Skip to the content
2 layers40.6 × 27.9 mmBitsoko ESP32-module v2, the printed circuit board in 3D

Bitsoko ESP32-module v2

bitsoko-services/narra

This repository contains hardware designs and software for Narra, an open source, BLE advertising and control, LED signage platform. The project utilises the ESP32 and the ESP-IDF framework.

Size
40.6 × 27.9 mm
Copper layers
2
Thickness
1.6 mm
Parts
6
Nets
38
Pads
85
Tracks, vias
152, 59
Pours
2
Routed
Yes
KiCad
KiCad 5 (file 20170123)
Created
17 Feb 2017
Updated
26 Dec 2017

Overview

Bitsoko ESP32-module v2 is an open-source printed circuit board by bitsoko-services, from the bitsoko-services/narra repository on GitHub, published under the Apache-2.0 licence. It is a 2-layer board of 40.6 × 27.9 mm with 6 parts on 38 nets, routed with 152 tracks and 59 vias.

Its parts include 3 capacitors, 2 connectors and 1 IC. It belongs with the ESP32 boards of this library.

README

README.md

Narra - An LED Signage Development Project

This repository contains hardware designs and software for Narra, an open source, BLE advertising and control, LED signage platform. The project utilises the ESP32 and the ESP-IDF framework. The signage device had to be able to be controlled over BLE via a mobile connection with web bluetooth running on the client web browser that would control the signage device functions such as what to display and change the device state by writing to predefined BLE characteristics.

This repository is Bluetooth v4.2 compliant.

Hardware

The hardware is made with the open-source PCB design tool Kicad. The hardware designs include:

  1. A custom programmer that made using a common commercial off the shelf CP210x UART-USB converter.
  2. The LED driver board as at different versions.
  3. A custom ESP32 module, friendly for development and product placement made from the ESP WROOM32. It is meant to be programmed using the programmer above.

Firmware

The fimware is divided into different components that are abstracted from each other and written in Pure C utilising the ESP-IDF framework and include:

Communication stack:
  1. ble_api- Contains utilities to control the BLE hardware. Interacts directly with the ESP BLE HAL. It is strictly written with multiple level of sanity checks on the input data from user prior to writing to flash.
Other components:
  1. common_api-Contains constants and definitions that persist across source files.

  2. controller_api- Contains the abstraction layer that enables/disables the display as well as verification that the text as UTF-8.

  3. external_libs- External libraries that are used. The one currently used is a modified version of the utf_8 decoder library by Bjoern Hoehrman.

  4. loader_api- API that is used to load from flash newly written variables via BLE. This is done at boot and after update via BLE dynamically.

  5. updater_api- API that is used to update the system variables in flash.

  6. renderer_api- This is the API that is heavily tied to the hardware itself and display method. The current display method is a row-scan method that takes advantage of the human persistence of vision.It also includes a header file containg the implemented character glyphs.

  7. main file- Is used to setup the various tasks and coordinates the various task interactions.

The communication stack is meant to be purely independent of other components thus one could use a TCP/IP or cellular stack and just reuse the same interface and function calls or add to them.

Building and uploading the code to device

Setup development environment using the build script in the utils/build folder:

shell
cd utils/build
sh setup.sh

Now build the firmware and flash to device over UART:

shell
cd ../../../firmware
make flash

The firmware is build for extensibility to support new codepoints under UTF-8.

To add new characters, one just has to:

  1. create the glyphs that represent the characters for that language and add to the existing in renderer_api/include/glyphmap.h . The characters are defined in codepoint ranges. To add a single character, the character range is 1.

  2. Change the allowed character UTF-8 codepoint ranges in common_api/narra_defines "UTF-8 implementation defines" section and add your own following the UTF-8 encoding ranges.

  3. Add the checks for the new codepoint definitions, added above, in the renderer so that your new implementation is recognised.

Contributors

Alois Mbutura "aloismbutura@gmail.com"

Felix omwansa "omwansafelixa@gmail.com"

See CONTRIBUTORS file

Parts

6
QtyValueFootprintReferences
20.1uFCapacitors_SMD:C_0805_HandSolderingC1, C3
2CONN_02X10narra:Pin_Header_Straight_2x10_Pitch2.54mm_8mil_staggeredJ1, J2
122uFCapacitors_SMD:C_1210_HandSolderingC2
1ESP32-WROOM32-MODULEnarra:ESP-WROOM32-MODULEU1

More from bitsoko-services/narra

3
  • 4 layers207.6 × 134.7 mmND-03, the printed circuit board in 3D

    ND-03

    bitsoko-services/narra

    This repository contains hardware designs and software for Narra, an open source, BLE advertising and control, LED signage platform. The project utilises the ESP32 and the ESP-IDF framework.

    130 partsApache-2.0
  • 4 layers232.4 × 53.3 mmND-01, the printed circuit board in 3D

    ND-01

    bitsoko-services/narra

    This repository contains hardware designs and software for Narra, an open source, BLE advertising and control, LED signage platform. The project utilises the ESP32 and the ESP-IDF framework.

    76 partsApache-2.0
  • 2 layers100 × 45 mmESP-32-programmer, the printed circuit board in 3D

    ESP-32-programmer

    bitsoko-services/narra

    This repository contains hardware designs and software for Narra, an open source, BLE advertising and control, LED signage platform. The project utilises the ESP32 and the ESP-IDF framework.

    18 partsApache-2.0

Similar boards

  • 2 layers18.5 × 11.1 mmSwitch, the printed circuit board in 3D

    Switch

    byrantech/laptop

    anyon_e, a highly integrated, high end, open source laptop. Attempt the impossible.

    6 parts4.3kMIT
  • 2 layers14.6 × 33 mmBrain board SD Card 1, the printed circuit board in 3D

    Brain board SD Card 1

    rusefi/rusefi

    rusefi - GPL internal combustion engine control unit

    6 parts1.2k
  • 2 layers9 × 9 mmDpoint, the printed circuit board in 3D

    Dpoint

    Jcparkyn/dpoint

    Open-source digital stylus using camera tracking and inertial measurements

    6 parts1.1kMIT
  • 2 layers51.5 × 16.6 mmMicroswitchXY Endstop, the printed circuit board in 3D

    MicroswitchXY Endstop

    VoronDesign/Voron-Hardware

    Cool Hardware designed by the Voron Design group

    6 parts1.1kGPL-3.0
  • 2 layers21.9 × 76.7 mmAmiga External, the printed circuit board in 3D

    Amiga External

    hoglet67/RGBtoHDMI

    Bare-metal Raspberry Pi project that provides pixel-perfect sampling of Retro Computer RGB/YUV video and conversion to HDMI

    6 parts1kGPL-3.0
  • 2 layers88.9 × 50.8 mmBusinesscard, the printed circuit board in 3D

    Businesscard

    hackclub/OnBoard

    💡 Join 1,000 teenagers and make your first PCB with a $100 grant!

    6 parts915
  • 2 layers20.3 × 15.2 mmL0 RGB led, the printed circuit board in 3D

    L0 RGB led

    Luos-io/luos_engine

    Open-source and real-time orchestrator for cyber-physical-systems, to easily design, test and deploy embedded applications and digital twins.

    6 parts546MIT
  • 2 layers9 × 3.6 mmOpticalEncoder, the printed circuit board in 3D

    OpticalEncoder

    adamb314/ServoProject

    Getting the most out of your hobby servo

    6 parts545

Questions

How big is the Bitsoko ESP32-module v2 PCB?

It measures 40.6 × 27.9 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Bitsoko ESP32-module v2 use?

6 parts. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the Bitsoko ESP32-module v2 KiCad files?

From the bitsoko-services/narra repository on GitHub, at the commit this page was made from: the board is hardware/esp32_module/Bitsoko-ESP32-module-v2.kicad_pcb. PCBKit opens the board in the browser, with nothing to install.

Can I use the Bitsoko ESP32-module v2 design in my own project?

Its repository publishes it under the Apache-2.0 licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).