Trilltechnician/giglez
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: Complete RTL_433 integration (Phases 1-8)

Browse Source 
Implemented full RTL_433 decoder integration for automatic IoT device identification:

## Phase 1-6: Core Implementation
- RTL_433 binary integration (v23.11, 244 protocols)
- Pulse data converter (RAW_Data → am.s16 format)
- Subprocess decoder wrapper with JSON parsing
- RTL433DecoderStrategy for matcher pipeline
- Comprehensive test suite (all tests passing)

## Phase 8: API Integration (this commit)
- GET /api/rtl433/status - Check decoder availability
- GET /api/rtl433/protocols - List 244 supported protocols
- GET /rtl433/protocols/{id} - Get protocol info
- POST /api/v1/captures/upload - Updated with RTL_433 decoding

## Files Added
- src/parser/rtl433_converter.py (~300 lines)
- src/matcher/rtl433_decoder.py (~400 lines)
- src/matcher/strategies.py (RTL433DecoderStrategy)
- docs/RTL433_INTEGRATION_PLAN.md
- docs/RTL433_IMPLEMENTATION_STATUS.md
- docs/RTL433_API_ENDPOINTS.md
- docs/PHASE8_COMPLETE.md
- tests/test_rtl433_integration.py
- tests/test_rtl433_api.sh

## Files Modified
- src/api/main_simple.py - Added RTL_433 decoding to upload
- src/api/routes/hardware.py - Added RTL_433 endpoints

## Performance
- Decode time: <0.05s per file
- 244 protocols supported
- 0.95 confidence for successful decodes

## Testing
- All integration tests passing
- All API endpoint tests passing
- ~3,600+ lines of code & documentation

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
priestlypython
2026-01-14 17:59:43 -08:00
parent 9bd9f4f43b
commit 8560fb5002
11 changed files with 3948 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files
src/api/main_simple.py
+97 -4
View File
@@ -22,6 +22,7 @@ sys.path.insert(0, str(Path(__file__).parent.parent.parent))
from src.parser.sub_parser import SubFileParser
from src.parser.gps_extractor import GPSFilenameExtractor
from src.matcher.simple_matcher import get_matcher
from src.matcher.rtl433_decoder import get_decoder as get_rtl433_decoder
# =============================================================================
# APPLICATION INSTANCE
@@ -278,6 +279,63 @@ async def cleanup_all_data():
}
@app.get("/api/rtl433/status")
async def rtl433_status():
"""Get RTL_433 decoder status"""
try:
decoder = get_rtl433_decoder()
available = decoder._check_rtl433_available()
version = decoder.get_version() if available else None
return {
"available": available,
"version": version,
"binary_path": decoder.rtl433_path,
"timeout": decoder.timeout,
"status": "operational" if available else "unavailable"
}
except Exception as e:
return {
"available": False,
"version": None,
"error": str(e),
"status": "error"
}
@app.get("/api/rtl433/protocols")
async def rtl433_protocols():
"""Get list of supported RTL_433 protocols"""
try:
decoder = get_rtl433_decoder()
if not decoder._check_rtl433_available():
return {
"error": "RTL_433 is not available on this server",
"total": 0,
"protocols": []
}
protocols = decoder.get_supported_protocols()
protocol_list = [
{"id": pid, "name": name}
for pid, name in sorted(protocols.items())
]
return {
"total": len(protocol_list),
"protocols": protocol_list
}
except Exception as e:
return {
"error": f"Failed to retrieve protocols: {str(e)}",
"total": 0,
"protocols": []
}
@app.post("/api/v1/captures/upload")
async def upload_captures(
files: List[UploadFile] = File(...),
@@ -334,8 +392,31 @@ async def upload_captures(
matcher = get_matcher()
matches = matcher.match(frequency, protocol, preset, raw_data=raw_data)
# Get best match
best_match = matches[0] if matches else None
# Try RTL_433 decoding for RAW signals
rtl433_devices = []
try:
if hasattr(metadata, 'has_raw_data') and metadata.has_raw_data:
decoder = get_rtl433_decoder()
if decoder._check_rtl433_available():
rtl433_devices = decoder.decode(metadata, enable_all_protocols=True)
except Exception as e:
print(f"RTL_433 decode error for {file.filename}: {e}")
# Combine all matches
all_matches = matches.copy() if matches else []
# Add RTL_433 decoded devices to matches
for rtl_dev in rtl433_devices:
all_matches.insert(0, type('obj', (object,), {
'device_name': rtl_dev.model,
'device_category': 'RTL_433 Decoded',
'confidence': rtl_dev.confidence,
'match_method': 'rtl433_decode',
'description': f"{rtl_dev.manufacturer or 'Unknown'} {rtl_dev.model} (Protocol {rtl_dev.protocol_id})"
})())
# Get best match (prioritize RTL_433 if available)
best_match = all_matches[0] if all_matches else None
# Use GPS from manifest or filename
global upload_counter
@@ -359,6 +440,18 @@ async def upload_captures(
"match_confidence": best_match.confidence if best_match else None,
"match_method": best_match.match_method if best_match else None,
"device_description": best_match.description if best_match else None,
# RTL_433 decoded devices
"rtl433_decoded": [
{
"model": d.model,
"manufacturer": d.manufacturer,
"device_id": d.device_id,
"protocol_id": d.protocol_id,
"confidence": d.confidence
}
for d in rtl433_devices
] if rtl433_devices else [],
# All matched devices (signature + RTL_433)
"matched_devices": [
{
"device_name": m.device_name,
@@ -367,8 +460,8 @@ async def upload_captures(
"method": m.match_method,
"description": m.description
}
for m in matches[:5] # Top 5 matches
] if matches else []
for m in all_matches[:10] # Top 10 matches (including RTL_433)
] if all_matches else []
}
# Store in memory
src/api/routes/hardware.py
+120 -1
View File
@@ -2,12 +2,131 @@
Hardware Control Endpoints (Development Mode Only)
"""
from fastapi import APIRouter
from fastapi import APIRouter, HTTPException
from typing import Dict, List
from loguru import logger
router = APIRouter()
@router.post("/hardware/scan")
async def start_scan():
"""Start RF scanning (Termux mode only)"""
# TODO: Implement T-Embed scanning
return {"status": "scanning"}
@router.get("/rtl433/status")
async def get_rtl433_status():
"""
Get RTL_433 decoder status and availability
Returns:
- available: Whether RTL_433 binary is installed
- version: RTL_433 version string
- binary_path: Path to rtl_433 binary
- timeout: Decode timeout in seconds
"""
try:
from ...matcher.rtl433_decoder import get_decoder
decoder = get_decoder()
available = decoder._check_rtl433_available()
version = decoder.get_version() if available else None
return {
"available": available,
"version": version,
"binary_path": decoder.rtl433_path,
"timeout": decoder.timeout,
"status": "operational" if available else "unavailable"
}
except Exception as e:
logger.error(f"Error checking RTL_433 status: {e}")
return {
"available": False,
"version": None,
"error": str(e),
"status": "error"
}
@router.get("/rtl433/protocols")
async def get_rtl433_protocols():
"""
Get list of supported RTL_433 protocols
Returns:
- total: Total number of supported protocols
- protocols: List of protocol objects with id and name
"""
try:
from ...matcher.rtl433_decoder import get_decoder
decoder = get_decoder()
if not decoder._check_rtl433_available():
raise HTTPException(
status_code=503,
detail="RTL_433 is not available on this server"
)
protocols = decoder.get_supported_protocols()
# Convert to list of objects
protocol_list = [
{"id": pid, "name": name}
for pid, name in sorted(protocols.items())
]
return {
"total": len(protocol_list),
"protocols": protocol_list
}
except HTTPException:
raise
except Exception as e:
logger.error(f"Error getting RTL_433 protocols: {e}")
raise HTTPException(
status_code=500,
detail=f"Failed to retrieve protocols: {str(e)}"
)
@router.get("/rtl433/protocols/{protocol_id}")
async def get_protocol_info(protocol_id: int):
"""
Get information about a specific RTL_433 protocol
Args:
protocol_id: Protocol ID number
Returns:
Protocol name and ID
"""
try:
from ...matcher.rtl433_decoder import get_decoder
decoder = get_decoder()
protocols = decoder.get_supported_protocols()
if protocol_id not in protocols:
raise HTTPException(
status_code=404,
detail=f"Protocol {protocol_id} not found"
)
return {
"id": protocol_id,
"name": protocols[protocol_id]
}
except HTTPException:
raise
except Exception as e:
logger.error(f"Error getting protocol {protocol_id}: {e}")
raise HTTPException(
status_code=500,
detail=f"Failed to retrieve protocol: {str(e)}"
)