tinyIoT MN-CSE(Pi)와 시연용 노트북 IN-CSE의 기동·점검·장애 대응 절차. 실제 주소는 기록하지 않고 <...> 자리표시자로 적는다.
CSE 이름 전환은 CSE 명명안, MQTT 규격은 onem2m/mqtt.md를 따른다.
2026-11-20 Pi에서 확인한 전체 배치와 재현 한계는 배포 및 운영 기록, 실제 요청 흐름은 아키텍처를 참고한다.
| CSE | 위치 | 포트 | CSE_BASE_RI |
서비스 |
|---|---|---|---|---|
| MN | Pi ~/tinyIoT |
3000 (HTTP), MQTT on | id-mn |
tinyiot-mn |
| IN (시연) | 노트북 Docker | Docker publish 설정에 따름 | id-in |
노트북 IN-CSE 컨테이너 |
| IN (대안 시험) | Pi ~/tinyIoT-in |
3001 | id-in |
tinyiot-in-local |
| 브로커 | Pi Mosquitto | 1883 | - | mosquitto |
설정 예시: onem2m/config.mn.example.h, onem2m/config.in.example.h. 서비스 파일: systemd/.
sudo cp systemd/tinyiot-mn.service systemd/tinyiot-in-local.service /etc/systemd/system/
sudo sed -i 's/<PI_USER>/실제계정/g' /etc/systemd/system/tinyiot-*.service
sudo systemctl daemon-reload
sudo systemctl enable --now tinyiot-mn
systemctl status tinyiot-mn --no-pager # 상태
journalctl -u tinyiot-mn -n 50 --no-pager # 로그
sudo systemctl restart tinyiot-mn # 재시작
ss -tln | grep -E '3000|3001|1883' # 포트 확인tinyIoT 폴더 소유자와 로그인 계정이 다르면 config.h 수정·빌드에 sudo가 필요하다.
cd ~/tinyIoT/source/server
make clean && make # config.h 변경은 make clean 없이 반영되지 않음
sudo systemctl restart tinyiot-mnPi에서 빌드는 1~2분 걸린다.
# CSEBase 조회 (rn, csi, ri 기록)
curl -s "http://127.0.0.1:3000/<CSE_BASE_NAME>" \
-H "X-M2M-Origin: CAdmin" -H "X-M2M-RI: chk1" -H "X-M2M-RVI: 3" -H "Accept: application/json"
# MN 로그에서 IN 등록·MQTT 구독 확인
journalctl -u tinyiot-mn -n 80 --no-pager | grep -iE "registration|mqtt"정상이면 Remote CSE registration check: 200과 MQTT Subscribe Success 4줄이 보인다.
시연 구성은 노트북 Docker IN-CSE를 사용한다. Pi 내부 IN은 노트북 연결과 분리해 확인할 때만 쓰는 대안이다. MN은 기동할 때 상위 IN 등록에 실패하면 스스로 종료한다.
cp -r ~/tinyIoT ~/tinyIoT-in
cd ~/tinyIoT-in/source/server
rm -f data.db # 새 DB로 시작
# config.h를 onem2m/config.in.example.h 배치 A 값으로 수정 (SERVER_IP 127.0.0.1, PORT 3001, CSE_BASE_RI id-in, ENABLE_MQTT 끔)
make clean && make
sudo systemctl enable --now tinyiot-in-local
# MN이 Pi 내부 IN을 보도록 수정 후 재빌드
# REMOTE_CSE_HOST "127.0.0.1", REMOTE_CSE_PORT 3001| 배치 | 바꿀 것 |
|---|---|
| Pi 주소 변경 | MN 설정의 SERVER_IP, worker secrets.h의 CSE_HOST, 노트북 dashboard의 DASH_CSE_BASE를 새 Pi 주소로 바꾼다. MN은 재빌드·재시작, worker 펌웨어는 재빌드·업로드, dashboard는 재시작 |
| 노트북 IN 주소 변경 | MN 설정의 REMOTE_CSE_HOST/PORT를 갱신해 MN 재빌드·재시작. 브리지의 BRIDGE_IN_BASE와 노트북 대시보드의 DASH_IN_BASE도 새 IN 주소로 바꾸고 각각 재시작 |
| 지게차 ESP 주소 변경 | ESP 시리얼 로그의 IP를 확인해 bash onem2m/sub_alert_node.sh <ESP_IP>를 다시 실행 |
| worker AE 재등록 | 새 worker alert CNT RI를 확인하고 grp-safezone-alarms의 mid 참조를 갱신한 뒤 fan-out과 알림을 확인 |
| 공통 | 클라이언트의 CSE 주소와 DHCP 주소 예약 여부를 실제 네트워크에서 확인. 비밀번호와 실주소는 저장소에 기록하지 않음 |
- 도서관 등 공용 Wi-Fi는 기기 간 통신을 막는 경우(AP 격리)가 많다. 휴대폰 핫스팟 등 개인 망을 쓴다.
.local이름이 풀리지 않으면 IP를 직접 쓴다.
esp8266/led_server/secrets.example.h를 같은 폴더의secrets.h로 복사한다.secrets.h는.gitignore대상이므로 개인 Wi-Fi 정보와 장비 주소는 그 파일에만 쓴다.- Wi-Fi 이름·비밀번호와
CSE_HOST=http://<PI_IP>:3000을 설정한다. Pi 주소가 바뀌면CSE_HOST를 바꾸고 worker 펌웨어를 다시 빌드·업로드한다. - 부팅 시 worker AE가 현재 ESP IP를
poa로 등록한다. 재등록으로 AE/alert CNT가 새로 만들어졌다면 새 alert RI를 확인해 그룹mid를 갱신한다.
이 ESP는 HTTP /notify를 열며, IP를 AE에 등록하지 않는다. Pi에서 ESP 시리얼 로그의 IP: ...를 확인한 뒤 아래 스크립트로 AE-forklift01/alert SUB의 nu를 갱신한다. 스크립트는 기존 같은 이름의 SUB를 삭제하고 다시 만든다.
bash onem2m/sub_alert_node.sh <ESP_IP>두 ESP의 Wi-Fi 정보는 펌웨어의 무시 목록(.gitignore) 대상 secrets.h에만 둔다. secrets.example.h에는 자리표시자만 유지한다.
WSL은 Windows와 다른 내부 IP(172.x)를 쓴다. Pi가 WSL의 IN에 닿으려면 Windows 포트포워딩이 필요하다.
- WSL에서
systemd/tinyiot-in.service등록 (<WSL_USER>수정) - Windows에서
onem2m/forward_in.bat을 관리자 권한으로 실행 (WSL IP 자동 감지, 방화벽 3000 허용) - Pi에서
curl http://<NOTEBOOK_IP>:3000/TinyIoT ...로 확인
WSL IP는 재부팅 때 바뀔 수 있으므로 부팅 후마다 2를 다시 실행한다.
| 증상 | 원인 | 조치 |
|---|---|---|
MN 서비스가 inactive (dead) |
IN 등록 실패로 종료 (IN 주소가 옛 IP, IN 미기동) | IN 상태 확인, REMOTE_CSE_HOST/PORT 확인 후 재빌드 |
| IN 등록이 간헐적으로 실패 | Pi DB가 느려 응답이 SOCKET_TIMEOUT(기본 3초)을 넘김 |
SOCKET_TIMEOUT 10으로 재빌드 |
| config를 바꿨는데 반영 안 됨 | Makefile이 config.h를 추적하지 않음 |
make clean && make |
bind() error: Address already in use |
이전 프로세스가 포트를 잡고 있음 | sudo ss -tlnp | grep 3000으로 PID 확인 후 그 프로세스만 종료. pkill -f server처럼 넓은 패턴은 VS Code 원격 서버까지 죽임 |
| MQTT 요청에 응답 없음 | 브로커 미기동, ENABLE_MQTT 꺼짐, 토픽 cse-ri 불일치 |
systemctl status mosquitto, 기동 로그의 구독 토픽 확인 |
MQTT Invalid Request |
m2m:rqp 래퍼 사용 |
평평한 JSON으로 (mqtt.md §3) |
MQTT rsc:4004 |
to 앞 슬래시 |
to를 CSEBase 이름부터 |
| CIN 생성 권한 오류 | fr이 AE를 만든 originator와 다름 |
같은 originator 사용, 다른 AE는 ACP 구성 |
Pi의 운영 MEC IPE는 MEC011에서 Vision 서비스를 발견하고 등록된 oneM2M 주소의 최신 fusedTracks와 cam_ok를 확인해 MN-CSE에 데이터 상태를 기록한다. ACTIVE인 서비스 등록도 데이터가 오래되면 데이터 상태는 INACTIVE일 수 있다. VisionAI를 잠시 실행한 시험에서 데이터 상태가 INACTIVE → ACTIVE로 바뀌었고, 시험 후 VisionAI를 다시 중지했다.
MEC011 발견 코드는 저장소 onem2m/mec_ipe.py에 포함돼 있다. 아래 일반 실행 명령의 기본 동작은 알려진 CIN 경로를 직접 조회하는 것이다. 발견을 사용하려면 아래 MEC011 설정을 지정해야 한다. Pi에서는 별도 설치 파일과 systemd drop-in으로 발견 모드를 실행한다. Pi 운영 설정을 참고한다.
# 저장소 루트에서 (Pi)
python3 -m onem2m.mec_ipe --once # 한 번 확인·기록
python3 -m onem2m.mec_ipe # 계속 실행
# 상태 확인
curl -s -H 'X-M2M-Origin: CAdmin' -H 'X-M2M-RI: chk' -H 'X-M2M-RVI: 3' -H 'Accept: application/json' \
http://127.0.0.1:3000/TinyIoT-MN/AE-mecIPE/MecServices/safezone-vision/status/la- 기록 위치:
AE-mecIPE/MecServices/<서비스>/status. 상태가 바뀔 때와 10초마다 CIN을 쓴다.la의ts가 30초 넘게 오래되면 IPE가 멈춘 것으로 보고 UNKNOWN으로 다룬다. - 다른 서비스:
IPE_SERVICE=<이름> IPE_PROBE=http://<주소>/health(2xx면 성공) 또는IPE_PROBE=cin:/<AE>/<CNT>/la. - MEC011 설정:
IPE_PROBE=mec-cin으로 발견을 켜고,IPE_MEC_BASE는 조회할 등록부,IPE_MEC_SERVICE는 찾을 서비스 이름,IPE_DISCOVERY_CSE_BASE는 발견 주소를 제한할 CSE다. 허용 CSE 값을 생략하면IPE_MN_BASE를 사용한다. Pi의 시험 서비스 엔트리는 VisionAI의 실제fusedTracks주소로 수동 등록했다. 중복 서비스 이름은 임의 선택하지 않고 허용 CSE 밖 주소는 사용하지 않는다. 데이터 stale이면INACTIVE, 새 데이터가 확인되면ACTIVE로 쓴다. 단위 시험 17개가 통과했다. 원격 CSE 조회와 자동 서비스 등록·주소 갱신, 여러 서비스 중 위치·부하 기반 선택은 검증·구현하지 않았다. - 주요 환경 변수:
IPE_PERIOD_S(1.0),IPE_FAIL_N(3),IPE_MAX_AGE_S(2.0),IPE_HEARTBEAT_S(10),IPE_READ_ORIGIN(CAdmin),IPE_ORIGIN(CmecIPE). - 시험:
python3 -m unittest onem2m.test_mec_ipe - Pi 시험(2026-11-18, 실제 MN-CSE,
bench_bus.mp4녹화 영상으로 돌린 실제 VisionAI 약 5 FPS): 꺼진 상태로 시작하면 2초 뒤 INACTIVE, VisionAI 시작 후 약 10초(모델 로딩 포함) 뒤 ACTIVE. VisionAI를 Ctrl+C로 멈추면 마지막 프레임 4.2–4.7초 뒤 INACTIVE, 다시 켜면 9.7초 뒤 ACTIVE. 같은 Pi에서 VisionAI를 두 개 돌려 약 1.6 FPS로 떨어졌을 때 잘못된 INACTIVE가 1초 동안 한 번 나왔으므로, 프레임이 2초 넘게 끊기는 환경이면IPE_MAX_AGE_S를 늘린다.
기본 IPE_PROBE=cin:/AE-VisionAI/fusedTracks/la는 MN-CSE 주소를 알고 직접 조회한다. MEC011을 경유하려면 Vision 데이터 제공 서비스가 먼저 MEC 서비스 등록부에 등록되어 있어야 한다. mec_ipe는 서비스 자체를 등록하지 않는다.
IPE_PROBE=mec-cin으로 바꾸면 IPE는 IPE_MEC_BASE의 MEC011 /services?ser_name=... 조회로 서비스를 찾고, ACTIVE 상태와 등록된 endpoint를 확인한 뒤 그 주소로 최신 CIN을 조회한다. endpoint는 IPE_DISCOVERY_CSE_BASE에 지정한 CSE 아래의 /la URI여야 하며, 비워두면 IPE_MN_BASE를 사용한다. 원격 CSE 사용 시 주소와 조회 권한을 미리 설정한다. 중복된 서비스 이름이나 허용한 주소 밖의 endpoint는 사용하지 않는다. MEC 등록부를 읽지 못하면 판정을 보류한다.
IPE가 쓴 MecServices/<서비스>/status는 현재 RiskEngine 입력으로 연결되어 있지 않다. MEC 발견 결과가 위험 판정에도 영향을 주게 하려면, 후속으로 엔진이 이 oneM2M 상태를 읽고 ACTIVE이며 상태 CIN이 신선할 때만 Vision 조언을 허용하도록 연결한다. 이때 레이더 단독 판정은 계속 유효하게 둔다.
IPE_MEC_BASE=http://127.0.0.1:18080/safezone-a/mep-a/mec_service_mgmt/v1 \
IPE_MEC_SERVICE=<MEC에 등록된 서비스 이름> \
IPE_PROBE=mec-cin \
python3 -m onem2m.mec_ipe --once위 주소는 같은 Pi에서 실행하는 Host A 시험 스택의 로컬 API 예시다. 다른 배치에서는 해당 플랫폼이 제공한 API root를 사용한다. IPE_MEC_UPDATE는 기본값 0으로 둔다. 이 기능은 MEC 서비스 상태를 자동 갱신하지 않으며, ACTIVE 표기만으로 최신 데이터가 있다고 보지 않는다. 실제 fusedTracks 데이터의 ts와 cam_ok를 계속 검사한다.
- Pi의 기존 MEC ARM64 컨테이너 네 개를 재시작했고, 로컬 MEC API와 모의 Vision 응답을 확인했다. 이미지 재빌드나 Redis 데이터 삭제는 하지 않았다.
- MEC 시험 앱 아래
safezone-vision-cin-trial을 별도 등록했다. endpoint는 실제 Pi MN-CSE의http://127.0.0.1:3000/TinyIoT-MN/AE-VisionAI/fusedTracks/la였다. - 변경한 IPE 파일을 Pi
/tmp에서--once로 실행하고AE-mecIPE-discovery-trial에 상태 CIN을 썼다. 확인값은probe=mec-cin,state=ACTIVE,registry_state=ACTIVE였다. 이는 운영safezone-ipe설정이나 서비스 코드를 전환한 결과가 아니다. - VisionAI는 실제 카메라·레이더 입력으로 잠시 실행해
cam_ok=true, 표적 0개, 약 2.1 FPS를 발행했다. 약 82°C에 도달해 중지했고, 온도는 이후 약 65°C로 내려갔다. 시험 상태 CIN 기록은 VisionAI를 중지한 뒤 수행했으므로 시험 실행에서만IPE_MAX_AGE_S=600을 사용했다. 따라서 이 기록의fresh판정은 기본 2초 신선도 검증으로 해석하면 안 된다. - 이후 운영
safezone-ipe에 별도 파일과 systemd drop-in으로mec-cin을 적용했다. 실제 VisionAI를 잠깐 실행하자 발견한 CIN이 최신으로 갱신되면서 IPE가 INACTIVE에서 ACTIVE로 바뀌었다. 약 2.1 FPS 상태에서 2초 신선도 기준을 잠깐 넘어 INACTIVE와 ACTIVE로 한 차례 흔들렸다. 시험 후 Vision은 중지했다. - MEC 등록은 시험용 앱 아래 수동으로 만들었다. 실제 Vision 앱의 자동 등록, 여러 서비스 선택, MEC 상태 자동 갱신과 장시간 안정성은 미검증이다. 현재 설정과 복구 위치는 Pi 운영 상태를 참고한다.