Core: Support inverted scan logic for optical switches

[dexter93]

Some optical switch designs use inverted logic for pressed state.

To invert the keypress logic, configure matrix_pins.input_pressed_state in info.json:

    "matrix_pins": {
        "input_pressed_state": 1,
},

or, define MATRIX_INPUT_PRESSED_STATE 1 in config.h

Description

Types of Changes

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

Issues Fixed or Closed by This PR

Checklist

• My code follows the code style of this project: C, Python
• I have read the PR Checklist document and have made the appropriate changes.
• My change requires a change to the documentation.
• I have updated the documentation accordingly.
• I have read the CONTRIBUTING document.
• I have added tests to cover my changes.
• I have tested the changes and verified that they work and don't break anything (as well as I can manage).

[dexter93]

Update on now stale #16340.

static inline uint8_t readMatrixPin(pin_t pin) should also probably become
static inline bool readMatrixPin(pin_t pin) since it's only spitting out 1/0

[dexter93]

Some thoughts on this can be found in SonixQMK#299

[dexter93]

functionality verified with no adverse effects in either input logic state