This repository contains the Libertas Hub release for Raspberry Pi 2, Raspberry Pi 3, and Raspberry Pi 4.
Libertas Hub is an IoT (Internet of Things) central controller with an IoT App design, Thing-App.
Libertas Hub connects to other IoT devices and enables end-users to run Thing-App to interact with those devices.
Libertas Thing-App is "write once, run everywhere" written in TypeScript. Our goal is to enable trillions of devices to run Thing-App directly. Libertas Hub is the first and most important step.
Libertas is designed to reach billions of users and cover trillions of CPU/MCU chips. With its simple yet disruptive design, We are confident Libertas will lead in the following decades.
You will need:
- A Raspberry Pi 2, 3, or 4 board.
- A microSD card as main storage. A size of >= 16GB is recommended; 8 GB is the minimum.
- A nRF52840 Dongle. It costs about USD 10.
- A USB thumb drive as backup storage. The Hub must have dual storage backup. Also, the thumb drive is IoT data storage.
Get the zip file for your Raspberry Pi model from the latest release (https://github.com/LibertasIoT/libertas-rpi-img/releases) and extract the zip file.
The nRF52840 Dongle is required as a radio transceiver. Use the nRF tool below to program Hornet transceiver firmware into the dongle.
Follow this link (https://www.nordicsemi.com/Products/Development-tools/nrf-connect-for-desktop).
The download link is on the left side of the webpage.
Install the software. Then launch the software. Note that we only need the "programmer App," as shown in the screenshot below.
First, click the "Add file" button in the upper left part of the window. Next, choose the .img file that comes with the zip file. The file name should be:
nrf52840-transceiver.img.hex
Then plug the dongle into the USB port of the machine. Wait for a few seconds. There should be a "USB plug-in sound" on the Windows platform.
Press the "horizontal button" on the dongle, as shown in the picture below. The dongle shall be in programming mode.
Then choose the dongle from the "SELECT DEVICE" button on the uppermost left side.
The correct device shall be an "Open DFU bootloader."
As the last step, click the "write" button on the left, and wait for the writing progress to finish.
A windows will popup to notify that the write is successful.
Unplug the dongle and plug it into a USB port of the Raspberry Pi. It is OK to use a USB 1.1 or 2.0 port.
It is recommended to use Rufus to write to a microSD card. You can download Rufus from https://rufus.ie/.
We have taken the public download off line. Contact founder, Mr. Qingjun, for the latest image of the Libertas Hub.
Choose the microSD card and the Raspberry Pi image. Leave all other parameters with their default values and click START to initiate the writing process. The image file shall be something like the below,
libertas-raspberrypiN_2022XXXXXXXXXX_fullsd.img
Two warning dialogs may pop up.
Press "OK" on each dialog to proceed.
Once Rufus is done writing the micro SD card. Remove the card from the PC and plug it into your Raspberry Pi.
Make sure the nRF52840 Dongle and USB drive are also plugged in. Then power up your Pi.
iOS App is always 10% behind and it is not released yet.
Follow the linkes below to download Android App.
There is a button on the dongle. Please ensure you can still access the button while the dongle is plugged into the Raspberry Pi. During Hub admin processes, you may be asked to press the button to prove that you have physical access to the Hub.
Follow this instruction to set up the Hub using Libertas Android App.
https://librehome.com/doc/smartphone_app/managing_hubs/add_a_new_hub/
Note that Raspberry Pi Hub will not be able to use our bridge service. Instead, you will need to set up the dynamic DNS and NAT to access the Hub from the Internet through our Libertas Smartphone App.
