Quickstart - Micro_Ledger
Welcome to the Little_Ledger Micro_Ledger Getting Started Guide!
Ready to take blockchain on the go? The Micro_Ledger is your wearable gateway to the XRP Ledger and Xahau Network, fusing the Internet of Things with the Internet of Value in a sleek, portable design. With vibrant audio alerts, dazzling visual displays on its 0.96" OLED screen, and subtle haptic feedback, this device brings real-time blockchain data to you on a lanyard making it tangible, interactive, and personal!
Built with a Seeed Studio Xiao ESP32 S3, a 900mAh battery, and open-source code from our ESP32-XRPL repository GitHub, the Micro_Ledger empowers you to monitor transactions, learn IoT programming, and contribute to the XRPL/Xahau ecosystems.
Whether you’re a developer crafting custom apps or a blockchain enthusiast staying connected, this guide will get you started fast.
Set Up Your Environment
The Arduino Integrated Development Environment (IDE) is an open-source, user-friendly platform designed for programming microcontrollers, offering a simple interface for writing and uploading code with support for C and C++.
Let’s get your Micro_Ledger ready to roll! Follow these steps to set up your software and hardware environment.
Step 1: Install Arduino IDE
Download and install the Arduino IDE from arduino.cc.
Open the IDE and prepare to configure it for ESP32.
Step 2: Add ESP32 Board Support
Go to File > Preferences.
In Additional Board Manager URLs add https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json
Navigate to Tools > Board > Boards Manager, search for “ESP32,” and install the esp32 package by Espressif Systems.
Step 3: Install Required Libraries
Go to Tools > Manage Libraries.
Install the libraries:
WebSockets (by Markus Sattler)
ArduinoJson (by Benoit Blanchon)
Adafruit_GFX_Library (by Adafruit)
Adafruit_SSD1306 (by Adafruit)
Preferences (by Volodymyr Shymanskyy)
Step 4: Install USB-to-Serial Drivers
Your ESP32 (NodeMCU-32S) needs a USB-to-serial driver to communicate with your computer. The driver depends on your OS and the ESP32’s chip (CP2102 or CH340/CH341).
Windows:
Install the driver for your ESP32’s chip:
CP2102: Silicon Labs CP2102 Driver
CH340/CH341: WCH CH340 Driver
Check for a COM port in Arduino IDE under Tools > Port.
macOS:
CP2102: Usually built-in (Catalina+); no driver needed.
CH340/CH341: Install from here.
Allow the driver in System Settings > Security & Privacy if prompted.
Look for /dev/cu.usbserial-* in Tools > Port.
Linux:
Most distributions support CP2102/CH340 natively.
Add your user to the dialout group
sudo usermod -a -G dialout $USERLog out and back in.
Look for /dev/ttyUSB0 in Tools > Port.
If the port doesn’t appear, use dmesg to troubleshoot.
Pro Tip: Use a high-quality USB cable with data lines (not power-only) to avoid connection issues.
Testing - connectionTest.ino
Welcome to the Micro_Ledger Test Script, your key to unlocking the full potential of this fully assembled, sleek wearable device!
This script is your first step to ensuring every component shines, delivering audio, visual, and tactile feedback as you explore blockchain on the go.
Step 1 : Clone the repository and open connectionTest.ino
Clone the Repository
You can use the following command, download a Zip file or Clone our repository from GitHub
https://github.com/Handy4ndy/ESP32-XRPL
git clone https://github.com/Handy4ndy/ESP32-XRPL.gitFrom the Arduino IDE, Navigate to Micro_Ledger folder and load the ConnectionTest.ino file.
Step 2: Assign Board XIAO ESP32S3 to your Port.
Connect the Micro_Ledger to your computer with a high-quality USB cable, open the Arduino IDE and select the "select other board and port" from the drop down next to the upload buttons (top left).
A window will appear allowing you to type in XIAO to assign the board to your port, If the ESP32 board is not appearing try a different USB cable and double check serial ports have been configured correctly.
Step 3: Upload the connectionTest.ino file
Select Upload in the Arduino IDE to program the Micro_Ledger
When the upload is complete you will be able to press the button on the bottom of the device to trigger the connection test, you should notice the message on the screen change, the vibration motor activate and the speaker play a sound.
If you have completed this test Congratulations your Micro_Ledger is setup and you may proceed to the nexts steps to configure your device to receive transaction notifications, monitor your server or the latest price action with the XRP / RLUSD pair.
Last updated