uclinux_bfin_release_notes_2006r1.html

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

		<td>1137</td><td> ./linux-2.6.x/System.map does not match target /proc/kallsyms </td>
	</tr>
	<tr>
		<td>1146</td><td> a couple of the libraries don&rsquo;t compile. </td>
	</tr>
	<tr>
		<td>1165</td><td> <acronym title="Concurrent Versions System">CVS</acronym> 2.6.16 kernel networking fails after 2 hours of downloading on 533 </td>
	</tr>
	<tr>
		<td>1186</td><td> Sometimes CTRL+C kills shell </td>
	</tr>
	<tr>
		<td>1188</td><td> CONFIG_PACKET_MMAP failed to build </td>
	</tr>
</table>
<br />

<p>
 There are also some issues in the LTP test cases. They are recorded as bug 352, 744, 745, 1010, 1050, 1096, 1211, 1212, 1218, 1219 and 1263.
</p>

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

<p>
1. Install Toolchain Release 2006R1
</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 2006R1
</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_2006R1.tar.bz /(WORK_DIR)
cd /(WORK_DIR)
bunzip2 uClinux-dist_2006R1.tar.bz
tar -xvf uClinux-dist_2006R1.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 [5311-6199] -->
<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 boot loader 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>
   
</p>

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

</div>
<!-- SECTION [6200-7443] -->
<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 [7444-7493] -->
<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 [7494-7787] -->
<h2><a name="building_compressed_linux_image" id="building_compressed_linux_image">Building Compressed Linux Image</a></h2>
<div class="level2">

<p>
Compressed Linux images can be found under folder &ldquo;uClinux-dist/image&rdquo;. But, you can also generate by yourself as follows.
</p>

<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>
   
</p>

</div>
<!-- SECTION [7788-8593] -->
<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>
  0&times;10000&times;200000&times;1000 
</p>

</div>
<!-- SECTION [8594-9134] -->
<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 0x20040000 0x203EFFFF
STAMP&gt; cp.b 0x1000000 0x20040000 $(filesize) 
STAMP&gt; setenv bootcmd bootm 0x20040000 
STAMP&gt; save
STAMP&gt; reset</pre>

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

</div>
<!-- SECTION [9377-9414] -->
<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 [9415-10058] -->
<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 Blackfin architecture in menu &ldquo;Vendor/Product Selection&rdquo;&rarr;&ldquo;AnalogDevices Product&rdquo;
</p>

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

<p>
4. In user configuration, applications can be selected to build and debugging information can be enabled.
</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 [10059-10711] -->
<h2><a name="customize_flat_elf_binary_format" id="customize_flat_elf_binary_format">Customize FLAT/ELF Binary Format</a></h2>
<div class="level2">

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

<p>
2. select Blackfin architecture in menu &ldquo;Vendor/Product Selection&rdquo;&rarr;&ldquo;AnalogDevices Product&rdquo;
</p>

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

<p>
4. select &ldquo;Blackfin Build Options&rdquo; &rarr; &ldquo;Build FD-PIC ELF binaries&rdquo; to build application into ELF binary. Unselect to build FLAT binary.
</p>

<p>
5. Change into folder uClibc and do menuconfig.
</p>

<p>
6. select &ldquo;Target Architecture&rdquo; &rarr; &ldquo;bfin&rdquo; to build uClibc into ELF binary. Select &ldquo;Target Architecture&rdquo; &rarr; &ldquo;bfinfdpic&rdquo; to build FLAT binary.
</p>

<p>
7. Change into folder uClinux-dist and make the image.
</p>

</div>
<!-- SECTION [10712-11374] -->
<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 patch folder bfin_patch/kgdb_patch.
</p>

<p>
2. To do source level kernel debugging by kgdb, please refer to the README file in patch folder bfin_patch/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 [11375-11788] -->
<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 [11789-] --></body>
</html>