Sun Coast Amateur
Radio Club Society

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== The Contact List ======
|<100%>|
^  <wrap todo></wrap>  DRAFT  <wrap todo></wrap>  ^
<WRAP center round important 70%>
Unlike texting on a phone, two companion nodes can**<fc #ff0000>not</fc>** exchange private messages with each other unless they are <wrap hi>both in each other's contact list</wrap>.
</WRAP>


A standalone way of building a contact list of neighbours is to:
  - Advert(ise) your node with precise (or close enough) location for others to find you.
  - Discover other nodes based on their location.

===== 1. Advert =====
<WRAP group>
<WRAP twothirds column>
Setup your name and location:
  * Tap the gear in the top right corner to go to the settings pages.
  * Write a name that is someone descriptive (your name, callsign, etc...).  You can change this anytime.
  * Tap the map icon to pick your location. <wrap important> This will be shared online </wrap> so you might want to select a street corner that's close to your house but not exactly where you live.  It should be close enough to be useful for your neighbours to identify you as part of the neighbourhood.
  * Check the "Share Position in Advert"
  * Tap the ✔ icon in the top right corner.
</WRAP>
 {{:links:meshcore:quickstart:contactlist01.png?300|}}
<WRAP third column>
</WRAP>
</WRAP>

<WRAP group>
<WRAP twothirds column>
Tweak the Contact Settings:
  * Scroll down to "Contact Settings"
  * Select "Auto Add Selected"
  * Uncheck all four options.
  * Tap the ✔ icon in the top right corner.

Turn off the GPS:
  * Scroll down to "Position Settings"
  * Select "Disabled"
  * Tap the ✔ icon in the top right corner.
</WRAP>
 {{:links:meshcore:quickstart:contactlist02.png?300|}}
<WRAP third column>
</WRAP>
</WRAP>



<WRAP group>
<WRAP twothirds column>
Advert(ise) your name and location to the network:
    * Tap of the "wave" icon just on the left of the gears at the top
    * Tap "Advert • Flood Routed"
</WRAP>
 {{:links:meshcore:quickstart:contactlist03.png?300|}}
<WRAP third column>
</WRAP>
</WRAP>

After a few minutes other nodes on the network will be able to see you on a map.

===== 2. Discover =====
There are three kinds of maps in MeshCore:
<WRAP simple centered box>
<WRAP third column>
{{:links:meshcore:quickstart:contactlist04.png?300|}}
The map at the bottom of the main page only shows nodes in your contact list.
</WRAP>
<WRAP third column>
{{:links:meshcore:quickstart:contactlist05.png?300|}}
{{:links:meshcore:quickstart:contactlist06.png?300|}}
The map under "Discover Contacts" shows all the nodes that your companion has heard so far.
</WRAP>
<WRAP third column>
{{:links:meshcore:quickstart:contactlist07.png?300|}}
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>

We'll use the "Discover Contacts" map to populate your contact list, but keep in mind that you might have to leave your node on for a bit for it to hear all the nodes in your area since they need to advert or transmit for your node to see them:
  * In the "Discover Contacts" "Map View", tap on the filter icon {{:links:meshcore:quickstart:contactlist08.png?20}} and select "Users".
  * Tap on a node
  * Under the node's name, tap on "Add"

If you go back to the main page's "Map", you should now see that contact.