We are happy of your visit and that you can read more about us. Here you can find the main firmware for your device compatible with Locha Mesh and be aware of our development process.
The Locha Mesh network is a secure radio network for text messaging and bitcoin transactions. The main objetive 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 this repository or take a look at our website locha.io.
The development code is located on the dev branch, all the development
happens there and all of the Pull-Request should be pointed to that branch.
Make sure your Pull-Request follows the CONTRIBUITING.md guidelines.
To compile the firmware (and to flash it) we use the Platform IO IDE, it's available as a VS Code Extension primarily, however it can be used as a standalone CLI too without the need to install another editor, please refer to the Platform IO website to see supported installation methods.
For example to build your project you can run this command on a CLI that has PlatformIO:
pio run -e featheresp32 --target uploadThat command will build the project and upload the binary to the ESP32 you have
connected, the -e featherep32 specifies the board model you have. Currently
the supported boards are:
featheresp32wemosbatesp32doit-devkit-v1
If your ESP32 development board isn't listed here you can modify the
platformio.ini file and submit a Pull-Request adding the board.
To ensure the safety of code we run some tests in the ESP32 to ensure the code
works as expected, the testing code lives in the test/ directory. To compile
a test you can run the following command:
pio test -e featheresp23 -f test_wifiPlease note that you can change featheresp32 for the board of your choice,
and you can change -f test_wifi to the test you want to run, or you can
remove it to run all tests.
You can compile the code documentation by installing the following tools:
Now you can just checkout to the doc/ directory and run:
make htmlThe documentation will reside in doc/build/_html/, from there you can open
index.html.
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