برنامج SRGBmods QMK الثابت

تنزيل البرنامج الثابت

بفضل فريق المشرفين لدينا، أصبحت الغالبية العظمى من لوحات المفاتيح المدعومة من QMK متاحة الآن للمجتمع كبرامج ثابتة مُعدّة مسبقًا. (يلزم دعم RGB Matrix في QMK حتى تكون لوحة المفاتيح مدعومة). يمكنك العثور على شيفرة GPL المصدرية لإنشاء هذا البرنامج الثابت هنا.

يمكنك العثور على ملفات البرامج الثابتة هنا.

نوصي بأن تجرّب إصدارات VIA أولًا لأنها ستتيح لك إصلاح أي مشكلات في تعيين المفاتيح.

(تأكد من نسخ تخطيطك الحالي احتياطيًا باستخدام VIA قبل التثبيت حتى تتمكن من استعادته بعد ذلك!)

عادةً ما توفّر الشركة المصنّعة للوحة مفاتيحك تعليمات تثبيت البرنامج الثابت. إذا كانت التعليمات تتضمن استخدام QMK Toolbox، فتأكد من تشغيل QMK Toolbox بصلاحيات المسؤول ومن تثبيت برامج التشغيل من داخل QMK Toolbox!

يمكنك أيضًا طلب المساعدة في قنوات QMK على خادم Discord هذا. (يُرجى السؤال فقط على خادم Discord المرتبط هنا، فالسؤال على خادم Discord الرئيسي لـ QMK سيجعلهم يطلبون منك أن تسألنا! - وهو أمر مزعج بلا شك…)

بعد الانتهاء من تثبيت البرنامج الثابت على لوحة مفاتيحك، اقرأ الدليل أدناه لتبدأ في كتابة إضافة للوحة المفاتيح.

مستودع ملحق إضافات SRGBmods QMK

بدءًا من SignalRGB 2.3.20 وما بعده، يكون مستودع ملحق QMK Plugins مفعّلًا افتراضيًا، ومع ذلك توجد عدة فروع في إعدادات هذا الملحق قد تتيح دعم لوحة مفاتيحك. داخل SignalRGB، انتقل إلى الإعدادات / إعدادات الملحقات / QMK-Plugins:

يكون الفرع Main محددًا افتراضيًا ويتضمن الإضافات المعروفة بأنها تعمل جيدًا، أما بقية الفروع فتوضّح طبيعتها بنفسها… إذا لم تتمكن من تشغيل لوحة مفاتيحك بعد اختيار أي من الفروع، فقد تحتاج إلى إنشاء إضافة مستخدم. إليك التعليمات أدناه:

إنشاء إضافة مستخدم

بعد تثبيت البرنامج الثابت على لوحة مفاتيحك، ستحتاج إلى تعديل إضافة لوحة المفاتيح أدناه لجعل SignalRGB يعمل مع لوحة مفاتيحك.

يمكن تنزيل مثال لإضافة لوحة مفاتيح من هنا: QMK_Keyboard_Example.js
يمكن تنزيل قوالب إضافات إضافية (Full وTKL و96% و75% و65% و64% و60% وغيرها) من هنا.
بعد تنزيل إضافة لوحة مفاتيح من أي من المصدرين أعلاه، افتحها في محرر نصوص.

export function Name() { return "QMK Keyboard"; }
export function VendorId() { return 0x0000; }
export function ProductId() { return 0x0000; }
export function Publisher() { return "WhirlwindFX"; }
export function Size() { return [21, 6]; }
export function DefaultPosition(){return [10, 100]; }
export function DefaultScale(){return 8.0}
export function ControllableParameters() {
  return [
    {"property":"shutdownColor", "group":"lighting", "label":"Shutdown Color", "min":"0", "max":"360", "type":"color", "default":"009bde"},
    {"property":"LightingMode", "group":"lighting", "label":"Lighting Mode", "type":"combobox", "values":["Canvas", "Forced"], "default":"Canvas"},
    {"property":"forcedColor", "group":"lighting", "label":"Forced Color", "min":"0", "max":"360", "type":"color", "default":"009bde"},
  ];
}

بعد فتح إضافة لوحة المفاتيح، ستظهر لك شاشة مشابهة للشاشة أعلاه.

ستحتاج إلى ملء بعض هذه الحقول، بدءًا من الحقل Name.
يجب ملء الحقل Name باسم لوحة المفاتيح التي طوّرت البرنامج الثابت من أجلها.

export function Name() { return "Massdrop CTRL QMK Keyboard"; }

بعد ذلك، نحتاج إلى ملء VendorId الخاص بلوحة المفاتيح. (يمكن تخطي خطوات لقطات الشاشة التالية باستخدام هذا الرابط.)

للعثور على VendorId الخاص بلوحة المفاتيح، افتح SignalRGB.
ثم انقر على ترس الإعدادات في الزاوية السفلية اليسرى.

ثم انقر على معلومات الجهاز.

ابحث عن لوحة مفاتيحك ودوّن قيمتي VendorID وProductID الخاصتين بها.

الآن املأ الحقلين VendorId وProductId بهاتين القيمتين.

export function Name() { return "Massdrop CTRL QMK Keyboard"; }
export function VendorId() { return 0x04d8; }
export function ProductId() { return 0xEED2; }

الحقل التالي الذي يجب ملؤه هو الحقل Publisher. في الحقل Publisher، يمكنك وضع اسمك أو اسم المستخدم أو المعرّف الخاص بك.

export function Name() { return "Massdrop CTRL QMK Keyboard"; }
export function VendorId() { return 0x04d8; }
export function ProductId() { return 0xEED2; }
export function Publisher() { return "WhirlwindFX"; }

الآن انتهينا من ملء الحقول، وننتقل إلى المصفوفات.

هناك 3 مصفوفات تحتاج إلى تعديل: vKeys وvKeynames وvKeyPositions

تربط المصفوفة vKeys كل مفتاح في لوحة المفاتيح بموضعه داخل بيانات RGB المُرسلة إلى لوحة المفاتيح.
تخبرنا المصفوفة vKeyNames بالمفتاح المقابل لكل vKey وvKeyPosition.
تخبر المصفوفة vKeyPositions برنامج SignalRGB بموضع كل مفتاح على لوحة المفاتيح.
أولًا، غيّر المصفوفة vKeyNames لتعكس لوحة مفاتيحك.
هذا يعني أنك تحتاج إلى إعادة ترتيب vKeyNames بحيث تطابق لوحة مفاتيحك.
- في حالتنا، اضطررنا إلى إزالة بعض المفاتيح وإعادة تنظيم المفاتيح المتبقية لأن لوحتنا من نوع TKL.

ثم حدّث المصفوفة vKeyPositions بنفس الطريقة التي حدّثت بها المصفوفة vKeyNames.

أخيرًا، حدّث المصفوفة vKeys بحيث تطابق المصفوفتين vKeyNames وvKeysPositions.

الآن، احفظ ملف الإضافة في %userprofile%/Documents/WhirlwindFX/plugins، ثم أعد تشغيل SignalRGB.

من المفترض أن تبدأ لوحة مفاتيحك بالإضاءة والتفاعل مع SignalRGB.

إذا لم تُضئ لوحة المفاتيح أو لم تتفاعل بشكل صحيح مع SignalRGB:

انتقل إلى صفحة الأجهزة في SignalRGB.

بعد ذلك، انتقل إلى لوحة مفاتيحك، ثم انقر على ترس الإعدادات.

ثم انقر على مفتاح التبديل إظهار وحدة التحكم.

يجب أن يظهر في وحدة التحكم إجمالي عدد مصابيح LED في الجهاز (Device Total LED Count). قارن هذا العدد بعدد مصابيح LED التي خصصتها.
- في حالتنا، يوجد 119 مصباح LED إجمالًا.

إذا كان عدد مصابيح LED يطابق عدد vKeys لديك:

تأكد من أن حقل Size في إضافتك أكبر بمقدار 1 في كل اتجاه من أعلى إحداثي لمصابيح LED:
- في حالتنا، يقع أبعد مصباح LED في الموضع [17,6]، لذا يجب أن يكون حقل Size هو [18,7].

export function Size() { return [18, 7]; }

إذا كان عدد مصابيح LED لا يطابق عدد vKeys لديك:

ستحتاج إلى إضافة vKeys وvKeyPositions وvKeyNames لتطابق إجمالي عدد مصابيح LED.
- في حالتنا، كان الجهاز يحتوي على 119 مصباح LED، لذا احتجنا إلى إضافة 32 مصباح LED للإضاءة السفلية للوحة المفاتيح.

إذا كان عدد vKeys يطابق إجمالي عدد مصابيح LED وكان حجم الجهاز مضبوطًا بشكل صحيح، لكن مصابيح LED مربوطة بشكل غير صحيح:
انضم إلى Discord واطلب المساعدة في قنوات QMK.