Difference between revisions of "Getting started with IGEP COM MODULE"

From IGEP - ISEE Wiki

Jump to: navigation, search
(Created page with '__NOTOC__ {{Navigation/IGEP Technology Guides|device=IGEP0030}} {| cellspacing="0" cellpadding="5" border="1" align="center" width="100%" style="text-align: left;" |- | bgcolo…')
 
 
(33 intermediate revisions by 5 users not shown)
Line 1: Line 1:
__NOTOC__
+
{{Table/IGEP Technology Devices
 +
|Tech_Family={{#lst:Template:Links|IGEP_COM_MODULE_Tech_Family}}
 +
|Tech_ID={{#lst:Template:Links|IGEP_COM_MODULE_Tech_ID}}
 +
|Name={{#lst:Template:Links|IGEP_COM_MODULE_Name}}
 +
|Image={{#lst:Template:Links|IGEP_COM_MODULE_Image}}
 +
|ISEE_MainPage={{#lst:Template:Links|IGEP_COM_MODULE_ISEE_MainPage}}
 +
|ISEE_Hardware={{#lst:Template:Links|IGEP_COM_MODULE_ISEE_Hardware}}
 +
}}
  
{{Navigation/IGEP Technology Guides|device=IGEP0030}}
+
__TOC__
  
  
{| cellspacing="0" cellpadding="5" border="1" align="center" width="100%" style="text-align: left;"
+
=Overview=
|-
+
This is the 1/3 chapter of the Getting Started with IGEP COM MODULE Tutorial Guide. In this first chapter, we will learn :
| bgcolor="#cccccc" |'''Getting started with IGEP0030'''
 
|-
 
|'''This page is a starting point for all products of the IGEP0030 family such IGEP COM MODULE.'''
 
|}
 
  
 +
* Boot the board and touring the default firmware.
 +
* Connect and log into.
  
{| cellspacing="0" cellpadding="5" border="1" align="center" style="text-align: left;"
+
Upon completion, you will be ready to continue with chapter 2/3 that explains more advanced tasks.
|-
 
| bgcolor="#cccccc" colspan="3" | '''Overview'''
 
|-
 
| [[Image:Igep0030.jpg|250px|center|link=Category:IGEP0030]]
 
|-
 
|1) '''Connect USB OTG cable to a PC'''
 
|-
 
|2) '''Log into IGEP0030 via USB Ethernet Gadget'''
 
|-
 
|3) '''Log into IGEP0030 via Wifi'''
 
|}
 
  
 +
We HIGHLY RECOMMEND THAT YOU UPDATE YOUR FIRMWARE IMAGE TO A RECENT RELEASE to ensure you have the latest features and bug fixes. Please see the article on [[IGEP_firmware_Yocto | IGEP YOCTO Firmware]].
  
This first chapter describes '''how to boot IGEP030''' and also gives some '''basic instructions''' about how to connect some peripherals.
 
  
  
=== Setting up ===
 
----
 
  
In the first chapter of this tutorial we are going to use:
 
  
* an USB A type plug to mini B type plug
+
=Requirements=
* a computer with Windows or Linux installed on it
+
In this tutorial we are going to use the following peripherals:
  
Do NOT power up your board yet.
+
* IGEP COM MODULE
 +
* USB Standard-A to Mini-B type cable
 +
* Powered USB HUB 2.0
 +
* PC
  
 +
=Getting started=
 +
<div style="text-align: center;">
 +
{{#ev:youtube|mXwt-2E4USE|500}}
 +
</div>
  
{| cellspacing="0" cellpadding="5" border="1" align="center" width="100%" style="text-align: left;"
 
|-
 
| bgcolor="#cccccc" |'''Power up via USB OTG connector'''
 
|-
 
|'''Connect IGEP0030 to a computer via USB OTG'''
 
|-
 
|}
 
  
The on-board '''HS USB OTG port''' is used as the default '''power input for IGEP0030 standalone''' operating mode.
+
==Power up==
 +
The board can be powered though USB OTG connector. It's recomended use an external USB hub. Connect the USB Standard-A to Mini-B type cable between the board and the USB hub.
  
First of all, connect IGEP0030 to your machine via the on-board USB OTG port with '''a USB cable''' (USB A type plug to mini B type plug).
+
[[Image:IGEP_COM_MODULE_with_HUB.JPG|center|200px]]
  
Connect IGEP0030 to your machine. It will power up.
+
{{Message/Information Message|title=USB OTG power is not available on newer IGEP COM MODULE devices|message='''NOTE''': Newer IGEP COM MODULE devices (IGEP0030-RFxx version since 2016 year) don't allow power devices using USB OTG connector. You should be used an expansion board (as example [[IGEP_NEW_YORK|IGEP NEW YORK]])}}
  
 +
==Booting==
 +
With the board powered, you'll see a few lights flash, after a few seconds may light up a fixed green led. The sequence will be different based on software version.
  
=== Connect to IGEP0030 via USB OTG connector ===
 
----
 
  
{| 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'll be able access to the board using the USB Ethernet Gadget.
|-
 
| bgcolor="#cccccc" |'''Overview'''
 
|-
 
| 1) '''Install a SSH client such PuTTy'''
 
  
2) '''Connect via USB Ethernet Gadget/RNDIS driver''', SSH: root@192.168.7.2
+
==Remote connection via USB Ethernet Gadget==
|}
+
{{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.}}
  
You can log into IGEP0030 via many '''interfaces with network connectivity''', such wifi, usb-ethernet gadget.. and many others (when connected to an IGEP Expansion Board).
+
In your Host Machine, open a terminal session and connect to the board using the SSH protocol:
  
In this section of this tutorial we are going to '''connect via USB Ethernet gadget'''. This feature allows you to have an IP connection over USB.  
+
$ ssh root@192.168.7.1
  
IGEP0030 uses this functionality to allow users to log via SSH.
+
An empty password for root user should work to access to the shell prompt. If you're experiencing some problems connecting to the board try with following guide : [[Using USB ethernet gadget to communicate]]
  
You can use this feature to interact with the IGEP Processor operating system [host] by typing commands in a client machine (your PC, for example) to perform specific tasks in IGEP0030. You can communicate and open a debug session via many other interfaces such Serial port, Ethernet, Wifi, USB Ethernet Gadget, etc. (if available in an IGEP Expansion Board, for example).
+
{{Navigation/IGEP Technology Guides/Getting Started/Ending
 +
|Next_Step={{#lst:Template:Links|IGEP_COM_MODULE_Community_Guides_2}}
 +
}}
  
Therefore, you will be able to access IGEP0030  from your client device (for example, a PC with Linux, Windows, etc.)
+
[[Category:IGEP Technology Devices Guides]]
 
 
 
 
The pre-installed software in IGEP0030 configures the USB interface with a static IP: 192.168.7.2
 
''Note: You will be able to change it later''
 
 
 
Now, pick the right section, depending on the Operating System you are using:
 
 
 
 
 
==== Linux Configuration ====
 
 
 
You should have the usbnet module available for your Linux kernel. On most distributions, this is the case by default. If this is not the case for your distribution, you will need to enable USB networking support in the kernel. If you build your own kernel then you want 'CDC Ethernet support' in USB Network adaptors.
 
 
 
*'''Ubuntu 10.04 LTS Lucid Lynx'''
 
 
 
In the file /etc/network/interfaces, you should add a section which looks like this:
 
 
 
auto usb0
 
iface usb0 inet static
 
  address 192.168.7.1
 
  network 192.168.7.0
 
  netmask 255.255.255.0
 
  broadcast 192.168.7.255
 
  gateway 192.168.7.1
 
 
 
Connect to the board using ssh
 
 
 
ssh -l root 192.168.7.2
 
 
 
 
 
==== Windows configuration ====
 
 
 
 
 
*'''Windows 7'''
 
 
 
Follow this tutorial: http://robosavvy.com/forum/viewtopic.php?p=28788
 
 
 
 
 
*'''Windows XP'''
 
 
 
1. During the first seconds the module is recognized as OMAP3430. Avoid the installation of this device and wait until ''RNDIS/Ethernet gadget'' is detected by the operating system.
 
 
 
2. The following driver INF file from the Gumstix Project works under Windows XP. [http://www.davehylands.com/linux/gumstix/usbnet/linux.inf <span class="s1">http://www.davehylands.com/linux/gumstix/usbnet/linux.inf</span>]
 
 
 
3. In ''Control Panel/Network Connections'' and after driver installation set up the TCP/IP properties of the ''Local Network Connection'' (''Linux USB Ethernet/RNDIS Gadget'') as follow:<br>
 
<pre>IP address 192.168.7.1
 
 
 
Netmask 255.255.255.0
 
 
 
Gateway 192.168.7.1 </pre>
 
 
 
'''''Thanks to Iñigo Lazkanotegi from Tecnalia (Donostia - San Sebastián) for this contribution.'''''
 
 
 
Now you must run any serial console that allows SSH such PuTTy (Linux, Windows).
 
 
 
You can download it from its official page at: http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html
 
 
 
Then, run the '''SSH client''' and start a SSH session to connect to the host (IGEP0030) from the client (your PC):
 
 
 
[[Image:Putty ssh.png|center]]
 
 
 
 
 
# Select the '''SSH''' at connection type.
 
# Next insert the '''IP address of the target'''. In this case, the IGEP0030 default IP (192.168.7.2).
 
# Ensure that the port is set to '''22''', the default for SSH communications.
 
# Finally, push the '''Open button''' to start the SSH session.
 
 
 
 
 
If everything goes right, you will be able to access to an IGEP0030 console from your PC via USB Ethernet gadget.
 
 
 
 
 
=== Connect to IGEP0030 via Wifi ===
 
----
 
 
 
{| cellspacing="0" cellpadding="5" border="1" align="center" width="100%" style="text-align: left;"
 
|-
 
| bgcolor="#cccccc" |'''Overview'''
 
|-
 
|'''Connect via wireless connection''', ESSID: WLAN_IGEP, SSH: root@192.168.6.1
 
|}
 
 
 
By default, '''the pre-installed software in IGEP0030 enables the wifi interface''' and creates an Ad-Hoc network, with '''WLAN_IGEP as ESSID''' and a '''static IP address: 192.168.6.1'''.
 
 
 
If you have successfully followed the previous section of the tutorial, you might have used PuTTy to connect to IGEP0030 via USB Ethernet Gadget. In this section we will '''connect to your board using wifi'''.
 
 
 
Therefore, follow this instructions:
 
 
 
1. '''Connect to the WLAN_IGEP wireless network''' from IGEP0030 with a wireless adaptor
 
 
 
2. '''Set a static IP''' within the subnet to your wireless adapter (for example: 192.168.6.2)
 
 
 
3. '''Open a PuTTy session''' and select SSH, 192.168.6.1 as target IP address.
 
 
 
4. '''Log into IGEP0030''' with login: root and empty password (press return)
 
 
 
 
 
You now have logged into IGEP0030 via its wireless connection.
 
 
 
 
 
'''Other references'''
 
 
 
*[[Using USB ethernet gadget to communicate]]
 
*[[Using IGEP WLAN to communicate]]
 
 
 
 
 
{{Navigation/IGEP Technology Guides/Getting Started/Ending|device=IGEP0030}}
 
 
 
[[Category:IGEP0030]]
 
[[Category:Tutorials]]
 
[[Category:Work in progress]]
 

Latest revision as of 09:57, 6 April 2018


Overview

This is the 1/3 chapter of the Getting Started with IGEP COM MODULE Tutorial Guide. In this first chapter, we will learn :

  • Boot the board and touring the default firmware.
  • Connect and log into.

Upon completion, you will be ready to continue with chapter 2/3 that explains more advanced tasks.

We HIGHLY RECOMMEND THAT YOU UPDATE YOUR FIRMWARE IMAGE TO A RECENT RELEASE to ensure you have the latest features and bug fixes. Please see the article on IGEP YOCTO Firmware.



Requirements

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

  • IGEP COM MODULE
  • USB Standard-A to Mini-B type cable
  • Powered USB HUB 2.0
  • PC

Getting started


Power up

The board can be powered though USB OTG connector. It's recomended use an external USB hub. Connect the USB Standard-A to Mini-B type cable between the board and the USB hub.

IGEP COM MODULE with HUB.JPG
Information.jpg NOTE: Newer IGEP COM MODULE devices (IGEP0030-RFxx version since 2016 year) don't allow power devices using USB OTG connector. You should be used an expansion board (as example IGEP NEW YORK)

Booting

With the board powered, you'll see a few lights flash, after a few seconds may light up 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'll be able access to the board using the USB Ethernet Gadget.

Remote connection via USB Ethernet Gadget

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 session and connect to the board using the SSH protocol:

$ ssh root@192.168.7.1

An empty password for root user should work to access to the shell prompt. If you're experiencing some problems connecting to the board try with following guide : Using USB ethernet gadget to communicate



You have successfully completed this chapter of the guide.


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