Manufacturing data: Difference between revisions
(→XO-4) |
|||
Line 461: | Line 461: | ||
===XO-4=== |
===XO-4=== |
||
<table border=1> |
<table border=1> |
||
<tr><th>SKU(s)</th><th>Keyboard Layout</th><th>AK</th><th>WW-WP</th><th>KM</th><th>KL</th><th>KV</th><th>LO</th><th>Model</th><th>Touch ?</th><th>KA Reference†</th><th>LA</th><th>Adapter</th><th>CPU</th><th>FLASH</th><th>RAM</th><th>Battery</th><th>Comment</th><th>Deployment Keys</th></tr> |
<tr><th>SKU(s)</th><th>Keyboard Layout</th><th>AK</th><th>WW-WP</th><th>KM</th><th>KL</th><th>KV</th><th>LO</th><th>Model</th><th>Touch ?</th><th>KA Reference†</th><th>LA</th><th>Adapter</th><th>CPU</th><th>WLAN</th><th>FLASH</th><th>RAM</th><th>Battery</th><th>Comment</th><th>Deployment Keys</th></tr> |
||
<tr><td>291</td><td>[[OLPC_English_Keyboard|English keyboard]]</td><td>yes</td><td>ww</td><td>olpc</td><td>us</td><td>olpc</td><td>en_US.UTF-8</td><td>CL4</td><td>yes</td><td>us</td><td>USA</td><td>US wall</td><td>1 GHz</td><td>4 GB</td><td>1 GB</td><td>LiFePo4</td><td>Developers, other</td><td></td></tr> |
<tr><td>291</td><td>[[OLPC_English_Keyboard|English keyboard]]</td><td>yes</td><td>ww</td><td>olpc</td><td>us</td><td>olpc</td><td>en_US.UTF-8</td><td>CL4</td><td>yes</td><td>us</td><td>USA</td><td>US wall</td><td>1 GHz</td><td>8686</td><td>4 GB</td><td>1 GB</td><td>LiFePo4</td><td>Developers, other</td><td></td></tr> |
||
<tr><td>292</td><td>[[OLPC_English_Non-membrane_Keyboard|English HS KB]]</td><td>yes</td><td>ww</td><td>olpcm</td><td>us</td><td>olpc</td><td>en_US.UTF-8</td><td>CL4A</td><td>yes</td><td>us</td><td>USA</td><td>US Brick</td><td>1 GHz</td><td>8 GB</td><td>1 GB</td><td>LiFePo4</td><td>Developers, others</td><td></td></tr> |
<tr><td>292</td><td>[[OLPC_English_Non-membrane_Keyboard|English HS KB]]</td><td>yes</td><td>ww</td><td>olpcm</td><td>us</td><td>olpc</td><td>en_US.UTF-8</td><td>CL4A</td><td>yes</td><td>us</td><td>USA</td><td>US Brick</td><td>1 GHz</td><td>8686</td><td>8 GB</td><td>1 GB</td><td>LiFePo4</td><td>Developers, others</td><td></td></tr> |
||
<tr><td>293</td><td>[[OLPC_English_Non-membrane_Keyboard|English HS KB]]</td><td>yes</td><td>ww</td><td>olpcm</td><td>us</td><td>olpc</td><td>en_US.UTF-8</td><td>CL4A</td><td>yes</td><td>us</td><td>USA</td><td>US Brick</td><td>1 GHz</td><td>8 GB</td><td>2 GB</td><td>LiFePo4</td><td>Developers, other</td><td></td></tr> |
<tr><td>293</td><td>[[OLPC_English_Non-membrane_Keyboard|English HS KB]]</td><td>yes</td><td>ww</td><td>olpcm</td><td>us</td><td>olpc</td><td>en_US.UTF-8</td><td>CL4A</td><td>yes</td><td>us</td><td>USA</td><td>US Brick</td><td>1 GHz</td><td>8686</td><td>8 GB</td><td>2 GB</td><td>LiFePo4</td><td>Developers, other</td><td></td></tr> |
||
<tr><td>294</td><td>[[OLPC_Argentina_Keyboard|Spanish keyboard]]</td><td>yes</td><td>ww</td><td>olpc</td><td>es</td><td>olpc</td><td>es_UY.UTF-8</td><td>CL4</td><td>yes</td><td>es</td><td>URY</td><td>US wall</td><td>1 GHz</td><td>4 GB</td><td>1 GB</td><td>LiFePo4</td><td>Developers, other</td><td></td></tr> |
<tr><td>294</td><td>[[OLPC_Argentina_Keyboard|Spanish keyboard]]</td><td>yes</td><td>ww</td><td>olpc</td><td>es</td><td>olpc</td><td>es_UY.UTF-8</td><td>CL4</td><td>yes</td><td>es</td><td>URY</td><td>US wall</td><td>1 GHz</td><td>8686</td><td>4 GB</td><td>1 GB</td><td>LiFePo4</td><td>Developers, other</td><td></td></tr> |
||
<tr><td>295</td><td>[[OLPC_English_Keyboard|English keyboard]]</td><td>yes</td><td>ww</td><td>olpc</td><td>us</td><td>olpc</td><td>en_US.UTF-8</td><td>CL4</td><td>yes</td><td>us</td><td>USA</td><td>US wall</td><td>1 GHz</td><td>8 GB</td><td>2 GB</td><td>NiMH</td><td>Developers, other</td><td></td></tr> |
<tr><td>295</td><td>[[OLPC_English_Keyboard|English keyboard]]</td><td>yes</td><td>ww</td><td>olpc</td><td>us</td><td>olpc</td><td>en_US.UTF-8</td><td>CL4</td><td>yes</td><td>us</td><td>USA</td><td>US wall</td><td>1 GHz</td><td>8787</td><td>8 GB</td><td>2 GB</td><td>NiMH</td><td>Developers, other</td><td></td></tr> |
||
<tr><td>296</td><td>[[OLPC_English_Non-membrane_Keyboard|English HS KB]]</td><td>yes</td><td>ww</td><td>olpcm</td><td>us</td><td>olpc</td><td>en_US.UTF-8</td><td>CL4A</td><td>yes</td><td>us</td><td>USA</td><td>US Brick</td><td>1.2 GHz</td><td>8 GB</td><td>2 GB</td><td>NiMH</td><td>Developers, other</td><td></td></tr> |
<tr><td>296</td><td>[[OLPC_English_Non-membrane_Keyboard|English HS KB]]</td><td>yes</td><td>ww</td><td>olpcm</td><td>us</td><td>olpc</td><td>en_US.UTF-8</td><td>CL4A</td><td>yes</td><td>us</td><td>USA</td><td>US Brick</td><td>1.2 GHz</td><td>8 GB</td><td>2 GB</td><td>NiMH</td><td>Developers, other</td><td></td></tr> |
||
<tr><td>297</td><td>[[OLPC_English_Keyboard|English keyboard]]</td><td>yes</td><td>ww</td><td>olpc</td><td>us</td><td>olpc</td><td>en_US.UTF-8</td><td>CL4B</td><td>no</td><td>us</td><td>USA</td><td>US wall</td><td>1.2 GHz</td><td>4 GB</td><td>1 GB</td><td>NiMH</td><td>Developers, other</td><td></td></tr> |
<tr><td>297</td><td>[[OLPC_English_Keyboard|English keyboard]]</td><td>yes</td><td>ww</td><td>olpc</td><td>us</td><td>olpc</td><td>en_US.UTF-8</td><td>CL4B</td><td>no</td><td>us</td><td>USA</td><td>US wall</td><td>1.2 GHz</td><td>8787</td><td>4 GB</td><td>1 GB</td><td>NiMH</td><td>Developers, other</td><td></td></tr> |
||
<tr><td>298</td><td>[[OLPC_English_Non-membrane_Keyboard|English HS KB]]</td><td>yes</td><td>ww</td><td>olpcm</td><td>us</td><td>olpc</td><td>en_US.UTF-8</td><td>CL4C</td><td>no</td><td>us</td><td>USA</td><td>US Brick</td><td>1 GHz</td><td>4 GB</td><td>1 GB</td><td>NiMH</td><td>Developers, other</td><td></td></tr> |
<tr><td>298</td><td>[[OLPC_English_Non-membrane_Keyboard|English HS KB]]</td><td>yes</td><td>ww</td><td>olpcm</td><td>us</td><td>olpc</td><td>en_US.UTF-8</td><td>CL4C</td><td>no</td><td>us</td><td>USA</td><td>US Brick</td><td>1 GHz</td><td>8787</td><td>4 GB</td><td>1 GB</td><td>NiMH</td><td>Developers, other</td><td></td></tr> |
||
<tr><td>299</td><td>[[OLPC_English_Non-membrane_Keyboard|English HS KB]]</td><td>yes</td><td>ww</td><td>olpcm</td><td>us</td><td>olpc</td><td>en_US.UTF-8</td><td>CL4A</td><td>yes</td><td>us</td><td>USA</td><td>US Brick</td><td>1.2 GHz</td><td>8 GB</td><td>2 GB</td><td>LiFePo4</td><td>Developers, other</td><td></td></tr> |
<tr><td>299</td><td>[[OLPC_English_Non-membrane_Keyboard|English HS KB]]</td><td>yes</td><td>ww</td><td>olpcm</td><td>us</td><td>olpc</td><td>en_US.UTF-8</td><td>CL4A</td><td>yes</td><td>us</td><td>USA</td><td>US Brick</td><td>1.2 GHz</td><td>8787</td><td>8 GB</td><td>2 GB</td><td>LiFePo4</td><td>Developers, other</td><td></td></tr> |
||
<tr><td>300</td><td>[[OLPC_English_Keyboard|English keyboard]]</td><td>yes</td><td>ww</td><td>olpc</td><td>us</td><td>olpc</td><td>en_US.UTF-8</td><td>CL4B</td><td>no</td><td>us</td><td>USA</td><td>US Wall</td><td>1 GHz</td><td>8 GB</td><td>1 GB</td><td>LiFePo4</td><td>Charlotte</td><td></td></tr> |
<tr><td>300</td><td>[[OLPC_English_Keyboard|English keyboard]]</td><td>yes</td><td>ww</td><td>olpc</td><td>us</td><td>olpc</td><td>en_US.UTF-8</td><td>CL4B</td><td>no</td><td>us</td><td>USA</td><td>US Wall</td><td>1 GHz</td><td>8787</td><td>8 GB</td><td>1 GB</td><td>LiFePo4</td><td>Charlotte</td><td></td></tr> |
||
<tr><td>301</td><td>[[OLPC_Spanish_Non-membrane_Keyboard|Spanish HS KB]]</td><td>yes</td><td>ww</td><td>olpcm</td><td>es</td><td>olpc</td><td>en_US.UTF-8</td><td>CL4A</td><td>yes</td><td>us</td><td>URY</td><td>US Brick</td><td>1.2 GHz</td><td>8 GB</td><td>2 GB</td><td>LiFePo4</td><td>Latam developers, other</td><td></td></tr> |
<tr><td>301</td><td>[[OLPC_Spanish_Non-membrane_Keyboard|Spanish HS KB]]</td><td>yes</td><td>ww</td><td>olpcm</td><td>es</td><td>olpc</td><td>en_US.UTF-8</td><td>CL4A</td><td>yes</td><td>us</td><td>URY</td><td>US Brick</td><td>1.2 GHz</td><td>8787</td><td>8 GB</td><td>2 GB</td><td>LiFePo4</td><td>Latam developers, other</td><td></td></tr> |
||
Revision as of 19:50, 2 January 2013
This document defines the method for storing manufacturing data on an OLPC laptop, as well as the interaction with the security system.
Manufacturing data is information about a specific OLPC laptop that is known at time of manufacture and stored in the unit's SPI FLASH. It includes basic manufacturing data such as the product model, part number, and motherboard model number; unique identifying information such as the serial number, unique user ID, and WLAN MAC address; and language localization information such as the keyboard version and language locale. There are also flag indicating the anti-theft "status" of the laptop (activated, developer).
Goals
- Security: When an OLPC machine leaves the factory, the SPI FLASH must be write protected, if the customer has requested that anti-theft be enabled.
- Manufacturability: The procedures should be fast, reliable, and convenient within the constraints of the manufacturing flow.
- Extensibility: The data formats should make it easy to revise or extend the manufacturing data set in the future.
- Sanity: The validity of the manufacturing data should be easy to verify.
- Robustness: Programs that read or write manufacturing data should continue to work when the data set is revised.
- Simplicity: The implementation programs should be small and easy to write and verify.
Version History
Version 3.3, 2010-07-08 KM value for mechanical keyboard is now "olpcm"
Version 3.2, 2010-07-06 Corrected olpc2 usage with respect to KV and new mechanical keyboard
Version 3.1, 2010-06-03 Added olpc2 info in KM and KV, for new mechanical keyboard
Version 3.0, 2009-06-18 (lots of other updates have happened) Added SKU 53 and 54 for Nicaragua
Version 2.9, 2007-11-20 us,ng -> ng
Version 2.8, 2007-11-14 Corrected a couple of keyboard table entries - us,ur -> us,pk, and ng -> us,ng
Version 2.7, 2007-11-14 Added SK tag for SKU number
Version 2.6, 2007-10-21 Revised SG tag per input from Quanta
Version 2.5, 2007-10-19 Added SG tag information
Version 2.4, 2007-10-17 Revised SD tag format
Version 2.3, 2007-10-11 Revised KA tag, fixed lengths and example values for other tags to match reality.
Version 2.2, 2007-10-09 Clarified LA and LO values, added dk and ak tags.
Version 2,1, 2007-10-07 add keyboard data
Version 2.0, 2007-05-24 manufacturing data now lives in Sector E, not Sector 0.
Version 1.0, 2006-11-16 added some example data values from Quanta.
Version 0.2, 2006-09-14 added approvals process, added wp/ww to tags list, specified tag registration process
Version 0.1, 2006-09-13
Specification
Location
The manufacturing data shall start at SPI FLASH offset 0xeffff and grow downwards. 2K of space is currently "reserved" for this purpose, although at that time of this writing (2007-05-24, ROM version Q2C14), there is nothing else in that 64K sector, so the 2K limit is not hard and fast.
Historical note: Prior to the C-series firmware, i.e. up to and including Q2B87, the manufacturing data was located at the end of the first 64K sector of the SPI FLASH chip, growing down toward the "EC" code area. The VSA code was above the upper boundary of the manufacturing data.
Rationale
This rationale is obsolete now that the manufacturing data is no longer in the EC sector, but remains here for historical background.
- Placing the manufacturing data near the EC code results in a single boundary below which the data is effectively immutable. This simplifies and increases the reliability of the code for field updates to OFW.
- 64K is the size of an erase sector; the EC code plus the manufacturing data should "never need to be erased".
- The current size of the EC code is approximately 16K, so there should be plenty of space for manufacturing data within that 64K sector.
Data Format
The manufacturing data shall be stored using the following extensible tagged representation:
- Each item shall consist of a tag header plus optional binary data.
- There are two tag formats - a 4-byte format that can have from 0 to 127 bytes of data, and a 5-byte format that can have from 0 to 16383 bytes of data (the practical limit is less because of the overall size limits on the manufacturing data area).
- The 4-byte tag shall consist of:
- Two name bytes, each containing a case-sensitive 7-bit ASCII character
- A length byte whose binary value is from 0 to 127, indicating the number of additional data bytes (not including the 4-byte tag).
- A check byte whose binary value is the one's complement of the length byte
- The 5-byte tag shall consist of:
- Two name bytes, each containing a case-sensitive 7-bit ASCII character
- A check byte whose binary value is from 128 to 255, computed as described below.
- A low length byte (0..127), containing the 7 least significant bits of the data length
- A high length byte (0..127), containing the 7 most significant bits of the data length.
- The data length is given by ((high_length << 7) + low_length). (If the most-significant bit of either low_length or high_length is set, the tag is invalid.)
- The check byte value is calculated as (low_length ^ high_length ^ 0xff). Note that this guarantees that the most-significant bit of the check byte will be 1, thus distinguishing the 5-byte tag from the 4-byte tag format.
- The 4-byte tag shall consist of:
- The list of manufacturing data is the concatenation of individual items.
- The list grows in the "downward" direction, reflecting the fact that the manufacturing data is stored at the end of a region.
- There is no padding for alignment purposes - each tagged item is immediately adjacent to (i.e. just below) its predecessor.
- The end of the list is denoted by the absence of a valid tag "after" (i.e. at the address just below) the last item.
- Within a tagged item, the order of bytes is:
- Highest address: second name character
- Highest address minus 1: first name character
- Highest address minus 2: length byte of 4-byte format (0-127) or check byte of 5-byte format (128-255)
- Highest address minus 3: check byte (~length) of 4-byte format or low length of 5-byte format
- Highest address minus 4: last data byte (if any) of 4-byte format or high length byte of 5-byte format
- Highest address minus 5: next-to-last data byte (if any) of 5-byte format or last data byte (if any) of 5-byte format
- ... (additional data bytes)
- The interpretation of the data bytes within an item varies from name to name; code that operates on such data must know the appropriate data interpretation for the names that it uses. (But see also #Data Value Encoding Conventions .)
Rationale
- The list grows down because it has to start at a known location at the end of an erase sector
- The order of characters within tag names makes it easier to "visually parse" the data when looking at memory dumps, with no adverse effect on program code.
- Note that a valid check byte always has the most-significant bit set, and the other three tag bytes always have that bit clear.
- Erased FLASH storage (all bytes FF) does not constitute a valid tag, nor does all-zero storage.
- Software that inspects specific items of manufacturing data need not understand the details of all tags. It can just skip tags to find the one it's looking for.
- Appending a tag to the end of the list involves skipping to the end of the list and writing the new tag.
- Changing the value of an existing tag is difficult, except for the special case of changing some bits from 1 to 0 (which can be done without erasing the FLASH).
- It is possible to distinguish the 4-byte and 5-byte header formats from either direction. From the direction of the name bytes (going downward in memory), if the next byte is <128, it is the 4-byte format. Conversely, from the direction of the data bytes (going upward in memory), if the next byte is <128, it is the 5-byte format.
- The 5-byte format is not supported by any firmware version <= q2c28, and systems <= C1 do not have any 5-byte tags. It follows that systems that use 5-byte tags must have firmware > q2c29.
Write Protect Behavior
- Prior to starting execution of the main operating system, the bootloader shall control the hardware write protection for the SPI FLASH as follows:
- If the location of the first tag (i.e. the bytes at SPI FLASH offset 0xfffc-0xffff) is erased (i.e. all four byte values are 0xff), the bootloader shall not enable the hardware write protection.
- If the location of the first tag contains a valid tag with the name 'ww' and zero data length (i.e. 'w' at 0xffff, 'w' at 0xfffe, 0x0 at 0xfffd , and 0xff at 0xfffc), the bootloader shall not enable the hardware write protection.
- Otherwise, the bootloader shall enable the hardware write protection.
Rationale
- The "all erased" clause handles the "virgin FLASH" case, for initial manufacturing procedures.
- The "ww" clause enables the possibility of "incremental logging" during the manufacturing flow. The first manufacturing phase that adds an item to the manufacturing data area creates a "ww" tag at the beginning. Subsequent phases can extend the list with other tags as necessary. The final step in the manufacturing flow changes the "ww" to "wp", thus causing the bootloader to enable write protection.
- Note that changing "ww" to "wp" drives three bits from 1 to 0, which can be done without erasing. The only way to return to "ww" (or to 0xff) is to erase the entire sector.
- (Need a link to the document defining the auto-bootloader-update procedure).
Data Value Encoding Conventions
- The following conventions should be observed when defining data formats for new tags:
- Store text strings with the first character at the lowest address, null terminated.
- Store variable length text strings using only the amount of space needed (including the null terminator).
- Consider storing numeric values as human-readable ASCII text when it is reasonable to do so.
- Store multi-byte binary numbers in little-endian form, i.e. with the least-significant byte at the lowest address.
Rationale
- The order of characters within text strings makes it easier to "visually parse" the data when looking at memory dumps, while also being easier (or at least no harder) to operate on with program code.
- Null termination makes it easy to use C library routines.
- There's no need to pad out strings to a predefined maximum length, because the tag encapsulation can tell you the actual length.
- Note that there is no guarantee that multi-byte binary numbers will be naturally-aligned.
Tag Registration
- The most recent version of this document at http://wiki.laptop.org/go/Manufacturing_Data contains the definitive list of tag names and values.
- The method for arbitrating changes to the list is as follows: Someone associated with the OLPC project will be designated as the gatekeeper of the list. The gatekeeper is currently Mitch Bradley, wmb@firmworks.com . Upon request, the gatekeeper will add tags to the list. Such requests should include complete definitions of the proposed new tags and their value encodings.
Rationale
- The assumption is that new tags will be defined infrequently.
Defined Tags
Use '.mfg-data' at the OK prompt to get the tag settings.
(In the tag name DQ, the "first name character" is "D", the "second name character" is "Q")
Tag Name | Data Length (including null) | Req | Meaning | Encoding |
---|---|---|---|---|
ww | 0 | Write Allow | (No Data) Presence at beginning of tag list prevents bootloader from enabling hardware write protect of SPI FLASH. This can be used to allow incremental updates to the tag list during multiple manufacturing phases. See #Write Protect Behavior. Set by disable-security. | |
wp | 0 | Write Protect | (No Data) Change 'ww' to 'wp' to enable hardware write protect. Note that if the first tag is not 'ww', write protect will be enabled, so if the entire tag list is written at once (no incremental tagging), it is not necessary to include the 'wp' tag. Set by enable-security. | |
ak | 0 | o | Activation Key | (No Data) Presence of this field indicates that this system is persistently activated, requiring no temporal lease to run the operating system. Open Firmware uses this as an input to its secure boot algorithm. For certain SKUs, this field might be set at the factory. |
dk | 0 | o | Developer Key | (No Data) Presence of this field indicates that this system is persistently unlocked and can be used without going through the Open Firmware secure boot algorithm. Typically, this flag would not be set at the factory, but would instead be added to the manufacturing data by individuals who have acquired a developer key and wish to unlock the machine permanently. Overrides the wp tag on XO-1 and XO-1.5 only. |
rt | 0 | o | RTC Anti-rollback | (No Data) Presence of this field enables the RTC Anti-rollback feature as described in RTC Anti-rollback |
SN | 12 | Y | Serial Number | Format: AABYWWSSSSS
AA - Area, where SH is QSMC (Shanghai), and CS is CSMC (Changshu) |
SG | 1 | Board Revision | Example: 0xC2. A single binary byte whose hexadecimal representation matches the "letter number" designation of the board revision. The value for an XO-1 B2 machines was 0xB2, for B3 was 0xB3, and for B4 was 0xB4. For XO-1 C1 machines, the value was 0xA9, due to an error of unknown origin. For XO-1 C2 versions (MP), this value was 0xC2. For XO-1.5, 0xD0 indicates A2, 0xD1 indicates B2, 0xD2 indicates B3, 0xD3 indicates C1, and 0xD4 indicates a C2 version (and MP). | |
B# | 15 | Motherboard Number | Example: QTFLCA72400085 | |
U# | 37 | Y | UUID# | Example: DADD886B-C2F7-4B9C-89CB-43B9A81A388C (Random Generate) |
P# | 12 | Y | Part Number | Example: 1CL11ZU0KD9 |
M# | 4 | Product Model Number | Example: CL1C | |
LA | varies | Y | Country Code | Three-letter ISO 3166-1-alpha-3 country code specifying the target country for this system. (See http://en.wikipedia.org/wiki/ISO_3166-1_alpha-3). In prototype systems, the use of this tag was inconsistent, sometimes specifying the target country and sometimes specifying the target country's predominant language. The meaning for future systems is hereby clarified to be the country, not the language. In cases where the same SKU is to be used for multiple countries, this field should contain the name of an arbitrary one of those countries. The detailed use of this field is unspecified, but the OS might, for instance, use it as a "hint" in case other fields are missing (as with prototype systems) or insufficiently specific. |
LO | varies | Y | Product Localization | Default value for the POSIX locale (LANG environment variable). The Linux startup code uses this to configure the language environment. If not present, the Linux startup code will chose a default according to some heuristic. Example value: en_US.UTF-8 |
KA | 111 | Y | Keyboard ASCII map | Specifies the keyboard key numbers for the US ASCII characters on this system's keyboard. This lets Open Firmware automatically adapt to different keyboard layouts. See #Keyboard ASCII Map. |
KM | varies | Y | Keyboard Model | "olpc" for the OLPC rubber membrane keyboard, "olpcm" for the newer OLPC mechanical keyboard; see below |
KL | varies | Y | Keyboard Layout | Layout of the keyboard: "es", "fi", "us,ar", "us,ru"; see table below for settings for OLPC Keyboards |
KV | varies | Y | Keyboard Variant | Keyboard variant for OLPC Keyboards; see below. |
CC | 11 | Configuration Code | Example: 2222XXXXXX | |
F# | 3 | Factory Number | Example: F6 | |
L# | 2 | Line Number | Example: H | |
S# | 11 | SWID # | OS Build that was loaded in the factory. Example: CL1XL00406 | |
T# | 13 | TSWID# | Example: TSIMG_V3.0.2 | |
WM | 18 | Y | Wireless MAC # | Example: 00-17-C4-03-56-8A |
MN | 5 | Model Name | Example: XO-1.5 HS | |
BV | 6 | BIOS Version | Example: Q2C18 | |
TS | 3 | Test Station | Example: DL for DOWNLOAD (SMT/ASSY/DL/RUNIN/FINAL/SHIP/FQA) (See this tip on using this tag to disable pretty boot.) | |
BD | 3 | Boot Device | Example: u:\boot\olpc.fth cifs:\\user:password@10.20.0.2\directory\olpc.fth This is the value of the boot-device list to use in the manufacturing phase indicated by the TS tag. XO-1.5 and later only. | |
MS | 3 | Manufacturing Server | Example: cifs:\\user:password@10.20.0.2\directory\ This is the server to use in the manufacturing phase indicated by the TS tag. | |
SS | 3 | SMT Status | Example: EN (for END), ST (for START) | |
FQ | 3 | FQA | Example: NA (START/END) | |
SD | 7 | SWDL Date | Example: 20071017 (for 17 November 2007) | |
MD | 16 | Manufacturing Date | Example: 20081014T200700Z (for 14 October 2008, 8:07:00 PM UTC) | |
md | 16 | Manufacturing Grace Period | Between manufacturing and distribution, this tag will exist, and after ten days at next boot the tag will be automatically changed to MD. | |
SK | varies | Stock Keeping Unit number | The SKU number, expressed as a decimal number in ASCII, null terminated, without leading zeros. Examples: "1" (length is 2 including null), "13" (length 3 including null), "237" (length 4 including null). | |
AP | 0 | Auto Power | When external power is applied, the laptop will power up if it was on when the power failed. (On XO-1 requires Q2F05 or later.) Note that if the laptop battery is missing, or runs down low enough over time (which will require weeks after a shutdown due to low battery), the "power-on" state will be lost and the laptop will not turn back on when power is reapplied. | |
CP | 0 | Constant Power | When external power is applied, the laptop will power up unconditionally. (On XO-1 requires Q2F05 or later.) | |
TI | varies | Touchscreen Inversion | Used by OFW's EXC7200 touchscreen driver. If the value string contains the letter 'x', the driver will invert the X axis. If the value string contains the letter 'y', the driver will invert the Y axis. Otherwise, or if the tag is not present, the driver will not invert those axes. This is intended for development use, on the small number of XO-3 systems fitted with non-OLPC touchscreens. It is not needed for OLPC touchscreens. |
The "Req" field indicates which tags are required for proper operation of the laptop. The KA tag is required unless the keyboard type is US, in which case OFW will default to the correct key map. The ak and dk flags may be viewed as required, if they were already set!
Keyboards
The scheme selected (using the KM, KL, and KV flags) maps directly to the X Window System Xkb extension.
The AK field is used to designate pre-activated or not activated coming out of the factory. 'Yes' means the AK flag exists in the mfg-data; and the laptop is pre-activated. 'No' means there is no AK flag, and the laptop will have to be activated at the delivery site.
The KM field is the model of the keyboard: For the OLPC rubber membrane keyboard, its value is "olpc". For the OLPC mechanical keyboard, its value is "olpcm". Note that the KM values "olpc" and "olpcm" have different meanings than the KV values "olpc" and "olpc2". KM specifies the physical keyboard hardware, whereas KV indicates different ways that software can interpret a given keyboard.
The KL field specifies the layouts on the keyboard. Keyboards may have multiple layouts, which can be switched between at run time. The names for these layouts generally bear resemblance to ISO country codes, as a given keyboard is often (but not necessarily) in use in particular countries. One or more layouts can be present on a keyboard. If there are multiple layouts, the layout codes are separated by the "," character.
The KV field specifies one or more variant usage plans for a given layout. Example values include strings such as "olpc", "olpc2", "dvorak", "winkeys", "bksl", and comma-separated lists of such base values. It is important to understand that KV does not specify the physical layout, but rather changes the way that the "xkb" X Keyboard Extension software interprets the keys for a given layout. For example, either the "olpc" or "olpc2" variant can be used for the OLPC rubber keyboard. When the "olpc" variant is in use, the multiply and divide keys are treated as multiply and divide. When the "olpc2" variant is in use, those keys are treated as "switch group".
The OLPC mechanical keyboard does not have multiply and divide keys, so there is no effective difference between KV=olpc and KV=olpc2 for that keyboard. The variation only affects key codes that the mechanical keyboard cannot generate. Therefore, including "olpc2" in the KV value list for the mechanical keyboard is pointless, but probably harmless.
The LO field is both language and region specific: The first two letters are the language code; the second two letters are the country code. Note that many langauge/region variants can share a common keyboard, e.g., Russian (ru_RU) and Ukrainian (uk_UA) both use the Cyrillic keyboard, but will need different SKUs to accommodate the different language settings on the laptop.
Keyboard Layout | AK | KM | KL | KV | LO | SKU(s) | KA Reference† | Comment |
---|---|---|---|---|---|---|---|---|
US International keyboard | yes | olpc | us | olpc | en_US.UTF-8 | 1,2,19 27, 33, 34, 39, 44, 45 | us | Developers, other |
US International keyboard | yes | olpc | us | olpc | en_US.UTF-8 | 20,28,21 | us | Alabama, Nigeria (temp), Rwanda (temp) |
Spanish keyboard | no | olpc | es | olpc | es_UY.UTF-8 | 5,6,18,40 | es | Uruguay, Paraguay |
Spanish keyboard | no | olpc | es | olpc | es_MX.UTF-8 | 3,4,17 | es | Mexico/Peru |
Spanish keyboard | yes | olpc | es | olpc | es_UY.UTF-8 | 26 | es | General Spanish laptops |
Portuguese keyboard | yes | olpc | br | olpc | pt_BR.UTF-8 | 10,42 | pt | Brasil |
Amharic keyboard | no | olpc | us,et | olpc2,basic | am_ET.UTF-8 | 11 | us | Ethiopia |
Arabic keyboard | yes | olpc | us,ara | olpc2,olpc | ar_EG.UTF-8 | 7,41 | us | |
Nigerian keyboard | yes | olpc | ng | olpc | en_US.UTF-8 | 9 | us(?) | (US/International keyboard only) for Igbo, Yoruba, and Hausa |
French keyboard | yes | olpc | fr | olpc | fr_FR.UTF-8 | fr | (not approved for MP) | |
Thai keyboard | yes | olpc | us,th | olpc2,olpc | th_TH.UTF-8 | 8 | us | Thailand |
Urdu keyboard | yes | olpc | us,pk | olpc2,olpc | ur_PK.UTF-8 | 12 | us | Pakistan |
Cyrillic keyboard | yes | olpc | us,ru | olpc2,olpc | uk_UA.UTF-8 | 30 | us | Russia |
Turkish keyboard | yes | olpc | tr | olpc | tr_TR.UTF-8 | us | Turkish-Q approved | |
Nepali keyboard | yes | olpc | us,np | olpc2,olpc | ne_NP.UTF-8 | 15, 46 | us | Nepal |
Mongolian keyboard | yes | olpc | us,mn | olpc2,olpc | mn_MN.UTF-8 | 13,43 | us | Mongolia |
Kazakh keyboard | yes | olpc | us,kz | olpc2,olpc | kk_KZ.UTF-8 | us | (not approved for MP) | |
Devanagari keyboard | yes | olpc | us,in | olpc2,olpc | hi_IN.UTF-8 | 14 | us | India |
Dari keyboard | yes | olpc | us,af | olpc2,fa-olpc | fa_AF.UTF-8 | 22 | us | Afghanistan |
Uzbec keyboard | yes | olpc | us,af | olpc2,uz-olpc | uz_AF.UTF-8 | us | ||
Pashto keyboard | yes | olpc | us,af | olpc2,pa-olpc | ps_AF.UTF-8 | us | ||
Khmer keyboard | yes | olpc | us,kh | olpc2,olpc | km_KH.UTF-8 | 25 | us | Cambodia |
Pulaar keyboard | yes | olpc | ff | olpc | ff_SN.UTF-8 | (not approved for MP) | ||
Armenian keyboard | yes | olpc | us,am | olpc2,olpc | hy_AM.UTF-8 | us | (not approved for MP) | |
Italian keyboard | yes | olpc | it | olpc | it_IT.UTF-8 | 23 | it | Italy |
French Canadian keyboard | yes | olpc | ca | olpc | ht_HT.UTF-8 | 24 | ht | Kreyòl for Haiti |
- †KA Reference is a hint as to which Keyboard ASCII Map to load for both OFW and the Console. It is not the actual KA string, which is described below, but it can be used with the 'loadkeys' command on the console (It should match the value of the KEYTABLE field in /etc/sysconfig/keyboard).
Keyboard ASCII Map
The KA tag specifies the locations of US ASCII characters on the keyboard. It is primarily intended for use by Open Firmware, whose command character set is US ASCII. This tag makes it unnecessary to revise the firmware for new keyboard layouts.
The tag value is a compact encoding specifying the keyboard scanset-1 scan codes that generate US ASCII characters. The encoding takes advantage of these facts and assumptions to save space:
- Scanset-1 values are less than 0x60 for keys in the alpha/numeric/punctuation region.
- The lower case letters a-z are always on unshifted keys and the upper case equivalents are generated with the Shift key.
- The numbers and punctuation characters can be unshifted, shifted, or in the AltGr map.
- If a particular key combination results in a printable ASCII character, holding down the Ctrl key will result in the corresponding control character.
- The dedicated keys that generate the ASCII characters Esc, Tab, Enter, Erase, and Space and the non-ASCII function and arrow keys are the same for all keyboard layouts.
Given those assumptions, 68 scancodes must be specified:
- 26 unshifted scancodes for a-z
- 42 possibly-modified scancodes for numbers and punctuation
The KA tag value consists of 110 data bytes plus an extra null terminator byte. Bytes 0-25 are the scancodes for a-z. Bytes 26-109 are 42 pairs of bytes, each pair consisting of a scancode and a keymap number, for numbers and punctuation. Byte 110 is an extra null terminator byte to protect the data from any software that might strip a trailing null from tag values.
Bytes 26-109 specify characters in this order:
0123456789!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~
The first byte of pair is the scancode number, the second is the keymap number, as follows:
Number | Keymap |
---|---|
0 | Unshifted |
1 | Shifted |
2 | AltGr |
The firmware keyboard driver currently has only these three maps; it does not distinguish between shifted and unshifted AltGr variants, nor does it have a special keymap for the Function key.
For ASCII codes with no corresponding key, the scancode and keymap numbers should be 0, but it is best not to leave such "holes" in the ASCII character set.
SKU(s)
XO-1
SKU(s) | Keyboard Layout | AK | KM | KL | KV | LO | Model | KA Reference† | LA | Comment |
---|---|---|---|---|---|---|---|---|---|---|
01 | US International keyboard | yes | olpc | us | olpc | en_US.UTF-8 | CL1 | us | Developers, other | |
02 | US International keyboard | yes | olpc | us | olpc | en_US.UTF-8 | CL1 | us | Developers, other | |
03 | Spanish keyboard | no | olpc | es | olpc | es_MX.UTF-8 | CL1 | es | Mexico/Peru | |
04 | Spanish keyboard | no | olpc | es | olpc | es_MX.UTF-8 | CL1 | es | Peru | |
05 | Spanish keyboard | no | olpc | es | olpc | es_UY.UTF-8 | CL1 | es | Uruguay, Paraguay | |
06 | Spanish keyboard | no | olpc | es | olpc | es_UY.UTF-8 | CL1 | es | Uruguay | |
07 | Arabic keyboard | yes | olpc | us,ara | olpc2,olpc | ar_EG.UTF-8 | CL1 | us | Iraq, Palestine, Egypt | |
08 | Thai keyboard | yes | olpc | us,th | olpc2,olpc | th_TH.UTF-8 | CL1 | us | Thailand | |
09? | Nigerian keyboard | yes | olpc | ng | olpc | en_US.UTF-8 | CL1 | us(?) | (US/International keyboard only) for Igbo, Yoruba, and Hausa | |
10 | Portuguese keyboard | yes | olpc | br | olpc | pt_BR.UTF-8 | CL1 | pt | Brazil | |
11 | Amharic keyboard | no | olpc | us,et | olpc2,basic | am_ET.UTF-8 | CL1 | us | Ethiopia | |
12? | Urdu keyboard | yes | olpc | us,pk | olpc2,olpc | ur_PK.UTF-8 | 12 | us | Pakistan | |
13 | Mongolian keyboard | yes | olpc | us,mn | olpc2,olpc | mn_MN.UTF-8 | CL1 | us | Mongolia | |
14 | Devanagari keyboard | yes | olpc | us,in | olpc2,olpc | hi_IN.UTF-8 | CL1 | us | India | |
15? | Nepali keyboard | yes | olpc | us,np | olpc2,olpc | ne_NP.UTF-8 | 15 | us | Nepal | |
16? | ||||||||||
17? | Portuguese keyboard | yes | olpc | br | olpc | pt_BR.UTF-8 | CL1 | pt | Brazil | |
18 | Spanish keyboard | no | olpc | es | olpc | es_UY.UTF-8 | CL1 | es | Uruguay | |
19 | US International keyboard | yes | olpc | us | olpc | en_US.UTF-8 | CL1 | us | Developers, other | |
20 | US International keyboard | yes | olpc | us | olpc | en_US.UTF-8 | CL1 | us | Alabama | |
21 | US International keyboard | yes | olpc | us | olpc | en_US.UTF-8 | CL1 | us | Rwanda | |
22 | Dari keyboard | yes | olpc | us,af | olpc2,fa-olpc | fa_AF.UTF-8 | CL1 | us | Afghanistan | |
23 | Italian keyboard | yes | olpc | it | olpc | it_IT.UTF-8 | CL1 | it | Italy | |
24 | French Canadian keyboard | yes | olpc | ca | olpc | ht_HT.UTF-8 | CL1 | ht | Kreyòl for Haiti | |
25 | Khmer keyboard | yes | olpc | us,kh | olpc2,olpc | km_KH.UTF-8 | CL1 | us | Cambodia | |
26 | Spanish keyboard | yes | olpc | es | olpc | es_UY.UTF-8 | CL1 | es | Developers, General Spanish laptops | |
27 | US International keyboard | yes | olpc | us | olpc | en_US.UTF-8 | CL1 | us | ||
28 | US International keyboard | yes | olpc | us | olpc | en_US.UTF-8 | CL1 | us | Nigeria | |
29 | ?? | ? | ? | ? | ? | ?? | CL1 | us | Panama | |
30 | Cyrillic keyboard | yes | olpc | us,ru | olpc2,olpc | uk_UA.UTF-8 | CL1 | us | Russia | |
31 | ?? | ? | ? | ? | ? | ?? | CL1 | us | Senegal | |
32 | ?? | ? | ? | ? | ? | ?? | CL1 | us | Sri Lanka | |
33 | Turkish Keyboard | yes | ? | ? | ? | ?? | CL1 | us | Turkey | |
34? | Mongolian keyboard | yes | olpc | us,mn | olpc2,olpc | mn_MN.UTF-8 | CL1 | us | MS Mongolia | |
35? | Spanish keyboard | no | olpc | es | olpc | es_MX.UTF-8? | CL1A | es | MS Uruguay | |
36? | Thai keyboard | yes | olpc | us | olpc | en_US.UTF-8? | CL1 | us | MS Thailand | |
37? | US International keyboard | yes | olpc | us | olpc | en_US.UTF-8 | CL1A | us | MS Rwanda | |
38? | US International keyboard | yes | olpc | us | olpc | en_US.UTF-8 | CL1A | us | MS South Africa | |
39 | US International keyboard | yes | olpc | us | olpc | en_US.UTF-8 | CL1A | us | Developers, other | |
40 | Spanish keyboard | no | olpc | es | olpc | es_UY.UTF-8 | CL1A | es | Uruguay | |
41 | Arabic keyboard | yes | olpc | us,ara | olpc2,olpc | ar_EG.UTF-8 | CL1A | us | ||
42 | Portuguese keyboard | yes | olpc | br | olpc | pt_BR.UTF-8 | CL1A | pt | Brazil | |
43 | Mongolian keyboard | yes | olpc | us,mn | olpc2,olpc | mn_MN.UTF-8 | CL1A | us | Mongolia | |
44 | US International keyboard | yes | olpc | us | olpc | en_US.UTF-8 | CL1A | us | Rwanda | |
45 | US International keyboard | yes | olpc | us | olpc | en_GH.UTF-8 | CL1A | us | Ghana | |
46 | Nepali keyboard | yes | olpc | us,np | olpc2,olpc | ne_NP.UTF-8 | CL1A | us | Nepal | |
47 | Spanish keyboard | no | olpc | es | olpc | es_MX.UTF-8 | CL1A | es | Peru Custom Keys: http://dev.laptop.org/~reuben/per/ | |
48 | Spanish keyboard | yes | olpc | es | olpc | es_MX.UTF-8 | CL1A | es | MS Peru, MS Colombia | |
49? | Spanish keyboard | yes | olpc | es | olpc | es_UY.UTF-8 | CL1A | es | MS Uruguay | |
50 | Thai keyboard | yes | olpc | us | olpc | en_US.UTF-8? | CL1 | us | MS Thailand | |
51 | US International keyboard | yes | olpc | us | olpc | en_US.UTF-8 | CL1A | us | MS Rwanda | |
52 | US International keyboard | yes | olpc | us | olpc | en_US.UTF-8 | CL1A | us | MS South Africa | |
54 | N/A | N/A | N/A | N/A | N/A | N/A | N/A | N/A | N/A | N/A |
55 | Spanish keyboard | no | olpc | es | olpc | es_NI.UTF-8 | CL1A | es | NIC | Nicaragua (new TP) |
56 | US International keyboard | yes | olpc | us | olpc | en_US.UTF-8 | CL1A | us | PNG | Oceania |
57 | Spanish keyboard | no | olpc | es | olpc | es_NI.UTF-8 | CL1 | es | NIC | Nicaragua (old TP, not manufactured but field-updated) |
58 | Dari keyboard | yes | olpc | us,af | olpc2,fa-olpc | fa_AF.UTF-8 | CL1A | us | AFG | Afghanistan |
59 | Spanish keyboard | no | olpc | es | olpc | es_CO.UTF-8 | CL1A | es | COL | Colombia |
60 | US International keyboard | yes | olpc | us | olpc | en_SZ.UTF-8 | CL1A | us | SWZ | Swaziland |
61 | Arabic keyboard | yes | olpc | us,ara | olpc2,olpc | ar_IQ.UTF-8 | CL1A | us | IRQ | Iraq |
62 | US International keyboard | yes | olpc | us | olpc | en_US.UTF-8 | CL1A | us | GRC | Greece - EU Adapter |
63 | Azerty keyboard | yes | olpc | fr | olpc | fr_ML.UTF-8 | CL1A | azerty | RMM | Mali-EU |
64 | Azerty keyboard | yes | olpc | fr | olpc | fr_BI.UTF-8 | CL1A | azerty | BDI | Burundi-EU |
65 | Portuguese keyboard | yes | olpc | br | olpc | pt_MZ.UTF-8 | CL1A | pt | MOZ | Mozambique-EU |
66 | Spanish keyboard | yes | olpc | es | olpc | es_SV.UTF-8 | CL1A | es | SLV | El Salvador - US Power Adapter |
67 | US International keyboard | yes | olpc | us | olpc | en_AU.UTF-8 | CL1A | us | AUS | Australia - No Power Adapter |
68 | US International keyboard | yes | olpc | us | olpc | en_IT.UTF-8 | CL1A | us | ITA | Italy-EU Adapter |
SKU(s) | Keyboard Layout | AK | KM | KL | KV | LO | Model | KA Reference† | LA | Comment |
XO-1.5
SKU(s) | Keyboard Layout | AK | WW-WP | KM | KL | KV | LO | Model | KA Reference† | LA | Adapter | FLASH | RAM | Comment | Deployment Keys |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
98 | US International keyboard | yes | ww | olpc | us | olpc | en_US.UTF-8 | CL1B | us | US wall | 4 GB | 1 GB | Developers, other | ||
99 | US International keyboard | yes | ww | olpc | us | olpc | en_US.UTF-8 | CL1B | us | none | 4 GB | 1 GB | other (5-pack) | ||
100 | US International keyboard | yes | ww | olpc | us | olpc | en_US.UTF-8 | CL1B | us | USA | US brick | 4 GB | 1 GB | Developers, other | |
101 | Spanish keyboard | no | wp | olpc | es | olpc | es_AR.UTF-8 | CL1B | es | ARG | AR wall | 4 GB | 1 GB | Argentina | http://dev.laptop.org/~reuben/arg/ |
102 | Spanish keyboard | no | wp | olpc | es | olpc | es_MX.UTF-8 | CL1B | es | PER | US wall | 2 GB | 512 MB | Peru | http://dev.laptop.org/~reuben/per/ |
103 | Spanish keyboard | no | wp | olpc | es | olpc | es_CO.UTF-8 | CL1B | es | COL | US Brick | 4 GB | 1 GB | Colombia | |
104 | US International keyboard | yes | ww | olpc | us | olpc | en_AU.UTF-8 | CL1B | us | AUS | NONE | 4 GB | 1 GB | Australia | Deployment Keys: http://download.laptop.org.au/XO/keys/pubkeys.zip Custom Image: http://download.laptop.org.au/XO/F11/10.1.3/au3/XO-1.5/ |
105 | Spanish keyboard | no | wp | olpc | es | olpc | es_MX.UTF-8 | CL1B | es | MEX | US wall | 4 GB | 1 GB | Mexico | |
106 | US International keyboard | yes | ww | olpc | us | olpc | en_ID.UTF-8 | CL1B | us | IDN | EU wall | 4 GB | 1 GB | Indonesia | |
107 | Portuguese keyboard | yes | ww | olpc | br | olpc | pt_BR.UTF-8 | CL1B | pt | BRA | US wall | 4 GB | 1 GB | Brazil | |
108 | US International keyboard | yes | ww | olpc | us | olpc | en_CA.UTF-8 | CL1B | us | CAN | US wall | 4 GB | 1 GB | Canada | |
109 | US International keyboard | yes | ww | olpc | us | olpc | en_PH.UTF-8 | CL1B | us | PHL | US wall | 4 GB | 1 GB | Philippines | |
110 | US International keyboard | yes | ww | olpc | us | olpc | en_AN.UTF-8 | CL1B | us | ANT | US wall | 4 GB | 1 GB | Netherlands Antilles | |
111 | US International keyboard | yes | ww | olpc | us | olpc | en_NL.UTF-8 | CL1B | us | NLD | EU wall | 4 GB | 1 GB | Netherlands | |
112 | US International keyboard | yes | ww | olpc | us | olpc | en_US.UTF-8 | CL1B | us | USA | EU wall | 4 GB | 1 GB | OLPC EU Developers | |
113 | African AZERTY keyboard | yes | ww | olpc | fr | olpc | CL1B | EU brick | 4 GB | 1 GB | Francophone Africa | ||||
114 | Spanish keyboard | no | wp | olpc | es | olpc | es_NI.UTF-8 | CL1B | es | NIC | US wall | 4 GB | 1 GB | Nicaragua -- Custom Image: http://dev.laptop.org/~dsd/nic-xo1.5-costa/ | http://dev.laptop.org/~reuben/nic/ |
115 | Spanish keyboard | no | wp | olpc | es | olpc | es_UY.UTF-8 | CL1B | es | URY | EU wall | 2 GB | 512 MB | Uruguay | http://dev.laptop.org/~reuben/UY/ |
116 | Spanish HS KB | no | wp | olpcm | es | olpc | es_UY.UTF-8 | CL1C | es | URY | EU wall | 4 GB | 1 GB | Uruguay | http://dev.laptop.org/~reuben/UY/ |
117 | Spanish keyboard | no | wp | olpc | es | olpc | es_MX.UTF-8 | CL1B | es | PER | US wall | 4 GB | 512 MB | Peru | http://dev.laptop.org/~reuben/per/ |
118 | Arabic keyboard | yes | ww | olpc | us,ara | olpc2,olpc | ar_SY.UTF-8 | CL1B | us | SYR | EU wall | 4 GB | 1 GB | Palestinian Territories, others | |
119 | Azerty keyboard | yes | ww | olpc | us | olpc | fr_FR.UTF-8 | CL1B | us | SEN | EU wall | 4 GB | 1 GB | Senegal & generic Francophone Africa | |
120 | US International keyboard | yes | ww | olpc | us | olpc | en_JM.UTF-8 | CL1B | us | JAM | US wall | 4 GB | 1 GB | Jamaica | |
121 | Spanish HS KB | no | wp | olpcm | es | olpc | es_UY.UTF-8 | CL1C | es | URY | EU wall | 8 GB | 1 GB | Uruguay | http://dev.laptop.org/~reuben/UY/ |
122 | US International keyboard | yes | ww | olpc | us | olpc | en_BB.UTF-8 | CL1B | us | BRB | US wall | 4 GB | 1 GB | Barbados | |
123 | US International keyboard | yes | ww | olpc | us | olpc | en_FM.UTF-8 | CL1B | us | FSM | US wall | 4 GB | 1 GB | Micronesia | |
124 | Dari keyboard | yes | ww | olpc | us,af | olpc2,fa-olpc | fa_AF.UTF-8 | CL1B | us | AFG | EU wall | 4 GB | 1 GB | Afghanistan | Dari or Pashto? |
125 | Hebrew keyboard | yes | ww | ? | ? | ? | ? | CL1B | us | ISR | EU wall | 4 GB | 1 GB | Israel | |
126 | N/A | ||||||||||||||
127 | Portuguese keyboard | yes | ww | olpc | br | olpc | pt_BR.UTF-8 | CL1B | pt | AGO | EU wall | 4 GB | 1 GB | Angola | |
128 | English HS KB | yes | ww | olpcm | en | olpc | en_US.UTF-8 | CL1C | us | USA | US brick | 4 GB | 1 GB | Developers | |
129 | US International keyboard | yes | ww | olpc | us | olpc | en_US.UTF-8 | CL1B | us | ZMB | EU wall | 4 GB | 1 GB | Zambia | |
130 | Amharic keyboard | yes | ww | olpc | us,et | olpc2,basic | am_ET.UTF-8 | CL1B | us | ETH | EU wall | 4 GB | 1 GB | Ethiopia | |
131 | Spanish keyboard | no | wp | olpc | es | olpc | es_PY.UTF-8 | CL1B | es | PRY | EU wall | 4 GB | 1 GB | Paraguay | http://dev.laptop.org/~reuben/PY/ and Custom Image: http://www.paraguayeduca.org/osbuild/os376py.zd |
132 | US International keyboard | yes | ww | olpc | us | olpc | en_US.UTF-8 | CL1B | us | LKA | EU wall | 4 GB | 1 GB | Sri Lanka | |
133 | US International keyboard | yes | ww | olpc | us | olpc | en_CA.UTF-8 | CL1B | us | CAN | US brick | 4 GB | 1 GB | Canada | |
134 | Spanish keyboard | yes | ww | olpc | es | olpc | es_SV.UTF-8 | CL1B | es | SLV | US brick | 4 GB | 1 GB | El Salvador | |
135 | Spanish HS KB | yes | wp | olpcm | es | olpc | es_MX.UTF-8 | CL1C | es | PER | Blue US wall | 2 GB | 512 MB | Peru | Keys: http://dev.laptop.org/~reuben/per/ Custom Image: ftp://ftp.perueduca.edu.pe/XO_OLPC/secundaria/ |
136 | Spanish HS KB | no | wp | olpcm | es | olpc | es_UY.UTF-8 | CL1C | es | URY | EU wall | 8 GB | 1 GB | Uruguay | Keys: http://dev.laptop.org/~reuben/UY/ Custom Image: UY Windows XP |
137 | US International keyboard | yes | wp | olpc | us | olpc | en_US.UTF-8 | CL1B | us | RWA | EU wall | 2 GB | 512 MB | Rwanda | Keys: http://dev.laptop.org/~reuben/RWA/ |
138 | Spanish keyboard | yes | ww | olpc | es | olpc | es_MX.UTF-8 | CL1B | es | HND | US brick | 4 GB | 1 GB | Honduras | |
139 | US International keyboard | yes | ww | olpc | us | olpc | en_US.UTF-8 | CL1B | us | PAK | EU brick | 4 GB | 1 GB | Pakistan | |
140 | Spanish keyboard | no | wp | olpc | es | olpc | es_CR.UTF-8 | CL1B | es | CRI | US Brick | 4 GB | 1 GB | Costa Rica | |
141 | US International keyboard | yes | wp | olpc | us | olpc | en_US.UTF-8 | CL1B | us | RWA | EU wall | 4 GB | 1 GB | Rwanda | Keys: http://dev.laptop.org/~reuben/RWA/ |
142 | US International keyboard | yes | ww | olpc | us | olpc | en_PH.UTF-8 | CL1B | us | PHL | US Brick | 4 GB | 1 GB | Philippines | |
143 | Armenian keyboard layout | yes | ww | olpc | us,am | olpc2,olpc-phonetic | hy_AM.UTF-8 | CL1B | us | ARM | EU Brick | 4 GB | 1 GB | Armenia | Custom Image: http://dev.laptop.org/~reuben/armenia_10.1.3-xo1.5/os1-4g.zd |
144 | Spanish keyboard | no | wp | olpc | es | olpc | es_MX.UTF-8 | CL1B | es | HND | US Brick | 8 GB | 1 GB | Honduras | |
145 | Spanish keyboard | no | wp | olpc | es | olpc | es_CO.UTF-8 | CL1B | es | COL | US Wall | 2 GB | 512 MB | Colombia | |
146 | Dari keyboard | yes | ww | olpc | us,af | olpc2,fa-olpc | fa_AF.UTF-8 | CL1B | us | AFG | EU Brick | 4 GB | 1 GB | Afghanistan | Dari |
147 | US International keyboard | yes | ww | olpc | us | olpc | en_PH.UTF-8 | CL1B | us | PHL | US Brick | 4 GB | 1 GB | Philippines | Deployment Keys: http://dev.laptop.org/~reuben/PHL/ |
148 | Thai keyboard | yes | ww | olpc | us,th | olpc2,olpc | th_TH.UTF-8 | CL1B | us | THA | US Brick | 4 GB | 1 GB | Thailand | |
149 | US International keyboard | yes | ww | olpc | us | olpc | nl_NL.UTF-8 | CL1B | us | SUR | EU Brick | 4 GB | 1 GB | Suriname | |
150 | US International keyboard | yes | ww | olpc | us | olpc | en_US.UTF-8 | CL1B | us | MHL | US Wall | 4 GB | 1 GB | Marshall Islands | |
151 | Azerty keyboard | yes | ww | olpc | us | olpc | fr_FR.UTF-8 | CL1B | us | CMR | EU wall | 2 GB | 512 MB | Cameroon | |
152 | US International keyboard | yes | ww | olpc | us | olpc | en_US.UTF-8 | CL1B | us | CMR | EU wall | 2 GB | 512 MB | Cameroon | |
153 | US International keyboard | no | wp | olpc | us | olpc | en_US.UTF-8 | CL1B | us | RWA | EU wall | 2 GB | 512 MB | Rwanda | Custom Image: http://dev.laptop.org/~reuben/os5.zd2 Keys: http://dev.laptop.org/~reuben/RWA/ |
154 | English HS KB | yes | ww | olpcm | en | olpc | en_AU.UTF-8 | CL1C | us | AUS | None | 4 GB | 1 GB | Australia | Deployment Keys: http://download.laptop.org.au/XO/keys/pubkeys.zip Custom Image: http://download.laptop.org.au/XO/F14/11.3.1/au886/ |
SKU(s) | Keyboard Layout | AK | WW/WP | KM | KL | KV | LO | Model | KA Reference† | LA | Comment |
XO-1.75
SKU(s) | Keyboard Layout | AK | WW-WP | KM | KL | KV | LO | Model | KA Reference† | LA | Adapter | CPU | FLASH | RAM | Comment | Deployment Keys |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
198 | US Int'l keyboard | yes | ww | olpc | us | olpc | en_US.UTF-8 | CL2 | us | US Wall | 800 MHz | 4 GB | 512 MB | Developers, other | ||
199 | English HS KB | yes | ww | olpcm | us | olpc | en_US.UTF-8 | CL2A | us | US Brick | 800 MHz | 4 GB | 512 MB | Developers, other | ||
200 | US Int'l keyboard | yes | ww | olpc | us | olpc | en_US.UTF-8 | CL2 | us | US Brick | 800 MHz | 4 GB | 512 MB | Developers, other | ||
201 | English HS KB | yes | ww | olpcm | us | olpc | en_US.UTF-8 | CL2A | us | US Wall | 800 MHz | 8 GB | 1 GB | Developers, other | ||
202 | Portuguese keyboard | yes | ww | olpc | br | olpc | pt_BR.UTF-8 | CL2 | pt | BRA | US Brick | 800 MHz | 8 GB | 1 GB | Developers, Brazil | |
203 | US Int'l keyboard | yes | ww | olpc | us | olpc | en_US.UTF-8 | CL2 | us | US Wall | 800 MHz | 4 GB | 512 MB | RAMP, Developers, other | ||
204 | English HS KB | yes | ww | olpcm | us | olpc | en_US.UTF-8 | CL2A | us | US Wall | 800 MHz | 8 GB | 1 GB | RAMP, Developers, other | ||
205 | Spanish keyboard | no | wp | olpc | es | olpc | es_NI.UTF-8 | CL2 | es | NIC | US Brick | 800 MHz | 4 GB | 1 GB | Nicaragua -- Custom Image: | http://dev.laptop.org/~reuben/nic/ |
206 | Spanish keyboard | no | wp | olpc | es | olpc | es_UY.UTF-8 | CL2 | es | URY | EU Wall | 800 MHz | 8 GB | 1 GB | Uruguay | http://dev.laptop.org/~reuben/UY/ |
207 | Spanish keyboard | yes | ww | olpc | es | olpc | es_SV.UTF-8 | CL2 | es | SLV | US Brick | 800 MHz | 4 GB | 1 GB | El Salvador | |
208 | Spanish keyboard | no | wp | olpc | es | olpc | es_MX.UTF-8 | CL2 | es | HND | US Brick | 800 MHz | 4 GB | 1 GB | Honduras | http://dev.laptop.org/~reuben/hn.zip |
209 | US International keyboard | yes | ww | olpc | us | olpc | en_ID.UTF-8 | CL2 | us | IDN | EU Brick | 800 MHz | 4 GB | 1 GB | Indonesia | |
210 | Spanish keyboard | yes | ww | olpc | es | olpc | es_MX.UTF-8 | CL2 | es | PER | US Brick | 800 MHz | 4 GB | 512 MB | Peru | http://dev.laptop.org/~reuben/per/ and http://dev.laptop.org/~reuben/peru_amazonas.zip |
211 | Spanish HS KB | yes | ww | olpcm | es | olpc | es_MX.UTF-8 | CL2A | es | PER | US Brick | 800 MHz | 4 GB | 512 MB | Peru | http://dev.laptop.org/~reuben/per/ and http://dev.laptop.org/~reuben/peru_amazonas.zip |
212 | Azerty keyboard | yes | ww | olpc | fr | olpc | fr_FR.UTF-8 | CL2 | azerty | HTI | US Brick | 800 MHz | 4 GB | 1 GB | Haiti | Custom Image: http://dev.laptop.org/~reuben/azerty/ |
213 | US Int'l keyboard | yes | ww | olpc | us | olpc | en_US.UTF-8 | CL2 | us | USA | US Brick | 800 MHz | 4 GB | 1 GB | SF, Developers, other | |
214 | English HS KB | yes | ww | olpcm | us | olpc | en_CA.UTF-8 | CL2A | us | CAN | US Brick | 800 MHz | 4 GB | 1 GB | ICT4E | |
215 | English HS KB | yes | ww | olpcm | us | olpc | en_CA.UTF-8 | CL2A | us | CAN | US Brick | 800 MHz | 4 GB | 1 GB | Canada - TBSF | |
216 | US International keyboard | yes | ww | olpc | us | olpc | en_US.UTF-8 | CL2 | us | RWA | EU Brick | 800 MHz | 4 GB | 1 GB | Girls Initiative - Rwanda | |
217 | Spanish keyboard | yes | ww | olpc | es | olpc | es_MX.UTF-8 | CL2 | es | USA | US Brick | 800 MHz | 8 GB | 1 GB | OLPC Inventory | |
218 | Spanish keyboard | yes | ww | olpc | es | olpc | en_US.UTF-8 | CL2 | es | USA | US Wall | 1 GHz | 8 GB | 1 GB | Quanta internal testing | |
219 | Spanish HS KB | yes | ww | olpcm | es | olpc | en_US.UTF-8 | CL2A | es | USA | US Wall | 1 GHz | 8 GB | 1 GB | Quanta internal testing | |
220 | US International keyboard | yes | ww | olpc | us | olpc | en_PH.UTF-8 | CL2 | us | PHL | US Wall | 800 MHz | 4 GB | 1 GB | Philippines | Deployment Keys: http://dev.laptop.org/~reuben/PHL/ |
221 | US International keyboard | yes | ww | olpc | us | olpc | en_FJ.UTF-8 | CL2 | us | FJI | US Wall | 800 MHz | 4 GB | 1 GB | Fiji | |
222 | Armenian keyboard layout | yes | ww | olpc | us,am | olpc2,olpc-phonetic | hy_AM.UTF-8 | CL2 | us | ARM | EU Brick | 800 MHz | ?? GB | ?? GB | Armenia | Custom Image: Yes?? Deployment Keys: Yes?? |
223 | Azerty keyboard | yes | ww | olpc | fr | olpc | fr_FR.UTF-8 | CL2 | azerty | GAB | EU Wall | 800 MHz | 4 GB | 1 GB | Gabon | |
224 | US Int'l keyboard | no | wp | olpc | us | olpc | en_US.UTF-8 | CL2 | us | USA | US Brick | 1 GHz | 8 GB | 1 GB | Charlotte | Deployment Keys: http://dev.laptop.org/~reuben/clt.zip |
225 | English HS KB | no | wp | olpcm | us | olpc | en_US.UTF-8 | CL2A | us | USA | US Brick | 1 GHz | 8 GB | 1 GB | Charlotte | Deployment Keys: http://dev.laptop.org/~reuben/clt.zip |
226 | Spanish keyboard | no | wp | olpc | es | olpc | es_MX.UTF-8 | CL2 | es | HND | US Wall | 1 GHz | 8 GB | 1 GB | Gobierno de Honduras | Standard Image: 12.1.0 Deployment Keys: http://dev.laptop.org/~reuben/hn.zip |
227 | Azerty keyboard | yes | ww | olpc | fr | olpc | fr_FR.UTF-8 | CL2 | azerty | TGO | EU Brick | 800 MHz | 4 GB | 1 GB | Atlantique Télécom TOGO | |
228 | US International keyboard | yes | ww | olpc | us | olpc | en_US.UTF-8 | CL2 | us | BTN | US Brick | 800 MHz | 4 GB | 1 GB | Olpc Asia - Buthan | |
229 | AUS HS KB | yes | ww | olpcm | us | olpc | en_AU.UTF-8 | CL2A | us | AUS | AUS Brick | 800 MHz | 8 GB | 1 GB | Australia | Deployment Keys: http://download.laptop.org.au/XO/keys/pubkeys.zip Custom Image: http://download.laptop.org.au/XO/F14/11.3.1/au889/XO-1.75/ |
230 | Spanish keyboard | no | wp | olpc | es | olpc | es_UY.UTF-8 | CL2 | es | URY | EU Wall | 800 MHz | 8 GB | 1 GB | Uruguay Generic | None |
XO-4
SKU(s) | Keyboard Layout | AK | WW-WP | KM | KL | KV | LO | Model | Touch ? | KA Reference† | LA | Adapter | CPU | WLAN | FLASH | RAM | Battery | Comment | Deployment Keys |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
291 | English keyboard | yes | ww | olpc | us | olpc | en_US.UTF-8 | CL4 | yes | us | USA | US wall | 1 GHz | 8686 | 4 GB | 1 GB | LiFePo4 | Developers, other | |
292 | English HS KB | yes | ww | olpcm | us | olpc | en_US.UTF-8 | CL4A | yes | us | USA | US Brick | 1 GHz | 8686 | 8 GB | 1 GB | LiFePo4 | Developers, others | |
293 | English HS KB | yes | ww | olpcm | us | olpc | en_US.UTF-8 | CL4A | yes | us | USA | US Brick | 1 GHz | 8686 | 8 GB | 2 GB | LiFePo4 | Developers, other | |
294 | Spanish keyboard | yes | ww | olpc | es | olpc | es_UY.UTF-8 | CL4 | yes | es | URY | US wall | 1 GHz | 8686 | 4 GB | 1 GB | LiFePo4 | Developers, other | |
295 | English keyboard | yes | ww | olpc | us | olpc | en_US.UTF-8 | CL4 | yes | us | USA | US wall | 1 GHz | 8787 | 8 GB | 2 GB | NiMH | Developers, other | |
296 | English HS KB | yes | ww | olpcm | us | olpc | en_US.UTF-8 | CL4A | yes | us | USA | US Brick | 1.2 GHz | 8 GB | 2 GB | NiMH | Developers, other | ||
297 | English keyboard | yes | ww | olpc | us | olpc | en_US.UTF-8 | CL4B | no | us | USA | US wall | 1.2 GHz | 8787 | 4 GB | 1 GB | NiMH | Developers, other | |
298 | English HS KB | yes | ww | olpcm | us | olpc | en_US.UTF-8 | CL4C | no | us | USA | US Brick | 1 GHz | 8787 | 4 GB | 1 GB | NiMH | Developers, other | |
299 | English HS KB | yes | ww | olpcm | us | olpc | en_US.UTF-8 | CL4A | yes | us | USA | US Brick | 1.2 GHz | 8787 | 8 GB | 2 GB | LiFePo4 | Developers, other | |
300 | English keyboard | yes | ww | olpc | us | olpc | en_US.UTF-8 | CL4B | no | us | USA | US Wall | 1 GHz | 8787 | 8 GB | 1 GB | LiFePo4 | Charlotte | |
301 | Spanish HS KB | yes | ww | olpcm | es | olpc | en_US.UTF-8 | CL4A | yes | us | URY | US Brick | 1.2 GHz | 8787 | 8 GB | 2 GB | LiFePo4 | Latam developers, other |
Useful links
- ISO Country Codes
- CIA World Factbook Table of ISO 3166 Codes (includes three-letter codes not given in the ISO document above)
- ISO Language Codes
- IANA Language Tag Registry
- Mains electricity by country, with power specs and plug descriptions
- wikipedia:Language code
- wikipedia:Country code
- Preproduction components in XO-1.75
- Preproduction components in XO-4