Blue Mark DroneScout 230 Series Manual

Remote id for drones. receiver manual
Hide thumbs Also See for DroneScout 230 Series:

Advertisement

Quick Links

DroneScout - Receiver Manual
230-series
May 2022 - version 1.0
The latest version of this manual is located here:
https://download.bluemark.io/dronescout_sensor_manual_230.pdf
Intended audience: system integrators
1/28
DroneScout Receiver Manual - version 1.0 May 2022 - © BlueMark Innovations BV 2022

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the DroneScout 230 Series and is the answer not in the manual?

Questions and answers

Summary of Contents for Blue Mark DroneScout 230 Series

  • Page 1 DroneScout - Receiver Manual 230-series May 2022 - version 1.0 The latest version of this manual is located here: https://download.bluemark.io/dronescout_sensor_manual_230.pdf Intended audience: system integrators 1/28 DroneScout Receiver Manual - version 1.0 May 2022 - © BlueMark Innovations BV 2022...
  • Page 2 Disclaimer: we are not responsible or liable for errors or incomplete information in this document. Version history version date description May 2022 Initial release  2/28 DroneScout Receiver Manual - version 1.0 May 2022 - © BlueMark Innovations BV 2022...
  • Page 3: Table Of Contents

    Contents 1 Introduction ....................................4 1.1 Audience ..................................4 1.2 Receiver ..................................4 1.3 Installation ..................................6 1.4 Login.................................... 10 1.5 Read-only file system ............................10 1.6 Open Drone ID ................................. 10 1.7 Global architecture ..............................10 1.8 Maximum detection range ..........................11 2 Configuration ..................................13 2.1 root password ................................
  • Page 4: Introduction

    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/dronescout_sensor_manual_230.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.
  • Page 6: Installation

    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.
  • Page 10: Login

    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.
  • Page 11: Maximum Detection Range

    1.8 Maximum detection range The maximum detection range depends on several factors: Effective radiated power (ERP) of the transponder (transmit power, antenna design)  Antenna height of the receiver and transponder. Detection range increases with higher  height as it converges to free-space propagation. Antenna gain and directivity of the receiver.
  • Page 12 BLE legacy Average RSSI at 500 m: -78 dBm   Sensitivity radio -97 dBm So 19 dB (-78 - -97) above sensitivity level. Assuming free space propagation (6 dB loss per doubling of the distance), the maximum detection range is: 500*10^(19/20) = 4.4 km. BLE Long Range Average RSSI at 500 m: -78 dBm ...
  • Page 13: Configuration

    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. 2.1 root password For production environments it is strongly advised to change the default password. overlayroot-chroot passwd #interactive tool to change the password exit reboot # new password will work after a reboot...
  • Page 14 [interface] WLAN_USB_1 = wlan1 ; interface for WLAN 1 adapter WLAN_USB_2 = wlan2 ; interface for WLAN 2 adapter BT_UART_1 = /dev/ttyUSB0 ; interface for USB UART adapter [threshold] WLAN_USB = -200 ; signals weaker as the threshold won't be processed. BT_UART = -200 ;...
  • Page 15: Remote Ssh Login

    2.3 remote SSH login When receivers are placed behind a router, they can't be accessed remotely. Reverse SSH is a method to be able to login remotely without changing router or firewall settings. See https://www.howtogeek.com/428413/what-is-reverse-ssh-tunneling-and-how-to-use-it/ background information. Default remote SSH login is disabled. If remote SSH is enabled (by setting enabled to “1”...
  • Page 16 17,36 18,40 19,48 20,52 21,56 22,60 23,64 24,149 25,6 26,44 27,161 28,165 Use the following commands to edit file /root/remote.conf: overlayroot-chroot nano /root/wlan_channels.conf # use nano (or vi) as editor exit reboot # to apply changes 16/28 DroneScout Receiver Manual - version 1.0 May 2022 - © BlueMark Innovations BV 2022...
  • Page 17 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 18 5680 MHz [136]  5700 MHz [140]   5720 MHz [144] 5745 MHz [149]  5765 MHz [153]  5785 MHz [157]  5805 MHz [161]  5825 MHz [165]  5845 MHz [169]  5865 MHz [173]  5885 MHz [177] ...
  • Page 19: Mqtt Messages

    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 20 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 21 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...
  • Page 22: Mqtt Subscriber (Reference Code)

    4 MQTT SUBSCRIBER REFERENCE CODE You need to write your own MQTT subscriber application to process the MQTT messages published by the DroneScout receivers. Below reference Python3 source code is published to process such MQTT messages. It can also be found here: https://github.com/BluemarkInnovations/RemoteID-MQTT-subscriber #!/usr/bin/python3...
  • Page 23 client.on_connect = on_connect client.connect(broker, port) subscribe(client) return client def subscribe(client: mqtt_client): def on_message(client, userdata, msg): print(f"Received message from topic `{msg.topic}`") try: #not compressed payload = msg.payload.decode() # remove newline char as it will prevent decoding of json if ord(payload[-1:]) == 10: payload = payload[:-1] except (UnicodeDecodeError, AttributeError): #lzma compressed...
  • Page 24 #BasicID message 1 if BasicID1_valid == 1: BasicID1_start_byte = 32 [UAType] = struct.unpack('i', UASdata[BasicID1_start_byte:BasicID1_start_byte + 4]) [IDType] = struct.unpack('i', UASdata[BasicID1_start_byte + 4:BasicID1_start_byte + 4 + 4]) print("Basic ID 1 data") print("UAType..", UAType) print("IDType..", IDType) print("Basic ID..", UASdata[BasicID1_start_byte + 8:BasicID1_start_byte+ 8 + 21].decode('ascii')) print("") #LocationValid message if LocationValid == 1:...
  • Page 25 print("BaroAccuracy..", BaroAccuracy) print("SpeedAccuracy..", SpeedAccuracy) print("TSAccuracy..", TSAccuracy) print("TimeStamp..", int(TimeStamp/60), ":" , int(TimeStamp % 60),sep="") print("") #SelfIDValid message if SelfIDValid == 1: print("Self ID data") SelfID_start_byte = 776 [DescType] = struct.unpack('i', UASdata[SelfID_start_byte:SelfID_start_byte + 4]) Desc = UASdata[SelfID_start_byte + 4:SelfID_start_byte + 4 + 23] print("Desc Type..", DescType) print("Desc..", Desc.decode('ascii')) print("")
  • Page 26 [OperatorIdType] = struct.unpack('i', UASdata[OperatorID_start_byte:OperatorID_start_byte + 4]) print("Operator ID Type..", OperatorIdType) print("Operator ID..", UASdata[OperatorID_start_byte + 4:OperatorID_start_byte + 4 + 20].decode('ascii')) print("") except: pass try: status_json = json_obj.get('status') status_json.get('sensor ID') # fail if it is data json print("status message") print("sensor ID..", status_json.get('sensor ID')) print("timestamp..", status_json.get('timestamp')) epoch_timestamp = datetime.datetime.fromtimestamp(status_json.get('timestamp')/1000)
  • Page 27 Example output: 27/28 DroneScout Receiver Manual - version 1.0 May 2022 - © BlueMark Innovations BV 2022...
  • Page 28: Firmware Update

    IRMWARE UPDATE The firmware can be updated to the latest version by executing the following update-script. sh /root/update.sh Note, this update script does not remove files, nor does it overwrite the file remote.conf. 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.

Table of Contents