Agilent Technologies E4371A Video Gaming Accessories User Manual


 
Language Dictionary - 6
83
cfMeasVoltage
Syntax
int cfMeasVoltage(CF_HANDLE server, int cell, float *reading);
Description
Returns the measured cell voltage in volts for a particular cell or for all cells. Voltage is
measured at the selected sense terminals for each cell. The cell argument can be an individual
cell number from 1 to 256, or the constant CF_ALL_CELLS to request readings for all cells. If
CF_ALL_CELLS is given, the reading argument should point to an array of size
CF_MAX_CELLS that will receive the return values.
cfOpen
Syntax
int cfOpen(char *server_name, CF_HANDLE *server, char *password);
Description
Before using any of the cell forming (cf) functions, you must establish a connection with the
desired cell forming server. This function creates a connection and returns a handle to be used by
all other cf functions. Access to cfOpen is protected by an alpha-numeric password, which is
verified before the connection is permitted to be made. The password can be changed using a
serial terminal connected to Serial Port B. The maximum length of the password is 32 characters.
The server_name argument can either be an IP address or the server name.
Example
#include <stdio.h>
#include <mccd.h>
main()
{
CF_HANDLE server;
if (cfOpen("15.14.248.100", &server, "mypassword"))
printf("Cannot connect to MCCD server\n");
}
cfOpenGroup
Syntax
int cfOpenGroup(CF_HANDLE server, char *name, CF_HANDLE *group_handle);
Description
Associates a CF_HANDLE with a defined group for subsequent control. The group handle
returned can be used to direct API commands to the specified group.
When an API program is finished using a group handle, it should close the handle by calling
cfClose and passing the group handle value. There are only a limited number of group handles
available, and an API program can use them all up if it does not free group handles that are no
longer needed.
When the server handle (a handle obtained by a call to cfOpen) is closed, all group handles
associated with that server handle are automatically closed. In that case it is not necessary to
close the group handles explicitly.