PC로 제어가능한 닌텐도 스위치 컨트롤러 제작기 - 2. Python 개발환경 구축하기

내가 테스트를 위해 사용할 코드는 Python 언어로 작성된 ItsDeidara / CommunityController 이다. 따라서 Python 개발 환경을 구축해야한다. 혹시 이 글을 보며 따라할 사람이 있을지는 모르겠지만 Python 을 모르는 사용자에게 모든 내용을 일일히 설명할 수는 없어서 간단히만 정리했다. 아무래도 Python 을 아예 모르는 사용자는 본 단계부터 따라하기 어려울 수도 있겠다.

1. Anaconda 가상환경 구축 및 필요 패키지 설치

효과적인 버전 관리를 위해 Anaconda 를 설치하는 것을 권장한다. 나는 이전부터 Anaconda 를 사용하던 관계로 설치 과정은 본 포스트에 적지 않았다. 구글에 [Python Anaconda 설치]로 검색하면 많은 결과가 나오니 찾아보아도 되고, 그냥 Python 을 설치해서 사용해도 별 문제는 없다. 다만 Anaconda 를 이용하면 여러 패키지를 가상환경 별로 설치 및 관리할 수 있어 프로젝트를 깔끔하게 관리할 수 있다. 여하튼 본 포스트는 Anaconda 를 사용하는 것을 기준으로 설명한다.

Anaconda Prompt 를 열고 아래의 커맨드를 입력하여 PCtoSwitch35 라는 이름으로 Python 3.5 버전의 가상환경을 생성한다.

conda create --name PCtoSwitch35 python=3.5

가상환경 생성 완료 후, conda activate PCtoSwitch35 를 입력하여 가상환경을 활성화한다. 가상환경이 활성화되면 가장 왼쪽의 (base) 가 (PCtoSwitch35) 로 바뀐다. 이제 이 상황에서 라이브러리를 설치하면 PCtoSwitch35 에만 설치되게 된다.

나중에 코드를 RUN 해본 후 pyserial 과 requests 라는 이름의 패키지를 필수로 설치해줘야 한다는 것을 알았다. 이 글을 보고 따라하는 사람은 아래의 커맨드를 입력하여 바로 필요한 패키지를 설치하면 되겠다.

conda install -c anaconda pyserial

conda install requests

2. PyCharm 프로젝트 생성

나는 Python 코딩을 위해 PyCharm 을 애용하는데, 왜냐하면 디버깅이 편하기 때문이다. 특히 남이 짠 코드를 직접 불러와 실행하는 경우에는 에러가 말 그대로 작렬하는 경우가 있어서 디버깅이 필수이다. 본 글을 따라해 볼 Python 초보자는 구글에 [PyCharm 설치] 를 검색하여 에디터를 설치하기 바란다.

PyCharm 을 실행하고 Create Project 메뉴를 선택한다. Location 에 적당한 빈폴더를 선택하고, Project Interpreter 로는 Existing interpreter 를 선택하여 앞서 생성한 가상환경의 python.exe 파일을 선택해주었다. 내 경우 경로는 C:\Users\{유저명}\AppData\Local\conda\conda\envs\PCtoSwitch35\python.exe 이다.

ItsDeidara / CommunityController 에서 파일을 내려받는다. Git을 사용할 줄 안다면 사용하면 되고, 아니면 해당 페이지의 Download 메뉴를 이용해 압축된 파일로 내려받으면 된다.

다운로드를 완료하였다면 압축을 풀고, CommunityController-master\Twitch Plays Nintendo Switch\CommunityController v3\BOTW 경로에 있는 모든 파일을 앞서 프로젝트에서 설정한 Location 폴더 안에 복사하자.

그리고 좌측 트리에서 main.py 파일을 열면 아래처럼 될 것이다.

아직 USB to UART 모듈을 PC에 연결하지 않았으므로, 이대로 실행하면 당연히 오류가 발생한다. 하지만 이것을 PC에 연결하더라도 오류가 발생하게 되는데, 문제의 원인과 해결 방법에 대해서는 다음 문서에서 설명할 것이다.