fix dead external URLs (#361)
This commit is contained in:
parent
5f0ad093cc
commit
0da5cc1ef8
|
@ -2,7 +2,7 @@
|
|||
Tools for Developers
|
||||
====================
|
||||
|
||||
This section of the AREDN |trade| documentation contains information useful for developers who want to retrieve information from one or more nodes for use in any of several applications. For example, a developer may want to write a program which periodically polls a set of nodes to gather link quality or signal values to insert them into a network management or historian system for trending and analysis. The popular `KG6WXC MeshMap <https://gitlab.kg6wxc.net/mesh/meshmap>`_ application uses these tools to create and update a comprehensive mesh network map.
|
||||
This section of the AREDN |trade| documentation contains information useful for developers who want to retrieve information from one or more nodes for use in any of several applications. For example, a developer may want to write a program which periodically polls a set of nodes to gather link quality or signal values to insert them into a network management or historian system for trending and analysis. The popular KG6WXC MeshMap application uses these tools to create and update a comprehensive mesh network map.
|
||||
|
||||
SYSINFO.JSON
|
||||
============
|
||||
|
|
|
@ -44,7 +44,7 @@ For example, Mikrotik LHG5 and Ubiquiti RocketDish5 antennas are very narrow, wi
|
|||
|
||||
While it is helpful to know the antenna pattern for the nodes at both ends, the key is knowing the exact coordinates of the two locations so you can determine their topographical relationship to each other (horizontal and vertical azimuth). There are several computer tools for modeling radio links that were mentioned in the **Network Design Guide** under the *Network Modeling* section. One of the most useful is `VE2DBE's Radio Mobile <http://www.ve2dbe.com/rmonline.html>`_ which provides all of the required details for aiming directional antennas between two locations, including both true and magnetic bearings for both sides of the link.
|
||||
|
||||
Another invaluable tool mentioned in the **Applications and Services Guide** under *Other Services* is `KG6WXC's MeshMap Network Visualizer <https://gitlab.kg6wxc.net/mesh/meshmap>`_. This program automatically discovers live nodes on a mesh network and periodically polls them to display their location, configuration, services, and link information. It also has a ruler tool that displays the distance and true bearing (not magnetic) between any two points you select on the map.
|
||||
Another invaluable tool mentioned in the **Applications and Services Guide** under *Other Services* is KG6WXC's MeshMap Network Visualizer. This program automatically discovers live nodes on a mesh network and periodically polls them to display their location, configuration, services, and link information. It also has a ruler tool that displays the distance and true bearing (not magnetic) between any two points you select on the map.
|
||||
|
||||
Studying the types of maps mentioned above may allow you to discover other sites where you could place intermediate nodes that might link two distant locations. Google Earth can help you identify visible landmarks before aiming. Obvious tall objects such as water towers or multi-story buildings can be added as markers. Nearby objects such as church steeples or park features can be useful as visual reference points during the aiming procedure: for example, "I need to aim over the skate park to the left of the church to hit the remote node." Google Earth also provides a ruler tool which shows the bearing between map locations, and you can look at the Profile View to see whether there are features which may block your signal. Another tool mentioned in the **Network Design Guide** under the *Network Modeling* section is `Radio Fresnel <http://www.radiofresnel.com>`_ which generates a Google Earth KMZ file that identifies ground features which may block the Fresnel Zone along your link path.
|
||||
|
||||
|
|
|
@ -34,7 +34,7 @@ Installing and Using IperfSpeed
|
|||
|
||||
The **IperfSpeed** package provides a web-based control interface for running network tests between nodes, and it was written by Trevor Paskett K7FPV using the Perl programming language. With the project to retire Perl on AREDN |trade| nodes, there is now an alternative *IperfSpeed* package which uses the Lua programming language. The original Perl and new Lua packages are available at the following links:
|
||||
|
||||
- `Original Perl version of IperfSpeed <https://aredn.s3.amazonaws.com/iperfspeed_0.5.1_all.ipk>`_
|
||||
- Original Perl version of IperfSpeed [No longer available]
|
||||
|
||||
- `New Lua version of IperfSpeed <https://github.com/kn6plv/iperfspeed>`_
|
||||
|
||||
|
|
|
@ -57,7 +57,7 @@ Disadvantages
|
|||
3.4 GHz Characteristics
|
||||
-----------------------
|
||||
|
||||
.. note:: Late in 2020 the `FCC ruled <https://docs.fcc.gov/public/attachments/FCC-20-138A1.pdf>`_ to sunset secondary Amateur allocations in the 9 cm *(3.3-3.5 GHz)* band. Although existing Amateur operations *"may continue while the Commission finalizes plans to reallocate spectrum,"* be aware that future FCC actions could remove Amateur operations altogether. Consider this before investing in or implementing new AREDN |trade| devices in this band.
|
||||
.. note:: Late in 2020 the FCC ruled to sunset secondary Amateur allocations in the 9 cm *(3.3-3.5 GHz)* band. Although existing Amateur operations *"may continue while the Commission finalizes plans to reallocate spectrum,"* be aware that future FCC actions could remove Amateur operations altogether. Consider this before investing in or implementing new AREDN |trade| devices in this band.
|
||||
|
||||
Advantages
|
||||
Equipment in the 9 cm band is appropriate for *Backbone Links* since there is less potential for interference from other devices sharing these frequencies at tower sites. With clear line of sight and well-aligned antennas, 3.4 GHz signals can propagate across very long distances. You can select channel widths of 5, 10, or 20 MHz, with larger channel widths providing higher data rates. Remember that reducing the channel width may increase the SNR to improve signal quality if that is an issue for a marginal link.
|
||||
|
|
|
@ -24,7 +24,7 @@ Most computer modeling software will be able to estimate the link characteristic
|
|||
Ubiquiti AirLink Tool
|
||||
+++++++++++++++++++++
|
||||
|
||||
If you are using Ubiquiti radios there is a free modeling tool available on the Ubiquiti website (http://link.ubnt.com). This tool will ask you to locate your node endpoints by clicking on a map display. It allows you to select the radio frequency and model from a dropdown list, as well as having you specify the antenna heights, antenna gain, and transmit power. With this information it will calculate and display the coverage area and the link quality.
|
||||
If you are using Ubiquiti radios there is a free modeling tool available on the Ubiquiti website (http://ui.com). This tool will ask you to locate your node endpoints by clicking on a map display. It allows you to select the radio frequency and model from a dropdown list, as well as having you specify the antenna heights, antenna gain, and transmit power. With this information it will calculate and display the coverage area and the link quality.
|
||||
|
||||
The path profile is color coded to indicate whether the link quality is adequate. It displays the link distance, line of sight, as well as the Fresnel Zone and 60% clearance area. It also estimates the signal levels at each endpoint and the predicted throughput for the link. An example *AirLink* path profile is shown below.
|
||||
|
||||
|
|
|
@ -9,7 +9,7 @@ Chat programs are one of the least network-intensive types of communication prog
|
|||
MeshChat
|
||||
--------
|
||||
|
||||
MeshChat has become the primary chat service for AREDN |trade| networks because it was written by Trevor Paskett K7FPV specifically for mesh communication. Users access MeshChat via web browser, and the service can run on the mesh node itself or on a LAN-connected Debian or Raspberry Pi computer. After logging in by entering a call sign, you can send a message by typing into a text box and clicking the *Submit* button. The list of active users is displayed, and every message is visible to all participants on the chat service. Multiple *Zones* and *Channels* are supported for categorizing and filtering message traffic.
|
||||
MeshChat has become the primary chat service for AREDN |trade| networks because it was written specifically for mesh communication by Trevor Paskett K7FPV. Users access MeshChat via web browser, and the service can run on the mesh node itself or on a LAN-connected Debian or Raspberry Pi computer. After logging in by entering a call sign, you can send a message by typing into a text box and clicking the *Submit* button. The list of active users is displayed, and every message is visible to all participants on the chat service. Multiple *Zones* and *Channels* are supported for categorizing and filtering message traffic.
|
||||
|
||||
A copy of the message database is stored on every device where MeshChat is running. Nodes may have intermittent network connectivity, but as long as at least one node is available the MeshChat database remains intact. Once nodes come online they immediately sync by retrieving a full copy of the message database. If any new messages are found, they are appended to the local message database.
|
||||
|
||||
|
@ -25,7 +25,7 @@ As originally designed, MeshChat uses the Perl programming language and is able
|
|||
|
||||
- `Older Lua version of Meshchat for AREDN ≥3.22.6.0 (no longer maintained) <https://github.com/kn6plv/meshchat>`_
|
||||
|
||||
- `Original Perl version of Meshchat for AREDN ≤3.22.1.0 or for running Meshchat on a Raspbian or Debian computer (no longer maintained) <https://www.trevorsbench.com/meshchat-messaging-for-mesh-networks/>`_
|
||||
- `Original Perl version of Meshchat for AREDN ≤3.22.1.0 or for running Meshchat on a Raspbian or Debian computer (no longer maintained)
|
||||
|
||||
.. image:: _images/meshchat.png
|
||||
:alt: MeshChat Web Interface
|
||||
|
|
Loading…
Reference in New Issue