Improve README style
parent
fc0e6c1a71
commit
271789453b
@ -1,42 +1,42 @@
|
||||
silabs-dbg-adapter
|
||||
|
||||
Debug adapter for Silicon Labs Mini Simplicity targets
|
||||
A debug adapter for Silicon Labs Mini Simplicity targets
|
||||
|
||||
|
||||
OVERVIEW
|
||||
FEATURES
|
||||
|
||||
- 2x10 100mil pitch IDC socket for Segger J-Link debuggers and the like
|
||||
- 2x5 50mil pitch IDC header for Silicon Labs Mini Simplicity targets
|
||||
- 2x5 50mil pitch IDC header for general ARM Cortex targets
|
||||
- Voltage regulator and on/off switch for powering targets with the debugger
|
||||
- Target reset push-button
|
||||
- 2x10 100mil-pitch IDC socket for Segger J-Link debuggers and the like
|
||||
- 2x5 50mil-pitch IDC header for Silicon Labs Mini Simplicity targets
|
||||
- 2x5 50mil-pitch IDC header for general ARM Cortex targets
|
||||
- Voltage regulator and on/off switch for powering targets with the debugger
|
||||
- Target reset push-button
|
||||
|
||||
|
||||
DEPENDENCIES
|
||||
|
||||
- KiCad version 5.1.6 for macOS. Results with previous or subsequent versions
|
||||
will likely vary.
|
||||
- kipy (https://git.alt-tek.com/alt-tek/kipy) is useful to simplify executing
|
||||
scripts with KiCad's Python environment. It is required to generate board
|
||||
plots with plot.py for releases.
|
||||
- tea (https://gitea.com/gitea/tea) is required to generate releases. Install
|
||||
and write your API token to ~/.config/git.alt-tek.com/api-token. Restrict
|
||||
access to your API token by setting its file permissions accordingly
|
||||
(i.e. 'chmod 600 ~/.config/git.alt-tek.com/api-token').
|
||||
- In order to generate releases, SSH must be configured for git.alt-tek.com
|
||||
such that SSH Git commands can be executed without explicitly specifying an
|
||||
SSH identity or private key
|
||||
- KiCad version 5.1.6 for macOS. Results with previous or subsequent
|
||||
versions will likely vary.
|
||||
- kipy (https://git.alt-tek.com/alt-tek/kipy) is useful to simplify executing
|
||||
scripts with KiCad's Python environment. It is required to generate board
|
||||
plots with plot.py for releases.
|
||||
- tea (https://gitea.com/gitea/tea) is required to generate releases.
|
||||
Install and write your API token to ~/.config/git.alt-tek.com/api-token.
|
||||
Restrict access to your API token by setting its file permissions
|
||||
accordingly (i.e. 'chmod 600 ~/.config/git.alt-tek.com/api-token').
|
||||
- In order to generate releases, SSH must be configured for git.alt-tek.com
|
||||
such that SSH Git commands can be executed without explicitly specifying an
|
||||
SSH identity or private key
|
||||
|
||||
|
||||
RELEASING
|
||||
|
||||
1. See above dependencies
|
||||
2. Create an annotated Git tag for the release commit using
|
||||
"git tag -a v<version> -m 'Version <version>' <commit>" where version is the
|
||||
board version in X.Y.Z form and <commit> is the commit hash
|
||||
(e.g. "git tag -a v1.2.3 -m 'Version 1.2.3' d15c0cafe")
|
||||
3. Push the tag upstream (i.e. 'git push origin tags/v<version>')
|
||||
4. Use the release script to build the release and upload it as a draft
|
||||
(i.e. './release <version>')
|
||||
5. Review the release draft. If it is ready for pre-release or production,
|
||||
publish it.
|
||||
1. See above dependencies
|
||||
2. Create an annotated Git tag for the release commit using
|
||||
"git tag -a v<version> -m 'Version <version>' <commit>" where version is
|
||||
the board version in X.Y.Z form and <commit> is the commit hash
|
||||
(e.g. "git tag -a v1.2.3 -m 'Version 1.2.3' d15c0cafe")
|
||||
3. Push the tag upstream (i.e. 'git push origin tags/v<version>')
|
||||
4. Use the release script to build the release and upload it as a draft
|
||||
(i.e. './release <version>')
|
||||
5. Review the release draft. If it is ready for pre-release or production,
|
||||
publish it.
|
||||
|
Loading…
Reference in New Issue