89 lines
5.0 KiB
Markdown
89 lines
5.0 KiB
Markdown
# Eikos connectivity and Preview check
|
|
|
|
## Verified on 2026-11-13
|
|
|
|
User-authorized hardware check on an **Eikos 4K, firmware 3.3.10**. The unit
|
|
reported this identity through `GET /api/tpp/v1/system`. Its WebRCS bundle was
|
|
`app.e42fce4879f318b28cde.js`. The device address was supplied for this session;
|
|
it is not a compiled-in application default.
|
|
|
|
- HTTP read access and WebRCS WebSocket feedback worked without authentication
|
|
on this configured device. Do not assume other installations permit this.
|
|
- `GET /api/stores/device` returned the state tree used by WebRCS, including
|
|
screen canvas dimensions, layer center positions/container sizes, source
|
|
assignments, crop/mask fields and transition state.
|
|
- The explicit REST read
|
|
`/api/tpp/v1/screens/2/live-layers/1/presets/preview` reported input 4,
|
|
matching the internal Preview bank. That REST response contained source/status,
|
|
not the full geometry. Geometry was obtained from the WebRCS state endpoint.
|
|
- Screen 2's transition state was `AT_DOWN`: Program was `DOWN`, Preview `UP`.
|
|
WebRCS's own bank-selection code maps `AT_UP` the other way around. These
|
|
are physical banks, **not permanent Program/Preview identifiers**.
|
|
- A single Preview layer property was changed over the WebRCS WebSocket:
|
|
screen 2, bank `UP`, layer 1, `position.pp.posH`, **1436 → 1437 → 1436**.
|
|
Readback confirmed the intermediate change and restoration. The complete
|
|
tested layer matched its original state after restoration. All four screen
|
|
Program preset trees matched before, during and after this test.
|
|
- No TAKE, CUT, transition, Program, input/global crop, output configuration,
|
|
source-routing or preset-memory command was sent. Raw snapshots remain
|
|
temporary local artifacts and are not committed.
|
|
|
|
The message envelope observed and tested was `channel: "DEVICE"`, with
|
|
`data.path` an array of state-tree keys and `data.value` the new scalar value.
|
|
The read path for the tested property was:
|
|
|
|
```
|
|
device/screenList/items/2/presetList/items/UP/liveLayerList/items/1/position/pp/posH
|
|
```
|
|
|
|
This is evidence of a working bidirectional link, **not validation of either
|
|
advanced-crop export strategy**. Only horizontal center movement was exercised.
|
|
The WebRCS internal endpoint/protocol is firmware-specific, rather than a promise
|
|
of stable public REST geometry support. Manufacturer references are linked from
|
|
[the official Eikos downloads section](https://www.analogway.com/products/eikos-4k).
|
|
The linked API PDFs were not accessible during this check; protocol findings
|
|
above come from the installed device and its own WebRCS bundle.
|
|
|
|
## Read-only import bridge
|
|
|
|
The desktop app remains offline. A standard-library Python helper provides a
|
|
reproducible read-only bridge while the GUI device adapter is developed:
|
|
|
|
```sh
|
|
python3 tools/midra_probe.py --host DEVICE_IP --save-snapshot /tmp/eikos-state.json
|
|
python3 tools/midra_probe.py --host DEVICE_IP --screen 2 --layers 1 2 --svg /tmp/preview.svg
|
|
# Replay a saved snapshot without connecting:
|
|
python3 tools/midra_probe.py --snapshot /tmp/eikos-state.json --screen 2 --layers 1 2 --svg /tmp/replay.svg
|
|
```
|
|
|
|
Select the matching number of editor layers, choose **Import SVG**, and review
|
|
mapping before applying. Match the editor output resolution to the device canvas;
|
|
SVG geometry import does not replace the editor's screen settings.
|
|
The helper exports **container geometry only**: center minus half-size becomes
|
|
top-left x/y, preserving half pixels. Source aspect fitting can make the visible
|
|
picture differ from this container. Routing, source resolution, source cropping,
|
|
effects, borders, opacity and zoom are not imported. Nonzero layer crop or mask
|
|
is refused rather than silently imported as final visible bounds. Device slots
|
|
are explicitly selected; unused slots are not assumed to be available layers.
|
|
|
|
The helper has no device write operation, bypasses system proxies, refuses
|
|
redirects, bounds reads to 32 MiB and never overwrites an existing output file.
|
|
Snapshots may contain network/private configuration; keep them out of Git and
|
|
sanitize before sharing. Its exchange contract is documented in
|
|
[interfaces](interfaces/midra-device-import.md).
|
|
|
|
## Remaining integration work
|
|
|
|
- Build a reviewed GUI import with explicit screen/layer mapping and unsupported
|
|
state reporting; preserve the current project until import is accepted.
|
|
- Verify source/input and layer crop units and Centered aspect behavior. Observed
|
|
crop edge values such as `18350` must not be interpreted as editor source pixels.
|
|
- Validate size, vertical position, odd dimensions and both export strategies
|
|
independently before enabling their device commands.
|
|
- Production writes need explicit Preview targeting, transition-state monitoring,
|
|
fresh before/after review and stale-state rejection. A GET followed by a
|
|
physical-bank write is not atomic: another controller can TAKE between them.
|
|
Do not expose this diagnostic write technique as a generally safe send button.
|
|
- Never write shared input/output configuration to implement a Preview-only edit.
|
|
No Program or TAKE operation belongs in this layout tool's Preview adapter.
|