background image

Message Transmission - GPS Pinger Hive Map Feature

The Swarm Map Beta is an included service in the 

Swarm Hive

 to monitor device health and 

track the location of your devices. The most recent recorded GPS point (taken from your Eval 
Kit pinger messages) is displayed on the map. 
Map functionality can be expanded to include any of Swarm’s modems (using firmware version 
v1.1.0 or newer
) by sending messages using APPID: 65535 through the Swarm Network in a 
JSON-structured message:

{"ln":-111.823,"si":0.128,"bi":0.216,"sv":20.032,"lt":40.4799,"bv":3.944,"d":1627498644,"n":261,"a":1835.0,"s":2.0,"c":290.0,"r":-103,"ti":0.04}

ln: 

Longitude

si: 

Solar current (A)

bi: 

Battery current (A)

sv: 

Solar voltage (V)

lt: 

Latitude

bv: 

Battery voltage (V)

d:  

Date and time as 

Epoch seconds

 (ex: 1625771690 = Thursday, July 8, 2021 12:14:50 PM GMT-07:00 DST)

n: 

Number of messages that have been sent since last power-up

a: 

Altitude (m)

s: 

Speed (km/h)

c: 

Course (degrees)

r: 

Last RSSI value (dBm)

ti: 

Tile current (A) 

This GPS location report is accurate up to 4 decimal places in Decimal Degrees, around 11 meters.

10

 Customer Support |

 

[email protected]

Summary of Contents for EVAL Kit

Page 1: ... 2021 SWARM TECHNOLOGIES INC Evaluation Kit Quickstart Guide ...

Page 2: ...essage Transmission Kit Interactivity Development Resources Troubleshooting Swarm Eval Kit What s Included Follow along with our QuickStart Video Something broken or missing Customer Support techsupport swarm space https youtu be zJMWd1PM13E 2 ...

Page 3: ...ry Power Switch 8 24VDC Solar Input 6 pin Serial Header I C Header Noise RSSI Indicator LED FeatherS2 OLED Display Stack u fl SMA Sat Antenna Cable Eval Kit Configuration Buttons 3 Customer Support techsupport swarm space 4 2VDC Out USB Feather Serial Jumper Swarm Tile Device ID Swarm Tile Authentication Code ...

Page 4: ...p an activation email will be sent to you Navigate to Devices Add Devices Click Start Scanning to scan your Swarm Tile QR Code The Swarm Tile modem is located inside the Evaluation Kit If you are unable to use the browser based scanner you can also use your camera app to scan the Tile QR code and enter the auth code in the Hive manually See example below ac ABCDE 12345 XYZ x 1 2 3 ...

Page 5: ... a flat surface with solar panel facing down Locate the external power button on the side of your Eval Kit Press and latch the switch to power on Overview Setup Powering on the Kit 5 Customer Support techsupport swarm space ...

Page 6: ... extend tripod legs Install wave VHF antenna onto the solar bracket bulkhead hand tight Screw the tripod mount into the threaded hole on bottom of the Eval Kit solar bracket Remove the tripod mounting attachment by loosening the latch at the top of the tripod 6 Customer Support techsupport swarm space ...

Page 7: ... transmission The OLED also displays the actual background noise RSSI value To lower your noise RSSI isolate the Eval kit in an area with RF interference outside in a more remote location is ideal Noise RSSI dBm Background Noise Level 90 Bad Unlikely to work 93 Marginal 97 OK 100 Good 105 Great 95dBm 91dBm 7 Customer Support techsupport swarm space ...

Page 8: ... web App When transmitted by the Kit the message will be sent to the specified To email address This method requires WiFi to be enabled In Access Point AP Mode users connect to the Eval Kit AP default name swarm xxxx with password 12345678 and communicate to address 192 168 4 1 to queue messages and send other commands In Station STA Mode users specify the network to connect the Eval Kit to connect...

Page 9: ...view of the sky with minimal obstructions and observe the RSSI indicator LED on the board If leaving the Kit for an extended period of time orient the solar panel to face the Equator When the LED indicator shows GREEN your kit has an optimal background noise RSSI level for a successful transmission The Eval Kit will have best transmission results outdoors and 5 km away from cities where RF noise i...

Page 10: ... Network in a JSON structured message ln 111 823 si 0 128 bi 0 216 sv 20 032 lt 40 4799 bv 3 944 d 1627498644 n 261 a 1835 0 s 2 0 c 290 0 r 103 ti 0 04 ln Longitude si Solar current A bi Battery current A sv Solar voltage V lt Latitude bv Battery voltage V d Date and time as Epoch seconds ex 1625771690 Thursday July 8 2021 12 14 50 PM GMT 07 00 DST n Number of messages that have been sent since l...

Page 11: ...4 1 in your device web browser You will see a messaging UI appear with the Swarm logo this may take a minute to load 3 Once the web messaging app has loaded you can fill out the 4 required fields to send an email message of up to 192 bytes through your Swarm Eval Kit a When the Tile has queued the message you ll see a fading Message Sent i Messages are kept on the Tile for 48 hours by default configu...

Page 12: ...it Example Tools below 3 You can now simply queue a message on the Eval Kit by using the TD Transmit Data command Determine what you would like to send as your first message within quotes and calculate the checksum for the message For example Command TD Message string in quotes Hello World Message checksum 31 The full command to the Tile will then be TD Hello World 31 If the message is accepted a ...

Page 13: ...ow control None b If connected wirelessly use Telnet to the Feather IP address i You can use ZOC for this on Windows macOS 2 Send the following commands to the feather a set ssid YourSSID i Response Successfully set ssid to YourSSID b set pw YourSSIDPassword i Response Successfully set pw to YourSSIDPassword c set mode sta i Response Successfully set mode to sta d reset i Response No response Feat...

Page 14: ...he right position from FEATHER to USB see bottom image Power on the Eval Kit once again note that the Feather will not be accessible in this mode and the OLED display will not be active Using a Serial Monitor tool such as ZOC connect to the Swarm Tile using the identified USB COM port baud rate 115200 config 8 N 1 with Flow Control None You can now send commands and receive responses to from the Til...

Page 15: ...ring which time you will attempt to transmit your queued messages to the Swarm Network Higher elevation passes are generally better for transmission success 1 Enter your address or postal code in the search bar 2 Find a suitable pass window based on the local time and pass duration 3 Place the Kit outdoors with a view of the sky and wait for transmission 1 2 15 Customer Support techsupport swarm s...

Page 16: ... our REST API integration guide You can also access our Swagger UI documentation page from Hive Help API Documentation When your device has successfully transmitted through the Swarm Network you will see your messages displayed in the Swarm Hive If you are monitoring the Tile log with a Telnet or Serial connection the Tile will report when a message has been transmitted to a Swarm Satellite with t...

Page 17: ...sid EvalKitAP set ssid MyHomeWifi set pw password Set the password to create when in AP mode or to connect to in STA mode Default 12345678 set pw EvalKitPW set pw MyHomePW set interval minutes Set the interval for the gps pinger feature 0 will disable the GPS pinger Acceptable range is 15 to 720 minutes Default 60min set interval 120 show Print the wifi mode ssid password and interval to be committe...

Page 18: ...ollowed by a feather reset No telnet functionality exists while WiFi is disabled B None This pin is internally tied to the RSSI indicator pin and is not configurable C GPS Pinger Enable Disable This button will disable or enable the GPS pinger Reset Resets Feather OLED Pressing this button will reset the feather Reset A Factory Reset To reset the feather to factory default press and release Reset ...

Page 19: ...fer Enable Feather USB Serial Connection Tile Power Enable Customer Support techsupport swarm space Switching Reg Enable Switching Reg PWM Mode The image below shows the default jumper configuration for the Eval Kit Note that the Serial Jumper J7 2 can be switched to allow for Feather USB serial access to the Swarm Tile ...

Page 20: ...rrupted testing An additional pass through is available in the Eval Kit enclosure cable gland Providing external power involves removing the solar panel leads from the green terminal block and replacing with a 8 24VDC supply The OLED display will then report the INA3221 reading of the external power input as SOL xx xx Note No jumper changes are required for external power input 20 Customer Support...

Page 21: ...some additional helpful resources for using your Eval Kit Swarm Resources Swarm Getting Started Github Swarm Getting Started Wiki Troubleshooting RSSI Troubleshooting Antenna Swarm Developer Tools Swarm Tile Manual External Resources FeatherS2 FAQ Updating FeatherS2 Bootloader CircuitPython Overview Customer Support techsupport swarm space 21 ...

Page 22: ...FCC Rules Operation is subject to the following two conditions 1 This device may not cause harmful interference and 2 This device must accept any interference received including interference that may cause undesired operation This Class B digital apparatus complies with Canadian ICES 003 Cet appareil numérique de la classe B est conforme à la norme NMB 003 Canada 22 Customer Support techsupport sw...

Reviews: