search

btcven / radio-firmware

The firmware for the radio module
https://locha.io
Apache License 2.0
7 stars 10 forks source link
locha-mesh lochamesh mcu mesh network off-grid radio turpial

readme


Project Website | Donate | Sponsor | Buy

Radio Firmware

Important!!

The development of this code continues in the turpial-firmware repository.

Here you can find the main firmware for your device compatible with Locha Mesh (the radio) and be aware of our development process.

What's Locha Mesh?

The Locha Mesh network is a secure radio network for text messaging and bitcoin transactions. The main objective is a long range network for everyone and everywhere, for this reason, we are working not only in a protocol, also the firmware for affordable devices like our "Turpial".

If you want to learn more about Locha Mesh feel free to read the Locha Mesh main repository or take a look at our website locha.io.

Sponsor.

If you want to support this project you can make a donation to the Locha Mesh effort to build a private censorship-resistant mesh network devices for Bitcoin and Lightning Network payments without Internet.

Here are some places if you want to support us:

Supported boards.

This firmware should run on all the platform that Contiki-NG supports, however our main focus is to support the SimpleLink MCUs, these are the ones used in the Turpial board, mainly the CC1312R.

Table of Contents.

Radio Firmware

What's Locha Mesh?

Sponsor.

Supported boards.

License.

Getting started.

First start by cloning the repository:

git clone https://github.com/btcven/radio-firmware.git

cd radio-firmware

git submodule update --init --recursive

Next you need to install the necessary tools to build and correctly flash Turpial's radio-firmware :

Development workflow

Development happens in the dev branch, all of the Pull-Requests should be pointed to that branch. Make sure you follow the CONTRIBUTING.md guidelines. All Pull-Requests require that at least two developers review them first before merging to dev branch.

Install build essentials (make, etc).

Install ARM compiler.

You should download it from GNU-RM Downloads.

On Ubuntu/Any Linux Distribution.

wget https://developer.arm.com/-/media/Files/downloads/gnu-rm/9-2019q4/RC2.1/gcc-arm-none-eabi-9-2019-q4-major-x86_64-linux.tar.bz2

tar xjf gcc-arm-none-eabi-9-2019-q4-major-x86_64-linux.tar.bz2

This will create a directory named gcc-arm-none-eabi-9-2019-q4-major-x86_64-linux in your current working dir. Add <working-directory>/gcc-arm-none-eabi-5_2-2015q4/bin to your $PATH.

Windows.

arm-gcc(GNU-RM Downloads) has a downloadable installer for the GCC ARM compiler. Make sure after you have installed it that it is on your PATH, if not add it.

Install Uniflash.

Install TI's Uniflash tool for your operating system. This tool allows you to upload the built firmware to the CC1312R radio module.

Compiling the project.

The build process is very simple, just call make and it will build the firmware. The built firmware is located under the bin/ directory.

make

Testing with Renode.

Currently we can test the code without using the actual SimpleLink radio MCU, for this case we use Renode as our emulation environment. This allows us to develop and test with more flexibility.

To build and test with renode set these environment variables:

export BOARD=cc2538dk
export RENODE_CONFIG=$(pwd)/dist/board.resc

Then build the firmware:

make

To run Renode, from the command line execute this:

make emulate BOARD=cc2538dk

Note: renode needs to be in your path.

License.

Copyright © 2019 Bitcoin Venezuela and Locha Mesh developers.

Licensed under the Apache License, Version 2.0

A text quote is shown below

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Read the full text: Locha Mesh Apache License 2.0