Skip to content
Start free evaluation

PDCOMM_GEM_COMMAND_RECEIVED

Macro

Outcome: an Equipment received a validated S2F41 Host Command Send.

#define PDCOMM_GEM_COMMAND_RECEIVED UINT32_C(26)

Declared in: #include <pdcomm_gem_commands.h>

The result is a PRIMARY result whose validation was frozen at receipt:

  • an unknown RCMD gives HCACK #PDCOMM_GEM_COMMAND_UNKNOWN;
  • a command defined with require_online_remote gives #PDCOMM_GEM_COMMAND_CANNOT_PERFORM unless the control state is ONLINE REMOTE;
  • parameter problems give #PDCOMM_GEM_COMMAND_PARAMETER_ERRORS with one CPACK per problem: 1 for an unknown CPNAME; 2 for a duplicate name, an element count outside min_count..max_count, a value outside the numeric bounds, or a missing required parameter; 3 for a format that is not allowed or differs from the configured format.

A request that is malformed or exceeds max_parameters_per_command, max_identifier_bytes, or max_errors is reported as #PDCOMM_GEM_UNHANDLED instead. Read the request with pdcomm_gem_result_command_info() and answer it with pdcomm_gem_equipment_respond_command().