6 C function

6.1 The explain of method interface defined in the dynamic library

• Socket connection:

  • int InitSock(char* SevIP,int SevPort);
    Explain：build socket connections.
    Explain of parameters：
    char* SevIP---ip address of server.
    int SevPort---port of server.

  • int DeinitSock();
    Explain：uninstall socket connection.
    Note：Must appear in pairs with InitSock, ro may affect other operations.

  • int openi2c();
    Explain：open i2c.

  • int closei2c();
    Explain：close i2c.

  • seti2cspeed(int i2cPort, int i2cSpeed);
    Explain：set the port and speed of i2c.
    Explain of parameters：
    int i2cPort--- i2c port.
    int i2cSpeed--- i2c speed.
    return value： 0：success; not 0：wrong code.

  • int ReadregMulti(int i2cport, char idevaddr, int iregaddr, int iregaddrcount, char *buffer, int len);
    Explain: read register
    Explain of parameters：
    int i2cport --- i2c port.
    char idevaddr--- device address.
    int iregaddr--- register address.
    int iregaddrcount--- register address occupation number of bytes.
    char *buffer--- the start address which the read value stored.
    int len--- the number of read register

  • WriteregMulti(int i2cport, char idevaddr, int iregaddr, int iregaddrcount, char *data, int len);
    Explain:write register
    Explain of parameters：
    int i2cport --- i2c port.
    char idevaddr--- device address.
    int iregaddr--- register address.
    int iregaddrcount--- register address occupation number of bytes.
    char *data--- the start address which the writing value stored.
    int len--- the number of write register.

  • int ReadregPeriod(int i2cport, char idevaddr, int iregaddr, int iregaddrcount, char *buffer, int iregbytes, int count, int period)
    Explain:periodic read a register.
    Explain of parameters:
    int i2cport --- i2c port.
    char idevaddr--- device address.
    int iregaddr--- register address.
    int iregaddrcount--- register address occupation number of bytes.
    char *buffer--- the start address which the read value stored.
    int iregbytes --- total number of bytes register.
    int count --- reading times.
    int period --- read period, unit:μs.
    

    Note:when calling the ReadregPeriod function, count*period<4000000, this is because the socket read timeout is set to 4s, more than the number of dll will return -7, read error, error code:10060.

• USB connection:

  • USBIO_OpenDevice(int deviceId)
    Explain:Open USB Device
    Explain of parameters:
    int deviceId ---Serial number of device, 0 corresponding to the first device.
    Returns: returns a handle, if have error is invalid.

  • USBIO_CloseDevice(int deviceId)
    Explain:Close USB Device
    Explain of parameters:
    int deviceId ---Serial number of device, 0 corresponding to the first device.
    

  • USBIO_SetStream(int deviceId, int mode)
    Explain:Set serial flow pattern.
    Explain of parameters:
    int deviceId ---Serial number of device, 0 corresponding to the first device.
    int mode --- The specified model, see down
    bit 1-bit0:I2C interface speed /SCL frequency, 00= and low /20KHz, 01= standard /100KHz (the default), 10= /400KHz, 11= high speed /750KHz
    bit2:The SPI I/O /IO pin, 0= single input single output (D3 clock /D5 /D7) (the default), 1= double input double output (D3 clock /D5 D4 /D7 into the D6)
    bit7:A sequence of bytes in SPI, 0= low in front, 1= high in the front.
    Other reserved, must be 0.

  • USBIO_StreamI2C(int deviceId, int writeLength, char * writeBuffer, int readLength, char * readBuffer)
    Explain:The processing of I2C data flow, 2 wire interface, the clock line for the SCL pin, the data line to the SDA pin (quasi bidirectional I/O), speed of about 56K byte. Explain of parameters:
    int deviceId ---Serial number of device, 0 corresponding to the first device.
    int writeLength --- The number of bytes of data to write.
    char * writeBuffer ---Pointer to a buffer, placed ready to write data, the first byte is usually I2C device address and the read and write direction. int readLength --- Data bytes to read number.
    char * readBuffer --- Pointer to a buffer, after the return is read into the data.

6.2 Control function return value limit.

The preparation of control binding C script functions, print format binding function requirements are as follows:

if(isSuccess)

printf("error=%s,return=%f","ok",0.0);

elseif(xxx)

printf("error=%s,return=%d","err 1, failed", 1);

elseif(yyy)

printf("error=%s,return=%d","err 2, failed", 2);

Note:"error=" value means state message of result executed, ok or failed, if ok, print ok, if failed, print 'err xx, failed.',The "return=" means the return value of the function definition. Only the successful implementation, namely OK, the tool will return value is passed to the control, failure, the tool will execute the print status information to the interface.

C scripting function corresponding control, special attention should be paid to the return value of function of each control requirements:

• Button operation:unlimited.
• Indicator operation:the return value must be 0 or a positive integer.
• Trace operation:unlimited.
• I2c Set:the return value must be an integer.
• Monitor operation
  • Lock Time:the return value must be 0 or a positive integer.
  • Symbol Error:the return value must be a float or integer. Note: the floating-point data will be accurate to five decimal places, four to five homes in value after the.
  • Carrier Error:the return value must be a float or integer. Note: the floating-point data will be accurate to five decimal places, four to five homes in value after the.
  • Signal Intensity:The return value must be an integer. When the return value is less than 0, the progress of default by 0%, when the return value is greater than 100, the progress of default by 100% display.
  • Signal Quality:The return value must be an integer. When the return value is less than 0, the progress of default by 0%, when the return value is greater than 100, the progress of default by 100% display.
  • C/N:The return value must be a float or integer.
  • Error Rate:The return value must be a float or integer.
• Spectrum view operation

  When the spectrum from the function into the drawing, In the C script function return value defines:

  • A string by the two-dimensional coordinates of each point are separated by: "#".
  • Between points X and Y axis coordinate with English commas.
  • X and Y data must be an integer or floating-point type.

  Format:{x1,y1}#{x2,y2}#{x3,y3}#...... such as:{3,4}#{5,6}#{7,8}#

  Sample:
  
  #include "stdio.h"
  #define length 300
  int fftdata(int argc, char ** argv )
  {
  int doubleArray[2][length];
  int i;
  int j;
  for(i = 0; i < length; i++){
  doubleArray[0][i] = i;
  doubleArray[1][i] = i + 1;
  }
  printf("\n");
  Note: "error=%s, return=" should be in the for cycle.
  printf("error=%s,return=","ok");
  for(j = 0; j < (length- 1); j++){
  printf("{%d,%d}#", doubleArray[0][j],doubleArray[1][j]);
  }
  return 0;
  }

6.3 Precondition

• I2C service has been launched
• Socket connection:
  • Ip Address and Dev Address of "DUT Network" should be coordinate with the device.
  • I2C speed, the I2C Port and Dev Addess in "DUT Netmork" should be coordinate with each other.
• Usb connection:
  • Dev address of usb setting should be coordinate with the device

6.4 Call I2C read and write

6.5 Explain of writing C script functions

6.6 Sample