ST对STM8S系列都有提供固件库,而不同的版本自然存在一些不同,版本也一直从V1.0.0升级到目前的V1.1.1。
环境: FWLIB V1.0.1版本,采用STM8SF103
在使用GPIO库时,一个偶然发现stm8s_gpio.h中的宏定义是存在问题的。
代码定义如下:
******************************************************************************
*@filestm8s_gpio.h
*@briefThisfilecontainsallfunctionsprototypeandmacros
fortheGPIOperipheral.
*@authorSTMicroelectronics-MCDApplicationTeam
*@versionV1.0.1
*@date09/22/2008
******************************************************************************
typedefenum
{
GPIO_MODE_IN_FL_NO_IT=(u8)0b00000000,
GPIO_MODE_IN_PU_NO_IT=(u8)0b01000000,
GPIO_MODE_IN_FL_IT=(u8)0b00100000,
GPIO_MODE_IN_PU_IT=(u8)0b01100000,
GPIO_MODE_OUT_OD_LOW_FAST=(u8)0b10000000,
GPIO_MODE_OUT_PP_LOW_FAST=(u8)0b11000000,
GPIO_MODE_OUT_OD_LOW_SLOW=(u8)0b10100000,
GPIO_MODE_OUT_PP_LOW_SLOW=(u8)0b11100000,
GPIO_MODE_OUT_OD_HIZ_FAST=(u8)0b10010000,
GPIO_MODE_OUT_PP_HIGH_FAST=(u8)0b11010000,
GPIO_MODE_OUT_OD_HIZ_SLOW=(u8)0b10110000,
GPIO_MODE_OUT_PP_HIGH_SLOW=(u8)0b11110000
}GPIO_Mode_TypeDef;
我在main.c中是直接这样用的 GPIO_Init(GPIOC,GPIO_PIN_ALL,GPIO_MODE_OUT_PP_HIGH_FAST); //将GPIOC所有IO口设置成推挽输出,10M速度。空闲IO口设置为输出低电平能降低不必要的功耗。
但是调试查看寄存器时发现 CR2寄存器全为0,不应该才对。手册上清晰的表明了为1为设置10M速度。
翻看stm8s_gpio.c中的GPIO_Init函数,有设置CR2寄存器,前提是根据GPIO_MODE掩码来进行判断,判断的根据就是 Bit 5。如下:
if((((u8)(GPIO_Mode))&(u8)0x20)!=(u8)0x00)
{
GPIOx->CR2|=GPIO_Pin;
}
else
{
GPIOx->CR2&=(u8)(~(GPIO_Pin));
}

继续查看固件库,对于V1.1.1来说不存在这个问题,如:
******************************************************************************
*@filestm8s_gpio.h
*@briefThisfilecontainsallfunctionsprototypeandmacros
fortheGPIOperipheral.
*@authorSTMicroelectronics-MCDApplicationTeam
*@versionV1.1.1
*@date06/05/2009
******************************************************************************
typedefenum
{
GPIO_MODE_IN_FL_NO_IT=(u8)0b00000000,
GPIO_MODE_IN_PU_NO_IT=(u8)0b01000000,
GPIO_MODE_IN_FL_IT=(u8)0b00100000,
GPIO_MODE_IN_PU_IT=(u8)0b01100000,
GPIO_MODE_OUT_OD_LOW_FAST=(u8)0b10100000,
GPIO_MODE_OUT_PP_LOW_FAST=(u8)0b11100000,
GPIO_MODE_OUT_OD_LOW_SLOW=(u8)0b10000000,
GPIO_MODE_OUT_PP_LOW_SLOW=(u8)0b11000000,
GPIO_MODE_OUT_OD_HIZ_FAST=(u8)0b10110000,
GPIO_MODE_OUT_PP_HIGH_FAST=(u8)0b11110000,
GPIO_MODE_OUT_OD_HIZ_SLOW=(u8)0b10010000,
GPIO_MODE_OUT_PP_HIGH_SLOW=(u8)0b11010000
}GPIO_Mode_TypeDef;
同样是GPIO_MODE_OUT_PP_HIGH_FAST,前者定义为 0b11010000,而后者则是 0b11110000。
后来从发行日志里也了解到,ST已经更正了这个错误。
<h3>V1.1.1 - 06/05/2009</h3>
@code
General
-------
+ Project template updated for both STVD and RIDE toolchains
+ Almost peripheral examples reviewed and validated with both Cosmic and Raisonance
compilers
library
-------
+ stm8s.h:
- __CONST definition added for Cosmic and Raisonance compilers
- TINY definition added for Cosmic and Raisonance compilers
- NEAR definition added for Raisonance compilers
- CAN registers declaration updated
- ADC1 registers declaration updated
+ stm8s_adc1.h:
- IS_ADC1_BUFFER_OK macro definition updated
+ stm8s_beep.c:
- BEEP_Init function updated
- BEEP->CSR |= BEEP_CSR_BEEPEN; removed from init function
+ stm8s_can.c/.h:
- Private variables declaration changed to volatile
- CAN_DeInit function updated
- CAN_Receive function updated
- CAN_FilterInit funtion updated
- CAN_Transmit function updated
- CAN_IT_TypeDef enum updated:
- CAN_IT_ERR and CAN_IT_LEC definition updated to avoid ANSI check
error with Cosmic
+ stm8s_clk.h:
- CLK_Peripheral_TypeDef enum updated:
- CLK_PERIPHERAL_UART1 definition updated and conditioned by the
device to use
+ stm8s_gpio.h:
- The GPIO_Mode_TypeDef enum element definition updated:
- GPIO_MODE_OUT_OD_LOW_FAST
- GPIO_MODE_OUT_PP_LOW_FAST
- GPIO_MODE_OUT_OD_LOW_SLOW
- GPIO_MODE_OUT_PP_LOW_SLOW
- GPIO_MODE_OUT_OD_HIZ_FAST
- GPIO_MODE_OUT_PP_HIGH_FAST
- GPIO_MODE_OUT_OD_HIZ_SLOW
- GPIO_MODE_OUT_PP_HIGH_SLOW
使用FWLIB V1.1.1替换FWLIB V1.0.1过程中,需要注意新版本中不存在 stm8s_macro.h,stm8s_map.h,取而代之的是stm8s.h,而且stm8s.h中外设宏配置也与旧版本不同。对于外设的编译判断旧版采用的是stm8s_conf.h文件,而新版则是根据芯片的型号。
旧版: 在stm8s_map.h中进行编译宏条件判断
#ifdef _ADC1
#define ADC1 ((ADC1_TypeDef *) ADC1_BaseAddress)
#endif
#ifdef _ADC2
#define ADC2 ((ADC2_TypeDef *) ADC2_BaseAddress)
#endif
#ifdef _ITC
#define ITC ((ITC_TypeDef *) ITC_BaseAddress)
#endif
#ifdef _CFG
#define CFG ((CFG_TypeDef *) CFG_BaseAddress)
#endif
.......
.......
新版: 在stm8s.h中进行宏条件判断
#if defined(STM8S105) || defined(STM8S103) || defined(STM8S903)
#define ADC1 ((ADC1_TypeDef *) ADC1_BaseAddress)
#endif /* (STM8S105) ||(STM8S103) || (STM8S903) */
#if defined(STM8S208) || defined(STM8S207)
#define ADC2 ((ADC2_TypeDef *) ADC2_BaseAddress)
#endif /* (STM8S208) ||(STM8S207) */
#define AWU ((AWU_TypeDef *) AWU_BaseAddress)
#define BEEP ((BEEP_TypeDef *) BEEP_BaseAddress)
#ifdef STM8S208
#define CAN ((CAN_TypeDef *) CAN_BaseAddress)
#endif /* (STM8S208) */
#define CLK ((CLK_TypeDef *) CLK_BaseAddress)
......
......
新版固件库无需使用stm8s_conf.h来配置外设,转而是使用芯片的型号即可。如果使用了USE_STDPERIPH_DRIVER宏,则仍然会包含stm8s_conf.h配置文件。STM8S103,编译过程中自然就能够将ADC1等外设编译进去。

还有要注意的就是,不存在的外设不要加入到项目中,这样会导致编译不过。

剔除了stm8s_adc2.c、stm8s_can.c、stm8s_tim3.c、stm8s_tim5.c、stm8s_tim6.c、stm8s_uart2.c、stm8s_uart3.c,这些外设对于STM8S103是不存在的。