Control and integration

IP control

Telnet control over the network

Anything the web server can change can also be changed by opening a socket to the Diva and sending a line of text. The syntax is the RS232 syntax with the header removed.

IP control means driving a device over the network with a plain text command protocol, usually over a raw TCP socket that behaves much like telnet. There is no session to maintain and no state to keep: you connect, send a line, and read a line back. Control systems prefer it because the network cable is already in the rack, one processor can reach many devices at once, and there is no baud rate or wiring polarity to get wrong.

The trade is that you have to know the address and the port, and a device that loses its address disappears completely. That is why controllable equipment almost always ships with DHCP switched on and takes a static address only when someone chooses one deliberately.

IP control on the HDfury Diva

An Ethernet cable between the LAN CONTROL RJ45 connector and your router or switch is mandatory, since there is no wireless route in. By default the Diva takes an address by DHCP and shows it on the default OLED page, with the hostname and the mDNS name on the LAN INFO page. The control port is set in the CONFIG section under IP PORT, with 2210 as the default, so a session opens to something like 192.168.1.100:2210. A change to the address or the port applies only after a reboot or power cycle.

The command syntax is the RS232 syntax minus the header. Over RS232 every command begins with #diva; over IP that header is dropped. There are two generic forms, set target value to write and get target to read, all in lowercase, ending in a carriage return or a newline. Every reply the Diva sends has both a carriage return and a newline appended, so a parser can rely on a consistent line ending.

set inseltx0 1

Routes input 1 to the TX0 output and leaves TX1 as it is. Values 0 to 3 select an input, and 4 sets that output to follow the other one.

set dhcp off

Switches the unit to the static configuration held in ipaddr, ipmask and ipgw.

set tcpport x

Changes the port the unit listens on for control. A reboot is required before it takes effect.

set reboot

Restarts the unit without clearing any settings.

All glossary terms