From 23b1d34b949db00724bb3b203968c340a948db4f Mon Sep 17 00:00:00 2001 From: Hays Chan <25737801+hayschan@users.noreply.github.com> Date: Mon, 2 Dec 2024 20:26:38 +0800 Subject: [PATCH 1/3] update OTA instructions for iOS with packet settings - Added detailed steps to enable "Packets Receipt Notification" in the nRF DFU app, which unlocks the ability to adjust the number of packets. - Improved troubleshooting section to include advice on reducing the number of packets to improve upload stability. - Clarified the upload process and estimated time for completion (around 10 minutes with ~1 kB/s upload speed). --- docs/getting-started/flashing-firmware/nrf52/ota.mdx | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs/getting-started/flashing-firmware/nrf52/ota.mdx b/docs/getting-started/flashing-firmware/nrf52/ota.mdx index 65211882..65426284 100644 --- a/docs/getting-started/flashing-firmware/nrf52/ota.mdx +++ b/docs/getting-started/flashing-firmware/nrf52/ota.mdx @@ -51,5 +51,16 @@ OTA firmware updates are available on iOS & iPadOS using the nRF Device Firmware 4. Connect to your device 5. Upload the firmware +If the upload fails, here are some tips based on common issues: + +1. **Ensure the correct app is used:** Double-check that you’ve downloaded the **nRF Device Firmware Update (nrF DFU)** app, not the nRF Connect app. +2. **Adjust packet settings:** In the app’s settings, the default number of packets is often set to 23. If you experience upload failures, follow these steps to adjust the packet size: + 1. Enable "**Packets Receipt Notification**" in the app settings. + 2. After enabling this, the "**Number of Packets**" setting will become active, allowing you to reduce it. Try changing the number of packets to **5**. + 3. Upload the firmware. Wait patiently. The upload speed is reported to be around 1 kB/s, so the process may take approximately 10 minutes to complete. + 4. If it still fails, reduce the value by one and retry the upload. + +*Note: Enabling "Packets Receipt Notification" is critical, as it unlocks the ability to modify the packet count. Reducing the packet size can significantly improve the upload stability and reduce the likelihood of failure.* + From 72c61e5503ee7a2593a31dd8b8bb21254568a693 Mon Sep 17 00:00:00 2001 From: Hays Chan <25737801+hayschan@users.noreply.github.com> Date: Tue, 3 Dec 2024 09:53:07 +0800 Subject: [PATCH 2/3] add reminder to prevent screen timeout during iOS OTA upload - Added note to temporarily set iPhone's auto-lock to "Never" to prevent the screen from turning off during the Bluetooth OTA firmware upload. --- docs/getting-started/flashing-firmware/nrf52/ota.mdx | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/getting-started/flashing-firmware/nrf52/ota.mdx b/docs/getting-started/flashing-firmware/nrf52/ota.mdx index 65426284..746845b4 100644 --- a/docs/getting-started/flashing-firmware/nrf52/ota.mdx +++ b/docs/getting-started/flashing-firmware/nrf52/ota.mdx @@ -59,6 +59,7 @@ If the upload fails, here are some tips based on common issues: 2. After enabling this, the "**Number of Packets**" setting will become active, allowing you to reduce it. Try changing the number of packets to **5**. 3. Upload the firmware. Wait patiently. The upload speed is reported to be around 1 kB/s, so the process may take approximately 10 minutes to complete. 4. If it still fails, reduce the value by one and retry the upload. +3. **Prevent screen timeout during upload**: The iPhone's auto-lock feature is often set to 30 seconds or 1 minute by default. When this happens, the screen will go black, and the phone may go to sleep, potentially interrupting the Bluetooth firmware upload. To avoid this, temporarily set the auto-lock to "Never" during the upload process to ensure that the phone stays awake and the upload completes without interruption. *Note: Enabling "Packets Receipt Notification" is critical, as it unlocks the ability to modify the packet count. Reducing the packet size can significantly improve the upload stability and reduce the likelihood of failure.* From 3a2820c44cb9de2939ce592f5d8c32ba9663ff6d Mon Sep 17 00:00:00 2001 From: Hays Chan <25737801+hayschan@users.noreply.github.com> Date: Tue, 3 Dec 2024 13:42:18 +0800 Subject: [PATCH 3/3] docs: remove redundant note about "Packets Receipt Notification" in iOS OTA instructions - Removed the duplicate note about enabling "Packets Receipt Notification" since it's already mentioned earlier in the troubleshooting steps. Co-authored-by: pdxlocations <117498748+pdxlocations@users.noreply.github.com> --- docs/getting-started/flashing-firmware/nrf52/ota.mdx | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/getting-started/flashing-firmware/nrf52/ota.mdx b/docs/getting-started/flashing-firmware/nrf52/ota.mdx index 746845b4..eee6df98 100644 --- a/docs/getting-started/flashing-firmware/nrf52/ota.mdx +++ b/docs/getting-started/flashing-firmware/nrf52/ota.mdx @@ -61,7 +61,6 @@ If the upload fails, here are some tips based on common issues: 4. If it still fails, reduce the value by one and retry the upload. 3. **Prevent screen timeout during upload**: The iPhone's auto-lock feature is often set to 30 seconds or 1 minute by default. When this happens, the screen will go black, and the phone may go to sleep, potentially interrupting the Bluetooth firmware upload. To avoid this, temporarily set the auto-lock to "Never" during the upload process to ensure that the phone stays awake and the upload completes without interruption. -*Note: Enabling "Packets Receipt Notification" is critical, as it unlocks the ability to modify the packet count. Reducing the packet size can significantly improve the upload stability and reduce the likelihood of failure.*