====== MPINO STUDIO 2 Phase 8 · 활동바와 사이드 패널 ======

활동바에서 탐색기ㆍ래더설정ㆍ라이브러리ㆍ심볼을 열고 사용하는 방법을 설명합니다.

{{ :products:mpino_studio2:activity-bar-learning-path.svg?1000 |활동바와 사이드 패널 이해 순서 }}

===== 1. 활동바에서 화면 열기 =====

활동바는 화면 왼쪽에 있는 세로 아이콘 영역입니다. 아이콘에 따라 왼쪽 사이드 패널, 화면 아래쪽 패널 또는 별도 창이 열립니다.

{{ :products:mpino_studio2:activity-bar-marked.svg?1000 |탐색기부터 설정까지 7개 활동바 아이콘 }}

^ 마킹 ^ 도구 ^ 열리는 위치 ^ 사용하는 기능 ^
| **①** | 탐색기 | 왼쪽 사이드 패널 | 프로젝트 파일, 보드, Arduino Code와 래더 탭을 확인합니다. |
| **②** | 래더설정 | 왼쪽 사이드 패널 | 현재 보드의 핀 매핑과 메모리 영역을 확인합니다. |
| **③** | 래더 핀맵 설정 | 별도 창 | 현재 보드의 LD 주소와 Arduino 핀 매핑을 변경합니다. 자세한 방법은 [[products:mpino_studio2:menus_settings#래더_핀맵_설정|Phase 7 · 래더 핀맵 설정]]에서 확인할 수 있습니다. |
| **④** | 라이브러리 | 왼쪽 사이드 패널 | 라이브러리를 검색ㆍ설치ㆍ삭제하거나 가져옵니다. |
| **⑤** | 심볼 | 이동 가능한 독립 창 | PLC 메모리 주소에 심볼과 코멘트를 등록합니다. |
| **⑥** | 시리얼 모니터 | 화면 아래쪽 패널 | 시리얼 모니터 탭을 열거나 닫습니다. 연결과 송수신 방법은 [[products:mpino_studio2:monitoring#시리얼_모니터_연결|Phase 6 · 시리얼 모니터 연결]]에서 확인할 수 있습니다. |
| **⑦** | 설정 | 별도 창 | 프로그램 환경설정을 엽니다. 각 설정은 [[products:mpino_studio2:menus_settings#환경설정|Phase 7 · 환경설정]]에서 설명합니다. |

탐색기ㆍ래더설정ㆍ라이브러리는 같은 사이드 패널 영역을 사용합니다. 닫힌 상태에서 아이콘을 누르면 해당 패널이 열리고, 다른 아이콘을 누르면 내용이 바뀝니다. 현재 선택한 아이콘을 다시 누르면 사이드 패널이 닫힙니다. ''Ctrl + B''를 눌러도 사이드 패널을 열고 닫을 수 있습니다.

시리얼 모니터 아이콘도 같은 방식으로 동작합니다. 하단 패널이 닫혀 있으면 시리얼 모니터를 열고, 다른 하단 탭이 보이면 시리얼 모니터로 전환하며, 이미 시리얼 모니터가 선택되어 있으면 하단 패널을 닫습니다.

===== 2. 탐색기 =====

탐색기는 현재 프로젝트에 들어 있는 파일과 래더를 보여 줍니다. 항목을 선택하면 가운데 편집 화면도 해당 Arduino Code 또는 래더로직으로 바뀝니다.

{{ :products:mpino_studio2:explorer-panel-marked.svg?1000 |프로젝트 파일과 보드, Code와 Ladder가 표시된 탐색기 }}

^ 마킹 ^ 표시 항목 ^ 확인하거나 실행하는 내용 ^
| **①** | 파일 | 현재 열려 있는 ''.mp2'' 프로젝트의 파일 이름입니다. 저장 전에는 **Untitled**로 표시됩니다. |
| **②** | 보드 | 현재 프로젝트에서 선택한 보드입니다. |
| **③** | 보드 변경 | 다른 보드로 변경하는 창을 엽니다. 변경 후 확인할 내용은 [[products:mpino_studio2:menus_settings#보드_변경|Phase 7 · 보드 변경]]에서 설명합니다. |
| **④** | 코드 | Arduino Code 파일을 표시합니다. 파일명을 선택하면 해당 코드 편집 화면으로 이동합니다. |
| **⑤** | 래더 | 프로젝트의 래더로직을 표시합니다. 이름을 선택하면 해당 래더 편집 화면으로 이동합니다. |

프로젝트를 수정하고 저장하지 않으면 탐색기 제목 옆에 점이 표시됩니다. 저장하면 점이 사라집니다. 확장 모듈을 사용하는 프로젝트에서는 **보드** 아래에 **옵션 모듈**과 XㆍYㆍFㆍK 모듈 개수도 표시됩니다.

**코드**와 **래더** 오른쪽의 ''+''는 새 항목을 만듭니다. 이름 변경ㆍ삭제ㆍ순서 변경을 포함한 파일 관리 방법은 [[products:mpino_studio2:code_editor#코드_파일_생성ㆍ관리|Phase 5 · 코드 파일 생성ㆍ관리]]에서 확인할 수 있습니다.

===== 3. 래더설정 =====

래더설정은 현재 보드의 LD 주소, Arduino 핀, 메모리 사용 개수를 한곳에서 확인하는 패널입니다. 이 패널에서는 값을 직접 변경하지 않습니다.

{{ :products:mpino_studio2:ladder-settings-panel-marked.svg?1000 |핀 매핑과 메모리 영역을 표시한 래더설정 패널 }}

^ 마킹 ^ 표시 항목 ^ 읽는 방법 ^
| **①** | 현재 보드 | 핀과 메모리 정보를 읽어 온 기준 보드입니다. |
| **②** | 핀 매핑 | 제목을 누르면 LDㆍArduino 핀 목록을 접거나 펼칩니다. |
| **③** | LDㆍArduino | **LD**는 래더에서 사용하는 주소이며 **Arduino**는 해당 주소에 연결된 Arduino 핀입니다. |
| **④** | 사용하지 않는 핀 | 흐리게 표시된 행은 현재 핀 매핑에서 **사용**이 해제된 핀입니다. |
| **⑤** | 메모리 영역 | 제목을 누르면 PㆍMㆍDㆍCㆍTㆍR 메모리 개수를 접거나 펼칩니다. |
| **⑥** | 개수ㆍ단위ㆍSRAM | 영역별 메모리 개수와 비트ㆍ워드ㆍ실수 단위를 표시합니다. 아래쪽에는 설정한 PLC 메모리의 예상 SRAM 사용량과 보드의 전체 SRAM이 표시됩니다. |

핀 매핑과 메모리 영역은 서로 따로 접고 펼칠 수 있습니다. 긴 핀 목록을 확인할 때는 메모리 영역을 접고, 메모리 개수를 확인할 때는 핀 매핑을 접으면 필요한 내용이 한 화면에 들어옵니다.

핀의 LD 주소ㆍ사용 여부를 변경하려면 활동바의 **래더 핀맵 설정**을 사용합니다. 편집 방법은 [[products:mpino_studio2:menus_settings#래더_핀맵_설정|Phase 7 · 래더 핀맵 설정]]에서 확인하십시오. 메모리 개수를 변경하려면 **설정 → 메모리 영역 설정**을 선택합니다. 메모리 개수와 주소 범위는 [[products:mpino_studio2:memory#메모리_영역|Phase 2 · 메모리 영역]]에서 설명합니다.

===== 4. 라이브러리 =====

라이브러리 패널에서 온라인 라이브러리를 검색ㆍ설치하고, 설치된 라이브러리를 프로젝트에 포함하거나 폴더ㆍ소스 파일ㆍZIP 파일로 가져올 수 있습니다.

==== 라이브러리 검색ㆍ설치 ====

{{ :products:mpino_studio2:library-search-marked.svg?1000 |Servo를 검색한 라이브러리 패널 }}

^ 마킹 ^ 화면 항목 ^ 동작 ^
| **①** | 검색창 | 라이브러리 이름이나 검색어를 입력합니다. 입력을 멈추면 검색 결과가 갱신됩니다. |
| **②** | 찾기 | 온라인 라이브러리 색인을 다시 불러옵니다. 첫 검색에서 결과가 나오지 않으면 선택합니다. |
| **③** | 필터 | **호환만 보기**는 현재 보드와 호환 표시가 있는 결과만, **설치된 라이브러리**는 PC에 설치된 항목만 보여 줍니다. |
| **④** | 호환 표시 | 현재 보드의 아키텍처와 라이브러리 정보를 비교한 결과입니다. |
| **⑤** | 설치ㆍ제거 | 설치하지 않은 라이브러리는 **설치**, 설치된 라이브러리는 **제거**로 표시됩니다. |

검색창에 라이브러리 이름을 입력하고 필요한 항목의 **설치**를 선택합니다. 설치가 끝나면 버튼이 **제거**로 바뀝니다. 목록이 이전 상태로 보이면 **새로고침**을 선택해 설치 목록과 Arduino Code 자동완성을 다시 불러옵니다.

**호환** 표시는 라이브러리가 제공하는 아키텍처 정보를 기준으로 한 참고 정보입니다. 호환으로 표시되어도 라이브러리가 사용하는 핀, 타이머, MCU 기능에 따라 빌드 또는 동작 결과가 달라질 수 있습니다.

==== 설치된 라이브러리 관리ㆍ프로젝트 포함 ====

{{ :products:mpino_studio2:library-installed-marked.svg?1000 |설치된 라이브러리의 버전과 배포ㆍ보기ㆍ제거 항목 }}

^ 마킹 ^ 화면 항목 ^ 동작 ^
| **①** | 설치된 라이브러리 | 검색 결과 대신 PC에 설치된 라이브러리만 표시합니다. |
| **②** | 버전 | 현재 설치된 라이브러리 버전입니다. |
| **③** | 배포 | 선택한 라이브러리를 프로젝트 저장 파일에 포함합니다. |
| **④** | 보기 | 해당 라이브러리가 설치된 폴더를 엽니다. |
| **⑤** | 제거 | 사용자 라이브러리 폴더에서 해당 라이브러리를 삭제합니다. |

**배포**를 선택한 라이브러리는 프로젝트를 저장할 때 현재 라이브러리 폴더의 내용이 ''.mp2'' 파일에 포함됩니다. 다른 PC에서 그 프로젝트를 열면 포함된 라이브러리를 사용할 수 있습니다. 같은 이름의 라이브러리가 다른 PC의 사용자 라이브러리 폴더에 이미 있으면 그 PC에 설치된 라이브러리를 우선 사용합니다.

MPINO Studio 2가 기본으로 제공하는 라이브러리는 수신 PC에도 있으므로 **배포** 선택 항목을 표시하지 않습니다. 포함할 라이브러리가 많으면 프로젝트 파일도 커집니다.

사용자 라이브러리 폴더를 변경하는 방법은 [[products:mpino_studio2:menus_settings#일반|Phase 7 · 환경설정의 일반 탭]]에서 확인할 수 있습니다.

==== 오프라인 라이브러리 가져오기 ====

{{ :products:mpino_studio2:library-import-marked.svg?1000 |라이브러리 새로고침과 폴더ㆍ파일ㆍZIP 가져오기 메뉴 }}

^ 마킹 ^ 화면 항목 ^ 동작 ^
| **①** | 라이브러리 도구 | **새로고침**은 라이브러리 폴더의 변경사항을 다시 읽고, **폴더 열기**는 사용자 라이브러리 폴더를 엽니다. |
| **②** | 가져오기 | 가져오기 방법을 선택하는 메뉴를 엽니다. |
| **③** | 폴더에서 | ''library.properties''와 소스 파일이 들어 있는 라이브러리 폴더를 선택합니다. |
| **④** | 파일/ZIP에서 | ''.h'', ''.cpp'', ''.c'' 등 개별 소스 파일 또는 ZIP 라이브러리를 선택합니다. |

^ 선택한 형식 ^ 처리 방법 ^
| 라이브러리 폴더 | 폴더 전체를 하나의 라이브러리로 가져옵니다. |
| 개별 소스 파일 | 선택한 파일을 묶을 라이브러리 이름을 입력한 뒤 가져옵니다. 이름에는 ''\ / : * ? " < > &#124;'' 문자를 사용할 수 없습니다. |
| ZIP 파일 | ZIP 안의 라이브러리 구조를 읽어 가져옵니다. 여러 ZIP은 함께 선택할 수 있습니다. |

ZIP 파일과 개별 소스 파일은 한 번에 섞어 선택할 수 없습니다. 두 형식이 함께 있다면 ZIP 파일을 먼저 가져온 뒤 **파일/ZIP에서**를 다시 열어 개별 소스 파일을 가져옵니다.

라이브러리 폴더에 소스 파일만 직접 복사하면 폴더 구조를 알 수 없어 빌드와 자동완성에서 제외될 수 있습니다. 이 경우 **가져오기 → 파일/ZIP에서**를 선택해 설치한 뒤 **새로고침**을 선택합니다.

===== 5. 심볼 =====

심볼은 PLC 메모리 주소에 붙이는 이름입니다. 예를 들어 ''M0''에 ''Motor''를 등록하면 래더에서 주소 대신 **Motor**를 표시하고, Arduino Code에서도 같은 이름으로 ''M0'' 메모리를 읽고 쓸 수 있습니다.

==== 심볼 창 ====

{{ :products:mpino_studio2:symbol-modal-marked.svg?1000 |주소ㆍ심볼ㆍ코멘트 입력과 메모리 탭이 있는 심볼 창 }}

^ 마킹 ^ 화면 항목 ^ 동작 ^
| **①** | 새 심볼 입력 | 주소ㆍ심볼ㆍ코멘트를 입력하고 **추가**를 선택합니다. 코멘트는 생략할 수 있습니다. |
| **②** | 메모리 탭 | 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''를 함께 등록 |

{{ :products:mpino_studio2:symbol-validation-marked.svg?1000 |이미 등록된 Motor를 다시 입력했을 때의 심볼 오류 }}

^ 마킹 ^ 화면 항목 ^ 확인 내용 ^
| **①** | 입력한 값 | 등록하려는 주소와 심볼을 유지하므로 잘못된 부분을 바로 수정할 수 있습니다. |
| **②** | 오류 내용 | 추가하거나 수정할 수 없는 이유를 표시합니다. 오류가 있으면 해당 행을 일부만 등록하지 않습니다. |

==== 주소 변경과 래더 반영 ====

등록된 심볼의 주소를 변경할 때 기존 주소를 사용하는 래더 셀이 있으면 함께 변경할 셀 개수를 확인하는 창이 열립니다.

{{ :products:mpino_studio2:symbol-address-change.svg?1000 |M0 심볼 주소와 이를 사용하는 래더 셀 2개를 M2로 변경하는 확인창 }}

^ 변경한 항목 ^ 적용 결과 ^ 확인창 ^
| 심볼 이름 | 래더에 표시되는 이름이 바뀝니다. 래더 셀에 저장된 실제 주소는 유지됩니다. | 표시하지 않습니다. |
| 심볼 주소 | 심볼의 실제 메모리 주소가 바뀌고 기존 주소를 변수로 사용하는 래더 셀도 새 주소로 변경됩니다. | 영향을 받는 래더 셀이 있으면 개수를 표시합니다. |

주소 변경을 취소하면 심볼과 래더 셀 모두 기존 주소를 유지합니다. 영향을 받는 래더 셀이 없는 주소는 확인창 없이 변경됩니다.

==== 가져오기ㆍ내보내기 ====

^ 기능 ^ 지원 형식 ^ 처리 방법 ^
| 내보내기 | ''.xlsx'', ''.csv'' | **주소ㆍ심볼ㆍ코멘트** 세 열로 현재 목록을 저장합니다. |
| 가져오기 | ''.xlsx'', ''.csv'' | 파일의 심볼 목록으로 현재 목록 전체를 교체합니다. 주소는 대문자로 변환하며 심볼과 코멘트는 입력한 글자를 유지합니다. |

가져온 파일의 한 행이라도 주소ㆍ이름 규칙을 어기거나 중복되면 가져오기 전체를 중단하고 기존 심볼 목록을 유지합니다. 기존 목록에 새 행을 추가하는 작업이 아니므로 가져오기 전에 필요한 경우 현재 목록을 먼저 내보냅니다.

==== 래더와 Arduino Code에서 사용 ====

{{ :products:mpino_studio2:symbol-ladder-code-usage.svg?1000 |M0에 등록한 Motor 심볼을 래더와 Arduino Code에서 함께 사용 }}

래더 셀에는 실제 주소가 저장되며 심볼은 그 주소를 읽기 쉽게 표시하는 이름입니다. 따라서 심볼 이름만 바꿔도 래더의 메모리 동작은 바뀌지 않습니다.

빌드할 때 Arduino Code에서 사용할 수 있는 심볼은 다음과 같은 형식으로 연결됩니다.

<code cpp>
// 심볼 창에서 M0 = Motor, M10 = Start로 등록
if (Start) {
  Motor = true;
}
</code>

Arduino Code에서 사용할 심볼은 영문자 또는 ''_''로 시작하고 나머지가 영문자ㆍ숫자ㆍ''_''로 구성된 C 식별자여야 합니다. C/C++ 예약어, PㆍMㆍDㆍCㆍTㆍR 메모리 배열명, ''setup'', ''loop'', ''digitalWrite'' 같은 Arduinoㆍ생성 함수 이름과 겹치는 심볼은 Arduino Code용 정의에서 제외됩니다. 한글이나 일본어 이름은 래더에서 사용할 수 있지만 Arduino Code에서는 실제 주소를 사용해야 합니다.

래더와 Arduino Code가 같은 메모리를 공유하는 구조는 [[products:mpino_studio2:memory#arduino_코드와_래더_로직의_메모리_공유|Phase 2 · Arduino 코드와 래더 로직의 메모리 공유]]에서 확인할 수 있습니다.

===== 6. 문제해결방법 =====

^ 증상 ^ 확인할 항목 ^ 해결 방법 ^
| 활동바 아이콘을 눌러도 사이드 패널이 보이지 않습니다. | 같은 아이콘을 두 번 눌렀거나 ''Ctrl + B''로 사이드 패널을 닫았는지 확인합니다. | 탐색기ㆍ래더설정ㆍ라이브러리 중 필요한 아이콘을 한 번 선택합니다. |
| 라이브러리 검색 결과가 표시되지 않습니다. | 인터넷 연결, 검색어, **호환만 보기** 필터를 확인합니다. | **찾기**로 색인을 갱신한 뒤 필터를 해제하고 다시 검색합니다. |
| 설치 또는 가져온 라이브러리가 목록에 없습니다. | 설치 작업이 끝났는지와 사용자 라이브러리 폴더를 확인합니다. | **새로고침**을 선택해 목록과 자동완성을 다시 불러옵니다. |
| ZIP과 소스 파일을 함께 가져올 수 없습니다. | 선택한 파일에 ZIP과 ''.h''ㆍ''.cpp'' 등이 섞여 있는지 확인합니다. | ZIP과 개별 소스 파일을 나누어 두 번 가져옵니다. |
| 심볼을 추가하거나 수정할 수 없습니다. | 심볼 창 아래쪽의 오류 내용과 주소ㆍ이름 중복을 확인합니다. | 오류가 표시된 값을 규칙에 맞게 수정한 뒤 다시 추가하거나 적용합니다. |
| 심볼 주소를 바꿀 때 래더 셀 개수가 표시됩니다. | 기존 주소를 변수로 사용하는 래더 셀의 수입니다. | 변경할 주소와 영향 범위를 확인한 뒤 **변경** 또는 **취소**를 선택합니다. |
| 심볼을 가져온 뒤 기존 목록이 바뀌었습니다. | 가져오기는 기존 목록과 합치지 않고 전체 목록을 교체합니다. | 필요한 기존 심볼을 가져올 파일에 함께 넣거나, 가져오기 전에 기존 목록을 내보냅니다. |
| Arduino Code에서 심볼 이름을 사용할 수 없습니다. | 심볼 이름이 C 식별자 형식인지, 예약어나 내장 이름과 겹치는지 확인합니다. | 영문자 또는 ''_''로 시작하는 고유한 이름으로 변경하거나 실제 메모리 주소를 사용합니다. |

===== 관련 문서 =====

  * [[products:mpino_studio2:memory|Phase 2 · 메모리 이해하기]] — 메모리 영역ㆍ핀 매핑ㆍ메모리 공유
  * [[products:mpino_studio2:code_editor|Phase 5 · Arduino Code 편집]] — 코드 파일과 자동완성
  * [[products:mpino_studio2:monitoring|Phase 6 · 시리얼ㆍ래더 모니터링]] — 하단 패널과 연결
  * [[products:mpino_studio2:menus_settings|Phase 7 · 메뉴와 환경설정]] — 보드ㆍ핀맵ㆍ프로그램 설정
  * [[products:mpino_studio2:troubleshooting|Phase 9 · 문제 해결]] — 증상별 확인 항목
  * [[products:mpino_studio2|MPINO STUDIO 2 사용설명서]]

[[products:mpino_studio2:menus_settings|← Phase 7 · 메뉴와 환경설정]] | [[products:mpino_studio2:troubleshooting|Phase 9 · 문제 해결 →]] | [[products:mpino_studio2|MPINO STUDIO 2 사용설명서로 돌아가기]]