Set Setting (S) command

Top  Previous  Next

 

Description (see command description format info here)

 

Function:Sets (writes) new setting value

 

Can be issued through:Network (broadcasts ignored*, login required); serial port

 

Command format:Sssvv...v, where ss: setting mnemonic, vv...v: new setting value

 

Possible replies:A, D, C, F

 

First introduced:Earlier than "baseline" V3.14/V3.51

 

See also:Get Setting (G) command

 


Details

 

Set Setting command assigns new values to the selected setting. ss is the setting mnemonic, i.e. "IP" for the IP-address (IP) setting.

 

Example: to set IP-address to 192.168.100.40 issue the following command**:

 

-->DS:        SIP192.168.100.40

DS-->:        A

 

When issued through the network, this command requires prior login using the Login (L) command (programming session must be opened). Denied (D) reply code is returned if the programming session is not in progress or if it doesn't belong to the sender of the Set Setting command- the DS remembers the IP-address of the network host that opens the programming session and requires that all subsequent commands (that require prior login) are sent from the same IP.

 

Error (C) reply code is returned if the setting mnemonic and/or supplied setting value is/are invalid. Failed (F) reply code is returned if the DS fails to write new setting value. This usually indicates a hardware malfunction (EEPROM failure).

 

* Without prior selection using Select In Broadcast Mode (W) command.

 

** Encapsulation characters such as IEC, STX, CR are not shown.