CDM530AM-GPL Release Note

===========================================================================================
HOW TO SETUP THE ENVIRONMENT:

1.Contents:
	a) GPL: the source tree directory.
	b) buildroot-gcc342.tar.bz2 : the toolchains used to build the firmware
	c) GPL_readme.txt: instructions of building firmware.

2.How to make?
	a) The compile environment we used is X86 CPU, Fedora 5.
	b) Untar buildroot-gcc342.tar.bz2 to /opt . 
	   You will get a directory "/opt/buildroot-gcc342".
	c) Untar CDM530AM_GPL_xxx.tar.bz2 to /tmp.
	d) Login as root.
	e) cd /tmp/GPL, and type "make" to bulid kernel and filesystem.
	f) After "make", you will get firmware image "/tmp/GPL/image/firmware.bin".
	   **Please make sure the size of your kernel(image/kernel.bin) must 
	   **be less than 1MB and file system (image/rootfs.bin) must be less than 2.6MB. 

3.How to install?
	a) Upgrade firmware.bin via router's Web UI. (please refer your user manual)
	   
	   *NOTE*, I have to say, if you modified something and cause some errors,
	   the device may not be able to restart again.
	   
	   So, PLEASE MAKE SURE YOU REALLY KNOW WHAT YOU ARE DOING BEFORE YOU
	   UPGRADE ANY UNOFFICIAL FIRMWARE.
	   
4.Some hints
	The plateform we used on this project is mips, yeah, you might have
	known that after unpacking the cross compiler.
	It means, every change you want to make, could be verified in PC
	first. It's important, or you may need to restore the flash image
	much often.

===================================================================================										

HOW TO ADD AN APPLICATION:

Introduction:
	This text file just a sample to show how to add an application to this GPL package.

Step: Add amit_test to the GPL package
	1)Copy the source of your application to open_src, so there will be a directory named amit_test
	  in ./rootfs/src/open_src

	2)Make sure your using compiler is mips-linux-uclibc in Makefile.
		CC = mips-linux-uclibc-gcc

	3)Add install script in rootfs/makefile.install, and make it copy to usr_src/bin or usr_src/sbin
	  Just as example in rootfs/makefile.install
		.PHONY: INSTALL.copy_amit_test
		INSTALL.copy_amit_test:
		    @cp -a $(COMPO_DIR)/amit_test                  $(INSTALL_ROOT)/usr/sbin

	4)Add the directory to rootfs/makefile.config
		COMPO_LIST += open_src/amit_test.60.mk
	  It will make amit_test when you make the file system.

	5)Add the directory name amit_test.60.mk to rootfs/open_src with a Makefile
		include ../../makefile.envars

		COMPO_DIR := $(COMPO_BASE)/open_src/amit_test

		include ../../makefile.compo
		include ../../makefile.install

		build:
		    make -C $(COMPO_DIR)

		install: INSTALL.copy_amit_test

		clean:
		    make clean -C $(COMPO_DIR)

		copying:

	6)Then you can make the FW using "make".

	7)You can check "image/root/usr/sbin/amit_test "if the application in in the FW or not.
