bt81x-spin
This is a P8X32A/Propeller driver object for the Bridgetek BT81x series Advanced Embedded Video Engine (EVE)
IMPORTANT: This software is meant to be used with the spin-standard-library (P8X32A) or p2-spin-standard-library (P2X8C4M64P). Please install the applicable library first before attempting to use this code, otherwise you will be missing several files required to build the project.
Salient Features
- SPI connection at 20MHz W/10MHz R (P1), up to 30MHz (P2)
- Graphics primitives: Lines, Points, Text Strings (w/optional wrapping), Numbers (base 2..36), Boxes
- Widgets: Buttons, Dials, Gauges, Gradients (w/or w/o alpha-blending), Keyboard keys, Progress bars, Scroll bars, Sliders, Spinners, Toggle switches
- Set color of primitives, widgets, clear-screen color
- Set panel brightness
- Set scissor clip region
- Screen rotation
- Touchscreen: define tags for display regions, read touch coordinates, read tagged area currently touched, set resistive touch sensitivty, set touch ADC oversampling factor, built-in EVE TS calibration, read/write calibration matrix (includes demo code to write calibration to MCU EE/Flash)
- Set display-specific timings simply by #including the correct file for your display
- Use custom fonts (generated with EVE asset builder or equivalent)
Requirements
P1/SPIN1:
- spin-standard-library
- 1 extra core/cog for the PASM SPI engine
P2/SPIN2:
Compiler Compatibility
| Processor |
Language |
Compiler |
Backend |
Status |
| P1 |
SPIN1 |
FlexSpin (6.9.4) |
Bytecode |
OK |
| P1 |
SPIN1 |
FlexSpin (6.9.4) |
Native/PASM |
OK |
| P2 |
SPIN2 |
FlexSpin (6.9.4) |
NuCode |
Build OK (untested) |
| P2 |
SPIN2 |
FlexSpin (6.9.4) |
Native/PASM2 |
OK |
(other versions or toolchains not listed are not supported, and may or may not work)
Hardware compatibility
- Tested with EVE3 (BT815, 816) Matrix orbital 4.3" (Resistive), 5.0" (Capacitive), 7.0" (Capacitive)
- Not tested with earlier (FTxxx) or newer EVE4 (BT817, BT818)
Limitations
- Very early in development - may malfunction, or outright fail to build
- API not considered stable - not advisable to design a product around this
- Single-channel SPI only (doesn't support DSPI, QSPI)
- Doesn't support interrupts
- Doesn't support MIDI/audio
- Custom fonts are currently limited to legacy format and must be embedded in the application, so
may require substantial amounts of RAM