Code Monkey home page Code Monkey logo

rfm69's Introduction

RFM69 Library

Build Status GitHub release GitHub issues GitHub pull requests license

By Felix Rusu, LowPowerLab.com
RFM69 library for RFM69W, RFM69HW, RFM69CW, RFM69HCW (semtech SX1231, SX1231H)
The latest examples, new features and bug fixes are found in the original repository of this library.

License

GPL 3.0, please see the License.txt file for details. Be sure to include the same license with any fork or redistribution of this library.

Features

  • easy to use API with a few simple functions for basic usage
  • 1023 possible nodes on 256 possible networks
  • 61 bytes max message length (limited to 61 to support AES hardware encryption)
  • customizable transmit power (32 levels) for low-power transmission control
  • sleep function for power saving
  • automatic ACKs with the sendWithRetry() function
  • hardware 128bit AES encryption
  • hardware preamble, synch recognition and CRC check
  • digital RSSI can be read at any time with readRSSI()
  • interrupt driven
  • tested on all Moteinos & many custom boards designed by LowPowerLab
  • works with RFM69W, RFM69HW, RFM69CW, RFM69HCW, Semtech SX1231/SX1231H transceivers
  • promiscuous mode allows any node to listen to any packet on same network

Library Installation (Arduino IDE)

Copy the content of this library in the "Arduino/libraries/RFM69" folder.
To find your Arduino folder go to File>Preferences in the Arduino IDE.
See this tutorial on Arduino libraries.

Hardware & programming

The easiest way to get started is with the well documented and supported Moteino microcontroller platform which is easily programmable from the Arduino IDE. This includes the Moteino, MoteinoUSB & MoteinoMEGA. RFM69 transceivers were extensively tested on Moteinos for the purpose of building internet of things (IoT) devices that can be controlled wirelessly. This platform has matured over time and there is now a dedicated page where you can review how these devices can interact with each other via a RaspberryPi gateway interface. Here's a video overview:
https://www.youtube.com/watch?v=YUUZ6k0pBHg
https://www.youtube.com/watch?v=I9MNZQgqKHA
https://www.youtube.com/watch?v=F15dEqZ4pMM

Basic sample usage

  • The Gateway example listens for incoming data from remote nodes and responds to any ACK requests
  • The Node example is a loop that sends increasingly longer packets to the gateway and waits for an ACK each time
  • More examples are added from time to time, check all the examples, visit the LowPowerLab blog for latest news and projects, and check out the LowPowerLab forums for projects and discussion

Blog writeup

See the library release blog post

Why RFM69

  • I have spent a lot of time developing this library for RFM69W/CW/HW/HCW transceivers. I made it open source because I believe a lot of people can benefit from this new powerful transceiver. I hope others will also contribute and build on my work
  • I have long researched alternative transceivers for RFM12B which is still an excellent transceiver but it is much lower output power and has limited built in features which need to be implemented in firmware (PREAMBLE, SYNC, CRC, packet engine, encryption etc).
  • I wanted a transceiver that could still be very small, easy to use, and have the longer range that I needed
  • RFM69 comes in 2 variants: RFM69W/CW (13dBm, 45mA TX) and RFM69HW/HCW (20dBm, 130mA TX). They are not pin compatible. The RFM69HCW is generally recommended since it has the extra power when needed.

RFM69 range and antennas

  • I have tested open-air range on these transceivers in various combinations.
  • I am happy to say that a range of upwards of 400m can be achieved with the default settings provided in the library. Some users reported upwards of 500m by lowering the bitrate, and a forum user reported 1.5miles at 1.2Kbps: see this forum post and this blog page
  • The caveat with these higher RF power units is that they need more DC power when they transmit. For battery powered motes, you will need to keep them powered down and only transmit periodically. Use the sleep() function to put the radios in low power mode and use the LowPower library to power down your Moteino.
  • The RFM69 ATC feature enables keeping transmit power only at the required level to achieve the desired RSSI at the receiving end, see examples for usage

rfm69's People

Contributors

lowpowerlab avatar damadmai avatar ortegafernando avatar atalonica avatar ivankravets avatar rlpipkin avatar androlgenhald avatar brainelectronics avatar lukagith avatar sraillard avatar per1234 avatar dekay avatar mcspr avatar strange-v avatar wifixcort avatar markbergsma avatar jdede avatar christineyen avatar ademuri avatar drewblessing avatar underscoreho avatar jgillula avatar maxgerhardt avatar janhrach avatar spetrow avatar haschler avatar plattrap avatar renno-bih avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.