LOGIN
Raspberry Pi

센서 데이터 수집 시스템 구축 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.GPIO

3. 조도 센서 테스트 (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.target

8. 마무리

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         # 테스트 전 멈춤 (같은 핀 충돌 방지)
목록