// Borland C++ Builder
// Copyright (c) 1995, 2002 by Borland Software Corporation
// All rights reserved

// (DO NOT EDIT: machine generated header) 'coscom1_2.pas' rev: 6.00

#ifndef coscom1_2_H
#define coscom1_2_H

//#pragma delphiheader begin
//#pragma option push -w-
//#pragma option push -Vx
//#include <Windows.hpp>	// Pascal unit
//#include <SysInit.hpp>	// Pascal unit
//#include <System.hpp>	// Pascal unit

//-- user supplied -----------------------------------------------------------

//all functions except coscomopenPort, coscomclosePort, isvalidCoscomDevice
//call inside the function "isvalidCoscomDevice" so it isn't necessary to call
//this function extra

//the return value -1 means the function is unsupported by this device

//namespace Coscom1_2
//{

//-- type declarations -------------------------------------------------------
//-- var, const, procedure ---------------------------------------------------

//CODE_Description_Begin(coscomopenPort)
// opens port with portnumber 1 .. x
// return value -4 means invalid portnumber
// return value 0 means an error occurred
// return value 1 means successful call of function
//CODE_Description_End
extern "C" int __stdcall coscomopenPort(int portnumber);

//CODE_Description_Begin(coscomclosePort)
// closes port with portnumber 1 .. x
// return value -4 means invalid portnumber
// return value 0 means an error occurred
// return value 1 means successful call of function
//CODE_Description_End
extern "C" int __stdcall coscomclosePort(int portnumber);

//CODE_Description_Begin(isvalidCoscomDevice)
// checks if the device is ready for function call with portnumber 1 .. x
// return value -4 means invalid portnumber
// return value 0 means the port isn't open
// return value -2 means the port is opened but the device cann't be controlled
// return value 1 means the device can controlled by user
//CODE_Description_End
extern "C" int __stdcall isvalidCoscomDevice(int portnumber);

//CODE_Description_Begin(coscomgetVersion)
// get the device eprom software version with portnumber 1 .. x
// return value -4 means invalid portnumber
// return value -2 means the port is opened but the device cann't be controlled
// return value -3 means an error occurred during function call
// return value 0 means the port isn't open
// return value 1 means the device can controlled by user
// returned parameter values:
// versionchars = see coscom.org function V00
//CODE_Description_End
extern "C" int __stdcall coscomgetVersion(int portnumber, char * versionchars);

//CODE_Description_Begin(coscomgetStatus)
// checks the device control status with portnumber 1 .. x
// return value -4 means invalid portnumber
// return value -2 means the port is opened but the device cann't be controlled
// return value -3 means an error occurred during function call
// return value 0 means the port isn't open
// return value 1 means the device can controlled by user
// returned parameter values:
// returned value value:
// 0 == Stop
//	1 == Run
//	2 == Pause
//	3 == Stopping
//	4 == Detecting
//	5 == Off
//CODE_Description_End
extern "C" int __stdcall coscomgetStatus(int portnumber, int *value);

//CODE_Description_Begin(coscomgetDuration)
// get the device runtime duration 1 .. x
// return value -4 means invalid portnumber
// return value -2 means the port is opened but the device cann't be controlled
// return value -3 means an error occurred during function call
// return value 0 means the port isn't open
// return value 1 means the device can controlled by user
// returned parameter values:
// returned value value:
// value = duration in ms
// - this duration is the time returned by the coscom function T00
//CODE_Description_End
extern "C" int __stdcall coscomgetDuration(int portnumber, int *value);

//CODE_Description_Begin(coscomgetSpeed)
// get the device actual speed with portnumber 1 .. x
// return value -4 means invalid portnumber
// return value -2 means the port is opened but the device cann't be controlled
// return value -3 means an error occurred during function call
// return value 0 means the port isn't open
// return value 1 means the device can controlled by user
// returned parameter values:
// returned value value:
// value = speed in m/s for treadmills m/min for ladder ergometers
// - this speed is the value returned by the coscom function S01
//CODE_Description_End
extern "C" int __stdcall coscomgetSpeed(int portnumber, double * value);

//CODE_Description_Begin(coscomgetAcceleration)
// get the device actual acceleration index with portnumber 1 .. x
// return value -4 means invalid portnumber
// return value -2 means the port is opened but the device cann't be controlled
// return value -3 means an error occurred during function call
// return value 0 means the port isn't open
// return value 1 means the device can controlled by user
// returned parameter values:
// returned value value:
// value = acceleration index 0..7
// - this acceleration index is the value returned by the coscom function A01
//CODE_Description_End
extern "C" int __stdcall coscomgetAcceleration(int portnumber, int *value);

//CODE_Description_Begin(coscomgetElevation)
// get the device actual elevation with portnumber 1 .. x
// return value -4 means invalid portnumber
// return value -2 means the port is opened but the device cann't be controlled
// return value -3 means an error occurred during function call
// return value 0 means the port isn't open
// return value 1 means the device can controlled by user
// returned parameter values:
// returned value value:
// value = elevation in % - (height / length) * 100%
// - this elevation is the value returned by the coscom function E01
//CODE_Description_End
extern "C" int __stdcall coscomgetElevation(int portnumber, double * value);

//CODE_Description_Begin(coscomgetHeartrate)
// get the device actual heartrate with portnumber 1 .. x
// return value -4 means invalid portnumber
// return value -2 means the port is opened but the device cann't be controlled
// return value -3 means an error occurred during function call
// return value 0 means the port isn't open
// return value 1 means the device can controlled by user
// returned parameter values:
// returned value value:
// value = heartrate in beats per minunte
// 0 == invalid heartrate value
// - this elevation is the value returned by the coscom function P01
//CODE_Description_End
extern "C" int __stdcall coscomgetHeartrate(int portnumber, int *value);

//CODE_Description_Begin(coscomgetDistance)
// get the device actual distance with portnumber 1 .. x
// return value -4 means invalid portnumber
// return value -2 means the port is opened but the device cann't be controlled
// return value -3 means an error occurred during function call
// return value 0 means the port isn't open
// return value 1 means the device can controlled by user
// returned parameter values:
// returned value value:
// value = distance in meters for treadmills / decimetre for ladder ergometer
// - this distance is the value returned by the coscom function D00
//CODE_Description_End
extern "C" int __stdcall coscomgetDistance(int portnumber, int *value);

//CODE_Description_Begin(coscomgetError)
// get the device error status with portnumber 1 .. x
// return value -4 means invalid portnumber
// return value -2 means the port is opened but the device cann't be controlled
// return value -3 means an error occurred during function call
// return value 0 means the port isn't open
// return value 1 means the device can controlled by user
// returned parameter values:
// returned value value:
// value = error numbers
// - this error numbers are the values returned by the coscom function Z00
//CODE_Description_End
extern "C" int __stdcall coscomgetError(int portnumber, int *value);

//CODE_Description_Begin(coscomgetFailSafe)
// get the device fail safe time with portnumber 1 .. x
//remark: this value is the last value set by the function coscomsetFailSafe
// return value -4 means invalid portnumber
// return value -2 means the port is opened but the device cann't be controlled
// return value -3 means an error occurred during function call
// return value 0 means the port isn't open
// return value 1 means the device can controlled by user
// returned parameter values:
// returned value value:
// value = 0..25
// - this fail safe time is the value set by the coscom function F00
//CODE_Description_End
extern "C" int __stdcall coscomgetFailSafe(int portnumber, int *value);

//CODE_Description_Begin(coscomgetWeight)
// get the device Weight with portnumber 1 .. x
// return value -4 means invalid portnumber
// return value -2 means the port is opened but the device cann't be controlled
// return value -3 means an error occurred during function call
// return value 0 means the port isn't open
// return value 1 means the device can controlled by user
// returned parameter values:
// returned value value:
// value = 0..
// - this weight is the value returned by the coscom function J00
//CODE_Description_End
extern "C" int __stdcall coscomgetWeight(int portnumber, int *value);

//CODE_Description_Begin(coscomgetEnergy)
// get the device Energy with portnumber 1 .. x
// return value -4 means invalid portnumber
// return value -2 means the port is opened but the device cann't be controlled
// return value -3 means an error occurred during function call
// return value 0 means the port isn't open
// return value 1 means the device can controlled by user
// returned parameter values:
// returned value value:
// value =
// - this energy is the value returned by the coscom function J01
//CODE_Description_End
extern "C" int __stdcall coscomgetEnergy(int portnumber, double * value);

//CODE_Description_Begin(coscomgetPower)
// get the device Power with portnumber 1 .. x
// return value -4 means invalid portnumber
// return value -2 means the port is opened but the device cann't be controlled
// return value -3 means an error occurred during function call
// return value 0 means the port isn't open
// return value 1 means the device can controlled by user
// returned parameter values:
// returned value value:
// value =
// - this power is the value returned by the coscom function J02
//CODE_Description_End
extern "C" int __stdcall coscomgetPower(int portnumber, double * value);

//CODE_Description_Begin(coscomsetFailSafe)
// get the device fail safe time with portnumber 1 .. x
// return value -4 means invalid portnumber
// return value -2 means the port is opened but the device cann't be controlled
// return value -3 means an error occurred during function call
// return value 0 means the port isn't open
// return value 1 means the device can controlled by user
// returned parameter values:
// returned value value:
// value = 0..25
// - this fail safe time is the value set by the coscom function F00
//CODE_Description_End
extern "C" int __stdcall coscomsetFailSafe(int portnumber, int value);

//CODE_Description_Begin(coscomsetSpeed)
// sets the device program speed with portnumber 1 .. x
// parameter value:
// value = speed in m/s for treadmills m/min for ladder ergometers
// - this speed is the value set by the coscom function S02
// return value -4 means invalid portnumber
// return value -2 means the port is opened but the device cann't be controlled
// return value -3 means an error occurred during function call
// return value 0 means the port isn't open
// return value 1 means the device can controlled by user
//CODE_Description_End
extern "C" int __stdcall coscomsetSpeed(int portnumber, double value);

//CODE_Description_Begin(coscomsetAcceleration)
// sets the device program acceleration index with portnumber 1 .. x
// parameter value:
// value = 0..7
// - this acceleration index is the value set by the coscom function A01
// return value -4 means invalid portnumber
// return value -2 means the port is opened but the device cann't be controlled
// return value -3 means an error occurred during function call
// return value 0 means the port isn't open
// return value 1 means the device can controlled by user
//CODE_Description_End
extern "C" int __stdcall coscomsetAcceleration(int portnumber, int value);

//CODE_Description_Begin(coscomsetAcceleration)
// this function is the concatenation of the functions coscomsetAcceleration +
// coscomsetSpeed
//CODE_Description_End
extern "C" int __stdcall coscomsetSpeedAccel(int portnumber, double value, int accelerationindex);

//CODE_Description_Begin(coscomsetElevation)
// sets the device program elevation with portnumber 1 .. x
// parameter value:
// value = elevation in % - (height / length) * 100%
// - this elevation is the value set by the coscom function E03
// return value -4 means invalid portnumber
// return value -2 means the port is opened but the device cann't be controlled
// return value -3 means an error occurred during function call
// return value 0 means the port isn't open
// return value 1 means the device can controlled by user
//CODE_Description_End
extern "C" int __stdcall coscomsetElevation(int portnumber, double value);

//CODE_Description_Begin(coscomKeyPressStart)
// sends device key press start command with portnumber 1 .. x
// parameter how:
// 0 == released
// 1 == pressed
// - this key press is the value send by the coscom function U10
// return value -4 means invalid portnumber
// return value -2 means the port is opened but the device cann't be controlled
// return value -3 means an error occurred during function call
// return value 0 means the port isn't open
// return value 1 means the device can controlled by user
//CODE_Description_End
extern "C" int __stdcall coscomKeyPressStart(int portnumber, int how);

//CODE_Description_Begin(coscomKeyPressStop)
// sends device key press stop command with portnumber 1 .. x
// parameter how:
// 0 == released
// 1 == pressed
// - this key press is the value send by the coscom function U10
// return value -4 means invalid portnumber
// return value -2 means the port is opened but the device cann't be controlled
// return value -3 means an error occurred during function call
// return value 0 means the port isn't open
// return value 1 means the device can controlled by user
//CODE_Description_End
extern "C" int __stdcall coscomKeyPressStop(int portnumber, int how);

//CODE_Description_Begin(coscomKeyPressPlus)
// sends device key press + command with portnumber 1 .. x
// parameter how:
// 0 == released
// 1 == pressed
// - this key press is the value send by the coscom function U10
// return value -4 means invalid portnumber
// return value -2 means the port is opened but the device cann't be controlled
// return value -3 means an error occurred during function call
// return value 0 means the port isn't open
// return value 1 means the device can controlled by user
//CODE_Description_End
extern "C" int __stdcall coscomKeyPressPlus(int portnumber, int how);

//CODE_Description_Begin(coscomKeyPressMinus)
// sends device key press - command with portnumber 1 .. x
// parameter how:
// 0 == released
// 1 == pressed
// - this key press is the value send by the coscom function U10
// return value -4 means invalid portnumber
// return value -2 means the port is opened but the device cann't be controlled
// return value -3 means an error occurred during function call
// return value 0 means the port isn't open
// return value 1 means the device can controlled by user
//CODE_Description_End
extern "C" int __stdcall coscomKeyPressMinus(int portnumber, int how);

//CODE_Description_Begin(coscomKeyPressUp)
// sends device key press up command with portnumber 1 .. x
// parameter how:
// 0 == released
// 1 == pressed
// - this key press is the value send by the coscom function U10
// return value -4 means invalid portnumber
// return value -2 means the port is opened but the device cann't be controlled
// return value -3 means an error occurred during function call
// return value 0 means the port isn't open
// return value 1 means the device can controlled by user
//CODE_Description_End
extern "C" int __stdcall coscomKeyPressUp(int portnumber, int how);

//CODE_Description_Begin(coscomKeyPressDown)
// sends device key press down command with portnumber 1 .. x
// parameter how:
// 0 == released
// 1 == pressed
// - this key press is the value send by the coscom function U10
// return value -4 means invalid portnumber
// return value -2 means the port is opened but the device cann't be controlled
// return value -3 means an error occurred during function call
// return value 0 means the port isn't open
// return value 1 means the device can controlled by user
//CODE_Description_End
extern "C" int __stdcall coscomKeyPressDown(int portnumber, int how);

//CODE_Description_Begin(coscomsetProtocol)
// this function enables/disables the hardware protocol device with portnumber 1 .. x
// parameter how
// 0 == off
// 1 == on
//remark: if switches the protocol on, the dll automatically creates a directory
// under the program directory named "Protocol". in this directory an file is opened
// with an name with the following format "Protocolyyyymmdd-n.TXT"
// yyyy == year
// mm == month
// dd == day
// n == ticks from start of the windows session
// a valid example is "Protocol20051214-3910265.TXT"
//CODE_Description_End
extern "C" int __stdcall coscomsetProtocol(int portnumber, int how);

//CODE_Description_Begin(coscomsetProtocol)
// returns the device hardware protocol status with portnumber 1 .. x
// return value -4 means invalid portnumber
// return value -2 means the port is opened but the device cann't be controlled
// return value -3 means an error occurred during function call
// return value 0 means the port isn't open
// return value 1 means the device can controlled by user
// returned value how;
// 0 == off
// 1 == on
//CODE_Description_End
extern "C" int __stdcall coscomgetProtocol(int portnumber, int *how);

//}	/* namespace Coscom1_2 */
//using namespace Coscom1_2;
//#pragma option pop	// -w-
//#pragma option pop	// -Vx

//#pragma delphiheader end.
//-- end unit ----------------------------------------------------------------
#endif	// coscom1_2