Skip to content

Commit c5c7267

Browse files
committed
Clarify Pi deployment policy and PIC-paced strobe
1 parent c9e0688 commit c5c7267

6 files changed

Lines changed: 7 additions & 13 deletions

File tree

ARCHITECTURE.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -134,7 +134,7 @@ If you want to verify that “who owns what logic” is consistent in code, star
134134
Configuration is primarily driven by environment variables (`RIO_*`) plus a small number of config/constants in `software/config.py`.
135135
- **Hardware vs simulation**: routine dev/tests use `RIO_SIMULATION=true`; hardware runs use `RIO_SIMULATION=false`.
136136
- **Feature toggles**: modules such as droplet analysis, flow, heater can be enabled/disabled via env vars (see `software/README.md`).
137-
- **Control mode**: strobe-centric vs camera-centric mode is selected via `RIO_STROBE_CONTROL_MODE` (see deployment/software docs).
137+
- **Strobe pacing**: PIC-paced only (camera is triggered by the PIC; no multi-mode selection).
138138
- **ROI mode**: `RIO_ROI_MODE=software|hardware` (software default). Hardware ROI applies only on camera backends that support it; otherwise the app falls back to software ROI.
139139

140140
Example configuration files live under:

hardware-modules/strobe-imaging/strobe_pic/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ The host driver should treat the `main.c` packet switch as authoritative for pay
4848

4949
## Compatibility notes
5050

51-
- Host-side strobe behavior has multiple orchestration modes (strobe-centric vs camera-centric). Ensure the selected host mode is compatible with the firmware/trigger wiring you’re using.
51+
- Host-side strobe behavior is PIC-paced only (camera is triggered by the PIC). Ensure wiring matches this trigger direction.
5252
- If you use the hardware-trigger variant, verify the GPIO trigger pin wiring and the corresponding interrupt configuration.
5353

5454
## AI-generated notice

pi-deployment/configurations/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ This directory contains example configuration files and documentation for the Ri
2121

2222
### Detailed Reference Examples
2323

24-
- **`config-example-strobe-centric-32bit.yaml`** - Detailed 32-bit PIC-paced configuration
24+
- **`config-example-strobe-centric-32bit.yaml`** - Detailed 32-bit PIC-paced configuration (legacy filename)
2525

2626
## Documentation
2727

scripts/deploy/create-pi-deployment.bat

Lines changed: 3 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -113,10 +113,9 @@ echo echo ""
113113
echo echo "Setup complete!"
114114
echo echo ""
115115
echo echo "To run the application:"
116-
echo echo " 1. export RIO_STROBE_CONTROL_MODE=strobe-centric # or camera-centric"
117-
echo echo " 2. export RIO_SIMULATION=false"
118-
echo echo " 3. export RIO_DROPLET_ANALYSIS_ENABLED=true"
119-
echo echo " 4. python main.py"
116+
echo echo " 1. export RIO_SIMULATION=false"
117+
echo echo " 2. export RIO_DROPLET_ANALYSIS_ENABLED=true"
118+
echo echo " 3. python main.py"
120119
echo echo ""
121120
echo echo "Or use the run.sh script after setting environment variables."
122121
echo echo ""
@@ -132,14 +131,12 @@ echo.
132131
echo cd "$^(dirname "$0"^)"
133132
echo.
134133
echo # Set default environment variables if not set
135-
echo export RIO_STROBE_CONTROL_MODE=${RIO_STROBE_CONTROL_MODE:-strobe-centric}
136134
echo export RIO_SIMULATION=${RIO_SIMULATION:-false}
137135
echo export RIO_DROPLET_ANALYSIS_ENABLED=${RIO_DROPLET_ANALYSIS_ENABLED:-true}
138136
echo export RIO_FLOW_ENABLED=${RIO_FLOW_ENABLED:-false}
139137
echo export RIO_HEATER_ENABLED=${RIO_HEATER_ENABLED:-false}
140138
echo.
141139
echo echo "Starting Rio microfluidics controller..."
142-
echo echo "Control mode: $RIO_STROBE_CONTROL_MODE"
143140
echo echo "Simulation: $RIO_SIMULATION"
144141
echo echo "Droplet detection: $RIO_DROPLET_ANALYSIS_ENABLED"
145142
echo echo ""

scripts/deploy/create-pi-deployment.sh

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -288,7 +288,6 @@ echo "Next steps:"
288288
echo " 1. If legacy camera is not enabled, run: sudo raspi-config → Interface Options → Legacy Camera → Enable"
289289
echo " 2. Reboot if you changed camera settings: sudo reboot"
290290
echo " 3. After reboot, run the application:"
291-
echo " export RIO_STROBE_CONTROL_MODE=strobe-centric # or camera-centric"
292291
echo " export RIO_SIMULATION=false"
293292
echo " export RIO_DROPLET_ANALYSIS_ENABLED=true"
294293
echo " python main.py"
@@ -309,14 +308,12 @@ cat > "$DEPLOY_DIR/run.sh" << 'EOF'
309308
cd "$(dirname "$0")"
310309
311310
# Set default environment variables if not set
312-
export RIO_STROBE_CONTROL_MODE=${RIO_STROBE_CONTROL_MODE:-strobe-centric}
313311
export RIO_SIMULATION=${RIO_SIMULATION:-false}
314312
export RIO_DROPLET_ANALYSIS_ENABLED=${RIO_DROPLET_ANALYSIS_ENABLED:-true}
315313
export RIO_FLOW_ENABLED=${RIO_FLOW_ENABLED:-false}
316314
export RIO_HEATER_ENABLED=${RIO_HEATER_ENABLED:-false}
317315
318316
echo "Starting Rio microfluidics controller..."
319-
echo "Control mode: $RIO_STROBE_CONTROL_MODE"
320317
echo "Simulation: $RIO_SIMULATION"
321318
echo "Droplet detection: $RIO_DROPLET_ANALYSIS_ENABLED"
322319
echo ""

software/configurations/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ This directory contains example configuration files and documentation for the Ri
2121

2222
### Detailed Reference Examples
2323

24-
- **`config-example-strobe-centric-32bit.yaml`** - Detailed 32-bit PIC-paced configuration
24+
- **`config-example-strobe-centric-32bit.yaml`** - Detailed 32-bit PIC-paced configuration (legacy filename)
2525

2626
## Documentation
2727

0 commit comments

Comments
 (0)