Tastenanzahl Lesen; Listing 63: Getkeycount - Tastenanzahl Lesen - B&R APC910 Implementierungsanleitung

APC910 / PPC900
Implementierungsanleitung

7.13.1 Tastenanzahl lesen

Die Anzahl der unterstützen Tasten eines Panels kann durch Lesen des Panel Specials Register des
MTCX (siehe Seite 52) ermittelt werden.
Information:
Derzeit wird technisch bedingt von allen B&R Geräten, die Tasten unterstützen können, die An-
zahl der Tasten mit 128 gemeldet. Davon kann aber nicht abgeleitet werden, dass auf dem Gerät
wirklich 128 Tasten vorhanden sind. Es können auch weniger oder sogar keine Tasten vorhanden
sein. Nur wenn Tastenanzahl 0 gelesen wird, kann davon ausgegangen werden, dass das Gerät
keine Tasten unterstützt.
Das folgende C Codebeispiel zeigt, wie die Anzahl der unterstützten Tasten gelesen werden kann.
Aus Performancegründen wird nur das höherwertigste Byte des Panel Specials Register gelesen.
// Get supported key count of a panel.
//
// Parameters
// PanelNumber
// [in] Specifies the panel number: 0 to 15.
// KeyCount
// [out] Points to variable that receives the
// maximum number of supported matrix keys: 0 to 128.
//
// Return 0 at success and -1 at failure.
int GetKeyCount(unsigned int PanelNumber, unsigned char *KeyCount)
{
int retvalue;
// TODO: acquire synchronization object for panel data here
retvalue = MtcxSwitchToLinkedPanel(PanelNumber);
if (retvalue == MTCX_OKAY)
*KeyCount = READ_PORT_UCHAR(MTCX_PANEL_SPECIALS_ADDR + 2); // read byte 2 only
// TODO: release synchronization object for panel data here
if (retvalue != MTCX_OKAY)
{
// TODO: add your error handling here
return -1;
}
return 0;
}
Listing 63: GetKeyCount – Tastenanzahl lesen
Die verwendeten Definitionen finden Sie auf Seite 59.
Die aufgerufene Funktion MtcxSwitchToLinkedPanel finden Sie auf Seite 68.
Copyright © B&R - Änderungen vorbehalten
APC910_PPC900_Implementierungsanleitung_V2_00.docx
Codebeispiele
17.01.14
128/165