diff --git a/doc/guides/device_mgmt/mcumgr.rst b/doc/guides/device_mgmt/mcumgr.rst index 8d9c9332931e..2497b345a730 100644 --- a/doc/guides/device_mgmt/mcumgr.rst +++ b/doc/guides/device_mgmt/mcumgr.rst @@ -209,6 +209,20 @@ on Zephyr. The ones that are supported are described in the following table: :kconfig:`CONFIG_THREAD_STACK_INFO` and :kconfig:`CONFIG_INIT_STACKS` options must be set. +.. _mcumgr_jlink_ob_virtual_msd: + +J-Link Virtual MSD Interaction Note +*********************************** + +On boards where a J-Link OB is present which has both CDC and MSC (virtual Mass +Storage Device, also known as drag-and-drop) support, the MSD functionality can +prevent mcumgr commands over the CDC UART port from working due to how USB +endpoints are configured in the J-Link firmware (for example on the Nordic +``nrf52840dk``) because of limiting the maximum packet size (most likely to occur +when using image management commands for updating firmware). This issue can be +resolved by disabling MSD functionality on the J-Link device, follow the +instructions on :ref:`nordic_segger_msd` to disable MSD support. + .. _image_mgmt: Image Management diff --git a/samples/subsys/mgmt/mcumgr/smp_svr/README.rst b/samples/subsys/mgmt/mcumgr/smp_svr/README.rst index 2c9ebcf3004e..c610504a5c00 100644 --- a/samples/subsys/mgmt/mcumgr/smp_svr/README.rst +++ b/samples/subsys/mgmt/mcumgr/smp_svr/README.rst @@ -246,6 +246,18 @@ send a string to the remote target device and have it echo it back: In the following sections, examples will use ```` to represent the ``--conntype `` and ``--connstring=`` :file:`mcumgr` parameters. +J-Link Virtual MSD Interaction Note +*********************************** + +On boards where a J-Link OB is present which has both CDC and MSC (virtual Mass +Storage Device, also known as drag-and-drop) support, the MSD functionality can +prevent mcumgr commands over the CDC UART port from working due to how USB +endpoints are configured in the J-Link firmware (for example on the Nordic +``nrf52840dk``) because of limiting the maximum packet size (most likely to occur +when using image management commands for updating firmware). This issue can be +resolved by disabling MSD functionality on the J-Link device, follow the +instructions on :ref:`nordic_segger_msd` to disable MSD support. + Device Firmware Upgrade (DFU) *****************************