Difference between revisions of "Setup"

From ArmadeusWiki
Jump to: navigation, search
m (First StartUp)
(Build and update your system)
(37 intermediate revisions by 8 users not shown)
Line 1: Line 1:
On this page, you will find all the usefull informations you need to configure your Armadeus board for optimum usage.
+
On this page, you will find all the useful information to configure your Armadeus board for optimum usage.
  
 
==First StartUp==
 
==First StartUp==
Just got your Armadeus board and want to start playing with it ? Follow these quick steps to setup your environment accordingly:
+
Just got your Armadeus development kit and want to start playing with it?
# Connect your APF to your development board (custom or [[APF9328DevLight|DevLight]]/[[APF9328DevFull|DevFull]]) (your system will be hereafter referred to as "the Target") --->> [[Image:Apf_on_devlight.png|40px]]
+
# Connect your PC (= "the Host") to your board with a [http://en.wikipedia.org/wiki/Null_modem null-modem RS232 cable] (only Rx/Tx/Gnd signals are needed). If you don't have a RS232 port on your Host, you can use a "USB <-> serial" converter (you'll still require the null-modem cable).
+
# [[Communicate | Install (minimum) tools to communicate with your APF from your Host.]]
+
# [[Development_boards_power_supply | Connect the power supply on your development board.]]
+
# Verify your system is booting by starting Linux: In U-Boot console, type "boot". Several informations will be displayed on your terminal like on this [[Linux start screenshot | screenshot ]] (Default Linux login is "root" with an empty password). '''IF NOT''', walk through [[U-Boot communication quick check|this small checklist]].
+
# If Linux has successfully started, your system is operational. If you want to add applications to your board or developp custom ones, then you can proceed with the Toolchain installation. [[Setup#Basics | See Basics below]].
+
  
==Basics for customizing your board==
+
Follow these quick steps to setup your environment accordingly:
 +
# Plug your APF module in your development/docking board (custom one or Armadeus Systems official one) (your system will be hereafter referred to as "the Target")
 +
# '''On APF9328Dev/APF27Dev/PPS:''' connect your PC (= "the Host") to your board with a [http://en.wikipedia.org/wiki/Null_modem null-modem RS-232 cable] (only Rx/Tx/Gnd signals are needed). If you don't have a RS-232 port on your Host, you can use a "USB <-> serial" converter (you'll still need the null-modem cable).
 +
# '''On APF51Dev/APF28Dev/APF6Dev/OPOS6ULDev:''' connect your PC (= "the Host") to your board with a USB cable. On the devt board use the "Debug" miniUSB connector
 +
# [[Communicate | Install (minimum) tools to communicate with your APF/OPOS from your Host.]]
 +
# Connect the power supply to your development board. (See the [[Datasheet]] of your *Dev board for more informations)
 +
# Verify your system is booting and starting Linux (In U-Boot console, type "boot" if bootdelay is too long). Several information will be displayed on your terminal like on this [[Linux start screenshot | screenshot]] (Default Linux login is "root" with an empty password). '''If your system is NOT starting''', walk through [[U-Boot communication quick check|this small checklist]].
 +
# If Linux has successfully started, your system is operational. If you want to add applications to your board or develop custom ones, then you can proceed with the Toolchain installation. [[Setup#Build_and_update_your_system | See Build and update your system]].
 +
 
 +
===Tutorial===
 +
If you want a more "userfriendly" procedure, you can try this (under construction) tutorial: [[Beginner's_tutorial]]
 +
 
 +
==Build and update your system==
 +
# [[Embedded Linux system basis]]
 
# [[Toolchain| Install the development environment (=Toolchain) for your board and generate your Linux/rootfs images]]
 
# [[Toolchain| Install the development environment (=Toolchain) for your board and generate your Linux/rootfs images]]
 
# [[Target Software Installation| Install/flash your U-Boot, Linux and rootfs freshly generated images on your board]]
 
# [[Target Software Installation| Install/flash your U-Boot, Linux and rootfs freshly generated images on your board]]
 
# [[Armadeus_3#How-to_develop_with_Armadeus_.2F_customize_your_SDK| Customize your Armadeus SDK]]
 
# [[Armadeus_3#How-to_develop_with_Armadeus_.2F_customize_your_SDK| Customize your Armadeus SDK]]
  
==Going further with your board==
 
* [[Network File System configuration| How to configure NFS on Host and Target]]
 
* [[MultiMediaCard | How to use MMC/SD/microSD cards from Linux on your Armadeus board]]
 
* [[ALSA|How to play sound with your board]]
 
* [[Mplayer|How to play videos on you board]]
 
 
* [[FrameBuffer]]: how to configure and use the framebuffer for new LCDs
 
* [[BackLight| How to control the backlight of you graphical LCD (if it supports it)]]
 
* [[GPIO Driver]]: how to configure the GPIO driver
 
* [[Boa]]: How install and configure the boa Web server on your board
 
* [[USB Gadget]]: how to configure your Armadeus board to use it as a USB device (aka Gadget in Linux language)
 
* [[DAC|Digital to Analog Convertion]]: how to configure and use the DAC on your board
 
* [[ADC max1027|Analog to Digital Converter]]: how to install and use the on board ADC (max1027)
 
* [[PWM]]: how to use the i.MX integrated PWM
 
* [[RTC]]: how to use an external Real Time Clock (Maxim DS1374)
 
* [[Watchdog]]: how to configure and use the i.MX integrated Watchdog
 
* [[TV Output]]: How to use the SVideo output of the APF9328DevFull
 
* [[USB Host]]: How to use USB Host controllers of the APF9328DevFull and APF27
 
* [[TSC2102 Linux driver| Touchscreen ]]: How to configure and use the touchscreen controller
 
* [[CAN bus Linux driver]]: how to configure and use the CAN controller of the DevFull
 
  
==Advanced==
+
{{Note| When a board is shipped, default factory binaries are flashed on it. It can be a legacy version of the armadeus BSP. So it's important to load the latest release binaries ("Get latest release" menu on side bar of this wiki), or build them yourself, and update all software with the following commands (on U-Boot assuming the image files have already been copied in /tftpboot, and [[Communicate#TFTP_server_installation | tftpboot server is correctly installed on your host]]):
* [[Ethernet_MAC_address|How to change your board Ethernet MAC address]] (Thanks to Julien Catalano)
+
* [[BootLoader]]: (U-Boot useful tips)
+
* [[BootStrap]]: Install U-Boot from scratch or recover your U-Boot if it was corrupted
+
* [[Serial Transfer| How to transfer files between your Host and your Armadeus board's Linux with the RS232 link]] (if you don't have Ethernet/NFS/TFTP/MMC/USB)
+
* [[Armadeus 3]]: How to use the third generation of Armadeus SDK at a glance (notably for 2.x users). Newcomers can particularly find the chapter [[Armadeus_3#How-to_develop_with_Armadeus_.2F_customize_your_SDK| How-to customize your Armadeus SDK]] interesting.
+
  
{{LanguageBar|Setup|Configuration|Konfiguration}}
+
<pre class="apf">
 +
BIOS> run update_uboot
 +
BIOS> reset
 +
BIOS> run flash_reset_env
 +
...
 +
BIOS> run update_kernel
 +
BIOS> run update_rootfs
 +
</pre>
 +
}}

Revision as of 08:12, 6 July 2017

On this page, you will find all the useful information to configure your Armadeus board for optimum usage.

First StartUp

Just got your Armadeus development kit and want to start playing with it?

Follow these quick steps to setup your environment accordingly:

  1. Plug your APF module in your development/docking board (custom one or Armadeus Systems official one) (your system will be hereafter referred to as "the Target")
  2. On APF9328Dev/APF27Dev/PPS: connect your PC (= "the Host") to your board with a null-modem RS-232 cable (only Rx/Tx/Gnd signals are needed). If you don't have a RS-232 port on your Host, you can use a "USB <-> serial" converter (you'll still need the null-modem cable).
  3. On APF51Dev/APF28Dev/APF6Dev/OPOS6ULDev: connect your PC (= "the Host") to your board with a USB cable. On the devt board use the "Debug" miniUSB connector
  4. Install (minimum) tools to communicate with your APF/OPOS from your Host.
  5. Connect the power supply to your development board. (See the Datasheet of your *Dev board for more informations)
  6. Verify your system is booting and starting Linux (In U-Boot console, type "boot" if bootdelay is too long). Several information will be displayed on your terminal like on this screenshot (Default Linux login is "root" with an empty password). If your system is NOT starting, walk through this small checklist.
  7. If Linux has successfully started, your system is operational. If you want to add applications to your board or develop custom ones, then you can proceed with the Toolchain installation. See Build and update your system.

Tutorial

If you want a more "userfriendly" procedure, you can try this (under construction) tutorial: Beginner's_tutorial

Build and update your system

  1. Embedded Linux system basis
  2. Install the development environment (=Toolchain) for your board and generate your Linux/rootfs images
  3. Install/flash your U-Boot, Linux and rootfs freshly generated images on your board
  4. Customize your Armadeus SDK


Note Note: When a board is shipped, default factory binaries are flashed on it. It can be a legacy version of the armadeus BSP. So it's important to load the latest release binaries ("Get latest release" menu on side bar of this wiki), or build them yourself, and update all software with the following commands (on U-Boot assuming the image files have already been copied in /tftpboot, and tftpboot server is correctly installed on your host):
BIOS> run update_uboot
BIOS> reset
BIOS> run flash_reset_env
...
BIOS> run update_kernel
BIOS> run update_rootfs