7.39. Sterownik setdmn

• Zgodność ze specyfikacją: 4 .

• Obsługiwane urządzenia: TCP client, for example SZARP 'setter' program.

• Protokół komunikacji: Daemon uses telnet-like protocol to allow setting values of handled parameters by network client, especially 'setter' program. On first connection, client gets list of handled parameters with their current values and allowed min/max values, one parameter per line in format:

  "parameter name" [current] [min] [max]

  Client can set value of parameter with command:

  "parameter name" [new_value]

  If value of parameter is changed, all connected clients gets refreshed info about parameter (in format like after first connect). Server can also set error info, one of strings:

  :E_MIN if new value is less then allowed minimum

  :E_MAX if new value is grater then allowed maximum

  :E_NOTALLOWED if client is not allowed to connect (based on client IP)

  :E_OTHER for other unspecified server error

  Error info string can be followed by optional message, that should be presented to user.

• Initial parameter values are read from SZARP database (last assessible values are used).

• Przykładowa konfiguracja:

  <device daemon="/opt/szarp/bin/setdmn" xmlns:extra="http://www.praterm.com.pl/SZARP/ipk-extra"
  	path="/dev/null"
  	extra:tcp-port="8010" 		<!-- TCP port to listen on -->
  	extra:tcp-allowed="192.168.1.2"	<!-- list of allowed IP addresses, delimited with spaces -->
  	>
  	<unit id="1" type="1" subtype="1" bufsize="1">
  		<param name="Some:Setable:Parameter" ...
  			extra:min="0"		<!-- minimum allowed value -->
  			extra:max="27.8"	<!-- maximum allowed value -->
  		> ... </param>
  	</unit>
  </device>