Hi everyone,
since some people are getting their first MNT Pocket Reforms a tiny bit quicker than expected, and our handbook is not yet finished, I’m collecting some crucial info here until the book is out:
Powering On/Off, OLED Menu, Standby Switch, Ports
First of all, the Quickstart manual covers turning it on and off, and safety. This is included in paper form as well:
Most importantly: The OLED menu in the keyboard can be accessed by pressing Hyper (diagonal arrow key) and Enter.
The standby power switch (as seen in Quickstart manual) can also be used as an emergency reset function because it will power cycle the system controller, in case things are really stuck.
Read before Installing Stuff with APT
Some packages appear to pull in a kernel upgrade. But unfortunately, this doesn’t automatically install the matching WiFi driver package reform-qcacld2
.
Update 2024-05-28: We published an update to the reform-qcacld2
which installs a self-update hook in /etc/kernel/postinst.d
which alleviates this problem. To make sure you have the updated package, we recommend to apt update
and then apt upgrade
after you connect MNT Pocket Reform to the network initially.
Otherwise, if a kernel update is pulled in, you won’t be able to connect to WiFi and will need USB/Bluetooth/Ethernet (or a MicroSD bootdisk) to get it back. We’re working on an automatic hook to fix this.
Keyboard Combos
Then, you’ll need to know about some keyboard combos, i.e. how to get F-keys and curly braces etc for programming. We covered this in a Crowd Supply post here:
There’s an outdated piece of info there: The device is not turned on/off by pressing Hyper+Space, but you can turn it on by holding the menu key combo for 2 seconds (Hyper+Enter
), or by dialing “Power On” in the OLED menu. Powering off should be done via normal Linux tools (in the 3 dots menu on a desktop or via systemctl poweroff
). If you are stuck due to a crash etc, you can hard power off in the OLED menu.
Keyboard Backlight Color/Brightness
Hold Hyper
and roll the trackball!
Screen Brightness
You can regulate brightness with the combos:
Hyper+Super+1
(darker)Hyper+Super+2
(brighter)
Desktops and their Shortcuts
On the software side, MNT Pocket Reform’s Debian Linux based system is almost identical to that of MNT Reform, so this guide applies, especially the keyboard shortcuts and config options for Sway and Wayfire (as well as the chapters Linux Console Basics and Software):
https://mntre.com/reform2/handbook/desktops.html
USB-C PD Debugging
If something doesn’t work with a particular USB-C PD power supply (so far we tested successfully Anker, Ugreen, Apple and of course the official CUI supply), you can get a bit of debugging info by listening to the output of the on-board RP2040 system controller. You can do this in the Linux console by entering sudo tio /dev/ttyACM0
.
Known Compatibility Issues
- Framework Laptop PD Power supply doesn’t charge the Pocket (only once?). Might be a timeout issue in our system controller firmware (maybe here).