Transparent Transmissions

These examples will show you how to send and receive messages in transparent mode.

In this mode, each device who share the same channel and address will be able to communicate with each other.

Receiver

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

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

examples/transmit_transparent/receiver.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 transparent transmission mode.  (Default)
e32.tx_mode = ebyte_e32.TransmissionMode.TRANSMISSION_TRANSPARENT

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

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

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()

Monitor

Monitors channel 4 for messages by using the 0xFFFF address.

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

examples/transmit_transparent/monitor.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 transparent transmission mode.  (Default)
e32.tx_mode = ebyte_e32.TransmissionMode.TRANSMISSION_TRANSPARENT

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

print(f"Monitoring 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()

Sender

Sends a 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_transparent/sender.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=0x1337, channel=4)

# Switching to transparent transmission mode.
e32.tx_mode = ebyte_e32.TransmissionMode.TRANSMISSION_TRANSPARENT

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

# Message content:
#  * Message: b'Hello World !'
# The target channel and address are the same as the module's.
message = b'Hello World !'

# Sending with helper
e32.send(message)

time.sleep(0.5)  # Waiting to prevent RF spamming

# Switching to an empty shared address and sending another message.
e32.address = 0xBEEF
message = b'You shouldn\'t receive this !'
e32.send(message)
e32.wait_aux()

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

Broadcast

Broadcasts a messages to all modules on channel 4 by using the 0xFFFF address.

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

examples/transmit_transparent/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=0xFFFF, channel=4)

# Switching to transparent transmission mode.
e32.tx_mode = ebyte_e32.TransmissionMode.TRANSMISSION_TRANSPARENT

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

# Message content:
#  * Message: b'Hello World !'
# The target channel is the same as the module's.
message = b'Hello World !'

# Sending with helper
e32.send(message)

time.sleep(0.5)  # Waiting to prevent RF spamming

# Switching to an empty channel and sending another message.
e32.channel = 5
message = b'You shouldn\'t receive this !'
e32.send(message)
e32.wait_aux()

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