Layout Editor ZMK

الغرض والنية للمستخدم: يحل هذا Tool مشكلة تصميم وتحقق وتصدير مخططات لوحات المفاتيح لبرمجيات ZMK. يستهدف مهندسي البرمجيات الثابتة، مصممي الأجهزة وبنّاء اللوحات الذين يخططون أسلاك المصفوفة والتعيينات حسب الطبقة. يقدّم المستخدمون board_rows وboard_cols وlayers وقيود footprint، يضعون المفاتيح على شبكة ويحددون مفاتيح لكل طبقة. يضمن Tool القابلية للإنشاء قبل النمذجة الأولية وينتج تصديرات جاهزة للتكامل مع عملية البناء. كما يدعم التخطيط متعدد الطبقات ويقدم مخرجات قابلة للمراجعة.
المنطق الأساسي والميزات: المحرك الأساسي عبارة عن مُشغّل تخطيط مبني على شبكة مع تعريف الشبكة وتحديد مواقع المفاتيح عبر عدة طبقات والتحقق من صحة التعيينات. الميزات الاختيارية تشمل التكامل مع مكتبة footprint، اقتراحات توزيع تلقائية واستيراد/تصدير دفعي للتكوينات. تقيد القواعد بتعيين واحد فقط لكل خلية في كل طبقة، تتحقق من الحدود وتكشف عن تعارضات بين الطبقات وتبلغ عن وضعيات غير قابلة. يولّد خرائط لكل طبقة وتكويناً موحّداً يتوافق مع عمليات ZMK YAML/JSON.
المدخلات والمخرجات: المدخلات تشمل board_rows (int)، board_cols (int)، layers (int)، footprint (string). المخرجات تشمل خرائط كل طبقة وتكويناً موحّداً وتقارير تحقق تسلط الضوء على التعارضات والفجوات ومشاكل الحدود. التصدير متوافق مع مقاييس ZMK وجاهز للدمج في firmware.
الخوارزميات والحسابات: يربط إحداثيات الشبكة بخطوط المصفوفة، يحسب فهارس كل طبقة ويكوّن البيانات لصيغة متوافقة مع ZMK. يعتمد على منطق مصفوفة لوحة المفاتيح القياسي ويدعم التخطيطات غير المتساوية عبر عناصر نائب.
الأخطاء والحالات الحدية: يُبلِّغ عن مدخلات غير صالحة، مدخلات مفقودة، ازدواجيات، مواقع خارج الحدود وعدم توفر مكتبة footprint مع رسائل قابلة للتنفيذ. سلوك فشل سريع يوجّه إلى خطوات التصحيح.
الصناعة/الإقليم والتوطين: يتماشى افتراضياً مع اتجاهات لوحة مفاتيح ANSI-US، مع تعيينات طبقة محلية ووثائق للهياكل الإقليمية. الوحدات هي خلايا الشبكة؛ لا افتراضات هاردوير محلية خارج معايير مفاتيح الأكواد.
الافتراضات والاستثناءات: يفترض وجود مكتبة footprint صالحة و outputs متوافقة مع firmware؛ يستبعد واجهة المستخدم وتقييمات الأجهزة أو أهداف firmware غير ZMK. لا يغطي السماكات التصنيعية أو تصميمات لوحات مفاتيح غير القائمة على شبكة.