This page describes the device driver and the device window for the TLE-Updater logical device. This device complements the Pass-Scheduler device and reads on request the newest of a set of TLE files, parses this and commands the two TLE lines to an antenna controller device. The device also moves outdated TLE files to an archive directory.
When receiving a "take" command, the device starts to do the following steps. If there occurs a fault in this procedure, the device sets a fault flag indicating this fault and aborts the procedure after the faulty step.
If the procedure failed, the the device shows a fault and the state.* parameters are set to intermediate values which correspond to the procedure step up to which the procedure succeeded.
A "reset" command ("CLR FAULTS" button) may be issued to reset faults and state.* parameters. This is for convenience only, a "reset" is not required as the devices does this anyhow when it starts the procedure the next time with the next "take" command.
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 all relevant parameters of the device, permits to set the satelliteId and to trigger a "take" manually for testing purposes.
--- 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 integrate the device into the VLC/M&C.
| parameter | description |
|---|---|
| nameId | The ID of the parameter where to set the satellite name which has been read from the TLE file at the antenna controller. |
| line1Id | The ID wehre to set the first TLE line at the antenna controller. |
| line2Id | The ID where to set the second TLE line at the antenna controller. |
| takeId | The ID of the antenna controller parameter which must be set in order to make the controller "take" the values above. |
| takeVal | The value which has to be sent with the takeId . |
| tleDir | The directory which gets scanned for TLE files. The directory may be defined as a path relative to the M&C's working directory or as an absolute path starting with a "/" character. |
| archiveDir | The directory where outdated TLE files are moved to. The directory may be defined as a path relative to the M&C's working directory or as an absolute path starting with a "/" character. Please note, this directory must be at the same physical drive as the tleDir because a "rename" command is used to move the files, this does not work over separate drives. |
Variables defined by this device driver
| name | type | flags | range |
|---|---|---|---|
| info.driver | TEXT | R/O | StringRange R/O |
| info.type | TEXT | R/O | StringRange R/O |
| info.frame | TEXT | R/O | StringRange R/O |
| config.nameId | TEXT | SAVE SETUP | StringRange |
| config.line1Id | TEXT | SAVE SETUP | StringRange |
| config.line2Id | TEXT | SAVE SETUP | StringRange |
| config.takeId | TEXT | SAVE SETUP | StringRange |
| config.takeVal | TEXT | SAVE SETUP | StringRange |
| config.tleDir | TEXT | SAVE SETUP | StringRange |
| config.archiveDir | TEXT | SAVE SETUP | StringRange |
| take | TEXT | NOPRESET | StringRange |
| reset | TEXT | NOPRESET | StringRange |
| satelliteId | TEXT | SAVE | StringRange |
| state.name | TEXT | R/O | StringRange R/O |
| state.line1 | TEXT | R/O | StringRange R/O |
| state.line2 | TEXT | R/O | StringRange R/O |
| state.filename | TEXT | R/O | StringRange R/O |
| faults.01 | ALARM | R/O | AlarmFlagRange R/O (No satellite ID) |
| faults.02 | ALARM | R/O | AlarmFlagRange R/O (No TLE file) |
| faults.03 | ALARM | R/O | AlarmFlagRange R/O (Invalid input dir) |
| faults.04 | ALARM | R/O | AlarmFlagRange R/O (Invalid output dir) |
| faults.05 | ALARM | R/O | AlarmFlagRange R/O (Invalid TLE format) |