Moteur de programmation KB360 SmartSet
Guide de l'utilisateur
Fièrement conçu et assemblé à la main aux États-Unis depuis 1992
Kinesis® AdvantagClavier e360™ avec le moteur de programmation SmartSet™ Les modèles de clavier couverts par ce manuel incluent tous les claviers de la série KB360 (KB360-xxx). Certaines fonctionnalités peuvent nécessiter une mise à niveau du micrologiciel. Toutes les fonctionnalités ne sont pas prises en charge sur tous les modèles. Ce manuel ne couvre pas la configuration et les fonctionnalités de l'AdvantagClavier professionnel e360 doté du moteur de programmation ZMK.
Édition du 11 février 2021
Ce manuel couvre les fonctionnalités incluses jusqu'à la version 1.0.0 du micrologiciel.
Si vous disposez d'une version antérieure du micrologiciel, toutes les fonctionnalités décrites dans ce manuel peuvent ne pas être prises en charge. Pour télécharger le dernier firmware ici :
kinesis.com/support/adv360/#firmware-updates
© 2022 par Kinesis Corporation, tous droits réservés. KINESIS est une marque déposée de Kinesis Corporation. AVANCETAGE360, CONTOURED KEYBOARD, SMARTSET et v-DRIVE sont des marques commerciales de Kinesis Corporation. WINDOWS, MAC, MACOS, LINUX, ZMK et ANDROID sont la propriété de leurs propriétaires respectifs.
Les informations contenues dans ce document sont susceptibles d'être modifiées sans préavis. Aucune partie de ce document ne peut être reproduite ou transmise sous quelque forme ou par quelque moyen que ce soit, électronique ou mécanique, à des fins commerciales, sans l'autorisation écrite expresse de Kinesis Corporation.
CORPORATION KINESIS
22030 20th Avenue SE, bureau 102
Bothell, Washington 98021 États-Unis
www.kinesis.com
Déclaration de la FCC sur les interférences radio
Cet équipement a été testé et jugé conforme aux limites d'un appareil numérique de classe B, conformément à la partie 15 des règles de la FCC.
Ces limites sont conçues pour fournir une protection raisonnable contre les interférences nuisibles lorsque l'équipement est utilisé dans une installation résidentielle. Cet équipement génère, utilise et peut émettre de l'énergie de fréquence radio et, s'il n'est pas installé et utilisé conformément aux instructions, peut causer des interférences nuisibles aux communications radio.
Cependant, il n'existe aucune garantie que des interférences ne se produiront pas dans une installation particulière. Si cet équipement provoque des interférences nuisibles à la réception radio ou télévision, ce qui peut être déterminé en éteignant et en rallumant l'équipement, l'utilisateur est encouragé à essayer de corriger les interférences en prenant une ou plusieurs des mesures suivantes :
- Réorienter ou déplacer l'antenne de réception
- Augmenter la séparation entre l'équipement et le récepteur
- Branchez l'équipement sur une prise d'un circuit différent de celui auquel le récepteur est connecté
- Consultez le revendeur ou un technicien radio/TV expérimenté pour obtenir de l'aide
Avertissement
Pour assurer la conformité continue de la FCC, l'utilisateur doit utiliser uniquement des câbles d'interface blindés lors de la connexion à l'ordinateur ou au périphérique. De plus, tout changement ou modification non autorisé à cet équipement annulerait le droit de l'utilisateur à l'utiliser.
DÉCLARATION DE CONFORMITÉ D’INDUSTRIE CANADA
Cet appareil numérique de classe B répond à toutes les exigences de la réglementation canadienne sur les équipements provoquant une interface.
1.0 Introduction
L'Advantage360 est un clavier entièrement programmable qui dispose d'un stockage flash intégré (le "v-Drive) et n'utilise aucun pilote ou logiciel spécial. Le clavier a été conçu pour être programmé rapidement et facilement à l'aide des raccourcis intégrés ou via l'application SmartSet pour Windows et Mac. Les utilisateurs expérimentés ont la possibilité de contourner l'interface graphique SmartSet et de "programmer directement" le clavier sur tous les principaux systèmes d'exploitation en accédant au texte simple du clavier fileconfiguration files.
Ces instructions s'appliquent à la base AdvantagLe modèle e360 est doté du moteur de programmation SmartSet. Si vous avez le modèle professionnel avec le moteur ZMK, arrêtez de lire et visitez https://kinesis-ergo.com/support/adv360-pro.
2.0 Programmation directe terminéeview
L'Advantage360 dispose de 9 Pro personnalisablesfiles qui comprennent 9 ensembles d'aménagements et de configurations d'éclairage. Le clavier dispose également d'une série de paramètres de clavier globaux qui peuvent être configurés. Chacune de ces configurations est stockée dans un ensemble de dossiers sur le clavier (le "v-Drive") sous la forme d'une série de texte simple files (.txt). Pendant la programmation embarquée, le clavier lit/écrit automatiquement sur ces filec'est "dans les coulisses". La particularité du 360 est que les utilisateurs expérimentés peuvent "connecter" (c'est-à-dire "monter") le v-Drive à leur PC, puis modifier directement cette configuration. files sous Windows, Linux, Mac et Chrome.
Chaque fois qu'un remappage ou une macro est créé dans un Profile, il est écrit dans le layout.txt correspondant file comme une ligne discrète de "code". Et la fonction et la couleur de chacune des 6 LED RVB sont contrôlées dans le led.txt correspondant file. Chaque fois qu'un paramètre du clavier est modifié, le changement est enregistré dans le "settings.txt" file.
3.0 Avant de commencer
3.1 Utilisateurs avancés UNIQUEMENT
L'édition directe nécessite d'apprendre à lire et à écrire une syntaxe personnalisée. L'insertion de caractères incorrects dans l'une des configurations files peuvent avoir des conséquences inattendues et peuvent causer des problèmes temporaires même avec le fonctionnement de base du clavier. Lisez d'abord le guide de démarrage rapide et le manuel de l'utilisateur et procédez avec prudence.
3.2 Toujours éjecter le v-Drive avant de déconnecter le v-Drive
Le v-Drive est comme n'importe quel autre lecteur flash que vous connectez à votre PC. Si vous le retirez soudainement alors que le PC accède toujours au contenu du lecteur, vous pouvez provoquer file dommage. Pour protéger le v-Drive, enregistrez et fermez toujours toutes les configurations files, puis utilisez le protocole d'éjection approprié pour votre système d'exploitation avant de « déconnecter » le v-Drive avec le raccourci intégré. Si votre PC refuse d'éjecter le disque, assurez-vous que tous files et les dossiers sont fermés et réessayez.
Éjecter Windows : enregistrez et fermez tout fichier .txt files que vous avez modifié. De File Explorer, revenez au niveau supérieur du lecteur amovible "ADV360" et cliquez avec le bouton droit sur le nom du lecteur, puis sélectionnez Éjecter. Une fois que vous avez reçu la notification "Safe to Eject", vous pouvez procéder à la fermeture du v-Drive avec le raccourci intégré. L'échec de l'éjection peut entraîner une erreur de lecteur mineure que Windows vous demandera de réparer. Le processus "Analyser et réparer"
(illustré à droite) est simple et rapide.
3.3 Utilisateurs non américains
Votre ordinateur doit être configuré pour la disposition du clavier anglais (US). D'autres pilotes de langue utilisent des codes/positions différents pour certaines touches qui sont essentielles pour la programmation de caractères tels que [], {} et >.
3.4 Texte simple Files UNIQUEMENT
Ne pas enregistrer la configuration files au format RTF (.rft) car les caractères spéciaux peuvent provoquer des erreurs de syntaxe.
3.5 Une mise à jour du micrologiciel peut être requise
Certaines des fonctionnalités décrites dans ce guide peuvent nécessiter une mise à jour du micrologiciel. Téléchargez le firmware et obtenez les instructions d'installation ici : https://kinesis-ergo.com/support/adv360/#firmware-updates
4.0 Dispositions de programmation directe
Le 360 dispose de 9 Pro configurablesfiles, chacun avec sa propre « mise en page » correspondante (1-9). Les neuf mises en page par défaut sont enregistrées en tant que fichier .txt séparé files dans le sous-dossier « layouts » sur le v-Drive. Seuls les remappages et les macros personnalisés sont enregistrés dans le file, donc si aucune modification n'a été apportée à une mise en page, le file sera vide et le clavier effectuera des actions « par défaut ». Les utilisateurs peuvent soit écrire du code à partir de zéro, soit modifier le code existant à l'aide des règles de syntaxe décrites ci-dessous. Remarque : Suppression d'une mise en page file supprimera définitivement ses remappages et macros stockés, mais le clavier régénérera automatiquement une mise en page vierge file.
Remarque : Profile 0 n'est pas programmable et n'a donc pas de layout.txt correspondant file.
4.1 File Convention de dénomination
Seules les neuf mises en page numérotées peuvent être chargées dans l'Advantage360. Des mises en page de "sauvegarde" supplémentaires peuvent être enregistrées au format .txt files avec des noms descriptifs, mais ils ne peuvent pas être chargés sur le clavier sans les renommer au préalable.
4.2 Syntaxe terminéeview– Jetons de position et d'action
Les remappages et les macros sont encodés dans une mise en page file utilisant une syntaxe propriétaire. Chacune des touches du clavier (autre que la touche SmartSet) s'est vu attribuer un jeton de « position » unique utilisé pour identifier cette touche pour la programmation dans l'une ou l'autre couche (voir la carte des jetons de position dans l'annexe A).
Chaque action du clavier et de la souris prise en charge par le 360 s'est vu attribuer un jeton "Action" unique correspondant à un "code de numérisation" USB standard.
View actions et jetons pris en charge ici : https://kinesis-ergo.com/support/adv360/#manuals
Pour reprogrammer avec succès une clé, l'utilisateur doit utiliser la syntaxe pour désigner la clé physique (via un jeton de position) et attribuer une ou plusieurs actions à la touche (via des jetons d'action). Le symbole ">" est utilisé pour séparer les jetons de position des jetons d'action. Chaque jeton individuel est entouré de crochets. Examples:
- Les remappages sont encodés avec des crochets carrés : [position]>[action]
- Les macros sont encodées en Curly Parenthèses : {position de la touche de déclenchement}{co-déclencheur du modificateur}>{action1}{action2}…
Écrivez votre remappage sous l'en-tête de couche souhaité pour l'affecter à cette couche
4.3 Conseils de programmation de mise en page
- Si le clavier ne peut pas comprendre le remappage souhaité, l'action par défaut restera en vigueur.
- Ne pas mélanger et assortir carré et curly parenthèses dans une seule ligne de code
- Séparez chaque ligne de code avec Entrée/Retour
- L'ordre dans lequel les lignes de code apparaissent dans le .txt file n'a généralement pas d'importance, sauf en cas de commandes contradictoires, auquel cas la commande la plus proche du bas de la file sera mis en œuvre.
- Les jetons ne sont pas sensibles à la casse. Capitaliser un jeton ne produira pas l'action "décalée".
- Une ligne de code peut être temporairement désactivée en plaçant un astérisque (*) au début de la ligne.
4.4 Jetons de position
De manière générale, les jetons de position sont définis par l'action Windows QWERTY de base pour la clé dans la disposition par défaut. Dans certains cas, les jetons ont été modifiés pour plus de clarté et/ou de facilité de programmation.
- Example : La position de la touche de raccourci 1 est : [hk1]>…
4.6 Programmation des remappages
Pour programmer un remappage, encodez le jeton de position et un jeton d'action entre crochets, séparés par ">". Remapper Examples:
1. La touche de raccourci 1 exécute Q : [hk1]>[q]
2. La touche Échap exécute le verrouillage des majuscules : [esc]>[caps]
Actions décalées : Les caractères décalés (par exemple, "!") ne peuvent pas être produits par un Remap. Pour produire une action de touche décalée, il est nécessaire de l'encoder sous forme de macro qui inclut à la fois les traits bas et haut de la touche Maj entourant l'action de touche de base. Les coups vers le bas sont indiqués en plaçant un "-" à l'intérieur de la parenthèse et les coups vers le haut sont indiqués en plaçant un "+". Voir example macro 1 ci-dessous.
4.7 Macros de programmation
Pour programmer une macro, encodez les "touches de déclenchement" à gauche du ">" en curly parenthèses. Encodez ensuite un ou plusieurs jetons d'action à droite du « > » dans curly parenthèses. Chaque macro peut inclure environ 300 jetons d'action et chaque mise en page peut stocker jusqu'à 7,200 100 jetons de macro au total répartis sur XNUMX macros.
Touches de déclenchement : Toute touche non modificatrice peut déclencher une macro. Un co-déclencheur peut être ajouté en encodant un modificateur à gauche de ">". Voir example 1 ci-dessous.
Note: Les co-déclencheurs Windows ne sont pas recommandés. Écrivez votre macro sous l'en-tête de calque souhaité.
Préfixe de vitesse de lecture individuelle {s_} : Par défaut, toutes les macros sont lues à la vitesse de lecture par défaut sélectionnée. Pour attribuer une vitesse personnalisée afin d'améliorer les performances de lecture d'une macro donnée, vous pouvez utiliser le préfixe "{s_}" "Vitesse de lecture individuelle". Choisissez un nombre de 1 à 9 correspondant à l'échelle de vitesse indiquée à la section 4.6. Le préfixe de vitesse doit être placé à droite du ">" avant le contenu de la macro. Voir example 2 ci-dessous.
Préfixe multijoueur {x_} : Par défaut, toutes les macros sont lues en continu tant que la touche de déclenchement est enfoncée. Pour remplacer la fonction de répétition et restreindre la lecture d'une macro à un certain nombre de fois, vous pouvez utiliser le préfixe « Macro Multiplay » « {x_} ». Choisissez un nombre de 1 à 9 correspondant au nombre de fois que vous souhaitez que la macro soit rejouée. Le préfixe multiplay doit être placé à droite du « > » avant le contenu de la macro. Voir example 3 ci-dessous. Si une macro n'est pas lue correctement, essayez d'attribuer une valeur Multiplay de 1. La macro peut en fait être déclenchée plusieurs fois avant que vous ne relâchiez la touche de déclenchement. Voir example 3 ci-dessous
Délais : Des retards peuvent être insérés dans une macro pour améliorer les performances de lecture ou pour produire un double-clic de souris. Les retards sont disponibles dans n'importe quel intervalle entre 1 et 999 millisecondes ({d001} et {d999}), y compris les retards aléatoires ({dran}). Les jetons de retard peuvent être combinés pour produire des retards de différentes durées.
Ex macroamples:
1. La touche Pause exécute "Salut" avec un H majuscule : {pause}{rctrl}>{-lshft}{h}{+lshft}{i}
2. Le raccourci 4 + Ctrl gauche exécute "qwerty" à la vitesse 9 : {lctrl}{hk4}>{s9}{q}{w}{e}{r}{t}{y}
3. Le raccourci 1 augmente le volume de 3 crans : {hk1}>{x3}{vol+)
4.8 Actions de tapotement et de maintien
Avec Tap and Hold, vous pouvez attribuer deux actions uniques à une seule touche en fonction de la durée de la pression sur la touche. Désignez le jeton de position dans la couche appropriée, puis l'action Tap, puis le délai de temporisation de 1 à 999 millisecondes à l'aide du jeton spécial Tap and Hold ({t&hxxx}), puis l'action Hold. En raison des délais de temporisation inhérents, il n'est pas recommandé d'utiliser Tap-and-Hold avec des touches de saisie alphanumériques. Toutes les actions clés ne prennent pas en charge Tap-and-Hold.
Note: Pour la plupart des applications, nous recommandons un délai de 250 ms.
Appuyez et maintenez Example:
- Caps exécute Caps lorsque vous appuyez sur et Esc lorsqu'il est maintenu plus de 500 ms : [caps]>[caps][t&h500][esc]
5.0 LED RVB à programmation directe
Le 360 dispose de 3 LED RVB programmables sur chaque module clé. Les neuf effets d'éclairage par défaut sont enregistrés sous forme de fichier .txt séparé files dans le sous-dossier « éclairage » du v-Drive. Les affectations par défaut sont indiquées ci-dessous. Remarque : Si le file est vide, les indicateurs seront désactivés.
5.1 Définir votre indicateur
Module de clé gauche
Gauche = Verrouillage des majuscules (Activé/Désactivé)
Moyen = Profile (0-9)
Droite = Calque (Base, Kp, Fn1, Fn2, Fn3)
Module de clé droit
Gauche = Verr Num (Activé/Désactivé)
Milieu = Verrouillage du défilement (Activé/Désactivé)
Droite = Calque (Base, Kp, Fn1, Fn2, Fn3)
Les 6 indicateurs sont définis avec un jeton de position de base
- LED gauche du module gauche : [IND1]
- LED centrale du module gauche : [IND2]
- LED droite du module gauche : [IND3]
- LED gauche du module droit : [IND4]
- LED centrale du module droit : [IND5]
- Module droit Voyant droit : [IND6]
5.2 Définir votre fonction
Une variété de fonctions sont prises en charge et d'autres pourraient être ajoutées à l'avenir.
- Désactiver le voyant : [null]
- Pro actiffile: [prof]
- Verrouillage des majuscules (activé/désactivé) : [majuscules]
- Verr Num (Activé/Désactivé) : [nmlk]
- Verrouillage du défilement (Activé/Désactivé) : [sclk]
- Couche active :
- Base : [layd]
- Clavier : [layk]
- Fn : [lay1]
- Fn2 : [lay2]
- Fn3 : [pose]
5.3 Définir votre/vos couleur(s)
À l'exception de Calque, chaque fonction peut se voir attribuer une seule valeur de couleur à l'aide d'une valeur à 9 chiffres correspondant à la valeur RVB de la couleur souhaitée (0-255). La fonction Calque prend en charge l'attribution de jusqu'à 5 couleurs, une pour chaque calque.
5.4 Syntaxe
Chaque indicateur est codé de la même manière qu'un remappage de base. Utilisez le jeton de position de l'indicateur, le ">" puis la fonction, puis la couleur. Pour le Layer LED, vous devrez écrire une ligne de syntaxe distincte pour chaque couche
Annexe A — Carte des jetons de position
Documents / Ressources
 |
Moteur de programmation KINESIS KB360 SmartSet [pdf] Guide de l'utilisateur Moteur de programmation KB360 SmartSet, KB360, moteur de programmation SmartSet |
 |
Moteur de programmation KINESIS KB360 SmartSet [pdf] Guide de l'utilisateur Moteur de programmation KB360 SmartSet, KB360, Moteur de programmation SmartSet, Moteur de programmation, Moteur |
