Updated HamShield Best Practices Guide (markdown)

spaceneedle 2015-07-06 17:07:50 -07:00
parent 8ccf5def75
commit 091eefa0af
1 changed files with 9 additions and 11 deletions

@ -1,6 +1,4 @@
# HAMShield Best Practices Guide
The HAMShield can bring a lot of new, interesting applications to the field of amateur radio. Due to the fast development times of this radio, this can also lead to a lot of new automated or remote controlled services.
The HamShield can bring a lot of new, interesting applications to the field of amateur radio. Due to the fast development times of this radio, this can also lead to a lot of new automated or remote controlled services.
While most applications will likely follow the FCC rule 97.221, it is important to become familiar with it:
@ -18,13 +16,13 @@ While most applications will likely follow the FCC rule 97.221, it is important
>
>[60 FR 26001, May 16, 1995, as amended at 72 FR 3082, Jan. 24, 2007; 77 FR 5412, Feb. 3, 2012]
97.221 says that automated digital emissions in the bands HAMShield are permitted, and automated audio-based systems are permitted as long as another human-operated station is interrogating the remote end. We are also making the assumption that the content of the message also follows FCC guidelines.
97.221 says that automated digital emissions in the bands HamShield are permitted, and automated audio-based systems are permitted as long as another human-operated station is interrogating the remote end. We are also making the assumption that the content of the message also follows FCC guidelines.
Still, even with this very open authorization, there are a lot of things you can do to make your HAMShield sketch play well with other users within the band.
Still, even with this very open authorization, there are a lot of things you can do to make your HamShield sketch play well with other users within the band.
#### Always listen before you transmit - .waitForChannel()
Nice amateur radio operators do this automatically. Nicer amateur radio operators even allow a few seconds of dead air to permit someone to break into the transmission in case of emergency. But unless you tell the HAMShield to do so, it will not. Fortunately, this is easy to do.
Nice amateur radio operators do this automatically. Nicer amateur radio operators even allow a few seconds of dead air to permit someone to break into the transmission in case of emergency. But unless you tell the HamShield to do so, it will not. Fortunately, this is easy to do.
Using .waitforChannel() by itself waits indefinitely and returns true when there is no activity on the channel.
@ -42,17 +40,17 @@ In this example, we use the optional arguments channel timeout and breaker timeo
#### Pay close attention to your area's band plan and frequency allocations
Being able to set any frequency with one line of code comes with great power and great responsibility. Every jurisdiction in the world has different frequency allocations. Every locality within that jurisdiction may have a different band plan for using those frequencies. Take care in knowing both of these. While the HAMShield library prevents accidental transmission outside of USA amateur radio bands, this may still not be applicable in your specific location.
Being able to set any frequency with one line of code comes with great power and great responsibility. Every jurisdiction in the world has different frequency allocations. Every locality within that jurisdiction may have a different band plan for using those frequencies. Take care in knowing both of these. While the HamShield library prevents accidental transmission outside of USA amateur radio bands, this may still not be applicable in your specific location.
Even though you are authorized to use the HAMShield on a certain frequency, it does not mean that you should. Repeaters may be assigned to non-standard frequencies, certain amateur TV allocations may exist in your area, as well as other special services. Be sure to look at your location's band plan for more information.
Even though you are authorized to use the HamShield on a certain frequency, it does not mean that you should. Repeaters may be assigned to non-standard frequencies, certain amateur TV allocations may exist in your area, as well as other special services. Be sure to look at your location's band plan for more information.
It is highly recommended that when testing your HAMShield, you either connect to a dummy load or operate in the experimental section of the amateur radio band.
It is highly recommended that when testing your HamShield, you either connect to a dummy load or operate in the experimental section of the amateur radio band.
### Always identify - .morseOut("MYCALLSIGN TEST")
It is very easy to be caught up in the next killer new application for amateur radio but forget to write in station identification. The HAMShield library makes this easy, too.
It is very easy to be caught up in the next killer new application for amateur radio but forget to write in station identification. The HamShield library makes this easy, too.
.morseOut(char array) lets us send morse code during our transmissions for very easy identification. You can also change the HAMSHIELD_MORSE_DOT value in HAMShield.h to adjust speed to make this more convenient. The lower the value, the faster the words per minute.
.morseOut(char array) lets us send morse code during our transmissions for very easy identification. You can also change the HAMSHIELD_MORSE_DOT value in HamShield.h to adjust speed to make this more convenient. The lower the value, the faster the words per minute.
For example: