Cartes
Les commandes pour les cartes, les périphériques et leurs broches.
Commandes : archec board · archec device · archec pins
Les cartes connues sont celles du store fourni avec archec (arche-hw-store : ESP32, STM32 Nucleo, Raspberry Pi Pico et Pi, nRF52840 DK, Jetson Orin Nano, Kria KR260) et celles de vos propres collections. Ces collections sont cherchées dans les libraries du projet, dans ARCHE_BOARDS (une liste de chemins, que fixe le réglage arche.boardCollections de VS Code) et à côté d’archec. Une carte est un composant de kind board. Elle déclare son product { vendor; part-number; url }, ses processeurs (compute { hal …; chip "…" }) et ses connecteurs avec leurs broches (pins { tx PA12; rx PA11 }). Un binaire on une carte tourne sur son processeur, et archec gen --target embassy pilote le contrôleur CAN sur les broches de la carte. Voir le store de cartes.
| Commande | Ce qu’elle fait |
|---|---|
archec device list [--family i2c] [--displays] [--json] · archec device show <device> · archec device add <main.arche> <device> [--to <board>.<port>] [--as <part>] [--into <System>] [--dry-run] |
Les périphériques du store matériel (capteurs, écrans, moteurs… : devices/ de lib/arche-hw-store), avec leur bus, leur adresse, leurs mesures et leur driver Go. --displays liste les écrans — ILI9341, ST7789, SSD1306, HDMI — avec la taille, la densité et l’entrée qu’une ui en reçoit (ui.md). add écrit le uses, l’include, la part dans la plateforme et, avec --to, son lien vers le port de la carte. Le tout n’est gardé que si le projet se construit comme avant. |
archec board list [<main.arche>] [--json] |
Toutes les cartes de toutes les collections que voit le projet (ou cette machine) : leurs processeurs, leur HAL et leurs connecteurs. |
archec board show <board> [<main.arche>] |
Une carte, désignée par son id (nucleo-g474re), sa définition (NucleoG474RE) ou collection/id : ce qu’elle est, ses processeurs, ses connecteurs et leurs broches. |
archec board picture <board> | <main.arche> [--system <System>] [-o <file.svg>] |
Une image de carte en SVG : son contour, son processeur, ses barrettes et ses connecteurs, chaque port numéroté avec sa fonction et ses broches. À partir d’un modèle : le matériel de chaque système qui contient des cartes, c’est-à-dire ses cartes, ses périphériques et ses bus, câblés comme le disent ses liens (--system pour un seul ; avec -o, un fichier par système). Les diagrammes « Hardware » du playground sont ces images. |
archec board add <main.arche> <board> [--copy] [--as <part>] [--into <System>] [--dry-run] |
Ajoute la carte au projet : uses sur sa collection (et libraries pour une collection à vous), include de son fichier, et une part dans la plateforme. La plateforme est le système que nomme un déploiement, sinon celui qu’a créé board add, sinon un nouveau system <Project>Hw. --copy copie plutôt son dossier dans components/. Rien n’est écrit si le projet ne se construit pas aussi bien qu’avant. |
archec board new <id> --in <folder> [--from <board>] [--name "…"] [--vendor "…"] |
Une carte à vous dans une collection (son library.arche est créé si le dossier n’en est pas encore une). Elle part d’un modèle, ou d’une copie d’une autre carte à adapter. |
archec board check [<folder>] |
Vérifie une collection (par défaut, le store) : chaque carte se construit seule, ses processeurs indiquent hal et chip (ou os), ses broches sont des broches de sa puce et son image est présente. Code de sortie 1 en cas d’erreur. |
archec pins <main.arche> [System] [--json] |
Le plan de broches de chaque carte : chaque broche qu’utilisent ses connecteurs, le port et son rôle, l’endroit où le port est relié, son level, et si la part l’a écrit. Viennent ensuite les avertissements du plan de broches (pin-conflict, pin-function, pin-pair, pin-level, board-pin). Code de sortie 1 s’il y en a un. Voir les cartes. |
archec board extract <main.arche> <Def|System.part> --in <folder> [--id <id>] |
Une carte définie dans le modèle, copiée avec son image dans votre collection. Ce qu’elle utilise du projet est signalé. |