hydrausb3_fw icon indicating copy to clipboard operation
hydrausb3_fw copied to clipboard

HydraUSB3 (WCH CH569) open source test firmware / examples / libraries to experiment with streaming / high-speed protocols (USB2 HS, USB3 SS, HSPI, SerDes...)

HydraUSB3 v1 Test firmware / examples

hydrausb3_fw repository contains open source (see LICENSE) test firmware / examples for HydraUSB3 v1 devkit using WCH CH569 MCU.

  • Contributor shall check CODING_STYLE.md

For more details on HydraUSB3 see https://hydrabus.com/hydrausb3-v1-0-specifications

All examples with name HydraUSB3_DualBoard_XXX requires 2x HydraUSB3 v1 boards to be plugged together.

  • First HydraUSB3 board shall have PB24 not populated (called RX mode)
  • Seconds HydraUSB3 board shall have PB24 populated with a 2.54mm Jumper (called TX mode)

2xHydraUSB3 plugged together

wch-ch56x-bsp submodule contains the BSP (Board Support Package) based on WCH official code from https://github.com/openwch/ch569/tree/main/EVT/EXAM/SRC (but heavily refactored/rewritten on lot of parts)

How to build/flash and use firmwares examples / source code for HydraUSB3(CH569 MCU)

For Linux:

  • See Wiki How to build flash and use examples on Linux with shell:
    • https://github.com/hydrausb3/hydrausb3_fw/wiki/how-to-build-flash-and-use-examples-on-linux
  • See Wiki How to build flash and use examples on Linux with Eclipse IDE:
    • https://github.com/hydrausb3/hydrausb3_fw/wiki/how-to-build-flash-and-use-examples-on-linux-Eclipse-IDE

For Windows(requires MSYS2/MINGW64):

  • See Wiki How to build flash and use examples on Windows with MSYS2/MINGW64 shell:
    • https://github.com/hydrausb3/hydrausb3_fw/wiki/how-to-build-flash-and-use-examples-on-windows
  • See Wiki How to build flash and use examples on Windows with Eclipse IDE:
    • https://github.com/hydrausb3/hydrausb3_fw/wiki/how-to-build-flash-and-use-examples-on-windows-Eclipse-IDE