핑퐁로봇 검증 버전은 파이썬 3.10.11입니다. 최신 버전(3.12, 3.13 등)을 설치하면 라이브러리 호환 오류의 원인이 됩니다:

• python.org 첫 화면의 큰 다운로드 버튼(최신 버전)을 누르지 말고, [All releases]에서 3.10.11을 찾아 Windows installer (64-bit)를 다운로드
• 설치 첫 화면에서 'Add python.exe to PATH' 체크 필수 — 빠뜨리면 명령이 실행되지 않습니다
• 마지막 창의 [Disable path length limit]까지 클릭해야 설치 완료
• 이미 다른 파이썬이 있어도 3.10.11을 추가 설치하면 됩니다. PowerShell에서 python –version이 3.10.11이 아니면: 검색창 '환경 변수' → Path 편집 → Python310 줄을 맨 위로 이동

💡 미니콘다도 검증 버전 23.10.0 사용을 권장합니다. 다운로드 페이지에는 최신 버전이 먼저 보이므로, 선생님이 검증 버전 설치 파일을 미리 받아 USB/공유폴더로 배포하면 수업이 매끄럽습니다.

큐브에 내장된 센서(버튼, 적외선 근접, 자이로·가속도) 외에도, 큐브의 4핀 확장 포트에 외부 센서를 연결할 수 있습니다:

• 센서킷: 빛(조도), 소리, 온도, 자석, 볼륨(가변저항), 컬러, 초음파(거리 2~255cm), 8×8 도트매트릭스, RC 서보모터
• 확장 보드: 큐비노(아두이노 UNO 호환), 아두이노 나노 아답터, 마이크로비트 엣지 커넥터

💡 조도 센서로 스마트 가로등, 초음파 센서로 장애물 감지 자율주행, 온도 센서로 IoT 온도계 등 생활 속 프로젝트 수업을 구성할 수 있습니다.

대부분 프롬프트의 현재 위치가 교육자료 폴더가 아니어서 생기는 문제입니다. 순서대로 점검하세요:

1. 교육자료 PingPong_Python_BLE 압축을 풀었는지 확인 (압축 파일 상태로는 안 됩니다)
2. 'Anaconda Prompt (miniconda3)'에서 실행 중인지 확인 — 일반 PowerShell에서는 'conda가 인식되지 않는다'는 오류가 납니다
3. cd로 압축 푼 폴더까지 이동 — 경로 입력이 어려우면 폴더를 프롬프트 창에 드래그 앤 드롭하는 것이 가장 확실합니다
4. OneDrive를 쓰는 PC는 바탕화면 실제 경로가 'C:Users이름OneDrive바탕 화면'이라서 cd Desktop… 이 실패할 수 있습니다 → 드래그 앤 드롭 사용
5. 사용자명이 한글인 계정은 경로 문제가 생길 수 있으니 경로를 복사해 붙여넣기
6. Proceed ([y]/n)? 가 나오면 y 입력. 생성은 2~5분 걸리며 처음 한 번만 하면 됩니다 (conda env list로 생성 확인)

💡 생성(create)은 한 번, 활성화(conda activate pingpong)는 프롬프트를 새로 열 때마다 매번 필요합니다.

네. 초·중·고 교내 축제 및 전시회 등에서 진로/기술 체험 부스 운영을 대행합니다. 로봇·AI·코딩 융합 체험 프로그램:

• 언플러그 알고리즘 메이커 · G큐브 스포츠 콘테스트 · 타임어택 자동차 경주 · AI 로봇 축구 토너먼트 · AI 메이즈 이스케이프 등

부스 운영 문의: 02-6956-2237 / qna@roborisen.com (교구 대여 문의도 가능합니다)

① 초기 설정 블록(연결)을 실행하지 않은 채 ② 동작 블록부터 실행했을 때 나는 오류입니다. 커널을 재시작한 직후 아래 셀만 다시 실행할 때 가장 자주 발생합니다:

• 항상 ①연결 → ②동작 → ③종료 순서로 실행하고, 커널을 재시작했다면 반드시 ①부터 다시 실행
• 함수 이름 오타(예: run_motor를 runmotor로)도 같은 NameError가 납니다

함께 알아두면 좋은 오류 읽는 법 (빨간 글씨 맨 아랫줄부터 읽습니다):

• IndentationError: 들여쓰기(띄어쓰기)가 어긋남 → 해당 줄 앞 공백을 위아래 줄과 맞추기(보통 4칸)
• SyntaxError: 문법 오류 → 그 줄의 괄호 짝과 줄 끝의 콜론(:) 확인
• ModuleNotFoundError: 라이브러리 없음 → Q85 참조

💡 오류 메시지는 실패가 아니라 단서입니다. 빨간 글씨를 그대로 복사해 ChatGPT 핑퐁 프로젝트에 상황과 함께 붙여넣으면 수정된 코드를 받을 수 있습니다 — 'AI와 함께 디버깅'도 바이브 코딩입니다.

라이브러리를 찾지 못하는 상태입니다. 실행 위치와 가상환경을 점검하세요:

1. 프롬프트 맨 앞이 (pingpong)인지 확인 — (base) 상태라면 conda activate pingpong 입력
2. 주피터 노트북은 반드시 PingPong_Python_BLE 폴더에서 실행 (cd로 이동한 뒤 jupyter notebook)
3. pygame 오류는 (pingpong) 상태에서 pip install pygame==2.6.1 — (base)에서 설치하면 주피터에서 쓸 수 없습니다. 버전은 교재 코드 호환을 위해 2.6.1로 고정

매 수업 시작 루틴 3줄: ① cd DesktopPingPong_Python_BLE → ② conda activate pingpong → ③ jupyter notebook

💡 프롬프트(검은 창)를 닫으면 주피터도 함께 꺼집니다. 수업 중에는 창을 닫지 말고 최소화만 하세요.

네. 전국 1,200명 이상의 전문 강사가 있어 학교 맞춤형으로 수업 운영을 지원합니다:

• 전담운영: 주강사/보조강사 팀이 수업 전체를 운영
• 코티칭: 선생님 주도 수업에 강사가 보조로 참여
• 단기/장기 운영 모두 가능 — 교내 정규·자율·특별·동아리 활동 등

💡 코티칭과 무료 교원 연수를 함께 활용하면, 이후 선생님 직접 수업으로 자연스럽게 전환할 수 있습니다.

연결 실패는 대부분 아래 순서로 해결됩니다:

1. 그룹넘버 확인: 코드의 group_id 값과 큐브에 붙은 번호 스티커가 일치하는지 (단체 수업에서는 학생마다 다릅니다 — 옆 사람 큐브에 연결될 수 있어요)
2. 이전 세션 미종료가 가장 흔한 원인: 직전 실행이 블루투스를 점유한 상태 → [Restart Kernel]로 커널 재시작 후 ①블록부터 다시
3. 블루투스 동글은 첫 블록 실행 '전'에 꽂기 — 늦게 꽂았다면 커널 재시작 후 처음부터
4. 큐브 배터리 확인: 측면 LED가 빨간색으로 계속 깜박이면 충전 필요
5. 스마트폰 핑퐁 앱이 큐브를 잡고 있으면 앱 종료 후 재시도
6. 큐브 2개 수업(미니카·리듬게임 등): 'Connected with a master robot' 후 두 번째 큐브까지 연결되어 'Fully connected'가 떠야 완료 — 하나만 연결된 채 동작 블록을 실행하면 오류가 납니다. 연결이 꼬이면 큐브 전원을 모두 끄고(노란 버튼 3초) 처음부터 순서대로

모터가 멈추지 않을 때: 셀 정지(■) 버튼은 코드만 끊어서 모터가 계속 돌 수 있습니다 → stop_motor()를 실행하거나 커널을 재시작하세요.

💡 수업 종료 5분 전 '종료 루틴'을 전체 공지로 실행시키면 다음 수업의 연결 오류가 크게 줄어듭니다: 종료 코드 실행 → 'End thread' 확인 → 큐브 전원 끄기(노란 버튼 3초) → [Restart Kernel]. 오류가 났을 때도 커널 재시작은 필수입니다.

네, 가능합니다. 학교 기기 환경별로 사용할 수 있는 소프트웨어가 다릅니다:

• 스마트폰·태블릿(Android/iOS): 핑퐁 로봇 앱, 핑퐁 스크래치 앱 — 앱 코딩·블록 코딩 수업 가능
• 크롬북(Chromebook): 핑퐁 앱, 핑퐁 스크래치 지원 — PC실 없이 크롬북만으로 블록 코딩 수업 가능
• 윈도우/맥 PC·노트북: 핑퐁 스크래치, 엔트리 지원
• 파이썬·AI 바이브 코딩 과정: 윈도우 PC 기준 교안 제공 (파이썬 3.10.11 설치 필요)
• 블루투스가 없는 데스크탑은 핑퐁 USB 동글을 사용해 연결합니다

💡 앱 코딩은 태블릿만으로, 블록 코딩은 크롬북만으로도 시작할 수 있어 별도 PC실이 없는 학교도 도입할 수 있습니다.