차이

문서의 선택한 두 판 사이의 차이를 보여줍니다.

--- products:mpino_studio2:troubleshooting [2026/09/14 10:47] – 바깥 편집 127.0.0.1
+++ products:mpino_studio2:troubleshooting [2026/10/25 11:33] (현재) – 바깥 편집 127.0.0.1
@@ 줄 1: / 줄 1: @@
 ====== MPINO STUDIO 2 Phase 9 · 문제 해결 ======
-빌드ㆍ업로드ㆍ모니터링ㆍ입출력 결과에서 문제가 생겼을 때 증상에 맞는 확인 순서를 찾습니다.
+빌드ㆍ업로드ㆍ모니터링ㆍ입출력에 문제가 생겼을 때 증상에 맞는 확인 순서를 찾아주시기 바랍니다.
 {{ :products:mpino_studio2:troubleshooting-path-ko.svg?1000 |프로젝트 작업부터 실제 동작까지 문제를 확인하는 순서 }}
@@ 줄 7: / 줄 7: @@
 ===== 1. 증상으로 찾아보기 =====
-작업이 멈춘 단계를 먼저 고릅니다. 같은 증상이라도 **빌드 전**, **업로드 중**, **보드 실행 중**에는 확인할 곳이 다릅니다.
+아래 표에서 현재 증상과 가장 가까운 항목을 찾아주시기 바랍니다. 같은 증상이라도 **빌드 전**, **업로드 중**, **보드 실행 중**에는 확인할 곳이 다릅니다.
 ^ 화면에서 보이는 증상 ^ 먼저 확인할 곳 ^ 이어서 볼 설명 ^
@@ 줄 22: / 줄 22: @@
 ===== 2. 빌드가 실패할 때 =====
-**실행 → 빌드**를 선택한 뒤 하단의 **빌드 출력**에서 오류가 나타난 단계를 확인합니다. **문제** 탭에 파일ㆍ줄 또는 래더 위치가 표시되면 해당 항목을 선택해 편집 위치로 이동합니다. 첫 번째 Arduino Code 파일의 문제 항목은 코드 위치로 이동하며, 추가 코드 파일은 표시된 파일명과 줄 번호를 확인해 탐색기에서 엽니다.
+**실행 → 빌드**를 선택한 뒤 하단의 **빌드 출력**에서 오류가 나타난 단계를 확인해주시기 바랍니다. **문제** 탭에 파일ㆍ줄 또는 래더 위치가 표시되면 해당 항목을 선택해 편집 위치로 이동해주시기 바랍니다. 첫 번째 Arduino Code 파일의 문제 항목은 코드 위치로 이동하며, 추가 코드 파일은 표시된 파일명과 줄 번호를 확인해 탐색기에서 열어주시기 바랍니다.
 ^ 확인한 위치 ^ 다음 행동 ^ 자세한 설명 ^
-| Arduino Code의 파일ㆍ줄 | 해당 줄의 문법과 이름을 수정하고 다시 빌드합니다. | [[products:mpino_studio2:code_editor|Phase 5 · 코드 오류 확인]] |
+| 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:memory|Phase 2 · 메모리 주소]] / [[products:mpino_studio2:ladder_editing|Phase 3 · 래더 셀 편집]] |
-| 박스함수의 명령어ㆍ인수 | 해당 박스함수의 입력 형식과 허용 범위를 확인합니다. | [[products:mpino_studio2:box_functions|Phase 4 · 박스함수]] |
+| 박스함수의 명령어ㆍ인수 | 해당 박스함수의 입력 형식과 허용 범위를 확인해주시기 바랍니다. | [[products:mpino_studio2:box_functions|Phase 4 · 박스함수]] |
-| 문제 탭에 위치가 없는 빌드 오류 | 빌드 출력의 오류 문구와 그 앞의 로그를 확인합니다. | [[products:mpino_studio2:first_project|Phase 1 · 빌드하기]] |
+| 문제 탭에 위치가 없는 빌드 오류 | 빌드 출력의 오류 문구와 그 앞의 로그를 확인해주시기 바랍니다. | [[products:mpino_studio2:first_project|Phase 1 · 빌드하기]] |
-수정한 뒤 다시 빌드합니다. 빌드 결과를 확인한 다음 업로드 상태를 점검합니다.
+수정한 뒤 다시 빌드해주시기 바랍니다. 빌드 결과를 확인한 다음 업로드 상태를 점검해주시기 바랍니다.
 ===== 3. 업로드가 시작되지 않거나 중간에 멈출 때 =====
-빌드가 성공했는데 업로드가 진행되지 않으면 **상태바 오른쪽의 포트 선택**과 **프로젝트에서 선택한 보드**를 확인합니다. 포트 목록은 열 때 갱신됩니다. 목록이 비어 있으면 PC에 해당 포트가 표시되는지와 제품에 맞는 다운로드 케이블의 연결 상태를 확인한 뒤 목록을 다시 엽니다. MPINO-8A4R(T)-S의 연결은 [[products:mpino_studio2:first_project|Phase 1 · 포트 선택과 업로드]]를 참고합니다.
+빌드가 성공했는데 업로드가 진행되지 않으면 **상태바 오른쪽의 포트 선택**과 **프로젝트에서 선택한 보드**를 확인해주시기 바랍니다. 포트 목록은 열 때 갱신됩니다. 목록이 비어 있으면 PC에 해당 포트가 표시되는지와 제품에 맞는 다운로드 케이블의 연결 상태를 확인한 뒤 목록을 다시 열어주시기 바랍니다. MPINO-8A4R(T)-S의 연결은 [[products:mpino_studio2:first_project|Phase 1 · 포트 선택과 업로드]]를 참고합니다.
-업로드 로그에 표시된 결과에 따라 다음을 확인합니다.
+업로드 로그에 표시된 결과에 따라 다음을 확인해주시기 바랍니다.
 ^ 로그에서 확인한 상태 ^ 확인할 곳 ^
-| 선택한 포트에 접근할 수 없음 | 다른 프로그램이 포트를 사용 중인지 확인합니다. MPINO Studio 2의 모니터 연결은 업로드 시 일시적으로 해제됩니다. |
+| 선택한 포트에 접근할 수 없음 | 다른 프로그램이 포트를 사용 중인지 확인해주시기 바랍니다. MPINO Studio 2의 모니터 연결은 업로드 시 일시적으로 해제됩니다. |
-| 보드가 응답하지 않음 | 선택한 포트, 연결 케이블, 실제 제품과 프로젝트의 보드 선택을 확인합니다. |
+| 보드가 응답하지 않음 | 선택한 포트, 연결 케이블, 실제 제품과 프로젝트의 보드 선택을 확인해주시기 바랍니다. |
-| 포트를 찾을 수 없음 | 케이블과 PC의 포트 인식 상태를 확인하고 포트 목록을 다시 엽니다. |
+| 포트를 찾을 수 없음 | 케이블과 PC의 포트 인식 상태를 확인하고 포트 목록을 다시 열어주시기 바랍니다. |
-| 그 밖의 업로드 실패 | 업로드 로그에서 처음 표시된 오류와 직전 단계를 확인합니다. |
+| 그 밖의 업로드 실패 | 업로드 로그에서 처음 표시된 오류와 직전 단계를 확인해주시기 바랍니다. |
-제품별 케이블ㆍ단자와 보드 사양은 해당 [[products:mpino_series|제품 상세 설명]]에서 확인합니다.
+제품별 케이블ㆍ단자와 보드 사양은 해당 [[products:mpino_series|제품 상세 설명]]에서 확인해주시기 바랍니다.
 ===== 4. 모니터를 연결했는데 값이 보이지 않을 때 =====
-**시리얼 모니터**는 Arduino Code가 송신한 데이터를 보여 줍니다. **래더 모니터링**은 래더 접점ㆍ코일의 도통과 메모리 현재값을 보여 줍니다. 먼저 어떤 화면에서 값이 없는지 구분합니다.
+**시리얼 모니터**는 Arduino Code가 송신한 데이터를 보여 줍니다. **래더 모니터링**은 래더 접점ㆍ코일의 도통과 메모리 현재값을 보여 줍니다. 먼저 어떤 화면에서 값이 없는지 구분해주시기 바랍니다.
 ^ 상태 ^ 먼저 확인할 것 ^
-| 시리얼 모니터가 연결되지 않음 | 상태바의 PC 포트를 선택하고 모니터의 **연결** 상태를 확인합니다. |
+| 시리얼 모니터가 연결되지 않음 | 상태바의 PC 포트를 선택하고 모니터의 **연결** 상태를 확인해주시기 바랍니다. |
-| 연결됐지만 시리얼 수신값이 없음 | ''Serial.print()''가 실행되는지, 모니터 통신 속도가 코드의 ''Serial.begin()'' 값과 같은지 확인합니다. 문자가 깨지면 수신 인코딩도 확인합니다. |
+| 연결됐지만 시리얼 수신값이 없음 | ''Serial.print()''가 실행되는지, 모니터 통신 속도가 코드의 ''Serial.begin()'' 값과 같은지 확인해주시기 바랍니다. 문자가 깨지면 수신 인코딩도 확인해주시기 바랍니다. |
-| 래더 모니터링을 시작할 수 없음 | **모니터링 사용 포트**를 설정했는지, 설정 후 다시 빌드ㆍ업로드했는지 확인합니다. |
+| 래더 모니터링을 시작할 수 없음 | **모니터링 사용 포트**를 설정했는지, 설정 후 다시 빌드ㆍ업로드했는지 확인해주시기 바랍니다. |
-| 래더 모니터링은 켜졌지만 값이 없음 | 설정한 통신 채널과 연결 채널이 맞는지 확인합니다. |
+| 래더 모니터링은 켜졌지만 값이 없음 | 설정한 통신 채널과 연결 채널이 맞는지 확인해주시기 바랍니다. |
-| 표시되던 래더 값이 멈춤 | 보드와 통신 상태를 확인한 뒤 모니터링을 끄고 다시 켭니다. |
+| 표시되던 래더 값이 멈춤 | 보드와 통신 상태를 확인한 뒤 모니터링을 끄고 다시 켜주시기 바랍니다. |
-두 모니터는 상태바에서 선택한 PC 시리얼 포트를 함께 사용하므로 동시에 연결할 수 없습니다. 포트 사용 관계와 연결 절차는 [[products:mpino_studio2:monitoring|Phase 6 · 시리얼ㆍ래더 모니터링]]에서 확인합니다.
+두 모니터는 상태바에서 선택한 PC 시리얼 포트를 함께 사용하므로 동시에 연결할 수 없습니다. 포트 사용 관계와 연결 절차는 [[products:mpino_studio2:monitoring|Phase 6 · 시리얼ㆍ래더 모니터링]]에서 확인해주시기 바랍니다.
 ===== 5. 래더 표시와 실제 입출력이 다를 때 =====
-  - 래더 모니터링에서 해당 접점과 코일의 **도통 표시**가 바뀌는지 확인합니다. 도통 표시 자체가 없으면 앞의 모니터링 연결 상태부터 확인합니다.
+  - 래더 모니터링에서 해당 접점과 코일의 **도통 표시**가 바뀌는지 확인해주시기 바랍니다. 도통 표시 자체가 없으면 앞의 모니터링 연결 상태부터 확인해주시기 바랍니다.
-  - 프로젝트에서 선택한 보드가 연결한 제품과 같은지 확인합니다.
+  - 프로젝트에서 선택한 보드가 연결한 제품과 같은지 확인해주시기 바랍니다.
-  - **설정 → 래더 핀맵 설정**에서 해당 P 주소의 **사용**, 입출력 방향, 실제 핀 매핑을 확인합니다.
+  - **설정 → 래더 핀맵 설정**에서 해당 P 주소의 **사용**, 입출력 방향, 실제 핀 매핑을 확인해주시기 바랍니다.
-  - 화면의 주소와 실제 제품 단자를 제품 상세 설명의 핀맵에서 대조합니다.
+  - 화면의 주소와 실제 제품 단자를 제품 상세 설명의 핀맵에서 대조해주시기 바랍니다.
-''P0'' 입력과 ''P32'' 출력 예제는 **MPINO-8A4R(T)-S를 선택한 Phase 1 프로젝트**의 예입니다. 다른 보드의 P 주소와 단자에 그대로 적용하지 마십시오. [[products:mpino_studio2:first_project|Phase 1 · 첫 프로젝트]]와 [[products:mpino_studio2:menus_settings|Phase 7 · 보드ㆍ핀맵 변경]]에서 확인할 수 있습니다.
+''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 · 메모리 영역]]에 정리되어 있습니다. 실제 배선과 출력 방식은 제품별 사양을 따릅니다.
+''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:menus_settings|Phase 7 · 환경설정]] |
-| 모니터링 사용 포트ㆍ보드 통신 설정 | 변경한 설정으로 다시 빌드ㆍ업로드했는지 확인합니다. | [[products:mpino_studio2:monitoring|Phase 6 · 모니터링 설정]] / [[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:code_editor|Phase 5 · 코드 파일 관리]] |
-| 라이브러리ㆍ심볼 | 라이브러리 목록의 **새로고침** 또는 심볼 창의 입력 오류를 확인합니다. | [[products:mpino_studio2:activity_bar|Phase 8 · 라이브러리ㆍ심볼]] |
+| 라이브러리ㆍ심볼 | 라이브러리 목록의 **새로고침** 또는 심볼 창의 입력 오류를 확인해주시기 바랍니다. | [[products:mpino_studio2:activity_bar|Phase 8 · 라이브러리ㆍ심볼]] |
 ===== 7. 원인을 찾지 못했을 때 =====
-문제가 반복되면 **어느 단계에서**, **무엇을 실행했을 때**, **어떤 오류가 표시됐는지**를 순서대로 적습니다. 선택한 제품ㆍ보드와 포트도 함께 기록합니다. 예: “MPINO-8A4R(T)-S 프로젝트에서 빌드는 완료됐지만, COM3을 선택해 업로드하면 ‘보드가 응답하지 않습니다’가 표시됩니다.”
+문제가 반복되면 **어느 단계에서**, **무엇을 실행했을 때**, **어떤 오류가 표시됐는지**를 순서대로 적어주시기 바랍니다. 선택한 제품ㆍ보드와 포트도 함께 기록해주시기 바랍니다. 예: “MPINO-8A4R(T)-S 프로젝트에서 빌드는 완료됐지만, COM3을 선택해 업로드하면 ‘보드가 응답하지 않습니다’가 표시됩니다.”
 **도움말 → 버그 신고**에서 문제 설명을 입력해 보낼 수 있습니다. 기본 진단 정보는 포함되며, 프로젝트ㆍ화면 캡처ㆍ연락처는 필요한 경우에만 선택합니다. 신고 화면과 각 첨부 항목은 [[products:mpino_studio2:menus_settings|Phase 7 · 도움말 메뉴]]를 참고합니다.