LCOV - code coverage report
Current view: top level - flamenco/nanopb - pb.h (source / functions) Hit Total Coverage
Test: cov.lcov Lines: 34 37 91.9 %
Date: 2024-11-13 11:58:15 Functions: 0 0 -

          Line data    Source code
       1             : /* Common parts of the nanopb library. Most of these are quite low-level
       2             :  * stuff. For the high-level interface, see pb_encode.h and pb_decode.h.
       3             :  */
       4             : 
       5             : #ifndef PB_H_INCLUDED
       6             : #define PB_H_INCLUDED
       7             : 
       8             : /*****************************************************************
       9             :  * Nanopb compilation time options. You can change these here by *
      10             :  * uncommenting the lines, or on the compiler command line.      *
      11             :  *****************************************************************/
      12             : 
      13             : /* Enable support for dynamically allocated fields */
      14             : /* #define PB_ENABLE_MALLOC 1 */
      15             : 
      16             : /* Define this if your CPU / compiler combination does not support
      17             :  * unaligned memory access to packed structures. Note that packed
      18             :  * structures are only used when requested in .proto options. */
      19             : /* #define PB_NO_PACKED_STRUCTS 1 */
      20             : 
      21             : /* Increase the number of required fields that are tracked.
      22             :  * A compiler warning will tell if you need this. */
      23             : /* #define PB_MAX_REQUIRED_FIELDS 256 */
      24             : 
      25             : /* Add support for tag numbers > 65536 and fields larger than 65536 bytes. */
      26             : /* #define PB_FIELD_32BIT 1 */
      27             : 
      28             : /* Disable support for error messages in order to save some code space. */
      29             : /* #define PB_NO_ERRMSG 1 */
      30             : 
      31             : /* Disable support for custom streams (support only memory buffers). */
      32             : /* #define PB_BUFFER_ONLY 1 */
      33             : 
      34             : /* Disable support for 64-bit datatypes, for compilers without int64_t
      35             :    or to save some code space. */
      36             : /* #define PB_WITHOUT_64BIT 1 */
      37             : 
      38             : /* Don't encode scalar arrays as packed. This is only to be used when
      39             :  * the decoder on the receiving side cannot process packed scalar arrays.
      40             :  * Such example is older protobuf.js. */
      41             : /* #define PB_ENCODE_ARRAYS_UNPACKED 1 */
      42             : 
      43             : /* Enable conversion of doubles to floats for platforms that do not
      44             :  * support 64-bit doubles. Most commonly AVR. */
      45             : /* #define PB_CONVERT_DOUBLE_FLOAT 1 */
      46             : 
      47             : /* Check whether incoming strings are valid UTF-8 sequences. Slows down
      48             :  * the string processing slightly and slightly increases code size. */
      49             : /* #define PB_VALIDATE_UTF8 1 */
      50             : 
      51             : /* This can be defined if the platform is little-endian and has 8-bit bytes.
      52             :  * Normally it is automatically detected based on __BYTE_ORDER__ macro. */
      53             : /* #define PB_LITTLE_ENDIAN_8BIT 1 */
      54             : 
      55             : /* Configure static assert mechanism. Instead of changing these, set your
      56             :  * compiler to C11 standard mode if possible. */
      57             : /* #define PB_C99_STATIC_ASSERT 1 */
      58             : /* #define PB_NO_STATIC_ASSERT 1 */
      59             : 
      60             : /******************************************************************
      61             :  * You usually don't need to change anything below this line.     *
      62             :  * Feel free to look around and use the defined macros, though.   *
      63             :  ******************************************************************/
      64             : 
      65             : 
      66             : /* Version of the nanopb library. Just in case you want to check it in
      67             :  * your own program. */
      68             : #define NANOPB_VERSION "nanopb-0.4.8-dev"
      69             : 
      70             : /* Include all the system headers needed by nanopb. You will need the
      71             :  * definitions of the following:
      72             :  * - strlen, memcpy, memset functions
      73             :  * - [u]int_least8_t, uint_fast8_t, [u]int_least16_t, [u]int32_t, [u]int64_t
      74             :  * - size_t
      75             :  * - bool
      76             :  *
      77             :  * If you don't have the standard header files, you can instead provide
      78             :  * a custom header that defines or includes all this. In that case,
      79             :  * define PB_SYSTEM_HEADER to the path of this file.
      80             :  */
      81             : #ifdef PB_SYSTEM_HEADER
      82             : #include PB_SYSTEM_HEADER
      83             : #else
      84             : #include <stdint.h>
      85             : #include <stddef.h>
      86             : #include <stdbool.h>
      87             : #include <string.h>
      88             : #include <limits.h>
      89             : 
      90             : #ifdef PB_ENABLE_MALLOC
      91             : #include <stdlib.h>
      92             : #endif
      93             : #endif
      94             : 
      95             : #ifdef __cplusplus
      96             : extern "C" {
      97             : #endif
      98             : 
      99             : /* Macro for defining packed structures (compiler dependent).
     100             :  * This just reduces memory requirements, but is not required.
     101             :  */
     102             : #if defined(PB_NO_PACKED_STRUCTS)
     103             :     /* Disable struct packing */
     104             : #   define PB_PACKED_STRUCT_START
     105             : #   define PB_PACKED_STRUCT_END
     106             : #   define pb_packed
     107             : #elif defined(__GNUC__) || defined(__clang__)
     108             :     /* For GCC and clang */
     109             : #   define PB_PACKED_STRUCT_START
     110             : #   define PB_PACKED_STRUCT_END
     111             : #   define pb_packed __attribute__((packed))
     112             : #elif defined(__ICCARM__) || defined(__CC_ARM)
     113             :     /* For IAR ARM and Keil MDK-ARM compilers */
     114             : #   define PB_PACKED_STRUCT_START _Pragma("pack(push, 1)")
     115             : #   define PB_PACKED_STRUCT_END _Pragma("pack(pop)")
     116             : #   define pb_packed
     117             : #elif defined(_MSC_VER) && (_MSC_VER >= 1500)
     118             :     /* For Microsoft Visual C++ */
     119             : #   define PB_PACKED_STRUCT_START __pragma(pack(push, 1))
     120             : #   define PB_PACKED_STRUCT_END __pragma(pack(pop))
     121             : #   define pb_packed
     122             : #else
     123             :     /* Unknown compiler */
     124             : #   define PB_PACKED_STRUCT_START
     125             : #   define PB_PACKED_STRUCT_END
     126             : #   define pb_packed
     127             : #endif
     128             : 
     129             : /* Detect endianness */
     130             : #ifndef PB_LITTLE_ENDIAN_8BIT
     131             : #if ((defined(__BYTE_ORDER) && __BYTE_ORDER == __LITTLE_ENDIAN) || \
     132             :      (defined(__BYTE_ORDER__) && __BYTE_ORDER__ == __ORDER_LITTLE_ENDIAN__) || \
     133             :       defined(__LITTLE_ENDIAN__) || defined(__ARMEL__) || \
     134             :       defined(__THUMBEL__) || defined(__AARCH64EL__) || defined(_MIPSEL) || \
     135             :       defined(_M_IX86) || defined(_M_X64) || defined(_M_ARM)) \
     136             :      && CHAR_BIT == 8
     137             : #define PB_LITTLE_ENDIAN_8BIT 1
     138             : #endif
     139             : #endif
     140             : 
     141             : /* Handly macro for suppressing unreferenced-parameter compiler warnings. */
     142             : #ifndef PB_UNUSED
     143        2142 : #define PB_UNUSED(x) (void)(x)
     144             : #endif
     145             : 
     146             : /* Harvard-architecture processors may need special attributes for storing
     147             :  * field information in program memory. */
     148             : #ifndef PB_PROGMEM
     149             : #ifdef __AVR__
     150             : #include <avr/pgmspace.h>
     151             : #define PB_PROGMEM             PROGMEM
     152             : #define PB_PROGMEM_READU32(x)  pgm_read_dword(&x)
     153             : #else
     154             : #define PB_PROGMEM
     155   113095905 : #define PB_PROGMEM_READU32(x)  (x)
     156             : #endif
     157             : #endif
     158             : 
     159             : /* Compile-time assertion, used for checking compatible compilation options.
     160             :  * If this does not work properly on your compiler, use
     161             :  * #define PB_NO_STATIC_ASSERT to disable it.
     162             :  *
     163             :  * But before doing that, check carefully the error message / place where it
     164             :  * comes from to see if the error has a real cause. Unfortunately the error
     165             :  * message is not always very clear to read, but you can see the reason better
     166             :  * in the place where the PB_STATIC_ASSERT macro was called.
     167             :  */
     168             : #ifndef PB_NO_STATIC_ASSERT
     169             : #  ifndef PB_STATIC_ASSERT
     170             : #    if defined(__ICCARM__)
     171             :        /* IAR has static_assert keyword but no _Static_assert */
     172             : #      define PB_STATIC_ASSERT(COND,MSG) static_assert(COND,#MSG);
     173             : #    elif defined(_MSC_VER) && (!defined(__STDC_VERSION__) || __STDC_VERSION__ < 201112)
     174             :        /* MSVC in C89 mode supports static_assert() keyword anyway */
     175             : #      define PB_STATIC_ASSERT(COND,MSG) static_assert(COND,#MSG);
     176             : #    elif defined(PB_C99_STATIC_ASSERT)
     177             :        /* Classic negative-size-array static assert mechanism */
     178             : #      define PB_STATIC_ASSERT(COND,MSG) typedef char PB_STATIC_ASSERT_MSG(MSG, __LINE__, __COUNTER__)[(COND)?1:-1];
     179             : #      define PB_STATIC_ASSERT_MSG(MSG, LINE, COUNTER) PB_STATIC_ASSERT_MSG_(MSG, LINE, COUNTER)
     180             : #      define PB_STATIC_ASSERT_MSG_(MSG, LINE, COUNTER) pb_static_assertion_##MSG##_##LINE##_##COUNTER
     181             : #    elif defined(__cplusplus)
     182             :        /* C++11 standard static_assert mechanism */
     183             : #      define PB_STATIC_ASSERT(COND,MSG) static_assert(COND,#MSG);
     184             : #    else
     185             :        /* C11 standard _Static_assert mechanism */
     186             : #      define PB_STATIC_ASSERT(COND,MSG) _Static_assert(COND,#MSG);
     187             : #    endif
     188             : #  endif
     189             : #else
     190             :    /* Static asserts disabled by PB_NO_STATIC_ASSERT */
     191             : #  define PB_STATIC_ASSERT(COND,MSG)
     192             : #endif
     193             : 
     194             : /* Test that PB_STATIC_ASSERT works
     195             :  * If you get errors here, you may need to do one of these:
     196             :  * - Enable C11 standard support in your compiler
     197             :  * - Define PB_C99_STATIC_ASSERT to enable C99 standard support
     198             :  * - Define PB_NO_STATIC_ASSERT to disable static asserts altogether
     199             :  */
     200             : PB_STATIC_ASSERT(1, STATIC_ASSERT_IS_NOT_WORKING)
     201             : 
     202             : /* Number of required fields to keep track of. */
     203             : #ifndef PB_MAX_REQUIRED_FIELDS
     204           0 : #define PB_MAX_REQUIRED_FIELDS 64
     205             : #endif
     206             : 
     207             : #if PB_MAX_REQUIRED_FIELDS < 64
     208             : #error You should not lower PB_MAX_REQUIRED_FIELDS from the default value (64).
     209             : #endif
     210             : 
     211             : #ifdef PB_WITHOUT_64BIT
     212             : #ifdef PB_CONVERT_DOUBLE_FLOAT
     213             : /* Cannot use doubles without 64-bit types */
     214             : #undef PB_CONVERT_DOUBLE_FLOAT
     215             : #endif
     216             : #endif
     217             : 
     218             : /* List of possible field types. These are used in the autogenerated code.
     219             :  * Least-significant 4 bits tell the scalar type
     220             :  * Most-significant 4 bits specify repeated/required/packed etc.
     221             :  */
     222             : 
     223             : typedef uint_least8_t pb_type_t;
     224             : 
     225             : /**** Field data types ****/
     226             : 
     227             : /* Numeric types */
     228     1556397 : #define PB_LTYPE_BOOL    0x00U /* bool */
     229       87015 : #define PB_LTYPE_VARINT  0x01U /* int32, int64, enum, bool */
     230     7170870 : #define PB_LTYPE_UVARINT 0x02U /* uint32, uint64 */
     231     3364299 : #define PB_LTYPE_SVARINT 0x03U /* sint32, sint64 */
     232      643032 : #define PB_LTYPE_FIXED32 0x04U /* fixed32, sfixed32, float */
     233    15148878 : #define PB_LTYPE_FIXED64 0x05U /* fixed64, sfixed64, double */
     234             : 
     235             : /* Marker for last packable field type. */
     236     3202611 : #define PB_LTYPE_LAST_PACKABLE 0x05U
     237             : 
     238             : /* Byte array with pre-allocated buffer.
     239             :  * data_size is the length of the allocated PB_BYTES_ARRAY structure. */
     240    21061833 : #define PB_LTYPE_BYTES 0x06U
     241             : 
     242             : /* String with pre-allocated buffer.
     243             :  * data_size is the maximum length. */
     244    38695317 : #define PB_LTYPE_STRING 0x07U
     245             : 
     246             : /* Submessage
     247             :  * submsg_fields is pointer to field descriptions */
     248   246623277 : #define PB_LTYPE_SUBMESSAGE 0x08U
     249             : 
     250             : /* Submessage with pre-decoding callback
     251             :  * The pre-decoding callback is stored as pb_callback_t right before pSize.
     252             :  * submsg_fields is pointer to field descriptions */
     253   118791141 : #define PB_LTYPE_SUBMSG_W_CB 0x09U
     254             : 
     255             : /* Extension pseudo-field
     256             :  * The field contains a pointer to pb_extension_t */
     257    49432041 : #define PB_LTYPE_EXTENSION 0x0AU
     258             : 
     259             : /* Byte array with inline, pre-allocated byffer.
     260             :  * data_size is the length of the inline, allocated buffer.
     261             :  * This differs from PB_LTYPE_BYTES by defining the element as
     262             :  * pb_byte_t[data_size] rather than pb_bytes_array_t. */
     263     2427195 : #define PB_LTYPE_FIXED_LENGTH_BYTES 0x0BU
     264             : 
     265             : /* Number of declared LTYPES */
     266             : #define PB_LTYPES_COUNT 0x0CU
     267   357508755 : #define PB_LTYPE_MASK 0x0FU
     268             : 
     269             : /**** Field repetition rules ****/
     270             : 
     271    56470815 : #define PB_HTYPE_REQUIRED 0x00U
     272    27945696 : #define PB_HTYPE_OPTIONAL 0x10U
     273             : #define PB_HTYPE_SINGULAR 0x10U
     274   136021068 : #define PB_HTYPE_REPEATED 0x20U
     275             : #define PB_HTYPE_FIXARRAY 0x20U
     276    40095354 : #define PB_HTYPE_ONEOF    0x30U
     277   174505080 : #define PB_HTYPE_MASK     0x30U
     278             : 
     279             : /**** Field allocation types ****/
     280             : 
     281    28669035 : #define PB_ATYPE_STATIC   0x00U
     282   120398733 : #define PB_ATYPE_POINTER  0x80U
     283     6026871 : #define PB_ATYPE_CALLBACK 0x40U
     284   106260369 : #define PB_ATYPE_MASK     0xC0U
     285             : 
     286   106260369 : #define PB_ATYPE(x) ((x) & PB_ATYPE_MASK)
     287   174505080 : #define PB_HTYPE(x) ((x) & PB_HTYPE_MASK)
     288   357508755 : #define PB_LTYPE(x) ((x) & PB_LTYPE_MASK)
     289   148769379 : #define PB_LTYPE_IS_SUBMSG(x) (PB_LTYPE(x) == PB_LTYPE_SUBMESSAGE || \
     290   148769379 :                                PB_LTYPE(x) == PB_LTYPE_SUBMSG_W_CB)
     291             : 
     292             : /* Data type used for storing sizes of struct fields
     293             :  * and array counts.
     294             :  */
     295             : #if defined(PB_FIELD_32BIT)
     296             :     typedef uint32_t pb_size_t;
     297             :     typedef int32_t pb_ssize_t;
     298             : #else
     299             :     typedef uint_least16_t pb_size_t;
     300             :     typedef int_least16_t pb_ssize_t;
     301             : #endif
     302    30904548 : #define PB_SIZE_MAX ((pb_size_t)-1)
     303             : 
     304             : /* Data type for storing encoded data and other byte streams.
     305             :  * This typedef exists to support platforms where uint8_t does not exist.
     306             :  * You can regard it as equivalent on uint8_t on other platforms.
     307             :  */
     308             : typedef uint_least8_t pb_byte_t;
     309             : 
     310             : /* Forward declaration of struct types */
     311             : typedef struct pb_istream_s pb_istream_t;
     312             : typedef struct pb_ostream_s pb_ostream_t;
     313             : typedef struct pb_field_iter_s pb_field_iter_t;
     314             : 
     315             : /* This structure is used in auto-generated constants
     316             :  * to specify struct fields.
     317             :  */
     318             : typedef struct pb_msgdesc_s pb_msgdesc_t;
     319             : struct pb_msgdesc_s {
     320             :     const uint32_t *field_info;
     321             :     const pb_msgdesc_t * const * submsg_info;
     322             :     const pb_byte_t *default_value;
     323             : 
     324             :     bool (*field_callback)(pb_istream_t *istream, pb_ostream_t *ostream, const pb_field_iter_t *field);
     325             : 
     326             :     pb_size_t field_count;
     327             :     pb_size_t required_field_count;
     328             :     pb_size_t largest_tag;
     329             : };
     330             : 
     331             : /* Iterator for message descriptor */
     332             : struct pb_field_iter_s {
     333             :     const pb_msgdesc_t *descriptor;  /* Pointer to message descriptor constant */
     334             :     void *message;                   /* Pointer to start of the structure */
     335             : 
     336             :     pb_size_t index;                 /* Index of the field */
     337             :     pb_size_t field_info_index;      /* Index to descriptor->field_info array */
     338             :     pb_size_t required_field_index;  /* Index that counts only the required fields */
     339             :     pb_size_t submessage_index;      /* Index that counts only submessages */
     340             : 
     341             :     pb_size_t tag;                   /* Tag of current field */
     342             :     pb_size_t data_size;             /* sizeof() of a single item */
     343             :     pb_size_t array_size;            /* Number of array entries */
     344             :     pb_type_t type;                  /* Type of current field */
     345             : 
     346             :     void *pField;                    /* Pointer to current field in struct */
     347             :     void *pData;                     /* Pointer to current data contents. Different than pField for arrays and pointers. */
     348             :     void *pSize;                     /* Pointer to count/has field */
     349             : 
     350             :     const pb_msgdesc_t *submsg_desc; /* For submessage fields, pointer to field descriptor for the submessage. */
     351             : };
     352             : 
     353             : /* For compatibility with legacy code */
     354             : typedef pb_field_iter_t pb_field_t;
     355             : 
     356             : /* Make sure that the standard integer types are of the expected sizes.
     357             :  * Otherwise fixed32/fixed64 fields can break.
     358             :  *
     359             :  * If you get errors here, it probably means that your stdint.h is not
     360             :  * correct for your platform.
     361             :  */
     362             : #ifndef PB_WITHOUT_64BIT
     363             : PB_STATIC_ASSERT(sizeof(int64_t) == 2 * sizeof(int32_t), INT64_T_WRONG_SIZE)
     364             : PB_STATIC_ASSERT(sizeof(uint64_t) == 2 * sizeof(uint32_t), UINT64_T_WRONG_SIZE)
     365             : #endif
     366             : 
     367             : /* This structure is used for 'bytes' arrays.
     368             :  * It has the number of bytes in the beginning, and after that an array.
     369             :  * Note that actual structs used will have a different length of bytes array.
     370             :  */
     371             : #define PB_BYTES_ARRAY_T(n) struct { pb_size_t size; pb_byte_t bytes[n]; }
     372     1681425 : #define PB_BYTES_ARRAY_T_ALLOCSIZE(n) ((size_t)n + offsetof(pb_bytes_array_t, bytes))
     373             : 
     374             : struct pb_bytes_array_s {
     375             :     pb_size_t size;
     376             :     pb_byte_t bytes[1];
     377             : };
     378             : typedef struct pb_bytes_array_s pb_bytes_array_t;
     379             : 
     380             : /* This structure is used for giving the callback function.
     381             :  * It is stored in the message structure and filled in by the method that
     382             :  * calls pb_decode.
     383             :  *
     384             :  * The decoding callback will be given a limited-length stream
     385             :  * If the wire type was string, the length is the length of the string.
     386             :  * If the wire type was a varint/fixed32/fixed64, the length is the length
     387             :  * of the actual value.
     388             :  * The function may be called multiple times (especially for repeated types,
     389             :  * but also otherwise if the message happens to contain the field multiple
     390             :  * times.)
     391             :  *
     392             :  * The encoding callback will receive the actual output stream.
     393             :  * It should write all the data in one call, including the field tag and
     394             :  * wire type. It can write multiple fields.
     395             :  *
     396             :  * The callback can be null if you want to skip a field.
     397             :  */
     398             : typedef struct pb_callback_s pb_callback_t;
     399             : struct pb_callback_s {
     400             :     /* Callback functions receive a pointer to the arg field.
     401             :      * You can access the value of the field as *arg, and modify it if needed.
     402             :      */
     403             :     union {
     404             :         bool (*decode)(pb_istream_t *stream, const pb_field_t *field, void **arg);
     405             :         bool (*encode)(pb_ostream_t *stream, const pb_field_t *field, void * const *arg);
     406             :     } funcs;
     407             : 
     408             :     /* Free arg for use by callback */
     409             :     void *arg;
     410             : };
     411             : 
     412             : extern bool pb_default_field_callback(pb_istream_t *istream, pb_ostream_t *ostream, const pb_field_t *field);
     413             : 
     414             : /* Wire types. Library user needs these only in encoder callbacks. */
     415             : typedef enum {
     416             :     PB_WT_VARINT = 0,
     417             :     PB_WT_64BIT  = 1,
     418             :     PB_WT_STRING = 2,
     419             :     PB_WT_32BIT  = 5,
     420             :     PB_WT_PACKED = 255 /* PB_WT_PACKED is internal marker for packed arrays. */
     421             : } pb_wire_type_t;
     422             : 
     423             : /* Structure for defining the handling of unknown/extension fields.
     424             :  * Usually the pb_extension_type_t structure is automatically generated,
     425             :  * while the pb_extension_t structure is created by the user. However,
     426             :  * if you want to catch all unknown fields, you can also create a custom
     427             :  * pb_extension_type_t with your own callback.
     428             :  */
     429             : typedef struct pb_extension_type_s pb_extension_type_t;
     430             : typedef struct pb_extension_s pb_extension_t;
     431             : struct pb_extension_type_s {
     432             :     /* Called for each unknown field in the message.
     433             :      * If you handle the field, read off all of its data and return true.
     434             :      * If you do not handle the field, do not read anything and return true.
     435             :      * If you run into an error, return false.
     436             :      * Set to NULL for default handler.
     437             :      */
     438             :     bool (*decode)(pb_istream_t *stream, pb_extension_t *extension,
     439             :                    uint32_t tag, pb_wire_type_t wire_type);
     440             : 
     441             :     /* Called once after all regular fields have been encoded.
     442             :      * If you have something to write, do so and return true.
     443             :      * If you do not have anything to write, just return true.
     444             :      * If you run into an error, return false.
     445             :      * Set to NULL for default handler.
     446             :      */
     447             :     bool (*encode)(pb_ostream_t *stream, const pb_extension_t *extension);
     448             : 
     449             :     /* Free field for use by the callback. */
     450             :     const void *arg;
     451             : };
     452             : 
     453             : struct pb_extension_s {
     454             :     /* Type describing the extension field. Usually you'll initialize
     455             :      * this to a pointer to the automatically generated structure. */
     456             :     const pb_extension_type_t *type;
     457             : 
     458             :     /* Destination for the decoded data. This must match the datatype
     459             :      * of the extension field. */
     460             :     void *dest;
     461             : 
     462             :     /* Pointer to the next extension handler, or NULL.
     463             :      * If this extension does not match a field, the next handler is
     464             :      * automatically called. */
     465             :     pb_extension_t *next;
     466             : 
     467             :     /* The decoder sets this to true if the extension was found.
     468             :      * Ignored for encoding. */
     469             :     bool found;
     470             : };
     471             : 
     472             : #define pb_extension_init_zero {NULL,NULL,NULL,false}
     473             : 
     474             : /* Memory allocation functions to use. You can define pb_realloc and
     475             :  * pb_free to custom functions if you want. */
     476             : #ifdef PB_ENABLE_MALLOC
     477             : #   ifndef pb_realloc
     478     4751889 : #       define pb_realloc(ptr, size) realloc(ptr, size)
     479             : #   endif
     480             : #   ifndef pb_free
     481     2941260 : #       define pb_free(ptr) free(ptr)
     482             : #   endif
     483             : #endif
     484             : 
     485             : /* This is used to inform about need to regenerate .pb.h/.pb.c files. */
     486             : #define PB_PROTO_HEADER_VERSION 40
     487             : 
     488             : /* These macros are used to declare pb_field_t's in the constant array. */
     489             : /* Size of a structure member, in bytes. */
     490             : #define pb_membersize(st, m) (sizeof ((st*)0)->m)
     491             : /* Number of entries in an array. */
     492             : #define pb_arraysize(st, m) (pb_membersize(st, m) / pb_membersize(st, m[0]))
     493             : /* Delta from start of one member to the start of another member. */
     494             : #define pb_delta(st, m1, m2) ((int)offsetof(st, m1) - (int)offsetof(st, m2))
     495             : 
     496             : /* Force expansion of macro value */
     497             : #define PB_EXPAND(x) x
     498             : 
     499             : /* Binding of a message field set into a specific structure */
     500             : #define PB_BIND(msgname, structname, width) \
     501             :     const uint32_t structname ## _field_info[] PB_PROGMEM = \
     502             :     { \
     503             :         msgname ## _FIELDLIST(PB_GEN_FIELD_INFO_ ## width, structname) \
     504             :         0 \
     505             :     }; \
     506             :     const pb_msgdesc_t* const structname ## _submsg_info[] = \
     507             :     { \
     508             :         msgname ## _FIELDLIST(PB_GEN_SUBMSG_INFO, structname) \
     509             :         NULL \
     510             :     }; \
     511             :     const pb_msgdesc_t structname ## _msg = \
     512             :     { \
     513             :        structname ## _field_info, \
     514             :        structname ## _submsg_info, \
     515             :        msgname ## _DEFAULT, \
     516             :        msgname ## _CALLBACK, \
     517             :        0 msgname ## _FIELDLIST(PB_GEN_FIELD_COUNT, structname), \
     518             :        0 msgname ## _FIELDLIST(PB_GEN_REQ_FIELD_COUNT, structname), \
     519             :        0 msgname ## _FIELDLIST(PB_GEN_LARGEST_TAG, structname), \
     520             :     }; \
     521             :     msgname ## _FIELDLIST(PB_GEN_FIELD_INFO_ASSERT_ ## width, structname)
     522             : 
     523             : #define PB_GEN_FIELD_COUNT(structname, atype, htype, ltype, fieldname, tag) +1
     524             : #define PB_GEN_REQ_FIELD_COUNT(structname, atype, htype, ltype, fieldname, tag) \
     525             :     + (PB_HTYPE_ ## htype == PB_HTYPE_REQUIRED)
     526             : #define PB_GEN_LARGEST_TAG(structname, atype, htype, ltype, fieldname, tag) \
     527             :     * 0 + tag
     528             : 
     529             : /* X-macro for generating the entries in struct_field_info[] array. */
     530             : #define PB_GEN_FIELD_INFO_1(structname, atype, htype, ltype, fieldname, tag) \
     531             :     PB_FIELDINFO_1(tag, PB_ATYPE_ ## atype | PB_HTYPE_ ## htype | PB_LTYPE_MAP_ ## ltype, \
     532             :                    PB_DATA_OFFSET_ ## atype(_PB_HTYPE_ ## htype, structname, fieldname), \
     533             :                    PB_DATA_SIZE_ ## atype(_PB_HTYPE_ ## htype, structname, fieldname), \
     534             :                    PB_SIZE_OFFSET_ ## atype(_PB_HTYPE_ ## htype, structname, fieldname), \
     535             :                    PB_ARRAY_SIZE_ ## atype(_PB_HTYPE_ ## htype, structname, fieldname))
     536             : 
     537             : #define PB_GEN_FIELD_INFO_2(structname, atype, htype, ltype, fieldname, tag) \
     538             :     PB_FIELDINFO_2(tag, PB_ATYPE_ ## atype | PB_HTYPE_ ## htype | PB_LTYPE_MAP_ ## ltype, \
     539             :                    PB_DATA_OFFSET_ ## atype(_PB_HTYPE_ ## htype, structname, fieldname), \
     540             :                    PB_DATA_SIZE_ ## atype(_PB_HTYPE_ ## htype, structname, fieldname), \
     541             :                    PB_SIZE_OFFSET_ ## atype(_PB_HTYPE_ ## htype, structname, fieldname), \
     542             :                    PB_ARRAY_SIZE_ ## atype(_PB_HTYPE_ ## htype, structname, fieldname))
     543             : 
     544             : #define PB_GEN_FIELD_INFO_4(structname, atype, htype, ltype, fieldname, tag) \
     545             :     PB_FIELDINFO_4(tag, PB_ATYPE_ ## atype | PB_HTYPE_ ## htype | PB_LTYPE_MAP_ ## ltype, \
     546             :                    PB_DATA_OFFSET_ ## atype(_PB_HTYPE_ ## htype, structname, fieldname), \
     547             :                    PB_DATA_SIZE_ ## atype(_PB_HTYPE_ ## htype, structname, fieldname), \
     548             :                    PB_SIZE_OFFSET_ ## atype(_PB_HTYPE_ ## htype, structname, fieldname), \
     549             :                    PB_ARRAY_SIZE_ ## atype(_PB_HTYPE_ ## htype, structname, fieldname))
     550             : 
     551             : #define PB_GEN_FIELD_INFO_8(structname, atype, htype, ltype, fieldname, tag) \
     552             :     PB_FIELDINFO_8(tag, PB_ATYPE_ ## atype | PB_HTYPE_ ## htype | PB_LTYPE_MAP_ ## ltype, \
     553             :                    PB_DATA_OFFSET_ ## atype(_PB_HTYPE_ ## htype, structname, fieldname), \
     554             :                    PB_DATA_SIZE_ ## atype(_PB_HTYPE_ ## htype, structname, fieldname), \
     555             :                    PB_SIZE_OFFSET_ ## atype(_PB_HTYPE_ ## htype, structname, fieldname), \
     556             :                    PB_ARRAY_SIZE_ ## atype(_PB_HTYPE_ ## htype, structname, fieldname))
     557             : 
     558             : #define PB_GEN_FIELD_INFO_AUTO(structname, atype, htype, ltype, fieldname, tag) \
     559             :     PB_FIELDINFO_AUTO2(PB_FIELDINFO_WIDTH_AUTO(_PB_ATYPE_ ## atype, _PB_HTYPE_ ## htype, _PB_LTYPE_ ## ltype), \
     560             :                    tag, PB_ATYPE_ ## atype | PB_HTYPE_ ## htype | PB_LTYPE_MAP_ ## ltype, \
     561             :                    PB_DATA_OFFSET_ ## atype(_PB_HTYPE_ ## htype, structname, fieldname), \
     562             :                    PB_DATA_SIZE_ ## atype(_PB_HTYPE_ ## htype, structname, fieldname), \
     563             :                    PB_SIZE_OFFSET_ ## atype(_PB_HTYPE_ ## htype, structname, fieldname), \
     564             :                    PB_ARRAY_SIZE_ ## atype(_PB_HTYPE_ ## htype, structname, fieldname))
     565             : 
     566             : #define PB_FIELDINFO_AUTO2(width, tag, type, data_offset, data_size, size_offset, array_size) \
     567             :     PB_FIELDINFO_AUTO3(width, tag, type, data_offset, data_size, size_offset, array_size)
     568             : 
     569             : #define PB_FIELDINFO_AUTO3(width, tag, type, data_offset, data_size, size_offset, array_size) \
     570             :     PB_FIELDINFO_ ## width(tag, type, data_offset, data_size, size_offset, array_size)
     571             : 
     572             : /* X-macro for generating asserts that entries fit in struct_field_info[] array.
     573             :  * The structure of macros here must match the structure above in PB_GEN_FIELD_INFO_x(),
     574             :  * but it is not easily reused because of how macro substitutions work. */
     575             : #define PB_GEN_FIELD_INFO_ASSERT_1(structname, atype, htype, ltype, fieldname, tag) \
     576             :     PB_FIELDINFO_ASSERT_1(tag, PB_ATYPE_ ## atype | PB_HTYPE_ ## htype | PB_LTYPE_MAP_ ## ltype, \
     577             :                    PB_DATA_OFFSET_ ## atype(_PB_HTYPE_ ## htype, structname, fieldname), \
     578             :                    PB_DATA_SIZE_ ## atype(_PB_HTYPE_ ## htype, structname, fieldname), \
     579             :                    PB_SIZE_OFFSET_ ## atype(_PB_HTYPE_ ## htype, structname, fieldname), \
     580             :                    PB_ARRAY_SIZE_ ## atype(_PB_HTYPE_ ## htype, structname, fieldname))
     581             : 
     582             : #define PB_GEN_FIELD_INFO_ASSERT_2(structname, atype, htype, ltype, fieldname, tag) \
     583             :     PB_FIELDINFO_ASSERT_2(tag, PB_ATYPE_ ## atype | PB_HTYPE_ ## htype | PB_LTYPE_MAP_ ## ltype, \
     584             :                    PB_DATA_OFFSET_ ## atype(_PB_HTYPE_ ## htype, structname, fieldname), \
     585             :                    PB_DATA_SIZE_ ## atype(_PB_HTYPE_ ## htype, structname, fieldname), \
     586             :                    PB_SIZE_OFFSET_ ## atype(_PB_HTYPE_ ## htype, structname, fieldname), \
     587             :                    PB_ARRAY_SIZE_ ## atype(_PB_HTYPE_ ## htype, structname, fieldname))
     588             : 
     589             : #define PB_GEN_FIELD_INFO_ASSERT_4(structname, atype, htype, ltype, fieldname, tag) \
     590             :     PB_FIELDINFO_ASSERT_4(tag, PB_ATYPE_ ## atype | PB_HTYPE_ ## htype | PB_LTYPE_MAP_ ## ltype, \
     591             :                    PB_DATA_OFFSET_ ## atype(_PB_HTYPE_ ## htype, structname, fieldname), \
     592             :                    PB_DATA_SIZE_ ## atype(_PB_HTYPE_ ## htype, structname, fieldname), \
     593             :                    PB_SIZE_OFFSET_ ## atype(_PB_HTYPE_ ## htype, structname, fieldname), \
     594             :                    PB_ARRAY_SIZE_ ## atype(_PB_HTYPE_ ## htype, structname, fieldname))
     595             : 
     596             : #define PB_GEN_FIELD_INFO_ASSERT_8(structname, atype, htype, ltype, fieldname, tag) \
     597             :     PB_FIELDINFO_ASSERT_8(tag, PB_ATYPE_ ## atype | PB_HTYPE_ ## htype | PB_LTYPE_MAP_ ## ltype, \
     598             :                    PB_DATA_OFFSET_ ## atype(_PB_HTYPE_ ## htype, structname, fieldname), \
     599             :                    PB_DATA_SIZE_ ## atype(_PB_HTYPE_ ## htype, structname, fieldname), \
     600             :                    PB_SIZE_OFFSET_ ## atype(_PB_HTYPE_ ## htype, structname, fieldname), \
     601             :                    PB_ARRAY_SIZE_ ## atype(_PB_HTYPE_ ## htype, structname, fieldname))
     602             : 
     603             : #define PB_GEN_FIELD_INFO_ASSERT_AUTO(structname, atype, htype, ltype, fieldname, tag) \
     604             :     PB_FIELDINFO_ASSERT_AUTO2(PB_FIELDINFO_WIDTH_AUTO(_PB_ATYPE_ ## atype, _PB_HTYPE_ ## htype, _PB_LTYPE_ ## ltype), \
     605             :                    tag, PB_ATYPE_ ## atype | PB_HTYPE_ ## htype | PB_LTYPE_MAP_ ## ltype, \
     606             :                    PB_DATA_OFFSET_ ## atype(_PB_HTYPE_ ## htype, structname, fieldname), \
     607             :                    PB_DATA_SIZE_ ## atype(_PB_HTYPE_ ## htype, structname, fieldname), \
     608             :                    PB_SIZE_OFFSET_ ## atype(_PB_HTYPE_ ## htype, structname, fieldname), \
     609             :                    PB_ARRAY_SIZE_ ## atype(_PB_HTYPE_ ## htype, structname, fieldname))
     610             : 
     611             : #define PB_FIELDINFO_ASSERT_AUTO2(width, tag, type, data_offset, data_size, size_offset, array_size) \
     612             :     PB_FIELDINFO_ASSERT_AUTO3(width, tag, type, data_offset, data_size, size_offset, array_size)
     613             : 
     614             : #define PB_FIELDINFO_ASSERT_AUTO3(width, tag, type, data_offset, data_size, size_offset, array_size) \
     615             :     PB_FIELDINFO_ASSERT_ ## width(tag, type, data_offset, data_size, size_offset, array_size)
     616             : 
     617             : #define PB_DATA_OFFSET_STATIC(htype, structname, fieldname) PB_DO ## htype(structname, fieldname)
     618             : #define PB_DATA_OFFSET_POINTER(htype, structname, fieldname) PB_DO ## htype(structname, fieldname)
     619             : #define PB_DATA_OFFSET_CALLBACK(htype, structname, fieldname) PB_DO ## htype(structname, fieldname)
     620             : #define PB_DO_PB_HTYPE_REQUIRED(structname, fieldname) offsetof(structname, fieldname)
     621             : #define PB_DO_PB_HTYPE_SINGULAR(structname, fieldname) offsetof(structname, fieldname)
     622             : #define PB_DO_PB_HTYPE_ONEOF(structname, fieldname) offsetof(structname, PB_ONEOF_NAME(FULL, fieldname))
     623             : #define PB_DO_PB_HTYPE_OPTIONAL(structname, fieldname) offsetof(structname, fieldname)
     624             : #define PB_DO_PB_HTYPE_REPEATED(structname, fieldname) offsetof(structname, fieldname)
     625             : #define PB_DO_PB_HTYPE_FIXARRAY(structname, fieldname) offsetof(structname, fieldname)
     626             : 
     627             : #define PB_SIZE_OFFSET_STATIC(htype, structname, fieldname) PB_SO ## htype(structname, fieldname)
     628             : #define PB_SIZE_OFFSET_POINTER(htype, structname, fieldname) PB_SO_PTR ## htype(structname, fieldname)
     629             : #define PB_SIZE_OFFSET_CALLBACK(htype, structname, fieldname) PB_SO_CB ## htype(structname, fieldname)
     630             : #define PB_SO_PB_HTYPE_REQUIRED(structname, fieldname) 0
     631             : #define PB_SO_PB_HTYPE_SINGULAR(structname, fieldname) 0
     632             : #define PB_SO_PB_HTYPE_ONEOF(structname, fieldname) PB_SO_PB_HTYPE_ONEOF2(structname, PB_ONEOF_NAME(FULL, fieldname), PB_ONEOF_NAME(UNION, fieldname))
     633             : #define PB_SO_PB_HTYPE_ONEOF2(structname, fullname, unionname) PB_SO_PB_HTYPE_ONEOF3(structname, fullname, unionname)
     634             : #define PB_SO_PB_HTYPE_ONEOF3(structname, fullname, unionname) pb_delta(structname, fullname, which_ ## unionname)
     635             : #define PB_SO_PB_HTYPE_OPTIONAL(structname, fieldname) pb_delta(structname, fieldname, has_ ## fieldname)
     636             : #define PB_SO_PB_HTYPE_REPEATED(structname, fieldname) pb_delta(structname, fieldname, fieldname ## _count)
     637             : #define PB_SO_PB_HTYPE_FIXARRAY(structname, fieldname) 0
     638             : #define PB_SO_PTR_PB_HTYPE_REQUIRED(structname, fieldname) 0
     639             : #define PB_SO_PTR_PB_HTYPE_SINGULAR(structname, fieldname) 0
     640             : #define PB_SO_PTR_PB_HTYPE_ONEOF(structname, fieldname) PB_SO_PB_HTYPE_ONEOF(structname, fieldname)
     641             : #define PB_SO_PTR_PB_HTYPE_OPTIONAL(structname, fieldname) 0
     642             : #define PB_SO_PTR_PB_HTYPE_REPEATED(structname, fieldname) PB_SO_PB_HTYPE_REPEATED(structname, fieldname)
     643             : #define PB_SO_PTR_PB_HTYPE_FIXARRAY(structname, fieldname) 0
     644             : #define PB_SO_CB_PB_HTYPE_REQUIRED(structname, fieldname) 0
     645             : #define PB_SO_CB_PB_HTYPE_SINGULAR(structname, fieldname) 0
     646             : #define PB_SO_CB_PB_HTYPE_ONEOF(structname, fieldname) PB_SO_PB_HTYPE_ONEOF(structname, fieldname)
     647             : #define PB_SO_CB_PB_HTYPE_OPTIONAL(structname, fieldname) 0
     648             : #define PB_SO_CB_PB_HTYPE_REPEATED(structname, fieldname) 0
     649             : #define PB_SO_CB_PB_HTYPE_FIXARRAY(structname, fieldname) 0
     650             : 
     651             : #define PB_ARRAY_SIZE_STATIC(htype, structname, fieldname) PB_AS ## htype(structname, fieldname)
     652             : #define PB_ARRAY_SIZE_POINTER(htype, structname, fieldname) PB_AS_PTR ## htype(structname, fieldname)
     653             : #define PB_ARRAY_SIZE_CALLBACK(htype, structname, fieldname) 1
     654             : #define PB_AS_PB_HTYPE_REQUIRED(structname, fieldname) 1
     655             : #define PB_AS_PB_HTYPE_SINGULAR(structname, fieldname) 1
     656             : #define PB_AS_PB_HTYPE_OPTIONAL(structname, fieldname) 1
     657             : #define PB_AS_PB_HTYPE_ONEOF(structname, fieldname) 1
     658             : #define PB_AS_PB_HTYPE_REPEATED(structname, fieldname) pb_arraysize(structname, fieldname)
     659             : #define PB_AS_PB_HTYPE_FIXARRAY(structname, fieldname) pb_arraysize(structname, fieldname)
     660             : #define PB_AS_PTR_PB_HTYPE_REQUIRED(structname, fieldname) 1
     661             : #define PB_AS_PTR_PB_HTYPE_SINGULAR(structname, fieldname) 1
     662             : #define PB_AS_PTR_PB_HTYPE_OPTIONAL(structname, fieldname) 1
     663             : #define PB_AS_PTR_PB_HTYPE_ONEOF(structname, fieldname) 1
     664             : #define PB_AS_PTR_PB_HTYPE_REPEATED(structname, fieldname) 1
     665             : #define PB_AS_PTR_PB_HTYPE_FIXARRAY(structname, fieldname) pb_arraysize(structname, fieldname[0])
     666             : 
     667             : #define PB_DATA_SIZE_STATIC(htype, structname, fieldname) PB_DS ## htype(structname, fieldname)
     668             : #define PB_DATA_SIZE_POINTER(htype, structname, fieldname) PB_DS_PTR ## htype(structname, fieldname)
     669             : #define PB_DATA_SIZE_CALLBACK(htype, structname, fieldname) PB_DS_CB ## htype(structname, fieldname)
     670             : #define PB_DS_PB_HTYPE_REQUIRED(structname, fieldname) pb_membersize(structname, fieldname)
     671             : #define PB_DS_PB_HTYPE_SINGULAR(structname, fieldname) pb_membersize(structname, fieldname)
     672             : #define PB_DS_PB_HTYPE_OPTIONAL(structname, fieldname) pb_membersize(structname, fieldname)
     673             : #define PB_DS_PB_HTYPE_ONEOF(structname, fieldname) pb_membersize(structname, PB_ONEOF_NAME(FULL, fieldname))
     674             : #define PB_DS_PB_HTYPE_REPEATED(structname, fieldname) pb_membersize(structname, fieldname[0])
     675             : #define PB_DS_PB_HTYPE_FIXARRAY(structname, fieldname) pb_membersize(structname, fieldname[0])
     676             : #define PB_DS_PTR_PB_HTYPE_REQUIRED(structname, fieldname) pb_membersize(structname, fieldname[0])
     677             : #define PB_DS_PTR_PB_HTYPE_SINGULAR(structname, fieldname) pb_membersize(structname, fieldname[0])
     678             : #define PB_DS_PTR_PB_HTYPE_OPTIONAL(structname, fieldname) pb_membersize(structname, fieldname[0])
     679             : #define PB_DS_PTR_PB_HTYPE_ONEOF(structname, fieldname) pb_membersize(structname, PB_ONEOF_NAME(FULL, fieldname)[0])
     680             : #define PB_DS_PTR_PB_HTYPE_REPEATED(structname, fieldname) pb_membersize(structname, fieldname[0])
     681             : #define PB_DS_PTR_PB_HTYPE_FIXARRAY(structname, fieldname) pb_membersize(structname, fieldname[0][0])
     682             : #define PB_DS_CB_PB_HTYPE_REQUIRED(structname, fieldname) pb_membersize(structname, fieldname)
     683             : #define PB_DS_CB_PB_HTYPE_SINGULAR(structname, fieldname) pb_membersize(structname, fieldname)
     684             : #define PB_DS_CB_PB_HTYPE_OPTIONAL(structname, fieldname) pb_membersize(structname, fieldname)
     685             : #define PB_DS_CB_PB_HTYPE_ONEOF(structname, fieldname) pb_membersize(structname, PB_ONEOF_NAME(FULL, fieldname))
     686             : #define PB_DS_CB_PB_HTYPE_REPEATED(structname, fieldname) pb_membersize(structname, fieldname)
     687             : #define PB_DS_CB_PB_HTYPE_FIXARRAY(structname, fieldname) pb_membersize(structname, fieldname)
     688             : 
     689             : #define PB_ONEOF_NAME(type, tuple) PB_EXPAND(PB_ONEOF_NAME_ ## type tuple)
     690             : #define PB_ONEOF_NAME_UNION(unionname,membername,fullname) unionname
     691             : #define PB_ONEOF_NAME_MEMBER(unionname,membername,fullname) membername
     692             : #define PB_ONEOF_NAME_FULL(unionname,membername,fullname) fullname
     693             : 
     694             : #define PB_GEN_SUBMSG_INFO(structname, atype, htype, ltype, fieldname, tag) \
     695             :     PB_SUBMSG_INFO_ ## htype(_PB_LTYPE_ ## ltype, structname, fieldname)
     696             : 
     697             : #define PB_SUBMSG_INFO_REQUIRED(ltype, structname, fieldname) PB_SI ## ltype(structname ## _ ## fieldname ## _MSGTYPE)
     698             : #define PB_SUBMSG_INFO_SINGULAR(ltype, structname, fieldname) PB_SI ## ltype(structname ## _ ## fieldname ## _MSGTYPE)
     699             : #define PB_SUBMSG_INFO_OPTIONAL(ltype, structname, fieldname) PB_SI ## ltype(structname ## _ ## fieldname ## _MSGTYPE)
     700             : #define PB_SUBMSG_INFO_ONEOF(ltype, structname, fieldname) PB_SUBMSG_INFO_ONEOF2(ltype, structname, PB_ONEOF_NAME(UNION, fieldname), PB_ONEOF_NAME(MEMBER, fieldname))
     701             : #define PB_SUBMSG_INFO_ONEOF2(ltype, structname, unionname, membername) PB_SUBMSG_INFO_ONEOF3(ltype, structname, unionname, membername)
     702             : #define PB_SUBMSG_INFO_ONEOF3(ltype, structname, unionname, membername) PB_SI ## ltype(structname ## _ ## unionname ## _ ## membername ## _MSGTYPE)
     703             : #define PB_SUBMSG_INFO_REPEATED(ltype, structname, fieldname) PB_SI ## ltype(structname ## _ ## fieldname ## _MSGTYPE)
     704             : #define PB_SUBMSG_INFO_FIXARRAY(ltype, structname, fieldname) PB_SI ## ltype(structname ## _ ## fieldname ## _MSGTYPE)
     705             : #define PB_SI_PB_LTYPE_BOOL(t)
     706             : #define PB_SI_PB_LTYPE_BYTES(t)
     707             : #define PB_SI_PB_LTYPE_DOUBLE(t)
     708             : #define PB_SI_PB_LTYPE_ENUM(t)
     709             : #define PB_SI_PB_LTYPE_UENUM(t)
     710             : #define PB_SI_PB_LTYPE_FIXED32(t)
     711             : #define PB_SI_PB_LTYPE_FIXED64(t)
     712             : #define PB_SI_PB_LTYPE_FLOAT(t)
     713             : #define PB_SI_PB_LTYPE_INT32(t)
     714             : #define PB_SI_PB_LTYPE_INT64(t)
     715             : #define PB_SI_PB_LTYPE_MESSAGE(t)  PB_SUBMSG_DESCRIPTOR(t)
     716             : #define PB_SI_PB_LTYPE_MSG_W_CB(t) PB_SUBMSG_DESCRIPTOR(t)
     717             : #define PB_SI_PB_LTYPE_SFIXED32(t)
     718             : #define PB_SI_PB_LTYPE_SFIXED64(t)
     719             : #define PB_SI_PB_LTYPE_SINT32(t)
     720             : #define PB_SI_PB_LTYPE_SINT64(t)
     721             : #define PB_SI_PB_LTYPE_STRING(t)
     722             : #define PB_SI_PB_LTYPE_UINT32(t)
     723             : #define PB_SI_PB_LTYPE_UINT64(t)
     724             : #define PB_SI_PB_LTYPE_EXTENSION(t)
     725             : #define PB_SI_PB_LTYPE_FIXED_LENGTH_BYTES(t)
     726             : #define PB_SUBMSG_DESCRIPTOR(t)    &(t ## _msg),
     727             : 
     728             : /* The field descriptors use a variable width format, with width of either
     729             :  * 1, 2, 4 or 8 of 32-bit words. The two lowest bytes of the first byte always
     730             :  * encode the descriptor size, 6 lowest bits of field tag number, and 8 bits
     731             :  * of the field type.
     732             :  *
     733             :  * Descriptor size is encoded as 0 = 1 word, 1 = 2 words, 2 = 4 words, 3 = 8 words.
     734             :  *
     735             :  * Formats, listed starting with the least significant bit of the first word.
     736             :  * 1 word:  [2-bit len] [6-bit tag] [8-bit type] [8-bit data_offset] [4-bit size_offset] [4-bit data_size]
     737             :  *
     738             :  * 2 words: [2-bit len] [6-bit tag] [8-bit type] [12-bit array_size] [4-bit size_offset]
     739             :  *          [16-bit data_offset] [12-bit data_size] [4-bit tag>>6]
     740             :  *
     741             :  * 4 words: [2-bit len] [6-bit tag] [8-bit type] [16-bit array_size]
     742             :  *          [8-bit size_offset] [24-bit tag>>6]
     743             :  *          [32-bit data_offset]
     744             :  *          [32-bit data_size]
     745             :  *
     746             :  * 8 words: [2-bit len] [6-bit tag] [8-bit type] [16-bit reserved]
     747             :  *          [8-bit size_offset] [24-bit tag>>6]
     748             :  *          [32-bit data_offset]
     749             :  *          [32-bit data_size]
     750             :  *          [32-bit array_size]
     751             :  *          [32-bit reserved]
     752             :  *          [32-bit reserved]
     753             :  *          [32-bit reserved]
     754             :  */
     755             : 
     756             : #define PB_FIELDINFO_1(tag, type, data_offset, data_size, size_offset, array_size) \
     757             :     (0 | (((tag) << 2) & 0xFF) | ((type) << 8) | (((uint32_t)(data_offset) & 0xFF) << 16) | \
     758             :      (((uint32_t)(size_offset) & 0x0F) << 24) | (((uint32_t)(data_size) & 0x0F) << 28)),
     759             : 
     760             : #define PB_FIELDINFO_2(tag, type, data_offset, data_size, size_offset, array_size) \
     761             :     (1 | (((tag) << 2) & 0xFF) | ((type) << 8) | (((uint32_t)(array_size) & 0xFFF) << 16) | (((uint32_t)(size_offset) & 0x0F) << 28)), \
     762             :     (((uint32_t)(data_offset) & 0xFFFF) | (((uint32_t)(data_size) & 0xFFF) << 16) | (((uint32_t)(tag) & 0x3c0) << 22)),
     763             : 
     764             : #define PB_FIELDINFO_4(tag, type, data_offset, data_size, size_offset, array_size) \
     765             :     (2 | (((tag) << 2) & 0xFF) | ((type) << 8) | (((uint32_t)(array_size) & 0xFFFF) << 16)), \
     766             :     ((uint32_t)(int_least8_t)(size_offset) | (((uint32_t)(tag) << 2) & 0xFFFFFF00)), \
     767             :     (data_offset), (data_size),
     768             : 
     769             : #define PB_FIELDINFO_8(tag, type, data_offset, data_size, size_offset, array_size) \
     770             :     (3 | (((tag) << 2) & 0xFF) | ((type) << 8)), \
     771             :     ((uint32_t)(int_least8_t)(size_offset) | (((uint32_t)(tag) << 2) & 0xFFFFFF00)), \
     772             :     (data_offset), (data_size), (array_size), 0, 0, 0,
     773             : 
     774             : /* These assertions verify that the field information fits in the allocated space.
     775             :  * The generator tries to automatically determine the correct width that can fit all
     776             :  * data associated with a message. These asserts will fail only if there has been a
     777             :  * problem in the automatic logic - this may be worth reporting as a bug. As a workaround,
     778             :  * you can increase the descriptor width by defining PB_FIELDINFO_WIDTH or by setting
     779             :  * descriptorsize option in .options file.
     780             :  */
     781             : #define PB_FITS(value,bits) ((uint32_t)(value) < ((uint32_t)1<<bits))
     782             : #define PB_FIELDINFO_ASSERT_1(tag, type, data_offset, data_size, size_offset, array_size) \
     783             :     PB_STATIC_ASSERT(PB_FITS(tag,6) && PB_FITS(data_offset,8) && PB_FITS(size_offset,4) && PB_FITS(data_size,4) && PB_FITS(array_size,1), FIELDINFO_DOES_NOT_FIT_width1_field ## tag)
     784             : 
     785             : #define PB_FIELDINFO_ASSERT_2(tag, type, data_offset, data_size, size_offset, array_size) \
     786             :     PB_STATIC_ASSERT(PB_FITS(tag,10) && PB_FITS(data_offset,16) && PB_FITS(size_offset,4) && PB_FITS(data_size,12) && PB_FITS(array_size,12), FIELDINFO_DOES_NOT_FIT_width2_field ## tag)
     787             : 
     788             : #ifndef PB_FIELD_32BIT
     789             : /* Maximum field sizes are still 16-bit if pb_size_t is 16-bit */
     790             : #define PB_FIELDINFO_ASSERT_4(tag, type, data_offset, data_size, size_offset, array_size) \
     791             :     PB_STATIC_ASSERT(PB_FITS(tag,16) && PB_FITS(data_offset,16) && PB_FITS((int_least8_t)size_offset,8) && PB_FITS(data_size,16) && PB_FITS(array_size,16), FIELDINFO_DOES_NOT_FIT_width4_field ## tag)
     792             : 
     793             : #define PB_FIELDINFO_ASSERT_8(tag, type, data_offset, data_size, size_offset, array_size) \
     794             :     PB_STATIC_ASSERT(PB_FITS(tag,16) && PB_FITS(data_offset,16) && PB_FITS((int_least8_t)size_offset,8) && PB_FITS(data_size,16) && PB_FITS(array_size,16), FIELDINFO_DOES_NOT_FIT_width8_field ## tag)
     795             : #else
     796             : /* Up to 32-bit fields supported.
     797             :  * Note that the checks are against 31 bits to avoid compiler warnings about shift wider than type in the test.
     798             :  * I expect that there is no reasonable use for >2GB messages with nanopb anyway.
     799             :  */
     800             : #define PB_FIELDINFO_ASSERT_4(tag, type, data_offset, data_size, size_offset, array_size) \
     801             :     PB_STATIC_ASSERT(PB_FITS(tag,30) && PB_FITS(data_offset,31) && PB_FITS(size_offset,8) && PB_FITS(data_size,31) && PB_FITS(array_size,16), FIELDINFO_DOES_NOT_FIT_width4_field ## tag)
     802             : 
     803             : #define PB_FIELDINFO_ASSERT_8(tag, type, data_offset, data_size, size_offset, array_size) \
     804             :     PB_STATIC_ASSERT(PB_FITS(tag,30) && PB_FITS(data_offset,31) && PB_FITS(size_offset,8) && PB_FITS(data_size,31) && PB_FITS(array_size,31), FIELDINFO_DOES_NOT_FIT_width8_field ## tag)
     805             : #endif
     806             : 
     807             : 
     808             : /* Automatic picking of FIELDINFO width:
     809             :  * Uses width 1 when possible, otherwise resorts to width 2.
     810             :  * This is used when PB_BIND() is called with "AUTO" as the argument.
     811             :  * The generator will give explicit size argument when it knows that a message
     812             :  * structure grows beyond 1-word format limits.
     813             :  */
     814             : #define PB_FIELDINFO_WIDTH_AUTO(atype, htype, ltype) PB_FI_WIDTH ## atype(htype, ltype)
     815             : #define PB_FI_WIDTH_PB_ATYPE_STATIC(htype, ltype) PB_FI_WIDTH ## htype(ltype)
     816             : #define PB_FI_WIDTH_PB_ATYPE_POINTER(htype, ltype) PB_FI_WIDTH ## htype(ltype)
     817             : #define PB_FI_WIDTH_PB_ATYPE_CALLBACK(htype, ltype) 2
     818             : #define PB_FI_WIDTH_PB_HTYPE_REQUIRED(ltype) PB_FI_WIDTH ## ltype
     819             : #define PB_FI_WIDTH_PB_HTYPE_SINGULAR(ltype) PB_FI_WIDTH ## ltype
     820             : #define PB_FI_WIDTH_PB_HTYPE_OPTIONAL(ltype) PB_FI_WIDTH ## ltype
     821             : #define PB_FI_WIDTH_PB_HTYPE_ONEOF(ltype) PB_FI_WIDTH ## ltype
     822             : #define PB_FI_WIDTH_PB_HTYPE_REPEATED(ltype) 2
     823             : #define PB_FI_WIDTH_PB_HTYPE_FIXARRAY(ltype) 2
     824             : #define PB_FI_WIDTH_PB_LTYPE_BOOL      1
     825             : #define PB_FI_WIDTH_PB_LTYPE_BYTES     2
     826             : #define PB_FI_WIDTH_PB_LTYPE_DOUBLE    1
     827             : #define PB_FI_WIDTH_PB_LTYPE_ENUM      1
     828             : #define PB_FI_WIDTH_PB_LTYPE_UENUM     1
     829             : #define PB_FI_WIDTH_PB_LTYPE_FIXED32   1
     830             : #define PB_FI_WIDTH_PB_LTYPE_FIXED64   1
     831             : #define PB_FI_WIDTH_PB_LTYPE_FLOAT     1
     832             : #define PB_FI_WIDTH_PB_LTYPE_INT32     1
     833             : #define PB_FI_WIDTH_PB_LTYPE_INT64     1
     834             : #define PB_FI_WIDTH_PB_LTYPE_MESSAGE   2
     835             : #define PB_FI_WIDTH_PB_LTYPE_MSG_W_CB  2
     836             : #define PB_FI_WIDTH_PB_LTYPE_SFIXED32  1
     837             : #define PB_FI_WIDTH_PB_LTYPE_SFIXED64  1
     838             : #define PB_FI_WIDTH_PB_LTYPE_SINT32    1
     839             : #define PB_FI_WIDTH_PB_LTYPE_SINT64    1
     840             : #define PB_FI_WIDTH_PB_LTYPE_STRING    2
     841             : #define PB_FI_WIDTH_PB_LTYPE_UINT32    1
     842             : #define PB_FI_WIDTH_PB_LTYPE_UINT64    1
     843             : #define PB_FI_WIDTH_PB_LTYPE_EXTENSION 1
     844             : #define PB_FI_WIDTH_PB_LTYPE_FIXED_LENGTH_BYTES 2
     845             : 
     846             : /* The mapping from protobuf types to LTYPEs is done using these macros. */
     847             : #define PB_LTYPE_MAP_BOOL               PB_LTYPE_BOOL
     848             : #define PB_LTYPE_MAP_BYTES              PB_LTYPE_BYTES
     849             : #define PB_LTYPE_MAP_DOUBLE             PB_LTYPE_FIXED64
     850             : #define PB_LTYPE_MAP_ENUM               PB_LTYPE_VARINT
     851             : #define PB_LTYPE_MAP_UENUM              PB_LTYPE_UVARINT
     852             : #define PB_LTYPE_MAP_FIXED32            PB_LTYPE_FIXED32
     853             : #define PB_LTYPE_MAP_FIXED64            PB_LTYPE_FIXED64
     854             : #define PB_LTYPE_MAP_FLOAT              PB_LTYPE_FIXED32
     855             : #define PB_LTYPE_MAP_INT32              PB_LTYPE_VARINT
     856             : #define PB_LTYPE_MAP_INT64              PB_LTYPE_VARINT
     857             : #define PB_LTYPE_MAP_MESSAGE            PB_LTYPE_SUBMESSAGE
     858             : #define PB_LTYPE_MAP_MSG_W_CB           PB_LTYPE_SUBMSG_W_CB
     859             : #define PB_LTYPE_MAP_SFIXED32           PB_LTYPE_FIXED32
     860             : #define PB_LTYPE_MAP_SFIXED64           PB_LTYPE_FIXED64
     861             : #define PB_LTYPE_MAP_SINT32             PB_LTYPE_SVARINT
     862             : #define PB_LTYPE_MAP_SINT64             PB_LTYPE_SVARINT
     863             : #define PB_LTYPE_MAP_STRING             PB_LTYPE_STRING
     864             : #define PB_LTYPE_MAP_UINT32             PB_LTYPE_UVARINT
     865             : #define PB_LTYPE_MAP_UINT64             PB_LTYPE_UVARINT
     866             : #define PB_LTYPE_MAP_EXTENSION          PB_LTYPE_EXTENSION
     867             : #define PB_LTYPE_MAP_FIXED_LENGTH_BYTES PB_LTYPE_FIXED_LENGTH_BYTES
     868             : 
     869             : /* These macros are used for giving out error messages.
     870             :  * They are mostly a debugging aid; the main error information
     871             :  * is the true/false return value from functions.
     872             :  * Some code space can be saved by disabling the error
     873             :  * messages if not used.
     874             :  *
     875             :  * PB_SET_ERROR() sets the error message if none has been set yet.
     876             :  *                msg must be a constant string literal.
     877             :  * PB_GET_ERROR() always returns a pointer to a string.
     878             :  * PB_RETURN_ERROR() sets the error and returns false from current
     879             :  *                   function.
     880             :  */
     881             : #ifdef PB_NO_ERRMSG
     882             : #define PB_SET_ERROR(stream, msg) PB_UNUSED(stream)
     883             : #define PB_GET_ERROR(stream) "(errmsg disabled)"
     884             : #else
     885           0 : #define PB_SET_ERROR(stream, msg) (stream->errmsg = (stream)->errmsg ? (stream)->errmsg : (msg))
     886             : #define PB_GET_ERROR(stream) ((stream)->errmsg ? (stream)->errmsg : "(none)")
     887             : #endif
     888             : 
     889           0 : #define PB_RETURN_ERROR(stream, msg) return PB_SET_ERROR(stream, msg), false
     890             : 
     891             : #ifdef __cplusplus
     892             : } /* extern "C" */
     893             : #endif
     894             : 
     895             : #ifdef __cplusplus
     896             : #if __cplusplus >= 201103L
     897             : #define PB_CONSTEXPR constexpr
     898             : #else  // __cplusplus >= 201103L
     899             : #define PB_CONSTEXPR
     900             : #endif  // __cplusplus >= 201103L
     901             : 
     902             : #if __cplusplus >= 201703L
     903             : #define PB_INLINE_CONSTEXPR inline constexpr
     904             : #else  // __cplusplus >= 201703L
     905             : #define PB_INLINE_CONSTEXPR PB_CONSTEXPR
     906             : #endif  // __cplusplus >= 201703L
     907             : 
     908             : extern "C++"
     909             : {
     910             : namespace nanopb {
     911             : // Each type will be partially specialized by the generator.
     912             : template <typename GenMessageT> struct MessageDescriptor;
     913             : }  // namespace nanopb
     914             : }
     915             : #endif  /* __cplusplus */
     916             : 
     917             : #endif

Generated by: LCOV version 1.14