1 /*
2 * Declare directives for structure packing. No padding will be provided
3 * between the members of packed structures, and therefore, there is no
4 * guarantee that structure members will be aligned.
5 *
6 * Declaring packed structures is compiler specific. In order to handle all
7 * cases, packed structures should be delared as:
8 *
9 * #include <packed_section_start.h>
10 *
11 * typedef BWL_PRE_PACKED_STRUCT struct foobar_t {
12 * some_struct_members;
13 * } BWL_POST_PACKED_STRUCT foobar_t;
14 *
15 * #include <packed_section_end.h>
16 *
17 *
18 * Portions of this code are copyright (c) 2021 Cypress Semiconductor Corporation
19 *
20 * Copyright (C) 1999-2017, Broadcom Corporation
21 *
22 * Unless you and Broadcom execute a separate written software license
23 * agreement governing use of this software, this software is licensed to you
24 * under the terms of the GNU General Public License version 2 (the "GPL"),
25 * available at http://www.broadcom.com/licenses/GPLv2.php, with the
26 * following added to such license:
27 *
28 * As a special exception, the copyright holders of this software give you
29 * permission to link this software with independent modules, and to copy and
30 * distribute the resulting executable under terms of your choice, provided that
31 * you also meet, for each linked independent module, the terms and conditions of
32 * the license of that module. An independent module is a module which is not
33 * derived from this software. The special exception does not apply to any
34 * modifications of the software.
35 *
36 * Notwithstanding the above, under no circumstances may you combine this
37 * software in any way with any other Broadcom software provided under a license
38 * other than the GPL, without Broadcom's express prior written consent.
39 *
40 *
41 * <<Broadcom-WL-IPTag/Open:>>
42 *
43 * $Id: packed_section_start.h 666738 2016-10-24 12:16:37Z $
44 */
45
46 #ifndef _alignment_test_
47 #define _alignment_test_
48
49 /* ASSERT default packing */
50 typedef struct T4 {
51 uint8 a;
52 uint32 b;
53 uint16 c;
54 uint8 d;
55 } T4_t;
56
57 /* 4 byte alignment support */
58 /*
59 * a . . .
60 * b b b b
61 * c c d .
62 */
63
64 /*
65 * Below function is meant to verify that this file is compiled with the default alignment of 4.
66 * Function will fail to compile if the condition is not met.
67 */
68 #ifdef __GNUC__
69 #define VARIABLE_IS_NOT_USED __attribute__ ((unused))
70 #else
71 #define VARIABLE_IS_NOT_USED
72 #endif // endif
73 static void alignment_test(void);
74 static void
alignment_test(void)75 VARIABLE_IS_NOT_USED alignment_test(void)
76 {
77 /* verify 4 byte alignment support */
78 STATIC_ASSERT(sizeof(T4_t) == 12);
79 }
80 #endif /* _alignment_test_ */
81
82 /* Error check - BWL_PACKED_SECTION is defined in packed_section_start.h
83 * and undefined in packed_section_end.h. If it is already defined at this
84 * point, then there is a missing include of packed_section_end.h.
85 */
86 #ifdef BWL_PACKED_SECTION
87 #error "BWL_PACKED_SECTION is already defined!"
88 #else
89 #define BWL_PACKED_SECTION
90 #endif // endif
91
92 #if defined(BWL_DEFAULT_PACKING)
93 /* generate an error if BWL_DEFAULT_PACKING is defined */
94 #error "BWL_DEFAULT_PACKING not supported any more."
95 #endif /* BWL_PACKED_SECTION */
96
97 /* Declare compiler-specific directives for structure packing. */
98 #if defined(__GNUC__) || defined(__lint)
99 #define BWL_PRE_PACKED_STRUCT
100 #define BWL_POST_PACKED_STRUCT __attribute__ ((packed))
101 #elif defined(__CC_ARM)
102 #define BWL_PRE_PACKED_STRUCT __packed
103 #define BWL_POST_PACKED_STRUCT
104 #else
105 #error "Unknown compiler!"
106 #endif // endif
107