074 基于Palm OS的通讯系统样本
(样本只提供该系统的基本情况介绍,若需要完整的设计和论文,建议您购买本系统,凡是购买本站系统的,本站均根据您的要求,把系统上的开发信息,题目等修改成符合您的要求)

 

本设计包含内容：源代码+毕业论文
论文大概：
 
 

 

目    录

1 绪论
1.1引言…………………………………………………………………………………….................. 
1.2 Palm OS在嵌入式开发中的地位……………………………………………………………….
    1.3 Palm OS通讯系统的前景………………………………………………………………………
2 研究背景
2.1 Palm的硬件介绍…………………………………………………………………………………
2.2 Palm OS操作系统特点…………………………………………………………………………..
2.3 Code Worrior7.0概述……………………………………………………………………………
2.4 Palm OS编程的基本概念……………………………………………………………………….
3 系统分析
3.1 “我的收支”程序需求分析……………………………………………………………………….
3.2 “我的收支”程序可行性分析…………………………………………………………………….
4 总体设计
4.1 软件流程…………………………………………………………………………………………
4.2 操作流程图……………………………………………………………………………………
4.3 内部模块设计图……………………………………………………………………………….
4.3.1 应用程序窗体事件处理模块…………………………………………………………
     4.3.2主窗体事件处理模块…………………………………………………………………
4.3.3 数据库记录管理模块…………………………………………………………………
4.3.4 整体构成………………………………………………………………………………
5 详细设计和实现
5.1界面设计………………………………………………………………………………………
5.2 事件循环………………………………………………………………………………………
5.3模块设计………………………………………………………………………………………..
5.3.1 应用程序窗体事件处理器设计………………………………………………………
        5.3.2 主窗体事件处理器设计………………………………………………………………..
5.3.3数据库管理设计………………………………………………………………………...
5.4 调试运行与安装……………………………………………………………………………….
6  实现同步通讯
6.1 同步的概念……………………………………………………………………………………..
6.2 与其他设备通讯的几种方式……………………………………………………………………
    6.3 同步通讯操作…………………………………………………………………………………...
7 结束语…………………………………………………………………………………………………..
附录：Palm OS软件设计术语……………………………………………………………………...
致谢………………………………………………………………………………………………..
参考文献………………………………………………………………………..…………………..

 

 

 

 

 

 

基于Palm OS的通讯系统
摘要：掌上电脑是个全新的领域。后PC时代是嵌入式和网络化的时代,在PDA市场激烈竞争的今天,有关Palm OS 的研究、开发和应用也将随之推广。本课题是基于Palm OS的软件开发和应用。即将计算机软件技术应用于小型移
动设备,着力开发一个小型通讯系统。
该文首先介绍了Palm OS作为智能手机的操作系统的现状以及基于Palm OS通讯软件的前景；随后讲述基于Palm OS开发的必需背景知识,包括Palm硬件,操作系统特点和开发工具介绍；从第三章起开始介绍“我的收支”应用软件的设计。需求分析章节讲述了用户需求和软件基本功能定义。总体和详细设计是整个论文的主体,阐述了大部分设计过程。最后我们讲述了如何将我们的设计的软件与台式机同步通讯。
本课题实现的PDA通讯软件具有设计相对简单,但却能充分利用掌上电脑的有限资源达到方便实用的目的。
 
关键词：掌上电脑,Palm OS,Code Warrior,通讯系统,我的收支

 

 

 

 

1 The Communication System of Palm OS
Abstract：On the palm the computer is a brand-new field. The latter PC time is inserts type and the network time, in PDA market steep competition today, related Palm OS research, development and application work also along with it promotion. This topic is based on the Palm OS application and the development, applies the computer software technology to the small mobile equipment, wears the strength to develop a small communication system.
The paper first introduced Palm OS becomes the intelligent handset the operating system and Palm the OS communication software foreground; Afterwards narrates based on Palm the OS development essential background knowledge, including Palm hardware, operating system characteristic and development kit introduction; Starts my revenue and expenditure application software design from the third chapter. The demand analysis chapter narrated the user demand and the software basic function. The overall and the detailed design are the entire paper main body, elaborated the majority of designs process. How finally did we narrate ours design software and the table model computer synchronized communication.
This topic implementation PDA communication software has the design to be relatively simple, but actually can fully use on the palm the computer restricted resource to achieve the convenience practical target.
 
Key Words：Palm Computer ,Palm OS,Code Warrior ,Communication System,My income
  

 

 

1 绪论
1.1 引言
     2004年2月24日,下一代移动设备及智能手机操作系统Palm OS 的供应商PalmSource公司推出了迄今为止世界上功能最强的智能手机-----G88 Palm Powered(tm) GSM 。 该手机是最新一款全功能智能手机,使用嵌入式操作系统---Palm OS,它将传统的Palm OS PIM 功能与电话所需的性能特点集成于小巧而紧凑的外形结构之内。不仅如此,因为Palm OS 平台的设计基于开放式模块化架构之上,所以它允许用户及软件开发商为通讯领域、文化教育、企业应用及娱乐市场开发出不同的产品和解决方案,完全实现移动手机跟个人PC计算机的融合。    
Palm OS是全球已售出的3,000多万台Palm Powered™智能移动设备的基础平台,它以其强大功能、灵活特性、易于使用的用户界面闻名遐尔。强大的Palm OS 开发者社区拥有超过275,000名成员,是Palm Powered经济圈的核心组成部分,并且已经成为Palm OS平台在全球手持设备及智能手机市场中获得成功的关键。Palm Powered 智能移动设备目前已经拥有超过20,000 种应用软件可供使用,用户可以根据自己的特殊需要进行专项设置并最终成为个人日常工作和生活中不可或缺的亲密伴侣。针对通信、企业、教育以及娱乐市场创新设备的产生而设计的全新增强版本的操作系统——Palm OS Cobalt将大大加速Palm Powered™的掌上电脑和智能手机的开发,Palmsource公司同时还发布了目前市场上最流行的PalmOS 5的升级版——Palm OS Garnet。PalmOS Combalt和Palm OS Garnet这两种版本的操作系统在保持了Palm Powered平台业界著名的灵活性的同时,又赋予了其新的功能。PalmOS Cobalt为更多全新种类的智能移动设备以及解决方案的诞生铺平了道路。在Palm OS Cobalt和Palm OS Garnet中添加的无线功能将赋予更多厂商推出更多种类智能和无线产品的能力。
可以说,基于Palm OS 平台的软件设计特别是通讯软件将是一片全新的领域。
1.2 Palm OS在嵌入式开发中的地位
目前国内嵌入式操作系统主要有两大类：Palm OS和Windows CE,国内以Windows CE为主,但在国际市场上Palm完全占主导地位,（其原因是由于Palm在中国的投入力度不够,宣传和推广没落实。Palm公司已经意识到这个问题,正加快对国内市场的开发）。                                                                                                    
Palm 0S平台是掌上电脑操作系统的开元鼻祖。早在1996年它就造成了全球掌上电脑市场的爆炸式增长,现在全球有57％的个人用户使用该平台,其用户数超过其他操作系统用户数的总和。今天,该平台已经成为全球2500万零上电脑和智能电话的基础平台,全球25万开发商基于PaIm 0S平台开发了1.5万多种应用,消费者自发组织的“Nm用户俱乐部”在全球超过160个。
随着Palm OS Cobalt的推出,PalmSource公司扩展了在多媒体和通信领域的平台领导地位。加之Palm OS Cobalt具有强大的安全框架,从而在商业和企业市场获得了更好的发展机会。新一代Palm将使用204MHZ的StrongARM CPU,同时加入MP3解码专利,增强了多媒体功能。
Palm OS是一个非常优秀的操作系统,在某种程度上比WinCE的性能更好,随着掌上设备的发展,移动应用软件将带动整个软件产业的发展。
1.3 Palm OS通讯系统的前景
    Palm OS软件库内容丰富,其设计初衷即为向通讯领域、企业应用、文化教育及娱乐市场提供种类多样的垂直解决方案,其中包括网络浏览器、电子邮件及互联网通讯软件、销售员工团队及业务实地自动化软件、个人效率管理、群件、财务管理软件及游戏软件等。
近几年有关PDA的技术飞速发展,这种手持设备集中了计算、电话、传真和网络等多种功能。它不仅可用来管理个人信息(如通讯录,计划等),更重要的是可以上网浏览,收发Email,发传真,甚至还可以当作手机来用。尤为重要的是,这些功能都可以通过无线方式实现。当然,并不是任何PDA都具备以上所有功能。即使具备,也可能由于缺乏相应的服务而不能实现。但可以预见,PDA发展的趋势和潮流就是计算、通信、网络、存储、娱乐、电子商务等多功能的融合。
2004年4月,随着英特尔发布了其XScale处理器家族的升级产品PXA270系列处理器,PDA市场非常火爆。采用Intel Xscale PXA270处理器的奔迈Palm Zire72中文版于2004年5月在我国上市,受到热烈欢迎。Zire72作为使用PXA270处理器的市面上第一款掌上电脑,享尽了该款处理器带来的种种好处,高达312MHZ的主频让Zire72反应迅捷流畅；专门为可拍照手持设备开发的Quik Capture接口技术使得Zire72轻松拥有高达120万像素数码摄像、拍照功能；源于PC处理器的Wireless MMX技术和其他多媒体图形加速技术使得Zire72具有与PC相似的多媒体能力,支持realone进行MP3播放,更让人津津乐道的是其支持AVI和MPEG的视频播放让您轻松拥有一部掌中影院。此外,起内置的电话拨号软件使你在任何时候只要插入一张手机卡即可轻松实现语音及视频电话（手机卡服务商提供视频服务的话）。其内置的web浏览器也可也使你畅游无线因特网,这一切都可以在手掌上发生。
从以上好消息可以看出,掌上电脑特别是跟智能手机融合的掌上电脑将给人们将来的生活带来翻天覆地的变化。掌上电脑、手机、数码相机、数码摄像机渐渐进入我们的生活,在Palm OS 及其应用软件的帮助下,它们的界限将更加模糊。移动＋宽带＋多媒体将是IT最大的未来,不论是Palm,Win CE还是其他手持移动设备,都让我们享受精彩的信息世界。

 

 

 

2  研究背景
2.1 Palm的硬件介绍
Palm与PC机的比较
项目 PC Palm
CPU Pentium III,IV….
AMD K7 series…. Motorola 68328,68EZ328
(DragonBall)
RAM SDRAM,DDRAM
32MB—1GMB以上 Flash RAM
2MB---32MB
Hard Disk 有 无
屏幕分辨率(像素) 640x480,800x600,1024x768… 160x160
处理速度(HZ) 1000M以上 16M或者20M
I/O 键盘,鼠标等 手写输入
电源 家用交流电源 电池
可移植性 无 有
待机时间 有限时间关机 永不关机
                               表2-1
由表2-1可知,Palm与PC有明显的差异。
2.2 Palm OS操作系统特点
Palm OS操作系统是运行于一个多任务抢占型系统内核的顶端。一个任务用于产生用户界面,其它的任务处理用户输入等。 用户界面每次只允许一个应用软件运行。
其特点有：
⑴ 内存管理
内存是掌上设备中比较独特的部分。RAM随机存储器在Palm OS系统中别用于两个目的：
① 动态内存 这部分内存是在系统和应用软件运行时才需要的。它其中还包含了软件所需的堆栈。当重新启动系统以后,该内存空间被清空,这部分内存的用途有点像传统的台式机操作系统下的内存。因此Palm OS设备不可随便切断电源,否则将造成数据丢失等严重后果。
② 永久存储 这包括了那些下载到掌上设备中的软件和数据,用户将在掌上设备上访问、编辑这些软件和数据。如计划事件、名片和电话号码、备忘录,以及其他所有内嵌软件所需的数据,都放在这部分内存中。每次重启时,这部分内存还是保持原样。我们可以把这部分的内存看成是台式机的硬盘上对各种文件的存储。
注意：和传统的台式机的操作系统不同,永久存储区的数据和代码不是复制到动态存储区来执行的,掌上设备的数据和代码都是在它们在永久存储区的所在位置直接被使用的。例如,当执行某部分程序时,就是直接在永久存储区该程序存放的位置被执行的。因为永久存储区位于RAM中,因此CPU当然可以直接读取它们,就像读取其它的RAM一样。同样,其中的数据也能够直接在存储位置被读取和显示。
⑵ 资源管理
我们可以把Palm OS系统中的一个应用软件看成是一个资源数据库,其中包含了很多不同的资源。每一个资源相当于数据库中的记录,有类型,有编号。按照这种存储方式,各种资源提供了应用软件所需的内核和外观元素。在台式机上,这些资源数据库的扩展名是.PRC。
资源中包含的一些内容如下：
 程序的源代码
 用户界面元素
 文本
 窗体
 图标
用户界面元素将根据资源中的描述进行初始化,然后显示在掌上设备的屏幕上。因为初始化过程不是在软件的源代码中完成的,因此,开发人员可以改变用户界面（如,改变软件的语言）而不需要对程序的源代码作修改。另外一个优点就是,您可以使用可视化编辑器来显示和编辑软件的用户界面的各个部分。这些编辑器能够允许您方便地改变外观效果和数据的输出效果,而不需要重新编译和重新载入该应用软件。
3. 事件驱动
Palm OS软件是事件驱动的。事件的发生,就像手写笔的按下和抬起,然后您的软件就会对着写事件做出响应。其中的一些事件是由应用软件来处理的,其它的将由操作系统来处理。一旦软件启动,它将进入一个事件循环,周而复制地捕获事件并处理它们。该事件循环只有在用户打开另外一个应用软件,关闭当前的软件时才会结束。
4. 窗体和控件
Palm OS有一个内置的机制,用于支持各种控件和管理窗体。窗体和一个台式机系统中的窗口有点相似。因为Palm OS应用软件的用户界面的局限性,每次当后多个窗体显示时,只有一个是被激活的。
5. 通讯
Palm OS系统支持多种通讯方式。因为通讯模块是Palm取得成功的根本因素,您可能认为在当前和未来的应用软件中,操作系统的这部分还是一个很值得探讨的方面。当前的通讯协议如下：
 串行通讯
 拥有socket接口的TCP/IP通讯
 红外线。低水平的红外通讯是通过IrDA（Infrared Data Assocation）是实现的
 高水平的对象交换能够支持在Palm设备和支持工业标准对象之间的信息交换。当前,这些对象还只能通过IRDA实现。不过以后会提供更多的信息交换技术。
2.3 Code Warrior7.0概述
 CodeWarrior for Palm OS 7.0是Metrowerks公司开发的经Palm公司官方认可的Palm OS系统软件开发工具。它是一个商业化的开发平台。本来CodeWarrior只是一个专门用于Macintosh平台的开发工具,现在是被移植到Windows平台上来。它允许开发者创建ANSI C 和 C++程序,支持Macintosh或者Windows NT4.0或以上系统平台。目前它已经包含了Palm公司的Conduit SDK（软件开发工具包）,以及Palm自己的开发文献。
它包括：
2.3.1 Metrowerks的构造器（Constructor）
Constructor是一个图形界面的资源编辑器,用于为您的应用软件创建用户界面元素。 使用Constructor创建资源
 
                             图1  construtor构造器

 

 

4 概要设计
4.1  开发流程图
 
图4  开发流程示意图
数据存储字典：
 
                                  图5  数据存储字典
4.2 操作流程图
              
                                  图6   操作流程图
4.3 内部模块设计
    根据软件功能定义,为了实现软件的几个基本功能-----即创建数据库和添加记录、删除记录、查询记录,通过Palm OS的Hotsysnc实现数据同步,我们把功能模块分成三个部分：应用程序窗体事件处理部分,主窗体事件处理部分和数据库记录管理部分。它们的函数构成如下,分别实现各自功能。
4.3.1 应用程序窗体事件处理模块
 
                                  图7  应用程序模块图
4.3.2 主窗体事件处理模块
 
                                图8  主窗体模块图
4.3.3 数据库记录管理模块

                                 图9  数据库管理模块图
以上是主要模块的函数构成。

                             图13 资源编辑窗口三
 
                                图14   警告窗口

 

在这个窗口中会指出错误的位置,并列出代码用以更正。更正错误之后再进行Make。若没有出现其他提示,则表示Make完成,并且会在工程目录下的Obj文件夹下生成.Prc文件,即可执行文件。
可执行文件的安装：将.Prc文件拖入POSE仿真器,鼠标右击仿真器,在弹出的菜单中选择Reset,软复位之后即可在Palm设备中看到应用程序的启动图标,如图十九所示。
 
                   图20  My income通讯软件成功下载到PDA设备

 

 

 

 

 

6 实现同步通讯
6.1同步的概念
      能与台式机同步和共享数据是Palm OS掌上电脑得以普及的关键。台式电脑善于大量的数据输入和数字处理,但用户无法把它放在口袋里去拜访客人。掌上电脑非常适合用于迅速记录便条以及约会提醒,但它决不可能用来分析财务报告和写书。这两种设备联合起来比它们各自功能的总和还大。
实现PDA设备与台式机同步,实际上是在掌上电脑和台式机之间建立一个“导管”。该导管存在于台式机上,并与掌上电脑的应用程序HotSync同步,HotSync调用其中的代码,这些代码精确地控制两者之间的数据传输。导管在其中扮演至关重要的角色。
当进行同步的时候,台式计算机必须运行Palm Desktop或者相关同步软件,要同步的数据库存储在这台计算机上,此时,导管会对数据进行筛选,并根据用户的优先选择将数据传给掌上电脑。导管同时负责观察两个数据库的记录,并确定它们之间哪些记录是不同的,同时还要负责确定数据的传递方向。确定哪些数据需要更新之后,导管还要将其处理转变为掌上电脑应用程序可读的形式,然后开始传送给掌上设备。
当然,虽然导管可以达到细节上的同步逻辑水平,但是如果应用程序不需要的话,我们也可以使用缺省的“备份导管”。“备份导管”不是逐条地比较掌上电脑数据库和台式机中的记录,而是为整个数据库做一个简单的拷贝,并传送过去。这种方法对小型数据库非常实用。
6.2 与其他设备通讯的几种方式
⑴ 串行通信协议
    通过托架（底座,cradle）,Palm OS掌上电脑通过串行电缆线与其他设备直接连接,它使用串行通信协议与台式计算机实现同步。
⑵ TCP/IP协议通信
    TCP/IP协议是Internet上的标准协议。掌上电脑可以通过适当的设备（如网卡）与Internet上任何一台计算机建立联系,并交换数据。Palm OS通过自己的网络库函数来建立TCP/IP连接。
⑶ 无线通信协议
    Palm VII上安装有无线通信协议,它通过Palm.net无线网络以实现Palm OS掌上电脑的无线通信。由于无线带宽比较敖贵,因此Palm OS无线通信系统使用一种称为“Web限幅”策略,以将通信量降至最少。无线Palm OS用户通过运行“Web限幅”的应用程序Clipper来浏览信息。
⑷ IrDA协议通信
     从Palm OS 3.0开始,Palm设备可以通过标准的IrDA协议来进行通信。在多种设备之间建立红外线连接,如手机,台式计算机,笔记本电脑等。Palm OS红外通信协议提供丰富的底层控制。
6.3 同步通讯操作
不管用那种方式进行同步通讯,一般都要用到HotSync和Palm Desktop。本课题中无法用POSE模拟,必须将.PRC文件下载到实际PDA设备中,产生数据记录后即可跟台式计算机进行同步操作。以托架方式同步为例,方法是：
连接托架
关闭计算机,将Palm托架引出的电缆插入计算机的串行通讯口。
 
图21 与台式机连接
注意：Palm需要一个专门的串口,它不能与内部调制解调器或其它设备共用一个串口。
 安装Palm Desktop Palm Desktop
 将Palm的许多功能扩展到计算机上。它能够使Palm上的信息与计算机上的信息完全同步。做同步处理之后,在Palm上或Palm Desktop上所做的修改会同时分别出现在Palm和计算机上。
系统要求：
要安装和运行Palm Desktop,计算机系统必须满足下列要求：
最低要求
 Windows95,98或WindowsNT4．0
 与IBM机型兼容的486计算机或更高级别的机型
 至少8MB内存,建议16MB
 12MB可用硬盘空间
 VGA显示器或更高级别的显示器(Palm Quick Tour需要256色视频显示）
 CD－ROM驱动器
 点选设备（鼠标等）
 一个可用串行口
可选设备
 调制解调器（如Palm调制解调器）
软件安装
为确保Palm Desktop的安装过程安全、无间断,在安装开始之前请做好以下工作：
 将Palm托架与计算机串口相连。
 如果您已经将Palm放入托架中,在安装过程中请将它取下
 退出所有程序,包括在启动时自动运行的程序,例如传真程序、病毒保护程序、屏幕保护程序以及象Microsoft Office那样的应用工具栏。
 不要把Palm文件简单地复制到硬盘上。应该通过安装程序把文件安装在合适的位置并把这些文件解压缩。
安装Palm Desktop：
⑴ 退出所有打开的Windows程序,并关闭任何病毒扫描软件。
⑵ 将Palm Desktop光盘插入计算机的CD－ROM驱动器。
⑶ 等待引导安装的界面出现。
⑷ 单击安装按钮开始安装。
⑸ 按照屏幕提示的指令完成安装。
这样启动Hotsync跟Palm Desktop之后,将Palm放到拖架上,按下“同步”按钮,即开始同步,直到同步完成,完成通讯过程。

 

 

 

 

 

 

 

7 结束语
经过一百多天的努力,在老师的悉心指导和组员的激烈探讨和学习下,我终于按时圆满完成了毕业论文。此时,我以愉快的心情写下这篇结束语,以表达其中的感受与收获。
首先,我觉得凡事都要有规划、有步骤的进行,所谓“预则立,不预则废”,这是我在开发完这套通讯系统之后的最大体会。因为刚开始,在拿到课题的时候我对掌上电脑一无所知,根本不知到从何下手。后来在老师的指导下,我们到处找资料对其进行研究了解。在随后在对硬件和Palm OS的编程思想有了一定了解以后,我们开始有计划、有步骤地实施开发计划,以至于到后来我们的开发工作越来月顺畅。遇到问题我们不是盲目地茫然,而是从相关知识了解起,逐渐学习、思考,最后达到融会贯通,为我所用。
其次,基于Palm OS掌上电脑的开发是一个新兴起的领域,今后要加强这方面的学习和研究。本课题设计的通讯系统目前只是一个模型,其功能还需要更加加强和完善。
总的来说,这个系统的开发实践使我进一步明确了掌上电脑的开发设计思想和方法,加深了我对手持移动设备软件设计的信心和决心,同时,通过亲身经历的所有开发过程,更加全面的巩固了所学的计算机知识,包括硬件和软件知识,特别是软件编程能力,为我以后的工作打下了坚实的基础。
 

 

 

 

 

致    谢
首先,在课题的完成和论文的撰写过程中我自始至终得到了导师刘铁武副教授的指导和帮助,没有刘教授的指导我是不可能完成本课题和论文的。刘教授治学严谨的科研作风、敏锐的思维以及诲人不倦的人生态度都给我以潜移默化的熏陶,使我终生受益。在此,谨向他致以深深的敬意与诚挚的感谢!
 在湖南工程学院学习的四年时间,我的学业和身心每一步的成长中无不饱含着大学所有老师的心血,在此向曾给予我关怀和支持的各位老师们表示衷心的感谢!在此尤其感谢刘教授。他曾在学习上给我了无私的指导,使我对计算机学科产生了浓厚的兴趣。
非常感谢我的同学黄瑜和杨昊两位在完成课题中对我的倾力相助,与他们的合作是非常愉快、非常成功的。在几个月的相互学习和探讨中,我们建立了深厚的友谊,我相信这将成为我人生旅途中一帧永存的瑰丽风景。
最后,我要感谢我的父母,他们含辛茹苦大半生,为了我的学业付出了无数的辛劳和汗水。在我完成论文之际,更由衷的向他们表示感谢!

 

 

 

 

 

 

 

 

 

 

附录一：源程序
#include <PalmOS.h>
#include <PalmCompatibility.h>
#include "StarterRsc.h"
/***********************************************************************
 *
 *   自定义结构
 *
 ***********************************************************************/
typedef struct
 {
 UInt8 replaceme;
 } StarterPreferenceType;

typedef struct
 {
 UInt8 replaceme;
 } StarterAppInfoType;

typedef StarterAppInfoType* StarterAppInfoPtr;

/***********************************************************************
 *
 *  以下是全局变量申明
 *
 ***********************************************************************/
//static Boolean HideSecretRecords;
static DmOpenRef MyDB;
static UInt16 TotalRecord;
static UInt16 RecordIndex;
static UInt16 TopRecord;
static DateTimeType RecordDate;
static Char RecordUsage[17];
static Int32 RecordAmount =0;
static Int16 RecordMethod =0;
static Char RecordRemark[51];
static Byte RecordInOut;

/***********************************************************************
 *
 *    内部常量
 *
 ***********************************************************************/
#define appFileCreator     'STRT'
#define appVersionNum              0x01
#define appPrefID                  0x00
#define appPrefVersionNum          0x01

// 预定义操作系统最小版本号为Palm OS3.5或更高
#define ourMinVersion sysMakeROMVersion(3,5,0,sysROMStageRelease,0)

#define DB_DATE   0
#define DB_DATE_SIZE (sizeof(DateTimeType))
#define DB_USAGE  (DB_DATE + DB_DATE_SIZE)
#define DB_USAGE_SIZE 18
#define DB_AMOUNT  (DB_USAGE + DB_USAGE_SIZE)
#define DB_AMOUNT_SIZE (sizeof(Int32))
#define DB_METHOD  (DB_AMOUNT + DB_AMOUNT_SIZE)
#define DB_METHOD_SIZE (sizeof(Int16))
#define DB_REMARK  (DB_METHOD + DB_METHOD_SIZE)
#define DB_REMARK_SIZE 50
#define DB_RECORD_SIZE (DB_REMARK + DB_REMARK_SIZE)

/***********************************************************************
 *
 *  以下为内部函数
 *
 ***********************************************************************/

/***********************************************************************
 *
 * 函数:    RomVersionCompatible
 *
 * 描述: 检测最低操作系统版本号            .
 *
 * 参数:  requiredVersion – 最少ROM版本号
 *        (在SystemMgr.h中查看sysFtrNumROMVersion格式即可)
 *
 *        launchFlags     - 应用程序初始化装载标记
 *                              
 * 返回值:   错误码或者0 （版本兼容时返回0）
*
 ***********************************************************************/
static Err RomVersionCompatible(UInt32 requiredVersion, UInt16 launchFlags)
{
 UInt32 romVersion;

  FtrGet(sysFtrCreator, sysFtrNumROMVersion, &romVersion);
 if (romVersion < requiredVersion)
  {
  if ((launchFlags & (sysAppLaunchFlagNewGlobals | sysAppLaunchFlagUIApp)) ==
   (sysAppLaunchFlagNewGlobals | sysAppLaunchFlagUIApp))
   {
   FrmAlert (RomIncompatibleAlert);
  
   if (romVersion < ourMinVersion)
    {
    AppLaunchWithCommand(sysFileCDefaultApp, sysAppLaunchCmdNormalLaunch, NULL);
    }
   }
  
  return sysErrRomIncompatible;
  }

 return errNone;
}

/***********************************************************************
 *
 * 函数:    GetObjectPtr
 *
 * 描述: 返回当前窗体的指针
 *
 *