Difference between revisions of "Setup"

From ArmadeusWiki
Jump to: navigation, search
(First StartUp)
(Build and update your system)
 
(116 intermediate revisions by 10 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 play with it ? Then follow this quick list to setup your envt accordingly: <br>
+
Just got your Armadeus development kit and want to start playing with it?
1] Connect your APF to your development board or to a Devlight
+
2] Connect the Host (your PC) to your development system with a crossover RS232 cable
+
3] Power up the system (+5Vdc for a Devlight ) <br>
+
4] Establish the connection between your Host and your APF [[Connect]] <br>
+
5] Verify your APF by starting Linux. In uBoot, type "boot". Several informations will be displayed on your console like on the screenshot here.
+
6] If Linux has successfully started, you can proceed with the toolchain installation. See Basics below
+
  
==Basics==
+
Follow these quick steps to setup your environment accordingly:
* [[Toolchain]]: How to install the development environment for the Armadeus boards
+
# Plug your APF/OPOS module in your development/docking board (custom one or Armadeus Systems official one) (your system will be hereafter referred to as "the Target").
* [[Connect]]: How to communicate with the Armadeus boards from the Host
+
# '''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).
* [[Target Software Installation]]: How to install, uBoot, Linux and your RootFS on the Armadeus boards
+
# '''On APF51Dev/APF28Dev/APF6Dev/OPOS6ULDev:''' connect your PC (= "the Host") to your board with a mini USB cable. On the devt board use the "Debug" connector.
 +
# [[Communicate | On your Host PC, Install the (minimum) tools to communicate with your APF/OPOS.]]
 +
# 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]].
  
==Packages and Modules==
+
===Tutorial===
* [[FrameBuffer]]: how to configure and use the framebuffer for new LCDs
+
If you want a more "user friendly" procedure, you can try [[Beginner's_tutorial|this (under construction) tutorial]].
* [[GPIO Driver]]: how to configure the GPIO driver
+
* [[Network Configuration]]: how to configure Host and Target network
+
* [[Serial Transfer]]: transfer files between your Host and your Armadeus board with the RS232 link
+
* [[USB Gadget]] -- Instructions to configure your Armadeus board to use it as a USB device (aka Gadget in Linux language)
+
* [[MultiMediaCard]] -- Instructions to use MMC/SD cards with your Armadeus board
+
* [[DAC|Digital to Analog Convertion]]: how to configure and use the DAC on your board
+
  
==Advanced==
+
==Build and update your system==
* [[BootLoader]]: (U-Boot useful tips)
+
# [[Embedded Linux system basis]]
* [[BootStrap]]: communicate and test your board when no software is installed on it
+
# [[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]]
 +
# [[Armadeus_3#How-to_develop_with_Armadeus_.2F_customize_your_SDK| Customize your Armadeus SDK]]
 +
 
 +
 
 +
{{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]]):
 +
 
 +
<pre class="apf">
 +
BIOS> run update_uboot
 +
BIOS> reset
 +
BIOS> run flash_reset_env
 +
BIOS> reset                (then define ''ipaddr'' and ''serverip'')
 +
...
 +
BIOS> run update_kernel    (not needed on OPOS6UL* boards)
 +
BIOS> run update_rootfs
 +
</pre>
 +
}}

Latest revision as of 14:11, 4 June 2019

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/OPOS 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 mini USB cable. On the devt board use the "Debug" connector.
  4. On your Host PC, Install the (minimum) tools to communicate with your APF/OPOS.
  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 "user friendly" procedure, you can try this (under construction) 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> reset                 (then define ''ipaddr'' and ''serverip'')
...
BIOS> run update_kernel     (not needed on OPOS6UL* boards)
BIOS> run update_rootfs