This page contains information about the Samsung Series 5 Chromebook that is interesting and/or useful to software developers. For general information about getting started with developing on Chromium OS (the open-source version of the software on Chrome OS devices), see the Chromium OS Developer Guide You might want to enter developer mode if you're following the instructions in the Chromium OS Developer Guide , or if you just want to get access to a shell on your device to poke around

Caution: Modifications you make to the system are not supported by Google, may cause hardware

Caution: Modifications you make to the system are not supported by Google, may cause hardware , software or security issues and may void warranty.

Developer mode on the Samsung Series 5 has two levels of access, "dev-switch on" and "dev-mode BIOS". With the first level you enable a command line shell, which lets you look around inside the GNU/Linux operating system, but does not let you run your own versions. The second level of access installs a special BIOS component that provides the ability to boot your own operating systems from either removable (USB/SD) or fixed (SSD) drives. Both levels of access are completely reversible, so don't be afraid to experiment.The developer switch enables the command line shell. The switch is behind a little door on the right-hand side of the chromebook. To enable the developer switch you open the door, use something pointy to move the switch towards the back of the device, and reboot.Some people have reported that the developer switch breaks easily.The first time you reboot after turning the developer switch on, your chromebook will:

Make you wait between 5 and 10 minutes while it erases the data.

Show a scary warning that its software cannot be trusted, since a command line shell is enabled (press Ctrl-D or wait 30 seconds to dismiss).

Show a scary warning that its software cannot be trusted, since a command line shell is enabled (press Ctrl-D or wait 30 seconds to dismiss).

Show a scary warning that its software cannot be trusted, since a command line shell is enabled (press Ctrl-D or wait 30 seconds to dismiss).

Show a scary warning that its software cannot be trusted, since a command line shell is enabled (press Ctrl-D or wait 30 seconds to dismiss).

Continue to boot only Google-signed images, and only from the SSD.

Continue to boot only Google-signed images, and only from the SSD.

At this point, verified boot is still active but because a command line shell is enabled, your system issecure. Refer to Poking around your Chrome OS Notebook to see how to access the command line shell. The message displayed at the shell itself should tell you how to set your own password to protect shell access and make your system secure again.Here's a photo showing the location of the developer switch:If you want to make modifications to the Chrome OS filesystem or boot your own version of Chromium OS, you'll need to activate the second level of developer access. You do this by running a special command from the command line shell, available after the device boots to the 'select language' screen by pressing Ctrl-Alt-"→" (Ctrl-Alt-F2). You first log in with the username 'chronos' (if you've set a shell password, you'll be prompted for it). Then you switch to the 'root' account, and run the command to install the developer-mode BIOS. For example:

localhost login: chronos

chronos@localhost $ sudo bash

localhost chronos # chromeos-firmwareupdate --mode=todev



What's going on here?

How to boot your own image from USB

Follow the steps above to turn on the developer switch and to install the developer-mode BIOS.

Build a Chrome OS image using the steps in the Chromium OS Developer Guide . It does not need to be a recovery image.

Chromium OS Developer Guide Insert the removable drive containing your image into either USB slot.

Reboot, and when you see the blue scary boot screen, press Ctrl-U.

It should boot your image. If for some reason it doesn't think your image is valid it will just beep once instead.

How to install your own Chromium OS image on your SSD

/usr/sbin/chromeos-install

Leaving Developer Mode

One other thing to try first

chromeos-firmwareupdate --mode tonormal

How to use the Recovery Mode button

Verified boot is the process by which Chrome OS ensures that you are running only the software that shipped with your chromebook. The process starts with the read-only BIOS, which is built into the device at the factory and can't be modified without disassembly (please don't try that; you'll void your warranty). The read-only BIOS verifies one of two read-write BIOSes (there are two so we can provide updates if we have to with less risk of failure) and continues execution there. The read-write BIOS then verifies one of two (same reason) kernels and executes that, and the kernel verifies its root filesystem as each block is read off the SSD.The normal read-write BIOSes will only boot Google-signed kernels, and only from the SSD. When you run the chromeos-firmwareupdate command above, you are replacing the primary read-write BIOS with a different one that will allow any self-signed kernel (refer to the Chromium OS Developer Guide ) to boot from either a removable device (by pressing Ctrl-U at the scary boot screen) or from the SSD (press Ctrl-D or wait 30 seconds).If you follow the full instructions from the Chromium OS Developer Guide , you will eventually end up with a bootable USB drive containing your image. You can boot that image directly from the USB drive as described above. Since it's your personal image, it should have shell access enabled. Log in as user "chronos" and runThat will wipe the SSD and install your image on it instead. When you reboot, it should attempt to boot your version. You'll still continue to see the scary boot screen at every boot, of course, as long as you are in developer mode and have the developer-mode BIOS installed, so you'll need to press Ctrl-D or wait 30 seconds to boot.To leave developer mode, simply flip the developer-mode switch back to the OFF position and reboot. One of two things will happen. If your chromebook still has a valid read-write normal-mode BIOS, Google-signed kernel, and an unmodified Chrome OS root filesystem, then that's what will boot and you'll be back running the official Chrome OS image. Or, if you've modified any part of the verified boot chain so that a full verified boot process isn't possible, you'll be dropped into recovery mode . That will require you to create a bootable USB key to restore your chromebook to its fresh-from-the-factory state. That's annoying, but not dangerous. As long as you haven't taken the device apart, you shouldn't be able to permanently break anything.In either case, all personal information will be wiped from the device during the transition.When the developer switch is on, the BIOS is not updated by any automatic Chrome OS updates. If you don't think you changed anything but you still end up in recovery mode, it may be that you've haven't applied a pending firmware update. Turn the developer switch back on, reboot, and from a root shell runThat will restore the primary read-write BIOS to normal mode, which may restore the verified boot process. Turn the developer switch off again and reboot. If you still end up in recovery mode, you'll just have to use the recovery process to fix it.

Recovery mode is a special boot operation in which the BIOS will:

Refuse to boot from the SSD



Prompt you to insert a recovery USB drive

Only boot a Google-signed image from the USB drive

You will encounter recovery mode when the BIOS is unable to find a valid kernel to boot, either because the SSD has become corrupted or (more likely) because you modified all the kernel partitions while in developer mode and have switched back to normal mode. While in developer mode, you will be presented with the scary boot screen at every boot. Pressing SPACE or RETURN will take you to recovery mode.

You can also force your chromebook into recovery mode (even in normal mode) by using the recovery mode button. On the bottom of the Samsung Series 5, on the corner nearest the developer switch, there is a tiny pinhole:

If you stick a paperclip into this hole, you'll feel it press a button. To force recovery mode, turn the device off, press this button, and while keeping it pressed, turn the device on again. This sometimes requires three hands or a bit of contortion, but you'll know it worked when you see the recovery screen instead of booting normally.

How to hard-reset the EC

You should never have to do this. If you think you need to and haven't been specifically instructed to do so by Google or Samsung, please contact one of those companies to tell them why.

The Samsung Series 5, like most portable computers, has a small embedded controller ("EC") inside it that controls things like battery charging, LEDs, fans, and so forth even when the device is turned off. The EC runs anytime that power is available, even battery power. In the extremely rare and unusual case that the EC needs to be reset, the only certain way is to remove power. But since the Samsung Series 5 battery is not removable, there is a battery disconnect button for this purpose. Unplug the AC, flip the device over, and use a paperclip to gently press the battery reset button through the hole on the back of the chromebook. Hold it down for a few seconds, then release it.