Remove obsolete audio and buzzer control documentation files, including detailed guides and HTML interfaces, to streamline the repository and eliminate redundancy. This cleanup enhances maintainability and focuses on essential resources for the reTerminal DM4 audio and buzzer functionalities.
This commit is contained in:
92
archive/chromium-setup-legacy/JIRA-SUMMARY.md
Normal file
92
archive/chromium-setup-legacy/JIRA-SUMMARY.md
Normal file
@@ -0,0 +1,92 @@
|
||||
# reTerminal DM4 Buzzer Control - Jira Summary
|
||||
|
||||
## Summary
|
||||
|
||||
Implemented buzzer control functionality for reTerminal DM4 device with test scripts and documentation.
|
||||
|
||||
## Device Information
|
||||
|
||||
- **Model:** reTerminal DM4 (Raspberry Pi CM4)
|
||||
- **Buzzer Location:** Bottom right corner of screen
|
||||
- **Control Path:** `/sys/class/leds/usr-buzzer/brightness`
|
||||
- **Control Method:** Linux LED subsystem (on/off only)
|
||||
|
||||
## Implementation
|
||||
|
||||
### Test Scripts Created
|
||||
|
||||
1. **Bash Test Script** (`test_buzzer.sh`)
|
||||
- Location: `/home/pi/buzzer/test_buzzer.sh` on device
|
||||
- Tests: 8 different buzzer patterns (single, double, triple, long, rapid, slow, success, error)
|
||||
- Usage: `ssh guard "/home/pi/buzzer/test_buzzer.sh"` or `/home/pi/buzzer/test_buzzer.sh`
|
||||
|
||||
2. **Python Test Script** (`test_buzzer.py`)
|
||||
- Location: `/home/pi/buzzer/test_buzzer.py` on device
|
||||
- Same test patterns as bash script
|
||||
- Usage: `ssh guard "python3 /home/pi/buzzer/test_buzzer.py"` or `python3 /home/pi/buzzer/test_buzzer.py`
|
||||
|
||||
### Basic Control Commands
|
||||
|
||||
```bash
|
||||
# Turn ON
|
||||
echo 1 | sudo tee /sys/class/leds/usr-buzzer/brightness
|
||||
|
||||
# Turn OFF
|
||||
echo 0 | sudo tee /sys/class/leds/usr-buzzer/brightness
|
||||
|
||||
# Check Status
|
||||
cat /sys/class/leds/usr-buzzer/brightness # 0=OFF, 1/255=ON
|
||||
```
|
||||
|
||||
### Python Control Example
|
||||
|
||||
```python
|
||||
import subprocess
|
||||
import time
|
||||
|
||||
BUZZER = '/sys/class/leds/usr-buzzer/brightness'
|
||||
|
||||
def beep(duration=0.2):
|
||||
subprocess.run(['sudo', 'tee', BUZZER], input='1', text=True)
|
||||
time.sleep(duration)
|
||||
subprocess.run(['sudo', 'tee', BUZZER], input='0', text=True)
|
||||
```
|
||||
|
||||
## Common Use Cases
|
||||
|
||||
- **Success Alert:** 2 short beeps
|
||||
- **Error Alert:** 3 fast beeps
|
||||
- **Notification:** 1 short beep
|
||||
- **Warning:** 1 long beep
|
||||
|
||||
## Requirements
|
||||
|
||||
- `sudo` privileges required
|
||||
- Test scripts available on device at `/tmp/`
|
||||
- Buzzer is simple on/off (no volume/frequency control)
|
||||
|
||||
## Documentation
|
||||
|
||||
- **Quick Reference:** `BUZZER-CONTROL.md` - Concise guide with commands and test script references
|
||||
- **Detailed Guide:** `BUZZER-CONTROL-SIMPLE.md` - Comprehensive documentation
|
||||
- **Flask API:** `FLASK-BUZZER-CONTROL.md` - Web API implementation
|
||||
|
||||
## Testing
|
||||
|
||||
Both test scripts have been uploaded to the device and verified working. Scripts test:
|
||||
- Single beep patterns
|
||||
- Multiple beep patterns
|
||||
- Different timing intervals
|
||||
- Common alert patterns (success, error)
|
||||
|
||||
## Status
|
||||
|
||||
✅ **Complete** - Test scripts created, uploaded to device, and documentation provided.
|
||||
|
||||
## Files
|
||||
|
||||
- `test_buzzer.sh` - Bash test script
|
||||
- `test_buzzer.py` - Python test script
|
||||
- `BUZZER-CONTROL.md` - Quick reference documentation
|
||||
- `BUZZER-CONTROL-SIMPLE.md` - Detailed documentation
|
||||
- `FLASK-BUZZER-CONTROL.md` - Flask API documentation
|
||||
Reference in New Issue
Block a user