Difference between revisions of "IOT-GATE-iMX7 and SBC-IOT-iMX7: Linux: Automatic Installation"

From Compulab Mediawiki
Jump to: navigation, search
(See also)
 
imported>Uri.mashiach
m (Preparing installation media)
 
(2 intermediate revisions by one other user not shown)
Line 1: Line 1:
 
== Introduction ==
 
== Introduction ==
This article provides an installation guide for Linux kernel and Debian root file system on the IOT-GATE-iMX7 Internet of Things Gateway and SBC-IOT-iMX7 Internet of Things Single Board Computer eMMC internal storage device.
+
This article provides an installation guide for Linux kernel and Debian root file system onto the IOT-GATE-iMX7 IoT Gateway and SBC-IOT-iMX7 Single Board Computer on-board eMMC storage.
  
 
== Preparation steps ==
 
== Preparation steps ==
 
* Obtain a PC workstation with a USB port.
 
* Obtain a PC workstation with a USB port.
* Download the Linux package for IOT-GATE-iMX7 and SBC-IOT-iMX7 from CompuLab website. Use either [http://www.compulab.co.il/products/iot-gateways/iot-gate-imx7-nxp-i-mx-7-internet-of-things-gateway/#devres IOT-GATE-iMX7] or [http://www.compulab.co.il/products/sbcs/sbc-iot-imx7-nxp-i-mx-7-internet-of-things-single-board-computer/#devres SBC-IOT-iMX7] product web page for downloading. Unzip the package to a directory on your host workstation.
+
* Download the BSP binary for IOT-GATE-iMX7 and SBC-IOT-iMX7 from CompuLab website. Use either [http://www.compulab.com/products/iot-gateways/iot-gate-imx7-nxp-i-mx-7-internet-of-things-gateway/#devres IOT-GATE-iMX7] or [http://www.compulab.com/products/sbcs/sbc-iot-imx7-nxp-i-mx-7-internet-of-things-single-board-computer/#devres SBC-IOT-iMX7] product web page for downloading. Unzip the package to a directory on your host workstation.
 
* All image files mentioned below can be found in the {{filename|images}} subdirectory.
 
* All image files mentioned below can be found in the {{filename|images}} subdirectory.
 
* Use the standard microUSB-to-USB cable to connect the host PC to the micro USB connector marked '''Console''' on IOT-GATE-iMX7 rear panel (connector '''P3''' on SBC-IOT-iMX7).  
 
* Use the standard microUSB-to-USB cable to connect the host PC to the micro USB connector marked '''Console''' on IOT-GATE-iMX7 rear panel (connector '''P3''' on SBC-IOT-iMX7).  
Line 13: Line 13:
 
* Obtain a micro SD card. Any commercially available micro SD card of 1GB (or larger) may be used.
 
* Obtain a micro SD card. Any commercially available micro SD card of 1GB (or larger) may be used.
 
* Create a first partition on it. The partition can be formatted either ext2/3/4 or FAT file system.
 
* Create a first partition on it. The partition can be formatted either ext2/3/4 or FAT file system.
* Copy all files  found in the directory {{filename|images}} from the unzipped Linux package to the first partition on the installation media (micro SD card).
+
* Copy all files  found in the {{filename|install}} directory from the unzipped package to the first partition on the installation media (micro SD card).
 
<!--* Continue to the [[#Automatic Installation Procedure | Automatic Installation Procedure]] section.-->
 
<!--* Continue to the [[#Automatic Installation Procedure | Automatic Installation Procedure]] section.-->
  
 
== Automatic Installation Procedure ==
 
== Automatic Installation Procedure ==
* Start terminal emulation software on your PC with the following serial port settings:
+
{{:Transclusion: CL-SOM-iMX7: Linux: Automatic Installation: Procedure}}
<blockquote>
 
{{:SB-SOM: serial port parameters table}}
 
</blockquote>
 
* Plug the installation media (micro MMC/SD card) to the microSD socket marked '''uSD''' on IOT-GATE-iMX7 front panel (slot P18 on the SBC-iMX7).
 
* Turn on the device.
 
* The system will boot from the SD card and start the automatic installation procedure.
 
<pre>
 
    Kernel release : Linux Linux 4.1.15-cl-som-imx7-3.0
 
 
 
Press any key to cancel installation  5
 
</pre>
 
The Automatic Installation Procedure can be terminated by pressing any key during the timeout.
 
* The installation script performs all required steps including installing Linux images onto the eMMC storage device and setting up the boot environment.
 
{{Note| The Automatic Installation script cleans up the eMMC device during the installation procedure. All data stored on the eMMC device will be lost.}}
 
<pre>
 
=== Mount Source /dev/mmcblk0p1 ===
 
* mount_source [  ]
 
===Installing OS===
 
* Updating partitions
 
* Formatting partitions
 
* mount_destination [  ]
 
* Copying kernel files
 
* Extracting user space rootfs.tar.bz2
 
165MiB 0:02:38 [1.04MiB/s] [================================>] 100%           
 
* unmount_destination [  ]
 
=== Setup bootloader environment ===
 
=== Unmount Source /dev/mmcblk0p1 ===
 
* unmount_source [  ]
 
Please remove installation SD card ...
 
Press any key to cancel restart  0
 
...
 
</pre>
 
* The system will reboot automatically to the newly installed Debian Linux. Please reboot manually, if for some reason the system does not reboot automatically.
 
* Please remember to remove the installation SD card.
 
  
 
== Troubleshooting ==
 
== Troubleshooting ==
Line 58: Line 24:
 
== See also ==
 
== See also ==
 
* [[IOT-GATE-iMX7 and SBC-IOT-iMX7: Linux: Manual Installation]]
 
* [[IOT-GATE-iMX7 and SBC-IOT-iMX7: Linux: Manual Installation]]
* [[IOT-GATE-iMX7 and SBC-IOT-iMX7: Linux: Package contents]]
+
* [[CL-SOM-iMX7: Linux: Package contents]]
 
* [[IOT-GATE-iMX7 and SBC-IOT-iMX7: Linux: Debian]]
 
* [[IOT-GATE-iMX7 and SBC-IOT-iMX7: Linux: Debian]]
* [[IOT-GATE-iMX7 and SBC-IOT-iMX7: Linux: Kernel]]
+
* [[CL-SOM-iMX7: Linux: Kernel]]
 
* [[Linux Development for ARM modules]]
 
* [[Linux Development for ARM modules]]
  

Latest revision as of 13:41, 6 December 2018

Introduction

This article provides an installation guide for Linux kernel and Debian root file system onto the IOT-GATE-iMX7 IoT Gateway and SBC-IOT-iMX7 Single Board Computer on-board eMMC storage.

Preparation steps

  • Obtain a PC workstation with a USB port.
  • Download the BSP binary for IOT-GATE-iMX7 and SBC-IOT-iMX7 from CompuLab website. Use either IOT-GATE-iMX7 or SBC-IOT-iMX7 product web page for downloading. Unzip the package to a directory on your host workstation.
  • All image files mentioned below can be found in the images subdirectory.
  • Use the standard microUSB-to-USB cable to connect the host PC to the micro USB connector marked Console on IOT-GATE-iMX7 rear panel (connector P3 on SBC-IOT-iMX7).
  • Make sure the new /dev/ttyUSBx device file is created by using the ls /dev/ttyUSB* command. x is the last number of the ttyUSB device.

Preparing installation media

  • Obtain a micro SD card. Any commercially available micro SD card of 1GB (or larger) may be used.
  • Create a first partition on it. The partition can be formatted either ext2/3/4 or FAT file system.
  • Copy all files found in the install directory from the unzipped package to the first partition on the installation media (micro SD card).

Automatic Installation Procedure

  • Start terminal emulation software on your PC with the following serial port settings:
Baud Rate Data Bits Stop Bits Parity Flow Control
115200 8 1 none none
  • Plug the installation media (SD/microSD card) into the SD socket:
    • On SBC-iMX7 - SD socket P9
    • On SBC-IOT-iMX7 - micro-SD socket P18
    • On IOT-GATE-iMX7 - socket marked uSD
  • Turn on the system.
  • The system will boot from the SD card and start the automatic installation procedure.
        Kernel release : Linux 4.14.98-cl-som-imx7-6.3

===CompuLab Automatic Installation System 2.0.1 (Nov 20 2018)===
Press any key to cancel installation   0

The Automatic Installation Procedure can be terminated by pressing any key during the timeout.

  • The installation script performs all necessary steps including installing Linux images onto the on-board storage device (eMMC) and setting up the boot environment.
Admolition note.png The Automatic Installation script deletes the storage device during the installation procedure. All data stored on the eMMC will be lost.
=== Installation Target: eMMC ===
* Mounting extra images
* Loading extra modules
===Installing OS===
* Updating partitions
* Formatting partitions
* Copying kernel files
* Extracting user space rootfs.tar.bz2
 405MiB 0:06:37 [1.02MiB/s] [================================>] 100%            
* Unmounting extra images
Please remove installation SD card ...
Press any key to cancel restart   0
...
  • The system will reboot automatically to the newly installed Linux. Please reboot manually, if for some reason the system does not reboot automatically.
  • Please remember to remove the installation SD card.

Troubleshooting

  • Automatic installation doesn't start.

The U-Boot environment should be set to default:

  • Power on the board.
  • Press and hold Ctrl-C to get command prompt.
  • Set default U-Boot environment and boot the board:
CL-SOM-iMX7 # env default -a
CL-SOM-iMX7 # saveenv
CL-SOM-iMX7 # reset

See also