Commit Graph

5 Commits

Author SHA1 Message Date
c61f73fa33 build: app.spec에 빌드 명령어 안내 주석 추가, exe 이름을 팔레타이징으로 고정
- pyinstaller app.spec 한 번으로 dist\app\팔레타이징.exe 가 바로 나오도록
  EXE name 변경 (기존: app.exe 빌드 후 수동 이름 변경)
- 빌드용 패키지 설치 명령과 파이썬 버전 참고사항을 spec 상단에 문서화

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-07 16:40:11 +09:00
64c333e04d docs: 스태커 실제 동작(하부 적층 방식) 기준으로 주석/상수명 정정
현장 확인 결과 스태커는 상부 압축이 아니라 하부 적층(bottom-stacking) 장치:
- 책 인입(DI0) -> 리프터(coil0)가 책을 위로 밀어올림 -> 선반(coil1) 열림/닫힘
  -> 새 책이 스택 맨 아래에 끼워진 채 선반 위에 걸쳐짐 -> 픽업량 도달(DI1) 시 로봇 픽업
- 리프터 상승 중(DI3=0)에는 컨베이어 일시정지 연동

변경 사항 (로직/타이밍 변경 없음, 명칭/주석만):
- 스태커 상수명 정정: LIFT_START_WAIT / SHELF_OPEN_DELAY / SHELF_OPEN_TIME / SHELF_CLOSE_SETTLE
- 헤더 I/O 맵, [스태커 동작 원리] 섹션, 스레드/픽업 조건 주석 전면 정정
- DO0 그리퍼 명칭을 누름판(포크 받침 + 상부 누름 고정) 구조로 명확화

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-07 16:33:49 +09:00
3d8521ad89 perf: 택타임 단축(권당 약 2.5~3초) 및 전체 주석/문서화 정비
[택타임 개선 - 값 변경]
- 픽업 전 실린더 후퇴 대기 save_time 2.0s -> 0.5s (GRIPPER_RETRACT_WAIT)
- 적재 푸셔 유지 대기 1.0s -> 0.6s (PUSH_HOLD_WAIT)
- 포크 인출 후 대기 0.5s -> 0.3s (FORK_EXIT_WAIT)
- 수직 그리퍼 해제 대기 0.3/0.2s -> 0.2s 통일 (RELEASE_WAIT)
- in-pos 폴링 가드 0.1s -> 0.05s (IN_POS_GUARD_TIME, 권당 8~10회 호출)
- 스태커 픽업 대기 백오프 2.0s -> 0.5s (STACKER_BACKOFF)

[택타임 개선 - 구조]
- 메인 루프/is_in_pose/JKS 폴링의 무간격 busy-wait에 폴링 간격 추가
  (상태 스레드 GIL 기아 해소 -> 센서 반응 지연 감소)
- 높이탐색 폴링 루프의 매회 print 제거 (콘솔 블록으로 인한 멈칫 위험 제거)
- 경광등 DO를 변경 시에만 전송 (0.1s마다 3회 재전송하던 컨트롤러 통신 부하 제거)

[안전성 보강]
- is_in_pose/높이탐색: 통신 오류 시 재시도 (오류 값으로 진행하던 잠재 버그 수정)
- 비상정지 중 EMO 고속 반복 호출로 인한 컨트롤러 통신 폭주 방지

[가독성]
- 모든 대기시간을 파일 상단 상수 블록으로 모으고 기존값/튜닝 가이드 주석 명시
- 모듈 헤더에 시스템 개요/IO 맵/스레드 구조 문서화, 전 함수 docstring 추가
- 픽업/적재 시퀀스 단계 주석, 죽은 코드 제거, 오타 수정 (파지/적재 대기값은 기존 유지)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-07 15:07:40 +09:00
461d5feb01 chore: .gitignore 보강 및 PyInstaller spec 추가
- build/, dist/, __pycache__/, .claude/, _backup/ 제외 처리
- 실행파일 빌드용 app.spec 버전 관리에 포함

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-07 14:23:23 +09:00
4176f04a61 first commit 2026-08-04 14:31:11 +09:00