# Hướng Dẫn Sử Dụng Robot Trợ Lý Học Tập

Tài liệu này dành cho người lần đầu cầm robot. Nội dung chỉ hướng dẫn sử dụng, kết nối Wi-Fi, kết nối loa Bluetooth, hỏi đáp và dùng camera. Các phần cấu hình nâng cao cho người lập trình không nằm trong tài liệu này.

## 1. Chuẩn Bị Trước Khi Dùng

Bạn cần có:

- Robot đã lắp Raspberry Pi, camera, nút bấm và màn hình TFT + OLED hoặc chỉ OLED.
- Nguồn cấp ổn định cho robot. Nên dùng củ sạc ngoài, không nên cấp nguồn từ cổng USB máy tính nếu có gắn sound card USB, loa hoặc thiết bị ngoại vi.
- Điện thoại hoặc máy tính có Wi-Fi để vào trang cấu hình robot.
- Mạng Wi-Fi 2.4GHz. Không dùng được Wi-Fi 5GHz.
- Nếu dùng loa Bluetooth: bật loa và để loa ở chế độ chờ kết nối.

## 2. Bật Robot

1. Cắm nguồn cho robot.
2. Chờ khoảng 30-60 giây để robot khởi động.
3. Nhìn màn hình chính:
   - Nếu robot đã vào được Wi-Fi, màn hình sẽ hiện trạng thái sẵn sàng hoặc địa chỉ quản lý trong vài giây.
   - Nếu robot chưa vào được Wi-Fi, robot sẽ bật Wi-Fi setup tên `robotpi-setup` và hiện màn hình cấu hình Wi-Fi.

Khi robot sẵn sàng, bạn có thể nói “robot ơi” rồi đọc câu hỏi, hoặc bấm giữ nút ở bụng để nói.

Nếu robot lắp TFT 4 inch, TFT là màn hình chính còn OLED nhỏ hiển thị mắt và
đồng hồ/thời tiết. Nếu robot chỉ lắp OLED 1.3 inch, OLED sẽ hiển thị toàn bộ
trạng thái và nội dung như phiên bản ban đầu; cách sử dụng không thay đổi.

## 3. Cài Đặt Lần Đầu

Khi mới dùng lần đầu, robot thường chưa biết Wi-Fi nhà bạn. Làm như sau:

1. Mở Wi-Fi trên điện thoại hoặc máy tính.
2. Kết nối vào Wi-Fi của robot:
   - Tên Wi-Fi: `robotpi-setup`
   - Mật khẩu: `68686868`
3. Mở trình duyệt và vào:

```text
http://10.42.0.1:8765/
```

4. Vào phần **Wi-Fi**.
5. Bấm **Quét Wi-Fi**.
6. Chọn Wi-Fi nhà bạn.
7. Nhập mật khẩu Wi-Fi.
8. Bấm **Kết nối Wi-Fi**.
9. Chờ robot kết nối.

Nếu kết nối thành công:

- Wi-Fi `robotpi-setup` sẽ tự tắt.
- Robot sẽ vào Wi-Fi nhà bạn.
- Màn hình chính sẽ chuyển sang trạng thái sẵn sàng.
- Địa chỉ quản lý sẽ đổi sang dạng IP trong mạng nhà, ví dụ:

```text
http://192.168.1.43:8765/
```

Lưu ý: hãy chọn Wi-Fi 2.4GHz. Không chọn Wi-Fi có chữ `5G` nếu đó là mạng 5GHz.

## 4. Xem Địa Chỉ Trang Quản Lý Robot

Khi robot đã kết nối Wi-Fi nhưng bạn không nhớ địa chỉ trang quản lý:

1. Bấm nhanh nút ở bụng robot **2 lần**.
2. Màn hình chính sẽ hiện:
   - Tên Wi-Fi hiện tại.
   - Địa chỉ trang quản lý robot.
3. Màn hình này tự tắt sau khoảng 5 giây.

Ví dụ màn hình có thể hiện:

```text
Wi-Fi: Dung Dung...
http://192.168.1.43:8765/
```

Nếu chưa kịp đọc, bấm nhanh 2 lần lần nữa.

## 5. Đổi Wi-Fi Cho Robot

Khi robot đang kết nối Wi-Fi cũ và bạn muốn đổi sang Wi-Fi khác:

1. Bấm nhanh nút ở bụng robot **3 lần**.
2. Robot sẽ quên Wi-Fi cũ.
3. Robot bật lại Wi-Fi setup `robotpi-setup`.
4. Màn hình chính hiện màn hình cấu hình Wi-Fi.
5. Trên điện thoại hoặc máy tính, kết nối vào:

```text
robotpi-setup
```

Mật khẩu:

```text
68686868
```

6. Mở trình duyệt:

```text
http://10.42.0.1:8765/
```

7. Vào phần **Wi-Fi**, quét mạng, chọn Wi-Fi mới và nhập mật khẩu.

Sau khi đổi thành công, robot sẽ tắt `robotpi-setup` và chuyển sang Wi-Fi mới.

## 6. Kết Nối Loa Bluetooth

1. Bật loa Bluetooth.
2. Đưa loa vào chế độ ghép nối. Thường loa sẽ nhấp nháy đèn hoặc phát âm báo chờ kết nối.
3. Mở trang quản lý robot.
4. Vào phần **Âm thanh** hoặc **Thiết bị âm thanh**.
5. Bấm **Quét Bluetooth**.
6. Chọn đúng tên loa trong danh sách.
7. Bấm **Kết nối**. Robot tự dùng loa đó làm output và tự ngắt loa Bluetooth cũ nếu có.
8. Khi cần, dùng nút **Ngắt kết nối** hoặc **Quên thiết bị** ngay trên loa tương ứng.
9. Bấm **Test loa** để kiểm tra.

Nếu không nghe tiếng:

- Kiểm tra loa đã bật và còn pin.
- Đưa loa lại gần robot.
- Tắt loa rồi bật lại.
- Quét Bluetooth lại.
- Bấm làm mới trạng thái và kiểm tra loa có nhãn **đang dùng** hay chưa.

## 7. Dùng Nút Ở Bụng Robot

Robot dùng một nút bấm ở bụng để điều khiển nhanh.

| Thao tác | Chức năng |
| --- | --- |
| Bấm giữ | Bắt đầu ghi âm câu hỏi |
| Thả nút | Dừng ghi âm và gửi câu hỏi cho robot xử lý |
| Bấm 1 lần | Dừng nhạc, hoặc chuyển bước tiếp theo khi robot đang hướng dẫn bài từng bước |
| Bấm nhanh 2 lần | Hiện tên Wi-Fi và địa chỉ trang quản lý trong 5 giây |
| Bấm nhanh 3 lần | Quên Wi-Fi cũ và bật lại `robotpi-setup` để cấu hình Wi-Fi mới |

Khi robot đang đọc câu trả lời, bấm nút một lần sẽ làm robot im ngay để bạn nói tiếp hoặc hỏi câu khác.

## 8. Hỏi Robot Bằng Giọng Nói

### Cách 1: Gọi “robot ơi”

1. Chờ robot ở trạng thái sẵn sàng và không ở chế độ ngủ.
2. Nói rõ “robot ơi”, sau đó đọc luôn câu hỏi.
3. Khi nhận đúng wake phrase, màn hình chuyển sang **Đang nghe**.
4. Nói xong và im lặng; robot tự kết thúc đoạn ghi âm rồi xử lý.

Ví dụ: **“Robot ơi, quang hợp là gì?”**

### Cách 2: Bấm giữ nút

1. Chờ robot ở trạng thái sẵn sàng.
2. Bấm giữ nút ở bụng robot.
3. Nói câu hỏi rõ ràng, gần micro.
4. Nói xong thì thả nút.
5. Robot sẽ xử lý, trả lời bằng giọng nói và hiển thị nội dung ngắn trên màn hình.

Ví dụ câu hỏi:

```text
Robot ơi, định luật Ôm là gì?
```

```text
Robot ơi, 2 cộng 3 bằng mấy?
```

```text
Robot ơi, giải thích cho tôi vì sao có ngày và đêm.
```

```text
Robot ơi, hướng dẫn tôi giải phương trình 2x + 5 = 13.
```

Nếu robot báo không nghe rõ:

- Nói gần micro hơn.
- Nói chậm hơn.
- Giảm tiếng ồn xung quanh.
- Bấm giữ và nói lại.

## 9. Hỏi Bài Tập Theo Từng Bước

Với bài toán hoặc bài tập cần giải nhiều bước, robot có thể hướng dẫn từng bước.

Ví dụ:

```text
Robot ơi, hướng dẫn tôi giải phương trình 2x + 5 = 13 từng bước.
```

Robot sẽ đọc bước 1 và chờ bạn làm. Khi làm xong:

1. Bấm nút ở bụng robot 1 lần.
2. Robot chuyển sang bước tiếp theo.
3. Lặp lại đến khi xong bài.

## 10. Khi Nào Robot Sẽ Chụp Ảnh?

Robot chỉ nên chụp ảnh khi bạn nói rõ là cần dùng camera hoặc chỉ vào bài trước camera.

Các câu nên dùng:

```text
Robot ơi, chụp ảnh bài này và giải giúp tôi.
```

```text
Robot ơi, dùng camera xem câu 18 giải thế nào.
```

```text
Robot ơi, chụp trang này và đọc đề bài cho tôi.
```

```text
Robot ơi, xem chỗ này điền gì.
```

```text
Robot ơi, dùng camera xem vật này là gì.
```

Khi muốn robot chụp ảnh:

1. Đặt sách, vở hoặc vật cần xem trước camera.
2. Giữ cho hình không rung.
3. Bật đủ sáng.
4. Bấm giữ nút và nói câu có ý định chụp rõ ràng.
5. Thả nút.
6. Robot sẽ báo đang chụp, chụp ảnh rồi gửi đi xử lý.

Nếu bạn không muốn robot chụp ảnh, hãy nói rõ:

```text
Robot ơi, chỉ giải thích thôi, không chụp ảnh.
```

## 11. Mẹo Để Robot Nhận Bài Tốt Hơn

- Đặt trang vở thẳng, không nghiêng quá nhiều.
- Không che chữ bằng tay.
- Đưa camera đủ gần để chữ rõ.
- Tránh ánh sáng lóa trên giấy.
- Nếu bài dài, có thể hỏi từng phần hoặc từng câu.
- Với công thức toán, nên đọc rõ đề nếu ảnh không đủ rõ.

## 12. Mở Trang Quản Lý Để Cấu Hình Nhanh

Trong trang quản lý, người dùng thường cần các phần sau:

- **Wi-Fi**: quét và đổi mạng Wi-Fi.
- **Âm thanh**: kết nối/ngắt/quên loa Bluetooth, chỉnh âm lượng, test loa/mic và cấu hình wake phrase.
- **Cấu hình**: chọn TFT 4 inch hoặc OLED 1.3 inch, đặt thời gian ngủ.
- **Camera**: xem thử camera và ảnh vừa chụp.
- **Hỏi robot**: nhập câu hỏi bằng bàn phím để test khi chưa dùng micro.

Không nên thay đổi các mục không hiểu rõ.

## 13. Các Trạng Thái Thường Gặp

| Trạng thái | Ý nghĩa | Cách xử lý |
| --- | --- | --- |
| Đang khởi động | Robot vừa được cấp nguồn | Chờ thêm |
| Cấu hình Wi-Fi | Robot chưa vào được Wi-Fi nhà | Kết nối `robotpi-setup` và cấu hình Wi-Fi |
| Sẵn sàng | Robot dùng được | Nói “robot ơi” hoặc bấm giữ nút để hỏi |
| Đang nghe | Robot đang ghi âm | Nói xong rồi im lặng, hoặc thả nút nếu đang bấm giữ |
| Đang suy nghĩ | Robot đang xử lý | Chờ robot trả lời |
| Đang ngủ | TFT đen; OLED phụ hiện đồng hồ, wake phrase tạm dừng | Bấm nút để đánh thức |

## 14. Xử Lý Lỗi Nhanh

### Không Vào Được Trang Quản Lý

1. Bấm nhanh nút 2 lần để xem đúng IP.
2. Kiểm tra điện thoại/máy tính đang cùng Wi-Fi với robot.
3. Nếu robot đang ở setup mode, kết nối vào `robotpi-setup` và mở `http://10.42.0.1:8765/`.

### Robot Không Vào Được Wi-Fi Nhà

1. Kiểm tra Wi-Fi là 2.4GHz.
2. Kiểm tra mật khẩu Wi-Fi.
3. Đặt robot gần router hơn.
4. Bấm nhanh nút 3 lần để bật lại `robotpi-setup`, rồi cấu hình lại.

### Không Nghe Tiếng Loa

1. Kiểm tra loa đã bật.
2. Kiểm tra loa Bluetooth có nhãn **đang dùng**; nếu không, robot sẽ phát qua loa USB mặc định.
3. Bấm **Test loa** trong trang quản lý.
4. Tăng âm lượng loa.

### Robot Không Nghe Rõ

1. Nói gần micro hơn.
2. Kiểm tra micro đã cắm đúng cổng mic của USB soundcard.
3. Bấm **Test mic** trong trang quản lý.
4. Giảm tiếng ồn xung quanh.

### Camera Nhìn Mờ

1. Lau mặt camera.
2. Tăng ánh sáng.
3. Đưa bài lại gần hoặc xa hơn một chút để lấy nét rõ hơn.
4. Mở preview camera trong trang quản lý để căn lại.

## 15. Tóm Tắt Thao Tác Quan Trọng

- Lần đầu dùng: vào Wi-Fi `robotpi-setup`, mở `http://10.42.0.1:8765/`, cấu hình Wi-Fi nhà.
- Xem địa chỉ quản lý: bấm nhanh nút 2 lần.
- Đổi Wi-Fi: bấm nhanh nút 3 lần.
- Hỏi robot: nói “robot ơi” rồi đọc câu hỏi, hoặc bấm giữ nút, nói, rồi thả nút.
- Chụp ảnh bài/vật: nói rõ `chụp ảnh`, `dùng camera`, `xem bài này`, `xem trang này`, `xem chỗ này`.
- Chuyển bước hướng dẫn bài tập: bấm nút 1 lần.