Manuals/Neo FreeRunner/eu

From Openmoko

(Difference between revisions)
Jump to: navigation, search
Line 122: Line 122:
 
Izatez, Neo FreeRunnerra berezko [[Distributions| banaketa]] bat barnean ezarrita duela iritsiko zaizu, beraz, hemendik aurrerakorik egin beharrik ez duzu izango. Irakurri [[Om_2008 | OM 2008]] [[Manuals/Om_2008|eskuliburua]] zure telefonoa erabiltzen hasteko. Gerora, zure gailuan [[Distributions|banaketa]] berriagoa edota erabilera zabalagoa duena edota aukera bereziak eskaintzen dituena instalatu nahi zenezake, kasu horretan irakurri ondokoa.
 
Izatez, Neo FreeRunnerra berezko [[Distributions| banaketa]] bat barnean ezarrita duela iritsiko zaizu, beraz, hemendik aurrerakorik egin beharrik ez duzu izango. Irakurri [[Om_2008 | OM 2008]] [[Manuals/Om_2008|eskuliburua]] zure telefonoa erabiltzen hasteko. Gerora, zure gailuan [[Distributions|banaketa]] berriagoa edota erabilera zabalagoa duena edota aukera bereziak eskaintzen dituena instalatu nahi zenezake, kasu horretan irakurri ondokoa.
  
===Installing a bootloader===
+
===Abiarazlea instalatu===
  
The bootloader is needed to start up the operating system on the phone. Qi is the recommended bootloader for the Neo FreeRunner. Installing it will result in faster booting. If you want to have multiple operating systems on your phone you should still stick with U-Boot, which is the older bootloader. You can download a bootloader from http://downloads.openmoko.org/distro/testing/NeoFreerunner/ and install it using the program [[NeoTool]] on your Linux PC. (See http://wiki.openmoko.org/wiki/No_Linux if you do not have Linux on your PC)
+
Telefonoko sistema eragilea abiarazteko beharrezkoa da bootloader edo abiarazlea. '''Qi''' da gomendatutako abiarazlea Neo FreeRunner gailuan. Horrekin, abiatzeko prozesua azkarragoa baita. Hainbat sistema eragileren artean aukeratu ahal izateko, U-Boot abiarazlea mantendu beharko zenuke, hau abiarazle zaharragoa da. Abiarazlea http://downloads.openmoko.org/distro/testing/NeoFreerunner/ helbidetik har dezakezu eta  [[NeoTool]] programaren bidez zure Linux PCan instala dezakezu. (ikusi http://wiki.openmoko.org/wiki/No_Linux ez badaukazu Linuxpean dabilen PCrik, baina hobe zenuke linux banaketa zirraragarriren bat instalatuko bazenio zeure PCari)
  
===Updating the GSM Firmware===
+
===GSM Firmwarea eguneratu===
  
 
The current version of the GSM Firmware is called Moko 11. If you do not have this version installed yet you should do an upgrade, which will fix several issues related to the phone functionality of the FreeRunner.
 
The current version of the GSM Firmware is called Moko 11. If you do not have this version installed yet you should do an upgrade, which will fix several issues related to the phone functionality of the FreeRunner.

Revision as of 21:13, 20 January 2010


Mila esker Neo FreeRunner erosteagatik. Neo FreeRunner telefonoa Openmokorako pentsatutako bigarren hardware plataforma da. Gida honetan hasierako erabilerarako behar duzuna eta tresna berria ezagutzen ikasiko duzu.

Neo FreeRunner Package

Contents

Hardwarearen konfigurazioa, Neo Freerunnerra eta bere osagaiak ezagutzen hasi

Mikro-SD txartelaren, SIM Txartelaren eta bateriaren instalazioa

  • Neo Freerunnerraren atzeko tapa kendu, horretarako, alboetatik heldu telefonoa, eta goian daukan arteka edo zirrikituan azkazalen laguntzaz atzerantz bultza eta atzeko tapa askatuko da.
zirrikituan azkazalez bultza.
Atzeko estalkia askatu!
  • Orain bateria jarri behar den kokagunea agerian dago, eta bere azpian telefoniako txartela eta Mikro SD txartela jartzeko guneak ere ikusiko dituzu.
  • Lehendabizi SIM txartelaren estalkia askatu behar da, horretarako, beherantz (kanpoko USB entxufe alderantz) bultza metalezko klipa. Kontu handiz ibili, zati delikatua baita hau, eta indarrez eginez gero kalteak eragin daitezke. Norantza ere arretaz aztertu.


Jarri SIM eta SD txartelak hemen.
  • Altxa SIM txartela eusteko klipa.
  • Mikro-SD txartelak erabili aurretik begiratu onartzen direla jakina den Mikro-SD txartelen zerrenda.
  • Mikro-SD euskarria bi aldetatik lotuta dago, Errazena alda bakoitza banaka askatzea da. Erditik tiraz bi aldeak batera askatzen saituz gero, loturak indar handiagoa egiten du, beraz, lehendabizi alde bat askatu eta gero bestea. Kontuz labanekin edota bihurkinekin! honako argazkietan ikus daiteke euskarria irekita eta txartelak sartuta.
  • Sartu Mikro-SD txartela bere euskarrian. Kontuan izan euskarrian txartela eusteko kartolatxoak (eusteko topeak) daudela, kartola horien artetik sartu txartela (tente geratuko da txartela, kontaktuak beheko aldean) eta ondoren itxi euskarria txartela etzanda gera dadin. Txartelaren kontaktuak beheko aldean geratu beharko dute, alegia ez dira ikusiko, eta gainera telefonoaren ertzean egongo dira.
  • Mikro-SD txartelaren euskarria etzan ondoren, bi lokailuak ondo itxi dirala ziurtatu. Gaizki itxitako euskarriko txartela ez du ikusiko telefonoak.
  • SIM txartela bere euskarrian sartu, kontu izan honek ere metalezko bi kartolatxo dauzkala, eta horien artean sartu behar dela.Berriz ere kontaktu elektrikoak beheruntz geratu behar dute, eta ebakitako ertza Freerunner gailuaren kanpo aldetik gertu geratu behar du (GPS antenaren aldean).
  • Etzan SIM txartelaren euskarria eta metalezko klipa GPS antenaren aldera labaindu ondo itxita gera dadin.
SIM and SD euskarriak irekita, eta txartelak beren lekuetan
Gailu batzuek itxura hau daukate, tanta modukoa ez da akatsa
  • Sartu bateria horretarako gunean, bateriaren kontaktuak telefonoaren kontaktuekin elkartuz. Lehendabizi kontaktuen aldea sartu.
  • Freerunnerraren atzeko tapa bere tokian jarri.


Tips

Bideotxoa ere ikus dezakezu. Neo gailuaren bertsio zaharrarekin egina den arren, antzeko prozesua da.


Neo FreeRunnerra kargatu

Lehendabiziko erabileraren aurretik Bateria guztiz kargatu behar da. Bateria kargatzeko 1000mA-ko kargatzailea edota 500mA-ko karga eman dezakeen USB portu bat erabil daitezke. Gaur egungo konputagailuek ez daukate inolako arazorik NEO Freerunnera kargatzeko USB portuak erabiliz. Itzalita baldin badago, ez da kargatuko, beraz, piztu eta interfaze grafikoa (GUI edo Graphical User Interface) agertu arte piztu dadila. USB kablea sartzen duzunean (USB kableak konputagailuari konektatuta egon behar du edota 1000mA-ko kargagailuari, alegia, argi indarra eduki behar du) automatikoki piztuko da. Ez bada bere kabuz pizten, eskuz piztu dezakezu, horretarako, pizteko botoia sakatu (bost edo sei segundo sakatuta eduki). Botoi hau USB entxufearen azpian dago.

Nahiz eta kargagailuak 2A-ko indarra emateko gaitasuna eduki, Neo Freerunnerraren karga-abiadura 1A-koa da, eta beraz, kargatze-abiadura kargagailuaren gaitasuna baino txikiagoa da.

Entxufeak hiru mota onartzen ditu: berez Ipar Ameriketako entxufea da, baina estalkia kendu eta Europako edota Erresuma Batuko entxufeetarako egokigailua jar daitezke entxufean. Horretarako, entxufearen estalkiaren kisketa sakatu eta estalkia kanporantz labaindu behar da. Kisketa entxufearen estalkiaren testua dagoen kontrako aldean dago. Kontuan izan Ipar Amerikako entxufearen bi konektoreak ez direla askatuko, horien gainetik sartu behar da egokigailua. Egokigailua ere antzera kentzen da.

Bateria kargatzeko denbora sarrerako indarraren araberakoa da, 100mA-ko indarraz 12~15 ordu behar dira (gailua eteteko egoeran dagoenean indar horrekin kargatzen da) *), sarrerako indarra 500mA-koa bada (PC-en USB konexioa) 2~3 ordu behar dira, eta 1000mA-ko indarrez (kargatzailea) 1.5~3 ordu behar dira. (90%~100%)
*) Gailuak 100 mA baino gehiago behar ditu lanean ari denean, beraz, USB bidezko indarra 100mAkoa baldin bada, eteteko egoeran ez badago, gailua ez da kargatuko.

NOTE: ikusi Neo FreeRunner Hardware arazoak bateria guztiz husten ez lagatzeari buruz.


Botoiak eta konexioak

 
Pizteko botoia, USBa eta kanpoko GPS Antena (ezkerretik eskuinera)
 
AUX Botoia eta aurikularren jack-a (ezkerretik eskuinera)
Pizteko botoia

Ikututxoa edo kolpetxoa emanaz GTA02 gailua etete-egoeran jarriko da.

Sakatuta edukiz gero gailua itzali egingo da.
Aux botoia

Ikututxo bidez edo sakatuz pantaila blokeatuko da.

Aurikularren Jack-a

Aurikularren jack-a 2.5mm dituen konektorea da, eta 4 kontaktu dauzka: stereo + MIC. Motorola smartphone (A780,A1200, ...) eta V-360 gailuek erabiltzen dutenarekin bateragarria da.

Informazio gehiago aurikularren orrian.


Zure gailuaren aldaera zein den jakiteko

Zure gailua zer nolakoa den jakitea komeni zaizu, hau da, gailuaren aldaera (revision) zein den zehaztea komeni da.

Bi hauek garrantzitsuak dira, zure gailuan, fabrikan, zein irudi flasheatu (ezarri) duten jakiten lagunduko baitizute. (c.f. banaketak eta Neo FreeRunner (aka GTA02) aldaerak).

Softwarea instalatu

Freerunnerrean dagoen software ia guztia aldatu edo eguneratu daiteke, bai eta gailua pizteko beharrezkoa den abiarazlea eta GSM txipean dagoen softwarea ere.

Izatez, Neo FreeRunnerra berezko banaketa bat barnean ezarrita duela iritsiko zaizu, beraz, hemendik aurrerakorik egin beharrik ez duzu izango. Irakurri OM 2008 eskuliburua zure telefonoa erabiltzen hasteko. Gerora, zure gailuan banaketa berriagoa edota erabilera zabalagoa duena edota aukera bereziak eskaintzen dituena instalatu nahi zenezake, kasu horretan irakurri ondokoa.

Abiarazlea instalatu

Telefonoko sistema eragilea abiarazteko beharrezkoa da bootloader edo abiarazlea. Qi da gomendatutako abiarazlea Neo FreeRunner gailuan. Horrekin, abiatzeko prozesua azkarragoa baita. Hainbat sistema eragileren artean aukeratu ahal izateko, U-Boot abiarazlea mantendu beharko zenuke, hau abiarazle zaharragoa da. Abiarazlea http://downloads.openmoko.org/distro/testing/NeoFreerunner/ helbidetik har dezakezu eta NeoTool programaren bidez zure Linux PCan instala dezakezu. (ikusi http://wiki.openmoko.org/wiki/No_Linux ez badaukazu Linuxpean dabilen PCrik, baina hobe zenuke linux banaketa zirraragarriren bat instalatuko bazenio zeure PCari)

GSM Firmwarea eguneratu

The current version of the GSM Firmware is called Moko 11. If you do not have this version installed yet you should do an upgrade, which will fix several issues related to the phone functionality of the FreeRunner.


This works by starting the FreeRunner from a system installed on the uSD, which will automatically apply all needed instructions to flash the GSM firmware to the chip. The uSD image will have to be written on a uSD, which will overwrite all its content, so as to make sure it is repartitioned correctly and that it contains the correct bootable system. The procedure has proven to do a reliable job on flashing MOKO11 to GTA02. Chances anything fails are minimal if you _strictly_ follow the instructions. There's no way to do any harm to your device by using this method.

Take special care though about the destination of `dd`, it has to be the *physical* device (e.g. foo0) of your uSD-card, *not* any partition (e.g. foo0p1). Also make sure there are *no* mounted partitions left on the uSD when starting `dd`!
Triple-check you are not accidentally overwriting your system-HD, by e.g using /dev/sda instead of /dev/sdc! Double-check once more! This is the one-typo-kills-system case ;-) You've been warned.

  1. Download and untar http://people.openmoko.org/joerg/calypso_moko_FW/moko11/flash-moko11_uSD-image.tar.gz on your desktop computer. Read the README.tx file that came with the tarball.
  2. Insert a uSD to your computer's reader, and unmount all uSD-partitions that might have been automounted (use mount or df -h to check). Do not use "safely remove" for this.
  3. Use dd to write the image flash-moko11-2.image to the physical(!) uSD-device (this will erase all data from your uSD, including previous partition table and partitions! It will as well erase all data from your computer's HD, in case you accidentally `dd` to this device instead of uSD). Log in as root or use sudo to get root privileges needed to write to the uSD card. For example:
  4. % sudo dd if=flash-moko11-2.image of=/dev/mmcblk0
    
  5. Execute sync or eject <device> to make sure everything is flushed to the uSD before physically removing it from the reader.
  6. Insert the uSD to your FreeRunner, boot from NOR-U-Boot and select the "Boot from microSD" option.
  7. See the boot and flashing process happen, and wait until a green "d_o_n_e" message shows on screen (takes some 6 min). You may can now remove the uSD or login via ssh and use mickeyterm to access the modem and check the firmware version is indeed moko11. Right after flashing, pressing the power button will suspend/resume the Neo, but not shut it down. If you want to do so, you can either remove the battery by hand, or (more gentle way) log in as root into it through the USB cable (root password is blank), and issue:
  8.  # shutdown -h now
    

NOTE

If you don't have a uSD reader on your PC, you can dd from the Neo: install task-base-smbfs, u(n)mount /media/card, mount the directory in which you have the flash-moko11-2.image file and do the dd stuff. This will take about 12 minutes.

You can speed this up by re-gziping just the image file and using the following command to decompress it directly to the flash card:

 % gzip -d < flash-moko11-2.image.gz > /dev/mmcblk0

Using this gzip method, you can actually do the update with an in place image as long as it is shell enabled and has 92M free on the main file system (all but Android and Neovento right now). Just get the 92M gzip file to the phone, use the above line to extract it to the card after unmounting.

Or, maybe in a more simpler manner:

 root@om-gta02 ~ $ umount /media/card
and then from desktop:
 scp flash-moko11-2.image root@192.168.0.202:/dev/mmcblk0

NOTE 2

Whether you have Qi installed or not (see above) as your boot loader, you must power up to the NoR menu (Hold AUX Key, press Power button) and select "Boot from microSD (fat/ext2)" to begin the installation process (per DocScrutinizer in #openmoko). Do not let Qi boot the uSD. Although it still seems to flash OK, the green "d_o_n_e" does not show up, to give you the warm feeling that everything is OK.

You can confirm the firmware version number using the mickeyterm (cmd: "AT+CGMR"). In SHR-Settings, Phone/Modem Information will supply the same number.

Installing a distribution

This section describes how to install a distribution on the internal flash memory of the Neo FreeRunner. If you want to install it on the memory card please refer to the guide provided by the distribution.

For installing a new distribution you will need two files, a root file system (rootfs) image and a kernel image. The root file system image usually ends with ".jffs2", and the kernel image ends with ".uimage.bin". You can get these files from http://wiki.openmoko.org/wiki/Download . Use the program NeoTool to install the distribution on your FreeRunner. The flashing process can take up to 15 minutes for a ~70MB image. It is also wise to make sure that your Neo has enough battery charge prior to flashing.

When flashing succeeds the following will be shown:

status(0) = No error condition is present
Done!
Personal tools


Mila esker Neo FreeRunner erosteagatik. Neo FreeRunner telefonoa Openmokorako pentsatutako bigarren hardware plataforma da. Gida honetan hasierako erabilerarako behar duzuna eta tresna berria ezagutzen ikasiko duzu.

Neo FreeRunner Package

Hardwarearen konfigurazioa, Neo Freerunnerra eta bere osagaiak ezagutzen hasi

Mikro-SD txartelaren, SIM Txartelaren eta bateriaren instalazioa

  • Neo Freerunnerraren atzeko tapa kendu, horretarako, alboetatik heldu telefonoa, eta goian daukan arteka edo zirrikituan azkazalen laguntzaz atzerantz bultza eta atzeko tapa askatuko da.
zirrikituan azkazalez bultza.
Atzeko estalkia askatu!
  • Orain bateria jarri behar den kokagunea agerian dago, eta bere azpian telefoniako txartela eta Mikro SD txartela jartzeko guneak ere ikusiko dituzu.
  • Lehendabizi SIM txartelaren estalkia askatu behar da, horretarako, beherantz (kanpoko USB entxufe alderantz) bultza metalezko klipa. Kontu handiz ibili, zati delikatua baita hau, eta indarrez eginez gero kalteak eragin daitezke. Norantza ere arretaz aztertu.


Jarri SIM eta SD txartelak hemen.
  • Altxa SIM txartela eusteko klipa.
  • Mikro-SD txartelak erabili aurretik begiratu onartzen direla jakina den Mikro-SD txartelen zerrenda.
  • Mikro-SD euskarria bi aldetatik lotuta dago, Errazena alda bakoitza banaka askatzea da. Erditik tiraz bi aldeak batera askatzen saituz gero, loturak indar handiagoa egiten du, beraz, lehendabizi alde bat askatu eta gero bestea. Kontuz labanekin edota bihurkinekin! honako argazkietan ikus daiteke euskarria irekita eta txartelak sartuta.
  • Sartu Mikro-SD txartela bere euskarrian. Kontuan izan euskarrian txartela eusteko kartolatxoak (eusteko topeak) daudela, kartola horien artetik sartu txartela (tente geratuko da txartela, kontaktuak beheko aldean) eta ondoren itxi euskarria txartela etzanda gera dadin. Txartelaren kontaktuak beheko aldean geratu beharko dute, alegia ez dira ikusiko, eta gainera telefonoaren ertzean egongo dira.
  • Mikro-SD txartelaren euskarria etzan ondoren, bi lokailuak ondo itxi dirala ziurtatu. Gaizki itxitako euskarriko txartela ez du ikusiko telefonoak.
  • SIM txartela bere euskarrian sartu, kontu izan honek ere metalezko bi kartolatxo dauzkala, eta horien artean sartu behar dela.Berriz ere kontaktu elektrikoak beheruntz geratu behar dute, eta ebakitako ertza Freerunner gailuaren kanpo aldetik gertu geratu behar du (GPS antenaren aldean).
  • Etzan SIM txartelaren euskarria eta metalezko klipa GPS antenaren aldera labaindu ondo itxita gera dadin.
SIM and SD euskarriak irekita, eta txartelak beren lekuetan
Gailu batzuek itxura hau daukate, tanta modukoa ez da akatsa
  • Sartu bateria horretarako gunean, bateriaren kontaktuak telefonoaren kontaktuekin elkartuz. Lehendabizi kontaktuen aldea sartu.
  • Freerunnerraren atzeko tapa bere tokian jarri.


Tips

Bideotxoa ere ikus dezakezu. Neo gailuaren bertsio zaharrarekin egina den arren, antzeko prozesua da.


Neo FreeRunnerra kargatu

Lehendabiziko erabileraren aurretik Bateria guztiz kargatu behar da. Bateria kargatzeko 1000mA-ko kargatzailea edota 500mA-ko karga eman dezakeen USB portu bat erabil daitezke. Gaur egungo konputagailuek ez daukate inolako arazorik NEO Freerunnera kargatzeko USB portuak erabiliz. Itzalita baldin badago, ez da kargatuko, beraz, piztu eta interfaze grafikoa (GUI edo Graphical User Interface) agertu arte piztu dadila. USB kablea sartzen duzunean (USB kableak konputagailuari konektatuta egon behar du edota 1000mA-ko kargagailuari, alegia, argi indarra eduki behar du) automatikoki piztuko da. Ez bada bere kabuz pizten, eskuz piztu dezakezu, horretarako, pizteko botoia sakatu (bost edo sei segundo sakatuta eduki). Botoi hau USB entxufearen azpian dago.

Nahiz eta kargagailuak 2A-ko indarra emateko gaitasuna eduki, Neo Freerunnerraren karga-abiadura 1A-koa da, eta beraz, kargatze-abiadura kargagailuaren gaitasuna baino txikiagoa da.

Entxufeak hiru mota onartzen ditu: berez Ipar Ameriketako entxufea da, baina estalkia kendu eta Europako edota Erresuma Batuko entxufeetarako egokigailua jar daitezke entxufean. Horretarako, entxufearen estalkiaren kisketa sakatu eta estalkia kanporantz labaindu behar da. Kisketa entxufearen estalkiaren testua dagoen kontrako aldean dago. Kontuan izan Ipar Amerikako entxufearen bi konektoreak ez direla askatuko, horien gainetik sartu behar da egokigailua. Egokigailua ere antzera kentzen da.

Bateria kargatzeko denbora sarrerako indarraren araberakoa da, 100mA-ko indarraz 12~15 ordu behar dira (gailua eteteko egoeran dagoenean indar horrekin kargatzen da) *), sarrerako indarra 500mA-koa bada (PC-en USB konexioa) 2~3 ordu behar dira, eta 1000mA-ko indarrez (kargatzailea) 1.5~3 ordu behar dira. (90%~100%)
*) Gailuak 100 mA baino gehiago behar ditu lanean ari denean, beraz, USB bidezko indarra 100mAkoa baldin bada, eteteko egoeran ez badago, gailua ez da kargatuko.

NOTE: ikusi Neo FreeRunner Hardware arazoak bateria guztiz husten ez lagatzeari buruz.


Botoiak eta konexioak

 
Pizteko botoia, USBa eta kanpoko GPS Antena (ezkerretik eskuinera)
 
AUX Botoia eta aurikularren jack-a (ezkerretik eskuinera)
Pizteko botoia

Ikututxoa edo kolpetxoa emanaz GTA02 gailua etete-egoeran jarriko da.

Sakatuta edukiz gero gailua itzali egingo da.
Aux botoia

Ikututxo bidez edo sakatuz pantaila blokeatuko da.

Aurikularren Jack-a

Aurikularren jack-a 2.5mm dituen konektorea da, eta 4 kontaktu dauzka: stereo + MIC. Motorola smartphone (A780,A1200, ...) eta V-360 gailuek erabiltzen dutenarekin bateragarria da.

Informazio gehiago aurikularren orrian.


Zure gailuaren aldaera zein den jakiteko

Zure gailua zer nolakoa den jakitea komeni zaizu, hau da, gailuaren aldaera (revision) zein den zehaztea komeni da.

Bi hauek garrantzitsuak dira, zure gailuan, fabrikan, zein irudi flasheatu (ezarri) duten jakiten lagunduko baitizute. (c.f. banaketak eta Neo FreeRunner (aka GTA02) aldaerak).

Softwarea instalatu

Freerunnerrean dagoen software ia guztia aldatu edo eguneratu daiteke, bai eta gailua pizteko beharrezkoa den abiarazlea eta GSM txipean dagoen softwarea ere.

Izatez, Neo FreeRunnerra berezko banaketa bat barnean ezarrita duela iritsiko zaizu, beraz, hemendik aurrerakorik egin beharrik ez duzu izango. Irakurri OM 2008 eskuliburua zure telefonoa erabiltzen hasteko. Gerora, zure gailuan banaketa berriagoa edota erabilera zabalagoa duena edota aukera bereziak eskaintzen dituena instalatu nahi zenezake, kasu horretan irakurri ondokoa.

Installing a bootloader

The bootloader is needed to start up the operating system on the phone. Qi is the recommended bootloader for the Neo FreeRunner. Installing it will result in faster booting. If you want to have multiple operating systems on your phone you should still stick with U-Boot, which is the older bootloader. You can download a bootloader from http://downloads.openmoko.org/distro/testing/NeoFreerunner/ and install it using the program NeoTool on your Linux PC. (See http://wiki.openmoko.org/wiki/No_Linux if you do not have Linux on your PC)

Updating the GSM Firmware

The current version of the GSM Firmware is called Moko 11. If you do not have this version installed yet you should do an upgrade, which will fix several issues related to the phone functionality of the FreeRunner.


This works by starting the FreeRunner from a system installed on the uSD, which will automatically apply all needed instructions to flash the GSM firmware to the chip. The uSD image will have to be written on a uSD, which will overwrite all its content, so as to make sure it is repartitioned correctly and that it contains the correct bootable system. The procedure has proven to do a reliable job on flashing MOKO11 to GTA02. Chances anything fails are minimal if you _strictly_ follow the instructions. There's no way to do any harm to your device by using this method.

Take special care though about the destination of `dd`, it has to be the *physical* device (e.g. foo0) of your uSD-card, *not* any partition (e.g. foo0p1). Also make sure there are *no* mounted partitions left on the uSD when starting `dd`!
Triple-check you are not accidentally overwriting your system-HD, by e.g using /dev/sda instead of /dev/sdc! Double-check once more! This is the one-typo-kills-system case ;-) You've been warned.

  1. Download and untar http://people.openmoko.org/joerg/calypso_moko_FW/moko11/flash-moko11_uSD-image.tar.gz on your desktop computer. Read the README.tx file that came with the tarball.
  2. Insert a uSD to your computer's reader, and unmount all uSD-partitions that might have been automounted (use mount or df -h to check). Do not use "safely remove" for this.
  3. Use dd to write the image flash-moko11-2.image to the physical(!) uSD-device (this will erase all data from your uSD, including previous partition table and partitions! It will as well erase all data from your computer's HD, in case you accidentally `dd` to this device instead of uSD). Log in as root or use sudo to get root privileges needed to write to the uSD card. For example:
  4. % sudo dd if=flash-moko11-2.image of=/dev/mmcblk0
    
  5. Execute sync or eject <device> to make sure everything is flushed to the uSD before physically removing it from the reader.
  6. Insert the uSD to your FreeRunner, boot from NOR-U-Boot and select the "Boot from microSD" option.
  7. See the boot and flashing process happen, and wait until a green "d_o_n_e" message shows on screen (takes some 6 min). You may can now remove the uSD or login via ssh and use mickeyterm to access the modem and check the firmware version is indeed moko11. Right after flashing, pressing the power button will suspend/resume the Neo, but not shut it down. If you want to do so, you can either remove the battery by hand, or (more gentle way) log in as root into it through the USB cable (root password is blank), and issue:
  8.  # shutdown -h now
    

NOTE

If you don't have a uSD reader on your PC, you can dd from the Neo: install task-base-smbfs, u(n)mount /media/card, mount the directory in which you have the flash-moko11-2.image file and do the dd stuff. This will take about 12 minutes.

You can speed this up by re-gziping just the image file and using the following command to decompress it directly to the flash card:

 % gzip -d < flash-moko11-2.image.gz > /dev/mmcblk0

Using this gzip method, you can actually do the update with an in place image as long as it is shell enabled and has 92M free on the main file system (all but Android and Neovento right now). Just get the 92M gzip file to the phone, use the above line to extract it to the card after unmounting.

Or, maybe in a more simpler manner:

 root@om-gta02 ~ $ umount /media/card
and then from desktop:
 scp flash-moko11-2.image root@192.168.0.202:/dev/mmcblk0

NOTE 2

Whether you have Qi installed or not (see above) as your boot loader, you must power up to the NoR menu (Hold AUX Key, press Power button) and select "Boot from microSD (fat/ext2)" to begin the installation process (per DocScrutinizer in #openmoko). Do not let Qi boot the uSD. Although it still seems to flash OK, the green "d_o_n_e" does not show up, to give you the warm feeling that everything is OK.

You can confirm the firmware version number using the mickeyterm (cmd: "AT+CGMR"). In SHR-Settings, Phone/Modem Information will supply the same number.

Installing a distribution

This section describes how to install a distribution on the internal flash memory of the Neo FreeRunner. If you want to install it on the memory card please refer to the guide provided by the distribution.

For installing a new distribution you will need two files, a root file system (rootfs) image and a kernel image. The root file system image usually ends with ".jffs2", and the kernel image ends with ".uimage.bin". You can get these files from http://wiki.openmoko.org/wiki/Download . Use the program NeoTool to install the distribution on your FreeRunner. The flashing process can take up to 15 minutes for a ~70MB image. It is also wise to make sure that your Neo has enough battery charge prior to flashing.

When flashing succeeds the following will be shown:

status(0) = No error condition is present
Done!