Ok: Difference between revisions

From OLPC
Jump to navigation Jump to search
No edit summary
No edit summary
 
(18 intermediate revisions by 3 users not shown)
Line 1: Line 1:
[[Image:Ok-xo-1-q2f19-show-child.png|thumb|press the [[File:Esc.png]] key once when the grey icon first appears]]
The 'ok' prompt is the [[OFW|Open Firmware]] menu for the laptop. At this point the laptop firmware is ready to accept commands. The operating system is not running.
The 'ok' prompt is the [[OFW|Open Firmware]] menu for the laptop. At this point the laptop firmware is ready to accept commands. The operating system is not running.


There are several methods to get to the 'ok' prompt.
There are several methods to get to the 'ok' prompt. The most common is to press the [[File:Esc.png]] ''Escape'' key once when the grey icon first appears after powering on.


The 'ok' prompt is not available if the laptop is secured. If you have tried all these methods, then perhaps your laptop is secured. See [[Activation_and_Developer_Keys|how to unlock]].
The 'ok' prompt is not available if the laptop is secured and has no developer key. If you have tried all these methods, then perhaps your laptop is secured and you need a "developer key". See [[#Developer_Key_Absent|how to prove it]]. See [[Activation_and_Developer_Keys|how to unlock]].


== Novice ==
== Unsecured ==


=== Regular ===

[[Image:Ok-xo-1-q2f19-unsecure.png|thumb|the 'ok' prompt]]
* [[Shutdown]] the laptop,
* [[Shutdown]] the laptop,
* Watch the display, turn on the laptop, and as soon as the grey icon appears in the centre of the display press [[File:Esc.png]] ''Escape'' key once, and the 'ok' prompt should appear within two seconds.
* Hold down the '✓' (check) game pad key and turn on the laptop, a diagram of the game keys should appear with a message ''Release the game keys to continue'',
* Release the '✓' (check) game pad key, and immediately press [[File:Esc.png]] ''Escape'' key a few times a second, and the 'ok' prompt should appear,
* press ''enter'' to get a fresh 'ok' prompt.


OLPC D1, 1 GiB memory installed, 4 GB internal storage, S/N SHC937010AA
OLPC D1, 1 GiB memory installed, 4 GB internal storage, S/N SHC937010AA
OpenFirmware CL1 Q3A39c Q3A EC Firmware Ver:1.9.28
OpenFirmware CL1 Q3A39 Q3A EC Firmware Ver:1.9.28
Type the Esc key to interrupt automatic startup
Type 'help' for more information.
Type 'help' for more information.
ok
ok
ok


== Regular ==
=== Novice ===

[[Image:Ok-xo-1-q2f19-release-check-key.png|thumb|holding down the ✓' (check) game pad key]]
This method does not rely on timing. For when you are under stress and doing many things at the same time.


* [[Shutdown]] the laptop,
* [[Shutdown]] the laptop,
* Hold down the '✓' (check) game pad key and turn on the laptop, within four (4) seconds, a diagram of the game keys will appear with a message ''Release the game keys to continue'',
* Turn on the laptop, and press [[File:Esc.png]] ''Escape'' key once during the startup sound, and the 'ok' prompt should appear.
* Hold down the [[File:Esc.png]] ''Escape'' key,
* Release the '✓' (check) game pad key, and the 'ok' prompt should appear within two seconds,
* press ''enter'' to get a fresh 'ok' prompt.


OLPC D1, 1 GiB memory installed, 4 GB internal storage, S/N SHC937010AA
OLPC D1, 1 GiB memory installed, 4 GB internal storage, S/N SHC937010AA
OpenFirmware CL1 Q3A39c Q3A EC Firmware Ver:1.9.28
OpenFirmware CL1 Q3A39 Q3A EC Firmware Ver:1.9.28
Type the Esc key to interrupt automatic startup
Type 'help' for more information.
Type 'help' for more information.
ok
ok
ok


== Expert ==
=== Expert ===


* [[Shutdown]] the laptop,
* [[Shutdown]] the laptop,
Line 39: Line 47:


OLPC D1, 1 GiB memory installed, 4 GB internal storage, S/N SHC937010AA
OLPC D1, 1 GiB memory installed, 4 GB internal storage, S/N SHC937010AA
OpenFirmware CL1 Q3A39c Q3A EC Firmware Ver:1.9.28
OpenFirmware CL1 Q3A39 Q3A EC Firmware Ver:1.9.28
Type 'help' for more information.
Type 'help' for more information.
ok
ok


This method sometimes doesn't work for some laptops.
This method sometimes doesn't work for some laptops.

== Secured ==

=== Developer Key Present ===

[[Image:Ok-xo-1-q2f19-unlocked-with-escape.png|thumb|secured, but unlocked with a developer key on USB drive]]
When a developer key is present on a secured laptop, the timing is different. This is because device and filesystems are accessed before the escape key can be used. The access time varies.

* [[Shutdown]] the laptop,
* Hold down the '✓' (check) game pad key and turn on the laptop, a diagram of the game keys should appear with a message ''Release the game keys to continue'',
* Release the '✓' (check) game pad key, and within ten seconds a ''Devel key Signature valid'' message will appear, with an open padlock icon, followed by ''Type the ESC key to interrupt automatic startup'',
* Press [[File:Esc.png]] ''Escape'' key once, and the 'ok' prompt should appear immediately.
* press ''enter'' to get a fresh 'ok' prompt.

This different behaviour is another good reason to ''disable-security'' if the laptop need not be secured.

=== Developer Key Absent ===

[[Image:Ok-xo-1-q2f19-secure-with-escape.png|thumb|secured with no developer key present, no keys pressed]]
[[Image:Ok-xo-1-q2f19-secure-with-check-key-and-escape.png|thumb|secured with no developer key present, after using check key and pressing escape]]
The 'ok' prompt cannot be accessed using the keyboard if a developer key is not present on a secured laptop.

You can prove this:
* [[Shutdown]] the laptop,
* Hold down the '✓' (check) game pad key and turn on the laptop, a diagram of the game keys should appear with a message ''Release the game keys to continue'',
* Press [[File:Esc.png]] ''Escape'' key once,
* Release the '✓' (check) game pad key, and the ''Devel key Signature valid'' message will not appear, instead a sequence of ''Trying'' lines will appear, and the laptop will try to boot.

The missing ''Devel key Signature valid'' message proves the laptop is secured and a developer key is not present.

In recent firmware, a ''Secured, continuing'' message proves the laptop is secured and a developer key is not present.


== How do I know it worked? ==
== How do I know it worked? ==
Line 51: Line 90:
You should see text on the screen. There should be the word ok with a black rectangle after it.
You should see text on the screen. There should be the word ok with a black rectangle after it.


ok
ok


Press ''enter'', and a new word ok will appear and the black rectangle should move down.
Press ''enter'', and a new word ok will appear and the black rectangle should move down.

When you are finished with the ok prompt, you can either turn the laptop off, or type boot and press enter.

== Alternatives ==

If the above methods do not work, you may try:
* [[upgrading firmware]], because some earlier firmware made it harder to get the ok prompt, or
* attach a [[serial adapter]] between the XO and another computer, and during startup press the Escape key on the other computer.


== Technical Data ==
== Technical Data ==


The firmware only checks for the [[File:Esc.png]] ''Escape'' key for a short time during the [[Startup sound]]. It is possible for the volume to have been turned down so that you cannot hear the sound, see [[Startup_sound#How_to_enable]] to fix.
The firmware only checks for the [[File:Esc.png]] ''Escape'' key for a short time during the [[Startup sound]]. It is possible for the volume to have been turned down so that you cannot hear the sound, see [[Startup sound#How to enable]] to fix.


This 'ok' prompt is called a command line interface (CLI), and the black rectangle is a cursor.
This 'ok' prompt is called a command line interface (CLI), and the black rectangle (█) is a cursor.


Normally it is hidden, which is why you have to do special things to get to it.
Normally it is hidden, which is why you have to do special things to get to it.
Line 65: Line 112:
== Learn More ==
== Learn More ==


You might only have needed the 'ok' prompt for a specific task. But there's way more. To learn how to use the 'ok' prompt fully, see [[Forth_Lessons]].
You might only have needed the 'ok' prompt for a specific task. But there's way more. To learn how to use the 'ok' prompt fully, see [[Forth Lessons]].

[[Category:Firmware]]
[[Category:XO startup]]

Latest revision as of 06:01, 10 January 2014

press the Esc.png key once when the grey icon first appears

The 'ok' prompt is the Open Firmware menu for the laptop. At this point the laptop firmware is ready to accept commands. The operating system is not running.

There are several methods to get to the 'ok' prompt. The most common is to press the Esc.png Escape key once when the grey icon first appears after powering on.

The 'ok' prompt is not available if the laptop is secured and has no developer key. If you have tried all these methods, then perhaps your laptop is secured and you need a "developer key". See how to prove it. See how to unlock.

Unsecured

Regular

the 'ok' prompt
  • Shutdown the laptop,
  • Watch the display, turn on the laptop, and as soon as the grey icon appears in the centre of the display press Esc.png Escape key once, and the 'ok' prompt should appear within two seconds.
OLPC D1, 1 GiB memory installed, 4 GB internal storage, S/N SHC937010AA
OpenFirmware  CL1   Q3A39  Q3A   EC Firmware Ver:1.9.28

Type 'help' for more information.

ok █

Novice

holding down the ✓' (check) game pad key

This method does not rely on timing. For when you are under stress and doing many things at the same time.

  • Shutdown the laptop,
  • Hold down the '✓' (check) game pad key and turn on the laptop, within four (4) seconds, a diagram of the game keys will appear with a message Release the game keys to continue,
  • Hold down the Esc.png Escape key,
  • Release the '✓' (check) game pad key, and the 'ok' prompt should appear within two seconds,
  • press enter to get a fresh 'ok' prompt.
OLPC D1, 1 GiB memory installed, 4 GB internal storage, S/N SHC937010AA
OpenFirmware  CL1   Q3A39  Q3A   EC Firmware Ver:1.9.28

Type the Esc key to interrupt automatic startup
Type 'help' for more information.

ok
ok █

Expert

  • Shutdown the laptop,
  • Hold down the Esc.png Escape key while turning on the laptop, and the 'ok' prompt should appear.
OLPC D1, 1 GiB memory installed, 4 GB internal storage, S/N SHC937010AA
OpenFirmware  CL1   Q3A39  Q3A   EC Firmware Ver:1.9.28

Type 'help' for more information.

ok █

This method sometimes doesn't work for some laptops.

Secured

Developer Key Present

secured, but unlocked with a developer key on USB drive

When a developer key is present on a secured laptop, the timing is different. This is because device and filesystems are accessed before the escape key can be used. The access time varies.

  • Shutdown the laptop,
  • Hold down the '✓' (check) game pad key and turn on the laptop, a diagram of the game keys should appear with a message Release the game keys to continue,
  • Release the '✓' (check) game pad key, and within ten seconds a Devel key Signature valid message will appear, with an open padlock icon, followed by Type the ESC key to interrupt automatic startup,
  • Press Esc.png Escape key once, and the 'ok' prompt should appear immediately.
  • press enter to get a fresh 'ok' prompt.

This different behaviour is another good reason to disable-security if the laptop need not be secured.

Developer Key Absent

secured with no developer key present, no keys pressed
secured with no developer key present, after using check key and pressing escape

The 'ok' prompt cannot be accessed using the keyboard if a developer key is not present on a secured laptop.

You can prove this:

  • Shutdown the laptop,
  • Hold down the '✓' (check) game pad key and turn on the laptop, a diagram of the game keys should appear with a message Release the game keys to continue,
  • Press Esc.png Escape key once,
  • Release the '✓' (check) game pad key, and the Devel key Signature valid message will not appear, instead a sequence of Trying lines will appear, and the laptop will try to boot.

The missing Devel key Signature valid message proves the laptop is secured and a developer key is not present.

In recent firmware, a Secured, continuing message proves the laptop is secured and a developer key is not present.

How do I know it worked?

You should see text on the screen. There should be the word ok with a black rectangle after it.

ok █

Press enter, and a new word ok will appear and the black rectangle should move down.

When you are finished with the ok prompt, you can either turn the laptop off, or type boot and press enter.

Alternatives

If the above methods do not work, you may try:

  • upgrading firmware, because some earlier firmware made it harder to get the ok prompt, or
  • attach a serial adapter between the XO and another computer, and during startup press the Escape key on the other computer.

Technical Data

The firmware only checks for the Esc.png Escape key for a short time during the Startup sound. It is possible for the volume to have been turned down so that you cannot hear the sound, see Startup sound#How to enable to fix.

This 'ok' prompt is called a command line interface (CLI), and the black rectangle (█) is a cursor.

Normally it is hidden, which is why you have to do special things to get to it.

Learn More

You might only have needed the 'ok' prompt for a specific task. But there's way more. To learn how to use the 'ok' prompt fully, see Forth Lessons.