Fixed typos in documentation (#6871)
* Fixed typos in documentation * Update docs/arm_debugging.md Co-Authored-By: fauxpark <fauxpark@gmail.com> * Update docs/arm_debugging.md Co-Authored-By: fauxpark <fauxpark@gmail.com>master
parent
482ec79e59
commit
de386e5972
|
@ -6,15 +6,15 @@ This guide is catered towards advance users and assumes you can compile an ARM c
|
||||||
|
|
||||||
## Installing the software
|
## Installing the software
|
||||||
|
|
||||||
The main objective here is to get the MCU Eclipse IDE correcly installed on our machine. The necesarry instructions are derived from [this](https://gnu-mcu-eclipse.github.io/install/) install guide.
|
The main objective here is to get the MCU Eclipse IDE correctly installed on our machine. The necessary instructions are derived from [this](https://gnu-mcu-eclipse.github.io/install/) install guide.
|
||||||
|
|
||||||
### The xPack Manager
|
### The xPack Manager
|
||||||
|
|
||||||
This tool is a software package manager and it is used to help us get the necesarry depencencies.
|
This tool is a software package manager and it is used to help us get the necessary dependencies.
|
||||||
|
|
||||||
XPM runs using Node.js so grab that form [here](https://nodejs.org/en/). After installation, open a terminal and type `npm -v`. A reply with the version number means that the instalation was successful.
|
XPM runs using Node.js so grab that from [here](https://nodejs.org/en/). After installation, open a terminal and type `npm -v`. A reply with the version number means that the installation was successful.
|
||||||
|
|
||||||
XPM instalation instructions can be found [here](https://www.npmjs.com/package/xpm) and are OS specific. Entering `xpm --version` to your terminal should return the software version.
|
XPM installation instructions can be found [here](https://www.npmjs.com/package/xpm) and are OS specific. Entering `xpm --version` to your terminal should return the software version.
|
||||||
|
|
||||||
### The ARM Toolchain
|
### The ARM Toolchain
|
||||||
|
|
||||||
|
@ -26,10 +26,10 @@ If you are using windows you need to install this!
|
||||||
|
|
||||||
`xpm install --global @gnu-mcu-eclipse/windows-build-tools`
|
`xpm install --global @gnu-mcu-eclipse/windows-build-tools`
|
||||||
|
|
||||||
### Programer/Debugger Drivers
|
### Programmer/Debugger Drivers
|
||||||
|
|
||||||
Now its the time to install your programer's drivers. This tutorial was made using an ST-Link v2 which you can get from almost anywhere.
|
Now it's time to install your programmer's drivers. This tutorial was made using an ST-Link v2 which you can get from almost anywhere.
|
||||||
If you have an ST-Link the drivers can be found [here](https://www.st.com/en/development-tools/stsw-link009.html) otherwise consult the manufuturer of your tool.
|
If you have an ST-Link the drivers can be found [here](https://www.st.com/en/development-tools/stsw-link009.html) otherwise consult the manufacturer of your tool.
|
||||||
|
|
||||||
### OpenOCD
|
### OpenOCD
|
||||||
|
|
||||||
|
@ -84,4 +84,4 @@ Reset your keyboard.
|
||||||
Press the bug icon and if all goes well you should soon find yourself in the debug perspective. Here the program counter will pause at the beginning of the main function and way for you to press Play. Most of the features of all debuggers work on ARM MCUs but for exact details google is your friend!
|
Press the bug icon and if all goes well you should soon find yourself in the debug perspective. Here the program counter will pause at the beginning of the main function and way for you to press Play. Most of the features of all debuggers work on ARM MCUs but for exact details google is your friend!
|
||||||
|
|
||||||
|
|
||||||
Happy debugging!
|
Happy debugging!
|
||||||
|
|
|
@ -44,7 +44,7 @@ qmk setup # This will clone `qmk/qmk_firmware` and optionally set up your build
|
||||||
We are looking for people to create and maintain a `qmk` package for more operating systems. If you would like to create a package for your OS please follow these guidelines:
|
We are looking for people to create and maintain a `qmk` package for more operating systems. If you would like to create a package for your OS please follow these guidelines:
|
||||||
|
|
||||||
* Follow best practices for your OS when they conflict with these guidelines
|
* Follow best practices for your OS when they conflict with these guidelines
|
||||||
* Documment why in a comment when you do deviate
|
* Document why in a comment when you do deviate
|
||||||
* Install using a virtualenv
|
* Install using a virtualenv
|
||||||
* Instruct the user to set the environment variable `QMK_HOME` to have the firmware source checked out somewhere other than `~/qmk_firmware`.
|
* Instruct the user to set the environment variable `QMK_HOME` to have the firmware source checked out somewhere other than `~/qmk_firmware`.
|
||||||
|
|
||||||
|
|
|
@ -67,7 +67,7 @@ The presence of this file means that the folder is a keyboard target and can be
|
||||||
|
|
||||||
### `<keyboard_name.c>`
|
### `<keyboard_name.c>`
|
||||||
|
|
||||||
This is where you will write custom code for your keyboard. Typically you will write code to initialize and interface with the hardware in your keyboard. If your keyboard consists of only a key matrix with no LEDs, speakers, or other auxillary hardware this file can be blank.
|
This is where you will write custom code for your keyboard. Typically you will write code to initialize and interface with the hardware in your keyboard. If your keyboard consists of only a key matrix with no LEDs, speakers, or other auxiliary hardware this file can be blank.
|
||||||
|
|
||||||
The following functions are typically defined in this file:
|
The following functions are typically defined in this file:
|
||||||
|
|
||||||
|
|
|
@ -109,7 +109,7 @@ After it gets to this point, the build script will look for the DFU bootloader e
|
||||||
dfu-programmer: no device present.
|
dfu-programmer: no device present.
|
||||||
Error: Bootloader not found. Trying again in 5s.
|
Error: Bootloader not found. Trying again in 5s.
|
||||||
|
|
||||||
Once it does this, you'll want to reset the controller. It should then show output similiar to this:
|
Once it does this, you'll want to reset the controller. It should then show output similar to this:
|
||||||
|
|
||||||
```
|
```
|
||||||
*** Attempting to flash, please don't remove device
|
*** Attempting to flash, please don't remove device
|
||||||
|
|
Loading…
Reference in New Issue