Author Topic: Updated documentation, tips and tricks for Leeku PCBs  (Read 3617 times)

0 Members and 1 Guest are viewing this topic.

Offline wholypantalones

  • Thread Starter
  • Posts: 574
Updated documentation, tips and tricks for Leeku PCBs
« on: Fri, 05 October 2018, 21:21:30 »
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_sw

You 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#msg2236885

Can I run Jigon on Linux or Mac?

Nope, jigon only works on Windows, sadly.

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, running Jigon and remapping the spacebar should fix this.

Where's the fn or function key?

Default mapping for fn is usually pause 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:

Quote
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 OracleKev

https://geekhack.org/index.php?topic=95066.msg2660521#msg2660521

L3 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/l3

QMK port: https://geekhack.org/index.php?topic=97623.msg2702250#msg2702250

How 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/OPDo4OV

How 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_sw

Here'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_tune

https://web.archive.org/web/20180706063827/http://blog.naver.com/PostView.nhn?blogId=wioiw24&logNo=220781386856&parentCategoryNo=&categoryNo=312&viewDate=&isShowPopularPosts=false&from=postView

Other helpful posts / things /stuff

Having 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
« Last Edit: Sun, 05 May 2019, 15:49:05 by wholypantalones »

Offline ba7777

  • Posts: 169
  • Location: China
Re: Updated documentation, tips and tricks for Leeku PCBs
« Reply #1 on: Fri, 05 October 2018, 23:26:38 »
Well done! Thank you very much!

Offline nug

  • Posts: 42
  • Location: Melbourne
Re: Updated documentation, tips and tricks for Leeku PCBs
« Reply #2 on: Sun, 06 January 2019, 21:26:49 »
Can I use TMK or QMK instead of Jigon?

Here's the TMK port: https://github.com/xauser/tmk_keyboard/tree/xauser/keyboard/l3

Still need clarification on using QMK, but it looks like the controller won't work with QMK.

https://geekhack.org/index.php?topic=94637.msg2594709;topicseen#msg2594709
Actually the board does work with QMK, I use it on my TX65, LZ GHv2 and Finger60 PCB.

I've attached the files in a zip, if you place that folder into the QMK keyboards folder and then run
Code: [Select]
make l3_tkl87:defaultYou can then flash the hex using the loadfw.bat file (referencing the newly created QMK hex file of course)

Note that configuring LEDs and RGB backlighting in QMK is tricky for these boards. I've only managed to get an LED indicator on layer activation to work.

EDIT: The attached zip contains the configs for L3_Finger60, L3_Finger65, and L3_TKL87. I haven't taken into account alternative layouts so you'll need to modify the keymaps. I was able to compile the default hex in MSYS2.
« Last Edit: Mon, 07 January 2019, 01:47:37 by nug »