Platform Builder debugs images only of the type nk.bin, therefore you must first rename all eboot.* filenames to nk.* before attempting to debug eboot. To do this:
1- Create a folder, for example eboot, under the directory C:\WINCE600\OSDesigns\<current solution>\RelDir
2- Open the Solution in Visual Studio, then select View → Solution Explorer.
3- In the Solution Explorer window, drop the tree to view the EBOOT node of the current target board. For example C:\WINCE600\PLATFORM\<BoardBSP_node>\SRC\BOOTLOADER\EBOOT
4- Right-click on the EBOOT node and select Properties from the context menu to display the window Editing C:\WINCE600\PLATFORM\<BoardBSP>\SRC\BOOTLOADER\EBOOT\sources
5- Access the General tab, change Target .pdb Name and Target Name to eboot, then click OK.
6- In the Solution Explorer window, right-click on the node C:\WINCE600\PLATFORM\<BoardBSP_node>\SRC\BOOTLOADER\EBOOT and select Build from the context menu.
7- Ensure that the project is built without any errors. If this is not the case, rebuild the project.
8- From the directory C:\WINCE600\OSDesigns\<current solution>\RelDir\<current solution>_Debug, copy eboot.* to the eboot directory created in Step 1. Then copy the eboot.pdb file from C:\WINCE600\PLATFORM\<BoardBSP_node>\SRC\BOOTLOADER\EBOOT to the eboot directory created in Step 1.
9- In the directory created in Step 1, rename all eboot.* file names to nk.* (for example, rename eboot.bin to nk.bin and eboot.nb0 to nk.nb0).
10- Open Visual Studio, then select File → Open → Project/Solution...
11- Locate and select nk.bin, for example in C:\WINCE600\OSDesigns\OSDesign9\OSDesign9\RelDir\eboot, as the Project.
12- Select Target → Connectivity Options to open the Target Device Connectivity Options dialog box.
13- Ensure that the Download and Transport options are set as None, and that the Debugger option is set to eXDI2RVI.
14- Select Target → Attach Device to connect to the target and open the eXDI Console dialog box.
15- In the eXDI Console dialog box, select the Download checkbox.
16- Select the required core, for example ARM926EJ-S.
17- Enter the appropriate Load Address where you want to download nk.nb0. For more details on the Load Address field, see the Image panel information in Accessing the eXDI console.
18- Select the Stop radio button from the D/L and panel.
19- Click the Connect button to connect to the target and to start the image download process.
20- Select File → Open, and then browse to the appropriate eboot directory. For example, C:\WINCE600\PLATFORM\<BoardBSP_directory>\eboot.
21- Open the source files to view and add breakpoints in them.
Updating the EBOOT is dangerous. If the updated process does not finish successful, the
EBOOT will not start anymore, and you will have to reprogram it again via JTAG debugger.
1. Use the File menu of Visual Studio and choose Open Workspace.
2. Select the appropriate EBOOT.NB0 file. (see folder \EBOOT)
3. Follow the steps in Configuring Ethernet Connection for Downloading and Debugging to
establish an Ethernet connection between the target and Visual Studio.
4. From the Target menu, select Attach Device.
5. Select Download on the terminal, and confirm the destination as 1
6. The eBoot should be loaded into the RAM, confirm to write into the Flash-Memory with “Y”
7. After the download is complete, from the Target menu, select Detach Device.
8. Switch over your terminal emulation application. At this point, EBOOT has downloaded the
image temporarily into SDRAM and is ready to begin the flash programming procedure.
9. In the terminal emulation application, hit the ‘y’ key to begin programming the flash.
10. EBOOT will program the image into flash and provide status using serial debug messages.
Once the programming is complete.
11. Close the Visual Studio workspace for EBOOT.nb0. It is not necessary to save any workspace changes.
12. Reset the target hardware. If you see new EBOOT messages appear on the terminal, EBOOT has been properly programmed into NOR flash.
eboot.c:
C:\WINCE600\PLATFORM\???\Src\BOOTLOADER\EBOOT
EBOOT.bin:
C:\WINCE600\OSDesigns\???\???\RelDir\???_Release
EBOOT.nb0:
C:\WINCE600\OSDesigns\???\???\RelDir\???_Release
boot.bib:
C:\WINCE600\PLATFORM\???\Src\BOOTLOADER\EBOOT
Eboot library (dhcp.c/h, udp.c/h, tftp.c/h, …):
C:\WINCE600\PUBLIC\COMMON\OAK\DRIVERS\ETHDBG\EBOOT
menu.h:
C:\WINCE600\PLATFORM\???\Src\BOOTLOADER\COMMON
*.h
C:\WINCE600\PLATFORM\???\Src\Inc
Source paths:
C:\WINCE600\PLATFORM\???\SRC\BOOTLOADER\XLDR\
C:\WINCE600\PLATFORM\???\SRC\BOOTLOADER\COMMON\
C:\WINCE600\PLATFORM\???\SRC\BOOTLOADER\EBOOT\
C:\WINCE600\PLATFORM\???\SRC\BOOTLOADER\BOOTSHELL\
C:\WINCE600\PLATFORM\???\SRC\BOOTLOADER\HWLIB\CSPDDK\DDK_APBHDMA\
C:\WINCE600\PLATFORM\???\SRC\BOOTLOADER\HWLIB\CSPDDK\DDK_IOMUX_GPIO\
C:\WINCE600\PLATFORM\???\SRC\BOOTLOADER\HWLIB\CSPDDK\DDK_CLK\
C:\WINCE600\PLATFORM\???\SRC\BOOTLOADER\HWLIB\LCDIF\
