pitec

pitec

TUI multiplataforma para descargar el historial de cámaras de cultivo PITEC BIOREF-19 L por Bluetooth.

Un solo binario, sin dependencias de runtime ni cgo. El asistente sigue el flujo de trabajo de campo de principio a fin:

 📡 escanear Bluetooth  →  ☑ seleccionar PiTecs  →  🔑 parear (PIN 1010)  →  📥 descargar  →  📄 CSV

PITEC BIOREF-19 L — Descarga de datos
Paso 1/3 · Escaneo Bluetooth

[x] Pitec 6838               54:B7:E5:78:EE:D3
[x] Pitec 6856               54:B7:E5:78:EF:D9
[x] Pitec 6918               54:B7:E5:78:EE:57  pareado
[x] Pitec 7036               54:B7:E5:78:EC:32
[ ] WH-CH720N                A8:E6:E8:67:4D:EB  pareado

Carpeta salida: ~/Documents/PITEC
Dirección:      4

↑↓ mover · espacio marcar · a todos los PiTec · enter descargar · r reescanear · q salir

✨ Características

• 🔍 Escaneo Bluetooth con detección automática de equipos PiTec (preseleccionados).
• 🔑 Pareo sin intervención — responde solo la clave 1010 en los tres sistemas.
• 📥 Descarga por lotes: marca varios equipos y el asistente los procesa en serie con progreso en vivo.
• 📄 Un CSV por equipo en ~/Documents/PITEC (fecha, 8 canales en °C y banderas de alarma).
• 🖥️ Multiplataforma real: BlueZ/D-Bus + RFCOMM nativo en Linux, blueutil en macOS, API Win32 en Windows.
• 🤖 Modo headless (pitec download) para scripts y tareas programadas.

🚀 Uso

pitec                    # asistente interactivo (recomendado)
pitec scan               # solo escanear y listar equipos
pitec download           # pipeline completo sin interfaz
pitec download -out /ruta/personalizada
pitec -addr 7 download   # si el equipo no usa la dirección de bus 4

Teclas del asistente: ↑↓ moverse · espacio marcar · a todos los PiTec · enter descargar · r reescanear · o abrir carpeta de salida · q salir.

📦 Instalación

Descarga el binario de tu sistema desde Releases, o compila desde el código:

go install github.com/BIOLIMON/pitec/cmd/pitec@latest

Requisitos por sistema

🔧 Comandos avanzados (puerto serie directo)

pitec ports                                   # listar puertos serie
pitec -port /dev/cu.Pitec6918 monitor         # valores actuales en vivo
pitec -port COM5 -addr 4 history -out d.csv   # descarga por puerto explícito

Si el módulo Bluetooth del equipo no usa el canal RFCOMM 1 (solo Linux): PITEC_RFCOMM_CHANNEL=2 pitec download.

🧬 Protocolo

Las cámaras hablan un protocolo serie propio (9600 baud 8N1) sobre Bluetooth SPP: tramas ASCII de 77 caracteres con índice hex, timestamp, 8 canales con bandera de alarma y checksum. El parser está aislado en internal/protocol (puro, sin I/O, con tests) y la capa Bluetooth por plataforma en internal/bt. Detalles en CLAUDE.md.

🛠️ Desarrollo

go test ./...        # tests (parser de protocolo)
go vet ./...
go build -o pitec ./cmd/pitec/

# compilación cruzada, sin cgo
GOOS=linux   GOARCH=amd64 go build -o dist/pitec-linux ./cmd/pitec/
GOOS=windows GOARCH=amd64 go build -o dist/pitec.exe   ./cmd/pitec/
GOOS=darwin  GOARCH=arm64 go build -o dist/pitec-mac   ./cmd/pitec/

📄 Licencia

MIT