This page describes the device driver and the device window for the SatService-IO-FEP device. This device monitors and controls the SatService IO-FEP controller.
The SatService-IO-FEP device driver is part of the sat-nms framework for M&C of plain digital I/O functions. Monitoring alarm circuits or controlling waveguide switches are indicatives for applications of this framework.
The application configuration normally does not access the SatService-IO-FEP device driver directly (except to access the temperature readings). There are a couple of application level logical devices (e.g. Input , Output or WG-Switch ) which may use the SatService-IO-FEP device driver as a low level driver to access the physical I/O ports.
Input ports
The variables 'inputs.0', 'inputs.1' and 'inputs.2' refer to the input ports 1..16, 17..32 and 33..48 respectively. The least significant bit in a variable reports the state of the lowest numbered port in it's group.
The variables report the logical state if the input. A bit set to '1' denotes an 'ON' or 'FLT' state, '0' stands for 'OFF' or 'OK'. The reported input states respect the 'delay' and 'invert' settings configured in the IO-FEP for each individual port.
Unused ports always report a '0', the same applies to the input ports 33..48 if the IO-FEP has no extension board installed.
Output ports
The variable 'outputs' reports the actual state of the digital outputs and also sets the output states. The least significant bit in the variable corresponds to output 1, the most significant bit to output 16. The port states respect the 'invert' setting configured for each individual port in the IO-FEP.
Unused ports and ports which are configured in the IO-FEP as HPA muting outputs always report the state '0'. Writing to these ports will be ignored.
Waveguide switches
The variable 'wgstat' reports the actual state of the waveguide switches. For each waveguide switch there are 2 bits, indicating the position of the switch. '01' denotes position 'A', '10' denotes position 'B'. The bit combinations '00' and '11' both indicate a fault. This similar to the way, the physical position indicators of a waveguide switch are working. However, the bits reflect a logical state in the IO-FEP rather than the physical state of the position indicators. This is because the IO-FEP hides it's internal queuing mechanism for switch actuation's from the controlling M&C.
The variable 'wgcmd' is the complement to 'wgstat' for actuating the switches. In the software the bits of this variable are treated like output ports which perform the switch motor actuation. In fact, the IO-FEP monitors 0 to 1 transitions of each bit and performs the switch actuation accordingly. The actuation pulse duration is controlled by the IO-FEP, not by the sat-nms software. Nevertheless, the IO-FEP waveguide switch interface is fully compatible to the WG-Switch logical device.
Switches configured in the IO-FEP as 'unused' always report the position '00'. The same applies to the switches 9..16 if no extension board is installed in the IO-FEP.
PSU fault monitoring
The IO-FEP "E" version, together with firmware versions beginning from January 2013, monitors the presence of power supply voltages. The sat-nms device driver reports these PSU fault flags as 'faults.11' to 'faults.14'. With IO-FEP versions that do not support PSU monitoring, these fault flags remain unset / uninitialized.
The PSU monitoring for the redundant supply voltages may be masked in the IO-FEPs setup. The IO-FEP reports always them as OK in this case.
Configuration settings
If used with the sat-nms framework for M&C of plain digital I/O functions, the SatService IO-FEP acts like an unprogrammed PLC device. It is intended, that the device driver processes switch settings and changes of input circuits as fast as possible. The following settings are necessary to achieve this:
Device window pages
The following table shows which device window pages are available with this individual device type. Tool-bar functions not mentioned here are described at the general description of device windows .
--- Shows / commands I/O port states.
--- Shows the temperature readings
--- The faults page.
--- The device info page.
--- The maintenance page. The configuration parameters described below are set at this page.Configuration parameters
At the maintenance page of the device window there are a couple of configuration parameters which must be set to make the software talk to the device.
parameter --- description
address --- The SNMP address specification for the device. The full address specification consists of the following fields:aaa.bbb.ccc.ddd:pppp read-community write-community
retries --- The number of communication retries which are made at application level. For use with the sat-nms framework for M&C of plain digital I/O functions this parameter must be set to 0.
snmpTimeout --- The timeout value used by the SNMP protocol implementation. The default value is 5 seconds. For use with the sat-nms framework for M&C of plain digital I/O functions this parameter must be set to 200 msec.
snmpRetries --- The the number of retries used by the SNMP protocol implementation. The default value is 2 retries.
swCtrlFaultSrc --- Defines in which way the driver evaluates the switch control fault flag (faults.17). This fault flag tells that the IO-FEP actually is not capable to control switches or to report input signals correctly.
Variables defined by this device driver
| name | type | flags | range |
|---|---|---|---|
| info.driver | TEXT | R/O | StringRange R/O |
| lowLevel.cmd | TEXT | StringRange | |
| lowLevel.reply | TEXT | R/O | StringRange R/O |
| faults.99 | ALARM | R/O | AlarmFlagRange R/O (Communication) |
| faults.commstat | TEXT | R/O | StringRange R/O |
| info.type | TEXT | R/O | StringRange R/O |
| info.port | TEXT | R/O | StringRange R/O |
| info.frame | TEXT | R/O | StringRange R/O |
| info.serialno | TEXT | R/O | StringRange R/O |
| info.version | TEXT | R/O | StringRange R/O |
| info.extensionBoard | TEXT | R/O | StringRange R/O |
| info.psuMonitoring | BOOLEAN | R/O | BooleanRange R/O (true false) |
| info.ntpSyncSupport | BOOLEAN | R/O | BooleanRange R/O (true false) |
| snmpTimeout | INTEGER | SETUP | IntegerRange (1 .. 100000) |
| snmpRetries | INTEGER | SETUP | IntegerRange (0 .. 10) |
| config.swCtrlFaultSrc | CHOICE | SAVE SETUP | EnumRange (COMM COMM+PSU1 COMM+PSU1+PSU2) |
| internal.caps | INTEGER | R/O | IntegerRange R/O (0 .. 0) |
| internal.dummy | TEXT | R/O | StringRange R/O |
| internal.ltmp | HEX | R/O | HexRange R/O (0 .. 0) |
| internal.htmp | HEX | R/O | HexRange R/O (0 .. 0) |
| internal.ntp | INTEGER | R/O | IntegerRange R/O (0 .. 0) |
| inputs.0 | HEX | R/O | HexRange R/O (0 .. 0) |
| inputs.1 | HEX | R/O | HexRange R/O (0 .. 0) |
| inputs.2 | HEX | R/O | HexRange R/O (0 .. 0) |
| outputs | HEX | HexRange (0 .. 0) | |
| wgstat | HEX | R/O | HexRange R/O (0 .. 0) |
| wgcmd | HEX | HexRange (0 .. 0) | |
| temperature.0 | FLOAT | R/O | DoubleRange R/O (0.0 .. 0.0) |
| temperature.1 | FLOAT | R/O | DoubleRange R/O (0.0 .. 0.0) |
| temperature.2 | FLOAT | R/O | DoubleRange R/O (0.0 .. 0.0) |
| temperature.3 | FLOAT | R/O | DoubleRange R/O (0.0 .. 0.0) |
| temperature.4 | FLOAT | R/O | DoubleRange R/O (0.0 .. 0.0) |
| initialized | TEXT | R/O | StringRange R/O |
| faults.01 | ALARM | R/O | AlarmFlagRange R/O (Board temperature LOW) |
| faults.02 | ALARM | R/O | AlarmFlagRange R/O (Board temperature HIGH) |
| faults.03 | ALARM | R/O | AlarmFlagRange R/O (Temperature 1 LOW) |
| faults.04 | ALARM | R/O | AlarmFlagRange R/O (Temperature 1 HIGH) |
| faults.05 | ALARM | R/O | AlarmFlagRange R/O (Temperature 2 LOW) |
| faults.06 | ALARM | R/O | AlarmFlagRange R/O (Temperature 2 HIGH) |
| faults.07 | ALARM | R/O | AlarmFlagRange R/O (Temperature 3 LOW) |
| faults.08 | ALARM | R/O | AlarmFlagRange R/O (Temperature 3 HIGH) |
| faults.09 | ALARM | R/O | AlarmFlagRange R/O (Temperature 4 LOW) |
| faults.10 | ALARM | R/O | AlarmFlagRange R/O (Temperature 4 HIGH) |
| faults.11 | ALARM | R/O | AlarmFlagRange R/O (PSU 24V DC) |
| faults.12 | ALARM | R/O | AlarmFlagRange R/O (PSU 24V EXT) |
| faults.13 | ALARM | R/O | AlarmFlagRange R/O (PSU 24V DC RED.) |
| faults.14 | ALARM | R/O | AlarmFlagRange R/O (PSU 24V EXT RED.) |
| faults.15 | ALARM | R/O | AlarmFlagRange R/O (NTP sync) |
| faults.16 | ALARM | R/O | AlarmFlagRange R/O (Primary NTP server) |
| faults.17 | ALARM | R/O | AlarmFlagRange R/O (Switch control) |