uclinux_bfin_release_notes_2005r3.html

ADI 公司blackfin系列的用户使用文挡。

	</tr>
	<tr>
		<td>860</td><td>dpmc test can&rsquo;t change voltage and do deepsleep test</td>
	</tr>
	<tr>
		<td>877</td><td>Kernel panic - not syncing: No CPLB Address Match</td>
	</tr>
	<tr>
		<td>883</td><td>Lumpy UDP packet transmission</td>
	</tr>
	<tr>
		<td>891</td><td>tcp stress testing echo service</td>
	</tr>
	<tr>
		<td>895</td><td>top and vmstat reports error user/sys/idle cpu load percentage</td>
	</tr>
	<tr>
		<td>908</td><td>LTP auto test hang randomly on bf537 if enable data cache</td>
	</tr>
</table>
<br />

<p>
There are also some issues in the LTP test cases. They are recorded as bug 264, 532, 561, 562, 563, 567, 732, 733, 734, 735, 736, 737, 742, 743, 744, 745, 890 and 893.
</p>

</div>
<!-- SECTION [6567-7741] -->
<h1><a name="build_procedure" id="build_procedure">Build Procedure</a></h1>
<div class="level1">

<p>
1. Install Toolchain Release 2005R3
</p>

<p>
Go to <a href="http://blackfin.uclinux.org/frs/?group_id=18" class="urlextern" title="http://blackfin.uclinux.org/frs/?group_id=18"  rel="nofollow">http://blackfin.uclinux.org/frs/?group_id=18</a> for more information
</p>

<p>
2. Download the source code of project uClinux for Blackfin release 2005R3
</p>

<p>
Go to <a href="http://blackfin.uclinux.org/frs/?group_id=17" class="urlextern" title="http://blackfin.uclinux.org/frs/?group_id=17"  rel="nofollow">http://blackfin.uclinux.org/frs/?group_id=17</a>
</p>

<p>
3. Uncompress uclinux-dist.tar.bz to working directory 
</p>
<pre class="code">cp uClinux-dist_2005R3.tar.bz /(WORK_DIR)
cd /(WORK_DIR)
bunzip2 uClinux-dist_2005R3.tar.bz
tar -xvf uClinux-dist_2005R3.tar</pre>

<p>
 4. Compile the source using following commands   
</p>
<pre class="code">cd uClinux-dist
make clean 
make menuconfig (save and exit without making any changes)
make </pre>

<p>
  5. Find the compiled blackfin executable linux in the following location  
</p>
<pre class="code">$(WORK_DIR)/uClinux-dist/images </pre>

<p>
 6. Above file shall be used to download to the target board.   
</p>

</div>
<!-- SECTION [7742-8629] -->
<h1><a name="load_kernel_to_target_board" id="load_kernel_to_target_board">Load Kernel to Target Board</a></h1>
<div class="level1">

<p>
 1. Use below serial cables to connect board to host computer.  
</p>
<pre class="code">Male-Female 1-1 serial cable</pre>

<p>
 2. Use minicom or some other serial communications utility to configure the serial port with the following parameters. If run minicom for the first time, run &ldquo;minicom -s&rdquo; to setup the port. 
</p>
<pre class="code">Serial Device = /dev/ttyS0
Baud Rate = Baud that have been selected in kernel menuconfig (Default value is 57600)
Number of bits = 8
Parity = None
Stop bits = 1</pre>

<p>
 3. Make sure the BMODE pins on the target board are set to 00. If u-boot loads automatically on reset, the pins are already set correctly. 
</p>

<p>
4. Make sure tftp server is installed in the host machine. Copy <em>linux </em>from uClinux-dist/images/ that is built in above steps to the /tftpboot of the host PC. 
</p>

<p>
5. Load the linux file with the following bootloader commands. Make sure the ipaddr (target board IP) and serverip (host IP) are correct. 
</p>
<pre class="code">STAMP&gt; setenv ipaddr x.y.z.n
STAMP&gt; setenv serverip x.y.z.m 
STAMP&gt; saveenv
STAMP&gt; tftp 0x1000000 linux
STAMP&gt; bootelf 0x1000000</pre>

<p>
 Where x.y.z.m is the ip address of the host machine, and x.y.z.n is the ip address of the target board. 
</p>

<p>
6. The kernel should then boot
</p>

</div>
<!-- SECTION [8630-9853] -->
<h1><a name="adding_upgrading_kernel_in_flash" id="adding_upgrading_kernel_in_flash">Adding / upgrading kernel in flash</a></h1>
<div class="level1">

</div>
<!-- SECTION [9854-9903] -->
<h2><a name="building_linux_image_compressed_and_uncompressed" id="building_linux_image_compressed_and_uncompressed">Building Linux image (compressed and uncompressed)</a></h2>
<div class="level2">

<p>
(This Image Will be Used in bootm command)   Linux ELF image has to be changed as per u-boot standards to load Linux using <em>bootm</em> command. Following subsections explain how to build compressed and uncompressed Linux images. 
</p>

</div>
<!-- SECTION [9904-10196] -->
<h2><a name="building_compressed_linux_image" id="building_compressed_linux_image">Building Compressed Linux Image</a></h2>
<div class="level2">

<p>
 1. Generate the binary file from the ELF file, using following command 
</p>
<pre class="code">$ bfin-uclinux-objcopy -O binary linux linux.bin </pre>

<p>
 2. Compress the binary file obtained above, using following command  
</p>
<pre class="code">$ gzip -9 linux.bin  </pre>

<p>
 3. Build the final linux image, using following command 
</p>
<pre class="code">(WORK_DIR)/u-boot_1.1.3/tools/mkimage -A blackfin -O linux -T kernel -C gzip -a 0x1000 -e 0x1000 -n &quot;Bfin uClinux Kernel&quot; -d linux.bin.gz uImage</pre>

<p>
 <em><strong>Note:</strong></em> Use the utility mkimage present in the u-boot_1.1.3/tools directory to merge the header information like Image Name, Image Type, Data Size, Load Address, Entry Point into the linux.bin.gz. 
</p>

</div>
<!-- SECTION [10197-10870] -->
<h2><a name="building_uncompressed_linux_image" id="building_uncompressed_linux_image">Building uncompressed Linux image</a></h2>
<div class="level2">

<p>
 Use following commands to build uncompressed Linux image 
</p>
<pre class="code">(WORK_DIR)/u-boot_1.1.3tools/mkimage -A blackfin -O linux -T kernel -C none -a 0x1000 -e 0x1000 -n &quot;Bfin uClinux kernel&quot; -d linux.bin uImage</pre>

<p>
 <em><strong>Note:</strong></em> 0&times;1000 is used because we have compiled the kernel with that location as the entry point. If anyone wants to chose a different address for entry point (for eg, 0&times;20000), then please give that address instead of 0&times;1000. Ensure to change the entry point of the kernel.   
</p>

</div>
<!-- SECTION [10871-11403] -->
<h2><a name="programming_flash" id="programming_flash">Programming Flash</a></h2>
<div class="level2">
<pre class="code">STAMP&gt; tftp 0x1000000 uImage
STAMP&gt; protect off all 
STAMP&gt; erase 0x20100000 0x203FFFFF
STAMP&gt; cp.b 0x1000000 0x20100000 $(filesize) 
STAMP&gt; setenv bootcmd bootm 0x20100000 
STAMP&gt; save
STAMP&gt; reset</pre>

</div>
<!-- SECTION [11404-11646] -->
<h1><a name="build_customized_uclinux" id="build_customized_uclinux">Build Customized uClinux</a></h1>
<div class="level1">

</div>
<!-- SECTION [11647-11684] -->
<h2><a name="customize_kernel" id="customize_kernel">Customize Kernel</a></h2>
<div class="level2">

<p>
1. make menuconfig in uClinux for Blackfin project
</p>

<p>
2. select option &ldquo;Kernel/Library/Defaults Selection&rdquo; &rarr; &ldquo;Customize Kernel Settings&rdquo; and exit
</p>

<p>
3. In kernel configuration, processor and board specific options can be changed in &ldquo;Processor type and features&rdquo;, such as cache status, CPU, DMA, etc.
</p>

<p>
4. Driver specific options are in respective menus. Such as Ethernet driver in &ldquo;Networking supporting&rdquo;, sound card driver in &ldquo;Sound&rdquo;, video driver in &ldquo;Graphic Support&rdquo;, etc.
</p>

<p>
5. Save and exit. Then make the image again as mentioned before. The changes of the kernel take effects after you load and run the new image.
</p>

</div>
<!-- SECTION [11685-12327] -->
<h2><a name="customize_application_and_lib" id="customize_application_and_lib">Customize Application and Lib</a></h2>
<div class="level2">

<p>
1. make menuconfig in uClinux for Blackfin project
</p>

<p>
2. select option &ldquo;Kernel/Library/Defaults Selection&rdquo; &rarr; &ldquo;Customize Vender/User Settings&rdquo; and exit
</p>

<p>
3. In user configuration, applications can be selected to build and debugging information can be enabled.
</p>

<p>
4. In order to configure busybox 1.00, you should go into the folder &ldquo;user/busybox-1.00-rc3/&rdquo; and do menuconfig.
</p>

<p>
5. In order to configure uClibc, you should go into the folder &ldquo;uClibc&rdquo; and do menuconfig.
</p>

<p>
6. After the menuconfig is done, make the image again as mentioned before. The new selected application can be found in the romfs after you load and run the new image.
</p>

</div>
<!-- SECTION [12328-13000] -->
<h2><a name="customize_for_debugging" id="customize_for_debugging">Customize for debugging</a></h2>
<div class="level2">

<p>
1. To debug an application, please refer to the document &ldquo;gdb_guide_bfin.txt&rdquo; in subfolder kgdb_patch.
</p>

<p>
2. To do source level kernel debugging by kgdb, please refer to the README file in subfolder kgdb_patch. After apply the kgdb patch file to the kernel, a simple guide &ldquo;kgdb_bfin.txt&rdquo; can be found in subfolder &ldquo;linux-2.6.x/Documentation/blackfin/&rdquo;
</p>

</div>
<!-- SECTION [13001-13386] -->
<h1><a name="reporting_bugs" id="reporting_bugs">Reporting Bugs</a></h1>
<div class="level1">

<p>
  1. Go to the following blackfin uclinux bug tracker page, 
</p>

<p>
<a href="http://blackfin.uclinux.org/tracker/?atid=141&amp;group_id=17&amp;func=browse" class="urlextern" title="http://blackfin.uclinux.org/tracker/?atid=141&amp;group_id=17&amp;func=browse"  rel="nofollow">http://blackfin.uclinux.org/tracker/?atid=141&amp;group_id=17&amp;func=browse</a> 
</p>

<p>
2. If the bug is not already reported click on &ldquo;Submit New&rdquo; button to report new bug. 
</p>

</div>
<!-- SECTION [13387-] --></body>
</html>