kopia lustrzana https://github.com/F5OEO/rpitx
Grammar correction
Mihajlo Petković
GitHub
rodzic
09569a6854
commit
d3a29d0442
56
README.md
56
README.md
|
|
@ -1,8 +1,8 @@
|
|||
|
||||
# About rpitx
|
||||
**rpitx** is a general radio frequency transmitter for Raspberry Pi which doesn't require any other hardware unless filter to avoid intererence. It can handle frequencies from 5 KHz up to 1500 MHz.
|
||||
**rpitx** is a general radio frequency transmitter for Raspberry Pi which doesn't require any other hardware other than filter to avoid intererence. It can handle frequencies from 5 KHz up to 1500 MHz.
|
||||
|
||||
Rpitx is a software made for educational on RF system. It has not been tested for compliance with regulations governing transmission of radio signals. You are responsible for using your Raspberry Pi legally.
|
||||
Rpitx is a software made for education on RF systems. It has not been tested for compliance with regulations governing transmissions of radio signals. You are responsible for using your Raspberry Pi legally.
|
||||
|
||||
A forum is available : https://groups.io/g/rpitx
|
||||
|
||||
|
|
@ -24,7 +24,7 @@ git clone https://github.com/F5OEO/rpitx
|
|||
cd rpitx
|
||||
./install.sh
|
||||
```
|
||||
Make a reboot in order to use **rpitx** in a stable state.
|
||||
Reboot in order to use **rpitx** in a stable state.
|
||||
That's it !
|
||||
```sh
|
||||
sudo reboot
|
||||
|
|
@ -45,20 +45,20 @@ sudo reboot
|
|||
| Pi3B+|OK|
|
||||
| Pi4|In beta mode|
|
||||
|
||||
Plug a wire on GPIO 4, means Pin 7 of the GPIO header ([header P1](http://elinux.org/RPi_Low-level_peripherals#General_Purpose_Input.2FOutput_.28GPIO.29)). This acts as the antenna. The optimal length of the wire depends the frequency you want to transmit on, but it works with a few centimeters for local testing.
|
||||
Plug a wire on GPIO 4, which is Pin 7 of the GPIO header ([header P1](http://elinux.org/RPi_Low-level_peripherals#General_Purpose_Input.2FOutput_.28GPIO.29)). This acts as the antenna. The optimal length of the wire depends on the frequency you want to transmit on, but it works with a few centimeters for local testing.
|
||||
|
||||
# How to use it
|
||||
|
||||
## Easytest
|
||||
**easytest** is the easiest way to start and see some demonstration. All transmission are made on free ISM band (434MHZ).
|
||||
**easytest** is the easiest way to start and see some demonstrations. All transmission are made on the free ISM band (434MHZ).
|
||||
To launch it, go to rpitx folder and launch easytest.sh :
|
||||
```sh
|
||||
cd rpitx
|
||||
./easytest.sh
|
||||
```
|
||||
Choose your choice with arrows and enter to start it.**Don't forget, some test are made in loop, you have to press CTRL^C to exit and back to menu.**
|
||||
Choose different modes with arrows and press enter to start it.**Don't forget, some tests are made in a loop, you have to press CTRL^C to exit and back to menu.**
|
||||
|
||||
Easy way to monitor what you are doing is by using a SDR software and a SDR receiver like a rtl-sdr one and set the frequency to 434MHZ.
|
||||
Easy way to monitor what you are doing is by using an SDR software and an SDR receiver like an rtl-sdr one and set the frequency to 434MHZ.
|
||||
|
||||
### Carrier ###
|
||||
|
||||
|
|
@ -66,70 +66,70 @@ A simple carrier generated at 434MHZ.
|
|||
|
||||
### Chirp ###
|
||||
|
||||
A carrier which move around 434MHZ.
|
||||
A carrier which moves around 434MHZ.
|
||||
|
||||
### Spectrum ###
|
||||
|
||||
A picture is displayed on the waterfall on your SDR. Note that you should make some tweaks in order to obtain contrast and correct size depending on your reception and SDR software you use.
|
||||
A picture is displayed on the waterfall of your SDR. Note that you should make some tweaks in order to obtain contrast and correct size depending on your reception and SDR software you use.
|
||||
|
||||
### RfMyFace ###
|
||||
|
||||
Spectrum painting of your face using the raspicam for fun !
|
||||
Spectrum painting of your face using the raspicam for fun!
|
||||
|
||||
### FM with RDS ###
|
||||
|
||||
Broadcast FM with RDS. You should receive it with your SDR. This is the modulation that you should hear on your classical FM Radio receiver, but at this time, the frequency is too high.
|
||||
Broadcast FM with RDS. You should receive it with your SDR. This is the same modulation of commercially broadcast FM stations, but in this case, the frequency is higher since the FM broadcast badn is between 87-108 MHz.
|
||||
|
||||
### Single Side Band modulation (SSB) ###
|
||||
|
||||
This is the classical Hamradio analog voice modulation. Use your SDR in USB mode.
|
||||
This is the classical analog voice modulation used in ham radio. Use your SDR in USB mode.
|
||||
|
||||
### Slow Scan Television (SSTV) ###
|
||||
|
||||
This is a picture transmission mode using audio modulation (USB mode). You need an extra software to decode and display it (qsstv,msstv...). This demo uses the Martin1 mode of sstv.
|
||||
This is a picture transmission mode using USB modulated audio. You need an extra software to decode and display it (QSSTV, MMSSTV, ...). This demo uses the Martin1 SSTV mode.
|
||||
|
||||
|
||||
### Pocsag (pager mode) ###
|
||||
### POCSAG (pager mode) ###
|
||||
|
||||
This is a mode used by pagers. You need an extra software to decode. Set your SDR in NBFM mode.
|
||||
This is a mode used by pagers. You need an extra software to decode. Set your SDR in NBFM mode. Default is 1200 bps.
|
||||
|
||||
### Freedv (digital voice) ###
|
||||
### FreeDV (digital voice) ###
|
||||
|
||||
This is state of the art opensource digital modulation. You need Freedv for demodulation.
|
||||
This is state of the art opensource digital modulation. You need FreeDV for demodulation.
|
||||
|
||||
### Opera (Beacon) ###
|
||||
|
||||
This a beacon mode which sound like Morse. You need opera in mode 0.5 to decode.
|
||||
This a beacon mode which sound like Morse code (CW). You need Opera decoder set to 0.5 in order to decode it.
|
||||
|
||||
## Rpitx and low cost RTL-SDR dongle ##
|
||||
|
||||
|
||||
**rtlmenu** allows to use rtl-sdr receiver dongle and **rpitx** together. This combine receiver and transmission for experimenting.
|
||||
To launch it, go to rpitx folder and launch rtlmenu.sh :
|
||||
**rtlmenu** allows to use rtl-sdr receiver dongle and **rpitx** together. This involves reception and retransmission for experimenting.
|
||||
To launch it, go to the rpitx folder and launch rtlmenu.sh :
|
||||
```sh
|
||||
./rtlmenu.sh
|
||||
```
|
||||
You have first to set receiver frequency and gain of rtl-sdr. Warning about gain, you should ensure that you have enough gain to receive the signal but not to strong which could saturate it and will not be usefull by **rpitx**.
|
||||
You have to first to set receiver frequency and gain of RTL-SDR. Attention about gain, you should ensure that you have just enough gain to receive the signal clearly but not too high which could saturate the receiver and won't work properly*.
|
||||
|
||||
Choose your choice with arrows and enter to start it.**Don't forget, some test are made in loop, you have to press CTRL^C to exit and back to menu.**
|
||||
Choose with arrows and enter to start it.**Don't forget, some test are made in a loop, you have to press CTRL^C to exit and go back to the menu.**
|
||||
|
||||
|
||||
### Record and play ###
|
||||
|
||||
|
||||
A typical application, is to replay a signal. Picture above shows a replay of a signal from a RF remote switch.
|
||||
So first, record few seconds of signal, CTRL^C for stop recording. Then replay it with play.
|
||||
A typical application is to replay a signal. Picture above shows a replayed signal from an RF remote switch.
|
||||
So first, record few seconds of the signal, press CTRL^C to stop the recording. Then replay it by pressing play.
|
||||
|
||||
### Transponder ###
|
||||
|
||||
We can also live transmitting a received band frequency. Here the input frequency is a FM broadcast station which is retransmit on 434MHZ.
|
||||
We can also retransmitt live the received frequency. Here the input frequency is an FM broadcast station which is retransmitted on 434 MHz.
|
||||
|
||||
### Relay with transmodulation ###
|
||||
We assume that input frequency is tuned on FM station. It is demodulated and modulate to SSB on 434MHZ. SSB is not HiFi, so prefere to choose a talk radio, music sounds like bit weird !
|
||||
### Relaying with transmodulation ###
|
||||
We assume that the input frequency is tuned to an FM station. It is first demodulated and then modulated to SSB on 434MHZ. SSB is not HiFi, so prefere to choose a spoken radio, music sounds a bit weird!
|
||||
|
||||
|
||||
# To continue
|
||||
**rpitx** is a generic RF transmitter. There is a lot of modulation to do with it and also documentation to make all that easy to contribute. This will be the next step ! Feel free to inspect scripts, change parameters (frequencies, audio input, pictures...).
|
||||
**rpitx** is a generic RF transmitter. There are a lots of modulation types to experiment with and much documentation to make easy to contribute. This will be the next step! Feel free to inspect scripts, change parameters (frequencies, audio input, pictures, ...).
|
||||
|
||||
# Credits
|
||||
All rights of the original authors reserved.
|
||||
|
|
|
|||
Ładowanie…
Reference in New Issue