Keine Beschreibung

Fabian Peter Hammerle 7be72eacfb workflow: fix typo in "python-version" variable's name		vor 2 Jahren
.github	7be72eacfb workflow: fix typo in "python-version" variable's name	vor 2 Jahren
cc1101	706ead5c4c pylint: enable various optional checks/extensions	vor 2 Jahren
examples	cebeeb5207 rename set/get_output_power_levels to set/get_output_power as a higher patable setting does not necessarily imply a higher output power level (see table 39)	vor 3 Jahren
tests	76a8257292 tests: ignore pylint's irrelevant duplicate-code warnings	vor 2 Jahren
.gitignore	f6fccfd243 pipeline: added pytest-cov	vor 3 Jahren
.pylintrc	706ead5c4c pylint: enable various optional checks/extensions	vor 2 Jahren
CHANGELOG.md	296016cc42 drop compatibility with python3.6	vor 2 Jahren
COPYING	994a9a5ede added GPLv3+	vor 4 Jahren
Pipfile	33cc4caacc dev env: re-add typed-ast to fix mypy on python3.7	vor 2 Jahren
Pipfile.lock	ef8e3ee207 Bump mypy from 0.960 to 0.961	vor 2 Jahren
README.md	bd9b03db92 readme: fix typo	vor 3 Jahren
mypy.ini	991cc935f0 mypy: ignore missing imports	vor 4 Jahren
setup.py	296016cc42 drop compatibility with python3.6	vor 2 Jahren

python-cc1101

Python Library & Command Line Tool to Transmit RF Signals via CC1101 Transceivers

Setup

$ pip3 install --user --upgrade cc1101

On Raspbian / Raspberry Pi OS, dependencies can optionally be installed via:

$ sudo apt-get install --no-install-recommends python3-spidev

Wiring Raspberry Pi

Connect the following pins directly:

CC1101	Raspberry Pi
VDD	3.3V (Pin 1 or 17)
SI	MOSI (Pin 19)
SO	MISO (Pin 21)
CSn	CE0 (Pin 24)
SCLK	SCLK (Pin 23)
GDO2*	Any GPIO pin, commonly GPIO25 (Pin 22) [1,2,3]
GDO0*	Any GPIO pin, GPIO24 (Pin 18) recommended
GND	Ground

No resistors required. Connection of pins marked with * is optional. GDO2 stays "high until power and crystal have stabilized" (see CHIP_RDYn in docs). GDO0 is used by .asynchronous_transmission() for data input.

If some of these pins are already in use, select a different SPI bus or chip select: https://www.raspberrypi.org/documentation/hardware/raspberrypi/spi/README.md (permalink)

Raspberry Pi GPIO docs: https://www.raspberrypi.org/documentation/usage/gpio/

Usage

Library

See examples.

import cc1101

with cc1101.CC1101() as transceiver:
    transceiver.set_base_frequency_hertz(433.92e6)
    print(transceiver)
    transceiver.transmit(b"\x01\xff\x00 message")

In case CC1101 is connected to a different SPI bus or chip select line than /dev/spidev0.0, use CC1101(spi_bus=?, spi_chip_select=?).

Command Line

$ printf '\x01\x02\x03' | cc1101-transmit -f 433920000 -r 1000

See cc1101-transmit --help.

Troubleshooting

In case a PermissionError gets raised, check the permissions of /dev/spidev*. You'll probably need sudo usermod -a -G spi $USER, followed by a re-login.

Consult CC1101's offical docs for an in-depth explanation of all options: https://www.ti.com/lit/ds/symlink/cc1101.pdf