Projekt CANgauge CANgauge Project

Pierwsze Uruchomienie - Konfiguracja w 3 Krokach First Start - Configuration in 3 Steps

Aby w pełni przygotować urządzenie do pracy z nowym oprogramowaniem v2.0, postępuj zgodnie z poniższą instrukcją. To fully prepare the device for use with the new v2.0 software, follow the instructions below.

1. Aktualizacja Firmware Urządzenia:Device Firmware Update: To podstawa do działania nowych funkcji. This is essential for new features to work.
   • Odłącz CANgauge od zasilania. Naciśnij i przytrzymaj przycisk "BOOTSEL" na płytce.Disconnect CANgauge from power. Press and hold the "BOOTSEL" button on the board.
   • Trzymając przycisk, podłącz urządzenie do komputera kablem USB. Pojawi się dysk "RPI-RP2".While holding the button, connect the device to your computer with a USB cable. A disk named "RPI-RP2" will appear.
   • Przeciągnij i upuść pobrany plik .uf2 na dysk "RPI-RP2". Urządzenie zaktualizuje się i uruchomi ponownie.Drag and drop the downloaded .uf2 file onto the "RPI-RP2" disk. The device will update and restart automatically.
2. Wgranie Ustawień Fabrycznych:Uploading Factory Settings: Ten krok przygotuje urządzenie i skonfiguruje podstawowe parametry. This step prepares the device and configures basic parameters.
   • Uruchom aplikację konfiguracyjną i połącz się z urządzeniem.Launch the configurator application and connect to the device.
   • W zakładce "Konfiguracja Parametrów" kliknij przycisk "📁 Wczytaj z pliku JSON...".In the "Parameter Configuration" tab, click the "📁 Load from JSON file..." button.
   • Wybierz plik CANgauge_v2.0.0_factory_settings.json z pobranego pakietu.Select the CANgauge_v2.0.0_factory_settings.json file from the downloaded bundle.
   • Po wczytaniu, kliknij główny przycisk "📤 Synchronizuj Zmiany", a następnie "💾 Zapisz w EEPROM".After loading, click the main "📤 Synchronize Changes" button, followed by "💾 Save to EEPROM".
3. Hurtowy Import Ikon:Bulk Icon Import: Wgrajmy zestaw startowych ikon dla skonfigurowanych parametrów. Let's upload the starter set of icons for the configured parameters.
   • W zakładce "Konfiguracja Parametrów" kliknij "🖼️ Importuj Wiele Ikon...".In the "Parameter Configuration" tab, click "🖼️ Import Multiple Icons...".
   • W nowym oknie kliknij "📁 Wybierz folder z ikonami..." i wskaż folder icons z pobranego pakietu.In the new window, click "📁 Select icon folder..." and point to the icons folder from the downloaded bundle.
   • Aplikacja automatycznie przypisze ikony do parametrów. Kliknij "✅ Rozpocznij import".The application will automatically assign icons to parameters. Click "✅ Start import".

Twoje urządzenie jest teraz w pełni skonfigurowane i gotowe do personalizacji oraz podłączenia do magistrali CAN! Your device is now fully configured and ready for personalization and connection to the CAN bus!

Przegląd Funkcji Konfiguratora v2.0 Configurator v2.0 Feature Overview

Nowa aplikacja to centrum dowodzenia Twojego CANgauge. Interfejs oparty na zakładkach zapewnia intuicyjny dostęp do wszystkich, nawet najbardziej zaawansowanych opcji. The new application is the command center for your CANgauge. The tab-based interface provides intuitive access to all options, even the most advanced ones.

Główny Ekran - Konfiguracja ParametrówMain Screen - Parameter Configuration

Centrum zarządzania 12 slotami na parametry. Możesz tu aktywować/deaktywować sloty (klikając checkbox w pierwszej kolumnie), zmieniać ich kolejność strzałkami (zmiana wymaga synchronizacji) oraz otwierać okno szczegółowej edycji (dwuklik).The management center for 12 parameter slots. Here you can activate/deactivate slots (by clicking the checkbox in the first column), change their order with the arrows (requires synchronization), and open the detailed editing window (double-click).

Zakładka - Ustawienia OgólneTab - General Settings

Dostosuj globalne zachowanie urządzenia. Zmień prędkość CAN, orientację ekranu, kolory interfejsu (RGB565), czułość automatycznego podświetlenia. Aktywuj tryb demo do testów (uwaga: buzzer jest w nim wyłączony) i zdefiniuj, który parametr pełni rolę obrotów silnika (RPM).Customize the global behavior of the device. Change the CAN speed, screen orientation, interface colors (RGB565), and auto-backlight sensitivity. Activate demo mode for testing (note: the buzzer is disabled) and define which parameter serves as the engine speed (RPM).

Zakładka - CAN ExpanderTab - CAN Expander

Rozszerz możliwości systemu o dodatkowe wejścia i wyjścia. Gdy zakładka jest aktywna, statusy I/O są odświeżane na żywo. Aplikacja waliduje ustawienia, zapobiegając konfliktom (np. dwa wejścia na tym samym bicie tej samej ramki).Expand the system's capabilities with additional inputs and outputs. When the tab is active, I/O statuses are refreshed live. The application validates settings to prevent conflicts (e.g., two inputs on the same bit of the same frame).

Zakładka - Menedżer PlikówTab - File Manager

Zarządzaj wewnętrzną pamięcią flash. Przeglądaj i usuwaj wgrane pliki (np. ikony), monitoruj zajętość pamięci za pomocą paska postępu. Dostępna jest również funkcja formatowania pamięci (operacja nieodwracalna, wymaga podwójnego potwierdzenia).Manage the internal flash memory. Browse and delete uploaded files (e.g., icons), and monitor memory usage with a progress bar. A memory format function is also available (an irreversible operation that requires double confirmation).

Narzędzie - Import z Pliku DBCTool - Import from DBC File

Importuj definicje sygnałów z plików .dbc. Aplikacja automatycznie naprawia częsty błąd w plikach DBC, poprawnie flagując ramki o ID > 0x7FF jako Extended. Wystarczy przeciągnąć sygnały do slotów, a wszystkie dane (CAN ID, bity, skala) zostaną uzupełnione.Import signal definitions from .dbc files. The application automatically fixes a common error in DBC files by correctly flagging frames with an ID > 0x7FF as Extended. Simply drag signals to the slots, and all data (CAN ID, bits, scale) will be filled in.

Narzędzie - CAN SnifferTool - CAN Sniffer

Narzędzie diagnostyczne do podsłuchiwania magistrali CAN. Pokazuje typ ramki (STD/EXT), oblicza częstotliwość w czasie rzeczywistym i pozwala na zapisywanie całej komunikacji do pliku CSV na bieżąco, co jest nieocenione przy diagnostyce i inżynierii wstecznej.A diagnostic tool for sniffing the CAN bus. It shows the frame type (STD/EXT), calculates the frequency in real-time, and allows for live logging of all communication to a CSV file, which is invaluable for diagnostics and reverse engineering.

Edytor Parametrów - Pełna Kontrola Parameter Editor - Full Control

Dwukrotne kliknięcie na dowolny parametr otwiera zaawansowany edytor, który daje Ci władzę nad każdym aspektem jego działania i wyglądu. Został on podzielony na trzy logiczne sekcje: Double-clicking on any parameter opens an advanced editor that gives you power over every aspect of its operation and appearance. It has been divided into three logical sections:

Ogólne i Źródło Danych General & Data Source

• CAN ID / Ramka RozszerzonaExtended Frame: Identyfikator ramki (HEX). Zaznacz pole EXT, aby nasłuchiwać ramek 29-bitowych. Frame identifier (HEX). Check the EXT box to listen for 29-bit frames.
• Bit startowy / Długość bitowa:Start Bit / Bit Length: Precyzyjna lokalizacja danych. Precise data location.
• Wgraj Ikonę:Upload Icon: Obraz jest automatycznie skalowany do 50x50px i konwertowany do formatu RGB565. Ważne: kolor czarny (#000000) jest traktowany jako przezroczysty. The image is automatically scaled to 50x50px and converted to RGB565 format. Important: the color black (#000000) is treated as transparent.
• Little Endian: Określa kolejność bajtów. Zaznacz, jeśli najmniej znaczący bajt jest pierwszy. Defines the byte order. Check if the least significant byte comes first.
• Wartość ze znakiem:Signed Value: Interpretuje dane jako liczby ujemne i dodatnie. Interprets the data as negative and positive numbers.
• Skala / Offset:Scale / Offset: Stosuje wzór: wartość = (dane * skala) + offset. Applies the formula: value = (data * scale) + offset.

Wyświetlanie Display

• Precyzja:Precision: Liczba miejsc po przecinku. Number of decimal places.
• Specjalne warunki wyświetlania:Special Display Conditions: Zastępuje wartość liczbową predefiniowanym tekstem (np. "OK", "Błąd"), gdy wartość znajdzie się w podanym zakresie. Replaces a numerical value with predefined text (e.g., "OK", "Error") when the value falls within a specified range.

Alarmy Alarms

Niezbędne do działania alarmów! Required for Alarms to Work!

Aby alarmy działały poprawnie, w zakładce 'Ustawienia Ogólne' musisz wskazać, który parametr odpowiada za obroty silnika (RPM). Alarmy są celowo dezaktywowane poniżej pewnego progu obrotów (aby uniknąć fałszywych ostrzeżeń na postoju). Jeśli żaden parametr nie jest ustawiony jako RPM, system przyjmuje wartość zero, co permanentnie wyłącza wszystkie alarmy. For alarms to function correctly, you must specify which parameter corresponds to engine speed (RPM) in the 'General Settings' tab. Alarms are intentionally deactivated below a certain RPM threshold (to avoid false warnings when stationary). If no parameter is set as RPM, the system assumes a value of zero, which permanently disables all alarms.

• Progi Główne:Main Thresholds: Cztery progi dla Ostrzeżenia (żółty kolor) i Alarmu (czerwony kolor). Four thresholds for Warning (yellow color) and Alarm (red color).
• Alarmy zależne:Dependent Alarms: Aktywuje dwa niezależne zestawy progów (A i B). Activates two independent sets of thresholds (A and B).
• Parametr nadrzędny:Parent Parameter: Wybierz parametr (np. RPM), którego wartość będzie decydować o użyciu zestawu progów A lub B. Jest to przydatne do ustawienia różnych progów np. temperatury oleju dla niskich i wysokich obrotów silnika. Select a parameter (e.g., RPM) whose value will determine whether to use threshold set A or B. This is useful for setting different thresholds, for instance, for oil temperature at low and high engine speeds.
• Próg przełączenia:Switching Threshold: Wartość parametru nadrzędnego, która przełącza progi. The value of the parent parameter that switches between the thresholds.

Expander Wejść/Wyjść - Pinout i Charakterystyka I/O Expander - Pinout and Characteristics

CANgauge wyposażony jest w złącze rozszerzeń, które udostępnia dodatkowe wejścia i wyjścia, zwiększając możliwości integracji z czujnikami i urządzeniami wykonawczymi w pojeździe. Poniżej znajduje się opis pinów oraz ich charakterystyka elektryczna.CANgauge is equipped with an expansion connector that provides additional inputs and outputs, increasing the possibilities of integration with sensors and actuators in the vehicle. Below is a description of the pins and their electrical characteristics.

Schematy Uproszczone PortówSimplified Port Schematics

Uproszczone schematy elektryczne dla wyjścia cyfrowego (DO), wejścia analogowego (AI) i wejścia cyfrowego (DI).Simplified electrical schematics for the digital output (DO), analog input (AI), and digital input (DI).

Podłączenie PrzekaźnikaRelay Connection

Prawidłowy sposób podłączenia zewnętrznego przekaźnika do wyjścia cyfrowego wraz z wymaganą diodą zabezpieczającą D7.The correct way to connect an external relay to a digital output, including the required D7 protection diode.

Pełna Obsługa Ramek 29-bit (Extended ID) Full Support for 29-bit Frames (Extended ID)

Wraz z wersją 2.0, CANgauge zyskuje pełne wsparcie dla rozszerzonych 29-bitowych ramek CAN (Extended ID), obok standardowych 11-bitowych. Jest to kluczowa funkcja dla integracji z bardziej złożonymi systemami, w tym z magistralami danych spotykanymi w nowoczesnych pojazdach (np. w oparciu o standard J1939).With version 2.0, CANgauge gains full support for extended 29-bit CAN frames (Extended ID), alongside standard 11-bit frames. This is a key feature for integration with more complex systems, including data buses found in modern vehicles (e.g., based on the J1939 standard).

Obsługa rozszerzonych identyfikatorów jest niezwykle prosta. Zarówno podczas konfiguracji parametrów wyświetlacza, jak i w zakładce CAN Expander, wystarczy zaznaczyć pole wyboru EXT obok pola CAN ID. Od tego momentu urządzenie będzie nasłuchiwać lub wysyłać ramki o 29-bitowym identyfikatorze.Handling extended identifiers is extremely simple. Both when configuring display parameters and in the CAN Expander tab, you just need to check the EXT box next to the CAN ID field. From that moment, the device will listen for or send frames with a 29-bit identifier.

Pełna obsługa obu standardów ID sprawia, że CANgauge jest uniwersalnym narzędziem, gotowym do pracy zarówno w prostych projektach hobbystycznych, jak i w zaawansowanych instalacjach motoryzacyjnych.Full support for both ID standards makes CANgauge a universal tool, ready for work in both simple hobby projects and advanced automotive installations.

Synchronizacja i Zapis - Zrozumienie Procesu Synchronization and Saving - Understanding the Process

Zrozumienie różnicy między synchronizacją a zapisem do pamięci stałej jest kluczowe dla poprawnej obsługi urządzenia. Aplikacja posiada wbudowane zabezpieczenia, aby zapobiec przypadkowej utracie ustawień.Understanding the difference between synchronization and saving to permanent memory is crucial for proper device operation. The application has built-in safeguards to prevent accidental loss of settings.

• Zmiany natychmiastowe:Instant Changes: Większość pojedynczych zmian (np. aktywacja parametru, zmiana koloru, modyfikacja progu alarmowego) jest wysyłana do pamięci RAM urządzenia natychmiast po ich dokonaniu w interfejsie. Most individual changes (e.g., activating a parameter, changing a color, modifying an alarm threshold) are sent to the device's RAM immediately after they are made in the interface.
• 📤 Synchronizuj Zmiany Synchronize Changes Przycisk ten wysyła całą, kompletną konfigurację z aplikacji do pamięci RAM urządzenia. Jest to konieczne głównie po operacjach, które nie są wysyłane natychmiast, takich jak zmiana kolejności parametrów lub załadowanie ustawień z pliku. This button sends the entire, complete configuration from the application to the device's RAM. It is mainly necessary after operations that are not sent immediately, such as changing the order of parameters or loading settings from a file.
• 💾 Zapisz w EEPROM Save to EEPROM Instruuje urządzenie, aby zapisało swoją aktualną konfigurację z pamięci RAM do pamięci stałej (EEPROM). Dzięki temu ustawienia przetrwają odłączenie zasilania. Instructs the device to save its current configuration from RAM to permanent memory (EEPROM). This ensures that the settings will survive a power outage.