node-red-contrib-knx-ultimate/tutorial/knxUltimateViewer.md

Control your KNX and KNX Secure intallation via Node-Red! A bunch of KNX nodes, with integrated Philips HUE control and ETS group address importer. Easy to use and highly configurable.

# knxUltimateViewer Node – Tutorial Outline

## 1. Intro (0:00)
- "Welcome! The `knxUltimateViewer` node is your real-time KNX dashboard feed."
- "It streams all group addresses connected to the gateway and prepares data for UI widgets, lists, and queues."

## 2. Inputs & Outputs (0:20)
- Inputs: none.
- Outputs: three distinct feeds.
  - Output 1: GA dashboard payload (detailed object per telegram).
  - Output 2: simple array of values for rapid processing.
  - Output 3: queue-style updates (FIFO) useful for logs."

## 3. Core Setup (0:50)
- **Server**: select the KNX gateway to observe.
- **Name**: optional label shown in the workspace.
- No other configuration is required: deploy and start viewing traffic."

## 4. Output Format Details (1:15)
- Output 1: includes GA, DPT, decoded value, timestamp, and secure flag.
- Output 2: simplified structure `[ga, value, timestamp]` for dashboards or context storage.
- Output 3: queue-friendly objects sorted by arrival order for history panels."

## 5. Usage Patterns (1:45)
- Build a Node-RED dashboard to display live KNX telegrams.
- Store snapshots into context or external databases for analysis.
- Trigger alerts when specific addresses change without wiring dedicated listeners."

## 6. Best Practices (2:10)
- Pair with `knxUltimateLogger` for persistent auditing.
- Use function nodes downstream to filter by GA or DPT as needed.
- Keep the viewer disabled in production if you don’t require live dashboards—reduces overhead."

## 7. Demo Ideas (2:35)
- Basic debugging: print output 1 to debug sidebar while commissioning.
- UI table: use output 2 to populate an editable list of KNX states.
- History log: feed output 3 into a rolling buffer for timeline charts."

## 8. Wrap-Up & CTA (3:00)
- "We connected the gateway, explored the three outputs, and suggested dashboard ideas."
- "Subscribe for more KNX monitoring tips and share your viewer dashboards!"