《A1系列二次开发手册范本》由会员分享，可在线阅读，更多相关《A1系列二次开发手册范本（41页珍藏版）》请在金锄头文库上搜索。
1、前前 言言 本使用手册详细说明了捷宝 A1 平台系列抄表机 JBA188 JBA168 JBA198 的二次开发工 具 开发流程 API 函数 以及通讯动态库函数 请在使用前仔细阅读该使用手册 以便 保证您的正确使用和工作效率 敬请妥善保管以备日后查阅之用 如发现本手册有编写错 误之处 请予以指出 以便更正 目目 录录 前前 言言 1 1 二次应用程序开发说明二次应用程序开发说明 4 4 1 1 CBJTOOL安装 4 1 2 编写应用程序 4 1 3 编程注意事项 4 1 4 编译程序 4 1 4 1 Cbjtool 编译工具 4 1 4 2 编译步骤 4 1 5 下装文件 5 1 6 工程
2、文件操作 5 二次开发接口介绍二次开发接口介绍 6 6 2 1 数据类型 6 2 1 1 基本数据类型 6 2 1 2 消息 6 2 1 3 显示区域 7 2 1 4 光标 7 2 2 键盘接口函数 8 2 3 LCD 接口函数 8 2 4 底层输出函数 9 2 5 GDI 接口显示函数 9 2 6 蜂鸣器与时钟接口函数 13 2 6 1 蜂鸣器函数 13 2 6 2 时钟接口 13 2 6 3 定时器接口 14 2 7 文件操作函数 15 2 8 数据库操作函数 BDC H 17 2 9 GUI 组件库函数 19 2 10 消息处理函数 31 2 10 1 系统消息处理 31 2 10 2
3、GUI 消息处理 32 2 11 标准C数据转换函数 34 2 12 标准C字符串函数 34 2 13 图标资源 35 2 14 串行通讯类 36 2 15 权限管理类 38 2 16 环境变量类 38 2 17 输入法接口 40 2 18 系统服务调用 41 二次应用程序开发说明二次应用程序开发说明 A1 平台的应用程序可用 ARM 处理器的开发工具 ADS ARM Developer Suite 进行编写与 编译 这里主要介绍我公司提供的集成开发环境 cbjtool2007 来开发二次应用程序 1 11 1 cbjtoolcbjtool 安装安装 将 CbjTool2007 目录整个拷贝到
4、您的电脑根目录下 BIN 可执行文件 EXE LIB 运行库文件 a INCLUDE 头文件 H 1 21 2 编写应用程序编写应用程序 源程序可以在任何编辑软件中进行编辑 即可以用通用工具 写字版 UltraEdit 32 等 和我们提供的 CbjTool exe 该文件在 BIN 目录下 1 31 3 编程注意事项 编程注意事项 在定义数组的大小时应将字符串结束符 0 考虑进去 否则若引起 RAM 地址冲突可能会产 生不可预料的结果 例如 取时间函数getDateTimeStrgetDateTimeStr s 返回的是 17 个字符长的时间 串 加上结束符 0 共 18 个字节长 故定义
5、s 的大小时至少是 18 个字节 1 41 4 编译程序编译程序 1 4 11 4 1 CbjtoolCbjtool 编译工具编译工具 在 BIN 目录下 Cbjtool exe 具有抄表程序编辑 编译功能 运行平台 win9x win2000 winXP 1 4 21 4 2 编译步骤编译步骤 如果我们的程序是用通用工具来编辑的 那么编译前也要把程序存到某个目录下 然后 才能对其进行编译 编译过程如下 运行 Cbjtool exe 在菜单 文件 里打开文件 即所要编译的 C 源程序 在菜单 程序 里选择 编译 编译没有错后再选择 连接 或直 选择 生成 也可以直接单击工具栏上的绿色三角符号
6、如果程序是在 Cbjtool exe 下编辑的 存盘后直接对其编译就可以了 编译方法同 如果程序没有错误 编译连接后生成 bin 文件 o 文件 axf 文件 在 Cbjtool exe 界面的下方有编译结果报告 1 51 5 下装文件下装文件 程序正确编译后生成的 bin 文件 我们要把它下装到抄表机上 以使其在抄表机上运行 下装前请先连接好抄表机与微机的通讯电缆 并进入抄表机的通讯等待状态 然后点击 cbjtool exe 中的 下装程序 菜单 或快捷按钮 即可 如果要下装数据库 dbf 文件 可点击 cbjtool exe 中的 通讯管理器 菜单 或快捷按钮 1 61 6 工程文件操作工
7、程文件操作 如果您的源程序在多个文件中 就需要建立工程文件统一编译连接 具体步骤如下 先选 择 cbjtool exe 中 工程 新建 菜单 在弹出的 另存为 对话框中选择存放有源程序的 目录 并输入一个工程名 然后点 保存 这时 cbjtool 将新建一个扩展名为 JBP 的工 程文件并打开 工程管理器 您可以在 工程管理器 中添加源文件 注意 软件会自动 将包含 main 函数的 C 文件排到工程文件列表的最上面 另外 一个工程中所有用到的源 文件 C 头文件 H 及工程文件 JBP 必须放在同一个目录下 以后可以选择 cbjtool exe 中 工程 打开 菜单来打开已经建立的工程 工程
8、打开后要进行编译连接时请选择 程序 生成 或点击三角形的快捷按钮 二次开发二次开发接口介绍接口介绍 A1 平台二次开发接口由一系列数据类型与系统功能调用 API 函数组成 如无特别声明 A1 平台的所有数据类型及函数原型均在 jblib hjblib h 头文件中 2 12 1 数据类型数据类型 这里将介绍 A1 平台开发时所需用到的一些常用数据类型 则于 GUI 组件类别及其属性较多 所以与 GUI 组件相关的数据类型将放到 GUI 库函数说明中介绍 2 1 12 1 1 基本数据类型基本数据类型 U8U88bit 无符号类型 同 unsigned char U16U1616bit 无符号类
9、型 同 unsigned int U32U3232bit 无符号类型 同 unsigned long P U8P U8指向 U8 类型数据指针 同 unsigned char P U16P U16指向 U16 类型数据指针 同 unsigned int P U32P U32指向 U32 类型数据指针 同 unsigned long 注意 全局变量只能动态始化 局部变量可以静态初始化 即声明时初始化 2 1 22 1 2 消息消息 与消息处理相关的数据类型只有一个 TMsg 结构体 其声明如下 typedeftypedef packed packed structstruct tagMessag
10、e tagMessage unsigned intMsgMsg void ObjObj unsigned shortWParamWParam unsigned shortLParamLParam unsigned charResultResult TMsg PMsg TMsg PMsg 成员说明 MsgMsg 消息类型 ObjObj 消息目标对象 即将接收并处理该消息的对象 若消息处理对象不确定 或者该 消息需要多个可能的对象处理则 Obj 值可能为 NULL WParamWParam 消息参数 1 具体容依消息类型而定 LParamLParam 消息参数 2 具体容依消息类型而定 Resul
11、tResult 消息返回值 若该消息被处理 Result 将被置值为 MSG OK MSG OK 值为 1 2 1 32 1 3 显示区域显示区域 矩形区域结构体 RectRect typedeftypedef structstruct tagRect tagRect U8leftleft U8toptop U8rightright U8bottombottom U8widthwidth U8heightheight Rect PRect Rect PRect 成员说明 leftleft 矩形区域左边坐标 tToptTop 矩形区域顶部坐标 rightright 矩形区域右边坐标 bottom
12、bottom 矩形区域底部坐标 widthwidth 矩形区域宽度 heightheight 矩形区域高度 注意 若要更改 Rect 大小及位置请使用以下四个宏来操作 SetRectWidth rt value SetRectWidth rt value 设置 Rect 宽度 SetRectHeight rt value SetRectHeight rt value 设置 Rect 高度 SetRectTop rt value SetRectTop rt value 修改 Rect 顶部位置 SetRectLeft rt value SetRectLeft rt value 修改 Rect 左
13、边位置 2 1 42 1 4 光标光标 typedeftypedef packed packed structstruct tagCurosr tagCurosr HWNDHWNDownerowner U8typetype U8x x U8y y U8flagflag Cursor PCursor Cursor PCursor 成员说明 ownerowner 该光标所有者 即需要显示光标的组件 typetype 光标类型 光标显示形状 0 2 分别为坚线 工字型 下划线型光标 x x 光标 X 坐标 屏幕坐标 y y 光标 Y 坐标 屏幕坐标 flagflag 光标状态 为 1 则光标正在显示
14、 为 0 则光标已消隐 2 22 2 键盘接口函数键盘接口函数 键盘按键值分为扫描码与标准键值两种 即一个按键可以用扫描码与标准按键来表示 扫描码与键盘设计布局有关 如果键盘布局设计变更其扫描码可能也会变化 标准健值是 固定的 如 退出 ESC 键在不同型号不同键盘布局的机器上键值均为 27 1 U8 keygos keygos U32 n n 功能 从键盘接收一个按键 等待 n ms 指定时间 参数据 n 等待的延时参数 单位为毫秒 返回 有按键则为键值 无按键返回 0 备注 keygos 返回的按键值为扫描码 区别于标准键值 如 退出 键值为十六进制 0 x03 系统定义为常量 CK ES
15、C 扫描码定义均以 CK 打头 可以在 keydef h 头文 件中找到所有键码定义 2 U8 key U16key U16 msg msg 功能 从键盘等待一个按键 如果没有按键 则无限期等待 直到按键产生为止 参数 msg 为指向十六位无符号数的指针 如果不需要处理消息则直接令 msg 为 NULL 或 0 即可 返回 有按键才返回 返回标准键值 msg 返回本次按键的消息值 备注 key 返回的按键值为标准键值 如 退出 键键值为 27 同 PC 机 ESC 键值一样 系 统定义为 VK ESC 标准键值定义均以 VK 打头 可以在 keydef h 头文件中找到所 有键值定义 2 32
16、 3 LCDLCD 接口函数接口函数 LCD 接口函数提供 LCD 屏的直接控制与绘图操作 属于较为底层的开发接口 若非需要较 高的绘图性能与响应速度 一般显示输出请使用 GDI 函数集 1 void lcd setcontract lcd setcontract int c c 功能 设置 LCD 屏对比度 参数 对比度取值围 0 255 2 void LCD ShowImage LCD ShowImage U8 bufbuf U8 startx6startx6 U8 startystarty U8 endx6endx6 U8 endyendy U8 mode mode 功能 显示一 4 位 16 级灰度图片 参数 buf灰度图片数据 startx 图片左上角 x 坐标 屏幕坐标 starty 图片左上角 y 坐从标 屏幕坐标 endx 图片右下角 x 坐从标 屏幕坐标 endy 图片右下角 y 坐从标 屏幕坐标 mode 显示模式 目前保留没用 2 42 4 底层输出函数底层输出函数 底层输出为操作系统支持的几个最简单的输出操作 而其它类别的输出调用 如 GDI 与 GUI 函数库
