Troubleshooting

Troubleshooting

Symptom	Check
Unsupported document version	Send the exact string "2.0"; migrate v1 commands with Versioning.
Text does not appear	Use draw_text, positive box dimensions, nonempty spans, size 6–96, and explicit family helvetica.
Text breaks mid-word or has no ellipsis	These are current renderer limitations; see Draw Text.
Empty response leaves the old display	An empty parsed command list skips refresh. Send clear to blank it.
Image is rejected	Check raw palette format and decoded length ceil(width * height / 2); do not send PNG/JPEG bytes directly.
Response is too large	Keep the entire JSON body within 128 KiB. Prefer primitives and small images.
Geometry near the edge is missing	Some primitives reject out-of-bounds arguments instead of clipping. Check the command page.
Shapes, images, and text do not align exactly	Review the coordinate offsets in Renderer Notes.
Device cannot reach a local server	Use the server computer's reachable LAN address; check its listening interface and that the endpoint returns JSON.
Schedule is rejected	Use exactly five fields, each a single number or *; steps and ranges are unsupported.
Device sleeps without refreshing	Inspect serial logs at 115200 for WiFi, clock, JSON, and allocation failures. A missing valid clock causes a 15-minute retry sleep.
Configuration page is unavailable	Wake via the setup button or start without saved WiFi credentials, join the configuration AP, and open http://192.48.56.2/.

For a minimal endpoint, use Examples or PHP Library. Build and wiring instructions are in Hardware and Setup.