BrickMotion WEB Controller

BrickMotion WEB Controller to lekka aplikacja WEB o niskim opóźnieniu (low-latency), stworzona do zdalnego sterowania kompatybilnymi, programowalnymi hubami za pomocą interfejsu WebSerial API lokalnie. Komunikuje się ona bezpośrednio z dedykowanymi skryptami MicroPython uruchomionymi na hubie, zapewniając płynną kontrolę w czasie rzeczywistym z poziomu responsywnego interfejsu w przeglądarce.

Brak konieczności modyfikacji oprogramowania (Firmware): Aplikacja działa w pełni na bazie fabrycznego oprogramowania układowego huba. Nie musisz wgrywać niestandardowego firmware'u, modyfikować plików systemowych ani ryzykować utraty gwarancji na urządzenie.

Aplikacja została dokładnie przetestowana w środowisku Windows oraz ChromeOS przy użyciu przeglądarek Google Chrome i Microsoft Edge.

Jak uruchomić aplikację (<code>start.bat</code> vs bezpośredni plik HTML)

Aplikację możesz uruchomić na dwa sposoby:

1. Bezpośrednie uruchomienie pliku HTML (Najprostsze):

   • Po prostu kliknij dwukrotnie plik <code>.html</code> (np. <code>BrickMotionWEBcontroller.html</code>), aby otworzyć go w domyślnej przeglądarce obsługującej WebSerial. W większości standardowych konfiguracji na Windowsie i ChromeOS aplikacja działa od razu, bez konieczności dodatkowej konfiguracji.

2. Użycie skryptu <code>start.bat</code> (Opcjonalne / Zalecane dla „czystego” środowiska):

   • Dołączony skrypt <code>start.bat</code> uruchamia aplikację na lokalnym serwerze deweloperskim (<code>localhost</code>) bezpośrednio w trybie incognito / prywatnym przeglądarki Google Chrome. Zapobiega to zakłócaniu stabilności połączenia WebSerial przez wtyczki i rozszerzenia przeglądarki lub pamięć podręczną (cache).

Szybka instrukcja obsługi

1. Wgraj skrypt odbiornika:

   • Otwórz preferowane oficjalne oprogramowanie do obsługi huba (wersję przeglądarkową lub aplikację stacjonarną) i utwórz nowy projekt Python.

   • Skopiuj skrypt odbiornika, klikając przycisk „Python Script” w aplikacji BrickMotion WEB Controller, a następnie wklej go do swojego projektu.

   • Ważne (Sposób połączenia):

     • Kabel USB (Zalecany): Programowanie i uruchamianie skryptu przez kabel USB zapewnia najbardziej stabilne połączenie.

     • Bluetooth: Jeśli wgrywasz lub uruchamiasz skrypt przez Bluetooth, pamiętaj o rozłączeniu oficjalnej aplikacji z hubem po wystartowaniu skryptu. W przeciwnym razie przeglądarka nie będzie mogła sparować się z urządzeniem przez WebSerial.

2. Uruchom kontroler:

   • Otwórz plik <code>.html</code> bezpośrednio lub uruchom <code>start.bat</code>, aby otworzyć go w trybie incognito.

3. Połącz się z hubem:

   • Kliknij przycisk Connect w aplikacji BrickMotion WEB Controller.

   • Wybierz odpowiedni port szeregowy / COM z okna dialogowego przeglądarki i zatwierdź wybór.

   • Po połączeniu wskaźnik statusu zmieni kolor na zielony, a sterowanie w czasie rzeczywistym zostanie aktywowane.

Rozwiązywanie problemów: Co zrobić, gdy aplikacja nie widzi huba?

Jeśli lista portów szeregowych w przeglądarce jest pusta lub aplikacja nie wykrywa huba, wykonaj poniższe kroki:

1. Sprawdź Bluetooth i sparowanie w systemie:

   • Upewnij się, że moduł Bluetooth w komputerze jest włączony.

   • Otwórz ustawienia systemowe (Ustawienia Windows > Bluetooth i urządzenia lub Ustawienia ChromeOS > Bluetooth).

   • Sprawdź, czy hub jest sparowany bezpośrednio na poziomie systemu operacyjnego. Jeśli nie ma go na liście, wprowadź hub w tryb parowania i najpierw sparuj go w ustawieniach systemu.

2. Rozłącz oficjalne aplikacje:

   • Połączenia szeregowe i Bluetooth nie mogą być udostępniane kilku aplikacjom jednocześnie. Upewnij się, że oficjalne oprogramowanie, aplikacja stacjonarna lub inne karty przeglądarki połączone z hubem są całkowicie zamknięte lub rozłączone.

3. Zrestartuj hub:

   • Wyłącz i włącz hub ponownie, zrestartuj skrypt MicroPython i spróbuj połączyć się ponownie w przeglądarce.

4. Sprawdź kompatybilność przeglądarki:

   • Upewnij się, że używasz obsługiwanej przeglądarki opartej na silniku Chromium (Google Chrome lub Microsoft Edge) z włączoną obsługą interfejsu WebSerial.

Pamiętaj, że kupujesz projekt typu DIY / Hobbystyczny:

• Niewielka opłata: Cena symbolicznie pokrywa czas poświęcony na opracowanie kodu i przygotowanie dokumentacji.

• Wersja niezależna: Aplikacja jest tworzona amatorsko i rozwijana w czasie wolnym — nie jest to komercyjny produkt dużej korporacji ani oficjalne oprogramowanie producenta zestawów.

• Szybki start bez modyfikacji: Projekt działa na fabrycznym oprogramowaniu huba i wykorzystuje nowoczesne WebSerial API, ale ze względu na specyfikę połączeń przeglądarkowych oraz środowiska (różne systemy, wersje Bluetooth, wtyczki w przeglądarkach) mogą sporadycznie wystąpić drobne trudności konfiguracyjne.