MPIMotorMessage / MEIMotorMessage

Definition: MPIMotorMessage

	typedef enum { MPIMotorMessageMOTOR_INVALID, MPIMotorMessageTYPE_INVALID, MPIMotorMessageSTEPPER_NA, } MPIMotorMessage;
	Required Header: stdmpi.h Change History: Modified in the 03.04.00: Addition of STEPPER_NA. Modified in the 03.02.00.

Description

MPIMotorMessage is an enumeration of Motor error messages that can be returned by the MPI library.

MPIMotorMessageMOTOR_INVALID
	The motor number is out of range. This message code is returned by mpiMotorCreate(…) if the motor number is less than zero or greater than or equal to MEIXmpMAX_Motors.
MPIMotorMessageTYPE_INVALID
	The motor type is not valid. This message code is returned by mpiMotorConfigGet / Set(...) if the motor type is not a value defined in the enumeration MPIMotorType. To avoid this error, use one of the defined motor types in MPIMotorType.
MPIMotorMessageSTEPPER_NA
	The hardware does not support the Stepper motor type. This message code is returned by mpiMotorConfigSet(...) if the motor type is configured for MPIMotorTypeSTEPPER when the node hardware does not support steppers. To correct the problem, do not select the stepper motor type.

Definition: MEIMotorMessage

typedef enum {
    MEIMotorMessageMOTOR_NOT_ENABLED,
    MEIMotorMessageSECONDARY_ENCODER_NA,
    MEIMotorMessageHARDWARE_NOT_FOUND,
    MEIMotorMessageSTEPPER_INVALID,
    MEIMotorMessageDISABLE_ACTION_INVALID,
    MEIMotorMessagePULSE_WIDTH_INVALID,
    MEIMotorMessageFEEDBACK_REVERSAL_NA,
    MEIMotorMessageFILTER_DISABLE_NA,
    MEIMotorMessagePHASE_FINDING_FAILED,
    MEIMotorMessageDEMAND_MODE_UNSUPPORTED,
    MEIMotorMessageDEMAND_MODE_NOT_SET,
    MEIMotorMessagePOSITION_FEEDBACK_OFFSET_UNSUPPORTED,
    MEIMotorMessagePOSITION_FEEDBACK_OFFSET_SET_FAILED,
    MEIMotorMessagePOSITION_FEEDBACK_OFFSET_UNINITIALIZED,
} MEIMotorMessage;

Required Header: stdmei.h
Change History: Modified in the 03.04.00. Modified in the 03.03.00.

Description

MEIMotorMessage is an enumeration of Motor error messages that can be returned by the MPI library.

MEIMotorMessageMOTOR_NOT_ENABLED
	The motor number is not active in the controller. This message code is returned by mpiMotorEventConfigGet(…) if the specified motor is not enabled in the controller. To correct the problem, use mpiControlConfigSet(…) to enable the motor object, by setting the motorCount to greater than the motor number. For example, to enable motor 0 to 3, set motorCount to 4.
MEIMotorMessageSECONDARY_ENCODER_NA
	The motor's secondary encoder is not available. This message code is returned by mpiMotorConfigSet(…) or mpiMotorEventConfigSet(…) if the encoder fault trigger is configured for a secondary encoder when the hardware does not support a secondary encoder. To correct the problem, do not select the secondary encoder when configuring the encoder fault conditions.
MEIMotorMessageHARDWARE_NOT_FOUND
	The motor object's hardware resource is not available. This message code is returned by mpiMotorConfigGet(…) or mpiMotorConfigSet(…) if the node hardware for the motor is not found. During controller and network initialization the nodes and motor count for each node is discovered and mapped to the controller's motor objects. An application should not configure a motor object if there is no mapped hardware to receive the service commands. To correct this problem, verify that all expected nodes were found. Use meiSqNodeInfo(…) to determine the node topology and motor count per node. Check the node hardware power and network connections.
MEIMotorMessageSTEPPER_INVALID
	The motor object stepper configuration is not valid. These message codes are returned by mpiMotorConfigGet(…) or mpiMotorConfigSet(…) if the motor type is configured for stepper while the disable action is configured for command position equals actual position. The disable action feature sets the command position equal to the actual position when the amp enable signal is set to disable. Stepper motor types are driven by a digital pulse, which is triggered by the controller's command position. Do not use disable action set to command equals actual with stepper motor types.
MEIMotorMessageDISABLE_ACTION_INVALID
	The motor object stepper configuration is not valid. These message codes are returned by mpiMotorConfigGet(…) or mpiMotorConfigSet(…) if the motor type is configured for stepper while the disable action is configured for command position equals actual position. The disable action feature sets the command position equal to the actual position when the amp enable signal is set to disable. Stepper motor types are driven by a digital pulse, which is triggered by the controller's command position. Do not use disable action set to command equals actual with stepper motor types.
MEIMotorMessagePULSE_WIDTH_INVALID
	The motor stepper pulse width is not valid. This message code is returned by mpiMotorConfigSet(...) if the pulseWidth is out of range. To correct the problem, specify the the pulse width value between 100 nanoseconds and 1 millisecond.
MEIMotorMessageFEEDBACK_REVERSAL_NA
	The feedback reversal is not applicable for the feedback type specified. This message code is returned by mpiMotorConfigSet(...) if the feedback type is not MEIMotorEncoderTypeQUAD_AB and the encoderPhase is set to TRUE. To correct the problem, set encoderPhase to FALSE. Some drives may support feedback reversal via drive parameters. Please consult the drive manufacturer's documentation for details.
MEIMotorMessageFILTER_DISABLE_NA
	The feedback filter disable is not applicable for the feedback type specified. This message code is returned by mpiMotorConfigSet(...) if the feedback type is not MEIMotorEncoderTypeQUAD_AB and the filterDisable is set to TRUE. To correct the problem, set filterDisable to FALSE.
MEIMotorMessagePHASE_FINDING_FAILED
	The drive failed to complete the phase finding procedure. This message code is returned by meiMotorPhaseFindStart(…) if the drive failed to successfully initailized commutation. To determine the cause of the failure, check the fault and warning codes from the drive with meiMotorAmpFault(…) and meiMotorAmpWarning(…).
MEIMotorMessageDEMAND_MODE_UNSUPPORTED
	The motor does not support the specified demand mode. This message is returned by mpiMotorConfigSet(…) or mpiMotorEventConfigSet(…) if the demand mode is configured for a mode that the node/drive does not support. To correct this problem, use the default demand mode or specify a different demand mode.
MEIMotorMessageDEMAND_MODE_NOT_SET
	The demand mode cannot be changed while the amplifier is enabled. This message is returned by mpiMotorConfigSet(…) or mpiMotorEventConfigSet(…) if the demand mode is changed while the motor’s amplifier is enabled. To avoid this error message, disable the motor’s amp enable with mpiMotorAmpEnableSet(…) before changing the demand mode.
MEIMotorMessagePOSITION_FEEDBACK_OFFSET_UNSUPPORTED
	The specified motor does not support the position feedback offset storage feature, either because the FPGA on the drive to which the motor is connected does not implement the feature, or because there is no storage available in the encoder's EEPROM. This message will also occur if the drive is not configured to talk to the encoder using the EnDat 2.1 protocol.
MEIMotorMessagePOSITION_FEEDBACK_OFFSET_SET_FAILED
	The specified motor failed to store the position feedback offset. The exact cause of the failure may vary, but it indicates a problem with the service channel mechanism used to communicate to the motor.
MEIMotorMessagePOSITION_FEEDBACK_OFFSET_UNINITIALIZED
	The motor object was able to retrieve the stored position feedback offset, but the internal checksum indicated that the data was unintialized. The returned position may not be valid. This error will also occur if the encoder memory used to store the offset becomes corrupted.