ILOGICS 제품 사용설명서

이 문서는 읽기 전용입니다. 원본을 볼 수는 있지만 바꿀 수는 없습니다. 문제가 있다고 생각하면 관리자에게 문의하세요.
====== MPINO STUDIO 2 Phase 9 · 문제 해결 ======

빌드ㆍ업로드ㆍ모니터링ㆍ입출력에 문제가 생겼을 때 증상에 맞는 확인 순서를 찾습니다.

{{ :products:mpino_studio2:troubleshooting-path-ko.svg?1000 |프로젝트 작업부터 실제 동작까지 문제를 확인하는 순서 }}

===== 1. 증상으로 찾아보기 =====

아래 표에서 현재 증상과 가장 가까운 항목을 찾습니다. 같은 증상이라도 **빌드 전**, **업로드 중**, **보드 실행 중**에는 확인할 곳이 다릅니다.

^ 화면에서 보이는 증상 ^ 먼저 확인할 곳 ^ 이어서 볼 설명 ^
| 프로젝트를 열거나 저장할 수 없습니다. | 파일 메뉴와 저장 경로 | [[products:mpino_studio2:menus_settings|Phase 7 · 프로젝트 열기ㆍ저장]] |
| 래더 셀이 예상대로 편집되지 않습니다. | 래더 탭과 선택한 셀 | [[products:mpino_studio2:ladder_editing|Phase 3 · 래더 편집]] |
| Arduino Code가 예상대로 편집되지 않습니다. | 코드 탭과 선택한 파일 | [[products:mpino_studio2:code_editor|Phase 5 · Arduino Code 편집]] |
| 빌드 출력에 오류가 표시됩니다. | 빌드 출력과 문제 탭 | [[#빌드가_실패할_때|2. 빌드가 실패할 때]] |
| 업로드가 시작되지 않거나 멈춥니다. | 빌드 결과, 상태바 포트, 업로드 로그 | [[#업로드가_시작되지_않거나_중간에_멈출_때|3. 업로드 문제]] |
| 시리얼 모니터에 값이 없습니다. | 연결 상태, 통신 속도, 송신 코드 | [[#모니터를_연결했는데_값이_보이지_않을_때|4. 모니터 값 확인]] |
| 래더 도통ㆍ현재값이 없거나 멈췄습니다. | 모니터링 사용 포트, 업로드한 설정, 연결 상태 | [[#모니터를_연결했는데_값이_보이지_않을_때|4. 모니터 값 확인]] |
| 래더 표시와 실제 입출력이 다릅니다. | 선택한 보드와 래더 핀맵 | [[#래더_표시와_실제_입출력이_다를_때|5. 입출력 확인]] |
| 설정이나 편집 결과가 반영되지 않습니다. | 저장ㆍ적용ㆍ빌드ㆍ업로드 중 필요한 단계 | [[#변경한_설정이나_편집_결과가_반영되지_않을_때|6. 변경 결과 확인]] |

===== 2. 빌드가 실패할 때 =====

**실행 → 빌드**를 선택한 뒤 하단의 **빌드 출력**에서 오류가 나타난 단계를 확인합니다. **문제** 탭에 파일ㆍ줄 또는 래더 위치가 표시되면 해당 항목을 선택해 편집 위치로 이동합니다. 첫 번째 Arduino Code 파일의 문제 항목은 코드 위치로 이동하며, 추가 코드 파일은 표시된 파일명과 줄 번호를 확인해 탐색기에서 엽니다.

^ 확인한 위치 ^ 다음 행동 ^ 자세한 설명 ^
| Arduino Code의 파일ㆍ줄 | 해당 줄의 문법과 이름을 수정하고 다시 빌드합니다. | [[products:mpino_studio2:code_editor|Phase 5 · 코드 오류 확인]] |
| 래더 셀ㆍ주소 | 표시된 셀의 주소와 데이터 형식을 확인합니다. | [[products:mpino_studio2:memory|Phase 2 · 메모리 주소]] / [[products:mpino_studio2:ladder_editing|Phase 3 · 래더 셀 편집]] |
| 박스함수의 명령어ㆍ인수 | 해당 박스함수의 입력 형식과 허용 범위를 확인합니다. | [[products:mpino_studio2:box_functions|Phase 4 · 박스함수]] |
| 문제 탭에 위치가 없는 빌드 오류 | 빌드 출력의 오류 문구와 그 앞의 로그를 확인합니다. | [[products:mpino_studio2:first_project|Phase 1 · 빌드하기]] |

수정한 뒤 다시 빌드합니다. 빌드 결과를 확인한 다음 업로드 상태를 점검합니다.

===== 3. 업로드가 시작되지 않거나 중간에 멈출 때 =====

빌드가 성공했는데 업로드가 진행되지 않으면 **상태바 오른쪽의 포트 선택**과 **프로젝트에서 선택한 보드**를 확인합니다. 포트 목록은 열 때 갱신됩니다. 목록이 비어 있으면 PC에 해당 포트가 표시되는지와 제품에 맞는 다운로드 케이블의 연결 상태를 확인한 뒤 목록을 다시 엽니다. MPINO-8A4R(T)-S의 연결은 [[products:mpino_studio2:first_project|Phase 1 · 포트 선택과 업로드]]를 참고합니다.

업로드 로그에 표시된 결과에 따라 다음을 확인합니다.

^ 로그에서 확인한 상태 ^ 확인할 곳 ^
| 선택한 포트에 접근할 수 없음 | 다른 프로그램이 포트를 사용 중인지 확인합니다. MPINO Studio 2의 모니터 연결은 업로드 시 일시적으로 해제됩니다. |
| 보드가 응답하지 않음 | 선택한 포트, 연결 케이블, 실제 제품과 프로젝트의 보드 선택을 확인합니다. |
| 포트를 찾을 수 없음 | 케이블과 PC의 포트 인식 상태를 확인하고 포트 목록을 다시 엽니다. |
| 그 밖의 업로드 실패 | 업로드 로그에서 처음 표시된 오류와 직전 단계를 확인합니다. |

제품별 케이블ㆍ단자와 보드 사양은 해당 [[products:mpino_series|제품 상세 설명]]에서 확인합니다.

===== 4. 모니터를 연결했는데 값이 보이지 않을 때 =====

**시리얼 모니터**는 Arduino Code가 송신한 데이터를 보여 줍니다. **래더 모니터링**은 래더 접점ㆍ코일의 도통과 메모리 현재값을 보여 줍니다. 먼저 어떤 화면에서 값이 없는지 구분합니다.

^ 상태 ^ 먼저 확인할 것 ^
| 시리얼 모니터가 연결되지 않음 | 상태바의 PC 포트를 선택하고 모니터의 **연결** 상태를 확인합니다. |
| 연결됐지만 시리얼 수신값이 없음 | ''Serial.print()''가 실행되는지, 모니터 통신 속도가 코드의 ''Serial.begin()'' 값과 같은지 확인합니다. 문자가 깨지면 수신 인코딩도 확인합니다. |
| 래더 모니터링을 시작할 수 없음 | **모니터링 사용 포트**를 설정했는지, 설정 후 다시 빌드ㆍ업로드했는지 확인합니다. |
| 래더 모니터링은 켜졌지만 값이 없음 | 설정한 통신 채널과 연결 채널이 맞는지 확인합니다. |
| 표시되던 래더 값이 멈춤 | 보드와 통신 상태를 확인한 뒤 모니터링을 끄고 다시 켭니다. |

두 모니터는 상태바에서 선택한 PC 시리얼 포트를 함께 사용하므로 동시에 연결할 수 없습니다. 포트 사용 관계와 연결 절차는 [[products:mpino_studio2:monitoring|Phase 6 · 시리얼ㆍ래더 모니터링]]에서 확인합니다.

===== 5. 래더 표시와 실제 입출력이 다를 때 =====

  - 래더 모니터링에서 해당 접점과 코일의 **도통 표시**가 바뀌는지 확인합니다. 도통 표시 자체가 없으면 앞의 모니터링 연결 상태부터 확인합니다.
  - 프로젝트에서 선택한 보드가 연결한 제품과 같은지 확인합니다.
  - **설정 → 래더 핀맵 설정**에서 해당 P 주소의 **사용**, 입출력 방향, 실제 핀 매핑을 확인합니다.
  - 화면의 주소와 실제 제품 단자를 제품 상세 설명의 핀맵에서 대조합니다.

''P0'' 입력과 ''P32'' 출력 예제는 **MPINO-8A4R(T)-S를 선택한 Phase 1 프로젝트**의 예입니다. 다른 보드의 P 주소와 단자에 그대로 적용하지 마십시오. [[products:mpino_studio2:first_project|Phase 1 · 첫 프로젝트]]와 [[products:mpino_studio2:menus_settings|Phase 7 · 보드ㆍ핀맵 변경]]에서 확인할 수 있습니다.

''C'' 메모리 값이 예상과 다르면 해당 보드의 기능 매핑과 카운터 주소가 겹치는지 확인합니다. MPINO-8A4R(T)-S의 ''C0''~''C10'' 매핑은 [[products:mpino_studio2:memory|Phase 2 · 메모리 영역]]에 정리되어 있습니다. 실제 배선과 출력 방식은 제품별 사양을 따릅니다.

===== 6. 변경한 설정이나 편집 결과가 반영되지 않을 때 =====

^ 변경한 대상 ^ 반영을 위해 확인할 것 ^ 자세한 설명 ^
| 프로젝트의 코드ㆍ래더ㆍ심볼 | 편집한 프로젝트를 저장했는지 확인합니다. 보드 실행 결과까지 바꾸려면 다시 빌드ㆍ업로드합니다. | [[products:mpino_studio2:menus_settings|Phase 7 · 프로젝트 저장]] |
| 단축키ㆍ래더 디자인 | 단축키는 환경설정에서 즉시 반영됩니다. 래더 디자인은 **저장**을 선택해야 적용됩니다. | [[products:mpino_studio2:menus_settings|Phase 7 · 환경설정]] |
| 모니터링 사용 포트ㆍ보드 통신 설정 | 변경한 설정으로 다시 빌드ㆍ업로드했는지 확인합니다. | [[products:mpino_studio2:monitoring|Phase 6 · 모니터링 설정]] / [[products:mpino_studio2:menus_settings|Phase 7 · 통신 설정]] |
| 코드 파일ㆍ자동완성 | 현재 연 코드 파일과 탐색기의 파일 목록을 확인합니다. | [[products:mpino_studio2:code_editor|Phase 5 · 코드 파일 관리]] |
| 라이브러리ㆍ심볼 | 라이브러리 목록의 **새로고침** 또는 심볼 창의 입력 오류를 확인합니다. | [[products:mpino_studio2:activity_bar|Phase 8 · 라이브러리ㆍ심볼]] |

===== 7. 원인을 찾지 못했을 때 =====

문제가 반복되면 **어느 단계에서**, **무엇을 실행했을 때**, **어떤 오류가 표시됐는지**를 순서대로 적습니다. 선택한 제품ㆍ보드와 포트도 함께 기록합니다. 예: “MPINO-8A4R(T)-S 프로젝트에서 빌드는 완료됐지만, COM3을 선택해 업로드하면 ‘보드가 응답하지 않습니다’가 표시됩니다.”

**도움말 → 버그 신고**에서 문제 설명을 입력해 보낼 수 있습니다. 기본 진단 정보는 포함되며, 프로젝트ㆍ화면 캡처ㆍ연락처는 필요한 경우에만 선택합니다. 신고 화면과 각 첨부 항목은 [[products:mpino_studio2:menus_settings|Phase 7 · 도움말 메뉴]]를 참고합니다.

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

  * [[products:mpino_studio2:first_project|Phase 1 · 첫 프로젝트 만들기]] — 빌드ㆍ포트ㆍ업로드
  * [[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:activity_bar|Phase 8 · 활동바와 사이드 패널]] — 라이브러리ㆍ심볼
  * [[products:mpino_studio2|MPINO STUDIO 2 사용설명서]]

[[products:mpino_studio2:activity_bar|← Phase 8 · 활동바와 사이드 패널]] | [[products:mpino_studio2|MPINO STUDIO 2 사용설명서로 돌아가기]]