rn2903.hpp

/*
 * Author: Jon Trulson <jtrulson@ics.com>
 * Copyright (c) 2017 Intel Corporation.
 *
 * Permission is hereby granted, free of charge, to any person obtaining
 * a copy of this software and associated documentation files (the
 * "Software"), to deal in the Software without restriction, including
 * without limitation the rights to use, copy, modify, merge, publish,
 * distribute, sublicense, and/or sell copies of the Software, and to
 * permit persons to whom the Software is furnished to do so, subject to
 * the following conditions:
 *
 * The above copyright notice and this permission notice shall be
 * included in all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
 * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
 * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
 * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 */
#pragma once

#include <string>
#include <iostream>

#include "rn2903.h"

namespace upm {
    class RN2903 {
    public:

        RN2903(unsigned int uart,
               unsigned int baudrate=RN2903_DEFAULT_BAUDRATE);

        RN2903(std::string uart_path,
               unsigned int baudrate=RN2903_DEFAULT_BAUDRATE);

        virtual ~RN2903();

        void setResponseWaitTime(
            unsigned int wait_ms=RN2903_DEFAULT_RESP_DELAY);

        void setResponse2WaitTime(
            unsigned int wait_ms=RN2903_DEFAULT_RESP2_DELAY);

        bool dataAvailable(unsigned int millis);

        void drain();

        RN2903_RESPONSE_T command(const std::string cmd);

        RN2903_RESPONSE_T commandWithArg(const std::string cmd,
                                         const std::string arg);

        RN2903_RESPONSE_T waitForResponse(int wait_ms);

        std::string getResponse();

        int getResponseLen();

        void setDeviceEUI(const std::string str);

        void getDeviceEUI();

        void setDeviceAddr(std::string str);

        void getDeviceAddr();

        void setNetworkSessionKey(std::string str);

        void setApplicationSessionKey(std::string str);

        void setApplicationEUI(const std::string str);

        void getApplicationEUI();

        void setApplicationKey(const std::string str);

        void getApplicationKey();

        std::string toHex(const std::string src);

        std::string fromHex(const std::string src);

        RN2903_JOIN_STATUS_T join(RN2903_JOIN_TYPE_T type);

        RN2903_MAC_TX_STATUS_T macTx(RN2903_MAC_MSG_TYPE_T type,
                                     int port, std::string payload);

        RN2903_RESPONSE_T radioTx(const std::string payload);

        RN2903_RESPONSE_T radioRx(int window_size);

        std::string getHardwareEUI();

        void updateMacStatus();

        int getMacStatusWord();

        RN2903_MAC_STATUS_T getMacStatus();

        void macSave();

        void macPause();

        void macResume();

        void reset();

        void macSetBattery(int level);

        void setDebug(bool enable);

        void setBaudrate(unsigned int baudrate);

        void setFlowControl(RN2903_FLOW_CONTROL_T fc);

        bool find(const std::string str);

        std::string getRadioRxPayload();

        bool autobaud(int retries);


    protected:
        // rn2903 device context
        rn2903_context m_rn2903;

        std::string read(int size);

        int write(std::string buffer);

    private:
        /* Disable implicit copy and assignment operators */
        RN2903(const RN2903&) = delete;
        RN2903 &operator=(const RN2903&) = delete;
    };
}