User Tools

Site Tools


en-us_commands:reference:iclcddisplay

This is an old revision of the document!


IclcdDisplay()

IclcdDisplay() turns the LCD display on or off.

IclcdDisplay command operation flow

bool IclcdDisplay(bool on = true, uint8_t device = 0)

Commands

Command Arguments Return Value Operation
IclcdDisplay(on, device) bool on = true
uint8_t device = 0
bool Turns the LCD display on or off.

Example

bool IclcdBegin(uint8_t address, uint8_t columns, uint8_t rows,
                bool backlight = true, uint8_t device = 0);
bool IclcdClear(uint8_t device = 0);
bool IclcdHome(uint8_t device = 0);
bool IclcdSetCursor(uint8_t column, uint8_t row, uint8_t device = 0);
bool IclcdDisplay(bool on = true, uint8_t device = 0);
bool IclcdCursor(bool on = true, uint8_t device = 0);
bool IclcdBlink(bool on = true, uint8_t device = 0);
bool IclcdBacklight(bool on = true, uint8_t device = 0);
bool IclcdScrollLeft(uint8_t device = 0);
bool IclcdScrollRight(uint8_t device = 0);
bool IclcdTextDirection(bool leftToRight = true, uint8_t device = 0);
bool IclcdAutoscroll(bool on = true, uint8_t device = 0);
bool IclcdCreateChar(uint8_t location, const uint8_t charmap[8],
                     uint8_t device = 0);
bool IclcdWrite(uint8_t value, uint8_t device = 0);
bool IclcdCommand(uint8_t command, uint8_t device = 0);
bool IclcdPrint(...);

Precautions

  • PCF8574 connections use the same mapping as the existing CLCD library: P0=RS, P1=R/W, P2=Enable, P3=backlight, P4~P7=LCD D4~D7.
  • Verify the LCD module's actual I²C address using its settings and I²C scan results.
  • SDA/SCL can share the bus with other I²C devices, but addresses must not overlap.
  • Do not run Wire transfers or I²C slave callbacks concurrently with Iclcd…(). Iclcd transfers run at 100 kHz and then restore the previous TWI settings.
  • On MPAINO, using D20/D21 for external interrupts prevents simultaneous I²C use.
  • IclcdCommand() can change the LCD state directly. Use it only if you understand HD44780 commands.

← Built-in Command List

en-us_commands/reference/iclcddisplay.1788785566.txt.gz · Last modified: by 127.0.0.1

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki