# Quickstart - Micro\_Ledger

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!

<figure><img src="https://3326058433-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYSjOqnJTe0DZqDoQNIrF%2Fuploads%2FYDORx8ACMWtfbAhZlNIG%2FUntitled%20design(16).png?alt=media&#x26;token=7397cb8e-7356-4d14-a435-c9d919b57c44" alt=""><figcaption></figcaption></figure>

Built with a Seeed Studio Xiao ESP32 S3, a 900mAh battery, and open-source code from our ESP32-XRPL repository [GitHub](https://github.com/Handy4ndy/ESP32-XRPL/tree/main/Little_Ledger), the Micro\_Ledger empowers you to monitor transactions, learn IoT programming, and contribute to the XRPL/Xahau ecosystems.&#x20;

Whether you’re a developer crafting custom apps or a blockchain enthusiast staying connected, this guide will get you started fast.&#x20;

***

**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++.

<figure><img src="https://3326058433-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYSjOqnJTe0DZqDoQNIrF%2Fuploads%2FKEH802PSczKl0tJXoLna%2FScreen%2BShot%2B2021-02-17%2Bat%2B18.00.37.png?alt=media&#x26;token=81f2d8ee-d7bb-4c8f-9f69-eba154e4476e" alt=""><figcaption></figcaption></figure>

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

1. Download and install the Arduino IDE from [arduino.cc](https://www.arduino.cc/en/software).
2. Open the IDE and prepare to configure it for ESP32.

<figure><img src="https://3326058433-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYSjOqnJTe0DZqDoQNIrF%2Fuploads%2FDAeEiFHTqftMnBvsLd4T%2F6.png?alt=media&#x26;token=fd0d17c9-ab7b-43f6-9e96-2938575d932c" alt=""><figcaption></figcaption></figure>

Step 2: Add ESP32 Board Support

1. Go to File > Preferences.
2. In Additional Board Manager URLs add <https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json>
3. Navigate to Tools > Board > Boards Manager, search for “ESP32,” and install the esp32 package by Espressif Systems.

<figure><img src="https://3326058433-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYSjOqnJTe0DZqDoQNIrF%2Fuploads%2FXUlCqKrIYKOQ1vdp72bx%2F9.png?alt=media&#x26;token=fc02d877-5ba3-4184-8390-54733b8c1bdd" alt=""><figcaption></figcaption></figure>

Step 3: Install Required Libraries

1. Go to Tools > Manage Libraries.
2. Install the libraries:
   * WebSockets (by Markus Sattler)
   * ArduinoJson (by Benoit Blanchon)
   * Adafruit\_GFX\_Library (by Adafruit)
   * Adafruit\_SSD1306 (by Adafruit)
   * Preferences (by Volodymyr Shymanskyy)

<figure><img src="https://3326058433-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYSjOqnJTe0DZqDoQNIrF%2Fuploads%2FOxvbNHQYKE5iYLm7QRhX%2FScreenshot%20from%202025-09-02%2014-13-56.png?alt=media&#x26;token=a75472a1-d106-4072-81b0-a2087ccf81c8" alt=""><figcaption></figcaption></figure>

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](https://learn.sparkfun.com/tutorials/how-to-install-ch340-drivers#drivers-if-you-need-them)
    * CH340/CH341: [WCH CH340 Driver](https://learn.sparkfun.com/tutorials/how-to-install-ch340-drivers#drivers-if-you-need-them)
  * 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](https://github.com/adrianmihalko/ch340g-ch34g-ch34x-mac-os-x-driver).
  * 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 $USER    
  ```
  * Log 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 <a href="#testing-example-01.-blink" id="testing-example-01.-blink"></a>

Welcome to the Micro\_Ledger Test Script, your key to unlocking the full potential of this fully assembled, sleek wearable device!&#x20;

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 <a href="#clone-the-repository" id="clone-the-repository"></a>

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.git
```

* &#x20;From the Arduino IDE, Navigate to Micro\_Ledger folder and load the ConnectionTest.ino file.

<figure><img src="https://3326058433-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYSjOqnJTe0DZqDoQNIrF%2Fuploads%2FtMnUzZRBUtOUTn60SL2L%2FScreenshot%20from%202025-09-02%2020-51-19.png?alt=media&#x26;token=31a82ea7-220f-41ec-bb5d-02a2aa8ad6ab" alt=""><figcaption></figcaption></figure>

**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.

<figure><img src="https://3326058433-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYSjOqnJTe0DZqDoQNIrF%2Fuploads%2Fjs4FUVLDxn3Bo7J9ARiQ%2FScreenshot%20from%202025-09-02%2021-12-05.png?alt=media&#x26;token=15458b27-be3a-4dcf-b8ea-521f9abf122e" alt=""><figcaption></figcaption></figure>

**Step 3: Upload the connectionTest.ino file**

Select Upload in the Arduino IDE to program the Micro\_Ledger

<figure><img src="https://3326058433-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYSjOqnJTe0DZqDoQNIrF%2Fuploads%2FIRNBXappzFPYkbTvAOL3%2FScreenshot%20from%202025-09-02%2021-18-47.png?alt=media&#x26;token=37d76e1f-c00c-431b-9b68-112fca29adc6" alt=""><figcaption></figcaption></figure>

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.