تم نشر هذا المشروع لجميع الأشخاص المهتمين في مجال تصنيع وابتكار المشاريع الإلكترونية والبرمجية، و نود التنويه أن موقع انا الكتروني يخلي مسؤوليته التامة في حال لم يعمل المشروع لدى العميل أو في حال الاستخدام الخاطئ للمكونات الإلكترونية والكهربائية التي قد تؤدي لحدوث الحرائق أو غيرها لا سمح الله.

• للتعرف على تجهيز لوحة أردوينو للبرمجة قم بزيارة الرابط التالي.
• خطوات انشاء التلغرام البوت وربطه مع الويموس:

المرحلة 1: إنشاء بوت Telegram

• افتح تطبيق Telegram
• في البحث اكتب: BotFather
• ستجده بحساب موثق ✔️
• اضغط Open
• اضغط Create a New Bot
• سيطلب منك كتابة:
• ✔️ اسم البوت (Bot Name)
• مثال: Smart Alert System
• ✔️ اسم المستخدم في الخانة الثالثة (username_bot)
• ⚠️ مهم: يجب أن ينتهي بـ bot وبدون مسافات
• مثال: smart_1950_bot (يجب الا يكون مستعمل مسبقا)
• بعدها اضغط Create Bot
• بعدها سيعطيك التوكن (TOKEN)، ستظهر لك رسالة مثل:123456789:AAAbbbCCCxxxYYYzzz
• 📌 هذا التوكن مهم جدا
• 👉 اضغط Copy احتفظ به جيدًا

المرحلة 2: إنشاء مجموعة Telegram بالتفصيل

• لإنشاء المجموعة، اضغط:
  • ☰ (القائمة)
  • New Group
• اختر أي شخص (يمكن حذفه لاحقًا)
• اكتب اسم المجموعة:
• مثال: Home Alerts
• اضغط على OK
• لاضافة البوت للمجموعة، اولا عد الى الصفحة الرئيسية للتلغرام
• اكتب اسم المستخدم username_bot في خانة البحث
• اضغط على Start
• اضغط على اسمها من الأعلى
•  اختر: Add to Group or Channel
• ابحث عن اسم المجموعة وأضفه اليها
• ✔️ فعّل خاصية Manage Group وكل الخاصيات التي تحتها
• اضغط Add bot as Admin

 المرحلة 3: الحصول على CHAT ID (أهم خطوة)

• في المجموعة اكتب رسالة: hello ثم ارسلها
• افتح المتصفح واكتب:
• https://api.telegram.org/botTOKEN/getUpdates
• 📌 استبدل:
• كلمة TOKEN ← بالتوكن الخاص بك الذي نسخته مسبقا واحتفظت به
• ستظهر لك بيانات JSON مثل:

{"ok": true,"result": [{"message": {"chat": {"id": -1001234567890,"title": "Home Alerts"}}}]}


• 📌 انسخ رقم id الفريد الذي سيظهر لك: مثلا هنا 1001234567890-
• 👉 هذا هو: CHAT_ID

المرحلة 4: إعداد Arduino IDE + Wemos

• افتح Arduino IDE
• File → Preferences
• أضف هذا الرابط: http://arduino.esp8266.com/stable/package_esp8266com_index.json
• لتثبيت البورد، اختر: Tools → Board → Boards Manager
• ابحث: ESP8266
• اضغط Install
• لاختيار البورد، اختر:Tools → Board → LOLIN (Wemos) D1 R1

المرحلة 5: ما يجب اضافته في الكود

• اسم شبكة الواي فاي (SSID): اسم الشبكة التي سيتصل بها الـ Wemos: مثلا:

• const char* ssid = “Redmi A1”;
• كلمة مرور الواي فاي (PASS): مثلا:
• const char* pass = “19041904”;
• توكن البوت (Bot Token): هو المفتاح الذي يسمح للأردوينو بالتواصل مع البوت بدونه لا يمكن إرسال رسائل
• ⚠️ مهم: يجب أن يبقى سري، مثلا:
• const char* BOT_TOKEN = “8767103482:AAH6Zn4FRJ-NQ9RwCrnt3OTDLqPZK-L7Fbg”;

• معرّف المحادثة (Chat ID): يحدد إلى أين تُرسل الرسائل، مثلا:

• const char* CHAT_ID = “-1003617183721”;

• قبل رفع الكود الى اللوحة، يجب عدم تركيب الاسلاك مع لوحة الويموس حتى اكتمال عملية الرفع.
• كما يجب تنزيل المكتبات التالية:
• مكتبة ESP8266WiFi.h.
• مكتبة WiFiClientSecure.h.
• مكتبة UniversalTelegramBot.h.
• مكتبة ArduinoJson.h.
• مكتبة SPI.h.
• مكتبة MFRC522.h.
• للإطلاع على كيفية تحميل وتنصيب المكتبات قم بزيارة الرابط التالي.
• في حال لم يعمل هذا الكود البرمجي، قم بتحميل ملف الكود بالضغط على زر التحميل الموجود في الأسفل.

#include <ESP8266WiFi.h>
#include <WiFiClientSecure.h>
#include <UniversalTelegramBot.h>
#include <ArduinoJson.h>
#include <SPI.h>
#include <MFRC522.h>

// — 1. بيانات الاتصال —
const char* ssid = “Redmi A1”;
const char* pass = “19041904”;
const char* BOT_TOKEN = “8767103482:AAH6Zn4FRJ-NQ9RwCrnt3OTDLqPZK-L7Fbg”;
const char* CHAT_ID = “-1003617183721”;

// — 2. تعريف الدبابيس —
#define RST_PIN D3
#define SS_PIN D4
#define BUZZER D2

MFRC522 mfrc522(SS_PIN, RST_PIN);
WiFiClientSecure client;
UniversalTelegramBot bot(BOT_TOKEN, client);

// — 3. قاعدة بيانات الطلاب وحالتهم —
struct Student {
String uid;
String name;
bool isPresent;
};

// أضف طلابك هنا
Student students[] = {
{“4090B789”, “أحمد محمد”, false},
{“FA60CB7D”, “محمود يوسف”, false},
};

const int totalStudents = sizeof(students) / sizeof(students[0]);

// — 4. توقيت الحضور —
unsigned long startTime;
const unsigned long attendanceWindow = 5000; // مدة تسجيل الحضور (مثلاً 5 ثواني)
bool reportingDone = false;

void setup() {
Serial.begin(115200);
SPI.begin();
mfrc522.PCD_Init();

pinMode(BUZZER, OUTPUT);
digitalWrite(BUZZER, LOW);

WiFi.begin(ssid, pass);
client.setInsecure(); // تسريع الاتصال بتخطي التحقق من الشهادات الثقيلة

Serial.print(“Connecting to WiFi”);
while (WiFi.status() != WL_CONNECTED) {
delay(500);
Serial.print(“.”);
}
Serial.println(“\nConnected!”);

// إرسال الرسالة الأصلية كما هي
bot.sendMessage(CHAT_ID, “⚠️ بدأت فترة تسجيل حضور الطلاب الآن…”, “”);
startTime = millis();
}

void loop() {
unsigned long currentTime = millis();

// أولاً: التحقق من انتهاء الوقت وإرسال التقرير
if (currentTime – startTime > attendanceWindow && !reportingDone) {
sendAbsenceReport();
reportingDone = true;
}

// ثانياً: قراءة البطاقات (بسرعة عالية)
if (!reportingDone) {
// إذا لم توجد بطاقة، يخرج المعالج فوراً ليكمل الـ loop دون تأخير
if (!mfrc522.PICC_IsNewCardPresent() || !mfrc522.PICC_ReadCardSerial()) {
return;
}

String tagID = “”;
for (byte i = 0; i < mfrc522.uid.size; i++) {
tagID += String(mfrc522.uid.uidByte[i] < 0x10 ? “0” : “”);
tagID += String(mfrc522.uid.uidByte[i], HEX);
}
tagID.toUpperCase();

processAttendance(tagID);

// إنهاء القراءة للاستعداد للبطاقة التالية
mfrc522.PICC_HaltA();
mfrc522.PCD_StopCrypto1();
}
}

// دالة تسجيل الحضور (تم تحسين سرعة البحث)
void processAttendance(String id) {
bool found = false;
for (int i = 0; i < totalStudents; i++) {
if (students[i].uid == id) {
if (!students[i].isPresent) {
students[i].isPresent = true;
Serial.println(“Attendance marked for: ” + students[i].name);

// تنبيه صوتي سريع (100ms بدلاً من 150ms لزيادة الاستجابة)
digitalWrite(BUZZER, HIGH);
delay(100);
digitalWrite(BUZZER, LOW);
}
found = true;
break; // التوقف عن البحث فور إيجاد الطالب لتوفير الوقت
}
}
if (!found) Serial.println(“Unknown Tag: ” + id);
}

// دالة التقرير النهائي بالنصوص الأصلية
void sendAbsenceReport() {
String absentList = “📝 **تقرير الغياب الصباحي**\n”;
absentList += “————————–\n”;
int absentCount = 0;

for (int i = 0; i < totalStudents; i++) {
if (!students[i].isPresent) {
absentList += “❌ ” + students[i].name + “\n”;
absentCount++;
}
}

if (absentCount == 0) {
absentList += “✅ جميع الطلاب حاضرون اليوم.”;
} else {
absentList += “————————–\n”;
absentList += “عدد الغائبين: ” + String(absentCount);
}

// إرسال الرسالة مع التأكد من التنسيق
if (bot.sendMessage(CHAT_ID, absentList, “Markdown”)) {
Serial.println(“Absence report sent!”);
} else {
Serial.println(“Failed to send report”);
}

// تنبيه طويل (ثانية واحدة)
digitalWrite(BUZZER, HIGH);
delay(1000);
digitalWrite(BUZZER, LOW);
}