문서 버전 v2026.08.31.0

PDF 다운로드

처음 실행 및 가져오기¶

목표¶

라이브러리에서 시작해 자료를 가져오고, 문서를 열고, 다시 라이브러리로 돌아오는 첫 사용 흐름을 끝까지 완료합니다.

지원 플랫폼¶

iOS
macOS

대상 독자¶

첫 가져오기 흐름을 끝까지 확인하고 싶은 신규 사용자
라이브러리에서 작업 공간으로 이어지는 가져오기 동작을 검증하는 테스터

사전 준비¶

PCBAtlas가 이미 라이브러리까지 정상 실행됩니다.
내장 샘플 중 하나 또는 직접 준비한 설계/제조 프로젝트 파일이 있습니다.

단계¶

라이브러리에서 시작해 원본 자료에 맞는 Import File 또는 Import Folder를 선택합니다.
원본이 IPC-2581 XML이면, 앱이 물어볼 때 가져오기 의도를 선택합니다.
라이브러리 상단의 진행 배너가 끝날 때까지 기다린 뒤 생성된 문서를 엽니다.
독립형 PCB 원본은 PCB Viewer에서, 회로도 원본 및 회로도가 포함된 KiCad 프로젝트는 Schematic Workbench에서 열리고 리비전이 예상대로 갱신되었는지 확인합니다.

결과¶

원본 자료가 새 문서 또는 새 리비전으로 라이브러리에 들어오고, 해당 PCB Viewer 또는 Schematic Workbench에서 열립니다.

첫 실행 시 기본 샘플¶

라이브러리가 비어 있으면 앱은 바로 열어 볼 수 있는 세 개의 샘플 문서를 자동으로 준비합니다.

h730duino(ODB++ 제조 자료)
BluePhil(KiCad 설계 보드)
WooKey Mainboard(PCB와 계층 회로도를 포함한 KiCad 프로젝트)

상호작용 흐름만 익히려면 먼저 이 샘플 중 하나를 여세요. 직접 가진 데이터를 검증하려면 아래 가져오기 흐름을 이어가면 됩니다.

현재 지원되는 가져오기 경로¶

`Import File`¶

독립형 DSN, KiCad .kicad_pcb, KiCad .kicad_sch 또는 IPC-2581 XML
일반 KiCad .zip 또는 앱이 인식하는 ODB++ / Gerber / Drill 제조 아카이브
호환되는 .epcbdoc.zip 문서 패키지

.kicad_pro를 단독 파일로 가져오지 마세요. 프로젝트에는 같은 디렉터리의 회로도, 라이브러리, 설정이 필요하므로 Import Folder를 사용하세요. 독립 .kicad_sch는 하위 시트를 참조하지 않을 때만 직접 가져올 수 있습니다. 여러 시트 회로도도 프로젝트 폴더로 가져와야 하며 앱은 디렉터리 권한을 보완하려는 두 번째 파일 선택기를 표시하지 않습니다.

`Import Folder`¶

유효한 .kicad_pro가 있는 KiCad 프로젝트 디렉터리(회로도 전용 프로젝트 포함)

폴더와 아카이브의 원본 선택¶

Import Folder는 KiCad 프로젝트만 받습니다. PCBAtlas가 유효한 .kicad_pro를 찾아야 합니다. 프로젝트 파일이 없거나 프로젝트를 다시 열 수 없으면 .kicad_pcb 또는 .kicad_sch 가져오기로 폴백하지 않고 직접 오류가 납니다. 여러 프로젝트가 발견되면 자동으로 하나를 고르지 않고 명시적인 선택을 요청합니다. 성공적으로 가져오면 선택한 디렉터리의 모든 일반 파일을 원래 상대 경로로 같은 리비전에 보존하며, 프로젝트 클로저 밖의 설명 파일이나 제조 출력도 포함합니다. 읽을 수 없는 파일, 심볼릭 링크 또는 다른 지원되지 않는 디렉터리 항목이 있으면 일부만 저장하지 않고 전체 가져오기가 실패합니다.

Files, iCloud Drive 또는 타사 파일 제공자에서 프로젝트 디렉터리를 선택하면 앱은 먼저 전체 디렉터리를 로컬 임시 스냅샷으로 준비한 뒤 프로젝트 진입점을 확인합니다. .history 같은 이력 디렉터리도 원래 경로로 리비전에 남지만, 그 안의 PCB나 회로도는 이력 지원 파일일 뿐 .kicad_pro와 같은 디렉터리의 현재 설계와 열기 진입점을 경쟁하지 않습니다.

KiCad 5 .sch 회로도를 여전히 보존한 프로젝트에서 .kicad_pro가 가리키는 같은 이름의 .kicad_sch가 사라졌지만 같은 디렉터리에 정확히 같은 이름의 .sch가 있으면 PCBAtlas는 그 .sch와 하위 시트를 프로젝트 회로도로 인식하고 PCB와 회로도의 이중 캔버스를 열 수 있게 합니다. 관련 없는 .sch를 선택하지 않습니다. .kicad_pro 없이 .pro만 있는 이전 프로젝트 디렉터리는 계속 Import Folder 지원 범위 밖입니다.

KiCad 프로젝트를 열면 앱은 먼저 프로젝트와 같은 이름의 회로도를 엽니다. 같은 이름의 회로도가 없으면 경로 순서대로 사용할 수 있는 회로도를 하나 선택합니다. 프로젝트에 PCB와 회로도가 모두 있으면 같은 진행 단계에서 두 캔버스를 준비하고 완료 후 기본으로 이중 캔버스를 보여줍니다. 설계 원본이 한 종류뿐이면 단일 캔버스를 표시하며 캔버스 전환 버튼은 사용할 수 없습니다.

`IPC-2581`의 특별 동작¶

IPC-2581 XML을 선택하면 앱은 그것을 설계 쪽 데이터로 볼지 제조 쪽 데이터로 볼지 자동으로 가정하지 않습니다. 대신 확인 대화상자를 보여 주고 다음 중 하나를 선택하게 합니다.

설계 데이터로 가져오기
제조 데이터로 가져오기

어떤 피드백이 보이나요?¶

라이브러리 상단에는 제목, 단계 설명, 퍼센트를 포함한 진행 중 배너가 표시됩니다.
프로젝트를 열 때 세로 또는 컴팩트 레이아웃은 Viewer 진행 페이지를 유지합니다. 캔버스 준비가 끝난 뒤에만 직접 조작 가능한 내용을 보여 주며, 미리 Project 페이지로 전환하지 않습니다.
가져오는 동안 사용자가 다른 문서를 수동으로 열어도 작업은 계속 완료되지만, 새로 가져온 문서로 초점이 강제로 돌아가지는 않습니다.
다른 문서가 열린 상태에서 새 보드 파일을 작업 공간에 놓으면, 앱은 먼저 현재 내용을 바꿀지 묻습니다.

KiCad Project 또는 회로도를 가져온 후¶

Import Folder 또는 일반 KiCad .zip으로 .kicad_pro를 가져오면 PCBAtlas는 관련 KiCad 프로젝트 파일을 해당 라이브러리 리비전 안에 저장하고 작업 공간에 Project 페이지를 표시합니다. Import Folder는 선택한 디렉터리의 다른 일반 파일도 보존합니다. Source Documents / Libraries / Settings로 내용을 묶어 어떤 보드 파일, 회로도, 라이브러리 파일, 설정이 함께 캡처되었는지 확인할 수 있습니다. 독립 .kicad_sch는 Import File로 바로 회로도 작업 공간에 들어가며 상위 디렉터리를 추가로 요청하지 않습니다.

회로도를 열 때도 작업 공간은 2D 캔버스를 사용하지만, 오른쪽 Workbench는 회로도 전용 구조로 바뀝니다.

Sheets: 계층, 이동 경로, 열 수 있는 하위 시트를 확인합니다.
Search: Current Sheet 또는 Whole Project 범위에서 Symbols / Nets / Labels / Text / Markers를 검색합니다.
Selection / Details: 검색 결과나 캔버스 선택에서 고른 객체를 보여줍니다.
Problems: 회로도 Workbench를 사용할 수 없을 때의 명확한 문제 메시지, 지원되지 않는 내용, 가져오기 문제 세부 정보를 보여줍니다.

회로도 캔버스는 symbol / pin / wire / bus / label / text / junction / marker 선택을 지원합니다. 선택, 상세 정보, 하이라이트는 서로 동기화되고 겹친 대상은 순환해서 선택할 수 있으며, 선택한 비네트 객체에는 주황색 위치 표시 프레임이 나타납니다. PCB 경로가 있으면 단일 캔버스 모드에서 PCB에서 보기를 사용할 수 있습니다. 실행하면 PCB로 전환되고, 가능할 경우 일치하는 풋프린트나 패드를 선택하며, 그렇지 않으면 연결된 네트를 강조한 뒤 대상에 맞게 화면을 조정합니다. 분할 보기에서는 두 캔버스의 cross-probe가 연동됩니다. 레이아웃 편집은 전용 EDA 도구에서 계속 처리해야 합니다.

리비전 관련 동작¶

문서 카드의 동작 메뉴에서 다음을 할 수 있습니다.

설계 리비전 추가
제조 리비전 추가

즉 가져오기는 새 문서를 만드는 데만 쓰이지 않습니다. 같은 프로젝트의 지속적인 리비전 기록을 관리하는 방법이기도 합니다.

같은 이름과 형식을 다시 가져올 때의 현재 규칙¶

같은 문서 이름과 같은 형식의 원본이 다시 들어오면, 현재 버전은 자동으로 새 최상위 카드를 만들기보다 같은 문서에 대한 또 한 번의 입력으로 처리합니다.

새로 가져온 원본 소스가 현재 리비전과 바이트 단위로 동일하면, 앱은 변경된 내용이 없다고 알리고 가져오기를 무시합니다.
원본 소스가 다르면, 앱은 그 문서 아래 새 리비전으로 저장하고 최신 리비전으로 전환합니다.
리비전 라벨은 문서 이름을 기준으로 A1 / A2 / ...처럼 동적으로 표시됩니다.

사용 팁¶

첫 검증에는 단일 DSN 또는 KiCad 파일로 시작하세요.
제조 데이터는 가져오기 전에 압축 파일이나 디렉터리가 완전한지 확인하세요.
같은 프로젝트의 반복 업데이트에는 거의 같은 문서를 여러 개 만들기보다 리비전 추가를 권장합니다.

자주 묻는 질문¶

`IPC-2581`를 골랐는데 왜 다시 한 번 묻나요?¶

같은 IPC-2581 XML도 설계 쪽 데이터 또는 제조 쪽 데이터로 다룰 수 있기 때문에, 현재 버전은 사용자가 명시적으로 선택하도록 합니다.

같은 `IPC-2581`에 설계 의도와 제조 의도를 선택했는데 화면 차이가 거의 없어요.¶

현재 버전에서는 정상적인 동작입니다. IPC-2581에서 오늘의 주요 차이는 작업 공간에서 즉시 보이는 시각 차이보다, 라이브러리 쪽 가져오기 의도와 문서 분류에 있습니다.

설계 의도를 선택하면 문서는 설계 쪽 자료로 관리됩니다.
제조 의도를 선택하면 문서는 제조 쪽 자료로 관리됩니다.
이 분류는 이후 기본 리비전 추가 유형 같은 관리 동작에 영향을 줍니다.
같은 IPC-2581을 두 의도로 가져오면 보통 자동 병합되지 않고 별도 문서가 만들어집니다.

동시에 현재 표시 동작은 파일을 연 뒤 설계/제조의 차이를 아직 강하게 드러내지 않으므로, 눈에 보이는 결과는 꽤 비슷할 수 있습니다.

가져오기 선택기가 모든 제조 패키지 확장자를 나열하지 않는 이유는 무엇인가요?¶

제조 데이터 가져오기는 일반적인 압축 파일, 디렉터리, 데이터 입력을 받습니다. 최종 결과는 선택한 원본에서 앱이 실제로 무엇을 인식할 수 있는지에 따라 달라집니다.