أداة RasPY

شعار أداة RasPY

مرحبًا بكم في وثائق أداة RasPY

أداة RasPY هي تطبيق متكامل للتحكم في دبابيس GPIO الخاصة بـ Raspberry Pi ومراقبتها من خلال واجهة رسومية بديهية أو واجهة برمجة تطبيقات REST.

جدول المحتويات

مقدمة

التطوير

موارد إضافية

المجتمع

الميزات الرئيسية

✅ واجهة رسومية عصرية

🔌 دعم كامل لـ GPIO

🌐 واجهة ويب

البدء السريع

  1. التثبيت - كيفية تثبيت وتكوين أداة RasPY
  2. الدليل - دليل استخدام التطبيق
  3. واجهة برمجة التطبيقات - وثائق API للمطورين
  4. التطوير - دليل التطوير والمساهمة

دليل المستخدم

الواجهة الرسومية

تم تصميم واجهة RasPY Utility الرسومية لتكون بديهية وسهلة الاستخدام.

القائمة الرئيسية

التحكم في GPIO

  1. افتح نافذة التحكم في GPIO من القائمة
  2. حدد الدبوس الذي تريد التحكم به
  3. استخدم الأزرار لتبديل الحالات
  4. راقب الحالة في الوقت الفعلي

محاكي GPIO

يتيح لك المحاكي اختبار الكود بدون أجهزة فعلية:

  1. قم بتشغيل المحاكي من قائمة GPIO
  2. استخدم الواجهة لمحاكاة الإدخال/الإخراج
  3. تنعكس التغييرات في الوقت الفعلي

التسجيل وتصحيح الأخطاء

يسجل التطبيق الأحداث المهمة في ملف logs/app.log. استخدم عارض السجلات المدمج من أجل:

اختصارات لوحة المفاتيح

مرجع API

نظرة عامة

تسمح واجهة برمجة تطبيقات REST الخاصة بـ RasPY Utility بالتحكم في دبابيس GPIO من خلال طلبات HTTP. تكون جميع الردود بتنسيق JSON.

النقاط النهائية المتاحة

GET /api/gpio

إرجاع حالة جميع دبابيس GPIO المُهيأة.

مثال على الاستجابة:

{
  "17": {"state": 0, "mode": "out", "description": "الصمام الثنائي الباعث للضوء الأحمر"},
  "18": {"state": 1, "mode": "in", "description": "زر"}
}

GET /api/gpio/<int:pin>

إرجاع حالة الدبوس المحدد.

المعلمات:

رموز الحالة:

مثال على الاستجابة:

{
  "state": 0,
  "mode": "out",
  "description": "الصمام الثنائي الباعث للضوء الأحمر"
}

POST /api/gpio/<int:pin>/on

يقوم بتشغيل الدبوس المحدد.

المعلمات:

رموز الحالة:

POST /api/gpio/<int:pin>/off

يقوم بإيقاف تشغيل الدبوس المحدد.

المعلمات:

رموز الحالة:

أمثلة على الاستخدام

التحكم في GPIO باستخدام Python

import requests

BASE_URL = "http://localhost:5000/api/gpio"

# الحصول على حالة جميع الدبابيس
response = requests.get(f"{BASE_URL}")
print("الحالة الحالية:", response.json())

# تشغيل الدبوس 17
response = requests.post(f"{BASE_URL}/17/on")
print("استجابة التشغيل:", response.status_code)

موارد مفيدة