Page 2
Intended audience: system integrators Disclaimer: we are not responsible or liable for errors or incomplete information in this document. Version history version date description May 2022 Initial release November 2022 Added FCC information How to install a MQTT broker on the ds230 ...
NTRODUCTION Thank you for purchasing and using DroneScout products! The latest version of this user manual may be downloaded at the following link, where the most up-to-date version will be found: https://download.bluemark.io/ds230.pdf (Direct/Broadcast) Remote Identification (Remote ID) adds “beacon” capability to drones to broadcast basic information of airborne drones, such as the operator's registration number, drone serial number and current position.
Page 5
1x Bluetooth antenna connector (N-type) 2x WiFi antenna connector (N-type) omni-directional antennas with 5 dBi gain Size: 27.2 x 27.6 x 9.6 cm (without antennas). Weight: around 1.4 kg (with mast mount 1.9 kg Bluetooth scanning The Bluetooth radio scans continuously for Bluetooth LE and Bluetooth LE Long-Range packets with Remote ID payload.
Figure 1 - DroneScout 230-serie receiver 1.3 Installation Summary Install the receiver to a wall or pole mast using the included mast mount. Connect/screw the 3 antennas to the antenna connectors on the enclosure. Powering up the receiver without antennas may damage the Bluetooth and WiFi radios. ...
Page 7
you don’t want the receiver nearby it, as (busy) WiFi networks will reduce the detection range. Basically, install the receiver away from areas where there are signals in the 2.4/5 GHz band or large nearby objects (house) that can block detection of signals/drones from that direction. Detection area Detection area Figure 2 - install the receiver in the center of the detection area.
Page 8
Detection area Figure 3 - use multiple receivers to cover the detection area in case the detection area is not square, or circle shape. Construction materials - Construction materials (wood, concrete) attenuate wireless signals. This means that the detection area is reduced, if a receiver is installed behind or in such an object. This is especially true for the 5 GHz band.
Page 9
Power - The receiver needs power and is powered via Power over Ethernet (PoE), 802.11af. Connect the Ethernet port of the receiver to an PoE capable switch/router to have both power and connectivity. Connectivity - Connect the Ethernet port of the receiver to your router. The receiver needs Ethernet to upload data to the MQTT broker.
1.4 Login The receiver runs on Ubuntu 20.04 Linux distribution (ARM64). It can be accessed via SSH on the local network. Login details User name : root Password : bluemark Service : SSH Port : 22 IP address : DHCP client in local network Note: please change the password in production deployments! 1.5 Read-only file system The receiver uses a so-called overlayroot file system.
1.7 Global architecture The receiver has a binary, dronescout, in the root-folder (/root) to sense for Remote ID signals. There is also a configuration file dronescout.conf to configure MQTT and other settings. The file wlan_channels.conf is used to specify the WiFi channels that will be scanned. Finally, there are some auxiliary files that are discussed in the next chapter.
Page 12
receiver antenna height 2.5 m drone/transponder height 10 m transponder ERP power 20 dBm. RSSI measurements based on a slow moving drone equipped with the DroneBeacon transponder. flat agricultural land nearby trees > 15 meter (behind antenna), nearby building > 25 meter (behind antenna) ...
range compared to the existing 5 dBi antennas. Rule of thumb is that every 6 dB increase, will result in doubling of the detection range. Hence, a 15 dBi antenna would triple (3x) the maximum detection distance. High-gain antennas and/or high receiver location may prevent detection of nearby drones.
ONFIGURATION The firmware is protected by a license/device key. In case the receiver does not work anymore due to license errors, please contact support. The ds230 needs a MQTT broker for uploading data. In the default configuration none is configured. For test purposes you can also install a MQTT broker on the sensor it self. This is described in section 2.5.
Page 15
transmit_mode = 2; 0 send MQTT message for each new message, 1 every second (truncate), 2 combine all and send at transmit mode 2 interval ms period transmit_mode_2_interval_ms = 250; set the transmission interval (ms) in transmit mode 2 (valid range: 50 to 60000) aggregate_data = 1;...
overloaded, if a lot of signals are detected and a lot of sensors are uploading data to the broker. In such cases new MQTT messages will get stalled at the sensor. In most smaller setups, it is safe to use transmit_mode is 0.
Login from the SSH server The receiver can be accessed from the SSH server by entering the following command: ssh root@localhost -p10230 The number 10230 is the remote_port in remote.conf . 2.4 wlan_channels.conf The /root/wlan_channels.conf file specifies which WiFi channels are scanned by the receiver. The default contents is show below: 6,44 7,149...
Page 18
The first number on the row is the sequence number. The second number is the channel number. Up to 256 channels can be configured. If the WiFi radio reaches the end of the sequence it will start with the first element. The second radio will scan the same channels, but with half period delay. Typically leave this file to default settings.
Page 20
clientID = ; set clientID or to random to generate random ID, leave empty for default setting ssl = 0 ; 0 disable SSL in MQTT connection 1, enable SSL ssl_verify = 0 ; disable SSL verification of SSL key of MQTT broker (useful for self-generated keys) CAfile = /root/certs/ca.crt ;...
3 MQTT MESSAGES The receiver generates two types of MQTT messages (JSON format): Status messages - every minute, the receiver will send a status message Data messages - data messages with Remote ID data. Status messages The receiver will publish every minute a status message. An example message is shown below. Figure 4 - Example receiver status message.
Page 22
Figure 5 - Example remote ID data message. This message contains several sections: protocol - indicates the protocol version. Currently only protocol 1.0 exists. data - a data message contains a section data. sensor ID - the sensor ID set in dronescout.conf ...
Page 23
type - the remote ID type. It can be BLE legacy, BLE long range, WiFi NaN or WiFi beacon. UASdata - this contains the Remote ID data. It is base64 -encoded. The binary data itself is the Open Drone ID structure defined on line 401 in file opendroneid.h: https://github.com/opendroneid/opendroneid-core-c/blob/master/libopendroneid/opendron eid.h...
4 MQTT SUBSCRIBER REFERENCE CODE You need to write your own MQTT subscriber application to process the MQTT messages published by the DroneScout receivers. Reference Python3 source code is available to process MQTT messages of the ds230 receiver. It can be found here: https://github.com/BluemarkInnovations/RemoteID-MQTT-subscriber 24/27...
ARRANTY The product has a two-year warranty period, starting at the date of receiving the product. Outside warranty are issues like crash damage, improper use, (extreme) weather conditions that damages the product. The product is eligible for future firmware updates as described in the Chapter Firmware update.
Need help?
Do you have a question about the DroneScout 230 Series and is the answer not in the manual?
Questions and answers