display

# Display — Eyes & Info ## Quick Start Controls the lamp's 1.28" round LCD display (GC9A01, 240x240). Two modes: animated eyes (default) and info text. Usually auto-synced by the Emotion skill — only call directly for manual eye control or info display. ## Workflow 1. Determine the mode needed: - **Eyes**: `[HW:/display/eyes:{"expression":"happy","pupil_x":0.0,"pupil_y":0.0}]` - **Info**: `[HW:/display/info:{"text":"14:30","subtitle":"Good afternoon"}]` then `[HW:/display/eyes-mode:{}]` 2. Place markers at start of reply — Lamp fires them before TTS. Skip silently if display unavailable. **Important**: The Emotion skill auto-syncs eyes during conversation. Do not call both Emotion and Display for the same reaction. ## Examples **Input:** "Look to the left" **Output:** `[HW:/display/eyes:{"expression":"neutral","pupil_x":-1.0,"pupil_y":0.0}]` (no confirmation needed) **Input:** "What time is it?" **Output:** `[HW:/display/info:{"text":"14:30","subtitle":"Good afternoon"}]` It's 2:30 PM. **Input:** "Show me a happy face" **Output:** `[HW:/display/eyes:{"expression":"happy"}]` Here's a happy face! ## How to Control Display **No exec/curl needed.** Inline markers at start of reply: ``` [HW:/display/eyes:{"expression":"happy","pupil_x":0.0,"pupil_y":0.0}] [HW:/display/info:{"text":"14:30","subtitle":"Good afternoon"}] [HW:/display/eyes-mode:{}] ``` - `pupil_x`: -1.0 (look left) to 1.0 (look right) - `pupil_y`: -1.0 (look up) to 1.0 (look down) - `text`: max 20 characters, `subtitle`: optional max 40 characters ### Available expressions | Expression | When to use | |---|---| | `neutral` | Default resting state | | `happy` | Good news, jokes, greetings | | `sad` | Bad news, empathy | | `curious` | Questions, interest | | `thinking` | Processing, considering | | `excited` | Big news, enthusiasm | | `shy` | Bashful, compliments received | | `shock` | Surprises | | `sleepy` | Late night, tired | | `angry` | Frustration (use sparingly) | | `love` | Affection | ## Error Handling - If `GET /display` returns unavailable or the API is unreachable, skip all display calls silently. Do not error out to the user. - If an invalid expression is given, fall back to `neutral`. - If text exceeds character limits, truncate gracefully. ## Rules - **Emotion skill auto-syncs eyes** — when you call `POST /emotion`, the display updates automatically. Do not call both. - **Info mode is temporary** — show info briefly, then switch back to eyes. - The display is plugin hardware — it may not be available. Always check first, and skip silently if absent. - Do not use this skill for normal conversation reactions — use the Emotion skill instead. ## Output Template ``` [Display] Mode: {eyes|info} Expression: {expression} | Text: {text} Status: {success|skipped|unavailable} ```