Skip to content
This repository was archived by the owner on Jan 3, 2025. It is now read-only.

Commit 0c26b80

Browse files
committed
Update README.md for v0.1.0-beta
1 parent fb2d769 commit 0c26b80

File tree

1 file changed

+92
-16
lines changed

1 file changed

+92
-16
lines changed

README.md

+92-16
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,15 @@
44

55
Nerve dev board using off-the-shelf modules.
66

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+
716
![nerve_ada_board.png](docs/nerve_ada_board.png)
817
918
---
@@ -13,26 +22,70 @@ Nerve dev board using off-the-shelf modules.
1322
1423
<!-- TOC -->
1524
* [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)
2440
<!-- TOC -->
2541
2642
</details>
2743
2844
---
2945
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
3184
3285
Development board for the STM32
3386
based [nerve](https://github.com/danielljeon/nerve) controller firmware.
3487
35-
### 1.1 Function Connectors
88+
### 2.1 Function Connectors
3689
3790
These connectors are fixed by hardware (PCB traces or the connector itself).
3891
@@ -45,7 +98,7 @@ These connectors are fixed by hardware (PCB traces or the connector itself).
4598
| CAN1 (Transceiver U7) | J7 | Pin 1: CAN1 High, Pin 2: CAN1 Low |
4699
| CAN2 (Transceiver U8) | J8 | Pin 1: CAN2 High, Pin 2: CAN2 Low |
47100
48-
### 1.2 Switches & Jumpers
101+
### 2.2 Switches & Jumpers
49102
50103
User controllable hardware and/or firmware driven inputs.
51104
@@ -57,7 +110,7 @@ User controllable hardware and/or firmware driven inputs.
57110
| SDIO Card Detect Jumper | J4 | Close for card inserted (pull-down on close) |
58111
| BOOT0 Jumper | J5 | Open for run flash memory (pull-down on open) |
59112
60-
### 1.3 Plug-in Modules
113+
### 2.3 Plug-in Modules
61114
62115
Off-the-shelf plug-in boards, primarily from Adafruit.
63116
@@ -68,7 +121,7 @@ Off-the-shelf plug-in boards, primarily from Adafruit.
68121
| 4754 | U6 | Adafruit Industries LLC | 2.54 mm pitch TH | 1 | BNO085 Module |
69122
| 5708 | U7, U8 | Adafruit Industries LLC | 2.54 mm pitch TH | 2 | TJA1051T/3 Module |
70123
71-
### 1.4 Breakout Connectors
124+
### 2.4 Breakout Connectors
72125
73126
Simple breakout connectors, driven fully or partially by firmware. See schematic
74127
and firmware docs for details.
@@ -83,7 +136,9 @@ and firmware docs for details.
83136
84137
---
85138
86-
## 2 Development
139+
## 3 Development
140+
141+
### 3.1 Worflow
87142
88143
Developed using KiCad with KiBot GitHub Actions
89144
workflow, [kibot.yaml](.github/workflows/kibot.yaml).
@@ -107,11 +162,32 @@ CI/CD objectives:
107162
6. CAD.
108163
- (`.step`).
109164
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+
110186
---
111187
112-
## 3 Production History
188+
## 4 Production History
113189
114-
### 3.1 v0.1.0-alpha-7b18788
190+
### 4.1 v0.1.0-alpha-7b18788
115191
116192
Commit: [7b18788](https://github.com/danielljeon/nerve_ada_board/commit/7b187884c03f280627d8443d2d9cc163f4b6956e).
117193

0 commit comments

Comments
 (0)