= Proposal for new getting started "What can I do with IGEP0020 board " =
__NOTOC__ __TOC__
{| width="200" cellspacing="0" cellpadding="4" border="1" align="right"
|-
|}
If you have '''successfully completed the [[Getting Started with IGEP0020 board|getting started guide]]''' for IGEP0020, you can follow this first introduction about what can you do with this board:
[[Image:Igep0020.jpg|462x309px|link=Category:IGEP0020]]
=== Overview ===
----
This page is a starting point for all products of the IGEP0020 family such IGEPv2 Board.
This guide is divided in three different chapters:=== Booting and setting up ===
* '''Getting started''': A basic tutorial about how to connect and boot your IGEP0020* '''What can I do?''': An extensive article to setup In the main peripherals previous chapter of this tutorial, we have booted IGEP0020* '''Start developing''': Once you have successfully followed the previous tutorials, you are ready to start developing with IGEP Technology. Here you will find some basic tips tricks about how to start with itits pre-installed software.
At Once the right corner of this pages you will find board has booted up, it asks for a navigation box with this linkslogin in the serial debug port. You can log in into IGEP0020 via the serial interface.
*The default login user is: '''root'''
*There is '''no password''' for this user.
=== Getting started ===
----
This getting started guide describes '''how to boot IGEP020''' and also gives some '''basic instructions''' about how to connect some peripherals.
In fact, IGEP0020 can boot from many other devices (listed by priority):
For further information about this board, there exist other sections where you can find specific and extended contents, in-depth description, valuables web links, etc.# from USB# from UART3# from a MMC/MicroSD card # from OneNAND memory
If that is your case, visit the '''[[:Category:IGEP0020|main page of IGEP0020]]''' or check the categories at the IGEP Community Wiki.
As we haven't set any other device (instead of the oneNAND or flash memory) the system boots from it.
=== Preinstalled software ===
----
By default, '''all brand new IGEP Processor Boards have a firmware installed''' on its flash memory.
That means that But, as the MicroSD card has an upper priority than the flash, if you power up your board plug a MicroSD card (with the right configuration on it ) to the MicroSD card reader, IGEP0020 will run a Linux distribution provided boot from it and installed by ISEEwon't boot from the flash memory.
This distribution consists on a '''minimal Linux-based distribution''' with a lite X Window System and GNOME Mobile based applications created with '''Poky Platform Builder'''.
Now, We are going to use this functionality to update your pre-installed software.
'''Linux distributions'''
In this tutorial, we are going to use the === Updating your pre-installed software in your IGEP0020, that is the Poky Linux. But if you wish, you can always update with a new or a different distribution.===
We are now going to introduce update the main components of pre-installed software to the preinstalled software of your IGEP0020:latest version.
* Bootloaders: * Kernel: * Root File System: * Kernel ModulesFor this purpose, you will need:
* a microSD card
* a computer with microSD card reader (or with adapter)
* a GNU/Linux distribution installed on the computer (a Linux partition or a virtual machine on Windows)
** the main reason is that Windows does not detect multiple partitions on a microSD card
If you are familiar with On your Linux Kernel and distributionshost PC, you can check out the '''[[:Category:Software distributions|Software distributions]]''' category at the IGEP Community Wiki to get many other distributions for your IGEP0020should open a Terminal.
The first thing you'll do is download latest firwmare from ISEE:
=== Setting up === wget http://downloads.igep.es/binaries/firmware/poky-firmware-3.3.1--First of all, you can begin to '''add peripherals'''10.tar.gz
In this tutorial we are going to learn how Next, untar the firmware and enter to connect and the main usage of:directory
* the serial cable tar xzf poky-firmware-3.3.1-10.tar.gz* a monitor* a USB keyboard and a mouse* a network cable cd poky-firmware-3.3.1-10/
Do NOT power up Insert your board yet.SD card into the host machine (the machine you downloaded the firmware), and run following command
./poky-media-create --mmc [device] --binary poky-image-sato-igep00x0-[timestamp].tar.gz --machine [machine]
'''Monitor'''where:* [device] is the SD card device name, for example: /dev/sdb* [machine] is the machine name, options are** igep0020** igep0030** igep0032
IGEP0020 has a '''DVI-D interface''' where you can connect a '''HDMI connector to a monitor'''Finally plug the SD card into IGEP device and power up your board.
The Digital Visual Interface (DVI) is a video standard interface designed = How 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 flash the High-Definition Multimedia Interface (HDMI) standard in digital mode (DVI-D), and VGA in analog mode (DVI-A).latest software image =
You will need Now you have a cable booted board with '''male DVI-D connector''' for latest firmware running from SD card, you can write the monitor, and '''male HDMI connector''' from IGEP0020firmware to the flash memory.
Note that your monitor should be able Enter to support 1024 x 768 @ 60 Hzthe IGEP device using root as login name and an empty password, which is enter to the default resolution in /opt/firmware an run the preinstalled software./flash script
cd /opt/firmware
./flash.sh
'''Serial'''When finish, unplug the SD card and reboot the board, enjoy the new firmware running from flash memory.
In the preinstalled software, the serial port is configured as a '''Debug interfaceOther references'''. That means that if you connect an external device to the serial port you will be able to see the : [[Update_the_PRE-INSTALLED_software_image_to_a_current_release|'''Linux Kernel tracesupdate your pre-installed software image''', as the system boots.]]
Furthermore, you will be able to access IGEP0020 with a '''serial client console''' in your host device (for example, a PC with Linux, Windows, etc.)
In this tutorial, we are going to test this feature by connecting an '''AT/Everex Cable''' to the '''10-pin serial header''' on IGEP0020 and a '''[http://en.wikipedia.org/wiki/Null_modem null modem] DB9 male-male''' serial cable between the board and your host machine
----
[[Image:DSC 0177.JPG|thumb|550px|right|*'''SerialConsole''': AT/Everex Cable connected to the 10-pin serial header on IGEP0020. '''Network''': Ethernet cable]] To communicate with IGEP0020 via Serial port you have to connect your host machine to the [[Using serial debug port in your IGEP0020. 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. * If you don't know how to set up your serial cable, refer to the following article: '''[[How_to_setup_the_IDC10_cablecommunicate|How to setup the IDC10 cablehere]]'''. Also, if you do not have Serial port in is an explanation about how to correctly configure your host machine you might need a USB to Serial converter to communicate via this port.Console<br> * If you are not familiar with a serial console, refer to this page, an extended article about '''SSH''': [[Using serial debug port SSH to communicate|here]]'''.is an explanation about how to login via Ethernet or USB
'''Audio IN/OUT'''
External Audio input devices, such as a powered microphone or the audio output of a PC or MP3 player, can be connected = How to handle the via a 3.5mm jack (Audio IN).gpio-LED's<br> =
An external Audio output device, such as external stereo powered speakersThis is probably the most simple feature in the board, can but sometimes LED's may be connected to the BASE0010 via a 3.5mm jack (Audio OUT)only way of checking the status of some of your applications.
IGEP0020 has 4 LED's which you can control, for example, using 'echo'. Here is an example of turning LED's On:
<pre>echo 1 > /sys/devices/platform/leds-gpio/leds/d240\:green/brightness
echo 1 > /sys/devices/platform/leds-gpio/leds/d240\:red/brightness
echo 1 > /sys/devices/platform/leds-gpio/leds/d440\:green/brightness
echo 1 > /sys/devices/platform/leds-gpio/leds/d440\:red/brightness
</pre>
You can turn them down using the same command and write '0' instead of '1'.
'''Keyboard/Mouse'''If you want to trigger the leds you can enable this mode and select the trigger source (none by default) to: mmc0, mmc1, timer, heartbeat and default-on.<br>
In IGEP0020 To enable any of this modes you might need just have to change a powered hub to connect parameter in the directory of the led you want to most USBcontrol.You can see all the possibilities using 'cat':<br> <pre>$ cat /sys/devices/platform/leds-gpio/leds/d240\:green/trigger
Connect [none] mmc0 mmc1 timer heartbeat default-on</pre> In the USB hub to example above, we have checked the status of the USB host connector trigger in your IGEP0020, and then plug your keyboard and mouse into the USB hubled D240:green. Mode 'none' is selected.
Only USB 2.0 To change it, for example, to the timer mode you can use 'echo':<br> <pre>echo timer > /sys/devices will work in IGEP0020/platform/leds-gpio/leds/d240\:green/trigger</pre> In this case, so if connect any USB mouse 1we have set the trigger to the 'timer' mode.0 into Now you can set the time for what the led is ON and the USB host connector without time it is OFF using :<br> <pre>echo 250 > /sys/devices/platform/leds-gpio/leds/d240\:green/delay_onecho 750 > /sys/devices/platform/leds-gpio/leds/d240\:green/delay_off</pre> Now the selected led is configured with a USB hub 2.0, it will not worktimer consisting of 250 miliseconds ON and 750 miliseconds OFF.
= How to use RS-485 =
'''Network'''Follow the link to the extensive article: [[How_to_use_RS485_on_IGEP0020_board|How to use RS-485 on IGEP0020 board]]
IGEP0020 comes with one 10/100BASE-TX Ethernet ports. Plug an Ethernet cable between IGEP0020 and your host machine = How to get sound out (or any other network device with ethernet connectivityaudio out). =
In this tutorialThe amplifiers for the headset output are disabled by default, we will use ethernet to access IGEP0020 so the first thing you'll do is enable these amplifiers with IP configuration, send files, etc.
amixer set -D hw:0 'Headset' 0dB
amixer set -D hw:0 'HeadsetL Mixer AudioL2' on
amixer set -D hw:0 'HeadsetR Mixer AudioR2' on
=== Power up ===----Then you can easily play a wav sound, for example
Once you have connected the peripherals '''you can apply power''' to your IGEP0020 (5V DCC) aplay sample.wav
* '''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. = How to get sound in (read the next chapter of this tutorialaudio in) =
* '''LED's''': You will also see a few LED's flash can record audio in IGEP0020 during the system boot(the sequence will be different based on software version).with
* '''Monitor''': Finally, if you connected the DVI arecord -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 connectedt wav -c 2 -r 44100 -f S16_LE -v audio-in.wav
* '''USB devices''': You will be able to use your keyboard and mouse and 'play' with 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" />Following output is expected on console
Now, you have Recording WAVE 'audio-in.wav' : Signed 16 bit Little Endian, Rate 44100 Hz, Stereo Plug PCM: Hardware PCM card 0 'successfully completed the first chapter''TWL4030' of this getting started guide!device 0 subdevice 0 Its setup is: stream : CAPTURE access : RW_INTERLEAVED format : S16_LE subformat : STD channels : 2 rate : 44100 exact rate : 44100 (44100/1) msbits : 16 buffer_size : 32768 period_size : 2048 period_time : 46439 tick_time : 7812 tstamp_mode : NONE period_step : 1 sleep_min : 0 avail_min : 2048 xfer_align : 2048 start_threshold : 1 stop_threshold : 32768 silence_threshold: 0 silence_size : 0 boundary : 1073741824
When ever you think you want to stop just press CONTRL+C
=== The next step is: [[What can I do with IGEP0020]] ===
=== See also ==Developing under IGEP Technology =
* Visit the following link and '''start [[:Category:IGEP0020Start developing under IGEP Technology|IGEP0020developing under IGEP Technology]]: Main page of IGEP0020 with links to official documentation'''
[[Category:IGEP0020]]
[[Category:Tutorials]]