Getting Started with HydraBus flash and use hydrafw on windows

Flash and use hydrafw for HydraBus and HydraNFC Shield v2 on Windows

Prerequisites for Windows:

• Putty Terminal or other terminal to communicate with HydraBus board through USB called USB communications device class (or USB CDC).
• Download the latest release (.zip archive example build_HydraFW.xxx.zip): https://github.com/hydrabus/hydrafw_hydranfc_shield_v2/releases
• Optionally you can also build the firmware from source code see https://github.com/hydrabus/hydrafw_hydranfc_shield_v2/blob/master/README.md

Flash hydrafw on Windows:

1) PowerOff HydraBus board (disconnect all USB)

2) Keep pressing UBTN button at PowerON/RESET in order to enter USB DFU (you do not need any jumper wire)

Note: You can also do that step with an HydraNFC connected on Top (or any other official shield)

If you have some problems to enter USB DFU remove all wires/extension connected (on J1/J2/J3) and connect BOOT0 & BOOT1 like described hereafter(it works on any revision of HydraBus Board).

3) Connect MicroUsb cable from PC to HydraBus USB1 board, now windows shall detect a new device

Note: USB DFU is working only on HydraBus USB1 (USB2 cannot be used for that)

If windows have problem to detect the device use an External USB1.1 or 2.0 Hub as there is problem with USB3.0 port/internal USB Hub on some computer and windows version.

4) Install the USB DFU driver

1. Download and Extract archive STSW-STM32080 from URL: http://www.st.com/web/catalog/tools/FM147/CL1794/SC961/SS1533/PF257916

• When archive STSW-STM32080 is extracted follow readme.txt (in root dir) to install USB DFU driver and other tools.

• Also depending on Windows system especially windows 8 or 8.1 it is required to disable signed driver else install of USB DFU Driver is impossible.

  • Step by step tutorial to disable signed driver on Win8.x: https://learn.sparkfun.com/tutorials/disabling-driver-signature-on-windows-8/disabling-signed-driver-enforcement-on-windows-8
  • Then repeat previous step to install USB DFU driver and other tools.

5) Go into the utils\windows_dfu_util folder and run update_fw_usb_dfu_hydrafw.bat (will flash latest firmware during about 10s)

Before this step you shall build the firmware or extract a prebuilt firmware from https://github.com/hydrabus/hydrafw_hydranfc_shield_v2/releases example build_HydraFW.xxx.zip and extract it in root of hydrafw in order to have build directory with all prebuilt files in it. Steps to build the firmware are available in https://github.com/hydrabus/hydrafw_hydranfc_shield_v2

Note: If you have error to update the firmware, change USB port or try with an External USB 2.0 Hub as there is sometimes problems with some USB2.0/USB3.0 ports, then retry this step.

6) Disconnect MicroUsb cable from HydraBus (disconnect also jumper wire "BOOT0 to 3V3" and "BOOT1 to GND" if they was previously connected)

7) Reconnect MicroUsb cable on USB1 or USB2(both port are supported), Now hydrafw is started (ULED shall blink)

Important: Since firmware commit 550cc50 Windows 8.1 and 10 automatically use the standard usbser.sys USB driver, so no any driver shall be manually installed for more details see https://github.com/hydrabus/hydrafw_hydranfc_shield_v2/commit/550cc500240e35e950cd5f7fcf559f033a56bce7

When hydrafw is running and connected on a Windows XP, Vista, 7, 8 you need to install HydraBus Virtual COM Port Driver (only the first time) from: https://github.com/hydrabus/hydrafw_hydranfc_shield_v2/tree/master/utils/windows_usb_driver

• Also depending on Windows system especially Windows 8 it is required to disable signed driver else install of USB CDC driver is impossible.
• Step by step tutorial to disable signed driver on Windows 8: https://learn.sparkfun.com/tutorials/disabling-driver-signature-on-windows-8/disabling-signed-driver-enforcement-on-windows-8
• Retry to install USB CDC driver (from https://github.com/hydrabus/hydrafw_hydranfc_shield_v2/tree/master/utils/windows_usb_driver)
  • You can follow this tutorial to explain how to install USB CDC Driver on Windows https://startingelectronics.org/articles/atmel-ARM/SAM-BA-USB-CDC-driver-install/ thanks to choose https://github.com/hydrabus/hydrafw_hydranfc_shield_v2/tree/master/utils/windows_usb_driver
  • Note: You shall have only one file hydrabus_usb_cdc.inf in its own directory windows_usb_driver before to install the driver (the best is to clone https://github.com/hydrabus/hydrafw_hydranfc_shield_v2/tree/master/utils/windows_usb_driver directory)

Using HydraBus with Putty Terminal on Windows:

1. In order to communicate with HydraBus (Through USB Virtual COM Port), I recommend the use of Putty Terminal
2. HydraFW commands are described in wiki https://github.com/hydrabus/hydrafw_hydranfc_shield_v2/wiki/HydraFW-console-commands

---