GraphicsDisplay / UniGraphic

Basically i glued Peter Drescher and Simon Ford libs in a GraphicsDisplay class, then derived TFT or LCD class (which inherits Protocols class), then the most derived ones (Inits), which are per-display and are the only part needed to be adapted to diff hw.

Dependents:   testUniGraphic_150217 maze_TFT_MMA8451Q TFT_test_frdm-kl25z TFT_test_NUCLEO-F411RE ... more

Protocols/Protocols.h@34:c66986d80f72, 2022-01-25 (annotated)

Committer:
Geremia
Date:
Tue Jan 25 17:57:55 2022 +0000
Revision:
34:c66986d80f72
Parent:
33:f87f06292637 
align attribute fixed to gcc style, updated to OS6 then got bored

Who changed what in which revision?

UserRevisionLine numberNew contents of line
Geremia 4:12ba0ecc2c1f 1 /* mbed UniGraphic library - Abstract protocol class
Geremia 4:12ba0ecc2c1f 2 * Copyright (c) 2015 Giuliano Dianda
Geremia 4:12ba0ecc2c1f 3 * Released under the MIT License: http://mbed.org/license/mit
Geremia 4:12ba0ecc2c1f 4 */
Geremia 4:12ba0ecc2c1f 5
Geremia 0:75ec1b3cde17 6 /** @file Protocols.h
Geremia 0:75ec1b3cde17 7 */
Geremia 0:75ec1b3cde17 8 #ifndef Protocols_H
Geremia 0:75ec1b3cde17 9 #define Protocols_H
Geremia 0:75ec1b3cde17 10
Geremia 0:75ec1b3cde17 11 #include "mbed.h"
Geremia 0:75ec1b3cde17 12
Geremia 11:b842b8e332cb 13 #define RGB24to16(r,g,b) (((r&0xF8)<<8)|((g&0xFC)<<3)|((b&0xF8)>>3)) //5 red | 6 green | 5 blue
Geremia 5:b222a9461d6b 14 #define BGR2RGB(color) (((color&0x1F)<<11) | (color&0x7E0) | ((color&0xF800)>>11))
Geremia 5:b222a9461d6b 15
Geremia 30:87855d03d91a 16 #define FLIP_NONE 0
Geremia 30:87855d03d91a 17 #define FLIP_X 1
Geremia 30:87855d03d91a 18 #define FLIP_Y 2
Geremia 30:87855d03d91a 19
Geremia 3:48f3282c2be8 20 //#define USE_CS
Geremia 3:48f3282c2be8 21
Geremia 0:75ec1b3cde17 22 /** Protocol types
Geremia 0:75ec1b3cde17 23 */
dreschpe 25:daacdcf34e52 24 #include "platform.h"
dreschpe 25:daacdcf34e52 25
dreschpe 25:daacdcf34e52 26 #if DEVICE_PORTINOUT
Geremia 0:75ec1b3cde17 27 enum proto_t {
Geremia 21:ae0a4eedfc90 28 PAR_8 /**< Parallel 8bit, port pins 0 to 7 */
Geremia 21:ae0a4eedfc90 29 ,PAR_16 /**< Parallel 16bit, port pins 0 to 15 */
Geremia 21:ae0a4eedfc90 30 ,BUS_8 /**< Parallel 8bit, scattered pins */
Geremia 21:ae0a4eedfc90 31 ,BUS_16 /**< Parallel 16bit, scattered pins */
Geremia 0:75ec1b3cde17 32 ,SPI_8 /**< SPI 8bit */
Geremia 0:75ec1b3cde17 33 ,SPI_16 /**< SPI 16bit */
dreschpe 33:f87f06292637 34 ,I2C_ /**< I2C */
Geremia 0:75ec1b3cde17 35 };
dreschpe 25:daacdcf34e52 36 #else
dreschpe 25:daacdcf34e52 37 enum proto_t {
dreschpe 25:daacdcf34e52 38 BUS_8 /**< Parallel 8bit, scattered pins */
dreschpe 25:daacdcf34e52 39 ,BUS_16 /**< Parallel 16bit, scattered pins */
dreschpe 25:daacdcf34e52 40 ,SPI_8 /**< SPI 8bit */
dreschpe 25:daacdcf34e52 41 ,SPI_16 /**< SPI 16bit */
dreschpe 33:f87f06292637 42 ,I2C_ /**< I2C */
dreschpe 25:daacdcf34e52 43 };
dreschpe 25:daacdcf34e52 44 #endif
Geremia 0:75ec1b3cde17 45
Geremia 0:75ec1b3cde17 46
Geremia 6:8356d48a07db 47 /** Abstract interface class for spi and parallel protocols
Geremia 0:75ec1b3cde17 48 */
Geremia 0:75ec1b3cde17 49 class Protocols
Geremia 0:75ec1b3cde17 50 {
Geremia 0:75ec1b3cde17 51 public:
Geremia 0:75ec1b3cde17 52
Geremia 1:ff019d22b275 53 /** Send 8bit command to display controller
Geremia 0:75ec1b3cde17 54 *
Geremia 0:75ec1b3cde17 55 * @param cmd: byte to send
Geremia 0:75ec1b3cde17 56 *
Geremia 0:75ec1b3cde17 57 */
Geremia 1:ff019d22b275 58 virtual void wr_cmd8(unsigned char cmd) = 0;
Geremia 0:75ec1b3cde17 59
Geremia 1:ff019d22b275 60 /** Send 8bit data to display controller
Geremia 0:75ec1b3cde17 61 *
Geremia 1:ff019d22b275 62 * @param data: byte to send
Geremia 0:75ec1b3cde17 63 *
Geremia 0:75ec1b3cde17 64 */
Geremia 1:ff019d22b275 65 virtual void wr_data8(unsigned char data) = 0;
Geremia 0:75ec1b3cde17 66
Geremia 4:12ba0ecc2c1f 67 /** Send 2x8bit command to display controller
Geremia 1:ff019d22b275 68 *
Geremia 1:ff019d22b275 69 * @param cmd: halfword to send
Geremia 1:ff019d22b275 70 *
Geremia 1:ff019d22b275 71 */
Geremia 1:ff019d22b275 72 virtual void wr_cmd16(unsigned short cmd) = 0;
Geremia 1:ff019d22b275 73
Geremia 4:12ba0ecc2c1f 74 /** Send 2x8bit data to display controller
Geremia 1:ff019d22b275 75 *
Geremia 1:ff019d22b275 76 * @param data: halfword to send
Geremia 0:75ec1b3cde17 77 *
Geremia 0:75ec1b3cde17 78 */
Geremia 1:ff019d22b275 79 virtual void wr_data16(unsigned short data) = 0;
Geremia 1:ff019d22b275 80
Geremia 4:12ba0ecc2c1f 81 /** Send 16bit pixeldata to display controller
Geremia 4:12ba0ecc2c1f 82 *
Geremia 4:12ba0ecc2c1f 83 * @param data: halfword to send
Geremia 4:12ba0ecc2c1f 84 *
Geremia 4:12ba0ecc2c1f 85 */
Geremia 4:12ba0ecc2c1f 86 virtual void wr_gram(unsigned short data) = 0;
Geremia 4:12ba0ecc2c1f 87
Geremia 4:12ba0ecc2c1f 88 /** Send same 16bit pixeldata to display controller multiple times
Geremia 1:ff019d22b275 89 *
Geremia 1:ff019d22b275 90 * @param data: halfword to send
Geremia 1:ff019d22b275 91 * @param count: how many
Geremia 1:ff019d22b275 92 *
Geremia 1:ff019d22b275 93 */
Geremia 4:12ba0ecc2c1f 94 virtual void wr_gram(unsigned short data, unsigned int count) = 0;
Geremia 1:ff019d22b275 95
Geremia 4:12ba0ecc2c1f 96 /** Send array of pixeldata shorts to display controller
Geremia 1:ff019d22b275 97 *
Geremia 4:12ba0ecc2c1f 98 * @param data: unsigned short pixeldata array
Geremia 1:ff019d22b275 99 * @param lenght: lenght (in shorts)
Geremia 1:ff019d22b275 100 *
Geremia 1:ff019d22b275 101 */
Geremia 4:12ba0ecc2c1f 102 virtual void wr_grambuf(unsigned short* data, unsigned int lenght) = 0;
Geremia 0:75ec1b3cde17 103
Geremia 5:b222a9461d6b 104 /** Read 16bit pixeldata from display controller (with dummy cycle)
Geremia 5:b222a9461d6b 105 *
Geremia 11:b842b8e332cb 106 * @param convert true/false. Convert 18bit to 16bit, some controllers returns 18bit
Geremia 5:b222a9461d6b 107 * @returns 16bit color
Geremia 5:b222a9461d6b 108 */
Geremia 11:b842b8e332cb 109 virtual unsigned short rd_gram(bool convert) = 0;
Geremia 5:b222a9461d6b 110
Geremia 7:bb0383b91104 111 /** Read 4x8bit register data (with dummy cycle)
Geremia 7:bb0383b91104 112 * @param reg the register to read
Geremia 7:bb0383b91104 113 * @returns data as uint
Geremia 7:bb0383b91104 114 *
Geremia 7:bb0383b91104 115 */
Geremia 7:bb0383b91104 116 virtual unsigned int rd_reg_data32(unsigned char reg) = 0;
Geremia 7:bb0383b91104 117
Geremia 7:bb0383b91104 118 /** Read 3x8bit ExtendedCommands register data
Geremia 7:bb0383b91104 119 * @param reg the register to read
Geremia 7:bb0383b91104 120 * @param SPIreadenablecmd vendor/device specific cmd to read EXTC registers
Geremia 7:bb0383b91104 121 * @returns data as uint
Geremia 7:bb0383b91104 122 * @note EXTC regs (0xB0 to 0xFF) are read/write registers but needs special cmd to be read in SPI mode
Geremia 7:bb0383b91104 123 */
Geremia 7:bb0383b91104 124 virtual unsigned int rd_extcreg_data32(unsigned char reg, unsigned char SPIreadenablecmd) = 0;
Geremia 7:bb0383b91104 125
Geremia 20:14daa48ffd4c 126 /** ILI932x specific, does a dummy read cycle, number of bits is protocol dependent
Geremia 20:14daa48ffd4c 127 * for PAR protocols: a signle RD bit toggle
Geremia 20:14daa48ffd4c 128 * for SPI8: 8clocks
Geremia 20:14daa48ffd4c 129 * for SPI16: 16 clocks
Geremia 20:14daa48ffd4c 130 */
Geremia 20:14daa48ffd4c 131 virtual void dummyread () = 0;
Geremia 20:14daa48ffd4c 132
Geremia 20:14daa48ffd4c 133 /** ILI932x specific, select register for a successive write or read
Geremia 20:14daa48ffd4c 134 *
Geremia 20:14daa48ffd4c 135 * @param reg register to be selected
Geremia 20:14daa48ffd4c 136 * @param forread false = a write next (default), true = a read next
Geremia 20:14daa48ffd4c 137 * @note forread only used by SPI protocols
Geremia 20:14daa48ffd4c 138 */
Geremia 20:14daa48ffd4c 139 virtual void reg_select(unsigned char reg, bool forread =false) = 0;
Geremia 20:14daa48ffd4c 140
Geremia 20:14daa48ffd4c 141 /** ILI932x specific, write register with data
Geremia 20:14daa48ffd4c 142 *
Geremia 20:14daa48ffd4c 143 * @param reg register to write
Geremia 20:14daa48ffd4c 144 * @param data 16bit data
Geremia 20:14daa48ffd4c 145 */
Geremia 20:14daa48ffd4c 146 virtual void reg_write(unsigned char reg, unsigned short data) = 0;
Geremia 20:14daa48ffd4c 147
Geremia 20:14daa48ffd4c 148 /** ILI932x specific, read register
Geremia 20:14daa48ffd4c 149 *
Geremia 20:14daa48ffd4c 150 * @param reg register to be read
Geremia 20:14daa48ffd4c 151 * @returns 16bit register value
Geremia 20:14daa48ffd4c 152 */
Geremia 20:14daa48ffd4c 153 virtual unsigned short reg_read(unsigned char reg) = 0;
Geremia 20:14daa48ffd4c 154
Geremia 0:75ec1b3cde17 155 /** HW reset sequence (without display init commands)
Geremia 0:75ec1b3cde17 156 */
Geremia 0:75ec1b3cde17 157 virtual void hw_reset() = 0;
Geremia 0:75ec1b3cde17 158
Geremia 0:75ec1b3cde17 159 /** Set ChipSelect high or low
Geremia 0:75ec1b3cde17 160 * @param enable 0/1
Geremia 0:75ec1b3cde17 161 */
Geremia 0:75ec1b3cde17 162 virtual void BusEnable(bool enable) = 0;
Geremia 0:75ec1b3cde17 163
Geremia 0:75ec1b3cde17 164 };
Geremia 0:75ec1b3cde17 165 #endif