# mspiceland/usdx-pebblehf architecture

> Architecture diagram of the GitHub repository mspiceland/usdx-pebblehf, 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/mspiceland/usdx-pebblehf
- Repository: https://github.com/mspiceland/usdx-pebblehf

## Overview

Pebble HF is an experimental, single-band 20-meter QRP transceiver. Its principal workflow is operator input and audio/key signals processed by firmware into radio transmission, with received signals filtered and presented as audio. The README describes the firmware’s DSP, operating controls, and radio capabilities; the sampled flashing utility separately programs boards through avrdude. The firmware source is listed in the tree but was not excerpted, so internal firmware relationships are shown only where the README documents them.

Main entry points: [`usdx.ino`](https://github.com/mspiceland/usdx-pebblehf/blob/main/usdx.ino) (Radio firmware), [`utils/flash_pebble.py`](https://github.com/mspiceland/usdx-pebblehf/blob/main/utils/flash_pebble.py) (Flash utility)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_operation["Radio operation"]
  node_controls["Radio controls<br/>[usdx.ino]"]
  node_firmware["Radio firmware<br/>[usdx.ino]"]
  node_vfo["VFO and RIT<br/>[usdx.ino]"]
  node_keyer["CW keyer<br/>[usdx.ino]"]
end

subgraph group_signal["Signal processing"]
  node_transmit["DSP transmitter<br/>[usdx.ino]"]
  node_receive["DSP receiver<br/>[usdx.ino]"]
  node_radio["RF transceiver"]
end

subgraph group_programming["Board programming"]
  node_programmer["Board programmer"]
  node_flash["Flash utility<br/>[flash_pebble.py]"]
  node_avrdude["avrdude"]
end

node_operator(("Radio operator"))

node_operator -->|"operates"| node_controls
node_controls -->|"sets operation"| node_firmware
node_firmware -->|"supports tuning"| node_vfo
node_firmware -->|"supports keying"| node_keyer
node_firmware -->|"runs transmit DSP"| node_transmit
node_firmware -->|"runs receive DSP"| node_receive
node_transmit -->|"drives transmission"| node_radio
node_radio -->|"provides signals"| node_receive
node_programmer -->|"runs utility"| node_flash
node_flash -->|"invokes"| node_avrdude
node_flash -.->|"programs firmware"| node_radio

click node_controls "https://github.com/mspiceland/usdx-pebblehf/blob/main/usdx.ino"
click node_firmware "https://github.com/mspiceland/usdx-pebblehf/blob/main/usdx.ino"
click node_vfo "https://github.com/mspiceland/usdx-pebblehf/blob/main/usdx.ino"
click node_keyer "https://github.com/mspiceland/usdx-pebblehf/blob/main/usdx.ino"
click node_transmit "https://github.com/mspiceland/usdx-pebblehf/blob/main/usdx.ino"
click node_receive "https://github.com/mspiceland/usdx-pebblehf/blob/main/usdx.ino"
click node_flash "https://github.com/mspiceland/usdx-pebblehf/blob/main/utils/flash_pebble.py"

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_controls,node_firmware,node_vfo,node_keyer toneBlue
class node_transmit,node_receive,node_radio toneAmber
class node_programmer,node_flash,node_avrdude toneMint
class node_operator toneIndigo
```

## Components

### Radio operation

- [Radio controls](https://github.com/mspiceland/usdx-pebblehf/blob/main/usdx.ino): `usdx.ino`
- [Radio firmware](https://github.com/mspiceland/usdx-pebblehf/blob/main/usdx.ino): `usdx.ino`
- [VFO and RIT](https://github.com/mspiceland/usdx-pebblehf/blob/main/usdx.ino): `usdx.ino`
- [CW keyer](https://github.com/mspiceland/usdx-pebblehf/blob/main/usdx.ino): `usdx.ino`

### Signal processing

- [DSP transmitter](https://github.com/mspiceland/usdx-pebblehf/blob/main/usdx.ino): `usdx.ino`
- [DSP receiver](https://github.com/mspiceland/usdx-pebblehf/blob/main/usdx.ino): `usdx.ino`
- **RF transceiver**

### Board programming

- **Board programmer**
- [Flash utility](https://github.com/mspiceland/usdx-pebblehf/blob/main/utils/flash_pebble.py): `utils/flash_pebble.py`
- **avrdude**

### Other components

- **Radio operator**

## Connections

- Radio operator → Radio controls: operates (evidence: `README.md`)
- Radio controls → Radio firmware: sets operation (evidence: `README.md`)
- Radio firmware → VFO and RIT: supports tuning (evidence: `README.md`)
- Radio firmware → CW keyer: supports keying (evidence: `README.md`)
- Radio firmware → DSP transmitter: runs transmit DSP (evidence: `README.md`)
- Radio firmware → DSP receiver: runs receive DSP (evidence: `README.md`)
- DSP transmitter → RF transceiver: drives transmission (evidence: `README.md`)
- RF transceiver → DSP receiver: provides signals (evidence: `README.md`)
- Board programmer → Flash utility: runs utility (evidence: `utils/flash_pebble.py`)
- Flash utility → avrdude: invokes (evidence: `utils/flash_pebble.py`)
- Flash utility → RF transceiver: programs firmware
