Glossary

[makew0rld]

More work is needed here, hoping others can contribute to this branch. The start of the glossary.

[benhylau]

Thanks for starting this. I made changes to the first 4 glossary terms (up to PTMP) and will leave the more technical ones to those more involved in the tech team.

I got mdbook set up on my local now. Was wondering if it would support the gitbook glossary feature that highlights and links everything in the book that is a glossary item to its dictionary (e.g. https://cloud-provider-vsphere.sigs.k8s.io/glossary.html). Doesn't look like it does put perhaps there is a plugin.

Not a high priority, but a nice to have in the future. This would require us to write in a particular way though, e.g. PTMP being the subtitle, so the scanner picks up, like how they do VM.

[darkdrgn2k]

PTP/PTMP

The current wording for these is VERY super node specific and assume wireless.

• PTP can be a VPN/TUNNEL just as much as it can be a point to point antenna
• Most antennas (at least ones we have used) can run in both PTP and PTMP modes
• The most common PTMP antenna is the Omni Directional antenna found in your home router
• Omni Directional and Sector antennas are usually used for PTMP to be able to "hear" more devices
• Directional antennas are usually used for PTP to be able to isolate the noise created into a specific direction since only one device needs to hear it.
• Directional antennas can also be PTMP, for example if there are 2-3 different stations in a narrow beam that can connect back
• A more common use of Directional Antennas in PTMP mode are CPE that users of the mesh will put up in their home pointing at the sectors
• On SUPER NODES
  • PTP is used to interconnect other parts of the node and between super nodes
  • PTMP is used as sectors to connect to as many people as possible.

Also we probably should clarify:

Antenna - This is a piece of metal that is designed to transmit and receive specific RF frequencies. Shape of the antenna defines what kinda of "radiation pattern" it will have, Omni, Sector, Directional etc.

Radio - This is an device connected to an antenna. Radios provide power to the antenna to radiate in the form of RF, and receive the signals from the antenna and interpret them. In Wifi radios present themselves are an interface.

Router - Device that can move packets between different last 3 interfaces

When we talk about the LAP-120 "antenna" its actually a combination of ANTENNA+RADIO+ROUTER. However since the main purpose of the device is to be an ANTENNA this is why its called an Antenna.

Similarly how a MODEM+ROUTER+SWITCH+ACCESSPOINT in the bells' CPE is called a "MODEM" or even
WIRELESS MODEM" as them primary function that we care about is the MODEM (modulate/demodulate the signals coming from the ISP) and WIRELESS (wifi!)

[darkdrgn2k]

Awesome start thanks

Not sure if we should be writing as "we use babeld to create a mesh network" or more factually "babeld is used to create a mesh network"

Also some great reference can be found here
https://github.com/tomeshnet/tomesh.101/blob/master/glossary/glossary.md

[makew0rld]

Thanks for the comments! I've responded and made some commits.

Not sure if we should be writing as "we use babeld to create a mesh network" or more factually "babeld is used to create a mesh network"

No idea either. Maybe the second?

Also some great reference can be found here
https://github.com/tomeshnet/tomesh.101/blob/master/glossary/glossary.md

This looks helpful thanks. Feel free to add some of these yourself as well, but I can work on integrating them at some point.

[darkdrgn2k]

see #7 (comment)