Sulkta-Coop/adacam-api
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Clean Python Flask replacement for odc-api (Hivemapper Bee liberation)
6 commits 1 branch 1 tag 48 KiB
Find a file
Kayos 595c1cadf5 fix: GPS from SQLite framekms (confirmed live device schema) 
odc-api.db confirmed present on device. framekms table has:
  latitude, longitude, altitude, hdop, satellites_used, time
NOT lat_deg/lon_deg/alt_m/num_satellites as previously assumed.
Redis fallback retained, supports both field naming conventions.
API response format unchanged (still returns lat_deg/lon_deg for Varroa compat).
2026-03-14 20:51:26 -07:00
adacam_api fix: GPS from SQLite framekms (confirmed live device schema) 2026-03-14 20:51:26 -07:00
systemd Initial commit: adacam-api v1.0.0 2026-03-14 08:13:04 -07:00
.gitignore Initial commit: adacam-api v1.0.0 2026-03-14 08:13:04 -07:00
install.sh fix: pre-liberation review — frames dir, wigle config GET, debug redis-keys endpoint 2026-03-14 17:59:08 -07:00
main.py Initial commit: adacam-api v1.0.0 2026-03-14 08:13:04 -07:00
README.md Initial commit: adacam-api v1.0.0 2026-03-14 08:13:04 -07:00
requirements.txt Initial commit: adacam-api v1.0.0 2026-03-14 08:13:04 -07:00

README.md

adacam-api

Clean Python Flask replacement for Hivemapper's odc-api — a 434k-line Node.js monolith with a filed CVE. This service runs on the Hivemapper Bee (HDC-S) dashcam as part of the adacam liberation stack.

What it does

  • Serves API endpoints for the Varroa Android app and adamaps-forwarder
  • Reads GPS data from Redis (GNSSFusion30Hz)
  • Stores landmark detections in SQLite
  • Forwards detections to AdaMaps API (with offline queuing)

Endpoints

Method Path Description
GET /api/1/landmarks/last/{N} Last N detections
POST /api/1/landmarks Ingest new detection
GET /api/1/gnssConcise/latestValid Current GPS fix
GET /api/1/status Device status
GET /api/1/deviceinfo Device identity
GET /api/1/recording/frames/latest Latest frame path

Note: /api/1/cmd is intentionally NOT implemented — that was the CVE.

Installation

./install.sh

This will:

  1. Copy files to /opt/adacam/
  2. Install Python dependencies
  3. Enable and start the systemd service
  4. Generate a device ID on first run

Configuration

Config file: /data/adacam/config.json

{
  "device_id": "auto-generated UUID",
  "adamaps_key": "adamaps-ingest-2026",
  "adamaps_api": "https://api.adamaps.org",
  "ap_interface": "wlp1s0f0",
  "tunnel_host": "",
  "tunnel_user": "",
  "tunnel_port": 2222
}

Requirements

  • Python 3.8+
  • Redis (for GPS/IMU data)
  • Flask, redis-py, requests

License

MIT