Tecnologia vestible

Emulació de teclat i ratolí

Emulació de teclat

El microcontrolador pot enviar caràcters a l'ordinador emulant el comportament d'un teclat. Per fer-ho cal importar la biblioteca Keyboard.h.

Comencem veient un exemple en el que uns polsadors connectats a una placa Flora emulen la polsació de tecles:

#include <Keyboard.h>

void setup() {
  Serial.begin(9600);
  pinMode(0, INPUT_PULLUP);
  pinMode(1, INPUT_PULLUP);
  pinMode(2, INPUT_PULLUP);
  pinMode(3, INPUT_PULLUP);
  Keyboard.begin();
  delay(1000);
  Serial.println("Prem un botó");
}

void loop() {
  // Polsador 0
  if (!digitalRead(0)) {
    Serial.println("Has premut el botó 0, escrivim Hola"); 
    Keyboard.write('H');
    Keyboard.write('o');
    Keyboard.write('l');
    Keyboard.write('a');
  }
  while (!digitalRead(0))
    ;    // Esperem que es deixi anar
  // Polsador 1
  if (!digitalRead(1)) {
    Serial.println("Has premut el botó 1, escrivim 'm'"); 
    Keyboard.press('m');
  }
  while (!digitalRead(1))
    ;    // Esperem que es deixi anar
  Keyboard.release('m');
  // Polsador 2
  if (!digitalRead(2)) {
    Serial.println("Has premut el botó 2, escrivim 'M'"); 
    Keyboard.press(KEY_LEFT_SHIFT);
    Keyboard.press('m');
  }
  while (!digitalRead(2))
    ;    // Esperem que es deixi anar
  Keyboard.releaseAll();
  // Polsador 3
  if (!digitalRead(3)) {
    Serial.println("Has premut el botó 3, enviem ENTER"); 
    Keyboard.press(KEY_RETURN);
  }
  while (!digitalRead(3))
    ;    // Esperem que es deixi anar
  Keyboard.release(KEY_RETURN);
  delay(200);    // Pausa per evitar rebots
}

En aquest cas hem posat resistències pull-up i, per tant, les entrades que fem servir (de la 0 a la 3) s'activen quan es connecten a GND. El polsador de l'entrada 0 envia un text, la comanda que es fa servir és Keyboard.write, que permet enviar caràcters ASCII individualment i cal posar-li el caràcter entre cometes simples o el seu codi ASCII. El de l'entrada 1 envia una lletra m fent servir la comanda Keyboard.press i després hem d'enviar la comanda Keyboard.release per indicar que hem deixat de polsar la tecla. El polsador de l'entrada 2 envia una M, fixem-nos que s'envia la pulsació de la tecla majúscules i la de la tecla M. Després hem enviat la comanda Keyboard.releaseAll que indica que hem deixat anar les tecles, així no cal enviar un Keyboard.release per a cada una. La funció Keyboard.write ja envia l'ordre de deixar anar la tecla i, per tant, no cal dir res més. Finalment, el polsador de l'entrada 2 envia la pulsació de la tecla ENTER. Si mb les comandes Keyboard.write i Keyboard.press s'envia una lletra majúscula, en realitat s'acaba enviant la tecla de majúscules i la de la lletra corresponent.

Atenció: Quan provem el programa hem de tenir la precaució de posar el cursor sobre una aplicació en la que poguem escriure, per exemple la llibreta, on anirem veient els caràcters que s'envien en prémer els polsadors. Si tinguéssim el cursor en el nostre programa a l'entorn Arduino veuríem com el programa es modifica amb els caràcters que es van enviant. Quan fem programes, cal que ens assegurem que hi ha un estat en el que el programa no envia caràcters perquè sinó se'ns farà molt difícil modificar-lo.

Important: La biblioteca que estem fent servir correspon al teclat dels EUA. Atès que els codis dels caràcters especials estan relacionats amb la posició de la tecla i no amb el caràcter, en un altre teclat podem obtenir caràcters diferents. Així doncs, es fa imprescindible fer proves abans de donar un programa per definitiu).

En la taula següent anem a comentar les opcions disponibles a la biblioteca Keyboard.h.

També tenim les funcions Keyboard.print i Keyboard.println que ens permeten enviar una seqüència de caràcters, que en el segon cas acabarà amb un salt de línia. El següent programa n'és un exemple.

#include <Keyboard.h>

void setup() {
  pinMode(0, INPUT_PULLUP);
  pinMode(1, INPUT_PULLUP);
  pinMode(2, INPUT_PULLUP);
  Keyboard.begin();
  delay(1000);
}

void loop() {
  // Polsador 0
  if (!digitalRead(0)) {
    Keyboard.print("Hola");
  }
  while (!digitalRead(0))
    ;    // Esperem que es deixi anar
  // Polsador 1
  if (!digitalRead(1)) {
    Keyboard.println("Bon dia");
  }
  while (!digitalRead(1))
    ;    // Esperem que es deixi anar
  // Polsador 2
  if (!digitalRead(2)) {
    Keyboard.println();
  }
  while (!digitalRead(2))
    ;    // Esperem que es deixi anar
  delay(200);    // Pausa per evitar rebots
}

A la taula següent hi ha els caràcters que hem de posar entre cometes simples i els resultats que obrindrem segons la combinació. Hem posat els caràcters que obtindríem amb els fitxers de configuració de teclat que acostumem a fer servir. Cal tenir present que el comportament que obtindrem amb moltes de les tecles depèn del programa en el que les fem servir o del context del programa.

Nota: Per als caràcters especials hem fet servir el seu codi numèric. Si no obtenim els caràcters llistats vol dir que el nostre teclat no es correspon amb el de la taula. Llavors haurem de provar els codis ASCII que corresponen a caràcters que no són ni lletres ni xifres (és a dir del 33 al 47, del 58 al 64, del 91 al 96 i del 123 al 126) fins trobar el que ens fa falta.

Emulació de ratolí

Ara anem a veure un exemple emulant el ratolí. Comencem veient un exemple en el que uns polsadors connectats a una placa Flora ens servirà per moure el punter a la pantalla.

#include <Mouse.h>

void setup() {
  Serial.begin(9600);
  pinMode(0, INPUT_PULLUP);
  pinMode(1, INPUT_PULLUP);
  pinMode(2, INPUT_PULLUP);
  pinMode(3, INPUT_PULLUP);
  pinMode(12, INPUT_PULLUP);
  Mouse.begin();
  delay(1000);
  Serial.println("Prem un botó");
}

void loop() {
  // Polsador 0
  if (!digitalRead(0)) {
    Serial.println("Has premut el botó 0, pujar"); 
    Mouse.move(0, -5, 0);
  }
  while (!digitalRead(0))
    ;    // Esperem que es deixi anar
  // Polsador 1
  if (!digitalRead(1)) {
    Serial.println("Has premut el botó 1, dreta"); 
    Mouse.move(5, 0, 0);
  }
  while (!digitalRead(1))
    ;    // Esperem que es deixi anar
  // Polsador 2
  if (!digitalRead(2)) {
    Serial.println("Has premut el botó 2, baixar"); 
    Mouse.move(0, 5, 0);
  }
  while (!digitalRead(2))
    ;    // Esperem que es deixi anar
  // Polsador 3
  if (!digitalRead(3)) {
    Serial.println("Has premut el botó 3, esquerra"); 
    Mouse.move(-5, 0, 0);
  }
  while (!digitalRead(3))
    ;    // Esperem que es deixi anar
  // Polsador 12
  if (!digitalRead(12)) {
    Serial.println("Has premut el botó 12, clic"); 
    Mouse.click();
  }
  while (!digitalRead(12))
    ;    // Esperem que es deixi anar
  delay(200);    // Pausa per evitar rebots
}

Atenció: Quan fem programes, cal que ens assegurem que hi ha un estat en el que el programa no envia caràcters perquè sinó se'ns farà molt difícil modificar-lo.

En la taula següent anem a comentar les opcions disponibles a la biblioteca Mouse.h.

^★Els valors han de ser signed char i, per tant, han d'estar entre -127 i 127

En aquest web, les fotografies marcades amb [AF] són del web d'Adafruit, les marcades amb [SF] del web d'Sparkfun i les marcades amb [AU] del web d'Arduino.

Aquesta obra d'Oriol Boix està llicenciada sota una llicència no importada Reconeixement-NoComercial-SenseObraDerivada 3.0.