mitosis icon indicating copy to clipboard operation
mitosis copied to clipboard

Documentation Improvement Request

Open kendotpm opened this issue 8 years ago • 2 comments

As a newbie approaching this project from no experience, here's the things that were / are still really difficult to help me get going:

  1. As referenced in #5 and subsequently my recent issue from #8, the link to the nRF sdk makes it appear as if you cannot get to version 11. For me, I ended up grabbing the newer stuff, ultimately creating the error both @joric and I ran into. We need to be able to get to version 11 to get the newbie friendly program.sh running and to be able to build your custom make files.
  2. A folder structure after all unzipping and downloading would have been really helpful. I had actually missed things by 1 nested folder and it made following the guide really difficult. This is quite an RTFM type of user error, but it'd help just sanity checking things as a new user.
  3. Overall understanding of what needs to be flashed to the hands, and what needs to be flashed to the receiver at a high level. I'm actually still unsure.
  4. Specific instructions of what and how to flash to the receiver, similar to the instructions for flashing to the hands. I'm still unsure.
  5. Pairing instructions to link the hands to the receiver. There's a Pairing button on the receiver (discovered through the build log on imgur), but I'm not actually sure how the lights should react and whether my flashing is faulty or my soldering is faulty.

The README assumes a lot of knowledge, and that's probably ok, but I'm in love with this keyboard and it's currently a frustrating mystery to me as a newbie to the keyboard building world. A little time spent on docs would go a really long way!

kendotpm avatar Sep 20 '17 09:09 kendotpm

@krazyken04 Pairing button doesn't do anything actually, addresses are hardcoded, also there's no encryption. I haven't done much testing - it either works or not (In my case it didn't, because of the memory placement issue I fixed in https://github.com/reversebias/mitosis/pull/7, it took a week to notice an inconsistency in the configuration files).

joric avatar Sep 20 '17 11:09 joric

This person has created a repo to collect some supplementary documentation: https://github.com/babarrett/mitosis-docs

Regarding 3:

  • precompiled-basic-left.hex: flash to the wireless module on left hand board
  • precompiled-basic-qmk.hex: flash to the pro micro on the receiver. includes @reversebias's key layout as described in the imgur build log, corresponding to https://github.com/qmk/qmk_firmware/blob/master/keyboards/mitosis/keymaps/default/keymap.c
  • precompiled-basic-receiver.hex: flash to the wireless module on the receiver
  • precompiled-basic-right.hex: flash to wireless module on right hand board
  • testing-receiver-rgb.hex: (optional) flash to the pro micro on the receiver to make LED blink. no keyboard functionality.

datagrok avatar Oct 30 '17 00:10 datagrok