OpenInkpot 0.2 Installation Guide
What device do I have?
Hanlin V3 looks like this (logo and labels on keys may be different):
There are two variations of the device, dubbed V3 (with 64mb of internal memory) and V3ext (with 512mb of internal memory). All new devices are V3ext, so unless you bought your device in early 2008, you should have V3ext.
If you are in doubt, attach your device to a PC and have a look at size of disk which is exported as mass storage. It should be ~9mb for the V3 and ~500mb for the V3ext.
Hanvon N510/N516 looks like this (again, the logo and labels on keys may be different):
There are no known variants of N510/N516.
Hanlin v3 and v3ext
BEWARE: Updating to this version will cause your internal storage for the books to be reformatted, so backup first! The format may take up to 10 minutes during the first boot, so be patient. Reverting back to the original firmware will require reformatting the partition back — just attach the device to PC after reflashing, and format disk to FAT. If you already have OpenInkpot, your books will be preserved.
There are two installation methods.
This method completely replaces the original firmware with OpenInkpot. This is recommended for the users who want to switch to OpenInkpot and avoid using the original firmware at all. This method works for restoring the original firmware as well, if necessary.
- Download the firmware file ("v3-install" is for V3, "v3ext-install" is for V3ext — see above to detect which one you have).
- Unpack to obtain the V3update.bin file
- Copy this file to the root directory of the SD card. Use plain SD formatted with FAT16 - SDHC, MMC, and FAT32 cards won't work. The bootloader is not able to address beyond 1Gb, so either use a card with less than 1Gb storage, or make sure whole file is in first 1Gb of card (e.g. by formatting it). For Windows users the best way to format the SD card is with the tool provided by SDcard.org.
- Insert this card to the e-book.
- Press the + button on the right side of device and hold it.
- Reboot (press the button in the small hole at the back of the device using a needle or another sharp item) or power on the device (press the power button while the device is powered off).
- Release the + button after the sound signal.
- Follow the instructions on screen.
- If there is any problem (like file not found) most likely it is due to the above restrictions. Please carefully check them again. In addition check the filename (it has to be "V3update.bin"). Additionally, the bootloader is very picky concerning the specific formatting of SD cards. It may be necessary to use an completely empty SD card and/or to reformat the card with the SDcard.org tool and/or to low-level format it with the HDDGuru's low level formatter and then put a file system on the whole card (e.g. with mkdosfs) and/or to create a partition first. Even then some cards may work and some may not.
Note that first boot might be quite long due to storage reformatting and fontconfig caches generation. It's normal, and subsequent reboots will be much faster.
This method boots OpenInkpot from the original firmware. All changes are saved to 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 eject SD card while OpenInkpot is running from it. Also, OpenInkpot is little unstable in the live version at the moment, unlike the flashed version.
- Download the firmware file (single file for both 64mb and 512mb versions).
- Unpack it to the SD card.
- Insert the SD card and run the boot-OI-v3.exe file.
All changes made during the session (history of files, current position in directory) will be saved to root.fs file in openinkpot directory. You can use the same image on many devices.
BEWARE: a method to restore original firmware is not yet discovered.
ALSO BEWARE: There is a new version of Hanvon N516 for which this procedure does not work. You will probably render your device unusable, until support for the new version of N516 is supported.
The easiest way to get OpenInkpot on the N510/N516 is to buy the "Azboka N516" from Azbooka, which comes with OpenInkpot preloaded.
If you have an N510/N516 with another firmware, proceed as follows:
- Get a PC with Windows (yep, we know it sucks - but there is no working Linux USBboot client for N510/N516 yet. Fortunately further updates do not need anything beyond the device itself).
- Download flashimage firmware and unpack it.
- Proceed as described in README inside.
Note that first boot after reflashing might be quite long due to fontconfig caches generation. It's normal, subsequent reboots will be much faster.
This method is suitable only if you have OpenInkpot installed on your N510/N516 already. See the previous section for reflashing device for a first time.
- Download update or reinstall firmware (update updates kernel and userspace, reinstall reinstalls everything, including bootloader and user area, completely wiping settings, saved history and lastread positions in files).
- Unpack archive and put the .oifw file on the root of SD card.
- Put the SD card in the device.
- Power off the device and then power it on.
- When press any key to start update text is displayed on screen, press any key. There are Azbooka N516 devices with older bootloader installed on factory which does not have such indication. You'll need to press "menu" key while blue led light is switching on->off during boot. It's easy to miss, so keep watching.
- The update menu will be displayed.
- Press the button corresponding to the firmware you've put on the SD card.
- Wait until the reflashing is finished (several minutes).
It is advisable to recharge the battery before updating. If device turns off while rewriting the bootloader, you will have to use the "first-time installation" method to unbrick the device.
Note that first boot might be quite long due to fontconfig caches generation. It's normal, subsequent reboots will be much faster.