[Docs] Add dedicated page for Split Keyboard information

[drashna]

Types of Changes

• Core
• Bugfix
• New feature
• Enhancement/optimization
• Keyboard (addition or update)
• Keymap/layout/userspace (addition or update)
• Documentation

Checklist

• My code follows the code style of this project.
• I have updated the documentation accordingly.
• I have read the CONTRIBUTING document.

To Do

• Include more information about hardware, and wiring
• Add Troubleshooting info
• Add RGB Underglow information

[SethBarberee]

Looks good. Maybe also mention RGBLIGHT_SPLIT for the sake of animation syncing for split keyboards?

[yanfali]

LGTM. I think a short section on troubleshooting would be a valuable addition. Some very non-specific keyboard ideas include, checking for shorts on the TRRS connector, reflowing pins on that connector. Also some pointers to the different configurations for the RGB light strips might be handy. i.e. serial, direct cable attachment, and i2c. With pointers to examples of both.

Otherwise, very good addition.

[yanfali]

One additional thought, maybe discuss some of the different controllers available and the pros and cons. With placeholders for ARM. This would also give you a place to mention the sparkfun pro micro and their 3.3v jumper.

[drashna]

@yanfali Yeah, I need to add a lot more here, However, I wanted to get at least this much done, and started. That way, I could start getting feedback.

@SethBarberee Yeah, was planning on it. Thanks for the feedback!

[yanfali]

I'm seeing this in view mode. So it looks wrong

[drashna]

Fixed now. Weird markdown formatting issue ...

[mtei]

I drew some blue figures and some gray figures.

i2c connection

#define USE_I2C

soft serial connection

#define SOFT_SERIAL_PIN D0

#define SOFT_SERIAL_PIN D2

RGB LED connection (single LED chain)

#define SOFT_SERIAL_PIN D2

#define RGB_DI_PIN        B5
#define RGBLED_NUM_LEFT   4
#define RGBLED_NUM_RIGHT  4
#define RGBLED_NUM        (RGBLED_NUM_LEFT+RGBLED_NUM_RIGHT)

RGB LED connection (double LED chain with I2C)

#define USE_I2C

#define RGB_DI_PIN  B5
#define RGBLED_NUM  4

or

#define USE_I2C

#define RGB_DI_PIN       B5
#define RGBLED_NUM_LEFT  4
#define RGBLED_NUM_RIGHT 4
#define RGBLED_NUM       (RGBLED_NUM_LEFT+RGBLED_NUM_RIGHT)
#define RGBLED_SPLIT     { RGBLED_NUM_LEFT, RGBLED_NUM_RIGHT }

RGB LED connection (double LED chain with serial)

#define SOFT_SERIAL_PIN D2

#define RGB_DI_PIN  B5
#define RGBLED_NUM  4
#define RGBLIGHT_SPLIT

or

#define SOFT_SERIAL_PIN D2

#define RGB_DI_PIN        B5
#define RGBLED_NUM_LEFT   4
#define RGBLED_NUM_RIGHT  4
#define RGBLED_NUM        (RGBLED_NUM_LEFT+RGBLED_NUM_RIGHT)
#define RGBLED_SPLIT      { RGBLED_NUM_LEFT, RGBLED_NUM_RIGHT }

[mtei]

RGBLIGHT_SPLIT V.S. RGBLED_SPLIT

#define RGBLIGHT_SPLIT
//or
// #define USE_I2C

#define RGBLED_SPLIT { RGBLED_NUM_LEFT, RGBLED_NUM_RIGHT }