{"id":13223,"date":"2024-03-15T06:37:47","date_gmt":"2024-03-15T06:37:47","guid":{"rendered":"https:\/\/www.silicloud.com\/blog\/explanation-of-how-assert_param-is-used-in-stm32\/"},"modified":"2025-08-05T14:07:45","modified_gmt":"2025-08-05T14:07:45","slug":"explanation-of-how-assert_param-is-used-in-stm32","status":"publish","type":"post","link":"https:\/\/www.silicloud.com\/blog\/explanation-of-how-assert_param-is-used-in-stm32\/","title":{"rendered":"STM32 assert_param Macro Usage Guide"},"content":{"rendered":"

In STM32, assert_param is a macro used to check if the input parameters of a function meet the expected conditions. The definition of this macro can be found in the stm32fxxx.h file in the CMSIS library.<\/p>\n

The definition of the assert_param macro is as follows:<\/p>\n

#define assert_param(expr) ((expr) ? (void)0 : assert_failed((uint8_t *)__FILE__, __LINE__))\r\n<\/code><\/pre>\n
The assert_param macro takes an expression as a parameter. If the result of the expression is non-zero, it is considered valid and no action is taken. If the result is zero, it is considered invalid, and the assert_failed function is called for error handling.<\/p>\n
The definition of the assert_failed function is as follows:<\/p>\n
void assert_failed(uint8_t* file, uint32_t line)\r\n{\r\n  \/* \u7528\u6237\u53ef\u4ee5\u5728\u8fd9\u91cc\u6dfb\u52a0\u81ea\u5b9a\u4e49\u9519\u8bef\u5904\u7406\u4ee3\u7801 *\/\r\n\r\n  \/* \u6b7b\u5faa\u73af\uff0c\u505c\u6b62\u7a0b\u5e8f\u6267\u884c *\/\r\n  while (1)\r\n  {\r\n  }\r\n}\r\n<\/code><\/pre>\n
In this function, users can add their own custom error handling code. By default, the function simply goes into an infinite loop, halting the program’s execution.<\/p>\n
The usage of the assert_param macro is as follows:<\/p>\n
void foo(uint32_t value)\r\n{\r\n  \/* \u68c0\u67e5\u8f93\u5165\u53c2\u6570\u662f\u5426\u5408\u6cd5 *\/\r\n  assert_param(value <= 100);\r\n\r\n  \/* \u51fd\u6570\u7684\u5176\u4ed6\u64cd\u4f5c *\/\r\n}\r\n<\/code><\/pre>\n
In the previous example, assert_param(value <= 100) is used to check if the input parameter value is less than or equal to 100. If the value of value exceeds 100, the assert_param macro will trigger an error handling mechanism.<\/p>\n
In conclusion, the assert_param macro is used in STM32 to check the validity of function input parameters, helping developers to identify and debug issues early on.<\/p>\n","protected":false},"excerpt":{"rendered":"
In STM32, assert_param is a macro used to check if the input parameters of a function meet the expected conditions. The definition of this macro can be found in the stm32fxxx.h file in the CMSIS library. The definition of the assert_param macro is as follows: #define assert_param(expr) ((expr) ? (void)0 : assert_failed((uint8_t *)__FILE__, __LINE__)) The […]<\/p>\n","protected":false},"author":8,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_import_markdown_pro_load_document_selector":0,"_import_markdown_pro_submit_text_textarea":"","footnotes":""},"categories":[1],"tags":[17546,17548,6986,8983,17547],"class_list":["post-13223","post","type-post","status-publish","format-standard","hentry","category-uncategorized","tag-assert_param","tag-cmsis","tag-embedded-systems","tag-parameter-validation","tag-stm32"],"yoast_head":"\nSTM32 assert_param Macro Usage Guide - Blog - Silicon Cloud<\/title>\n<meta name=\"description\" content=\"Learn how STM32's assert_param macro validates parameters, its definition in CMSIS, and usage for robust embedded development.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.silicloud.com\/blog\/explanation-of-how-assert_param-is-used-in-stm32\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"STM32 assert_param Macro Usage Guide\" \/>\n<meta property=\"og:description\" content=\"Learn how STM32's assert_param macro validates parameters, its definition in CMSIS, and usage for robust embedded development.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.silicloud.com\/blog\/explanation-of-how-assert_param-is-used-in-stm32\/\" \/>\n<meta property=\"og:site_name\" content=\"Blog - Silicon Cloud\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/SiliCloudGlobal\/\" \/>\n<meta property=\"article:published_time\" content=\"2024-03-15T06:37:47+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2025-08-05T14:07:45+00:00\" \/>\n<meta name=\"author\" content=\"William Carter\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@SiliCloudGlobal\" \/>\n<meta name=\"twitter:site\" content=\"@SiliCloudGlobal\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"William Carter\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"1 minute\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/www.silicloud.com\/blog\/explanation-of-how-assert_param-is-used-in-stm32\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/www.silicloud.com\/blog\/explanation-of-how-assert_param-is-used-in-stm32\/\"},\"author\":{\"name\":\"William Carter\",\"@id\":\"https:\/\/www.silicloud.com\/blog\/#\/schema\/person\/f697031891aacefc4b681d139781d3c0\"},\"headline\":\"STM32 assert_param Macro Usage Guide\",\"datePublished\":\"2024-03-15T06:37:47+00:00\",\"dateModified\":\"2025-08-05T14:07:45+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/www.silicloud.com\/blog\/explanation-of-how-assert_param-is-used-in-stm32\/\"},\"wordCount\":155,\"publisher\":{\"@id\":\"https:\/\/www.silicloud.com\/blog\/#organization\"},\"keywords\":[\"assert_param\",\"CMSIS\",\"embedded systems\",\"parameter validation\",\"STM32\"],\"inLanguage\":\"en-US\"},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.silicloud.com\/blog\/explanation-of-how-assert_param-is-used-in-stm32\/\",\"url\":\"https:\/\/www.silicloud.com\/blog\/explanation-of-how-assert_param-is-used-in-stm32\/\",\"name\":\"STM32 assert_param Macro Usage Guide - Blog - Silicon Cloud\",\"isPartOf\":{\"@id\":\"https:\/\/www.silicloud.com\/blog\/#website\"},\"datePublished\":\"2024-03-15T06:37:47+00:00\",\"dateModified\":\"2025-08-05T14:07:45+00:00\",\"description\":\"Learn how STM32's assert_param macro validates parameters, its definition in CMSIS, and usage for robust embedded development.\",\"breadcrumb\":{\"@id\":\"https:\/\/www.silicloud.com\/blog\/explanation-of-how-assert_param-is-used-in-stm32\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.silicloud.com\/blog\/explanation-of-how-assert_param-is-used-in-stm32\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.silicloud.com\/blog\/explanation-of-how-assert_param-is-used-in-stm32\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.silicloud.com\/blog\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"STM32 assert_param Macro Usage Guide\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.silicloud.com\/blog\/#website\",\"url\":\"https:\/\/www.silicloud.com\/blog\/\",\"name\":\"Silicon Cloud Blog\",\"description\":\"\",\"publisher\":{\"@id\":\"https:\/\/www.silicloud.com\/blog\/#organization\"},\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/www.silicloud.com\/blog\/#organization\",\"name\":\"Silicon Cloud Blog\",\"url\":\"https:\/\/www.silicloud.com\/blog\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.silicloud.com\/blog\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/www.silicloud.com\/blog\/wp-content\/uploads\/2023\/11\/EN-SILICON-Full.png\",\"contentUrl\":\"https:\/\/www.silicloud.com\/blog\/wp-content\/uploads\/2023\/11\/EN-SILICON-Full.png\",\"width\":1024,\"height\":1024,\"caption\":\"Silicon Cloud Blog\"},\"image\":{\"@id\":\"https:\/\/www.silicloud.com\/blog\/#\/schema\/logo\/image\/\"},\"sameAs\":[\"https:\/\/www.facebook.com\/SiliCloudGlobal\/\",\"https:\/\/twitter.com\/SiliCloudGlobal\"]},{\"@type\":\"Person\",\"@id\":\"https:\/\/www.silicloud.com\/blog\/#\/schema\/person\/f697031891aacefc4b681d139781d3c0\",\"name\":\"William Carter\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.silicloud.com\/blog\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/1786698071dd8d74bec894b512f9e3c610c3a2a32985f67e688976cee3c8bbef?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/1786698071dd8d74bec894b512f9e3c610c3a2a32985f67e688976cee3c8bbef?s=96&d=mm&r=g\",\"caption\":\"William Carter\"},\"url\":\"https:\/\/www.silicloud.com\/blog\/author\/williamcarter\/\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"STM32 assert_param Macro Usage Guide - Blog - Silicon Cloud","description":"Learn how STM32's assert_param macro validates parameters, its definition in CMSIS, and usage for robust embedded development.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.silicloud.com\/blog\/explanation-of-how-assert_param-is-used-in-stm32\/","og_locale":"en_US","og_type":"article","og_title":"STM32 assert_param Macro Usage Guide","og_description":"Learn how STM32's assert_param macro validates parameters, its definition in CMSIS, and usage for robust embedded development.","og_url":"https:\/\/www.silicloud.com\/blog\/explanation-of-how-assert_param-is-used-in-stm32\/","og_site_name":"Blog - Silicon Cloud","article_publisher":"https:\/\/www.facebook.com\/SiliCloudGlobal\/","article_published_time":"2024-03-15T06:37:47+00:00","article_modified_time":"2025-08-05T14:07:45+00:00","author":"William Carter","twitter_card":"summary_large_image","twitter_creator":"@SiliCloudGlobal","twitter_site":"@SiliCloudGlobal","twitter_misc":{"Written by":"William Carter","Est. reading time":"1 minute"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/www.silicloud.com\/blog\/explanation-of-how-assert_param-is-used-in-stm32\/#article","isPartOf":{"@id":"https:\/\/www.silicloud.com\/blog\/explanation-of-how-assert_param-is-used-in-stm32\/"},"author":{"name":"William Carter","@id":"https:\/\/www.silicloud.com\/blog\/#\/schema\/person\/f697031891aacefc4b681d139781d3c0"},"headline":"STM32 assert_param Macro Usage Guide","datePublished":"2024-03-15T06:37:47+00:00","dateModified":"2025-08-05T14:07:45+00:00","mainEntityOfPage":{"@id":"https:\/\/www.silicloud.com\/blog\/explanation-of-how-assert_param-is-used-in-stm32\/"},"wordCount":155,"publisher":{"@id":"https:\/\/www.silicloud.com\/blog\/#organization"},"keywords":["assert_param","CMSIS","embedded systems","parameter validation","STM32"],"inLanguage":"en-US"},{"@type":"WebPage","@id":"https:\/\/www.silicloud.com\/blog\/explanation-of-how-assert_param-is-used-in-stm32\/","url":"https:\/\/www.silicloud.com\/blog\/explanation-of-how-assert_param-is-used-in-stm32\/","name":"STM32 assert_param Macro Usage Guide - Blog - Silicon Cloud","isPartOf":{"@id":"https:\/\/www.silicloud.com\/blog\/#website"},"datePublished":"2024-03-15T06:37:47+00:00","dateModified":"2025-08-05T14:07:45+00:00","description":"Learn how STM32's assert_param macro validates parameters, its definition in CMSIS, and usage for robust embedded development.","breadcrumb":{"@id":"https:\/\/www.silicloud.com\/blog\/explanation-of-how-assert_param-is-used-in-stm32\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.silicloud.com\/blog\/explanation-of-how-assert_param-is-used-in-stm32\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.silicloud.com\/blog\/explanation-of-how-assert_param-is-used-in-stm32\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.silicloud.com\/blog\/"},{"@type":"ListItem","position":2,"name":"STM32 assert_param Macro Usage Guide"}]},{"@type":"WebSite","@id":"https:\/\/www.silicloud.com\/blog\/#website","url":"https:\/\/www.silicloud.com\/blog\/","name":"Silicon Cloud Blog","description":"","publisher":{"@id":"https:\/\/www.silicloud.com\/blog\/#organization"},"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/www.silicloud.com\/blog\/#organization","name":"Silicon Cloud Blog","url":"https:\/\/www.silicloud.com\/blog\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.silicloud.com\/blog\/#\/schema\/logo\/image\/","url":"https:\/\/www.silicloud.com\/blog\/wp-content\/uploads\/2023\/11\/EN-SILICON-Full.png","contentUrl":"https:\/\/www.silicloud.com\/blog\/wp-content\/uploads\/2023\/11\/EN-SILICON-Full.png","width":1024,"height":1024,"caption":"Silicon Cloud Blog"},"image":{"@id":"https:\/\/www.silicloud.com\/blog\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.facebook.com\/SiliCloudGlobal\/","https:\/\/twitter.com\/SiliCloudGlobal"]},{"@type":"Person","@id":"https:\/\/www.silicloud.com\/blog\/#\/schema\/person\/f697031891aacefc4b681d139781d3c0","name":"William Carter","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.silicloud.com\/blog\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/1786698071dd8d74bec894b512f9e3c610c3a2a32985f67e688976cee3c8bbef?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/1786698071dd8d74bec894b512f9e3c610c3a2a32985f67e688976cee3c8bbef?s=96&d=mm&r=g","caption":"William Carter"},"url":"https:\/\/www.silicloud.com\/blog\/author\/williamcarter\/"}]}},"_links":{"self":[{"href":"https:\/\/www.silicloud.com\/blog\/wp-json\/wp\/v2\/posts\/13223","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.silicloud.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.silicloud.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.silicloud.com\/blog\/wp-json\/wp\/v2\/users\/8"}],"replies":[{"embeddable":true,"href":"https:\/\/www.silicloud.com\/blog\/wp-json\/wp\/v2\/comments?post=13223"}],"version-history":[{"count":3,"href":"https:\/\/www.silicloud.com\/blog\/wp-json\/wp\/v2\/posts\/13223\/revisions"}],"predecessor-version":[{"id":157135,"href":"https:\/\/www.silicloud.com\/blog\/wp-json\/wp\/v2\/posts\/13223\/revisions\/157135"}],"wp:attachment":[{"href":"https:\/\/www.silicloud.com\/blog\/wp-json\/wp\/v2\/media?parent=13223"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.silicloud.com\/blog\/wp-json\/wp\/v2\/categories?post=13223"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.silicloud.com\/blog\/wp-json\/wp\/v2\/tags?post=13223"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}