feat(camera): add bananarchy-photo CLI, Sxmo menu integration, and multi-capture ISPIF/VFE0 reset

MANUAL.md

@@ -35,8 +35,9 @@ This manual covers flashing, operating, and customizing **Bananarchy Linux** (`v
    - Patched `q6core`, `q6afe`, `q6afe-dai`, `q6voice-dai`, `q6mvm`, and device trees (`VoiceMMode1` DAI + PM8909 WCD codec).
    - Automatic PM8909 WCD analog codec register initialization at boot (`CDC_A_MICB_1_VAL` `0xf141 = 0x60` for 2.8V internal MEMS microphone bias, and `CDC_A_RX_EAR_CTL` `0xf1c0 |= 0x20` for +6 dB earpiece PA gain).
    - WirePlumber `50-s16le.lua` (`S16LE` sample format enforcement), ALSA UCM2 profiles (`qdsp6.conf`, `HiFi.conf`, and `VoiceCall.conf`), `q6voiced` (`card=0, device=2`), `sxmo_audio.sh` / `sxmo_modemaudio.sh` PipeWire UCM profile switching, `sxmo_ob.sh` (`WOB_DISABLE_PLEDGE=1`), `rmtfs`, `msm-modem-uim-selection`, `msm8909-modem-wwan-port`, and `ModemManager` (`mmcli`).
-5. **Rear 2MP camera (`src/msm8905-cam/`) & SY7807 torch LED (`src/leds-msm8905-torch/`)**:
+5. **Rear 2MP camera (`src/msm8905-cam/` & `bananarchy-photo`) & SY7807 torch LED (`src/leds-msm8905-torch/`)**:
    - `msm8905-cam.ko`: powers PM8909 LDOs (`L2` 1.2V, `L6` 1.8V, `L17` 2.85V) and `CAMSS_MCLK0` (24 MHz on GPIO 26), configures the GalaxyCore `GC2395` MIPI CSI-2 sensor (`blsp_i2c3` `0x37`) and MSM8909 `CAMSS` (`CSIPHY0 -> CSID0 -> ISPIF -> VFE0 RDI0 -> VBIF -> CMA`), and exposes `/dev/video0` (`800x600` 24-bit `RGB3` V4L2 capture device).
+   - `bananarchy-photo`: CLI and Sxmo menu camera utility (`Camera` in the Sxmo System and Apps menus) supporting instant JPEG/PNG photo capture, optional flash (`-f`), and `imv` photo viewing (`-v`).
    - `leds-msm8905-torch.ko`: exposes `/sys/class/leds/white:torch` (`GPIO 31`), configures WCD micbias/earpiece registers at boot, and hooks PM8909 `PON` clean shutdown.
 6. **Memory & swap tuning for 512 MB RAM**:
    - `384 MiB` ZSTD-compressed `zram0` swap (priority `100`) + `512 MiB` `/swapfile` (priority `10`), with `vm.swappiness=100` and `vm.page-cluster=0`.
@@ -45,7 +46,7 @@ This manual covers flashing, operating, and customizing **Bananarchy Linux** (`v
    - **Janet**: `janet`, `janet-dev`, `jpm` (Janet package manager)
    - **Perl**: `perl`, `perl-io-socket-ssl` (`IO::Socket::SSL`)
    - **Tcl & SQLite**: `tcl`, `tcl-lib` (`tcllib`), `tcl-tls`, `sqlite` (`sqlite3`), `sqlite-tcl` (`tcl-sqlite`)
-   - **Hardware & media utilities**: `v4l-utils` (`v4l2-ctl`), `i2c-tools`, `ffmpeg`, `mpv`, `imv`
+   - **Hardware & media utilities**: `bananarchy-photo`, `v4l-utils` (`v4l2-ctl`), `i2c-tools`, `ffmpeg`, `mpv`, `imv`
 
 ---
 
@@ -235,22 +236,37 @@ You can switch between **vertical (`splitv`, one under another)**, **horizontal
 
 ## 5. Camera, audio, flashlight & cellular modem reference
 
-### 5.1 Taking photos with the rear camera (`/dev/video0`)
+### 5.1 Taking photos with the rear camera (`bananarchy-photo` & `/dev/video0`)
 
 The `msm8905-cam` kernel module drives the rear 2MP GalaxyCore `GC2395` sensor through MSM8909 `CAMSS` (`CSIPHY0 -> CSID0 -> ISPIF -> VFE0 -> VBIF`) and registers `/dev/video0` (`800x600` 24-bit `RGB3`).
 
-To capture a photo to `~/photo.jpg` (or `.png`), stream a frame with `v4l2-ctl` and encode it with `ffmpeg -f rawvideo`:
-```bash
-v4l2-ctl -d /dev/video0 \
-  --set-fmt-video=width=800,height=600,pixelformat=RGB3 \
-  --stream-mmap --stream-count=1 --stream-to=/tmp/frame.rgb && \
-ffmpeg -hide_banner -loglevel error \
-  -f rawvideo -pixel_format rgb24 -video_size 800x600 \
-  -i /tmp/frame.rgb -frames:v 1 -y ~/photo.jpg && \
-rm -f /tmp/frame.rgb
-```
-- **Viewing photos on the phone**: run `imv ~/photo.jpg` or `mpv ~/photo.jpg`.
-- **Why `v4l2-ctl` + `ffmpeg -f rawvideo` is used**: Alpine's `libavdevice` links against `libv4l2.so.0`, whose `v4l2_mmap` wrapper on 32-bit ARM (`musl` 64-bit `off_t`) misaligns variadic `syscall(SYS_mmap2, ...)` arguments. Capturing via `v4l2-ctl` and encoding via `ffmpeg -f rawvideo` bypasses `libv4l2` completely.
+- **From the Sxmo keypad UI**:
+  Open the **System menu** (`Left softkey`) or **Apps menu** (`Left softkey` -> `Apps`) and select **Camera** (`bananarchy-photo --menu`). From the Camera menu you can:
+  - **Take photo**: capture a photo to `~/Pictures/photo-YYYYMMDD-HHMMSS.jpg` and immediately open it in `imv`.
+  - **Take photo (flash)**: turn on the rear flashlight (`white:torch`), capture a photo, restore the flashlight state, and open the photo in `imv`.
+  - **View photos**: browse all saved photos in `~/Pictures` using `imv` (press `Right softkey` inside `imv` to navigate, zoom, rotate, or quit).
+- **From the CLI (`bananarchy-photo`)**:
+  ```bash
+  # Capture to ~/Pictures/photo-YYYYMMDD-HHMMSS.jpg and print path
+  bananarchy-photo
+
+  # Capture with rear LED flash enabled and open in imv
+  bananarchy-photo -f -v
+
+  # Capture to a custom JPEG or PNG file path
+  bananarchy-photo ~/my-shot.png
+  ```
+- **Direct low-level capture (`v4l2-ctl` + `ffmpeg -f rawvideo`)**:
+  ```bash
+  v4l2-ctl -d /dev/video0 \
+    --set-fmt-video=width=800,height=600,pixelformat=RGB3 \
+    --stream-mmap --stream-count=1 --stream-to=/tmp/frame.rgb && \
+  ffmpeg -hide_banner -loglevel error \
+    -f rawvideo -pixel_format rgb24 -video_size 800x600 \
+    -i /tmp/frame.rgb -frames:v 1 -y ~/photo.jpg && \
+  rm -f /tmp/frame.rgb
+  ```
+- **Why `v4l2-ctl` + `ffmpeg -f rawvideo` is used under the hood**: Alpine's `libavdevice` links against `libv4l2.so.0`, whose `v4l2_mmap` wrapper on 32-bit ARM (`musl` 64-bit `off_t`) misaligns variadic `syscall(SYS_mmap2, ...)` arguments. Capturing via `v4l2-ctl` and encoding via `ffmpeg -f rawvideo` bypasses `libv4l2` completely.
 
 ### 5.2 Switching speakers (loudspeaker vs. earpiece) & recording microphone audio