frvn componentes

frvn componentes es la API de alto nivel del protocolo frvn. Trabajas con objetos que representan piezas de hardware (un LED, un botón, un servo) y tienen métodos y eventos claros. Es la forma más rápida de programar un thing.

Todos los componentes se crean con new five.<Componente>(pin) y quedan enlazados a la placa de este thing automáticamente.

LED

const led = new five.Led(13);

led.on();          // encender
led.off();         // apagar
led.toggle();      // alternar
led.blink(500);    // parpadear cada 500 ms
led.pulse(1000);   // latido suave (pin PWM)
led.brightness(128); // 0–255 (pin PWM)

Botón

const boton = new five.Button(2);

boton.on("down", () => {
  varG.presionado = true;
});

boton.on("up", () => {
  varG.presionado = false;
});

Sensor (entrada analógica)

const sensor = new five.Sensor("A0");

// "change": solo cuando el valor cambia
sensor.on("change", () => {
  varG.lectura = sensor.value;          // 0–1023 crudo
  varG.escalado = sensor.scaleTo(0, 100); // re-mapeado a 0–100
});

// "data": de forma periódica (útil para muestrear)
sensor.on("data", () => {
  pushData("lecturas", sensor.value);
});

Servo

const servo = new five.Servo(9);

servo.to(90);    // ir a 90°
servo.sweep();   // barrer de extremo a extremo
servo.stop();

Relé

const rele = new five.Relay(8);

rele.on();
rele.off();
rele.toggle();

Limitaciones

Algunas piezas del catálogo no están disponibles en la plataforma:

• Motores paso a paso (five.Stepper): no disponible.
• Sensor de ultrasonido HC‑SR04 (five.Proximity): no disponible.
• Varias placas a la vez: no aplica — recuerda que un thing es una placa.
• Sensores DHT (temperatura/humedad): no uses un componente; léelos con frvn directo mediante board.dhtRead(...).

Cuándo bajar a frvn directo

Si necesitas un pin o protocolo que no tiene componente, o quieres control fino, usa frvn directo. Puedes mezclar ambos estilos en el mismo boardCode.