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,79 @@
+# 폐쇄망 Windows 11 — 오프라인 빌드/실행
+
+이 저장소의 `vendor/` 에는 **인터넷 없이** 설치·실행할 수 있는 파일이 포함되어 있습니다.
+
+## 포함 내용
+
+- `vendor/wheels/*.whl` — pyusb, pynput, setuptools, pip, virtualenv 등
+- `vendor/libusb-1.0.dll` — libusb x64
+- `vendor/python-windows/` — Python 3.11.9 embeddable (시스템 Python 불필요)
+- `vendor/get-pip.py` — 오프라인 pip 설치
+- `vendor/tools/zadig.exe` — WinUSB 바인딩 (폐쇄망용, 오프라인)
+
+## 지원 케이블
+
+| 모델 | USB ID | 비고 |
+|------|--------|------|
+| **JUC500** | `0711:7500` | Interface 5 (MI_05) bulk 파일 전송 |
+
+## 대상 PC에서 **신규** 설치
+
+1. 소스 트리 전체를 USB 등으로 복사 (특히 `vendor/` 누락 금지)
+   - Mac에서 전체 zip: `./scripts/make_windows_bundle.sh` (`.venv` 제외, `vendor/` 포함)
+2. Git Bash (권장):
+
+```bash
+cd /c/dev/juc500
+./start_win.sh
+```
+
+첫 실행 시 `vendor/` 로 `.venv`·`libusb` 가 **자동 생성**됩니다.
+
+또는 CMD:
+
+```bat
+cd c:\dev\juc500
+scripts\setup_windows.bat
+.\start.bat
+```
+
+## 이미 설치된 PC에 **소스 업데이트만** (폐쇄망)
+
+Mac에서:
+
+```bash
+./scripts/make_offline_windows_update.sh
+```
+
+생성물:
+
+- `dist-offline/juc500-offline-update-*.zip`
+- 바탕화면 동일 zip
+- `vendor/tools/zadig.exe`, `vendor/wheels`, `juc500_xfer/*`, `apply_offline_update.bat` 포함
+
+Windows에서:
+
+1. zip을 USB로 복사·압축 해제  
+2. JUC500 GUI 종료  
+3. `apply_offline_update.bat` 실행 (기본 `C:\dev\juc500`)  
+4. `start.bat` 재실행 → 상단 빌드 태그가 `BUILD.txt`의 `XFER_BUILD`와 일치하는지 확인  
+
+인터넷·PyPI 불필요.
+
+## USB / WinUSB
+
+장치 Interface 5 는 **Zadig → WinUSB** 가 필요합니다.
+
+```
+vendor\tools\zadig.exe
+```
+
+Options → List All Devices → `Smart Data Link` (0711:7500) → **Interface 5 (MI_05)** → WinUSB.
+
+## 온라인 PC에서 vendor 갱신
+
+```bat
+python -m pip download -d vendor\wheels ^
+  pyusb==1.2.1 pynput==1.8.2 six==1.17.0 ^
+  "setuptools>=68" wheel packaging pip build virtualenv
+```