edid

The edid command manages the EDID library: the named EDID entries that can be stored, edited, and applied to transmitter devices.


Command Type	DisplayNet
Minimum Version	2.x.x

Usage

edid list
edid create <edid_name> <hex_value>
edid update <edid_name> <hex_value>
edid rename <old_name> <new_name>
edid delete <edid_name>
edid upload <edid_name> <devicelist>

Subcommands

Subcommand	Description
`list`	Returns all EDID entries in the library
`create`	Creates a new library entry
`update`	Updates an entry to a new EDID hex value
`rename`	Renames an entry
`delete`	Deletes an entry
`upload`	Applies an entry to one or more transmitter devices

Arguments

Argument	Required	Description
`edid_name`	All except `list`	The name of an EDID library entry. Case-insensitive.
`hex_value`	`create`, `update`	A valid EDID in hexadecimal format. Validated before being stored.
`devicelist`	`upload`	A comma-delimited list of device names or MAC addresses.

upload targets transmitters only

Only transmitter devices are valid targets for upload. The ALL and ALL_RX group names cannot be used.

Examples

Store a display's EDID under a name
edid create LG_4K_Reference 00ffffffffffff00...

Apply a stored EDID to two sources
edid upload LG_4K_Reference bluray_player,media_pc

Return value

edid list
{
  "status": "SUCCESS",
  "request_id": null,
  "result": {
    "edids": [
      {
        "EdidId": 7,
        "name": "EDID1",
        "value": "<EDID_HEX_VALUE>",
        "CreationDate": "2023-05-03T03:06:37.0928108Z",
        "LastEditDate": "2023-05-03T03:06:37.0928108Z",
        "CreatedBy": "DNAdmin",
        "LastEditedBy": "DNAdmin"
      }
    ]
  },
  "error": null
}

Notifications

create, update, rename, and delete broadcast the whole library to every connected client, in the same edids shape edid list returns. A client can replace its cached list with the notification's contents rather than reconciling a change.

REST API

Endpoint type	DisplayNet API command
Address	`POST /api/displaynet/<operation>`, or name the operation in the body of a `POST /api/displaynet`. See Sending commands.
Role	`User`

Subcommand	Operation	Parameters
`create`	`edid_create`	`name` `value`
`delete`	`edid_delete`	`name`
`list`	`edid_list`	—
`rename`	`edid_rename`	`name` `new_name`
`update`	`edid_update`	`name` `value`
`upload`	`edid_upload`	`edid` `device`

Usage​

Subcommands​

Arguments​

Examples​

Return value​

Notifications​

REST API​

See also​