Modifications

Sauter à la navigation Sauter à la recherche

ENG-CANSAT-MISSION1-RECEIVE (voir la source)

Version du 30 octobre 2018 à 21:46

6 309 octets ajoutés ,  30 octobre 2018 à 21:46
→‎Other options
Ligne 1 : Ligne 1 :  
{{ENG-CANSAT-NAV}}
 
{{ENG-CANSAT-NAV}}
   −
{{traduction}}
   
== Introduction ==
 
== Introduction ==
 
The following wiring will prepare the "Receiver Station" for the mission 1. From the "RFM69HCW Testing" section, we will use an Arduino UNO and RFM69HCW module to '''redirect the Radio Messages to the serial port'''.
 
The following wiring will prepare the "Receiver Station" for the mission 1. From the "RFM69HCW Testing" section, we will use an Arduino UNO and RFM69HCW module to '''redirect the Radio Messages to the serial port'''.
Ligne 61 : Ligne 60 :     
In the informations:
 
In the informations:
−
* '''len''': len of the data.
+
* '''data_len''': length of the data stream received.
 
* '''RSSI''': indicated the [https://en.wikipedia.org/wiki/Received_signal_strength_indication strength of the signal] (-15 at best, -90 at worst).
 
* '''RSSI''': indicated the [https://en.wikipedia.org/wiki/Received_signal_strength_indication strength of the signal] (-15 at best, -90 at worst).
 
* '''transmitted_data''': the data as transmitted by the emitter. As designed in the emitter, it starts with ''':''' and ends with ''';\r\n'''
 
* '''transmitted_data''': the data as transmitted by the emitter. As designed in the emitter, it starts with ''':''' and ends with ''';\r\n'''
 +
 +
In the '''transmitted_data''', we can identify:
 +
* The packet counter
 +
* The time counter (milliseconds)
 +
* The temperature (from tmp36)
 +
* The atmospheric pressure (from bmp280)
 +
* The temperature2 (from bmp280)
    
== The code explained ==
 
== The code explained ==
Ligne 76 : Ligne 82 :     
First, the script will includes all the needed libraries.
 
First, the script will includes all the needed libraries.
 +
 +
<syntaxhighlight lang="c">
 +
#include <SPI.h>
 +
#include <RH_RF69.h>
 +
</syntaxhighlight>
 +
 +
Then, it defines the parameters for the radio module and the pinout used to wire the RFM69HCW radio. The code adapt himself to the the board selected in the compiler.
 +
 +
The last line create the object {{fname|rf69}} to control the module.
 +
 +
<syntaxhighlight lang="c">
 +
#define RF69_FREQ 433.0
 +
 +
#if defined (__AVR_ATmega32U4__) // Feather 32u4 w/Radio
 +
  #define RFM69_CS      8
 +
  #define RFM69_INT    7
 +
  #define RFM69_RST    4
 +
  #define LED          13
 +
#endif
 +
 +
#if defined(ARDUINO_SAMD_FEATHER_M0) // Feather M0 w/Radio
 +
  #define RFM69_CS      8
 +
  #define RFM69_INT    3
 +
  #define RFM69_RST    4
 +
  #define LED          13
 +
#endif
 +
 +
#if defined (__AVR_ATmega328P__)  // Feather 328P w/wing (or Arduino UNO)
 +
  #define RFM69_INT    3  //
 +
  #define RFM69_CS      4  //
 +
  #define RFM69_RST    2  // "A"
 +
  #define LED          13
 +
#endif
 +
 +
#if defined(ESP8266)    // ESP8266 feather w/wing
 +
  #define RFM69_CS      2    // "E"
 +
  #define RFM69_IRQ    15  // "B"
 +
  #define RFM69_RST    16  // "D"
 +
  #define LED          0
 +
#endif
 +
 +
#if defined(ESP32)    // ESP32 feather w/wing
 +
  #define RFM69_RST    13  // same as LED
 +
  #define RFM69_CS      33  // "B"
 +
  #define RFM69_INT    27  // "A"
 +
  #define LED          13
 +
#endif
 +
 +
// Singleton instance of the radio driver
 +
RH_RF69 rf69(RFM69_CS, RFM69_INT);
 +
</syntaxhighlight>
 +
 +
The {{fname|setup()}} function:
 +
* initialize the serial connexion @ 115200 bauds
 +
* initialze the radio module
 +
 +
<syntaxhighlight lang="c">
 +
void setup() {
 +
  Serial.begin(115200);
 +
 +
  pinMode(LED, OUTPUT);   
 +
  pinMode(RFM69_RST, OUTPUT);
 +
  digitalWrite(RFM69_RST, LOW);
 +
 +
  Serial.println("[INFO] CanSat Belgium Radio Receiver (Radio to Serial)!");
 +
 +
  // manual reset
 +
  digitalWrite(RFM69_RST, HIGH);
 +
  delay(10);
 +
  digitalWrite(RFM69_RST, LOW);
 +
  delay(10);
 +
 
 +
  if (!rf69.init()) {
 +
    Serial.println("[ERROR] RFM69 radio init failed");
 +
    while (1);
 +
  }
 +
  Serial.println("[INFO] RFM69 radio init OK!");
 +
 
 +
  // Defaults after init are 434.0MHz, modulation GFSK_Rb250Fd250, +13dbM (for low power module)
 +
  // No encryption
 +
  if (!rf69.setFrequency(RF69_FREQ)) {
 +
    Serial.println("[ERROR] setFrequency failed");
 +
  }
 +
 +
  // When using High Power RF69, RFM69HW then the Tx power ishighpowermodule
 +
  // flag MUST be with to TRUE
 +
  rf69.setTxPower(20, true);  // Power range 14-20
 +
 +
  // The encryption key has to be the same as the one in the server
 +
  uint8_t key[] = { 0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07, 0x08,
 +
                    0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07, 0x08};
 +
  rf69.setEncryptionKey(key);
 +
 
 +
  pinMode(LED, OUTPUT);
 +
 +
  Serial.print("[INFO] RFM69 radio @");
 +
  Serial.print((int)RF69_FREQ);
 +
  Serial.println(" MHz");
 +
}
 +
</syntaxhighlight>
 +
 +
The main {{fname|loop()}} function just check if a new message arrives.
 +
 +
If so, it read the message and store it into {{fname|buf}} buffer.
 +
 +
Then, several {{fname|Serial.print()}} statement are used to send the data over the serial connexion.
 +
 +
Finally, the sketch sends an '''ACK''' confirmation message.
 +
 +
<syntaxhighlight lang="c">
 +
void loop() {
 +
if (rf69.available()) {
 +
    // Should be a message for us now 
 +
    uint8_t buf[RH_RF69_MAX_MESSAGE_LEN];
 +
    uint8_t len = sizeof(buf);
 +
    if (rf69.recv(buf, &len)) {
 +
      if (!len) return;
 +
      buf[len] = 0;
 +
      Serial.print("[DATA](len=" );
 +
      Serial.print(len);
 +
      Serial.print(",RSSI=");
 +
      Serial.print(rf69.lastRssi(), DEC);
 +
      Serial.print(")");
 +
      Serial.print((char*)buf); // Data send by remote is supposed to contains the \r\n
 +
 +
      // Send a reply!
 +
      uint8_t data[] = "ACK";
 +
      rf69.send(data, sizeof(data));
 +
      rf69.waitPacketSent();
 +
      Blink(LED, 50, 1); //blink LED 1 times, 50ms between blinks
 +
    }
 +
  }
 +
  else {
 +
    Blink(LED, 50, 3); //blink LED 3 times, 50ms between blinks
 +
  }
 +
}
 +
</syntaxhighlight>
 +
 +
The {{fname|Blink()}} function is used to signal error code (blink once when a message received, blink 3 times when having a communication error).
 +
 +
<syntaxhighlight lang="c">
 +
void Blink(byte PIN, byte DELAY_MS, byte loops) {
 +
  for (byte i=0; i<loops; i++)  {
 +
    digitalWrite(PIN,HIGH);
 +
    delay(DELAY_MS);
 +
    digitalWrite(PIN,LOW);
 +
    delay(DELAY_MS);
 +
  }
 +
}
 +
</syntaxhighlight>
    
== Compile and upload ==
 
== Compile and upload ==
Ligne 83 : Ligne 239 :  
Select the proper port in the menu '''Tools -> Port'''
 
Select the proper port in the menu '''Tools -> Port'''
   −
Then press the "compile" button.
+
Then press the "upload" button.
 +
 
 +
== Capturing data to file ==
 +
Having data available in the Arduino Serial Monitor is great... but capturing it without Arduino would be even better.
 +
 
 +
=== Putty ===
 +
The putty software (available on Windows, Mac, Linux) can be also be used to connect to the Arduino Serial Port interface
 +
 
 +
Here how it should be configured to capture the data.
 +
 
 +
[[Fichier:ENG-CANSAT-MISSION1-RECEIVE-30.png|360px]]
 +
 
 +
Putty also offers some logging capability that may be useful.
 +
 
 +
=== Linux command ===
 +
If you are addict to Linux or Raspberry-Pi board then you can easily view and capture the data with the following commnands.
 +
 
 +
cat /dev/ttyACM0 > output.dat
 +
 
 +
This command will redirect the content of the USB port to a file named {{fname|output.dat}} .
 +
 
 +
=== With Python ===
 +
The following Python script will capture a serial port (see {{fname|baud_rate}} variable) and write the content to a file (see {{fname|write_to_file_path}} variable).
 +
 
 +
The content of the file is reset when the script is started.
 +
 
 +
{{ambox-stop|text=Openning the Serial Port will issue the automatic Reset feature of the Arduino board.}}
 +
 +
<syntaxhighlight lang="python">
 +
import serial
 +
 
 +
serial_port = '/dev/ttyACM0';
 +
# depend on Serial.begin(baud_rate) in Arduino
 +
baud_rate = 115200;
 +
write_to_file_path = "output.txt";
 +
 
 +
output_file = open(write_to_file_path, "w+")
 +
ser = serial.Serial(serial_port, baud_rate)
 +
try:
 +
    while True:
 +
        line = ser.readline()
 +
        line = line.encode("utf-8") #ser.readline returns a binary, convert to string
 +
        print(line)
 +
        output_file.write(line)
 +
except KeyboardInterrupt:
 +
    print( 'User abord' )
 +
output_file.close()
 +
ser.close()
 +
</syntaxhighlight>
 +
 
 +
=== Other options ===
 +
You may find many other capture methods from Internet:
 +
* Free Software available on Internet
 +
* Source Code example for your favourite programming language.
    
{{ENG-CANSAT-TRAILER}}
 
{{ENG-CANSAT-TRAILER}}
Admin
Bureaucrates, Administrateurs
29 836

modifications

Récupérée de « https://wiki.mchobby.be/index.php?title=Spécial:MobileDiff/27530...27568 »

Menu de navigation