Using your nano, cleaning and tips
Keebwerk Nanos come in a variety of colours and materials.
We have optimised and adjusted production along the way to eliminate some issues we had noticed but all parts are compatible to all Nano’s. If you have a Nano from the first batch you can still purchase an extra Part in the new colours and it is guaranteed to fit!
Nano Bento: Brass Bases
- Brass bases purchased with the limited edition Nano. Bento are in a Raw state and to give the gorgeous matte finish they are sandblasted. Brass, in its raw form is susceptible to corrosion, visible as dark spots. This corrosion is only a thin surface layer and does not destroy the product over time.
- If you have experienced this corrosion it is very easy to remove it. Use some hot water and house hold citric acid, often purchaseable in small packets as a powder form. Dissolve the Citric acid in the hot water, tip a paper toal in the liquid and rub over the corrosion. You will see the discolouration disappear.
- PLEASE BE AWARE THAT SOME PRODUCTS CAN HAVE ADDITIVES THAT MIGHT CAUSE DAMAGE TO THE BRASS MATERIAL – try out in a spot that is not visible – for example on the inside. Remove the Brass Base from your Nano before cleaning as to not risk water damage to your PCB.
- Your Nano comes with a Aluminium Knob that is friction fitted on the Potentiometer. If you want to remove the Knob you can carefully pull it off the potentiometer Stem.
- Spare knobs can be purchased in our store
We have iterated the PCBs over the production batches. All PCBs are identical in functionality but can vary in their appearance
- There are black and white PCBs. All Nanos starting in the year 2020 have white PCBs.
- Nano’s purchased after May 2021 have a PCB that has a date marking on them with the year 2019. Truth be told this was a manufacturing mistake, the PCBs are however brand new and we decided to not scrap the PCBs due to visual mistake that cannot be seen in operation.
NANO FIRMWARE – Flashing and How TO’s
Basic prebuilt .hex files
Here are some basic example setups of our nano. slider with various applications, please be aware, these may be OS specific and might only work with the specified OS. Our .hex files are available for download here, we will be pushing some basic keymaps to the official QMK rep.
- Adobe Photoshop MAC
- Media Control MAC
- Windows Media Control MAC
What we have working –
Foobar Control on Windows
Media Control on Windows
MIDI2LIGHTROOM on MAC
ControllerMate Control on MAC
Windows Volume on Windows
THE FILES YOU NEED
The basic .hex folder setup is available at this link below:
The basic standard .hex file is available at this link below:
MAC Lag – for some reason when the nano. slider is connected and no output is being read by the mac, the nano. slider lags and seems sluggish, the solution to this is to open a MIDI application which reads the output of the nano. slider
WINDOWS 10 Issue – Windows 10 has been realising updates that have been messing with the MIDI files. FIXED!
HOW TO – MANUAL
How to flash your nano. device.
Our nano. devices use standard QMK firmware modified by us to fit the extra pinout of the ATMEGA32 processor which is occupied by the potentiometer. This guide is for any beginner who would like to learn about QMK and how to flash their keebwerk device.
First of all, you will require a few things to make this work.
- The folder (if planning to makefile (.hex) on your own) / .hex file
- QMK Toolbox (Mac) – Command Tool on Windows – QMK Toolbox (Windows)
- USB Cable
- nano. slider device (believe it or not.)
Setting up the files as you need.
To get the nano. to type keys/commands as you want to you will have to modify the keymap of the QMK firmware. This process is fairly simple, even without any past programming experience. PLEASE DO NOT use an online standard QMK configurator as the QMK folder that the nano. uses is built differently to support the potentiometer.
a) You will need to access the QMK folder that you have downloaded using Finder or Explorer, and you will navigate to:
please open the keymap.c file using a text/code editor.
b) You will find a bunch of code and some of it might look familiar to you as you will see words like KEYMAP and KC_4.
c) Now, for people who are familiar with QMK, you will immediately recognize some parts of the code. This is where the code lies which tells the device what each keypress should mean to the computer. Here you can change where you want media buttons, number buttons or letters on your nano. device.
The code is in the following order,
KEYMAP( KC_3, KC_4, KC_5, KC_6, KC_2, TG(1), KC_1, KC_0),
Please be aware that these numbers are in random order and do not respond to the visual layout of the nano. slider.
The locations currently set as:
KC_1, KC_2, KC_3 2U KEY BEING KC_0
KC_4, KC_5, KC_6
You can now change any of the keys to whatever you require.
Here is the full list https://beta.docs.qmk.fm/features/keycodes_basic
A further list can be found here: https://beta.docs.qmk.fm/features/feature_advanced_keycodes
PLEASE do not use ALIAS codes of the QMK keys, but the full keycodes.
You can now replace the parts of codes in the file to match what you require, please make sure the commas and the formatting is still correct while copy-pasting code.C
Creating the .hex file out of the folder
The first step is to prepare your .hex file by using command console/ terminal/ whatever console editor you have on your system. For this to work you will require a few dependencies and libraries. We recommend you visit: https://docs.qmk.fm/#/ and install what you require to make QMK work on your computer.
After everything is installed, you will have to make your .hex file from the folders that you have downloaded from our site (and modified yourself)
To do this you will need to navigate in your terminal/console to the qmk folder (in our case it has landed in Downloads)
cd /Downloads/qmk-nanoslider (qmk-nanoslider is the folder name, please make sure it matches the folder name of the QMK folder that you downloaded)
And after, you will want to create the .hex file by typing:
The console will then show you the process of what it is doing to make the .hex file, you should see a success / OK! message at the end of it. Please make sure there are no errors in the process of creating the .hex.
Congratulations now you have made your own .hex file from a few random folders and files.
Flashing the nano. slider
To flash the nano. slider, we recommend you use QMK Toolbox to program the nano. slider as it is the easiest.
The window of QMK Toolbox will look like this:
Please connect the nano. slider and press the reset button on the bottom of the nano. slider, inside the nano. slider under the base. Select the .hex file you have created inside the folder of the qmk firmware that you have downloaded. Please press the flash button on the app once the log says the keyboard is connected. The nano. slider now works and should be good to go!
Using the MIDI!
Power Mixer was one of the first use cases we had for the nano. slider, please find the settings below that you can use to get Power Mixer to work. There is a small delay in the MIDI signal, but we are trying to bug-fix that.
Power Mixer can be found here: https://www.actualsolution.com/power-mixer/features/