dmi_acer_hotkeys

Synopsis

#include <opendmi/entity/acer/hotkeys.h>

typedef struct dmi_acer_hotkeys {
    uint16_t comm_functions;
    uint16_t app_functions;
    uint16_t media_functions;
    uint16_t display_functions;
    uint16_t other_functions;
    uint8_t comm_key;
    size_t hotkey_count;
    dmi_acer_hotkey_entry_t *hotkeys;
} dmi_acer_hotkeys_t;

Description

The dmi_acer_hotkeys_t structure holds the decoded Acer hotkey functions (type 170), which tell the functions of the hotkeys of a laptop the Acer WMI driver reads. Some laptops of other brands, e.g. Fujitsu-Siemens, Medion, Lenovo and eMachines, are said to carry it too.

The structure is returned by dmi_entity_info for the structures decoded by dmi_acer_hotkeys_spec, of type DMI_TYPE(acer_hotkeys), declared in <opendmi/module/acer.h>, once the Acer extension module (dmi_acer_module) is enabled. It lives as long as the context it has been decoded in. The module is enabled for the platforms whose firmware or system vendor is Acer, since Acer laptops carry the firmware of other vendors, e.g. Insyde.

The hotkeys follow the function bitmaps up to the end of the structure. Their key numbers tell the button group by the high bits, and the functions of the keys of a group add up to its bitmap. The first key is the one of the communication function, the only one the Acer WMI driver reads.

Fields

comm_functions

Functions of the communication button, whose bits are the values of dmi_acer_comm_function_t: bit 0 WiFi, bit 6 3G, bit 7 WiMAX, bit 11 Bluetooth and bit 14 radio button.

app_functions

Functions of the application button.

media_functions

Functions of the media button.

display_functions

Functions of the display button.

other_functions

Functions of the other buttons.

comm_key

Number of the key of the communication function, at offset 0x0E, where the structures holding hotkeys begin the first of them. Structures of 0x0F bytes end with it and hold no hotkeys, the way the Acer WMI driver reads them, and are decoded by dmi_acer_hotkeys_basic_spec into the same structure.

hotkey_count

Number of the hotkeys.

hotkeys

Hotkeys, see dmi_acer_hotkey_entry. May be nullptr when hotkey_count is 0.

See also

dmi_entity_info, dmi_acer_hotkey_entry

Standards

Not part of the SMBIOS specification. Defined by Acer firmware, as the Acer WMI driver of Linux and dmidecode describe it. The hotkeys past the function bitmaps are reverse engineered from the data corpus.