Skip to content

agent test_09_01_05 #167

Closed
Closed

Description

@max-free-time

온보딩 테스트 중에 st app에 04-151 에러가 발생하고 있는데 이건 왜 발생하는 거야?

Activity

  1. st-device-sdk commented on Sep 1, 2026

    @st-device-sdk
    Collaborator

    접수 완료

  2. st-device-sdk commented on Sep 1, 2026

    @st-device-sdk
    Collaborator

    04-151 에러 의미

    "Disconnect with BLE device unexpectedly" – ST 앱의 BLE 온보딩 중 예기치 않게 디바이스와의 BLE 연결이 끊어진 상황입니다.

    일반적인 원인

    1. BLE 신호 품질 문제 – 간섭, 거리, 또는 신호 약화로 인한 연결 끊김
    2. 디바이스 전력 부족 – 배터리 부족 또는 전원 공급 불안정
    3. BLE GATT 작업 실패 – 페어링/본딩 또는 특성 읽기/쓰기 중 오류
    4. 디바이스 메모리/스택 부족 – 리소스 한계로 인한 동작 중단
    5. 디바이스 watchdog/crash – 온보딩 중 디바이스 재시작

    진단 단계

    1단계: 디바이스 로그 수집

    온보딩 재시도 시 다음 로그를 함께 수집해주세요:

    • 디바이스 측 로그: BLE 연결 해제 시점의 전체 로그 (watchdog, reboot 여부 확인)
    • ST 앱 로그: 앱 설정 → 정보 → 버그 리포트로 수집
    • 연결 환경: 테스트 위치, BLE 간섭원, 디바이스 전원 상태

    2단계: 기본 확인 사항

    • 디바이스와 모바일 간 거리를 1m 이내로 유지
    • 다른 BLE/WiFi 기기 간섭 최소화
    • 디바이스 펌웨어 버전 및 STDK 버전 확인

    3단계: 로그 기반 분석

    수집한 로그를 이슈에 업로드하면 다음을 분석할 수 있습니다:

    • BLE disconnect reason code
    • 마지막 성공한 GATT 작업
    • 메모리/스택 상태
    • 타이밍/timeout 문제

    더 정확한 지원을 위해 디바이스 로그와 재현 환경 정보를 댓글로 남겨주시면 감사하겠습니다.


    이 답변은 STDK 지원 도구로 자동 생성되었습니다.

  3. max-free-time commented on Sep 1, 2026

    @max-free-time
    Author

    모바일이 연결을 자꾸 끊는거 같은데 어떻게 확인해야 하지?

  4. st-device-sdk commented on Sep 1, 2026

    @st-device-sdk
    Collaborator

    모바일 측 BLE 연결 끊김 진단 방법

    모바일이 연결을 끊는 패턴을 파악하려면 다음 단계로 진행하세요:

    1️⃣ ST 앱 로그 수집 (더 자세히)

    Android:

    • 앱 설정 → 정보 → 버그 리포트 → "로그 생성" (또는 "Generate Log")
    • 또는 adb logcat 명령으로 실시간 모니터링:
      adb logcat -s "*SmartThings*:V" -s "*BLE*:V" > st_ble_log.txt
    • 온보딩 시작 전부터 에러까지의 전체 로그 수집

    iOS:

    • 설정 → 개인정보보호 → 분석 → 공유하지 않음 (버그 수집 활성화)
    • 또는 Xcode → Window → Devices and Simulators → 로그 정렬

    2️⃣ BLE 수준의 연결 끊김 원인 파악

    확인할 핵심 정보:

    • Disconnect Reason Code: 로그에서 BLE disconnect reason: 0x## 찾기

      • 0x13: 로컬 호스트 종료 (모바일이 능동 종료)
      • 0x15: 원격 디바이스 종료 (디바이스가 능동 종료)
      • 0x08: 연결 타임아웃 (응답 없음)
      • 기타: 신호 손실, 간섭 등
    • 타이밍: 끊어지는 시점 기록

      • 온보딩 시작 후 몇 초?
      • cmd 1~7 중 어느 단계에서?
      • 특정 GATT 작업 중?

    3️⃣ 로그에서 타이밍 분석

    수집한 ST 앱 로그를 분석할 때:

    [09:15:32.123] BLE Connected to device
    [09:15:32.450] cmd:0 - Device Info (시작)
    [09:15:33.100] cmd:0 - Device Info (완료)
    [09:15:33.150] cmd:1 - Key Exchange (시작)
    [09:15:34.200] BLE Disconnected - Reason: 0x15  ← 여기서 끊김
    
    • 즉시 끊김 (1초 이내): BLE 신호 문제 or 디바이스 crash/reboot
    • 느리게 끊김 (10초 이상): 모바일 타임아웃 or 너무 오래 응답 없음
    • 특정 cmd에서만: 해당 cmd 처리 로직 문제

    4️⃣ 디바이스 로그와 비교

    디바이스 로그도 함께 수집하면:

    • 모바일이 끊었는지 vs 디바이스가 끊었는지 확인 가능
    • 디바이스가 응답했는지 여부 확인
    • 메모리 부족, watchdog 재부팅 등 감지

    📋 다음 단계

    다음 정보를 이슈에 올려주면 더 정확히 진단할 수 있습니다:

    1. ST 앱 로그 파일 (버그 리포트)
    2. 끊어지는 시점 (온보딩 시작 후 몇 초?)
    3. 끊어지는 cmd 번호 (cmd:0~7 중)
    4. Disconnect Reason Code (있으면)
    5. 디바이스 로그 (가능하면)
    6. 재현 환경 (거리, 간섭원, 모바일 모델)
    

    이 답변은 STDK 지원 도구로 자동 생성되었습니다.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions