Read Me

# readme.txt
#    
#    ding.lixing@gmail.com
#
#                                       JDS使用授权
#    您可以随意使用JDS及其附属资料，唯一的条件是您必须遵守BSD License或GNU Library or Lesser General Public License (LGPL) 的任意之一或全部。
#
#
# 
#
# 2009.03.03 dlx create

JDS简单介绍

1、JDS名称由来
    JDS的全称应当为JDSoE，是“JDS is a Developer Suit of Embedded system.”的简称。
    首字母J我倾向于将他解释为中国上古神话中火神“祝融”名字的第一个拼音字母，藉此希望自由软件在中国能够“星星之火以燎原”。
    当然JDS作为一个自由软件，对其名称的解释同样是自由的，您可以按您的意愿随意解释。

2、JDS目录组织
    JDS中包含多个子目录：
    DOCS：用于存放JDS的各种文档。
    hostBin：用于存放构建主机使用的软件工具
    	MS：windwos主机的软件工具
    	GNU：GNU主机的软件工具
    MAKE：用于存放makefile脚本
    SRC：用于存放JDS源代码
    	vm：不同目标板源代码及配置脚本
    	cm：多任务实时内核源代码
    	其他：更多的组件（目前还未实现）
    PROJS：用于存放各个工程
    	
3、建立您自己工程的简要说明
    建立一个新工程，最简单的方法是拷贝并修改已有的类似工程。
    对于每个发布的JDS版本，在PROJS目录中都会有一个测试工程，你可以将其拷贝并修改为您希望的名字保存在PROJS目录下。
    然后（为保持可移植性，文件名称需区别大小写字母）：
    1、修改makefile
    	a、通过赋值PROJECT_DIR为您的工程设置路径，注意目录分隔符应为“/”,如：“PROJECT_DIR = D:/work/project/JDS/PROJS/testApp”
    	b、通过赋值PROJECT_NAME为您的工程设置名称，建议工程名称与目录名称一致，如：“PROJECT_NAME = testApp”
    	c、通过赋值VM_NAME选择您使用的目标板，如：“VM_NAME = easyRAM213X”
		d、通过赋值USER_LIBS设置您自己的软件组件库，组件库的名称格式为“组件名称”+“Lib.a”，如：“USER_LIBS = mainLib.a uartLib.a testLib.a”
		e、通过赋值JDS_LIBS设置您需要的JDS组件库，组件库的名称格式为“组件名称”+“Lib.a”，如：“JDS_LIBS = cmLib.a”
    2、建立您自己的组件
   		a、复制已有的软件组件（JDS组件或用户组件），到您自己的工程目录并修改为合适的名称
   		b、在组件目录的SRC中添加源文件（删除原有文件），在include中添加组件对外的头文件（删除原有文件）
   		c、修改组件makefile：设置组件名称（组件名称必须与组件目录名称一致），设置组件的目标文件（对应于各C或汇编文件）

4、构建您的工程
   首先进入JDS主目录，对于MS主机（目前还未提供对GNU主机的支持，主要原因是我还不熟悉GNU的arm编译器，但将来会以GNU主机作为JDS的主要使用平台）执行build.bat批处理程序，它将为您设置环境变量，同时启动一个控制台程序。
   通过控制台程序，您可以进入您的项目目录。在此执行:
   a、make clean清除之前的编译结果
   b、make 构建您的工程
   需要说明的是，在每个工程目录中除用户组件目录外另需要有3个目录用于存放构建的中间结果，现在的makefile脚本并不支持自动建立它们。所以在建立新的工程目录时您需要自己建立，并保证里面没有任何文件和目录。它们是：
   dep：存放您工程的依赖文件
   obj：存放您工程编译的目标文件
   lib：存放组件库文件
   另外：每个用户程序的入口都为startMain，原型为“void startMain(void)”，它由vmInit负责调用。您可以在此完成对JDS和用户组件的初始化，并开始您自己的处理逻辑。
   
5、目前支持的vm
ARM
	lpc2210		采用lpc2210主处理器的一款简单开发板，由张珂制作，可以联系我或张珂获取原理图及相关资料。目前JDS中的所有源代码都是在其上进行调试的。
	easyRAM2131	周立功的一款arm开发板，使用芯片为lpc2131。对于lpc213X系列其他芯片，需要适当调整scatter和vmBoot.s，以符合其地址空间分配。
	对于使用arm主芯片的目标板，您应当在编译主机上安装有ads12。