PeekSmith

À propos de

MagiScript permet de connecter Atom à PeekSmith 3 ou SuperPeek. Vous pouvez :

afficher des messages sur son écran,
envoyer des modèles de vibration,
activer/désactiver le rapport de l'accéléromètre,
recevoir des événements liés aux boutons.

Se connecter à PeekSmith

Avant de pouvoir interagir avec un dispositif PeekSmith, vous devez vous y connecter à l'aide de la commande ps.connect (méthode). La méthode prend un seul argument, qui est l'ID du dispositif PeekSmith auquel vous voulez vous connecter.

Par exemple, si vous voulez vous connecter à un appareil PeekSmith avec l'ID "PeekSmith-036666", vous pouvez utiliser le code suivant :

ps.connect('PeekSmith-036666');

Si Atom n'est pas encore connecté à un périphérique PeekSmith, il commencera à le chercher puis se connectera. Si un appareil PeekSmith est déjà connecté, cette commande sera ignorée (même s'il s'agit d'un appareil différent). Vous pouvez utiliser la commande '*' pour se connecter à n'importe quel appareil PeekSmith disponible.

La meilleure façon de se connecter est d'ajouter cet appel au début du fichier main qui s'exécute lorsque le code est chargé.

function main() {
  ps.connect('PeekSmith-036666');
  // ...
}

Affichage d'un texte sur l'écran de PeekSmith

Une fois que vous vous êtes connecté à un appareil PeekSmith, vous pouvez afficher du texte sur son écran à l'aide de la commande ps.print La méthode prend un seul argument. La méthode prend un seul argument, qui est le texte que vous voulez afficher à l'écran. Si PeekSmith n'est pas encore connecté, MagiScript collectera vos messages et les enverra dès qu'un appareil sera connecté.

Par exemple, si vous souhaitez afficher le texte "Hello World" sur l'écran de PeekSmith, vous pouvez utiliser le code suivant :

ps.print('Hello World');

Cela affichera le texte "Hello World" sur l'écran de PeekSmith.

En utilisant le "Smart Text" de PeekSmith, vous pouvez afficher des cartes ou des couleurs à l'écran comme si vous envoyiez des messages :

ps.print('AH');        // displays an Ace of Heart
ps.print('7D KS');     // seven of diamonds, king of spades
ps.pring('star');      // displays a star ESP sign
ps.print('yellow');    // displays a yellow card

Vibration PeekSmith

Vous pouvez également faire vibrer le dispositif PeekSmith en utilisant le bouton ps.vibrate méthode. La méthode prend un seul argument, qui est le motif que vous voulez faire vibrer.

Par exemple, si vous voulez faire vibrer le dispositif PeekSmith avec un motif de trois vibrations courtes, vous pouvez utiliser le code suivant :

ps.vibrate('...');

Cela fera vibrer le dispositif PeekSmith trois fois dans un schéma court. Le dernier firmware du PeekSmith supporte les mêmes motifs qu'Atom (à l'exception du tic-tac court).

Données de l'accéléromètre (depuis le micrologiciel v1.1.31)

PeekSmith 3 possède un accéléromètre, et Atom peut l'activer ou le désactiver. Lorsqu'il est activé, l'accéléromètre commence à fournir des données brutes (x, y et z).

Accéléromètre ON

Il existe d'autres façons d'activer l'accéléromètre, mais elles ont le même effet :

ps.accel('on'); // please note that ON or On will not work
ps.accel(true);

Accéléromètre OFF

La désactivation de l'accéléromètre est similaire :

ps.accel('off'); // please note that OFF or Off will not work
ps.accel(false);

Données de l'accéléromètre

Vous commencerez à recevoir des événements contenant des données XYZ lorsque vous activerez l'accéléromètre via la fonction onEvent. La valeur sera un nombre séparé par des virgules, le type "xyz" et la source "ps::accel".

Exemple

Voici un exemple de code qui montre comment vous pouvez les utiliser :

function main() {
  ps.connect('PeekSmith-031060');
  ps.accel('on');
}

function onEvent(value, type, source) {
  if (type === 'xyz' && source === 'ps:accel') {
    let xyz = strSplit(value, ',');
    let x = parseInt(xyz[0]);
    let y = parseInt(xyz[1]);
    let z = parseInt(xyz[2]);
    console.log(x, y, z);
  }
}

Réception des événements liés aux boutons

Lorsqu'un PeekSmith est connecté, il commence à envoyer des événements de pression et de relâchement des boutons. PeekSmith a 3 boutons, #0 est le bouton latéral, #1 est le bouton avant gauche, et #2 est le bouton avant droit. Vous pouvez les traiter avec la fonction onEvent.

Consultez notre page de documentation sur les boutons pour plus de détails.

Conclusion

MagiScript offre un moyen facile de se connecter et de contrôler les appareils PeekSmith directement à partir d'Atom. En utilisant l'outil ps.connect, ps.printet ps.vibrate vous pouvez interagir avec le dispositif PeekSmith et afficher du texte et des motifs sur son écran, ainsi que le faire vibrer.

Navigation