MNT Reform

The open source DIY laptop for hacking, customization, and privacy

Limited items in stock

View Purchasing Options
Mar 26, 2021

Project update 11 of 15

March 2021 Production & Shipping!

by Lukas H

We have assembled and shipped the first 25 MNT Reforms! This included completing the Operator Handbook, System Image, and packaging. Also, we used the delay to upgrade the keycaps.

New Keycaps

When it became clear near the end of 2020 that things would be delayed by at least two months, we jumped at the opportunity to improve an aspect of the laptop that had been a matter of criticism by beta customers: the standard Kailh Choc keycaps don’t have a particularly great feel, mainly because they are perfectly flat. After trying out the MBK concave keycaps, we talked to FKcaps about a collaboration. They were able to manufacture a new version of their caps in record speed that fit our laser engraving approach: a translucent ABS body painted with a thin layer of black PU. Our minimalistic design strategy of using only two different keycaps on the keyboard paid off here by simplifying the process. The result is that the production MNT Reform keyboards look and feel even better than originally planned.

MNT Reform Keyboard with new keycaps

OLED Menu

While writing the handbook I realized that the system controller functions triggered by key combinations should be made more discoverable. I wrote an interactive scrollable menu rendered on the OLED display which lists all functions and their shortcuts, but it also allows you to just select a function and press ENTER to trigger it. You can enter the menu at any time by pressing the Circle key. Among the current functions are "Power On/Off", "Reset", "Battery Status", controlling the keyboard backlight and "Wake" from standby.

MNT Reform OLED menu

Operator Handbook Completed

Stack of MNT Reform Handbooks

In the first weeks of 2021 I wrote the MNT Reform Operator Handbook with some initial help from Ben Cardinal and later with Brendan Nystedt as my editor. Paul Klingberg contributed a number of crispy illustrations of MNT Reform parts rendered in a line drawing style. 100rabbits contributed the cover design and the design of the online version. Pinguin Druck in Berlin printed the handbook, which ended up being 136 pages in A5 format. All sources for the book can be found in our git repository.

MNT Reform Operator Handbook Content 1
MNT Reform Operator Handbook Content 2

Solution for Dual Display + NVMe

i.MX8M has two display engines that shovel pixel data from memory to a display output: DCSS and LCDIF. Both of them can supply only one output at a time. DCSS is more featureful and can do framebuffer compression among other tricks, and it can supply either the HDMI or the MIPI-DSI output. LCDIF can supply only the MIPI-DSI output and has a limited FIFO buffer of 512 bytes.

If you want to use only one display at a time (internal or external), DCSS is the better choice. For a dual display setup, the only choice is DCSS for the external and LCDIF for the internal display.

During more intensive testing, I discovered a problem: PCIe traffic, for example by a NVMe SSD, can interrupt the LCDIF’s ability to fill up its buffer on time, causing the display to glitch. Lowering the refresh rate did not help, so it appeared not to be a bandwidth problem. I couldn’t find any documentation by NXP on how to attack this issue, and the support channels I contacted didn’t have an answer either.

After a handful of very frustrating days, I wanted to give up on the problem and announce that the combination of dual display plus NVMe SSD would not work out. But contacting a kernel developer at NXP provided me with an unexpected solution in the last minute: there is a yet undocumented QoS (quality of service) controller that let me limit the number of outstanding transactions of bus masters like the two PCIe controllers. You can find the rather obscure looking patch for the problem in our git repository.

By default, MNT Reform will boot in single (internal) display mode powered by DCSS. With the included reform-display-config script, you can switch to using the DCSS/LCDIF combination that enables both internal and external displays to be used together.

System Image Completed, Rescue System on eMMC Flash

MNT Reform System Image MOTD

Next to managing logistics, I spent around 2 weeks completing the system image(s) for MNT Reform, now based on Linux 5.11 and a Debian Sid userland. There have been numerous small tweaks to the system including a third desktop option: WindowMaker running on the Cage single-application compositor (the single application being a fullscreen Xwayland in this case). The reform-windowmaker script demonstrates how to run classic Xorg desktops on a Wayland compositor, as Xorg by itself doesn’t currently work reliably on the etnaviv modesetting drivers. Also, running Xorg environments on Wayland gives you tearing-free output as a bonus. If you prefer the native Xorg anyway, you can currently run it on the Linux framebuffer using the fbdev driver, but without hardware acceleration.

Our build script (mkimage.sh) now first builds a smaller version of the full image (without big desktop applications like LibreOffice) called the Rescue System. We install this Rescue System on the 16GB eMMC flash included on the Nitrogen8M processor module. If you ever make your main system unbootable and don’t have a second SD card, you can flip the DIP switch on the processor module to boot from eMMC instead. You can even reverse things and move your main OS to eMMC and boot from SD cards in emergency situations. Currently, accessing the switch requires to remove the heatsink from the processor module.

Electronics Stocked, 25 Units Shipped

MNT Reform Production Unit

We have all electronics stocked to build 450 MNT Reforms, except for some of the keyboards: we have 330 in stock and 150 on the way to us. In any case we already have enough parts to fulfill all campaign orders. We also received the first 25 sets of aluminum/acrylic case parts and have assembled the very first 20 production MNT Reforms and 5 DIY kits. Booting the first one was a bit of a magical moment. While we’re still learning how to do the assembly and packaging in the most efficient way possible, our plan is to ramp up to 10 devices per day. Nevertheless, we already sent the first 25 devices out to EU backers, and the initial feedback is very positive. I’m incredibly proud of the hard work of my coworkers Greta and Magda over the last months who made all of this possible in the middle of a pandemic.

MNT Reforms being tested
Greta assembling and packaging MNT Reforms
Magda sewing MNT Reform Max sleeves

A Note on Shipping

If you have backed the campaign during the crowdfunding phase and your shipping address is within the European Union, your order will be shipped by us from Germany. Since we can ship these EU orders individually, they will begin shipping first. The rest of the orders will be shipped in bulk to Crowd Supply for final distribution to all other backers outside of the EU (United States, Canada, Australia, Japan, etc.) from their warehouse in the United States. If you’re unsure about your order status or have any other questions, please contact Crowd Supply support directly.

MNT Community

To anticipate the first backers receiving their MNT Reforms and to collect technical support, feedback, hacks and recipes in a central place, we launched a forum, MNT Community. Sign-ups are moderated to combat spam but are swiftly handled.

Thank you for your patience and continuing support while we work on getting more MNT Reforms into your hands!


Sign up to receive future updates for MNT Reform.

Subscribe to the Crowd Supply newsletter, highlighting the latest creators and projects