Connect your devices

Bring your real hardware into Zequent: a DJI dock pairs itself with a one-time code, other devices are added by their serial number, and the software that talks to them gets a credential of its own.

How a device reaches Zequent

Every device is connected through an adapter: a small program that speaks the device's own protocol on one side and Zequent on the other. A DJI dock talks to the DJI adapter directly; a MAVLink drone, a radar or a jammer has its adapter running nearby.

Whichever way it connects, a device appears in Zequent as an asset under Manage›Operations›Assets. An asset belongs to exactly one organization, and that is decided when it is added: it cannot be moved afterwards.

12

There are two ways in:

Way in	Use it when	How
Pair device ①	The device announces its own serial number: a DJI dock, or an adapter set up with a pairing code.	Pair a DJI dock
New asset ②	You know the device's serial number and the adapter is waiting for it.	Add a device by its serial number

Pair a DJI dock

1. Create a pairing code

   On Assets, select Pair device.

   

   Field	What to enter
   Label	What the code is for, for example Rooftop dock. You see it in the list of codes.
   Vendor and Type	DJI and Dock. A device of another kind is then refused without using up the code.
   Devices	1. The dock's drone joins together with the dock and needs no code of its own.
   Valid for	How long until the code expires: from 15 minutes, while you stand at the dock, up to 24 hours, for a dock that is still on its way.

   Select Create code. The code is shown once: copy it or write it down.

2. Enter the code on the dock

   When you connect the dock to your Zequent platform in DJI's setup, it asks for the code that binds it to an organization. Enter the pairing code. The dock shows your organization's name: check it, and confirm.

3. Check the dock and its drone

   The dock and its drone appear on Assets, in your organization. A green dot next to the name means it is online.

Under the asset list, Pairing codes shows every code you created, whether it is still open, used, expired or revoked, and which devices used it. Select Revoke to cancel a code that is no longer needed. A dock that is reset and paired again keeps its asset and doesn't use up a new code.

Add a device by its serial number

For a device whose adapter is configured with its serial number, create the asset first. The adapter never creates assets on its own: until the asset exists, the device does not appear.

1. Create the asset

   On Assets, select New asset.

   

   Field	What to enter
   Serial number	Exactly the serial number the adapter uses for this device.
   Name	The name everyone sees, for example Survey quad. Without one, the serial number is shown.
   Type and Vendor	What the device is, for example Aircraft and MAVLink.
   Connection and Connection string	Where the adapter reaches the device. For a MAVLink drone this is its MAVLink address, for example udp://:14540. Every device needs its own.

   Select Create asset.

2. Start the adapter

   Start or restart the device's adapter. Once it is connected, the device shows online on Assets.

Give an adapter its credential

An adapter proves to Zequent who it is with a credential. Without one, the platform refuses it.

1. Issue the credential

   Open Manage›Access & Integrations›Credentials and select New credential.

   

   Choose Edge adapter, give it a name that says where it runs, for example mavlink-hangar-2, and choose how long it is valid: up to two years, one year by default. Select Issue credential.

2. Hand the token to the adapter

   The token is shown once. Whoever runs the adapter sets it as ZQNT_EDGE_TOKEN, together with ZQNT_PLATFORM_PUBLIC_KEY, the key the adapter uses to recognize commands from your platform. Your platform administrator provides that key.

The list shows when each credential was last used, so you can tell whether an adapter is calling in. To take access away, for example when a laptop with an adapter is lost, select Revoke: the credential stops working within seconds. Issue a new one for the adapter that should keep running.

Kind	For
Edge adapter	An adapter that connects devices.
Integration Hub	The Integration Hub, which also reads event triggers and starts Applications.
Client application	Your own software on a Zequent client SDK. It sees your organization's devices, Applications and runs, but never users or settings.

Is it online?

Two things can be online, and the Assets list shows both:

• The device: the dot before its name. Its adapter can reach it right now.
• Its adapter: the Edge column. No edge means the adapter for this kind of device isn't connected to the platform.

If a device shows No edge, fix the adapter first. If the adapter is connected but the device is offline, the adapter is running but can't reach the device: check that it is switched on and reachable.

Manage›Operations›Adapter Manager lists every adapter that has connected, with its endpoint, the kind of device it serves, its status and when it was last seen. Starting, stopping and restarting an adapter there is for system administrators, and affects every device that adapter serves.

Check a device

On Assets, select › at the end of a device's row to open its page. Overview shows its battery, height and heading at a glance, what it is and how it is connected, when it last reported, and where it is on a map.

Tab	Shows
Telemetry	Battery, height, speed and heading over the last hour, 6 hours, day or week.
Aggregates	The same history summed up: average, lowest and highest battery, average height.
Path	Where the device went, on a map.
Live	Everything the device reports, as it arrives.
Safety	Every time the platform stepped in for this device, for example a low-battery return home.
Edit	Model, connection details and the site the device is stationed at. Organization administrators only.

Media captured by this asset at the top right lists every photo and video the device uploaded. See Find photos and videos.

Safety keeps what the platform did, also when nobody saw the alert. Return run opens the run that brought the drone home.

Remove a device

On Assets, expand the device's row and select Delete asset. This frees its serial number, so the device can be added or paired again, for example into another organization. It cannot be undone.

Troubleshooting

• The dock refuses the pairing code. The code is mistyped, used up, expired or revoked. Create a new one and enter it again.
• The device does not appear after New asset. Check that the serial number matches the adapter's exactly, and that the adapter is running with a valid credential: on Credentials, an adapter that never called in shows never used.
• A device shows offline. Its adapter has stopped sending. Check that the adapter runs and that the device is switched on and reachable from it.

Next steps