I want to find...

Search

Shares

Table of Content

EthercatDevice_DmpHID.uartSetFormat()

[EthercatDevice_DmpHID_Generic]

Description

Configure the UART frame format for the specified UART port of the EtherCAT slave device.

Derived Class:

Class NameVendor IDProduct CodeUARTKeypadLCMMPG
EthercatDevice_QECR11HU1S0x00000bc30x0086d404OO
EthercatDevice_QECR11HU5S0x00000bc30x0086d403O
EthercatDevice_QECR00HU5S0x00000bc30x0086d400O
EthercatDevice_QECR11HU9S0x00000bc30x0086d402OOOO
EthercatDevice_QECR00HU9S0x00000bc30x0086d401OOOO

Syntax

int uartSetFormat(int dev, uint8_t format);

Parameters

  • [in] int dev
    The specified UART port of the EtherCAT slave device.
    • 0 for COM1.
    • 1 for COM2.
  • [in] uint8_t format
    The UART frame format to be configured. The bit definition of this parameter is as follows:
    uartSetFormat-1

Data Bits: These bits define the word length of the data being transmitted and received.

DefinitionValueDescription
ECAT_UART_BYTESIZE50x005 data bits.
ECAT_UART_BYTESIZE60x016 data bits.
ECAT_UART_BYTESIZE70x027 data bits.
ECAT_UART_BYTESIZE80x038 data bits.

Stop: This bit selects the number of stop bits to be transmitted.

DefinitionValueDescription
ECAT_UART_STOPBIT10x00One stop bit.
ECAT_UART_STOPBIT20x04Two stop bits (1.5 with 5-bit data).

Parity: These bits select the way in which parity control is performed.

DefinitionValueDescription
ECAT_UART_NOPARITY0x00No parity bit.
ECAT_UART_ODDPARITY0x08Odd parity.
ECAT_UART_EVENPARITY0x18Even parity.
ECAT_UART_MARKPARITY0x28The parity bit exists and is always 1.
ECAT_UART_SPACEPARITY0x38The parity bit exists and is always 0.

Return Value

Return an error code. If the returned value is zero, it indicates a successful execution of this function.

Comment

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

Example

#include "Ethercat.h"

EthercatMaster master;
EthercatDevice_QECR11HU9S slave;

void setup() {
  master.begin();
  slave.attach(0, master);
  slave.uartSetFormat(0, ECAT_UART_BYTESIZE8 + ECAT_UART_NOPARITY + ECAT_UART_STOPBIT1);
}

void loop() {
  // ...
}

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

Scroll to Top