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

From IGEP - ISEE Wiki

Jump to: navigation, search
m
m (Undo revision 9376 by Pau pajuelo (Talk))
 
(11 intermediate revisions by 3 users not shown)
Line 1: Line 1:
__NOTOC__
 
 
 
{{Table/IGEP Technology Devices
 
{{Table/IGEP Technology Devices
 
|Tech_Family={{#lst:Template:Links|IGEP_COM_PROTON_Tech_Family}}
 
|Tech_Family={{#lst:Template:Links|IGEP_COM_PROTON_Tech_Family}}
Line 11: Line 9:
  
  
{| cellspacing="0" cellpadding="5" border="1" align="center" style="text-align: left;"
+
= Overview =
|-
 
| bgcolor="#cccccc" colspan="3" | '''Overview'''
 
|-
 
|1) '''Connect USB OTG cable to a PC'''
 
|-
 
|2) '''Log into IGEP COM PROTON via USB Ethernet Gadget'''
 
|}
 
 
 
 
 
This first chapter describes '''how to boot IGEP COM PROTON''' 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
 
* a computer with Windows or Linux installed on it
 
 
 
Do NOT power up your board yet.
 
 
 
 
 
{| cellspacing="0" cellpadding="5" border="1" align="center" width="100%" style="text-align: left;"
 
|-
 
| bgcolor="#cccccc" |'''Power up via USB OTG connector'''
 
|-
 
|'''Connect IGEP COM PROTON to a computer via USB OTG'''
 
|-
 
|}
 
 
 
The on-board '''HS USB OTG port''' is used as the default '''power input for IGEP COM PROTON standalone''' operating mode.
 
 
 
First of all, connect IGEP COM PROTON to your machine via the on-board USB OTG port with '''a USB cable''' (USB A type plug to mini B type plug).
 
 
 
Connect IGEP COM PROTON to your machine. It will power up.
 
 
 
 
 
=== Connect to IGEP COM PROTON via USB OTG connector ===
 
----
 
  
{| cellspacing="0" cellpadding="5" border="1" align="center" width="100%" style="text-align: left;"
+
This is the 1/3 chapter of the Getting Started with IGEP COM PROTON Tutorial Guide.
|-
 
| bgcolor="#cccccc" |'''Overview'''
 
|-
 
| 1) '''Install a SSH client such PuTTy'''
 
  
2) '''Connect via USB Ethernet Gadget/RNDIS driver''', SSH: root@192.168.7.2
+
In this first chapter, we will learn how to connect and log into.
|}
 
  
You can log into IGEP COM PROTON via many '''interfaces with network connectivity''', such usb-ethernet gadget.. and many others (when connected to an IGEP Expansion Board).
+
Upon completion, you will be ready to continue with chapter 2/3 that explains more advanced tasks.
  
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.  
+
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]]
  
IGEP COM PROTON uses this functionality to allow users to log via SSH.
 
  
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 IGEP COM PROTON. 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).
+
__TOC__
  
Therefore, you will be able to access IGEP COM PROTON  from your client device (for example, a PC with Linux, Windows, etc.)
 
  
 +
= Requirements =
  
The pre-installed software in IGEP0030 configures the USB interface with a static IP: 192.168.7.2
+
In this tutorial we are going to use the following peripherals:
''Note: You will be able to change it later''
 
  
Now, pick the right section, depending on the Operating System you are using:
+
* IGEP COM PROTON
 +
* USB Standard-A to Mini-B type cable
 +
* Powered USB HUB 2.0
 +
* A PC
  
 +
= Getting started =
  
==== Linux Configuration ====
+
== Power up ==
  
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.  
+
The board can be powered though USB OTG connector. It's recommended use an external USB hub. Connect the USB Standard-A to Mini-B type cable between the board and the USB hub.
  
*'''Ubuntu 10.04 LTS Lucid Lynx'''
+
[[Image:IGEP_COM_PROTON_with_HUB.JPG|center|200px]]
  
In the file /etc/network/interfaces, you should add a section which looks like this:
+
== Booting ==
  
auto usb0
+
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 softwre version.
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
+
"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 ==
  
==== Windows configuration ====
+
{{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 session and connect to the boad using the SSH protocol,
  
*'''Windows 7'''
+
$ ssh root@192.168.7.1
  
Follow this tutorial: http://robosavvy.com/forum/viewtopic.php?p=28788
+
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]]
  
*'''Windows XP'''
+
{{Navigation/IGEP Technology Guides/Getting Started/Ending
 
 
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 (IGEP COM PROTON) 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 IGEP COM PROTON console from your PC via USB Ethernet gadget.
 
 
 
{{Navigation/IGEP Technology Devices Guides/Next Step
 
|Name={{#lst:Template:Links|IGEP_COM_PROTON_Name}}
 
|Community_MainPage={{#lst:Template:Links|IGEP_COM_PROTON_Community_MainPage}}
 
 
|Next_Step={{#lst:Template:Links|IGEP_COM_PROTON_Community_Guides_2}}
 
|Next_Step={{#lst:Template:Links|IGEP_COM_PROTON_Community_Guides_2}}
 
}}
 
}}
  
 
[[Category:IGEP Technology Devices Guides]]
 
[[Category:IGEP Technology Devices Guides]]
[[Category:Work in progress]]
 

Latest revision as of 10:00, 18 October 2013


Overview

This is the 1/3 chapter of the Getting Started with IGEP COM PROTON Tutorial Guide.

In this first chapter, we will learn how to 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 PROTON
  • USB Standard-A to Mini-B type cable
  • Powered USB HUB 2.0
  • A PC

Getting started

Power up

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

IGEP COM PROTON with HUB.JPG

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 softwre 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 boad 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