Using HAL in Stm32 arduino IDE (Cube generated)

Post here all questions related to STM32 core if you can't find a relevant section!
Post Reply
FarhanKhosravi
Posts: 3
Joined: Sun May 01, 2022 12:24 pm

Using HAL in Stm32 arduino IDE (Cube generated)

Post by FarhanKhosravi »

Hi there
I'm using on a project that needs few arduino libraries, and unfortunately they're missing for cube IDE...
on the other hand, STM32 Core for arduino is heavily bloated and my code runs very slow, specially ADC is super slow

So I wanted to do all of my Configurations and pin settings in Cube (MX or IDE) and then input generated code in Arduino IDE... which seems very difficult.
(But this will help a lot of users, if it works)

There is two Questions:
1. this is Cube generated code for using ADC and DMA with my desired options and speed, etc:

Code: Select all

/* USER CODE BEGIN Header */
/**
  ******************************************************************************
  * @file           : main.c
  * @brief          : Main program body
  ******************************************************************************
  * @attention
  *
  * Copyright (c) 2024 STMicroelectronics.
  * All rights reserved.
  *
  * This software is licensed under terms that can be found in the LICENSE file
  * in the root directory of this software component.
  * If no LICENSE file comes with this software, it is provided AS-IS.
  *
  ******************************************************************************
  */
/* USER CODE END Header */
/* Includes ------------------------------------------------------------------*/
#include "main.h"

/* Private includes ----------------------------------------------------------*/
/* USER CODE BEGIN Includes */

/* USER CODE END Includes */

/* Private typedef -----------------------------------------------------------*/
/* USER CODE BEGIN PTD */

/* USER CODE END PTD */

/* Private define ------------------------------------------------------------*/
/* USER CODE BEGIN PD */

/* USER CODE END PD */

/* Private macro -------------------------------------------------------------*/
/* USER CODE BEGIN PM */

/* USER CODE END PM */

/* Private variables ---------------------------------------------------------*/
ADC_HandleTypeDef hadc1;
DMA_HandleTypeDef hdma_adc1;

/* USER CODE BEGIN PV */

/* USER CODE END PV */

/* Private function prototypes -----------------------------------------------*/
void SystemClock_Config(void);
static void MX_GPIO_Init(void);
static void MX_DMA_Init(void);
static void MX_ADC1_Init(void);
/* USER CODE BEGIN PFP */

/* USER CODE END PFP */

/* Private user code ---------------------------------------------------------*/
/* USER CODE BEGIN 0 */

/* USER CODE END 0 */

/**
  * @brief  The application entry point.
  * @retval int
  */
int main(void)
{

  /* USER CODE BEGIN 1 */

  /* USER CODE END 1 */

  /* MCU Configuration--------------------------------------------------------*/

  /* Reset of all peripherals, Initializes the Flash interface and the Systick. */
  HAL_Init();

  /* USER CODE BEGIN Init */

  /* USER CODE END Init */

  /* Configure the system clock */
  SystemClock_Config();

  /* USER CODE BEGIN SysInit */

  /* USER CODE END SysInit */

  /* Initialize all configured peripherals */
  MX_GPIO_Init();
  MX_DMA_Init();
  MX_ADC1_Init();
  /* USER CODE BEGIN 2 */

  /* USER CODE END 2 */

  /* Infinite loop */
  /* USER CODE BEGIN WHILE */
  while (1)
  {
    /* USER CODE END WHILE */

    /* USER CODE BEGIN 3 */
  }
  /* USER CODE END 3 */
}

/**
  * @brief System Clock Configuration
  * @retval None
  */
void SystemClock_Config(void)
{
  RCC_OscInitTypeDef RCC_OscInitStruct = {0};
  RCC_ClkInitTypeDef RCC_ClkInitStruct = {0};

  /** Configure the main internal regulator output voltage
  */
  __HAL_RCC_PWR_CLK_ENABLE();
  __HAL_PWR_VOLTAGESCALING_CONFIG(PWR_REGULATOR_VOLTAGE_SCALE1);

  /** Initializes the RCC Oscillators according to the specified parameters
  * in the RCC_OscInitTypeDef structure.
  */
  RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSE;
  RCC_OscInitStruct.HSEState = RCC_HSE_ON;
  RCC_OscInitStruct.PLL.PLLState = RCC_PLL_ON;
  RCC_OscInitStruct.PLL.PLLSource = RCC_PLLSOURCE_HSE;
  RCC_OscInitStruct.PLL.PLLM = 12;
  RCC_OscInitStruct.PLL.PLLN = 96;
  RCC_OscInitStruct.PLL.PLLP = RCC_PLLP_DIV2;
  RCC_OscInitStruct.PLL.PLLQ = 4;
  if (HAL_RCC_OscConfig(&RCC_OscInitStruct) != HAL_OK)
  {
    Error_Handler();
  }

  /** Initializes the CPU, AHB and APB buses clocks
  */
  RCC_ClkInitStruct.ClockType = RCC_CLOCKTYPE_HCLK|RCC_CLOCKTYPE_SYSCLK
                              |RCC_CLOCKTYPE_PCLK1|RCC_CLOCKTYPE_PCLK2;
  RCC_ClkInitStruct.SYSCLKSource = RCC_SYSCLKSOURCE_PLLCLK;
  RCC_ClkInitStruct.AHBCLKDivider = RCC_SYSCLK_DIV1;
  RCC_ClkInitStruct.APB1CLKDivider = RCC_HCLK_DIV2;
  RCC_ClkInitStruct.APB2CLKDivider = RCC_HCLK_DIV1;

  if (HAL_RCC_ClockConfig(&RCC_ClkInitStruct, FLASH_LATENCY_3) != HAL_OK)
  {
    Error_Handler();
  }
}

/**
  * @brief ADC1 Initialization Function
  * @param None
  * @retval None
  */
static void MX_ADC1_Init(void)
{

  /* USER CODE BEGIN ADC1_Init 0 */

  /* USER CODE END ADC1_Init 0 */

  ADC_ChannelConfTypeDef sConfig = {0};

  /* USER CODE BEGIN ADC1_Init 1 */

  /* USER CODE END ADC1_Init 1 */

  /** Configure the global features of the ADC (Clock, Resolution, Data Alignment and number of conversion)
  */
  hadc1.Instance = ADC1;
  hadc1.Init.ClockPrescaler = ADC_CLOCK_SYNC_PCLK_DIV4;
  hadc1.Init.Resolution = ADC_RESOLUTION_12B;
  hadc1.Init.ScanConvMode = DISABLE;
  hadc1.Init.ContinuousConvMode = ENABLE;
  hadc1.Init.DiscontinuousConvMode = DISABLE;
  hadc1.Init.ExternalTrigConvEdge = ADC_EXTERNALTRIGCONVEDGE_NONE;
  hadc1.Init.ExternalTrigConv = ADC_SOFTWARE_START;
  hadc1.Init.DataAlign = ADC_DATAALIGN_RIGHT;
  hadc1.Init.NbrOfConversion = 1;
  hadc1.Init.DMAContinuousRequests = DISABLE;
  hadc1.Init.EOCSelection = ADC_EOC_SINGLE_CONV;
  if (HAL_ADC_Init(&hadc1) != HAL_OK)
  {
    Error_Handler();
  }

  /** Configure for the selected ADC regular channel its corresponding rank in the sequencer and its sample time.
  */
  sConfig.Channel = ADC_CHANNEL_2;
  sConfig.Rank = 1;
  sConfig.SamplingTime = ADC_SAMPLETIME_3CYCLES;
  if (HAL_ADC_ConfigChannel(&hadc1, &sConfig) != HAL_OK)
  {
    Error_Handler();
  }
  /* USER CODE BEGIN ADC1_Init 2 */

  /* USER CODE END ADC1_Init 2 */

}

/**
  * Enable DMA controller clock
  */
static void MX_DMA_Init(void)
{

  /* DMA controller clock enable */
  __HAL_RCC_DMA2_CLK_ENABLE();

  /* DMA interrupt init */
  /* DMA2_Stream0_IRQn interrupt configuration */
  HAL_NVIC_SetPriority(DMA2_Stream0_IRQn, 0, 0);
  HAL_NVIC_EnableIRQ(DMA2_Stream0_IRQn);

}

/**
  * @brief GPIO Initialization Function
  * @param None
  * @retval None
  */
static void MX_GPIO_Init(void)
{
/* USER CODE BEGIN MX_GPIO_Init_1 */
/* USER CODE END MX_GPIO_Init_1 */

  /* GPIO Ports Clock Enable */
  __HAL_RCC_GPIOH_CLK_ENABLE();
  __HAL_RCC_GPIOA_CLK_ENABLE();

/* USER CODE BEGIN MX_GPIO_Init_2 */
/* USER CODE END MX_GPIO_Init_2 */
}

/* USER CODE BEGIN 4 */

/* USER CODE END 4 */

/**
  * @brief  This function is executed in case of error occurrence.
  * @retval None
  */
void Error_Handler(void)
{
  /* USER CODE BEGIN Error_Handler_Debug */
  /* User can add his own implementation to report the HAL error return state */
  __disable_irq();
  while (1)
  {
  }
  /* USER CODE END Error_Handler_Debug */
}

#ifdef  USE_FULL_ASSERT
/**
  * @brief  Reports the name of the source file and the source line number
  *         where the assert_param error has occurred.
  * @param  file: pointer to the source file name
  * @param  line: assert_param error line source number
  * @retval None
  */
void assert_failed(uint8_t *file, uint32_t line)
{
  /* USER CODE BEGIN 6 */
  /* User can add his own implementation to report the file name and line number,
     ex: printf("Wrong parameters value: file %s on line %d\r\n", file, line) */
  /* USER CODE END 6 */
}
#endif /* USE_FULL_ASSERT *//
I don't know that is this the right way to use HAL codes in Arduino? just copying and pasting cube generated code works like a charm?
So in my case, it Didn't.
any help and introduction will greatly appreciated.


2. hal_conf_extra.h simply doesn't work for me...
As mentioned in this link of wiki, I tried this code:

Code: Select all

#define HAL_ADC_MODULE_DISABLED
#define HAL_I2C_MODULE_DISABLED
#define HAL_RTC_MODULE_DISABLED
#define HAL_SPI_MODULE_DISABLED
#define HAL_ETH_MODULE_DISABLED
#define HAL_SD_MODULE_DISABLED
inside hal_conf_extra.h and compiled, to check if i can disable modules and use Cube generated codes, or not.
i tested code above in Blink.io example & it always uses 10000 bytes of STM32F103 (generic) even if I dont use that extra file. Literally NOTHING happens by using this header file...
I'm using the latest versions of Cube IDE / STM32 Core / Arduino IDE 2.3.4

searched so many sites and didn't find any solution for these two questions. things are getting more and more weird/difficult and i wish if i was able to use arduino libraries in Cube IDE Directly. Implementing HAL in this core seems harder that I thought...

Sincerely
fpiSTM
Posts: 1944
Joined: Wed Dec 11, 2019 7:11 pm
Answers: 108
Location: Le Mans
Contact:

Re: Using HAL in Stm32 arduino IDE (Cube generated)

Post by fpiSTM »

FarhanKhosravi
Posts: 3
Joined: Sun May 01, 2022 12:24 pm

Re: Using HAL in Stm32 arduino IDE (Cube generated)

Post by FarhanKhosravi »

fpiSTM wrote: Sat Dec 07, 2024 12:28 pm See viewtopic.php?t=110
Hi fpiSTM.
Yeah, I've read this topic before. I wish we could have all of these -DHAL_xxx available commands in a dedicated page in Wiki... i don't know how many they are and how to use others. just a bit more instructions and examples are needed in this page:
https://github.com/stm32duino/Arduino_C ... uild_opt.h
Maybe enriching this page with more examples will help a lot of users struggling with HAL usage. (STM is known for its rich documentation; and people using STM32Duino are often more newbie than keil/cube users, so this means they need even richer wiki & examples to get their job done)

and after all... the second question is bothering me. i did everything right and hal_conf_extra.h doesn't do it's job..? maybe a bug in new updates or something?...
fpiSTM
Posts: 1944
Joined: Wed Dec 11, 2019 7:11 pm
Answers: 108
Location: Le Mans
Contact:

Re: Using HAL in Stm32 arduino IDE (Cube generated)

Post by fpiSTM »

FarhanKhosravi wrote: Sat Dec 07, 2024 12:47 pm I wish we could have all of these -DHAL_xxx available commands in a dedicated page in Wiki...
You got it here:
https://github.com/stm32duino/Arduino_C ... figuration
FarhanKhosravi wrote: Sat Dec 07, 2024 12:47 pm i don't know how many they are and how to use others. just a bit more instructions and examples are needed in this page:
https://github.com/stm32duino/Arduino_C ... uild_opt.h
Maybe enriching this page with more examples will help a lot of users struggling with HAL usage. (STM is known for its rich documentation; and people using STM32Duino are often more newbie than keil/cube users, so this means they need even richer wiki & examples to get their job done)
Don't know what you expect, there are some examples, list all does not provide any interest as they are listed in the previous list. Moreover you can ad all what you want as this is purely gcc build configuration (Define, build options,...)
FarhanKhosravi wrote: Sat Dec 07, 2024 12:47 pm and after all... the second question is bothering me. i did everything right and hal_conf_extra.h doesn't do it's job..? maybe a bug in new updates or something?...
It do it's job:
Default blink compile for a Nucleo L053RB:
Sketch uses 20640 bytes (31%) of program storage space. Maximum is 65536 bytes.
Global variables use 1428 bytes (17%) of dynamic memory, leaving 6764 bytes for local variables. Maximum is 8192 bytes.
With hal_conf_extra.h:

Code: Select all

#define HAL_ADC_MODULE_DISABLED
#define HAL_RTC_MODULE_DISABLED
#define HAL_SPI_MODULE_DISABLED
#define HAL_TIM_MODULE_DISABLED
#define HAL_EXTI_MODULE_DISABLED
#define HAL_I2C_MODULE_DISABLED
Sketch uses 19084 bytes (29%) of program storage space. Maximum is 65536 bytes.
Global variables use 1092 bytes (13%) of dynamic memory, leaving 7100 bytes for local variables. Maximum is 8192 bytes.
Then with Serial disabled thanks the menu:
Sketch uses 10204 bytes (15%) of program storage space. Maximum is 65536 bytes.
Global variables use 548 bytes (6%) of dynamic memory, leaving 7644 bytes for local variables. Maximum is 8192 bytes.
The gain depends on the series. First gain is 1K but not so huge because SPI and I2C are used only when the respective library is included.
Serial is huge depending of the series and linked to the HAL usage.
You can also customize the pinmap array to have some gain:
https://github.com/stm32duino/Arduino_C ... nmap-array

In your case you should use the HAL_MODULE_ONLY for the ADC:
https://github.com/stm32duino/Arduino_C ... odule-only
Post Reply

Return to “General discussion”