readme.txt

s3c2400 ads1.2 usos portting

Target board specifications
~~~~~~~~~~~~~~~~~~~~~~~~~~~

CPU : Samsung S3C2400 (ARM920T core)
ROM : HY29LV160 for internal boot ROM and HY29LV1024 for external boot ROM
RAM : Samsung K4S281632 16MB(2M*16bit*4banks) SDRAM * 2EA
Compiler : ARM Developer Suite 1.2


The version of this port
~~~~~~~~~~~~~~~~~~~~~~~~

uC/OS-II ver 2.51 for S3C2400 ver 3.0

Staff
~~~~~

This revision is ported by Lee Chae-Won in November 16th, 2003.
E-mail : [e-mail] ; [e-mail]
Homepage : http://user.chollian.net/~hebb/

Hardware & core firmware designer : Yoon Gwang-Yoon
E-mail : [e-mail]
Homepage : ARM STUDY GROUP (http://arm.cim.co.kr)

Description
~~~~~~~~~~~

This port is made for the purpose of studying and understanding the ARM system
in ARM STUDY GROUP (http://arm.cim.co.kr).
In some parts of important core routines, I refered to the sources of EP-7209 
ports by Mr. Kim Hyo-jun ([e-mail]).


Install guide
~~~~~~~~~~~~~

[1] Unzip all the stuffs in any folder. For example,

C:\UCOS251_S3C2400_ADS\
   common.h
   hwdefs.inc
   includes.h
   interrupt.c
   main.c
   misc.c
   mmu.s
   os_cfg.h
   os_cpu.h
   os_cpu_a.s
   os_cpu_c.c
   reg_define.h
   serial_poll.c
   serial_poll.h
   timer.c
   readme.txt - this file
   
C:\UCOS251_S3C2400\Source\
   uC/OS-II ver 2.51 core files. Refer to note.txt.
   
C:\ucos251_S3C2400_ADS\ucos251_S3C2400_ADS\
   ucos251_S3C2400_ADS.mcp  - Code Warrior Project file.
   
[2] Open ucos251_S3C2400_ADS.mcp in ADS 1.2 and Compile it!
   
Revision History
~~~~~~~~~~~~~~~~

2003. 4. 15. : Preliminary version completed. 
               Toggle 2 LEDs.

2003. 4. 17. : Preliminary version 0.2. 
               Adjust system clock speed to 102.6MHz for the sake of stability.
               
2003. 4. 20. : Release version 1.0 completed.
               UART polling routines are attached.

2003. 4. 21. : Release version 1.1 completed.
               IRQ_Handler is revised in order to prevent interrupt nesting while
               processing context switching in the IRQ Handler.

2003. 4. 24. : Release version 1.2 completed.
               Path of some files in "includes.h" are revised.
               Comments of misc.c is changed from 112.5M to 102.6M.

2003. 4. 27. : Release version 2.0 completed.
               uC/OS-II ver 2.51 is ported.
               Path name is changed to \UCOS251_S3C2400\
               TimerClock value in timer.c and timer.h is changed to 15951.5 for 
               the sake of accuracy.
               OS_TICKS_PER_SEC value in OS_CFG.H is set to 200 

2003. 4. 30. : Release version 2.1 for high speed test completed.
               PLL is set as FCLK = 150MHz, HCLK = 75MHz, PCLK = 75MHz
               (cf : 150MHz is the maximum value described in the specification 
               of S3C2400)

2003. 5. 13. : In ucos_ii.h, following lines are added.
               #include <string.h>
               #include <stdio.h>
               #include "\UCOS251_S3C2400\os_cpu.h"
               #include "\UCOS251_S3C2400\os_cfg.h"

2003. 11. 16. : Port is revised for ARM Developer Suite v1.2
                  [1] In the function "OSIntCtxSw" of Os_cpu_a.s,
                      "ADD   sp,sp,#4" is changed to "ADD   sp,sp,#8"
                  [2] ucos_ii.h is changed as follows.
                      #include <string.h>
                      #include <stdio.h>
                      #include "..\os_cpu.h"
                      #include "..\os_cfg.h"
                  [3] In UCOS-II.C, <> is changed to "" as follows.

                   #define  OS_GLOBALS             /* Declare GLOBAL variables                              */
                   #include "ucos_ii.h"


                   #define  OS_MASTER_FILE         /* Prevent the following files from including includes.h */
                   #include "os_core.c"
                   #include "os_flag.c"
                   #include "os_mbox.c"
                   #include "os_mem.c"
                   #include "os_mutex.c"
                   #include "os_q.c"
                   #include "os_sem.c"
                   #include "os_task.c"
                   #include "os_time.c"

                   [4] In Os_cpu_a.s, MMU setting lines are changed.
                   
                   [5] Task numbers are changed from 2 to 3.