Follow these steps to prepare your RPi DevKit to run the UrsaLeo demo and start sending sensor data from the ThunderBoard sensors to one of the demo 3D models.
As a prerequisite, you will need:
- A computer (Windows 10) with the latest version of balenaEtcher installed
- A microSD card reader connected to your computer
- UrsaLeo RPi DevKit with Silicon Labs Thunderboard 2 sensor
- Ethernet cable
Update your RPi software steps:
- Flash the Raspbian Pi OS Lite image
- Remote login via SSH access
- Install the UrsaLeo demo package
- Configure your RPi
- Configure Wifi (Optional)
1. Flash the Raspbian Pi OS Lite image
- Visit the Raspberry Pi site to download the latest Lite version:
- Insert the SD card from the DevKit into your PC's card reader and start balenaEtcher. Select the downloaded Raspbian Pi OS Lite compressed image file.
Select the SD card. Cancel any dialogues requesting you format the drive
Flash the image. It will take several minutes to flash and verify.
2. Remote login via SSH access
- Eject the microSD card from your PC's card reader, then re-insert it again
- Open File Explorer and in the "boot" (D:) drive, create a new text document named "ssh" with no extension
- Eject the SD card from the PC and insert into the RPi card socket
- Attach the Ethernet cable to the RPi network connector
- Power up the RPi allowing it to boot until the green activity LED stops flashing (about 1min)
- On your PC open the Command Prompt and enter the following command:
- Depending on your local network configuration, if there is an error or no response, try adding .local to the hostname and use that instead in the following sections
- Accept the connection by entering "yes"
- At the login prompt enter the password "raspberry"
- The prompt will change and you should now be remotely logged into your RPi
Run the following commands to update the device with any available security patches:
sudo apt update
sudo apt upgrade
Useful information about connecting to your RPi remotely can be found at Raspberrypi.org.
3. UrsaLeo demo installation
- Enter the following command to download the UrsaLeo demo package:
- Install the UrsaLeo demo using the following command:
sudo apt install ./ursaleo-gateway_0.5.5-1_armhf.deb
- Allow the installer will install the package and any additional dependencies required
After the installation has completed, you will be returned to the system prompt
4. Device configuration
Start the gateway configuration using the following command which will present a menu of options:
Once the menu is displayed, proceed through the available options in order:
Option 1 - Connect Sensor
- Connect the ThunderBoard to the RPi with the USB cable supplied - the blue LED will turn on
- Enter option one to start the BLE paring
- Press the button marked "Reset" near the centre of the ThunderBoard - the yellow LED will start flashing
- Enter the option for your ThunderBoard MAC
Option 2 - Register gateway
- Enter option 2 to register the gateway
- Press return to accept the default service: demo.services.ursaleo.com
- The gateway will acquire an access token then display the Device ID number which should be noted down.
Option 3 - System info
- This option can be used at any time to display the system information.
Option 4 - Reboot
- Enter option 4 to reboot the gateway. It must be used before the changes are saved, now or in the future
- The SSH session will disconnect and the RPi will shutdown
- On rebooting the gateway will connect and start sending data from the ThunderBoard sensors
Option 5 - Power down
- Use option 5 to power down the gateway safely
- Allow about 30 seconds for the yellow activity light on the RPi to stop flashing before turning off the power supply
Warning: The RPi should never be disconnected from the power supply without shutting down the operating system first as doing so can permanently corrupt the SD card
To view your sensor data in one of the demo models, navigate back to the Getting Started page and continue through the 3 step process.
Note: If you purchased an UrsaLeo RPi DevKit, you can request the optional debug LED module at no charge by submitting a request here: Submit a request.
If you have the LED module installed, you should now be able to check the status of the LED's:
• LED 1 = On (connection to Internet)
• LED 2 = On (connection to Thunderboard )
• LED 3 = On (Connection to UrsaLeo service)
• Note: If LED 2 does not turn on, press the reset button located in the centre of the Thunderboard.
5. Configure WiFi (Optional)
- Open a Command Prompt and login remotely to your RPi by entering the following command (see step 2):
- Start the Raspberry Pi configuration menu by issuing the following command:
- Choose Network Options and follow the prompts to setup your country code, SSID and password
You should now be able to reboot, disconnect the Ethernet cable and your RPi will connect via WiFi