postmarketOS

nokia rx51 (Nokia N900)

Contributors

MartijnBraam
craftyguy

What works

Booting the system
Kernel log to the display
Framebuffer graphics
Unlocking the root partition using the keyboard
Display Backlight control
Wayland on framebuffer
Module loading
Wifi (see Additional Info below)
Notification led
Audio playback
Keyboard backlight (see Additional Info below)
Battery capacity reporting (see Additional Info below)

What does not work

Virtual terminal keymap is incorrect, the shift key doesn't allow entering numbers
Both cameras

Additional info

Martijn's N900 has uboot installed a long time ago, I'm using sdcard boot from the bootmenu shell using run sdboot
The Neo900 (still in development) will upgrade the hardware inside of the N900, and has some nice features such as hardware sandboxing the modem.

Wifi

The linux-firmware package is required to provide the wl1251 firmware necessary for initializing the wifi device. (#158)

Once the device has been successfully initialized, enable it:

$ sudo ip link set wlan0 up
$ sudo iw wlan0 set type managed

Configure wpa_supplicant (only necessary on encrypted networks):

$ sudo su -
# wpa_passphrase $YOUR_SSID > /etc/wpa_supplicant/wlan0.conf
<enter passphrase here and press Enter>
# exit

Connect to network using wpa_supplicant:

$ sudo wpa_supplicant -Dwext -i wlan0 -c /etc/wpa_supplicant/wlan0.conf

If your network uses DHCP, start the DHCP client:

$ sudo udhcpc -i wlan0

Keyboard Backlight

There are 6 keyboard backlight LEDs that can be adjusted, they are found under /sys/class/leds/lp5523:kb{1-6}. To adjust brightness, write a value, $VAL between 0 and 255, to the brightness parameter as the root user:

for i in $(seq 1 6);
    do echo $VAL > /sys/class/leds/lp5523\:kb$i/brightness
done

Boot partition within postmarketos

The boot partition can be accessed within postmarketos by mounting /dev/dm-0. This allows performing kernel updates by installing the linux-nokia-rx51 apk after mounting /dev/dm-0 to /boot.

Display

With DRM enabled (#197), the display can be managed at this location: /sys/devices/platform/omapdrm.0/graphics/fb0/

Keyboard layout in console

In order to set the keyboard layout for the virtual console (e.g. to take advantage of number keys on the N900 keyboard), obtain your desired language keymap file for the RX-51, such as this one.. (TODO: Need to pull 'official' vconsole keymaps from Maemo5 if they exist..).

On the N900, install kbd-bkeymaps, either by using pmbootstrap install --add kbd-bkeysmaps on the host system or by running apk add kbd-bkeysmaps on the device itself.

The keymap must be in binary format, bmap. This can be accomplished using the loadkeys tool:

$ apk add kbd kbd-bkeymaps
$ loadkeys -b rx51_us.map > rx51_us.bmap
$ gzip rx51_us.bmap

Compress it and copy it to /usr/share/bkeymaps/us/ on the N900.

Log into the N900, and run sudo setup-keymap, then select us and finally rx51_us.

Battery Capacity Reporting

The current battery capacity can be found under /sys/class/power_supply/bq27200-0/capacity, and is represented as a percentage. For example, a value of 11 equates to 11%. If capacity does not exist or contains erroneous information, then your battery needs to be calibrated first. To calibrate the battery:

1) Charge it up fully, using a wall power adapter.

2) Once it is charged up, power on the device

3) Unplug the device and allow the battery to run all the way down until it powers off. This may take quite a while to happen (>24hrs, but can be made shorter by running a CPU intensive workload)

4) When device powers off, plug it back into wall adapter and allow to charge up fully again. The battery and charging chip should now be calibrated.