pybricks.messaging: Add empty module.

This will be used for wired and wireless messaging functions and classes.

This name was originally introduced in Pybricks 2.0 but was not included in Pybricks 3.0 since it was not used on Powered Up. It makes a comeback now, with backwards compatible classes.

Author: laurensvalk

bricks/_common/qstrdefs.h

@@ -27,6 +27,10 @@ Q(pybricks.hubs)
 Q(pybricks.iodevices)
 #endif
 
+#if PYBRICKS_PY_MESSAGING
+Q(pybricks.messaging)
+#endif
+
 #if PYBRICKS_PY_NXTDEVICES
 Q(pybricks.nxtdevices)
 #endif

bricks/_common/sources.mk

@@ -51,6 +51,7 @@ PYBRICKS_PYBRICKS_SRC_C = $(addprefix pybricks/,\
 	iodevices/pb_type_iodevices_pupdevice.c \
 	iodevices/pb_type_iodevices_xbox_controller.c \
 	iodevices/pb_type_uart_device.c \
+	messaging/pb_module_messaging.c \
 	nxtdevices/pb_module_nxtdevices.c \
 	nxtdevices/pb_type_nxtdevices_colorsensor.c \
 	nxtdevices/pb_type_nxtdevices_energymeter.c \

bricks/essentialhub/mpconfigport.h

@@ -38,6 +38,7 @@
 #define PYBRICKS_PY_IODEVICES_PUP_DEVICE        (1)
 #define PYBRICKS_PY_IODEVICES_UART_DEVICE       (1)
 #define PYBRICKS_PY_IODEVICES_XBOX_CONTROLLER   (1)
+#define PYBRICKS_PY_MESSAGING                   (1)
 #define PYBRICKS_PY_NXTDEVICES                  (0)
 #define PYBRICKS_PY_PARAMETERS                  (1)
 #define PYBRICKS_PY_PARAMETERS_BUTTON           (1)

bricks/ev3/mpconfigport.h

@@ -42,6 +42,7 @@
 #define PYBRICKS_PY_IODEVICES_PUP_DEVICE        (1)
 #define PYBRICKS_PY_IODEVICES_UART_DEVICE       (1)
 #define PYBRICKS_PY_IODEVICES_XBOX_CONTROLLER   (0)
+#define PYBRICKS_PY_MESSAGING                   (1)
 #define PYBRICKS_PY_NXTDEVICES                  (1)
 #define PYBRICKS_PY_PARAMETERS                  (1)
 #define PYBRICKS_PY_PARAMETERS_BUTTON           (1)

bricks/primehub/mpconfigport.h

@@ -35,6 +35,7 @@
 #define PYBRICKS_PY_IODEVICES_PUP_DEVICE         (1)
 #define PYBRICKS_PY_IODEVICES_XBOX_CONTROLLER   (1)
 #define PYBRICKS_PY_MEDIA_IMAGE                 (0)
+#define PYBRICKS_PY_MESSAGING                   (1)
 #define PYBRICKS_PY_NXTDEVICES                  (0)
 #define PYBRICKS_PY_PARAMETERS                  (1)
 #define PYBRICKS_PY_PARAMETERS_BUTTON           (1)

bricks/virtualhub/mpconfigport.h

@@ -38,6 +38,7 @@
 #define PYBRICKS_PY_IODEVICES_PUP_DEVICE        (0)
 #define PYBRICKS_PY_IODEVICES_UART_DEVICE       (0)
 #define PYBRICKS_PY_IODEVICES_XBOX_CONTROLLER   (1)
+#define PYBRICKS_PY_MESSAGING                   (1)
 #define PYBRICKS_PY_NXTDEVICES                  (0)
 #define PYBRICKS_PY_PARAMETERS                  (1)
 #define PYBRICKS_PY_PARAMETERS_BUTTON           (1)

pybricks/messaging/pb_module_messaging.c

@@ -0,0 +1,35 @@
+// SPDX-License-Identifier: MIT
+// Copyright (c) 2018-2021 The Pybricks Authors
+
+#include "py/mpconfig.h"
+
+#if PYBRICKS_PY_MESSAGING
+
+#include "py/mphal.h"
+#include "py/obj.h"
+#include "py/objstr.h"
+#include "py/runtime.h"
+#include "py/mperrno.h"
+
+#include <pbio/util.h>
+
+#include <pybricks/util_mp/pb_obj_helper.h>
+#include <pybricks/util_mp/pb_kwarg_helper.h>
+
+#include <pybricks/util_pb/pb_error.h>
+
+static const mp_rom_map_elem_t messaging_globals_table[] = {
+    { MP_ROM_QSTR(MP_QSTR___name__), MP_ROM_QSTR(MP_QSTR_messaging) },
+};
+static MP_DEFINE_CONST_DICT(pb_module_messaging_globals, messaging_globals_table);
+
+const mp_obj_module_t pb_module_messaging = {
+    .base = { &mp_type_module },
+    .globals = (mp_obj_dict_t *)&pb_module_messaging_globals,
+};
+
+#if !MICROPY_MODULE_BUILTIN_SUBPACKAGES
+MP_REGISTER_MODULE(MP_QSTR_pybricks_dot_messaging, pb_module_messaging);
+#endif
+
+#endif // PYBRICKS_PY_MESSAGING

pybricks/pybricks.c

@@ -66,6 +66,9 @@ extern const mp_obj_module_t pb_module_pupdevices;
 #if PYBRICKS_PY_IODEVICES
 extern const mp_obj_module_t pb_module_iodevices;
 #endif
+#if PYBRICKS_PY_MESSAGING
+extern const mp_obj_module_t pb_module_messaging;
+#endif
 #if PYBRICKS_PY_PARAMETERS
 extern const mp_obj_module_t pb_module_parameters;
 #endif
@@ -99,6 +102,9 @@ static const mp_rom_map_elem_t pybricks_globals_table[] = {
     #if PYBRICKS_PY_IODEVICES
     { MP_ROM_QSTR(MP_QSTR_iodevices), MP_ROM_PTR(&pb_module_iodevices) },
     #endif
+    #if PYBRICKS_PY_MESSAGING
+    { MP_ROM_QSTR(MP_QSTR_messaging), MP_ROM_PTR(&pb_module_messaging) },
+    #endif
     #if PYBRICKS_PY_PARAMETERS
     { MP_ROM_QSTR(MP_QSTR_parameters), MP_ROM_PTR(&pb_module_parameters) },
     #endif