he4et/cantor-mx-tastatura
1
0
Fork 0
mirror of https://github.com/He4eT/cantor-mx-tastatura.git synced 2026-06-18 21:54:28 +00:00
Code Issues Projects Releases Packages Wiki Activity
Custom 42 key diodeless split keyboard with the Vial support.
63 commits 1 branch 0 tags 5.7 MiB
  • C 91.5%
  • Makefile 5.6%
  • Shell 2.9%
Find a file
He4eT b06a29c654 Update README.md
2026-05-14 13:11:48 +02:00
images Add photos 2024-09-04 23:13:13 +02:00
keyboards keyboards: follow qmk naming convention 2025-05-12 11:30:58 +02:00
layouts Add Vial layout 2024-09-04 21:30:08 +02:00
things Add the slim case model 2024-09-04 20:40:44 +02:00
vial-qmk@b991365328 Add vial-qmk as a submodule 2025-05-12 11:23:14 +02:00
.gitmodules Add vial-qmk as a submodule 2025-05-12 11:23:14 +02:00
LICENSE Create LICENSE 2025-05-12 11:46:22 +02:00
Makefile Makefile: Vim modeline 2025-05-13 12:29:16 +02:00
README.md Update README.md 2026-05-14 13:11:48 +02:00

README.md

Cantor MX Tastatura

Cantor MX Keyboard by the Decentrala comunity.

Configuration for the 8MHz version of Blackpill_f411 provided by the Xecut hackspace.

Overview Overview Alternative

"Tastatura" is the Serbian word for "keyboard".

Initial Flash

  1. Clone this repository:

    git clone --recurse-submodules git@github.com:He4eT/cantor-mx-tastatura.git
cd cantor-mx-tastatura

  2. Connect the left controller to your computer using a USB cable.

  3. Start the flashing process (Docker required):

    • For 8MHz Blackpill_f411 controllers: 
      make flash blackpill=f411_8mhz half=left
    • Otherwise: 
      make flash half=left

  4. Use the onboard BOOT0 and NRST button to put the board into bootloader mode:

    • press and hold the BOOT0 button,
    • press and release the NRST (Reset) button to power cycle the processor,
    • release the BOOT0 button.

    For additional details, refer to STM32 Black Pill. See also the troubleshooting section.

  5. Repeat the process starting from step 2 for the right half.

  6. Download the Vial configurator.

  7. Linux Only: Configure udev rules for the first launch.

  8. Open the Vial configurator.

  9. Optional: Load a layout from ./layouts/.

Layouts

Default

By default, the Cantor Vial layout from the vial-qmk repository is used.

My Opinionated Layout

./layouts/odd_cantor_tastatura.vil

Check out this forum thread for some explanations.

Base Layer

Base Layer

Right Hand Layer

Left Hand Layer

Left Hand Layer

Right Hand Layer

Mouse Layer

Mouse Layer

Case

./things/case_slim.stl

The Cantor MX Slim Case is a remix of the Cantor MX Case by @JellyTitan.

Troubleshooting

dfu-util: Error during download

Some versions of the STM32 Black Pill are unable to be flashed over USB using DFU mode. In this case, you can usually flash the firmware using an ST-LINK device instead:

make flash half=left
st-flash write ./vial-qmk/custom_cantor_f401_vial.bin 0x8000000