2410 CE Dot NET 4.1 BSP Porting Guide

 

This documentation can be changed without notice.

You can download newest version of this documentation on our website.

Sorry about my English. May be there is so many errata and heedless of grammar.

 

If you have any question or find errata, please send me the mail(mailto:jaeyong2.lee@samsung.com).

 

index

1.     Copying the BSP

2.     Catalog Installation

3.     Make new platform

4.     Modifying the features

5.     How to running the image

1.    Ethernet Download

2.    USB Download

6.     Device Drivers

1.    CS8900

2.    Serial

3.    IrDA

4.    USB

5.    NAND

6.    SD

7.    Power Management

8.    Eboot loader

9.    PCMCIA

10.    Keyboard

11.    Button

12.    Touch

13.    Display

7.     Known Problems

8.     Changes

 

Copying the BSP.

Please copy the S3C2410 directory to WINCE410\PLATFORM.

The S3C2410.cec file was located in S3C2410 directory.

If you have the BSP with same name, then you must back up the old bsp.

You must copy the “CS8900R” directory in “S3C2410\__for_Public” folder to “WINCE410\PUBLIC\COMMON\OAK\DRIVERS\NETCARD”.

 

Catalog Installation

Choose the “Manage Catalog Features…” on “File” Menu

Choose the “Import…” menu on “Manage Catalog Features” dialog box.

Choose the “S3C2410.CEC” file in the “S3C2410” BSP directory.

You can see the “SAMSUNG: S3C2410” field on catalog viewer.

Make new platform.

Choose the “New Platform” on “File” menu.

Then you can see “New Platform Wizard – Step 1”. Press “Next” button.

You can also find “SAMSUNG: S3C2410” BSP on “New Platform Wizard – Step 2”.

Choose the “SAMSUNG: S3C2410” and press “Next” button.

Please choose configuration what you want in the “Available configurations” list.

And type the platform name in “Platform name:” text box. And press “Next” button.

Please choose the other configuration on “New Platform Wizard – Step 4”. And press “Next” button.

Select the “Application & Media” what you want, on “New Platform Wizard – Step 5”.

Modify the “Available features:” on “New Platform Wizard – Step 4” if you want. And press “Next” button.

Press “Next” button.

You can see the “Congratulations!” dialog box.

All of the sequence to create new platform is done.

Press the “Done” button.

 

Modifying the features

Delete some features what the features does not included in your boards. (PCI)

Compile the platform.

 

How to running the image

Ethernet Download.

Before you download the wince image through Ethernet, you must have to have eboot image on your AMD flash memory.

Please select the “Configure Remote Connection…” on “Target” menu.

Select the “Ethernet – Download” in “Download:” selection combo box.

Select the “Ethernet – KITL Transport” in “Kernel” selection combo box.

And press the “Configure…” box.

Then you can see the “Configure Ethernet Download Service” dialog box.

If you turning on the SMDK2410X board with press the EINT0 button(If you want to see details press here).

There comes up the “S3C2410?????” on the list.

Select the “S3C2410?????” on the “Available Devices:” list. And press the “OK” button.

Select the “Download / Initialize” on the “Target” menu and turning on the board, you can download the “nk.bin” image to the target board through Ethernet.

Then you can see below message on the “hyper terminal” through UART1 on the target board.

After download completed, the Ethernet downloader writes the image to the NAND.

After that the Windows CE 4.1 is booted up on target board.

USB Download

You must install the USB driver and dnw program on your host PC. You can download from hear.

Run dnw.exe and select configuration/option menu and set UART/USB Options

You must set the “Download Address” to “0x30040000”.

You must confirm the menu bar, [COM1, 115200bps][USB:OK]

Please select the “Transmit” on “USB port” menu.

And choose the “nk.nb0” file in “WINCE410\PUBLIC\[Platform Name]\RelDir\SAMSUNG_S3C2410Release” directory.

You can see the progress bar.

After download completed, the WindowsCE 4.1 is booted up on target board.

 

 

Make the Ethernet downloader on AMD Flash ROM

Download the S3C2410 Reference board test program.

Run dnw.exe and set the configuration.

Select Serial Port/Transmit menu. And choose the “2410test.bin” file.

Select “87:NOR Flash Program”.

Change a flash ROM which you want to make Ethernet downloader on power-on state.

Select “a: AM29LV800BB x1”. Type “Y”.

And select “Transmit” on “Serial Port” menu.

And choose the “eboot.nb0” file in “WINCE410\PUBLIC\[Platform Name]\RelDir\SAMSUNG_S3C2410Release” directory.

Then you can see the progress bar.

Now downloading the “eboot.nb0” image to SDRAM address “0x31000000” through UART0.

If you press Enter key, default value is input.

You continue to download the file until address 0x40000 because the size of the “eboot.nb0” file is less than 0x40000.

Type “N” and stop a download. And reboot your target board.

 

Device Drivers

CS8900

About CS8900 network device driver source, it is placed at __for_Public\Network_driver.

As you know, these source codes have to be placed in public folder.

WINCE410\PUBLIC\COMMON\OAK\DRIVERS\NETCARD\CS8900R.

Also, you have to modify public\COMMON\cesysgen\makefile to make cs8900 miniport driver.

First, find 'ne2000' in this makefile. You can find it at 4 place.

Just add 'cs8900' after 'ne2000'.Then, build it.

At first type the "build" command at "<root>\public\common\oak\drivers\netcard\cs8900".

After that type the "nmake cs8900" commnad in "public\COMMON\cesysgen"

Now, you can get your new cs8900 device driver.

 

Serial

There is not implemented auto detect yet.

So you must change the “pc connection” on “control panel” to “`115200 @ Serial”.

And you must execute “windows\repllog.exe”.

 

IrDA

The IrDA source code is same with Serial device driver.

If you decide to use IrDA port for Active Sync, you cannot use serial port.

Because TXD2 and RXD2 register is shared by IrDA and serial on 2410 evaluation board.

You can find that the jumper J18, J19 are used to select one of them.

 

USB

USB Host :

The USB mouse and keyboard works fine. But there is some problem in power management. If the system is waked up from suspend mode, the usb keyboard is not working correctly, but if you reconnect the usb keyboard, it works fine. We are going to solve this problem.

USB Device :

You must install the usb device driver(WINCE410\PLATFORM\S3C2410\DRIVERS\usb\function\wceusbsh.*) in host PC for USB Activesync.

 

NAND

The pocketstore version 0.21.

 

SD

Working good.

 

Power Management

Working good.

 

Eboot loader

1. How to write EBOOT to AMD ROM

a. Connect serial cable to S3C2410 Board's COM1 Port and Host PC.

b. Run USB Downloader which is provided in this package or Any other downloader.

c. Set the 0x30000000 as target address to download ROM Writer program(2410test.bin).

d. Download "2410test.bin" file to SDRAM memory on S3C2410 Board.

e. Select the function "ROM Prog Flash".

f. Select the type of a flash memory to "a"(AM29LV800BB x1).

g. Type to "y" about below question.

             Do you want to download through UART0 from 0xd000000? [y/n]:

h. You can see the "STATUS:" message, while downloading the your eboot.nb0 file.

i. The size is lower than 256k(0~40000h). You have to write it to AMD flash ROM following up the sequence.

j. After all writing processes, connect serial cable to COM2 Port and reset the board.

  

2. About Eboot.

There is three ways to running the WinCE.

 

Case 1) When you press only the "EINT0" Button while Power ON.

a. Run the "eshell" program.

b. You can see the "Select Device" Dialog box.

c. You can find new Device Name on the "Select Device" Dialog box's list on Host PC. And choose it.

d. Then the "Microsoft Windows CE Debug Shell" is running now.

e. Choose the download image on "File->Select Image" Menu(or Press Ctrl+i).

f. After downloading it, the S3C2410 Boards will be writing the nk.bin image to NAND flash.

   If you compile the OS with multiple XIP you must choose "chain.lst" file.

g. After writing kernel image to NAND flash, the board is going to Ethernet debugging mode.

 

Case 2) When you press the "EINT0" and the "EINT2" Button while Power ON.

a. The process of running the "Microsoft Windows CE Debug Shell" program is same with case 1 (a-e).

b. You can see the below question, enter the S3C2410 boards IP Address and Netmask Address to downloading the nk.bin image or list of bin files in "chain.lst" file or various bin file.

   If you type the Enter Key, you can use default address.

             Enter       IP Address ( 12.25.134.15 ) :

             Enter Netmask Address ( 255.255.254.0 ) :

c. Please enter the IP Address and Netmask Address, you can see the downloading status in "Microsoft Windows CE Debug Shell" program.

d. After downloading it, the S3C2410 Boards will be writing the nk.bin image to NAND flash. You can see the status through UART.

e. After writing kernel image to NAND flash, the board is going to Ethernet debugging mode.

 

Case 3) If you Power ON without pressing any button.

a. If the NAND flash has right image, then the board is booted up.

b. If the NAND flash has wrong image, then see Case 1 sequence.

 

Notes, If the compiled nk.bin image contains "CS8900" device driver, the Ethernet debugging do not work correctly.

       But If you press the reset button or turn on the power, the Booting has no problem. Only ethernet debugging has problem.

       If you want to debugging through Ethernet, please exclude the CS8900.dll in platform.bib file and platform.reg file.

  

3. About bin2header.exe

This file makes nandimg.h file from 2410loader.bin file.

When EBOOT writes WinCE image to NAND Flash ROM, it also writes "nand boot loader" and some information of WinCE Image to first block of NAND Flash ROM.

 

PCMCIA

Working good.

 

KeyBoard

There is no problem.

 

Button

Working good.

EINT0 button : suspend/wakeup function.

EINT2 button : software reset.

 

Touch

Working good.

 

Audio

Play/Record function is Working good.

 

Display

There is no problem.

 

 

 

Known Problems

- None 

 

Changes

2002.10.05          - Base porting and add some device drivers.

2002.12.04          - Add NAND Filesytem device driver

                           - Change the start address to 0x30040000

2002.12.04           - Modify the RTC function. (OEMSetRealTime, OEMGetRealTime)

2002.12.05           - Modify the serial/IrDA device driver to use common mdd.

2002.12.14           - Add PCMCIA device driver routine. Power Management block is not written yet.

2002.12.27           - Add cs8900 ethernet device driver.

2002.12.28           - LCD rotation routine is added.

2002.12.28           - Add Hardware volume control function.

2003.03.10           - touch, serial device drivers are updated.

2003.03.18           - PCMCIA,SD device drivers are updated

2003.03.27           - USB device driver is updated.

2003.04.09           - Add Audio Record function.

 

 

BSP Release Version - V1.01

 

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

The feedback that I receive from you is vital for me to bring you better solutions.

If you have any suggestions please feel free e-mail me with you comments.

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