# chinmay-5/isaac-teleop architecture

> Architecture diagram of the GitHub repository chinmay-5/isaac-teleop, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/chinmay-5/isaac-teleop
- Repository: https://github.com/chinmay-5/isaac-teleop

## Overview

Isaac Teleop is currently a small Zephyr firmware application for the MXChip AZ3166. Its runtime configures the onboard LSM6DSL for 104 Hz sampling, fetches acceleration and gyroscope readings, then sends them to the serial console and formats them for the SSD1306 OLED through Zephyr’s Character Framebuffer API. ROS 2 and Isaac Sim are future milestones, not current runtime components. The graph reflects the README and the sampled main.c; hardware-driver internals were not inspected.

Main entry points: [`firmware/app/src/main.c`](https://github.com/chinmay-5/isaac-teleop/blob/main/firmware/app/src/main.c) (Sampling Loop)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Firmware Application"]
  node_main["Sampling Loop<br/>[main.c]"]
end

subgraph group_sensor["IMU Input"]
  node_sensor_api["Zephyr Sensor API"]
  node_lsm6dsl["LSM6DSL IMU"]
end

subgraph group_outputs["Telemetry Output"]
  node_cfb["Character Framebuffer"]
  node_oled["SSD1306 OLED"]
  node_console["Serial Console"]
end

node_main -->|"configures and fetches"| node_sensor_api
node_sensor_api -->|"reads measurements"| node_lsm6dsl
node_main -->|"prints readings"| node_console
node_main -->|"renders readings"| node_cfb
node_cfb -->|"updates display"| node_oled

click node_main "https://github.com/chinmay-5/isaac-teleop/blob/main/firmware/app/src/main.c"

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_main toneBlue
class node_sensor_api,node_lsm6dsl toneAmber
class node_cfb,node_oled,node_console toneMint
```

## Components

### Firmware Application

- [Sampling Loop](https://github.com/chinmay-5/isaac-teleop/blob/main/firmware/app/src/main.c): `firmware/app/src/main.c`

### IMU Input

- **Zephyr Sensor API**
- **LSM6DSL IMU**

### Telemetry Output

- **Character Framebuffer**
- **SSD1306 OLED**
- **Serial Console**

## Connections

- Sampling Loop → Zephyr Sensor API: configures and fetches (evidence: `firmware/app/src/main.c`)
- Zephyr Sensor API → LSM6DSL IMU: reads measurements (evidence: `README.md`)
- Sampling Loop → Serial Console: prints readings (evidence: `firmware/app/src/main.c`)
- Sampling Loop → Character Framebuffer: renders readings (evidence: `firmware/app/src/main.c`)
- Character Framebuffer → SSD1306 OLED: updates display (evidence: `README.md`)
