/*
|
* Interface definitions for reversed TLVs
|
*
|
* Copyright (C) 2020, Broadcom.
|
*
|
* Unless you and Broadcom execute a separate written software license
|
* agreement governing use of this software, this software is licensed to you
|
* under the terms of the GNU General Public License version 2 (the "GPL"),
|
* available at http://www.broadcom.com/licenses/GPLv2.php, with the
|
* following added to such license:
|
*
|
* As a special exception, the copyright holders of this software give you
|
* permission to link this software with independent modules, and to copy and
|
* distribute the resulting executable under terms of your choice, provided that
|
* you also meet, for each linked independent module, the terms and conditions of
|
* the license of that module. An independent module is a module which is not
|
* derived from this software. The special exception does not apply to any
|
* modifications of the software.
|
*
|
*
|
* <<Broadcom-WL-IPTag/Dual:>>
|
*/
|
|
#ifndef _dngl_rtlv_h_
|
#define _dngl_rtlv_h_
|
|
#include <typedefs.h>
|
|
/* Types of reverse TLVs downloaded to the top of dongle RAM.
|
* A reverse TLV consists of:
|
* data <variable length>
|
* len <4 bytes>
|
* type <4 bytes>
|
*/
|
enum {
|
DNGL_RTLV_TYPE_NONE = 0,
|
/* replaces bcmrand.h BCM_NVRAM_RNG_SIGNATURE */
|
DNGL_RTLV_TYPE_RNG_SIGNATURE = 0xFEEDC0DEu, /* RNG random data */
|
DNGL_RTLV_TYPE_FW_SIGNATURE = 0xFEEDFE51, /* FW signature */
|
DNGL_RTLV_TYPE_NVRAM_SIGNATURE = 0xFEEDFE52, /* NVRAM signature */
|
DNGL_RTLV_TYPE_FWSIGN_MEM_MAP = 0xFEEDFE53, /* FW signing memory map */
|
DNGL_RTLV_TYPE_FWSIGN_STATUS = 0xFEEDFE54, /* signature verification status */
|
DNGL_RTLV_TYPE_END_MARKER = 0xFEED0E2D, /* end of rTLVs marker */
|
};
|
typedef uint32 dngl_rtlv_type_t;
|
typedef uint32 dngl_rtlv_len_t;
|
|
/* Search for a reversed TLV with the given type, starting at the given address */
|
int dngl_rtlv_find(const uint8 *rtlv_ptr, const uint8 *addr_limit, dngl_rtlv_type_t type,
|
dngl_rtlv_len_t *out_len, const uint8 **out_data);
|
|
/* Search for a reversed TLV with the given type, starting at the top of RAM */
|
int dngl_rtlv_find_from_ramtop(dngl_rtlv_type_t type, dngl_rtlv_len_t *out_len,
|
const uint8 **out_data);
|
|
/* Search for the end of the reversed TLVs at the top of RAM to return the next RAM address */
|
const uint8* dngl_rtlv_skipall(void);
|
|
#ifdef RTLV_DEBUG
|
void dbg_log_rtlv(const char* str, const void* p1, const void* p2, const void *p3,
|
const void* p4, const void *p5);
|
#else /* RTLV_DEBUG */
|
#define dbg_log_rtlv(str, p1, p2, p3, p4, p5)
|
#endif /* RTLV_DEBUG */
|
|
#endif /* _dngl_rtlv_h_ */
|
