# swatimishra0416-png/automatic-bidirectional-visitor-counter architecture

> Architecture diagram of the GitHub repository swatimishra0416-png/automatic-bidirectional-visitor-counter, 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/swatimishra0416-png/automatic-bidirectional-visitor-counter
- Repository: https://github.com/swatimishra0416-png/automatic-bidirectional-visitor-counter

## Overview

This is an Arduino room-occupancy counter: two sequential IR sensors determine entry or exit, the system updates a nonnegative visitor count, and that count drives the LCD and occupancy-based light control. The runtime is implemented in one sketch, so its documented processing stages share that source path. The source was not excerpted; relationships shown here are based on the README’s descriptions of system behavior.

Main entry points: [`code/visitor_counter_code/visitor_counter.ino`](https://github.com/swatimishra0416-png/automatic-bidirectional-visitor-counter/blob/main/code/visitor_counter_code/visitor_counter.ino) (Visitor Count)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_sensing["Sensing and Direction"]
  node_debouncing["Sensor Debouncing"]
  node_direction_fsm["Direction FSM"]
end

subgraph group_occupancy["Occupancy State"]
  node_visitor_count["Visitor Count"]
end

subgraph group_outputs["Displays and Controls"]
  node_lcd["16×2 LCD"]
  node_light_control["Light Control"]
  node_relay["Relay Module"]
  node_led["Status LED"]
end

node_ir_sensors["IR Sensors A/B"]
node_room_light["Room Light"]

node_ir_sensors -->|"provide readings"| node_debouncing
node_debouncing -->|"provides stable transitions"| node_direction_fsm
node_direction_fsm -->|"determines count change"| node_visitor_count
node_visitor_count -->|"updates display"| node_lcd
node_visitor_count -->|"determines occupancy output"| node_light_control
node_light_control -->|"switches"| node_relay
node_relay -->|"controls"| node_room_light
node_light_control -->|"indicates output state"| node_led

click node_debouncing "https://github.com/swatimishra0416-png/automatic-bidirectional-visitor-counter/blob/main/code/visitor_counter_code/visitor_counter.ino"
click node_direction_fsm "https://github.com/swatimishra0416-png/automatic-bidirectional-visitor-counter/blob/main/code/visitor_counter_code/visitor_counter.ino"
click node_visitor_count "https://github.com/swatimishra0416-png/automatic-bidirectional-visitor-counter/blob/main/code/visitor_counter_code/visitor_counter.ino"
click node_light_control "https://github.com/swatimishra0416-png/automatic-bidirectional-visitor-counter/blob/main/code/visitor_counter_code/visitor_counter.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_debouncing,node_direction_fsm toneBlue
class node_visitor_count toneAmber
class node_lcd,node_light_control,node_relay,node_led toneMint
class node_ir_sensors,node_room_light toneIndigo
```

## Components

### Sensing and Direction

- [Sensor Debouncing](https://github.com/swatimishra0416-png/automatic-bidirectional-visitor-counter/blob/main/code/visitor_counter_code/visitor_counter.ino): `code/visitor_counter_code/visitor_counter.ino`
- [Direction FSM](https://github.com/swatimishra0416-png/automatic-bidirectional-visitor-counter/blob/main/code/visitor_counter_code/visitor_counter.ino): `code/visitor_counter_code/visitor_counter.ino`

### Occupancy State

- [Visitor Count](https://github.com/swatimishra0416-png/automatic-bidirectional-visitor-counter/blob/main/code/visitor_counter_code/visitor_counter.ino): `code/visitor_counter_code/visitor_counter.ino`

### Displays and Controls

- **16×2 LCD**
- [Light Control](https://github.com/swatimishra0416-png/automatic-bidirectional-visitor-counter/blob/main/code/visitor_counter_code/visitor_counter.ino): `code/visitor_counter_code/visitor_counter.ino`
- **Relay Module**
- **Status LED**

### Other components

- **IR Sensors A/B**
- **Room Light**

## Connections

- IR Sensors A/B → Sensor Debouncing: provide readings (evidence: `README.md`)
- Sensor Debouncing → Direction FSM: provides stable transitions (evidence: `README.md`)
- Direction FSM → Visitor Count: determines count change (evidence: `README.md`)
- Visitor Count → 16×2 LCD: updates display (evidence: `README.md`)
- Visitor Count → Light Control: determines occupancy output (evidence: `README.md`)
- Light Control → Relay Module: switches (evidence: `README.md`)
- Relay Module → Room Light: controls (evidence: `README.md`)
- Light Control → Status LED: indicates output state (evidence: `README.md`)
