Mirrors
/
ARDEN-documentation
mirror of https://github.com/aredn/documentation.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Update Optional Settings text (#62) 

* Update Optional Settings text

Update the Optional Settings description in the Basic Setup document.

* Update Optional Settings text

Add section headers.
This commit is contained in:
Steve Lewis KC0EUW 2020-05-09 09:42:16 -07:00 committed by GitHub
parent 7e2853dd69
commit ab8ce73771
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 31 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

BIN
arednGettingStarted/_images/optional-settings.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 24 KiB

41
arednGettingStarted/basic_setup.rst
View File

@ -2,7 +2,10 @@
Basic Radio Setup
==================
After you have installed the AREDN |trade| firmware, rebooted the device, and connected your computer to the LAN port on the :abbr:`PoE (Power over Ethernet)` you can navigate to the following URL: ``http://localnode``. The initial status page will be displayed, instructing you to configure your node by clicking the **Setup** button.
First-Time Setup
----------------
After you have installed the AREDN |trade| firmware, rebooted the device, and connected your computer to a LAN port on the node or the :abbr:`PoE (Power over Ethernet)` you can navigate to your node's web interface at ``http://192.168.1.1`` or ``http://localnode`` for first-time radio setup. The initial status page will be displayed, instructing you to configure your node by clicking the **Setup** button. This is sometimes referred to as the "NOCALL" or *firstboot* display.
----------
@ -25,11 +28,11 @@ The **Basic Setup** page will be displayed, as shown below.
----------
In order to get your new AREDN |trade| node on the air, you need to enter the following items.
Many of these settings will be described in detail in subsequent sections of this documentation. In order to get your new AREDN |trade| node on the air for the first time, you need to enter the following items.
**Node Name**
Begin the node name with your callsign, followed by unique identifying information of your choice. Node names may contain up to 63 letters, numbers, and dashes, but cannot begin or end with a dash. Underscores, spaces, or any other characters are not allowed. Node names are not case sensitive, but the case will be preserved on the node status display.
Amateur radio operators are required to identify all transmitting stations. The AREDN |trade| node name is beaconed automatically by the node every five minutes, so the node name must contain your callsign. Recommended names follow the (callsign)-(label) format, such as AD5BC-MOBILE or AD5BC-1. This is similar to the MYCALL setting you would give a packet :abbr:`TNC (Terminal Node Controller)`, but without the 0-15 character restriction.
Begin the node name with your callsign, followed by unique identifying information of your choice. Node names may contain up to 63 letters, numbers, and dashes, but cannot begin or end with a dash. Underscores, spaces, or any other characters are not allowed. Node names are not case sensitive, but the case will be preserved on the node status display.
Amateur radio operators are required to identify all transmitting stations. The AREDN |trade| node name is beaconed automatically by the node every five minutes, so the node name must contain your callsign. Recommended names follow the (callsign)-(label) format, such as AD5BC-MOBILE or AD5BC-120SE. As a general rule node names should be kept as short as possible, while clearly and uniquely identifying the node.
**Password**
Set a new administration password for the node. Enter it again in the *Retype Password* box to verify it is correct. The first time a node is configured it will require you to change the password. Be sure to remember or record the new password so you can use it for any future administrative tasks on the node.
@ -45,19 +48,37 @@ In order to get your new AREDN |trade| node on the air, you need to enter the fo
**Active Settings**
* Use the dropdown list to select the maximum output power for this device. Remember that amateur operators are required to use the minimum power necessary to make contact with other stations.
See the *Advanced Configuration* section for more information about these and other settings in the **Mesh RF** column.
* Use the slider to select the maximum distance you estimate between your node and other neighboring nodes.
* Use the dropdown list to select the maximum output power for this device. Remember that amateur operators are required to use the minimum power necessary to make contact with other stations.
* Some devices have max power levels that change depending on the channel or frequency being used, and in that case the max level may change when you save the settings. The output power will be capped at the max level supported by the hardware for that frequency.
* Use the slider to select the maximum distance you estimate between your node and other neighboring nodes. A value of *zero* will tell the node to automatically determine the correct distance value.
* Once these settings have been adjusted, click the **Apply** button.
* Some devices have max power levels that change depending on the channel or frequency being used, and in that case the max level may change when you save the settings. The output power will be capped at the max level supported by the hardware for that frequency.
**Optional Settings**
In this section you can enter your node's latitude and longitude, as well as the grid square designator. Click the **Apply Location Settings** button after entering this information. You may also change the timezone for your node's system time.
* Once these settings have been adjusted, click the **Apply** button.
Once you have entered, applied, and verified that your node settings are correct, click the **Save Changes** button. Your node will record the new configuration settings and automatically reboot.
Optional Settings
-----------------
In this section you can enter your node's latitude and longitude, as well as the grid square designator. The latitude/longitude values should be in decimal format (for example, 30.444522 and -95.111234). The optional node location settings are not required in order for your node to function normally.
.. image:: _images/optional-settings.png
:alt: Optional Settings
:align: center
* If you are using a location-aware web browser, you can click the **Find Me** button to populate the latitude/longitude fields. This works well if you are viewing the *Basic Settings* page on a mobile device with built-in GPS.
* If your node has an Internet connection available, the **Show Map** and **Upload Data to AREDN Servers** buttons will become active. The **Show Map** button will display a map that allows you to click the position where your node is located or to drag an existing location marker to a different spot on the map. Both of these actions will automatically update the latitude/longitude fields on the page.
* The **Upload Data to AREDN Servers** button will send your node information to an AREDN |trade| server on the Internet. By submitting this information you are agreeing to allow AREDN |trade| to publish your node location on a public mapping service and utilize the information for other purposes such as statistical analysis. No sensitive data such as passwords are sent to the AREDN |trade| servers. If you wish to remove your node location from the public mapping service, simply clear or erase your latitude/longitude values, click *Apply Location Settings* and then *Upload Data to AREDN Servers*.
* Click the **Apply Location Settings** button after entering new location information on this page. The new settings become active without clicking the *Save Changes* button.
You may also change the timezone for your node's system time, as well as selecting a `Network Time Protocol (NTP) <https://en.wikipedia.org/wiki/Network_Time_Protocol>`_ source if your node is connected to a network which has a network time server.
.. |trade| unicode:: U+00AE .. Registered Trademark SIGN
:ltrim: