Detailed description
This pull request
- implements function
PINOUT_SWITCH()to switch between pinouts. In total 3 alternative pinouts can be defined. - adds one alternative pinout for the blackpillv2 platform. The pinout description is found in the README.md of the blackpillv2 platform, modified in this pull request. This pinout uses the pins near the bottom of the board. The alternative pinout is visualized in figure 1.
- adds the macros to facilitate using either USART1 or USART2 as USBUSART.
The implementation of a function to select alternative pinouts was mentioned in this issue comment.
230974447-ec7b25cb-ee38-4424-a54b-d596888b1aa3
Figure 1: alternative pinout 1
Your checklist for this pull request
- I've read the Code of Conduct
- I've read the guidelines for contributing to this repository
- It builds for hardware native (
make PROBE_HOST=native) - It builds as BMDA (
make PROBE_HOST=hosted). - It builds for hardware blackpillv2 (
make PROBE_HOST=blackpillv2) - It builds for hardware blackpillv2 with alternative pinout 1 (
make PROBE_HOST=blackpillv2 ALTERNATIVE_PINOUT=1) - I've tested it to the best of my ability
- My commit messages provide a useful short description of what the commits do
Closing issues
## Detailed description
This pull request
- implements function `PINOUT_SWITCH()` to switch between pinouts. In total 3 alternative pinouts can be defined.
- adds one alternative pinout for the blackpillv2 platform. The pinout description is found in the README.md of the blackpillv2 platform, modified in this pull request. This pinout uses the pins near the bottom of the board. The alternative pinout is visualized in figure 1.
- adds the macros to facilitate using either USART1 or USART2 as USBUSART.
The implementation of a function to select alternative pinouts was mentioned in [this issue comment](https://github.com/blackmagic-debug/blackmagic/issues/1418#issuecomment-1507492647).
Figure 1: alternative pinout 1
## Your checklist for this pull request
* [x] I've read the [Code of Conduct](https://github.com/blackmagic-debug/blackmagic/blob/main/CODE_OF_CONDUCT.md)
* [x] I've read the [guidelines for contributing](https://github.com/blackmagic-debug/blackmagic/blob/main/CONTRIBUTING.md) to this repository
* [x] It builds for hardware native (`make PROBE_HOST=native`)
* [x] It builds as BMDA (`make PROBE_HOST=hosted`).
* [x] It builds for hardware blackpillv2 (`make PROBE_HOST=blackpillv2`)
* [x] It builds for hardware blackpillv2 with alternative pinout 1 (`make PROBE_HOST=blackpillv2 ALTERNATIVE_PINOUT=1`)
* [x] I've tested it to the best of my ability
* [x] My commit messages provide a useful short description of what the commits do
## Closing issues
<!-- put "fixes #XXXX" here to auto-close the issue(s) that your PR fixes (if any). -->