timelapse-2/apps/device-agent

Timelapse Device Agent (Pi4 + DSLR)

Agent này chạy trên thiết bị Pi4 đầu cuối để:

1. Claim thiết bị về server bằng claim code
2. Poll trạng thái approved/rejected
3. Lưu API key one-time vào /boot/timelapse/agent.key
4. Gửi heartbeat định kỳ về server

Không chạy trên Mac

Script install chỉ chạy trên Pi/Linux systemd.

Setup trên Pi 4

cd /opt/timelapse
git pull

# install agent service
sudo bash apps/device-agent/scripts/install-agent.sh

# theo dõi logs
journalctl -u timelapse-agent.service -f

Mock Device Simulator (test nhanh)

Có thể giả lập thiết bị mà không cần phần cứng thật:

# 1) giả lập thiết bị mới xin claim code
python3 apps/device-agent/mock-device-cli.py claim \
  --server http://localhost:3001 \
  --count 5

# 2) giả lập heartbeat cho device seed demo
python3 apps/device-agent/mock-device-cli.py heartbeat \
  --server http://localhost:3001 \
  --demo \
  --interval 5

# 3) custom device list
python3 apps/device-agent/mock-device-cli.py heartbeat \
  --server http://localhost:3001 \
  --device DEMO-001:dev-api-key-demo-001 \
  --device DEMO-002:dev-api-key-demo-002

Mẹo: mở dashboard và theo dõi trạng thái thay đổi realtime khi script heartbeat đang chạy.

##

Mock Device Simulator (test nhanh)

Có thể giả lập thiết bị mà không cần phần cứng thật:

# 1) giả lập thiết bị mới xin claim code
python3 apps/device-agent/mock-device-cli.py claim \
  --server http://localhost:3001 \
  --count 5

# 2) giả lập heartbeat cho device seed demo
python3 apps/device-agent/mock-device-cli.py heartbeat \
  --server http://localhost:3001 \
  --demo \
  --interval 5

# 3) custom device list
python3 apps/device-agent/mock-device-cli.py heartbeat \
  --server http://localhost:3001 \
  --device DEMO-001:dev-api-key-demo-001 \
  --device DEMO-002:dev-api-key-demo-002

Mẹo: mở dashboard và theo dõi trạng thái thay đổi realtime khi script heartbeat đang chạy.

##

Cấu hình

File: /etc/timelapse/agent.env

TL_SERVER_URL=http://<server-ip>:3001
TL_DEVICE_NAME=Pi-DSLR-01
TL_SERIAL_NO=PI4-DSLR-01
TL_HEARTBEAT_INTERVAL=30
TL_CLAIM_POLL_INTERVAL=10
TL_CONFIG_DIR=/boot/timelapse

Luồng claim

Khi service chạy lần đầu:

• Agent in claim code ra terminal/log
• Dashboard admin approve device
• Agent tự nhận API key và bắt đầu heartbeat

File runtime

• /boot/timelapse/agent.json — metadata (deviceUuid, deviceId)
• /boot/timelapse/agent.key — API key (chmod 600)