UniGraphic-Fork for ST7920-LCD-controller and SH1106. Tested with 128x64 LCD with SPI and 128x64-OLED with IIC
Dependents: UniGraphic-St7920-Test AfficheurUTILECO
Fork of UniGraphic by
Fork of the UniGraphic-Library for monochrome LCDs with ST7920 controller and 128x64-IIC-OLED-Display with SH1106-Controller
Had to adapt LCD for following reasons:
- Give access to screenbuffer buffer[] to parent class
- pixel() and pixel_read() as they are hardware-dependent
- added reset-pin to IIC-Interface
GraphicDisplay:: sends buffer to LCD when auto_update is set to true.
Testprogram for ST7920 can be found here:
https://developer.mbed.org/users/charly/code/UniGraphic-St7920-Test/
Protocols/PAR8.h@38:1b6f9fc49a03, 2018-10-30 (annotated)
- Committer:
- charly
- Date:
- Tue Oct 30 20:00:29 2018 +0000
- Revision:
- 38:1b6f9fc49a03
- Parent:
- 27:acb2594b8aa4
some modifications.
Who changed what in which revision?
User | Revision | Line number | New contents of line |
---|---|---|---|
Geremia | 0:75ec1b3cde17 | 1 | #ifndef PAR8_H |
Geremia | 0:75ec1b3cde17 | 2 | #define PAR8_H |
Geremia | 0:75ec1b3cde17 | 3 | |
Geremia | 0:75ec1b3cde17 | 4 | #include "mbed.h" |
Geremia | 0:75ec1b3cde17 | 5 | #include "Protocols.h" |
dreschpe | 27:acb2594b8aa4 | 6 | |
dreschpe | 27:acb2594b8aa4 | 7 | #if DEVICE_PORTINOUT |
Geremia | 0:75ec1b3cde17 | 8 | //#include "GraphicsDisplay.h" |
Geremia | 0:75ec1b3cde17 | 9 | |
Geremia | 6:8356d48a07db | 10 | /** Parallel 8bit interface |
Geremia | 6:8356d48a07db | 11 | */ |
Geremia | 0:75ec1b3cde17 | 12 | class PAR8 : public Protocols |
Geremia | 0:75ec1b3cde17 | 13 | { |
Geremia | 0:75ec1b3cde17 | 14 | public: |
Geremia | 0:75ec1b3cde17 | 15 | |
Geremia | 0:75ec1b3cde17 | 16 | /** Create a PAR8 display interface with a GPIO port and 5 control pins |
Geremia | 0:75ec1b3cde17 | 17 | * |
Geremia | 0:75ec1b3cde17 | 18 | * @param port GPIO port to use |
Geremia | 0:75ec1b3cde17 | 19 | * @param CS pin connected to CS of display |
Geremia | 0:75ec1b3cde17 | 20 | * @param reset pin connected to RESET of display |
Geremia | 0:75ec1b3cde17 | 21 | * @param DC pin connected to data/command of display |
Geremia | 0:75ec1b3cde17 | 22 | * @param WR pin connected to SDI of display |
Geremia | 0:75ec1b3cde17 | 23 | * @param RD pin connected to RS of display |
Geremia | 0:75ec1b3cde17 | 24 | */ |
Geremia | 0:75ec1b3cde17 | 25 | PAR8(PortName port, PinName CS, PinName reset, PinName DC, PinName WR, PinName RD); |
Geremia | 0:75ec1b3cde17 | 26 | |
Geremia | 0:75ec1b3cde17 | 27 | protected: |
Geremia | 0:75ec1b3cde17 | 28 | |
Geremia | 1:ff019d22b275 | 29 | /** Send 8bit command to display controller |
Geremia | 0:75ec1b3cde17 | 30 | * |
Geremia | 0:75ec1b3cde17 | 31 | * @param cmd: byte to send |
Geremia | 0:75ec1b3cde17 | 32 | * |
Geremia | 0:75ec1b3cde17 | 33 | */ |
Geremia | 1:ff019d22b275 | 34 | virtual void wr_cmd8(unsigned char cmd); |
Geremia | 0:75ec1b3cde17 | 35 | |
Geremia | 1:ff019d22b275 | 36 | /** Send 8bit data to display controller |
Geremia | 0:75ec1b3cde17 | 37 | * |
Geremia | 1:ff019d22b275 | 38 | * @param data: byte to send |
Geremia | 0:75ec1b3cde17 | 39 | * |
Geremia | 0:75ec1b3cde17 | 40 | */ |
Geremia | 1:ff019d22b275 | 41 | virtual void wr_data8(unsigned char data); |
Geremia | 0:75ec1b3cde17 | 42 | |
Geremia | 4:12ba0ecc2c1f | 43 | /** Send 2x8bit command to display controller |
Geremia | 1:ff019d22b275 | 44 | * |
Geremia | 1:ff019d22b275 | 45 | * @param cmd: halfword to send |
Geremia | 1:ff019d22b275 | 46 | * |
Geremia | 1:ff019d22b275 | 47 | */ |
Geremia | 1:ff019d22b275 | 48 | virtual void wr_cmd16(unsigned short cmd); |
Geremia | 1:ff019d22b275 | 49 | |
Geremia | 4:12ba0ecc2c1f | 50 | /** Send 2x8bit data to display controller |
Geremia | 1:ff019d22b275 | 51 | * |
Geremia | 1:ff019d22b275 | 52 | * @param data: halfword to send |
Geremia | 1:ff019d22b275 | 53 | * |
Geremia | 1:ff019d22b275 | 54 | */ |
Geremia | 1:ff019d22b275 | 55 | virtual void wr_data16(unsigned short data); |
Geremia | 1:ff019d22b275 | 56 | |
Geremia | 4:12ba0ecc2c1f | 57 | /** Send 16bit pixeldata to display controller |
Geremia | 4:12ba0ecc2c1f | 58 | * |
Geremia | 4:12ba0ecc2c1f | 59 | * @param data: halfword to send |
Geremia | 4:12ba0ecc2c1f | 60 | * |
Geremia | 4:12ba0ecc2c1f | 61 | */ |
Geremia | 4:12ba0ecc2c1f | 62 | virtual void wr_gram(unsigned short data); |
Geremia | 4:12ba0ecc2c1f | 63 | |
Geremia | 4:12ba0ecc2c1f | 64 | /** Send same 16bit pixeldata to display controller multiple times |
Geremia | 1:ff019d22b275 | 65 | * |
Geremia | 1:ff019d22b275 | 66 | * @param data: halfword to send |
Geremia | 1:ff019d22b275 | 67 | * @param count: how many |
Geremia | 1:ff019d22b275 | 68 | * |
Geremia | 1:ff019d22b275 | 69 | */ |
Geremia | 4:12ba0ecc2c1f | 70 | virtual void wr_gram(unsigned short data, unsigned int count); |
Geremia | 1:ff019d22b275 | 71 | |
Geremia | 4:12ba0ecc2c1f | 72 | /** Send array of pixeldata shorts to display controller |
Geremia | 1:ff019d22b275 | 73 | * |
Geremia | 4:12ba0ecc2c1f | 74 | * @param data: unsigned short pixeldata array |
Geremia | 1:ff019d22b275 | 75 | * @param lenght: lenght (in shorts) |
Geremia | 1:ff019d22b275 | 76 | * |
Geremia | 1:ff019d22b275 | 77 | */ |
Geremia | 4:12ba0ecc2c1f | 78 | virtual void wr_grambuf(unsigned short* data, unsigned int lenght); |
Geremia | 0:75ec1b3cde17 | 79 | |
Geremia | 5:b222a9461d6b | 80 | /** Read 16bit pixeldata from display controller (with dummy cycle) |
Geremia | 5:b222a9461d6b | 81 | * |
Geremia | 11:b842b8e332cb | 82 | * @param convert true/false. Convert 18bit to 16bit, some controllers returns 18bit |
Geremia | 5:b222a9461d6b | 83 | * @returns 16bit color |
Geremia | 5:b222a9461d6b | 84 | */ |
Geremia | 11:b842b8e332cb | 85 | virtual unsigned short rd_gram(bool convert); |
Geremia | 5:b222a9461d6b | 86 | |
Geremia | 7:bb0383b91104 | 87 | /** Read 4x8bit register data (with dummy cycle) |
Geremia | 7:bb0383b91104 | 88 | * @param reg the register to read |
Geremia | 7:bb0383b91104 | 89 | * @returns data as uint |
Geremia | 7:bb0383b91104 | 90 | * |
Geremia | 7:bb0383b91104 | 91 | */ |
Geremia | 7:bb0383b91104 | 92 | virtual unsigned int rd_reg_data32(unsigned char reg); |
Geremia | 7:bb0383b91104 | 93 | |
Geremia | 7:bb0383b91104 | 94 | /** Read 3x8bit ExtendedCommands register data |
Geremia | 7:bb0383b91104 | 95 | * @param reg the register to read |
Geremia | 7:bb0383b91104 | 96 | * @returns data as uint |
Geremia | 7:bb0383b91104 | 97 | * @note EXTC regs (0xB0 to 0xFF) are read/write registers, for Parallel mode directly accessible in both directions |
Geremia | 7:bb0383b91104 | 98 | */ |
Geremia | 7:bb0383b91104 | 99 | virtual unsigned int rd_extcreg_data32(unsigned char reg, unsigned char SPIreadenablecmd); |
Geremia | 7:bb0383b91104 | 100 | |
Geremia | 20:14daa48ffd4c | 101 | /** ILI932x specific, does a dummy read cycle, number of bits is protocol dependent |
Geremia | 20:14daa48ffd4c | 102 | * for PAR protocols: a signle RD bit toggle |
Geremia | 20:14daa48ffd4c | 103 | * for SPI8: 8clocks |
Geremia | 20:14daa48ffd4c | 104 | * for SPI16: 16 clocks |
Geremia | 20:14daa48ffd4c | 105 | */ |
Geremia | 20:14daa48ffd4c | 106 | virtual void dummyread (); |
Geremia | 20:14daa48ffd4c | 107 | |
Geremia | 20:14daa48ffd4c | 108 | /** ILI932x specific, select register for a successive write or read |
Geremia | 20:14daa48ffd4c | 109 | * |
Geremia | 20:14daa48ffd4c | 110 | * @param reg register to be selected |
Geremia | 20:14daa48ffd4c | 111 | * @param forread false = a write next (default), true = a read next |
Geremia | 20:14daa48ffd4c | 112 | * @note forread only used by SPI protocols |
Geremia | 20:14daa48ffd4c | 113 | */ |
Geremia | 20:14daa48ffd4c | 114 | virtual void reg_select(unsigned char reg, bool forread =false); |
Geremia | 20:14daa48ffd4c | 115 | |
Geremia | 20:14daa48ffd4c | 116 | /** ILI932x specific, write register with data |
Geremia | 20:14daa48ffd4c | 117 | * |
Geremia | 20:14daa48ffd4c | 118 | * @param reg register to write |
Geremia | 20:14daa48ffd4c | 119 | * @param data 16bit data |
Geremia | 20:14daa48ffd4c | 120 | */ |
Geremia | 20:14daa48ffd4c | 121 | virtual void reg_write(unsigned char reg, unsigned short data); |
Geremia | 20:14daa48ffd4c | 122 | |
Geremia | 20:14daa48ffd4c | 123 | /** ILI932x specific, read register |
Geremia | 20:14daa48ffd4c | 124 | * |
Geremia | 20:14daa48ffd4c | 125 | * @param reg register to be read |
Geremia | 20:14daa48ffd4c | 126 | * @returns 16bit register value |
Geremia | 20:14daa48ffd4c | 127 | */ |
Geremia | 20:14daa48ffd4c | 128 | virtual unsigned short reg_read(unsigned char reg); |
Geremia | 20:14daa48ffd4c | 129 | |
Geremia | 0:75ec1b3cde17 | 130 | /** HW reset sequence (without display init commands) |
Geremia | 0:75ec1b3cde17 | 131 | */ |
Geremia | 0:75ec1b3cde17 | 132 | virtual void hw_reset(); |
Geremia | 0:75ec1b3cde17 | 133 | |
Geremia | 0:75ec1b3cde17 | 134 | /** Set ChipSelect high or low |
Geremia | 0:75ec1b3cde17 | 135 | * @param enable 0/1 |
Geremia | 0:75ec1b3cde17 | 136 | */ |
Geremia | 0:75ec1b3cde17 | 137 | virtual void BusEnable(bool enable); |
Geremia | 0:75ec1b3cde17 | 138 | |
Geremia | 0:75ec1b3cde17 | 139 | |
Geremia | 0:75ec1b3cde17 | 140 | |
Geremia | 0:75ec1b3cde17 | 141 | private: |
Geremia | 0:75ec1b3cde17 | 142 | |
Geremia | 0:75ec1b3cde17 | 143 | PortInOut _port; |
Geremia | 0:75ec1b3cde17 | 144 | DigitalOut _CS; |
Geremia | 0:75ec1b3cde17 | 145 | DigitalOut _reset; |
Geremia | 0:75ec1b3cde17 | 146 | DigitalOut _DC; |
Geremia | 0:75ec1b3cde17 | 147 | DigitalOut _WR; |
Geremia | 0:75ec1b3cde17 | 148 | DigitalOut _RD; |
Geremia | 0:75ec1b3cde17 | 149 | |
Geremia | 0:75ec1b3cde17 | 150 | }; |
dreschpe | 25:daacdcf34e52 | 151 | #endif |
dreschpe | 25:daacdcf34e52 | 152 | |
Geremia | 0:75ec1b3cde17 | 153 | #endif |