Difference between revisions of "IoTGateway/BSP/Linux/AM335x/AM335x LBV2 User Guide"

From ESS-WIKI
Jump to: navigation, search
 
(16 intermediate revisions by one other user not shown)
Line 1: Line 1:
 +
{{DISPLAYTITLE:Linux BSP User Guide for AM335x series}} __TOC__
 +
 
= Start Guide =
 
= Start Guide =
  
Line 5: Line 7:
 
== <span style="color:#0070c0">Configure your Linux Host</span> ==
 
== <span style="color:#0070c0">Configure your Linux Host</span> ==
  
Please refer to [[IoTGateway/BSP/Linux/AM335x/AM335x_LBV6_User_Guide#Configure_your_Linux_Host|<span class="mw-headline" id="Configure_your_Linux_Host"><span style="color:#0070c0">Configure your Linux Host</span></span>]] to configure your Linux Host.
+
Please refer to [[IoTGateway/BSP/Linux/AM335x/AM335x_LBV6_User_Guide#Configure_your_Linux_Host|<span class="mw-headline" id="Configure_your_Linux_Host"><span style="color:#0070c0">Configure your Linux Host</span></span>]] to configure&nbsp; your linux host.
  
 
== <span style="color:#0070c0">Install Advantech SDK</span> ==
 
== <span style="color:#0070c0">Install Advantech SDK</span> ==
  
Please refer to [[IoTGateway/BSP/Linux/AM335x/AM335x_LBV6_User_Guide#Install_Advantech_SDK|<span class="mw-headline" id="Configure_your_Linux_Host"><span style="color:#0070c0">Install Advantech SDK</span></span>]] to install Advantech SDK.
+
Please refer to [[IoTGateway/BSP/Linux/AM335x/AM335x_LBV6_User_Guide#Install_Advantech_SDK|<span class="mw-headline" id="Configure_your_Linux_Host"><span style="color:#0070c0">Install Advantech SDK</span></span>]] to install&nbsp; advantech sdk.
  
 
== <span style="color:#0070c0">BSP Building Guide</span> ==
 
== <span style="color:#0070c0">BSP Building Guide</span> ==
  
Please refer to [[IoTGateway/BSP/Linux/AM335x/AM335x_LBV6_User_Guide#Install_Advantech_SDK|<span class="mw-headline" id="Configure_your_Linux_Host"><span style="color:#0070c0">BSP Building Guide</span></span>]] to build advantech BSP.
+
In the following building demo, we always assume building is for RSB4220 platform. others(such as ROM3310,RSB4221) are same。 $(BSP) is your BSP root directory. In order to simplify the description, we use "$(BSP)" to represent actual BSP root path. you need to replace the string to actual path。
  
== <span style="color:#0070c0">Update Linux OS</span> ==
+
'''1. Setup uboot and kernel build environment'''
  
All advantech products based on AM335x platform support '''boot from SD card''' or '''onboard flash'''. This section will guide you how to build an image for Linux system boot media.
+
*$ sudo su (Change to “root” authority)
 +
*Input user password
 +
*#cd $(BSP)/scripts/
 +
*#source setenv.sh (To configure the developing environment automatically)
  
=== Debug Message ===
+
Then you can start to code the source code, build uboot and kernel images.
  
All advantech risc products can connect to a host PC (Linux or Windows) by using console cable and debug port adapter. In order to communicate with host PC, serial communication program such as HyperTerminal, Tera Term or PuTTY is must required. Suggest use PuTTY on your host PC. Below is the detail instruction of how to setup PuTTY on ubuntu 14.04 hosts:<br/>Install putty as below<br/>[[File:Putty1.png|RTENOTITLE]]
+
The '''setenv.sh''' script is used to configure the developing environment quickly. It will configure the folder paths for system.
  
*Connect target board to your ubuntu PC by using console cable.
+
<font color="#FF0000">Note! You have to run “#source setenv.sh” every time once you open a new "Terminal" utility. It is suggested to change to “root” authority to use the source code. And the “$(BSP)” is the root directory of BSP source code. </font><br/>'''2. Build u-boot Image'''<br/>Advantech has a script to build the u-boot quickly. You can build u-boot image by follow below steps:
*Open putty on your ubuntu PC.
 
*power up the target board.
 
*Setting putty as follows.
 
  
[[File:Putty5.png|RTENOTITLE]]<br/>Select correct serial line, then click open. Then you will see the console information: [[File:Putty7.png|RTENOTITLE]]<br/>Type root to login in system.
+
*Open "Terminal" on Ubuntu host PC.
 +
*$sudo su (Change to “root” authority)
 +
*Input user password.
 +
*#cd $(BSP)/scripts/
 +
*#source setenv.sh (To configure the developing environment automatically)
 +
*#./cfg_uboot.sh am335x_rsb4220_defconfig (To set the u-boot configuration automatically)
 +
*#./mk_uboot.sh (Start to build the u-boot)
  
=== Storage Information (eMMC/SD card) ===
+
'''Then you can see u-boot.img is being built and located in ../image. '''<br/><br/>'''3. Build Linux Kernel Image'''<br/>Advantech offer you a script to build the “uImage” quickly. You can build uImage by follow below steps:
  
The storages devices name as following:
+
*Open "Terminal" on Ubuntu host PC.
 +
*$sudo su (Change to “root” authority)
 +
*Input user password.
 +
*#cd $(BSP)/scripts/
 +
*#source setenv.sh (To configure the developing environment automatically)
 +
*#./cfg_kernel.sh tisdk_am335x-rsb4220_defconfig (To set the uImage configuration automatically)
 +
*#./mk_kernel.sh (Start to build the uImage)
  
{| class="wikitable"
+
'''Then you can see uImage is being built and located in ../image.'''
|-
 
! Device
 
! Node Name
 
|-
 
| SD caed
 
| /dev/mmcblk0
 
|-
 
| eMMC
 
| /dev/mmcblk1
 
|}
 
  
If Linux os exists in both SD card and eMMC flash, the linux in SD is default boot option. If no SD card inserted, the eMMC node is "/dev/mmcblk0".
+
== <span style="color:#0070c0">Update Linux OS</span> ==
 
 
=== Create a Linux SD Card System ===
 
 
 
'''1. Create system from Pre-built System Image'''<br/>You are able to find the pre-built image from Advantech website. Please follow below steps to create a SD card for boot up. we still use the RSB-4220 as demo:
 
  
*Copy “4420LIVxxxx_yyyy-mm-dd.tar.gz” package to your /root/.
+
Please refer to [[IoTGateway/BSP/Linux/AM335x/AM335x_LBV6_User_Guide#Update_Linux_OS|<span class="mw-headline" id="Configure_your_Linux_Host"><span style="color:#0070c0">Update Linux OS</span></span>]] to update your linux os.
*Open "Terminal" on Ubuntu host PC.
 
*$sudo su (Change to “root” authority)
 
*Input your password.
 
*#cd /root/
 
*#tar xzvf 4220LIVxxxx_yyyy-mm-dd.tar.gz (Unzip files)
 
*Insert one SD card to your developing computer
 
*Check the SD card location, like /dev/sdb
 
*#cd ./4220LIVxxxx_yyyy-mm-dd/scripts
 
*#./mksd-linux.sh /dev/sdb
 
*Type “y” (Start to copy files, wait until it shows [Done] )
 
  
Then insert the Linux system SD card to target board (like RSB-4220), it will boot up with Linux environment.
+
= <span class="mw-headline" id="Developement_Guide">Developement Guide</span> =
  
'''2.Create system from Source Code Package'''<br/>When you receive the advantech Linux source code package, you can refer following steps to create a Linux system SD card for booting up from it.we still use the RSB-4220 as demo:
+
== <span class="mw-headline" id="HW_module_Configuration_.26_driver"><span style="color:#0070c0">HW module Configuration & driver</span></span> ==
 
 
*Open "Terminal" on Ubuntu host PC.
 
*$sudo su (Change to “root” authority)
 
*Input your password.
 
*Insert one SD card to your developing computer
 
*Check the SD card location, like: /dev/sdb
 
*Ensure that you have built the uboot and kernel
 
*#cd $(BSP)/scripts
 
*#./mksd-linux.sh /dev/sdb
 
*Type “y” (Start to copy files, wait until it shows [Done] )
 
  
Then insert the Linux system SD card to target board's (such as RSB-4220) SD card slot, it will boot up with Linux environment.
+
*[http://ess-wiki.advantech.com.tw/view/IoTGateway/BSP/Linux/AM335x/V2/Hardware_module Hardware module]
  
=== Boot from Onboard Flash ===
+
== <span class="mw-headline" id="C.2FC.2B.2B_.26_Qt_Application_Development"><span style="color:#0070c0">C/C++ & Qt Application Development</span></span> ==
  
If you’ve already had a Linux system SD card, you can refer following steps to copy the content to onboard flash and then boot from onboard flash. Advantech also provide you a script “mkinand-linux.sh” to speed up the process of installing system image to onboard flash.
+
*[http://ess-wiki.advantech.com.tw/view/IoTGateway/BSP/Linux/AM335x/C/C++_Development C/C++ Application Development]
 +
*[http://ess-wiki.advantech.com.tw/view/IoTGateway/BSP/Linux/AM335x/Qt_Application_Development Qt Application Development]
  
*Ensure you have created a linux system on SD card
+
== <span class="mw-headline" id="System_Service_.26_Usage"><span style="color:#0070c0">System Service & Usage</span></span> ==
*Insert this Linux system SD card to target board and connect serial console.
 
*On your target system, type #root (Login)
 
*On your target system, type #cd /mk_inand
 
*On your target system, type #./mkinand-linux.sh /dev/mmcblk1
 
*Type “y” (Start to copy files, wait until it shows [Done] )
 
*After done, Power off and remove this SD card.
 
  
Then you can boot from onboard flash without SD card.
+
*[http://ess-wiki.advantech.com.tw/view/IoTGateway/BSP/Linux/AM335x/V2/System_Service_and_Usage System Service & Usage]

Latest revision as of 03:08, 6 February 2018

Start Guide

Generally,to do Linux development, you’ll need a host PC running Linux. In the development with the advantech SDK, it would be strongly recommend to use Ubuntu 12.04 LTS 64 bit/ Ubuntu 14.04 LTS 64 bit as developing environment. Because we have successfully tested our BSP on these OS version. Please install the Ubuntu 12.04 LTS 64 bit / Ubuntu 14.04 LTS 64 bit at your PC/NB in advance.

Configure your Linux Host

Please refer to Configure your Linux Host to configure  your linux host.

Install Advantech SDK

Please refer to Install Advantech SDK to install  advantech sdk.

BSP Building Guide

In the following building demo, we always assume building is for RSB4220 platform. others(such as ROM3310,RSB4221) are same。 $(BSP) is your BSP root directory. In order to simplify the description, we use "$(BSP)" to represent actual BSP root path. you need to replace the string to actual path。

1. Setup uboot and kernel build environment

  • $ sudo su (Change to “root” authority)
  • Input user password
    1. cd $(BSP)/scripts/
    2. source setenv.sh (To configure the developing environment automatically)

Then you can start to code the source code, build uboot and kernel images.

The setenv.sh script is used to configure the developing environment quickly. It will configure the folder paths for system.

Note! You have to run “#source setenv.sh” every time once you open a new "Terminal" utility. It is suggested to change to “root” authority to use the source code. And the “$(BSP)” is the root directory of BSP source code.
2. Build u-boot Image
Advantech has a script to build the u-boot quickly. You can build u-boot image by follow below steps:

  • Open "Terminal" on Ubuntu host PC.
  • $sudo su (Change to “root” authority)
  • Input user password.
    1. cd $(BSP)/scripts/
    2. source setenv.sh (To configure the developing environment automatically)
    3. ./cfg_uboot.sh am335x_rsb4220_defconfig (To set the u-boot configuration automatically)
    4. ./mk_uboot.sh (Start to build the u-boot)

Then you can see u-boot.img is being built and located in ../image.

3. Build Linux Kernel Image
Advantech offer you a script to build the “uImage” quickly. You can build uImage by follow below steps:

  • Open "Terminal" on Ubuntu host PC.
  • $sudo su (Change to “root” authority)
  • Input user password.
    1. cd $(BSP)/scripts/
    2. source setenv.sh (To configure the developing environment automatically)
    3. ./cfg_kernel.sh tisdk_am335x-rsb4220_defconfig (To set the uImage configuration automatically)
    4. ./mk_kernel.sh (Start to build the uImage)

Then you can see uImage is being built and located in ../image.

Update Linux OS

Please refer to Update Linux OS to update your linux os.

Developement Guide

HW module Configuration & driver

C/C++ & Qt Application Development

System Service & Usage