데이터 분석가를 위한 BiliMon 활용 방법

1. 텔레메트리 전송 페이로드 규격 (JSON)

BiliMon265V12 장비가 dbentrance 또는 AltServer05 웹 게이트웨이로 전송하는 HTTP POST JSON 페이로드의 정밀 스키마 정의입니다.

필드명	데이터 타입	설명 및 파싱 예시	비고
CommandType	String	항상 'InsertData'로 고정.	기본 구분
DataType	String	펌웨어 구동 버전. (예: 'BM265V12')	식별 필드
TableName	String	기기 고유 테이블 이름. THISDEVICEID와 매칭됨.	핵심 인덱스
DataName	String	포트 번호와 동작 상태 전이 번호의 조합. (예: 'A0:1', 'A1:100')	상태 전이
DataValue1	String	정밀 측정된 실제 계측 데이터값 팩.	원시 데이터
Option	String	기기 동기화 타임스탬프. 'YYYY-MM-DD HH:MM:SS'.	시간값
UserPW	String	HMAC SHA-256 대칭 키 보안 무결성 해시 키.	보안 서명

2. DataName 상태 전이 코드 매핑 사전

데이터 분석 시 가장 먼저 체크해야 할 포트 동작 지표 코드표입니다.

상태 전이 문자열	물리적 현상 정의	분석 해석 방안
A:0	센서 회로 즉시 연결 해제 감지	I2C 전원 상실 혹은 물리 센서 분리 상태로 파싱.
A:-1	1초 초과 연결 끊김 지속 상태	완전한 물리 분리 확정 상태. 정밀 검토 요망.
A:1	최초 센서 활성화 완료 (Warm-up 개시)	이 시점부터 기기가 기준값(Reference) 로드를 준비함.
A:100	NVS로부터 Reference 복원 및 대기 상태	기기가 안정적 감지 대기(WAITING) 상태에 진입함.

3. 물리 계측값 변동 및 이벤트 추적 기법

Option2 필드에는 기기의 센서 상세 설정 파라미터가 압축 수록됩니다. 예를 들어 'EC:1/AS:1/BC:0/US:A102/OM:1/TM:1/PV:120'로 콤마 구분 기호 형태로 전달됩니다.

• OM (OperationMode): 기기가 현재 어떤 로직 코어에서 수행 중인지 구분합니다.

• TM (TesterMode): 배터리 테스터의 방전/충전 등 시퀀스 상태를 식별합니다.

• PV (PWM Value): 인가된 게이트 제어 펄스 폭 듀티 파라미터입니다.

그림 2. BiliMon 실시간 수집 데이터 분석 대시보드 화면

[분석가용 주의사항] DataValue1에 포함된 전압/전류값은 기준 영점값(ReferenceValue)을 가감한 차분값이므로, 실제 배터리의 절대 전압/전류를 도출하려면 DB상의 기동 알림 레코드에 등록된 보정 기준값과 합산하여 누적 연산을 돌려야 정확한 물리 곡선이 도출됩니다.