Fixed Transmissions

These examples will show you how to send and receive messages in fixed mode in unicast and broadcast.

In this mode, each message needs to contain the target channel and address before the actual data.
You can also use the special 0xFFFF address to monitor or broadcast messages on a given channel.

Unicast Receiver

Waits on channel 4 with the 0x1337 address for any incoming unicast or broadcast messages.

⚠️ Received messages may be truncated at specific lengths depending on the frequencies and operating parameters used due to RF regulations.

examples/transmit_fixed/receiver_unicast.py

# SPDX-FileCopyrightText: 2023 Herwin Bozet
#
# SPDX-License-Identifier: Unlicense

import board
import time

import ebyte_e32

PIN_M0 = board.B3
PIN_M1 = board.B4
PIN_RXD = board.A2  # Pin marked as RX on the module
PIN_TXD = board.A3  # Pin marked as TX on the module
PIN_AUX = board.B7

e32 = ebyte_e32.E32Device(PIN_M0, PIN_M1, PIN_AUX, PIN_TXD, PIN_RXD, address=0x1337, channel=4)

# Switching to fixed transmission mode.
e32.tx_mode = ebyte_e32.TransmissionMode.TRANSMISSION_FIXED

# Switching to mode 0.  (Normal mode)
e32.mode = ebyte_e32.Modes.MODE_NORMAL

print(f"Waiting for messages... on channel {e32.channel} for 0x{e32.address:x}...")

while True:
    # Checking if the module sent us some data
    if e32.in_buffer > 0:
        # Wait for the module to finish receiving data
        e32.wait_aux()
        
        # We grab the data, and can process it here
        data = e32.read()
        
        # We print it and exit
        print(f"We received a {len(data)} byte(s) long message:")
        print(data)
    
    # If nothing was received, we wait.
    time.sleep(0.1)

print()
print("Now exiting...")
e32.deinit()

Monitoring Receiver

Waits on channel 4 with the special 0xFFFF address for any unicast or broadcast messages on that channel.

⚠️ Received messages may be truncated at specific lengths depending on the frequencies and operating parameters used due to RF regulations.

examples/transmit_fixed/receiver_broadcast.py

# SPDX-FileCopyrightText: 2023 Herwin Bozet
#
# SPDX-License-Identifier: Unlicense

import board
import time

import ebyte_e32

PIN_M0 = board.B3
PIN_M1 = board.B4
PIN_RXD = board.A2  # Pin marked as RX on the module
PIN_TXD = board.A3  # Pin marked as TX on the module
PIN_AUX = board.B7

e32 = ebyte_e32.E32Device(PIN_M0, PIN_M1, PIN_AUX, PIN_TXD, PIN_RXD, address=0xFFFF, channel=4)

# Switching to fixed transmission mode.
e32.tx_mode = ebyte_e32.TransmissionMode.TRANSMISSION_FIXED

# Switching to mode 0.  (Normal mode)
e32.mode = ebyte_e32.Modes.MODE_NORMAL

print(f"Monitoring for messages... on channel {e32.channel}...")

while True:
    # Checking if the module sent us some data
    if e32.in_buffer > 0:
        # Wait for the module to finish receiving data
        e32.wait_aux()
        
        # We grab the data, and can process it here
        data = e32.read()
        
        # We print it and exit
        print(f"We received a {len(data)} byte(s) long message:")
        print(data)
    
    # If nothing was received, we wait.
    time.sleep(0.1)

print()
print("Now exiting...")
e32.deinit()

Unicast Sender

Sends a unicast message to any modules on channel 4 with the 0x1337 address.

⚠️ Sent messages may be truncated at specific lengths depending on the frequencies and operating parameters used due to RF regulations.

examples/transmit_fixed/sender_unicast.py

# SPDX-FileCopyrightText: 2023 Herwin Bozet
#
# SPDX-License-Identifier: Unlicense

import board
import time

import ebyte_e32

PIN_M0 = board.IO13
PIN_M1 = board.IO12
PIN_RXD = board.IO11  # Pin marked as RX on the module
PIN_TXD = board.IO10  # Pin marked as TX on the module
PIN_AUX = board.IO9

e32 = ebyte_e32.E32Device(PIN_M0, PIN_M1, PIN_AUX, PIN_TXD, PIN_RXD, address=0xBEEF, channel=4)

# Switching to fixed transmission mode.
e32.tx_mode = ebyte_e32.TransmissionMode.TRANSMISSION_FIXED

# Switching to mode 0.  (Normal mode)
e32.mode = ebyte_e32.Modes.MODE_NORMAL

# Message content:
#  * Receiver's address: 0x1337  (b'\x13\x37')
#  * Receiver's channel: 4  (b'\x04')
#  * Message: b'Hello World !'
message = b'\x13\x37\x04Hello World !'

# Sending with helper
e32.send(message)

# The message may be truncated at specific lengths depending on the frequencies used.
# Please check the documentation for more information !

Broadcast Sender

Sends a broadcast message to any modules on channel 4 by using the target address 0xFFFF.

⚠️ Sent messages may be truncated at specific lengths depending on the frequencies and operating parameters used due to RF regulations.

examples/transmit_fixed/sender_broadcast.py

# SPDX-FileCopyrightText: 2023 Herwin Bozet
#
# SPDX-License-Identifier: Unlicense

import board
import time

import ebyte_e32

PIN_M0 = board.IO13
PIN_M1 = board.IO12
PIN_RXD = board.IO11  # Pin marked as RX on the module
PIN_TXD = board.IO10  # Pin marked as TX on the module
PIN_AUX = board.IO9

e32 = ebyte_e32.E32Device(PIN_M0, PIN_M1, PIN_AUX, PIN_TXD, PIN_RXD, address=0xBEEF, channel=4)

# Switching to fixed transmission mode.
e32.tx_mode = ebyte_e32.TransmissionMode.TRANSMISSION_FIXED

# Switching to mode 0.  (Normal mode)
e32.mode = ebyte_e32.Modes.MODE_NORMAL

# Message content:
#  * Receiver's address: 0xFFFF  (b'\xFF\xFF')
#  * Receiver's channel: 4  (b'\x04')
#  * Message: b'Hello World !'
message = b'\xFF\xFF\x04Hello World !'

# Sending with helper
e32.send(message)

# The message may be truncated at specific lengths depending on the frequencies used.
# Please check the documentation for more information !