# dustofstars/linuxmcuxpressoworkspace architecture

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

- Interactive diagram: https://gitdiagram.com/dustofstars/linuxmcuxpressoworkspace
- Repository: https://github.com/dustofstars/linuxmcuxpressoworkspace

## Overview

LinuxMCUXpressoWorkspace is a collection of independent NXP MCUXpresso embedded examples, not one application. Its projects cover microphone/GPIO, a hello-world console, audio recording and playback, LVGL widgets, and FlexSPI flash or PSRAM transfers. The principal user-to-result workflows therefore vary by example: run a board-specific firmware demo and observe its hardware or console output. The tree and limited excerpts establish the examples and some component relationships, but not most application-level call sequences; those links are omitted rather than inferred.

Main entry points: [`evkcmimxrt1060_sai_edma_record_playback/board/app.h`](https://github.com/dustofstars/linuxmcuxpressoworkspace/blob/master/evkcmimxrt1060_sai_edma_record_playback/board/app.h) (Record playback), [`evkmimxrt1060_lvgl_demo_widgets/lvgl/lvgl/src/extra/others/fragment/lv_fragment_manager.c`](https://github.com/dustofstars/linuxmcuxpressoworkspace/blob/master/evkmimxrt1060_lvgl_demo_widgets/lvgl/lvgl/src/extra/others/fragment/lv_fragment_manager.c) (Fragment manager), [`Project33_onboard_mic_gpio_RT1010/component/serial_manager/fsl_component_serial_manager.c`](https://github.com/dustofstars/linuxmcuxpressoworkspace/blob/master/Project33_onboard_mic_gpio_RT1010/component/serial_manager/fsl_component_serial_manager.c) (Serial manager), [`Project33_onboard_mic_gpio_RT1010/source/Project33_onboard_mic_gpio_RT1010.c`](https://github.com/dustofstars/linuxmcuxpressoworkspace/blob/master/Project33_onboard_mic_gpio_RT1010/source/Project33_onboard_mic_gpio_RT1010.c) (Mic GPIO demo)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_demos["Board demos"]
  node_mic_demo["Mic GPIO demo"]
  node_hello_demo["Hello world<br/>[hello_world.c]"]
end

subgraph group_audio["Audio"]
  node_audio_demo["Record playback<br/>[app.h]"]
  node_audio_codec["Audio codec config<br/>[app.h]"]
end

subgraph group_ui["UI runtime"]
  node_lvgl_demo["LVGL widgets<br/>[lv_conf.h]"]
  node_fragment_api["Fragment API<br/>[lv_fragment.h]"]
  node_fragment_manager["Fragment manager"]
end

subgraph group_platform["Platform components"]
  node_freertos_tasks["Task scheduler<br/>[tasks.c]"]
  node_serial_manager["Serial manager"]
  node_uart_port["UART port adapter"]
end

subgraph group_memory["Memory transfers"]
  node_flash_demo["Octal flash transfer"]
  node_psram_demo["PSRAM transfer<br/>[app.h]"]
end

node_engineer(("Firmware user"))

node_engineer -.->|"runs firmware"| node_mic_demo
node_engineer -.->|"runs firmware"| node_hello_demo
node_engineer -.->|"runs firmware"| node_audio_demo
node_engineer -.->|"runs firmware"| node_lvgl_demo
node_engineer -.->|"runs firmware"| node_flash_demo
node_engineer -.->|"runs firmware"| node_psram_demo
node_fragment_manager -->|"uses callbacks"| node_fragment_api
node_serial_manager -->|"dispatches UART"| node_uart_port
node_audio_demo -.->|"configures audio"| node_audio_codec

click node_mic_demo "https://github.com/dustofstars/linuxmcuxpressoworkspace/blob/master/Project33_onboard_mic_gpio_RT1010/source/Project33_onboard_mic_gpio_RT1010.c"
click node_hello_demo "https://github.com/dustofstars/linuxmcuxpressoworkspace/blob/master/evkbmimxrt1170_hello_world_cm7/source/hello_world.c"
click node_audio_demo "https://github.com/dustofstars/linuxmcuxpressoworkspace/blob/master/evkcmimxrt1060_sai_edma_record_playback/board/app.h"
click node_audio_codec "https://github.com/dustofstars/linuxmcuxpressoworkspace/blob/master/evkcmimxrt1060_sai_edma_record_playback/board/app.h"
click node_lvgl_demo "https://github.com/dustofstars/linuxmcuxpressoworkspace/blob/master/evkmimxrt1060_lvgl_demo_widgets/source/lv_conf.h"
click node_fragment_api "https://github.com/dustofstars/linuxmcuxpressoworkspace/blob/master/evkmimxrt1060_lvgl_demo_widgets/lvgl/lvgl/src/extra/others/fragment/lv_fragment.h"
click node_fragment_manager "https://github.com/dustofstars/linuxmcuxpressoworkspace/blob/master/evkmimxrt1060_lvgl_demo_widgets/lvgl/lvgl/src/extra/others/fragment/lv_fragment_manager.c"
click node_freertos_tasks "https://github.com/dustofstars/linuxmcuxpressoworkspace/blob/master/evkmimxrt1060_lvgl_demo_widgets/freertos/freertos-kernel/tasks.c"
click node_serial_manager "https://github.com/dustofstars/linuxmcuxpressoworkspace/blob/master/Project33_onboard_mic_gpio_RT1010/component/serial_manager/fsl_component_serial_manager.c"
click node_uart_port "https://github.com/dustofstars/linuxmcuxpressoworkspace/blob/master/Project33_onboard_mic_gpio_RT1010/component/serial_manager/fsl_component_serial_port_uart.h"
click node_flash_demo "https://github.com/dustofstars/linuxmcuxpressoworkspace/blob/master/evkmimxrt685_flexspi_octal_polling_transfer_cm33/source/flexspi_octal_flash_ops.c"
click node_psram_demo "https://github.com/dustofstars/linuxmcuxpressoworkspace/blob/master/evkmimxrt685_flexspi_psram_polling_transfer_cm33/board/app.h"

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_mic_demo,node_hello_demo,node_engineer toneBlue
class node_audio_demo,node_audio_codec toneAmber
class node_lvgl_demo,node_fragment_api,node_fragment_manager toneMint
class node_freertos_tasks,node_serial_manager,node_uart_port toneRose
class node_flash_demo,node_psram_demo toneIndigo
```

## Components

### Board demos

- [Mic GPIO demo](https://github.com/dustofstars/linuxmcuxpressoworkspace/blob/master/Project33_onboard_mic_gpio_RT1010/source/Project33_onboard_mic_gpio_RT1010.c): `Project33_onboard_mic_gpio_RT1010/source/Project33_onboard_mic_gpio_RT1010.c`
- [Hello world](https://github.com/dustofstars/linuxmcuxpressoworkspace/blob/master/evkbmimxrt1170_hello_world_cm7/source/hello_world.c): `evkbmimxrt1170_hello_world_cm7/source/hello_world.c`

### Audio

- [Record playback](https://github.com/dustofstars/linuxmcuxpressoworkspace/blob/master/evkcmimxrt1060_sai_edma_record_playback/board/app.h): `evkcmimxrt1060_sai_edma_record_playback/board/app.h`
- [Audio codec config](https://github.com/dustofstars/linuxmcuxpressoworkspace/blob/master/evkcmimxrt1060_sai_edma_record_playback/board/app.h): `evkcmimxrt1060_sai_edma_record_playback/board/app.h`

### UI runtime

- [LVGL widgets](https://github.com/dustofstars/linuxmcuxpressoworkspace/blob/master/evkmimxrt1060_lvgl_demo_widgets/source/lv_conf.h): `evkmimxrt1060_lvgl_demo_widgets/source/lv_conf.h`
- [Fragment API](https://github.com/dustofstars/linuxmcuxpressoworkspace/blob/master/evkmimxrt1060_lvgl_demo_widgets/lvgl/lvgl/src/extra/others/fragment/lv_fragment.h): `evkmimxrt1060_lvgl_demo_widgets/lvgl/lvgl/src/extra/others/fragment/lv_fragment.h`
- [Fragment manager](https://github.com/dustofstars/linuxmcuxpressoworkspace/blob/master/evkmimxrt1060_lvgl_demo_widgets/lvgl/lvgl/src/extra/others/fragment/lv_fragment_manager.c): `evkmimxrt1060_lvgl_demo_widgets/lvgl/lvgl/src/extra/others/fragment/lv_fragment_manager.c`

### Platform components

- [Task scheduler](https://github.com/dustofstars/linuxmcuxpressoworkspace/blob/master/evkmimxrt1060_lvgl_demo_widgets/freertos/freertos-kernel/tasks.c): `evkmimxrt1060_lvgl_demo_widgets/freertos/freertos-kernel/tasks.c`
- [Serial manager](https://github.com/dustofstars/linuxmcuxpressoworkspace/blob/master/Project33_onboard_mic_gpio_RT1010/component/serial_manager/fsl_component_serial_manager.c): `Project33_onboard_mic_gpio_RT1010/component/serial_manager/fsl_component_serial_manager.c`
- [UART port adapter](https://github.com/dustofstars/linuxmcuxpressoworkspace/blob/master/Project33_onboard_mic_gpio_RT1010/component/serial_manager/fsl_component_serial_port_uart.h): `Project33_onboard_mic_gpio_RT1010/component/serial_manager/fsl_component_serial_port_uart.h`

### Memory transfers

- [Octal flash transfer](https://github.com/dustofstars/linuxmcuxpressoworkspace/blob/master/evkmimxrt685_flexspi_octal_polling_transfer_cm33/source/flexspi_octal_flash_ops.c): `evkmimxrt685_flexspi_octal_polling_transfer_cm33/source/flexspi_octal_flash_ops.c`
- [PSRAM transfer](https://github.com/dustofstars/linuxmcuxpressoworkspace/blob/master/evkmimxrt685_flexspi_psram_polling_transfer_cm33/board/app.h): `evkmimxrt685_flexspi_psram_polling_transfer_cm33/board/app.h`

### Other components

- **Firmware user**

## Connections

- Firmware user → Mic GPIO demo: runs firmware
- Firmware user → Hello world: runs firmware
- Firmware user → Record playback: runs firmware
- Firmware user → LVGL widgets: runs firmware
- Firmware user → Octal flash transfer: runs firmware
- Firmware user → PSRAM transfer: runs firmware
- Fragment manager → Fragment API: uses callbacks (evidence: `evkmimxrt1060_lvgl_demo_widgets/lvgl/lvgl/src/extra/others/fragment/lv_fragment_manager.c`)
- Serial manager → UART port adapter: dispatches UART (evidence: `Project33_onboard_mic_gpio_RT1010/component/serial_manager/fsl_component_serial_manager.c`)
- Record playback → Audio codec config: configures audio (evidence: `evkcmimxrt1060_sai_edma_record_playback/board/app.h`)
