# android-fs5

CLI toolset for managing the **exone GmbH FS5** Android 9 device via ADB.

## Device

| Property | Value |
|----------|-------|
| Model | exone GmbH FS5 |
| Serial | RD51QE202392 |
| Android | 9 |
| Storage | ~52 GB |

## Requirements

| Tool | Version | Install |
|------|---------|---------|
| adb | 1.0.41+ | `sudo pacman -S android-tools` |
| bash | 5.x | pre-installed |
| python3 | 3.x | pre-installed |

## Setup

```bash
cp .env.example .env
# Edit .env if your device serial differs
chmod +x fs5
```

## Usage

```text
Usage: fs5 <command> [options]

Commands:
  status              Show device health and info
  push <src> <dst>    Push file/dir to device
  pull <src> <dst>    Pull file/dir from device
  app list            List installed apps
  app install <apk>   Install APK on device
  app uninstall <pkg> Uninstall package (requires --force)
  shell [cmd]         Execute shell command on device
  logs                Stream or capture logcat output

Global Options:
  --json              Output as JSON
  --force             Allow destructive/overwrite operations
  --help              Show help
```

## Examples

```bash
# Device health check
./fs5 status
./fs5 status --json | python3 -m json.tool

# File transfer
./fs5 push ./report.pdf /sdcard/Documents/report.pdf
./fs5 pull /sdcard/DCIM/photo.jpg ./photo.jpg
./fs5 push ./file.txt /sdcard/file.txt --force   # overwrite

# App management
./fs5 app list
./fs5 app list --all --json
./fs5 app install ./myapp.apk
./fs5 app uninstall com.example.app --force

# Shell access
./fs5 shell "df -h"
./fs5 shell "pm list packages | grep google"

# Log capture
./fs5 logs --lines 50
./fs5 logs --filter ActivityManager
./fs5 logs --lines 100 --output /tmp/device.log
```

## Exit Codes

| Code | Meaning |
|------|---------|
| 0 | Success |
| 1 | General error |
| 2 | Device not found |

## Configuration (`.env`)

```bash
DEVICE_SERIAL=RD51QE202392   # ADB device serial
LOG_FILE=./fs5.log            # Operation log path
DEFAULT_PUSH_PATH=/sdcard/    # Default push destination
ADB_TIMEOUT=10                # ADB timeout in seconds
```

## Testing

```bash
# Install test dependencies (once)
sudo pacman -S bats bats-assert bats-support shellcheck

# Run all tests
bats tests/

# Run specific test file
bats tests/test_status.bats

# Lint
shellcheck fs5 lib/adb.sh lib/output.sh
```

## Operation Log

All mutating operations (push, pull, install, uninstall) are logged to `fs5.log`:

```text
2026-03-02T15:43:00+01:00 PUSH /home/ja/file.txt -> /sdcard/file.txt [OK]
2026-03-02T15:44:00+01:00 INSTALL /tmp/app.apk [OK]
```

## Project Structure

```text
android-fs5/
├── fs5                 # Main CLI entrypoint
├── lib/
│   ├── adb.sh          # ADB wrapper functions
│   └── output.sh       # Output formatting (human + JSON)
├── tests/
│   ├── test_status.bats
│   ├── test_transfer.bats
│   ├── test_app.bats
│   ├── test_shell.bats
│   └── test_logs.bats
├── specs/              # Spec-Driven Development artifacts
├── .env.example        # Config template
└── README.md
```