Wi-Fi

בדף הזה מוסבר איך לשלוט ב-Wi-Fi במכשיר Cuttlefish.

שימוש ב-Wmediumd

התכונה Cuttlefish Wi-Fi משתמשת בכלי הדמיה בשם Wmediumd כדי לדמות את המדיום האלחוטי. Wmediumd מנהל את העברת החבילות של Wi-Fi בין שתי מכונות Cuttlefish או בין מכונה של Cuttlefish למכונה של OpenWRT. Wmedium ל-Cuttlefish מוטמע ב-/platform/external/wmediumd/.

כדי לשלוט בממשק Wmediumd, משתמשים בכלי WmediumdService (Android מגרסה 14 ואילך) או בכלי wmedium_control (Android מגרסה 13 ומטה).

WmediumdService

במכשירים עם Android מגרסה 14 ואילך, אפשר להשתמש ב-WmediumdService כדי לשלוט בכלי Wmedium. למידע נוסף על בקרה על השירות באמצעות ה-API ל-REST או באמצעות ממשק שורת הפקודה (CLI), ראו Cuttlefish: בקרת סביבה.

בטבלה הבאה מפורטים השיטות ב-WmediumdService. מידע מפורט על השיטות זמין במאמר wmediumd.proto.

שיטות תיאור
ListStations הצגת רשימה של כל התחנות שמצורפות ל-Wmediumd.
LoadConfig טעינת תצורת Wmediumd באמצעות קובץ נתון.
ReloadConfig טעינה מחדש של קובץ התצורה של Wmediumd שנטען כרגע.
SetCivicloc מגדירים את המיקום הרשמי (למשל, כתובת למשלוח דואר) של התחנה הספציפית.
SetLci מגדירים את ה-LCI (קו הרוחב, קו האורך והגובה) של התחנה הספציפית.
SetPosition הגדרת המיקום של התחנה במרחב דו-מימדי.
SetSnr הגדרת ערך יחס אות לרעש (SNR) (0-255) בין שתי תחנות.
SetTxpower הגדרת עוצמת השידור (TX power) של התחנה הספציפית.
StartPcap מתחילים לתעד את כל המסגרות שמשודרות באוויר ושומרים אותן בקובץ .pcap.
StopPcap עצירת תיעוד החבילות הנוכחי והשלמתו.

wmediumd_control

במכשירים עם Android מגרסה 13 ומטה, משתמשים בכלי wmediumd_control כדי לשלוט בסביבה האלחוטית במכשירי Cuttlefish. בטבלה הבאה מפורטים פקודות המשנה של wmediumd_control.

פקודות משנה תיאור
list_stations הצגת רשימה של כל התחנות שמצורפות ל-Wmediumd.
reload_config [CONFIG_FILE_PATH] טוענים מחדש את ההגדרות של Wmediumd באמצעות CONFIG_FILE_PATH . אם השדה CONFIG_FILE_PATH לא יצוין, קובץ התצורה הנוכחי יטען מחדש.
set_civicloc MAC_ADDR CIVICLOC מגדירים את המיקום הרשמי (למשל, כתובת למשלוח דואר) של התחנה הספציפית.
set_lci MAC_ADDR LCI מגדירים את ה-LCI (קו הרוחב, קו האורך והגובה) של התחנה הספציפית.
set_position MAC_ADDR X_POSITION Y_POSITION הגדרת המיקום של התחנה במרחב דו-מימדי.
set_snr MAC_ADDR1 MAC_ADDR2 SNR_VALUE הגדרת ערך יחס אות לרעש (SNR) (0-255) בין שתי תחנות.
start_pcap PCAP_FILE_PATH מתחילים לתעד את כל הפריים שמשודרים לשידור חי ושומרים אותם בקובץ .pcap.
stop_pcap עצירת תיעוד החבילות הנוכחי וסיום התהליך.

שימוש ב-OpenWRT

התכונה Wi-Fi של Cuttlefish תומכת בשימוש ב-OpenWRT לווירטואליזציה של נקודות גישה (AP) ל-Wi-Fi. ההטמעה של OpenWRT עבור Cuttlefish נמצאת בכתובת platform/external/openwrt-prebuilts/.

כדי להתחבר ל-OpenWRT, משתמשים במידע שמופיע בטבלה הבאה. אם לא מצרפים אפשרויות כשמריצים את Cuttlefish, מזהה המכשיר הוא cvd-1 וכתובת ה-IP של OpenWRT WAN היא 192.168.94.2 או 192.168.96.2.

סוג החיבור יעד
SSH root@OPENWRT_WAN_IP_ADDRESS
דף אינטרנט https://localhost:1443/devices/DEVICE_ID/openwrt
דף אינטרנט (דור קודם) https://OPENWRT_WAN_IP_ADDRESS

OpenwrtControlService

במכשירים עם Android מגרסה 14 ואילך, כדי לשלוט ולקבוע את ההגדרות של נקודות Wi-Fi וירטואליות, משתמשים בשירות OpenwrtControlService. למידע נוסף על שליטה בשירות באמצעות ה-API ל-REST או ה-CLI, קראו את המאמר Cuttlefish: בקרת סביבה.

בטבלה הבאה מפורטים השיטות ב-OpenwrtControlService. מידע מפורט על השיטות זמין במאמר openwrt_control.proto.

שיטות תיאור
LuciRpc שליחת קריאה ל-RPC לממשק האינטרנט של Luci ב-OpenWRT.
OpenwrtIpAddr קבלת כתובת ה-IP של WAN ב-OpenWRT. משתמשים בכתובת הזו כדי להתחבר למכונה של OpenWRT דרך SSH או ממשק אינטרנט.