• There are five examples in the main function, and you can switch between different demos by commenting/uncommenting these lines

【Demo flashing】

• Put the Pico device into boot disk mode by pressing the boot button to connect to the computer and then releasing the boot button
• Compile, flash, and run as shown in the figure:
  • Click (1) to start compiling
  • If ② appears, the compilation is successful
  • Click (3) to flash (if you do not enter the boot disk, you will get an error when flashing: No accessible RP-series devices in BOOTSEL mode were found.)

1. Put the Pico device into boot disk mode by pressing the boot button to connect to the computer and then releasing the boot button
2. Go to the folder *\LCD1602_I2C_Module_Demo\Pico\python and copy the uf2 firmware of the corresponding device to the boot disk

【Save driver library】

1. Open Thonny, connect to pico device
2. Open the LCD1602.py file in *\LCD1602_I2C_Module_Demo\Pico\python\lib, and save it to pico
3. The specific steps are as follows:

【Run demo】

1. Use thonny to open the demo in *\LCD1602_I2C_Module_Demo\esp32\python\examples file, and run it as follows:

1. Go to the folder *\LCD1602_I2C_Module_Demo\Pico\arduino, copy the files inside to the libraries folder of the project folder. If you are still unsure, you can refer to this link

【Run demo】

1. Put the Pico device into boot disk mode by pressing the boot button to connect to the computer and then releasing the boot button
2. Use Arduino IDE to open the demo in *\LCD1602_I2C_Module_Demo\Pico\arduino\Waveshare_LCD1602\examples file
3. The specific steps are as follows:

• ① and ② are for choosing the corresponding development board model and port
• ③ Compile and flash
• ④ Flashing completed

1. Go to the folder *\LCD1602_I2C_Module_Demo\Arduino, copy the files inside to the libraries folder of the project folder. If you are still unsure, you can refer to this link

【Run demo】

1. Use Arduino IDE to open the demo in *\LCD1602_I2C_Module_Demo\Arduino\Waveshare_LCD1602\examples file
2. The specific steps are as follows:

• ① and ② are for choosing the corresponding development board model and port
• ③ Compile and flash
• ④ Flashing completed

1. Go to the folder *\LCD1602_I2C_Module_Demo\esp32\arduino, copy the files inside to the libraries folder of the project folder. If you are still unsure, you can refer to this link

【Run demo】

1. Use Arduino IDE to open the demo in *\LCD1602_I2C_Module_Demo\esp32\arduino\Waveshare_LCD1602\examples file
2. The specific steps are as follows:

• ① and ② are for choosing the corresponding development board model and port
• ③ Compile and flash
• ④ Flashing completed

1. Download the corresponding firmware from Micropython official website
2. If using ESP32S3, you can directly use the firmware we provide, the path:

   *\LCD1602_I2C_Module_Demo\esp32\python\bin

• For the tutorial on flashing firmware, please refer to Flash Firmware Flashing and Erasing tutorial

1. Note: The download address is 0x00

【Save driver library】

1. Open Thonny, connect to esp32 device
2. Open the LCD1602.py file in *\LCD1602_I2C_Module_Demo\Pico\python\lib, and save it to esp32
3. The specific steps are as follows:

【Run demo】

1. Use thonny to open the demo in *\LCD1602_I2C_Module_Demo\Pico\python\examples file, and run it as follows:

• python3

sudo apt install python3-smbus

• python2

sudo apt install python-smbus

• Download the demo, unzip and compile it

cd ~
wget https://files.waveshare.com/wiki/LCD1602-I2C-Module/LCD1602_I2C_Module_Demo.zip
unzip LCD1602_I2C_Module_Demo.zip
cd ~/LCD1602_I2C_Module_code/Jetson Nano/python/examples

【Run Character display demo】

• Character display

sudo python Character_display.py

【Run Custom char demo】

• Custom char

sudo python Custom_char.py

【Run Direction control demo】

• Direction control

sudo python Direction_control.py

【Run Display time demo】

• Display time

sudo python Display_time.py

【Run Scroll display demo】

• Scroll display

sudo python Scroll_display.py

API introduction

 /**
  *  @brief  LCD screen initialization
  *  @param cols  Number of columns (currently not functional)
  *  @param rows  Number of rows
  */ 
 void LCD1602_init(uint8_t cols, uint8_t rows);

 /**
  *  @brief  Open display
  */
 void LCD1602_display();

 /**
  *  @brief  Send command
  *  @param value  The commands that have been sent
  */
 void LCD1602_command(uint8_t value);

 /**
  *  @brief  Set cursor position
  *  @param col  Number of columns: Optional range 0-15, maximum 39, needs to be moved to observe characters greater than 15
  *  @param row  Number of rows: Optional range 0-1, 0 represents the first row, 1 represents the second row
  
 void LCD1602_setCursor(uint8_t col, uint8_t row);

 /**
  *  @brief  Clear the display and return the cursor to its initial position (0 position)
  */
 void LCD1602_clear();

 /**
  *  @brief  Write data
  *  @param value  The data has been written
  */
 void LCD1602_data(uint8_t value);

 /**
  *  @brief  Display string
  *  @param str  The strings have been displayed
  */
 void LCD1602_send_string(const char *str);

 /**
  *  @brief  Turn off underline cursor
  */
 void LCD1602_noCursor();

 /**
  *  @brief  Turn on underline cursor
  */
 void LCD1602_cursor();

 /**
  *  @brief  Scroll left to display
  */
 void LCD1602_scrollDisplayLeft();

 /**
  *  @brief  Scroll right to display
  */
 void LCD1602_scrollDisplayRight();

 /**
  *  @brief  This function is used for the text that scrolls from left to right
  */
 void LCD1602_leftToRight();

 /**
  *  @brief  This function is used for the text that scrolls from right to left
  */
 void LCD1602_rightToLeft();

 /**
  *  @brief  This will align the text to the left from the cursor display position
  */
 void LCD1602_noAutoscroll();

 /**
  *  @brief  This will align the text to the right from the cursor display position
  */
 void LCD1602_autoscroll();

 /**
  *  @brief  Allow us to fill the first 8 CGRAM positions with custom characters
  *  @param location  Substitute characters: Range (0-7)
  *  @param charmap  Character array: 8 bytes in size
  */
 void LCD1602_createChar(uint8_t location, uint8_t charmap[]);

 /**
  *  @brief  Backlight chip initialization
  */
 void LCD1602_led_init();

 /**
  *  @brief  Set backlight brightness
  *  @param value  Backlight intensity value: Range (0-100)
  */
 void LCD1602_set_brightness(uint8_t value);

 /**
  *  @brief  Set backlight mode
  *  @param mode  0x00 for normal mode, 0x20 for breathing mode
  */
 void LCD1602_set_led_mode(uint8_t mode);

【Python】

API introduction

 def command(self, cmd)
   
     @brief  Send command
     @param cmd  The commands that have been sent
   

 def data(self,data)
   
     @brief  Write character
     @param data  The data has been written
   

 def setCursor(self,col,row)
   
     @brief  Set cursor position
     @param col  Number of columns: Optional range 0-39
     @param row  Number of rows: Optional range 0-1, 0 represents the first row, 1 represents the second row
   

 def clear(self)
   
     @brief  Clear the display and return the cursor to its initial position (0 position)
   

 def printout(self,arg)
   
     @brief  Output display to the LCD screen
     @param arg  The data that has been output 
   

def createChar(self, location, charmap)
   
     @brief  Allow us to fill the first 8 CGRAM positions with custom characters
     @param location  Substitute characters: Range (0-7)
     @param charmap  Character array: 8 bytes in size
   

 def scrollDisplayLeft(self)
   
     @brief  Scroll left to display
   

 def scrollDisplayRight(self)
   
     @brief  Scroll right to display
   

 def cursor(self)
   
     @brief  Turn on underline cursor
   

 def nocursor(self)
   
     @brief  Turn off underline cursor
   

 def leftToRight(self)
   
     @brief  This function is used for the text that scrolls from left to right
   

 def rightToLeft(self)
   
     @brief  This function is used for the text that scrolls from right to left
   

 def autoscroll(self)
   
     @brief  This will align the text to the right from the cursor display position
   

 def noautoscroll(self)
   
     @brief  This will align the text to the left from the cursor display position
   

 def display(self)
   
     @brief  Open display
   

def set_brightness(self, Value)
   
     @brief  Set backlight brightness
     @param Value: Range (0-100)
   

def set_mode(self, Mode)
   
     @brief  Backlight mode
     @param Mode: Normal mode (0x00), breathing mode (0x20)