search

pok3r-custom / pok3r_re_firmware

Reverse engineering project for the POK3R and related keyboards.
219 stars 17 forks source link

Request: Update Wiki page to include hardware unlocker links #31

Open kmanwar89 opened 4 years ago

kmanwar89 commented 4 years ago

@ChaoticConundrum

First and foremost, thank you for all the work you've done to get QMK working on the pok3r.

I've been using my Pok3r for about 1.5 years, and would love to put QMK on it. I'm following the documentation, but having trouble understanding exactly what is needed to unlock the pok3r? Can the documentation for unlocking it be updated to reflect what equipment is needed for unlocking the keyboard? Right now, it just says to refer to the Wiki, but the Wiki for the Pok3r isn't exactly clear.

I'm big on documentation, and plan to thoroughly document my journey, so I'd be happy to send a PR your way to update things as they happen. Thanks!

ChaoticEnigma commented 4 years ago

Ah, I think I meant to improve that wiki page at some point. Before starting, you may want to read #23 to see what you're getting yourself into!

The tool required is a hardware JTAG debugger. I mostly use JLink tools, so I'd recommend a JLink EDU mini, the cheapest genuine one they have available. Other people have had success with other tools, as well as JLink knock-offs.

You will need to solder wires from the CN2 header (see POK3R Notes) to something you can connect the debugger to. I suggest this breakout.

The software will depend on which tool you have, but for a JLink, you can use the scripts in this repository for mass erasing and flashing. On Linux, you can install the JLink software and then do:

make mass_erase
make pok3r_bootloader

Then the QMK firmware is flashed with pok3rtool.

TaiSHiNet commented 4 years ago

I know you're doing a lot, but could you post instructions on how to do this? I'm a complete noob when it comes to soldering but I'm all in for trying. Also, the breakout links to the POK3R Notes

Thanks again!

ChaoticEnigma commented 4 years ago

I fixed the link, thanks. Adafruit went out of stock anyway...

My hope is that I can get some firmware working that doesn't require unlocking the keyboard, which can just be downloaded over USB. It's hard to be motivated to write documentation that you plan to make obsolete...

I have been slowly working on that firmware, but I haven't had a lot of time. I can answer questions about unlocking and flashing the current firmware with a debugger, but I think I'd rather work on new firmware than write a step-by-step guide.

TaiSHiNet commented 4 years ago

I'm interested more as a personal learning experience. But I understand your situation. Any way people can contribute to your solution?

markx commented 4 years ago

It's great to hear that you are working on that firmware. There's still hope for me :)