2013-03-23 22:22:34 +01:00
|
|
|
Documentation of RescueOS
|
|
|
|
=========================
|
|
|
|
RescueOS is a rescue solution for the Nokia N900, distributed
|
|
|
|
as an initrd image. It has several features, most
|
|
|
|
notable:
|
|
|
|
|
|
|
|
mounting maemo /
|
|
|
|
EMMC access(can mount maemo home and MyDocs partition)
|
2015-03-31 23:18:45 +02:00
|
|
|
Lock code reset
|
2013-03-23 22:22:34 +01:00
|
|
|
WiFi support
|
|
|
|
USB mass-storage mode
|
|
|
|
USB networking
|
|
|
|
Battery charging
|
|
|
|
|
|
|
|
Users must be familiar with the Linux console.
|
|
|
|
|
|
|
|
This project is _NOT_ the meego rescue initrd.
|
|
|
|
|
2013-09-15 22:00:24 +02:00
|
|
|
|
2013-03-23 22:22:34 +01:00
|
|
|
How does it work?
|
|
|
|
~~~~~~~~~~~~~~~~~
|
|
|
|
The flasher utility loads rescueOS. This makes it unnecessary
|
2013-03-24 12:14:43 +01:00
|
|
|
to modify the bootloader or maemo's /sbin/preinit like other solutions do.
|
2013-03-23 22:22:34 +01:00
|
|
|
|
|
|
|
By using the "-l" option, we do not flash the kernel or initrd image.
|
|
|
|
It only loads the kernel into RAM. No modification on
|
|
|
|
the NAND or bootloader happens.
|
|
|
|
|
|
|
|
|
2013-06-23 01:57:05 +02:00
|
|
|
Use cases
|
2013-03-23 22:22:34 +01:00
|
|
|
~~~~~~~~
|
2013-06-23 01:57:05 +02:00
|
|
|
In fact, most users do not need it. Either way, possible use cases:
|
2013-03-23 22:22:34 +01:00
|
|
|
|
|
|
|
-Changing typos in bootscripts which prevent an operation system
|
2013-06-23 01:57:05 +02:00
|
|
|
(e.g. maemo) to boot.
|
2013-03-23 22:22:34 +01:00
|
|
|
|
2013-06-23 01:57:05 +02:00
|
|
|
-Creating a backup of files before starting a reflash. But should have existed
|
|
|
|
anyway, correct?
|
2013-03-23 22:22:34 +01:00
|
|
|
|
|
|
|
-Charging the battery (when maemo is dead).
|
|
|
|
|
|
|
|
-Modification of the EMMC partitions and partition table.
|
|
|
|
|
2013-06-23 01:57:05 +02:00
|
|
|
-Backing up & Restoring maemo rootfs.
|
2013-03-23 22:22:34 +01:00
|
|
|
|
|
|
|
-fsck file system checks
|
|
|
|
|
2015-03-31 23:18:45 +02:00
|
|
|
-Resetting the lock code (without reflashing)
|
|
|
|
|
2013-03-23 22:22:34 +01:00
|
|
|
-and more...
|
|
|
|
|
2015-04-05 03:20:36 +02:00
|
|
|
Booting RescueOS
|
2013-03-23 22:22:34 +01:00
|
|
|
~~~~~~~~~~~~~~~
|
2013-06-23 01:57:05 +02:00
|
|
|
Note: You can not store persistent data in / as everything happens in RAM. Of
|
|
|
|
course, it becomes possible when you mount the EMMC or sd card on the
|
|
|
|
corresponding mountpoint.
|
2013-03-23 22:22:34 +01:00
|
|
|
|
2013-06-23 01:57:05 +02:00
|
|
|
Note: It comes without any promises and without any warranty. Therefore you
|
|
|
|
are doing everything at your own risk.
|
|
|
|
|
2015-04-05 03:20:36 +02:00
|
|
|
To load RescueOS onto an N900, you'll need a USB data cable, a PC, and one of
|
|
|
|
the following flashers:
|
2013-03-23 22:22:34 +01:00
|
|
|
|
2015-04-05 03:20:36 +02:00
|
|
|
- 0xFFFF - the Open Free Fiasco Firmware Flasher
|
|
|
|
Free/open source, but only runs on GNU/Linux.
|
|
|
|
Packaged for Ubuntu and Debian as '0xffff':
|
|
|
|
http://packages.ubuntu.com/source/0xffff
|
|
|
|
https://packages.debian.org/sid/0xffff
|
|
|
|
Discussion: http://talk.maemo.org/showthread.php?t=87996
|
|
|
|
Source repo: https://github.com/pali/0xFFFF
|
|
|
|
|
|
|
|
- maemo_flasher v3.5 - the original proprietary flasher from Nokia
|
|
|
|
Windows, MacOS, GNU/Linux
|
|
|
|
Official distribution site is gone. Archive copies at:
|
|
|
|
https://web.archive.org/web/20131117084237/http://skeiron.org/tablets-dev/maemo_dev_env_downloads/
|
|
|
|
Documentation:
|
|
|
|
http://wiki.maemo.org/Documentation/Maemo_5_Developer_Guide/Development_Environment/Maemo_Flasher-3.5
|
|
|
|
|
|
|
|
Switch the N900 completely off. If it is plugged into a charger, a PC, or
|
|
|
|
anything else by its USB port, unplug it and wait about 10 seconds to give the
|
|
|
|
charger software time to shut down. Don't connect it to the PC just yet.
|
|
|
|
|
|
|
|
Startup the flasher and get it ready to load RescueOS. For 0xFFFF, the
|
|
|
|
incantation is:
|
|
|
|
|
|
|
|
0xFFFF -m kernel:zImage -m initfs:rootfs.cramfs -l -b 'rootdelay root=/dev/ram0'
|
|
|
|
|
|
|
|
For maemo_flasher, it's:
|
|
|
|
|
|
|
|
flasher-3.5 -k zImage -n rootfs.cramfs -l -b"rootdelay root=/dev/ram0"
|
|
|
|
|
|
|
|
You'll get a message like "suitable device not found...", but the flasher
|
|
|
|
should block and wait. Now connect the N900 to the PC with the data cable; the
|
|
|
|
flasher should detect the device, upload RescueOS, launch it, and then exit.
|
2013-03-23 22:22:34 +01:00
|
|
|
|
|
|
|
|
|
|
|
~~~~~~~~~~~~~~~
|
|
|
|
How to use it
|
|
|
|
~~~~~~~~~~~~~~~
|
|
|
|
It boots and you get a bash shell.
|
|
|
|
|
|
|
|
The folder /rescueOS/ contains some scripts for various tasks. Not all of them
|
|
|
|
are completed yet. They help you with the usual stuff, e.g. mass-storage
|
|
|
|
mode, maemo root mounting, usbnetworking, WiFi setup etc.
|
|
|
|
|
|
|
|
Mounting maemo root
|
|
|
|
-------------------
|
|
|
|
/rescueOS/mount-maemo-root.sh
|
|
|
|
This scripts mounts the maemo root to /mnt/maemo.
|
|
|
|
|
|
|
|
/rescueOS/umount-maemo-root.sh
|
|
|
|
|
2015-03-31 23:18:45 +02:00
|
|
|
Lock code reset
|
|
|
|
---------------
|
|
|
|
code_reset
|
|
|
|
# This will set the lock code back to the default ('12345').
|
|
|
|
|
2013-03-23 22:22:34 +01:00
|
|
|
USB Networking
|
|
|
|
-------------
|
|
|
|
/rescueOS/usbnetworking-enable.sh
|
|
|
|
Sets up USB networking in the following way:
|
|
|
|
ifconfig usb0 192.168.2.15 up
|
|
|
|
ifconfig usb0 netmask 255.255.255.0
|
|
|
|
route add 192.168.2.14 usb0
|
|
|
|
|
|
|
|
To disable it: /rescueOS/usbnetworking-disable.sh
|
|
|
|
|
|
|
|
USB Mass-Storage mode
|
|
|
|
--------------------
|
|
|
|
/rescueOS/mass-storage-enable.sh
|
2013-03-24 12:14:43 +01:00
|
|
|
Makes the first 2 EMMC partitions available for the mass-storage
|
|
|
|
mode. Known as /home/ and /home/user/MyDocs inside maemo.
|
2013-03-23 22:22:34 +01:00
|
|
|
|
|
|
|
/rescueOS/mass-storage-disable.sh: Deactivates mass-storage mode.
|
|
|
|
|
|
|
|
WiFi support
|
|
|
|
------------
|
|
|
|
It has wpa_supplicant, but without EAP support. This should be ok for
|
|
|
|
most home networks which use a PSK.
|
|
|
|
|
|
|
|
Give the following a try:
|
|
|
|
|
2013-03-24 12:14:43 +01:00
|
|
|
wpa_passphrase [essid] [password] > /run/wlan.conf
|
2013-03-23 22:22:34 +01:00
|
|
|
sh /rescueOS/setup-wpa-wifi.sh
|
|
|
|
|
2013-03-24 12:14:43 +01:00
|
|
|
For DHCP:
|
2013-03-23 22:22:34 +01:00
|
|
|
|
2013-03-24 12:14:43 +01:00
|
|
|
udhcpc -i wlan0.
|
2013-03-23 22:22:34 +01:00
|
|
|
|
|
|
|
Battery charging
|
|
|
|
----------------
|
|
|
|
By using ShadowJK's charge21 script. Use it only with the wallcharger,
|
|
|
|
as it pulls 950 mA, and USB is not designed for that
|
|
|
|
(some ports can do it though, don't try if in doubt.)
|
|
|
|
|
|
|
|
/rescueOS/charge21.bash
|
|
|
|
|
|
|
|
Shutdown
|
|
|
|
--------
|
|
|
|
poweroff
|
|
|
|
|
|
|
|
Root password
|
|
|
|
-------------
|
|
|
|
rootme
|
|
|
|
|
2013-06-23 01:57:05 +02:00
|
|
|
How to transfer files
|
|
|
|
=====================
|
|
|
|
It asks you on boot whether an FTP Server should be started.
|
|
|
|
This will have anonymous up and download permissions everywhere.
|
|
|
|
Then you can connect to it once USB networking or a WLAN connection
|
|
|
|
has been established, using any FTP client. For downloads, most browsers
|
|
|
|
can be used.
|
|
|
|
|
|
|
|
Alternatively, use mass-storage mode.
|
2013-03-23 22:22:34 +01:00
|
|
|
|
2013-09-15 22:00:24 +02:00
|
|
|
Contributions and suggestions are welcome. Write to me (NIN101 on freenode or TMO. E-Mail: n900-rescueos at quitesimple period org).
|