5. Hive - Swarm-Technologies/Getting-Started GitHub Wiki

Q: Why does the date/time shown on Hive differ from the time at which the message was transmitted by the Modem?
A: The date and time displayed on Hive for transmission packets represents the date/time at which the packet was received by Hive. Once a packet has been transmitted from the Modem, the satellite will carry that packet until it passes over a Swarm ground station. The packet will then be downlinked to the ground station after which it will be visible on Hive. The time taken for a packet to arrive on Hive after transmission will vary based on the device location and its proximity to the next Swarm ground station. Testing in the intended installation location is the best guide for determining what your average latencies will be for transmission.

Q: How do I use the REST API?
A: The REST API is fully documented on the API Docs page included within Hive. Please note the following:

  • All message data is Base64 encoded. An online Base64 encoding/decoding tool is available here.
  • The organizationId, userApplicationId, and deviceid are all represented in decimal format. An online HEX to DEC convertor is available here.
  • The devicetype for the Swarm Modem is 1.
  • All times are represented in ISO 8601 format such as 2022-07-25T19:37:09.211Z.

Q: How do I use webhooks?
A: There are some instructions available for webhooks on the Delivery Page within Hive. Please click on the question marks on the page to learn more. Ubidots has a webhooks plugin available for the Swarm Hive along with a tutorial that is available on their website here.

Q: Why does my device’s last heard date/time state “Never”?
A: This is because your Swarm Modem has not yet transmitted on the network. Please load some messages for transmission onto the Modem and refer to the Modem transmission FAQ section for further help.

Q: How do I transfer a Swarm Modem between Swarm accounts?
A: The following steps outline how a Swarm Modem can be transferred between accounts:

  • The first step is to remove the Modem from the existing Hive account that it is registered to. To do this, login to the Swarm Hive and navigate to the Devices Page.
  • Select the device that you want to transfer to a new account to show the device details.
  • Scroll down in the device details pop-out section to the bottom and click on “Remove from Account”.
  • A confirmation message will appear for the user to confirm if they want to remove the device from the account.
  • Once the device has been removed from the initial account, it can be registered to a different Hive account by following the instructions presented in this document.
  • If there are any issues with the transfer process, please contact Swarm Support.