Novastar H Series Api Here
{ "jsonrpc": "2.0", "result": { "token": "session_token_abc123", "expires_in": 3600 }, "id": 1 } You must include this token in the X-Auth-Token header or params for subsequent calls. Here are the most valuable endpoints for developers working with the H series API. Use these to control your LED wall programmatically. 1. Switching Input Source This is the most common command. H Series supports multiple layers (Layer A, Layer B, and PIP).
{ "jsonrpc": "2.0", "method": "login", "params": { "username": "admin", "password": "your_password" }, "id": 1 }
In the world of professional LED display control, NovaStar has long been synonymous with reliability and cutting-edge technology. While their popular VX series and MX series dominate the all-in-one controller market, the H Series (specifically the H2, H5, and H9) represents a different beast entirely: a modular, high-performance sending card controller designed for large-scale, mission-critical LED installations. novastar h series api
{ "jsonrpc": "2.0", "method": "display/brightness", "params": { "token": "session_token_abc123", "value": 65 }, "id": 3 } (Range: 0 to 100) H Series allows saving "User Modes" (Presets). This loads an entire configuration: source, scaling, color temp.
# Dim screen for mood lighting await websocket.send(json.dumps({ "jsonrpc": "2.0", "method": "display/brightness", "params": {"token": token, "value": 10}, "id": 2 })) print("Screen dimmed to 10%") asyncio.run(control_novastar_h9()) Even with perfect code, the physical network matters. Here are the three most common failures: Error: Code -32001 – Method Not Found Cause: Your firmware is too old or the syntax is for the wrong H model. Fix: Upgrade to H series v1.8.2+. The H2 does not support cropping; the H9 does. Error: Code -32602 – Invalid Params Cause: You sent a string instead of an integer (e.g., "brightness": "50" instead of 50 ). Fix: Strictly adhere to JSON types. Booleans must be true/false , not "true" . Issue: Connection drops after 60 seconds Cause: No heartbeat or session timeout. Fix: Implement a "keep-alive" background task: { "jsonrpc": "2
{ "jsonrpc": "2.0", "method": "preset/load", "params": { "token": "session_token_abc123", "index": 0 }, "id": 4 } Note: index corresponds to the numbered preset slot (0-7). For mission-critical walls, you need to know if the controller is overheating or losing signal.
set:cropping
import asyncio import websockets import json async def control_novastar_h9(): uri = "ws://192.168.1.100:8088/novastar/api" async with websockets.connect(uri) as websocket: # Login await websocket.send(json.dumps({ "jsonrpc": "2.0", "method": "login", "params": {"username": "admin", "password": "123456"}, "id": 1 })) response = await websocket.recv() token = json.loads(response)['result']['token']