NodleIoTOpen dashboard →
Documentation

Fleet Registration

How to register a fleet: where to go and which steps to follow. The path depends on your organization's plan — on the Managed Service Nodle signs and pays for every on-chain operation, while everyone else registers on-chain from their own wallet.

Before you register: find your fleet identifier

Your fleet name is a label you choose in the dashboard. Your fleet identifier comes from the Bluetooth Low Energy (BLE) advertisements your devices broadcast. Check your device's configuration app or manufacturer documentation to identify its advertising format.

Fleet identifier formats and examples
FormatWhat to copyFleet identifier example
iBeaconThe proximity UUID. Keep Major and Minor separately for device matching.ibeacon:a8d2f51f-a5a1-480a-9bb0-12750ebc2352
Eddystone-UIDThe Namespace ID: 10 bytes (20 hexadecimal characters). Keep the Instance ID separately.eddystone:00112233445566778899
Manufacturer dataThe Bluetooth SIG Company ID: 2 bytes (4 hexadecimal characters).cid:09e1
Service dataThe Service UUID associated with the advertised service data: 4, 8 or 32 hexadecimal characters.sdata:1234567812345678123456789abcdef0

Examples are illustrative. Use the values broadcast by your own devices, with the corresponding prefix. A bare UUID is also accepted for iBeacon. The Eddystone namespace is not a UUID.

Find the identifier with a Bluetooth scanner

A BLE scanner such as Nordic Semiconductor's nRF Connect for Mobile can help you inspect nearby devices and their advertising data.

  1. Turn on your beacon and place it near your phone.
  2. Open the scanner, grant the Bluetooth permissions it requests, and start scanning.
  3. Select your device and expand its advertising data.
  4. Find the iBeacon UUID, Eddystone-UID Namespace, Manufacturer Data Company ID, or Service Data UUID, depending on the format.
  5. Copy the relevant value and add the prefix shown above before entering it in the dashboard.

Available fields depend on the app, operating system and advertising format; Nordic lists full iBeacon and Eddystone support for Android. If the identifier is not visible, check the manufacturer's configuration app or documentation. Use the advertised identifier rather than the Bluetooth name or address. The exception is a single label, which can be registered by its MAC (see below).

Fleet identity vs. full device identifier

You may encounter a full device identifier such as:

cid:09e1#0347001cfb00000003206f0c2300c00403460968

The part before #, cid:09e1, is the fleet identity. The suffix belongs to the full device identifier. Enter cid:09e1 in the fleet registration form, without the suffix. To follow one label instead, register it by its MAC as a dashboard-only cid:<4 hex>[/<prefix>]#<MAC> fleet (Managed Service: Register Fleet → Create Fleet).

A Company ID may be shared by multiple products from the same manufacturer. Configure your swarm filters to match the advertisements relevant to your fleet.

If your device broadcasts several formats, choose the one you intend to use and keep that choice consistent when configuring your swarm filters.

Ready to register?

Go to Fleets → Register Fleet, enter the identifier and choose a descriptive fleet name. The dashboard checks whether the identity is already claimed. Follow the instructions for your plan below. Swarm filters define which device advertisements match your fleet; locations describe where the fleet operates.

How it works

On the Managed Service plan, Nodle performs every on-chain operation for you — claiming the fleet identity, registering locations and swarms, and maintaining them afterwards. You fill in a short form, and your dashboard wallet never needs funding: no tokens to buy and no gas to pay.

Registering a fleet requires the admin role. Admins and editors can manage an existing fleet's locations, swarms and webhooks.

Register a fleet

  1. Go to Fleets in the sidebar and click Register Fleet. The registration form opens straight away.
  2. Details — enter the tag identifier and a fleet name. If you paste a bare UUID, pick the tag type as well. The dashboard checks on-chain that the identifier is not already claimed.
  3. Locations (optional) — add the countries, or the administrative divisions, where the fleet operates. The first location you add fixes the fleet at country or local level, so the rest must match it.
  4. Swarm membership — build the filters that match your devices' advertisements, or continue without them to register the fleet with an empty filter and add them later.
  5. Click Register. Everything is submitted as one request; the summary that follows lists the claim, location and swarm transactions.

What it costs you

Nothing on-chain — Nodle posts the bonds and pays the gas. Your plan includes a number of fleet registrations per billing period, and the form shows how many are left and the date the count resets. Once they are used up, new registrations are refused until that date; contact the Nodle team if you need more before then.

After registering

  • The fleet appears under Fleets. Open it to add locations, promote or drop a location tier, manage swarm membership, set up webhooks, or delete it — all handled by Nodle in the same way.
  • Already claimed a fleet yourself? Its Locations card shows a Set Nodle as Operator button. Confirm it once and Nodle can run registrations and maintenance for that fleet too.