Kobo Tolino E Bookreader branches and status

Table of Contents Compile Branches Kernel status Booting via fastboot on vendor boot (to test things without installing the kernel in flash) starting fastboot via serial console Kobo Clara HD Kobo Libra H2O Tolino Shine 2 HD Tolino Vision 5 Upstreaming

Compile

make CROSS_COMPILE=arm-linux-gnueabihf- ARCH=arm kobo_defconfig zImage modules dtbs

installation notes (currently only for Kobo Clara HD): see https://misc.andi.de1.cc/kobo

Branches

• kobo/base: last mainline release merged with kobo_defconfig and stuff accepted by upstream
• kobo/touchscreen-simplified-X.Y: cyttsp5 touchscreen with basic features (no proximity, no buttons, etc. but multitouch), probably easier for upstreaming
• kobo/touchscreen-X.Y: cyttsp5 touchscreen with full features
• kobo/battery-X.Y: battery/charger driver
• kobo/epdc-vX.Y: EPDC + PXP + EPDC-PMIC: everything needed for displaying things
• kobo/merged-X.Y: feature branches merged together
• kobo/epdc-drm-X.Y: EPDC via drm subsystem (will be polished for upstreaming)
• kobo/drm-merged-X.Y: feature branches merged together with the drm variant

Kernel status

Version marks the kernel version where things have arrived upstream

-	Kobo Clara HD	Tolino Shine 3	Tolino Shine 2 HD	Kobo Libra H2O	Tolino Vision 5
SoC	IMX6SLL	IMX6SoloLite	IMX6SoloLite	IMX6SLL	IMX6SoloLite
basic devicetree mainlined	v5.5: imx6sll-kobo-clarahd.dtb	v5.6: imx6sl-tolino-shine3.dtb	v5.10: imx6sl-tolino-shine2hd.dtb	v5.16: imx6sll-kobo-librah2o.dtb	v5.16: imx6sl-tolino-vision5.dtb
Buttons	v5.6	v5.6	v5.10	v5.16	v5.16
LEDs	v5.5	v5.6	v5.10	v5.16	v5.16
Frontlight	v5.5: lm3630a	v5.6: lm3630a	v5.13: ntxec (2)	v5.16: lm3630a (1)	v5.16: lm3630a (1)
Touchscreen	working: cyttsp5	working: cyttsp5	v5.10	cyttsp5	cyttsp5
Battery status	v5.10: rc5t619 (rn5t618)	v5.10: rc5t619 (rn5t618)	v5.10: rc5t619 (rn5t618)	rc5t619 (rn5t618)	rc5t619 (rn5t618)
RTC	v5.8: rc5t619	v5.8: rc5t619	v5.10: rc5t619	v5.16: rc5t619	v5.16: rc5t619
EPD	working: mxc_epdc_v2_fb	working: mxc_epdc_fb / mxc_epdc_drm	working: mxc_epdc_fb / mxc_epdc_drm	WIP	WIP
Wifi	out-of-tree: rtl8189fs	out-of-tree: rtl8189fs	v5.10: brcmfmac / out-of-tree rtl8189fs depending on board revision	out-of-tree: rtl8189fs	out-of-tree: rtl8189fs
suspend/resume wakeup	ok	(3)	(3)	ok	(3)

(1) cold backlight needs higher overvoltage protection setting which is not configurable via existing driver

(2) backlight is available via pwm interface, boost pin not implemented

(3) only shallow sleep with vendor u-boot, no wakeup from deep sleep, with newer u-boot from https://github.com/akemnade/u-boot-fslc no problems seen, calling imx_gpc_pre_suspend(true) starts the trouble

Booting via fastboot on vendor boot (to test things without installing the kernel in flash)

hint: depending on fastboot version, running it as root reduces races with permission settings.

starting fastboot via serial console

- press a key in your terminal programm to enter uboot commandline while booting.

- enter fastboot (for mx6sl-based devices which have an older u-boot) or fastboot 0 (for mx6sll-based devices which have a newer u-boot)

Kobo Clara HD

Configure commandline via kernel, set CONFIG_CMDLINE_FORCE (not required if kernel is loaded from µSD)

mkbootimg --base 0x84800000 --kernel arch/arm/boot/zImage  --second arch/arm/boot/dts/imx6sll-kobo-clarahd.dtb -o clara.img
fastboot boot clara.img (possibly as root)

turn on device via power button, bootloader will activate fastboot if power button is still pressed.

Kobo Libra H2O

Configure commandline via kernel, set CONFIG_CMDLINE_FORCE (not required if kernel is loaded from µSD)

mkbootimg --base 0x84800000 --kernel arch/arm/boot/zImage  --second arch/arm/boot/dts/imx6sll-kobo-librah2o.dtb -o libra.img
fastboot boot libra.img (possibly as root)

press page down while turning on device, bootloader will activate fastboot.

Tolino Shine 2 HD

Make sure

CONFIG_ARM_APPENDED_DTB=y 
CONFIG_ARM_ATAG_DTB_COMPAT=y
CONFIG_ARM_ATAG_DTB_COMPAT_CMDLINE_FROM_BOOTLOADER=y

are set.

append devicetree to kernel image and create fastboot image:

cat arch/arm/boot/zImage arch/arm/boot/dts/imx6sl-tolino-shine2hd.dtb >img
mkbootimg --base 0x80800000 --kernel img  --cmdline "$CMDLINE" -o shine2.img
fastboot boot shine2.img

press frontlight button while powering on.

Tolino Vision 5

Make sure

CONFIG_ARM_APPENDED_DTB=y 
CONFIG_ARM_ATAG_DTB_COMPAT=y
CONFIG_ARM_ATAG_DTB_COMPAT_CMDLINE_FROM_BOOTLOADER=y

are set.

append devicetree to kernel image and create fastboot image:

cat arch/arm/boot/zImage arch/arm/boot/dts/imx6sl-tolino-vision5.dtb >img
mkbootimg --base 0x80800000 --kernel img  --cmdline "$CMDLINE" -o vision5.img
fastboot boot vision5.img

Pressing the power button for around 30 seconds enables fastboot.

Upstreaming

• v5.16: Devicetrees for Kobo Libra H2O and Tolino Vision 5
• v5.15: Vusb voltage_now sysfs property
• v5.14: input current limit USB/ADP, charger type detection, IRQ races for RTC/charger
• v5.13: PWM (for backlight) for Tolino Shine 2 HD
• v5.12: second uart