Setup Hardware

The following steps are required to set up a tower into the Harbor system.

Note that whether it’s a new tower or a tower being restarted/recovered, the steps must be the same to ensure there are no dirty data.

Pre-requisites:

  • iOS Device (iPhone or iPad Required).

  • Download the latest firmware version to your phone.

  • Note the Tower ID to configure. We will provide you with the Tower ID.

  • Make sure your phone has the right date and time configured.

  • Stay nearby the tower to have a strong BLE signal to connect to it.

Firmware Update

  1. Use the Harbor Connect iOS App to connect to the tower.

  2. Establish a Technician Session using the Request Session > Technician buttons.

  3. Check in the console that there are no errors in the process.

  4. Use the Begin Firmware Update button.

  5. If you need to do a factory reset after the Firmware Update, enter true in the dialog. This will trigger a factory reset process after the firmware is updated. The factory reset takes ~1 minutes to complete. You only need a factory reset if you’re configuring the tower for the first time, or if you need to delete the whole configuration.

  6. If a factory reset was requested, wait until it’s completed (the green light on the board stops blinking).

  7. If a tower was reset (either doing a factory reset command, using the board’s button, or doing a factory reset after a firmware update), Harbor Backend needs to restart the Sync events counter to start processing events from the beginning.

  8. Ask a Harbor Backend dev to restart the sync counters on the tower you just configured.

Tower Configuration

  1. Use the Harbor Connect iOS App to connect to the tower. Note that if you did a firmware update before, you need to go back and discover/connect to the tower again.

  2. Establish a Technician Session using the Request Session > Technician buttons.

  3. In the left column, use the Set Tower ID button to configure the tower ID provided by Harbor.

  4. Use the Set Clock button to configure the RTC with the phone’s date and time.

  5. To make it easier to follow the next steps, clear the console using the red Clear button now.

  6. At this point, the tower has the tower ID and the clock configured, but the BLE interface is still connected to the old tower configuration. To fix this: Go back to the list of nearby towers. Hit the Discover Devices button.

  7. Connect to the tower and check the console for the Tower ID and Firmware version. Make sure it has the configured Tower ID and the latest firmware version there.

  8. Establish a Technician Session using the Request Session > Technician buttons.

  9. Go to Bundled Functions > Download Configuration. This will download the Harbor configuration to the tower and will sync all the locker tokens, tower config, and keys between the Harbor backend and the tower’s device.

  10. To confirm the configuration was applied correctly, go back to the screen with the list of commands, and check the last message of the console. It should be a packet_type = 0 packet, with a session_sequence of ~200.