easycomm-parser.h

#pragma once
#ifdef __cplusplus
extern "C"
{
#endif

#include "easycomm-parser-types.h"
#include <stdbool.h>

    /**
     * notes: do not
     * - change enum order
     * - assign values to enum items
     */
    typedef enum EasycommParserStandard
    {
        EasycommParserStandard1,   // standard 1 only
                                   // - compatible with #201 Hamlib Model: EasycommI
        EasycommParserStandard12,  // standard 1 and 2
        EasycommParserStandard123, // standard 1, 2 and 3
        EasycommParserStandard2,   // standard 2 only, 1 excluded
                                   // - compatible with #202 Hamlib Model: EasycommII
        EasycommParserStandard23,  // standard 2 and 3, 1 excluded
                                   // - compatible with #204 Hamlib Model: EasycommIII
        EasycommParserStandard3,   // standard 3 only, 1 and 2 excluded
    } EasycommParserStandard;

    /**
     * Parses issued commands from host
     * @param buffer the command string: trimmed, no whitespace, null terminated, without "\r" "\n"
     * @param protocol_standard Easycomm standard: to intercept
     * @param parsed the parsed structure (assume the struct touched in any case regardless of return value)
     * @return true on success
     */
    bool easycommParseCommand(const char *buffer, EasycommData *parsed, EasycommParserStandard protocol_standard);

#ifdef __cplusplus
}
#endif