How infinitimeorg/infinitime works
InfiniTime is open-source PineTime smartwatch firmware. The principal workflow is user interaction with watch faces and apps, which present time, health, utility, and settings features using firmware controllers and device hardware. Companion apps communicate with the watch over BLE for notifications, data exchange, and updates; the repository also includes a Python DFU client. The graph reflects documented capabilities and sampled wiring; some screen-to-service and BLE-service details are represented at subsystem level because their implementations were not sampled.
Main entry points: NimbleController.cpp BLE controller · main.cpp System task · DisplayApp.cpp Display app · FS.cpp Filesystem
Components 19
Watch interface
- Display app
src/displayapp/DisplayApp.cpp - Apps and watch faces
src/displayapp/screens
Device services
- Device controllers
src/components - Date and time
src/components/datetime/DateTimeController.cpp - Motion and steps
src/components/motion/MotionController.cpp - Alarm
src/components/alarm/AlarmController.cpp - Filesystem
src/components/fs/FS.cpp
Connectivity and updates
- BLE controller
src/components/ble/NimbleController.cpp - BLE services
src/components/ble - Service discovery
src/components/ble/ServiceDiscovery.cpp - DFU client
bootloader/ota-dfu-python/dfu.py - DFU service
src/components/ble/DfuService.cpp - Firmware validator
src/components/firmwarevalidator/FirmwareValidator.cpp
Runtime and hardware
- System task
src/main.cpp - FreeRTOS
src/FreeRTOS - Flash storage
src/drivers/SpiNorFlash.cpp - Device drivers
src/drivers
Other components
- Watch user
- Companion app
Connections 18
- Watch user → Display app: interacts with
- Display app → Apps and watch faces: dispatches views
- Apps and watch faces → Device controllers: uses services
- Display app → Device drivers: renders via
- System task → FreeRTOS: starts scheduler
- System task → BLE controller: initializes
- Alarm → Date and time: reads time
- Alarm → System task: posts alert
- Date and time → System task: posts time events
- Motion and steps → BLE services: updates step service
- Device controllers → Filesystem: persists settings
- Filesystem → Flash storage: reads and writes
- BLE controller → BLE services: advertises services
- BLE controller → Service discovery: starts discovery
- BLE controller → Filesystem: stores bonds
- Companion app → BLE controller: connects over BLE
- DFU client → DFU service: sends firmware data
- DFU service → Firmware validator: validates firmware