Network Properties [net]

This request sets various Network properties.

URL:

/set.cgi?dst=net&<optional-parameters>

Optional Parameters:

  • name=<string> (optional)
    • This parameter (if present) sets the device’s name.
    • Maximum length of this string is 15 characters.

  • ipA=<ipAddress> (optional)
    • This parameter (if present) sets the device’s primary IP Address.

  • subA=<ipAddress> (optional)
    • This parameter (if present) sets the device’s primary subnet mask.

  • dhcpA=<0,1> (optional)
    • This parameter (if present) sets the device’s primary DHCP Mode.
    • This parameter may be set to 0 or 1.

  • ipB=<ipAddress> (optional)
    • This parameter (if present) sets the device’s secondary IP Address.
    • This parameter is of no use on a device with a single Ethernet port.

  • subB=<ipAddress> (optional)
    • This parameter (if present) sets the device’s secondary subnet mask.
    • This parameter is of no use on a device with a single Ethernet port.

  • dhcpB=<0,1> (optional)
    • This parameter (if present) sets the device’s secondary DHCP Mode.
    • This parameter may be set to 0 or 1.
    • This parameter is of no use on a device with a single Ethernet port.

  • gateway=<ipAddress> (optional)
    • This parameter (if present) sets the device’s gateway address.

  • interfaces=<1,2> (optional)
    • This parameter (if present) sets the device’s number of interfaces.
    • A setting of 1 puts the device into a mode where each physical port is connected to a built-in switch connected to a single interface.
    • A setting of 2 puts the device into a mode where each of the two physical ports become their own separate interfaces, each with their own IP addresses.
    • This parameter has no effect on a device with a single Ethernet port.

Response:

A single byte is returned. The following table explains the possible return values.

Result Description
0x00 The operation was successful.
0xFF The network interfaces file could not be read.

Examples:

Function URL
Set the device name to “My CueServer” /set.cgi?dst=net&name=My+CueServer
Set the primary IP parameters /set.cgi?dst=net&ipA=10.0.1.5&subA=255.0.0.0&dhcpA=0