first commit

examples/serial/serial_gateway/serial_gateway.ino

@@ -0,0 +1,69 @@
+// serial_gateway.pde
+// This sketch can be used as a gateway between 2 RadioHead radio networks (connected by a serial line), 
+// or between 
+// 1 RadioHead radio network and a Unix host.
+// It relays all messages received on the radio driver to the serial port 
+// (using the RH_Serial driver and protocol). And it relays all messages received on the RH_Serial
+// driver port to the radio driver.
+// Both drivers operate in promiscuous mode and preserve all headers, so this sketch acts as 
+// a transparent gateway between RH_Serial and and other RadioHead driver.
+//
+// By replacing RH_Serial with another RadioHead driver, this can act as a universal gateway
+// between any 2 RadioHead networks.
+//
+// Tested with RF22 driver and RH_Serial driver. The serial port was connected to a Unix host, where the 
+// serial_reliable_datagram_server.pde was built and running like this:
+// tools/simBuild examples/serial/serial_reliable_datagram_server/serial_reliable_datagram_server.pde
+// RH_HARDWARESERIAL_DEVICE_NAME=/dev/ttyUSB1 ./serial_reliable_datagram_server
+// -*- mode: C++ -*-
+// 
+
+#include <SPI.h>
+#include <RH_RF22.h>
+#include <RH_Serial.h>
+
+// Singleton instance of the radio driver
+// You can use other radio drivers if you want
+RH_RF22 radio;
+// Singleton instance of the serial driver which relays all messages
+// via Serial to another RadioHead RH_Serial driver, perhaps on a Unix host.
+// You could use a different Serial if the arduino has more than 1, eg Serial1 on a Mega
+RH_Serial serial(Serial);
+
+void setup() 
+{
+  Serial.begin(9600);
+  if (!radio.init())
+    Serial.println("radio init failed");  
+  radio.setPromiscuous(true);
+  // Defaults after init are 434.0MHz, 0.05MHz AFC pull-in, modulation FSK_Rb2_4Fd36
+  if (!serial.init())
+    Serial.println("serial init failed");  
+  serial.setPromiscuous(true);
+}
+
+uint8_t buf[RH_SERIAL_MAX_MESSAGE_LEN];
+void loop()
+{
+  if (radio.available())
+  {    
+    uint8_t len = sizeof(buf);
+    radio.recv(buf, &len);
+    serial.setHeaderTo(radio.headerTo());
+    serial.setHeaderFrom(radio.headerFrom());
+    serial.setHeaderId(radio.headerId());
+    serial.setHeaderFlags(radio.headerFlags(), 0xFF); // Must clear all flags
+    serial.send(buf, len);
+  }
+  if (serial.available())
+  {
+    uint8_t len = sizeof(buf);
+    serial.recv(buf, &len);
+    radio.setHeaderTo(serial.headerTo());
+    radio.setHeaderFrom(serial.headerFrom());
+    radio.setHeaderId(serial.headerId());
+    radio.setHeaderFlags(serial.headerFlags(), 0xFF); // Must clear all flags
+    radio.send(buf, len);
+  }
+}
+