[Urgent] Looking For Description of STM32MP157F-DK2 HAL and low-layer drivers PDF

[purushotham2608]

Hello all, good day I hope your Christmas season is going well. I'm looking for a pdf document equivalent of the PDF that is attached to this post that gives description for STM32MP157F-DK2 HAL and low-layer drivers or a HAL API Manual/Programming manual to program our STM32MP157F-DK2 board using STM32CubeIDE. I tried searching the internet for anything of the sort but I couldn't find anything for my STM32MP157F-DK2 board please provide kind support as soon as possible thank you best regards.

[TDK]

Duplicate:

https://community.st.com/t5/stm32cubeide-mpus/looking-for-description-of-stm32mp157f-dk2-hal-and-low-layer/td-p/623140

 

[TDK]

 

If what you're looking for doesn't exist on the project page, and it doesn't show up in a google search, it probably doesn't exist. The code is open source, you can use that as the documentation.

https://www.st.com/en/embedded-software/stm32cubemp1.html#tools-software

 

[purushotham2608]

Dear Sir/Madam, Thank you for your kind reply. How are we supposed to program the board without the documentation of the HAL API in STM32CubeIDE? I watched a Digikey tutorial series on STM32 they said to search for the HAL API Documentation for your board to program the STM32 Board https://www.youtube.com/watch?v=hyZS2p1tW-g&list=PLEBQazB0HUyRYuzfi4clXsKUSgorErmBv it seems very important as it details all the HAL functions that we can use when programming. We have also searched the link you have provided for the documentation however we could not find anything on the HAL API. Please provide kind support thank you best regards.

[TDK]

I don't know. If you need a PDF and can't go off of the code and function definitions within the code, maybe programming this chip isn't for you.

The HAL stuff is more targeted for MCUs, not MPUs. That video is for MCUs.

[PatrickF]

Hi @purushotham2608 

I'm afraid the document you are asking for does not exist for STM32MP1 products.

Note: the DK2 is a board and there is only HW documentation https://www.st.com/en/evaluation-tools/stm32mp157f-dk2.html.

The STM32MP15x devices (which is the processor of the DK2 board) are intended to run Linux on Cortex-A7 and bare-metal SW on Cortex-M4 (using STM32CubeMP1 HAL). Cortex-M4 is seen as a coprocessor of Linux subsystem (e.g. to manage real time activities).

Regarding STM32CubeMP1, some information is listed here: https://www.st.com/en/embedded-software/stm32cubemp1.html

Getting started is in wiki: https://wiki.st.com/stm32mpu/wiki/Getting_started/STM32MP1_boards/STM32MP157x-DK2/Develop_on_Arm%C2%AE_Cortex%C2%AE-M4

Within STM32CubeMP1 package, you will have many examples and application you could refer to.

https://wiki.st.com/stm32mpu/wiki/STM32CubeMP15_Package_release_note_-_v1.6.0

Then, full information and details about using HAL fonctions are inside the 'C' code as comments.

Regards.

[Olivier GALLIEN]

Hi @purushotham2608 ,

The HAL user manual is provided in the Cube Firmware package under STM32Cube_FW_MP1_V1.6.0\Drivers\STM32MP1xx_HAL_Driver\STM32MP157Cxx_CM4_User_Manual.chm

Let us know if it fit your expectation. 

Olivier 

 

 

[purushotham2608]

Dear Sir/Madam, Good day thank you for your kind reply. Is this the equivalent/something similar of the PDF attached to this reply? Can we use this as an alternative for this PDF for our board? 

[Olivier GALLIEN]

Hi @purushotham2608 ,

This is not equivalent since the .chm is an automatic generated documentation from code. It does contain not "human" made educational section as you can have in the .pdf. 

Anyway, it document the same way all API functions : 

eg USART_Init 

.chm 

 

.pdf

 

Note that most of generic "learning" chapter in the L4 pdf are likely applicable to STM32MP1 M4. 

Differences to be cross-checked using .chm and code itself. 

This is all we can provide as generic documentation. If you are still stuck finding some information, please be more specific in a dedicated post. 

Olivier 

[purushotham2608]

Dear Sir/Madam, Good day, Thank you for your kind reply once again, As long as we can use this documentation to program our board and it lists all the functions that we can use to program this board we will be satisfied (such as using this documentation to learn how to turn on an LED as an example).

[Olivier GALLIEN]

Hi @purushotham2608 ,

Sure the document is valid. Since C and F means : 

C = Secure boot, cryptography hardware, 650 MHz
F = Secure boot, cryptography hardware, 800 MHz

I advise you to read the Datasheet Datasheet - STM32MP157C/F - Arm<Sup>®</Sup> dual Cortex<Sup>®</Sup>-A7 800 MHz + Cortex<Sup>®</Sup>-M4 MPU, 3D GPU, TFT/DSI, 37 comm. interfaces, 29 timers, adv. analog, crypto and some introduction to the product on st.com and wiki. 

Olivier 

 

[purushotham2608]

Dear Sir/Madam, Good day. Thank you for confirming thanks to that information I believe this is what I have been looking for.  For more information, We don't plan to use Linux for this board we plan to program the board entirely in C language using STM32CUBEIDE. Thank You everyone for your kind support.

[Olivier GALLIEN]

Hi @purushotham2608 ,

Be aware that ST does not provide any support for a "bare" HAL implementation on the STM32MP15x. We only provide ecosystem for Linux on A7. 

You can't, and it make no sense, to make a product using only the M4. 

If you are interested in an MPU with HAL support, I recommend you to rather use the STM32MP13 which is delivered with complete ecosystem for HAL support. 

See STM32CubeMP13 Package release note - v1.0.0 - stm32mpu 

Olivier