Get Setting (G) command

Top  Previous  Next

 

Description (see command description format info here)

 

Function:Gets (reads) new setting value

 

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

 

Command format:Sss, where ss is the setting name

 

Possible replies:Avv...v, D, C, F, where vv...v is current setting value

 

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

 

See also:---

 


Details

 

Get Setting command reads out current value of the selected setting. ss is the setting mnemonic, i.e. "IP" for the IP-address (IP) setting.

 

Example: to read current IP-address issue the following command**:

 

-->DS:        GIP

DS-->:        A192.168.100.40

 

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 Get 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 is invalid. Failed (F) reply code is returned if the DS fails to read out the setting value, setting value is not valid, or if the data is found to be corrupted***. This may indicate a hardware malfunction (EEPROM failure).

 

Invalid setting can be repaired using the Set Setting (S) command or (recommended) using the Initialize (I) command or quick initialization (this will initialize all other invalid settings).

 

 

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

 

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

 

*** Each setting's data is protected by an individual checksum.