Core: Support inverted scan logic for optical switches

[dexter93]

Some optical switch designs use inverted logic.

To invert the keypress logic, configure pressed_key.pin_state in info.json:

    "pressed_key.pin_state": 1,

or, define PRESSED_KEY_PIN_STATE 1 in config.h

Description

Types of Changes

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

Issues Fixed or Closed by This PR

Checklist

• [x] My code follows the code style of this project: C, Python
• [x] I have read the PR Checklist document and have made the appropriate changes.
• [x] My change requires a change to the documentation.
• [x] I have updated the documentation accordingly.
• [x] 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]

pr tracking https://github.com/qmk/qmk_firmware/pull/16340

[dexter93]

Closing, since the change got re-implemented and merged in upstream. Next rebase cycle will include it natively