Difference between revisions of "IGEP Firmware set-up"

From IGEP - ISEE Wiki

Jump to: navigation, search
(Install IGEP Firmware on bootable SD-card)
 
(65 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
Depending on your desired set-up here you will find key-points on how the get and set the igep firmware
 
Depending on your desired set-up here you will find key-points on how the get and set the igep firmware
 +
 +
 +
 +
{| width="97%" cellspacing="4" cellpadding="4" border="0" align="center"
 +
|- style="height: 121.1px;"
 +
| style="height: 121.1px;" bgcolor="#ffffff"|
 +
[[Image:Warning_icon.png|left|97x88px]]
 +
 +
 +
<span style="color: #000000;">'''You should install kernel modules into each rootfs you download, don't miss  [http://labs.isee.biz/index.php/Linux_Kernel_4.9.y Linux Kernel Tutorial].'''</span>
 +
 +
|}
 +
==*!* General information about RootFS *!*==
 +
To log into each one of the RootFS and igep firmware presented below you use
 +
 +
UBUNTU / DEBIAN
 +
 +
* Username: root
 +
* Password: letmein
 +
 +
YOCTO
 +
 +
* Username: root
 +
* Password:
  
 
==Ubuntu==
 
==Ubuntu==
Download latest firmware from downloads server
+
Download latest release from downloads server
  
* [http://downloads.isee.biz/pub/isee-releases/ubuntu/xenial_16.04_lts/ubuntu-xenial-armhf-igep-base-v0.01.tgz Ubuntu Xenial 16.04 LTS (isee-v0.01)]
+
* [http://downloads.isee.biz/pub/isee-releases/ubuntu/xenial_16.04_lts/ubuntu-xenial-armhf-igep-base-v0.01.tgz Ubuntu Xenial 16.04 LTS (isee-v0.01) ARM Hard Float]
  
 
====Instructions needed to decompress in the SD====
 
====Instructions needed to decompress in the SD====
Line 11: Line 35:
  
 
  <span class="skimlinks-unlinked">sudo tar -xvzf /home/user/Downloads/ubuntu-xenial-armhf-igep-base-v0.01.tgz -C /media/user/rootfs</span>
 
  <span class="skimlinks-unlinked">sudo tar -xvzf /home/user/Downloads/ubuntu-xenial-armhf-igep-base-v0.01.tgz -C /media/user/rootfs</span>
 +
 
==Debian==
 
==Debian==
Download latest firmware from downloads server
+
Download latest release from downloads server
  
* [http://downloads.isee.biz/pub/relaunch/rootfs/debian/stretch/debian-stretch-armhf-igep-base-no-version.tgz Debian Stretch ARM Hard Float]
+
* [http://downloads.isee.biz/pub/relaunch/rootfs/debian/stretch/debian-stretch-armhf-igep-base-v0.01.tgz Debian Stretch ARM Hard Float]
  
 
====Instructions needed to decompress in the SD====
 
====Instructions needed to decompress in the SD====
Line 23: Line 48:
  
 
==Buildroot==
 
==Buildroot==
Download latest firmware from downloads server
+
Download latest release from downloads server
  
 
* [http://downloads.isee.biz/pub/relaunch/rootfs/buildroot/skeltal/igep-buildroot-skeltal-base-no-version.bz2 Buildroot ARM Hard Float]
 
* [http://downloads.isee.biz/pub/relaunch/rootfs/buildroot/skeltal/igep-buildroot-skeltal-base-no-version.bz2 Buildroot ARM Hard Float]
Line 32: Line 57:
  
 
  <span class="skimlinks-unlinked">sudo tar -xjzf /home/user/Downloads/igep-buildroot-skeltal-base-no-version.bz2 -C /media/user/rootfs</span>
 
  <span class="skimlinks-unlinked">sudo tar -xjzf /home/user/Downloads/igep-buildroot-skeltal-base-no-version.bz2 -C /media/user/rootfs</span>
 +
 
==Yocto==
 
==Yocto==
====<span id="Introduction" class="mw-headline">Introduction</span>====
+
===<u><span id="Introduction" class="mw-headline">Introduction</span></u>===
The IGEP Firmware could be [index.php/How_to_get_the_Poky_Linux_distribution built from scratch]
+
The IGEP Firmware could be [http://labs.isee.biz/index.php/How_to_use_the_Yocto_Project_to_develop_Embedded_Linux built from scratch] using a tool from the Yocto Project called Poky. The Poky build system allows developers to create their own complete Linux Distribution for their embedded systems.
 
 
using a tool from the Yocto Project called Poky. The Poky build system allows developers to create their own complete Linux Distribution for their embedded systems.
 
  
The firmware that runs on every [index.php/IGEP_Technology_devices IGEP Technology devices] is created in the hope to introduce you quickly to the IGEP Technology. The IGEP Firmware provides a preconfigured Linux system allowing communicating and experiencing easily with IGEP devices.
+
The firmware that runs on every [http://labs.isee.biz/index.php/IGEP_Technology_devices IGEP Technology devices]  is created in the hope to introduce you quickly to the IGEP Technology. The IGEP Firmware provides a preconfigured Linux system allowing communicating and experiencing easily with IGEP devices.
  
 
The image is built using the GNOME Mobile software stack, providing a well defined user experience. The user interface environment used is SATO, it is designed to work well with screens at very high DPI and restricted size. It is coded with focus on efficiency and speed so that it works smoothly on hand- held and other embedded hardware.
 
The image is built using the GNOME Mobile software stack, providing a well defined user experience. The user interface environment used is SATO, it is designed to work well with screens at very high DPI and restricted size. It is coded with focus on efficiency and speed so that it works smoothly on hand- held and other embedded hardware.
  
If you need to custom more your Linux OS, for example: editing, adding or removing packages, please read [index.php/How_to_get_the_Poky_Linux_distribution this article].
+
If you need to custom more your Linux OS, for example: editing, adding or removing packages, please read [http://labs.isee.biz/index.php/How_to_use_the_Yocto_Project_to_develop_Embedded_Linux this article]
  
====<span id="Features" class="mw-headline">Features</span>====
+
===<u><span id="Features" class="mw-headline">Features</span></u>===
 
======<span id="Software_included:" class="mw-headline">Software included:</span>======
 
======<span id="Software_included:" class="mw-headline">Software included:</span>======
 
GNU/Linux system
 
GNU/Linux system
Line 65: Line 89:
  
 
[http://downloads.isee.biz/denzil/rpm/ Software public repositories] (RPM-based)
 
[http://downloads.isee.biz/denzil/rpm/ Software public repositories] (RPM-based)
 
=====<span id="Other_useful_information" class="mw-headline">Other useful information</span>=====
 
''' Note that are only available for OMAP3 processors'''
 
 
Account information
 
 
* Username: root
 
* Password:
 
 
Network configuration (IP addresses)
 
 
* [index.php/Using_Ethernet_to_communicate eth0] − 192.168.5.1
 
* eth0:0 − assigned via dhcp.
 
* [index.php/Using_IGEP_WLAN_to_communicate wlan0] − 192.168.6.1 (with dhcp server)
 
* [index.php/Using_USB_ethernet_gadget_to_communicate usb0] − 192.168.7.1 (with dhcp server)
 
  
 
====<span id="Install" class="mw-headline">Install</span>====
 
====<span id="Install" class="mw-headline">Install</span>====
''(from [index.php/How_to_create_a_SD-card_with_the_latest_software_image How to create a SD-card with the latest software image])''
+
Download latest firmware from downloads server
 
 
{| width="auto" cellspacing="1" cellpadding="1" border="0" align="center"
 
|-
 
||
 
| style="text-align: center;"| 
 
|-
 
| scope="row"| 
 
||This How-To was tested IGEP SDK Virtual Machine, but most of the contents are valid also for other GNU/Linux distributions.
 
There is no guarantee that this will work on other ones.
 
  
|}
+
* [http://downloads.isee.biz/pub/relaunch/rootfs/yocto/pyro/minimal/ Yocto no-base ARM Hard Float repo]
====='''Create IGEP Firmware bootable SD-card'''=====
 
'''IGEP AM335x''' - The first thing you'll do is download the latest firwmare from [http://www.isee.biz/support/downloads/item/igep-firmware-yocto-1-4-2-0-am335x ISEE site Yocto IGEP AM335x]
 
  
'''IGEP OMAP 3''' - Start session in IGEP SDK Virtual Machine. The first thing you'll do is download the latest firwmare from [http://www.isee.biz/support/downloads/item/igep-firmware-yocto-1-2-2-6 ISEE site Yocto IGEP OMAP 3] <br />'''IGEP SMARC i.MX6 Dual/Quad''' - The first thing you'll do is download the latest firwmare from [http://downloads.isee.biz/pub/releases/firmware/igep_firmware-yocto-1.8-0-imx6q-igep0046.tar.bz2 ISEE site Yocto IGEP SMARC i.MX6 Dual/Quad] <br />'''IGEP SMARC i.MX6 DualLite''' - The first thing you'll do is download the latest firwmare from [http://downloads.isee.biz/pub/releases/firmware/igep_firmware-yocto-1.8-0-imx6dl-igep0046.tar.bz2 ISEE site Yocto IGEP SMARC i.MX6 DualLite] <br />'''IGEP SMARC i.MX6 Solo''' - The first thing you'll do is download the latest firwmare from [http://downloads.isee.biz/pub/releases/firmware/igep_firmware-yocto-1.8-0-imx6s-igep0046.tar.bz2 ISEE site Yocto IGEP SMARC i.MX6 Solo]
+
====Instructions needed to decompress in the SD====
 +
<pre>sudo tar -xvzf [your_compressed_rootfs] -C [target_location_rootfs]</pre>
 +
<span class="skimlinks-unlinked">'''For example''', to uncompress the rootfs of the link into the rootfs partition of the MicroSD Card you can write:</span>
  
 +
<span class="skimlinks-unlinked">sudo tar -xjzf /home/user/Downloads/igep002hf-yocto-pyro-minimal-base-no-version.bz2 -C /media/user/rootf</span>
 +
==IGEP-Tools==
 +
IGEP Tools are a set of binaries that should come with every firmware provided by ISEE. These tools will allow you to handle in a easy way the process of updating and creating new bootable media that will run on igep devices. A basic concept of each tools is described:
  
 +
* igep-media-create:  Create a new bootable SD cards or HD images.
 +
* igep-flash: Flash bootable images to the board's flash memory
 +
* create-android-image: Create an Android image tarball from Android build
 +
* e-functions: Required by other igep tools to function properly.
 +
* writeloader: Used by igep-flash when flashing igep-firmware for IGEPv2, IGEP COM MODULE, and IGEP COM PROTON boards due to ECC compatibility in those board's NAND
  
# Select Products -> Processor Boards
+
Usually igep-tools should come installed by default with igep firmware releases, in case it is not there you can always download them from our git repository:
# Click on your processor board product.
 
# Click on Software tab
 
# Click on IGEP Firmware
 
# Select Download icon.
 
 
 
Once the file is downloaded you can create bootable SD-Card, under Linux, untar the IGEP
 
 
 
<pre>tar jxf igep_firmware-yocto-*.tar.bz2
 
cd igep_firmware-yocto-*</pre>
 
Insert a SD-Card media and use the igep-media-create script to copy the firmware to SD-Card media.
 
 
 
<pre>./igep-media-create -–mmc  --image  --machine </pre>
 
where:<br /> - is the SD-Card device of your computer.<br /> - is the file that contains bootloader, kernel and rootfs image.<br /> - is the IGEP Processor Board. Available options are:
 
 
 
* igep0020 - For IGEP v2 Processor Board
 
* igep0030 - For IGEP COM MODULE Processor Board
 
* igep0032 - For IGEP COM PROTON Processor Board
 
* igep0033 - For IGEP COM AQUILA Processor Board
 
* igep0046 - For IGEP iMX6 Processor Board
 
 
 
<br />For example, assuming the SD-card device takes '/dev/sdf' and you have an IGEPv2 board ('igep0020'), type
 
 
 
<pre>./igep-media-create --mmc /dev/sdf --machine igep0020 --image demo-image-sato-igep00x0.tar.bz2</pre>
 
For example, assuming the SD-card device takes '/dev/sdb' and you have an IGEP COM MODULE ('igep0030'), type
 
 
 
<pre>./igep-media-create --mmc /dev/sdb --machine igep0030 --image demo-image-sato-igep00x0.tar.bz2</pre>
 
These methods should give you a bootable SD-card.
 
 
 
 
 
 
 
====='''Booting IGEP device and login/connect methods'''=====
 
Insert the bootable SD-card media into the micro-SD card socket
 
 
 
of IGEP device and power on it. This should result in a running system with Sato graphical desktop root filesystem built by Yocto.
 
 
 
If you want login in/connect to the system, you have several options:
 
 
 
* '''Serial debug link''', you should just plug serial cable to your computer
 
* '''Ethernet''', you should assign an IP in the range 192.168.5.[2-254] and connect to target using a SSH client and connecting to 192.168.5.1 
 
* '''Wifi''', connect to IGEP_xx network, a dynamic IP should be assigned in your host and you can sign into the target connecting to 192.168.6.1
 
* '''USB ethernet gadget''', connect a IGEP device to USB port of your computer, dynamic IP should be assigned in your host and you can sign into the target connecting to 192.168.7.1 o (if available) Graphical interface on plugged DVI/TFT display and USB Keyboard in IGEP device
 
  
The root password is empty, so to log in type ''''root'''' for the user name and hit 'Enter' at the Password prompt: (''empty password'') and you should be in.
+
<pre>git clone https://git.isee.biz/igep-tools/igep-tools.git</pre>
 +
<pre>cd igep-tools/script</pre>
 +
Insert a SD-Card media and use the igep-media-create script to copy the firmware to SD-Card media, required options are:
  
Then, you could play and fun with IGEP board.
+
==Install IGEP Firmware on bootable SD-card==
 +
''(usefull also [http://labs.isee.biz/index.php/How_to_flash_the_latest_software_image How Update board Flash with the latest software image] )''
  
For example, you could flash the latest software image into internal FLASH memory ( [index.php/How_to_flash_the_latest_software_image How to flash the latest software image] )
+
The first thing you'll do is download the latest firwmare according to your igep model
  
  
  
{| width="auto" cellspacing="0" cellpadding="10" border="0" align="center"
+
{| class="contenttable sortable"
 +
|- style="height: 22px;"
 +
! style="text-align: center; height: 22px;"|IGEP BOARD
 +
! style="text-align: center; height: 22px;"|Firmware v1.0 no-x11 (Pyro 2.3)
 
|-
 
|-
| scope="row" bgcolor="#ffffff"| 
+
| style="text-align: center;"|IGEPv2
| style="font-size: 130%;" bgcolor="#ffffff"|<span style="color: #000000;">If you have any question, don't ask to ask at the '''[http://forum.isee.biz/ IGEP Community Forum]''' or the '''[http://webchat.freenode.net/?channels=igep IGEP Community Chat]'''</span>
+
| style="text-align: center;"|[http://downloads.isee.biz/pub/relaunch/igep0020/firmware/igep0020-yocto-pyro-minimal-firmware-v1.0.tar.bz2 Yocto Pyro IGEPv2 Minimal]
| scope="row" bgcolor="#ffffff"| 
+
|- style="height: 22px;"
 +
| style="text-align: center; height: 22px;"|IGEP COM MODULE
 +
| style="text-align: center; height: 22px;"|[http://downloads.isee.biz/pub/relaunch/igep0030/firmware/igep0030-yocto-pyro-minimal-firmware-v1.0.tar.bz2 Yocto Pyro COM MODULE Minimal]
 +
|- style="height: 22px;"
 +
| style="text-align: center; height: 22px;"|IGEP COM AQUILA
 +
| style="text-align: center; height: 22px;"|[http://downloads.isee.biz/pub/relaunch/igep0033/firmware/igep0033-yocto-pyro-minimal-firmware-v1.0_512.tar.bz2 Yocto Pyro AQUILA (NAND 512 MB) Minimal  |][http://downloads.isee.biz/pub/relaunch/igep0033/firmware/igep0033-yocto-pyro-skeltal-firmware-v1.0.tar.bz2  <span style="color: #ff0000;">Yocto Pyro AQUILA (NAND 128MB) Skeltal ***</span>]
 +
|- style="height: 22px;"
 +
| style="text-align: center; height: 22px;"|IGEP SMARC AM335X
 +
| style="text-align: center; height: 22px;"|[http://downloads.isee.biz/pub/relaunch/igep0034/firmware/igep0034-yocto-pyro-minimal-firmware-v1.0.tar.bz2 Yocto Pyro AM335X -Minimal]
 +
|- style="height: 22px;"
 +
| style="text-align: center; height: 22px;"|IGEP SMARC iMX6
 +
| style="text-align: center; height: 22px;"|[http://downloads.isee.biz/pub/relaunch/igep0046dl/firmware/igep0046dl-yocto-pyro-minimal-firmware-v1.0.tar.bz2 Yocto Pyro iMX6DL Minimal] | [http://downloads.isee.biz/pub/relaunch/igep0046q/firmware/igep0046q-yocto-pyro-minimal-firmware-v1.0.tar.bz2 Yocto Pyro iMX6Q Minimal]
 +
|- style="height: 22px;"
 +
| style="text-align: center; height: 22px;"|IGEP SMARC iMX6UL/ULL
 +
| style="text-align: center; height: 22px;"|[http://downloads.isee.biz/pub/relaunch/igep0146/ready-rootfs/yocto/minimal/igep0146-yocto-minimal-kernel-4-9-11.tar.bz2 Yocto Pyro iMX6UL Minimal]
 
|}
 
|}
====<span id="Extending_the_IGEP_Firmware_with_packages" class="mw-headline">Extending the IGEP Firmware with packages</span>====
+
<span style="color: #ff0000;">*** Only use this firmware to flash the NAND memory of and IGEP COM AQUILA with 128 MiB NAND. Place it at /opt/firmware and execute the procedure in '' [http://labs.isee.biz/index.php/How_to_flash_the_latest_software_image How Update board Flash with the latest software image]''</span>
''' Note that the repositories are only available for OMAP3 processors'''
 
  
The IGEP Firmware is based on RPM packages. The RPM Package
+
Insert a SD-Card media and use the [http://labs.isee.biz/index.php/IGEP_Firmware_set-up#IGEP-Tools igep-media-create] script to copy the firmware to SD-Card media.
  
Manager is a package management system that automates the process of installing, upgrading and removing software packages. If you also need some software that is typically not found in the IGEP Firmware, you can search if this software it’s available in the ISEE repositories.
+
<pre>./igep-media-create --cp-uenv -–mmc  --image  --machine </pre>
 +
where:<br /> - is the SD-Card device of your computer.<br /> - is the file that contains bootloader, kernel and rootfs image.<br /> - is the IGEP Processor Board. Available options are:
  
You can manage packages from the IGEP Firmware using "zypper". Zypper is the command line package manager installed on the IGEP Firmware for installing, removing, updating and querying software packages of local or remote repositories. Use following commands:
+
* '''igep0033''' - For IGEP COM AQUILA Processor Board
 +
* '''igep0034'''- For IGEP SMARC AM335x , <span style="color: #0000ff;">'''IGEPv2'''</span> , <span style="color: #0000ff;">'''IGEP COM MODULE'''</span> and '''<span style="color: #0000ff;">IGEP COM PROTON</span>''' Processor Boards
 +
* '''igep0046''' - For IGEP iMX6, iMX6UL Processor Board (S/DL/Q/UL/ULL)
  
* To get the package list from the repository, use
+
'''<span style="color: #ff0000;">*** It is important to use igep0034 machine even for IGEPv2  (igep0020) IGEP COM MODULE  (igep0030) and IGEP COM PROTON (igep0032) for this specific tool due to backwards incompatibility. Until a new patch of igep-media-create is made. Remember for those boards to use --machine igep0034 as argument</span>'''
  
<pre>zypper refresh</pre>
+
<br />For example, assuming the SD-card device takes '/dev/sdf' and you have an IGEPv2 board , type
* To search a package
 
  
<pre>zypper search package_name</pre>
+
<pre>./igep-media-create --cp-uenv --mmc /dev/sdf --machine igep0034 --image igep0020-yocto-pyro-minimal-firmware-v1.0.tar.bz2</pre>
* To install a package from registered repositories, use
+
For example, assuming the SD-card device takes '/dev/sdb' and you have an IGEP COM MODULE ('igep0030'), type
  
<pre>zypper install package_name</pre>
+
<pre>./igep-media-create --cp-uenv --mmc /dev/sdb --machine igep0034 --image igep0020-yocto-pyro-minimal-firmware-v1.0.tar.bz2</pre>
* To remove an installed package, use
+
These methods should give you a bootable SD-card.
 
 
<pre>zypper remove package_name</pre>
 
* A list of all new packages available can be obtained with the command
 
 
 
<pre>zypper list-updates -t package</pre>
 
* To update your system, just run the
 
 
 
<pre>zypper update</pre>
 
* Other useful zypper commands :
 
 
 
<pre>zypper help
 
zypper help command</pre>
 
==IGEP-Tools==
 

Latest revision as of 14:05, 27 November 2018

Depending on your desired set-up here you will find key-points on how the get and set the igep firmware


Warning icon.png


You should install kernel modules into each rootfs you download, don't miss  Linux Kernel Tutorial.

*!* General information about RootFS *!*

To log into each one of the RootFS and igep firmware presented below you use

UBUNTU / DEBIAN

  • Username: root
  • Password: letmein

YOCTO

  • Username: root
  • Password:

Ubuntu

Download latest release from downloads server

Instructions needed to decompress in the SD

sudo tar -xvzf [your_compressed_rootfs] -C [target_location_rootfs]

For example, to uncompress the rootfs of the link into the rootfs partition of the MicroSD Card you can write:

sudo tar -xvzf /home/user/Downloads/ubuntu-xenial-armhf-igep-base-v0.01.tgz -C /media/user/rootfs

Debian

Download latest release from downloads server

Instructions needed to decompress in the SD

sudo tar -xvzf [your_compressed_rootfs] -C [target_location_rootfs]

For example, to uncompress the rootfs of the link into the rootfs partition of the MicroSD Card you can write:

sudo tar -xvzf /home/user/Downloads/debian-stretch-armhf-igep-base-no-version.tgz -C /media/user/rootfs

Buildroot

Download latest release from downloads server

Instructions needed to decompress in the SD

sudo tar -xvzf [your_compressed_rootfs] -C [target_location_rootfs]

For example, to uncompress the rootfs of the link into the rootfs partition of the MicroSD Card you can write:

sudo tar -xjzf /home/user/Downloads/igep-buildroot-skeltal-base-no-version.bz2 -C /media/user/rootfs

Yocto

Introduction

The IGEP Firmware could be built from scratch using a tool from the Yocto Project called Poky. The Poky build system allows developers to create their own complete Linux Distribution for their embedded systems.

The firmware that runs on every IGEP Technology devices  is created in the hope to introduce you quickly to the IGEP Technology. The IGEP Firmware provides a preconfigured Linux system allowing communicating and experiencing easily with IGEP devices.

The image is built using the GNOME Mobile software stack, providing a well defined user experience. The user interface environment used is SATO, it is designed to work well with screens at very high DPI and restricted size. It is coded with focus on efficiency and speed so that it works smoothly on hand- held and other embedded hardware.

If you need to custom more your Linux OS, for example: editing, adding or removing packages, please read this article

Features

Software included:

GNU/Linux system

  • Linux kernel.
  • Root filesystem (initscripts, X11-based, EXT3, JFFS2, UBIFS, VFAT, NTFS, NFS...)
  • Drivers (USB,SPI,I2C,CAN,Ethernet,GPRS,...)
  • Network protocols (TCP/IP, UDP/IP, ARP, ICMP, SNMP, TFTP, TELNET, DHCP,BOOTP, SSH-SSL, HTTP, HTTP-SSL, NAT, NTP, PPP,...)
  • RPM package system.

GNOME Mobile software stack

  • GTK toolkit for interface construction.
  • GConf application configuration service which leverages XML for data persistence.
  • GnomeVFS file access abstraction layer which provides support for network transparent file manipulation.
  • GStreamer multimedia framework which supports dynamic media editing as well as playback.
  • D-Bus interprocess communication system.
  • BlueZ Bluetooth stack.
  • Avahi service for Zeroconf service discovery.

Software public repositories (RPM-based)

Install

Download latest firmware from downloads server

Instructions needed to decompress in the SD

sudo tar -xvzf [your_compressed_rootfs] -C [target_location_rootfs]

For example, to uncompress the rootfs of the link into the rootfs partition of the MicroSD Card you can write:

sudo tar -xjzf /home/user/Downloads/igep002hf-yocto-pyro-minimal-base-no-version.bz2 -C /media/user/rootf

IGEP-Tools

IGEP Tools are a set of binaries that should come with every firmware provided by ISEE. These tools will allow you to handle in a easy way the process of updating and creating new bootable media that will run on igep devices. A basic concept of each tools is described:

  • igep-media-create:  Create a new bootable SD cards or HD images.
  • igep-flash: Flash bootable images to the board's flash memory
  • create-android-image: Create an Android image tarball from Android build
  • e-functions: Required by other igep tools to function properly.
  • writeloader: Used by igep-flash when flashing igep-firmware for IGEPv2, IGEP COM MODULE, and IGEP COM PROTON boards due to ECC compatibility in those board's NAND

Usually igep-tools should come installed by default with igep firmware releases, in case it is not there you can always download them from our git repository:

git clone https://git.isee.biz/igep-tools/igep-tools.git
cd igep-tools/script

Insert a SD-Card media and use the igep-media-create script to copy the firmware to SD-Card media, required options are:

Install IGEP Firmware on bootable SD-card

(usefull also How Update board Flash with the latest software image )

The first thing you'll do is download the latest firwmare according to your igep model


IGEP BOARD Firmware v1.0 no-x11 (Pyro 2.3)
IGEPv2 Yocto Pyro IGEPv2 Minimal
IGEP COM MODULE Yocto Pyro COM MODULE Minimal
IGEP COM AQUILA Yocto Pyro AQUILA (NAND 512 MB) Minimal  |Yocto Pyro AQUILA (NAND 128MB) Skeltal ***
IGEP SMARC AM335X Yocto Pyro AM335X -Minimal
IGEP SMARC iMX6 Yocto Pyro iMX6DL Minimal | Yocto Pyro iMX6Q Minimal
IGEP SMARC iMX6UL/ULL Yocto Pyro iMX6UL Minimal

*** Only use this firmware to flash the NAND memory of and IGEP COM AQUILA with 128 MiB NAND. Place it at /opt/firmware and execute the procedure in  How Update board Flash with the latest software image

Insert a SD-Card media and use the igep-media-create script to copy the firmware to SD-Card media.

./igep-media-create --cp-uenv -–mmc  --image  --machine 

where:
- is the SD-Card device of your computer.
- is the file that contains bootloader, kernel and rootfs image.
- is the IGEP Processor Board. Available options are:

  • igep0033 - For IGEP COM AQUILA Processor Board
  • igep0034- For IGEP SMARC AM335x , IGEPv2 , IGEP COM MODULE and IGEP COM PROTON Processor Boards
  • igep0046 - For IGEP iMX6, iMX6UL Processor Board (S/DL/Q/UL/ULL)

*** It is important to use igep0034 machine even for IGEPv2  (igep0020) IGEP COM MODULE  (igep0030) and IGEP COM PROTON (igep0032) for this specific tool due to backwards incompatibility. Until a new patch of igep-media-create is made. Remember for those boards to use --machine igep0034 as argument


For example, assuming the SD-card device takes '/dev/sdf' and you have an IGEPv2 board , type

./igep-media-create --cp-uenv --mmc /dev/sdf --machine igep0034 --image igep0020-yocto-pyro-minimal-firmware-v1.0.tar.bz2

For example, assuming the SD-card device takes '/dev/sdb' and you have an IGEP COM MODULE ('igep0030'), type

./igep-media-create --cp-uenv --mmc /dev/sdb --machine igep0034 --image igep0020-yocto-pyro-minimal-firmware-v1.0.tar.bz2

These methods should give you a bootable SD-card.