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\winXP

1.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 char

U1616bit无符号类型.同unsigned int

U3232bit无符号类型.同unsigned long

P_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值可能为NULL

WParam:消息参数1，具体容依消息类型而定

LParam:消息参数2，具体容依消息类型而定

Result:消息返回值，若该消息被处理Result将被置值为MSG_OK(MSG_OK值为1)