1 programming interface definitions – Metrohm 846 Driver Toolbox User Manual

Page 27

Advertising
background image

3.1 Programming interface definitions

Dosing Interface USB Toolbox, Annex

23

throw new DosInt-

Face846Exception(DosIntFace846Exception.getErrorString(nReturnstate), nReturnstate);

}

/**

* Prepares the Dosing Unit for exchange. The cylinder is filled from the specified port

and then the valve disk is

* turned to port 2.

* This action can be held and continued, but not stopped.

*

* @param ifNo Dosing Interface [1... ?]

* @param msbNo Dosino at MSB [1... 4]

* @param port Fill port [1..4]

* @param revRate Filling rate [0.01... 166 mL/min]

* @throws DosIntFace846Exception

*/

public static final void duExchange(int ifNo, int msbNo, int port, float revRate) throws

DosIntFace846Exception{

int nReturnstate = DosIntFace846.callExchange(ifNo, msbNo, port, revRate);

if (nReturnstate != 0)

throw new DosInt-

Face846Exception(DosIntFace846Exception.getErrorString(nReturnstate), nReturnstate);

}

/**

* Reads the state of a Dosino drive.

*

* @param ifNo Dosing Interface [1... ?]

* @param msbNo Dosino at MSB [1... 4]

* @return 0 = Dosino is ready to execute a function, <br>

* 1 = Cylinder is being filled, <br>

* 2 = Dosino is executing Exchange function, <br>

* 3 = Dosino is executing GoPos function, <br>

* 4 = Dosino is executing ZeroAdjust function, <br>

* 5 = Dosino is executing Adjust function, <br>

* 6 = Dosino is executing Cock function, <br>

* 7 = Dosino is executing ToEnd function, <br>

* 8 = Dosino is executing MakeStep function, <br>

* 9 = Dosino is executing Prep function, <br>

* 10 = Dosino is executing Empty function, <br>

* 11 = Dosino is busy, <br>

* 12 = Dosino is halted while filling, <br>

* 13 = Dosino is halted in Exchange function, <br>

* 14 = Dosino is halted in GoPos function, <br>

* 15 = Dosino is halted in ZeroAdjust function, <br>

* 16 = Dosino is halted in Adjust function, <br>

* 17 = Dosino is halted in ToEnd function, <br>

* 18 = Dosino is halted in MakeStep function, <br>

* 19 = Dosino is halted in Prep function, <br>

* 20 = Dosino is halted in Empty function, <br>

* 21 = Dosino has timed out, <br>

* 22 = Dosino status is undefined<br>

* @throws DosIntFace846Exception

*/

public static final int status(int ifNo, int msbNo) throws DosIntFace846Exception{

dosinoState = 22;

int nReturnstate = DosIntFace846.callStatus(ifNo, msbNo);

if (nReturnstate == 0)

return dosinoState;

else

throw new DosInt-

Face846Exception(DosIntFace846Exception.getErrorString(nReturnstate), nReturnstate);

}

/**

* Stops the current Dosino action.

*

* @param ifNo Dosing Interface [1... ?]

* @param msbNo Dosino at MSB [1... 4]

* @throws DosIntFace846Exception

*/

Advertising