EthercatDevice_DmpHID.lcmGotoXY()

[EthercatDevice_DmpHID_Generic]

Description

Move the current cursor on the LCM of the EtherCAT slave device to the specified coordinates.

Derived Class:

Syntax

int lcmGotoXY(int x, int y);

Parameters

• [in] int x
  X-axis position of the LCM.
• [in] int y
  Y-axis position of the LCM.

Return Value

Return the current cursor position of the LCM. The formula for calculating the cursor position P_cursor is as follows, where W is the width of the LCM:

$$P_{cursor} = W \times (Y – 1) + (X – 1)$$

If the return value is smaller than 0, it means an error code.

Comment

This function must be called after a successful execution of EthercatMaster::begin(). This function is non-blocking and can be called within the Cyclic Callback.

Example

#include "Ethercat.h"

EthercatMaster master;
EthercatDevice_QECR11HU9S slave;

void CyclicCallback() {
  slave.update();
}

void setup() {
  master.begin();
  slave.attach(0, master);
  master.attachCyclicCallback(CyclicCallback);
  master.start();

  slave.lcmGotoXY(1, 1);
  slave.lcmPrint("Hello");
  slave.lcmGotoXY(8, 1);
  slave.lcmPrint("World!");
  slave.lcmGotoXY(2, 2);
  slave.lcmPrint("QEC HID slave");
}

void loop() {
  // ...
}

Please see EthercatDevice_DmpHID_Generic Class for more QEC HID slave instructions and API usage.