diff --git a/LABORATORY.md b/LABORATORY.md deleted file mode 100644 index 0331e2d4..00000000 --- a/LABORATORY.md +++ /dev/null @@ -1,356 +0,0 @@ -# Laboratory - -The test bench for on-device testing of the decoder: devices, cameras, what each of them can do, how to reach them and how to test. This file holds the things that **change rarely**. Plans, checklists and run results stay in the test-round issues. - -| Goes here | Goes into the test-round issue | -|---|---| -| devices, cameras, IP addresses, firmware, codecs | which PRs and builds are tested in this round | -| what a camera or server supports (transports, audio codecs, limits) | checklist (`- [ ]`) | -| access, tools, scripts, pitfalls | one comment per run: build, commit, result table, findings | -| log lines and how to read them | open questions to check on the bench | - -**Keep it current.** If a test round finds that something here is wrong or has changed (new camera, new firmware, a camera broke, a new pitfall), fix this file in the same round and mention the change in the run comment. - -**Never publish credentials.** No passwords, no full RTSP URLs with credentials, no screenshots with people in the frame. Ask in the round's issue if you need them. - -## Test rounds - -| Round | Issue | Scope | -|---|---|---| -| 1 | [#53](https://github.com/OpenIPC/decoder/issues/53) (closed, reference) | v2 lifecycle, video fit, audio formats, Quad audio, credential store (#48–#52, #54) | -| 2 | [#74](https://github.com/OpenIPC/decoder/issues/74) | transports: RTSP over UDP, plain RTP, RTSP multicast (#70, #72, #73) | - -A new round opens a new issue with the same structure as #53, links to this file for the bench and adds a row to the table above. - -## Rules - -- **CI builds only.** Test the APKs built by GitHub Actions: workflow artifacts for working branches, the `latest` release for `v2` / `basic`. No local builds. -- Check the commit hash of the installed build in the menu (`Exit [v…, ]`). -- Leave a build with working cameras installed on the device when you finish. -- Findings that are not quick fixes get their own issues (time-box about 15 minutes per problem). -- When every item for a PR is ticked: comment on the PR with a link to the result, take it out of draft, remove `awaiting device test`. - -## Devices - -### AG-216 Android TV boxes - -Two identical boxes with the same firmware (checked 2026-10-13): - -| | Aceline-1 | Aceline-2 | -|---|---|---| -| Address | `172.17.32.144:5555` (Ethernet; Wi‑Fi switched off) | `172.17.32.145:5555` (Ethernet) | -| Display | **none** (headless): only `screencap`, the debug page and the logs show what is on screen | **monitor** Philips 226VL over HDMI (HDMI audio active); for checks that need a real picture or a person looking | -| Serial | `KFB442005119` | `KFB442001288` | -| Extra apps | Yandex Browser TV, Faceter, Record Radio | VK TV, Wink, VLC, Nova; autostart `com.oranth.atvapplist` | -| Role | test box: builds of working branches, 8-camera 3×3 layout below | **always the latest `v2` release** (updated after every merge into `v2`), for a look at the current app; multi-view with two cameras: slot 1 `.133`, slot 2 `.165` | - -Common to both: - -| | | -|---|---| -| Access | ADB over TCP on port 5555, no authorization prompt, shell uid 2000 (no root) | -| Model | `AG-216` (`ro.product.brand`/`manufacturer` say Amlogic, product `p281`); the SoC is **Allwinner** `sun50iw9p1` (H313/H616 family), platform `cupid` / `homlet` | -| Firmware | `eros_p1-userdebug 10 QP1A.191105.004 251022 release-keys`, built 2025-10-22, kernel 4.9.170, security patch 2019-12-05 | -| Fingerprint | `Amlogic/p281/p281:10/QP1A.191105.004/251022:userdebug/release-keys` | -| Android | 10 (API 29), `armeabi-v7a` (32-bit userspace on a 64-bit CPU) | -| RAM / storage | 2 GB / `/data` 11 GB | -| Screen | 1280×720 (16:9), 60 Hz, 160 dpi, `television` UI mode, no touch | -| HW video decoder | `OMX.allwinner.video.decoder.avc` (16 instances), `…hevc` (**4** instances); beyond that, key-frame cells use `c2.android.*` software decoders (#138) | -| JPEG decoder | `OMX.allwinner.video.decoder.mjpeg` is declared in `/vendor/etc/media_codecs.xml` but not listed by Android, and creating it fails (`0xfffffffe`): MJPEG always runs on the software path here | -| Decoder hang | Once (2026-10-13, after a long test session) every cell received but nothing decoded until `adb reboot`; the app now says so (#145, #147). In tests: all cells `0.0 fps` with `in_fps` > 0 → reboot the box first | -| Quirks | The vendor firmware sometimes shows its own "Update Alert!!" dialog after screen off/on; unrelated to the app | - -Check the firmware of a box: `$ADB shell getprop ro.build.description`. If it changes, update the table above. - -#### Developer settings - -Both boxes are kept in sync (aligned on 2026-10-13). Check with `$ADB shell settings get `: - -| Setting | Value | Why | -|---|---|---| -| Developer options, ADB | on | | -| `global stay_on_while_plugged_in` | `3`; screen-off timeout never | the screen never sleeps during a run | -| Animation scales | 1.0 | | -| `system pointer_location`, `system show_touches` | 0 | the pointer overlay would be drawn on top of the app and end up in screenshots | -| `secure anr_show_background` | 1 | ANR dialogs of background apps are shown (#76) | -| `global package_verifier_enable`, `verifier_verify_adb_installs` | 0, 0 | `adb install` is not verified (no delay, no prompt on screen) | -| `global hdmi_control_enabled` / `hdmi_control_auto_device_off_enabled` | 1 / 0 | CEC on, but the box does not switch the display off | -| Locale | `en-GB` | system UI and app strings in English, also in screenshots | - -Set without root: `settings put …` for the keys; the locale via Settings → Language (`am start -a android.settings.LOCALE_SETTINGS`, D-pad to *English (United Kingdom)*). Left as they are, not used by the app: `debug_view_attributes`, `force_allow_on_external`, `force_resizable_activities` (on only on Aceline-1). - -Not available in the lab yet: a phone or tablet (rotation, #31), a Wi‑Fi Android device (multicast lock), Android 5. - -### TECNO KM4 phone (touch) - -Added 2026-10-14: the only device in the lab with a touch screen and an on-screen keyboard. Use it for WebUI and text input (#159, #160) and for anything touch-only. - -| | | -|---|---| -| Address | `172.17.32.170` (Wi‑Fi); ADB only over **Wireless debugging** (see [adb](#adb)), no port 5555 | -| Model | TECNO KM4, `TECNO/KM4-RU/TECNO-KM4:15/AP3A.240905.015.A2/180010:user/release-keys` | -| SoC | Unisoc **UMS9230E** (T606 class), `arm64-v8a`, kernel 5.15 | -| Android | 15 (API 35); the app runs edge to edge here (target SDK 36), so system bars overlap windows that do not handle insets | -| RAM | 3 GB | -| Screen | 720×1600, 280 dpi, touch, on-screen keyboard (Gboard); the app turns it to landscape (1600×720) | -| HW video decoder | `c2.unisoc.avc.decoder` / `c2.unisoc.hevc.decoder` (10 instances each; 1080p: H.264 106 fps, H.265 212 fps), also as `OMX.sprd.*` | -| Menu | a tap on the picture; `uiautomator dump` works for finding buttons | -| Checked | 2026-10-14, v2.04, `.133` over RTSP: H.264 1920×1080 at 30 fps (UDP, Opus), 16:9 kept. WebUI full screen (#160): the keyboard shows for the camera's login fields, the page scrolls the focused field above it, typed text stays when the focus moves to another field, Back hides the keyboard and then closes WebUI. Found: **Close** two thirds under the status bar (#169) | - -## Cameras - -All cameras are on the lab network `172.17.32.0/24` and reachable from the device. - -### Group A: stream tests - -Only these cameras are used for protocol, codec, audio and transport tests. - -| IP | Hardware / firmware | Video | Audio | RTSP server | Notes | -|---|---|---|---|---|---| -| `172.17.32.133` | OpenIPC, SigmaStar SSC33x (infinity6b0), Majestic Lite | H.264 | Opus | `OpenIPC.org RTSP Server/0.1` | OSD "The OpenIPC Lab."; codec and audio are changed live in tests | -| `172.17.32.126` | OpenIPC, SigmaStar SSC33x (infinity6b0), sensor SC2336P, Majestic Lite | H.265 1920×1088 | Opus 48 kHz stereo | `OpenIPC.org RTSP Server/0.1` | Also has an ONVIF metadata track | -| `172.17.32.53` | XM, stock firmware | H.264 1280×720 (coded 1280×736), 25 fps | none | `H264DVR 1.0` | **One RTSP client at a time**; login and password are in the URL path | - -Default state is listed above; a round that changes a camera's codec should put it back or note the new state here. - -### Group B: grid fillers - -Only for filling grid cells (Quad 2×2, 3×3) and screenshots; not used in stream tests. - -| IP | Video | State | -|---|---|---| -| `172.17.32.201` | H.264 | OK; substream is off (`stream=1` returns an empty stream) | -| `172.17.32.184` | H.265 | OK | -| `172.17.32.167` | | OK | -| `172.17.32.247` | | OK | -| `172.17.32.248` | | OK | -| `172.17.32.165` | H.265 1920×1080, 30 fps | OK since 2026-10-13 (SSC335, sc2336; firmware 2.6.10.12 lite). Before, on the 2024-10 firmware, the encoder produced no frames: SDP without parameter sets (`profile-level-id=000000`), `MI_VENC … ring height is zero` in `dmesg`; fixed by the firmware update | - -### URLs - -- OpenIPC cameras: `rtsp://:@/stream=0` (main), `/stream=1` (substream). -- MJPEG (Majestic): RTSP `rtsp://:@/stream=2` (RTP/JPEG, `.133`: 1280×720, 5 fps), HTTP `http://:@/mjpeg` (`multipart/x-mixed-replace`, chunked, Basic auth). -- XM: `rtsp://:554/user=_password=_channel=1_stream=0.sdp?real_stream`. The password is in the path, so it also appears in the `Content-Base` header; the app redacts it in logs (#55). - -### README screenshots - -Retake them with every version that changes what the app looks like, on **both** devices (from 2026-10-14): - -| File | Device | What | -|---|---|---| -| `quad_menu.jpg` | Aceline-1 (`.144`), `screencap` | 3×3 layout below with the menu open (open it with `DPAD_CENTER` and capture within a second: it closes by itself) | -| `single_status.jpg` | Aceline-1 | single view right after connecting, with the status line (`screenrecord`, then a frame; the line shows ~3 s) | -| `debug_page.jpg`, `debug_json.png`, `debug_log.png` | Aceline-1's debug page | headless Chromium, 1440×900 | -| `phone_menu.jpg`, `phone_single.jpg`, `phone_reset.jpg`, `phone_webui.jpg` | TECNO KM4 (`.170`) | the menu, single view with the status line (`screenrecord --size 1600x720`), the Reset confirmation, WebUI with the keyboard on the camera's login page | - -A night picture is fine. Never a password in a shot. - -### 3×3 layout (README screenshots, 8-slot tests) - -| Slot | Camera | -|---|---| -| 1 | `.247` | -| 2 | `.133`, HTTP MJPEG `http://<.133>/mjpeg` (#121, #139) | -| 3 | `.126` | -| 4 | `.201` | -| 5 | `.248` | -| 6 | `.184` | -| 7 | `.167` | -| 8 | `.53` (XM, bottom right) | - -The ninth cell is the U cell (pushed UDP RTP, #87). Its source on the bench: `.165` pushes its main stream with Majestic `outgoing` to `udp://172.17.32.144:5600` (Aceline-1); `.165` is also a spare filler for any slot. - -### Other sources - -| What | Where | Notes | -|---|---|---| -| MJPEG over RTSP (#119) | `rtsp://<.133>/stream=2` | RTP/JPEG PT 26, type 0 (4:2:2), Q = 255 (tables in-band), 1280×720, 5 fps, ≈ 5 Mbit/s, plus Opus | -| HTTP MJPEG (#121) | `http://<.133>/mjpeg` | `multipart/x-mixed-replace; boundary=boundarydonotcross`, Basic auth | -| Pushed RTP | `.165` → Aceline-1 `:5600` | the U cell; check with `curl -u … http://172.17.32.165/api/v1/outgoing.json` (`state: live`) | - -## What the servers support - -### RTSP transports - -Checked with raw RTSP `SETUP` requests (2026-10-12). - -| Request (`Transport:`) | Majestic Lite (`.133`, `.126`) | XM `H264DVR 1.0` (`.53`) | -|---|---|---| -| `RTP/AVP/TCP;interleaved` | 200 | 200 | -| `RTP/AVP;unicast;client_port=X-Y` | 200, `RTP/AVP/UDP;unicast;…;server_port` | 200, `RTP/AVP;unicast;mode=PLAY;source=…;server_port=…;ssrc=…` (no `/UDP`) | -| `RTP/AVP;multicast` (with or without `destination`) | **400** `client_port' not found` | **451** | -| `RTP/AVP;multicast;client_port=…` | 200, but silently unicast | 200, but silently unicast | - -No camera in the lab does RTSP multicast. To test #69 for real, run a multicast-capable RTSP server on the lab host (e.g. mediamtx relaying `.133`). - -Multicast from OpenIPC is only available as plain RTP via Majestic `outgoing` (`udp://:`), see #68. - -### RTP over UDP from the lab cameras - -Measured on the lab host (8 s of RTSP-over-UDP video each, #113): the cameras send the packets **heavily reordered** (up to ~42 positions, p99 34 — the app's reorder buffer handles that), and `.126` also **loses** about 1.5 packets/s on the way (`.133`: almost none). A 1080p key frame is a few hundred packets, so over UDP key frames often arrive with a hole and are dropped whole: on key frames only (multi-view) such a cell shows nothing. Auto then falls back to TCP (#125, #128); pushed streams (`udp://`, the U cell) cannot (#133). Over TCP nothing is lost. The AG-216 caps the socket receive buffer at 256 KiB (`rmem_max`), which is not the cause. - -### SDP - -- Majestic: `c=IN IP4 0.0.0.0`; tracks `a=control:video`, `audio`, `metadata`; Opus PT 98, ONVIF metadata PT 107. -- XM: `c=IN IP4 172.17.32.53`; one track `a=control:trackID=3`, video H.264 only. - -### Audio codecs (Majestic Lite on the lab cameras) - -| `.audio.codec` | RTP | Status | -|---|---|---| -| `opus` | `opus/48000/2` | ✅ supported | -| `aac` | `mpeg4-generic/8000/1` | ✅ supported | -| PCM | `L16/8000/1` | ✅ supported | -| G.711 μ-law / A-law | | ❌ falls back to L16 on this build; G.711 cannot be tested here | - -### Changing the camera on the fly (OpenIPC) - -```sh -ssh root@172.17.32.133 -cli -s .video0.codec h265 # h264 | h265 -cli -s .audio.codec opus # opus | aac | ... -/etc/init.d/S95majestic restart -``` - -Plain RTP (`outgoing`): add a destination such as `udp://172.17.32.144:5600` (or a group `udp://239.1.2.3:5600`) in the web UI → Outgoing, or via `/api/v1/outgoing.json`. - -Rebooting a test camera or restarting Majestic on it is fine when it misbehaves. - -## Access - -### adb - -`adb` is not installed system-wide on the lab host. Download Google's platform-tools to a temp dir: - -```sh -curl -sSLO https://dl.google.com/android/repository/platform-tools-latest-linux.zip -unzip -q platform-tools-latest-linux.zip -$PWD/platform-tools/adb connect 172.17.32.144:5555 # Aceline-1, no display -$PWD/platform-tools/adb connect 172.17.32.145:5555 # Aceline-2, with a monitor -export ADB="$PWD/platform-tools/adb -s 172.17.32.144:5555" -$ADB shell getprop ro.product.model # AG-216 -``` - -With several devices connected, every command needs `-s :`. - -**TECNO KM4 (`.170`): Wireless debugging (Android 11+).** It has no fixed port: `adb connect` fails (`failed to connect`) until the lab host is paired, and the debugging port changes whenever Wireless debugging is restarted or the phone reboots. - -1. On the phone: *Settings → Developer options → Wireless debugging*. The main screen shows **IP address & port**: the debugging port, for `connect`. -2. *Pair device with pairing code*: a **pairing port** (a different one) and a **6-digit code**, valid while that dialog is open. Ask the person at the phone for both. -3. On the lab host: - ```sh - $PWD/platform-tools/adb pair 172.17.32.170: # "Successfully paired" - $PWD/platform-tools/adb connect 172.17.32.170: - export ADB="$PWD/platform-tools/adb -s 172.17.32.170:" - ``` - -The pairing is kept with the host's adb key (`~/.android/adbkey`): later only `connect` with the current debugging port is needed, and `pair` again only after the key or the phone's pairings were reset. - -### Builds - -- `v2` / `basic`: `gh release download latest -R OpenIPC/decoder -p decoder-v2.apk -p decoder.apk` -- An older `v2` / `basic` build: from the OpenIPC Telegram channel (every build of these branches is posted there with its version and commit). There are no per-version releases (#194). -- Branches: `build.yml` builds signed APKs only on **push** runs (not `pull_request`); artifact name is `decoder-`: - ```sh - B=feat/rtsp-multicast - RUN=$(gh run list -R OpenIPC/decoder -b $B -e push -L 1 --json databaseId -q '.[0].databaseId') - gh run download $RUN -R OpenIPC/decoder -n decoder-${B//\//-} - ``` -- Versions: `v2` is **2.xx** (from 2.00, #152). Every PR that changes the app bumps `android/app/build.gradle` as its last commit before the merge: `versionName` +0.01 (2.00 → 2.01 → …), `versionCode` +1. Docs-only PRs do not. `basic` keeps its 1.07.x line. The installed version shows in the menu (`Exit [v…]`) and in `/stats.json`. -- Every build is `com.openipc.decoder` with the release signature. Switching from a debug build needs `adb uninstall` first, which wipes the settings. - -### Setting a camera without the UI - -```sh -$ADB shell "am start -a android.intent.action.SEND -t text/plain \ - --es android.intent.extra.TEXT '' [--es transport tcp|udp|auto|multicast] \ - -n com.openipc.decoder/.Decoder" -``` - -The link goes into the active slot and is saved. The transport extra exists from #70 on. - -- Transport in the UI: menu → URL dialog of the slot → **TCP / UDP / Auto / Multicast** under the URL. -- udp:// slots (#72) are a URL, not a transport: `udp://@:5600`, `udp://@239.1.2.3:5600`, `udp://@239.1.2.3:5600`, optional `?codec=h265&pt=97`. -- The share intent writes into the **active** slot (and switches to the single view): select the slot first. -- Filling slots on the box: tap a menu button by its text rather than by coordinates (from 2.06 the menu is a grid: slots `1`–`8` on top, then `Settings WebUI Grid Slides`, then `Exit Reset Debug UDP`, #177): `uiautomator dump`, take the `bounds` of `text="N"`, `input tap` its centre; the URL dialog of a slot: **Settings** (single view only) → `TCP` / `UDP` / `Auto` / `Multicast` → `SAVE`. - -## Methods - -### Smoke test - -Install → set the camera via the share intent → 15 s → screenshot → 3× (Home → back via the launcher) → screenshot → logcat. Pass: picture after every resume, thread count does not grow, 0 `FATAL EXCEPTION` / `ANR in`. - -
smoke.sh <apk> <label> (needs ADB and CAM_URL in the environment) - -```bash -#!/bin/bash -# usage: ADB="adb -s 172.17.32.144:5555" CAM_URL='rtsp://...' ./smoke.sh
- -The script uninstalls first. To test an upgrade that keeps the settings, use `$ADB install -r` without the uninstall. - -### Other checks - -| What | How | -|---|---| -| Thread leak | `$ADB shell ls /proc/$(pidof com.openipc.decoder)/task \| wc -l`, before and after | -| UDP socket leak | `$ADB shell cat /proc/$(pidof com.openipc.decoder)/net/udp`, count lines before and after | -| CPU per thread | `$ADB shell top -H -p ` (a spinning `rtsp-audio` thread was found this way) | -| Screen off / on | `input keyevent KEYCODE_SLEEP` / `KEYCODE_WAKEUP` | -| Grid ↔ single stress (#76) | loop: menu → tap `4` (grid → single), 4 s, menu → tap `Grid` (single → grid; `Q` before 2.06), 8 s; afterwards count `Davey! duration=` ≥ 1000 ms and `ANR in` in logcat; 8–10 cycles reproduce #76 today | -| Transport in use | `/stats.json`: `transport` (in use, e.g. `TCP (auto)` after a fallback) and `transport_mode` (setting) per cell; `nal_dropped` = NAL units lost to packet loss | -| Menu with a remote (#91) | `input keyevent KEYCODE_DPAD_CENTER` opens the menu with the focus on the active item (slot, Grid or UDP; Q or U before 2.06); `DPAD_RIGHT` ×n along the slots, `DPAD_DOWN` to the word cell under the slot (Settings, WebUI, Grid or Slides; a grey one passes on to the row below), `DPAD_UP` back to the left slot above it, then `DPAD_CENTER` must switch to that slot; `KEYCODE_BACK` closes it. The focused item: `uiautomator dump /sdcard/m.xml` and look for `focused="true"`. Check in single view and multi-view | -| 4:3 screen | `wm size 960x720`, back with `wm size reset` | -| Audio playback (sound cannot be heard remotely) | `dumpsys media.audio_flinger`: server position of the app's track; frames/s ≈ sample rate, no underruns | -| Screenshot | `$ADB exec-out screencap -p > shot.png`; long-press screenshot in the app saves to `Pictures/OpenIPC/` | -| Load average on SigmaStar cameras | ~10–11 is normal on SSC33x (the vendor pipeline threads sit in `D` state); not a sign of a fault | -| UI frozen? | `dumpsys gfxinfo com.openipc.decoder`: frame count must grow | -| Block UDP from a camera (no root on the box) | on the camera: `iptables -A OUTPUT -p udp --sport 1024: -j DROP`, remove afterwards; if the camera has no `iptables`, mark as not testable | -| Installed build | menu → `Exit [v…, ]`, or `dumpsys package com.openipc.decoder \| grep versionName` | - -### Log lines (`logcat -s OpenIPCDecoder`) - -| Line | Meaning | -|---|---| -| `Start video decoder` | decoder (re)started; count per run | -| `playing over UDP` / `TCP` / `multicast` | transport in use after PLAY | -| `UDP SETUP failed (…), using TCP`, `no video over UDP, using TCP`, `multicast SETUP failed (…)` | Auto / Multicast fallback | -| `listening for RTP on UDP port …, group …` | udp:// slot bound | -| `RTP payload type 96, H.264` | udp:// codec picked from the stream | -| `joined 239.x.x.x:port` | RTSP multicast group joined | -| `UDP channel …: N packets lost, M late or duplicate` | reorder stats when a session ends | -| `UDP from an unexpected sender ignored` | sender filter | -| `…: packets but no decoded frame for 8 s (N NAL units lost) over UDP, using TCP` | Auto: UDP delivered, but nothing decodable (#125) | -| `audio SETUP over UDP failed (…), using TCP`, `audio not over UDP like video, using TCP` | Auto: UDP audio not possible, both tracks over TCP (#128) | -| `NAL unit dropped (…): packet loss inside a fragmented NAL unit` | a NAL unit with a lost packet (logged 1st–3rd, then every 100th) | -| `Video pt 26 MJPEG`, `JPEG frame dropped (…)` | MJPEG stream (#119) / a JPEG frame with a lost packet | -| `Decoder capacity of this device: … blocks/s, failed at …` | multi-view planner learnt a new capacity (#85, #126) | - -### Pitfalls - -- Do not restart with `am force-stop` + `am start`: the TV launcher grabs focus about 1 s later. Use Home → back. -- Count `FATAL EXCEPTION` only; plain `AndroidRuntime` lines come from the `input` / `am` shell commands. -- Mask the camera password in every log you post (the `mask` function in the smoke script). -- The XM camera serves one RTSP client at a time: a session that is not torn down blocks the next connection. -- Switching multi-view ↔ single view can freeze the window for 3–68 s on the AG-216 (#76, open): `Davey! … QueueBufferDuration=…` in logcat, sometimes an ANR. After many switches `media.codec` once hung in `D` state (load ~70) — reboot the box (`adb reboot`, ~25 s). Avoid needless switches in tests; start the app straight into the wanted mode (a cold start with the share intent opens the single view). -- `/stats.json` `ui_thread: not responding within 1000 ms` means the UI thread is stuck — usually #76. diff --git a/README.md b/README.md index 9fa37924..45111d09 100644 --- a/README.md +++ b/README.md @@ -111,7 +111,6 @@ Every item, the remote, sharing a URL from another app and **Reset**: [Usage](do | [Security](docs/security.md) | credential store, debug server (LAN only), log redaction, no encryption on the network | | [Devices](docs/devices.md) | verified and not working devices, hardware decoder notes, device and camera reports | | [Drones and Wi‑Fi toys](docs/toys.md) | how toys stream, FLOW-UFO (in testing), what to try with an unknown toy, what to send | -| [Laboratory](LABORATORY.md) | the test bench: devices, cameras, access, methods | The change history is the [merged pull requests](https://github.com/OpenIPC/decoder/pulls?q=is%3Apr+is%3Amerged+base%3Av2) and the [commits of v2](https://github.com/OpenIPC/decoder/commits/v2). diff --git a/README.ru.md b/README.ru.md index e4ed5954..54f41a82 100644 --- a/README.ru.md +++ b/README.ru.md @@ -113,7 +113,6 @@ | [Security](docs/security.md) | хранилище учётных данных, отладочный сервер (только локальная сеть), скрытие паролей в логах, отсутствие шифрования в сети | | [Devices](docs/devices.md) | проверенные и неработающие устройства, особенности аппаратных декодеров, отчёты об устройствах и камерах | | [Drones and Wi‑Fi toys](docs/toys.md) | как передают видео игрушки, FLOW-UFO (в тестировании), что попробовать с неизвестной игрушкой, что прислать | -| [Laboratory](LABORATORY.md) | тестовый стенд: устройства, камеры, доступ, методики | История изменений — это [принятые pull request'ы](https://github.com/OpenIPC/decoder/pulls?q=is%3Apr+is%3Amerged+base%3Av2) и [коммиты ветки v2](https://github.com/OpenIPC/decoder/commits/v2). diff --git a/README.zh-CN.md b/README.zh-CN.md index adde3275..1fea1b09 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -113,7 +113,6 @@ | [Security](docs/security.md) | 凭据存储、调试服务器（仅限局域网）、日志脱敏、网络传输未加密 | | [Devices](docs/devices.md) | 已验证和无法使用的设备、硬件解码器说明、设备与摄像机报告 | | [Drones and Wi‑Fi toys](docs/toys.md) | 玩具如何传输视频、FLOW-UFO（测试中）、遇到未知玩具时可以尝试什么、需要提交哪些信息 | -| [Laboratory](LABORATORY.md) | 测试平台：设备、摄像机、访问方式、测试方法 | 更新历史即[已合并的 pull request](https://github.com/OpenIPC/decoder/pulls?q=is%3Apr+is%3Amerged+base%3Av2) 和 [v2 分支的提交](https://github.com/OpenIPC/decoder/commits/v2)。 diff --git a/docs/architecture.md b/docs/architecture.md index 0a25f96e..9300d32b 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -143,7 +143,6 @@ android/ Gradle project .github/ISSUE_TEMPLATE/ device and camera report forms docs/ these documents screenshots/ README pictures -LABORATORY.md the test bench ``` The legacy 1.0x version lives in the `basic` branch (single file, built as `decoder.apk`). diff --git a/docs/debug.md b/docs/debug.md index 7e4241d0..12470c0e 100644 --- a/docs/debug.md +++ b/docs/debug.md @@ -174,7 +174,7 @@ The FLOW-UFO test build ([toys.md](toys.md#flow-ufo)) adds a `flowufo` object pe ## Log -`http://:8085/log`: the last 500 lines of the app's own log (logcat in `threadtime` format; without the `READ_LOGS` permission logcat returns only the app's own lines), redacted as they come in. The same lines over adb: `adb logcat -s OpenIPCDecoder`. Lines worth knowing are listed in [LABORATORY.md](../LABORATORY.md#log-lines-logcat--s-openipcdecoder). +`http://:8085/log`: the last 500 lines of the app's own log (logcat in `threadtime` format; without the `READ_LOGS` permission logcat returns only the app's own lines), redacted as they come in. The same lines over adb: `adb logcat -s OpenIPCDecoder`. ## Save report diff --git a/docs/testing.md b/docs/testing.md index b4c2d67c..a7588da7 100644 --- a/docs/testing.md +++ b/docs/testing.md @@ -136,4 +136,4 @@ A release build needs a keystore at `android/key.jks` and `KEYSTORE_PASS`, `KEY_ ## Device tests -The bench (devices, cameras, addresses, adb access, scripts, log lines, pitfalls) is described in [LABORATORY.md](../LABORATORY.md). Test rounds run as GitHub issues that follow the structure of [#53](https://github.com/OpenIPC/decoder/issues/53). Reports from users: [devices.md](devices.md#reporting). +Test rounds run as GitHub issues that follow the structure of [#53](https://github.com/OpenIPC/decoder/issues/53). Reports from users: [devices.md](devices.md#reporting). diff --git a/docs/transports.md b/docs/transports.md index 5bc7c690..7d0345b2 100644 --- a/docs/transports.md +++ b/docs/transports.md @@ -121,7 +121,7 @@ Not supported: G.726, MP4A-LATM with in-band configuration (`cpresent=1`) ([#14] ## What the servers support -Measured on the lab cameras; details and dates in [LABORATORY.md](../LABORATORY.md#what-the-servers-support). +Measured on the lab cameras. | Feature | OpenIPC Majestic | XM (`H264DVR 1.0`) | |---|---|---|