# infinitimeorg/infinitime architecture

> Architecture diagram of the GitHub repository infinitimeorg/infinitime, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-23). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/infinitimeorg/infinitime
- Repository: https://github.com/infinitimeorg/infinitime

## Overview

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: [`src/components/ble/NimbleController.cpp`](https://github.com/infinitimeorg/infinitime/blob/main/src/components/ble/NimbleController.cpp) (BLE controller), [`src/main.cpp`](https://github.com/infinitimeorg/infinitime/blob/main/src/main.cpp) (System task), [`src/displayapp/DisplayApp.cpp`](https://github.com/infinitimeorg/infinitime/blob/main/src/displayapp/DisplayApp.cpp) (Display app), [`src/components/fs/FS.cpp`](https://github.com/infinitimeorg/infinitime/blob/main/src/components/fs/FS.cpp) (Filesystem)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Watch interface"]
  node_display["Display app<br/>[DisplayApp.cpp]"]
  node_screens["Apps and watch faces"]
end

subgraph group_services["Device services"]
  node_controllers["Device controllers"]
  node_datetime["Date and time"]
  node_motion["Motion and steps"]
  node_alarm["Alarm"]
  node_fs["Filesystem<br/>[FS.cpp]"]
end

subgraph group_connectivity["Connectivity and updates"]
  node_ble["BLE controller"]
  node_ble_services["BLE services"]
  node_discovery["Service discovery"]
  node_dfu_client["DFU client<br/>[dfu.py]"]
  node_dfu_service["DFU service<br/>[DfuService.cpp]"]
  node_validator["Firmware validator"]
end

subgraph group_platform["Runtime and hardware"]
  node_system["System task<br/>[main.cpp]"]
  node_rtos["FreeRTOS"]
  node_flash[("Flash storage<br/>[SpiNorFlash.cpp]")]
  node_drivers["Device drivers"]
end

node_user(("Watch user"))
node_companion(("Companion app"))

node_user -->|"interacts with"| node_display
node_display -->|"dispatches views"| node_screens
node_screens -->|"uses services"| node_controllers
node_display -->|"renders via"| node_drivers
node_system -->|"starts scheduler"| node_rtos
node_system -->|"initializes"| node_ble
node_alarm -->|"reads time"| node_datetime
node_alarm -->|"posts alert"| node_system
node_datetime -->|"posts time events"| node_system
node_motion -->|"updates step service"| node_ble_services
node_controllers -->|"persists settings"| node_fs
node_fs -->|"reads and writes"| node_flash
node_ble -->|"advertises services"| node_ble_services
node_ble -->|"starts discovery"| node_discovery
node_ble -->|"stores bonds"| node_fs
node_companion -->|"connects over BLE"| node_ble
node_dfu_client -->|"sends firmware data"| node_dfu_service
node_dfu_service -.->|"validates firmware"| node_validator

click node_display "https://github.com/infinitimeorg/infinitime/blob/main/src/displayapp/DisplayApp.cpp"
click node_screens "https://github.com/infinitimeorg/infinitime/tree/main/src/displayapp/screens"
click node_system "https://github.com/infinitimeorg/infinitime/blob/main/src/main.cpp"
click node_rtos "https://github.com/infinitimeorg/infinitime/tree/main/src/FreeRTOS"
click node_controllers "https://github.com/infinitimeorg/infinitime/tree/main/src/components"
click node_datetime "https://github.com/infinitimeorg/infinitime/blob/main/src/components/datetime/DateTimeController.cpp"
click node_motion "https://github.com/infinitimeorg/infinitime/blob/main/src/components/motion/MotionController.cpp"
click node_alarm "https://github.com/infinitimeorg/infinitime/blob/main/src/components/alarm/AlarmController.cpp"
click node_fs "https://github.com/infinitimeorg/infinitime/blob/main/src/components/fs/FS.cpp"
click node_flash "https://github.com/infinitimeorg/infinitime/blob/main/src/drivers/SpiNorFlash.cpp"
click node_drivers "https://github.com/infinitimeorg/infinitime/tree/main/src/drivers"
click node_ble "https://github.com/infinitimeorg/infinitime/blob/main/src/components/ble/NimbleController.cpp"
click node_ble_services "https://github.com/infinitimeorg/infinitime/tree/main/src/components/ble"
click node_discovery "https://github.com/infinitimeorg/infinitime/blob/main/src/components/ble/ServiceDiscovery.cpp"
click node_dfu_client "https://github.com/infinitimeorg/infinitime/blob/main/bootloader/ota-dfu-python/dfu.py"
click node_dfu_service "https://github.com/infinitimeorg/infinitime/blob/main/src/components/ble/DfuService.cpp"
click node_validator "https://github.com/infinitimeorg/infinitime/blob/main/src/components/firmwarevalidator/FirmwareValidator.cpp"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_display,node_screens,node_user toneBlue
class node_controllers,node_datetime,node_motion,node_alarm,node_fs toneAmber
class node_ble,node_ble_services,node_discovery,node_dfu_client,node_dfu_service,node_validator toneMint
class node_system,node_rtos,node_flash,node_drivers toneRose
class node_companion toneIndigo
```

## Components

### Watch interface

- [Display app](https://github.com/infinitimeorg/infinitime/blob/main/src/displayapp/DisplayApp.cpp): `src/displayapp/DisplayApp.cpp`
- [Apps and watch faces](https://github.com/infinitimeorg/infinitime/tree/main/src/displayapp/screens): `src/displayapp/screens`

### Device services

- [Device controllers](https://github.com/infinitimeorg/infinitime/tree/main/src/components): `src/components`
- [Date and time](https://github.com/infinitimeorg/infinitime/blob/main/src/components/datetime/DateTimeController.cpp): `src/components/datetime/DateTimeController.cpp`
- [Motion and steps](https://github.com/infinitimeorg/infinitime/blob/main/src/components/motion/MotionController.cpp): `src/components/motion/MotionController.cpp`
- [Alarm](https://github.com/infinitimeorg/infinitime/blob/main/src/components/alarm/AlarmController.cpp): `src/components/alarm/AlarmController.cpp`
- [Filesystem](https://github.com/infinitimeorg/infinitime/blob/main/src/components/fs/FS.cpp): `src/components/fs/FS.cpp`

### Connectivity and updates

- [BLE controller](https://github.com/infinitimeorg/infinitime/blob/main/src/components/ble/NimbleController.cpp): `src/components/ble/NimbleController.cpp`
- [BLE services](https://github.com/infinitimeorg/infinitime/tree/main/src/components/ble): `src/components/ble`
- [Service discovery](https://github.com/infinitimeorg/infinitime/blob/main/src/components/ble/ServiceDiscovery.cpp): `src/components/ble/ServiceDiscovery.cpp`
- [DFU client](https://github.com/infinitimeorg/infinitime/blob/main/bootloader/ota-dfu-python/dfu.py): `bootloader/ota-dfu-python/dfu.py`
- [DFU service](https://github.com/infinitimeorg/infinitime/blob/main/src/components/ble/DfuService.cpp): `src/components/ble/DfuService.cpp`
- [Firmware validator](https://github.com/infinitimeorg/infinitime/blob/main/src/components/firmwarevalidator/FirmwareValidator.cpp): `src/components/firmwarevalidator/FirmwareValidator.cpp`

### Runtime and hardware

- [System task](https://github.com/infinitimeorg/infinitime/blob/main/src/main.cpp): `src/main.cpp`
- [FreeRTOS](https://github.com/infinitimeorg/infinitime/tree/main/src/FreeRTOS): `src/FreeRTOS`
- [Flash storage](https://github.com/infinitimeorg/infinitime/blob/main/src/drivers/SpiNorFlash.cpp): `src/drivers/SpiNorFlash.cpp`
- [Device drivers](https://github.com/infinitimeorg/infinitime/tree/main/src/drivers): `src/drivers`

### Other components

- **Watch user**
- **Companion app**

## Connections

- 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
