{"id":13774922,"url":"https://github.com/bastilleresearch/scapy-radio","last_synced_at":"2025-05-11T07:30:55.949Z","repository":{"id":6280428,"uuid":"55267469","full_name":"BastilleResearch/scapy-radio","owner":"BastilleResearch","description":"scapy-radio (from original Hg repo)","archived":false,"fork":false,"pushed_at":"2023-02-27T10:59:16.000Z","size":1439,"stargazers_count":84,"open_issues_count":7,"forks_count":21,"subscribers_count":12,"default_branch":"master","last_synced_at":"2024-11-17T09:39:56.560Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/BastilleResearch.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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-04-01T23:07:29.000Z","updated_at":"2024-08-20T09:12:27.000Z","dependencies_parsed_at":"2024-01-15T04:05:51.530Z","dependency_job_id":"8fca74a8-87a2-47b5-b7b0-213f24030ed8","html_url":"https://github.com/BastilleResearch/scapy-radio","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/BastilleResearch%2Fscapy-radio","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BastilleResearch%2Fscapy-radio/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BastilleResearch%2Fscapy-radio/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BastilleResearch%2Fscapy-radio/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BastilleResearch","download_url":"https://codeload.github.com/BastilleResearch/scapy-radio/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253533161,"owners_count":21923373,"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-03T17:01:31.807Z","updated_at":"2025-05-11T07:30:55.093Z","avatar_url":"https://github.com/BastilleResearch.png","language":"Python","funding_links":[],"categories":["\u003ca id=\"01f99d208e245eb44f15f720043b50d4\"\u003e\u003c/a\u003eScapy"],"sub_categories":[],"readme":"# Introduction\n\nThis tool is a modified version of scapy that aims at providing an quick and\nefficient pentest tool with RF capabilities.\n\nIt includes:\n\n* A modified version of scapy that can leverage GNU Radio to handle a SDR card\n* GNU Radio flow graphs (GRC files) we have build that allows full duplex communication\n* GNU Radio blocks we have written to handle several protocols\n\n\n\n## Supported radio protocols:\n\n* Bluetooth LE (advertising only)\n* 802.15.4 (used by Zigbee, Xbee, 6LoWPAN)\n* ZWave (European frequency, 868MHz)\n\n\n# Requirements\n\nYou need to have a full working GNU Radio 3.7 installation.\n\n**Note**: You will need to edit GRC files if you are running with GNU Radio 3.7.5+\nbecause they changed the UHD Sink block (there is now 2 inputs, the first one being\nfor commands instead of samples).\n\nThe provided GRC files have been fully tested with an Ettus B210 SDR but they\nshould work just as fine with any other UHD compatible device.\n\nYou can also edit the GRC files to replace UHD Sink/Source blocks by the\ncorresponding Osmocom blocks. Don't forget to set the parameters correctly.\n\n\n# Installation\n\nWe tried to make the installation as easy as possible.\n\nIf you want to install everything, just launch:\n\n`$ ./install.sh`\n\nThe script will prompt you for your password to install the tools system-wide\nusing `sudo` command.\n\nUsage:\n\n`$ ./install.sh [scapy|grc|blocks] ...`\n\n\n## Options\n\n### scapy\nThis will install or update scapy installation. This option is useful when you\nhave added/modified layers and want to make them available in your system\n\n### grc\nThis will copy all the GRC files into `$HOME/.scapy/radio/` and it will also\nconvert them automatically into Python files using `grcc` command.\n\n### blocks\nThis will build all the extra blocks you have written for GNU Radio and install\nthem.\n\n\n# Usage\n\nThe tool can be launched by using the following command:\n\n`$ scapy-radio`\n\n## Switch between protocol\n\nOne in the scapy interactive shell, switching between radio protocols is as\nsimple as:\n\n` \u003e\u003e\u003e switch_radio_protocol(\"ZWave\")`\n\nYou can also specify the radio protocol directly to some \"radio-enabled\" functions:\n\n` \u003e\u003e\u003e sniff_radio(radio=\"ZWave\")`\n\n## Radio commands\n\n* `switch_radio_protocol(layer, *args, **kargs)`: change the current radio protocol\n* `sniffradio(opened_socket=None, radio=None, *args, **kargs)`: works like `sniff()`\n* `srradio(pkts, inter=0.1, *args, **kargs)`: works like `sr()`\n* `srradio1(pkts, *args, **kargs)`: works like `sr1()`\n* `gnuradio_get_vars(*args, **kargs)`: get variables for the running GRC\n* `gnuradio_set_vars(host=\"localhost\", port=8080, **kargs)`: set variable for the running GRC\n* `gnuradio_start_graph(host=\"localhost\", port=8080)`: resume the running GRC\n* `gnuradio_stop_graph(host=\"localhost\", port=8080)`: pause the running GRC\n\n\n## Reading / Writing PCAP files\n\nThe tool allows writing and reading back PCAP files with the usual `scapy` command:\n\n```python\n\u003e\u003e\u003e wrpcap(\"pcap-file.pcap\", pkts)\n\u003e\u003e\u003e pkts2 = rdpcap(\"pcap-file.pcap\")\n```\n\n\n# Tools\n\n## ZWave\n### Automaton\\_stop\\_alarm.py\n\nThis script is a scapy Automaton that will send a *switch off* ZWave packet each times it\nlistens a *switch on* ZWave packet.\n\nThe script has been used to successfully disable a ZWave siren alarm automatically.\n\n### passive\\_scan.py\n\nThis script intends to passively scan and map ZWave automation network.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbastilleresearch%2Fscapy-radio","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbastilleresearch%2Fscapy-radio","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbastilleresearch%2Fscapy-radio/lists"}