linux二次开发指南

1、 A8二次开发平台应用软件开发指南版本2.1目录TOC o 1-5 h z1.简介4 HYPERLINK l bookmark8 2.二次开发平台架构4 HYPERLINK l bookmark12 2.1驱动层5 HYPERLINK l bookmark14 2.2LINUX内核5 HYPERLINK l bookmark16 2.3MINIGUI库、中间件5 HYPERLINK l bookmark18 应用程序5 HYPERLINK l bookmark20 3.建立开发环境5 HYPERLINK l bookmark22 3.1安装VMWARE5 HYPERLINK l bookmar

2、k26 3.2安装LINUX6 HYPERLINK l bookmark34 3.3安装VMWARETOOLS12 HYPERLINK l bookmark36 共享WINDOWS文件夹133.5交叉编译器安装14 HYPERLINK l bookmark44 3.6MINIGUI库安装15 HYPERLINK l bookmark50 4.应用DEMO介绍15 HYPERLINK l bookmark52 DEMO目录介绍15 HYPERLINK l bookmark54 PC端目录结构15 HYPERLINK l bookmark58 A8中目录结构16增加文件16增加文件夹16 HYPE

3、RLINK l bookmark66 编译DEMO174.5软件下载工具驱动安装194.6应用软件及相关资料下载234.7常用命令255.中间件接口使用说明275.1卡类操作27 HYPERLINK l bookmark90 5.1.1M1卡操作27设置卡片类型27寻卡27卡类型选择27读数据27写数据28权限控制28减值操作28加值操作29块拷贝29 HYPERLINK l bookmark92 PSAM/IC卡操作29卡片上电操作29卡片中文件选择30执行APDU命令30卡进行下电操作30IC卡插入检测30磁条卡操作31启动磁卡读31刷卡检测31读二磁道数据31读三磁道数据315.2打印机

4、操作32 HYPERLINK l bookmark96 缺纸检测32字体大小设置32字间距设置32行间距设置32打印浓度设置32开始打印一行字符33 HYPERLINK l bookmark110 停止打印335.2.8打印黑白图片33时钟操作345.4.1驱动应用层接口函数索引表：345.4.2应用层接口函数介绍：34网络连接操作35蜂鸣器控制36 HYPERLINK l bookmark130 LCD控制361.简介A8是本公司在多年专业技术积累的基础上开发出来的一个二次开发平台。为您提供灵活、可靠、易用的开发平台。通过二次开发平台可在短时间内实现各种各样的应用开发。A8二次开发平台采用的

5、是ARM9+LINUX+中间件+MINIGUI的组合方式实现的。2.二次开发平台架构A8二次开发平台以开源操作系统linux为基础、根据不同的硬件配置选择相应的驱动、采用MINIGUI为应用软件开发环境。实现各个层次的软件相互独立、独立开发调试，各层之采用标准接口进行交互。A8软件架构主要分为四个层次，分别是硬件驱动层、linux内核、MINIGUI库和中间件、应用软件层。另外还有一个就是系统引导代码bootloader,bootloader是系统上电后到linux内核启动前执行的代码。具体层次关系如图1所示。设备端sDK包r应用软件图1：A8SDK架构2.1驱动层向下实现对硬件设备的控制（包

6、括上下电、读写、复位等操作），向上为LINUX提供标准的接口（包括open、close、read、writ、ioctl等）。在linux中大部分设备都是以设备文件的形式出现，应用程序可以像操作普通文件一样来操作外部设备，但网络设备除外。2.2LINUX内核向下提供了标准的接口，便于驱动程序的注册，向上为应用软件、中间件、MINIGUI提供系统调用接口。2.3MINIGUI库、中间件Linux本身并不提供图形界面，根据产品的需求引入GUI库，库提供类似windows的消息处理机制，该机制符合目前大部分软件开发人员的开发习惯；开发人员不需要花费大量的时间和精力学习新的开发环境。中间件把A8中对外设

7、的操作进行封装，经过封装后中间件向应用层提供统一的接口。中间件作为二次开发平台的一部分以源代码的形式提供给用户。应用程序根据不同的应用开发相关的程序，在SDK中提供相关模块的应用示例，开发人员在实际开发过程中可参考示例进行编码调试。3.建立开发环境为能在PC上进行软件的编辑、编译、下载等工作，需要在PC端建立一个开发环境。先在WINDOWS中安装VMware虚拟机，然后在安装linux系统，最后安装相关的编译器等配套软件。为使项目成员开发环境尽可能的相同，请将相关开发软件安装在D:ProgramFiles下，除非软件本身只能安装在指定的路径。3.1安装VMWare1）先运行VMware-wor

8、kstation-5.0.0-13124.exe按提示将VMWare安装在D:ProgramFiles下2）运行hp_VMware3124_zmb.exe对VMWare进汉化。3.2安装Linux1）运行VMwareWorkstation2）选择新建拟机3）按下一步提示进行，当到“客户机操作系统”时，请选择您要在此虚拟机上安装的操作系统，并选择对应的版本。4）按下一步进入命名虚拟机，给虚拟机命名请统一命名为“Linux”,位置请统一放在D盘。位置（1）使用桥接网络”网络类型按下一步。虚拟机名称匹）LinuxD:IlocijjTierLtEHyVirtualM*hihe三Linux打开已存在的5

9、）网络类型选择网络连接用桥接网络进蓉戸机操作變竝直接访问外部以丈网络口客户机在外部网络中必须有自己的IF地址-O使用网络地址转换OTAT）（1）让客户机操作丟统使用主机的IF地址访问主计算机的拨号或外部比丈网络连接-養蟹走常鬱鑒倉1主计算机上的私有虚拟网络-O不使用网络连接（X）上一歩下一歩追）取消把显示的客尸操作东统作対一T标淮FC袞互-6）当到“指定磁盘容量”时，请把磁盘容量指定为大于10G；如容量足够,请设为20G.10.U0磁盘大小（GB）:0分割磁盘为2GB的文件（I）新建虔拟机向导磁盘容量此虚拟磁盘永远不会犬于你在这里设置的摄大容量O指定珀蛊容量你想要此磁盘多大?曙籍翳諜磁轎竊鰐翻

10、蠶謬雲贻会很小沁上一步完.成1取消马上分配所有磁盘空间黎曙諺豔蠶壽驪蠶靈翳韻豔菁而-38）根据需要选择相关选项（通常按照默认值）7）运行VMWareWorkstation-虚拟机-设置-CD-ROM（IDEl:0）-使用ISO映像-通过浏览.在F:开发工具软件开发工具RedHat9.0中选中shrike-i386-disc1开始安装linux。注：RedHat9.0可存放在其他目录下。Linuz状态：客尸操祚系蛟：配置童件：版本：电源关闭RedH：atLirm:D:VMyDijcujtimtlti.MyVirt口alMachineEVLinm:Vrmdhat.vtti当前虚拟机用于VMware

11、Workstation5.0.0设备启动此虚拟机编辑虚拟机设置克隆此虚拟机愛内存口硬盘(SCSI0:0)CD-EOM(IDE1:0)回软呃矚以太网USB控制器则音频512MB使用映像D:redhat2.使用呃动器A：桥接存在默认适配器备注在这里输入此虚拟机的备注9)安装完shrike-i386-disc1后，会提示插入第二张光盘，单击虚拟机-设置-CDROM(IDEl:0)-使用ISO映象-浏缆-选择shrike-i386-disc2-确定。继续安装。.L_r：.redhat.在线帮助正在安装软件包10)安装完shrike-i386-disc2后，会提示插入第三张光盘，单击虚拟机-设置-CDR

12、OM(IDE1:0)-使用ISO映象-浏缆-选择shrike-i386-disc3-确定。继续安装,直到安装完成.。A8开发指南 总迸程:更换光盘大小请插入第3张光盘后再継续。1721M0:211661M0:2160M0:00OpenO办暑音件、套件*和丈家分拿您的建址!OpenO的电。子邮件*文宇处理器、和文稿演示软件俛这一切成为可能做实事“的基本工具A8开发指南 RunninganacondajtheRedHatLinuxsysteminstaller-pleaseuait.Probingforvideocard:UESAdriver(generic)Probingformonitorty

13、pe:UnknounmonitorProbingformousetype:Generic-WheelMouse(FS/Z)AttemptingtostartmatiueXseruerUaitingforXservertostart.loglocatedin/tmp/X.logXseruerstartedsuccessfully.YoudonothaveVMwarEToolsinstiled.安装VMwaretools退出到windows-点击虚拟机(M)-选择设置-CD-ROM(IDE1:0)-使用ISO映像-通过浏览.在D:ProgramFilesVMwareVMwareWorkstatio

14、n中选中linux.iso进入linux在根目录下运行mount-tiso9660/dev/cdrom/mnt/cdrom,把虚拟光驱挂载到系统中。这时如果进入/mnt目录下，将会发现多了一个(或两个)文件：vmware-linux-tools.tar.gz。这就是WMWARETOOLS的LINUX软件包，也就是我们刚才使用WINDOWS打开linux.iso文件所看到的。用命令cp/mnt/vmware-linux-tools.tar.gz/tmp/把VMwaretools复制到tmp目录下。用命令umount/dev/cdrom从系统中卸载虚拟光驱。进入tmp目录，并用命令tarzxfvm

15、ware-linux-tools.tar.gz解压,，产生文件夹vmware-tools-distrib，进入该文件夹可看到文件install.pl，用. HYPERLINK /install.pl运行安装命令。按提示进行安装(基本上只要敲回车)。如果以前有安装过，则会提示你是否需要备份以前的配置文件，建议选择“y”。按照提示进行即可完成。虔拟机设置硬件选项设备気内存匚3硬盘（SCSI0CD-EOM（IDE回软驰轉以丈网USB控制器個音频：0)1:0)摘要512MB使用映像D:r.使用驰动器A:桥接存在设备状态可已连接（jc）可电源打开时连接辺默认适配器连接O使用物理驰动器（）：自动检测P匚连

16、接排除此虚拟机（1）以前版本模拟（1）使用iso映像（X）：D:FrogramFilesVMwareVT,浏览.查找范围（X）：口Recent我的文裆VMwareWorkstationrL-1rLO1CLu-1桌面3.4共享windows文件夹在安装完VMwaretools后，退出到windows-点击虚拟机（M）-选择设置-选项-共享文件夹-添加-下一步-在名称输入A8开发指南A8开发指南l5框中输入名称（如share-win）；在王机文件夹中通过浏缆选择要共享的文件夹-下一步-完成。然后进入linux的/mnt/hgfs中，通过命令ls就可看到共享文件夹（如share-win）。虔拟机设置

17、硬件选项常规电源共事文件夹快照客户机隔离高级的拖放启用标淮/标淮命名共享童件夹你想要怎么调用此共享文件夹?摘要Linux名称浏览.取消3.5交叉编译器安装1）进入/usr/local/目录中2）把arm-linux-3.4.1.tar.gz拷贝到/usr/local/目录中。3）用命令tarzxvfarm-linux-3.4.1.tar.gz进行解压，在/usr/local/中生成一个arm目录，在arm目录中生成3.4.1。到此交叉编译器安装完成。Vioot!kcaItwst/usr/locaI*匕xlootlocaIhostrootloc3Ihcstbinetcgarresrcotloca

18、IhastrcotlocaIhast文件（）编辑（E）査看世）终端转到（Q帮助Qi）root#cd/usr/loca1/locI#IsincludeIibIibexecsbinsharesrclocaI#cp/mit/hgfs/share/crcss-conpile/arnrIinux-3.4J.tar,gz、locaI#IsarirrIinux-3.4J.tarbinetcgarresincludeIibIibexecsbinsharesrc|rcotlDcaIhastlocaI#tarzxvfarm-Iinux-3.4B1.tartgzMINIGUI库安装1）将arm-mg-gcc3.4.

19、1.tar.gz拷贝到/usr/目录中ruutlocaIhostiirnrOtd/rOOtlocaItiust/#Hbindevhorre1ibmiscoptroottftpboutusrbootetcinitrdlost+foundnntprocsbintnrpvarH.4.ruutluaIhost/#cp/nnt/hgis/share/aiTii-n-gcc3.4.1.tar,gz/usrrootlocaIhost/ffcd/usrruutluaIhostusrIs2）用命令tarzxvfarm-mg-gcc3.4.1.tar.gz进行解压产生文件夹arm-mg-gcc3.4.1XIIFt

20、fiariTmg-gccSt4.1.LartgzdietgarreskerbercsIibexecsbinsrcbinetincludeIibIccaIsharetnrprootlocaIhostusrjjttar-zxviarm-ng-gtc3.4.1ttartgzarnrmp-gc3.4./arnrmg-gc3t4.1/Iib.tartgzarnrmp-gc3.4./intlude/arnrmp-gcc3.4.1/include/nniniigui/arm-ng-gcc3.4.1/include/minigui/ext/到此完成开发环境的建立，可进行应用软件的开发了。4.应用DEMO介绍应

21、用程序主要包括两方面的内容，一是界面的开发，主要是通过调用MINIGUI提供的各类函数及相关图片来实现；二是在业务处理过程中相关模块的控制，比如Ml卡读写、IC卡读写、磁条卡读写、PSAM卡操作、打印机控制等。在SDK中提供一个应用程序的DEMO,通过这个DEMO开发人员能进行应用软件的开发。在DEMO中已经确定了相关资源的布局，开发人员根据实际需要在对应的文件夹中增加代码或图片或相关文件夹，并修改Makefile。4.1DEMO目录介绍4.1.1PC端目录结构在DEMO的一级目录中包括5个文件夹，分别是：l)bin在这个目录中包括一个Makefile、所有的目标文件、最终可执行文件。通过Ma

22、kefile实现对代码的自动编译。进入这个目录执行make命令就可对工程中的文件进行编译并生成可执行文件。可执行文件可通过USB口下载到A8中执行。2)doc在这个目录中含二次开发相关说明文档。应用程序开发过程中产生的文A8开发指南 档。middleware在这个目录中包含中间件相关接口头文件、中间件源码、中间件部分库。应用程序开发中应通过调用接口头文件实现对设备的操作。resource在该目录中有一个picture文件夹，主要保存应用中需要的图片文件。source在这个目录中包含所有的应用代码，这些代码按照业务模块进行划分，同一业务模块的代码(源文件和头文件)放在同一个文件夹中。对文件夹及文

23、件采用“望文生意”的方式进行命名。4.1.2A8中目录结构在A8中所有应用软件及相关资源都是放在/mnt/yaffs/目录下。通常为某个应用建立一个独立的文件夹，如sdk_demo,并在这个目录中存放相关资源。对于DEMO在sdk_demo中建有两个一级文件夹，分别是：1)bin该文件夹存放可执行文件、MiniGUI.cfg。MiniGUI.cfg要通过DNW下载到这个目录中，最好现在PC上先压缩成MiniGUI.cfg.tar.gz(压缩命令是tarzcvfMiniGUI.cfg.tar.gzMiniGUI.cfg)然后再下载，下载完后通过命令tarzxvfMiniGUI.cfg.tar.g

24、z进行解压。2)resource主要放相关资源，在这个文件夹中有一个picture文件夹，picture存放图片文件。增加文件以显示主菜单为例子，介绍如何在工程中加入代码源文件，主要分为以下几个步骤：poweron中添加MainMenu.cMainMenu.h在poweron.mk中在目标文件中增加MainMenu.o添加对MainMenu.c的编译规则，MainMenu.o:$(POWERON_SRC_PATH)MainMenu.c$(CC)$(CFLAGS)$(DFLAGS)$(POWERON_SRC_PATH)MainMenu.c通过以上两步骤就在已有的文件夹中添加了一个源文件，3)在b

25、in目录中执行make命令，如代码无错误就会在bin中生成目标文件和可执行文件。4.3增加文件夹通常开发中为一个新的业务建一个文件夹，用于存放相关代码。以消费业务为例子，介绍如何在工程中加入文件夹，主要分为以下几个步骤：在source目录中创建一个名字为trans的文件夹。在trans文件夹中创建一个文件trans.mk在trans文件夹中创建与消费相关的源文件，如money_input_win.cmoney_input_win.hpurse_win.c4)在trans.mk中写入本文件夹中各个源文件的编译规则。5)在bin目录下的Makefile中加入三项内容A8开发指南 a)源文件及头文件

26、所在的路径TRANS_SRC_PATH=./source/trans/TRANS_INC_PATH=./source/trans/b)包含trans目录中文件的makefileinclude./source/trans/trans.mkc）在依赖目标文件中加入目标文件$（TRANS_OBJ）编译DEMO1）首先将DEMO软件拷贝到共享目录（在3.4共享windows文件夹所设置的文件夹）中。或者在创建一个应用时就放在这个共享目录中。2）编译在linux桌面点主菜单-系统工具-终端如下图口门|显竝肿I-1口|凶二Ixhulb-TUwaireVEhntet1onACE廉KPfE）iRtliEJ兰看

27、03虚映护柚IB心圍口UpenXDl的主目录fttacH*BJT3FM:半luiAUs輔开11laSAEK副區ill的ra苦理酬.吳as恵忍乜型丄Iil固旳裁曲临也（3回回廈二丄出血X-I轧惱或；屮齐和出村卜Ct+ffl：,ME寡曙Jfc址设且ftit41卜：丸卉戎电容最爼r.nWl.-.i|FluHilrfNuUliuiUUhJiidhPliJMMnjOurflrdIIbINalw.ilwit內迄屬Mill店rAMi纲卄寤yI.!LJ松t挤式化狀1nmI词口卞DinkJ*ert/吨lk/harrZafrjwkxthtMb-按下鼠标左键出现一个终端窗口如下图A8开发指南 -通过命令进入到DEM

28、O的bin目录中,执行相关命名进行编译。编译完成后会在bin目录中生产相关目标文件和可执行文件。相关操作过程如下图，看不清楚请放大。4.5软件下载工具驱动安装1）将DNW目录下的secbulk.inf文拷贝到c:windowsinf文件夹中。Inf是一个隐藏目录，需要去掉文件夹的隐藏属性才能看到该文件夹。2）给A8上电3）用USB线连接PC和A8,PC会发现新硬件，然后会弹出“找到新的硬件向点击下一步PC搜索相关驱动搜索完成后弹出以下界面选中c:windowssecbulk.inf然后点击下一步弹出以下界面点击确定弹出secbulk.sys文件路径选择框，如下图通过浏览选择secbulk.sy

29、s存放路径，如下图点击打开然后再点击确定如果顺利则会显示下面界面，到此完成软件下载驱动程序的安装。4.6应用软件及相关资料下载1）用串口线连接A8和PC2）用USB线连接A8和PC3）在PC端打开一个串口工具（TCL或串口调试大师等）4）在串口中输入cat/dev/usbd/mnt/yaffs/xxxx/yyyy其中xxxx表示下载的内容存放的路径yyyy表示下载文件名称5）打开DNW对DNW进行配置（通常只需做一次）如下图：Configuration-Options点击OK完成设置。6）下载软件USBPort-Transmit弹出文件选择框如下图点击打开就开始下载，如下图下载完成后串口会显示

30、DownloadO.K.7)运行应用软件对于需要运行软件，先要改变其属性才能运行。通过命令改变一个文件的属性。chmod+xfilename通过这个命令就将文件filename改为可执行文件。运行文件只需要在文件所在的目录下输入文件名然后回车即可。注意：运行前请确保在该目录中已经有MiniGUI.cfg文件。常用命令1)cd目录切换命令cd/mnt/yaffs/sdk_demo通过绝对路径进入到sdk_demo目录。cd./sdk_demo通过相对路径进入到当前目录中的sdk_demo(当然这个目录是已经存在的)cd.退到上一级目录d)cd/退到根目录2)mkdir创建目录如mkddirtes

31、t在当前目录中创建一个名为test的目录。3)rm文件或目录删除命令如rmtest-rf强行删除目录test及目录中的所有命令，并不产生提示信息。4)touch、vi创建一个文件touch创建一个空文件如touchfilenamevi创建并编辑一个文件vifilename创建一个文件并进入编辑状态，编辑完后按ESC-按shift+:-保存修改内容按w-退出编辑按q通常vi用的频率比较高。5)insmod/rmmod驱动加载/协助命令在调用相关驱动函数或中间件之前要加载相应的驱动。如要在LCD上显示内容则先要加载LCD的驱动，insmod/mnt/yaffs/stdriver/lcd.o。驱动都

32、放在/mnt/yaffs/stdriver/目录中。在完成操作后通常为了降低功耗会将驱动卸载掉，通过执行rmmod命令实现。如rmmodlcd将LCD驱动从内核中卸载。在调试中可通过lsmod命名查看已经加载的驱动，该命令不需带参数。5.中间件接口使用说明中间件是对设备控制的封装，为开发人员提供简单、直观的编程接口。中间件包含大部分设备的控制接口。通过中间件开发人员无需了解linux相关的系统调用及设备驱动接口。卡类操作511M1卡操作提供操作M1卡的相关函数，函数实现文件为mifareone.c，接口头文件为mifareone.h。函数介绍如下：设置卡片类型longMifareCardTyp

33、eSet(longtype)函数功能：设置卡片类型(TYPE-A或TYPE-B)。通常使用比较少.输入：type0-TYPE-A；1-TYPE-B；输出：无返回：=0成功；其它失败；寻卡longMifareOne_SearchCard(unsignedchar*csn,unsignedlongwaittime)函数功能：搜索天线范围内的卡片,获得卡号。输入：waittime寻卡时间，以ms为单位；输出：csn选择到的卡系列号；长度大于10Byte的数组；第一个字节为卡号的长度，后面的为具体卡号返回：0csn长度(字节)卡类型选择longSlectCardType(longslecttype)函

34、数功能：选择需要使用的卡功能，某些卡(比如SIM-PASS卡)内部同时具有M1功能和Pro功能，此时程序需要指定操作的是那种功能。一般只有使用Pro卡的时候，才需要调用该函数输入：slecttype=0M1卡，=1Pro卡，=2Type-B卡；输出：无返回：=0磁道数据长度；其它失败；读三磁道数据longReadTrace3(unsignedchar*trace,unsignedlongmaxlen,long*tracestatus)函数功能：读三磁道数据。输入：maxlen准备接收的最大的数据长度输出：*trace三磁道数据*tracestatus磁道状态:0-磁道空;-无起始标志;-无结束

35、标志;-校验错误;返回：=0磁道数据长度；其它失败；副作用：无5.2打印机操作介绍打印驱动函数的使用，打印机的控制/使用。实现文件名称为printer.c，接口头文件名为printer.h。主意：longPrinterStatus(void)/longPrinterStart(longn)必须与longPrinterStop(longn)成对调用。5.2.1缺纸检测longPrinterStatus(void)/longPrinterStart(longn)函数功能：检测打印机的状态,是否缺纸输入：无；输出：无；返回：0正常；NOPAER缺纸;其它失败字体大小设置voidPFontSizeSe

36、t(longFontSize)函数功能：设置打印字体大小输入：FontSize字体=12/16/24/32输出：无；返回：无5.2.3字间距设置voidPSpaceSet(longspace)函数功能：设置打印字体的字符间隔输入：space以点为单位；输出：无；返回：无；行间距设置voidPLineSpaceSet(longlinespace)函数功能：设置打印字体的行间距输入：linespace以点为单位输出：无；返回：无；打印浓度设置longPrintDarkSet(unsignedchardark)函数功能：设置打印浓度输入：dark浓度值(值越大越黑)；输出：无；返回：0成功；其它失败

37、；5.2.6开始打印一行字符longPrint(char*str)函数功能：打印一行字符输入：str字符串指针，以“0”结束；输出：无；返回：0成功；NOPAER缺纸;其它失败5.2.7停止打印longPrinterStop(longn)函数功能：停止打印输入：无；输出：无；返回：0成功；其它失败打印黑白图片longPrintPicture(unsignedchar*str,longwidth,longheight)函数功能：打印一幅图片输入：Str图形点阵字库；Width图片宽度，=384Height图片高度输出：无；返回：0成功；NOPAER缺纸;其它失败使用说明：1)使用“Bmp_Too

38、ls.ext”生成点阵字库，如下图2)该软件将生成一个点阵字库数组，保存在PIC_HZK中，保存在PIC.TXT文件中。将文件中的内容拷贝到代码中。3)最后参考上面的提示，进行函数的调用。即可。时钟操作5.4.1驱动应用层接口函数索引表：一序号功能描述1longWrite_Date(unsigned*output)char写日期2longWrite_Time(unsigned*time)char写时间3longRead_Date(unsigned*output)char读日期4longRead_Time(unsigned*time)char读时间5.4.2应用层接口函数介绍：longWrite_Date(unsigned