View source for XO 4 B1

{{OLPC}}
{{TOCright}}
[[XO-4|XO-4 Touch Laptop]] Beta test model, also known as B-test or B1.

== Description ==

The B1 was the first complete prototype of the [[XO-4_Touch|XO-4 Touch]].  The B1 bring up happened in the middle of September, 2012.   XO-4 B1 units all have prototype multi-touch touchscreens using touchscreen technology from [http://www.neonode.com/ Neonode].

== Identification ==

* Seven bumps (arranged in two rows) on the Hinge Cover, identical to the XO-1.75[[Image:XO-1.75_Hinge_Cover.jpg|thumb|right|XO-4 B1 Hinge Cover]].  This [[Media:XO-4_Hinge_Cover.jpg|will change]] for production. [[Image:XO-4_Hinge_Cover.jpg|thumb|right|Production XO-4 Hinge Cover]]
* The display has a bezel which doesn't have any texture (it is slick), and it is 1mm deeper than earlier XO laptops.
* The touchscreen light guide is clear.   In production units, this will be tinted and appear deep purple/black.
* Rev. C motherboard

B1 laptops were produced with a variety of keyboards.   They are identified in the battery compartment as [[Manufacturing_data#XO-4|SKUs 291, 292, 293, or 294]].

Photographs:

[[Image:XO4_A2_mobo_annotated_bot.png|600px|center]]

''Actually an A2 motherboard.  Changes are minor, however.  To be updated soon''

== Software Support ==
[[Image:XO_4_Block_Diagram.png|thumb|right|XO-4 Block Diagram]]
*The current Linux image is one of the F18 builds  (13.1.0, the target OS for production).   Look for it at [http://build.laptop.org/13.1.0/os8/xo-4/ http://build.laptop.org/13.1.0/os8/xo-4/], for example.

*The current [[Open Firmware]] release is [http://dev.laptop.org/pub/firmware/q7b04/ Q7B04].
**The Q7Bxx series of Open Firmware cannot be used with [[XO_4_A2|XO-4 A2]] motherboards.   Starting with XO-4 B1, the size of OFW is 2MBytes.
**This will not work on an XO-1, XO-1.5, or XO-1.75.  As with XO-1.75, Open Firmware and the EC firmware are separate --- Open Firmware contains a recent version of the EC firmware and will automatically update an older version given two sources of power, but a more recent version may actually be programmed into the EC.

*The current EC Firmware release is [http://dev.laptop.org/pub/ec/cl4-7_0_2_05.img 7.0.2.05].

'''It is strongly recommended that you have two sources of power (a charged battery and an external power source) when you upgrade your EC or Open Firmware.'''   Failure to do so may require the use of an SPI programmer to recover your laptop.

===Upgrading the EC code===

====Using Open Firmware and WiFi====
*requires Q7B01 or later

 ok wifi name
 ok flash-ec http:\\dev.laptop.org\pub\ec\cl4-7_0_2_01.img
 Reading http:\\dev.laptop.org\pub\ec\cl4-7_0_2_01.img
 Scan for: name found
 Associate with: name 
 DHCP got 10.0.0.170 
 EC firmware verison: XO-EC 7 0.2.01
 Erasing ...
 
 Writing ...
 fff0 
 Verifying ...
 fff0

Board powers down at this point due to EC restart.  Power up manually.

====Using Open Firmware====
*requires Q7B01 or later

Place the EC firmware on a USB key and type:

 ok flash-ec u:firmware-name
 EC firmware verison: XO-EC 7 0.2.01
 Erasing ...
 
 Writing ...
 fff0 
 Verifying ...
 fff0

Board powers down at this point due to EC restart.  Power up manually.

===Upgrading OFW===

====Using a USB Stick====
Place a recent release of the Q7XYY firmware onto a USB stick, and place it in one of the laptops USB ports.  Provide external power to the laptop.

Interrupt the OFW boot process by pressing the ESC key.

Type (assuming a q7b02 release):
  flash u:\q7b02.rom

Reboot by holding down the power button once this is completed.

====Using an SD Card====
Place a recent release of the Q7XYY firmware onto an SD device, and place it in the external SD slot.  Provide external power to the laptop.

Interrupt the OFW boot process by pressing the ESC key.

Type (assuming a q7b02 release):
  flash ext:\q7b02.rom

Reboot by holding down the power button once this is completed.

See [[SPI_FLASH_Recovery_for_XO-4_Using_JTAG|SPI Flash Recovery using JTAG]] if necessary.

===Upgrading Linux===

====Installing from Open Firmware====
You will need the .zd version of the OS image.  Download it, then:
# Place the image on a USB stick, and insert it into the XO-4 laptop's external SD slot.
# Get the [[Ok]] prompt,
# Install onto the internal SD card, type:
 fs-update u:os1.zd

====Installing from Linux using an XO-1.75====
To install on an XO-1.75, boot an XO-1.75 to Linux, insert the SD card in the XO-1.75 external slot, then:
 zcat os1.img.gz > /dev/mmcblk1
... and then power down, remove the SD card, and insert in the XO-4.

====Installing from Open Firmware using an XO-1.75====
You will need the .zd version of the OS image.  Download it, then:
# Place the image on a USB stick, and insert it into the XO-1.75 laptop's USB port.
# Get the [[Ok]] prompt,

To install an image onto the external SD card, you need to type:
 
 devalias fsdisk ext:0
 fs-update u:\os1.zd

... and then power down, remove the SD card, and insert it in the XO-4.

===Setting the Date===
The simplest way to set the date after replacing/changing the RTC battery is boot into [[Open Firmware]] and type:

 wifi <your_essid>
 ntp-set-clock

== Restrictions ==

There is a [[XO4_B1_ECOs|list of recommended modifications (ECOs)]].

We recommend that B1 motherboards use a heat spreader.

===Known Tooling Problems===
These are some of the known tooling problems, all of which will be fixed:
* The power button, and the game buttons above it are not properly heat-staked, causing both problems with assembly and also a misalignment once assembled.
* The bezel doesn't have its final texture
* The hinge cover doesn't have it's final ID

===Disassembly===
When disassembling the XO-4 B1, please be careful with the flex cable connecting the touchscreen to the motherboard.  In particular, the connector used to connect the flex cable to the IR PCB on the bezel is relatively fragile.   Instead of disconnecting the flex cable from the IR PCB, we recommend laying the bezel/touchscreen assembly on the keyboard, removing the display, then disconnecting the flex cable from the motherboard.   This will be improved in the C1 version.

When reassembling the laptop, please be aware that proper operation of the touchscreen requires that it be flat.   Don't expect it to work well if the bezel isn't properly attached to the laptop using the four screws underneath the bezel.

====Display Screws====
The display is attached to the mainframe using screws which are shorter than the ones used on previous XOs.   '''If you use one of the "normal" length, you will damage the motherboard.'''   This is being fixed.

===Speakers===
We are looking at several problems with the speakers:

====Connectors====
Be very careful with the speaker connectors, it is easy to pull the wires out of the plastic shell.  This is being studied.

====Rattles====
The speakers are not properly attached, and are prone to rattle, especially after shipping.   If yours rattles, we recommend using a heavy duty epoxy to glue it down.  This will be fixed.

===White Screen at Boot===
After shipping from the factory, the laptop will refuse to boot.  This presents a white screen to the user, followed eventually by the "alien invasion screen" showing the number 52.  Simply reboot the laptop and it should never happen again.   This was tracked as <trac>12135</trac>, and has been fixed in versions of [[Open Firmware|OFW]] later than Q7B02.

===Second serial port===
As with XO-1.75, there is a second serial port provided for deep debugging of kernel issues.   Unlike XO-1.75, this serial port is not populated by default.   If you need to use this serial port, you will have to populate CN23, and make sure that Q38, Q44, R408, R373, and R98 are also populated.    Like the main serial port, this one operates at +3.3V (using a voltage translator on the motherboard, as the actual SoC pins only tolerate +1.8V).

== Documentation ==

Supporting documentation for these laptops (all in PDF):
* [[Media:XO_4_Pinouts.pdf|Pinouts]]
* [[Media:XO_4_Power_Distribution.png|Power Distribution]] ( [[Media:XO_4_Power_Distribution.pdf|PDF]] )
* [[XO_4_Tinderbox_Power|Power Measurements (Tinderbox)]]
* [[Media:XO_4_Connectors_A2.pdf|Connector Locations]]
* [[Media:XO_4_GPIOs.pdf|GPIO Mappings]]
* [[Media:XO_4_EC_Pinout_v2.pdf|EC Pinout]]

'''Please note that production boards might have different pin mappings and connector locations.'''

See also:
* [[XO_4_Parts|XO-4 Parts]] -- what SKU has what memory and eMMC chip
* [[XO_4_Touch_Testing|XO-4 Touchscreen Testing]]
* [[XO_4_Memory_Test|XO-4 Memory Testing]] -- from CForth
* [[XO 4 HDMI Debug]]
* [[XO_1.75_JTAG|XO-1.75 JTAG]] -- XO-1.75 used the same JTAG connector
* [[SPI FLASH Recovery for XO-4 Using CForth]]
* [[SPI FLASH Recovery for XO-4 Using JTAG]]
* [[Debugging Open Firmware Startup]]

== Followed by ==

* [[XO_4_C1|C1]]

== Preceded by ==

* [[XO_4_A2|A2]]

== Changes ==

* [[XO4_A2_B1_Changes|XO-4 A2 B1 Changes]]
* [[XO4_B1_ECOs|XO-4 B1 ECOs]]
* [[XO4_B1_C1_Changes|XO-4 B1 C1 Changes]]

[[Category:Hardware]]
[[Category:XO-4]]