neomesh915mhz.h

Go to the documentation of this file.

/****************************************************************************
** Copyright (C) 2020 MikroElektronika d.o.o.
** Contact: https://www.mikroe.com/contact
**
** 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.
****************************************************************************/
 
#ifndef NEOMESH915MHZ_H
#define NEOMESH915MHZ_H
 
#ifdef __cplusplus
extern "C"{
#endif
 
#ifdef PREINIT_SUPPORTED
#include "preinit.h"
#endif
 
#ifdef MikroCCoreVersion
    #if MikroCCoreVersion >= 1
        #include "delays.h"
    #endif
#endif
 
#include "drv_digital_out.h"
#include "drv_digital_in.h"
#include "drv_uart.h"
 
#define NEOMESH915MHZ_CMD_NACK_SEND                 0x02
#define NEOMESH915MHZ_CMD_ACK_SEND                  0x03
#define NEOMESH915MHZ_CMD_NODE_STATUS               0x07
#define NEOMESH915MHZ_CMD_NODE_INFO                 0x08
#define NEOMESH915MHZ_CMD_NEIGHBOUR_LIST            0x09
#define NEOMESH915MHZ_CMD_NETWORK_COMMAND           0x0A
#define NEOMESH915MHZ_CMD_SAPI_TO_AAPI              0x0B
#define NEOMESH915MHZ_CMD_ROUTE_INFO                0x0C
#define NEOMESH915MHZ_CMD_WES_COMMAND               0x10
#define NEOMESH915MHZ_CMD_WES_SETUP_RSP             0x11
#define NEOMESH915MHZ_CMD_GET_SW_VERSION            0x14
#define NEOMESH915MHZ_CMD_ALT_MODE                  0x20
 
#define NEOMESH915MHZ_RSP_ACK                       0x50
#define NEOMESH915MHZ_RSP_NACK                      0x51
#define NEOMESH915MHZ_RSP_ACK_HOST                  0x52
#define NEOMESH915MHZ_RSP_ACK_HOST_HAPA             0x53
#define NEOMESH915MHZ_RSP_NACK_HOST                 0x54
#define NEOMESH915MHZ_RSP_NACK_HOST_HAPA            0x55
#define NEOMESH915MHZ_RSP_NACK_SEND                 0x56
#define NEOMESH915MHZ_RSP_NACK_DROP                 0x57
#define NEOMESH915MHZ_RSP_NODE_INFO                 0x58
#define NEOMESH915MHZ_RSP_NEIGHBOUR_LIST            0x59
#define NEOMESH915MHZ_RSP_NETWORK_COMMAND           0x5A
#define NEOMESH915MHZ_RSP_ROUTE_INFO                0x5C
#define NEOMESH915MHZ_RSP_WES_STATUS                0x60
#define NEOMESH915MHZ_RSP_WES_SETUP                 0x61
#define NEOMESH915MHZ_RSP_GET_SW_VERSION            0x64
#define NEOMESH915MHZ_RSP_ALT_MODE                  0x70
 
#define NEOMESH915MHZ_SAPI_CMD_LOGIN                0x0103u
#define NEOMESH915MHZ_SAPI_CMD_RESET_LIST_ITERATOR  0x0104u
#define NEOMESH915MHZ_SAPI_CMD_GET_LIST             0x0105u
#define NEOMESH915MHZ_SAPI_CMD_GET_SETTING_FLASH    0x0106u
#define NEOMESH915MHZ_SAPI_CMD_GET_SETTING_RAM      0x0107u
#define NEOMESH915MHZ_SAPI_CMD_COMMIT_SETTINGS      0x0108u
#define NEOMESH915MHZ_SAPI_CMD_DISCARD_SETTINGS     0x0109u
#define NEOMESH915MHZ_SAPI_CMD_SET_SETTING          0x010Au
#define NEOMESH915MHZ_SAPI_CMD_START_PROTOCOL_STACK 0x0112u
#define NEOMESH915MHZ_SAPI_CMD_START_BOOTLOADER     0x0113u
#define NEOMESH915MHZ_SAPI_HEADER                   0x3E
#define NEOMESH915MHZ_SAPI_TRAIL                    0x21
 
#define NEOMESH915MHZ_SAPI_RSP_OK                   0x0380u
#define NEOMESH915MHZ_SAPI_RSP_ERROR                0x0381u
#define NEOMESH915MHZ_SAPI_RSP_BOOTLOADER_START     0x0382u
#define NEOMESH915MHZ_SAPI_RSP_PROTOCOL_STACK_START 0x0383u
#define NEOMESH915MHZ_SAPI_RSP_PROTOCOL_STACK_ERROR 0x0384u
#define NEOMESH915MHZ_SAPI_RSP_RESET                0x0385u
#define NEOMESH915MHZ_SAPI_RSP_SETTINGS_LIST_OUTPUT 0x0185u
#define NEOMESH915MHZ_SAPI_RSP_SETTINGS_VALUE       0x0186u
 
#define NEOMESH915MHZ_SAPI_LOGIN_PASSWORD_0         0x4C
#define NEOMESH915MHZ_SAPI_LOGIN_PASSWORD_1         0x76
#define NEOMESH915MHZ_SAPI_LOGIN_PASSWORD_2         0x6C
#define NEOMESH915MHZ_SAPI_LOGIN_PASSWORD_3         0x31
#define NEOMESH915MHZ_SAPI_LOGIN_PASSWORD_4         0x30
 
#define NEOMESH915MHZ_SAPI_SETTINGS_ID_NODE_ID      0x0A
 
#define NEOMESH915MHZ_TIMEOUT_MS                    20000ul
 
#define NEOMESH915MHZ_MAX_PAYLOAD_LEN               255
 
#define NEOMESH915MHZ_TX_DRV_BUFFER_SIZE            300u
#define NEOMESH915MHZ_RX_DRV_BUFFER_SIZE            300u
 
 // neomesh915mhz_cmd
 
#define NEOMESH915MHZ_MAP_MIKROBUS( cfg, mikrobus ) \
    cfg.tx_pin = MIKROBUS( mikrobus, MIKROBUS_TX ); \
    cfg.rx_pin = MIKROBUS( mikrobus, MIKROBUS_RX ); \
    cfg.app = MIKROBUS( mikrobus, MIKROBUS_AN ); \
    cfg.rst = MIKROBUS( mikrobus, MIKROBUS_RST ); \
    cfg.wes = MIKROBUS( mikrobus, MIKROBUS_CS ); \
    cfg.cts = MIKROBUS( mikrobus, MIKROBUS_PWM ); \
    cfg.wup = MIKROBUS( mikrobus, MIKROBUS_INT );
 
 // neomesh915mhz_map
 // neomesh915mhz
 
typedef struct
{
    // Output pins
    digital_out_t rst;  
    digital_out_t wes;  
    // Input pins
    digital_in_t app;   
    digital_in_t cts;   
    digital_in_t wup;   
    // Modules
    uart_t uart;        
    // Buffers
    uint8_t uart_rx_buffer[ NEOMESH915MHZ_RX_DRV_BUFFER_SIZE ]; 
    uint8_t uart_tx_buffer[ NEOMESH915MHZ_TX_DRV_BUFFER_SIZE ]; 
} neomesh915mhz_t;
 
typedef struct
{
    // Communication gpio pins
    pin_name_t rx_pin;  
    pin_name_t tx_pin;  
    // Additional gpio pins
    pin_name_t app;     
    pin_name_t rst;     
    pin_name_t wes;     
    pin_name_t cts;     
    pin_name_t wup;     
    // Static variable
    uint32_t         baud_rate;     
    bool             uart_blocking; 
    uart_data_bits_t data_bit;      
    uart_parity_t    parity_bit;    
    uart_stop_bits_t stop_bit;      
} neomesh915mhz_cfg_t;
 
typedef struct
{
    uint8_t cmd;                                        
    uint8_t len;                                        
    uint8_t payload[ NEOMESH915MHZ_MAX_PAYLOAD_LEN ];   
} neomesh915mhz_aapi_frame_t;
 
typedef struct
{
    uint16_t cmd;                                       
    uint8_t len;                                        
    uint8_t payload[ NEOMESH915MHZ_MAX_PAYLOAD_LEN ];   
} neomesh915mhz_sapi_frame_t;
 
typedef enum
{
    NEOMESH915MHZ_OK = 0,
    NEOMESH915MHZ_ERROR = -1,
    NEOMESH915MHZ_TIMEOUT = -2
 
} neomesh915mhz_return_value_t;
 
void neomesh915mhz_cfg_setup ( neomesh915mhz_cfg_t *cfg );
 
err_t neomesh915mhz_init ( neomesh915mhz_t *ctx, neomesh915mhz_cfg_t *cfg );
 
err_t neomesh915mhz_send_aapi_frame ( neomesh915mhz_t *ctx, neomesh915mhz_aapi_frame_t *frame );
 
err_t neomesh915mhz_read_aapi_frame ( neomesh915mhz_t *ctx, neomesh915mhz_aapi_frame_t *frame );
 
err_t neomesh915mhz_send_sapi_frame ( neomesh915mhz_t *ctx, neomesh915mhz_sapi_frame_t *frame );
 
err_t neomesh915mhz_read_sapi_frame ( neomesh915mhz_t *ctx, neomesh915mhz_sapi_frame_t *frame );
 
void neomesh915mhz_set_rst_pin ( neomesh915mhz_t *ctx, uint8_t state );
 
void neomesh915mhz_set_wes_pin ( neomesh915mhz_t *ctx, uint8_t state );
 
uint8_t neomesh915mhz_get_app_pin ( neomesh915mhz_t *ctx );
 
uint8_t neomesh915mhz_get_cts_pin ( neomesh915mhz_t *ctx );
 
uint8_t neomesh915mhz_get_wup_pin ( neomesh915mhz_t *ctx );
 
#ifdef __cplusplus
}
#endif
#endif // NEOMESH915MHZ_H
 
 // neomesh915mhz
 
// ------------------------------------------------------------------------ END