{"id":37702307,"url":"https://github.com/dtn7/rf95modem-go","last_synced_at":"2026-01-16T13:01:18.361Z","repository":{"id":98596936,"uuid":"216795163","full_name":"dtn7/rf95modem-go","owner":"dtn7","description":"Golang library to send and receive data over LoRa via a rf95modem","archived":false,"fork":false,"pushed_at":"2023-08-10T21:40:33.000Z","size":59,"stargazers_count":6,"open_issues_count":3,"forks_count":2,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-08-14T11:35:21.871Z","etag":null,"topics":["golang-library","lora","modem","rf95"],"latest_commit_sha":null,"homepage":"","language":"Go","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/dtn7.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-10-22T11:17:55.000Z","updated_at":"2024-06-24T20:42:34.000Z","dependencies_parsed_at":"2024-06-19T17:35:27.131Z","dependency_job_id":"1bc88894-2a7e-420e-81b3-b8be40708d6a","html_url":"https://github.com/dtn7/rf95modem-go","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/dtn7/rf95modem-go","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dtn7%2Frf95modem-go","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dtn7%2Frf95modem-go/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dtn7%2Frf95modem-go/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dtn7%2Frf95modem-go/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dtn7","download_url":"https://codeload.github.com/dtn7/rf95modem-go/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dtn7%2Frf95modem-go/sbom","scorecard":{"id":358513,"data":{"date":"2025-08-11","repo":{"name":"github.com/dtn7/rf95modem-go","commit":"c7b3c776152b78c4613b47935ead0af8d17e8b06"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3.4,"checks":[{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:16: update your workflow using https://app.stepsecurity.io/secureworkflow/dtn7/rf95modem-go/ci.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:18: update your workflow using https://app.stepsecurity.io/secureworkflow/dtn7/rf95modem-go/ci.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci.yml:26: update your workflow using https://app.stepsecurity.io/secureworkflow/dtn7/rf95modem-go/ci.yml/main?enable=pin","Info:   0 out of   2 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   1 third-party GitHubAction dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/ci.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Code-Review","score":0,"reason":"Found 0/29 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: GNU General Public License v3.0: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'main'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 1 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-18T10:11:57.553Z","repository_id":98596936,"created_at":"2025-08-18T10:11:57.559Z","updated_at":"2025-08-18T10:11:57.559Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28478886,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T11:59:17.896Z","status":"ssl_error","status_checked_at":"2026-01-16T11:55:55.838Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["golang-library","lora","modem","rf95"],"created_at":"2026-01-16T13:01:17.646Z","updated_at":"2026-01-16T13:01:18.356Z","avatar_url":"https://github.com/dtn7.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# rf95modem-go\n\n[![Go Reference](https://pkg.go.dev/badge/github.com/dtn7/rf95modem-go/rf95.svg)][godoc]\n![CI](https://github.com/dtn7/rf95modem-go/workflows/CI/badge.svg)\n\nGolang library to send and receive data over LoRa PHY via a serial connection to a [rf95modem].\n\nThis library was tested against the rf95modem commit [`8f163aa`][rf95modem-commit], slightly after version 0.7.3.\n\n\n## Library\n\nThe primary focus of this library is to send and receive data via LoRa's physical layer, LoRa PHY, with the help of a [rf95modem].\n\nTherefore the `rf95.Modem` allows direct interaction with a connected rf95modem, including configuration changes, sending, and receiving raw LoRa PHY messages.\nAdditionally the `rf95.Stream` allows using the known `io.Reader` and `io.Writer` interfaces for data exchange.\nA `rf95.Stream` is hooked to the `rf95.Modem` as a registered handler, where, of course, custom handlers can also be implemented and connected.\n\nThe following two short code examples are demonstrating how to use `rf95.Modem` and `rf95.Stream` on top.\nMore details are available in the [documentation][godoc].\nThere are also example programs available under `./cmd`, which are also described below.\n\n```go\n// Example of how to use a rf95.Modem to establish a connection, configure the\n// rf95modem, send some bytes and wait for the first answere.\n\npackage main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/dtn7/rf95modem-go/rf95\"\n)\n\nfunc checkError(err error) {\n\tif err != nil {\n\t\tpanic(err)\n\t}\n}\n\nfunc main() {\n\t// Create and configure a rf95.Modem for rf95modem usage\n\tmodem, err := rf95.OpenSerial(\"/dev/ttyUSB0\", context.Background())\n\tcheckError(err)\n\n\tcheckError(modem.Frequency(868.23))\n\tcheckError(modem.Mode(rf95.FastShortRange))\n\n\t// Broadcast a message\n\t_, err = modem.Transmit([]byte(\"Hello LoRa PHY from rf95modem{,-go}\"))\n\tcheckError(err)\n\n\t// Register a handler to print a received message and exit\n\tfinChan := make(chan struct{})\n\n\t_, err = modem.RegisterHandlers(func(rx rf95.RxMessage) {\n\t\tfmt.Printf(\"%#v\\n\", rx)\n\t\tclose(finChan)\n\t}, nil)\n\tcheckError(err)\n\n\t\u003c-finChan\n\n\tcheckError(modem.Close())\n}\n```\n\n```go\n// Another example which utilizes a rf95.Stream to send a local files and dump a\n// received sample to another file.\npackage main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\t\"io\"\n\t\"os\"\n\n\t\"github.com/dtn7/rf95modem-go/rf95\"\n)\n\nfunc checkError(err error) {\n\tif err != nil {\n\t\tpanic(err)\n\t}\n}\n\nfunc main() {\n\t// Create and configure a rf95.Modem for rf95modem usage\n\tmodem, err := rf95.OpenSerial(\"/dev/ttyUSB0\", context.Background())\n\tcheckError(err)\n\n\tcheckError(modem.Frequency(868.23))\n\tcheckError(modem.Mode(rf95.FastShortRange))\n\n\t// Create a rf95.Stream using our modem\n\tstream, err := rf95.NewStream(modem)\n\tcheckError(err)\n\n\t// Send part of our source code over LoRa, because we are so Free(tm)\n\tfOut, err := os.Open(\"rf95/modem.go\")\n\tcheckError(err)\n\tdefer fOut.Close()\n\n\tn, err := io.Copy(stream, fOut)\n\tcheckError(err)\n\tfmt.Printf(\"send %d bytes over LoRa\\n\", n)\n\n\t// Dump 256 bytes received via LoRa to a tempfile\n\tfIn, err := os.CreateTemp(\"\", \"lora_dump_\")\n\tcheckError(err)\n\tdefer fIn.Close()\n\n\tn, err = io.Copy(fIn, io.LimitReader(stream, 256))\n\tcheckError(err)\n\tfmt.Printf(\"wrote %d bytes received over LoRa to %s\\n\", n, fIn.Name())\n\n\tcheckError(modem.Close())\n}\n```\n\n## Example: rf95logger\n\nA simple logger script for incoming messages with their RSSI and SNR.\n\n```\n$ go build ./cmd/rf95logger\n```\n\n```\n# Logging messages from /dev/ttyUSB0 at 868.1 MHz on mode 1, fast+short range\n$ ./rf95logger /dev/ttyUSB0 868.1 1 | tee loralog.csv\n```\n\n\n## Example: rf95pty\n\nA small proof of concept is `rf95pty` to bind a [rf95modem] to a new pseudoterminal\ndevice. This code should work for POSIX operating systems.\n\n```\n$ go build ./cmd/rf95pty\n```\n\n```\n# Node A provides a shell over LoRa - stupid idea, btw\n\n$ ./rf95pty /dev/ttyUSB0\nStarting modem with Status(...)\nOpening pty device /dev/pts/5\n\n$ socat /dev/pts/5,raw,nonblock,echo=0 exec:sh,pty,stderr,setsid,sigint,sane\n```\n\n```\n# Node B uses this shell\n\n$ ./rf95pty /dev/ttyUSB1\nStarting modem with Status(...)\nOpening pty device /dev/pts/7\n\n$ screen /dev/pts/7\n```\n\n\n[godoc]: https://pkg.go.dev/github.com/dtn7/rf95modem-go/rf95\n[rf95modem]: https://github.com/gh0st42/rf95modem\n[rf95modem-commit]: https://github.com/gh0st42/rf95modem/commit/8f163aa23e6f0c1ca7403c13b0811366e40b7317\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdtn7%2Frf95modem-go","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdtn7%2Frf95modem-go","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdtn7%2Frf95modem-go/lists"}