doc: update nrf5 migration guide

b-gent · eivindj-nordic · commit 0999c80b373c · 2025-09-05T12:30:23.000+02:00
Add section for SoftDevice and update the DFU part.

Signed-off-by: Bartosz Gentkowski &lt;bartosz.gentkowski@nordicsemi.no&gt;
diff --git a/doc/nrf-bm/images/nrf5_bm_memory_part.svg b/doc/nrf-bm/images/nrf5_bm_memory_part.svg
@@ -0,0 +1,182 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<!-- Generated by Microsoft Visio, SVG Export nrf5_bm_memory_part.svg Page-1 -->
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:ev="http://www.w3.org/2001/xml-events"
+		xmlns:v="http://schemas.microsoft.com/visio/2003/SVGExtensions/" width="5.34159in" height="6.1457in"
+		viewBox="0 0 384.594 442.491" xml:space="preserve" color-interpolation-filters="sRGB" class="st14">
+	<v:documentProperties v:langID="1033" v:viewMarkup="false"/>
+
+	<style type="text/css">
+	<![CDATA[
+		.st1 {fill:#0f4861;stroke:#0d4964;stroke-width:0.25}
+		.st2 {fill:#feffff;font-family:Calibri;font-size:0.75em}
+		.st3 {font-size:1em}
+		.st4 {fill:#11b0ee;stroke:#0d4964;stroke-width:0.25}
+		.st5 {fill:#085878;stroke:#0d4964;stroke-width:0.25}
+		.st6 {fill:#83caeb;stroke:#0d4964;stroke-width:0.25}
+		.st7 {fill:#ffc000;stroke:#0d4964;stroke-width:0.25}
+		.st8 {fill:none;stroke:none;stroke-width:0.25}
+		.st9 {fill:#0d4964;font-family:Calibri;font-size:0.499992em}
+		.st10 {fill:#feffff;font-family:Calibri;font-size:0.666664em}
+		.st11 {fill:url(#ptrn10-57);shape-rendering:crispEdges;stroke:#0d4964;stroke-width:0.25}
+		.st12 {fill:#000000;font-family:Calibri;font-size:0.75em}
+		.st13 {fill:#0d4964;font-family:Calibri;font-size:1.00001em}
+		.st14 {fill:none;fill-rule:evenodd;font-size:12px;overflow:visible;stroke-linecap:square;stroke-miterlimit:3}
+	]]>
+	</style>
+
+	<defs id="Patterns_And_Gradients">
+		<pattern id="ptrn10-57" v:fillPattern="10" v:foreground="#085878" v:background="#ffffff" patternUnits="userSpaceOnUse"
+				width="6" height="6" viewBox="0 0 64 64">
+			<image x="0" y="0" width="64" height="64" image-rendering="optimizeSpeed"
+					xlink:href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAgAAAAICAYAAADED76LAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAAEnQAABJ0Ad5mH3gAAAAdSURBVChTY+CIqPiPDND5DLgkYHwGXBIwMCRMAAB1n9yxyvIxswAAAABJRU5ErkJggg=="/>
+		</pattern>
+	</defs>
+	<g v:mID="0" v:index="1" v:groupContext="foregroundPage">
+		<title>Page-1</title>
+		<v:pageProperties v:drawingScale="0.0393701" v:pageScale="0.0393701" v:drawingUnits="24" v:shadowOffsetX="8.50394"
+				v:shadowOffsetY="-8.50394"/>
+		<g id="shape1000-1" v:mID="1000" v:groupContext="shape" transform="translate(278.045,-0.25)">
+			<title>Sheet.1000</title>
+			<desc>mcuBoot (IRoT)</desc>
+			<v:textBlock v:margins="rect(4,4,4,4)" v:tabSpace="42.5197"/>
+			<v:textRect cx="52.4409" cy="421.231" width="104.89" height="42.5197"/>
+			<rect x="0" y="399.971" width="104.882" height="42.5197" class="st1"/>
+			<text x="35.88" y="418.53" class="st2" v:langID="1044"><v:paragraph v:horizAlign="1"/><v:tabList/>mcuBoot<v:newlineChar/><tspan
+						x="41.57" dy="1.2em" class="st3">(IRoT)</tspan></text>		</g>
+		<g id="shape1001-5" v:mID="1001" v:groupContext="shape" transform="translate(278.045,-57.5098)">
+			<title>Sheet.1001</title>
+			<desc>Application</desc>
+			<v:textBlock v:margins="rect(4,4,4,4)" v:tabSpace="42.5197" v:verticalAlign="0"/>
+			<v:textRect cx="52.4409" cy="351.782" width="104.89" height="181.417"/>
+			<rect x="0" y="261.073" width="104.882" height="181.417" class="st4"/>
+			<text x="31.71" y="348.77" class="st2" v:langID="1044"><v:paragraph v:horizAlign="1"/><v:tabList/><v:newlineChar/><v:newlineChar/><v:newlineChar/><v:newlineChar/><v:newlineChar/><v:newlineChar/><v:newlineChar/>Application<v:newlineChar/></text>		</g>
+		<g id="shape1002-8" v:mID="1002" v:groupContext="shape" transform="translate(278.045,-239.778)">
+			<title>Sheet.1002</title>
+			<desc>Firmware loader without Bluetooth LE</desc>
+			<v:textBlock v:margins="rect(4,4,4,4)" v:tabSpace="42.5197"/>
+			<v:textRect cx="52.4409" cy="414.144" width="104.89" height="56.6929"/>
+			<rect x="0" y="385.798" width="104.882" height="56.6929" class="st5"/>
+			<text x="6.86" y="411.44" class="st2" v:langID="1044"><v:paragraph v:horizAlign="1"/><v:tabList/>F<tspan class="st3"
+						v:langID="1045">irmware</tspan> <tspan class="st3" v:langID="1045">l</tspan>oader <tspan class="st3"
+						v:langID="1045">without<v:newlineChar/></tspan><tspan x="29.13" dy="1.2em" class="st3" v:langID="1045">Bluetooth LE</tspan></text>		</g>
+		<g id="shape1003-15" v:mID="1003" v:groupContext="shape" transform="translate(278.045,-297.321)">
+			<title>Sheet.1003</title>
+			<desc>SoftDevice</desc>
+			<v:textBlock v:margins="rect(4,4,4,4)" v:tabSpace="42.5197" v:verticalAlign="0"/>
+			<v:textRect cx="52.4409" cy="397.136" width="104.89" height="90.7087"/>
+			<rect x="0" y="351.782" width="104.882" height="90.7087" class="st6"/>
+			<text x="32.91" y="363.88" class="st2" v:langID="1044"><v:paragraph v:horizAlign="1"/><v:tabList/>SoftDevice</text>		</g>
+		<g id="shape1004-18" v:mID="1004" v:groupContext="shape" transform="translate(278.045,-388.88)">
+			<title>Sheet.1004</title>
+			<desc>Layout metadata</desc>
+			<v:textBlock v:margins="rect(4,4,4,4)" v:tabSpace="42.5197"/>
+			<v:textRect cx="52.4409" cy="438.31" width="104.89" height="8.36219"/>
+			<rect x="0" y="434.128" width="104.882" height="8.36219" class="st7"/>
+			<text x="21.42" y="441.01" class="st2" v:langID="1044"><v:paragraph v:horizAlign="1"/><v:tabList/>Layout <tspan
+						class="st3" v:langID="1045">m</tspan>etadata</text>		</g>
+		<g id="shape1005-22" v:mID="1005" v:groupContext="shape" transform="translate(236.943,-0.958663)">
+			<title>Sheet.1005</title>
+			<desc>0x0000</desc>
+			<v:textBlock v:margins="rect(4,4,4,4)" v:tabSpace="42.5197"/>
+			<v:textRect cx="19.4882" cy="438.239" width="38.98" height="8.50394"/>
+			<rect x="0" y="433.987" width="38.9764" height="8.50394" class="st8"/>
+			<text x="17.17" y="440.04" class="st9" v:langID="1044"><v:paragraph v:horizAlign="2"/><v:tabList/>0x0000</text>		</g>
+		<g id="shape1006-25" v:mID="1006" v:groupContext="shape" transform="translate(278.045,-43.5492)">
+			<title>Sheet.1006</title>
+			<desc>Storage (optional)</desc>
+			<v:textBlock v:margins="rect(4,4,4,4)" v:tabSpace="42.5197"/>
+			<v:textRect cx="52.4409" cy="435.794" width="104.89" height="13.3937"/>
+			<rect x="0" y="429.097" width="104.882" height="13.3937" class="st7"/>
+			<text x="19.46" y="438.49" class="st2" v:langID="1044"><v:paragraph v:horizAlign="1"/><v:tabList/>Storage (optional)</text>		</g>
+		<g id="shape1007-28" v:mID="1007" v:groupContext="shape" transform="translate(41.3524,-0.25)">
+			<title>Sheet.1007</title>
+			<desc>MBR</desc>
+			<v:textBlock v:margins="rect(4,4,4,4)" v:tabSpace="42.5197"/>
+			<v:textRect cx="52.4409" cy="435.794" width="104.89" height="13.3937"/>
+			<rect x="0" y="429.097" width="104.882" height="13.3937" class="st1"/>
+			<text x="44.67" y="438.19" class="st10" v:langID="1044"><v:paragraph v:horizAlign="1"/><v:tabList/>MBR</text>		</g>
+		<g id="shape1008-31" v:mID="1008" v:groupContext="shape" transform="translate(41.3524,-102.297)">
+			<title>Sheet.1008</title>
+			<desc>Application</desc>
+			<v:textBlock v:margins="rect(4,4,4,4)" v:tabSpace="42.5197" v:verticalAlign="0"/>
+			<v:textRect cx="52.4409" cy="339.026" width="104.89" height="206.929"/>
+			<rect x="0" y="235.562" width="104.882" height="206.929" class="st4"/>
+			<text x="31.71" y="323.26" class="st2" v:langID="1044"><v:paragraph v:horizAlign="1"/><v:tabList/><v:newlineChar/><v:newlineChar/><v:newlineChar/><v:newlineChar/><v:newlineChar/><v:newlineChar/><v:newlineChar/>Application<v:newlineChar/></text>		</g>
+		<g id="shape1009-34" v:mID="1009" v:groupContext="shape" transform="translate(41.3524,-13.8563)">
+			<title>Sheet.1009</title>
+			<desc>SoftDevice</desc>
+			<v:textBlock v:margins="rect(4,4,4,4)" v:tabSpace="42.5197" v:verticalAlign="0"/>
+			<v:textRect cx="52.4409" cy="397.136" width="104.89" height="90.7087"/>
+			<rect x="0" y="351.782" width="104.882" height="90.7087" class="st6"/>
+			<text x="32.91" y="363.88" class="st2" v:langID="1044"><v:paragraph v:horizAlign="1"/><v:tabList/>SoftDevice</text>		</g>
+		<g id="shape1010-37" v:mID="1010" v:groupContext="shape" transform="translate(41.3524,-380.093)">
+			<title>Sheet.1010</title>
+			<desc>MBR parameter storage</desc>
+			<v:textBlock v:margins="rect(4,4,4,4)" v:tabSpace="42.5197"/>
+			<v:textRect cx="52.4409" cy="438.31" width="104.89" height="8.36219"/>
+			<rect x="0" y="434.128" width="104.882" height="8.36219" class="st7"/>
+			<text x="8.55" y="441.01" class="st2" v:langID="1044"><v:paragraph v:horizAlign="1"/><v:tabList/>MBR parameter storage</text>		</g>
+		<g id="shape1011-40" v:mID="1011" v:groupContext="shape" transform="translate(0.25,-0.958663)">
+			<title>Sheet.1011</title>
+			<desc>0x0000</desc>
+			<v:textBlock v:margins="rect(4,4,4,4)" v:tabSpace="42.5197"/>
+			<v:textRect cx="19.4882" cy="438.239" width="38.98" height="8.50394"/>
+			<rect x="0" y="433.987" width="38.9764" height="8.50394" class="st8"/>
+			<text x="17.17" y="440.04" class="st9" v:langID="1044"><v:paragraph v:horizAlign="2"/><v:tabList/>0x0000</text>		</g>
+		<g id="shape1012-43" v:mID="1012" v:groupContext="shape" transform="translate(41.3524,-310.006)">
+			<title>Sheet.1012</title>
+			<desc>Application data</desc>
+			<v:textBlock v:margins="rect(4,4,4,4)" v:tabSpace="42.5197"/>
+			<v:textRect cx="52.4409" cy="435.794" width="104.89" height="13.3937"/>
+			<rect x="0" y="429.097" width="104.882" height="13.3937" class="st7"/>
+			<text x="22.51" y="438.49" class="st2" v:langID="1044"><v:paragraph v:horizAlign="1"/><v:tabList/>Application <tspan
+						class="st3" v:langID="1045">d</tspan>ata</text>		</g>
+		<g id="shape1013-47" v:mID="1013" v:groupContext="shape" transform="translate(41.3524,-323.4)">
+			<title>Sheet.1013</title>
+			<desc>Bootloader</desc>
+			<v:textBlock v:margins="rect(4,4,4,4)" v:tabSpace="42.5197"/>
+			<v:textRect cx="52.4409" cy="414.144" width="104.89" height="56.6929"/>
+			<rect x="0" y="385.798" width="104.882" height="56.6929" class="st5"/>
+			<text x="32.01" y="416.84" class="st2" v:langID="1044"><v:paragraph v:horizAlign="1"/><v:tabList/>Bootloader</text>		</g>
+		<g id="shape1014-50" v:mID="1014" v:groupContext="shape" transform="translate(41.3524,-388.667)">
+			<title>Sheet.1014</title>
+			<desc>Bootloader settings</desc>
+			<v:textBlock v:margins="rect(4,4,4,4)" v:tabSpace="42.5197"/>
+			<v:textRect cx="52.4409" cy="438.31" width="104.89" height="8.36219"/>
+			<rect x="0" y="434.128" width="104.882" height="8.36219" class="st7"/>
+			<text x="16.7" y="441.01" class="st2" v:langID="1044"><v:paragraph v:horizAlign="1"/><v:tabList/>Bootloader setting<tspan
+						class="st3" v:langID="1045">s</tspan></text>		</g>
+		<g id="shape1015-54" v:mID="1015" v:groupContext="shape" transform="translate(41.3524,-253.313)">
+			<title>Sheet.1015</title>
+			<desc>Free</desc>
+			<v:textBlock v:margins="rect(4,4,4,4)" v:tabSpace="42.5197"/>
+			<v:textRect cx="52.4409" cy="414.144" width="104.89" height="56.6929"/>
+			<rect x="0" y="385.798" width="104.882" height="56.6929" class="st11"/>
+			<text x="44.33" y="416.84" class="st12" v:langID="1044"><v:paragraph v:horizAlign="1"/><v:tabList/>Free</text>		</g>
+		<g id="shape1016-59" v:mID="1016" v:groupContext="shape" transform="translate(278.045,-182.234)">
+			<title>Sheet.1016</title>
+			<desc>Free</desc>
+			<v:textBlock v:margins="rect(4,4,4,4)" v:tabSpace="42.5197"/>
+			<v:textRect cx="52.4409" cy="414.144" width="104.89" height="56.6929"/>
+			<rect x="0" y="385.798" width="104.882" height="56.6929" class="st11"/>
+			<text x="44.33" y="416.84" class="st12" v:langID="1044"><v:paragraph v:horizAlign="1"/><v:tabList/>Free</text>		</g>
+		<g id="shape1017-63" v:mID="1017" v:groupContext="shape" transform="translate(274.532,-399.721)">
+			<title>Sheet.1017</title>
+			<desc>Bare Metal memory partitioning</desc>
+			<v:textBlock v:margins="rect(4,4,4,4)" v:tabSpace="42.5197"/>
+			<v:textRect cx="54.9061" cy="421.231" width="109.82" height="42.5197"/>
+			<rect x="0" y="399.971" width="109.812" height="42.5197" class="st8"/>
+			<text x="27.96" y="417.63" class="st13" v:langID="2057"><v:paragraph v:horizAlign="1"/><v:tabList/>Bare Metal <v:newlineChar/><tspan
+						x="4.44" dy="1.2em" class="st3">memory partition</tspan><tspan class="st3" v:langID="1045">ing</tspan></text>		</g>
+		<g id="shape1018-68" v:mID="1018" v:groupContext="shape" transform="translate(39.935,-399.721)">
+			<title>Sheet.1018</title>
+			<desc>nRF5 memory partitioning</desc>
+			<v:textBlock v:margins="rect(4,4,4,4)" v:tabSpace="42.5197"/>
+			<v:textRect cx="54.9061" cy="421.231" width="109.82" height="42.5197"/>
+			<rect x="0" y="399.971" width="109.812" height="42.5197" class="st8"/>
+			<text x="42.7" y="417.63" class="st13" v:langID="1044"><v:paragraph v:horizAlign="1"/><v:tabList/>nRF5<tspan
+						class="st3" v:langID="2057"> </tspan><tspan x="4.44" dy="1.2em" class="st3" v:langID="2057">memory partition</tspan><tspan
+						class="st3" v:langID="1045">ing</tspan></text>		</g>
+	</g>
+</svg>
diff --git a/doc/nrf-bm/links.txt b/doc/nrf-bm/links.txt
@@ -77,3 +77,5 @@
 .. _`nrfx migration guides`: https://github.com/NordicSemiconductor/nrfx/wiki/nrfx-2.11.0-to-3.0.0
 .. _`Migration notes - nRF5 SDK to nRF Connect SDK Bare Metal option`: https://docs.nordicsemi.com/bundle/nrf-bm-latest/page/migration/nrf5_bm_migration.html
 .. _`S115 9.0.0-3.prototype API reference`: https://docs.nordicsemi.com/bundle/s115_9.0.0-3.prototype_api/page/topics.html
+.. _`nRF5 SDK DFU memory layout`: https://docs.nordicsemi.com/bundle/sdk_nrf5_v17.1.0/page/lib_bootloader.html
+.. _`MCUmgr SMP protocol`: https://docs.zephyrproject.org/latest/services/device_mgmt/smp_protocol.html
diff --git a/doc/nrf-bm/migration/nrf5_bm_migration.rst b/doc/nrf-bm/migration/nrf5_bm_migration.rst
