أستكشاف أخطاء البوابات الخلوية وإصلاحها باستخدام أوامر AT

المقدمة

يصف هذا المستند إستخدام أوامر AT لمودم CG522-E، Sierra Wireless EM9190 التي يمكن تطبيقها من نظام تشغيل CG522.

ما هي الأوامر؟ 

أوامر AT، أو أوامر الانتباه، هي مجموعة من التعليمات تستخدم للتحكم في أجهزة المودم. يأتي الاسم "AT" من بادئة الانتباه التي يجب أن تسبق كل أمر للحصول على اهتمام المودم. يتم إستخدام هذه الأوامر لإدارة العديد من وظائف المودم، بما في ذلك الاتصال والتعليق وتغيير معلمات الاتصال.

لماذا نحتاج إلى معرفة AT Commands؟

تعد أوامر AT ضرورية لعدة أسباب، وخاصة عند التعامل مع إتصالات المودم والتحكم في تطبيقات متعددة. هنا بعض الأسباب الرئيسية لماذا أوامر AT مطلوبة:

1. التحكم في الجهاز: توفر أوامر AT طريقة قياسية للتحكم في وظائف المودم، مثل أرقام الطلب، وإرسال الرسائل واستقبالها، وإدارة إتصالات الشبكة.
2. التكوين: وهي تسمح للمستخدمين بتكوين إعدادات المودم، بما في ذلك معلمات الشبكة وإعدادات إرسال البيانات وإدارة الطاقة. ويعد هذا أمرا بالغ الأهمية لتحسين الأداء وضمان التوافق مع الشبكات المختلفة.
3. التشخيصات واستكشاف الأخطاء وإصلاحها: يمكن إستخدام أوامر AT لاستعلام المودم عن معلومات الحالة وفحص جودة الإشارة واسترداد رموز الأخطاء، مما يساعد في تشخيص مشاكل الاتصال واستكشاف أخطائها وإصلاحها.

وبشكل عام، تعد أوامر AT أداة بالغة الأهمية بالنسبة للمطورين والمهندسين والفنيين الذين يحتاجون إلى التفاعل مع أجهزة المودم وإدارتها بكفاءة وفعالية. فهي توفر الواجهة اللازمة لمجموعة واسعة من مهام وتطبيقات الاتصال.

كيفية تشغيل أوامر AT على CG522-E

يمكن تنفيذ هذا الإجراء ببساطة من خلال تشغيل الأوامر من جلسة عمل CLI نشطة إلى عبارة الجوال.

CellularGateway# cellular 1 modem-at-commands
Value for '' (<string>): 
    
    

cellular_modem_at_cmd: modem-at-response

أوامر Basic AT

ATI، المعروفة أيضا باسم AT IDENTIFICATION، هي أمر يمكن إستخدامه لإظهار صناعة المودم، وطرازه، والبرامج الثابتة التي يعمل بها، و IMEI، والرقم التسلسلي المصنع.

CellularGateway# cellular 1 modem-at-commands
Value for '' (<string>): ati

cellular_modem_at_cmd: modem-at-response ati
Manufacturer: Sierra Wireless, Incorporated
Model: EM9190
Revision: SWIX55C_03.09.11.00 7bf975 jenkins 2022/06/10 20:36:01
IMEI: 111111111111
IMEI SV: 22
FSN: XXXXXXXXXXXX
+GCAP: +CGSM
OK

at!priid؟ يعرض إصدار OEM PRI وخيارات PRI لشركات النقل المتوفرة.

cellular_modem_at_cmd: modem-at-response AT!PRIID?
PRI Part Number: 9909919
Revision: 001.009
Customer: Cisco
Carrier PRI: 9999999_9909619_SWIX55C_03.09.11.00_01_ATT_030.046_001
Carrier PRI: 9999999_9911061_SWIX55C_03.09.11.00_01_BELL_030.007_001
Carrier PRI: 9999999_9909622_SWIX55C_03.09.11.00_01_DOCOMO_030.041_003
Carrier PRI: 9999999_9909621_SWIX55C_03.09.11.00_01_GENERIC_030.044_006
Carrier PRI: 9999999_9910814_SWIX55C_03.09.11.00_01_KDDI_030.025_001
Carrier PRI: 9999999_9910766_SWIX55C_03.09.11.00_01_SOFTBANK_030.031_004
Carrier PRI: 9999999_9910398_SWIX55C_03.04.03.00_01_TELSTRA_030.016_001
Carrier PRI: 9999999_9910308_SWIX55C_03.10.07.00_01_TMO_030.052_000
Carrier PRI: 9999999_9909620_SWIX55C_03.09.11.00_01_VERIZON_030.046_003
OK

في!IMPREF؟ يعرض البرنامج الثابت PRI والحامل المستخدم بجانب الناقل المفضل في حالة تكوين أي منهما. 

cellular_modem_at_cmd: modem-at-response AT!IMPREF?
!IMPREF:
preferred fw version: 00.00.00.00
preferred carrier name: AUTO-SIM
preferred config name: AUTO-SIM_000.000_000
preferred subpri index: 000
current fw version: 03.09.11.00
current carrier name: GENERIC
current config name: GENERIC_030.044_006
current subpri index: 000
OK

في!CPIN؟ إظهار ما إذا كانت بطاقة SIM جاهزة أو تتطلب تنشيط رقم PIN.

cellular_modem_at_cmd: modem-at-response AT+CPIN?
+CPIN: READY
OKAT+CPIN="SIM-PIN" is the command to insert a PIN to unlock the SIM.

cellular_modem_at_cmd: modem-at-response AT+CPIN="3045"
OK

ومع ذلك، في حالة إعادة تشغيل البوابة الخلوية أو المودم، يلزم إدخال رقم التعريف الشخصي (PIN) مرة أخرى.

يمكن تطبيق SIM-PIN على AT+CLCK=SC"،0 لإلغاء تأمين SIM بشكل دائم، وبالتالي لا حاجة لإدراج PIM مرة أخرى بعد إعادة تحميل.

cellular_modem_at_cmd: modem-at-response AT+CLCK="SC",0,"3045"
OK

AT+CREG؟ للتحقق من حالة تسجيل الشبكة الحالية للمودم إلى الشبكة المحولة للدائرة، المعروفة بشبكات GSM. ومن المتوقع ان يعيد زوجا من الثقوب.

القيمة الأولى من هذا الزوج هي العملية:

يكون |0 هو الإعداد الافتراضي وهو يعني أنه يجب التحقق من تسجيل الشبكة يدويا.

يشير ٪1 إلى كود النتيجة الذي يتم إرجاعه عند حدوث تغيير على الشبكة.

2 لإظهار معلومات التسجيل والموقع عند التسجيل.

أنت لا تحتاج أن يغير هذا قيمة ما لم ينصح ب TAC. القيمة الثانية لهذا الزوج هي حالة التسجيل ويمكن تفسيرها.

• 0- غير مسجل، لا يبحث الجهاز حاليا عن عامل تشغيل جديد.
• 1- مسجل في الشبكة المنزلية.
• 2- غير مسجل، ولكن الجهاز يبحث حاليا عن مشغل جديد.
• 3- رفض التسجيل.
• 4- غير معروف. على سبيل المثال، خارج النطاق.
• 5- مسجل، تجوال. الجهاز مسجل على شبكة أجنبية (وطنية أو دولية).

cellular_modem_at_cmd: modem-at-response at+creg?
+CREG: 0,1
OK

في هذه القصاصة، يمكننا أن نرى أن العملية ثبتت إلى 0 والتسجيل ثبتت إلى 1. 

AT+CEREG؟ للتحقق من حالة تسجيل الشبكة الحالية للمودم إلى الشبكة التي يتم تحويلها بواسطة الحزمة المعروفة ب Internet Access. إرجاع القيم التي هي نفس الأمر السابق:

cellular_modem_at_cmd: modem-at-response at+creg?
+CREG: 0,1
OK

AT+CGREG؟ للتحقق من حالة تسجيل الشبكة الحالية للمودم إلى شبكة GPRS. إرجاع القيم التي هي نفس الأمر السابق:

cellular_modem_at_cmd: modem-at-response at+cgreg?
+CGREG: 0,0
OK

ترجع AT+CIMI قيمة IMSI:

cellular_modem_at_cmd: modem-at-response AT+CIMI
268069668483162

ترجع AT+CCID قيمة ICCID:

cellular_modem_at_cmd: modem-at-response AT+CCID
+CCID: 89351060001115740710

at!UIMS؟ إرجاع رقم فتحة بطاقة SIM النشطة:

cellular_modem_at_cmd: modem-at-response AT!UIMS?
!UIMS: 0

AT!GSTATUS؟ للتحقق من حالة الاتصال، يرجى التحقق من وضع النظام ENDC (NSA 5G) للتحقق من وجود اتصال نشط من الجيل الخامس. إذا كان وضع النظام هو LTE، فلا تكون 5G نشطة. ويعتبر نطاق LTE المشار إليه هو نطاق الربط 4G لاتصال ENDC.

نطاقات SSC (خلايا الخدمة الثانوية) هي للنطاقات الأكثر إستخداما لتجميع الناقل، ولكن لأن لدينا اتصال نشط من الجيل الخامس هنا، نطاقات SSC غير نشطة. نطاق NR5G المشار إليه هو نطاق 5G المستخدم لاتصال البيانات.

cellular_modem_at_cmd: modem-at-response AT!GSTATUS?
!GSTATUS:
Current Time: 1730657 Temperature: 44
Thermal Mitigation Level: 0
Reset Counter: 2 Mode: ONLINE
System mode: ENDC PS state: Attached
LTE band: B1 LTE bw: 20 MHz
LTE Rx chan: 500 LTE Tx chan: 18500
EMM state: Registered Normal Service
RRC state: RRC Connected
IMS reg state: REGISTERED IMS mode: Normal
IMS Srv State: FULL SMS,NO VoIP
PCC RxM RSSI: --- PCC RxM RSRP: ---
PCC RxD RSSI: -59 PCC RxD RSRP: -86
PCC RxM1 RSSI: --- PCC RxM1 RSRP: ---
PCC RxD1 RSSI: --- PCC RxD1 RSRP: ---
PCC Tx Power: -20 TAC: bc7a (48250)
RSRQ (dB): -7.8 Cell ID: 00066e2b (421419)
SINR (dB): 14.2
SCC1 NR5G band: n78 SCC1 NR5G bw: 90 MHz
SCC1 NR5G Tx Power: 3 SCC1 NR5G Tx chan: 650332
SCC1 NR5G Rx chan: 650332
NR5G RSRP (dBm): -94 NR5G RSRQ (dB): -11
NR5G SINR (dB): 19.5

nr!INFO؟ وضع الاتصال NSA (غير مستقل) إذا كان هناك اتصال 5G نشط. يوضح هذا الإخراج أنه يتم إستخدام نطاق NR5G:

cellular_modem_at_cmd: modem-at-response AT!NRINFO?
!NRINFO:
Connectivity Mode: NSA
NR5G Cell ID: 67
NR5G band: n78 NR5G Carrier ID: 0
NR5G dl bw: 90 MHz NR5G ul bw: 90 MHz
NR5G Tx Power: 3 NR5G Tx chan: 650332
NR5G Rx chan: 650332
NR5G dl MIMO: 0 NR5G ul MIMO: 1
NR5G(sub6) RxM RSSI (dBm): -60.6 NR5G(sub6) RxD RSSI (dBm): -60.8
NR5G(sub6) RxM1 RSSI (dBm): -60.1 NR5G(sub6) RxD1 RSSI (dBm): -61.8
NR5G RSRP (dBm): -94 NR5G RSRQ (dB): -11
NR5G SINR (dB): 20.0

من +CGDCONT؟ للتحقق من أسماء نقاط الوصول (APN) المدمجة:

cellular_modem_at_cmd: modem-at-response AT+CGDCONT?
+CGDCONT: 1,"IPV4V6","internet","0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0",0,0,0,0,,,,,,,,,"",,,,0
+CGDCONT: 2,"IPV4V6","ims","0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0",0,0,0,0,,,,,,,,,"",,,,0

يقوم AT+CGDCONT=X بمسح APN محدد وإزالته استنادا إلى رقم الفهرس الخاص به:

cellular_modem_at_cmd: modem-at-response AT+CGDCONT?
+CGDCONT: 1,"IPV4V6","internet","0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0",0,0,0,0,,,,,,,,,"",,,,0
+CGDCONT: 2,"IPV4V6","ims","0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0",0,0,0,0,,,,,,,,,"",,,,0
OK

CellularGateway#
CellularGateway# cellular 1 modem-at-commands
Value for '' (<string>): AT+CGDCONT=2

cellular_modem_at_cmd: modem-at-response AT+CGDCONT=2
OK

CellularGateway#
CellularGateway# cellular 1 modem-at-commands
Value for '' (<string>): AT+CGDCONT?

cellular_modem_at_cmd: modem-at-response AT+CGDCONT?
+CGDCONT: 1,"IPV4V6","internet","0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0",0,0,0,0,,,,,,,,,"",,,,0
OK

AT+PCINFO؟ فحص حالة الطاقة المنخفضة وحالة المودم. إذا كان أي من ناخبي LPM (وضع الطاقة المنخفضة) ليس صفرا، فإن ذلك يشير إلى سبب تعيين المودم على حالة الطاقة المنخفضة، قائمة ببعض من أكثر الأسباب شيوعا.

• الحالة: حالة الاتصال مطلوبة
• درجة الحرارة: درجة حرارة عالية
• فولت: خرج من الجهد الكهربائي الخاص بالمواصفات
• المستخدم: فرض بواسطة المستخدم
• W_DISABLE: فرض بواسطة المستخدم
• فوتا: عملية تحديث FOTA

cellular_modem_at_cmd: modem-at-response AT!PCINFO?
State: Online
LPM voters - Temp:0, Volt:0, User:0, W_DISABLE:0, IMSWITCH:0, BIOS:0, LWM2M:0, OMADM:0, FOTA:0, NVCRIT:0, RFCAL:0, MMWCAL:0, RFC_INIT:0
LPM persistence - None

AT!IMAGE؟ يسرد كافة الحزم الثابتة وصور PRO الموجودة على المودم:

cellular_modem_at_cmd: modem-at-response at!image?
TYPE SLOT STATUS LRU FAILURES UNIQUE_ID BUILD_ID
FW 1 GOOD 2 0 0 ?_? 03.09.11.00_?
FW 2 GOOD 1 0 0 ?_? 03.10.07.00_?
FW 3 GOOD 1 0 0 ?_? 03.04.03.00_?
Max FW images: 3
Active FW image is at slot 1
TYPE SLOT STATUS LRU FAILURES UNIQUE_ID BUILD_ID
PRI FF GOOD 0 0 0 030.046_001 03.09.11.00_ATT
PRI FF GOOD 0 0 0 030.007_001 03.09.11.00_BELL
PRI FF GOOD 0 0 0 030.041_003 03.09.11.00_DOCOMO
PRI FF GOOD 0 0 0 030.044_006 03.09.11.00_GENERIC
PRI FF GOOD 0 0 0 030.025_001 03.09.11.00_KDDI
PRI FF GOOD 0 0 0 030.031_004 03.09.11.00_SOFTBANK
PRI FF GOOD 0 0 0 030.016_001 03.04.03.00_TELSTRA
PRI FF GOOD 0 0 0 030.052_000 03.10.07.00_TMO
PRI FF GOOD 0 0 0 030.046_003 03.09.11.00_VERIZON
Max PRI images: 50

at!image=<op><type><slot>يحذف برنامجا ثابتا معينا.

• op = 0: حذف، 1: القائمة، 
• النوع = 0: و، 1: التكوين
• slot = فهرس فتحات التخزين الثابت، none يتضمن جميع الفتحات.

CellularGateway# cellular 1 modem-at-commands
Value for '' (<string>): at!image?

cellular_modem_at_cmd: modem-at-response at!image?
TYPE SLOT STATUS LRU FAILURES UNIQUE_ID BUILD_ID
FW 1 GOOD 2 0 0 ?_? 03.09.11.00_?
FW 2 GOOD 1 0 0 ?_? 03.10.07.00_?
FW 3 GOOD 1 0 0 ?_? 03.04.03.00_?
Max FW images: 3
Active FW image is at slot 1
TYPE SLOT STATUS LRU FAILURES UNIQUE_ID BUILD_ID
PRI FF GOOD 0 0 0 030.046_001 03.09.11.00_ATT
PRI FF GOOD 0 0 0 030.007_001 03.09.11.00_BELL
PRI FF GOOD 0 0 0 030.041_003 03.09.11.00_DOCOMO
PRI FF GOOD 0 0 0 030.044_006 03.09.11.00_GENERIC
PRI FF GOOD 0 0 0 030.025_001 03.09.11.00_KDDI
PRI FF GOOD 0 0 0 030.031_004 03.09.11.00_SOFTBANK
PRI FF GOOD 0 0 0 030.016_001 03.04.03.00_TELSTRA
PRI FF GOOD 0 0 0 030.052_000 03.10.07.00_TMO
PRI FF GOOD 0 0 0 030.046_003 03.09.11.00_VERIZON
Max PRI images: 50
OK

CellularGateway#
CellularGateway# cellular 1 modem-at-commands
Value for '' (<string>): AT!IMAGE=0,0,3

cellular_modem_at_cmd: modem-at-response AT!IMAGE=0,0,3
OK

CellularGateway#
CellularGateway# cellular 1 modem-at-commands
Value for '' (<string>): AT!IMAGE?

cellular_modem_at_cmd: modem-at-response AT!IMAGE?
TYPE SLOT STATUS LRU FAILURES UNIQUE_ID BUILD_ID
FW 1 GOOD 2 0 0 ?_? 03.09.11.00_?
FW 2 GOOD 1 0 0 ?_? 03.10.07.00_?
FW 3 EMPTY 0 0 0

إرجاع AT+COPS؟ وضع التحديد الحالي وتنسيق المشغل والمشغل وتقنية الوصول اللاسلكي. 

الشرطة: [وضع التحديد]،[تنسيق المشغل]،[المشغل]،[تقنية الوصول اللاسلكية] موافق

<stat> = حالة الشبكة.

• 0 = غير معروف
• 1 = متوفر
• 2 = الحالي
• 3 = ممنوع

<mode> = وضع التحديد.

• 0 = التحديد التلقائي
• 1 = التحديد اليدوي
• 2 = إلغاء التسجيل من الشبكة

<format> = تنسيق عامل التشغيل.

• 0 = أبجدية رقمية طويلة - "T-Mobile USA"
• 1 = أبجدية رقمية قصيرة - "TMO"
• 2 = رقمي مع MCC + MNC - "310260"

<oper> = معرف عامل التشغيل.

سلسلة من الأرقام ترجع معرف (معرفات) عامل التشغيل في <format> المدرج.

<acT> = تقنية الوصول اللاسلكية.

• 0 = GSM
• 1 = بروتوكول GSM Compact
• 2 = أوتران
• 3 = GSM w/EGPRS
• 4 = أوتران w/hsdpa
• 5 = uTRAN w/HSUPA
• 6 = أوتران w/hsdpa و hsupa
• 7 = E-Utran
• 8 = EC-GSM-IoT (وضع A/Gb)
• 9 = منفذ E-UTRAN (وضع NB-S1)
• 10 = E-UTRA متصل ب 5GCN.
• 11 = NR متصل ب 5GCN.
• 12 = 5G مستقلة
• 13 = غير مستقل 5G

cellular_modem_at_cmd: modem-at-response AT+COPS?
+COPS: 0,0,"MEO MEO",13
OK

at!يعرض Verinfo تفاصيل المضيف والمودم:

cellular_modem_at_cmd: modem-at-response AT!VERINFO
SBL: BOOT.SBL.4.1-00247
TZ: TZ.FU.5.9-00189
AOP: unknown
UEFI: SWIX55C_03.09.11.00
Mpss: SWIX55C_03.09.11.00 7bf975 jenkins 2022/06/10 20:36:01
OS: Linux version 4.14.206 Fri Jun 10 21:25:48 UTC 2022
Yocto: SWIX55C_03.09.11.00 2022 Fri Jun 10 21:25:48 UTC 2022
RootFS: SWIX55C_03.09.11.00 2022 Fri Jun 10 21:25:48 UTC 2022
Security: secure
RF_CAL_TREE: unknown

تعرض AT+CGCONTRDP تفاصيل الاتصال الحالي.

+CGCONTRDP: <cid>،<bearer_id>،<apn>،<ip address>، <dns ip address>، <secondary dns ip address>

• cid:معرف الاتصال.

• معرف_الحامل: طبيب أسنان الحامل.

• apn:اسم نقطة الوصول.

cellular_modem_at_cmd: modem-at-response AT+CGCONTRDP
+CGCONTRDP: 1,5,internet,<IP Address >,,< DNS Server1 >,<DNS Server2>
OK

at!flog؟ يعرض محفوظات إجراءات البرامج الثابتة. يلزم توفر هذا الأمر عند الشك في حدوث مشكلة انخفاض في الطاقة أو عطل.

cellular_modem_at_cmd: modem-at-response AT!FLOG?
!FLOG:
OK
Class long:
00000,1980/01/06 00:00:40.028,SWIX55C_01.07.2,COMMENT=Log created,LOG_VERSION=1.0
00001,1980/01/06 00:02:46.543,SWIX55C_01.07.2,NV_BACKUP=START,COMMENT=index 1
00001,1980/01/06 00:02:49.981,SWIX55C_01.07.2,NV_BACKUP=COMPLETE,COMMENT=index 1,STATUS=PASS
00001,1980/01/06 00:00:00.000,SWIX55C_,BOOT_HOLD=3,
00001,1980/01/06 00:00:00.000,C3091400,BOOT_HOLD=3,
00002,1980/01/06 00:06:06.390,C3091100,COPY_FROM_BACKUP=/swir/nvdelta/NVUP_GENERIC.010,STATUS=PASS
00002,1980/01/06 00:06:06.390,C3091100,COPY_FROM_BACKUP=/swir/nvdelta/NVUP_ATT.010,STATUS=PASS
00002,1980/01/06 00:06:06.390,C3091100,COPY_FROM_BACKUP=/swir/nvdelta/NVUP_VERIZON.010,STATUS=PASS
00002,1980/01/06 00:06:06.390,C3091100,COPY_FROM_BACKUP=/swir/nvdelta/NVUP_DOCOMO.010,STATUS=PASS
00002,1980/01/06 00:06:06.390,C3091100,COPY_FROM_BACKUP=/swir/nvdelta/NVUP_KDDI.010,STATUS=PASS
00002,1980/01/06 00:06:06.390,C3091100,COPY_FROM_BACKUP=/swir/nvdelta/NVUP_TMO.010,STATUS=PASS
00002,1980/01/06 00:06:06.390,C3091100,COPY_FROM_BACKUP=/swir/nvdelta/NVUP_SOFTBANK.010,STATUS=PASS
00002,1980/01/06 00:06:06.390,C3091100,COPY_FROM_BACKUP=/swir/nvdelta/NVUP_TELSTRA.010,STATUS=PASS
00002,1980/01/06 00:06:06.390,C3091100,COPY_FROM_BACKUP=/nvup/NVUP_1104703_EM9190_Cisco.020,STATUS=PASS
00002,1980/01/06 00:06:06.390,C3091100,COPY_FROM_BACKUP=/swir/nvdelta/NVUP_BELL.010,STATUS=PASS
00002,1980/01/06 00:06:06.390,C3091100,NV_UPDATE=START,FILE=/nvup/NVUP_1104703_EM9190_Cisco.020
00002,198

AT!Gcdump، ملف التعطل والتعقب في حالة حدوث أعطال في المودم.

Value for '' (<string>): AT!GCDUMP

cellular_modem_at_cmd: modem-at-response AT!GCDUMP
No crash data available
OK

القرار

في النهاية، تعطينا أوامر AT الرؤية التي نحتاجها على عمليات المودم.

توصي Cisco باستخدامها بشكل حكيم وعدم تغيير أي معلمات لأنها يمكن أن تؤدي إلى فقدان الشبكة.