Diferencia entre revisiones de «tone()»

De ArduWiki
Saltar a: navegación, buscar
(Página creada con «== Descripción == == Sintaxis == <pre> </pre> == Parámetros == == Retornos == == Advertencias == == Ejemplo == <pre> </pre> == Vea también == == Referencias == *...»)
 
Línea 1: Línea 1:
 
== Descripción ==
 
== Descripción ==
 +
Genera en un pin una onda cuadrada de la  frecuencia especificada (y ciclo de trabajo del 50%). Se puede especificar una duración, de lo contrario la onda continúa hasta una llamada a noTone().
 +
 +
El pin puede ser conectado a un zumbador piezoeléctrico o a un altavoz para reproducir tonos.
 +
 +
Sólo un tono puede ser generado a la vez. Si un tono ya se está reproduciendo en un pin diferente, la llamada a tono() no tendrá ningún efecto. Si el tono se está reproduciendo en el mismo pin, la llamada ajustará su frecuencia.
 +
 +
{| class="wikitable col2cen col3cen"
 +
|+
 +
|-
 +
! Placa !! Frecuencia Mín. (Hz) !! Frecuencia Máx (Hz)
 +
|-
 +
| Uno, Mega, Leonardo y otras placas AVR || 31 || 65535
 +
|-
 +
| Zero || 41 || 275000
 +
|-
 +
| Gemma || No implementado || No implementado
 +
|-
 +
| Due || No implementado || No implementado
 +
|}
 +
 +
Para detalles técnicos ver las notas [https://code.google.com/p/rogue-code/wiki/ToneLibraryDocumentation#Ugly_Details Brett Hagman's].
 +
 +
{{Nota|Si desea reproducir tonos diferentes en varios pines, es necesario llamar [[noTone()]] en un pin antes de llamar a tone() en el siguiente pin.}}
  
 
== Sintaxis ==
 
== Sintaxis ==
 
<pre>
 
<pre>
 +
tone(pin, frecuencia);
 +
tone(pin, frecuencia, duracion);
 
</pre>
 
</pre>
  
 
== Parámetros ==
 
== Parámetros ==
 +
;pin: el pin en el que se quiere generar el tono
 +
;frecuencia: la frecuencia del tono en hertz - [[unsigned int]]
 +
;duracion: la duración del tono en milisegundos (opcional) - [[unsigned long]]
  
 
== Retornos ==
 
== Retornos ==
 +
Nada.
  
 
== Advertencias ==
 
== Advertencias ==
 +
* El uso de la función '''tone()''' interferirá con la salida PWM en los pines 3 y 11 (en placas distintas de la [[MEGA]]).
  
 
== Ejemplo ==
 
== Ejemplo ==
Línea 16: Línea 46:
  
 
== Vea también ==
 
== Vea también ==
 +
* [[noTone()]]
  
 
== Referencias ==
 
== Referencias ==
* [https://www.arduino.cc/reference/es/language/functions/time/millis/ Guia de referencia de Arduino]
+
* [https://www.arduino.cc/reference/es/language/functions/time/tone/ Guia de referencia de Arduino]
  
  
 
[[Category:Funciones]]
 
[[Category:Funciones]]

Revisión del 03:18 16 jun 2018

Descripción

Genera en un pin una onda cuadrada de la frecuencia especificada (y ciclo de trabajo del 50%). Se puede especificar una duración, de lo contrario la onda continúa hasta una llamada a noTone().

El pin puede ser conectado a un zumbador piezoeléctrico o a un altavoz para reproducir tonos.

Sólo un tono puede ser generado a la vez. Si un tono ya se está reproduciendo en un pin diferente, la llamada a tono() no tendrá ningún efecto. Si el tono se está reproduciendo en el mismo pin, la llamada ajustará su frecuencia.

Placa Frecuencia Mín. (Hz) Frecuencia Máx (Hz)
Uno, Mega, Leonardo y otras placas AVR 31 65535
Zero 41 275000
Gemma No implementado No implementado
Due No implementado No implementado

Para detalles técnicos ver las notas Brett Hagman's.

Nota: Si desea reproducir tonos diferentes en varios pines, es necesario llamar noTone() en un pin antes de llamar a tone() en el siguiente pin.


Sintaxis

tone(pin, frecuencia);
tone(pin, frecuencia, duracion);

Parámetros

pin
el pin en el que se quiere generar el tono
frecuencia
la frecuencia del tono en hertz - unsigned int
duracion
la duración del tono en milisegundos (opcional) - unsigned long

Retornos

Nada.

Advertencias

  • El uso de la función tone() interferirá con la salida PWM en los pines 3 y 11 (en placas distintas de la MEGA).

Ejemplo


Vea también

Referencias