BSides Leeds ESP32 LoRa Badge – Flashing Guide

Firstly Install the Arduino IDE from https://www.arduino.cc/en/main/software

Once installed go to Files -> Preferences under “Additional Board Manager URLs” add https://dl.espressif.com/dl/package_esp32_index.json

Then go to Tools -> Board -> Board Manager and search for ESP32. You should have ESP32 by espressif, install this set of boards.

You should then be able to go Tools -> Boards and select “Heltec_Wifi_LoRa_32”

Next to to Tools -> Port and select the apropriate port the dev board is connected to (Windows users will probably need to installed the USB to UART drivers from https://www.silabs.com/products/development-tools/software/usb-to-uart-bridge-vcp-drivers

Note the board will normally need to be plugged in for the serial port to be present.

Next go to Tools -> Upload Speed to 115200.

Finally got to Sketch -> Manage library and add
ESP8266 and ESP32 Oled Driver for SSD1306 by Daniel Eichorn, Fabrice Weinberg and LoRa by Sandeep Mistry


This should give you an IDE capable of sending compiling the firmware and flashing it onto the dev board

You can obtain Mark’s firmware from https://github.com/unprovable/LoRaChat <Check, the final build may move>

Once you have the .ino file open in the UI, select Sketch -> Upload to send it (it’ll compile it first if needed).

A few seconds later, the firmware should be on the device.

If you’re struggling, there is a more complete guide at https://robotzero.one/heltec-wifi-kit-32/ (just remember to select the LoRa board).

BSides Leeds LoRa Badge Guide – Usage

This Info is also available online at<insert URL>

First get yourself a ESP32 LoRa board (details, including a link to get the next-day via Amazon Prime can be found <link to SBG Engineering Blog for page for Quick Start Guide>) and pop along the the SBG Flashing Station to get BSides Leeds 2019 custom Challenge firmware on it.

Receiver Only

To receive broadcast messages (both from BSidesLeeds and other attendees) just apply power to the USB connector and watch the messages appear on the mini OLED screen.

Transmitter & Receiver

Connect the USB port to some kind or serial terminal. The guide assumes they’ll be some kind of Windows, Mac or Linux host, but we’re sure other people will be more creative.


Connecting

Start by lugging the board into your computer then :-

Windows

Install USB UART driver from https://www.silabs.com/products/development-tools/software/usb-to-uart-bridge-vcp-drivers and check you have a new port in device manager when the board is plugged in (normally COM3)

Next install PuTTY, from https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html and configure as follows (Connection Type: Serial, Serial Line: <from above, normally COM3>, Speed 115200)

Hit open and you should get something like the screen below

OSX & Linux

Doing screen /dev/ttyUSB0 115200 in a shell should give you something line the screen below

<Insert Pic>

Usage

LoRa is a low-power, low-bitrate but very long range radio protocol suitable for sending small amounts of data a long way.

Your badge is a LoRa based chat system. Choose a Nick then type away. Message received will be shown on the OLED screen on the badge.

Look out for special BROADCAST announcements during the day.


Beyond simple chat

The firmware source is available from https://github.com/unprovable/BSidesLeeds2019 . Feel free to take it and modify it.

BSides Leeds ESP32 LoRa Badge Quick Start Guide

It’s probably no great surprise that once again the BSides 2018 Badge is also a PCB.

However most people don’t get the chance to have fun with their badges until the get home, but as this years badge is all about interaction, SBG have teamed up with BSidesLeeds to help you actually take part on the day.

What you need?

The heart of the badge is a LoRa ESP32 Board. These were originally designed by Heltec as “ESP32 OLED LoRa Development Boards” intended for IoT device/sensor development. For this badge, an original or any of its 23mm pitch pin-compatible copies are fine.

You can get them much cheaper of Ali Express, but to get them in time for the conference and if you’re an Amazon Prime customer you can get them from here (though any board with a compatible pin-out is likely to work)

https://www.amazon.co.uk/gp/product/B078M74NNN

You then need need something to act as a keyboard interface and power source, a laptop works fine with a USB cable works fine, but we’re sure some of you will come up with inventive alternatives.

It would be nice to solder them on the day, but the venue doesn’t allow for that, so the good new is, you can actually get it working without the board.

Then what?

The easy way? Just turn up to the SBG Firmware Flashing Station (located in the <insert place> with your LoRa board and we’ll drop @LargeCardinal’s custom firmware on it, pass you some info <link tbc> on how to hook it up to a PC/Mac/Linux box and let the magic begin.

Easy as that!

However, if you want to do it all yourself, see this guide <link tbc>