Keyboard firmwares for Atmel AVR and Cortex-M
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

README.md 4.9KB

Squashed 'tmk_core/' changes from 57d27a8..08ce4c3 08ce4c3 Add update for chibios in README 30cac1d Merge remote-tracking branch 'flabbergast-tmk_keyboard/chibios' f218a38 core: Remove unused warning. Fix tmk_keyboard/#293 3e68807 Chibios: add more guards for transmitting (fix a deadlock bug). cecc807 core: Speed up compilation d01d959 Merge remote-tracking branch 'upstream/master' into chibios 8ff12ae Merge pull request #230 from jerryen/master 3afb83d core: Add note about sudo and git 2525d5d Chibios: Update to new USB API. 2fc5cd6 Merge branch 'master' into chibios 6f5511a core: Fix variable initialize 02a15fa core: Fix variable init and header include 1833ca1 Merge pull request #292 from obones/command_warning bc9dc6f Merge pull request #294 from shayneholmes/fix-debug-message c1b891b Merge pull request #295 from doopai/master 1da837c core: Add macro commands SM(), RM() and CM() d9d5a93 Add support for storing, restoring and clearing modifiers in macros 4f371c0 core: Add dfu-programmer example to doc/build.md ba3792e core: Fix doc/build.md 4b99fed remove SERIAL_SOFT_DEBUG macro 984accb Fix typo in bootmagic debug message 67a7ea1 usb_usb: Fix for keymap editor 2fc9ae4 host_driver is only used if KEYBOARD_LOCK_ENABLE is defined a35cdea Chibios: add 'core/protocol' to the makefiles' search path. 5ed2fd6 Merge remote-tracking branch 'upstream/master' into chibios bbc4851 Do timeout when writing to CONSOLE EP queue. 2450559 Remove an errant comma trailing the KC_ERAS macro alias 8465747 Merge pull request #270 from jeffgran/single-tap-toggle a37339a Merge pull request #271 from jeffgran/default-layer-toggle 8e732f7 core: Update doc/build.md and remove other_projects.md e47dc15 Workaround for compiler warnings when console disabled. 4184c52 Add maple mini code. b555238 core: Fix rules.mk for dfu target 26dacf4 add ACTION_DEFAULT_LAYER_TOGGLE to toggle a default layer on/off 83607d9 enable TAPPING_TOGGLE=1 to work correctly bef3089 Merge branch 'master' into chibios f7a55fd core: Fix debug print of usb_hid 1402f7d core: Add keycode KC_JPY for JIS 8e3a460 Chibios: Remove the wait in the main loop. 7d41746 ChibiOS: prettify/document sleep_led code. 235cdee ChibiOS: Update infinity bootloader code to match updated ChibiOS. 807bf1e Chibios: Add breathing sleep LED on Kinetis MCUs. ba3bf7c ChibiOS: make reset request more CMSISy. bf2ffd4 Add correct chibios/bootloader_jump for infinity KB. f5e03fd Chibios/usb_main: rename a variable for clarity. 63a330c Fix drop key stroke d8f5b06 Fix report size of boot protocol. 38abb50 ChibiOS/STM32: send remote wakeup. 6725650 ChibiOS/kinetis: sending remote wakeup. 69f6e54 Chibios: use WFI in idle. WIP suspend stuff. 02f044b Move chibios/cortex selection to local Makefiles. fa59dfa Rename chibios example keyboard. 5c060de Add eeprom support for chibios/kinetis. efd0044 Move declaration of keymap_config. 7196b24 Make bootmagic.c code portable (_delay_ms -> wait_ms). 37b15b2 Add missing #include to keymap.c. 31316e3 Merge branch 'master' into chibios 166f312 Fix chibios/usb_main GET_REPORT handing. 57ac6c2 Add ARM Teensies bootloader code. 1758086 Move STM32 bootloader address config to separate .h file. 03bb026 Rename some Makefile defines. 76ba6ac NKRO fixes. 06498f8 Update chibios README. db0a4f5 Add basic sleep_led for chibios. c3f930e Move AVR specific sleep_led.c into avr. 4069494 Fix bootloader-jump compiling. 9117f7b Small updates. 269cb85 Implement jump-to-bootloader. 7e81b34 Move chibios to tool. 923a892 Make usb_main more USB_DRIVER #define independent. aa054f0 Add ChibiOS support (USB stack + support files). 1e3e282 Modularity and gcc warnings fixes. 2f60ce0 Add KEYBOARD_LOCK_ENABLE to makefile git-subtree-dir: tmk_core git-subtree-split: 08ce4c3021d2ecd446c5b9a137aded65423d241e
8 years ago
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150
  1. TMK Keyboard Firmware Core Library
  2. ==================================
  3. This is a keyboard firmware library with some useful features for Atmel AVR and Cortex-M.
  4. Source code is available here: <https://github.com/tmk/tmk_keyboard/tree/core>
  5. Updates
  6. -------
  7. #### 2016/02/10
  8. flabbergast's Chibios protocol was merged from <https://github.com/flabbergast/tmk_keyboard/tree/chibios>. See [protocol/chibios/README.md](protocol/chibios/README.md). Chibios protocol supports Cortex-M such as STM32 and Kinetis.
  9. #### 2015/04/22
  10. separated with TMK Keyboard Firmware Collection
  11. Features
  12. --------
  13. These features can be used in your keyboard.
  14. * Multi-layer Keymap - Multiple keyboard layouts with layer switching
  15. * Mouse key - Mouse control with keyboard
  16. * System Control Key - Power Down, Sleep, Wake Up and USB Remote Wake up
  17. * Media Control Key - Volume Down/Up, Mute, Next/Prev track, Play, Stop and etc
  18. * USB NKRO - 120 keys(+ 8 modifiers) simultaneously
  19. * PS/2 mouse support - PS/2 mouse(TrackPoint) as composite device
  20. * Keyboard protocols - PS/2, ADB, M0110, Sun and other old keyboard protocols
  21. * User Function - Customizable function of key with writing code
  22. * Macro - Very primitive at this time
  23. * Keyboard Tricks - Oneshot modifier and modifier with tapping feature
  24. * Debug Console - Messages for debug and interaction with firmware
  25. * Virtual DIP Switch - Configurations stored EEPROM(Boot Magic)
  26. * Locking CapsLock - Mechanical switch support for CapsLock
  27. * Breathing Sleep LED - Sleep indicator with charm during USB suspend
  28. * Backlight - Control backlight levels
  29. TMK Keyboard Firmware Collection
  30. --------------------------------
  31. Complete firmwares for various keyboards and protocol converters.
  32. <https://github.com/tmk/tmk_keyboard>
  33. License
  34. -------
  35. **GPLv2** or later. Some protocol files are under **Modified BSD License**.
  36. LUFA, PJRC and V-USB stack have their own license respectively.
  37. Build Firmware and Program Controller
  38. -------------------------------------
  39. See [doc/build.md](doc/build.md).
  40. Start Your Own Project
  41. -----------------------
  42. **TBD**
  43. ### Config.h Options
  44. #### 1. USB vendor/product ID and device description
  45. #define VENDOR_ID 0xFEED
  46. #define PRODUCT_ID 0xBEEF
  47. #define MANUFACTURER t.m.k.
  48. #define PRODUCT Macway mod
  49. #define DESCRIPTION t.m.k. keyboard firmware for Macway mod
  50. #### 2. Keyboard matrix configuration
  51. #define MATRIX_ROWS 8
  52. #define MATRIX_COLS 8
  53. #define MATRIX_HAS_GHOST
  54. Architecture
  55. ------------
  56. Architecture Diagram
  57. +---------------+---------------+-------------+
  58. | Host | Keyboard | Matrix, LED |
  59. ___________ |-----------+-+ +-------------+ | +-----------|
  60. / /| Keys/Mouse | Protocol |d| | Action | | | Protocol |
  61. /__________/ |<-----------| LUFA |r| | Layer, Tap | | | Matrix |
  62. |.--------.| | LED | V-USB |i| |-------------| | | PS/2,IBM | __________________
  63. || || |----------->| PJRC |v| | Keymap | | | ADB,M0110| Keys / /_/_/_/_/_/_/_/ /|
  64. || Host || | Console | iWRAP(BT)|e| | Mousekey | | | SUN/NEWS |<----------/ /_/_/_/_/_/_/_/ / /
  65. ||________||/.<-----------| UART |r| | Report | | | X68K/PC98| Control / /_/_/_/_/_/_/_/ / /
  66. `_========_'/| |---------------------------------------------|-------->/___ /_______/ ___/ /
  67. |_o______o_|/ | Sendchar, Print, Debug, Command, ... | |_________________|/
  68. +---------------------------------------------+ Keyboard
  69. Debugging
  70. --------
  71. Use PJRC's `hid_listen` to see debug messages. You can use the tool for debug even if firmware use LUFA stack.
  72. You can use xprintf() to display debug info on `hid_listen`, see `common/xprintf.h`.
  73. Files and Directories
  74. -------------------
  75. ### Top
  76. * common/ - common codes
  77. * protocol/ - keyboard protocol support
  78. * doc/ - documents
  79. * common.mk - Makefile for common
  80. * protocol.mk - Makefile for protocol
  81. * rules.mk - Makefile for build rules
  82. ### Common
  83. * host.h
  84. * host_driver.h
  85. * keyboard.h
  86. * command.h
  87. * keymap.h
  88. * action.h
  89. * keycode.h
  90. * matrix.h
  91. * led.h
  92. * mousekey.h
  93. * report.h
  94. * debug.h
  95. * print.h
  96. * bootloader.h
  97. * sendchar.h
  98. * timer.h
  99. * util.h
  100. ### Keyboard Protocols
  101. * lufa/ - LUFA USB stack
  102. * pjrc/ - PJRC USB stack
  103. * vusb/ - Objective Development V-USB
  104. * iwrap/ - Bluetooth HID for Bluegiga iWRAP
  105. * ps2.c - PS/2 protocol
  106. * adb.c - Apple Desktop Bus protocol
  107. * m0110.c - Macintosh 128K/512K/Plus keyboard protocol
  108. * news.c - Sony NEWS keyboard protocol
  109. * x68k.c - Sharp X68000 keyboard protocol
  110. * serial_soft.c - Asynchronous Serial protocol implemented by software
  111. Coding Style
  112. -------------
  113. - Doesn't use Tab to indent, use 4-spaces instead.