Language Dictionary - 6

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.

83

Page 83
Image 83
Agilent Technologies E4374A, E4370A, E4371A manual CfMeasVoltage, CfOpenGroup