Heitu 빛 측정기: API로 실시간 데이터 가져오기
최근 스마트홈, 식물 재배, 환경 데이터 모니터링에 관심이 많아
Heitu 빛 측정기를 구매하여 사용해 보았습니다.
단순한 조도계를 넘어, API를 통해 실시간으로 데이터를 가져올 수 있는 점이 인상적이었습니다.
🌞 제품 개요
- 제품 이름 : Heitu 빛 측정기
- 제조사 : 주식회사 1778리빙테크
⚙️ 측정 항목 소개
Heitu 빛 측정기는 단순 조도뿐만 아니라 PAR, PPFD등의
전문적인 광 데이터를 함께 제공합니다.
또한 일 누적 조도/ PAR / PPFD 값도 자동으로 계산되어
하루 동안 식물이 받은 총 빛의 양을 확인할 수 있습니다.
이 덕분에 식물 재배나 조명 환경 분석에 매우 유용합니다.
⚙️ 사용 방법


- 일반 모드:
- 녹색 LED가 서서히 켜졌다가 꺼지며, 이 상태에서는 조도, PAR, PPFD 등의 데이터를 자동으로 측정하고 서버로 전송합니다.
- Bluetooth 모드:
- 제품 후면의 버튼을 2초간 누르면 Bluetooth 모드에 진입합니다. 빨간색 LED가 서서히 켜졌다가 꺼지며, 앱 연동 시 사용하는 모드입니다.
- 다시 일반 모드로 돌아가려면 후면 버튼을 2초간 다시 눌러주면 됩니다.
📱 앱 연동 방법
Heitu 빛 측정기는 전용 앱과 연동하여 언제 어디서나 실시간으로 빛 데이터를 확인할 수 있습니다.


- App Store 또는 Play 스토어에서 “Heitu” 앱을 다운로드 후 회원가입 및 로그인합니다.
- Heitu 앱에서 상단의 “+” → “장치 추가”를 선택합니다. (빛 측정기가 빨간색 불이 깜빡이는 Bluetooth 상태인지 확인해주세요.)


- 목록에 나타난 “빛 측정기”를 클릭합니다.
- 만약 기기가 보이지 않는다면, 우측 하단의 돋보기 버튼을 눌러 검색 후 잠시 기다리면 목록에 나타납니다.
- “기기 추가하기”를 클릭합니다.
- 연결할 WiFi를 선택하고 화면에 안내에 따라 등록 과정을 진행하여 기기 등록을 완료합니다.

이제 홈 화면에 진입하면 사진과 같이 빛 측정기를 확인할 수 있습니다.
📊 앱 모니터링
Heitu 앱을 통해 실시간으로 측정된 조도, PAR, PPFD, 온도, 습도 데이터 등을 확인할 수 있습니다.
데이터는 클라우드에 자동 저장되어, 누적 값이나 일 별 통계도 쉽게 확인 가능합니다.
또한, 항목별 차트를 통해 원하는 기간이나 특정 시점의 데이터를 편리하게 분석할 수 있습니다.


🔑 Heitu REST API 활용하기
Heitu는 REST API를 지원하여, 개인 프로젝트나 데이터 분석 등 다양한 활용이 가능합니다.
API 사용을 위해서는 사용자 아이디, 빛 측정기(혹은 다른 장치)의 장치 아이디, 그리고 API key가 필요합니다.
🆔 장치 아이디 확인하기
장치 아이디를 확인하는 방법 입니다.


- 빛 측정기 대시보드 페이지에서 ⚙️버튼을 클릭합니다.
- “장치 속성” 버튼을 클릭합니다.
- 화면 하단에 “장치 아이디”를 확인합니다.
🧩 API key 확인하기
API key를 확인하는 방법입니다.

- (모바일) 화면 우측 하단의 프로필(사람 모양) 아이콘을 탭합니다. (PC) 화면 우측 상단의 사용자이름을 클릭합니다.
- 화면을 아래로 내려, API key를 확인합니다.
- 아직 발급 받지 않았다면 “발급하기” 버튼을 눌러 API key를 생성하세요.
- 이미 발급 된 상태에서 “재발급”을 진행하면 기존 API key는 더 이상 사용할 수 없으니 주의가 필요합니다.
🔑 Heitu REST API를 통한 실시간 데이터 가져오기
이제 본격적으로 Heitu REST API를 이용하여 원하는 데이터를 불러오는 방법입니다.
저는 아래의 두 가지 방법으로 데이터를 가져와 봤습니다.
방법 1. 🌐 웹 브라우저에서 바로 확인하기
별도의 코드 작성 없이, 웹 브라우저 주소창에서 바로 데이터 조회가 가능합니다.
현재 데이터 불러오기
https://heitu.1778tech.com/api?cmd=read&user_id={사용자 아이디}&device_id={장치 아이디}&apikey={apikey}
브라우저 주소창에 위 주소를 입력하면 JSON 형식의 데이터를 바로 확인할 수 있습니다.
웹 브라우저 REST API 응답 예시

방법 2. 🐍 Python으로 데이터 활용하기
조금 더 다양한 방식으로 데이터를 활용하고 싶다면,
프로그래밍 언어를 사용해 REST API를 사용할 수 있습니다.
저는 프로그래밍 언어 중 Python을 이용해 Heitu REST API로부터 3분마다 데이터를 조회하고,
그 결과를 CSV 파일에 자동으로 저장하는 코드를 작성해 보았습니다.
예시 코드
import time
import requests
import os
import csv
import datetime
user_id = "{사용자 아이디}" #사용자의 아이디(이메일형식)를 입력합니다.
device_id = "{장치 아이디}" #장치 아이디를 입력합니다.
apikey = "{apikey}" #API key를 입력합니다.
url = "https://heitu.1778tech.com/api?cmd=read&user_id="+user_id+"&device_id="+device_id+"&apikey="+apikey+""
# response = requests.get(url)
# print(response.json())
filename = "light_log.csv"
now = int(time.time())
headers = ["시간", "lux", "par", "ppfd", "accum_lux", "accum_par", "accum_ppfd", "온도", "습도"]
while True:
response = requests.get(url).json()
data_items = response["data"][0][1]
data_dict = {item["name"]: item["value"] for item in data_items}
timestamp = float(response["data"][0][0])
time_str = datetime.datetime.fromtimestamp(timestamp).strftime("%Y-%m-%d %H:%M:%S")
row = [
time_str,
data_dict.get("lux", ""),
data_dict.get("rad", ""),
data_dict.get("ppfd", ""),
data_dict.get("accum_lux", ""),
data_dict.get("accum_rad", ""),
data_dict.get("accum_ppfd", ""),
data_dict.get("temp", ""),
data_dict.get("humd", "")
]
file_exists = os.path.exists(filename)
with open(filename, "a", newline="", encoding="utf-8-sig") as f:
writer = csv.writer(f)
if not file_exists:
writer.writerow(headers)
writer.writerow(row)
time.sleep(180) # 180초마다 작동.
프로그램을 실행하면, light_log.csv 파일이 존재하지 않을 경우 자동으로 새로 생성됩니다.
이후 3분마다 측정된 데이터가 해당 파일에 순차적으로 기록됩니다.
만약 이미 light_log.csv 파일이 존재한다면, 기존 파일에 새로운 데이터가 계속 추가되어 누적 저장됩니다.
csv 파일 예시

이처럼 간단한 코드로 실시간 데이터 수집, 기록 등 다양한 활용을 할 수 있어, 개인 프로젝트나 IoT 데이터 분석에도 적극 활용할 수 있습니다.
💬 사용 경험
👍 장점
- 하루 동안의 누적 값을 확인할 수 있다.
- 하루 동안 누적된 조도, PAR, PPFD 값을 확인할 수 있어 식물 재배나 광 환경 분석에 매우 유용합니다.
- 이 기능을 통해 실제로 식물이 하루 동안 얼마나 많은 빛을 받았는지 확인할 수 있습니다.
- 온도 및 습도 측정 가능.
- 빛 측정기이지만 온도와 습도도 측정 가능하여 하나의 센서로 더 다양한 값을 확인할 수 있습니다.
- Heitu 앱
- 앱과 연동하여 사용하게 되면 어디서든 실시간으로 측정 값을 확인 할 수 있으며, 자동화 기능을 사용하여 다양한 기능을 사용할 수 있습니다.
💡참고사항
제품 구매 시 디스플레이 유무를 선택할 수 있습니다.
- 제가 사용한 제품은 디스플레이가 없는 버전으로, 측정 값을 기기에서 바로 확인할 수 없지만, 스마트폰 앱을 이용하여 어디서든 실시간으로 측정 값을 확인 할 수 있어서, 실제 사용에서는 불편함이 거의 없었습니다.
- 디스플레이가 있는 버전은 측정 값을 기기에서 바로 확인할 수 있는 편리함이 있고, 제가 사용한 디스플레이가 없는 버전은 가격이 더 저렴하면서도 앱 연동으로 충분히 편리하게 사용할 수 있다는 장점이 있습니다.
- 기기에서 바로 측정 값을 확인하고 싶은 분이라면 아래 링크에서 디스플레이 탑재 모델을 확인해 보시는 것도 좋습니다.
- 디스플레이 탑재 모델 바로 가기

🌿사용 후기
실제로 사용해보니 측정 정확도나 반응 속도는 만족스러웠습니다.
온도, 습도, 조도 같은 기본 환경 정보 외에도 PAR과 PPFD 같은 세부 지표까지 확인할 수 있어서, 식물 재배 환경을 세밀하게 관리할 때 도움이 많이 됐습니다.
앱이나 웹을 통해 실시간으로 데이터를 볼 수 있고, 이전 기록까지 한눈에 확인할 수 있어서
스마트폰으로 관리하는 분들에겐 오히려 편리할 수 있습니다.
전체적으로 보면, 정확한 측정과 데이터 관리에 초점이 맞춰진 제품이라
디스플레이보다는 앱 기반의 스마트 관리 기능을 중시하는 분들에게 특히 잘 맞습니다. 🌱
🔗 참고 링크
더 자세한 사용법과 문서는 아래의 링크에서 확인할 수 있습니다.
https://docs.1778tech.com/
Heitu 빛 측정기: API로 실시간 데이터 가져오기 더 읽기"