103 lines
5.7 KiB
Markdown
103 lines
5.7 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 now has **Import → Midra Preview…**, also accessible from
|
||
**Preferences → Midra integration**. Enter the device IP and click **Read / refresh**.
|
||
Reads run in a worker thread; canceling discards late results. Choose a screen and
|
||
exactly as many device layers as selected editor layers, then **Review import…**
|
||
opens the existing mapping dialog. Output resolutions must match. Reading never
|
||
changes the document; only applying the reviewed import does. No automatic
|
||
connection or polling occurs, and no credentials or address are persisted.
|
||
|
||
The Rust adapter was tested against the same Eikos 3.3.10: two 1920×1080 screens;
|
||
disabled zero-canvas screen slots are filtered. A CLI smoke check is available:
|
||
|
||
```sh
|
||
cargo run -p midra-layout --example read_midra -- DEVICE_IP
|
||
```
|
||
|
||
A standard-library Python helper remains available for snapshot capture/offline replay:
|
||
|
||
```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
|
||
|
||
- Extend the implemented reviewed GUI container import to full source/framing
|
||
conversion after the corresponding hardware mapping is verified.
|
||
- 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.
|