Documentation
Everything you need to get started with the Lilian Board
Quick Links
Getting Started
The Lilian Board requires only three components to function: the board itself, an electronic sensor, and an Android device with the Lilian App installed. Follow the steps below to make your first sensor reading.
Hardware Overview
The Lilian Board is a compact PCB featuring USB connectivity and breakout headers for I2C, SPI, UART, and GPIO signals. It is powered entirely by the Android device via USB, so no external power supply is required.
Supported Protocols
| Protocol | Role | Use Case |
|---|---|---|
| I2C | Master | Sensors, displays, RTC modules |
| SPI | Master | High-speed data, ADCs, flash memory |
| UART | Full-duplex | GPS modules, serial debug |
| GPIO | In/Out | LEDs, buttons, relays, interrupts |
Python API
The Lilian App exposes a Python scripting environment. The board operates as the I2C master while a Python script embedded in the Android app orchestrates the operation sequence.
Code Examples
# Read temperature from an I2C sensor
import lilian
board = lilian.Board()
i2c = board.i2c(address=0x48)
temp_raw = i2c.read_register(0x00, 2)
temperature = (temp_raw[0] << 4 | temp_raw[1] >> 4) * 0.0625
print(f"Temperature: {temperature:.2f} °C")