LEAPS Raspberry Pi

This page provides:

  • The LEAPS Raspberry Pi package.

  • Information about system requirements.

  • Instructions on how to install LEAPS Raspberry Pi.

The installation is fast and easy and only needs to be done once.

Before starting: Remember to back up any important files from the SD card you want to keep, as all data will be permanently overwritten during formatting.

System requirements

  • Raspberry Pi 3B or newer.

  • Recommended: A set of UDK (At least five devices) to verify.

  • Recommended: Batteries or USB-C cables for powering the devices.

  • Recommended: LEAPS Manager to configure devices.

Setup instructions

  1. Download LEAPS Raspberry Pi Image.

  1. Extract the LEAPS Raspberry Pi Archive.

  • Use a program like WinZip or 7-Zip to extract the downloaded LEAPS Raspberry Pi zip file.

  1. Launching the Raspberry Pi Imager.

  • Your operating system may try to block the installer.

  • On Windows: If you see a warning message, click More info and Run anyway.

  1. Installing the LEAPS Raspberry Pi Image.

  • Insert your SD card into the computer or laptop’s SD card slot.

  • Open the Raspberry Pi Imager.

../../../_images/raspberry_pi_imager.png

  • Select ‘Use custom’ then select, the desired LEAPS Raspberry Pi Image you want to install.

../../../_images/raspberry_pi_image_use_custom.png

  • Choose the correct SD card to install the image on. The drives may be displayed differently on different platforms.

../../../_images/choose_the_correct_sd_card.png

  • Take extra care to select the correct drive based on its memory capacity.

  • A new WRITE button will appear with “once the LEAPS Raspberry Pi Image and the SD card are selected.

../../../_images/raspberry_pi_image_write.png

  • Click the WRITE button.

  1. Writing and finishing up.

  • Wait for the Raspberry Pi Imager to complete the writing process.

../../../_images/raspberry_pi_image_writing.png

  • Once you receive a confirmation message, you can safely eject your SD card.

../../../_images/raspberry_pi_image_confirm.png

  1. Getting started with LEAPS.

  • Remove the SD card from your computer or laptop and insert it into the Raspberry Pi.

  • Make sure your Raspberry Pi is powered on.

  • The LEAPS system is installed and configured to boot with your Raspberry Pi.

  1. Wait for the System to Boot.

  • Please be patient and allow a few minutes for the entire system to finish booting

  1. Connect to the LEAPS-AP network broadcasted by the Raspberry Pi with the password Leaps1234.

../../../_images/connect_leaps_udk_network.png

  1. SSH into the Raspberry Pi (optional).

  • On a PC (or even another Raspberry Pi), open a PowerShell or Terminal window, then enter the following command to connect to the Raspberry Pi via SSH.

    ssh leaps@192.168.200.1

  • By default the account is leaps and password is leaps.

  1. Use LEAPS Manager to prepare network.

../../../_images/raspberry_pi_network_demo01.jpg

  1. Connection with Gateway Board.

  • Connect the gateway board to your Raspberry Pi using a USB-C Data Cable.

  • Plug the USB-C Data Cable into the USB-C Data Port 1 on your PC. Ensure a stable connection.

  • Will hear two beeps as a confirmation if successfully connected in gateway mode as confirmation.

  1. Check system status (optional).

  • Use the mosquitto_sub command to check the system status. This command will connect to the Mosquitto MQTT broker and display all messages received.

mosquitto_sub -p 1883 -d -v -t '#'

  1. Access LEAPS Center.

  • In a web browser, access the address 192.168.200.1/24. (This can be opened directly on Raspberry Pi or, on a PC that is connected to the LEAPS-AP network broadcasted by the Raspberry Pi with the password Leaps1234 - Step 9)

  • If you are on a LAN network, use another computer’s web browser to access the Raspberry Pi’s IP address.

  • Configure the network settings in LEAPS Center to match the network ID of the gateway board you have connected.

  1. Login LEAPS Center.

  • Logging in with Username as admin and Password as admin.

../../../_images/raspberry_leaps_center_login.png

  1. Configure the network on LEAPS Center.

  • Check the network settings in LEAPS Center to match the network ID of the gateway board you have connected.

../../../_images/raspberry_pi_leaps_center_udk.png

  • Please refer to the LEAPS Center and LEAPS Manager for more details on how to use the application to configure and visualize the nodes and network.

Now the system has been successfully set up and configured the system. Enjoy using it!

Note

How to reconfigure with any network

  1. Turn Off the LEAPS-AP Wi-Fi AP on Raspberry Pi

  • First, make sure to disable the Wi-Fi Access Point (AP) on your Raspberry Pi.

  1. Connect Raspberry Pi to the Desired Network

  • Connect your Raspberry Pi to the Ethernet or Wi-Fi network you want to use.

  1. Check the IP Address

  • Open a terminal on your Raspberry Pi and check the IP address with ifconfig command

../../../_images/raspberry_pi_check_ip.png

  • Note down the IP address; for example, it might be 192.168.0.104.

  1. Update Corresponding IP Address

  • Open the configuration file for the LEAPS gateway:

    sudo nano /usr/share/LEAPS-DOCKER-LINUX/leaps-gateway-hub/data/leaps-gateway.conf
    ../../../_images/raspberry_pi_leaps_gateway.png

  • Look for the line specifying the IP address and change it to 192.168.0.104.

  • Next, open the configuration file for the LEAPS server:

    sudo nano /usr/share/LEAPS-DOCKER-LINUX/leaps-server-hub/data/leaps-server.conf
    ../../../_images/raspberry_pi_leaps_server.png

  • Again, update this file to reflect the new IP address 192.168.0.104.

  1. Restart LEAPS Server and LEAPS Gateway

  • After making the changes, restart both services:

    sudo docker restart leaps_server

    sudo docker restart leaps_gateway

  1. Confirm LEAPS Server and LEAPS Gateway are Working Properly

  • Check the status of the running Docker containers:

    leaps@raspberrypi:~ $ sudo docker ps
CONTAINER ID   IMAGE                          COMMAND                  CREATED      STATUS          PORTS                                                                                  NAMES
b5bc1d479a04   leapslabs/leaps_gateway:udk   "/app/leaps-gateway …"   6 days ago   Up 15 minutes                                                                                          leaps_gateway
68c33d70bc07   leapslabs/leaps_server:udk    "/app/leaps-server -…"   6 days ago   Up 15 minutes   0.0.0.0:7777->7777/tcp, 0.0.0.0:7777->7777/udp, :::7777->7777/tcp, :::7777->7777/udp   leaps_server
38092ca7b1b1   leapslabs/leaps_center:udk    "sh -c 'cd /app &&  …"   6 days ago   Up 15 minutes   80/tcp, 0.0.0.0:80->8080/tcp, [::]:80->8080/tcp                                        leaps_center

  1. Monitor MQTT Messages

  • To monitor MQTT messages, use:

    mosquitto_sub -p 1883 -d -v -t '#'

  1. Open LEAPS Center and Update Host

  • Launch the LEAPS Center application and update the host address to 192.168.0.104.

  • Ensure to reload the networks to apply changes.

../../../_images/raspberry_pi_leaps_center_reconfig.png

Note

How to Set a Password for Wi-Fi AP: LEAPS-AP

Set the access point security and password on Raspberry Pi OS Bookworm:

sudo nmcli con modify hotspot wifi-sec.key-mgmt wpa-psk
sudo nmcli con modify hotspot wifi-sec.psk "Leaps1234"

Setting up an access point on Raspberry Pi OS Bullseye and older:

  1. Edit Hostapd Configuration. Open the Hostapd configuration file with this command:

sudo nano /etc/hostapd/hostapd.conf

  1. Add the Following Parameters at the End of the File:

wpa=2
wpa_passphrase=Leaps1234
wpa_key_mgmt=WPA-PSK
wpa_pairwise=TKIP
rsn_pairwise=CCMP

  1. Save and Exit

Press CTRL + O to save, then CTRL + X to exit the editor.

  1. Restart Your Raspberry Pi

To apply the changes, restart your Raspberry Pi.

Note

Step-by-step instructions to expand the filesystem for LEAPS Raspberry Pi (For versions prior to v1.1.0)

  1. Open raspi-config. From a terminal on your Raspberry Pi, run:

sudo raspi-config

  1. Navigate to Expand Filesystem. Use the arrow keys and Enter:

Advanced Options -> Expand Filesystem

  1. Confirm Expansion. Select OK when prompted.

You’ll see a message saying the root filesystem will be expanded on the next reboot

  1. Reboot. When prompted, choose Yes to reboot

(or manually reboot later with sudo reboot):

  1. Verify (Optional). After reboot, confirm the disk is fully expanded:

df -h /