Skip to the content
2 layers20 × 47.3 mmADAPTER PCB, the printed circuit board in 3D

A long-range low-power radio interface for Ethereum nodes

Size
20 × 47.3 mm
Copper layers
2
Thickness
1.6 mm
Parts
17
Nets
19
Pads
53
Tracks, vias
73, 21
Pours
1
Routed
Yes
KiCad
KiCad 7 (file 20221018)
Created
16 Aug 2023
Updated
20 Mar 2024

Overview

ADAPTER PCB is an open-source printed circuit board by OxMarco, from the OxMarco/ethereum-lora repository on GitHub, published under the MIT licence. It is a 2-layer board of 20 × 47.3 mm with 17 parts on 19 nets, routed with 73 tracks and 21 vias.

It is built around the E22-400T30D, CH340X and 917-181A202ED60200. Its parts include 5 capacitors, 2 ICs, 1 resistor, 1 diode and 1 connector. It belongs with the radio and wireless and interfaces and adapters boards of this library.

Main components

3

README

README.md

Ethereum LoRa

Header

Abstract

Ethereum LoRa is a project aimed at adding a LoRa radio interface to Ethereum nodes. By doing so, it becomes possible to query a node with JSON-RPC commands even in locations where Wi-Fi or cellular connectivity is absent. This enhancement allows Ethereum-based services to run in rural or underdeveloped areas of the world, fostering crypto adoption.

About LoRa

The LoRa Communication System is an innovative project designed to facilitate seamless and efficient communication using the LoRa protocol. Aimed at establishing a reliable medium for data transmission even in challenging conditions, our solution stands as a testament to the powerful blend of software ingenuity and hardware capabilities. Whether it's for remote sensing applications, IoT devices, or any scenario where traditional connectivity might falter, our system ensures that your data reaches its destination.

Technical Details

The software interfaces with the Ethereum node and the LoRa E22 module, allowing bi-directional communication. When the system starts, it sets up the LoRa module with specific configurations. Users can input JSON payloads, which are then sent via the LoRa interface to an Ethereum node. The system also listens for incoming messages from the Ethereum node, which can then be parsed and presented to the user.

How It Works

At its core, our system relies on the LoRa (Long Range) protocol, a patented digital wireless data communication technology. Through a combination of software controllers and hardware integrations, the system listens for incoming LoRa messages and parses them for further processing. Depending on the message type—whether it's a handshake or a request—the controller can efficiently interpret and respond to the data.

Assumptions

  • The devices used are compatible with the LoRa E22 chip model.
  • The data communicated is structured in JSON format with specific fields, such as "message_type", to allow the system to differentiate between different types of messages.
  • The environment variables are correctly set for chip model, serial port, and other necessary pins.

Implementation

We've designed a modular approach, with a main driver program that leverages two key components: the ConfigManager and LoRaController. The ConfigManager handles configuration retrieval while the LoRaController manages the setup, listening, and sending of LoRa messages. When data is received, it's parsed based on its message type and, if it's a request, further extracted to ensure clean and valid JSON content.

Running the Project Locally

  1. Ensure you have Python installed (version 3.x recommended).
  2. Clone the repository:
    text
    git clone <repository_url>
  3. Navigate to the project directory.
  4. Install the required libraries:
    text
    pip install -r requirements.txt
  5. Set the necessary environment variables (like LORA_CHIP_MODEL, SERIAL_PORT, etc.).
  6. Run the application:
    text
    python client.py
    Or
    text
    python server.py

Hardware

The BOM is very basic, consisting of a LoRa UART module and a simple PCB TTL-to-UART adapter. pcb render Pins at the bottom of the PCB allow users to upgrade the firmware or select a different working mode, for instance to support re-broadcasting, a form of basic mesh networking.

Acknowledgements

A big thanks goes to the Ethereum Foundation for sponsoring this project under their "Run a Node" program.

Parts

17
QtyValueFootprintReferences
4TestPointTestPoint:TestPoint_Pad_D1.0mmTP1, TP2, TP3, TP4
30.1uFCapacitor_SMD:C_0603_1608MetricC1, C3, C4
110uFCapacitor_SMD:C_0805_2012MetricC2
11AFuse:Fuse_0805_2012MetricF1
11kResistor_SMD:R_0603_1608MetricR3
147uFCapacitor_Tantalum_SMD:CP_EIA-3528-15_AVX-HC5
1917-181A202ED60200FOOTPRINTS:USB-A-TH_917-181A202ED60201J1
1CH340XPackage_SO:MSOP-10_3x3mm_P0.5mmU2
1E22-400T30DFOOTPRINTS:COMM-TH_E22-400T30DU1
1M0Connector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_HorizontalJP1
1M1Connector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_HorizontalJP2
1STATLED_SMD:LED_0603_1608MetricD1

Similar boards

  • 2 layers150.2 × 80.4 mmEsquema, the printed circuit board in 3D

    Esquema

    CactusRockets/Weiss_Placas

    Aqui colocaremos as placas do projeto, arquivos vindos do EAGLE e KiCAD

    23 parts1
  • 6 layers60 × 55 mmPoE Ethernet GPIB Adapter, the printed circuit board in 3D

    PoE Ethernet GPIB Adapter

    Kofen/PoE_Ethernet_GPIB_Adapter

    This folder contains the necessary hardware files for the PoE Ethernet GPIB Adapter project.

    198 parts120GPL-3.0
  • 2 layers36.4 × 18.9 mmCh340x, the printed circuit board in 3D

    Ch340x

    openwch/ch34x

    CH340, CH343, CH342, CH344,CH348

    14 parts42
  • 2 layers100 × 100 mmZxevo1010 main, the printed circuit board in 3D

    Zxevo1010 main

    UzixLS/zxevo1010-board

    10x10cm PCB variant of ZX-Evolution project for G738/G706 enclosure

    252 parts26
  • 4 layers100 × 100 mmGammaSpectrometer, the printed circuit board in 3D

    GammaSpectrometer

    RobertGawron/GammaSpectrometer

    Device for quantitative analyze energy spectra of gamma-ray sources. Allows to study what radioactive isotopes in what quantities are present in measured sample.

    326 parts16MIT
  • 4 layers102 × 100 mmZelvicka, the printed circuit board in 3D

    Zelvicka

    RoboticsBrno/Robutek

    Robůtek je robotická platforma založená na čipu ESP32-S3. Je velice rozšitiřelný, ale ze základu umí jezdit, kreslit fixou, jezdit po čáře, pohybovat se bludištěm. Programování je přes Jaculus.

    214 parts12
  • 2 layers150 × 68 mmController, the printed circuit board in 3D

    Controller

    candykingdom/firefly2

    Small blinkenlight boards that sync up using radios

    194 parts5
  • 4 layers46 × 100 mmMusic32v3, the printed circuit board in 3D

    Music32v3

    Thecactusman0/Music32-V3

    Portable music player

    183 parts3GPL-3.0

Questions

How big is the ADAPTER PCB PCB?

It measures 20 × 47.3 mm and has 2 copper layers, 1.6 mm thick.

What parts does the ADAPTER PCB use?

17 parts, built around the E22-400T30D, CH340X and 917-181A202ED60200. 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 ADAPTER PCB KiCad files?

From the OxMarco/ethereum-lora repository on GitHub, at the commit this page was made from: the board is pcb/ADAPTER PCB/ADAPTER PCB.kicad_pcb and its schematic pcb/ADAPTER PCB/ADAPTER PCB.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the ADAPTER PCB design in my own project?

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