OpenInkpot 0.1 Installation Guide

Supported Hardware

v3 reader, both 64mb (v3) and 512mb (v3ext) models.

Hanlin v3 and v3ext

There are three installation methods.

Flashing firmware

This method completely replaces original firmware with OpenInkpot one. This is recommended for the users who want to switch to OpenInkpot and avoid using original firmware at all.

1. Download the firmware file ("v3" is for 64mb version, "v3ext" is for 512mb one).
2. Unpack to obtain the V3update.bin file
3. Copy this file to the root directory of SD card. Use plain SD - SDHC and MMC cards won't work. Bootloader also isn't capable to address beyond 1Gb, so either use card <= 1Gb, or make sure whole file is in first 1Gb of card.
4. Insert this card to the e-book
5. Press the + button on the right side of device and hold it.
6. Reboot (press button at the back of device in small hole using needle or another sharp item) or power on the device (press the power button while device is powered off).
7. Release the + button after the sound signal.
8. Follow the instructions on screen.

OI-on-SD (live)

This method boots OpenInkpot from the original firmware. All changes are saved in the file on SD card. This is recommended for the users who want to try OpenInkpot or still have to use original firmware for something. This method has one obvious limitation: you can't remove SD card while OpenInkpot is running from it.

1. Download the firmware file (single file for both 64mb and 512mb versions).
2. Unpack it to the root directory of SD card (keep the openinkpot directory).
3. Insert SD card and run openinkpot/boot-OI-v3.exe file.

All changes made during the session (history of files, current position in directory) will be saved in root.fs file in openinkpot directory. You can use the same image on different V3 devices.

NFS root

This method boots OpenInkpot from the network. This is recommended for developers who want to have easy way to debug applications on V3. This is not recommended for end users. Nfsroot may boot both from original firmware and from installed OpenInkpot.

Preparing:

1. Get the oi-hanlin-v3-nfsroot archive.
2. Make sure you're using kernel NFS server (userspace NFS does not work due to unclear reasons).
3. Create directory /srv/nfs/openinkpot-root and unpack archive to this directory.
4. Add the next line to /etc/exports:

   /srv/nfs/openinkpot-root  192.168.111.1(rw,async,no_root_squash,no_subtree_check)
   

5. Reload NFS server settings (and make sure your portmap listens on the usb0 interface)

Booting from original firmware:

1. Get all files from here and reloaded.ko from here and put them to root of SD card.
2. Insert SD card ond run nfsboot file.

Booting from OpenInkpot:

1. Get zImage from here and put it to root of SD card.
2. Insert card to device.
3. ssh to the device and run

   kexec -l /mnt/zImage
   kexec -e