Trang này mô tả cách kiểm soát Wi-Fi trên thiết bị Cuttlefish.
Sử dụng Wmediumd
Tính năng Wi-Fi của Cuttlefish sử dụng Wmediumd, một công cụ mô phỏng, để mô phỏng môi trường không dây. Wmediumd quản lý việc phân phối các gói Wi-Fi giữa hai thực thể Cuttlefish hoặc giữa một thực thể Cuttlefish và một thực thể OpenWRT. Wmedium cho Cuttlefish được triển khai trong
/platform/external/wmediumd/.
Để kiểm soát giao diện Wmediumd, hãy sử dụng công cụ WmediumdService (Android 14 trở lên) hoặc wmedium_control (Android 13 trở xuống).
WmediumdService
Đối với các thiết bị chạy Android 14 trở lên, hãy sử dụng WmediumdService để kiểm soát công cụ Wmedium. Để biết thông tin chi tiết về cách kiểm soát
dịch vụ này bằng API REST hoặc giao diện dòng lệnh (CLI), hãy xem
bài viết Cuttlefish: Kiểm soát môi trường.
Bảng sau đây liệt kê các phương thức trong WmediumdService. Để biết thông tin chi tiết
về các phương thức, hãy xem
wmediumd.proto.
| Phương thức | Mô tả |
|---|---|
ListStations |
Liệt kê tất cả các trạm được đính kèm vào Wmediumd. |
LoadConfig |
Tải cấu hình Wmediumd bằng một tệp nhất định. |
ReloadConfig |
Tải lại tệp cấu hình Wmediumd hiện đang được tải. |
SetCivicloc
|
Đặt vị trí dân sự (ví dụ: địa chỉ bưu chính) của trạm cụ thể. |
SetLci
|
Đặt LCI (vĩ độ, kinh độ, độ cao) của trạm cụ thể. |
SetPosition |
Đặt vị trí của trạm trong không gian hai chiều. |
SetSnr
|
Đặt giá trị tỷ lệ tín hiệu trên tạp âm (SNR) (0-255) giữa hai trạm. |
SetTxpower |
Đặt công suất truyền (công suất TX) của trạm cụ thể. |
StartPcap
|
Bắt đầu ghi lại tất cả các khung được truyền qua không trung và lưu vào tệp .pcap. |
StopPcap |
Dừng và hoàn tất quá trình ghi lại gói dữ liệu hiện tại. |
wmediumd_control
Đối với các thiết bị chạy Android 13 trở xuống, hãy sử dụng công cụ wmediumd_control để kiểm soát môi trường không dây trong các thiết bị Cuttlefish.
Bảng sau đây liệt kê các lệnh con trong wmediumd_control.
| Lệnh con | Mô tả |
|---|---|
list_stations
|
Liệt kê tất cả các trạm được đính kèm vào Wmediumd. |
reload_config
[CONFIG_FILE_PATH]
|
Tải lại cấu hình Wmediumd bằng CONFIG_FILE_PATH . Nếu bạn bỏ qua CONFIG_FILE_PATH hãy tải lại tệp cấu hình hiện đang được tải. |
set_civicloc MAC_ADDR
CIVICLOC |
Đặt vị trí dân sự (ví dụ: địa chỉ bưu chính) của trạm cụ thể. |
set_lci MAC_ADDR
LCI |
Đặt LCI (vĩ độ, kinh độ, độ cao) của trạm cụ thể. |
set_position MAC_ADDR
X_POSITION
Y_POSITION |
Đặt vị trí của trạm trong không gian hai chiều. |
set_snr MAC_ADDR1
MAC_ADDR2
SNR_VALUE |
Đặt giá trị tỷ lệ tín hiệu trên tạp âm (SNR) (0-255) giữa hai trạm. |
start_pcap
PCAP_FILE_PATH
|
Bắt đầu ghi lại tất cả các khung được truyền qua không trung và lưu vào tệp .pcap. |
stop_pcap
|
Dừng và hoàn tất quá trình ghi lại gói dữ liệu hiện tại. |
Sử dụng OpenWRT
Tính năng Wi-Fi của Cuttlefish hỗ trợ sử dụng OpenWRT để ảo hoá các điểm truy cập Wi-Fi (AP). Việc triển khai OpenWRT cho Cuttlefish nằm ở
platform/external/openwrt-prebuilts/.
Để kết nối với OpenWRT, hãy sử dụng thông tin trong bảng sau. Nếu bạn không nối thêm bất kỳ tuỳ chọn nào khi khởi chạy Cuttlefish, thì mã thiết bị là cvd-1 và địa chỉ IP WAN OpenWRT là 192.168.94.2 hoặc 192.168.96.2.
| Loại kết nối | Đích đến |
|---|---|
| SSH | root@OPENWRT_WAN_IP_ADDRESS |
| Trang web | https://localhost:1443/devices/DEVICE_ID/openwrt |
| Trang web (cũ) | https://OPENWRT_WAN_IP_ADDRESS |
OpenwrtControlService
Đối với các thiết bị chạy Android 14 trở lên, để kiểm soát và định cấu hình các AP Wi-Fi ảo hoá, hãy sử dụng dịch vụ OpenwrtControlService. Để biết thông tin chi tiết về cách kiểm soát dịch vụ này
bằng API REST hoặc CLI, hãy xem
bài viết Cuttlefish: Kiểm soát môi trường.
Bảng sau đây liệt kê các phương thức trong OpenwrtControlService. Để biết thông tin chi tiết về các phương thức, hãy xem
openwrt_control.proto.
| Phương thức | Mô tả |
|---|---|
LuciRpc |
Gửi lệnh gọi RPC đến giao diện web Luci trong OpenWRT. |
OpenwrtIpAddr
|
Nhận địa chỉ IP WAN OpenWRT. Sử dụng địa chỉ này để kết nối một thực thể OpenWRT thông qua SSH hoặc giao diện web. |