مرجع Kconfig

idf.py menuconfig، قائمة Safi Configuration (main/Kconfig.projbuild). كيف تتراكب هذه مع sdkconfig.local وملف الإنتاج: بداية العمل.

عام

الخيار	النوع	الافتراضي	الغرض
SAFI_WIFI_SSID	string	فارغ	شبكة WiFi الاحتياطية في زمن البناء (مسار التزويد 2). ضع القيم الحقيقية في sdkconfig.local، لا في ملفات متتبعة أبداً
SAFI_WIFI_PASSWORD	string	فارغ	كلمة المرور المرافقة
SAFI_MDNS_HOSTNAME	string	safi	اسم مضيف mDNS؛ ترد لوحة التحكم على https://<hostname>.local
SAFI_PROVISIONING_TRANSPORT	choice	SoftAP	وسيلة نقل التزويد: SAFI_PROVISIONING_TRANSPORT_SOFTAP (الافتراضي) أو SAFI_PROVISIONING_TRANSPORT_BLE. كلتاهما تعملان مع تطبيق التزويد من Espressif؛ انظر خطوات الاقتران عبر BLE
SAFI_PROVISIONING_WINDOW_MIN	int	10	الدقائق التي تبقى فيها نافذة التزويد مفتوحة قبل أن تعيد الدورة محاولة بيانات الاعتماد المخزنة (لماذا يتناوبان)
SAFI_MAX_RFID_CARDS	int	50	سعة قاعدة بيانات البطاقات؛ كل خانة تكلف بضع عشرات من بايتات NVS
SAFI_TIMEZONE	string	EET-2EEST,M4.5.5/0,M10.5.4/24	المنطقة الزمنية الافتراضية وفق POSIX قبل أن يضبط المستخدم واحدة؛ تُشحن بالقاهرة (EET-2، توقيت EEST الصيفي). إشارة POSIX معكوسة، لذا EET-2 تعني UTC+2 (تحذير اصطلاح الإشارة)
SAFI_SNTP_SERVER	string	pool.ntp.org	مصدر الوقت؛ غيّره للشبكات التي تحجب NTP العام
SAFI_RTC_DS3231	bool	y	استكشف RTC من DS3231 عند الإقلاع؛ العتاد الغائب يتدهور إلى SNTP فقط
SAFI_RTC_INT_GPIO	int	10	منفذ GPIO الموصول بدبوس INT في DS3231 (تصريف مفتوح، نشط منخفضاً، يتطلب مقاومة رفع)؛ جزء من قناع استيقاظ السكون العميق
SAFI_LCD_PANEL	choice	ST7735S	أي شاشة يقودها هذا البناء: SAFI_LCD_ST7735S (1.8 بوصة 128x160) أو SAFI_LCD_ST7789 (1.47 بوصة 172x320)؛ انظر اختيار الشاشة
SAFI_LCD_SPI_CLOCK_MHZ	int	10 أو 20	ساعة SPI للشاشة؛ افتراضي لكل شاشة، اخفضه إلى 10 مع أسلاك وصل صاخبة
SAFI_DISPLAY_BOOT_TEST_PATTERN	bool	n	أشرطة اختبار خام للشاشة عند الإقلاع، من أجل تشغيل العتاد الأول فقط؛ يكلف وقت إقلاع عند التفعيل
SAFI_AUDIO_BOOT_TONE	bool	n	يشغل نغمة 1 كيلوهرتز مباشرة إلى I2S لنحو 1.5 ثانية بعد بدء المكبر، متجاوزاً المفكك وبطاقة SD ومستوى الصوت البرمجي لعزل مسار ESP32 إلى MAX98357A إلى السماعة. للتشغيل الأول فقط

القائمة الفرعية Safi Security

الخيار	النوع	الافتراضي	الغرض
SAFI_ALLOW_INSECURE_OTA_PULL	bool	n	يسمح بسحب OTA عبر HTTP الصريح لخوادم المنضدة. للمطورين فقط؛ ترفض بوابات الإنتاج البناء مع تفعيله
SAFI_ENFORCE_PRODUCTION_GATES	bool	n	يحول قائمة التحقق من التحصين إلى أخطاء ترجمة (لماذا)
SAFI_OTA_REQUIRE_FINGERPRINT_PIN	bool	n	يثبت سحوبات OTA على هوية خادم مضبوطة
SAFI_OTA_SERVER_URL_PREFIX	string	فارغ	بادئة الرابط المطلوبة لسحب OTA عند تفعيل التثبيت

خيارات بارزة ليست من صافي يضبطها هذا المشروع

مضبوطة في sdkconfig.defaults وتستحق المعرفة عندما تفاجئك:

الخيار	القيمة	لماذا
CONFIG_MBEDTLS_EXTERNAL_MEM_ALLOC	y	مخازن TLS المؤقتة في PSRAM (الضغط)
CONFIG_SPIRAM_ALLOW_BSS_SEG_EXTERNAL_MEMORY	y	يتيح ثوابت EXT_RAM_BSS_ATTR
CONFIG_LV_USE_BIDI، CONFIG_LV_USE_ARABIC_PERSIAN_CHARS	y	عرض العربية
CONFIG_LV_FONT_FMT_TXT_LARGE	y	تتطلبه الخطوط العربية المدمجة
أمثلة LVGL والعروض التوضيحية	off	تكلف نحو 240 كيلوبايت من RAM الداخلية في لوحات ثابتة
عدد مخازن WiFi الثابتة RX/TX	مخفض	مقاس لبث الصوت، ويمول مكدس الصوت والمخزن الحلقي (الميزانية)
CONFIG_ESP_COREDUMP_ENABLE_TO_FLASH	y	فحص ما بعد الانهيار