summaryrefslogtreecommitdiff
path: root/misc/Obsoleted/configs/16z/include/board.h
blob: a60e1a359ad343d1de07c62b1ee38ad6fdf48fd7 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
/****************************************************************************
 * configs/16z/include/board.h
 *
 *   Copyright (C) 2014 Gregory Nutt. All rights reserved.
 *   Author: Gregory Nutt <gnutt@nuttx.org>
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in
 *    the documentation and/or other materials provided with the
 *    distribution.
 * 3. Neither the name NuttX nor the names of its contributors may be
 *    used to endorse or promote products derived from this software
 *    without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
 * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
 * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
 * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
 * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 * POSSIBILITY OF SUCH DAMAGE.
 *
 ****************************************************************************/

#ifndef __CONFIGS_16Z_INCLUDE_BOARD_H
#define __CONFIGS_16Z_INCLUDE_BOARD_H

/****************************************************************************
 * Included Files
 ****************************************************************************/

/****************************************************************************
 * Definitions
 ****************************************************************************/

/* The 16Z board has a 18.432MHz crystal.  The ZNEO clocking will be
 * configured to use this crystal frequency directly as the clock source
 */

#define BOARD_XTAL_FREQUENCY   18432000 /* 18.432MHz */
#define BOARD_CLKSRC           1        /* Clock source = external crystal */
#define BOARD_SYSTEM_FREQUENCY BOARD_XTAL_FREQUENCY

/* Flash option bits
 *
 * "Each time the option bits are programmed or erased, the device must be
 *  Reset for the change to take place. During any reset operation .., the
 *  option bits are automatically read from the Program memory and written
 *  to Option Configuration registers. ... Option Bit Control Register are
 *  loaded before the device exits Reset and the ZNEO CPU begins code
 *  execution. The Option Configuration registers are not part of the
 *  Register file and are not accessible for read or write access."
 *
 * "The FLASH3 value of 0x7f is very important because it enables the
 *  J-port, otherwise used for 16-bit data.
 *
 * "... in 16z there are some unusual hardware connections. ZNEO
 *  communicates with 16-bit memory via 8-bit bus and using the 16-bit
 *  control signals BHE and BLE."
 */

#ifndef __ASSEMBLY__
#  define BOARD_FLOPTION0 (Z16F_FLOPTION0_MAXPWR | Z16F_FLOPTION0_WDTRES | \
                           Z16F_FLOPTION0_WDTA0 | Z16F_FLOPTION0_VBOA0 | \
                           Z16F_FLOPTION0_DBGUART | Z16F_FLOPTION0_FWP | \
                           Z16F_FLOPTION0_RP)

#  define BOARD_FLOPTION1 (Z16F_FLOPTION1_RESVD | Z16F_FLOPTION1_MCEN | \
                           Z16F_FLOPTION1_OFFH | Z16F_FLOPTION1_OFFL)

#  define BOARD_FLOPTION2 Z16F_FLOPTION2_RESVD

#  define BOARD_FLOPTION3 (Z16F_FLOPTION3_RESVD | Z16F_FLOPTION3_NORMAL)

/* The same settings, pre-digested for assembly language */

#else
#  define BOARD_FLOPTION0 %ff
#  define BOARD_FLOPTION1 %ff
#  define BOARD_FLOPTION2 %ff
#  define BOARD_FLOPTION3 %7f
#endif

/* LEDs
 *
 * The 16z board has 7 LEDs, five of which are controllable via software:
 *
 *   ----- ------ ------ ------------------------------------
 *   LED   Color  Signal Description
 *   ----- ------ ------ ------------------------------------
 *   LED1  Red     3V3   Indicates the presence of +3.3V
 *   LED2  Red     5V    Indicates the presence of +5V

 *   LED3  Blue    ~RF   Controlled via PH2.  Notes: 1, 2
 *   LED4  Green   ~SXM  Controlled via PH3.  Notes: 1, 3
 *   LED5  Green   ~SD1  Controlled via PJ0.  Notes: 1, 4
 *   LED6  Yellow  ~SD2  Controlled via PJ4.  Notes: 1, 5
 *   LED7  Yellow  ~SD0  Controlled via PJ7.  Notes: 1, 6
 *   ----- ------ ------ ------------------------------------
 *
 *   Note 1:  Pulled high so a low output illuminates the LED.
 *   Note 2:  PH2/~RF is also used by the RF transceiver, X2.  That part is not
 *            populated on my board.
 *   Note 3:  ~SXM is the chip select for the serial memory, U4.  That part is
 *            not populated on my board.
 *   Note 4:  ~SD1 is the chip select for the SD card 1, X11.
 *   Note 5:  ~SD2 is the chip select for the SD card 2, X10.
 *   Note 6:  ~SD0 is the chip select for the microSD 0, X12.
 *
 * In conclusion:  None of the LEDs are available to indicate software status
 * without potentially sacrificing board functionality.  If the RF transceiver
 * is not installed (CONFIG_16Z_RFTRANSCEIVER=n) and if LED support is
 * requested (CONFIG_ARCH_LEDS), then LED3 will be used to indicate status:  A
 * solid color means that the board has boot successfully; flashing at a rate
 * of approximately 2Hz indicates a software failure.
 */

#define __LED3_BIT (1 << 0)
#define __LED4_BIT (1 << 1)
#undef  HAVE_16Z_LED3
#undef  HAVE_16Z_LED4

#if !defined(CONFIG_16Z_RFTRANSCEIVER)
#  define __LEDPANIC __LED3_BIT
#  define HAVE_16Z_LED3
#elif !defined(CONFIG_16Z_SERIAL_MEMORY)
#  define __LEDPANIC __LED4_BIT
#  define HAVE_16Z_LED4
#else
#  define __LEDPANIC (0)
#endif

#if !defined(CONFIG_16Z_SERIAL_MEMORY) && !defined(HAVE_16Z_LED4)
#  define __LEDSTARTED __LED4_BIT
#  define HAVE_16Z_LED4
#else
#  define __LEDSTARTED __LEDPANIC
#endif
                                        /* LED3   LED4 */
#define LED_STARTED       0             /* OFF    OFF  */
#define LED_HEAPALLOCATE  0             /* N/C    N/C  */
#define LED_IRQSENABLED   0             /* N/C    N/C  */
#define LED_STACKCREATED  __LEDSTARTED  /* N/C    ON   */
#define LED_INIRQ         0             /* N/C    N/C  */
#define LED_SIGNAL        0             /* N/C    N/C  */
#define LED_ASSERTION     0             /* N/C    N/C  */
#define LED_PANIC         __LEDPANIC    /* ON     N/C  */

/****************************************************************************
 * Public Functions
 ****************************************************************************/

#undef EXTERN
#if defined(__cplusplus)
#define EXTERN extern "C"
extern "C" {
#else
#define EXTERN extern
#endif

#undef EXTERN
#if defined(__cplusplus)
}
#endif

#endif  /* __CONFIGS_16Z_INCLUDE_BOARD_H */