Sensiq

A small desktop companion built on the ESP8266. It displays animated faces on a 0.96" OLED and reacts to motion and gestures using an accelerometer and gesture sensor. A behavioral logic engine changes its expressions based on how you interact with it or whether you ignore it.

No cloud, no microphone, no app. Everything runs locally on the chip.

---

Hardware

Component	Role
ESP8266 12F	Microcontroller
0.96" OLED (128x64)	Display
ADXL345	Motion and shake detection
APDS9960	Gesture and RGB sensing
VL53L0X	Time-of-Flight distance sensor (3mm to 1.2m)
BMP280	Temperature and pressure sensor
AMS1117	3.3V voltage regulator
TP4056	Li-ion charging (optional, for future battery builds)

---

Interaction

All input is gesture and motion based. There are no buttons.

Input	Action
Shake	Switch modes
Swipe left / right	Navigate options or logs
Swipe up / down	Select or confirm
Repeated slow swipes	Triggers happy state
Rapid repeated swipes	Triggers shy state, device goes quiet

Behavioral states

• Idle: Cycles through random face animations when left alone.
• Happy: Triggered by slow, repeated gesture input.
• Shy: Triggered by too many rapid inputs. Retreats to minimal idle faces.

---

Features

Animated Faces

Default idle state. Displays randomized expressions and reacts to interaction patterns.

Session Logging

Track work or study sessions without using your phone.

Flow: Shake to enter mode, Swipe L/R to pick an activity, Swipe Up to start, Shake to exit.

Environment Monitor

Reads temperature and atmospheric pressure from the BMP280 in real time.

Clock

A minimal HH:MM:SS display.

Distance Measurement

Live distance readings from the VL53L0X sensor. Range: 3mm to 1.2m.

---

Setup

Hardware

Wire components according to the schematics in /hardware.

Software

1. Open firmware/sensiq.ino in Arduino IDE.
2. Install the following libraries via Library Manager:
   • Adafruit SSD1306
   • Adafruit GFX
   • Adafruit APDS9960
   • Adafruit BMP280
   • VL53L0X
3. Under board settings, select Generic ESP8266 Module.
4. Connect via USB and flash.

---

Project Structure

Sensiq/
├── firmware/        # ESP8266 Arduino (.ino) source
├── hardware/        # Schematics and wiring diagrams
├── docs/            # Interaction flowcharts and design notes
├── images/          # Photos and demo recordings
└── README.md

---

License

Open source. Use it, modify it, build on it.