zmk/README.md

35 lines
1.4 KiB
Markdown
Raw Normal View History

2020-05-01 13:49:04 -07:00
# Zephyr Mechanical Keyboard (ZMK) Firmware
2020-05-25 18:39:44 -07:00
[![Netlify Status](https://api.netlify.com/api/v1/badges/942d61a9-87c0-4c23-9b51-f5ed0bce495d/deploy-status)](https://app.netlify.com/sites/zmk/deploys)
2020-05-01 13:49:04 -07:00
This project is a complete work in progress, with absolutely nothing functioning yet. The goal is to explore a new MK firmware
with a less restritive license and better BLE support, built on top of the [Zephyr Project](https://www.zephyrproject.org/)
2020-05-15 18:52:25 -07:00
## TODO
2020-05-16 14:30:30 -07:00
- Document boards/shields/keymaps usage.
2020-05-15 18:52:25 -07:00
- Move most Kconfig setings to the board/keymap defconfigs and out of the toplevel `prj.conf` file.
- Merge the Kscan GPIO driver upstream, or integrate it locally, to avoid use of Zephyr branch.
- Display support, including displaying BLE SC auth numbers for "numeric comparison" mode if we have the screen.
- Fix BT settings to work w/ Zephyr. Do we really need them?
- Tests?
2020-05-16 20:26:26 -07:00
# Missing Features
2020-05-18 13:21:41 -07:00
- Consumer Key Support (play/pause, etc)
2020-05-16 20:26:26 -07:00
- Mod Tap
- One Shot
- Shell over BLE?
- Split support
- custom kscan driver? that recieves events from other side over BLE notifications?
- Need to figure out how to do "custom" GATT services. Custom UUID?
- Do we need to send any state updates over from primary to secondary side?
2020-05-18 13:21:41 -07:00
- Encoders
2020-05-19 12:24:11 -07:00
- Battery reporting.
- Low power mode, with wakeup from interrupt?
2020-05-16 20:26:26 -07:00
2020-05-15 18:52:25 -07:00
## Long Term
- Tool to convert keymap `info.json` files into a DTS keymap file?
- Firmware build service?