Implementierungshandbuch für die Tastatur-Hintergrundbeleuchtung

In diesem Dokument wird die Protokollimplementierung für die Integration der Backlight-Steuerung von Tastaturgeräten erläutert, die mit einem kompatiblen Windows 11-Host verbunden sind. Dies umfasst keine Anleitungen zu mechanischen Einschränkungen, elektrischen Einschränkungen oder komponentenauswahl für die Hardware des Tastaturgeräts.

In diesem Handbuch werden nur einfache globale Tastatur-Backlights behandelt, bei denen eine einzelne Helligkeitsstufe auf die gesamte Tastatur angewendet wird. Für Tastaturen mit zonenbasierter oder pro Taster RGB-Beleuchtung finden Sie stattdessen " Dynamische Beleuchtung ".

Unterstützung für die Integration von Tastaturhinterlights ist in Windows 11, Version 25H2, Build 26200.7922 oder höher, verfügbar.

Implementierung des Tastatur-Backlight-Protokolls

Ein gutes Verständnis des HID-Protokolls ist erforderlich, um die hier dargestellten Informationen verstehen zu können. Informationen zum HID-Protokoll finden Sie in den folgenden Ressourcen:

Anleitung zur Hintergrundbeleuchtung der Tastatur

Erforderliche HID-Sammlung

Die Funktionalität in Bezug auf die Tastaturhintergrundbeleuchtung muss in einer HID-Consumer-Tastaturhintergrundbeleuchtungssammlung (Seite 0xC, Nutzung 0x7) enthalten sein.

Eingabeschaltflächen

In der folgenden Tabelle werden die Eingabetasten des Host-Computers für die Tastaturbeleuchtungsteuerung definiert. Diese Schaltflächen sollten nicht direkt Helligkeitsupdates auf dem Gerät anwenden, sondern die Steuerungsvorgänge auf den Host zurückstellen. In vielen Fällen antwortet der Host umgehend auf eine Eingabetaste mit einem Set-Level-Bericht, wobei dieser optional basierend auf dem Helligkeitsalgorithmus des Hosts angepasst wird. Das Gerät sollte während des Wartens auf diese Antwort keine temporäre Helligkeitsänderung anwenden.

Eingabeschaltflächen werden pro Gerät angewendet und gelten nicht für andere Geräte als dasjenige, das den Bericht erstellt.

Wenn das Gerät an einen Host angeschlossen ist, der die Tastatur-Backlight-Steuerung nicht unterstützt – angezeigt durch das Fehlen eines Ausgabeberichts "Set Level" beim Start oder zur Verbindungszeit – kann das Gerät auf eine direkte lokale Helligkeitssteuerung für seine Eingabetasten zurückgreifen.

Optionale Verwendungen
Berichtsname Beschreibung Seite ID
Helligkeitserhöhung Fordert den Host auf, die Helligkeit der Hintergrundbeleuchtung um einen logischen Schritt zu erhöhen. Der Host bestimmt die Schrittgröße, die je nach logischem Bereich und aktivem Helligkeitsalgorithmus variieren kann. Es wird dringend empfohlen, dass Geräte, die Helligkeitsinkrementierung unterstützen, auch die Helligkeitsdekrementierung unterstützen sollten. 0x0C 0x0079
Helligkeitsverringerung Fordert den Host auf, die Helligkeit der Hintergrundbeleuchtung um einen logischen Schritt zu verringern. Der Host bestimmt die Schrittgröße, die je nach logischem Bereich und aktivem Helligkeitsalgorithmus variieren kann. Es wird dringend empfohlen, dass Geräte, die Helligkeitsverringerung unterstützen, auch Helligkeitsanpassung unterstützen sollten. 0x0C 0x007A
Ein/Aus-Steuerung (OOC) Fordert den Host auf, die Tastatur-Hintergrundbeleuchtung ein- oder auszuschalten. Wenn die Hintergrundbeleuchtung aktiviert wird, bestimmt der Host einen geeigneten Wert für die Helligkeit ungleich Null, der an das Gerät gesendet werden soll. Das Deaktivieren der Hintergrundbeleuchtung impliziert eine Anforderung für den Host, die Hintergrundbeleuchtung auf null Helligkeit festzulegen. 0x0C 0x007C
Auto Fordert den Host an, die automatische Helligkeitsanpassung zu aktivieren oder zu deaktivieren. 0x0C 0x007F
Minimum festlegen Fordert den Host auf, die Tastatur-Hintergrundbeleuchtung auf die minimale nicht null logische Helligkeitsstufe (in der Regel 1 Nit) festzulegen. Dies stellt die minimale Helligkeit dar, die vom Gerät unterstützt wird, ohne die Hintergrundbeleuchtung vollständig zu deaktivieren. 0x0C 0x007D
Maximale Anzahl festlegen Fordert den Host auf, die Tastatur-Hintergrundbeleuchtung auf die logische maximale Helligkeitsstufe festzulegen. 0x0C 0x007E
Nächste Ebene Der Host wird aufgefordert, die Helligkeit der Tastaturbeleuchtung auf die nächste höhere Stufe festzulegen. Wird die aktuelle Helligkeitsstufe erreicht oder überschritten, erfolgt eine Rücksetzung auf die niedrigste vorgeschlagene Stufe. Wenn der Bericht zur Funktion "Level-Vorschläge" nicht implementiert ist, wird diese Schaltfläche ignoriert. 0x0C 0x0515
Vorherige Ebene Fordert den Host auf, die Tastatur-Hintergrundbeleuchtung auf die nächstniedrigere Helligkeitsstufe festzulegen und bei Unterschreitung der niedrigsten Stufe auf die höchste Stufe zu wechseln, wenn die aktuelle Helligkeitsstufe die niedrigste erfüllt oder unterschreitet. Wenn der Featurebericht "Niveauvorschläge" nicht implementiert ist, wird diese Schaltfläche ignoriert. 0x0C 0x0516

Bericht über Pegelausgabe festlegen

Der Host sendet diesen Bericht, um die Helligkeitsstufe der Hintergrundbeleuchtung auf dem Gerät festzulegen oder zu ändern. Das Gerät kann einen Host mit Tastaturbeleuchtung erkennen, indem es diesen Bericht beim Systemstart oder beim Herstellen einer Verbindung mit dem Host empfängt.

Der Ausgabebericht „Ebene festlegen“ muss einen logischen Bereich von Helligkeitswerten auf einer linearen Skala definieren, wobei die HID-Einheit als Nits angegeben ist. Der Host verwendet diesen logischen Bereich, um die möglichen Helligkeitsstufen zu bestimmen, die vom Gerät unterstützt werden; Es ist nicht erforderlich, dass das Gerät kalibriert wird, um genaue Leuchtdichtewerte zu emittieren. Alle anderen Tastatur-Backlight-Befehle und Hostvorgänge verweisen auf diesen logischen Bereich.

Wenn das logische Minimum gleich oder größer als das logische Maximum ist, gilt das Gerät als nicht kompatibel und wird nicht für die Backlight-Steuerung durch den Host geöffnet.

Ein Wert vom Typ "Ebene festlegen" von 0 weist das Gerät an, die Hintergrundbeleuchtung zu deaktivieren. Es wird dringend empfohlen, dass das Gerät für diesen Bericht ein logisches Minimum von 0 (keine Helligkeit) verwendet.

Obligatorische Verwendungen
Berichtsname Beschreibung Seite ID
Ebene festlegen Weist das Gerät an, die Tastatur-Hintergrundbeleuchtung auf die angegebene Helligkeit in der logischen Maßeinheit 'Nits' einzustellen. 0x0C 0x007B

Bericht über Vorschläge zur Hintergrundbeleuchtungsstufen-Funktion

Dieser Bericht ist optional. Das Gerät kann eine Reihe von mindestens zwei Helligkeitsvoreinstellungen unterstützen, die er durchlaufen möchte, wenn der Benutzer die Schaltflächen "Nächste Ebene" oder "Vorherige Ebene" drückt. Der Host fragt diese Voreinstellungen beim Systemstart ab oder wenn das Gerät eine Verbindung mit dem Host herstellt oder erneut herstellt. Die Voreinstellungen müssen sich innerhalb des logischen Bereichs befinden, der im "Set-Level-Ausgabebericht" angegeben ist. Ein Vorschlagswert von 0 ist gültig und zeigt den Zustand "Hintergrundbeleuchtung aus" als Voreinstellung an.

Der Featurebericht "Level Suggestions" wird ignoriert, wenn das Gerät weder die Schaltfläche "Nächste Ebene" noch die Eingabeschaltfläche "Vorherige Ebene" implementiert.

Optionale Verwendungen
Berichtsname Beschreibung Seite ID
Vorschlag für die Stufe der Tastatur-Hintergrundbeleuchtung Gibt eine voreingestellte Voreinstellung für die Helligkeit an, die berücksichtigt werden soll, wenn der Host die Eingabeschaltflächen "Nächste Ebene" oder "Vorherige Ebene" behandelt. 0x07 0x0517

Bericht zur Einstellung der Tastaturbeleuchtungsstufe

Dieser Bericht ist optional. Das Gerät kann diesen Bericht implementieren, um dem Host eine vorgeschlagene anfängliche Helligkeitsstufe beim Start oder zur Verbindungszeit zu signalisieren, z. B. wenn die Hintergrundbeleuchtung vor dem Systemstart oder an das Gerät vom Benutzer angepasst wurde. Der Host fragt diesen Bericht beim Systemstart ab oder wenn das Gerät die Verbindung mit dem Host herstellt oder wiederherstellt, wobei optional der vorgeschlagene Wert mit einem eigenen überschrieben werden kann. Ein vorgeschlagener Wert von 0 ist gültig und gibt an, dass die Hintergrundbeleuchtung deaktiviert war. Wenn der vorgeschlagene Wert außerhalb des zulässigen Bereichs des Ausgabeberichts "Ebene festlegen" liegt, wird der Bericht ignoriert. Ein vorgeschlagener Wert, der keinem Eintrag im Bericht des Features "Level-Vorschläge" entspricht, ist gültig, sofern er innerhalb des logischen Bereichs liegt.

Der logische Bereich für diesen Bericht muss innerhalb des logischen Bereichs für den Ausgabebericht "Ebene festlegen" liegen.

Optionale Verwendungen
Berichtsname Beschreibung Seite ID
Ebene festlegen Informiert den Host über die aktuelle Helligkeitsstufe der Hintergrundbeleuchtung als Vorschlag für den anfänglichen Zustand des Geräts in dessen Helligkeitsalgorithmen. 0x0C 0x007B

Hostverhalten der Tastatur-Hintergrundbeleuchtung

Dimmen im Energiesparmodus

Windows unterstützt das automatische Dimmen der Tastatur-Hintergrundbeleuchtung, wenn der Energiesparmodus aktiviert ist. Auf kompatiblen Geräten kann dieses Feature unter EinstellungenSystemEnergie & AkkuEnergiesparmodusTastaturhelligkeit verringern, wenn der Energiesparmodus verwendet wird oder mit der folgenden Tastenkombination umgeschaltet werden: Energie & Akku.

Anpassung

Dieses Feature kann in der Registrierung wie in der folgenden Tabelle beschrieben konfiguriert werden. Standardmäßig wendet die Funktion einen 70%-Multiplikator auf die Helligkeit der Tastatur-Hintergrundbeleuchtung an, sobald der Energiesparmodus aktiviert ist.

Registrierungsschlüssel Namen Typ Einheiten
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Lighting\Backlight HintergrundbeleuchtungsenergiesparmodusAktiviert REG_DWORD Boolescher Wert (1 oder 0)
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Lighting\Backlight HintergrundbeleuchtungEnergiesparmultiplikator REG_DWORD Prozent (0-100)

Das Feature kann auch mithilfe von Windows Unattended Setup oder Runtime-Provisioning konfiguriert werden.

Automatische Anpassung der Tastaturbeleuchtungshelligkeit

Auf Geräten wie Laptops, die sowohl eine Tastatur-Hintergrundbeleuchtung als auch einen Ambient light sensor enthalten, unterstützt Windows die automatische Anpassung der Helligkeit der Tastaturrücklicht. Dieses Feature wird auch für externe Tastaturen unterstützt, wenn sie an Geräte mit Umgebungslichtsensoren angeschlossen sind.

Die automatische Tastaturbeleuchtungsanpassung unterscheidet sich von der adaptiven Helligkeit für Displays, ist jedoch konzeptionell in der Umsetzung ähnlich.

Auf kompatiblen Geräten kann dieses Feature unter Einstellungen>Bluetooth & Geräte>Tastatur>Hintergrundbeleuchtung>automatisch die Tastaturhelligkeit ändern, wenn sich die Beleuchtung ändert oder über die folgende Verknüpfung aufgerufen werden: Tastatur.

Eingeteilte Umgebungslicht-Reaktionskurve

Die Autobrightness der Tastaturbeleuchtung entlehnt das Konzept einer zusammengefassten Umgebungslichtreaktionskurve (ALR), wie in der adaptiven Helligkeit beschrieben.

Die Zuordnungen zwischen den Standardwerten der Lux-Bereiche und den Prozentsätzen der Tastaturhintergrundbeleuchtung werden in der folgenden Tabelle angezeigt. Der Prozentsatz des Buckets bezieht sich auf einen Anteil am logischen Höchstwert des "Set Value"-Ausgabeberichts und wird verwendet, wenn der Umgebungslichtpegel innerhalb des Bereichs des Buckets liegt.

Alle Buckets in der ALR-Kurve müssen zusammenhängend oder überlappend sein – Lücken zwischen Buckets sind nicht zulässig. Jeder Bucket muss einen minimalen lux-Wert haben, der streng kleiner als sein maximaler lux-Wert ist. Wenn der Umgebungslichtwert unter den minimalen Lux des niedrigsten Buckets fällt, wird der Prozentsatz des niedrigsten Buckets verwendet. Wenn es den maximalen Lux des obersten Buckets überschreitet, wird der Prozentsatz des obersten Buckets verwendet.

Bucket Min Lux Max Lux Prozentsatz
1 0 6 35
2 5 14 52
3 12 32 70
4 30 45 88
5 40 100 100
6 95 110 88
7 105 160 70
8 155 205 52
9 200 300 0

Wenn mehrere Backlit-Tastaturen angeschlossen sind, wird dieselbe ALR-Kurve für alle Tastaturen verwendet, wobei die resultierenden Prozentsätze auf jedes Gerät basierend auf dem logischen Helligkeitsbereich dieses Geräts angewendet werden.

Anpassung

Die Autobrightness-Aktivierungs- und ALR-Kurvenwerte können in der Registrierung konfiguriert werden, wie in der nachstehenden Tabelle beschrieben. Sie können auch mit Windows Unattended-Setup oder Runtime-Bereitstellung konfiguriert werden.

Registrierungsschlüssel Namen Typ Einheiten
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Lighting\Backlight Gestaffelte Hintergrundbeleuchtungs-Autobeleuchtung aktivieren REG_DWORD Boolescher Wert (1 oder 0)
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Lighting\Backlight Hintergrundbeleuchtungsautomatischehelligkeitsbereichszuordnung REG_SZ Zeichenfolge, die aus einem oder mehreren durch Kommas getrennten Dreifachen in der Form <minlux>:<maxlux>:<percentage> besteht. Jedes Tripel stellt einen Bucket auf der ALR-Kurve dar. Wenn die benutzerdefinierte ALR-Kurve Lücken aufweist, null Einträge enthält oder einen Bucket enthält, in dem minlux ≥ maxluxstattdessen die Standard-ALR-Kurve verwendet wird.

Manuelle Außerkraftsetzung von Autobrightness

Wenn eine Eingabeschaltfläche gedrückt wird, während die Automatische Tastaturbeleuchtung aktiviert ist, wird eine temporäre manuelle Außerkraftsetzung des Autobrightness-Algorithmus initiiert. Die Außerkraftsetzung generiert einen einzelnen, zusätzlichen Bucket, der auf die bucketisierte Kurve angewendet wird, die auf dem aktuellen Umgebungslichtwert liegt, mit minimalen und maximalen Lux-Werten, die einen bestimmten Abstand über oder unter dem aktuellen Wert generiert haben, basierend auf einem Prozentsatz dieses Lesewerts.

Die Standardwertzuordnungen zwischen Lux-Buckets und manuellen Überschreibungsbereichskonstanten sind in der folgenden Tabelle dargestellt. Einträge in der Nachschlagetabelle müssen zusammenhängende, nicht überlappende Lux-Bereiche aufweisen.

Bucket Min Lux Max Lux Unterer Überschreibungsgrenzwertfaktor Oberer Überschreibungsgrenzfaktor
1 0 20 1.00 1.00
2 20 40 0.70 0.60
3 40 150 0.60 0.60
4 150 600 0.50 0.50
5 600 1000 0.40 0.40
6 1000 4000 0,30 0.25
7 4000 10000 0,20 0,20
8 10000 30000 0.15 0,10
9 30000 100.000 0,10 0,10

Ein Beispiel für die Berechnung des Überschreibungsbereichs ist ein Benutzer, der eine Eingabetaste drückt, wenn der neueste Umgebungslichtwert 120 Lux ist. Der entsprechende Nachschlagetabelleneintrag ist Bucket 3, da 120 Lux zwischen 40 und 150 Lux fällt. Der Eimer wird mit einem Schwellenwert von 60% unter dem aktuellen Messwert erstellt. Bei R=120 und A=0,6 beträgt die untere Schwelle 120(1 - 0,6) = 48 Lux. Der obere Schwellenwert liegt auch bei 60% über dem aktuellen Lesewert. Bei R=120 und B=0,6 beträgt der obere Schwellenwert wiederum 120(1 + 0,6) = 192 Lux. Daher wird die manuelle Überschreibung angewendet, solange der Umgebungslichtpegel im Bereich von [48, 192] bleibt.

Sobald aktiviert, wird der Prozentsatz der Helligkeit des manuellen Override-Buckets verwendet, bis entweder:

  • Der Umgebungslichtwert überschreitet die Grenzen des Außerkraftsetzungs-Buckets, an dem die Außerkraftsetzung abgebrochen wird, der Außerkraftsetzungsbereich wird geschlossen, und das Autobrightness-Steuerelement wird mit der bucketisierten ALR-Kurve fortgesetzt oder
  • Ein weiteres Drücken der Eingabeschaltfläche wird vom Gerät empfangen, das den Host dazu veranlasst, den Helligkeitsprozentsatz anzupassen und den manuellen Überschreibungsbereich entsprechend dem zuletzt gemessenen Umgebungslichtwert neu zu berechnen.

Anpassung

Die manuelle Override-Nachschlagetabelle kann im Registry konfiguriert werden, wie in der folgenden Tabelle beschrieben. Sie kann auch mit Windows Unbeaufsichtigtes Setup oder Laufzeitbereitstellung konfiguriert werden.

Registrierungsschlüssel Namen Typ Einheiten
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Lighting\Backlight BacklightAutobrightnessManualOverrideLut REG_SZ Zeichenfolge, die aus einem oder mehreren kommagetrennten 4-Tupeln in der Form <minlux>:<maxlux>:<lowerboundfactor>:<upperboundfactor>besteht. Jedes 4-Tupel stellt einen Eintrag in der Nachschlagetabelle dar. Wenn die benutzerdefinierte Nachschlagetabelle Lücken aufweist, keine Einträge hat, überlappende Buckets enthält oder einen Bucket enthält, in dem minlux ≥ maxlux, wird stattdessen die Standard-Nachschlagetabelle verwendet.

HID-Beispiel-Berichtdeskriptoren

Beispiel für Tastatur-Backlight-Deskriptor

Der folgende Deskriptor unterstützt alle obligatorischen und optionalen Verwendungen. Er deklariert die Unterstützung für acht Tastatur-Hintergrundbeleuchtungseingabeschaltflächen.

Alle logischen Bereiche für den Funktionsbericht "Ebene festlegen" und die Funktionsberichte "Ebene-Vorschläge" müssen innerhalb des logischen Bereichs des obligatorischen Ausgabeberichts "Ebene festlegen" liegen.

0x05, 0x0C,                      // UsagePage(Consumer[0x000C])
0x09, 0x07,                      // UsageId(Keyboard Backlight[0x0007])
0xA1, 0x01,                      // Collection(Application)
0x85, 0x01,                      //     ReportId(1)
0x09, 0x79,                      //     UsageId(Keyboard Brightness Increment[0x0079])
0x09, 0x7A,                      //     UsageId(Keyboard Brightness Decrement[0x007A])
0x09, 0x7C,                      //     UsageId(Keyboard Backlight OOC[0x007C])
0x09, 0x7D,                      //     UsageId(Keyboard Backlight Set Minimum[0x007D])
0x09, 0x7E,                      //     UsageId(Keyboard Backlight Set Maximum[0x007E])
0x09, 0x7F,                      //     UsageId(Keyboard Backlight Auto[0x007F])
0x0A, 0x15, 0x05,                //     UsageId(Keyboard Brightness Next[0x0515])
0x0A, 0x16, 0x05,                //     UsageId(Keyboard Brightness Previous[0x0516])
0x15, 0x00,                      //     LogicalMinimum(0)
0x25, 0x01,                      //     LogicalMaximum(1)
0x95, 0x08,                      //     ReportCount(8)
0x75, 0x01,                      //     ReportSize(1)
0x81, 0x06,                      //     Input(Data, Variable, Relative, NoWrap, Linear, PreferredState, NoNullPosition, BitField)
0x0A, 0x17, 0x05,                //     UsageId(Keyboard Backlight Level Suggestion[0x0517])
0x67, 0xE1, 0x00, 0x00, 0x01,    //     Unit('nits', SiLinear, Centimeter:-2, Candela:1)
0x55, 0x04,                      //     UnitExponent(10,000)
0x26, 0xFF, 0x00,                //     LogicalMaximum(255)
0x95, 0x04,                      //     ReportCount(4)
0x75, 0x08,                      //     ReportSize(8)
0xB1, 0x03,                      //     Feature(Constant, Variable, Absolute, NoWrap, Linear, PreferredState, NoNullPosition, NonVolatile, BitField)
0x85, 0x02,                      //     ReportId(2)
0x09, 0x7B,                      //     UsageId(Keyboard Backlight Set Level[0x007B])
0x95, 0x01,                      //     ReportCount(1)
0xB1, 0x03,                      //     Feature(Constant, Variable, Absolute, NoWrap, Linear, PreferredState, NoNullPosition, NonVolatile, BitField)
0x85, 0x01,                      //     ReportId(1)
0x09, 0x7B,                      //     UsageId(Keyboard Backlight Set Level[0x007B])
0x91, 0x02,                      //     Output(Data, Variable, Absolute, NoWrap, Linear, PreferredState, NoNullPosition, NonVolatile, BitField)
0xC0,                            // EndCollection()

Der obige Deskriptor wurde über die folgende Waratah-Datei generiert:

[[unit]]
name = 'meter'
centimeter = [100.0, 1.0]

[[unit]]
name = 'nits'
candela = [1.0, 1.0]
meter = [1.0, -2.0]

[[usagePage]]
name = 'Consumer'

    [[usagePage.usage]]
    id = 0x07
    name = 'Keyboard Backlight'
    types = ['CA']

    [[usagePage.usage]]
    id = 0x515
    name = 'Keyboard Brightness Next'
    types = ['OSC']

    [[usagePage.usage]]
    id = 0x516
    name = 'Keyboard Brightness Previous'
    types = ['OSC']

    [[usagePage.usage]]
    id = 0x517
    name = 'Keyboard Backlight Level Suggestion'
    types = ['SV']

[[applicationCollection]]
usage = ['Consumer', 'Keyboard Backlight']

    [[applicationCollection.inputReport]]

        [[applicationCollection.inputReport.variableItem]]
        usage = ['Consumer', 'Keyboard Brightness Increment']
        logicalValueRange = [0, 1]
        reportFlags = ['Relative', 'PreferredState']

        [[applicationCollection.inputReport.variableItem]]
        usage = ['Consumer', 'Keyboard Brightness Decrement']
        logicalValueRange = [0, 1]
        reportFlags = ['Relative', 'PreferredState']

        [[applicationCollection.inputReport.variableItem]]
        usage = ['Consumer', 'Keyboard Backlight OOC']
        logicalValueRange = [0, 1]
        reportFlags = ['Relative', 'PreferredState']

        [[applicationCollection.inputReport.variableItem]]
        usage = ['Consumer', 'Keyboard Backlight Set Minimum']
        logicalValueRange = [0, 1]
        reportFlags = ['Relative', 'PreferredState']

        [[applicationCollection.inputReport.variableItem]]
        usage = ['Consumer', 'Keyboard Backlight Set Maximum']
        logicalValueRange = [0, 1]
        reportFlags = ['Relative', 'PreferredState']

        [[applicationCollection.inputReport.variableItem]]
        usage = ['Consumer', 'Keyboard Backlight Auto']
        logicalValueRange = [0, 1]
        reportFlags = ['Relative', 'PreferredState']

        [[applicationCollection.inputReport.variableItem]]
        usage = ['Consumer', 'Keyboard Brightness Next']
        logicalValueRange = [0, 1]
        reportFlags = ['Relative', 'PreferredState']

        [[applicationCollection.inputReport.variableItem]]
        usage = ['Consumer', 'Keyboard Brightness Previous']
        logicalValueRange = [0, 1]
        reportFlags = ['Relative', 'PreferredState']

    # Keyboard provided brightness level suggestions for host.
    # Here, the device suggests 4 brightness levels, which the host is free to override as it sees fit.
    [[applicationCollection.featureReport]]

        [[applicationCollection.featureReport.variableItem]]
        usage = ['Consumer', 'Keyboard Backlight Level Suggestion']
        sizeInBits = 8
        logicalValueRange = 'maxUnsignedSizeRange'
        unit = 'nits'
        reportFlags = ['constant']
        count = 4

    # Keyboard reports its last used brightness level as a hint to the host during initialization.
    [[applicationCollection.featureReport]]

        [[applicationCollection.featureReport.variableItem]]
        usage = ['Consumer', 'Keyboard Backlight Set Level']
        sizeInBits = 8
        logicalValueRange = 'maxUnsignedSizeRange'
        unit = 'nits'
        reportFlags = ['constant']

    # Host control of the keyboard brightness level.
    # Device has been previously calibrated to understand what LED 'power level' corresponds to emitted nits.
    [[applicationCollection.outputReport]]

        [[applicationCollection.outputReport.variableItem]]
        usage = ['Consumer', 'Keyboard Backlight Set Level']
        sizeInBits = 8
        logicalValueRange = 'maxUnsignedSizeRange'
        unit = 'nits'
  • Last updated on