Skip to content

Latest commit

 

History

History
67 lines (48 loc) · 3.91 KB

README.md

File metadata and controls

67 lines (48 loc) · 3.91 KB
Raw

PDQ_GFX_Libs

All credits go to https://github.com/XarkLabs/PDQ_GFX_Libs and of course to Adafruit!

Thanks for your work!!!

Main goal of this fork was reducing the size needed for using this awesome library. This was mainly achieved by removing font support.

My Changes:

  • Reformatting... Sorry this makes a comparison & PR really hard x.x
  • More templates => almost no more #defines needed for configuration
  • No more custom font support
  • Extracted FastPin templates to another library (https://github.com/7FM/FastPin.git)
  • Small adjustment to the assembler code to work with -Wl,--relax compiler flag which replaces call (4 cycles) with rcall (3 cycles) where possible => breaks timing if not adjusted, to be save enable SAVE_DELAYS or FORCE_RCALL (if it succeeds linking)
  • Removed some compability functions
  • 1 or 2 code generalizations
  • optimize variable sizes which results in faster execution + less bytes needed (if something goes wrong first try to increase the variable sizes if this might be the reason, this might also affect timings)
  • changed includes this should fix the issue mentioned below (at least for platformio it does, just use #include <PDQ_GFX/PDQ_GFX.h> and i.e. #include <PDQ_ST7735/PDQ_ST7735.h>)
  • Hopefully I did not break something :D

TODOs:

  • adjust examples

XarkLabs PDQ_GFX_Libs

An optimized fork of Adafruit's GFX library (and LCD drivers) for Arduino (AVR).

This is a replacement "re-mix" of the Adafruit GFX library and associated hardware drivers.

Currently supported are ILI9340, ILI9341, ST7735 and ST7781 LCD drivers (and compatible chipsets).

It is between 2.5x and 12x faster than the Adafruit libraries for SPI LCDs, but it aims to be completely "sketch compatible" (so you can easily speed up your sketches that are using Adafruit's library). You just need to change the name of the #include and "tft" object. A version of the Adafruit "benchmark" example is included (PDQ_graphicsbest.ino) with each driver library.

This includes the 1.8", 2.2" and 2.8" SPI TFT LCD boards or "touch shields" that are commonly available from Adafruit and many other vendors. These are commonly 128x128, 128x160 or 240x320 (but the library supports rotation).

I would also like to thank the excellent http://fastled.io/ project for creating the "FastPin.h" template header that allows for full speed GPIO while allowing the use of "friendly" Arduino pin numbering (it is included in the PDQ driver libraries).

New features in latest commit ("v1.1.5" 2016-04-09) include:

  • Synced core functions with Adafruit_GFX (few changes - I think their clipping is still broken [fixed in PDQ_GFX])
  • Support for new fonts as seen in Adafruit_GFX GitHub
  • Minor bugfixes

New features in latest commit ("v1.0.0" 2015-05-30) include:

  • Arduino IDE 1.6.x support (mainly information in library.properties, but also tested and 100% warning free).
  • New ATtiny85 support for IL934x using USI SPI (not quite as fast as 328P - but can run 20MHz PLL to make up).
  • New support for parallel ST7781 driver as used in Seeed Studio 2.8" Touch Shield (also sold by Radio Shack). This is the fastest LCD supported currently.
  • "Bit-banged" SPI support. Not as fast, but can use (nearly) any pins.
  • Added pushColor with a count that can speed up application rendering runs of same color.
  • Tidied up files and made sure all drivers were updated with latest tweaks.

Suggestions, issues, bugs and comments welcome. Via https://hackaday.io/Xark or visit #Arduino channel on Freenode.net IRC. I have also posted a write-up about the development of this library at http://hackaday.io/Xark (describes most of the optimizations done).

XarkLabs Issues

Currently, the library may only be used from the INO file in your project. You cannot include it in a header file and use it from other CPP files. The current workaround is to write wrapper functions or classes, declare them in a header file, and then implement them in the INO file.