ديسنت إسبرسو

تقديم تطبيقات الويب لميزان Half Decent

تطبيقات ويب نصف لائقة

تضم هذه المجموعة ثلاثة تطبيقات ويب تم بناؤها باستخدام JavaScript وHTML وCSS العادية. وهي توضح وظائف متنوعة متاحة عبر تقنية Bluetooth منخفضة الطاقة للويب (Web BLE) وشبكة Wi-Fi وUSB للويب (Web USB). ستفتح هذه التطبيقات طرقًا جديدة للتفاعل مع ميزان Half Decent الخاص بك. فهي توفر أدوات قوية لمراقبة الجودة والوزن الدقيق والجرعات المبسطة مباشرة من متصفح الويب الخاص بك.

جرّب التطبيقات: عروض توضيحية حية

تعمّق في استخدام أدوات الويب لدينا. هذا متاح حاليًا لمتصفحات أجهزة الكمبيوتر المكتبية والمحمولة وأجهزة Android وiOS عبر اتصال Wi-Fi الخاص بالميزان.

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

مساعد مراقبة الجودة: مثالي لضمان الاتساق. يسمح لك هذا التطبيق بوزن نفس العناصر بشكل متكرر، مما يبسط تتبع البيانات وفحوصات الجودة.

مساعد الجرعات: بسّط عملية الجرعات الخاصة بك بواجهة بديهية مصممة لتحقيق قياسات دقيقة وقابلة للتكرار.

صانع الكوكتيل : سيرشدك هذا التطبيق التفاعلي خلال جميع خطوات صنع الكوكتيلات الكلاسيكية من كتاب "PDT Cocktail Book" الشهير.

البدء: كيفية الاتصال والاستخدام

الاتصال بميزان Half Decent الخاص بك لتطبيقات الويب لدينا هو أمر بسيط. اتبع هذه الخطوات:

1. التحقق من المتصفح:

من الضروري التحقق من المتصفح. استخدم فقط أحدث إصدار من Google Chrome (الإصدار 136 أو أحدث) أو Microsoft Edge (الإصدار 136 أو أحدث).

2. فتح تطبيق:

انتقل إلى أحد روابط التطبيقات المذكورة أعلاه.

3. تفعيل وضع الاقتران:

ضع ميزان Half Decent الخاص بك في وضع الاقتران عبر Bluetooth.

4. الاتصال عبر التطبيق:
  • انقر على زر "اتصال" في تطبيق الويب.
  • ستظهر نافذة منبثقة تعرض أجهزة Bluetooth المتاحة.
  • اختر "Decent Scale" من القائمة.
    • 5. تأكيد الاتصال:

    بمجرد الاتصال، سيتحول زر "اتصال" إلى اللون الأحمر وسيتغير نصه إلى "قطع الاتصال". سترى أيضًا تحديثات الوزن المباشرة من ميزانك معروضة على الشاشة.

    6. البدء:

    انقر على زر "بدء" واتبع التعليمات التي تظهر على الشاشة الخاصة بالتطبيق الذي تستخدمه.

    استخدام اتصال USB-C :

    تطبيقاتنا تدعم أيضًا اتصال USB-C المباشر. إذا اخترت هذه الطريقة:

  • أولاً، قم بتوصيل جهازك بميزان Half Decent عبر كابل USB-C.
  • بعد ذلك، قم بتثبيت برامج تشغيل CH34X التسلسلية على جهازك.
  • اختر اتصال USB من القائمة المنسدلة، وانقر على "اتصال"، واختر "USB Serial" من القائمة المنبثقة.
  • قم بتوصيله وستظهر تحديثات الوزن المباشرة على الشاشة.

    • استخدام اتصال Wi-Fi (يتطلب البرنامج الثابت 3.0.0) :

    يستخدم ميزان Half Decent الآن شبكة Wi-Fi لميزات واتصالات إضافية.

  • لتفعيل وضع Wi-Fi، انتقل إلى قائمة الإعدادات في HDS وابحث عن إدخال "إعدادات Wi-Fi".

    • يمكنك تمكين أو تعطيل Wi-Fi هناك وعرض تفاصيل Wi-Fi الحالية.

  • إذا قمت بتبديل Wi-Fi تشغيل/إيقاف، يجب عليك إعادة تشغيل الميزان حتى تدخل الإعدادات الجديدة حيز التنفيذ.

    • سيفتح HDS شبكة Wi-Fi خاصة به، تسمى "Decent Scale". وهي محمية بكلمة مرور: '12345678.'

  • بمجرد الاتصال بشبكة Wi-Fi هذه، انتقل إلى hds.local أو 192.168.1.1 باستخدام متصفحك لتغيير إعدادات Wi-Fi.

    • قم بتوصيل HDS بشبكة Wi-Fi المنزلية الخاصة بك (2.4 جيجاهرتز) بالذهاب إلى صفحة hds.local وإدخال معرف Wi-Fi وكلمة المرور الخاصة بك.

    أعد تشغيل الميزان لتطبيق الإعدادات الجديدة. قم بتخزين إعدادات Wi-Fi الخاصة بك بشكل صحيح وحافظ على HDS ضمن نطاق الإشارة. إذا لم تفعل ذلك، فسيعود إلى شبكة Wi-Fi الخاصة به (Decent Scale)، مما يسمح لك بتغيير الإعدادات مرة أخرى إذا لزم الأمر.

    الغرض والجمهور المستهدف

    تخدم تطبيقات الويب هذه هدفين رئيسيين:

  • لمستخدمي الميزان: أدوات ميزان Half Decent لدينا عملية وسهلة الاستخدام. إنها تعزز وظائف الميزان للمهام اليومية.
  • للمطورين: عرض توضيحي واقعي لقدرات Web Bluetooth وWeb USB ضروري لتشجيع الاستكشاف والابتكار باستخدام هذه التقنيات.

    • هذه التطبيقات مثالية لـ:

  • مالكي آلة Decent Espresso و/أو ميزان Half Decent: حقق أقصى استفادة من روتين الوزن اليومي وتحضير القهوة.
  • محترفي مراقبة الجودة: تبسيط عمليات الوزن، وتحسين الاتساق، وتبسيط جمع البيانات.
  • المطورين وعشاق التكنولوجيا: استكشف تطبيقًا عمليًا لـ Web BLE وWeb USB في سياق إنترنت الأشياء (IoT).

    • للمطورين: الغوص التقني المتعمق
  • كود تطبيقات الويب هذه متاح في دليل web_apps من مستودع openscale.
  • الأساس: تم بناؤه باستخدام HTML وCSS وJavaScript القياسية.
  • التصميم: Tailwind CSS هو نهج قائم على الأدوات المساعدة للتصميم، مما يضمن واجهة سريعة الاستجابة وحديثة. ملاحظة: Tailwind هو إطار عمل CSS، لكن منطقه الأساسي موجود في JavaScript العادي، متجنبًا أطر عمل JavaScript الثقيلة.
  • الاتصال:
  • واجهة برمجة تطبيقات Web Bluetooth (Web BLE): تتيح الاتصال اللاسلكي بميزان Half Decent.
  • واجهة برمجة تطبيقات Web USB: توفر طريقة اتصال سلكية بديلة.
  • توافق المتصفح: استخدم Google Chrome (الإصدار 136 أو أحدث) أو Microsoft Edge (الإصدار 136 أو أحدث)، وiOS، وSafari باستخدام اتصال Wi-Fi الخاص بالميزان.
  • Wi-Fi (Websocket): قم بترقية ميزان half decent إلى البرنامج الثابت 3.0.0، ثم اتبع التعليمات أعلاه لتشغيله. سيقوم HDS الآن ببث بيانات الوزن واستقبال أمر الصفر (tare) عبر نقطة نهاية WebSocket. راجع مثال الكود هنا. هنا.
  • تخزين البيانات: يتم تخزين البيانات مثل القراءات والإعدادات المسبقة محليًا في التخزين المحلي للمتصفح. يمكن للمستخدمين تنزيل بياناتهم كملفات JSON أو CSV.

    • هيكل الكود والوحدات الرئيسية

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

    وحدات JavaScript الرئيسية وأدوارها:

  • scale.js: يتعامل مع بروتوكول BLE، والتواصل مع ميزان Half Decent (HDS)، ووظيفة وضع الجرعات الأساسية.
  • constants.js: يخزن رسائل 10 بايت المبرمجة مسبقًا للتواصل مع HDS وقيم العتبة المختلفة.
  • state-machine.js: ينفذ المنطق الأساسي لـ "مساعد الجرعات" و"مساعد مراقبة الجودة" باستخدام نموذج آلة الحالة المحدودة.
  • export.js: يدير وظيفة تصدير قراءات الوزن وبيانات التقييم كملفات CSV أو JSON.
  • presets.js: يسمح للمستخدمين في "مساعد الجرعات" و"مساعد مراقبة الجودة" بحفظ الأوزان المستهدفة كإعدادات مسبقة، مخزنة مؤقتًا محليًا بواسطة المتصفح.
  • ui-controller.js: يدير التحديثات والتغييرات على واجهة HTML.
  • modules/connection : يحتوي على التطبيقات المحددة لطرق اتصال BLE وUSB.
  • modules/reconnecting-websocket.js/ : وحدة بسيطة لمساعدتك في إعادة الاتصال بـ websocket تلقائيًا، يوصى باستخدامها إذا كانت قوة Wi-Fi غير كافية.

    • راجع دليل المبرمج لميزان Half Decent للحصول على تفاصيل شاملة حول بروتوكولات الاتصال بالميزان.

    إعداد التطوير

    اتبع هذه الخطوات البسيطة للحصول على نسخة محلية وتشغيلها:

    1. تنزيل دليل web_apps: لا يوفر GitHub تنزيلًا مباشرًا للأدلة الفرعية. استخدم أداة متخصصة لذلك. إليك خياران:
  • استخدم أداة ويب مثل DownGit أو github1s.
  • انتقل إلى موقع الأداة على الويب.
  • الصق رابط دليل web_apps على GitHub: https://github.com/decentespresso/openscale/tree/main/web_apps
  • اتبع تعليمات الأداة لتنزيل الدليل كملف ZIP.
  • قم باستخراج ملف ZIP الذي تم تنزيله. سيؤدي هذا إلى إنشاء مجلد web_apps.
    • 2. انتقل إلى دليل المشروع:

    cd web_apps/dosing_assistant

    3. قم بتقديم الملفات باستخدام خادم HTTP محلي:

    نظرًا لأن هذه تطبيقات ويب تستخدم Web BLE، فيجب تقديمها عبر https:// أو http://localhost

    يمكنك استخدام خادم NPX HTTP بسيط أو أي خادم محلي آخر تفضله.

  • باستخدام http.server الخاص بـ NPX:

    • npx http-server -p 8000

    ثم، افتح متصفح Chrome وانتقل إلى أحد:


    http://localhost:8000/weigh_save.html


    http://localhost:8000/dosing_assistant.html

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

    دليل ميزان Half Decent: جدول المحتويات

    #app #opensource #javascript #webweigh #halfdecentscale #bluetooth #usb #decentscale #weighing #WIFI



  • هذه ترجمة لـ: Introducing Half Decent Scale web apps


    john created 2025/05/29, john updated 2026/07/09