Open Hard- & Software

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Esp32LCDisplayI2C ======
[[http://www.openhardsoftware.de/ | Open Hard- & Software]]
[
[[http://www.openhardsoftware.de/dokuwiki | DokuWiki]]
[[http://www.openhardsoftware.de/websites | WebSites]]
[[http://www.openhardsoftware.de/mediawiki | MediaWiki]]
[[http://www.openhardsoftware.de/nextcloud | NextCloud]]
]

===== Übersicht =====
  * Esp32-Ansteuerung eines LCDisplays mit I2C-Interface(PCF8574)
  * das LCDisplay besitzt 4 Zeilen und 20 Spalten

==== Links ====
  * [[https://github.com/dhylands/python_lcd | dhylands-python_lcd]]

==== Quell-Code====
**Main-Program: CheckEsp32LCDisplayI2C.py**
<code python>
#
import time
import machine
import LCDisplayI2C
#
I2CADDRESS_LCDISPLAY_T  = 0x27
I2CADDRESS_LCDISPLAY_A  = 0x3F
#
LCDISPLAY_COUNT_ROWS    = 4
LCDISPLAY_COUNT_COLUMNS = 20
#
def TestLoop():
    for S in range(0, 10):
        LCDisplay.MoveTo(0, 0)
        LCDisplay.PutText('********************')
        LCDisplay.MoveTo(1, 0)
        LCDisplay.PutText('* Esp32LCDisplay   *')
        LCDisplay.MoveTo(2, 0)
        LCDisplay.PutText('* Version 01V01    *')
        LCDisplay.MoveTo(3, 0)
        LCDisplay.PutText('********************')
        time.sleep_ms(2000)
        LCDisplay.Clear()
        for P in range(0, 30):
            LCDisplay.MoveTo(0, 0)
            LCDisplay.PutText('Line0[{}]'.format(time.ticks_ms()))
            LCDisplay.MoveTo(1, 0)
            LCDisplay.PutText('Line1[{}]'.format(time.ticks_ms()))
            LCDisplay.MoveTo(2, 0)
            LCDisplay.PutText('Line2[{}]'.format(time.ticks_ms()))
            LCDisplay.MoveTo(3, 0)
            LCDisplay.PutText('Line3[{}]'.format(time.ticks_ms()))
    #
#-------------------------------------------------------------    
if '__main__' == __name__:
    print('*** CheckEsp32LCDisplayI2C: begin')
    #
    I2CDisplay = machine.SoftI2C(scl=machine.Pin(22), sda=machine.Pin(21), freq=2000000) 
    LCDisplay = LCDisplayI2C.CLCDisplayI2C(I2CDisplay, I2CADDRESS_LCDISPLAY_T, \
                                           LCDISPLAY_COUNT_ROWS, LCDISPLAY_COUNT_COLUMNS)
    #
    TestLoop()
    #
    print('*** CheckEsp32LCDisplayI2C: end')
    #
#
</code>

**Library-Module: LCDisplayI2C.py (derived from Basic-Class)**
<code python>
#
"""Implements a HD44780 character LCD connected via PCF8574 on I2C"""
#
from LCDisplay import CLCDisplay
from time import sleep_ms
#
# The PCF8574 has a jumper selectable address: 0x20 - 0x27
DEFAULT_I2C_ADDR = 0x27
#
MASK_RS = 0x01
MASK_RW = 0x02
MASK_E = 0x04
SHIFT_BACKLIGHT = 3
SHIFT_DATA = 4
#
class CLCDisplayI2C(CLCDisplay):
    #
    def __init__(self, i2c, i2caddress, countrows, countcolumns):
        self.I2C = i2c
        self.I2CAddress = i2caddress
        self.I2C.writeto(self.I2CAddress, bytearray([0]))
        sleep_ms(20)   # Allow LCD time to powerup
        # Send reset 3 times
        self.hal_write_init_nibble(self.LCD_FUNCTION_RESET)
        sleep_ms(5)    # need to delay at least 4.1 msec
        self.hal_write_init_nibble(self.LCD_FUNCTION_RESET)
        sleep_ms(1)
        self.hal_write_init_nibble(self.LCD_FUNCTION_RESET)
        sleep_ms(1)
        # Put LCD into 4 bit mode
        self.hal_write_init_nibble(self.LCD_FUNCTION)
        sleep_ms(1)
        CLCDisplay.__init__(self, countrows, countcolumns)
        cmd = self.LCD_FUNCTION
        if countrows > 1:
            cmd |= self.LCD_FUNCTION_2LINES
        self.hal_write_command(cmd)
    #
    def hal_write_init_nibble(self, nibble):
        byte = ((nibble >> 4) & 0x0f) << SHIFT_DATA
        self.I2C.writeto(self.I2CAddress, bytearray([byte | MASK_E]))
        self.I2C.writeto(self.I2CAddress, bytearray([byte]))
    #
    def hal_backlight_on(self):
        self.I2C.writeto(self.I2CAddress, bytearray([1 << SHIFT_BACKLIGHT]))
    #
    def hal_backlight_off(self):
        self.I2C.writeto(self.I2CAddress, bytearray([0]))
    #
    def hal_write_command(self, cmd):
        """Data is latched on the falling edge of E."""
        byte = ((self.Backlight << SHIFT_BACKLIGHT) | (((cmd >> 4) & 0x0f) << SHIFT_DATA))
        self.I2C.writeto(self.I2CAddress, bytearray([byte | MASK_E]))
        self.I2C.writeto(self.I2CAddress, bytearray([byte]))
        byte = ((self.Backlight << SHIFT_BACKLIGHT) | ((cmd & 0x0f) << SHIFT_DATA))
        self.I2C.writeto(self.I2CAddress, bytearray([byte | MASK_E]))
        self.I2C.writeto(self.I2CAddress, bytearray([byte]))
        if cmd <= 3: # The home and clear commands require a worst case delay of 4.1 msec
            sleep_ms(5)
    #
    def hal_write_data(self, data):
        byte = (MASK_RS | (self.Backlight << SHIFT_BACKLIGHT) | (((data >> 4) & 0x0f) << SHIFT_DATA))
        self.I2C.writeto(self.I2CAddress, bytearray([byte | MASK_E]))
        self.I2C.writeto(self.I2CAddress, bytearray([byte]))
        byte = (MASK_RS | (self.Backlight << SHIFT_BACKLIGHT) | ((data & 0x0f) << SHIFT_DATA))
        self.I2C.writeto(self.I2CAddress, bytearray([byte | MASK_E]))
        self.I2C.writeto(self.I2CAddress, bytearray([byte]))
    #
#    
</code>

**Library-Module: LCDisplay.py (Basic-Class)**
<code python>
"""Provides an API for talking to HD44780 compatible character LCDs."""
#
import time
#
class CLCDisplay:
    # HD44780 LCD controller command set
    LCD_CLR = 0x01              # DB0: clear display
    LCD_HOME = 0x02             # DB1: return to home position
    #
    LCD_ENTRY_MODE = 0x04       # DB2: set entry mode
    LCD_ENTRY_INC = 0x02        # --DB1: increment
    LCD_ENTRY_SHIFT = 0x01      # --DB0: shift
    #
    LCD_ON_CTRL = 0x08          # DB3: turn lcd/cursor on
    LCD_ON_DISPLAY = 0x04       # --DB2: turn display on
    LCD_ON_CURSOR = 0x02        # --DB1: turn cursor on
    LCD_ON_BLINK = 0x01         # --DB0: blinking cursor
    #
    LCD_MOVE = 0x10             # DB4: move cursor/display
    LCD_MOVE_DISP = 0x08        # --DB3: move display (0-> move cursor)
    LCD_MOVE_RIGHT = 0x04       # --DB2: move right (0-> left)
    #
    LCD_FUNCTION = 0x20         # DB5: function set
    LCD_FUNCTION_8BIT = 0x10    # --DB4: set 8BIT mode (0->4BIT mode)
    LCD_FUNCTION_2LINES = 0x08  # --DB3: two lines (0->one line)
    LCD_FUNCTION_10DOTS = 0x04  # --DB2: 5x10 font (0->5x7 font)
    LCD_FUNCTION_RESET = 0x30   # See "Initializing by Instruction" section
    #
    LCD_CGRAM = 0x40            # DB6: set CG RAM address
    LCD_DDRAM = 0x80            # DB7: set DD RAM address
    #
    LCD_RS_CMD = 0
    LCD_RS_DATA = 1
    #
    LCD_RW_WRITE = 0
    LCD_RW_READ = 1
    #
    def __init__(self, num_lines, num_columns):
        self.num_lines = num_lines
        if self.num_lines > 4:
            self.num_lines = 4
        self.num_columns = num_columns
        if self.num_columns > 40:
            self.num_columns = 40
        self.CursorY = 0
        self.CursorX = 0
        self.ImpliedNewline = False
        self.Backlight = True
        self.DisplayOff()
        self.BacklightOn()
        self.Clear()
        self.hal_write_command(self.LCD_ENTRY_MODE | self.LCD_ENTRY_INC)
        self.HideCursor()
        self.DisplayOn()
    #
    def Clear(self):
        self.hal_write_command(self.LCD_CLR)
        self.hal_write_command(self.LCD_HOME)
        self.CursorY = 0
        self.CursorX = 0
    #
    def ShowCursor(self):
        self.hal_write_command(self.LCD_ON_CTRL | self.LCD_ON_DISPLAY |
                               self.LCD_ON_CURSOR)
    #
    def HideCursor(self):
        self.hal_write_command(self.LCD_ON_CTRL | self.LCD_ON_DISPLAY)
    #
    def BlinkCursorOn(self):
        self.hal_write_command(self.LCD_ON_CTRL | self.LCD_ON_DISPLAY |
                               self.LCD_ON_CURSOR | self.LCD_ON_BLINK)
    #
    def BlinkCursorOff(self):
        self.hal_write_command(self.LCD_ON_CTRL | self.LCD_ON_DISPLAY |
                               self.LCD_ON_CURSOR)
    #
    def DisplayOn(self):
        self.hal_write_command(self.LCD_ON_CTRL | self.LCD_ON_DISPLAY)
    #
    def DisplayOff(self):
        self.hal_write_command(self.LCD_ON_CTRL)
    #
    def BacklightOn(self):
        self.backlight = True
        self.hal_backlight_on()
    #
    def BacklightOff(self):
        self.backlight = False
        self.hal_backlight_off()
    #
    def MoveTo(self, cursory, cursorx):
        self.CursorY = cursory
        self.CursorX = cursorx
        Address = cursorx & 0x3f
        if cursory & 1:
            Address += 0x40    # Lines 1 & 3 add 0x40
        if cursory & 2:     # Lines 2 & 3 add number of columns
            Address += self.num_columns
        self.hal_write_command(self.LCD_DDRAM | Address)
    #
    def PutCharacter(self, character):
        if character == '\n':
            if self.implied_newline:
                self.implied_newline = False
            else:
                self.CursorX = self.num_columns
        else:
            self.hal_write_data(ord(character))
            self.CursorX += 1
        if self.CursorX >= self.num_columns:
            self.CursorX = 0
            self.CursorY += 1
            self.implied_newline = (character != '\n')
        if self.CursorY >= self.num_lines:
            self.CursorY = 0
        self.MoveTo(self.CursorY, self.CursorX)
    #
    def PutText(self, text):
        for C in text:
            self.PutCharacter(C)
    #
    def custom_char(self, location, charmap):
        location &= 0x7
        self.hal_write_command(self.LCD_CGRAM | (location << 3))
        self.hal_sleep_us(40)
        for i in range(8):
            self.hal_write_data(charmap[i])
            self.hal_sleep_us(40)
        self.MoveTo(self.cursor_y, self.cursor_x)
    #
    def hal_backlight_on(self):
        pass
    #
    def hal_backlight_off(self):
        pass
    #
    def hal_write_command(self, cmd):
        raise NotImplementedError
    #
    def hal_write_data(self, data):
        raise NotImplementedError
    #
    def hal_sleep_us(self, usecs):
        time.sleep_us(usecs)  
    #
#
</code>



===== Entwicklung =====

==== 211216 : Esp32LCDisplayI2C 01V01 ====
  * Minimierung abgeschlossen
  * Download: {{:module:micropython:Esp32LCDisplayI2C:2112161443_Esp32LCDisplayI2C_01V01.zip|2112161443_Esp32LCDisplayI2C_01V01.zip}}


** VSCode: Testprogramm Esp32LCDisplayI2C 01V01** \\ 
{{:module:micropython:Esp32LCDisplayI2C:2112161443_VSCodeEsp32LCDisplayI2C.jpg?400|2112161443_VSCodeEsp32LCDisplayI2C.jpg}}

** Funktionsweise Ansteuerung LCDisplayI2C** \\ 
{{:module:micropython:Esp32LCDisplayI2C:2112161443_Esp32LCDisplayI2C_01V01.mp4|2112161443_Esp32LCDisplayI2C_01V01.mp4}}


==== 211216 : DokuWiki:Esp32LCDisplayI2C ====
  * WICHTIG: **LCDisplayI2C(PCF8574T) 4row x 20columns muss mit 5V betrieben werden!**
  * Versuch, die Github-Original-Files zu minimieren und optimieren
==== 211215 : Erster Versuch Esp32-LCDisplayI2C ====
  * Download [[https://github.com/dhylands/python_lcd | Github: DHylands: lcd_api and i2c_lcd]]
  * Erzeugung lcd-Projekt unter VSCode
  * Upload aller (25!) Files zum Esp32-MicroPython
  * run 'esp8266_i2c_lcd_test.py'
    * DEFAULT_I2C_ADDR = 0x27
    * i2c = I2C(scl=Pin(22), sda=Pin(21), freq=100000)
    * lcd = I2cLcd(i2c, DEFAULT_I2C_ADDR, 4, 20)
  * {{:module:micropython:Esp32LCDisplayI2C:2112151800_Esp32LCDisplayI2C_lcd_00V01.zip|2112151800_Esp32LCDisplayI2C_lcd_00V01.zip}}

{{:module:micropython:Esp32LCDisplayI2C:2112151800_Esp32LCDisplayI2C_lcd_00V01.mp4|2112151800_Esp32LCDisplayI2C_lcd_00V01.mp4}}


-----
[[http://www.openhardsoftware.de/ | Open Hard- & Software]]
[
[[http://www.openhardsoftware.de/dokuwiki | DokuWiki]]
[[http://www.openhardsoftware.de/websites | WebSites]]
[[http://www.openhardsoftware.de/mediawiki | MediaWiki]]
[[http://www.openhardsoftware.de/nextcloud | NextCloud]]
]