Companion configureren
Deze pagina legt uit hoe je een companion installeert en configureert voor gebruik.
Liever visueel? Deze video loopt door alle stappen heen.
Wat heb je nodig?
Hardware
- Een geschikt Meshcore apparaat
- Een laptop of andere computer voor het klaarmaken van het apparaat
- Een laptop of telefoon voor de Meshcore app (tenzij je een apparaat met ingebouwd toetsenbordje gaat gebruiken)
- Een USB data kabel om apparaat en laptop te verbinden
Software
- Meshcore companion firmware, te installeren via een web-flasher
- Meshcore app voor je laptop of telefoon
Bluetooth, USB of wifi?
De koppeling tussen de meshcore app en je companion node kan op drie manieren. Je moet kiezen welke manier je wilt gebruiken, want dit bepaalt de keuze voor de firmware! Twijfel je, kies dan bluetooth. In de stappen hieronder gaan we uit van bluetooth.
Bluetooth (BLE)
Beginnersvriendelijk, voldoet in de meeste gevallen. De USB kabel heb je alleen nodig voor het flashen van de firmware en om je companion node op te laden.
USB
Altijd een USB kabel nodig tussen je laptop/telefoon en je companion node. Deze versie ondersteunt geen bluetooth.
Wifi
Voor gevorderden. Reikt wat verder dan bluetooth. Handig als je je companion op een hoge plaats wilt zetten voor een goede radioverbinding, en dan toch beneden op de bank met je laptop of telefoon verbinding wilt. Maar niet alle apparaten ondersteunen wifi. En je hebt ook speciale firmware nodig om wifi te ondersteunen, bijvoorbeeld de Infinity edition of Weebl firmware.
Aan de slag
Voordat je begint: zorg dat de antenne op je apparaat is aangesloten! Een apparaat zonder antenne in gebruik nemen kan het beschadigen.
Deel 1: Firmware installeren (flashen)
Stap 1
Verbind je apparaat met je laptop met behulp van de USB kabel.
Stap 2
Gebruik je Linux? Maak dan je gebruikersaccount lid van de groep "dialout". Daarna moet je uitloggen en weer inloggen. Dan mag je via USB communiceren.
Stap 3
Open de Chrome browser in je laptop en ga naar https://flasher.meshcore.io/. Let op: gebruik Chrome, Chromium, Brave of een andere browser die USB verbindingen ondersteunt. Veel andere browsers doen dat niet.
Stap 4
Kies het juiste apparaat uit de lijst. Als je met de muis over een apparaat gaat, zie je een illustratie hoe het apparaat eruit ziet. Je kunt ook de lijst filteren op trefwoord. Je hebt de juiste firmware voor je apparaat nodig, anders werkt het niet.
Stap 5
Kies "Companion Bluetooth". Pas op: veel mensen kiezen "Companion USB" vanuit de gedachte dat ze nu verbinding hebben met USB, maar de "Companion USB" spreekt geen bluetooth!
Stap 6
Als er een knop met "Enter DFU mode" is, klik er op. DFU = device firmware update. De browser vraagt vervolgens: "flasher.meshcore.io wil verbinden met een seriële poort". Kies het apparaat uit de lijst. Als je de naam van het apparaat niet herkent, kies dan degene met "usbmodem" in de naam. Klik dan op de knop "Verbinding maken". Als het goed is, is de knop "Enter DFU mode" veranderd in "DFU mode active".
Is er geen knop met "Enter DFU mode"? Dan moet je even opzoeken hoe je je device in DFU mode zet. Soms doe je dat met knopjes op je device zelf.
Opmerking: Als je een update doet, klik dan NIET op "Erase flash". Dan wordt echt alles gewist, dus je identiteit, je contacten, je berichten, je kanalen en je instellingen.
Stap 7
Klik op de knop "Flash". Je moet opnieuw het apparaat kiezen. Als het goed gaat, staat er "Flashing..." en zie je een voortgangsbalk. Als het flashen voltooid is, staat er "Flashing complete!".
Deel 2: Meshcore app installeren en verbinden met de companion
De Meshcore app is er voor:
- Android
- iOS
- Windows
- MacOS
- Linux
- Er is ook een web-app die op vrijwel elk platform draait.
Je kunt ze downloaden/installeren vanaf https://meshcore.io/#download.
In dit voorbeeld gaan we uit van de web app.
Stap 8
Open de app, bijvoorbeeld de web app op https://app.meshcore.nz/. Je kan ook op de flasher pagina klikken op "Launch app".
Als het goed is staat er "MeshCore" en "verbinding verbroken" en "niet verbonden".
Stap 9
Klik op "Verbinden". Er staat nu "Verbinden via Bluetooth".
Stap 10
Klik op "Nu scannen" en kies je apparaat uit de lijst van beschikbare bluetooth apparaten. Het kan een paar seconden duren. Als er wordt gevraagd om de bluetooth code, lees dan de code van het beeldschermpje van je apparaat. Heeft je apparaat geen beeldscherm, gebruik dan code 123456.
De eerste keer dat je je companion gebruikt, staat er waarschijnlijk "Welkom bij MeshCore - Laten we je nieuwe apparaat instellen!" Klik dan op volgende.
Stap 11
Kies een naam voor je companion. Met deze naam word je zichtbaar als je berichten verstuurt in het MeshCore netwerk.
Je kan een emoji gebruiken. Die wordt dan gebruikt als avatar. Let op: emoji's nemen 4 tekens in beslag, en de ruimte is beperkt.
Klik op volgende. Op het scherm staat nu "Radio-instellingen kiezen".
Stap 12
- In Nederland, kies "Netherlands" uit de lijst van radio-instellingen.
- In Limburg, België en Duitsland, kies "EU/UK (Narrow)".
Klik daarna op volgende. Als het goed is staat er nu "Installatie voltooid". Maar we zijn nog niet helemaal klaar!
Deel 3: Overige instellingen
Als het goed is zie je nu een scherm met contacten. Voordat we hiermee aan de slag gaan, stellen we eerst even een paar dingen in.
Ga naar het ⚙️ tandwiel rechtsboven. Je komt dan in de Instellingen. We gaan de volgende dingen instellen:
- Openbare informatie
- Positie delen in advertentie: niet inschakelen. Dat is om je privacy te beschermen.
- Radio-instellingen
- Zendvermogen LoRa-chip (dBm): 22 is voor de meeste apparaten de maximumwaarde en een goed startpunt. Heb je prima verbindingen met de repeaters om je heen, dan kun je deze waarde wat lager zetten om batterij te sparen.
- Netwerk instellingen
- Standaard hashgrootte van pad: 3-byte. 2-byte mag ook, maar 1-byte wordt door veel repeaters geblokkeerd dus is af te raden. Deze waarde bepaalt hoe goed jouw berichten door de mesh te traceren zijn en dat is heel fijn als je wilt zien tot waar je berichten komen.
- Standaardregio: aanklikken
- Klik rechtsboven op de drie puntjes ⠇
- Kies in het menu "Regio's ontdekken" en dan op de knop "Regio's ontdekken"
- Vink alle regio's aan
- Klik op <- om terug te gaan
- Kies regio "nl" uit de lijst om als standaard in te stellen
- Contactinstellingen
- Kies Geselecteerde automatische toevoegen (dat is om te voorkomen dat je adresboek volloopt met informatie die niet relevant is)
- Repeaters automatisch toevoegen: ☑ aan
- Oudste overschrijven: ☑ aan
- Maximaal aantal hops voor automatisch toevoegen: 2 (meer mag ook maar dan wordt je contactenlijst flink gevuld met namen van repeaters)
- Klik op ✓ rechtsboven om op te slaan.
- Berichtinstellingen
- Bevestigingen voor directe berichten: 2. Iemand die aan jou berichten stuurt krijgt dan minder vaak te zien dat het mislukt is.
- Sneller als afgeleverd markeren: ☑ aan
- Hops onder kanaalberichten tonen: ☑ aan
- Hashgroottes van kanaalberichtpaden tonen: ☑ aan
- Toon regio scopes voor kanaalberichten: ☑ aan
- Klik op ✓ rechtsboven om op te slaan.
Je companion is nu goed ingesteld en kan gebruikt worden.
Deel 4: Repeaters in de buurt ontdekken
- In het hoofdscherm van de Meshcore app, klik rechtsboven op de drie puntjes ⠇
- Kies in het menu "Hulpmiddelen"
- Kies "Nabijgelegen nodes ontdekken"
- Kies "Repeaters ontdekken". Met een beetje geluk en geduld zie je nu repeaters verschijnen.
- Met ✓ kun je repeaters toevoegen aan je adresboek. Ze worden dan in de app altijd met hun naam weergegeven.
Vind je geen repeaters, probeer dan op een andere plaats in huis, bijvoorbeeld op zolder, of bij het raam. Of probeer het op je werk. Kijk op Troubleshooting voor tips.
Deel 5: Testen
We gaan een testbericht sturen in kanaal #mc-radar.
- Ga naar "Kanalen", midden onderin.
- Klik rechtsboven op de drie puntjes ⠇
- Kies in het menu "Kanaal toevoegen"
- Kies "Deelnemen aan een hashtag-kanaal"
- Vul in: #mc-radar (de # is al ingevuld)
- Klik op "Deelnemen aan kanaal". Je ziet een QR code.
- Klik op "Ga naar kanaal"
- Typ een korte tekst in het vak "Verstuur een bericht" en druk op enter of klik op het papieren vliegtuigje.
Je bericht wordt nu verzonden. Als het goed gaat zie je onder je bericht verschijnen "x herhalingen gehoord". Dat betekent dat repeaters in de buurt jouw bericht gehoord hebben en doorgeven. Is je bericht niet herhaald, kijk dan op Troubleshooting.
Vervolgens kun je op https://mc-radar.woodwar.com/test-inspector bekijken waar je berichtje gekomen is!
Zie ook: MC-Radar