Mode d’emploi The MOLLUSK
CREDITS ET REMERCIEMENTS
Rédaction + création : Arnoz
Basé sur le travail de MJR : http://mjrnet.org/pinscape/
Merci de ne pas copier ou publier ce document sans l’autorisation préalable de l’auteur.
PRESENTATION DE LA CARTE :
a – The MOLLUSK
Cette carte est une carte d’extension qui permet d’ajouter des ports PWM à une KL25Z sous Pinscape.
Elle est conçu pour recevoir des cartes « filles » qui gèreront la puissance. les cartes peuvent se chainer pour multiplier le nombre de sorties disponible.
IMPORTANT : On ne branchera JAMAIS au grand JAMAIS de toys directement en sortie de MOLLUSK, il faut toujours passer par des cartes filles, sous risque de tout péter !!!
Elle utilise 4 sorties digitales et 1 sortie PWM, ainsi qu’un 5V et qu’une masse commune à la KL25Z.
Elle permet d’ajouter 16 sorties PWM à la KL25Z, et les cartes peuvent se connecter les unes à la suite des autres pour ainsi ajouter autant de sorties PWM que l’on veut, en utilisant seulement les 5 câbles sur la KL25Z .
Chaque sortie passe par un optocoupleur pour bien séparer les signaux électriques de commande et de puissance.
On viendra brancher sur les 16 sorties disponible des cartes filles comme la MOS4 ou la MOS’LIGHT, qui se chargeront de gérer la puissance et ainsi piloter vos toys.
La commande de la carte s’effectuant à l’aide de 7 fils de signaux, il est intéressant de noter que l’on peut éloigner la carte d’extension de la KL25Z jusqu’à l’autre bout du Pincab avec son alimentation dédiée grâce à seulement 7 petits câbles, et ainsi réduire les longueurs de câble puissance et regrouper tout cela ou bon vous semble, et même à plusieurs endroits stratégiques dans votre Pincab, car il est de même pour la liaison entre 2 cartes d’extension.
Elle dispose de 16 sorties en ligne (2*8) sur prise numérotés de 1 à 16.
Je vous conseille de visionner cette vidéo de présentation pour éclaircir tout ça ….
1 – INSTALLATION DES CARTES :
a – Câblage des cartes
Avant tout, cette carte ne gère QUE LE COURANT CONTINU, ne branchez aucune tension alternative dessus, jamais, même sous la menace !)
Câblez toujours hors tension, une fois le câblage effectué, vérifiez-le scrupuleusement une première fois, faites une pause de quelques minutes, et revérifiez votre câblage. La première cause d’erreur reste l’humain !
Toutes les tensions données dans ce document sont en courant continu DC
Commençons par la partie commande.
Celle-ci possède plusieurs connecteurs.
Le Data in (Prise 7 pins) c’est ici que nous faisons la connexion sur la KL25Z
Le Data out (Prise 7 pins) qui permet de relier la MOLLUSK ou carte d’extension suivante si on désire en rajouter
L’Alim 12V (2 pins) que nous devons raccorder au +12V et au GND de l’alimentation des toys (pas besoin d’une grosse section de fil, du AWG 28 suffit)
Les sorties 1 à 16 ou nous raccorderons les entrées des cartes filles.
DATA IN
Pour la partie Data in, j’ai choisi 5 sorties sur la KL25Z, mais une fois ce mode d’emploi terminé, vous pourrez modifier la configuration pour câbler la carte sur d’autres sorties.
Pour ce qui est du +5V et du GND, vous pouvez au choix les prendre sur l’alimentation du PC où est branché votre KL25Z, soit directement sur la KL25Z (le deuxième choix est préférable à mon sens)
Pour plus de simplicité, je vous invites à utiliser mon KL SHIELD ou toutes les connections sont repérées pour l’utilisation de la Master of Mosfets.
GSCLK → PTA13 (une sortie PWM)
SCLK → PTC5 (SPI SCLK PTC5 ou PTD1)
Sin → PTC6 (SPI MOSI PTC6 ou PTD2)
XLAT → PTC10 (une sortie digitale)
BLANK → PTC11 (une sortie digitale)
+5V KL → P5V_USB (5V KL)
GND KL → GND (GND KL)
DATA OUT
Si vous avez une carte d’extension à la suite de celle-ci, vous reliez les 2 cartes entre elles simplement comme cela :
GSCLK → GSCLK
SCLK → SCLK
Sout → Sin
XLAT → XLAT
BLANK → BLANK
+5V KL → +5V KL
GND KL → GND KL
ALIM TOYS
Veuillez simplement relier le +12V et le GND à votre alimentation 12V Toys
Attention !
Ne jamais connecter ici de +12v ou de GND qui viendrais de la KL25Z ou de l’alimentation du PC du pincab, cela aurait pour effet d’annuler la protection optoélectronique
OUT
Veuillez relier chacune des 16 sorties à l’entrée de votre carte fille (cables de pilotage).
Du cable AWG28 est très bien pour ça
b – Partie logiciel
Regardons maintenant du côté de la programmation de la carte
Premièrement, votre KL25Z doit être flashée avec le dernier Firmware (0605 version du 05/03/2019 minimum) et vous devez avoir installés au minimum DirectOutput V3.1.7011.27968 built 2019.03.13 .
Plus d’infos sur ce lien : http://mjrnet.org/pinscape/BuildGuideV2/BuildGuide.php?custom=EU&expver=R3.201602xx&sid=DOF
Pour que votre KL25Z puisse utiliser ces sorties, vous devez déjà la déclarer et la configurer dans le Pinscape Config Tool, cela vous permettra aussi de savoir ou brancher les fils sur la KL.
Lancez le Pinscape config tool
allez dans SETUP comme pour configurer votre KL, en descendant un peu vous allez tomber sur TLC5940 Setup, dans « Number of TCL » renseignez le nombre de carte d’extension que vous branchez sur la KL (dans mon cas je branche 2 cartes d’extension), puis choisissez les pins à connecter sur les différentes entrées de la carte d’extension, Choisissez dans un premier temps les mêmes pins que moi, plus tard si vous le souhaitez-vous pourrez changer la configuration comme bon vous semble.
Le « SI Output » sera relié au SIn sur la carte d’extension (Signal OUTPUT que l’on branche dans Signal INPUT)
Le reste c’est la même dénomination.
Si vous rajoutez une ou plusieurs cartes d’extension, et bien vous changez juste le nombre de TLC, le reste de la config ne bouge pas.
Ensuite allez dans la partie où l’on configure les sortie, et la, Oh surprise, un nouvel élément est disponible dans le menu à droite (TLC5940 OUT), cliquez dessus, vous verrez apparaître vos nouvelles sorties. Si vous avez plusieurs cartes, vous aurez autant de « chip » de disponibles.
Si jamais vous voyez apparaitre un point d’exclamation rouge à coté d’une sortie, c’est que vous avez assignés cette dernière à deux endroits différents, veuillez corriger cela sinon cela ne fonctionnera pas.
Assignez ces sorties sur vos toys, vous le faites pour les sorties de la KL25Z en temps habituel. Comme vous le voyez ci-dessous, on peut avoir plus de 32 sorties, et nous pouvons câbler les sorties dans l’ordre qui nous arrange.
Notez bien à quel toy correspond chaque sortie, sauvegardez tout ça en cliquant sur « PROGRAM KL25Z » en bas, faites un backup de la config, puis allez faire votre DOF et téléchargez les fichier Directoutput config.
Pour utiliser plus de 32 sorties avec notre montage, nous n’allons plus déclarer une KL25Z
dans la partie « account » du DOF CONFIG TOOL, mais une Pinscape Device (dans l’absolu, la KL25 tourne sous PINSCAPE, nous devrions toujours déclarer comme ceci)
Et là nous nous retrouvons avec 128 sorties disponibles dans la partie « Port Assignments ».
Bien sûr, si vous n’avez qu’une carte, vous pourrez utiliser les 16 sortie de cette dernière plus les sorties de la KL (digitales ou autres PWM). Renseignez les toys selon leurs sorties déclarées dans Pinscape config tool.
Avantage des sorties PWM pour gérer des contacteurs, shaker, et autres LED…
Utiliser des sorties PWM sur nos toys à un avantage, on peut depuis le DOF faire varier les tensions maximales que l’on applique à nos toys, cela permet par exemple si les LEDs de votre backboard sont trop puissante de les limiter de façon logicielle (sans devoir aller bricoler l’alim pour baisser sa tension), de faire sonner différemment des contacteurs ou des solénoïdes en les alimentant un peu moins, de limiter la vitesse maximale d’un shaker
Tout ça se passe dans le DOF config tool, dans la fenêtre ou vous assignez vos toys, sur la droite il y a ça
SHAKER MOTOR sert à gérer les vitesse minimum et maximum du shaker, rentrer une valeur dans min et max pour définir ces dernières.
FAN permet la même chose, mais pour le ventilateur.
Custom Brightness sert à gérer le niveau max des lumières, pareil on rentre ici la valeur max désiré pour le Strobe, le PF Strob MX (strob sur led adressable teensy/wemos), les flasher (les LED RGB du backboard) et Ledstrip Flasher (les bandeaux RGB undercab et derrière le backglass)