# jokimbe/kobra-updated architecture

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

- Interactive diagram: https://gitdiagram.com/jokimbe/kobra-updated
- Repository: https://github.com/jokimbe/kobra-updated

## Overview

This repository is an archived Marlin-based firmware adaptation for the Anycubic Kobra. Its runtime spans printer configuration, embedded startup, G-code and motion/thermal control, storage, and LCD interaction. The README documents DGUS Reloaded and Vyper UI options; sampled DGUS handlers show UI actions using ExtUI and the G-code queue. Several major Marlin subsystems are present in the tree and source index but were not sampled, so their connections are shown only when documented or clearly marked unverified.

Main entry points: [`Marlin/src/MarlinCore.cpp`](https://github.com/jokimbe/kobra-updated/blob/master/Marlin/src/MarlinCore.cpp) (Firmware core), [`Marlin/src/lcd/extui/dgus_reloaded/DGUSTxHandler.cpp`](https://github.com/jokimbe/kobra-updated/blob/master/Marlin/src/lcd/extui/dgus_reloaded/DGUSTxHandler.cpp) (DGUS output), [`Marlin/lib/cores/arduino/main/main.cpp`](https://github.com/jokimbe/kobra-updated/blob/master/Marlin/lib/cores/arduino/main/main.cpp) (Board startup), [`Marlin/src/lcd/extui/dgus_reloaded/DGUSRxHandler.cpp`](https://github.com/jokimbe/kobra-updated/blob/master/Marlin/src/lcd/extui/dgus_reloaded/DGUSRxHandler.cpp) (DGUS input)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_config["Printer configuration"]
  node_settings["Printer settings<br/>[Configuration.h]"]
  node_advanced_settings["Advanced settings"]
  node_config_pre["Configuration setup<br/>[MarlinConfigPre.h]"]
  node_config_core["Configuration assembly<br/>[MarlinConfig.h]"]
end

subgraph group_platform["Embedded platform"]
  node_startup["Board startup<br/>[main.cpp]"]
  node_hal["HC32 HAL"]
  node_hc32_ddl["HC32 drivers"]
end

subgraph group_runtime["Printer runtime"]
  node_marlin_core["Firmware core<br/>[MarlinCore.cpp]"]
  node_gcode["G-code parsing<br/>[parser.cpp]"]
  node_gcode_queue["Command queue<br/>[queue.h]"]
  node_motion["Motion planning<br/>[planner.h]"]
  node_steppers["Stepper control<br/>[stepper.h]"]
  node_thermal["Thermal control<br/>[temperature.cpp]"]
  node_pause["Pause and resume<br/>[pause.h]"]
  node_print_counter["Print tracking<br/>[printcounter.h]"]
  node_controller_fan["Controller cooling<br/>[controllerfan.cpp]"]
  node_fatfs[("SD filesystem<br/>[ff.c]")]
end

subgraph group_ui["Display interfaces"]
  node_dgus_rx["DGUS input<br/>[DGUSRxHandler.cpp]"]
  node_dgus_screen["DGUS screens"]
  node_dgus_tx["DGUS output<br/>[DGUSTxHandler.cpp]"]
  node_extui["External UI API<br/>[ui_api.h]"]
  node_vyper_ui["Vyper display UI<br/>[dgus_tft.cpp]"]
end

node_operator(("Printer operator"))
node_printer(("Kobra printer"))
node_display(("Touch display"))

node_operator -->|"operates"| node_printer
node_printer -.->|"boots firmware"| node_startup
node_settings -->|"configures"| node_config_pre
node_advanced_settings -->|"configures"| node_config_pre
node_config_pre -->|"precedes"| node_config_core
node_startup -->|"initializes hardware"| node_hc32_ddl
node_startup -.->|"starts runtime"| node_marlin_core
node_hal -.->|"uses drivers"| node_hc32_ddl
node_marlin_core -.->|"dispatches commands"| node_gcode
node_gcode -.->|"queues commands"| node_gcode_queue
node_gcode_queue -.->|"dispatches motion"| node_motion
node_motion -.->|"provides moves"| node_steppers
node_marlin_core -.->|"updates temperatures"| node_thermal
node_marlin_core -.->|"updates cooling"| node_controller_fan
node_marlin_core -.->|"accesses media"| node_fatfs
node_dgus_rx -->|"controls printer"| node_extui
node_dgus_rx -->|"queues commands"| node_gcode_queue
node_dgus_tx -->|"reads printer state"| node_extui
node_dgus_tx -->|"reads print time"| node_print_counter
node_dgus_tx -.->|"sends display data"| node_display
node_display -.->|"sends input"| node_dgus_rx
node_dgus_screen -.->|"manages screens"| node_display
node_vyper_ui -.->|"supports display"| node_display
node_operator -.->|"uses interface"| node_display

click node_settings "https://github.com/jokimbe/kobra-updated/blob/master/Marlin/Configuration.h"
click node_advanced_settings "https://github.com/jokimbe/kobra-updated/blob/master/Marlin/Configuration_adv.h"
click node_config_pre "https://github.com/jokimbe/kobra-updated/blob/master/Marlin/src/inc/MarlinConfigPre.h"
click node_config_core "https://github.com/jokimbe/kobra-updated/blob/master/Marlin/src/inc/MarlinConfig.h"
click node_startup "https://github.com/jokimbe/kobra-updated/blob/master/Marlin/lib/cores/arduino/main/main.cpp"
click node_hal "https://github.com/jokimbe/kobra-updated/tree/master/Marlin/src/HAL/HC32F46x"
click node_hc32_ddl "https://github.com/jokimbe/kobra-updated/tree/master/Marlin/lib/cores/ddl"
click node_marlin_core "https://github.com/jokimbe/kobra-updated/blob/master/Marlin/src/MarlinCore.cpp"
click node_gcode "https://github.com/jokimbe/kobra-updated/blob/master/Marlin/src/gcode/parser.cpp"
click node_gcode_queue "https://github.com/jokimbe/kobra-updated/blob/master/Marlin/src/gcode/queue.h"
click node_motion "https://github.com/jokimbe/kobra-updated/blob/master/Marlin/src/module/planner.h"
click node_steppers "https://github.com/jokimbe/kobra-updated/blob/master/Marlin/src/module/stepper.h"
click node_thermal "https://github.com/jokimbe/kobra-updated/blob/master/Marlin/src/module/temperature.cpp"
click node_pause "https://github.com/jokimbe/kobra-updated/blob/master/Marlin/src/feature/pause.h"
click node_print_counter "https://github.com/jokimbe/kobra-updated/blob/master/Marlin/src/module/printcounter.h"
click node_controller_fan "https://github.com/jokimbe/kobra-updated/blob/master/Marlin/src/feature/controllerfan.cpp"
click node_fatfs "https://github.com/jokimbe/kobra-updated/blob/master/Marlin/lib/libraries/FatFs/ff.c"
click node_dgus_rx "https://github.com/jokimbe/kobra-updated/blob/master/Marlin/src/lcd/extui/dgus_reloaded/DGUSRxHandler.cpp"
click node_dgus_screen "https://github.com/jokimbe/kobra-updated/blob/master/Marlin/src/lcd/extui/dgus_reloaded/DGUSScreenHandler.cpp"
click node_dgus_tx "https://github.com/jokimbe/kobra-updated/blob/master/Marlin/src/lcd/extui/dgus_reloaded/DGUSTxHandler.cpp"
click node_extui "https://github.com/jokimbe/kobra-updated/blob/master/Marlin/src/lcd/extui/ui_api.h"
click node_vyper_ui "https://github.com/jokimbe/kobra-updated/blob/master/Marlin/src/lcd/extui/anycubic_vyper/dgus_tft.cpp"

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_settings,node_advanced_settings,node_config_pre,node_config_core toneBlue
class node_startup,node_hal,node_hc32_ddl toneAmber
class node_marlin_core,node_gcode,node_gcode_queue,node_motion,node_steppers,node_thermal,node_pause,node_print_counter,node_controller_fan,node_fatfs toneMint
class node_dgus_rx,node_dgus_screen,node_dgus_tx,node_extui,node_vyper_ui toneRose
class node_operator,node_printer,node_display toneIndigo
```

## Components

### Printer configuration

- [Printer settings](https://github.com/jokimbe/kobra-updated/blob/master/Marlin/Configuration.h): `Marlin/Configuration.h`
- [Advanced settings](https://github.com/jokimbe/kobra-updated/blob/master/Marlin/Configuration_adv.h): `Marlin/Configuration_adv.h`
- [Configuration setup](https://github.com/jokimbe/kobra-updated/blob/master/Marlin/src/inc/MarlinConfigPre.h): `Marlin/src/inc/MarlinConfigPre.h`
- [Configuration assembly](https://github.com/jokimbe/kobra-updated/blob/master/Marlin/src/inc/MarlinConfig.h): `Marlin/src/inc/MarlinConfig.h`

### Embedded platform

- [Board startup](https://github.com/jokimbe/kobra-updated/blob/master/Marlin/lib/cores/arduino/main/main.cpp): `Marlin/lib/cores/arduino/main/main.cpp`
- [HC32 HAL](https://github.com/jokimbe/kobra-updated/tree/master/Marlin/src/HAL/HC32F46x): `Marlin/src/HAL/HC32F46x`
- [HC32 drivers](https://github.com/jokimbe/kobra-updated/tree/master/Marlin/lib/cores/ddl): `Marlin/lib/cores/ddl`

### Printer runtime

- [Firmware core](https://github.com/jokimbe/kobra-updated/blob/master/Marlin/src/MarlinCore.cpp): `Marlin/src/MarlinCore.cpp`
- [G-code parsing](https://github.com/jokimbe/kobra-updated/blob/master/Marlin/src/gcode/parser.cpp): `Marlin/src/gcode/parser.cpp`
- [Command queue](https://github.com/jokimbe/kobra-updated/blob/master/Marlin/src/gcode/queue.h): `Marlin/src/gcode/queue.h`
- [Motion planning](https://github.com/jokimbe/kobra-updated/blob/master/Marlin/src/module/planner.h): `Marlin/src/module/planner.h`
- [Stepper control](https://github.com/jokimbe/kobra-updated/blob/master/Marlin/src/module/stepper.h): `Marlin/src/module/stepper.h`
- [Thermal control](https://github.com/jokimbe/kobra-updated/blob/master/Marlin/src/module/temperature.cpp): `Marlin/src/module/temperature.cpp`
- [Pause and resume](https://github.com/jokimbe/kobra-updated/blob/master/Marlin/src/feature/pause.h): `Marlin/src/feature/pause.h`
- [Print tracking](https://github.com/jokimbe/kobra-updated/blob/master/Marlin/src/module/printcounter.h): `Marlin/src/module/printcounter.h`
- [Controller cooling](https://github.com/jokimbe/kobra-updated/blob/master/Marlin/src/feature/controllerfan.cpp): `Marlin/src/feature/controllerfan.cpp`
- [SD filesystem](https://github.com/jokimbe/kobra-updated/blob/master/Marlin/lib/libraries/FatFs/ff.c): `Marlin/lib/libraries/FatFs/ff.c`

### Display interfaces

- [DGUS input](https://github.com/jokimbe/kobra-updated/blob/master/Marlin/src/lcd/extui/dgus_reloaded/DGUSRxHandler.cpp): `Marlin/src/lcd/extui/dgus_reloaded/DGUSRxHandler.cpp`
- [DGUS screens](https://github.com/jokimbe/kobra-updated/blob/master/Marlin/src/lcd/extui/dgus_reloaded/DGUSScreenHandler.cpp): `Marlin/src/lcd/extui/dgus_reloaded/DGUSScreenHandler.cpp`
- [DGUS output](https://github.com/jokimbe/kobra-updated/blob/master/Marlin/src/lcd/extui/dgus_reloaded/DGUSTxHandler.cpp): `Marlin/src/lcd/extui/dgus_reloaded/DGUSTxHandler.cpp`
- [External UI API](https://github.com/jokimbe/kobra-updated/blob/master/Marlin/src/lcd/extui/ui_api.h): `Marlin/src/lcd/extui/ui_api.h`
- [Vyper display UI](https://github.com/jokimbe/kobra-updated/blob/master/Marlin/src/lcd/extui/anycubic_vyper/dgus_tft.cpp): `Marlin/src/lcd/extui/anycubic_vyper/dgus_tft.cpp`

### Other components

- **Printer operator**
- **Kobra printer**
- **Touch display**

## Connections

- Printer operator → Kobra printer: operates
- Kobra printer → Board startup: boots firmware
- Printer settings → Configuration setup: configures (evidence: `Marlin/src/inc/MarlinConfigPre.h`)
- Advanced settings → Configuration setup: configures (evidence: `Marlin/src/inc/MarlinConfigPre.h`)
- Configuration setup → Configuration assembly: precedes (evidence: `Marlin/src/inc/MarlinConfig.h`)
- Board startup → HC32 drivers: initializes hardware (evidence: `Marlin/lib/cores/arduino/main/main.cpp`)
- Board startup → Firmware core: starts runtime
- HC32 HAL → HC32 drivers: uses drivers
- Firmware core → G-code parsing: dispatches commands
- G-code parsing → Command queue: queues commands
- Command queue → Motion planning: dispatches motion
- Motion planning → Stepper control: provides moves (evidence: `Marlin/src/module/stepper.h`)
- Firmware core → Thermal control: updates temperatures
- Firmware core → Controller cooling: updates cooling
- Firmware core → SD filesystem: accesses media
- DGUS input → External UI API: controls printer (evidence: `Marlin/src/lcd/extui/dgus_reloaded/DGUSRxHandler.cpp`)
- DGUS input → Command queue: queues commands (evidence: `Marlin/src/lcd/extui/dgus_reloaded/DGUSRxHandler.cpp`)
- DGUS output → External UI API: reads printer state (evidence: `Marlin/src/lcd/extui/dgus_reloaded/DGUSTxHandler.cpp`)
- DGUS output → Print tracking: reads print time (evidence: `Marlin/src/lcd/extui/dgus_reloaded/DGUSTxHandler.cpp`)
- DGUS output → Touch display: sends display data
- Touch display → DGUS input: sends input
- DGUS screens → Touch display: manages screens
- Vyper display UI → Touch display: supports display
- Printer operator → Touch display: uses interface
