Nandblaster for XO-1.5

From OLPC
Revision as of 19:07, 4 August 2010 by Quozl (talk | contribs) (nb-update is not yet in q3a49 but is in svn)
Jump to: navigation, search

Quick Start

XO-1.5

How to install to multiple XO-1.5 using NANDblaster:

  • ensure receiving XO-1.5 have firmware q3a45 or later,
  • ensure transmitter XO-1.5 has firmware q3a50 or later,
  • copy the os*.zd file to /fs.zd on a USB stick
  • select one XO-1.5 to be the transmitter, (there is no change to what is installed on it),
  • insert the USB stick in the transmitter laptop,
  • power up to the Ok prompt,
  • type nb-update and press enter,
  • wait for nb-update to get going, when it says "pass 1" and counts up the blocks it is ready - it usually takes about 15 seconds,
  • power up the receiving laptops using the four game keys down sequence,
  • if a receiving laptop does not start, try again,
  • wait for each laptop to finish and turn off (or reboot?),
  • when all have finished, type ESC on the transmitter laptop, then power it off and remove the USB stick.

NANDblasting an Unsigned Filesystem Image File

To send an unsigned filesystem image, put the filesystem image file (*.zd) on a USB key as "/fs.zd". Insert the USB key into the sending XO and type:

 ok nb-update

NANDblasting a Signed Filesystem Image File

To send a signed filesystem image, put the filesystem image file (*.zd) on a USB key as "/fs.zd". Put the corresponding signature bundle (the .zip that contains a control file and a signature file) on the USB key as "/fs.zip". Insert the USB key into the sending XO and type:

 ok nb-secure

Stopping

You can stop the sender by typing the ESC key or by powering off. If you type any other key, the sender will pause and ask you if you want to stop. If you then type 'y', it will stop; other keys will resume the sending.

"No quiet channels" - Forcing the Channel

The sender chooses a wireless channel automatically by scanning to find the least-busy channel. If they are all busy, i.e. they all have received signal strength values exceeding some threshold, the sender tell you which one has the least signal strength and ask for confirmation before proceeding on that channel.

You can force it to use a specific channel by appending either "1", "6", or "11" to one of the commands above, for example:

 ok nb-update6

or

 ok nb-secure11

If you force the channel, the sender won't check if the channel is busy, it will just start sending.

Changing the Redundancy

You can change the redundancy percentage before you execute one of the send commands. For example, to set the sender redundancy to 12% (the default is 20%), type:

 ok d# 12 to redundancy

The redundancy controls the number of extra error correction packets that the sender sends for each erase block worth of source data.

Design Notes

Nandblaster_for_XO-1.5_Design_Discussion