User Tools

Site Tools


links:meshcore:part1

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
links:meshcore:part1 [2026/10/25 20:04] – va7filinks:meshcore:part1 [2026/10/25 20:34] (current) – [To Do] va7fi
Line 11: Line 11:
 This is the first part of the guide.  [[part2 |The second part]] is about repeaters and other more advanced setups. This is the first part of the guide.  [[part2 |The second part]] is about repeaters and other more advanced setups.
 ---- ----
 +
  
 ====== Introduction ====== ====== Introduction ======
Line 109: Line 110:
  
 <WRAP pagebreak /> <WRAP pagebreak />
 +
  
 ===== Connect to your MeshCore Device ===== ===== Connect to your MeshCore Device =====
Line 135: Line 137:
  
 <WRAP pagebreak /> <WRAP pagebreak />
 +
  
 <WRAP group> <WRAP group>
Line 151: Line 154:
 </WRAP> </WRAP>
 </WRAP> </WRAP>
 +
 ==== Public Info ==== ==== Public Info ====
 <WRAP group> <WRAP group>
Line 184: Line 188:
 </WRAP> </WRAP>
 </WRAP> </WRAP>
- 
  
 ==== Network Settings ==== ==== Network Settings ====
Line 207: Line 210:
   * Tap the "''Default Path Hash Size''" and select "''2-byte''" for companions, or "''3-byte''" for repeaters.   * Tap the "''Default Path Hash Size''" and select "''2-byte''" for companions, or "''3-byte''" for repeaters.
   * Tap the <key>✔</key> icon in the top right corner to save the settings.   * Tap the <key>✔</key> icon in the top right corner to save the settings.
- 
  
 ==== Other Settings ==== ==== Other Settings ====
Line 234: Line 236:
 </WRAP> </WRAP>
 </WRAP> </WRAP>
- 
  
 === Position Settings === === Position Settings ===
Line 247: Line 248:
 </WRAP> </WRAP>
 </WRAP> </WRAP>
- 
  
 ==== Extra Tools ==== ==== Extra Tools ====
Line 264: Line 264:
 Finally, let's tap the <key>✔</key> icon in the top right corner one last time to save the settings before exiting. Finally, let's tap the <key>✔</key> icon in the top right corner one last time to save the settings before exiting.
 <WRAP pagebreak /> <WRAP pagebreak />
 +
  
 ===== Contacts ===== ===== Contacts =====
Line 281: Line 282:
 </WRAP> </WRAP>
  
 +==== 1. Advert/Discover ====
  
- +=== Advert ===
- +
-==== 1. Advert/Discover ====+
 <WRAP group> <WRAP group>
 <WRAP twothirds column> <WRAP twothirds column>
-=== Advert === 
 An advert is an unencrypted packet transmitted by your MeshCore node. It includes your node name, location and type, public identity key and a cryptographic signature to prevent anyone from tampering with the information as it’s sent across the mesh. An advert is an unencrypted packet transmitted by your MeshCore node. It includes your node name, location and type, public identity key and a cryptographic signature to prevent anyone from tampering with the information as it’s sent across the mesh.
  
Line 305: Line 304:
 </WRAP> </WRAP>
 </WRAP> </WRAP>
- 
  
 There was a deliberate decision made to [[https://github.com/meshcore-dev/MeshCore/issues/974 |prevent auto advert for companions]] (but not for repeaters).  As such, you should <wrap important>flood advert at least once a week</wrap> so that new users can find and add you to their contact list. There was a deliberate decision made to [[https://github.com/meshcore-dev/MeshCore/issues/974 |prevent auto advert for companions]] (but not for repeaters).  As such, you should <wrap important>flood advert at least once a week</wrap> so that new users can find and add you to their contact list.
Line 313: Line 311:
  
 <WRAP pagebreak /> <WRAP pagebreak />
 +
 === Discover === === Discover ===
 The easiest way to add nodes that are in your neighbourhood to your contact list is to use the map feature.  However, there are three different kinds of maps in MeshCore: The easiest way to add nodes that are in your neighbourhood to your contact list is to use the map feature.  However, there are three different kinds of maps in MeshCore:
Line 321: Line 320:
 {{:links:meshcore:contactlist04.png?200|}} \\ {{:links:meshcore:contactlist04.png?200|}} \\
 1) The map at the bottom of the main page only shows nodes in your contact list. 1) The map at the bottom of the main page only shows nodes in your contact list.
- 
 </WRAP> </WRAP>
 <WRAP third column> <WRAP third column>
Line 327: Line 325:
 {{:links:meshcore:contactlist06.png?200|}} \\ {{:links:meshcore:contactlist06.png?200|}} \\
 2) The map under "Discover Contacts" shows all the nodes that your companion has heard so far. 2) The map under "Discover Contacts" shows all the nodes that your companion has heard so far.
- 
 </WRAP> </WRAP>
 <WRAP third column> <WRAP third column>
 {{:links:meshcore:contactlist07.png?200|}} \\ {{:links:meshcore:contactlist07.png?200|}} \\
 3) The "Internet Map" shows a map of all the nodes heard by "observers" that are shared to the [[https://meshcore.io/map |Internet]]. 3) The "Internet Map" shows a map of all the nodes heard by "observers" that are shared to the [[https://meshcore.io/map |Internet]].
- 
 </WRAP> </WRAP>
 </WRAP> </WRAP>
Line 343: Line 339:
  
 The map will only show users that have not been added yet.  To add them: The map will only show users that have not been added yet.  To add them:
- 
   * Tap on a node   * Tap on a node
   * Under the node's name, tap on "''Add''"   * Under the node's name, tap on "''Add''"
Line 350: Line 345:
  
 The maps only show nodes that have [[#public_info |shared their Position in Advert]].  Nodes that have not shared their location will still show in the list, but you won't be able to tell where they are located.  That's why it's <wrap important>important to share your approximate location</wrap>: so others in your neighbourhood can add you to their contact list. The maps only show nodes that have [[#public_info |shared their Position in Advert]].  Nodes that have not shared their location will still show in the list, but you won't be able to tell where they are located.  That's why it's <wrap important>important to share your approximate location</wrap>: so others in your neighbourhood can add you to their contact list.
- 
  
 <WRAP pagebreak /> <WRAP pagebreak />
- 
  
 ==== 2. QR Code ==== ==== 2. QR Code ====
Line 396: Line 389:
 ==== 3. Link to Clipboard ==== ==== 3. Link to Clipboard ====
 The easiest way to share your contacts via email or SMS is to use a contact link. The easiest way to share your contacts via email or SMS is to use a contact link.
 +
 === Share === === Share ===
 <WRAP group> <WRAP group>
Line 421: Line 415:
   * Tap on "''Import from Clipboard Link''"   * Tap on "''Import from Clipboard Link''"
   * Tap the <key>**✔**</key> icon to add.   * Tap the <key>**✔**</key> icon to add.
- 
 </WRAP> </WRAP>
  
Line 428: Line 421:
 </WRAP> </WRAP>
 </WRAP> </WRAP>
 +
 <WRAP pagebreak /> <WRAP pagebreak />
 +
 ==== 4. In a Channel ==== ==== 4. In a Channel ====
 We haven't discussed Channels yet, so feel free to come back to this section later.   We haven't discussed Channels yet, so feel free to come back to this section later.  
Line 461: Line 456:
  
 <WRAP pagebreak /> <WRAP pagebreak />
- 
- 
- 
  
  
Line 470: Line 462:
 This section is **optional**.  It'll help you understand how channels and private messages work, but it won't show you how to do anything new. Feel free to skip it. This section is **optional**.  It'll help you understand how channels and private messages work, but it won't show you how to do anything new. Feel free to skip it.
 </WRAP> </WRAP>
- 
  
 There are basically two different strategies for encrypting a message: There are basically two different strategies for encrypting a message:
Line 489: Line 480:
  
 ==== MeshCore and Public-key Cryptography ==== ==== MeshCore and Public-key Cryptography ====
- 
 MeshCore uses Public Key Cryptography to: MeshCore uses Public Key Cryptography to:
   * Identify you uniquely: your public key is your unique ID.  It's listed in [[#public_info |System -> Public Info]], and it's part of the [[#qr_code |Contact Info]] that you share with others for them to add you to their contact list.  Your private key can be [[#extra_tools |exported]] for backup purposes or in case you upgrade your device and want to keep the same ID.  But <wrap alert>don't share your private key with anyone.</wrap>   * Identify you uniquely: your public key is your unique ID.  It's listed in [[#public_info |System -> Public Info]], and it's part of the [[#qr_code |Contact Info]] that you share with others for them to add you to their contact list.  Your private key can be [[#extra_tools |exported]] for backup purposes or in case you upgrade your device and want to keep the same ID.  But <wrap alert>don't share your private key with anyone.</wrap>
Line 497: Line 487:
 <WRAP pagebreak /> <WRAP pagebreak />
  
-===== Direct, Private Messages ===== 
  
 +===== Direct, Private Messages =====
 To send a direct, private message to someone, <wrap important>you **both** need to be in each other's contact lists.</wrap> To send a direct, private message to someone, <wrap important>you **both** need to be in each other's contact lists.</wrap>
   * Use one of the four methods for [[#contacts |sharing contact info]].   * Use one of the four methods for [[#contacts |sharing contact info]].
Line 529: Line 519:
 </WRAP> </WRAP>
 </WRAP> </WRAP>
- 
  
 <WRAP pagebreak /> <WRAP pagebreak />
- 
- 
- 
  
  
Line 634: Line 620:
  
 <WRAP pagebreak /> <WRAP pagebreak />
- 
  
  
Line 661: Line 646:
  
 <WRAP pagebreak /> <WRAP pagebreak />
- 
  
  
Line 667: Line 651:
  
 ===== Online Tools and Maps ===== ===== Online Tools and Maps =====
- 
 |[[https://app.meshcore.nz]]|The browser version of the MeshCore app| |[[https://app.meshcore.nz]]|The browser version of the MeshCore app|
 |[[https://map.meshcore.dev/?zoom=10&lat=49.5127&lon=-123.5797| https://map.meshcore.io]] |Official MeshCore Node map| |[[https://map.meshcore.dev/?zoom=10&lat=49.5127&lon=-123.5797| https://map.meshcore.io]] |Official MeshCore Node map|
Line 675: Line 658:
 |[[https://heywhatsthat.com/profiler.html |https://heywhatsthat.com]] |Path Profiler | |[[https://heywhatsthat.com/profiler.html |https://heywhatsthat.com]] |Path Profiler |
  
-===== More Information ===== 
  
 +===== More Information =====
 |[[https://meshcore.io]] |Official MeshCore website| |[[https://meshcore.io]] |Official MeshCore website|
 |[[https://github.com/meshcore-dev/MeshCore]] |Official MeshCore Github| |[[https://github.com/meshcore-dev/MeshCore]] |Official MeshCore Github|
Line 686: Line 669:
 |[[https://idahomesh.org/meshcore-channels-rooms-and-dms]] |Channels vs Rooms vs DMs| |[[https://idahomesh.org/meshcore-channels-rooms-and-dms]] |Channels vs Rooms vs DMs|
 |[[https://discord.gg/vHUqyBSTPe]] |Vancouver Island Amateur Radio Discord Server | |[[https://discord.gg/vHUqyBSTPe]] |Vancouver Island Amateur Radio Discord Server |
 +
  
 ===== To Do ===== ===== To Do =====
Line 691: Line 675:
   * Add screenshots to the [[#channels]] section   * Add screenshots to the [[#channels]] section
   * Edit the [[part2 |second part]] of this guide.   * Edit the [[part2 |second part]] of this guide.
- --- //[[[email protected]|Patrick, VA7FI]] 2026/10/25 // + --- //[[[email protected]|Patrick, VA7FI]] 2026/10/25 20:34//
 </WRAP> </WRAP>
 +
  
 ===== Copyright and Attribution ===== ===== Copyright and Attribution =====
links/meshcore/part1.1792983880.txt.gz · Last modified: by va7fi