usda-vision/management-dashboard-web-app/API Documentations/docs/CURRENT_CONFIGURATION.md

📋 Current System Configuration Reference

Overview

This document shows the exact current configuration structure of the USDA Vision Camera System, including all fields and their current values.

🔧 Complete Configuration Structure

System Configuration (config.json)

{
  "mqtt": {
    "broker_host": "192.168.1.110",
    "broker_port": 1883,
    "username": null,
    "password": null,
    "topics": {
      "vibratory_conveyor": "vision/vibratory_conveyor/state",
      "blower_separator": "vision/blower_separator/state"
    }
  },
  "storage": {
    "base_path": "/storage",
    "max_file_size_mb": 1000,
    "max_recording_duration_minutes": 60,
    "cleanup_older_than_days": 30
  },
  "system": {
    "camera_check_interval_seconds": 2,
    "log_level": "DEBUG",
    "log_file": "usda_vision_system.log",
    "api_host": "0.0.0.0",
    "api_port": 8000,
    "enable_api": true,
    "timezone": "America/New_York",
    "auto_recording_enabled": true
  },
  "cameras": [
    {
      "name": "camera1",
      "machine_topic": "blower_separator",
      "storage_path": "/storage/camera1",
      "exposure_ms": 0.3,
      "gain": 4.0,
      "target_fps": 0,
      "enabled": true,
      "video_format": "mp4",
      "video_codec": "mp4v",
      "video_quality": 95,
      "auto_start_recording_enabled": true,
      "auto_recording_max_retries": 3,
      "auto_recording_retry_delay_seconds": 2,
      "sharpness": 0,
      "contrast": 100,
      "saturation": 100,
      "gamma": 100,
      "noise_filter_enabled": false,
      "denoise_3d_enabled": false,
      "auto_white_balance": false,
      "color_temperature_preset": 0,
      "wb_red_gain": 0.94,
      "wb_green_gain": 1.0,
      "wb_blue_gain": 0.87,
      "anti_flicker_enabled": false,
      "light_frequency": 0,
      "bit_depth": 8,
      "hdr_enabled": false,
      "hdr_gain_mode": 2
    },
    {
      "name": "camera2",
      "machine_topic": "vibratory_conveyor",
      "storage_path": "/storage/camera2",
      "exposure_ms": 0.2,
      "gain": 2.0,
      "target_fps": 0,
      "enabled": true,
      "video_format": "mp4",
      "video_codec": "mp4v",
      "video_quality": 95,
      "auto_start_recording_enabled": true,
      "auto_recording_max_retries": 3,
      "auto_recording_retry_delay_seconds": 2,
      "sharpness": 0,
      "contrast": 100,
      "saturation": 100,
      "gamma": 100,
      "noise_filter_enabled": false,
      "denoise_3d_enabled": false,
      "auto_white_balance": false,
      "color_temperature_preset": 0,
      "wb_red_gain": 1.01,
      "wb_green_gain": 1.0,
      "wb_blue_gain": 0.87,
      "anti_flicker_enabled": false,
      "light_frequency": 0,
      "bit_depth": 8,
      "hdr_enabled": false,
      "hdr_gain_mode": 0
    }
  ]
}

📊 Configuration Field Reference

MQTT Settings

Field	Value	Description
broker_host	"192.168.1.110"	MQTT broker IP address
broker_port	1883	MQTT broker port
username	null	MQTT authentication (not used)
password	null	MQTT authentication (not used)

MQTT Topics

Machine	Topic	Camera
Vibratory Conveyor	vision/vibratory_conveyor/state	camera2
Blower Separator	vision/blower_separator/state	camera1

Storage Settings

Field	Value	Description
base_path	"/mnt/nfs_share"	Root storage directory
max_file_size_mb	1000	Maximum file size (1GB)
max_recording_duration_minutes	60	Maximum recording duration
cleanup_older_than_days	30	Auto-cleanup threshold

System Settings

Field	Value	Description
camera_check_interval_seconds	2	Camera health check interval
log_level	"DEBUG"	Logging verbosity
api_host	"0.0.0.0"	API server bind address
api_port	8000	API server port
timezone	"America/New_York"	System timezone
auto_recording_enabled	true	Enable MQTT-triggered recording

🎥 Camera Configuration Details

Camera 1 (Blower Separator)

Setting	Value	Description
Basic Settings
name	"camera1"	Camera identifier
machine_topic	"blower_separator"	MQTT topic to monitor
storage_path	"/mnt/nfs_share/camera1"	Video storage location
exposure_ms	0.3	Exposure time (milliseconds)
gain	4.0	Camera gain multiplier
target_fps	0	Target FPS (0 = unlimited)
Video Recording
video_format	"mp4"	Video file format
video_codec	"mp4v"	Video codec (MPEG-4)
video_quality	95	Video quality (0-100)
Auto Recording
auto_start_recording_enabled	true	Enable auto-recording
auto_recording_max_retries	3	Max retry attempts
auto_recording_retry_delay_seconds	2	Delay between retries
Image Quality
sharpness	0	Sharpness adjustment
contrast	100	Contrast level
saturation	100	Color saturation
gamma	100	Gamma correction
White Balance
auto_white_balance	false	Auto white balance disabled
wb_red_gain	0.94	Red channel gain
wb_green_gain	1.0	Green channel gain
wb_blue_gain	0.87	Blue channel gain
Advanced
bit_depth	8	Color bit depth
hdr_enabled	false	HDR disabled
hdr_gain_mode	2	HDR gain mode

Camera 2 (Vibratory Conveyor)

Setting	Value	Difference from Camera 1
name	"camera2"	Different identifier
machine_topic	"vibratory_conveyor"	Different MQTT topic
storage_path	"/storage/camera2"	Different storage path
exposure_ms	0.2	Faster exposure (0.2 vs 0.3)
gain	2.0	Lower gain (2.0 vs 4.0)
wb_red_gain	1.01	Different red balance (1.01 vs 0.94)
hdr_gain_mode	0	Different HDR mode (0 vs 2)

All other settings are identical to Camera 1

🔄 Recent Changes

MP4 Format Update

• Added: video_format, video_codec, video_quality fields
• Changed: Default recording format from AVI to MP4
• Impact: Requires service restart to take effect

Current Status

• ✅ Configuration updated with MP4 settings
• ⚠️ Service restart required to apply changes
• 📁 Existing AVI files remain accessible

📝 Notes

1. Target FPS = 0: Both cameras use unlimited frame rate for maximum capture speed
2. Auto Recording: Both cameras automatically start recording when their respective machines turn on
3. White Balance: Manual white balance settings optimized for each camera's environment
4. Storage: Each camera has its own dedicated storage directory
5. Video Quality: Set to 95/100 for high-quality recordings with MP4 compression benefits

🔧 Configuration Management

To modify these settings:

1. Edit config.json file
2. Restart the camera service: sudo ./start_system.sh
3. Verify changes via API: GET /cameras/{camera_name}/config

For real-time settings (exposure, gain, fps), use the API without restart:

PUT /cameras/{camera_name}/config