Files

97 lines
3.2 KiB
Markdown

# LF_PROX2BRUTE — HID ProxII Bruteforce v2
> **Author:** Yann Gascuel
> **Frequency:** LF (125 kHz)
> **Hardware:** Generic Proxmark3
[Back to Standalone Modes Index](../../armsrc/Standalone/readme.md#individual-mode-documentation) | [Source Code](../../armsrc/Standalone/lf_prox2brute.c) | [Development Guide](../../armsrc/Standalone/readme.md#developing-standalone-modes)
---
## What
An improved version of [ProxBrute](lf_proxbrute.md) that brute forces HID ProxII H10301 26-bit card numbers over a **configurable range** with compile-time settings for facility code, start number, and end number.
## Why
The original ProxBrute requires reading a card first and only goes downward. Prox2Brute lets you pre-configure the exact facility code and card number range to test — no need to capture a card first. It's faster because it's purpose-built for the H10301 26-bit format with optimized timing between attempts.
Use this when:
- You already know the facility code (from reconnaissance or a previous capture)
- You want to test a specific card number range
- You need faster iteration than the original ProxBrute
## How
1. Configure the target parameters at compile time via `#define` directives: `FACILITY_CODE`, `CARDNUM_START`, `CARDNUM_END`
2. On startup, press the button to begin
3. The device iterates through each card number, simulating the HID 26-bit format
4. LEDs cycle in binary to show progress
5. Hold button for 1 second to exit
## LED Indicators
| LED | Meaning |
|-----|---------|
| **A** | Inverts every attempt — fast blink = running |
| **B** | Inverts every 8 attempts |
| **C** | Inverts every 16 attempts |
| **D** | Inverts every 32 attempts — slow blink = progress |
| **D** (initial) | Waiting for button press to start |
| **C** (initial) | Ready indicator |
The LED pattern creates a visual binary counter showing brute force progress at a glance.
## Button Controls
| Action | Effect |
|--------|--------|
| **Hold 200ms** | Start brute force |
| **Hold ≥ 1 second** (during brute) | Exit brute force |
| **USB command** | Exit standalone mode |
## State Machine
```mermaid
stateDiagram-v2
[*] --> WaitStart : Startup\nLED_D on
WaitStart --> BruteLoop : Button hold 200ms\nLED_C on (ready)
BruteLoop --> BruteLoop : Simulate CN++\nLEDs show binary progress
BruteLoop --> Complete : CN > CARDNUM_END
BruteLoop --> [*] : Button hold ≥ 1s
Complete --> [*] : All numbers tested
note right of BruteLoop
FC = FACILITY_CODE (compile-time)
CN iterates CARDNUM_START → CARDNUM_END
LEDs A/B/C/D show binary counter
end note
```
## Compile-Time Configuration
Edit the `#define` values in the source code before compiling:
```c
#define FACILITY_CODE 111 // Target facility code
#define CARDNUM_START 1 // First card number to try
#define CARDNUM_END 65535 // Last card number to try
```
## Compilation
```
make clean
make STANDALONE=LF_PROX2BRUTE -j
./pm3-flash-fullimage
```
## Related
- [ProxBrute](lf_proxbrute.md) — Original ProxII brute (reads card first, goes downward)
- [HID Corporate Brute](lf_hidbrute.md) — Corporate 1000 format brute force
- [HID FC Brute](lf_hidfcbrute.md) — Facility code brute force