ENG-CANSAT-PICO-RFM69HCW-TEST
Forewords
It is now time to establish a communication between:
- a Data Emitter (CanSat) made with a raspberry-Pico + RFM69HCW-433MHz.
- a Data Receiver (Base Station) made with the second RFM69HCW coupled to another Pico microcontroler.
As the kit contains contains two Pico microcontroller we will be able to create the "Data Emitter" on the CanSat as well as the Data Receiver at the ground station.
In this simple example:
- The Data Emitter will send a message and wait 500ms for a response (ACK).
- The Data Receiver will receive the message.
- The Data Receiver will send a ACK reply.
As we will see, there are 2 key items to be highlighted:
- The frequency must be identical in the emitter and the receiver (eg: 433.1 MHz in this example).
- The encryption key must be identical on the both side.
Installing the RFM69 library
The Adafruit's FRM69HCW are provided with a MicroPython library available on GitHub.
You can download and copy the library manually to your board from the Repository.
First, open the repository, then navigate to the file lib/rfm69.py .
Follow the steps describes in the "BMP280 library installation" to copy the RFM69 library to your micropython board.
Once copied, you can also check the proper installation by typing from rfm69 import * .
The RFM69 library repository contains many examples of usage. Do not hesitate to check them!
About Antennas
 |
The RFM69HCW will not work without antenna, even at 1m distance of each other. |
For this example, a simple wire twisted in the antenna hole will do a great job for testing.
Please wait before soldering the wire inside the antenna hole!. The antenna hole can be populated with:
- a simple wire
- a µFl SMT antenna connector where you could plug various kind of antenna.
- a PCB SMA Connector where you could plus various kind of antenna.
A µFl connector (also named uFl) is looking to this:
A PCB SMA Connector is looking to this:
Frequency, Encryption & Power
To make the module communicating together:
- The module must be identical. You cannot mix them.
- The tuned frequency must be identical.
- The encryption key must be identical.
Tuned frequency
The tuned frequency is declared with a line like this:
...
rfm = RFM69( spi=spi, nss=nss, reset=rst )
rfm.frequency_mhz = 433.1
where the tuned frequency is directly assigned to the frequency_mhz property.
|
Use the frequency assigned to your team by the instructor. |
In packet radio, several teams can share the same frequency if they use distinct encryption key.
Like TCP (from TCP/IP network), the packet radio is able to detect packet collision and try to recover from it.
However, more teams share the same frequency, more collision we have.
Encyption Key
The module encrypts the data with AES-128.
The encryption key is defined with 16 bytes and assigned to the encryption_key property.
The code here below defines the key 1234567812345678 under binary format.
...
rfm = RFM69( spi=spi, nss=nss, reset=rst )
rfm.encryption_key = ( b"\x01\x02\x03\x04\x05\x06\x07\x08\x01\x02\x03\x04\x05\x06\x07\x08" )
It is also possible to defines the same key with a more user friendly code.
...
rfm = RFM69( spi=spi, nss=nss, reset=rst )
rfm.encryption_key = bytes( [1,2,3,4,5,6,7,8,1,2,3,4,5,6,7,8] )
|
It is highly recommended for each team to define its own encryption key. |
When all the teams do use the same frequency and the same key then they will all receives the messages from the other teams also sending messages. Your messages will also been received by all the other teams.
Transmission Power
The transmission power is set to 13 dBm by default (it is safer across all RFM modules, the library also work for RFM95).
The transmission power can be set from 14 to 20 dBm by assigning the tx_power property.
Lowest values requires less power. Less power means higher battery life but also smaller transmission distance.
rfm = RFM69( spi=spi, nss=nss, reset=rst )
# rfm.tx_power = 13 # 13 dBm = 20mW (default value, safer for all modules)
rfm.tx_power = 20 # 20 dBm = 100mW, 20 dBm for FRM69HW only
Tips & Tricks:
It is possible to estimate the transmission power (in milliWatts) by using the following function.
def dbm_to_mw(dBm):
""" Transform the power in dBm to its equivalent in milliWatt """
return 10**((dBm)/10.)
Written by Meurisse D. for MCHobby