/* 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 #include #include #include #include #include #include #include #include #include "ANF2Driver.h" #include #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; jconnect(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; jgetInfo(); } fprintf(fp, " Reg\t"); for (j=0; jinputReg_[i]); } fprintf(fp, "\n"); } fprintf(fp, "\n"); /*for (i=0; i(asynMotorController::getAxis(pANF2Axis methodsasynUser)); return static_cast(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(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; ireadReg16(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); }