جاهزية برامج الترميز
وجود برنامج ترميز في الفهرس واعتماد إصداره واتصال جهاز التتبع أمور منفصلة. افحص الحدود التالية قبل توجيه أجهزة الأسطول أو الشحن إلى بيئة نشر. يذكر الفهرس حدود تنفيذ كل محوّل؛ ولا يثبت جاهزية تثبيت عميل أو توافق كل طراز جهاز.
افحص كل حد
| الفحص | ما يثبته | ما لا يثبته |
|---|---|---|
| الفهرس | البروتوكول والإعدادات وحالة التنفيذ المعلنة | تشغيل تثبيت عميل أو دعم كل طراز وبرنامج ثابت |
| اعتماد الإصدار | قبول السجل لإصدار موقّع ونتيجة المطابقة المسجّلة | اتصال الجهاز أو اختبار حمل إنتاجي أو قبول المزوّد |
| وصول المنشأة | توفر برنامج ترميز مضمّن، أو تثبيت نشط لإصدار معتمد للمنشأة | توفر مسار شبكة أو نجاح فك الترميز |
| تهيئة بيئة التشغيل | ترجمة حزمة محددة وربطها ونجاح فحص سلامتها في عملية تشغيل واحدة | إذن التثبيت أو جاهزية دائمة أو اختبار الجهاز ذهابًا وإيابًا |
| اختبار الجهاز | إرسال الطراز والبرنامج الثابت الفعليين للموقع أو الحدث المتوقع في المنشأة الصحيحة | كل إصدار برنامج ثابت أو كل أمر أو قدرة إنتاجية مستدامة |
لا تحتاج برامج الترميز المضمّنة إلى تثبيت من السوق. أما برامج السوق فتحتاج إلى تثبيت واعتماد إصدار ووصول المنشأة. لا تتجاوز التهيئة الناجحة هذه الشروط. يحتاج مفتاح API أيضًا إلى نطاقات كل عملية عامة؛ وافحص وصول خطة المنشأة في وحدة التحكم.
حدود تهيئة بيئة التشغيل
التهيئة عملية داخلية للمنصة. لا يقدّم هذا الدليل واجهة API عامة أو إجراءً في المتصفح لتنفيذها. لا تضع بيانات
اعتماد الخدمات الداخلية في مفاتيح API أو شيفرة المتصفح أو البيانات أو تذاكر الدعم.
يتوفر تنفيذ التهيئة وعميل السجل في الشيفرة؛ وهذا وحده لا يعني تفعيل سير العمل وربطه في بيئة النشر.
حالة التثبيت active ليست إيصال جاهزية.
تفحص التهيئة الحزمة الموقّعة، وتنفذ الترجمة والربط وإنشاء المثيل وفحص سلامة برنامج الترميز ضمن حدود التشغيل. يحدد الإيصال المنشأة وبرنامج الترميز والإصدار وبصمة الحزمة الخاصة بالفحص. يستخدم الفحص مخزن مفاتيح وقيم مؤقتًا ومعزولًا؛ ولا يثبت عمل مزوّد التخزين التشغيلي ولا يحتفظ بجلسة جهاز. لا يفك إطار جهاز ولا يرسل أمرًا إليه.
لا يضمن الإيصال بقاء الحزم المترجمة أو توفر سعة جاهزة في كل عملية تشغيل أو توافق الأجهزة أو معدل المعالجة. أكد جاهزية النشر مع ZAITRACK قبل توجيه الأجهزة؛ ولا تعتبر اختبار الشيفرة أو نجاح الترجمة قبولًا إنتاجيًا.
اختبر جهاز أسطول أو شحن
- افحص البروتوكول والرسائل المدعومة والحدود ووسيلة النقل في الفهرس للطراز والبرنامج الثابت المحددين.
- أكد المنشأة والإصدار المعتمد في Adapter Studio عندما يكون التثبيت مطلوبًا. افحص وصول خطة المنشأة ونطاقات مفتاح API في وحدة التحكم وDeveloper Studio.
- اطلب من ZAITRACK عنوان النقل المتاح والمنفذ المخصص لبيئة النشر. لا يخصص تثبيت السجل اسم مضيف عامًا ولا يفتح مسار شبكة بمفرده.
- اتبع تسجيل جهاز تتبع. تحقق من ظهور تقرير الجهاز الفعلي تحت المنشأة والجهاز والمركبة الصحيحة، مع الوقت والموقع وقيم الأحداث المتوقعة.
- تحقق من كل أمر مطلوب باستخدام الفهرس والجهاز الفعلي. لا يثبت فك موقع نجاح القفل أو الفتح عن بُعد أو غيرهما من الأوامر على ذلك البرنامج الثابت. استخدم إجراء اختبار أجهزة متفقًا عليه.
عند الفشل، أرسل بيئة النشر والمنشأة وإصدار برنامج الترميز وبصمة الحزمة إن توفرت وطراز الجهاز وبرنامجه الثابت ووسيلة النقل والوقت بالتوقيت العالمي UTC ومعرّف الطلب. احذف المفاتيح والتواقيع وبيانات الاعتماد والبيانات الشخصية. استخدم قناة الدعم الآمنة المتفق عليها لإرسال بيانات الجهاز الخام.
هوية طرفية JT808 والتوجيه الأصلي
يختار المسار الأصلي المراجع المعرّفين jt808.generic وjt808.huabao_elock فقط لبيئة تشغيل JT808 مخصصة. الاسم jt808 اسم بروتوكول وليس معرّف ترميز آخر؛ وتحتفظ الأسماء البديلة والمعرّفات غير المعروفة وبرامج الترميز الأصلية الأخرى ومعرّفات المحوّلات المثبّتة بمسارها الأساسي القائم. المسار معطّل افتراضيًا، ولا يثبّت محوّلًا موقّعًا ولا يرقّيه. لا يعود فشل الاستدعاء المخصص إلى سلوك فك ترميز أقدم. حُدِّثت في بيئة العرض بيئة تشغيل JT808 الأصلية المخصصة وعملاؤها في TCP وUDP وMQTT وناقل الأوامر. بقيت بيئة تشغيل المحوّلات الأساسية وبيئة Teltonika المخصصة دون تغيير. تثبت الفحوص المستقلة جاهزية المكوّنات المحدّثة بشكل انتقائي والحفاظ على الحالة المحمية؛ ولا تثبت تقرير جهاز فعليًا جديدًا أو سير عمل عميلًا مصادَقًا أو قبول العتاد. لم تُنشر وحدة JT808 موقّعة ولم يتغير إصدار أي تثبيت مثبّت.
في محادثات TCP/UDP المسمّاة، يحدد Hello رقم الطرفية المرسل على السلك ويعيد حالة اتصال معتمة. أعد تمرير الحالة دون تغيير مع هوية الطرفية نفسها. يتحقق برنامج الترميز المحدّث من طرفية الإطار وهوية الاتصال المقدّمة والحالة قبل Hello أو فك الترميز أو إرسال رد نجاح. لا تستبدل رقم الطرفية على السلك بمعرّف UUID القياسي لجهاز المنصة. يستخدم فك ترميز Message دون حالة هوية الإطار القياسية، ولا ينشئ ربط اتصال.
تُرفض الحالة القديمة ذات البايتين، والحالة المشوّهة، والطرفية المختلفة، والاتصال المسمّى بلا حالة. أعد الاتصال لإنشاء حالة متوافقة بدل اختلاقها. يجب تنسيق توافق بيئة التشغيل والعميل. في المحوّلات الموقّعة، يجب أيضًا توافق الوحدة المرجعية المستخدمة لـ Hello مع إصدار فك الترميز المثبّت: لا ينشئ Hello جديد مع مفكك قديم هذا الربط؛ ويُرفض Hello قديم مع مفكك جديد. لا يغيّر النشر أو تحديث بيانات الفهرس إصدار التثبيت المثبّت أو الاتصال القائم.
ينطبق مسار إجابات الأوامر الأصلي الخاص فقط على الإطارات التي يتعرف عليها مصنّف إجابات JT808 القائم. يتحقق من الهوية قبل تسليم الإجابة إلى منتظر الأمر، ويمنع نشر القياسات الخام لهذا المسار، وينقّي أخطاء فك الترميز. تتجاهل تفاصيل إجابات المعلمات قيم المعلمات. تحتفظ إطارات المجموع الاختباري أو الترويسة المشوّهة التي لا يمكن تصنيفها بسياسة الخام والعزل القائمة؛ كما يحتفظ AdapterServer العام للمحوّلات الموقّعة بسلوكه القائم للإطارات الخام. لا تعتبر هذا المسار الأصلي المحدود ضمانًا عامًا لسرية إجابات المعلمات، ولا تضع بيانات اعتماد في حمولات الدعم.
فحص الاتصال هذا ليس مصادقة لبيانات اعتماد الطرفية. تبقى الرسائل المجزأة غير مدعومة. يبقى تخصيص الأرقام التسلسلية الأصلية للإقرارات والأوامر بالسلوك العام القائم ذي 16 بت؛ ولا تثبت هذه الخطوة حماية دائمة من إعادة التشغيل أو التفاف الأرقام. تغطي الاختبارات المعزولة ترويسات 2013/2019 والمعرّفين الأصليين وتوقعات الحمولة والحالة والإقرار الكاملة، لا كل برنامج ثابت أو جهاز فعلي. اختبار حمل HTTP معزول لمدة ثلاث دقائق ليس اختبار تحمّل لساعة أو معدل الإدخال الكامل أو قبول قدرة العتاد أو الإنتاج.
اتبع دليل المنتج اتصال JT/T 808، وتحقق من الطراز ورقم الطرفية والمنشأة والنقل والبرنامج الثابت الفعلي قبل توجيه جهاز عميل. لا تعِد تشغيل بيانات تاريخية لاختبار نشر، ولا تستنتج ضمانات جديدة للحمولة أو EventID من ربط الطرفية.
مستشعرات Teltonika المسمّاة وسلطة مصدر حرارة المقطورة
حُدِّث فك ترميز Teltonika الأصلي في بيئة العرض للمعرّفين teltonika.codec8 وteltonika.codec8e، مع مستهلك بيانات المقطورات وWeb BFF ومكوّنات وحدة التحكم اللاحقة. تستخدم الاستدعاءات الأصلية بيئة تشغيل مخصصة لـ Teltonika؛ وتحتفظ استدعاءات المحوّلات المثبّتة بمسارها المنفصل. ما زال إصدار WASM المرشح 1.0.2 غير منشور وغير مثبّت بهذه العملية. بيانات الفهرس وتحديث المكوّن الأصلي وترقية محوّل مثبّت حدود مختلفة.
لا تثبت هذه العملية اختبارًا حيًا مصادَقًا لحقول الشحنة الجديدة أو مسار اختيار المصدر، ولا تقرير جهاز فعليًا جديدًا عبر هذا المسار، ولا اعتماد موقع المسبار أو العتاد. تحقق من القناة المرسلة والتوصيلات في التثبيت الفعلي قبل الاعتماد على مراقبة الشحنة. لا تحل اختبارات الشيفرة والتنفيذ المعزول محل هذه الفحوص الخاصة بالعميل والجهاز.
يُخرج برنامج الترميز قنوات Dallas من dallas-1 إلى dallas-4 كعناصر sensors منفصلة، بقيم type: "temperature" وunit: "C" وvalue الرقمية المرصودة. ولا ينسب أول مسبار موجود إلى cargo.temp_c. القراءة المسمّاة لا تثبت الحجرة أو موقع التوصيل. تبقى قراءة 115°C المدعومة حقيقة مستشعر؛ وهي ليست قيمة صالحة في CargoBlock الجذري، الذي يبقى حده الأقصى 100°C. لا تقصّها ولا تنسخها إلى ذلك الكائن.
يحتوي الحقل الاختياري reefer.cargoSensorBinding على sourceDeviceId وchannel. يجب أن يساوي معرّف المصدر trackerDeviceId المعيّن للأصل؛ ويفحص التطبيق أيضًا منشأة القياس وجهازه. مثال لجزء الربط بعد التحقق من المسبار المركّب:
{
"cargoSensorBinding": {
"sourceDeviceId": "<assigned tracker UUID>",
"channel": "dallas-1"
}
}
هذا جزء من حقول وحدة التبريد، وليس طلب إنشاء أو تحديث كاملًا. استخدم واجهة المقطورات الحالية أو نموذج وحدة التحكم مع ملف المراقبة الكامل والحقول المطلوبة ومعالجة الإصدار. يركّب التسجيل جهاز التتبع قبل تحديث الربط النهائي؛ أبلغ عن الفشل الجزئي وتحقق من الحالة المحفوظة، ولا تعتبر الخطوات معاملة موزعة. لا تستخدم إعدادًا عامًا لتثبيت برنامج الترميز لإثبات توصيلات أصل محدد.
يقبل الربط المسمّى المهيأ قراءة سلسيوس مطابقة واحدة بالضبط ذات قيمة رقمية محدودة. لا تؤدي القناة المفقودة أو المكررة أو ذات الوحدة الخاطئة أو القيمة غير الصالحة إلى استخدام مستشعر آخر أو حرارة الشحنة الجذرية القديمة. عند غياب الربط المسمّى يبقى مسار cargo.temp_c الصريح القديم. في التحديث، يحافظ إغفال cargoSensorBinding على الربط الحالي عندما يبقى جهاز التتبع دون تغيير؛ وتمسحه القيمة null الصريحة. يمسح استبدال جهاز التتبع الربط القديم ما لم يُقدَّم ربط جديد صريح لذلك الجهاز. قد يحذف خادم قديم حقول الربط غير المعروفة من JSONB، لذا يلزم تنسيق نشر المخطط وكل الكتّاب.
يسجّل cargoTempAt وقت حدث الحرارة المقبول مستقلًا عن lastSeenAt. لا تجدّده تحديثات GPS أو الأبواب وحدها؛ وتبقى الأوقات التاريخية المفقودة null. تمسح تغييرات المصدر أو جهاز التتبع الحرارة المخزنة القديمة وفترة الرصد. ويعيد تغيير ملف المراقبة فترة الرصد أيضًا. يميّز endReason للتجاوز بين in_range وmonitoring_source_changed وmonitoring_profile_changed وasset_retired؛ وتبقى الأسباب التاريخية المفقودة null. الانتهاء الإداري ليس تعافيًا مقاسًا. يبقى تعارض ترتيب الأحداث المستقبلية مع الانتهاء الإداري فجوة مستقلة في سياسة المضيف؛ لا تستنتج التحقق الزمني من هذا العرض.
بالنسبة للمكوّنات المنشورة، تحقق من الجهاز المركّب والقناة المطابقة والتوصيل الفعلي، ثم افحص قراءة مقبولة ووقت حرارتها ومدة التجاوز المهيأة. يجب ألا تختار القراءة المفقودة مصدرًا بديلًا. لا ترسل أوامر أجهزة أو تغيّر حرارة شحنة فعلية لمجرد اختبار هذا الدليل. تغيير حمولة CTM يغيّر EventID المشتق من بصمتها؛ اتبع سياسة إصدار برنامج الترميز وتثبيته وإعادة التشغيل المتفق عليها، ولا تعِد البيانات التاريخية بافتراض ثبات الهوية.
راجع دليل سلسلة التبريد لمسار المشغّل.
الإيقاف والترقية والإلغاء
يمكن إيقاف التثبيت أو إلغاؤه، ويمكن إلغاء إصدار موقّع أو مفتاح. تحتفظ استعلامات السجل في بيئة التشغيل بالاستجابات الناجحة مدة تصل إلى 30 ثانية، ولذلك لا تعني تغييرات الوصول قطع اتصال الشبكة فورًا. بعد الترقية أو تغيير الوصول، أعد فحوص الجهاز ذات الصلة. أحدث إصدار معتمد في السجل لا يثبت تغيير الإصدار المثبّت لدى العميل أو جلسة جهاز متصل.