kstars

IS Functions: Functions all drivers must define.

Detailed Description

This section defines functions that must be defined in each driver.

These functions are never called by the driver, but are called by the driver framework. These must always be defined even if they do nothing.


Functions
void	ISGetProperties (const char *dev)
void	ISNewText (const char dev, const char name, char texts[], char names[], int n)
void	ISNewNumber (const char dev, const char name, double doubles, char names[], int n)
void	ISNewSwitch (const char dev, const char name, ISState states, char names[], int n)
void	ISNewBLOB (const char dev, const char name, int sizes[], int blobsizes[], char blobs[], char formats[], char *names[], int n)
void	ISSnoopDevice (XMLEle *root)

Function Documentation

void ISGetProperties ( const char * dev )

Get Device Properties.

Parameters:

dev

the name of the device.

This function is called by the framework whenever the driver has received a getProperties message from an INDI client. The argument

Parameters:

dev

is either a string containing the name of the device specified within the message, or NULL if no device was specified. If the driver does not recognize the device, it should ignore the message and do nothing. If dev matches the device the driver is implementing, or dev is NULL, the driver must respond by sending one defXXX message to describe each property defined by this device, including its current (or initial) value. The recommended way to send these messages is to call the appropriate IDDef functions.

Definition at line 56 of file sbigcam.cpp.

void ISNewBLOB	(	const char *	dev,
		const char *	name,
		int	sizes[],
		int	blobsizes[],
		char *	blobs[],
		char *	formats[],
		char *	names[],
		int	n
	)

Update data of an existing blob vector property.

Parameters:

	dev	the name of the device.
	name	the name of the blob vector property to update.
	sizes	an array of base64 blob sizes in bytes before decoding.
	blobsizes	an array of the sizes of blobs after decoding from base64.
	blobs	an array of decoded data. Each blob size is found in blobsizes array.
	formats	Blob data format (e.g. fits.z).
	names	names of blob members to update.
	n	the number of blobs to update.

Note:: You do not need to call this function, it is called by INDI when new blob values arrive from the client. e.g. BLOB element with name names[0] has data located in blobs[0] with size sizes[0] and format formats[0].

Definition at line 95 of file sbigcam.cpp.

void ISNewNumber	(	const char *	dev,
		const char *	name,
		double *	doubles,
		char *	names[],
		int	n
	)

Update the value of an existing number vector property.

Parameters:

	dev	the name of the device.
	name	the name of the number vector property to update.
	doubles	an array of number values.
	names	parallel names to the array of number values.
	n	the dimension of doubles[].

Note:: You do not need to call this function, it is called by INDI when new number values arrive from the client.

void ISNewSwitch	(	const char *	dev,
		const char *	name,
		ISState *	states,
		char *	names[],
		int	n
	)

Update the value of an existing switch vector property.

Parameters:

	dev	the name of the device.
	name	the name of the switch vector property to update.
	states	an array of switch states.
	names	parallel names to the array of switch states.
	n	the dimension of states[].

Note:: You do not need to call this function, it is called by INDI when new switch values arrive from the client.

Definition at line 65 of file sbigcam.cpp.

void ISNewText	(	const char *	dev,
		const char *	name,
		char *	texts[],
		char *	names[],
		int	n
	)

Update the value of an existing text vector property.

Parameters:

	dev	the name of the device.
	name	the name of the text vector property to update.
	texts	an array of text values.
	names	parallel names to the array of text values.
	n	the dimension of texts[].

Note:: You do not need to call this function, it is called by INDI when new text values arrive from the client.

Definition at line 75 of file sbigcam.cpp.

void ISSnoopDevice ( XMLEle * root )

Function defined by Drivers that is called when another Driver it is snooping (by having previously called IDSnoopDevice()) sent any INDI message.

Parameters:

root

The argument contains the full message exactly as it was sent by the driver. Hint: use the IUSnoopXXX utility functions to help crack the message if it was one of setXXX or defXXX.

Definition at line 106 of file sbigcam.cpp.

kstars

IS Functions: Functions all drivers must define.

Detailed Description

Functions

Function Documentation

kstars

kdeedu