A1系列二次开发手册范本

前言本使用手册详细说明了捷宝A1平台系列抄表机（JBA188,JBA168,JBA198）的二次开发工具，开发流程，API函数，以及通讯动态库函数，请在使用前仔细阅读该使用手册，以便保证您的正确使用和工作效率，敬请妥善保管以备日后查阅之用。

如发现本手册有编写错误之处，请予以指出，以便更正，！目录前言 (1)二次应用程序开发说明 (3)1.1 CBJTOOL安装 (3)1.2编写应用程序 (3)1.3编程注意事项： (3)1.4编译程序 (3)1.4.1 Cbjtool编译工具 (3)1.4.2编译步骤 (3)1.5下装文件 (4)1.6工程文件操作 (4)二次开发接口介绍 (5)2.1数据类型 (5)2.1.1基本数据类型 (5)2.1.2消息 (5)2.1.3显示区域 (6)2.1.4光标 (6)2.2键盘接口函数 (7)2.3LCD接口函数 (7)2.4底层输出函数 (8)2.5GDI接口显示函数 (8)2.6蜂鸣器与时钟接口函数 (12)2.6.1 蜂鸣器函数 (12)2.6.2 时钟接口 (12)2.6.3 定时器接口 (13)2.7文件操作函数 (14)2.8数据库操作函数(BDC.H) (15)2.9GUI组件库函数 (17)2.10消息处理函数 (30)2.10.1系统消息处理 (30)2.10.2 GUI消息处理 (31)2.11标准C数据转换函数 (32)2.12标准C字符串函数 (33)2.13图标资源 (34)2.14串行通讯类 (34)2.15权限管理类 (36)2.16环境变量类 (36)2.17输入法接口 (38)2.18系统服务调用 (39)二次应用程序开发说明A1平台的应用程序可用ARM处理器的开发工具ADS（ARM Developer Suite）进行编写与编译，这里主要介绍我公司提供的集成开发环境cbjtool2007来开发二次应用程序。

1.1 cbjtool安装将CbjTool2007目录整个拷贝到您的电脑根目录下。

.. \BIN\ 可执行文件(*.EXE).. \LIB\ 运行库文件（*.a）.. \INCLUDE\ 头文件 (*.H)1.2编写应用程序源程序可以在任何编辑软件中进行编辑，即可以用通用工具（写字版,UltraEdit-32等）和我们提供的CbjTool.exe该文件在’.. \BIN\’目录下。

1.3编程注意事项：在定义数组的大小时应将字符串结束符’\0’考虑进去,否则若引起RAM地址冲突可能会产生不可预料的结果.例如:取时间函数getDateTimeStr (s),返回的是17个字符长的时间串,加上结束符’\0’共18个字节长,故定义s的大小时至少是18个字节。

1.4编译程序1.4.1 Cbjtool编译工具在’..\BIN\’目录下Cbjtool.exe具有抄表程序编辑,编译功能。

运行平台: win9x\win2000\winXP1.4.2编译步骤如果我们的程序是用通用工具来编辑的，那么编译前也要把程序存到某个目录下，然后才能对其进行编译。

编译过程如下：<1>运行Cbjtool.exe<2>在菜单“文件”里打开文件（即所要编译的C源程序）。

<3>在菜单“程序”里选择“编译”，编译没有错后再选择“连接”；或直选择“生成”，也可以直接单击工具栏上的绿色三角符号。

如果程序是在Cbjtool.exe下编辑的，存盘后直接对其编译就可以了。

编译方法同<3>。

如果程序没有错误，编译连接后生成.bin文件、.o文件、.axf文件。

在Cbjtool.exe界面的下方有编译结果报告。

1.5下装文件程序正确编译后生成的.bin文件，我们要把它下装到抄表机上，以使其在抄表机上运行。

下装前请先连接好抄表机与微机的通讯电缆,并进入抄表机的通讯等待状态，然后点击cbjtool.exe中的’下装程序’菜单(或快捷按钮)即可。

如果要下装数据库(*.dbf)文件，可点击cbjtool.exe中的’通讯管理器’菜单(或快捷按钮) 。

1.6工程文件操作如果您的源程序在多个文件中,就需要建立工程文件统一编译连接。

具体步骤如下:先选择cbjtool.exe中’工程-新建’菜单,在弹出的’另存为’对话框中选择存放有源程序的目录,并输入一个工程名,然后点’保存’。

这时cbjtool将新建一个扩展名为.JBP的工程文件并打开’工程管理器’,您可以在’工程管理器’中添加源文件。

注意：软件会自动将包含main()函数的C文件排到工程文件列表的最上面。

另外，一个工程中所有用到的源文件(.C)、头文件(.H)及工程文件(.JBP)必须放在同一个目录下。

以后可以选择cbjtool.exe中’工程-打开’菜单来打开已经建立的工程。

工程打开后要进行编译连接时请选择’程序-生成’或点击三角形的快捷按钮。

二次开发接口介绍A1平台二次开发接口由一系列数据类型与系统功能调用API函数组成，如无特别声明，A1平台的所有数据类型及函数原型均在jblib.h头文件中。

2.1数据类型这里将介绍A1平台开发时所需用到的一些常用数据类型，则于GUI组件类别及其属性较多，所以与GUI组件相关的数据类型将放到GUI库函数说明中介绍。

2.1.1基本数据类型U88bit无符号类型.同unsigned charU1616bit无符号类型.同unsigned intU3232bit无符号类型.同unsigned longP_U8指向U8类型数据指针.同unsigned char *P_U16指向U16类型数据指针.同unsigned int *P_U32指向U32类型数据指针.同unsigned long *注意：全局变量只能动态始化，局部变量可以静态初始化，即声明时初始化。

2.1.2消息与消息处理相关的数据类型只有一个TMsg结构体，其声明如下：typedef __packed struct tagMessage{unsigned int Msg;void*Obj;unsigned short WParam;unsigned short LParam;unsigned char Result;}TMsg,*PMsg;成员说明：Msg: 消息类型Obj: 消息目标对象，即将接收并处理该消息的对象，若消息处理对象不确定，或者该消息需要多个可能的对象处理则Obj值可能为NULLWParam:消息参数1，具体容依消息类型而定LParam:消息参数2，具体容依消息类型而定Result:消息返回值，若该消息被处理Result将被置值为MSG_OK(MSG_OK值为1)2.1.3显示区域矩形区域结构体Recttypedef struct tagRect{U8left;U8top;U8right;U8bottom;U8width;U8height;}Rect,*PRect;成员说明：left: 矩形区域左边坐标tTop: 矩形区域顶部坐标right: 矩形区域右边坐标bottom: 矩形区域底部坐标width: 矩形区域宽度height: 矩形区域高度注意：若要更改Rect大小及位置请使用以下四个宏来操作SetRectWidth(rt,value)：设置Rect宽度SetRectHeight(rt,value)：设置Rect高度SetRectTop(rt,value)：修改Rect顶部位置SetRectLeft(rt,value)：修改Rect左边位置2.1.4光标typedef __packed struct tagCurosr{HWND owner;U8type;U8x;U8y;U8flag;}Cursor,*PCursor;成员说明：owner: 该光标所有者，即需要显示光标的组件type: 光标类型，光标显示形状0—2分别为坚线、工字型、下划线型光标x: 光标X坐标，屏幕坐标y: 光标Y坐标，屏幕坐标flag: 光标状态，为1则光标正在显示，为0则光标已消隐2.2键盘接口函数键盘按键值分为扫描码与标准键值两种，即一个按键可以用扫描码与标准按键来表示。

扫描码与键盘设计布局有关，如果键盘布局设计变更其扫描码可能也会变化。

标准健值是固定的，如“退出”(ESC)键在不同型号不同键盘布局的机器上键值均为27。

1.U8 keygos(U32 n)功能：从键盘接收一个按键,等待n(ms)指定时间参数据：n，等待的延时参数，单位为毫秒返回：有按键则为键值，无按键返回0。

备注：keygos返回的按键值为扫描码，区别于标准键值，如“退出”键值为十六进制0x03，系统定义为常量CK_ESC，扫描码定义均以CK_打头，可以在”keydef.h”头文件中找到所有键码定义。

2.U8 key(U16 *msg)功能：从键盘等待一个按键，如果没有按键，则无限期等待，直到按键产生为止参数：msg为指向十六位无符号数的指针，如果不需要处理消息则直接令msg为NULL或0即可。

返回：有按键才返回，返回标准键值，*msg返回本次按键的消息值备注：key返回的按键值为标准键值，如”退出”键键值为27，同PC机ESC键值一样，系统定义为VK_ESC，标准键值定义均以VK_打头，可以在”keydef.h”头文件中找到所有键值定义。

2.3 LCD接口函数LCD接口函数提供LCD屏的直接控制与绘图操作，属于较为底层的开发接口，若非需要较高的绘图性能与响应速度，一般显示输出请使用GDI函数集1.void lcd_setcontract(int c)功能：设置LCD屏对比度参数：对比度取值围 0 – 2552.void LCD_ShowImage(U8 *buf,U8 startx6,U8 starty,U8 endx6,U8 endy,U8 mode)功能：显示一4位16级灰度图片参数：buf 灰度图片数据startx: 图片左上角x坐标，屏幕坐标starty: 图片左上角y坐从标，屏幕坐标endx: 图片右下角x坐从标，屏幕坐标endy: 图片右下角y坐从标，屏幕坐标mode: 显示模式，目前保留没用2.4底层输出函数底层输出为操作系统支持的几个最简单的输出操作，而其它类别的输出调用（如GDI 与 GUI 函数库）则需要系统执行某些初始化后才能调用。

1.void cls(void)功能：清屏3.int printf( const char *format, ... )功能：可将各种数据类型的数据格式化后显示在屏幕上。

参数：format 格式化串。

用于控制转换后串的格式。

包括：%d 有符号整型%u 无符号整型%x 无符号十六进制数%c 字符%s 字符串%p 指针备注：浮点数据转字符串请便用jb_ftoa函数4.int uprintf( const char *format, ... )功能：格式化输出到串口参数：同printf5.int Aprintf( const char *format, ... )功能：格式化输出8*8点阵西文字符，参数：同printf2.5 GDI接口显示函数1.void setcolor(U8 color)功能：设置前景色参数：color 颜色值，取值为GDI_COLOR_MIN 0GDI_COLOR_MAX 15GDI_COLOR_LIGHT 5GDI_COLOR_NORMAL 10GDI_COLOR_DARK 152.U8 getcolor(void)功能：返回当前前景色设置参数：无3.void setbkcolor(U8 color)功能：设置背景色参数：color 背景颜色值，取值同setcolor4.U8 getbkcolor(void)功能：返回当前背景色设置参数：无5.void setfontch(U8 font)功能：设置中文字体参数：中文字体font 可选FONT_CH_12 中文12点阵字体FONT_CH_16 中文16点阵字体6.U8 getfontch(void)功能：返回当前中文字体返回：返回值有以下两种取值FONT_CH_12 中文12点阵字体FONT_CH_16 中文16点阵字体参数：无7.void setfonten(U8 font)功能：设置西文字体参数：西文字体font 可选FONT_EN_08 8点阵西文字体FONT_EN_12 12点阵西文字体FONT_EN_16 16点阵西文字体8.U8 getfonten(void)功能：返回当前西文字体返回：返回以下值FONT_EN_08 8点阵西文字体FONT_EN_12 12点阵西文字体FONT_EN_16 16点阵西文字体参数：无9.void setfont(U8 font)功能：设置当前字体参数：一种中文与一种西文字体组合值。