Calibration

Overview

This group defines all required functions to calibrate dosing units or to set the internal position counter of devices to a defined state.

Collaboration diagram for Calibration:

Functions
long	NemCalibrate (TNemesys *Nemesys, uint32_t Velocity)
	Execute reference move (homing move) for single dosing unit. More...
long	NemRestorePos (TNemesys *Nemesys, int32_t dwPos)
	Restore position value. More...

Function Documentation

long NemCalibrate	(	TNemesys *	Nemesys,
		uint32_t	Velocity
	)

Execute reference move (homing move) for single dosing unit.

If the device executes an reference move, then the pusher is moved towards the lower limit sensor.

Parameters

[in]	Nemesys	Device to calibrate
[in]	Velocity	Speed of calibbration move in mrpm (millirevolutions per minute)

Returns

Error code - ERR_NOERR indicates success

{
    long    Result;

    //
    // Set operation mode to homing mode
    //
    Result = Nem_SetOpMode(Nemesys, NEM_OP_MODE_HOMING);
    if (ERR_NOERR != Result)
    {
        return Result;
    }

    //
    // set homing mode
    //
    Result = Nem_SetHomingMode(Nemesys, HM_POS_LIM);
    if (ERR_NOERR != Result)
    {
        return Result;
    }

    //
    // set homing speed in mrpm/min
    //
    Result = Nem_SetHomingSpeed(Nemesys, Velocity);
    if (ERR_NOERR != Result)
    {
        return Result;
    }

    //
    // After calibration the position counter should contain the value 0
    //
    Result = Nem_SetHomePos(Nemesys, 0);
    if (ERR_NOERR != Result)
    {
        return Result;
    }

    //
    // Enable drive
    //
    Result = Nem_SetControlWord(Nemesys, CW_OP_EN);
    if (ERR_NOERR != Result)
    {
        return Result;
    }

    //
    // Give drive some time to process first control word
    //
    CsiSleep(50);

    //
    // Now start homing
    //
    return Nem_SetControlWord(Nemesys, CW_OP_EN | CWBIT_HOMING_START);
}

Here is the call graph for this function:

long NemRestorePos	(	TNemesys *	Nemesys,
		int32_t	dwPos
	)

Restore position value.

If the neMESYS device is switched off, the internal position value will get lost. If the device is swicthed on again later, normally a calibration move is necessary to initialize the internal position counter. If the application stored the last position value before device switch off, then it is possible to restore the position value by calling this function.

Parameters

[in]	Nemesys	Device to setup
[in]	dwPos	The position value to store in internal position counter.

Returns

Error code - ERR_NOERR indicates success

{
    long  Result;

    //
    // Set operation mode to homing mode
    //
    Result = Nem_SetOpMode(Nemesys, NEM_OP_MODE_HOMING);
    if (ERR_NOERR != Result)
    {
        return Result;
    }

    //
    // set homing mode
    //
    Result = Nem_SetHomingMode(Nemesys, HM_ACTUAL_POSITION);
    if (ERR_NOERR != Result)
    {
        return Result;
    }

    //
    // Set position counter to position value
    //
    dwPos = 0 - dwPos; // we need invertet value
    Result = Nem_SetHomePos(Nemesys,  dwPos);
    if (ERR_NOERR != Result)
    {
        return Result;
    }

    //
    // Enable drive
    //
    Result = Nem_SetControlWord(Nemesys, CW_OP_EN);
    if (ERR_NOERR != Result)
    {
        return Result;
    }

    //
    // Give drive some time to process first control word
    //
    CsiSleep(50);
    //
    // Now start homing
    //
    return Nem_SetControlWord(Nemesys, CW_OP_EN | CWBIT_HOMING_START);;
}

Here is the call graph for this function: