|
| 1 | +/* |
| 2 | + * This file is part of the MicroPython project, http://micropython.org/ |
| 3 | + * |
| 4 | + * The MIT License (MIT) |
| 5 | + * |
| 6 | + * Copyright (c) 2020 Scott Shawcroft for Adafruit Industries |
| 7 | + * |
| 8 | + * Permission is hereby granted, free of charge, to any person obtaining a copy |
| 9 | + * of this software and associated documentation files (the "Software"), to deal |
| 10 | + * in the Software without restriction, including without limitation the rights |
| 11 | + * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell |
| 12 | + * copies of the Software, and to permit persons to whom the Software is |
| 13 | + * furnished to do so, subject to the following conditions: |
| 14 | + * |
| 15 | + * The above copyright notice and this permission notice shall be included in |
| 16 | + * all copies or substantial portions of the Software. |
| 17 | + * |
| 18 | + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
| 19 | + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
| 20 | + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE |
| 21 | + * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
| 22 | + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, |
| 23 | + * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN |
| 24 | + * THE SOFTWARE. |
| 25 | + */ |
| 26 | + |
| 27 | +#include "supervisor/board.h" |
| 28 | +#include "mpconfigboard.h" |
| 29 | +#include "shared-bindings/microcontroller/Pin.h" |
| 30 | +#include "shared-module/displayio/__init__.h" |
| 31 | +#include "shared-module/displayio/mipi_constants.h" |
| 32 | + |
| 33 | +#define DELAY 0x80 |
| 34 | + |
| 35 | +// From Arduino-ST7789 library https://github.com/ananevilya/Arduino-ST7789-Library/blob/master/Arduino_ST7789.cpp |
| 36 | +#define ST7789_TFTWIDTH 240 |
| 37 | +#define ST7789_TFTHEIGHT 240 |
| 38 | + |
| 39 | +#define ST7789_240x240_XSTART 0 |
| 40 | +#define ST7789_240x240_YSTART 0 |
| 41 | + |
| 42 | +#define ST7789_NOP 0x00 |
| 43 | +#define ST7789_SWRESET 0x01 |
| 44 | +#define ST7789_RDDID 0x04 |
| 45 | +#define ST7789_RDDST 0x09 |
| 46 | + |
| 47 | +#define ST7789_SLPIN 0x10 |
| 48 | +#define ST7789_SLPOUT 0x11 |
| 49 | +#define ST7789_PTLON 0x12 |
| 50 | +#define ST7789_NORON 0x13 |
| 51 | + |
| 52 | +#define ST7789_INVOFF 0x20 |
| 53 | +#define ST7789_INVON 0x21 |
| 54 | +#define ST7789_DISPOFF 0x28 |
| 55 | +#define ST7789_DISPON 0x29 |
| 56 | +#define ST7789_CASET 0x2A |
| 57 | +#define ST7789_RASET 0x2B |
| 58 | +#define ST7789_RAMWR 0x2C |
| 59 | +#define ST7789_RAMRD 0x2E |
| 60 | + |
| 61 | +#define ST7789_PTLAR 0x30 |
| 62 | +#define ST7789_COLMOD 0x3A |
| 63 | +#define ST7789_MADCTL 0x36 |
| 64 | +#define ST7789_VSCSAD 0x37 |
| 65 | +#define ST7789_PORCTRL 0xB2 |
| 66 | +#define ST7789_GCTRL 0xB7 |
| 67 | +#define ST7789_VCOMS 0xBB |
| 68 | +#define ST7789_LCMCTRL 0xC0 |
| 69 | +#define ST7789_IDSET 0xC1 |
| 70 | +#define ST7789_VDVVRHEN 0xC2 |
| 71 | +#define ST7789_VRHS 0xC3 |
| 72 | +#define ST7789_VDVS 0xC4 |
| 73 | +#define ST7789_VCMOFSET 0xC5 |
| 74 | +#define ST7789_FRCTRL2 0xC6 |
| 75 | +#define ST7789_CABCCTRL 0xC7 |
| 76 | +#define ST7789_REGSEL1 0xC8 |
| 77 | +#define ST7789_REGSEL2 0xCA |
| 78 | +#define ST7789_PWMFRSEL 0xCC |
| 79 | +#define ST7789_PWCTRL1 0xD0 |
| 80 | +#define ST7789_VAPVANEN 0xD2 |
| 81 | +#define ST7789_PVGAMCTRL 0xE0 |
| 82 | +#define ST7789_NVGAMCTRL 0xE1 |
| 83 | + |
| 84 | +#define ST7789_MADCTL_MY 0x80 |
| 85 | +#define ST7789_MADCTL_MX 0x40 |
| 86 | +#define ST7789_MADCTL_MV 0x20 |
| 87 | +#define ST7789_MADCTL_ML 0x10 |
| 88 | +#define ST7789_MADCTL_RGB 0x00 |
| 89 | + |
| 90 | +#define ST7789_RDID1 0xDA |
| 91 | +#define ST7789_RDID2 0xDB |
| 92 | +#define ST7789_RDID3 0xDC |
| 93 | +#define ST7789_RDID4 0xDD |
| 94 | + |
| 95 | +#define DISPLAY_MADCTL (ST7789_MADCTL_RGB) |
| 96 | +#define DISPLAY_VSCSAD 0 |
| 97 | + |
| 98 | +// The init_sequence is bitpacked to minimize the ram impact. Every command begins with a |
| 99 | +// command byte followed by a byte to determine the parameter count and delay. When the top bit |
| 100 | +// of the second byte is 1 (0x80), a delay will occur after the command parameters are sent. |
| 101 | +// The remaining 7 bits are the parameter count excluding any delay byte. The bytes following |
| 102 | +// are the parameters. When the delay bit is set, a single byte after the parameters specifies |
| 103 | +// the delay duration in milliseconds. The value 0xff will lead to an extra long 500 ms delay |
| 104 | +// instead of 255 ms.uint8_t display_init_sequence[] = { |
| 105 | +// display init sequence according to LilyGO example app |
| 106 | + |
| 107 | +uint8_t display_init_sequence[] = { |
| 108 | + // From Lilygo example |
| 109 | + // sw reset |
| 110 | + 0x01, 0 | DELAY, 150, |
| 111 | + // sleep out |
| 112 | + 0x11, 0 | DELAY, 120, |
| 113 | + // normal display mode on |
| 114 | + 0x13, 0, |
| 115 | + // display and color format settings |
| 116 | + 0x36, 1, DISPLAY_MADCTL, |
| 117 | + 0xB6, 2, 0x0A, 0x82, |
| 118 | + 0x3A, 1 | DELAY, 0x55, 10, |
| 119 | + // ST7789V frame rate setting |
| 120 | + 0xB2, 5, 0x0C, 0x0C, 0x00, 0x33, 0x33, |
| 121 | + // voltages: VGH / VGL |
| 122 | + 0xB7, 1, 0x35, |
| 123 | + // ST7789V power setting |
| 124 | + 0xBB, 1, 0x28, |
| 125 | + 0xC0, 1, 0x0C, |
| 126 | + 0xC2, 2, 0x01, 0xFF, |
| 127 | + 0xC3, 1, 0x10, |
| 128 | + 0xC4, 1, 0x20, |
| 129 | + 0xC6, 1, 0x0F, |
| 130 | + 0xD0, 2, 0xA4, 0xA1, |
| 131 | + // ST7789V gamma setting |
| 132 | + 0xE0, 14, 0xD0, 0x00, 0x02, 0x07, 0x0A, 0x28, 0x32, 0x44, 0x42, 0x06, 0x0E, 0x12, 0x14, 0x17, |
| 133 | + 0xE1, 14, 0xD0, 0x00, 0x02, 0x07, 0x0A, 0x28, 0x31, 0x54, 0x47, 0x0E, 0x1C, 0x17, 0x1B, 0x1E, |
| 134 | + 0x21, 0, |
| 135 | + // display on |
| 136 | + 0x21, 0 | DELAY, 10, // _INVON |
| 137 | + 0x29, 0 | DELAY, 120 |
| 138 | +}; |
| 139 | + |
| 140 | + |
| 141 | +void board_init(void) { |
| 142 | + // USB |
| 143 | + common_hal_never_reset_pin(&pin_GPIO19); |
| 144 | + common_hal_never_reset_pin(&pin_GPIO20); |
| 145 | + |
| 146 | + // Debug UART |
| 147 | + #ifdef DEBUG |
| 148 | + common_hal_never_reset_pin(&pin_GPIO6); |
| 149 | + common_hal_never_reset_pin(&pin_GPIO7); |
| 150 | + #endif /* DEBUG */ |
| 151 | + |
| 152 | + // Display |
| 153 | + |
| 154 | + busio_spi_obj_t *spi = &displays[0].fourwire_bus.inline_bus; |
| 155 | + |
| 156 | + common_hal_busio_spi_construct( |
| 157 | + spi, |
| 158 | + &pin_GPIO12, // CLK |
| 159 | + &pin_GPIO11, // MOSI |
| 160 | + NULL // MISO not connected |
| 161 | + ); |
| 162 | + |
| 163 | + common_hal_busio_spi_never_reset(spi); |
| 164 | + |
| 165 | + displayio_fourwire_obj_t *bus = &displays[0].fourwire_bus; |
| 166 | + bus->base.type = &displayio_fourwire_type; |
| 167 | + |
| 168 | + common_hal_displayio_fourwire_construct( |
| 169 | + bus, |
| 170 | + spi, |
| 171 | + &pin_GPIO14, // DC |
| 172 | + &pin_GPIO10, // CS |
| 173 | + &pin_GPIO9, // RST |
| 174 | + 40000000, // baudrate |
| 175 | + 0, // polarity |
| 176 | + 0 // phase |
| 177 | + ); |
| 178 | + |
| 179 | + // workaround as board_init() is called before reset_port() in main.c |
| 180 | + pwmout_reset(); |
| 181 | + |
| 182 | + displayio_display_obj_t *display = &displays[0].display; |
| 183 | + display->base.type = &displayio_display_type; |
| 184 | + common_hal_displayio_display_construct( |
| 185 | + display, |
| 186 | + bus, |
| 187 | + 240, // width (after rotation) |
| 188 | + 240, // height (after rotation) |
| 189 | + 0, // column start |
| 190 | + 80, // row start |
| 191 | + 0, // rotation |
| 192 | + 16, // color depth |
| 193 | + false, // grayscale |
| 194 | + false, // pixels in a byte share a row. Only valid for depths < 8 |
| 195 | + 1, // bytes per cell. Only valid for depths < 8 |
| 196 | + false, // reverse_pixels_in_byte. Only valid for depths < 8 |
| 197 | + true, // reverse_pixels_in_word |
| 198 | + MIPI_COMMAND_SET_COLUMN_ADDRESS, // set column command |
| 199 | + MIPI_COMMAND_SET_PAGE_ADDRESS, // set row command |
| 200 | + MIPI_COMMAND_WRITE_MEMORY_START, // write memory command |
| 201 | + 0x37, // set vertical scroll command |
| 202 | + display_init_sequence, |
| 203 | + sizeof(display_init_sequence), |
| 204 | + NULL, // There is no backlight pin, defined for now. |
| 205 | + NO_BRIGHTNESS_COMMAND, |
| 206 | + 1.0f, // brightness (ignored) |
| 207 | + true, // auto_brightness |
| 208 | + false, // single_byte_bounds |
| 209 | + false, // data_as_commands |
| 210 | + true, // auto_refresh |
| 211 | + 60, // native_frames_per_second |
| 212 | + false, // backlight_on_high |
| 213 | + false // SH1107_addressing |
| 214 | + ); |
| 215 | +} |
| 216 | + |
| 217 | +bool board_requests_safe_mode(void) { |
| 218 | + return false; |
| 219 | +} |
| 220 | + |
| 221 | +void reset_board(void) { |
| 222 | + |
| 223 | +} |
| 224 | + |
| 225 | +void board_deinit(void) { |
| 226 | + common_hal_displayio_release_displays(); |
| 227 | +} |
0 commit comments