Manuel de référence de l’interface graphique
Manuel de référence de l’interface graphique SIMx52
La plate-forme SHIP (Serious Human Interface™ Platform) est un système complet de développement et de déploiement rapide d’interfaces graphiques. L’IDE SHIP Total (« SHIPTide ») est l’outil de conception d’interface graphique basé sur PC qui génère un fichier de données GUI complet comprenant des polices, des images, une mise en page, des ressources, des événements et des scripts. Ce fichier de données, appelé « Cargo », est ensuite téléchargé dans le stockage d’une carte SIM (souvent en FLASH série). SHIPEngine est le moteur binaire d’exécution installé sur la carte SIM qui, lorsqu’il démarre, découvre le binaire cargo et décompresse et affiche l’interface graphique.
Lors de la création d’une interface graphique dans SHIPTide, le développeur a souvent besoin d’interagir dans l’environnement de l’interface graphique avec les fonctionnalités de la plate-forme matérielle sous-jacente, par exemple écouter l’écran tactile ou baisser la luminosité de l’écran LCD.
Chaque caractéristique majeure de la plate-forme matérielle est représentée dans l’environnement GUI sous la forme d’un port. Par exemple, la plupart des cartes SIM disposent d’un port verre, d’un port tactile, d’un ou plusieurs ports uart, etc. Le contrôle et la lecture des fonctionnalités de chacun de ces ports se font par le biais de variables spéciales appelées variables de port (plus précisément, portvars) qui existent dans leurs ports respectifs.
Ces manuels de référence de l’interface graphique (GRM) ne sont pas destinés à décrire pleinement les fonctionnalités et les utilisations typiques de chaque port et portvar. Au lieu de cela, ce GRM est conçu pour décrire les ports et les variables de port disponibles, les plages de valeurs appropriées et les notes d’utilisation spéciales. La description plus large des ports et des portvars, y compris des exemples d’utilisation, se trouve ailleurs dans les notes d’applications et les vidéos de formation en ligne. Consultez la page d’accueil de la documentation SHIP pour une liste complète des références et des formations.
Nœud de plate-forme
Dedans SHIPTide et l’environnement SHIPEngine chaque SIM a un plateforme section qui contient ses ports, ses portvars et quelques informations de base sur leplateformelui-même.
Dans tous les environnements SHIP GUI, le nœud de plate-forme porte également le nom fixe de « plate-forme ». Le nom « plate-forme » est réservé et unique, il s’agit donc d’une référence unique et spécifique à la plate-forme SIM sur laquelle l’interface graphique actuelle s’exécute. Toutes ses propriétés peuvent être spécifiées en notation « point » avec platform suivi de « .property », par exemple platform.id.
Le nœud de plate-forme possède les propriétés suivantes, qui sont toutes en lecture seule :
| Propriété | Type de données | Description |
|---|---|---|
| platform.id† | Entier | Valeur hexadécimale 32 bits composée de l'ID du fournisseur USB (0x25D8) de Serious Integrated Inc., suivi de l'ID du produit USB spécifique à la plate-forme pour le port de périphérique USB sur la carte SIM. |
| platform.vendor | Corde | Valeur constante de « Grave ». |
| platform.model† | Corde | Valeur spécifique à la plate-forme constante contenant le nom du modèle de la carte SIM. |
| platform.sn | Corde | Représentation en chaîne du numéro de série unique de 64 bits que chaque carte SIM a gravé dans son matériel au moment de la fabrication. Les numéros de série ont un format spécifique ; pour plus d'informations, contactez Serious. |
| platform.oemsn | Corde | Représentation sous forme de chaîne d'un numéro de série 64 bits spécifique au client : certaines variantes de carte SIM personnalisées ont été gravées dans leur matériel au moment de la fabrication. Pour plus d'informations, contactez Serious. |
Notes spécifiques à la plate-forme
| plate-forme.modèle | platform.id | Taille de l'écran LCD |
|---|---|---|
| SIM152 | 0x25D800152 | 3.5" |
| SIM252 | 0x25D800252 | 4.3" |
| SIM352 | 0x25D800352 | 5" |
| SIM552 | 0x25D800552 | 7" |
Port(s) en verre
Les ports en verre sont utilisés pour contrôler l’affichage de la carte SIM et sont généralement désignés au format « plate-forme ». GLASS0 », « plate-forme. VERRE1″, etc.
Les différents champs sont renseignés au lancement de SHIPEngine avec les valeurs par défaut de la plate-forme donnée.
| Portvar | Type de données | Autorisations | Description |
|---|---|---|---|
| kick | Booléen | Lecture/écriture | L'activation de la valeur de kick réinitialise la minuterie de rétroéclairage (si elle est réglée). La valeur réelle n'a pas d'importance ; C'est l'événement de changement qui réinitialise la minuterie de rétroéclairage. En tant que tel, kick doit toujours être attribué à l'opposé de sa valeur actuelle (c'est-à-dire GLASS0.kick = ! GLASS0.kick). |
| timeout | Entier | Lecture/écriture | Le nombre de secondes jusqu'à ce que le rétroéclairage s'éteigne automatiquement. Si kick est modifié, la minuterie est réinitialisée à la valeur de délai d'attente complet. S'il est réglé sur 0, le rétroéclairage ne s'éteindra jamais automatiquement. Cette valeur est toujours 0 (désactivée) au démarrage. Si une valeur par défaut autre que 0 est souhaitée, stockez la valeur souhaitée dans une variable persistante dans votre interface graphique et chargez-la dans le délai d'expiration au démarrage à l'aide de l'événement shiplaunch. |
| width† | Dimension | Lecture seule | Il s'agit de la largeur (x), en pixels, de l'affichage de la carte SIM. (Par défaut : spécifique à la plate-forme) |
| height† | Dimension | Lecture seule | Il s'agit de la hauteur (y), en pixels, de l'affichage de la carte SIM. (Par défaut : spécifique à la plate-forme) |
| mirrorx | Booléen | Lecture/écriture | Lorsqu'il est réglé, l'ensemble de l'affichage est reflété dans la direction x. Peut être utilisé en conjonction avec flipxy. (Par défaut false) |
| mirrory | Booléen | Lecture/écriture | Lorsqu'il est réglé, l'ensemble de l'affichage est reflété dans la direction y. Peut être utilisé en conjonction avec flipxy. (Defaultfalse) |
| flipxy | Booléen | Lecture/écriture | Lorsqu'il est réglé, l'ensemble de l'affichage est retourné sur l'axe x-y (mode portrait). Peut être utilisé en conjonction avec mirrorx et/ou mirrory. (Par défaut : false) |
| bpp† | Octet | Lecture seule | Nombre de bits par pixel sur le verre. Le nombre total de couleurs affichables est de 2 à la puissance de ce nombre (par exemple 2^16 = 65536 couleurs totales). (Par défaut : spécifique à la plate-forme) |
| backlight | Octet | Lecture/écriture | La luminosité du rétroéclairage est comprise entre 0 (éteint) et 100 (max). La régulation de l'intensité du rétroéclairage peut réduire la puissance, augmenter la longévité du matériel de rétroéclairage et améliorer la visualisation dans différentes conditions d'éclairage. Le réglage de cette valeur sur une valeur hors plage définit le rétroéclairage à max. (par défaut : 100) |
Notes spécifiques à la plate-forme
- Le SIMx52 dispose d’un seul écran, désigné par le nom de GLASS0
Le code LCD spécifique du module que vous utilisez indique la résolution (largeur x hauteur des pixels) de l’écran LCD; le 7ème des 8 chiffres est la résolution ; ainsi, par exemple, dans le numéro de pièce 7 » « SIM552-A01-C45ALMDA », le code LCD est « C45ALMDA » et le 7ème chiffre est « D ». La recherche de ce code dans les tables de codes LCD donne 800×480.
Dans cet exemple,
- Pour le mode paysage, la largeur et la hauteur sont respectivement de 800 et 480
- Pour le mode portrait, la largeur et la hauteur sont respectivement de 480 et 800
- bpp est de 24 (pour la couleur 24 bits RGB888) pour tous les produits SIMx52
Port(s) tactile(s)
Les ports tactiles sont utilisés pour lire et configurer l’interface tactile de la carte SIM et sont généralement désignés au format « plate-forme ». TOUCH0 », « plate-forme. TOUCH1″, etc.
| Portvar | Type de données | Autorisations | Description |
|---|---|---|---|
| event | Toucher | Lecture seule | Type de données complexe avec plusieurs propriétés. (voir Événements tactiles) |
| width† | Dimension | Lecture seule | Il s'agit de la largeur (x), en pixels, de l'affichage de la carte SIM. (Par défaut : spécifique à la plate-forme) |
| height† | Dimension | Lecture seule | Il s'agit de la hauteur (y), en pixels, de l'affichage de la carte SIM. (Par défaut : spécifique à la plate-forme) |
| mirrorx | Booléen | Lecture/écriture | Lorsqu'elle est définie, les valeurs reçues des événements tactiles sont reflétées dans la direction x. Peut être utilisé en conjonction avec flipxy. (Par défaut : false) |
| mirrory | Booléen | Lecture/écriture | Lorsqu'elle est définie, les valeurs reçues des événements tactiles sont reflétées dans la direction y. Peut être utilisé en conjonction avec flipxy. (Par défaut : false) |
| flipxy | Booléen | Lecture/écriture | Lorsqu'elle est définie, les valeurs reçues des événements tactiles sont inversées sur l'axe x-y (mode portrait). Peut être utilisé en conjonction avec mirrorx et/ou mirrory. (Par défaut : false) |
Notes spécifiques à la plate-forme
Il y a une seule interface tactile ; désigné par le nom Plateforme. TOUCHER0
La résolution de l’écran tactile (le cas échéant) est la même que celle de l’écran LCD. En supposant le même code de résolution « D » (c’est-à-dire 800×480) que dans l’exemple ci-dessus :
- Pour le mode paysage, la largeur et la hauteur sont respectivement de 800 et 480
- Pour le mode portrait, la largeur et la hauteur sont respectivement de 480 et 800
GPIO Port(s)
Les ports GPIO sur SIMx52 sont nommés plate-forme. GPIO et contient une variété de ports d’E/S à usage général, notamment :
| Portvar | Type de données | Autorisations | Description |
|---|---|---|---|
| pcbTemp | Température | Lecture seule | Valeur du capteur de température embarqué le cas échéant. |
| tempPrecision | Octet | Lecture/écriture | Contrôle le nombre de bits de précision de la lecture pcbTemperature (SHIPv4) ou pcbTemp (SHIPv5). Une valeur comprise entre 0 et 8 ; La valeur par défaut est 0. |
| ambLight | Octet | Lecture seule | Reflète l'intensité actuelle de la lumière ambiante, de 0 à 100%. Peut être combiné avec le rétroéclairage pour que la luminosité du rétroéclairage LCD suive les conditions de lumière ambiante. |
| ioX | Booléen | Lecture/écriture | Lit la valeur physique actuelle de la broche GPIO, où « X » est 0,1,.. en fonction de la plateforme. Les écritures sont ignorées à moins que la broche ne soit configurée en tant que sortie (voir plate-forme. GPIO. IOMODE). |
| ioModeX | Octet | Lecture/écriture | Définit le mode de sortie de la broche GPIO, où « X » est 0,1,.. en fonction de la plateforme ; Voir plate-forme. GPIO. Constantes IOMODE pour les paramètres. |
Notes spécifiques à la plate-forme
- Il y a 4 broches GPIO io disponibles, numérotées 0, 1, 2, 3.
- La fonctionnalité GPIO n’est pas encore implémentée ; Contactez-nous pour plus de détails.
- Si le capteur de température embarqué n’est pas présent sur la plate-forme, pcbTemp indiquera 23.00°C.
UART Port(s)
Les ports UART sont utilisés pour configurer la façon dont une carte SIM communique avec un autre appareil et sont généralement désignés au format « plate-forme ». UART0 », « plate-forme. UART1″, etc.
Si vous tentez de définir une valeur non valide pour l’une de ces portvars, la valeur de la portvar ne sera pas modifiée. (voir UART_FLAGS)
| Portvar | Type de données | Autorisations | Description |
|---|---|---|---|
| rate† | Entier | Lecture/écriture | Le débit en bauds. |
| bits† | UART_FLAG | Lecture/écriture | Nombre de bits par jeu de caractères. |
| stop† | UART_FLAG | Lecture/écriture | Nombre de bits d'arrêt envoyés après chaque jeu de caractères. |
| parity† | UART_FLAG | Lecture/écriture | Le bit de parité envoyé après chaque jeu de caractères. |
| txControl† | UART_FLAG | Lecture/écriture | Définit le fonctionnement de la ligne de contrôle tx matériel pour le contrôle de l'émetteur-récepteur en duplex intégral/semi-duplex (par défaut UART_FLAGS. TXC_UNUSED). |
Notes spécifiques à la plate-forme
- SIMx52 dispose de deux UART désignés par la plate-forme de noms. UART0 et plate-forme. UART1
plateforme. UART0 est l’UART connecté à l’émetteur-récepteur RS485 (le cas échéant) et exposé via le connecteur de réseau industriel 3,5 mm à 6 broches. plateforme. UART1 est l’UART disponible sur les connecteurs carte-à-carte et JST16.
Au sein des deux ‘ plateformes. Les nœuds UARTx sont les sous-variables suivantes :
- le taux par défaut est 9600
- bits La valeur par défaut est UART_FLAGS. BITS_8
- stop default est UART_FLAGS. STOP_1
- La valeur par défaut de parité est UART_FLAGS. PARITY_NONE
USBF CDC Port(s)
Les variables de port USBF (c’est-à-dire port USB) Communications Class Device (CDC) sont utilisées pour configurer la façon dont une carte SIM communique avec un autre appareil et sont référencées au format « plate-forme ». USBF_CDC0 », « plate-forme. USBF_CDC1″, etc.
Plusieurs protocoles de périphériques USB (alias « classes ») peuvent être actifs simultanément sur le même port. Par exemple, sur le port de périphérique USB 0 d’une plate-forme, vous pouvez avoir :
- USBF_CDC0, la mise en œuvre de la classe de dispositifs de communication (alias « port série sur USB »), et,
- USBF_VENDOR0, la classe Vendor (ou « Raw ») liée à une Protocole SHIPBridge relie Échange de données avec un autre tableau
les deux fonctionnant simultanément.
USBF_CDC périphériques se comportent comme des UART et ont un sous-ensemble des portvars UART. Si vous tentez de définir une valeur non valide pour l’une de ces portvars, la valeur de la portvar ne sera pas modifiée. (voir UART_FLAGS)
| Portvar | Type de données | Autorisations | Description |
|---|---|---|---|
| rate† | Entier | Lecture/écriture | Le débit en bauds. |
| bits† | UART_FLAG | Lecture/écriture | Nombre de bits par jeu de caractères. |
| stop† | UART_FLAG | Lecture/écriture | Nombre de bits d'arrêt envoyés après chaque jeu de caractères. |
| parity† | UART_FLAG | Lecture/écriture | Le bit de parité envoyé après chaque jeu de caractères. |
Notes spécifiques à la plate-forme
- Le SIMx52 dispose d’un port de périphérique USB (alias « Function ») avec une classe de périphérique de communication (CDC alias « port série sur USB ») appelée USBF_CDC0.
USBF_CDC0 est exposé via le connecteur USB Micro B ainsi que sur le connecteur carte-à-carte de la carte fille. Étant donné que vous ne pouvez pas avoir deux hôtes connectés au même port de périphérique USB, ce port est auto-arbitré par SHIPEngine comme décrit dans le manuel de référence technique SIMx52.
Au sein des deux plateformes. USBF_CDCx nœuds sont les sous-variables suivantes :
- La valeur par défaut est 12000000
- bits La valeur par défaut est UART_FLAGS. BITS_8
- stop default est UART_FLAGS. STOP_1
- La valeur par défaut de parité est UART_FLAGS. PARITY_NONE
Port(s) USBF de classe fournisseur
La plateforme. USBF_VENDORx ports n’ont pas de paramètres de configuration ; Ce nœud est conçu pour se lier principalement à la Protocole SHIPBridge pour l’échange de données entre les interfaces graphiques et les systèmes externes.
Plusieurs protocoles de périphériques USB (alias « classes ») peuvent être actifs simultanément sur le même port. Par exemple, sur le port de périphérique USB 0 d’une plate-forme, vous pouvez avoir :
- USBF_CDC0, la mise en œuvre de la classe de dispositifs de communication (alias « port série sur USB »), et,
- USBF_VENDOR0, la classe Vendor (ou « Raw ») liée à une Protocole SHIPBridge Lien Échange de données avec un autre tableau les deux fonctionnant simultanément.
Notes spécifiques à la plate-forme
- Le SIMx52 dispose d’un port de périphérique USB (alias « Function ») avec un pilote de classe « vendor » (alias « raw »), USBF_VENDOR0.
USBF_VENDOR0 est exposé via le connecteur USB Micro B ainsi que sur le connecteur carte-à-carte de la carte fille. Étant donné que vous ne pouvez pas avoir deux hôtes connectés au même port de périphérique USB, ce port est auto-arbitré par SHIPEngine comme décrit dans le manuel de référence technique SIMx52.
Port(s) de périphérique de stockage
DRIVE est en fait un groupe de ports qui nomment les différents « lecteurs » de stockage disponibles sur une plate-forme donnée. Nœuds au sein de la « plate-forme ». DRIVE », par exemple « platform. CONDUIRE. BULK0 » peut être référencé par des descripteurs de fichiers et des opérations de type périphérique de stockage, par exemple en interrogeant la taille du périphérique de stockage.
Périphériques de stockage en vrac
CONDUIRE. Les ports BULKx font référence aux systèmes de fichiers sur les périphériques de stockage en vrac, tels que les périphériques e.MMC, NAND ou NOR Flash, intégrés au module spécifique et sont désignés au format « plate-forme ». CONDUIRE. BULK0 », « plate-forme. CONDUIRE. EN VRAC1″, etc. Pensez à DRIVE. CONDUIRE. BULK0 en tant que « lecteur C » traditionnel sur un PC – le périphérique de stockage principal intégré.
CONDUIRE. Les ports BULKx peuvent être référencés dans diverses actions liées aux fichiers, comme l’appareil sur lequel un fichier est ouvert/fermé/lu/écrit, par exemple. De plus, ces ports ont divers attributs pour déterminer/contrôler leur état :
| Portvar | Type de données | Autorisations | Description |
|---|---|---|---|
| autoUpdate† | Booléen | Lecture/écriture | Il s'agit d'un paramètre persistant de redémarrage, qui active/désactive (si vrai/faux) le processus de mise à jour automatique si des fichiers de mise à jour du micrologiciel sont présents sur le disque. |
Périphériques de stockage hôte USB
CONDUIRE. Les ports USBHx font référence à des systèmes de fichiers sur des supports USB amovibles, par exemple une clé USB, branchés sur un connecteur USB Host A de module (le cas échéant), et sont désignés au format « plate-forme ». CONDUIRE. USBH0 », « plate-forme. CONDUIRE. USBH1″, etc.
CONDUIRE. Les ports USBHx peuvent être référencés dans diverses actions liées aux fichiers, comme l’appareil sur lequel un fichier est ouvert/fermé/lu/écrit, par exemple. De plus, ces ports ont divers attributs pour déterminer/contrôler leur état
| Portvar | Type de données | Autorisations | Description |
|---|---|---|---|
| autoUpdate† | Booléen | Lecture/écriture | Il s'agit d'un paramètre persistant de redémarrage, qui active/désactive (si vrai/faux) le processus de mise à jour automatique si des fichiers de mise à jour du micrologiciel sont présents sur le disque. |
| mounted† | Booléen | Lire | Lorsque true, indique que le support amovible est inséré et monté avec un format et un système de fichiers valides. |
Périphériques de stockage sur carte SD
CONDUIRE. Les ports SDx font référence aux systèmes de fichiers sur des supports USB amovibles, par exemple une clé USB, branchée sur le connecteur de carte SD ou Micro SD d’un module (le cas échéant), et sont désignés au format « plate-forme ». CONDUIRE. SD0 », « plate-forme. CONDUIRE. SD1″, etc.
CONDUIRE. Les ports SDx peuvent être référencés dans diverses actions liées aux fichiers, comme le périphérique sur lequel un fichier est ouvert/fermé/lu/écrit, par exemple. De plus, ces ports ont divers attributs pour déterminer/contrôler leur état :
| Portvar | Type de données | Autorisations | Description |
|---|---|---|---|
| autoUpdate† | Booléen | Lecture/écriture | Il s'agit d'un paramètre persistant de redémarrage, qui active/désactive (si vrai/faux) le processus de mise à jour automatique si des fichiers de mise à jour du micrologiciel sont présents sur le disque. |
| mounted† | Booléen | Lire | Lorsque true, indique que le support amovible est inséré et monté avec un format et un système de fichiers valides. |
Notes spécifiques à la plate-forme
- Le SIMx52 dispose de trois ports DRIVE, un pour chacun des périphériques de stockage disponibles :
- DRIVE. BULK0 qui fait référence au système de fichiers en vrac e.MMC embarqué
- DRIVE. USBH0 qui fait référence au système de fichiers sur un périphérique de type clé USB branché sur le connecteur USB Host A
- DRIVE. SD0 qui fait référence au système de fichiers sur une carte Micro SD si elle est branchée sur la carte SIM.
Port(s) média(s)
Les ports MEDIAx font référence à la sortie de l’audio et de la vidéo sur le module, et sont désignés au format « plate-forme ». MEDIA0 », « plate-forme. MEDIA1″, etc.
Les ports MEDIAx disposent de différents attributs permettant de déterminer/contrôler leur état :
| Portvar | Type de données | Autorisations | Description |
|---|---|---|---|
| error† | Octet | Lire | La condition d'erreur du clip multimédia. |
| height† | Dimension | Lire | La hauteur, en pixels, du clip multimédia en cours de lecture s'il contient du contenu vidéo (sinon elle sera 0). |
| layer† | Octet | Lecture/écriture | Calque actuel dans lequel la vidéo est lue (par défaut 1 est superposé, 0 est derrière l'interface graphique). |
| length† | Entier | Lire | La durée totale du médiaclip en cours de lecture, en millisecondes. |
| location† | Noeud | Lecture/écriture | Le DRIVE source (par exemple, la plate-forme. CONDUIRE. BULK0) du fichier audio ou vidéo source. |
| play† | Booléen | Lecture/écriture | Lit (si true) ou met en pause (si false) le clip multimédia. Cela devient automatiquement faux à la fin de la lecture d'un clip. |
| position† | Entier | Lecture/écriture | La position actuelle jouée dans ce clip multimédia, en millisecondes. |
| source† | Corde | Lecture/écriture | Nom de fichier du fichier audio ou vidéo source. |
| state† | Octet | Lire | L'état du clip multimédia. |
| volume† | Octet | Lecture/écriture | Le volume du clip multimédia en cours de lecture de 0 à 100 %. |
| width† | Dimension | Lire | La largeur, en pixels, du clip multimédia en cours de lecture s'il contient du contenu vidéo (sinon elle sera 0). |
En général, les fichiers multimédias sont des « conteneurs » qui contiennent de l’audio et/ou de la vidéo. Par exemple, un clip audio mp3 sur votre PC est en fait un conteneur MPEG-ES encapsulant du contenu audio encodé avec le codec mp3. Les films MPEG, souvent dans des fichiers .mp4, sont en fait des conteneurs encapsulant des pistes vidéo et audio encodées de différentes manières.
La distinction entre le type de conteneur et l’encodage du contenu est importante, car pour que SHIPEngine sur la plateforme puisse lire le média, le conteneur ainsi que le contenu doivent être reconnaissables et jouables.
Remarques spécifiques à la plate-forme
Le SIMx52 dispose d’un seul port multimédia ; désigné par le nom Plateform.MEDIA0.
SHIPTide peut prendre en charge l’importation de nombreux conteneurs et codecs audio/vidéo. Les exportations avec du contenu audio/vidéo intégré dans le fichier de cargaison seront converties par SHIPTide dans le format natif le mieux adapté.
Le SIMx52 ne prend pas en charge la vidéo. Tout contenu multimédia provenant des médias importés par SHIPTide sera dépouillé de sa ou ses pistes vidéo.
Nativement, le SIMx52 prend en charge les formats audio suivants :
Les éléments suivants sont prévus pour une sortie future, Contactez-nous pour plus de détails.
- .weba, avec les codecs pris en charge :
- .mp3 fichiers audio
