https://github.com/elehobica/pico_st7735_80x160
ST7735 (80x160) library for Raspberry Pi Pico / Pico 2
https://github.com/elehobica/pico_st7735_80x160
lcd80x160 raspberry-pi-pico raspberry-pi-pico-2 st7735 waveshare
Last synced: 3 months ago
JSON representation
ST7735 (80x160) library for Raspberry Pi Pico / Pico 2
- Host: GitHub
- URL: https://github.com/elehobica/pico_st7735_80x160
- Owner: elehobica
- License: bsd-2-clause
- Created: 2021-03-14T09:42:11.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2025-03-03T08:57:53.000Z (4 months ago)
- Last Synced: 2025-03-03T09:35:35.075Z (4 months ago)
- Topics: lcd80x160, raspberry-pi-pico, raspberry-pi-pico-2, st7735, waveshare
- Language: C
- Homepage:
- Size: 408 KB
- Stars: 11
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# ST7735 80x160 LCD Library for Raspberry Pi Pico / Pico 2
## Overview
ST7735 80x160 LCD display library for Raspberry Pi Pico / Pico 2
This project supports:
* ST7735 80x160 LCD
* Backlight control by PWM
## Supported Board
* Raspberry Pi Pico
* Raspberry Pi Pico 2
* ST7735S 80x160 LCD
* Waveshare RP2040-LCD-0.96 Board (ST7735S 80x160 LCD build-in)
## Pin Assignment
### ST7735S 80x160 LCD (Raspberry Pi Pico Board)
| Pico Pin # | Pin Name | Function | ST7735S 80x160 Board |
----|----|----|----
|12 | GP9 | GPIO | BLK |
|14 | GP10 | SPI1_SCK | SCL |
|15 | GP11 | SPI1_TX | SDA |
|17 | GP13 | SPI1_CSn | CS |
|19 | GP14 | GPIO | DC |
|20 | GP15 | GPIO | RES |
| 18 | GND | GND | GND |
| 36 | 3V3(OUT) | 3.3V | VCC |
### ST7735S 80x160 LCD (Waveshare RP2040-LCD-0.96 Board)
Uncomment #define BOARD_WAVESHARE_RP2040_LCD_096 in lcd.h
| Pin # | Pin Name | Function | Signal Name |
----|----|----|----
|11 | GP8 | GPIO | DC |
|12 | GP9 | SPI1_CSn | CS |
|14 | GP10 | SPI1_SCK | SCL |
|15 | GP11 | SPI1_TX | DIN |
|16 | GP12 | GPIO | RST |
|-- | GP25 | GPIO | BL |
### Serial (CP2102 module)
| Pico Pin # | Pin Name | Function | CP2102 module |
----|----|----|----
| 1 | GP0 | UART0_TX | RXD |
| 2 | GP1 | UART0_RX | TXD |
| 3 | GND | GND | GND |
## How to build
* See ["Getting started with Raspberry Pi Pico"](https://datasheets.raspberrypi.org/pico/getting-started-with-pico.pdf)
* Put "pico-sdk", "pico-examples" and "pico-extras" on the same level with this project folder.
* Set environmental variables for PICO_SDK_PATH, PICO_EXTRAS_PATH and PICO_EXAMPLES_PATH
* Confirmed with Pico SDK 2.1.1
```
> git clone -b 2.1.1 https://github.com/raspberrypi/pico-sdk.git
> cd pico-sdk
> git submodule update -i
> cd ..
> git clone -b sdk-2.1.1 https://github.com/raspberrypi/pico-examples.git
>
> git clone -b sdk-2.1.1 https://github.com/raspberrypi/pico-extras.git
>
> git clone -b main https://github.com/elehobica/pico_st7735_80x160.git
```
### Windows
* Build is confirmed with Developer Command Prompt for VS 2022 and Visual Studio Code on Windows environment
* Confirmed with cmake-3.27.2-windows-x86_64 and gcc-arm-none-eabi-10.3-2021.10-win32
* Lanuch "Developer Command Prompt for VS 2022"
```
> cd pico_st7735_80x160\test
> mkdir build && cd build
> cmake -G "NMake Makefiles" .. ; (for Raspberry Pi Pico 1 series)
> cmake -G "NMake Makefiles" -DPICO_PLATFORM=rp2350 -DPICO_BOARD=pico2 .. ; (for Raspberry Pi Pico 2)
> nmake
```
* Put "*.uf2" on RPI-RP2 or RP2350 drive
### Linux
* Build is confirmed with [pico-sdk-dev-docker:sdk-2.1.1-1.0.0]( https://hub.docker.com/r/elehobica/pico-sdk-dev-docker)
* Confirmed with cmake-3.22.1 and arm-none-eabi-gcc (15:10.3-2021.07-4) 10.3.1
```
$ cd pico_st7735_80x160/test
$ mkdir build && cd build
$ cmake .. # (for Raspberry Pi Pico 1 series)
$ cmake -DPICO_PLATFORM=rp2350 -DPICO_BOARD=pico2 .. # (for Raspberry Pi Pico 2)
$ make -j4
```
* Download "*.uf2" on RPI-RP2 or RP2350 drive
## Configuration
Configure library settings by `LCD_Config()` with `pico_st7735_80x160_config_t`
```
pico_st7735_80x160_config_t lcd_cfg = {
SPI_CLK_FREQ_DEFAULT,
spi1,
PIN_LCD_SPI1_CS_DEFAULT,
PIN_LCD_SPI1_SCK_DEFAULT,
PIN_LCD_SPI1_MOSI_DEFAULT,
PIN_LCD_DC_DEFAULT,
PIN_LCD_RST_DEFAULT,
PIN_LCD_BLK_DEFAULT,
INVERSION_DEFAULT, // 0: non-color-inversion, 1: color-inversion
RGB_ORDER_DEFAULT, // 0: RGB, 1: BGR
ROTATION_DEFAULT,
H_OFS_DEFAULT,
V_OFS_DEFAULT,
X_MIRROR_DEFAULT
};
LCD_Config(&lcd_cfg);
```
## Application Example
* [RPi_Pico_WAV_Player](https://github.com/elehobica/RPi_Pico_WAV_Player)