You are here

GPIO_MAKE_PULSE (0x0A)

The GPIO_MAKE_PULSE command instructs GPIO-24 adapter to generate a single pulse on selected I/O pin. For more detailed information see Section 9.3, “Single Pulses”.

GPIO_MAKE_PULSE Command

Go to Response

Byte 0 GPIO_MAKE_PULSE Command ID (0x0A).
Byte 1 ECHO Echo to associate a command with the response.
Byte 2 GPIO GPIO pin number.
Byte 3 VAL Logical level of the pulse.
Byte 4 TL Pulse length (least significant byte).
Byte 5 TH Pulse length (most significant byte).
Byte 6 MODE Settings mode for pulse generation.
Byte 7 Reserved Reserved (must be 0).

Command is an 8-byte array of the following format:

Byte 0: GPIO_MAKE_PULSE (0x0A)

This byte contains command ID (command type). It should be set to 0x0A.

Byte 1: ECHO

This byte is used to associate a response received from GPIO-24 adapter with a specific command. Response will contain exactly the same value in its echo byte.

Byte 2: GPIO

GPIO pin number:

  • 0..7 corresponds to GPIO PORT A pins 0..7

  • 8..15 corresponds to GPIO PORT B pins 0..7

  • 16..23 corresponds to GPIO PORT C pins 0..7

Byte 3: VAL

Logical level of the pulse:

  • 0 – negative pulse.

  • 1 – positive pulse.

Bytes 4, 5: TL/TH

Byte 4: TL – least significant byte (low byte) of pulse length.

Byte 5: TH – most significant byte (high byte) of pulse length.

Pulse length is specified in ms in the range from 1 to 65535 ms (65.535 seconds).

Byte 6: MODE

The settings mode for pulse generation:

  • 0 – current pulse will be generated using the settings specified in GPIO_MAKE_PULSE command;

  • 1 – current pulse will be generated using the settings stored in the internal memory. GPIO_MAKE_PULSE command settings will be ignored. You can change settings, stored in the internal memory, with GPIO_SET_PULSE_CFG command.

Byte 7: Reserved

This byte is reserved for future usage and must be set to 0.

For convenience GPIO_MAKE_PULSE_CMD structure is declared in reports.h file.

GPIO-24 adapter sends GPIO_MAKE_PULSE response after command execution.

GPIO_MAKE_PULSE Response

Go to Command

Byte 0 GPIO_MAKE_PULSE Response ID (0x0A).
Byte 1 ECHO Echo to associate a command with the response.
Byte 2 ST Status of the command execution.
Byte 3..7 Reserved Reserved

Response is an 8-byte array of the following format:

Byte 0: GPIO_MAKE_PULSE (0x0A)

Response ID (response type). This byte will contain 0x0A.

Byte 1: ECHO

Echo byte copied from the corresponding command. It is used to associate the response with the specific command.

Byte 2: ST

Status of the command execution:

  • GPIO_ST_SUCCESS (0x00) – Command execution succeeded.

  • GPIO_ST_INVALID_GPIO (0x02)- Invalid I/O pin number has been specified.

Bytes 3..7: Reserved

These bytes are reserved for future usage.

For convenience GPIO_MAKE_PULSE_RSP structure is declared in reports.h file.