# sreesamanvithamanoorvadhoolas/electronicclock architecture

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

- Interactive diagram: https://gitdiagram.com/sreesamanvithamanoorvadhoolas/electronicclock
- Repository: https://github.com/sreesamanvithamanoorvadhoolas/electronicclock

## Overview

EClock is embedded firmware for a PSoC-based electronic clock. Its visible startup path initializes the display and logger, configures the ErikaOS system tick, starts the OS, and activates application tasks; button interrupts signal the control task. The tree also shows clock, state-machine, RTE, and display components, but their detailed runtime wiring is not excerpted. The ErikaOS customizer configures tasks, alarms, counters, events, resources, and ISRs. Those subsystems are included, with uncertain links omitted rather than inferred.

Main entry points: [`EClock.cydsn/source/asw/main.c`](https://github.com/sreesamanvithamanoorvadhoolas/electronicclock/blob/master/EClock.cydsn/source/asw/main.c) (Firmware startup), [`EClock.cydsn/source/rte/rte.c`](https://github.com/sreesamanvithamanoorvadhoolas/electronicclock/blob/master/EClock.cydsn/source/rte/rte.c) (Runtime environment), [`EClock.cydsn/ErikaOS_v2_5_3/Custom/ErikaOSParameters.cs`](https://github.com/sreesamanvithamanoorvadhoolas/electronicclock/blob/master/EClock.cydsn/ErikaOS_v2_5_3/Custom/ErikaOSParameters.cs) (OS customizer), [`EClock.cydsn/source/asw/tsk_control.c`](https://github.com/sreesamanvithamanoorvadhoolas/electronicclock/blob/master/EClock.cydsn/source/asw/tsk_control.c) (Control task)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_application["Clock application"]
  node_startup["Firmware startup<br/>[main.c]"]
  node_clock["Clock logic<br/>[clock.c]"]
  node_state["State machine<br/>[statemachine.c]"]
  node_input_task["Input task<br/>[tsk_input.c]"]
  node_control_task["Control task<br/>[tsk_control.c]"]
  node_system_task["System task<br/>[tsk_system.c]"]
end

subgraph group_runtime["RTE and OS"]
  node_rte["Runtime environment<br/>[rte.c]"]
  node_rte_signals["RTE signals<br/>[sc_control.c]"]
  node_display_signal["Display signal<br/>[sc_display.c]"]
  node_input_signal["Input signal<br/>[sc_input.c]"]
  node_erika["ErikaOS services<br/>[ee_startos.c]"]
end

subgraph group_hardware["Board interfaces"]
  node_hal["PSoC hardware<br/>[project.h]"]
  node_tft["TFT display driver<br/>[tft.c]"]
  node_logging["UART logging<br/>[logging.c]"]
end

subgraph group_configuration["OS configuration"]
  node_os_customizer["OS customizer"]
  node_task_editor["Task editor<br/>[ErikaOSTask.cs]"]
  node_alarm_config["Alarm configuration"]
  node_isr_config["ISR configuration<br/>[ErikaOSISRs.cs]"]
end

node_user(("Clock user"))

node_user -.->|"presses buttons"| node_input_task
node_startup -->|"initializes interrupts"| node_hal
node_startup -->|"initializes display"| node_tft
node_startup -->|"starts logger"| node_logging
node_startup -->|"starts OS"| node_erika
node_startup -->|"activates task"| node_control_task
node_startup -->|"activates task"| node_system_task
node_startup -->|"activates task"| node_input_task
node_startup -->|"prints startup text"| node_tft
node_control_task -.->|"uses state logic"| node_state
node_clock -.->|"uses signal API"| node_rte_signals
node_rte -.->|"dispatches signals"| node_rte_signals
node_rte -.->|"dispatches signals"| node_display_signal
node_rte -.->|"dispatches signals"| node_input_signal
node_os_customizer -->|"configures tasks"| node_task_editor
node_os_customizer -->|"configures alarms"| node_alarm_config
node_os_customizer -->|"configures ISRs"| node_isr_config

click node_startup "https://github.com/sreesamanvithamanoorvadhoolas/electronicclock/blob/master/EClock.cydsn/source/asw/main.c"
click node_clock "https://github.com/sreesamanvithamanoorvadhoolas/electronicclock/blob/master/EClock.cydsn/source/asw/clock.c"
click node_state "https://github.com/sreesamanvithamanoorvadhoolas/electronicclock/blob/master/EClock.cydsn/source/asw/statemachine.c"
click node_input_task "https://github.com/sreesamanvithamanoorvadhoolas/electronicclock/blob/master/EClock.cydsn/source/asw/tsk_input.c"
click node_control_task "https://github.com/sreesamanvithamanoorvadhoolas/electronicclock/blob/master/EClock.cydsn/source/asw/tsk_control.c"
click node_system_task "https://github.com/sreesamanvithamanoorvadhoolas/electronicclock/blob/master/EClock.cydsn/source/asw/tsk_system.c"
click node_rte "https://github.com/sreesamanvithamanoorvadhoolas/electronicclock/blob/master/EClock.cydsn/source/rte/rte.c"
click node_rte_signals "https://github.com/sreesamanvithamanoorvadhoolas/electronicclock/blob/master/EClock.cydsn/source/rte/sc_control.c"
click node_display_signal "https://github.com/sreesamanvithamanoorvadhoolas/electronicclock/blob/master/EClock.cydsn/source/rte/sc_display.c"
click node_input_signal "https://github.com/sreesamanvithamanoorvadhoolas/electronicclock/blob/master/EClock.cydsn/source/rte/sc_input.c"
click node_erika "https://github.com/sreesamanvithamanoorvadhoolas/electronicclock/blob/master/EClock.cydsn/ErikaOS_v2_5_3/API/ee_startos.c"
click node_hal "https://github.com/sreesamanvithamanoorvadhoolas/electronicclock/blob/master/EClock.cydsn/codegentemp/project.h"
click node_tft "https://github.com/sreesamanvithamanoorvadhoolas/electronicclock/blob/master/EClock.cydsn/source/bsw/tft/tft.c"
click node_logging "https://github.com/sreesamanvithamanoorvadhoolas/electronicclock/blob/master/EClock.cydsn/source/bsw/logging.c"
click node_os_customizer "https://github.com/sreesamanvithamanoorvadhoolas/electronicclock/blob/master/EClock.cydsn/ErikaOS_v2_5_3/Custom/ErikaOSParameters.cs"
click node_task_editor "https://github.com/sreesamanvithamanoorvadhoolas/electronicclock/blob/master/EClock.cydsn/ErikaOS_v2_5_3/Custom/ErikaOSTask.cs"
click node_alarm_config "https://github.com/sreesamanvithamanoorvadhoolas/electronicclock/blob/master/EClock.cydsn/ErikaOS_v2_5_3/Custom/ErikaOSAlarmsCounters.cs"
click node_isr_config "https://github.com/sreesamanvithamanoorvadhoolas/electronicclock/blob/master/EClock.cydsn/ErikaOS_v2_5_3/Custom/ErikaOSISRs.cs"

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_startup,node_clock,node_state,node_input_task,node_control_task,node_system_task,node_user toneBlue
class node_rte,node_rte_signals,node_display_signal,node_input_signal,node_erika toneAmber
class node_hal,node_tft,node_logging toneMint
class node_os_customizer,node_task_editor,node_alarm_config,node_isr_config toneRose
```

## Components

### Clock application

- [Firmware startup](https://github.com/sreesamanvithamanoorvadhoolas/electronicclock/blob/master/EClock.cydsn/source/asw/main.c): `EClock.cydsn/source/asw/main.c`
- [Clock logic](https://github.com/sreesamanvithamanoorvadhoolas/electronicclock/blob/master/EClock.cydsn/source/asw/clock.c): `EClock.cydsn/source/asw/clock.c`
- [State machine](https://github.com/sreesamanvithamanoorvadhoolas/electronicclock/blob/master/EClock.cydsn/source/asw/statemachine.c): `EClock.cydsn/source/asw/statemachine.c`
- [Input task](https://github.com/sreesamanvithamanoorvadhoolas/electronicclock/blob/master/EClock.cydsn/source/asw/tsk_input.c): `EClock.cydsn/source/asw/tsk_input.c`
- [Control task](https://github.com/sreesamanvithamanoorvadhoolas/electronicclock/blob/master/EClock.cydsn/source/asw/tsk_control.c): `EClock.cydsn/source/asw/tsk_control.c`
- [System task](https://github.com/sreesamanvithamanoorvadhoolas/electronicclock/blob/master/EClock.cydsn/source/asw/tsk_system.c): `EClock.cydsn/source/asw/tsk_system.c`

### RTE and OS

- [Runtime environment](https://github.com/sreesamanvithamanoorvadhoolas/electronicclock/blob/master/EClock.cydsn/source/rte/rte.c): `EClock.cydsn/source/rte/rte.c`
- [RTE signals](https://github.com/sreesamanvithamanoorvadhoolas/electronicclock/blob/master/EClock.cydsn/source/rte/sc_control.c): `EClock.cydsn/source/rte/sc_control.c`
- [Display signal](https://github.com/sreesamanvithamanoorvadhoolas/electronicclock/blob/master/EClock.cydsn/source/rte/sc_display.c): `EClock.cydsn/source/rte/sc_display.c`
- [Input signal](https://github.com/sreesamanvithamanoorvadhoolas/electronicclock/blob/master/EClock.cydsn/source/rte/sc_input.c): `EClock.cydsn/source/rte/sc_input.c`
- [ErikaOS services](https://github.com/sreesamanvithamanoorvadhoolas/electronicclock/blob/master/EClock.cydsn/ErikaOS_v2_5_3/API/ee_startos.c): `EClock.cydsn/ErikaOS_v2_5_3/API/ee_startos.c`

### Board interfaces

- [PSoC hardware](https://github.com/sreesamanvithamanoorvadhoolas/electronicclock/blob/master/EClock.cydsn/codegentemp/project.h): `EClock.cydsn/codegentemp/project.h`
- [TFT display driver](https://github.com/sreesamanvithamanoorvadhoolas/electronicclock/blob/master/EClock.cydsn/source/bsw/tft/tft.c): `EClock.cydsn/source/bsw/tft/tft.c`
- [UART logging](https://github.com/sreesamanvithamanoorvadhoolas/electronicclock/blob/master/EClock.cydsn/source/bsw/logging.c): `EClock.cydsn/source/bsw/logging.c`

### OS configuration

- [OS customizer](https://github.com/sreesamanvithamanoorvadhoolas/electronicclock/blob/master/EClock.cydsn/ErikaOS_v2_5_3/Custom/ErikaOSParameters.cs): `EClock.cydsn/ErikaOS_v2_5_3/Custom/ErikaOSParameters.cs`
- [Task editor](https://github.com/sreesamanvithamanoorvadhoolas/electronicclock/blob/master/EClock.cydsn/ErikaOS_v2_5_3/Custom/ErikaOSTask.cs): `EClock.cydsn/ErikaOS_v2_5_3/Custom/ErikaOSTask.cs`
- [Alarm configuration](https://github.com/sreesamanvithamanoorvadhoolas/electronicclock/blob/master/EClock.cydsn/ErikaOS_v2_5_3/Custom/ErikaOSAlarmsCounters.cs): `EClock.cydsn/ErikaOS_v2_5_3/Custom/ErikaOSAlarmsCounters.cs`
- [ISR configuration](https://github.com/sreesamanvithamanoorvadhoolas/electronicclock/blob/master/EClock.cydsn/ErikaOS_v2_5_3/Custom/ErikaOSISRs.cs): `EClock.cydsn/ErikaOS_v2_5_3/Custom/ErikaOSISRs.cs`

### Other components

- **Clock user**

## Connections

- Clock user → Input task: presses buttons
- Firmware startup → PSoC hardware: initializes interrupts (evidence: `EClock.cydsn/source/asw/main.c`)
- Firmware startup → TFT display driver: initializes display (evidence: `EClock.cydsn/source/asw/main.c`)
- Firmware startup → UART logging: starts logger (evidence: `EClock.cydsn/source/asw/main.c`)
- Firmware startup → ErikaOS services: starts OS (evidence: `EClock.cydsn/source/asw/main.c`)
- Firmware startup → Control task: activates task (evidence: `EClock.cydsn/source/asw/main.c`)
- Firmware startup → System task: activates task (evidence: `EClock.cydsn/source/asw/main.c`)
- Firmware startup → Input task: activates task (evidence: `EClock.cydsn/source/asw/main.c`)
- Firmware startup → TFT display driver: prints startup text (evidence: `EClock.cydsn/source/asw/main.c`)
- Control task → State machine: uses state logic
- Clock logic → RTE signals: uses signal API
- Runtime environment → RTE signals: dispatches signals
- Runtime environment → Display signal: dispatches signals
- Runtime environment → Input signal: dispatches signals
- OS customizer → Task editor: configures tasks (evidence: `EClock.cydsn/ErikaOS_v2_5_3/Custom/ErikaOSTask.cs`)
- OS customizer → Alarm configuration: configures alarms (evidence: `EClock.cydsn/ErikaOS_v2_5_3/Custom/ErikaOSAlarmsCounters.cs`)
- OS customizer → ISR configuration: configures ISRs (evidence: `EClock.cydsn/ErikaOS_v2_5_3/Custom/ErikaOSISRs.cs`)
