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

Compare commits

base: he4et:63a60985128c166c70cf08a49b084bb16dca40ae
Branches Tags
he4et:master
...
compare: he4et:b06a29c654202e330ab6ad961b2b365344dc1e11
Branches Tags
he4et:master

2 commits
63a6098512 ... b06a29c654

Author SHA1 Message Date
He4eT
b06a29c654 Update README.md 2026-05-14 13:11:48 +02:00
He4eT
59aef3e740 Update README.md 2026-05-14 13:11:38 +02:00
1 changed files with 18 additions and 5 deletions
Download patch file Download diff file Expand all files Collapse all files

23
README.md
View file

@ -11,18 +11,18 @@ Configuration for the 8MHz version of Blackpill_f411 provided by the [Xecut hack
## Initial Flash ## Initial Flash
1. Clone this repository: 1. Clone this repository:
``` ```sh
git clone --recurse-submodules git@github.com:He4eT/cantor-mx-tastatura.git git clone --recurse-submodules git@github.com:He4eT/cantor-mx-tastatura.git
cd cantor-mx-tastatura cd cantor-mx-tastatura
``` ```
2. Connect the **left** controller to your computer using a USB cable. 2. Connect the **left** controller to your computer using a USB cable.
3. Start the flashing process (Docker required): 3. Start the flashing process (Docker required):
- For **8MHz Blackpill_f411** controllers: - For **8MHz Blackpill_f411** controllers:
``` ```sh
make flash blackpill=f411_8mhz half=left make flash blackpill=f411_8mhz half=left
``` ```
- Otherwise: - Otherwise:
``` ```sh
make flash half=left make flash half=left
``` ```
4. Use the onboard `BOOT0` and `NRST` button to put the board into bootloader mode: 4. Use the onboard `BOOT0` and `NRST` button to put the board into bootloader mode:
@ -31,6 +31,7 @@ Configuration for the 8MHz version of Blackpill_f411 provided by the [Xecut hack
- release the `BOOT0` button. - release the `BOOT0` button.
For additional details, refer to [STM32 Black Pill](https://land-boards.com/blwiki/index.php?title=STM32_Black_Pill). For additional details, refer to [STM32 Black Pill](https://land-boards.com/blwiki/index.php?title=STM32_Black_Pill).
See also the [troubleshooting section](#Troubleshooting).
5. Repeat the process starting from step 2 for the **right** half. 5. Repeat the process starting from step 2 for the **right** half.
6. Download the [Vial configurator](https://get.vial.today/). 6. Download the [Vial configurator](https://get.vial.today/).
7. **Linux Only**: Configure [udev rules](https://get.vial.today/manual/linux-udev.html) for the first launch. 7. **Linux Only**: Configure [udev rules](https://get.vial.today/manual/linux-udev.html) for the first launch.
@ -46,7 +47,7 @@ from the [vial-qmk](https://github.com/vial-kb/vial-qmk/) repository is used.
### My Opinionated Layout ### My Opinionated Layout
``` ```text
./layouts/odd_cantor_tastatura.vil ./layouts/odd_cantor_tastatura.vil
``` ```
Check out [this forum thread](https://forum.dmz.rs/t/cantor-mx-keyboard/700) Check out [this forum thread](https://forum.dmz.rs/t/cantor-mx-keyboard/700)
@ -66,8 +67,20 @@ for some explanations.
## Case ## Case
``` ```text
./things/case_slim.stl ./things/case_slim.stl
``` ```
The [Cantor MX Slim Case](https://www.printables.com/model/996711-cantor-mx-slim-case) is The [Cantor MX Slim Case](https://www.printables.com/model/996711-cantor-mx-slim-case) is
a remix of the [Cantor MX Case](https://www.printables.com/model/707238-cantor-mx-case) by [@JellyTitan](https://www.printables.com/@JellyTitan). a remix of the [Cantor MX Case](https://www.printables.com/model/707238-cantor-mx-case) by [@JellyTitan](https://www.printables.com/@JellyTitan).
## Troubleshooting
### dfu-util: Error during download
Some versions of the STM32 Black Pill are [unable to be flashed over USB using DFU mode](https://github.com/qmk/qmk_firmware/issues/17576).
In this case, you can usually flash the firmware using an ST-LINK device instead:
```sh
make flash half=left
st-flash write ./vial-qmk/custom_cantor_f401_vial.bin 0x8000000
```