EZIO-G500 Go Library

A Go library for the EZIO-G500 graphics LCD display found in Checkpoint/pfSense appliances.

Features

• Status Daemon — 7 rotating screens with live system metrics
• Animated Logo — Rotating 3D "pf" with smooth 10Hz animation
• LED Health Indicators — CPU/memory threshold alerts (green/orange/red)
• Live Bandwidth — Per-interface KB/s rates sorted by traffic
• 128x64 Graphics — Full framebuffer with drawing primitives
• Memory Optimized — Background metrics, ring buffers, stale pruning
• pfSense Integration — CPU, memory, interfaces, WireGuard tunnels

Architecture

┌─────────────────┐     ┌─────────────────┐
│ Metrics Thread  │     │  Display Thread │
│ (every 5 sec)   │────▸│  (2Hz/10Hz)     │
│ sysctl, netstat │     │  render cache   │
└─────────────────┘     └─────────────────┘
         │                       │
         ▼                       ▼
    ┌─────────┐           ┌───────────┐
    │  Cache  │           │ Serial I/O│
    └─────────┘           │ (direct)  │
                          └───────────┘

• Metrics thread: Fetches system data every 5 seconds
• Display thread: Reads from cache, never blocks on I/O
• Adaptive frame rate: 10Hz for logo, 2Hz for other screens
• Direct serial I/O: No subprocess spawning during operation

Quick Start (pfSense)

# SSH to your pfSense device
ssh root@your-pfsense-ip

# Download and install
fetch -o install.sh https://raw.githubusercontent.com/sagostin/ezio-g500/main/scripts/install-pfsense.sh
chmod +x install.sh && ./install.sh

Status Screens

The daemon cycles through 7 screens (10 seconds each):

Screen	Content
Logo	3D rotating pf, hostname, uptime, CPU/MEM
CPU	Usage bar, load average, uptime
Memory	Usage bar, used/free MB
Interfaces	Active interfaces with IPs (sorted by traffic)
WAN Traffic	Live WAN bandwidth (KB/s)
Tunnel Traffic	VPN/WireGuard bandwidth
LAN Traffic	Other interfaces bandwidth

LED Indicators

LED	Meaning
LED1 (top)	🟢 Logo screen, 🟠 Traffic screens
LED2 (middle)	🟢 Healthy, 🟠 Warning (70-90%), 🔴 Critical (>90%)
LED3 (bottom)	🟢 Home (logo screen)

Manual Usage

# Run status daemon
eziolcd -port /dev/cuau1 daemon

# Show single status
eziolcd -port /dev/cuau1 status

# Display text
eziolcd -port /dev/cuau1 text "Hello World"

# Control LEDs
eziolcd -port /dev/cuau1 led 1 green

Building

git clone https://github.com/sagostin/ezio-g500.git
cd ezio-g500

# Build for pfSense
GOOS=freebsd GOARCH=amd64 go build -o eziolcd-freebsd-amd64 ./cmd/eziolcd

# Deploy
cd scripts && ./deploy.sh install

Serial Ports

Platform	Port
pfSense/FreeBSD	/dev/cuau1
Linux	/dev/ttyS1
USB Serial	/dev/ttyUSB0

Package Structure

pkg/
├── eziog500/     # Core driver: device, framebuffer, LEDs
├── display/      # High-level display API
├── font/         # 8px and 6px pixel fonts
├── pfsense/      # Metrics and status screens
├── menu/         # Interactive menu system
├── render3d/     # 3D wireframe rendering
└── ui/           # UI widgets

Credits

Protocol reverse engineering by:

• Saint-Frater
• tchatzi

License

MIT License