REZIENA BLE Protocol Specification

번호 버전 변경일 변경내용 작성자

1 V00.01 2017.06.03 최초 작성 김태균
2 V00.02 2017.06.14 데이터 포맷 및 명령 추가 최으뜸
3. V00.03 2017.06.19 Command 상세 설명 추가 김태균
4 V00.04 2017.06.20 Parameter 수정 최으뜸
5 V00.05 2017.06.28 Treatment 명령어 추가(test 용) 김태균
6 V00.06 2019.04.12 Battery 추가 채상아
7 V00.07 2019.06.07 BLE connect 명령어 추가 채상아
8 V00.08 2019.06.19 접촉 감지 명령어 추가 채상아
9 V00.09 2019.06.20 접촉 감지 수정 채상아
10 V00.10 2019.08.23 Contact 추가, Connect, touch 삭제 채상아
11 V00.11 2019.08.26 Set Energy 추가 채상아
1. Data Format
1) Command:

STX Command Parameter ETX

1byte 1byte 2byte 1byte

2) Response:

Command
1byte

3) 용어설명

항목 설명 비고
STX 0x02(hex)
Command 동작 명령
Parameter/Status Command: 동작 명령에 대한 옵션 설정
Response: 명령 수신 여부
ETX 0x03(hex)
4) Command list

Category 기능 비
Command Code
고
Contact 접촉 0x11 [Device->App] 디바이스에 피부 접촉이 감지되면
알림
App: Caring 페이지일 경우 붙는 애니메이션 실행
떨어짐 0x12 [Device->App] 디바이스에 피부 떨어짐이
감지되면 알림
App: Caring 페이지일 경우 떨어지는 애니메이션
실행
요청 0x13 [App->Device] Treat 화면 진입시 접촉 정보 요청
Set Energy 조사시간 0x21 [App->Device] 조사할 시간(ms 단위)
Device: App 에서 전송한 조사시간으로 세팅함
세팅이 안되어있을 시
기본 1.5mm=10ms, 3.0mm=20ms
Parameter: 조사할 시간
Moisture 모드 진입 0x31 [App->Device]
Measuring App: 수분 측정 화면 이동시, Device 로 수분 측정
준비 명령 전송
Device: ADC 초기화, 측정 전류 인가
측정 시작 0x32 [Device->App] 피부 접촉 시 시작 알림
App: Moisture guide 에 “Detect..” 문구 띄움
Device: 피부 수분 측정을 위해 적정 주파수의
전류를 인가하고, 적정횟수 반복 측정하여
평균값을 저장.
측정 종료 0x33 [Device->App] 측정 종료 알림
Parameter: 측정값 전송.
App: 수신 데이터를 등급을 나눠 표시.
Device: 측정 종료됨과 함께 평균값을 parameter
로 전송
측정 취소 0x34 [App->Device] 종료 전 취소 버튼 입력
App: 이전 화면으로 이동.
Device: 수분 측정을 중단하고, 수분 측정
모드에서 벗어남.
[Device->App] 종료 전 취소: 피부 접촉 분리
App: 수분 측정값 0 으로 표현한다.
Device: 수분 측정을 중단하고, 수분 측정
모드에서 벗어난다.
Caring 케어시작 0x41 [Device->App] care 시작
Center button 입력 후 기기를 피부에 접촉하면
시작 명령 전송.
App: 시술이 시작을 인지. 화면상에서 시술부위가
깜빡이는 상태
케어종료 0x42 [Device->App] care 종료.
Device: transducer 를 1 cycle 동작 후(마지막
shot 발생 후) 전송
App: 깜박이고 있는 시술부위를 완료 영역
색상으로 변경.
케어취소 0x43 [Device->App] care 중 device 피부접촉 분리
App: 깜박이고 있는 시술부위를 완료 영역
 색상으로 변경, 다음 부위 준비
Device: transducer 를 초기 위치로 이송
케어레디 0x44 [Device->App] 헤드부에서 transducer 를 초기
위치로 이송 완료 시 전송.
Error 구동부에러 0x51 [Device->App] 구동계 에러, 파라미터에 에러
번호
하이프에러 0x52 [Device->App] 트랜스듀서 부 에러, 파라미터:
에러번호(ex. 과열)
전원부에러 0x53 [Device->App] 충전, 방전 속도 에러
Battery 배터리요청 0x61 [App->Device]
App: 기기 이미지 클릭 시 or 첫 화면에서 BT 연결
후 팝업 뜰 때 전송
Device: 배터리 값 얻기
배터리전송 0x62 [Device->App]
Device: 배터리 전송
App: 배터리 띄우기
Parameter: 배터리값 전송
(Abnormal)
배터리가 15%이하면 1%감소마다 배터리 전송
App: 기기이미지가 느낌표있는 이미지로 바뀜
팝업 내용에 10%이하면 꺼진다는 문구 추가
Device: 배터리 전송
Parameter: 배터리 값 전송
Shot counts Request 0x71 [App->Device]
App: request to send total shot count of a
device
Response 0x72 [Device->App]
Total shot count is compose of 4 bytes
Device : response of 0x71
first 2 byte of device total shot counts
Response 0x73 [Device->App]
Total shot count is compose of 4 bytes
Device : response of 0x71
last 2 byte of device total shot counts

2. Command 별 상세

1) Contact

[접촉]

전송 방향: Device -> App

전송 조건: Device 에 접촉이 감지될 경우

STX Command Parameter ETX

0x02 0x11 0x00, 0x00 0x03
 [떨어짐]

전송 방향: Device -> App

전송 조건: Device 에 떨어짐이 감지될 경우

STX Command Parameter ETX

0x02 0x12 0x00, 0x00 0x03

2) Set Energy

[조사시간]

전송 방향: App->Device

전송 조건: B2B 앱에서 BLE 재연결시, B2B 앱에서 에너지 설정 버튼 클릭시

Parameter:

- 조사시간 (기본: 10=1.5mm, 20=3.0mm, 단위: ms)

STX Command Parameter ETX

0x02 0x21 0x00, 0x00 0x03

3) Moisture Measuring

[모드진입]

전송방향: App->Device

전송 조건: App 에서 수분 측정 화면 이동 시

App: 수분 측정 화면 이동시, Device 로 수분 측정 준비 명령 전송

Device: ADC 초기화, 측정 전류 인가

STX Command Parameter ETX

0x02 0x31 0x00, 0x00 0x03

[측정시작]

전송방향: Device->App

전송조건: 수분측정 모드 진입 후 피부 접촉 시
 App: 패킷 수신으로부터 5 초간 progress bar 적용

Device: 패킷 전송과 함께 적정 주파수의 전류를 이용하여 수분 측정을 시작.

STX Command Parameter ETX

0x02 0x32 0x00, 0x00 0x03

[측정종료]

전송방향: Device->App

전송조건: 수분측정 모드 시작 후 정해진 횟수만큼 반복하여 평균값 계산 완료 후

App: 수신 데이터를 물방울과 함께 표시, 저장되어 있는 이전 데이터와의 차이 값 표시.

Device: 측정 종료됨과 함께 평균값을 parameter 로 전송

Parameter

- Mt: 0~100. 피부 수분 값

STX Command Parameter ETX

0x02 0x33 0x00, 0x00 0x03

[측정취소]

전송방향: App->Device

전송조건: 측정 동작 중 App 화면 상의 Cancel 버튼 또는 < 버튼 입력.

App: 이전 화면으로 이동.

Device: 수분 측정 중단, 수분 측정 모드에서 벗어남.

전송방향: Device->App

전송조건: Device 에서 측정 중 피부 접촉 분리 시

App: 수분 값을 0 으로 표시한다.

Device: 수분 측정 중단, 수분 측정 모드에서 벗어남

STX Command Parameter ETX

0x02 0x34 0x00, 0x00 0x03
4) Caring

[케어시작]

전송방향: Device->App

전송조건: Center button 입력 후 기기를 피부에 접촉하면 전송.

App: 시술 인지. 화면상의 특정 시술 부위가 깜빡이는 상태.

Device: transducer 이송 및 적정 위치 도달 시 초음파 발생.

STX Command Parameter ETX

0x02 0x41 0x00, 0x00 0x03

[케어종료]

전송방향: Device->App

전송조건: treatment 시작 후 transducer 를 1 cycle 동작 완료 후(마지막 shot 발생 후) 전송

App: 깜박이고 있는 시술부위를 완료 영역 색상으로 변경

Device:

STX Command Parameter ETX

0x02 0x42 0x00, 0x00 0x03

[케어취소]

전송방향: Device->App

전송조건: treatment 중 device 피부 접촉 분리 시

App: 깜박이고 있는 시술부위를 완료 영역 색상으로 변경, 다음 부위 준비.

Device: transducer 를 초기 위치로 이송. 초음파 발생 정지

STX Command Parameter ETX

0x02 0x43 0x00, 0x00 0x03

[케어레디]

전송방향: Device->App

전송조건: transducer 가 초기 위치 도달 시 전송. 최초 BLE 연결시 초기 위치에 이미 도달해 있으면

전송.
 App:

Device:

STX Command Parameter ETX

0x02 0x44 0x00, 0x00 0x03

5) Error

[구동부에러]

전송방향: Device->App

전송조건: 구동부 에러 발생시

App:

Device:

Parameter:

- Err: TBD.

STX Command Parameter ETX

unsigned int
0x02 0x51 0x03
ex) 0x00000001

[하이프에러]

전송방향: Device->App

전송조건: Transducer 관련 에러 발생시 (과열, feedback 회로 정보)

App:

Device:

Parameter:

- Err: TBD.

STX Command Parameter ETX

0x02 0x52 Err, 0x00 0x03

[전원부에러]

전송방향: Device->App
 전송조건: 전원부의 출력 전원, 배터리 관련 에러 발생시.

App:

Device:

Parameter:

- Err: TBD.

STX Command Parameter ETX

0x02 0x53 Err, 0x00 0x03

6) Battery

[배터리요청]

전송방향: App->Device

전송조건: 기기 이미지 클릭 or 처음 BT 연결 후 팝업 뜰 때 (BluetoothActivity 진입시)

App:

Device: 배터리 값 얻기

Parameter:

STX Command Parameter ETX

0x02 0x61 0x00, 0x00 0x03

[배터리전송]

전송방향: Device->App

전송조건: 배터리 요청 받으면 전송 (CODE: 0x61)

App: 배터리 띄우기

Device:

(Abnormal): 배터리 양이 15%이하면 1%감소마다 배터리 값 전송

App: Bluetooth 팝업이 떠 있는 상태이면 경고문구 추가

Bluetooth 팝업이 떠 있지 않으면 앱 이미지 배터리 부족 이미지로 바꿈

Parameter: 배터리값

STX Command Parameter ETX

0x02 0x62 0x00, 0x00 0x03