MobileRead Forums - View Single Post

jssp · 07-07-2024, 01:04 PM

Hi there,

I wanted to share my experience getting koreader working on my BQ Cervantes Touch Light reader. According to the original post of this thread, it's not 100% supported and I have definitely found some problems to make it work. However, I have a pretty functional version of the software working and I thought it could be a good idea to share.

Step 1: Unlocking the device. The first step involves installing the developers firmware. The BQ Cervantes Touch Light has it's firmware in a hidden sd card, only accessible by disassembling the device. You'll need to pry open the plastic case, which is REALLY difficult to do without breaking it as the plastic is really brittle. Mine got broken in 3 parts, but I was able to put everything back together with the help of some glue (the kind used for mobile phone repairs). Once you get access to the mainboard behind the screen, there is a 4gb micro sd card. Simply remove it and connect it to your main computer using an SD reader. Partition 5 in this SD is the one that gets mounted in /mnt/private. You will have to mount it in your computer and create an empty file "hackers_ok" to enable the developers firmware to be flashed. Just create this empty file, and install the sd card back in the ereader. You can also copy the rest of the files needed for the installation while you have this sd card mounted on your main computer, but it's not strictly needed.

Some relevant information:
- The dev firmware is still available for download from the archive.org link here.
- For Cervantes Touch Light the latest version available is 5.2.0.
- The ko-deps archive contains a corrupted iproute package. There are links posted in this thread to alternatives, these should work fine.
- In order to flash the dev firmware you'll need to switch off the reader, and switch it on again while pressing the "home" button. Or at least, this is what worked for me.

Step 2: Install Koreader. Once the dev firmware is installed, simply go to settings and enable telnet access. You can connect via wifi using a standard telnet client. Follow this instructions in the first post of this thread to install all the necessary files under /mnt/private

Step 3: Fix Wifi. Once koreader is installed, the main issue I found was the inability to connect to Wifi. After some hours of debugging and reading about connman, wpa_supplicant, and wifi drivers in linux I found out that the Cervantes scripts in koreader try to load a wifi driver that is not correct for the touch light version. This can be observed in line 11 of /mnt/private/koreader/enable_wifi.sh. The script tries to load module "8189fs", but the correct module to load is "dhd". Another change is necessary when loading the wpa_supplicant command, "-D wext" needs to be changed to "-D nl80211". With these two changes wifi does work again. The disable_wifi.sh script needs to be changed as well to unload the right wifi driver.

Your enable_wifi.sh should look something like this:

Code:

#!/bin/sh

# Debian Wheezy ships an old wpa_supplicant binary (1.0.3). Please refer to
# https://manpages.debian.org/wheezy/wpasupplicant/wpa_supplicant.8.en.html
# to see which command line options are available.

# Do not run this script twice (ie: when no wireless is available or wireless
# association to ap failed.
./disable-wifi.sh

if ! lsmod | grep -q dhd; then
    modprobe dhd
    sleep 1
fi

ifconfig eth0 up
sleep 1

wpa_supplicant -i eth0 -C /var/run/wpa_supplicant -B -D nl80211 2>/dev/null

I hope at least someone will find this information useful. Koreader gives a new life to this old reader.

Best regards!

07-07-2024, 01:04 PM	#73
jssp Junior Member Posts: 1 Karma: 91984 Join Date: Jul 2024 Device: BQ Cervantes Touch Light	Making Cervantes Touch Light Great Again Hi there, I wanted to share my experience getting koreader working on my BQ Cervantes Touch Light reader. According to the original post of this thread, it's not 100% supported and I have definitely found some problems to make it work. However, I have a pretty functional version of the software working and I thought it could be a good idea to share. Step 1: Unlocking the device. The first step involves installing the developers firmware. The BQ Cervantes Touch Light has it's firmware in a hidden sd card, only accessible by disassembling the device. You'll need to pry open the plastic case, which is REALLY difficult to do without breaking it as the plastic is really brittle. Mine got broken in 3 parts, but I was able to put everything back together with the help of some glue (the kind used for mobile phone repairs). Once you get access to the mainboard behind the screen, there is a 4gb micro sd card. Simply remove it and connect it to your main computer using an SD reader. Partition 5 in this SD is the one that gets mounted in /mnt/private. You will have to mount it in your computer and create an empty file "hackers_ok" to enable the developers firmware to be flashed. Just create this empty file, and install the sd card back in the ereader. You can also copy the rest of the files needed for the installation while you have this sd card mounted on your main computer, but it's not strictly needed. Some relevant information: - The dev firmware is still available for download from the archive.org link here. - For Cervantes Touch Light the latest version available is 5.2.0. - The ko-deps archive contains a corrupted iproute package. There are links posted in this thread to alternatives, these should work fine. - In order to flash the dev firmware you'll need to switch off the reader, and switch it on again while pressing the "home" button. Or at least, this is what worked for me. Step 2: Install Koreader. Once the dev firmware is installed, simply go to settings and enable telnet access. You can connect via wifi using a standard telnet client. Follow this instructions in the first post of this thread to install all the necessary files under /mnt/private Step 3: Fix Wifi. Once koreader is installed, the main issue I found was the inability to connect to Wifi. After some hours of debugging and reading about connman, wpa_supplicant, and wifi drivers in linux I found out that the Cervantes scripts in koreader try to load a wifi driver that is not correct for the touch light version. This can be observed in line 11 of /mnt/private/koreader/enable_wifi.sh. The script tries to load module "8189fs", but the correct module to load is "dhd". Another change is necessary when loading the wpa_supplicant command, "-D wext" needs to be changed to "-D nl80211". With these two changes wifi does work again. The disable_wifi.sh script needs to be changed as well to unload the right wifi driver. Your enable_wifi.sh should look something like this: Code: #!/bin/sh # Debian Wheezy ships an old wpa_supplicant binary (1.0.3). Please refer to # https://manpages.debian.org/wheezy/wpasupplicant/wpa_supplicant.8.en.html # to see which command line options are available. # Do not run this script twice (ie: when no wireless is available or wireless # association to ap failed. ./disable-wifi.sh if ! lsmod \| grep -q dhd; then modprobe dhd sleep 1 fi ifconfig eth0 up sleep 1 wpa_supplicant -i eth0 -C /var/run/wpa_supplicant -B -D nl80211 2>/dev/null I hope at least someone will find this information useful. Koreader gives a new life to this old reader. Best regards!