MicroDuck 첫 연결 | BLE 검색부터 Wi-Fi·콘솔까지

10월 16일 확인: Beta 보드 업데이트 후 실제 이름 다시 찾기

공식 daemon 0.17.4의 원래 배포일은 10월 15일입니다. Beta 보드에서만 기본 duck-xxxx 이름의 SoC 일련번호 출처가 U-Boot의 device tree에서 커널 /proc/cpuinfo의 Serial로 바뀌었습니다. 제작자가 조사한 두 Beta 보드는 이전에 모두 duck-d041이었고, 고정 소스 테스트에서는 그중 하나가 duck-2b6d가 됩니다. 사이트가 실물 업데이트를 시험한 결과는 아닙니다. 직접 설정한 이름은 유지되고 Zero 3W는 계속 device tree 값을 읽습니다. Beta의 목소리·합창 ID와 원격 접속용 hardware ID도 달라질 수 있으므로 일련번호나 ID를 공개하지 마세요.

업데이트 후 예전 기본 이름으로 찾지 못하면 PC에서 uvx duckctl scan을 다시 실행하고 실제로 표시된 이름을 --name 또는 DUCK_ROBOT에 사용하세요. 과거 duck-d041이나 본문의 예시 duck-c51b을 고정값으로 쓰지 마세요. 이미 페어링된 기체는 광고 표시가 다를 수 있어 스캔 결과가 적다는 이유만으로 오프라인이라 단정할 수 없습니다. 이름 변경만 보고 Bluetooth bond를 삭제하지 마세요. 이번 변경은 신원 값의 출처에 한정되며 일반 BLE 페어링이나 암호 전송을 안전하게 만든 것은 아닙니다. 아래 개발판의 평문 전송 경고는 계속 적용됩니다. 이름·검색 규칙 · 음성 시드.

PC에서 로봇 이름을 먼저 확정

이 경로는 Pollen Robotics 공식 기체용입니다. 사이트가 10월 15일 공식 0.17.2 문서와 고정 클라이언트 코드를 읽어 빈 안내를 채웠으며, 상위 버전은 10월 13일 발표됐습니다. 새 기능 공개로 설명하지 않습니다. 실물 BLE 연결·Wi-Fi·콘솔을 여기서 시험하지 않았고, kissqy R1 복제 이미지에 같은 기능이 있다고 가정하지 않습니다.

PC에 uv가 있다면 첫 줄로 주변 BLE 광고를 봅니다. scan 자체는 기체와 접속하지 않아 PIN이 필요 없습니다. info는 접속해서 신원을 읽으며 처음에는 페어링과 PIN 검증이 생길 수 있습니다. 예시 duck-c51b 대신 실제 스캔 결과의 이름을 넣고 --name을 유지하세요. 이름 없이 여러 기체를 찾으면 먼저 발견된 다른 기체가 선택될 수 있습니다. uvx는 로컬 캐시를 재사용하거나 새 배포본을 받을 수 있으며, 이 안내는 0.17.2 클라이언트를 기준으로 확인했습니다.

uvx duckctl scan
uvx duckctl --name duck-c51b info

다음 Wi-Fi 상태 조회와 네트워크 검색은 BLE로 가능해 기존 SSH가 필요하지 않습니다. 다만 광고만 읽는 scan과 달리 이 조회는 로봇에 연결해 PIN을 사용합니다(--pin, DUCK_PIN, 미설정 시 문서의 기본값 000000). PIN 확인이 BLE 암호화를 뜻하지는 않습니다. 고정 btd 코드에 따르면 일반 개발 보드는 페어링이 기본적으로 꺼져 있습니다. Bluetooth 주소, SSID, PIN을 공개 글에 올리지 마세요.

uvx duckctl --name duck-c51b wifi status
uvx duckctl --name duck-c51b wifi scan

Wi-Fi를 바꿀 때 생기는 끊김을 예상

아래 예시는 두 자리표시자를 자신의 SSID와 비밀번호로 바꾼 뒤에만 실행합니다. 공식 CLI는 비밀번호를 --psk 인자로 받으며 이 경로에 숨김 입력 옵션은 없습니다. 공유 컴퓨터의 셸 기록이나 프로세스 인자에 노출될 수 있습니다. 더 중요한 것은 이 0.17.2 개발판 btd가 보통 페어링과 BLE 암호화가 기본적으로 꺼져 있어 근처에서 PIN과 Wi-Fi 비밀번호를 읽을 수 있다는 점입니다. 믿을 수 있는 근거리에서 격리된 테스트망과 임시 자격 증명으로만 이 절차를 쓰고, 집·직장의 비밀번호를 안전하게 전송된다고 생각해 넣지 마세요. 고정 서비스·라우팅 코드. 비밀번호를 넣은 명령도 게시하지 마세요. 접속 변경은 기존 Wi-Fi SSH를 끊을 수 있습니다. 서버의 조회 상한 45초와 클라이언트의 별도 60초 제한은 접속 성공 보장이 아닙니다. 정말 열린 네트워크에서만 --psk를 빼세요. 고정 가이드.

uvx duckctl --name duck-c51b wifi connect 'YOUR_SSID' --psk 'YOUR_WIFI_PASSWORD'

웹페이지와 영상 신호는 서로 다른 단계

다시 상태와 IP를 읽고 open --print로 웹주소만 확인합니다. 일반 open은 로봇의 브라우저 콘솔을 엽니다. 주소가 없는 로봇은 이 WebRTC 콘솔을 쓸 수 없습니다. 8080 페이지가 떠도 별도 8443 신호 포트에 닿지 않으면 영상·조작 연결이 실패할 수 있습니다. 이를 Bluetooth 문제로 단정하거나 인터넷에 포트를 공개하지 말고 LAN/방화벽 경로를 확인하세요.

uvx duckctl --name duck-c51b wifi status
uvx duckctl --name duck-c51b ip
uvx duckctl --name duck-c51b open --print

콘솔의 버튼은 실제 기체를 움직일 수 있습니다. Stop은 화면의 명령을 0으로 만들 뿐 서보 전원을 끊는 비상정지가 아닙니다. 원문. 질문에는 클라이언트/로봇 버전, scan에 이름이 보였는지, no address였는지, 8080과 8443 중 실패 단계를 적어 기술 게시판에 남기세요. Bluetooth 주소, 시리얼, LAN IP, SSID, PIN, Wi-Fi 비밀번호와 계정은 가려야 합니다. 연결 후 패드 입력 문제는 게임패드 진단, UDP 끊김 시간은 0.17.2 설명을 보세요.