التحكم في المراوح

يمكن للإضافات إتاحة التحكم في سرعة المراوح والإبلاغ عن درجات الحرارة لنظام التبريد في SignalRGB. عند تفعيل ذلك، يمكن للمستخدمين ضبط منحنيات المراوح ومراقبة عدد الدورات في الدقيقة (RPM) وعرض قراءات درجات الحرارة مباشرة في SignalRGB.

النمط العام للإضافة التي تدعم التحكم في المراوح هو:

1. صدّر SupportsFanControl() بحيث تُرجع true لإبلاغ SignalRGB بأن هذا الجهاز يحتوي على مراوح قابلة للتحكم.
2. اكتشف المراوح المتصلة (عبر أوامر خاصة بالجهاز أو من خلال استطلاع قيم RPM).
3. استدعِ device.createFanControl() لكل مروحة مكتشفة داخل Initialize().
4. في كل إطار داخل Render(): اقرأ قيمة RPM الحالية من الجهاز وأبلغ عنها باستخدام device.setRPM()، ثم اقرأ السرعة المطلوبة من device.getFanLevel() وطبّقها على الجهاز.

تنبيه

يجب استدعاء device.setRPM() في كل إطار. إذا توقف تحديثها، فستتجمّد السرعة المطلوبة لوحدة التحكم في المروحة.

تحقق دائمًا من device.fanControlDisabled() قبل استدعاء أي من دوال مستوى المروحة. فقد يكون التحكم في المراوح غير متاح لأن المستخدم لا يملك SignalRGB Pro، أو لأن المستخدم قد عطّله يدويًا.

---

تصدير الإضافة

SupportsFanControl()

تُصدَّر من الإضافة للإعلان عن أن هذا الجهاز يدعم التحكم في المراوح. يستدعيها SignalRGB أثناء التهيئة ليقرر ما إذا كان سيعرض واجهة التبريد للجهاز.

export function SupportsFanControl() { return true; }

إذا كان هذا التصدير غير موجود أو أرجع false، فستظل واجهة برمجة التحكم في المراوح متاحة، لكن واجهة التبريد لن تظهر للجهاز.

---

طرق وحدة التحكم في المروحة

device.fanControlDisabled()

تُرجع true إذا كان التحكم في المراوح غير متاح حاليًا — إما لأن المستخدم لا يملك SignalRGB Pro، أو لأنه عطّل نظام التبريد يدويًا.

تحقق دائمًا من هذا قبل استدعاء device.getFanLevel() أو device.getNormalizedFanLevel().

القيمة المُرجعة	النوع	الوصف
Disabled	boolean	true إذا كانت واجهة برمجة التبريد غير متاحة

if (device.fanControlDisabled()) {
    return;
}

---

device.createFanControl(fanId)

تُنشئ وحدة تحكم في مروحة بالمعرّف المُعطى. استدعِها داخل Initialize() لكل مروحة يتيحها الجهاز. إذا كانت هناك وحدة تحكم بالمعرّف نفسه موجودة بالفعل، فسيتم تجاهل الاستدعاء.

المعامل	النوع	الوصف	مثال
FanId	string	معرّف فريد لوحدة التحكم في المروحة هذه	"Fan1"

device.createFanControl("Fan1");
device.createFanControl("Fan2");

---

device.removeFanControl(fanId)

تزيل وحدة التحكم في المروحة ذات المعرّف المُعطى. استخدمها إذا لم تعد المروحة مكتشفة أو انقطع اتصال الجهاز.

المعامل	النوع	الوصف	مثال
FanId	string	معرّف وحدة التحكم في المروحة المراد إزالتها	"Fan1"

---

device.getFanLevel(fanId)

تُرجع سرعة المروحة المطلوبة لوحدة التحكم المُعطاة كنسبة مئوية (0–100)، مشتقة من إعدادات منحنى المروحة الحالية للمستخدم.

تنبيه

تحقق دائمًا من device.fanControlDisabled() قبل استدعاء هذه الدالة.

المعامل	النوع	الوصف	مثال
FanId	string	معرّف وحدة التحكم في المروحة	"Fan1"

القيمة المُرجعة	النوع	الوصف	مثال
FanSpeed	int	السرعة المطلوبة، 0–100	42

let speed = device.getFanLevel("Fan1"); // e.g. 42 (meaning 42%)

---

device.getNormalizedFanLevel(fanId)

تُرجع سرعة المروحة المطلوبة كعدد عشري مُطبَّع (0.0–1.0). مفيدة عندما يتوقع الجهاز دورة تشغيل كسرية بدلًا من نسبة مئوية.

تنبيه

تحقق دائمًا من device.fanControlDisabled() قبل استدعاء هذه الدالة.

المعامل	النوع	الوصف	مثال
FanId	string	معرّف وحدة التحكم في المروحة	"Fan1"

القيمة المُرجعة	النوع	الوصف	مثال
FanSpeed	float	السرعة المطلوبة، 0.0–1.0	0.42

let speed = device.getNormalizedFanLevel("Fan1"); // e.g. 0.42

---

device.setRPM(fanId, rpm)

تُبلغ عن قيمة RPM المقاسة حاليًا لوحدة التحكم في المروحة. تُعرض هذه القيمة في واجهة التبريد ورسوم مراقبة النظام البيانية.

تنبيه

يجب استدعاء هذه الدالة في كل إطار. إذا توقف تحديثها، فستتجمّد السرعة المستهدفة لوحدة التحكم في المروحة.

المعامل	النوع	الوصف	مثال
FanId	string	معرّف وحدة التحكم في المروحة	"Fan1"
RPM	int	سرعة المروحة الحالية بوحدة RPM	1337

let rpm = ReadRPMFromDevice("Fan1");
device.setRPM("Fan1", rpm);

---

طرق مستشعر درجة الحرارة

يمكن للإضافات أيضًا إتاحة قراءات درجات الحرارة لنظام التبريد في SignalRGB. تظهر هذه القيم في مراقبة النظام ويمكن استخدامها كمصدر إدخال لمنحنيات المراوح.

device.createTemperatureSensor(sensorId)

تُنشئ مستشعر درجة حرارة بالمعرّف المُعطى. استدعِها داخل Initialize() لكل مصدر لدرجة الحرارة يتيحه الجهاز.

المعامل	النوع	الوصف	مثال
SensorId	string	معرّف فريد لهذا المستشعر	"Coolant Temp"

device.createTemperatureSensor("Coolant Temp");

---

device.removeTemperatureSensor(sensorId)

تزيل مستشعر درجة الحرارة ذا المعرّف المُعطى.

المعامل	النوع	الوصف	مثال
SensorId	string	معرّف المستشعر المراد إزالته	"Coolant Temp"

---

device.SetTemperature(sensorId, temperature)

تُبلغ عن درجة الحرارة الحالية للمستشعر المُعطى. استدعِها في كل إطار بعد قراءة القيمة من الجهاز.

المعامل	النوع	الوصف	مثال
SensorId	string	معرّف المستشعر	"Coolant Temp"
Temperature	float	درجة الحرارة الحالية بالدرجات المئوية	34.5

let temp = ReadTemperatureFromDevice();
device.SetTemperature("Coolant Temp", temp);

---

مثال كامل

export function SupportsFanControl() { return true; }

export function Initialize() {
    device.createFanControl("Fan1");
    device.createFanControl("Fan2");
    device.createTemperatureSensor("Coolant Temp");
}

export function Render() {
    // Report current RPM — required every frame or speed will hardlock
    device.setRPM("Fan1", ReadRPM(1));
    device.setRPM("Fan2", ReadRPM(2));

    // Report current temperature
    device.SetTemperature("Coolant Temp", ReadTemp());

    // Apply desired speed to hardware
    if (!device.fanControlDisabled()) {
        SetDeviceFanSpeed(1, device.getFanLevel("Fan1"));
        SetDeviceFanSpeed(2, device.getFanLevel("Fan2"));
    }
}

export function Shutdown() {
    device.removeFanControl("Fan1");
    device.removeFanControl("Fan2");
    device.removeTemperatureSensor("Coolant Temp");
}