Also in English
can.sys

Yazılaraçık kaynak

Kendim için yazdığım bir aracı herkese açmak

Barda'yı bir havyayı bulabilmek için yazdım. MIT lisansıyla yayımlamadan önce, onu benden başka birinin de kurabileceği hâle getirmem gerekti.

tarih
süre
3 dk okuma
kaynaklar
3
yazar
Ali CAN
  • açık kaynak
  • Barda
  • Bluetooth
  • MCP

Barda çok somut bir sinir bozukluğundan doğdu. Elektronik ve alet malzemem çantalarda ve kasalarda duruyor, hepsi birlikte yüz kadar küçük şey. Her projeden önce bir ESP32 kartını ya da bir makara lehim telini aramakla çeyrek saat kaybediyordum.

Ahşap bir çalışma tezgâhında açık bir çanta: Raspberry Pi için bir CAN kartı, bir OBD-II kablosu, GPS modülleri, bir devre tahtası ve bir kutu direnç, çevresinde bileşen poşetleri.
Fig. 1Gerçek bir örnek: CAN veri yolu üzerine bir projenin malzemesi, bir çanta ile poşetler arasında. Raspberry Pi için CAN kartı, OBD-II kablosu, GPS modülleri, devre tahtası, dirençler.

Model üç kavrama sığıyor: nesneler, lotlar (çanta, kasa, çekmece) ve projeler. Her nesnenin ve her lotun, küçük bir termal etiket yazıcısında, bir Fichero D11s'te Bluetooth ile basılmış bir QR etiketi var. Bir projenin kartı, yola çıkmadan önceki tek işe yarar soruyu yanıtlıyor: yanıma hangi lotları alıyorum.[1]

Eylülden beri Barda evde, benim için çalışıyordu. Onu yayımlamak istediğim gün, kişisel bir aracın nelere hiç aldırmadan yaşayabildiğini fark ettim.

Yazıcı her yerdeydi#

İlk sürüm tek bir yazıcı tanıyordu ve özellikleri kodun dört bir yanına yazılmıştı. Evde sorun değil: zaten bir tane yazıcım var. Başka biri içinse bu bir duvar.

Bu yüzden yazıcıyı koddan çıkarıp bir kayıt defterine dönüştürdüm. Bir model tek bir yerde tanımlanıyor: çözünürlüğü (D11s için 203 dpi), baskı kafasının genişliği, etiket boyutları ve desteklediği bağlantı yolları. Çizim kendiliğinden uyum sağlıyor. Bir Niimbot ya da Phomemo eklemek için web tarafında bir sürücü, iPhone tarafında bir Swift sınıfı yazmak yetiyor; geri kalanına dokunmak gerekmiyor.

Mimariyi zaten Bluetooth belirlemişti. Safari, iPhone'da da Mac'te de web sayfalarına Bluetooth erişimi vermiyor. iPhone uygulaması yalnızca bu yüzden var: siteyi gösteriyor ve ona bir CoreBluetooth sürücüsü sağlıyor.[2] Etiket tamamen web tarafında çiziliyor; Swift önceden kodlanmış bir görüntüyü alıyor, parçalara bölüyor ve gönderiyor. D11s'in protokolünü tek başıma çözmedim: o da MIT lisansıyla yayımlanan fichero-printer projesinden geliyor.[3]

On iki milimetre yükseklik#

Hiç düşünmeden yeniden vereceğim bir karar: QR kod bir web adresi değil, yalnızca nesnenin altı karakterlik kısa kodunu taşıyor, IR7MCX gibi. 12 mm'lik bir etikette bir adres 25 × 25 modüllük bir ızgara gerektiriyor. Kod tek başına 21 × 21'e sığıyor; modüller %32 daha büyük, hata düzeltme oranı da %7'den %25'e çıkıyor. Katlanmış ya da lekelenmiş bir etiketin hâlâ okunabilmesini sağlayan şey bu. Kod alfabesinde I, L, O ve U da yok, çünkü bu boyutta kolayca karıştırılıyorlar.

Bozulamayan bir demo#

Barda'yı kimseden kurmasını istemeden gösterebilmek için bir demo modu ekledim. Uygulamayı şifresiz, ilk açılışta oluşturulan hayali bir envanter üzerinde açıyor. Asıl soru, kilidin nereye konacağıydı. Düğmeleri devre dışı bırakmak yetmiyor, çünkü bir form düğme olmadan da rahatça yeniden gönderilebilir. Bu yüzden ret, istek koda ulaşmadan önce middleware'de gerçekleşiyor: form, sunucu eylemi ya da dosya yükleme, her yazma işlemi orada reddediliyor ve MCP sunucusu kapalı.

Bu mod showcase-barda.can-ali.fr adresinde çevrimiçi çalışıyor; proje sayfasındaki ekran görüntüleri de bu moddan alındı.

Yapay zekânın yapamadığı şey#

Barda'nın, Claude envantere bakıp eşyaları yerleştirebilsin diye bir MCP sunucusu var. On beş araç sunuyor ve hiçbiri bir şey silmiyor. Bir model kodu karıştırabilir, silinmiş bir nesne de geri gelmez. Yazma işlemleri, formlarla birebir aynı koddan geçiyor.

Yayın için, kendi sunucuma özgü dağıtım betiği kaldırıldı. iPhone uygulaması artık geliştirici ekibini, uygulama kimliğini ve sunucu adresini git'in yok saydığı yerel bir dosyadan okuyor. Depoya bir MIT lisansı, bir Docker Compose dosyası ve kurulumu, yazıcıları ve her ortam değişkenini anlatan bir README eklendi.

Kod GitHub'da, iki depoda: web uygulaması için Lyniiiix/barda, iPhone için Lyniiiix/barda-ios. Başka bir Bluetooth etiket yazıcınız varsa, kayıt defteri onu karşılamaya hazır.

SOURCES

  1. [1]Barda: web uygulaması, GitHub, MIT lisansıgithub.com
  2. [2]barda-ios: iPhone kabuğu ve CoreBluetooth sürücüsü, GitHub, MIT lisansıgithub.com
  3. [3]fichero-printer: Fichero D11s'in Bluetooth protokolü, 0xmh, MIT lisansıgithub.com