# masontl/pico-nife architecture

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

- Interactive diagram: https://gitdiagram.com/masontl/pico-nife
- Repository: https://github.com/masontl/pico-nife

## Overview

P.I.C.O. N.I.F.E. is Arduino firmware for a handheld device-addressing and communications tool, with menu-driven transducer and instrument functions, serial connections, an LCD interface, and a protected transducer-power rail. A separate 9414 loopback sketch provides command-response behavior. The excerpts show menu-state names and character data, but not the main sketch or feature implementations; dashed links mark workflow relationships that are plausible from the product description or tree, not verified calls.

Main entry points: [`Pico Nife code/sans_EEPROM_pico_nife_working_pico_arduino/sans_EEPROM_pico_nife_working_pico_arduino.ino`](https://github.com/masontl/pico-nife/blob/main/Pico%20Nife%20code/sans_EEPROM_pico_nife_working_pico_arduino/sans_EEPROM_pico_nife_working_pico_arduino.ino) (Pico Nife firmware), [`Pico Nife code/sans_EEPROM_pico_nife_working_pico_arduino/navagation_through_pages.ino`](https://github.com/masontl/pico-nife/blob/main/Pico%20Nife%20code/sans_EEPROM_pico_nife_working_pico_arduino/navagation_through_pages.ino) (Page navigation), [`Pico Nife code/sans_EEPROM_pico_nife_working_pico_arduino/display_pages.ino`](https://github.com/masontl/pico-nife/blob/main/Pico%20Nife%20code/sans_EEPROM_pico_nife_working_pico_arduino/display_pages.ino) (Display pages), [`Pico Nife code/sans_EEPROM_pico_nife_working_pico_arduino/handle_button_presses.ino`](https://github.com/masontl/pico-nife/blob/main/Pico%20Nife%20code/sans_EEPROM_pico_nife_working_pico_arduino/handle_button_presses.ino) (Button handling)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Menu and display"]
  node_firmware["Pico Nife firmware"]
  node_menus["Menu states"]
  node_navigation["Page navigation"]
  node_display["Display pages<br/>[display_pages.ino]"]
  node_buttons["Button handling"]
  node_characters["Strike-through glyphs<br/>[strike_through.h]"]
end

subgraph group_instrument["Instrument workflows"]
  node_instrument_helpers["Instrument routines<br/>[sn_voids.ino]"]
  node_instrument_voids["Additional routines<br/>[voids.ino]"]
end

subgraph group_communications["Communications"]
  node_serial["Serial communication"]
end

subgraph group_hardware["Device and power"]
  node_transducer{{"Transducer"}}
  node_instrument_device{{"Connected instrument"}}
  node_lcd["20×4 LCD"]
  node_power["Transducer power switch"]
end

subgraph group_loopback["9414 loopback"]
  node_loopback_sketch["9414 loopback sketch"]
end

node_operator(("Operator"))

node_operator -.->|"operates"| node_firmware
node_firmware -.->|"dispatches pages"| node_navigation
node_navigation -.->|"uses states"| node_menus
node_buttons -.->|"changes pages"| node_navigation
node_display -.->|"renders menus"| node_lcd
node_display -.->|"uses glyphs"| node_characters
node_firmware -->|"controls power"| node_power
node_serial -.->|"communicates"| node_transducer
node_serial -.->|"communicates"| node_instrument_device
node_firmware -.->|"dispatches routines"| node_instrument_helpers
node_firmware -.->|"dispatches routines"| node_instrument_voids

click node_firmware "https://github.com/masontl/pico-nife/blob/main/Pico%20Nife%20code/sans_EEPROM_pico_nife_working_pico_arduino/sans_EEPROM_pico_nife_working_pico_arduino.ino"
click node_menus "https://github.com/masontl/pico-nife/blob/main/Pico%20Nife%20code/sans_EEPROM_pico_nife_working_pico_arduino/main_menu_state_index.h"
click node_navigation "https://github.com/masontl/pico-nife/blob/main/Pico%20Nife%20code/sans_EEPROM_pico_nife_working_pico_arduino/navagation_through_pages.ino"
click node_display "https://github.com/masontl/pico-nife/blob/main/Pico%20Nife%20code/sans_EEPROM_pico_nife_working_pico_arduino/display_pages.ino"
click node_buttons "https://github.com/masontl/pico-nife/blob/main/Pico%20Nife%20code/sans_EEPROM_pico_nife_working_pico_arduino/handle_button_presses.ino"
click node_characters "https://github.com/masontl/pico-nife/blob/main/Pico%20Nife%20code/sans_EEPROM_pico_nife_working_pico_arduino/strike_through.h"
click node_instrument_helpers "https://github.com/masontl/pico-nife/blob/main/Pico%20Nife%20code/sans_EEPROM_pico_nife_working_pico_arduino/sn_voids.ino"
click node_instrument_voids "https://github.com/masontl/pico-nife/blob/main/Pico%20Nife%20code/sans_EEPROM_pico_nife_working_pico_arduino/voids.ino"
click node_serial "https://github.com/masontl/pico-nife/blob/main/Pico%20Nife%20code/sans_EEPROM_pico_nife_working_pico_arduino/sans_EEPROM_pico_nife_working_pico_arduino.ino"
click node_loopback_sketch "https://github.com/masontl/pico-nife/blob/main/9414%20loopback%20code/loopback_9414_command_responses/loopback_9414_command_responses.ino"

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_firmware,node_menus,node_navigation,node_display,node_buttons,node_characters toneBlue
class node_instrument_helpers,node_instrument_voids toneAmber
class node_serial toneMint
class node_transducer,node_instrument_device,node_lcd,node_power toneRose
class node_loopback_sketch,node_operator toneIndigo
```

## Components

### Menu and display

- [Pico Nife firmware](https://github.com/masontl/pico-nife/blob/main/Pico%20Nife%20code/sans_EEPROM_pico_nife_working_pico_arduino/sans_EEPROM_pico_nife_working_pico_arduino.ino): `Pico Nife code/sans_EEPROM_pico_nife_working_pico_arduino/sans_EEPROM_pico_nife_working_pico_arduino.ino`
- [Menu states](https://github.com/masontl/pico-nife/blob/main/Pico%20Nife%20code/sans_EEPROM_pico_nife_working_pico_arduino/main_menu_state_index.h): `Pico Nife code/sans_EEPROM_pico_nife_working_pico_arduino/main_menu_state_index.h`
- [Page navigation](https://github.com/masontl/pico-nife/blob/main/Pico%20Nife%20code/sans_EEPROM_pico_nife_working_pico_arduino/navagation_through_pages.ino): `Pico Nife code/sans_EEPROM_pico_nife_working_pico_arduino/navagation_through_pages.ino`
- [Display pages](https://github.com/masontl/pico-nife/blob/main/Pico%20Nife%20code/sans_EEPROM_pico_nife_working_pico_arduino/display_pages.ino): `Pico Nife code/sans_EEPROM_pico_nife_working_pico_arduino/display_pages.ino`
- [Button handling](https://github.com/masontl/pico-nife/blob/main/Pico%20Nife%20code/sans_EEPROM_pico_nife_working_pico_arduino/handle_button_presses.ino): `Pico Nife code/sans_EEPROM_pico_nife_working_pico_arduino/handle_button_presses.ino`
- [Strike-through glyphs](https://github.com/masontl/pico-nife/blob/main/Pico%20Nife%20code/sans_EEPROM_pico_nife_working_pico_arduino/strike_through.h): `Pico Nife code/sans_EEPROM_pico_nife_working_pico_arduino/strike_through.h`

### Instrument workflows

- [Instrument routines](https://github.com/masontl/pico-nife/blob/main/Pico%20Nife%20code/sans_EEPROM_pico_nife_working_pico_arduino/sn_voids.ino): `Pico Nife code/sans_EEPROM_pico_nife_working_pico_arduino/sn_voids.ino`
- [Additional routines](https://github.com/masontl/pico-nife/blob/main/Pico%20Nife%20code/sans_EEPROM_pico_nife_working_pico_arduino/voids.ino): `Pico Nife code/sans_EEPROM_pico_nife_working_pico_arduino/voids.ino`

### Communications

- [Serial communication](https://github.com/masontl/pico-nife/blob/main/Pico%20Nife%20code/sans_EEPROM_pico_nife_working_pico_arduino/sans_EEPROM_pico_nife_working_pico_arduino.ino): `Pico Nife code/sans_EEPROM_pico_nife_working_pico_arduino/sans_EEPROM_pico_nife_working_pico_arduino.ino`

### Device and power

- **Transducer**
- **Connected instrument**
- **20×4 LCD**
- **Transducer power switch**

### 9414 loopback

- [9414 loopback sketch](https://github.com/masontl/pico-nife/blob/main/9414%20loopback%20code/loopback_9414_command_responses/loopback_9414_command_responses.ino): `9414 loopback code/loopback_9414_command_responses/loopback_9414_command_responses.ino`

### Other components

- **Operator**

## Connections

- Operator → Pico Nife firmware: operates
- Pico Nife firmware → Page navigation: dispatches pages
- Page navigation → Menu states: uses states
- Button handling → Page navigation: changes pages
- Display pages → 20×4 LCD: renders menus
- Display pages → Strike-through glyphs: uses glyphs
- Pico Nife firmware → Transducer power switch: controls power (evidence: `readme.md`)
- Serial communication → Transducer: communicates
- Serial communication → Connected instrument: communicates
- Pico Nife firmware → Instrument routines: dispatches routines
- Pico Nife firmware → Additional routines: dispatches routines
