NOTE: You will first need to set up an UrsaLeo Cloud account.
- Raspberry Pi v3B , v3B+ or new v4B
- Minimum 8GB microSD card
- Keyboard and monitor - a USB keyboard and HDMI monitor (Note this can be replaced after serial I/O is enabled on the Raspberry Pi by connecting a computer to the console interface using a suitable cable)
- A Silabs Thunderboard2 or BME280 to run the initial demo.*
- UrsaLeo LED debug board (optional)
- An UrsaLeo Cloud account
*We recommend you do not begin this process until you have secured all components as noted above unless you are writing your own sensor driver. Instructions for writing your own sensor driver can be found here.
If you don't already have Raspbian Buster Lite installed on your Raspberry Pi, please follow the first set of instructions. If you've already installed this on your device, skip down to the Gateway Installation section.
Raspbian OS installation
1. Download Raspbian Buster Lite image from http://www.raspberrypi.org/downloads/raspbian/ to your computer and flash onto SD card.
2. Reinsert the SD card into your Raspberry Pi and power on. Login as user pi with password raspberry.
3. Configure WiFi by typing:
Scroll down to 2. Network Options and press Enter. Scroll down to N2 Wi-fi and press Enter to input your country code, SSID, and passphrase. You can also configure serial and SSH within this menu if desired. Scroll down to Finish to return to the prompt.
**We highly recommend configuring SSH and connecting to the Pi with your computer. You can easily copy and paste commands from this page to the SSH session to ensure all commands are entered properly.**
4. Update system to latest versions by typing:
sudo apt update && sudo apt upgrade
Be sure to watch the installation as you'll be prompted to continue and must press Y to complete the install. This process can take a few minutes.
1. Download UrsaLeo Gateway package
sudo apt install ./ursaleo-gateway_1.2.2-1_armhf.deb
Type Y when prompted and q to quit news item. Ignore warnings.
Now you're ready to run the configuration menu to register to your device to your UrsaLeo Cloud Account.
- The UrsaLeo Configuration menu can be accessed from the prompt after logging into the Pi by executing:
# sudo ul-config
UrsaLeo Gateway Configuration menu
Once the menu is displayed, proceed through the available options in order:
Option 1 - Register Device
- When selected, this option first tests the route to the UrsaLeo cloud MQTT bridge. On a connectivity failure, a message to check connectivity will be displayed. Address the connectivity issue by connecting an Ethernet cable or configuring WiFi as described above for Option 1, then retry Option 2.
- Once connectivity is established, you will be prompted to enter the Device ID, Registration Code, and your UrsaLeo Cloud platform username and password. Existing users should enter the Device ID and Registration Code as described above. New users can simply press enter when prompted to generate these codes.
- (New users only) On completion, a new key pair to identify your device will be generated and the public portion sent over https to register your device (the private portion is stored on your device). This process also checks that a valid device exists along with the validation code in the cloud. All being well, the device will then connect to the UrsaLeo cloud platform, storing the credentials locally.
- On failure, an error message will indicate specific authorisation and other issues. Check your credentials and try again. Note that the Registration Code is case sensitive and must be entered correctly, including the dashes.
Option 2 - Thunderboard Demo
- Use Option 2 to configure the Thunderboard demo and restore the BLE connection between your DevKit and the Thunderboard 2 sensor that came with your kit.
- Type 2 and press return. It is recommended to press the reset button on the Thunderboard and select the option that is returned at the prompt after a few seconds. This process can take 10 - 20 seconds to complete - be patient!
- It can also be used at a later stage to change or replace the Thunderboard 2 sensor. Note that your device will not send data until this step is completed.
Option 3 - BME280 Demo (Optional)
- Use Option 3 to configure the BME280 demo as an alternative to the Thunderboard demo. This uses the I2C bus to connect to BME280 modules. The modules I2C address can be changed in the config file /etc/ursaleo/bme280.ini
- Type 3 and press return.
- It can also be used at a later stage to change or replace the BME280 sensor. Note that your device will not send data until this step is completed.
Option 4 - System Info
- Displays key system configuration details on screen and generates a log file containing current configuration and system state that can be emailed to email@example.com. This can be run at any time.
Option 5 – Reboot
- You can now reboot your device by selecting Option 5. **Note that no previous changes will be saved to the device unless Option 4 is performed.**
- After the Devkit has completed rebooting, we recommend that you press the reset button near the centre of the Thunderboard. The green LED near the centre of the Thunderboard should flash one or two times then go off - indicating a connection.
- Your DevKit is now updated and will automatically start sending sensor data to your UrsaLeo Cloud account.
To view your sensor data in the dashboard, see Monitor Your Sensor Data
Note: If you have a promotional code for a free LED, please submit a request with the the promo code.
If you already have the LED module installed, you should now be able to check the status of the LED's:
• LED 1 = On (connection to Google IoT Core)
• LED 2 = On (connection to Thunderboard Sense 2 / BME280)
• LED 3 = On (Authentication with Google Cloud Platform) after a few seconds
• Note: If LED 2 does not turn on, press the reset button located in the centre of the Thunderboard.
LED 4 is used by UrsaLeo Support for debugging purposes. If LED 4 lights up, please submit a request for help.