zwave_s2_nonce_management.h

Go to the documentation of this file.

/******************************************************************************
 * # License
 * <b>Copyright 2021 Silicon Laboratories Inc. www.silabs.com</b>
 ******************************************************************************
 * The licensor of this software is Silicon Laboratories Inc. Your use of this
 * software is governed by the terms of Silicon Labs Master Software License
 * Agreement (MSLA) available at
 * www.silabs.com/about-us/legal/master-software-license-agreement. This
 * software is distributed to you in Source Code format and is governed by the
 * sections of the MSLA applicable to Source Code.
 *
 *****************************************************************************/
 
#ifndef ZWAVE_S2_NONCE_MANAGEMENT_H
#define ZWAVE_S2_NONCE_MANAGEMENT_H
 
#include "sl_status.h"
#include "zwave_node_id_definitions.h"
#include "zwave_controller_types.h"
 
#define CTR_DRBG_KEY_LENGTH 16
#define CTR_DRBG_INTERNAL_STATE_LENGTH 16
#define MPAN_INNER_STATE_LENGTH 16
 
typedef struct span_entry {
  uint8_t df;
  uint8_t working_state[CTR_DRBG_INTERNAL_STATE_LENGTH];
  uint8_t key[CTR_DRBG_KEY_LENGTH];
  uint8_t rx_sequence;
  uint8_t tx_sequence;
  uint8_t class_id;
} span_entry_t;
 
typedef struct mpan_entry {
  uint8_t inner_state[MPAN_INNER_STATE_LENGTH];
  zwave_node_id_t owner_node_id;
  uint8_t group_id;
  uint8_t class_id;
} mpan_entry_t;
 
#ifdef __cplusplus
extern "C" {
#endif
 
sl_status_t zwave_s2_get_span_data(zwave_node_id_t node_id,
                                   span_entry_t *span_data);
 
void zwave_s2_set_span_table(zwave_node_id_t node_id,
                             const span_entry_t *span_data);
 
sl_status_t zwave_s2_get_mpan_data(zwave_node_id_t owner_node_id,
                                   zwave_multicast_group_id_t group_id,
                                   mpan_entry_t *mpan_data);
 
void zwave_s2_set_mpan_data(zwave_node_id_t owner_node_id,
                            zwave_multicast_group_id_t group_id,
                            const mpan_entry_t *mpan_data);
void zwave_s2_reset_span(zwave_node_id_t node_id);
 
void zwave_s2_reset_mpan(zwave_node_id_t owner_node_id,
                         zwave_multicast_group_id_t group_id);
#ifdef __cplusplus
}
#endif
 
#endif  //ZWAVE_S2_NONCE_MANAGEMENT_H