Releases: ploxiln/vial-qmk
Release list
newfxx_r5c
This is basically equivalent to NathanA's r5 release, but built with new scripts and a newer toolchain (gcc-15.x). It's not really better than NathanA's r5 release at https://www.newfxx-firmware.nconx.com/ but this release build is offered here to test/validate compatibility with more computers and keyboards.
To flash your keyboard with this vial firmware, unzip the tarball, and run the script appropriate for your keyboard model and layout.
- Windows: double-click the appropriate
flash-fxx-xxx.batscript inflash-scripts-win/- After putting the keyboard in bootloader mode, you need to attach the "WinUSB" driver to it, see below
- macOS: open a Terminal, drag the appropriate script from
flash-scripts-unix/into the terminal to copy/paste the full path of the script file, and hit enter to run. - Linux: Install "dfu-programmer" from your linux distro package manager, then open a terminal, and run the appropriate script from
flash-scripts-unix/with sudo- like:
sudo /path/to/flash-scripts-unix/flash-fxx-xxxx.sh
- like:
You will be prompted to put the keyboard into "bootloader mode". Usually Fn-space-R will do this, or the "pandrew-util" has a function to do it, or consult https://www.modelfkeyboards.com/manual/#10
On Windows, after putting the keyboard in bootloader mode, you need to attach the "WinUSB" driver to it (for dfu-programmer-1.x which is included in the firmware flashing archive). See https://github.com/tmk/tmk_keyboard/wiki/WinUSB-Driver
Caveats:
- While NathanA's archive included
dfu-programmer.execompiled for good old x86 Windows, which also works on now-ubiquitous x86_64 Windows, this release archive includes an updated version compiled for x86_64 windows only. - While NathanA's archive included
dfu-programmer.macosfor older x86_64 macOS, which also works on newer Apple Silicon arm64 macs if you install Rosetta, this release archive includes an updated version compiled for Apple Silicon arm64 only. But, you can installdfu-programmerfrom homebrew (or macports?) and the script will use the copy it finds in your PATH preferentially.
The "pandrew-util" builds here are similarly built only for x86_64 windows and arm64 macOS (whereas NathanA's builds are compatible with the older architectures).
On macOS, open the DMG and drag the app to your Applications folder (or wherever). Your first attempt to run it will be blocked because it's not signed, then go to System Settings -> Security and Privacy and at the bottom there will be a button to "Open anyway". Thereafter it will open directly without complaint.
newfxx_r5 pandrew-util
Source tree / github history reconstructed from build.sh from newfxx-vial-package_r5p1.7z from https://www.newfxx-firmware.nconx.com/
Built for Linux amd64 in a Debian-11 container for compatibility with slightly older linux distros (and should be compatible with newer distro releases too). You'll just have to install system packages for hidapi and qt5-gui/widgets:
- Debian/Ubuntu:
apt install libhidapi-hidraw0 libqt5gui5 libqt5widgets5 - Fedora:
dnf install hidapi qt5-qtbase-gui - Arch:
pacman -S hidapi qt5-base
Also, unrelated, but a convenient place to stash it: dfu-programmer built for macOS arm64. Extract the binary to /usr/local/bin/ or any custom location you've added to your shell PATH. (This is useful for running the keyboard flash scripts from the distributed built firmware archive, without installing homebrew just to install dfu-programmer.)