sigrok - User contributions [en]

Protocol decoder:Cc1101

2019-03-29T16:45:39Z

Stan23: /* Decoder */ Screenshots added

{{Infobox protocol decoder
| id = cc1101
| name = CC1101
| description = Low-Power Sub-1 GHz RF Transceiver chip
| status = supported
| license = GPLv2+
| source_code_dir = cc1101
| image = [[File:CC1101_module.jpg|250px]]
| input = [[Protocol decoder:spi|spi]]
| output = cc1101
| probes = —
| optional_probes = —
| options = chip
}}

The '''cc1101''' protocol decoder supports the protocol spoken by the Texas Instruments [http://www.ti.com/product/CC1101 CC1101] sub-1 GHz transceiver chips.

== Hardware ==

Modules with these chips can be purchased fairly inexpensive from various online marketplaces. Most (all?) have an 8-pin header with the following pinout:

{| border="0" style="font-size: smaller; text-align: center" class="alternategrey sigroktable"
|-
! Pin
! Function
|-
| 1
| VCC
|-
| 2
| GND
|-
| 3
| MOSI
|-
| 4
| CLK
|-
| 5
| MISO
|-
| 6
| GDO2
|-
| 7
| GDO0
|-
| 8
| CSn
|}

== Protocol ==

The chip uses the standard SPI protocol and pins (CSn, SCK, MOSI, MISO), with the additional GDO0 and GDO2 pins. They are configurable and can be used to inform the SPI master about the completion of a packet reception/transmission.

SPI commands can have variable length, the CSn signal has to stay low during the whole command, and then go high after the last byte. The first byte of a command defines the type of the command, the chip always outputs its internal status register at the beginning. The following bytes are dependent on the command type, can be register values to write into the chip or payload data to send, or empty bytes that are ignored if the command only reads the output of the chip.

== Decoder ==

The <tt>cc1101</tt> decoder stacks on top of the [[Protocol decoder:spi|SPI decoder]] and decodes the commands to the chip and the responses of the chip, and also issues warnings for wrong/incomplete commands.

Some decoded commands in [[PulseView]]:

<gallery>
File:CC1101_PD_strobe.png|Decoded strobe command.
File:CC1101_PD_status_register_read.png|Decoded register read of the MARCSTATE register.
File:CC1101_PD_burst_write.png|Decoded burst write.
</gallery>

[[sigrok-cli]] can be used to decode the capture in the following way:


$ '''sigrok-cli -i sigrok-dumps/spi/cc1l01/cc1l01-read-write.sr \'''
'''-P spi:clk=CLK:mosi=MOSI:miso=MISO:cs=CS,cc1101'''
Status = "0x16"; STATE is RX, 0 bytes available in RX FIFO
Status read: PKTSTATUS (0x38) = "0x30"
STROBE "SIDLE"
Status = "0x31"; STATE is RX, 15 bytes free in TX FIFO
Status = "0x15"; STATE is IDLE, 15 bytes free in TX FIFO
Write: PKTCTRL1 (0x07) = "0x4C"
Status = "0x0"; STATE is IDLE, 0 bytes available in RX FIFO
Read: PKTCTRL1 (0x07) = "0x4C"
Status = "0x15"; STATE is IDLE, 15 bytes free in TX FIFO
Write: MCSM2 (0x16) = "0x1C"
Status = "0x0"; STATE is IDLE, 0 bytes available in RX FIFO
Read: MCSM2 (0x16) = "0x1C"
Status = "0x15"; STATE is IDLE, 15 bytes free in TX FIFO
Write: WOREVT1 (0x1E) = "0x2F"
Status = "0x0"; STATE is IDLE, 0 bytes available in RX FIFO
Read: WOREVT1 (0x1E) = "0x2F"
Status = "0x15"; STATE is IDLE, 15 bytes free in TX FIFO
Write: WOREVT0 (0x1F) = "0x65"
Status = "0x0"; STATE is IDLE, 0 bytes available in RX FIFO
Read: WOREVT0 (0x1F) = "0x65"
Status = "0x15"; STATE is IDLE, 15 bytes free in TX FIFO
Write: WORCTRL (0x20) = "0x78"
Status = "0x0"; STATE is IDLE, 0 bytes available in RX FIFO
Read: WORCTRL (0x20) = "0x78"
STROBE "SWORRST"
Status = "0x15"; STATE is IDLE, 15 bytes free in TX FIFO
STROBE "SWOR"
Status = "0x15"; STATE is IDLE, 15 bytes free in TX FIFO


The status response is decoded.

== Resources ==

* [http://www.ti.com/product/CC1101 Texas Instruments CC1101] ([http://www.ti.com/lit/ds/symlink/cc1101.pdf datasheet])

[[Category:Protocol decoder]]
[[Category:SPI]]

File:CC1101 PD status register read.png

2019-03-29T16:44:59Z

Stan23: /* Summary */

== Summary ==
decoded CC1101 register read (MARCSTATE status register)

== Licensing ==
{{PD}}

File:CC1101 PD status register read.png

2019-03-29T16:44:48Z

Stan23: /* Summary */

== Summary ==
decoded CC1101 register read (MARCCSTATE status register)

== Licensing ==
{{PD}}

File:CC1101 PD status register read.png

2019-03-29T16:44:39Z

Stan23: /* Summary */

== Summary ==
decoded CC1101 register read ( MARCCSTATE status register)

== Licensing ==
{{PD}}

File:CC1101 PD status register read.png

2019-03-29T16:43:03Z

Stan23: decoded CC1101 regsiter read (STATUS register)

== Summary ==
decoded CC1101 regsiter read (STATUS register)
== Licensing ==
{{PD}}

File:CC1101 PD burst write.png

2019-03-29T16:41:42Z

Stan23: decoded CC1101 burst write

== Summary ==
decoded CC1101 burst write
== Licensing ==
{{PD}}

File:CC1101 PD strobe.png

2019-03-29T16:40:00Z

Stan23: decoded CC1101 strobe command

== Summary ==
decoded CC1101 strobe command
== Licensing ==
{{PD}}

File:CC1101 module.jpg

2019-03-29T16:37:30Z

Stan23: /* Summary */

== Summary ==
2 slightly different modules containing TI CC1101 RF transceiver chips and components for 868 MHz

== Licensing ==
{{PD}}

Protocol decoder:Cc1101

2019-03-29T16:21:31Z

Stan23: created, using nrf24l01 as template

{{Infobox protocol decoder
| id = cc1101
| name = CC1101
| description = Low-Power Sub-1 GHz RF Transceiver chip
| status = supported
| license = GPLv2+
| source_code_dir = cc1101
| image = [[File:CC1101_module.jpg|250px]]
| input = [[Protocol decoder:spi|spi]]
| output = cc1101
| probes = —
| optional_probes = —
| options = chip
}}

The '''cc1101''' protocol decoder supports the protocol spoken by the Texas Instruments [http://www.ti.com/product/CC1101 CC1101] sub-1 GHz transceiver chips.

== Hardware ==

Modules with these chips can be purchased fairly inexpensive from various online marketplaces. Most (all?) have an 8-pin header with the following pinout:

{| border="0" style="font-size: smaller; text-align: center" class="alternategrey sigroktable"
|-
! Pin
! Function
|-
| 1
| VCC
|-
| 2
| GND
|-
| 3
| MOSI
|-
| 4
| CLK
|-
| 5
| MISO
|-
| 6
| GDO2
|-
| 7
| GDO0
|-
| 8
| CSn
|}

== Protocol ==

The chip uses the standard SPI protocol and pins (CSn, SCK, MOSI, MISO), with the additional GDO0 and GDO2 pins. They are configurable and can be used to inform the SPI master about the completion of a packet reception/transmission.

SPI commands can have variable length, the CSn signal has to stay low during the whole command, and then go high after the last byte. The first byte of a command defines the type of the command, the chip always outputs its internal status register at the beginning. The following bytes are dependent on the command type, can be register values to write into the chip or payload data to send, or empty bytes that are ignored if the command only reads the output of the chip.

== Decoder ==

The <tt>cc1101</tt> decoder stacks on top of the [[Protocol decoder:spi|SPI decoder]] and decodes the commands to the chip and the responses of the chip, and also issues warnings for wrong/incomplete commands.

Some decoded commands in [[PulseView]]:

<gallery>
ToDo
</gallery>

[[sigrok-cli]] can be used to decode the capture in the following way:


$ '''sigrok-cli -i sigrok-dumps/spi/cc1l01/cc1l01-read-write.sr \'''
'''-P spi:clk=CLK:mosi=MOSI:miso=MISO:cs=CS,cc1101'''
Status = "0x16"; STATE is RX, 0 bytes available in RX FIFO
Status read: PKTSTATUS (0x38) = "0x30"
STROBE "SIDLE"
Status = "0x31"; STATE is RX, 15 bytes free in TX FIFO
Status = "0x15"; STATE is IDLE, 15 bytes free in TX FIFO
Write: PKTCTRL1 (0x07) = "0x4C"
Status = "0x0"; STATE is IDLE, 0 bytes available in RX FIFO
Read: PKTCTRL1 (0x07) = "0x4C"
Status = "0x15"; STATE is IDLE, 15 bytes free in TX FIFO
Write: MCSM2 (0x16) = "0x1C"
Status = "0x0"; STATE is IDLE, 0 bytes available in RX FIFO
Read: MCSM2 (0x16) = "0x1C"
Status = "0x15"; STATE is IDLE, 15 bytes free in TX FIFO
Write: WOREVT1 (0x1E) = "0x2F"
Status = "0x0"; STATE is IDLE, 0 bytes available in RX FIFO
Read: WOREVT1 (0x1E) = "0x2F"
Status = "0x15"; STATE is IDLE, 15 bytes free in TX FIFO
Write: WOREVT0 (0x1F) = "0x65"
Status = "0x0"; STATE is IDLE, 0 bytes available in RX FIFO
Read: WOREVT0 (0x1F) = "0x65"
Status = "0x15"; STATE is IDLE, 15 bytes free in TX FIFO
Write: WORCTRL (0x20) = "0x78"
Status = "0x0"; STATE is IDLE, 0 bytes available in RX FIFO
Read: WORCTRL (0x20) = "0x78"
STROBE "SWORRST"
Status = "0x15"; STATE is IDLE, 15 bytes free in TX FIFO
STROBE "SWOR"
Status = "0x15"; STATE is IDLE, 15 bytes free in TX FIFO


The status response is decoded.

== Resources ==

* [http://www.ti.com/product/CC1101 Texas Instruments CC1101] ([http://www.ti.com/lit/ds/symlink/cc1101.pdf datasheet])

[[Category:Protocol decoder]]
[[Category:SPI]]

File:CC1101 module.jpg

2019-03-29T16:07:48Z

Stan23: 2 slightly different modules containing TI CC1101 RF transceiver chips

== Summary ==
2 slightly different modules containing TI CC1101 RF transceiver chips
== Licensing ==
{{PD}}