Diferencia entre revisiones de «tone()»
De ArduWiki
(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/ | + | * [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
Contenido
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).
