Le fichier README.md suivant décrit la procédure de développement et d'installation de la PiNe Box, y compris l'interface utilisateur. Le boîtier PiNe est un appareil fermé fonctionnant avec un Raspberry Pi qui permet le déclenchement simultané d'événements et d'horodatage entre un système EEG ainsi qu'un moniteur externe de signes vitaux. Le système exécute une interface utilisateur Python qui lit les déclencheurs TTL à partir de dispositifs de déclenchement externes (qui sont simultanément envoyés à un amplificateur EEG) et envoie un message UDP au moniteur de signes vitaux via une liaison réseau Ethernet. Une interface graphique permet à l'utilisateur de sélectionner l'adresse IP et les ports d'écoute appropriés.
Ces instructions concernent six déclencheurs d'entrée (stimuli bouton-poussoir, lance, tactile, auditif, visuel et expérimental/Pin Prick) utilisant la spécification TTL et le système de signes vitaux est actuellement supposé être iXTrend développé par iXcellence : https://www.ixellence .com/index.php/en/home/17-default-en/products
Développeurs : Kirubin Pillay, Maria Cobo Andrade, Caroline Hartley, Alan Worley 06/07/2021
Groupe de neuroimagerie pédiatrique, Université d'Oxford, Oxford, Royaume-Uni.
Hôpital Great Ormond Street, Londres, Royaume-Uni.
Version 1.0 (sortie le 06/07/2021)
Un manuscrit est actuellement en cours d’élaboration et devra être cité une fois publié. La citation sera fournie ici.
Pour développer la box PiNe, ce référentiel contient les informations suivantes :
Les instructions du logiciel du système d'exploitation supposent qu'une version récente de Raspbian Jessie est déjà installée sur le Pi. Le code de l'interface utilisateur Python nécessite Python 3.7.0 ou supérieur.
git clone https://github.com/kpillay/PiNEbox.git
cd PiNEbox.
pip install -r requirements.txt
Le Pi est généralement installé avec Python 2 et éventuellement une version de Python 3 (<3.7.0) au moins sur le système d'exploitation Raspbian. Si tel est le cas, Python 3.7 devra d'abord être installé et lié symboliquement à la commande python
lors de son exécution sur le terminal. Pour y parvenir, suivez les instructions trouvées dans : https://installvirtual.com/install-python-3-7-on-raspberry-pi/. S'il est déjà configuré, passez à l'étape 3.
Après avoir suivi les instructions de l'étape 1, le programme d'installation de pip pointera probablement toujours vers une instance Python précédente. Pour éviter ce conflit, téléchargez et installez le référentiel avec les commandes suivantes (en supposant que python 3.7 soit désormais lié symboliquement par python
dans le terminal. Notez que cela téléchargera une version en lecture seule du référentiel et est recommandé lorsque vous souhaitez simplement déployer le logiciel actuel. version sur votre Pi pour une utilisation non-développeur.
git clone git://github.com/kpillay/PiNEbox.git
cd PiNEbox
python -m pip install -r requirements.txt
Quelques adaptations du logiciel doivent être apportées pour qu'il fonctionne au mieux avec le matériel du boîtier PiNe et l'interface utilisateur Python. Cela inclut l'installation d'un clavier virtuel à utiliser sur l'écran tactile.
Avant de continuer, mettez à jour le système d'exploitation Raspbian vers la dernière version. Pour ce faire, entrez les commandes suivantes dans le terminal Pi (assurez-vous d'abord qu'une connexion Internet est établie sur le Pi via WiFi ou Ethernet) :
sudo apt-get update
sudo apt-get upgrade
sudo shutdown -r now
Une fois le Pi mis à jour et arrêté. Redémarrez et procédez comme ci-dessous.
Le bouton d'arrêt logiciel utilise la broche TxD du Pi GPIO pour fournir à l'utilisateur un indicateur de l'état actuel du processeur. Cette broche doit être activée dans le logiciel pour alimenter la LED. Pour ce faire :
bootconfig.txt
enable_uart=1
, puis enregistrez et fermez.Le clavier-boîte d'allumettes est choisi ici. Pour l'installer et créer un raccourci sur la barre d'outils :
sudo apt-get install matchbox-keyboard
.Pour créer une apparence plus professionnelle et sur mesure pour le système d'exploitation de votre Pi en vue de l'exécution de l'interface utilisateur Python, vous pouvez modifier les couleurs. L'arrière-plan et les couleurs de la barre des tâches et de la fenêtre peuvent être modifiés pour correspondre à l'interface utilisateur Python en accédant au menu Démarrer de Pi, en sélectionnant « Préférences » et en ouvrant les paramètres « Apparence ». Les codes couleurs HEX suivants peuvent être utilisés :
Un fond d'écran PiNe Box est également inclus dans le référentiel et appelé « PiNe_wallpaper.png ». Cela peut également être ajouté dans les paramètres ci-dessus.
Pour exécuter l'interface utilisateur PiNe sur PC/Mac/Raspberry Pi, exécutez simplement cli.py
dans l'IDE de votre choix. Pour exécuter directement dans le terminal, accédez à l'emplacement du référentiel et utilisez la commande suivante :
python cli.py
L'interface utilisateur Python peut être testée en définissant l'adresse IP sur localhost (127.0.0.1) et en exécutant le script comme ci-dessus. L'ouverture d'une session Python parallèle avec les scripts serveur fournis PiNe_macServerUDP.py et PiNe_macServerTCP.py en fonction du choix de messagerie permettra de tester que les scripts cli.py renvoient avec succès des messages à votre machine locale.
Une fois que l'interface utilisateur Python peut être ouverte avec succès comme ci-dessus à l'aide du terminal, elle peut être configurée pour s'ouvrir automatiquement à chaque démarrage du Pi. Les instructions suivantes supposent que le dossier du référentiel PiNEbox se trouve sur le bureau :
sudo nano /etc/xdg/lxsession/LXDE-pi/autostart
./home/pi/Desktop/PiNEbox/PiNe_startup.sh
.