# T-Order 태블릿 세팅 자동화 시스템

T-Order에서 사용하던 태블릿(ITAB X40L Plus)을 디지털 사이니지 또는 특수 용도로 전환하기 위한 자동화 세팅 도구입니다.

## 📋 개요

이 도구는 여러 대의 태블릿을 연속으로 설정할 수 있는 자동화 시스템으로, 각 기기를 연결하면 자동으로 WiFi 설정, 불필요한 앱 제거, 시스템 최적화, 필수 앱 설치 및 설정을 수행합니다.

## 🎯 주요 기능

- **연속 다중 기기 지원**: 한 대 완료 후 다음 기기 자동 대기
- **모델 자동 검증**: 호환 모델만 처리 (ITAB_X40L_Plus)
- **WiFi 자동 연결**: 지정된 네트워크에 자동 접속
- **앱 정리 자동화**: T-Order, YouTube 등 불필요한 앱 일괄 제거
- **디지털 사이니지 최적화**: 화면 상시 켜짐, 절전 비활성화 등
- **필수 앱 자동 설치**: Synology Photos, MacroDroid 설치 및 권한 설정
- **배경화면 설정 지원**: 사용자 확인 방식으로 안정성 보장

## 📁 폴더 구조

```
platform-tools/
├── setup.bat          # 메인 자동화 스크립트 (연속 다중 기기 지원)
├── spec_chk.bat       # 기기 사양 확인 스크립트
├── README.md          # 프로젝트 설명서 (본 문서)
├── sdk/               # Android SDK Platform Tools
│   ├── adb.exe
│   ├── fastboot.exe
│   └── ...
└── data/              # 태블릿에 전송될 데이터
    ├── macrodroid.apk # MacroDroid 앱 설치 파일
    ├── macrodroid.mdr # MacroDroid 매크로 프로필
    ├── photos.apk     # Synology Photos 앱 설치 파일
    └── wallpaper.jpg  # 배경화면 이미지
```

## 🚀 사용 방법

### 1. 사전 준비

1. **SDK 설치 확인**: `sdk/` 폴더에 Android Platform Tools가 있는지 확인
   - 없을 경우: [Android SDK Platform Tools](https://developer.android.com/studio/releases/platform-tools) 다운로드 후 압축 해제
   
2. **필수 파일 준비**: `data/` 폴더에 다음 파일들이 있는지 확인
   - `macrodroid.apk`, `photos.apk`: 앱 설치 파일
   - `macrodroid.mdr`: 매크로 설정 파일
   - `wallpaper.jpg`: 배경화면 이미지

3. **태블릿 설정**:
   - 설정 > 태블릿 정보 > 빌드 번호 7회 탭하여 개발자 모드 활성화
   - 설정 > 개발자 옵션 > USB 디버깅 활성화

### 2. 기기 사양 확인 (선택사항)

```powershell
.\spec_chk.bat
```

태블릿의 모델명, OS 버전, 센서 탑재 여부 등을 확인할 수 있습니다.

### 3. 자동 세팅 실행

```powershell
.\setup.bat
```

스크립트 실행 후:
1. 태블릿을 USB로 연결
2. 태블릿에서 "USB 디버깅 허용" 팝업 승인
3. 자동으로 작업이 진행됨
4. 사용자 확인이 필요한 단계에서 안내 메시지 표시
5. 작업 완료 후 기기 연결 해제하면 자동으로 다음 기기 대기

### 4. 작업 흐름

#### STEP 1: 네트워크 설정 (WiFi)
- WiFi 활성화
- 지정된 SSID로 자동 연결

#### STEP 2: 앱 정리
- T-Order 관련 앱 자동 검색 및 제거
- YouTube, Google Keep, TeamViewer 등 불필요한 앱 제거

#### STEP 3: 시스템 최적화 (디지털 사이니지 모드)
- 애니메이션 효과 전체 비활성화
- 화면 상시 켜짐 설정 (타임아웃 무한대)
- 화면 밝기 최대 고정
- 자동 회전 활성화
- 터치 사운드/햅틱 피드백 비활성화
- 알림 숨김 모드 활성화
- 자동 업데이트 비활성화
- 절전 모드 비활성화
- USB 디버깅 유지 설정

#### STEP 4: 필수 앱 설치 및 배경화면
- Synology Photos 앱 설치 (미설치 시)
- MacroDroid 앱 설치 (미설치 시)
- 배경화면 설정 앱 실행
  - **사용자 확인**: 태블릿에서 앱 선택 및 배경화면 설정 완료 후 키 입력

#### STEP 5: MacroDroid 권한 설정
- 시스템 설정 쓰기 권한
- 다른 앱 위에 표시 권한
- 사용 기록 접근 권한
- 방해 금지 모드 접근 권한
- 알림 리스너 서비스 권한
- 접근성 서비스 활성화

#### STEP 6: MacroDroid 매크로 프로필 전송
- 매크로 설정 파일을 Download 폴더로 전송

#### 작업 완료
- 기기 연결 해제 감지
- 3초 후 자동으로 새로운 기기 대기 상태로 전환
- **Ctrl + C**로 언제든지 전체 작업 종료 가능

## ⚙️ 설정 변경

`setup.bat` 파일 상단의 설정 영역에서 다음 값들을 수정할 수 있습니다:

```bat
:: --- [설정 영역] ---
set "DEBUG_MODE=OFF"                        # 디버그 모드 (ON/OFF)
set "SSID=fg"                               # WiFi SSID
set "PW=Fg9576861!"                         # WiFi 비밀번호
set "PKG_MD=com.arlosoft.macrodroid"        # MacroDroid 패키지명
set "PKG_PHOTOS=com.synology.projectkailash" # Photos 패키지명
set "TARGET_MODEL=ITAB_X40L_Plus"           # 대상 기기 모델
```

## 🔧 문제 해결

### ADB를 찾을 수 없음
- `sdk/` 폴더에 `adb.exe`가 있는지 확인
- Android SDK Platform Tools 다운로드 필요

### 기기가 인식되지 않음
- USB 디버깅이 활성화되어 있는지 확인
- USB 케이블이 데이터 전송을 지원하는지 확인
- 태블릿에서 "USB 디버깅 허용" 팝업 승인 필요

### 호환되지 않는 모델 오류
- 현재 `ITAB_X40L_Plus` 모델만 지원
- 다른 모델 사용 시 `TARGET_MODEL` 설정 변경 필요

### 배경화면 설정이 스킵됨
- 앱 실행 후 3초 대기 시간이 자동으로 추가됨
- 사용자가 배경화면 앱을 선택하고 설정 완료 후 키 입력 필요

## 📝 참고사항

- 작업 중 태블릿 연결을 해제하지 마세요
- 네트워크 설정은 WiFi만 지원합니다
- 모든 설정은 ADB 명령어로 수행되므로 인터넷 연결이 필요하지 않습니다
- 디버그 모드를 ON으로 설정하면 모든 명령어 출력을 확인할 수 있습니다

## 📜 라이선스

이 프로젝트는 내부 사용을 위한 도구입니다.

## 🙋 문의

문제가 발생하거나 개선 사항이 있으면 이슈를 등록해 주세요.
- USB 디버깅 유지 설정

#### STEP 4: 필수 앱 설치 및 배경화면
- Synology Photos 앱 설치 (미설치 시)
- MacroDroid 앱 설치 (미설치 시)
- 배경화면 설정 앱 실행
  - **사용자 확인**: 태블릿에서 앱 선택 및 배경화면 설정 완료 후 키 입력

#### STEP 5: MacroDroid 권한 설정
- 시스템 설정 쓰기 권한
- 다른 앱 위에 표시 권한
- 사용 기록 접근 권한
- 방해 금지 모드 접근 권한
- 알림 리스너 서비스 권한
- 접근성 서비스 활성화

#### STEP 6: MacroDroid 매크로 프로필 전송
- 매크로 설정 파일을 Download 폴더로 전송
4. **앱 설치** - MacroDroid, Synology Photos 설치
5. **배경화면 설정** - 지정된 이미지로 배경화면 변경
6. **권한 자동 부여** - MacroDroid 권한 자동 설정
7. **매크로 전송** - 자동화 매크로 프로필 전송
8. **앱 실행** - 설치된 앱 자동 실행

## ⚙️ 설정 변경

`setup.bat` 파일 상단의 설정 영역을 수정하세요:

```batch
:: --- [설정 영역] ---
set "DEBUG_MODE=ON"    :: ON: 모든 로그 출력 / OFF: 간소화된 출력 모드
set "SSID=fg"          :: WiFi SSID
set "PW=Fg9576861!"    :: WiFi 비밀번호
```

## 📦 data 폴더 파일 설명

| 파일 | 설명 |
|------|------|
| `macrodroid.apk` | 자동화 앱 (MacroDroid) |
| `macrodroid.mdr` | 자동화 매크로 설정 파일 |
| `photos.apk` | Synology Photos 앱 |
| `wallpaper.jpg` | 배경화면 이미지 |

## 🔧 문제 해결

### ADB 기기가 인식되지 않을 때

1. USB 드라이버 재설치
2. USB 케이블 교체 (데이터 전송 지원 케이블인지 확인)
3. 다른 USB 포트 시도

### 권한 오류 발생 시

일부 권한은 기기에서 수동 허용이 필요할 수 있습니다. MacroDroid 앱 실행 후 권한 안내를 따라주세요.

## 📝 License

내부 사용 목적으로 제작되었습니다.