센서 데이터 수집 시스템 구축 2 - 라즈베리파이 서버
전체 구조
[DHT11 온습도] ─┐
├─→ collector.py (1분마다 측정) ─→ queue.db (임시 저장) ─HTTPS + 토큰─→ kgorani.kr/api/sensor.php ─→ DB
[KY-018 조도] ─┘인터넷이 끊겨도 측정값은 queue.db 에 쌓였다가, 연결되면 한꺼번에 전송된다.1. 시스템 설정
sudo apt update && sudo apt full-upgrade -y
sudo apt install -y python3-dev build-essential
- RPi.GPIO 를 설치할 때 C 코드를 컴파일하므로 Python 개발 헤더 필요
sudo usermod -aG gpio $USER
- GPIO 사용 권한 (실행 후 다시 로그인)
echo "dtoverlay=dht11,gpiopin=18" | sudo tee -a
/boot/firmware/config.txt
sudo reboot재부팅 후 확인
cat /sys/bus/iio/devices/iio:device0/name # dht11@12
cat /sys/bus/iio/devices/iio:device0/in_temp_input # 20900 → 20.9°C
cat /sys/bus/iio/devices/iio:device0/in_humidityrelative_input # 67000 → 67%처음 한 번은 Connection timed out 이 나올 수 있음 (정상). 2~3초 뒤 다시 읽기2. 프로젝트 폴더 생성 · 가상환경
mkdir -p ~/sensor_server
cd ~/sensor_server
python3 -m venv venv
source venv/bin/activate
pip install RPi.GPIO3. 조도 센서 테스트 (light_test.py)
불을 켰을 때 DO 값이 0 인지 1 인지 확인 → 5번 .env 의 LIGHT_ON_VALUE 에 사용import time
import RPi.GPIO as GPIO
LIGHT_PIN = 23 # GPIO23 (물리 16번 핀)
GPIO.setmode(GPIO.BCM)
GPIO.setup(LIGHT_PIN, GPIO.IN)
try:
while True:
value = GPIO.input(LIGHT_PIN)
print(f"DO 값: {value} → {'어두움' if value else '밝음'}")
time.sleep(1)
except KeyboardInterrupt:
print("종료")
finally:
GPIO.cleanup()- 손으로 가렸다 뗐다 하면서 0/1 이 바뀌는지 확인4. 설정 파일 (.env)
API_URL=https://kgorani.kr/api/sensor.php
API_TOKEN=여기에_토큰
INTERVAL=60
LIGHT_ON_VALUE=0- API_TOKEN : 서버 config.php 의 SENSOR_API_TOKEN 과 같은 값- INTERVAL : 측정 간격(초)
- LIGHT_ON_VALUE : 불이 켜졌을 때의 DO 값
토큰이 들어 있으므로 나만 읽을 수 있게 설정
- chmod 600 .env
5. 수집 프로그램 (collector.py)
#!/usr/bin/env python3
"""
센서 데이터 수집 프로그램 (라즈베리파이)
- INTERVAL 초마다 DHT11(온습도)과 KY-018(조도, DO)을 읽음
· DHT11 은 커널 드라이버로 읽음 (/boot/firmware/config.txt 에 dtoverlay=dht11,gpiopin=18)
- 측정값은 먼저 queue.db 에 저장한 뒤 kgorani.kr 로 전송
→ 인터넷이 끊겨도 값이 사라지지 않고, 연결되면 밀린 값을 한꺼번에 보냄
- 설정(서버 주소, 토큰)은 같은 폴더의 .env 파일에서 읽음
배선
DHT11 : + → 1번(3.3V), out → 12번(GPIO18), - → 6번(GND)
KY-018 : VCC → 17번(3.3V), DO → 16번(GPIO23), GND → 14번(GND)
"""
import json
import os
import signal
import sqlite3
import ssl
import sys
import time
import urllib.error
import urllib.request
from datetime import datetime
import RPi.GPIO as GPIO
BASE_DIR = os.path.dirname(os.path.abspath(__file__))
QUEUE_PATH = os.path.join(BASE_DIR, "queue.db")
IIO_ROOT = "/sys/bus/iio/devices" # 커널 DHT11 드라이버가 값을 보여주는 곳
LIGHT_PIN = 23 # GPIO23 (물리 16번)
BATCH_SIZE = 200 # 한 번에 보낼 최대 개수
QUEUE_MAX = 50000 # 오래 끊겨 있을 때 큐가 무한히 커지지 않게 (1분 간격이면 약 35일치)
def log(msg):
print(f"[{datetime.now():%Y-%m-%d %H:%M:%S}] {msg}", flush=True)
def load_env(path):
"""KEY=VALUE 형식의 .env 파일 읽기"""
cfg = {}
with open(path, encoding="utf-8") as f:
for line in f:
line = line.strip()
if not line or line.startswith("#") or "=" not in line:
continue
key, value = line.split("=", 1)
cfg[key.strip()] = value.strip()
return cfg
CFG = load_env(os.path.join(BASE_DIR, ".env"))
API_URL = CFG["API_URL"]
API_TOKEN = CFG["API_TOKEN"]
INTERVAL = max(10, int(CFG.get("INTERVAL", "60")))
LIGHT_ON_VALUE = int(CFG.get("LIGHT_ON_VALUE", "0")) # 불이 켜졌을 때 DO 값 (테스트로 확인한 값)
# ── 로컬 큐 (SQLite) ───────────────────────────────────────────
def open_queue():
db = sqlite3.connect(QUEUE_PATH)
db.execute("CREATE TABLE IF NOT EXISTS queue (id INTEGER PRIMARY KEY AUTOINCREMENT, payload TEXT NOT NULL)")
db.commit()
return db
def enqueue(db, reading):
db.execute("INSERT INTO queue (payload) VALUES (?)", (json.dumps(reading),))
# 너무 많이 쌓이면 가장 오래된 것부터 버림
db.execute("DELETE FROM queue WHERE id <= (SELECT MAX(id) FROM queue) - ?", (QUEUE_MAX,))
db.commit()
def pending_count(db):
return db.execute("SELECT COUNT(*) FROM queue").fetchone()[0]
# ── 센서 읽기 ─────────────────────────────────────────────────
def find_dht_device():
"""커널 DHT11 장치 폴더 찾기 (iio:device0 처럼 번호가 바뀔 수 있어서 이름으로 찾음)"""
try:
names = sorted(os.listdir(IIO_ROOT))
except OSError:
return None
for name in names:
path = os.path.join(IIO_ROOT, name)
try:
with open(os.path.join(path, "name"), encoding="utf-8") as f:
if f.read().strip().startswith("dht11"): # 이름이 'dht11@12' 처럼 나옴
return path
except OSError:
continue
return None
def read_sysfs_int(path):
with open(path, encoding="utf-8") as f:
return int(f.read().strip())
def read_dht(dev, tries=3):
"""
DHT11 온도 · 습도 읽기 (커널 드라이버는 1000배 값을 줌: 20900 → 20.9)
가끔 실패(Connection timed out 등)하므로 최대 3번까지 다시 시도. 끝내 실패하면 (None, None)
"""
if dev is None:
log("DHT11 드라이버를 찾을 수 없음 (/boot/firmware/config.txt 의 dtoverlay=dht11,gpiopin=18 확인)")
return None, None
last_error = ""
for _ in range(tries):
try:
t = read_sysfs_int(os.path.join(dev, "in_temp_input")) / 1000
h = read_sysfs_int(os.path.join(dev, "in_humidityrelative_input")) / 1000
return round(t, 1), round(h, 1)
except OSError as e:
last_error = e.strerror or str(e)
except ValueError as e:
last_error = f"값 형식 오류: {e}"
time.sleep(2.5) # DHT11 은 최소 2초 간격으로 읽어야 함
log(f"DHT11 읽기 실패: {last_error}")
return None, None
def read_light():
"""1 = 켜짐, 0 = 꺼짐"""
return 1 if GPIO.input(LIGHT_PIN) == LIGHT_ON_VALUE else 0
# ── 서버로 전송 ───────────────────────────────────────────────
def send_batch(db):
"""
큐에서 최대 BATCH_SIZE 개를 보냄
반환: 보낸 개수 (0 = 보낼 것 없음, -1 = 실패 → 다음에 다시 시도)
"""
rows = db.execute("SELECT id, payload FROM queue ORDER BY id LIMIT ?", (BATCH_SIZE,)).fetchall()
if not rows:
return 0
body = json.dumps({"readings": [json.loads(p) for _, p in rows]}).encode("utf-8")
req = urllib.request.Request(
API_URL,
data=body,
method="POST",
headers={
"Content-Type": "application/json",
"X-Sensor-Token": API_TOKEN,
"User-Agent": "rapi-sensor-collector",
},
)
try:
with urllib.request.urlopen(req, timeout=15, context=ssl.create_default_context()) as res:
result = json.loads(res.read().decode("utf-8"))
except urllib.error.HTTPError as e:
detail = e.read().decode("utf-8", "replace")[:200]
log(f"전송 실패 HTTP {e.code}: {detail}")
if e.code in (400, 413):
# 서버가 형식 자체를 거부 → 다시 보내도 같은 결과이므로 이 묶음은 버림
drop(db, rows)
log(f"형식 오류로 {len(rows)}개를 버렸습니다.")
return -1
except (urllib.error.URLError, OSError, ValueError) as e:
log(f"서버에 연결할 수 없음 (큐에 보관, 나중에 다시 전송): {e}")
return -1
if not result.get("ok"):
log(f"서버 응답 오류: {result}")
return -1
drop(db, rows)
if result.get("rejected"):
log(f"서버가 {result['rejected']}개를 거부함 (값 범위 · 시각 오류)")
return len(rows)
def drop(db, rows):
db.executemany("DELETE FROM queue WHERE id = ?", [(r[0],) for r in rows])
db.commit()
# ── 메인 ─────────────────────────────────────────────────────
def main():
if not API_URL.startswith("https://"):
log("경고: API_URL 이 https 가 아닙니다. 토큰이 암호화되지 않은 채 전송됩니다.")
# systemd 가 서비스를 멈출 때(SIGTERM)도 GPIO 정리를 하고 끝나도록
signal.signal(signal.SIGTERM, lambda *_: sys.exit(0))
GPIO.setmode(GPIO.BCM)
GPIO.setup(LIGHT_PIN, GPIO.IN)
dht = find_dht_device()
db = open_queue()
log(f"수집 시작: {INTERVAL}초 간격, 전송 주소 {API_URL}, 대기 중인 값 {pending_count(db)}개")
log(f"DHT11 장치: {dht or '찾지 못함'}")
try:
while True:
started = time.monotonic()
t, h = read_dht(dht)
light = read_light()
reading = {
"measured_at": datetime.now().strftime("%Y-%m-%d %H:%M:%S"),
"temperature": t,
"humidity": h,
"light": light,
}
enqueue(db, reading)
log(f"측정 온도={t}°C 습도={h}% 전등={'ON' if light else 'OFF'}")
# 밀린 값까지 전송 (한 번에 최대 5묶음 = 1000개)
sent = 0
for _ in range(5):
n = send_batch(db)
if n <= 0:
break
sent += n
if sent:
log(f"전송 완료 {sent}개 (남은 값 {pending_count(db)}개)")
time.sleep(max(1, INTERVAL - (time.monotonic() - started)))
except KeyboardInterrupt:
log("종료")
finally:
GPIO.cleanup()
db.close()
if __name__ == "__main__":
main()6. 실행 확인
cd ~/sensor_server
source venv/bin/activate
python collector.py정상 출력[2026-11-17 19:41:45] 수집 시작: 60초 간격, 전송 주소 https://kgorani.kr/api/sensor.php, 대기 중인 값 0개
[2026-11-17 19:41:45] DHT11 장치: /sys/bus/iio/devices/iio:device0
[2026-11-17 19:41:45] 측정 온도=20.8°C 습도=68.0% 전등=ON
[2026-11-17 19:41:46] 전송 완료 1개 (남은 값 0개)끌 때는 Ctrl+C (Ctrl+Z 는 일시정지라 GPIO 를 계속 잡고 있음)7. 부팅 시 자동 실행 (systemd)
/etc/systemd/system/sensor-collector.service[Unit]
Description=Sensor collector (DHT11 + KY-018 -> kgorani.kr)
After=network-online.target
Wants=network-online.target
[Service]
User=kgorani
WorkingDirectory=/home/kgorani/sensor_server
ExecStart=/home/kgorani/sensor_server/venv/bin/python /home/kgorani/sensor_server/collector.py
Restart=always
RestartSec=10
[Install]
WantedBy=multi-user.target8. 마무리
sudo systemctl daemon-reload
sudo systemctl enable --now sensor-collector
sudo systemctl status sensor-collector # active (running) 확인
journalctl -u sensor-collector -f # 실시간 로그
sudo systemctl restart sensor-collector # 코드 수정 후 재시작
sudo systemctl stop sensor-collector # 테스트 전 멈춤 (같은 핀 충돌 방지)