instrukcja instalacji

Od pudełka do grającej kostki
w kwadrans.

Bez lutowania i bez kompilowania: kupujesz kostkę, wgrywasz obraz prosto z przeglądarki (albo jedną komendą w terminalu), łączysz z Wi-Fi telefonem. Poniżej każdy krok osobno.

CZEGO POTRZEBUJESZ kostka M5Stack Core2kabel USB-C do danychkomputer Win / macOSdomowe Wi-Fi 2,4 GHzgłośnik BT (opcjonalnie)

KROK 01ZAKUP

Kup kostkę

M5Stack Core2 — jedno pudełko z ekranem, głośnikiem, baterią i oboma radiami, ~50 €. Do niczego nie trzeba lutownicy. W Polsce kupisz ją w Botlandzie ↗ (ok. 220 zł, wysyłka w 24 h), poza Polską w sklepie M5Stack ↗. Wszystkie dotychczasowe rewizje (v1.0, v1.1, v1.3) grają tym samym plikiem.

KROK 02OBRAZ

Pobierz obraz systemu

Jeden plik .bin z całym systemem — bez kompilowania, bez środowisk programistycznych. Aktualna wersja: 0.2.1 (katalog 218 zmierzonych stacji, konsola stacji w przeglądarce, automatyczne logotypy).

Pobierz open-radio-0-2-1.bin (2,4 MB)

SHA-256: 295ca3fdf9f9daf7a11ee979bc3371b2c79aaf48de5afe455668b72b23dc0546 (plik .sha256) ·

Pobierając, akceptujesz warunki: licencja GPL-3.0 (pełne źródła w repozytorium na GitHubie ↗), nazwa projektu chroniona, bez gwarancji. Pełny tekst: LICENSE-0-2-1.txt.

Poprzednia wersja 0.1 (stabilna)

open-radio-0-1.bin (2,3 MB) · SHA-256: a075693cbc401ebadfc222befc53b899d17e9df564d6277c28d51f434f77b671 (.sha256)

KROK 03KABEL

Podłącz kostkę do komputera

Kablem USB-C — koniecznie takim do transmisji danych (część kabli „do ładowania" nie ma linii danych i komputer nic nie zobaczy). Kostka zgłosi się jako port szeregowy przez układ CH9102. Jeśli system jej nie widzi, zainstaluj sterownik z strony sterowników M5Stack ↗ (sekcja „CH9102 Driver", wersje dla Windows i macOS) i przepnij kabel.

KROK 04FLASH

Wgraj obraz

▣ Z PRZEGLĄDARKI — GŁÓWNA ŚCIEŻKA

Trzy ruchy, bez instalowania czegokolwiek: 1. otwórz tę stronę w Chrome albo Edge na komputerze, kostka na kablu · 2. kliknij przycisk i wybierz port · 3. zatwierdź czyszczenie i instalację — strona wgra system i zrestartuje kostkę (~2 min).

Ta przeglądarka nie obsługuje Web Serial — otwórz w Chrome/Edge albo rozwiń opcje poniżej. Web Serial zablokowany — rozwiń opcje poniżej.

W okienku wyboru portu kostka może figurować jako „Nienazwane urządzenie", „USB Single Serial", cu.usbserial-… (macOS) albo COM… (Windows) — nazwę zgłasza fabryczny układ USB kostki (CH9102), nie nasz system. Odłącz inne urządzenia USB-serial, a na liście zostanie tylko kostka.

Inne opcje: stabilna wersja 0.1 i instalacja z terminala (esptool)

▣ WERSJA 0.1 Z PRZEGLĄDARKI

Ta przeglądarka nie obsługuje Web Serial. Web Serial zablokowany.

Terminal (Safari/Firefox/Linux albo gdy wolisz klasycznie). Narzędzie esptool to oficjalny program Espressif. Instalujesz raz, używasz jedną komendą:

▣ WINDOWS

Zainstaluj Pythona ↗ — w instalatorze zaznacz „Add python.exe to PATH".
Otwórz Wiersz poleceń (Start → wpisz „cmd") i zainstaluj narzędzie:
python -m pip install esptool
Sprawdź numer portu: Menedżer urządzeń → Porty (COM i LPT) — np. COM5.
Wgraj obraz (podmień COM5 i nazwę pliku na swoje):
python -m esptool --chip esp32 --port COM5 --baud 460800 write_flash 0x0 open-radio-0-2-1.bin

▣ MACOS

Otwórz Terminal (Spotlight → „Terminal"). Python 3 jest w systemie.
Zainstaluj narzędzie:
python3 -m pip install esptool
Znajdź port kostki:
ls /dev/cu.*
Szukaj wpisu typu /dev/cu.usbserial-XXXX albo /dev/cu.wchusbserial-XXXX.
Wgraj obraz (podmień port i nazwę pliku na swoje):
python3 -m esptool --chip esp32 --port /dev/cu.usbserial-XXXX --baud 460800 write_flash 0x0 open-radio-0-2-1.bin

Po 1–2 minutach zobaczysz Hash of data verified — kostka zrestartuje się sama do systemu radia.

KROK 05PIERWSZY START

Połącz z Wi-Fi telefonem

Kostka wystawia własną tymczasową sieć konfiguracji. Na telefonie: połącz się z siecią OpenRadio-Setup, wpisz jednorazowy kod pokazany na ekranie kostki. Portal otworzy się sam (jeśli nie — wejdź na 192.168.4.1), dodaj w nim swoje domowe Wi-Fi i gotowe. Telefon nie będzie już potrzebny.

Zaraz potem kostka zapyta o stacje: wybierasz dziewięć z katalogu 218 sprawdzonych, a listę możesz przejrzeć i ułożyć wcześniej na komputerze. Później zmienisz ją w ustawieniach, bez wgrywania systemu od nowa.

KROK 06GŁOŚNIK

Sparuj głośnik Bluetooth (opcjonalnie)

Najpierw zawsze zagra głośnik wbudowany. Chcesz lepszy dźwięk: włącz swój głośnik BT w tryb parowania i dotknij skanowania na ekranie Bluetooth kostki — głośnik zostanie zapamiętany i od tej pory będą łączyć się sami. Wskazówka z pomiarów: kostka lubi stać dalej niż 2 m od routera, bo jego nadajnik potrafi zagłuszać Bluetooth.

Częste potknięcia:

komputer nie widzi kostki→w 9 na 10 przypadków winny jest kabel bez linii danych — weź inny; potem sterownik CH9102 (Krok 03)

„Permission denied" / port zajęty→zamknij programy, które trzymają port szeregowy (Arduino IDE, monitory portu), i spróbuj ponownie — bez sudo

flash OK, ale nie gra→odłącz i podłącz zasilanie (power-cycle); przy pierwszym starcie stacji kostka buforuje ok. 2 s

← Wróć do strony kostki Dziennik produkcji

Od pudełka do grającej kostkiw kwadrans.