3D baskı macropad: ESP32 ve Home Assistant için özel kontrol paneli

Bir ışığı değiştirmek için telefonda uygulama açmak her zaman en rahat yol değildir. Masada çalışan biri çoğu zaman aynı birkaç işlemi tekrarlar: çalışma ışığını açar, ekran parlamasını azaltır, dinlenme sahnesine geçer veya odadan çıkarken aydınlatmayı kapatır. Bu işlemlerin sabit bir fiziksel karşılığı olduğunda kullanıcı önce arayüzü bulmak zorunda kalmaz. Elini uzatır, işaretini bildiği tuşa basar ve sonucu görür. 3D baskı macropad projesinin değeri, elektronik bileşenleri küçük bir kutuya sığdırmanın ötesinde bu ilişkiyi tasarlayabilmesidir.

Prusa'nın 12 Haziran 2026 tarihli özel macropad projesi, altı mekanik tuşu, döner encoder'ı ve küçük OLED ekranı Seeed XIAO ESP32-C3 kartıyla birleştiriyor. Kart ESPHome üzerinden Home Assistant ile haberleşiyor; basılmış gövde de düğmeleri, ekranı ve USB bağlantısını masa üstünde kullanılabilir bir nesneye dönüştürüyor. Bu yazı kaynak projenin mekanik ve yazılımsal kararlarını inceler, yeni bir tasarımda çözülmesi gereken ayrıntıları açar. Anlatılan yeni çalışma masası senaryosu bir tasarım örneğidir; gerçekleştirilmiş METATECHTR kurulumu veya doğrulanmış ürün testi değildir.

Buradaki kapsam USB ile beslenen bir kullanıcı arayüzüdür. Macropad, Home Assistant'ın zaten yönettiği aydınlatmaya komut verir. Şebeke gerilimini anahtarlayan bir röle kutusu, priz veya elektrik tesisatı yapımı anlatılmaz. Bu sınır mekanik tasarımı da sadeleştirir: gövdenin görevi kartı, düşük gerilimli bağlantıları ve kumandaları taşımaktır. Bir ev otomasyon sisteminin bütün güvenliğini veya hedef cihazların elektriksel uygunluğunu tek başına bu kutu sağlamaz.

Tuş sayısından önce kullanım davranışını belirlemek

Altı tuşun bulunması, mutlaka altı renk seçmek gerektiği anlamına gelmez. Kaynak proje renkler üzerinden kolay anlaşılır bir gösterim kurar. Yeni bir çalışma masasında ise aynı sayıda tuş farklı görevleri temsil edebilir: yoğun çalışma, görüntülü görüşme, okuma, akşam, genel aydınlatma ve kapatma. Önce kullanıcının gerçekte tekrarladığı işleri yazmak gerekir. Çok seyrek yapılan bir ayarı ayrı tuşa bağlamak, en sık kullanılan işlevi bir menünün arkasına saklamaya değmeyebilir.

İşlev listesini fiillerle yazmak yararlıdır. “Mavi” bir renk adıdır; “arkadaki vurgu ışığını mavi yap” ise hedefi ve eylemi tanımlar. “Toplantı” kelimesi tek başına hangi lambaların değişeceğini söylemez; yüzü aydınlatan lambayı açma ve arka plandaki aşırı parlak ışığı azaltma davranışı açık bir sahne tanımıdır. Kullanıcının zihnindeki iş ile otomasyonun değiştirdiği varlıklar arasındaki fark bu aşamada ortaya çıkar. Donanım üretildikten sonra keşfedilirse tuş üzerindeki simgeler de yanlış kalabilir.

Bir tuşun tekrar basıldığında ne yaptığı ayrıca kararlaştırılmalıdır. İlk basışta bir sahne seçip ikinci basışta kapatmak yer tasarrufu sağlar; fakat panelin sahne bilgisinin doğru olması gerekir. Aynı ışık telefondan değiştirilmişse panelin son gönderdiği renk ile gerçek durum ayrışabilir. Ayrı kapatma tuşu daha fazla alan kullanır, buna karşılık kullanıcının önce mevcut sahneyi çözmesini gerektirmez. Hangisinin uygun olduğu tuş sayısından çok kullanım ortamına bağlıdır. Birden fazla kişinin kullandığı ortak masada açık anlamlı eylemler genellikle daha kolay öğrenilir.

Uzun basış, çift basış ve tuş birleşimleri ilk tasarımda cazip görünür. Bunlar aynı yüzeye daha çok komut sığdırır ancak görünmez bir öğrenme yükü oluşturur. Sadece sahibi tarafından kullanılan bir panelde ileri işlevler kabul edilebilir; misafirlerin de dokunduğu bir lambada aynı davranış şaşırtıcı olabilir. İlk sürümde kısa basışların anlaşılır olması, sonra gerçekten gerekli bir ikinci davranışın eklenmesi daha yönetilebilir bir geliştirme yoludur. Kullanıcı hiç kullanmadığı bir işlev için karmaşık durum mantığını taşımak zorunda kalmaz.

Encoder için de tek ve anlaşılır bir ana görev seçilmelidir. Işık parlaklığını çevirmeyle ayarlamak doğal bir eşleşmedir. Aynı düğmeye basıp ekran kontrastını değiştirme moduna geçmek kaynak projede yer kazandırır. Bunun bedeli, çevirmenin anlamının zaman zaman değişmesidir. Mod değişikliği ekranda belirgin değilse kullanıcı ışığı kısmaya çalışırken yalnız ekranı karartabilir. Böyle bir ikincil mod seyrek kullanılıyorsa gündelik hareketten ayrı bir ayar akışına taşınması da düşünülebilir.

Elin ulaşacağı düzeni elektronik listesiyle birlikte düşünmek

Masa üstündeki kumandada yalnız toplam en ve boy önemli değildir. Tuşun üst yüzeyi, çevrilen düğmenin çapı, gövdenin yüksekliği ve elin yaklaşma yönü birlikte değerlendirilir. Yan yana iki tuş arasında görsel boşluk bulunması, parmağın onları rahat ayıracağı anlamına gelmez. Özellikle keycap yüzeyleri dışa doğru genişliyorsa üstteki aralık gövde üzerindeki açıklıktan daha küçük olabilir. Tasarımın ölçülmesi gereken yüzeyi anahtar deliği kadar parmağın temas ettiği yüzeydir.

Encoder tuşlara fazla yakın yerleştirilirse çevrilirken yakındaki tuşa dokunmak kolaylaşır. Düğme etrafında parmakların süpürdüğü alanı düşünmek bu sorunu görünür kılar. Kullanıcı düğmeyi iki parmağıyla yanlardan kavrayacaksa, yalnız üstten bastırarak çevirecek kullanıcıya göre farklı bir boşluğa ihtiyaç duyar. Düğme boyunu büyütmek kavramayı kolaylaştırabilir ama masada istemeden çarpma olasılığını da artırır. Bu karar yalnız gövde render'ına bakılarak verilmemelidir.

Mekanik anahtarın hissi de işlevin bir parçasıdır. Kaynak projede kullanılan Blue tipi anahtarın seçilmiş olması bütün ortamlar için sessiz veya ideal olduğu anlamına gelmez. Ortak çalışma alanında tuş sesi istenmeyebilir; bazı kullanıcılar belirgin hissi tercih edebilir. Anahtar değiştirilirse sadece elektrik kontağı değil, gövdeye oturma biçimi, plaka kalınlığı, tırnak geometrisi ve keycap bağlantısı yeniden incelenir. Birbirine benzeyen parçaların aynı dış ölçülere sahip olduğunu varsaymak gereksiz baskı tekrarlarına yol açabilir.

Ekranı kullanıcının baktığı yöne yerleştirmek önemlidir. Panel klavyenin solunda duracaksa, tam karşıdan okunacak biçimde çizilmiş küçük yazılar pratikte dar açıdan görülebilir. Gövdeyi eğimli yapmak bazen okumayı kolaylaştırır, fakat tuşlara basarken kaymayı ve arka taraftaki kablonun çıkış yönünü de etkiler. Düz bir gövdeyi yükselten ayrı ayaklar, ilk gövdeyi değiştirmeden açıyı denemek için yararlı bir seçenek olabilir. Burada amaç bütün panellere aynı eğimi önermek değil, yerleşimin gerçek masa üzerindeki ilişkisinin sınanmasıdır.

Kablo da kullanım alanının içindedir. USB girişi arka yüzdeyse paneli duvara çok yaklaştırmak kabloyu sıkıştırabilir. Yandan çıkan kablo fare hareketine engel olabilir. Sağ açılı kablo seçmek sorunu çözebilir, ancak bu kez konektör başlığının şekli ve gövdedeki açıklık birbirine uymalıdır. Kutu deliği yalnız metal USB ucuna göre çizilirse kalın plastik başlık sonuna kadar oturamayabilir. Bu yüzden kablonun gerçek başlık ölçüsünü tasarım girdisi olarak almak gerekir.

Gövdeyi dış kabuk değil, parça yerleştirme sistemi olarak tasarlamak

Kaynak macropad, üst gövdeye tutunan anahtarları, ekran ve encoder yerleşimini, alt kapağı ve kartın hareketini sınırlayan parçayı birlikte ele alır. Özellikle USB kablosu takılırken kartın geriye itilmesini engelleyen mesafe parçası dikkat çekicidir. Bir kart masada kablosuz dururken sağlam görünse bile kablo takma kuvveti onu yerinden oynatabilir. Konektörü dışarı açmak tek başına yeterli değildir; bağlantı anında kuvvetin nereye aktarıldığı da tasarlanmalıdır.

Kartı sabitleyen yüzeylerin bileşenlerin üstüne basmaması gerekir. Baskılı devre kartının kenarıyla üzerindeki elemanların yükseklikleri aynı şey değildir. Altında lehim çıkıntıları olan bir kartı tamamen düz zemine bastırmak, gövde modelinde görünmeyen temaslar oluşturabilir. Destek noktaları kartın üretici çizimi ve gerçek parçanın yerleşimiyle birlikte belirlenmelidir. Kutu içinde boşluk bulunduğu için kartı rastgele köpükle veya sıkıştırılmış kabloyla tutturmak, sonraki servis işlemlerini zorlaştırır.

Anahtar açıklıkları için gövdenin üst yüzey kalınlığı özel önem taşır. Tırnaklı bir anahtar belirli bir plaka ilişkisi için tasarlanmış olabilir. Üst yüzeyi kalınlaştırarak genel kutuyu daha sağlam yapmak, tırnağın arka taraftan açılmasını engelleyebilir. Böyle bir durumda bütün paneli inceltmek yerine anahtar çevresinde yerel bir oturma geometrisi düşünülür. Bu, dış kabuğun rijitliği ile bağlantı ayrıntısının gerektirdiği şekli birbirinden ayırmaya yardımcı olur.

Encoder milinin yüksekliği de iki parçayı birbirine bağlar: elektronik modülün gövde içindeki konumu ve dış düğmenin kavrama derinliği. Düğme çok aşağı oturursa üst yüzeye sürtünebilir; çok yukarıda kalırsa yalpalama hissi artabilir. Milin kesiti ve düz yüzeyi varsa düğmenin iç boşluğu buna uygun olmalıdır. Ekran çerçevesiyle encoder gövdesi aynı yükseklikte görünse bile gerçek kartlar, somunlar veya kablo uçları farklı hacim kaplayabilir. CAD içinde yalnız görünen üst parçaları modellemek yeterli olmaz.

Alt kapağın sökülebilir olması, ilk montajdan sonra da değerlidir. Wi-Fi ayarından bağımsız bir bağlantı hatasını aramak, bir anahtarı değiştirmek veya USB soketini incelemek için içerisine ulaşmak gerekebilir. Sürtünmeli kapak basit bir çözüm olabilir, ancak kaynak dosyadaki geçme ölçüsünün farklı malzeme ve yazıcıda aynı tutuşu sağlayacağı varsayılmaz. Kapak tutuşu, günlük basışlarda açılmama ile gereksiz zorlamadan sökülebilme arasında bir tasarım tercihidir.

İç hacimde kablo güzergâhı neden çizilmelidir?

Elektronik parça listesi yalnız kartların dış ölçülerini saydığında kutu olduğundan büyük görünür. Kablolar eklendiğinde boşluğun önemli kısmı kaybolur. Konektörlerin bükülmeden önce ihtiyaç duyduğu mesafe, kablo demetlerinin dönüşü ve kapağın kapanma yolu ayrı hacimler oluşturur. Kaynak projede Dupont bağlantılarının yüksekliği alt parça tasarımını etkiliyor. Bu örnek, kablolamanın son dakikada yerleştirilecek bir ayrıntı olmadığını gösterir.

Bir kabloyu iki nokta arasında çizilen düz çizgi gibi düşünmek yanıltıcıdır. Gerçek bağlantıda uçların yönü, bağlantının çıkarılacağı hareket ve bükülmenin başlayacağı yer bulunur. Üst gövdeyi kaldırırken kablolar geriliyorsa alt ve üst parçanın ayrılabilmesi için bir servis hareketi tanımlanmalıdır. Kapağın tamamen yana yatırılmasına izin veren düzen, birkaç milimetre açılabilen düzenden farklıdır. Montaj sırasında hangi parçanın elde tutulacağı bile bağlantı sırasını etkileyebilir.

Prototip bağlantılarında söküp takılabilir kablolar değişiklik yapmayı kolaylaştırır. Kaynak yazar günlük kullanımda daha düzenli bir bağlantıya geçmeyi öneriyor. Buradan lehimli her bağlantının otomatik olarak kusursuz olduğu sonucu çıkarılamaz. Kötü hazırlanmış lehim, mekanik gerilim altındaki tel veya korunmamış iletken de sorun yaratabilir. Bağlantı tekniği ne olursa olsun, kablonun çekme kuvvetini doğrudan küçük kart bağlantısına taşımamak ve temasların birbirine değmesini önlemek gerekir.

Kutu içinde kabloların işlevlere göre yönlendirilmesi hata aramayı kolaylaştırır. Altı tuşun ortak bağlantıları bir yerde, ekranın haberleşme hatları başka bir güzergâhta düzenlenebilir. Bu düzenin amacı estetik bir fotoğraf üretmek değildir; hangi kablonun hangi bileşene gittiğini izleyebilmektir. İsimlendirme de aynı mantığı taşımalıdır. “Sol üst tuş” mekanik tanımdır, “çalışma sahnesi” yazılım işlevi, “GPIO2” ise elektriksel bağlantıdır. Bu üç ad aynı satırda tutulduğunda sonraki değişiklikler daha anlaşılır olur.

Montajın son aşamasında kapağın kabloları yerine itmesi beklenmemelidir. Kapak kapatılırken belirgin direnç oluşuyorsa içerideki yığılma görülmeden baskıyla bastırmak, problemin kaynağını saklar. Gövdenin daha yüksek yapılması bazı düzenlerde doğru çözüm olabilir; başka bir tasarımda kartı döndürmek veya konektör yönünü değiştirmek daha iyi sonuç verir. Yalnız dış boyutu küçültmek uğruna bütün erişim ve bağlantı paylarını kaldırmak, macropadın günlük kullanımını iyileştirmez.

Baskı kararları: okunabilir işaretler ve mekanik açıklıklar

Kaynak örnekte farklı renklerle basılmış gövde ve tuşlar kullanılıyor; üretim fotoğraflarında dönemin beta INDX düzeni de yer alıyor. Bu görüntü bir macropad için o sisteme sahip olmanın şartı değildir. Tek renkli bir gövde ve sonradan takılan işaretli keycap'ler de aynı kontrol mantığını taşıyabilir. Çok renk seçimi mekanik uyumdan ayrı ele alınmalıdır. Önce anahtarın ve kapağın doğru oturması, sonra görsel ayrıntıların olgunlaştırılması daha anlaşılır bir iş sırası oluşturur.

Keycap üzerindeki simge yalnız ekranda güzel görünmemelidir. Çok ince bir çizgi dilimleme sırasında kaybolabilir, birbirine yakın iki bölüm birleşebilir veya küçük bir iç boşluk kapanabilir. Simgeyi tasarlarken gerçek baskı genişliğinde görmek gerekir. Karmaşık bir güneş resmi yerine sade bir ışık işareti daha iyi okunabilir. Çizginin pozitif kabartma mı, oyuk mu yoksa başka renkli yüzey mi olduğu da görünürlüğü değiştirir. Tek bir yöntem bütün filament ve ışık koşullarında üstün değildir.

Tuşun üst yüzeyi baskı tablasına bakacak biçimde yerleştirildiğinde görünen yüzeyin dokusu ve işaretin ilk katmandaki ayrıntısı birlikte değerlendirilir. Kaynak görselinde parçaların sunum için nasıl dizildiği ile gerçek baskı yönünü birbirine karıştırmamak gerekir. Dilimleyicideki renkli düzen bir imalat talimatının tamamı değildir. Önizlemede sembolün katmanları, anahtar milini kavrayan bölüm ve üst yüzeyin sürekliliği ayrı incelenir.

Bir keycap bağlantısının sıkılığı yalnız XY ölçüsünden kaynaklanmayabilir. Delik biçimi, baskı yönü, ilk katmanın taşması ve iç köşelerin üretilebilmesi de sonucu etkiler. Takılmayan parçayı zorlayarak anahtara bastırmak yerine, basılmış bağlantı geometrisinin beklenen şekli gerçekten oluşturup oluşturmadığı görülmelidir. Çok gevşek bağlantıda ise bütün tuşu büyütmek gereksizdir; sorun tutunan iç geometridedir. Böyle yerel düzeltmeler dış yüzeydeki simge düzenini korur.

Gövde için malzeme seçimi de görünüşle bitmez. Kaynak projedeki ahşap dolgulu renkler masa üzerinde belirli bir görsel dil kurar. Bunun aynı baskı ayarlarıyla bütün ahşap dolgulu filamentlere uygulanabileceği düşünülmemelidir. Seçilen malzemenin kendi üretici profili, baskı davranışı ve amaçlanan ortamla ilişkisi değerlendirilir. Gövdeyi sıcak bir cihazın yanına koymak gibi kullanım koşulları varsa, yalnız renk uyumuna göre karar vermek yeterli olmaz. Malzeme ailesine ilişkin ayrıntılar için malzeme seçimi rehberine geçilebilir.

Kart seçimi ve pin adları: birbirine benzeyen iki isim sistemi

Kaynak tasarım Seeed XIAO ESP32-C3 üzerine kuruludur. “ESP32” ifadesi bütün kartların aynı fiziksel pin dizilimini, aynı boyutları veya aynı kullanılabilir girişleri sunduğu anlamına gelmez. Başka bir kart tercih edildiğinde hem kablolama hem kutunun iç yerleşimi yeniden ele alınır. USB konektörünün konumu, kartın altındaki parçalar ve anten çevresindeki düzen bile gövdeyle ilişkilidir. Kaynak modelin içine sığmak, elektriksel eşdeğerlik kanıtı değildir.

Kart üzerindeki D etiketleri ile yazılımda kullanılan GPIO numaralarını ayrı tutmak özellikle önemlidir. Kaynak örnekte D0 etiketi GPIO2'ye, D1 GPIO3'e karşılık gelir; diğer bağlantılar da aynı adlandırma mantığıyla eşleştirilmiştir. Rastgele bir internet şemasındaki “2” numarasını kartın ikinci görünen ayağı sanmak yanlış bağlantıya neden olabilir. Eşleştirme, seçilen kartın üretici pin çiziminden alınmalıdır. Seeed'in XIAO ESP32-C3 belgesi bu kartın fiziksel düzenini ve önyükleme açısından özel pinlerini açıklıyor.

Kaynakta altı tuş, encoder'ın iki dönüş hattı ve basma kontağı, ayrıca ekranın iki haberleşme hattı kullanılıyor. Sayısal olarak pinlerin yetmesi, bütün pinlerin her koşulda eşdeğer kullanılabileceği anlamına gelmez. Seeed belgesinde GPIO2, GPIO8 ve GPIO9'un açılış davranışıyla ilişkili strapping pinleri olduğu belirtilir. Bu nedenle özellikle açılışta basılı tutulan bir tuşun sistemi nasıl etkilediği düşünülmelidir. Çalışırken sorunsuz görünen düzen, enerji verildiği andaki seviyeler farklıysa başka davranabilir.

Bağlantı çizimi, gerçek modülün besleme ve sinyal gereksinimleriyle birlikte kontrol edilmelidir. Aynı ürün adıyla satılan ekran veya encoder modüllerinin üzerindeki yardımcı devreler farklı olabilir. “USB'den besleniyor” cümlesi bütün sinyal uçlarının USB besleme gerilimiyle kullanılabileceği anlamına gelmez. Burada evrensel bir bağlantı şeması yerine kaynak projedeki mimari inceleniyor. Gerçek montajda seçilen kartın ve her modülün üretici belgesi esas alınır; varsayımla farklı gerilimler birbirine bağlanmaz.

Ekranın veri hatlarıyla encoder'ın hareket hatları farklı işlevler taşır. İkisi de birkaç kabloyla bağlanıyor diye aynı tür giriş gibi ele alınamaz. Ekranın haberleşme adresi, modül modeli ve yazılım bileşeni birbiriyle uyumlu olmalıdır. Tuşlarda ise boşta ve basılı durumda beklenen mantık seviyesi açıkça belirlenir. Bir tuşun ekranda sürekli basılı görünmesi, mekanik sıkışma kadar ters yorumlanmış giriş veya yanlış bağlantıdan da kaynaklanabilir. Sorunu önce hangi katmanda aradığını bilmek, gereksiz gövde değişikliklerini önler.

Üç ayrı bilgi: istek, gerçek durum ve ekranda görünen durum

Macropad tasarımında en kolay gözden kaçan konu durum bilgisidir. Kullanıcı bir tuşa bastığında panel bir istek üretir. Home Assistant bu isteği işler ve hedef ışığa komut gönderebilir. Işık kendi durumunu bildirir. Panel de ekranda bir metin veya yüzde gösterir. Bu dört olay çok hızlı gerçekleşse bile aynı olay değildir. Kullanıcı “okuma” tuşuna basınca ekranın hemen “OKUMA” yazması, bütün hedef ışıkların istenen duruma geçtiğinin kesin kanıtı sayılmamalıdır.

Kaynak kodda aktif tuş metni ve ışık durumu arasında belirli ilişkiler kurulmuş. Bu, küçük bir projeyi çalıştırmak için anlaşılır bir yaklaşım. Ancak kaynak kodu yeni bir eve uyarlarken hangi bilginin otorite kabul edildiği seçilmelidir. Panelin en son gönderdiği komut mu, Home Assistant'ın bildirdiği ışık özellikleri mi, yoksa bir sahnenin ayrı mantıksal durumu mu esas alınacak? Cevap verilmezse ekran bazen doğru, bazen eski bir durumu temsil eder.

Örneğin kullanıcı panelden beyaz ışığı seçtikten sonra telefondan rengi değiştirsin. Panel yalnız son tuş adını saklıyorsa ekranda hâlâ beyaz yazabilir. Kaynak akış parlaklık ve kapanma durumunun bazı kısımlarını geri alıyor olsa da bu, tüm renk ve sahne ilişkilerini otomatik olarak doğrulamaz. Yeni tasarımda son komutu “istenen sahne”, cihazdan gelen bilgiyi “mevcut durum” olarak ayrı göstermek düşünülebilir. Küçük ekranda ikisine de yer yoksa, gösterilen alanın anlamı sadeleştirilmelidir.

Bu ayrım kapatma davranışını da etkiler. Aynı tuşa ikinci kez basınca kapat kuralı, son tuş etiketine dayanıyorsa dışarıdan yapılan değişikliklerden sonra şaşırtıcı olabilir. Kullanıcı okuma ışığını yeniden çağırdığını düşünürken panel onu kapatabilir. Çözüm her zaman daha çok kod değildir. Bir tuşu her basışta aynı sahneyi çağıracak biçimde tanımlamak ve kapatmayı ayrı eylem yapmak, bazı kullanımlar için daha açık bir davranıştır. Tutarlı anlam, az sayıdaki tuşu verimli kullanmak kadar değerlidir.

Hedef ışığın erişilemez olması da “kapalı” ile aynı durum değildir. Kapalı bir lamba tekrar açılabilir; erişilemez bir varlığa gönderilen komut ise sonuç vermeyebilir. Bilinmeyen değeri otomatik olarak sıfır veya tam parlaklık kabul etmek yanlış geri bildirim üretir. Ekranda kısa bir bağlantı veya hedef uyarısı göstermek, gerçek olmayan bir yüzde sunmaktan daha açıklayıcıdır. Böylece kullanıcı sorunun tuşta mı, ağda mı, yoksa lambada mı olabileceğini daha kolay ayırır.

Encoder hareketini ışık değişimine çevirmek

Döner encoder, potansiyometre gibi fiziksel olarak tek bir mutlak konuma bağlı olmak zorunda değildir. Yazılım hareket adımlarını sayarak bir değer oluşturur. Kaynakta bu değer ışık parlaklığını sınırlı sayıda kademeye dönüştürür. Bunun kullanışlı olması için bir fiziksel tıkın ne kadar değişiklik üreteceği, alt ve üst sınırda ne olacağı ve dışarıdan değişen parlaklığın yerel değere nasıl aktarılacağı anlaşılır olmalıdır.

ESPHome encoder belgesi A ve B sinyallerini, çözünürlük ayarını ve alt üst sınırları tanımlar. Belgede ayrıca başlangıç değerinin yayınlanması ve sayacın yazılımla değiştirilmesi ayrı seçeneklerdir. Dolayısıyla kaynakta görülen bir çözünürlük değerini bütün encoder'lara otomatik uygulamak doğru değildir. Düğmenin bir fiziksel adımında yazılımın ne gördüğü gözlenir. Ters yön algısında da önce A/B eşleşmesi ve yapılandırma incelenir; gövdeyi ters çevirmek gibi alakasız çözümlere gidilmez.

Kademeli kontrolün avantajı tahmin edilebilir olmasıdır. Küçük bir çevirme anlaşılır bir parlaklık değişikliği üretir. Buna karşılık çok az kademe, özellikle düşük ışık düzeylerinde kullanıcıya kaba gelebilir. Daha fazla kademe ise hassasiyet sağlarken uzun aralığı geçmek için daha çok hareket gerektirebilir. Kullanım amacı burada belirleyicidir. Bir odanın genel aydınlatması ile masa üstünde ince parlaklık ayarı yapmak aynı arayüz beklentisini doğurmaz. Tek bir kaynak değeri evrensel ergonomi ölçütü değildir.

Kaynak yazılımda servis modu açıldığında aynı encoder ekran kontrastını yönetir; normal moda dönüldüğünde önceki ışık değerine geri dönülür. Böyle iki değer arasında geçiş yapılıyorsa, ekrandaki mod adının hareket başlamadan görünmesi yararlıdır. Kullanıcı çevirmeye devam ederken modun sessizce değişmesi istenmeyen sonuç verir. Moddan çıkış için ayrıca bir süre sınırı veya açık onay düşünülüyorsa bunun davranışı da tanımlanmalıdır. Bu tasarım seçenekleri kaynak kodda varmış gibi sunulmaz; yeni arayüzün anlaşılabilirliğini artırmak için değerlendirilecek kararlardır.

Ekran kontrastıyla ışık parlaklığının aynı yüzde işaretiyle gösterilmesi de anlam karışıklığı yaratabilir. Kaynak OLED bileşeninde ekranın kontrastı ayarlanıyor; bu, klasik bir arka ışık düğmesiyle aynı fiziksel kavram değildir. ESPHome SSD1306 belgesi desteklenen model ve ilgili ayarları ayırıyor. Yeni ekranda “IŞIK” ve “EKRAN” gibi açık başlıklar kullanmak, aynı sayının iki farklı şeyi temsil ettiğini görünür kılar. Küçük bir metin kararı, elektronik devrede değişiklik yapmadan kullanım hatasını azaltabilir.

Geri besleme döngüsü ve başlangıç davranışı

Işık parlaklığı hem panelden hem telefondan değiştirilebildiğinde iki yönlü bilgi akışı gerekir. Panel ışığı değiştirir, Home Assistant yeni durumu bildirir, panel kendi sayacını günceller. Bu güncelleme yeniden kullanıcı hareketi gibi yorumlanırsa aynı komut tekrar gönderilebilir. Kaynak kod bu ilişkiyi kısa süreli bir geri bildirim engeliyle yönetmeye çalışır. Kullanılan süre belirli bir proje tercihidir; bütün ağlarda gecikmeyi veya yarış durumlarını çözen evrensel bir değer değildir.

Yeni tasarımda olayın kaynağını ayırmak daha açık bir düşünme yöntemidir. Kullanıcı hareketi, dışarıdan gelen durum değişikliği ve açılışta yapılan ilk eşitleme aynı işlevi çağırsa bile aynı niyete sahip değildir. Kullanıcı hareketi bir komut üretebilir. Dış durum güncellemesi yalnız sayacı ve ekranı değiştirebilir. Açılış eşitlemesi ise sistemin mevcut durumunu öğrenmelidir. Bu ayrım yapılınca her güncellemenin hedef ışığa yazma yapması gerekmez.

Kaynak başlangıç akışında encoder için belirli bir ilk değer atanıyor. Bu değer, evdeki ışığın o anda gerçekten o parlaklıkta olduğunu kanıtlamaz. Panel yeniden başlatıldığında gece karanlık olan odaya sırf kendi varsayılanı nedeniyle tam ışık komutu göndermesi istenmeyebilir. Başlangıç davranışını tanımlarken “kullanıcı hiçbir şeye dokunmadı” durumu özellikle ele alınır. İlk bağlantıda yalnız okumak, geçerli durum geldikten sonra kumandayı etkinleştirmek veya son değeri açıkça belirsiz göstermek farklı tasarım seçenekleridir.

Bağlantı yeniden geldiğinde de aynı soru ortaya çıkar. Wi-Fi kesintisi sırasında birkaç tuşa basılmışsa bu eski istekler sonradan topluca uygulanmalı mı? Aydınlatma panelinde çoğu zaman kullanıcının son niyetini değerlendirmek daha anlamlı olabilir, fakat bu karar hedef uygulamanın gereksinimine bağlıdır. Her basışı kuyrukta saklamak otomatik olarak daha güvenilir bir arayüz oluşturmaz. Dakikalar önceki bir “aç” komutunun kullanıcı odadan ayrıldıktan sonra uygulanması istenmeyebilir.

Bu olayları bir zaman çizelgesiyle düşünmek faydalıdır: panel açıldı, ağ kuruldu, Home Assistant bağlantısı geldi, ışık durumu öğrenildi, kullanıcı çevirdi, hedef cevap verdi. Her aşamada ekranda ne göründüğü ve hangi aşamada komut üretilebildiği belirlenir. Böylece sadece başarılı bağlantının fotoğrafını değerlendirmek yerine geçişler de tasarlanır. Bir panelin günlük kalitesi, çoğu zaman normal çalışırken gösterdiği sayıdan çok bu geçişlerde anlaşılır olmasına bağlıdır.

Home Assistant tarafında hedefleri ve otomasyon sınırlarını kurmak

Kaynak proje Home Assistant içinde ışıkları bir grup altında topluyor. Bu yaklaşım paneli tek tek lamba adlarından ayırmayı kolaylaştırabilir: fiziksel tuş aynı işi yapar, grubun içeriği zamanla değişebilir. Ancak bir grup adı yazınca her sistemde aynı varlık kimliğinin oluşacağı varsayılmaz. Mevcut isimler, önceki kayıtlar ve kullanıcı tercihleri kimliği etkileyebilir. Otomasyonda kullanılan gerçek varlık adı kurulu sistemden okunmalıdır; örnek metindeki ad otomatik olarak doğru kabul edilmez.

Grup davranışı da kullanıcı beklentisiyle uyumlu olmalıdır. Bir sahne hem masa lambasını hem arka plan ışığını etkiliyorsa, hepsine aynı parlaklığı göndermek istenen görünümü sağlamayabilir. Panel tuşunun görevi bir grup değerini doğrudan değiştirmek mi, yoksa önceden düzenlenmiş bir sahneyi çağırmak mı olacak? Bu ayrım fiziksel kutudan bağımsızdır. Aynı macropad donanımı farklı otomasyon mantıklarını taşıyabilir; bu esneklik, her davranışı kart yazılımına gömmemek için bir gerekçedir.

Home Assistant'ın ESPHome entegrasyonu yerel API üzerinden bağlantıyı ve cihaz ekleme sürecini belgeliyor. Panelden Home Assistant'a doğrudan eylem çağrısı yapmak ile Home Assistant'ın panel sensörlerini okuyup kendi otomasyonunu yürütmesi aynı izin modeli değildir. Kaynak akışta bu yönler dikkatle ayrılmalıdır. Bir rehberde görülen bütün izinleri anlamadan açmak yerine, gerçekten kullanılan iletişim yönüne uygun ayar seçilir.

Otomasyonun yeni bir hareket geldiğinde ne yaptığı da özellikle encoder için önemlidir. Home Assistant otomasyon modları tek çalıştırma, yeniden başlatma, sıraya alma ve paralel çalışma davranışlarını farklı tanımlar. Kaynakta yeniden başlatma modu kullanılıyor. Hızlı çevirme sırasında yeni olay gelirse önceki eylem dizisi yarıda kalabilir. Işık isteği ile ardından gelen ekran metni güncellemesi aynı dizideyse, yalnız ilk eylemin uygulanması gibi durumlar düşünülmelidir. Mod seçimi “en hızlı olan” şeklinde tek ölçütle yapılmaz.

Yeni bir tasarımda hedef ışığa istek gönderen akış ile doğrulanmış durumdan ekranı güncelleyen akışı ayırmak değerlendirilebilir. Böylece ekran metni önceki otomasyonun son adımına bağımlı kalmaz. Bu öneri hazır ve denenmiş bir kod paketi değildir; kaynak akışın neden belirli durumlarda eski etiket gösterebileceğini anlamaya yarayan bir mimari karardır. Uygulamadan önce gerçek varlıklarla ve seçili yazılım sürümleriyle sınanması gerekir.

Küçük cihazda güvenliği somut ayarlara dönüştürmek

Kaynak yazıdaki kodu doğrudan kopyalamadan önce güncel güvenlik ayarları gözden geçirilmelidir. Wi-Fi parolasını ayrı bir dosyada tutmak yararlıdır, ancak tek başına bütün iletişimin korunduğu anlamına gelmez. ESPHome güvenlik rehberi cihazların güvenilir ağlarda çalışmasını, API şifrelemesini, cihazlara özgü anahtarları ve güncelleme erişiminin korunmasını ele alıyor. Örnek yapılandırma paylaşılırken gerçek ağ parolası veya anahtarın metne, ekran görüntüsüne ya da indirilebilir dosyaya girmemesi gerekir.

ESPHome yerel API belgesi şifreleme anahtarı ve güncel yapılandırma alanları için esas kaynaktır. Güncel API belgesi, hizmetlerin artık eylem olarak adlandırıldığını ve eski services ile homeassistant.service yazımının desteklenmeye devam ettiğini açıklıyor. Bu ad değişikliği tek başına eski dosyanın çalışmayacağı anlamına gelmez; yine de bütün yapılandırma kullanılan sürümle kontrol edilir. Önce kullanılan ESPHome sürümü belirlenir, sonra yapılandırma doğrulanır. Derleyicinin kabul ettiği dosya da otomasyonun istenen kullanıcı davranışını gerçekleştirdiğini tek başına kanıtlamaz; sözdizimi ile işlev ayrı kontrollerdir.

Bu panelin internetten doğrudan erişilebilir olması günlük aydınlatma işlevi için bir gereklilik değildir. Hangi ağdan erişileceği ve kimin yapılandırma değiştirebileceği açık tutulur. Gereksiz yönetim arayüzleri sırf örnekte bulunduğu için etkinleştirilmez. Cihaz devredilecekse ağ bilgileri ve erişim anahtarları da eski kurulumdan bağımsız ele alınır. Burada amaç küçük projeyi kurumsal bir ağ kitabına dönüştürmek değil, cihazın işlevi için gerçekten gereken erişimi tanımlamaktır.

İlk çalıştırmayı anlamlı aşamalara ayırmak

İlk denemede bütün tuşları, ekranı, encoder'ı ve ışık otomasyonunu aynı anda bağlamak hatanın yerini belirsizleştirir. Daha anlaşılır bir sıra, önce kartın USB üzerinden programlanabildiğini, sonra tek bir girişin beklenen durumu verdiğini, ardından ekranın doğru içeriği gösterebildiğini görmektir. Seeed belgesinin belirttiği gibi yalnız şarj için yapılmış bir USB kablosu veri bağlantısı sağlamayabilir. Bu nedenle bilgisayarın kartı görmemesi her zaman kart veya yazılım arızası değildir.

Tuşları kontrol ederken fiziksel sırayla yazılım adlarını birlikte izlemek gerekir. Sol üst tuşa basınca başka işlev değişiyorsa önce bağlantı eşleşmesi araştırılır. Bir tuş sürekli aktif görünüyorsa kapak takılmadan da aynı davranışın oluşup oluşmadığı gözlenir. Sorun yalnız gövde kapalıyken ortaya çıkıyorsa keycap sürtünmesi, anahtarın sıkışması veya kablonun hareketi gibi mekanik nedenler daha olası hale gelir. Elektriksel ve mekanik gözlemleri birbirinden ayırmak bu nedenle değerlidir.

Encoder kontrolünde yavaş ve hızlı hareketler ayrı denenir. Her fiziksel adımın sayıyla ilişkisi, yönün tutarlılığı ve sınırlara gelindiğinde davranış incelenir. Sonra dışarıdan parlaklık değiştirilerek sayacın yeni duruma nasıl geçtiği görülür. Bu ikinci deneme yapılmazsa panel yalnız kendi komutlarıyla kullanıldığında düzgün görünür, telefondan yapılan değişikliklerden sonra ise beklenmedik sıçramalar gösterebilir. Akıllı ev arayüzü birden fazla kumandanın aynı hedefe dokunabildiği bir ortamda çalışır.

Ekran kontrolünde sadece yazının görünmesi yeterli değildir. Uzun sahne adı, bağlantı kopması, bilinmeyen ışık durumu ve servis modu gibi farklı içerikler okunabilir olmalıdır. Küçük OLED'de her bilgiyi aynı anda göstermek yerine öncelik sırası oluşturulabilir. Normal durumda ışık ve değer, hata durumunda bağlantı veya hedef bilgisi öne çıkar. Birbiri üstüne binen kısa metinler, daha fazla bilgi gösterdiği halde daha az anlaşılır bir arayüz oluşturabilir.

Son aşamada panel gerçek masa yerine konur ve kabloyla birlikte kullanılır. Tuş basarken kayma, encoder çevrilirken devrilme eğilimi, USB başlığının duvara dayanması ve ekranın oturma açısından okunması burada görünür olur. Bunlar yazılım kayıtlarında bulunmayan sorunlardır. Gövdeye ağırlık eklemek, ayak düzenini değiştirmek veya kablo yönünü yeniden tasarlamak gibi çözümler ancak gözlenen sorunla ilişkilendirildiğinde anlamlıdır. Her kutuya aynı ağırlık veya aynı taban malzemesi eklemek gerekmez.

Örnek tasarım: tek masada çalışma, görüşme ve akşam ışığı

Varsayımsal bir kullanıcı için üç temel sahne ve ayrı kapatma tuşu düşünelim. Kullanıcı gündüz çalışırken masa lambasını, görüşme sırasında yüzünü aydınlatan ışığı, akşam ise daha yumuşak arka planı tercih ediyor. Beşinci tuş genel oda ışığını, altıncı tuş da sık kullandığı başka bir sahneyi çağırabilir. Bu düzeni seçmeden önce aynı işi yapan iki tuş bulunup bulunmadığına bakılır. Gereksiz tekrar varsa altı tuşun hepsini doldurmak zorunlu değildir.

Bu örnekte encoder yalnız seçili aydınlatmanın parlaklığını değiştirir. Hangi hedefin seçili olduğu ekranda açıkça görünür; kullanıcı sahne değiştirince encoder'ın etkilediği varlık da tanımlı biçimde değişir. Böyle bir düzen kaynak projeden daha fazla durum gerektirebilir. Bu nedenle ilk sürümde encoder'ı bütün ışıkları kapsayan sabit bir gruba bağlamak daha sade bulunabilir. Karar, kullanıcının ince ayarı ne kadar sık yaptığına göre verilir; teknik olarak mümkün olan her seçenek ilk sürüme alınmaz.

Tuş simgeleri de bu davranışı destekler. Çalışma için sade bir masa veya kitap işareti, görüşme için özgün bir kamera simgesi, kapatma için anlaşılır bir güç işareti kullanılabilir. Renkler yardımcı olur fakat tek ayırt edici özellik olmamalıdır. Loş ortamda veya renkleri farklı algılayan kullanıcıda şekil ve yerleşim de anlam taşır. Başka bir kurgu evreninin amblemini kullanmak yerine özgün ve kullanım hakkı açık simgeler seçmek, panelin paylaşılabilir tasarım dosyalarını da sadeleştirir.

Kaynak fotoğraflarında farklı renk ve simge sürümleri görülüyor. Bunlar aynı mekanik fikrin görsel olarak çeşitlenebildiğini gösterir; fotoğraftaki üçüncü taraf amblem veya karakterler için model dağıtım hakkı verdiği anlamına gelmez. İndirilecek model, yazı tipi ve simgenin kendi lisansı ayrıca korunmalıdır. Özellikle bir projeyi satılabilir ürün haline getirmek amaçlanıyorsa, kaynak blog görselini kullanma izni ile içerdiği bütün tasarım dosyalarını yeniden dağıtma hakkı birbirine karıştırılmaz.

Donanım değişmeden yeni işlev eklenirken sorulacak sorular

Macropadın güçlü yanlarından biri, aynı tuşların zaman içinde başka bir işleve atanabilmesidir. Ancak yazılımdaki bir isim değişikliği fiziksel arayüzde görünmezse kullanıcı eski anlamı hatırlamaya devam eder. Örneğin daha önce genel ışığı kapatan tuş yeni sürümde yalnız masa lambasını kapatıyorsa, üzerindeki işaret aynı kaldığı halde sonuç değişmiştir. Böyle bir değişiklikte tuş simgesi, ekran metni ve gerçek hedef birlikte gözden geçirilir. Kolay yeniden programlanabilirlik, davranışın sessizce değişmesi gerektiği anlamına gelmez.

Yeni işlev eklerken önce mevcut düzenin hangi varsayımını değiştirdiği bulunur. Tek ışık grubunu kontrol eden panelde encoder her zaman aynı hedefe yazıyordur. İki oda arasında seçim eklemek artık seçili oda bilgisini de gerektirir. Kullanıcı odayı değiştirdikten sonra encoder'ın önceki odanın değerini yeni odaya göndermemesi gerekir. Böylece küçük görünen bir menü eklentisinin aslında başlangıç, eşitleme ve ekran mantığını etkilediği anlaşılır. Kutu aynı kalsa da yazılımın düşünülmesi gereken durumları çoğalır.

Sahne sayısını artırmak için bir üst mod tuşu kullanıldığında da benzer bir sorun oluşur. Üst sıradaki tuşlar bir modda renk, başka modda oda seçerse, dokunsal hafıza tek başına yeterli olmaz. Ekranın hangi modun etkin olduğunu sürekli göstermesi veya fiziksel yerleşimde modun ayrı bir işareti olması düşünülebilir. Eğer ekranı okumak için eğilmek gerekiyorsa bu çözüm pratikte zayıflar. Çok işlevli panel planı ile ekranın boyutu ve yerleşimi bu nedenle bağımsız kararlar değildir.

Donanım değişimi ise farklı bir yeniden değerlendirme gerektirir. Encoder yerine başka bir modül takmak yalnız aynı üç bağlantının bulunmasına bakılarak yapılmaz. Mil yüksekliği, sabitleme şekli, elektriksel davranış ve adım hissi değişebilir. Ekran değiştirildiğinde de dış çerçeve aynı görünse bile aktif görüntü alanı veya kartın dışarı taşan kısmı farklı olabilir. Kaynak kutuya sığan ilk bileşeni esas alıp bütün benzer ürünlere uyumlu ilan etmek, kullanıcıyı gereksiz uyarlamaya zorlayabilir.

Bir tasarımın paylaşılabilir olması için hangi parçaların değiştirilebilir kabul edildiği açıkça belirtilmelidir. Üst kapağı sabit tutup yalnız keycap simgelerini değiştirmek küçük bir varyanttır. Farklı kart için yeni iç destek tasarlamak ise başka bir mekanik varyanttır. Bu ikisini aynı dosyanın rastgele değişmiş sürümleri olarak saklamak, hangi kapağın hangi alt gövdeyle eşleştiğini belirsizleştirir. Parça adlarında işlevi ve uyum ilişkisini anlaşılır biçimde tutmak, sonraki kullanıcıların yanlış kombinasyonu basmasını önlemeye yardımcı olur.

Yazı tipleri küçük OLED'de ayrıca sınanmalıdır. Bilgisayarda düzgün görünen bir Türkçe sahne adı, seçilen font dosyasında gerekli karakterler bulunmadığında eksik görünebilir. “Çalışma” ve “Görüşme” gibi adları gerçek ekranda değerlendirmek, yalnız kısa İngilizce örneklerle kontrol yapmaktan daha açıklayıcıdır. Harfleri kısaltmak gerekiyorsa kısaltmanın anlamı korunur; iki farklı sahne aynı görünen etikete dönüşmemelidir. Lisansı izin veren fontun dosyası ve gerekli lisans metni de tasarım paketinin parçası olarak ele alınır.

Ekran yerleşiminde metnin değişen uzunluğu hesaba katılır. “Akşam” ile “Genel aydınlatma” aynı genişlikte değildir. Birinci satırı sahne adına, ikinci satırı hedefe ayırmak yeterli gelmiyorsa hangi bilginin öncelikli olduğuna karar verilir. Her metni giderek küçültmek okunabilirliği azaltabilir. Bunun yerine kısa ve açık isimler, sabit yerleşimli bir değer alanı ve gerektiğinde ayrı hata ekranı düşünülebilir. Kullanıcı arayüzü, elektronik modülün kaç piksel sunduğunu mümkün olduğunca çok kelimeyle doldurma yarışına dönüştürülmez.

Son olarak, paneli çoğaltmak isteyen biri tek prototipteki el ayarlarını görünür hale getirmelidir. Örneğin bir kapağın içindeki yerel zımparalama, bir kablonun belirli yönde katlanması veya simgenin özel bir baskı yönü gerektirmesi dosyada belli olmayabilir. Tek nesneyi kullanmak için bu ayrıntılar hatırlanabilir; ikinci nesnede ise yeniden keşfedilmeleri zaman kaybettirir. Gerekli geometri düzeltmesini modele taşımak ve parça yerleşimini anlaşılır kılmak, aynı macropadın başka masalarda da üretilebilmesini kolaylaştırır. Bu aşamada amaç seri üretim uygunluğu ilan etmek değil, tasarımın hangi ayrıntılara dayandığını açıklaştırmaktır.

Bu tasarımın değerlendirilmesi için somut bir kullanım turu oluşturulabilir. Kullanıcı önce çalışma sahnesini seçer, encoder ile ışığı azaltır ve sonra aynı ışığı telefondan değiştirir. Panelin gösterdiği değer telefondaki değişimi izlemelidir. Ardından panel yeniden başlatılır; kullanıcı dokunmadan bir sahne komutu oluşup oluşmadığı gözlenir. Son olarak hedef lamba erişilemez hale getirildiğinde ekranın eski yüzdeyi kesin bilgi gibi sunup sunmadığına bakılır. Bu tur, yalnız bütün tuşlara bir kez basmaktan farklıdır; birden fazla kumandanın ve bağlantı geçişinin birlikte oluşturduğu davranışı ortaya çıkarır.

Turun ardından sorunların aynı listede karıştırılmaması yararlıdır. Tuşun zor basılması mekanik bir sonuçtur; sahnenin yanlış hedefe gitmesi eşleştirme sorunudur; ekranda eski isim kalması durum yönetimiyle ilgilidir. Her biri ayrı bir tasarım değişikliği gerektirir. Böylece gövdeyi yeniden basmanın yazılım hatasını çözmesi beklenmez, yazılım filtresiyle sıkışmış keycap gizlenmez. Bir sonraki sürümde yalnız değiştirilen davranış yeniden incelenirken, komşu işlevlerin etkilenip etkilenmediği de kısa bir kullanım turuyla görülebilir. Bu yaklaşım, küçük bir kişisel projede bile değişikliklerin neden yapıldığını anlaşılır tutar.

Sorunun hangi katmanda olduğunu bulmak

Panel hiç açılmıyorsa önce besleme ve USB bağlantısı değerlendirilir; ışığın tepki vermemesi tek başına panelin açılmadığını göstermez. Ekran çalışıyor fakat tuşlar görünmüyorsa giriş eşleşmesi ve yapılandırma incelenir. Tuş olayları Home Assistant'a ulaşıyor ama ışık değişmiyorsa hedef varlık, otomasyon koşulu ve eylem mantığına geçilir. Işık değişiyor fakat ekrandaki ad yanlışsa sorun büyük olasılıkla gösterilen durumun nasıl üretildiğindedir. Bu sıra aynı belirtiye her seferinde gövdeyi açarak yaklaşmayı önler.

Yalnız yeniden başlatma sırasında ortaya çıkan hata, çalışma anındaki hatadan ayrı ele alınmalıdır. Tuşa basılıyken açılma, ağın henüz hazır olmaması veya ilk durum bilgisinin gelmemesi farklı nedenlerdir. Kaynak kartta bazı pinlerin açılış rolü bulunması bu ayrımı özellikle önemli kılar. Normal çalışırken bütün tuşların doğru görünmesi, açılış davranışının da tamamlandığı anlamına gelmez. Tasarımın gerçek kullanımında enerji kesintisi ve yeniden bağlantı olağan durumlar olarak düşünülmelidir.

Arada bir atlayan encoder değeri ise hemen ağ sorununa bağlanmamalıdır. Önce yerel sayacın doğru hareket edip etmediği görülür. Yerel değer tutarlı, ışık gecikmeli ise iletişim ve otomasyon akışına bakılır. Yerel değer de düzensizse modül, bağlantı, çözünürlük ve giriş işleme tarafı araştırılır. Ekranda gösterilen sayı ile hedef lambanın gerçek parlaklığını ayrı izlemek bu teşhisin temelidir. Bir tek yüzde göstergesinden bütün sistemin hangi bölümünün hata yaptığı çıkarılamaz.

Başarılı bir macropad, her özelliği küçük bir kutuya sığdıran tasarım değildir. Günlük birkaç işi rahatça yapan, yanlış durumda dürüst geri bildirim veren ve bileşenlerine ulaşılabilen bir arayüzdür. 3D baskının katkısı da tam burada ortaya çıkar: USB çıkışı, tuş yerleşimi, ekran açısı ve işaretler belirli kullanıcının masasına göre değiştirilebilir. Kaynak projenin parçalarını anlamak, onları aynı biçimde çoğaltmaktan daha fazla seçenek sunar; yazılımın durum mantığı ile fiziksel düzen birlikte geliştirildiğinde bu seçenekler kullanılabilir bir nesneye dönüşür.