| /* |
| * 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_ */ |
