usb_hid_host - GitLite

KO | EN

gitlite — search

#python #react #ai #typescript #go #machine-learning #linux #nodejs #windows #awesome #awesome-list #security #ios #openai

usb_hid_host

(★ 176)

A compact USB HID host FPGA core supporting keyboards, mice and gamepads.

파일 탐색기

최종 버전 다운로드 (.zip)

- - hid_printer.v
  - print.vh
  - uart_tx_V2.v
  - utils.vh
- - build.ys
  - Makefile
  - top.v
  - usb_hid_host_demo.pcf
- - build.ys
  - clock.v
  - ecppll.py
  - Makefile
  - top.v
  - usb_hid_host_demo.lpf
- - build.ys
  - clock.v
  - Makefile
  - top.v
  - usb_hid_host_demo.pcf
- - build.ys
  - clock.v
  - Makefile
  - top.v
  - usb_hid_host_demo.lpf
- - tang-nano-20k.gprj
  - tang-primer-25k.gprj
  - top.v
- - build.ys
  - clock.v
  - ecppll.py
  - Makefile
  - top.v
  - ulx3s_v20.lpf
- usb_hid_host.md
- usb_hid_host_demo.png
- usb_hid_host_setup.jpg
- - asukp.py
  - ukp.s
- usb_hid_host.v
- usb_hid_host_rom.hex
- usb_hid_host_rom.v
LICENSE
README.md

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/nand2mario/usb_hid_host

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd usb_hid_host

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Make

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Make Linux/macOS는 보통 기본 설치되어 있습니다. Windows는 별도 설치(예: MSYS2, WSL)가 필요합니다.

⚠️ 이 프로젝트는 규모가 큰 저장소라, 이 방법이 실제 핵심 제품이 아니라 내부 하위 패키지를 가리키는 것일 수 있습니다. README 전체를 함께 확인해보세요.

cd boards/icebreaker

이 프로젝트의 관련 파일이 하위 폴더 안에 있어서, 먼저 그 폴더로 이동합니다.

make

생성된 빌드 설정을 바탕으로 실제 컴파일을 진행해 실행 파일을 만듭니다.

✅ 에러 없이 끝나면 성공입니다. 생성된 실행 파일을 직접 실행해보세요.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Compact USB HID host FPGA core

nand2mario, 8/2023

Usb_hid_host is a compact FPGA core designed to support USB keyboards, mice and gamepads. It is designed mainly for FPGA retro gaming and computing projects. The most significant advantage is its all-in-one design. It does not require a CPU to work. And it is quite small (<300 LUTs, <250 registers and 1 BRAM block).

To use usb_hid_host, simply add `usb_hid_host.v`, `usb_hid_host_rom.v` and `usb_hid_host_rom.hex` to your project. The module interface in `usb_hid_host.v` should be sufficiently documented to get you started.

For FPGA boards with pmod ports, [usb_host_pmod](https://github.com/nand2mario/usb_host_pmod) is a pmod module designed to work with usb_hid_host.

Please refer to [usb_hid_host.md](doc/usb_hid_host.md) for a more comprehensive introduction to the design of the core.

## Sample projects

Sample projects are available for the following boards to demonstrate the usage of usb_hid_host.

* [Tang Nano 20K](boards/tang-nano-20k/) (Gowin GW2A FPGA). Gowin IDE project file `usb_hid_proj.gprj` is provided. Simply open it in Gowin IDE and build the project. 
* [IceSugar-Pro](boards/icesugar-pro/) and [Machdyne Schoko](boards/schoko/) (Lattice ECP5). These come with Makefiles for the open source Yosys/nextpnr toolchain. 
* [iCEBreaker](boards/icebreaker) and [Machdyne Riegel](boards/riegel/) (Lattice iCE40), also building with Yosys/nextpnr.

Connect your USB devices and expect results similar to the following.

<img src='doc/usb_hid_host_demo.png' width=450> <img src='doc/usb_hid_host_setup.jpg' width=380>

Usb_hid_host does not rely on vendor-specific primitives, making it compatible with most FPGAs and boards. If you encounter any problems, please submit an issue.

## Improvements under consideration

* Better compatibility for low-speed gamepads through VID/PID identification.
* Support XBOX360-compatible controllers (needs USB full-speed).
* Support USB hubs (also needs USB full-speed).
* Support MIDI devices.

## Credit

* Based on [hi631's project](https://github.com/hi631/tang-nano-9K/tree/master/NES) supporting USB gamepad on Tang Nano 9K.