index :: hw

hw.rpi.display.hd44780

aliases: [hw.rpi.display.lcd1602], [hw.rpi.display.lcd2004]

LCD display driver for Raspberry Pi (1602 or 2004 module)

available since version: 0.9.8

---

information

Note: display can be configured in single line mode.

methods:

• backlight turn on/off the display backlight
  parameters:
  • STATE new state
    type: bool
    required: True
    
• char write character to the display and move cursor to the next position
  parameters:
  • CHAR char code
    type: int
    required: True
    

• clear clear all display data and set cursor position to 0, 0
  

• cursor_blink turn on/off cursor blinking
  parameters:
  • STATE new state
    type: bool
    required: True
    
• cursor_on turn on/off display cursor
  parameters:
  • STATE new state
    type: bool
    required: True
    
• cursor_pos set cursor potision
  parameters:

  • LINE cursor line
    type: int
    required: True
    

  • COL cursor line character position
    type: int
    required: True
    

• font choose font
  

• move_cursor move cursor horizontally
  parameters:
  • SHIFT relative cursor shift. Negative values move the cursor leftwards, positive values - rightwards
    type: int
    required: True
    
• move_display move display content horizontally
  parameters:
  • SHIFT relative display move, not altering the display content
    type: int
    required: True
    
• write write the message at the current cursor position and then move the cursor to the next position after last written character
  parameters:
  • MSG value list
    type: list
    required: True
    

properties:

• @i2c_addr (initonly) Get/set I²C address. Values 'default' (for addr 0x27), 'alt' (for addr 0x3f) are also accepted
  type: int
  range: -4..119
  default: -1
  

• @i2c_bus (initonly) Get/set I²C bus
  type: atom
  enum: 1, 2, 3, 4, 5, 6, default, none
  default: none
  

• @rows (initonly) Get/set number of display rows
  type: int
  enum: 1, 2, 4
  default: 1
  

inlets:

• control input
  type: control

outlets:

• no output
  type: control

keywords:

display 1602 2004 lcd i2c rpi

Authors: Serge Poltavsky

License: GPL3 or later