Installation Guides

Instructions for how to set up Black Lager

Components of Black Lager

You will need the following parts to use the Black Lager network.

  • LoRa radio running the Black Lager firmware
  • The Black Lager Messaging client

Supported Hardware

  • LILYGO Lora v2.1-1.6
  • LILYGO T-Beam
  • Note: Other models listed here may also work, but they have not been tested with the Black Lager firmware or application

Flashing Radio Device with Black Lager Firmware

Install Prerequisite Software
Python3 and pip are required for Black-Lager. Check if you have python3 and pip installed with the following command, if not please install them.

python3 --version

pip3 --version

To install esptool

pip3 install --upgrade esptool

To test if esptool is working

esptool chip_id

You should see a result similar to this:

mydir$ esptool chip_id
esptool.py v2.6
Found 2 serial ports
Serial port /dev/ttyUSB0
Connecting....
Detecting chip type... ESP32
Chip is ESP32D0WDQ6 (revision 1)
Features: WiFi, BT, Dual Core, 240MHz, VRef calibration in efuse, Coding Scheme None
MAC: 24:6f:28:b5:36:71
Uploading stub...
Running stub...
Stub running...
Warning: ESP32 has no Chip ID. Reading MAC instead.
MAC: 24:6f:28:b5:36:71
Hard resetting via RTS pin...

Next step is to locate the firmware file you have downloaded, and open the directory in terminal. Run the code below to flash the firmware on your device.

bin/device-install.sh -f FIRMWARE_PATH.bin


Messaging Client

To install the Black Lager messaging client run pip install blacklager.