User Tools

Site Tools


en-us_commands:reference:iclcdbegin

This is an old revision of the document!


IclcdBegin()

IclcdBegin() sets the address and screen dimensions of a PCF8574 character LCD.

IclcdBegin command operation flow

bool IclcdBegin(uint8_t address, uint8_t columns, uint8_t rows, bool backlight = true, uint8_t device = 0)

Commands

Command Arguments Return Value Operation
IclcdBegin(address, columns, rows, backlight, device) uint8_t address
uint8_t columns
uint8_t rows
bool backlight = true
uint8_t device = 0
bool Sets the address and screen dimensions of a PCF8574 character LCD.

Example

void setup() {
  Serial.begin(115200);
 
  if (!IclcdBegin(0x27, 20, 4)) {  // Set the address and dimensions of the PCF8574 character LCD.
    Serial.println(F("CLCD connection failed"));
    return;
  }
 
  IclcdSetCursor(0, 0);  // Move the cursor to the specified column and row.
  IclcdPrint(F("ILOGICS Iclcd"));  // Print a string or number to the LCD.
  IclcdSetCursor(0, 1);  // Move the cursor to the specified column and row.
  IclcdPrint(1234);  // Print a string or number to the LCD.
  IclcdSetCursor(6, 1);  // Move the cursor to the specified column and row.
  IclcdPrint(12.34, 2);  // Print a string or number to the LCD.
}
 
void loop() {
}

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/iclcdbegin.1788791733.txt.gz · Last modified: by 127.0.0.1

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki