Skip to main content

Uni V2 on Ubuntu Debugging

 "I've had the Uni for a few days now, and it works just great with Ubuntu. However, it doesn't work straight out of the box. There is a simple enough fix and only requires a one-line terminal command to get it working.

The issue is that, in order to read/write to a serial port (which is the protocol Gemini PR uses in Ubuntu), the user needs to be added to the dialout group. In theory, one could run Plover as a super user, but at least on my machine, Plover crashes for some reason when I try to run it with super user permissions, so I had to specifically change one permission for the regular user.

If none of this makes sense, that's okay. Here's a step-by-step on what to do to get the Uni working in Ubuntu, and you're welcome to re-publish it on your Guide page or your Blog. The command should, in theory, work in Arch Linux distros too, but I recommend testing that before saying so on your website.


1. Press CTRL + ALT + T to bring up the terminal.

2. Type the following line in the terminal from within any directory:

     sudo usermod -a -G dialout $USER

3. Log out of Ubuntu.

4. Log back in as the user you normally log in as.

5. Plug your Uni v2 into any USB port.

6. Open Plover.

7. Click on the Configure button.

8. Click on the Machine tab.

9. In the Machine dropdown menu, click on Gemini PR.

10. Click the Scan button in the Connection subgroup.

11. Click on the option* that shows up in the Port dropdown menu.

12. Click the OK button.


* If the device still doesn't work and there was more than one device in the Port dropdown menu, just keep trying different ones until it works.


One other thing is that, if you unplug the Uni and plug it back in, there's a chance it will switch ports. The easy way to fix that is to tell people to repeat steps 6 through 12 in order to get Plover to detect it again, with the additional step of clicking on Reconnect Machine in the File menu."

-Brownie McFinnigan

Comments

Popular posts from this blog

Steno In a Nutshell

Quick, read this sentence out loud. Now, try to type that same sentence. Which was faster? Most people can read much faster than they can type. Stenographers, on the other hand, can type as fast as you read! But what is steno anyways? Sometimes, steno feels like magic. Words. Entire words, magically appearing on the screen. Steno is a method of writing that allows the user to press multiple keys at the same time to make an entire word. Here's a video of me doing stenography. Huh? Watch it again. Maybe you can understand it the second time around. Or maybe not. Still confused? I was too. But it turns out, it's not as complicated as it looks. Steno might look like playing a piano, and you're not wrong... Piano and steno are actually quite similar. Both use chords to represent sounds. Phonetic Spelling You write in steno by typing words as they sound. You spell "cat" by typing "KAT" in steno. There are only 22 letter keys on the steno layout even though the...

Steno with the Uni: How to connect it with Plover.

See the updated guide on setting up the Uni here! Thanks for purchasing the Uni! This is the layout: If you bought the PCB version click  here  for the build guide. Everything below is for those who ordered the fully assembled version. Fully Assembled Setup The fully assembled Uni will come ready to use out of the box. Almost. You just need to have Plover installed on your computer. Make sure to get the latest build. How to install Plover  : Click on the latest version of Plover (continuous 4.0.0 or whatever is newest). Under Assets install the Windows Installer (or macOS or Linux depending on your operating system). Go through the installation setup If you already have Plover installed do this: Open Plover. Click the Configure gear icon on the top left corner. Click on the Machine tab. Click on the drop down next to Machine: and select Gemini PR Below, click on the button that says Scan. Click on the drop down for Port and select the COM number that popped up. If more ...

How to do NKRO on QMK for stenography

This is not an in-depth tutorial, but a pile of resources for future reference. If your keyboard is mechanical and it uses QMK Firmware, try holding LeftShift+RightShift+N to enable nkro. If that doesn't work, check the  QMK docs . If you're really savvy, you can manually edit the firmware code. The most important piece of code is the #define FORCE_NKRO in the config.h file. More information on qmk and steno can be found  here . You can also check out the_uni branch on my fork of the qmk firmware github to see an example of the firmware that a Uni uses.