# lora-net/lorastudio architecture

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

- Interactive diagram: https://gitdiagram.com/lora-net/lorastudio
- Repository: https://github.com/lora-net/lorastudio

## Overview

This repository is a release archive for LoRa Studio, not an application source tree. The README describes a host-based Python GUI that connects through pyOCD to development-kit firmware and runs radio demonstrations. The graph preserves the documented demo types, supported kit platforms, firmware-update flow, and embedded documentation. No source excerpts are available, so relationships are limited to those stated in the README; component paths point to that documentation rather than unsampled implementation files.

Main entry points: [`README.md`](https://github.com/lora-net/lorastudio/blob/master/README.md) (Host GUI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_host["Host Application"]
  node_gui["Host GUI<br/>[README.md]"]
  node_connection["Device Connection<br/>[README.md]"]
  node_pyocd["pyOCD Control<br/>[README.md]"]
end

subgraph group_demos["Radio Demonstrations"]
  node_pingpong["Ping Pong<br/>[README.md]"]
  node_per["Packet Error Rate<br/>[README.md]"]
  node_cw["Continuous Wave<br/>[README.md]"]
  node_power["Power Measures<br/>[README.md]"]
end

subgraph group_device["Device Side"]
  node_firmware["Kit Firmware<br/>[README.md]"]
  node_radio["LR20xx Radio<br/>[README.md]"]
  node_platforms["Kit Platforms<br/>[README.md]"]
end

subgraph group_support["Setup and Help"]
  node_firmware_update["Firmware Update<br/>[README.md]"]
  node_firmware_bins["Firmware Binaries<br/>[README.md]"]
  node_in_app_docs["In-App Guide<br/>[README.md]"]
end

node_engineer(("Engineer"))

node_engineer -->|"uses"| node_gui
node_gui -->|"opens connection"| node_connection
node_connection -->|"controls with"| node_pyocd
node_pyocd -->|"communicates with"| node_firmware
node_firmware -->|"executes operations"| node_radio
node_gui -->|"runs demo"| node_pingpong
node_gui -->|"runs demo"| node_per
node_gui -->|"runs demo"| node_cw
node_gui -->|"runs demo"| node_power
node_firmware -->|"supports"| node_platforms
node_engineer -->|"initiates update"| node_firmware_update
node_firmware_update -->|"selects binary"| node_firmware_bins
node_firmware_update -->|"uses connected kit"| node_connection
node_engineer -->|"opens guide"| node_in_app_docs

click node_gui "https://github.com/lora-net/lorastudio/blob/master/README.md"
click node_connection "https://github.com/lora-net/lorastudio/blob/master/README.md"
click node_pyocd "https://github.com/lora-net/lorastudio/blob/master/README.md"
click node_pingpong "https://github.com/lora-net/lorastudio/blob/master/README.md"
click node_per "https://github.com/lora-net/lorastudio/blob/master/README.md"
click node_cw "https://github.com/lora-net/lorastudio/blob/master/README.md"
click node_power "https://github.com/lora-net/lorastudio/blob/master/README.md"
click node_firmware "https://github.com/lora-net/lorastudio/blob/master/README.md"
click node_radio "https://github.com/lora-net/lorastudio/blob/master/README.md"
click node_platforms "https://github.com/lora-net/lorastudio/blob/master/README.md"
click node_firmware_update "https://github.com/lora-net/lorastudio/blob/master/README.md"
click node_firmware_bins "https://github.com/lora-net/lorastudio/blob/master/README.md"
click node_in_app_docs "https://github.com/lora-net/lorastudio/blob/master/README.md"

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_gui,node_connection,node_pyocd toneBlue
class node_pingpong,node_per,node_cw,node_power toneAmber
class node_firmware,node_radio,node_platforms toneMint
class node_firmware_update,node_firmware_bins,node_in_app_docs toneRose
class node_engineer toneIndigo
```

## Components

### Host Application

- [Host GUI](https://github.com/lora-net/lorastudio/blob/master/README.md): `README.md`
- [Device Connection](https://github.com/lora-net/lorastudio/blob/master/README.md): `README.md`
- [pyOCD Control](https://github.com/lora-net/lorastudio/blob/master/README.md): `README.md`

### Radio Demonstrations

- [Ping Pong](https://github.com/lora-net/lorastudio/blob/master/README.md): `README.md`
- [Packet Error Rate](https://github.com/lora-net/lorastudio/blob/master/README.md): `README.md`
- [Continuous Wave](https://github.com/lora-net/lorastudio/blob/master/README.md): `README.md`
- [Power Measures](https://github.com/lora-net/lorastudio/blob/master/README.md): `README.md`

### Device Side

- [Kit Firmware](https://github.com/lora-net/lorastudio/blob/master/README.md): `README.md`
- [LR20xx Radio](https://github.com/lora-net/lorastudio/blob/master/README.md): `README.md`
- [Kit Platforms](https://github.com/lora-net/lorastudio/blob/master/README.md): `README.md`

### Setup and Help

- [Firmware Update](https://github.com/lora-net/lorastudio/blob/master/README.md): `README.md`
- [Firmware Binaries](https://github.com/lora-net/lorastudio/blob/master/README.md): `README.md`
- [In-App Guide](https://github.com/lora-net/lorastudio/blob/master/README.md): `README.md`

### Other components

- **Engineer**

## Connections

- Engineer → Host GUI: uses (evidence: `README.md`)
- Host GUI → Device Connection: opens connection (evidence: `README.md`)
- Device Connection → pyOCD Control: controls with (evidence: `README.md`)
- pyOCD Control → Kit Firmware: communicates with (evidence: `README.md`)
- Kit Firmware → LR20xx Radio: executes operations (evidence: `README.md`)
- Host GUI → Ping Pong: runs demo (evidence: `README.md`)
- Host GUI → Packet Error Rate: runs demo (evidence: `README.md`)
- Host GUI → Continuous Wave: runs demo (evidence: `README.md`)
- Host GUI → Power Measures: runs demo (evidence: `README.md`)
- Kit Firmware → Kit Platforms: supports (evidence: `README.md`)
- Engineer → Firmware Update: initiates update (evidence: `README.md`)
- Firmware Update → Firmware Binaries: selects binary (evidence: `README.md`)
- Firmware Update → Device Connection: uses connected kit (evidence: `README.md`)
- Engineer → In-App Guide: opens guide (evidence: `README.md`)
