MQTT 연동 토픽 안내 > 펌웨어 공유

• 목록

펌웨어 공유 글을 올릴 때는 파일만 첨부하지 말고, 나루티움과 연동할 때 사용하는 MQTT 토픽과 JSON 신호 형식도 함께 적어 주세요.

1. 수집 토픽 예시

sensor/data/{device_id}

예:
sensor/data/2832

device/{device_key}/telemetry

예:
device/line01/telemetry

2. 상태/동작 신호 예시

센서값이나 장비 동작 상태를 보낼 때는 아래처럼 JSON 예시를 글에 같이 적어 주세요.

{
  "device_id": "2832",
  "source_item_id": 32,
  "group_secret": "ABCDEFGH",
  "temp": 23.4,
  "humidity": 61.2,
  "status": "normal",
  "running": true
}

• device_id 또는 device_key 기준을 같이 적어 주세요.
• source_item_id, item_id를 쓰는지 함께 적어 주세요.
• 상태값, 센서값, 동작값이 어떤 의미인지 글 본문에 설명해 주세요.

3. 제어 신호 예시

장비 제어를 지원하는 경우 서버가 보내는 명령 형식도 같이 적어 주세요.

cmd/send

{
  "cmd": "ON",
  "device_id": "2832",
  "device_key": "pump-01",
  "item_id": 12,
  "source_item_id": 32,
  "sensor_key": "power"
}

예: 전원 ON/OFF, 모터 회전, 밸브 열림/닫힘, 속도 변경 같은 제어 신호는 펌웨어가 이해하는 키 이름과 값 형식을 함께 적어 주세요.