pi-pm3/LED_MAPPINGS.md

Proxmark3 LED Mappings Reference

Proxmark3 Easy

Based on hardware testing with Proxmark3 Easy and LED_ORDER=PM3EASY:

LED Configuration

LED	Color	GPIO Pin	PWM Channel	Brightness	Physical Position
A	Green	PA0	PWM0	✅ 0-100%	1st (leftmost)
B	Blue	PA2	PWM2	✅ 0-100%	4th (rightmost)
C	Orange	PA9	None	On/Off	2nd
D	Red	PA8	None	On/Off	3rd

Physical LED order (left to right): Green, Orange, Red, Blue

GPIO Pin Details

From include/config_gpio.h with LED_ORDER_PM3EASY:

#define GPIO_LED_A    AT91C_PIO_PA0   // Green - PWM0 capable
#define GPIO_LED_B    AT91C_PIO_PA2   // Blue - PWM2 capable
#define GPIO_LED_C    AT91C_PIO_PA9   // Orange - GPIO only
#define GPIO_LED_D    AT91C_PIO_PA8   // Red - GPIO only

LED Bitmask Values

LED	Bitmask (decimal)	Bitmask (hex)	Binary
A	1	0x01	0001
B	2	0x02	0010
C	4	0x04	0100
D	8	0x08	1000
All	15	0x0F	1111

Standard Proxmark3 (Non-Easy)

With default LED ordering (no LED_ORDER_PM3EASY):

LED	Color	GPIO Pin	PWM Channel	Notes
A	Orange	PA0	PWM0	✅ Brightness capable
B	Green	PA8	None	On/Off only
C	Red	PA9	None	On/Off only
D	Red2	PA2	PWM2	✅ Brightness capable

Note: Only LEDs on PA0 and PA2 can use PWM brightness control on any PM3 variant.

Usage Examples

Proxmark3 Easy

# Green LED at 50% brightness
hw led --led a --brightness 50

# Blue LED at 75% brightness
hw led --led b --brightness 75

# Orange LED on (no brightness control)
hw led --led c --on

# Red LED toggle
hw led --led d --toggle

# Both PWM LEDs at 30%
hw led --led a,b --brightness 30

Multi-Device Identification

Use brightness levels to distinguish between multiple Proxmark3 devices:

# Device 1: Dim green
hw led --led a --brightness 20

# Device 2: Bright blue
hw led --led b --brightness 100

# Device 3: Medium green + dim blue
hw led --led a --brightness 60
hw led --led b --brightness 30

Hardware Testing Notes

• Confirmed via individual LED testing on PM3 Easy hardware
• During hw tune: Red (D) and Blue (B) LEDs typically active
• During flashing: Orange (C) and sometimes Green (A) visible
• LED polarity: Active-low (PWM duty cycle is inverted)

Code References

• LED definitions: armsrc/util.h lines 45-63
• LED macros: include/proxmark3_arm.h lines 91-102
• GPIO mapping: include/config_gpio.h lines 22-39
• PWM functions: armsrc/util.c lines 419-504

---

Last Updated: 2025-12-02 Hardware: Proxmark3 Easy with LED_ORDER=PM3EASY