4
4
5
5
Nerve dev board using off-the-shelf modules.
6
6
7
+ > ** Note: This design is now no longer under active development. The final
8
+ changes to the main branch are published as release tagged ` v0.1.0-beta ` ,
9
+ see the release notes: [ 1.1 v0.1.0-beta] ( #11-v010-beta ) .**
10
+
11
+ > 💡** Hint:** To clone this repository use:
12
+ > ``` shell
13
+ > git clone --recursive
14
+ > ` ` `
15
+
7
16
! [nerve_ada_board.png](docs/nerve_ada_board.png)
8
17
9
18
---
@@ -13,26 +22,70 @@ Nerve dev board using off-the-shelf modules.
13
22
14
23
< ! -- TOC -->
15
24
* [nerve_ada_board](# nerve_ada_board)
16
- * [ 1 Overview] ( #1-overview )
17
- * [ 1.1 Function Connectors] ( #11-function-connectors )
18
- * [ 1.2 Switches & Jumpers] ( #12-switches--jumpers )
19
- * [ 1.3 Plug-in Modules] ( #13-plug-in-modules )
20
- * [ 1.4 Breakout Connectors] ( #14-breakout-connectors )
21
- * [ 2 Development] ( #2-development )
22
- * [ 3 Production History] ( #3-production-history )
23
- * [ 3.1 v0.1.0-alpha-7b18788] ( #31-v010-alpha-7b18788 )
25
+ * [1 Release Notes](# 1-release-notes)
26
+ * [1.1 v0.1.0-beta](# 11-v010-beta)
27
+ * [1.1.1 LSE Crystal](# 111-lse-crystal)
28
+ * [1.1.2 External Clock Crystal Tuning](# 112-external-clock-crystal-tuning)
29
+ * [1.1.3 GPS](# 113-gps)
30
+ * [2 Overview](# 2-overview)
31
+ * [2.1 Function Connectors](# 21-function-connectors)
32
+ * [2.2 Switches & Jumpers](# 22-switches--jumpers)
33
+ * [2.3 Plug-in Modules](# 23-plug-in-modules)
34
+ * [2.4 Breakout Connectors](# 24-breakout-connectors)
35
+ * [3 Development](# 3-development)
36
+ * [3.1 Worflow](# 31-worflow)
37
+ * [3.2 Submodules](# 32-submodules)
38
+ * [4 Production History](# 4-production-history)
39
+ * [4.1 v0.1.0-alpha-7b18788](# 41-v010-alpha-7b18788)
24
40
< ! -- TOC -->
25
41
26
42
< /details>
27
43
28
44
---
29
45
30
- ## 1 Overview
46
+ # # 1 Release Notes
47
+
48
+ # ## 1.1 v0.1.0-beta
49
+
50
+ Following the initial validation of components and software on this PCB design,
51
+ development has shifted to a more production-oriented
52
+ board: [nerve_pcb](https://github.com/danielljeon/nerve_pcb). While the base
53
+ components remain similar, many have been modified, with further
54
+ changes expected.
55
+
56
+ During the development of the new design, several hardware and PCB issues were
57
+ identified. Although this ` README.md` will no longer be updated, the following
58
+ sections document the known issues as of the final release.
59
+
60
+ # ### 1.1.1 LSE Crystal
61
+
62
+ The current LSE crystal on the STM32F446RE is the ABS25-32.768KHZ-6-T.
63
+
64
+ This is not the intended component; the correct crystal should have been the
65
+ ` ABS25-32.768KHZ-T` , which has a more appropriate load capacitance specification
66
+ of 12.5 pF. The ` ABS25-32.768KHZ-6-T` variant, with a 6 pF load capacitance, was
67
+ used inadvertently.
68
+
69
+ # ### 1.1.2 External Clock Crystal Tuning
70
+
71
+ The crystal circuits use calculated capacitors that have not yet been fully
72
+ verified or fine-tuned. Specifically, the 32.768 kHz LSE crystal is likely using
73
+ incorrect capacitors with a value of 1.5 pF.
74
+
75
+ # ### 1.1.3 GPS
76
+
77
+ The GPS module (` SAM-M10Q` ) had not been verified to be functional as of the
78
+ release. However, this is likely due to software limitations rather than issues
79
+ with the hardware or PCB design.
80
+
81
+ ---
82
+
83
+ # # 2 Overview
31
84
32
85
Development board for the STM32
33
86
based [nerve](https://github.com/danielljeon/nerve) controller firmware.
34
87
35
- ### 1 .1 Function Connectors
88
+ # ## 2 .1 Function Connectors
36
89
37
90
These connectors are fixed by hardware (PCB traces or the connector itself).
38
91
@@ -45,7 +98,7 @@ These connectors are fixed by hardware (PCB traces or the connector itself).
45
98
| CAN1 (Transceiver U7) | J7 | Pin 1: CAN1 High, Pin 2: CAN1 Low |
46
99
| CAN2 (Transceiver U8) | J8 | Pin 1: CAN2 High, Pin 2: CAN2 Low |
47
100
48
- ### 1 .2 Switches & Jumpers
101
+ # ## 2 .2 Switches & Jumpers
49
102
50
103
User controllable hardware and/or firmware driven inputs.
51
104
@@ -57,7 +110,7 @@ User controllable hardware and/or firmware driven inputs.
57
110
| SDIO Card Detect Jumper | J4 | Close for card inserted (pull-down on close) |
58
111
| BOOT0 Jumper | J5 | Open for run flash memory (pull-down on open) |
59
112
60
- ### 1 .3 Plug-in Modules
113
+ # ## 2 .3 Plug-in Modules
61
114
62
115
Off-the-shelf plug-in boards, primarily from Adafruit.
63
116
@@ -68,7 +121,7 @@ Off-the-shelf plug-in boards, primarily from Adafruit.
68
121
| 4754 | U6 | Adafruit Industries LLC | 2.54 mm pitch TH | 1 | BNO085 Module |
69
122
| 5708 | U7, U8 | Adafruit Industries LLC | 2.54 mm pitch TH | 2 | TJA1051T/3 Module |
70
123
71
- ### 1 .4 Breakout Connectors
124
+ # ## 2 .4 Breakout Connectors
72
125
73
126
Simple breakout connectors, driven fully or partially by firmware. See schematic
74
127
and firmware docs for details.
@@ -83,7 +136,9 @@ and firmware docs for details.
83
136
84
137
---
85
138
86
- ## 2 Development
139
+ # # 3 Development
140
+
141
+ # ## 3.1 Worflow
87
142
88
143
Developed using KiCad with KiBot GitHub Actions
89
144
workflow, [kibot.yaml](.github/workflows/kibot.yaml).
@@ -107,11 +162,32 @@ CI/CD objectives:
107
162
6. CAD.
108
163
- (` .step` ).
109
164
165
+ # ## 3.2 Submodules
166
+
167
+ This repository includes the submodule ` component_library` , located
168
+ at: [component_library](https://github.com/danielljeon/component_library).
169
+
170
+ When cloning the repository, make sure to use the recursive option:
171
+
172
+ ` ` ` shell
173
+ git clone --recursive
174
+ ` ` `
175
+
176
+ To update the submodule to its latest version in a cloned repository, use the
177
+ following command:
178
+
179
+ > Note: This is not recommended for this deprecated repository, as pulling
180
+ > updates from the submodule' s latest commit may result in incompatibilities.
181
+
182
+ ```shell
183
+ git submodule update --remote --merge
184
+ ```
185
+
110
186
---
111
187
112
- ## 3 Production History
188
+ ## 4 Production History
113
189
114
- ### 3 .1 v0.1.0-alpha-7b18788
190
+ ### 4 .1 v0.1.0-alpha-7b18788
115
191
116
192
Commit: [7b18788](https://github.com/danielljeon/nerve_ada_board/commit/7b187884c03f280627d8443d2d9cc163f4b6956e).
117
193
0 commit comments