ja-jp_commands:reference:iclcdhome

目次

IclcdHome()

IclcdHome()

IclcdHome()はカーソルを先頭位置へ移動します。

bool IclcdHome(uint8_t device = 0)

コマンド

コマンド	引数	戻り値	動作
`IclcdHome(device)`	`uint8_t device = 0`	`bool`	カーソルを先頭位置へ移動します。

使用例

MPAINO-8A8R(T)のI2Cポートに、アドレス0x27の20×4 PCF8574文字LCDを接続した例です。実際のLCDのアドレスやサイズが異なる場合は、IclcdBegin()の引数を変更してください。

bool lcdReady = false;
 
void setup() {
  lcdReady = IclcdBegin(0x27, 20, 4);  // LCDのアドレスと画面サイズを設定します。
  if (lcdReady) {
    IclcdPrint(F("ABCD"));  // 動作確認用の文字を表示します。
    IclcdHome();  // カーソルを先頭列へ移動します。
    IclcdWrite('X');  // LCDに1文字を書きます。
  }
}
 
void loop() {}

注意事項

PCF8574接続は従来のCLCDライブラリと同じマッピングを使用します：P0=RS、P1=R/W、P2=Enable、P3=バックライト、P4~P7=LCD D4~D7。
LCDモジュールの実際のI²Cアドレスは、モジュール設定とI²Cスキャン結果で確認してください。
SDA/SCLは他のI²C機器とバスを共有できますが、アドレスの重複は禁止です。
Iclcd…()の実行中にWire転送やI²Cスレーブコールバックを同時実行しないでください。Iclcd転送は100 kHzで実行した後、元のTWI設定を復元します。
MPAINOでD20/D21を外部割り込みに使用する場合、I²Cとは同時使用できません。
IclcdCommand()はLCD状態を直接変更できるため、HD44780コマンドを理解している場合だけ使用してください。

同じカテゴリの内蔵コマンド

← 内蔵コマンド一覧

ja-jp_commands/reference/iclcdhome.txt · 最終更新: 2026/09/14 20:30 by 127.0.0.1