# Modbus إلى MQTT

> يستطلع PLCGateway أجهزة Modbus TCP وRTU – عدادات الطاقة ومحوّلات التردد ووحدات PLC والحساسات – وينشر سجلاتها وCoils إلى وسيط MQTT كقيم مسمّاة ومُحجَّمة.

لا تجيب أجهزة Modbus إلا عند سؤالها، وما تعيده محتوى سجلات خام. أما منصة IoT فتريد العكس: قيمًا مسمّاة تصل من تلقاء نفسها. ويستطلع PLCGateway السجلات، ويجمع القيم ذات 32 و64 بت بترتيب الكلمات الصحيح، ويطبّق التحجيم، وينشر كل وسم عند تغيّره.

يُدعم Modbus TCP وRTU over TCP وRTU على خط تسلسلي (RS-485 / RS-232) في النسخة المثبّتة نفسها، فيصل عداد طاقة تسلسلي ووحدة PLC على Ethernet إلى الوسيط نفسه. وتُقرأ السجلات المتتالية في طلب واحد.

- **المصدر:** [Modbus TCP / RTU](https://plcgateway.com/ar/protocols/modbus.md) (`modbus_tcp`, `modbus_rtu_tcp`, `modbus_rtu`)
- **الاتصال:** TCP 502 · RTU over TCP · RS-485 / RS-232
- **الوجهة:** [MQTT](https://plcgateway.com/ar/integrations.md)
- **الكتابة:** نعم
- **مضمَّن في:** PLCGateway Connect, PLCGateway SCADA, PLCGateway Embedded

## الإعداد في خمس خطوات

1. أضف جهازًا، واختر Modbus TCP أو RTU عبر TCP أو RTU التسلسلي، وأدخل عنوان IP أو المنفذ التسلسلي مع معدّل الباود والتكافؤ.
2. اضبط معرّف الوحدة (unit id)، واضبط لقيم 32 بت ترتيب الكلمات المعتمد في الجهاز.
3. أنشئ الوسوم بعناوينها وأنواع بياناتها، أو استورد قائمة السجلات من CSV؛ ثم اختبر الاتصال لرؤية القيم الأولى.
4. افتح Gateway → MQTT، وأدخل عنوان الوسيط والمنفذ وبيانات الدخول، وفعّل TLS إذا كان الوسيط يتطلبه، واختر الموضوع الأساسي.
5. اختر النشر عند التغيّر أو على فترات، وصيغة JSON أو القيمة المجردة، ثم تحقّق من المواضيع باستخدام mosquitto_sub أو في منصتك.

## مثال: المواضيع والحمولات

يُنشر جهاز بالمعرّف meter1 وهذه الوسوم كما هو موضّح أدناه؛ والأسطر هي ما يطبعه mosquitto_sub -v. الأسماء والقيم أمثلة.

| الوسم | العنوان | قيمة مثال |
|---|---|---|
| `ActivePower` | `HR100` | 42.75 kW |
| `Energy` | `HR200` | 128450.5 kWh |
| `PumpRunning` | `C12` | true |

**مواضيع MQTT وحمولاتها**

```
plcgateway/status online
plcgateway/meter1/ActivePower {"q":"GOOD","t":1794465246839,"u":"kW","v":42.75}
plcgateway/meter1/Energy {"q":"GOOD","t":1794465246839,"u":"kWh","v":128450.5}
plcgateway/meter1/PumpRunning {"q":"GOOD","t":1794465246839,"v":true}
```

الموضوع: الموضوع الأساسي / معرّف الجهاز / اسم الوسم. وتحمل حمولة JSON القيمة (v) والجودة (q) والطابع الزمني بالمللي ثانية (t) والوحدة (u).

## ناشر MQTT في PLCGateway

ينشر PLCGateway كل وسم إلى وسيط MQTT لديك – Mosquitto أو EMQX أو HiveMQ أو AWS IoT Core أو منصة سحابية عبر جسر – فتشترك أنظمة تقنية المعلومات في المواضيع بدل استطلاع وحدة التحكم. ويدعم MQTT 3.1.1 عبر TCP أو TLS، مع اسم مستخدم وكلمة مرور.

تُرسل القيم عند تغيّرها أو على فترات ثابتة، بصيغة JSON مع الجودة والطابع الزمني أو كقيمة مجردة. ويُعلم موضوعُ حالةٍ محتفَظ به (retained) مع رسالة last will المشتركين بما إذا كانت البوابة متصلة.

- موضوع لكل وسم: الموضوع الأساسي / الجهاز / الوسم، مع موضوع أساسي تختاره أنت
- QoS 0 أو 1، ورسائل محتفَظ بها (retained)، ورسالة birth وlast will
- كتابة اختيارية: القيمة المنشورة إلى موضوع /set الخاص بالوسم تُكتب إلى وحدة التحكم
- تُحفظ الرسائل في طابور أثناء تعذّر الوصول إلى الوسيط وتُرسل بعد إعادة الاتصال

![إعدادات ناشر MQTT: الوسيط (broker) وTLS والموضوع الأساسي ووضع النشر وتنسيق الحمولة](https://plcgateway.com/assets/img/shots/mqtt-1400.webp)

## وحدات التحكم والأجهزة

- [Modbus TCP / RTU](https://plcgateway.com/ar/protocols/modbus.md)
- [Schneider Electric Modicon](https://plcgateway.com/ar/controllers/schneider-electric.md)
- [وحدات التحكم المبنية على CODESYS](https://plcgateway.com/ar/controllers/codesys-plcs.md)
- [أتمتة المباني وعدادات الطاقة](https://plcgateway.com/ar/controllers/building-automation.md)

## أسئلة وأجوبة

### هل يعمل مع Modbus RTU عبر RS-485؟

نعم. استخدم منفذًا تسلسليًا أو محوّل USB في الحاسوب، أو محوّل Ethernet إلى تسلسلي مع RTU over TCP. ويُضبط معدل البود والتماثل (parity) ومعرّف الوحدة (unit id) لكل جهاز.

### كيف تُعالَج قيم الفاصلة العائمة ذات 32 بت؟

يحدّد نوع بيانات الوسم العرض، ويُختار ترتيب الكلمات (ABCD أو CDAB أو BADC أو DCBA) لكل جهاز أو لكل وسم، فتكون القيمة المنشورة هي العدد الحقيقي، لا سجلين خامين.

### هل يمكنني كتابة سجل عبر MQTT؟

نعم، عند تفعيل الكتابة: تُكتب القيمة المرسلة إلى موضوع /set الخاص بالوسم في سجل Holding أو Coil.

## حلول ذات صلة

- [Modbus إلى OPC UA](https://plcgateway.com/ar/solutions/modbus-to-opc-ua.md)
- [Siemens S7 إلى MQTT](https://plcgateway.com/ar/solutions/siemens-s7-to-mqtt.md)
- [FANUC FOCAS إلى MQTT](https://plcgateway.com/ar/solutions/fanuc-focas-to-mqtt.md)
- [Haas CNC إلى MQTT](https://plcgateway.com/ar/solutions/haas-to-mqtt.md)
- [MTConnect إلى MQTT](https://plcgateway.com/ar/solutions/mtconnect-to-mqtt.md)
- [Allen-Bradley EtherNet/IP إلى MQTT](https://plcgateway.com/ar/solutions/ethernet-ip-to-mqtt.md)
- [جميع البروتوكولات](https://plcgateway.com/ar/protocols.md)

_أسماء المنتجات والطرازات علامات تجارية لأصحابها. وهي مذكورة فقط لتوضيح المعدّات التي تتواصل معها برامج التشغيل؛ ولا تربط PLCGateway أي صلة بهذه الشركات._

---
Source: https://plcgateway.com/ar/solutions/modbus-to-mqtt
