ReferencePlatforms/Imaging/Nokia N810: Difference between revisions

From MozillaWiki
Jump to navigation Jump to search
No edit summary
 
(19 intermediate revisions by the same user not shown)
Line 1: Line 1:
=N810 Imaging=
==Step 1: Reset Hardware==
We use N810s to do on-device testing of our maemo4 builds of our mobile browser.  In order to deal with maintaining 80 of these devices we have developed an imaging solution. Our initial attempt was to create a custom firmware image but file corruption became an issue. We eventually figured out how to boot these devices from MiniSD cards.  We have special tools for creating and maintaining the filesystems on these cards.
'''NOTE: You should be in the RF Shielded room with the door *CLOSED* to ensure machines connect to correct network'''
 
For each session:
*Ensure USB A end of Nokia MicroUSB cable is in computer
*Remove batteries and backplates from all devices to be imaged
<pre>
cd ~/n810-imaging
sudo ./moz-prep.sh
#Follow onscreen prompts
#once all devices are prepped press CTRL+C to quit moz-prep.sh
</pre>


Our process has the following logical blocks:
==Step 2: Image multiple cards==
*Firmware installation and configuration (RE)
<pre>
*Moving filesystem to SD card (RE)
#Detach all MicroSD card readers from computer
*Creating image on imaging computer (RE)
#Insert MicroSD cards to be imaged into MicroSD card readers
*[[ReferencePlatforms/Imaging/Nokia_N810#Resetting_hardware|Reseting Hardware]] (IT)
#Plug in MicroSD card readers with MicroSD cards into computer
*[[ReferencePlatforms/Imaging/Nokia_N810#Imaging_Cards|Imaging cards]] (IT)
#then run
*[[ReferencePlatforms/Imaging/Nokia_N810#Power_On_Devices|Powering on devices]] (IT)
cd ~/n810-imaging
sudo ./bulk-image.sh
#This will take approx 5-7 minutes per card; computer will beep when all cards are imaged.
# JHFORD will paste sample output here
#Remove all MicroSD card readers
#Remove MicroSD cards from MicroSD card readers
#Final output will tell you how many cards were successful,
#this for your information and is not critical to the imaging process
</pre>


==Step 3: Verify card and power on device==
<pre>
#Run and follow on screen instructions
cd ~/n810-imaging
sudo ./bulk-verify.sh
</pre>


==Step 4: Boot device==
*This step assumes that the MicroSD card has been inserted into the correct device
*Press the power button on the top of the device '''then''' plug the charger into the device (NOTE: order is important).
*Verify the device comes turns on successfully with the blue geometry-themed desktop.
*Verify that the grey Wifi logo in top right of screen turns to solid white
** may take 5 minutes


All RE actions are documented at [[ReferencePlatforms/Test/Maemo]].  If the imaging machine needs to be set up again, the instructions for this action are located at [[ReferencePlatforms/mobile-imaging-linux]]
==Troubleshooting Tips==
IGNORE BELOW HERE UNLESS YOU ARE *REALLY* CURIOUS


The remainder of this document is to give instruction on the IT imaging actions
===N810 Imaging===
We use N810s to do on-device testing of our maemo4 builds of our mobile browser.  In order to deal with maintaining 80 of these devices we have developed an imaging solution.  Our initial attempt was to create a custom firmware image but file corruption became an issue.  We eventually figured out how to boot these devices from MiniSD cards.  We have special tools for creating and maintaining the filesystems on these cards.


=Resetting hardware=
===Resetting hardware===
The purpose of this step is to zero out the root mtd device as well as reflashing the linux kernel and bootloader.  We want to make sure that any possible corruption in these critical subsystems is repaired
The purpose of this step is to zero out the root mtd device as well as reflashing the linux kernel and bootloader.  We want to make sure that any possible corruption in these critical subsystems is repaired


==Instructions==
===Potential issues===
We have a program [http://hg.mozilla.org/build/tools/file/tip/buildfarm/mobile/n810-imaging/moz-prep.sh moz-prep.sh] that automates this process.  To launch this program, run:
$ cd ~/n810-imaging
$ sudo ./moz-prep.sh
There will be lots of extraneous output that is useful in debugging.  There should be a line saying
Suitable USB device not found, waiting
as the last line of output.  This is a sign that you are ready to plug in the next N810 to prep.
 
You will follow the same process for the entirety of the program execution.  The suggested process is:
*remove the battery and backplate for all devices to be imaged
*launch moz-prep.sh as outlined above
*plug microusb cable into computer if not all ready there
*for each device to image:
**plug microusb cable into device
**replace battery and backplate
**plug in charger
***if the power doesn't turn on automatically, press power button
***There should be a blue USB logo in the top right of the screen, a progress bar on the bottom of the screen and a large 'NOKIA' logo in the center of the screen
**Wait until you see something like:
UNPLUG DEVICE
Bus 008 Device 003: ID 0421:0105 Nokia Mobile Phones Nokia Firmware Upgrade Mode
**Unplug usb cable
**Once you see 'Suitable USB device not found, waiting' again, you should plug in the next device
*once all devices are prepped press CTRL+C to quit moz-prep.sh
 
==Potential issues==
If you see
If you see
  ERROR! Lost USB Connection while flashing RX-44_DIABLO_5.2008.43-7_PR_COMBINED_MR0_ARM.bin.  Dead battery?
  ERROR! Lost USB Connection while flashing RX-44_DIABLO_5.2008.43-7_PR_COMBINED_MR0_ARM.bin.  Dead battery?
this is a sign that moz-prep encountered an error.  This is a sign that for some reason, the nokia flashing program lost connection to the device.  This is often caused by trying to flash with a dead battery.  We mitigate this by flashing with the charger connected.  This has also been caused by issues with the linux kernel on the imaging host.  If you encounter this error on multiple devices using different batteries reboot the imaging machine.  If you still have issues, someone has broken the imaging machine.
this is a sign that moz-prep encountered an error.  This is a sign that for some reason, the nokia flashing program lost connection to the device.  This is often caused by trying to flash with a dead battery.  We mitigate this by flashing with the charger connected.  This has also been caused by issues with the linux kernel on the imaging host.  If you encounter this error on multiple devices using different batteries reboot the imaging machine.  If you still have issues, someone has broken the imaging machine.
=Imaging Cards=
This step puts the Maemo operating system filesystem we use onto the Mini/MicroSD card that we boot from.  Each card is imaged with a specific hostname, so it is critical that the card you image is matched to the device you put it in.
==Instructions==
*remove all sd card readers from the imaging machine
*remove all non-essential USB devices
*reboot computer
sudo reboot
*log in and run
cd ~/n810-imaging
*For each card, run
sudo ./moz-image.sh moz-n810-v2 /dev/sdc maemo-n810-23
**the three arguments to this program are:
**moz-n810-v2 -- version of the image, will be included in the request to reimage
**/dev/sdb -- device node for the sd card
***run <code>./bulk-image.sh</code> to find out potential device nodes
**maemo-n810-23 -- host name for the device the card is going in
=Power On Devices=
For each card that has been imaged and matching device prepped:
*insert the MicroSD card into a MiniSD adapter and insert the minisd adapter into the N810. 
*Ensure you are in the RF shielded room. 
*Press the power button on the top of the device '''then''' plug the charger into the device.  Pushing the button before plugging in charger is important because the action that causes boot sets a low level option that determines boot behaviour.
*Verify the device comes up with the blue geometry-themed desktop.
*Verify that the grey Wifi logo turns to solid white
** may take a while

Latest revision as of 21:39, 20 May 2010

Step 1: Reset Hardware

NOTE: You should be in the RF Shielded room with the door *CLOSED* to ensure machines connect to correct network

For each session:

  • Ensure USB A end of Nokia MicroUSB cable is in computer
  • Remove batteries and backplates from all devices to be imaged
cd ~/n810-imaging
sudo ./moz-prep.sh 
#Follow onscreen prompts
#once all devices are prepped press CTRL+C to quit moz-prep.sh

Step 2: Image multiple cards

#Detach all MicroSD card readers from computer 
#Insert MicroSD cards to be imaged into MicroSD card readers
#Plug in MicroSD card readers with MicroSD cards into computer
#then run
cd ~/n810-imaging
sudo ./bulk-image.sh
#This will take approx 5-7 minutes per card; computer will beep when all cards are imaged.
# JHFORD will paste sample output here
#Remove all MicroSD card readers
#Remove MicroSD cards from MicroSD card readers
#Final output will tell you how many cards were successful, 
#this for your information and is not critical to the imaging process

Step 3: Verify card and power on device

#Run and follow on screen instructions
cd ~/n810-imaging
sudo ./bulk-verify.sh

Step 4: Boot device

  • This step assumes that the MicroSD card has been inserted into the correct device
  • Press the power button on the top of the device then plug the charger into the device (NOTE: order is important).
  • Verify the device comes turns on successfully with the blue geometry-themed desktop.
  • Verify that the grey Wifi logo in top right of screen turns to solid white
    • may take 5 minutes

Troubleshooting Tips

IGNORE BELOW HERE UNLESS YOU ARE *REALLY* CURIOUS

N810 Imaging

We use N810s to do on-device testing of our maemo4 builds of our mobile browser. In order to deal with maintaining 80 of these devices we have developed an imaging solution. Our initial attempt was to create a custom firmware image but file corruption became an issue. We eventually figured out how to boot these devices from MiniSD cards. We have special tools for creating and maintaining the filesystems on these cards.

Resetting hardware

The purpose of this step is to zero out the root mtd device as well as reflashing the linux kernel and bootloader. We want to make sure that any possible corruption in these critical subsystems is repaired

Potential issues

If you see 

ERROR! Lost USB Connection while flashing RX-44_DIABLO_5.2008.43-7_PR_COMBINED_MR0_ARM.bin.  Dead battery?

this is a sign that moz-prep encountered an error. This is a sign that for some reason, the nokia flashing program lost connection to the device. This is often caused by trying to flash with a dead battery. We mitigate this by flashing with the charger connected. This has also been caused by issues with the linux kernel on the imaging host. If you encounter this error on multiple devices using different batteries reboot the imaging machine. If you still have issues, someone has broken the imaging machine.

Retrieved from "https://wiki.allizom.org/index.php?title=ReferencePlatforms/Imaging/Nokia_N810&oldid=224660"