CAPÍTULO III. Estado de la cuestión.
3.4 Evolución hacia un tema de la agenda política
3.4.5 El Comisionado del Gobierno apuesta por la igualdad de oportunidades
Function
TDM_CONTROL_STATUS_REPORT
Library TDM.LIB
Function symbol
Purpose The function activates or deactivates the automatic status report of the tdm R 360.
Parameters Function inputs
Function outputs, none
Description The status report provides the application software with all relevant unit information:
• currently displayed picture
• currently displayed message
• keyboard status (which key has been pressed or released)
• LED is set or not set
• unit status (e.g. preset value entry active)
TDM_CONTROL_STATUS_REPORT activates the automatic status report. Each change of the above points is transferred to the controller.
The current status can be evaluated with TDM_REPORT_STATUS and TDM_REPORT_KEYDATA. The function has to be called only once for switching on or switching off. The execution of the function can then be blocked via the input ENABLE. It is, however, useful to call the functions in certain intervals (e.g. every 500 ms) when TDM_CONTROL_STATUS_REPORT is active. That way it is prevented that the monitoring of the unit status does not work e.g. after a failure of the tdm power supply.
Name Data type Description
ENABLE BOOL TRUE: function is executed FALSE: function is not executed ON BOOL TRUE: automatic status report is
switched on
FALSE: automatic status report is switched off
Function
TDM_REQUEST_STATUS
Library TDM.LIB
Function symbol
Purpose The function requests the current status report of the tdm R 360.
Parameters Function input
Function outputs, none
Description The status report provides the application software with all the relevant unit information:
• currently displayed picture
• currently displayed message
• keyboard status (which key has been pressed or released)
• LED is set or not set
• unit status (e.g. preset value entry active)
• status of the signal output (not CR1000)
TDM_REQUEST_STATUS requests a one-time status report from the display. MODE defines which data are to be polled. Like a one-shot display the status of the above points is transferred to the controller.
Name Data type Description
ENABLE BOOL TRUE: function is executed FALSE: function is not executed
MODE BYTE value for selecting the feedback parameters
Value Output via Description
0 TDM_REPORT_STATUS unit status
1 TDM_REPORT_KEYDATA keyboard status (keys 1-32) 2 TDM_REPORT_KEYDATA keyboard status (keys 33-64) 3 TDM_REPORT_KEYDATA LED status (keys 1-32) 4 TDM_REPORT_KEYDATA LED status (keys 33-64)
Function
TDM_REPORT_STATUS
Library TDM.LIB
Function symbol
Purpose The function shows the current status report of the tdm R 360.
Parameters Function inputs
Function outputs
Description The function TDM_REPORT_STATUS is called cyclically. Apart from the current picture and message number the status of the keys and the unit are displayed.
For the individual values please refer to the tdm R 360 manual The keyboard bits are generally converted into decimal figures. The unit status is displayed directly as a decimal value.
Name Data type Description
ENABLE BOOL TRUE: function is executed FALSE: function is not executed
RESET BOOL TRUE: sets output RECEIVED to FALSE
Name Data type Description
RECEIVED BOOL TRUE: new data received FALSE: no new data received PICTURE-
NUMBER
WORD number of the current picture MESSAGE-
NUMBER
WORD number of the current message KEYSTATUS BYTE keyboard status
DEVICE- STATUS
Function
TDM_REPORT_KEYDATA
Library TDM.LIB
Function symbol
Purpose The function shows the current keyboard status of the tdm R 360.
Parameters Function input
Function outputs
Name Data type Description
ENABLE BOOL TRUE: function is executed FALSE: function is not executed RESET BOOL TRUE: sets output RECEIVED to
FALSE
Name Data type Description
RECEIVED BOOL TRUE: new data received FALSE: no new data received CTRL BYTE control parameters for keys and LED
polling
NUMBER BYTE only for CTRL = 0, contains key number and status
TA0TA4 BYTE for CTRL = 0 ... 4, status bytes of keys or LEDs (bit-oriented)
TA1TA5 BYTE for CTRL = 0 ... 4, status bytes of keys or LEDs (bit-oriented)
TA2TA6 BYTE for CTRL = 0 ... 4, status bytes of keys or LEDs (bit-oriented)
TA3TA7 BYTE for CTRL = 0...4, status bytes of keys or LEDs (bit-oriented)
Description The function TDM_REPORT_KEYDATA can be polled cyclically. It transfers the current key and LED status.
TA0 ... TA7 provide the key/LED status in bytes (e.g. bit- oriented). With CTRL you select the key/LED groups to be polled.
For the individual values please refer to the tdm R 360 manual. CTRL always returns the value 0 when TDM_CONTROL_STATUS_REPORT is switched on.
Function
TDM_LED
Library TDM.LIB
Function symbol
Purpose The function activates or deactivates the tdm LEDs.
Parameters Function inputs
Function outputs, none
Description The function TDM_LED can be polled cyclically. This function changes the status of the keyboard LEDs (set/reset). Depending on the defined control parameters the LEDs can be processed individually or bit-wise in groups of 8 via a mask value.
For the individual values please refer to the tdm R 360 manual.
Name Data type Description
ENABLE BOOL TRUE: function is executed FALSE: function is not executed CONTROL BYTE control parameter for setting / resetting
the LEDs
NUMBER BYTE LED mask number or individual LED number
VALUE BYTE mask value when NUMBER = LED mask number
Function
TDM_SINGLE_LED_ON_OFF
Library TDM.LIB
Function symbol
Purpose The function activates or deactivates a single tdm LED.
Parameters Function inputs
Function outputs, none
Description TDM_SINGLE_LED_ON_OFF can switch an individual LED on (ON=TRUE) or off (ON=FALSE).
As opposed to the function TDM_LED, TDM_SINGLE_LED_ON_OFF can be set permanently. The corresponding CAN command is only transferred once within the function thus preventing an excess workload on the CAN bus.
For the individual values please refer to the tdm R 360 manual.
Name Data type Description
ENABLE BOOL TRUE: function is executed FALSE: function is not executed ON BOOL TRUE: LED switched on
FALSE: LED switched off NUMBER BYTE individual LED number