문서의 이전 판입니다!
목차
MPINO STUDIO 2 Phase 8 · 활동바와 사이드 패널
1. 활동바와 화면 열기
활동바는 화면 왼쪽에 있는 세로 아이콘 영역입니다. 아이콘에 따라 왼쪽 사이드 패널, 화면 아래쪽 패널 또는 별도 창이 열립니다.
| 마킹 | 도구 | 열리는 위치 | 사용하는 기능 |
|---|---|---|---|
| ① | 탐색기 | 왼쪽 사이드 패널 | 프로젝트 파일, 보드, Arduino Code와 래더 탭을 확인합니다. |
| ② | 래더설정 | 왼쪽 사이드 패널 | 현재 보드의 핀 매핑과 메모리 영역을 확인합니다. |
| ③ | 래더 핀맵 설정 | 별도 창 | 현재 보드의 LD 주소와 Arduino 핀 매핑을 변경합니다. 자세한 방법은 Phase 7 · 래더 핀맵 설정에서 확인할 수 있습니다. |
| ④ | 라이브러리 | 왼쪽 사이드 패널 | 라이브러리를 검색ㆍ설치ㆍ삭제하거나 가져옵니다. |
| ⑤ | 심볼 | 이동 가능한 독립 창 | PLC 메모리 주소에 심볼과 코멘트를 등록합니다. |
| ⑥ | 시리얼 모니터 | 화면 아래쪽 패널 | 시리얼 모니터 탭을 열거나 닫습니다. 연결과 송수신 방법은 Phase 6 · 시리얼 모니터 연결에서 확인할 수 있습니다. |
| ⑦ | 설정 | 별도 창 | 프로그램 환경설정을 엽니다. 각 설정은 Phase 7 · 환경설정에서 설명합니다. |
탐색기ㆍ래더설정ㆍ라이브러리는 같은 사이드 패널 영역을 사용합니다. 닫힌 상태에서 아이콘을 누르면 해당 패널이 열리고, 다른 아이콘을 누르면 내용이 바뀝니다. 현재 선택한 아이콘을 다시 누르면 사이드 패널이 닫힙니다. Ctrl + B를 눌러도 사이드 패널을 열고 닫을 수 있습니다.
시리얼 모니터 아이콘도 같은 방식으로 동작합니다. 하단 패널이 닫혀 있으면 시리얼 모니터를 열고, 다른 하단 탭이 보이면 시리얼 모니터로 전환하며, 이미 시리얼 모니터가 선택되어 있으면 하단 패널을 닫습니다.
2. 탐색기
탐색기는 현재 프로젝트에 들어 있는 파일과 래더를 보여 줍니다. 항목을 선택하면 가운데 편집 화면도 해당 Arduino Code 또는 래더로직으로 바뀝니다.
| 마킹 | 표시 항목 | 확인하거나 실행하는 내용 |
|---|---|---|
| ① | 파일 | 현재 열려 있는 .mp2 프로젝트 파일입니다. 저장하지 않은 프로젝트는 파일 경로 대신 저장 안됨으로 표시됩니다. |
| ② | 보드 | 현재 프로젝트에서 선택한 보드입니다. |
| ③ | 보드 변경 | 다른 보드로 변경하는 창을 엽니다. 변경 후 확인할 내용은 Phase 7 · 보드 변경에서 설명합니다. |
| ④ | 코드 | Arduino Code 파일을 표시합니다. 파일명을 선택하면 해당 코드 편집 화면으로 이동합니다. |
| ⑤ | 래더 | 프로젝트의 래더로직을 표시합니다. 이름을 선택하면 해당 래더 편집 화면으로 이동합니다. |
프로젝트를 수정하고 저장하지 않으면 탐색기 제목 옆에 점이 표시됩니다. 저장하면 점이 사라집니다. 확장 모듈을 사용하는 프로젝트에서는 보드 아래에 옵션 모듈과 XㆍYㆍFㆍK 모듈 개수도 표시됩니다.
코드와 래더 오른쪽의 +는 새 항목을 만듭니다. 이름 변경ㆍ삭제ㆍ순서 변경을 포함한 파일 관리 방법은 Phase 5 · 코드 파일 생성ㆍ관리에서 확인할 수 있습니다.
3. 래더설정
래더설정은 현재 보드의 LD 주소, Arduino 핀, 메모리 사용 개수를 한곳에서 확인하는 패널입니다. 이 패널에서는 값을 직접 변경하지 않습니다.
| 마킹 | 표시 항목 | 읽는 방법 |
|---|---|---|
| ① | 현재 보드 | 핀과 메모리 정보를 읽어 온 기준 보드입니다. |
| ② | 핀 매핑 | 제목을 누르면 LDㆍArduino 핀 목록을 접거나 펼칩니다. |
| ③ | LDㆍArduino | LD는 래더에서 사용하는 주소이며 Arduino는 해당 주소에 연결된 Arduino 핀입니다. |
| ④ | 사용하지 않는 핀 | 흐리게 표시된 행은 현재 핀 매핑에서 사용이 해제된 핀입니다. |
| ⑤ | 메모리 영역 | 제목을 누르면 PㆍMㆍDㆍCㆍTㆍR 메모리 개수를 접거나 펼칩니다. |
| ⑥ | 개수ㆍ단위ㆍSRAM | 영역별 메모리 개수와 비트ㆍ워드ㆍ실수 단위를 표시합니다. 아래쪽에는 설정한 PLC 메모리의 예상 SRAM 사용량과 보드의 전체 SRAM이 표시됩니다. |
핀 매핑과 메모리 영역은 서로 따로 접고 펼칠 수 있습니다. 긴 핀 목록을 확인할 때는 메모리 영역을 접고, 메모리 개수를 확인할 때는 핀 매핑을 접으면 필요한 내용이 한 화면에 들어옵니다.
핀의 LD 주소ㆍ사용 여부를 변경하려면 활동바의 래더 핀맵 설정을 사용합니다. 편집 방법은 Phase 7 · 래더 핀맵 설정에서 확인하십시오. 메모리 개수를 변경하려면 설정 → 메모리 영역 설정을 선택합니다. 메모리 개수와 주소 범위는 Phase 2 · 메모리 영역에서 설명합니다.
4. 라이브러리
라이브러리 패널에서 온라인 라이브러리를 검색ㆍ설치하고, 설치된 라이브러리를 프로젝트에 포함하거나 폴더ㆍ소스 파일ㆍZIP 파일로 가져올 수 있습니다.
라이브러리 검색ㆍ설치
| 마킹 | 화면 항목 | 동작 |
|---|---|---|
| ① | 검색창 | 라이브러리 이름이나 검색어를 입력합니다. 입력을 멈추면 검색 결과가 갱신됩니다. |
| ② | 찾기 | 온라인 라이브러리 색인을 다시 불러옵니다. 첫 검색에서 결과가 나오지 않으면 선택합니다. |
| ③ | 필터 | 호환만 보기는 현재 보드와 호환 표시가 있는 결과만, 설치된 라이브러리는 PC에 설치된 항목만 보여 줍니다. |
| ④ | 호환 표시 | 현재 보드의 아키텍처와 라이브러리 정보를 비교한 결과입니다. |
| ⑤ | 설치ㆍ제거 | 설치하지 않은 라이브러리는 설치, 설치된 라이브러리는 제거로 표시됩니다. |
검색창에 라이브러리 이름을 입력하고 필요한 항목의 설치를 선택합니다. 설치가 끝나면 버튼이 제거로 바뀝니다. 목록이 이전 상태로 보이면 새로고침을 선택해 설치 목록과 Arduino Code 자동완성을 다시 불러옵니다.
호환 표시는 라이브러리가 제공하는 아키텍처 정보를 기준으로 한 참고 정보입니다. 호환으로 표시되어도 라이브러리가 사용하는 핀, 타이머, MCU 기능에 따라 빌드 또는 동작 결과가 달라질 수 있습니다.
설치된 라이브러리 관리ㆍ프로젝트 포함
| 마킹 | 화면 항목 | 동작 |
|---|---|---|
| ① | 설치된 라이브러리 | 검색 결과 대신 PC에 설치된 라이브러리만 표시합니다. |
| ② | 버전 | 현재 설치된 라이브러리 버전입니다. |
| ③ | 배포 | 선택한 라이브러리를 프로젝트 저장 파일에 포함합니다. |
| ④ | 보기 | 해당 라이브러리가 설치된 폴더를 엽니다. |
| ⑤ | 제거 | 사용자 라이브러리 폴더에서 해당 라이브러리를 삭제합니다. |
배포를 선택한 라이브러리는 프로젝트를 저장할 때 현재 라이브러리 폴더의 내용이 .mp2 파일에 포함됩니다. 다른 PC에서 그 프로젝트를 열면 포함된 라이브러리를 사용할 수 있습니다. 같은 이름의 라이브러리가 다른 PC의 사용자 라이브러리 폴더에 이미 있으면 그 PC에 설치된 라이브러리를 우선 사용합니다.
MPINO Studio 2가 기본으로 제공하는 라이브러리는 수신 PC에도 있으므로 배포 선택 항목을 표시하지 않습니다. 포함할 라이브러리가 많으면 프로젝트 파일도 커집니다.
사용자 라이브러리 폴더를 변경하는 방법은 Phase 7 · 환경설정의 일반 탭에서 확인할 수 있습니다.
오프라인 라이브러리 가져오기
| 마킹 | 화면 항목 | 동작 |
|---|---|---|
| ① | 라이브러리 도구 | 새로고침은 라이브러리 폴더의 변경사항을 다시 읽고, 폴더 열기는 사용자 라이브러리 폴더를 엽니다. |
| ② | 가져오기 | 가져오기 방법을 선택하는 메뉴를 엽니다. |
| ③ | 폴더에서 | library.properties와 소스 파일이 들어 있는 라이브러리 폴더를 선택합니다. |
| ④ | 파일/ZIP에서 | .h, .cpp, .c 등 개별 소스 파일 또는 ZIP 라이브러리를 선택합니다. |
| 선택한 형식 | 처리 방법 |
|---|---|
| 라이브러리 폴더 | 폴더 전체를 하나의 라이브러리로 가져옵니다. |
| 개별 소스 파일 | 선택한 파일을 묶을 라이브러리 이름을 입력한 뒤 가져옵니다. 이름에는 \ / : * ? “ < > | 문자를 사용할 수 없습니다. |
| ZIP 파일 | ZIP 안의 라이브러리 구조를 읽어 가져옵니다. 여러 ZIP은 함께 선택할 수 있습니다. |
ZIP 파일과 개별 소스 파일은 한 번에 섞어 선택할 수 없습니다. 두 형식이 함께 있다면 ZIP 파일을 먼저 가져온 뒤 파일/ZIP에서를 다시 열어 개별 소스 파일을 가져옵니다.
라이브러리 폴더에 소스 파일만 직접 복사하면 폴더 구조를 알 수 없어 빌드와 자동완성에서 제외될 수 있습니다. 이 경우 가져오기 → 파일/ZIP에서로 설치한 뒤 새로고침을 선택합니다.
5. 심볼
심볼은 PLC 메모리 주소에 붙이는 이름입니다. 예를 들어 M0에 Motor를 등록하면 래더에서 주소 대신 Motor를 표시하고, Arduino Code에서도 같은 이름으로 M0 메모리를 읽고 쓸 수 있습니다.
심볼 창
| 마킹 | 화면 항목 | 동작 |
|---|---|---|
| ① | 새 심볼 입력 | 주소ㆍ심볼ㆍ코멘트를 입력하고 추가를 선택합니다. 코멘트는 생략할 수 있습니다. |
| ② | 메모리 탭 | PㆍMㆍDㆍCㆍTㆍR 영역별 심볼을 나누어 보여 줍니다. 글자 옆 숫자는 해당 영역의 심볼 개수입니다. |
| ③ | 정렬 | 주소순과 심볼순을 전환합니다. 화면에 보이는 순서만 바뀝니다. |
| ④ | 가져오기ㆍ내보내기 | 심볼 목록을 CSV 또는 XLSX 파일로 주고받습니다. |
| ⑤ | 심볼 목록 | 주소, 심볼, 코멘트를 보여 줍니다. 각 칸을 선택하면 바로 수정할 수 있습니다. |
| ⑥ | 삭제 | 해당 행을 확인창 없이 즉시 삭제합니다. |
심볼 창은 편집 화면 위에서 이동할 수 있습니다. 활동바의 심볼을 다시 선택하면 창이 닫힙니다. 창이 열려 있어도 뒤쪽의 Arduino Code와 래더 화면을 확인하고 편집할 수 있습니다.
추가ㆍ수정ㆍ삭제
- 위쪽 입력줄에 주소, 심볼, 필요한 경우 코멘트를 입력합니다.
- 추가를 선택하거나
Enter를 누릅니다. - 등록이 끝나면 해당 주소 영역의 탭이 열리고 주소 입력칸으로 포커스가 돌아갑니다.
등록된 주소ㆍ심볼ㆍ코멘트를 선택하면 표 안에서 수정할 수 있습니다. Enter를 누르거나 다른 곳을 선택하면 적용되고, Esc를 누르면 수정 전 값으로 돌아갑니다.
삭제는 별도의 확인창 없이 바로 적용됩니다. 심볼 추가ㆍ수정ㆍ삭제와 주소 변경에 따른 래더 셀 변경은 래더 편집의 Ctrl + Z로 되돌릴 수 없습니다.
주소와 심볼 이름 규칙
| 항목 | 규칙 | 사용할 수 있는 예 | 사용할 수 없는 예 |
|---|---|---|---|
| 주소 | PㆍMㆍDㆍCㆍTㆍR 중 한 글자와 0 이상의 정수로 구성합니다. | P0, M10, D25, R3 | D0.1, WM0, A0, M-1 |
| 심볼의 첫 글자 | 문자 또는 _로 시작합니다. | Motor, _Ready, 운전중 | 1Motor, -Ready |
| 심볼 전체 | 주소와 같은 형식이거나 @로 시작하는 이름은 사용할 수 없습니다. | StartBtn, Temp_1 | M10, @ON |
| 중복 | 주소와 심볼 이름은 각각 중복할 수 없습니다. 영문 이름은 대소문자를 구분하지 않습니다. | Motor, Start | Motor와 motor를 함께 등록 |
| 마킹 | 화면 항목 | 확인 내용 |
|---|---|---|
| ① | 입력한 값 | 등록하려는 주소와 심볼을 유지하므로 잘못된 부분을 바로 수정할 수 있습니다. |
| ② | 오류 내용 | 추가하거나 수정할 수 없는 이유를 표시합니다. 오류가 있으면 해당 행을 일부만 등록하지 않습니다. |
주소 변경과 래더 반영
등록된 심볼의 주소를 변경할 때 기존 주소를 사용하는 래더 셀이 있으면 함께 변경할 셀 개수를 확인하는 창이 열립니다.
| 변경한 항목 | 적용 결과 | 확인창 |
|---|---|---|
| 심볼 이름 | 래더에 표시되는 이름이 바뀝니다. 래더 셀에 저장된 실제 주소는 유지됩니다. | 표시하지 않습니다. |
| 심볼 주소 | 심볼의 실제 메모리 주소가 바뀌고 기존 주소를 변수로 사용하는 래더 셀도 새 주소로 변경됩니다. | 영향을 받는 래더 셀이 있으면 개수를 표시합니다. |
주소 변경을 취소하면 심볼과 래더 셀 모두 기존 주소를 유지합니다. 영향을 받는 래더 셀이 없는 주소는 확인창 없이 변경됩니다.
가져오기ㆍ내보내기
| 기능 | 지원 형식 | 처리 방법 |
|---|---|---|
| 내보내기 | .xlsx, .csv | 주소ㆍ심볼ㆍ코멘트 세 열로 현재 목록을 저장합니다. |
| 가져오기 | .xlsx, .csv | 파일의 심볼 목록으로 현재 목록 전체를 교체합니다. 주소는 대문자로 변환하며 심볼과 코멘트는 입력한 글자를 유지합니다. |
가져온 파일의 한 행이라도 주소ㆍ이름 규칙을 어기거나 중복되면 가져오기 전체를 중단하고 기존 심볼 목록을 유지합니다. 기존 목록에 새 행을 추가하는 작업이 아니므로 가져오기 전에 필요한 경우 현재 목록을 먼저 내보냅니다.
래더와 Arduino Code에서 사용
래더 셀에는 실제 주소가 저장되며 심볼은 그 주소를 읽기 쉽게 표시하는 이름입니다. 따라서 심볼 이름만 바꿔도 래더의 메모리 동작은 바뀌지 않습니다.
빌드할 때 Arduino Code에서 사용할 수 있는 심볼은 다음과 같은 형식으로 연결됩니다.
// 심볼 창에서 M0 = Motor, M10 = Start로 등록 if (Start) { Motor = true; }
Arduino Code에서 사용할 심볼은 영문자 또는 _로 시작하고 나머지가 영문자ㆍ숫자ㆍ_로 구성된 C 식별자여야 합니다. C/C++ 예약어, PㆍMㆍDㆍCㆍTㆍR 메모리 배열명, setup, loop, digitalWrite 같은 Arduinoㆍ생성 함수 이름과 겹치는 심볼은 Arduino Code용 정의에서 제외됩니다. 한글이나 일본어 이름은 래더에서 사용할 수 있지만 Arduino Code에서는 실제 주소를 사용해야 합니다.
래더와 Arduino Code가 같은 메모리를 공유하는 구조는 Phase 2 · Arduino 코드와 래더 로직의 메모리 공유에서 확인할 수 있습니다.
6. 문제해결방법
| 증상 | 확인할 항목 | 해결 방법 |
|---|---|---|
| 활동바 아이콘을 눌러도 사이드 패널이 보이지 않습니다. | 같은 아이콘을 두 번 눌렀거나 Ctrl + B로 사이드 패널을 닫았는지 확인합니다. | 탐색기ㆍ래더설정ㆍ라이브러리 중 필요한 아이콘을 한 번 선택합니다. |
| 라이브러리 검색 결과가 표시되지 않습니다. | 인터넷 연결, 검색어, 호환만 보기 필터를 확인합니다. | 찾기로 색인을 갱신한 뒤 필터를 해제하고 다시 검색합니다. |
| 설치 또는 가져온 라이브러리가 목록에 없습니다. | 설치 작업이 끝났는지와 사용자 라이브러리 폴더를 확인합니다. | 새로고침을 선택해 목록과 자동완성을 다시 불러옵니다. |
| ZIP과 소스 파일을 함께 가져올 수 없습니다. | 선택한 파일에 ZIP과 .hㆍ.cpp 등이 섞여 있는지 확인합니다. | ZIP과 개별 소스 파일을 나누어 두 번 가져옵니다. |
| 심볼을 추가하거나 수정할 수 없습니다. | 심볼 창 아래쪽의 오류 내용과 주소ㆍ이름 중복을 확인합니다. | 오류가 표시된 값을 규칙에 맞게 수정한 뒤 다시 추가하거나 적용합니다. |
| 심볼 주소를 바꿀 때 래더 셀 개수가 표시됩니다. | 기존 주소를 변수로 사용하는 래더 셀의 수입니다. | 변경할 주소와 영향 범위를 확인한 뒤 변경 또는 취소를 선택합니다. |
| 심볼을 가져온 뒤 기존 목록이 바뀌었습니다. | 가져오기는 기존 목록과 합치지 않고 전체 목록을 교체합니다. | 필요한 기존 심볼을 가져올 파일에 함께 넣거나, 가져오기 전에 기존 목록을 내보냅니다. |
| Arduino Code에서 심볼 이름을 사용할 수 없습니다. | 심볼 이름이 C 식별자 형식인지, 예약어나 내장 이름과 겹치는지 확인합니다. | 영문자 또는 _로 시작하는 고유한 이름으로 변경하거나 실제 메모리 주소를 사용합니다. |
관련 문서
- Phase 2 · 메모리 이해하기 — 메모리 영역ㆍ핀 매핑ㆍ메모리 공유
- Phase 5 · Arduino Code 편집 — 코드 파일과 자동완성
- Phase 6 · 시리얼ㆍ래더 모니터링 — 하단 패널과 연결
- Phase 7 · 메뉴와 환경설정 — 보드ㆍ핀맵ㆍ프로그램 설정
- Phase 9 · 문제 해결 — 증상별 첫 확인 위치
← Phase 7 · 메뉴와 환경설정 | Phase 9 · 문제 해결 → | MPINO STUDIO 2 사용설명서로 돌아가기
