Difference between revisions of "Getting started with IGEPv2"

From IGEP - ISEE Wiki

Jump to: navigation, search
m
 
(95 intermediate revisions by 5 users not shown)
Line 1: Line 1:
__NOTOC__
+
{{Table/IGEP Technology Devices
 
+
|Tech_Family={{#lst:Template:Links|IGEPv2_Tech_Family}}
{| cellspacing="0" cellpadding="5" border="1" align="center" width="100%" style="text-align: left;"
+
|Tech_ID={{#lst:Template:Links|IGEPv2_Tech_ID}}
|-
 
| bgcolor="#cccccc" |'''IGEPv2 - Part 1/3'''
 
|-
 
|'''This tutorial is a starting point for IGEPv2.'''
 
|}
 
 
 
 
 
{{Navigation/IGEP Technology Guides
 
 
|Name={{#lst:Template:Links|IGEPv2_Name}}
 
|Name={{#lst:Template:Links|IGEPv2_Name}}
 
|Image={{#lst:Template:Links|IGEPv2_Image}}
 
|Image={{#lst:Template:Links|IGEPv2_Image}}
 
|ISEE_MainPage={{#lst:Template:Links|IGEPv2_ISEE_MainPage}}
 
|ISEE_MainPage={{#lst:Template:Links|IGEPv2_ISEE_MainPage}}
 
|ISEE_Hardware={{#lst:Template:Links|IGEPv2_ISEE_Hardware}}
 
|ISEE_Hardware={{#lst:Template:Links|IGEPv2_ISEE_Hardware}}
|Community_MainPage={{#lst:Template:Links|IGEPv2_Community_MainPage}}
 
|Community_Guides_1={{#lst:Template:Links|IGEPv2_Community_Guides_1}}
 
|Community_Guides_2={{#lst:Template:Links|IGEPv2_Community_Guides_2}}
 
 
}}
 
}}
  
  
{| cellspacing="0" cellpadding="5" border="1" align="center" style="text-align: left;"
+
__TOC__
|-
 
| bgcolor="#cccccc" colspan="3" | '''IGEP Technology Devices Guides - Part 1/3 - Summary'''
 
|-
 
| [[Image:{{#lst:Template:Links|IGEPv2_Image}}|250px|center|link={{#lst:Template:Links|IGEPv2_Community_MainPage}}]]
 
|-
 
|1) '''Connect a DVI Monitor'''
 
|-
 
|2) '''Connect a Serial cable'''
 
|-
 
|3) '''Connect Audio In/Out minijack'''
 
|-
 
|4) '''Connect USB devices (keyboard and mouse)'''
 
|-
 
|5) '''Connect network cable'''
 
|-
 
|6) '''Power up IGEPv2 (5V DC)'''
 
|}
 
 
 
 
 
This first chapter describes '''how to boot IGEPv2''' and also gives some '''basic instructions''' about how to connect some peripherals.
 
 
 
 
 
=== Setting up ===
 
----
 
First of all, you can begin to '''add some peripherals'''.
 
 
 
In this tutorial we are going to use:
 
 
 
* the serial cable
 
* a monitor
 
* a USB keyboard and a mouse
 
* a network cable.
 
 
 
Do NOT power up your board yet.
 
 
 
 
 
{| cellspacing="0" cellpadding="5" border="1" align="center" width="100%" style="text-align: left;"
 
|-
 
| bgcolor="#cccccc" |'''Monitor'''
 
|-
 
|IGEPv2 has a '''DVI-D interface''' where you can connect a '''HDMI connector to a monitor'''.
 
You will need a cable with '''male DVI-D connector''' for the monitor, and '''male HDMI connector''' from IGEPv2.
 
|}
 
 
 
The Digital Visual Interface (DVI) is a video standard interface designed to provide very high visual quality on digital display devices such as flat panel LCD computer displays and digital projectors. It is partially compatible with the High-Definition Multimedia Interface (HDMI) standard in digital mode (DVI-D), and VGA in analog mode (DVI-A).
 
 
 
 
 
Note that your monitor should be able to support 1024 x 768 @ 60 Hz, which is the default resolution in the preinstalled software.
 
  
 +
=Requirements=
 +
In this tutorial we are going to use the following peripherals:
  
{| cellspacing="0" cellpadding="5" border="1" align="center" width="100%" style="text-align: left;"
+
* IGEPv2 with its power supply
|-
+
* Monitor compatible with DVI-D
| bgcolor="#cccccc" |'''Serial'''
+
* HDMI/DVI-D cable
|-
+
* Network cable
|Connect an '''AT/Everex Cable''' to the '''10-pin serial header''' on IGEPv2 and a '''[http://en.wikipedia.org/wiki/Null_modem null modem] DB9 male-male''' serial cable between the board and your host machine.
+
* Powered USB HUB 2.0
|}
+
* USB keyboard and a mouse
 +
* PC
  
In the preinstalled software, the serial port is configured as a '''Debug interface'''.  
+
=Getting started=
 +
The following video illustrates the getting started process. You will see how to connect some peripherals and power up the board.
  
You can use the debug interface to interact with the IGEP Processor operating system [host] by typing commands in a client machine (your PC, for example) to perform specific tasks. You can communicate and open a debug session via many interfaces such Serial port, Ethernet, Wifi, USB Ethernet Gadget, etc.
+
<div style="text-align: center;">
 +
{{#ev:youtube|jtHL6JVo7kA|500}}
 +
</div>
 +
==Monitor==
 +
The board will connect to your DVI monitor via its HDMI connector. You can use a HDMI/DVI-D cable to connect the board to the monitor. Your monitor should be able to support 1024 x 768 @ 60 Hz, which is the default resolution used by the firmware.
  
Furthermore, if you connect an external device to the serial port you will be able to see the '''Linux Kernel traces''', as the system boots.
+
If your monitor doesn't have a DVI-D input, you can also use a HDMI input using a HDMI/HDMI cable, in that case you should [[How_do_I_edit_my_kernel_command_line | edit the kernel cmdline parameters]] and replace :
  
Therefore, you will be able to access IGEPv2 with a '''serial console''' from your client device (for example, a PC with Linux, Windows, etc.)
+
omapfb.mode=dvi:1280x720MR-16@60
  
[[Image:DSC 0177.JPG|thumb|550px|right|'''Serial''': AT/Everex Cable connected to the 10-pin serial header on IGEPv2. '''Network''': Ethernet cable]]
+
for this one :
  
To communicate with IGEPv2 via Serial port you have to '''connect your client machine to the serial debug port''' in your IGEPv2 (host).  
+
omapfb.mode=dvi:hd720-16@60
  
Once you have set the cable, then you have to run a serial console, or any program that can interact with the serial port in your host machine, such Minicom, PuTTy (Linux, Windows), Terminal (Windows), etc.
+
==Network==
 +
You may now plug the Ethernet cable into the 10/100 Ethernet jack of the board to get network access. The default firmware configures the Ethernet device with static ip address (192.168.5.1).
  
* If you don't know how to set up your serial cable, refer to the following article: '''[[How_to_setup_the_IDC10_cable|How to setup the IDC10 cable]]'''. Also, if you do not have Serial port in your host machine you might need a USB to Serial converter to communicate via this port.
+
==Keyboard/Mouse==
 +
The USB Host of the board is ONLY USB High speed (480Mbit/s). You will need a powered USB hub 2.0 to connect to most USB devices.
  
* If you are not familiar with a serial console, refer to this page, an extended article about '''[[Using serial debug port to communicate]]'''.
+
Now, connect an USB hub to the USB Host and plug your keyboard and mouse into the hub.
  
 +
==Booting==
 +
With all the peripherals attached, plug in the wall adapter (5V DC) and power on your board. You will see a few lights flash, see how to red leds light up and after a few seconds may light up only a fixed green led. The sequence will be different based on software version.
  
{| cellspacing="0" cellpadding="5" border="1" align="center" width="100%" style="text-align: left;"
+
"Under the hood" the bootloader is preparing to load the linux kernel. The linux kernel loads and initializes the hardware and mounts the root file system. Finally, you will see a screen desktop like the following screenshot.
|-
 
| bgcolor="#cccccc" |'''Audio'''
 
|-
 
|Connect an '''external output audio device''' to the 3.5mm jack Audio Out connector in IGEPv2, such as external stereo powered speakers.
 
|}
 
  
External Audio input devices, such as a powered microphone or the audio output of a PC or MP3 player, can be connected to the via a 3.5mm jack (Audio IN).
+
The pre-installed firmware in its flash memory consists of a minimal Linux-based distribution with a lite X Window System and GNOME Mobile based applications created with Poky Platform Builder.
  
 +
You can use the mouse and the keyboard to dive into the desktop.
  
{| cellspacing="0" cellpadding="5" border="1" align="center" width="100%" style="text-align: left;"
+
[[Image:Poky-screenshot.png|thumb|center|500px|Screenshot of the Desktop of the pre-installed software]]
|-
 
| bgcolor="#cccccc" |'''Keyboard & Mouse'''
 
|-
 
| In IGEPv2 you might need a powered hub to connect to most USB.
 
Connect an '''USB hub to the USB host connector''' in your IGEPv2, and then plug your keyboard and mouse into the USB hub.
 
|}
 
  
'''Only USB 2.0 devices will work''' in IGEPv2, so if you connect any USB mouse 1.0 into the USB host connector without using a USB hub 2.0, it will not work.
+
==Remote connection via Ethernet==
 +
{{Message/Information Message|title=|message=If you aren't using a Linux operating system, use [http://labs.isee.biz/index.php/IGEP_SDK_Virtual_Machine IGEP SDK Virtual Machine] to connect to the board}}
  
 +
In your Host Machine, open a terminal sessions set up an Ethernet alias for your network interface,
  
{| cellspacing="0" cellpadding="5" border="1" align="center" width="100%" style="text-align: left;"
+
$ sudo ifconfig eth0:0 192.168.5.10
|-
 
| bgcolor="#cccccc" |'''Network'''
 
|-
 
| Plug an '''Ethernet cable''' between IGEPv2 and your client machine (or any other network device with ethernet connectivity).
 
|}
 
  
IGEPv2 comes with one 10/100BASE-TX Ethernet ports.
+
Connect to the board using the SSH protocol
  
In the following chapters we will use ethernet to access IGEPv2 with IP configuration, send files, etc.
+
$ ssh root@192.168.5.1
  
 +
An empty password for root user should work to access to the shell prompt.
  
{| cellspacing="0" cellpadding="5" border="1" align="center" width="100%" style="text-align: left;"
+
{{Navigation/IGEP Technology Guides/Getting Started/Ending
|-
 
| bgcolor="#cccccc" |'''Power up'''
 
|-
 
| Once you have connected the peripherals '''you can apply power''' to your IGEPv2 (5V DCC).
 
|}
 
 
 
* '''Serial''': If you have connected the '''serial debug port''', you will see the system traces as the board is starting up. Finally you will see the boot prompt asking for login. (read the next chapter of this tutorial)
 
 
 
* '''LED's''': You will also see a few LED's flash in IGEPv2 during the system boot(the sequence will be different based on software version).
 
 
 
* '''Monitor''': Finally, if you connected the DVI-D signal (with HDMI connector) to a monitor, the desktop of the preinstalled software will appear on the screen and you will be able to use the mouse and the keyboard, if connected.
 
 
 
* '''USB devices''': You will be able to use your keyboard and mouse and 'play' with some features of this little distribution.
 
 
 
{|
 
|-
 
| [[Image:Poky-prompt-screenshot.png|thumb|550px|left|Poky prompt]] [[Image:Poky-screenshot.png|thumb|400px|right|Poky desktop]]
 
|}
 
<br style="clear:both" />
 
 
 
{{Navigation/IGEP Technology Devices Guides/Next Step
 
|Name={{#lst:Template:Links|IGEPv2_Name}}
 
|Community_MainPage={{#lst:Template:Links|IGEPv2_Community_MainPage}}
 
 
|Next_Step={{#lst:Template:Links|IGEPv2_Community_Guides_2}}
 
|Next_Step={{#lst:Template:Links|IGEPv2_Community_Guides_2}}
 
}}
 
}}
  
 
[[Category:IGEP Technology Devices Guides]]
 
[[Category:IGEP Technology Devices Guides]]
[[Category:IGEP0020]]
 
[[Category:Work in progress]]
 

Latest revision as of 10:10, 9 April 2018


Requirements

In this tutorial we are going to use the following peripherals:

  • IGEPv2 with its power supply
  • Monitor compatible with DVI-D
  • HDMI/DVI-D cable
  • Network cable
  • Powered USB HUB 2.0
  • USB keyboard and a mouse
  • PC

Getting started

The following video illustrates the getting started process. You will see how to connect some peripherals and power up the board.

Monitor

The board will connect to your DVI monitor via its HDMI connector. You can use a HDMI/DVI-D cable to connect the board to the monitor. Your monitor should be able to support 1024 x 768 @ 60 Hz, which is the default resolution used by the firmware.

If your monitor doesn't have a DVI-D input, you can also use a HDMI input using a HDMI/HDMI cable, in that case you should edit the kernel cmdline parameters and replace :

omapfb.mode=dvi:1280x720MR-16@60

for this one :

omapfb.mode=dvi:hd720-16@60

Network

You may now plug the Ethernet cable into the 10/100 Ethernet jack of the board to get network access. The default firmware configures the Ethernet device with static ip address (192.168.5.1).

Keyboard/Mouse

The USB Host of the board is ONLY USB High speed (480Mbit/s). You will need a powered USB hub 2.0 to connect to most USB devices.

Now, connect an USB hub to the USB Host and plug your keyboard and mouse into the hub.

Booting

With all the peripherals attached, plug in the wall adapter (5V DC) and power on your board. You will see a few lights flash, see how to red leds light up and after a few seconds may light up only a fixed green led. The sequence will be different based on software version.

"Under the hood" the bootloader is preparing to load the linux kernel. The linux kernel loads and initializes the hardware and mounts the root file system. Finally, you will see a screen desktop like the following screenshot.

The pre-installed firmware in its flash memory consists of a minimal Linux-based distribution with a lite X Window System and GNOME Mobile based applications created with Poky Platform Builder.

You can use the mouse and the keyboard to dive into the desktop.

Screenshot of the Desktop of the pre-installed software

Remote connection via Ethernet

Information.jpg If you aren't using a Linux operating system, use IGEP SDK Virtual Machine to connect to the board

In your Host Machine, open a terminal sessions set up an Ethernet alias for your network interface,

$ sudo ifconfig eth0:0 192.168.5.10

Connect to the board using the SSH protocol

$ ssh root@192.168.5.1

An empty password for root user should work to access to the shell prompt.



You have successfully completed this chapter of the guide.


Continue this tutorial guide: [[What can I do with IGEPv2|2/3 - What can I do with IGEPv2]]
Igep forum.png If you have any question, don't ask to ask at the IGEP Community Forum or the IGEP Community Chat Irc.png