swapped PM3OTHER -> PM3GENERIC, while keeping PM3OTHER functionalitwise for backwards compat.

This commit is contained in:
iceman1001 2021-01-14 14:23:00 +01:00
commit d7baee2f0c
6 changed files with 24 additions and 21 deletions

View file

@ -34,17 +34,17 @@ E.g. you might need to move the documentation elsewhere according to your distro
make install PREFIX=/usr INSTALLDOCSRELPATH=share/doc/proxmark3-${version}
```
It's possible to add other firmwares as well with tagged names (`FWTAG=<mytag>`), e.g. here we're compiling another image for non-RDV4 devices:
It's possible to add other firmwares as well with tagged names (`FWTAG=<mytag>`), e.g. here we're compiling another image for generic Proxmark3 devices:
```
make -j fullimage PLATFORM=PM3OTHER PLATFORM_EXTRAS=
make fullimage/install PLATFORM=PM3OTHER PLATFORM_EXTRAS= DESTDIR=build PREFIX=/usr FWTAG=other
make -j fullimage PLATFORM=PM3GENERIC PLATFORM_EXTRAS=
make fullimage/install PLATFORM=PM3GENERIC PLATFORM_EXTRAS= DESTDIR=build PREFIX=/usr FWTAG=generic
```
and it will be added along the other firmware as:
and it will be added along the other firmwares as:
```
./build/usr/share/proxmark3/firmware/fullimage-other.elf
./build/usr/share/proxmark3/firmware/fullimage-generic.elf
```
For verbose usage and see the actual commands being executed, add `V=1`.

View file

@ -91,7 +91,7 @@ At the moment both are maintained because they don't perfectly overlap yet.
| Feature | Makefile | Remarks |
|-----|---|---|
| Platform choice | `PLATFORM=` | values: `PM3RDV4`, `PM3OTHER` |
| Platform choice | `PLATFORM=` | values: `PM3RDV4`, `PM3GENERIC` |
| Platform size | `PLATFORM_SIZE=` | values: `256`, `512` |
| Platform extras | `PLATFORM_EXTRAS=` | values: `BTADDON`, `FPC_USART_DEV` |
| Skip LF/HF techs in the firmware | `SKIP_`*`=1` | see `common_arm/Makefile.hal` for a list |

View file

@ -29,8 +29,8 @@ make SKIPBT=1
## Firmware
By default, the firmware is of course tuned for the Proxmark3 Rdv4.0 device, which has built-in support for 256kb onboard flash SPI memory, Sim module (smart card support), FPC connector.
These features make it very different from all other devices, there is non other like this one.
By default, the firmware is of course tuned for the Proxmark3 RDV4 device, which has built-in support for 256kb onboard flash SPI memory, Sim module (smart card support), FPC connector.
These features make it very different from all other Proxmark3 devices, there is non other like this one.
**Recommendation**: if you don't have a RDV4, we strongly recommend your device to have at least a 512kb arm chip, since this repo is crossing 256kb limit. There is still a way to skip parts to make it fit on a 256kb device, see below.
@ -43,8 +43,8 @@ Here are the supported values you can assign to `PLATFORM` in `Makefile.platform
| PLATFORM | DESCRIPTION |
|-----------------|--------------------------|
| PM3RDV4 (def) | Proxmark3 rdv4 |
| PM3OTHER | Proxmark3 generic target |
| PM3RDV4 (def) | Proxmark3 RDV4 |
| PM3GENERIC | Proxmark3 generic target |
By default `PLATFORM=PM3RDV4`.
@ -103,7 +103,7 @@ By default `STANDALONE=HF_MSDSAL`.
If you own a Proxmark3 Easy with only 256kb, you can use a few definitions to help you getting a smaller firmware.
First thing is of course to use the `PLATFORM=PM3OTHER`.
First thing is of course to use the `PLATFORM=PM3GENERIC`.
Adding `PLATFORM_SIZE=256` will provoke an error during compilation of the recovery image if your image is too big, so you can detect the problem before trying to flash the Proxmark3, e.g.
```
[=] GEN proxmark3_recovery.bin
@ -133,7 +133,7 @@ a series of `SKIP_*` allow to skip some of the functionalities and to get a smal
So for example, at the time of writing, this is a valid `Makefile.platform` compiling an image for 256k:
```
PLATFORM=PM3OTHER
PLATFORM=PM3GENERIC
PLATFORM_SIZE=256
STANDALONE=
SKIP_HITAG=1