_/qmk_firmware
1
0
Fork 0
Code Releases Activity
keyboard controller firmware for Atmel AVR and ARM USB families https://github.com/qmk/qmk_firmware http://qmk.fm/
38 commits 1 branch 0 tags 126 MiB
C 84.5%
Objective-C 5.7%
C++ 4.3%
Makefile 4.1%
Python 0.6%
Other 0.5%
Find a file
Fred Sundvik 4d7e4a4780 Don't include lcd_backlight_hal for emulator
2016-05-28 11:13:08 +03:00
example_integration Suspend support for the visualizer 2016-03-13 20:13:02 +02:00
ugfx@7d7eeef0ad Use ugfx API instead of chibios 2016-05-17 09:35:02 +03:00
.gitmodules Update ugfx with ChibiOS 4 support. 2016-04-09 19:49:52 +03:00
lcd_backlight.c Add LCD backlight support 2016-02-13 19:21:16 +02:00
lcd_backlight.h Add LCD backlight support 2016-02-13 19:21:16 +02:00
led_test.c Enable and fix compilation of more files 2016-05-17 09:45:05 +03:00
led_test.h Run mirrored keyframes for led tests as well 2016-04-24 16:40:41 +03:00
LICENSE.md Update readme and license 2016-02-13 22:08:49 +02:00
readme.md Update readme and license 2016-02-13 22:08:49 +02:00
visualizer.c Add callback function for emulator drawing 2016-05-18 09:03:42 +03:00
visualizer.h Add callback function for emulator drawing 2016-05-18 09:03:42 +03:00
visualizer.mk Don't include lcd_backlight_hal for emulator 2016-05-28 11:13:08 +03:00

readme.md

A visualization library for the TMK keyboard firmware

This library is designed to work together with the TMK keyboard firmware. Currently it only works for Chibios flavors, but it would be possible to add support for other configurations as well. The LCD display functionality is provided by the uGFX library.

To use this library as a user

You can and should modify the visualizer_user.c file. Check the comments in the file for more information.

To add this library to custom keyboard projects

  1. Add tmk_visualizer as a submodule to your project
  2. Set VISUALIZER_DIR in the main keyboard project makefile to point to the submodule
  3. Define LCD_ENABLE and/or LCD_BACKLIGHT_ENABLE, to enable support
  4. Include the visualizer.mk make file
  5. Copy the files in the example_integration folder to your keyboard project
  6. All other files than the callback.c file are included automatically, so you will need to add callback.c to your makefile manually. If you already have a similar file in your project, you can just copy the functions instead of the whole file.
  7. Edit the files to match your hardware. You might might want to read the Chibios and UGfx documentation, for more information.
  8. If you enable LCD support you might also have to write a custom uGFX display driver, check the uGFX documentation for that. You probably also want to enable SPI support in your Chibios configuration.