{"id":13673764,"url":"https://github.com/travisgoodspeed/loraham","last_synced_at":"2025-10-10T15:33:53.679Z","repository":{"id":70896685,"uuid":"69190814","full_name":"travisgoodspeed/loraham","owner":"travisgoodspeed","description":"Ham radio protocols and Arduino examples for LoRa on 70cm.","archived":false,"fork":false,"pushed_at":"2020-05-09T18:08:20.000Z","size":70,"stargazers_count":273,"open_issues_count":9,"forks_count":28,"subscribers_count":51,"default_branch":"master","last_synced_at":"2025-04-02T16:50:17.970Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/travisgoodspeed.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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":"2016-09-25T21:11:17.000Z","updated_at":"2025-03-22T16:39:14.000Z","dependencies_parsed_at":"2024-01-17T04:52:47.998Z","dependency_job_id":null,"html_url":"https://github.com/travisgoodspeed/loraham","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/travisgoodspeed%2Floraham","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/travisgoodspeed%2Floraham/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/travisgoodspeed%2Floraham/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/travisgoodspeed%2Floraham/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/travisgoodspeed","download_url":"https://codeload.github.com/travisgoodspeed/loraham/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248126259,"owners_count":21051887,"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":[],"created_at":"2024-08-02T11:00:21.864Z","updated_at":"2025-10-10T15:33:53.620Z","avatar_url":"https://github.com/travisgoodspeed.png","language":"C++","funding_links":[],"categories":["Projects"],"sub_categories":[],"readme":"# LoRaHam\n\nThis project consists of ham radio protocols and Arduino examples for\nLoRa on 70cm.  The code, the protocols, and the hardware have all been\nintentionally kept simple for easy experimentation, in the interest of\ngetting folks to build things and to put their projects on the air.\n\nThis project has only recently been made public; please join us in\n`#loraham` on Freenode if you'd like to play along.\n\n# Getting Started\n\nYou will need to buy Adafruit M0 LoRa Feather boards, which can be\nprogrammed to act as Beacons, Gateways, and Terminals.  You should be\nrunning the latest Arduino environment, with the Adafruit board\ndefinitions and the RadioHead radio library.\n\nhttp://www.airspayce.com/mikem/arduino/RadioHead/\n\n# Basics of the Protocol\n\nA Beacon is just a transmitter, and nothing else.  It doesn't receive\npackets, but once every five or more minutes, it will transmit a quick\nburst with a voltage, a sequence number, and maybe another sensor\nreading.  A beacon's packet is addressed to the callsign \"BEACON\" from\nits own callsign, which is followed by a suffix.  Comments can come\nlater.  For example, this is my solar powered beacon that won't\ntransmit on low voltage.\n\n```\nBEACON KK4VCZ-16 VCC=3.718945 count=437 Solar. No TX on low voltage.\n```\n\nThese messages are then repeated by Gateways, which you might also\ncall a Digipeater.  Gateways are optionally connected to the Internet,\nin order to share their packets with the wider world.  When a gateway\ntransmits a packet, it appends a second line addressed to `RT`\n(retransmit) from its own callsign and optional observations of the\nreceived signal strength.  In this example, `KK4VCZ-16` is the Beacon\nand `KM4BBD-10` is the Gateway.\n\n```\nBEACON KK4VCZ-16 VCC=3.718945 count=437 Solar. No TX on low voltage.\nRT KM4BBD-10 rssi=-46\n```\n\nFinally, you might want to use a LoRaHam network for your own personal\nmessages on an interactive Terminal.  In this case, you will send the\ninitial packet in the form of ``DESTINATION SOURCE Text``.  So when\n`KK4VCZ` sends a message to `KC3BVL`, it'll look like this.\n\n```\nKC3BVL KK4VCZ Hey Jim, it's Travis.  Care for a beer?\n```\n\nThe packet might be retransmitted by a gateway or two, so when Jim\n(`KC3BVL`) receives the packet, it might look like the following if\nrepeated by `KM4BBD-10` and `AB3XL-13`.  Note that the first line is\nunchanged, and also that you can graph the path that the packet took\nby looking at the later lines.\n\n```\nKC3BVL KK4VCZ Hey Jim, it's Travis.  Care for a beer?\nRT KM4BBD-10 rssi=-46\nRT AB3XL-13 rssi=-80\n```\n\nThe extra lines are added in order, so the packet went from `KK4VCZ`\nto `KM4BBD-10` to `AB3XL-13` to `KC3BVL`.  Just like on the first\nline, the destination is always listed first and the source listed\nsecond.\n\n\n# Hardware Designs\n\nSee the Wiki at https://github.com/travisgoodspeed/loraham/wiki for\nour hardware reference designs.  In brief, we are simply powering\nAdafruit LoRa Feather 434MHz boards with solar-charging motion\nactivated light boxes from which the lights have been torn out.\n\n# Active Networks\n\nThe first LoRaHam network was born and raised in West Philadelphia, on\nthe airwaves it passes packets each day.  Other networks are planned;\nplease say Howdy in the IRC channel if you'd like to start one.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftravisgoodspeed%2Floraham","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftravisgoodspeed%2Floraham","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftravisgoodspeed%2Floraham/lists"}