mirror of
https://github.com/meshtastic/Meshtastic-Android.git
synced 2026-06-26 06:25:24 -04:00
chore: Scheduled updates (Firmware, Hardware, Translations, Graphs, Baseline) (#5906)
This commit is contained in:
James Rich
@@ -3,52 +3,52 @@ title: Android Auto
|
||||
parent: Käyttöopas
|
||||
nav_order: 18
|
||||
last_updated: 2026-06-11
|
||||
description: Use Meshtastic hands-free on an Android Auto head unit — read messages aloud, reply by voice, and check nodes and mesh status while driving.
|
||||
description: Käytä Meshtasticia hands-free-tilassa Android Auto -laitteessa — lue viestit ääneen, vastaa puheella ja tarkista radiot sekä mesh-verkon tila ajon aikana.
|
||||
aliases:
|
||||
- android-auto
|
||||
- car
|
||||
- head-unit
|
||||
- auto
|
||||
- päälaite
|
||||
- auto
|
||||
---
|
||||
|
||||
# Android Auto
|
||||
|
||||
Meshtastic integrates with Android Auto so you can stay in touch with your mesh while driving, without taking your hands off the wheel or your eyes off the road.
|
||||
Meshtastic integroituu Android Auton kanssa, joten voit pysyä yhteydessä mesh-verkkoosi ajon aikana ilman, että otat käsiä pois ratista tai katsetta tiestä.
|
||||
|
||||
> ⚠️ **Note:** Android Auto support is available on **Google-flavor Android builds only**. It is not included in the F-Droid build, and it is not available on Desktop or iOS.
|
||||
> ⚠️ **Huom:** Android Auto -tuki on saatavilla vain **Google-version Android-laitteissa**. Sitä ei ole mukana F-Droid-versiossa, eikä se ole saatavilla työpöydällä tai iOS:ssä.
|
||||
|
||||
## Yleiskatsaus
|
||||
|
||||
When your phone is connected to an Android Auto head unit (or the Desktop Head Unit emulator used for development), Meshtastic appears as a messaging app built with the Android Car App Library. The car interface presents a tabbed Home screen optimized for driving-safe, glanceable use:
|
||||
Kun puhelin on yhdistetty Android Auto -pääyksikköön (tai kehityksessä käytettävään Desktop Head Unit -emulaattoriin), Meshtastic näkyy viestisovelluksena, joka on toteutettu Android Car App Library -kirjastolla. Auton käyttöliittymä näyttää välilehdellisen aloitusnäkymän, joka on optimoitu ajoturvalliseen ja nopeasti silmäiltävään käyttöön:
|
||||
|
||||
- **Messages** — recent conversations, with hands-free reading and replies.
|
||||
- **Nodes** — the mesh node list, with a node-detail view.
|
||||
- **Status** — current connection and mesh status.
|
||||
- **Viestit** — viimeisimmät keskustelut, ääneen luettava ja äänellä vastattava.
|
||||
- **Radiot** — mesh-verkon radiolista, sisältää radion yksityiskohtaisen näkymän.
|
||||
- **Tila** — nykyinen yhteys- ja mesh-verkon tila.
|
||||
|
||||
The car app does not add a new connection of its own. It uses the Meshtastic app's existing connection, node, and message state, so it reflects whatever your phone is already connected to.
|
||||
Autosovellus ei luo omaa yhteyttä. Se käyttää Meshtastic-sovelluksen olemassa olevaa yhteyttä, radioa ja viestitilaa, joten se heijastaa sitä, mihin puhelimesi on jo yhdistetty.
|
||||
|
||||
> ⚠️ **Note:** Your phone must be connected to a Meshtastic radio for the car app to show live data. If the app is disconnected, the car screen reflects that disconnected state.
|
||||
> ⚠️ **Huom:** Puhelimen täytyy olla yhdistetty Meshtastic-radioon, jotta autosovellus näyttää reaaliaikaista dataa. Jos sovellus ei ole yhdistetty, auton näyttö näyttää katkaistun yhteyden tilan.
|
||||
|
||||
## Viestit
|
||||
|
||||
The Messages tab lists your recent conversations. While driving, you can:
|
||||
Viestit-välilehti näyttää viimeisimmät keskustelusi. Ajon aikana voit:
|
||||
|
||||
- **Have messages read aloud** so you don't need to look at the screen.
|
||||
- **Reply by voice or text** using your head unit's reply control, dictating your response hands-free.
|
||||
- **Kuunnella viestit ääneen**, jotta sinun ei tarvitse katsoa näyttöä.
|
||||
- **Vastata äänellä tai tekstillä** käyttämällä pääyksikön vastaustoimintoa ja sanella vastauksesi hands-free-tilassa.
|
||||
|
||||
## Laitteet
|
||||
|
||||
The Nodes tab shows your mesh node list in a car-friendly layout. Selecting a node opens a node-detail view with key information about that node. See [Nodes](nodes) for the full meaning of the information shown.
|
||||
Radiot-välilehti näyttää mesh-verkon radiolistan ajamiseen sopivassa näkymässä. Radion valinta avaa yksityiskohtaisen näkymän, jossa näkyy tärkeimmät tiedot kyseisestä radiosta. Katso [Radiot](nodes) saadaksesi täydellisen selityksen näytettävistä tiedoista.
|
||||
|
||||
## Status
|
||||
## Tila
|
||||
|
||||
The Status tab summarizes your current connection and mesh status at a glance — useful for confirming you're still connected to your radio without opening your phone.
|
||||
Tila-välilehti näyttää nykyisen yhteyden ja mesh-verkon tilan yhdellä silmäyksellä — hyödyllinen varmistamaan, että olet yhä yhteydessä radioon ilman puhelimen avaamista.
|
||||
|
||||
## Related Topics
|
||||
## Aiheeseen liittyvät aiheet
|
||||
|
||||
- [Messages & Channels](messages-and-channels) — full messaging features on your phone
|
||||
- [Nodes](nodes) — detailed node list and node-detail information
|
||||
- [Connections](connections) — how the app connects to your radio
|
||||
- [Viestit ja kanavat](messages-and-channels) — kaikki viestitoiminnot puhelimessa
|
||||
- [Radiot](nodes) — yksityiskohtainen radiolista ja radion tietonäkymä
|
||||
- [Yhteydet](connections) — miten sovellus yhdistyy radioon
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -1,63 +1,63 @@
|
||||
---
|
||||
title: App Functions
|
||||
title: Sovellustoiminnot
|
||||
parent: Käyttöopas
|
||||
nav_order: 19
|
||||
last_updated: 2026-06-11
|
||||
description: Expose mesh capabilities to the Android system and on-device AI assistants (e.g. Gemini) so they can run mesh workflows without opening the app.
|
||||
description: Tuo mesh-ominaisuudet Android-järjestelmälle ja laitteessa toimiville tekoälyavustajille (esim. Gemini), jotta ne voivat suorittaa mesh-toimintoja ilman sovelluksen avaamista.
|
||||
aliases:
|
||||
- app-functions
|
||||
- system-ai
|
||||
- sovellustoiminnot
|
||||
- järjestelmä-ai
|
||||
- gemini
|
||||
- assistant-functions
|
||||
- assistenttitoiminnot
|
||||
---
|
||||
|
||||
# App Functions
|
||||
# Sovellustoiminnot
|
||||
|
||||
App Functions expose Meshtastic capabilities to the Android system and to on-device AI assistants (such as Gemini) through the Android App Functions API. With them enabled, an assistant can discover and trigger mesh workflows for you — for example sending a message or checking your mesh status — without you opening the app.
|
||||
Sovellustoiminnot tuovat Meshtastic-ominaisuudet Android-järjestelmälle ja laitteessa toimiville tekoälyavustajille (kuten Gemini) Android App Functions -rajapinnan kautta. Kun ne ovat käytössä, avustaja voi löytää ja käynnistää mesh-toimintoja puolestasi — esimerkiksi lähettää viestin tai tarkistaa mesh-tilan — ilman että avaat sovellusta.
|
||||
|
||||
> ⚠️ **Note:** App Functions are available on **Google-flavor Android builds only**.
|
||||
> ⚠️ **Huom:** Sovellustoiminnot ovat saatavilla vain **Google-version Android-laitteissa**.
|
||||
|
||||
> ⚠️ **Note:** This is separate from the in-app **Chirpy** assistant. App Functions let the _system_ AI assistant act on your mesh; Chirpy is a conversational assistant inside the Meshtastic app itself.
|
||||
> ⚠️ **Huom:** Tämä on erillinen in-app **Chirpy** -avustajasta. Sovellustoiminnot mahdollistavat sen, että _järjestelmän_ tekoälyavustaja voi toimia mesh-verkon kautta; Chirpy on Meshtastic-sovelluksen sisäinen keskusteluavustaja.
|
||||
|
||||
## Enabling App Functions
|
||||
## Sovellustoimintojen käyttöönotto
|
||||
|
||||
App Functions are controlled from **Settings → System AI** (the in-app screen is labeled "System AI"). The screen has:
|
||||
Sovellustoimintoja hallitaan kohdasta **Asetukset → Järjestelmän tekoäly** (sovelluksen näkymän nimi on "Järjestelmän tekoäly"). Näyttö sisältää:
|
||||
|
||||
- A **master toggle** labeled **"Allow AI access"**, with the subtitle _"Let system AI assistants (e.g. Gemini) discover and use mesh functions"_. When off, no functions are exposed to the system.
|
||||
- An **individual toggle for each function**, so you can expose only the capabilities you want.
|
||||
- **Pääkytkin**, nimeltään **"Salli tekoälyn käyttö"**, ja alaotsikko _"Salli järjestelmän tekoälyavustajien (esim. Gemini) löytää ja käyttää mesh-toimintoja"_. Kun pois käytöstä, toimintoja ei jaeta järjestelmälle.
|
||||
- Yksittäinen kytkin jokaiselle toiminnolle, jotta voit paljastaa vain haluamasi ominaisuudet.
|
||||
|
||||
The functions are grouped into a **Write** section (functions that change something or send data to your mesh) and a **Read** section (functions that only return information).
|
||||
Toiminnot on jaettu **Kirjoita**-osioon (toiminnot, jotka muuttavat jotakin tai lähettävät dataa mesh-verkkoon) ja **Lue**-osioon (toiminnot, jotka palauttavat vain tietoa).
|
||||
|
||||
|
||||
|
||||
|
||||
### Write Functions
|
||||
### Kirjoitustoiminnot
|
||||
|
||||
| Function | What it does |
|
||||
| ---------------- | ----------------------------------------------------------------------------------------------------------------------- |
|
||||
| **Send Message** | Sends a text message to a contact (direct message) or to a channel, up to 237 bytes. |
|
||||
| Toiminto | Mitä se tekee |
|
||||
| ----------------- | ---------------------------------------------------------------------------------------------------------------------- |
|
||||
| **Lähetä viesti** | Lähettää tekstiviestin kontaktille (suora viesti) tai kanavaan, enintään 237 tavua. |
|
||||
|
||||
### Read Functions
|
||||
### Lukutoiminnot
|
||||
|
||||
| Function | What it returns |
|
||||
| ----------------------- | ----------------------------------------------------------- |
|
||||
| **Get Mesh Status** | Overall mesh status. |
|
||||
| **Get Node List** | The list of nodes on your mesh. |
|
||||
| **Get Channel Info** | Information about your channels. |
|
||||
| **Get Device Status** | Status of your connected radio. |
|
||||
| **Get Node Details** | Detailed information about a specific node. |
|
||||
| **Get Recent Messages** | Recent messages from your conversations. |
|
||||
| **Get Unread Summary** | A summary of unread messages. |
|
||||
| **Get Mesh Metrics** | Telemetry and metrics from your mesh. |
|
||||
| Toiminto | Mitä se palauttaa |
|
||||
| -------------------------------- | ----------------------------------------------------------- |
|
||||
| **Hae mesh-verkko-tila** | Koko mesh-verkon tila. |
|
||||
| **Hae radiolista** | Mesh-verkon radiolista. |
|
||||
| **Hae kanavatiedot** | Tietoa kanavistasi. |
|
||||
| **Hae laitteen tila** | Yhdistetyn radion tila. |
|
||||
| **Hae radion tiedot** | Yksityiskohtaiset tiedot tietystä radiosta. |
|
||||
| **Hae viimeisimmät viestit** | Viimeisimmät viestisi keskusteluista. |
|
||||
| **Hae lukemattomien yhteenveto** | Yhteenveto lukemattomista viesteistä. |
|
||||
| **Hae mesh-metriikat** | Mesh-verkon telemetria ja metriikat. |
|
||||
|
||||
## Privacy
|
||||
## Yksityisyys
|
||||
|
||||
> 🔒 **Privacy:** The **Send Message** function lets an assistant send messages to your mesh on your behalf. Only enable functions you trust the assistant to use. The read functions expose node, message, and metric data to the assistant — enable only what you're comfortable sharing. Each function has its own toggle, and the master toggle turns all of them off at once.
|
||||
> 🔒 **Tietosuoja:** **Lähetä viesti** -toiminnon avulla avustaja voi lähettää viestejä mesh-verkkoosi puolestasi. Ota käyttöön vain ne toiminnot, joihin luotat avustajan saavan käyttää. Lukutoiminnot tuovat radion, viestien ja metriikoiden tiedot avustajan käyttöön — ota käyttöön vain se, mitä haluat jakaa. Jokaisella toiminnolla on oma kytkin, ja pääkytkin poistaa kaikki käytöstä kerralla.
|
||||
|
||||
## Related Topics
|
||||
## Aiheeseen liittyvät aiheet
|
||||
|
||||
- [Messages & Channels](messages-and-channels) — sending messages directly in the app
|
||||
- [Nodes](nodes) — the node list the read functions draw from
|
||||
- [Node Metrics](node-metrics) — the telemetry behind Get Mesh Metrics
|
||||
- [Viestit ja kanavat](messages-and-channels) — viestien lähettäminen suoraan sovelluksessa
|
||||
- [Radiot](nodes) — radiolista, josta lukutoiminnot hakevat tiedot
|
||||
- [Radiometriikat](node-metrics) — telemetria, jonka pohjalta **Hae mesh-metriikat** muodostuu
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -1,126 +1,126 @@
|
||||
---
|
||||
title: Yhteydet
|
||||
parent: User Guide
|
||||
parent: Käyttöopas
|
||||
nav_order: 2
|
||||
last_updated: 2026-05-20
|
||||
description: Connect your phone or desktop to a Meshtastic radio via Bluetooth, USB, or TCP/IP.
|
||||
description: Yhdistä puhelin tai työpöytä Meshtastic-radioon Bluetoothin, USB:n tai TCP/IP:n kautta.
|
||||
aliases:
|
||||
- bluetooth
|
||||
- usb
|
||||
- tcp
|
||||
- pairing
|
||||
- pariliitos
|
||||
---
|
||||
|
||||
# Yhteydet
|
||||
|
||||
Meshtastic supports multiple transport methods to communicate between your phone/desktop and a radio node.
|
||||
Meshtastic tukee useita siirtotapoja puhelimen/työpöydän ja radion välillä viestimiseen.
|
||||
|
||||
## Bluetooth (BLE)
|
||||
|
||||
Bluetooth Low Energy is the default and most common connection method on Android.
|
||||
Bluetooth Low Energy on oletus ja yleisin yhteystapa Androidilla.
|
||||
|
||||
### Pairing a Device
|
||||
### Laitteen pariliitos
|
||||
|
||||
1. Ensure your Meshtastic radio is powered on and in pairing mode.
|
||||
2. Open the app and navigate to the **Connect** tab.
|
||||
3. Tap **Scan for Devices** — nearby Meshtastic radios will appear.
|
||||
4. Select your device from the list.
|
||||
5. Accept the Bluetooth pairing prompt if shown.
|
||||
1. Varmista, että Meshtastic-radio on päällä ja paritustilassa.
|
||||
2. Avaa sovellus ja siirry **Yhdistä**-välilehdelle.
|
||||
3. Paina **Etsi laitteita** — lähellä olevat Meshtastic-radiot tulevat näkyviin.
|
||||
4. Valitse laitteesi listasta.
|
||||
5. Hyväksy Bluetooth-pariliitospyyntö, jos se tulee näkyviin.
|
||||
|
||||
|
||||
|
||||
|
||||
You can filter devices by transport type using the filter chips at the top:
|
||||
Voit suodattaa laitteita yhteystavan mukaan yläreunan suodatinpainikkeilla:
|
||||
|
||||
|
||||
|
||||
|
||||
> 💡 **Tip:** If your device doesn't appear, check that Bluetooth and Location permissions are granted, and that the radio is not already connected to another device.
|
||||
> 💡 **Vinkki:** Jos laitteesi ei näy, varmista että Bluetooth ja sijaintiluvat on myönnetty ja että radio ei ole jo yhdistettynä toiseen laitteeseen.
|
||||
|
||||
### Connection Status
|
||||
### Yhteyden tila
|
||||
|
||||
| Icon | State | Kuvaus |
|
||||
| ---- | -------------- | ----------------------------- |
|
||||
| 🟢 | Yhdistetty | Active radio link established |
|
||||
| 🟡 | Yhdistetään | Handshake in progress |
|
||||
| 🔴 | Ei yhdistetty | No active connection |
|
||||
| ⚪ | Not configured | Ei laitetta valittuna |
|
||||
| Ikoni | Tila | Kuvaus |
|
||||
| ----- | ------------- | ---------------------------------- |
|
||||
| 🟢 | Yhdistetty | Aktiivinen radiolinkki muodostettu |
|
||||
| 🟡 | Yhdistetään | Yhteyden muodostus käynnissä |
|
||||
| 🔴 | Ei yhdistetty | Ei aktiivista yhteyttä |
|
||||
| ⚪ | Ei määritetty | Ei laitetta valittuna |
|
||||
|
||||
When connecting, a status indicator shows the current connection state:
|
||||
Yhdistettäessä tilailmaisin näyttää nykyisen yhteyden tilan:
|
||||
|
||||
|
||||
|
||||
|
||||
If no devices are found, the app shows an empty state with instructions:
|
||||
Jos laitteita ei löydy, sovellus näyttää tyhjän näkymän ohjeiden kanssa:
|
||||
|
||||
|
||||
|
||||
|
||||
### Troubleshooting Bluetooth
|
||||
### Bluetoothin vianmääritys
|
||||
|
||||
- **Device not found:** Toggle Bluetooth off/on, ensure location is enabled.
|
||||
- **Connection drops:** Move closer to the radio; check for interference.
|
||||
- **Pairing rejected:** Forget the device in Android Bluetooth settings and retry.
|
||||
- **Laitetta ei löydy:** Kytke Bluetooth pois/päälle ja varmista, että sijainti on käytössä.
|
||||
- **Yhteys katkeaa:** Siirry lähemmäs radiota ja tarkista mahdolliset häiriöt.
|
||||
- **Paritus hylätty:** Poista laite Androidin Bluetooth-asetuksista ja yritä uudelleen.
|
||||
|
||||
## USB Serial
|
||||
## USB-sarjaporttiyhteys
|
||||
|
||||
USB connections provide a wired alternative, useful for desktop or when Bluetooth is unavailable.
|
||||
|
||||
### Setup
|
||||
|
||||
1. Connect your radio via USB cable to your device.
|
||||
2. The app will prompt for USB permission — tap **Allow**.
|
||||
3. The connection is established automatically.
|
||||
|
||||
> ⚠️ **Note:** USB connections require OTG support on Android devices.
|
||||
|
||||
## TCP/IP (WiFi)
|
||||
|
||||
Some Meshtastic radios support WiFi connectivity, allowing TCP-based connections.
|
||||
USB-yhteydet tarjoavat langallisen vaihtoehdon, hyödyllinen työpöytäkäytössä tai kun Bluetooth ei ole käytettävissä.
|
||||
|
||||
### Asetukset
|
||||
|
||||
1. Connect your radio to a WiFi network via the radio's web interface or settings.
|
||||
2. In the app, go to **Connect → TCP**.
|
||||
3. Enter the radio's IP address and port (default: 4403).
|
||||
4. Tap **Connect**.
|
||||
1. Yhdistä radio USB-kaapelilla laitteeseesi.
|
||||
2. Sovellus pyytää USB-oikeuksia — paina **Salli**.
|
||||
3. Yhteys muodostetaan automaattisesti.
|
||||
|
||||
|
||||
> ⚠️ **Huom:** USB-yhteydet vaativat OTG-tuen Android-laitteissa.
|
||||
|
||||
When a device is found, it appears in the connection list:
|
||||
## TCP/IP (WiFi)
|
||||
|
||||
|
||||
Jotkin Meshtastic-radiot tukevat WiFi-yhteyttä, jolloin yhteys voidaan muodostaa TCP:n kautta.
|
||||
|
||||
A successful connection is confirmed with a status indicator:
|
||||
### Asetukset
|
||||
|
||||
|
||||
1. Yhdistä radio WiFi-verkkoon radion web-käyttöliittymän tai asetusten kautta.
|
||||
2. Sovelluksessa siirry kohtaan **Yhdistä → TCP**.
|
||||
3. Syötä radion IP-osoite ja portti (oletus: 4403).
|
||||
4. Paina **Yhdistä**.
|
||||
|
||||
### When to Use TCP
|
||||
|
||||
|
||||
- Radio is on the same local network
|
||||
- Testing with a simulated radio
|
||||
- Environments where Bluetooth has interference issues
|
||||
Kun laite löytyy, se näkyy yhteyslistassa:
|
||||
|
||||
## Reconnection Behavior
|
||||
|
||||
|
||||
The app reconnects to the **last selected device** on startup. You can switch transports from the Connect screen at any time.
|
||||
Onnistunut yhteys vahvistetaan tilailmaisimella:
|
||||
|
||||
To disconnect, tap the disconnect button on the Connect screen:
|
||||
|
||||
|
||||
|
||||
### Milloin TCP-yhteyttä kannattaa käyttää
|
||||
|
||||
## Desktop Connections
|
||||
- Radio on samassa lähiverkossa
|
||||
- Testaus simuloidulla radiolla
|
||||
- Ympäristöt, joissa Bluetoothissa on häiriöongelmia
|
||||
|
||||
On Desktop (Linux/macOS/Windows), the app supports:
|
||||
## Uudelleenyhdistämisen toiminta
|
||||
|
||||
- **Bluetooth (BLE)** — via the Kable library; works on macOS, Linux, and Windows
|
||||
- **USB Serial** — primary wired connection method
|
||||
- **TCP/IP** — for network-connected radios
|
||||
Sovellus yhdistyy käynnistyksen yhteydessä **viimeksi valittuun laitteeseen**. Voit vaihtaa yhteystapaa Yhdistä-näkymästä milloin tahansa.
|
||||
|
||||
See [Desktop App](desktop) for platform-specific details and keyboard shortcuts.
|
||||
Yhteyden katkaisemiseksi paina Yhdistä-näkymän katkaisupainiketta:
|
||||
|
||||
## Related Topics
|
||||
|
||||
|
||||
- [Getting Started](onboarding) — first-launch setup and permissions
|
||||
- [Settings — Radio & User](settings-radio-user) — Bluetooth and network configuration
|
||||
- [Desktop App](desktop) — desktop-specific connection details
|
||||
- [Supported devices](https://meshtastic.org/docs/hardware/devices) — full list of compatible radios on meshtastic.org
|
||||
## Työpöytäyhteydet
|
||||
|
||||
Työpöydällä (Linux/macOS/Windows) sovellus tukee:
|
||||
|
||||
- **Bluetooth (BLE)** — Kable-kirjaston kautta; toimii macOS:llä, Linuxilla ja Windowsilla
|
||||
- **USB-sarjaportti** — ensisijainen langallinen yhteystapa
|
||||
- **TCP/IP** — verkkoyhteydellä oleville radioille
|
||||
|
||||
Katso [Työpöytäsovellus](desktop) alustakohtaiset tiedot ja pikanäppäimet.
|
||||
|
||||
## Aiheeseen liittyvät aiheet
|
||||
|
||||
- [Aloitus](onboarding) — ensikäynnistyksen käyttöönotto ja käyttöoikeudet
|
||||
- [Asetukset — Radio & käyttäjä](settings-radio-user) — Bluetooth- ja verkkoasetukset
|
||||
- [Työpöytäsovellus](desktop) — työpöytäkohtaiset yhteystiedot
|
||||
- [Tuetut laitteet](https://meshtastic.org/docs/hardware/devices) — täydellinen lista yhteensopivista radioista meshtastic.org -sivustolla
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -1,124 +1,124 @@
|
||||
---
|
||||
title: Desktop App
|
||||
parent: User Guide
|
||||
title: Työpöytäsovellus
|
||||
parent: Käyttöopas
|
||||
nav_order: 14
|
||||
last_updated: 2026-06-11
|
||||
description: Install and use the Meshtastic Desktop app on Linux, macOS, and Windows — connections, feature parity, and keyboard shortcuts.
|
||||
description: Asenna ja käytä Meshtastic-työpöytäsovellusta Linuxilla, macOS:llä ja Windowsilla — yhteydet, ominaisuuksien yhtenevyys ja pikanäppäimet.
|
||||
aliases:
|
||||
- desktop
|
||||
- työpöytä
|
||||
- linux
|
||||
- macos
|
||||
- windows
|
||||
- jvm
|
||||
---
|
||||
|
||||
# Desktop App
|
||||
# Työpöytäsovellus
|
||||
|
||||
The Meshtastic Desktop application shares its core codebase with Android via Kotlin Multiplatform. Most features work identically on Linux, macOS, and Windows.
|
||||
Meshtastic-työpöytäsovellus jakaa ydinkoodipohjan Android-version kanssa Kotlin Multiplatformin kautta. Useimmat ominaisuudet toimivat identtisesti Linuxilla, macOS:llä ja Windowsilla.
|
||||
|
||||
## Asennus
|
||||
|
||||
### Linux
|
||||
|
||||
- Download the `.deb` or `.AppImage` package from the releases page
|
||||
- Or build from source using `./gradlew :desktopApp:run`
|
||||
- Lataa `.deb`- tai `.AppImage`-paketti julkaisusivulta
|
||||
- Tai rakenna lähdekoodista komennolla `./gradlew :desktopApp:run`
|
||||
|
||||
### macOS
|
||||
|
||||
- Download the `.dmg` package from releases
|
||||
- Or build from source
|
||||
- Lataa `.dmg`-paketti julkaisusivulta
|
||||
- Tai rakenna lähdekoodista
|
||||
|
||||
### Windows
|
||||
|
||||
- Download the `.msi` installer from releases
|
||||
- Or build from source
|
||||
- Lataa `.msi`-asennuspaketti julkaisusivulta
|
||||
- Tai rakenna lähdekoodista
|
||||
|
||||
## Connecting Your Radio
|
||||
## Radioon yhdistäminen
|
||||
|
||||
### USB Serial (Primary)
|
||||
### USB-sarjaportti (ensisijainen)
|
||||
|
||||
The most reliable connection method on Desktop:
|
||||
Luotettavin yhteystapa työpöydällä:
|
||||
|
||||
1. Connect your Meshtastic radio via USB cable.
|
||||
2. The app should detect the serial port automatically.
|
||||
3. If not detected, select the correct serial port from the Connect menu.
|
||||
1. Yhdistä Meshtastic-radio USB-kaapelilla.
|
||||
2. Sovelluksen pitäisi tunnistaa sarjaportti automaattisesti.
|
||||
3. Jos laitetta ei tunnisteta, valitse oikea sarjaportti Yhdistä-valikosta.
|
||||
|
||||
### TCP/IP
|
||||
|
||||
For network-connected radios:
|
||||
Verkkoyhteydellä oleville radioille:
|
||||
|
||||
1. Enter the radio's IP address and port (default: 4403).
|
||||
2. Click **Connect**.
|
||||
1. Syötä radion IP-osoite ja portti (oletus: 4403).
|
||||
2. Paina **Yhdistä**.
|
||||
|
||||
### Bluetooth (BLE)
|
||||
|
||||
Bluetooth Low Energy is supported on Desktop via the [Kable](https://github.com/JuulLabs/kable) library:
|
||||
Bluetooth Low Energy on tuettu työpöydällä [Kable](https://github.com/JuulLabs/kable)-kirjaston kautta:
|
||||
|
||||
1. Ensure your system has a Bluetooth adapter.
|
||||
2. The app scans for nearby Meshtastic radios automatically.
|
||||
3. Select your device from the Connect screen.
|
||||
1. Varmista, että järjestelmässäsi on Bluetooth-adapteri.
|
||||
2. Sovellus etsii lähellä olevia Meshtastic-radioita automaattisesti.
|
||||
3. Valitse laitteesi Yhdistä-näkymästä.
|
||||
|
||||
## Feature Parity
|
||||
## Ominaisuuksien yhtenevyys
|
||||
|
||||
| Feature | Android | Desktop | Viestit |
|
||||
| -------------------------------------------- | ------- | ------- | ---------------------------------------------- |
|
||||
| Messaging | ✓ | ✓ | Full parity |
|
||||
| Node List | ✓ | ✓ | Full parity |
|
||||
| Kartta | ✓ | ✓ | Full parity |
|
||||
| Asetukset | ✓ | ✓ | Full parity |
|
||||
| Bluetooth (BLE) | ✓ | ✓ | Via Kable on desktop |
|
||||
| Firmware Update OTA | ✓ | ✗ | Use web flasher |
|
||||
| Notifications | ✓ | ✓ | Native OS notifications |
|
||||
| Widgets | ✓ | ✗ | Android-only |
|
||||
| Android Auto | ✓ | ✗ | Android-only — not available on Desktop or iOS |
|
||||
| AI Assistant (Chirpy) | ✓\* | ✗ | Google flavor Android only |
|
||||
| App Functions (system AI) | ✓† | ✗ | Google flavor Android only |
|
||||
| Ominaisuus | Android | Työpöytä | Viestit |
|
||||
| ----------------------------------------------------------- | ------- | -------- | -------------------------------------------------------------------- |
|
||||
| Viestit | ✓ | ✓ | Täysi yhtenevyys |
|
||||
| Radiolista | ✓ | ✓ | Täysi yhtenevyys |
|
||||
| Kartta | ✓ | ✓ | Täysi yhtenevyys |
|
||||
| Asetukset | ✓ | ✓ | Täysi yhtenevyys |
|
||||
| Bluetooth (BLE) | ✓ | ✓ | Työpöydällä Kable-kirjaston kautta |
|
||||
| Laiteohjelmistopäivitys OTA | ✓ | ✗ | Käytä web-flasheria |
|
||||
| Ilmoitukset | ✓ | ✓ | Käyttöjärjestelmän natiivit ilmoitukset |
|
||||
| Widgetit | ✓ | ✗ | Vain Android |
|
||||
| Vain Android | ✓ | ✗ | Vain Android — ei saatavilla työpöydällä tai iOS:llä |
|
||||
| Tekoälyavustaja (Chirpy) | ✓\* | ✗ | Vain Google-version Android-laitteissa |
|
||||
| Sovellustoiminnot (järjestelmän tekoäly) | ✓† | ✗ | Vain Google-version Android-laitteissa |
|
||||
|
||||
\*Chirpy AI requires Android 14+ on Google flavor builds with supported hardware.
|
||||
\*Chirpy AI vaatii Android 14+ -version Google-version Android-laitteissa, joissa on tuettu laitteisto.
|
||||
|
||||
†App Functions exposes app actions to the Android system AI on Google flavor builds. See [App Functions](app-functions).
|
||||
†Sovellustoiminnot tuo sovellustoiminnot Android-järjestelmän tekoälylle Google-version Android-laitteissa. Katso [Sovellustoiminnot](app-functions).
|
||||
|
||||
## UI Differences
|
||||
## Käyttöliittymäerot
|
||||
|
||||
The Desktop app uses the same Compose Multiplatform UI with adaptations for larger screens and desktop interaction.
|
||||
Työpöytäsovellus käyttää samaa Compose Multiplatform -käyttöliittymää, mutta se on mukautettu suuremmille näytöille ja työpöytäkäyttöön.
|
||||
|
||||
### Keyboard Shortcuts
|
||||
### Pikanäppäimet
|
||||
|
||||
| Shortcut | Action |
|
||||
| ------------------- | ---------------------- |
|
||||
| **⌘Q** / **Ctrl+Q** | Quit the application |
|
||||
| **⌘,** / **Ctrl+,** | Open Settings |
|
||||
| **⌘1** / **Ctrl+1** | Switch to Messages tab |
|
||||
| **⌘2** / **Ctrl+2** | Switch to Nodes tab |
|
||||
| **⌘3** / **Ctrl+3** | Switch to Map tab |
|
||||
| **⌘4** / **Ctrl+4** | Switch to Connect tab |
|
||||
| Pikanäppäin | Toiminto |
|
||||
| ------------------- | --------------------------- |
|
||||
| **⌘Q** / **Ctrl+Q** | Sulje sovellus |
|
||||
| **⌘,** / **Ctrl+,** | Avaa asetukset |
|
||||
| **⌘1** / **Ctrl+1** | Vaihda Viestit-välilehdelle |
|
||||
| **⌘2** / **Ctrl+2** | Vaihda Radiot-välilehdelle |
|
||||
| **⌘3** / **Ctrl+3** | Vaihda Kartta-välilehdelle |
|
||||
| **⌘4** / **Ctrl+4** | Vaihda Yhdistä-välilehdelle |
|
||||
|
||||
### Window & System Tray
|
||||
### Ikkuna ja järjestelmätarjotin
|
||||
|
||||
- **Window resizing** — responsive layout adapts to window dimensions
|
||||
- **System tray** — minimize to system tray for background mesh operation
|
||||
- **Tray menu** — right-click the tray icon to show window or quit
|
||||
- **Mouse interaction** — hover states and standard desktop navigation
|
||||
- **Ikkunan koon muuttaminen** — responsiivinen asettelu mukautuu ikkunan kokoon
|
||||
- **Järjestelmätarjotin** — pienennä järjestelmätarjottimeen taustalla tapahtuvaa mesh-toimintaa varten
|
||||
- **Valikko** — napsauta järjestelmätarjottimen kuvaketta hiiren oikealla näyttääksesi ikkunan tai sulkeaksesi sovelluksen
|
||||
- **Hiiritoiminnot** — hover-tilat ja tavallinen työpöydän navigointi
|
||||
|
||||
### Notification Preferences
|
||||
### Ilmoitusasetukset
|
||||
|
||||
The Desktop app provides in-app toggles for controlling which notifications are shown — messages, new nodes, and low battery alerts. Access these from **Settings → Notifications** within the app.
|
||||
Työpöytäsovellus tarjoaa sisäiset kytkimet ilmoitusten hallintaan — viestit, uudet radiot ja alhaisen akun varoitukset. Avaa nämä kohdasta **Asetukset → Ilmoitukset** sovelluksessa.
|
||||
|
||||
## Built-in Documentation Browser
|
||||
## Sisäänrakennettu dokumentaatioselain
|
||||
|
||||
The Desktop app includes a built-in documentation browser for quick access to help content without leaving the application.
|
||||
Työpöytäsovellus sisältää sisäänrakennetun dokumentaatioselaimen, jonka avulla ohjeisiin pääsee nopeasti poistumatta sovelluksesta.
|
||||
|
||||
|
||||
|
||||
|
||||
The browser supports full-text search across all documentation:
|
||||
Selain tukee koko dokumentaation laajuista kokotekstihakua:
|
||||
|
||||
|
||||
|
||||
|
||||
Individual doc pages render with full formatting:
|
||||
Yksittäiset dokumenttisivut renderöidään täydellä muotoilulla:
|
||||
|
||||
|
||||
|
||||
|
||||
## Building from Source
|
||||
## Rakentaminen lähdekoodista
|
||||
|
||||
```bash
|
||||
git clone https://github.com/meshtastic/Meshtastic-Android.git
|
||||
@@ -127,22 +127,22 @@ git submodule update --init
|
||||
./gradlew :desktopApp:run
|
||||
```
|
||||
|
||||
Requirements:
|
||||
Vaatimukset:
|
||||
|
||||
- JDK 21
|
||||
- No Android SDK required for desktop-only builds
|
||||
- Android SDK:ta ei tarvita pelkkien työpöytäversioiden rakentamiseen
|
||||
|
||||
## Known Limitations
|
||||
## Tunnetut rajoitukset
|
||||
|
||||
- No OTA firmware updates (use web flasher)
|
||||
- Some Android-specific features (widgets, specific notification channels) are unavailable
|
||||
- Performance may vary on low-spec hardware running Compose Desktop
|
||||
- BLE bonding is not yet supported on desktop (pairing works without bonding)
|
||||
- Ei OTA-laiteohjelmistopäivityksiä (käytä web-flasheria)
|
||||
- Jotkin Android-kohtaiset ominaisuudet (widgetit, tietyt ilmoituskanavat) eivät ole käytettävissä
|
||||
- Suorituskyky voi vaihdella heikkotehoisella laitteistolla ajettaessa Compose Desktopia
|
||||
- BLE-paritus ei vielä tallenna laiteparia työpöydällä (paritus toimii ilman tallennusta)
|
||||
|
||||
## Related Topics
|
||||
## Aiheeseen liittyvät aiheet
|
||||
|
||||
- [Connections](connections) — connection methods overview
|
||||
- [Firmware Updates](firmware) — use the [Web Flasher](https://flasher.meshtastic.org) for desktop firmware updates
|
||||
- [Yhteydet](connections) — yhteystapojen yleiskatsaus
|
||||
- [Laiteohjelmistopäivitykset](firmware) — käytä [Web Flasheria](https://flasher.meshtastic.org) työpöydän laiteohjelmistopäivityksiin
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user