6 C脚本函数

6.1 动态库中定义的方法接口以及说明

• Socket连接：

  • int InitSock(char* SevIP,int SevPort);
    说明：建立socket连接。
    参数说明：
    char* SevIP---server端ip地址。
    int SevPort---server端端口号。

  • int DeinitSock();
    说明：卸载socket连接。
    注意：一定要和InitSock成对出现，否则可能会影响别的操作。

  • int openi2c();
    说明：打开i2c。

  • int closei2c();
    说明：关闭i2c。

  • seti2cspeed(int i2cPort, int i2cSpeed);
    说明：设置i2c端口和速率。
    参数说明：
    int i2cPort--- i2c端口。
    int i2cSpeed--- i2c速率。
    返回值：0：成功；非0：错误码。

  • int ReadregMulti(int i2cport, char idevaddr, int iregaddr, int iregaddrcount, char *buffer, int len);
    说明:读取寄存器。
    参数说明：
    int i2cport --- i2c端口号。
    char idevaddr--- 设备地址。
    int iregaddr--- 寄存器地址。
    int iregaddrcount--- 寄存器地址占用字节数。
    char *buffer--- 要读的值存放的起始地址。
    int len--- 读取寄存器个数。

  • WriteregMulti(int i2cport, char idevaddr, int iregaddr, int iregaddrcount, char *data, int len);
    说明:写寄存器
    参数说明：
    int i2cport --- i2c端口号。
    char idevaddr--- 设备地址。
    int iregaddr--- 寄存器地址。
    int iregaddrcount--- 寄存器地址占用字节数。
    char *data--- 要写的值存放的起始地址。
    int len--- 写寄存器个数。

  • int ReadregPeriod(int i2cport, char idevaddr, int iregaddr, int iregaddrcount, char *buffer, int iregbytes, int count, int period)
    说明：周期读某一寄存器。
    参数说明：
    int i2cport --- i2c端口号。
    char idevaddr--- 设备地址。
    int iregaddr--- 寄存器地址。
    int iregaddrcount--- 寄存器地址占用字节数。
    char *buffer--- 要读的值存放的起始地址。
    int iregbytes --- 寄存器占字节数。
    int count --- 读取次数。
    int period --- 读取周期，单位μs。
    

    注：在调用 ReadregPeriod 函数时，count*period<4000000, 这是由于socket读超时时间设置为4s，超过这个数dll会返回-7，读错误，错误码10060。

• USB连接：

  • USBIO_OpenDevice(int deviceId)
    说明：打开USB设备。
    参数说明：
    int deviceId ---设备序列号，0对应第一个设备。
    返回值：返回句柄，出错则无效。

  • USBIO_CloseDevice(int deviceId)
    说明:关闭USB设备。
    参数说明：
    int deviceId ---设备序列号，0对应第一个设备。
    

  • USBIO_SetStream(int deviceId, int mode)
    说明：设置串口流模式。
    参数说明：
    int deviceId ---设备序列号，0对应第一个设备。
    int mode --- 指定模式，见下行
    位1-位0：I2C接口速度/SCL频率，00=低速/20KHz，01=标准/100KHz(默认值)，10=快速/400KHz，11=高速/750KHz
    位2： SPI的I/O数/IO引脚， 0=单入单出（D3时钟/D5出/D7入）(默认值)，1=双入双出（D3时钟/D5出D4出/D7入D6入）
    位7： SPI字节中的位顺序, 0=低位在前, 1=高位在前。
    其它保留，必须为0。

  • USBIO_StreamI2C(int deviceId, int writeLength, char * writeBuffer, int readLength, char * readBuffer)
    说明：处理I2C数据流,2线接口,时钟线为SCL引脚,数据线为SDA引脚(准双向I/O),速度约56K字节。 参数说明：
    int deviceId ---设备序列号，0对应第一个设备。
    int writeLength --- 准备写出的数据字节数。
    char * writeBuffer --- 指向一个缓冲区,放置准备写出的数据,首字节通常是I2C设备地址及读写方向位。 int readLength --- 准备读取的数据字节数。
    char * readBuffer --- 指向一个缓冲区,返回后是读入的数据。

6.2 控件绑定函数返回值限制

编写控件绑定C脚本函数时，绑定函数的打印格式要求如下：

if(执行正常)

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);

说明：

• error 用来说明执行状态信息：当状态信息中包含“err” 或 "failed"，任务函数执行失败，否则认为函数执行成功。
• return 用来描述真实的返回值：只有函数的返回状态为成功，工具端才会解析真实的返回值。

编写控件绑定C脚本函数时，也应特别注意每个控件的函数返回值要求：

• Button操作：无限制。
• Indicator操作：返回值必须为0或者正整数。
• Trace操作:无限制。
• I2c Set操作： 返回值必须为整数。
• Monitor操作
  • Lock Time：返回值必须为0或者正整数。
  • Symbol Error：返回值必须为浮点数或者整数。注：浮点型数据将会精确到小数点后五位，显示四舍五入后的值。
  • Carrier Error：返回值必须为浮点数或者整数。注：浮点型数据将会精确到小数点后五位，显示四舍五入后的值。
  • Signal Intensity：返回值必须为整数。当返回值小于0，进度条默认按0%显示，当返回值大于100，进度条默认按100%显示。
  • Signal Quality：返回值必须为整数。当返回值小于0，进度条默认按0%显示，当返回值大于100，进度条默认按100%显示。
  • C/N：返回值必须为浮点数或者整数。
  • Error Rate：返回值必须为浮点数或者整数。
• 频谱图操作

  当频谱图从函数读入画图时， C脚本中定义的函数返回值应是：

  • 一个由二维点坐标构成的字符串：每个点之间用“#”分隔。
  • 点中X和Y轴坐标之间用英文逗号分隔。
  • X和Y轴数据必须是整型或者浮点型。

  格式为：{x1,y1}#{x2,y2}#{x3,y3}# .....例如：{3,4}#{5,6}#{7,8}#。

  参考样例如下：
  
  #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");
  注意："error=%s,return="应处于for循环外面。
  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 前提

• I2C服务已经启动
• Socket 连接：
  • HiChannel工具菜单栏，DUT网络中Ip Address、Dev Address和板端Ip相匹配
  • I2C Speed，DUT网络中I2C Port 与Dev Address匹配
• USB 连接：
  • HiChannel工具菜单栏，Usb设置中Dev Address和板端相匹配

6.4 调用I2C读写

6.5 C脚本函数编写说明

6.6 样例