libs/module: Optmize send method.

Signed-off-by: icyqwq <[email protected]>

Author: icyqwq

docs/en/module/lora.rst

@@ -2,7 +2,7 @@
 LoraModule
 ==========
 
-.. include:: ../refs/module.loramodule.ref
+.. include:: ../refs/module.lora.ref
 
 The LoRa433_V1.1 Module is part of the M5Stack stackable module series. It is a LoRa communication module that operates at a 433MHz frequency and utilizes the Ra-02 module (SX1278 chip) solution.
 
@@ -16,10 +16,19 @@ Micropython Example::
     import M5
     from M5 import *
     from module import LoraModule
-    lora = LoraModule()
+    lora = LoraModule(pin_irq=35, pin_rst=13) # basic
+    lora = LoraModule(pin_irq=35, pin_rst=25) # core2
+    lora = LoraModule(pin_irq=10, pin_rst=5) # cores3
     lora.send("Hello, LoRa!")
+    
     print(lora.recv())
     
+    def callback(received_data):
+        global lora
+        print(received_data)
+        lora.start_recv()
+    lora.set_irq_callback(callback)
+    lora.start_recv()
 
 UIFLOW2 Example:
 
@@ -35,7 +44,7 @@ Constructors
 
 .. class:: LoraModule(pin_cs, pin_irq, pin_rst, freq_band, sf, bw, coding_rate, preamble_len, output_power)
 
-	Initialize the LoRa module.
+    Initialize the LoRa module.
 
     :param int pin_cs: Chip select pin
     :param int pin_irq: Interrupt pin
@@ -59,6 +68,8 @@ Methods
 
     Send a data packet.
 
+    :return (int): The return value is the timestamp when transmission completed, as a`time.ticks_ms()` result. It will be more accurate if the modem was initialized to use interrupts.
+
     :param  packet: The data packet to send.
     :param  tx_at_ms: Time to transmit the packet in milliseconds. For precise timing of sent packets, there is an optional `tx_at_ms` argument which is a timestamp (as a `time.ticks_ms()` value). If set, the packet will be sent as close as possible to this timestamp and the function will block until that time arrives
 
@@ -70,6 +81,8 @@ Methods
 
     Receive a data packet.
 
+    :return (RxPacket): Returns None on timeout, or an `RxPacket` instance with the packet on success.
+
     :param  timeout_ms: Optional, sets a receive timeout in milliseconds. If None (default value), then the function will block indefinitely until a packet is received.
     :param int rx_length: Necessary to set if `implicit_header` is set to `True` (see above). This is the length of the packet to receive. Ignored in the default LoRa explicit header mode, where the received radio header includes the length.
     :param RxPacket rx_packet: Optional, this can be an `RxPacket` object previously received from the modem. If the newly received packet has the same length, this object is reused and returned to save an allocation. If the newly received packet has a different length, a new `RxPacket` object is allocated and returned instead.
@@ -78,6 +91,57 @@ Methods
 
         |recv.svg|
 
+.. method:: LoraModule.start_recv()
+
+    Start receiving data once, trigger an interrupt when data is received.
+
+
+
+    UIFLOW2:
+
+        |start_recv.svg|
+
+.. method:: LoraModule.set_irq_callback(callback)
+
+    Set the IRQ callback function.
+
+
+    :param  callback: The callback function. The function should accept one argument, which is the received data.
+
+    UIFLOW2:
+
+        |set_irq_callback.svg|
+
+.. method:: LoraModule.standby()
+
+    Set the modem to standby mode.
+
+
+
+    UIFLOW2:
+
+        |standby.svg|
+
+.. method:: LoraModule.sleep()
+
+    Set the modem to sleep mode.
+
+
+
+    UIFLOW2:
+
+        |sleep.svg|
+
+.. method:: LoraModule.irq_triggered()
+
+    Check if the IRQ has been triggered.
+
+
+
+    UIFLOW2:
+
+        |irq_triggered.svg|
+
 
 
 Constants
@@ -88,9 +152,9 @@ Constants
 
     Select the LoRa frequency band.
 
-	
+    
 .. data:: LoraModule.BANDWIDTHS
 
     Valid bandwidth
 
-	
+    

docs/en/refs/module.lora.ref

@@ -4,10 +4,14 @@
     :height: 200px
     :width: 200px
 
-.. |init.svg| image:: https://static-cdn.m5stack.com/mpy_docs/module/loramodule/init.svg
-.. |_validate_range.svg| image:: https://static-cdn.m5stack.com/mpy_docs/module/loramodule/_validate_range.svg
-.. |send.svg| image:: https://static-cdn.m5stack.com/mpy_docs/module/loramodule/send.svg
-.. |recv.svg| image:: https://static-cdn.m5stack.com/mpy_docs/module/loramodule/recv.svg
+.. |init.svg| image:: https://static-cdn.m5stack.com/mpy_docs/module/lora/init.svg
+.. |send.svg| image:: https://static-cdn.m5stack.com/mpy_docs/module/lora/send.svg
+.. |recv.svg| image:: https://static-cdn.m5stack.com/mpy_docs/module/lora/recv.svg
+.. |start_recv.svg| image:: https://static-cdn.m5stack.com/mpy_docs/module/lora/start_recv.svg
+.. |set_irq_callback.svg| image:: https://static-cdn.m5stack.com/mpy_docs/module/lora/set_irq_callback.svg
+.. |standby.svg| image:: https://static-cdn.m5stack.com/mpy_docs/module/lora/standby.svg
+.. |sleep.svg| image:: https://static-cdn.m5stack.com/mpy_docs/module/lora/sleep.svg
+.. |irq_triggered.svg| image:: https://static-cdn.m5stack.com/mpy_docs/module/lora/irq_triggered.svg
 
-.. |example.svg| image:: https://static-cdn.m5stack.com/mpy_docs/module/loramodule/example.svg
+.. |example.svg| image:: https://static-cdn.m5stack.com/mpy_docs/module/lora/example.svg
 

m5stack/libs/module/lora.py

@@ -140,6 +140,13 @@ def send(self, packet, tx_at_ms=None) -> int:
         return:
             note: The return value is the timestamp when transmission completed, as a`time.ticks_ms()` result. It will be more accurate if the modem was initialized to use interrupts.
         """
+        if isinstance(packet, str):
+            packet = bytes(packet, "utf-8")
+        elif isinstance(packet, list | tuple):
+            packet = bytes(packet)
+        elif isinstance(packet, int):
+            packet = bytes([packet])
+
         return self.modem.send(packet, tx_at_ms)
 
     def recv(self, timeout_ms=None, rx_length=0xFF, rx_packet: RxPacket = None) -> RxPacket: