This should cover most Leeku boards: ALPhaS, Finger, FingerUp, CP-SQ, MX1800, MX3000, MX1830, Legacy 1800/3000.I'd like to compile the knowledge gathered over the years that seems to be spread over multiple threads and forums concerning Leeku PCBs. Feel free to share corrections and other tips and I'll try to update this to reflect those corrections and additions.
How do I change the layout of my pcb?Leeku PCBs are programmed using software called Jigon which can be found in this thread on kbdlab:
http://kbdlab.co.kr/index.php?document_srl=2702787&mid=board_swYou need the JigOn_xxxxxx.zip (Key mapping GUI) file.
Here is some helpful documentation on using the Jigon software:
https://geekhack.org/index.php?topic=83950.msg2236885#msg2236885Can I run Jigon on Linux or Mac?Nope, jigon only works on Windows, sadly.
Jigon just crashes every time I try to update the layout on my PCBRight click on the application icon and choose run Jigon as administrator from the context menu.
Why does the spacebar not work on my PCB?I have encountered quite a few PCBs where the spacebar is not mapped to anything with the default keymap or mapped to fn, running Jigon and remapping the spacebar should fix this.
Where's the fn or function key?Default mapping for fn is usually pause or spacebar by default. This can be changed by connecting your PCB to jiGon and remapping.
Why aren't my keymap or LEDs working?From the linked Jigon documentation above:
If the keyboard works, but setting the keymap or LEDs doesn’t, or pressing a key in JigOn doesn’t turn the key red, then the version of JigOn and the firmware may be mismatched. Flash the keyboard to the firmware that matches the version of JigOn you’re using(download them both at once from the original page!)
In other words use the same version of firmware that matches the Jigon version. If you're using the 170419 version of Jigon, use the 170419 version of firmware.
Why is my keyboard outputting strange characters when I type?- You forgot to hit disconnect in the Jigon program. It will output gibberish when connected instead of highlighting the keys in the program.
- Switch your input language in windows to EN-US.
Can I map keys to turn the LEDs off and on?For the top LEDs, yes you can. For the bottom RGB Leds, no you can't. They can only be controlled while Jigon is running and connected to your keyboard.
How do I flash the firmware?You need to download the L3_xxxxxx.zip (All L3-xxx PCBs) or the L3_FW_RESET.zip (RESET FW - Factory reset when set or keymap is corrupted .) which is the firmware, either one will suffice as they tend to be the same.
Unzip the firmware file and plug your keyboard in. Click the loadfw.bat file which is a batch file that runs the l3cmd.exe file, opens bootloadHID_l3.exe and flashes the L3.hex file onto the PCB. You will see a command prompt window open and do it's thing. once done, press any key to continue. Firmware done.
Why am I getting a communication error with device?Plug your USB cable directly into your computer instead of a USB hub.
Some helpful tips from OracleKevhttps://geekhack.org/index.php?topic=95066.msg2660521#msg2660521L3 boards are easy to deal with when you are aware of just a few things.
When flashing (with loadfw.bat under L3_yymmdd.zip) or updating settings (with JigOn), make sure:
1) L3 board is directly connected to PC's USB
2) There is just one L3 board connected to the PC
If the board is in weird state (not recognized as "L3" device or does not work with the latest firmware update or JigOn)
1) Boot into bootloader (press/short ~ and connect USB, "HIDBOOT" device gets recognized)
2) Run loadfw.bat under L3_FW_RESET.zip
Occasionally, bootloader/firmware are blown due to static electricity or voltage spike from faulty components (especially RGB LEDs), MCU needs to be reprogrammed via ISP loader physically connected to the board.
I haven't seen this being done on GH, so it would be really handy to have someone local (familiar with this sort of things) come up to speed. If you need the connector (looks like this http://kbdlab.co.kr/index.php?mid=board_CDST33&document_srl=3854117), make one or talk to someone on kbdlab. My guess is there are fair number of PCBs with blown bootloader/firmware floating around.
If MCU reprogramming doesn't fix things, most likely you are dealing with component failure. This is beyond typical DIY territory, so your best bet is to talk to the GB runner or local guru.
IMO, L3 boards and software are proven with years of track record. It's easy to solder and utilities are all self contained. There are idiosyncrasies like JigOn UI and limited hub/multi device support, but most people don't flash/update their keyboards often.
Can I use TMK or QMK instead of Jigon?Here's the TMK port:
https://github.com/xauser/tmk_keyboard/tree/xauser/keyboard/l3QMK port:
https://geekhack.org/index.php?topic=97623.msg2702250#msg2702250QMK repo:
https://github.com/wholypantalones/leeku_qmkHow do I know if I have a bricked PCB?Well, this will happen when you plug it in and nothing works as well as a communication error in your device manager.
https://imgur.com/OPDo4OVHow do I fix it?You're going to need an ISP to re-flash the bootloader using the L3_bootloader.zip (Bootloader - use ISP Loader) from here:
http://kbdlab.co.kr/index.php?document_srl=2702787&mid=board_swHere's a couple of helpful posts (need translation) to help out, I successfully fixed the above PCB last weekend.
http://kbdlab.co.kr/index.php?document_srl=3437863&mid=board_tunehttps://web.archive.org/web/20180706063827/http://blog.naver.com/PostView.nhn?blogId=wioiw24&logNo=220781386856&parentCategoryNo=&categoryNo=312&viewDate=&isShowPopularPosts=false&from=postViewOther helpful posts / things /stuffHaving to reflash the layout on power cycle generally means that the firmware and / or jigon version needs to be updated. If that doesn't fix it a bootloader reflash is in order.
dorf_se has some useful videos on programming the PCB at that "keeb" talking site here:
https://www.keebtalk.com/t/leeku-pcbs/3683