lapiSwitch 사용 설명서

0시작하기 전에

lapiSwitch는 태블릿의 DeviceInfo와 파티션을 직접 다루는 도구입니다. 아래 내용을 모두 이해한 뒤에 시작하세요.

작업 전에 사진·문서 같은 개인 파일은 PC나 클라우드에 따로 옮겨 두세요. 앱이 만든 원본 백업 폴더와 로그는 작업이 끝난 뒤에도 지우지 말고 보관하세요. 원본 복구에 꼭 필요합니다.

전체 흐름 한눈에 보기

1. 기기 연결
2. 리전 선택
3. 펌웨어 검사
4. 변환 설정
5. 최종 확인
6. 자동 진행 10단계
7. 완료

내부적으로는 검사·원본 백업 → TWRP에서 DeviceInfo 변경·검증 → 원본 GPT·Recovery 복원 → 공식 펌웨어 설치·재부팅 순서로 진행됩니다. 사용자가 할 일은 설정을 고르고, 중간에 나오는 재부팅 확인창에서 확인을 누르고, USB 연결을 끝까지 유지하는 것입니다.

1준비물과 지원 조건

버전 상한은 지금 태블릿에 설치된 펌웨어의 기준입니다. 설치할 펌웨어 패키지는 앱이 따로 검사합니다. 순정롬으로 확인된 기기 펌웨어가 상한보다 새로우면 변환이 차단됩니다. 버전·리전을 순정롬으로 확인할 수 없으면 커스텀롬·GSI·테스트 빌드 가능성을 안내하는 경고창이 나타납니다. 취소하면 중단하고, 계속 진행을 선택해야 작업이 이어집니다. 기기 모델 확인과 통신 오류 검사는 그대로 적용됩니다.

태블릿 미리 설정하기

1. 태블릿 설정 → 태블릿 정보에서 빌드 번호를 여러 번 눌러 개발자 옵션을 켭니다. 메뉴 이름과 위치는 펌웨어 버전에 따라 조금 다를 수 있습니다.
2. 개발자 옵션 → USB 디버깅을 켭니다.
3. 배터리를 충분히 충전합니다. 작업 중 전원이 꺼지면 위험합니다.
4. USB 허브나 연장선보다는 PC 본체의 USB 포트에 직접 연결하세요.

PC 미리 준비하기

• 목표 리전의 공식 펌웨어를 내려받아 압축을 풀어 둡니다. 앱에서는 압축 파일이 아니라 풀린 폴더를 선택합니다.
• Lenovo Software Fix나 다른 ADB 도구(안드로이드 스튜디오, 스크린 미러링 앱 등)는 종료합니다. 켜져 있으면 연결이 끊기거나 충돌할 수 있습니다. 앱이 감지하면 종료 버튼을 보여 줍니다(3장).

2설치와 첫 실행

1. GitHub Releases에서 Windows ZIP 파일과 .zip.sha256 체크섬 파일을 내려받습니다.
2. 체크섬을 확인합니다. PowerShell에서 아래 명령을 실행한 결과가 .zip.sha256 파일의 값과 같아야 합니다.
   Get-FileHash <내려받은 ZIP 파일 경로> -Algorithm SHA256
3. ZIP의 압축을 풀고 lapiSwitch.exe를 실행합니다. 설치 과정은 없습니다.
4. USB 드라이버가 없으면 Dashboard 위쪽에 안내가 나타납니다. 다운로드 및 설치를 눌러 설치하세요.

드라이버 방식은 설정 → USB 드라이버에서도 확인하고 바꿀 수 있습니다.

• Kernel (기본값, LTBox와 같음): Qualcomm 직렬 드라이버를 사용합니다. 특별한 이유가 없으면 이 방식을 쓰세요.
• Userspace: WinUSB / libusb를 사용합니다. EDL(9008) 장치에 WinUSB 드라이버가 설치되어 있어야 합니다.

3기기 연결과 Dashboard

태블릿을 켠 상태로 USB에 연결하면 Dashboard에 기기 정보가 나타납니다. 연결 상태는 약 3초마다 자동으로 다시 확인됩니다.

1 2 3 4 5 6 7 8

1. 1연결 상태 배지 — 지금 연결 모드(ADB, Fastboot, EDL)와 문제 상태(승인 필요, 서버 충돌, 기기 연결 안 됨)를 보여 줍니다.
2. 2설정 — 언어, 개인정보 보호, 로그·백업 위치, USB 드라이버, 오픈소스 라이선스(12장).
3. 3왼쪽 메뉴 — 리전 변환을 시작하면 아래에 변환 순서(01 리전 선택 ~ 05 진행/결과)가 나타나 현재 단계를 표시합니다.
4. 4기기 카드 — 모델명, 모델 번호(TB520FU), Android 버전. 오른쪽에도 연결 상태 배지가 있습니다.
5. 5기기 정보 — RAM·저장 공간, 활성 슬롯(a/b), 롤백 방지 상태, 설치된 펌웨어 버전, 시리얼 번호.
6. 6원본 복구 — 백업으로 원래 구성을 되돌립니다(11장).
7. 7리전 변환 — 변환 과정을 시작합니다(4장).
8. 8연결 상태 자동 확인 안내.

USB 디버깅 승인이 필요할 때

처음 연결하면 태블릿 화면에 “USB 디버깅을 허용하시겠습니까?” 창이 뜹니다. 이 컴퓨터에서 항상 허용을 체크하고 허용을 누르세요. 승인 전에는 상태가 ADB · 승인 필요로 표시되고 기기 정보가 비어 있습니다.

다른 프로그램과 충돌할 때

다른 프로그램의 ADB 서버가 기기를 붙잡고 있으면 ADB · 서버 충돌이 표시됩니다. 위쪽 안내의 ADB 서버 종료를 누르면 충돌하는 ADB 서버를 끄고 다시 연결합니다.

Lenovo Software Fix가 실행 중이면 기기 연결이 끊길 수 있어 종료 안내가 나타납니다. 강제 종료를 누르면 확인창이 뜨고, 종료를 누르면 Windows가 관리자 권한을 요청합니다.

4리전 선택

Dashboard에서 리전 변환을 누르면 변환 마법사가 시작됩니다. 왼쪽 메뉴에 변환 순서가 나타나고, 지금 단계가 파란색으로 표시됩니다. 언제든 아래쪽 이전으로 앞 단계로 돌아갈 수 있습니다.

• ROW — 글로벌 펌웨어로 변환합니다.
• PRC — 중국 내수 펌웨어로 변환합니다.

현재 기기의 리전과 관계없이 선택한 목표 리전으로 진행합니다. 롤백인덱스 초기화 여부는 03 변환 설정 단계에서 고릅니다.

5펌웨어 검사

1. 폴더 선택을 눌러 압축을 푼 공식 펌웨어 폴더를 고릅니다. 버튼 오른쪽에 목표 리전(예: 목표: ROW)이 표시됩니다.
2. 앱이 모델·리전·필수 파일을 자동으로 검사합니다. 암호화된 .x 파일은 선택한 폴더 안에 XML로 복호화됩니다.
3. “펌웨어 검사를 통과했습니다”가 나오면 다음을 누릅니다.

리전이 맞지 않을 때

목표 리전과 다른 펌웨어 폴더를 고르면 위쪽에 빨간 오류가 표시되고 다음이 비활성화됩니다. 목표 리전과 같은 펌웨어 폴더를 다시 선택하세요.

6변환 설정

1 2 3 4 5 6

1. 1사용자 데이터: 초기화 필수 — 선택할 수 없는 항목입니다. 리전 변환에는 항상 초기화가 함께 진행됩니다.
2. 2초기화 · 32개 인덱스 → 0 (기본값) — DeviceInfo에 저장된 롤백 인덱스 32개를 0으로 바꿉니다. 기기보다 롤백 인덱스가 낮은 펌웨어도 설치할 수 있게 됩니다.
3. 3미초기화 · 기존 값 유지 — 롤백 인덱스를 건드리지 않아 기존 다운그레이드 차단이 그대로 유지됩니다. 이 경우 기기보다 롤백 인덱스가 낮은 펌웨어는 작업 시작 단계에서 거부됩니다(9장의 그림 참고).
4. 4국가 코드 — 현재 선택된 국가가 국기와 함께 표시됩니다. 선택을 눌러 바꿉니다.
5. 5로그 및 백업 위치 — 이번 작업의 로그와 원본 백업이 저장될 곳. 바꾸려면 오른쪽 위 설정에서 변경합니다.
6. 6설정을 마치면 다음.

국가 코드 고르기

선택을 누르면 국가 코드 창이 열립니다. 국가명(한국어·영어 등)이나 코드로 검색할 수 있습니다. 예를 들어 ko, 한국, Korea, KR 모두 대한민국을 찾습니다. 원하는 항목을 고르고 적용을 누르세요. 기존 국가 코드를 그대로 두려면 맨 위의 변경 안 함을 고릅니다.

7최종 확인

시작 전에 지금까지 고른 내용을 마지막으로 확인하는 화면입니다. 내용을 꼼꼼히 읽고 동의 항목을 체크해야 변환 시작이 활성화됩니다.

1 2 3 4 5 6 7

1. 1연결 확인 — 기기 연결을 확인했다는 표시입니다. 시작 직전에 한 번 더 확인합니다.
2. 2요약 — 목표 리전, 사용자 데이터(삭제), 국가 코드, 펌웨어 폴더.
3. 3백업 안내 — 원본 GPT·활성 슬롯 Recovery·vendor_boot·misc 및 고유 파티션을 먼저 백업합니다. 시작 후에는 케이블을 빼거나 앱을 종료하지 마세요.
4. 4롤백인덱스 — 변환 설정에서 고른 방식.
5. 5동의 체크 — “사용자 데이터가 반드시 초기화되는 것과 위 안내를 확인했습니다.”
6. 6시작할 수 없는 이유가 있으면 여기에 표시됩니다.
7. 7변환 시작 — 누르는 즉시 작업이 시작됩니다.

기기가 연결되어 있지 않으면 위쪽에 기기 연결 안 됨이 표시되고, 체크를 해도 변환 시작을 누를 수 없습니다.

8진행 화면 (10단계)

변환 시작을 누르면 10단계가 자동으로 진행됩니다. 단계가 끝나면 다음 단계로 넘어가며, 사용자가 할 일은 재부팅 확인창에서 확인을 누르는 것뿐입니다.

1 2 3 4 5 6 7 8

1. 1전체 진행률 — 단계별 소요 시간 비중을 고려한 값이며, 펌웨어 설치 단계는 실제 전송량을 반영합니다.
2. 2현재 단계 번호와 이름.
3. 3단계 카드 — 끝난 단계에는 ✓ 표시가 붙습니다.
4. 4지금 진행 중인 단계(파란 테두리).
5. 5지금 하고 있는 작업 설명.
6. 6펌웨어 설치 단계의 세부 진행률(파티션 이름과 전송 비율).
7. 7실시간 로그 — 자세한 작업 기록. 같은 내용이 로그 파일에도 저장됩니다.
8. 8주의 문구. 대기 단계가 30초를 넘기면 이 자리 오른쪽에 작업 중지 버튼이 나타납니다.

단계별 설명

시작 직후: 파일 검사

기기가 EDL 모드로 연결된 상태에서 시작한 경우

보통은 태블릿이 정상 부팅된 상태(ADB)에서 시작합니다. 이미 EDL 모드로 연결된 채로 시작하면 아래 확인창이 나옵니다. 이 작업은 기기가 정상 부팅이 가능한 상태일 때만 진행할 수 있습니다. 정상 부팅이 되는 기기라면 확인, 부팅이 안 되는 기기라면 취소를 누르세요.

TWRP로 재부팅 (STEP 05)

원본 백업과 준비가 끝나면 빨간 테두리의 재부팅 전 확인 창이 뜹니다. 내용을 읽고 확인을 누르면 태블릿이 TWRP Recovery로 재부팅됩니다. 태블릿에 TWRP 화면이 나타나도 앱이 자동으로 진행하므로 태블릿에서 따로 조작할 필요는 없습니다.

연결이 오래 걸릴 때: 작업 중지

TWRP나 EDL 연결을 30초 넘게 기다리면 오른쪽 아래에 작업 중지 버튼이 나타납니다. 먼저 케이블과 태블릿 화면을 확인하고, 그래도 연결되지 않을 때만 사용하세요. 누르면 확인창이 나오고, 확인을 누르면 대기를 멈춥니다.

3분(180초) 안에 연결되지 않으면 오류로 중단하며 백업과 작업 기록은 보존됩니다. 연결을 확인한 뒤 이어하기를 선택하거나, EDL에서 원본 복구를 진행하세요. USB 통신 응답을 기다리는 중이면 해당 응답 대기가 끝난 뒤 오류가 표시될 수 있습니다.

중지한 뒤에는 두 가지 방법이 있습니다.

• 나중에 TWRP의 ADB 연결이 되면 앱을 다시 열어 이어하기(10장)로 계속 진행합니다.
• 기기를 직접 EDL 모드로 진입시킨 뒤 원본 복구(11장)를 진행합니다.

EDL로 재부팅 (STEP 07)

DeviceInfo 쓰기와 검증이 끝나면 다시 재부팅 전 확인 창이 뜹니다. 확인을 누르면 EDL로 전환해 원본 GPT·Recovery를 복원하고 공식 펌웨어를 설치합니다. 이때 사용자 데이터가 초기화됩니다.

마무리 (STEP 10)

9완료와 중단

정상 완료

“변환 작업을 마쳤습니다”와 100%가 표시되면 끝입니다. 태블릿이 시스템으로 부팅됩니다. 초기화 직후의 첫 부팅은 평소보다 오래 걸릴 수 있으니 기다려 주세요. 부팅이 끝나면 실제로 부팅되는지와 국가 코드가 맞는지 확인하세요.

• 처음으로 — Dashboard로 돌아갑니다.
• 원본 복구 — 원본 구성 복구 화면으로 이동합니다.
• 로그 다른 곳에 저장 — 이번 작업 로그를 원하는 위치에 복사합니다. 문제를 문의할 때 첨부하세요.

작업이 중단된 경우

문제가 생기면 “작업이 중단되었습니다”와 함께 원인, 백업 위치, 로그가 표시됩니다. 원인을 읽고 해결한 뒤 다시 시도하거나, 필요하면 원본 복구를 진행하세요. 백업 폴더는 지우지 마세요.

위 예시처럼 “이 펌웨어는 기기보다 롤백인덱스가 낮습니다”가 나오면 둘 중 하나를 고르세요.

• 롤백 인덱스가 기기와 같거나 더 높은 (보통 더 최신) 펌웨어를 선택합니다.
• 변환 설정에서 롤백인덱스를 초기화로 선택합니다. 초기화하면 낮은 index의 펌웨어도 허용됩니다.

10이어하기

작업 도중 앱이 꺼졌거나 대기를 중지했다면, 앱을 다시 열었을 때 위쪽에 “이어갈 작업이 있습니다” 안내가 나옵니다. 아래 작은 글씨는 목표 리전과 저장된 단계입니다(예: ROW · S5). 작업 확인을 누르세요.

1. 저장된 목표 리전, 사용자 데이터, 국가 코드, 펌웨어 폴더, 백업 위치, 현재 단계, 롤백인덱스를 확인합니다.
2. 노란 안내를 읽습니다. 예를 들어 TWRP 단계에서 멈췄다면 “저장된 TWRP·DeviceInfo 단계부터 결과를 재확인”한 뒤 원본 GPT·Recovery 복원과 펌웨어 설치를 진행합니다.
3. “저장된 설정과 이어갈 작업을 확인했습니다”를 체크하고 이어하기를 누릅니다. 이어가지 않고 원래대로 되돌리려면 원본 복구를 누릅니다.

이전 작업을 두고 새로 시작하기

이어갈 작업이 남아 있는 상태에서 새 변환을 시작하면 이전 작업 보관 후 새로 시작 확인창이 나옵니다. 확인을 누르면 이전 작업을 중단하고 새 작업을 준비하며, 기존 백업과 로그는 보존됩니다.

11원본 복구

Dashboard나 결과 화면의 원본 복구는 앱이 만든 백업으로 GPT·Recovery·vendor_boot 구성과, 필요한 경우 원래 DeviceInfo 리전을 되돌립니다.

1. 백업한 그 기기 한 대를 EDL 모드로 연결합니다.
2. 백업 폴더 선택으로 이 기기의 백업 폴더(backup\region_change\TB520FU_…)를 고릅니다. 앱이 백업 파일과 해시를 확인하고 모델·슬롯·리전·파일 수를 보여 줍니다.
3. 호환 loader 선택으로 기기에 맞는 Firehose loader 파일(.melf, .elf, .mbn)을 고릅니다. 보통 공식 펌웨어 폴더에 들어 있습니다.
4. 빨간 안내를 읽고 “이 백업을 만든 기기이며 원본 복구를 진행하겠습니다”를 체크합니다.
5. 원본 복구 시작을 누릅니다. DeviceInfo 변경이 검증된 상태라면 TWRP에서 원래 리전으로 되돌린 뒤 원본 vendor_boot·Recovery·GPT를 복원합니다.

12설정

오른쪽 위 톱니바퀴를 누르면 앱 설정이 열립니다. 아래쪽 이전으로 원래 화면에 돌아갑니다.

13백업과 로그 위치

기본 저장 위치는 %LOCALAPPDATA%\lapiSwitch입니다. 탐색기 주소창에 그대로 붙여 넣으면 열립니다.

• 백업 폴더는 폴더째로 보관하세요. 안의 파일 일부만 옮기면 해시 확인에 실패해 원본 복구가 거부될 수 있습니다.
• 다른 곳에 옮겨 보관할 때도 폴더째 옮기세요. 원본 복구 때는 그 폴더를 직접 선택합니다.
• 로그에는 기기 정보가 들어 있습니다. 공유하기 전에 설정의 시리얼 번호 숨기기를 켜 두면 이후 로그에서 시리얼이 가려집니다.

14문제 해결

15크레딧과 라이선스

• LTBox — @miner7222: 기기 통신, EDL 플래시, 드라이버·펌웨어 처리와 일부 GUI 자산의 기반입니다. lapiSwitch는 LTBox를 기반으로 만든 독립 도구입니다.
• TWRP: @wnduddld0513님이 lenovo-sm8650에 배포한 TB520FU용 Recovery 빌드(v3.7.1_16-20261014)를 사용합니다.
• 기타: qdlrs, flag-icons, Noto Sans KR, iced 및 Rust 의존성.

lapiSwitch는 GPL-3.0-or-later로 배포됩니다. 서드파티 구성요소에는 각각의 라이선스가 적용되며, 앱의 설정 → 오픈소스 라이선스 → 라이선스 보기에서 확인할 수 있습니다. 제품명과 상표의 권리는 각 소유자에게 있습니다.

소스 코드와 최신 릴리즈: github.com/corrupt3904/lapiSwitch