qmk-firmware/quantum/visualizer
Jack Humbert 800ec55dfc Make arguments redo, subproject elimination (#1784)
* redo make args to use colons, better folder structuring system [skip ci]

* don't put spaces after statements - hard lessons in makefile development

* fix-up some other rules.mk

* give travis a chance

* reset KEYMAPS variable

* start converting keyboards to new system

* try making all with travis

* redo make args to use colons, better folder structuring system [skip ci]

* don't put spaces after statements - hard lessons in makefile development

* fix-up some other rules.mk

* give travis a chance

* reset KEYMAPS variable

* start converting keyboards to new system

* try making all with travis

* start to update readmes and keyboards

* look in keyboard directories for board.mk

* update visualizer rules

* fix up some other keyboards/keymaps

* fix arm board ld includes

* fix board rules

* fix up remaining keyboards

* reset layout variable

* reset keyboard_layouts

* fix remainging keymaps/boards

* update readmes, docs

* add note to makefile error

* update readmes

* remove planck keymap warnings

* update references and docs

* test out tarvis build stages

* don't use stages for now

* don't use stages for now
2017-10-14 11:32:19 -10:00
..
resources Move LCD logo to visualizer resources 2017-04-09 18:34:59 +03:00
LICENSE.md Add 'quantum/visualizer/' from commit 'bde869aa7ec8601459bc63b9636081d21108d1be' 2016-07-06 20:15:45 +03:00
common_gfxconf.h Shared gfxconf 2017-07-10 09:01:59 -04:00
default_animations.c Shared default animations 2017-07-10 09:01:59 -04:00
default_animations.h Shared default animations 2017-07-10 09:01:59 -04:00
lcd_backlight.c Add function for getting the LCD backlight brightness 2017-06-24 00:34:16 +03:00
lcd_backlight.h Change inline to static inline 2017-06-24 00:34:16 +03:00
lcd_backlight_keyframes.c Clarify naming between LCD_BACKLIGHT and LED_BACKLIGHT 2017-07-10 09:01:59 -04:00
lcd_keyframes.c Make it easier to use drivers 2017-07-10 09:01:59 -04:00
lcd_keyframes.h Move the logo drawing keyframe to lcd_keyframes 2017-04-09 18:34:59 +03:00
led_backlight_keyframes.c Make it easier to use drivers 2017-07-10 09:01:59 -04:00
led_backlight_keyframes.h Clarify naming between LCD_BACKLIGHT and LED_BACKLIGHT 2017-07-10 09:01:59 -04:00
readme.md Add 'quantum/visualizer/' from commit 'bde869aa7ec8601459bc63b9636081d21108d1be' 2016-07-06 20:15:45 +03:00
visualizer.c Fix uninitialized backlight_level in the Visualizer 2017-07-10 09:02:36 -04:00
visualizer.h Include config.h from visualizer.h 2017-06-24 00:34:16 +03:00
visualizer.mk Make arguments redo, subproject elimination (#1784) 2017-10-14 11:32:19 -10:00
visualizer_keyframes.c Move common visualizer keyframes into visualizer_keyframes.h 2017-04-09 18:34:59 +03:00
visualizer_keyframes.h Move common visualizer keyframes into visualizer_keyframes.h 2017-04-09 18:34:59 +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.