MacroStick Dokümantasyonu

core_payload Endpoint'i

Mon, 01 Jan 0001 00:00:00 +0000

core_payload, MacroStick’e doğrudan HID komut paketleri göndermek için kullanılan açık geliştirici endpoint’idir.

Bu endpoint, kendi uygulamanızdan MacroStick’i tetiklemek istediğiniz durumlarda kullanılır. Örneğin test otomasyonu, özel kontrol panelleri, kiosk sistemleri veya oyun/medya kontrol entegrasyonları için uygundur.

Endpoint

Alan	Değer
Method	`POST`
URL	`http://192.168.7.1/api/core_payload`
Content-Type	`application/json`
Kimlik doğrulama	HTTP Basic Auth

Sessiz modda cihazın MacroStick Wi-Fi ağına bağlandıktan sonra aynı URL kullanılır.

İstek Gövdesi

İstek gövdesi tek bir payload alanı içerir:

Erişim

Mon, 01 Jan 0001 00:00:00 +0000

Web arayüzüne USB bağlantısı üzerinden tarayıcıyla erişilir. Sessiz modda aynı arayüz Wi-Fi üzerinden kullanılabilir.

Erişim Yöntemleri

Yöntem	Adres	Ne Zaman Kullanılır?
USB IP adresi	`http://192.168.7.1`	Standart ve en güvenilir erişim yöntemi
mDNS adı	`http://macrostick.local`	Sisteminiz mDNS destekliyorsa daha kolay adres
Sessiz mod Wi-Fi	`http://192.168.7.1`	Cihazın Wi-Fi ağına bağlandığınızda

USB Üzerinden Erişim

MacroStick’i USB portuna takın.
Bağlantının kurulması için 2-3 saniye bekleyin.
Tarayıcıda şu adresi açın:

 http://192.168.7.1

Desteklenen sistemlerde şu adres de çalışabilir:

Eşleştirme

Mon, 01 Jan 0001 00:00:00 +0000

Bluetooth eşleştirme için önce MacroStick tarafında Bluetooth LE özelliğini açın.

Eşleştirme Öncesi Kontrol

Bluetooth LE ayarı açık olmalıdır.
Hedef cihazda Bluetooth açık olmalıdır.
MacroStick hedef cihaza yakın olmalıdır.
Daha önce başarısız eşleştirme olduysa hedef cihazdaki eski kayıt kaldırılmalıdır.

Hazırlık

Web arayüzünde Ayarlar sayfasına gidin.
Bluetooth LE Kullan anahtarını açın.
Gerekirse HID öncelik modunu Sadece Bluetooth veya Bluetooth Öncelikli olarak ayarlayın.
Cihazı hedef cihaza yakın tutun.

Windows

Windows Bluetooth ayarlarını açın.
Bluetooth veya diğer cihaz ekle seçeneğini kullanın.
Listeden MacroStick cihazını seçin.
Eşleştirme tamamlanana kadar bekleyin.

macOS

Sistem Ayarları içinden Bluetooth bölümünü açın.
Listeden MacroStick cihazını seçin.
Bağlan veya Eşleştir seçeneğini kullanın.

Android

Bluetooth ayarlarını açın.
Yeni cihaz aramayı başlatın.
MacroStick cihazını seçin.
Eşleştirme isteğini onaylayın.

iOS ve iPadOS

Ayarlar > Bluetooth bölümünü açın.
MacroStick cihazını seçin.
Eşleştirme isteğini onaylayın.

Sorun Giderme

Sorun	Yapılacak İşlem
MacroStick listede görünmüyor	Bluetooth LE ayarının açık olduğunu kontrol edin
Eşleşme tamamlanmıyor	Hedef cihazda Bluetooth’u kapatıp açın ve tekrar deneyin
Bağlantı kurulmuyor	HID öncelik modunu Bluetooth kullanımına uygun seçin
Eski eşleşme sorun çıkarıyor	Hedef cihazdaki eski MacroStick kaydını kaldırıp yeniden eşleştirin

Eşleştirme Sonrası Test

Eşleştirme tamamlandıktan sonra güvenli bir metin alanı açın ve kısa bir makro çalıştırın:

Firmware Güncelleme

Mon, 01 Jan 0001 00:00:00 +0000

Firmware güncellemesi, MacroStick’in cihaz yazılımını yeni sürüme taşır.

Güncelleme işlemi dikkat gerektirir. Yanlış dosya kullanmayın ve işlem sırasında cihazın bağlantısını kesmeyin.

Ne Zaman Güncellenmeli?

Firmware güncellemesi şu durumlarda yapılır:

Yeni özellik yayınlandığında
Hata düzeltmesi sağlandığında
Performans veya uyumluluk iyileştirmesi önerildiğinde
Destek ekibi belirli bir sürüme geçmenizi istediğinde

Güncelleme dosyası .bin uzantılıdır.

Güncelleme Dosyasını Alma

Firmware dosyasını ürünün resmi destek kanallarından veya destek ekibinden edinin. Kaynağı doğrulanmamış firmware dosyalarını yüklemeyin.

Hızlı Başlangıç

Mon, 01 Jan 0001 00:00:00 +0000

Bu sayfa, MacroStick’i ilk kez çalıştırmak için gereken en kısa akışı gösterir.

Adımlar

MacroStick’i bilgisayarınızdaki boş bir USB portuna takın.
Bağlantının kurulması için 2-3 saniye bekleyin.
Tarayıcıda şu adresi açın:

 http://macrostick.local

veya

 http://192.168.7.1

Giriş ekranı geldiğinde kutudan çıkan karttaki kullanıcı adı ve şifreyi kullanın.
Sol menüden Makrolarım sayfasına gidin.
Makro Adı alanına kısa bir ad yazın ve script alanına şu örneği yapıştırın:

 BEKLE 500
YAZ Merhaba!
YAZ_VE Bu ilk makrom.

Kaydet düğmesine tıklayın.
Makro listesinde oluşturduğunuz makronun yanındaki Oynat düğmesine tıklayın.

Fiziksel Tuşlarla Kullanım

İlk makroyu test ettikten sonra Genel Bakış sayfasındaki Makro Oynatma Tuşları bölümünü kontrol edin.

Komutlar

Mon, 01 Jan 0001 00:00:00 +0000

MacroStick scriptleri satır satır okunur. Her satır bir komut, komut parametresi veya yorum olabilir.

Okuma Sırası

Komutlar yukarıdan aşağıya çalışır. Bir satır tamamlanmadan sonraki satıra geçilmez. Bu nedenle bekleme süreleri ve tuş bırakma komutları scriptin doğru çalışmasında önemlidir.

Temel Yapı

 KOMUT parametre

Örnek:

 BEKLE 500
YAZ Merhaba
YAZ_VE MacroStick

Yorum Satırları

# ile başlayan satırlar yorumdur ve çalıştırılmaz.

 # Uygulamanın açılmasını bekle
BEKLE 1000
YAZ Hazır

Türkçe ve İngilizce Komutlar

MacroStick aynı komutların Türkçe ve İngilizce adlarını destekler.

Kontrol Tuşları

Mon, 01 Jan 0001 00:00:00 +0000

MacroStick, bağlı fiziksel klavyedeki kilit tuşlarını ana makro kontrol yöntemi olarak kullanır.

Bu sayede web arayüzüne dönmeden makroyu oynatabilir, fiziksel kayıt başlatabilir veya makroyu döngüye alabilirsiniz.

Temel Mantık

Tuş	İşlev	Sonuç
Caps Lock	Yüklü makroyu oynatır	Seçili makro bir kez çalışır
Num Lock	Kaydı başlatır	Harici klavye/fare hareketleri kaydedilmeye başlar
Num Lock	Kaydı durdurur	Kayıt otomatik kaydedilir ve oynatmaya hazır olur
Scroll Lock	Yüklü makroyu döngüye alır	Makro tekrar tekrar çalışır

Kayıt Num Lock ile durdurulduğunda makro otomatik kaydedilir ve oynatmaya hazır hale gelir.

MacroStick Nedir?

Mon, 01 Jan 0001 00:00:00 +0000

MacroStick, tekrarlayan klavye, fare, gamepad ve medya kontrol işlemlerini otomatikleştiren bir USB donanım cihazıdır. Kullanıcılar bu işlemleri makro olarak kaydeder veya script şeklinde yazar, ardından web arayüzünden ya da fiziksel kısayollardan çalıştırır.

Cihaz kutudan çıktığı gibi çalışır. Sürücü, masaüstü uygulaması veya ek yazılım kurulumu gerekmez.

MacroStick Ne Değildir?

MacroStick bir masaüstü uygulaması veya bulut servisi değildir. Makrolar cihaz üzerinde saklanır ve cihaz hedef sisteme standart HID girdileri gönderir. Bu sayede hedef sistemde ek yazılım kurmadan çalışabilir.

Makro Nedir?

Mon, 01 Jan 0001 00:00:00 +0000

Makro, MacroStick’in sırayla çalıştırdığı adımlar listesidir. Bu adımlar klavye tuşları, metin yazma, fare hareketleri, tıklamalar ve bekleme süreleri olabilir.

Makro Ne İşe Yarar?

Makrolar, tekrarlanan giriş işlemlerini tek komutla çalıştırmanızı sağlar. Örneğin:

Sık kullanılan metinleri yazdırma
Klavye kısayollarını otomatik çalıştırma
Fare tıklaması ve kaydırma adımlarını tekrarlama
Bir uygulama açıldıktan sonra belirli tuş dizilerini gönderme

Makro Planlama

İyi çalışan makrolar genellikle açık bir hedefe ve yeterli bekleme sürelerine sahiptir. Makroyu yazmadan önce şu soruları yanıtlayın:

Nasıl Etkinleştirilir?

Mon, 01 Jan 0001 00:00:00 +0000

Sessiz mod, cihaz açılırken üst düğme basılı tutularak etkinleştirilir.

Ön Bilgi

Sessiz mod yalnızca açılış sırasında etkinleştirilir. Cihaz normal açıldıysa sessiz moda geçmek için yeniden başlatmanız gerekir.

Etkinleştirme

MacroStick’i USB portuna takmadan önce üst düğmeye basılı tutun.
Düğmeyi basılı tutarken cihazı USB portuna takın.
Sessiz modun aktif olduğunu gösteren durum görünene kadar bekleyin.
Cihaz MacroStick adlı Wi-Fi ağını oluşturur.

Aktif Olduğunda

Bilgi	Değer
Wi-Fi ağı	`MacroStick`
Şifre	`12345678`
Web arayüzü	`http://192.168.7.1`

USB HID normal şekilde çalışmaya devam eder.

BLE Kullanımı

Mon, 01 Jan 0001 00:00:00 +0000

Bluetooth eşleştirme tamamlandıktan sonra MacroStick hedef cihazda kablosuz klavye ve fare gibi kullanılabilir.

Kullanım Öncesi

Bluetooth üzerinden çıktı almak için yalnızca eşleştirme yeterli olmayabilir. HID öncelik modunun Bluetooth’u kullanacak şekilde ayarlanmış olması gerekir.

Bağlantı Davranışı

Bluetooth kullanımı için:

Hedef cihazda Bluetooth açık olmalıdır.
MacroStick açık olmalıdır.
Bluetooth LE ayarı açık olmalıdır.
HID öncelik modu Bluetooth kullanımına uygun olmalıdır.

Eşleştirme bilgisi cihazda saklanır. Daha önce eşleştirilen host cihaz uygun durumdaysa bağlantı otomatik kurulabilir.

Genel Bakış Sayfası

Mon, 01 Jan 0001 00:00:00 +0000

Genel Bakış, web arayüzüne giriş yaptıktan sonra açılan ana sayfadır. Cihazın mevcut durumunu gösterir ve sık kullanılan makro ayarlarına hızlı erişim sağlar.

Bu Sayfayı Ne İçin Kullanırsınız?

Cihazın mevcut durumunu hızlıca görmek
Varsayılan makroyu seçmek
Makro oynatma hızını değiştirmek
Fiziksel kontrol tuşlarını açmak veya kapatmak
Başlangıçta otomatik makro çalıştırmayı yönetmek

Durum Kartları

Sayfanın üst bölümünde özet bilgiler yer alır.

Kart	Açıklama
Makro Oynatma Hızı	Seçili oynatma hızını gösterir
Varsayılan Makro Adı	Cihazda varsayılan olarak seçili makroyu gösterir
Otomatik Tuş Bırakma	Makro sonunda basılı kalan tuşların bırakılıp bırakılmayacağını gösterir
Makro Belleği	Kullanılan makro depolama oranını gösterir
Güncel Sürüm	Yüklü firmware sürümünü gösterir

Makro Oynatma Tuşları

Bu bölüm, MacroStick’in günlük kullanımındaki en önemli kontrollerden biridir. Bağlı fiziksel klavyedeki kilit tuşlarını makro kontrol tuşu olarak kullanmanızı sağlar.

HID Ayarları

Mon, 01 Jan 0001 00:00:00 +0000

HID ayarları, MacroStick’in klavye ve fare girdilerini hangi bağlantı üzerinden göndereceğini belirler.

Bu ayar özellikle USB ve Bluetooth’u aynı cihazda veya farklı cihazlarda kullanırken önemlidir.

HID Öncelik Modları

Mod	Davranış
Sadece Aygıt	HID çıktısı yalnızca USB üzerinden gönderilir
Sadece Bluetooth	HID çıktısı yalnızca Bluetooth üzerinden gönderilir
Bluetooth Öncelikli	Bluetooth bağlıysa Bluetooth kullanılır; bağlı değilse USB kullanılır
Aygıt & Bluetooth	HID çıktısı USB ve Bluetooth üzerinden aynı anda gönderilir

Hangi Mod Seçilmeli?

Kullanım	Önerilen Mod
Cihaz USB ile bilgisayara takılı kullanılacaksa	Sadece Aygıt
Kablosuz klavye/fare gibi kullanılacaksa	Sadece Bluetooth
Bluetooth varsa kablosuz, yoksa USB kullanılacaksa	Bluetooth Öncelikli
Aynı girdinin iki bağlantıya da gönderilmesi gerekiyorsa	Aygıt & Bluetooth

Başlangıçta Oynat

Başlangıçta Oynat açık olduğunda MacroStick açılır açılmaz seçili varsayılan makroyu çalıştırır.

Kimlik Doğrulama

Mon, 01 Jan 0001 00:00:00 +0000

MacroStick API’sine yapılan istekler kimlik doğrulama gerektirir. Kimlik bilgisi eksik veya hatalı olan istekler 401 Unauthorized yanıtı alır; istek işlenmez.

Yöntem: HTTP Basic Authentication

MacroStick, endüstri standardı HTTP Basic Authentication kullanır. Her HTTP isteğinde Authorization başlığı aşağıdaki formatta gönderilmelidir:

 Authorization: Basic <base64(kullanıcıadı:şifre)>

Örnek format:

 KULLANICI_ADI:SIFRE → base64 → Authorization başlığı

Modern HTTP kütüphanelerinin büyük çoğunluğu bu işlemi otomatik yapar; base64 kodlamayı elle hesaplamanıza gerek kalmaz.

Klavye Komutları

Mon, 01 Jan 0001 00:00:00 +0000

Klavye komutları, hedef cihaza tuş basma ve metin yazma girdileri gönderir.

Komut Özeti

Komut	İngilizce	Kullanım
`BAS`	`PRESS`	Tuşa veya tuş kombinasyonuna basar
`BIRAK`	`RELEASE`	Basılı tuşları bırakır
`YAZ`	`STRING`	Metin yazar
`YAZ_VE`	`STRINGLN`	Metin yazar ve Enter’a basar
`CAPSLOCK_AC`	`ENSURE_CAPSLOCK_ON`	Caps Lock’u açık hale getirir
`CAPSLOCK_KAPAT`	`ENSURE_CAPSLOCK_OFF`	Caps Lock’u kapalı hale getirir

BAS (PRESS)

Bir tuşa veya tuş kombinasyonuna basar.

 BAS <tuş veya kombinasyon>

Örnekler:

Kurulum

Mon, 01 Jan 0001 00:00:00 +0000

MacroStick harici güç veya yazılım kurulumu gerektirmez. Cihazı kullanmak için host cihaza USB üzerinden bağlamanız yeterlidir.

Kutu İçeriği ve Hazırlık

Kuruluma başlamadan önce cihazın ve kutudan çıkan giriş bilgileri kartının yanınızda olduğundan emin olun. Web arayüzüne giriş için kullanıcı adı ve şifre bu kartta yer alır.

İlk kurulumda USB çoklayıcı yerine doğrudan bilgisayar USB portunu kullanmak bağlantı sorunlarını azaltır.

USB Portları

Port	Kullanım
Erkek USB-A	Bilgisayar, tablet, telefon, DVR veya USB HID kabul eden başka bir host cihaza bağlanır
Dişi USB-A	Fiziksel klavye veya fare bağlayarak makro kaydetmek için kullanılır

Bağlantı Adımları

MacroStick’i host cihazın USB portuna takın.
Cihazın açılması ve bağlantının kurulması için 2-3 saniye bekleyin.
Tarayıcıdan http://macrostick.local veya http://192.168.7.1 adresini açın.

USB OTG adaptörü gerektiren telefon veya tabletlerde uygun adaptör kullanılmalıdır.

Wi-Fi Bağlantısı

Mon, 01 Jan 0001 00:00:00 +0000

Sessiz mod açıkken MacroStick kendi Wi-Fi ağını oluşturur.

Bu bağlantı cihaz yönetimi içindir. Bağlandığınız cihaz internet erişimi olmadığını bildirebilir; bu normaldir.

Ağ Bilgileri

Bilgi	Değer
Ağ adı	`MacroStick`
Şifre	`12345678`
Web arayüzü	`http://192.168.7.1`

Eğer yönetici şifrenizi daha önce değiştirdiyseniz WiFi erişim noktası şifreniz bu şifre ile aynıdır.

Bağlanma Adımları

Cihazı sessiz modda açın.
Bilgisayar, tablet veya telefonunuzda Wi-Fi ayarlarını açın.
MacroStick ağını seçin.
Şifre olarak 12345678 girin.
Bağlandıktan sonra tarayıcıda http://192.168.7.1 adresini açın.
Kutudaki kartta yazan kullanıcı adı ve şifreyle giriş yapın.

Sorun Giderme

Sorun	Yapılacak İşlem
Ağ görünmüyor	Cihazı yeniden başlatıp sessiz modu tekrar etkinleştirin
Şifre kabul edilmiyor	`12345678` değerini doğru girdiğinizi kontrol edin
Web arayüzü açılmıyor	Cihazınızın `MacroStick` Wi-Fi ağına bağlı olduğundan emin olun
İnternet bağlantısı uyarısı çıkıyor	Bu ağ web arayüzü içindir; internet bağlantısı sağlaması beklenmez

Kullanım Sonrası

İşiniz bittiğinde cihazı normal modda kullanmak için yeniden başlatın ve açılış sırasında üst düğmeye basmayın. Böylece Wi-Fi erişim noktası açılmadan normal kullanım devam eder.

Yeni Makro Oluşturma

Mon, 01 Jan 0001 00:00:00 +0000

Web arayüzündeki script editörüyle yeni makro oluşturabilirsiniz.

Adımlar

Web arayüzünde Makrolarım sayfasına gidin.
Makro Adı alanına kısa ve anlaşılır bir ad yazın.
Script editörüne makro komutlarını girin.
Gerekirse Test Et düğmesiyle scripti kontrol edin.
Kaydet düğmesine tıklayın.

Makro kaydedildikten sonra dosya yöneticisi tablosunda görünür.

Örnek Script

 BEKLE 500
YAZ Merhaba!
YAZ_VE Bu satır Enter ile biter.
BAS CTRL+C
BIRAK

Yazım Kuralları

Her komutu ayrı satıra yazın.
Yorum satırları # ile başlar.
Türkçe veya İngilizce komut adlarını kullanabilirsiniz.
YAZ ve YAZ_VE komutları Türkçe karakterleri destekler.
Tuş kombinasyonlarından sonra BIRAK kullanın.
Uygulama geçişleri, menü açılışları ve sayfa yüklemeleri için BEKLE ekleyin.

Örnek yorum:

Çevre Birimi Ayarları

Mon, 01 Jan 0001 00:00:00 +0000

Çevre birimi ayarları, MacroStick’in kablosuz bağlantılarını ve cihaz üzerindeki görsel göstergelerini yönetir.

Bu ayarlar bağlantı deneyimini etkileyebilir. Değişikliklerden sonra cihazı yeniden başlatmanız gerekebilir.

Bluetooth LE Kullan

Bluetooth LE açıkken MacroStick, BLE HID cihazı olarak kablosuz klavye ve fare işlevi sunabilir.

Bluetooth kullanmak için:

Bluetooth LE ayarını açın.
Hedef cihazda Bluetooth ayarlarına gidin.
MacroStick cihazını eşleştirin.
HID öncelik modunun Bluetooth kullanımına uygun olduğundan emin olun.

Wi-Fi AP Kullan

Wi-Fi AP açıkken cihaz MacroStick adlı kablosuz ağ oluşturur.

Fare Komutları

Mon, 01 Jan 0001 00:00:00 +0000

Fare komutları hedef cihaza fare hareketi, tıklama ve kaydırma girdileri gönderir.

Komut Özeti

Komut	İngilizce	Kullanım
`FARE_HAREKET`	`MOUSE_MOVE`	Fareyi mevcut konuma göre hareket ettirir
`FARE_TIKLA`	`MOUSE_CLICK`	Sol, sağ veya orta tıklama yapar
`FARE_KAYDIR`	`MOUSE_SCROLL`	Dikey kaydırma yapar

FARE_HAREKET (MOUSE_MOVE)

Fare imlecini mevcut konumuna göre hareket ettirir.

 FARE_HAREKET <x> <y>

Parametre	Açıklama
`x`	Yatay hareket. Pozitif değer sağa, negatif değer sola hareket ettirir
`y`	Dikey hareket. Pozitif değer aşağı, negatif değer yukarı hareket ettirir

Örnekler:

Fiziksel Kayıt

Mon, 01 Jan 0001 00:00:00 +0000

Fiziksel kayıt, klavye veya fareyle yaptığınız işlemleri makro olarak kaydetmenizi sağlar. Kayıt işlemi bağlı klavyedeki Num Lock kontrol tuşuyla başlatılır ve durdurulur.

Hazırlık

Klavye veya farenizi MacroStick’in dişi USB-A portuna bağlayın.
Web arayüzünde Genel Bakış sayfasına gidin.
Numlock İle Kaydı Başlat anahtarının açık olduğundan emin olun.
Kayıt alacağınız hedef uygulamayı hazır hale getirin.

Ne Zaman Fiziksel Kayıt Kullanılır?

Fiziksel kayıt, özellikle adımları elle yazmanın zor olduğu durumlarda yararlıdır:

İlk Bağlantı

Mon, 01 Jan 0001 00:00:00 +0000

Web arayüzü, MacroStick’i yapılandırmak ve makroları yönetmek için kullanılan ana yönetim panelidir.

Ön Koşullar

MacroStick USB üzerinden bağlı olmalıdır.
Tarayıcı cihazın sunduğu yerel adrese erişebilmelidir.
Kutudan çıkan giriş bilgileri kartı hazır olmalıdır.

Giriş Yapma

MacroStick’i USB portuna takın.
2-3 saniye bekleyin.
Tarayıcıda şu adresi açın:

 http://macrostick.local

veya

 http://192.168.7.1

Kutudan çıkan karttaki kullanıcı adı ve şifreyi girin.
Giriş düğmesine tıklayın.

Desteklenen sistemlerde http://macrostick.local adresi de kullanılabilir.

Makrolarım Sayfası

Mon, 01 Jan 0001 00:00:00 +0000

Makrolarım sayfası, cihazdaki makroları oluşturmak ve yönetmek için kullanılır.

Sayfa Yapısı

Bu sayfa iki ana bölümden oluşur:

Yeni Makro Oluştur: Script yazarak veya dosya seçerek yeni makro oluşturma alanı.
Dosya Yöneticisi: Kayıtlı makroları listeleme, adlandırma, oynatma, döngüye alma ve silme alanı.

Yeni Makro Oluşturma

Makro Adı alanına en fazla 63 karakterlik bir ad yazın.
Script editörüne makro komutlarını girin.
Gerekirse Test Et düğmesiyle scripti kontrol edin.
Kaydet düğmesine tıklayın.

Örnek:

Paket Üretimi

Mon, 01 Jan 0001 00:00:00 +0000

MacroStick’e core_payload endpoint’i üzerinden gönderilen her komut tam olarak 16 byte’lık sabit uzunlukta bir pakettir. Bu sayfa komut yapısını, doğrulama değerinin nasıl hesaplandığını ve yaygın komut türleri için hazır örnekleri kapsar.

Temel Yardımcı Sınıf

Aşağıdaki sınıfı doğrudan projelerinizde kullanabilirsiniz. Sayfanın geri kalanındaki tüm örnekler bu sınıf üzerine kuruludur.

 import struct
import requests


class MacroStick:
 """MacroStick HTTP API istemcisi."""

 SYNC = 0xA5
 KEYBOARD = 0x02
 MOUSE = 0x03
 GAMEPAD = 0x04
 CONSUMER = 0x05
 SYSTEM_CONTROL = 0x06

 FLAG_DISABLE_AUTO_RELEASE = 0x01

 def __init__(self, host: str = "192.168.7.1", username: str = "", password: str = ""):
 self.base_url = f"http://{host}/api/core_payload"
 self.auth = (username, password)
 self._queue: list[bytes] = []

 # ------------------------------------------------------------------ #
 # Paket oluşturma #
 # ------------------------------------------------------------------ #

 @staticmethod
 def _crc8(data: bytes) -> int:
 crc = 0x00
 for byte in data:
 crc ^= byte
 for _ in range(8):
 crc = ((crc << 1) ^ 0x07) & 0xFF if crc & 0x80 else (crc << 1) & 0xFF
 return crc

 @classmethod
 def _build(cls, type_byte: int, command_data: bytes, flags: int = 0x00) -> bytes:
 assert len(command_data) == 12
 crc_input = bytes([cls.SYNC, type_byte]) + command_data + bytes([flags])
 checksum = cls._crc8(crc_input)
 return bytes([cls.SYNC, type_byte]) + command_data + bytes([checksum, flags])

 # ------------------------------------------------------------------ #
 # Toplu gönderim #
 # ------------------------------------------------------------------ #

 def send(self, *packets: bytes) -> int:
 """
 1–10 paket alır, tek HTTP isteğiyle gönderir.
 Dönüş değeri: HTTP durum kodu.
 """
 assert 1 <= len(packets) <= 10
 payload = b"".join(packets).hex()
 resp = requests.post(self.base_url, auth=self.auth, json={"payload": payload})
 return resp.status_code

 def queue(self, *packets: bytes):
 """Paketi kuyruğa ekle; flush() ile toplu gönder."""
 self._queue.extend(packets)

 def flush(self) -> list[int]:
 """Kuyruktaki tüm paketleri 10'arlı gruplar halinde gönderir."""
 codes = []
 while self._queue:
 batch = self._queue[:10]
 self._queue = self._queue[10:]
 codes.append(self.send(*batch))
 return codes

 # ------------------------------------------------------------------ #
 # Klavye #
 # ------------------------------------------------------------------ #

 @classmethod
 def key_press(cls, keycode: int, modifier: int = 0x00, flags: int = 0x00) -> bytes:
 data = bytes([modifier, 0x00, keycode, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00])
 return cls._build(cls.KEYBOARD, data, flags)

 @classmethod
 def key_combo(cls, keycodes: list[int], modifier: int = 0x00, flags: int = 0x00) -> bytes:
 """En fazla 6 tuşu aynı anda basılı tut."""
 assert len(keycodes) <= 6
 padded = (keycodes + [0x00] * 6)[:6]
 data = bytes([modifier, 0x00] + padded + [0x00, 0x00, 0x00, 0x00])
 return cls._build(cls.KEYBOARD, data, flags)

 @classmethod
 def key_release(cls) -> bytes:
 return cls._build(cls.KEYBOARD, bytes(12))

 # ------------------------------------------------------------------ #
 # Fare #
 # ------------------------------------------------------------------ #

 @classmethod
 def mouse_move(cls, x: int, y: int) -> bytes:
 data = struct.pack("bbbbb7x", 0, x, y, 0, 0)
 return cls._build(cls.MOUSE, data)

 @classmethod
 def mouse_button(cls, buttons: int) -> bytes:
 data = bytes([buttons]) + bytes(11)
 return cls._build(cls.MOUSE, data)

 @classmethod
 def mouse_scroll(cls, wheel: int, pan: int = 0) -> bytes:
 data = struct.pack("bbbbb7x", 0, 0, 0, wheel, pan)
 return cls._build(cls.MOUSE, data)

 # ------------------------------------------------------------------ #
 # Consumer #
 # ------------------------------------------------------------------ #

 @classmethod
 def consumer_key(cls, usage: int) -> bytes:
 data = struct.pack("<H10x", usage)
 return cls._build(cls.CONSUMER, data)

 # ------------------------------------------------------------------ #
 # Gamepad #
 # ------------------------------------------------------------------ #

 @classmethod
 def gamepad(cls, x=0, y=0, z=0, rx=0, ry=0, rz=0, hat=0, buttons=0) -> bytes:
 btn_bytes = struct.pack("<I", buttons) # 4 byte, little-endian
 data = struct.pack("bbbbbbb", x, y, z, rx, ry, rz, hat) + btn_bytes + b"\x00"
 return cls._build(cls.GAMEPAD, data)

 # ------------------------------------------------------------------ #
 # System Control #
 # ------------------------------------------------------------------ #

 @classmethod
 def system_control(cls, usage: int) -> bytes:
 data = bytes([usage]) + bytes(11)
 return cls._build(cls.SYSTEM_CONTROL, data)

Paket Yapısı

Her komut tam olarak 16 byte’tır; daha kısa veya uzun paketler geçersiz sayılır. Endpoint’e gönderirken bu 16 byte’lık paket hex string olarak yazılır; bu nedenle tek paket 32 hex karakterdir.

Bildirimler Sayfası

Mon, 01 Jan 0001 00:00:00 +0000

Bildirimler sayfası, cihaz olaylarını takip etmek ve kayıt tutma davranışını yönetmek için kullanılır. Bu sayfa özellikle sorun giderme, test ve destek süreçlerinde yararlıdır.

Sayfa Yapısı

Bildirimler sayfasında iki ana bölüm bulunur:

Bölüm	Ne İşe Yarar?
Bildirim/Log Ayarları	Kayıt tutmayı açar veya kapatır
Kayıtlar	Cihazın kaydettiği olayları listeler

Kayıt Tutmayı Etkinleştir

Kayıt Tutmayı Etkinleştir anahtarı açıkken cihaz olayları kayıt listesine yazılır.

Bu özellik sürekli açık bırakılmak zorunda değildir. Normal günlük kullanımda kapalı tutulabilir; sorun giderme veya test sırasında açılması daha uygundur.

Diğer Komutlar

Mon, 01 Jan 0001 00:00:00 +0000

Bu komutlar MacroStick üzerindeki LED ve OLED ekran durumunu script içinden kontrol eder.

Kullanım Amacı

LED ve ekran komutları, makro çalışırken cihazın görünür durumunu yönetmek için kullanılabilir. Örneğin uzun bir makro başlarken LED’i açabilir, işlem sonunda kapatabilirsiniz.

LED_KULLAN (ENSURE_LED_ON)

Cihaz LED’ini açık hale getirir.

 LED_KULLAN

LED_KULLANMA (ENSURE_LED_OFF)

Cihaz LED’ini kapalı hale getirir.

 LED_KULLANMA

EKRAN_KULLAN (ENSURE_DISPLAY_ON)

Yerleşik ekranı açık hale getirir.

 EKRAN_KULLAN

EKRAN_KULLANMA (ENSURE_DISPLAY_OFF)

OLED ekranı kapalı hale getirir.

Makro Yükleme

Mon, 01 Jan 0001 00:00:00 +0000

Hazır makro dosyalarını Makrolarım sayfasından cihaza yükleyebilirsiniz.

Desteklenen Dosyalar

Dosya Türü	Kullanım
`.macro`	MacroStick makro dosyası
`.txt`	Script komutları içeren metin dosyası

Maksimum dosya boyutu 68 KB’dir.

Yükleme Adımları

Web arayüzünde Makrolarım sayfasına gidin.
Dosya yükleme alanından dosyanızı seçin.
Dosyanın yüklenmesini bekleyin.
Makronun dosya yöneticisi listesinde göründüğünü kontrol edin.

Yükleme Öncesi Kontrol

Dosya uzantısı .macro veya .txt olmalıdır.
Dosya boyutu 68 KB sınırını aşmamalıdır.
Cihazda 20 makro sınırına ulaşılmamış olmalıdır.
Script içeriğini bilmiyorsanız önce güvenli bir test ortamında çalıştırın.

.txt Dosyası Örneği

Bir .txt dosyası şu şekilde komutlar içerebilir:

Yönetici Ayarları

Mon, 01 Jan 0001 00:00:00 +0000

Yönetici ayarları, cihazın güvenlik ve bakım işlemleri için kullanılır.

Bu bölümdeki işlemler cihazın erişimini veya kayıtlı verilerini etkileyebilir. Özellikle sıfırlama ve formatlama işlemlerini dikkatli kullanın.

Şifre Değiştirme

Ayarlar sayfasına gidin.
Yönetici Şifresi bölümünü bulun.
Yeni Şifre alanına yeni şifrenizi yazın.
Yeni Şifre Tekrar alanına aynı şifreyi tekrar yazın.
Kaydet düğmesine tıklayın.
Cihazı yeniden başlatın.

Şifre 3 ile 20 karakter arasında olmalıdır.

Varsayılan giriş bilgileri ürün kutusundaki kartta yer alır.

Ayarlar Sayfası

Mon, 01 Jan 0001 00:00:00 +0000

Ayarlar sayfası, cihaz davranışını ve yönetici işlemlerini yapılandırmak için kullanılır.

Bu sayfa arayüzdeki kontrolleri açıklar. Ayarların ne zaman kullanılacağına dair ayrıntılar için Ayarlar bölümüne bakın.

Ayarları Değiştirmeden Önce

Bazı ayarlar cihazın bağlantı şeklini veya yönetim erişimini etkileyebilir. Özellikle Wi-Fi AP, Bluetooth, HID önceliği, sıfırlama ve formatlama işlemlerinde değişikliğin sonucunu önceden kontrol edin.

Çevre Birimleri

Ayar	Açıklama
Bluetooth LE Kullan	BLE HID özelliğini açar veya kapatır
Wi-Fi AP Kullan	Wi-Fi erişim noktasını açar veya kapatır
LED Kullan	Cihaz LED’ini açar veya kapatır
Ekran Kullan	OLED ekranı açar veya kapatır

Bazı değişikliklerin etkili olması için cihazın yeniden başlatılması gerekebilir.

Makro Çalıştırma

Mon, 01 Jan 0001 00:00:00 +0000

Kaydedilmiş makroları web arayüzünden veya bağlı fiziksel klavyedeki Caps Lock kontrol tuşuyla çalıştırabilirsiniz.

Çalıştırmadan Önce

Makro hedef cihaza gerçek giriş gönderir. Çalıştırmadan önce:

Doğru pencerenin veya uygulamanın aktif olduğunu kontrol edin.
Makro metin yazacaksa imlecin doğru alanda olduğundan emin olun.
Makro kısayol kullanıyorsa hedef uygulamanın bu kısayolları kabul ettiğini doğrulayın.

Caps Lock ile Çalıştırma

Günlük kullanımda en hızlı yöntem Caps Lock tuşudur.

Genel Bakış sayfasına gidin.
Makro Ayarları bölümünde çalıştırılacak makroyu seçin.
Makro Oynatma Tuşları bölümünde Capslock İle Oynat anahtarını açın.
Hedef uygulamayı hazır hale getirin.
Bağlı fiziksel klavyede Caps Lock tuşuna basın.

Makro çalıştığında OLED ekranda kısa süre Oynat mesajı görünür.

Zamanlama

Mon, 01 Jan 0001 00:00:00 +0000

Zamanlama komutları, makrodaki adımlar arasında ne kadar beklenileceğini belirler.

Neden Önemlidir?

Hedef uygulamalar her zaman aynı hızda tepki vermez. Bir pencerenin açılması, menünün görünmesi veya sayfanın yüklenmesi zaman alabilir. Zamanlama komutları, makronun bu durumlarda güvenilir çalışmasına yardımcı olur.

BEKLE (DELAY)

Belirtilen süre kadar bekler.

 BEKLE <milisaniye>

Örnekler:

 BEKLE 500
BEKLE 1000
BEKLE 5000

Değer	Anlamı
`500`	Yarım saniye
`1000`	1 saniye
`5000`	5 saniye

VARSATILAN_BEKLEME (DEFAULT_DELAY)

Sonraki adımlar için varsayılan bekleme süresini ayarlar.

Makro Döngüsü

Mon, 01 Jan 0001 00:00:00 +0000

Makro döngüsü, seçili makronun tekrar tekrar çalıştırılmasını sağlar. Günlük kullanımda döngü kontrolü bağlı fiziksel klavyedeki Scroll Lock tuşuyla yapılır.

Ne Zaman Kullanılır?

Döngü, aynı makronun belirli aralıklarla tekrar etmesi gereken durumlarda kullanılır. Döngüye almadan önce makronun tek çalıştırmada doğru sonuç verdiğini mutlaka test edin.

Scroll Lock ile Döngü Başlatma

Genel Bakış sayfasına gidin.
Makro Ayarları bölümünde döngüye alınacak makroyu seçin.
Makro Oynatma Tuşları bölümünde Scrolllock İle Tekrarla anahtarını açın.
Hedef uygulamayı hazır hale getirin.
Bağlı fiziksel klavyede Scroll Lock tuşuna basın.

Makro döngüye girdiğinde yerleşik ekranda kısa süre Tekrarla mesajı görünür.

Yazılım Güncelleme Sayfası

Mon, 01 Jan 0001 00:00:00 +0000

Yazılım Güncelleme sayfası, MacroStick firmware dosyasını yüklemek için kullanılır.

Bu sayfa arayüz adımlarını açıklar. Güncellemenin ne zaman yapılacağı ve dikkat edilmesi gerekenler için Firmware Güncelleme sayfasına bakın.

Güncelleme Öncesi Kontrol

Dosyanın .bin uzantılı olduğundan emin olun.
Dosyayı üreticiden aldığınızı doğrulayın.
Cihazı güncelleme bitene kadar çıkarmayacağınızdan emin olun.
Mümkünse güncellemeden önce mevcut önemli makrolarınızı yedekleyin.

Dosya Yükleyerek Güncelleme

Güncel firmware dosyasını edinin. Dosya uzantısı .bin olmalıdır.
Gözat veya dosya seçme düğmesine tıklayın.
Bilgisayarınızdaki .bin dosyasını seçin.
Güncelleme işlemini başlatın.
Yükleme tamamlanana kadar bekleyin.
Cihaz yeniden başladığında web arayüzüne tekrar bağlanın.

Otomatik Güncelleştirmeler

Bu panel otomatik güncelleme durumunu gösterir. Son kontrol zamanı, sürüm URL’si ve firmware URL’si gibi alanlar bilgilendirme amaçlıdır.

Makro Silme

Mon, 01 Jan 0001 00:00:00 +0000

Kullanmadığınız makroları Makrolarım sayfasından silebilirsiniz.

Silmeden Önce

Silmek istediğiniz makronun doğru makro olduğundan emin olun.
Makro önemliyse içeriğini ayrıca saklayın.
Varsayılan makro olarak seçili makroyu silerseniz varsayılan makro seçimini yeniden kontrol edin.

Tek Makro Silme

Makrolarım sayfasına gidin.
Silmek istediğiniz makroyu listede bulun.
Makronun yanındaki Sil düğmesine tıklayın.
Onay istenirse işlemi onaylayın.

Silinen makro geri alınamaz.

Diğer Makrolar Etkilenir mi?

Hayır. Tek makro silme işlemi yalnızca seçilen makroyu siler. Diğer makrolar, ayarlar ve bildirimler değişmeden kalır.

Sıkça Sorulan Sorular

Mon, 01 Jan 0001 00:00:00 +0000

Cihazı taktım ama `192.168.7.1` web sayfası açılmıyor, ne yapmalıyım?

Önce 2-3 saniye bekleyin ve sayfayı yenileyin. Sorun devam ederse USB bağlantısını çıkarıp yeniden takın, farklı bir USB portu deneyin ve doğrudan http://192.168.7.1 adresini yazın. Desteklenen sistemlerde http://macrostick.local adresini de deneyebilirsiniz.

Tarayıcının adresi arama motorunda aramadığından emin olun; adres çubuğuna tam olarak http://192.168.7.1 yazın. Sessiz moddaysanız önce MacroStick Wi-Fi ağına bağlanmanız gerekir.

Giriş bilgilerimi unuttum, ne yapabilirim?

Varsayılan giriş bilgileri kutudan çıkan kartta yer alır. Şifreyi değiştirdiyseniz ve hatırlamıyorsanız cihazı fabrika ayarlarına sıfırlamanız gerekebilir. Sıfırlama işlemi makroları ve ayarları silebilir. Cihazınızı sıfırlamak için; cihaz takılıyken ekranda “cihazınız sıfırlanıyor” ibaresini görene kadar cihazın üstündeki sessiz mod butonuna basınız.

MacroStick Dokümantasyonu

core_payload Endpoint'i

Endpoint link

İstek Gövdesi link

Erişim

Erişim Yöntemleri link

USB Üzerinden Erişim link

Eşleştirme

Eşleştirme Öncesi Kontrol link

Hazırlık link

Windows link

macOS link

Android link

iOS ve iPadOS link

Sorun Giderme link

Eşleştirme Sonrası Test link

Firmware Güncelleme

Ne Zaman Güncellenmeli? link

Güncelleme Dosyasını Alma link

Hızlı Başlangıç

Adımlar link

Fiziksel Tuşlarla Kullanım link

Komutlar

Okuma Sırası link

Temel Yapı link

Yorum Satırları link

Türkçe ve İngilizce Komutlar link

Kontrol Tuşları

Temel Mantık link

MacroStick Nedir?

MacroStick Ne Değildir? link

Makro Nedir?

Makro Ne İşe Yarar? link

Makro Planlama link

Nasıl Etkinleştirilir?

Ön Bilgi link

Etkinleştirme link

Aktif Olduğunda link

BLE Kullanımı

Kullanım Öncesi link

Bağlantı Davranışı link

Genel Bakış Sayfası

Bu Sayfayı Ne İçin Kullanırsınız? link

Durum Kartları link

Makro Oynatma Tuşları link

HID Ayarları

HID Öncelik Modları link

Hangi Mod Seçilmeli? link

Başlangıçta Oynat link

Kimlik Doğrulama

Yöntem: HTTP Basic Authentication link

Klavye Komutları

Komut Özeti link

BAS (PRESS) link

Kurulum

Kutu İçeriği ve Hazırlık link

USB Portları link

Bağlantı Adımları link

Wi-Fi Bağlantısı

Ağ Bilgileri link

Bağlanma Adımları link

Sorun Giderme link

Kullanım Sonrası link

Yeni Makro Oluşturma

Adımlar link

Örnek Script link

Yazım Kuralları link

Çevre Birimi Ayarları

Bluetooth LE Kullan link

Wi-Fi AP Kullan link

Fare Komutları

Komut Özeti link

FARE_HAREKET (MOUSE_MOVE) link

Fiziksel Kayıt

Hazırlık link

Ne Zaman Fiziksel Kayıt Kullanılır? link

İlk Bağlantı

Ön Koşullar link

Giriş Yapma link

Makrolarım Sayfası

Endpoint

İstek Gövdesi

Erişim Yöntemleri

USB Üzerinden Erişim

Eşleştirme Öncesi Kontrol

Hazırlık

Windows

macOS

Android

iOS ve iPadOS

Sorun Giderme

Eşleştirme Sonrası Test

Ne Zaman Güncellenmeli?

Güncelleme Dosyasını Alma

Adımlar

Fiziksel Tuşlarla Kullanım

Okuma Sırası

Temel Yapı

Yorum Satırları

Türkçe ve İngilizce Komutlar

Temel Mantık

MacroStick Ne Değildir?

Makro Ne İşe Yarar?

Makro Planlama

Ön Bilgi

Etkinleştirme

Aktif Olduğunda

Kullanım Öncesi

Bağlantı Davranışı

Bu Sayfayı Ne İçin Kullanırsınız?

Durum Kartları

Makro Oynatma Tuşları

HID Öncelik Modları

Hangi Mod Seçilmeli?

Başlangıçta Oynat

Yöntem: HTTP Basic Authentication

Komut Özeti

BAS (PRESS)

Kutu İçeriği ve Hazırlık

USB Portları

Bağlantı Adımları

Ağ Bilgileri

Bağlanma Adımları

Sorun Giderme

Kullanım Sonrası

Adımlar

Örnek Script

Yazım Kuralları

Bluetooth LE Kullan

Wi-Fi AP Kullan

Komut Özeti

FARE_HAREKET (MOUSE_MOVE)

Hazırlık

Ne Zaman Fiziksel Kayıt Kullanılır?

Ön Koşullar

Giriş Yapma

Sayfa Yapısı

Yeni Makro Oluşturma

Temel Yardımcı Sınıf

Paket Yapısı

Sayfa Yapısı

Kayıt Tutmayı Etkinleştir

Kullanım Amacı

LED_KULLAN (ENSURE_LED_ON)

LED_KULLANMA (ENSURE_LED_OFF)

EKRAN_KULLAN (ENSURE_DISPLAY_ON)

EKRAN_KULLANMA (ENSURE_DISPLAY_OFF)

Desteklenen Dosyalar

Yükleme Adımları

Yükleme Öncesi Kontrol

.txt Dosyası Örneği

Şifre Değiştirme

Ayarları Değiştirmeden Önce

Çevre Birimleri

Çalıştırmadan Önce

Caps Lock ile Çalıştırma

Neden Önemlidir?

BEKLE (DELAY)

VARSATILAN_BEKLEME (DEFAULT_DELAY)

Ne Zaman Kullanılır?