المحتويات

المقدمة

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

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

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

أوامر Basic 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 باستخدامها بشكل حكيم وعدم تغيير أي معلمات لأنها يمكن أن تؤدي إلى فقدان الشبكة.