[Si443x] Renamed basic examples to _Blocking

This commit is contained in:
jgromes 2023-06-24 21:59:18 +02:00
parent 18307f478d
commit 06529844c3
3 changed files with 53 additions and 41 deletions

View file

@ -1,21 +1,26 @@
/* /*
RadioLib Si443x Receive Example RadioLib Si443x Blocking Receive Example
This example receives packets using Si443x FSK radio module. This example receives packets using Si443x FSK radio module.
To successfully receive data, the following settings have to be the same To successfully receive data, the following settings have to be the same
on both transmitter and receiver: on both transmitter and receiver:
- carrier frequency - carrier frequency
- bit rate - bit rate
- frequency deviation - frequency deviation
- sync word - sync word
Other modules from Si443x/RFM2x family can also be used. Using blocking receive is not recommended, as it will lead
to significant amount of timeouts, inefficient use of processor
time and can some miss packets!
Instead, interrupt receive is recommended.
For default module settings, see the wiki page Other modules from Si443x/RFM2x family can also be used.
https://github.com/jgromes/RadioLib/wiki/Default-configuration#si443xrfm2x
For full API reference, see the GitHub Pages For default module settings, see the wiki page
https://jgromes.github.io/RadioLib/ https://github.com/jgromes/RadioLib/wiki/Default-configuration#si443xrfm2x
For full API reference, see the GitHub Pages
https://jgromes.github.io/RadioLib/
*/ */
// include the library // include the library

View file

@ -1,19 +1,23 @@
/* /*
RadioLib Si443x Transmit Example RadioLib Si443x Blocking Transmit Example
This example transmits packets using Si4432 FSK radio module. This example transmits packets using Si4432 FSK radio module.
Each packet contains up to 64 bytes of data, in the form of: Each packet contains up to 64 bytes of data, in the form of:
- Arduino String - Arduino String
- null-terminated char array (C-string) - null-terminated char array (C-string)
- arbitrary binary data (byte array) - arbitrary binary data (byte array)
Other modules from Si443x/RFM2x family can also be used. Other modules from Si443x/RFM2x family can also be used.
For default module settings, see the wiki page Using blocking transmit is not recommended, as it will lead
https://github.com/jgromes/RadioLib/wiki/Default-configuration#si443xrfm2x to inefficient use of processor time!
Instead, interrupt transmit is recommended.
For full API reference, see the GitHub Pages For default module settings, see the wiki page
https://jgromes.github.io/RadioLib/ https://github.com/jgromes/RadioLib/wiki/Default-configuration#si443xrfm2x
For full API reference, see the GitHub Pages
https://jgromes.github.io/RadioLib/
*/ */
// include the library // include the library
@ -44,15 +48,15 @@ void setup() {
} }
} }
// counter to keep track of transmitted packets
int count = 0;
void loop() { void loop() {
Serial.print(F("[Si4432] Transmitting packet ... ")); Serial.print(F("[Si4432] Transmitting packet ... "));
// you can transmit C-string or Arduino string up to // you can transmit C-string or Arduino string up to
// 64 characters long // 64 characters long
// NOTE: transmit() is a blocking method! int state = radio.transmit("Hello World! #" + String(count++));
// See example Si443x_Transmit_Interrupt for details
// on non-blocking transmission method.
int state = radio.transmit("Hello World!");
// you can also transmit byte array up to 64 bytes long // you can also transmit byte array up to 64 bytes long
/* /*

View file

@ -1,19 +1,19 @@
/* /*
RadioLib Si443x Transmit with Interrupts Example RadioLib Si443x Transmit with Interrupts Example
This example transmits packets using Si4432 FSK radio module. This example transmits packets using Si4432 FSK radio module.
Each packet contains up to 64 bytes of data, in the form of: Each packet contains up to 64 bytes of data, in the form of:
- Arduino String - Arduino String
- null-terminated char array (C-string) - null-terminated char array (C-string)
- arbitrary binary data (byte array) - arbitrary binary data (byte array)
Other modules from Si443x/RFM2x family can also be used. Other modules from Si443x/RFM2x family can also be used.
For default module settings, see the wiki page For default module settings, see the wiki page
https://github.com/jgromes/RadioLib/wiki/Default-configuration#si443xrfm2x https://github.com/jgromes/RadioLib/wiki/Default-configuration#si443xrfm2x
For full API reference, see the GitHub Pages For full API reference, see the GitHub Pages
https://jgromes.github.io/RadioLib/ https://jgromes.github.io/RadioLib/
*/ */
// include the library // include the library
@ -80,6 +80,9 @@ void setFlag(void) {
transmittedFlag = true; transmittedFlag = true;
} }
// counter to keep track of transmitted packets
int count = 0;
void loop() { void loop() {
// check if the previous transmission finished // check if the previous transmission finished
if(transmittedFlag) { if(transmittedFlag) {
@ -109,13 +112,13 @@ void loop() {
// you can transmit C-string or Arduino string up to // you can transmit C-string or Arduino string up to
// 256 characters long // 256 characters long
transmissionState = radio.startTransmit("Hello World!"); transmissionState = radio.startTransmit("Hello World! #" + String(count++));
// you can also transmit byte array up to 64 bytes long // you can also transmit byte array up to 64 bytes long
/* /*
byte byteArr[] = {0x01, 0x23, 0x45, 0x67, byte byteArr[] = {0x01, 0x23, 0x45, 0x67,
0x89, 0xAB, 0xCD, 0xEF}; 0x89, 0xAB, 0xCD, 0xEF};
int state = radio.startTransmit(byteArr, 8); transmissionState = radio.startTransmit(byteArr, 8);
*/ */
} }
} }