الكتابة مع الكتب
الكلمات الدلالية هي آلية تطبيق خاصة لإرسال ومعالجة التعليمات بشكل متسلسل. يمكنهم تكوين إعدادات لوحة التشفير، وقراءة وكتابة ذاكرة المرسل، وتنفيذ العمليات الأخرى.
استخدم السيناريوهات عندما يتطلب المتصفح إجراء برمجة يختلف عن المعيار MSA ويحتاج إلى سلسلة من التعليمات الخاصة لتخزين التغييرات في الذاكرة بنجاح. كما يمكن للكتاب المكتوبين تلقائيًا برمجة متكررة من مناطق الذاكرة المختلفة مع الحد الأدنى من مشاركة المشغل.
كيف أستخدم السيناريو؟
- افتح القائمة التحكم - كتابة باستخدام سكريبت - اختيار ملف سكريبته لتحديد مسار ملف السيناريو؛
- تأكد من أن المحرر يحتوي على الرمز الصحيح إذا كان السيناريو يستخدم بيانات المحرر أثناء التنفيذ.
- انقر على زر كتابة ذاكرة المرسل لتشغيل السيناريو.
عند تشغيل السيناريو، تتجاهل التطبيق إعدادات منطقة الذاكرة التي تم اختيارها حاليا. يجب تحديد مناطق القراءة والكتابة في أوامر السيناريو.
يرجى ملاحظة أن البرمجيات لا تثبت ما إذا كان الكتابة ناجحة بعد الانتهاء من السيناريو.
كيف يمكنني إزالة السيناريو المختار؟
اذهب إلى القائمة التحكم - كتابة باستخدام سيناريو - إعادة تعيين سيناريو إزالة السيناريو المحدد والعودة إلى الكتابة القياسية.
كيف أكتب سيناريو؟
ويستند سينتاكس الأوامر النصية على بروتوكول الأوامر SFPTotal.
مثال :
// Write password AABBCCDD to page A2 at offset 7B
w2A2007B03AABBCCDD
// Write the code from the editor to page A0 at offset 00
w2A000007F{00;7F}
// Write value 80 to page A2 at offset 7F
w2A2007F0080
// Write value 01 to page A2 at offset FF
w2A200FF0001
PAUSE
// Read code from page A0 at offset 00
R2A000007F
قم بإنشاء ملف نصي وإدخال تعليمات واحدة لكل خط. حفظ ملف السيناريو لاستخدام هذه الإجراءات البرمجة في التطبيق.
إضافية سكريبت الأوامر
يتم معالجة الأوامر الإضافية التالية من خلال التطبيق.
PAUSE
استراحة سكريبت تنفيذ الوقف الافتراضي هو 100 ms.
يحدد المعلم الاختياري مدة الفراغ في مللي ثانية.
PAUSE
Delay 100ms
PAUSE=2000
Delay 2000ms
SETCHECKSUM
إعادة حساب السجلات.
SETVAL
قم بتعيين خلية المحرر في offset XX لتقييم YY. تحديد قيم المعلمات في شكل HEX العلوي.
معدل الإعفاء يقبل القيم من 00 إلى 7F.
SETVAL 7F 03
{00;7F}
استبدال ماكرو {XX;YY} يتم استخدامها داخل الأوامر الأخرى لإدخال قطعة من الرمز من المحرر. أثناء تنفيذ السيناريو، يتم استبدال ماكرو تلقائيا مع البيانات الحالية المحرر بدءا من بايت XX وتمدد بايت YY.
ملاحظة أن قيمة المعلمات YY 00 في HEX يعني أن 1 بايت يتم استبداله ، بينما قيمة 7F في HEX يعني أنه يتم استبدال بايتات 128. إعداد YY إلى طول القسم في بايتين أقل من واحد ، يتم التعبير عنه في hexadecimal.
مثال: كتابة قسم 128 بايت إلى صفحة A2h في 80h بدءا.
w2A200807F{00;7F}
مثال: كتابة قطاع الحدود 96-byte DDM إلى صفحة A2h على offset 00h، تليها قراءة.
W2A200005F{00;5F}
مثال: تخصيص متغير لقطاع الرمز 16 بايت على 0x44 offset الذي يحتوي على الرقم التسلسلي.
$VAR2={44;0F}
$VAR1
متغيرات البوفر $VAR1. استخدم متغيرات البوفر لتخزين أجزاء الرمز من المحرر وإدخال محتوياتها أثناء تنفيذ السيناريو.
يدعم التطبيق 10 متغيرات بوفر، $VAR0–$VAR9.
$VAR1={00;43}
$VAR2={44;0F}
$VAR3={54;2B}
$VAR4=002AFE
$VAR5=4F
$YYYY
إدخال السنة الحالية في القيادة.
$MM
إدخال الشهر الحالي في الأمر.
$DD
إدخال اليوم الحالي في الأمر.
BACKUPTOFILE
ابدأ نسخة احتياطية لنوع الوحدة المحدد في إعدادات التطبيق. تقرأ التطبيق الصفحات المتاحة بشكل متتالي وتخزين البيانات إلى ملف. هذا الأمر يعادل استدعاء الوظيفة من قائمة التطبيق.
BACKUPDIR
إعداد دليل النسخ الاحتياطي. يمكن استخدام المعلمات الإضافية لإنشاء دليل مع اسم معين.
مثال: إنشاء دليل النسخ الاحتياطي مع التاريخ في اسمه.
$VAR5=SOMETEXT
BACKUPDIR=\$YYYY-$MM-$DD_$VAR5\
BACKUPTOFILE
IMPORTFILE
استيراد رمز HEX من ملف ثنائي إلى المحرر.
IMPORTFILE=\catalog\filename.bin
IMPORTHEX
إدخال رمز HEX إلى المحرر.
مثال: استيراد قطعة رمز 128 بايت إلى المحرر.
IMPORTHEX=030407100000000000000006670000000802001E4F454D2020202020202020202020202000000B4053465031302D535220202020202020204120202003520091001A000058473936535230313020202020202020303830393236202068F0031200001111A8DD05AA642FAA6F5A64DAF3285A9D000000000000000000F05E482F
استيراد الرمز إلى المحرر عن طريق إدراج متغيرات البوفر.
$VAR1={00;43}
$VAR2={44;0F}
$VAR3={54;2B}
IMPORTHEX=$VAR1$VAR2$VAR3
INCREMENT
زيادة قيمة المتغيرات التي تحتوي على تمثيل إكسادسيما للرمز بحيث يزداد العدد في نهاية تمثيل النص بمقدار واحد.
على سبيل المثال، تمثيل النص المتغير SN129YY00201 يتم تحويلها إلى SN129YY00202.
إذا كان الزرو يسبق الجزء العددي، يحاول التطبيق الحفاظ على طول الحبل الأصلي عندما يحتاج العدد المتزايد إلى رقم إضافي، وتحول القيمة إلى اليسار. وبالتالي فإن القيمة SN129YY00999 يتم تحويلها إلى SN129YY01000.
$VAR1={00;43}
// Assign the code area containing the serial number to a variable
$VAR2={44;0F}
$VAR3={54;2B}
INCREMENT $VAR2
IMPORTHEX=$VAR1$VAR2$VAR3
ERASEVENDORCODE
ملء المنطقة المحددة للبائع في المحرر بالزيوت.
COUNTER
مقارنة إيتراation سكريبت.
ضع هذا الأمر في بداية ملف السيناريو الذي يعمل في قوس قزح. يتوفر حساب الإيترات الحالي من خلال متغير $COUNTER.
// Invoke the iteration counter
COUNTER
// Assign the current counter value to a variable
$VAR0=$COUNTER
// Display the counter value
ECHO $COUNTER
IF A ... B THEN ...
مقارنة القيم استخدم هذا البناء لمقارنة A و B وتنفذ الأمر الذي يلي THEN إذا كانت الحالة المحددة صحيحة.
// Assign numeric values to variables
$VAR1=10
$VAR2=20
// Display a message box if the condition is true.
IF $VAR1 < $VAR2 THEN MSGBOX HELLO WORLD!
LOOP
تكرار السيناريو ضع هذا الأمر في نهاية ملف السيناريو لإبلاغ التطبيق بتشغيل الإجراء مرة أخرى. قاعدة UNLOOP تقوم بإلغاء LOOP استخدم شرطًا للخروج من الدائرة وتجنب التكرار الذي لا نهاية له.
مثال مع شروط
COUNTER
...
R1A000007F
...
// Repeat the script until 10 iterations have completed
IF $COUNTER < 10 THEN LOOP
إذا دخل سكريبت مفتاحًا لا نهاية له، توقف عن استخدامه باستخدام الأمر العالمي للانقطاع في <أدوات - عمليات الانقطاع>.
STRTOHEX
تحويل النص التالي للمشغل إلى شريط HEX.
$VAR9=STRTOHEX QSFP28-SR4
MSGBOX $VAR9
HEXTOSTR
تحويل شريط HEX بعد المشغل إلى نص.
$VAR9=HEXTOSTR 5153465032382D535234202020202020
MSGBOX $VAR9
PADRIGHTHEX
ضع القيمة السادسة في $VAR1 على اليمين مع الشخصية التي يكون رمزها YY حتى يصل طول تمثيل النص إلى XX.
تنسيق الأوامر :
PADRIGHTHEX XX YY $VAR1
XXرقم عشري يحدد طول تمثيل النص في شريط HEX؛YYالرمز HEX للشخصية المستخدمة لضبط الحبل إلى الطول المطلوب.$VAR1المتغير الذي يحتوي على سلك HEX لتحويل.
// Convert text to a HEX string and store it in a variable
$VAR9=STRTOHEX QSFP28-SR4
// Pad the variable on the right with spaces (HEX code 0x20) to 16 bytes
$VAR8=PADRIGHTHEX 16 20 $VAR9
ECHO $VAR8
هذه الأوامر مفيدة عند تخصيص النص إلى متغير وتحويلها إلى سلسلة HEX من طول محدد.
PADLEFTHEX
يعمل مثل PADRIGHTHEX. ضع القيمة السادسة في $VAR1 على اليسار مع الشخصية التي يكون رمزها YY حتى يصل طول تمثيل النص إلى XX.
SAVECODEDIR
قم بتعيين مسار حفظ ملف الرمز تلقائيًا دون مربع حوار.
مثال: إعداد مسار إخراج الرمز إلى دليل يسمى بعد رقم التسلسل في الرمز:
$VAR4=HEXTOSTR {44;0F}
SAVECODEDIR=C:\Users\DemoUser\Desktop\Codes\$VAR4
SAVEFILE
حفظ الرمز إلى ملف على المسار الذي وضعه SAVECODEDIR. يولد التطبيق اسم الملف تلقائيًا وفقًا لنوع وصفحة الوحدة المحددة.
$VAR4=HEXTOSTR {44;0F}
SAVECODEDIR=C:\Users\DemoUser\Desktop\Codes\$VAR4
SAVEFILE
SIGNATURE
قم بتشغيل جهاز الكمبيوتر باستخدام المعلمات المحددة مسبقاً.
هذه الميزة تتطلب ترخيصًا متمددًا للمولد في التطبيق ، والذي لا يتم تضمينه في الحزمة القياسية.
إطلاق النار الخارجي
APIURL
قم بتعيين URL المستخدمة لإدخال الدليل الخارجي لـ API.
APIURL=http://localhost/example/api.php
APICALL
استدعاء محرك API الخارجي. هذا يعادل النقر على زر API في نافذة التطبيق الرئيسية.
تنسيق طلب البريد الإلكتروني للحصول على مكالمات إلى APIURL
POST Fields: code=0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000&module_type=1&table=A0&offset=00
codeالرمز: شريط 256 حرف (HEX، أعلى)؛module_typeنوع الوحدة (0 — GBIC, 1 — SFP, 2 — SFP-DD, 3 — XFP, 4 — QSFP, 5 — QSFP-DD, 6 — OSFP);tableعنوان الجدول (HEX، الأعلى؛ على سبيل المثال: A0، A2)؛offsetتخصيص الجدول (HEX، العلوي؛ على سبيل المثال: 00، 80).
يجب على الخادم إرجاع شريط JSON:
{"status":1,"script":"R1A000007F\r\nW1A000007F{00;7F}\r\n","message":"","code":"0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000","module_type":"1","table":"A0","offset":"00"}
يجب أن يحتوي استجابة الخادم على المعلمات التالية:
statusحالة المعالجة: 1 - استيراد وتشغيل السيناريو؛ 0 - عرض رسالة دون استيراد الرمز؛scriptالنص المكتوب لتنفيذ بعد استيراد الرمز؛ اترك فارغا إذا لم يتم تحديد النص المكتبي.messageالرسالة التي تعود، تظهر عند حالة = 0؛codeرمز العودة: شريط 256 حرفًا (HEX ، أعلى) ؛module_typeنوع الوحدة (0 — GBIC, 1 — SFP, 2 — SFP-DD, 3 — XFP, 4 — QSFP, 5 — QSFP-DD, 6 — OSFP);tableعنوان الجدول (HEX، الأعلى؛ على سبيل المثال: A0، A2)؛offsetتخصيص الجدول (HEX، العلوي؛ على سبيل المثال: 00، 80).
العمليات النقدية
يدعم معالج السيناريو إضافة وتخفيض وتكرار وتقسيم من خلال MATH.
تنسيق الأوامر :
MATH Value1 %Operator Value2
المشغلين الأريثميين المدعومين:
+- إضافات-- التخفيضات .*التكاثر ؛/- تقسيم
COUNTER
$VAR0=MATH 10 - $COUNTER
ECHO $VAR0
// Repeat the script while the condition is true
IF $VAR0 > 0 THEN LOOP
ملف المستخدم
الأوامر للعمل مع ملف المستخدم.
USERFILEPATH
إعداد مسار ملف المستخدم.
USERFILEPATH=C:\Users\User\Desktop\user-file.txt
GETUSERFILESTRING
اقرأ الخط المحدد من ملف المستخدم.
GETUSERFILESTRING 10
SAVETOUSERFILE
حفظ البيانات إلى ملف المستخدم.
مثال :
// Store the serial number in a variable
$VAR2={44;0F}
// Save the variable value to the user file
SAVETOUSERFILE HEXTOSTR $VAR2
// Add a line feed and carriage return
SAVETOUSERFILE HEXTOSTR 0D0A
$STRCOUNTUSERFILE
هذا القيمة يحتوي على عدد الخطوط في ملف المستخدم.
// Find the inserted line's position by subtracting the script iteration count from the file's line count
$VAR0=MATH $STRCOUNTUSERFILE - $COUNTER
ECHO $VAR0
// Read the most recently inserted line from the file
GETUSERFILESTRING $VAR0