اضافه شدن ورک فلو تست شبکه

README.md

@@ -0,0 +1,39 @@
+# فلش و تست دستگاه Amin Pardaz Asia v1.5
+
+workflow اصلی `flash-aminpa-V1.5.yml` با push به شاخهٔ `main` اجرا می‌شود.
+workflow تست نرم‌افزاری برای اجرا پس از موفقیت آن و همچنین اجرای دستی تعریف شده است.
+
+## متغیرهای Gitea برای تست نرم‌افزاری
+
+متغیرها را در تنظیمات مخزن Gitea، بخش **Actions → Variables** تعریف کنید.
+نام متغیرها باید دقیقاً مطابق جدول باشد.
+
+| نام متغیر | کاربرد | پیش‌فرض | الزامی |
+| --- | --- | --- | --- |
+| `TEST_INTERFACE` | نام کارت شبکهٔ میزبان runner برای تست | `eno1` | خیر |
+| `TEST_HOST_IP` | آدرس IPv4 میزبان runner روی کارت شبکهٔ تست | `192.168.75.15` | خیر |
+| `TEST_DEVICE_IP` | آدرس IPv4 دستگاه فلش‌شده که باید به ping پاسخ دهد | ندارد | بله |
+
+`TEST_HOST_IP` آدرس میزبان است، نه دستگاه هدف. مقدار `TEST_DEVICE_IP` باید
+با آن متفاوت باشد و با IP دستگاه پس از بوت سیستم‌عامل مطابقت داشته باشد؛
+این مقدار لزوماً همان `ipaddr` موقت در U-Boot نیست.
+
+IP میزبان باید از قبل روی کارت شبکهٔ انتخاب‌شده تنظیم شده باشد و مسیر رسیدن
+به دستگاه از همان کارت شبکه عبور کند. اسکریپت تنظیمات شبکهٔ میزبان را تغییر نمی‌دهد.
+مقادیر IP به‌صورت آدرس IPv4 وارد می‌شوند، نه رنج یا CIDR.
+
+اسکریپت با پایتون سیستم و ابزارهای سیستم `ip` و `ping` اجرا می‌شود.
+پس از بررسی تنظیمات میزبان، حداکثر ۱۸۰ ثانیه منتظر پاسخ ping دستگاه می‌ماند؛
+اولین پاسخ موفق نتیجهٔ `PASS` دارد. نبود پاسخ تا پایان مهلت یا خطای تنظیمات
+باعث `FAIL` و شکست workflow می‌شود.
+
+نمونهٔ اجرای دستی روی runner با جایگزین‌کردن IP واقعی دستگاه:
+
+```bash
+/usr/bin/python3 scripts/software_test.py \
+  --interface eno1 \
+  --host-ip 192.168.75.15 \
+  --device-ip <DEVICE_IP>
+```
+
+برای محل فایل‌های firmware و نقشهٔ فلش، [راهنمای firmware](firmware/README.md) را ببینید.