diff --git a/HydraBus_HydraNFC_board.jpg b/HydraBus_HydraNFC_board.jpg deleted file mode 100644 index 73d84ed..0000000 Binary files a/HydraBus_HydraNFC_board.jpg and /dev/null differ diff --git a/HydraBus_board.jpg b/HydraBus_board.jpg deleted file mode 100644 index 87f0ef0..0000000 Binary files a/HydraBus_board.jpg and /dev/null differ diff --git a/HydraBus_v1_HydraNFC_Shield_v2.jpg b/HydraBus_v1_HydraNFC_Shield_v2.jpg new file mode 100644 index 0000000..8324ec5 Binary files /dev/null and b/HydraBus_v1_HydraNFC_Shield_v2.jpg differ diff --git a/HydraFW_Default_PinAssignment.png b/HydraFW_Default_PinAssignment.png deleted file mode 100644 index 2870c63..0000000 Binary files a/HydraFW_Default_PinAssignment.png and /dev/null differ diff --git a/README.md b/README.md index 32ecbff..d646b5a 100644 --- a/README.md +++ b/README.md @@ -1,20 +1,79 @@ -HydraFW official firmware for HydraBus/HydraNFC +HydraFW official firmware for HydraBus v1/HydraNFC Shield v2 ======== -HydraFW is a native C (and asm) open source firmware for HydraBus board with support of HydraNFC Shield. +HydraFW is a native C (and asm) open source firmware for HydraBus board with support of HydraNFC Shield v2. +This specific firmware for HydraBus v1/HydraNFC Shield v2 is a fork of https://github.com/hydrabus/hydrafw commit [1cce35acc76758828e4d3a16139fb7899804acbb](https://github.com/hydrabus/hydrafw/commit/1cce35acc76758828e4d3a16139fb7899804acbb) -You can Buy HydraBus/HydraNFC Online: http://hydrabus.com/buy-online +You can Buy HydraBus v1/HydraNFC Shield v2 Online: http://hydrabus.com/buy-online -![HydraBus+HydraNFC board](HydraBus_HydraNFC_board.jpg) +![HydraBus+HydraNFC Shield V2 boards](HydraBus_v1_HydraNFC_Shield_v2.jpg) -![HydraFW default pin assignment](HydraFW_Default_PinAssignment.png) +HydraNFC Shield v2 is based on [STMicroelectronics ST25R3916 NFC chipset](https://www.st.com/en/nfc/st25r3916.html) which is today the most powerful and versatile NFC chipset available on the market. +HydraNFC Shield v2 is for anyone interested in Learning/Developping/Debugging/Hacking/Penetration Testing for basic or advanced NFC communications. -* Getting Started with HydraBus: https://github.com/hydrabus/hydrafw/wiki/Getting-Started-with-HydraBus -* HydraFW Wiki: https://github.com/hydrabus/hydrafw/wiki -* HydraFW usage with VT100 Terminal see wiki https://github.com/hydrabus/hydrafw/wiki/HydraFW-commands -* For more details on HydraBus Hardware and Firmware see also: https://github.com/hydrabus/hydrabus -* For more details on HydraNFC Hardware see: https://github.com/hydrabus/hydranfc -* If you want to help on this project see: - * [Coding Styles](https://github.com/hydrabus/hydrafw/blob/master/CODING_STYLE.md), [Wiki](https://github.com/hydrabus/hydrafw/wiki) & [Wiki Task List](https://github.com/hydrabus/hydrafw/wiki/Task-List) - * [How to Build/Flash/Use HydraFW on Windows](https://github.com/hydrabus/hydrafw/wiki/how-to-build-flash-and-use-hydrafw-on-windows) - * [How to Build/Flash/Use HydraFW on Linux](https://github.com/hydrabus/hydrafw/wiki/how-to-build-flash-and-use-hydrafw-on-linux) +**Key Features of HydraNFC Shield V2 hardware (with HydraNFC v2 Antenna):** +* Operating modes + * Reader/writer + * Card emulation (Type A and Type F Tags are supported natively, other tags can be supported with Special stream and Transparent modes) + * Active and passive peer to peer +* RF communication + * EMVCo™ 3.0 analog and digital compliant + * NFC-A / ISO14443A up to 848 kbit/s + * NFC-B / ISO14443B up to 848 kbit/s + * NFC-F / FeliCa™ up to 424 kbit/s + * NFC-V / ISO15693 up to 53 kb/s + * NFC-A / ISO14443A and NFC-F / FeliCa™ card emulation + * Active and passive peer to peer initiator and target modes, up to 424 kbit/s + * Low level modes (Special stream and Transparent modes) to implement MIFARE Classic® compliant or other custom protocols +* Key features + * 1.6W output power at 5V with Differential Antenna and Variable capacitors for NFC Automatic antenna tuning (AAT) + * Reader/writer mode range is more than 12cm for NFC-A (ISO14443A) Tags(Credit Card format) + * Reader/writer mode range is more than 16cm for NFC-V (ISO15693) Tags(ST25 Tag 5cm x 5cm) + * Dynamic power output (DPO) controls the field strength to stay within given limits + * Active wave shaping (AWS) reduces over-and under-shoots + * Noise suppression receiver (NSR) allows reception in noisy environment + * Integrated EMVCo 3.0 compliant EMD handling + * Automatic gain control and squelch feature to maximize SNR + * Low power capacitive and inductive card detection + * Low power NFC active and passive target modes + * Adjustable ASK modulation depth, from 5 to 40% + * Integrated regulators to boost system PSRR + * AM/PM and I/Q demodulator with baseband channel summation or automatic channel selection + * Possibility to drive two independent single ended antennas (default use differential antenna) + * Measurement of antenna voltage amplitude and phase, RSSI, on-chip supply and regulated voltages +* External communication interfaces + * 512-byte FIFO + * Serial peripheral interface (SPI) up to 10 Mbit/s (Tested with success on HydraBus v1 at 10.5Mbit/s) +* Electrical characteristics + * Wide supply voltage and ambient temperature range (2.6 to 5.5 V from -40 °C to +105 °C, 2.4 to 5.5 V from -20 °C to +105 °C) + * Wide peripheral communication supply range, from 1.65 to 5.5 V + * Quartz oscillator operating with 27.12 MHz crystal with fast start-up + +**Key Features of HydraFW (for HydraBus v1/HydraNFC Shield v2 hardware) firmware using [STMicroelectronics RFAL for ST25R3916](https://www.st.com/content/st_com/en/products/embedded-software/st25-nfc-rfid-software/stsw-st25rfal002.html):** +This firmware is fully open source and based on HydraFW and is specific to HydraBus v1 with HydraNFC Shield v2 it use [STMicroelectronics RFAL for ST25R3916](https://www.st.com/content/st_com/en/products/embedded-software/st25-nfc-rfid-software/stsw-st25rfal002.html) +The RFAL simplifies the development of applications by encapsulating device and protocol details. +* Complete middleware to build NFC enabled applications based on the ST25R3916 device +* Supported modes: + * Reader/Writer + * P2P initiator (PCM and ACM) + * P2P target (PCM and ACM) + * Card emulation +* Support of major NFC and proprietary technologies: + * NFC-A (ISO14443A) + * NFC-B (ISO14443B) + * NFC-F (FeliCa™) + * NFC-V (ISO15693) + * P2P (ISO18092) + * ST25TB, Kovio, B’, iClass, Calypso® +* Supported protocols: + * ISO-DEP (ISO data exchange protocol, ISO14443-4) + * NFC-DEP (NFC data exchange protocol, ISO18092) +* Easy portability across different platforms (MCUs/RTOSs/OSs) +* Compliant with main RF/NFC standards: + * NFC Forum + * EMVCo™ + * ISO14443 + * ISO15693 + * ISO18092 +* MISRA C:2012 compliant +* Free, user-friendly license terms