Hi,
It's been a while since I last posted, but now I think I have something to share with you. Those last months, I wasn't finding any interesting books to read and started to find my Kobo just ... boring. And I thought 'then maybe some hacking could be fun' and here I am with this guide. It will help you set up Alpine Linux with gcc, g++ or clang to develop custom applications for your Kobo. I didn't worked out how to run X yet, but maybe I will in the future. Then you could use them (if they are CLI apps) with https://github.com/llandsmeer/inkvt (thanks NiLuJe & Llandsmeer !)
So, how ?
Prerequisites
1. A Kobo with a fair amount of free space (ideally 3GB+). Preferably with kernel >3.0. I tested with my Glo HD and Libra and both worked (Glo HD has 3.0.35, Libra has 4.1).
2. A computer (or something you can ssh/telnet with).
3. NiLuJe's stuff (not mandatory, but is very useful for SSH) https://www.mobileread.com/forums/sh...d.php?t=254214
Let's start!
1. First, enable devmode on your Kobo. Fairly easy; just "search" devmodeon in your Kobo's search bar. It will add some games to your "Beta features" menu, but more importantly, it will give us entire access to the Kobo via telnet.
2. Check what IP your Kobo is using by going to Settings/Technical information.
3. Tap the WiFi icon at the top of the screen and leave the menu open. It will disable "wifi sleep" which could disrupt our telnet access. Note: you can also set up usbnet from there and then telnet via USB, with no interruptions.
4. In a Linux terminal/Telnet-able machine, type "telnet <IP>". E.g.
Log in as root. There's no password.
5. Check your Linux kernel version by typing in "uname -r". If it is less than 3.0, you may encounter problems.
6. Change directory to /mnt/onboard:
Here we will create a disk image. It's not possible to just dump a rootfs in the onboard partition because it is formatted in FAT32, and FAT32 doesn't like Linux very much (permission problems). So a disk image will help us circumvent this problem. Type in:
Note: the above command creates a 2G disk image. If your Kobo doesn't have the disk space required for that, you could change the "count" to 1024 or 512 for example, and you will get, respectively, a 1G and 512MB disk image.
7. Format the disk image. If your Kobo is from the future or has this capability, you *could* be able to format it in ext4 format natively by adding the "-t ext4" flag in the command line. However, mke2fs here only supports ext2, which is usable too, albeit older. So you could try to format a 2G image on your host system with an ext4 filesystem, then txz-compress it and extract it in your Kobo's storage. This didn't work in my Glo HD though, but did in my Libra. So we'll use the legacy way:
8. Mount the disk image. Here we'll use /mnt/user as a mountpoint, but you can mount it in another directory if you want.
This should run without errors. Then, change directory to the mountpoint:
and do a quick
to check if you see your mountpoint in the list, like that:
9. Ensure that your Kobo is connected to the Internet, then head over to https://alpinelinux.org/downloads/ and scroll down to the "Mini Root Filesystem" part, and right-click the green button with "armv7", then click on "Copy link location" or something like that.
On your Kobo:
(where the link should be replaced with the latest version available)
This should get the tar archive with the Alpine Linux filesystem on your disk image.
10. On your Kobo, we'll now get the tar archive extracted. Ensure you're still on your SSH/Telnet session and type:
Where the wildcard (*) could be replaced with the actual name of the tar archive.
11. Prepare the chroot. Type in:
This will bind your Kobo's existing /dev, /proc, /sys, /run contents to your Alpine Linux mounted disk image on /mnt/user. Therefore, you'll have greater flexibility when it comes to more hardware-based tasks or process monitoring. Also, we copy the resolv.conf file from the root filesystem to the Alpine disk image to be able to access the network from the chroot. You may need to re-copy this file later if your network info changes.
12. Chroot. Type in:
You should get in Alpine Linux. Congratulations !
13. Now, Alpine Linux comes with the holy grail: a package manager!, apk. First, try installing Nano:
If all goes well, you should be able to run it directly after, by simply typing in "nano". Isn't that great? :D
14. If you want to have a compiler, nothing is easier! Just type in:
or you can install clang instead if you prefer it to gcc/g++. You should now be able to compile! :) I successfully compiled binutils yesterday and "file" this morning. It's slow, but usable and it works well! If you want to go further, you could build gcc/g++ with gcc/g++, to obtain a fully optimized compiler (three-stage process: https://gcc.gnu.org/install/build.html), but the default binary works well.
15. Well, it's done! If you reboot your Kobo, you can think of adding the disk image to /etc/fstab so it is automatically mounted at startup, and set up an init script which mounts /dev, /sys, /run, etc. automatically.
I hope you enjoyed this! Let me know if it worked for you and ask questions if you want!
:)
Disclaimer: I am not responsible if you brick your Kobo with this technique, or if you lose files.
It's been a while since I last posted, but now I think I have something to share with you. Those last months, I wasn't finding any interesting books to read and started to find my Kobo just ... boring. And I thought 'then maybe some hacking could be fun' and here I am with this guide. It will help you set up Alpine Linux with gcc, g++ or clang to develop custom applications for your Kobo. I didn't worked out how to run X yet, but maybe I will in the future. Then you could use them (if they are CLI apps) with https://github.com/llandsmeer/inkvt (thanks NiLuJe & Llandsmeer !)
So, how ?
Prerequisites
1. A Kobo with a fair amount of free space (ideally 3GB+). Preferably with kernel >3.0. I tested with my Glo HD and Libra and both worked (Glo HD has 3.0.35, Libra has 4.1).
2. A computer (or something you can ssh/telnet with).
3. NiLuJe's stuff (not mandatory, but is very useful for SSH) https://www.mobileread.com/forums/sh...d.php?t=254214
Let's start!
1. First, enable devmode on your Kobo. Fairly easy; just "search" devmodeon in your Kobo's search bar. It will add some games to your "Beta features" menu, but more importantly, it will give us entire access to the Kobo via telnet.
2. Check what IP your Kobo is using by going to Settings/Technical information.
3. Tap the WiFi icon at the top of the screen and leave the menu open. It will disable "wifi sleep" which could disrupt our telnet access. Note: you can also set up usbnet from there and then telnet via USB, with no interruptions.
4. In a Linux terminal/Telnet-able machine, type "telnet <IP>". E.g.
Code:
telnet 192.168.0.1835. Check your Linux kernel version by typing in "uname -r". If it is less than 3.0, you may encounter problems.
6. Change directory to /mnt/onboard:
Code:
cd /mnt/onboardCode:
dd if=/dev/zero of=/mnt/onboard/alpine.img bs=1M count=20487. Format the disk image. If your Kobo is from the future or has this capability, you *could* be able to format it in ext4 format natively by adding the "-t ext4" flag in the command line. However, mke2fs here only supports ext2, which is usable too, albeit older. So you could try to format a 2G image on your host system with an ext4 filesystem, then txz-compress it and extract it in your Kobo's storage. This didn't work in my Glo HD though, but did in my Libra. So we'll use the legacy way:
Code:
mke2fs -F /mnt/onboard/alpine.imgCode:
mount /mnt/onboard/alpine.img /mnt/userCode:
cd /mnt/userCode:
df -hCode:
/dev/loop1 2047.7M 13.0K 2047.2M 0% /mnt/userOn your Kobo:
Code:
cd /mnt/user && wget https://dl-cdn.alpinelinux.org/alpine/v3.12/releases/armv7/alpine-minirootfs-3.12.3-armv7.tar.gzThis should get the tar archive with the Alpine Linux filesystem on your disk image.
10. On your Kobo, we'll now get the tar archive extracted. Ensure you're still on your SSH/Telnet session and type:
Code:
cd /mnt/user && tar -xvf alpine-minirootfs*.tar.gz11. Prepare the chroot. Type in:
Code:
mount -v --bind /dev /mnt/user/dev
mount -v --bind /dev/pts /mnt/user/dev/pts
mount -vt proc proc /mnt/user/proc
mount -vt sysfs sysfs /mnt/user/sys
mount -vt tmpfs tmpfs /mnt/user/run
cp /etc/resolv.conf /mnt/user/etc12. Chroot. Type in:
Code:
chroot /mnt/user /bin/sh13. Now, Alpine Linux comes with the holy grail: a package manager!, apk. First, try installing Nano:
Code:
apk add nano14. If you want to have a compiler, nothing is easier! Just type in:
Code:
apk add gcc g++15. Well, it's done! If you reboot your Kobo, you can think of adding the disk image to /etc/fstab so it is automatically mounted at startup, and set up an init script which mounts /dev, /sys, /run, etc. automatically.
I hope you enjoyed this! Let me know if it worked for you and ask questions if you want!
:)
Disclaimer: I am not responsible if you brick your Kobo with this technique, or if you lose files.