Version du document v2026.08.31.0

Premier lancement et importation¶

But¶

Vous aider à boucler un premier parcours complet : démarrer dans la bibliothèque, importer une source, l'ouvrir et revenir à la bibliothèque.

Plateformes prises en charge¶

iOS
macOS

Public visé¶

Nouveaux utilisateurs souhaitant terminer leur première boucle d’importation
Testeurs validant le comportement d'importation de la bibliothèque vers l'espace de travail

Conditions préalables¶

PCBAtlas peut déjà se lancer dans la bibliothèque
Vous disposez soit de l'un des échantillons intégrés, soit de vos propres fichiers sources de conception/fabrication prêts.

Mesures¶

Partez de la bibliothèque et choisissez Import File ou Import Folder selon la source.
Si la source est IPC-2581 XML, choisissez l’intention d’importation lorsque vous y êtes invité.
Attendez que la bannière de progression de la bibliothèque soit terminée, puis ouvrez le document résultant.
Vérifiez que les sources PCB autonomes s’ouvrent dans PCB Viewer ; que les sources de schémas et les projets KiCad contenant un schéma s’ouvrent dans Schematic Workbench ; et que les révisions sont mises à jour comme prévu.

Résultat¶

La source est importée dans la bibliothèque comme nouveau document ou nouvelle révision, puis l’espace de travail ouvre le PCB Viewer ou Schematic Workbench correspondant.

Contenu par défaut lors du premier lancement à froid¶

Lorsque la bibliothèque est vide, l'application l'alimente automatiquement avec trois exemples de documents qui peuvent être ouverts immédiatement :

h730duino (données de fabrication ODB++)
BluePhil (carte de conception KiCad)
WooKey Mainboard (projet KiCad contenant un PCB et des schémas hiérarchiques)

Si vous souhaitez simplement connaître le flux d'interaction, ouvrez d'abord l'un de ces exemples. Si vous souhaitez valider vos propres données, poursuivez le flux d'importation ci-dessous.

Chemins d'importation actuels¶

`Import File`¶

un fichier autonome DSN, KiCad .kicad_pcb, KiCad .kicad_sch ou IPC-2581 XML
un .zip KiCad ordinaire ou une archive de fabrication ODB++ / Gerber / Drill reconnue par l’application
un package de document .epcbdoc.zip compatible

N’importez pas .kicad_pro comme fichier isolé. Un projet a besoin des schémas, bibliothèques et réglages du même répertoire ; utilisez Import Folder. Un .kicad_sch autonome ne peut être importé directement que s’il ne référence pas de child sheets. Un schéma multi-sheet doit aussi être importé via son dossier de projet ; l’application ne présente pas de second sélecteur de fichiers pour compléter l’autorisation de répertoire.

`Import Folder`¶

un répertoire de projet KiCad contenant un .kicad_pro valide, y compris les projets ne contenant que des schémas

Sélection de la source dans les dossiers et archives¶

Import Folder n’accepte que les projets KiCad : PCBAtlas doit trouver un .kicad_pro valide. S’il n’existe pas de fichier de projet ou si le projet ne peut pas être rouvert, l’import échoue directement au lieu de se rabattre sur un import .kicad_pcb ou .kicad_sch. Si plusieurs projets sont trouvés, vous devez choisir explicitement ; aucun n’est choisi silencieusement. Après un import réussi, tous les fichiers ordinaires du répertoire sélectionné sont conservés dans la même révision avec leur chemin relatif d’origine, y compris les notes ou sorties de fabrication hors fermeture du projet. Un fichier illisible, un lien symbolique ou une autre entrée de répertoire non prise en charge fait échouer tout l’import, sans en enregistrer seulement une partie.

Quand vous choisissez un répertoire de projet depuis Files, iCloud Drive ou un fournisseur tiers, l’application prépare d’abord le répertoire complet comme instantané temporaire local, puis vérifie l’entrée du projet. Les répertoires historiques tels que .history restent dans la révision à leur chemin d’origine, mais leur PCB ou schéma est du matériel historique de support et ne concurrence pas le design actuel près du .kicad_pro pour l’entrée d’ouverture.

Pour un projet conservant des schémas KiCad 5 .sch, si le .kicad_pro pointe vers un .kicad_sch homonyme absent mais qu’un .sch exactement homonyme est présent, PCBAtlas reconnaît ce .sch et ses child sheets comme schéma du projet et permet le double canevas PCB/schéma. Il ne choisit pas un .sch sans rapport. Les répertoires de projets anciens ne contenant que .pro et aucun .kicad_pro restent hors de la portée prise en charge par Import Folder.

À l’ouverture d’un projet KiCad, l’application ouvre d’abord le schéma portant le même nom que le projet ; s’il n’en existe pas, elle sélectionne un schéma disponible par ordre de chemin. Un projet contenant PCB et schéma prépare deux canevas dans la même étape de progression et affiche par défaut les canevas doubles à la fin. Avec une seule source de conception, il affiche un canevas unique et le bouton de changement de canevas est indisponible.

Comportement spécial pour IPC-2581¶

Lorsque vous sélectionnez un IPC-2581 XML, l'application ne détermine pas s'il doit être traité comme des données côté conception ou côté fabrication. Au lieu de cela, il affiche une boîte de dialogue de confirmation afin que vous puissiez choisir :

importer comme données de conception
importer comme données de fabrication

Étapes recommandées¶

Cliquez sur Import File ou Import Folder sur la page d’accueil de la bibliothèque.
Utilisez Import File pour les fichiers autonomes et les archives ; utilisez Import Folder pour un répertoire complet de projet KiCad contenant .kicad_pro.
Après avoir sélectionné un fichier, s'il s'agit d'un IPC-2581 XML, choisissez l'intention d'importation.
Attendez que la bannière de progression de l'importation en haut de la bibliothèque avance.
Une fois l'importation terminée, une nouvelle fiche de document apparaît ou le nombre de révisions du document cible augmente.
Ouvrez le document et vérifiez qu’un projet contenant PCB et schéma affiche par défaut les canevas doubles ; un document n’ayant qu’une source de conception affiche un canevas unique. Vérifiez aussi que Project / Data est complet.

Import file and import folder entry points

Import progress banner with stage and percentage

Quels commentaires vous verrez¶

Le haut de la bibliothèque affiche une bannière en cours avec un titre, des détails de l'étape et un pourcentage.
À l’ouverture d’un projet, les dispositions verticales ou compactes restent sur la page de progression du Viewer. Le contenu interactif n’apparaît directement qu’une fois les canevas prêts ; l’interface ne bascule pas prématurément vers Project.
Si vous ouvrez manuellement un autre document pendant l'importation, la tâche se termine quand même, mais elle ne rétablit pas de force le focus sur le document nouvellement importé.
Si vous déposez un nouveau fichier de tableau dans l'espace de travail alors qu'un autre document est ouvert, l'application vous demande d'abord si elle doit remplacer le contenu actuel.

Après import d’un KiCad Project ou d’un schéma¶

Après import de .kicad_pro via Import Folder ou un .zip KiCad ordinaire, PCBAtlas enregistre les fichiers de projet KiCad associés dans la révision de bibliothèque et expose une page Project dans l’espace de travail. Import Folder conserve aussi les autres fichiers ordinaires du répertoire sélectionné. Le contenu est groupé sous Source Documents / Libraries / Settings pour confirmer les fichiers de carte, schémas, bibliothèques et réglages capturés. Un .kicad_sch autonome entre directement dans l’espace de travail schématique via Import File sans demander son répertoire parent.

Quand vous ouvrez un schéma, l’espace de travail utilise toujours le canevas 2D, mais le Workbench de droite passe à une structure propre aux schémas :

Sheets : inspecter la hiérarchie, le breadcrumb et les child sheets ouvrables.
Search : rechercher Symbols / Nets / Labels / Text / Markers dans Current Sheet ou Whole Project.
Selection / Details : afficher l’objet choisi depuis les résultats de recherche ou le pick du canevas.
Problems : afficher les détails de problèmes d’import, les éléments non pris en charge et les messages clairs de problème lorsque le Workbench schématique est indisponible.

Le canevas schématique permet de sélectionner symbol / pin / wire / bus / label / text / junction / marker. La sélection, les détails et la surbrillance restent synchronisés, les candidats superposés peuvent être parcourus et un objet sélectionné autre qu’un réseau est encadré par un repère orange. Lorsqu’un chemin vers le PCB est disponible, le mode à canevas unique propose Voir sur le PCB ; cette action ouvre le PCB, sélectionne si possible l’empreinte ou la pastille correspondante, sinon surligne le réseau connecté, puis ajuste la vue à la cible. La vue fractionnée conserve le cross-probe lié entre les deux canevas. Les modifications de schéma restent réservées à un outil EDA dédié.

Actions liées aux révisions¶

À partir du menu d'actions d'une fiche de document, vous pouvez :

ajouter une révision de conception
ajouter une révision de fabrication

Cela signifie que l’importation ne sert pas uniquement à créer de nouveaux documents. C'est également ainsi que l'historique des révisions en cours est conservé pour le même projet.

Règle actuelle pour la réimportation du même nom et du même format¶

Lorsqu'une source revient avec le même nom de document et le même format, l'implémentation actuelle la traite comme un autre cycle d'entrée pour le même document plutôt que de créer automatiquement une nouvelle carte de niveau supérieur :

si la source originale nouvellement importée est identique en octets à la révision actuelle, l'application signale que rien n'a changé et ignore l'importation
si la source d'origine est différente, l'application la stocke en tant que nouvelle révision sous ce document et passe à la dernière révision
les étiquettes de révision sont affichées dynamiquement sous la forme A1 / A2 / ... en fonction du nom du document

Recommandations¶

Pour une première passe de validation, commencez par un seul fichier DSN ou KiCad.
Pour les données de fabrication, vérifiez que l'archive ou le répertoire est complet avant l'importation.
Pour les mises à jour itératives du même projet, préférez ajouter des révisions plutôt que de créer plusieurs documents presque identiques.

Questions courantes¶

Pourquoi l'application demande-t-elle à nouveau après avoir sélectionné `IPC-2581` ?¶

Parce que le même IPC-2581 XML peut être traité comme des données côté conception ou côté fabrication, et l'implémentation actuelle vous demande de choisir explicitement.

Pourquoi les intentions de conception et de fabrication d’un même `IPC-2581` semblent-elles parfois presque identiques après l’importation ?¶

C'est normal dans la version actuelle. Pour IPC-2581, la principale différence aujourd'hui réside dans l'intention d'importation et la classification des documents côté bibliothèque, et non dans une différence visuelle immédiatement évidente dans l'espace de travail.

Si vous choisissez l’intention de conception, le document est géré comme un matériau côté conception.
Si vous choisissez l’intention de fabrication, le document est géré comme article côté fabrication.
Cette classification affecte le comportement de gestion ultérieur, comme le type de révision ajouté par défaut.
L’importation du même IPC-2581 avec les deux intentions crée généralement deux documents distincts au lieu de les fusionner automatiquement.

Dans le même temps, le flow d’affichage actuel n’exprime pas encore très clairement la distinction entre conception et fabrication une fois le fichier ouvert, de sorte que le résultat visible peut toujours être assez similaire.

Pourquoi le sélecteur d'importation ne répertorie-t-il pas tous les suffixes de packages de fabrication ?¶

L’importation de fabrication accepte les archives, répertoires et entrées de données générales communs. Le résultat final dépend de ce que l’importateur peut réellement reconnaître à partir de la source sélectionnée.