blob: bd927a84af52a465f518d20ed833599828187e56 [file] [log] [blame]
Gyorgy Szingdb9783c2019-04-17 21:08:48 +02001###########################
2Musca-B1 Platform Specifics
3###########################
4
5****************
6DAPLink Firmware
7****************
Gabor Abonyi4aa39302022-07-14 16:33:13 +02008The code on Musca-B1 is running from embedded flash. Make sure that the DAPLink
Gyorgy Szingdb9783c2019-04-17 21:08:48 +02009FW for eFlash is downloaded to the board. You can find on the
Nicola Mazzucato9eadf7f2025-06-03 11:10:19 +010010`Arm Developer page <https://developer.arm.com/documentation/110409/0100/Musca-B1-firmware-update-and-boot-recovery>`__
Gyorgy Szingdb9783c2019-04-17 21:08:48 +020011A short description of how to update the DAPLink FW can be found there as well.
12
Minos Galanakisfc6804e2020-03-10 11:03:34 +000013.. Note::
14 Warm reset of eFlash is not supported on Musca_B1. TF-M may not boot after
15 a warm reset. Further information on the hardware limitation can be
Nicola Mazzucato9eadf7f2025-06-03 11:10:19 +010016 found on `Arm Developer page <https://developer.arm.com/documentation/110409/0100/Musca-B1-warm-reset-of-eFlash>`__.
Minos Galanakisfc6804e2020-03-10 11:03:34 +000017
Miklos Balintc7b1b6c2019-04-24 12:38:36 +020018********************
19Platform pin service
20********************
21
22This service is designed to perform secure pin services of the platform
23(e.g alternate function setting, pin mode setting, etc).
24The service uses the IOCTL API of TF-M's Platform Service, which allows the
25non-secure application to make pin service requests on Musca B1 based on a
26generic service request delivery mechanism.
27
Amjad Ouled-Ameur704cc762025-06-20 17:05:02 +010028********************
29Musca B1 Default CPU
30********************
31
32Musca B1 is a dual core platform (being based on the `SSE-200 subsystem <https://developer.arm.com/documentation/101104/0200/introduction/about-the-sse-200>`__),
33boot ROM code uses CPU0 running on 40.96MHz, while TF-M switches to CPU1 running on 163.84MHz.
34An additional benefit to switching the default core is that CPU1 can access SRAM3
35as Tightly Coupled Memory (TCM), while CPU0 can't.
36When the core switch happens, CPU0 sleeps in a WFI loop to save power.
37
38More information can be found in the following `patchset <https://review.trustedfirmware.org/c/TF-M/trusted-firmware-m/+/39616>`__.
39
Gyorgy Szingdb9783c2019-04-17 21:08:48 +020040--------------
41
Nicola Mazzucato9eadf7f2025-06-03 11:10:19 +010042*Copyright (c) 2017-2025, Arm Limited. All rights reserved.*