keyboards/handwired/ms_sculpt_mobile/readme.md

   1 # Microsoft Sculpt Mobile
   2
   3 This is a way to take a Microsoft ergonomic bluetooth keyboard, and make it
   4 into a hard-wired keyboard running QMK.
   5
   6 The keyboard is known under several different names:
   7 Mobile Bluetooth 5000, Mobile 6000, Sculpt mobile, and Asus rebranded.
   8
   9 I had a stack of them, since they're cheap on ebay, travel well, and are just ergo enough.
  10
  11 The ribbon cable is 1mm pitch, which is hard to hand solder. I bought a cheap set of
  12 "pitch adapter" boards https://www.amazon.com/Double-Sided-0-4mm-1-0-Adapter-60mmx38mm/dp/B00OK42118
  13
  14 Cut the original ribbon cable sockets off the bluetooth board using a razor, they're hard to desolder.
  15 They're also allow the cable to be inserted on top or bottom.
  16
  17 If I was going to do it again, I'd make the MCU connection come out the top of the keyboard
  18 and avoid the wires dangling out the bottom.
  19
  20 As I was debugging the matrix, I started to get random failures. In desparation I tried a second MCU,
  21 but had the same problems. It turns out that the ribbon cable connections can get worn. Shave a
  22 half millimeter off the end of the ribbon cable & the errors go away.
  23
  24 My method for discovering the matrix was to set up a LAYOUT macro that included all pins.
  25 See MATRIX_TESTING_LAYOUT if you need it. Then set up a keymap that has all printable symbols
  26 in the first 4 rows. test each key & record output. Then switch the printable symbols to the
  27 bottom 4 rows & repeat. This was enough to show the matrix.
  28
  29
  30 The full original keymap for the Sculpt is
  31
  32 |   | A  | B  | C  | D   | E   | F   | G    | H    | I    | J     | K    | L      | M    | N     | O    | P      | Q    | R   |
  33 |:-:|:--:|:--:|:--:|:---:|:---:|:---:|:----:|:----:|:----:|:-----:|:----:|:------:|:----:|:-----:|:----:|:------:|:----:|:---:|
  34 | 0 | b  | n  | m  | ,   | .   | /   |      |      |      | Caps  |      |        |      |       |      |        |      | Fn  |
  35 | 1 | g  | h  | "  |     |     |     |      |      |      |       | Vol+ | Mute   | RCtl |       | Vol- | PgDn   | LCtl |     |
  36 | 2 | 7  | 8  | 9  | 0   | Del |     | PgUp |      |      |       |      | RShift |      |       |      | LShift |      |     |
  37 | 3 | p  | [  | ]  | \   |     |     |      |      |      |       | RAlt |        |      |       | LAlt |        |      |     |
  38 | 4 | y  | u  | i  | o   |     |     |      |      |      |       |      |        |      | LGUI  |      |        |      |     |
  39 | 5 | ~  | -  | += | j   | k   | l   | ;    | 5    | 6    | Bksp  | 1    | 2      | 3    | 4     | F4   | F5     | F6   |     |
  40 | 6 | a  | s  | d  | q   | w   | e   | Up   | Left | Down | Right |      |        |      | Space | F1   | F2     | F3   | Tab |
  41 | 7 | F7 | F8 | F9 | F10 | F11 | F12 |      | f    | r    | t     | z    | x      | c    |       | v    | Enter  | Esc  |     |
  42
  43 This works with 18 cols + 8  rows on a Teensy++, or ARM-based Teensy.
  44
  45 The Astar mini has all pins exposed , so you can do 18x8
  46 If you want a speaker, LEDs, etc., you'll need to free up a pin.  I recommend joining columns
  47 R and L to the same pin.
  48
  49 Building - add ASTAR=1 to the compile line or leave out for teensy2++
  50
  51 Make example for this keyboard (after setting up your build environment):
  52
  53     make handwired/ms_sculpt_mobile:default
  54
  55 See the [build environment setup](https://docs.qmk.fm/#/getting_started_build_tools) and the [make instructions](https://docs.qmk.fm/#/getting_started_make_guide) for more information. Brand new to QMK? Start with our [Complete Newbs Guide](https://docs.qmk.fm/#/newbs).