Getting Started

Everything you need to set up your Aillo system and start building. From board setup and module installation to mobile app configuration, naming conventions, and your first project.

Requirements

What You Need

Getting started with Aillo requires just a few components. Pick a board, grab some modules, power it up, and connect with the mobile app.

Board
2x3 or larger
2+ Modules
e.g. Button + LED
USB-C Cable
5V 2A power
Mobile App
Android or iOS
Setup

Board Setup

1

Connect the board to a USB-C power source (5V, 2A minimum).

2

System LED shows purple — board is paused.

3

Place modules on the slots — they snap in via pogo pins.

4

Board auto-detects each module and its rotation.

5

Long-press the button to enable Bluetooth.

System LED

Red blinkError
Yellow blinkWarning
Green staticRunning
Purple staticPaused

BLE LED

OffDisabled
Blue staticReady
Blue blinkConnected
App

Mobile App

Available on both platforms.

Android

Requires: Android 7.0+ (API 24)

Built with: Kotlin + Material Design

iOS

Requires: iOS 15.0+

Built with: Swift + Programmatic UI

Workflow

Creating a Project

Open the app, place modules on the canvas, draw connections, and send everything to the board wirelessly.

1

Open the app and create a new project.

2

Add modules from the library sidebar.

3

Arrange to match your physical board layout.

4

Draw connections between flows (input → output).

5

Connect via BLE and send the configuration.

6

Press the board button to Play.

Reference

Naming Scheme

Every product carries a 15-digit numeric SKU, laser-engraved as a QR code so it can be scanned rather than read. Revision is deliberately not part of it — a SKU names a product, and the unit reports its own hardware revision when it is plugged in.

Modules

001 001 CCC SSS NNN
MMM
Manufacturer
001 = Aillo
CLS
Class
001 = Module
CAT
Category
001 = HID
SUB
Subcategory
001 = Buttons
ITM
Item
001 = First

Example: 001001001001001 = Aillo > Module > HID > Buttons > Push Button

Boards

001 002 FFF CCC RRR
MMM
Manufacturer
001 = Aillo
CLS
Class
002 = Board
FAM
Family
001 = Classic
COL
Columns
003 = 3 cols
ROW
Rows
002 = 2 rows

Example: 001002001003002 = Aillo > Board > Classic > 3×2 grid (6 slots)

The first six digits are the same for every product; the last nine mean whatever the class defines. Manufacturer and class codes are assigned from a public registry, so a scanner resolves any product without knowing who made it.

Need Help?

Can't find what you're looking for? Reach out to us.

Contact Us