User Tools

Site Tools


projects:crazyradio:python_lib

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
projects:crazyradio:python_lib [2015-08-06 11:46]
arnaud created
projects:crazyradio:python_lib [2020-05-12 14:15] (current)
kimberly
Line 1: Line 1:
 +
 +<WRAP center round important 60%>
 +This page has deprecated and moved to the new documentation framework of the main Bitcraze website. Please go to [[https://www.bitcraze.io/documentation/system/]]
 +</WRAP>
 ====== Python Crazyradio Library ====== ====== Python Crazyradio Library ======
  
Line 18: Line 22:
 </code> </code>
  
-Ths is an example on how to use the lib:+This is an example on how to use the lib:
  
 <code python> <code python>
Line 53: Line 57:
 ^ Returns     | None | ^ Returns     | None |
 ^ Description | Close the USB device. Should be called before closing the program. | ^ Description | Close the USB device. Should be called before closing the program. |
- 
-==  set_channel(self, channel) == 
-^ Name        | ''set_channel'' | 
-^ Parameters  | (int) channel | 
-^ Returns     | None | 
-^ Description | Set the Crazyradio channel. Channel must be between 0 and 125. Channels are spaced by 1MHz starting at 2400MHz and ending at 2525MHz. | 
  
 ==  set_channel(self, channel) == ==  set_channel(self, channel) ==
Line 70: Line 68:
 ^ Parameters  | (list of int) address | ^ Parameters  | (list of int) address |
 ^ Returns     | None | ^ Returns     | None |
-^ Description | Set the Crazyradio address. The address is 5 bytes long. It should be a list of 5 bytes values. |+^ Description | Set the Crazyradio address. The //address// is 5 bytes long. It should be a list of 5 bytes values. |
  
 ==  set_data_rate(self, datarate) == ==  set_data_rate(self, datarate) ==
Line 76: Line 74:
 ^ Parameters  | (int) datarate | ^ Parameters  | (int) datarate |
 ^ Returns     | None | ^ Returns     | None |
-^ Description | Set the Crazyradio datarate. Datarate is one of ''DR_250KPS'', ''DR_1MPS'' or ''DR_2MPS'' |+^ Description | Set the Crazyradio datarate. //Datarate// is one of ''DR_250KPS'', ''DR_1MPS'' or ''DR_2MPS'' |
  
 +==  set_power(self, power) ==
 +^ Name        | ''set_power'' |
 +^ Parameters  | (int) power |
 +^ Returns     | None |
 +^ Description | Set the Crazyradio transmit power. //Power// is one of ''P_M18DBM'', ''P_M12DBM'', ''P_M6DBM'' or ''P_0DBM'' respectively for -18dBm, -12dBm, -6dBm and 0dBm. |
 +
 +==  set_arc(self, arc) ==
 +^ Name        | ''set_arc'' |
 +^ Parameters  | (int) arc |
 +^ Returns     | None |
 +^ Description | Set the number of retry. 0<//arc//<15. See nRF24L01 documentation for more info. |
 +
 +==  set_ard_time(self, us) ==
 +^ Name        | ''set_ard_time'' |
 +^ Parameters  | (int) us |
 +^ Returns     | None |
 +^ Description | Set the time to wait for an Ack in micro seconds. 250<//us//<4000. The wait time for an Ack packet corresponds to the time to receive the biggest expected Ack. See nRF24L01 documentation for more info. |
 +
 +==  set_ard_bytes(self, nbytes) ==
 +^ Name        | ''set_ard_bytes'' |
 +^ Parameters  | (int) nbytes |
 +^ Returns     | None |
 +^ Description | Set the time to wait for an Ack in number of ack payload bytes. The Crazyradio will calculate the correct time with the currently selected datarate. |
 +
 +==  set_cont_carrier(self, active) ==
 +^ Name        | ''set_cont_carrier'' |
 +^ Parameters  | (bool) active |
 +^ Returns     | None |
 +^ Description | Enable or disable the continious carrier mode. In continious carrier the Crazyradio transmit a constant sinus at the currently set frequency (channel) and power. This is a test mode that can affect other 2.4GHz devices (ex. wifi) it should only be used in a lab for test purposes. |
 +
 +==  scan_channels(self, start, stop, packet) ==
 +^ Name        | ''scan_channels'' |
 +^ Parameters  | (int) start, (int) stop, (int) packet|
 +^ Returns     | (list) List of channels that Acked the packet |
 +^ Description | Sends \packet\ to all channels from start to stop. Returns a list of the channels for which an ACK was received. |
 +
 +==  send_packet(self, dataOut) ==
 +^ Name        | ''send_packet'' |
 +^ Parameters  | (list or tuple) dataOut |
 +^ Returns     | ([[#_radio_ack|_radio_ack]]) Ack status |
 +^ Description | Sends the packet //dataOut// on the configured channel and datarate. Waits for an ack and returns a _radio_ack object that contains the ack status and optional ack payload data. |
 ==== _radio_ack ==== ==== _radio_ack ====
  
 === Fields === === Fields ===
 +
 +^ (bool) ack | At ''True'' if an Ack packet has been receive (ie. if the packet was received by the device) |
 +^ (bool) powerDet | Indicate the nRF24LU1 power detector status. See nRF24LU1 documentation for more information. |
 +^ (int) retry | Number of retry before an ack was received |
 +^ (tuple) data | Data payload received in the Ack packet |
  
 === Methods === === Methods ===
  
 +None
  
  
  
projects/crazyradio/python_lib.1438854363.txt.gz · Last modified: 2015-08-06 11:46 by arnaud