sat-nms IO-FEP2 User Manual

4.2 Parameter list

The table below shows the complete list of M&C parameters the IO-FEP2 knows. For each parameter the valid range and a short description is given. The list applies to the HTTP and RS232 remote interfaces and in some way also to the SNMP interface as the latter uses OIDs which resemble these parameters one by one.

name		description
time	r/o	Delivers date / time, format YYY-MM-DD HH:MM:SS
stim	r/w	Sets date / time, format YYY-MM-DD HH:MM:SS
sver	r/o	Software version
srno	r/o	Device serial no
caps	r/o	Software capabilities, coded as bits in a decimal number:
		2^0 = IO-FEP-E version
		2^1 = protection / redundancy switching installed
		2^2 = power supply monitoring installed
		2^3 = NTP time synchronization installed
tmp0	r/o	Board temperature (°C)
tmp1	r/o	Temperature sensor 1 (°C)
tmp2	r/o	Temperature sensor 2 (°C)
tmp3	r/o	Temperature sensor 3 (°C)
tmp4	r/o	Temperature sensor 4 (°C)
outp	r/w	Digital outputs
wgsw	r/w	Waveguide switch actuation
prsw	r/w	Protection switch monitoring and control
stat	r/o	I/O state
psua	r/o	Power supply alarms (4 digits 0/1 for 24V, 24VEXT, 24V-RED and 24VEXT-RED) 0 states OK, 1 states fault
tsya	r/o	Time synchronisation alarm, 0 = NTP sync OK or disabled, 1 = NTP sync failed, 2 = NTP1 sync failed, but NTP2 sync was successful.
lsyn	r/o	Delivers a text describing the date/time and source of the recent clock synchronisation
lnas	r/o	Delivers a string containing the voltage and current readings of all 6 LNA power supply monitoring units. The readings are ordered 'voltage 1' 'current 1' .. 'voltage 6' 'current 6'. Voltages are in V, currents in mA. Values are separated by one space character.
lnaa	r/o	Delivers a string 6 characters long which reports the LNA power supply monitoring alarms. Each character may be either '0' (OK) or '1' (Alarm), the first character refers to the LNA 1 power supply monitoring unit.

I/O state monitoring

The command 'stat=?' returns a 32 character string which contains the complete I/O state of the IO-FEP2, coded in 5 hexadecimal numbers. Example:

   000000000010 0400 00000006 00 00
             |   |          |  |  |
             |   |          |  |  no hi temperature faults
             |   |          |  no low temperature faults
             |   |          S01=B, S02=A
             |   Output 11 is ON
             Input 5 is on

Inputs --- The first number (12 characters, 48 bits) reports the state of the IO-FEP2 input circuits. Each bit of the hexadecimal number corresponds to one input. The least significant bit corresponds to input 1. A bit set to '1' reports an 'ON' or 'FLT' input, inputs which are 'OK' or 'OFF' read '0'. The reported port states are logical states, they already include the polarity inversion and filtering delay as defined in the setup for each individual port. Unused ports always read '0'.
Outputs --- The second number (4 characters, 16 bits) reports the actual state of the output ports in a similar way. The contents of this is exactly the same as the reply to 'outp=?': bit 0 corresponds to the state of PhotoMOS output 1, bit 15 to the state of the relay 6. A bit set to 1 tells that the output is 'ON' as displayed at the user interface. A software polling the 'stat=?' variable frequently may parse the output state from here rather from 'outp=?', thus saving some protocol overhead.
WG Switch Positions --- The third number (8 characters, 32 bits) reports the actual wave guide switch position. Each switch encodes it's state in two bits of the number, WG switch 1 uses the least significant bits. The bits reflect the state of the position indication circuits of each switch: '01' tells that the switch is in position 'A', '10' signals position 'B'. The bit combinations '00' and '11' both signal invalid states, a software monitoring the IO-FEP2 should decode this and report it to the operator. The switch positions reported here are pre-processed by the IO-FEP2, not the raw position indication readings. If a switch is commanded to position 'X', this position is reported immediately, even if the switch did not yet reach this position. After the switch process has completed (or timed out) the real position is reported. This behaviour nis necessary to hide the delayed / queued switching performed by the IO-FEP2 from a M&C computer which expectes the IO-FEP2 to be a 'dumb PLC'. Unused waveguide switches always report '00'
Temperature Faults --- The words 4 (low temperature faults) and 5 (high temperature faults) encode the limit faults for the temperature sensors of the IO-FEP2. The least significant bit corresponds to the internal board temperature sensor, bit 1 to the external temperature sensor 1 and so on.

Waveguide switch actuation

The command 'wgsw=xxxxxxxx' actuates one or more waveguide switches. Switch positions are coded the same way as in the 'stat=?' reply described above: two bits for each switch, the least significant two bits for switch 1. A bit combination '01' commands position 'A', '10' commands position 'B'. The combinations '00' and '11' are ignored, the switch position remains unchanged. If multiple switch movements are commanded at the same time, the switches move contemporaneously unless the number of parallel switch actuations has been limited in the setup.

A computer controlling the IO-FEP2 may use the 'wgsw' command like it would control the actuation motors directly: switching on a motor and switching it off a few hundred milliseconds later. This is for compatibility with software that expects a dumb switching unit to control the waveguide switches. In fact there are no timing constraints with the 'wgsw', the IO-FEP2 control the actuation timing off the switches internally.

Output control

The command 'outp=?' returns a 4 digit, 16 bit hexadecimal number showing the actual state of all outputs of the IO-FEP2. Bit 0 corresponds to the state of PhotoMOS output 1, bit 15 to the state of the relay 6. A bit set to 1 tells that the output is 'ON' as displayed at the user interface.

Writing a 'outp=xxxx' sets all outputs of the IO-FEP2. To set or clear a single output, you have to read the actual state, set/clear the appropriate bit and send the number back to the IO-FEP2.

Outputs which are not configured as type 'OUTPUT' always read '0'. Setting these outputs has no effect, the IO-FEP2 silently ignores commands to outputs which are not configured to act as a general purpose output.

Protection switch control

The command 'prsw=?' returns a 32 digit hexadecimal string showing the state of up to 16 protection switch units in the IO-FEP2. The bit positions 0..7 (the rightmost two digits) refer to protection switch #1, bits 8..15 to protection switch #2 and so on. The status bit definitions for one protection switch are as follows:

0 (lsb) --- 1 = WG-Switch fault or instance not configured
1 --- 0 = 1:1-SW-ONCE, 1 = 1:1-SW-ALWAYS
2 --- 0 = DISABLED, 1 = ENABLED
3 --- 0 = 1:1, 1 = 2:1 redundancy (bit 1 doesn't care in this case)
4 --- 1 = fault in chain A
5 --- 1 = fault in chain B
6 --- 1 = SWITCHED
7 (msb) --- 0 = chain A selected, 1 = chain B selected

The same parameter is used to send commands to a protection switch unit in the IO-FEP2. The format is different to the status report described above. One command changes one parameter of a particular protection switch:

prsw= xy applies the command x (a one digit number 1..8) to the switch y (1..16). The command codes for x are defined as follows:

1 --- Set the protection switch to UNUSED
2 --- Set the protection switch to 1:1-SW-ONCE
3 --- Set the protection switch to 1:1-SW-ALWAYS
4 --- Set the protection switch to DISABLED
5 --- Set the protection switch to ENABLED
6 --- Set the protection switch to position A
7 --- Set the protection switch to position B
8 --- Reset the SWITCHED flag of the protection switch
9 --- Set the protection switch to SW-2TO1

Example: 'prsw=312' sets the protection 12 switch to SW-ALWAYS.

For 2:1 protection switches, you have to command the position of both switches involved in order to set the redundant chain destination to CHAIN-A (B/A), CHAIN-B (A/B) or none (A/A).