Guia de Referencia Arduino

REFERENCIAS ARDUINO

FUNCIONES:

• Digital I/O

digitalRead() : Lee el valor de un pin digital especificado, ya sea HIGH o LOW.

digitalWrite() : Escribe un valor HIGH o LOW a un pin digital.

Si el pin ha sido configurado como OUTPUT con pinMode(), su voltaje se ajustará al valor correspondiente: 5V (o 3.3V en placas de 3.3V) para HIGH, 0V (tierra) para LOW.

Si el pin está configurado como INPUT, digitalWrite() habilitará (HIGH) o deshabilitará (LOW) el pullup interno del pin de entrada. Se recomienda establecer el pinMode() a INPUT_PULLUP para habilitar la resistencia interna de pull-up. Vea el tutorial de Pines Digitales para más información.

Si no establece el pinMode() a OUTPUT, y conecta un LED a un pin, al llamar a digitalWrite(HIGH), el LED puede aparecer atenuado. Sin establecer explícitamente pinMode(), digitalWrite() habrá habilitado la resistencia interna de pull-up, que actúa como una gran resistencia limitadora de corriente.

pinmode(): Configura el pin especificado para que se comporte como una entrada o una salida. Consulte la página de Pines Digitales para obtener detalles sobre la funcionalidad de los pines.

A partir de Arduino 1.0.1, es posible habilitar las resistencias pullup internas con el modo INPUT_PULLUP. Además, el modo INPUT deshabilita explícitamente los pullups internos.

• Analog I/O

analogRead(): Reads the value from the specified analog pin. Arduino boards contain a multichannel, 10-bit analog to digital converter. This means that it will map input voltages between 0 and the operating voltage(5V or 3.3V) into integer values between 0 and 1023. On an Arduino UNO, for example, this yields a resolution between readings of: 5 volts / 1024 units or, 0.0049 volts (4.9 mV) per unit.

analogReference():Configura la tensión de referencia utilizada para la entrada analógica (es decir, el valor utilizado como tope del rango de entrada

analogWrite(): Escribe un valor analógico (onda PWM) en un pin. Se puede utilizar para encender un LED con diferentes brillos o para accionar un motor a varias velocidades.

• Zero, Due & MKR Family

analogReadResolution() : analogReadResolution() es una extensión de la API analógica para la familia Zero, Due, MKR, Nano 33 (BLE e IoT) y Portenta.

Establece el tamaño (en bits) del valor devuelto por analogRead(). Por defecto es de 10 bits (devuelve valores entre 0-1023) para la compatibilidad con placas basadas en AVR.

analogWriteResolution() :  es una extensión de la API analógica para el Arduino Due.

analogWriteResolution() establece la resolución de la función analogWrite(). Por defecto es de 8 bits (valores entre 0-255) para la compatibilidad con placas basadas en AVR.

• Advanced I/O

 noTone(): Detiene la generación de una onda cuadrada disparada por tone(). No tiene efecto si no se está generando ningún tono.

pulseIn(): Lee un pulso (ya sea HIGH o LOW) en un pin. Por ejemplo, si el valor es ALTO, pulseIn() espera a que el pin pase de BAJO a ALTO, inicia la temporización, luego espera a que el pin pase a BAJO y detiene la temporización. Devuelve la longitud del pulso en microsegundos o se rinde y devuelve 0 si no se recibió ningún pulso completo dentro del tiempo de espera.

pulseInLong(): pulseInLong() es una alternativa a pulseIn() que es mejor para manejar los escenarios afectados por pulsos largos e interrupciones.

shiftIn(): Desplaza un byte de datos un bit a la vez. Comienza por el bit más significativo (es decir, el más a la izquierda) o el menos significativo (el más a la derecha). Para cada bit, el pin del reloj se pone en alto, el siguiente bit se lee de la línea de datos, y entonces el pin del reloj se pone en bajo.

Si estás interactuando con un dispositivo que se sincroniza por flancos ascendentes, tendrás que asegurarte de que el pin de reloj está bajo antes de la primera llamada a shiftIn(), por ejemplo, con una llamada a digitalWrite(clockPin, LOW).

Nota: esta es una implementación de software; Arduino también proporciona una biblioteca SPI que utiliza la implementación de hardware, que es más rápida pero sólo funciona en pines específicos.

shiftOut(): Desplaza un byte de datos un bit cada vez. Comienza por el bit más significativo (es decir, el más a la izquierda) o el menos significativo (el más a la derecha). Cada bit se escribe a su vez en un pin de datos, después de lo cual se pulsa un pin de reloj (se toma alto, luego bajo) para indicar que el bit está disponible.

Nota: si estás interactuando con un dispositivo que se sincroniza por flancos ascendentes, tendrás que asegurarte de que el pin de reloj está bajo antes de la llamada a shiftOut(), por ejemplo, con una llamada a digitalWrite(clockPin, LOW).

Esta es una implementación de software; vea también la biblioteca SPI, que proporciona una implementación de hardware que es más rápida pero que sólo funciona en pines específicos.

tone(): Genera una onda cuadrada de la frecuencia especificada (y un ciclo de trabajo del 50%) en un pin. Se puede especificar una duración, de lo contrario la onda continúa hasta una llamada a noTone(). El pin puede conectarse a un zumbador piezoeléctrico u otro altavoz para reproducir tonos.

• Time

delay(): Pone en pausa el programa durante el tiempo (en milisegundos) especificado como parámetro. (Hay 1000 milisegundos en un segundo).

delayMicroseconds(): Pone en pausa el programa durante el tiempo (en microsegundos) especificado por el parámetro. Hay mil microsegundos en un milisegundo y un millón de microsegundos en un segundo.

micros(): Devuelve el número de microsegundos desde que la placa Arduino comenzó a ejecutar el programa actual.

millis(): Devuelve el número de milisegundos transcurridos desde que la placa Arduino comenzó a ejecutar el programa actual. Este número se desbordará (volverá a cero), después de aproximadamente 50 días.

• Math

abs(): Calcula el valor absoluto de un número

constrain(): Restringe un número para que esté dentro de un rango.

map(): Reasigna un número de un rango a otro. Es decir, un valor de fromLow se mapearía a toLow, un valor de fromHigh a toHigh, valores intermedios a valores intermedios, etc.

max(): Calcula el máximo de dos números

min(): Calcula el mínimo de dos números

...