{"id":13650748,"url":"https://github.com/RavenLRS/raven","last_synced_at":"2025-04-22T18:32:48.612Z","repository":{"id":66683341,"uuid":"131609763","full_name":"RavenLRS/raven","owner":"RavenLRS","description":"Raven Long Range System","archived":false,"fork":false,"pushed_at":"2020-06-04T11:49:50.000Z","size":13820,"stargazers_count":163,"open_issues_count":9,"forks_count":42,"subscribers_count":37,"default_branch":"master","last_synced_at":"2024-05-01T12:35:49.814Z","etag":null,"topics":["betaflight","crsf","fport","inav","lora","lrs","rc","sbus"],"latest_commit_sha":null,"homepage":null,"language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RavenLRS.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2018-04-30T15:01:01.000Z","updated_at":"2024-04-23T16:48:33.000Z","dependencies_parsed_at":"2024-01-03T04:47:53.715Z","dependency_job_id":"6ae3a194-1fe7-4fc2-ab3d-7d8da5a4fd6b","html_url":"https://github.com/RavenLRS/raven","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RavenLRS%2Fraven","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RavenLRS%2Fraven/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RavenLRS%2Fraven/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RavenLRS%2Fraven/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RavenLRS","download_url":"https://codeload.github.com/RavenLRS/raven/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223903168,"owners_count":17222495,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["betaflight","crsf","fport","inav","lora","lrs","rc","sbus"],"created_at":"2024-08-02T02:00:40.535Z","updated_at":"2024-11-10T01:31:07.903Z","avatar_url":"https://github.com/RavenLRS.png","language":"C","funding_links":[],"categories":["Libraries","RC Transmitters \u0026 Handcontroller 🎮"],"sub_categories":["Modules 🧩"],"readme":"# Raven Long Range System\n\n[![Build Status](https://travis-ci.com/RavenLRS/raven.svg?branch=master)](https://travis-ci.com/RavenLRS/raven)\n\nRaven is completely open source a long range system (LRS) based on LoRa\nwhich also supports peer to peer communications (so for example,\nflight controllers in aircrafts can talk directly to each other).\n\n# Main features\n\n- Long Range support using LoRa for the main RC link between TX and RX.\n- Full telemetry, integrated with the radio (voice alerts with OpenTX, etc...).\n- Supports 7 different bands: 147Mhz, 169Mhz, 315Mhz, 433Mhz, 470Mhz, 868Mhz and 915Mhz.\n- Up to 20 channels.\n- Support for P2P for aircraft to aircraft communication (either direct\nor via pilots on the ground). Allows, for example, displaying a radar in the\nOSD, automatically choosing a free VTX channel or automatically following\nanother aircraft.\n- OLED screens, both on the TX and RX with channel monitor, telemetry\nviewer and full configuration (requires at least one button on the board).\n- Bluetooth MSP bridge using the same serial port as the RC link (works with\nall the existing Betaflight/iNAV configurators with support for Bluetooth).\n- Support for OTA updates over Bluetooth (iOS and Android apps coming soon).\n- Model ID with 64 memory slots.\n- Fully configurable from the radio using CRSF scripts (crossfire.lua\nand device.lua).\n- Low latency. 250Hz between radio and TX as well as between TX and flight\ncontroller. Air protocol is limited to 100Hz for now, but will support up\nto 150hz with telemetry or 200hz without telemetry in the near future.\n- Multiple RX protocols supported (SBUS+SmartPort, FPort, MSP, CRSF, ...).\n- Support for backup batteries (useful for missing aircraft recovery).\n\n![Raven TX on a Q X7](docs/images/raven_qx7.png?raw=true \"Raven TX on a Q X7\")\n\n## Compiling Raven\n\nRaven is built on top of [esp-idf](https://github.com/espressif/esp-idf), but it includes it\nas a submodule, so you should only need to install the [Xtensa toolchain](https://docs.espressif.com/projects/esp-idf/en/stable/get-started/index.html)\n\nRaven you should install and configure it. Make sure to install version 3.0 by running\n`git checkout v3.0` (their instructions will give you the development version, not a stable one).\nDownload the required submodules by running `git submodule init` followed by `git submodule update -r` in the same directory that you have cloned the esp-idf repository (i.e. no need to clone the master esp-idf repository).\n\nThen, clone the Raven repository by running `git clone --recursive https://github.com/RavenLRS/raven.git`. Don't forget the `--recursive` option, since Raven\nuses submodules.\n\nFrom the directory where you've cloned Raven, run `PORT=\u003cport\u003e TARGET=\u003ctarget\u003e make erase flash` to flash a new module. For\nupdating a board which is already running Raven, omit the `erase` part to avoid wiping your configuration. The `erase` is only\nneeded for new boards, since they might come with some pre-flashed app that can interfere with Raven.\n\nRun `make` without any arguments to print the help, which includes additional instructions about the port naming as well as the\nvalid list of targets. Targets use the following naming convention:\n\n- [board-name]_tx: Raven with support for working as TX only (connected to the radio).\n- [board-name]_rx: Raven with support for working as RX only (connected to the flight controller or the servos/ESCs).\n- [board-name]_txrx: Raven with support for both TX and RX, controlled by an option. Note that type of build is mostly used\nfor development and troubleshooting. Most of the time you should flash the TX or the RX variants.\n\nIf you want to see the debug logs, you can use the builtin esp-idf monitor by running `PORT=\u003cport\u003e TARGET=\u003ctarget\u003e make monitor`.\n\n\n## Hardware setup\n\nA typical setup of 100mw TX and RX for 433Mhz or 868/916Mhz costs $20-30. All popular ESP32 boards with LoRa are supported and can be used as both TX and RX.\n\n## Getting started\n\nCheck [the documentation](docs/getting_started.md) to get up and running in no time!","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FRavenLRS%2Fraven","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FRavenLRS%2Fraven","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FRavenLRS%2Fraven/lists"}