implement keyboard lock status reader API

This commit is contained in:
xs5871
2022-01-19 23:01:14 +00:00
committed by Kyle Brown
parent a62d39a252
commit 8419ed789c
3 changed files with 88 additions and 0 deletions

23
docs/lock_status.md Normal file
View File

@@ -0,0 +1,23 @@
# Lock Status
This extension exposes host-side locks like caps or num lock.
## Enabling the extension
```python
from kmk.extensions.lock_status import LockStatus
locks = LockStatus()
keyboard.extensions.append(locks)
```
## Read Lock Status
Lock states can be retrieved with getter methods and are truth valued -- `True`
when the lock is enabled and `False` otherwise.
|Method |Description |
|--------------------------|------------|
|`locks.get_caps_lock() ` |Num Lock |
|`locks.get_caps_lock() ` |Caps Lock |
|`locks.get_scroll_lock() `|Scroll Lock |
|`locks.get_compose() ` |Compose |
|`locks.get_kana() ` |Kana |