juc500 정상동작

2026-07-21 21:04:25 +09:00
parent ff60cee1cc
commit 1388668b56
2917 changed files with 708021 additions and 651 deletions
@@ -0,0 +1,81 @@
+# Windows 11 설정
+
+## 연결 시 Access denied (Interface 5)
+
+```
+USB interface 5 점유 실패: [Errno 13] Access denied
+```
+
+→ 케이블은 보이지만 Interface 5가 WinUSB가 아닙니다.  
+자세한 단계: [`WINDOWS-ACCESS-DENIED.md`](WINDOWS-ACCESS-DENIED.md)
+
+요약: GUI **Wormhole 종료** → Zadig → **List All Devices** → **Smart Data Link (Interface 5) / MI_05** → **WinUSB** → Replace Driver → 케이블 재연결.
+
+## 소스에서 실행 (오프라인 wheel 포함)
+
+저장소의 `vendor/wheels/pyusb-1.2.1-py3-none-any.whl` 을 사용합니다. PyPI 접속이 없어도 됩니다.
+
+```powershell
+cd juc500
+py -3 -m venv .venv
+.\.venv\Scripts\Activate.ps1
+python -m pip install --no-index --find-links=vendor\wheels -r requirements.txt
+pip install -e .
+python -m juc500_xfer gui
+```
+
+또는 `scripts\setup_windows.bat`
+
+설치 후 실행 (Git Bash):
+
+```bash
+./start.sh
+```
+
+CMD/탐색기에서는 `start.bat` 을 사용해도 됩니다.
+
+## 설치파일 사용 (권장)
+
+1. `JUC500-Setup-win64.exe` 실행해 설치  
+   또는 `JUC500-portable.exe` / zip 포터블 사용  
+2. 아래 **Zadig WinUSB** 설정  
+3. `JUC500` 실행 → 브라우저 GUI → **연결**
+
+Mac에서 빌드 산출물 받기:
+
+```bash
+./build-installer-windows.sh --ci
+```
+
+## 1. Zadig로 WinUSB 바인딩
+
+1. [Zadig](https://zadig.akeo.ie/) 실행 (관리자)  
+2. Options → **List All Devices**  
+3. `Smart Data Link` 선택  
+4. 하단에서 **Interface 5** 선택 → Driver: **WinUSB** → Replace Driver  
+5. 마찬가지로 **Interface 1** (CDC Data) 권장  
+6. Interface 2(Mass Storage), 3·4(HID) 는 그대로 두세요.
+
+공식 Wormhole가 설치돼 있으면 GUI의 **Wormhole 종료** 또는 `python -m juc500_xfer kill-wormhole` 후 Zadig를 실행하세요.
+
+## 2. libusb DLL
+
+[libusb releases](https://github.com/libusb/libusb/releases) 에서 MS64/dll을 받아:
+
+```
+juc500/vendor/libusb-1.0.dll
+```
+
+에 두거나 PATH에 추가합니다.
+
+## 3. 실행
+
+```powershell
+py -3 -m venv .venv
+.\.venv\Scripts\Activate.ps1
+pip install -r requirements.txt
+python -m juc500_xfer info
+python -m juc500_xfer recv --dest $env:USERPROFILE\Downloads -y
+```
+
+Mac 쪽에서 `send` 하면 전송이 시작됩니다.