s2aio V: 1.

5
Extensión de la Tarjeta Arduino para Snap! y Scratch 2.0
versión offline
Creada por

Alan Yorinks

Traducción y Adaptación al Español

Prof. José Manuel Ruiz Gutiérrez

1
 s2aio
Extensión de la Tarjeta Arduino para Snap! y Scratch 2.0
versión offline

Índice
1. Introducción
2. Instalación de Python 3.5
3. Instalación del IDE Arduino
4. Instalar Scratch version off line
5. Instalar s2aio
6. Ejecución personalizada de s2aio para Scratch
7. Ejecución personalizada de s2aio para Snap!
8. Bloque de Programación de s2aio
8.1. Configuración de PIN analógico
8.2. Configuración d PIN Digital
8.3. Escribir Analógico (PWM)
8.4. Escribir Digital
8.5. Tono
8.6. No Tono
8.7. Servo
8.8. Leer Analógico
8.9. Leer Digital
8.10. Depurar
9. Blink
10. Usando un componente tipo Ultrasonido

Nota: Este manual es una traducción y adaptación al español de la documentación

publicada por Alan Yorinks, creador de la librería en la Wiki de Github. La librería se
puede descargar en este enlace

Copyright (C) 2015, Alan Yorinks, All rights reserved.

26 de Noviembre de 2015 José Manuel Ruiz Gutiérrez

2
1. Introducción
El objetivo de esta aplicación es programar, controlar y monitorizar una tarjeta Arduino
utilizando Scratch o Snap! mediante lenguajes de programación visuales sin tener que
aprender C ++.

La plicación facilita la programación de aplicaciones que "dialoguen" con la tarjeta

Arduino facilitando el intercambio de datos en los dos sentido de flujo entrada/salida.

La posibilidad de trabajar con librerías añadidas a la conocida aplicación Scrtach 2.0 y

también a la aplicación igualmante publica Snap! hace que esta herramienta sea muy
interesante para quienes desean experimentar con Arduino.

Se incluyen con s2aio bloques programados para los siguientes idiomas:

 1 = English (EN)
 2 = Chinese (zh-CN)
 3 = Chinese (zh-TW)
 4= Dutch(NL)
 5 = French(FR)
 6 = German(DE)
 7= Greek(GR)
 8 = Korean(KO)
 9 = Italian(IT)
 10 = Portuguese(PT)
 11 = Spanish(ES)

Características

• Escrito en Python usando el nuevo Python 3.5 y la librería asyncio.

• Funciona en varias plataformas con Windows, Mac y Linux.
• Fácil de instalar.
• Fácil de usar.

3
2. Instalación de Python 3.5
Para instalar Python 3.5, vaya a la página Pagina Principal de Python, y descargue la
distribución 3.5 para su sistema operativo.

Si usted tiene Python 2.7 instalado, no es necesario quitarlo.

Debe utilizar Python 3.5 para que funcione s2aio

Durante el proceso de instalación, hay una opción para añadir Python 3.5 a su ruta,
asegúrese de que se comprueba antes de proceder con la instalación.

Después de la instalación, abra una ventana de comandos y escriba: python -v. Usted
debe ver Python 3.5.0 o algo similar.

4
3. Instalación del IDE Arduino
Instale la última versión del IDE de Arduino desde la página de descarga de Arduino.

Durante la instalación, se le pedirá para cargar un controlador para USB/Comunicación

serie. Por favor, instale el controlador.

Después de la instalación, conecte el Arduino al ordenador con el cable USB.

Abra el IDE y en el menú Herramientas, seleccione el tipo de tarjeta y el puerto al que

está conectada.

A continuación, desde el menú Fichero/Ejemplos/01.Basics seleccione el sketch Blink

y descárguelo en Arduino para comprobar que puede comunicarse con Arduino.

Para los usuarios de Linux, si usted está teniendo problemas para cargar el boceto,
puede que tenga que agregarse al grupo dialout. Para ello, abra una ventana de terminal
y escriba:

sudo usermod -a -G dialout YOUR_USER_NAME

Salga de linux y vuelva a entrar, a continuación, abra el IDE y compruebe que puede
cargar el sketch Blink.

Una vez que esta operación se realizó con éxito está en disposición de poder descargar
sobre Arduino el StandardFirmata (suministrado con el Arduino IDE) o FirmataPlus.
Las instrucciones para cargar FirmataPlus se pueden encontrar aquí. Para utilizar Para
trabajar con los bloques de control configurados para SONAR o TONO con s2aio, es
preciso cargar FirmataPlus en Arduino.

5
4. Instalar el Editor Scratch versión
offline
Para los usuario de Windows y Mac, vaya a la página de descarga Scratch, y siga las
instrucciones de instalación de su sistema operativo.

Para los usuarios de Linux, las instrucciones de la página de descarga de Scratch son
incorrectos. Ir a este enlace y seguir las instrucciones. Las instrucciones mencionan que
tienes que ir otra página para 64 bits de Linux, pero el uso de Ubuntu, me pareció que
las instrucciones sean correctas para ambas versiones de 32 y 64 bits.

Durante la instalación, acepte la ubicación de instalación por defecto.

6
5. Instalar s2aio
Asegúrese de que usted tiene una conexión a Internet.

Para los usuarios de Windows, abra una ventana de comandos y escriba:

pip install s2aio

Para los usuarios de Linux, abra una ventana de terminal y escriba:

sudo pip3 install s2aio

Este comando instalará s2aio y todas sus librerías necesarias. Un archivo ejecutable se
instalará en la ruta de ejecución para facilitar el arranque.

Para Arrancar el programa para Scratch:

Conectar Arduino al Ordenador y escribir en la ventana de comandos:

s2aio

o ejecutar el fichero s2aio.exe que se encuentra en:

C:\Users\....\AppData\Local\Programs\Python\Python35\Scripts\s2aio.exe

¿Como desinstalar la librería?

En Windows escribir este comando en la ventana de comandos de Windows:

pip uninstall s2aio

o en Linux:

sudo pip3 uninstall s2aio

7
Ejecución de s2aio
La ejecución de s2aio acepta los siguientes comandos o parámetros:

uso: s2aio [-h] [-c CLIENT] [-l LANGUAGE] [-p COMPORT] [-b BASE_PATH] [-v]

Argumentos opcionales:

-h, --help muestra un mensaje de ayuda y se cierra

-c CLIENT por defecto = scratch [scratch | snap | no_client]
-l LANGUAGE 1=English(default) 2=Chinese(zh-CN) 3=Chinese(zh-
TW)4=Dutch(NL) 5=French(FR) 6=German(DE) 7=Greek(GR)
8=Korean(KO)9=Italian(IT) 10=Portuguese(PT) 11=Spanish(ES)
-p COMPORT Puerto COM de conexión de Arduino - e.g. /dev/ttyACMO o
COM3
-b BASE_PATH Python File Path - e.g. /usr/local/lib/python3.5/dist-
packages/s2aio

-v Print version and Python path

NOTA IMPORTANTE: La opción de languaje está solo disponible para usar con
Scratch.

8
6. Ejecución y personalización de 2aio
para Scratch
Arrancando s2aio
A partir de la ventana de comandos o el terminal DOS de Windows , simplemente
escriba: s2aio

Esto iniciará Scratch y los bloques de programación predeterminada de idioma Inglés

se instalará en él la pestaña Más Bloques del editor de Scratch.

Opciones de "línea de comando"

Puede cambiar el comportamiento de s2aio en el arranque mediante el uso de sus
opciones de línea de comandos:

uso: s2aio [-h] [-c CLIENT] [-l LANGUAGE] [-p COMPORT] [-b BASE_PATH] [-v]

Argumentos opcionales:

-h, --help muestra un mensaje de ayuda y se cierra

-c CLIENT por defecto = scratch [scratch | snap | no_client]
-l LANGUAGE 1=English(default) 2=Chinese(zh-CN) 3=Chinese(zh-
TW)4=Dutch(NL) 5=French(FR) 6=German(DE) 7=Greek(GR)
8=Korean(KO)9=Italian(IT) 10=Portuguese(PT) 11=Spanish(ES)
-p COMPORT Puerto COM de conexión de Arduino - e.g. /dev/ttyACMO o
COM3
-b BASE_PATH Python File Path - e.g. /usr/local/lib/python3.5/dist-
packages/s2aio

-v Print version and Python path

OPCIÓN CLIENTE

El cliente predeterminado es Scratch. Si desea lanzar Snap! en su navegador de

Internet, utilice la opción -c snap. Si desea iniciar un cliente de forma manual,
seleccione la opción -c no_client.

Nota: La opción de cliente de Scratch detectará automáticamente cuando el editor de

Scratch está cerrado. Al cabo de 2 segundos, s2aio cerrará también. Si selecciona
no_client, esta función está desactivada.

9
OPCIÓN LENGUAJE

De forma predeterminada, Scratch se inicia utilizando para los bloques de programación

el idioma Inglés. Para inicializar Scratch con un idioma diferente, utilice la opción de
idioma. Seleccione el identificador de idioma de las opciones que se muestran arriba.

Así, por ejemplo, si desea comenzar de cero con los bloques de programación para la
lengua española, empezaría s2aio con:

s2aio -l 11

Tenga en cuenta que la opción es la letra 'l' (ele) y no el número 1.

Si desea modificar el idioma por defecto a algo distinto de Inglés, por favor consulte la
sección "Comportamiento de inicio Personalización s2aio"

OPCIÓN DE PUERTO COM

El programa detectará automáticamente el puerto COM en el que está conectado

Arduino. Si desea establecer explícitamente el PUERTO COM PORT, utilice esta
opción. Así, por ejemplo, para iniciar s2aio para COM23, escribiría:

s2aio -p COM23

OPCIÓN BASE_PATH

El programa determina automáticamente donde se instalaron los archivos de la librería

s2aio durante la instalación pip. Si desea cambiar explícitamente la ruta de acceso a
estos archivos, puede utilizar esta opción. Ejemplo:

s2aio -b /usr/local/lib/python3.5/dist-packages/s2aio

OPCIÓN VERSIÓN

La opción -v imprimirá tanto el número de versión de s2aio como la ruta de Python

para los archivos de la biblioteca s2aio.

~$ s2aio -v

s2aio version 1.4 - 16 Nov 2015

Python path = /usr/local/lib/python3.5/dist-packages/s2aio

Personalizar en el arranque el comportamiento de

s2aio
La librería s2aio contiene un fichero llamada configuration.cfg que se encuentra en el
directorio de configuración de la librería. Mediante la ruta mostrada anteriormente, el
archivo de configuración se encuentra en el directorio

10
C:\Users\xxxx\AppData\Local\Programs\Python\Python35\Lib\site-
packages\s2aio\configuration

El path para su sistema puede ser diferente. Utilice la opción -v para determinar el
patch.

Antes de hacer cualquier cambio en este fichero, se sugiere encarecidamente que haga
una copia de seguridad del archivo.

Cambiando el lenguaje por defecto en el arranque

Para cambiar el idioma de inicio predeterminada del Inglés, cambie:

scratch_language = 1

Para cambiar el lenguaje de Scrtach = LANGUAGE OF YOUR CHOICE

Así por ejemplo, si desea que el idioma por defecto para ser edición española de esta
línea para que diga:

scratch_language = 11

11
7. Ejecución y personalización de s2aio
para Snap!
Inicio de s2aio
A partir de la ventana de comandos de Windows o la ventana terminal DOS ,
simplemente escriba:

s2aio

Esto iniciará Snap! cargandolo en el navegador de la URL de Internet.

Para importar un proyecto Snap! específico para el idioma deseado, en un tipo de

terminal o ventana de comandos:

s2aio -v

Mediante la ruta Python devuelta, los archivos Snap! de proyecto se encuentran en el

directorio de Snap! Archivos. Para ir a ese directorio, escriba:

cd Snap *

para evitar tener que escapar de la! en el nombre.

Opciones de "línea de comando"

Puede cambiar el comportamiento de s2aio en el arranque mediante el uso de sus
opciones de línea de comandos:

uso: s2aio [-h] [-c CLIENT] [-l LANGUAGE] [-p COMPORT] [-b BASE_PATH] [-v]

Argumentos opcionales:

-h, --help muestra un mensaje de ayuda y se cierra

-c CLIENT por defecto = scratch [scratch | snap | no_client]
-l LANGUAGE 1=English(default) 2=Chinese(zh-CN) 3=Chinese(zh-
TW)4=Dutch(NL) 5=French(FR) 6=German(DE) 7=Greek(GR)
8=Korean(KO)9=Italian(IT) 10=Portuguese(PT) 11=Spanish(ES)
-p COMPORT Puerto COM de conexión de Arduino - e.g. /dev/ttyACMO o
COM3
-b BASE_PATH Python File Path - e.g. /usr/local/lib/python3.5/dist-
packages/s2aio

-v Print version and Python path

12
OPCION CLIENTE

El cliente predeterminado es Scratch. Si desea lanzar Snap! en su navegador de

Internet, utilice la opción -c snap. Si desea iniciar un cliente de forma manual,
seleccione la opción -c no_client.

Nota: La opción de cliente de Scratch detectará automáticamente cuando el editor de

Scratch está cerrado. Al cabo de 2 segundos, s2aio cerrará también. Si selecciona
no_client, esta función está desactivada.

OPCIÓN LENGUAJE

La opción de idioma sólo funciona cuando se utiliza Scratch. Bloques de idiomas para
Snap! debe ser cargado o importado manualmente.

OPCIÓN DE PUERTO COM

El programa detectará automáticamente el puerto COM en el que esta conectado

Arduino. Si desea establecer explícitamente el PUERTO COM PORT, utilice esta
opción. Así, por ejemplo, para iniciar s2aio para COM23, escribiría:

s2aio -p COM23

OPCIÓN BASE_PATH

El programa determina automáticamente donde se instalaron los archivos de la librería

s2aio durante la instalación pip. Si desea cambiar explícitamente la ruta de acceso a
estos archivos, puede utilizar esta opción. Ejemplo:

s2aio -b /usr/local/lib/python3.5/dist-packages/s2aio

OPCIÓN VERSIÓN

La opción -v imprimirá tanto el número de versión de s2aio como la ruta de Python

para los archivos de la biblioteca s2aio.

~$ s2aio -v

s2aio version 1.4 - 16 Nov 2015

Python path = /usr/local/lib/python3.5/dist-packages/s2aio

Personalizando el comportamiento de s2aio en el inicio

La librería s2aio contiene un fichero llamado configuration.cfg que se encuentra en el
directorio de configuración de la librería. Mediante la ruta mostrada anteriormente, el
archivo de configuración se encuentra en el directorio /usr/local/lib/python3.5/dist-
packages/s2aio/configuration. El path para su sistema puede ser diferente. Utilice la
opción -v para determinar la ruta.

13
Antes de hacer cualquier cambio a esta imagen, se sugiere encarecidamente que haga
una copia de seguridad del archivo.

Cambiando la URL de Snap!

Por defecto s2aio cargará http://snap.berkeley.edu/snapsource/snap.html.

Si desea cargar Snap! a partir de una copia local del editor, puede cambiar la dirección
URL predeterminada editando la opción snap_url en el archivo configuration.cfg.

14
8. Bloques de Programación de s2aio
s2aio suministra diez bloques de programación de usuario para Scratch y cada bloque
tiene su propia página de descripción detallada contenida en este documento.

Los bloques de Scratch están instalados en la pestaña Mas Bloques del editor de
Scratch.

El Snap! bloques están ubicados en diversas pestañas dentro del editor Snap!. La
ubicación se muestra en cada bloque especifico en las siguientes descripciones de cada
bloque.

 Configurar Pin Analógico

 Configurar Pin Digital
 Escribir Analógica (PWM)
 Escribir Digital
 Tono
 No Tono
 Servo
 Leer Analógica
 Leer Digital
 Depurar

8.1. Configurar Pin Analógico

Localización en Snap!: Librería Sensores.

Este bloque de comando configura un pin de entrada analógica (pines marcados con el
identificativo 'A' en la tarjeta de Arduino).

Ingrese el número de PIN sin la letra "A", por ejemplo para entrar pin A5, basta con
introducir 5.

15
La lista desplegable en la parte izquierda de este bloque le permite seleccionar si desea
o no refrescar los datos leidos del bloque analógico Read.

Si la opción Activar está seleccionada, las actualizaciones se procesan de forma

continua y se pueden leer desde Analog Read.

Si se selecciona la opcion Desactivado, el Bloque Leer Analogico mostrará el último

valor y no se actualizará a menos que se vuelve a habilitar para el PIN.

Para pines analógicos, a diferencia de los pines digitales, activar / desactivar es

específico para el PIN designado y no un grupo de pines. La activación o desactivación
sólo afecta al pin seleccionado y no otros.

Valores de Depuración

Valor Depuración Explicación

0 No Error

2-1 El numero de pin especificado no es un valor entero

2-2 El número de pin especificado no es un número valido para pin analógico

8.2. Configurar Pin Digital

Localización en Snap!: Librería Sensores.

Este bloque de comandos configura el modo de trabajo de un pin digital de entrada o de

salida digital.

16
Ingrese el número de PIN y haga clic en la lista desplegable en el lado derecho del
bloque para seleccionar el modo deseado.

Modo de Trabajo Tipo

Entrada Input

Salida Output

PWM Output

Servo Output

Tono Output

Sonar Input

Para utilizar las opciones de configuración de Tono o Sonar, se requiere cargar el

firmware FirmataPlus en la tarjeta Arduino. Las instrucciones para instalar lo las
encontraremos aquí..

En el lado derecho del bloque encontramos la lista desplegable con las opciones
Activar/Desactivar. Estos valores son efectivos sólo para los modos de trabajo tipo
entrada. Si está habilitado (por defecto), se comunicarán los cambios de datos para el
pin. Si está desactivada, el bloque Leer Digital no reportara cambios de estado.

Si el pin está configurado para la entrada de sonar, sus valores de datos se recuperan
utilizando el bloque Leer Digital.

NOTA IMPORTANTE: Los pines de Arduino se describen a nivel de hardware como

miembros de un grupo de puertos de 8 pines. Cómo activar o desactivar un pin de
entrada afectará a los ocho miembros del grupo de pines.

NOTA ESPECIAL: Configuración de tono y operación Servo puede interferir con la

operación PWM. Tono interferirá con salida PWM en los pines 3 y 11 (en las tarjetas
que no sean la Mega). En las tarjetas que no sean los Mega, configuración servo va a
interferir con la funcionalidad PWM en los pines 9 y 10. En los Mega, que puede
interferir con PWM en los pines 10 y 11.

Valores de Depuración

Valor Depuración Explicación

0 No Error

1-1 El pin especificado no es un valor entero

1-2 El numero de pin especificado esta fuera de

rango valido dentro de los pines de Arduino de

17
 Valor Depuración Explicación

la tarjeta en uso

El pin especificado no soporta modo de trabajo

1-3
tipo Entrada

El pin especificado no soporta modo de trabajo

1-4
tipo Salida

El pin especificado no soporta modo de trabajo

1-5
tipo PWM

El pin especificado no soporta modo de trabajo

1-6
Servo

El pin especificado no soporta modo de trabajo

1-7
Tono

El pin especificado no soporta modo de trabajo

1-8
Sonar

1-9 Desconocido el modo especificado

1-10 El modo seleccionado no soporta 'Disactivado'

18
8.3. Escribir Analógica (PWM)

Localización en Snap!: Librería Sensores.

Este bloque de comando configura un pin como salida PWM.

Ingrese el número de PIN y el valor de PWM en el rango de 0 a 255.

NOTA ESPECIAL: En la configuración de estos pines, puede afectar la configuración

de pines de tipo Tono o Servo con la configuracion PWM. Tono interferirá con salida
PWM en los pines 3 y 11 (en las placas que no sean la Mega). En las placas que no sean
los Mega, configuración servo va a interferir con la funcionalidad PWM en los pines 9 y
10. En los Mega, que puede interferir con PWM en los pines 10 y 11.

Valores de Depuración

Valor depuración Explicación

0 No Error

4-1 El pin especificado no es un valor entero

4-2 El numero de pin no es un numero valido

4-3 El Pin configurado no puede ser una salida PWM

El valor enviado al pin he PWM debe ser un valor

4-4
entero

El rango del valor enviado al Pin PWM debe estar

4-5
comprendido en el rango de 0-255

19
8.4. Escribir Valor Digital

Localización en Snap!: Librería Sensores.

This command block configures a pin for Digital output.

Enter the pin number and select either zero or one from the right hand side drop down
list.

Este bloque de comando configura un Pin como salida digital.

Ingrese el número de PIN y seleccione cero o uno en la lista desplegable de la parte

derecha.

Valores de Depuración

Valor depuración Explicación

0 No Error

3-1 El pin especificado no es un valor entero

3-2 El numero de pin no es un numero valido

20
8.5. Tono

Localización en Snap!: Librería Sonido.

This command block will play a tone at the frequency and duration specified.

Entering a duration of zero will leave the tone activated. Use the no tone command
block to deactivate.

You must configure the pin for tone operation by using the Digital Pin Configuration
Block before using this block.

Este bloque de comandos emitirá un tono de frecuencia y duración especificada.

Introduciendo una duración de cero dejará el tono activado. Utilice el comando NO

Tone para desactivar el tono.

Debe configurar el pin para la operación del tono utilizando el bloque de configuración
de pin "Configurar Pin Digital".

Valores de Depuración

Valor depuración Explicación

0 No Error

5-1 El pin especificado no es un valor entero

El Pin no ha sido configurado como tipo

5-3
Tono

5-4 La frecuencia se debe especificar con un

21
Valor depuración Explicación

numero entero

La duración se debe especificar como un

5-5
numero entero

22
8.6. No Tono

Localización en Snap!: Librería Sonido.

This command block will stop tone generation on the selected pin if a tone is currently
playing. It is normally used either if the Tone block was set with a duration of zero
(continuous tone) or the end of the program has been reached and tone needs to be
ended.

Este bloque de comandos detendrá la generación de tonos en el pin seleccionado si un

tono se está reproduciendo. Normalmente se utiliza ya sea si el bloque de tonos se fijó
con una duración de cero (tono continuo) o el final del programa si se ha alcanzado y el
tono necesita ser terminado.

Valores de Depuración

Valor depuración Explicación

0 No Error

6-1 El pin especificado no es un valor entero

6-2 El número de pin no es válido

El Pin no ha sido configurado como tipo

6-3
Tono

23
8.7. Servo

Localización en Snap!: Librería Movimiento.

Este bloque de comando configura la posición de un servo de motor entre 0 y 180

grados.

Ingrese el número de PIN y el ángulo de giro del servo.

Para utilizar este bloque, el pin debe haberse configurado para la operación servo
usando el bloque de "Configuración de Pin Digital.

Valores de Depuración

Valor depuración Explicación

0 No Error

7-1 El pin especificado no es un valor entero

7-2 El numero de pin no es un numero valido

7-3 El Pin no ha sido configurado como Servo

El valor del ángulo de posición debe ser un valor

7-4
entero

La posición de ángulo especificada debe estar en el

7-5
rango de 0-180

24
8.8. Leer Analógica

Localización en Snap!: Librería Sensores.

Este bloque reportera el valor analógico más reciente para el pin seleccionado. Su valor
es normalmente "asignado" a un bloque de datos para usarse y leerse en un bucle. Se
añada a veces un pequeño retardo en la lectura para reducir la carga de la CPU.

El valor de los datos también puede ser testeado usando un bloque condicional, por
ejemplo, If / Then.

Valores de Depuración

(Estos valores son reportados únicamente ara Snap - la validación de datos para este
bloque no es posible dentro de Scratch)

25
Valor depuración Explicación

0 No Error

9-1 El pin especificado no es un valor entero

9-2 El número de pin no es válido para un pin analógico

9-3 El Pin no ha sido configurado como entrada analógica

26
8.9. Leer Pin Digital

Localización en Snap!: Librería Sensores.

This reporter block will report the latest digital value for the selected pin. Its value is
normally "assigned" to a data block for use and read in a loop. A small delay is
sometimes added to the loop to lessen the burden on the CPU. .

If a pin has been configured for sonar operation, the latest sonar value is reported using
this block.

The data value may also be tested using a conditional block, e.g. If/Then.

27
Valores de Depuración
(Estos valores son reportados únicamente ara Snap - la validación de datos para este
bloque no es posible dentro de Scratch)

Valor depuración Explicación

0 No Error

8-1 El pin especificado no es un valor entero

8-2 El número de pin no es válido para un pin de entrada digital

8-3 El Pin no ha sido configurado como entrada digital

28
8.10. Depurar

Localización en Snap!: Librería Sensores.

Para Scratch
Este bloque reporta y muestra el último error aparecido por cualquiera de los bloques de
programación s2aio.

Hay una casilla pequeña al lado del bloque de depuración en la paleta de bloques.
Marque la casilla, y el valor depurador se mostrará en el escenario Scratch.

For Snap

Snap! no ofrece una casilla de verificación, por lo que el bloque puede ser
colocado en un bucle o prueba con bloque si/entonces el bloque si la
declaración de error.

Los códigos de error se muestran para cada bloque en sus páginas de descripción.

Una lista completa de los códigos de error se puede encontrar aquí.

29
Lista de errores:

DIGITAL PIN MODE BLOCK

1-1 Pin Must Be Specified as an Integer
1-2 Pin number exceeds the maximum number of pins for the arduino
1-3 Pin does not support digital input mode
1-4 Pin does not support digital output mode
1-5 Pin does support PWM mode
1-6 Pin does not support servo mode
1-7 Pin does not support tone mode
1-8 Pin does not support SONAR mode
1-9 Unknown Pin Mode specified
1-10 Pin must be input mode to be disabled
ANALOG PIN MODE BLOCK
2-1 Pin Must Be Specified as an Integer
2-2 Pin is not a valid analog pin
DIGITAL PIN WRITE
3-1 Pin Must Be Specified as an Integer
3-2 Pin number is invalid
3-3 Pin is not configured for digital output
ANALOG PIN WRITE
4-1 Pin Must Be Specified as an Integer
4-2 Pin number is invalid
4-3 Pin is not configured for PWM output
4-4 Value must be specified as an integer
4-5 Value must be in the range of 0-255
PLAY TONE
5-1 Pin Must Be Specified as an Integer
5-2 Pin number is not valid
5-3 Pin was not properly configured
5-4 Frequency must be specified as an integer
5-5 Duration must be specified as an integer
NO TONE
6-1 Pin Must Be Specified as an Integer
6-2 Pin number is not valid
6-3 Pin was not properly configured
SERVO POSITION
7-1 Pin Must Be Specified as an Integer
7-2 Pin number is not valid
7-3 Pin was not properly configured
7-4 Position must be specified as an integer
7-5 Position must be in the range of 0 - 180
DIGITAL_READ (Snap!
Only)
8-1 Pin Must Be Specified as an Integer
8-2 Pin number is not valid
8-3 Pin is not properly configured
ANALOG_READ (Snap!
Only)
9-1 Pin Must Be Specified as an Integer
9-2 Pin number is not a valid analog pin number
9-3 Pin is not properly configured

Usando el Bloque Depurar

Each time an s2aio block is executed, the Debugger value is set to 0 and if any errors
are encountered the Debugger value is updated with the error code. So if you have two
sequential blocks executing, and the first has an error condition, the error code will be
overwritten when the second block executes.

30
Cada vez que s2aio ejecuta un bloque, el valor depurador se establece en 0 y si se
encuentran errores el valor depurador se actualiza con el código de error. Así que si
usted tiene dos bloques secuenciales de ejecución, y la primera tiene una condición de
error, será sobrescrito el código de error cuando el segundo bloque se ejecuta.

Si la secuencia de comandos no funciona como se esperaba, al utilizar el bloque

depurador, puede que tenga que separar sus bloques y ejecutarlos de forma individual
para detectar el error. Usted puede agregar sus bloques, uno por uno, volviendo a la
secuencia de comandos hasta que esté satisfecho todos los bloques están operando sin
errores detectados.

31
9. Blink
Este es un ejemplo muy simple que hará parpadear el LED "L", conectado al PIN13 de
un Arduino. No requiere ningún hardware adicional aparte de una placa Arduino.

El script comienza con un bloque "Al presionar".

Es seguido por el bloque de configuración Pin Digital. Este bloque establece pin 13
como salida digital habilitada.

El bloque de bucle "por siempre" contiene un bloque de "valor digital en PIN" que
escribe un 1 en el PIN13.

Esto es seguido por un bloque de "esperar" ajustado a 1 segundo.

A continuación, es un bloque de escritura digital valor digital en PIN" que escribe un 0

en el PIN13, seguido de un bloque de "esperar" de 1 segundo de duración

Cuando se ejecuta en el Arduino el LED se encenderá y apagará a razón de 1 segundo.

32
10. Usando un objeto tipo Sonar

El diagrama de arriba muestra cómo conectar un dispositivo sensor de Ultrasonidos

HC-SR04 con s2aio.

El Pin se activa usando un bloque "Leer Pin Digital". El diagrama anterior utiliza el pin
12.

El pin se habilita mediante el bloque de configuración Pin Digital, seleccionar el modo

de Sonar. Datos Sónar se controla mediante el uso de un bloque de lectura digital.
FirmataPlus debe ser cargado en el Arduino, para que esta característica funcione.

Nota: Este manual es una traducción y adaptación al español de la documentación

publicada por Alan Yorinks, creador de la librería en la Wiki de Github. La librería se
puede descargar en este enlace

Copyright (C) 2015, Alan Yorinks, All rights reserved.

26 de Noviembre de 2015 José Manuel Ruiz Gutiérrez

33