Skip to content

Commit 424f5fe

Browse files
authored
add case where no west workspace initialized to readme (#2975)
2 parents 9c12965 + 2fd8a2c commit 424f5fe

1 file changed

Lines changed: 37 additions & 3 deletions

File tree

omi/firmware/BUILD_AND_OTA_FLASH.md

Lines changed: 37 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -91,16 +91,33 @@ WEST_PYTHON="/opt/homebrew/Cellar/west/1.4.0/libexec/bin/python"
9191
$WEST_PYTHON -m pip install cryptography intelhex ecdsa click cbor2
9292
```
9393

94-
### 3. Prepare the Workspace
94+
### 3. Initialize the nRF Connect SDK Workspace
95+
96+
If the `v2.9.0` directory doesn't exist or is empty, you need to initialize the nRF Connect SDK workspace:
9597

9698
```bash
9799
# Navigate to the firmware directory
98-
cd /path/to/omi/firmware/v2.9.0
100+
cd /path/to/omi/firmware
101+
102+
# Create and navigate to the v2.9.0 directory
103+
mkdir -p v2.9.0
104+
cd v2.9.0
105+
106+
# Initialize nRF Connect SDK v2.9.0 workspace
107+
west init -m https://github.com/nrfconnect/sdk-nrf --mr v2.9.0
99108

100-
# Update West workspace (if needed)
109+
# Download all required repositories (this may take several minutes)
101110
west update
102111
```
103112

113+
**Note**: The `west update` command downloads approximately 1.5GB of source code including:
114+
- Zephyr RTOS
115+
- nRF Connect SDK modules
116+
- MCUboot bootloader
117+
- Various libraries and tools
118+
119+
If the workspace already exists and is properly configured, you can skip to step 4.
120+
104121
## Building the Firmware
105122

106123
### 1. Prepare Configuration Files
@@ -226,6 +243,23 @@ cd ../omi
226243
cp omi.conf prj.conf
227244
```
228245

246+
#### Workspace Issues
247+
```bash
248+
# Error: No such file or directory: v2.9.0
249+
# Initialize the workspace first:
250+
cd /path/to/omi/firmware
251+
mkdir -p v2.9.0 && cd v2.9.0
252+
west init -m https://github.com/nrfconnect/sdk-nrf --mr v2.9.0
253+
west update
254+
255+
# Error: already initialized in /path/to/omi/firmware
256+
# Remove broken workspace and reinitialize:
257+
rm -rf .west
258+
cd v2.9.0
259+
west init -m https://github.com/nrfconnect/sdk-nrf --mr v2.9.0
260+
west update
261+
```
262+
229263
### OTA Flashing Issues
230264

231265
#### Device Not Found

0 commit comments

Comments
 (0)