# lora-net/swdm031_img_xfer architecture

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

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

## Overview

This Zephyr demo runs in two compile-time roles: an initiator sends a 42-frame monochrome image over FLRP-BURST, while a slave listens, receives it, and renders it on the OLED. The main loop handles startup, button-driven and periodic transfer control; the transfer module owns FLRP operations and receive-side reporting, and the display module provides queued text and image output. Relationships for role behavior and image rendering are documented in the README; source excerpts show main-loop calls and display behavior, but not all FLRP callback wiring.

Main entry points: [`src/main.c`](https://github.com/lora-net/swdm031_img_xfer/blob/main/src/main.c) (Role main loop), [`src/common/app_flrp_img_xfer.c`](https://github.com/lora-net/swdm031_img_xfer/blob/main/src/common/app_flrp_img_xfer.c) (FLRP transfer), [`src/oled_display/oled_display.c`](https://github.com/lora-net/swdm031_img_xfer/blob/main/src/oled_display/oled_display.c) (Display service), [`src/image_data/image_chick_looking.c`](https://github.com/lora-net/swdm031_img_xfer/blob/main/src/image_data/image_chick_looking.c) (Image frames)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_control["Application control"]
  node_main["Role main loop<br/>[main.c]"]
end

subgraph group_transfer["Image transfer"]
  node_xfer["FLRP transfer"]
  node_image["Image frames"]
end

subgraph group_display["OLED presentation"]
  node_display["Display service<br/>[oled_display.c]"]
  node_logo["Startup logo<br/>[lora_logo.c]"]
end

node_user(("User"))
node_peer(("Peer device"))
node_oled["OLED hardware"]

node_user -->|"presses button"| node_main
node_main -->|"starts transfer"| node_xfer
node_main -->|"updates display"| node_display
node_main -->|"animates logo"| node_logo
node_image -->|"provides payload"| node_xfer
node_xfer -->|"transfers image"| node_peer
node_xfer -->|"delivers received image"| node_display
node_display -->|"renders frames"| node_oled

click node_main "https://github.com/lora-net/swdm031_img_xfer/blob/main/src/main.c"
click node_xfer "https://github.com/lora-net/swdm031_img_xfer/blob/main/src/common/app_flrp_img_xfer.c"
click node_image "https://github.com/lora-net/swdm031_img_xfer/blob/main/src/image_data/image_chick_looking.c"
click node_display "https://github.com/lora-net/swdm031_img_xfer/blob/main/src/oled_display/oled_display.c"
click node_logo "https://github.com/lora-net/swdm031_img_xfer/blob/main/src/oled_display/lora_logo.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,node_user toneBlue
class node_xfer,node_image toneAmber
class node_display,node_logo toneMint
class node_peer,node_oled toneIndigo
```

## Components

### Application control

- [Role main loop](https://github.com/lora-net/swdm031_img_xfer/blob/main/src/main.c): `src/main.c`

### Image transfer

- [FLRP transfer](https://github.com/lora-net/swdm031_img_xfer/blob/main/src/common/app_flrp_img_xfer.c): `src/common/app_flrp_img_xfer.c`
- [Image frames](https://github.com/lora-net/swdm031_img_xfer/blob/main/src/image_data/image_chick_looking.c): `src/image_data/image_chick_looking.c`

### OLED presentation

- [Display service](https://github.com/lora-net/swdm031_img_xfer/blob/main/src/oled_display/oled_display.c): `src/oled_display/oled_display.c`
- [Startup logo](https://github.com/lora-net/swdm031_img_xfer/blob/main/src/oled_display/lora_logo.c): `src/oled_display/lora_logo.c`

### Other components

- **User**
- **Peer device**
- **OLED hardware**

## Connections

- User → Role main loop: presses button (evidence: `src/main.c`)
- Role main loop → FLRP transfer: starts transfer (evidence: `src/main.c`)
- Role main loop → Display service: updates display (evidence: `src/main.c`)
- Role main loop → Startup logo: animates logo (evidence: `src/main.c`)
- Image frames → FLRP transfer: provides payload (evidence: `README.md`)
- FLRP transfer → Peer device: transfers image (evidence: `README.md`)
- FLRP transfer → Display service: delivers received image (evidence: `README.md`)
- Display service → OLED hardware: renders frames (evidence: `src/oled_display/oled_display.c`)
