Versi Dokumen v2026.08.31.0

Peluncuran pertama dan impor¶

Target halaman¶

Membantu Anda menyelesaikan loop tertutup penggunaan pertama: mulai dari database, mengimpor data, membuka ruang kerja, lalu kembali ke database.

Platform yang didukung¶

iOS/iPadOS: 17.0 atau lebih tinggi.
macOS: 14 atau lebih tinggi.

Siapa yang harus membacanya?¶

Pengguna baru yang ingin menyelesaikan proses impor pertama
Penguji yang perlu memverifikasi perilaku impor repositori ke ruang kerja

Kondisi persiapan¶

PCBAtlas sudah bisa masuk database
Anda memiliki contoh bawaan, atau telah menyiapkan file proyek desain/manufaktur Anda sendiri

Langkah operasi¶

Mulai dari pustaka, lalu pilih Import File atau Import Folder sesuai sumbernya.
Jika sumbernya adalah IPC-2581 XML, pilih maksud impor saat diminta.
Tunggu hingga proses impor di bagian atas perpustakaan selesai sebelum membuka dokumen yang dihasilkan.
Pastikan sumber PCB mandiri terbuka di PCB Viewer; sumber skema dan proyek KiCad yang berisi skema terbuka di Schematic Workbench; serta revisinya diperbarui sesuai harapan.

hasil¶

Sumber diimpor ke pustaka sebagai dokumen atau revisi baru, lalu ruang kerja membuka PCB Viewer atau Schematic Workbench yang sesuai.

Data default untuk start dingin pertama¶

Ketika database kosong, aplikasi secara otomatis akan menambahkan tiga contoh dokumen yang dapat langsung dibuka:

h730duino (data manufaktur ODB++)
BluePhil (papan desain KiCad)
WooKey Mainboard (proyek KiCad yang berisi PCB dan skema hierarkis)

Jika Anda baru familiar dengan interaksinya, Anda bisa memulai dengan membuka salah satu contohnya. Jika Anda ingin memverifikasi informasi Anda, silakan lanjutkan dengan proses impor di bawah.

Jalur impor yang saat ini didukung¶

`Import File`¶

file mandiri DSN, KiCad .kicad_pcb, KiCad .kicad_sch, atau IPC-2581 XML
.zip KiCad biasa atau arsip manufaktur ODB++ / Gerber / Drill yang dikenali aplikasi
paket dokumen .epcbdoc.zip yang kompatibel

Jangan impor .kicad_pro sebagai file terpisah. Proyek memerlukan skema, pustaka, dan pengaturan di direktori yang sama; gunakan Import Folder. .kicad_sch mandiri hanya dapat diimpor langsung jika tidak mereferensikan child sheet. Skema multi-sheet juga harus diimpor lewat folder proyek; aplikasi tidak membuka pemilih file kedua untuk melengkapi izin direktori.

`Import Folder`¶

direktori proyek KiCad dengan .kicad_pro yang valid, termasuk proyek yang hanya berisi skema

Pemilihan sumber dalam folder dan arsip¶

Import Folder hanya menerima proyek KiCad: PCBAtlas harus menemukan .kicad_pro yang valid. Jika tidak ada berkas proyek atau proyek tidak dapat dibuka kembali, impor gagal langsung tanpa fallback ke impor .kicad_pcb atau .kicad_sch. Jika ada beberapa proyek, aplikasi meminta pilihan eksplisit dan tidak memilih diam-diam. Setelah impor berhasil, semua berkas reguler di direktori yang dipilih dipertahankan dalam revisi yang sama dengan jalur relatif aslinya, termasuk catatan atau keluaran manufaktur di luar penutupan proyek. Berkas tidak dapat dibaca, symlink, atau entri direktori yang tidak didukung membuat seluruh impor gagal, bukan hanya menyimpan sebagian.

Saat memilih direktori proyek dari Files, iCloud Drive, atau penyedia berkas pihak ketiga, aplikasi terlebih dahulu menyiapkan direktori lengkap sebagai snapshot sementara lokal lalu memeriksa entri proyek. Direktori riwayat seperti .history tetap tersimpan dalam revisi di jalur aslinya, tetapi PCB atau skema di dalamnya hanya materi pendukung historis dan tidak bersaing dengan desain saat ini di samping .kicad_pro untuk entri pembukaan.

Untuk proyek yang masih menggunakan skema KiCad 5 .sch, jika .kicad_pro menunjuk ke .kicad_sch bernama sama yang sudah tidak ada tetapi terdapat .sch dengan nama yang persis sama di direktori, PCBAtlas mengenali .sch tersebut dan child sheet-nya sebagai skema proyek dan dapat membuka kanvas ganda PCB/skema. Aplikasi tidak memilih .sch yang tidak terkait. Direktori proyek lama yang hanya memiliki .pro tanpa .kicad_pro tetap di luar cakupan dukungan Import Folder.

Saat membuka proyek KiCad, aplikasi terlebih dahulu membuka skema dengan nama yang sama dengan proyek; jika tidak ada, aplikasi memilih skema yang tersedia berdasarkan urutan jalur. Proyek dengan PCB dan skema menyiapkan dua kanvas pada tahap kemajuan yang sama dan secara default menampilkan kanvas ganda ketika siap. Satu jenis sumber desain hanya menampilkan kanvas tunggal dan tombol ganti kanvas tidak tersedia.

Perilaku khusus IPC-2581¶

Setelah memilih IPC-2581 XML, aplikasi tidak akan otomatis menebak apakah harus diproses sebagai data desain atau data manufaktur. Sebaliknya, kotak konfirmasi akan muncul sehingga Anda dapat memilih:

Impor sebagai Data Desain
Impor sebagai Data Manufaktur

Langkah yang disarankan¶

Klik Import File atau Import Folder di beranda pustaka.
Gunakan Import File untuk file mandiri dan arsip; gunakan Import Folder untuk direktori proyek KiCad lengkap yang berisi .kicad_pro.
Setelah memilih file, jika IPC-2581 XML, lalu pilih maksud impor.
Tunggu hingga bilah kemajuan impor di bagian atas database bergerak maju.
Setelah impor selesai, akan muncul kartu dokumen baru, atau jumlah revisi dokumen target akan bertambah.
Buka dokumen dan pastikan proyek dengan PCB dan skema secara default menampilkan kanvas ganda; dokumen dengan satu sumber desain menampilkan kanvas tunggal. Pastikan juga konten Project / Data lengkap.

Import file and import folder entry points

Import progress banner with stage and percentage

Masukan apa yang akan Anda lihat?¶

Spanduk pengimpor akan muncul di bagian atas perpustakaan dengan judul, detail tahapan, dan persentase.
Saat membuka proyek, tata letak potret atau ringkas tetap berada di halaman kemajuan Viewer. Konten interaktif hanya ditampilkan langsung setelah kanvas siap; antarmuka tidak beralih lebih awal ke Project.
Jika Anda membuka dokumen lain secara manual selama proses impor, impor akan tetap selesai, namun fokus tidak akan dipaksa kembali ke dokumen yang baru diimpor setelah selesai.
Jika Anda menyeret file papan baru ke ruang kerja saat dokumen yang ada terbuka, aplikasi akan menanyakan apakah akan mengganti konten saat ini.

Setelah mengimpor Proyek atau skema KiCad¶

Setelah mengimpor .kicad_pro melalui Import Folder atau .zip KiCad biasa, PCBAtlas menyimpan file proyek KiCad terkait dalam revisi pustaka dan menyediakan halaman Project di ruang kerja. Import Folder juga mempertahankan berkas reguler lain dalam direktori yang dipilih. Konten dikelompokkan sebagai Source Documents / Libraries / Settings, sehingga file papan, skema, pustaka, dan pengaturan dapat diperiksa. .kicad_sch mandiri masuk langsung ke ruang kerja skema melalui Import File tanpa meminta direktori induknya.

Saat membuka skema, ruang kerja masih menggunakan kanvas 2D, namun Meja Kerja di sebelah kanan akan beralih ke struktur khusus skema:

Sheets: Melihat hierarki, remah roti, dan sublembar yang dapat dibuka.
Search: Cari Symbols / Nets / Labels / Text / Markers di Current Sheet atau Whole Project.
Selection / Details : Menampilkan objek yang diperoleh dari hasil pencarian atau klik kanvas.
Problems: Menampilkan masalah impor, konten yang tidak didukung untuk sementara, dan alasan yang jelas mengapa meja kerja skema tidak tersedia.

Kanvas skema mendukung pemilihan symbol / pin / wire / bus / label / text / junction / marker. Pilihan, detail, dan sorotan tetap sinkron, target yang bertumpuk dapat digilir, dan objek non-net yang dipilih diberi bingkai penunjuk oranye. Jika tersedia jalur ke PCB, mode kanvas tunggal menampilkan Lihat di PCB; tindakan ini beralih ke PCB, memilih footprint atau pad yang cocok bila memungkinkan, jika tidak menyorot net yang terhubung, lalu menyesuaikan tampilan ke target. Tampilan terbagi mempertahankan cross-probe yang tertaut di kedua kanvas. Pengeditan tata letak tetap dilakukan di alat EDA khusus.

Operasi terkait revisi¶

Di menu tindakan kartu dokumen, Anda dapat:

Revisi desain tambahan
Revisi Manufaktur Tambahan

Oleh karena itu, impor tidak hanya menjadi pintu masuk pembuatan dokumen baru, tetapi juga cara untuk menjaga sejarah revisi selanjutnya dari proyek yang sama.

Aturan saat ini untuk impor berulang dengan nama dan format yang sama¶

Ketika materi sumber diimpor lagi menggunakan nama dokumen yang sama dan format yang sama, versi saat ini akan memperlakukannya sebagai masukan lain dari dokumen yang sama, bukan secara otomatis membuat kartu tingkat atas baru:

Jika sumber asli yang baru diimpor byte identik dengan revisi saat ini, aplikasi akan meminta agar tidak ada perubahan dan mengabaikan impor ini.
Jika sumber aslinya berbeda, aplikasi akan menyimpannya sebagai revisi baru di bawah dokumen dan beralih ke revisi terbaru
Label revisi akan ditampilkan secara dinamis sebagai A1 / A2 / ... berdasarkan nama dokumen

Saran penggunaan¶

Saat memverifikasi untuk pertama kalinya, mulailah dengan satu file DSN atau KiCad.
Untuk data pembuatan, konfirmasikan bahwa isi paket atau direktori terkompresi sudah lengkap sebelum mengimpor.
Ketika proyek yang sama diperbarui berulang kali, berikan prioritas untuk menambahkan revisi dan jangan membuat beberapa dokumen yang hampir identik.

Pertanyaan Umum¶

Mengapa sistem bertanya lagi setelah memilih `IPC-2581`?¶

Karena IPC-2581 XML yang sama dapat digunakan sebagai data sisi desain atau data sisi manufaktur. Versi saat ini mengharuskan Anda membuat pilihan eksplisit.

Mengapa `IPC-2581` yang sama terlihat hampir sama setelah memilih maksud desain dan manufaktur?¶

Ini adalah perilaku normal untuk versi saat ini. Untuk IPC-2581, perbedaan utamanya sekarang adalah maksud impor dan klasifikasi dokumen di sisi database, bukan perbedaan visual yang langsung terlihat di ruang kerja.

Saat memilih maksud desain, dokumen akan dikelola sebagai data sisi desain.
Saat memilih maksud manufaktur, dokumen akan dikelola sebagai data sisi manufaktur.
Klasifikasi ini memengaruhi perilaku pengelolaan selanjutnya, seperti jenis revisi tambahan default.
Ketika IPC-2581 yang sama diimpor dengan kedua maksud, dua dokumen terpisah biasanya dibuat alih-alih digabungkan secara otomatis.

Pada saat yang sama, perilaku tampilan saat ini belum menunjukkan perbedaan klasifikasi desain/manufaktur secara jelas, sehingga hasil yang terlihat setelah pembukaan mungkin masih serupa.

Mengapa pemilih impor tidak mencantumkan akhiran setiap paket produksi?¶

Impor manufaktur menerima arsip umum, direktori, dan masukan data umum. Hasil akhir bergantung pada kemampuan aplikasi untuk mengidentifikasi struktur paket manufaktur yang didukung dari sumber yang dipilih.