lin-epics-modules/motorBase
0
0
Fork 0
forked from epics_driver_modules/motorBase
Code Pull Requests Activity
Files
beba85f7b2cc86e4c9dfedbca8baeb8dbce9cccb
motorBase/motorApp/AMCISrc/ANF2Driver.cpp
T
Kevin Peterson ed95506bb1 Fix for building on Windows
2018-04-19 11:09:28 -05:00

1089 lines
37 KiB
C++
Raw Blame History

/*
FILENAME... ANF2Driver.cpp
USAGE... Motor record driver support for the AMCI ANF2 stepper motor controller over Modbus/TCP.
Kevin Peterson
Based on the AMCI ANG1 Model 3 device driver written by Kurt Goetze
*/
#include <stdio.h>
#include <string.h>
#include <stdlib.h>
#include <math.h>
#include <errno.h>
#include <iocsh.h>
#include <epicsThread.h>
#include <epicsString.h>
#include <asynInt32SyncIO.h>
#include "ANF2Driver.h"
#include <epicsExport.h>
#define NINT(f) (int)((f)>0 ? (f)+0.5 : (f)-0.5)
static const char *driverName = "ANF2MotorDriver";
/** Constructor, Creates a new ANF2Controller object.
* \param[in] portName The name of the asyn port that will be created for this driver
* \param[in] ANF2InPortName The name of the drvAsynSerialPort that was created previously to connect to the ANF2 controller
* \param[in] ANF2OutPortName The name of the drvAsynSerialPort that was created previously to connect to the ANF2 controller
* \param[in] numAxes The number of axes on the controller stack
*/
ANF2Controller::ANF2Controller(const char *portName, const char *ANF2InPortName, const char *ANF2OutPortName,
int numAxes)
: asynMotorController(portName, numAxes, NUM_ANF2_PARAMS,
asynInt32ArrayMask, // One additional interface beyond those in base class
asynInt32ArrayMask, // One additional callback interface beyond those in base class
ASYN_CANBLOCK | ASYN_MULTIDEVICE,
1, // autoconnect
0, 0) // Default priority and stack size
{
int i, j;
asynStatus status = asynSuccess;
static const char *functionName = "ANF2Controller::ANF2Controller";
// Keep track of the number of axes created, so the poller can wait for all the axes to be created before starting
axesCreated_ = 0;
inputDriver_ = epicsStrDup(ANF2InPortName); // Set this before calls to create Axis objects
// Create controller-specific parameters
createParam(ANF2ResetErrorsString, asynParamInt32, &ANF2ResetErrors_);
createParam(ANF2GetInfoString, asynParamInt32, &ANF2GetInfo_);
//createParam(ANF2ReconfigString, asynParamInt32, &ANF2Reconfig_);
numAxes_ = numAxes;
for (j=0; j<numAxes_; j++) {
/* Connect to ANF2 controller */
for (i=0; i<MAX_INPUT_REGS; i++) {
status = pasynInt32SyncIO->connect(ANF2InPortName, i+j*AXIS_REG_OFFSET, &pasynUserInReg_[j][i], NULL);
}
status = pasynInt32ArraySyncIO->connect(ANF2OutPortName, j*AXIS_REG_OFFSET, &pasynUserOutReg_[j], NULL);
}
if (status) {
asynPrint(this->pasynUserSelf, ASYN_TRACE_ERROR,
"%s: cannot connect to ANF2 controller\n",
functionName);
}
/* Create the poller thread for this controller (do 2 forced-fast polls)
* NOTE: at this point the axis objects don't yet exist, but the poller tolerates this */
//startPoller(movingPollPeriod, idlePollPeriod, 2);
}
/** Creates a new ANF2Controller object.
* Configuration command, called directly or from iocsh
* \param[in] portName The name of the asyn port that will be created for this driver
* \param[in] ANF2InPortName The name of the drvAsynIPPPort that was created previously to connect to the ANF2 controller
* \param[in] ANF2OutPortName The name of the drvAsynIPPPort that was created previously to connect to the ANF2 controller
* \param[in] numAxes The number of axes on the controller stack
*/
extern "C" int ANF2CreateController(const char *portName, const char *ANF2InPortName, const char *ANF2OutPortName, int numAxes)
{
// Enforce max values
if (numAxes > MAX_AXES) {
numAxes = MAX_AXES;
}
new ANF2Controller(portName, ANF2InPortName, ANF2OutPortName, numAxes);
return(asynSuccess);
}
/** Starts the poller for a given controller
* \param[in] ANF2Name The name of the asyn port that for the controller
* \param[in] movingPollPeriod The time in ms between polls when any axis is moving
* \param[in] idlePollPeriod The time in ms between polls when no axis is moving
*/
extern "C" asynStatus ANF2StartPoller(const char *ANF2Name, int movingPollPeriod, int idlePollPeriod)
{
ANF2Controller *pC;
static const char *functionName = "ANF2StartPoller";
pC = (ANF2Controller*) findAsynPortDriver(ANF2Name);
if (!pC) {
printf("%s:%s: Error port %s not found\n",
driverName, functionName, ANF2Name);
return asynError;
}
pC->lock();
pC->doStartPoller(movingPollPeriod/1000.0, idlePollPeriod/1000.0);
pC->unlock();
return asynSuccess;
}
void ANF2Controller::doStartPoller(double movingPollPeriod, double idlePollPeriod)
{
//
movingPollPeriod_ = movingPollPeriod;
idlePollPeriod_ = idlePollPeriod;
//
startPoller(movingPollPeriod_, idlePollPeriod_, 2);
}
/** Reports on status of the driver
* \param[in] fp The file pointer on which report information will be written
* \param[in] level The level of report detail desired
*
* If details > 0 then information is printed about each axis.
* After printing controller-specific information it calls asynMotorController::report()
*/
void ANF2Controller::report(FILE *fp, int level)
{
int i, j;
ANF2Axis* pAxis[MAX_AXES];
fprintf(fp, "====================================\n");
fprintf(fp, "ANF2 motor driver:\n");
fprintf(fp, " asyn port: %s\n", this->portName);
fprintf(fp, " num axes: %i\n", numAxes_);
fprintf(fp, " axes created: %i\n", axesCreated_);
fprintf(fp, " moving poll period: %lf\n", movingPollPeriod_);
fprintf(fp, " idle poll period: %lf\n", idlePollPeriod_);
fprintf(fp, "\n");
fprintf(fp, "Input registers:\n\n");
for (j=0; j<numAxes_; j++) {
pAxis[j] = getAxis(j);
pAxis[j]->getInfo();
}
fprintf(fp, " Reg\t");
for (j=0; j<numAxes_; j++) {
fprintf(fp, "Axis %i\t", j);
}
fprintf(fp, "\n");
for (i=0; i<MAX_INPUT_REGS; i++) {
fprintf(fp, " %i\t", i);
for (j=0; j<numAxes_; j++) {
fprintf(fp, "0x%04x\t", pAxis[j]->inputReg_[i]);
}
fprintf(fp, "\n");
}
fprintf(fp, "\n");
/*for (i=0; i<MAX_INPUT_REGS; i++) {
fprintf(fp, " reg %i, pasynUserInReg_[%i][%i]=0x%x\n", i, j, i, pasynUserInReg_[j][i]);
}*/
// Call the base class method
asynMotorController::report(fp, level);
fprintf(fp, "====================================\n");
}
/** Returns a pointer to an ANF2Axis object.
* Returns NULL if the axis number encoded in pasynUser is invalid.
* \param[in] pasynUser asynUser structure that encodes the axis index number. */
ANF2Axis* ANF2Controller::getAxis(asynUser *pasynUser)
{
// ? return static_cast<ANF2Axis*>(asynMotorController::getAxis(pANF2Axis methodsasynUser));
return static_cast<ANF2Axis*>(asynMotorController::getAxis(pasynUser));
}
/** Returns a pointer to an ANF2Axis object.
* Returns NULL if the axis number encoded in pasynUser is invalid.
* \param[in] No Axis index number. */
ANF2Axis* ANF2Controller::getAxis(int axisNo)
{
return static_cast<ANF2Axis*>(asynMotorController::getAxis(axisNo));
}
/** Called when asyn clients call pasynInt32->write().
* Extracts the function and axis number from pasynUser.
* Sets the value in the parameter library (?)
*
* If the function is ANF2Jerk_ it sets the jerk value in the controller.
* Calls any registered callbacks for this pasynUser->reason and address.
*
* For all other functions it calls asynMotorController::writeInt32.
* \param[in] pasynUser asynUser structure that encodes the reason and address.
* \param[in] value Value to write. */
asynStatus ANF2Controller::writeInt32(asynUser *pasynUser, epicsInt32 value)
{
int function = pasynUser->reason;
asynStatus status = asynSuccess;
ANF2Axis *pAxis = getAxis(pasynUser);
static const char *functionName = "writeInt32";
/* Set the parameter and readback in the parameter library. */
status = setIntegerParam(pAxis->axisNo_, function, value);
if (function == ANF2ResetErrors_)
{
// Only reset errors when value is 1
if (value == 1) {
printf("ANF2Controller:writeInt32: Resetting errors for axis = %d\n", pAxis->axisNo_);
pAxis->resetErrors();
}
} else if (function == ANF2GetInfo_)
{
// Only get info when value is 1
if (value == 1) {
printf("ANF2Controller:writeInt32: Getting info for axis = %d\n", pAxis->axisNo_);
pAxis->getInfo();
}
/*
} else if (function == ANF2Reconfig_)
{
// reconfig regardless of the value
pAxis->reconfig(value);
*/
} else {
// Call base class method
status = asynMotorController::writeInt32(pasynUser, value);
}
/* Do callbacks so higher layers see any changes */
pAxis->callParamCallbacks();
if (status)
asynPrint(pasynUser, ASYN_TRACE_ERROR,
"%s:%s: error, status=%d function=%d, value=%d\n",
driverName, functionName, status, function, value);
else
asynPrint(pasynUser, ASYN_TRACEIO_DRIVER,
"%s:%s: function=%d, value=%d\n",
driverName, functionName, function, value);
return status;
}
asynStatus ANF2Controller::writeReg32Array(int axisNo, epicsInt32* output, int nElements, double timeout)
{
asynStatus status;
ANF2Axis *pAxis = getAxis(axisNo);
static const char *functionName = "ANF2Controller::writeReg32Array";
// This message isn't very helpful. Print something better in the future.
asynPrint(pAxis->pasynUser_, ASYN_TRACEIO_DRIVER,
"%s: axisNo=%i, nElements=%d\n",
functionName, axisNo, nElements);
status = pasynInt32ArraySyncIO->write(pasynUserOutReg_[axisNo], output, nElements, timeout);
return status;
}
asynStatus ANF2Controller::readReg16(int axisNo, int axisReg, epicsInt32 *input, double timeout)
{
asynStatus status;
//printf("axisReg = %d\n", axisReg);
//asynPrint(this->pasynUserSelf, ASYN_TRACEIO_DRIVER,"readReg16 reg = %d\n", axisReg);
status = pasynInt32SyncIO->read(pasynUserInReg_[axisNo][axisReg], input, timeout);
return status ;
}
asynStatus ANF2Controller::readReg32(int axisNo, int axisReg, epicsInt32 *combo, double timeout)
{
asynStatus status;
epicsInt32 lowerWord32, upperWord32; // only have pasynInt32SyncIO, not pasynInt16SyncIO ,
//printf("calling readReg16\n");
status = readReg16(axisNo, axisReg, &upperWord32, timeout); //get Upper Word
axisReg++;
status = readReg16(axisNo, axisReg, &lowerWord32, timeout); //get Lower Word
*combo = NINT((upperWord32 << 16) | lowerWord32);
return status ;
}
// ANF2Axis methods Here
// These are the ANF2Axis methods
/** Creates a new ANF2Axis object.
* \param[in] pC Pointer to the ANF2Controller to which this axis belongs.
* \param[in] axisNo Index number of this axis, range 0 to pC->numAxes_-1.
*
* Initializes register numbers, etc.
*/
ANF2Axis::ANF2Axis(ANF2Controller *pC, int axisNo, epicsInt32 config, epicsInt32 baseSpeed, epicsInt32 homingTimeout)
: asynMotorAxis(pC, axisNo),
pC_(pC)
{
int status;
axisNo_ = axisNo;
config_ = config;
baseSpeed_ = baseSpeed;
homingTimeout_ = homingTimeout;
// These registers will always be zero
zeroRegisters(zeroReg_);
status = pasynInt32SyncIO->connect(pC_->inputDriver_, axisNo_*AXIS_REG_OFFSET, &pasynUserForceRead_, "MODBUS_READ");
if (status) {
//printf("%s:%s: Error, unable to connect pasynUserForceRead_ to Modbus input driver %s\n", pC_->inputDriver_, pC_->functionName, myModbusInputDriver);
printf("%s: Error, unable to connect pasynUserForceRead_ to Modbus input driver\n", pC_->inputDriver_);
}
/* TODO:
* reduce the sleeps to see which ones are necessary
* make reconfig useful?
*/
epicsThreadSleep(0.1);
// Clear the command/configuration register (a good thing to do but doesn't appear to be necessary)
//status = pC_->writeReg32Array(axisNo_, zeroReg_, 5, DEFAULT_CONTROLLER_TIMEOUT);
// Delay
//epicsThreadSleep(0.05);
// These registers will always have the last config that was sent to the controller
zeroRegisters(confReg_);
// Send the configuration (array)
// assemble the configuration bits; set the start speed to a non-zero value (100), which is required for the configuration to be accepted
confReg_[CONFIGURATION] = config;
confReg_[BASE_SPEED] = baseSpeed;
confReg_[HOME_TIMEOUT] = homingTimeout << 16;
// Write all the registers
status = pC_->writeReg32Array(axisNo_, confReg_, 5, DEFAULT_CONTROLLER_TIMEOUT);
// Delay
epicsThreadSleep(0.05);
// Parse the configuration (mostly for asynReport purposes)
// MSW
CaptInput_ = (config & (0x1 << 16)) >> 16;
ExtInput_ = (config & (0x2 << 16)) >> 17;
HomeInput_ = (config & (0x4 << 16)) >> 18;
CWInput_ = (config & (0x18 << 16)) >> 19;
CCWInput_ = (config & (0x60 << 16)) >> 21;
BHPO_ = (config & (0x80 << 16)) >> 23;
QuadEnc_ = (config & (0x100 << 16)) >> 24;
DiagFbk_ = (config & (0x200 << 16)) >> 25;
OutPulse_ = (config & (0x400 << 16)) >> 26;
HomeOp_ = (config & (0x800 << 16)) >> 27;
CardAxis_ = (config & (0x4000 << 16)) >> 30;
OpMode_ = (epicsUInt32)(config & (0x8000 << 16)) >> 31;
// LSW
CaptInputAS_ = config & 0x1;
ExtInputAS_ = (config & 0x2) >> 1;
HomeInputAS_ = (config & 0x4) >> 2;
CWInputAS_ = (config & 0x8) >> 3;
CCWInputAS_ = (config & 0x10) >> 4;
// Only allow UEIP to be used if the axis is configured to have a quadrature encoder
if ((QuadEnc_ != 0x0) || (DiagFbk_ != 0x0)) {
setIntegerParam(pC_->motorStatusHasEncoder_, 1);
} else {
setIntegerParam(pC_->motorStatusHasEncoder_, 0);
}
// set position to 0 to clear the "position invalid" status that results from configuring the axis
setPosition(0);
// Tell asynMotor device support the position is zero so that autosave will restore the saved position (doesn't appear to be necessary)
//setDoubleParam(pC_->motorPosition_, 0.0);
// Delay
//epicsThreadSleep(1.0);
// Initialize parameters to avoid ASYN_TRACE_FLOW errors
setIntegerParam(pC_->motorStatusDirection_, 1);
// The following are necessary after this commit:
// https://github.com/epics-modules/motor/commit/36dfab4a78725866fab5bd212c4c128a86e9f044
setIntegerParam(pC_->motorPowerAutoOnOff_, 0);
setDoubleParam(pC_->motorPowerOnDelay_, 0.0);
setDoubleParam(pC_->motorPowerOffDelay_, 0.0);
// Tell the driver the axis has been created
pC_->axesCreated_ += 1;
//epicsThreadSleep(1.0);
}
/*
Configuration Bits:
0x1 - Caputure Input (0 = Disabled, 1 = Enabled)
0x2 - External Input (0 = Disabled, 1 = Enabled)
0x4 - Home Input (0 = Disabled, 1 = Enabled)
0x8 -
*/
extern "C" asynStatus ANF2CreateAxis(const char *ANF2Name, /* specify which controller by port name */
int axis, /* axis number 0-1 */
const char *hexConfig, /* desired configuration in hex */
epicsInt32 baseSpeed, /* base speed */
epicsInt32 homingTimeout) /* homing timeout */
{
ANF2Controller *pC;
epicsInt32 config;
static const char *functionName = "ANF2CreateAxis";
pC = (ANF2Controller*) findAsynPortDriver(ANF2Name);
if (!pC) {
printf("%s:%s: Error port %s not found\n",
driverName, functionName, ANF2Name);
return asynError;
}
errno = 0;
config = strtoul(hexConfig, NULL, 16);
if (errno != 0) {
printf("%s:%s: Error invalid config=%s\n",
driverName, functionName, hexConfig);
return asynError;
} else {
printf("%s:%s: Config=0x%x\n",
driverName, functionName, config);
}
// baseSpeed is steps/second (1-1,000,000)
if (baseSpeed < 1) {
baseSpeed = 1;
}
if (baseSpeed > 1000000) {
baseSpeed = 1000000;
}
// homingTimeout is seconds (0-300)
if (homingTimeout < 0) {
homingTimeout = 0;
}
if (homingTimeout > 300) {
homingTimeout = 300;
}
pC->lock();
new ANF2Axis(pC, axis, config, baseSpeed, homingTimeout);
pC->unlock();
return asynSuccess;
}
void ANF2Axis::zeroRegisters(epicsInt32 *reg)
{
int i;
for(i=0; i<5; i++)
{
reg[i] = 0x0;
}
}
asynStatus ANF2Axis::resetErrors()
{
asynStatus status;
epicsInt32 errorReg[5];
static const char *functionName = "ANF2Axis::resetErrors";
asynPrint(pasynUser_, ASYN_TRACEIO_DRIVER, "%s: axisNo=%i\n", functionName, axisNo_);
zeroRegisters(errorReg);
errorReg[COMMAND] = 0x800 << 16;
// Send the reset error command
status = pC_->writeReg32Array(axisNo_, errorReg, 5, DEFAULT_CONTROLLER_TIMEOUT);
return status;
}
void ANF2Axis::getInfo()
{
asynStatus status;
int i;
// For a read (not sure why this is necessary)
status = pasynInt32SyncIO->write(pasynUserForceRead_, 1, DEFAULT_CONTROLLER_TIMEOUT);
//printf("Registers for axis %i:\n", axisNo_);
for( i=0; i<MAX_INPUT_REGS; i++)
{
status = pC_->readReg16(axisNo_, i, &inputReg_[i], DEFAULT_CONTROLLER_TIMEOUT);
//printf(" status=%d, register=%i, val=0x%x\n", status, i, inputReg_[i]);
}
}
/*
// reconfig was used during development. It won't be generally useful without effort.
// It isn't obvious that this is a feature that should exist on-the-fly
void ANF2Axis::reconfig(epicsInt32 value)
{
asynStatus status;
epicsInt32 confReg[5];
// TODO: modify this to use the base speed from the parameter, and instead accept a string for a new config
printf("Reconfiguring axis %i\n", axisNo_);
// Clear the command/configuration register
status = pC_->writeReg32Array(axisNo_, zeroReg_, 5, DEFAULT_CONTROLLER_TIMEOUT);
// Construct the new config
zeroRegisters(confReg);
confReg[CONFIGURATION] = 0x86000000;
confReg[BASE_SPEED] = 0x00000064;
//confReg[HOME_TIMEOUT] = 0x0;
//confReg[CONFIG_REG_3] = 0x0;
//confReg[CONFIG_REG_4] = 0x0;
epicsThreadSleep(0.05);
// Send the new config
status = pC_->writeReg32Array(axisNo_, confReg_, 5, DEFAULT_CONTROLLER_TIMEOUT);
epicsThreadSleep(0.05);
// Set the position to clear the invalid position error
setPosition(value);
epicsThreadSleep(0.05);
}
*/
/** Reports on status of the axis
* \param[in] fp The file pointer on which report information will be written
* \param[in] level The level of report detail desired
*
* After printing device-specific information calls asynMotorAxis::report()
*/
void ANF2Axis::report(FILE *fp, int level)
{
// TODO: make this more useful
if (level > 0) {
fprintf(fp, "Configuration for axis %i [0x%x]:\n", axisNo_, config_);
fprintf(fp, " Base Speed: %i\n", baseSpeed_);
fprintf(fp, " Homing Timeout: %i\n", homingTimeout_);
fprintf(fp, " Capture Input: %i (Active State: %i)\n", CaptInput_, CaptInputAS_);
fprintf(fp, " External Input: %i (Active State: %i)\n", ExtInput_, ExtInputAS_);
fprintf(fp, " Home Input: %i (Active State: %i)\n", HomeInput_, HomeInputAS_);
fprintf(fp, " CW Input: %i (Active State: %i)\n", CWInput_, CWInputAS_);
fprintf(fp, " CCW Input: %i (Active State: %i)\n", CCWInput_, CCWInputAS_);
fprintf(fp, " Backplane Home Proximity Operation: %i\n", BHPO_);
fprintf(fp, " Quadrature Encoder: %i\n", QuadEnc_);
fprintf(fp, " Diagnostic Feedback: %i\n", DiagFbk_);
fprintf(fp, " Output Pulse Type: %i\n", OutPulse_);
fprintf(fp, " Home Operation: %i\n", HomeOp_);
fprintf(fp, " Card Axis: %i\n", CardAxis_);
fprintf(fp, " Operation Mode for Axis: %i\n", OpMode_);
fprintf(fp, "\n");
}
//printf("ANF2Axis::report -> BEFORE asynMotorAxis::report!!\n");
// Call the base class method
asynMotorAxis::report(fp, level);
//printf("ANF2Axis::report -> AFTER asynMotorAxis::report!!\n");
}
// SET VEL & ACCEL
asynStatus ANF2Axis::sendAccelAndVelocity(double acceleration, double velocity)
{
// static const char *functionName = "ANF2Axis::sendAccelAndVelocity";
// ANF2 speed range is 1 to 1,000,000 steps/sec
if (velocity > 1000000.0) {
velocity = 1000000.0;
}
if (velocity < 1.0) {
velocity = 1.0;
}
// Set the velocity register
motionReg_[SPEED] = NINT(velocity);
// ANF2 acceleration range 1 to 2000 steps/ms/sec
// Therefore need to limit range received by motor record from 1000 to 2e6 steps/sec/sec
if (acceleration < 1000.0) {
//printf("Acceleration is < 1000: %lf\n", acceleration);
acceleration = 1000.0;
}
if (acceleration > 2000000.0) {
//printf("Acceleration is > 2000: %lf\n", acceleration);
acceleration = 2000000.0;
}
// Set the accel/decel register
motionReg_[ACCEL_DECEL] = (NINT(acceleration/1000.0) << 16) | (NINT(acceleration/1000.0));
return asynSuccess;
}
/*
* This driver only sets the base speed at initialization when the configuration is sent.
* It is possible that the base speed (VBAS) in the motor record is inconsistent with the
* base speed set at initialization, since there is no way for an asyn motor driver to force
* the base speed to be reset when a user changes it. The resulting acceleration calculated
* by the motor record is likely to be incorrect. The following method calculates the
* acceleration that will give the correct acceleration time (ACCL) for the base speed that
* was specified at initialization.
*/
double ANF2Axis::correctAccel(double minVelocity, double maxVelocity, double acceleration)
{
double accelTime;
double newAccel;
static const char *functionName = "ANF2Axis::correctAccel";
accelTime = (maxVelocity - minVelocity) / acceleration;
newAccel = (maxVelocity - (double)baseSpeed_) / accelTime;
asynPrint(pasynUser_, ASYN_TRACEIO_DRIVER,
"%s: axisNo=%i, old acceleration=%lf, new acceleration=%lf\n",
functionName, axisNo_, acceleration, newAccel);
return newAccel;
}
// MOVE
asynStatus ANF2Axis::move(double position, int relative, double minVelocity, double maxVelocity, double acceleration)
{
asynStatus status;
epicsInt32 posInt;
static const char *functionName = "ANF2Axis::move";
asynPrint(pasynUser_, ASYN_TRACEIO_DRIVER,
"%s: axisNo=%i, relative=%i, minVelocity=%f, maxVelocity=%f, acceleration=%f\n",
functionName, axisNo_, relative, minVelocity, maxVelocity, acceleration);
// Clear the command/configuration register
status = pC_->writeReg32Array(axisNo_, zeroReg_, 5, DEFAULT_CONTROLLER_TIMEOUT);
epicsThreadSleep(0.05);
// Clear the motition registers
zeroRegisters(motionReg_);
// Correct the acceleration
acceleration = correctAccel(minVelocity, maxVelocity, acceleration);
// This sets indices 2 & 3 of motionReg_
status = sendAccelAndVelocity(acceleration, maxVelocity);
posInt = NINT(position);
if (relative) {
//printf(" ** relative move called\n");
// Set position and cmd registers
motionReg_[COMMAND] = 0x2 << 16;
motionReg_[POSITION] = posInt;
} else {
//printf(" ** absolute move called\n");
// Set position and cmd registers
motionReg_[COMMAND] = 0x1 << 16;
motionReg_[POSITION] = posInt;
}
//printf(" ** position = %d\n", posInt);
// The final registers are zero for absolute and relative moves (this shouldn't be necessary--DELETEME)
motionReg_[CMD_REG_4] = 0x0;
// Write all the registers atomically
// The number of elements refers to the number of epicsInt32s registers_
status = pC_->writeReg32Array(axisNo_, motionReg_, 5, DEFAULT_CONTROLLER_TIMEOUT);
// Delay the first status read, give the controller some time to return moving status
epicsThreadSleep(0.05);
return status;
}
// HOME (needs work)
asynStatus ANF2Axis::home(double minVelocity, double maxVelocity, double acceleration, int forwards)
{
asynStatus status;
static const char *functionName = "ANF2Axis::home";
asynPrint(pasynUser_, ASYN_TRACEIO_DRIVER,
"%s: axisNo=%i, forwards=%i, minVelocity=%f, maxVelocity=%f, acceleration=%f\n",
functionName, axisNo_, forwards, minVelocity, maxVelocity, acceleration);
// Clear the command/configuration register
status = pC_->writeReg32Array(axisNo_, zeroReg_, 5, DEFAULT_CONTROLLER_TIMEOUT);
epicsThreadSleep(0.05);
// Clear the motition registers
zeroRegisters(motionReg_);
// Correct the acceleration
acceleration = correctAccel(minVelocity, maxVelocity, acceleration);
// This sets indices 2 & 3 of motionReg_
status = sendAccelAndVelocity(acceleration, maxVelocity);
// Note: if the home input is active when the home command is sent, the axis will appear to move in the wrong direction
if (forwards) {
printf(" ** HOMING FORWARDS **\n");
// The +Find Home (CW) command
motionReg_[COMMAND] = 0x20 << 16;
} else {
printf(" ** HOMING REVERSE **\n");
// The -Find Home (CCW) command
motionReg_[COMMAND] = 0x40 << 16;
}
// Write all the registers atomically
status = pC_->writeReg32Array(axisNo_, motionReg_, 5, DEFAULT_CONTROLLER_TIMEOUT);
return status;
}
// JOG
asynStatus ANF2Axis::moveVelocity(double minVelocity, double maxVelocity, double acceleration)
{
asynStatus status;
//int velo, distance;
static const char *functionName = "ANF2Axis::moveVelocity";
asynPrint(pasynUser_, ASYN_TRACEIO_DRIVER,
"%s: axisNo=%d, minVelocity=%f, maxVelocity=%f, acceleration=%f\n",
functionName, axisNo_, minVelocity, maxVelocity, acceleration);
//
// The jog command requires a different stop than a move command
// Set a jogging flag
jogging_ = true;
// Clear the command/configuration register
status = pC_->writeReg32Array(axisNo_, zeroReg_, 5, DEFAULT_CONTROLLER_TIMEOUT);
epicsThreadSleep(0.05);
// Clear the motition registers
zeroRegisters(motionReg_);
// Note: the jog acceleration doesn't need to be corrected; the JAR field has units of egu/s/s
if (maxVelocity > 0.0) {
//printf(" ** positive jog called\n");
// Set cmd register
motionReg_[COMMAND] = 0x80 << 16;
// Do nothing to the velocity
} else {
//printf(" ** negative jog called\n");
// Set cmd register
motionReg_[COMMAND] = 0x100 << 16;
// ANF2 only accepts speeds > 0
maxVelocity = fabs(maxVelocity);
}
// This sets indices 2 & 3 of motionReg_
status = sendAccelAndVelocity(acceleration, maxVelocity);
// Write all the registers atomically
status = pC_->writeReg32Array(axisNo_, motionReg_, 5, DEFAULT_CONTROLLER_TIMEOUT);
//
/*
velo = NINT(fabs(maxVelocity));
// Simulate a jog like the ANG1 driver does. Move 1 million steps
distance = 1000000;
if (maxVelocity > 0.) {
// This is a positive move in ANF2 coordinates
//printf(" ** relative move (JOG pos) called\n");
status = move(distance, 0, minVelocity, velo, acceleration);
} else {
// This is a negative move in ANF2 coordinates
//printf(" ** relative move (JOG neg) called\n");
status = move((distance * -1.0), 0, minVelocity, velo, acceleration);
}
*/
// Delay the first status read, give the controller some time to return moving status
epicsThreadSleep(0.05);
return status;
}
// STOP
asynStatus ANF2Axis::stop(double acceleration)
{
asynStatus status;
epicsInt32 stopReg;
static const char *functionName = "ANF2Axis::stop";
asynPrint(pasynUser_, ASYN_TRACEIO_DRIVER, "%s: axisNo=%i\n", functionName, axisNo_);
//printf("\n STOP \n\n");
// The stop commands ignore all 32-bit registers beyond the first
// Clear the command/configuration register (this causes a jog to stop)
status = pC_->writeReg32Array(axisNo_, zeroReg_, 1, DEFAULT_CONTROLLER_TIMEOUT);
if (jogging_ == false)
{
//printf("stopping a normal move\n");
// The immediate stop command cuts the pulses off without any deceleration and causes the position to become invalid
//stopReg = 0x10 << 16; // Immediate stop
// Hold move works very well with normal moves
stopReg = 0x4 << 16; // Hold move
// This causes a normal move to stop
status = pC_->writeReg32Array(axisNo_, &stopReg, 1, DEFAULT_CONTROLLER_TIMEOUT);
// Clear the command/configuration register
//status = pC_->writeReg32Array(axisNo_, zeroReg_, 5, DEFAULT_CONTROLLER_TIMEOUT);
} else {
// Reset the jogging flag (assume the stop was successful)
//printf("resetting the jog flag\n");
jogging_ = false;
}
return status;
}
// SET
asynStatus ANF2Axis::setPosition(double position)
{
asynStatus status;
epicsInt32 set_position;
epicsInt32 posReg[5];
static const char *functionName = "ANF2Axis::setPosition";
asynPrint(pasynUser_, ASYN_TRACEIO_DRIVER, "%s: axisNo=%i, position=%lf\n", functionName, axisNo_, position);
// Clear the command/configuration register
status = pC_->writeReg32Array(axisNo_, zeroReg_, 5, DEFAULT_CONTROLLER_TIMEOUT);
epicsThreadSleep(0.1);
set_position = NINT(position);
zeroRegisters(posReg);
posReg[COMMAND] = 0x200 << 16;
posReg[POSITION] = set_position;
// Write all the registers atomically
status = pC_->writeReg32Array(axisNo_, posReg, 5, DEFAULT_CONTROLLER_TIMEOUT);
// Can this delay be shorter?
epicsThreadSleep(0.2);
// The ANG1 driver does this; do we need to?
// Clear the command/configuration register
//status = pC_->writeReg32Array(axisNo_, zeroReg_, 5, DEFAULT_CONTROLLER_TIMEOUT);
return status;
}
// ENABLE TORQUE
asynStatus ANF2Axis::setClosedLoop(bool closedLoop)
{
//asynStatus status;
//epicsInt32 clReg[5];
//static const char *functionName = "ANF2Axis::setClosedLoop";
// The ANF2 doesn't have a closed-loop enable/disable command, so do nothing.
// The configuration of an axis:
// * can be changed so that an axis is disabled, but that doesn't disable torque
// * can be changed to disable the use of encoder inputs, but that isn't currently allowed on-the-fly
/*printf(" ** setClosedLoop called \n");
if (closedLoop) {
printf("setting enable true\n");
setIntegerParam(pC_->motorStatusPowerOn_, 1);
} else {
printf("setting disable false\n");
setIntegerParam(pC_->motorStatusPowerOn_, 0);
}
return status;*/
return asynSuccess;
}
// POLL
/** Polls the axis.
* This function reads motor position, limit status, home status, and moving status
* It calls setIntegerParam() and setDoubleParam() for each item that it polls,
* and then calls callParamCallbacks() at the end.
* \param[out] moving A flag that is set indicating that the axis is moving (true) or done (false). */
asynStatus ANF2Axis::poll(bool *moving)
{
int done;
int lowLimit;
int highLimit;
int enabled;
int cmdError;
int direction;
double position;
double encPosition;
asynStatus status;
epicsInt32 read_val; // don't use a pointer here. The _address_ of read_val should be passed to the read function.
// Don't do any polling until ALL the axes have been created; this ensures that we don't interpret the configuration values as command values
// This is probably not necessary now that the poller can be started after iocInit
if (pC_->axesCreated_ != pC_->numAxes_) {
*moving = false;
return asynSuccess;
}
// Force a read operation
//printf(" . . . . . Calling pasynInt32SyncIO->write\n");
//printf("Calling pasynInt32SyncIO->write(pasynUserForceRead_, 1, TIMEOUT), pasynUserForceRead_->reason=%d\n", pasynUserForceRead_->reason);
status = pasynInt32SyncIO->write(pasynUserForceRead_, 1, DEFAULT_CONTROLLER_TIMEOUT);
//printf(" . . . . . status = %d\n", status);
// if status goto end
// Read the current motor position
status = pC_->readReg32(axisNo_, POS_RD_UPR, &read_val, DEFAULT_CONTROLLER_TIMEOUT);
//printf("ANF2Axis::poll: Motor position raw: %d\n", read_val);
position = (double) read_val;
setDoubleParam(pC_->motorPosition_, position);
//printf("ANF2Axis::poll: Motor #%i position: %f\n", axisNo_, position);
// Read encoder position
status = pC_->readReg32(axisNo_, EN_POS_UPR, &read_val, DEFAULT_CONTROLLER_TIMEOUT);
//printf("ANF2Axis::poll: Motor encoder position raw: %d\n", read_val);
encPosition = (double) read_val;
setDoubleParam(pC_->motorEncoderPosition_, encPosition);
//printf("ANF2Axis::poll: Motor #%i encoder position: %f\n", axisNo_, encPosition);
// Read the moving status of this motor
//
status = pC_->readReg16(axisNo_, STATUS_1, &read_val, DEFAULT_CONTROLLER_TIMEOUT);
//printf("status 1 is 0x%X\n", read_val);
// Done logic
done = ((read_val & 0x8) >> 3); // status word 1 bit 3 set to 1 when the motor is not in motion.
setIntegerParam(pC_->motorStatusDone_, done);
*moving = done ? false:true;
//printf("done is %d\n", done);
// Initialize the direction bit to the last value
status = pC_->getIntegerParam(pC_->motorStatusDirection_, &direction);
// Direction (only set the direction of the controller is moving)
if (!done) {
if (read_val & 0x1) {
direction = 1;
}
if ((read_val & 0x2) >> 1) {
direction = 0;
}
setIntegerParam(pC_->motorStatusDirection_, direction);
}
// Check for command errors
cmdError = (read_val & 0x1000) ? 1 : 0;
// Check for enable/disable (not actually the torque status) and set accordingly.
// Enable/disable is determined by the configuration and it isn't obvious why one would disable an axis.
enabled = (read_val & 0x4000);
if (enabled)
setIntegerParam(pC_->motorStatusPowerOn_, 1);
else
setIntegerParam(pC_->motorStatusPowerOn_, 0);
// Read the limit status
//
status = pC_->readReg16(axisNo_, STATUS_2, &read_val, DEFAULT_CONTROLLER_TIMEOUT);
//printf("status 2 is 0x%X\n", read_val);
// Set the high limit only when moving in the positive direction
highLimit = (read_val & 0x8) ? (direction & 1) : 0; // a cw limit has been reached
setIntegerParam(pC_->motorStatusHighLimit_, highLimit);
//printf("+limit %d\n", highLimit);
// Set the low limit only when moving in the negative direction
lowLimit = (read_val & 0x10) ? (!direction & 1) : 0; // a ccw limit has been reached
setIntegerParam(pC_->motorStatusLowLimit_, lowLimit);
//printf("-limit %d\n", lowLimit);
// Clear command errors so we can attempt to move again
if (cmdError) {
printf("poll: resetting errors\n");
resetErrors();
}
// Should be in init routine? Allows CNEN to be used.
setIntegerParam(pC_->motorStatusGainSupport_, 1);
// Notify asynMotorController polling routine that we're ready
callParamCallbacks();
return status;
}
/** Code for iocsh registration */
/* ANF2CreateController */
static const iocshArg ANF2CreateControllerArg0 = {"Port name", iocshArgString};
static const iocshArg ANF2CreateControllerArg1 = {"ANF2 In port name", iocshArgString};
static const iocshArg ANF2CreateControllerArg2 = {"ANF2 Out port name", iocshArgString};
static const iocshArg ANF2CreateControllerArg3 = {"Number of axes", iocshArgInt};
static const iocshArg * const ANF2CreateControllerArgs[] = {&ANF2CreateControllerArg0,
&ANF2CreateControllerArg1,
&ANF2CreateControllerArg2,
&ANF2CreateControllerArg3};
static const iocshFuncDef ANF2CreateControllerDef = {"ANF2CreateController", 4, ANF2CreateControllerArgs};
static void ANF2CreateControllerCallFunc(const iocshArgBuf *args)
{
ANF2CreateController(args[0].sval, args[1].sval, args[2].sval, args[3].ival);
}
/* ANF2StartPoller */
static const iocshArg ANF2StartPollerArg0 = {"Port name", iocshArgString};
static const iocshArg ANF2StartPollerArg1 = {"Moving poll period (ms)", iocshArgInt};
static const iocshArg ANF2StartPollerArg2 = {"Idle poll period (ms)", iocshArgInt};
static const iocshArg * const ANF2StartPollerArgs[] = {&ANF2StartPollerArg0,
&ANF2StartPollerArg1,
&ANF2StartPollerArg2};
static const iocshFuncDef ANF2StartPollerDef = {"ANF2StartPoller", 3, ANF2StartPollerArgs};
static void ANF2StartPollerCallFunc(const iocshArgBuf *args)
{
ANF2StartPoller(args[0].sval, args[1].ival, args[2].ival);
}
/* ANF2CreateAxis */
static const iocshArg ANF2CreateAxisArg0 = {"Port name", iocshArgString};
static const iocshArg ANF2CreateAxisArg1 = {"Axis number", iocshArgInt};
static const iocshArg ANF2CreateAxisArg2 = {"Hex config", iocshArgString};
static const iocshArg ANF2CreateAxisArg3 = {"Base speed", iocshArgInt};
static const iocshArg ANF2CreateAxisArg4 = {"Homing timeout", iocshArgInt};
static const iocshArg * const ANF2CreateAxisArgs[] = {&ANF2CreateAxisArg0,
&ANF2CreateAxisArg1,
&ANF2CreateAxisArg2,
&ANF2CreateAxisArg3,
&ANF2CreateAxisArg4};
static const iocshFuncDef ANF2CreateAxisDef = {"ANF2CreateAxis", 5, ANF2CreateAxisArgs};
static void ANF2CreateAxisCallFunc(const iocshArgBuf *args)
{
ANF2CreateAxis(args[0].sval, args[1].ival, args[2].sval, args[3].ival, args[4].ival);
}
static void ANF2Register(void)
{
iocshRegister(&ANF2CreateControllerDef, ANF2CreateControllerCallFunc);
iocshRegister(&ANF2StartPollerDef, ANF2StartPollerCallFunc);
iocshRegister(&ANF2CreateAxisDef, ANF2CreateAxisCallFunc);
}
extern "C" {
epicsExportRegistrar(ANF2Register);
}
View Git Blame Copy Permalink