From 460e0e9e7389177d32562ac8c6ae830188c4f2e4 Mon Sep 17 00:00:00 2001 From: MobKBK <15059009+mobkbk@user.noreply.gitee.com> Date: Sat, 20 Jun 2026 21:22:34 +0800 Subject: [PATCH] init --- BALANCE/DataScope_DP.C | 90 + BALANCE/DataScope_DP.h | 21 + BALANCE/balance.c | 750 ++ BALANCE/balance.h | 39 + BALANCE/control.c | 259 + BALANCE/control.h | 33 + BALANCE/filter.c | 68 + BALANCE/filter.h | 11 + BALANCE/robot_select_init.c | 93 + BALANCE/robot_select_init.h | 108 + BALANCE/show.c | 344 + BALANCE/show.h | 15 + BALANCE/system.c | 197 + BALANCE/system.h | 124 + CORE/arm_math.h | 7154 +++++++++++++ CORE/core_cm4.h | 1772 ++++ CORE/core_cm4_simd.h | 673 ++ CORE/core_cmFunc.h | 636 ++ CORE/core_cmInstr.h | 688 ++ CORE/startup_stm32f40_41xxx.s | 434 + FWLIB/inc/misc.h | 178 + FWLIB/inc/stm32f4xx_adc.h | 656 ++ FWLIB/inc/stm32f4xx_can.h | 644 ++ FWLIB/inc/stm32f4xx_crc.h | 83 + FWLIB/inc/stm32f4xx_cryp.h | 384 + FWLIB/inc/stm32f4xx_dac.h | 304 + FWLIB/inc/stm32f4xx_dbgmcu.h | 109 + FWLIB/inc/stm32f4xx_dcmi.h | 312 + FWLIB/inc/stm32f4xx_dma.h | 609 ++ FWLIB/inc/stm32f4xx_dma2d.h | 475 + FWLIB/inc/stm32f4xx_exti.h | 183 + FWLIB/inc/stm32f4xx_flash.h | 488 + FWLIB/inc/stm32f4xx_flash_ramfunc.h | 103 + FWLIB/inc/stm32f4xx_fmc.h | 1143 ++ FWLIB/inc/stm32f4xx_fsmc.h | 675 ++ FWLIB/inc/stm32f4xx_gpio.h | 502 + FWLIB/inc/stm32f4xx_hash.h | 257 + FWLIB/inc/stm32f4xx_i2c.h | 711 ++ FWLIB/inc/stm32f4xx_iwdg.h | 131 + FWLIB/inc/stm32f4xx_ltdc.h | 531 + FWLIB/inc/stm32f4xx_pwr.h | 212 + FWLIB/inc/stm32f4xx_rcc.h | 630 ++ FWLIB/inc/stm32f4xx_rng.h | 120 + FWLIB/inc/stm32f4xx_rtc.h | 881 ++ FWLIB/inc/stm32f4xx_sai.h | 611 ++ FWLIB/inc/stm32f4xx_sdio.h | 536 + FWLIB/inc/stm32f4xx_spi.h | 549 + FWLIB/inc/stm32f4xx_syscfg.h | 210 + FWLIB/inc/stm32f4xx_tim.h | 1150 +++ FWLIB/inc/stm32f4xx_usart.h | 431 + FWLIB/inc/stm32f4xx_wwdg.h | 111 + FWLIB/src/misc.c | 249 + FWLIB/src/stm32f4xx_adc.c | 1745 ++++ FWLIB/src/stm32f4xx_can.c | 1700 +++ FWLIB/src/stm32f4xx_crc.c | 133 + FWLIB/src/stm32f4xx_cryp.c | 934 ++ FWLIB/src/stm32f4xx_cryp_aes.c | 1707 +++ FWLIB/src/stm32f4xx_cryp_des.c | 308 + FWLIB/src/stm32f4xx_cryp_tdes.c | 325 + FWLIB/src/stm32f4xx_dac.c | 714 ++ FWLIB/src/stm32f4xx_dbgmcu.c | 180 + FWLIB/src/stm32f4xx_dcmi.c | 538 + FWLIB/src/stm32f4xx_dma.c | 1301 +++ FWLIB/src/stm32f4xx_dma2d.c | 784 ++ FWLIB/src/stm32f4xx_exti.c | 311 + FWLIB/src/stm32f4xx_flash.c | 1612 +++ FWLIB/src/stm32f4xx_flash_ramfunc.c | 158 + FWLIB/src/stm32f4xx_fmc.c | 1367 +++ FWLIB/src/stm32f4xx_fsmc.c | 985 ++ FWLIB/src/stm32f4xx_gpio.c | 611 ++ FWLIB/src/stm32f4xx_hash.c | 726 ++ FWLIB/src/stm32f4xx_hash_md5.c | 320 + FWLIB/src/stm32f4xx_hash_sha1.c | 323 + FWLIB/src/stm32f4xx_i2c.c | 1462 +++ FWLIB/src/stm32f4xx_iwdg.c | 266 + FWLIB/src/stm32f4xx_ltdc.c | 1110 ++ FWLIB/src/stm32f4xx_pwr.c | 939 ++ FWLIB/src/stm32f4xx_rcc.c | 2307 +++++ FWLIB/src/stm32f4xx_rng.c | 397 + FWLIB/src/stm32f4xx_rtc.c | 2761 +++++ FWLIB/src/stm32f4xx_sai.c | 1079 ++ FWLIB/src/stm32f4xx_sdio.c | 1011 ++ FWLIB/src/stm32f4xx_spi.c | 1319 +++ FWLIB/src/stm32f4xx_syscfg.c | 240 + FWLIB/src/stm32f4xx_tim.c | 3365 ++++++ FWLIB/src/stm32f4xx_usart.c | 1486 +++ FWLIB/src/stm32f4xx_wwdg.c | 307 + FreeRTOS/croutine.c | 395 + FreeRTOS/event_groups.c | 752 ++ FreeRTOS/include/FreeRTOS.h | 1063 ++ FreeRTOS/include/FreeRTOSConfig.h | 191 + FreeRTOS/include/StackMacros.h | 171 + FreeRTOS/include/croutine.h | 762 ++ FreeRTOS/include/deprecated_definitions.h | 321 + FreeRTOS/include/event_groups.h | 797 ++ FreeRTOS/include/list.h | 453 + FreeRTOS/include/mpu_prototypes.h | 177 + FreeRTOS/include/mpu_wrappers.h | 201 + FreeRTOS/include/portable.h | 207 + FreeRTOS/include/projdefs.h | 161 + FreeRTOS/include/queue.h | 1798 ++++ FreeRTOS/include/semphr.h | 1171 +++ FreeRTOS/include/stdint.readme | 27 + FreeRTOS/include/task.h | 2267 ++++ FreeRTOS/include/timers.h | 1314 +++ FreeRTOS/list.c | 240 + .../Keil/See-also-the-RVDS-directory.txt | 1 + FreeRTOS/portable/MemMang/ReadMe.url | 5 + FreeRTOS/portable/MemMang/heap_1.c | 188 + FreeRTOS/portable/MemMang/heap_2.c | 314 + FreeRTOS/portable/MemMang/heap_3.c | 139 + FreeRTOS/portable/MemMang/heap_4.c | 478 + FreeRTOS/portable/MemMang/heap_5.c | 527 + FreeRTOS/portable/RVDS/ARM7_LPC21xx/port.c | 333 + FreeRTOS/portable/RVDS/ARM7_LPC21xx/portASM.s | 151 + .../portable/RVDS/ARM7_LPC21xx/portmacro.h | 188 + .../portable/RVDS/ARM7_LPC21xx/portmacro.inc | 118 + FreeRTOS/portable/RVDS/ARM_CA9/port.c | 522 + FreeRTOS/portable/RVDS/ARM_CA9/portASM.s | 200 + FreeRTOS/portable/RVDS/ARM_CA9/portmacro.h | 205 + FreeRTOS/portable/RVDS/ARM_CA9/portmacro.inc | 147 + FreeRTOS/portable/RVDS/ARM_CM0/port.c | 349 + FreeRTOS/portable/RVDS/ARM_CM0/portmacro.h | 156 + FreeRTOS/portable/RVDS/ARM_CM3/port.c | 701 ++ FreeRTOS/portable/RVDS/ARM_CM3/portmacro.h | 294 + FreeRTOS/portable/RVDS/ARM_CM4F/port.c | 789 ++ FreeRTOS/portable/RVDS/ARM_CM4F/portmacro.h | 294 + FreeRTOS/portable/RVDS/ARM_CM4_MPU/port.c | 845 ++ .../portable/RVDS/ARM_CM4_MPU/portmacro.h | 348 + FreeRTOS/portable/RVDS/ARM_CM7/ReadMe.txt | 18 + FreeRTOS/portable/RVDS/ARM_CM7/r0p1/port.c | 775 ++ .../portable/RVDS/ARM_CM7/r0p1/portmacro.h | 298 + FreeRTOS/portable/readme.txt | 20 + FreeRTOS/queue.c | 2566 +++++ FreeRTOS/readme.txt | 17 + FreeRTOS/tasks.c | 4807 +++++++++ FreeRTOS/timers.c | 1092 ++ HARDWARE/DataScope_DP.C | 85 + HARDWARE/DataScope_DP.h | 16 + HARDWARE/LED.C | 81 + HARDWARE/LED.H | 27 + HARDWARE/MPU6050/I2C.c | 352 + HARDWARE/MPU6050/I2C.h | 52 + HARDWARE/MPU6050/MPU6050.c | 545 + HARDWARE/MPU6050/mpu6050.h | 385 + HARDWARE/adc.c | 166 + HARDWARE/adc.h | 16 + HARDWARE/can.c | 413 + HARDWARE/can.h | 40 + HARDWARE/dma.c | 78 + HARDWARE/dma.h | 21 + HARDWARE/encoder.c | 279 + HARDWARE/encoder.h | 24 + HARDWARE/exti.c | 29 + HARDWARE/exti.h | 35 + HARDWARE/key.c | 185 + HARDWARE/key.h | 19 + HARDWARE/motor.c | 222 + HARDWARE/motor.h | 63 + HARDWARE/oled.c | 325 + HARDWARE/oled.h | 41 + HARDWARE/oledfont.h | 398 + HARDWARE/pstwo.c | 424 + HARDWARE/pstwo.h | 75 + HARDWARE/stmflash.c | 220 + HARDWARE/stmflash.h | 52 + HARDWARE/timer.c | 474 + HARDWARE/timer.h | 11 + HARDWARE/usartx.c | 936 ++ HARDWARE/usartx.h | 85 + OBJ/ExtDll.iex | 2 + OBJ/OriginCar.axf | Bin 0 -> 718768 bytes OBJ/OriginCar.build_log.htm | 94 + OBJ/OriginCar.hex | 3610 +++++++ OBJ/OriginCar.htm | 3829 +++++++ OBJ/OriginCar.lnp | 45 + OBJ/OriginCar.map | 4422 ++++++++ OBJ/OriginCar.sct | 16 + OBJ/OriginCar_FreeRTOS.dep | 2244 ++++ OBJ/adc.crf | Bin 0 -> 613175 bytes OBJ/adc.d | 78 + OBJ/adc.o | Bin 0 -> 583240 bytes OBJ/balance.crf | Bin 0 -> 619194 bytes OBJ/balance.d | 78 + OBJ/balance.o | Bin 0 -> 616852 bytes OBJ/can.crf | Bin 0 -> 616495 bytes OBJ/can.d | 78 + OBJ/can.o | Bin 0 -> 591724 bytes OBJ/croutine.crf | Bin 0 -> 562554 bytes OBJ/croutine.d | 55 + OBJ/croutine.o | Bin 0 -> 526088 bytes OBJ/delay.crf | Bin 0 -> 562538 bytes OBJ/delay.d | 54 + OBJ/delay.o | Bin 0 -> 534796 bytes OBJ/encoder.crf | Bin 0 -> 615478 bytes OBJ/encoder.d | 78 + OBJ/encoder.o | Bin 0 -> 588788 bytes OBJ/event_groups.crf | Bin 0 -> 575728 bytes OBJ/event_groups.d | 56 + OBJ/event_groups.o | Bin 0 -> 556184 bytes OBJ/heap_4.crf | Bin 0 -> 568129 bytes OBJ/heap_4.d | 54 + OBJ/heap_4.o | Bin 0 -> 539484 bytes OBJ/i2c.crf | Bin 0 -> 615763 bytes OBJ/i2c.d | 78 + OBJ/i2c.o | Bin 0 -> 596220 bytes OBJ/key.crf | Bin 0 -> 613027 bytes OBJ/key.d | 78 + OBJ/key.o | Bin 0 -> 582536 bytes OBJ/led.crf | Bin 0 -> 612316 bytes OBJ/led.d | 78 + OBJ/led.o | Bin 0 -> 578428 bytes OBJ/list.crf | Bin 0 -> 557973 bytes OBJ/list.d | 53 + OBJ/list.o | Bin 0 -> 529588 bytes OBJ/main.crf | Bin 0 -> 612028 bytes OBJ/main.d | 77 + OBJ/main.o | Bin 0 -> 576112 bytes OBJ/misc.crf | Bin 0 -> 525095 bytes OBJ/misc.d | 41 + OBJ/misc.o | Bin 0 -> 497560 bytes OBJ/motor.crf | Bin 0 -> 615133 bytes OBJ/motor.d | 78 + OBJ/motor.o | Bin 0 -> 582052 bytes OBJ/mpu6050.crf | Bin 0 -> 614826 bytes OBJ/mpu6050.d | 78 + OBJ/mpu6050.o | Bin 0 -> 601872 bytes OBJ/oled.crf | Bin 0 -> 614953 bytes OBJ/oled.d | 79 + OBJ/oled.o | Bin 0 -> 602136 bytes OBJ/port.crf | Bin 0 -> 564814 bytes OBJ/port.d | 53 + OBJ/port.o | Bin 0 -> 544504 bytes OBJ/pstwo.crf | Bin 0 -> 614811 bytes OBJ/pstwo.d | 78 + OBJ/pstwo.o | Bin 0 -> 600900 bytes OBJ/queue.crf | Bin 0 -> 587330 bytes OBJ/queue.d | 55 + OBJ/queue.o | Bin 0 -> 602576 bytes OBJ/robot_select_init.crf | Bin 0 -> 612254 bytes OBJ/robot_select_init.d | 78 + OBJ/robot_select_init.o | Bin 0 -> 577520 bytes OBJ/show.crf | Bin 0 -> 614378 bytes OBJ/show.d | 79 + OBJ/show.o | Bin 0 -> 585672 bytes OBJ/startup_stm32f40_41xxx.d | 1 + OBJ/startup_stm32f40_41xxx.lst | 1989 ++++ OBJ/startup_stm32f40_41xxx.o | Bin 0 -> 8092 bytes OBJ/stm32f4xx_adc.crf | Bin 0 -> 531838 bytes OBJ/stm32f4xx_adc.d | 41 + OBJ/stm32f4xx_adc.o | Bin 0 -> 550644 bytes OBJ/stm32f4xx_can.crf | Bin 0 -> 533888 bytes OBJ/stm32f4xx_can.d | 41 + OBJ/stm32f4xx_can.o | Bin 0 -> 532352 bytes OBJ/stm32f4xx_gpio.crf | Bin 0 -> 527190 bytes OBJ/stm32f4xx_gpio.d | 41 + OBJ/stm32f4xx_gpio.o | Bin 0 -> 512256 bytes OBJ/stm32f4xx_it.crf | Bin 0 -> 524489 bytes OBJ/stm32f4xx_it.d | 41 + OBJ/stm32f4xx_it.o | Bin 0 -> 498680 bytes OBJ/stm32f4xx_pwr.crf | Bin 0 -> 528072 bytes OBJ/stm32f4xx_pwr.d | 41 + OBJ/stm32f4xx_pwr.o | Bin 0 -> 518128 bytes OBJ/stm32f4xx_rcc.crf | Bin 0 -> 535718 bytes OBJ/stm32f4xx_rcc.d | 41 + OBJ/stm32f4xx_rcc.o | Bin 0 -> 573260 bytes OBJ/stm32f4xx_syscfg.crf | Bin 0 -> 525424 bytes OBJ/stm32f4xx_syscfg.d | 41 + OBJ/stm32f4xx_syscfg.o | Bin 0 -> 501284 bytes OBJ/stm32f4xx_tim.crf | Bin 0 -> 545079 bytes OBJ/stm32f4xx_tim.d | 41 + OBJ/stm32f4xx_tim.o | Bin 0 -> 635024 bytes OBJ/stm32f4xx_usart.crf | Bin 0 -> 530309 bytes OBJ/stm32f4xx_usart.d | 41 + OBJ/stm32f4xx_usart.o | Bin 0 -> 536020 bytes OBJ/sys.crf | Bin 0 -> 525566 bytes OBJ/sys.d | 41 + OBJ/sys.o | Bin 0 -> 493168 bytes OBJ/system.crf | Bin 0 -> 611882 bytes OBJ/system.d | 77 + OBJ/system.o | Bin 0 -> 576988 bytes OBJ/system_stm32f4xx.crf | Bin 0 -> 526286 bytes OBJ/system_stm32f4xx.d | 40 + OBJ/system_stm32f4xx.o | Bin 0 -> 495548 bytes OBJ/tasks.crf | Bin 0 -> 592508 bytes OBJ/tasks.d | 56 + OBJ/tasks.o | Bin 0 -> 644160 bytes OBJ/timer.crf | Bin 0 -> 617434 bytes OBJ/timer.d | 78 + OBJ/timer.o | Bin 0 -> 586688 bytes OBJ/timers.crf | Bin 0 -> 583380 bytes OBJ/timers.d | 56 + OBJ/timers.o | Bin 0 -> 573492 bytes OBJ/usart.crf | Bin 0 -> 551292 bytes OBJ/usart.d | 51 + OBJ/usart.o | Bin 0 -> 522528 bytes OBJ/usartx.crf | Bin 0 -> 619711 bytes OBJ/usartx.d | 78 + OBJ/usartx.o | Bin 0 -> 615920 bytes SYSTEM/delay/delay.c | 137 + SYSTEM/delay/delay.h | 39 + SYSTEM/sys/sys.c | 44 + SYSTEM/sys/sys.h | 83 + SYSTEM/usart/usart.c | 102 + SYSTEM/usart/usart.h | 16 + USER/DebugConfig/FreeRTOS_STM32F407ZG.dbgconf | 48 + USER/EventRecorderStub.scvd | 9 + USER/JLinkSettings.ini | 34 + USER/OriginCar.uvguix.12459 | 1887 ++++ USER/OriginCar.uvguix.32892 | 3799 +++++++ USER/OriginCar.uvoptx | 861 ++ USER/OriginCar.uvprojx | 654 ++ USER/main.c | 52 + USER/stm32f4xx.h | 9176 +++++++++++++++++ USER/stm32f4xx_conf.h | 125 + USER/stm32f4xx_it.c | 168 + USER/stm32f4xx_it.h | 60 + USER/system_stm32f4xx.c | 1130 ++ USER/system_stm32f4xx.h | 105 + keilkilll.bat | 27 + 320 files changed, 135203 insertions(+) create mode 100644 BALANCE/DataScope_DP.C create mode 100644 BALANCE/DataScope_DP.h create mode 100644 BALANCE/balance.c create mode 100644 BALANCE/balance.h create mode 100644 BALANCE/control.c create mode 100644 BALANCE/control.h create mode 100644 BALANCE/filter.c create mode 100644 BALANCE/filter.h create mode 100644 BALANCE/robot_select_init.c create mode 100644 BALANCE/robot_select_init.h create mode 100644 BALANCE/show.c create mode 100644 BALANCE/show.h create mode 100644 BALANCE/system.c create mode 100644 BALANCE/system.h create mode 100644 CORE/arm_math.h create mode 100644 CORE/core_cm4.h create mode 100644 CORE/core_cm4_simd.h create mode 100644 CORE/core_cmFunc.h create mode 100644 CORE/core_cmInstr.h create mode 100644 CORE/startup_stm32f40_41xxx.s create mode 100644 FWLIB/inc/misc.h create mode 100644 FWLIB/inc/stm32f4xx_adc.h create mode 100644 FWLIB/inc/stm32f4xx_can.h create mode 100644 FWLIB/inc/stm32f4xx_crc.h create mode 100644 FWLIB/inc/stm32f4xx_cryp.h create mode 100644 FWLIB/inc/stm32f4xx_dac.h create mode 100644 FWLIB/inc/stm32f4xx_dbgmcu.h create mode 100644 FWLIB/inc/stm32f4xx_dcmi.h create mode 100644 FWLIB/inc/stm32f4xx_dma.h create mode 100644 FWLIB/inc/stm32f4xx_dma2d.h create mode 100644 FWLIB/inc/stm32f4xx_exti.h create mode 100644 FWLIB/inc/stm32f4xx_flash.h create mode 100644 FWLIB/inc/stm32f4xx_flash_ramfunc.h create mode 100644 FWLIB/inc/stm32f4xx_fmc.h create mode 100644 FWLIB/inc/stm32f4xx_fsmc.h create mode 100644 FWLIB/inc/stm32f4xx_gpio.h create mode 100644 FWLIB/inc/stm32f4xx_hash.h create mode 100644 FWLIB/inc/stm32f4xx_i2c.h create mode 100644 FWLIB/inc/stm32f4xx_iwdg.h create mode 100644 FWLIB/inc/stm32f4xx_ltdc.h create mode 100644 FWLIB/inc/stm32f4xx_pwr.h create mode 100644 FWLIB/inc/stm32f4xx_rcc.h create mode 100644 FWLIB/inc/stm32f4xx_rng.h create mode 100644 FWLIB/inc/stm32f4xx_rtc.h create mode 100644 FWLIB/inc/stm32f4xx_sai.h create mode 100644 FWLIB/inc/stm32f4xx_sdio.h create mode 100644 FWLIB/inc/stm32f4xx_spi.h create mode 100644 FWLIB/inc/stm32f4xx_syscfg.h create mode 100644 FWLIB/inc/stm32f4xx_tim.h create mode 100644 FWLIB/inc/stm32f4xx_usart.h create mode 100644 FWLIB/inc/stm32f4xx_wwdg.h create mode 100644 FWLIB/src/misc.c create mode 100644 FWLIB/src/stm32f4xx_adc.c create mode 100644 FWLIB/src/stm32f4xx_can.c create mode 100644 FWLIB/src/stm32f4xx_crc.c create mode 100644 FWLIB/src/stm32f4xx_cryp.c create mode 100644 FWLIB/src/stm32f4xx_cryp_aes.c create mode 100644 FWLIB/src/stm32f4xx_cryp_des.c create mode 100644 FWLIB/src/stm32f4xx_cryp_tdes.c create mode 100644 FWLIB/src/stm32f4xx_dac.c create mode 100644 FWLIB/src/stm32f4xx_dbgmcu.c create mode 100644 FWLIB/src/stm32f4xx_dcmi.c create mode 100644 FWLIB/src/stm32f4xx_dma.c create mode 100644 FWLIB/src/stm32f4xx_dma2d.c create mode 100644 FWLIB/src/stm32f4xx_exti.c create mode 100644 FWLIB/src/stm32f4xx_flash.c create mode 100644 FWLIB/src/stm32f4xx_flash_ramfunc.c create mode 100644 FWLIB/src/stm32f4xx_fmc.c create mode 100644 FWLIB/src/stm32f4xx_fsmc.c create mode 100644 FWLIB/src/stm32f4xx_gpio.c create mode 100644 FWLIB/src/stm32f4xx_hash.c create mode 100644 FWLIB/src/stm32f4xx_hash_md5.c create mode 100644 FWLIB/src/stm32f4xx_hash_sha1.c create mode 100644 FWLIB/src/stm32f4xx_i2c.c create mode 100644 FWLIB/src/stm32f4xx_iwdg.c create mode 100644 FWLIB/src/stm32f4xx_ltdc.c create mode 100644 FWLIB/src/stm32f4xx_pwr.c create mode 100644 FWLIB/src/stm32f4xx_rcc.c create mode 100644 FWLIB/src/stm32f4xx_rng.c create mode 100644 FWLIB/src/stm32f4xx_rtc.c create mode 100644 FWLIB/src/stm32f4xx_sai.c create mode 100644 FWLIB/src/stm32f4xx_sdio.c create mode 100644 FWLIB/src/stm32f4xx_spi.c create mode 100644 FWLIB/src/stm32f4xx_syscfg.c create mode 100644 FWLIB/src/stm32f4xx_tim.c create mode 100644 FWLIB/src/stm32f4xx_usart.c create mode 100644 FWLIB/src/stm32f4xx_wwdg.c create mode 100644 FreeRTOS/croutine.c create mode 100644 FreeRTOS/event_groups.c create mode 100644 FreeRTOS/include/FreeRTOS.h create mode 100644 FreeRTOS/include/FreeRTOSConfig.h create mode 100644 FreeRTOS/include/StackMacros.h create mode 100644 FreeRTOS/include/croutine.h create mode 100644 FreeRTOS/include/deprecated_definitions.h create mode 100644 FreeRTOS/include/event_groups.h create mode 100644 FreeRTOS/include/list.h create mode 100644 FreeRTOS/include/mpu_prototypes.h create mode 100644 FreeRTOS/include/mpu_wrappers.h create mode 100644 FreeRTOS/include/portable.h create mode 100644 FreeRTOS/include/projdefs.h create mode 100644 FreeRTOS/include/queue.h create mode 100644 FreeRTOS/include/semphr.h create mode 100644 FreeRTOS/include/stdint.readme create mode 100644 FreeRTOS/include/task.h create mode 100644 FreeRTOS/include/timers.h create mode 100644 FreeRTOS/list.c create mode 100644 FreeRTOS/portable/Keil/See-also-the-RVDS-directory.txt create mode 100644 FreeRTOS/portable/MemMang/ReadMe.url create mode 100644 FreeRTOS/portable/MemMang/heap_1.c create mode 100644 FreeRTOS/portable/MemMang/heap_2.c create mode 100644 FreeRTOS/portable/MemMang/heap_3.c create mode 100644 FreeRTOS/portable/MemMang/heap_4.c create mode 100644 FreeRTOS/portable/MemMang/heap_5.c create mode 100644 FreeRTOS/portable/RVDS/ARM7_LPC21xx/port.c create mode 100644 FreeRTOS/portable/RVDS/ARM7_LPC21xx/portASM.s create mode 100644 FreeRTOS/portable/RVDS/ARM7_LPC21xx/portmacro.h create mode 100644 FreeRTOS/portable/RVDS/ARM7_LPC21xx/portmacro.inc create mode 100644 FreeRTOS/portable/RVDS/ARM_CA9/port.c create mode 100644 FreeRTOS/portable/RVDS/ARM_CA9/portASM.s create mode 100644 FreeRTOS/portable/RVDS/ARM_CA9/portmacro.h create mode 100644 FreeRTOS/portable/RVDS/ARM_CA9/portmacro.inc create mode 100644 FreeRTOS/portable/RVDS/ARM_CM0/port.c create mode 100644 FreeRTOS/portable/RVDS/ARM_CM0/portmacro.h create mode 100644 FreeRTOS/portable/RVDS/ARM_CM3/port.c create mode 100644 FreeRTOS/portable/RVDS/ARM_CM3/portmacro.h create mode 100644 FreeRTOS/portable/RVDS/ARM_CM4F/port.c create mode 100644 FreeRTOS/portable/RVDS/ARM_CM4F/portmacro.h create mode 100644 FreeRTOS/portable/RVDS/ARM_CM4_MPU/port.c create mode 100644 FreeRTOS/portable/RVDS/ARM_CM4_MPU/portmacro.h create mode 100644 FreeRTOS/portable/RVDS/ARM_CM7/ReadMe.txt create mode 100644 FreeRTOS/portable/RVDS/ARM_CM7/r0p1/port.c create mode 100644 FreeRTOS/portable/RVDS/ARM_CM7/r0p1/portmacro.h create mode 100644 FreeRTOS/portable/readme.txt create mode 100644 FreeRTOS/queue.c create mode 100644 FreeRTOS/readme.txt create mode 100644 FreeRTOS/tasks.c create mode 100644 FreeRTOS/timers.c create mode 100644 HARDWARE/DataScope_DP.C create mode 100644 HARDWARE/DataScope_DP.h create mode 100644 HARDWARE/LED.C create mode 100644 HARDWARE/LED.H create mode 100644 HARDWARE/MPU6050/I2C.c create mode 100644 HARDWARE/MPU6050/I2C.h create mode 100644 HARDWARE/MPU6050/MPU6050.c create mode 100644 HARDWARE/MPU6050/mpu6050.h create mode 100644 HARDWARE/adc.c create mode 100644 HARDWARE/adc.h create mode 100644 HARDWARE/can.c create mode 100644 HARDWARE/can.h create mode 100644 HARDWARE/dma.c create mode 100644 HARDWARE/dma.h create mode 100644 HARDWARE/encoder.c create mode 100644 HARDWARE/encoder.h create mode 100644 HARDWARE/exti.c create mode 100644 HARDWARE/exti.h create mode 100644 HARDWARE/key.c create mode 100644 HARDWARE/key.h create mode 100644 HARDWARE/motor.c create mode 100644 HARDWARE/motor.h create mode 100644 HARDWARE/oled.c create mode 100644 HARDWARE/oled.h create mode 100644 HARDWARE/oledfont.h create mode 100644 HARDWARE/pstwo.c create mode 100644 HARDWARE/pstwo.h create mode 100644 HARDWARE/stmflash.c create mode 100644 HARDWARE/stmflash.h create mode 100644 HARDWARE/timer.c create mode 100644 HARDWARE/timer.h create mode 100644 HARDWARE/usartx.c create mode 100644 HARDWARE/usartx.h create mode 100644 OBJ/ExtDll.iex create mode 100644 OBJ/OriginCar.axf create mode 100644 OBJ/OriginCar.build_log.htm create mode 100644 OBJ/OriginCar.hex create mode 100644 OBJ/OriginCar.htm create mode 100644 OBJ/OriginCar.lnp create mode 100644 OBJ/OriginCar.map create mode 100644 OBJ/OriginCar.sct create mode 100644 OBJ/OriginCar_FreeRTOS.dep create mode 100644 OBJ/adc.crf create mode 100644 OBJ/adc.d create mode 100644 OBJ/adc.o create mode 100644 OBJ/balance.crf create mode 100644 OBJ/balance.d create mode 100644 OBJ/balance.o create mode 100644 OBJ/can.crf create mode 100644 OBJ/can.d create mode 100644 OBJ/can.o create mode 100644 OBJ/croutine.crf create mode 100644 OBJ/croutine.d create mode 100644 OBJ/croutine.o create mode 100644 OBJ/delay.crf create mode 100644 OBJ/delay.d create mode 100644 OBJ/delay.o create mode 100644 OBJ/encoder.crf create mode 100644 OBJ/encoder.d create mode 100644 OBJ/encoder.o create mode 100644 OBJ/event_groups.crf create mode 100644 OBJ/event_groups.d create mode 100644 OBJ/event_groups.o create mode 100644 OBJ/heap_4.crf create mode 100644 OBJ/heap_4.d create mode 100644 OBJ/heap_4.o create mode 100644 OBJ/i2c.crf create mode 100644 OBJ/i2c.d create mode 100644 OBJ/i2c.o create mode 100644 OBJ/key.crf create mode 100644 OBJ/key.d create mode 100644 OBJ/key.o create mode 100644 OBJ/led.crf create mode 100644 OBJ/led.d create mode 100644 OBJ/led.o create mode 100644 OBJ/list.crf create mode 100644 OBJ/list.d create mode 100644 OBJ/list.o create mode 100644 OBJ/main.crf create mode 100644 OBJ/main.d create mode 100644 OBJ/main.o create mode 100644 OBJ/misc.crf create mode 100644 OBJ/misc.d create mode 100644 OBJ/misc.o create mode 100644 OBJ/motor.crf create mode 100644 OBJ/motor.d create mode 100644 OBJ/motor.o create mode 100644 OBJ/mpu6050.crf create mode 100644 OBJ/mpu6050.d create mode 100644 OBJ/mpu6050.o create mode 100644 OBJ/oled.crf create mode 100644 OBJ/oled.d create mode 100644 OBJ/oled.o create mode 100644 OBJ/port.crf create mode 100644 OBJ/port.d create mode 100644 OBJ/port.o create mode 100644 OBJ/pstwo.crf create mode 100644 OBJ/pstwo.d create mode 100644 OBJ/pstwo.o create mode 100644 OBJ/queue.crf create mode 100644 OBJ/queue.d create mode 100644 OBJ/queue.o create mode 100644 OBJ/robot_select_init.crf create mode 100644 OBJ/robot_select_init.d create mode 100644 OBJ/robot_select_init.o create mode 100644 OBJ/show.crf create mode 100644 OBJ/show.d create mode 100644 OBJ/show.o create mode 100644 OBJ/startup_stm32f40_41xxx.d create mode 100644 OBJ/startup_stm32f40_41xxx.lst create mode 100644 OBJ/startup_stm32f40_41xxx.o create mode 100644 OBJ/stm32f4xx_adc.crf create mode 100644 OBJ/stm32f4xx_adc.d create mode 100644 OBJ/stm32f4xx_adc.o create mode 100644 OBJ/stm32f4xx_can.crf create mode 100644 OBJ/stm32f4xx_can.d create mode 100644 OBJ/stm32f4xx_can.o create mode 100644 OBJ/stm32f4xx_gpio.crf create mode 100644 OBJ/stm32f4xx_gpio.d create mode 100644 OBJ/stm32f4xx_gpio.o create mode 100644 OBJ/stm32f4xx_it.crf create mode 100644 OBJ/stm32f4xx_it.d create mode 100644 OBJ/stm32f4xx_it.o create mode 100644 OBJ/stm32f4xx_pwr.crf create mode 100644 OBJ/stm32f4xx_pwr.d create mode 100644 OBJ/stm32f4xx_pwr.o create mode 100644 OBJ/stm32f4xx_rcc.crf create mode 100644 OBJ/stm32f4xx_rcc.d create mode 100644 OBJ/stm32f4xx_rcc.o create mode 100644 OBJ/stm32f4xx_syscfg.crf create mode 100644 OBJ/stm32f4xx_syscfg.d create mode 100644 OBJ/stm32f4xx_syscfg.o create mode 100644 OBJ/stm32f4xx_tim.crf create mode 100644 OBJ/stm32f4xx_tim.d create mode 100644 OBJ/stm32f4xx_tim.o create mode 100644 OBJ/stm32f4xx_usart.crf create mode 100644 OBJ/stm32f4xx_usart.d create mode 100644 OBJ/stm32f4xx_usart.o create mode 100644 OBJ/sys.crf create mode 100644 OBJ/sys.d create mode 100644 OBJ/sys.o create mode 100644 OBJ/system.crf create mode 100644 OBJ/system.d create mode 100644 OBJ/system.o create mode 100644 OBJ/system_stm32f4xx.crf create mode 100644 OBJ/system_stm32f4xx.d create mode 100644 OBJ/system_stm32f4xx.o create mode 100644 OBJ/tasks.crf create mode 100644 OBJ/tasks.d create mode 100644 OBJ/tasks.o create mode 100644 OBJ/timer.crf create mode 100644 OBJ/timer.d create mode 100644 OBJ/timer.o create mode 100644 OBJ/timers.crf create mode 100644 OBJ/timers.d create mode 100644 OBJ/timers.o create mode 100644 OBJ/usart.crf create mode 100644 OBJ/usart.d create mode 100644 OBJ/usart.o create mode 100644 OBJ/usartx.crf create mode 100644 OBJ/usartx.d create mode 100644 OBJ/usartx.o create mode 100644 SYSTEM/delay/delay.c create mode 100644 SYSTEM/delay/delay.h create mode 100644 SYSTEM/sys/sys.c create mode 100644 SYSTEM/sys/sys.h create mode 100644 SYSTEM/usart/usart.c create mode 100644 SYSTEM/usart/usart.h create mode 100644 USER/DebugConfig/FreeRTOS_STM32F407ZG.dbgconf create mode 100644 USER/EventRecorderStub.scvd create mode 100644 USER/JLinkSettings.ini create mode 100644 USER/OriginCar.uvguix.12459 create mode 100644 USER/OriginCar.uvguix.32892 create mode 100644 USER/OriginCar.uvoptx create mode 100644 USER/OriginCar.uvprojx create mode 100644 USER/main.c create mode 100644 USER/stm32f4xx.h create mode 100644 USER/stm32f4xx_conf.h create mode 100644 USER/stm32f4xx_it.c create mode 100644 USER/stm32f4xx_it.h create mode 100644 USER/system_stm32f4xx.c create mode 100644 USER/system_stm32f4xx.h create mode 100644 keilkilll.bat diff --git a/BALANCE/DataScope_DP.C b/BALANCE/DataScope_DP.C new file mode 100644 index 0000000..2d2ce81 --- /dev/null +++ b/BALANCE/DataScope_DP.C @@ -0,0 +1,90 @@ + +#include "DataScope_DP.h" + /************************************************************************** +作者：平衡小车之家 +我的淘宝小店：http://shop114407458.taobao.com/ +**************************************************************************/ +unsigned char DataScope_OutPut_Buffer[42] = {0}; //串口发送缓冲区 + + +//函数说明：将单精度浮点数据转成4字节数据并存入指定地址 +//附加说明：用户无需直接操作此函数 +//target:目标单精度数据 +//buf:待写入数组 +//beg:指定从数组第几个元素开始写入 +//函数无返回 +void Float2Byte(float *target,unsigned char *buf,unsigned char beg) +{ + unsigned char *point; + point = (unsigned char*)target; //得到float的地址 + buf[beg] = point[0]; + buf[beg+1] = point[1]; + buf[beg+2] = point[2]; + buf[beg+3] = point[3]; +} + + +//函数说明：将待发送通道的单精度浮点数据写入发送缓冲区 +//Data：通道数据 +//Channel：选择通道（1-10） +//函数无返回 +void DataScope_Get_Channel_Data(float Data,unsigned char Channel) +{ + if ( (Channel > 10) || (Channel == 0) ) return; //通道个数大于10或等于0，直接跳出，不执行函数 + else + { + switch (Channel) + { + case 1: Float2Byte(&Data,DataScope_OutPut_Buffer,1); break; + case 2: Float2Byte(&Data,DataScope_OutPut_Buffer,5); break; + case 3: Float2Byte(&Data,DataScope_OutPut_Buffer,9); break; + case 4: Float2Byte(&Data,DataScope_OutPut_Buffer,13); break; + case 5: Float2Byte(&Data,DataScope_OutPut_Buffer,17); break; + case 6: Float2Byte(&Data,DataScope_OutPut_Buffer,21); break; + case 7: Float2Byte(&Data,DataScope_OutPut_Buffer,25); break; + case 8: Float2Byte(&Data,DataScope_OutPut_Buffer,29); break; + case 9: Float2Byte(&Data,DataScope_OutPut_Buffer,33); break; + case 10: Float2Byte(&Data,DataScope_OutPut_Buffer,37); break; + } + } +} + + +//函数说明：生成 DataScopeV1.0 能正确识别的帧格式 +//Channel_Number，需要发送的通道个数 +//返回发送缓冲区数据个数 +//返回0表示帧格式生成失败 +unsigned char DataScope_Data_Generate(unsigned char Channel_Number) +{ + if ( (Channel_Number > 10) || (Channel_Number == 0) ) { return 0; } //通道个数大于10或等于0，直接跳出，不执行函数 + else + { + DataScope_OutPut_Buffer[0] = '$'; //帧头 + + switch(Channel_Number) + { + case 1: DataScope_OutPut_Buffer[5] = 5; return 6; + case 2: DataScope_OutPut_Buffer[9] = 9; return 10; + case 3: DataScope_OutPut_Buffer[13] = 13; return 14; + case 4: DataScope_OutPut_Buffer[17] = 17; return 18; + case 5: DataScope_OutPut_Buffer[21] = 21; return 22; + case 6: DataScope_OutPut_Buffer[25] = 25; return 26; + case 7: DataScope_OutPut_Buffer[29] = 29; return 30; + case 8: DataScope_OutPut_Buffer[33] = 33; return 34; + case 9: DataScope_OutPut_Buffer[37] = 37; return 38; + case 10: DataScope_OutPut_Buffer[41] = 41; return 42; + } + } + return 0; +} + + + + + + + + + + + diff --git a/BALANCE/DataScope_DP.h b/BALANCE/DataScope_DP.h new file mode 100644 index 0000000..30994c2 --- /dev/null +++ b/BALANCE/DataScope_DP.h @@ -0,0 +1,21 @@ + /************************************************************************** +作者：平衡小车之家 +我的淘宝小店：http://shop114407458.taobao.com/ +**************************************************************************/ + +#ifndef __DATA_PRTOCOL_H +#define __DATA_PRTOCOL_H + + +extern unsigned char DataScope_OutPut_Buffer[42]; //待发送帧数据缓存区 + + +void DataScope_Get_Channel_Data(float Data,unsigned char Channel); // 写通道数据至 待发送帧数据缓存区 + +unsigned char DataScope_Data_Generate(unsigned char Channel_Number); // 发送帧数据生成函数 + + +#endif + + + diff --git a/BALANCE/balance.c b/BALANCE/balance.c new file mode 100644 index 0000000..cb3aef2 --- /dev/null +++ b/BALANCE/balance.c @@ -0,0 +1,750 @@ +#include "balance.h" + +int Time_count=0; //Time variable //计时变量 + +// Robot mode is wrong to detect flag bits +//机器人模式是否出错检测标志位 +int robot_mode_check_flag=0; + +short test_num; + +Encoder OriginalEncoder; //Encoder raw data //编码器原始数据 + +u8 command_lost_count=0; //串口、CAN控制命令丢失时间计数，丢失1秒后停止控制 +/************************************************************************** +Function: The inverse kinematics solution is used to calculate the target speed of each wheel according to the target speed of three axes +Input : X and Y, Z axis direction of the target movement speed +Output : none +函数功能：运动学逆解，根据三轴目标速度计算各车轮目标转速 +入口参数：X和Y、Z轴方向的目标运动速度 +返回 值：无 +**************************************************************************/ +void Drive_Motor(float Vx,float Vy,float Vz) +{ + float amplitude=3.5; //Wheel target speed limit //车轮目标速度限幅 + + //Speed smoothing is enabled when moving the omnidirectional trolley + //全向移动小车才开启速度平滑处理 + if(Car_Mode==Mec_Car||Car_Mode==Omni_Car) + { + Smooth_control(Vx,Vy,Vz); //Smoothing the input speed //对输入速度进行平滑处理 + + //Get the smoothed data + //获取平滑处理后的数据 + Vx=smooth_control.VX; + Vy=smooth_control.VY; + Vz=smooth_control.VZ; + } + + //Mecanum wheel car + //麦克纳姆轮小车 + if (Car_Mode==Mec_Car) + { + //Inverse kinematics //运动学逆解 + MOTOR_A.Target = +Vy+Vx-Vz*(Axle_spacing+Wheel_spacing); + MOTOR_B.Target = -Vy+Vx-Vz*(Axle_spacing+Wheel_spacing); + MOTOR_C.Target = +Vy+Vx+Vz*(Axle_spacing+Wheel_spacing); + MOTOR_D.Target = -Vy+Vx+Vz*(Axle_spacing+Wheel_spacing); + + //Wheel (motor) target speed limit //车轮(电机)目标速度限幅 + MOTOR_A.Target=target_limit_float(MOTOR_A.Target,-amplitude,amplitude); + MOTOR_B.Target=target_limit_float(MOTOR_B.Target,-amplitude,amplitude); + MOTOR_C.Target=target_limit_float(MOTOR_C.Target,-amplitude,amplitude); + MOTOR_D.Target=target_limit_float(MOTOR_D.Target,-amplitude,amplitude); + } + + //Omni car + //全向轮小车 + else if (Car_Mode==Omni_Car) + { + //Inverse kinematics //运动学逆解 + MOTOR_A.Target = Vy + Omni_turn_radiaus*Vz; + MOTOR_B.Target = -X_PARAMETER*Vx - Y_PARAMETER*Vy + Omni_turn_radiaus*Vz; + MOTOR_C.Target = +X_PARAMETER*Vx - Y_PARAMETER*Vy + Omni_turn_radiaus*Vz; + + //Wheel (motor) target speed limit //车轮(电机)目标速度限幅 + MOTOR_A.Target=target_limit_float(MOTOR_A.Target,-amplitude,amplitude); + MOTOR_B.Target=target_limit_float(MOTOR_B.Target,-amplitude,amplitude); + MOTOR_C.Target=target_limit_float(MOTOR_C.Target,-amplitude,amplitude); + MOTOR_D.Target=0; //Out of use //没有使用到 + } + + //Ackermann structure car + //阿克曼小车 + else if (Car_Mode==Akm_Car) + { + //Ackerman car specific related variables //阿克曼小车专用相关变量 + float R, Ratio=636.56, AngleR, Angle_Servo; + + // For Ackerman small car, Vz represents the front wheel steering Angle + //对于阿克曼小车Vz代表右前轮转向角度 + AngleR=Vz; + R=Axle_spacing/tan(AngleR)-0.5f*Wheel_spacing; + //R=Axle_spacing/tan(AngleR); + + // Front wheel steering Angle limit (front wheel steering Angle controlled by steering engine), unit: rad + //前轮转向角度限幅(舵机控制前轮转向角度)，单位：rad + AngleR=target_limit_float(AngleR,-0.6f,0.6f); + + //Inverse kinematics //运动学逆解 + if(AngleR!=0) + { + MOTOR_A.Target = Vx*(R-0.5f*Wheel_spacing)/R; + MOTOR_B.Target = Vx*(R+0.5f*Wheel_spacing)/R; + } + else + { + MOTOR_A.Target = Vx; + MOTOR_B.Target = Vx; + } + // The PWM value of the servo controls the steering Angle of the front wheel + //舵机PWM值，舵机控制前轮转向角度 + + Angle_Servo = -0.628f*pow(AngleR, 3) + 1.269f*pow(AngleR, 2) - 1.772f*AngleR + 1.573f; + Servo=SERVO_INIT + (Angle_Servo - 1.572f)*Ratio; + // Servo=SERVO_INIT + (Angle_Servo)*Ratio; + //Wheel (motor) target speed limit //车轮(电机)目标速度限幅 + MOTOR_A.Target=target_limit_float(MOTOR_A.Target,-amplitude,amplitude); + MOTOR_B.Target=target_limit_float(MOTOR_B.Target,-amplitude,amplitude); + MOTOR_C.Target=0; //Out of use //没有使用到 + MOTOR_D.Target=0; //Out of use //没有使用到 + Servo=target_limit_int(Servo,800,2200); //Servo PWM value limit //舵机PWM值限幅 + } + + //Differential car + //差速小车 + else if (Car_Mode==Diff_Car) + { + //Inverse kinematics //运动学逆解 + MOTOR_A.Target = Vx - Vz * Wheel_spacing / 2.0f; //计算出左轮的目标速度 + MOTOR_B.Target = Vx + Vz * Wheel_spacing / 2.0f; //计算出右轮的目标速度 + + //Wheel (motor) target speed limit //车轮(电机)目标速度限幅 + MOTOR_A.Target=target_limit_float( MOTOR_A.Target,-amplitude,amplitude); + MOTOR_B.Target=target_limit_float( MOTOR_B.Target,-amplitude,amplitude); + MOTOR_C.Target=0; //Out of use //没有使用到 + MOTOR_D.Target=0; //Out of use //没有使用到 + } + + //FourWheel car + //四驱车 + else if(Car_Mode==FourWheel_Car) + { + //Inverse kinematics //运动学逆解 + MOTOR_A.Target = Vx - Vz * (Wheel_spacing + Axle_spacing) / 2.0f; //计算出左轮的目标速度 + MOTOR_B.Target = Vx - Vz * (Wheel_spacing + Axle_spacing) / 2.0f; //计算出左轮的目标速度 + MOTOR_C.Target = Vx + Vz * (Wheel_spacing + Axle_spacing) / 2.0f; //计算出右轮的目标速度 + MOTOR_D.Target = Vx + Vz * (Wheel_spacing + Axle_spacing) / 2.0f; //计算出右轮的目标速度 + + //Wheel (motor) target speed limit //车轮(电机)目标速度限幅 + MOTOR_A.Target=target_limit_float( MOTOR_A.Target,-amplitude,amplitude); + MOTOR_B.Target=target_limit_float( MOTOR_B.Target,-amplitude,amplitude); + MOTOR_C.Target=target_limit_float( MOTOR_C.Target,-amplitude,amplitude); + MOTOR_D.Target=target_limit_float( MOTOR_D.Target,-amplitude,amplitude); + } + + //Tank Car + //履带车 + else if (Car_Mode==Tank_Car) + { + //Inverse kinematics //运动学逆解 + MOTOR_A.Target = Vx - Vz * (Wheel_spacing) / 2.0f; //计算出左轮的目标速度 + MOTOR_B.Target = Vx + Vz * (Wheel_spacing) / 2.0f; //计算出右轮的目标速度 + + //Wheel (motor) target speed limit //车轮(电机)目标速度限幅 + MOTOR_A.Target=target_limit_float( MOTOR_A.Target,-amplitude,amplitude); + MOTOR_B.Target=target_limit_float( MOTOR_B.Target,-amplitude,amplitude); + MOTOR_C.Target=0; //Out of use //没有使用到 + MOTOR_D.Target=0; //Out of use //没有使用到 + } +} +/************************************************************************** +Function: FreerTOS task, core motion control task +Input : none +Output : none +函数功能：FreeRTOS任务，核心运动控制任务 +入口参数：无 +返回 值：无 +**************************************************************************/ +void Balance_task(void *pvParameters) +{ + u32 lastWakeTime = getSysTickCnt(); + + while(1) + { + // This task runs at a frequency of 100Hz (10ms control once) + //此任务以100Hz的频率运行（10ms控制一次） + vTaskDelayUntil(&lastWakeTime, F2T(RATE_100_HZ)); + + //Time count is no longer needed after 30 seconds + //时间计数，30秒后不再需要 + if(Time_count<3000)Time_count++; + + //Get the encoder data, that is, the real time wheel speed, + //and convert to transposition international units + //获取编码器数据，即车轮实时速度，并转换位国际单位 + Get_Velocity_Form_Encoder(); + + if(Check==0) //If self-check mode is not enabled //如果没有启动自检模式 + { +// command_lost_count++; //串口、CAN控制命令丢失时间计数，丢失1秒后停止控制 +// if(command_lost_count>RATE_100_HZ && APP_ON_Flag==0 && Remote_ON_Flag==0 && PS2_ON_Flag==0) //不是APP、PS2、航模遥控模式，就是CAN、串口1、串口3控制模式 +// Move_X=0, Move_Y=0, Move_Z=0; + + if (APP_ON_Flag) Get_RC(); //Handle the APP remote commands //处理APP遥控命令 + else if (Remote_ON_Flag) Remote_Control(); //Handle model aircraft remote commands //处理航模遥控命令 + else if (PS2_ON_Flag) PS2_control(); //Handle PS2 controller commands //处理PS2手柄控制命令 + + //CAN, Usart 1, Usart 3, Uart5 control can directly get the three axis target speed, + //without additional processing + //CAN、串口1、串口3(ROS)、串口5控制直接得到三轴目标速度，无须额外处理 + else Drive_Motor(Move_X, Move_Y, Move_Z); + + //Click the user button to update the gyroscope zero + //单击用户按键更新陀螺仪零点 + Key(); + + //If there is no abnormity in the battery voltage, and the enable switch is in the ON position, + //and the software failure flag is 0 + //如果电池电压不存在异常，而且使能开关在ON档位，而且软件失能标志位为0 + if(Turn_Off(Voltage)==0) + { + //Speed closed-loop control to calculate the PWM value of each motor, + //PWM represents the actual wheel speed + //速度闭环控制计算各电机PWM值，PWM代表车轮实际转速 + MOTOR_A.Motor_Pwm=Incremental_PI_A(MOTOR_A.Encoder, MOTOR_A.Target); + MOTOR_B.Motor_Pwm=Incremental_PI_B(MOTOR_B.Encoder, MOTOR_B.Target); + MOTOR_C.Motor_Pwm=Incremental_PI_C(MOTOR_C.Encoder, MOTOR_C.Target); + MOTOR_D.Motor_Pwm=Incremental_PI_D(MOTOR_D.Encoder, MOTOR_D.Target); + + Limit_Pwm(16700); + + //Set different PWM control polarity according to different car models + //根据不同小车型号设置不同的PWM控制极性 + switch(Car_Mode) + { + case Mec_Car: Set_Pwm( MOTOR_A.Motor_Pwm, -MOTOR_B.Motor_Pwm, -MOTOR_C.Motor_Pwm, MOTOR_D.Motor_Pwm, 0 ); break; //Mecanum wheel car //麦克纳姆轮小车 + case Omni_Car: Set_Pwm(-MOTOR_A.Motor_Pwm, MOTOR_B.Motor_Pwm, -MOTOR_C.Motor_Pwm, MOTOR_D.Motor_Pwm, 0 ); break; //Omni car //全向轮小车 + case Akm_Car: Set_Pwm( MOTOR_A.Motor_Pwm, MOTOR_B.Motor_Pwm, 16799,-16799 , Servo); break; //Ackermann structure car //阿克曼小车 + case Diff_Car: Set_Pwm( MOTOR_A.Motor_Pwm, MOTOR_B.Motor_Pwm, MOTOR_C.Motor_Pwm, MOTOR_D.Motor_Pwm, 0 ); break; //Differential car //两轮差速小车 + case FourWheel_Car: Set_Pwm( MOTOR_A.Motor_Pwm, -MOTOR_B.Motor_Pwm, -MOTOR_C.Motor_Pwm, MOTOR_D.Motor_Pwm, 0 ); break; //FourWheel car //四驱车 + case Tank_Car: Set_Pwm( MOTOR_A.Motor_Pwm, MOTOR_B.Motor_Pwm, MOTOR_C.Motor_Pwm, MOTOR_D.Motor_Pwm, 0 ); break; //Tank Car //履带车 + } + } + //If Turn_Off(Voltage) returns to 1, the car is not allowed to move, and the PWM value is set to 0 + //如果Turn_Off(Voltage)返回值为1，不允许控制小车进行运动，PWM值设置为0 + else Set_Pwm(0,0,0,0,0); + } + } +} +/************************************************************************** +Function: Assign a value to the PWM register to control wheel speed and direction +Input : PWM +Output : none +函数功能：赋值给PWM寄存器，控制车轮转速与方向 +入口参数：PWM +返回 值：无 +**************************************************************************/ +void Set_Pwm(int motor_a,int motor_b,int motor_c,int motor_d,int servo) +{ + //Forward and reverse control of motor + //电机正反转控制 + if(motor_a<0) PWMA1=16799,PWMA2=16799+motor_a; + else PWMA2=16799,PWMA1=16799-motor_a; + + //Forward and reverse control of motor + //电机正反转控制 + if(motor_b<0) PWMB1=16799,PWMB2=16799+motor_b; + else PWMB2=16799,PWMB1=16799-motor_b; +// PWMB1=10000,PWMB2=5000; + + //Forward and reverse control of motor + //电机正反转控制 + if(motor_c<0) PWMC1=16799,PWMC2=16799+motor_c; + else PWMC2=16799,PWMC1=16799-motor_c; + + //Forward and reverse control of motor + //电机正反转控制 + if(motor_d<0) PWMD1=16799,PWMD2=16799+motor_d; + else PWMD2=16799,PWMD1=16799-motor_d; + + //Servo control + //舵机控制 + Servo_PWM =servo; +} + +/************************************************************************** +Function: Limit PWM value +Input : Value +Output : none +函数功能：限制PWM值 +入口参数：幅值 +返回 值：无 +**************************************************************************/ +void Limit_Pwm(int amplitude) +{ + MOTOR_A.Motor_Pwm=target_limit_float(MOTOR_A.Motor_Pwm,-amplitude,amplitude); + MOTOR_B.Motor_Pwm=target_limit_float(MOTOR_B.Motor_Pwm,-amplitude,amplitude); + MOTOR_C.Motor_Pwm=target_limit_float(MOTOR_C.Motor_Pwm,-amplitude,amplitude); + MOTOR_D.Motor_Pwm=target_limit_float(MOTOR_D.Motor_Pwm,-amplitude,amplitude); +} +/************************************************************************** +Function: Limiting function +Input : Value +Output : none +函数功能：限幅函数 +入口参数：幅值 +返回 值：无 +**************************************************************************/ +float target_limit_float(float insert,float low,float high) +{ + if (insert < low) + return low; + else if (insert > high) + return high; + else + return insert; +} +int target_limit_int(int insert,int low,int high) +{ + if (insert < low) + return low; + else if (insert > high) + return high; + else + return insert; +} +/************************************************************************** +Function: Check the battery voltage, enable switch status, software failure flag status +Input : Voltage +Output : Whether control is allowed, 1: not allowed, 0 allowed +函数功能：检查电池电压、使能开关状态、软件失能标志位状态 +入口参数：电压 +返回 值：是否允许控制，1：不允许，0允许 +**************************************************************************/ +u8 Turn_Off( int voltage) +{ + u8 temp; + if(voltage<10||EN==0||Flag_Stop==1) + { + temp=1; + PWMA1=0;PWMA2=0; + PWMB1=0;PWMB2=0; + PWMC1=0;PWMC1=0; + PWMD1=0;PWMD2=0; + } + else + temp=0; + return temp; +} +/************************************************************************** +Function: Calculate absolute value +Input : long int +Output : unsigned int +函数功能：求绝对值 +入口参数：long int +返回 值：unsigned int +**************************************************************************/ +u32 myabs(long int a) +{ + u32 temp; + if(a<0) temp=-a; + else temp=a; + return temp; +} +/************************************************************************** +Function: Incremental PI controller +Input : Encoder measured value (actual speed), target speed +Output : Motor PWM +According to the incremental discrete PID formula +pwm+=Kp[e（k）-e(k-1)]+Ki*e(k)+Kd[e(k)-2e(k-1)+e(k-2)] +e(k) represents the current deviation +e(k-1) is the last deviation and so on +PWM stands for incremental output +In our speed control closed loop system, only PI control is used +pwm+=Kp[e（k）-e(k-1)]+Ki*e(k) + +函数功能：增量式PI控制器 +入口参数：编码器测量值(实际速度)，目标速度 +返回 值：电机PWM +根据增量式离散PID公式 +pwm+=Kp[e（k）-e(k-1)]+Ki*e(k)+Kd[e(k)-2e(k-1)+e(k-2)] +e(k)代表本次偏差 +e(k-1)代表上一次的偏差 以此类推 +pwm代表增量输出 +在我们的速度控制闭环系统里面，只使用PI控制 +pwm+=Kp[e（k）-e(k-1)]+Ki*e(k) +**************************************************************************/ +int Incremental_PI_A (float Encoder,float Target) +{ + static float Bias,Pwm,Last_bias; + Bias=Target-Encoder; //Calculate the deviation //计算偏差 + Pwm+=Velocity_KP*(Bias-Last_bias)+Velocity_KI*Bias; + if(Pwm>16700)Pwm=16700; + if(Pwm<-16700)Pwm=-16700; + Last_bias=Bias; //Save the last deviation //保存上一次偏差 + return Pwm; +} +int Incremental_PI_B (float Encoder,float Target) +{ + static float Bias,Pwm,Last_bias; + Bias=Target-Encoder; //Calculate the deviation //计算偏差 + Pwm+=Velocity_KP*(Bias-Last_bias)+Velocity_KI*Bias; + if(Pwm>16700)Pwm=16700; + if(Pwm<-16700)Pwm=-16700; + Last_bias=Bias; //Save the last deviation //保存上一次偏差 + return Pwm; +} +int Incremental_PI_C (float Encoder,float Target) +{ + static float Bias,Pwm,Last_bias; + Bias=Target-Encoder; //Calculate the deviation //计算偏差 + Pwm+=Velocity_KP*(Bias-Last_bias)+Velocity_KI*Bias; + if(Pwm>16700)Pwm=16700; + if(Pwm<-16700)Pwm=-16700; + Last_bias=Bias; //Save the last deviation //保存上一次偏差 + return Pwm; +} +int Incremental_PI_D (float Encoder,float Target) +{ + static float Bias,Pwm,Last_bias; + Bias=Target-Encoder; //Calculate the deviation //计算偏差 + Pwm+=Velocity_KP*(Bias-Last_bias)+Velocity_KI*Bias; + if(Pwm>16700)Pwm=16700; + if(Pwm<-16700)Pwm=-16700; + Last_bias=Bias; //Save the last deviation //保存上一次偏差 + return Pwm; +} +/************************************************************************** +Function: Processes the command sent by APP through usart 2 +Input : none +Output : none +函数功能：对APP通过串口2发送过来的命令进行处理 +入口参数：无 +返回 值：无 +**************************************************************************/ +void Get_RC(void) +{ + u8 Flag_Move=1; + if(Car_Mode==Mec_Car||Car_Mode==Omni_Car) //The omnidirectional wheel moving trolley can move laterally //全向轮运动小车可以进行横向移动 + { + switch(Flag_Direction) //Handle direction control commands //处理方向控制命令 + { + case 1: Move_X=RC_Velocity; Move_Y=0; Flag_Move=1; break; + case 2: Move_X=RC_Velocity; Move_Y=-RC_Velocity; Flag_Move=1; break; + case 3: Move_X=0; Move_Y=-RC_Velocity; Flag_Move=1; break; + case 4: Move_X=-RC_Velocity; Move_Y=-RC_Velocity; Flag_Move=1; break; + case 5: Move_X=-RC_Velocity; Move_Y=0; Flag_Move=1; break; + case 6: Move_X=-RC_Velocity; Move_Y=RC_Velocity; Flag_Move=1; break; + case 7: Move_X=0; Move_Y=RC_Velocity; Flag_Move=1; break; + case 8: Move_X=RC_Velocity; Move_Y=RC_Velocity; Flag_Move=1; break; + default: Move_X=0; Move_Y=0; Flag_Move=0; break; + } + if(Flag_Move==0) + { + //If no direction control instruction is available, check the steering control status + //如果无方向控制指令，检查转向控制状态 + if (Flag_Left ==1) Move_Z= PI/2*(RC_Velocity/500); //left rotation //左自转 + else if(Flag_Right==1) Move_Z=-PI/2*(RC_Velocity/500); //right rotation //右自转 + else Move_Z=0; //stop //停止 + } + } + else //Non-omnidirectional moving trolley //非全向移动小车 + { + switch(Flag_Direction) //Handle direction control commands //处理方向控制命令 + { + case 1: Move_X=+RC_Velocity; Move_Z=0; break; + case 2: Move_X=+RC_Velocity; Move_Z=-PI/2; break; + case 3: Move_X=0; Move_Z=-PI/2; break; + case 4: Move_X=-RC_Velocity; Move_Z=-PI/2; break; + case 5: Move_X=-RC_Velocity; Move_Z=0; break; + case 6: Move_X=-RC_Velocity; Move_Z=+PI/2; break; + case 7: Move_X=0; Move_Z=+PI/2; break; + case 8: Move_X=+RC_Velocity; Move_Z=+PI/2; break; + default: Move_X=0; Move_Z=0; break; + } + if (Flag_Left ==1) Move_Z= PI/2; //left rotation //左自转 + else if(Flag_Right==1) Move_Z=-PI/2; //right rotation //右自转 + } + + //Z-axis data conversion //Z轴数据转化 + if(Car_Mode==Akm_Car) + { + //Ackermann structure car is converted to the front wheel steering Angle system target value, and kinematics analysis is pearformed + //阿克曼结构小车转换为前轮转向角度 + Move_Z=Move_Z*2/9; + } + else if(Car_Mode==Diff_Car||Car_Mode==Tank_Car||Car_Mode==FourWheel_Car) + { + if(Move_X<0) Move_Z=-Move_Z; //The differential control principle series requires this treatment //差速控制原理系列需要此处理 + Move_Z=Move_Z*RC_Velocity/500; + } + + //Unit conversion, mm/s -> m/s + //单位转换，mm/s -> m/s + Move_X=Move_X/1000; Move_Y=Move_Y/1000; Move_Z=Move_Z; + + //Control target value is obtained and kinematics analysis is performed + //得到控制目标值，进行运动学分析 + Drive_Motor(Move_X,Move_Y,Move_Z); +} + +/************************************************************************** +Function: Handle PS2 controller control commands +Input : none +Output : none +函数功能：对PS2手柄控制命令进行处理 +入口参数：无 +返回 值：无 +**************************************************************************/ +void PS2_control(void) +{ + int LX,LY,RY; + int Threshold=20; //Threshold to ignore small movements of the joystick //阈值，忽略摇杆小幅度动作 + + //128 is the median.The definition of X and Y in the PS2 coordinate system is different from that in the ROS coordinate system + //128为中值。PS2坐标系与ROS坐标系对X、Y的定义不一样 + LY=-(PS2_LX-128); + LX=-(PS2_LY-128); + RY=-(PS2_RX-128); + + //Ignore small movements of the joystick //忽略摇杆小幅度动作 + if(LX>-Threshold&&LX-Threshold&&LY-Threshold&&RY m/s + //单位转换，mm/s -> m/s + Move_X=Move_X/1000; + Move_Y=Move_Y/1000; + Move_Z=Move_Z; + + //Control target value is obtained and kinematics analysis is performed + //得到控制目标值，进行运动学分析 + Drive_Motor(Move_X,Move_Y,Move_Z); +} + +/************************************************************************** +Function: The remote control command of model aircraft is processed +Input : none +Output : none +函数功能：对航模遥控控制命令进行处理 +入口参数：无 +返回 值：无 +**************************************************************************/ +void Remote_Control(void) +{ + //Data within 1 second after entering the model control mode will not be processed + //对进入航模控制模式后1秒内的数据不处理 + static u8 thrice=100; + int Threshold=100; //Threshold to ignore small movements of the joystick //阈值，忽略摇杆小幅度动作 + + //limiter //限幅 + int LX,LY,RY,RX,Remote_RCvelocity; + Remoter_Ch1=target_limit_int(Remoter_Ch1,1000,2000); + Remoter_Ch2=target_limit_int(Remoter_Ch2,1000,2000); + Remoter_Ch3=target_limit_int(Remoter_Ch3,1000,2000); + Remoter_Ch4=target_limit_int(Remoter_Ch4,1000,2000); + + // Front and back direction of left rocker. Control forward and backward. + //左摇杆前后方向。控制前进后退。 + LX=Remoter_Ch2-1500; + + //Left joystick left and right.Control left and right movement. Only the wheelie omnidirectional wheelie will use the channel. + //Ackerman trolleys use this channel as a PWM output to control the steering gear + //左摇杆左右方向。控制左右移动。麦轮全向轮才会使用到改通道。阿克曼小车使用该通道作为PWM输出控制舵机 + LY=Remoter_Ch4-1500; + + //Front and back direction of right rocker. Throttle/acceleration/deceleration. + //右摇杆前后方向。油门/加减速。 + RX=Remoter_Ch3-1500; + + //Right stick left and right. To control the rotation. + //右摇杆左右方向。控制自转。 + RY=Remoter_Ch1-1500; + + if(LX>-Threshold&&LX-Threshold&&LY-Threshold&&RX-Threshold&&RY m/s + //单位转换，mm/s -> m/s + Move_X=Move_X/1000; + Move_Y=Move_Y/1000; + Move_Z=Move_Z; + + //Data within 1 second after entering the model control mode will not be processed + //对进入航模控制模式后1秒内的数据不处理 + if(thrice>0) Move_X=0,Move_Z=0,thrice--; + + //Control target value is obtained and kinematics analysis is performed + //得到控制目标值，进行运动学分析 + Drive_Motor(Move_X,Move_Y,Move_Z); +} +/************************************************************************** +Function: Click the user button to update gyroscope zero +Input : none +Output : none +函数功能：单击用户按键更新陀螺仪零点 +入口参数：无 +返回 值：无 +**************************************************************************/ +void Key(void) +{ + u8 tmp; + tmp=click_N_Double_MPU6050(50); + if(tmp==2)memcpy(Deviation_gyro,Original_gyro,sizeof(gyro)),memcpy(Deviation_accel,Original_accel,sizeof(accel)); +} +/************************************************************************** +Function: Read the encoder value and calculate the wheel speed, unit m/s +Input : none +Output : none +函数功能：读取编码器数值并计算车轮速度，单位m/s +入口参数：无 +返回 值：无 +**************************************************************************/ +void Get_Velocity_Form_Encoder(void) +{ + //Retrieves the original data of the encoder + //获取编码器的原始数据 + float Encoder_A_pr,Encoder_B_pr,Encoder_C_pr,Encoder_D_pr; + OriginalEncoder.A=Read_Encoder(2); + OriginalEncoder.B=Read_Encoder(3); + OriginalEncoder.C=Read_Encoder(4); + OriginalEncoder.D=Read_Encoder(5); + + //test_num=OriginalEncoder.B; + + //Decide the encoder numerical polarity according to different car models + //根据不同小车型号决定编码器数值极性 + switch(Car_Mode) + { + case Mec_Car: Encoder_A_pr= OriginalEncoder.A; Encoder_B_pr= OriginalEncoder.B; Encoder_C_pr=-OriginalEncoder.C; Encoder_D_pr=-OriginalEncoder.D; break; + case Omni_Car: Encoder_A_pr=-OriginalEncoder.A; Encoder_B_pr=-OriginalEncoder.B; Encoder_C_pr=-OriginalEncoder.C; Encoder_D_pr=-OriginalEncoder.D; break; + case Akm_Car: Encoder_A_pr= OriginalEncoder.A; Encoder_B_pr=-OriginalEncoder.B; Encoder_C_pr= OriginalEncoder.C; Encoder_D_pr= OriginalEncoder.D; break; + case Diff_Car: Encoder_A_pr= OriginalEncoder.A; Encoder_B_pr=-OriginalEncoder.B; Encoder_C_pr= OriginalEncoder.C; Encoder_D_pr= OriginalEncoder.D; break; + case FourWheel_Car: Encoder_A_pr= OriginalEncoder.A; Encoder_B_pr= OriginalEncoder.B; Encoder_C_pr=-OriginalEncoder.C; Encoder_D_pr=-OriginalEncoder.D; break; + case Tank_Car: Encoder_A_pr= OriginalEncoder.A; Encoder_B_pr=-OriginalEncoder.B; Encoder_C_pr= OriginalEncoder.C; Encoder_D_pr= OriginalEncoder.D; break; + } + + //The encoder converts the raw data to wheel speed in m/s + //编码器原始数据转换为车轮速度，单位m/s + MOTOR_A.Encoder= Encoder_A_pr*CONTROL_FREQUENCY*Wheel_perimeter/Encoder_precision; + MOTOR_B.Encoder= Encoder_B_pr*CONTROL_FREQUENCY*Wheel_perimeter/Encoder_precision; + MOTOR_C.Encoder= Encoder_C_pr*CONTROL_FREQUENCY*Wheel_perimeter/Encoder_precision; + MOTOR_D.Encoder= Encoder_D_pr*CONTROL_FREQUENCY*Wheel_perimeter/Encoder_precision; +} +/************************************************************************** +Function: Smoothing the three axis target velocity +Input : Three-axis target velocity +Output : none +函数功能：对三轴目标速度做平滑处理 +入口参数：三轴目标速度 +返回 值：无 +**************************************************************************/ +void Smooth_control(float vx,float vy,float vz) +{ + float step=0.01; + + if (vx>0) smooth_control.VX+=step; + else if(vx<0) smooth_control.VX-=step; + else if(vx==0) smooth_control.VX=smooth_control.VX*0.9f; + + if (vy>0) smooth_control.VY+=step; + else if(vy<0) smooth_control.VY-=step; + else if(vy==0) smooth_control.VY=smooth_control.VY*0.9f; + + if (vz>0) smooth_control.VZ+=step; + else if(vz<0) smooth_control.VZ-=step; + else if(vz==0) smooth_control.VZ=smooth_control.VZ*0.9f; + + smooth_control.VX=target_limit_float(smooth_control.VX,-float_abs(vx),float_abs(vx)); + smooth_control.VY=target_limit_float(smooth_control.VY,-float_abs(vy),float_abs(vy)); + smooth_control.VZ=target_limit_float(smooth_control.VZ,-float_abs(vz),float_abs(vz)); +} +/************************************************************************** +Function: Floating-point data calculates the absolute value +Input : float +Output : The absolute value of the input number +函数功能：浮点型数据计算绝对值 +入口参数：浮点数 +返回 值：输入数的绝对值 +**************************************************************************/ +float float_abs(float insert) +{ + if(insert>=0) return insert; + else return -insert; +} +/************************************************************************** +Function: Prevent the potentiometer to choose the wrong mode, resulting in initialization error caused by the motor spinning.Out of service +Input : none +Output : none +函数功能：防止电位器选错模式，导致初始化出错引发电机乱转。已停止使用 +入口参数：无 +返回 值：无 +**************************************************************************/ +void robot_mode_check(void) +{ + static u8 error=0; + + if(abs(MOTOR_A.Motor_Pwm)>2500||abs(MOTOR_B.Motor_Pwm)>2500||abs(MOTOR_C.Motor_Pwm)>2500||abs(MOTOR_D.Motor_Pwm)>2500) error++; + //If the output is close to full amplitude for 6 times in a row, it is judged that the motor rotates wildly and makes the motor incapacitated + //如果连续6次接近满幅输出，判断为电机乱转，让电机失能 + if(error>6) EN=0,Flag_Stop=1,robot_mode_check_flag=1; +} diff --git a/BALANCE/balance.h b/BALANCE/balance.h new file mode 100644 index 0000000..eb7c51b --- /dev/null +++ b/BALANCE/balance.h @@ -0,0 +1,39 @@ +#ifndef __BALANCE_H +#define __BALANCE_H +#include "sys.h" +#include "system.h" + +#define BALANCE_TASK_PRIO 4 //Task priority //任务优先级 +#define BALANCE_STK_SIZE 512 //Task stack size //任务堆栈大小 + +//Parameter of kinematics analysis of omnidirectional trolley +//全向轮小车运动学分析参数 +#define X_PARAMETER (sqrt(3)/2.f) +#define Y_PARAMETER (0.5f) +#define L_PARAMETER (1.0f) + +extern short test_num; +extern int robot_mode_check_flag; +extern u8 command_lost_count; //串口、CAN控制命令丢失时间计数，丢失1秒后停止控制 +void Balance_task(void *pvParameters); +void Set_Pwm(int motor_a,int motor_b,int motor_c,int motor_d,int servo); +void Limit_Pwm(int amplitude); +float target_limit_float(float insert,float low,float high); +int target_limit_int(int insert,int low,int high); +u8 Turn_Off( int voltage); +u32 myabs(long int a); +int Incremental_PI_A (float Encoder,float Target); +int Incremental_PI_B (float Encoder,float Target); +int Incremental_PI_C (float Encoder,float Target); +int Incremental_PI_D (float Encoder,float Target); +void Get_RC(void); +void Remote_Control(void); +void Drive_Motor(float Vx,float Vy,float Vz); +void Key(void); +void Get_Velocity_Form_Encoder(void); +void Smooth_control(float vx,float vy,float vz); +void PS2_control(void); +float float_abs(float insert); +void robot_mode_check(void); +#endif + diff --git a/BALANCE/control.c b/BALANCE/control.c new file mode 100644 index 0000000..4540e71 --- /dev/null +++ b/BALANCE/control.c @@ -0,0 +1,259 @@ +#include "control.h" +#include "filter.h" + /************************************************************************** +作者：平衡小车之家 +我的淘宝小店：http://shop114407458.taobao.com/ +**************************************************************************/ + +u8 Flag_Target,Flag_Change; //相关标志位 +u8 temp1; //临时变量 +float Voltage_Count,Voltage_All; //电压采样相关变量 +float Gyro_K=0.004; //陀螺仪比例系数 +int j; +#define a_PARAMETER (0.275f) +#define T 0.320f //0.145f +#define L 0.315f //0.17f +#define K 570.8f +/************************************************************************** +函数功能：小车运动数学模型 +入口参数：Y轴速度和角度 +返回 值：无 +**************************************************************************/ +void Kinematic_Analysis(float Vy,float angle) +{ + Target_A = Vy*(1+T*tan(angle)/2/L); + Target_B = Vy*(1-T*tan(angle)/2/L); + Servo=SERVO_INIT-angle*K; +} +/************************************************************************** +函数功能：所有的控制代码都在这里面 + 5ms定时中断由MPU6050的INT引脚触发 + 严格保证采样和数据处理的时间同步 +**************************************************************************/ +int EXTI15_10_IRQHandler(void) +{ + if(INT==0) + { + EXTI->PR=1<<15; //清除LINE5上的中断标志位 + Flag_Target=!Flag_Target; + if(delay_flag==1) + { + if(++delay_50==10) delay_50=0,delay_flag=0; //给主函数提供50ms的精准延时 + } + if(Flag_Target==1) //5ms读取一次陀螺仪和加速度计的值 + { + if(Usart_Flag==0&&PS2_ON_Flag==0&&Usart_ON_Flag==1) memcpy(rxbuf,Urxbuf,8*sizeof(u8)); //如果解锁了串口控制标志位，进入串口控制模式 + Read_DMP(); //===更新姿态 + Key();//扫描按键变化 + return 0; + } //===10ms控制一次，为了保证M法测速的时间基准，首先读取编码器数据 + UA_Encoder=Read_Encoder(2); //===读取编码器的值 + Encoder_A=UA_Encoder/25; + Position_A+=Encoder_A; //===积分得到速度 + UB_Encoder=-Read_Encoder(3); //===读取编码器的值 + Encoder_B=UB_Encoder/25; + Position_B+=Encoder_B; //===积分得到速度 + Read_DMP(); //===更新姿态 + Led_Flash(100); //===LED闪烁;常规模式 1s改变一次指示灯的状态 + Voltage_All+=Get_battery_volt(); //多次采样累积 + if(++Voltage_Count==100) Voltage=Voltage_All/100,Voltage_All=0,Voltage_Count=0;//求平均值 获取电池电压 + if(PS2_KEY==4)PS2_ON_Flag=1,CAN_ON_Flag=0,Usart_ON_Flag=0; + if(CAN_ON_Flag==1||Usart_ON_Flag==1||PS2_ON_Flag==1) CAN_N_Usart_Control(); //接到串口或者CAN遥控解锁指令之后，使能CAN和串口控制输入 + if(RC_Velocity>0&&RC_Velocity<15) RC_Velocity=15; //避免电机进入低速非线性区 + if(Turn_Off(Voltage)==0) //===如果电池电压不存在异常 + { + if(CAN_ON_Flag==0&&Usart_ON_Flag==0&&PS2_ON_Flag==0) Get_RC(Run_Flag);//===串口和CAN控制都未使能，则接收蓝牙遥控指 + Motor_A=Incremental_PI_A(Encoder_A,Target_A); //===速度闭环控制计算电机A最终PWM + Motor_B=Incremental_PI_B(Encoder_B,Target_B); //===速度闭环控制计算电机B最终PWM + Xianfu_Pwm(6900); //===PWM限幅 + Set_Pwm(-Motor_A,-Motor_B,Servo); //===赋值给PWM寄存器 + } + else Set_Pwm(0,0,SERVO_INIT); //===赋值给PWM寄存器 + } + return 0; +} + + +/************************************************************************** +函数功能：赋值给PWM寄存器 +入口参数：PWM +返回 值：无 +**************************************************************************/ +void Set_Pwm(int motor_a,int motor_b,int servo) +{ + + if(motor_a<0) INA2=1, INA1=0; + else INA2=0, INA1=1; + PWMA=myabs(motor_a); + + if(motor_b<0) INB2=1, INB1=0; + else INB2=0, INB1=1; + PWMB=myabs(motor_b); + SERVO=servo; + +} + +/************************************************************************** +函数功能：限制PWM赋值 +入口参数：幅值 +返回 值：无 +**************************************************************************/ +void Xianfu_Pwm(int amplitude) +{ + if(Motor_A<-amplitude) Motor_A=-amplitude; + if(Motor_A>amplitude) Motor_A=amplitude; + if(Motor_B<-amplitude) Motor_B=-amplitude; + if(Motor_B>amplitude) Motor_B=amplitude; + if (Servo>1930) Servo=1930; +// if (Servo<1035) Servo=1035; +} +/************************************************************************** +函数功能：位置PID控制过程中速度的设置 +入口参数：无、幅值 +返回 值：无 +**************************************************************************/ +void Xianfu_Velocity(int amplitude_A,int amplitude_B,int amplitude_C,int amplitude_D) +{ + if(Motor_A<-amplitude_A) Motor_A=-amplitude_A; //位置控制模式中，A电机的运行速度 + if(Motor_A>amplitude_A) Motor_A=amplitude_A; //位置控制模式中，A电机的运行速度 + if(Motor_B<-amplitude_B) Motor_B=-amplitude_B; //位置控制模式中，B电机的运行速度 + if(Motor_B>amplitude_B) Motor_B=amplitude_B; //位置控制模式中，B电机的运行速度 +} +/************************************************************************** +函数功能：按键修改小车运行状态 +入口参数：无 +返回 值：无 +**************************************************************************/ +void Key(void) +{ + u8 tmp; + tmp=click_N_Double(100); + if(tmp==2)Flag_Show=!Flag_Show;//双击控制显示模式 +} + +/************************************************************************** +函数功能：异常关闭电机 +入口参数：电压 +返回 值：1：异常 0：正常 +**************************************************************************/ +u8 Turn_Off( int voltage) +{ + u8 temp; + if(voltage<1110)//电池电压过低关闭电机 + { + temp=1; + PWMA=0; + PWMB=0; + } + else + temp=0; + return temp; +} + +/************************************************************************** +函数功能：绝对值函数 +入口参数：long int +返回 值：unsigned int +**************************************************************************/ +u32 myabs(long int a) +{ + u32 temp; + if(a<0) temp=-a; + else temp=a; + return temp; +} +/************************************************************************** +函数功能：增量PI控制器 +入口参数：编码器测量值，目标速度 +返回 值：电机PWM +根据增量式离散PID公式 +pwm+=Kp[e（k）-e(k-1)]+Ki*e(k)+Kd[e(k)-2e(k-1)+e(k-2)] +e(k)代表本次偏差 +e(k-1)代表上一次的偏差 以此类推 +pwm代表增量输出 +在我们的速度控制闭环系统里面，只使用PI控制 +pwm+=Kp[e（k）-e(k-1)]+Ki*e(k) +**************************************************************************/ +int Incremental_PI_A (int Encoder,int Target) +{ + static int Bias,Pwm,Last_bias; + Bias=Encoder-Target; //计算偏差 + Pwm+=Velocity_KP*(Bias-Last_bias)+Velocity_KI*Bias; //增量式PI控制器 + if(Pwm>7200)Pwm=7200; + if(Pwm<-7200)Pwm=-7200; + Last_bias=Bias; //保存上一次偏差 + return Pwm; //增量输出 +} +int Incremental_PI_B (int Encoder,int Target) +{ + static int Bias,Pwm,Last_bias; + Bias=Encoder-Target; //计算偏差 + Pwm+=Velocity_KP*(Bias-Last_bias)+Velocity_KI*Bias; //增量式PI控制器 + if(Pwm>7200)Pwm=7200; + if(Pwm<-7200)Pwm=-7200; + Last_bias=Bias; //保存上一次偏差 + return Pwm; //增量输出 +} + +/************************************************************************** +函数功能：通过串口指令对小车进行遥控 +入口参数：串口指令 +返回 值：无 +**************************************************************************/ +void Get_RC(u8 mode) +{ +// float step=0.3f; //设置速度控制步进值。 + if(mode==0)//速度 + { + switch(Flag_Direction) //方向控制 + { + case 1: Move_Y=RC_Velocity; Angle=0; break; + case 2: Move_Y=RC_Velocity; Angle=PI/4; break; + case 3: Move_Y=0; Angle=0; break; + case 4: Move_Y=-RC_Velocity; Angle=-PI/4; break; + case 5: Move_Y=-RC_Velocity; Angle=0; break; + case 6: Move_Y=-RC_Velocity; Angle=PI/4; break; + case 7: Move_Y=0; Angle=0; break; + case 8: Move_Y=+RC_Velocity; Angle=-PI/4; break; + default: Move_Y=0; Angle=0; break; + } +// if(Move_Y<-RC_Velocity) Move_Y=-RC_Velocity; +// if(Move_Y>RC_Velocity) Move_Y=RC_Velocity; +// if(Angle<-RC_Velocity) Angle=-RC_Velocity; +// if(Angle>RC_Velocity) Angle=RC_Velocity; + } + Kinematic_Analysis(Move_Y,Angle);//得到控制目标值，进行运动学分析 +} + +/************************************************************************** +函数功能：接收CAN或者串口控制指令进行处理 +入口参数：无 +返回 值：无 +**************************************************************************/ +void CAN_N_Usart_Control(void) +{ +// int flag_1, flag_2; + int RX,LY; + int Yuzhi=20; + if(CAN_ON_Flag==1||Usart_ON_Flag==1) + { +// if(rxbuf[1])flag_1=1; else flag_1=-1; //方向控制位 +// if(rxbuf[3])flag_2=1; else flag_2=-1; //方向控制位 +// Target_A=flag_1*rxbuf[0]; +// Target_B=flag_2*rxbuf[1]; + if(rxbuf[1]==0)Move_Y=rxbuf[0]; //识别运动方向 + else Move_Y=-rxbuf[0]; //速度 + Angle=(rxbuf[2]-90)*PI/180; //角度获取 + } + else if (PS2_ON_Flag==1) + { + RX=PS2_RX-128; + LY=PS2_LY-128; + if(RX>-Yuzhi&&RX-Yuzhi&&LY5)Car_Mode=5; + + //Car_Mode=0; + + switch(Car_Mode) + { + case Mec_Car: Robot_Init(MEC_wheelspacing, MEC_axlespacing, 0, HALL_30F, Hall_13, Mecanum_75); break; //麦克纳姆轮小车 + case Omni_Car: Robot_Init(0, 0, Omni_Turn_Radiaus_109, HALL_30F, Hall_13, FullDirecion_60); break; //全向轮小车 + case Akm_Car: Robot_Init(Akm_wheelspacing, Akm_axlespacing, 0, HALL_30F, Hall_13, Black_WheelDiameter); break; //阿克曼小车 + case Diff_Car: Robot_Init(Diff_wheelSpacing, 0, 0, HALL_30F, Hall_13, Black_WheelDiameter); break; //两轮差速小车 + case FourWheel_Car: Robot_Init(Four_Mortor_wheelSpacing, Four_Mortor__axlespacing, 0, HALL_30F, Hall_13, Black_WheelDiameter); break; //四驱车 + case Tank_Car: Robot_Init(Tank_wheelSpacing, 0, 0, HALL_30F, Hall_13, Tank_WheelDiameter); break; //履带车 + } + + + //Check the parameters//自检相关参数 + switch(Car_Mode) + { + case Mec_Car: CheckPhrase1=8, CheckPhrase2=14; break; //麦克纳姆轮小车 + case Omni_Car: CheckPhrase1=6, CheckPhrase2=10; break; //全向轮小车 + case Akm_Car: CheckPhrase1=4, CheckPhrase2=7; break; //阿克曼小车 + case Diff_Car: CheckPhrase1=4, CheckPhrase2=7; break; //两轮差速小车 + case FourWheel_Car: CheckPhrase1=8, CheckPhrase2=11; break; //四驱车 + case Tank_Car: CheckPhrase1=4, CheckPhrase2=7; break; //履带车 + } +} + +/************************************************************************** +Function: Initialize cart parameters +Input : wheelspacing, axlespacing, omni_rotation_radiaus, motor_gear_ratio, Number_of_encoder_lines, tyre_diameter +Output : none +函数功能：初始化小车参数 +入口参数：轮距 轴距 自转半径 电机减速比 电机编码器精度 轮胎直径 +返回 值：无 +**************************************************************************/ +void Robot_Init(double wheelspacing, float axlespacing, float omni_turn_radiaus, float gearratio,float Accuracy,float tyre_diameter) // +{ + //wheelspacing, Mec_Car is half wheelspacing + //轮距 麦轮车为半轮距 + Robot_Parament.WheelSpacing=wheelspacing; + //axlespacing, Mec_Car is half axlespacing + //轴距 麦轮车为半轴距 + Robot_Parament.AxleSpacing=axlespacing; + //Rotation radius of omnidirectional trolley + //全向轮小车旋转半径 + Robot_Parament.OmniTurnRadiaus=omni_turn_radiaus; + //motor_gear_ratio + //电机减速比 + Robot_Parament.GearRatio=gearratio; + //Number_of_encoder_lines + //编码器精度(编码器线数) + Robot_Parament.EncoderAccuracy=Accuracy; + //Diameter of driving wheel + //主动轮直径 + Robot_Parament.WheelDiameter=tyre_diameter; + + //Encoder value corresponding to 1 turn of motor (wheel) + //电机(车轮)转1圈对应的编码器数值 + Encoder_precision=EncoderMultiples*Robot_Parament.EncoderAccuracy*Robot_Parament.GearRatio; + //Driving wheel circumference + //主动轮周长 + Wheel_perimeter=Robot_Parament.WheelDiameter*PI; + //wheelspacing, Mec_Car is half wheelspacing + //轮距 麦轮车为半轮距 + Wheel_spacing=Robot_Parament.WheelSpacing; + //axlespacing, Mec_Car is half axlespacing + //轴距 麦轮车为半轴距 + Axle_spacing=Robot_Parament.AxleSpacing; + //Rotation radius of omnidirectional trolley + //全向轮小车旋转半径 + Omni_turn_radiaus=Robot_Parament.OmniTurnRadiaus; +} + + diff --git a/BALANCE/robot_select_init.h b/BALANCE/robot_select_init.h new file mode 100644 index 0000000..4f66e6b --- /dev/null +++ b/BALANCE/robot_select_init.h @@ -0,0 +1,108 @@ +#ifndef __ROBOTSELECTINIT_H +#define __ROBOTSELECTINIT_H +#include "sys.h" +#include "system.h" + +//Parameter structure of robot +//机器人参数结构体 +typedef struct +{ + float WheelSpacing; //Wheelspacing, Mec_Car is half wheelspacing //轮距 麦轮车为半轮距 + float AxleSpacing; //Axlespacing, Mec_Car is half axlespacing //轴距 麦轮车为半轴距 + int GearRatio; //Motor_gear_ratio //电机减速比 + int EncoderAccuracy; //Number_of_encoder_lines //编码器精度(编码器线数) + float WheelDiameter; //Diameter of driving wheel //主动轮直径 + float OmniTurnRadiaus; //Rotation radius of omnidirectional trolley //全向轮小车旋转半径 +}Robot_Parament_InitTypeDef; + +// Encoder structure +//编码器结构体 +typedef struct +{ + int A; + int B; + int C; + int D; +}Encoder; + +//The minimum turning radius of Ackermann models is determined by the mechanical structure: +//the maximum Angle of the wheelbase, wheelbase and front wheels +//阿克曼车型的最小转弯半径，由机械结构决定：轮距、轴距、前轮最大转角 +#define MINI_AKM_MIN_TURN_RADIUS 0.350f + +//Wheelspacing, Mec_Car is half wheelspacing +//轮距 麦轮是一半 +//#define MEC_wheelspacing 0.109 +#define MEC_wheelspacing 0.0930 //修正2021.03.30 +#define Akm_wheelspacing 0.162f +#define Diff_wheelSpacing 0.177f +#define Four_Mortor_wheelSpacing 0.26f +#define Tank_wheelSpacing 0.235f + +//Axlespacing, Mec_Car is half axlespacing +//轴距 麦轮是一半 +#define MEC_axlespacing 0.085 +#define Akm_axlespacing 0.158f +#define Diff_axlespacing 0.155f +#define Four_Mortor__axlespacing 0.28f +#define Tank_axlespacing 0.222f + +//Motor_gear_ratio +//电机减速比 +#define HALL_30F 30 +#define HALL_60F 60 +#define MD36N_5_18 5.18 +#define MD36N_27 27 +#define MD36N_51 51 +#define MD36N_71 71 +#define MD60N_18 18 +#define MD60N_47 47 + +//Number_of_encoder_lines +//编码器精度 +#define Photoelectric_500 500 +#define Hall_13 13 + +//Mecanum wheel tire diameter series +//麦轮轮胎直径 +#define Mecanum_60 0.060f +#define Mecanum_75 0.075f +#define Mecanum_100 0.100f +#define Mecanum_127 0.127f +#define Mecanum_152 0.152f + +//Omni wheel tire diameter series +//轮径全向轮直径系列 +#define FullDirecion_60 0.060 +#define FullDirecion_75 0.075 +#define FullDirecion_127 0.127 +#define FullDirecion_152 0.152 +#define FullDirecion_203 0.203 +#define FullDirecion_217 0.217 + +//Black tire, tank_car wheel diameter +//黑色轮胎、履带车轮直径 +#define Black_WheelDiameter 0.065 +//#define Tank_WheelDiameter 0.047 +#define Tank_WheelDiameter 0.043 + +//Rotation radius of omnidirectional trolley +//全向轮小车旋转半径 +#define Omni_Turn_Radiaus_109 0.109 +#define Omni_Turn_Radiaus_164 0.164 +#define Omni_Turn_Radiaus_180 0.180 +#define Omni_Turn_Radiaus_290 0.290 + +//The encoder octave depends on the encoder initialization Settings +//编码器倍频数，取决于编码器初始化设置 +#define EncoderMultiples 4 +//Encoder data reading frequency +//编码器数据读取频率 +#define CONTROL_FREQUENCY 100 + +//#define PI 3.1415f //PI //圆周率 + +void Robot_Select(void); +void Robot_Init(double wheelspacing, float axlespacing, float omni_turn_radiaus, float gearratio,float Accuracy,float tyre_diameter); + +#endif diff --git a/BALANCE/show.c b/BALANCE/show.c new file mode 100644 index 0000000..4f130ac --- /dev/null +++ b/BALANCE/show.c @@ -0,0 +1,344 @@ +#include "show.h" +int Voltage_Show; +unsigned char i; +unsigned char Send_Count; +extern SEND_DATA Send_Data; +extern int MPU9250ErrorCount, EncoderA_Count, EncoderB_Count, EncoderC_Count, EncoderD_Count; +extern int MPU9250SensorCountA, MPU9250SensorCountB, MPU9250SensorCountC, MPU9250SensorCountD; +extern int Time_count; +/************************************************************************** +Function: Read the battery voltage, buzzer alarm, start the self-test, send data to APP, OLED display task +Input : none +Output : none +函数功能：读取电池电压、蜂鸣器报警、开启自检、向APP发送数据、OLED显示屏显示任务 +入口参数：无 +返回 值：无 +**************************************************************************/ +int Buzzer_count=25; +void show_task(void *pvParameters) +{ + u32 lastWakeTime = getSysTickCnt(); + while(1) + { + int i=0; + static int LowVoltage_1=0, LowVoltage_2=0; + vTaskDelayUntil(&lastWakeTime, F2T(RATE_10_HZ));//This task runs at 10Hz //此任务以10Hz的频率运行 + + //开机时蜂鸣器短暂蜂鸣，开机提醒 + //The buzzer will beep briefly when the machine is switched on + if(Time_count<50)Buzzer=1; + else if(Time_count>=51 && Time_count<100)Buzzer=0; + + if(LowVoltage_1==1 || LowVoltage_2==1)Buzzer_count=0; + if(Buzzer_count<5)Buzzer_count++; + if(Buzzer_count<5)Buzzer=1; //The buzzer is buzzing //蜂鸣器蜂鸣 + else if(Buzzer_count==5)Buzzer=0; + + //Read the battery voltage //读取电池电压 + for(i=0;i<10;i++) + { + Voltage_All+=Get_battery_volt(); + } + Voltage=Voltage_All/10; + Voltage_All=0; + + if(LowVoltage_1==1)LowVoltage_1++; //Make sure the buzzer only rings for 0.5 seconds //确保蜂鸣器只响0.5秒 + if(LowVoltage_2==1)LowVoltage_2++; //Make sure the buzzer only rings for 0.5 seconds //确保蜂鸣器只响0.5秒 + if(Voltage>=12.6f)Voltage=12.6f; + else if(10<=Voltage && Voltage<10.5f && LowVoltage_1<2)LowVoltage_1++; //10.5V, first buzzer when low battery //10.5V，低电量时蜂鸣器第一次报警 + else if(Voltage<10 && LowVoltage_1<2)LowVoltage_2++; //10V, when the car is not allowed to control, the buzzer will alarm the second time //10V，小车禁止控制时蜂鸣器第二次报警 + + APP_Show(); //Send data to the APP //向APP发送数据 + oled_show(); //Tasks are displayed on the screen //显示屏显示任务 + } +} + +/************************************************************************** +Function: The OLED display displays tasks +Input : none +Output : none +函数功能：OLED显示屏显示任务 +入口参数：无 +返回 值：无 +**************************************************************************/ +void oled_show(void) +{ + static int count=0; + int Car_Mode_Show; + + //Collect the tap information of the potentiometer, + //and display the car model to be fitted when the car starts up in real time + //采集电位器档位信息，实时显示小车开机时要适配的小车型号 + Divisor_Mode=2048/CAR_NUMBER+5; + Car_Mode_Show=(int) ((Get_adc_Average(Potentiometer,10))/Divisor_Mode); + if(Car_Mode_Show>5)Car_Mode_Show=5; + //Car_Mode_Show=0; + + Voltage_Show=Voltage*100; + count++; + + if(Check==0)//The car displays normally when the self-check mode is not enabled //没有开启自检模式时小车正常显示 + { + //The first line of the display displays the content// + //显示屏第1行显示内容// + switch(Car_Mode_Show) + { + case Mec_Car: OLED_ShowString(0,0,"Mec "); break; + case Omni_Car: OLED_ShowString(0,0,"Omni"); break; + case Akm_Car: OLED_ShowString(0,0,"Akm "); break; + case Diff_Car: OLED_ShowString(0,0,"Diff"); break; + case FourWheel_Car: OLED_ShowString(0,0,"4WD "); break; + case Tank_Car: OLED_ShowString(0,0,"Tank"); break; + } + + if(Car_Mode==Mec_Car||Car_Mode==Omni_Car) + { + //The Mec_car and omni_car show Z-axis angular velocity + //麦轮、全向轮小车显示Z轴角速度 + OLED_ShowString(55,0,"GZ"); + if( gyro[2]<0) OLED_ShowString(80,0,"-"),OLED_ShowNumber(90,0,-gyro[2],5,12); + else OLED_ShowString(80,0,"+"),OLED_ShowNumber(90,0, gyro[2],5,12); + } + else if(Car_Mode==Akm_Car||Car_Mode==Diff_Car||Car_Mode==FourWheel_Car||Car_Mode==Tank_Car) + { + //Akm_Car, Diff_Car, FourWheel_Car and Tank_Car Displays gyroscope zero + //阿克曼、差速、四驱、履带车显示陀螺仪零点 + OLED_ShowString(55,0,"BIAS"); + if( Deviation_gyro[2]<0) OLED_ShowString(90,0,"-"),OLED_ShowNumber(100,0,-Deviation_gyro[2],3,12); //Zero-drift data of gyroscope Z axis + else OLED_ShowString(90,0,"+"),OLED_ShowNumber(100,0, Deviation_gyro[2],3,12); //陀螺仪z轴零点漂移数据 + } + //The first line of the display displays the content// + //显示屏第1行显示内容// + + + //The second line of the display displays the content// + //显示屏第2行显示内容// + if(Car_Mode==Mec_Car||Car_Mode==Omni_Car||Car_Mode==FourWheel_Car) + { + //Mec_Car, Omni_Car and FourWheel_Car Display the target speed and current actual speed of motor A + //麦轮、全向轮、四驱车显示电机A的目标速度和当前实际速度 + OLED_ShowString(0,10,"A"); + if( MOTOR_A.Target<0) OLED_ShowString(15,10,"-"), + OLED_ShowNumber(20,10,-MOTOR_A.Target*1000,5,12); + else OLED_ShowString(15,10,"+"), + OLED_ShowNumber(20,10, MOTOR_A.Target*1000,5,12); + + if( MOTOR_A.Encoder<0)OLED_ShowString(60,10,"-"), + OLED_ShowNumber(75,10,-MOTOR_A.Encoder*1000,5,12); + else OLED_ShowString(60,10,"+"), + OLED_ShowNumber(75,10, MOTOR_A.Encoder*1000,5,12); + } + else if(Car_Mode==Akm_Car||Car_Mode==Diff_Car||Car_Mode==Tank_Car) + { + //The Akm_Car, Diff_Car and Tank_Car show Z-axis angular velocity + //阿克曼、差速、坦克小车显示Z轴角速度 + OLED_ShowString(00,10,"GYRO_Z:"); + if( gyro[2]<0) OLED_ShowString(60,10,"-"), + OLED_ShowNumber(75,10,-gyro[2],5,12); + else OLED_ShowString(60,10,"+"), + OLED_ShowNumber(75,10, gyro[2],5,12); + } + //The second line of the display displays the content// + //显示屏第2行显示内容// + + //Lines 3 and 4 of the display screen display content// + //显示屏第3、4行显示内容// + if(Car_Mode==Mec_Car||Car_Mode==Omni_Car||Car_Mode==FourWheel_Car) + { + //Mec_Car, Omni_Car and FourWheel_Car Display the target speed and current actual speed of motor B + //麦轮、全向轮、四驱车显示电机B的目标速度和当前实际速度 + OLED_ShowString(0,20,"B"); + if( MOTOR_B.Target<0) OLED_ShowString(15,20,"-"), + OLED_ShowNumber(20,20,-MOTOR_B.Target*1000,5,12); + else OLED_ShowString(15,20,"+"), + OLED_ShowNumber(20,20, MOTOR_B.Target*1000,5,12); + + if( MOTOR_B.Encoder<0)OLED_ShowString(60,20,"-"), + OLED_ShowNumber(75,20,-MOTOR_B.Encoder*1000,5,12); + else OLED_ShowString(60,20,"+"), + OLED_ShowNumber(75,20, MOTOR_B.Encoder*1000,5,12); + + //Mec_Car, Omni_Car and FourWheel_Car Display the target speed and current actual speed of motor C + //麦轮、全向轮、四驱车显示电机C的目标速度和当前实际速度 + OLED_ShowString(0,30,"C"); + if( MOTOR_C.Target<0) OLED_ShowString(15,30,"-"), + OLED_ShowNumber(20,30,- MOTOR_C.Target*1000,5,12); + else OLED_ShowString(15,30,"+"), + OLED_ShowNumber(20,30, MOTOR_C.Target*1000,5,12); + + if( MOTOR_C.Encoder<0)OLED_ShowString(60,30,"-"), + OLED_ShowNumber(75,30,-MOTOR_C.Encoder*1000,5,12); + else OLED_ShowString(60,30,"+"), + OLED_ShowNumber(75,30, MOTOR_C.Encoder*1000,5,12); + } + else if(Car_Mode==Akm_Car||Car_Mode==Diff_Car||Car_Mode==Tank_Car) + { + //Akm_Car, Diff_Car and Tank_Car Display the target speed and current actual speed of motor A + //阿克曼、差速、履带车显示电机A的目标速度和当前实际速度 + OLED_ShowString(0,20,"L:"); + if( MOTOR_A.Target<0) OLED_ShowString(15,20,"-"), + OLED_ShowNumber(20,20,-MOTOR_A.Target*1000,5,12); + else OLED_ShowString(15,20,"+"), + OLED_ShowNumber(20,20, MOTOR_A.Target*1000,5,12); + if( MOTOR_A.Encoder<0) OLED_ShowString(60,20,"-"), + OLED_ShowNumber(75,20,-MOTOR_A.Encoder*1000,5,12); + else OLED_ShowString(60,20,"+"), + OLED_ShowNumber(75,20, MOTOR_A.Encoder*1000,5,12); + //Akm_Car, Diff_Car and Tank_Car Display the target speed and current actual speed of motor B + //阿克曼、差速、履带车显示电机B的目标速度和当前实际速度 + OLED_ShowString(0,30,"R:"); + if( MOTOR_B.Target<0) OLED_ShowString(15,30,"-"), + OLED_ShowNumber(20,30,-MOTOR_B.Target*1000,5,12); + else OLED_ShowString(15,30,"+"), + OLED_ShowNumber(20,30, MOTOR_B.Target*1000,5,12); + + if( MOTOR_B.Encoder<0) OLED_ShowString(60,30,"-"), + OLED_ShowNumber(75,30,-MOTOR_B.Encoder*1000,5,12); + else OLED_ShowString(60,30,"+"), + OLED_ShowNumber(75,30, MOTOR_B.Encoder*1000,5,12); + +// if( Remoter_Ch1<0) OLED_ShowString(15,20,"-"), +// OLED_ShowNumber(20,20,-Remoter_Ch1,5,12); +// else OLED_ShowString(15,20,"+"), +// OLED_ShowNumber(20,20, Remoter_Ch1,5,12); +// if( Remoter_Ch2<0) OLED_ShowString(60,20,"-"), +// OLED_ShowNumber(75,20,-Remoter_Ch2,5,12); +// else OLED_ShowString(60,20,"+"), +// OLED_ShowNumber(75,20, Remoter_Ch2,5,12); +// if( Remoter_Ch3<0) OLED_ShowString(15,30,"-"), +// OLED_ShowNumber(20,30,-Remoter_Ch3,5,12); +// else OLED_ShowString(15,30,"+"), +// OLED_ShowNumber(20,30, Remoter_Ch3,5,12); +// if( Remoter_Ch4<0) OLED_ShowString(60,30,"-"), +// OLED_ShowNumber(75,30,-Remoter_Ch4,5,12); +// else OLED_ShowString(60,30,"+"), +// OLED_ShowNumber(75,30, Remoter_Ch4,5,12); + } + //Lines 3 and 4 of the display screen display content// + //显示屏第3、4行显示内容// + + //Line 5 of the display displays the content// + //显示屏第5行显示内容// + if(Car_Mode==Mec_Car||Car_Mode==FourWheel_Car) + { + //Mec_Car Display the target speed and current actual speed of motor D + //麦轮小车显示电机D的目标速度和当前实际速度 + OLED_ShowString(0,40,"D"); + if( MOTOR_D.Target<0) OLED_ShowString(15,40,"-"), + OLED_ShowNumber(20,40,- MOTOR_D.Target*1000,5,12); + else OLED_ShowString(15,40,"+"), + OLED_ShowNumber(20,40, MOTOR_D.Target*1000,5,12); + if( MOTOR_D.Encoder<0) OLED_ShowString(60,40,"-"), + OLED_ShowNumber(75,40,-MOTOR_D.Encoder*1000,5,12); + else OLED_ShowString(60,40,"+"), + OLED_ShowNumber(75,40, MOTOR_D.Encoder*1000,5,12); + } + else if(Car_Mode==Omni_Car) + { + // The Omni_car shows Z-axis angular velocity (1000 times magnification) in rad/s + //全向轮小车显示Z轴角速度(放大1000倍)，单位rad/s + OLED_ShowString(0,40,"MOVE_Z"); + if(Send_Data.Sensor_Str.X_speed<0) OLED_ShowString(60,40,"-"), + OLED_ShowNumber(75,40,-Send_Data.Sensor_Str.X_speed,5,12); + else OLED_ShowString(60,40,"+"), + OLED_ShowNumber(75,40, Send_Data.Sensor_Str.X_speed,5,12); + } + else if(Car_Mode==Akm_Car) + { + //Akm_Car displays the PWM value of the Servo + //阿克曼小车显示舵机的PWM的数值 + OLED_ShowString(00,40,"SERVO:"); + if( Servo<0) OLED_ShowString(60,40,"-"), + OLED_ShowNumber(80,40,-Servo,4,12); + else OLED_ShowString(60,40,"+"), + OLED_ShowNumber(80,40, Servo,4,12); + } + else if(Car_Mode==Diff_Car||Car_Mode==Tank_Car) + { + // The Diff_Car and Tank_Car displays the PWM values of the left and right motors + //差速小车、履带车显示左右电机的PWM的数值 + OLED_ShowString(00,40,"MA"); + if( MOTOR_A.Motor_Pwm<0)OLED_ShowString(20,40,"-"), + OLED_ShowNumber(30,40,-MOTOR_A.Motor_Pwm,4,12); + else OLED_ShowString(20,40,"+"), + OLED_ShowNumber(30,40, MOTOR_A.Motor_Pwm,4,12); + OLED_ShowString(60,40,"MB"); + if(MOTOR_B.Motor_Pwm<0) OLED_ShowString(80,40,"-"), + OLED_ShowNumber(90,40,-MOTOR_B.Motor_Pwm,4,12); + else OLED_ShowString(80,40,"+"), + OLED_ShowNumber(90,40, MOTOR_B.Motor_Pwm,4,12); + } + //Line 5 of the display displays the content// + //显示屏第5行显示内容// + + //Displays the current control mode //显示当前控制模式 + if(PS2_ON_Flag==1) OLED_ShowString(0,50,"PS2 "); + else if (APP_ON_Flag==1) OLED_ShowString(0,50,"APP "); + else if (Remote_ON_Flag==1)OLED_ShowString(0,50,"R-C "); + else if (CAN_ON_Flag==1) OLED_ShowString(0,50,"CAN "); + else if ((Usart1_ON_Flag || Usart5_ON_Flag)==1) OLED_ShowString(0,50,"USART"); + else OLED_ShowString(0,50,"ROS "); + + //Displays whether controls are allowed in the current car + //显示当前小车是否允许控制 + if(EN==1&&Flag_Stop==0) OLED_ShowString(45,50,"O N"); + else OLED_ShowString(45,50,"OFF"); + + OLED_ShowNumber(75,50,Voltage_Show/100,2,12); + OLED_ShowString(88,50,"."); + OLED_ShowNumber(98,50,Voltage_Show%100,2,12); + OLED_ShowString(110,50,"V"); + if(Voltage_Show%100<10) OLED_ShowNumber(92,50,0,2,12); + } + + OLED_Refresh_Gram(); +} +/************************************************************************** +Function: Send data to the APP +Input : none +Output : none +函数功能：向APP发送数据 +入口参数：无 +返回 值：无 +**************************************************************************/ +void APP_Show(void) +{ + static u8 flag_show; + int Left_Figure,Right_Figure,Voltage_Show; + + //The battery voltage is processed as a percentage + //对电池电压处理成百分比形式 + Voltage_Show=(Voltage*1000-10000)/27; + if(Voltage_Show>100)Voltage_Show=100; + + //Wheel speed unit is converted to 0.01m/s for easy display in APP + //车轮速度单位转换为0.01m/s，方便在APP显示 + Left_Figure=MOTOR_A.Encoder*100; if(Left_Figure<0)Left_Figure=-Left_Figure; + Right_Figure=MOTOR_B.Encoder*100; if(Right_Figure<0)Right_Figure=-Right_Figure; + + //Used to alternately print APP data and display waveform + //用于交替打印APP数据和显示波形 + flag_show=!flag_show; + + if(PID_Send==1) + { + //Send parameters to the APP, the APP is displayed in the debug screen + //发送参数到APP，APP在调试界面显示 + printf("{C%d:%d:%d}$",(int)RC_Velocity,(int)Velocity_KP,(int)Velocity_KI); + PID_Send=0; + } + else if(flag_show==0) + { + //Send parameters to the APP and the APP will be displayed on the front page + //发送参数到APP，APP在首页显示 + printf("{A%d:%d:%d:%d}$",(u8)Left_Figure,(u8)Right_Figure,Voltage_Show,(int)gyro[2]); + } + else + { + //Send parameters to the APP, the APP is displayed in the waveform interface + //发送参数到APP，APP在波形界面显示 + printf("{B%d:%d:%d}$",(int)gyro[0],(int)gyro[1],(int)gyro[2]); + } +} + + diff --git a/BALANCE/show.h b/BALANCE/show.h new file mode 100644 index 0000000..9fb814f --- /dev/null +++ b/BALANCE/show.h @@ -0,0 +1,15 @@ +#ifndef __SHOW_H +#define __SHOW_H +#include "sys.h" +#include "oled.h" +#include "system.h" +#define SHOW_TASK_PRIO 3 +#define SHOW_STK_SIZE 512 + +void show_task(void *pvParameters); +void oled_show(void); +void APP_Show(void); +void OLED_ShowCheckConfirming(void); +void OLED_ShowChecking(void); +void OLED_ShowCheckResult(void); +#endif diff --git a/BALANCE/system.c b/BALANCE/system.c new file mode 100644 index 0000000..d0d48ec --- /dev/null +++ b/BALANCE/system.c @@ -0,0 +1,197 @@ +#include "system.h" + +//Robot software fails to flag bits +//机器人软件失能标志位 +u8 Flag_Stop=1; + +//The ADC value is variable in segments, depending on the number of car models. Currently there are 6 car models +//ADC值分段变量，取决于小车型号数量，目前有6种小车型号 +int Divisor_Mode; + +// Robot type variable +//机器人型号变量 +//0=Mec_Car，1=Omni_Car，2=Akm_Car，3=Diff_Car，4=FourWheel_Car，5=Tank_Car +u8 Car_Mode=4; + +//Servo control PWM value, Ackerman car special +//舵机控制PWM值，阿克曼小车专用 +int Servo; + +//Default speed of remote control car, unit: mm/s +//遥控小车的默认速度，单位：mm/s +float RC_Velocity=500; + +//Vehicle three-axis target moving speed, unit: m/s +//小车三轴目标运动速度，单位：m/s +float Move_X, Move_Y, Move_Z; + +//PID parameters of Speed control +//速度控制PID参数 +float Velocity_KP=300,Velocity_KI=800; + +//Smooth control of intermediate variables, dedicated to omni-directional moving cars +//平滑控制中间变量，全向移动小车专用 +Smooth_Control smooth_control; + +//The parameter structure of the motor +//电机的参数结构体 +Motor_parameter MOTOR_A,MOTOR_B,MOTOR_C,MOTOR_D; + +/************ 小车型号相关变量 **************************/ +/************ Variables related to car model ************/ +//Encoder accuracy +//编码器精度 +float Encoder_precision; +//Wheel circumference, unit: m +//轮子周长，单位：m +float Wheel_perimeter; +//Drive wheel base, unit: m +//主动轮轮距，单位：m +float Wheel_spacing; +//The wheelbase of the front and rear axles of the trolley, unit: m +//小车前后轴的轴距，单位：m +float Axle_spacing; +//All-directional wheel turning radius, unit: m +//全向轮转弯半径，单位：m +float Omni_turn_radiaus; +/************ 小车型号相关变量 **************************/ +/************ Variables related to car model ************/ + +//PS2 controller, Bluetooth APP, aircraft model controller, CAN communication, serial port 1, serial port 5 communication control flag bit. +//These 6 flag bits are all 0 by default, representing the serial port 3 control mode +//PS2手柄、蓝牙APP、航模手柄、CAN通信、串口1、串口5通信控制标志位。这6个标志位默认都为0，代表串口3控制模式 +u8 PS2_ON_Flag=0, APP_ON_Flag=0, Remote_ON_Flag=0, CAN_ON_Flag=0, Usart1_ON_Flag, Usart5_ON_Flag; + +//Bluetooth remote control associated flag bits +//蓝牙遥控相关的标志位 +u8 Flag_Left, Flag_Right, Flag_Direction=0, Turn_Flag; + +//Sends the parameter's flag bit to the Bluetooth APP +//向蓝牙APP发送参数的标志位 +u8 PID_Send; + +//The PS2 gamepad controls related variables +//PS2手柄控制相关变量 +float PS2_LX,PS2_LY,PS2_RX,PS2_RY,PS2_KEY; + +//Self-check the relevant flag variables +//自检相关标志变量 +int Check=0, Checking=0, Checked=0, CheckCount=0, CheckPhrase1=0, CheckPhrase2=0; + +//Check the result code +//自检结果代码 +long int ErrorCode=0; + +void systemInit(void) +{ + +// //Interrupt priority group setti ng +// //中断优先级分组设置 + NVIC_PriorityGroupConfig(NVIC_PriorityGroup_4); +// +// //Delay function initialization +// //延时函数初始化 + delay_init(168); + + //Initialize the hardware interface connected to the LED lamp + //初始化与LED灯连接的硬件接口 + LED_Init(); + + //Initialize the hardware interface connected to the buzzer + //初始化与蜂鸣器连接的硬件接口 + Buzzer_Init(); + + //Initialize the hardware interface connected to the enable switch + //初始化与使能开关连接的硬件接口 + Enable_Pin(); + + //Initialize the hardware interface connected to the OLED display + //初始化与OLED显示屏连接的硬件接口 + OLED_Init(); + + //Initialize the hardware interface connected to the user's key + //初始化与用户按键连接的硬件接口 + KEY_Init(); + + //Serial port 1 initialization, communication baud rate 115200, + //can be used to communicate with ROS terminal + //串口1初始化，通信波特率115200，可用于与ROS端通信 + uart1_init(115200); + + //Serial port 2 initialization, communication baud rate 9600, + //used to communicate with Bluetooth APP terminal + //串口2初始化，通信波特率9600，用于与蓝牙APP端通信 + uart2_init(9600); + + //Serial port 3 is initialized and the baud rate is 115200. + //Serial port 3 is the default port used to communicate with ROS terminal + //串口3初始化，通信波特率115200，串口3为默认用于与ROS端通信的串口 + uart3_init(115200); + + //Serial port 5 initialization, communication baud rate 115200, + //can be used to communicate with ROS terminal + //串口5初始化，通信波特率115200，可用于与ROS端通信 + uart5_init(115200); + + //ADC pin initialization, used to read the battery voltage and potentiometer gear, + //potentiometer gear determines the car after the boot of the car model + //ADC引脚初始化，用于读取电池电压与电位器档位，电位器档位决定小车开机后的小车适配型号 + Adc_Init(); + Adc_POWER_Init(); + + //Initialize the CAN communication interface + //CAN通信接口初始化 + CAN1_Mode_Init(1,7,6,3,0); + + //According to the tap position of the potentiometer, determine which type of car needs to be matched, + //and then initialize the corresponding parameters + //根据电位器的档位判断需要适配的是哪一种型号的小车，然后进行对应的参数初始化 + Robot_Select(); + + //Encoder A is initialized to read the real time speed of motor C + //编码器A初始化，用于读取电机C的实时速度 + Encoder_Init_TIM2(); + //Encoder B is initialized to read the real time speed of motor D + //编码器B初始化，用于读取电机D的实时速度 + Encoder_Init_TIM3(); + //Encoder C is initialized to read the real time speed of motor B + //编码器C初始化，用于读取电机B的实时速度 + Encoder_Init_TIM4(); + //Encoder D is initialized to read the real time speed of motor A + //编码器D初始化，用于读取电机A的实时速度 + Encoder_Init_TIM5(); + + //定时器12用作舵机的PWM接口 + TIM12_SERVO_Init(9999,84-1); //APB1的时钟频率为84M , 频率=84M/((9999+1)*(83+1))=100Hz + + //普通小车默认定时器8用作航模接口 + // TIM8_SERVO_Init(9999,168-1);//APB2的时钟频率为168M , 频率=168M/((9999+1)*(167+1))=100Hz + //Initialize the model remote control interface + //初始化航模遥控接口 + TIM8_Cap_Init(9999,168-1); //高级定时器TIM8的时钟频率为168M + + //Initialize motor speed control and, for controlling motor speed, PWM frequency 10kHz + //初始化电机速度控制以及，用于控制电机速度，PWM频率10KHZ + //APB2时钟频率为168M，满PWM为16799，频率=168M/((16799+1)*(0+1))=10k + TIM1_PWM_Init(16799,0); + TIM9_PWM_Init(16799,0); + TIM10_PWM_Init(16799,0); + TIM11_PWM_Init(16799,0); + + //IIC initialization for MPU6050 + //IIC初始化，用于MPU6050 + I2C_GPIOInit(); + + //MPU6050 is initialized to read the vehicle's three-axis attitude, + //three-axis angular velocity and three-axis acceleration information + //MPU6050 初始化，用于读取小车三轴姿态、三轴角速度、三轴加速度信息 + MPU6050_initialize(); + + //Initialize the hardware interface to the PS2 controller + //初始化与PS2手柄连接的硬件接口 + PS2_Init(); + + //PS2 gamepad configuration is initialized and configured in analog mode + //PS2手柄配置初始化,配置为模拟量模式 + PS2_SetInit(); +} diff --git a/BALANCE/system.h b/BALANCE/system.h new file mode 100644 index 0000000..eda2a55 --- /dev/null +++ b/BALANCE/system.h @@ -0,0 +1,124 @@ +#ifndef __SYSTEM_H +#define __SYSTEM_H + +// Refer to all header files you need +//引用所有需要用到的头文件 +#include "FreeRTOSConfig.h" +//FreeRTOS相关头文件 +//FreeRTOS related header files +#include "FreeRTOS.h" +#include "stm32f4xx.h" +#include "task.h" +#include "queue.h" +#include "timers.h" +#include "semphr.h" +//The associated header file for the peripheral +//外设的相关头文件 +#include "sys.h" +#include "delay.h" +#include "usart.h" +#include "balance.h" +#include "led.h" +#include "oled.h" +#include "usart.h" +#include "usartx.h" +#include "adc.h" +#include "can.h" +#include "motor.h" +#include "timer.h" +#include "encoder.h" +#include "show.h" +#include "pstwo.h" +#include "key.h" +#include "robot_select_init.h" +#include "I2C.h" +#include "MPU6050.h" + + +// Enumeration of car types +//小车型号的枚举定义 +typedef enum +{ + Mec_Car = 0, + Omni_Car, + Akm_Car, + Diff_Car, + FourWheel_Car, + Tank_Car +} CarMode; + +//Motor speed control related parameters of the structure +//电机速度控制相关参数结构体 +typedef struct +{ + float Encoder; //Read the real time speed of the motor by encoder //编码器数值，读取电机实时速度 + float Motor_Pwm; //Motor PWM value, control the real-time speed of the motor //电机PWM数值，控制电机实时速度 + float Target; //Control the target speed of the motor //电机目标速度值，控制电机目标速度 + float Velocity_KP; //Speed control PID parameters //速度控制PID参数 + float Velocity_KI; //Speed control PID parameters //速度控制PID参数 +}Motor_parameter; + +//Smoothed the speed of the three axes +//平滑处理后的三轴速度 +typedef struct +{ + float VX; + float VY; + float VZ; +}Smooth_Control; + +/****** external variable definition. When system.h is referenced in other C files, + other C files can also use the variable defined by system.c ******/ +/****** 外部变量定义，当其它c文件引用system.h时，也可以使用system.c定义的变量 ******/ +extern u8 Flag_Stop; +extern int Divisor_Mode; +extern u8 Car_Mode; +extern int Servo; +extern float RC_Velocity; +extern float Move_X, Move_Y, Move_Z; +extern float Velocity_KP, Velocity_KI; +extern Smooth_Control smooth_control; +extern Motor_parameter MOTOR_A, MOTOR_B, MOTOR_C, MOTOR_D; +extern float Encoder_precision; +extern float Wheel_perimeter; +extern float Wheel_spacing; +extern float Axle_spacing; +extern float Omni_turn_radiaus; +extern u8 PS2_ON_Flag, APP_ON_Flag, Remote_ON_Flag, CAN_ON_Flag, Usart1_ON_Flag, Usart5_ON_Flag; +extern u8 Flag_Left, Flag_Right, Flag_Direction, Turn_Flag; +extern u8 PID_Send; +extern float PS2_LX,PS2_LY,PS2_RX,PS2_RY,PS2_KEY; +extern int Check, Checking, Checked, CheckCount, CheckPhrase1, CheckPhrase2; +extern long int ErrorCode; + +void systemInit(void); + +/***Macros define***/ /***宏定义***/ +//After starting the car (1000/100Hz =10) for seconds, it is allowed to control the car to move +//开机(1000/100hz=10)秒后才允许控制小车进行运动 +#define CONTROL_DELAY 1000 +//The number of robot types to determine the value of Divisor_Mode. There are currently 6 car types +//机器人型号数量，决定Divisor_Mode的值，目前有6种小车类型 +#define CAR_NUMBER 6 +#define RATE_1_HZ 1 +#define RATE_5_HZ 5 +#define RATE_10_HZ 10 +#define RATE_20_HZ 20 +#define RATE_25_HZ 25 +#define RATE_50_HZ 50 +#define RATE_100_HZ 100 +#define RATE_200_HZ 200 +#define RATE_250_HZ 250 +#define RATE_500_HZ 500 +#define RATE_1000_HZ 1000 +/***Macros define***/ /***宏定义***/ + +//C library function related header file +//C库函数的相关头文件 +#include +#include +#include +#include +#include +#include "stdarg.h" +#endif diff --git a/CORE/arm_math.h b/CORE/arm_math.h new file mode 100644 index 0000000..d33f8a9 --- /dev/null +++ b/CORE/arm_math.h @@ -0,0 +1,7154 @@ +/* ---------------------------------------------------------------------- +* Copyright (C) 2010-2015 ARM Limited. All rights reserved. +* +* $Date: 20. October 2015 +* $Revision: V1.4.5 b +* +* Project: CMSIS DSP Library +* Title: arm_math.h +* +* Description: Public header file for CMSIS DSP Library +* +* Target Processor: Cortex-M7/Cortex-M4/Cortex-M3/Cortex-M0 +* +* Redistribution and use in source and binary forms, with or without +* modification, are permitted provided that the following conditions +* are met: +* - Redistributions of source code must retain the above copyright +* notice, this list of conditions and the following disclaimer. +* - Redistributions in binary form must reproduce the above copyright +* notice, this list of conditions and the following disclaimer in +* the documentation and/or other materials provided with the +* distribution. +* - Neither the name of ARM LIMITED nor the names of its contributors +* may be used to endorse or promote products derived from this +* software without specific prior written permission. +* +* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS +* FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE +* COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, +* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, +* BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; +* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER +* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN +* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE +* POSSIBILITY OF SUCH DAMAGE. + * -------------------------------------------------------------------- */ + +/** + \mainpage CMSIS DSP Software Library + * + * Introduction + * ------------ + * + * This user manual describes the CMSIS DSP software library, + * a suite of common signal processing functions for use on Cortex-M processor based devices. + * + * The library is divided into a number of functions each covering a specific category: + * - Basic math functions + * - Fast math functions + * - Complex math functions + * - Filters + * - Matrix functions + * - Transforms + * - Motor control functions + * - Statistical functions + * - Support functions + * - Interpolation functions + * + * The library has separate functions for operating on 8-bit integers, 16-bit integers, + * 32-bit integer and 32-bit floating-point values. + * + * Using the Library + * ------------ + * + * The library installer contains prebuilt versions of the libraries in the Lib folder. + * - arm_cortexM7lfdp_math.lib (Little endian and Double Precision Floating Point Unit on Cortex-M7) + * - arm_cortexM7bfdp_math.lib (Big endian and Double Precision Floating Point Unit on Cortex-M7) + * - arm_cortexM7lfsp_math.lib (Little endian and Single Precision Floating Point Unit on Cortex-M7) + * - arm_cortexM7bfsp_math.lib (Big endian and Single Precision Floating Point Unit on Cortex-M7) + * - arm_cortexM7l_math.lib (Little endian on Cortex-M7) + * - arm_cortexM7b_math.lib (Big endian on Cortex-M7) + * - arm_cortexM4lf_math.lib (Little endian and Floating Point Unit on Cortex-M4) + * - arm_cortexM4bf_math.lib (Big endian and Floating Point Unit on Cortex-M4) + * - arm_cortexM4l_math.lib (Little endian on Cortex-M4) + * - arm_cortexM4b_math.lib (Big endian on Cortex-M4) + * - arm_cortexM3l_math.lib (Little endian on Cortex-M3) + * - arm_cortexM3b_math.lib (Big endian on Cortex-M3) + * - arm_cortexM0l_math.lib (Little endian on Cortex-M0 / CortexM0+) + * - arm_cortexM0b_math.lib (Big endian on Cortex-M0 / CortexM0+) + * + * The library functions are declared in the public file arm_math.h which is placed in the Include folder. + * Simply include this file and link the appropriate library in the application and begin calling the library functions. The Library supports single + * public header file arm_math.h for Cortex-M7/M4/M3/M0/M0+ with little endian and big endian. Same header file will be used for floating point unit(FPU) variants. + * Define the appropriate pre processor MACRO ARM_MATH_CM7 or ARM_MATH_CM4 or ARM_MATH_CM3 or + * ARM_MATH_CM0 or ARM_MATH_CM0PLUS depending on the target processor in the application. + * + * Examples + * -------- + * + * The library ships with a number of examples which demonstrate how to use the library functions. + * + * Toolchain Support + * ------------ + * + * The library has been developed and tested with MDK-ARM version 5.14.0.0 + * The library is being tested in GCC and IAR toolchains and updates on this activity will be made available shortly. + * + * Building the Library + * ------------ + * + * The library installer contains a project file to re build libraries on MDK-ARM Tool chain in the CMSIS\\DSP_Lib\\Source\\ARM folder. + * - arm_cortexM_math.uvprojx + * + * + * The libraries can be built by opening the arm_cortexM_math.uvprojx project in MDK-ARM, selecting a specific target, and defining the optional pre processor MACROs detailed above. + * + * Pre-processor Macros + * ------------ + * + * Each library project have differant pre-processor macros. + * + * - UNALIGNED_SUPPORT_DISABLE: + * + * Define macro UNALIGNED_SUPPORT_DISABLE, If the silicon does not support unaligned memory access + * + * - ARM_MATH_BIG_ENDIAN: + * + * Define macro ARM_MATH_BIG_ENDIAN to build the library for big endian targets. By default library builds for little endian targets. + * + * - ARM_MATH_MATRIX_CHECK: + * + * Define macro ARM_MATH_MATRIX_CHECK for checking on the input and output sizes of matrices + * + * - ARM_MATH_ROUNDING: + * + * Define macro ARM_MATH_ROUNDING for rounding on support functions + * + * - ARM_MATH_CMx: + * + * Define macro ARM_MATH_CM4 for building the library on Cortex-M4 target, ARM_MATH_CM3 for building library on Cortex-M3 target + * and ARM_MATH_CM0 for building library on Cortex-M0 target, ARM_MATH_CM0PLUS for building library on Cortex-M0+ target, and + * ARM_MATH_CM7 for building the library on cortex-M7. + * + * - __FPU_PRESENT: + * + * Initialize macro __FPU_PRESENT = 1 when building on FPU supported Targets. Enable this macro for M4bf and M4lf libraries + * + *
+ * CMSIS-DSP in ARM::CMSIS Pack + * ----------------------------- + * + * The following files relevant to CMSIS-DSP are present in the ARM::CMSIS Pack directories: + * |File/Folder |Content | + * |------------------------------|------------------------------------------------------------------------| + * |\b CMSIS\\Documentation\\DSP | This documentation | + * |\b CMSIS\\DSP_Lib | Software license agreement (license.txt) | + * |\b CMSIS\\DSP_Lib\\Examples | Example projects demonstrating the usage of the library functions | + * |\b CMSIS\\DSP_Lib\\Source | Source files for rebuilding the library | + * + *
+ * Revision History of CMSIS-DSP + * ------------ + * Please refer to \ref ChangeLog_pg. + * + * Copyright Notice + * ------------ + * + * Copyright (C) 2010-2015 ARM Limited. All rights reserved. + */ + + +/** + * @defgroup groupMath Basic Math Functions + */ + +/** + * @defgroup groupFastMath Fast Math Functions + * This set of functions provides a fast approximation to sine, cosine, and square root. + * As compared to most of the other functions in the CMSIS math library, the fast math functions + * operate on individual values and not arrays. + * There are separate functions for Q15, Q31, and floating-point data. + * + */ + +/** + * @defgroup groupCmplxMath Complex Math Functions + * This set of functions operates on complex data vectors. + * The data in the complex arrays is stored in an interleaved fashion + * (real, imag, real, imag, ...). + * In the API functions, the number of samples in a complex array refers + * to the number of complex values; the array contains twice this number of + * real values. + */ + +/** + * @defgroup groupFilters Filtering Functions + */ + +/** + * @defgroup groupMatrix Matrix Functions + * + * This set of functions provides basic matrix math operations. + * The functions operate on matrix data structures. For example, + * the type + * definition for the floating-point matrix structure is shown + * below: + * 
+ *     typedef struct
+ *     {
+ *       uint16_t numRows;     // number of rows of the matrix.
+ *       uint16_t numCols;     // number of columns of the matrix.
+ *       float32_t *pData;     // points to the data of the matrix.
+ *     } arm_matrix_instance_f32;
+ *
+ * There are similar definitions for Q15 and Q31 data types. + * + * The structure specifies the size of the matrix and then points to + * an array of data. The array is of size numRows X numCols + * and the values are arranged in row order. That is, the + * matrix element (i, j) is stored at: + * 
+ *     pData[i*numCols + j]
+ *
+ * + * \par Init Functions + * There is an associated initialization function for each type of matrix + * data structure. + * The initialization function sets the values of the internal structure fields. + * Refer to the function arm_mat_init_f32(), arm_mat_init_q31() + * and arm_mat_init_q15() for floating-point, Q31 and Q15 types, respectively. + * + * \par + * Use of the initialization function is optional. However, if initialization function is used + * then the instance structure cannot be placed into a const data section. + * To place the instance structure in a const data + * section, manually initialize the data structure. For example: + * 
+ * arm_matrix_instance_f32 S = {nRows, nColumns, pData};
+ * arm_matrix_instance_q31 S = {nRows, nColumns, pData};
+ * arm_matrix_instance_q15 S = {nRows, nColumns, pData};
+ *
+ * where nRows specifies the number of rows, nColumns + * specifies the number of columns, and pData points to the + * data array. + * + * \par Size Checking + * By default all of the matrix functions perform size checking on the input and + * output matrices. For example, the matrix addition function verifies that the + * two input matrices and the output matrix all have the same number of rows and + * columns. If the size check fails the functions return: + * 
+ *     ARM_MATH_SIZE_MISMATCH
+ *
+ * Otherwise the functions return + * 
+ *     ARM_MATH_SUCCESS
+ *
+ * There is some overhead associated with this matrix size checking. + * The matrix size checking is enabled via the \#define + * 
+ *     ARM_MATH_MATRIX_CHECK
+ *
+ * within the library project settings. By default this macro is defined + * and size checking is enabled. By changing the project settings and + * undefining this macro size checking is eliminated and the functions + * run a bit faster. With size checking disabled the functions always + * return ARM_MATH_SUCCESS. + */ + +/** + * @defgroup groupTransforms Transform Functions + */ + +/** + * @defgroup groupController Controller Functions + */ + +/** + * @defgroup groupStats Statistics Functions + */ +/** + * @defgroup groupSupport Support Functions + */ + +/** + * @defgroup groupInterpolation Interpolation Functions + * These functions perform 1- and 2-dimensional interpolation of data. + * Linear interpolation is used for 1-dimensional data and + * bilinear interpolation is used for 2-dimensional data. + */ + +/** + * @defgroup groupExamples Examples + */ +#ifndef _ARM_MATH_H +#define _ARM_MATH_H + +/* ignore some GCC warnings */ +#if defined ( __GNUC__ ) +#pragma GCC diagnostic push +#pragma GCC diagnostic ignored "-Wsign-conversion" +#pragma GCC diagnostic ignored "-Wconversion" +#pragma GCC diagnostic ignored "-Wunused-parameter" +#endif + +#define __CMSIS_GENERIC /* disable NVIC and Systick functions */ + +#if defined(ARM_MATH_CM7) + #include "core_cm7.h" +#elif defined (ARM_MATH_CM4) + #include "core_cm4.h" +#elif defined (ARM_MATH_CM3) + #include "core_cm3.h" +#elif defined (ARM_MATH_CM0) + #include "core_cm0.h" + #define ARM_MATH_CM0_FAMILY +#elif defined (ARM_MATH_CM0PLUS) + #include "core_cm0plus.h" + #define ARM_MATH_CM0_FAMILY +#else + #error "Define according the used Cortex core ARM_MATH_CM7, ARM_MATH_CM4, ARM_MATH_CM3, ARM_MATH_CM0PLUS or ARM_MATH_CM0" +#endif + +#undef __CMSIS_GENERIC /* enable NVIC and Systick functions */ +#include "string.h" +#include "math.h" +#ifdef __cplusplus +extern "C" +{ +#endif + + + /** + * @brief Macros required for reciprocal calculation in Normalized LMS + */ + +#define DELTA_Q31 (0x100) +#define DELTA_Q15 0x5 +#define INDEX_MASK 0x0000003F +#ifndef PI +#define PI 3.14159265358979f +#endif + + /** + * @brief Macros required for SINE and COSINE Fast math approximations + */ + +#define FAST_MATH_TABLE_SIZE 512 +#define FAST_MATH_Q31_SHIFT (32 - 10) +#define FAST_MATH_Q15_SHIFT (16 - 10) +#define CONTROLLER_Q31_SHIFT (32 - 9) +#define TABLE_SIZE 256 +#define TABLE_SPACING_Q31 0x400000 +#define TABLE_SPACING_Q15 0x80 + + /** + * @brief Macros required for SINE and COSINE Controller functions + */ + /* 1.31(q31) Fixed value of 2/360 */ + /* -1 to +1 is divided into 360 values so total spacing is (2/360) */ +#define INPUT_SPACING 0xB60B61 + + /** + * @brief Macro for Unaligned Support + */ +#ifndef UNALIGNED_SUPPORT_DISABLE + #define ALIGN4 +#else + #if defined (__GNUC__) + #define ALIGN4 __attribute__((aligned(4))) + #else + #define ALIGN4 __align(4) + #endif +#endif /* #ifndef UNALIGNED_SUPPORT_DISABLE */ + + /** + * @brief Error status returned by some functions in the library. + */ + + typedef enum + { + ARM_MATH_SUCCESS = 0, /**< No error */ + ARM_MATH_ARGUMENT_ERROR = -1, /**< One or more arguments are incorrect */ + ARM_MATH_LENGTH_ERROR = -2, /**< Length of data buffer is incorrect */ + ARM_MATH_SIZE_MISMATCH = -3, /**< Size of matrices is not compatible with the operation. */ + ARM_MATH_NANINF = -4, /**< Not-a-number (NaN) or infinity is generated */ + ARM_MATH_SINGULAR = -5, /**< Generated by matrix inversion if the input matrix is singular and cannot be inverted. */ + ARM_MATH_TEST_FAILURE = -6 /**< Test Failed */ + } arm_status; + + /** + * @brief 8-bit fractional data type in 1.7 format. + */ + typedef int8_t q7_t; + + /** + * @brief 16-bit fractional data type in 1.15 format. + */ + typedef int16_t q15_t; + + /** + * @brief 32-bit fractional data type in 1.31 format. + */ + typedef int32_t q31_t; + + /** + * @brief 64-bit fractional data type in 1.63 format. + */ + typedef int64_t q63_t; + + /** + * @brief 32-bit floating-point type definition. + */ + typedef float float32_t; + + /** + * @brief 64-bit floating-point type definition. + */ + typedef double float64_t; + + /** + * @brief definition to read/write two 16 bit values. + */ +#if defined __CC_ARM + #define __SIMD32_TYPE int32_t __packed + #define CMSIS_UNUSED __attribute__((unused)) + +#elif defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050) + #define __SIMD32_TYPE int32_t + #define CMSIS_UNUSED __attribute__((unused)) + +#elif defined __GNUC__ + #define __SIMD32_TYPE int32_t + #define CMSIS_UNUSED __attribute__((unused)) + +#elif defined __ICCARM__ + #define __SIMD32_TYPE int32_t __packed + #define CMSIS_UNUSED + +#elif defined __CSMC__ + #define __SIMD32_TYPE int32_t + #define CMSIS_UNUSED + +#elif defined __TASKING__ + #define __SIMD32_TYPE __unaligned int32_t + #define CMSIS_UNUSED + +#else + #error Unknown compiler +#endif + +#define __SIMD32(addr) (*(__SIMD32_TYPE **) & (addr)) +#define __SIMD32_CONST(addr) ((__SIMD32_TYPE *)(addr)) +#define _SIMD32_OFFSET(addr) (*(__SIMD32_TYPE *) (addr)) +#define __SIMD64(addr) (*(int64_t **) & (addr)) + +#if defined (ARM_MATH_CM3) || defined (ARM_MATH_CM0_FAMILY) + /** + * @brief definition to pack two 16 bit values. + */ +#define __PKHBT(ARG1, ARG2, ARG3) ( (((int32_t)(ARG1) << 0) & (int32_t)0x0000FFFF) | \ + (((int32_t)(ARG2) << ARG3) & (int32_t)0xFFFF0000) ) +#define __PKHTB(ARG1, ARG2, ARG3) ( (((int32_t)(ARG1) << 0) & (int32_t)0xFFFF0000) | \ + (((int32_t)(ARG2) >> ARG3) & (int32_t)0x0000FFFF) ) + +#endif + + + /** + * @brief definition to pack four 8 bit values. + */ +#ifndef ARM_MATH_BIG_ENDIAN + +#define __PACKq7(v0,v1,v2,v3) ( (((int32_t)(v0) << 0) & (int32_t)0x000000FF) | \ + (((int32_t)(v1) << 8) & (int32_t)0x0000FF00) | \ + (((int32_t)(v2) << 16) & (int32_t)0x00FF0000) | \ + (((int32_t)(v3) << 24) & (int32_t)0xFF000000) ) +#else + +#define __PACKq7(v0,v1,v2,v3) ( (((int32_t)(v3) << 0) & (int32_t)0x000000FF) | \ + (((int32_t)(v2) << 8) & (int32_t)0x0000FF00) | \ + (((int32_t)(v1) << 16) & (int32_t)0x00FF0000) | \ + (((int32_t)(v0) << 24) & (int32_t)0xFF000000) ) + +#endif + + + /** + * @brief Clips Q63 to Q31 values. + */ + static __INLINE q31_t clip_q63_to_q31( + q63_t x) + { + return ((q31_t) (x >> 32) != ((q31_t) x >> 31)) ? + ((0x7FFFFFFF ^ ((q31_t) (x >> 63)))) : (q31_t) x; + } + + /** + * @brief Clips Q63 to Q15 values. + */ + static __INLINE q15_t clip_q63_to_q15( + q63_t x) + { + return ((q31_t) (x >> 32) != ((q31_t) x >> 31)) ? + ((0x7FFF ^ ((q15_t) (x >> 63)))) : (q15_t) (x >> 15); + } + + /** + * @brief Clips Q31 to Q7 values. + */ + static __INLINE q7_t clip_q31_to_q7( + q31_t x) + { + return ((q31_t) (x >> 24) != ((q31_t) x >> 23)) ? + ((0x7F ^ ((q7_t) (x >> 31)))) : (q7_t) x; + } + + /** + * @brief Clips Q31 to Q15 values. + */ + static __INLINE q15_t clip_q31_to_q15( + q31_t x) + { + return ((q31_t) (x >> 16) != ((q31_t) x >> 15)) ? + ((0x7FFF ^ ((q15_t) (x >> 31)))) : (q15_t) x; + } + + /** + * @brief Multiplies 32 X 64 and returns 32 bit result in 2.30 format. + */ + + static __INLINE q63_t mult32x64( + q63_t x, + q31_t y) + { + return ((((q63_t) (x & 0x00000000FFFFFFFF) * y) >> 32) + + (((q63_t) (x >> 32) * y))); + } + +/* + #if defined (ARM_MATH_CM0_FAMILY) && defined ( __CC_ARM ) + #define __CLZ __clz + #endif + */ +/* note: function can be removed when all toolchain support __CLZ for Cortex-M0 */ +#if defined (ARM_MATH_CM0_FAMILY) && ((defined (__ICCARM__)) ) + static __INLINE uint32_t __CLZ( + q31_t data); + + static __INLINE uint32_t __CLZ( + q31_t data) + { + uint32_t count = 0; + uint32_t mask = 0x80000000; + + while((data & mask) == 0) + { + count += 1u; + mask = mask >> 1u; + } + + return (count); + } +#endif + + /** + * @brief Function to Calculates 1/in (reciprocal) value of Q31 Data type. + */ + + static __INLINE uint32_t arm_recip_q31( + q31_t in, + q31_t * dst, + q31_t * pRecipTable) + { + q31_t out; + uint32_t tempVal; + uint32_t index, i; + uint32_t signBits; + + if(in > 0) + { + signBits = ((uint32_t) (__CLZ( in) - 1)); + } + else + { + signBits = ((uint32_t) (__CLZ(-in) - 1)); + } + + /* Convert input sample to 1.31 format */ + in = (in << signBits); + + /* calculation of index for initial approximated Val */ + index = (uint32_t)(in >> 24); + index = (index & INDEX_MASK); + + /* 1.31 with exp 1 */ + out = pRecipTable[index]; + + /* calculation of reciprocal value */ + /* running approximation for two iterations */ + for (i = 0u; i < 2u; i++) + { + tempVal = (uint32_t) (((q63_t) in * out) >> 31); + tempVal = 0x7FFFFFFFu - tempVal; + /* 1.31 with exp 1 */ + /* out = (q31_t) (((q63_t) out * tempVal) >> 30); */ + out = clip_q63_to_q31(((q63_t) out * tempVal) >> 30); + } + + /* write output */ + *dst = out; + + /* return num of signbits of out = 1/in value */ + return (signBits + 1u); + } + + + /** + * @brief Function to Calculates 1/in (reciprocal) value of Q15 Data type. + */ + static __INLINE uint32_t arm_recip_q15( + q15_t in, + q15_t * dst, + q15_t * pRecipTable) + { + q15_t out = 0; + uint32_t tempVal = 0; + uint32_t index = 0, i = 0; + uint32_t signBits = 0; + + if(in > 0) + { + signBits = ((uint32_t)(__CLZ( in) - 17)); + } + else + { + signBits = ((uint32_t)(__CLZ(-in) - 17)); + } + + /* Convert input sample to 1.15 format */ + in = (in << signBits); + + /* calculation of index for initial approximated Val */ + index = (uint32_t)(in >> 8); + index = (index & INDEX_MASK); + + /* 1.15 with exp 1 */ + out = pRecipTable[index]; + + /* calculation of reciprocal value */ + /* running approximation for two iterations */ + for (i = 0u; i < 2u; i++) + { + tempVal = (uint32_t) (((q31_t) in * out) >> 15); + tempVal = 0x7FFFu - tempVal; + /* 1.15 with exp 1 */ + out = (q15_t) (((q31_t) out * tempVal) >> 14); + /* out = clip_q31_to_q15(((q31_t) out * tempVal) >> 14); */ + } + + /* write output */ + *dst = out; + + /* return num of signbits of out = 1/in value */ + return (signBits + 1); + } + + + /* + * @brief C custom defined intrinisic function for only M0 processors + */ +#if defined(ARM_MATH_CM0_FAMILY) + static __INLINE q31_t __SSAT( + q31_t x, + uint32_t y) + { + int32_t posMax, negMin; + uint32_t i; + + posMax = 1; + for (i = 0; i < (y - 1); i++) + { + posMax = posMax * 2; + } + + if(x > 0) + { + posMax = (posMax - 1); + + if(x > posMax) + { + x = posMax; + } + } + else + { + negMin = -posMax; + + if(x < negMin) + { + x = negMin; + } + } + return (x); + } +#endif /* end of ARM_MATH_CM0_FAMILY */ + + + /* + * @brief C custom defined intrinsic function for M3 and M0 processors + */ +#if defined (ARM_MATH_CM3) || defined (ARM_MATH_CM0_FAMILY) + + /* + * @brief C custom defined QADD8 for M3 and M0 processors + */ + static __INLINE uint32_t __QADD8( + uint32_t x, + uint32_t y) + { + q31_t r, s, t, u; + + r = __SSAT(((((q31_t)x << 24) >> 24) + (((q31_t)y << 24) >> 24)), 8) & (int32_t)0x000000FF; + s = __SSAT(((((q31_t)x << 16) >> 24) + (((q31_t)y << 16) >> 24)), 8) & (int32_t)0x000000FF; + t = __SSAT(((((q31_t)x << 8) >> 24) + (((q31_t)y << 8) >> 24)), 8) & (int32_t)0x000000FF; + u = __SSAT(((((q31_t)x ) >> 24) + (((q31_t)y ) >> 24)), 8) & (int32_t)0x000000FF; + + return ((uint32_t)((u << 24) | (t << 16) | (s << 8) | (r ))); + } + + + /* + * @brief C custom defined QSUB8 for M3 and M0 processors + */ + static __INLINE uint32_t __QSUB8( + uint32_t x, + uint32_t y) + { + q31_t r, s, t, u; + + r = __SSAT(((((q31_t)x << 24) >> 24) - (((q31_t)y << 24) >> 24)), 8) & (int32_t)0x000000FF; + s = __SSAT(((((q31_t)x << 16) >> 24) - (((q31_t)y << 16) >> 24)), 8) & (int32_t)0x000000FF; + t = __SSAT(((((q31_t)x << 8) >> 24) - (((q31_t)y << 8) >> 24)), 8) & (int32_t)0x000000FF; + u = __SSAT(((((q31_t)x ) >> 24) - (((q31_t)y ) >> 24)), 8) & (int32_t)0x000000FF; + + return ((uint32_t)((u << 24) | (t << 16) | (s << 8) | (r ))); + } + + + /* + * @brief C custom defined QADD16 for M3 and M0 processors + */ + static __INLINE uint32_t __QADD16( + uint32_t x, + uint32_t y) + { +/* q31_t r, s; without initialisation 'arm_offset_q15 test' fails but 'intrinsic' tests pass! for armCC */ + q31_t r = 0, s = 0; + + r = __SSAT(((((q31_t)x << 16) >> 16) + (((q31_t)y << 16) >> 16)), 16) & (int32_t)0x0000FFFF; + s = __SSAT(((((q31_t)x ) >> 16) + (((q31_t)y ) >> 16)), 16) & (int32_t)0x0000FFFF; + + return ((uint32_t)((s << 16) | (r ))); + } + + + /* + * @brief C custom defined SHADD16 for M3 and M0 processors + */ + static __INLINE uint32_t __SHADD16( + uint32_t x, + uint32_t y) + { + q31_t r, s; + + r = (((((q31_t)x << 16) >> 16) + (((q31_t)y << 16) >> 16)) >> 1) & (int32_t)0x0000FFFF; + s = (((((q31_t)x ) >> 16) + (((q31_t)y ) >> 16)) >> 1) & (int32_t)0x0000FFFF; + + return ((uint32_t)((s << 16) | (r ))); + } + + + /* + * @brief C custom defined QSUB16 for M3 and M0 processors + */ + static __INLINE uint32_t __QSUB16( + uint32_t x, + uint32_t y) + { + q31_t r, s; + + r = __SSAT(((((q31_t)x << 16) >> 16) - (((q31_t)y << 16) >> 16)), 16) & (int32_t)0x0000FFFF; + s = __SSAT(((((q31_t)x ) >> 16) - (((q31_t)y ) >> 16)), 16) & (int32_t)0x0000FFFF; + + return ((uint32_t)((s << 16) | (r ))); + } + + + /* + * @brief C custom defined SHSUB16 for M3 and M0 processors + */ + static __INLINE uint32_t __SHSUB16( + uint32_t x, + uint32_t y) + { + q31_t r, s; + + r = (((((q31_t)x << 16) >> 16) - (((q31_t)y << 16) >> 16)) >> 1) & (int32_t)0x0000FFFF; + s = (((((q31_t)x ) >> 16) - (((q31_t)y ) >> 16)) >> 1) & (int32_t)0x0000FFFF; + + return ((uint32_t)((s << 16) | (r ))); + } + + + /* + * @brief C custom defined QASX for M3 and M0 processors + */ + static __INLINE uint32_t __QASX( + uint32_t x, + uint32_t y) + { + q31_t r, s; + + r = __SSAT(((((q31_t)x << 16) >> 16) - (((q31_t)y ) >> 16)), 16) & (int32_t)0x0000FFFF; + s = __SSAT(((((q31_t)x ) >> 16) + (((q31_t)y << 16) >> 16)), 16) & (int32_t)0x0000FFFF; + + return ((uint32_t)((s << 16) | (r ))); + } + + + /* + * @brief C custom defined SHASX for M3 and M0 processors + */ + static __INLINE uint32_t __SHASX( + uint32_t x, + uint32_t y) + { + q31_t r, s; + + r = (((((q31_t)x << 16) >> 16) - (((q31_t)y ) >> 16)) >> 1) & (int32_t)0x0000FFFF; + s = (((((q31_t)x ) >> 16) + (((q31_t)y << 16) >> 16)) >> 1) & (int32_t)0x0000FFFF; + + return ((uint32_t)((s << 16) | (r ))); + } + + + /* + * @brief C custom defined QSAX for M3 and M0 processors + */ + static __INLINE uint32_t __QSAX( + uint32_t x, + uint32_t y) + { + q31_t r, s; + + r = __SSAT(((((q31_t)x << 16) >> 16) + (((q31_t)y ) >> 16)), 16) & (int32_t)0x0000FFFF; + s = __SSAT(((((q31_t)x ) >> 16) - (((q31_t)y << 16) >> 16)), 16) & (int32_t)0x0000FFFF; + + return ((uint32_t)((s << 16) | (r ))); + } + + + /* + * @brief C custom defined SHSAX for M3 and M0 processors + */ + static __INLINE uint32_t __SHSAX( + uint32_t x, + uint32_t y) + { + q31_t r, s; + + r = (((((q31_t)x << 16) >> 16) + (((q31_t)y ) >> 16)) >> 1) & (int32_t)0x0000FFFF; + s = (((((q31_t)x ) >> 16) - (((q31_t)y << 16) >> 16)) >> 1) & (int32_t)0x0000FFFF; + + return ((uint32_t)((s << 16) | (r ))); + } + + + /* + * @brief C custom defined SMUSDX for M3 and M0 processors + */ + static __INLINE uint32_t __SMUSDX( + uint32_t x, + uint32_t y) + { + return ((uint32_t)(((((q31_t)x << 16) >> 16) * (((q31_t)y ) >> 16)) - + ((((q31_t)x ) >> 16) * (((q31_t)y << 16) >> 16)) )); + } + + /* + * @brief C custom defined SMUADX for M3 and M0 processors + */ + static __INLINE uint32_t __SMUADX( + uint32_t x, + uint32_t y) + { + return ((uint32_t)(((((q31_t)x << 16) >> 16) * (((q31_t)y ) >> 16)) + + ((((q31_t)x ) >> 16) * (((q31_t)y << 16) >> 16)) )); + } + + + /* + * @brief C custom defined QADD for M3 and M0 processors + */ + static __INLINE int32_t __QADD( + int32_t x, + int32_t y) + { + return ((int32_t)(clip_q63_to_q31((q63_t)x + (q31_t)y))); + } + + + /* + * @brief C custom defined QSUB for M3 and M0 processors + */ + static __INLINE int32_t __QSUB( + int32_t x, + int32_t y) + { + return ((int32_t)(clip_q63_to_q31((q63_t)x - (q31_t)y))); + } + + + /* + * @brief C custom defined SMLAD for M3 and M0 processors + */ + static __INLINE uint32_t __SMLAD( + uint32_t x, + uint32_t y, + uint32_t sum) + { + return ((uint32_t)(((((q31_t)x << 16) >> 16) * (((q31_t)y << 16) >> 16)) + + ((((q31_t)x ) >> 16) * (((q31_t)y ) >> 16)) + + ( ((q31_t)sum ) ) )); + } + + + /* + * @brief C custom defined SMLADX for M3 and M0 processors + */ + static __INLINE uint32_t __SMLADX( + uint32_t x, + uint32_t y, + uint32_t sum) + { + return ((uint32_t)(((((q31_t)x << 16) >> 16) * (((q31_t)y ) >> 16)) + + ((((q31_t)x ) >> 16) * (((q31_t)y << 16) >> 16)) + + ( ((q31_t)sum ) ) )); + } + + + /* + * @brief C custom defined SMLSDX for M3 and M0 processors + */ + static __INLINE uint32_t __SMLSDX( + uint32_t x, + uint32_t y, + uint32_t sum) + { + return ((uint32_t)(((((q31_t)x << 16) >> 16) * (((q31_t)y ) >> 16)) - + ((((q31_t)x ) >> 16) * (((q31_t)y << 16) >> 16)) + + ( ((q31_t)sum ) ) )); + } + + + /* + * @brief C custom defined SMLALD for M3 and M0 processors + */ + static __INLINE uint64_t __SMLALD( + uint32_t x, + uint32_t y, + uint64_t sum) + { +/* return (sum + ((q15_t) (x >> 16) * (q15_t) (y >> 16)) + ((q15_t) x * (q15_t) y)); */ + return ((uint64_t)(((((q31_t)x << 16) >> 16) * (((q31_t)y << 16) >> 16)) + + ((((q31_t)x ) >> 16) * (((q31_t)y ) >> 16)) + + ( ((q63_t)sum ) ) )); + } + + + /* + * @brief C custom defined SMLALDX for M3 and M0 processors + */ + static __INLINE uint64_t __SMLALDX( + uint32_t x, + uint32_t y, + uint64_t sum) + { +/* return (sum + ((q15_t) (x >> 16) * (q15_t) y)) + ((q15_t) x * (q15_t) (y >> 16)); */ + return ((uint64_t)(((((q31_t)x << 16) >> 16) * (((q31_t)y ) >> 16)) + + ((((q31_t)x ) >> 16) * (((q31_t)y << 16) >> 16)) + + ( ((q63_t)sum ) ) )); + } + + + /* + * @brief C custom defined SMUAD for M3 and M0 processors + */ + static __INLINE uint32_t __SMUAD( + uint32_t x, + uint32_t y) + { + return ((uint32_t)(((((q31_t)x << 16) >> 16) * (((q31_t)y << 16) >> 16)) + + ((((q31_t)x ) >> 16) * (((q31_t)y ) >> 16)) )); + } + + + /* + * @brief C custom defined SMUSD for M3 and M0 processors + */ + static __INLINE uint32_t __SMUSD( + uint32_t x, + uint32_t y) + { + return ((uint32_t)(((((q31_t)x << 16) >> 16) * (((q31_t)y << 16) >> 16)) - + ((((q31_t)x ) >> 16) * (((q31_t)y ) >> 16)) )); + } + + + /* + * @brief C custom defined SXTB16 for M3 and M0 processors + */ + static __INLINE uint32_t __SXTB16( + uint32_t x) + { + return ((uint32_t)(((((q31_t)x << 24) >> 24) & (q31_t)0x0000FFFF) | + ((((q31_t)x << 8) >> 8) & (q31_t)0xFFFF0000) )); + } + +#endif /* defined (ARM_MATH_CM3) || defined (ARM_MATH_CM0_FAMILY) */ + + + /** + * @brief Instance structure for the Q7 FIR filter. + */ + typedef struct + { + uint16_t numTaps; /**< number of filter coefficients in the filter. */ + q7_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ + q7_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps.*/ + } arm_fir_instance_q7; + + /** + * @brief Instance structure for the Q15 FIR filter. + */ + typedef struct + { + uint16_t numTaps; /**< number of filter coefficients in the filter. */ + q15_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ + q15_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps.*/ + } arm_fir_instance_q15; + + /** + * @brief Instance structure for the Q31 FIR filter. + */ + typedef struct + { + uint16_t numTaps; /**< number of filter coefficients in the filter. */ + q31_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ + q31_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps. */ + } arm_fir_instance_q31; + + /** + * @brief Instance structure for the floating-point FIR filter. + */ + typedef struct + { + uint16_t numTaps; /**< number of filter coefficients in the filter. */ + float32_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ + float32_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps. */ + } arm_fir_instance_f32; + + + /** + * @brief Processing function for the Q7 FIR filter. + * @param[in] S points to an instance of the Q7 FIR filter structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data. + * @param[in] blockSize number of samples to process. + */ + void arm_fir_q7( + const arm_fir_instance_q7 * S, + q7_t * pSrc, + q7_t * pDst, + uint32_t blockSize); + + + /** + * @brief Initialization function for the Q7 FIR filter. + * @param[in,out] S points to an instance of the Q7 FIR structure. + * @param[in] numTaps Number of filter coefficients in the filter. + * @param[in] pCoeffs points to the filter coefficients. + * @param[in] pState points to the state buffer. + * @param[in] blockSize number of samples that are processed. + */ + void arm_fir_init_q7( + arm_fir_instance_q7 * S, + uint16_t numTaps, + q7_t * pCoeffs, + q7_t * pState, + uint32_t blockSize); + + + /** + * @brief Processing function for the Q15 FIR filter. + * @param[in] S points to an instance of the Q15 FIR structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data. + * @param[in] blockSize number of samples to process. + */ + void arm_fir_q15( + const arm_fir_instance_q15 * S, + q15_t * pSrc, + q15_t * pDst, + uint32_t blockSize); + + + /** + * @brief Processing function for the fast Q15 FIR filter for Cortex-M3 and Cortex-M4. + * @param[in] S points to an instance of the Q15 FIR filter structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data. + * @param[in] blockSize number of samples to process. + */ + void arm_fir_fast_q15( + const arm_fir_instance_q15 * S, + q15_t * pSrc, + q15_t * pDst, + uint32_t blockSize); + + + /** + * @brief Initialization function for the Q15 FIR filter. + * @param[in,out] S points to an instance of the Q15 FIR filter structure. + * @param[in] numTaps Number of filter coefficients in the filter. Must be even and greater than or equal to 4. + * @param[in] pCoeffs points to the filter coefficients. + * @param[in] pState points to the state buffer. + * @param[in] blockSize number of samples that are processed at a time. + * @return The function returns ARM_MATH_SUCCESS if initialization was successful or ARM_MATH_ARGUMENT_ERROR if + * numTaps is not a supported value. + */ + arm_status arm_fir_init_q15( + arm_fir_instance_q15 * S, + uint16_t numTaps, + q15_t * pCoeffs, + q15_t * pState, + uint32_t blockSize); + + + /** + * @brief Processing function for the Q31 FIR filter. + * @param[in] S points to an instance of the Q31 FIR filter structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data. + * @param[in] blockSize number of samples to process. + */ + void arm_fir_q31( + const arm_fir_instance_q31 * S, + q31_t * pSrc, + q31_t * pDst, + uint32_t blockSize); + + + /** + * @brief Processing function for the fast Q31 FIR filter for Cortex-M3 and Cortex-M4. + * @param[in] S points to an instance of the Q31 FIR structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data. + * @param[in] blockSize number of samples to process. + */ + void arm_fir_fast_q31( + const arm_fir_instance_q31 * S, + q31_t * pSrc, + q31_t * pDst, + uint32_t blockSize); + + + /** + * @brief Initialization function for the Q31 FIR filter. + * @param[in,out] S points to an instance of the Q31 FIR structure. + * @param[in] numTaps Number of filter coefficients in the filter. + * @param[in] pCoeffs points to the filter coefficients. + * @param[in] pState points to the state buffer. + * @param[in] blockSize number of samples that are processed at a time. + */ + void arm_fir_init_q31( + arm_fir_instance_q31 * S, + uint16_t numTaps, + q31_t * pCoeffs, + q31_t * pState, + uint32_t blockSize); + + + /** + * @brief Processing function for the floating-point FIR filter. + * @param[in] S points to an instance of the floating-point FIR structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data. + * @param[in] blockSize number of samples to process. + */ + void arm_fir_f32( + const arm_fir_instance_f32 * S, + float32_t * pSrc, + float32_t * pDst, + uint32_t blockSize); + + + /** + * @brief Initialization function for the floating-point FIR filter. + * @param[in,out] S points to an instance of the floating-point FIR filter structure. + * @param[in] numTaps Number of filter coefficients in the filter. + * @param[in] pCoeffs points to the filter coefficients. + * @param[in] pState points to the state buffer. + * @param[in] blockSize number of samples that are processed at a time. + */ + void arm_fir_init_f32( + arm_fir_instance_f32 * S, + uint16_t numTaps, + float32_t * pCoeffs, + float32_t * pState, + uint32_t blockSize); + + + /** + * @brief Instance structure for the Q15 Biquad cascade filter. + */ + typedef struct + { + int8_t numStages; /**< number of 2nd order stages in the filter. Overall order is 2*numStages. */ + q15_t *pState; /**< Points to the array of state coefficients. The array is of length 4*numStages. */ + q15_t *pCoeffs; /**< Points to the array of coefficients. The array is of length 5*numStages. */ + int8_t postShift; /**< Additional shift, in bits, applied to each output sample. */ + } arm_biquad_casd_df1_inst_q15; + + /** + * @brief Instance structure for the Q31 Biquad cascade filter. + */ + typedef struct + { + uint32_t numStages; /**< number of 2nd order stages in the filter. Overall order is 2*numStages. */ + q31_t *pState; /**< Points to the array of state coefficients. The array is of length 4*numStages. */ + q31_t *pCoeffs; /**< Points to the array of coefficients. The array is of length 5*numStages. */ + uint8_t postShift; /**< Additional shift, in bits, applied to each output sample. */ + } arm_biquad_casd_df1_inst_q31; + + /** + * @brief Instance structure for the floating-point Biquad cascade filter. + */ + typedef struct + { + uint32_t numStages; /**< number of 2nd order stages in the filter. Overall order is 2*numStages. */ + float32_t *pState; /**< Points to the array of state coefficients. The array is of length 4*numStages. */ + float32_t *pCoeffs; /**< Points to the array of coefficients. The array is of length 5*numStages. */ + } arm_biquad_casd_df1_inst_f32; + + + /** + * @brief Processing function for the Q15 Biquad cascade filter. + * @param[in] S points to an instance of the Q15 Biquad cascade structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data. + * @param[in] blockSize number of samples to process. + */ + void arm_biquad_cascade_df1_q15( + const arm_biquad_casd_df1_inst_q15 * S, + q15_t * pSrc, + q15_t * pDst, + uint32_t blockSize); + + + /** + * @brief Initialization function for the Q15 Biquad cascade filter. + * @param[in,out] S points to an instance of the Q15 Biquad cascade structure. + * @param[in] numStages number of 2nd order stages in the filter. + * @param[in] pCoeffs points to the filter coefficients. + * @param[in] pState points to the state buffer. + * @param[in] postShift Shift to be applied to the output. Varies according to the coefficients format + */ + void arm_biquad_cascade_df1_init_q15( + arm_biquad_casd_df1_inst_q15 * S, + uint8_t numStages, + q15_t * pCoeffs, + q15_t * pState, + int8_t postShift); + + + /** + * @brief Fast but less precise processing function for the Q15 Biquad cascade filter for Cortex-M3 and Cortex-M4. + * @param[in] S points to an instance of the Q15 Biquad cascade structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data. + * @param[in] blockSize number of samples to process. + */ + void arm_biquad_cascade_df1_fast_q15( + const arm_biquad_casd_df1_inst_q15 * S, + q15_t * pSrc, + q15_t * pDst, + uint32_t blockSize); + + + /** + * @brief Processing function for the Q31 Biquad cascade filter + * @param[in] S points to an instance of the Q31 Biquad cascade structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data. + * @param[in] blockSize number of samples to process. + */ + void arm_biquad_cascade_df1_q31( + const arm_biquad_casd_df1_inst_q31 * S, + q31_t * pSrc, + q31_t * pDst, + uint32_t blockSize); + + + /** + * @brief Fast but less precise processing function for the Q31 Biquad cascade filter for Cortex-M3 and Cortex-M4. + * @param[in] S points to an instance of the Q31 Biquad cascade structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data. + * @param[in] blockSize number of samples to process. + */ + void arm_biquad_cascade_df1_fast_q31( + const arm_biquad_casd_df1_inst_q31 * S, + q31_t * pSrc, + q31_t * pDst, + uint32_t blockSize); + + + /** + * @brief Initialization function for the Q31 Biquad cascade filter. + * @param[in,out] S points to an instance of the Q31 Biquad cascade structure. + * @param[in] numStages number of 2nd order stages in the filter. + * @param[in] pCoeffs points to the filter coefficients. + * @param[in] pState points to the state buffer. + * @param[in] postShift Shift to be applied to the output. Varies according to the coefficients format + */ + void arm_biquad_cascade_df1_init_q31( + arm_biquad_casd_df1_inst_q31 * S, + uint8_t numStages, + q31_t * pCoeffs, + q31_t * pState, + int8_t postShift); + + + /** + * @brief Processing function for the floating-point Biquad cascade filter. + * @param[in] S points to an instance of the floating-point Biquad cascade structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data. + * @param[in] blockSize number of samples to process. + */ + void arm_biquad_cascade_df1_f32( + const arm_biquad_casd_df1_inst_f32 * S, + float32_t * pSrc, + float32_t * pDst, + uint32_t blockSize); + + + /** + * @brief Initialization function for the floating-point Biquad cascade filter. + * @param[in,out] S points to an instance of the floating-point Biquad cascade structure. + * @param[in] numStages number of 2nd order stages in the filter. + * @param[in] pCoeffs points to the filter coefficients. + * @param[in] pState points to the state buffer. + */ + void arm_biquad_cascade_df1_init_f32( + arm_biquad_casd_df1_inst_f32 * S, + uint8_t numStages, + float32_t * pCoeffs, + float32_t * pState); + + + /** + * @brief Instance structure for the floating-point matrix structure. + */ + typedef struct + { + uint16_t numRows; /**< number of rows of the matrix. */ + uint16_t numCols; /**< number of columns of the matrix. */ + float32_t *pData; /**< points to the data of the matrix. */ + } arm_matrix_instance_f32; + + + /** + * @brief Instance structure for the floating-point matrix structure. + */ + typedef struct + { + uint16_t numRows; /**< number of rows of the matrix. */ + uint16_t numCols; /**< number of columns of the matrix. */ + float64_t *pData; /**< points to the data of the matrix. */ + } arm_matrix_instance_f64; + + /** + * @brief Instance structure for the Q15 matrix structure. + */ + typedef struct + { + uint16_t numRows; /**< number of rows of the matrix. */ + uint16_t numCols; /**< number of columns of the matrix. */ + q15_t *pData; /**< points to the data of the matrix. */ + } arm_matrix_instance_q15; + + /** + * @brief Instance structure for the Q31 matrix structure. + */ + typedef struct + { + uint16_t numRows; /**< number of rows of the matrix. */ + uint16_t numCols; /**< number of columns of the matrix. */ + q31_t *pData; /**< points to the data of the matrix. */ + } arm_matrix_instance_q31; + + + /** + * @brief Floating-point matrix addition. + * @param[in] pSrcA points to the first input matrix structure + * @param[in] pSrcB points to the second input matrix structure + * @param[out] pDst points to output matrix structure + * @return The function returns either + * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. + */ + arm_status arm_mat_add_f32( + const arm_matrix_instance_f32 * pSrcA, + const arm_matrix_instance_f32 * pSrcB, + arm_matrix_instance_f32 * pDst); + + + /** + * @brief Q15 matrix addition. + * @param[in] pSrcA points to the first input matrix structure + * @param[in] pSrcB points to the second input matrix structure + * @param[out] pDst points to output matrix structure + * @return The function returns either + * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. + */ + arm_status arm_mat_add_q15( + const arm_matrix_instance_q15 * pSrcA, + const arm_matrix_instance_q15 * pSrcB, + arm_matrix_instance_q15 * pDst); + + + /** + * @brief Q31 matrix addition. + * @param[in] pSrcA points to the first input matrix structure + * @param[in] pSrcB points to the second input matrix structure + * @param[out] pDst points to output matrix structure + * @return The function returns either + * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. + */ + arm_status arm_mat_add_q31( + const arm_matrix_instance_q31 * pSrcA, + const arm_matrix_instance_q31 * pSrcB, + arm_matrix_instance_q31 * pDst); + + + /** + * @brief Floating-point, complex, matrix multiplication. + * @param[in] pSrcA points to the first input matrix structure + * @param[in] pSrcB points to the second input matrix structure + * @param[out] pDst points to output matrix structure + * @return The function returns either + * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. + */ + arm_status arm_mat_cmplx_mult_f32( + const arm_matrix_instance_f32 * pSrcA, + const arm_matrix_instance_f32 * pSrcB, + arm_matrix_instance_f32 * pDst); + + + /** + * @brief Q15, complex, matrix multiplication. + * @param[in] pSrcA points to the first input matrix structure + * @param[in] pSrcB points to the second input matrix structure + * @param[out] pDst points to output matrix structure + * @return The function returns either + * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. + */ + arm_status arm_mat_cmplx_mult_q15( + const arm_matrix_instance_q15 * pSrcA, + const arm_matrix_instance_q15 * pSrcB, + arm_matrix_instance_q15 * pDst, + q15_t * pScratch); + + + /** + * @brief Q31, complex, matrix multiplication. + * @param[in] pSrcA points to the first input matrix structure + * @param[in] pSrcB points to the second input matrix structure + * @param[out] pDst points to output matrix structure + * @return The function returns either + * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. + */ + arm_status arm_mat_cmplx_mult_q31( + const arm_matrix_instance_q31 * pSrcA, + const arm_matrix_instance_q31 * pSrcB, + arm_matrix_instance_q31 * pDst); + + + /** + * @brief Floating-point matrix transpose. + * @param[in] pSrc points to the input matrix + * @param[out] pDst points to the output matrix + * @return The function returns either ARM_MATH_SIZE_MISMATCH + * or ARM_MATH_SUCCESS based on the outcome of size checking. + */ + arm_status arm_mat_trans_f32( + const arm_matrix_instance_f32 * pSrc, + arm_matrix_instance_f32 * pDst); + + + /** + * @brief Q15 matrix transpose. + * @param[in] pSrc points to the input matrix + * @param[out] pDst points to the output matrix + * @return The function returns either ARM_MATH_SIZE_MISMATCH + * or ARM_MATH_SUCCESS based on the outcome of size checking. + */ + arm_status arm_mat_trans_q15( + const arm_matrix_instance_q15 * pSrc, + arm_matrix_instance_q15 * pDst); + + + /** + * @brief Q31 matrix transpose. + * @param[in] pSrc points to the input matrix + * @param[out] pDst points to the output matrix + * @return The function returns either ARM_MATH_SIZE_MISMATCH + * or ARM_MATH_SUCCESS based on the outcome of size checking. + */ + arm_status arm_mat_trans_q31( + const arm_matrix_instance_q31 * pSrc, + arm_matrix_instance_q31 * pDst); + + + /** + * @brief Floating-point matrix multiplication + * @param[in] pSrcA points to the first input matrix structure + * @param[in] pSrcB points to the second input matrix structure + * @param[out] pDst points to output matrix structure + * @return The function returns either + * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. + */ + arm_status arm_mat_mult_f32( + const arm_matrix_instance_f32 * pSrcA, + const arm_matrix_instance_f32 * pSrcB, + arm_matrix_instance_f32 * pDst); + + + /** + * @brief Q15 matrix multiplication + * @param[in] pSrcA points to the first input matrix structure + * @param[in] pSrcB points to the second input matrix structure + * @param[out] pDst points to output matrix structure + * @param[in] pState points to the array for storing intermediate results + * @return The function returns either + * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. + */ + arm_status arm_mat_mult_q15( + const arm_matrix_instance_q15 * pSrcA, + const arm_matrix_instance_q15 * pSrcB, + arm_matrix_instance_q15 * pDst, + q15_t * pState); + + + /** + * @brief Q15 matrix multiplication (fast variant) for Cortex-M3 and Cortex-M4 + * @param[in] pSrcA points to the first input matrix structure + * @param[in] pSrcB points to the second input matrix structure + * @param[out] pDst points to output matrix structure + * @param[in] pState points to the array for storing intermediate results + * @return The function returns either + * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. + */ + arm_status arm_mat_mult_fast_q15( + const arm_matrix_instance_q15 * pSrcA, + const arm_matrix_instance_q15 * pSrcB, + arm_matrix_instance_q15 * pDst, + q15_t * pState); + + + /** + * @brief Q31 matrix multiplication + * @param[in] pSrcA points to the first input matrix structure + * @param[in] pSrcB points to the second input matrix structure + * @param[out] pDst points to output matrix structure + * @return The function returns either + * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. + */ + arm_status arm_mat_mult_q31( + const arm_matrix_instance_q31 * pSrcA, + const arm_matrix_instance_q31 * pSrcB, + arm_matrix_instance_q31 * pDst); + + + /** + * @brief Q31 matrix multiplication (fast variant) for Cortex-M3 and Cortex-M4 + * @param[in] pSrcA points to the first input matrix structure + * @param[in] pSrcB points to the second input matrix structure + * @param[out] pDst points to output matrix structure + * @return The function returns either + * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. + */ + arm_status arm_mat_mult_fast_q31( + const arm_matrix_instance_q31 * pSrcA, + const arm_matrix_instance_q31 * pSrcB, + arm_matrix_instance_q31 * pDst); + + + /** + * @brief Floating-point matrix subtraction + * @param[in] pSrcA points to the first input matrix structure + * @param[in] pSrcB points to the second input matrix structure + * @param[out] pDst points to output matrix structure + * @return The function returns either + * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. + */ + arm_status arm_mat_sub_f32( + const arm_matrix_instance_f32 * pSrcA, + const arm_matrix_instance_f32 * pSrcB, + arm_matrix_instance_f32 * pDst); + + + /** + * @brief Q15 matrix subtraction + * @param[in] pSrcA points to the first input matrix structure + * @param[in] pSrcB points to the second input matrix structure + * @param[out] pDst points to output matrix structure + * @return The function returns either + * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. + */ + arm_status arm_mat_sub_q15( + const arm_matrix_instance_q15 * pSrcA, + const arm_matrix_instance_q15 * pSrcB, + arm_matrix_instance_q15 * pDst); + + + /** + * @brief Q31 matrix subtraction + * @param[in] pSrcA points to the first input matrix structure + * @param[in] pSrcB points to the second input matrix structure + * @param[out] pDst points to output matrix structure + * @return The function returns either + * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. + */ + arm_status arm_mat_sub_q31( + const arm_matrix_instance_q31 * pSrcA, + const arm_matrix_instance_q31 * pSrcB, + arm_matrix_instance_q31 * pDst); + + + /** + * @brief Floating-point matrix scaling. + * @param[in] pSrc points to the input matrix + * @param[in] scale scale factor + * @param[out] pDst points to the output matrix + * @return The function returns either + * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. + */ + arm_status arm_mat_scale_f32( + const arm_matrix_instance_f32 * pSrc, + float32_t scale, + arm_matrix_instance_f32 * pDst); + + + /** + * @brief Q15 matrix scaling. + * @param[in] pSrc points to input matrix + * @param[in] scaleFract fractional portion of the scale factor + * @param[in] shift number of bits to shift the result by + * @param[out] pDst points to output matrix + * @return The function returns either + * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. + */ + arm_status arm_mat_scale_q15( + const arm_matrix_instance_q15 * pSrc, + q15_t scaleFract, + int32_t shift, + arm_matrix_instance_q15 * pDst); + + + /** + * @brief Q31 matrix scaling. + * @param[in] pSrc points to input matrix + * @param[in] scaleFract fractional portion of the scale factor + * @param[in] shift number of bits to shift the result by + * @param[out] pDst points to output matrix structure + * @return The function returns either + * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. + */ + arm_status arm_mat_scale_q31( + const arm_matrix_instance_q31 * pSrc, + q31_t scaleFract, + int32_t shift, + arm_matrix_instance_q31 * pDst); + + + /** + * @brief Q31 matrix initialization. + * @param[in,out] S points to an instance of the floating-point matrix structure. + * @param[in] nRows number of rows in the matrix. + * @param[in] nColumns number of columns in the matrix. + * @param[in] pData points to the matrix data array. + */ + void arm_mat_init_q31( + arm_matrix_instance_q31 * S, + uint16_t nRows, + uint16_t nColumns, + q31_t * pData); + + + /** + * @brief Q15 matrix initialization. + * @param[in,out] S points to an instance of the floating-point matrix structure. + * @param[in] nRows number of rows in the matrix. + * @param[in] nColumns number of columns in the matrix. + * @param[in] pData points to the matrix data array. + */ + void arm_mat_init_q15( + arm_matrix_instance_q15 * S, + uint16_t nRows, + uint16_t nColumns, + q15_t * pData); + + + /** + * @brief Floating-point matrix initialization. + * @param[in,out] S points to an instance of the floating-point matrix structure. + * @param[in] nRows number of rows in the matrix. + * @param[in] nColumns number of columns in the matrix. + * @param[in] pData points to the matrix data array. + */ + void arm_mat_init_f32( + arm_matrix_instance_f32 * S, + uint16_t nRows, + uint16_t nColumns, + float32_t * pData); + + + + /** + * @brief Instance structure for the Q15 PID Control. + */ + typedef struct + { + q15_t A0; /**< The derived gain, A0 = Kp + Ki + Kd . */ +#ifdef ARM_MATH_CM0_FAMILY + q15_t A1; + q15_t A2; +#else + q31_t A1; /**< The derived gain A1 = -Kp - 2Kd | Kd.*/ +#endif + q15_t state[3]; /**< The state array of length 3. */ + q15_t Kp; /**< The proportional gain. */ + q15_t Ki; /**< The integral gain. */ + q15_t Kd; /**< The derivative gain. */ + } arm_pid_instance_q15; + + /** + * @brief Instance structure for the Q31 PID Control. + */ + typedef struct + { + q31_t A0; /**< The derived gain, A0 = Kp + Ki + Kd . */ + q31_t A1; /**< The derived gain, A1 = -Kp - 2Kd. */ + q31_t A2; /**< The derived gain, A2 = Kd . */ + q31_t state[3]; /**< The state array of length 3. */ + q31_t Kp; /**< The proportional gain. */ + q31_t Ki; /**< The integral gain. */ + q31_t Kd; /**< The derivative gain. */ + } arm_pid_instance_q31; + + /** + * @brief Instance structure for the floating-point PID Control. + */ + typedef struct + { + float32_t A0; /**< The derived gain, A0 = Kp + Ki + Kd . */ + float32_t A1; /**< The derived gain, A1 = -Kp - 2Kd. */ + float32_t A2; /**< The derived gain, A2 = Kd . */ + float32_t state[3]; /**< The state array of length 3. */ + float32_t Kp; /**< The proportional gain. */ + float32_t Ki; /**< The integral gain. */ + float32_t Kd; /**< The derivative gain. */ + } arm_pid_instance_f32; + + + + /** + * @brief Initialization function for the floating-point PID Control. + * @param[in,out] S points to an instance of the PID structure. + * @param[in] resetStateFlag flag to reset the state. 0 = no change in state 1 = reset the state. + */ + void arm_pid_init_f32( + arm_pid_instance_f32 * S, + int32_t resetStateFlag); + + + /** + * @brief Reset function for the floating-point PID Control. + * @param[in,out] S is an instance of the floating-point PID Control structure + */ + void arm_pid_reset_f32( + arm_pid_instance_f32 * S); + + + /** + * @brief Initialization function for the Q31 PID Control. + * @param[in,out] S points to an instance of the Q15 PID structure. + * @param[in] resetStateFlag flag to reset the state. 0 = no change in state 1 = reset the state. + */ + void arm_pid_init_q31( + arm_pid_instance_q31 * S, + int32_t resetStateFlag); + + + /** + * @brief Reset function for the Q31 PID Control. + * @param[in,out] S points to an instance of the Q31 PID Control structure + */ + + void arm_pid_reset_q31( + arm_pid_instance_q31 * S); + + + /** + * @brief Initialization function for the Q15 PID Control. + * @param[in,out] S points to an instance of the Q15 PID structure. + * @param[in] resetStateFlag flag to reset the state. 0 = no change in state 1 = reset the state. + */ + void arm_pid_init_q15( + arm_pid_instance_q15 * S, + int32_t resetStateFlag); + + + /** + * @brief Reset function for the Q15 PID Control. + * @param[in,out] S points to an instance of the q15 PID Control structure + */ + void arm_pid_reset_q15( + arm_pid_instance_q15 * S); + + + /** + * @brief Instance structure for the floating-point Linear Interpolate function. + */ + typedef struct + { + uint32_t nValues; /**< nValues */ + float32_t x1; /**< x1 */ + float32_t xSpacing; /**< xSpacing */ + float32_t *pYData; /**< pointer to the table of Y values */ + } arm_linear_interp_instance_f32; + + /** + * @brief Instance structure for the floating-point bilinear interpolation function. + */ + typedef struct + { + uint16_t numRows; /**< number of rows in the data table. */ + uint16_t numCols; /**< number of columns in the data table. */ + float32_t *pData; /**< points to the data table. */ + } arm_bilinear_interp_instance_f32; + + /** + * @brief Instance structure for the Q31 bilinear interpolation function. + */ + typedef struct + { + uint16_t numRows; /**< number of rows in the data table. */ + uint16_t numCols; /**< number of columns in the data table. */ + q31_t *pData; /**< points to the data table. */ + } arm_bilinear_interp_instance_q31; + + /** + * @brief Instance structure for the Q15 bilinear interpolation function. + */ + typedef struct + { + uint16_t numRows; /**< number of rows in the data table. */ + uint16_t numCols; /**< number of columns in the data table. */ + q15_t *pData; /**< points to the data table. */ + } arm_bilinear_interp_instance_q15; + + /** + * @brief Instance structure for the Q15 bilinear interpolation function. + */ + typedef struct + { + uint16_t numRows; /**< number of rows in the data table. */ + uint16_t numCols; /**< number of columns in the data table. */ + q7_t *pData; /**< points to the data table. */ + } arm_bilinear_interp_instance_q7; + + + /** + * @brief Q7 vector multiplication. + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in each vector + */ + void arm_mult_q7( + q7_t * pSrcA, + q7_t * pSrcB, + q7_t * pDst, + uint32_t blockSize); + + + /** + * @brief Q15 vector multiplication. + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in each vector + */ + void arm_mult_q15( + q15_t * pSrcA, + q15_t * pSrcB, + q15_t * pDst, + uint32_t blockSize); + + + /** + * @brief Q31 vector multiplication. + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in each vector + */ + void arm_mult_q31( + q31_t * pSrcA, + q31_t * pSrcB, + q31_t * pDst, + uint32_t blockSize); + + + /** + * @brief Floating-point vector multiplication. + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in each vector + */ + void arm_mult_f32( + float32_t * pSrcA, + float32_t * pSrcB, + float32_t * pDst, + uint32_t blockSize); + + + /** + * @brief Instance structure for the Q15 CFFT/CIFFT function. + */ + typedef struct + { + uint16_t fftLen; /**< length of the FFT. */ + uint8_t ifftFlag; /**< flag that selects forward (ifftFlag=0) or inverse (ifftFlag=1) transform. */ + uint8_t bitReverseFlag; /**< flag that enables (bitReverseFlag=1) or disables (bitReverseFlag=0) bit reversal of output. */ + q15_t *pTwiddle; /**< points to the Sin twiddle factor table. */ + uint16_t *pBitRevTable; /**< points to the bit reversal table. */ + uint16_t twidCoefModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */ + uint16_t bitRevFactor; /**< bit reversal modifier that supports different size FFTs with the same bit reversal table. */ + } arm_cfft_radix2_instance_q15; + +/* Deprecated */ + arm_status arm_cfft_radix2_init_q15( + arm_cfft_radix2_instance_q15 * S, + uint16_t fftLen, + uint8_t ifftFlag, + uint8_t bitReverseFlag); + +/* Deprecated */ + void arm_cfft_radix2_q15( + const arm_cfft_radix2_instance_q15 * S, + q15_t * pSrc); + + + /** + * @brief Instance structure for the Q15 CFFT/CIFFT function. + */ + typedef struct + { + uint16_t fftLen; /**< length of the FFT. */ + uint8_t ifftFlag; /**< flag that selects forward (ifftFlag=0) or inverse (ifftFlag=1) transform. */ + uint8_t bitReverseFlag; /**< flag that enables (bitReverseFlag=1) or disables (bitReverseFlag=0) bit reversal of output. */ + q15_t *pTwiddle; /**< points to the twiddle factor table. */ + uint16_t *pBitRevTable; /**< points to the bit reversal table. */ + uint16_t twidCoefModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */ + uint16_t bitRevFactor; /**< bit reversal modifier that supports different size FFTs with the same bit reversal table. */ + } arm_cfft_radix4_instance_q15; + +/* Deprecated */ + arm_status arm_cfft_radix4_init_q15( + arm_cfft_radix4_instance_q15 * S, + uint16_t fftLen, + uint8_t ifftFlag, + uint8_t bitReverseFlag); + +/* Deprecated */ + void arm_cfft_radix4_q15( + const arm_cfft_radix4_instance_q15 * S, + q15_t * pSrc); + + /** + * @brief Instance structure for the Radix-2 Q31 CFFT/CIFFT function. + */ + typedef struct + { + uint16_t fftLen; /**< length of the FFT. */ + uint8_t ifftFlag; /**< flag that selects forward (ifftFlag=0) or inverse (ifftFlag=1) transform. */ + uint8_t bitReverseFlag; /**< flag that enables (bitReverseFlag=1) or disables (bitReverseFlag=0) bit reversal of output. */ + q31_t *pTwiddle; /**< points to the Twiddle factor table. */ + uint16_t *pBitRevTable; /**< points to the bit reversal table. */ + uint16_t twidCoefModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */ + uint16_t bitRevFactor; /**< bit reversal modifier that supports different size FFTs with the same bit reversal table. */ + } arm_cfft_radix2_instance_q31; + +/* Deprecated */ + arm_status arm_cfft_radix2_init_q31( + arm_cfft_radix2_instance_q31 * S, + uint16_t fftLen, + uint8_t ifftFlag, + uint8_t bitReverseFlag); + +/* Deprecated */ + void arm_cfft_radix2_q31( + const arm_cfft_radix2_instance_q31 * S, + q31_t * pSrc); + + /** + * @brief Instance structure for the Q31 CFFT/CIFFT function. + */ + typedef struct + { + uint16_t fftLen; /**< length of the FFT. */ + uint8_t ifftFlag; /**< flag that selects forward (ifftFlag=0) or inverse (ifftFlag=1) transform. */ + uint8_t bitReverseFlag; /**< flag that enables (bitReverseFlag=1) or disables (bitReverseFlag=0) bit reversal of output. */ + q31_t *pTwiddle; /**< points to the twiddle factor table. */ + uint16_t *pBitRevTable; /**< points to the bit reversal table. */ + uint16_t twidCoefModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */ + uint16_t bitRevFactor; /**< bit reversal modifier that supports different size FFTs with the same bit reversal table. */ + } arm_cfft_radix4_instance_q31; + +/* Deprecated */ + void arm_cfft_radix4_q31( + const arm_cfft_radix4_instance_q31 * S, + q31_t * pSrc); + +/* Deprecated */ + arm_status arm_cfft_radix4_init_q31( + arm_cfft_radix4_instance_q31 * S, + uint16_t fftLen, + uint8_t ifftFlag, + uint8_t bitReverseFlag); + + /** + * @brief Instance structure for the floating-point CFFT/CIFFT function. + */ + typedef struct + { + uint16_t fftLen; /**< length of the FFT. */ + uint8_t ifftFlag; /**< flag that selects forward (ifftFlag=0) or inverse (ifftFlag=1) transform. */ + uint8_t bitReverseFlag; /**< flag that enables (bitReverseFlag=1) or disables (bitReverseFlag=0) bit reversal of output. */ + float32_t *pTwiddle; /**< points to the Twiddle factor table. */ + uint16_t *pBitRevTable; /**< points to the bit reversal table. */ + uint16_t twidCoefModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */ + uint16_t bitRevFactor; /**< bit reversal modifier that supports different size FFTs with the same bit reversal table. */ + float32_t onebyfftLen; /**< value of 1/fftLen. */ + } arm_cfft_radix2_instance_f32; + +/* Deprecated */ + arm_status arm_cfft_radix2_init_f32( + arm_cfft_radix2_instance_f32 * S, + uint16_t fftLen, + uint8_t ifftFlag, + uint8_t bitReverseFlag); + +/* Deprecated */ + void arm_cfft_radix2_f32( + const arm_cfft_radix2_instance_f32 * S, + float32_t * pSrc); + + /** + * @brief Instance structure for the floating-point CFFT/CIFFT function. + */ + typedef struct + { + uint16_t fftLen; /**< length of the FFT. */ + uint8_t ifftFlag; /**< flag that selects forward (ifftFlag=0) or inverse (ifftFlag=1) transform. */ + uint8_t bitReverseFlag; /**< flag that enables (bitReverseFlag=1) or disables (bitReverseFlag=0) bit reversal of output. */ + float32_t *pTwiddle; /**< points to the Twiddle factor table. */ + uint16_t *pBitRevTable; /**< points to the bit reversal table. */ + uint16_t twidCoefModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */ + uint16_t bitRevFactor; /**< bit reversal modifier that supports different size FFTs with the same bit reversal table. */ + float32_t onebyfftLen; /**< value of 1/fftLen. */ + } arm_cfft_radix4_instance_f32; + +/* Deprecated */ + arm_status arm_cfft_radix4_init_f32( + arm_cfft_radix4_instance_f32 * S, + uint16_t fftLen, + uint8_t ifftFlag, + uint8_t bitReverseFlag); + +/* Deprecated */ + void arm_cfft_radix4_f32( + const arm_cfft_radix4_instance_f32 * S, + float32_t * pSrc); + + /** + * @brief Instance structure for the fixed-point CFFT/CIFFT function. + */ + typedef struct + { + uint16_t fftLen; /**< length of the FFT. */ + const q15_t *pTwiddle; /**< points to the Twiddle factor table. */ + const uint16_t *pBitRevTable; /**< points to the bit reversal table. */ + uint16_t bitRevLength; /**< bit reversal table length. */ + } arm_cfft_instance_q15; + +void arm_cfft_q15( + const arm_cfft_instance_q15 * S, + q15_t * p1, + uint8_t ifftFlag, + uint8_t bitReverseFlag); + + /** + * @brief Instance structure for the fixed-point CFFT/CIFFT function. + */ + typedef struct + { + uint16_t fftLen; /**< length of the FFT. */ + const q31_t *pTwiddle; /**< points to the Twiddle factor table. */ + const uint16_t *pBitRevTable; /**< points to the bit reversal table. */ + uint16_t bitRevLength; /**< bit reversal table length. */ + } arm_cfft_instance_q31; + +void arm_cfft_q31( + const arm_cfft_instance_q31 * S, + q31_t * p1, + uint8_t ifftFlag, + uint8_t bitReverseFlag); + + /** + * @brief Instance structure for the floating-point CFFT/CIFFT function. + */ + typedef struct + { + uint16_t fftLen; /**< length of the FFT. */ + const float32_t *pTwiddle; /**< points to the Twiddle factor table. */ + const uint16_t *pBitRevTable; /**< points to the bit reversal table. */ + uint16_t bitRevLength; /**< bit reversal table length. */ + } arm_cfft_instance_f32; + + void arm_cfft_f32( + const arm_cfft_instance_f32 * S, + float32_t * p1, + uint8_t ifftFlag, + uint8_t bitReverseFlag); + + /** + * @brief Instance structure for the Q15 RFFT/RIFFT function. + */ + typedef struct + { + uint32_t fftLenReal; /**< length of the real FFT. */ + uint8_t ifftFlagR; /**< flag that selects forward (ifftFlagR=0) or inverse (ifftFlagR=1) transform. */ + uint8_t bitReverseFlagR; /**< flag that enables (bitReverseFlagR=1) or disables (bitReverseFlagR=0) bit reversal of output. */ + uint32_t twidCoefRModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */ + q15_t *pTwiddleAReal; /**< points to the real twiddle factor table. */ + q15_t *pTwiddleBReal; /**< points to the imag twiddle factor table. */ + const arm_cfft_instance_q15 *pCfft; /**< points to the complex FFT instance. */ + } arm_rfft_instance_q15; + + arm_status arm_rfft_init_q15( + arm_rfft_instance_q15 * S, + uint32_t fftLenReal, + uint32_t ifftFlagR, + uint32_t bitReverseFlag); + + void arm_rfft_q15( + const arm_rfft_instance_q15 * S, + q15_t * pSrc, + q15_t * pDst); + + /** + * @brief Instance structure for the Q31 RFFT/RIFFT function. + */ + typedef struct + { + uint32_t fftLenReal; /**< length of the real FFT. */ + uint8_t ifftFlagR; /**< flag that selects forward (ifftFlagR=0) or inverse (ifftFlagR=1) transform. */ + uint8_t bitReverseFlagR; /**< flag that enables (bitReverseFlagR=1) or disables (bitReverseFlagR=0) bit reversal of output. */ + uint32_t twidCoefRModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */ + q31_t *pTwiddleAReal; /**< points to the real twiddle factor table. */ + q31_t *pTwiddleBReal; /**< points to the imag twiddle factor table. */ + const arm_cfft_instance_q31 *pCfft; /**< points to the complex FFT instance. */ + } arm_rfft_instance_q31; + + arm_status arm_rfft_init_q31( + arm_rfft_instance_q31 * S, + uint32_t fftLenReal, + uint32_t ifftFlagR, + uint32_t bitReverseFlag); + + void arm_rfft_q31( + const arm_rfft_instance_q31 * S, + q31_t * pSrc, + q31_t * pDst); + + /** + * @brief Instance structure for the floating-point RFFT/RIFFT function. + */ + typedef struct + { + uint32_t fftLenReal; /**< length of the real FFT. */ + uint16_t fftLenBy2; /**< length of the complex FFT. */ + uint8_t ifftFlagR; /**< flag that selects forward (ifftFlagR=0) or inverse (ifftFlagR=1) transform. */ + uint8_t bitReverseFlagR; /**< flag that enables (bitReverseFlagR=1) or disables (bitReverseFlagR=0) bit reversal of output. */ + uint32_t twidCoefRModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */ + float32_t *pTwiddleAReal; /**< points to the real twiddle factor table. */ + float32_t *pTwiddleBReal; /**< points to the imag twiddle factor table. */ + arm_cfft_radix4_instance_f32 *pCfft; /**< points to the complex FFT instance. */ + } arm_rfft_instance_f32; + + arm_status arm_rfft_init_f32( + arm_rfft_instance_f32 * S, + arm_cfft_radix4_instance_f32 * S_CFFT, + uint32_t fftLenReal, + uint32_t ifftFlagR, + uint32_t bitReverseFlag); + + void arm_rfft_f32( + const arm_rfft_instance_f32 * S, + float32_t * pSrc, + float32_t * pDst); + + /** + * @brief Instance structure for the floating-point RFFT/RIFFT function. + */ +typedef struct + { + arm_cfft_instance_f32 Sint; /**< Internal CFFT structure. */ + uint16_t fftLenRFFT; /**< length of the real sequence */ + float32_t * pTwiddleRFFT; /**< Twiddle factors real stage */ + } arm_rfft_fast_instance_f32 ; + +arm_status arm_rfft_fast_init_f32 ( + arm_rfft_fast_instance_f32 * S, + uint16_t fftLen); + +void arm_rfft_fast_f32( + arm_rfft_fast_instance_f32 * S, + float32_t * p, float32_t * pOut, + uint8_t ifftFlag); + + /** + * @brief Instance structure for the floating-point DCT4/IDCT4 function. + */ + typedef struct + { + uint16_t N; /**< length of the DCT4. */ + uint16_t Nby2; /**< half of the length of the DCT4. */ + float32_t normalize; /**< normalizing factor. */ + float32_t *pTwiddle; /**< points to the twiddle factor table. */ + float32_t *pCosFactor; /**< points to the cosFactor table. */ + arm_rfft_instance_f32 *pRfft; /**< points to the real FFT instance. */ + arm_cfft_radix4_instance_f32 *pCfft; /**< points to the complex FFT instance. */ + } arm_dct4_instance_f32; + + + /** + * @brief Initialization function for the floating-point DCT4/IDCT4. + * @param[in,out] S points to an instance of floating-point DCT4/IDCT4 structure. + * @param[in] S_RFFT points to an instance of floating-point RFFT/RIFFT structure. + * @param[in] S_CFFT points to an instance of floating-point CFFT/CIFFT structure. + * @param[in] N length of the DCT4. + * @param[in] Nby2 half of the length of the DCT4. + * @param[in] normalize normalizing factor. + * @return arm_status function returns ARM_MATH_SUCCESS if initialization is successful or ARM_MATH_ARGUMENT_ERROR if fftLenReal is not a supported transform length. + */ + arm_status arm_dct4_init_f32( + arm_dct4_instance_f32 * S, + arm_rfft_instance_f32 * S_RFFT, + arm_cfft_radix4_instance_f32 * S_CFFT, + uint16_t N, + uint16_t Nby2, + float32_t normalize); + + + /** + * @brief Processing function for the floating-point DCT4/IDCT4. + * @param[in] S points to an instance of the floating-point DCT4/IDCT4 structure. + * @param[in] pState points to state buffer. + * @param[in,out] pInlineBuffer points to the in-place input and output buffer. + */ + void arm_dct4_f32( + const arm_dct4_instance_f32 * S, + float32_t * pState, + float32_t * pInlineBuffer); + + + /** + * @brief Instance structure for the Q31 DCT4/IDCT4 function. + */ + typedef struct + { + uint16_t N; /**< length of the DCT4. */ + uint16_t Nby2; /**< half of the length of the DCT4. */ + q31_t normalize; /**< normalizing factor. */ + q31_t *pTwiddle; /**< points to the twiddle factor table. */ + q31_t *pCosFactor; /**< points to the cosFactor table. */ + arm_rfft_instance_q31 *pRfft; /**< points to the real FFT instance. */ + arm_cfft_radix4_instance_q31 *pCfft; /**< points to the complex FFT instance. */ + } arm_dct4_instance_q31; + + + /** + * @brief Initialization function for the Q31 DCT4/IDCT4. + * @param[in,out] S points to an instance of Q31 DCT4/IDCT4 structure. + * @param[in] S_RFFT points to an instance of Q31 RFFT/RIFFT structure + * @param[in] S_CFFT points to an instance of Q31 CFFT/CIFFT structure + * @param[in] N length of the DCT4. + * @param[in] Nby2 half of the length of the DCT4. + * @param[in] normalize normalizing factor. + * @return arm_status function returns ARM_MATH_SUCCESS if initialization is successful or ARM_MATH_ARGUMENT_ERROR if N is not a supported transform length. + */ + arm_status arm_dct4_init_q31( + arm_dct4_instance_q31 * S, + arm_rfft_instance_q31 * S_RFFT, + arm_cfft_radix4_instance_q31 * S_CFFT, + uint16_t N, + uint16_t Nby2, + q31_t normalize); + + + /** + * @brief Processing function for the Q31 DCT4/IDCT4. + * @param[in] S points to an instance of the Q31 DCT4 structure. + * @param[in] pState points to state buffer. + * @param[in,out] pInlineBuffer points to the in-place input and output buffer. + */ + void arm_dct4_q31( + const arm_dct4_instance_q31 * S, + q31_t * pState, + q31_t * pInlineBuffer); + + + /** + * @brief Instance structure for the Q15 DCT4/IDCT4 function. + */ + typedef struct + { + uint16_t N; /**< length of the DCT4. */ + uint16_t Nby2; /**< half of the length of the DCT4. */ + q15_t normalize; /**< normalizing factor. */ + q15_t *pTwiddle; /**< points to the twiddle factor table. */ + q15_t *pCosFactor; /**< points to the cosFactor table. */ + arm_rfft_instance_q15 *pRfft; /**< points to the real FFT instance. */ + arm_cfft_radix4_instance_q15 *pCfft; /**< points to the complex FFT instance. */ + } arm_dct4_instance_q15; + + + /** + * @brief Initialization function for the Q15 DCT4/IDCT4. + * @param[in,out] S points to an instance of Q15 DCT4/IDCT4 structure. + * @param[in] S_RFFT points to an instance of Q15 RFFT/RIFFT structure. + * @param[in] S_CFFT points to an instance of Q15 CFFT/CIFFT structure. + * @param[in] N length of the DCT4. + * @param[in] Nby2 half of the length of the DCT4. + * @param[in] normalize normalizing factor. + * @return arm_status function returns ARM_MATH_SUCCESS if initialization is successful or ARM_MATH_ARGUMENT_ERROR if N is not a supported transform length. + */ + arm_status arm_dct4_init_q15( + arm_dct4_instance_q15 * S, + arm_rfft_instance_q15 * S_RFFT, + arm_cfft_radix4_instance_q15 * S_CFFT, + uint16_t N, + uint16_t Nby2, + q15_t normalize); + + + /** + * @brief Processing function for the Q15 DCT4/IDCT4. + * @param[in] S points to an instance of the Q15 DCT4 structure. + * @param[in] pState points to state buffer. + * @param[in,out] pInlineBuffer points to the in-place input and output buffer. + */ + void arm_dct4_q15( + const arm_dct4_instance_q15 * S, + q15_t * pState, + q15_t * pInlineBuffer); + + + /** + * @brief Floating-point vector addition. + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in each vector + */ + void arm_add_f32( + float32_t * pSrcA, + float32_t * pSrcB, + float32_t * pDst, + uint32_t blockSize); + + + /** + * @brief Q7 vector addition. + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in each vector + */ + void arm_add_q7( + q7_t * pSrcA, + q7_t * pSrcB, + q7_t * pDst, + uint32_t blockSize); + + + /** + * @brief Q15 vector addition. + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in each vector + */ + void arm_add_q15( + q15_t * pSrcA, + q15_t * pSrcB, + q15_t * pDst, + uint32_t blockSize); + + + /** + * @brief Q31 vector addition. + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in each vector + */ + void arm_add_q31( + q31_t * pSrcA, + q31_t * pSrcB, + q31_t * pDst, + uint32_t blockSize); + + + /** + * @brief Floating-point vector subtraction. + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in each vector + */ + void arm_sub_f32( + float32_t * pSrcA, + float32_t * pSrcB, + float32_t * pDst, + uint32_t blockSize); + + + /** + * @brief Q7 vector subtraction. + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in each vector + */ + void arm_sub_q7( + q7_t * pSrcA, + q7_t * pSrcB, + q7_t * pDst, + uint32_t blockSize); + + + /** + * @brief Q15 vector subtraction. + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in each vector + */ + void arm_sub_q15( + q15_t * pSrcA, + q15_t * pSrcB, + q15_t * pDst, + uint32_t blockSize); + + + /** + * @brief Q31 vector subtraction. + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in each vector + */ + void arm_sub_q31( + q31_t * pSrcA, + q31_t * pSrcB, + q31_t * pDst, + uint32_t blockSize); + + + /** + * @brief Multiplies a floating-point vector by a scalar. + * @param[in] pSrc points to the input vector + * @param[in] scale scale factor to be applied + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in the vector + */ + void arm_scale_f32( + float32_t * pSrc, + float32_t scale, + float32_t * pDst, + uint32_t blockSize); + + + /** + * @brief Multiplies a Q7 vector by a scalar. + * @param[in] pSrc points to the input vector + * @param[in] scaleFract fractional portion of the scale value + * @param[in] shift number of bits to shift the result by + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in the vector + */ + void arm_scale_q7( + q7_t * pSrc, + q7_t scaleFract, + int8_t shift, + q7_t * pDst, + uint32_t blockSize); + + + /** + * @brief Multiplies a Q15 vector by a scalar. + * @param[in] pSrc points to the input vector + * @param[in] scaleFract fractional portion of the scale value + * @param[in] shift number of bits to shift the result by + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in the vector + */ + void arm_scale_q15( + q15_t * pSrc, + q15_t scaleFract, + int8_t shift, + q15_t * pDst, + uint32_t blockSize); + + + /** + * @brief Multiplies a Q31 vector by a scalar. + * @param[in] pSrc points to the input vector + * @param[in] scaleFract fractional portion of the scale value + * @param[in] shift number of bits to shift the result by + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in the vector + */ + void arm_scale_q31( + q31_t * pSrc, + q31_t scaleFract, + int8_t shift, + q31_t * pDst, + uint32_t blockSize); + + + /** + * @brief Q7 vector absolute value. + * @param[in] pSrc points to the input buffer + * @param[out] pDst points to the output buffer + * @param[in] blockSize number of samples in each vector + */ + void arm_abs_q7( + q7_t * pSrc, + q7_t * pDst, + uint32_t blockSize); + + + /** + * @brief Floating-point vector absolute value. + * @param[in] pSrc points to the input buffer + * @param[out] pDst points to the output buffer + * @param[in] blockSize number of samples in each vector + */ + void arm_abs_f32( + float32_t * pSrc, + float32_t * pDst, + uint32_t blockSize); + + + /** + * @brief Q15 vector absolute value. + * @param[in] pSrc points to the input buffer + * @param[out] pDst points to the output buffer + * @param[in] blockSize number of samples in each vector + */ + void arm_abs_q15( + q15_t * pSrc, + q15_t * pDst, + uint32_t blockSize); + + + /** + * @brief Q31 vector absolute value. + * @param[in] pSrc points to the input buffer + * @param[out] pDst points to the output buffer + * @param[in] blockSize number of samples in each vector + */ + void arm_abs_q31( + q31_t * pSrc, + q31_t * pDst, + uint32_t blockSize); + + + /** + * @brief Dot product of floating-point vectors. + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[in] blockSize number of samples in each vector + * @param[out] result output result returned here + */ + void arm_dot_prod_f32( + float32_t * pSrcA, + float32_t * pSrcB, + uint32_t blockSize, + float32_t * result); + + + /** + * @brief Dot product of Q7 vectors. + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[in] blockSize number of samples in each vector + * @param[out] result output result returned here + */ + void arm_dot_prod_q7( + q7_t * pSrcA, + q7_t * pSrcB, + uint32_t blockSize, + q31_t * result); + + + /** + * @brief Dot product of Q15 vectors. + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[in] blockSize number of samples in each vector + * @param[out] result output result returned here + */ + void arm_dot_prod_q15( + q15_t * pSrcA, + q15_t * pSrcB, + uint32_t blockSize, + q63_t * result); + + + /** + * @brief Dot product of Q31 vectors. + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[in] blockSize number of samples in each vector + * @param[out] result output result returned here + */ + void arm_dot_prod_q31( + q31_t * pSrcA, + q31_t * pSrcB, + uint32_t blockSize, + q63_t * result); + + + /** + * @brief Shifts the elements of a Q7 vector a specified number of bits. + * @param[in] pSrc points to the input vector + * @param[in] shiftBits number of bits to shift. A positive value shifts left; a negative value shifts right. + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in the vector + */ + void arm_shift_q7( + q7_t * pSrc, + int8_t shiftBits, + q7_t * pDst, + uint32_t blockSize); + + + /** + * @brief Shifts the elements of a Q15 vector a specified number of bits. + * @param[in] pSrc points to the input vector + * @param[in] shiftBits number of bits to shift. A positive value shifts left; a negative value shifts right. + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in the vector + */ + void arm_shift_q15( + q15_t * pSrc, + int8_t shiftBits, + q15_t * pDst, + uint32_t blockSize); + + + /** + * @brief Shifts the elements of a Q31 vector a specified number of bits. + * @param[in] pSrc points to the input vector + * @param[in] shiftBits number of bits to shift. A positive value shifts left; a negative value shifts right. + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in the vector + */ + void arm_shift_q31( + q31_t * pSrc, + int8_t shiftBits, + q31_t * pDst, + uint32_t blockSize); + + + /** + * @brief Adds a constant offset to a floating-point vector. + * @param[in] pSrc points to the input vector + * @param[in] offset is the offset to be added + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in the vector + */ + void arm_offset_f32( + float32_t * pSrc, + float32_t offset, + float32_t * pDst, + uint32_t blockSize); + + + /** + * @brief Adds a constant offset to a Q7 vector. + * @param[in] pSrc points to the input vector + * @param[in] offset is the offset to be added + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in the vector + */ + void arm_offset_q7( + q7_t * pSrc, + q7_t offset, + q7_t * pDst, + uint32_t blockSize); + + + /** + * @brief Adds a constant offset to a Q15 vector. + * @param[in] pSrc points to the input vector + * @param[in] offset is the offset to be added + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in the vector + */ + void arm_offset_q15( + q15_t * pSrc, + q15_t offset, + q15_t * pDst, + uint32_t blockSize); + + + /** + * @brief Adds a constant offset to a Q31 vector. + * @param[in] pSrc points to the input vector + * @param[in] offset is the offset to be added + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in the vector + */ + void arm_offset_q31( + q31_t * pSrc, + q31_t offset, + q31_t * pDst, + uint32_t blockSize); + + + /** + * @brief Negates the elements of a floating-point vector. + * @param[in] pSrc points to the input vector + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in the vector + */ + void arm_negate_f32( + float32_t * pSrc, + float32_t * pDst, + uint32_t blockSize); + + + /** + * @brief Negates the elements of a Q7 vector. + * @param[in] pSrc points to the input vector + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in the vector + */ + void arm_negate_q7( + q7_t * pSrc, + q7_t * pDst, + uint32_t blockSize); + + + /** + * @brief Negates the elements of a Q15 vector. + * @param[in] pSrc points to the input vector + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in the vector + */ + void arm_negate_q15( + q15_t * pSrc, + q15_t * pDst, + uint32_t blockSize); + + + /** + * @brief Negates the elements of a Q31 vector. + * @param[in] pSrc points to the input vector + * @param[out] pDst points to the output vector + * @param[in] blockSize number of samples in the vector + */ + void arm_negate_q31( + q31_t * pSrc, + q31_t * pDst, + uint32_t blockSize); + + + /** + * @brief Copies the elements of a floating-point vector. + * @param[in] pSrc input pointer + * @param[out] pDst output pointer + * @param[in] blockSize number of samples to process + */ + void arm_copy_f32( + float32_t * pSrc, + float32_t * pDst, + uint32_t blockSize); + + + /** + * @brief Copies the elements of a Q7 vector. + * @param[in] pSrc input pointer + * @param[out] pDst output pointer + * @param[in] blockSize number of samples to process + */ + void arm_copy_q7( + q7_t * pSrc, + q7_t * pDst, + uint32_t blockSize); + + + /** + * @brief Copies the elements of a Q15 vector. + * @param[in] pSrc input pointer + * @param[out] pDst output pointer + * @param[in] blockSize number of samples to process + */ + void arm_copy_q15( + q15_t * pSrc, + q15_t * pDst, + uint32_t blockSize); + + + /** + * @brief Copies the elements of a Q31 vector. + * @param[in] pSrc input pointer + * @param[out] pDst output pointer + * @param[in] blockSize number of samples to process + */ + void arm_copy_q31( + q31_t * pSrc, + q31_t * pDst, + uint32_t blockSize); + + + /** + * @brief Fills a constant value into a floating-point vector. + * @param[in] value input value to be filled + * @param[out] pDst output pointer + * @param[in] blockSize number of samples to process + */ + void arm_fill_f32( + float32_t value, + float32_t * pDst, + uint32_t blockSize); + + + /** + * @brief Fills a constant value into a Q7 vector. + * @param[in] value input value to be filled + * @param[out] pDst output pointer + * @param[in] blockSize number of samples to process + */ + void arm_fill_q7( + q7_t value, + q7_t * pDst, + uint32_t blockSize); + + + /** + * @brief Fills a constant value into a Q15 vector. + * @param[in] value input value to be filled + * @param[out] pDst output pointer + * @param[in] blockSize number of samples to process + */ + void arm_fill_q15( + q15_t value, + q15_t * pDst, + uint32_t blockSize); + + + /** + * @brief Fills a constant value into a Q31 vector. + * @param[in] value input value to be filled + * @param[out] pDst output pointer + * @param[in] blockSize number of samples to process + */ + void arm_fill_q31( + q31_t value, + q31_t * pDst, + uint32_t blockSize); + + +/** + * @brief Convolution of floating-point sequences. + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the location where the output result is written. Length srcALen+srcBLen-1. + */ + void arm_conv_f32( + float32_t * pSrcA, + uint32_t srcALen, + float32_t * pSrcB, + uint32_t srcBLen, + float32_t * pDst); + + + /** + * @brief Convolution of Q15 sequences. + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data Length srcALen+srcBLen-1. + * @param[in] pScratch1 points to scratch buffer of size max(srcALen, srcBLen) + 2*min(srcALen, srcBLen) - 2. + * @param[in] pScratch2 points to scratch buffer of size min(srcALen, srcBLen). + */ + void arm_conv_opt_q15( + q15_t * pSrcA, + uint32_t srcALen, + q15_t * pSrcB, + uint32_t srcBLen, + q15_t * pDst, + q15_t * pScratch1, + q15_t * pScratch2); + + +/** + * @brief Convolution of Q15 sequences. + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the location where the output result is written. Length srcALen+srcBLen-1. + */ + void arm_conv_q15( + q15_t * pSrcA, + uint32_t srcALen, + q15_t * pSrcB, + uint32_t srcBLen, + q15_t * pDst); + + + /** + * @brief Convolution of Q15 sequences (fast version) for Cortex-M3 and Cortex-M4 + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data Length srcALen+srcBLen-1. + */ + void arm_conv_fast_q15( + q15_t * pSrcA, + uint32_t srcALen, + q15_t * pSrcB, + uint32_t srcBLen, + q15_t * pDst); + + + /** + * @brief Convolution of Q15 sequences (fast version) for Cortex-M3 and Cortex-M4 + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data Length srcALen+srcBLen-1. + * @param[in] pScratch1 points to scratch buffer of size max(srcALen, srcBLen) + 2*min(srcALen, srcBLen) - 2. + * @param[in] pScratch2 points to scratch buffer of size min(srcALen, srcBLen). + */ + void arm_conv_fast_opt_q15( + q15_t * pSrcA, + uint32_t srcALen, + q15_t * pSrcB, + uint32_t srcBLen, + q15_t * pDst, + q15_t * pScratch1, + q15_t * pScratch2); + + + /** + * @brief Convolution of Q31 sequences. + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data Length srcALen+srcBLen-1. + */ + void arm_conv_q31( + q31_t * pSrcA, + uint32_t srcALen, + q31_t * pSrcB, + uint32_t srcBLen, + q31_t * pDst); + + + /** + * @brief Convolution of Q31 sequences (fast version) for Cortex-M3 and Cortex-M4 + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data Length srcALen+srcBLen-1. + */ + void arm_conv_fast_q31( + q31_t * pSrcA, + uint32_t srcALen, + q31_t * pSrcB, + uint32_t srcBLen, + q31_t * pDst); + + + /** + * @brief Convolution of Q7 sequences. + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data Length srcALen+srcBLen-1. + * @param[in] pScratch1 points to scratch buffer(of type q15_t) of size max(srcALen, srcBLen) + 2*min(srcALen, srcBLen) - 2. + * @param[in] pScratch2 points to scratch buffer (of type q15_t) of size min(srcALen, srcBLen). + */ + void arm_conv_opt_q7( + q7_t * pSrcA, + uint32_t srcALen, + q7_t * pSrcB, + uint32_t srcBLen, + q7_t * pDst, + q15_t * pScratch1, + q15_t * pScratch2); + + + /** + * @brief Convolution of Q7 sequences. + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data Length srcALen+srcBLen-1. + */ + void arm_conv_q7( + q7_t * pSrcA, + uint32_t srcALen, + q7_t * pSrcB, + uint32_t srcBLen, + q7_t * pDst); + + + /** + * @brief Partial convolution of floating-point sequences. + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data + * @param[in] firstIndex is the first output sample to start with. + * @param[in] numPoints is the number of output points to be computed. + * @return Returns either ARM_MATH_SUCCESS if the function completed correctly or ARM_MATH_ARGUMENT_ERROR if the requested subset is not in the range [0 srcALen+srcBLen-2]. + */ + arm_status arm_conv_partial_f32( + float32_t * pSrcA, + uint32_t srcALen, + float32_t * pSrcB, + uint32_t srcBLen, + float32_t * pDst, + uint32_t firstIndex, + uint32_t numPoints); + + + /** + * @brief Partial convolution of Q15 sequences. + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data + * @param[in] firstIndex is the first output sample to start with. + * @param[in] numPoints is the number of output points to be computed. + * @param[in] pScratch1 points to scratch buffer of size max(srcALen, srcBLen) + 2*min(srcALen, srcBLen) - 2. + * @param[in] pScratch2 points to scratch buffer of size min(srcALen, srcBLen). + * @return Returns either ARM_MATH_SUCCESS if the function completed correctly or ARM_MATH_ARGUMENT_ERROR if the requested subset is not in the range [0 srcALen+srcBLen-2]. + */ + arm_status arm_conv_partial_opt_q15( + q15_t * pSrcA, + uint32_t srcALen, + q15_t * pSrcB, + uint32_t srcBLen, + q15_t * pDst, + uint32_t firstIndex, + uint32_t numPoints, + q15_t * pScratch1, + q15_t * pScratch2); + + + /** + * @brief Partial convolution of Q15 sequences. + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data + * @param[in] firstIndex is the first output sample to start with. + * @param[in] numPoints is the number of output points to be computed. + * @return Returns either ARM_MATH_SUCCESS if the function completed correctly or ARM_MATH_ARGUMENT_ERROR if the requested subset is not in the range [0 srcALen+srcBLen-2]. + */ + arm_status arm_conv_partial_q15( + q15_t * pSrcA, + uint32_t srcALen, + q15_t * pSrcB, + uint32_t srcBLen, + q15_t * pDst, + uint32_t firstIndex, + uint32_t numPoints); + + + /** + * @brief Partial convolution of Q15 sequences (fast version) for Cortex-M3 and Cortex-M4 + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data + * @param[in] firstIndex is the first output sample to start with. + * @param[in] numPoints is the number of output points to be computed. + * @return Returns either ARM_MATH_SUCCESS if the function completed correctly or ARM_MATH_ARGUMENT_ERROR if the requested subset is not in the range [0 srcALen+srcBLen-2]. + */ + arm_status arm_conv_partial_fast_q15( + q15_t * pSrcA, + uint32_t srcALen, + q15_t * pSrcB, + uint32_t srcBLen, + q15_t * pDst, + uint32_t firstIndex, + uint32_t numPoints); + + + /** + * @brief Partial convolution of Q15 sequences (fast version) for Cortex-M3 and Cortex-M4 + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data + * @param[in] firstIndex is the first output sample to start with. + * @param[in] numPoints is the number of output points to be computed. + * @param[in] pScratch1 points to scratch buffer of size max(srcALen, srcBLen) + 2*min(srcALen, srcBLen) - 2. + * @param[in] pScratch2 points to scratch buffer of size min(srcALen, srcBLen). + * @return Returns either ARM_MATH_SUCCESS if the function completed correctly or ARM_MATH_ARGUMENT_ERROR if the requested subset is not in the range [0 srcALen+srcBLen-2]. + */ + arm_status arm_conv_partial_fast_opt_q15( + q15_t * pSrcA, + uint32_t srcALen, + q15_t * pSrcB, + uint32_t srcBLen, + q15_t * pDst, + uint32_t firstIndex, + uint32_t numPoints, + q15_t * pScratch1, + q15_t * pScratch2); + + + /** + * @brief Partial convolution of Q31 sequences. + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data + * @param[in] firstIndex is the first output sample to start with. + * @param[in] numPoints is the number of output points to be computed. + * @return Returns either ARM_MATH_SUCCESS if the function completed correctly or ARM_MATH_ARGUMENT_ERROR if the requested subset is not in the range [0 srcALen+srcBLen-2]. + */ + arm_status arm_conv_partial_q31( + q31_t * pSrcA, + uint32_t srcALen, + q31_t * pSrcB, + uint32_t srcBLen, + q31_t * pDst, + uint32_t firstIndex, + uint32_t numPoints); + + + /** + * @brief Partial convolution of Q31 sequences (fast version) for Cortex-M3 and Cortex-M4 + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data + * @param[in] firstIndex is the first output sample to start with. + * @param[in] numPoints is the number of output points to be computed. + * @return Returns either ARM_MATH_SUCCESS if the function completed correctly or ARM_MATH_ARGUMENT_ERROR if the requested subset is not in the range [0 srcALen+srcBLen-2]. + */ + arm_status arm_conv_partial_fast_q31( + q31_t * pSrcA, + uint32_t srcALen, + q31_t * pSrcB, + uint32_t srcBLen, + q31_t * pDst, + uint32_t firstIndex, + uint32_t numPoints); + + + /** + * @brief Partial convolution of Q7 sequences + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data + * @param[in] firstIndex is the first output sample to start with. + * @param[in] numPoints is the number of output points to be computed. + * @param[in] pScratch1 points to scratch buffer(of type q15_t) of size max(srcALen, srcBLen) + 2*min(srcALen, srcBLen) - 2. + * @param[in] pScratch2 points to scratch buffer (of type q15_t) of size min(srcALen, srcBLen). + * @return Returns either ARM_MATH_SUCCESS if the function completed correctly or ARM_MATH_ARGUMENT_ERROR if the requested subset is not in the range [0 srcALen+srcBLen-2]. + */ + arm_status arm_conv_partial_opt_q7( + q7_t * pSrcA, + uint32_t srcALen, + q7_t * pSrcB, + uint32_t srcBLen, + q7_t * pDst, + uint32_t firstIndex, + uint32_t numPoints, + q15_t * pScratch1, + q15_t * pScratch2); + + +/** + * @brief Partial convolution of Q7 sequences. + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data + * @param[in] firstIndex is the first output sample to start with. + * @param[in] numPoints is the number of output points to be computed. + * @return Returns either ARM_MATH_SUCCESS if the function completed correctly or ARM_MATH_ARGUMENT_ERROR if the requested subset is not in the range [0 srcALen+srcBLen-2]. + */ + arm_status arm_conv_partial_q7( + q7_t * pSrcA, + uint32_t srcALen, + q7_t * pSrcB, + uint32_t srcBLen, + q7_t * pDst, + uint32_t firstIndex, + uint32_t numPoints); + + + /** + * @brief Instance structure for the Q15 FIR decimator. + */ + typedef struct + { + uint8_t M; /**< decimation factor. */ + uint16_t numTaps; /**< number of coefficients in the filter. */ + q15_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps.*/ + q15_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ + } arm_fir_decimate_instance_q15; + + /** + * @brief Instance structure for the Q31 FIR decimator. + */ + typedef struct + { + uint8_t M; /**< decimation factor. */ + uint16_t numTaps; /**< number of coefficients in the filter. */ + q31_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps.*/ + q31_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ + } arm_fir_decimate_instance_q31; + + /** + * @brief Instance structure for the floating-point FIR decimator. + */ + typedef struct + { + uint8_t M; /**< decimation factor. */ + uint16_t numTaps; /**< number of coefficients in the filter. */ + float32_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps.*/ + float32_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ + } arm_fir_decimate_instance_f32; + + + /** + * @brief Processing function for the floating-point FIR decimator. + * @param[in] S points to an instance of the floating-point FIR decimator structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data + * @param[in] blockSize number of input samples to process per call. + */ + void arm_fir_decimate_f32( + const arm_fir_decimate_instance_f32 * S, + float32_t * pSrc, + float32_t * pDst, + uint32_t blockSize); + + + /** + * @brief Initialization function for the floating-point FIR decimator. + * @param[in,out] S points to an instance of the floating-point FIR decimator structure. + * @param[in] numTaps number of coefficients in the filter. + * @param[in] M decimation factor. + * @param[in] pCoeffs points to the filter coefficients. + * @param[in] pState points to the state buffer. + * @param[in] blockSize number of input samples to process per call. + * @return The function returns ARM_MATH_SUCCESS if initialization is successful or ARM_MATH_LENGTH_ERROR if + * blockSize is not a multiple of M. + */ + arm_status arm_fir_decimate_init_f32( + arm_fir_decimate_instance_f32 * S, + uint16_t numTaps, + uint8_t M, + float32_t * pCoeffs, + float32_t * pState, + uint32_t blockSize); + + + /** + * @brief Processing function for the Q15 FIR decimator. + * @param[in] S points to an instance of the Q15 FIR decimator structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data + * @param[in] blockSize number of input samples to process per call. + */ + void arm_fir_decimate_q15( + const arm_fir_decimate_instance_q15 * S, + q15_t * pSrc, + q15_t * pDst, + uint32_t blockSize); + + + /** + * @brief Processing function for the Q15 FIR decimator (fast variant) for Cortex-M3 and Cortex-M4. + * @param[in] S points to an instance of the Q15 FIR decimator structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data + * @param[in] blockSize number of input samples to process per call. + */ + void arm_fir_decimate_fast_q15( + const arm_fir_decimate_instance_q15 * S, + q15_t * pSrc, + q15_t * pDst, + uint32_t blockSize); + + + /** + * @brief Initialization function for the Q15 FIR decimator. + * @param[in,out] S points to an instance of the Q15 FIR decimator structure. + * @param[in] numTaps number of coefficients in the filter. + * @param[in] M decimation factor. + * @param[in] pCoeffs points to the filter coefficients. + * @param[in] pState points to the state buffer. + * @param[in] blockSize number of input samples to process per call. + * @return The function returns ARM_MATH_SUCCESS if initialization is successful or ARM_MATH_LENGTH_ERROR if + * blockSize is not a multiple of M. + */ + arm_status arm_fir_decimate_init_q15( + arm_fir_decimate_instance_q15 * S, + uint16_t numTaps, + uint8_t M, + q15_t * pCoeffs, + q15_t * pState, + uint32_t blockSize); + + + /** + * @brief Processing function for the Q31 FIR decimator. + * @param[in] S points to an instance of the Q31 FIR decimator structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data + * @param[in] blockSize number of input samples to process per call. + */ + void arm_fir_decimate_q31( + const arm_fir_decimate_instance_q31 * S, + q31_t * pSrc, + q31_t * pDst, + uint32_t blockSize); + + /** + * @brief Processing function for the Q31 FIR decimator (fast variant) for Cortex-M3 and Cortex-M4. + * @param[in] S points to an instance of the Q31 FIR decimator structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data + * @param[in] blockSize number of input samples to process per call. + */ + void arm_fir_decimate_fast_q31( + arm_fir_decimate_instance_q31 * S, + q31_t * pSrc, + q31_t * pDst, + uint32_t blockSize); + + + /** + * @brief Initialization function for the Q31 FIR decimator. + * @param[in,out] S points to an instance of the Q31 FIR decimator structure. + * @param[in] numTaps number of coefficients in the filter. + * @param[in] M decimation factor. + * @param[in] pCoeffs points to the filter coefficients. + * @param[in] pState points to the state buffer. + * @param[in] blockSize number of input samples to process per call. + * @return The function returns ARM_MATH_SUCCESS if initialization is successful or ARM_MATH_LENGTH_ERROR if + * blockSize is not a multiple of M. + */ + arm_status arm_fir_decimate_init_q31( + arm_fir_decimate_instance_q31 * S, + uint16_t numTaps, + uint8_t M, + q31_t * pCoeffs, + q31_t * pState, + uint32_t blockSize); + + + /** + * @brief Instance structure for the Q15 FIR interpolator. + */ + typedef struct + { + uint8_t L; /**< upsample factor. */ + uint16_t phaseLength; /**< length of each polyphase filter component. */ + q15_t *pCoeffs; /**< points to the coefficient array. The array is of length L*phaseLength. */ + q15_t *pState; /**< points to the state variable array. The array is of length blockSize+phaseLength-1. */ + } arm_fir_interpolate_instance_q15; + + /** + * @brief Instance structure for the Q31 FIR interpolator. + */ + typedef struct + { + uint8_t L; /**< upsample factor. */ + uint16_t phaseLength; /**< length of each polyphase filter component. */ + q31_t *pCoeffs; /**< points to the coefficient array. The array is of length L*phaseLength. */ + q31_t *pState; /**< points to the state variable array. The array is of length blockSize+phaseLength-1. */ + } arm_fir_interpolate_instance_q31; + + /** + * @brief Instance structure for the floating-point FIR interpolator. + */ + typedef struct + { + uint8_t L; /**< upsample factor. */ + uint16_t phaseLength; /**< length of each polyphase filter component. */ + float32_t *pCoeffs; /**< points to the coefficient array. The array is of length L*phaseLength. */ + float32_t *pState; /**< points to the state variable array. The array is of length phaseLength+numTaps-1. */ + } arm_fir_interpolate_instance_f32; + + + /** + * @brief Processing function for the Q15 FIR interpolator. + * @param[in] S points to an instance of the Q15 FIR interpolator structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data. + * @param[in] blockSize number of input samples to process per call. + */ + void arm_fir_interpolate_q15( + const arm_fir_interpolate_instance_q15 * S, + q15_t * pSrc, + q15_t * pDst, + uint32_t blockSize); + + + /** + * @brief Initialization function for the Q15 FIR interpolator. + * @param[in,out] S points to an instance of the Q15 FIR interpolator structure. + * @param[in] L upsample factor. + * @param[in] numTaps number of filter coefficients in the filter. + * @param[in] pCoeffs points to the filter coefficient buffer. + * @param[in] pState points to the state buffer. + * @param[in] blockSize number of input samples to process per call. + * @return The function returns ARM_MATH_SUCCESS if initialization is successful or ARM_MATH_LENGTH_ERROR if + * the filter length numTaps is not a multiple of the interpolation factor L. + */ + arm_status arm_fir_interpolate_init_q15( + arm_fir_interpolate_instance_q15 * S, + uint8_t L, + uint16_t numTaps, + q15_t * pCoeffs, + q15_t * pState, + uint32_t blockSize); + + + /** + * @brief Processing function for the Q31 FIR interpolator. + * @param[in] S points to an instance of the Q15 FIR interpolator structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data. + * @param[in] blockSize number of input samples to process per call. + */ + void arm_fir_interpolate_q31( + const arm_fir_interpolate_instance_q31 * S, + q31_t * pSrc, + q31_t * pDst, + uint32_t blockSize); + + + /** + * @brief Initialization function for the Q31 FIR interpolator. + * @param[in,out] S points to an instance of the Q31 FIR interpolator structure. + * @param[in] L upsample factor. + * @param[in] numTaps number of filter coefficients in the filter. + * @param[in] pCoeffs points to the filter coefficient buffer. + * @param[in] pState points to the state buffer. + * @param[in] blockSize number of input samples to process per call. + * @return The function returns ARM_MATH_SUCCESS if initialization is successful or ARM_MATH_LENGTH_ERROR if + * the filter length numTaps is not a multiple of the interpolation factor L. + */ + arm_status arm_fir_interpolate_init_q31( + arm_fir_interpolate_instance_q31 * S, + uint8_t L, + uint16_t numTaps, + q31_t * pCoeffs, + q31_t * pState, + uint32_t blockSize); + + + /** + * @brief Processing function for the floating-point FIR interpolator. + * @param[in] S points to an instance of the floating-point FIR interpolator structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data. + * @param[in] blockSize number of input samples to process per call. + */ + void arm_fir_interpolate_f32( + const arm_fir_interpolate_instance_f32 * S, + float32_t * pSrc, + float32_t * pDst, + uint32_t blockSize); + + + /** + * @brief Initialization function for the floating-point FIR interpolator. + * @param[in,out] S points to an instance of the floating-point FIR interpolator structure. + * @param[in] L upsample factor. + * @param[in] numTaps number of filter coefficients in the filter. + * @param[in] pCoeffs points to the filter coefficient buffer. + * @param[in] pState points to the state buffer. + * @param[in] blockSize number of input samples to process per call. + * @return The function returns ARM_MATH_SUCCESS if initialization is successful or ARM_MATH_LENGTH_ERROR if + * the filter length numTaps is not a multiple of the interpolation factor L. + */ + arm_status arm_fir_interpolate_init_f32( + arm_fir_interpolate_instance_f32 * S, + uint8_t L, + uint16_t numTaps, + float32_t * pCoeffs, + float32_t * pState, + uint32_t blockSize); + + + /** + * @brief Instance structure for the high precision Q31 Biquad cascade filter. + */ + typedef struct + { + uint8_t numStages; /**< number of 2nd order stages in the filter. Overall order is 2*numStages. */ + q63_t *pState; /**< points to the array of state coefficients. The array is of length 4*numStages. */ + q31_t *pCoeffs; /**< points to the array of coefficients. The array is of length 5*numStages. */ + uint8_t postShift; /**< additional shift, in bits, applied to each output sample. */ + } arm_biquad_cas_df1_32x64_ins_q31; + + + /** + * @param[in] S points to an instance of the high precision Q31 Biquad cascade filter structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data + * @param[in] blockSize number of samples to process. + */ + void arm_biquad_cas_df1_32x64_q31( + const arm_biquad_cas_df1_32x64_ins_q31 * S, + q31_t * pSrc, + q31_t * pDst, + uint32_t blockSize); + + + /** + * @param[in,out] S points to an instance of the high precision Q31 Biquad cascade filter structure. + * @param[in] numStages number of 2nd order stages in the filter. + * @param[in] pCoeffs points to the filter coefficients. + * @param[in] pState points to the state buffer. + * @param[in] postShift shift to be applied to the output. Varies according to the coefficients format + */ + void arm_biquad_cas_df1_32x64_init_q31( + arm_biquad_cas_df1_32x64_ins_q31 * S, + uint8_t numStages, + q31_t * pCoeffs, + q63_t * pState, + uint8_t postShift); + + + /** + * @brief Instance structure for the floating-point transposed direct form II Biquad cascade filter. + */ + typedef struct + { + uint8_t numStages; /**< number of 2nd order stages in the filter. Overall order is 2*numStages. */ + float32_t *pState; /**< points to the array of state coefficients. The array is of length 2*numStages. */ + float32_t *pCoeffs; /**< points to the array of coefficients. The array is of length 5*numStages. */ + } arm_biquad_cascade_df2T_instance_f32; + + /** + * @brief Instance structure for the floating-point transposed direct form II Biquad cascade filter. + */ + typedef struct + { + uint8_t numStages; /**< number of 2nd order stages in the filter. Overall order is 2*numStages. */ + float32_t *pState; /**< points to the array of state coefficients. The array is of length 4*numStages. */ + float32_t *pCoeffs; /**< points to the array of coefficients. The array is of length 5*numStages. */ + } arm_biquad_cascade_stereo_df2T_instance_f32; + + /** + * @brief Instance structure for the floating-point transposed direct form II Biquad cascade filter. + */ + typedef struct + { + uint8_t numStages; /**< number of 2nd order stages in the filter. Overall order is 2*numStages. */ + float64_t *pState; /**< points to the array of state coefficients. The array is of length 2*numStages. */ + float64_t *pCoeffs; /**< points to the array of coefficients. The array is of length 5*numStages. */ + } arm_biquad_cascade_df2T_instance_f64; + + + /** + * @brief Processing function for the floating-point transposed direct form II Biquad cascade filter. + * @param[in] S points to an instance of the filter data structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data + * @param[in] blockSize number of samples to process. + */ + void arm_biquad_cascade_df2T_f32( + const arm_biquad_cascade_df2T_instance_f32 * S, + float32_t * pSrc, + float32_t * pDst, + uint32_t blockSize); + + + /** + * @brief Processing function for the floating-point transposed direct form II Biquad cascade filter. 2 channels + * @param[in] S points to an instance of the filter data structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data + * @param[in] blockSize number of samples to process. + */ + void arm_biquad_cascade_stereo_df2T_f32( + const arm_biquad_cascade_stereo_df2T_instance_f32 * S, + float32_t * pSrc, + float32_t * pDst, + uint32_t blockSize); + + + /** + * @brief Processing function for the floating-point transposed direct form II Biquad cascade filter. + * @param[in] S points to an instance of the filter data structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data + * @param[in] blockSize number of samples to process. + */ + void arm_biquad_cascade_df2T_f64( + const arm_biquad_cascade_df2T_instance_f64 * S, + float64_t * pSrc, + float64_t * pDst, + uint32_t blockSize); + + + /** + * @brief Initialization function for the floating-point transposed direct form II Biquad cascade filter. + * @param[in,out] S points to an instance of the filter data structure. + * @param[in] numStages number of 2nd order stages in the filter. + * @param[in] pCoeffs points to the filter coefficients. + * @param[in] pState points to the state buffer. + */ + void arm_biquad_cascade_df2T_init_f32( + arm_biquad_cascade_df2T_instance_f32 * S, + uint8_t numStages, + float32_t * pCoeffs, + float32_t * pState); + + + /** + * @brief Initialization function for the floating-point transposed direct form II Biquad cascade filter. + * @param[in,out] S points to an instance of the filter data structure. + * @param[in] numStages number of 2nd order stages in the filter. + * @param[in] pCoeffs points to the filter coefficients. + * @param[in] pState points to the state buffer. + */ + void arm_biquad_cascade_stereo_df2T_init_f32( + arm_biquad_cascade_stereo_df2T_instance_f32 * S, + uint8_t numStages, + float32_t * pCoeffs, + float32_t * pState); + + + /** + * @brief Initialization function for the floating-point transposed direct form II Biquad cascade filter. + * @param[in,out] S points to an instance of the filter data structure. + * @param[in] numStages number of 2nd order stages in the filter. + * @param[in] pCoeffs points to the filter coefficients. + * @param[in] pState points to the state buffer. + */ + void arm_biquad_cascade_df2T_init_f64( + arm_biquad_cascade_df2T_instance_f64 * S, + uint8_t numStages, + float64_t * pCoeffs, + float64_t * pState); + + + /** + * @brief Instance structure for the Q15 FIR lattice filter. + */ + typedef struct + { + uint16_t numStages; /**< number of filter stages. */ + q15_t *pState; /**< points to the state variable array. The array is of length numStages. */ + q15_t *pCoeffs; /**< points to the coefficient array. The array is of length numStages. */ + } arm_fir_lattice_instance_q15; + + /** + * @brief Instance structure for the Q31 FIR lattice filter. + */ + typedef struct + { + uint16_t numStages; /**< number of filter stages. */ + q31_t *pState; /**< points to the state variable array. The array is of length numStages. */ + q31_t *pCoeffs; /**< points to the coefficient array. The array is of length numStages. */ + } arm_fir_lattice_instance_q31; + + /** + * @brief Instance structure for the floating-point FIR lattice filter. + */ + typedef struct + { + uint16_t numStages; /**< number of filter stages. */ + float32_t *pState; /**< points to the state variable array. The array is of length numStages. */ + float32_t *pCoeffs; /**< points to the coefficient array. The array is of length numStages. */ + } arm_fir_lattice_instance_f32; + + + /** + * @brief Initialization function for the Q15 FIR lattice filter. + * @param[in] S points to an instance of the Q15 FIR lattice structure. + * @param[in] numStages number of filter stages. + * @param[in] pCoeffs points to the coefficient buffer. The array is of length numStages. + * @param[in] pState points to the state buffer. The array is of length numStages. + */ + void arm_fir_lattice_init_q15( + arm_fir_lattice_instance_q15 * S, + uint16_t numStages, + q15_t * pCoeffs, + q15_t * pState); + + + /** + * @brief Processing function for the Q15 FIR lattice filter. + * @param[in] S points to an instance of the Q15 FIR lattice structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data. + * @param[in] blockSize number of samples to process. + */ + void arm_fir_lattice_q15( + const arm_fir_lattice_instance_q15 * S, + q15_t * pSrc, + q15_t * pDst, + uint32_t blockSize); + + + /** + * @brief Initialization function for the Q31 FIR lattice filter. + * @param[in] S points to an instance of the Q31 FIR lattice structure. + * @param[in] numStages number of filter stages. + * @param[in] pCoeffs points to the coefficient buffer. The array is of length numStages. + * @param[in] pState points to the state buffer. The array is of length numStages. + */ + void arm_fir_lattice_init_q31( + arm_fir_lattice_instance_q31 * S, + uint16_t numStages, + q31_t * pCoeffs, + q31_t * pState); + + + /** + * @brief Processing function for the Q31 FIR lattice filter. + * @param[in] S points to an instance of the Q31 FIR lattice structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data + * @param[in] blockSize number of samples to process. + */ + void arm_fir_lattice_q31( + const arm_fir_lattice_instance_q31 * S, + q31_t * pSrc, + q31_t * pDst, + uint32_t blockSize); + + +/** + * @brief Initialization function for the floating-point FIR lattice filter. + * @param[in] S points to an instance of the floating-point FIR lattice structure. + * @param[in] numStages number of filter stages. + * @param[in] pCoeffs points to the coefficient buffer. The array is of length numStages. + * @param[in] pState points to the state buffer. The array is of length numStages. + */ + void arm_fir_lattice_init_f32( + arm_fir_lattice_instance_f32 * S, + uint16_t numStages, + float32_t * pCoeffs, + float32_t * pState); + + + /** + * @brief Processing function for the floating-point FIR lattice filter. + * @param[in] S points to an instance of the floating-point FIR lattice structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data + * @param[in] blockSize number of samples to process. + */ + void arm_fir_lattice_f32( + const arm_fir_lattice_instance_f32 * S, + float32_t * pSrc, + float32_t * pDst, + uint32_t blockSize); + + + /** + * @brief Instance structure for the Q15 IIR lattice filter. + */ + typedef struct + { + uint16_t numStages; /**< number of stages in the filter. */ + q15_t *pState; /**< points to the state variable array. The array is of length numStages+blockSize. */ + q15_t *pkCoeffs; /**< points to the reflection coefficient array. The array is of length numStages. */ + q15_t *pvCoeffs; /**< points to the ladder coefficient array. The array is of length numStages+1. */ + } arm_iir_lattice_instance_q15; + + /** + * @brief Instance structure for the Q31 IIR lattice filter. + */ + typedef struct + { + uint16_t numStages; /**< number of stages in the filter. */ + q31_t *pState; /**< points to the state variable array. The array is of length numStages+blockSize. */ + q31_t *pkCoeffs; /**< points to the reflection coefficient array. The array is of length numStages. */ + q31_t *pvCoeffs; /**< points to the ladder coefficient array. The array is of length numStages+1. */ + } arm_iir_lattice_instance_q31; + + /** + * @brief Instance structure for the floating-point IIR lattice filter. + */ + typedef struct + { + uint16_t numStages; /**< number of stages in the filter. */ + float32_t *pState; /**< points to the state variable array. The array is of length numStages+blockSize. */ + float32_t *pkCoeffs; /**< points to the reflection coefficient array. The array is of length numStages. */ + float32_t *pvCoeffs; /**< points to the ladder coefficient array. The array is of length numStages+1. */ + } arm_iir_lattice_instance_f32; + + + /** + * @brief Processing function for the floating-point IIR lattice filter. + * @param[in] S points to an instance of the floating-point IIR lattice structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data. + * @param[in] blockSize number of samples to process. + */ + void arm_iir_lattice_f32( + const arm_iir_lattice_instance_f32 * S, + float32_t * pSrc, + float32_t * pDst, + uint32_t blockSize); + + + /** + * @brief Initialization function for the floating-point IIR lattice filter. + * @param[in] S points to an instance of the floating-point IIR lattice structure. + * @param[in] numStages number of stages in the filter. + * @param[in] pkCoeffs points to the reflection coefficient buffer. The array is of length numStages. + * @param[in] pvCoeffs points to the ladder coefficient buffer. The array is of length numStages+1. + * @param[in] pState points to the state buffer. The array is of length numStages+blockSize-1. + * @param[in] blockSize number of samples to process. + */ + void arm_iir_lattice_init_f32( + arm_iir_lattice_instance_f32 * S, + uint16_t numStages, + float32_t * pkCoeffs, + float32_t * pvCoeffs, + float32_t * pState, + uint32_t blockSize); + + + /** + * @brief Processing function for the Q31 IIR lattice filter. + * @param[in] S points to an instance of the Q31 IIR lattice structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data. + * @param[in] blockSize number of samples to process. + */ + void arm_iir_lattice_q31( + const arm_iir_lattice_instance_q31 * S, + q31_t * pSrc, + q31_t * pDst, + uint32_t blockSize); + + + /** + * @brief Initialization function for the Q31 IIR lattice filter. + * @param[in] S points to an instance of the Q31 IIR lattice structure. + * @param[in] numStages number of stages in the filter. + * @param[in] pkCoeffs points to the reflection coefficient buffer. The array is of length numStages. + * @param[in] pvCoeffs points to the ladder coefficient buffer. The array is of length numStages+1. + * @param[in] pState points to the state buffer. The array is of length numStages+blockSize. + * @param[in] blockSize number of samples to process. + */ + void arm_iir_lattice_init_q31( + arm_iir_lattice_instance_q31 * S, + uint16_t numStages, + q31_t * pkCoeffs, + q31_t * pvCoeffs, + q31_t * pState, + uint32_t blockSize); + + + /** + * @brief Processing function for the Q15 IIR lattice filter. + * @param[in] S points to an instance of the Q15 IIR lattice structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data. + * @param[in] blockSize number of samples to process. + */ + void arm_iir_lattice_q15( + const arm_iir_lattice_instance_q15 * S, + q15_t * pSrc, + q15_t * pDst, + uint32_t blockSize); + + +/** + * @brief Initialization function for the Q15 IIR lattice filter. + * @param[in] S points to an instance of the fixed-point Q15 IIR lattice structure. + * @param[in] numStages number of stages in the filter. + * @param[in] pkCoeffs points to reflection coefficient buffer. The array is of length numStages. + * @param[in] pvCoeffs points to ladder coefficient buffer. The array is of length numStages+1. + * @param[in] pState points to state buffer. The array is of length numStages+blockSize. + * @param[in] blockSize number of samples to process per call. + */ + void arm_iir_lattice_init_q15( + arm_iir_lattice_instance_q15 * S, + uint16_t numStages, + q15_t * pkCoeffs, + q15_t * pvCoeffs, + q15_t * pState, + uint32_t blockSize); + + + /** + * @brief Instance structure for the floating-point LMS filter. + */ + typedef struct + { + uint16_t numTaps; /**< number of coefficients in the filter. */ + float32_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ + float32_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps. */ + float32_t mu; /**< step size that controls filter coefficient updates. */ + } arm_lms_instance_f32; + + + /** + * @brief Processing function for floating-point LMS filter. + * @param[in] S points to an instance of the floating-point LMS filter structure. + * @param[in] pSrc points to the block of input data. + * @param[in] pRef points to the block of reference data. + * @param[out] pOut points to the block of output data. + * @param[out] pErr points to the block of error data. + * @param[in] blockSize number of samples to process. + */ + void arm_lms_f32( + const arm_lms_instance_f32 * S, + float32_t * pSrc, + float32_t * pRef, + float32_t * pOut, + float32_t * pErr, + uint32_t blockSize); + + + /** + * @brief Initialization function for floating-point LMS filter. + * @param[in] S points to an instance of the floating-point LMS filter structure. + * @param[in] numTaps number of filter coefficients. + * @param[in] pCoeffs points to the coefficient buffer. + * @param[in] pState points to state buffer. + * @param[in] mu step size that controls filter coefficient updates. + * @param[in] blockSize number of samples to process. + */ + void arm_lms_init_f32( + arm_lms_instance_f32 * S, + uint16_t numTaps, + float32_t * pCoeffs, + float32_t * pState, + float32_t mu, + uint32_t blockSize); + + + /** + * @brief Instance structure for the Q15 LMS filter. + */ + typedef struct + { + uint16_t numTaps; /**< number of coefficients in the filter. */ + q15_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ + q15_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps. */ + q15_t mu; /**< step size that controls filter coefficient updates. */ + uint32_t postShift; /**< bit shift applied to coefficients. */ + } arm_lms_instance_q15; + + + /** + * @brief Initialization function for the Q15 LMS filter. + * @param[in] S points to an instance of the Q15 LMS filter structure. + * @param[in] numTaps number of filter coefficients. + * @param[in] pCoeffs points to the coefficient buffer. + * @param[in] pState points to the state buffer. + * @param[in] mu step size that controls filter coefficient updates. + * @param[in] blockSize number of samples to process. + * @param[in] postShift bit shift applied to coefficients. + */ + void arm_lms_init_q15( + arm_lms_instance_q15 * S, + uint16_t numTaps, + q15_t * pCoeffs, + q15_t * pState, + q15_t mu, + uint32_t blockSize, + uint32_t postShift); + + + /** + * @brief Processing function for Q15 LMS filter. + * @param[in] S points to an instance of the Q15 LMS filter structure. + * @param[in] pSrc points to the block of input data. + * @param[in] pRef points to the block of reference data. + * @param[out] pOut points to the block of output data. + * @param[out] pErr points to the block of error data. + * @param[in] blockSize number of samples to process. + */ + void arm_lms_q15( + const arm_lms_instance_q15 * S, + q15_t * pSrc, + q15_t * pRef, + q15_t * pOut, + q15_t * pErr, + uint32_t blockSize); + + + /** + * @brief Instance structure for the Q31 LMS filter. + */ + typedef struct + { + uint16_t numTaps; /**< number of coefficients in the filter. */ + q31_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ + q31_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps. */ + q31_t mu; /**< step size that controls filter coefficient updates. */ + uint32_t postShift; /**< bit shift applied to coefficients. */ + } arm_lms_instance_q31; + + + /** + * @brief Processing function for Q31 LMS filter. + * @param[in] S points to an instance of the Q15 LMS filter structure. + * @param[in] pSrc points to the block of input data. + * @param[in] pRef points to the block of reference data. + * @param[out] pOut points to the block of output data. + * @param[out] pErr points to the block of error data. + * @param[in] blockSize number of samples to process. + */ + void arm_lms_q31( + const arm_lms_instance_q31 * S, + q31_t * pSrc, + q31_t * pRef, + q31_t * pOut, + q31_t * pErr, + uint32_t blockSize); + + + /** + * @brief Initialization function for Q31 LMS filter. + * @param[in] S points to an instance of the Q31 LMS filter structure. + * @param[in] numTaps number of filter coefficients. + * @param[in] pCoeffs points to coefficient buffer. + * @param[in] pState points to state buffer. + * @param[in] mu step size that controls filter coefficient updates. + * @param[in] blockSize number of samples to process. + * @param[in] postShift bit shift applied to coefficients. + */ + void arm_lms_init_q31( + arm_lms_instance_q31 * S, + uint16_t numTaps, + q31_t * pCoeffs, + q31_t * pState, + q31_t mu, + uint32_t blockSize, + uint32_t postShift); + + + /** + * @brief Instance structure for the floating-point normalized LMS filter. + */ + typedef struct + { + uint16_t numTaps; /**< number of coefficients in the filter. */ + float32_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ + float32_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps. */ + float32_t mu; /**< step size that control filter coefficient updates. */ + float32_t energy; /**< saves previous frame energy. */ + float32_t x0; /**< saves previous input sample. */ + } arm_lms_norm_instance_f32; + + + /** + * @brief Processing function for floating-point normalized LMS filter. + * @param[in] S points to an instance of the floating-point normalized LMS filter structure. + * @param[in] pSrc points to the block of input data. + * @param[in] pRef points to the block of reference data. + * @param[out] pOut points to the block of output data. + * @param[out] pErr points to the block of error data. + * @param[in] blockSize number of samples to process. + */ + void arm_lms_norm_f32( + arm_lms_norm_instance_f32 * S, + float32_t * pSrc, + float32_t * pRef, + float32_t * pOut, + float32_t * pErr, + uint32_t blockSize); + + + /** + * @brief Initialization function for floating-point normalized LMS filter. + * @param[in] S points to an instance of the floating-point LMS filter structure. + * @param[in] numTaps number of filter coefficients. + * @param[in] pCoeffs points to coefficient buffer. + * @param[in] pState points to state buffer. + * @param[in] mu step size that controls filter coefficient updates. + * @param[in] blockSize number of samples to process. + */ + void arm_lms_norm_init_f32( + arm_lms_norm_instance_f32 * S, + uint16_t numTaps, + float32_t * pCoeffs, + float32_t * pState, + float32_t mu, + uint32_t blockSize); + + + /** + * @brief Instance structure for the Q31 normalized LMS filter. + */ + typedef struct + { + uint16_t numTaps; /**< number of coefficients in the filter. */ + q31_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ + q31_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps. */ + q31_t mu; /**< step size that controls filter coefficient updates. */ + uint8_t postShift; /**< bit shift applied to coefficients. */ + q31_t *recipTable; /**< points to the reciprocal initial value table. */ + q31_t energy; /**< saves previous frame energy. */ + q31_t x0; /**< saves previous input sample. */ + } arm_lms_norm_instance_q31; + + + /** + * @brief Processing function for Q31 normalized LMS filter. + * @param[in] S points to an instance of the Q31 normalized LMS filter structure. + * @param[in] pSrc points to the block of input data. + * @param[in] pRef points to the block of reference data. + * @param[out] pOut points to the block of output data. + * @param[out] pErr points to the block of error data. + * @param[in] blockSize number of samples to process. + */ + void arm_lms_norm_q31( + arm_lms_norm_instance_q31 * S, + q31_t * pSrc, + q31_t * pRef, + q31_t * pOut, + q31_t * pErr, + uint32_t blockSize); + + + /** + * @brief Initialization function for Q31 normalized LMS filter. + * @param[in] S points to an instance of the Q31 normalized LMS filter structure. + * @param[in] numTaps number of filter coefficients. + * @param[in] pCoeffs points to coefficient buffer. + * @param[in] pState points to state buffer. + * @param[in] mu step size that controls filter coefficient updates. + * @param[in] blockSize number of samples to process. + * @param[in] postShift bit shift applied to coefficients. + */ + void arm_lms_norm_init_q31( + arm_lms_norm_instance_q31 * S, + uint16_t numTaps, + q31_t * pCoeffs, + q31_t * pState, + q31_t mu, + uint32_t blockSize, + uint8_t postShift); + + + /** + * @brief Instance structure for the Q15 normalized LMS filter. + */ + typedef struct + { + uint16_t numTaps; /**< Number of coefficients in the filter. */ + q15_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ + q15_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps. */ + q15_t mu; /**< step size that controls filter coefficient updates. */ + uint8_t postShift; /**< bit shift applied to coefficients. */ + q15_t *recipTable; /**< Points to the reciprocal initial value table. */ + q15_t energy; /**< saves previous frame energy. */ + q15_t x0; /**< saves previous input sample. */ + } arm_lms_norm_instance_q15; + + + /** + * @brief Processing function for Q15 normalized LMS filter. + * @param[in] S points to an instance of the Q15 normalized LMS filter structure. + * @param[in] pSrc points to the block of input data. + * @param[in] pRef points to the block of reference data. + * @param[out] pOut points to the block of output data. + * @param[out] pErr points to the block of error data. + * @param[in] blockSize number of samples to process. + */ + void arm_lms_norm_q15( + arm_lms_norm_instance_q15 * S, + q15_t * pSrc, + q15_t * pRef, + q15_t * pOut, + q15_t * pErr, + uint32_t blockSize); + + + /** + * @brief Initialization function for Q15 normalized LMS filter. + * @param[in] S points to an instance of the Q15 normalized LMS filter structure. + * @param[in] numTaps number of filter coefficients. + * @param[in] pCoeffs points to coefficient buffer. + * @param[in] pState points to state buffer. + * @param[in] mu step size that controls filter coefficient updates. + * @param[in] blockSize number of samples to process. + * @param[in] postShift bit shift applied to coefficients. + */ + void arm_lms_norm_init_q15( + arm_lms_norm_instance_q15 * S, + uint16_t numTaps, + q15_t * pCoeffs, + q15_t * pState, + q15_t mu, + uint32_t blockSize, + uint8_t postShift); + + + /** + * @brief Correlation of floating-point sequences. + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data Length 2 * max(srcALen, srcBLen) - 1. + */ + void arm_correlate_f32( + float32_t * pSrcA, + uint32_t srcALen, + float32_t * pSrcB, + uint32_t srcBLen, + float32_t * pDst); + + + /** + * @brief Correlation of Q15 sequences + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data Length 2 * max(srcALen, srcBLen) - 1. + * @param[in] pScratch points to scratch buffer of size max(srcALen, srcBLen) + 2*min(srcALen, srcBLen) - 2. + */ + void arm_correlate_opt_q15( + q15_t * pSrcA, + uint32_t srcALen, + q15_t * pSrcB, + uint32_t srcBLen, + q15_t * pDst, + q15_t * pScratch); + + + /** + * @brief Correlation of Q15 sequences. + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data Length 2 * max(srcALen, srcBLen) - 1. + */ + + void arm_correlate_q15( + q15_t * pSrcA, + uint32_t srcALen, + q15_t * pSrcB, + uint32_t srcBLen, + q15_t * pDst); + + + /** + * @brief Correlation of Q15 sequences (fast version) for Cortex-M3 and Cortex-M4. + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data Length 2 * max(srcALen, srcBLen) - 1. + */ + + void arm_correlate_fast_q15( + q15_t * pSrcA, + uint32_t srcALen, + q15_t * pSrcB, + uint32_t srcBLen, + q15_t * pDst); + + + /** + * @brief Correlation of Q15 sequences (fast version) for Cortex-M3 and Cortex-M4. + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data Length 2 * max(srcALen, srcBLen) - 1. + * @param[in] pScratch points to scratch buffer of size max(srcALen, srcBLen) + 2*min(srcALen, srcBLen) - 2. + */ + void arm_correlate_fast_opt_q15( + q15_t * pSrcA, + uint32_t srcALen, + q15_t * pSrcB, + uint32_t srcBLen, + q15_t * pDst, + q15_t * pScratch); + + + /** + * @brief Correlation of Q31 sequences. + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data Length 2 * max(srcALen, srcBLen) - 1. + */ + void arm_correlate_q31( + q31_t * pSrcA, + uint32_t srcALen, + q31_t * pSrcB, + uint32_t srcBLen, + q31_t * pDst); + + + /** + * @brief Correlation of Q31 sequences (fast version) for Cortex-M3 and Cortex-M4 + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data Length 2 * max(srcALen, srcBLen) - 1. + */ + void arm_correlate_fast_q31( + q31_t * pSrcA, + uint32_t srcALen, + q31_t * pSrcB, + uint32_t srcBLen, + q31_t * pDst); + + + /** + * @brief Correlation of Q7 sequences. + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data Length 2 * max(srcALen, srcBLen) - 1. + * @param[in] pScratch1 points to scratch buffer(of type q15_t) of size max(srcALen, srcBLen) + 2*min(srcALen, srcBLen) - 2. + * @param[in] pScratch2 points to scratch buffer (of type q15_t) of size min(srcALen, srcBLen). + */ + void arm_correlate_opt_q7( + q7_t * pSrcA, + uint32_t srcALen, + q7_t * pSrcB, + uint32_t srcBLen, + q7_t * pDst, + q15_t * pScratch1, + q15_t * pScratch2); + + + /** + * @brief Correlation of Q7 sequences. + * @param[in] pSrcA points to the first input sequence. + * @param[in] srcALen length of the first input sequence. + * @param[in] pSrcB points to the second input sequence. + * @param[in] srcBLen length of the second input sequence. + * @param[out] pDst points to the block of output data Length 2 * max(srcALen, srcBLen) - 1. + */ + void arm_correlate_q7( + q7_t * pSrcA, + uint32_t srcALen, + q7_t * pSrcB, + uint32_t srcBLen, + q7_t * pDst); + + + /** + * @brief Instance structure for the floating-point sparse FIR filter. + */ + typedef struct + { + uint16_t numTaps; /**< number of coefficients in the filter. */ + uint16_t stateIndex; /**< state buffer index. Points to the oldest sample in the state buffer. */ + float32_t *pState; /**< points to the state buffer array. The array is of length maxDelay+blockSize-1. */ + float32_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps.*/ + uint16_t maxDelay; /**< maximum offset specified by the pTapDelay array. */ + int32_t *pTapDelay; /**< points to the array of delay values. The array is of length numTaps. */ + } arm_fir_sparse_instance_f32; + + /** + * @brief Instance structure for the Q31 sparse FIR filter. + */ + typedef struct + { + uint16_t numTaps; /**< number of coefficients in the filter. */ + uint16_t stateIndex; /**< state buffer index. Points to the oldest sample in the state buffer. */ + q31_t *pState; /**< points to the state buffer array. The array is of length maxDelay+blockSize-1. */ + q31_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps.*/ + uint16_t maxDelay; /**< maximum offset specified by the pTapDelay array. */ + int32_t *pTapDelay; /**< points to the array of delay values. The array is of length numTaps. */ + } arm_fir_sparse_instance_q31; + + /** + * @brief Instance structure for the Q15 sparse FIR filter. + */ + typedef struct + { + uint16_t numTaps; /**< number of coefficients in the filter. */ + uint16_t stateIndex; /**< state buffer index. Points to the oldest sample in the state buffer. */ + q15_t *pState; /**< points to the state buffer array. The array is of length maxDelay+blockSize-1. */ + q15_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps.*/ + uint16_t maxDelay; /**< maximum offset specified by the pTapDelay array. */ + int32_t *pTapDelay; /**< points to the array of delay values. The array is of length numTaps. */ + } arm_fir_sparse_instance_q15; + + /** + * @brief Instance structure for the Q7 sparse FIR filter. + */ + typedef struct + { + uint16_t numTaps; /**< number of coefficients in the filter. */ + uint16_t stateIndex; /**< state buffer index. Points to the oldest sample in the state buffer. */ + q7_t *pState; /**< points to the state buffer array. The array is of length maxDelay+blockSize-1. */ + q7_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps.*/ + uint16_t maxDelay; /**< maximum offset specified by the pTapDelay array. */ + int32_t *pTapDelay; /**< points to the array of delay values. The array is of length numTaps. */ + } arm_fir_sparse_instance_q7; + + + /** + * @brief Processing function for the floating-point sparse FIR filter. + * @param[in] S points to an instance of the floating-point sparse FIR structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data + * @param[in] pScratchIn points to a temporary buffer of size blockSize. + * @param[in] blockSize number of input samples to process per call. + */ + void arm_fir_sparse_f32( + arm_fir_sparse_instance_f32 * S, + float32_t * pSrc, + float32_t * pDst, + float32_t * pScratchIn, + uint32_t blockSize); + + + /** + * @brief Initialization function for the floating-point sparse FIR filter. + * @param[in,out] S points to an instance of the floating-point sparse FIR structure. + * @param[in] numTaps number of nonzero coefficients in the filter. + * @param[in] pCoeffs points to the array of filter coefficients. + * @param[in] pState points to the state buffer. + * @param[in] pTapDelay points to the array of offset times. + * @param[in] maxDelay maximum offset time supported. + * @param[in] blockSize number of samples that will be processed per block. + */ + void arm_fir_sparse_init_f32( + arm_fir_sparse_instance_f32 * S, + uint16_t numTaps, + float32_t * pCoeffs, + float32_t * pState, + int32_t * pTapDelay, + uint16_t maxDelay, + uint32_t blockSize); + + + /** + * @brief Processing function for the Q31 sparse FIR filter. + * @param[in] S points to an instance of the Q31 sparse FIR structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data + * @param[in] pScratchIn points to a temporary buffer of size blockSize. + * @param[in] blockSize number of input samples to process per call. + */ + void arm_fir_sparse_q31( + arm_fir_sparse_instance_q31 * S, + q31_t * pSrc, + q31_t * pDst, + q31_t * pScratchIn, + uint32_t blockSize); + + + /** + * @brief Initialization function for the Q31 sparse FIR filter. + * @param[in,out] S points to an instance of the Q31 sparse FIR structure. + * @param[in] numTaps number of nonzero coefficients in the filter. + * @param[in] pCoeffs points to the array of filter coefficients. + * @param[in] pState points to the state buffer. + * @param[in] pTapDelay points to the array of offset times. + * @param[in] maxDelay maximum offset time supported. + * @param[in] blockSize number of samples that will be processed per block. + */ + void arm_fir_sparse_init_q31( + arm_fir_sparse_instance_q31 * S, + uint16_t numTaps, + q31_t * pCoeffs, + q31_t * pState, + int32_t * pTapDelay, + uint16_t maxDelay, + uint32_t blockSize); + + + /** + * @brief Processing function for the Q15 sparse FIR filter. + * @param[in] S points to an instance of the Q15 sparse FIR structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data + * @param[in] pScratchIn points to a temporary buffer of size blockSize. + * @param[in] pScratchOut points to a temporary buffer of size blockSize. + * @param[in] blockSize number of input samples to process per call. + */ + void arm_fir_sparse_q15( + arm_fir_sparse_instance_q15 * S, + q15_t * pSrc, + q15_t * pDst, + q15_t * pScratchIn, + q31_t * pScratchOut, + uint32_t blockSize); + + + /** + * @brief Initialization function for the Q15 sparse FIR filter. + * @param[in,out] S points to an instance of the Q15 sparse FIR structure. + * @param[in] numTaps number of nonzero coefficients in the filter. + * @param[in] pCoeffs points to the array of filter coefficients. + * @param[in] pState points to the state buffer. + * @param[in] pTapDelay points to the array of offset times. + * @param[in] maxDelay maximum offset time supported. + * @param[in] blockSize number of samples that will be processed per block. + */ + void arm_fir_sparse_init_q15( + arm_fir_sparse_instance_q15 * S, + uint16_t numTaps, + q15_t * pCoeffs, + q15_t * pState, + int32_t * pTapDelay, + uint16_t maxDelay, + uint32_t blockSize); + + + /** + * @brief Processing function for the Q7 sparse FIR filter. + * @param[in] S points to an instance of the Q7 sparse FIR structure. + * @param[in] pSrc points to the block of input data. + * @param[out] pDst points to the block of output data + * @param[in] pScratchIn points to a temporary buffer of size blockSize. + * @param[in] pScratchOut points to a temporary buffer of size blockSize. + * @param[in] blockSize number of input samples to process per call. + */ + void arm_fir_sparse_q7( + arm_fir_sparse_instance_q7 * S, + q7_t * pSrc, + q7_t * pDst, + q7_t * pScratchIn, + q31_t * pScratchOut, + uint32_t blockSize); + + + /** + * @brief Initialization function for the Q7 sparse FIR filter. + * @param[in,out] S points to an instance of the Q7 sparse FIR structure. + * @param[in] numTaps number of nonzero coefficients in the filter. + * @param[in] pCoeffs points to the array of filter coefficients. + * @param[in] pState points to the state buffer. + * @param[in] pTapDelay points to the array of offset times. + * @param[in] maxDelay maximum offset time supported. + * @param[in] blockSize number of samples that will be processed per block. + */ + void arm_fir_sparse_init_q7( + arm_fir_sparse_instance_q7 * S, + uint16_t numTaps, + q7_t * pCoeffs, + q7_t * pState, + int32_t * pTapDelay, + uint16_t maxDelay, + uint32_t blockSize); + + + /** + * @brief Floating-point sin_cos function. + * @param[in] theta input value in degrees + * @param[out] pSinVal points to the processed sine output. + * @param[out] pCosVal points to the processed cos output. + */ + void arm_sin_cos_f32( + float32_t theta, + float32_t * pSinVal, + float32_t * pCosVal); + + + /** + * @brief Q31 sin_cos function. + * @param[in] theta scaled input value in degrees + * @param[out] pSinVal points to the processed sine output. + * @param[out] pCosVal points to the processed cosine output. + */ + void arm_sin_cos_q31( + q31_t theta, + q31_t * pSinVal, + q31_t * pCosVal); + + + /** + * @brief Floating-point complex conjugate. + * @param[in] pSrc points to the input vector + * @param[out] pDst points to the output vector + * @param[in] numSamples number of complex samples in each vector + */ + void arm_cmplx_conj_f32( + float32_t * pSrc, + float32_t * pDst, + uint32_t numSamples); + + /** + * @brief Q31 complex conjugate. + * @param[in] pSrc points to the input vector + * @param[out] pDst points to the output vector + * @param[in] numSamples number of complex samples in each vector + */ + void arm_cmplx_conj_q31( + q31_t * pSrc, + q31_t * pDst, + uint32_t numSamples); + + + /** + * @brief Q15 complex conjugate. + * @param[in] pSrc points to the input vector + * @param[out] pDst points to the output vector + * @param[in] numSamples number of complex samples in each vector + */ + void arm_cmplx_conj_q15( + q15_t * pSrc, + q15_t * pDst, + uint32_t numSamples); + + + /** + * @brief Floating-point complex magnitude squared + * @param[in] pSrc points to the complex input vector + * @param[out] pDst points to the real output vector + * @param[in] numSamples number of complex samples in the input vector + */ + void arm_cmplx_mag_squared_f32( + float32_t * pSrc, + float32_t * pDst, + uint32_t numSamples); + + + /** + * @brief Q31 complex magnitude squared + * @param[in] pSrc points to the complex input vector + * @param[out] pDst points to the real output vector + * @param[in] numSamples number of complex samples in the input vector + */ + void arm_cmplx_mag_squared_q31( + q31_t * pSrc, + q31_t * pDst, + uint32_t numSamples); + + + /** + * @brief Q15 complex magnitude squared + * @param[in] pSrc points to the complex input vector + * @param[out] pDst points to the real output vector + * @param[in] numSamples number of complex samples in the input vector + */ + void arm_cmplx_mag_squared_q15( + q15_t * pSrc, + q15_t * pDst, + uint32_t numSamples); + + + /** + * @ingroup groupController + */ + + /** + * @defgroup PID PID Motor Control + * + * A Proportional Integral Derivative (PID) controller is a generic feedback control + * loop mechanism widely used in industrial control systems. + * A PID controller is the most commonly used type of feedback controller. + * + * This set of functions implements (PID) controllers + * for Q15, Q31, and floating-point data types. The functions operate on a single sample + * of data and each call to the function returns a single processed value. + * S points to an instance of the PID control data structure. in + * is the input sample value. The functions return the output value. + * + * \par Algorithm: + * 
+   *    y[n] = y[n-1] + A0 * x[n] + A1 * x[n-1] + A2 * x[n-2]
+   *    A0 = Kp + Ki + Kd
+   *    A1 = (-Kp ) - (2 * Kd )
+   *    A2 = Kd
+ * + * \par + * where \c Kp is proportional constant, \c Ki is Integral constant and \c Kd is Derivative constant + * + * \par + * \image html PID.gif "Proportional Integral Derivative Controller" + * + * \par + * The PID controller calculates an "error" value as the difference between + * the measured output and the reference input. + * The controller attempts to minimize the error by adjusting the process control inputs. + * The proportional value determines the reaction to the current error, + * the integral value determines the reaction based on the sum of recent errors, + * and the derivative value determines the reaction based on the rate at which the error has been changing. + * + * \par Instance Structure + * The Gains A0, A1, A2 and state variables for a PID controller are stored together in an instance data structure. + * A separate instance structure must be defined for each PID Controller. + * There are separate instance structure declarations for each of the 3 supported data types. + * + * \par Reset Functions + * There is also an associated reset function for each data type which clears the state array. + * + * \par Initialization Functions + * There is also an associated initialization function for each data type. + * The initialization function performs the following operations: + * - Initializes the Gains A0, A1, A2 from Kp,Ki, Kd gains. + * - Zeros out the values in the state buffer. + * + * \par + * Instance structure cannot be placed into a const data section and it is recommended to use the initialization function. + * + * \par Fixed-Point Behavior + * Care must be taken when using the fixed-point versions of the PID Controller functions. + * In particular, the overflow and saturation behavior of the accumulator used in each function must be considered. + * Refer to the function specific documentation below for usage guidelines. + */ + + /** + * @addtogroup PID + * @{ + */ + + /** + * @brief Process function for the floating-point PID Control. + * @param[in,out] S is an instance of the floating-point PID Control structure + * @param[in] in input sample to process + * @return out processed output sample. + */ + static __INLINE float32_t arm_pid_f32( + arm_pid_instance_f32 * S, + float32_t in) + { + float32_t out; + + /* y[n] = y[n-1] + A0 * x[n] + A1 * x[n-1] + A2 * x[n-2] */ + out = (S->A0 * in) + + (S->A1 * S->state[0]) + (S->A2 * S->state[1]) + (S->state[2]); + + /* Update state */ + S->state[1] = S->state[0]; + S->state[0] = in; + S->state[2] = out; + + /* return to application */ + return (out); + + } + + /** + * @brief Process function for the Q31 PID Control. + * @param[in,out] S points to an instance of the Q31 PID Control structure + * @param[in] in input sample to process + * @return out processed output sample. + * + * Scaling and Overflow Behavior: + * \par + * The function is implemented using an internal 64-bit accumulator. + * The accumulator has a 2.62 format and maintains full precision of the intermediate multiplication results but provides only a single guard bit. + * Thus, if the accumulator result overflows it wraps around rather than clip. + * In order to avoid overflows completely the input signal must be scaled down by 2 bits as there are four additions. + * After all multiply-accumulates are performed, the 2.62 accumulator is truncated to 1.32 format and then saturated to 1.31 format. + */ + static __INLINE q31_t arm_pid_q31( + arm_pid_instance_q31 * S, + q31_t in) + { + q63_t acc; + q31_t out; + + /* acc = A0 * x[n] */ + acc = (q63_t) S->A0 * in; + + /* acc += A1 * x[n-1] */ + acc += (q63_t) S->A1 * S->state[0]; + + /* acc += A2 * x[n-2] */ + acc += (q63_t) S->A2 * S->state[1]; + + /* convert output to 1.31 format to add y[n-1] */ + out = (q31_t) (acc >> 31u); + + /* out += y[n-1] */ + out += S->state[2]; + + /* Update state */ + S->state[1] = S->state[0]; + S->state[0] = in; + S->state[2] = out; + + /* return to application */ + return (out); + } + + + /** + * @brief Process function for the Q15 PID Control. + * @param[in,out] S points to an instance of the Q15 PID Control structure + * @param[in] in input sample to process + * @return out processed output sample. + * + * Scaling and Overflow Behavior: + * \par + * The function is implemented using a 64-bit internal accumulator. + * Both Gains and state variables are represented in 1.15 format and multiplications yield a 2.30 result. + * The 2.30 intermediate results are accumulated in a 64-bit accumulator in 34.30 format. + * There is no risk of internal overflow with this approach and the full precision of intermediate multiplications is preserved. + * After all additions have been performed, the accumulator is truncated to 34.15 format by discarding low 15 bits. + * Lastly, the accumulator is saturated to yield a result in 1.15 format. + */ + static __INLINE q15_t arm_pid_q15( + arm_pid_instance_q15 * S, + q15_t in) + { + q63_t acc; + q15_t out; + +#ifndef ARM_MATH_CM0_FAMILY + __SIMD32_TYPE *vstate; + + /* Implementation of PID controller */ + + /* acc = A0 * x[n] */ + acc = (q31_t) __SMUAD((uint32_t)S->A0, (uint32_t)in); + + /* acc += A1 * x[n-1] + A2 * x[n-2] */ + vstate = __SIMD32_CONST(S->state); + acc = (q63_t)__SMLALD((uint32_t)S->A1, (uint32_t)*vstate, (uint64_t)acc); +#else + /* acc = A0 * x[n] */ + acc = ((q31_t) S->A0) * in; + + /* acc += A1 * x[n-1] + A2 * x[n-2] */ + acc += (q31_t) S->A1 * S->state[0]; + acc += (q31_t) S->A2 * S->state[1]; +#endif + + /* acc += y[n-1] */ + acc += (q31_t) S->state[2] << 15; + + /* saturate the output */ + out = (q15_t) (__SSAT((acc >> 15), 16)); + + /* Update state */ + S->state[1] = S->state[0]; + S->state[0] = in; + S->state[2] = out; + + /* return to application */ + return (out); + } + + /** + * @} end of PID group + */ + + + /** + * @brief Floating-point matrix inverse. + * @param[in] src points to the instance of the input floating-point matrix structure. + * @param[out] dst points to the instance of the output floating-point matrix structure. + * @return The function returns ARM_MATH_SIZE_MISMATCH, if the dimensions do not match. + * If the input matrix is singular (does not have an inverse), then the algorithm terminates and returns error status ARM_MATH_SINGULAR. + */ + arm_status arm_mat_inverse_f32( + const arm_matrix_instance_f32 * src, + arm_matrix_instance_f32 * dst); + + + /** + * @brief Floating-point matrix inverse. + * @param[in] src points to the instance of the input floating-point matrix structure. + * @param[out] dst points to the instance of the output floating-point matrix structure. + * @return The function returns ARM_MATH_SIZE_MISMATCH, if the dimensions do not match. + * If the input matrix is singular (does not have an inverse), then the algorithm terminates and returns error status ARM_MATH_SINGULAR. + */ + arm_status arm_mat_inverse_f64( + const arm_matrix_instance_f64 * src, + arm_matrix_instance_f64 * dst); + + + + /** + * @ingroup groupController + */ + + /** + * @defgroup clarke Vector Clarke Transform + * Forward Clarke transform converts the instantaneous stator phases into a two-coordinate time invariant vector. + * Generally the Clarke transform uses three-phase currents Ia, Ib and Ic to calculate currents + * in the two-phase orthogonal stator axis Ialpha and Ibeta. + * When Ialpha is superposed with Ia as shown in the figure below + * \image html clarke.gif Stator current space vector and its components in (a,b). + * and Ia + Ib + Ic = 0, in this condition Ialpha and Ibeta + * can be calculated using only Ia and Ib. + * + * The function operates on a single sample of data and each call to the function returns the processed output. + * The library provides separate functions for Q31 and floating-point data types. + * \par Algorithm + * \image html clarkeFormula.gif + * where Ia and Ib are the instantaneous stator phases and + * pIalpha and pIbeta are the two coordinates of time invariant vector. + * \par Fixed-Point Behavior + * Care must be taken when using the Q31 version of the Clarke transform. + * In particular, the overflow and saturation behavior of the accumulator used must be considered. + * Refer to the function specific documentation below for usage guidelines. + */ + + /** + * @addtogroup clarke + * @{ + */ + + /** + * + * @brief Floating-point Clarke transform + * @param[in] Ia input three-phase coordinate a + * @param[in] Ib input three-phase coordinate b + * @param[out] pIalpha points to output two-phase orthogonal vector axis alpha + * @param[out] pIbeta points to output two-phase orthogonal vector axis beta + */ + static __INLINE void arm_clarke_f32( + float32_t Ia, + float32_t Ib, + float32_t * pIalpha, + float32_t * pIbeta) + { + /* Calculate pIalpha using the equation, pIalpha = Ia */ + *pIalpha = Ia; + + /* Calculate pIbeta using the equation, pIbeta = (1/sqrt(3)) * Ia + (2/sqrt(3)) * Ib */ + *pIbeta = ((float32_t) 0.57735026919 * Ia + (float32_t) 1.15470053838 * Ib); + } + + + /** + * @brief Clarke transform for Q31 version + * @param[in] Ia input three-phase coordinate a + * @param[in] Ib input three-phase coordinate b + * @param[out] pIalpha points to output two-phase orthogonal vector axis alpha + * @param[out] pIbeta points to output two-phase orthogonal vector axis beta + * + * Scaling and Overflow Behavior: + * \par + * The function is implemented using an internal 32-bit accumulator. + * The accumulator maintains 1.31 format by truncating lower 31 bits of the intermediate multiplication in 2.62 format. + * There is saturation on the addition, hence there is no risk of overflow. + */ + static __INLINE void arm_clarke_q31( + q31_t Ia, + q31_t Ib, + q31_t * pIalpha, + q31_t * pIbeta) + { + q31_t product1, product2; /* Temporary variables used to store intermediate results */ + + /* Calculating pIalpha from Ia by equation pIalpha = Ia */ + *pIalpha = Ia; + + /* Intermediate product is calculated by (1/(sqrt(3)) * Ia) */ + product1 = (q31_t) (((q63_t) Ia * 0x24F34E8B) >> 30); + + /* Intermediate product is calculated by (2/sqrt(3) * Ib) */ + product2 = (q31_t) (((q63_t) Ib * 0x49E69D16) >> 30); + + /* pIbeta is calculated by adding the intermediate products */ + *pIbeta = __QADD(product1, product2); + } + + /** + * @} end of clarke group + */ + + /** + * @brief Converts the elements of the Q7 vector to Q31 vector. + * @param[in] pSrc input pointer + * @param[out] pDst output pointer + * @param[in] blockSize number of samples to process + */ + void arm_q7_to_q31( + q7_t * pSrc, + q31_t * pDst, + uint32_t blockSize); + + + + /** + * @ingroup groupController + */ + + /** + * @defgroup inv_clarke Vector Inverse Clarke Transform + * Inverse Clarke transform converts the two-coordinate time invariant vector into instantaneous stator phases. + * + * The function operates on a single sample of data and each call to the function returns the processed output. + * The library provides separate functions for Q31 and floating-point data types. + * \par Algorithm + * \image html clarkeInvFormula.gif + * where pIa and pIb are the instantaneous stator phases and + * Ialpha and Ibeta are the two coordinates of time invariant vector. + * \par Fixed-Point Behavior + * Care must be taken when using the Q31 version of the Clarke transform. + * In particular, the overflow and saturation behavior of the accumulator used must be considered. + * Refer to the function specific documentation below for usage guidelines. + */ + + /** + * @addtogroup inv_clarke + * @{ + */ + + /** + * @brief Floating-point Inverse Clarke transform + * @param[in] Ialpha input two-phase orthogonal vector axis alpha + * @param[in] Ibeta input two-phase orthogonal vector axis beta + * @param[out] pIa points to output three-phase coordinate a + * @param[out] pIb points to output three-phase coordinate b + */ + static __INLINE void arm_inv_clarke_f32( + float32_t Ialpha, + float32_t Ibeta, + float32_t * pIa, + float32_t * pIb) + { + /* Calculating pIa from Ialpha by equation pIa = Ialpha */ + *pIa = Ialpha; + + /* Calculating pIb from Ialpha and Ibeta by equation pIb = -(1/2) * Ialpha + (sqrt(3)/2) * Ibeta */ + *pIb = -0.5f * Ialpha + 0.8660254039f * Ibeta; + } + + + /** + * @brief Inverse Clarke transform for Q31 version + * @param[in] Ialpha input two-phase orthogonal vector axis alpha + * @param[in] Ibeta input two-phase orthogonal vector axis beta + * @param[out] pIa points to output three-phase coordinate a + * @param[out] pIb points to output three-phase coordinate b + * + * Scaling and Overflow Behavior: + * \par + * The function is implemented using an internal 32-bit accumulator. + * The accumulator maintains 1.31 format by truncating lower 31 bits of the intermediate multiplication in 2.62 format. + * There is saturation on the subtraction, hence there is no risk of overflow. + */ + static __INLINE void arm_inv_clarke_q31( + q31_t Ialpha, + q31_t Ibeta, + q31_t * pIa, + q31_t * pIb) + { + q31_t product1, product2; /* Temporary variables used to store intermediate results */ + + /* Calculating pIa from Ialpha by equation pIa = Ialpha */ + *pIa = Ialpha; + + /* Intermediate product is calculated by (1/(2*sqrt(3)) * Ia) */ + product1 = (q31_t) (((q63_t) (Ialpha) * (0x40000000)) >> 31); + + /* Intermediate product is calculated by (1/sqrt(3) * pIb) */ + product2 = (q31_t) (((q63_t) (Ibeta) * (0x6ED9EBA1)) >> 31); + + /* pIb is calculated by subtracting the products */ + *pIb = __QSUB(product2, product1); + } + + /** + * @} end of inv_clarke group + */ + + /** + * @brief Converts the elements of the Q7 vector to Q15 vector. + * @param[in] pSrc input pointer + * @param[out] pDst output pointer + * @param[in] blockSize number of samples to process + */ + void arm_q7_to_q15( + q7_t * pSrc, + q15_t * pDst, + uint32_t blockSize); + + + + /** + * @ingroup groupController + */ + + /** + * @defgroup park Vector Park Transform + * + * Forward Park transform converts the input two-coordinate vector to flux and torque components. + * The Park transform can be used to realize the transformation of the Ialpha and the Ibeta currents + * from the stationary to the moving reference frame and control the spatial relationship between + * the stator vector current and rotor flux vector. + * If we consider the d axis aligned with the rotor flux, the diagram below shows the + * current vector and the relationship from the two reference frames: + * \image html park.gif "Stator current space vector and its component in (a,b) and in the d,q rotating reference frame" + * + * The function operates on a single sample of data and each call to the function returns the processed output. + * The library provides separate functions for Q31 and floating-point data types. + * \par Algorithm + * \image html parkFormula.gif + * where Ialpha and Ibeta are the stator vector components, + * pId and pIq are rotor vector components and cosVal and sinVal are the + * cosine and sine values of theta (rotor flux position). + * \par Fixed-Point Behavior + * Care must be taken when using the Q31 version of the Park transform. + * In particular, the overflow and saturation behavior of the accumulator used must be considered. + * Refer to the function specific documentation below for usage guidelines. + */ + + /** + * @addtogroup park + * @{ + */ + + /** + * @brief Floating-point Park transform + * @param[in] Ialpha input two-phase vector coordinate alpha + * @param[in] Ibeta input two-phase vector coordinate beta + * @param[out] pId points to output rotor reference frame d + * @param[out] pIq points to output rotor reference frame q + * @param[in] sinVal sine value of rotation angle theta + * @param[in] cosVal cosine value of rotation angle theta + * + * The function implements the forward Park transform. + * + */ + static __INLINE void arm_park_f32( + float32_t Ialpha, + float32_t Ibeta, + float32_t * pId, + float32_t * pIq, + float32_t sinVal, + float32_t cosVal) + { + /* Calculate pId using the equation, pId = Ialpha * cosVal + Ibeta * sinVal */ + *pId = Ialpha * cosVal + Ibeta * sinVal; + + /* Calculate pIq using the equation, pIq = - Ialpha * sinVal + Ibeta * cosVal */ + *pIq = -Ialpha * sinVal + Ibeta * cosVal; + } + + + /** + * @brief Park transform for Q31 version + * @param[in] Ialpha input two-phase vector coordinate alpha + * @param[in] Ibeta input two-phase vector coordinate beta + * @param[out] pId points to output rotor reference frame d + * @param[out] pIq points to output rotor reference frame q + * @param[in] sinVal sine value of rotation angle theta + * @param[in] cosVal cosine value of rotation angle theta + * + * Scaling and Overflow Behavior: + * \par + * The function is implemented using an internal 32-bit accumulator. + * The accumulator maintains 1.31 format by truncating lower 31 bits of the intermediate multiplication in 2.62 format. + * There is saturation on the addition and subtraction, hence there is no risk of overflow. + */ + static __INLINE void arm_park_q31( + q31_t Ialpha, + q31_t Ibeta, + q31_t * pId, + q31_t * pIq, + q31_t sinVal, + q31_t cosVal) + { + q31_t product1, product2; /* Temporary variables used to store intermediate results */ + q31_t product3, product4; /* Temporary variables used to store intermediate results */ + + /* Intermediate product is calculated by (Ialpha * cosVal) */ + product1 = (q31_t) (((q63_t) (Ialpha) * (cosVal)) >> 31); + + /* Intermediate product is calculated by (Ibeta * sinVal) */ + product2 = (q31_t) (((q63_t) (Ibeta) * (sinVal)) >> 31); + + + /* Intermediate product is calculated by (Ialpha * sinVal) */ + product3 = (q31_t) (((q63_t) (Ialpha) * (sinVal)) >> 31); + + /* Intermediate product is calculated by (Ibeta * cosVal) */ + product4 = (q31_t) (((q63_t) (Ibeta) * (cosVal)) >> 31); + + /* Calculate pId by adding the two intermediate products 1 and 2 */ + *pId = __QADD(product1, product2); + + /* Calculate pIq by subtracting the two intermediate products 3 from 4 */ + *pIq = __QSUB(product4, product3); + } + + /** + * @} end of park group + */ + + /** + * @brief Converts the elements of the Q7 vector to floating-point vector. + * @param[in] pSrc is input pointer + * @param[out] pDst is output pointer + * @param[in] blockSize is the number of samples to process + */ + void arm_q7_to_float( + q7_t * pSrc, + float32_t * pDst, + uint32_t blockSize); + + + /** + * @ingroup groupController + */ + + /** + * @defgroup inv_park Vector Inverse Park transform + * Inverse Park transform converts the input flux and torque components to two-coordinate vector. + * + * The function operates on a single sample of data and each call to the function returns the processed output. + * The library provides separate functions for Q31 and floating-point data types. + * \par Algorithm + * \image html parkInvFormula.gif + * where pIalpha and pIbeta are the stator vector components, + * Id and Iq are rotor vector components and cosVal and sinVal are the + * cosine and sine values of theta (rotor flux position). + * \par Fixed-Point Behavior + * Care must be taken when using the Q31 version of the Park transform. + * In particular, the overflow and saturation behavior of the accumulator used must be considered. + * Refer to the function specific documentation below for usage guidelines. + */ + + /** + * @addtogroup inv_park + * @{ + */ + + /** + * @brief Floating-point Inverse Park transform + * @param[in] Id input coordinate of rotor reference frame d + * @param[in] Iq input coordinate of rotor reference frame q + * @param[out] pIalpha points to output two-phase orthogonal vector axis alpha + * @param[out] pIbeta points to output two-phase orthogonal vector axis beta + * @param[in] sinVal sine value of rotation angle theta + * @param[in] cosVal cosine value of rotation angle theta + */ + static __INLINE void arm_inv_park_f32( + float32_t Id, + float32_t Iq, + float32_t * pIalpha, + float32_t * pIbeta, + float32_t sinVal, + float32_t cosVal) + { + /* Calculate pIalpha using the equation, pIalpha = Id * cosVal - Iq * sinVal */ + *pIalpha = Id * cosVal - Iq * sinVal; + + /* Calculate pIbeta using the equation, pIbeta = Id * sinVal + Iq * cosVal */ + *pIbeta = Id * sinVal + Iq * cosVal; + } + + + /** + * @brief Inverse Park transform for Q31 version + * @param[in] Id input coordinate of rotor reference frame d + * @param[in] Iq input coordinate of rotor reference frame q + * @param[out] pIalpha points to output two-phase orthogonal vector axis alpha + * @param[out] pIbeta points to output two-phase orthogonal vector axis beta + * @param[in] sinVal sine value of rotation angle theta + * @param[in] cosVal cosine value of rotation angle theta + * + * Scaling and Overflow Behavior: + * \par + * The function is implemented using an internal 32-bit accumulator. + * The accumulator maintains 1.31 format by truncating lower 31 bits of the intermediate multiplication in 2.62 format. + * There is saturation on the addition, hence there is no risk of overflow. + */ + static __INLINE void arm_inv_park_q31( + q31_t Id, + q31_t Iq, + q31_t * pIalpha, + q31_t * pIbeta, + q31_t sinVal, + q31_t cosVal) + { + q31_t product1, product2; /* Temporary variables used to store intermediate results */ + q31_t product3, product4; /* Temporary variables used to store intermediate results */ + + /* Intermediate product is calculated by (Id * cosVal) */ + product1 = (q31_t) (((q63_t) (Id) * (cosVal)) >> 31); + + /* Intermediate product is calculated by (Iq * sinVal) */ + product2 = (q31_t) (((q63_t) (Iq) * (sinVal)) >> 31); + + + /* Intermediate product is calculated by (Id * sinVal) */ + product3 = (q31_t) (((q63_t) (Id) * (sinVal)) >> 31); + + /* Intermediate product is calculated by (Iq * cosVal) */ + product4 = (q31_t) (((q63_t) (Iq) * (cosVal)) >> 31); + + /* Calculate pIalpha by using the two intermediate products 1 and 2 */ + *pIalpha = __QSUB(product1, product2); + + /* Calculate pIbeta by using the two intermediate products 3 and 4 */ + *pIbeta = __QADD(product4, product3); + } + + /** + * @} end of Inverse park group + */ + + + /** + * @brief Converts the elements of the Q31 vector to floating-point vector. + * @param[in] pSrc is input pointer + * @param[out] pDst is output pointer + * @param[in] blockSize is the number of samples to process + */ + void arm_q31_to_float( + q31_t * pSrc, + float32_t * pDst, + uint32_t blockSize); + + /** + * @ingroup groupInterpolation + */ + + /** + * @defgroup LinearInterpolate Linear Interpolation + * + * Linear interpolation is a method of curve fitting using linear polynomials. + * Linear interpolation works by effectively drawing a straight line between two neighboring samples and returning the appropriate point along that line + * + * \par + * \image html LinearInterp.gif "Linear interpolation" + * + * \par + * A Linear Interpolate function calculates an output value(y), for the input(x) + * using linear interpolation of the input values x0, x1( nearest input values) and the output values y0 and y1(nearest output values) + * + * \par Algorithm: + * 
+   *       y = y0 + (x - x0) * ((y1 - y0)/(x1-x0))
+   *       where x0, x1 are nearest values of input x
+   *             y0, y1 are nearest values to output y
+   *
+ * + * \par + * This set of functions implements Linear interpolation process + * for Q7, Q15, Q31, and floating-point data types. The functions operate on a single + * sample of data and each call to the function returns a single processed value. + * S points to an instance of the Linear Interpolate function data structure. + * x is the input sample value. The functions returns the output value. + * + * \par + * if x is outside of the table boundary, Linear interpolation returns first value of the table + * if x is below input range and returns last value of table if x is above range. + */ + + /** + * @addtogroup LinearInterpolate + * @{ + */ + + /** + * @brief Process function for the floating-point Linear Interpolation Function. + * @param[in,out] S is an instance of the floating-point Linear Interpolation structure + * @param[in] x input sample to process + * @return y processed output sample. + * + */ + static __INLINE float32_t arm_linear_interp_f32( + arm_linear_interp_instance_f32 * S, + float32_t x) + { + float32_t y; + float32_t x0, x1; /* Nearest input values */ + float32_t y0, y1; /* Nearest output values */ + float32_t xSpacing = S->xSpacing; /* spacing between input values */ + int32_t i; /* Index variable */ + float32_t *pYData = S->pYData; /* pointer to output table */ + + /* Calculation of index */ + i = (int32_t) ((x - S->x1) / xSpacing); + + if(i < 0) + { + /* Iniatilize output for below specified range as least output value of table */ + y = pYData[0]; + } + else if((uint32_t)i >= S->nValues) + { + /* Iniatilize output for above specified range as last output value of table */ + y = pYData[S->nValues - 1]; + } + else + { + /* Calculation of nearest input values */ + x0 = S->x1 + i * xSpacing; + x1 = S->x1 + (i + 1) * xSpacing; + + /* Read of nearest output values */ + y0 = pYData[i]; + y1 = pYData[i + 1]; + + /* Calculation of output */ + y = y0 + (x - x0) * ((y1 - y0) / (x1 - x0)); + + } + + /* returns output value */ + return (y); + } + + + /** + * + * @brief Process function for the Q31 Linear Interpolation Function. + * @param[in] pYData pointer to Q31 Linear Interpolation table + * @param[in] x input sample to process + * @param[in] nValues number of table values + * @return y processed output sample. + * + * \par + * Input sample x is in 12.20 format which contains 12 bits for table index and 20 bits for fractional part. + * This function can support maximum of table size 2^12. + * + */ + static __INLINE q31_t arm_linear_interp_q31( + q31_t * pYData, + q31_t x, + uint32_t nValues) + { + q31_t y; /* output */ + q31_t y0, y1; /* Nearest output values */ + q31_t fract; /* fractional part */ + int32_t index; /* Index to read nearest output values */ + + /* Input is in 12.20 format */ + /* 12 bits for the table index */ + /* Index value calculation */ + index = ((x & (q31_t)0xFFF00000) >> 20); + + if(index >= (int32_t)(nValues - 1)) + { + return (pYData[nValues - 1]); + } + else if(index < 0) + { + return (pYData[0]); + } + else + { + /* 20 bits for the fractional part */ + /* shift left by 11 to keep fract in 1.31 format */ + fract = (x & 0x000FFFFF) << 11; + + /* Read two nearest output values from the index in 1.31(q31) format */ + y0 = pYData[index]; + y1 = pYData[index + 1]; + + /* Calculation of y0 * (1-fract) and y is in 2.30 format */ + y = ((q31_t) ((q63_t) y0 * (0x7FFFFFFF - fract) >> 32)); + + /* Calculation of y0 * (1-fract) + y1 *fract and y is in 2.30 format */ + y += ((q31_t) (((q63_t) y1 * fract) >> 32)); + + /* Convert y to 1.31 format */ + return (y << 1u); + } + } + + + /** + * + * @brief Process function for the Q15 Linear Interpolation Function. + * @param[in] pYData pointer to Q15 Linear Interpolation table + * @param[in] x input sample to process + * @param[in] nValues number of table values + * @return y processed output sample. + * + * \par + * Input sample x is in 12.20 format which contains 12 bits for table index and 20 bits for fractional part. + * This function can support maximum of table size 2^12. + * + */ + static __INLINE q15_t arm_linear_interp_q15( + q15_t * pYData, + q31_t x, + uint32_t nValues) + { + q63_t y; /* output */ + q15_t y0, y1; /* Nearest output values */ + q31_t fract; /* fractional part */ + int32_t index; /* Index to read nearest output values */ + + /* Input is in 12.20 format */ + /* 12 bits for the table index */ + /* Index value calculation */ + index = ((x & (int32_t)0xFFF00000) >> 20); + + if(index >= (int32_t)(nValues - 1)) + { + return (pYData[nValues - 1]); + } + else if(index < 0) + { + return (pYData[0]); + } + else + { + /* 20 bits for the fractional part */ + /* fract is in 12.20 format */ + fract = (x & 0x000FFFFF); + + /* Read two nearest output values from the index */ + y0 = pYData[index]; + y1 = pYData[index + 1]; + + /* Calculation of y0 * (1-fract) and y is in 13.35 format */ + y = ((q63_t) y0 * (0xFFFFF - fract)); + + /* Calculation of (y0 * (1-fract) + y1 * fract) and y is in 13.35 format */ + y += ((q63_t) y1 * (fract)); + + /* convert y to 1.15 format */ + return (q15_t) (y >> 20); + } + } + + + /** + * + * @brief Process function for the Q7 Linear Interpolation Function. + * @param[in] pYData pointer to Q7 Linear Interpolation table + * @param[in] x input sample to process + * @param[in] nValues number of table values + * @return y processed output sample. + * + * \par + * Input sample x is in 12.20 format which contains 12 bits for table index and 20 bits for fractional part. + * This function can support maximum of table size 2^12. + */ + static __INLINE q7_t arm_linear_interp_q7( + q7_t * pYData, + q31_t x, + uint32_t nValues) + { + q31_t y; /* output */ + q7_t y0, y1; /* Nearest output values */ + q31_t fract; /* fractional part */ + uint32_t index; /* Index to read nearest output values */ + + /* Input is in 12.20 format */ + /* 12 bits for the table index */ + /* Index value calculation */ + if (x < 0) + { + return (pYData[0]); + } + index = (x >> 20) & 0xfff; + + if(index >= (nValues - 1)) + { + return (pYData[nValues - 1]); + } + else + { + /* 20 bits for the fractional part */ + /* fract is in 12.20 format */ + fract = (x & 0x000FFFFF); + + /* Read two nearest output values from the index and are in 1.7(q7) format */ + y0 = pYData[index]; + y1 = pYData[index + 1]; + + /* Calculation of y0 * (1-fract ) and y is in 13.27(q27) format */ + y = ((y0 * (0xFFFFF - fract))); + + /* Calculation of y1 * fract + y0 * (1-fract) and y is in 13.27(q27) format */ + y += (y1 * fract); + + /* convert y to 1.7(q7) format */ + return (q7_t) (y >> 20); + } + } + + /** + * @} end of LinearInterpolate group + */ + + /** + * @brief Fast approximation to the trigonometric sine function for floating-point data. + * @param[in] x input value in radians. + * @return sin(x). + */ + float32_t arm_sin_f32( + float32_t x); + + + /** + * @brief Fast approximation to the trigonometric sine function for Q31 data. + * @param[in] x Scaled input value in radians. + * @return sin(x). + */ + q31_t arm_sin_q31( + q31_t x); + + + /** + * @brief Fast approximation to the trigonometric sine function for Q15 data. + * @param[in] x Scaled input value in radians. + * @return sin(x). + */ + q15_t arm_sin_q15( + q15_t x); + + + /** + * @brief Fast approximation to the trigonometric cosine function for floating-point data. + * @param[in] x input value in radians. + * @return cos(x). + */ + float32_t arm_cos_f32( + float32_t x); + + + /** + * @brief Fast approximation to the trigonometric cosine function for Q31 data. + * @param[in] x Scaled input value in radians. + * @return cos(x). + */ + q31_t arm_cos_q31( + q31_t x); + + + /** + * @brief Fast approximation to the trigonometric cosine function for Q15 data. + * @param[in] x Scaled input value in radians. + * @return cos(x). + */ + q15_t arm_cos_q15( + q15_t x); + + + /** + * @ingroup groupFastMath + */ + + + /** + * @defgroup SQRT Square Root + * + * Computes the square root of a number. + * There are separate functions for Q15, Q31, and floating-point data types. + * The square root function is computed using the Newton-Raphson algorithm. + * This is an iterative algorithm of the form: + * 
+   *      x1 = x0 - f(x0)/f'(x0)
+   *
+ * where x1 is the current estimate, + * x0 is the previous estimate, and + * f'(x0) is the derivative of f() evaluated at x0. + * For the square root function, the algorithm reduces to: + * 
+   *     x0 = in/2                         [initial guess]
+   *     x1 = 1/2 * ( x0 + in / x0)        [each iteration]
+   *
+ */ + + + /** + * @addtogroup SQRT + * @{ + */ + + /** + * @brief Floating-point square root function. + * @param[in] in input value. + * @param[out] pOut square root of input value. + * @return The function returns ARM_MATH_SUCCESS if input value is positive value or ARM_MATH_ARGUMENT_ERROR if + * in is negative value and returns zero output for negative values. + */ + static __INLINE arm_status arm_sqrt_f32( + float32_t in, + float32_t * pOut) + { + if(in >= 0.0f) + { + +#if (__FPU_USED == 1) && defined ( __CC_ARM ) + *pOut = __sqrtf(in); +#elif (__FPU_USED == 1) && (defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050)) + *pOut = __builtin_sqrtf(in); +#elif (__FPU_USED == 1) && defined(__GNUC__) + *pOut = __builtin_sqrtf(in); +#elif (__FPU_USED == 1) && defined ( __ICCARM__ ) && (__VER__ >= 6040000) + __ASM("VSQRT.F32 %0,%1" : "=t"(*pOut) : "t"(in)); +#else + *pOut = sqrtf(in); +#endif + + return (ARM_MATH_SUCCESS); + } + else + { + *pOut = 0.0f; + return (ARM_MATH_ARGUMENT_ERROR); + } + } + + + /** + * @brief Q31 square root function. + * @param[in] in input value. The range of the input value is [0 +1) or 0x00000000 to 0x7FFFFFFF. + * @param[out] pOut square root of input value. + * @return The function returns ARM_MATH_SUCCESS if input value is positive value or ARM_MATH_ARGUMENT_ERROR if + * in is negative value and returns zero output for negative values. + */ + arm_status arm_sqrt_q31( + q31_t in, + q31_t * pOut); + + + /** + * @brief Q15 square root function. + * @param[in] in input value. The range of the input value is [0 +1) or 0x0000 to 0x7FFF. + * @param[out] pOut square root of input value. + * @return The function returns ARM_MATH_SUCCESS if input value is positive value or ARM_MATH_ARGUMENT_ERROR if + * in is negative value and returns zero output for negative values. + */ + arm_status arm_sqrt_q15( + q15_t in, + q15_t * pOut); + + /** + * @} end of SQRT group + */ + + + /** + * @brief floating-point Circular write function. + */ + static __INLINE void arm_circularWrite_f32( + int32_t * circBuffer, + int32_t L, + uint16_t * writeOffset, + int32_t bufferInc, + const int32_t * src, + int32_t srcInc, + uint32_t blockSize) + { + uint32_t i = 0u; + int32_t wOffset; + + /* Copy the value of Index pointer that points + * to the current location where the input samples to be copied */ + wOffset = *writeOffset; + + /* Loop over the blockSize */ + i = blockSize; + + while(i > 0u) + { + /* copy the input sample to the circular buffer */ + circBuffer[wOffset] = *src; + + /* Update the input pointer */ + src += srcInc; + + /* Circularly update wOffset. Watch out for positive and negative value */ + wOffset += bufferInc; + if(wOffset >= L) + wOffset -= L; + + /* Decrement the loop counter */ + i--; + } + + /* Update the index pointer */ + *writeOffset = (uint16_t)wOffset; + } + + + + /** + * @brief floating-point Circular Read function. + */ + static __INLINE void arm_circularRead_f32( + int32_t * circBuffer, + int32_t L, + int32_t * readOffset, + int32_t bufferInc, + int32_t * dst, + int32_t * dst_base, + int32_t dst_length, + int32_t dstInc, + uint32_t blockSize) + { + uint32_t i = 0u; + int32_t rOffset, dst_end; + + /* Copy the value of Index pointer that points + * to the current location from where the input samples to be read */ + rOffset = *readOffset; + dst_end = (int32_t) (dst_base + dst_length); + + /* Loop over the blockSize */ + i = blockSize; + + while(i > 0u) + { + /* copy the sample from the circular buffer to the destination buffer */ + *dst = circBuffer[rOffset]; + + /* Update the input pointer */ + dst += dstInc; + + if(dst == (int32_t *) dst_end) + { + dst = dst_base; + } + + /* Circularly update rOffset. Watch out for positive and negative value */ + rOffset += bufferInc; + + if(rOffset >= L) + { + rOffset -= L; + } + + /* Decrement the loop counter */ + i--; + } + + /* Update the index pointer */ + *readOffset = rOffset; + } + + + /** + * @brief Q15 Circular write function. + */ + static __INLINE void arm_circularWrite_q15( + q15_t * circBuffer, + int32_t L, + uint16_t * writeOffset, + int32_t bufferInc, + const q15_t * src, + int32_t srcInc, + uint32_t blockSize) + { + uint32_t i = 0u; + int32_t wOffset; + + /* Copy the value of Index pointer that points + * to the current location where the input samples to be copied */ + wOffset = *writeOffset; + + /* Loop over the blockSize */ + i = blockSize; + + while(i > 0u) + { + /* copy the input sample to the circular buffer */ + circBuffer[wOffset] = *src; + + /* Update the input pointer */ + src += srcInc; + + /* Circularly update wOffset. Watch out for positive and negative value */ + wOffset += bufferInc; + if(wOffset >= L) + wOffset -= L; + + /* Decrement the loop counter */ + i--; + } + + /* Update the index pointer */ + *writeOffset = (uint16_t)wOffset; + } + + + /** + * @brief Q15 Circular Read function. + */ + static __INLINE void arm_circularRead_q15( + q15_t * circBuffer, + int32_t L, + int32_t * readOffset, + int32_t bufferInc, + q15_t * dst, + q15_t * dst_base, + int32_t dst_length, + int32_t dstInc, + uint32_t blockSize) + { + uint32_t i = 0; + int32_t rOffset, dst_end; + + /* Copy the value of Index pointer that points + * to the current location from where the input samples to be read */ + rOffset = *readOffset; + + dst_end = (int32_t) (dst_base + dst_length); + + /* Loop over the blockSize */ + i = blockSize; + + while(i > 0u) + { + /* copy the sample from the circular buffer to the destination buffer */ + *dst = circBuffer[rOffset]; + + /* Update the input pointer */ + dst += dstInc; + + if(dst == (q15_t *) dst_end) + { + dst = dst_base; + } + + /* Circularly update wOffset. Watch out for positive and negative value */ + rOffset += bufferInc; + + if(rOffset >= L) + { + rOffset -= L; + } + + /* Decrement the loop counter */ + i--; + } + + /* Update the index pointer */ + *readOffset = rOffset; + } + + + /** + * @brief Q7 Circular write function. + */ + static __INLINE void arm_circularWrite_q7( + q7_t * circBuffer, + int32_t L, + uint16_t * writeOffset, + int32_t bufferInc, + const q7_t * src, + int32_t srcInc, + uint32_t blockSize) + { + uint32_t i = 0u; + int32_t wOffset; + + /* Copy the value of Index pointer that points + * to the current location where the input samples to be copied */ + wOffset = *writeOffset; + + /* Loop over the blockSize */ + i = blockSize; + + while(i > 0u) + { + /* copy the input sample to the circular buffer */ + circBuffer[wOffset] = *src; + + /* Update the input pointer */ + src += srcInc; + + /* Circularly update wOffset. Watch out for positive and negative value */ + wOffset += bufferInc; + if(wOffset >= L) + wOffset -= L; + + /* Decrement the loop counter */ + i--; + } + + /* Update the index pointer */ + *writeOffset = (uint16_t)wOffset; + } + + + /** + * @brief Q7 Circular Read function. + */ + static __INLINE void arm_circularRead_q7( + q7_t * circBuffer, + int32_t L, + int32_t * readOffset, + int32_t bufferInc, + q7_t * dst, + q7_t * dst_base, + int32_t dst_length, + int32_t dstInc, + uint32_t blockSize) + { + uint32_t i = 0; + int32_t rOffset, dst_end; + + /* Copy the value of Index pointer that points + * to the current location from where the input samples to be read */ + rOffset = *readOffset; + + dst_end = (int32_t) (dst_base + dst_length); + + /* Loop over the blockSize */ + i = blockSize; + + while(i > 0u) + { + /* copy the sample from the circular buffer to the destination buffer */ + *dst = circBuffer[rOffset]; + + /* Update the input pointer */ + dst += dstInc; + + if(dst == (q7_t *) dst_end) + { + dst = dst_base; + } + + /* Circularly update rOffset. Watch out for positive and negative value */ + rOffset += bufferInc; + + if(rOffset >= L) + { + rOffset -= L; + } + + /* Decrement the loop counter */ + i--; + } + + /* Update the index pointer */ + *readOffset = rOffset; + } + + + /** + * @brief Sum of the squares of the elements of a Q31 vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output value. + */ + void arm_power_q31( + q31_t * pSrc, + uint32_t blockSize, + q63_t * pResult); + + + /** + * @brief Sum of the squares of the elements of a floating-point vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output value. + */ + void arm_power_f32( + float32_t * pSrc, + uint32_t blockSize, + float32_t * pResult); + + + /** + * @brief Sum of the squares of the elements of a Q15 vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output value. + */ + void arm_power_q15( + q15_t * pSrc, + uint32_t blockSize, + q63_t * pResult); + + + /** + * @brief Sum of the squares of the elements of a Q7 vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output value. + */ + void arm_power_q7( + q7_t * pSrc, + uint32_t blockSize, + q31_t * pResult); + + + /** + * @brief Mean value of a Q7 vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output value. + */ + void arm_mean_q7( + q7_t * pSrc, + uint32_t blockSize, + q7_t * pResult); + + + /** + * @brief Mean value of a Q15 vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output value. + */ + void arm_mean_q15( + q15_t * pSrc, + uint32_t blockSize, + q15_t * pResult); + + + /** + * @brief Mean value of a Q31 vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output value. + */ + void arm_mean_q31( + q31_t * pSrc, + uint32_t blockSize, + q31_t * pResult); + + + /** + * @brief Mean value of a floating-point vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output value. + */ + void arm_mean_f32( + float32_t * pSrc, + uint32_t blockSize, + float32_t * pResult); + + + /** + * @brief Variance of the elements of a floating-point vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output value. + */ + void arm_var_f32( + float32_t * pSrc, + uint32_t blockSize, + float32_t * pResult); + + + /** + * @brief Variance of the elements of a Q31 vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output value. + */ + void arm_var_q31( + q31_t * pSrc, + uint32_t blockSize, + q31_t * pResult); + + + /** + * @brief Variance of the elements of a Q15 vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output value. + */ + void arm_var_q15( + q15_t * pSrc, + uint32_t blockSize, + q15_t * pResult); + + + /** + * @brief Root Mean Square of the elements of a floating-point vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output value. + */ + void arm_rms_f32( + float32_t * pSrc, + uint32_t blockSize, + float32_t * pResult); + + + /** + * @brief Root Mean Square of the elements of a Q31 vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output value. + */ + void arm_rms_q31( + q31_t * pSrc, + uint32_t blockSize, + q31_t * pResult); + + + /** + * @brief Root Mean Square of the elements of a Q15 vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output value. + */ + void arm_rms_q15( + q15_t * pSrc, + uint32_t blockSize, + q15_t * pResult); + + + /** + * @brief Standard deviation of the elements of a floating-point vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output value. + */ + void arm_std_f32( + float32_t * pSrc, + uint32_t blockSize, + float32_t * pResult); + + + /** + * @brief Standard deviation of the elements of a Q31 vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output value. + */ + void arm_std_q31( + q31_t * pSrc, + uint32_t blockSize, + q31_t * pResult); + + + /** + * @brief Standard deviation of the elements of a Q15 vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output value. + */ + void arm_std_q15( + q15_t * pSrc, + uint32_t blockSize, + q15_t * pResult); + + + /** + * @brief Floating-point complex magnitude + * @param[in] pSrc points to the complex input vector + * @param[out] pDst points to the real output vector + * @param[in] numSamples number of complex samples in the input vector + */ + void arm_cmplx_mag_f32( + float32_t * pSrc, + float32_t * pDst, + uint32_t numSamples); + + + /** + * @brief Q31 complex magnitude + * @param[in] pSrc points to the complex input vector + * @param[out] pDst points to the real output vector + * @param[in] numSamples number of complex samples in the input vector + */ + void arm_cmplx_mag_q31( + q31_t * pSrc, + q31_t * pDst, + uint32_t numSamples); + + + /** + * @brief Q15 complex magnitude + * @param[in] pSrc points to the complex input vector + * @param[out] pDst points to the real output vector + * @param[in] numSamples number of complex samples in the input vector + */ + void arm_cmplx_mag_q15( + q15_t * pSrc, + q15_t * pDst, + uint32_t numSamples); + + + /** + * @brief Q15 complex dot product + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[in] numSamples number of complex samples in each vector + * @param[out] realResult real part of the result returned here + * @param[out] imagResult imaginary part of the result returned here + */ + void arm_cmplx_dot_prod_q15( + q15_t * pSrcA, + q15_t * pSrcB, + uint32_t numSamples, + q31_t * realResult, + q31_t * imagResult); + + + /** + * @brief Q31 complex dot product + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[in] numSamples number of complex samples in each vector + * @param[out] realResult real part of the result returned here + * @param[out] imagResult imaginary part of the result returned here + */ + void arm_cmplx_dot_prod_q31( + q31_t * pSrcA, + q31_t * pSrcB, + uint32_t numSamples, + q63_t * realResult, + q63_t * imagResult); + + + /** + * @brief Floating-point complex dot product + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[in] numSamples number of complex samples in each vector + * @param[out] realResult real part of the result returned here + * @param[out] imagResult imaginary part of the result returned here + */ + void arm_cmplx_dot_prod_f32( + float32_t * pSrcA, + float32_t * pSrcB, + uint32_t numSamples, + float32_t * realResult, + float32_t * imagResult); + + + /** + * @brief Q15 complex-by-real multiplication + * @param[in] pSrcCmplx points to the complex input vector + * @param[in] pSrcReal points to the real input vector + * @param[out] pCmplxDst points to the complex output vector + * @param[in] numSamples number of samples in each vector + */ + void arm_cmplx_mult_real_q15( + q15_t * pSrcCmplx, + q15_t * pSrcReal, + q15_t * pCmplxDst, + uint32_t numSamples); + + + /** + * @brief Q31 complex-by-real multiplication + * @param[in] pSrcCmplx points to the complex input vector + * @param[in] pSrcReal points to the real input vector + * @param[out] pCmplxDst points to the complex output vector + * @param[in] numSamples number of samples in each vector + */ + void arm_cmplx_mult_real_q31( + q31_t * pSrcCmplx, + q31_t * pSrcReal, + q31_t * pCmplxDst, + uint32_t numSamples); + + + /** + * @brief Floating-point complex-by-real multiplication + * @param[in] pSrcCmplx points to the complex input vector + * @param[in] pSrcReal points to the real input vector + * @param[out] pCmplxDst points to the complex output vector + * @param[in] numSamples number of samples in each vector + */ + void arm_cmplx_mult_real_f32( + float32_t * pSrcCmplx, + float32_t * pSrcReal, + float32_t * pCmplxDst, + uint32_t numSamples); + + + /** + * @brief Minimum value of a Q7 vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] result is output pointer + * @param[in] index is the array index of the minimum value in the input buffer. + */ + void arm_min_q7( + q7_t * pSrc, + uint32_t blockSize, + q7_t * result, + uint32_t * index); + + + /** + * @brief Minimum value of a Q15 vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output pointer + * @param[in] pIndex is the array index of the minimum value in the input buffer. + */ + void arm_min_q15( + q15_t * pSrc, + uint32_t blockSize, + q15_t * pResult, + uint32_t * pIndex); + + + /** + * @brief Minimum value of a Q31 vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output pointer + * @param[out] pIndex is the array index of the minimum value in the input buffer. + */ + void arm_min_q31( + q31_t * pSrc, + uint32_t blockSize, + q31_t * pResult, + uint32_t * pIndex); + + + /** + * @brief Minimum value of a floating-point vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output pointer + * @param[out] pIndex is the array index of the minimum value in the input buffer. + */ + void arm_min_f32( + float32_t * pSrc, + uint32_t blockSize, + float32_t * pResult, + uint32_t * pIndex); + + +/** + * @brief Maximum value of a Q7 vector. + * @param[in] pSrc points to the input buffer + * @param[in] blockSize length of the input vector + * @param[out] pResult maximum value returned here + * @param[out] pIndex index of maximum value returned here + */ + void arm_max_q7( + q7_t * pSrc, + uint32_t blockSize, + q7_t * pResult, + uint32_t * pIndex); + + +/** + * @brief Maximum value of a Q15 vector. + * @param[in] pSrc points to the input buffer + * @param[in] blockSize length of the input vector + * @param[out] pResult maximum value returned here + * @param[out] pIndex index of maximum value returned here + */ + void arm_max_q15( + q15_t * pSrc, + uint32_t blockSize, + q15_t * pResult, + uint32_t * pIndex); + + +/** + * @brief Maximum value of a Q31 vector. + * @param[in] pSrc points to the input buffer + * @param[in] blockSize length of the input vector + * @param[out] pResult maximum value returned here + * @param[out] pIndex index of maximum value returned here + */ + void arm_max_q31( + q31_t * pSrc, + uint32_t blockSize, + q31_t * pResult, + uint32_t * pIndex); + + +/** + * @brief Maximum value of a floating-point vector. + * @param[in] pSrc points to the input buffer + * @param[in] blockSize length of the input vector + * @param[out] pResult maximum value returned here + * @param[out] pIndex index of maximum value returned here + */ + void arm_max_f32( + float32_t * pSrc, + uint32_t blockSize, + float32_t * pResult, + uint32_t * pIndex); + + + /** + * @brief Q15 complex-by-complex multiplication + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[out] pDst points to the output vector + * @param[in] numSamples number of complex samples in each vector + */ + void arm_cmplx_mult_cmplx_q15( + q15_t * pSrcA, + q15_t * pSrcB, + q15_t * pDst, + uint32_t numSamples); + + + /** + * @brief Q31 complex-by-complex multiplication + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[out] pDst points to the output vector + * @param[in] numSamples number of complex samples in each vector + */ + void arm_cmplx_mult_cmplx_q31( + q31_t * pSrcA, + q31_t * pSrcB, + q31_t * pDst, + uint32_t numSamples); + + + /** + * @brief Floating-point complex-by-complex multiplication + * @param[in] pSrcA points to the first input vector + * @param[in] pSrcB points to the second input vector + * @param[out] pDst points to the output vector + * @param[in] numSamples number of complex samples in each vector + */ + void arm_cmplx_mult_cmplx_f32( + float32_t * pSrcA, + float32_t * pSrcB, + float32_t * pDst, + uint32_t numSamples); + + + /** + * @brief Converts the elements of the floating-point vector to Q31 vector. + * @param[in] pSrc points to the floating-point input vector + * @param[out] pDst points to the Q31 output vector + * @param[in] blockSize length of the input vector + */ + void arm_float_to_q31( + float32_t * pSrc, + q31_t * pDst, + uint32_t blockSize); + + + /** + * @brief Converts the elements of the floating-point vector to Q15 vector. + * @param[in] pSrc points to the floating-point input vector + * @param[out] pDst points to the Q15 output vector + * @param[in] blockSize length of the input vector + */ + void arm_float_to_q15( + float32_t * pSrc, + q15_t * pDst, + uint32_t blockSize); + + + /** + * @brief Converts the elements of the floating-point vector to Q7 vector. + * @param[in] pSrc points to the floating-point input vector + * @param[out] pDst points to the Q7 output vector + * @param[in] blockSize length of the input vector + */ + void arm_float_to_q7( + float32_t * pSrc, + q7_t * pDst, + uint32_t blockSize); + + + /** + * @brief Converts the elements of the Q31 vector to Q15 vector. + * @param[in] pSrc is input pointer + * @param[out] pDst is output pointer + * @param[in] blockSize is the number of samples to process + */ + void arm_q31_to_q15( + q31_t * pSrc, + q15_t * pDst, + uint32_t blockSize); + + + /** + * @brief Converts the elements of the Q31 vector to Q7 vector. + * @param[in] pSrc is input pointer + * @param[out] pDst is output pointer + * @param[in] blockSize is the number of samples to process + */ + void arm_q31_to_q7( + q31_t * pSrc, + q7_t * pDst, + uint32_t blockSize); + + + /** + * @brief Converts the elements of the Q15 vector to floating-point vector. + * @param[in] pSrc is input pointer + * @param[out] pDst is output pointer + * @param[in] blockSize is the number of samples to process + */ + void arm_q15_to_float( + q15_t * pSrc, + float32_t * pDst, + uint32_t blockSize); + + + /** + * @brief Converts the elements of the Q15 vector to Q31 vector. + * @param[in] pSrc is input pointer + * @param[out] pDst is output pointer + * @param[in] blockSize is the number of samples to process + */ + void arm_q15_to_q31( + q15_t * pSrc, + q31_t * pDst, + uint32_t blockSize); + + + /** + * @brief Converts the elements of the Q15 vector to Q7 vector. + * @param[in] pSrc is input pointer + * @param[out] pDst is output pointer + * @param[in] blockSize is the number of samples to process + */ + void arm_q15_to_q7( + q15_t * pSrc, + q7_t * pDst, + uint32_t blockSize); + + + /** + * @ingroup groupInterpolation + */ + + /** + * @defgroup BilinearInterpolate Bilinear Interpolation + * + * Bilinear interpolation is an extension of linear interpolation applied to a two dimensional grid. + * The underlying function f(x, y) is sampled on a regular grid and the interpolation process + * determines values between the grid points. + * Bilinear interpolation is equivalent to two step linear interpolation, first in the x-dimension and then in the y-dimension. + * Bilinear interpolation is often used in image processing to rescale images. + * The CMSIS DSP library provides bilinear interpolation functions for Q7, Q15, Q31, and floating-point data types. + * + * Algorithm + * \par + * The instance structure used by the bilinear interpolation functions describes a two dimensional data table. + * For floating-point, the instance structure is defined as: + * 
+   *   typedef struct
+   *   {
+   *     uint16_t numRows;
+   *     uint16_t numCols;
+   *     float32_t *pData;
+   * } arm_bilinear_interp_instance_f32;
+   *
+ * + * \par + * where numRows specifies the number of rows in the table; + * numCols specifies the number of columns in the table; + * and pData points to an array of size numRows*numCols values. + * The data table pTable is organized in row order and the supplied data values fall on integer indexes. + * That is, table element (x,y) is located at pTable[x + y*numCols] where x and y are integers. + * + * \par + * Let (x, y) specify the desired interpolation point. Then define: + * 
+   *     XF = floor(x)
+   *     YF = floor(y)
+   *
+ * \par + * The interpolated output point is computed as: + * 
+   *  f(x, y) = f(XF, YF) * (1-(x-XF)) * (1-(y-YF))
+   *           + f(XF+1, YF) * (x-XF)*(1-(y-YF))
+   *           + f(XF, YF+1) * (1-(x-XF))*(y-YF)
+   *           + f(XF+1, YF+1) * (x-XF)*(y-YF)
+   *
+ * Note that the coordinates (x, y) contain integer and fractional components. + * The integer components specify which portion of the table to use while the + * fractional components control the interpolation processor. + * + * \par + * if (x,y) are outside of the table boundary, Bilinear interpolation returns zero output. + */ + + /** + * @addtogroup BilinearInterpolate + * @{ + */ + + + /** + * + * @brief Floating-point bilinear interpolation. + * @param[in,out] S points to an instance of the interpolation structure. + * @param[in] X interpolation coordinate. + * @param[in] Y interpolation coordinate. + * @return out interpolated value. + */ + static __INLINE float32_t arm_bilinear_interp_f32( + const arm_bilinear_interp_instance_f32 * S, + float32_t X, + float32_t Y) + { + float32_t out; + float32_t f00, f01, f10, f11; + float32_t *pData = S->pData; + int32_t xIndex, yIndex, index; + float32_t xdiff, ydiff; + float32_t b1, b2, b3, b4; + + xIndex = (int32_t) X; + yIndex = (int32_t) Y; + + /* Care taken for table outside boundary */ + /* Returns zero output when values are outside table boundary */ + if(xIndex < 0 || xIndex > (S->numRows - 1) || yIndex < 0 || yIndex > (S->numCols - 1)) + { + return (0); + } + + /* Calculation of index for two nearest points in X-direction */ + index = (xIndex - 1) + (yIndex - 1) * S->numCols; + + + /* Read two nearest points in X-direction */ + f00 = pData[index]; + f01 = pData[index + 1]; + + /* Calculation of index for two nearest points in Y-direction */ + index = (xIndex - 1) + (yIndex) * S->numCols; + + + /* Read two nearest points in Y-direction */ + f10 = pData[index]; + f11 = pData[index + 1]; + + /* Calculation of intermediate values */ + b1 = f00; + b2 = f01 - f00; + b3 = f10 - f00; + b4 = f00 - f01 - f10 + f11; + + /* Calculation of fractional part in X */ + xdiff = X - xIndex; + + /* Calculation of fractional part in Y */ + ydiff = Y - yIndex; + + /* Calculation of bi-linear interpolated output */ + out = b1 + b2 * xdiff + b3 * ydiff + b4 * xdiff * ydiff; + + /* return to application */ + return (out); + } + + + /** + * + * @brief Q31 bilinear interpolation. + * @param[in,out] S points to an instance of the interpolation structure. + * @param[in] X interpolation coordinate in 12.20 format. + * @param[in] Y interpolation coordinate in 12.20 format. + * @return out interpolated value. + */ + static __INLINE q31_t arm_bilinear_interp_q31( + arm_bilinear_interp_instance_q31 * S, + q31_t X, + q31_t Y) + { + q31_t out; /* Temporary output */ + q31_t acc = 0; /* output */ + q31_t xfract, yfract; /* X, Y fractional parts */ + q31_t x1, x2, y1, y2; /* Nearest output values */ + int32_t rI, cI; /* Row and column indices */ + q31_t *pYData = S->pData; /* pointer to output table values */ + uint32_t nCols = S->numCols; /* num of rows */ + + /* Input is in 12.20 format */ + /* 12 bits for the table index */ + /* Index value calculation */ + rI = ((X & (q31_t)0xFFF00000) >> 20); + + /* Input is in 12.20 format */ + /* 12 bits for the table index */ + /* Index value calculation */ + cI = ((Y & (q31_t)0xFFF00000) >> 20); + + /* Care taken for table outside boundary */ + /* Returns zero output when values are outside table boundary */ + if(rI < 0 || rI > (S->numRows - 1) || cI < 0 || cI > (S->numCols - 1)) + { + return (0); + } + + /* 20 bits for the fractional part */ + /* shift left xfract by 11 to keep 1.31 format */ + xfract = (X & 0x000FFFFF) << 11u; + + /* Read two nearest output values from the index */ + x1 = pYData[(rI) + (int32_t)nCols * (cI) ]; + x2 = pYData[(rI) + (int32_t)nCols * (cI) + 1]; + + /* 20 bits for the fractional part */ + /* shift left yfract by 11 to keep 1.31 format */ + yfract = (Y & 0x000FFFFF) << 11u; + + /* Read two nearest output values from the index */ + y1 = pYData[(rI) + (int32_t)nCols * (cI + 1) ]; + y2 = pYData[(rI) + (int32_t)nCols * (cI + 1) + 1]; + + /* Calculation of x1 * (1-xfract ) * (1-yfract) and acc is in 3.29(q29) format */ + out = ((q31_t) (((q63_t) x1 * (0x7FFFFFFF - xfract)) >> 32)); + acc = ((q31_t) (((q63_t) out * (0x7FFFFFFF - yfract)) >> 32)); + + /* x2 * (xfract) * (1-yfract) in 3.29(q29) and adding to acc */ + out = ((q31_t) ((q63_t) x2 * (0x7FFFFFFF - yfract) >> 32)); + acc += ((q31_t) ((q63_t) out * (xfract) >> 32)); + + /* y1 * (1 - xfract) * (yfract) in 3.29(q29) and adding to acc */ + out = ((q31_t) ((q63_t) y1 * (0x7FFFFFFF - xfract) >> 32)); + acc += ((q31_t) ((q63_t) out * (yfract) >> 32)); + + /* y2 * (xfract) * (yfract) in 3.29(q29) and adding to acc */ + out = ((q31_t) ((q63_t) y2 * (xfract) >> 32)); + acc += ((q31_t) ((q63_t) out * (yfract) >> 32)); + + /* Convert acc to 1.31(q31) format */ + return ((q31_t)(acc << 2)); + } + + + /** + * @brief Q15 bilinear interpolation. + * @param[in,out] S points to an instance of the interpolation structure. + * @param[in] X interpolation coordinate in 12.20 format. + * @param[in] Y interpolation coordinate in 12.20 format. + * @return out interpolated value. + */ + static __INLINE q15_t arm_bilinear_interp_q15( + arm_bilinear_interp_instance_q15 * S, + q31_t X, + q31_t Y) + { + q63_t acc = 0; /* output */ + q31_t out; /* Temporary output */ + q15_t x1, x2, y1, y2; /* Nearest output values */ + q31_t xfract, yfract; /* X, Y fractional parts */ + int32_t rI, cI; /* Row and column indices */ + q15_t *pYData = S->pData; /* pointer to output table values */ + uint32_t nCols = S->numCols; /* num of rows */ + + /* Input is in 12.20 format */ + /* 12 bits for the table index */ + /* Index value calculation */ + rI = ((X & (q31_t)0xFFF00000) >> 20); + + /* Input is in 12.20 format */ + /* 12 bits for the table index */ + /* Index value calculation */ + cI = ((Y & (q31_t)0xFFF00000) >> 20); + + /* Care taken for table outside boundary */ + /* Returns zero output when values are outside table boundary */ + if(rI < 0 || rI > (S->numRows - 1) || cI < 0 || cI > (S->numCols - 1)) + { + return (0); + } + + /* 20 bits for the fractional part */ + /* xfract should be in 12.20 format */ + xfract = (X & 0x000FFFFF); + + /* Read two nearest output values from the index */ + x1 = pYData[((uint32_t)rI) + nCols * ((uint32_t)cI) ]; + x2 = pYData[((uint32_t)rI) + nCols * ((uint32_t)cI) + 1]; + + /* 20 bits for the fractional part */ + /* yfract should be in 12.20 format */ + yfract = (Y & 0x000FFFFF); + + /* Read two nearest output values from the index */ + y1 = pYData[((uint32_t)rI) + nCols * ((uint32_t)cI + 1) ]; + y2 = pYData[((uint32_t)rI) + nCols * ((uint32_t)cI + 1) + 1]; + + /* Calculation of x1 * (1-xfract ) * (1-yfract) and acc is in 13.51 format */ + + /* x1 is in 1.15(q15), xfract in 12.20 format and out is in 13.35 format */ + /* convert 13.35 to 13.31 by right shifting and out is in 1.31 */ + out = (q31_t) (((q63_t) x1 * (0xFFFFF - xfract)) >> 4u); + acc = ((q63_t) out * (0xFFFFF - yfract)); + + /* x2 * (xfract) * (1-yfract) in 1.51 and adding to acc */ + out = (q31_t) (((q63_t) x2 * (0xFFFFF - yfract)) >> 4u); + acc += ((q63_t) out * (xfract)); + + /* y1 * (1 - xfract) * (yfract) in 1.51 and adding to acc */ + out = (q31_t) (((q63_t) y1 * (0xFFFFF - xfract)) >> 4u); + acc += ((q63_t) out * (yfract)); + + /* y2 * (xfract) * (yfract) in 1.51 and adding to acc */ + out = (q31_t) (((q63_t) y2 * (xfract)) >> 4u); + acc += ((q63_t) out * (yfract)); + + /* acc is in 13.51 format and down shift acc by 36 times */ + /* Convert out to 1.15 format */ + return ((q15_t)(acc >> 36)); + } + + + /** + * @brief Q7 bilinear interpolation. + * @param[in,out] S points to an instance of the interpolation structure. + * @param[in] X interpolation coordinate in 12.20 format. + * @param[in] Y interpolation coordinate in 12.20 format. + * @return out interpolated value. + */ + static __INLINE q7_t arm_bilinear_interp_q7( + arm_bilinear_interp_instance_q7 * S, + q31_t X, + q31_t Y) + { + q63_t acc = 0; /* output */ + q31_t out; /* Temporary output */ + q31_t xfract, yfract; /* X, Y fractional parts */ + q7_t x1, x2, y1, y2; /* Nearest output values */ + int32_t rI, cI; /* Row and column indices */ + q7_t *pYData = S->pData; /* pointer to output table values */ + uint32_t nCols = S->numCols; /* num of rows */ + + /* Input is in 12.20 format */ + /* 12 bits for the table index */ + /* Index value calculation */ + rI = ((X & (q31_t)0xFFF00000) >> 20); + + /* Input is in 12.20 format */ + /* 12 bits for the table index */ + /* Index value calculation */ + cI = ((Y & (q31_t)0xFFF00000) >> 20); + + /* Care taken for table outside boundary */ + /* Returns zero output when values are outside table boundary */ + if(rI < 0 || rI > (S->numRows - 1) || cI < 0 || cI > (S->numCols - 1)) + { + return (0); + } + + /* 20 bits for the fractional part */ + /* xfract should be in 12.20 format */ + xfract = (X & (q31_t)0x000FFFFF); + + /* Read two nearest output values from the index */ + x1 = pYData[((uint32_t)rI) + nCols * ((uint32_t)cI) ]; + x2 = pYData[((uint32_t)rI) + nCols * ((uint32_t)cI) + 1]; + + /* 20 bits for the fractional part */ + /* yfract should be in 12.20 format */ + yfract = (Y & (q31_t)0x000FFFFF); + + /* Read two nearest output values from the index */ + y1 = pYData[((uint32_t)rI) + nCols * ((uint32_t)cI + 1) ]; + y2 = pYData[((uint32_t)rI) + nCols * ((uint32_t)cI + 1) + 1]; + + /* Calculation of x1 * (1-xfract ) * (1-yfract) and acc is in 16.47 format */ + out = ((x1 * (0xFFFFF - xfract))); + acc = (((q63_t) out * (0xFFFFF - yfract))); + + /* x2 * (xfract) * (1-yfract) in 2.22 and adding to acc */ + out = ((x2 * (0xFFFFF - yfract))); + acc += (((q63_t) out * (xfract))); + + /* y1 * (1 - xfract) * (yfract) in 2.22 and adding to acc */ + out = ((y1 * (0xFFFFF - xfract))); + acc += (((q63_t) out * (yfract))); + + /* y2 * (xfract) * (yfract) in 2.22 and adding to acc */ + out = ((y2 * (yfract))); + acc += (((q63_t) out * (xfract))); + + /* acc in 16.47 format and down shift by 40 to convert to 1.7 format */ + return ((q7_t)(acc >> 40)); + } + + /** + * @} end of BilinearInterpolate group + */ + + +/* SMMLAR */ +#define multAcc_32x32_keep32_R(a, x, y) \ + a = (q31_t) (((((q63_t) a) << 32) + ((q63_t) x * y) + 0x80000000LL ) >> 32) + +/* SMMLSR */ +#define multSub_32x32_keep32_R(a, x, y) \ + a = (q31_t) (((((q63_t) a) << 32) - ((q63_t) x * y) + 0x80000000LL ) >> 32) + +/* SMMULR */ +#define mult_32x32_keep32_R(a, x, y) \ + a = (q31_t) (((q63_t) x * y + 0x80000000LL ) >> 32) + +/* SMMLA */ +#define multAcc_32x32_keep32(a, x, y) \ + a += (q31_t) (((q63_t) x * y) >> 32) + +/* SMMLS */ +#define multSub_32x32_keep32(a, x, y) \ + a -= (q31_t) (((q63_t) x * y) >> 32) + +/* SMMUL */ +#define mult_32x32_keep32(a, x, y) \ + a = (q31_t) (((q63_t) x * y ) >> 32) + + +#if defined ( __CC_ARM ) + /* Enter low optimization region - place directly above function definition */ + #if defined( ARM_MATH_CM4 ) || defined( ARM_MATH_CM7) + #define LOW_OPTIMIZATION_ENTER \ + _Pragma ("push") \ + _Pragma ("O1") + #else + #define LOW_OPTIMIZATION_ENTER + #endif + + /* Exit low optimization region - place directly after end of function definition */ + #if defined( ARM_MATH_CM4 ) || defined( ARM_MATH_CM7) + #define LOW_OPTIMIZATION_EXIT \ + _Pragma ("pop") + #else + #define LOW_OPTIMIZATION_EXIT + #endif + + /* Enter low optimization region - place directly above function definition */ + #define IAR_ONLY_LOW_OPTIMIZATION_ENTER + + /* Exit low optimization region - place directly after end of function definition */ + #define IAR_ONLY_LOW_OPTIMIZATION_EXIT + +#elif defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050) + #define LOW_OPTIMIZATION_ENTER + #define LOW_OPTIMIZATION_EXIT + #define IAR_ONLY_LOW_OPTIMIZATION_ENTER + #define IAR_ONLY_LOW_OPTIMIZATION_EXIT + +#elif defined(__GNUC__) + #define LOW_OPTIMIZATION_ENTER __attribute__(( optimize("-O1") )) + #define LOW_OPTIMIZATION_EXIT + #define IAR_ONLY_LOW_OPTIMIZATION_ENTER + #define IAR_ONLY_LOW_OPTIMIZATION_EXIT + +#elif defined(__ICCARM__) + /* Enter low optimization region - place directly above function definition */ + #if defined( ARM_MATH_CM4 ) || defined( ARM_MATH_CM7) + #define LOW_OPTIMIZATION_ENTER \ + _Pragma ("optimize=low") + #else + #define LOW_OPTIMIZATION_ENTER + #endif + + /* Exit low optimization region - place directly after end of function definition */ + #define LOW_OPTIMIZATION_EXIT + + /* Enter low optimization region - place directly above function definition */ + #if defined( ARM_MATH_CM4 ) || defined( ARM_MATH_CM7) + #define IAR_ONLY_LOW_OPTIMIZATION_ENTER \ + _Pragma ("optimize=low") + #else + #define IAR_ONLY_LOW_OPTIMIZATION_ENTER + #endif + + /* Exit low optimization region - place directly after end of function definition */ + #define IAR_ONLY_LOW_OPTIMIZATION_EXIT + +#elif defined(__CSMC__) + #define LOW_OPTIMIZATION_ENTER + #define LOW_OPTIMIZATION_EXIT + #define IAR_ONLY_LOW_OPTIMIZATION_ENTER + #define IAR_ONLY_LOW_OPTIMIZATION_EXIT + +#elif defined(__TASKING__) + #define LOW_OPTIMIZATION_ENTER + #define LOW_OPTIMIZATION_EXIT + #define IAR_ONLY_LOW_OPTIMIZATION_ENTER + #define IAR_ONLY_LOW_OPTIMIZATION_EXIT + +#endif + + +#ifdef __cplusplus +} +#endif + + +#if defined ( __GNUC__ ) +#pragma GCC diagnostic pop +#endif + +#endif /* _ARM_MATH_H */ + +/** + * + * End of file. + */ diff --git a/CORE/core_cm4.h b/CORE/core_cm4.h new file mode 100644 index 0000000..d65016c --- /dev/null +++ b/CORE/core_cm4.h @@ -0,0 +1,1772 @@ +/**************************************************************************//** + * @file core_cm4.h + * @brief CMSIS Cortex-M4 Core Peripheral Access Layer Header File + * @version V3.20 + * @date 25. February 2013 + * + * @note + * + ******************************************************************************/ +/* Copyright (c) 2009 - 2013 ARM LIMITED + + All rights reserved. + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions are met: + - Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + - Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + - Neither the name of ARM nor the names of its contributors may be used + to endorse or promote products derived from this software without + specific prior written permission. + * + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" + AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDERS AND CONTRIBUTORS BE + LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR + CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF + SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) + ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE + POSSIBILITY OF SUCH DAMAGE. + ---------------------------------------------------------------------------*/ + + +#if defined ( __ICCARM__ ) + #pragma system_include /* treat file as system include file for MISRA check */ +#endif + +#ifdef __cplusplus + extern "C" { +#endif + +#ifndef __CORE_CM4_H_GENERIC +#define __CORE_CM4_H_GENERIC + +/** \page CMSIS_MISRA_Exceptions MISRA-C:2004 Compliance Exceptions + CMSIS violates the following MISRA-C:2004 rules: + + \li Required Rule 8.5, object/function definition in header file.
+ Function definitions in header files are used to allow 'inlining'. + + \li Required Rule 18.4, declaration of union type or object of union type: '{...}'.
+ Unions are used for effective representation of core registers. + + \li Advisory Rule 19.7, Function-like macro defined.
+ Function-like macros are used to allow more efficient code. + */ + + +/******************************************************************************* + * CMSIS definitions + ******************************************************************************/ +/** \ingroup Cortex_M4 + @{ + */ + +/* CMSIS CM4 definitions */ +#define __CM4_CMSIS_VERSION_MAIN (0x03) /*!< [31:16] CMSIS HAL main version */ +#define __CM4_CMSIS_VERSION_SUB (0x20) /*!< [15:0] CMSIS HAL sub version */ +#define __CM4_CMSIS_VERSION ((__CM4_CMSIS_VERSION_MAIN << 16) | \ + __CM4_CMSIS_VERSION_SUB ) /*!< CMSIS HAL version number */ + +#define __CORTEX_M (0x04) /*!< Cortex-M Core */ + + +#if defined ( __CC_ARM ) + #define __ASM __asm /*!< asm keyword for ARM Compiler */ + #define __INLINE __inline /*!< inline keyword for ARM Compiler */ + #define __STATIC_INLINE static __inline + +#elif defined ( __ICCARM__ ) + #define __ASM __asm /*!< asm keyword for IAR Compiler */ + #define __INLINE inline /*!< inline keyword for IAR Compiler. Only available in High optimization mode! */ + #define __STATIC_INLINE static inline + +#elif defined ( __TMS470__ ) + #define __ASM __asm /*!< asm keyword for TI CCS Compiler */ + #define __STATIC_INLINE static inline + +#elif defined ( __GNUC__ ) + #define __ASM __asm /*!< asm keyword for GNU Compiler */ + #define __INLINE inline /*!< inline keyword for GNU Compiler */ + #define __STATIC_INLINE static inline + +#elif defined ( __TASKING__ ) + #define __ASM __asm /*!< asm keyword for TASKING Compiler */ + #define __INLINE inline /*!< inline keyword for TASKING Compiler */ + #define __STATIC_INLINE static inline + +#endif + +/** __FPU_USED indicates whether an FPU is used or not. For this, __FPU_PRESENT has to be checked prior to making use of FPU specific registers and functions. +*/ +#if defined ( __CC_ARM ) + #if defined __TARGET_FPU_VFP + #if (__FPU_PRESENT == 1) + #define __FPU_USED 1 + #else + #warning "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #define __FPU_USED 0 + #endif + #else + #define __FPU_USED 0 + #endif + +#elif defined ( __ICCARM__ ) + #if defined __ARMVFP__ + #if (__FPU_PRESENT == 1) + #define __FPU_USED 1 + #else + #warning "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #define __FPU_USED 0 + #endif + #else + #define __FPU_USED 0 + #endif + +#elif defined ( __TMS470__ ) + #if defined __TI_VFP_SUPPORT__ + #if (__FPU_PRESENT == 1) + #define __FPU_USED 1 + #else + #warning "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #define __FPU_USED 0 + #endif + #else + #define __FPU_USED 0 + #endif + +#elif defined ( __GNUC__ ) + #if defined (__VFP_FP__) && !defined(__SOFTFP__) + #if (__FPU_PRESENT == 1) + #define __FPU_USED 1 + #else + #warning "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #define __FPU_USED 0 + #endif + #else + #define __FPU_USED 0 + #endif + +#elif defined ( __TASKING__ ) + #if defined __FPU_VFP__ + #if (__FPU_PRESENT == 1) + #define __FPU_USED 1 + #else + #error "Compiler generates FPU instructions for a device without an FPU (check __FPU_PRESENT)" + #define __FPU_USED 0 + #endif + #else + #define __FPU_USED 0 + #endif +#endif + +#include /* standard types definitions */ +#include /* Core Instruction Access */ +#include /* Core Function Access */ +#include /* Compiler specific SIMD Intrinsics */ + +#endif /* __CORE_CM4_H_GENERIC */ + +#ifndef __CMSIS_GENERIC + +#ifndef __CORE_CM4_H_DEPENDANT +#define __CORE_CM4_H_DEPENDANT + +/* check device defines and use defaults */ +#if defined __CHECK_DEVICE_DEFINES + #ifndef __CM4_REV + #define __CM4_REV 0x0000 + #warning "__CM4_REV not defined in device header file; using default!" + #endif + + #ifndef __FPU_PRESENT + #define __FPU_PRESENT 0 + #warning "__FPU_PRESENT not defined in device header file; using default!" + #endif + + #ifndef __MPU_PRESENT + #define __MPU_PRESENT 0 + #warning "__MPU_PRESENT not defined in device header file; using default!" + #endif + + #ifndef __NVIC_PRIO_BITS + #define __NVIC_PRIO_BITS 4 + #warning "__NVIC_PRIO_BITS not defined in device header file; using default!" + #endif + + #ifndef __Vendor_SysTickConfig + #define __Vendor_SysTickConfig 0 + #warning "__Vendor_SysTickConfig not defined in device header file; using default!" + #endif +#endif + +/* IO definitions (access restrictions to peripheral registers) */ +/** + \defgroup CMSIS_glob_defs CMSIS Global Defines + + IO Type Qualifiers are used + \li to specify the access to peripheral variables. + \li for automatic generation of peripheral register debug information. +*/ +#ifdef __cplusplus + #define __I volatile /*!< Defines 'read only' permissions */ +#else + #define __I volatile const /*!< Defines 'read only' permissions */ +#endif +#define __O volatile /*!< Defines 'write only' permissions */ +#define __IO volatile /*!< Defines 'read / write' permissions */ + +/*@} end of group Cortex_M4 */ + + + +/******************************************************************************* + * Register Abstraction + Core Register contain: + - Core Register + - Core NVIC Register + - Core SCB Register + - Core SysTick Register + - Core Debug Register + - Core MPU Register + - Core FPU Register + ******************************************************************************/ +/** \defgroup CMSIS_core_register Defines and Type Definitions + \brief Type definitions and defines for Cortex-M processor based devices. +*/ + +/** \ingroup CMSIS_core_register + \defgroup CMSIS_CORE Status and Control Registers + \brief Core Register type definitions. + @{ + */ + +/** \brief Union type to access the Application Program Status Register (APSR). + */ +typedef union +{ + struct + { +#if (__CORTEX_M != 0x04) + uint32_t _reserved0:27; /*!< bit: 0..26 Reserved */ +#else + uint32_t _reserved0:16; /*!< bit: 0..15 Reserved */ + uint32_t GE:4; /*!< bit: 16..19 Greater than or Equal flags */ + uint32_t _reserved1:7; /*!< bit: 20..26 Reserved */ +#endif + uint32_t Q:1; /*!< bit: 27 Saturation condition flag */ + uint32_t V:1; /*!< bit: 28 Overflow condition code flag */ + uint32_t C:1; /*!< bit: 29 Carry condition code flag */ + uint32_t Z:1; /*!< bit: 30 Zero condition code flag */ + uint32_t N:1; /*!< bit: 31 Negative condition code flag */ + } b; /*!< Structure used for bit access */ + uint32_t w; /*!< Type used for word access */ +} APSR_Type; + + +/** \brief Union type to access the Interrupt Program Status Register (IPSR). + */ +typedef union +{ + struct + { + uint32_t ISR:9; /*!< bit: 0.. 8 Exception number */ + uint32_t _reserved0:23; /*!< bit: 9..31 Reserved */ + } b; /*!< Structure used for bit access */ + uint32_t w; /*!< Type used for word access */ +} IPSR_Type; + + +/** \brief Union type to access the Special-Purpose Program Status Registers (xPSR). + */ +typedef union +{ + struct + { + uint32_t ISR:9; /*!< bit: 0.. 8 Exception number */ +#if (__CORTEX_M != 0x04) + uint32_t _reserved0:15; /*!< bit: 9..23 Reserved */ +#else + uint32_t _reserved0:7; /*!< bit: 9..15 Reserved */ + uint32_t GE:4; /*!< bit: 16..19 Greater than or Equal flags */ + uint32_t _reserved1:4; /*!< bit: 20..23 Reserved */ +#endif + uint32_t T:1; /*!< bit: 24 Thumb bit (read 0) */ + uint32_t IT:2; /*!< bit: 25..26 saved IT state (read 0) */ + uint32_t Q:1; /*!< bit: 27 Saturation condition flag */ + uint32_t V:1; /*!< bit: 28 Overflow condition code flag */ + uint32_t C:1; /*!< bit: 29 Carry condition code flag */ + uint32_t Z:1; /*!< bit: 30 Zero condition code flag */ + uint32_t N:1; /*!< bit: 31 Negative condition code flag */ + } b; /*!< Structure used for bit access */ + uint32_t w; /*!< Type used for word access */ +} xPSR_Type; + + +/** \brief Union type to access the Control Registers (CONTROL). + */ +typedef union +{ + struct + { + uint32_t nPRIV:1; /*!< bit: 0 Execution privilege in Thread mode */ + uint32_t SPSEL:1; /*!< bit: 1 Stack to be used */ + uint32_t FPCA:1; /*!< bit: 2 FP extension active flag */ + uint32_t _reserved0:29; /*!< bit: 3..31 Reserved */ + } b; /*!< Structure used for bit access */ + uint32_t w; /*!< Type used for word access */ +} CONTROL_Type; + +/*@} end of group CMSIS_CORE */ + + +/** \ingroup CMSIS_core_register + \defgroup CMSIS_NVIC Nested Vectored Interrupt Controller (NVIC) + \brief Type definitions for the NVIC Registers + @{ + */ + +/** \brief Structure type to access the Nested Vectored Interrupt Controller (NVIC). + */ +typedef struct +{ + __IO uint32_t ISER[8]; /*!< Offset: 0x000 (R/W) Interrupt Set Enable Register */ + uint32_t RESERVED0[24]; + __IO uint32_t ICER[8]; /*!< Offset: 0x080 (R/W) Interrupt Clear Enable Register */ + uint32_t RSERVED1[24]; + __IO uint32_t ISPR[8]; /*!< Offset: 0x100 (R/W) Interrupt Set Pending Register */ + uint32_t RESERVED2[24]; + __IO uint32_t ICPR[8]; /*!< Offset: 0x180 (R/W) Interrupt Clear Pending Register */ + uint32_t RESERVED3[24]; + __IO uint32_t IABR[8]; /*!< Offset: 0x200 (R/W) Interrupt Active bit Register */ + uint32_t RESERVED4[56]; + __IO uint8_t IP[240]; /*!< Offset: 0x300 (R/W) Interrupt Priority Register (8Bit wide) */ + uint32_t RESERVED5[644]; + __O uint32_t STIR; /*!< Offset: 0xE00 ( /W) Software Trigger Interrupt Register */ +} NVIC_Type; + +/* Software Triggered Interrupt Register Definitions */ +#define NVIC_STIR_INTID_Pos 0 /*!< STIR: INTLINESNUM Position */ +#define NVIC_STIR_INTID_Msk (0x1FFUL << NVIC_STIR_INTID_Pos) /*!< STIR: INTLINESNUM Mask */ + +/*@} end of group CMSIS_NVIC */ + + +/** \ingroup CMSIS_core_register + \defgroup CMSIS_SCB System Control Block (SCB) + \brief Type definitions for the System Control Block Registers + @{ + */ + +/** \brief Structure type to access the System Control Block (SCB). + */ +typedef struct +{ + __I uint32_t CPUID; /*!< Offset: 0x000 (R/ ) CPUID Base Register */ + __IO uint32_t ICSR; /*!< Offset: 0x004 (R/W) Interrupt Control and State Register */ + __IO uint32_t VTOR; /*!< Offset: 0x008 (R/W) Vector Table Offset Register */ + __IO uint32_t AIRCR; /*!< Offset: 0x00C (R/W) Application Interrupt and Reset Control Register */ + __IO uint32_t SCR; /*!< Offset: 0x010 (R/W) System Control Register */ + __IO uint32_t CCR; /*!< Offset: 0x014 (R/W) Configuration Control Register */ + __IO uint8_t SHP[12]; /*!< Offset: 0x018 (R/W) System Handlers Priority Registers (4-7, 8-11, 12-15) */ + __IO uint32_t SHCSR; /*!< Offset: 0x024 (R/W) System Handler Control and State Register */ + __IO uint32_t CFSR; /*!< Offset: 0x028 (R/W) Configurable Fault Status Register */ + __IO uint32_t HFSR; /*!< Offset: 0x02C (R/W) HardFault Status Register */ + __IO uint32_t DFSR; /*!< Offset: 0x030 (R/W) Debug Fault Status Register */ + __IO uint32_t MMFAR; /*!< Offset: 0x034 (R/W) MemManage Fault Address Register */ + __IO uint32_t BFAR; /*!< Offset: 0x038 (R/W) BusFault Address Register */ + __IO uint32_t AFSR; /*!< Offset: 0x03C (R/W) Auxiliary Fault Status Register */ + __I uint32_t PFR[2]; /*!< Offset: 0x040 (R/ ) Processor Feature Register */ + __I uint32_t DFR; /*!< Offset: 0x048 (R/ ) Debug Feature Register */ + __I uint32_t ADR; /*!< Offset: 0x04C (R/ ) Auxiliary Feature Register */ + __I uint32_t MMFR[4]; /*!< Offset: 0x050 (R/ ) Memory Model Feature Register */ + __I uint32_t ISAR[5]; /*!< Offset: 0x060 (R/ ) Instruction Set Attributes Register */ + uint32_t RESERVED0[5]; + __IO uint32_t CPACR; /*!< Offset: 0x088 (R/W) Coprocessor Access Control Register */ +} SCB_Type; + +/* SCB CPUID Register Definitions */ +#define SCB_CPUID_IMPLEMENTER_Pos 24 /*!< SCB CPUID: IMPLEMENTER Position */ +#define SCB_CPUID_IMPLEMENTER_Msk (0xFFUL << SCB_CPUID_IMPLEMENTER_Pos) /*!< SCB CPUID: IMPLEMENTER Mask */ + +#define SCB_CPUID_VARIANT_Pos 20 /*!< SCB CPUID: VARIANT Position */ +#define SCB_CPUID_VARIANT_Msk (0xFUL << SCB_CPUID_VARIANT_Pos) /*!< SCB CPUID: VARIANT Mask */ + +#define SCB_CPUID_ARCHITECTURE_Pos 16 /*!< SCB CPUID: ARCHITECTURE Position */ +#define SCB_CPUID_ARCHITECTURE_Msk (0xFUL << SCB_CPUID_ARCHITECTURE_Pos) /*!< SCB CPUID: ARCHITECTURE Mask */ + +#define SCB_CPUID_PARTNO_Pos 4 /*!< SCB CPUID: PARTNO Position */ +#define SCB_CPUID_PARTNO_Msk (0xFFFUL << SCB_CPUID_PARTNO_Pos) /*!< SCB CPUID: PARTNO Mask */ + +#define SCB_CPUID_REVISION_Pos 0 /*!< SCB CPUID: REVISION Position */ +#define SCB_CPUID_REVISION_Msk (0xFUL << SCB_CPUID_REVISION_Pos) /*!< SCB CPUID: REVISION Mask */ + +/* SCB Interrupt Control State Register Definitions */ +#define SCB_ICSR_NMIPENDSET_Pos 31 /*!< SCB ICSR: NMIPENDSET Position */ +#define SCB_ICSR_NMIPENDSET_Msk (1UL << SCB_ICSR_NMIPENDSET_Pos) /*!< SCB ICSR: NMIPENDSET Mask */ + +#define SCB_ICSR_PENDSVSET_Pos 28 /*!< SCB ICSR: PENDSVSET Position */ +#define SCB_ICSR_PENDSVSET_Msk (1UL << SCB_ICSR_PENDSVSET_Pos) /*!< SCB ICSR: PENDSVSET Mask */ + +#define SCB_ICSR_PENDSVCLR_Pos 27 /*!< SCB ICSR: PENDSVCLR Position */ +#define SCB_ICSR_PENDSVCLR_Msk (1UL << SCB_ICSR_PENDSVCLR_Pos) /*!< SCB ICSR: PENDSVCLR Mask */ + +#define SCB_ICSR_PENDSTSET_Pos 26 /*!< SCB ICSR: PENDSTSET Position */ +#define SCB_ICSR_PENDSTSET_Msk (1UL << SCB_ICSR_PENDSTSET_Pos) /*!< SCB ICSR: PENDSTSET Mask */ + +#define SCB_ICSR_PENDSTCLR_Pos 25 /*!< SCB ICSR: PENDSTCLR Position */ +#define SCB_ICSR_PENDSTCLR_Msk (1UL << SCB_ICSR_PENDSTCLR_Pos) /*!< SCB ICSR: PENDSTCLR Mask */ + +#define SCB_ICSR_ISRPREEMPT_Pos 23 /*!< SCB ICSR: ISRPREEMPT Position */ +#define SCB_ICSR_ISRPREEMPT_Msk (1UL << SCB_ICSR_ISRPREEMPT_Pos) /*!< SCB ICSR: ISRPREEMPT Mask */ + +#define SCB_ICSR_ISRPENDING_Pos 22 /*!< SCB ICSR: ISRPENDING Position */ +#define SCB_ICSR_ISRPENDING_Msk (1UL << SCB_ICSR_ISRPENDING_Pos) /*!< SCB ICSR: ISRPENDING Mask */ + +#define SCB_ICSR_VECTPENDING_Pos 12 /*!< SCB ICSR: VECTPENDING Position */ +#define SCB_ICSR_VECTPENDING_Msk (0x1FFUL << SCB_ICSR_VECTPENDING_Pos) /*!< SCB ICSR: VECTPENDING Mask */ + +#define SCB_ICSR_RETTOBASE_Pos 11 /*!< SCB ICSR: RETTOBASE Position */ +#define SCB_ICSR_RETTOBASE_Msk (1UL << SCB_ICSR_RETTOBASE_Pos) /*!< SCB ICSR: RETTOBASE Mask */ + +#define SCB_ICSR_VECTACTIVE_Pos 0 /*!< SCB ICSR: VECTACTIVE Position */ +#define SCB_ICSR_VECTACTIVE_Msk (0x1FFUL << SCB_ICSR_VECTACTIVE_Pos) /*!< SCB ICSR: VECTACTIVE Mask */ + +/* SCB Vector Table Offset Register Definitions */ +#define SCB_VTOR_TBLOFF_Pos 7 /*!< SCB VTOR: TBLOFF Position */ +#define SCB_VTOR_TBLOFF_Msk (0x1FFFFFFUL << SCB_VTOR_TBLOFF_Pos) /*!< SCB VTOR: TBLOFF Mask */ + +/* SCB Application Interrupt and Reset Control Register Definitions */ +#define SCB_AIRCR_VECTKEY_Pos 16 /*!< SCB AIRCR: VECTKEY Position */ +#define SCB_AIRCR_VECTKEY_Msk (0xFFFFUL << SCB_AIRCR_VECTKEY_Pos) /*!< SCB AIRCR: VECTKEY Mask */ + +#define SCB_AIRCR_VECTKEYSTAT_Pos 16 /*!< SCB AIRCR: VECTKEYSTAT Position */ +#define SCB_AIRCR_VECTKEYSTAT_Msk (0xFFFFUL << SCB_AIRCR_VECTKEYSTAT_Pos) /*!< SCB AIRCR: VECTKEYSTAT Mask */ + +#define SCB_AIRCR_ENDIANESS_Pos 15 /*!< SCB AIRCR: ENDIANESS Position */ +#define SCB_AIRCR_ENDIANESS_Msk (1UL << SCB_AIRCR_ENDIANESS_Pos) /*!< SCB AIRCR: ENDIANESS Mask */ + +#define SCB_AIRCR_PRIGROUP_Pos 8 /*!< SCB AIRCR: PRIGROUP Position */ +#define SCB_AIRCR_PRIGROUP_Msk (7UL << SCB_AIRCR_PRIGROUP_Pos) /*!< SCB AIRCR: PRIGROUP Mask */ + +#define SCB_AIRCR_SYSRESETREQ_Pos 2 /*!< SCB AIRCR: SYSRESETREQ Position */ +#define SCB_AIRCR_SYSRESETREQ_Msk (1UL << SCB_AIRCR_SYSRESETREQ_Pos) /*!< SCB AIRCR: SYSRESETREQ Mask */ + +#define SCB_AIRCR_VECTCLRACTIVE_Pos 1 /*!< SCB AIRCR: VECTCLRACTIVE Position */ +#define SCB_AIRCR_VECTCLRACTIVE_Msk (1UL << SCB_AIRCR_VECTCLRACTIVE_Pos) /*!< SCB AIRCR: VECTCLRACTIVE Mask */ + +#define SCB_AIRCR_VECTRESET_Pos 0 /*!< SCB AIRCR: VECTRESET Position */ +#define SCB_AIRCR_VECTRESET_Msk (1UL << SCB_AIRCR_VECTRESET_Pos) /*!< SCB AIRCR: VECTRESET Mask */ + +/* SCB System Control Register Definitions */ +#define SCB_SCR_SEVONPEND_Pos 4 /*!< SCB SCR: SEVONPEND Position */ +#define SCB_SCR_SEVONPEND_Msk (1UL << SCB_SCR_SEVONPEND_Pos) /*!< SCB SCR: SEVONPEND Mask */ + +#define SCB_SCR_SLEEPDEEP_Pos 2 /*!< SCB SCR: SLEEPDEEP Position */ +#define SCB_SCR_SLEEPDEEP_Msk (1UL << SCB_SCR_SLEEPDEEP_Pos) /*!< SCB SCR: SLEEPDEEP Mask */ + +#define SCB_SCR_SLEEPONEXIT_Pos 1 /*!< SCB SCR: SLEEPONEXIT Position */ +#define SCB_SCR_SLEEPONEXIT_Msk (1UL << SCB_SCR_SLEEPONEXIT_Pos) /*!< SCB SCR: SLEEPONEXIT Mask */ + +/* SCB Configuration Control Register Definitions */ +#define SCB_CCR_STKALIGN_Pos 9 /*!< SCB CCR: STKALIGN Position */ +#define SCB_CCR_STKALIGN_Msk (1UL << SCB_CCR_STKALIGN_Pos) /*!< SCB CCR: STKALIGN Mask */ + +#define SCB_CCR_BFHFNMIGN_Pos 8 /*!< SCB CCR: BFHFNMIGN Position */ +#define SCB_CCR_BFHFNMIGN_Msk (1UL << SCB_CCR_BFHFNMIGN_Pos) /*!< SCB CCR: BFHFNMIGN Mask */ + +#define SCB_CCR_DIV_0_TRP_Pos 4 /*!< SCB CCR: DIV_0_TRP Position */ +#define SCB_CCR_DIV_0_TRP_Msk (1UL << SCB_CCR_DIV_0_TRP_Pos) /*!< SCB CCR: DIV_0_TRP Mask */ + +#define SCB_CCR_UNALIGN_TRP_Pos 3 /*!< SCB CCR: UNALIGN_TRP Position */ +#define SCB_CCR_UNALIGN_TRP_Msk (1UL << SCB_CCR_UNALIGN_TRP_Pos) /*!< SCB CCR: UNALIGN_TRP Mask */ + +#define SCB_CCR_USERSETMPEND_Pos 1 /*!< SCB CCR: USERSETMPEND Position */ +#define SCB_CCR_USERSETMPEND_Msk (1UL << SCB_CCR_USERSETMPEND_Pos) /*!< SCB CCR: USERSETMPEND Mask */ + +#define SCB_CCR_NONBASETHRDENA_Pos 0 /*!< SCB CCR: NONBASETHRDENA Position */ +#define SCB_CCR_NONBASETHRDENA_Msk (1UL << SCB_CCR_NONBASETHRDENA_Pos) /*!< SCB CCR: NONBASETHRDENA Mask */ + +/* SCB System Handler Control and State Register Definitions */ +#define SCB_SHCSR_USGFAULTENA_Pos 18 /*!< SCB SHCSR: USGFAULTENA Position */ +#define SCB_SHCSR_USGFAULTENA_Msk (1UL << SCB_SHCSR_USGFAULTENA_Pos) /*!< SCB SHCSR: USGFAULTENA Mask */ + +#define SCB_SHCSR_BUSFAULTENA_Pos 17 /*!< SCB SHCSR: BUSFAULTENA Position */ +#define SCB_SHCSR_BUSFAULTENA_Msk (1UL << SCB_SHCSR_BUSFAULTENA_Pos) /*!< SCB SHCSR: BUSFAULTENA Mask */ + +#define SCB_SHCSR_MEMFAULTENA_Pos 16 /*!< SCB SHCSR: MEMFAULTENA Position */ +#define SCB_SHCSR_MEMFAULTENA_Msk (1UL << SCB_SHCSR_MEMFAULTENA_Pos) /*!< SCB SHCSR: MEMFAULTENA Mask */ + +#define SCB_SHCSR_SVCALLPENDED_Pos 15 /*!< SCB SHCSR: SVCALLPENDED Position */ +#define SCB_SHCSR_SVCALLPENDED_Msk (1UL << SCB_SHCSR_SVCALLPENDED_Pos) /*!< SCB SHCSR: SVCALLPENDED Mask */ + +#define SCB_SHCSR_BUSFAULTPENDED_Pos 14 /*!< SCB SHCSR: BUSFAULTPENDED Position */ +#define SCB_SHCSR_BUSFAULTPENDED_Msk (1UL << SCB_SHCSR_BUSFAULTPENDED_Pos) /*!< SCB SHCSR: BUSFAULTPENDED Mask */ + +#define SCB_SHCSR_MEMFAULTPENDED_Pos 13 /*!< SCB SHCSR: MEMFAULTPENDED Position */ +#define SCB_SHCSR_MEMFAULTPENDED_Msk (1UL << SCB_SHCSR_MEMFAULTPENDED_Pos) /*!< SCB SHCSR: MEMFAULTPENDED Mask */ + +#define SCB_SHCSR_USGFAULTPENDED_Pos 12 /*!< SCB SHCSR: USGFAULTPENDED Position */ +#define SCB_SHCSR_USGFAULTPENDED_Msk (1UL << SCB_SHCSR_USGFAULTPENDED_Pos) /*!< SCB SHCSR: USGFAULTPENDED Mask */ + +#define SCB_SHCSR_SYSTICKACT_Pos 11 /*!< SCB SHCSR: SYSTICKACT Position */ +#define SCB_SHCSR_SYSTICKACT_Msk (1UL << SCB_SHCSR_SYSTICKACT_Pos) /*!< SCB SHCSR: SYSTICKACT Mask */ + +#define SCB_SHCSR_PENDSVACT_Pos 10 /*!< SCB SHCSR: PENDSVACT Position */ +#define SCB_SHCSR_PENDSVACT_Msk (1UL << SCB_SHCSR_PENDSVACT_Pos) /*!< SCB SHCSR: PENDSVACT Mask */ + +#define SCB_SHCSR_MONITORACT_Pos 8 /*!< SCB SHCSR: MONITORACT Position */ +#define SCB_SHCSR_MONITORACT_Msk (1UL << SCB_SHCSR_MONITORACT_Pos) /*!< SCB SHCSR: MONITORACT Mask */ + +#define SCB_SHCSR_SVCALLACT_Pos 7 /*!< SCB SHCSR: SVCALLACT Position */ +#define SCB_SHCSR_SVCALLACT_Msk (1UL << SCB_SHCSR_SVCALLACT_Pos) /*!< SCB SHCSR: SVCALLACT Mask */ + +#define SCB_SHCSR_USGFAULTACT_Pos 3 /*!< SCB SHCSR: USGFAULTACT Position */ +#define SCB_SHCSR_USGFAULTACT_Msk (1UL << SCB_SHCSR_USGFAULTACT_Pos) /*!< SCB SHCSR: USGFAULTACT Mask */ + +#define SCB_SHCSR_BUSFAULTACT_Pos 1 /*!< SCB SHCSR: BUSFAULTACT Position */ +#define SCB_SHCSR_BUSFAULTACT_Msk (1UL << SCB_SHCSR_BUSFAULTACT_Pos) /*!< SCB SHCSR: BUSFAULTACT Mask */ + +#define SCB_SHCSR_MEMFAULTACT_Pos 0 /*!< SCB SHCSR: MEMFAULTACT Position */ +#define SCB_SHCSR_MEMFAULTACT_Msk (1UL << SCB_SHCSR_MEMFAULTACT_Pos) /*!< SCB SHCSR: MEMFAULTACT Mask */ + +/* SCB Configurable Fault Status Registers Definitions */ +#define SCB_CFSR_USGFAULTSR_Pos 16 /*!< SCB CFSR: Usage Fault Status Register Position */ +#define SCB_CFSR_USGFAULTSR_Msk (0xFFFFUL << SCB_CFSR_USGFAULTSR_Pos) /*!< SCB CFSR: Usage Fault Status Register Mask */ + +#define SCB_CFSR_BUSFAULTSR_Pos 8 /*!< SCB CFSR: Bus Fault Status Register Position */ +#define SCB_CFSR_BUSFAULTSR_Msk (0xFFUL << SCB_CFSR_BUSFAULTSR_Pos) /*!< SCB CFSR: Bus Fault Status Register Mask */ + +#define SCB_CFSR_MEMFAULTSR_Pos 0 /*!< SCB CFSR: Memory Manage Fault Status Register Position */ +#define SCB_CFSR_MEMFAULTSR_Msk (0xFFUL << SCB_CFSR_MEMFAULTSR_Pos) /*!< SCB CFSR: Memory Manage Fault Status Register Mask */ + +/* SCB Hard Fault Status Registers Definitions */ +#define SCB_HFSR_DEBUGEVT_Pos 31 /*!< SCB HFSR: DEBUGEVT Position */ +#define SCB_HFSR_DEBUGEVT_Msk (1UL << SCB_HFSR_DEBUGEVT_Pos) /*!< SCB HFSR: DEBUGEVT Mask */ + +#define SCB_HFSR_FORCED_Pos 30 /*!< SCB HFSR: FORCED Position */ +#define SCB_HFSR_FORCED_Msk (1UL << SCB_HFSR_FORCED_Pos) /*!< SCB HFSR: FORCED Mask */ + +#define SCB_HFSR_VECTTBL_Pos 1 /*!< SCB HFSR: VECTTBL Position */ +#define SCB_HFSR_VECTTBL_Msk (1UL << SCB_HFSR_VECTTBL_Pos) /*!< SCB HFSR: VECTTBL Mask */ + +/* SCB Debug Fault Status Register Definitions */ +#define SCB_DFSR_EXTERNAL_Pos 4 /*!< SCB DFSR: EXTERNAL Position */ +#define SCB_DFSR_EXTERNAL_Msk (1UL << SCB_DFSR_EXTERNAL_Pos) /*!< SCB DFSR: EXTERNAL Mask */ + +#define SCB_DFSR_VCATCH_Pos 3 /*!< SCB DFSR: VCATCH Position */ +#define SCB_DFSR_VCATCH_Msk (1UL << SCB_DFSR_VCATCH_Pos) /*!< SCB DFSR: VCATCH Mask */ + +#define SCB_DFSR_DWTTRAP_Pos 2 /*!< SCB DFSR: DWTTRAP Position */ +#define SCB_DFSR_DWTTRAP_Msk (1UL << SCB_DFSR_DWTTRAP_Pos) /*!< SCB DFSR: DWTTRAP Mask */ + +#define SCB_DFSR_BKPT_Pos 1 /*!< SCB DFSR: BKPT Position */ +#define SCB_DFSR_BKPT_Msk (1UL << SCB_DFSR_BKPT_Pos) /*!< SCB DFSR: BKPT Mask */ + +#define SCB_DFSR_HALTED_Pos 0 /*!< SCB DFSR: HALTED Position */ +#define SCB_DFSR_HALTED_Msk (1UL << SCB_DFSR_HALTED_Pos) /*!< SCB DFSR: HALTED Mask */ + +/*@} end of group CMSIS_SCB */ + + +/** \ingroup CMSIS_core_register + \defgroup CMSIS_SCnSCB System Controls not in SCB (SCnSCB) + \brief Type definitions for the System Control and ID Register not in the SCB + @{ + */ + +/** \brief Structure type to access the System Control and ID Register not in the SCB. + */ +typedef struct +{ + uint32_t RESERVED0[1]; + __I uint32_t ICTR; /*!< Offset: 0x004 (R/ ) Interrupt Controller Type Register */ + __IO uint32_t ACTLR; /*!< Offset: 0x008 (R/W) Auxiliary Control Register */ +} SCnSCB_Type; + +/* Interrupt Controller Type Register Definitions */ +#define SCnSCB_ICTR_INTLINESNUM_Pos 0 /*!< ICTR: INTLINESNUM Position */ +#define SCnSCB_ICTR_INTLINESNUM_Msk (0xFUL << SCnSCB_ICTR_INTLINESNUM_Pos) /*!< ICTR: INTLINESNUM Mask */ + +/* Auxiliary Control Register Definitions */ +#define SCnSCB_ACTLR_DISOOFP_Pos 9 /*!< ACTLR: DISOOFP Position */ +#define SCnSCB_ACTLR_DISOOFP_Msk (1UL << SCnSCB_ACTLR_DISOOFP_Pos) /*!< ACTLR: DISOOFP Mask */ + +#define SCnSCB_ACTLR_DISFPCA_Pos 8 /*!< ACTLR: DISFPCA Position */ +#define SCnSCB_ACTLR_DISFPCA_Msk (1UL << SCnSCB_ACTLR_DISFPCA_Pos) /*!< ACTLR: DISFPCA Mask */ + +#define SCnSCB_ACTLR_DISFOLD_Pos 2 /*!< ACTLR: DISFOLD Position */ +#define SCnSCB_ACTLR_DISFOLD_Msk (1UL << SCnSCB_ACTLR_DISFOLD_Pos) /*!< ACTLR: DISFOLD Mask */ + +#define SCnSCB_ACTLR_DISDEFWBUF_Pos 1 /*!< ACTLR: DISDEFWBUF Position */ +#define SCnSCB_ACTLR_DISDEFWBUF_Msk (1UL << SCnSCB_ACTLR_DISDEFWBUF_Pos) /*!< ACTLR: DISDEFWBUF Mask */ + +#define SCnSCB_ACTLR_DISMCYCINT_Pos 0 /*!< ACTLR: DISMCYCINT Position */ +#define SCnSCB_ACTLR_DISMCYCINT_Msk (1UL << SCnSCB_ACTLR_DISMCYCINT_Pos) /*!< ACTLR: DISMCYCINT Mask */ + +/*@} end of group CMSIS_SCnotSCB */ + + +/** \ingroup CMSIS_core_register + \defgroup CMSIS_SysTick System Tick Timer (SysTick) + \brief Type definitions for the System Timer Registers. + @{ + */ + +/** \brief Structure type to access the System Timer (SysTick). + */ +typedef struct +{ + __IO uint32_t CTRL; /*!< Offset: 0x000 (R/W) SysTick Control and Status Register */ + __IO uint32_t LOAD; /*!< Offset: 0x004 (R/W) SysTick Reload Value Register */ + __IO uint32_t VAL; /*!< Offset: 0x008 (R/W) SysTick Current Value Register */ + __I uint32_t CALIB; /*!< Offset: 0x00C (R/ ) SysTick Calibration Register */ +} SysTick_Type; + +/* SysTick Control / Status Register Definitions */ +#define SysTick_CTRL_COUNTFLAG_Pos 16 /*!< SysTick CTRL: COUNTFLAG Position */ +#define SysTick_CTRL_COUNTFLAG_Msk (1UL << SysTick_CTRL_COUNTFLAG_Pos) /*!< SysTick CTRL: COUNTFLAG Mask */ + +#define SysTick_CTRL_CLKSOURCE_Pos 2 /*!< SysTick CTRL: CLKSOURCE Position */ +#define SysTick_CTRL_CLKSOURCE_Msk (1UL << SysTick_CTRL_CLKSOURCE_Pos) /*!< SysTick CTRL: CLKSOURCE Mask */ + +#define SysTick_CTRL_TICKINT_Pos 1 /*!< SysTick CTRL: TICKINT Position */ +#define SysTick_CTRL_TICKINT_Msk (1UL << SysTick_CTRL_TICKINT_Pos) /*!< SysTick CTRL: TICKINT Mask */ + +#define SysTick_CTRL_ENABLE_Pos 0 /*!< SysTick CTRL: ENABLE Position */ +#define SysTick_CTRL_ENABLE_Msk (1UL << SysTick_CTRL_ENABLE_Pos) /*!< SysTick CTRL: ENABLE Mask */ + +/* SysTick Reload Register Definitions */ +#define SysTick_LOAD_RELOAD_Pos 0 /*!< SysTick LOAD: RELOAD Position */ +#define SysTick_LOAD_RELOAD_Msk (0xFFFFFFUL << SysTick_LOAD_RELOAD_Pos) /*!< SysTick LOAD: RELOAD Mask */ + +/* SysTick Current Register Definitions */ +#define SysTick_VAL_CURRENT_Pos 0 /*!< SysTick VAL: CURRENT Position */ +#define SysTick_VAL_CURRENT_Msk (0xFFFFFFUL << SysTick_VAL_CURRENT_Pos) /*!< SysTick VAL: CURRENT Mask */ + +/* SysTick Calibration Register Definitions */ +#define SysTick_CALIB_NOREF_Pos 31 /*!< SysTick CALIB: NOREF Position */ +#define SysTick_CALIB_NOREF_Msk (1UL << SysTick_CALIB_NOREF_Pos) /*!< SysTick CALIB: NOREF Mask */ + +#define SysTick_CALIB_SKEW_Pos 30 /*!< SysTick CALIB: SKEW Position */ +#define SysTick_CALIB_SKEW_Msk (1UL << SysTick_CALIB_SKEW_Pos) /*!< SysTick CALIB: SKEW Mask */ + +#define SysTick_CALIB_TENMS_Pos 0 /*!< SysTick CALIB: TENMS Position */ +#define SysTick_CALIB_TENMS_Msk (0xFFFFFFUL << SysTick_VAL_CURRENT_Pos) /*!< SysTick CALIB: TENMS Mask */ + +/*@} end of group CMSIS_SysTick */ + + +/** \ingroup CMSIS_core_register + \defgroup CMSIS_ITM Instrumentation Trace Macrocell (ITM) + \brief Type definitions for the Instrumentation Trace Macrocell (ITM) + @{ + */ + +/** \brief Structure type to access the Instrumentation Trace Macrocell Register (ITM). + */ +typedef struct +{ + __O union + { + __O uint8_t u8; /*!< Offset: 0x000 ( /W) ITM Stimulus Port 8-bit */ + __O uint16_t u16; /*!< Offset: 0x000 ( /W) ITM Stimulus Port 16-bit */ + __O uint32_t u32; /*!< Offset: 0x000 ( /W) ITM Stimulus Port 32-bit */ + } PORT [32]; /*!< Offset: 0x000 ( /W) ITM Stimulus Port Registers */ + uint32_t RESERVED0[864]; + __IO uint32_t TER; /*!< Offset: 0xE00 (R/W) ITM Trace Enable Register */ + uint32_t RESERVED1[15]; + __IO uint32_t TPR; /*!< Offset: 0xE40 (R/W) ITM Trace Privilege Register */ + uint32_t RESERVED2[15]; + __IO uint32_t TCR; /*!< Offset: 0xE80 (R/W) ITM Trace Control Register */ + uint32_t RESERVED3[29]; + __O uint32_t IWR; /*!< Offset: 0xEF8 ( /W) ITM Integration Write Register */ + __I uint32_t IRR; /*!< Offset: 0xEFC (R/ ) ITM Integration Read Register */ + __IO uint32_t IMCR; /*!< Offset: 0xF00 (R/W) ITM Integration Mode Control Register */ + uint32_t RESERVED4[43]; + __O uint32_t LAR; /*!< Offset: 0xFB0 ( /W) ITM Lock Access Register */ + __I uint32_t LSR; /*!< Offset: 0xFB4 (R/ ) ITM Lock Status Register */ + uint32_t RESERVED5[6]; + __I uint32_t PID4; /*!< Offset: 0xFD0 (R/ ) ITM Peripheral Identification Register #4 */ + __I uint32_t PID5; /*!< Offset: 0xFD4 (R/ ) ITM Peripheral Identification Register #5 */ + __I uint32_t PID6; /*!< Offset: 0xFD8 (R/ ) ITM Peripheral Identification Register #6 */ + __I uint32_t PID7; /*!< Offset: 0xFDC (R/ ) ITM Peripheral Identification Register #7 */ + __I uint32_t PID0; /*!< Offset: 0xFE0 (R/ ) ITM Peripheral Identification Register #0 */ + __I uint32_t PID1; /*!< Offset: 0xFE4 (R/ ) ITM Peripheral Identification Register #1 */ + __I uint32_t PID2; /*!< Offset: 0xFE8 (R/ ) ITM Peripheral Identification Register #2 */ + __I uint32_t PID3; /*!< Offset: 0xFEC (R/ ) ITM Peripheral Identification Register #3 */ + __I uint32_t CID0; /*!< Offset: 0xFF0 (R/ ) ITM Component Identification Register #0 */ + __I uint32_t CID1; /*!< Offset: 0xFF4 (R/ ) ITM Component Identification Register #1 */ + __I uint32_t CID2; /*!< Offset: 0xFF8 (R/ ) ITM Component Identification Register #2 */ + __I uint32_t CID3; /*!< Offset: 0xFFC (R/ ) ITM Component Identification Register #3 */ +} ITM_Type; + +/* ITM Trace Privilege Register Definitions */ +#define ITM_TPR_PRIVMASK_Pos 0 /*!< ITM TPR: PRIVMASK Position */ +#define ITM_TPR_PRIVMASK_Msk (0xFUL << ITM_TPR_PRIVMASK_Pos) /*!< ITM TPR: PRIVMASK Mask */ + +/* ITM Trace Control Register Definitions */ +#define ITM_TCR_BUSY_Pos 23 /*!< ITM TCR: BUSY Position */ +#define ITM_TCR_BUSY_Msk (1UL << ITM_TCR_BUSY_Pos) /*!< ITM TCR: BUSY Mask */ + +#define ITM_TCR_TraceBusID_Pos 16 /*!< ITM TCR: ATBID Position */ +#define ITM_TCR_TraceBusID_Msk (0x7FUL << ITM_TCR_TraceBusID_Pos) /*!< ITM TCR: ATBID Mask */ + +#define ITM_TCR_GTSFREQ_Pos 10 /*!< ITM TCR: Global timestamp frequency Position */ +#define ITM_TCR_GTSFREQ_Msk (3UL << ITM_TCR_GTSFREQ_Pos) /*!< ITM TCR: Global timestamp frequency Mask */ + +#define ITM_TCR_TSPrescale_Pos 8 /*!< ITM TCR: TSPrescale Position */ +#define ITM_TCR_TSPrescale_Msk (3UL << ITM_TCR_TSPrescale_Pos) /*!< ITM TCR: TSPrescale Mask */ + +#define ITM_TCR_SWOENA_Pos 4 /*!< ITM TCR: SWOENA Position */ +#define ITM_TCR_SWOENA_Msk (1UL << ITM_TCR_SWOENA_Pos) /*!< ITM TCR: SWOENA Mask */ + +#define ITM_TCR_DWTENA_Pos 3 /*!< ITM TCR: DWTENA Position */ +#define ITM_TCR_DWTENA_Msk (1UL << ITM_TCR_DWTENA_Pos) /*!< ITM TCR: DWTENA Mask */ + +#define ITM_TCR_SYNCENA_Pos 2 /*!< ITM TCR: SYNCENA Position */ +#define ITM_TCR_SYNCENA_Msk (1UL << ITM_TCR_SYNCENA_Pos) /*!< ITM TCR: SYNCENA Mask */ + +#define ITM_TCR_TSENA_Pos 1 /*!< ITM TCR: TSENA Position */ +#define ITM_TCR_TSENA_Msk (1UL << ITM_TCR_TSENA_Pos) /*!< ITM TCR: TSENA Mask */ + +#define ITM_TCR_ITMENA_Pos 0 /*!< ITM TCR: ITM Enable bit Position */ +#define ITM_TCR_ITMENA_Msk (1UL << ITM_TCR_ITMENA_Pos) /*!< ITM TCR: ITM Enable bit Mask */ + +/* ITM Integration Write Register Definitions */ +#define ITM_IWR_ATVALIDM_Pos 0 /*!< ITM IWR: ATVALIDM Position */ +#define ITM_IWR_ATVALIDM_Msk (1UL << ITM_IWR_ATVALIDM_Pos) /*!< ITM IWR: ATVALIDM Mask */ + +/* ITM Integration Read Register Definitions */ +#define ITM_IRR_ATREADYM_Pos 0 /*!< ITM IRR: ATREADYM Position */ +#define ITM_IRR_ATREADYM_Msk (1UL << ITM_IRR_ATREADYM_Pos) /*!< ITM IRR: ATREADYM Mask */ + +/* ITM Integration Mode Control Register Definitions */ +#define ITM_IMCR_INTEGRATION_Pos 0 /*!< ITM IMCR: INTEGRATION Position */ +#define ITM_IMCR_INTEGRATION_Msk (1UL << ITM_IMCR_INTEGRATION_Pos) /*!< ITM IMCR: INTEGRATION Mask */ + +/* ITM Lock Status Register Definitions */ +#define ITM_LSR_ByteAcc_Pos 2 /*!< ITM LSR: ByteAcc Position */ +#define ITM_LSR_ByteAcc_Msk (1UL << ITM_LSR_ByteAcc_Pos) /*!< ITM LSR: ByteAcc Mask */ + +#define ITM_LSR_Access_Pos 1 /*!< ITM LSR: Access Position */ +#define ITM_LSR_Access_Msk (1UL << ITM_LSR_Access_Pos) /*!< ITM LSR: Access Mask */ + +#define ITM_LSR_Present_Pos 0 /*!< ITM LSR: Present Position */ +#define ITM_LSR_Present_Msk (1UL << ITM_LSR_Present_Pos) /*!< ITM LSR: Present Mask */ + +/*@}*/ /* end of group CMSIS_ITM */ + + +/** \ingroup CMSIS_core_register + \defgroup CMSIS_DWT Data Watchpoint and Trace (DWT) + \brief Type definitions for the Data Watchpoint and Trace (DWT) + @{ + */ + +/** \brief Structure type to access the Data Watchpoint and Trace Register (DWT). + */ +typedef struct +{ + __IO uint32_t CTRL; /*!< Offset: 0x000 (R/W) Control Register */ + __IO uint32_t CYCCNT; /*!< Offset: 0x004 (R/W) Cycle Count Register */ + __IO uint32_t CPICNT; /*!< Offset: 0x008 (R/W) CPI Count Register */ + __IO uint32_t EXCCNT; /*!< Offset: 0x00C (R/W) Exception Overhead Count Register */ + __IO uint32_t SLEEPCNT; /*!< Offset: 0x010 (R/W) Sleep Count Register */ + __IO uint32_t LSUCNT; /*!< Offset: 0x014 (R/W) LSU Count Register */ + __IO uint32_t FOLDCNT; /*!< Offset: 0x018 (R/W) Folded-instruction Count Register */ + __I uint32_t PCSR; /*!< Offset: 0x01C (R/ ) Program Counter Sample Register */ + __IO uint32_t COMP0; /*!< Offset: 0x020 (R/W) Comparator Register 0 */ + __IO uint32_t MASK0; /*!< Offset: 0x024 (R/W) Mask Register 0 */ + __IO uint32_t FUNCTION0; /*!< Offset: 0x028 (R/W) Function Register 0 */ + uint32_t RESERVED0[1]; + __IO uint32_t COMP1; /*!< Offset: 0x030 (R/W) Comparator Register 1 */ + __IO uint32_t MASK1; /*!< Offset: 0x034 (R/W) Mask Register 1 */ + __IO uint32_t FUNCTION1; /*!< Offset: 0x038 (R/W) Function Register 1 */ + uint32_t RESERVED1[1]; + __IO uint32_t COMP2; /*!< Offset: 0x040 (R/W) Comparator Register 2 */ + __IO uint32_t MASK2; /*!< Offset: 0x044 (R/W) Mask Register 2 */ + __IO uint32_t FUNCTION2; /*!< Offset: 0x048 (R/W) Function Register 2 */ + uint32_t RESERVED2[1]; + __IO uint32_t COMP3; /*!< Offset: 0x050 (R/W) Comparator Register 3 */ + __IO uint32_t MASK3; /*!< Offset: 0x054 (R/W) Mask Register 3 */ + __IO uint32_t FUNCTION3; /*!< Offset: 0x058 (R/W) Function Register 3 */ +} DWT_Type; + +/* DWT Control Register Definitions */ +#define DWT_CTRL_NUMCOMP_Pos 28 /*!< DWT CTRL: NUMCOMP Position */ +#define DWT_CTRL_NUMCOMP_Msk (0xFUL << DWT_CTRL_NUMCOMP_Pos) /*!< DWT CTRL: NUMCOMP Mask */ + +#define DWT_CTRL_NOTRCPKT_Pos 27 /*!< DWT CTRL: NOTRCPKT Position */ +#define DWT_CTRL_NOTRCPKT_Msk (0x1UL << DWT_CTRL_NOTRCPKT_Pos) /*!< DWT CTRL: NOTRCPKT Mask */ + +#define DWT_CTRL_NOEXTTRIG_Pos 26 /*!< DWT CTRL: NOEXTTRIG Position */ +#define DWT_CTRL_NOEXTTRIG_Msk (0x1UL << DWT_CTRL_NOEXTTRIG_Pos) /*!< DWT CTRL: NOEXTTRIG Mask */ + +#define DWT_CTRL_NOCYCCNT_Pos 25 /*!< DWT CTRL: NOCYCCNT Position */ +#define DWT_CTRL_NOCYCCNT_Msk (0x1UL << DWT_CTRL_NOCYCCNT_Pos) /*!< DWT CTRL: NOCYCCNT Mask */ + +#define DWT_CTRL_NOPRFCNT_Pos 24 /*!< DWT CTRL: NOPRFCNT Position */ +#define DWT_CTRL_NOPRFCNT_Msk (0x1UL << DWT_CTRL_NOPRFCNT_Pos) /*!< DWT CTRL: NOPRFCNT Mask */ + +#define DWT_CTRL_CYCEVTENA_Pos 22 /*!< DWT CTRL: CYCEVTENA Position */ +#define DWT_CTRL_CYCEVTENA_Msk (0x1UL << DWT_CTRL_CYCEVTENA_Pos) /*!< DWT CTRL: CYCEVTENA Mask */ + +#define DWT_CTRL_FOLDEVTENA_Pos 21 /*!< DWT CTRL: FOLDEVTENA Position */ +#define DWT_CTRL_FOLDEVTENA_Msk (0x1UL << DWT_CTRL_FOLDEVTENA_Pos) /*!< DWT CTRL: FOLDEVTENA Mask */ + +#define DWT_CTRL_LSUEVTENA_Pos 20 /*!< DWT CTRL: LSUEVTENA Position */ +#define DWT_CTRL_LSUEVTENA_Msk (0x1UL << DWT_CTRL_LSUEVTENA_Pos) /*!< DWT CTRL: LSUEVTENA Mask */ + +#define DWT_CTRL_SLEEPEVTENA_Pos 19 /*!< DWT CTRL: SLEEPEVTENA Position */ +#define DWT_CTRL_SLEEPEVTENA_Msk (0x1UL << DWT_CTRL_SLEEPEVTENA_Pos) /*!< DWT CTRL: SLEEPEVTENA Mask */ + +#define DWT_CTRL_EXCEVTENA_Pos 18 /*!< DWT CTRL: EXCEVTENA Position */ +#define DWT_CTRL_EXCEVTENA_Msk (0x1UL << DWT_CTRL_EXCEVTENA_Pos) /*!< DWT CTRL: EXCEVTENA Mask */ + +#define DWT_CTRL_CPIEVTENA_Pos 17 /*!< DWT CTRL: CPIEVTENA Position */ +#define DWT_CTRL_CPIEVTENA_Msk (0x1UL << DWT_CTRL_CPIEVTENA_Pos) /*!< DWT CTRL: CPIEVTENA Mask */ + +#define DWT_CTRL_EXCTRCENA_Pos 16 /*!< DWT CTRL: EXCTRCENA Position */ +#define DWT_CTRL_EXCTRCENA_Msk (0x1UL << DWT_CTRL_EXCTRCENA_Pos) /*!< DWT CTRL: EXCTRCENA Mask */ + +#define DWT_CTRL_PCSAMPLENA_Pos 12 /*!< DWT CTRL: PCSAMPLENA Position */ +#define DWT_CTRL_PCSAMPLENA_Msk (0x1UL << DWT_CTRL_PCSAMPLENA_Pos) /*!< DWT CTRL: PCSAMPLENA Mask */ + +#define DWT_CTRL_SYNCTAP_Pos 10 /*!< DWT CTRL: SYNCTAP Position */ +#define DWT_CTRL_SYNCTAP_Msk (0x3UL << DWT_CTRL_SYNCTAP_Pos) /*!< DWT CTRL: SYNCTAP Mask */ + +#define DWT_CTRL_CYCTAP_Pos 9 /*!< DWT CTRL: CYCTAP Position */ +#define DWT_CTRL_CYCTAP_Msk (0x1UL << DWT_CTRL_CYCTAP_Pos) /*!< DWT CTRL: CYCTAP Mask */ + +#define DWT_CTRL_POSTINIT_Pos 5 /*!< DWT CTRL: POSTINIT Position */ +#define DWT_CTRL_POSTINIT_Msk (0xFUL << DWT_CTRL_POSTINIT_Pos) /*!< DWT CTRL: POSTINIT Mask */ + +#define DWT_CTRL_POSTPRESET_Pos 1 /*!< DWT CTRL: POSTPRESET Position */ +#define DWT_CTRL_POSTPRESET_Msk (0xFUL << DWT_CTRL_POSTPRESET_Pos) /*!< DWT CTRL: POSTPRESET Mask */ + +#define DWT_CTRL_CYCCNTENA_Pos 0 /*!< DWT CTRL: CYCCNTENA Position */ +#define DWT_CTRL_CYCCNTENA_Msk (0x1UL << DWT_CTRL_CYCCNTENA_Pos) /*!< DWT CTRL: CYCCNTENA Mask */ + +/* DWT CPI Count Register Definitions */ +#define DWT_CPICNT_CPICNT_Pos 0 /*!< DWT CPICNT: CPICNT Position */ +#define DWT_CPICNT_CPICNT_Msk (0xFFUL << DWT_CPICNT_CPICNT_Pos) /*!< DWT CPICNT: CPICNT Mask */ + +/* DWT Exception Overhead Count Register Definitions */ +#define DWT_EXCCNT_EXCCNT_Pos 0 /*!< DWT EXCCNT: EXCCNT Position */ +#define DWT_EXCCNT_EXCCNT_Msk (0xFFUL << DWT_EXCCNT_EXCCNT_Pos) /*!< DWT EXCCNT: EXCCNT Mask */ + +/* DWT Sleep Count Register Definitions */ +#define DWT_SLEEPCNT_SLEEPCNT_Pos 0 /*!< DWT SLEEPCNT: SLEEPCNT Position */ +#define DWT_SLEEPCNT_SLEEPCNT_Msk (0xFFUL << DWT_SLEEPCNT_SLEEPCNT_Pos) /*!< DWT SLEEPCNT: SLEEPCNT Mask */ + +/* DWT LSU Count Register Definitions */ +#define DWT_LSUCNT_LSUCNT_Pos 0 /*!< DWT LSUCNT: LSUCNT Position */ +#define DWT_LSUCNT_LSUCNT_Msk (0xFFUL << DWT_LSUCNT_LSUCNT_Pos) /*!< DWT LSUCNT: LSUCNT Mask */ + +/* DWT Folded-instruction Count Register Definitions */ +#define DWT_FOLDCNT_FOLDCNT_Pos 0 /*!< DWT FOLDCNT: FOLDCNT Position */ +#define DWT_FOLDCNT_FOLDCNT_Msk (0xFFUL << DWT_FOLDCNT_FOLDCNT_Pos) /*!< DWT FOLDCNT: FOLDCNT Mask */ + +/* DWT Comparator Mask Register Definitions */ +#define DWT_MASK_MASK_Pos 0 /*!< DWT MASK: MASK Position */ +#define DWT_MASK_MASK_Msk (0x1FUL << DWT_MASK_MASK_Pos) /*!< DWT MASK: MASK Mask */ + +/* DWT Comparator Function Register Definitions */ +#define DWT_FUNCTION_MATCHED_Pos 24 /*!< DWT FUNCTION: MATCHED Position */ +#define DWT_FUNCTION_MATCHED_Msk (0x1UL << DWT_FUNCTION_MATCHED_Pos) /*!< DWT FUNCTION: MATCHED Mask */ + +#define DWT_FUNCTION_DATAVADDR1_Pos 16 /*!< DWT FUNCTION: DATAVADDR1 Position */ +#define DWT_FUNCTION_DATAVADDR1_Msk (0xFUL << DWT_FUNCTION_DATAVADDR1_Pos) /*!< DWT FUNCTION: DATAVADDR1 Mask */ + +#define DWT_FUNCTION_DATAVADDR0_Pos 12 /*!< DWT FUNCTION: DATAVADDR0 Position */ +#define DWT_FUNCTION_DATAVADDR0_Msk (0xFUL << DWT_FUNCTION_DATAVADDR0_Pos) /*!< DWT FUNCTION: DATAVADDR0 Mask */ + +#define DWT_FUNCTION_DATAVSIZE_Pos 10 /*!< DWT FUNCTION: DATAVSIZE Position */ +#define DWT_FUNCTION_DATAVSIZE_Msk (0x3UL << DWT_FUNCTION_DATAVSIZE_Pos) /*!< DWT FUNCTION: DATAVSIZE Mask */ + +#define DWT_FUNCTION_LNK1ENA_Pos 9 /*!< DWT FUNCTION: LNK1ENA Position */ +#define DWT_FUNCTION_LNK1ENA_Msk (0x1UL << DWT_FUNCTION_LNK1ENA_Pos) /*!< DWT FUNCTION: LNK1ENA Mask */ + +#define DWT_FUNCTION_DATAVMATCH_Pos 8 /*!< DWT FUNCTION: DATAVMATCH Position */ +#define DWT_FUNCTION_DATAVMATCH_Msk (0x1UL << DWT_FUNCTION_DATAVMATCH_Pos) /*!< DWT FUNCTION: DATAVMATCH Mask */ + +#define DWT_FUNCTION_CYCMATCH_Pos 7 /*!< DWT FUNCTION: CYCMATCH Position */ +#define DWT_FUNCTION_CYCMATCH_Msk (0x1UL << DWT_FUNCTION_CYCMATCH_Pos) /*!< DWT FUNCTION: CYCMATCH Mask */ + +#define DWT_FUNCTION_EMITRANGE_Pos 5 /*!< DWT FUNCTION: EMITRANGE Position */ +#define DWT_FUNCTION_EMITRANGE_Msk (0x1UL << DWT_FUNCTION_EMITRANGE_Pos) /*!< DWT FUNCTION: EMITRANGE Mask */ + +#define DWT_FUNCTION_FUNCTION_Pos 0 /*!< DWT FUNCTION: FUNCTION Position */ +#define DWT_FUNCTION_FUNCTION_Msk (0xFUL << DWT_FUNCTION_FUNCTION_Pos) /*!< DWT FUNCTION: FUNCTION Mask */ + +/*@}*/ /* end of group CMSIS_DWT */ + + +/** \ingroup CMSIS_core_register + \defgroup CMSIS_TPI Trace Port Interface (TPI) + \brief Type definitions for the Trace Port Interface (TPI) + @{ + */ + +/** \brief Structure type to access the Trace Port Interface Register (TPI). + */ +typedef struct +{ + __IO uint32_t SSPSR; /*!< Offset: 0x000 (R/ ) Supported Parallel Port Size Register */ + __IO uint32_t CSPSR; /*!< Offset: 0x004 (R/W) Current Parallel Port Size Register */ + uint32_t RESERVED0[2]; + __IO uint32_t ACPR; /*!< Offset: 0x010 (R/W) Asynchronous Clock Prescaler Register */ + uint32_t RESERVED1[55]; + __IO uint32_t SPPR; /*!< Offset: 0x0F0 (R/W) Selected Pin Protocol Register */ + uint32_t RESERVED2[131]; + __I uint32_t FFSR; /*!< Offset: 0x300 (R/ ) Formatter and Flush Status Register */ + __IO uint32_t FFCR; /*!< Offset: 0x304 (R/W) Formatter and Flush Control Register */ + __I uint32_t FSCR; /*!< Offset: 0x308 (R/ ) Formatter Synchronization Counter Register */ + uint32_t RESERVED3[759]; + __I uint32_t TRIGGER; /*!< Offset: 0xEE8 (R/ ) TRIGGER */ + __I uint32_t FIFO0; /*!< Offset: 0xEEC (R/ ) Integration ETM Data */ + __I uint32_t ITATBCTR2; /*!< Offset: 0xEF0 (R/ ) ITATBCTR2 */ + uint32_t RESERVED4[1]; + __I uint32_t ITATBCTR0; /*!< Offset: 0xEF8 (R/ ) ITATBCTR0 */ + __I uint32_t FIFO1; /*!< Offset: 0xEFC (R/ ) Integration ITM Data */ + __IO uint32_t ITCTRL; /*!< Offset: 0xF00 (R/W) Integration Mode Control */ + uint32_t RESERVED5[39]; + __IO uint32_t CLAIMSET; /*!< Offset: 0xFA0 (R/W) Claim tag set */ + __IO uint32_t CLAIMCLR; /*!< Offset: 0xFA4 (R/W) Claim tag clear */ + uint32_t RESERVED7[8]; + __I uint32_t DEVID; /*!< Offset: 0xFC8 (R/ ) TPIU_DEVID */ + __I uint32_t DEVTYPE; /*!< Offset: 0xFCC (R/ ) TPIU_DEVTYPE */ +} TPI_Type; + +/* TPI Asynchronous Clock Prescaler Register Definitions */ +#define TPI_ACPR_PRESCALER_Pos 0 /*!< TPI ACPR: PRESCALER Position */ +#define TPI_ACPR_PRESCALER_Msk (0x1FFFUL << TPI_ACPR_PRESCALER_Pos) /*!< TPI ACPR: PRESCALER Mask */ + +/* TPI Selected Pin Protocol Register Definitions */ +#define TPI_SPPR_TXMODE_Pos 0 /*!< TPI SPPR: TXMODE Position */ +#define TPI_SPPR_TXMODE_Msk (0x3UL << TPI_SPPR_TXMODE_Pos) /*!< TPI SPPR: TXMODE Mask */ + +/* TPI Formatter and Flush Status Register Definitions */ +#define TPI_FFSR_FtNonStop_Pos 3 /*!< TPI FFSR: FtNonStop Position */ +#define TPI_FFSR_FtNonStop_Msk (0x1UL << TPI_FFSR_FtNonStop_Pos) /*!< TPI FFSR: FtNonStop Mask */ + +#define TPI_FFSR_TCPresent_Pos 2 /*!< TPI FFSR: TCPresent Position */ +#define TPI_FFSR_TCPresent_Msk (0x1UL << TPI_FFSR_TCPresent_Pos) /*!< TPI FFSR: TCPresent Mask */ + +#define TPI_FFSR_FtStopped_Pos 1 /*!< TPI FFSR: FtStopped Position */ +#define TPI_FFSR_FtStopped_Msk (0x1UL << TPI_FFSR_FtStopped_Pos) /*!< TPI FFSR: FtStopped Mask */ + +#define TPI_FFSR_FlInProg_Pos 0 /*!< TPI FFSR: FlInProg Position */ +#define TPI_FFSR_FlInProg_Msk (0x1UL << TPI_FFSR_FlInProg_Pos) /*!< TPI FFSR: FlInProg Mask */ + +/* TPI Formatter and Flush Control Register Definitions */ +#define TPI_FFCR_TrigIn_Pos 8 /*!< TPI FFCR: TrigIn Position */ +#define TPI_FFCR_TrigIn_Msk (0x1UL << TPI_FFCR_TrigIn_Pos) /*!< TPI FFCR: TrigIn Mask */ + +#define TPI_FFCR_EnFCont_Pos 1 /*!< TPI FFCR: EnFCont Position */ +#define TPI_FFCR_EnFCont_Msk (0x1UL << TPI_FFCR_EnFCont_Pos) /*!< TPI FFCR: EnFCont Mask */ + +/* TPI TRIGGER Register Definitions */ +#define TPI_TRIGGER_TRIGGER_Pos 0 /*!< TPI TRIGGER: TRIGGER Position */ +#define TPI_TRIGGER_TRIGGER_Msk (0x1UL << TPI_TRIGGER_TRIGGER_Pos) /*!< TPI TRIGGER: TRIGGER Mask */ + +/* TPI Integration ETM Data Register Definitions (FIFO0) */ +#define TPI_FIFO0_ITM_ATVALID_Pos 29 /*!< TPI FIFO0: ITM_ATVALID Position */ +#define TPI_FIFO0_ITM_ATVALID_Msk (0x3UL << TPI_FIFO0_ITM_ATVALID_Pos) /*!< TPI FIFO0: ITM_ATVALID Mask */ + +#define TPI_FIFO0_ITM_bytecount_Pos 27 /*!< TPI FIFO0: ITM_bytecount Position */ +#define TPI_FIFO0_ITM_bytecount_Msk (0x3UL << TPI_FIFO0_ITM_bytecount_Pos) /*!< TPI FIFO0: ITM_bytecount Mask */ + +#define TPI_FIFO0_ETM_ATVALID_Pos 26 /*!< TPI FIFO0: ETM_ATVALID Position */ +#define TPI_FIFO0_ETM_ATVALID_Msk (0x3UL << TPI_FIFO0_ETM_ATVALID_Pos) /*!< TPI FIFO0: ETM_ATVALID Mask */ + +#define TPI_FIFO0_ETM_bytecount_Pos 24 /*!< TPI FIFO0: ETM_bytecount Position */ +#define TPI_FIFO0_ETM_bytecount_Msk (0x3UL << TPI_FIFO0_ETM_bytecount_Pos) /*!< TPI FIFO0: ETM_bytecount Mask */ + +#define TPI_FIFO0_ETM2_Pos 16 /*!< TPI FIFO0: ETM2 Position */ +#define TPI_FIFO0_ETM2_Msk (0xFFUL << TPI_FIFO0_ETM2_Pos) /*!< TPI FIFO0: ETM2 Mask */ + +#define TPI_FIFO0_ETM1_Pos 8 /*!< TPI FIFO0: ETM1 Position */ +#define TPI_FIFO0_ETM1_Msk (0xFFUL << TPI_FIFO0_ETM1_Pos) /*!< TPI FIFO0: ETM1 Mask */ + +#define TPI_FIFO0_ETM0_Pos 0 /*!< TPI FIFO0: ETM0 Position */ +#define TPI_FIFO0_ETM0_Msk (0xFFUL << TPI_FIFO0_ETM0_Pos) /*!< TPI FIFO0: ETM0 Mask */ + +/* TPI ITATBCTR2 Register Definitions */ +#define TPI_ITATBCTR2_ATREADY_Pos 0 /*!< TPI ITATBCTR2: ATREADY Position */ +#define TPI_ITATBCTR2_ATREADY_Msk (0x1UL << TPI_ITATBCTR2_ATREADY_Pos) /*!< TPI ITATBCTR2: ATREADY Mask */ + +/* TPI Integration ITM Data Register Definitions (FIFO1) */ +#define TPI_FIFO1_ITM_ATVALID_Pos 29 /*!< TPI FIFO1: ITM_ATVALID Position */ +#define TPI_FIFO1_ITM_ATVALID_Msk (0x3UL << TPI_FIFO1_ITM_ATVALID_Pos) /*!< TPI FIFO1: ITM_ATVALID Mask */ + +#define TPI_FIFO1_ITM_bytecount_Pos 27 /*!< TPI FIFO1: ITM_bytecount Position */ +#define TPI_FIFO1_ITM_bytecount_Msk (0x3UL << TPI_FIFO1_ITM_bytecount_Pos) /*!< TPI FIFO1: ITM_bytecount Mask */ + +#define TPI_FIFO1_ETM_ATVALID_Pos 26 /*!< TPI FIFO1: ETM_ATVALID Position */ +#define TPI_FIFO1_ETM_ATVALID_Msk (0x3UL << TPI_FIFO1_ETM_ATVALID_Pos) /*!< TPI FIFO1: ETM_ATVALID Mask */ + +#define TPI_FIFO1_ETM_bytecount_Pos 24 /*!< TPI FIFO1: ETM_bytecount Position */ +#define TPI_FIFO1_ETM_bytecount_Msk (0x3UL << TPI_FIFO1_ETM_bytecount_Pos) /*!< TPI FIFO1: ETM_bytecount Mask */ + +#define TPI_FIFO1_ITM2_Pos 16 /*!< TPI FIFO1: ITM2 Position */ +#define TPI_FIFO1_ITM2_Msk (0xFFUL << TPI_FIFO1_ITM2_Pos) /*!< TPI FIFO1: ITM2 Mask */ + +#define TPI_FIFO1_ITM1_Pos 8 /*!< TPI FIFO1: ITM1 Position */ +#define TPI_FIFO1_ITM1_Msk (0xFFUL << TPI_FIFO1_ITM1_Pos) /*!< TPI FIFO1: ITM1 Mask */ + +#define TPI_FIFO1_ITM0_Pos 0 /*!< TPI FIFO1: ITM0 Position */ +#define TPI_FIFO1_ITM0_Msk (0xFFUL << TPI_FIFO1_ITM0_Pos) /*!< TPI FIFO1: ITM0 Mask */ + +/* TPI ITATBCTR0 Register Definitions */ +#define TPI_ITATBCTR0_ATREADY_Pos 0 /*!< TPI ITATBCTR0: ATREADY Position */ +#define TPI_ITATBCTR0_ATREADY_Msk (0x1UL << TPI_ITATBCTR0_ATREADY_Pos) /*!< TPI ITATBCTR0: ATREADY Mask */ + +/* TPI Integration Mode Control Register Definitions */ +#define TPI_ITCTRL_Mode_Pos 0 /*!< TPI ITCTRL: Mode Position */ +#define TPI_ITCTRL_Mode_Msk (0x1UL << TPI_ITCTRL_Mode_Pos) /*!< TPI ITCTRL: Mode Mask */ + +/* TPI DEVID Register Definitions */ +#define TPI_DEVID_NRZVALID_Pos 11 /*!< TPI DEVID: NRZVALID Position */ +#define TPI_DEVID_NRZVALID_Msk (0x1UL << TPI_DEVID_NRZVALID_Pos) /*!< TPI DEVID: NRZVALID Mask */ + +#define TPI_DEVID_MANCVALID_Pos 10 /*!< TPI DEVID: MANCVALID Position */ +#define TPI_DEVID_MANCVALID_Msk (0x1UL << TPI_DEVID_MANCVALID_Pos) /*!< TPI DEVID: MANCVALID Mask */ + +#define TPI_DEVID_PTINVALID_Pos 9 /*!< TPI DEVID: PTINVALID Position */ +#define TPI_DEVID_PTINVALID_Msk (0x1UL << TPI_DEVID_PTINVALID_Pos) /*!< TPI DEVID: PTINVALID Mask */ + +#define TPI_DEVID_MinBufSz_Pos 6 /*!< TPI DEVID: MinBufSz Position */ +#define TPI_DEVID_MinBufSz_Msk (0x7UL << TPI_DEVID_MinBufSz_Pos) /*!< TPI DEVID: MinBufSz Mask */ + +#define TPI_DEVID_AsynClkIn_Pos 5 /*!< TPI DEVID: AsynClkIn Position */ +#define TPI_DEVID_AsynClkIn_Msk (0x1UL << TPI_DEVID_AsynClkIn_Pos) /*!< TPI DEVID: AsynClkIn Mask */ + +#define TPI_DEVID_NrTraceInput_Pos 0 /*!< TPI DEVID: NrTraceInput Position */ +#define TPI_DEVID_NrTraceInput_Msk (0x1FUL << TPI_DEVID_NrTraceInput_Pos) /*!< TPI DEVID: NrTraceInput Mask */ + +/* TPI DEVTYPE Register Definitions */ +#define TPI_DEVTYPE_SubType_Pos 0 /*!< TPI DEVTYPE: SubType Position */ +#define TPI_DEVTYPE_SubType_Msk (0xFUL << TPI_DEVTYPE_SubType_Pos) /*!< TPI DEVTYPE: SubType Mask */ + +#define TPI_DEVTYPE_MajorType_Pos 4 /*!< TPI DEVTYPE: MajorType Position */ +#define TPI_DEVTYPE_MajorType_Msk (0xFUL << TPI_DEVTYPE_MajorType_Pos) /*!< TPI DEVTYPE: MajorType Mask */ + +/*@}*/ /* end of group CMSIS_TPI */ + + +#if (__MPU_PRESENT == 1) +/** \ingroup CMSIS_core_register + \defgroup CMSIS_MPU Memory Protection Unit (MPU) + \brief Type definitions for the Memory Protection Unit (MPU) + @{ + */ + +/** \brief Structure type to access the Memory Protection Unit (MPU). + */ +typedef struct +{ + __I uint32_t TYPE; /*!< Offset: 0x000 (R/ ) MPU Type Register */ + __IO uint32_t CTRL; /*!< Offset: 0x004 (R/W) MPU Control Register */ + __IO uint32_t RNR; /*!< Offset: 0x008 (R/W) MPU Region RNRber Register */ + __IO uint32_t RBAR; /*!< Offset: 0x00C (R/W) MPU Region Base Address Register */ + __IO uint32_t RASR; /*!< Offset: 0x010 (R/W) MPU Region Attribute and Size Register */ + __IO uint32_t RBAR_A1; /*!< Offset: 0x014 (R/W) MPU Alias 1 Region Base Address Register */ + __IO uint32_t RASR_A1; /*!< Offset: 0x018 (R/W) MPU Alias 1 Region Attribute and Size Register */ + __IO uint32_t RBAR_A2; /*!< Offset: 0x01C (R/W) MPU Alias 2 Region Base Address Register */ + __IO uint32_t RASR_A2; /*!< Offset: 0x020 (R/W) MPU Alias 2 Region Attribute and Size Register */ + __IO uint32_t RBAR_A3; /*!< Offset: 0x024 (R/W) MPU Alias 3 Region Base Address Register */ + __IO uint32_t RASR_A3; /*!< Offset: 0x028 (R/W) MPU Alias 3 Region Attribute and Size Register */ +} MPU_Type; + +/* MPU Type Register */ +#define MPU_TYPE_IREGION_Pos 16 /*!< MPU TYPE: IREGION Position */ +#define MPU_TYPE_IREGION_Msk (0xFFUL << MPU_TYPE_IREGION_Pos) /*!< MPU TYPE: IREGION Mask */ + +#define MPU_TYPE_DREGION_Pos 8 /*!< MPU TYPE: DREGION Position */ +#define MPU_TYPE_DREGION_Msk (0xFFUL << MPU_TYPE_DREGION_Pos) /*!< MPU TYPE: DREGION Mask */ + +#define MPU_TYPE_SEPARATE_Pos 0 /*!< MPU TYPE: SEPARATE Position */ +#define MPU_TYPE_SEPARATE_Msk (1UL << MPU_TYPE_SEPARATE_Pos) /*!< MPU TYPE: SEPARATE Mask */ + +/* MPU Control Register */ +#define MPU_CTRL_PRIVDEFENA_Pos 2 /*!< MPU CTRL: PRIVDEFENA Position */ +#define MPU_CTRL_PRIVDEFENA_Msk (1UL << MPU_CTRL_PRIVDEFENA_Pos) /*!< MPU CTRL: PRIVDEFENA Mask */ + +#define MPU_CTRL_HFNMIENA_Pos 1 /*!< MPU CTRL: HFNMIENA Position */ +#define MPU_CTRL_HFNMIENA_Msk (1UL << MPU_CTRL_HFNMIENA_Pos) /*!< MPU CTRL: HFNMIENA Mask */ + +#define MPU_CTRL_ENABLE_Pos 0 /*!< MPU CTRL: ENABLE Position */ +#define MPU_CTRL_ENABLE_Msk (1UL << MPU_CTRL_ENABLE_Pos) /*!< MPU CTRL: ENABLE Mask */ + +/* MPU Region Number Register */ +#define MPU_RNR_REGION_Pos 0 /*!< MPU RNR: REGION Position */ +#define MPU_RNR_REGION_Msk (0xFFUL << MPU_RNR_REGION_Pos) /*!< MPU RNR: REGION Mask */ + +/* MPU Region Base Address Register */ +#define MPU_RBAR_ADDR_Pos 5 /*!< MPU RBAR: ADDR Position */ +#define MPU_RBAR_ADDR_Msk (0x7FFFFFFUL << MPU_RBAR_ADDR_Pos) /*!< MPU RBAR: ADDR Mask */ + +#define MPU_RBAR_VALID_Pos 4 /*!< MPU RBAR: VALID Position */ +#define MPU_RBAR_VALID_Msk (1UL << MPU_RBAR_VALID_Pos) /*!< MPU RBAR: VALID Mask */ + +#define MPU_RBAR_REGION_Pos 0 /*!< MPU RBAR: REGION Position */ +#define MPU_RBAR_REGION_Msk (0xFUL << MPU_RBAR_REGION_Pos) /*!< MPU RBAR: REGION Mask */ + +/* MPU Region Attribute and Size Register */ +#define MPU_RASR_ATTRS_Pos 16 /*!< MPU RASR: MPU Region Attribute field Position */ +#define MPU_RASR_ATTRS_Msk (0xFFFFUL << MPU_RASR_ATTRS_Pos) /*!< MPU RASR: MPU Region Attribute field Mask */ + +#define MPU_RASR_XN_Pos 28 /*!< MPU RASR: ATTRS.XN Position */ +#define MPU_RASR_XN_Msk (1UL << MPU_RASR_XN_Pos) /*!< MPU RASR: ATTRS.XN Mask */ + +#define MPU_RASR_AP_Pos 24 /*!< MPU RASR: ATTRS.AP Position */ +#define MPU_RASR_AP_Msk (0x7UL << MPU_RASR_AP_Pos) /*!< MPU RASR: ATTRS.AP Mask */ + +#define MPU_RASR_TEX_Pos 19 /*!< MPU RASR: ATTRS.TEX Position */ +#define MPU_RASR_TEX_Msk (0x7UL << MPU_RASR_TEX_Pos) /*!< MPU RASR: ATTRS.TEX Mask */ + +#define MPU_RASR_S_Pos 18 /*!< MPU RASR: ATTRS.S Position */ +#define MPU_RASR_S_Msk (1UL << MPU_RASR_S_Pos) /*!< MPU RASR: ATTRS.S Mask */ + +#define MPU_RASR_C_Pos 17 /*!< MPU RASR: ATTRS.C Position */ +#define MPU_RASR_C_Msk (1UL << MPU_RASR_C_Pos) /*!< MPU RASR: ATTRS.C Mask */ + +#define MPU_RASR_B_Pos 16 /*!< MPU RASR: ATTRS.B Position */ +#define MPU_RASR_B_Msk (1UL << MPU_RASR_B_Pos) /*!< MPU RASR: ATTRS.B Mask */ + +#define MPU_RASR_SRD_Pos 8 /*!< MPU RASR: Sub-Region Disable Position */ +#define MPU_RASR_SRD_Msk (0xFFUL << MPU_RASR_SRD_Pos) /*!< MPU RASR: Sub-Region Disable Mask */ + +#define MPU_RASR_SIZE_Pos 1 /*!< MPU RASR: Region Size Field Position */ +#define MPU_RASR_SIZE_Msk (0x1FUL << MPU_RASR_SIZE_Pos) /*!< MPU RASR: Region Size Field Mask */ + +#define MPU_RASR_ENABLE_Pos 0 /*!< MPU RASR: Region enable bit Position */ +#define MPU_RASR_ENABLE_Msk (1UL << MPU_RASR_ENABLE_Pos) /*!< MPU RASR: Region enable bit Disable Mask */ + +/*@} end of group CMSIS_MPU */ +#endif + + +#if (__FPU_PRESENT == 1) +/** \ingroup CMSIS_core_register + \defgroup CMSIS_FPU Floating Point Unit (FPU) + \brief Type definitions for the Floating Point Unit (FPU) + @{ + */ + +/** \brief Structure type to access the Floating Point Unit (FPU). + */ +typedef struct +{ + uint32_t RESERVED0[1]; + __IO uint32_t FPCCR; /*!< Offset: 0x004 (R/W) Floating-Point Context Control Register */ + __IO uint32_t FPCAR; /*!< Offset: 0x008 (R/W) Floating-Point Context Address Register */ + __IO uint32_t FPDSCR; /*!< Offset: 0x00C (R/W) Floating-Point Default Status Control Register */ + __I uint32_t MVFR0; /*!< Offset: 0x010 (R/ ) Media and FP Feature Register 0 */ + __I uint32_t MVFR1; /*!< Offset: 0x014 (R/ ) Media and FP Feature Register 1 */ +} FPU_Type; + +/* Floating-Point Context Control Register */ +#define FPU_FPCCR_ASPEN_Pos 31 /*!< FPCCR: ASPEN bit Position */ +#define FPU_FPCCR_ASPEN_Msk (1UL << FPU_FPCCR_ASPEN_Pos) /*!< FPCCR: ASPEN bit Mask */ + +#define FPU_FPCCR_LSPEN_Pos 30 /*!< FPCCR: LSPEN Position */ +#define FPU_FPCCR_LSPEN_Msk (1UL << FPU_FPCCR_LSPEN_Pos) /*!< FPCCR: LSPEN bit Mask */ + +#define FPU_FPCCR_MONRDY_Pos 8 /*!< FPCCR: MONRDY Position */ +#define FPU_FPCCR_MONRDY_Msk (1UL << FPU_FPCCR_MONRDY_Pos) /*!< FPCCR: MONRDY bit Mask */ + +#define FPU_FPCCR_BFRDY_Pos 6 /*!< FPCCR: BFRDY Position */ +#define FPU_FPCCR_BFRDY_Msk (1UL << FPU_FPCCR_BFRDY_Pos) /*!< FPCCR: BFRDY bit Mask */ + +#define FPU_FPCCR_MMRDY_Pos 5 /*!< FPCCR: MMRDY Position */ +#define FPU_FPCCR_MMRDY_Msk (1UL << FPU_FPCCR_MMRDY_Pos) /*!< FPCCR: MMRDY bit Mask */ + +#define FPU_FPCCR_HFRDY_Pos 4 /*!< FPCCR: HFRDY Position */ +#define FPU_FPCCR_HFRDY_Msk (1UL << FPU_FPCCR_HFRDY_Pos) /*!< FPCCR: HFRDY bit Mask */ + +#define FPU_FPCCR_THREAD_Pos 3 /*!< FPCCR: processor mode bit Position */ +#define FPU_FPCCR_THREAD_Msk (1UL << FPU_FPCCR_THREAD_Pos) /*!< FPCCR: processor mode active bit Mask */ + +#define FPU_FPCCR_USER_Pos 1 /*!< FPCCR: privilege level bit Position */ +#define FPU_FPCCR_USER_Msk (1UL << FPU_FPCCR_USER_Pos) /*!< FPCCR: privilege level bit Mask */ + +#define FPU_FPCCR_LSPACT_Pos 0 /*!< FPCCR: Lazy state preservation active bit Position */ +#define FPU_FPCCR_LSPACT_Msk (1UL << FPU_FPCCR_LSPACT_Pos) /*!< FPCCR: Lazy state preservation active bit Mask */ + +/* Floating-Point Context Address Register */ +#define FPU_FPCAR_ADDRESS_Pos 3 /*!< FPCAR: ADDRESS bit Position */ +#define FPU_FPCAR_ADDRESS_Msk (0x1FFFFFFFUL << FPU_FPCAR_ADDRESS_Pos) /*!< FPCAR: ADDRESS bit Mask */ + +/* Floating-Point Default Status Control Register */ +#define FPU_FPDSCR_AHP_Pos 26 /*!< FPDSCR: AHP bit Position */ +#define FPU_FPDSCR_AHP_Msk (1UL << FPU_FPDSCR_AHP_Pos) /*!< FPDSCR: AHP bit Mask */ + +#define FPU_FPDSCR_DN_Pos 25 /*!< FPDSCR: DN bit Position */ +#define FPU_FPDSCR_DN_Msk (1UL << FPU_FPDSCR_DN_Pos) /*!< FPDSCR: DN bit Mask */ + +#define FPU_FPDSCR_FZ_Pos 24 /*!< FPDSCR: FZ bit Position */ +#define FPU_FPDSCR_FZ_Msk (1UL << FPU_FPDSCR_FZ_Pos) /*!< FPDSCR: FZ bit Mask */ + +#define FPU_FPDSCR_RMode_Pos 22 /*!< FPDSCR: RMode bit Position */ +#define FPU_FPDSCR_RMode_Msk (3UL << FPU_FPDSCR_RMode_Pos) /*!< FPDSCR: RMode bit Mask */ + +/* Media and FP Feature Register 0 */ +#define FPU_MVFR0_FP_rounding_modes_Pos 28 /*!< MVFR0: FP rounding modes bits Position */ +#define FPU_MVFR0_FP_rounding_modes_Msk (0xFUL << FPU_MVFR0_FP_rounding_modes_Pos) /*!< MVFR0: FP rounding modes bits Mask */ + +#define FPU_MVFR0_Short_vectors_Pos 24 /*!< MVFR0: Short vectors bits Position */ +#define FPU_MVFR0_Short_vectors_Msk (0xFUL << FPU_MVFR0_Short_vectors_Pos) /*!< MVFR0: Short vectors bits Mask */ + +#define FPU_MVFR0_Square_root_Pos 20 /*!< MVFR0: Square root bits Position */ +#define FPU_MVFR0_Square_root_Msk (0xFUL << FPU_MVFR0_Square_root_Pos) /*!< MVFR0: Square root bits Mask */ + +#define FPU_MVFR0_Divide_Pos 16 /*!< MVFR0: Divide bits Position */ +#define FPU_MVFR0_Divide_Msk (0xFUL << FPU_MVFR0_Divide_Pos) /*!< MVFR0: Divide bits Mask */ + +#define FPU_MVFR0_FP_excep_trapping_Pos 12 /*!< MVFR0: FP exception trapping bits Position */ +#define FPU_MVFR0_FP_excep_trapping_Msk (0xFUL << FPU_MVFR0_FP_excep_trapping_Pos) /*!< MVFR0: FP exception trapping bits Mask */ + +#define FPU_MVFR0_Double_precision_Pos 8 /*!< MVFR0: Double-precision bits Position */ +#define FPU_MVFR0_Double_precision_Msk (0xFUL << FPU_MVFR0_Double_precision_Pos) /*!< MVFR0: Double-precision bits Mask */ + +#define FPU_MVFR0_Single_precision_Pos 4 /*!< MVFR0: Single-precision bits Position */ +#define FPU_MVFR0_Single_precision_Msk (0xFUL << FPU_MVFR0_Single_precision_Pos) /*!< MVFR0: Single-precision bits Mask */ + +#define FPU_MVFR0_A_SIMD_registers_Pos 0 /*!< MVFR0: A_SIMD registers bits Position */ +#define FPU_MVFR0_A_SIMD_registers_Msk (0xFUL << FPU_MVFR0_A_SIMD_registers_Pos) /*!< MVFR0: A_SIMD registers bits Mask */ + +/* Media and FP Feature Register 1 */ +#define FPU_MVFR1_FP_fused_MAC_Pos 28 /*!< MVFR1: FP fused MAC bits Position */ +#define FPU_MVFR1_FP_fused_MAC_Msk (0xFUL << FPU_MVFR1_FP_fused_MAC_Pos) /*!< MVFR1: FP fused MAC bits Mask */ + +#define FPU_MVFR1_FP_HPFP_Pos 24 /*!< MVFR1: FP HPFP bits Position */ +#define FPU_MVFR1_FP_HPFP_Msk (0xFUL << FPU_MVFR1_FP_HPFP_Pos) /*!< MVFR1: FP HPFP bits Mask */ + +#define FPU_MVFR1_D_NaN_mode_Pos 4 /*!< MVFR1: D_NaN mode bits Position */ +#define FPU_MVFR1_D_NaN_mode_Msk (0xFUL << FPU_MVFR1_D_NaN_mode_Pos) /*!< MVFR1: D_NaN mode bits Mask */ + +#define FPU_MVFR1_FtZ_mode_Pos 0 /*!< MVFR1: FtZ mode bits Position */ +#define FPU_MVFR1_FtZ_mode_Msk (0xFUL << FPU_MVFR1_FtZ_mode_Pos) /*!< MVFR1: FtZ mode bits Mask */ + +/*@} end of group CMSIS_FPU */ +#endif + + +/** \ingroup CMSIS_core_register + \defgroup CMSIS_CoreDebug Core Debug Registers (CoreDebug) + \brief Type definitions for the Core Debug Registers + @{ + */ + +/** \brief Structure type to access the Core Debug Register (CoreDebug). + */ +typedef struct +{ + __IO uint32_t DHCSR; /*!< Offset: 0x000 (R/W) Debug Halting Control and Status Register */ + __O uint32_t DCRSR; /*!< Offset: 0x004 ( /W) Debug Core Register Selector Register */ + __IO uint32_t DCRDR; /*!< Offset: 0x008 (R/W) Debug Core Register Data Register */ + __IO uint32_t DEMCR; /*!< Offset: 0x00C (R/W) Debug Exception and Monitor Control Register */ +} CoreDebug_Type; + +/* Debug Halting Control and Status Register */ +#define CoreDebug_DHCSR_DBGKEY_Pos 16 /*!< CoreDebug DHCSR: DBGKEY Position */ +#define CoreDebug_DHCSR_DBGKEY_Msk (0xFFFFUL << CoreDebug_DHCSR_DBGKEY_Pos) /*!< CoreDebug DHCSR: DBGKEY Mask */ + +#define CoreDebug_DHCSR_S_RESET_ST_Pos 25 /*!< CoreDebug DHCSR: S_RESET_ST Position */ +#define CoreDebug_DHCSR_S_RESET_ST_Msk (1UL << CoreDebug_DHCSR_S_RESET_ST_Pos) /*!< CoreDebug DHCSR: S_RESET_ST Mask */ + +#define CoreDebug_DHCSR_S_RETIRE_ST_Pos 24 /*!< CoreDebug DHCSR: S_RETIRE_ST Position */ +#define CoreDebug_DHCSR_S_RETIRE_ST_Msk (1UL << CoreDebug_DHCSR_S_RETIRE_ST_Pos) /*!< CoreDebug DHCSR: S_RETIRE_ST Mask */ + +#define CoreDebug_DHCSR_S_LOCKUP_Pos 19 /*!< CoreDebug DHCSR: S_LOCKUP Position */ +#define CoreDebug_DHCSR_S_LOCKUP_Msk (1UL << CoreDebug_DHCSR_S_LOCKUP_Pos) /*!< CoreDebug DHCSR: S_LOCKUP Mask */ + +#define CoreDebug_DHCSR_S_SLEEP_Pos 18 /*!< CoreDebug DHCSR: S_SLEEP Position */ +#define CoreDebug_DHCSR_S_SLEEP_Msk (1UL << CoreDebug_DHCSR_S_SLEEP_Pos) /*!< CoreDebug DHCSR: S_SLEEP Mask */ + +#define CoreDebug_DHCSR_S_HALT_Pos 17 /*!< CoreDebug DHCSR: S_HALT Position */ +#define CoreDebug_DHCSR_S_HALT_Msk (1UL << CoreDebug_DHCSR_S_HALT_Pos) /*!< CoreDebug DHCSR: S_HALT Mask */ + +#define CoreDebug_DHCSR_S_REGRDY_Pos 16 /*!< CoreDebug DHCSR: S_REGRDY Position */ +#define CoreDebug_DHCSR_S_REGRDY_Msk (1UL << CoreDebug_DHCSR_S_REGRDY_Pos) /*!< CoreDebug DHCSR: S_REGRDY Mask */ + +#define CoreDebug_DHCSR_C_SNAPSTALL_Pos 5 /*!< CoreDebug DHCSR: C_SNAPSTALL Position */ +#define CoreDebug_DHCSR_C_SNAPSTALL_Msk (1UL << CoreDebug_DHCSR_C_SNAPSTALL_Pos) /*!< CoreDebug DHCSR: C_SNAPSTALL Mask */ + +#define CoreDebug_DHCSR_C_MASKINTS_Pos 3 /*!< CoreDebug DHCSR: C_MASKINTS Position */ +#define CoreDebug_DHCSR_C_MASKINTS_Msk (1UL << CoreDebug_DHCSR_C_MASKINTS_Pos) /*!< CoreDebug DHCSR: C_MASKINTS Mask */ + +#define CoreDebug_DHCSR_C_STEP_Pos 2 /*!< CoreDebug DHCSR: C_STEP Position */ +#define CoreDebug_DHCSR_C_STEP_Msk (1UL << CoreDebug_DHCSR_C_STEP_Pos) /*!< CoreDebug DHCSR: C_STEP Mask */ + +#define CoreDebug_DHCSR_C_HALT_Pos 1 /*!< CoreDebug DHCSR: C_HALT Position */ +#define CoreDebug_DHCSR_C_HALT_Msk (1UL << CoreDebug_DHCSR_C_HALT_Pos) /*!< CoreDebug DHCSR: C_HALT Mask */ + +#define CoreDebug_DHCSR_C_DEBUGEN_Pos 0 /*!< CoreDebug DHCSR: C_DEBUGEN Position */ +#define CoreDebug_DHCSR_C_DEBUGEN_Msk (1UL << CoreDebug_DHCSR_C_DEBUGEN_Pos) /*!< CoreDebug DHCSR: C_DEBUGEN Mask */ + +/* Debug Core Register Selector Register */ +#define CoreDebug_DCRSR_REGWnR_Pos 16 /*!< CoreDebug DCRSR: REGWnR Position */ +#define CoreDebug_DCRSR_REGWnR_Msk (1UL << CoreDebug_DCRSR_REGWnR_Pos) /*!< CoreDebug DCRSR: REGWnR Mask */ + +#define CoreDebug_DCRSR_REGSEL_Pos 0 /*!< CoreDebug DCRSR: REGSEL Position */ +#define CoreDebug_DCRSR_REGSEL_Msk (0x1FUL << CoreDebug_DCRSR_REGSEL_Pos) /*!< CoreDebug DCRSR: REGSEL Mask */ + +/* Debug Exception and Monitor Control Register */ +#define CoreDebug_DEMCR_TRCENA_Pos 24 /*!< CoreDebug DEMCR: TRCENA Position */ +#define CoreDebug_DEMCR_TRCENA_Msk (1UL << CoreDebug_DEMCR_TRCENA_Pos) /*!< CoreDebug DEMCR: TRCENA Mask */ + +#define CoreDebug_DEMCR_MON_REQ_Pos 19 /*!< CoreDebug DEMCR: MON_REQ Position */ +#define CoreDebug_DEMCR_MON_REQ_Msk (1UL << CoreDebug_DEMCR_MON_REQ_Pos) /*!< CoreDebug DEMCR: MON_REQ Mask */ + +#define CoreDebug_DEMCR_MON_STEP_Pos 18 /*!< CoreDebug DEMCR: MON_STEP Position */ +#define CoreDebug_DEMCR_MON_STEP_Msk (1UL << CoreDebug_DEMCR_MON_STEP_Pos) /*!< CoreDebug DEMCR: MON_STEP Mask */ + +#define CoreDebug_DEMCR_MON_PEND_Pos 17 /*!< CoreDebug DEMCR: MON_PEND Position */ +#define CoreDebug_DEMCR_MON_PEND_Msk (1UL << CoreDebug_DEMCR_MON_PEND_Pos) /*!< CoreDebug DEMCR: MON_PEND Mask */ + +#define CoreDebug_DEMCR_MON_EN_Pos 16 /*!< CoreDebug DEMCR: MON_EN Position */ +#define CoreDebug_DEMCR_MON_EN_Msk (1UL << CoreDebug_DEMCR_MON_EN_Pos) /*!< CoreDebug DEMCR: MON_EN Mask */ + +#define CoreDebug_DEMCR_VC_HARDERR_Pos 10 /*!< CoreDebug DEMCR: VC_HARDERR Position */ +#define CoreDebug_DEMCR_VC_HARDERR_Msk (1UL << CoreDebug_DEMCR_VC_HARDERR_Pos) /*!< CoreDebug DEMCR: VC_HARDERR Mask */ + +#define CoreDebug_DEMCR_VC_INTERR_Pos 9 /*!< CoreDebug DEMCR: VC_INTERR Position */ +#define CoreDebug_DEMCR_VC_INTERR_Msk (1UL << CoreDebug_DEMCR_VC_INTERR_Pos) /*!< CoreDebug DEMCR: VC_INTERR Mask */ + +#define CoreDebug_DEMCR_VC_BUSERR_Pos 8 /*!< CoreDebug DEMCR: VC_BUSERR Position */ +#define CoreDebug_DEMCR_VC_BUSERR_Msk (1UL << CoreDebug_DEMCR_VC_BUSERR_Pos) /*!< CoreDebug DEMCR: VC_BUSERR Mask */ + +#define CoreDebug_DEMCR_VC_STATERR_Pos 7 /*!< CoreDebug DEMCR: VC_STATERR Position */ +#define CoreDebug_DEMCR_VC_STATERR_Msk (1UL << CoreDebug_DEMCR_VC_STATERR_Pos) /*!< CoreDebug DEMCR: VC_STATERR Mask */ + +#define CoreDebug_DEMCR_VC_CHKERR_Pos 6 /*!< CoreDebug DEMCR: VC_CHKERR Position */ +#define CoreDebug_DEMCR_VC_CHKERR_Msk (1UL << CoreDebug_DEMCR_VC_CHKERR_Pos) /*!< CoreDebug DEMCR: VC_CHKERR Mask */ + +#define CoreDebug_DEMCR_VC_NOCPERR_Pos 5 /*!< CoreDebug DEMCR: VC_NOCPERR Position */ +#define CoreDebug_DEMCR_VC_NOCPERR_Msk (1UL << CoreDebug_DEMCR_VC_NOCPERR_Pos) /*!< CoreDebug DEMCR: VC_NOCPERR Mask */ + +#define CoreDebug_DEMCR_VC_MMERR_Pos 4 /*!< CoreDebug DEMCR: VC_MMERR Position */ +#define CoreDebug_DEMCR_VC_MMERR_Msk (1UL << CoreDebug_DEMCR_VC_MMERR_Pos) /*!< CoreDebug DEMCR: VC_MMERR Mask */ + +#define CoreDebug_DEMCR_VC_CORERESET_Pos 0 /*!< CoreDebug DEMCR: VC_CORERESET Position */ +#define CoreDebug_DEMCR_VC_CORERESET_Msk (1UL << CoreDebug_DEMCR_VC_CORERESET_Pos) /*!< CoreDebug DEMCR: VC_CORERESET Mask */ + +/*@} end of group CMSIS_CoreDebug */ + + +/** \ingroup CMSIS_core_register + \defgroup CMSIS_core_base Core Definitions + \brief Definitions for base addresses, unions, and structures. + @{ + */ + +/* Memory mapping of Cortex-M4 Hardware */ +#define SCS_BASE (0xE000E000UL) /*!< System Control Space Base Address */ +#define ITM_BASE (0xE0000000UL) /*!< ITM Base Address */ +#define DWT_BASE (0xE0001000UL) /*!< DWT Base Address */ +#define TPI_BASE (0xE0040000UL) /*!< TPI Base Address */ +#define CoreDebug_BASE (0xE000EDF0UL) /*!< Core Debug Base Address */ +#define SysTick_BASE (SCS_BASE + 0x0010UL) /*!< SysTick Base Address */ +#define NVIC_BASE (SCS_BASE + 0x0100UL) /*!< NVIC Base Address */ +#define SCB_BASE (SCS_BASE + 0x0D00UL) /*!< System Control Block Base Address */ + +#define SCnSCB ((SCnSCB_Type *) SCS_BASE ) /*!< System control Register not in SCB */ +#define SCB ((SCB_Type *) SCB_BASE ) /*!< SCB configuration struct */ +#define SysTick ((SysTick_Type *) SysTick_BASE ) /*!< SysTick configuration struct */ +#define NVIC ((NVIC_Type *) NVIC_BASE ) /*!< NVIC configuration struct */ +#define ITM ((ITM_Type *) ITM_BASE ) /*!< ITM configuration struct */ +#define DWT ((DWT_Type *) DWT_BASE ) /*!< DWT configuration struct */ +#define TPI ((TPI_Type *) TPI_BASE ) /*!< TPI configuration struct */ +#define CoreDebug ((CoreDebug_Type *) CoreDebug_BASE) /*!< Core Debug configuration struct */ + +#if (__MPU_PRESENT == 1) + #define MPU_BASE (SCS_BASE + 0x0D90UL) /*!< Memory Protection Unit */ + #define MPU ((MPU_Type *) MPU_BASE ) /*!< Memory Protection Unit */ +#endif + +#if (__FPU_PRESENT == 1) + #define FPU_BASE (SCS_BASE + 0x0F30UL) /*!< Floating Point Unit */ + #define FPU ((FPU_Type *) FPU_BASE ) /*!< Floating Point Unit */ +#endif + +/*@} */ + + + +/******************************************************************************* + * Hardware Abstraction Layer + Core Function Interface contains: + - Core NVIC Functions + - Core SysTick Functions + - Core Debug Functions + - Core Register Access Functions + ******************************************************************************/ +/** \defgroup CMSIS_Core_FunctionInterface Functions and Instructions Reference +*/ + + + +/* ########################## NVIC functions #################################### */ +/** \ingroup CMSIS_Core_FunctionInterface + \defgroup CMSIS_Core_NVICFunctions NVIC Functions + \brief Functions that manage interrupts and exceptions via the NVIC. + @{ + */ + +/** \brief Set Priority Grouping + + The function sets the priority grouping field using the required unlock sequence. + The parameter PriorityGroup is assigned to the field SCB->AIRCR [10:8] PRIGROUP field. + Only values from 0..7 are used. + In case of a conflict between priority grouping and available + priority bits (__NVIC_PRIO_BITS), the smallest possible priority group is set. + + \param [in] PriorityGroup Priority grouping field. + */ +__STATIC_INLINE void NVIC_SetPriorityGrouping(uint32_t PriorityGroup) +{ + uint32_t reg_value; + uint32_t PriorityGroupTmp = (PriorityGroup & (uint32_t)0x07); /* only values 0..7 are used */ + + reg_value = SCB->AIRCR; /* read old register configuration */ + reg_value &= ~(SCB_AIRCR_VECTKEY_Msk | SCB_AIRCR_PRIGROUP_Msk); /* clear bits to change */ + reg_value = (reg_value | + ((uint32_t)0x5FA << SCB_AIRCR_VECTKEY_Pos) | + (PriorityGroupTmp << 8)); /* Insert write key and priorty group */ + SCB->AIRCR = reg_value; +} + + +/** \brief Get Priority Grouping + + The function reads the priority grouping field from the NVIC Interrupt Controller. + + \return Priority grouping field (SCB->AIRCR [10:8] PRIGROUP field). + */ +__STATIC_INLINE uint32_t NVIC_GetPriorityGrouping(void) +{ + return ((SCB->AIRCR & SCB_AIRCR_PRIGROUP_Msk) >> SCB_AIRCR_PRIGROUP_Pos); /* read priority grouping field */ +} + + +/** \brief Enable External Interrupt + + The function enables a device-specific interrupt in the NVIC interrupt controller. + + \param [in] IRQn External interrupt number. Value cannot be negative. + */ +__STATIC_INLINE void NVIC_EnableIRQ(IRQn_Type IRQn) +{ +/* NVIC->ISER[((uint32_t)(IRQn) >> 5)] = (1 << ((uint32_t)(IRQn) & 0x1F)); enable interrupt */ + NVIC->ISER[(uint32_t)((int32_t)IRQn) >> 5] = (uint32_t)(1 << ((uint32_t)((int32_t)IRQn) & (uint32_t)0x1F)); /* enable interrupt */ +} + + +/** \brief Disable External Interrupt + + The function disables a device-specific interrupt in the NVIC interrupt controller. + + \param [in] IRQn External interrupt number. Value cannot be negative. + */ +__STATIC_INLINE void NVIC_DisableIRQ(IRQn_Type IRQn) +{ + NVIC->ICER[((uint32_t)(IRQn) >> 5)] = (1 << ((uint32_t)(IRQn) & 0x1F)); /* disable interrupt */ +} + + +/** \brief Get Pending Interrupt + + The function reads the pending register in the NVIC and returns the pending bit + for the specified interrupt. + + \param [in] IRQn Interrupt number. + + \return 0 Interrupt status is not pending. + \return 1 Interrupt status is pending. + */ +__STATIC_INLINE uint32_t NVIC_GetPendingIRQ(IRQn_Type IRQn) +{ + return((uint32_t) ((NVIC->ISPR[(uint32_t)(IRQn) >> 5] & (1 << ((uint32_t)(IRQn) & 0x1F)))?1:0)); /* Return 1 if pending else 0 */ +} + + +/** \brief Set Pending Interrupt + + The function sets the pending bit of an external interrupt. + + \param [in] IRQn Interrupt number. Value cannot be negative. + */ +__STATIC_INLINE void NVIC_SetPendingIRQ(IRQn_Type IRQn) +{ + NVIC->ISPR[((uint32_t)(IRQn) >> 5)] = (1 << ((uint32_t)(IRQn) & 0x1F)); /* set interrupt pending */ +} + + +/** \brief Clear Pending Interrupt + + The function clears the pending bit of an external interrupt. + + \param [in] IRQn External interrupt number. Value cannot be negative. + */ +__STATIC_INLINE void NVIC_ClearPendingIRQ(IRQn_Type IRQn) +{ + NVIC->ICPR[((uint32_t)(IRQn) >> 5)] = (1 << ((uint32_t)(IRQn) & 0x1F)); /* Clear pending interrupt */ +} + + +/** \brief Get Active Interrupt + + The function reads the active register in NVIC and returns the active bit. + + \param [in] IRQn Interrupt number. + + \return 0 Interrupt status is not active. + \return 1 Interrupt status is active. + */ +__STATIC_INLINE uint32_t NVIC_GetActive(IRQn_Type IRQn) +{ + return((uint32_t)((NVIC->IABR[(uint32_t)(IRQn) >> 5] & (1 << ((uint32_t)(IRQn) & 0x1F)))?1:0)); /* Return 1 if active else 0 */ +} + + +/** \brief Set Interrupt Priority + + The function sets the priority of an interrupt. + + \note The priority cannot be set for every core interrupt. + + \param [in] IRQn Interrupt number. + \param [in] priority Priority to set. + */ +__STATIC_INLINE void NVIC_SetPriority(IRQn_Type IRQn, uint32_t priority) +{ + if(IRQn < 0) { + SCB->SHP[((uint32_t)(IRQn) & 0xF)-4] = ((priority << (8 - __NVIC_PRIO_BITS)) & 0xff); } /* set Priority for Cortex-M System Interrupts */ + else { + NVIC->IP[(uint32_t)(IRQn)] = ((priority << (8 - __NVIC_PRIO_BITS)) & 0xff); } /* set Priority for device specific Interrupts */ +} + + +/** \brief Get Interrupt Priority + + The function reads the priority of an interrupt. The interrupt + number can be positive to specify an external (device specific) + interrupt, or negative to specify an internal (core) interrupt. + + + \param [in] IRQn Interrupt number. + \return Interrupt Priority. Value is aligned automatically to the implemented + priority bits of the microcontroller. + */ +__STATIC_INLINE uint32_t NVIC_GetPriority(IRQn_Type IRQn) +{ + + if(IRQn < 0) { + return((uint32_t)(SCB->SHP[((uint32_t)(IRQn) & 0xF)-4] >> (8 - __NVIC_PRIO_BITS))); } /* get priority for Cortex-M system interrupts */ + else { + return((uint32_t)(NVIC->IP[(uint32_t)(IRQn)] >> (8 - __NVIC_PRIO_BITS))); } /* get priority for device specific interrupts */ +} + + +/** \brief Encode Priority + + The function encodes the priority for an interrupt with the given priority group, + preemptive priority value, and subpriority value. + In case of a conflict between priority grouping and available + priority bits (__NVIC_PRIO_BITS), the samllest possible priority group is set. + + \param [in] PriorityGroup Used priority group. + \param [in] PreemptPriority Preemptive priority value (starting from 0). + \param [in] SubPriority Subpriority value (starting from 0). + \return Encoded priority. Value can be used in the function \ref NVIC_SetPriority(). + */ +__STATIC_INLINE uint32_t NVIC_EncodePriority (uint32_t PriorityGroup, uint32_t PreemptPriority, uint32_t SubPriority) +{ + uint32_t PriorityGroupTmp = (PriorityGroup & 0x07); /* only values 0..7 are used */ + uint32_t PreemptPriorityBits; + uint32_t SubPriorityBits; + + PreemptPriorityBits = ((7 - PriorityGroupTmp) > __NVIC_PRIO_BITS) ? __NVIC_PRIO_BITS : 7 - PriorityGroupTmp; + SubPriorityBits = ((PriorityGroupTmp + __NVIC_PRIO_BITS) < 7) ? 0 : PriorityGroupTmp - 7 + __NVIC_PRIO_BITS; + + return ( + ((PreemptPriority & ((1 << (PreemptPriorityBits)) - 1)) << SubPriorityBits) | + ((SubPriority & ((1 << (SubPriorityBits )) - 1))) + ); +} + + +/** \brief Decode Priority + + The function decodes an interrupt priority value with a given priority group to + preemptive priority value and subpriority value. + In case of a conflict between priority grouping and available + priority bits (__NVIC_PRIO_BITS) the samllest possible priority group is set. + + \param [in] Priority Priority value, which can be retrieved with the function \ref NVIC_GetPriority(). + \param [in] PriorityGroup Used priority group. + \param [out] pPreemptPriority Preemptive priority value (starting from 0). + \param [out] pSubPriority Subpriority value (starting from 0). + */ +__STATIC_INLINE void NVIC_DecodePriority (uint32_t Priority, uint32_t PriorityGroup, uint32_t* pPreemptPriority, uint32_t* pSubPriority) +{ + uint32_t PriorityGroupTmp = (PriorityGroup & 0x07); /* only values 0..7 are used */ + uint32_t PreemptPriorityBits; + uint32_t SubPriorityBits; + + PreemptPriorityBits = ((7 - PriorityGroupTmp) > __NVIC_PRIO_BITS) ? __NVIC_PRIO_BITS : 7 - PriorityGroupTmp; + SubPriorityBits = ((PriorityGroupTmp + __NVIC_PRIO_BITS) < 7) ? 0 : PriorityGroupTmp - 7 + __NVIC_PRIO_BITS; + + *pPreemptPriority = (Priority >> SubPriorityBits) & ((1 << (PreemptPriorityBits)) - 1); + *pSubPriority = (Priority ) & ((1 << (SubPriorityBits )) - 1); +} + + +/** \brief System Reset + + The function initiates a system reset request to reset the MCU. + */ +__STATIC_INLINE void NVIC_SystemReset(void) +{ + __DSB(); /* Ensure all outstanding memory accesses included + buffered write are completed before reset */ + SCB->AIRCR = ((0x5FA << SCB_AIRCR_VECTKEY_Pos) | + (SCB->AIRCR & SCB_AIRCR_PRIGROUP_Msk) | + SCB_AIRCR_SYSRESETREQ_Msk); /* Keep priority group unchanged */ + __DSB(); /* Ensure completion of memory access */ + while(1); /* wait until reset */ +} + +/*@} end of CMSIS_Core_NVICFunctions */ + + + +/* ################################## SysTick function ############################################ */ +/** \ingroup CMSIS_Core_FunctionInterface + \defgroup CMSIS_Core_SysTickFunctions SysTick Functions + \brief Functions that configure the System. + @{ + */ + +#if (__Vendor_SysTickConfig == 0) + +/** \brief System Tick Configuration + + The function initializes the System Timer and its interrupt, and starts the System Tick Timer. + Counter is in free running mode to generate periodic interrupts. + + \param [in] ticks Number of ticks between two interrupts. + + \return 0 Function succeeded. + \return 1 Function failed. + + \note When the variable __Vendor_SysTickConfig is set to 1, then the + function SysTick_Config is not included. In this case, the file device.h + must contain a vendor-specific implementation of this function. + + */ +__STATIC_INLINE uint32_t SysTick_Config(uint32_t ticks) +{ + if ((ticks - 1) > SysTick_LOAD_RELOAD_Msk) return (1); /* Reload value impossible */ + + SysTick->LOAD = ticks - 1; /* set reload register */ + NVIC_SetPriority (SysTick_IRQn, (1<<__NVIC_PRIO_BITS) - 1); /* set Priority for Systick Interrupt */ + SysTick->VAL = 0; /* Load the SysTick Counter Value */ + SysTick->CTRL = SysTick_CTRL_CLKSOURCE_Msk | + SysTick_CTRL_TICKINT_Msk | + SysTick_CTRL_ENABLE_Msk; /* Enable SysTick IRQ and SysTick Timer */ + return (0); /* Function successful */ +} + +#endif + +/*@} end of CMSIS_Core_SysTickFunctions */ + + + +/* ##################################### Debug In/Output function ########################################### */ +/** \ingroup CMSIS_Core_FunctionInterface + \defgroup CMSIS_core_DebugFunctions ITM Functions + \brief Functions that access the ITM debug interface. + @{ + */ + +extern volatile int32_t ITM_RxBuffer; /*!< External variable to receive characters. */ +#define ITM_RXBUFFER_EMPTY 0x5AA55AA5 /*!< Value identifying \ref ITM_RxBuffer is ready for next character. */ + + +/** \brief ITM Send Character + + The function transmits a character via the ITM channel 0, and + \li Just returns when no debugger is connected that has booked the output. + \li Is blocking when a debugger is connected, but the previous character sent has not been transmitted. + + \param [in] ch Character to transmit. + + \returns Character to transmit. + */ +__STATIC_INLINE uint32_t ITM_SendChar (uint32_t ch) +{ + if ((ITM->TCR & ITM_TCR_ITMENA_Msk) && /* ITM enabled */ + (ITM->TER & (1UL << 0) ) ) /* ITM Port #0 enabled */ + { + while (ITM->PORT[0].u32 == 0); + ITM->PORT[0].u8 = (uint8_t) ch; + } + return (ch); +} + + +/** \brief ITM Receive Character + + The function inputs a character via the external variable \ref ITM_RxBuffer. + + \return Received character. + \return -1 No character pending. + */ +__STATIC_INLINE int32_t ITM_ReceiveChar (void) { + int32_t ch = -1; /* no character available */ + + if (ITM_RxBuffer != ITM_RXBUFFER_EMPTY) { + ch = ITM_RxBuffer; + ITM_RxBuffer = ITM_RXBUFFER_EMPTY; /* ready for next character */ + } + + return (ch); +} + + +/** \brief ITM Check Character + + The function checks whether a character is pending for reading in the variable \ref ITM_RxBuffer. + + \return 0 No character available. + \return 1 Character available. + */ +__STATIC_INLINE int32_t ITM_CheckChar (void) { + + if (ITM_RxBuffer == ITM_RXBUFFER_EMPTY) { + return (0); /* no character available */ + } else { + return (1); /* character available */ + } +} + +/*@} end of CMSIS_core_DebugFunctions */ + +#endif /* __CORE_CM4_H_DEPENDANT */ + +#endif /* __CMSIS_GENERIC */ + +#ifdef __cplusplus +} +#endif diff --git a/CORE/core_cm4_simd.h b/CORE/core_cm4_simd.h new file mode 100644 index 0000000..83db95b --- /dev/null +++ b/CORE/core_cm4_simd.h @@ -0,0 +1,673 @@ +/**************************************************************************//** + * @file core_cm4_simd.h + * @brief CMSIS Cortex-M4 SIMD Header File + * @version V3.20 + * @date 25. February 2013 + * + * @note + * + ******************************************************************************/ +/* Copyright (c) 2009 - 2013 ARM LIMITED + + All rights reserved. + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions are met: + - Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + - Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + - Neither the name of ARM nor the names of its contributors may be used + to endorse or promote products derived from this software without + specific prior written permission. + * + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" + AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDERS AND CONTRIBUTORS BE + LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR + CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF + SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) + ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE + POSSIBILITY OF SUCH DAMAGE. + ---------------------------------------------------------------------------*/ + + +#ifdef __cplusplus + extern "C" { +#endif + +#ifndef __CORE_CM4_SIMD_H +#define __CORE_CM4_SIMD_H + + +/******************************************************************************* + * Hardware Abstraction Layer + ******************************************************************************/ + + +/* ################### Compiler specific Intrinsics ########################### */ +/** \defgroup CMSIS_SIMD_intrinsics CMSIS SIMD Intrinsics + Access to dedicated SIMD instructions + @{ +*/ + +#if defined ( __CC_ARM ) /*------------------RealView Compiler -----------------*/ +/* ARM armcc specific functions */ + +/*------ CM4 SIMD Intrinsics -----------------------------------------------------*/ +#define __SADD8 __sadd8 +#define __QADD8 __qadd8 +#define __SHADD8 __shadd8 +#define __UADD8 __uadd8 +#define __UQADD8 __uqadd8 +#define __UHADD8 __uhadd8 +#define __SSUB8 __ssub8 +#define __QSUB8 __qsub8 +#define __SHSUB8 __shsub8 +#define __USUB8 __usub8 +#define __UQSUB8 __uqsub8 +#define __UHSUB8 __uhsub8 +#define __SADD16 __sadd16 +#define __QADD16 __qadd16 +#define __SHADD16 __shadd16 +#define __UADD16 __uadd16 +#define __UQADD16 __uqadd16 +#define __UHADD16 __uhadd16 +#define __SSUB16 __ssub16 +#define __QSUB16 __qsub16 +#define __SHSUB16 __shsub16 +#define __USUB16 __usub16 +#define __UQSUB16 __uqsub16 +#define __UHSUB16 __uhsub16 +#define __SASX __sasx +#define __QASX __qasx +#define __SHASX __shasx +#define __UASX __uasx +#define __UQASX __uqasx +#define __UHASX __uhasx +#define __SSAX __ssax +#define __QSAX __qsax +#define __SHSAX __shsax +#define __USAX __usax +#define __UQSAX __uqsax +#define __UHSAX __uhsax +#define __USAD8 __usad8 +#define __USADA8 __usada8 +#define __SSAT16 __ssat16 +#define __USAT16 __usat16 +#define __UXTB16 __uxtb16 +#define __UXTAB16 __uxtab16 +#define __SXTB16 __sxtb16 +#define __SXTAB16 __sxtab16 +#define __SMUAD __smuad +#define __SMUADX __smuadx +#define __SMLAD __smlad +#define __SMLADX __smladx +#define __SMLALD __smlald +#define __SMLALDX __smlaldx +#define __SMUSD __smusd +#define __SMUSDX __smusdx +#define __SMLSD __smlsd +#define __SMLSDX __smlsdx +#define __SMLSLD __smlsld +#define __SMLSLDX __smlsldx +#define __SEL __sel +#define __QADD __qadd +#define __QSUB __qsub + +#define __PKHBT(ARG1,ARG2,ARG3) ( ((((uint32_t)(ARG1)) ) & 0x0000FFFFUL) | \ + ((((uint32_t)(ARG2)) << (ARG3)) & 0xFFFF0000UL) ) + +#define __PKHTB(ARG1,ARG2,ARG3) ( ((((uint32_t)(ARG1)) ) & 0xFFFF0000UL) | \ + ((((uint32_t)(ARG2)) >> (ARG3)) & 0x0000FFFFUL) ) + +#define __SMMLA(ARG1,ARG2,ARG3) ( (int32_t)((((int64_t)(ARG1) * (ARG2)) + \ + ((int64_t)(ARG3) << 32) ) >> 32)) + +/*-- End CM4 SIMD Intrinsics -----------------------------------------------------*/ + + + +#elif defined ( __ICCARM__ ) /*------------------ ICC Compiler -------------------*/ +/* IAR iccarm specific functions */ + +/*------ CM4 SIMD Intrinsics -----------------------------------------------------*/ +#include + +/*-- End CM4 SIMD Intrinsics -----------------------------------------------------*/ + + + +#elif defined ( __TMS470__ ) /*---------------- TI CCS Compiler ------------------*/ +/* TI CCS specific functions */ + +/*------ CM4 SIMD Intrinsics -----------------------------------------------------*/ +#include + +/*-- End CM4 SIMD Intrinsics -----------------------------------------------------*/ + + + +#elif defined ( __GNUC__ ) /*------------------ GNU Compiler ---------------------*/ +/* GNU gcc specific functions */ + +/*------ CM4 SIMD Intrinsics -----------------------------------------------------*/ +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SADD8(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("sadd8 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __QADD8(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("qadd8 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SHADD8(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("shadd8 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __UADD8(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uadd8 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __UQADD8(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uqadd8 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __UHADD8(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uhadd8 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SSUB8(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("ssub8 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __QSUB8(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("qsub8 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SHSUB8(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("shsub8 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __USUB8(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("usub8 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __UQSUB8(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uqsub8 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __UHSUB8(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uhsub8 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SADD16(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("sadd16 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __QADD16(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("qadd16 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SHADD16(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("shadd16 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __UADD16(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uadd16 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __UQADD16(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uqadd16 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __UHADD16(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uhadd16 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SSUB16(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("ssub16 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __QSUB16(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("qsub16 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SHSUB16(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("shsub16 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __USUB16(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("usub16 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __UQSUB16(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uqsub16 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __UHSUB16(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uhsub16 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SASX(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("sasx %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __QASX(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("qasx %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SHASX(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("shasx %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __UASX(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uasx %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __UQASX(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uqasx %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __UHASX(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uhasx %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SSAX(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("ssax %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __QSAX(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("qsax %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SHSAX(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("shsax %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __USAX(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("usax %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __UQSAX(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uqsax %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __UHSAX(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uhsax %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __USAD8(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("usad8 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __USADA8(uint32_t op1, uint32_t op2, uint32_t op3) +{ + uint32_t result; + + __ASM volatile ("usada8 %0, %1, %2, %3" : "=r" (result) : "r" (op1), "r" (op2), "r" (op3) ); + return(result); +} + +#define __SSAT16(ARG1,ARG2) \ +({ \ + uint32_t __RES, __ARG1 = (ARG1); \ + __ASM ("ssat16 %0, %1, %2" : "=r" (__RES) : "I" (ARG2), "r" (__ARG1) ); \ + __RES; \ + }) + +#define __USAT16(ARG1,ARG2) \ +({ \ + uint32_t __RES, __ARG1 = (ARG1); \ + __ASM ("usat16 %0, %1, %2" : "=r" (__RES) : "I" (ARG2), "r" (__ARG1) ); \ + __RES; \ + }) + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __UXTB16(uint32_t op1) +{ + uint32_t result; + + __ASM volatile ("uxtb16 %0, %1" : "=r" (result) : "r" (op1)); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __UXTAB16(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("uxtab16 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SXTB16(uint32_t op1) +{ + uint32_t result; + + __ASM volatile ("sxtb16 %0, %1" : "=r" (result) : "r" (op1)); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SXTAB16(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("sxtab16 %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SMUAD (uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("smuad %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SMUADX (uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("smuadx %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SMLAD (uint32_t op1, uint32_t op2, uint32_t op3) +{ + uint32_t result; + + __ASM volatile ("smlad %0, %1, %2, %3" : "=r" (result) : "r" (op1), "r" (op2), "r" (op3) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SMLADX (uint32_t op1, uint32_t op2, uint32_t op3) +{ + uint32_t result; + + __ASM volatile ("smladx %0, %1, %2, %3" : "=r" (result) : "r" (op1), "r" (op2), "r" (op3) ); + return(result); +} + +#define __SMLALD(ARG1,ARG2,ARG3) \ +({ \ + uint32_t __ARG1 = (ARG1), __ARG2 = (ARG2), __ARG3_H = (uint32_t)((uint64_t)(ARG3) >> 32), __ARG3_L = (uint32_t)((uint64_t)(ARG3) & 0xFFFFFFFFUL); \ + __ASM volatile ("smlald %0, %1, %2, %3" : "=r" (__ARG3_L), "=r" (__ARG3_H) : "r" (__ARG1), "r" (__ARG2), "0" (__ARG3_L), "1" (__ARG3_H) ); \ + (uint64_t)(((uint64_t)__ARG3_H << 32) | __ARG3_L); \ + }) + +#define __SMLALDX(ARG1,ARG2,ARG3) \ +({ \ + uint32_t __ARG1 = (ARG1), __ARG2 = (ARG2), __ARG3_H = (uint32_t)((uint64_t)(ARG3) >> 32), __ARG3_L = (uint32_t)((uint64_t)(ARG3) & 0xFFFFFFFFUL); \ + __ASM volatile ("smlaldx %0, %1, %2, %3" : "=r" (__ARG3_L), "=r" (__ARG3_H) : "r" (__ARG1), "r" (__ARG2), "0" (__ARG3_L), "1" (__ARG3_H) ); \ + (uint64_t)(((uint64_t)__ARG3_H << 32) | __ARG3_L); \ + }) + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SMUSD (uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("smusd %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SMUSDX (uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("smusdx %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SMLSD (uint32_t op1, uint32_t op2, uint32_t op3) +{ + uint32_t result; + + __ASM volatile ("smlsd %0, %1, %2, %3" : "=r" (result) : "r" (op1), "r" (op2), "r" (op3) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SMLSDX (uint32_t op1, uint32_t op2, uint32_t op3) +{ + uint32_t result; + + __ASM volatile ("smlsdx %0, %1, %2, %3" : "=r" (result) : "r" (op1), "r" (op2), "r" (op3) ); + return(result); +} + +#define __SMLSLD(ARG1,ARG2,ARG3) \ +({ \ + uint32_t __ARG1 = (ARG1), __ARG2 = (ARG2), __ARG3_H = (uint32_t)((ARG3) >> 32), __ARG3_L = (uint32_t)((ARG3) & 0xFFFFFFFFUL); \ + __ASM volatile ("smlsld %0, %1, %2, %3" : "=r" (__ARG3_L), "=r" (__ARG3_H) : "r" (__ARG1), "r" (__ARG2), "0" (__ARG3_L), "1" (__ARG3_H) ); \ + (uint64_t)(((uint64_t)__ARG3_H << 32) | __ARG3_L); \ + }) + +#define __SMLSLDX(ARG1,ARG2,ARG3) \ +({ \ + uint32_t __ARG1 = (ARG1), __ARG2 = (ARG2), __ARG3_H = (uint32_t)((ARG3) >> 32), __ARG3_L = (uint32_t)((ARG3) & 0xFFFFFFFFUL); \ + __ASM volatile ("smlsldx %0, %1, %2, %3" : "=r" (__ARG3_L), "=r" (__ARG3_H) : "r" (__ARG1), "r" (__ARG2), "0" (__ARG3_L), "1" (__ARG3_H) ); \ + (uint64_t)(((uint64_t)__ARG3_H << 32) | __ARG3_L); \ + }) + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SEL (uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("sel %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __QADD(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("qadd %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __QSUB(uint32_t op1, uint32_t op2) +{ + uint32_t result; + + __ASM volatile ("qsub %0, %1, %2" : "=r" (result) : "r" (op1), "r" (op2) ); + return(result); +} + +#define __PKHBT(ARG1,ARG2,ARG3) \ +({ \ + uint32_t __RES, __ARG1 = (ARG1), __ARG2 = (ARG2); \ + __ASM ("pkhbt %0, %1, %2, lsl %3" : "=r" (__RES) : "r" (__ARG1), "r" (__ARG2), "I" (ARG3) ); \ + __RES; \ + }) + +#define __PKHTB(ARG1,ARG2,ARG3) \ +({ \ + uint32_t __RES, __ARG1 = (ARG1), __ARG2 = (ARG2); \ + if (ARG3 == 0) \ + __ASM ("pkhtb %0, %1, %2" : "=r" (__RES) : "r" (__ARG1), "r" (__ARG2) ); \ + else \ + __ASM ("pkhtb %0, %1, %2, asr %3" : "=r" (__RES) : "r" (__ARG1), "r" (__ARG2), "I" (ARG3) ); \ + __RES; \ + }) + +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __SMMLA (int32_t op1, int32_t op2, int32_t op3) +{ + int32_t result; + + __ASM volatile ("smmla %0, %1, %2, %3" : "=r" (result): "r" (op1), "r" (op2), "r" (op3) ); + return(result); +} + +/*-- End CM4 SIMD Intrinsics -----------------------------------------------------*/ + + + +#elif defined ( __TASKING__ ) /*------------------ TASKING Compiler --------------*/ +/* TASKING carm specific functions */ + + +/*------ CM4 SIMD Intrinsics -----------------------------------------------------*/ +/* not yet supported */ +/*-- End CM4 SIMD Intrinsics -----------------------------------------------------*/ + + +#endif + +/*@} end of group CMSIS_SIMD_intrinsics */ + + +#endif /* __CORE_CM4_SIMD_H */ + +#ifdef __cplusplus +} +#endif diff --git a/CORE/core_cmFunc.h b/CORE/core_cmFunc.h new file mode 100644 index 0000000..0a18faf --- /dev/null +++ b/CORE/core_cmFunc.h @@ -0,0 +1,636 @@ +/**************************************************************************//** + * @file core_cmFunc.h + * @brief CMSIS Cortex-M Core Function Access Header File + * @version V3.20 + * @date 25. February 2013 + * + * @note + * + ******************************************************************************/ +/* Copyright (c) 2009 - 2013 ARM LIMITED + + All rights reserved. + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions are met: + - Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + - Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + - Neither the name of ARM nor the names of its contributors may be used + to endorse or promote products derived from this software without + specific prior written permission. + * + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" + AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDERS AND CONTRIBUTORS BE + LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR + CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF + SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) + ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE + POSSIBILITY OF SUCH DAMAGE. + ---------------------------------------------------------------------------*/ + + +#ifndef __CORE_CMFUNC_H +#define __CORE_CMFUNC_H + + +/* ########################### Core Function Access ########################### */ +/** \ingroup CMSIS_Core_FunctionInterface + \defgroup CMSIS_Core_RegAccFunctions CMSIS Core Register Access Functions + @{ + */ + +#if defined ( __CC_ARM ) /*------------------RealView Compiler -----------------*/ +/* ARM armcc specific functions */ + +#if (__ARMCC_VERSION < 400677) + #error "Please use ARM Compiler Toolchain V4.0.677 or later!" +#endif + +/* intrinsic void __enable_irq(); */ +/* intrinsic void __disable_irq(); */ + +/** \brief Get Control Register + + This function returns the content of the Control Register. + + \return Control Register value + */ +__STATIC_INLINE uint32_t __get_CONTROL(void) +{ + register uint32_t __regControl __ASM("control"); + return(__regControl); +} + + +/** \brief Set Control Register + + This function writes the given value to the Control Register. + + \param [in] control Control Register value to set + */ +__STATIC_INLINE void __set_CONTROL(uint32_t control) +{ + register uint32_t __regControl __ASM("control"); + __regControl = control; +} + + +/** \brief Get IPSR Register + + This function returns the content of the IPSR Register. + + \return IPSR Register value + */ +__STATIC_INLINE uint32_t __get_IPSR(void) +{ + register uint32_t __regIPSR __ASM("ipsr"); + return(__regIPSR); +} + + +/** \brief Get APSR Register + + This function returns the content of the APSR Register. + + \return APSR Register value + */ +__STATIC_INLINE uint32_t __get_APSR(void) +{ + register uint32_t __regAPSR __ASM("apsr"); + return(__regAPSR); +} + + +/** \brief Get xPSR Register + + This function returns the content of the xPSR Register. + + \return xPSR Register value + */ +__STATIC_INLINE uint32_t __get_xPSR(void) +{ + register uint32_t __regXPSR __ASM("xpsr"); + return(__regXPSR); +} + + +/** \brief Get Process Stack Pointer + + This function returns the current value of the Process Stack Pointer (PSP). + + \return PSP Register value + */ +__STATIC_INLINE uint32_t __get_PSP(void) +{ + register uint32_t __regProcessStackPointer __ASM("psp"); + return(__regProcessStackPointer); +} + + +/** \brief Set Process Stack Pointer + + This function assigns the given value to the Process Stack Pointer (PSP). + + \param [in] topOfProcStack Process Stack Pointer value to set + */ +__STATIC_INLINE void __set_PSP(uint32_t topOfProcStack) +{ + register uint32_t __regProcessStackPointer __ASM("psp"); + __regProcessStackPointer = topOfProcStack; +} + + +/** \brief Get Main Stack Pointer + + This function returns the current value of the Main Stack Pointer (MSP). + + \return MSP Register value + */ +__STATIC_INLINE uint32_t __get_MSP(void) +{ + register uint32_t __regMainStackPointer __ASM("msp"); + return(__regMainStackPointer); +} + + +/** \brief Set Main Stack Pointer + + This function assigns the given value to the Main Stack Pointer (MSP). + + \param [in] topOfMainStack Main Stack Pointer value to set + */ +__STATIC_INLINE void __set_MSP(uint32_t topOfMainStack) +{ + register uint32_t __regMainStackPointer __ASM("msp"); + __regMainStackPointer = topOfMainStack; +} + + +/** \brief Get Priority Mask + + This function returns the current state of the priority mask bit from the Priority Mask Register. + + \return Priority Mask value + */ +__STATIC_INLINE uint32_t __get_PRIMASK(void) +{ + register uint32_t __regPriMask __ASM("primask"); + return(__regPriMask); +} + + +/** \brief Set Priority Mask + + This function assigns the given value to the Priority Mask Register. + + \param [in] priMask Priority Mask + */ +__STATIC_INLINE void __set_PRIMASK(uint32_t priMask) +{ + register uint32_t __regPriMask __ASM("primask"); + __regPriMask = (priMask); +} + + +#if (__CORTEX_M >= 0x03) + +/** \brief Enable FIQ + + This function enables FIQ interrupts by clearing the F-bit in the CPSR. + Can only be executed in Privileged modes. + */ +#define __enable_fault_irq __enable_fiq + + +/** \brief Disable FIQ + + This function disables FIQ interrupts by setting the F-bit in the CPSR. + Can only be executed in Privileged modes. + */ +#define __disable_fault_irq __disable_fiq + + +/** \brief Get Base Priority + + This function returns the current value of the Base Priority register. + + \return Base Priority register value + */ +__STATIC_INLINE uint32_t __get_BASEPRI(void) +{ + register uint32_t __regBasePri __ASM("basepri"); + return(__regBasePri); +} + + +/** \brief Set Base Priority + + This function assigns the given value to the Base Priority register. + + \param [in] basePri Base Priority value to set + */ +__STATIC_INLINE void __set_BASEPRI(uint32_t basePri) +{ + register uint32_t __regBasePri __ASM("basepri"); + __regBasePri = (basePri & 0xff); +} + + +/** \brief Get Fault Mask + + This function returns the current value of the Fault Mask register. + + \return Fault Mask register value + */ +__STATIC_INLINE uint32_t __get_FAULTMASK(void) +{ + register uint32_t __regFaultMask __ASM("faultmask"); + return(__regFaultMask); +} + + +/** \brief Set Fault Mask + + This function assigns the given value to the Fault Mask register. + + \param [in] faultMask Fault Mask value to set + */ +__STATIC_INLINE void __set_FAULTMASK(uint32_t faultMask) +{ + register uint32_t __regFaultMask __ASM("faultmask"); + __regFaultMask = (faultMask & (uint32_t)1); +} + +#endif /* (__CORTEX_M >= 0x03) */ + + +#if (__CORTEX_M == 0x04) + +/** \brief Get FPSCR + + This function returns the current value of the Floating Point Status/Control register. + + \return Floating Point Status/Control register value + */ +__STATIC_INLINE uint32_t __get_FPSCR(void) +{ +#if (__FPU_PRESENT == 1) && (__FPU_USED == 1) + register uint32_t __regfpscr __ASM("fpscr"); + return(__regfpscr); +#else + return(0); +#endif +} + + +/** \brief Set FPSCR + + This function assigns the given value to the Floating Point Status/Control register. + + \param [in] fpscr Floating Point Status/Control value to set + */ +__STATIC_INLINE void __set_FPSCR(uint32_t fpscr) +{ +#if (__FPU_PRESENT == 1) && (__FPU_USED == 1) + register uint32_t __regfpscr __ASM("fpscr"); + __regfpscr = (fpscr); +#endif +} + +#endif /* (__CORTEX_M == 0x04) */ + + +#elif defined ( __ICCARM__ ) /*------------------ ICC Compiler -------------------*/ +/* IAR iccarm specific functions */ + +#include + + +#elif defined ( __TMS470__ ) /*---------------- TI CCS Compiler ------------------*/ +/* TI CCS specific functions */ + +#include + + +#elif defined ( __GNUC__ ) /*------------------ GNU Compiler ---------------------*/ +/* GNU gcc specific functions */ + +/** \brief Enable IRQ Interrupts + + This function enables IRQ interrupts by clearing the I-bit in the CPSR. + Can only be executed in Privileged modes. + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE void __enable_irq(void) +{ + __ASM volatile ("cpsie i" : : : "memory"); +} + + +/** \brief Disable IRQ Interrupts + + This function disables IRQ interrupts by setting the I-bit in the CPSR. + Can only be executed in Privileged modes. + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE void __disable_irq(void) +{ + __ASM volatile ("cpsid i" : : : "memory"); +} + + +/** \brief Get Control Register + + This function returns the content of the Control Register. + + \return Control Register value + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __get_CONTROL(void) +{ + uint32_t result; + + __ASM volatile ("MRS %0, control" : "=r" (result) ); + return(result); +} + + +/** \brief Set Control Register + + This function writes the given value to the Control Register. + + \param [in] control Control Register value to set + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE void __set_CONTROL(uint32_t control) +{ + __ASM volatile ("MSR control, %0" : : "r" (control) : "memory"); +} + + +/** \brief Get IPSR Register + + This function returns the content of the IPSR Register. + + \return IPSR Register value + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __get_IPSR(void) +{ + uint32_t result; + + __ASM volatile ("MRS %0, ipsr" : "=r" (result) ); + return(result); +} + + +/** \brief Get APSR Register + + This function returns the content of the APSR Register. + + \return APSR Register value + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __get_APSR(void) +{ + uint32_t result; + + __ASM volatile ("MRS %0, apsr" : "=r" (result) ); + return(result); +} + + +/** \brief Get xPSR Register + + This function returns the content of the xPSR Register. + + \return xPSR Register value + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __get_xPSR(void) +{ + uint32_t result; + + __ASM volatile ("MRS %0, xpsr" : "=r" (result) ); + return(result); +} + + +/** \brief Get Process Stack Pointer + + This function returns the current value of the Process Stack Pointer (PSP). + + \return PSP Register value + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __get_PSP(void) +{ + register uint32_t result; + + __ASM volatile ("MRS %0, psp\n" : "=r" (result) ); + return(result); +} + + +/** \brief Set Process Stack Pointer + + This function assigns the given value to the Process Stack Pointer (PSP). + + \param [in] topOfProcStack Process Stack Pointer value to set + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE void __set_PSP(uint32_t topOfProcStack) +{ + __ASM volatile ("MSR psp, %0\n" : : "r" (topOfProcStack) : "sp"); +} + + +/** \brief Get Main Stack Pointer + + This function returns the current value of the Main Stack Pointer (MSP). + + \return MSP Register value + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __get_MSP(void) +{ + register uint32_t result; + + __ASM volatile ("MRS %0, msp\n" : "=r" (result) ); + return(result); +} + + +/** \brief Set Main Stack Pointer + + This function assigns the given value to the Main Stack Pointer (MSP). + + \param [in] topOfMainStack Main Stack Pointer value to set + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE void __set_MSP(uint32_t topOfMainStack) +{ + __ASM volatile ("MSR msp, %0\n" : : "r" (topOfMainStack) : "sp"); +} + + +/** \brief Get Priority Mask + + This function returns the current state of the priority mask bit from the Priority Mask Register. + + \return Priority Mask value + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __get_PRIMASK(void) +{ + uint32_t result; + + __ASM volatile ("MRS %0, primask" : "=r" (result) ); + return(result); +} + + +/** \brief Set Priority Mask + + This function assigns the given value to the Priority Mask Register. + + \param [in] priMask Priority Mask + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE void __set_PRIMASK(uint32_t priMask) +{ + __ASM volatile ("MSR primask, %0" : : "r" (priMask) : "memory"); +} + + +#if (__CORTEX_M >= 0x03) + +/** \brief Enable FIQ + + This function enables FIQ interrupts by clearing the F-bit in the CPSR. + Can only be executed in Privileged modes. + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE void __enable_fault_irq(void) +{ + __ASM volatile ("cpsie f" : : : "memory"); +} + + +/** \brief Disable FIQ + + This function disables FIQ interrupts by setting the F-bit in the CPSR. + Can only be executed in Privileged modes. + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE void __disable_fault_irq(void) +{ + __ASM volatile ("cpsid f" : : : "memory"); +} + + +/** \brief Get Base Priority + + This function returns the current value of the Base Priority register. + + \return Base Priority register value + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __get_BASEPRI(void) +{ + uint32_t result; + + __ASM volatile ("MRS %0, basepri_max" : "=r" (result) ); + return(result); +} + + +/** \brief Set Base Priority + + This function assigns the given value to the Base Priority register. + + \param [in] basePri Base Priority value to set + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE void __set_BASEPRI(uint32_t value) +{ + __ASM volatile ("MSR basepri, %0" : : "r" (value) : "memory"); +} + + +/** \brief Get Fault Mask + + This function returns the current value of the Fault Mask register. + + \return Fault Mask register value + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __get_FAULTMASK(void) +{ + uint32_t result; + + __ASM volatile ("MRS %0, faultmask" : "=r" (result) ); + return(result); +} + + +/** \brief Set Fault Mask + + This function assigns the given value to the Fault Mask register. + + \param [in] faultMask Fault Mask value to set + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE void __set_FAULTMASK(uint32_t faultMask) +{ + __ASM volatile ("MSR faultmask, %0" : : "r" (faultMask) : "memory"); +} + +#endif /* (__CORTEX_M >= 0x03) */ + + +#if (__CORTEX_M == 0x04) + +/** \brief Get FPSCR + + This function returns the current value of the Floating Point Status/Control register. + + \return Floating Point Status/Control register value + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __get_FPSCR(void) +{ +#if (__FPU_PRESENT == 1) && (__FPU_USED == 1) + uint32_t result; + + /* Empty asm statement works as a scheduling barrier */ + __ASM volatile (""); + __ASM volatile ("VMRS %0, fpscr" : "=r" (result) ); + __ASM volatile (""); + return(result); +#else + return(0); +#endif +} + + +/** \brief Set FPSCR + + This function assigns the given value to the Floating Point Status/Control register. + + \param [in] fpscr Floating Point Status/Control value to set + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE void __set_FPSCR(uint32_t fpscr) +{ +#if (__FPU_PRESENT == 1) && (__FPU_USED == 1) + /* Empty asm statement works as a scheduling barrier */ + __ASM volatile (""); + __ASM volatile ("VMSR fpscr, %0" : : "r" (fpscr) : "vfpcc"); + __ASM volatile (""); +#endif +} + +#endif /* (__CORTEX_M == 0x04) */ + + +#elif defined ( __TASKING__ ) /*------------------ TASKING Compiler --------------*/ +/* TASKING carm specific functions */ + +/* + * The CMSIS functions have been implemented as intrinsics in the compiler. + * Please use "carm -?i" to get an up to date list of all instrinsics, + * Including the CMSIS ones. + */ + +#endif + +/*@} end of CMSIS_Core_RegAccFunctions */ + + +#endif /* __CORE_CMFUNC_H */ diff --git a/CORE/core_cmInstr.h b/CORE/core_cmInstr.h new file mode 100644 index 0000000..d213f0e --- /dev/null +++ b/CORE/core_cmInstr.h @@ -0,0 +1,688 @@ +/**************************************************************************//** + * @file core_cmInstr.h + * @brief CMSIS Cortex-M Core Instruction Access Header File + * @version V3.20 + * @date 05. March 2013 + * + * @note + * + ******************************************************************************/ +/* Copyright (c) 2009 - 2013 ARM LIMITED + + All rights reserved. + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions are met: + - Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + - Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + - Neither the name of ARM nor the names of its contributors may be used + to endorse or promote products derived from this software without + specific prior written permission. + * + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" + AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDERS AND CONTRIBUTORS BE + LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR + CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF + SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) + ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE + POSSIBILITY OF SUCH DAMAGE. + ---------------------------------------------------------------------------*/ + + +#ifndef __CORE_CMINSTR_H +#define __CORE_CMINSTR_H + + +/* ########################## Core Instruction Access ######################### */ +/** \defgroup CMSIS_Core_InstructionInterface CMSIS Core Instruction Interface + Access to dedicated instructions + @{ +*/ + +#if defined ( __CC_ARM ) /*------------------RealView Compiler -----------------*/ +/* ARM armcc specific functions */ + +#if (__ARMCC_VERSION < 400677) + #error "Please use ARM Compiler Toolchain V4.0.677 or later!" +#endif + + +/** \brief No Operation + + No Operation does nothing. This instruction can be used for code alignment purposes. + */ +#define __NOP __nop + + +/** \brief Wait For Interrupt + + Wait For Interrupt is a hint instruction that suspends execution + until one of a number of events occurs. + */ +#define __WFI __wfi + + +/** \brief Wait For Event + + Wait For Event is a hint instruction that permits the processor to enter + a low-power state until one of a number of events occurs. + */ +#define __WFE __wfe + + +/** \brief Send Event + + Send Event is a hint instruction. It causes an event to be signaled to the CPU. + */ +#define __SEV __sev + + +/** \brief Instruction Synchronization Barrier + + Instruction Synchronization Barrier flushes the pipeline in the processor, + so that all instructions following the ISB are fetched from cache or + memory, after the instruction has been completed. + */ +#define __ISB() __isb(0xF) + + +/** \brief Data Synchronization Barrier + + This function acts as a special kind of Data Memory Barrier. + It completes when all explicit memory accesses before this instruction complete. + */ +#define __DSB() __dsb(0xF) + + +/** \brief Data Memory Barrier + + This function ensures the apparent order of the explicit memory operations before + and after the instruction, without ensuring their completion. + */ +#define __DMB() __dmb(0xF) + + +/** \brief Reverse byte order (32 bit) + + This function reverses the byte order in integer value. + + \param [in] value Value to reverse + \return Reversed value + */ +#define __REV __rev + + +/** \brief Reverse byte order (16 bit) + + This function reverses the byte order in two unsigned short values. + + \param [in] value Value to reverse + \return Reversed value + */ +#ifndef __NO_EMBEDDED_ASM +__attribute__((section(".rev16_text"))) __STATIC_INLINE __ASM uint32_t __REV16(uint32_t value) +{ + rev16 r0, r0 + bx lr +} +#endif + +/** \brief Reverse byte order in signed short value + + This function reverses the byte order in a signed short value with sign extension to integer. + + \param [in] value Value to reverse + \return Reversed value + */ +#ifndef __NO_EMBEDDED_ASM +__attribute__((section(".revsh_text"))) __STATIC_INLINE __ASM int32_t __REVSH(int32_t value) +{ + revsh r0, r0 + bx lr +} +#endif + + +/** \brief Rotate Right in unsigned value (32 bit) + + This function Rotate Right (immediate) provides the value of the contents of a register rotated by a variable number of bits. + + \param [in] value Value to rotate + \param [in] value Number of Bits to rotate + \return Rotated value + */ +#define __ROR __ror + + +/** \brief Breakpoint + + This function causes the processor to enter Debug state. + Debug tools can use this to investigate system state when the instruction at a particular address is reached. + + \param [in] value is ignored by the processor. + If required, a debugger can use it to store additional information about the breakpoint. + */ +#define __BKPT(value) __breakpoint(value) + + +#if (__CORTEX_M >= 0x03) + +/** \brief Reverse bit order of value + + This function reverses the bit order of the given value. + + \param [in] value Value to reverse + \return Reversed value + */ +#define __RBIT __rbit + + +/** \brief LDR Exclusive (8 bit) + + This function performs a exclusive LDR command for 8 bit value. + + \param [in] ptr Pointer to data + \return value of type uint8_t at (*ptr) + */ +#define __LDREXB(ptr) ((uint8_t ) __ldrex(ptr)) + + +/** \brief LDR Exclusive (16 bit) + + This function performs a exclusive LDR command for 16 bit values. + + \param [in] ptr Pointer to data + \return value of type uint16_t at (*ptr) + */ +#define __LDREXH(ptr) ((uint16_t) __ldrex(ptr)) + + +/** \brief LDR Exclusive (32 bit) + + This function performs a exclusive LDR command for 32 bit values. + + \param [in] ptr Pointer to data + \return value of type uint32_t at (*ptr) + */ +#define __LDREXW(ptr) ((uint32_t ) __ldrex(ptr)) + + +/** \brief STR Exclusive (8 bit) + + This function performs a exclusive STR command for 8 bit values. + + \param [in] value Value to store + \param [in] ptr Pointer to location + \return 0 Function succeeded + \return 1 Function failed + */ +#define __STREXB(value, ptr) __strex(value, ptr) + + +/** \brief STR Exclusive (16 bit) + + This function performs a exclusive STR command for 16 bit values. + + \param [in] value Value to store + \param [in] ptr Pointer to location + \return 0 Function succeeded + \return 1 Function failed + */ +#define __STREXH(value, ptr) __strex(value, ptr) + + +/** \brief STR Exclusive (32 bit) + + This function performs a exclusive STR command for 32 bit values. + + \param [in] value Value to store + \param [in] ptr Pointer to location + \return 0 Function succeeded + \return 1 Function failed + */ +#define __STREXW(value, ptr) __strex(value, ptr) + + +/** \brief Remove the exclusive lock + + This function removes the exclusive lock which is created by LDREX. + + */ +#define __CLREX __clrex + + +/** \brief Signed Saturate + + This function saturates a signed value. + + \param [in] value Value to be saturated + \param [in] sat Bit position to saturate to (1..32) + \return Saturated value + */ +#define __SSAT __ssat + + +/** \brief Unsigned Saturate + + This function saturates an unsigned value. + + \param [in] value Value to be saturated + \param [in] sat Bit position to saturate to (0..31) + \return Saturated value + */ +#define __USAT __usat + + +/** \brief Count leading zeros + + This function counts the number of leading zeros of a data value. + + \param [in] value Value to count the leading zeros + \return number of leading zeros in value + */ +#define __CLZ __clz + +#endif /* (__CORTEX_M >= 0x03) */ + + + +#elif defined ( __ICCARM__ ) /*------------------ ICC Compiler -------------------*/ +/* IAR iccarm specific functions */ + +#include + + +#elif defined ( __TMS470__ ) /*---------------- TI CCS Compiler ------------------*/ +/* TI CCS specific functions */ + +#include + + +#elif defined ( __GNUC__ ) /*------------------ GNU Compiler ---------------------*/ +/* GNU gcc specific functions */ + +/* Define macros for porting to both thumb1 and thumb2. + * For thumb1, use low register (r0-r7), specified by constrant "l" + * Otherwise, use general registers, specified by constrant "r" */ +#if defined (__thumb__) && !defined (__thumb2__) +#define __CMSIS_GCC_OUT_REG(r) "=l" (r) +#define __CMSIS_GCC_USE_REG(r) "l" (r) +#else +#define __CMSIS_GCC_OUT_REG(r) "=r" (r) +#define __CMSIS_GCC_USE_REG(r) "r" (r) +#endif + +/** \brief No Operation + + No Operation does nothing. This instruction can be used for code alignment purposes. + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE void __NOP(void) +{ + __ASM volatile ("nop"); +} + + +/** \brief Wait For Interrupt + + Wait For Interrupt is a hint instruction that suspends execution + until one of a number of events occurs. + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE void __WFI(void) +{ + __ASM volatile ("wfi"); +} + + +/** \brief Wait For Event + + Wait For Event is a hint instruction that permits the processor to enter + a low-power state until one of a number of events occurs. + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE void __WFE(void) +{ + __ASM volatile ("wfe"); +} + + +/** \brief Send Event + + Send Event is a hint instruction. It causes an event to be signaled to the CPU. + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE void __SEV(void) +{ + __ASM volatile ("sev"); +} + + +/** \brief Instruction Synchronization Barrier + + Instruction Synchronization Barrier flushes the pipeline in the processor, + so that all instructions following the ISB are fetched from cache or + memory, after the instruction has been completed. + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE void __ISB(void) +{ + __ASM volatile ("isb"); +} + + +/** \brief Data Synchronization Barrier + + This function acts as a special kind of Data Memory Barrier. + It completes when all explicit memory accesses before this instruction complete. + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE void __DSB(void) +{ + __ASM volatile ("dsb"); +} + + +/** \brief Data Memory Barrier + + This function ensures the apparent order of the explicit memory operations before + and after the instruction, without ensuring their completion. + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE void __DMB(void) +{ + __ASM volatile ("dmb"); +} + + +/** \brief Reverse byte order (32 bit) + + This function reverses the byte order in integer value. + + \param [in] value Value to reverse + \return Reversed value + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __REV(uint32_t value) +{ +#if (__GNUC__ > 4) || (__GNUC__ == 4 && __GNUC_MINOR__ >= 5) + return __builtin_bswap32(value); +#else + uint32_t result; + + __ASM volatile ("rev %0, %1" : __CMSIS_GCC_OUT_REG (result) : __CMSIS_GCC_USE_REG (value) ); + return(result); +#endif +} + + +/** \brief Reverse byte order (16 bit) + + This function reverses the byte order in two unsigned short values. + + \param [in] value Value to reverse + \return Reversed value + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __REV16(uint32_t value) +{ + uint32_t result; + + __ASM volatile ("rev16 %0, %1" : __CMSIS_GCC_OUT_REG (result) : __CMSIS_GCC_USE_REG (value) ); + return(result); +} + + +/** \brief Reverse byte order in signed short value + + This function reverses the byte order in a signed short value with sign extension to integer. + + \param [in] value Value to reverse + \return Reversed value + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE int32_t __REVSH(int32_t value) +{ +#if (__GNUC__ > 4) || (__GNUC__ == 4 && __GNUC_MINOR__ >= 8) + return (short)__builtin_bswap16(value); +#else + uint32_t result; + + __ASM volatile ("revsh %0, %1" : __CMSIS_GCC_OUT_REG (result) : __CMSIS_GCC_USE_REG (value) ); + return(result); +#endif +} + + +/** \brief Rotate Right in unsigned value (32 bit) + + This function Rotate Right (immediate) provides the value of the contents of a register rotated by a variable number of bits. + + \param [in] value Value to rotate + \param [in] value Number of Bits to rotate + \return Rotated value + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __ROR(uint32_t op1, uint32_t op2) +{ + return (op1 >> op2) | (op1 << (32 - op2)); +} + + +/** \brief Breakpoint + + This function causes the processor to enter Debug state. + Debug tools can use this to investigate system state when the instruction at a particular address is reached. + + \param [in] value is ignored by the processor. + If required, a debugger can use it to store additional information about the breakpoint. + */ +#define __BKPT(value) __ASM volatile ("bkpt "#value) + + +#if (__CORTEX_M >= 0x03) + +/** \brief Reverse bit order of value + + This function reverses the bit order of the given value. + + \param [in] value Value to reverse + \return Reversed value + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __RBIT(uint32_t value) +{ + uint32_t result; + + __ASM volatile ("rbit %0, %1" : "=r" (result) : "r" (value) ); + return(result); +} + + +/** \brief LDR Exclusive (8 bit) + + This function performs a exclusive LDR command for 8 bit value. + + \param [in] ptr Pointer to data + \return value of type uint8_t at (*ptr) + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE uint8_t __LDREXB(volatile uint8_t *addr) +{ + uint32_t result; + +#if (__GNUC__ > 4) || (__GNUC__ == 4 && __GNUC_MINOR__ >= 8) + __ASM volatile ("ldrexb %0, %1" : "=r" (result) : "Q" (*addr) ); +#else + /* Prior to GCC 4.8, "Q" will be expanded to [rx, #0] which is not + accepted by assembler. So has to use following less efficient pattern. + */ + __ASM volatile ("ldrexb %0, [%1]" : "=r" (result) : "r" (addr) : "memory" ); +#endif + return(result); +} + + +/** \brief LDR Exclusive (16 bit) + + This function performs a exclusive LDR command for 16 bit values. + + \param [in] ptr Pointer to data + \return value of type uint16_t at (*ptr) + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE uint16_t __LDREXH(volatile uint16_t *addr) +{ + uint32_t result; + +#if (__GNUC__ > 4) || (__GNUC__ == 4 && __GNUC_MINOR__ >= 8) + __ASM volatile ("ldrexh %0, %1" : "=r" (result) : "Q" (*addr) ); +#else + /* Prior to GCC 4.8, "Q" will be expanded to [rx, #0] which is not + accepted by assembler. So has to use following less efficient pattern. + */ + __ASM volatile ("ldrexh %0, [%1]" : "=r" (result) : "r" (addr) : "memory" ); +#endif + return(result); +} + + +/** \brief LDR Exclusive (32 bit) + + This function performs a exclusive LDR command for 32 bit values. + + \param [in] ptr Pointer to data + \return value of type uint32_t at (*ptr) + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __LDREXW(volatile uint32_t *addr) +{ + uint32_t result; + + __ASM volatile ("ldrex %0, %1" : "=r" (result) : "Q" (*addr) ); + return(result); +} + + +/** \brief STR Exclusive (8 bit) + + This function performs a exclusive STR command for 8 bit values. + + \param [in] value Value to store + \param [in] ptr Pointer to location + \return 0 Function succeeded + \return 1 Function failed + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __STREXB(uint8_t value, volatile uint8_t *addr) +{ + uint32_t result; + + __ASM volatile ("strexb %0, %2, %1" : "=&r" (result), "=Q" (*addr) : "r" (value) ); + return(result); +} + + +/** \brief STR Exclusive (16 bit) + + This function performs a exclusive STR command for 16 bit values. + + \param [in] value Value to store + \param [in] ptr Pointer to location + \return 0 Function succeeded + \return 1 Function failed + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __STREXH(uint16_t value, volatile uint16_t *addr) +{ + uint32_t result; + + __ASM volatile ("strexh %0, %2, %1" : "=&r" (result), "=Q" (*addr) : "r" (value) ); + return(result); +} + + +/** \brief STR Exclusive (32 bit) + + This function performs a exclusive STR command for 32 bit values. + + \param [in] value Value to store + \param [in] ptr Pointer to location + \return 0 Function succeeded + \return 1 Function failed + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE uint32_t __STREXW(uint32_t value, volatile uint32_t *addr) +{ + uint32_t result; + + __ASM volatile ("strex %0, %2, %1" : "=&r" (result), "=Q" (*addr) : "r" (value) ); + return(result); +} + + +/** \brief Remove the exclusive lock + + This function removes the exclusive lock which is created by LDREX. + + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE void __CLREX(void) +{ + __ASM volatile ("clrex" ::: "memory"); +} + + +/** \brief Signed Saturate + + This function saturates a signed value. + + \param [in] value Value to be saturated + \param [in] sat Bit position to saturate to (1..32) + \return Saturated value + */ +#define __SSAT(ARG1,ARG2) \ +({ \ + uint32_t __RES, __ARG1 = (ARG1); \ + __ASM ("ssat %0, %1, %2" : "=r" (__RES) : "I" (ARG2), "r" (__ARG1) ); \ + __RES; \ + }) + + +/** \brief Unsigned Saturate + + This function saturates an unsigned value. + + \param [in] value Value to be saturated + \param [in] sat Bit position to saturate to (0..31) + \return Saturated value + */ +#define __USAT(ARG1,ARG2) \ +({ \ + uint32_t __RES, __ARG1 = (ARG1); \ + __ASM ("usat %0, %1, %2" : "=r" (__RES) : "I" (ARG2), "r" (__ARG1) ); \ + __RES; \ + }) + + +/** \brief Count leading zeros + + This function counts the number of leading zeros of a data value. + + \param [in] value Value to count the leading zeros + \return number of leading zeros in value + */ +__attribute__( ( always_inline ) ) __STATIC_INLINE uint8_t __CLZ(uint32_t value) +{ + uint32_t result; + + __ASM volatile ("clz %0, %1" : "=r" (result) : "r" (value) ); + return(result); +} + +#endif /* (__CORTEX_M >= 0x03) */ + + + + +#elif defined ( __TASKING__ ) /*------------------ TASKING Compiler --------------*/ +/* TASKING carm specific functions */ + +/* + * The CMSIS functions have been implemented as intrinsics in the compiler. + * Please use "carm -?i" to get an up to date list of all intrinsics, + * Including the CMSIS ones. + */ + +#endif + +/*@}*/ /* end of group CMSIS_Core_InstructionInterface */ + +#endif /* __CORE_CMINSTR_H */ diff --git a/CORE/startup_stm32f40_41xxx.s b/CORE/startup_stm32f40_41xxx.s new file mode 100644 index 0000000..340871f --- /dev/null +++ b/CORE/startup_stm32f40_41xxx.s @@ -0,0 +1,434 @@ +;******************** (C) COPYRIGHT 2014 STMicroelectronics ******************** +;* File Name : startup_stm32f40_41xxx.s +;* Author : MCD Application Team +;* @version : V1.4.0 +;* @date : 04-August-2014 +;* Description : STM32F40xxx/41xxx devices vector table for MDK-ARM toolchain. +;* This module performs: +;* - Set the initial SP +;* - Set the initial PC == Reset_Handler +;* - Set the vector table entries with the exceptions ISR address +;* - Configure the system clock and the external SRAM mounted on +;* STM324xG-EVAL board to be used as data memory (optional, +;* to be enabled by user) +;* - Branches to __main in the C library (which eventually +;* calls main()). +;* After Reset the CortexM4 processor is in Thread mode, +;* priority is Privileged, and the Stack is set to Main. +;* <<< Use Configuration Wizard in Context Menu >>> +;******************************************************************************* +; +; Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); +; You may not use this file except in compliance with the License. +; You may obtain a copy of the License at: +; +; http://www.st.com/software_license_agreement_liberty_v2 +; +; Unless required by applicable law or agreed to in writing, software +; distributed under the License is distributed on an "AS IS" BASIS, +; WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +; See the License for the specific language governing permissions and +; limitations under the License. +; +;******************************************************************************* + +; Amount of memory (in bytes) allocated for Stack +; Tailor this value to your application needs +; Stack Configuration +; Stack Size (in Bytes) <0x0-0xFFFFFFFF:8> +; + +Stack_Size EQU 0x00000400 + + AREA STACK, NOINIT, READWRITE, ALIGN=3 +Stack_Mem SPACE Stack_Size +__initial_sp + + +; Heap Configuration +; Heap Size (in Bytes) <0x0-0xFFFFFFFF:8> +; + +Heap_Size EQU 0x00000200 + + AREA HEAP, NOINIT, READWRITE, ALIGN=3 +__heap_base +Heap_Mem SPACE Heap_Size +__heap_limit + + PRESERVE8 + THUMB + + +; Vector Table Mapped to Address 0 at Reset + AREA RESET, DATA, READONLY + EXPORT __Vectors + EXPORT __Vectors_End + EXPORT __Vectors_Size + +__Vectors DCD __initial_sp ; Top of Stack + DCD Reset_Handler ; Reset Handler + DCD NMI_Handler ; NMI Handler + DCD HardFault_Handler ; Hard Fault Handler + DCD MemManage_Handler ; MPU Fault Handler + DCD BusFault_Handler ; Bus Fault Handler + DCD UsageFault_Handler ; Usage Fault Handler + DCD 0 ; Reserved + DCD 0 ; Reserved + DCD 0 ; Reserved + DCD 0 ; Reserved + DCD SVC_Handler ; SVCall Handler + DCD DebugMon_Handler ; Debug Monitor Handler + DCD 0 ; Reserved + DCD PendSV_Handler ; PendSV Handler + DCD SysTick_Handler ; SysTick Handler + + ; External Interrupts + DCD WWDG_IRQHandler ; Window WatchDog + DCD PVD_IRQHandler ; PVD through EXTI Line detection + DCD TAMP_STAMP_IRQHandler ; Tamper and TimeStamps through the EXTI line + DCD RTC_WKUP_IRQHandler ; RTC Wakeup through the EXTI line + DCD FLASH_IRQHandler ; FLASH + DCD RCC_IRQHandler ; RCC + DCD EXTI0_IRQHandler ; EXTI Line0 + DCD EXTI1_IRQHandler ; EXTI Line1 + DCD EXTI2_IRQHandler ; EXTI Line2 + DCD EXTI3_IRQHandler ; EXTI Line3 + DCD EXTI4_IRQHandler ; EXTI Line4 + DCD DMA1_Stream0_IRQHandler ; DMA1 Stream 0 + DCD DMA1_Stream1_IRQHandler ; DMA1 Stream 1 + DCD DMA1_Stream2_IRQHandler ; DMA1 Stream 2 + DCD DMA1_Stream3_IRQHandler ; DMA1 Stream 3 + DCD DMA1_Stream4_IRQHandler ; DMA1 Stream 4 + DCD DMA1_Stream5_IRQHandler ; DMA1 Stream 5 + DCD DMA1_Stream6_IRQHandler ; DMA1 Stream 6 + DCD ADC_IRQHandler ; ADC1, ADC2 and ADC3s + DCD CAN1_TX_IRQHandler ; CAN1 TX + DCD CAN1_RX0_IRQHandler ; CAN1 RX0 + DCD CAN1_RX1_IRQHandler ; CAN1 RX1 + DCD CAN1_SCE_IRQHandler ; CAN1 SCE + DCD EXTI9_5_IRQHandler ; External Line[9:5]s + DCD TIM1_BRK_TIM9_IRQHandler ; TIM1 Break and TIM9 + DCD TIM1_UP_TIM10_IRQHandler ; TIM1 Update and TIM10 + DCD TIM1_TRG_COM_TIM11_IRQHandler ; TIM1 Trigger and Commutation and TIM11 + DCD TIM1_CC_IRQHandler ; TIM1 Capture Compare + DCD TIM2_IRQHandler ; TIM2 + DCD TIM3_IRQHandler ; TIM3 + DCD TIM4_IRQHandler ; TIM4 + DCD I2C1_EV_IRQHandler ; I2C1 Event + DCD I2C1_ER_IRQHandler ; I2C1 Error + DCD I2C2_EV_IRQHandler ; I2C2 Event + DCD I2C2_ER_IRQHandler ; I2C2 Error + DCD SPI1_IRQHandler ; SPI1 + DCD SPI2_IRQHandler ; SPI2 + DCD USART1_IRQHandler ; USART1 + DCD USART2_IRQHandler ; USART2 + DCD USART3_IRQHandler ; USART3 + DCD EXTI15_10_IRQHandler ; External Line[15:10]s + DCD RTC_Alarm_IRQHandler ; RTC Alarm (A and B) through EXTI Line + DCD OTG_FS_WKUP_IRQHandler ; USB OTG FS Wakeup through EXTI line + DCD TIM8_BRK_TIM12_IRQHandler ; TIM8 Break and TIM12 + DCD TIM8_UP_TIM13_IRQHandler ; TIM8 Update and TIM13 + DCD TIM8_TRG_COM_TIM14_IRQHandler ; TIM8 Trigger and Commutation and TIM14 + DCD TIM8_CC_IRQHandler ; TIM8 Capture Compare + DCD DMA1_Stream7_IRQHandler ; DMA1 Stream7 + DCD FSMC_IRQHandler ; FSMC + DCD SDIO_IRQHandler ; SDIO + DCD TIM5_IRQHandler ; TIM5 + DCD SPI3_IRQHandler ; SPI3 + DCD UART4_IRQHandler ; UART4 + DCD UART5_IRQHandler ; UART5 + DCD TIM6_DAC_IRQHandler ; TIM6 and DAC1&2 underrun errors + DCD TIM7_IRQHandler ; TIM7 + DCD DMA2_Stream0_IRQHandler ; DMA2 Stream 0 + DCD DMA2_Stream1_IRQHandler ; DMA2 Stream 1 + DCD DMA2_Stream2_IRQHandler ; DMA2 Stream 2 + DCD DMA2_Stream3_IRQHandler ; DMA2 Stream 3 + DCD DMA2_Stream4_IRQHandler ; DMA2 Stream 4 + DCD ETH_IRQHandler ; Ethernet + DCD ETH_WKUP_IRQHandler ; Ethernet Wakeup through EXTI line + DCD CAN2_TX_IRQHandler ; CAN2 TX + DCD CAN2_RX0_IRQHandler ; CAN2 RX0 + DCD CAN2_RX1_IRQHandler ; CAN2 RX1 + DCD CAN2_SCE_IRQHandler ; CAN2 SCE + DCD OTG_FS_IRQHandler ; USB OTG FS + DCD DMA2_Stream5_IRQHandler ; DMA2 Stream 5 + DCD DMA2_Stream6_IRQHandler ; DMA2 Stream 6 + DCD DMA2_Stream7_IRQHandler ; DMA2 Stream 7 + DCD USART6_IRQHandler ; USART6 + DCD I2C3_EV_IRQHandler ; I2C3 event + DCD I2C3_ER_IRQHandler ; I2C3 error + DCD OTG_HS_EP1_OUT_IRQHandler ; USB OTG HS End Point 1 Out + DCD OTG_HS_EP1_IN_IRQHandler ; USB OTG HS End Point 1 In + DCD OTG_HS_WKUP_IRQHandler ; USB OTG HS Wakeup through EXTI + DCD OTG_HS_IRQHandler ; USB OTG HS + DCD DCMI_IRQHandler ; DCMI + DCD CRYP_IRQHandler ; CRYP crypto + DCD HASH_RNG_IRQHandler ; Hash and Rng + DCD FPU_IRQHandler ; FPU + +__Vectors_End + +__Vectors_Size EQU __Vectors_End - __Vectors + + AREA |.text|, CODE, READONLY + +; Reset handler +Reset_Handler PROC + EXPORT Reset_Handler [WEAK] + IMPORT SystemInit + IMPORT __main + + LDR R0, =SystemInit + BLX R0 + LDR R0, =__main + BX R0 + ENDP + +; Dummy Exception Handlers (infinite loops which can be modified) + +NMI_Handler PROC + EXPORT NMI_Handler [WEAK] + B . + ENDP +HardFault_Handler\ + PROC + EXPORT HardFault_Handler [WEAK] + B . + ENDP +MemManage_Handler\ + PROC + EXPORT MemManage_Handler [WEAK] + B . + ENDP +BusFault_Handler\ + PROC + EXPORT BusFault_Handler [WEAK] + B . + ENDP +UsageFault_Handler\ + PROC + EXPORT UsageFault_Handler [WEAK] + B . + ENDP +SVC_Handler PROC + EXPORT SVC_Handler [WEAK] + B . + ENDP +DebugMon_Handler\ + PROC + EXPORT DebugMon_Handler [WEAK] + B . + ENDP +PendSV_Handler PROC + EXPORT PendSV_Handler [WEAK] + B . + ENDP +SysTick_Handler PROC + EXPORT SysTick_Handler [WEAK] + B . + ENDP + +Default_Handler PROC + + EXPORT WWDG_IRQHandler [WEAK] + EXPORT PVD_IRQHandler [WEAK] + EXPORT TAMP_STAMP_IRQHandler [WEAK] + EXPORT RTC_WKUP_IRQHandler [WEAK] + EXPORT FLASH_IRQHandler [WEAK] + EXPORT RCC_IRQHandler [WEAK] + EXPORT EXTI0_IRQHandler [WEAK] + EXPORT EXTI1_IRQHandler [WEAK] + EXPORT EXTI2_IRQHandler [WEAK] + EXPORT EXTI3_IRQHandler [WEAK] + EXPORT EXTI4_IRQHandler [WEAK] + EXPORT DMA1_Stream0_IRQHandler [WEAK] + EXPORT DMA1_Stream1_IRQHandler [WEAK] + EXPORT DMA1_Stream2_IRQHandler [WEAK] + EXPORT DMA1_Stream3_IRQHandler [WEAK] + EXPORT DMA1_Stream4_IRQHandler [WEAK] + EXPORT DMA1_Stream5_IRQHandler [WEAK] + EXPORT DMA1_Stream6_IRQHandler [WEAK] + EXPORT ADC_IRQHandler [WEAK] + EXPORT CAN1_TX_IRQHandler [WEAK] + EXPORT CAN1_RX0_IRQHandler [WEAK] + EXPORT CAN1_RX1_IRQHandler [WEAK] + EXPORT CAN1_SCE_IRQHandler [WEAK] + EXPORT EXTI9_5_IRQHandler [WEAK] + EXPORT TIM1_BRK_TIM9_IRQHandler [WEAK] + EXPORT TIM1_UP_TIM10_IRQHandler [WEAK] + EXPORT TIM1_TRG_COM_TIM11_IRQHandler [WEAK] + EXPORT TIM1_CC_IRQHandler [WEAK] + EXPORT TIM2_IRQHandler [WEAK] + EXPORT TIM3_IRQHandler [WEAK] + EXPORT TIM4_IRQHandler [WEAK] + EXPORT I2C1_EV_IRQHandler [WEAK] + EXPORT I2C1_ER_IRQHandler [WEAK] + EXPORT I2C2_EV_IRQHandler [WEAK] + EXPORT I2C2_ER_IRQHandler [WEAK] + EXPORT SPI1_IRQHandler [WEAK] + EXPORT SPI2_IRQHandler [WEAK] + EXPORT USART1_IRQHandler [WEAK] + EXPORT USART2_IRQHandler [WEAK] + EXPORT USART3_IRQHandler [WEAK] + EXPORT EXTI15_10_IRQHandler [WEAK] + EXPORT RTC_Alarm_IRQHandler [WEAK] + EXPORT OTG_FS_WKUP_IRQHandler [WEAK] + EXPORT TIM8_BRK_TIM12_IRQHandler [WEAK] + EXPORT TIM8_UP_TIM13_IRQHandler [WEAK] + EXPORT TIM8_TRG_COM_TIM14_IRQHandler [WEAK] + EXPORT TIM8_CC_IRQHandler [WEAK] + EXPORT DMA1_Stream7_IRQHandler [WEAK] + EXPORT FSMC_IRQHandler [WEAK] + EXPORT SDIO_IRQHandler [WEAK] + EXPORT TIM5_IRQHandler [WEAK] + EXPORT SPI3_IRQHandler [WEAK] + EXPORT UART4_IRQHandler [WEAK] + EXPORT UART5_IRQHandler [WEAK] + EXPORT TIM6_DAC_IRQHandler [WEAK] + EXPORT TIM7_IRQHandler [WEAK] + EXPORT DMA2_Stream0_IRQHandler [WEAK] + EXPORT DMA2_Stream1_IRQHandler [WEAK] + EXPORT DMA2_Stream2_IRQHandler [WEAK] + EXPORT DMA2_Stream3_IRQHandler [WEAK] + EXPORT DMA2_Stream4_IRQHandler [WEAK] + EXPORT ETH_IRQHandler [WEAK] + EXPORT ETH_WKUP_IRQHandler [WEAK] + EXPORT CAN2_TX_IRQHandler [WEAK] + EXPORT CAN2_RX0_IRQHandler [WEAK] + EXPORT CAN2_RX1_IRQHandler [WEAK] + EXPORT CAN2_SCE_IRQHandler [WEAK] + EXPORT OTG_FS_IRQHandler [WEAK] + EXPORT DMA2_Stream5_IRQHandler [WEAK] + EXPORT DMA2_Stream6_IRQHandler [WEAK] + EXPORT DMA2_Stream7_IRQHandler [WEAK] + EXPORT USART6_IRQHandler [WEAK] + EXPORT I2C3_EV_IRQHandler [WEAK] + EXPORT I2C3_ER_IRQHandler [WEAK] + EXPORT OTG_HS_EP1_OUT_IRQHandler [WEAK] + EXPORT OTG_HS_EP1_IN_IRQHandler [WEAK] + EXPORT OTG_HS_WKUP_IRQHandler [WEAK] + EXPORT OTG_HS_IRQHandler [WEAK] + EXPORT DCMI_IRQHandler [WEAK] + EXPORT CRYP_IRQHandler [WEAK] + EXPORT HASH_RNG_IRQHandler [WEAK] + EXPORT FPU_IRQHandler [WEAK] + +WWDG_IRQHandler +PVD_IRQHandler +TAMP_STAMP_IRQHandler +RTC_WKUP_IRQHandler +FLASH_IRQHandler +RCC_IRQHandler +EXTI0_IRQHandler +EXTI1_IRQHandler +EXTI2_IRQHandler +EXTI3_IRQHandler +EXTI4_IRQHandler +DMA1_Stream0_IRQHandler +DMA1_Stream1_IRQHandler +DMA1_Stream2_IRQHandler +DMA1_Stream3_IRQHandler +DMA1_Stream4_IRQHandler +DMA1_Stream5_IRQHandler +DMA1_Stream6_IRQHandler +ADC_IRQHandler +CAN1_TX_IRQHandler +CAN1_RX0_IRQHandler +CAN1_RX1_IRQHandler +CAN1_SCE_IRQHandler +EXTI9_5_IRQHandler +TIM1_BRK_TIM9_IRQHandler +TIM1_UP_TIM10_IRQHandler +TIM1_TRG_COM_TIM11_IRQHandler +TIM1_CC_IRQHandler +TIM2_IRQHandler +TIM3_IRQHandler +TIM4_IRQHandler +I2C1_EV_IRQHandler +I2C1_ER_IRQHandler +I2C2_EV_IRQHandler +I2C2_ER_IRQHandler +SPI1_IRQHandler +SPI2_IRQHandler +USART1_IRQHandler +USART2_IRQHandler +USART3_IRQHandler +EXTI15_10_IRQHandler +RTC_Alarm_IRQHandler +OTG_FS_WKUP_IRQHandler +TIM8_BRK_TIM12_IRQHandler +TIM8_UP_TIM13_IRQHandler +TIM8_TRG_COM_TIM14_IRQHandler +TIM8_CC_IRQHandler +DMA1_Stream7_IRQHandler +FSMC_IRQHandler +SDIO_IRQHandler +TIM5_IRQHandler +SPI3_IRQHandler +UART4_IRQHandler +UART5_IRQHandler +TIM6_DAC_IRQHandler +TIM7_IRQHandler +DMA2_Stream0_IRQHandler +DMA2_Stream1_IRQHandler +DMA2_Stream2_IRQHandler +DMA2_Stream3_IRQHandler +DMA2_Stream4_IRQHandler +ETH_IRQHandler +ETH_WKUP_IRQHandler +CAN2_TX_IRQHandler +CAN2_RX0_IRQHandler +CAN2_RX1_IRQHandler +CAN2_SCE_IRQHandler +OTG_FS_IRQHandler +DMA2_Stream5_IRQHandler +DMA2_Stream6_IRQHandler +DMA2_Stream7_IRQHandler +USART6_IRQHandler +I2C3_EV_IRQHandler +I2C3_ER_IRQHandler +OTG_HS_EP1_OUT_IRQHandler +OTG_HS_EP1_IN_IRQHandler +OTG_HS_WKUP_IRQHandler +OTG_HS_IRQHandler +DCMI_IRQHandler +CRYP_IRQHandler +HASH_RNG_IRQHandler +FPU_IRQHandler + + B . + + ENDP + + ALIGN + +;******************************************************************************* +; User Stack and Heap initialization +;******************************************************************************* + IF :DEF:__MICROLIB + + EXPORT __initial_sp + EXPORT __heap_base + EXPORT __heap_limit + + ELSE + + IMPORT __use_two_region_memory + EXPORT __user_initial_stackheap + +__user_initial_stackheap + + LDR R0, = Heap_Mem + LDR R1, =(Stack_Mem + Stack_Size) + LDR R2, = (Heap_Mem + Heap_Size) + LDR R3, = Stack_Mem + BX LR + + ALIGN + + ENDIF + + END + +;************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE***** diff --git a/FWLIB/inc/misc.h b/FWLIB/inc/misc.h new file mode 100644 index 0000000..6c2fa6a --- /dev/null +++ b/FWLIB/inc/misc.h @@ -0,0 +1,178 @@ +/** + ****************************************************************************** + * @file misc.h + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file contains all the functions prototypes for the miscellaneous + * firmware library functions (add-on to CMSIS functions). + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Define to prevent recursive inclusion -------------------------------------*/ +#ifndef __MISC_H +#define __MISC_H + +#ifdef __cplusplus + extern "C" { +#endif + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @addtogroup MISC + * @{ + */ + +/* Exported types ------------------------------------------------------------*/ + +/** + * @brief NVIC Init Structure definition + */ + +typedef struct +{ + uint8_t NVIC_IRQChannel; /*!< Specifies the IRQ channel to be enabled or disabled. + This parameter can be an enumerator of @ref IRQn_Type + enumeration (For the complete STM32 Devices IRQ Channels + list, please refer to stm32f4xx.h file) */ + + uint8_t NVIC_IRQChannelPreemptionPriority; /*!< Specifies the pre-emption priority for the IRQ channel + specified in NVIC_IRQChannel. This parameter can be a value + between 0 and 15 as described in the table @ref MISC_NVIC_Priority_Table + A lower priority value indicates a higher priority */ + + uint8_t NVIC_IRQChannelSubPriority; /*!< Specifies the subpriority level for the IRQ channel specified + in NVIC_IRQChannel. This parameter can be a value + between 0 and 15 as described in the table @ref MISC_NVIC_Priority_Table + A lower priority value indicates a higher priority */ + + FunctionalState NVIC_IRQChannelCmd; /*!< Specifies whether the IRQ channel defined in NVIC_IRQChannel + will be enabled or disabled. + This parameter can be set either to ENABLE or DISABLE */ +} NVIC_InitTypeDef; + +/* Exported constants --------------------------------------------------------*/ + +/** @defgroup MISC_Exported_Constants + * @{ + */ + +/** @defgroup MISC_Vector_Table_Base + * @{ + */ + +#define NVIC_VectTab_RAM ((uint32_t)0x20000000) +#define NVIC_VectTab_FLASH ((uint32_t)0x08000000) +#define IS_NVIC_VECTTAB(VECTTAB) (((VECTTAB) == NVIC_VectTab_RAM) || \ + ((VECTTAB) == NVIC_VectTab_FLASH)) +/** + * @} + */ + +/** @defgroup MISC_System_Low_Power + * @{ + */ + +#define NVIC_LP_SEVONPEND ((uint8_t)0x10) +#define NVIC_LP_SLEEPDEEP ((uint8_t)0x04) +#define NVIC_LP_SLEEPONEXIT ((uint8_t)0x02) +#define IS_NVIC_LP(LP) (((LP) == NVIC_LP_SEVONPEND) || \ + ((LP) == NVIC_LP_SLEEPDEEP) || \ + ((LP) == NVIC_LP_SLEEPONEXIT)) +/** + * @} + */ + +/** @defgroup MISC_Preemption_Priority_Group + * @{ + */ + +#define NVIC_PriorityGroup_0 ((uint32_t)0x700) /*!< 0 bits for pre-emption priority + 4 bits for subpriority */ +#define NVIC_PriorityGroup_1 ((uint32_t)0x600) /*!< 1 bits for pre-emption priority + 3 bits for subpriority */ +#define NVIC_PriorityGroup_2 ((uint32_t)0x500) /*!< 2 bits for pre-emption priority + 2 bits for subpriority */ +#define NVIC_PriorityGroup_3 ((uint32_t)0x400) /*!< 3 bits for pre-emption priority + 1 bits for subpriority */ +#define NVIC_PriorityGroup_4 ((uint32_t)0x300) /*!< 4 bits for pre-emption priority + 0 bits for subpriority */ + +#define IS_NVIC_PRIORITY_GROUP(GROUP) (((GROUP) == NVIC_PriorityGroup_0) || \ + ((GROUP) == NVIC_PriorityGroup_1) || \ + ((GROUP) == NVIC_PriorityGroup_2) || \ + ((GROUP) == NVIC_PriorityGroup_3) || \ + ((GROUP) == NVIC_PriorityGroup_4)) + +#define IS_NVIC_PREEMPTION_PRIORITY(PRIORITY) ((PRIORITY) < 0x10) + +#define IS_NVIC_SUB_PRIORITY(PRIORITY) ((PRIORITY) < 0x10) + +#define IS_NVIC_OFFSET(OFFSET) ((OFFSET) < 0x000FFFFF) + +/** + * @} + */ + +/** @defgroup MISC_SysTick_clock_source + * @{ + */ + +#define SysTick_CLKSource_HCLK_Div8 ((uint32_t)0xFFFFFFFB) +#define SysTick_CLKSource_HCLK ((uint32_t)0x00000004) +#define IS_SYSTICK_CLK_SOURCE(SOURCE) (((SOURCE) == SysTick_CLKSource_HCLK) || \ + ((SOURCE) == SysTick_CLKSource_HCLK_Div8)) +/** + * @} + */ + +/** + * @} + */ + +/* Exported macro ------------------------------------------------------------*/ +/* Exported functions --------------------------------------------------------*/ + +void NVIC_PriorityGroupConfig(uint32_t NVIC_PriorityGroup); +void NVIC_Init(NVIC_InitTypeDef* NVIC_InitStruct); +void NVIC_SetVectorTable(uint32_t NVIC_VectTab, uint32_t Offset); +void NVIC_SystemLPConfig(uint8_t LowPowerMode, FunctionalState NewState); +void SysTick_CLKSourceConfig(uint32_t SysTick_CLKSource); + +#ifdef __cplusplus +} +#endif + +#endif /* __MISC_H */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/inc/stm32f4xx_adc.h b/FWLIB/inc/stm32f4xx_adc.h new file mode 100644 index 0000000..ce79d8e --- /dev/null +++ b/FWLIB/inc/stm32f4xx_adc.h @@ -0,0 +1,656 @@ +/** + ****************************************************************************** + * @file stm32f4xx_adc.h + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file contains all the functions prototypes for the ADC firmware + * library. + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Define to prevent recursive inclusion -------------------------------------*/ +#ifndef __STM32F4xx_ADC_H +#define __STM32F4xx_ADC_H + +#ifdef __cplusplus + extern "C" { +#endif + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @addtogroup ADC + * @{ + */ + +/* Exported types ------------------------------------------------------------*/ + +/** + * @brief ADC Init structure definition + */ +typedef struct +{ + uint32_t ADC_Resolution; /*!< Configures the ADC resolution dual mode. + This parameter can be a value of @ref ADC_resolution */ + FunctionalState ADC_ScanConvMode; /*!< Specifies whether the conversion + is performed in Scan (multichannels) + or Single (one channel) mode. + This parameter can be set to ENABLE or DISABLE */ + FunctionalState ADC_ContinuousConvMode; /*!< Specifies whether the conversion + is performed in Continuous or Single mode. + This parameter can be set to ENABLE or DISABLE. */ + uint32_t ADC_ExternalTrigConvEdge; /*!< Select the external trigger edge and + enable the trigger of a regular group. + This parameter can be a value of + @ref ADC_external_trigger_edge_for_regular_channels_conversion */ + uint32_t ADC_ExternalTrigConv; /*!< Select the external event used to trigger + the start of conversion of a regular group. + This parameter can be a value of + @ref ADC_extrenal_trigger_sources_for_regular_channels_conversion */ + uint32_t ADC_DataAlign; /*!< Specifies whether the ADC data alignment + is left or right. This parameter can be + a value of @ref ADC_data_align */ + uint8_t ADC_NbrOfConversion; /*!< Specifies the number of ADC conversions + that will be done using the sequencer for + regular channel group. + This parameter must range from 1 to 16. */ +}ADC_InitTypeDef; + +/** + * @brief ADC Common Init structure definition + */ +typedef struct +{ + uint32_t ADC_Mode; /*!< Configures the ADC to operate in + independent or multi mode. + This parameter can be a value of @ref ADC_Common_mode */ + uint32_t ADC_Prescaler; /*!< Select the frequency of the clock + to the ADC. The clock is common for all the ADCs. + This parameter can be a value of @ref ADC_Prescaler */ + uint32_t ADC_DMAAccessMode; /*!< Configures the Direct memory access + mode for multi ADC mode. + This parameter can be a value of + @ref ADC_Direct_memory_access_mode_for_multi_mode */ + uint32_t ADC_TwoSamplingDelay; /*!< Configures the Delay between 2 sampling phases. + This parameter can be a value of + @ref ADC_delay_between_2_sampling_phases */ + +}ADC_CommonInitTypeDef; + + +/* Exported constants --------------------------------------------------------*/ + +/** @defgroup ADC_Exported_Constants + * @{ + */ +#define IS_ADC_ALL_PERIPH(PERIPH) (((PERIPH) == ADC1) || \ + ((PERIPH) == ADC2) || \ + ((PERIPH) == ADC3)) + +/** @defgroup ADC_Common_mode + * @{ + */ +#define ADC_Mode_Independent ((uint32_t)0x00000000) +#define ADC_DualMode_RegSimult_InjecSimult ((uint32_t)0x00000001) +#define ADC_DualMode_RegSimult_AlterTrig ((uint32_t)0x00000002) +#define ADC_DualMode_InjecSimult ((uint32_t)0x00000005) +#define ADC_DualMode_RegSimult ((uint32_t)0x00000006) +#define ADC_DualMode_Interl ((uint32_t)0x00000007) +#define ADC_DualMode_AlterTrig ((uint32_t)0x00000009) +#define ADC_TripleMode_RegSimult_InjecSimult ((uint32_t)0x00000011) +#define ADC_TripleMode_RegSimult_AlterTrig ((uint32_t)0x00000012) +#define ADC_TripleMode_InjecSimult ((uint32_t)0x00000015) +#define ADC_TripleMode_RegSimult ((uint32_t)0x00000016) +#define ADC_TripleMode_Interl ((uint32_t)0x00000017) +#define ADC_TripleMode_AlterTrig ((uint32_t)0x00000019) +#define IS_ADC_MODE(MODE) (((MODE) == ADC_Mode_Independent) || \ + ((MODE) == ADC_DualMode_RegSimult_InjecSimult) || \ + ((MODE) == ADC_DualMode_RegSimult_AlterTrig) || \ + ((MODE) == ADC_DualMode_InjecSimult) || \ + ((MODE) == ADC_DualMode_RegSimult) || \ + ((MODE) == ADC_DualMode_Interl) || \ + ((MODE) == ADC_DualMode_AlterTrig) || \ + ((MODE) == ADC_TripleMode_RegSimult_InjecSimult) || \ + ((MODE) == ADC_TripleMode_RegSimult_AlterTrig) || \ + ((MODE) == ADC_TripleMode_InjecSimult) || \ + ((MODE) == ADC_TripleMode_RegSimult) || \ + ((MODE) == ADC_TripleMode_Interl) || \ + ((MODE) == ADC_TripleMode_AlterTrig)) +/** + * @} + */ + + +/** @defgroup ADC_Prescaler + * @{ + */ +#define ADC_Prescaler_Div2 ((uint32_t)0x00000000) +#define ADC_Prescaler_Div4 ((uint32_t)0x00010000) +#define ADC_Prescaler_Div6 ((uint32_t)0x00020000) +#define ADC_Prescaler_Div8 ((uint32_t)0x00030000) +#define IS_ADC_PRESCALER(PRESCALER) (((PRESCALER) == ADC_Prescaler_Div2) || \ + ((PRESCALER) == ADC_Prescaler_Div4) || \ + ((PRESCALER) == ADC_Prescaler_Div6) || \ + ((PRESCALER) == ADC_Prescaler_Div8)) +/** + * @} + */ + + +/** @defgroup ADC_Direct_memory_access_mode_for_multi_mode + * @{ + */ +#define ADC_DMAAccessMode_Disabled ((uint32_t)0x00000000) /* DMA mode disabled */ +#define ADC_DMAAccessMode_1 ((uint32_t)0x00004000) /* DMA mode 1 enabled (2 / 3 half-words one by one - 1 then 2 then 3)*/ +#define ADC_DMAAccessMode_2 ((uint32_t)0x00008000) /* DMA mode 2 enabled (2 / 3 half-words by pairs - 2&1 then 1&3 then 3&2)*/ +#define ADC_DMAAccessMode_3 ((uint32_t)0x0000C000) /* DMA mode 3 enabled (2 / 3 bytes by pairs - 2&1 then 1&3 then 3&2) */ +#define IS_ADC_DMA_ACCESS_MODE(MODE) (((MODE) == ADC_DMAAccessMode_Disabled) || \ + ((MODE) == ADC_DMAAccessMode_1) || \ + ((MODE) == ADC_DMAAccessMode_2) || \ + ((MODE) == ADC_DMAAccessMode_3)) + +/** + * @} + */ + + +/** @defgroup ADC_delay_between_2_sampling_phases + * @{ + */ +#define ADC_TwoSamplingDelay_5Cycles ((uint32_t)0x00000000) +#define ADC_TwoSamplingDelay_6Cycles ((uint32_t)0x00000100) +#define ADC_TwoSamplingDelay_7Cycles ((uint32_t)0x00000200) +#define ADC_TwoSamplingDelay_8Cycles ((uint32_t)0x00000300) +#define ADC_TwoSamplingDelay_9Cycles ((uint32_t)0x00000400) +#define ADC_TwoSamplingDelay_10Cycles ((uint32_t)0x00000500) +#define ADC_TwoSamplingDelay_11Cycles ((uint32_t)0x00000600) +#define ADC_TwoSamplingDelay_12Cycles ((uint32_t)0x00000700) +#define ADC_TwoSamplingDelay_13Cycles ((uint32_t)0x00000800) +#define ADC_TwoSamplingDelay_14Cycles ((uint32_t)0x00000900) +#define ADC_TwoSamplingDelay_15Cycles ((uint32_t)0x00000A00) +#define ADC_TwoSamplingDelay_16Cycles ((uint32_t)0x00000B00) +#define ADC_TwoSamplingDelay_17Cycles ((uint32_t)0x00000C00) +#define ADC_TwoSamplingDelay_18Cycles ((uint32_t)0x00000D00) +#define ADC_TwoSamplingDelay_19Cycles ((uint32_t)0x00000E00) +#define ADC_TwoSamplingDelay_20Cycles ((uint32_t)0x00000F00) +#define IS_ADC_SAMPLING_DELAY(DELAY) (((DELAY) == ADC_TwoSamplingDelay_5Cycles) || \ + ((DELAY) == ADC_TwoSamplingDelay_6Cycles) || \ + ((DELAY) == ADC_TwoSamplingDelay_7Cycles) || \ + ((DELAY) == ADC_TwoSamplingDelay_8Cycles) || \ + ((DELAY) == ADC_TwoSamplingDelay_9Cycles) || \ + ((DELAY) == ADC_TwoSamplingDelay_10Cycles) || \ + ((DELAY) == ADC_TwoSamplingDelay_11Cycles) || \ + ((DELAY) == ADC_TwoSamplingDelay_12Cycles) || \ + ((DELAY) == ADC_TwoSamplingDelay_13Cycles) || \ + ((DELAY) == ADC_TwoSamplingDelay_14Cycles) || \ + ((DELAY) == ADC_TwoSamplingDelay_15Cycles) || \ + ((DELAY) == ADC_TwoSamplingDelay_16Cycles) || \ + ((DELAY) == ADC_TwoSamplingDelay_17Cycles) || \ + ((DELAY) == ADC_TwoSamplingDelay_18Cycles) || \ + ((DELAY) == ADC_TwoSamplingDelay_19Cycles) || \ + ((DELAY) == ADC_TwoSamplingDelay_20Cycles)) + +/** + * @} + */ + + +/** @defgroup ADC_resolution + * @{ + */ +#define ADC_Resolution_12b ((uint32_t)0x00000000) +#define ADC_Resolution_10b ((uint32_t)0x01000000) +#define ADC_Resolution_8b ((uint32_t)0x02000000) +#define ADC_Resolution_6b ((uint32_t)0x03000000) +#define IS_ADC_RESOLUTION(RESOLUTION) (((RESOLUTION) == ADC_Resolution_12b) || \ + ((RESOLUTION) == ADC_Resolution_10b) || \ + ((RESOLUTION) == ADC_Resolution_8b) || \ + ((RESOLUTION) == ADC_Resolution_6b)) + +/** + * @} + */ + + +/** @defgroup ADC_external_trigger_edge_for_regular_channels_conversion + * @{ + */ +#define ADC_ExternalTrigConvEdge_None ((uint32_t)0x00000000) +#define ADC_ExternalTrigConvEdge_Rising ((uint32_t)0x10000000) +#define ADC_ExternalTrigConvEdge_Falling ((uint32_t)0x20000000) +#define ADC_ExternalTrigConvEdge_RisingFalling ((uint32_t)0x30000000) +#define IS_ADC_EXT_TRIG_EDGE(EDGE) (((EDGE) == ADC_ExternalTrigConvEdge_None) || \ + ((EDGE) == ADC_ExternalTrigConvEdge_Rising) || \ + ((EDGE) == ADC_ExternalTrigConvEdge_Falling) || \ + ((EDGE) == ADC_ExternalTrigConvEdge_RisingFalling)) +/** + * @} + */ + + +/** @defgroup ADC_extrenal_trigger_sources_for_regular_channels_conversion + * @{ + */ +#define ADC_ExternalTrigConv_T1_CC1 ((uint32_t)0x00000000) +#define ADC_ExternalTrigConv_T1_CC2 ((uint32_t)0x01000000) +#define ADC_ExternalTrigConv_T1_CC3 ((uint32_t)0x02000000) +#define ADC_ExternalTrigConv_T2_CC2 ((uint32_t)0x03000000) +#define ADC_ExternalTrigConv_T2_CC3 ((uint32_t)0x04000000) +#define ADC_ExternalTrigConv_T2_CC4 ((uint32_t)0x05000000) +#define ADC_ExternalTrigConv_T2_TRGO ((uint32_t)0x06000000) +#define ADC_ExternalTrigConv_T3_CC1 ((uint32_t)0x07000000) +#define ADC_ExternalTrigConv_T3_TRGO ((uint32_t)0x08000000) +#define ADC_ExternalTrigConv_T4_CC4 ((uint32_t)0x09000000) +#define ADC_ExternalTrigConv_T5_CC1 ((uint32_t)0x0A000000) +#define ADC_ExternalTrigConv_T5_CC2 ((uint32_t)0x0B000000) +#define ADC_ExternalTrigConv_T5_CC3 ((uint32_t)0x0C000000) +#define ADC_ExternalTrigConv_T8_CC1 ((uint32_t)0x0D000000) +#define ADC_ExternalTrigConv_T8_TRGO ((uint32_t)0x0E000000) +#define ADC_ExternalTrigConv_Ext_IT11 ((uint32_t)0x0F000000) +#define IS_ADC_EXT_TRIG(REGTRIG) (((REGTRIG) == ADC_ExternalTrigConv_T1_CC1) || \ + ((REGTRIG) == ADC_ExternalTrigConv_T1_CC2) || \ + ((REGTRIG) == ADC_ExternalTrigConv_T1_CC3) || \ + ((REGTRIG) == ADC_ExternalTrigConv_T2_CC2) || \ + ((REGTRIG) == ADC_ExternalTrigConv_T2_CC3) || \ + ((REGTRIG) == ADC_ExternalTrigConv_T2_CC4) || \ + ((REGTRIG) == ADC_ExternalTrigConv_T2_TRGO) || \ + ((REGTRIG) == ADC_ExternalTrigConv_T3_CC1) || \ + ((REGTRIG) == ADC_ExternalTrigConv_T3_TRGO) || \ + ((REGTRIG) == ADC_ExternalTrigConv_T4_CC4) || \ + ((REGTRIG) == ADC_ExternalTrigConv_T5_CC1) || \ + ((REGTRIG) == ADC_ExternalTrigConv_T5_CC2) || \ + ((REGTRIG) == ADC_ExternalTrigConv_T5_CC3) || \ + ((REGTRIG) == ADC_ExternalTrigConv_T8_CC1) || \ + ((REGTRIG) == ADC_ExternalTrigConv_T8_TRGO) || \ + ((REGTRIG) == ADC_ExternalTrigConv_Ext_IT11)) +/** + * @} + */ + + +/** @defgroup ADC_data_align + * @{ + */ +#define ADC_DataAlign_Right ((uint32_t)0x00000000) +#define ADC_DataAlign_Left ((uint32_t)0x00000800) +#define IS_ADC_DATA_ALIGN(ALIGN) (((ALIGN) == ADC_DataAlign_Right) || \ + ((ALIGN) == ADC_DataAlign_Left)) +/** + * @} + */ + + +/** @defgroup ADC_channels + * @{ + */ +#define ADC_Channel_0 ((uint8_t)0x00) +#define ADC_Channel_1 ((uint8_t)0x01) +#define ADC_Channel_2 ((uint8_t)0x02) +#define ADC_Channel_3 ((uint8_t)0x03) +#define ADC_Channel_4 ((uint8_t)0x04) +#define ADC_Channel_5 ((uint8_t)0x05) +#define ADC_Channel_6 ((uint8_t)0x06) +#define ADC_Channel_7 ((uint8_t)0x07) +#define ADC_Channel_8 ((uint8_t)0x08) +#define ADC_Channel_9 ((uint8_t)0x09) +#define ADC_Channel_10 ((uint8_t)0x0A) +#define ADC_Channel_11 ((uint8_t)0x0B) +#define ADC_Channel_12 ((uint8_t)0x0C) +#define ADC_Channel_13 ((uint8_t)0x0D) +#define ADC_Channel_14 ((uint8_t)0x0E) +#define ADC_Channel_15 ((uint8_t)0x0F) +#define ADC_Channel_16 ((uint8_t)0x10) +#define ADC_Channel_17 ((uint8_t)0x11) +#define ADC_Channel_18 ((uint8_t)0x12) + +#if defined (STM32F40_41xxx) +#define ADC_Channel_TempSensor ((uint8_t)ADC_Channel_16) +#endif /* STM32F40_41xxx */ + +#if defined (STM32F427_437xx) || defined (STM32F429_439xx) || defined (STM32F401xx) || defined (STM32F411xE) +#define ADC_Channel_TempSensor ((uint8_t)ADC_Channel_18) +#endif /* STM32F427_437xx || STM32F429_439xx || STM32F401xx || STM32F411xE */ + +#define ADC_Channel_Vrefint ((uint8_t)ADC_Channel_17) +#define ADC_Channel_Vbat ((uint8_t)ADC_Channel_18) + +#define IS_ADC_CHANNEL(CHANNEL) (((CHANNEL) == ADC_Channel_0) || \ + ((CHANNEL) == ADC_Channel_1) || \ + ((CHANNEL) == ADC_Channel_2) || \ + ((CHANNEL) == ADC_Channel_3) || \ + ((CHANNEL) == ADC_Channel_4) || \ + ((CHANNEL) == ADC_Channel_5) || \ + ((CHANNEL) == ADC_Channel_6) || \ + ((CHANNEL) == ADC_Channel_7) || \ + ((CHANNEL) == ADC_Channel_8) || \ + ((CHANNEL) == ADC_Channel_9) || \ + ((CHANNEL) == ADC_Channel_10) || \ + ((CHANNEL) == ADC_Channel_11) || \ + ((CHANNEL) == ADC_Channel_12) || \ + ((CHANNEL) == ADC_Channel_13) || \ + ((CHANNEL) == ADC_Channel_14) || \ + ((CHANNEL) == ADC_Channel_15) || \ + ((CHANNEL) == ADC_Channel_16) || \ + ((CHANNEL) == ADC_Channel_17) || \ + ((CHANNEL) == ADC_Channel_18)) +/** + * @} + */ + + +/** @defgroup ADC_sampling_times + * @{ + */ +#define ADC_SampleTime_3Cycles ((uint8_t)0x00) +#define ADC_SampleTime_15Cycles ((uint8_t)0x01) +#define ADC_SampleTime_28Cycles ((uint8_t)0x02) +#define ADC_SampleTime_56Cycles ((uint8_t)0x03) +#define ADC_SampleTime_84Cycles ((uint8_t)0x04) +#define ADC_SampleTime_112Cycles ((uint8_t)0x05) +#define ADC_SampleTime_144Cycles ((uint8_t)0x06) +#define ADC_SampleTime_480Cycles ((uint8_t)0x07) +#define IS_ADC_SAMPLE_TIME(TIME) (((TIME) == ADC_SampleTime_3Cycles) || \ + ((TIME) == ADC_SampleTime_15Cycles) || \ + ((TIME) == ADC_SampleTime_28Cycles) || \ + ((TIME) == ADC_SampleTime_56Cycles) || \ + ((TIME) == ADC_SampleTime_84Cycles) || \ + ((TIME) == ADC_SampleTime_112Cycles) || \ + ((TIME) == ADC_SampleTime_144Cycles) || \ + ((TIME) == ADC_SampleTime_480Cycles)) +/** + * @} + */ + + +/** @defgroup ADC_external_trigger_edge_for_injected_channels_conversion + * @{ + */ +#define ADC_ExternalTrigInjecConvEdge_None ((uint32_t)0x00000000) +#define ADC_ExternalTrigInjecConvEdge_Rising ((uint32_t)0x00100000) +#define ADC_ExternalTrigInjecConvEdge_Falling ((uint32_t)0x00200000) +#define ADC_ExternalTrigInjecConvEdge_RisingFalling ((uint32_t)0x00300000) +#define IS_ADC_EXT_INJEC_TRIG_EDGE(EDGE) (((EDGE) == ADC_ExternalTrigInjecConvEdge_None) || \ + ((EDGE) == ADC_ExternalTrigInjecConvEdge_Rising) || \ + ((EDGE) == ADC_ExternalTrigInjecConvEdge_Falling) || \ + ((EDGE) == ADC_ExternalTrigInjecConvEdge_RisingFalling)) + +/** + * @} + */ + + +/** @defgroup ADC_extrenal_trigger_sources_for_injected_channels_conversion + * @{ + */ +#define ADC_ExternalTrigInjecConv_T1_CC4 ((uint32_t)0x00000000) +#define ADC_ExternalTrigInjecConv_T1_TRGO ((uint32_t)0x00010000) +#define ADC_ExternalTrigInjecConv_T2_CC1 ((uint32_t)0x00020000) +#define ADC_ExternalTrigInjecConv_T2_TRGO ((uint32_t)0x00030000) +#define ADC_ExternalTrigInjecConv_T3_CC2 ((uint32_t)0x00040000) +#define ADC_ExternalTrigInjecConv_T3_CC4 ((uint32_t)0x00050000) +#define ADC_ExternalTrigInjecConv_T4_CC1 ((uint32_t)0x00060000) +#define ADC_ExternalTrigInjecConv_T4_CC2 ((uint32_t)0x00070000) +#define ADC_ExternalTrigInjecConv_T4_CC3 ((uint32_t)0x00080000) +#define ADC_ExternalTrigInjecConv_T4_TRGO ((uint32_t)0x00090000) +#define ADC_ExternalTrigInjecConv_T5_CC4 ((uint32_t)0x000A0000) +#define ADC_ExternalTrigInjecConv_T5_TRGO ((uint32_t)0x000B0000) +#define ADC_ExternalTrigInjecConv_T8_CC2 ((uint32_t)0x000C0000) +#define ADC_ExternalTrigInjecConv_T8_CC3 ((uint32_t)0x000D0000) +#define ADC_ExternalTrigInjecConv_T8_CC4 ((uint32_t)0x000E0000) +#define ADC_ExternalTrigInjecConv_Ext_IT15 ((uint32_t)0x000F0000) +#define IS_ADC_EXT_INJEC_TRIG(INJTRIG) (((INJTRIG) == ADC_ExternalTrigInjecConv_T1_CC4) || \ + ((INJTRIG) == ADC_ExternalTrigInjecConv_T1_TRGO) || \ + ((INJTRIG) == ADC_ExternalTrigInjecConv_T2_CC1) || \ + ((INJTRIG) == ADC_ExternalTrigInjecConv_T2_TRGO) || \ + ((INJTRIG) == ADC_ExternalTrigInjecConv_T3_CC2) || \ + ((INJTRIG) == ADC_ExternalTrigInjecConv_T3_CC4) || \ + ((INJTRIG) == ADC_ExternalTrigInjecConv_T4_CC1) || \ + ((INJTRIG) == ADC_ExternalTrigInjecConv_T4_CC2) || \ + ((INJTRIG) == ADC_ExternalTrigInjecConv_T4_CC3) || \ + ((INJTRIG) == ADC_ExternalTrigInjecConv_T4_TRGO) || \ + ((INJTRIG) == ADC_ExternalTrigInjecConv_T5_CC4) || \ + ((INJTRIG) == ADC_ExternalTrigInjecConv_T5_TRGO) || \ + ((INJTRIG) == ADC_ExternalTrigInjecConv_T8_CC2) || \ + ((INJTRIG) == ADC_ExternalTrigInjecConv_T8_CC3) || \ + ((INJTRIG) == ADC_ExternalTrigInjecConv_T8_CC4) || \ + ((INJTRIG) == ADC_ExternalTrigInjecConv_Ext_IT15)) +/** + * @} + */ + + +/** @defgroup ADC_injected_channel_selection + * @{ + */ +#define ADC_InjectedChannel_1 ((uint8_t)0x14) +#define ADC_InjectedChannel_2 ((uint8_t)0x18) +#define ADC_InjectedChannel_3 ((uint8_t)0x1C) +#define ADC_InjectedChannel_4 ((uint8_t)0x20) +#define IS_ADC_INJECTED_CHANNEL(CHANNEL) (((CHANNEL) == ADC_InjectedChannel_1) || \ + ((CHANNEL) == ADC_InjectedChannel_2) || \ + ((CHANNEL) == ADC_InjectedChannel_3) || \ + ((CHANNEL) == ADC_InjectedChannel_4)) +/** + * @} + */ + + +/** @defgroup ADC_analog_watchdog_selection + * @{ + */ +#define ADC_AnalogWatchdog_SingleRegEnable ((uint32_t)0x00800200) +#define ADC_AnalogWatchdog_SingleInjecEnable ((uint32_t)0x00400200) +#define ADC_AnalogWatchdog_SingleRegOrInjecEnable ((uint32_t)0x00C00200) +#define ADC_AnalogWatchdog_AllRegEnable ((uint32_t)0x00800000) +#define ADC_AnalogWatchdog_AllInjecEnable ((uint32_t)0x00400000) +#define ADC_AnalogWatchdog_AllRegAllInjecEnable ((uint32_t)0x00C00000) +#define ADC_AnalogWatchdog_None ((uint32_t)0x00000000) +#define IS_ADC_ANALOG_WATCHDOG(WATCHDOG) (((WATCHDOG) == ADC_AnalogWatchdog_SingleRegEnable) || \ + ((WATCHDOG) == ADC_AnalogWatchdog_SingleInjecEnable) || \ + ((WATCHDOG) == ADC_AnalogWatchdog_SingleRegOrInjecEnable) || \ + ((WATCHDOG) == ADC_AnalogWatchdog_AllRegEnable) || \ + ((WATCHDOG) == ADC_AnalogWatchdog_AllInjecEnable) || \ + ((WATCHDOG) == ADC_AnalogWatchdog_AllRegAllInjecEnable) || \ + ((WATCHDOG) == ADC_AnalogWatchdog_None)) +/** + * @} + */ + + +/** @defgroup ADC_interrupts_definition + * @{ + */ +#define ADC_IT_EOC ((uint16_t)0x0205) +#define ADC_IT_AWD ((uint16_t)0x0106) +#define ADC_IT_JEOC ((uint16_t)0x0407) +#define ADC_IT_OVR ((uint16_t)0x201A) +#define IS_ADC_IT(IT) (((IT) == ADC_IT_EOC) || ((IT) == ADC_IT_AWD) || \ + ((IT) == ADC_IT_JEOC)|| ((IT) == ADC_IT_OVR)) +/** + * @} + */ + + +/** @defgroup ADC_flags_definition + * @{ + */ +#define ADC_FLAG_AWD ((uint8_t)0x01) +#define ADC_FLAG_EOC ((uint8_t)0x02) +#define ADC_FLAG_JEOC ((uint8_t)0x04) +#define ADC_FLAG_JSTRT ((uint8_t)0x08) +#define ADC_FLAG_STRT ((uint8_t)0x10) +#define ADC_FLAG_OVR ((uint8_t)0x20) + +#define IS_ADC_CLEAR_FLAG(FLAG) ((((FLAG) & (uint8_t)0xC0) == 0x00) && ((FLAG) != 0x00)) +#define IS_ADC_GET_FLAG(FLAG) (((FLAG) == ADC_FLAG_AWD) || \ + ((FLAG) == ADC_FLAG_EOC) || \ + ((FLAG) == ADC_FLAG_JEOC) || \ + ((FLAG)== ADC_FLAG_JSTRT) || \ + ((FLAG) == ADC_FLAG_STRT) || \ + ((FLAG)== ADC_FLAG_OVR)) +/** + * @} + */ + + +/** @defgroup ADC_thresholds + * @{ + */ +#define IS_ADC_THRESHOLD(THRESHOLD) ((THRESHOLD) <= 0xFFF) +/** + * @} + */ + + +/** @defgroup ADC_injected_offset + * @{ + */ +#define IS_ADC_OFFSET(OFFSET) ((OFFSET) <= 0xFFF) +/** + * @} + */ + + +/** @defgroup ADC_injected_length + * @{ + */ +#define IS_ADC_INJECTED_LENGTH(LENGTH) (((LENGTH) >= 0x1) && ((LENGTH) <= 0x4)) +/** + * @} + */ + + +/** @defgroup ADC_injected_rank + * @{ + */ +#define IS_ADC_INJECTED_RANK(RANK) (((RANK) >= 0x1) && ((RANK) <= 0x4)) +/** + * @} + */ + + +/** @defgroup ADC_regular_length + * @{ + */ +#define IS_ADC_REGULAR_LENGTH(LENGTH) (((LENGTH) >= 0x1) && ((LENGTH) <= 0x10)) +/** + * @} + */ + + +/** @defgroup ADC_regular_rank + * @{ + */ +#define IS_ADC_REGULAR_RANK(RANK) (((RANK) >= 0x1) && ((RANK) <= 0x10)) +/** + * @} + */ + + +/** @defgroup ADC_regular_discontinuous_mode_number + * @{ + */ +#define IS_ADC_REGULAR_DISC_NUMBER(NUMBER) (((NUMBER) >= 0x1) && ((NUMBER) <= 0x8)) +/** + * @} + */ + + +/** + * @} + */ + +/* Exported macro ------------------------------------------------------------*/ +/* Exported functions --------------------------------------------------------*/ + +/* Function used to set the ADC configuration to the default reset state *****/ +void ADC_DeInit(void); + +/* Initialization and Configuration functions *********************************/ +void ADC_Init(ADC_TypeDef* ADCx, ADC_InitTypeDef* ADC_InitStruct); +void ADC_StructInit(ADC_InitTypeDef* ADC_InitStruct); +void ADC_CommonInit(ADC_CommonInitTypeDef* ADC_CommonInitStruct); +void ADC_CommonStructInit(ADC_CommonInitTypeDef* ADC_CommonInitStruct); +void ADC_Cmd(ADC_TypeDef* ADCx, FunctionalState NewState); + +/* Analog Watchdog configuration functions ************************************/ +void ADC_AnalogWatchdogCmd(ADC_TypeDef* ADCx, uint32_t ADC_AnalogWatchdog); +void ADC_AnalogWatchdogThresholdsConfig(ADC_TypeDef* ADCx, uint16_t HighThreshold,uint16_t LowThreshold); +void ADC_AnalogWatchdogSingleChannelConfig(ADC_TypeDef* ADCx, uint8_t ADC_Channel); + +/* Temperature Sensor, Vrefint and VBAT management functions ******************/ +void ADC_TempSensorVrefintCmd(FunctionalState NewState); +void ADC_VBATCmd(FunctionalState NewState); + +/* Regular Channels Configuration functions ***********************************/ +void ADC_RegularChannelConfig(ADC_TypeDef* ADCx, uint8_t ADC_Channel, uint8_t Rank, uint8_t ADC_SampleTime); +void ADC_SoftwareStartConv(ADC_TypeDef* ADCx); +FlagStatus ADC_GetSoftwareStartConvStatus(ADC_TypeDef* ADCx); +void ADC_EOCOnEachRegularChannelCmd(ADC_TypeDef* ADCx, FunctionalState NewState); +void ADC_ContinuousModeCmd(ADC_TypeDef* ADCx, FunctionalState NewState); +void ADC_DiscModeChannelCountConfig(ADC_TypeDef* ADCx, uint8_t Number); +void ADC_DiscModeCmd(ADC_TypeDef* ADCx, FunctionalState NewState); +uint16_t ADC_GetConversionValue(ADC_TypeDef* ADCx); +uint32_t ADC_GetMultiModeConversionValue(void); + +/* Regular Channels DMA Configuration functions *******************************/ +void ADC_DMACmd(ADC_TypeDef* ADCx, FunctionalState NewState); +void ADC_DMARequestAfterLastTransferCmd(ADC_TypeDef* ADCx, FunctionalState NewState); +void ADC_MultiModeDMARequestAfterLastTransferCmd(FunctionalState NewState); + +/* Injected channels Configuration functions **********************************/ +void ADC_InjectedChannelConfig(ADC_TypeDef* ADCx, uint8_t ADC_Channel, uint8_t Rank, uint8_t ADC_SampleTime); +void ADC_InjectedSequencerLengthConfig(ADC_TypeDef* ADCx, uint8_t Length); +void ADC_SetInjectedOffset(ADC_TypeDef* ADCx, uint8_t ADC_InjectedChannel, uint16_t Offset); +void ADC_ExternalTrigInjectedConvConfig(ADC_TypeDef* ADCx, uint32_t ADC_ExternalTrigInjecConv); +void ADC_ExternalTrigInjectedConvEdgeConfig(ADC_TypeDef* ADCx, uint32_t ADC_ExternalTrigInjecConvEdge); +void ADC_SoftwareStartInjectedConv(ADC_TypeDef* ADCx); +FlagStatus ADC_GetSoftwareStartInjectedConvCmdStatus(ADC_TypeDef* ADCx); +void ADC_AutoInjectedConvCmd(ADC_TypeDef* ADCx, FunctionalState NewState); +void ADC_InjectedDiscModeCmd(ADC_TypeDef* ADCx, FunctionalState NewState); +uint16_t ADC_GetInjectedConversionValue(ADC_TypeDef* ADCx, uint8_t ADC_InjectedChannel); + +/* Interrupts and flags management functions **********************************/ +void ADC_ITConfig(ADC_TypeDef* ADCx, uint16_t ADC_IT, FunctionalState NewState); +FlagStatus ADC_GetFlagStatus(ADC_TypeDef* ADCx, uint8_t ADC_FLAG); +void ADC_ClearFlag(ADC_TypeDef* ADCx, uint8_t ADC_FLAG); +ITStatus ADC_GetITStatus(ADC_TypeDef* ADCx, uint16_t ADC_IT); +void ADC_ClearITPendingBit(ADC_TypeDef* ADCx, uint16_t ADC_IT); + +#ifdef __cplusplus +} +#endif + +#endif /*__STM32F4xx_ADC_H */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/inc/stm32f4xx_can.h b/FWLIB/inc/stm32f4xx_can.h new file mode 100644 index 0000000..790e500 --- /dev/null +++ b/FWLIB/inc/stm32f4xx_can.h @@ -0,0 +1,644 @@ +/** + ****************************************************************************** + * @file stm32f4xx_can.h + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file contains all the functions prototypes for the CAN firmware + * library. + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Define to prevent recursive inclusion -------------------------------------*/ +#ifndef __STM32F4xx_CAN_H +#define __STM32F4xx_CAN_H + +#ifdef __cplusplus + extern "C" { +#endif + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @addtogroup CAN + * @{ + */ + +/* Exported types ------------------------------------------------------------*/ + +#define IS_CAN_ALL_PERIPH(PERIPH) (((PERIPH) == CAN1) || \ + ((PERIPH) == CAN2)) + +/** + * @brief CAN init structure definition + */ +typedef struct +{ + uint16_t CAN_Prescaler; /*!< Specifies the length of a time quantum. + It ranges from 1 to 1024. */ + + uint8_t CAN_Mode; /*!< Specifies the CAN operating mode. + This parameter can be a value of @ref CAN_operating_mode */ + + uint8_t CAN_SJW; /*!< Specifies the maximum number of time quanta + the CAN hardware is allowed to lengthen or + shorten a bit to perform resynchronization. + This parameter can be a value of @ref CAN_synchronisation_jump_width */ + + uint8_t CAN_BS1; /*!< Specifies the number of time quanta in Bit + Segment 1. This parameter can be a value of + @ref CAN_time_quantum_in_bit_segment_1 */ + + uint8_t CAN_BS2; /*!< Specifies the number of time quanta in Bit Segment 2. + This parameter can be a value of @ref CAN_time_quantum_in_bit_segment_2 */ + + FunctionalState CAN_TTCM; /*!< Enable or disable the time triggered communication mode. + This parameter can be set either to ENABLE or DISABLE. */ + + FunctionalState CAN_ABOM; /*!< Enable or disable the automatic bus-off management. + This parameter can be set either to ENABLE or DISABLE. */ + + FunctionalState CAN_AWUM; /*!< Enable or disable the automatic wake-up mode. + This parameter can be set either to ENABLE or DISABLE. */ + + FunctionalState CAN_NART; /*!< Enable or disable the non-automatic retransmission mode. + This parameter can be set either to ENABLE or DISABLE. */ + + FunctionalState CAN_RFLM; /*!< Enable or disable the Receive FIFO Locked mode. + This parameter can be set either to ENABLE or DISABLE. */ + + FunctionalState CAN_TXFP; /*!< Enable or disable the transmit FIFO priority. + This parameter can be set either to ENABLE or DISABLE. */ +} CAN_InitTypeDef; + +/** + * @brief CAN filter init structure definition + */ +typedef struct +{ + uint16_t CAN_FilterIdHigh; /*!< Specifies the filter identification number (MSBs for a 32-bit + configuration, first one for a 16-bit configuration). + This parameter can be a value between 0x0000 and 0xFFFF */ + + uint16_t CAN_FilterIdLow; /*!< Specifies the filter identification number (LSBs for a 32-bit + configuration, second one for a 16-bit configuration). + This parameter can be a value between 0x0000 and 0xFFFF */ + + uint16_t CAN_FilterMaskIdHigh; /*!< Specifies the filter mask number or identification number, + according to the mode (MSBs for a 32-bit configuration, + first one for a 16-bit configuration). + This parameter can be a value between 0x0000 and 0xFFFF */ + + uint16_t CAN_FilterMaskIdLow; /*!< Specifies the filter mask number or identification number, + according to the mode (LSBs for a 32-bit configuration, + second one for a 16-bit configuration). + This parameter can be a value between 0x0000 and 0xFFFF */ + + uint16_t CAN_FilterFIFOAssignment; /*!< Specifies the FIFO (0 or 1) which will be assigned to the filter. + This parameter can be a value of @ref CAN_filter_FIFO */ + + uint8_t CAN_FilterNumber; /*!< Specifies the filter which will be initialized. It ranges from 0 to 13. */ + + uint8_t CAN_FilterMode; /*!< Specifies the filter mode to be initialized. + This parameter can be a value of @ref CAN_filter_mode */ + + uint8_t CAN_FilterScale; /*!< Specifies the filter scale. + This parameter can be a value of @ref CAN_filter_scale */ + + FunctionalState CAN_FilterActivation; /*!< Enable or disable the filter. + This parameter can be set either to ENABLE or DISABLE. */ +} CAN_FilterInitTypeDef; + +/** + * @brief CAN Tx message structure definition + */ +typedef struct +{ + uint32_t StdId; /*!< Specifies the standard identifier. + This parameter can be a value between 0 to 0x7FF. */ + + uint32_t ExtId; /*!< Specifies the extended identifier. + This parameter can be a value between 0 to 0x1FFFFFFF. */ + + uint8_t IDE; /*!< Specifies the type of identifier for the message that + will be transmitted. This parameter can be a value + of @ref CAN_identifier_type */ + + uint8_t RTR; /*!< Specifies the type of frame for the message that will + be transmitted. This parameter can be a value of + @ref CAN_remote_transmission_request */ + + uint8_t DLC; /*!< Specifies the length of the frame that will be + transmitted. This parameter can be a value between + 0 to 8 */ + + uint8_t Data[8]; /*!< Contains the data to be transmitted. It ranges from 0 + to 0xFF. */ +} CanTxMsg; + +/** + * @brief CAN Rx message structure definition + */ +typedef struct +{ + uint32_t StdId; /*!< Specifies the standard identifier. + This parameter can be a value between 0 to 0x7FF. */ + + uint32_t ExtId; /*!< Specifies the extended identifier. + This parameter can be a value between 0 to 0x1FFFFFFF. */ + + uint8_t IDE; /*!< Specifies the type of identifier for the message that + will be received. This parameter can be a value of + @ref CAN_identifier_type */ + + uint8_t RTR; /*!< Specifies the type of frame for the received message. + This parameter can be a value of + @ref CAN_remote_transmission_request */ + + uint8_t DLC; /*!< Specifies the length of the frame that will be received. + This parameter can be a value between 0 to 8 */ + + uint8_t Data[8]; /*!< Contains the data to be received. It ranges from 0 to + 0xFF. */ + + uint8_t FMI; /*!< Specifies the index of the filter the message stored in + the mailbox passes through. This parameter can be a + value between 0 to 0xFF */ +} CanRxMsg; + +/* Exported constants --------------------------------------------------------*/ + +/** @defgroup CAN_Exported_Constants + * @{ + */ + +/** @defgroup CAN_InitStatus + * @{ + */ + +#define CAN_InitStatus_Failed ((uint8_t)0x00) /*!< CAN initialization failed */ +#define CAN_InitStatus_Success ((uint8_t)0x01) /*!< CAN initialization OK */ + + +/* Legacy defines */ +#define CANINITFAILED CAN_InitStatus_Failed +#define CANINITOK CAN_InitStatus_Success +/** + * @} + */ + +/** @defgroup CAN_operating_mode + * @{ + */ + +#define CAN_Mode_Normal ((uint8_t)0x00) /*!< normal mode */ +#define CAN_Mode_LoopBack ((uint8_t)0x01) /*!< loopback mode */ +#define CAN_Mode_Silent ((uint8_t)0x02) /*!< silent mode */ +#define CAN_Mode_Silent_LoopBack ((uint8_t)0x03) /*!< loopback combined with silent mode */ + +#define IS_CAN_MODE(MODE) (((MODE) == CAN_Mode_Normal) || \ + ((MODE) == CAN_Mode_LoopBack)|| \ + ((MODE) == CAN_Mode_Silent) || \ + ((MODE) == CAN_Mode_Silent_LoopBack)) +/** + * @} + */ + + + /** + * @defgroup CAN_operating_mode + * @{ + */ +#define CAN_OperatingMode_Initialization ((uint8_t)0x00) /*!< Initialization mode */ +#define CAN_OperatingMode_Normal ((uint8_t)0x01) /*!< Normal mode */ +#define CAN_OperatingMode_Sleep ((uint8_t)0x02) /*!< sleep mode */ + + +#define IS_CAN_OPERATING_MODE(MODE) (((MODE) == CAN_OperatingMode_Initialization) ||\ + ((MODE) == CAN_OperatingMode_Normal)|| \ + ((MODE) == CAN_OperatingMode_Sleep)) +/** + * @} + */ + +/** + * @defgroup CAN_operating_mode_status + * @{ + */ + +#define CAN_ModeStatus_Failed ((uint8_t)0x00) /*!< CAN entering the specific mode failed */ +#define CAN_ModeStatus_Success ((uint8_t)!CAN_ModeStatus_Failed) /*!< CAN entering the specific mode Succeed */ +/** + * @} + */ + +/** @defgroup CAN_synchronisation_jump_width + * @{ + */ +#define CAN_SJW_1tq ((uint8_t)0x00) /*!< 1 time quantum */ +#define CAN_SJW_2tq ((uint8_t)0x01) /*!< 2 time quantum */ +#define CAN_SJW_3tq ((uint8_t)0x02) /*!< 3 time quantum */ +#define CAN_SJW_4tq ((uint8_t)0x03) /*!< 4 time quantum */ + +#define IS_CAN_SJW(SJW) (((SJW) == CAN_SJW_1tq) || ((SJW) == CAN_SJW_2tq)|| \ + ((SJW) == CAN_SJW_3tq) || ((SJW) == CAN_SJW_4tq)) +/** + * @} + */ + +/** @defgroup CAN_time_quantum_in_bit_segment_1 + * @{ + */ +#define CAN_BS1_1tq ((uint8_t)0x00) /*!< 1 time quantum */ +#define CAN_BS1_2tq ((uint8_t)0x01) /*!< 2 time quantum */ +#define CAN_BS1_3tq ((uint8_t)0x02) /*!< 3 time quantum */ +#define CAN_BS1_4tq ((uint8_t)0x03) /*!< 4 time quantum */ +#define CAN_BS1_5tq ((uint8_t)0x04) /*!< 5 time quantum */ +#define CAN_BS1_6tq ((uint8_t)0x05) /*!< 6 time quantum */ +#define CAN_BS1_7tq ((uint8_t)0x06) /*!< 7 time quantum */ +#define CAN_BS1_8tq ((uint8_t)0x07) /*!< 8 time quantum */ +#define CAN_BS1_9tq ((uint8_t)0x08) /*!< 9 time quantum */ +#define CAN_BS1_10tq ((uint8_t)0x09) /*!< 10 time quantum */ +#define CAN_BS1_11tq ((uint8_t)0x0A) /*!< 11 time quantum */ +#define CAN_BS1_12tq ((uint8_t)0x0B) /*!< 12 time quantum */ +#define CAN_BS1_13tq ((uint8_t)0x0C) /*!< 13 time quantum */ +#define CAN_BS1_14tq ((uint8_t)0x0D) /*!< 14 time quantum */ +#define CAN_BS1_15tq ((uint8_t)0x0E) /*!< 15 time quantum */ +#define CAN_BS1_16tq ((uint8_t)0x0F) /*!< 16 time quantum */ + +#define IS_CAN_BS1(BS1) ((BS1) <= CAN_BS1_16tq) +/** + * @} + */ + +/** @defgroup CAN_time_quantum_in_bit_segment_2 + * @{ + */ +#define CAN_BS2_1tq ((uint8_t)0x00) /*!< 1 time quantum */ +#define CAN_BS2_2tq ((uint8_t)0x01) /*!< 2 time quantum */ +#define CAN_BS2_3tq ((uint8_t)0x02) /*!< 3 time quantum */ +#define CAN_BS2_4tq ((uint8_t)0x03) /*!< 4 time quantum */ +#define CAN_BS2_5tq ((uint8_t)0x04) /*!< 5 time quantum */ +#define CAN_BS2_6tq ((uint8_t)0x05) /*!< 6 time quantum */ +#define CAN_BS2_7tq ((uint8_t)0x06) /*!< 7 time quantum */ +#define CAN_BS2_8tq ((uint8_t)0x07) /*!< 8 time quantum */ + +#define IS_CAN_BS2(BS2) ((BS2) <= CAN_BS2_8tq) +/** + * @} + */ + +/** @defgroup CAN_clock_prescaler + * @{ + */ +#define IS_CAN_PRESCALER(PRESCALER) (((PRESCALER) >= 1) && ((PRESCALER) <= 1024)) +/** + * @} + */ + +/** @defgroup CAN_filter_number + * @{ + */ +#define IS_CAN_FILTER_NUMBER(NUMBER) ((NUMBER) <= 27) +/** + * @} + */ + +/** @defgroup CAN_filter_mode + * @{ + */ +#define CAN_FilterMode_IdMask ((uint8_t)0x00) /*!< identifier/mask mode */ +#define CAN_FilterMode_IdList ((uint8_t)0x01) /*!< identifier list mode */ + +#define IS_CAN_FILTER_MODE(MODE) (((MODE) == CAN_FilterMode_IdMask) || \ + ((MODE) == CAN_FilterMode_IdList)) +/** + * @} + */ + +/** @defgroup CAN_filter_scale + * @{ + */ +#define CAN_FilterScale_16bit ((uint8_t)0x00) /*!< Two 16-bit filters */ +#define CAN_FilterScale_32bit ((uint8_t)0x01) /*!< One 32-bit filter */ + +#define IS_CAN_FILTER_SCALE(SCALE) (((SCALE) == CAN_FilterScale_16bit) || \ + ((SCALE) == CAN_FilterScale_32bit)) +/** + * @} + */ + +/** @defgroup CAN_filter_FIFO + * @{ + */ +#define CAN_Filter_FIFO0 ((uint8_t)0x00) /*!< Filter FIFO 0 assignment for filter x */ +#define CAN_Filter_FIFO1 ((uint8_t)0x01) /*!< Filter FIFO 1 assignment for filter x */ +#define IS_CAN_FILTER_FIFO(FIFO) (((FIFO) == CAN_FilterFIFO0) || \ + ((FIFO) == CAN_FilterFIFO1)) + +/* Legacy defines */ +#define CAN_FilterFIFO0 CAN_Filter_FIFO0 +#define CAN_FilterFIFO1 CAN_Filter_FIFO1 +/** + * @} + */ + +/** @defgroup CAN_Start_bank_filter_for_slave_CAN + * @{ + */ +#define IS_CAN_BANKNUMBER(BANKNUMBER) (((BANKNUMBER) >= 1) && ((BANKNUMBER) <= 27)) +/** + * @} + */ + +/** @defgroup CAN_Tx + * @{ + */ +#define IS_CAN_TRANSMITMAILBOX(TRANSMITMAILBOX) ((TRANSMITMAILBOX) <= ((uint8_t)0x02)) +#define IS_CAN_STDID(STDID) ((STDID) <= ((uint32_t)0x7FF)) +#define IS_CAN_EXTID(EXTID) ((EXTID) <= ((uint32_t)0x1FFFFFFF)) +#define IS_CAN_DLC(DLC) ((DLC) <= ((uint8_t)0x08)) +/** + * @} + */ + +/** @defgroup CAN_identifier_type + * @{ + */ +#define CAN_Id_Standard ((uint32_t)0x00000000) /*!< Standard Id */ +#define CAN_Id_Extended ((uint32_t)0x00000004) /*!< Extended Id */ +#define IS_CAN_IDTYPE(IDTYPE) (((IDTYPE) == CAN_Id_Standard) || \ + ((IDTYPE) == CAN_Id_Extended)) + +/* Legacy defines */ +#define CAN_ID_STD CAN_Id_Standard +#define CAN_ID_EXT CAN_Id_Extended +/** + * @} + */ + +/** @defgroup CAN_remote_transmission_request + * @{ + */ +#define CAN_RTR_Data ((uint32_t)0x00000000) /*!< Data frame */ +#define CAN_RTR_Remote ((uint32_t)0x00000002) /*!< Remote frame */ +#define IS_CAN_RTR(RTR) (((RTR) == CAN_RTR_Data) || ((RTR) == CAN_RTR_Remote)) + +/* Legacy defines */ +#define CAN_RTR_DATA CAN_RTR_Data +#define CAN_RTR_REMOTE CAN_RTR_Remote +/** + * @} + */ + +/** @defgroup CAN_transmit_constants + * @{ + */ +#define CAN_TxStatus_Failed ((uint8_t)0x00)/*!< CAN transmission failed */ +#define CAN_TxStatus_Ok ((uint8_t)0x01) /*!< CAN transmission succeeded */ +#define CAN_TxStatus_Pending ((uint8_t)0x02) /*!< CAN transmission pending */ +#define CAN_TxStatus_NoMailBox ((uint8_t)0x04) /*!< CAN cell did not provide + an empty mailbox */ +/* Legacy defines */ +#define CANTXFAILED CAN_TxStatus_Failed +#define CANTXOK CAN_TxStatus_Ok +#define CANTXPENDING CAN_TxStatus_Pending +#define CAN_NO_MB CAN_TxStatus_NoMailBox +/** + * @} + */ + +/** @defgroup CAN_receive_FIFO_number_constants + * @{ + */ +#define CAN_FIFO0 ((uint8_t)0x00) /*!< CAN FIFO 0 used to receive */ +#define CAN_FIFO1 ((uint8_t)0x01) /*!< CAN FIFO 1 used to receive */ + +#define IS_CAN_FIFO(FIFO) (((FIFO) == CAN_FIFO0) || ((FIFO) == CAN_FIFO1)) +/** + * @} + */ + +/** @defgroup CAN_sleep_constants + * @{ + */ +#define CAN_Sleep_Failed ((uint8_t)0x00) /*!< CAN did not enter the sleep mode */ +#define CAN_Sleep_Ok ((uint8_t)0x01) /*!< CAN entered the sleep mode */ + +/* Legacy defines */ +#define CANSLEEPFAILED CAN_Sleep_Failed +#define CANSLEEPOK CAN_Sleep_Ok +/** + * @} + */ + +/** @defgroup CAN_wake_up_constants + * @{ + */ +#define CAN_WakeUp_Failed ((uint8_t)0x00) /*!< CAN did not leave the sleep mode */ +#define CAN_WakeUp_Ok ((uint8_t)0x01) /*!< CAN leaved the sleep mode */ + +/* Legacy defines */ +#define CANWAKEUPFAILED CAN_WakeUp_Failed +#define CANWAKEUPOK CAN_WakeUp_Ok +/** + * @} + */ + +/** + * @defgroup CAN_Error_Code_constants + * @{ + */ +#define CAN_ErrorCode_NoErr ((uint8_t)0x00) /*!< No Error */ +#define CAN_ErrorCode_StuffErr ((uint8_t)0x10) /*!< Stuff Error */ +#define CAN_ErrorCode_FormErr ((uint8_t)0x20) /*!< Form Error */ +#define CAN_ErrorCode_ACKErr ((uint8_t)0x30) /*!< Acknowledgment Error */ +#define CAN_ErrorCode_BitRecessiveErr ((uint8_t)0x40) /*!< Bit Recessive Error */ +#define CAN_ErrorCode_BitDominantErr ((uint8_t)0x50) /*!< Bit Dominant Error */ +#define CAN_ErrorCode_CRCErr ((uint8_t)0x60) /*!< CRC Error */ +#define CAN_ErrorCode_SoftwareSetErr ((uint8_t)0x70) /*!< Software Set Error */ +/** + * @} + */ + +/** @defgroup CAN_flags + * @{ + */ +/* If the flag is 0x3XXXXXXX, it means that it can be used with CAN_GetFlagStatus() + and CAN_ClearFlag() functions. */ +/* If the flag is 0x1XXXXXXX, it means that it can only be used with + CAN_GetFlagStatus() function. */ + +/* Transmit Flags */ +#define CAN_FLAG_RQCP0 ((uint32_t)0x38000001) /*!< Request MailBox0 Flag */ +#define CAN_FLAG_RQCP1 ((uint32_t)0x38000100) /*!< Request MailBox1 Flag */ +#define CAN_FLAG_RQCP2 ((uint32_t)0x38010000) /*!< Request MailBox2 Flag */ + +/* Receive Flags */ +#define CAN_FLAG_FMP0 ((uint32_t)0x12000003) /*!< FIFO 0 Message Pending Flag */ +#define CAN_FLAG_FF0 ((uint32_t)0x32000008) /*!< FIFO 0 Full Flag */ +#define CAN_FLAG_FOV0 ((uint32_t)0x32000010) /*!< FIFO 0 Overrun Flag */ +#define CAN_FLAG_FMP1 ((uint32_t)0x14000003) /*!< FIFO 1 Message Pending Flag */ +#define CAN_FLAG_FF1 ((uint32_t)0x34000008) /*!< FIFO 1 Full Flag */ +#define CAN_FLAG_FOV1 ((uint32_t)0x34000010) /*!< FIFO 1 Overrun Flag */ + +/* Operating Mode Flags */ +#define CAN_FLAG_WKU ((uint32_t)0x31000008) /*!< Wake up Flag */ +#define CAN_FLAG_SLAK ((uint32_t)0x31000012) /*!< Sleep acknowledge Flag */ +/* @note When SLAK interrupt is disabled (SLKIE=0), no polling on SLAKI is possible. + In this case the SLAK bit can be polled.*/ + +/* Error Flags */ +#define CAN_FLAG_EWG ((uint32_t)0x10F00001) /*!< Error Warning Flag */ +#define CAN_FLAG_EPV ((uint32_t)0x10F00002) /*!< Error Passive Flag */ +#define CAN_FLAG_BOF ((uint32_t)0x10F00004) /*!< Bus-Off Flag */ +#define CAN_FLAG_LEC ((uint32_t)0x30F00070) /*!< Last error code Flag */ + +#define IS_CAN_GET_FLAG(FLAG) (((FLAG) == CAN_FLAG_LEC) || ((FLAG) == CAN_FLAG_BOF) || \ + ((FLAG) == CAN_FLAG_EPV) || ((FLAG) == CAN_FLAG_EWG) || \ + ((FLAG) == CAN_FLAG_WKU) || ((FLAG) == CAN_FLAG_FOV0) || \ + ((FLAG) == CAN_FLAG_FF0) || ((FLAG) == CAN_FLAG_FMP0) || \ + ((FLAG) == CAN_FLAG_FOV1) || ((FLAG) == CAN_FLAG_FF1) || \ + ((FLAG) == CAN_FLAG_FMP1) || ((FLAG) == CAN_FLAG_RQCP2) || \ + ((FLAG) == CAN_FLAG_RQCP1)|| ((FLAG) == CAN_FLAG_RQCP0) || \ + ((FLAG) == CAN_FLAG_SLAK )) + +#define IS_CAN_CLEAR_FLAG(FLAG)(((FLAG) == CAN_FLAG_LEC) || ((FLAG) == CAN_FLAG_RQCP2) || \ + ((FLAG) == CAN_FLAG_RQCP1) || ((FLAG) == CAN_FLAG_RQCP0) || \ + ((FLAG) == CAN_FLAG_FF0) || ((FLAG) == CAN_FLAG_FOV0) ||\ + ((FLAG) == CAN_FLAG_FF1) || ((FLAG) == CAN_FLAG_FOV1) || \ + ((FLAG) == CAN_FLAG_WKU) || ((FLAG) == CAN_FLAG_SLAK)) +/** + * @} + */ + + +/** @defgroup CAN_interrupts + * @{ + */ +#define CAN_IT_TME ((uint32_t)0x00000001) /*!< Transmit mailbox empty Interrupt*/ + +/* Receive Interrupts */ +#define CAN_IT_FMP0 ((uint32_t)0x00000002) /*!< FIFO 0 message pending Interrupt*/ +#define CAN_IT_FF0 ((uint32_t)0x00000004) /*!< FIFO 0 full Interrupt*/ +#define CAN_IT_FOV0 ((uint32_t)0x00000008) /*!< FIFO 0 overrun Interrupt*/ +#define CAN_IT_FMP1 ((uint32_t)0x00000010) /*!< FIFO 1 message pending Interrupt*/ +#define CAN_IT_FF1 ((uint32_t)0x00000020) /*!< FIFO 1 full Interrupt*/ +#define CAN_IT_FOV1 ((uint32_t)0x00000040) /*!< FIFO 1 overrun Interrupt*/ + +/* Operating Mode Interrupts */ +#define CAN_IT_WKU ((uint32_t)0x00010000) /*!< Wake-up Interrupt*/ +#define CAN_IT_SLK ((uint32_t)0x00020000) /*!< Sleep acknowledge Interrupt*/ + +/* Error Interrupts */ +#define CAN_IT_EWG ((uint32_t)0x00000100) /*!< Error warning Interrupt*/ +#define CAN_IT_EPV ((uint32_t)0x00000200) /*!< Error passive Interrupt*/ +#define CAN_IT_BOF ((uint32_t)0x00000400) /*!< Bus-off Interrupt*/ +#define CAN_IT_LEC ((uint32_t)0x00000800) /*!< Last error code Interrupt*/ +#define CAN_IT_ERR ((uint32_t)0x00008000) /*!< Error Interrupt*/ + +/* Flags named as Interrupts : kept only for FW compatibility */ +#define CAN_IT_RQCP0 CAN_IT_TME +#define CAN_IT_RQCP1 CAN_IT_TME +#define CAN_IT_RQCP2 CAN_IT_TME + + +#define IS_CAN_IT(IT) (((IT) == CAN_IT_TME) || ((IT) == CAN_IT_FMP0) ||\ + ((IT) == CAN_IT_FF0) || ((IT) == CAN_IT_FOV0) ||\ + ((IT) == CAN_IT_FMP1) || ((IT) == CAN_IT_FF1) ||\ + ((IT) == CAN_IT_FOV1) || ((IT) == CAN_IT_EWG) ||\ + ((IT) == CAN_IT_EPV) || ((IT) == CAN_IT_BOF) ||\ + ((IT) == CAN_IT_LEC) || ((IT) == CAN_IT_ERR) ||\ + ((IT) == CAN_IT_WKU) || ((IT) == CAN_IT_SLK)) + +#define IS_CAN_CLEAR_IT(IT) (((IT) == CAN_IT_TME) || ((IT) == CAN_IT_FF0) ||\ + ((IT) == CAN_IT_FOV0)|| ((IT) == CAN_IT_FF1) ||\ + ((IT) == CAN_IT_FOV1)|| ((IT) == CAN_IT_EWG) ||\ + ((IT) == CAN_IT_EPV) || ((IT) == CAN_IT_BOF) ||\ + ((IT) == CAN_IT_LEC) || ((IT) == CAN_IT_ERR) ||\ + ((IT) == CAN_IT_WKU) || ((IT) == CAN_IT_SLK)) +/** + * @} + */ + +/** + * @} + */ + +/* Exported macro ------------------------------------------------------------*/ +/* Exported functions --------------------------------------------------------*/ + +/* Function used to set the CAN configuration to the default reset state *****/ +void CAN_DeInit(CAN_TypeDef* CANx); + +/* Initialization and Configuration functions *********************************/ +uint8_t CAN_Init(CAN_TypeDef* CANx, CAN_InitTypeDef* CAN_InitStruct); +void CAN_FilterInit(CAN_FilterInitTypeDef* CAN_FilterInitStruct); +void CAN_StructInit(CAN_InitTypeDef* CAN_InitStruct); +void CAN_SlaveStartBank(uint8_t CAN_BankNumber); +void CAN_DBGFreeze(CAN_TypeDef* CANx, FunctionalState NewState); +void CAN_TTComModeCmd(CAN_TypeDef* CANx, FunctionalState NewState); + +/* CAN Frames Transmission functions ******************************************/ +uint8_t CAN_Transmit(CAN_TypeDef* CANx, CanTxMsg* TxMessage); +uint8_t CAN_TransmitStatus(CAN_TypeDef* CANx, uint8_t TransmitMailbox); +void CAN_CancelTransmit(CAN_TypeDef* CANx, uint8_t Mailbox); + +/* CAN Frames Reception functions *********************************************/ +void CAN_Receive(CAN_TypeDef* CANx, uint8_t FIFONumber, CanRxMsg* RxMessage); +void CAN_FIFORelease(CAN_TypeDef* CANx, uint8_t FIFONumber); +uint8_t CAN_MessagePending(CAN_TypeDef* CANx, uint8_t FIFONumber); + +/* Operation modes functions **************************************************/ +uint8_t CAN_OperatingModeRequest(CAN_TypeDef* CANx, uint8_t CAN_OperatingMode); +uint8_t CAN_Sleep(CAN_TypeDef* CANx); +uint8_t CAN_WakeUp(CAN_TypeDef* CANx); + +/* CAN Bus Error management functions *****************************************/ +uint8_t CAN_GetLastErrorCode(CAN_TypeDef* CANx); +uint8_t CAN_GetReceiveErrorCounter(CAN_TypeDef* CANx); +uint8_t CAN_GetLSBTransmitErrorCounter(CAN_TypeDef* CANx); + +/* Interrupts and flags management functions **********************************/ +void CAN_ITConfig(CAN_TypeDef* CANx, uint32_t CAN_IT, FunctionalState NewState); +FlagStatus CAN_GetFlagStatus(CAN_TypeDef* CANx, uint32_t CAN_FLAG); +void CAN_ClearFlag(CAN_TypeDef* CANx, uint32_t CAN_FLAG); +ITStatus CAN_GetITStatus(CAN_TypeDef* CANx, uint32_t CAN_IT); +void CAN_ClearITPendingBit(CAN_TypeDef* CANx, uint32_t CAN_IT); + +#ifdef __cplusplus +} +#endif + +#endif /* __STM32F4xx_CAN_H */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/inc/stm32f4xx_crc.h b/FWLIB/inc/stm32f4xx_crc.h new file mode 100644 index 0000000..9fb34f9 --- /dev/null +++ b/FWLIB/inc/stm32f4xx_crc.h @@ -0,0 +1,83 @@ +/** + ****************************************************************************** + * @file stm32f4xx_crc.h + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file contains all the functions prototypes for the CRC firmware + * library. + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Define to prevent recursive inclusion -------------------------------------*/ +#ifndef __STM32F4xx_CRC_H +#define __STM32F4xx_CRC_H + +#ifdef __cplusplus + extern "C" { +#endif + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @addtogroup CRC + * @{ + */ + +/* Exported types ------------------------------------------------------------*/ +/* Exported constants --------------------------------------------------------*/ + +/** @defgroup CRC_Exported_Constants + * @{ + */ + +/** + * @} + */ + +/* Exported macro ------------------------------------------------------------*/ +/* Exported functions --------------------------------------------------------*/ + +void CRC_ResetDR(void); +uint32_t CRC_CalcCRC(uint32_t Data); +uint32_t CRC_CalcBlockCRC(uint32_t pBuffer[], uint32_t BufferLength); +uint32_t CRC_GetCRC(void); +void CRC_SetIDRegister(uint8_t IDValue); +uint8_t CRC_GetIDRegister(void); + +#ifdef __cplusplus +} +#endif + +#endif /* __STM32F4xx_CRC_H */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/inc/stm32f4xx_cryp.h b/FWLIB/inc/stm32f4xx_cryp.h new file mode 100644 index 0000000..2d70d8b --- /dev/null +++ b/FWLIB/inc/stm32f4xx_cryp.h @@ -0,0 +1,384 @@ +/** + ****************************************************************************** + * @file stm32f4xx_cryp.h + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file contains all the functions prototypes for the Cryptographic + * processor(CRYP) firmware library. + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Define to prevent recursive inclusion -------------------------------------*/ +#ifndef __STM32F4xx_CRYP_H +#define __STM32F4xx_CRYP_H + +#ifdef __cplusplus + extern "C" { +#endif + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @addtogroup CRYP + * @{ + */ + +/* Exported types ------------------------------------------------------------*/ + +/** + * @brief CRYP Init structure definition + */ +typedef struct +{ + uint32_t CRYP_AlgoDir; /*!< Encrypt or Decrypt. This parameter can be a + value of @ref CRYP_Algorithm_Direction */ + uint32_t CRYP_AlgoMode; /*!< TDES-ECB, TDES-CBC, DES-ECB, DES-CBC, AES-ECB, + AES-CBC, AES-CTR, AES-Key, AES-GCM and AES-CCM. + This parameter can be a value of @ref CRYP_Algorithm_Mode */ + uint32_t CRYP_DataType; /*!< 32-bit data, 16-bit data, bit data or bit string. + This parameter can be a value of @ref CRYP_Data_Type */ + uint32_t CRYP_KeySize; /*!< Used only in AES mode only : 128, 192 or 256 bit + key length. This parameter can be a value of + @ref CRYP_Key_Size_for_AES_only */ +}CRYP_InitTypeDef; + +/** + * @brief CRYP Key(s) structure definition + */ +typedef struct +{ + uint32_t CRYP_Key0Left; /*!< Key 0 Left */ + uint32_t CRYP_Key0Right; /*!< Key 0 Right */ + uint32_t CRYP_Key1Left; /*!< Key 1 left */ + uint32_t CRYP_Key1Right; /*!< Key 1 Right */ + uint32_t CRYP_Key2Left; /*!< Key 2 left */ + uint32_t CRYP_Key2Right; /*!< Key 2 Right */ + uint32_t CRYP_Key3Left; /*!< Key 3 left */ + uint32_t CRYP_Key3Right; /*!< Key 3 Right */ +}CRYP_KeyInitTypeDef; +/** + * @brief CRYP Initialization Vectors (IV) structure definition + */ +typedef struct +{ + uint32_t CRYP_IV0Left; /*!< Init Vector 0 Left */ + uint32_t CRYP_IV0Right; /*!< Init Vector 0 Right */ + uint32_t CRYP_IV1Left; /*!< Init Vector 1 left */ + uint32_t CRYP_IV1Right; /*!< Init Vector 1 Right */ +}CRYP_IVInitTypeDef; + +/** + * @brief CRYP context swapping structure definition + */ +typedef struct +{ + /*!< Current Configuration */ + uint32_t CR_CurrentConfig; + /*!< IV */ + uint32_t CRYP_IV0LR; + uint32_t CRYP_IV0RR; + uint32_t CRYP_IV1LR; + uint32_t CRYP_IV1RR; + /*!< KEY */ + uint32_t CRYP_K0LR; + uint32_t CRYP_K0RR; + uint32_t CRYP_K1LR; + uint32_t CRYP_K1RR; + uint32_t CRYP_K2LR; + uint32_t CRYP_K2RR; + uint32_t CRYP_K3LR; + uint32_t CRYP_K3RR; + uint32_t CRYP_CSGCMCCMR[8]; + uint32_t CRYP_CSGCMR[8]; +}CRYP_Context; + + +/* Exported constants --------------------------------------------------------*/ + +/** @defgroup CRYP_Exported_Constants + * @{ + */ + +/** @defgroup CRYP_Algorithm_Direction + * @{ + */ +#define CRYP_AlgoDir_Encrypt ((uint16_t)0x0000) +#define CRYP_AlgoDir_Decrypt ((uint16_t)0x0004) +#define IS_CRYP_ALGODIR(ALGODIR) (((ALGODIR) == CRYP_AlgoDir_Encrypt) || \ + ((ALGODIR) == CRYP_AlgoDir_Decrypt)) + +/** + * @} + */ + +/** @defgroup CRYP_Algorithm_Mode + * @{ + */ + +/*!< TDES Modes */ +#define CRYP_AlgoMode_TDES_ECB ((uint32_t)0x00000000) +#define CRYP_AlgoMode_TDES_CBC ((uint32_t)0x00000008) + +/*!< DES Modes */ +#define CRYP_AlgoMode_DES_ECB ((uint32_t)0x00000010) +#define CRYP_AlgoMode_DES_CBC ((uint32_t)0x00000018) + +/*!< AES Modes */ +#define CRYP_AlgoMode_AES_ECB ((uint32_t)0x00000020) +#define CRYP_AlgoMode_AES_CBC ((uint32_t)0x00000028) +#define CRYP_AlgoMode_AES_CTR ((uint32_t)0x00000030) +#define CRYP_AlgoMode_AES_Key ((uint32_t)0x00000038) +#define CRYP_AlgoMode_AES_GCM ((uint32_t)0x00080000) +#define CRYP_AlgoMode_AES_CCM ((uint32_t)0x00080008) + +#define IS_CRYP_ALGOMODE(ALGOMODE) (((ALGOMODE) == CRYP_AlgoMode_TDES_ECB) || \ + ((ALGOMODE) == CRYP_AlgoMode_TDES_CBC)|| \ + ((ALGOMODE) == CRYP_AlgoMode_DES_ECB) || \ + ((ALGOMODE) == CRYP_AlgoMode_DES_CBC) || \ + ((ALGOMODE) == CRYP_AlgoMode_AES_ECB) || \ + ((ALGOMODE) == CRYP_AlgoMode_AES_CBC) || \ + ((ALGOMODE) == CRYP_AlgoMode_AES_CTR) || \ + ((ALGOMODE) == CRYP_AlgoMode_AES_Key) || \ + ((ALGOMODE) == CRYP_AlgoMode_AES_GCM) || \ + ((ALGOMODE) == CRYP_AlgoMode_AES_CCM)) +/** + * @} + */ + +/** @defgroup CRYP_Phase + * @{ + */ + +/*!< The phases are valid only for AES-GCM and AES-CCM modes */ +#define CRYP_Phase_Init ((uint32_t)0x00000000) +#define CRYP_Phase_Header CRYP_CR_GCM_CCMPH_0 +#define CRYP_Phase_Payload CRYP_CR_GCM_CCMPH_1 +#define CRYP_Phase_Final CRYP_CR_GCM_CCMPH + +#define IS_CRYP_PHASE(PHASE) (((PHASE) == CRYP_Phase_Init) || \ + ((PHASE) == CRYP_Phase_Header) || \ + ((PHASE) == CRYP_Phase_Payload) || \ + ((PHASE) == CRYP_Phase_Final)) + +/** + * @} + */ + +/** @defgroup CRYP_Data_Type + * @{ + */ +#define CRYP_DataType_32b ((uint16_t)0x0000) +#define CRYP_DataType_16b ((uint16_t)0x0040) +#define CRYP_DataType_8b ((uint16_t)0x0080) +#define CRYP_DataType_1b ((uint16_t)0x00C0) +#define IS_CRYP_DATATYPE(DATATYPE) (((DATATYPE) == CRYP_DataType_32b) || \ + ((DATATYPE) == CRYP_DataType_16b)|| \ + ((DATATYPE) == CRYP_DataType_8b)|| \ + ((DATATYPE) == CRYP_DataType_1b)) +/** + * @} + */ + +/** @defgroup CRYP_Key_Size_for_AES_only + * @{ + */ +#define CRYP_KeySize_128b ((uint16_t)0x0000) +#define CRYP_KeySize_192b ((uint16_t)0x0100) +#define CRYP_KeySize_256b ((uint16_t)0x0200) +#define IS_CRYP_KEYSIZE(KEYSIZE) (((KEYSIZE) == CRYP_KeySize_128b)|| \ + ((KEYSIZE) == CRYP_KeySize_192b)|| \ + ((KEYSIZE) == CRYP_KeySize_256b)) +/** + * @} + */ + +/** @defgroup CRYP_flags_definition + * @{ + */ +#define CRYP_FLAG_BUSY ((uint8_t)0x10) /*!< The CRYP core is currently + processing a block of data + or a key preparation (for + AES decryption). */ +#define CRYP_FLAG_IFEM ((uint8_t)0x01) /*!< Input Fifo Empty */ +#define CRYP_FLAG_IFNF ((uint8_t)0x02) /*!< Input Fifo is Not Full */ +#define CRYP_FLAG_INRIS ((uint8_t)0x22) /*!< Raw interrupt pending */ +#define CRYP_FLAG_OFNE ((uint8_t)0x04) /*!< Input Fifo service raw + interrupt status */ +#define CRYP_FLAG_OFFU ((uint8_t)0x08) /*!< Output Fifo is Full */ +#define CRYP_FLAG_OUTRIS ((uint8_t)0x21) /*!< Output Fifo service raw + interrupt status */ + +#define IS_CRYP_GET_FLAG(FLAG) (((FLAG) == CRYP_FLAG_IFEM) || \ + ((FLAG) == CRYP_FLAG_IFNF) || \ + ((FLAG) == CRYP_FLAG_OFNE) || \ + ((FLAG) == CRYP_FLAG_OFFU) || \ + ((FLAG) == CRYP_FLAG_BUSY) || \ + ((FLAG) == CRYP_FLAG_OUTRIS)|| \ + ((FLAG) == CRYP_FLAG_INRIS)) +/** + * @} + */ + +/** @defgroup CRYP_interrupts_definition + * @{ + */ +#define CRYP_IT_INI ((uint8_t)0x01) /*!< IN Fifo Interrupt */ +#define CRYP_IT_OUTI ((uint8_t)0x02) /*!< OUT Fifo Interrupt */ +#define IS_CRYP_CONFIG_IT(IT) ((((IT) & (uint8_t)0xFC) == 0x00) && ((IT) != 0x00)) +#define IS_CRYP_GET_IT(IT) (((IT) == CRYP_IT_INI) || ((IT) == CRYP_IT_OUTI)) + +/** + * @} + */ + +/** @defgroup CRYP_Encryption_Decryption_modes_definition + * @{ + */ +#define MODE_ENCRYPT ((uint8_t)0x01) +#define MODE_DECRYPT ((uint8_t)0x00) + +/** + * @} + */ + +/** @defgroup CRYP_DMA_transfer_requests + * @{ + */ +#define CRYP_DMAReq_DataIN ((uint8_t)0x01) +#define CRYP_DMAReq_DataOUT ((uint8_t)0x02) +#define IS_CRYP_DMAREQ(DMAREQ) ((((DMAREQ) & (uint8_t)0xFC) == 0x00) && ((DMAREQ) != 0x00)) +/** + * @} + */ + +/** + * @} + */ + +/* Exported macro ------------------------------------------------------------*/ +/* Exported functions --------------------------------------------------------*/ + +/* Function used to set the CRYP configuration to the default reset state ****/ +void CRYP_DeInit(void); + +/* CRYP Initialization and Configuration functions ****************************/ +void CRYP_Init(CRYP_InitTypeDef* CRYP_InitStruct); +void CRYP_StructInit(CRYP_InitTypeDef* CRYP_InitStruct); +void CRYP_KeyInit(CRYP_KeyInitTypeDef* CRYP_KeyInitStruct); +void CRYP_KeyStructInit(CRYP_KeyInitTypeDef* CRYP_KeyInitStruct); +void CRYP_IVInit(CRYP_IVInitTypeDef* CRYP_IVInitStruct); +void CRYP_IVStructInit(CRYP_IVInitTypeDef* CRYP_IVInitStruct); +void CRYP_Cmd(FunctionalState NewState); +void CRYP_PhaseConfig(uint32_t CRYP_Phase); +void CRYP_FIFOFlush(void); +/* CRYP Data processing functions *********************************************/ +void CRYP_DataIn(uint32_t Data); +uint32_t CRYP_DataOut(void); + +/* CRYP Context swapping functions ********************************************/ +ErrorStatus CRYP_SaveContext(CRYP_Context* CRYP_ContextSave, + CRYP_KeyInitTypeDef* CRYP_KeyInitStruct); +void CRYP_RestoreContext(CRYP_Context* CRYP_ContextRestore); + +/* CRYP DMA interface function ************************************************/ +void CRYP_DMACmd(uint8_t CRYP_DMAReq, FunctionalState NewState); + +/* Interrupts and flags management functions **********************************/ +void CRYP_ITConfig(uint8_t CRYP_IT, FunctionalState NewState); +ITStatus CRYP_GetITStatus(uint8_t CRYP_IT); +FunctionalState CRYP_GetCmdStatus(void); +FlagStatus CRYP_GetFlagStatus(uint8_t CRYP_FLAG); + +/* High Level AES functions **************************************************/ +ErrorStatus CRYP_AES_ECB(uint8_t Mode, + uint8_t *Key, uint16_t Keysize, + uint8_t *Input, uint32_t Ilength, + uint8_t *Output); + +ErrorStatus CRYP_AES_CBC(uint8_t Mode, + uint8_t InitVectors[16], + uint8_t *Key, uint16_t Keysize, + uint8_t *Input, uint32_t Ilength, + uint8_t *Output); + +ErrorStatus CRYP_AES_CTR(uint8_t Mode, + uint8_t InitVectors[16], + uint8_t *Key, uint16_t Keysize, + uint8_t *Input, uint32_t Ilength, + uint8_t *Output); + +ErrorStatus CRYP_AES_GCM(uint8_t Mode, uint8_t InitVectors[16], + uint8_t *Key, uint16_t Keysize, + uint8_t *Input, uint32_t ILength, + uint8_t *Header, uint32_t HLength, + uint8_t *Output, uint8_t *AuthTAG); + +ErrorStatus CRYP_AES_CCM(uint8_t Mode, + uint8_t* Nonce, uint32_t NonceSize, + uint8_t* Key, uint16_t Keysize, + uint8_t* Input, uint32_t ILength, + uint8_t* Header, uint32_t HLength, uint8_t *HBuffer, + uint8_t* Output, + uint8_t* AuthTAG, uint32_t TAGSize); + +/* High Level TDES functions **************************************************/ +ErrorStatus CRYP_TDES_ECB(uint8_t Mode, + uint8_t Key[24], + uint8_t *Input, uint32_t Ilength, + uint8_t *Output); + +ErrorStatus CRYP_TDES_CBC(uint8_t Mode, + uint8_t Key[24], + uint8_t InitVectors[8], + uint8_t *Input, uint32_t Ilength, + uint8_t *Output); + +/* High Level DES functions **************************************************/ +ErrorStatus CRYP_DES_ECB(uint8_t Mode, + uint8_t Key[8], + uint8_t *Input, uint32_t Ilength, + uint8_t *Output); + +ErrorStatus CRYP_DES_CBC(uint8_t Mode, + uint8_t Key[8], + uint8_t InitVectors[8], + uint8_t *Input,uint32_t Ilength, + uint8_t *Output); + +#ifdef __cplusplus +} +#endif + +#endif /*__STM32F4xx_CRYP_H */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/inc/stm32f4xx_dac.h b/FWLIB/inc/stm32f4xx_dac.h new file mode 100644 index 0000000..13ce2e8 --- /dev/null +++ b/FWLIB/inc/stm32f4xx_dac.h @@ -0,0 +1,304 @@ +/** + ****************************************************************************** + * @file stm32f4xx_dac.h + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file contains all the functions prototypes for the DAC firmware + * library. + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Define to prevent recursive inclusion -------------------------------------*/ +#ifndef __STM32F4xx_DAC_H +#define __STM32F4xx_DAC_H + +#ifdef __cplusplus + extern "C" { +#endif + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @addtogroup DAC + * @{ + */ + +/* Exported types ------------------------------------------------------------*/ + +/** + * @brief DAC Init structure definition + */ + +typedef struct +{ + uint32_t DAC_Trigger; /*!< Specifies the external trigger for the selected DAC channel. + This parameter can be a value of @ref DAC_trigger_selection */ + + uint32_t DAC_WaveGeneration; /*!< Specifies whether DAC channel noise waves or triangle waves + are generated, or whether no wave is generated. + This parameter can be a value of @ref DAC_wave_generation */ + + uint32_t DAC_LFSRUnmask_TriangleAmplitude; /*!< Specifies the LFSR mask for noise wave generation or + the maximum amplitude triangle generation for the DAC channel. + This parameter can be a value of @ref DAC_lfsrunmask_triangleamplitude */ + + uint32_t DAC_OutputBuffer; /*!< Specifies whether the DAC channel output buffer is enabled or disabled. + This parameter can be a value of @ref DAC_output_buffer */ +}DAC_InitTypeDef; + +/* Exported constants --------------------------------------------------------*/ + +/** @defgroup DAC_Exported_Constants + * @{ + */ + +/** @defgroup DAC_trigger_selection + * @{ + */ + +#define DAC_Trigger_None ((uint32_t)0x00000000) /*!< Conversion is automatic once the DAC1_DHRxxxx register + has been loaded, and not by external trigger */ +#define DAC_Trigger_T2_TRGO ((uint32_t)0x00000024) /*!< TIM2 TRGO selected as external conversion trigger for DAC channel */ +#define DAC_Trigger_T4_TRGO ((uint32_t)0x0000002C) /*!< TIM4 TRGO selected as external conversion trigger for DAC channel */ +#define DAC_Trigger_T5_TRGO ((uint32_t)0x0000001C) /*!< TIM5 TRGO selected as external conversion trigger for DAC channel */ +#define DAC_Trigger_T6_TRGO ((uint32_t)0x00000004) /*!< TIM6 TRGO selected as external conversion trigger for DAC channel */ +#define DAC_Trigger_T7_TRGO ((uint32_t)0x00000014) /*!< TIM7 TRGO selected as external conversion trigger for DAC channel */ +#define DAC_Trigger_T8_TRGO ((uint32_t)0x0000000C) /*!< TIM8 TRGO selected as external conversion trigger for DAC channel */ + +#define DAC_Trigger_Ext_IT9 ((uint32_t)0x00000034) /*!< EXTI Line9 event selected as external conversion trigger for DAC channel */ +#define DAC_Trigger_Software ((uint32_t)0x0000003C) /*!< Conversion started by software trigger for DAC channel */ + +#define IS_DAC_TRIGGER(TRIGGER) (((TRIGGER) == DAC_Trigger_None) || \ + ((TRIGGER) == DAC_Trigger_T6_TRGO) || \ + ((TRIGGER) == DAC_Trigger_T8_TRGO) || \ + ((TRIGGER) == DAC_Trigger_T7_TRGO) || \ + ((TRIGGER) == DAC_Trigger_T5_TRGO) || \ + ((TRIGGER) == DAC_Trigger_T2_TRGO) || \ + ((TRIGGER) == DAC_Trigger_T4_TRGO) || \ + ((TRIGGER) == DAC_Trigger_Ext_IT9) || \ + ((TRIGGER) == DAC_Trigger_Software)) + +/** + * @} + */ + +/** @defgroup DAC_wave_generation + * @{ + */ + +#define DAC_WaveGeneration_None ((uint32_t)0x00000000) +#define DAC_WaveGeneration_Noise ((uint32_t)0x00000040) +#define DAC_WaveGeneration_Triangle ((uint32_t)0x00000080) +#define IS_DAC_GENERATE_WAVE(WAVE) (((WAVE) == DAC_WaveGeneration_None) || \ + ((WAVE) == DAC_WaveGeneration_Noise) || \ + ((WAVE) == DAC_WaveGeneration_Triangle)) +/** + * @} + */ + +/** @defgroup DAC_lfsrunmask_triangleamplitude + * @{ + */ + +#define DAC_LFSRUnmask_Bit0 ((uint32_t)0x00000000) /*!< Unmask DAC channel LFSR bit0 for noise wave generation */ +#define DAC_LFSRUnmask_Bits1_0 ((uint32_t)0x00000100) /*!< Unmask DAC channel LFSR bit[1:0] for noise wave generation */ +#define DAC_LFSRUnmask_Bits2_0 ((uint32_t)0x00000200) /*!< Unmask DAC channel LFSR bit[2:0] for noise wave generation */ +#define DAC_LFSRUnmask_Bits3_0 ((uint32_t)0x00000300) /*!< Unmask DAC channel LFSR bit[3:0] for noise wave generation */ +#define DAC_LFSRUnmask_Bits4_0 ((uint32_t)0x00000400) /*!< Unmask DAC channel LFSR bit[4:0] for noise wave generation */ +#define DAC_LFSRUnmask_Bits5_0 ((uint32_t)0x00000500) /*!< Unmask DAC channel LFSR bit[5:0] for noise wave generation */ +#define DAC_LFSRUnmask_Bits6_0 ((uint32_t)0x00000600) /*!< Unmask DAC channel LFSR bit[6:0] for noise wave generation */ +#define DAC_LFSRUnmask_Bits7_0 ((uint32_t)0x00000700) /*!< Unmask DAC channel LFSR bit[7:0] for noise wave generation */ +#define DAC_LFSRUnmask_Bits8_0 ((uint32_t)0x00000800) /*!< Unmask DAC channel LFSR bit[8:0] for noise wave generation */ +#define DAC_LFSRUnmask_Bits9_0 ((uint32_t)0x00000900) /*!< Unmask DAC channel LFSR bit[9:0] for noise wave generation */ +#define DAC_LFSRUnmask_Bits10_0 ((uint32_t)0x00000A00) /*!< Unmask DAC channel LFSR bit[10:0] for noise wave generation */ +#define DAC_LFSRUnmask_Bits11_0 ((uint32_t)0x00000B00) /*!< Unmask DAC channel LFSR bit[11:0] for noise wave generation */ +#define DAC_TriangleAmplitude_1 ((uint32_t)0x00000000) /*!< Select max triangle amplitude of 1 */ +#define DAC_TriangleAmplitude_3 ((uint32_t)0x00000100) /*!< Select max triangle amplitude of 3 */ +#define DAC_TriangleAmplitude_7 ((uint32_t)0x00000200) /*!< Select max triangle amplitude of 7 */ +#define DAC_TriangleAmplitude_15 ((uint32_t)0x00000300) /*!< Select max triangle amplitude of 15 */ +#define DAC_TriangleAmplitude_31 ((uint32_t)0x00000400) /*!< Select max triangle amplitude of 31 */ +#define DAC_TriangleAmplitude_63 ((uint32_t)0x00000500) /*!< Select max triangle amplitude of 63 */ +#define DAC_TriangleAmplitude_127 ((uint32_t)0x00000600) /*!< Select max triangle amplitude of 127 */ +#define DAC_TriangleAmplitude_255 ((uint32_t)0x00000700) /*!< Select max triangle amplitude of 255 */ +#define DAC_TriangleAmplitude_511 ((uint32_t)0x00000800) /*!< Select max triangle amplitude of 511 */ +#define DAC_TriangleAmplitude_1023 ((uint32_t)0x00000900) /*!< Select max triangle amplitude of 1023 */ +#define DAC_TriangleAmplitude_2047 ((uint32_t)0x00000A00) /*!< Select max triangle amplitude of 2047 */ +#define DAC_TriangleAmplitude_4095 ((uint32_t)0x00000B00) /*!< Select max triangle amplitude of 4095 */ + +#define IS_DAC_LFSR_UNMASK_TRIANGLE_AMPLITUDE(VALUE) (((VALUE) == DAC_LFSRUnmask_Bit0) || \ + ((VALUE) == DAC_LFSRUnmask_Bits1_0) || \ + ((VALUE) == DAC_LFSRUnmask_Bits2_0) || \ + ((VALUE) == DAC_LFSRUnmask_Bits3_0) || \ + ((VALUE) == DAC_LFSRUnmask_Bits4_0) || \ + ((VALUE) == DAC_LFSRUnmask_Bits5_0) || \ + ((VALUE) == DAC_LFSRUnmask_Bits6_0) || \ + ((VALUE) == DAC_LFSRUnmask_Bits7_0) || \ + ((VALUE) == DAC_LFSRUnmask_Bits8_0) || \ + ((VALUE) == DAC_LFSRUnmask_Bits9_0) || \ + ((VALUE) == DAC_LFSRUnmask_Bits10_0) || \ + ((VALUE) == DAC_LFSRUnmask_Bits11_0) || \ + ((VALUE) == DAC_TriangleAmplitude_1) || \ + ((VALUE) == DAC_TriangleAmplitude_3) || \ + ((VALUE) == DAC_TriangleAmplitude_7) || \ + ((VALUE) == DAC_TriangleAmplitude_15) || \ + ((VALUE) == DAC_TriangleAmplitude_31) || \ + ((VALUE) == DAC_TriangleAmplitude_63) || \ + ((VALUE) == DAC_TriangleAmplitude_127) || \ + ((VALUE) == DAC_TriangleAmplitude_255) || \ + ((VALUE) == DAC_TriangleAmplitude_511) || \ + ((VALUE) == DAC_TriangleAmplitude_1023) || \ + ((VALUE) == DAC_TriangleAmplitude_2047) || \ + ((VALUE) == DAC_TriangleAmplitude_4095)) +/** + * @} + */ + +/** @defgroup DAC_output_buffer + * @{ + */ + +#define DAC_OutputBuffer_Enable ((uint32_t)0x00000000) +#define DAC_OutputBuffer_Disable ((uint32_t)0x00000002) +#define IS_DAC_OUTPUT_BUFFER_STATE(STATE) (((STATE) == DAC_OutputBuffer_Enable) || \ + ((STATE) == DAC_OutputBuffer_Disable)) +/** + * @} + */ + +/** @defgroup DAC_Channel_selection + * @{ + */ + +#define DAC_Channel_1 ((uint32_t)0x00000000) +#define DAC_Channel_2 ((uint32_t)0x00000010) +#define IS_DAC_CHANNEL(CHANNEL) (((CHANNEL) == DAC_Channel_1) || \ + ((CHANNEL) == DAC_Channel_2)) +/** + * @} + */ + +/** @defgroup DAC_data_alignement + * @{ + */ + +#define DAC_Align_12b_R ((uint32_t)0x00000000) +#define DAC_Align_12b_L ((uint32_t)0x00000004) +#define DAC_Align_8b_R ((uint32_t)0x00000008) +#define IS_DAC_ALIGN(ALIGN) (((ALIGN) == DAC_Align_12b_R) || \ + ((ALIGN) == DAC_Align_12b_L) || \ + ((ALIGN) == DAC_Align_8b_R)) +/** + * @} + */ + +/** @defgroup DAC_wave_generation + * @{ + */ + +#define DAC_Wave_Noise ((uint32_t)0x00000040) +#define DAC_Wave_Triangle ((uint32_t)0x00000080) +#define IS_DAC_WAVE(WAVE) (((WAVE) == DAC_Wave_Noise) || \ + ((WAVE) == DAC_Wave_Triangle)) +/** + * @} + */ + +/** @defgroup DAC_data + * @{ + */ + +#define IS_DAC_DATA(DATA) ((DATA) <= 0xFFF0) +/** + * @} + */ + +/** @defgroup DAC_interrupts_definition + * @{ + */ +#define DAC_IT_DMAUDR ((uint32_t)0x00002000) +#define IS_DAC_IT(IT) (((IT) == DAC_IT_DMAUDR)) + +/** + * @} + */ + +/** @defgroup DAC_flags_definition + * @{ + */ + +#define DAC_FLAG_DMAUDR ((uint32_t)0x00002000) +#define IS_DAC_FLAG(FLAG) (((FLAG) == DAC_FLAG_DMAUDR)) + +/** + * @} + */ + +/** + * @} + */ + +/* Exported macro ------------------------------------------------------------*/ +/* Exported functions --------------------------------------------------------*/ + +/* Function used to set the DAC configuration to the default reset state *****/ +void DAC_DeInit(void); + +/* DAC channels configuration: trigger, output buffer, data format functions */ +void DAC_Init(uint32_t DAC_Channel, DAC_InitTypeDef* DAC_InitStruct); +void DAC_StructInit(DAC_InitTypeDef* DAC_InitStruct); +void DAC_Cmd(uint32_t DAC_Channel, FunctionalState NewState); +void DAC_SoftwareTriggerCmd(uint32_t DAC_Channel, FunctionalState NewState); +void DAC_DualSoftwareTriggerCmd(FunctionalState NewState); +void DAC_WaveGenerationCmd(uint32_t DAC_Channel, uint32_t DAC_Wave, FunctionalState NewState); +void DAC_SetChannel1Data(uint32_t DAC_Align, uint16_t Data); +void DAC_SetChannel2Data(uint32_t DAC_Align, uint16_t Data); +void DAC_SetDualChannelData(uint32_t DAC_Align, uint16_t Data2, uint16_t Data1); +uint16_t DAC_GetDataOutputValue(uint32_t DAC_Channel); + +/* DMA management functions ***************************************************/ +void DAC_DMACmd(uint32_t DAC_Channel, FunctionalState NewState); + +/* Interrupts and flags management functions **********************************/ +void DAC_ITConfig(uint32_t DAC_Channel, uint32_t DAC_IT, FunctionalState NewState); +FlagStatus DAC_GetFlagStatus(uint32_t DAC_Channel, uint32_t DAC_FLAG); +void DAC_ClearFlag(uint32_t DAC_Channel, uint32_t DAC_FLAG); +ITStatus DAC_GetITStatus(uint32_t DAC_Channel, uint32_t DAC_IT); +void DAC_ClearITPendingBit(uint32_t DAC_Channel, uint32_t DAC_IT); + +#ifdef __cplusplus +} +#endif + +#endif /*__STM32F4xx_DAC_H */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/inc/stm32f4xx_dbgmcu.h b/FWLIB/inc/stm32f4xx_dbgmcu.h new file mode 100644 index 0000000..5e70ffd --- /dev/null +++ b/FWLIB/inc/stm32f4xx_dbgmcu.h @@ -0,0 +1,109 @@ +/** + ****************************************************************************** + * @file stm32f4xx_dbgmcu.h + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file contains all the functions prototypes for the DBGMCU firmware library. + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Define to prevent recursive inclusion -------------------------------------*/ +#ifndef __STM32F4xx_DBGMCU_H +#define __STM32F4xx_DBGMCU_H + +#ifdef __cplusplus + extern "C" { +#endif + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @addtogroup DBGMCU + * @{ + */ + +/* Exported types ------------------------------------------------------------*/ +/* Exported constants --------------------------------------------------------*/ + +/** @defgroup DBGMCU_Exported_Constants + * @{ + */ +#define DBGMCU_SLEEP ((uint32_t)0x00000001) +#define DBGMCU_STOP ((uint32_t)0x00000002) +#define DBGMCU_STANDBY ((uint32_t)0x00000004) +#define IS_DBGMCU_PERIPH(PERIPH) ((((PERIPH) & 0xFFFFFFF8) == 0x00) && ((PERIPH) != 0x00)) + +#define DBGMCU_TIM2_STOP ((uint32_t)0x00000001) +#define DBGMCU_TIM3_STOP ((uint32_t)0x00000002) +#define DBGMCU_TIM4_STOP ((uint32_t)0x00000004) +#define DBGMCU_TIM5_STOP ((uint32_t)0x00000008) +#define DBGMCU_TIM6_STOP ((uint32_t)0x00000010) +#define DBGMCU_TIM7_STOP ((uint32_t)0x00000020) +#define DBGMCU_TIM12_STOP ((uint32_t)0x00000040) +#define DBGMCU_TIM13_STOP ((uint32_t)0x00000080) +#define DBGMCU_TIM14_STOP ((uint32_t)0x00000100) +#define DBGMCU_RTC_STOP ((uint32_t)0x00000400) +#define DBGMCU_WWDG_STOP ((uint32_t)0x00000800) +#define DBGMCU_IWDG_STOP ((uint32_t)0x00001000) +#define DBGMCU_I2C1_SMBUS_TIMEOUT ((uint32_t)0x00200000) +#define DBGMCU_I2C2_SMBUS_TIMEOUT ((uint32_t)0x00400000) +#define DBGMCU_I2C3_SMBUS_TIMEOUT ((uint32_t)0x00800000) +#define DBGMCU_CAN1_STOP ((uint32_t)0x02000000) +#define DBGMCU_CAN2_STOP ((uint32_t)0x04000000) +#define IS_DBGMCU_APB1PERIPH(PERIPH) ((((PERIPH) & 0xF91FE200) == 0x00) && ((PERIPH) != 0x00)) + +#define DBGMCU_TIM1_STOP ((uint32_t)0x00000001) +#define DBGMCU_TIM8_STOP ((uint32_t)0x00000002) +#define DBGMCU_TIM9_STOP ((uint32_t)0x00010000) +#define DBGMCU_TIM10_STOP ((uint32_t)0x00020000) +#define DBGMCU_TIM11_STOP ((uint32_t)0x00040000) +#define IS_DBGMCU_APB2PERIPH(PERIPH) ((((PERIPH) & 0xFFF8FFFC) == 0x00) && ((PERIPH) != 0x00)) +/** + * @} + */ + +/* Exported macro ------------------------------------------------------------*/ +/* Exported functions --------------------------------------------------------*/ +uint32_t DBGMCU_GetREVID(void); +uint32_t DBGMCU_GetDEVID(void); +void DBGMCU_Config(uint32_t DBGMCU_Periph, FunctionalState NewState); +void DBGMCU_APB1PeriphConfig(uint32_t DBGMCU_Periph, FunctionalState NewState); +void DBGMCU_APB2PeriphConfig(uint32_t DBGMCU_Periph, FunctionalState NewState); + +#ifdef __cplusplus +} +#endif + +#endif /* __STM32F4xx_DBGMCU_H */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/inc/stm32f4xx_dcmi.h b/FWLIB/inc/stm32f4xx_dcmi.h new file mode 100644 index 0000000..fa71500 --- /dev/null +++ b/FWLIB/inc/stm32f4xx_dcmi.h @@ -0,0 +1,312 @@ +/** + ****************************************************************************** + * @file stm32f4xx_dcmi.h + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file contains all the functions prototypes for the DCMI firmware library. + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Define to prevent recursive inclusion -------------------------------------*/ +#ifndef __STM32F4xx_DCMI_H +#define __STM32F4xx_DCMI_H + +#ifdef __cplusplus + extern "C" { +#endif + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @addtogroup DCMI + * @{ + */ + +/* Exported types ------------------------------------------------------------*/ +/** + * @brief DCMI Init structure definition + */ +typedef struct +{ + uint16_t DCMI_CaptureMode; /*!< Specifies the Capture Mode: Continuous or Snapshot. + This parameter can be a value of @ref DCMI_Capture_Mode */ + + uint16_t DCMI_SynchroMode; /*!< Specifies the Synchronization Mode: Hardware or Embedded. + This parameter can be a value of @ref DCMI_Synchronization_Mode */ + + uint16_t DCMI_PCKPolarity; /*!< Specifies the Pixel clock polarity: Falling or Rising. + This parameter can be a value of @ref DCMI_PIXCK_Polarity */ + + uint16_t DCMI_VSPolarity; /*!< Specifies the Vertical synchronization polarity: High or Low. + This parameter can be a value of @ref DCMI_VSYNC_Polarity */ + + uint16_t DCMI_HSPolarity; /*!< Specifies the Horizontal synchronization polarity: High or Low. + This parameter can be a value of @ref DCMI_HSYNC_Polarity */ + + uint16_t DCMI_CaptureRate; /*!< Specifies the frequency of frame capture: All, 1/2 or 1/4. + This parameter can be a value of @ref DCMI_Capture_Rate */ + + uint16_t DCMI_ExtendedDataMode; /*!< Specifies the data width: 8-bit, 10-bit, 12-bit or 14-bit. + This parameter can be a value of @ref DCMI_Extended_Data_Mode */ +} DCMI_InitTypeDef; + +/** + * @brief DCMI CROP Init structure definition + */ +typedef struct +{ + uint16_t DCMI_VerticalStartLine; /*!< Specifies the Vertical start line count from which the image capture + will start. This parameter can be a value between 0x00 and 0x1FFF */ + + uint16_t DCMI_HorizontalOffsetCount; /*!< Specifies the number of pixel clocks to count before starting a capture. + This parameter can be a value between 0x00 and 0x3FFF */ + + uint16_t DCMI_VerticalLineCount; /*!< Specifies the number of lines to be captured from the starting point. + This parameter can be a value between 0x00 and 0x3FFF */ + + uint16_t DCMI_CaptureCount; /*!< Specifies the number of pixel clocks to be captured from the starting + point on the same line. + This parameter can be a value between 0x00 and 0x3FFF */ +} DCMI_CROPInitTypeDef; + +/** + * @brief DCMI Embedded Synchronisation CODE Init structure definition + */ +typedef struct +{ + uint8_t DCMI_FrameStartCode; /*!< Specifies the code of the frame start delimiter. */ + uint8_t DCMI_LineStartCode; /*!< Specifies the code of the line start delimiter. */ + uint8_t DCMI_LineEndCode; /*!< Specifies the code of the line end delimiter. */ + uint8_t DCMI_FrameEndCode; /*!< Specifies the code of the frame end delimiter. */ +} DCMI_CodesInitTypeDef; + +/* Exported constants --------------------------------------------------------*/ + +/** @defgroup DCMI_Exported_Constants + * @{ + */ + +/** @defgroup DCMI_Capture_Mode + * @{ + */ +#define DCMI_CaptureMode_Continuous ((uint16_t)0x0000) /*!< The received data are transferred continuously + into the destination memory through the DMA */ +#define DCMI_CaptureMode_SnapShot ((uint16_t)0x0002) /*!< Once activated, the interface waits for the start of + frame and then transfers a single frame through the DMA */ +#define IS_DCMI_CAPTURE_MODE(MODE)(((MODE) == DCMI_CaptureMode_Continuous) || \ + ((MODE) == DCMI_CaptureMode_SnapShot)) +/** + * @} + */ + + +/** @defgroup DCMI_Synchronization_Mode + * @{ + */ +#define DCMI_SynchroMode_Hardware ((uint16_t)0x0000) /*!< Hardware synchronization data capture (frame/line start/stop) + is synchronized with the HSYNC/VSYNC signals */ +#define DCMI_SynchroMode_Embedded ((uint16_t)0x0010) /*!< Embedded synchronization data capture is synchronized with + synchronization codes embedded in the data flow */ +#define IS_DCMI_SYNCHRO(MODE)(((MODE) == DCMI_SynchroMode_Hardware) || \ + ((MODE) == DCMI_SynchroMode_Embedded)) +/** + * @} + */ + + +/** @defgroup DCMI_PIXCK_Polarity + * @{ + */ +#define DCMI_PCKPolarity_Falling ((uint16_t)0x0000) /*!< Pixel clock active on Falling edge */ +#define DCMI_PCKPolarity_Rising ((uint16_t)0x0020) /*!< Pixel clock active on Rising edge */ +#define IS_DCMI_PCKPOLARITY(POLARITY)(((POLARITY) == DCMI_PCKPolarity_Falling) || \ + ((POLARITY) == DCMI_PCKPolarity_Rising)) +/** + * @} + */ + + +/** @defgroup DCMI_VSYNC_Polarity + * @{ + */ +#define DCMI_VSPolarity_Low ((uint16_t)0x0000) /*!< Vertical synchronization active Low */ +#define DCMI_VSPolarity_High ((uint16_t)0x0080) /*!< Vertical synchronization active High */ +#define IS_DCMI_VSPOLARITY(POLARITY)(((POLARITY) == DCMI_VSPolarity_Low) || \ + ((POLARITY) == DCMI_VSPolarity_High)) +/** + * @} + */ + + +/** @defgroup DCMI_HSYNC_Polarity + * @{ + */ +#define DCMI_HSPolarity_Low ((uint16_t)0x0000) /*!< Horizontal synchronization active Low */ +#define DCMI_HSPolarity_High ((uint16_t)0x0040) /*!< Horizontal synchronization active High */ +#define IS_DCMI_HSPOLARITY(POLARITY)(((POLARITY) == DCMI_HSPolarity_Low) || \ + ((POLARITY) == DCMI_HSPolarity_High)) +/** + * @} + */ + + +/** @defgroup DCMI_Capture_Rate + * @{ + */ +#define DCMI_CaptureRate_All_Frame ((uint16_t)0x0000) /*!< All frames are captured */ +#define DCMI_CaptureRate_1of2_Frame ((uint16_t)0x0100) /*!< Every alternate frame captured */ +#define DCMI_CaptureRate_1of4_Frame ((uint16_t)0x0200) /*!< One frame in 4 frames captured */ +#define IS_DCMI_CAPTURE_RATE(RATE) (((RATE) == DCMI_CaptureRate_All_Frame) || \ + ((RATE) == DCMI_CaptureRate_1of2_Frame) ||\ + ((RATE) == DCMI_CaptureRate_1of4_Frame)) +/** + * @} + */ + + +/** @defgroup DCMI_Extended_Data_Mode + * @{ + */ +#define DCMI_ExtendedDataMode_8b ((uint16_t)0x0000) /*!< Interface captures 8-bit data on every pixel clock */ +#define DCMI_ExtendedDataMode_10b ((uint16_t)0x0400) /*!< Interface captures 10-bit data on every pixel clock */ +#define DCMI_ExtendedDataMode_12b ((uint16_t)0x0800) /*!< Interface captures 12-bit data on every pixel clock */ +#define DCMI_ExtendedDataMode_14b ((uint16_t)0x0C00) /*!< Interface captures 14-bit data on every pixel clock */ +#define IS_DCMI_EXTENDED_DATA(DATA)(((DATA) == DCMI_ExtendedDataMode_8b) || \ + ((DATA) == DCMI_ExtendedDataMode_10b) ||\ + ((DATA) == DCMI_ExtendedDataMode_12b) ||\ + ((DATA) == DCMI_ExtendedDataMode_14b)) +/** + * @} + */ + + +/** @defgroup DCMI_interrupt_sources + * @{ + */ +#define DCMI_IT_FRAME ((uint16_t)0x0001) +#define DCMI_IT_OVF ((uint16_t)0x0002) +#define DCMI_IT_ERR ((uint16_t)0x0004) +#define DCMI_IT_VSYNC ((uint16_t)0x0008) +#define DCMI_IT_LINE ((uint16_t)0x0010) +#define IS_DCMI_CONFIG_IT(IT) ((((IT) & (uint16_t)0xFFE0) == 0x0000) && ((IT) != 0x0000)) +#define IS_DCMI_GET_IT(IT) (((IT) == DCMI_IT_FRAME) || \ + ((IT) == DCMI_IT_OVF) || \ + ((IT) == DCMI_IT_ERR) || \ + ((IT) == DCMI_IT_VSYNC) || \ + ((IT) == DCMI_IT_LINE)) +/** + * @} + */ + + +/** @defgroup DCMI_Flags + * @{ + */ +/** + * @brief DCMI SR register + */ +#define DCMI_FLAG_HSYNC ((uint16_t)0x2001) +#define DCMI_FLAG_VSYNC ((uint16_t)0x2002) +#define DCMI_FLAG_FNE ((uint16_t)0x2004) +/** + * @brief DCMI RISR register + */ +#define DCMI_FLAG_FRAMERI ((uint16_t)0x0001) +#define DCMI_FLAG_OVFRI ((uint16_t)0x0002) +#define DCMI_FLAG_ERRRI ((uint16_t)0x0004) +#define DCMI_FLAG_VSYNCRI ((uint16_t)0x0008) +#define DCMI_FLAG_LINERI ((uint16_t)0x0010) +/** + * @brief DCMI MISR register + */ +#define DCMI_FLAG_FRAMEMI ((uint16_t)0x1001) +#define DCMI_FLAG_OVFMI ((uint16_t)0x1002) +#define DCMI_FLAG_ERRMI ((uint16_t)0x1004) +#define DCMI_FLAG_VSYNCMI ((uint16_t)0x1008) +#define DCMI_FLAG_LINEMI ((uint16_t)0x1010) +#define IS_DCMI_GET_FLAG(FLAG) (((FLAG) == DCMI_FLAG_HSYNC) || \ + ((FLAG) == DCMI_FLAG_VSYNC) || \ + ((FLAG) == DCMI_FLAG_FNE) || \ + ((FLAG) == DCMI_FLAG_FRAMERI) || \ + ((FLAG) == DCMI_FLAG_OVFRI) || \ + ((FLAG) == DCMI_FLAG_ERRRI) || \ + ((FLAG) == DCMI_FLAG_VSYNCRI) || \ + ((FLAG) == DCMI_FLAG_LINERI) || \ + ((FLAG) == DCMI_FLAG_FRAMEMI) || \ + ((FLAG) == DCMI_FLAG_OVFMI) || \ + ((FLAG) == DCMI_FLAG_ERRMI) || \ + ((FLAG) == DCMI_FLAG_VSYNCMI) || \ + ((FLAG) == DCMI_FLAG_LINEMI)) + +#define IS_DCMI_CLEAR_FLAG(FLAG) ((((FLAG) & (uint16_t)0xFFE0) == 0x0000) && ((FLAG) != 0x0000)) +/** + * @} + */ + +/** + * @} + */ + +/* Exported macro ------------------------------------------------------------*/ +/* Exported functions --------------------------------------------------------*/ + +/* Function used to set the DCMI configuration to the default reset state ****/ +void DCMI_DeInit(void); + +/* Initialization and Configuration functions *********************************/ +void DCMI_Init(DCMI_InitTypeDef* DCMI_InitStruct); +void DCMI_StructInit(DCMI_InitTypeDef* DCMI_InitStruct); +void DCMI_CROPConfig(DCMI_CROPInitTypeDef* DCMI_CROPInitStruct); +void DCMI_CROPCmd(FunctionalState NewState); +void DCMI_SetEmbeddedSynchroCodes(DCMI_CodesInitTypeDef* DCMI_CodesInitStruct); +void DCMI_JPEGCmd(FunctionalState NewState); + +/* Image capture functions ****************************************************/ +void DCMI_Cmd(FunctionalState NewState); +void DCMI_CaptureCmd(FunctionalState NewState); +uint32_t DCMI_ReadData(void); + +/* Interrupts and flags management functions **********************************/ +void DCMI_ITConfig(uint16_t DCMI_IT, FunctionalState NewState); +FlagStatus DCMI_GetFlagStatus(uint16_t DCMI_FLAG); +void DCMI_ClearFlag(uint16_t DCMI_FLAG); +ITStatus DCMI_GetITStatus(uint16_t DCMI_IT); +void DCMI_ClearITPendingBit(uint16_t DCMI_IT); + +#ifdef __cplusplus +} +#endif + +#endif /*__STM32F4xx_DCMI_H */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/inc/stm32f4xx_dma.h b/FWLIB/inc/stm32f4xx_dma.h new file mode 100644 index 0000000..b7c68eb --- /dev/null +++ b/FWLIB/inc/stm32f4xx_dma.h @@ -0,0 +1,609 @@ +/** + ****************************************************************************** + * @file stm32f4xx_dma.h + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file contains all the functions prototypes for the DMA firmware + * library. + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Define to prevent recursive inclusion -------------------------------------*/ +#ifndef __STM32F4xx_DMA_H +#define __STM32F4xx_DMA_H + +#ifdef __cplusplus + extern "C" { +#endif + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @addtogroup DMA + * @{ + */ + +/* Exported types ------------------------------------------------------------*/ + +/** + * @brief DMA Init structure definition + */ + +typedef struct +{ + uint32_t DMA_Channel; /*!< Specifies the channel used for the specified stream. + This parameter can be a value of @ref DMA_channel */ + + uint32_t DMA_PeripheralBaseAddr; /*!< Specifies the peripheral base address for DMAy Streamx. */ + + uint32_t DMA_Memory0BaseAddr; /*!< Specifies the memory 0 base address for DMAy Streamx. + This memory is the default memory used when double buffer mode is + not enabled. */ + + uint32_t DMA_DIR; /*!< Specifies if the data will be transferred from memory to peripheral, + from memory to memory or from peripheral to memory. + This parameter can be a value of @ref DMA_data_transfer_direction */ + + uint32_t DMA_BufferSize; /*!< Specifies the buffer size, in data unit, of the specified Stream. + The data unit is equal to the configuration set in DMA_PeripheralDataSize + or DMA_MemoryDataSize members depending in the transfer direction. */ + + uint32_t DMA_PeripheralInc; /*!< Specifies whether the Peripheral address register should be incremented or not. + This parameter can be a value of @ref DMA_peripheral_incremented_mode */ + + uint32_t DMA_MemoryInc; /*!< Specifies whether the memory address register should be incremented or not. + This parameter can be a value of @ref DMA_memory_incremented_mode */ + + uint32_t DMA_PeripheralDataSize; /*!< Specifies the Peripheral data width. + This parameter can be a value of @ref DMA_peripheral_data_size */ + + uint32_t DMA_MemoryDataSize; /*!< Specifies the Memory data width. + This parameter can be a value of @ref DMA_memory_data_size */ + + uint32_t DMA_Mode; /*!< Specifies the operation mode of the DMAy Streamx. + This parameter can be a value of @ref DMA_circular_normal_mode + @note The circular buffer mode cannot be used if the memory-to-memory + data transfer is configured on the selected Stream */ + + uint32_t DMA_Priority; /*!< Specifies the software priority for the DMAy Streamx. + This parameter can be a value of @ref DMA_priority_level */ + + uint32_t DMA_FIFOMode; /*!< Specifies if the FIFO mode or Direct mode will be used for the specified Stream. + This parameter can be a value of @ref DMA_fifo_direct_mode + @note The Direct mode (FIFO mode disabled) cannot be used if the + memory-to-memory data transfer is configured on the selected Stream */ + + uint32_t DMA_FIFOThreshold; /*!< Specifies the FIFO threshold level. + This parameter can be a value of @ref DMA_fifo_threshold_level */ + + uint32_t DMA_MemoryBurst; /*!< Specifies the Burst transfer configuration for the memory transfers. + It specifies the amount of data to be transferred in a single non interruptable + transaction. This parameter can be a value of @ref DMA_memory_burst + @note The burst mode is possible only if the address Increment mode is enabled. */ + + uint32_t DMA_PeripheralBurst; /*!< Specifies the Burst transfer configuration for the peripheral transfers. + It specifies the amount of data to be transferred in a single non interruptable + transaction. This parameter can be a value of @ref DMA_peripheral_burst + @note The burst mode is possible only if the address Increment mode is enabled. */ +}DMA_InitTypeDef; + +/* Exported constants --------------------------------------------------------*/ + +/** @defgroup DMA_Exported_Constants + * @{ + */ + +#define IS_DMA_ALL_PERIPH(PERIPH) (((PERIPH) == DMA1_Stream0) || \ + ((PERIPH) == DMA1_Stream1) || \ + ((PERIPH) == DMA1_Stream2) || \ + ((PERIPH) == DMA1_Stream3) || \ + ((PERIPH) == DMA1_Stream4) || \ + ((PERIPH) == DMA1_Stream5) || \ + ((PERIPH) == DMA1_Stream6) || \ + ((PERIPH) == DMA1_Stream7) || \ + ((PERIPH) == DMA2_Stream0) || \ + ((PERIPH) == DMA2_Stream1) || \ + ((PERIPH) == DMA2_Stream2) || \ + ((PERIPH) == DMA2_Stream3) || \ + ((PERIPH) == DMA2_Stream4) || \ + ((PERIPH) == DMA2_Stream5) || \ + ((PERIPH) == DMA2_Stream6) || \ + ((PERIPH) == DMA2_Stream7)) + +#define IS_DMA_ALL_CONTROLLER(CONTROLLER) (((CONTROLLER) == DMA1) || \ + ((CONTROLLER) == DMA2)) + +/** @defgroup DMA_channel + * @{ + */ +#define DMA_Channel_0 ((uint32_t)0x00000000) +#define DMA_Channel_1 ((uint32_t)0x02000000) +#define DMA_Channel_2 ((uint32_t)0x04000000) +#define DMA_Channel_3 ((uint32_t)0x06000000) +#define DMA_Channel_4 ((uint32_t)0x08000000) +#define DMA_Channel_5 ((uint32_t)0x0A000000) +#define DMA_Channel_6 ((uint32_t)0x0C000000) +#define DMA_Channel_7 ((uint32_t)0x0E000000) + +#define IS_DMA_CHANNEL(CHANNEL) (((CHANNEL) == DMA_Channel_0) || \ + ((CHANNEL) == DMA_Channel_1) || \ + ((CHANNEL) == DMA_Channel_2) || \ + ((CHANNEL) == DMA_Channel_3) || \ + ((CHANNEL) == DMA_Channel_4) || \ + ((CHANNEL) == DMA_Channel_5) || \ + ((CHANNEL) == DMA_Channel_6) || \ + ((CHANNEL) == DMA_Channel_7)) +/** + * @} + */ + + +/** @defgroup DMA_data_transfer_direction + * @{ + */ +#define DMA_DIR_PeripheralToMemory ((uint32_t)0x00000000) +#define DMA_DIR_MemoryToPeripheral ((uint32_t)0x00000040) +#define DMA_DIR_MemoryToMemory ((uint32_t)0x00000080) + +#define IS_DMA_DIRECTION(DIRECTION) (((DIRECTION) == DMA_DIR_PeripheralToMemory ) || \ + ((DIRECTION) == DMA_DIR_MemoryToPeripheral) || \ + ((DIRECTION) == DMA_DIR_MemoryToMemory)) +/** + * @} + */ + + +/** @defgroup DMA_data_buffer_size + * @{ + */ +#define IS_DMA_BUFFER_SIZE(SIZE) (((SIZE) >= 0x1) && ((SIZE) < 0x10000)) +/** + * @} + */ + + +/** @defgroup DMA_peripheral_incremented_mode + * @{ + */ +#define DMA_PeripheralInc_Enable ((uint32_t)0x00000200) +#define DMA_PeripheralInc_Disable ((uint32_t)0x00000000) + +#define IS_DMA_PERIPHERAL_INC_STATE(STATE) (((STATE) == DMA_PeripheralInc_Enable) || \ + ((STATE) == DMA_PeripheralInc_Disable)) +/** + * @} + */ + + +/** @defgroup DMA_memory_incremented_mode + * @{ + */ +#define DMA_MemoryInc_Enable ((uint32_t)0x00000400) +#define DMA_MemoryInc_Disable ((uint32_t)0x00000000) + +#define IS_DMA_MEMORY_INC_STATE(STATE) (((STATE) == DMA_MemoryInc_Enable) || \ + ((STATE) == DMA_MemoryInc_Disable)) +/** + * @} + */ + + +/** @defgroup DMA_peripheral_data_size + * @{ + */ +#define DMA_PeripheralDataSize_Byte ((uint32_t)0x00000000) +#define DMA_PeripheralDataSize_HalfWord ((uint32_t)0x00000800) +#define DMA_PeripheralDataSize_Word ((uint32_t)0x00001000) + +#define IS_DMA_PERIPHERAL_DATA_SIZE(SIZE) (((SIZE) == DMA_PeripheralDataSize_Byte) || \ + ((SIZE) == DMA_PeripheralDataSize_HalfWord) || \ + ((SIZE) == DMA_PeripheralDataSize_Word)) +/** + * @} + */ + + +/** @defgroup DMA_memory_data_size + * @{ + */ +#define DMA_MemoryDataSize_Byte ((uint32_t)0x00000000) +#define DMA_MemoryDataSize_HalfWord ((uint32_t)0x00002000) +#define DMA_MemoryDataSize_Word ((uint32_t)0x00004000) + +#define IS_DMA_MEMORY_DATA_SIZE(SIZE) (((SIZE) == DMA_MemoryDataSize_Byte) || \ + ((SIZE) == DMA_MemoryDataSize_HalfWord) || \ + ((SIZE) == DMA_MemoryDataSize_Word )) +/** + * @} + */ + + +/** @defgroup DMA_circular_normal_mode + * @{ + */ +#define DMA_Mode_Normal ((uint32_t)0x00000000) +#define DMA_Mode_Circular ((uint32_t)0x00000100) + +#define IS_DMA_MODE(MODE) (((MODE) == DMA_Mode_Normal ) || \ + ((MODE) == DMA_Mode_Circular)) +/** + * @} + */ + + +/** @defgroup DMA_priority_level + * @{ + */ +#define DMA_Priority_Low ((uint32_t)0x00000000) +#define DMA_Priority_Medium ((uint32_t)0x00010000) +#define DMA_Priority_High ((uint32_t)0x00020000) +#define DMA_Priority_VeryHigh ((uint32_t)0x00030000) + +#define IS_DMA_PRIORITY(PRIORITY) (((PRIORITY) == DMA_Priority_Low ) || \ + ((PRIORITY) == DMA_Priority_Medium) || \ + ((PRIORITY) == DMA_Priority_High) || \ + ((PRIORITY) == DMA_Priority_VeryHigh)) +/** + * @} + */ + + +/** @defgroup DMA_fifo_direct_mode + * @{ + */ +#define DMA_FIFOMode_Disable ((uint32_t)0x00000000) +#define DMA_FIFOMode_Enable ((uint32_t)0x00000004) + +#define IS_DMA_FIFO_MODE_STATE(STATE) (((STATE) == DMA_FIFOMode_Disable ) || \ + ((STATE) == DMA_FIFOMode_Enable)) +/** + * @} + */ + + +/** @defgroup DMA_fifo_threshold_level + * @{ + */ +#define DMA_FIFOThreshold_1QuarterFull ((uint32_t)0x00000000) +#define DMA_FIFOThreshold_HalfFull ((uint32_t)0x00000001) +#define DMA_FIFOThreshold_3QuartersFull ((uint32_t)0x00000002) +#define DMA_FIFOThreshold_Full ((uint32_t)0x00000003) + +#define IS_DMA_FIFO_THRESHOLD(THRESHOLD) (((THRESHOLD) == DMA_FIFOThreshold_1QuarterFull ) || \ + ((THRESHOLD) == DMA_FIFOThreshold_HalfFull) || \ + ((THRESHOLD) == DMA_FIFOThreshold_3QuartersFull) || \ + ((THRESHOLD) == DMA_FIFOThreshold_Full)) +/** + * @} + */ + + +/** @defgroup DMA_memory_burst + * @{ + */ +#define DMA_MemoryBurst_Single ((uint32_t)0x00000000) +#define DMA_MemoryBurst_INC4 ((uint32_t)0x00800000) +#define DMA_MemoryBurst_INC8 ((uint32_t)0x01000000) +#define DMA_MemoryBurst_INC16 ((uint32_t)0x01800000) + +#define IS_DMA_MEMORY_BURST(BURST) (((BURST) == DMA_MemoryBurst_Single) || \ + ((BURST) == DMA_MemoryBurst_INC4) || \ + ((BURST) == DMA_MemoryBurst_INC8) || \ + ((BURST) == DMA_MemoryBurst_INC16)) +/** + * @} + */ + + +/** @defgroup DMA_peripheral_burst + * @{ + */ +#define DMA_PeripheralBurst_Single ((uint32_t)0x00000000) +#define DMA_PeripheralBurst_INC4 ((uint32_t)0x00200000) +#define DMA_PeripheralBurst_INC8 ((uint32_t)0x00400000) +#define DMA_PeripheralBurst_INC16 ((uint32_t)0x00600000) + +#define IS_DMA_PERIPHERAL_BURST(BURST) (((BURST) == DMA_PeripheralBurst_Single) || \ + ((BURST) == DMA_PeripheralBurst_INC4) || \ + ((BURST) == DMA_PeripheralBurst_INC8) || \ + ((BURST) == DMA_PeripheralBurst_INC16)) +/** + * @} + */ + + +/** @defgroup DMA_fifo_status_level + * @{ + */ +#define DMA_FIFOStatus_Less1QuarterFull ((uint32_t)0x00000000 << 3) +#define DMA_FIFOStatus_1QuarterFull ((uint32_t)0x00000001 << 3) +#define DMA_FIFOStatus_HalfFull ((uint32_t)0x00000002 << 3) +#define DMA_FIFOStatus_3QuartersFull ((uint32_t)0x00000003 << 3) +#define DMA_FIFOStatus_Empty ((uint32_t)0x00000004 << 3) +#define DMA_FIFOStatus_Full ((uint32_t)0x00000005 << 3) + +#define IS_DMA_FIFO_STATUS(STATUS) (((STATUS) == DMA_FIFOStatus_Less1QuarterFull ) || \ + ((STATUS) == DMA_FIFOStatus_HalfFull) || \ + ((STATUS) == DMA_FIFOStatus_1QuarterFull) || \ + ((STATUS) == DMA_FIFOStatus_3QuartersFull) || \ + ((STATUS) == DMA_FIFOStatus_Full) || \ + ((STATUS) == DMA_FIFOStatus_Empty)) +/** + * @} + */ + +/** @defgroup DMA_flags_definition + * @{ + */ +#define DMA_FLAG_FEIF0 ((uint32_t)0x10800001) +#define DMA_FLAG_DMEIF0 ((uint32_t)0x10800004) +#define DMA_FLAG_TEIF0 ((uint32_t)0x10000008) +#define DMA_FLAG_HTIF0 ((uint32_t)0x10000010) +#define DMA_FLAG_TCIF0 ((uint32_t)0x10000020) +#define DMA_FLAG_FEIF1 ((uint32_t)0x10000040) +#define DMA_FLAG_DMEIF1 ((uint32_t)0x10000100) +#define DMA_FLAG_TEIF1 ((uint32_t)0x10000200) +#define DMA_FLAG_HTIF1 ((uint32_t)0x10000400) +#define DMA_FLAG_TCIF1 ((uint32_t)0x10000800) +#define DMA_FLAG_FEIF2 ((uint32_t)0x10010000) +#define DMA_FLAG_DMEIF2 ((uint32_t)0x10040000) +#define DMA_FLAG_TEIF2 ((uint32_t)0x10080000) +#define DMA_FLAG_HTIF2 ((uint32_t)0x10100000) +#define DMA_FLAG_TCIF2 ((uint32_t)0x10200000) +#define DMA_FLAG_FEIF3 ((uint32_t)0x10400000) +#define DMA_FLAG_DMEIF3 ((uint32_t)0x11000000) +#define DMA_FLAG_TEIF3 ((uint32_t)0x12000000) +#define DMA_FLAG_HTIF3 ((uint32_t)0x14000000) +#define DMA_FLAG_TCIF3 ((uint32_t)0x18000000) +#define DMA_FLAG_FEIF4 ((uint32_t)0x20000001) +#define DMA_FLAG_DMEIF4 ((uint32_t)0x20000004) +#define DMA_FLAG_TEIF4 ((uint32_t)0x20000008) +#define DMA_FLAG_HTIF4 ((uint32_t)0x20000010) +#define DMA_FLAG_TCIF4 ((uint32_t)0x20000020) +#define DMA_FLAG_FEIF5 ((uint32_t)0x20000040) +#define DMA_FLAG_DMEIF5 ((uint32_t)0x20000100) +#define DMA_FLAG_TEIF5 ((uint32_t)0x20000200) +#define DMA_FLAG_HTIF5 ((uint32_t)0x20000400) +#define DMA_FLAG_TCIF5 ((uint32_t)0x20000800) +#define DMA_FLAG_FEIF6 ((uint32_t)0x20010000) +#define DMA_FLAG_DMEIF6 ((uint32_t)0x20040000) +#define DMA_FLAG_TEIF6 ((uint32_t)0x20080000) +#define DMA_FLAG_HTIF6 ((uint32_t)0x20100000) +#define DMA_FLAG_TCIF6 ((uint32_t)0x20200000) +#define DMA_FLAG_FEIF7 ((uint32_t)0x20400000) +#define DMA_FLAG_DMEIF7 ((uint32_t)0x21000000) +#define DMA_FLAG_TEIF7 ((uint32_t)0x22000000) +#define DMA_FLAG_HTIF7 ((uint32_t)0x24000000) +#define DMA_FLAG_TCIF7 ((uint32_t)0x28000000) + +#define IS_DMA_CLEAR_FLAG(FLAG) ((((FLAG) & 0x30000000) != 0x30000000) && (((FLAG) & 0x30000000) != 0) && \ + (((FLAG) & 0xC002F082) == 0x00) && ((FLAG) != 0x00)) + +#define IS_DMA_GET_FLAG(FLAG) (((FLAG) == DMA_FLAG_TCIF0) || ((FLAG) == DMA_FLAG_HTIF0) || \ + ((FLAG) == DMA_FLAG_TEIF0) || ((FLAG) == DMA_FLAG_DMEIF0) || \ + ((FLAG) == DMA_FLAG_FEIF0) || ((FLAG) == DMA_FLAG_TCIF1) || \ + ((FLAG) == DMA_FLAG_HTIF1) || ((FLAG) == DMA_FLAG_TEIF1) || \ + ((FLAG) == DMA_FLAG_DMEIF1) || ((FLAG) == DMA_FLAG_FEIF1) || \ + ((FLAG) == DMA_FLAG_TCIF2) || ((FLAG) == DMA_FLAG_HTIF2) || \ + ((FLAG) == DMA_FLAG_TEIF2) || ((FLAG) == DMA_FLAG_DMEIF2) || \ + ((FLAG) == DMA_FLAG_FEIF2) || ((FLAG) == DMA_FLAG_TCIF3) || \ + ((FLAG) == DMA_FLAG_HTIF3) || ((FLAG) == DMA_FLAG_TEIF3) || \ + ((FLAG) == DMA_FLAG_DMEIF3) || ((FLAG) == DMA_FLAG_FEIF3) || \ + ((FLAG) == DMA_FLAG_TCIF4) || ((FLAG) == DMA_FLAG_HTIF4) || \ + ((FLAG) == DMA_FLAG_TEIF4) || ((FLAG) == DMA_FLAG_DMEIF4) || \ + ((FLAG) == DMA_FLAG_FEIF4) || ((FLAG) == DMA_FLAG_TCIF5) || \ + ((FLAG) == DMA_FLAG_HTIF5) || ((FLAG) == DMA_FLAG_TEIF5) || \ + ((FLAG) == DMA_FLAG_DMEIF5) || ((FLAG) == DMA_FLAG_FEIF5) || \ + ((FLAG) == DMA_FLAG_TCIF6) || ((FLAG) == DMA_FLAG_HTIF6) || \ + ((FLAG) == DMA_FLAG_TEIF6) || ((FLAG) == DMA_FLAG_DMEIF6) || \ + ((FLAG) == DMA_FLAG_FEIF6) || ((FLAG) == DMA_FLAG_TCIF7) || \ + ((FLAG) == DMA_FLAG_HTIF7) || ((FLAG) == DMA_FLAG_TEIF7) || \ + ((FLAG) == DMA_FLAG_DMEIF7) || ((FLAG) == DMA_FLAG_FEIF7)) +/** + * @} + */ + + +/** @defgroup DMA_interrupt_enable_definitions + * @{ + */ +#define DMA_IT_TC ((uint32_t)0x00000010) +#define DMA_IT_HT ((uint32_t)0x00000008) +#define DMA_IT_TE ((uint32_t)0x00000004) +#define DMA_IT_DME ((uint32_t)0x00000002) +#define DMA_IT_FE ((uint32_t)0x00000080) + +#define IS_DMA_CONFIG_IT(IT) ((((IT) & 0xFFFFFF61) == 0x00) && ((IT) != 0x00)) +/** + * @} + */ + + +/** @defgroup DMA_interrupts_definitions + * @{ + */ +#define DMA_IT_FEIF0 ((uint32_t)0x90000001) +#define DMA_IT_DMEIF0 ((uint32_t)0x10001004) +#define DMA_IT_TEIF0 ((uint32_t)0x10002008) +#define DMA_IT_HTIF0 ((uint32_t)0x10004010) +#define DMA_IT_TCIF0 ((uint32_t)0x10008020) +#define DMA_IT_FEIF1 ((uint32_t)0x90000040) +#define DMA_IT_DMEIF1 ((uint32_t)0x10001100) +#define DMA_IT_TEIF1 ((uint32_t)0x10002200) +#define DMA_IT_HTIF1 ((uint32_t)0x10004400) +#define DMA_IT_TCIF1 ((uint32_t)0x10008800) +#define DMA_IT_FEIF2 ((uint32_t)0x90010000) +#define DMA_IT_DMEIF2 ((uint32_t)0x10041000) +#define DMA_IT_TEIF2 ((uint32_t)0x10082000) +#define DMA_IT_HTIF2 ((uint32_t)0x10104000) +#define DMA_IT_TCIF2 ((uint32_t)0x10208000) +#define DMA_IT_FEIF3 ((uint32_t)0x90400000) +#define DMA_IT_DMEIF3 ((uint32_t)0x11001000) +#define DMA_IT_TEIF3 ((uint32_t)0x12002000) +#define DMA_IT_HTIF3 ((uint32_t)0x14004000) +#define DMA_IT_TCIF3 ((uint32_t)0x18008000) +#define DMA_IT_FEIF4 ((uint32_t)0xA0000001) +#define DMA_IT_DMEIF4 ((uint32_t)0x20001004) +#define DMA_IT_TEIF4 ((uint32_t)0x20002008) +#define DMA_IT_HTIF4 ((uint32_t)0x20004010) +#define DMA_IT_TCIF4 ((uint32_t)0x20008020) +#define DMA_IT_FEIF5 ((uint32_t)0xA0000040) +#define DMA_IT_DMEIF5 ((uint32_t)0x20001100) +#define DMA_IT_TEIF5 ((uint32_t)0x20002200) +#define DMA_IT_HTIF5 ((uint32_t)0x20004400) +#define DMA_IT_TCIF5 ((uint32_t)0x20008800) +#define DMA_IT_FEIF6 ((uint32_t)0xA0010000) +#define DMA_IT_DMEIF6 ((uint32_t)0x20041000) +#define DMA_IT_TEIF6 ((uint32_t)0x20082000) +#define DMA_IT_HTIF6 ((uint32_t)0x20104000) +#define DMA_IT_TCIF6 ((uint32_t)0x20208000) +#define DMA_IT_FEIF7 ((uint32_t)0xA0400000) +#define DMA_IT_DMEIF7 ((uint32_t)0x21001000) +#define DMA_IT_TEIF7 ((uint32_t)0x22002000) +#define DMA_IT_HTIF7 ((uint32_t)0x24004000) +#define DMA_IT_TCIF7 ((uint32_t)0x28008000) + +#define IS_DMA_CLEAR_IT(IT) ((((IT) & 0x30000000) != 0x30000000) && \ + (((IT) & 0x30000000) != 0) && ((IT) != 0x00) && \ + (((IT) & 0x40820082) == 0x00)) + +#define IS_DMA_GET_IT(IT) (((IT) == DMA_IT_TCIF0) || ((IT) == DMA_IT_HTIF0) || \ + ((IT) == DMA_IT_TEIF0) || ((IT) == DMA_IT_DMEIF0) || \ + ((IT) == DMA_IT_FEIF0) || ((IT) == DMA_IT_TCIF1) || \ + ((IT) == DMA_IT_HTIF1) || ((IT) == DMA_IT_TEIF1) || \ + ((IT) == DMA_IT_DMEIF1)|| ((IT) == DMA_IT_FEIF1) || \ + ((IT) == DMA_IT_TCIF2) || ((IT) == DMA_IT_HTIF2) || \ + ((IT) == DMA_IT_TEIF2) || ((IT) == DMA_IT_DMEIF2) || \ + ((IT) == DMA_IT_FEIF2) || ((IT) == DMA_IT_TCIF3) || \ + ((IT) == DMA_IT_HTIF3) || ((IT) == DMA_IT_TEIF3) || \ + ((IT) == DMA_IT_DMEIF3)|| ((IT) == DMA_IT_FEIF3) || \ + ((IT) == DMA_IT_TCIF4) || ((IT) == DMA_IT_HTIF4) || \ + ((IT) == DMA_IT_TEIF4) || ((IT) == DMA_IT_DMEIF4) || \ + ((IT) == DMA_IT_FEIF4) || ((IT) == DMA_IT_TCIF5) || \ + ((IT) == DMA_IT_HTIF5) || ((IT) == DMA_IT_TEIF5) || \ + ((IT) == DMA_IT_DMEIF5)|| ((IT) == DMA_IT_FEIF5) || \ + ((IT) == DMA_IT_TCIF6) || ((IT) == DMA_IT_HTIF6) || \ + ((IT) == DMA_IT_TEIF6) || ((IT) == DMA_IT_DMEIF6) || \ + ((IT) == DMA_IT_FEIF6) || ((IT) == DMA_IT_TCIF7) || \ + ((IT) == DMA_IT_HTIF7) || ((IT) == DMA_IT_TEIF7) || \ + ((IT) == DMA_IT_DMEIF7)|| ((IT) == DMA_IT_FEIF7)) +/** + * @} + */ + + +/** @defgroup DMA_peripheral_increment_offset + * @{ + */ +#define DMA_PINCOS_Psize ((uint32_t)0x00000000) +#define DMA_PINCOS_WordAligned ((uint32_t)0x00008000) + +#define IS_DMA_PINCOS_SIZE(SIZE) (((SIZE) == DMA_PINCOS_Psize) || \ + ((SIZE) == DMA_PINCOS_WordAligned)) +/** + * @} + */ + + +/** @defgroup DMA_flow_controller_definitions + * @{ + */ +#define DMA_FlowCtrl_Memory ((uint32_t)0x00000000) +#define DMA_FlowCtrl_Peripheral ((uint32_t)0x00000020) + +#define IS_DMA_FLOW_CTRL(CTRL) (((CTRL) == DMA_FlowCtrl_Memory) || \ + ((CTRL) == DMA_FlowCtrl_Peripheral)) +/** + * @} + */ + + +/** @defgroup DMA_memory_targets_definitions + * @{ + */ +#define DMA_Memory_0 ((uint32_t)0x00000000) +#define DMA_Memory_1 ((uint32_t)0x00080000) + +#define IS_DMA_CURRENT_MEM(MEM) (((MEM) == DMA_Memory_0) || ((MEM) == DMA_Memory_1)) +/** + * @} + */ + +/** + * @} + */ + +/* Exported macro ------------------------------------------------------------*/ +/* Exported functions --------------------------------------------------------*/ + +/* Function used to set the DMA configuration to the default reset state *****/ +void DMA_DeInit(DMA_Stream_TypeDef* DMAy_Streamx); + +/* Initialization and Configuration functions *********************************/ +void DMA_Init(DMA_Stream_TypeDef* DMAy_Streamx, DMA_InitTypeDef* DMA_InitStruct); +void DMA_StructInit(DMA_InitTypeDef* DMA_InitStruct); +void DMA_Cmd(DMA_Stream_TypeDef* DMAy_Streamx, FunctionalState NewState); + +/* Optional Configuration functions *******************************************/ +void DMA_PeriphIncOffsetSizeConfig(DMA_Stream_TypeDef* DMAy_Streamx, uint32_t DMA_Pincos); +void DMA_FlowControllerConfig(DMA_Stream_TypeDef* DMAy_Streamx, uint32_t DMA_FlowCtrl); + +/* Data Counter functions *****************************************************/ +void DMA_SetCurrDataCounter(DMA_Stream_TypeDef* DMAy_Streamx, uint16_t Counter); +uint16_t DMA_GetCurrDataCounter(DMA_Stream_TypeDef* DMAy_Streamx); + +/* Double Buffer mode functions ***********************************************/ +void DMA_DoubleBufferModeConfig(DMA_Stream_TypeDef* DMAy_Streamx, uint32_t Memory1BaseAddr, + uint32_t DMA_CurrentMemory); +void DMA_DoubleBufferModeCmd(DMA_Stream_TypeDef* DMAy_Streamx, FunctionalState NewState); +void DMA_MemoryTargetConfig(DMA_Stream_TypeDef* DMAy_Streamx, uint32_t MemoryBaseAddr, + uint32_t DMA_MemoryTarget); +uint32_t DMA_GetCurrentMemoryTarget(DMA_Stream_TypeDef* DMAy_Streamx); + +/* Interrupts and flags management functions **********************************/ +FunctionalState DMA_GetCmdStatus(DMA_Stream_TypeDef* DMAy_Streamx); +uint32_t DMA_GetFIFOStatus(DMA_Stream_TypeDef* DMAy_Streamx); +FlagStatus DMA_GetFlagStatus(DMA_Stream_TypeDef* DMAy_Streamx, uint32_t DMA_FLAG); +void DMA_ClearFlag(DMA_Stream_TypeDef* DMAy_Streamx, uint32_t DMA_FLAG); +void DMA_ITConfig(DMA_Stream_TypeDef* DMAy_Streamx, uint32_t DMA_IT, FunctionalState NewState); +ITStatus DMA_GetITStatus(DMA_Stream_TypeDef* DMAy_Streamx, uint32_t DMA_IT); +void DMA_ClearITPendingBit(DMA_Stream_TypeDef* DMAy_Streamx, uint32_t DMA_IT); + +#ifdef __cplusplus +} +#endif + +#endif /*__STM32F4xx_DMA_H */ + +/** + * @} + */ + +/** + * @} + */ + + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/inc/stm32f4xx_dma2d.h b/FWLIB/inc/stm32f4xx_dma2d.h new file mode 100644 index 0000000..fd4d18b --- /dev/null +++ b/FWLIB/inc/stm32f4xx_dma2d.h @@ -0,0 +1,475 @@ +/** + ****************************************************************************** + * @file stm32f4xx_dma2d.h + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file contains all the functions prototypes for the DMA2D firmware + * library. + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Define to prevent recursive inclusion -------------------------------------*/ +#ifndef __STM32F4xx_DMA2D_H +#define __STM32F4xx_DMA2D_H + +#ifdef __cplusplus + extern "C" { +#endif + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @addtogroup DMA2D + * @{ + */ + +/* Exported types ------------------------------------------------------------*/ + +/** + * @brief DMA2D Init structure definition + */ + +typedef struct +{ + uint32_t DMA2D_Mode; /*!< configures the DMA2D transfer mode. + This parameter can be one value of @ref DMA2D_MODE */ + + uint32_t DMA2D_CMode; /*!< configures the color format of the output image. + This parameter can be one value of @ref DMA2D_CMODE */ + + uint32_t DMA2D_OutputBlue; /*!< configures the blue value of the output image. + This parameter must range: + - from 0x00 to 0xFF if ARGB8888 color mode is slected + - from 0x00 to 0xFF if RGB888 color mode is slected + - from 0x00 to 0x1F if RGB565 color mode is slected + - from 0x00 to 0x1F if ARGB1555 color mode is slected + - from 0x00 to 0x0F if ARGB4444 color mode is slected */ + + uint32_t DMA2D_OutputGreen; /*!< configures the green value of the output image. + This parameter must range: + - from 0x00 to 0xFF if ARGB8888 color mode is slected + - from 0x00 to 0xFF if RGB888 color mode is slected + - from 0x00 to 0x2F if RGB565 color mode is slected + - from 0x00 to 0x1F if ARGB1555 color mode is slected + - from 0x00 to 0x0F if ARGB4444 color mode is slected */ + + uint32_t DMA2D_OutputRed; /*!< configures the red value of the output image. + This parameter must range: + - from 0x00 to 0xFF if ARGB8888 color mode is slected + - from 0x00 to 0xFF if RGB888 color mode is slected + - from 0x00 to 0x1F if RGB565 color mode is slected + - from 0x00 to 0x1F if ARGB1555 color mode is slected + - from 0x00 to 0x0F if ARGB4444 color mode is slected */ + + uint32_t DMA2D_OutputAlpha; /*!< configures the alpha channel of the output color. + This parameter must range: + - from 0x00 to 0xFF if ARGB8888 color mode is slected + - from 0x00 to 0x01 if ARGB1555 color mode is slected + - from 0x00 to 0x0F if ARGB4444 color mode is slected */ + + uint32_t DMA2D_OutputMemoryAdd; /*!< Specifies the memory address. This parameter + must be range from 0x00000000 to 0xFFFFFFFF. */ + + uint32_t DMA2D_OutputOffset; /*!< Specifies the Offset value. This parameter must be range from + 0x0000 to 0x3FFF. */ + + uint32_t DMA2D_NumberOfLine; /*!< Configures the number of line of the area to be transfered. + This parameter must range from 0x0000 to 0xFFFF */ + + uint32_t DMA2D_PixelPerLine; /*!< Configures the number pixel per line of the area to be transfered. + This parameter must range from 0x0000 to 0x3FFF */ +} DMA2D_InitTypeDef; + + + +typedef struct +{ + uint32_t DMA2D_FGMA; /*!< configures the DMA2D foreground memory address. + This parameter must be range from 0x00000000 to 0xFFFFFFFF. */ + + uint32_t DMA2D_FGO; /*!< configures the DMA2D foreground offset. + This parameter must be range from 0x0000 to 0x3FFF. */ + + uint32_t DMA2D_FGCM; /*!< configures the DMA2D foreground color mode . + This parameter can be one value of @ref DMA2D_FGCM */ + + uint32_t DMA2D_FG_CLUT_CM; /*!< configures the DMA2D foreground CLUT color mode. + This parameter can be one value of @ref DMA2D_FG_CLUT_CM */ + + uint32_t DMA2D_FG_CLUT_SIZE; /*!< configures the DMA2D foreground CLUT size. + This parameter must range from 0x00 to 0xFF. */ + + uint32_t DMA2D_FGPFC_ALPHA_MODE; /*!< configures the DMA2D foreground alpha mode. + This parameter can be one value of @ref DMA2D_FGPFC_ALPHA_MODE */ + + uint32_t DMA2D_FGPFC_ALPHA_VALUE; /*!< Specifies the DMA2D foreground alpha value + must be range from 0x00 to 0xFF. */ + + uint32_t DMA2D_FGC_BLUE; /*!< Specifies the DMA2D foreground blue value + must be range from 0x00 to 0xFF. */ + + uint32_t DMA2D_FGC_GREEN; /*!< Specifies the DMA2D foreground green value + must be range from 0x00 to 0xFF. */ + + uint32_t DMA2D_FGC_RED; /*!< Specifies the DMA2D foreground red value + must be range from 0x00 to 0xFF. */ + + uint32_t DMA2D_FGCMAR; /*!< Configures the DMA2D foreground CLUT memory address. + This parameter must range from 0x00000000 to 0xFFFFFFFF. */ +} DMA2D_FG_InitTypeDef; + + +typedef struct +{ + uint32_t DMA2D_BGMA; /*!< configures the DMA2D background memory address. + This parameter must be range from 0x00000000 to 0xFFFFFFFF. */ + + uint32_t DMA2D_BGO; /*!< configures the DMA2D background offset. + This parameter must be range from 0x0000 to 0x3FFF. */ + + uint32_t DMA2D_BGCM; /*!< configures the DMA2D background color mode . + This parameter can be one value of @ref DMA2D_FGCM */ + + uint32_t DMA2D_BG_CLUT_CM; /*!< configures the DMA2D background CLUT color mode. + This parameter can be one value of @ref DMA2D_FG_CLUT_CM */ + + uint32_t DMA2D_BG_CLUT_SIZE; /*!< configures the DMA2D background CLUT size. + This parameter must range from 0x00 to 0xFF. */ + + uint32_t DMA2D_BGPFC_ALPHA_MODE; /*!< configures the DMA2D background alpha mode. + This parameter can be one value of @ref DMA2D_FGPFC_ALPHA_MODE */ + + uint32_t DMA2D_BGPFC_ALPHA_VALUE; /*!< Specifies the DMA2D background alpha value + must be range from 0x00 to 0xFF. */ + + uint32_t DMA2D_BGC_BLUE; /*!< Specifies the DMA2D background blue value + must be range from 0x00 to 0xFF. */ + + uint32_t DMA2D_BGC_GREEN; /*!< Specifies the DMA2D background green value + must be range from 0x00 to 0xFF. */ + + uint32_t DMA2D_BGC_RED; /*!< Specifies the DMA2D background red value + must be range from 0x00 to 0xFF. */ + + uint32_t DMA2D_BGCMAR; /*!< Configures the DMA2D background CLUT memory address. + This parameter must range from 0x00000000 to 0xFFFFFFFF. */ +} DMA2D_BG_InitTypeDef; + + + +/* Exported constants --------------------------------------------------------*/ + +/** @defgroup DMA2D_Exported_Constants + * @{ + */ + +/** @defgroup DMA2D_MODE + * @{ + */ + + +#define DMA2D_M2M ((uint32_t)0x00000000) +#define DMA2D_M2M_PFC ((uint32_t)0x00010000) +#define DMA2D_M2M_BLEND ((uint32_t)0x00020000) +#define DMA2D_R2M ((uint32_t)0x00030000) + +#define IS_DMA2D_MODE(MODE) (((MODE) == DMA2D_M2M) || ((MODE) == DMA2D_M2M_PFC) || \ + ((MODE) == DMA2D_M2M_BLEND) || ((MODE) == DMA2D_R2M)) + + +/** + * @} + */ + +/** @defgroup DMA2D_CMODE + * @{ + */ +#define DMA2D_ARGB8888 ((uint32_t)0x00000000) +#define DMA2D_RGB888 ((uint32_t)0x00000001) +#define DMA2D_RGB565 ((uint32_t)0x00000002) +#define DMA2D_ARGB1555 ((uint32_t)0x00000003) +#define DMA2D_ARGB4444 ((uint32_t)0x00000004) + +#define IS_DMA2D_CMODE(MODE_ARGB) (((MODE_ARGB) == DMA2D_ARGB8888) || ((MODE_ARGB) == DMA2D_RGB888) || \ + ((MODE_ARGB) == DMA2D_RGB565) || ((MODE_ARGB) == DMA2D_ARGB1555) || \ + ((MODE_ARGB) == DMA2D_ARGB4444)) + + +/** + * @} + */ + +/** @defgroup DMA2D_OUTPUT_COLOR + * @{ + */ +#define DMA2D_Output_Color ((uint32_t)0x000000FF) + +#define IS_DMA2D_OGREEN(OGREEN) ((OGREEN) <= DMA2D_Output_Color) +#define IS_DMA2D_ORED(ORED) ((ORED) <= DMA2D_Output_Color) +#define IS_DMA2D_OBLUE(OBLUE) ((OBLUE) <= DMA2D_Output_Color) +#define IS_DMA2D_OALPHA(OALPHA) ((OALPHA) <= DMA2D_Output_Color) + +/** + * @} + */ + +/** @defgroup DMA2D_OUTPUT_OFFSET + * @{ + */ +#define DMA2D_OUTPUT_OFFSET ((uint32_t)0x00003FFF) + +#define IS_DMA2D_OUTPUT_OFFSET(OOFFSET) ((OOFFSET) <= DMA2D_OUTPUT_OFFSET) + + +/** + * @} + */ + +/** @defgroup DMA2D_SIZE + * @{ + */ + +#define DMA2D_pixel ((uint32_t)0x00003FFF) +#define DMA2D_Line ((uint32_t)0x0000FFFF) + +#define IS_DMA2D_LINE(LINE) ((LINE) <= DMA2D_Line) +#define IS_DMA2D_PIXEL(PIXEL) ((PIXEL) <= DMA2D_pixel) + + +/** + * @} + */ + +/** @defgroup DMA2D_OFFSET + * @{ + */ +#define OFFSET ((uint32_t)0x00003FFF) + +#define IS_DMA2D_FGO(FGO) ((FGO) <= OFFSET) + +#define IS_DMA2D_BGO(BGO) ((BGO) <= OFFSET) + +/** + * @} + */ + + +/** @defgroup DMA2D_FGCM + * @{ + */ + +#define CM_ARGB8888 ((uint32_t)0x00000000) +#define CM_RGB888 ((uint32_t)0x00000001) +#define CM_RGB565 ((uint32_t)0x00000002) +#define CM_ARGB1555 ((uint32_t)0x00000003) +#define CM_ARGB4444 ((uint32_t)0x00000004) +#define CM_L8 ((uint32_t)0x00000005) +#define CM_AL44 ((uint32_t)0x00000006) +#define CM_AL88 ((uint32_t)0x00000007) +#define CM_L4 ((uint32_t)0x00000008) +#define CM_A8 ((uint32_t)0x00000009) +#define CM_A4 ((uint32_t)0x0000000A) + +#define IS_DMA2D_FGCM(FGCM) (((FGCM) == CM_ARGB8888) || ((FGCM) == CM_RGB888) || \ + ((FGCM) == CM_RGB565) || ((FGCM) == CM_ARGB1555) || \ + ((FGCM) == CM_ARGB4444) || ((FGCM) == CM_L8) || \ + ((FGCM) == CM_AL44) || ((FGCM) == CM_AL88) || \ + ((FGCM) == CM_L4) || ((FGCM) == CM_A8) || \ + ((FGCM) == CM_A4)) + +#define IS_DMA2D_BGCM(BGCM) (((BGCM) == CM_ARGB8888) || ((BGCM) == CM_RGB888) || \ + ((BGCM) == CM_RGB565) || ((BGCM) == CM_ARGB1555) || \ + ((BGCM) == CM_ARGB4444) || ((BGCM) == CM_L8) || \ + ((BGCM) == CM_AL44) || ((BGCM) == CM_AL88) || \ + ((BGCM) == CM_L4) || ((BGCM) == CM_A8) || \ + ((BGCM) == CM_A4)) + +/** + * @} + */ + +/** @defgroup DMA2D_FG_CLUT_CM + * @{ + */ + +#define CLUT_CM_ARGB8888 ((uint32_t)0x00000000) +#define CLUT_CM_RGB888 ((uint32_t)0x00000001) + +#define IS_DMA2D_FG_CLUT_CM(FG_CLUT_CM) (((FG_CLUT_CM) == CLUT_CM_ARGB8888) || ((FG_CLUT_CM) == CLUT_CM_RGB888)) + +#define IS_DMA2D_BG_CLUT_CM(BG_CLUT_CM) (((BG_CLUT_CM) == CLUT_CM_ARGB8888) || ((BG_CLUT_CM) == CLUT_CM_RGB888)) + +/** + * @} + */ + +/** @defgroup DMA2D_FG_COLOR_VALUE + * @{ + */ + +#define COLOR_VALUE ((uint32_t)0x000000FF) + +#define IS_DMA2D_FG_CLUT_SIZE(FG_CLUT_SIZE) ((FG_CLUT_SIZE) <= COLOR_VALUE) + +#define IS_DMA2D_FG_ALPHA_VALUE(FG_ALPHA_VALUE) ((FG_ALPHA_VALUE) <= COLOR_VALUE) +#define IS_DMA2D_FGC_BLUE(FGC_BLUE) ((FGC_BLUE) <= COLOR_VALUE) +#define IS_DMA2D_FGC_GREEN(FGC_GREEN) ((FGC_GREEN) <= COLOR_VALUE) +#define IS_DMA2D_FGC_RED(FGC_RED) ((FGC_RED) <= COLOR_VALUE) + +#define IS_DMA2D_BG_CLUT_SIZE(BG_CLUT_SIZE) ((BG_CLUT_SIZE) <= COLOR_VALUE) + +#define IS_DMA2D_BG_ALPHA_VALUE(BG_ALPHA_VALUE) ((BG_ALPHA_VALUE) <= COLOR_VALUE) +#define IS_DMA2D_BGC_BLUE(BGC_BLUE) ((BGC_BLUE) <= COLOR_VALUE) +#define IS_DMA2D_BGC_GREEN(BGC_GREEN) ((BGC_GREEN) <= COLOR_VALUE) +#define IS_DMA2D_BGC_RED(BGC_RED) ((BGC_RED) <= COLOR_VALUE) + +/** + * @} + */ + +/** DMA2D_FGPFC_ALPHA_MODE + * @{ + */ + +#define NO_MODIF_ALPHA_VALUE ((uint32_t)0x00000000) +#define REPLACE_ALPHA_VALUE ((uint32_t)0x00000001) +#define COMBINE_ALPHA_VALUE ((uint32_t)0x00000002) + +#define IS_DMA2D_FG_ALPHA_MODE(FG_ALPHA_MODE) (((FG_ALPHA_MODE) == NO_MODIF_ALPHA_VALUE) || \ + ((FG_ALPHA_MODE) == REPLACE_ALPHA_VALUE) || \ + ((FG_ALPHA_MODE) == COMBINE_ALPHA_VALUE)) + +#define IS_DMA2D_BG_ALPHA_MODE(BG_ALPHA_MODE) (((BG_ALPHA_MODE) == NO_MODIF_ALPHA_VALUE) || \ + ((BG_ALPHA_MODE) == REPLACE_ALPHA_VALUE) || \ + ((BG_ALPHA_MODE) == COMBINE_ALPHA_VALUE)) + +/** + * @} + */ + +/** @defgroup DMA2D_Interrupts + * @{ + */ + +#define DMA2D_IT_CE DMA2D_CR_CEIE +#define DMA2D_IT_CTC DMA2D_CR_CTCIE +#define DMA2D_IT_CAE DMA2D_CR_CAEIE +#define DMA2D_IT_TW DMA2D_CR_TWIE +#define DMA2D_IT_TC DMA2D_CR_TCIE +#define DMA2D_IT_TE DMA2D_CR_TEIE + +#define IS_DMA2D_IT(IT) (((IT) == DMA2D_IT_CTC) || ((IT) == DMA2D_IT_CAE) || \ + ((IT) == DMA2D_IT_TW) || ((IT) == DMA2D_IT_TC) || \ + ((IT) == DMA2D_IT_TE) || ((IT) == DMA2D_IT_CE)) + +/** + * @} + */ + +/** @defgroup DMA2D_Flag + * @{ + */ + +#define DMA2D_FLAG_CE DMA2D_ISR_CEIF +#define DMA2D_FLAG_CTC DMA2D_ISR_CTCIF +#define DMA2D_FLAG_CAE DMA2D_ISR_CAEIF +#define DMA2D_FLAG_TW DMA2D_ISR_TWIF +#define DMA2D_FLAG_TC DMA2D_ISR_TCIF +#define DMA2D_FLAG_TE DMA2D_ISR_TEIF + + +#define IS_DMA2D_GET_FLAG(FLAG) (((FLAG) == DMA2D_FLAG_CTC) || ((FLAG) == DMA2D_FLAG_CAE) || \ + ((FLAG) == DMA2D_FLAG_TW) || ((FLAG) == DMA2D_FLAG_TC) || \ + ((FLAG) == DMA2D_FLAG_TE) || ((FLAG) == DMA2D_FLAG_CE)) + + +/** + * @} + */ + +/** @defgroup DMA2D_DeadTime + * @{ + */ + +#define DEADTIME ((uint32_t)0x000000FF) + +#define IS_DMA2D_DEAD_TIME(DEAD_TIME) ((DEAD_TIME) <= DEADTIME) + + +#define LINE_WATERMARK DMA2D_LWR_LW + +#define IS_DMA2D_LineWatermark(LineWatermark) ((LineWatermark) <= LINE_WATERMARK) + +/** + * @} + */ + +/** + * @} + */ + +/* Exported macro ------------------------------------------------------------*/ +/* Exported functions ------------------------------------------------------- */ + +/* Function used to set the DMA2D configuration to the default reset state *****/ +void DMA2D_DeInit(void); + +/* Initialization and Configuration functions *********************************/ +void DMA2D_Init(DMA2D_InitTypeDef* DMA2D_InitStruct); +void DMA2D_StructInit(DMA2D_InitTypeDef* DMA2D_InitStruct); +void DMA2D_StartTransfer(void); +void DMA2D_AbortTransfer(void); +void DMA2D_Suspend(FunctionalState NewState); +void DMA2D_FGConfig(DMA2D_FG_InitTypeDef* DMA2D_FG_InitStruct); +void DMA2D_FG_StructInit(DMA2D_FG_InitTypeDef* DMA2D_FG_InitStruct); +void DMA2D_BGConfig(DMA2D_BG_InitTypeDef* DMA2D_BG_InitStruct); +void DMA2D_BG_StructInit(DMA2D_BG_InitTypeDef* DMA2D_BG_InitStruct); +void DMA2D_FGStart(FunctionalState NewState); +void DMA2D_BGStart(FunctionalState NewState); +void DMA2D_DeadTimeConfig(uint32_t DMA2D_DeadTime, FunctionalState NewState); +void DMA2D_LineWatermarkConfig(uint32_t DMA2D_LWatermarkConfig); + +/* Interrupts and flags management functions **********************************/ +void DMA2D_ITConfig(uint32_t DMA2D_IT, FunctionalState NewState); +FlagStatus DMA2D_GetFlagStatus(uint32_t DMA2D_FLAG); +void DMA2D_ClearFlag(uint32_t DMA2D_FLAG); +ITStatus DMA2D_GetITStatus(uint32_t DMA2D_IT); +void DMA2D_ClearITPendingBit(uint32_t DMA2D_IT); + +#ifdef __cplusplus +} +#endif + +#endif /* __STM32F4xx_DMA2D_H */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/inc/stm32f4xx_exti.h b/FWLIB/inc/stm32f4xx_exti.h new file mode 100644 index 0000000..15eea48 --- /dev/null +++ b/FWLIB/inc/stm32f4xx_exti.h @@ -0,0 +1,183 @@ +/** + ****************************************************************************** + * @file stm32f4xx_exti.h + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file contains all the functions prototypes for the EXTI firmware + * library. + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Define to prevent recursive inclusion -------------------------------------*/ +#ifndef __STM32F4xx_EXTI_H +#define __STM32F4xx_EXTI_H + +#ifdef __cplusplus + extern "C" { +#endif + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @addtogroup EXTI + * @{ + */ + +/* Exported types ------------------------------------------------------------*/ + +/** + * @brief EXTI mode enumeration + */ + +typedef enum +{ + EXTI_Mode_Interrupt = 0x00, + EXTI_Mode_Event = 0x04 +}EXTIMode_TypeDef; + +#define IS_EXTI_MODE(MODE) (((MODE) == EXTI_Mode_Interrupt) || ((MODE) == EXTI_Mode_Event)) + +/** + * @brief EXTI Trigger enumeration + */ + +typedef enum +{ + EXTI_Trigger_Rising = 0x08, + EXTI_Trigger_Falling = 0x0C, + EXTI_Trigger_Rising_Falling = 0x10 +}EXTITrigger_TypeDef; + +#define IS_EXTI_TRIGGER(TRIGGER) (((TRIGGER) == EXTI_Trigger_Rising) || \ + ((TRIGGER) == EXTI_Trigger_Falling) || \ + ((TRIGGER) == EXTI_Trigger_Rising_Falling)) +/** + * @brief EXTI Init Structure definition + */ + +typedef struct +{ + uint32_t EXTI_Line; /*!< Specifies the EXTI lines to be enabled or disabled. + This parameter can be any combination value of @ref EXTI_Lines */ + + EXTIMode_TypeDef EXTI_Mode; /*!< Specifies the mode for the EXTI lines. + This parameter can be a value of @ref EXTIMode_TypeDef */ + + EXTITrigger_TypeDef EXTI_Trigger; /*!< Specifies the trigger signal active edge for the EXTI lines. + This parameter can be a value of @ref EXTITrigger_TypeDef */ + + FunctionalState EXTI_LineCmd; /*!< Specifies the new state of the selected EXTI lines. + This parameter can be set either to ENABLE or DISABLE */ +}EXTI_InitTypeDef; + +/* Exported constants --------------------------------------------------------*/ + +/** @defgroup EXTI_Exported_Constants + * @{ + */ + +/** @defgroup EXTI_Lines + * @{ + */ + +#define EXTI_Line0 ((uint32_t)0x00001) /*!< External interrupt line 0 */ +#define EXTI_Line1 ((uint32_t)0x00002) /*!< External interrupt line 1 */ +#define EXTI_Line2 ((uint32_t)0x00004) /*!< External interrupt line 2 */ +#define EXTI_Line3 ((uint32_t)0x00008) /*!< External interrupt line 3 */ +#define EXTI_Line4 ((uint32_t)0x00010) /*!< External interrupt line 4 */ +#define EXTI_Line5 ((uint32_t)0x00020) /*!< External interrupt line 5 */ +#define EXTI_Line6 ((uint32_t)0x00040) /*!< External interrupt line 6 */ +#define EXTI_Line7 ((uint32_t)0x00080) /*!< External interrupt line 7 */ +#define EXTI_Line8 ((uint32_t)0x00100) /*!< External interrupt line 8 */ +#define EXTI_Line9 ((uint32_t)0x00200) /*!< External interrupt line 9 */ +#define EXTI_Line10 ((uint32_t)0x00400) /*!< External interrupt line 10 */ +#define EXTI_Line11 ((uint32_t)0x00800) /*!< External interrupt line 11 */ +#define EXTI_Line12 ((uint32_t)0x01000) /*!< External interrupt line 12 */ +#define EXTI_Line13 ((uint32_t)0x02000) /*!< External interrupt line 13 */ +#define EXTI_Line14 ((uint32_t)0x04000) /*!< External interrupt line 14 */ +#define EXTI_Line15 ((uint32_t)0x08000) /*!< External interrupt line 15 */ +#define EXTI_Line16 ((uint32_t)0x10000) /*!< External interrupt line 16 Connected to the PVD Output */ +#define EXTI_Line17 ((uint32_t)0x20000) /*!< External interrupt line 17 Connected to the RTC Alarm event */ +#define EXTI_Line18 ((uint32_t)0x40000) /*!< External interrupt line 18 Connected to the USB OTG FS Wakeup from suspend event */ +#define EXTI_Line19 ((uint32_t)0x80000) /*!< External interrupt line 19 Connected to the Ethernet Wakeup event */ +#define EXTI_Line20 ((uint32_t)0x00100000) /*!< External interrupt line 20 Connected to the USB OTG HS (configured in FS) Wakeup event */ +#define EXTI_Line21 ((uint32_t)0x00200000) /*!< External interrupt line 21 Connected to the RTC Tamper and Time Stamp events */ +#define EXTI_Line22 ((uint32_t)0x00400000) /*!< External interrupt line 22 Connected to the RTC Wakeup event */ + +#define IS_EXTI_LINE(LINE) ((((LINE) & (uint32_t)0xFF800000) == 0x00) && ((LINE) != (uint16_t)0x00)) + +#define IS_GET_EXTI_LINE(LINE) (((LINE) == EXTI_Line0) || ((LINE) == EXTI_Line1) || \ + ((LINE) == EXTI_Line2) || ((LINE) == EXTI_Line3) || \ + ((LINE) == EXTI_Line4) || ((LINE) == EXTI_Line5) || \ + ((LINE) == EXTI_Line6) || ((LINE) == EXTI_Line7) || \ + ((LINE) == EXTI_Line8) || ((LINE) == EXTI_Line9) || \ + ((LINE) == EXTI_Line10) || ((LINE) == EXTI_Line11) || \ + ((LINE) == EXTI_Line12) || ((LINE) == EXTI_Line13) || \ + ((LINE) == EXTI_Line14) || ((LINE) == EXTI_Line15) || \ + ((LINE) == EXTI_Line16) || ((LINE) == EXTI_Line17) || \ + ((LINE) == EXTI_Line18) || ((LINE) == EXTI_Line19) || \ + ((LINE) == EXTI_Line20) || ((LINE) == EXTI_Line21) ||\ + ((LINE) == EXTI_Line22)) + +/** + * @} + */ + +/** + * @} + */ + +/* Exported macro ------------------------------------------------------------*/ +/* Exported functions --------------------------------------------------------*/ + +/* Function used to set the EXTI configuration to the default reset state *****/ +void EXTI_DeInit(void); + +/* Initialization and Configuration functions *********************************/ +void EXTI_Init(EXTI_InitTypeDef* EXTI_InitStruct); +void EXTI_StructInit(EXTI_InitTypeDef* EXTI_InitStruct); +void EXTI_GenerateSWInterrupt(uint32_t EXTI_Line); + +/* Interrupts and flags management functions **********************************/ +FlagStatus EXTI_GetFlagStatus(uint32_t EXTI_Line); +void EXTI_ClearFlag(uint32_t EXTI_Line); +ITStatus EXTI_GetITStatus(uint32_t EXTI_Line); +void EXTI_ClearITPendingBit(uint32_t EXTI_Line); + +#ifdef __cplusplus +} +#endif + +#endif /* __STM32F4xx_EXTI_H */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/inc/stm32f4xx_flash.h b/FWLIB/inc/stm32f4xx_flash.h new file mode 100644 index 0000000..1ddf7a0 --- /dev/null +++ b/FWLIB/inc/stm32f4xx_flash.h @@ -0,0 +1,488 @@ +/** + ****************************************************************************** + * @file stm32f4xx_flash.h + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file contains all the functions prototypes for the FLASH + * firmware library. + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Define to prevent recursive inclusion -------------------------------------*/ +#ifndef __STM32F4xx_FLASH_H +#define __STM32F4xx_FLASH_H + +#ifdef __cplusplus + extern "C" { +#endif + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @addtogroup FLASH + * @{ + */ + +/* Exported types ------------------------------------------------------------*/ +/** + * @brief FLASH Status + */ +typedef enum +{ + FLASH_BUSY = 1, + FLASH_ERROR_RD, + FLASH_ERROR_PGS, + FLASH_ERROR_PGP, + FLASH_ERROR_PGA, + FLASH_ERROR_WRP, + FLASH_ERROR_PROGRAM, + FLASH_ERROR_OPERATION, + FLASH_COMPLETE +}FLASH_Status; + +/* Exported constants --------------------------------------------------------*/ + +/** @defgroup FLASH_Exported_Constants + * @{ + */ + +/** @defgroup Flash_Latency + * @{ + */ +#define FLASH_Latency_0 ((uint8_t)0x0000) /*!< FLASH Zero Latency cycle */ +#define FLASH_Latency_1 ((uint8_t)0x0001) /*!< FLASH One Latency cycle */ +#define FLASH_Latency_2 ((uint8_t)0x0002) /*!< FLASH Two Latency cycles */ +#define FLASH_Latency_3 ((uint8_t)0x0003) /*!< FLASH Three Latency cycles */ +#define FLASH_Latency_4 ((uint8_t)0x0004) /*!< FLASH Four Latency cycles */ +#define FLASH_Latency_5 ((uint8_t)0x0005) /*!< FLASH Five Latency cycles */ +#define FLASH_Latency_6 ((uint8_t)0x0006) /*!< FLASH Six Latency cycles */ +#define FLASH_Latency_7 ((uint8_t)0x0007) /*!< FLASH Seven Latency cycles */ +#define FLASH_Latency_8 ((uint8_t)0x0008) /*!< FLASH Eight Latency cycles */ +#define FLASH_Latency_9 ((uint8_t)0x0009) /*!< FLASH Nine Latency cycles */ +#define FLASH_Latency_10 ((uint8_t)0x000A) /*!< FLASH Ten Latency cycles */ +#define FLASH_Latency_11 ((uint8_t)0x000B) /*!< FLASH Eleven Latency cycles */ +#define FLASH_Latency_12 ((uint8_t)0x000C) /*!< FLASH Twelve Latency cycles */ +#define FLASH_Latency_13 ((uint8_t)0x000D) /*!< FLASH Thirteen Latency cycles */ +#define FLASH_Latency_14 ((uint8_t)0x000E) /*!< FLASH Fourteen Latency cycles */ +#define FLASH_Latency_15 ((uint8_t)0x000F) /*!< FLASH Fifteen Latency cycles */ + + +#define IS_FLASH_LATENCY(LATENCY) (((LATENCY) == FLASH_Latency_0) || \ + ((LATENCY) == FLASH_Latency_1) || \ + ((LATENCY) == FLASH_Latency_2) || \ + ((LATENCY) == FLASH_Latency_3) || \ + ((LATENCY) == FLASH_Latency_4) || \ + ((LATENCY) == FLASH_Latency_5) || \ + ((LATENCY) == FLASH_Latency_6) || \ + ((LATENCY) == FLASH_Latency_7) || \ + ((LATENCY) == FLASH_Latency_8) || \ + ((LATENCY) == FLASH_Latency_9) || \ + ((LATENCY) == FLASH_Latency_10) || \ + ((LATENCY) == FLASH_Latency_11) || \ + ((LATENCY) == FLASH_Latency_12) || \ + ((LATENCY) == FLASH_Latency_13) || \ + ((LATENCY) == FLASH_Latency_14) || \ + ((LATENCY) == FLASH_Latency_15)) +/** + * @} + */ + +/** @defgroup FLASH_Voltage_Range + * @{ + */ +#define VoltageRange_1 ((uint8_t)0x00) /*!< Device operating range: 1.8V to 2.1V */ +#define VoltageRange_2 ((uint8_t)0x01) /*!= 0x08000000) && ((ADDRESS) <= 0x081FFFFF)) ||\ + (((ADDRESS) >= 0x1FFF7800) && ((ADDRESS) <= 0x1FFF7A0F))) +#endif /* STM32F427_437xx || STM32F429_439xx */ + +#if defined (STM32F40_41xxx) +#define IS_FLASH_ADDRESS(ADDRESS) ((((ADDRESS) >= 0x08000000) && ((ADDRESS) <= 0x080FFFFF)) ||\ + (((ADDRESS) >= 0x1FFF7800) && ((ADDRESS) <= 0x1FFF7A0F))) +#endif /* STM32F40_41xxx */ + +#if defined (STM32F401xx) +#define IS_FLASH_ADDRESS(ADDRESS) ((((ADDRESS) >= 0x08000000) && ((ADDRESS) <= 0x0803FFFF)) ||\ + (((ADDRESS) >= 0x1FFF7800) && ((ADDRESS) <= 0x1FFF7A0F))) +#endif /* STM32F401xx */ + +#if defined (STM32F411xE) +#define IS_FLASH_ADDRESS(ADDRESS) ((((ADDRESS) >= 0x08000000) && ((ADDRESS) <= 0x0807FFFF)) ||\ + (((ADDRESS) >= 0x1FFF7800) && ((ADDRESS) <= 0x1FFF7A0F))) +#endif /* STM32F411xE */ + +/** + * @} + */ + +/** @defgroup Option_Bytes_Write_Protection + * @{ + */ +#define OB_WRP_Sector_0 ((uint32_t)0x00000001) /*!< Write protection of Sector0 */ +#define OB_WRP_Sector_1 ((uint32_t)0x00000002) /*!< Write protection of Sector1 */ +#define OB_WRP_Sector_2 ((uint32_t)0x00000004) /*!< Write protection of Sector2 */ +#define OB_WRP_Sector_3 ((uint32_t)0x00000008) /*!< Write protection of Sector3 */ +#define OB_WRP_Sector_4 ((uint32_t)0x00000010) /*!< Write protection of Sector4 */ +#define OB_WRP_Sector_5 ((uint32_t)0x00000020) /*!< Write protection of Sector5 */ +#define OB_WRP_Sector_6 ((uint32_t)0x00000040) /*!< Write protection of Sector6 */ +#define OB_WRP_Sector_7 ((uint32_t)0x00000080) /*!< Write protection of Sector7 */ +#define OB_WRP_Sector_8 ((uint32_t)0x00000100) /*!< Write protection of Sector8 */ +#define OB_WRP_Sector_9 ((uint32_t)0x00000200) /*!< Write protection of Sector9 */ +#define OB_WRP_Sector_10 ((uint32_t)0x00000400) /*!< Write protection of Sector10 */ +#define OB_WRP_Sector_11 ((uint32_t)0x00000800) /*!< Write protection of Sector11 */ +#define OB_WRP_Sector_12 ((uint32_t)0x00000001) /*!< Write protection of Sector12 */ +#define OB_WRP_Sector_13 ((uint32_t)0x00000002) /*!< Write protection of Sector13 */ +#define OB_WRP_Sector_14 ((uint32_t)0x00000004) /*!< Write protection of Sector14 */ +#define OB_WRP_Sector_15 ((uint32_t)0x00000008) /*!< Write protection of Sector15 */ +#define OB_WRP_Sector_16 ((uint32_t)0x00000010) /*!< Write protection of Sector16 */ +#define OB_WRP_Sector_17 ((uint32_t)0x00000020) /*!< Write protection of Sector17 */ +#define OB_WRP_Sector_18 ((uint32_t)0x00000040) /*!< Write protection of Sector18 */ +#define OB_WRP_Sector_19 ((uint32_t)0x00000080) /*!< Write protection of Sector19 */ +#define OB_WRP_Sector_20 ((uint32_t)0x00000100) /*!< Write protection of Sector20 */ +#define OB_WRP_Sector_21 ((uint32_t)0x00000200) /*!< Write protection of Sector21 */ +#define OB_WRP_Sector_22 ((uint32_t)0x00000400) /*!< Write protection of Sector22 */ +#define OB_WRP_Sector_23 ((uint32_t)0x00000800) /*!< Write protection of Sector23 */ +#define OB_WRP_Sector_All ((uint32_t)0x00000FFF) /*!< Write protection of all Sectors */ + +#define IS_OB_WRP(SECTOR)((((SECTOR) & (uint32_t)0xFFFFF000) == 0x00000000) && ((SECTOR) != 0x00000000)) +/** + * @} + */ + +/** @defgroup Selection_Protection_Mode + * @{ + */ +#define OB_PcROP_Disable ((uint8_t)0x00) /*!< Disabled PcROP, nWPRi bits used for Write Protection on sector i */ +#define OB_PcROP_Enable ((uint8_t)0x80) /*!< Enable PcROP, nWPRi bits used for PCRoP Protection on sector i */ +#define IS_OB_PCROP_SELECT(PCROP) (((PCROP) == OB_PcROP_Disable) || ((PCROP) == OB_PcROP_Enable)) +/** + * @} + */ + +/** @defgroup Option_Bytes_PC_ReadWrite_Protection + * @{ + */ +#define OB_PCROP_Sector_0 ((uint32_t)0x00000001) /*!< PC Read/Write protection of Sector0 */ +#define OB_PCROP_Sector_1 ((uint32_t)0x00000002) /*!< PC Read/Write protection of Sector1 */ +#define OB_PCROP_Sector_2 ((uint32_t)0x00000004) /*!< PC Read/Write protection of Sector2 */ +#define OB_PCROP_Sector_3 ((uint32_t)0x00000008) /*!< PC Read/Write protection of Sector3 */ +#define OB_PCROP_Sector_4 ((uint32_t)0x00000010) /*!< PC Read/Write protection of Sector4 */ +#define OB_PCROP_Sector_5 ((uint32_t)0x00000020) /*!< PC Read/Write protection of Sector5 */ +#define OB_PCROP_Sector_6 ((uint32_t)0x00000040) /*!< PC Read/Write protection of Sector6 */ +#define OB_PCROP_Sector_7 ((uint32_t)0x00000080) /*!< PC Read/Write protection of Sector7 */ +#define OB_PCROP_Sector_8 ((uint32_t)0x00000100) /*!< PC Read/Write protection of Sector8 */ +#define OB_PCROP_Sector_9 ((uint32_t)0x00000200) /*!< PC Read/Write protection of Sector9 */ +#define OB_PCROP_Sector_10 ((uint32_t)0x00000400) /*!< PC Read/Write protection of Sector10 */ +#define OB_PCROP_Sector_11 ((uint32_t)0x00000800) /*!< PC Read/Write protection of Sector11 */ +#define OB_PCROP_Sector_12 ((uint32_t)0x00000001) /*!< PC Read/Write protection of Sector12 */ +#define OB_PCROP_Sector_13 ((uint32_t)0x00000002) /*!< PC Read/Write protection of Sector13 */ +#define OB_PCROP_Sector_14 ((uint32_t)0x00000004) /*!< PC Read/Write protection of Sector14 */ +#define OB_PCROP_Sector_15 ((uint32_t)0x00000008) /*!< PC Read/Write protection of Sector15 */ +#define OB_PCROP_Sector_16 ((uint32_t)0x00000010) /*!< PC Read/Write protection of Sector16 */ +#define OB_PCROP_Sector_17 ((uint32_t)0x00000020) /*!< PC Read/Write protection of Sector17 */ +#define OB_PCROP_Sector_18 ((uint32_t)0x00000040) /*!< PC Read/Write protection of Sector18 */ +#define OB_PCROP_Sector_19 ((uint32_t)0x00000080) /*!< PC Read/Write protection of Sector19 */ +#define OB_PCROP_Sector_20 ((uint32_t)0x00000100) /*!< PC Read/Write protection of Sector20 */ +#define OB_PCROP_Sector_21 ((uint32_t)0x00000200) /*!< PC Read/Write protection of Sector21 */ +#define OB_PCROP_Sector_22 ((uint32_t)0x00000400) /*!< PC Read/Write protection of Sector22 */ +#define OB_PCROP_Sector_23 ((uint32_t)0x00000800) /*!< PC Read/Write protection of Sector23 */ +#define OB_PCROP_Sector_All ((uint32_t)0x00000FFF) /*!< PC Read/Write protection of all Sectors */ + +#define IS_OB_PCROP(SECTOR)((((SECTOR) & (uint32_t)0xFFFFF000) == 0x00000000) && ((SECTOR) != 0x00000000)) +/** + * @} + */ + +/** @defgroup FLASH_Option_Bytes_Read_Protection + * @{ + */ +#define OB_RDP_Level_0 ((uint8_t)0xAA) +#define OB_RDP_Level_1 ((uint8_t)0x55) +/*#define OB_RDP_Level_2 ((uint8_t)0xCC)*/ /*!< Warning: When enabling read protection level 2 + it's no more possible to go back to level 1 or 0 */ +#define IS_OB_RDP(LEVEL) (((LEVEL) == OB_RDP_Level_0)||\ + ((LEVEL) == OB_RDP_Level_1))/*||\ + ((LEVEL) == OB_RDP_Level_2))*/ +/** + * @} + */ + +/** @defgroup FLASH_Option_Bytes_IWatchdog + * @{ + */ +#define OB_IWDG_SW ((uint8_t)0x20) /*!< Software IWDG selected */ +#define OB_IWDG_HW ((uint8_t)0x00) /*!< Hardware IWDG selected */ +#define IS_OB_IWDG_SOURCE(SOURCE) (((SOURCE) == OB_IWDG_SW) || ((SOURCE) == OB_IWDG_HW)) +/** + * @} + */ + +/** @defgroup FLASH_Option_Bytes_nRST_STOP + * @{ + */ +#define OB_STOP_NoRST ((uint8_t)0x40) /*!< No reset generated when entering in STOP */ +#define OB_STOP_RST ((uint8_t)0x00) /*!< Reset generated when entering in STOP */ +#define IS_OB_STOP_SOURCE(SOURCE) (((SOURCE) == OB_STOP_NoRST) || ((SOURCE) == OB_STOP_RST)) +/** + * @} + */ + + +/** @defgroup FLASH_Option_Bytes_nRST_STDBY + * @{ + */ +#define OB_STDBY_NoRST ((uint8_t)0x80) /*!< No reset generated when entering in STANDBY */ +#define OB_STDBY_RST ((uint8_t)0x00) /*!< Reset generated when entering in STANDBY */ +#define IS_OB_STDBY_SOURCE(SOURCE) (((SOURCE) == OB_STDBY_NoRST) || ((SOURCE) == OB_STDBY_RST)) +/** + * @} + */ + +/** @defgroup FLASH_BOR_Reset_Level + * @{ + */ +#define OB_BOR_LEVEL3 ((uint8_t)0x00) /*!< Supply voltage ranges from 2.70 to 3.60 V */ +#define OB_BOR_LEVEL2 ((uint8_t)0x04) /*!< Supply voltage ranges from 2.40 to 2.70 V */ +#define OB_BOR_LEVEL1 ((uint8_t)0x08) /*!< Supply voltage ranges from 2.10 to 2.40 V */ +#define OB_BOR_OFF ((uint8_t)0x0C) /*!< Supply voltage ranges from 1.62 to 2.10 V */ +#define IS_OB_BOR(LEVEL) (((LEVEL) == OB_BOR_LEVEL1) || ((LEVEL) == OB_BOR_LEVEL2) ||\ + ((LEVEL) == OB_BOR_LEVEL3) || ((LEVEL) == OB_BOR_OFF)) +/** + * @} + */ + +/** @defgroup FLASH_Dual_Boot + * @{ + */ +#define OB_Dual_BootEnabled ((uint8_t)0x10) /*!< Dual Bank Boot Enable */ +#define OB_Dual_BootDisabled ((uint8_t)0x00) /*!< Dual Bank Boot Disable, always boot on User Flash */ +#define IS_OB_BOOT(BOOT) (((BOOT) == OB_Dual_BootEnabled) || ((BOOT) == OB_Dual_BootDisabled)) +/** + * @} + */ + +/** @defgroup FLASH_Interrupts + * @{ + */ +#define FLASH_IT_EOP ((uint32_t)0x01000000) /*!< End of FLASH Operation Interrupt source */ +#define FLASH_IT_ERR ((uint32_t)0x02000000) /*!< Error Interrupt source */ +#define IS_FLASH_IT(IT) ((((IT) & (uint32_t)0xFCFFFFFF) == 0x00000000) && ((IT) != 0x00000000)) +/** + * @} + */ + +/** @defgroup FLASH_Flags + * @{ + */ +#define FLASH_FLAG_EOP ((uint32_t)0x00000001) /*!< FLASH End of Operation flag */ +#define FLASH_FLAG_OPERR ((uint32_t)0x00000002) /*!< FLASH operation Error flag */ +#define FLASH_FLAG_WRPERR ((uint32_t)0x00000010) /*!< FLASH Write protected error flag */ +#define FLASH_FLAG_PGAERR ((uint32_t)0x00000020) /*!< FLASH Programming Alignment error flag */ +#define FLASH_FLAG_PGPERR ((uint32_t)0x00000040) /*!< FLASH Programming Parallelism error flag */ +#define FLASH_FLAG_PGSERR ((uint32_t)0x00000080) /*!< FLASH Programming Sequence error flag */ +#define FLASH_FLAG_RDERR ((uint32_t)0x00000100) /*!< Read Protection error flag (PCROP) */ +#define FLASH_FLAG_BSY ((uint32_t)0x00010000) /*!< FLASH Busy flag */ +#define IS_FLASH_CLEAR_FLAG(FLAG) ((((FLAG) & (uint32_t)0xFFFFFE0C) == 0x00000000) && ((FLAG) != 0x00000000)) +#define IS_FLASH_GET_FLAG(FLAG) (((FLAG) == FLASH_FLAG_EOP) || ((FLAG) == FLASH_FLAG_OPERR) || \ + ((FLAG) == FLASH_FLAG_WRPERR) || ((FLAG) == FLASH_FLAG_PGAERR) || \ + ((FLAG) == FLASH_FLAG_PGPERR) || ((FLAG) == FLASH_FLAG_PGSERR) || \ + ((FLAG) == FLASH_FLAG_BSY) || ((FLAG) == FLASH_FLAG_RDERR)) +/** + * @} + */ + +/** @defgroup FLASH_Program_Parallelism + * @{ + */ +#define FLASH_PSIZE_BYTE ((uint32_t)0x00000000) +#define FLASH_PSIZE_HALF_WORD ((uint32_t)0x00000100) +#define FLASH_PSIZE_WORD ((uint32_t)0x00000200) +#define FLASH_PSIZE_DOUBLE_WORD ((uint32_t)0x00000300) +#define CR_PSIZE_MASK ((uint32_t)0xFFFFFCFF) +/** + * @} + */ + +/** @defgroup FLASH_Keys + * @{ + */ +#define RDP_KEY ((uint16_t)0x00A5) +#define FLASH_KEY1 ((uint32_t)0x45670123) +#define FLASH_KEY2 ((uint32_t)0xCDEF89AB) +#define FLASH_OPT_KEY1 ((uint32_t)0x08192A3B) +#define FLASH_OPT_KEY2 ((uint32_t)0x4C5D6E7F) +/** + * @} + */ + +/** + * @brief ACR register byte 0 (Bits[7:0]) base address + */ +#define ACR_BYTE0_ADDRESS ((uint32_t)0x40023C00) +/** + * @brief OPTCR register byte 0 (Bits[7:0]) base address + */ +#define OPTCR_BYTE0_ADDRESS ((uint32_t)0x40023C14) +/** + * @brief OPTCR register byte 1 (Bits[15:8]) base address + */ +#define OPTCR_BYTE1_ADDRESS ((uint32_t)0x40023C15) +/** + * @brief OPTCR register byte 2 (Bits[23:16]) base address + */ +#define OPTCR_BYTE2_ADDRESS ((uint32_t)0x40023C16) +/** + * @brief OPTCR register byte 3 (Bits[31:24]) base address + */ +#define OPTCR_BYTE3_ADDRESS ((uint32_t)0x40023C17) + +/** + * @brief OPTCR1 register byte 0 (Bits[7:0]) base address + */ +#define OPTCR1_BYTE2_ADDRESS ((uint32_t)0x40023C1A) + +/** + * @} + */ + +/* Exported macro ------------------------------------------------------------*/ +/* Exported functions --------------------------------------------------------*/ + +/* FLASH Interface configuration functions ************************************/ +void FLASH_SetLatency(uint32_t FLASH_Latency); +void FLASH_PrefetchBufferCmd(FunctionalState NewState); +void FLASH_InstructionCacheCmd(FunctionalState NewState); +void FLASH_DataCacheCmd(FunctionalState NewState); +void FLASH_InstructionCacheReset(void); +void FLASH_DataCacheReset(void); + +/* FLASH Memory Programming functions *****************************************/ +void FLASH_Unlock(void); +void FLASH_Lock(void); +FLASH_Status FLASH_EraseSector(uint32_t FLASH_Sector, uint8_t VoltageRange); +FLASH_Status FLASH_EraseAllSectors(uint8_t VoltageRange); +FLASH_Status FLASH_EraseAllBank1Sectors(uint8_t VoltageRange); +FLASH_Status FLASH_EraseAllBank2Sectors(uint8_t VoltageRange); +FLASH_Status FLASH_ProgramDoubleWord(uint32_t Address, uint64_t Data); +FLASH_Status FLASH_ProgramWord(uint32_t Address, uint32_t Data); +FLASH_Status FLASH_ProgramHalfWord(uint32_t Address, uint16_t Data); +FLASH_Status FLASH_ProgramByte(uint32_t Address, uint8_t Data); + +/* Option Bytes Programming functions *****************************************/ +void FLASH_OB_Unlock(void); +void FLASH_OB_Lock(void); +void FLASH_OB_WRPConfig(uint32_t OB_WRP, FunctionalState NewState); +void FLASH_OB_WRP1Config(uint32_t OB_WRP, FunctionalState NewState); +void FLASH_OB_PCROPSelectionConfig(uint8_t OB_PcROP); +void FLASH_OB_PCROPConfig(uint32_t OB_PCROP, FunctionalState NewState); +void FLASH_OB_PCROP1Config(uint32_t OB_PCROP, FunctionalState NewState); +void FLASH_OB_RDPConfig(uint8_t OB_RDP); +void FLASH_OB_UserConfig(uint8_t OB_IWDG, uint8_t OB_STOP, uint8_t OB_STDBY); +void FLASH_OB_BORConfig(uint8_t OB_BOR); +void FLASH_OB_BootConfig(uint8_t OB_BOOT); +FLASH_Status FLASH_OB_Launch(void); +uint8_t FLASH_OB_GetUser(void); +uint16_t FLASH_OB_GetWRP(void); +uint16_t FLASH_OB_GetWRP1(void); +uint16_t FLASH_OB_GetPCROP(void); +uint16_t FLASH_OB_GetPCROP1(void); +FlagStatus FLASH_OB_GetRDP(void); +uint8_t FLASH_OB_GetBOR(void); + +/* Interrupts and flags management functions **********************************/ +void FLASH_ITConfig(uint32_t FLASH_IT, FunctionalState NewState); +FlagStatus FLASH_GetFlagStatus(uint32_t FLASH_FLAG); +void FLASH_ClearFlag(uint32_t FLASH_FLAG); +FLASH_Status FLASH_GetStatus(void); +FLASH_Status FLASH_WaitForLastOperation(void); + +#ifdef __cplusplus +} +#endif + +#endif /* __STM32F4xx_FLASH_H */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/inc/stm32f4xx_flash_ramfunc.h b/FWLIB/inc/stm32f4xx_flash_ramfunc.h new file mode 100644 index 0000000..8ac175a --- /dev/null +++ b/FWLIB/inc/stm32f4xx_flash_ramfunc.h @@ -0,0 +1,103 @@ +/** + ****************************************************************************** + * @file stm32f4xx_flash_ramfunc.h + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief Header file of FLASH RAMFUNC driver. + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + + +/* Define to prevent recursive inclusion -------------------------------------*/ +#ifndef __STM32F4xx_FLASH_RAMFUNC_H +#define __STM32F4xx_FLASH_RAMFUNC_H + +#ifdef __cplusplus + extern "C" { +#endif + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @addtogroup FLASH RAMFUNC + * @{ + */ + +/* Exported types ------------------------------------------------------------*/ +/* Private define ------------------------------------------------------------*/ +/** + * @brief __RAM_FUNC definition + */ +#if defined ( __CC_ARM ) +/* ARM Compiler + ------------ + RAM functions are defined using the toolchain options. + Functions that are executed in RAM should reside in a separate source module. + Using the 'Options for File' dialog you can simply change the 'Code / Const' + area of a module to a memory space in physical RAM. + Available memory areas are declared in the 'Target' tab of the 'Options for Target' + dialog. +*/ +#define __RAM_FUNC void + +#elif defined ( __ICCARM__ ) +/* ICCARM Compiler + --------------- + RAM functions are defined using a specific toolchain keyword "__ramfunc". +*/ +#define __RAM_FUNC __ramfunc void + +#elif defined ( __GNUC__ ) +/* GNU Compiler + ------------ + RAM functions are defined using a specific toolchain attribute + "__attribute__((section(".RamFunc")))". +*/ +#define __RAM_FUNC void __attribute__((section(".RamFunc"))) + +#endif +/* Exported constants --------------------------------------------------------*/ +/* Exported macro ------------------------------------------------------------*/ +/* Exported functions --------------------------------------------------------*/ +__RAM_FUNC FLASH_FlashInterfaceCmd(FunctionalState NewState); +__RAM_FUNC FLASH_FlashSleepModeCmd(FunctionalState NewState); + + +#ifdef __cplusplus +} +#endif + +#endif /* __STM32F4xx_FLASH_RAMFUNC_H */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ + diff --git a/FWLIB/inc/stm32f4xx_fmc.h b/FWLIB/inc/stm32f4xx_fmc.h new file mode 100644 index 0000000..6e8fbc9 --- /dev/null +++ b/FWLIB/inc/stm32f4xx_fmc.h @@ -0,0 +1,1143 @@ +/** + ****************************************************************************** + * @file stm32f4xx_fmc.h + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file contains all the functions prototypes for the FMC firmware + * library. + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Define to prevent recursive inclusion -------------------------------------*/ +#ifndef __STM32F4xx_FMC_H +#define __STM32F4xx_FMC_H + +#ifdef __cplusplus + extern "C" { +#endif + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @addtogroup FMC + * @{ + */ + +/* Exported types ------------------------------------------------------------*/ + +/** + * @brief Timing parameters For NOR/SRAM Banks + */ +typedef struct +{ + uint32_t FMC_AddressSetupTime; /*!< Defines the number of HCLK cycles to configure + the duration of the address setup time. + This parameter can be a value between 0 and 15. + @note This parameter is not used with synchronous NOR Flash memories. */ + + uint32_t FMC_AddressHoldTime; /*!< Defines the number of HCLK cycles to configure + the duration of the address hold time. + This parameter can be a value between 1 and 15. + @note This parameter is not used with synchronous NOR Flash memories.*/ + + uint32_t FMC_DataSetupTime; /*!< Defines the number of HCLK cycles to configure + the duration of the data setup time. + This parameter can be a value between 1 and 255. + @note This parameter is used for SRAMs, ROMs and asynchronous multiplexed NOR Flash memories. */ + + uint32_t FMC_BusTurnAroundDuration; /*!< Defines the number of HCLK cycles to configure + the duration of the bus turnaround. + This parameter can be a value between 0 and 15. + @note This parameter is only used for multiplexed NOR Flash memories. */ + + uint32_t FMC_CLKDivision; /*!< Defines the period of CLK clock output signal, expressed in number of HCLK cycles. + This parameter can be a value between 1 and 15. + @note This parameter is not used for asynchronous NOR Flash, SRAM or ROM accesses. */ + + uint32_t FMC_DataLatency; /*!< Defines the number of memory clock cycles to issue + to the memory before getting the first data. + The parameter value depends on the memory type as shown below: + - It must be set to 0 in case of a CRAM + - It is don't care in asynchronous NOR, SRAM or ROM accesses + - It may assume a value between 0 and 15 in NOR Flash memories + with synchronous burst mode enable */ + + uint32_t FMC_AccessMode; /*!< Specifies the asynchronous access mode. + This parameter can be a value of @ref FMC_Access_Mode */ +}FMC_NORSRAMTimingInitTypeDef; + +/** + * @brief FMC NOR/SRAM Init structure definition + */ +typedef struct +{ + uint32_t FMC_Bank; /*!< Specifies the NOR/SRAM memory bank that will be used. + This parameter can be a value of @ref FMC_NORSRAM_Bank */ + + uint32_t FMC_DataAddressMux; /*!< Specifies whether the address and data values are + multiplexed on the databus or not. + This parameter can be a value of @ref FMC_Data_Address_Bus_Multiplexing */ + + uint32_t FMC_MemoryType; /*!< Specifies the type of external memory attached to + the corresponding memory bank. + This parameter can be a value of @ref FMC_Memory_Type */ + + uint32_t FMC_MemoryDataWidth; /*!< Specifies the external memory device width. + This parameter can be a value of @ref FMC_NORSRAM_Data_Width */ + + uint32_t FMC_BurstAccessMode; /*!< Enables or disables the burst access mode for Flash memory, + valid only with synchronous burst Flash memories. + This parameter can be a value of @ref FMC_Burst_Access_Mode */ + + uint32_t FMC_WaitSignalPolarity; /*!< Specifies the wait signal polarity, valid only when accessing + the Flash memory in burst mode. + This parameter can be a value of @ref FMC_Wait_Signal_Polarity */ + + uint32_t FMC_WrapMode; /*!< Enables or disables the Wrapped burst access mode for Flash + memory, valid only when accessing Flash memories in burst mode. + This parameter can be a value of @ref FMC_Wrap_Mode */ + + uint32_t FMC_WaitSignalActive; /*!< Specifies if the wait signal is asserted by the memory one + clock cycle before the wait state or during the wait state, + valid only when accessing memories in burst mode. + This parameter can be a value of @ref FMC_Wait_Timing */ + + uint32_t FMC_WriteOperation; /*!< Enables or disables the write operation in the selected bank by the FMC. + This parameter can be a value of @ref FMC_Write_Operation */ + + uint32_t FMC_WaitSignal; /*!< Enables or disables the wait state insertion via wait + signal, valid for Flash memory access in burst mode. + This parameter can be a value of @ref FMC_Wait_Signal */ + + uint32_t FMC_ExtendedMode; /*!< Enables or disables the extended mode. + This parameter can be a value of @ref FMC_Extended_Mode */ + + uint32_t FMC_AsynchronousWait; /*!< Enables or disables wait signal during asynchronous transfers, + valid only with asynchronous Flash memories. + This parameter can be a value of @ref FMC_AsynchronousWait */ + + uint32_t FMC_WriteBurst; /*!< Enables or disables the write burst operation. + This parameter can be a value of @ref FMC_Write_Burst */ + + uint32_t FMC_ContinousClock; /*!< Enables or disables the FMC clock output to external memory devices. + This parameter is only enabled through the FMC_BCR1 register, and don't care + through FMC_BCR2..4 registers. + This parameter can be a value of @ref FMC_Continous_Clock */ + + + FMC_NORSRAMTimingInitTypeDef* FMC_ReadWriteTimingStruct; /*!< Timing Parameters for write and read access if the Extended Mode is not used*/ + + FMC_NORSRAMTimingInitTypeDef* FMC_WriteTimingStruct; /*!< Timing Parameters for write access if the Extended Mode is used*/ +}FMC_NORSRAMInitTypeDef; + +/** + * @brief Timing parameters For FMC NAND and PCCARD Banks + */ +typedef struct +{ + uint32_t FMC_SetupTime; /*!< Defines the number of HCLK cycles to setup address before + the command assertion for NAND-Flash read or write access + to common/Attribute or I/O memory space (depending on + the memory space timing to be configured). + This parameter can be a value between 0 and 255.*/ + + uint32_t FMC_WaitSetupTime; /*!< Defines the minimum number of HCLK cycles to assert the + command for NAND-Flash read or write access to + common/Attribute or I/O memory space (depending on the + memory space timing to be configured). + This parameter can be a number between 0 and 255 */ + + uint32_t FMC_HoldSetupTime; /*!< Defines the number of HCLK clock cycles to hold address + (and data for write access) after the command de-assertion + for NAND-Flash read or write access to common/Attribute + or I/O memory space (depending on the memory space timing + to be configured). + This parameter can be a number between 0 and 255 */ + + uint32_t FMC_HiZSetupTime; /*!< Defines the number of HCLK clock cycles during which the + databus is kept in HiZ after the start of a NAND-Flash + write access to common/Attribute or I/O memory space (depending + on the memory space timing to be configured). + This parameter can be a number between 0 and 255 */ +}FMC_NAND_PCCARDTimingInitTypeDef; + +/** + * @brief FMC NAND Init structure definition + */ +typedef struct +{ + uint32_t FMC_Bank; /*!< Specifies the NAND memory bank that will be used. + This parameter can be a value of @ref FMC_NAND_Bank */ + + uint32_t FMC_Waitfeature; /*!< Enables or disables the Wait feature for the NAND Memory Bank. + This parameter can be any value of @ref FMC_Wait_feature */ + + uint32_t FMC_MemoryDataWidth; /*!< Specifies the external memory device width. + This parameter can be any value of @ref FMC_NAND_Data_Width */ + + uint32_t FMC_ECC; /*!< Enables or disables the ECC computation. + This parameter can be any value of @ref FMC_ECC */ + + uint32_t FMC_ECCPageSize; /*!< Defines the page size for the extended ECC. + This parameter can be any value of @ref FMC_ECC_Page_Size */ + + uint32_t FMC_TCLRSetupTime; /*!< Defines the number of HCLK cycles to configure the + delay between CLE low and RE low. + This parameter can be a value between 0 and 255. */ + + uint32_t FMC_TARSetupTime; /*!< Defines the number of HCLK cycles to configure the + delay between ALE low and RE low. + This parameter can be a number between 0 and 255 */ + + FMC_NAND_PCCARDTimingInitTypeDef* FMC_CommonSpaceTimingStruct; /*!< FMC Common Space Timing */ + + FMC_NAND_PCCARDTimingInitTypeDef* FMC_AttributeSpaceTimingStruct; /*!< FMC Attribute Space Timing */ +}FMC_NANDInitTypeDef; + +/** + * @brief FMC PCCARD Init structure definition + */ + +typedef struct +{ + uint32_t FMC_Waitfeature; /*!< Enables or disables the Wait feature for the Memory Bank. + This parameter can be any value of @ref FMC_Wait_feature */ + + uint32_t FMC_TCLRSetupTime; /*!< Defines the number of HCLK cycles to configure the + delay between CLE low and RE low. + This parameter can be a value between 0 and 255. */ + + uint32_t FMC_TARSetupTime; /*!< Defines the number of HCLK cycles to configure the + delay between ALE low and RE low. + This parameter can be a number between 0 and 255 */ + + + FMC_NAND_PCCARDTimingInitTypeDef* FMC_CommonSpaceTimingStruct; /*!< FMC Common Space Timing */ + + FMC_NAND_PCCARDTimingInitTypeDef* FMC_AttributeSpaceTimingStruct; /*!< FMC Attribute Space Timing */ + + FMC_NAND_PCCARDTimingInitTypeDef* FMC_IOSpaceTimingStruct; /*!< FMC IO Space Timing */ +}FMC_PCCARDInitTypeDef; + +/** + * @brief Timing parameters for FMC SDRAM Banks + */ + +typedef struct +{ + uint32_t FMC_LoadToActiveDelay; /*!< Defines the delay between a Load Mode Register command and + an active or Refresh command in number of memory clock cycles. + This parameter can be a value between 1 and 16. */ + + uint32_t FMC_ExitSelfRefreshDelay; /*!< Defines the delay from releasing the self refresh command to + issuing the Activate command in number of memory clock cycles. + This parameter can be a value between 1 and 16. */ + + uint32_t FMC_SelfRefreshTime; /*!< Defines the minimum Self Refresh period in number of memory clock + cycles. + This parameter can be a value between 1 and 16. */ + + uint32_t FMC_RowCycleDelay; /*!< Defines the delay between the Refresh command and the Activate command + and the delay between two consecutive Refresh commands in number of + memory clock cycles. + This parameter can be a value between 1 and 16. */ + + uint32_t FMC_WriteRecoveryTime; /*!< Defines the Write recovery Time in number of memory clock cycles. + This parameter can be a value between 1 and 16. */ + + uint32_t FMC_RPDelay; /*!< Defines the delay between a Precharge Command and an other command + in number of memory clock cycles. + This parameter can be a value between 1 and 16. */ + + uint32_t FMC_RCDDelay; /*!< Defines the delay between the Activate Command and a Read/Write command + in number of memory clock cycles. + This parameter can be a value between 1 and 16. */ + +}FMC_SDRAMTimingInitTypeDef; + +/** + * @brief Command parameters for FMC SDRAM Banks + */ + + +typedef struct +{ + uint32_t FMC_CommandMode; /*!< Defines the command issued to the SDRAM device. + This parameter can be a value of @ref FMC_Command_Mode. */ + + uint32_t FMC_CommandTarget; /*!< Defines which bank (1 or 2) the command will be issued to. + This parameter can be a value of @ref FMC_Command_Target. */ + + uint32_t FMC_AutoRefreshNumber; /*!< Defines the number of consecutive auto refresh command issued + in auto refresh mode. + This parameter can be a value between 1 and 16. */ + + uint32_t FMC_ModeRegisterDefinition; /*!< Defines the SDRAM Mode register content */ + +}FMC_SDRAMCommandTypeDef; + +/** + * @brief FMC SDRAM Init structure definition + */ + +typedef struct +{ + uint32_t FMC_Bank; /*!< Specifies the SDRAM memory bank that will be used. + This parameter can be a value of @ref FMC_SDRAM_Bank */ + + uint32_t FMC_ColumnBitsNumber; /*!< Defines the number of bits of column address. + This parameter can be a value of @ref FMC_ColumnBits_Number. */ + + uint32_t FMC_RowBitsNumber; /*!< Defines the number of bits of column address.. + This parameter can be a value of @ref FMC_RowBits_Number. */ + + uint32_t FMC_SDMemoryDataWidth; /*!< Defines the memory device width. + This parameter can be a value of @ref FMC_SDMemory_Data_Width. */ + + uint32_t FMC_InternalBankNumber; /*!< Defines the number of bits of column address. + This parameter can be of @ref FMC_InternalBank_Number. */ + + uint32_t FMC_CASLatency; /*!< Defines the SDRAM CAS latency in number of memory clock cycles. + This parameter can be a value of @ref FMC_CAS_Latency. */ + + uint32_t FMC_WriteProtection; /*!< Enables the SDRAM bank to be accessed in write mode. + This parameter can be a value of @ref FMC_Write_Protection. */ + + uint32_t FMC_SDClockPeriod; /*!< Define the SDRAM Clock Period for both SDRAM Banks and they allow to disable + the clock before changing frequency. + This parameter can be a value of @ref FMC_SDClock_Period. */ + + uint32_t FMC_ReadBurst; /*!< This bit enable the SDRAM controller to anticipate the next read commands + during the CAS latency and stores data in the Read FIFO. + This parameter can be a value of @ref FMC_Read_Burst. */ + + uint32_t FMC_ReadPipeDelay; /*!< Define the delay in system clock cycles on read data path. + This parameter can be a value of @ref FMC_ReadPipe_Delay. */ + + FMC_SDRAMTimingInitTypeDef* FMC_SDRAMTimingStruct; /*!< Timing Parameters for write and read access*/ + +}FMC_SDRAMInitTypeDef; + + +/* Exported constants --------------------------------------------------------*/ + +/** @defgroup FMC_Exported_Constants + * @{ + */ + +/** @defgroup FMC_NORSRAM_Bank + * @{ + */ +#define FMC_Bank1_NORSRAM1 ((uint32_t)0x00000000) +#define FMC_Bank1_NORSRAM2 ((uint32_t)0x00000002) +#define FMC_Bank1_NORSRAM3 ((uint32_t)0x00000004) +#define FMC_Bank1_NORSRAM4 ((uint32_t)0x00000006) + +#define IS_FMC_NORSRAM_BANK(BANK) (((BANK) == FMC_Bank1_NORSRAM1) || \ + ((BANK) == FMC_Bank1_NORSRAM2) || \ + ((BANK) == FMC_Bank1_NORSRAM3) || \ + ((BANK) == FMC_Bank1_NORSRAM4)) +/** + * @} + */ + +/** @defgroup FMC_NAND_Bank + * @{ + */ +#define FMC_Bank2_NAND ((uint32_t)0x00000010) +#define FMC_Bank3_NAND ((uint32_t)0x00000100) + +#define IS_FMC_NAND_BANK(BANK) (((BANK) == FMC_Bank2_NAND) || \ + ((BANK) == FMC_Bank3_NAND)) +/** + * @} + */ + +/** @defgroup FMC_PCCARD_Bank + * @{ + */ +#define FMC_Bank4_PCCARD ((uint32_t)0x00001000) +/** + * @} + */ + +/** @defgroup FMC_SDRAM_Bank + * @{ + */ +#define FMC_Bank1_SDRAM ((uint32_t)0x00000000) +#define FMC_Bank2_SDRAM ((uint32_t)0x00000001) + +#define IS_FMC_SDRAM_BANK(BANK) (((BANK) == FMC_Bank1_SDRAM) || \ + ((BANK) == FMC_Bank2_SDRAM)) + +/** + * @} + */ + + +/** @defgroup FMC_NOR_SRAM_Controller + * @{ + */ + +/** @defgroup FMC_Data_Address_Bus_Multiplexing + * @{ + */ + +#define FMC_DataAddressMux_Disable ((uint32_t)0x00000000) +#define FMC_DataAddressMux_Enable ((uint32_t)0x00000002) + +#define IS_FMC_MUX(MUX) (((MUX) == FMC_DataAddressMux_Disable) || \ + ((MUX) == FMC_DataAddressMux_Enable)) +/** + * @} + */ + +/** @defgroup FMC_Memory_Type + * @{ + */ + +#define FMC_MemoryType_SRAM ((uint32_t)0x00000000) +#define FMC_MemoryType_PSRAM ((uint32_t)0x00000004) +#define FMC_MemoryType_NOR ((uint32_t)0x00000008) + +#define IS_FMC_MEMORY(MEMORY) (((MEMORY) == FMC_MemoryType_SRAM) || \ + ((MEMORY) == FMC_MemoryType_PSRAM)|| \ + ((MEMORY) == FMC_MemoryType_NOR)) +/** + * @} + */ + +/** @defgroup FMC_NORSRAM_Data_Width + * @{ + */ + +#define FMC_NORSRAM_MemoryDataWidth_8b ((uint32_t)0x00000000) +#define FMC_NORSRAM_MemoryDataWidth_16b ((uint32_t)0x00000010) +#define FMC_NORSRAM_MemoryDataWidth_32b ((uint32_t)0x00000020) + +#define IS_FMC_NORSRAM_MEMORY_WIDTH(WIDTH) (((WIDTH) == FMC_NORSRAM_MemoryDataWidth_8b) || \ + ((WIDTH) == FMC_NORSRAM_MemoryDataWidth_16b) || \ + ((WIDTH) == FMC_NORSRAM_MemoryDataWidth_32b)) +/** + * @} + */ + +/** @defgroup FMC_Burst_Access_Mode + * @{ + */ + +#define FMC_BurstAccessMode_Disable ((uint32_t)0x00000000) +#define FMC_BurstAccessMode_Enable ((uint32_t)0x00000100) + +#define IS_FMC_BURSTMODE(STATE) (((STATE) == FMC_BurstAccessMode_Disable) || \ + ((STATE) == FMC_BurstAccessMode_Enable)) +/** + * @} + */ + +/** @defgroup FMC_AsynchronousWait + * @{ + */ +#define FMC_AsynchronousWait_Disable ((uint32_t)0x00000000) +#define FMC_AsynchronousWait_Enable ((uint32_t)0x00008000) + +#define IS_FMC_ASYNWAIT(STATE) (((STATE) == FMC_AsynchronousWait_Disable) || \ + ((STATE) == FMC_AsynchronousWait_Enable)) +/** + * @} + */ + +/** @defgroup FMC_Wait_Signal_Polarity + * @{ + */ +#define FMC_WaitSignalPolarity_Low ((uint32_t)0x00000000) +#define FMC_WaitSignalPolarity_High ((uint32_t)0x00000200) + +#define IS_FMC_WAIT_POLARITY(POLARITY) (((POLARITY) == FMC_WaitSignalPolarity_Low) || \ + ((POLARITY) == FMC_WaitSignalPolarity_High)) +/** + * @} + */ + +/** @defgroup FMC_Wrap_Mode + * @{ + */ +#define FMC_WrapMode_Disable ((uint32_t)0x00000000) +#define FMC_WrapMode_Enable ((uint32_t)0x00000400) + +#define IS_FMC_WRAP_MODE(MODE) (((MODE) == FMC_WrapMode_Disable) || \ + ((MODE) == FMC_WrapMode_Enable)) +/** + * @} + */ + +/** @defgroup FMC_Wait_Timing + * @{ + */ +#define FMC_WaitSignalActive_BeforeWaitState ((uint32_t)0x00000000) +#define FMC_WaitSignalActive_DuringWaitState ((uint32_t)0x00000800) + +#define IS_FMC_WAIT_SIGNAL_ACTIVE(ACTIVE) (((ACTIVE) == FMC_WaitSignalActive_BeforeWaitState) || \ + ((ACTIVE) == FMC_WaitSignalActive_DuringWaitState)) +/** + * @} + */ + +/** @defgroup FMC_Write_Operation + * @{ + */ +#define FMC_WriteOperation_Disable ((uint32_t)0x00000000) +#define FMC_WriteOperation_Enable ((uint32_t)0x00001000) + +#define IS_FMC_WRITE_OPERATION(OPERATION) (((OPERATION) == FMC_WriteOperation_Disable) || \ + ((OPERATION) == FMC_WriteOperation_Enable)) +/** + * @} + */ + +/** @defgroup FMC_Wait_Signal + * @{ + */ +#define FMC_WaitSignal_Disable ((uint32_t)0x00000000) +#define FMC_WaitSignal_Enable ((uint32_t)0x00002000) + +#define IS_FMC_WAITE_SIGNAL(SIGNAL) (((SIGNAL) == FMC_WaitSignal_Disable) || \ + ((SIGNAL) == FMC_WaitSignal_Enable)) +/** + * @} + */ + +/** @defgroup FMC_Extended_Mode + * @{ + */ +#define FMC_ExtendedMode_Disable ((uint32_t)0x00000000) +#define FMC_ExtendedMode_Enable ((uint32_t)0x00004000) + +#define IS_FMC_EXTENDED_MODE(MODE) (((MODE) == FMC_ExtendedMode_Disable) || \ + ((MODE) == FMC_ExtendedMode_Enable)) +/** + * @} + */ + +/** @defgroup FMC_Write_Burst + * @{ + */ + +#define FMC_WriteBurst_Disable ((uint32_t)0x00000000) +#define FMC_WriteBurst_Enable ((uint32_t)0x00080000) + +#define IS_FMC_WRITE_BURST(BURST) (((BURST) == FMC_WriteBurst_Disable) || \ + ((BURST) == FMC_WriteBurst_Enable)) +/** + * @} + */ + +/** @defgroup FMC_Continous_Clock + * @{ + */ + +#define FMC_CClock_SyncOnly ((uint32_t)0x00000000) +#define FMC_CClock_SyncAsync ((uint32_t)0x00100000) + +#define IS_FMC_CONTINOUS_CLOCK(CCLOCK) (((CCLOCK) == FMC_CClock_SyncOnly) || \ + ((CCLOCK) == FMC_CClock_SyncAsync)) +/** + * @} + */ + +/** @defgroup FMC_Address_Setup_Time + * @{ + */ +#define IS_FMC_ADDRESS_SETUP_TIME(TIME) ((TIME) <= 15) +/** + * @} + */ + +/** @defgroup FMC_Address_Hold_Time + * @{ + */ +#define IS_FMC_ADDRESS_HOLD_TIME(TIME) (((TIME) > 0) && ((TIME) <= 15)) +/** + * @} + */ + +/** @defgroup FMC_Data_Setup_Time + * @{ + */ +#define IS_FMC_DATASETUP_TIME(TIME) (((TIME) > 0) && ((TIME) <= 255)) +/** + * @} + */ + +/** @defgroup FMC_Bus_Turn_around_Duration + * @{ + */ +#define IS_FMC_TURNAROUND_TIME(TIME) ((TIME) <= 15) +/** + * @} + */ + +/** @defgroup FMC_CLK_Division + * @{ + */ +#define IS_FMC_CLK_DIV(DIV) (((DIV) > 0) && ((DIV) <= 15)) +/** + * @} + */ + +/** @defgroup FMC_Data_Latency + * @{ + */ +#define IS_FMC_DATA_LATENCY(LATENCY) ((LATENCY) <= 15) +/** + * @} + */ + +/** @defgroup FMC_Access_Mode + * @{ + */ +#define FMC_AccessMode_A ((uint32_t)0x00000000) +#define FMC_AccessMode_B ((uint32_t)0x10000000) +#define FMC_AccessMode_C ((uint32_t)0x20000000) +#define FMC_AccessMode_D ((uint32_t)0x30000000) + +#define IS_FMC_ACCESS_MODE(MODE) (((MODE) == FMC_AccessMode_A) || \ + ((MODE) == FMC_AccessMode_B) || \ + ((MODE) == FMC_AccessMode_C) || \ + ((MODE) == FMC_AccessMode_D)) +/** + * @} + */ + +/** + * @} + */ + +/** @defgroup FMC_NAND_PCCARD_Controller + * @{ + */ + +/** @defgroup FMC_Wait_feature + * @{ + */ +#define FMC_Waitfeature_Disable ((uint32_t)0x00000000) +#define FMC_Waitfeature_Enable ((uint32_t)0x00000002) + +#define IS_FMC_WAIT_FEATURE(FEATURE) (((FEATURE) == FMC_Waitfeature_Disable) || \ + ((FEATURE) == FMC_Waitfeature_Enable)) +/** + * @} + */ + +/** @defgroup FMC_NAND_Data_Width + * @{ + */ +#define FMC_NAND_MemoryDataWidth_8b ((uint32_t)0x00000000) +#define FMC_NAND_MemoryDataWidth_16b ((uint32_t)0x00000010) + +#define IS_FMC_NAND_MEMORY_WIDTH(WIDTH) (((WIDTH) == FMC_NAND_MemoryDataWidth_8b) || \ + ((WIDTH) == FMC_NAND_MemoryDataWidth_16b)) +/** + * @} + */ + +/** @defgroup FMC_ECC + * @{ + */ +#define FMC_ECC_Disable ((uint32_t)0x00000000) +#define FMC_ECC_Enable ((uint32_t)0x00000040) + +#define IS_FMC_ECC_STATE(STATE) (((STATE) == FMC_ECC_Disable) || \ + ((STATE) == FMC_ECC_Enable)) +/** + * @} + */ + +/** @defgroup FMC_ECC_Page_Size + * @{ + */ +#define FMC_ECCPageSize_256Bytes ((uint32_t)0x00000000) +#define FMC_ECCPageSize_512Bytes ((uint32_t)0x00020000) +#define FMC_ECCPageSize_1024Bytes ((uint32_t)0x00040000) +#define FMC_ECCPageSize_2048Bytes ((uint32_t)0x00060000) +#define FMC_ECCPageSize_4096Bytes ((uint32_t)0x00080000) +#define FMC_ECCPageSize_8192Bytes ((uint32_t)0x000A0000) + +#define IS_FMC_ECCPAGE_SIZE(SIZE) (((SIZE) == FMC_ECCPageSize_256Bytes) || \ + ((SIZE) == FMC_ECCPageSize_512Bytes) || \ + ((SIZE) == FMC_ECCPageSize_1024Bytes) || \ + ((SIZE) == FMC_ECCPageSize_2048Bytes) || \ + ((SIZE) == FMC_ECCPageSize_4096Bytes) || \ + ((SIZE) == FMC_ECCPageSize_8192Bytes)) +/** + * @} + */ + +/** @defgroup FMC_TCLR_Setup_Time + * @{ + */ +#define IS_FMC_TCLR_TIME(TIME) ((TIME) <= 255) +/** + * @} + */ + +/** @defgroup FMC_TAR_Setup_Time + * @{ + */ +#define IS_FMC_TAR_TIME(TIME) ((TIME) <= 255) +/** + * @} + */ + +/** @defgroup FMC_Setup_Time + * @{ + */ +#define IS_FMC_SETUP_TIME(TIME) ((TIME) <= 255) +/** + * @} + */ + +/** @defgroup FMC_Wait_Setup_Time + * @{ + */ +#define IS_FMC_WAIT_TIME(TIME) ((TIME) <= 255) +/** + * @} + */ + +/** @defgroup FMC_Hold_Setup_Time + * @{ + */ +#define IS_FMC_HOLD_TIME(TIME) ((TIME) <= 255) +/** + * @} + */ + +/** @defgroup FMC_HiZ_Setup_Time + * @{ + */ +#define IS_FMC_HIZ_TIME(TIME) ((TIME) <= 255) +/** + * @} + */ + +/** + * @} + */ + + +/** @defgroup FMC_NOR_SRAM_Controller + * @{ + */ + +/** @defgroup FMC_ColumnBits_Number + * @{ + */ +#define FMC_ColumnBits_Number_8b ((uint32_t)0x00000000) +#define FMC_ColumnBits_Number_9b ((uint32_t)0x00000001) +#define FMC_ColumnBits_Number_10b ((uint32_t)0x00000002) +#define FMC_ColumnBits_Number_11b ((uint32_t)0x00000003) + +#define IS_FMC_COLUMNBITS_NUMBER(COLUMN) (((COLUMN) == FMC_ColumnBits_Number_8b) || \ + ((COLUMN) == FMC_ColumnBits_Number_9b) || \ + ((COLUMN) == FMC_ColumnBits_Number_10b) || \ + ((COLUMN) == FMC_ColumnBits_Number_11b)) + +/** + * @} + */ + +/** @defgroup FMC_RowBits_Number + * @{ + */ +#define FMC_RowBits_Number_11b ((uint32_t)0x00000000) +#define FMC_RowBits_Number_12b ((uint32_t)0x00000004) +#define FMC_RowBits_Number_13b ((uint32_t)0x00000008) + +#define IS_FMC_ROWBITS_NUMBER(ROW) (((ROW) == FMC_RowBits_Number_11b) || \ + ((ROW) == FMC_RowBits_Number_12b) || \ + ((ROW) == FMC_RowBits_Number_13b)) + +/** + * @} + */ + +/** @defgroup FMC_SDMemory_Data_Width + * @{ + */ +#define FMC_SDMemory_Width_8b ((uint32_t)0x00000000) +#define FMC_SDMemory_Width_16b ((uint32_t)0x00000010) +#define FMC_SDMemory_Width_32b ((uint32_t)0x00000020) + +#define IS_FMC_SDMEMORY_WIDTH(WIDTH) (((WIDTH) == FMC_SDMemory_Width_8b) || \ + ((WIDTH) == FMC_SDMemory_Width_16b) || \ + ((WIDTH) == FMC_SDMemory_Width_32b)) + +/** + * @} + */ + +/** @defgroup FMC_InternalBank_Number + * @{ + */ +#define FMC_InternalBank_Number_2 ((uint32_t)0x00000000) +#define FMC_InternalBank_Number_4 ((uint32_t)0x00000040) + +#define IS_FMC_INTERNALBANK_NUMBER(NUMBER) (((NUMBER) == FMC_InternalBank_Number_2) || \ + ((NUMBER) == FMC_InternalBank_Number_4)) + +/** + * @} + */ + + +/** @defgroup FMC_CAS_Latency + * @{ + */ +#define FMC_CAS_Latency_1 ((uint32_t)0x00000080) +#define FMC_CAS_Latency_2 ((uint32_t)0x00000100) +#define FMC_CAS_Latency_3 ((uint32_t)0x00000180) + +#define IS_FMC_CAS_LATENCY(LATENCY) (((LATENCY) == FMC_CAS_Latency_1) || \ + ((LATENCY) == FMC_CAS_Latency_2) || \ + ((LATENCY) == FMC_CAS_Latency_3)) + +/** + * @} + */ + +/** @defgroup FMC_Write_Protection + * @{ + */ +#define FMC_Write_Protection_Disable ((uint32_t)0x00000000) +#define FMC_Write_Protection_Enable ((uint32_t)0x00000200) + +#define IS_FMC_WRITE_PROTECTION(WRITE) (((WRITE) == FMC_Write_Protection_Disable) || \ + ((WRITE) == FMC_Write_Protection_Enable)) + +/** + * @} + */ + + +/** @defgroup FMC_SDClock_Period + * @{ + */ +#define FMC_SDClock_Disable ((uint32_t)0x00000000) +#define FMC_SDClock_Period_2 ((uint32_t)0x00000800) +#define FMC_SDClock_Period_3 ((uint32_t)0x00000C00) + +#define IS_FMC_SDCLOCK_PERIOD(PERIOD) (((PERIOD) == FMC_SDClock_Disable) || \ + ((PERIOD) == FMC_SDClock_Period_2) || \ + ((PERIOD) == FMC_SDClock_Period_3)) + +/** + * @} + */ + +/** @defgroup FMC_Read_Burst + * @{ + */ +#define FMC_Read_Burst_Disable ((uint32_t)0x00000000) +#define FMC_Read_Burst_Enable ((uint32_t)0x00001000) + +#define IS_FMC_READ_BURST(RBURST) (((RBURST) == FMC_Read_Burst_Disable) || \ + ((RBURST) == FMC_Read_Burst_Enable)) + +/** + * @} + */ + +/** @defgroup FMC_ReadPipe_Delay + * @{ + */ +#define FMC_ReadPipe_Delay_0 ((uint32_t)0x00000000) +#define FMC_ReadPipe_Delay_1 ((uint32_t)0x00002000) +#define FMC_ReadPipe_Delay_2 ((uint32_t)0x00004000) + +#define IS_FMC_READPIPE_DELAY(DELAY) (((DELAY) == FMC_ReadPipe_Delay_0) || \ + ((DELAY) == FMC_ReadPipe_Delay_1) || \ + ((DELAY) == FMC_ReadPipe_Delay_2)) + +/** + * @} + */ + +/** @defgroup FMC_LoadToActive_Delay + * @{ + */ +#define IS_FMC_LOADTOACTIVE_DELAY(DELAY) (((DELAY) > 0) && ((DELAY) <= 16)) +/** + * @} + */ + +/** @defgroup FMC_ExitSelfRefresh_Delay + * @{ + */ +#define IS_FMC_EXITSELFREFRESH_DELAY(DELAY) (((DELAY) > 0) && ((DELAY) <= 16)) +/** + * @} + */ + +/** @defgroup FMC_SelfRefresh_Time + * @{ + */ +#define IS_FMC_SELFREFRESH_TIME(TIME) (((TIME) > 0) && ((TIME) <= 16)) +/** + * @} + */ + +/** @defgroup FMC_RowCycle_Delay + * @{ + */ +#define IS_FMC_ROWCYCLE_DELAY(DELAY) (((DELAY) > 0) && ((DELAY) <= 16)) +/** + * @} + */ + +/** @defgroup FMC_Write_Recovery_Time + * @{ + */ +#define IS_FMC_WRITE_RECOVERY_TIME(TIME) (((TIME) > 0) && ((TIME) <= 16)) +/** + * @} + */ + +/** @defgroup FMC_RP_Delay + * @{ + */ +#define IS_FMC_RP_DELAY(DELAY) (((DELAY) > 0) && ((DELAY) <= 16)) +/** + * @} + */ + +/** @defgroup FMC_RCD_Delay + * @{ + */ +#define IS_FMC_RCD_DELAY(DELAY) (((DELAY) > 0) && ((DELAY) <= 16)) + +/** + * @} + */ + +/** @defgroup FMC_Command_Mode + * @{ + */ +#define FMC_Command_Mode_normal ((uint32_t)0x00000000) +#define FMC_Command_Mode_CLK_Enabled ((uint32_t)0x00000001) +#define FMC_Command_Mode_PALL ((uint32_t)0x00000002) +#define FMC_Command_Mode_AutoRefresh ((uint32_t)0x00000003) +#define FMC_Command_Mode_LoadMode ((uint32_t)0x00000004) +#define FMC_Command_Mode_Selfrefresh ((uint32_t)0x00000005) +#define FMC_Command_Mode_PowerDown ((uint32_t)0x00000006) + +#define IS_FMC_COMMAND_MODE(COMMAND) (((COMMAND) == FMC_Command_Mode_normal) || \ + ((COMMAND) == FMC_Command_Mode_CLK_Enabled) || \ + ((COMMAND) == FMC_Command_Mode_PALL) || \ + ((COMMAND) == FMC_Command_Mode_AutoRefresh) || \ + ((COMMAND) == FMC_Command_Mode_LoadMode) || \ + ((COMMAND) == FMC_Command_Mode_Selfrefresh) || \ + ((COMMAND) == FMC_Command_Mode_PowerDown)) + +/** + * @} + */ + +/** @defgroup FMC_Command_Target + * @{ + */ +#define FMC_Command_Target_bank2 ((uint32_t)0x00000008) +#define FMC_Command_Target_bank1 ((uint32_t)0x00000010) +#define FMC_Command_Target_bank1_2 ((uint32_t)0x00000018) + +#define IS_FMC_COMMAND_TARGET(TARGET) (((TARGET) == FMC_Command_Target_bank1) || \ + ((TARGET) == FMC_Command_Target_bank2) || \ + ((TARGET) == FMC_Command_Target_bank1_2)) + +/** + * @} + */ + +/** @defgroup FMC_AutoRefresh_Number + * @{ + */ +#define IS_FMC_AUTOREFRESH_NUMBER(NUMBER) (((NUMBER) > 0) && ((NUMBER) <= 16)) + +/** + * @} + */ + +/** @defgroup FMC_ModeRegister_Definition + * @{ + */ +#define IS_FMC_MODE_REGISTER(CONTENT) ((CONTENT) <= 8191) + +/** + * @} + */ + + +/** @defgroup FMC_Mode_Status + * @{ + */ +#define FMC_NormalMode_Status ((uint32_t)0x00000000) +#define FMC_SelfRefreshMode_Status FMC_SDSR_MODES1_0 +#define FMC_PowerDownMode_Status FMC_SDSR_MODES1_1 + +#define IS_FMC_MODE_STATUS(STATUS) (((STATUS) == FMC_NormalMode_Status) || \ + ((STATUS) == FMC_SelfRefreshMode_Status) || \ + ((STATUS) == FMC_PowerDownMode_Status)) + + +/** + * @} + */ + +/** + * @} + */ + +/** @defgroup FMC_Interrupt_sources + * @{ + */ +#define FMC_IT_RisingEdge ((uint32_t)0x00000008) +#define FMC_IT_Level ((uint32_t)0x00000010) +#define FMC_IT_FallingEdge ((uint32_t)0x00000020) +#define FMC_IT_Refresh ((uint32_t)0x00004000) + +#define IS_FMC_IT(IT) ((((IT) & (uint32_t)0xFFFFBFC7) == 0x00000000) && ((IT) != 0x00000000)) +#define IS_FMC_GET_IT(IT) (((IT) == FMC_IT_RisingEdge) || \ + ((IT) == FMC_IT_Level) || \ + ((IT) == FMC_IT_FallingEdge) || \ + ((IT) == FMC_IT_Refresh)) + +#define IS_FMC_IT_BANK(BANK) (((BANK) == FMC_Bank2_NAND) || \ + ((BANK) == FMC_Bank3_NAND) || \ + ((BANK) == FMC_Bank4_PCCARD) || \ + ((BANK) == FMC_Bank1_SDRAM) || \ + ((BANK) == FMC_Bank2_SDRAM)) +/** + * @} + */ + +/** @defgroup FMC_Flags + * @{ + */ +#define FMC_FLAG_RisingEdge ((uint32_t)0x00000001) +#define FMC_FLAG_Level ((uint32_t)0x00000002) +#define FMC_FLAG_FallingEdge ((uint32_t)0x00000004) +#define FMC_FLAG_FEMPT ((uint32_t)0x00000040) +#define FMC_FLAG_Refresh FMC_SDSR_RE +#define FMC_FLAG_Busy FMC_SDSR_BUSY + +#define IS_FMC_GET_FLAG(FLAG) (((FLAG) == FMC_FLAG_RisingEdge) || \ + ((FLAG) == FMC_FLAG_Level) || \ + ((FLAG) == FMC_FLAG_FallingEdge) || \ + ((FLAG) == FMC_FLAG_FEMPT) || \ + ((FLAG) == FMC_FLAG_Refresh) || \ + ((FLAG) == FMC_SDSR_BUSY)) + +#define IS_FMC_GETFLAG_BANK(BANK) (((BANK) == FMC_Bank2_NAND) || \ + ((BANK) == FMC_Bank3_NAND) || \ + ((BANK) == FMC_Bank4_PCCARD) || \ + ((BANK) == FMC_Bank1_SDRAM) || \ + ((BANK) == FMC_Bank2_SDRAM) || \ + ((BANK) == (FMC_Bank1_SDRAM | FMC_Bank2_SDRAM))) + +#define IS_FMC_CLEAR_FLAG(FLAG) ((((FLAG) & (uint32_t)0xFFFFFFF8) == 0x00000000) && ((FLAG) != 0x00000000)) + + +/** + * @} + */ + +/** @defgroup FMC_Refresh_count + * @{ + */ +#define IS_FMC_REFRESH_COUNT(COUNT) ((COUNT) <= 8191) + +/** + * @} + */ + +/** + * @} + */ + + +/* Exported macro ------------------------------------------------------------*/ +/* Exported functions --------------------------------------------------------*/ + +/* NOR/SRAM Controller functions **********************************************/ +void FMC_NORSRAMDeInit(uint32_t FMC_Bank); +void FMC_NORSRAMInit(FMC_NORSRAMInitTypeDef* FMC_NORSRAMInitStruct); +void FMC_NORSRAMStructInit(FMC_NORSRAMInitTypeDef* FMC_NORSRAMInitStruct); +void FMC_NORSRAMCmd(uint32_t FMC_Bank, FunctionalState NewState); + +/* NAND Controller functions **************************************************/ +void FMC_NANDDeInit(uint32_t FMC_Bank); +void FMC_NANDInit(FMC_NANDInitTypeDef* FMC_NANDInitStruct); +void FMC_NANDStructInit(FMC_NANDInitTypeDef* FMC_NANDInitStruct); +void FMC_NANDCmd(uint32_t FMC_Bank, FunctionalState NewState); +void FMC_NANDECCCmd(uint32_t FMC_Bank, FunctionalState NewState); +uint32_t FMC_GetECC(uint32_t FMC_Bank); + +/* PCCARD Controller functions ************************************************/ +void FMC_PCCARDDeInit(void); +void FMC_PCCARDInit(FMC_PCCARDInitTypeDef* FMC_PCCARDInitStruct); +void FMC_PCCARDStructInit(FMC_PCCARDInitTypeDef* FMC_PCCARDInitStruct); +void FMC_PCCARDCmd(FunctionalState NewState); + +/* SDRAM Controller functions ************************************************/ +void FMC_SDRAMDeInit(uint32_t FMC_Bank); +void FMC_SDRAMInit(FMC_SDRAMInitTypeDef* FMC_SDRAMInitStruct); +void FMC_SDRAMStructInit(FMC_SDRAMInitTypeDef* FMC_SDRAMInitStruct); +void FMC_SDRAMCmdConfig(FMC_SDRAMCommandTypeDef* FMC_SDRAMCommandStruct); +uint32_t FMC_GetModeStatus(uint32_t SDRAM_Bank); +void FMC_SetRefreshCount(uint32_t FMC_Count); +void FMC_SetAutoRefresh_Number(uint32_t FMC_Number); +void FMC_SDRAMWriteProtectionConfig(uint32_t SDRAM_Bank, FunctionalState NewState); + +/* Interrupts and flags management functions **********************************/ +void FMC_ITConfig(uint32_t FMC_Bank, uint32_t FMC_IT, FunctionalState NewState); +FlagStatus FMC_GetFlagStatus(uint32_t FMC_Bank, uint32_t FMC_FLAG); +void FMC_ClearFlag(uint32_t FMC_Bank, uint32_t FMC_FLAG); +ITStatus FMC_GetITStatus(uint32_t FMC_Bank, uint32_t FMC_IT); +void FMC_ClearITPendingBit(uint32_t FMC_Bank, uint32_t FMC_IT); + +#ifdef __cplusplus +} +#endif + +#endif /*__STM32F4xx_FMC_H */ +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/inc/stm32f4xx_fsmc.h b/FWLIB/inc/stm32f4xx_fsmc.h new file mode 100644 index 0000000..deb0b0d --- /dev/null +++ b/FWLIB/inc/stm32f4xx_fsmc.h @@ -0,0 +1,675 @@ +/** + ****************************************************************************** + * @file stm32f4xx_fsmc.h + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file contains all the functions prototypes for the FSMC firmware + * library. + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Define to prevent recursive inclusion -------------------------------------*/ +#ifndef __STM32F4xx_FSMC_H +#define __STM32F4xx_FSMC_H + +#ifdef __cplusplus + extern "C" { +#endif + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @addtogroup FSMC + * @{ + */ + +/* Exported types ------------------------------------------------------------*/ + +/** + * @brief Timing parameters For NOR/SRAM Banks + */ +typedef struct +{ + uint32_t FSMC_AddressSetupTime; /*!< Defines the number of HCLK cycles to configure + the duration of the address setup time. + This parameter can be a value between 0 and 0xF. + @note This parameter is not used with synchronous NOR Flash memories. */ + + uint32_t FSMC_AddressHoldTime; /*!< Defines the number of HCLK cycles to configure + the duration of the address hold time. + This parameter can be a value between 0 and 0xF. + @note This parameter is not used with synchronous NOR Flash memories.*/ + + uint32_t FSMC_DataSetupTime; /*!< Defines the number of HCLK cycles to configure + the duration of the data setup time. + This parameter can be a value between 0 and 0xFF. + @note This parameter is used for SRAMs, ROMs and asynchronous multiplexed NOR Flash memories. */ + + uint32_t FSMC_BusTurnAroundDuration; /*!< Defines the number of HCLK cycles to configure + the duration of the bus turnaround. + This parameter can be a value between 0 and 0xF. + @note This parameter is only used for multiplexed NOR Flash memories. */ + + uint32_t FSMC_CLKDivision; /*!< Defines the period of CLK clock output signal, expressed in number of HCLK cycles. + This parameter can be a value between 1 and 0xF. + @note This parameter is not used for asynchronous NOR Flash, SRAM or ROM accesses. */ + + uint32_t FSMC_DataLatency; /*!< Defines the number of memory clock cycles to issue + to the memory before getting the first data. + The parameter value depends on the memory type as shown below: + - It must be set to 0 in case of a CRAM + - It is don't care in asynchronous NOR, SRAM or ROM accesses + - It may assume a value between 0 and 0xF in NOR Flash memories + with synchronous burst mode enable */ + + uint32_t FSMC_AccessMode; /*!< Specifies the asynchronous access mode. + This parameter can be a value of @ref FSMC_Access_Mode */ +}FSMC_NORSRAMTimingInitTypeDef; + +/** + * @brief FSMC NOR/SRAM Init structure definition + */ +typedef struct +{ + uint32_t FSMC_Bank; /*!< Specifies the NOR/SRAM memory bank that will be used. + This parameter can be a value of @ref FSMC_NORSRAM_Bank */ + + uint32_t FSMC_DataAddressMux; /*!< Specifies whether the address and data values are + multiplexed on the data bus or not. + This parameter can be a value of @ref FSMC_Data_Address_Bus_Multiplexing */ + + uint32_t FSMC_MemoryType; /*!< Specifies the type of external memory attached to + the corresponding memory bank. + This parameter can be a value of @ref FSMC_Memory_Type */ + + uint32_t FSMC_MemoryDataWidth; /*!< Specifies the external memory device width. + This parameter can be a value of @ref FSMC_Data_Width */ + + uint32_t FSMC_BurstAccessMode; /*!< Enables or disables the burst access mode for Flash memory, + valid only with synchronous burst Flash memories. + This parameter can be a value of @ref FSMC_Burst_Access_Mode */ + + uint32_t FSMC_AsynchronousWait; /*!< Enables or disables wait signal during asynchronous transfers, + valid only with asynchronous Flash memories. + This parameter can be a value of @ref FSMC_AsynchronousWait */ + + uint32_t FSMC_WaitSignalPolarity; /*!< Specifies the wait signal polarity, valid only when accessing + the Flash memory in burst mode. + This parameter can be a value of @ref FSMC_Wait_Signal_Polarity */ + + uint32_t FSMC_WrapMode; /*!< Enables or disables the Wrapped burst access mode for Flash + memory, valid only when accessing Flash memories in burst mode. + This parameter can be a value of @ref FSMC_Wrap_Mode */ + + uint32_t FSMC_WaitSignalActive; /*!< Specifies if the wait signal is asserted by the memory one + clock cycle before the wait state or during the wait state, + valid only when accessing memories in burst mode. + This parameter can be a value of @ref FSMC_Wait_Timing */ + + uint32_t FSMC_WriteOperation; /*!< Enables or disables the write operation in the selected bank by the FSMC. + This parameter can be a value of @ref FSMC_Write_Operation */ + + uint32_t FSMC_WaitSignal; /*!< Enables or disables the wait state insertion via wait + signal, valid for Flash memory access in burst mode. + This parameter can be a value of @ref FSMC_Wait_Signal */ + + uint32_t FSMC_ExtendedMode; /*!< Enables or disables the extended mode. + This parameter can be a value of @ref FSMC_Extended_Mode */ + + uint32_t FSMC_WriteBurst; /*!< Enables or disables the write burst operation. + This parameter can be a value of @ref FSMC_Write_Burst */ + + FSMC_NORSRAMTimingInitTypeDef* FSMC_ReadWriteTimingStruct; /*!< Timing Parameters for write and read access if the Extended Mode is not used*/ + + FSMC_NORSRAMTimingInitTypeDef* FSMC_WriteTimingStruct; /*!< Timing Parameters for write access if the Extended Mode is used*/ +}FSMC_NORSRAMInitTypeDef; + +/** + * @brief Timing parameters For FSMC NAND and PCCARD Banks + */ +typedef struct +{ + uint32_t FSMC_SetupTime; /*!< Defines the number of HCLK cycles to setup address before + the command assertion for NAND Flash read or write access + to common/Attribute or I/O memory space (depending on + the memory space timing to be configured). + This parameter can be a value between 0 and 0xFF.*/ + + uint32_t FSMC_WaitSetupTime; /*!< Defines the minimum number of HCLK cycles to assert the + command for NAND Flash read or write access to + common/Attribute or I/O memory space (depending on the + memory space timing to be configured). + This parameter can be a number between 0x00 and 0xFF */ + + uint32_t FSMC_HoldSetupTime; /*!< Defines the number of HCLK clock cycles to hold address + (and data for write access) after the command de-assertion + for NAND Flash read or write access to common/Attribute + or I/O memory space (depending on the memory space timing + to be configured). + This parameter can be a number between 0x00 and 0xFF */ + + uint32_t FSMC_HiZSetupTime; /*!< Defines the number of HCLK clock cycles during which the + data bus is kept in HiZ after the start of a NAND Flash + write access to common/Attribute or I/O memory space (depending + on the memory space timing to be configured). + This parameter can be a number between 0x00 and 0xFF */ +}FSMC_NAND_PCCARDTimingInitTypeDef; + +/** + * @brief FSMC NAND Init structure definition + */ +typedef struct +{ + uint32_t FSMC_Bank; /*!< Specifies the NAND memory bank that will be used. + This parameter can be a value of @ref FSMC_NAND_Bank */ + + uint32_t FSMC_Waitfeature; /*!< Enables or disables the Wait feature for the NAND Memory Bank. + This parameter can be any value of @ref FSMC_Wait_feature */ + + uint32_t FSMC_MemoryDataWidth; /*!< Specifies the external memory device width. + This parameter can be any value of @ref FSMC_Data_Width */ + + uint32_t FSMC_ECC; /*!< Enables or disables the ECC computation. + This parameter can be any value of @ref FSMC_ECC */ + + uint32_t FSMC_ECCPageSize; /*!< Defines the page size for the extended ECC. + This parameter can be any value of @ref FSMC_ECC_Page_Size */ + + uint32_t FSMC_TCLRSetupTime; /*!< Defines the number of HCLK cycles to configure the + delay between CLE low and RE low. + This parameter can be a value between 0 and 0xFF. */ + + uint32_t FSMC_TARSetupTime; /*!< Defines the number of HCLK cycles to configure the + delay between ALE low and RE low. + This parameter can be a number between 0x0 and 0xFF */ + + FSMC_NAND_PCCARDTimingInitTypeDef* FSMC_CommonSpaceTimingStruct; /*!< FSMC Common Space Timing */ + + FSMC_NAND_PCCARDTimingInitTypeDef* FSMC_AttributeSpaceTimingStruct; /*!< FSMC Attribute Space Timing */ +}FSMC_NANDInitTypeDef; + +/** + * @brief FSMC PCCARD Init structure definition + */ + +typedef struct +{ + uint32_t FSMC_Waitfeature; /*!< Enables or disables the Wait feature for the Memory Bank. + This parameter can be any value of @ref FSMC_Wait_feature */ + + uint32_t FSMC_TCLRSetupTime; /*!< Defines the number of HCLK cycles to configure the + delay between CLE low and RE low. + This parameter can be a value between 0 and 0xFF. */ + + uint32_t FSMC_TARSetupTime; /*!< Defines the number of HCLK cycles to configure the + delay between ALE low and RE low. + This parameter can be a number between 0x0 and 0xFF */ + + + FSMC_NAND_PCCARDTimingInitTypeDef* FSMC_CommonSpaceTimingStruct; /*!< FSMC Common Space Timing */ + + FSMC_NAND_PCCARDTimingInitTypeDef* FSMC_AttributeSpaceTimingStruct; /*!< FSMC Attribute Space Timing */ + + FSMC_NAND_PCCARDTimingInitTypeDef* FSMC_IOSpaceTimingStruct; /*!< FSMC IO Space Timing */ +}FSMC_PCCARDInitTypeDef; + +/* Exported constants --------------------------------------------------------*/ + +/** @defgroup FSMC_Exported_Constants + * @{ + */ + +/** @defgroup FSMC_NORSRAM_Bank + * @{ + */ +#define FSMC_Bank1_NORSRAM1 ((uint32_t)0x00000000) +#define FSMC_Bank1_NORSRAM2 ((uint32_t)0x00000002) +#define FSMC_Bank1_NORSRAM3 ((uint32_t)0x00000004) +#define FSMC_Bank1_NORSRAM4 ((uint32_t)0x00000006) +/** + * @} + */ + +/** @defgroup FSMC_NAND_Bank + * @{ + */ +#define FSMC_Bank2_NAND ((uint32_t)0x00000010) +#define FSMC_Bank3_NAND ((uint32_t)0x00000100) +/** + * @} + */ + +/** @defgroup FSMC_PCCARD_Bank + * @{ + */ +#define FSMC_Bank4_PCCARD ((uint32_t)0x00001000) +/** + * @} + */ + +#define IS_FSMC_NORSRAM_BANK(BANK) (((BANK) == FSMC_Bank1_NORSRAM1) || \ + ((BANK) == FSMC_Bank1_NORSRAM2) || \ + ((BANK) == FSMC_Bank1_NORSRAM3) || \ + ((BANK) == FSMC_Bank1_NORSRAM4)) + +#define IS_FSMC_NAND_BANK(BANK) (((BANK) == FSMC_Bank2_NAND) || \ + ((BANK) == FSMC_Bank3_NAND)) + +#define IS_FSMC_GETFLAG_BANK(BANK) (((BANK) == FSMC_Bank2_NAND) || \ + ((BANK) == FSMC_Bank3_NAND) || \ + ((BANK) == FSMC_Bank4_PCCARD)) + +#define IS_FSMC_IT_BANK(BANK) (((BANK) == FSMC_Bank2_NAND) || \ + ((BANK) == FSMC_Bank3_NAND) || \ + ((BANK) == FSMC_Bank4_PCCARD)) + +/** @defgroup FSMC_NOR_SRAM_Controller + * @{ + */ + +/** @defgroup FSMC_Data_Address_Bus_Multiplexing + * @{ + */ + +#define FSMC_DataAddressMux_Disable ((uint32_t)0x00000000) +#define FSMC_DataAddressMux_Enable ((uint32_t)0x00000002) +#define IS_FSMC_MUX(MUX) (((MUX) == FSMC_DataAddressMux_Disable) || \ + ((MUX) == FSMC_DataAddressMux_Enable)) +/** + * @} + */ + +/** @defgroup FSMC_Memory_Type + * @{ + */ + +#define FSMC_MemoryType_SRAM ((uint32_t)0x00000000) +#define FSMC_MemoryType_PSRAM ((uint32_t)0x00000004) +#define FSMC_MemoryType_NOR ((uint32_t)0x00000008) +#define IS_FSMC_MEMORY(MEMORY) (((MEMORY) == FSMC_MemoryType_SRAM) || \ + ((MEMORY) == FSMC_MemoryType_PSRAM)|| \ + ((MEMORY) == FSMC_MemoryType_NOR)) +/** + * @} + */ + +/** @defgroup FSMC_Data_Width + * @{ + */ + +#define FSMC_MemoryDataWidth_8b ((uint32_t)0x00000000) +#define FSMC_MemoryDataWidth_16b ((uint32_t)0x00000010) +#define IS_FSMC_MEMORY_WIDTH(WIDTH) (((WIDTH) == FSMC_MemoryDataWidth_8b) || \ + ((WIDTH) == FSMC_MemoryDataWidth_16b)) +/** + * @} + */ + +/** @defgroup FSMC_Burst_Access_Mode + * @{ + */ + +#define FSMC_BurstAccessMode_Disable ((uint32_t)0x00000000) +#define FSMC_BurstAccessMode_Enable ((uint32_t)0x00000100) +#define IS_FSMC_BURSTMODE(STATE) (((STATE) == FSMC_BurstAccessMode_Disable) || \ + ((STATE) == FSMC_BurstAccessMode_Enable)) +/** + * @} + */ + +/** @defgroup FSMC_AsynchronousWait + * @{ + */ +#define FSMC_AsynchronousWait_Disable ((uint32_t)0x00000000) +#define FSMC_AsynchronousWait_Enable ((uint32_t)0x00008000) +#define IS_FSMC_ASYNWAIT(STATE) (((STATE) == FSMC_AsynchronousWait_Disable) || \ + ((STATE) == FSMC_AsynchronousWait_Enable)) +/** + * @} + */ + +/** @defgroup FSMC_Wait_Signal_Polarity + * @{ + */ +#define FSMC_WaitSignalPolarity_Low ((uint32_t)0x00000000) +#define FSMC_WaitSignalPolarity_High ((uint32_t)0x00000200) +#define IS_FSMC_WAIT_POLARITY(POLARITY) (((POLARITY) == FSMC_WaitSignalPolarity_Low) || \ + ((POLARITY) == FSMC_WaitSignalPolarity_High)) +/** + * @} + */ + +/** @defgroup FSMC_Wrap_Mode + * @{ + */ +#define FSMC_WrapMode_Disable ((uint32_t)0x00000000) +#define FSMC_WrapMode_Enable ((uint32_t)0x00000400) +#define IS_FSMC_WRAP_MODE(MODE) (((MODE) == FSMC_WrapMode_Disable) || \ + ((MODE) == FSMC_WrapMode_Enable)) +/** + * @} + */ + +/** @defgroup FSMC_Wait_Timing + * @{ + */ +#define FSMC_WaitSignalActive_BeforeWaitState ((uint32_t)0x00000000) +#define FSMC_WaitSignalActive_DuringWaitState ((uint32_t)0x00000800) +#define IS_FSMC_WAIT_SIGNAL_ACTIVE(ACTIVE) (((ACTIVE) == FSMC_WaitSignalActive_BeforeWaitState) || \ + ((ACTIVE) == FSMC_WaitSignalActive_DuringWaitState)) +/** + * @} + */ + +/** @defgroup FSMC_Write_Operation + * @{ + */ +#define FSMC_WriteOperation_Disable ((uint32_t)0x00000000) +#define FSMC_WriteOperation_Enable ((uint32_t)0x00001000) +#define IS_FSMC_WRITE_OPERATION(OPERATION) (((OPERATION) == FSMC_WriteOperation_Disable) || \ + ((OPERATION) == FSMC_WriteOperation_Enable)) +/** + * @} + */ + +/** @defgroup FSMC_Wait_Signal + * @{ + */ +#define FSMC_WaitSignal_Disable ((uint32_t)0x00000000) +#define FSMC_WaitSignal_Enable ((uint32_t)0x00002000) +#define IS_FSMC_WAITE_SIGNAL(SIGNAL) (((SIGNAL) == FSMC_WaitSignal_Disable) || \ + ((SIGNAL) == FSMC_WaitSignal_Enable)) +/** + * @} + */ + +/** @defgroup FSMC_Extended_Mode + * @{ + */ +#define FSMC_ExtendedMode_Disable ((uint32_t)0x00000000) +#define FSMC_ExtendedMode_Enable ((uint32_t)0x00004000) + +#define IS_FSMC_EXTENDED_MODE(MODE) (((MODE) == FSMC_ExtendedMode_Disable) || \ + ((MODE) == FSMC_ExtendedMode_Enable)) +/** + * @} + */ + +/** @defgroup FSMC_Write_Burst + * @{ + */ + +#define FSMC_WriteBurst_Disable ((uint32_t)0x00000000) +#define FSMC_WriteBurst_Enable ((uint32_t)0x00080000) +#define IS_FSMC_WRITE_BURST(BURST) (((BURST) == FSMC_WriteBurst_Disable) || \ + ((BURST) == FSMC_WriteBurst_Enable)) +/** + * @} + */ + +/** @defgroup FSMC_Address_Setup_Time + * @{ + */ +#define IS_FSMC_ADDRESS_SETUP_TIME(TIME) ((TIME) <= 0xF) +/** + * @} + */ + +/** @defgroup FSMC_Address_Hold_Time + * @{ + */ +#define IS_FSMC_ADDRESS_HOLD_TIME(TIME) ((TIME) <= 0xF) +/** + * @} + */ + +/** @defgroup FSMC_Data_Setup_Time + * @{ + */ +#define IS_FSMC_DATASETUP_TIME(TIME) (((TIME) > 0) && ((TIME) <= 0xFF)) +/** + * @} + */ + +/** @defgroup FSMC_Bus_Turn_around_Duration + * @{ + */ +#define IS_FSMC_TURNAROUND_TIME(TIME) ((TIME) <= 0xF) +/** + * @} + */ + +/** @defgroup FSMC_CLK_Division + * @{ + */ +#define IS_FSMC_CLK_DIV(DIV) ((DIV) <= 0xF) +/** + * @} + */ + +/** @defgroup FSMC_Data_Latency + * @{ + */ +#define IS_FSMC_DATA_LATENCY(LATENCY) ((LATENCY) <= 0xF) +/** + * @} + */ + +/** @defgroup FSMC_Access_Mode + * @{ + */ +#define FSMC_AccessMode_A ((uint32_t)0x00000000) +#define FSMC_AccessMode_B ((uint32_t)0x10000000) +#define FSMC_AccessMode_C ((uint32_t)0x20000000) +#define FSMC_AccessMode_D ((uint32_t)0x30000000) +#define IS_FSMC_ACCESS_MODE(MODE) (((MODE) == FSMC_AccessMode_A) || \ + ((MODE) == FSMC_AccessMode_B) || \ + ((MODE) == FSMC_AccessMode_C) || \ + ((MODE) == FSMC_AccessMode_D)) +/** + * @} + */ + +/** + * @} + */ + +/** @defgroup FSMC_NAND_PCCARD_Controller + * @{ + */ + +/** @defgroup FSMC_Wait_feature + * @{ + */ +#define FSMC_Waitfeature_Disable ((uint32_t)0x00000000) +#define FSMC_Waitfeature_Enable ((uint32_t)0x00000002) +#define IS_FSMC_WAIT_FEATURE(FEATURE) (((FEATURE) == FSMC_Waitfeature_Disable) || \ + ((FEATURE) == FSMC_Waitfeature_Enable)) +/** + * @} + */ + + +/** @defgroup FSMC_ECC + * @{ + */ +#define FSMC_ECC_Disable ((uint32_t)0x00000000) +#define FSMC_ECC_Enable ((uint32_t)0x00000040) +#define IS_FSMC_ECC_STATE(STATE) (((STATE) == FSMC_ECC_Disable) || \ + ((STATE) == FSMC_ECC_Enable)) +/** + * @} + */ + +/** @defgroup FSMC_ECC_Page_Size + * @{ + */ +#define FSMC_ECCPageSize_256Bytes ((uint32_t)0x00000000) +#define FSMC_ECCPageSize_512Bytes ((uint32_t)0x00020000) +#define FSMC_ECCPageSize_1024Bytes ((uint32_t)0x00040000) +#define FSMC_ECCPageSize_2048Bytes ((uint32_t)0x00060000) +#define FSMC_ECCPageSize_4096Bytes ((uint32_t)0x00080000) +#define FSMC_ECCPageSize_8192Bytes ((uint32_t)0x000A0000) +#define IS_FSMC_ECCPAGE_SIZE(SIZE) (((SIZE) == FSMC_ECCPageSize_256Bytes) || \ + ((SIZE) == FSMC_ECCPageSize_512Bytes) || \ + ((SIZE) == FSMC_ECCPageSize_1024Bytes) || \ + ((SIZE) == FSMC_ECCPageSize_2048Bytes) || \ + ((SIZE) == FSMC_ECCPageSize_4096Bytes) || \ + ((SIZE) == FSMC_ECCPageSize_8192Bytes)) +/** + * @} + */ + +/** @defgroup FSMC_TCLR_Setup_Time + * @{ + */ +#define IS_FSMC_TCLR_TIME(TIME) ((TIME) <= 0xFF) +/** + * @} + */ + +/** @defgroup FSMC_TAR_Setup_Time + * @{ + */ +#define IS_FSMC_TAR_TIME(TIME) ((TIME) <= 0xFF) +/** + * @} + */ + +/** @defgroup FSMC_Setup_Time + * @{ + */ +#define IS_FSMC_SETUP_TIME(TIME) ((TIME) <= 0xFF) +/** + * @} + */ + +/** @defgroup FSMC_Wait_Setup_Time + * @{ + */ +#define IS_FSMC_WAIT_TIME(TIME) ((TIME) <= 0xFF) +/** + * @} + */ + +/** @defgroup FSMC_Hold_Setup_Time + * @{ + */ +#define IS_FSMC_HOLD_TIME(TIME) ((TIME) <= 0xFF) +/** + * @} + */ + +/** @defgroup FSMC_HiZ_Setup_Time + * @{ + */ +#define IS_FSMC_HIZ_TIME(TIME) ((TIME) <= 0xFF) +/** + * @} + */ + +/** @defgroup FSMC_Interrupt_sources + * @{ + */ +#define FSMC_IT_RisingEdge ((uint32_t)0x00000008) +#define FSMC_IT_Level ((uint32_t)0x00000010) +#define FSMC_IT_FallingEdge ((uint32_t)0x00000020) +#define IS_FSMC_IT(IT) ((((IT) & (uint32_t)0xFFFFFFC7) == 0x00000000) && ((IT) != 0x00000000)) +#define IS_FSMC_GET_IT(IT) (((IT) == FSMC_IT_RisingEdge) || \ + ((IT) == FSMC_IT_Level) || \ + ((IT) == FSMC_IT_FallingEdge)) +/** + * @} + */ + +/** @defgroup FSMC_Flags + * @{ + */ +#define FSMC_FLAG_RisingEdge ((uint32_t)0x00000001) +#define FSMC_FLAG_Level ((uint32_t)0x00000002) +#define FSMC_FLAG_FallingEdge ((uint32_t)0x00000004) +#define FSMC_FLAG_FEMPT ((uint32_t)0x00000040) +#define IS_FSMC_GET_FLAG(FLAG) (((FLAG) == FSMC_FLAG_RisingEdge) || \ + ((FLAG) == FSMC_FLAG_Level) || \ + ((FLAG) == FSMC_FLAG_FallingEdge) || \ + ((FLAG) == FSMC_FLAG_FEMPT)) + +#define IS_FSMC_CLEAR_FLAG(FLAG) ((((FLAG) & (uint32_t)0xFFFFFFF8) == 0x00000000) && ((FLAG) != 0x00000000)) +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/* Exported macro ------------------------------------------------------------*/ +/* Exported functions --------------------------------------------------------*/ + +/* NOR/SRAM Controller functions **********************************************/ +void FSMC_NORSRAMDeInit(uint32_t FSMC_Bank); +void FSMC_NORSRAMInit(FSMC_NORSRAMInitTypeDef* FSMC_NORSRAMInitStruct); +void FSMC_NORSRAMStructInit(FSMC_NORSRAMInitTypeDef* FSMC_NORSRAMInitStruct); +void FSMC_NORSRAMCmd(uint32_t FSMC_Bank, FunctionalState NewState); + +/* NAND Controller functions **************************************************/ +void FSMC_NANDDeInit(uint32_t FSMC_Bank); +void FSMC_NANDInit(FSMC_NANDInitTypeDef* FSMC_NANDInitStruct); +void FSMC_NANDStructInit(FSMC_NANDInitTypeDef* FSMC_NANDInitStruct); +void FSMC_NANDCmd(uint32_t FSMC_Bank, FunctionalState NewState); +void FSMC_NANDECCCmd(uint32_t FSMC_Bank, FunctionalState NewState); +uint32_t FSMC_GetECC(uint32_t FSMC_Bank); + +/* PCCARD Controller functions ************************************************/ +void FSMC_PCCARDDeInit(void); +void FSMC_PCCARDInit(FSMC_PCCARDInitTypeDef* FSMC_PCCARDInitStruct); +void FSMC_PCCARDStructInit(FSMC_PCCARDInitTypeDef* FSMC_PCCARDInitStruct); +void FSMC_PCCARDCmd(FunctionalState NewState); + +/* Interrupts and flags management functions **********************************/ +void FSMC_ITConfig(uint32_t FSMC_Bank, uint32_t FSMC_IT, FunctionalState NewState); +FlagStatus FSMC_GetFlagStatus(uint32_t FSMC_Bank, uint32_t FSMC_FLAG); +void FSMC_ClearFlag(uint32_t FSMC_Bank, uint32_t FSMC_FLAG); +ITStatus FSMC_GetITStatus(uint32_t FSMC_Bank, uint32_t FSMC_IT); +void FSMC_ClearITPendingBit(uint32_t FSMC_Bank, uint32_t FSMC_IT); + +#ifdef __cplusplus +} +#endif + +#endif /*__STM32F4xx_FSMC_H */ +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/inc/stm32f4xx_gpio.h b/FWLIB/inc/stm32f4xx_gpio.h new file mode 100644 index 0000000..e41bf4e --- /dev/null +++ b/FWLIB/inc/stm32f4xx_gpio.h @@ -0,0 +1,502 @@ +/** + ****************************************************************************** + * @file stm32f4xx_gpio.h + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file contains all the functions prototypes for the GPIO firmware + * library. + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Define to prevent recursive inclusion -------------------------------------*/ +#ifndef __STM32F4xx_GPIO_H +#define __STM32F4xx_GPIO_H + +#ifdef __cplusplus + extern "C" { +#endif + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @addtogroup GPIO + * @{ + */ + +/* Exported types ------------------------------------------------------------*/ + +#define IS_GPIO_ALL_PERIPH(PERIPH) (((PERIPH) == GPIOA) || \ + ((PERIPH) == GPIOB) || \ + ((PERIPH) == GPIOC) || \ + ((PERIPH) == GPIOD) || \ + ((PERIPH) == GPIOE) || \ + ((PERIPH) == GPIOF) || \ + ((PERIPH) == GPIOG) || \ + ((PERIPH) == GPIOH) || \ + ((PERIPH) == GPIOI) || \ + ((PERIPH) == GPIOJ) || \ + ((PERIPH) == GPIOK)) + +/** + * @brief GPIO Configuration Mode enumeration + */ +typedef enum +{ + GPIO_Mode_IN = 0x00, /*!< GPIO Input Mode */ + GPIO_Mode_OUT = 0x01, /*!< GPIO Output Mode */ + GPIO_Mode_AF = 0x02, /*!< GPIO Alternate function Mode */ + GPIO_Mode_AN = 0x03 /*!< GPIO Analog Mode */ +}GPIOMode_TypeDef; +#define IS_GPIO_MODE(MODE) (((MODE) == GPIO_Mode_IN) || ((MODE) == GPIO_Mode_OUT) || \ + ((MODE) == GPIO_Mode_AF)|| ((MODE) == GPIO_Mode_AN)) + +/** + * @brief GPIO Output type enumeration + */ +typedef enum +{ + GPIO_OType_PP = 0x00, + GPIO_OType_OD = 0x01 +}GPIOOType_TypeDef; +#define IS_GPIO_OTYPE(OTYPE) (((OTYPE) == GPIO_OType_PP) || ((OTYPE) == GPIO_OType_OD)) + + +/** + * @brief GPIO Output Maximum frequency enumeration + */ +typedef enum +{ + GPIO_Low_Speed = 0x00, /*!< Low speed */ + GPIO_Medium_Speed = 0x01, /*!< Medium speed */ + GPIO_Fast_Speed = 0x02, /*!< Fast speed */ + GPIO_High_Speed = 0x03 /*!< High speed */ +}GPIOSpeed_TypeDef; + +/* Add legacy definition */ +#define GPIO_Speed_2MHz GPIO_Low_Speed +#define GPIO_Speed_25MHz GPIO_Medium_Speed +#define GPIO_Speed_50MHz GPIO_Fast_Speed +#define GPIO_Speed_100MHz GPIO_High_Speed + +#define IS_GPIO_SPEED(SPEED) (((SPEED) == GPIO_Low_Speed) || ((SPEED) == GPIO_Medium_Speed) || \ + ((SPEED) == GPIO_Fast_Speed)|| ((SPEED) == GPIO_High_Speed)) + +/** + * @brief GPIO Configuration PullUp PullDown enumeration + */ +typedef enum +{ + GPIO_PuPd_NOPULL = 0x00, + GPIO_PuPd_UP = 0x01, + GPIO_PuPd_DOWN = 0x02 +}GPIOPuPd_TypeDef; +#define IS_GPIO_PUPD(PUPD) (((PUPD) == GPIO_PuPd_NOPULL) || ((PUPD) == GPIO_PuPd_UP) || \ + ((PUPD) == GPIO_PuPd_DOWN)) + +/** + * @brief GPIO Bit SET and Bit RESET enumeration + */ +typedef enum +{ + Bit_RESET = 0, + Bit_SET +}BitAction; +#define IS_GPIO_BIT_ACTION(ACTION) (((ACTION) == Bit_RESET) || ((ACTION) == Bit_SET)) + + +/** + * @brief GPIO Init structure definition + */ +typedef struct +{ + uint32_t GPIO_Pin; /*!< Specifies the GPIO pins to be configured. + This parameter can be any value of @ref GPIO_pins_define */ + + GPIOMode_TypeDef GPIO_Mode; /*!< Specifies the operating mode for the selected pins. + This parameter can be a value of @ref GPIOMode_TypeDef */ + + GPIOSpeed_TypeDef GPIO_Speed; /*!< Specifies the speed for the selected pins. + This parameter can be a value of @ref GPIOSpeed_TypeDef */ + + GPIOOType_TypeDef GPIO_OType; /*!< Specifies the operating output type for the selected pins. + This parameter can be a value of @ref GPIOOType_TypeDef */ + + GPIOPuPd_TypeDef GPIO_PuPd; /*!< Specifies the operating Pull-up/Pull down for the selected pins. + This parameter can be a value of @ref GPIOPuPd_TypeDef */ +}GPIO_InitTypeDef; + +/* Exported constants --------------------------------------------------------*/ + +/** @defgroup GPIO_Exported_Constants + * @{ + */ + +/** @defgroup GPIO_pins_define + * @{ + */ +#define GPIO_Pin_0 ((uint16_t)0x0001) /* Pin 0 selected */ +#define GPIO_Pin_1 ((uint16_t)0x0002) /* Pin 1 selected */ +#define GPIO_Pin_2 ((uint16_t)0x0004) /* Pin 2 selected */ +#define GPIO_Pin_3 ((uint16_t)0x0008) /* Pin 3 selected */ +#define GPIO_Pin_4 ((uint16_t)0x0010) /* Pin 4 selected */ +#define GPIO_Pin_5 ((uint16_t)0x0020) /* Pin 5 selected */ +#define GPIO_Pin_6 ((uint16_t)0x0040) /* Pin 6 selected */ +#define GPIO_Pin_7 ((uint16_t)0x0080) /* Pin 7 selected */ +#define GPIO_Pin_8 ((uint16_t)0x0100) /* Pin 8 selected */ +#define GPIO_Pin_9 ((uint16_t)0x0200) /* Pin 9 selected */ +#define GPIO_Pin_10 ((uint16_t)0x0400) /* Pin 10 selected */ +#define GPIO_Pin_11 ((uint16_t)0x0800) /* Pin 11 selected */ +#define GPIO_Pin_12 ((uint16_t)0x1000) /* Pin 12 selected */ +#define GPIO_Pin_13 ((uint16_t)0x2000) /* Pin 13 selected */ +#define GPIO_Pin_14 ((uint16_t)0x4000) /* Pin 14 selected */ +#define GPIO_Pin_15 ((uint16_t)0x8000) /* Pin 15 selected */ +#define GPIO_Pin_All ((uint16_t)0xFFFF) /* All pins selected */ + +#define GPIO_PIN_MASK ((uint32_t)0x0000FFFF) /* PIN mask for assert test */ +#define IS_GPIO_PIN(PIN) (((PIN) & GPIO_PIN_MASK ) != (uint32_t)0x00) +#define IS_GET_GPIO_PIN(PIN) (((PIN) == GPIO_Pin_0) || \ + ((PIN) == GPIO_Pin_1) || \ + ((PIN) == GPIO_Pin_2) || \ + ((PIN) == GPIO_Pin_3) || \ + ((PIN) == GPIO_Pin_4) || \ + ((PIN) == GPIO_Pin_5) || \ + ((PIN) == GPIO_Pin_6) || \ + ((PIN) == GPIO_Pin_7) || \ + ((PIN) == GPIO_Pin_8) || \ + ((PIN) == GPIO_Pin_9) || \ + ((PIN) == GPIO_Pin_10) || \ + ((PIN) == GPIO_Pin_11) || \ + ((PIN) == GPIO_Pin_12) || \ + ((PIN) == GPIO_Pin_13) || \ + ((PIN) == GPIO_Pin_14) || \ + ((PIN) == GPIO_Pin_15)) +/** + * @} + */ + + +/** @defgroup GPIO_Pin_sources + * @{ + */ +#define GPIO_PinSource0 ((uint8_t)0x00) +#define GPIO_PinSource1 ((uint8_t)0x01) +#define GPIO_PinSource2 ((uint8_t)0x02) +#define GPIO_PinSource3 ((uint8_t)0x03) +#define GPIO_PinSource4 ((uint8_t)0x04) +#define GPIO_PinSource5 ((uint8_t)0x05) +#define GPIO_PinSource6 ((uint8_t)0x06) +#define GPIO_PinSource7 ((uint8_t)0x07) +#define GPIO_PinSource8 ((uint8_t)0x08) +#define GPIO_PinSource9 ((uint8_t)0x09) +#define GPIO_PinSource10 ((uint8_t)0x0A) +#define GPIO_PinSource11 ((uint8_t)0x0B) +#define GPIO_PinSource12 ((uint8_t)0x0C) +#define GPIO_PinSource13 ((uint8_t)0x0D) +#define GPIO_PinSource14 ((uint8_t)0x0E) +#define GPIO_PinSource15 ((uint8_t)0x0F) + +#define IS_GPIO_PIN_SOURCE(PINSOURCE) (((PINSOURCE) == GPIO_PinSource0) || \ + ((PINSOURCE) == GPIO_PinSource1) || \ + ((PINSOURCE) == GPIO_PinSource2) || \ + ((PINSOURCE) == GPIO_PinSource3) || \ + ((PINSOURCE) == GPIO_PinSource4) || \ + ((PINSOURCE) == GPIO_PinSource5) || \ + ((PINSOURCE) == GPIO_PinSource6) || \ + ((PINSOURCE) == GPIO_PinSource7) || \ + ((PINSOURCE) == GPIO_PinSource8) || \ + ((PINSOURCE) == GPIO_PinSource9) || \ + ((PINSOURCE) == GPIO_PinSource10) || \ + ((PINSOURCE) == GPIO_PinSource11) || \ + ((PINSOURCE) == GPIO_PinSource12) || \ + ((PINSOURCE) == GPIO_PinSource13) || \ + ((PINSOURCE) == GPIO_PinSource14) || \ + ((PINSOURCE) == GPIO_PinSource15)) +/** + * @} + */ + +/** @defgroup GPIO_Alternat_function_selection_define + * @{ + */ +/** + * @brief AF 0 selection + */ +#define GPIO_AF_RTC_50Hz ((uint8_t)0x00) /* RTC_50Hz Alternate Function mapping */ +#define GPIO_AF_MCO ((uint8_t)0x00) /* MCO (MCO1 and MCO2) Alternate Function mapping */ +#define GPIO_AF_TAMPER ((uint8_t)0x00) /* TAMPER (TAMPER_1 and TAMPER_2) Alternate Function mapping */ +#define GPIO_AF_SWJ ((uint8_t)0x00) /* SWJ (SWD and JTAG) Alternate Function mapping */ +#define GPIO_AF_TRACE ((uint8_t)0x00) /* TRACE Alternate Function mapping */ + +/** + * @brief AF 1 selection + */ +#define GPIO_AF_TIM1 ((uint8_t)0x01) /* TIM1 Alternate Function mapping */ +#define GPIO_AF_TIM2 ((uint8_t)0x01) /* TIM2 Alternate Function mapping */ + +/** + * @brief AF 2 selection + */ +#define GPIO_AF_TIM3 ((uint8_t)0x02) /* TIM3 Alternate Function mapping */ +#define GPIO_AF_TIM4 ((uint8_t)0x02) /* TIM4 Alternate Function mapping */ +#define GPIO_AF_TIM5 ((uint8_t)0x02) /* TIM5 Alternate Function mapping */ + +/** + * @brief AF 3 selection + */ +#define GPIO_AF_TIM8 ((uint8_t)0x03) /* TIM8 Alternate Function mapping */ +#define GPIO_AF_TIM9 ((uint8_t)0x03) /* TIM9 Alternate Function mapping */ +#define GPIO_AF_TIM10 ((uint8_t)0x03) /* TIM10 Alternate Function mapping */ +#define GPIO_AF_TIM11 ((uint8_t)0x03) /* TIM11 Alternate Function mapping */ + +/** + * @brief AF 4 selection + */ +#define GPIO_AF_I2C1 ((uint8_t)0x04) /* I2C1 Alternate Function mapping */ +#define GPIO_AF_I2C2 ((uint8_t)0x04) /* I2C2 Alternate Function mapping */ +#define GPIO_AF_I2C3 ((uint8_t)0x04) /* I2C3 Alternate Function mapping */ + +/** + * @brief AF 5 selection + */ +#define GPIO_AF_SPI1 ((uint8_t)0x05) /* SPI1/I2S1 Alternate Function mapping */ +#define GPIO_AF_SPI2 ((uint8_t)0x05) /* SPI2/I2S2 Alternate Function mapping */ +#define GPIO_AF5_SPI3 ((uint8_t)0x05) /* SPI3/I2S3 Alternate Function mapping (Only for STM32F411xE Devices) */ +#define GPIO_AF_SPI4 ((uint8_t)0x05) /* SPI4/I2S4 Alternate Function mapping */ +#define GPIO_AF_SPI5 ((uint8_t)0x05) /* SPI5 Alternate Function mapping */ +#define GPIO_AF_SPI6 ((uint8_t)0x05) /* SPI6 Alternate Function mapping */ + +/** + * @brief AF 6 selection + */ +#define GPIO_AF_SPI3 ((uint8_t)0x06) /* SPI3/I2S3 Alternate Function mapping */ +#define GPIO_AF6_SPI2 ((uint8_t)0x06) /* SPI2 Alternate Function mapping (Only for STM32F411xE Devices) */ +#define GPIO_AF6_SPI4 ((uint8_t)0x06) /* SPI4 Alternate Function mapping (Only for STM32F411xE Devices) */ +#define GPIO_AF6_SPI5 ((uint8_t)0x06) /* SPI5 Alternate Function mapping (Only for STM32F411xE Devices) */ +#define GPIO_AF_SAI1 ((uint8_t)0x06) /* SAI1 Alternate Function mapping */ + +/** + * @brief AF 7 selection + */ +#define GPIO_AF_USART1 ((uint8_t)0x07) /* USART1 Alternate Function mapping */ +#define GPIO_AF_USART2 ((uint8_t)0x07) /* USART2 Alternate Function mapping */ +#define GPIO_AF_USART3 ((uint8_t)0x07) /* USART3 Alternate Function mapping */ +#define GPIO_AF7_SPI3 ((uint8_t)0x07) /* SPI3/I2S3ext Alternate Function mapping */ + +/** + * @brief AF 7 selection Legacy + */ +#define GPIO_AF_I2S3ext GPIO_AF7_SPI3 + +/** + * @brief AF 8 selection + */ +#define GPIO_AF_UART4 ((uint8_t)0x08) /* UART4 Alternate Function mapping */ +#define GPIO_AF_UART5 ((uint8_t)0x08) /* UART5 Alternate Function mapping */ +#define GPIO_AF_USART6 ((uint8_t)0x08) /* USART6 Alternate Function mapping */ +#define GPIO_AF_UART7 ((uint8_t)0x08) /* UART7 Alternate Function mapping */ +#define GPIO_AF_UART8 ((uint8_t)0x08) /* UART8 Alternate Function mapping */ + +/** + * @brief AF 9 selection + */ +#define GPIO_AF_CAN1 ((uint8_t)0x09) /* CAN1 Alternate Function mapping */ +#define GPIO_AF_CAN2 ((uint8_t)0x09) /* CAN2 Alternate Function mapping */ +#define GPIO_AF_TIM12 ((uint8_t)0x09) /* TIM12 Alternate Function mapping */ +#define GPIO_AF_TIM13 ((uint8_t)0x09) /* TIM13 Alternate Function mapping */ +#define GPIO_AF_TIM14 ((uint8_t)0x09) /* TIM14 Alternate Function mapping */ + +#define GPIO_AF9_I2C2 ((uint8_t)0x09) /* I2C2 Alternate Function mapping (Only for STM32F401xx/STM32F411xE Devices) */ +#define GPIO_AF9_I2C3 ((uint8_t)0x09) /* I2C3 Alternate Function mapping (Only for STM32F401xx/STM32F411xE Devices) */ + +/** + * @brief AF 10 selection + */ +#define GPIO_AF_OTG_FS ((uint8_t)0xA) /* OTG_FS Alternate Function mapping */ +#define GPIO_AF_OTG_HS ((uint8_t)0xA) /* OTG_HS Alternate Function mapping */ + +/** + * @brief AF 11 selection + */ +#define GPIO_AF_ETH ((uint8_t)0x0B) /* ETHERNET Alternate Function mapping */ + +/** + * @brief AF 12 selection + */ +#if defined (STM32F40_41xxx) +#define GPIO_AF_FSMC ((uint8_t)0xC) /* FSMC Alternate Function mapping */ +#endif /* STM32F40_41xxx */ + +#if defined (STM32F427_437xx) || defined (STM32F429_439xx) +#define GPIO_AF_FMC ((uint8_t)0xC) /* FMC Alternate Function mapping */ +#endif /* STM32F427_437xx || STM32F429_439xx */ + +#define GPIO_AF_OTG_HS_FS ((uint8_t)0xC) /* OTG HS configured in FS, Alternate Function mapping */ +#define GPIO_AF_SDIO ((uint8_t)0xC) /* SDIO Alternate Function mapping */ + +/** + * @brief AF 13 selection + */ +#define GPIO_AF_DCMI ((uint8_t)0x0D) /* DCMI Alternate Function mapping */ + +/** + * @brief AF 14 selection + */ + +#define GPIO_AF_LTDC ((uint8_t)0x0E) /* LCD-TFT Alternate Function mapping */ + +/** + * @brief AF 15 selection + */ +#define GPIO_AF_EVENTOUT ((uint8_t)0x0F) /* EVENTOUT Alternate Function mapping */ + +#if defined (STM32F40_41xxx) +#define IS_GPIO_AF(AF) (((AF) == GPIO_AF_RTC_50Hz) || ((AF) == GPIO_AF_TIM14) || \ + ((AF) == GPIO_AF_MCO) || ((AF) == GPIO_AF_TAMPER) || \ + ((AF) == GPIO_AF_SWJ) || ((AF) == GPIO_AF_TRACE) || \ + ((AF) == GPIO_AF_TIM1) || ((AF) == GPIO_AF_TIM2) || \ + ((AF) == GPIO_AF_TIM3) || ((AF) == GPIO_AF_TIM4) || \ + ((AF) == GPIO_AF_TIM5) || ((AF) == GPIO_AF_TIM8) || \ + ((AF) == GPIO_AF_I2C1) || ((AF) == GPIO_AF_I2C2) || \ + ((AF) == GPIO_AF_I2C3) || ((AF) == GPIO_AF_SPI1) || \ + ((AF) == GPIO_AF_SPI2) || ((AF) == GPIO_AF_TIM13) || \ + ((AF) == GPIO_AF_SPI3) || ((AF) == GPIO_AF_TIM14) || \ + ((AF) == GPIO_AF_USART1) || ((AF) == GPIO_AF_USART2) || \ + ((AF) == GPIO_AF_USART3) || ((AF) == GPIO_AF_UART4) || \ + ((AF) == GPIO_AF_UART5) || ((AF) == GPIO_AF_USART6) || \ + ((AF) == GPIO_AF_CAN1) || ((AF) == GPIO_AF_CAN2) || \ + ((AF) == GPIO_AF_OTG_FS) || ((AF) == GPIO_AF_OTG_HS) || \ + ((AF) == GPIO_AF_ETH) || ((AF) == GPIO_AF_OTG_HS_FS) || \ + ((AF) == GPIO_AF_SDIO) || ((AF) == GPIO_AF_DCMI) || \ + ((AF) == GPIO_AF_EVENTOUT) || ((AF) == GPIO_AF_FSMC)) +#endif /* STM32F40_41xxx */ + +#if defined (STM32F401xx) +#define IS_GPIO_AF(AF) (((AF) == GPIO_AF_RTC_50Hz) || ((AF) == GPIO_AF_TIM14) || \ + ((AF) == GPIO_AF_MCO) || ((AF) == GPIO_AF_TAMPER) || \ + ((AF) == GPIO_AF_SWJ) || ((AF) == GPIO_AF_TRACE) || \ + ((AF) == GPIO_AF_TIM1) || ((AF) == GPIO_AF_TIM2) || \ + ((AF) == GPIO_AF_TIM3) || ((AF) == GPIO_AF_TIM4) || \ + ((AF) == GPIO_AF_TIM5) || ((AF) == GPIO_AF_TIM8) || \ + ((AF) == GPIO_AF_I2C1) || ((AF) == GPIO_AF_I2C2) || \ + ((AF) == GPIO_AF_I2C3) || ((AF) == GPIO_AF_SPI1) || \ + ((AF) == GPIO_AF_SPI2) || ((AF) == GPIO_AF_TIM13) || \ + ((AF) == GPIO_AF_SPI3) || ((AF) == GPIO_AF_TIM14) || \ + ((AF) == GPIO_AF_USART1) || ((AF) == GPIO_AF_USART2) || \ + ((AF) == GPIO_AF_SDIO) || ((AF) == GPIO_AF_USART6) || \ + ((AF) == GPIO_AF_OTG_FS) || ((AF) == GPIO_AF_OTG_HS) || \ + ((AF) == GPIO_AF_EVENTOUT) || ((AF) == GPIO_AF_SPI4)) +#endif /* STM32F401xx */ + +#if defined (STM32F411xE) +#define IS_GPIO_AF(AF) (((AF) < 16) && ((AF) != 11) && ((AF) != 13) && ((AF) != 14)) +#endif /* STM32F411xE */ + +#if defined (STM32F427_437xx) || defined (STM32F429_439xx) +#define IS_GPIO_AF(AF) (((AF) == GPIO_AF_RTC_50Hz) || ((AF) == GPIO_AF_TIM14) || \ + ((AF) == GPIO_AF_MCO) || ((AF) == GPIO_AF_TAMPER) || \ + ((AF) == GPIO_AF_SWJ) || ((AF) == GPIO_AF_TRACE) || \ + ((AF) == GPIO_AF_TIM1) || ((AF) == GPIO_AF_TIM2) || \ + ((AF) == GPIO_AF_TIM3) || ((AF) == GPIO_AF_TIM4) || \ + ((AF) == GPIO_AF_TIM5) || ((AF) == GPIO_AF_TIM8) || \ + ((AF) == GPIO_AF_I2C1) || ((AF) == GPIO_AF_I2C2) || \ + ((AF) == GPIO_AF_I2C3) || ((AF) == GPIO_AF_SPI1) || \ + ((AF) == GPIO_AF_SPI2) || ((AF) == GPIO_AF_TIM13) || \ + ((AF) == GPIO_AF_SPI3) || ((AF) == GPIO_AF_TIM14) || \ + ((AF) == GPIO_AF_USART1) || ((AF) == GPIO_AF_USART2) || \ + ((AF) == GPIO_AF_USART3) || ((AF) == GPIO_AF_UART4) || \ + ((AF) == GPIO_AF_UART5) || ((AF) == GPIO_AF_USART6) || \ + ((AF) == GPIO_AF_CAN1) || ((AF) == GPIO_AF_CAN2) || \ + ((AF) == GPIO_AF_OTG_FS) || ((AF) == GPIO_AF_OTG_HS) || \ + ((AF) == GPIO_AF_ETH) || ((AF) == GPIO_AF_OTG_HS_FS) || \ + ((AF) == GPIO_AF_SDIO) || ((AF) == GPIO_AF_DCMI) || \ + ((AF) == GPIO_AF_EVENTOUT) || ((AF) == GPIO_AF_SPI4) || \ + ((AF) == GPIO_AF_SPI5) || ((AF) == GPIO_AF_SPI6) || \ + ((AF) == GPIO_AF_UART7) || ((AF) == GPIO_AF_UART8) || \ + ((AF) == GPIO_AF_FMC) || ((AF) == GPIO_AF_SAI1) || \ + ((AF) == GPIO_AF_LTDC)) +#endif /* STM32F427_437xx || STM32F429_439xx */ + +/** + * @} + */ + +/** @defgroup GPIO_Legacy + * @{ + */ + +#define GPIO_Mode_AIN GPIO_Mode_AN + +#define GPIO_AF_OTG1_FS GPIO_AF_OTG_FS +#define GPIO_AF_OTG2_HS GPIO_AF_OTG_HS +#define GPIO_AF_OTG2_FS GPIO_AF_OTG_HS_FS + +/** + * @} + */ + +/** + * @} + */ + +/* Exported macro ------------------------------------------------------------*/ +/* Exported functions --------------------------------------------------------*/ + +/* Function used to set the GPIO configuration to the default reset state ****/ +void GPIO_DeInit(GPIO_TypeDef* GPIOx); + +/* Initialization and Configuration functions *********************************/ +void GPIO_Init(GPIO_TypeDef* GPIOx, GPIO_InitTypeDef* GPIO_InitStruct); +void GPIO_StructInit(GPIO_InitTypeDef* GPIO_InitStruct); +void GPIO_PinLockConfig(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin); + +/* GPIO Read and Write functions **********************************************/ +uint8_t GPIO_ReadInputDataBit(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin); +uint16_t GPIO_ReadInputData(GPIO_TypeDef* GPIOx); +uint8_t GPIO_ReadOutputDataBit(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin); +uint16_t GPIO_ReadOutputData(GPIO_TypeDef* GPIOx); +void GPIO_SetBits(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin); +void GPIO_ResetBits(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin); +void GPIO_WriteBit(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin, BitAction BitVal); +void GPIO_Write(GPIO_TypeDef* GPIOx, uint16_t PortVal); +void GPIO_ToggleBits(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin); + +/* GPIO Alternate functions configuration function ****************************/ +void GPIO_PinAFConfig(GPIO_TypeDef* GPIOx, uint16_t GPIO_PinSource, uint8_t GPIO_AF); + +#ifdef __cplusplus +} +#endif + +#endif /*__STM32F4xx_GPIO_H */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/inc/stm32f4xx_hash.h b/FWLIB/inc/stm32f4xx_hash.h new file mode 100644 index 0000000..6994e1b --- /dev/null +++ b/FWLIB/inc/stm32f4xx_hash.h @@ -0,0 +1,257 @@ +/** + ****************************************************************************** + * @file stm32f4xx_hash.h + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file contains all the functions prototypes for the HASH + * firmware library. + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Define to prevent recursive inclusion -------------------------------------*/ +#ifndef __STM32F4xx_HASH_H +#define __STM32F4xx_HASH_H + +#ifdef __cplusplus + extern "C" { +#endif + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @addtogroup HASH + * @{ + */ + +/* Exported types ------------------------------------------------------------*/ + +/** + * @brief HASH Init structure definition + */ +typedef struct +{ + uint32_t HASH_AlgoSelection; /*!< SHA-1, SHA-224, SHA-256 or MD5. This parameter + can be a value of @ref HASH_Algo_Selection */ + uint32_t HASH_AlgoMode; /*!< HASH or HMAC. This parameter can be a value + of @ref HASH_processor_Algorithm_Mode */ + uint32_t HASH_DataType; /*!< 32-bit data, 16-bit data, 8-bit data or + bit string. This parameter can be a value of + @ref HASH_Data_Type */ + uint32_t HASH_HMACKeyType; /*!< HMAC Short key or HMAC Long Key. This parameter + can be a value of @ref HASH_HMAC_Long_key_only_for_HMAC_mode */ +}HASH_InitTypeDef; + +/** + * @brief HASH message digest result structure definition + */ +typedef struct +{ + uint32_t Data[8]; /*!< Message digest result : 8x 32bit wors for SHA-256, + 7x 32bit wors for SHA-224, + 5x 32bit words for SHA-1 or + 4x 32bit words for MD5 */ +} HASH_MsgDigest; + +/** + * @brief HASH context swapping structure definition + */ +typedef struct +{ + uint32_t HASH_IMR; + uint32_t HASH_STR; + uint32_t HASH_CR; + uint32_t HASH_CSR[54]; +}HASH_Context; + +/* Exported constants --------------------------------------------------------*/ + +/** @defgroup HASH_Exported_Constants + * @{ + */ + +/** @defgroup HASH_Algo_Selection + * @{ + */ +#define HASH_AlgoSelection_SHA1 ((uint32_t)0x0000) /*!< HASH function is SHA1 */ +#define HASH_AlgoSelection_SHA224 HASH_CR_ALGO_1 /*!< HASH function is SHA224 */ +#define HASH_AlgoSelection_SHA256 HASH_CR_ALGO /*!< HASH function is SHA256 */ +#define HASH_AlgoSelection_MD5 HASH_CR_ALGO_0 /*!< HASH function is MD5 */ + +#define IS_HASH_ALGOSELECTION(ALGOSELECTION) (((ALGOSELECTION) == HASH_AlgoSelection_SHA1) || \ + ((ALGOSELECTION) == HASH_AlgoSelection_SHA224) || \ + ((ALGOSELECTION) == HASH_AlgoSelection_SHA256) || \ + ((ALGOSELECTION) == HASH_AlgoSelection_MD5)) +/** + * @} + */ + +/** @defgroup HASH_processor_Algorithm_Mode + * @{ + */ +#define HASH_AlgoMode_HASH ((uint32_t)0x00000000) /*!< Algorithm is HASH */ +#define HASH_AlgoMode_HMAC HASH_CR_MODE /*!< Algorithm is HMAC */ + +#define IS_HASH_ALGOMODE(ALGOMODE) (((ALGOMODE) == HASH_AlgoMode_HASH) || \ + ((ALGOMODE) == HASH_AlgoMode_HMAC)) +/** + * @} + */ + +/** @defgroup HASH_Data_Type + * @{ + */ +#define HASH_DataType_32b ((uint32_t)0x0000) /*!< 32-bit data. No swapping */ +#define HASH_DataType_16b HASH_CR_DATATYPE_0 /*!< 16-bit data. Each half word is swapped */ +#define HASH_DataType_8b HASH_CR_DATATYPE_1 /*!< 8-bit data. All bytes are swapped */ +#define HASH_DataType_1b HASH_CR_DATATYPE /*!< 1-bit data. In the word all bits are swapped */ + +#define IS_HASH_DATATYPE(DATATYPE) (((DATATYPE) == HASH_DataType_32b)|| \ + ((DATATYPE) == HASH_DataType_16b)|| \ + ((DATATYPE) == HASH_DataType_8b) || \ + ((DATATYPE) == HASH_DataType_1b)) +/** + * @} + */ + +/** @defgroup HASH_HMAC_Long_key_only_for_HMAC_mode + * @{ + */ +#define HASH_HMACKeyType_ShortKey ((uint32_t)0x00000000) /*!< HMAC Key is <= 64 bytes */ +#define HASH_HMACKeyType_LongKey HASH_CR_LKEY /*!< HMAC Key is > 64 bytes */ + +#define IS_HASH_HMAC_KEYTYPE(KEYTYPE) (((KEYTYPE) == HASH_HMACKeyType_ShortKey) || \ + ((KEYTYPE) == HASH_HMACKeyType_LongKey)) +/** + * @} + */ + +/** @defgroup Number_of_valid_bits_in_last_word_of_the_message + * @{ + */ +#define IS_HASH_VALIDBITSNUMBER(VALIDBITS) ((VALIDBITS) <= 0x1F) + +/** + * @} + */ + +/** @defgroup HASH_interrupts_definition + * @{ + */ +#define HASH_IT_DINI HASH_IMR_DINIM /*!< A new block can be entered into the input buffer (DIN) */ +#define HASH_IT_DCI HASH_IMR_DCIM /*!< Digest calculation complete */ + +#define IS_HASH_IT(IT) ((((IT) & (uint32_t)0xFFFFFFFC) == 0x00000000) && ((IT) != 0x00000000)) +#define IS_HASH_GET_IT(IT) (((IT) == HASH_IT_DINI) || ((IT) == HASH_IT_DCI)) + +/** + * @} + */ + +/** @defgroup HASH_flags_definition + * @{ + */ +#define HASH_FLAG_DINIS HASH_SR_DINIS /*!< 16 locations are free in the DIN : A new block can be entered into the input buffer */ +#define HASH_FLAG_DCIS HASH_SR_DCIS /*!< Digest calculation complete */ +#define HASH_FLAG_DMAS HASH_SR_DMAS /*!< DMA interface is enabled (DMAE=1) or a transfer is ongoing */ +#define HASH_FLAG_BUSY HASH_SR_BUSY /*!< The hash core is Busy : processing a block of data */ +#define HASH_FLAG_DINNE HASH_CR_DINNE /*!< DIN not empty : The input buffer contains at least one word of data */ + +#define IS_HASH_GET_FLAG(FLAG) (((FLAG) == HASH_FLAG_DINIS) || \ + ((FLAG) == HASH_FLAG_DCIS) || \ + ((FLAG) == HASH_FLAG_DMAS) || \ + ((FLAG) == HASH_FLAG_BUSY) || \ + ((FLAG) == HASH_FLAG_DINNE)) + +#define IS_HASH_CLEAR_FLAG(FLAG)(((FLAG) == HASH_FLAG_DINIS) || \ + ((FLAG) == HASH_FLAG_DCIS)) + +/** + * @} + */ + +/** + * @} + */ + +/* Exported macro ------------------------------------------------------------*/ +/* Exported functions --------------------------------------------------------*/ + +/* Function used to set the HASH configuration to the default reset state ****/ +void HASH_DeInit(void); + +/* HASH Configuration function ************************************************/ +void HASH_Init(HASH_InitTypeDef* HASH_InitStruct); +void HASH_StructInit(HASH_InitTypeDef* HASH_InitStruct); +void HASH_Reset(void); + +/* HASH Message Digest generation functions ***********************************/ +void HASH_DataIn(uint32_t Data); +uint8_t HASH_GetInFIFOWordsNbr(void); +void HASH_SetLastWordValidBitsNbr(uint16_t ValidNumber); +void HASH_StartDigest(void); +void HASH_AutoStartDigest(FunctionalState NewState); +void HASH_GetDigest(HASH_MsgDigest* HASH_MessageDigest); + +/* HASH Context swapping functions ********************************************/ +void HASH_SaveContext(HASH_Context* HASH_ContextSave); +void HASH_RestoreContext(HASH_Context* HASH_ContextRestore); + +/* HASH DMA interface function ************************************************/ +void HASH_DMACmd(FunctionalState NewState); + +/* HASH Interrupts and flags management functions *****************************/ +void HASH_ITConfig(uint32_t HASH_IT, FunctionalState NewState); +FlagStatus HASH_GetFlagStatus(uint32_t HASH_FLAG); +void HASH_ClearFlag(uint32_t HASH_FLAG); +ITStatus HASH_GetITStatus(uint32_t HASH_IT); +void HASH_ClearITPendingBit(uint32_t HASH_IT); + +/* High Level SHA1 functions **************************************************/ +ErrorStatus HASH_SHA1(uint8_t *Input, uint32_t Ilen, uint8_t Output[20]); +ErrorStatus HMAC_SHA1(uint8_t *Key, uint32_t Keylen, + uint8_t *Input, uint32_t Ilen, + uint8_t Output[20]); + +/* High Level MD5 functions ***************************************************/ +ErrorStatus HASH_MD5(uint8_t *Input, uint32_t Ilen, uint8_t Output[16]); +ErrorStatus HMAC_MD5(uint8_t *Key, uint32_t Keylen, + uint8_t *Input, uint32_t Ilen, + uint8_t Output[16]); + +#ifdef __cplusplus +} +#endif + +#endif /*__STM32F4xx_HASH_H */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/inc/stm32f4xx_i2c.h b/FWLIB/inc/stm32f4xx_i2c.h new file mode 100644 index 0000000..8a2211d --- /dev/null +++ b/FWLIB/inc/stm32f4xx_i2c.h @@ -0,0 +1,711 @@ +/** + ****************************************************************************** + * @file stm32f4xx_i2c.h + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file contains all the functions prototypes for the I2C firmware + * library. + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Define to prevent recursive inclusion -------------------------------------*/ +#ifndef __STM32F4xx_I2C_H +#define __STM32F4xx_I2C_H + +#ifdef __cplusplus + extern "C" { +#endif + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @addtogroup I2C + * @{ + */ + +/* Exported types ------------------------------------------------------------*/ + +/** + * @brief I2C Init structure definition + */ + +typedef struct +{ + uint32_t I2C_ClockSpeed; /*!< Specifies the clock frequency. + This parameter must be set to a value lower than 400kHz */ + + uint16_t I2C_Mode; /*!< Specifies the I2C mode. + This parameter can be a value of @ref I2C_mode */ + + uint16_t I2C_DutyCycle; /*!< Specifies the I2C fast mode duty cycle. + This parameter can be a value of @ref I2C_duty_cycle_in_fast_mode */ + + uint16_t I2C_OwnAddress1; /*!< Specifies the first device own address. + This parameter can be a 7-bit or 10-bit address. */ + + uint16_t I2C_Ack; /*!< Enables or disables the acknowledgement. + This parameter can be a value of @ref I2C_acknowledgement */ + + uint16_t I2C_AcknowledgedAddress; /*!< Specifies if 7-bit or 10-bit address is acknowledged. + This parameter can be a value of @ref I2C_acknowledged_address */ +}I2C_InitTypeDef; + +/* Exported constants --------------------------------------------------------*/ + + +/** @defgroup I2C_Exported_Constants + * @{ + */ + +#define IS_I2C_ALL_PERIPH(PERIPH) (((PERIPH) == I2C1) || \ + ((PERIPH) == I2C2) || \ + ((PERIPH) == I2C3)) + +/** @defgroup I2C_Digital_Filter + * @{ + */ + +#define IS_I2C_DIGITAL_FILTER(FILTER) ((FILTER) <= 0x0000000F) +/** + * @} + */ + + +/** @defgroup I2C_mode + * @{ + */ + +#define I2C_Mode_I2C ((uint16_t)0x0000) +#define I2C_Mode_SMBusDevice ((uint16_t)0x0002) +#define I2C_Mode_SMBusHost ((uint16_t)0x000A) +#define IS_I2C_MODE(MODE) (((MODE) == I2C_Mode_I2C) || \ + ((MODE) == I2C_Mode_SMBusDevice) || \ + ((MODE) == I2C_Mode_SMBusHost)) +/** + * @} + */ + +/** @defgroup I2C_duty_cycle_in_fast_mode + * @{ + */ + +#define I2C_DutyCycle_16_9 ((uint16_t)0x4000) /*!< I2C fast mode Tlow/Thigh = 16/9 */ +#define I2C_DutyCycle_2 ((uint16_t)0xBFFF) /*!< I2C fast mode Tlow/Thigh = 2 */ +#define IS_I2C_DUTY_CYCLE(CYCLE) (((CYCLE) == I2C_DutyCycle_16_9) || \ + ((CYCLE) == I2C_DutyCycle_2)) +/** + * @} + */ + +/** @defgroup I2C_acknowledgement + * @{ + */ + +#define I2C_Ack_Enable ((uint16_t)0x0400) +#define I2C_Ack_Disable ((uint16_t)0x0000) +#define IS_I2C_ACK_STATE(STATE) (((STATE) == I2C_Ack_Enable) || \ + ((STATE) == I2C_Ack_Disable)) +/** + * @} + */ + +/** @defgroup I2C_transfer_direction + * @{ + */ + +#define I2C_Direction_Transmitter ((uint8_t)0x00) +#define I2C_Direction_Receiver ((uint8_t)0x01) +#define IS_I2C_DIRECTION(DIRECTION) (((DIRECTION) == I2C_Direction_Transmitter) || \ + ((DIRECTION) == I2C_Direction_Receiver)) +/** + * @} + */ + +/** @defgroup I2C_acknowledged_address + * @{ + */ + +#define I2C_AcknowledgedAddress_7bit ((uint16_t)0x4000) +#define I2C_AcknowledgedAddress_10bit ((uint16_t)0xC000) +#define IS_I2C_ACKNOWLEDGE_ADDRESS(ADDRESS) (((ADDRESS) == I2C_AcknowledgedAddress_7bit) || \ + ((ADDRESS) == I2C_AcknowledgedAddress_10bit)) +/** + * @} + */ + +/** @defgroup I2C_registers + * @{ + */ + +#define I2C_Register_CR1 ((uint8_t)0x00) +#define I2C_Register_CR2 ((uint8_t)0x04) +#define I2C_Register_OAR1 ((uint8_t)0x08) +#define I2C_Register_OAR2 ((uint8_t)0x0C) +#define I2C_Register_DR ((uint8_t)0x10) +#define I2C_Register_SR1 ((uint8_t)0x14) +#define I2C_Register_SR2 ((uint8_t)0x18) +#define I2C_Register_CCR ((uint8_t)0x1C) +#define I2C_Register_TRISE ((uint8_t)0x20) +#define IS_I2C_REGISTER(REGISTER) (((REGISTER) == I2C_Register_CR1) || \ + ((REGISTER) == I2C_Register_CR2) || \ + ((REGISTER) == I2C_Register_OAR1) || \ + ((REGISTER) == I2C_Register_OAR2) || \ + ((REGISTER) == I2C_Register_DR) || \ + ((REGISTER) == I2C_Register_SR1) || \ + ((REGISTER) == I2C_Register_SR2) || \ + ((REGISTER) == I2C_Register_CCR) || \ + ((REGISTER) == I2C_Register_TRISE)) +/** + * @} + */ + +/** @defgroup I2C_NACK_position + * @{ + */ + +#define I2C_NACKPosition_Next ((uint16_t)0x0800) +#define I2C_NACKPosition_Current ((uint16_t)0xF7FF) +#define IS_I2C_NACK_POSITION(POSITION) (((POSITION) == I2C_NACKPosition_Next) || \ + ((POSITION) == I2C_NACKPosition_Current)) +/** + * @} + */ + +/** @defgroup I2C_SMBus_alert_pin_level + * @{ + */ + +#define I2C_SMBusAlert_Low ((uint16_t)0x2000) +#define I2C_SMBusAlert_High ((uint16_t)0xDFFF) +#define IS_I2C_SMBUS_ALERT(ALERT) (((ALERT) == I2C_SMBusAlert_Low) || \ + ((ALERT) == I2C_SMBusAlert_High)) +/** + * @} + */ + +/** @defgroup I2C_PEC_position + * @{ + */ + +#define I2C_PECPosition_Next ((uint16_t)0x0800) +#define I2C_PECPosition_Current ((uint16_t)0xF7FF) +#define IS_I2C_PEC_POSITION(POSITION) (((POSITION) == I2C_PECPosition_Next) || \ + ((POSITION) == I2C_PECPosition_Current)) +/** + * @} + */ + +/** @defgroup I2C_interrupts_definition + * @{ + */ + +#define I2C_IT_BUF ((uint16_t)0x0400) +#define I2C_IT_EVT ((uint16_t)0x0200) +#define I2C_IT_ERR ((uint16_t)0x0100) +#define IS_I2C_CONFIG_IT(IT) ((((IT) & (uint16_t)0xF8FF) == 0x00) && ((IT) != 0x00)) +/** + * @} + */ + +/** @defgroup I2C_interrupts_definition + * @{ + */ + +#define I2C_IT_SMBALERT ((uint32_t)0x01008000) +#define I2C_IT_TIMEOUT ((uint32_t)0x01004000) +#define I2C_IT_PECERR ((uint32_t)0x01001000) +#define I2C_IT_OVR ((uint32_t)0x01000800) +#define I2C_IT_AF ((uint32_t)0x01000400) +#define I2C_IT_ARLO ((uint32_t)0x01000200) +#define I2C_IT_BERR ((uint32_t)0x01000100) +#define I2C_IT_TXE ((uint32_t)0x06000080) +#define I2C_IT_RXNE ((uint32_t)0x06000040) +#define I2C_IT_STOPF ((uint32_t)0x02000010) +#define I2C_IT_ADD10 ((uint32_t)0x02000008) +#define I2C_IT_BTF ((uint32_t)0x02000004) +#define I2C_IT_ADDR ((uint32_t)0x02000002) +#define I2C_IT_SB ((uint32_t)0x02000001) + +#define IS_I2C_CLEAR_IT(IT) ((((IT) & (uint16_t)0x20FF) == 0x00) && ((IT) != (uint16_t)0x00)) + +#define IS_I2C_GET_IT(IT) (((IT) == I2C_IT_SMBALERT) || ((IT) == I2C_IT_TIMEOUT) || \ + ((IT) == I2C_IT_PECERR) || ((IT) == I2C_IT_OVR) || \ + ((IT) == I2C_IT_AF) || ((IT) == I2C_IT_ARLO) || \ + ((IT) == I2C_IT_BERR) || ((IT) == I2C_IT_TXE) || \ + ((IT) == I2C_IT_RXNE) || ((IT) == I2C_IT_STOPF) || \ + ((IT) == I2C_IT_ADD10) || ((IT) == I2C_IT_BTF) || \ + ((IT) == I2C_IT_ADDR) || ((IT) == I2C_IT_SB)) +/** + * @} + */ + +/** @defgroup I2C_flags_definition + * @{ + */ + +/** + * @brief SR2 register flags + */ + +#define I2C_FLAG_DUALF ((uint32_t)0x00800000) +#define I2C_FLAG_SMBHOST ((uint32_t)0x00400000) +#define I2C_FLAG_SMBDEFAULT ((uint32_t)0x00200000) +#define I2C_FLAG_GENCALL ((uint32_t)0x00100000) +#define I2C_FLAG_TRA ((uint32_t)0x00040000) +#define I2C_FLAG_BUSY ((uint32_t)0x00020000) +#define I2C_FLAG_MSL ((uint32_t)0x00010000) + +/** + * @brief SR1 register flags + */ + +#define I2C_FLAG_SMBALERT ((uint32_t)0x10008000) +#define I2C_FLAG_TIMEOUT ((uint32_t)0x10004000) +#define I2C_FLAG_PECERR ((uint32_t)0x10001000) +#define I2C_FLAG_OVR ((uint32_t)0x10000800) +#define I2C_FLAG_AF ((uint32_t)0x10000400) +#define I2C_FLAG_ARLO ((uint32_t)0x10000200) +#define I2C_FLAG_BERR ((uint32_t)0x10000100) +#define I2C_FLAG_TXE ((uint32_t)0x10000080) +#define I2C_FLAG_RXNE ((uint32_t)0x10000040) +#define I2C_FLAG_STOPF ((uint32_t)0x10000010) +#define I2C_FLAG_ADD10 ((uint32_t)0x10000008) +#define I2C_FLAG_BTF ((uint32_t)0x10000004) +#define I2C_FLAG_ADDR ((uint32_t)0x10000002) +#define I2C_FLAG_SB ((uint32_t)0x10000001) + +#define IS_I2C_CLEAR_FLAG(FLAG) ((((FLAG) & (uint16_t)0x20FF) == 0x00) && ((FLAG) != (uint16_t)0x00)) + +#define IS_I2C_GET_FLAG(FLAG) (((FLAG) == I2C_FLAG_DUALF) || ((FLAG) == I2C_FLAG_SMBHOST) || \ + ((FLAG) == I2C_FLAG_SMBDEFAULT) || ((FLAG) == I2C_FLAG_GENCALL) || \ + ((FLAG) == I2C_FLAG_TRA) || ((FLAG) == I2C_FLAG_BUSY) || \ + ((FLAG) == I2C_FLAG_MSL) || ((FLAG) == I2C_FLAG_SMBALERT) || \ + ((FLAG) == I2C_FLAG_TIMEOUT) || ((FLAG) == I2C_FLAG_PECERR) || \ + ((FLAG) == I2C_FLAG_OVR) || ((FLAG) == I2C_FLAG_AF) || \ + ((FLAG) == I2C_FLAG_ARLO) || ((FLAG) == I2C_FLAG_BERR) || \ + ((FLAG) == I2C_FLAG_TXE) || ((FLAG) == I2C_FLAG_RXNE) || \ + ((FLAG) == I2C_FLAG_STOPF) || ((FLAG) == I2C_FLAG_ADD10) || \ + ((FLAG) == I2C_FLAG_BTF) || ((FLAG) == I2C_FLAG_ADDR) || \ + ((FLAG) == I2C_FLAG_SB)) +/** + * @} + */ + +/** @defgroup I2C_Events + * @{ + */ + +/** + =============================================================================== + I2C Master Events (Events grouped in order of communication) + =============================================================================== + */ + +/** + * @brief Communication start + * + * After sending the START condition (I2C_GenerateSTART() function) the master + * has to wait for this event. It means that the Start condition has been correctly + * released on the I2C bus (the bus is free, no other devices is communicating). + * + */ +/* --EV5 */ +#define I2C_EVENT_MASTER_MODE_SELECT ((uint32_t)0x00030001) /* BUSY, MSL and SB flag */ + +/** + * @brief Address Acknowledge + * + * After checking on EV5 (start condition correctly released on the bus), the + * master sends the address of the slave(s) with which it will communicate + * (I2C_Send7bitAddress() function, it also determines the direction of the communication: + * Master transmitter or Receiver). Then the master has to wait that a slave acknowledges + * his address. If an acknowledge is sent on the bus, one of the following events will + * be set: + * + * 1) In case of Master Receiver (7-bit addressing): the I2C_EVENT_MASTER_RECEIVER_MODE_SELECTED + * event is set. + * + * 2) In case of Master Transmitter (7-bit addressing): the I2C_EVENT_MASTER_TRANSMITTER_MODE_SELECTED + * is set + * + * 3) In case of 10-Bit addressing mode, the master (just after generating the START + * and checking on EV5) has to send the header of 10-bit addressing mode (I2C_SendData() + * function). Then master should wait on EV9. It means that the 10-bit addressing + * header has been correctly sent on the bus. Then master should send the second part of + * the 10-bit address (LSB) using the function I2C_Send7bitAddress(). Then master + * should wait for event EV6. + * + */ + +/* --EV6 */ +#define I2C_EVENT_MASTER_TRANSMITTER_MODE_SELECTED ((uint32_t)0x00070082) /* BUSY, MSL, ADDR, TXE and TRA flags */ +#define I2C_EVENT_MASTER_RECEIVER_MODE_SELECTED ((uint32_t)0x00030002) /* BUSY, MSL and ADDR flags */ +/* --EV9 */ +#define I2C_EVENT_MASTER_MODE_ADDRESS10 ((uint32_t)0x00030008) /* BUSY, MSL and ADD10 flags */ + +/** + * @brief Communication events + * + * If a communication is established (START condition generated and slave address + * acknowledged) then the master has to check on one of the following events for + * communication procedures: + * + * 1) Master Receiver mode: The master has to wait on the event EV7 then to read + * the data received from the slave (I2C_ReceiveData() function). + * + * 2) Master Transmitter mode: The master has to send data (I2C_SendData() + * function) then to wait on event EV8 or EV8_2. + * These two events are similar: + * - EV8 means that the data has been written in the data register and is + * being shifted out. + * - EV8_2 means that the data has been physically shifted out and output + * on the bus. + * In most cases, using EV8 is sufficient for the application. + * Using EV8_2 leads to a slower communication but ensure more reliable test. + * EV8_2 is also more suitable than EV8 for testing on the last data transmission + * (before Stop condition generation). + * + * @note In case the user software does not guarantee that this event EV7 is + * managed before the current byte end of transfer, then user may check on EV7 + * and BTF flag at the same time (ie. (I2C_EVENT_MASTER_BYTE_RECEIVED | I2C_FLAG_BTF)). + * In this case the communication may be slower. + * + */ + +/* Master RECEIVER mode -----------------------------*/ +/* --EV7 */ +#define I2C_EVENT_MASTER_BYTE_RECEIVED ((uint32_t)0x00030040) /* BUSY, MSL and RXNE flags */ + +/* Master TRANSMITTER mode --------------------------*/ +/* --EV8 */ +#define I2C_EVENT_MASTER_BYTE_TRANSMITTING ((uint32_t)0x00070080) /* TRA, BUSY, MSL, TXE flags */ +/* --EV8_2 */ +#define I2C_EVENT_MASTER_BYTE_TRANSMITTED ((uint32_t)0x00070084) /* TRA, BUSY, MSL, TXE and BTF flags */ + + +/** + =============================================================================== + I2C Slave Events (Events grouped in order of communication) + =============================================================================== + */ + + +/** + * @brief Communication start events + * + * Wait on one of these events at the start of the communication. It means that + * the I2C peripheral detected a Start condition on the bus (generated by master + * device) followed by the peripheral address. The peripheral generates an ACK + * condition on the bus (if the acknowledge feature is enabled through function + * I2C_AcknowledgeConfig()) and the events listed above are set : + * + * 1) In normal case (only one address managed by the slave), when the address + * sent by the master matches the own address of the peripheral (configured by + * I2C_OwnAddress1 field) the I2C_EVENT_SLAVE_XXX_ADDRESS_MATCHED event is set + * (where XXX could be TRANSMITTER or RECEIVER). + * + * 2) In case the address sent by the master matches the second address of the + * peripheral (configured by the function I2C_OwnAddress2Config() and enabled + * by the function I2C_DualAddressCmd()) the events I2C_EVENT_SLAVE_XXX_SECONDADDRESS_MATCHED + * (where XXX could be TRANSMITTER or RECEIVER) are set. + * + * 3) In case the address sent by the master is General Call (address 0x00) and + * if the General Call is enabled for the peripheral (using function I2C_GeneralCallCmd()) + * the following event is set I2C_EVENT_SLAVE_GENERALCALLADDRESS_MATCHED. + * + */ + +/* --EV1 (all the events below are variants of EV1) */ +/* 1) Case of One Single Address managed by the slave */ +#define I2C_EVENT_SLAVE_RECEIVER_ADDRESS_MATCHED ((uint32_t)0x00020002) /* BUSY and ADDR flags */ +#define I2C_EVENT_SLAVE_TRANSMITTER_ADDRESS_MATCHED ((uint32_t)0x00060082) /* TRA, BUSY, TXE and ADDR flags */ + +/* 2) Case of Dual address managed by the slave */ +#define I2C_EVENT_SLAVE_RECEIVER_SECONDADDRESS_MATCHED ((uint32_t)0x00820000) /* DUALF and BUSY flags */ +#define I2C_EVENT_SLAVE_TRANSMITTER_SECONDADDRESS_MATCHED ((uint32_t)0x00860080) /* DUALF, TRA, BUSY and TXE flags */ + +/* 3) Case of General Call enabled for the slave */ +#define I2C_EVENT_SLAVE_GENERALCALLADDRESS_MATCHED ((uint32_t)0x00120000) /* GENCALL and BUSY flags */ + +/** + * @brief Communication events + * + * Wait on one of these events when EV1 has already been checked and: + * + * - Slave RECEIVER mode: + * - EV2: When the application is expecting a data byte to be received. + * - EV4: When the application is expecting the end of the communication: master + * sends a stop condition and data transmission is stopped. + * + * - Slave Transmitter mode: + * - EV3: When a byte has been transmitted by the slave and the application is expecting + * the end of the byte transmission. The two events I2C_EVENT_SLAVE_BYTE_TRANSMITTED and + * I2C_EVENT_SLAVE_BYTE_TRANSMITTING are similar. The second one can optionally be + * used when the user software doesn't guarantee the EV3 is managed before the + * current byte end of transfer. + * - EV3_2: When the master sends a NACK in order to tell slave that data transmission + * shall end (before sending the STOP condition). In this case slave has to stop sending + * data bytes and expect a Stop condition on the bus. + * + * @note In case the user software does not guarantee that the event EV2 is + * managed before the current byte end of transfer, then user may check on EV2 + * and BTF flag at the same time (ie. (I2C_EVENT_SLAVE_BYTE_RECEIVED | I2C_FLAG_BTF)). + * In this case the communication may be slower. + * + */ + +/* Slave RECEIVER mode --------------------------*/ +/* --EV2 */ +#define I2C_EVENT_SLAVE_BYTE_RECEIVED ((uint32_t)0x00020040) /* BUSY and RXNE flags */ +/* --EV4 */ +#define I2C_EVENT_SLAVE_STOP_DETECTED ((uint32_t)0x00000010) /* STOPF flag */ + +/* Slave TRANSMITTER mode -----------------------*/ +/* --EV3 */ +#define I2C_EVENT_SLAVE_BYTE_TRANSMITTED ((uint32_t)0x00060084) /* TRA, BUSY, TXE and BTF flags */ +#define I2C_EVENT_SLAVE_BYTE_TRANSMITTING ((uint32_t)0x00060080) /* TRA, BUSY and TXE flags */ +/* --EV3_2 */ +#define I2C_EVENT_SLAVE_ACK_FAILURE ((uint32_t)0x00000400) /* AF flag */ + +/* + =============================================================================== + End of Events Description + =============================================================================== + */ + +#define IS_I2C_EVENT(EVENT) (((EVENT) == I2C_EVENT_SLAVE_TRANSMITTER_ADDRESS_MATCHED) || \ + ((EVENT) == I2C_EVENT_SLAVE_RECEIVER_ADDRESS_MATCHED) || \ + ((EVENT) == I2C_EVENT_SLAVE_TRANSMITTER_SECONDADDRESS_MATCHED) || \ + ((EVENT) == I2C_EVENT_SLAVE_RECEIVER_SECONDADDRESS_MATCHED) || \ + ((EVENT) == I2C_EVENT_SLAVE_GENERALCALLADDRESS_MATCHED) || \ + ((EVENT) == I2C_EVENT_SLAVE_BYTE_RECEIVED) || \ + ((EVENT) == (I2C_EVENT_SLAVE_BYTE_RECEIVED | I2C_FLAG_DUALF)) || \ + ((EVENT) == (I2C_EVENT_SLAVE_BYTE_RECEIVED | I2C_FLAG_GENCALL)) || \ + ((EVENT) == I2C_EVENT_SLAVE_BYTE_TRANSMITTED) || \ + ((EVENT) == (I2C_EVENT_SLAVE_BYTE_TRANSMITTED | I2C_FLAG_DUALF)) || \ + ((EVENT) == (I2C_EVENT_SLAVE_BYTE_TRANSMITTED | I2C_FLAG_GENCALL)) || \ + ((EVENT) == I2C_EVENT_SLAVE_STOP_DETECTED) || \ + ((EVENT) == I2C_EVENT_MASTER_MODE_SELECT) || \ + ((EVENT) == I2C_EVENT_MASTER_TRANSMITTER_MODE_SELECTED) || \ + ((EVENT) == I2C_EVENT_MASTER_RECEIVER_MODE_SELECTED) || \ + ((EVENT) == I2C_EVENT_MASTER_BYTE_RECEIVED) || \ + ((EVENT) == I2C_EVENT_MASTER_BYTE_TRANSMITTED) || \ + ((EVENT) == I2C_EVENT_MASTER_BYTE_TRANSMITTING) || \ + ((EVENT) == I2C_EVENT_MASTER_MODE_ADDRESS10) || \ + ((EVENT) == I2C_EVENT_SLAVE_ACK_FAILURE)) +/** + * @} + */ + +/** @defgroup I2C_own_address1 + * @{ + */ + +#define IS_I2C_OWN_ADDRESS1(ADDRESS1) ((ADDRESS1) <= 0x3FF) +/** + * @} + */ + +/** @defgroup I2C_clock_speed + * @{ + */ + +#define IS_I2C_CLOCK_SPEED(SPEED) (((SPEED) >= 0x1) && ((SPEED) <= 400000)) +/** + * @} + */ + +/** + * @} + */ + +/* Exported macro ------------------------------------------------------------*/ +/* Exported functions --------------------------------------------------------*/ + +/* Function used to set the I2C configuration to the default reset state *****/ +void I2C_DeInit(I2C_TypeDef* I2Cx); + +/* Initialization and Configuration functions *********************************/ +void I2C_Init(I2C_TypeDef* I2Cx, I2C_InitTypeDef* I2C_InitStruct); +void I2C_StructInit(I2C_InitTypeDef* I2C_InitStruct); +void I2C_Cmd(I2C_TypeDef* I2Cx, FunctionalState NewState); +void I2C_DigitalFilterConfig(I2C_TypeDef* I2Cx, uint16_t I2C_DigitalFilter); +void I2C_AnalogFilterCmd(I2C_TypeDef* I2Cx, FunctionalState NewState); +void I2C_GenerateSTART(I2C_TypeDef* I2Cx, FunctionalState NewState); +void I2C_GenerateSTOP(I2C_TypeDef* I2Cx, FunctionalState NewState); +void I2C_Send7bitAddress(I2C_TypeDef* I2Cx, uint8_t Address, uint8_t I2C_Direction); +void I2C_AcknowledgeConfig(I2C_TypeDef* I2Cx, FunctionalState NewState); +void I2C_OwnAddress2Config(I2C_TypeDef* I2Cx, uint8_t Address); +void I2C_DualAddressCmd(I2C_TypeDef* I2Cx, FunctionalState NewState); +void I2C_GeneralCallCmd(I2C_TypeDef* I2Cx, FunctionalState NewState); +void I2C_SoftwareResetCmd(I2C_TypeDef* I2Cx, FunctionalState NewState); +void I2C_StretchClockCmd(I2C_TypeDef* I2Cx, FunctionalState NewState); +void I2C_FastModeDutyCycleConfig(I2C_TypeDef* I2Cx, uint16_t I2C_DutyCycle); +void I2C_NACKPositionConfig(I2C_TypeDef* I2Cx, uint16_t I2C_NACKPosition); +void I2C_SMBusAlertConfig(I2C_TypeDef* I2Cx, uint16_t I2C_SMBusAlert); +void I2C_ARPCmd(I2C_TypeDef* I2Cx, FunctionalState NewState); + +/* Data transfers functions ***************************************************/ +void I2C_SendData(I2C_TypeDef* I2Cx, uint8_t Data); +uint8_t I2C_ReceiveData(I2C_TypeDef* I2Cx); + +/* PEC management functions ***************************************************/ +void I2C_TransmitPEC(I2C_TypeDef* I2Cx, FunctionalState NewState); +void I2C_PECPositionConfig(I2C_TypeDef* I2Cx, uint16_t I2C_PECPosition); +void I2C_CalculatePEC(I2C_TypeDef* I2Cx, FunctionalState NewState); +uint8_t I2C_GetPEC(I2C_TypeDef* I2Cx); + +/* DMA transfers management functions *****************************************/ +void I2C_DMACmd(I2C_TypeDef* I2Cx, FunctionalState NewState); +void I2C_DMALastTransferCmd(I2C_TypeDef* I2Cx, FunctionalState NewState); + +/* Interrupts, events and flags management functions **************************/ +uint16_t I2C_ReadRegister(I2C_TypeDef* I2Cx, uint8_t I2C_Register); +void I2C_ITConfig(I2C_TypeDef* I2Cx, uint16_t I2C_IT, FunctionalState NewState); + +/* + =============================================================================== + I2C State Monitoring Functions + =============================================================================== + This I2C driver provides three different ways for I2C state monitoring + depending on the application requirements and constraints: + + + 1. Basic state monitoring (Using I2C_CheckEvent() function) + ----------------------------------------------------------- + It compares the status registers (SR1 and SR2) content to a given event + (can be the combination of one or more flags). + It returns SUCCESS if the current status includes the given flags + and returns ERROR if one or more flags are missing in the current status. + + - When to use + - This function is suitable for most applications as well as for startup + activity since the events are fully described in the product reference + manual (RM0090). + - It is also suitable for users who need to define their own events. + + - Limitations + - If an error occurs (ie. error flags are set besides to the monitored + flags), the I2C_CheckEvent() function may return SUCCESS despite + the communication hold or corrupted real state. + In this case, it is advised to use error interrupts to monitor + the error events and handle them in the interrupt IRQ handler. + + Note + For error management, it is advised to use the following functions: + - I2C_ITConfig() to configure and enable the error interrupts (I2C_IT_ERR). + - I2Cx_ER_IRQHandler() which is called when the error interrupt occurs. + Where x is the peripheral instance (I2C1, I2C2 ...) + - I2C_GetFlagStatus() or I2C_GetITStatus() to be called into the + I2Cx_ER_IRQHandler() function in order to determine which error occurred. + - I2C_ClearFlag() or I2C_ClearITPendingBit() and/or I2C_SoftwareResetCmd() + and/or I2C_GenerateStop() in order to clear the error flag and source + and return to correct communication status. + + + 2. Advanced state monitoring (Using the function I2C_GetLastEvent()) + -------------------------------------------------------------------- + Using the function I2C_GetLastEvent() which returns the image of both status + registers in a single word (uint32_t) (Status Register 2 value is shifted left + by 16 bits and concatenated to Status Register 1). + + - When to use + - This function is suitable for the same applications above but it + allows to overcome the mentioned limitation of I2C_GetFlagStatus() + function. + - The returned value could be compared to events already defined in + this file or to custom values defined by user. + This function is suitable when multiple flags are monitored at the + same time. + - At the opposite of I2C_CheckEvent() function, this function allows + user to choose when an event is accepted (when all events flags are + set and no other flags are set or just when the needed flags are set + like I2C_CheckEvent() function. + + - Limitations + - User may need to define his own events. + - Same remark concerning the error management is applicable for this + function if user decides to check only regular communication flags + (and ignores error flags). + + + 3. Flag-based state monitoring (Using the function I2C_GetFlagStatus()) + ----------------------------------------------------------------------- + + Using the function I2C_GetFlagStatus() which simply returns the status of + one single flag (ie. I2C_FLAG_RXNE ...). + + - When to use + - This function could be used for specific applications or in debug + phase. + - It is suitable when only one flag checking is needed (most I2C + events are monitored through multiple flags). + - Limitations: + - When calling this function, the Status register is accessed. + Some flags are cleared when the status register is accessed. + So checking the status of one Flag, may clear other ones. + - Function may need to be called twice or more in order to monitor + one single event. + */ + +/* + =============================================================================== + 1. Basic state monitoring + =============================================================================== + */ +ErrorStatus I2C_CheckEvent(I2C_TypeDef* I2Cx, uint32_t I2C_EVENT); +/* + =============================================================================== + 2. Advanced state monitoring + =============================================================================== + */ +uint32_t I2C_GetLastEvent(I2C_TypeDef* I2Cx); +/* + =============================================================================== + 3. Flag-based state monitoring + =============================================================================== + */ +FlagStatus I2C_GetFlagStatus(I2C_TypeDef* I2Cx, uint32_t I2C_FLAG); + + +void I2C_ClearFlag(I2C_TypeDef* I2Cx, uint32_t I2C_FLAG); +ITStatus I2C_GetITStatus(I2C_TypeDef* I2Cx, uint32_t I2C_IT); +void I2C_ClearITPendingBit(I2C_TypeDef* I2Cx, uint32_t I2C_IT); + +#ifdef __cplusplus +} +#endif + +#endif /*__STM32F4xx_I2C_H */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/inc/stm32f4xx_iwdg.h b/FWLIB/inc/stm32f4xx_iwdg.h new file mode 100644 index 0000000..44d2543 --- /dev/null +++ b/FWLIB/inc/stm32f4xx_iwdg.h @@ -0,0 +1,131 @@ +/** + ****************************************************************************** + * @file stm32f4xx_iwdg.h + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file contains all the functions prototypes for the IWDG + * firmware library. + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Define to prevent recursive inclusion -------------------------------------*/ +#ifndef __STM32F4xx_IWDG_H +#define __STM32F4xx_IWDG_H + +#ifdef __cplusplus + extern "C" { +#endif + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @addtogroup IWDG + * @{ + */ + +/* Exported types ------------------------------------------------------------*/ +/* Exported constants --------------------------------------------------------*/ + +/** @defgroup IWDG_Exported_Constants + * @{ + */ + +/** @defgroup IWDG_WriteAccess + * @{ + */ +#define IWDG_WriteAccess_Enable ((uint16_t)0x5555) +#define IWDG_WriteAccess_Disable ((uint16_t)0x0000) +#define IS_IWDG_WRITE_ACCESS(ACCESS) (((ACCESS) == IWDG_WriteAccess_Enable) || \ + ((ACCESS) == IWDG_WriteAccess_Disable)) +/** + * @} + */ + +/** @defgroup IWDG_prescaler + * @{ + */ +#define IWDG_Prescaler_4 ((uint8_t)0x00) +#define IWDG_Prescaler_8 ((uint8_t)0x01) +#define IWDG_Prescaler_16 ((uint8_t)0x02) +#define IWDG_Prescaler_32 ((uint8_t)0x03) +#define IWDG_Prescaler_64 ((uint8_t)0x04) +#define IWDG_Prescaler_128 ((uint8_t)0x05) +#define IWDG_Prescaler_256 ((uint8_t)0x06) +#define IS_IWDG_PRESCALER(PRESCALER) (((PRESCALER) == IWDG_Prescaler_4) || \ + ((PRESCALER) == IWDG_Prescaler_8) || \ + ((PRESCALER) == IWDG_Prescaler_16) || \ + ((PRESCALER) == IWDG_Prescaler_32) || \ + ((PRESCALER) == IWDG_Prescaler_64) || \ + ((PRESCALER) == IWDG_Prescaler_128)|| \ + ((PRESCALER) == IWDG_Prescaler_256)) +/** + * @} + */ + +/** @defgroup IWDG_Flag + * @{ + */ +#define IWDG_FLAG_PVU ((uint16_t)0x0001) +#define IWDG_FLAG_RVU ((uint16_t)0x0002) +#define IS_IWDG_FLAG(FLAG) (((FLAG) == IWDG_FLAG_PVU) || ((FLAG) == IWDG_FLAG_RVU)) +#define IS_IWDG_RELOAD(RELOAD) ((RELOAD) <= 0xFFF) +/** + * @} + */ + +/** + * @} + */ + +/* Exported macro ------------------------------------------------------------*/ +/* Exported functions --------------------------------------------------------*/ + +/* Prescaler and Counter configuration functions ******************************/ +void IWDG_WriteAccessCmd(uint16_t IWDG_WriteAccess); +void IWDG_SetPrescaler(uint8_t IWDG_Prescaler); +void IWDG_SetReload(uint16_t Reload); +void IWDG_ReloadCounter(void); + +/* IWDG activation function ***************************************************/ +void IWDG_Enable(void); + +/* Flag management function ***************************************************/ +FlagStatus IWDG_GetFlagStatus(uint16_t IWDG_FLAG); + +#ifdef __cplusplus +} +#endif + +#endif /* __STM32F4xx_IWDG_H */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/inc/stm32f4xx_ltdc.h b/FWLIB/inc/stm32f4xx_ltdc.h new file mode 100644 index 0000000..d461c6d --- /dev/null +++ b/FWLIB/inc/stm32f4xx_ltdc.h @@ -0,0 +1,531 @@ +/** + ****************************************************************************** + * @file stm32f4xx_ltdc.h + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file contains all the functions prototypes for the LTDC firmware + * library. + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Define to prevent recursive inclusion -------------------------------------*/ +#ifndef __STM32F4xx_LTDC_H +#define __STM32F4xx_LTDC_H + +#ifdef __cplusplus + extern "C" { +#endif + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @addtogroup LTDC + * @{ + */ + +/* Exported types ------------------------------------------------------------*/ + +/** + * @brief LTDC Init structure definition + */ + +typedef struct +{ + uint32_t LTDC_HSPolarity; /*!< configures the horizontal synchronization polarity. + This parameter can be one value of @ref LTDC_HSPolarity */ + + uint32_t LTDC_VSPolarity; /*!< configures the vertical synchronization polarity. + This parameter can be one value of @ref LTDC_VSPolarity */ + + uint32_t LTDC_DEPolarity; /*!< configures the data enable polarity. This parameter can + be one of value of @ref LTDC_DEPolarity */ + + uint32_t LTDC_PCPolarity; /*!< configures the pixel clock polarity. This parameter can + be one of value of @ref LTDC_PCPolarity */ + + uint32_t LTDC_HorizontalSync; /*!< configures the number of Horizontal synchronization + width. This parameter must range from 0x000 to 0xFFF. */ + + uint32_t LTDC_VerticalSync; /*!< configures the number of Vertical synchronization + heigh. This parameter must range from 0x000 to 0x7FF. */ + + uint32_t LTDC_AccumulatedHBP; /*!< configures the accumulated horizontal back porch width. + This parameter must range from LTDC_HorizontalSync to 0xFFF. */ + + uint32_t LTDC_AccumulatedVBP; /*!< configures the accumulated vertical back porch heigh. + This parameter must range from LTDC_VerticalSync to 0x7FF. */ + + uint32_t LTDC_AccumulatedActiveW; /*!< configures the accumulated active width. This parameter + must range from LTDC_AccumulatedHBP to 0xFFF. */ + + uint32_t LTDC_AccumulatedActiveH; /*!< configures the accumulated active heigh. This parameter + must range from LTDC_AccumulatedVBP to 0x7FF. */ + + uint32_t LTDC_TotalWidth; /*!< configures the total width. This parameter + must range from LTDC_AccumulatedActiveW to 0xFFF. */ + + uint32_t LTDC_TotalHeigh; /*!< configures the total heigh. This parameter + must range from LTDC_AccumulatedActiveH to 0x7FF. */ + + uint32_t LTDC_BackgroundRedValue; /*!< configures the background red value. + This parameter must range from 0x00 to 0xFF. */ + + uint32_t LTDC_BackgroundGreenValue; /*!< configures the background green value. + This parameter must range from 0x00 to 0xFF. */ + + uint32_t LTDC_BackgroundBlueValue; /*!< configures the background blue value. + This parameter must range from 0x00 to 0xFF. */ +} LTDC_InitTypeDef; + +/** + * @brief LTDC Layer structure definition + */ + +typedef struct +{ + uint32_t LTDC_HorizontalStart; /*!< Configures the Window Horizontal Start Position. + This parameter must range from 0x000 to 0xFFF. */ + + uint32_t LTDC_HorizontalStop; /*!< Configures the Window Horizontal Stop Position. + This parameter must range from 0x0000 to 0xFFFF. */ + + uint32_t LTDC_VerticalStart; /*!< Configures the Window vertical Start Position. + This parameter must range from 0x000 to 0xFFF. */ + + uint32_t LTDC_VerticalStop; /*!< Configures the Window vaertical Stop Position. + This parameter must range from 0x0000 to 0xFFFF. */ + + uint32_t LTDC_PixelFormat; /*!< Specifies the pixel format. This parameter can be + one of value of @ref LTDC_Pixelformat */ + + uint32_t LTDC_ConstantAlpha; /*!< Specifies the constant alpha used for blending. + This parameter must range from 0x00 to 0xFF. */ + + uint32_t LTDC_DefaultColorBlue; /*!< Configures the default blue value. + This parameter must range from 0x00 to 0xFF. */ + + uint32_t LTDC_DefaultColorGreen; /*!< Configures the default green value. + This parameter must range from 0x00 to 0xFF. */ + + uint32_t LTDC_DefaultColorRed; /*!< Configures the default red value. + This parameter must range from 0x00 to 0xFF. */ + + uint32_t LTDC_DefaultColorAlpha; /*!< Configures the default alpha value. + This parameter must range from 0x00 to 0xFF. */ + + uint32_t LTDC_BlendingFactor_1; /*!< Select the blending factor 1. This parameter + can be one of value of @ref LTDC_BlendingFactor1 */ + + uint32_t LTDC_BlendingFactor_2; /*!< Select the blending factor 2. This parameter + can be one of value of @ref LTDC_BlendingFactor2 */ + + uint32_t LTDC_CFBStartAdress; /*!< Configures the color frame buffer address */ + + uint32_t LTDC_CFBLineLength; /*!< Configures the color frame buffer line length. + This parameter must range from 0x0000 to 0x1FFF. */ + + uint32_t LTDC_CFBPitch; /*!< Configures the color frame buffer pitch in bytes. + This parameter must range from 0x0000 to 0x1FFF. */ + + uint32_t LTDC_CFBLineNumber; /*!< Specifies the number of line in frame buffer. + This parameter must range from 0x000 to 0x7FF. */ +} LTDC_Layer_InitTypeDef; + +/** + * @brief LTDC Position structure definition + */ + +typedef struct +{ + uint32_t LTDC_POSX; /*!< Current X Position */ + uint32_t LTDC_POSY; /*!< Current Y Position */ +} LTDC_PosTypeDef; + +typedef struct +{ + uint32_t LTDC_BlueWidth; /*!< Blue width */ + uint32_t LTDC_GreenWidth; /*!< Green width */ + uint32_t LTDC_RedWidth; /*!< Red width */ +} LTDC_RGBTypeDef; + +typedef struct +{ + uint32_t LTDC_ColorKeyBlue; /*!< Configures the color key blue value. + This parameter must range from 0x00 to 0xFF. */ + + uint32_t LTDC_ColorKeyGreen; /*!< Configures the color key green value. + This parameter must range from 0x00 to 0xFF. */ + + uint32_t LTDC_ColorKeyRed; /*!< Configures the color key red value. + This parameter must range from 0x00 to 0xFF. */ +} LTDC_ColorKeying_InitTypeDef; + +typedef struct +{ + uint32_t LTDC_CLUTAdress; /*!< Configures the CLUT address. + This parameter must range from 0x00 to 0xFF. */ + + uint32_t LTDC_BlueValue; /*!< Configures the blue value. + This parameter must range from 0x00 to 0xFF. */ + + uint32_t LTDC_GreenValue; /*!< Configures the green value. + This parameter must range from 0x00 to 0xFF. */ + + uint32_t LTDC_RedValue; /*!< Configures the red value. + This parameter must range from 0x00 to 0xFF. */ +} LTDC_CLUT_InitTypeDef; + +/* Exported constants --------------------------------------------------------*/ + +/** @defgroup LTDC_Exported_Constants + * @} + */ + +/** @defgroup LTDC_SYNC + * @{ + */ + +#define LTDC_HorizontalSYNC ((uint32_t)0x00000FFF) +#define LTDC_VerticalSYNC ((uint32_t)0x000007FF) + +#define IS_LTDC_HSYNC(HSYNC) ((HSYNC) <= LTDC_HorizontalSYNC) +#define IS_LTDC_VSYNC(VSYNC) ((VSYNC) <= LTDC_VerticalSYNC) +#define IS_LTDC_AHBP(AHBP) ((AHBP) <= LTDC_HorizontalSYNC) +#define IS_LTDC_AVBP(AVBP) ((AVBP) <= LTDC_VerticalSYNC) +#define IS_LTDC_AAW(AAW) ((AAW) <= LTDC_HorizontalSYNC) +#define IS_LTDC_AAH(AAH) ((AAH) <= LTDC_VerticalSYNC) +#define IS_LTDC_TOTALW(TOTALW) ((TOTALW) <= LTDC_HorizontalSYNC) +#define IS_LTDC_TOTALH(TOTALH) ((TOTALH) <= LTDC_VerticalSYNC) + +/** + * @} + */ + +/** @defgroup LTDC_HSPolarity + * @{ + */ +#define LTDC_HSPolarity_AL ((uint32_t)0x00000000) /*!< Horizontal Synchronization is active low. */ +#define LTDC_HSPolarity_AH LTDC_GCR_HSPOL /*!< Horizontal Synchronization is active high. */ + +#define IS_LTDC_HSPOL(HSPOL) (((HSPOL) == LTDC_HSPolarity_AL) || \ + ((HSPOL) == LTDC_HSPolarity_AH)) + +/** + * @} + */ + +/** @defgroup LTDC_VSPolarity + * @{ + */ +#define LTDC_VSPolarity_AL ((uint32_t)0x00000000) /*!< Vertical Synchronization is active low. */ +#define LTDC_VSPolarity_AH LTDC_GCR_VSPOL /*!< Vertical Synchronization is active high. */ + +#define IS_LTDC_VSPOL(VSPOL) (((VSPOL) == LTDC_VSPolarity_AL) || \ + ((VSPOL) == LTDC_VSPolarity_AH)) + +/** + * @} + */ + +/** @defgroup LTDC_DEPolarity + * @{ + */ +#define LTDC_DEPolarity_AL ((uint32_t)0x00000000) /*!< Data Enable, is active low. */ +#define LTDC_DEPolarity_AH LTDC_GCR_DEPOL /*!< Data Enable, is active high. */ + +#define IS_LTDC_DEPOL(DEPOL) (((DEPOL) == LTDC_VSPolarity_AL) || \ + ((DEPOL) == LTDC_DEPolarity_AH)) + +/** + * @} + */ + +/** @defgroup LTDC_PCPolarity + * @{ + */ +#define LTDC_PCPolarity_IPC ((uint32_t)0x00000000) /*!< input pixel clock. */ +#define LTDC_PCPolarity_IIPC LTDC_GCR_PCPOL /*!< inverted input pixel clock. */ + +#define IS_LTDC_PCPOL(PCPOL) (((PCPOL) == LTDC_PCPolarity_IPC) || \ + ((PCPOL) == LTDC_PCPolarity_IIPC)) + +/** + * @} + */ + +/** @defgroup LTDC_Reload + * @{ + */ +#define LTDC_IMReload LTDC_SRCR_IMR /*!< Immediately Reload. */ +#define LTDC_VBReload LTDC_SRCR_VBR /*!< Vertical Blanking Reload. */ + +#define IS_LTDC_RELOAD(RELOAD) (((RELOAD) == LTDC_IMReload) || \ + ((RELOAD) == LTDC_VBReload)) + +/** + * @} + */ + +/** @defgroup LTDC_Back_Color + * @{ + */ + +#define LTDC_Back_Color ((uint32_t)0x000000FF) + +#define IS_LTDC_BackBlueValue(BBLUE) ((BBLUE) <= LTDC_Back_Color) +#define IS_LTDC_BackGreenValue(BGREEN) ((BGREEN) <= LTDC_Back_Color) +#define IS_LTDC_BackRedValue(BRED) ((BRED) <= LTDC_Back_Color) + +/** + * @} + */ + +/** @defgroup LTDC_Position + * @{ + */ + +#define LTDC_POS_CY LTDC_CPSR_CYPOS +#define LTDC_POS_CX LTDC_CPSR_CXPOS + +#define IS_LTDC_GET_POS(POS) (((POS) <= LTDC_POS_CY)) + + +/** + * @} + */ + +/** @defgroup LTDC_LIPosition + * @{ + */ + +#define IS_LTDC_LIPOS(LIPOS) ((LIPOS) <= 0x7FF) + +/** + * @} + */ + +/** @defgroup LTDC_CurrentStatus + * @{ + */ + +#define LTDC_CD_VDES LTDC_CDSR_VDES +#define LTDC_CD_HDES LTDC_CDSR_HDES +#define LTDC_CD_VSYNC LTDC_CDSR_VSYNCS +#define LTDC_CD_HSYNC LTDC_CDSR_HSYNCS + + +#define IS_LTDC_GET_CD(CD) (((CD) == LTDC_CD_VDES) || ((CD) == LTDC_CD_HDES) || \ + ((CD) == LTDC_CD_VSYNC) || ((CD) == LTDC_CD_HSYNC)) + + +/** + * @} + */ + +/** @defgroup LTDC_Interrupts + * @{ + */ + +#define LTDC_IT_LI LTDC_IER_LIE +#define LTDC_IT_FU LTDC_IER_FUIE +#define LTDC_IT_TERR LTDC_IER_TERRIE +#define LTDC_IT_RR LTDC_IER_RRIE + +#define IS_LTDC_IT(IT) ((((IT) & (uint32_t)0xFFFFFFF0) == 0x00) && ((IT) != 0x00)) + +/** + * @} + */ + +/** @defgroup LTDC_Flag + * @{ + */ + +#define LTDC_FLAG_LI LTDC_ISR_LIF +#define LTDC_FLAG_FU LTDC_ISR_FUIF +#define LTDC_FLAG_TERR LTDC_ISR_TERRIF +#define LTDC_FLAG_RR LTDC_ISR_RRIF + + +#define IS_LTDC_FLAG(FLAG) (((FLAG) == LTDC_FLAG_LI) || ((FLAG) == LTDC_FLAG_FU) || \ + ((FLAG) == LTDC_FLAG_TERR) || ((FLAG) == LTDC_FLAG_RR)) + +/** + * @} + */ + +/** @defgroup LTDC_Pixelformat + * @{ + */ +#define LTDC_Pixelformat_ARGB8888 ((uint32_t)0x00000000) +#define LTDC_Pixelformat_RGB888 ((uint32_t)0x00000001) +#define LTDC_Pixelformat_RGB565 ((uint32_t)0x00000002) +#define LTDC_Pixelformat_ARGB1555 ((uint32_t)0x00000003) +#define LTDC_Pixelformat_ARGB4444 ((uint32_t)0x00000004) +#define LTDC_Pixelformat_L8 ((uint32_t)0x00000005) +#define LTDC_Pixelformat_AL44 ((uint32_t)0x00000006) +#define LTDC_Pixelformat_AL88 ((uint32_t)0x00000007) + +#define IS_LTDC_Pixelformat(Pixelformat) (((Pixelformat) == LTDC_Pixelformat_ARGB8888) || ((Pixelformat) == LTDC_Pixelformat_RGB888) || \ + ((Pixelformat) == LTDC_Pixelformat_RGB565) || ((Pixelformat) == LTDC_Pixelformat_ARGB1555) || \ + ((Pixelformat) == LTDC_Pixelformat_ARGB4444) || ((Pixelformat) == LTDC_Pixelformat_L8) || \ + ((Pixelformat) == LTDC_Pixelformat_AL44) || ((Pixelformat) == LTDC_Pixelformat_AL88)) + +/** + * @} + */ + +/** @defgroup LTDC_BlendingFactor1 + * @{ + */ + +#define LTDC_BlendingFactor1_CA ((uint32_t)0x00000400) +#define LTDC_BlendingFactor1_PAxCA ((uint32_t)0x00000600) + +#define IS_LTDC_BlendingFactor1(BlendingFactor1) (((BlendingFactor1) == LTDC_BlendingFactor1_CA) || ((BlendingFactor1) == LTDC_BlendingFactor1_PAxCA)) + +/** + * @} + */ + +/** @defgroup LTDC_BlendingFactor2 + * @{ + */ + +#define LTDC_BlendingFactor2_CA ((uint32_t)0x00000005) +#define LTDC_BlendingFactor2_PAxCA ((uint32_t)0x00000007) + +#define IS_LTDC_BlendingFactor2(BlendingFactor2) (((BlendingFactor2) == LTDC_BlendingFactor2_CA) || ((BlendingFactor2) == LTDC_BlendingFactor2_PAxCA)) + + +/** + * @} + */ + + +/** @defgroup LTDC_LAYER_Config + * @{ + */ + +#define LTDC_STOPPosition ((uint32_t)0x0000FFFF) +#define LTDC_STARTPosition ((uint32_t)0x00000FFF) + +#define LTDC_DefaultColorConfig ((uint32_t)0x000000FF) +#define LTDC_ColorFrameBuffer ((uint32_t)0x00001FFF) +#define LTDC_LineNumber ((uint32_t)0x000007FF) + +#define IS_LTDC_HCONFIGST(HCONFIGST) ((HCONFIGST) <= LTDC_STARTPosition) +#define IS_LTDC_HCONFIGSP(HCONFIGSP) ((HCONFIGSP) <= LTDC_STOPPosition) +#define IS_LTDC_VCONFIGST(VCONFIGST) ((VCONFIGST) <= LTDC_STARTPosition) +#define IS_LTDC_VCONFIGSP(VCONFIGSP) ((VCONFIGSP) <= LTDC_STOPPosition) + +#define IS_LTDC_DEFAULTCOLOR(DEFAULTCOLOR) ((DEFAULTCOLOR) <= LTDC_DefaultColorConfig) + +#define IS_LTDC_CFBP(CFBP) ((CFBP) <= LTDC_ColorFrameBuffer) +#define IS_LTDC_CFBLL(CFBLL) ((CFBLL) <= LTDC_ColorFrameBuffer) + +#define IS_LTDC_CFBLNBR(CFBLNBR) ((CFBLNBR) <= LTDC_LineNumber) + + + +/** + * @} + */ + +/** @defgroup LTDC_colorkeying_Config + * @{ + */ + +#define LTDC_colorkeyingConfig ((uint32_t)0x000000FF) + +#define IS_LTDC_CKEYING(CKEYING) ((CKEYING) <= LTDC_colorkeyingConfig) + + +/** + * @} + */ + +/** @defgroup LTDC_CLUT_Config + * @{ + */ + +#define LTDC_CLUTWR ((uint32_t)0x000000FF) + +#define IS_LTDC_CLUTWR(CLUTWR) ((CLUTWR) <= LTDC_CLUTWR) + +/* Exported macro ------------------------------------------------------------*/ +/* Exported functions ------------------------------------------------------- */ + +/* Function used to set the LTDC configuration to the default reset state *****/ +void LTDC_DeInit(void); + +/* Initialization and Configuration functions *********************************/ +void LTDC_Init(LTDC_InitTypeDef* LTDC_InitStruct); +void LTDC_StructInit(LTDC_InitTypeDef* LTDC_InitStruct); +void LTDC_Cmd(FunctionalState NewState); +void LTDC_DitherCmd(FunctionalState NewState); +LTDC_RGBTypeDef LTDC_GetRGBWidth(void); +void LTDC_RGBStructInit(LTDC_RGBTypeDef* LTDC_RGB_InitStruct); +void LTDC_LIPConfig(uint32_t LTDC_LIPositionConfig); +void LTDC_ReloadConfig(uint32_t LTDC_Reload); +void LTDC_LayerInit(LTDC_Layer_TypeDef* LTDC_Layerx, LTDC_Layer_InitTypeDef* LTDC_Layer_InitStruct); +void LTDC_LayerStructInit(LTDC_Layer_InitTypeDef * LTDC_Layer_InitStruct); +void LTDC_LayerCmd(LTDC_Layer_TypeDef* LTDC_Layerx, FunctionalState NewState); +LTDC_PosTypeDef LTDC_GetPosStatus(void); +void LTDC_PosStructInit(LTDC_PosTypeDef* LTDC_Pos_InitStruct); +FlagStatus LTDC_GetCDStatus(uint32_t LTDC_CD); +void LTDC_ColorKeyingConfig(LTDC_Layer_TypeDef* LTDC_Layerx, LTDC_ColorKeying_InitTypeDef* LTDC_colorkeying_InitStruct, FunctionalState NewState); +void LTDC_ColorKeyingStructInit(LTDC_ColorKeying_InitTypeDef* LTDC_colorkeying_InitStruct); +void LTDC_CLUTCmd(LTDC_Layer_TypeDef* LTDC_Layerx, FunctionalState NewState); +void LTDC_CLUTInit(LTDC_Layer_TypeDef* LTDC_Layerx, LTDC_CLUT_InitTypeDef* LTDC_CLUT_InitStruct); +void LTDC_CLUTStructInit(LTDC_CLUT_InitTypeDef* LTDC_CLUT_InitStruct); +void LTDC_LayerPosition(LTDC_Layer_TypeDef* LTDC_Layerx, uint16_t OffsetX, uint16_t OffsetY); +void LTDC_LayerAlpha(LTDC_Layer_TypeDef* LTDC_Layerx, uint8_t ConstantAlpha); +void LTDC_LayerAddress(LTDC_Layer_TypeDef* LTDC_Layerx, uint32_t Address); +void LTDC_LayerSize(LTDC_Layer_TypeDef* LTDC_Layerx, uint32_t Width, uint32_t Height); +void LTDC_LayerPixelFormat(LTDC_Layer_TypeDef* LTDC_Layerx, uint32_t PixelFormat); + +/* Interrupts and flags management functions **********************************/ +void LTDC_ITConfig(uint32_t LTDC_IT, FunctionalState NewState); +FlagStatus LTDC_GetFlagStatus(uint32_t LTDC_FLAG); +void LTDC_ClearFlag(uint32_t LTDC_FLAG); +ITStatus LTDC_GetITStatus(uint32_t LTDC_IT); +void LTDC_ClearITPendingBit(uint32_t LTDC_IT); + +#ifdef __cplusplus +} +#endif + +#endif /* __STM32F4xx_LTDC_H */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/inc/stm32f4xx_pwr.h b/FWLIB/inc/stm32f4xx_pwr.h new file mode 100644 index 0000000..20b1fe9 --- /dev/null +++ b/FWLIB/inc/stm32f4xx_pwr.h @@ -0,0 +1,212 @@ +/** + ****************************************************************************** + * @file stm32f4xx_pwr.h + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file contains all the functions prototypes for the PWR firmware + * library. + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Define to prevent recursive inclusion -------------------------------------*/ +#ifndef __STM32F4xx_PWR_H +#define __STM32F4xx_PWR_H + +#ifdef __cplusplus + extern "C" { +#endif + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @addtogroup PWR + * @{ + */ + +/* Exported types ------------------------------------------------------------*/ +/* Exported constants --------------------------------------------------------*/ + +/** @defgroup PWR_Exported_Constants + * @{ + */ + +/** @defgroup PWR_PVD_detection_level + * @{ + */ +#define PWR_PVDLevel_0 PWR_CR_PLS_LEV0 +#define PWR_PVDLevel_1 PWR_CR_PLS_LEV1 +#define PWR_PVDLevel_2 PWR_CR_PLS_LEV2 +#define PWR_PVDLevel_3 PWR_CR_PLS_LEV3 +#define PWR_PVDLevel_4 PWR_CR_PLS_LEV4 +#define PWR_PVDLevel_5 PWR_CR_PLS_LEV5 +#define PWR_PVDLevel_6 PWR_CR_PLS_LEV6 +#define PWR_PVDLevel_7 PWR_CR_PLS_LEV7 + +#define IS_PWR_PVD_LEVEL(LEVEL) (((LEVEL) == PWR_PVDLevel_0) || ((LEVEL) == PWR_PVDLevel_1)|| \ + ((LEVEL) == PWR_PVDLevel_2) || ((LEVEL) == PWR_PVDLevel_3)|| \ + ((LEVEL) == PWR_PVDLevel_4) || ((LEVEL) == PWR_PVDLevel_5)|| \ + ((LEVEL) == PWR_PVDLevel_6) || ((LEVEL) == PWR_PVDLevel_7)) +/** + * @} + */ + + +/** @defgroup PWR_Regulator_state_in_STOP_mode + * @{ + */ +#define PWR_MainRegulator_ON ((uint32_t)0x00000000) +#define PWR_LowPowerRegulator_ON PWR_CR_LPDS + +/* --- PWR_Legacy ---*/ +#define PWR_Regulator_ON PWR_MainRegulator_ON +#define PWR_Regulator_LowPower PWR_LowPowerRegulator_ON + +#define IS_PWR_REGULATOR(REGULATOR) (((REGULATOR) == PWR_MainRegulator_ON) || \ + ((REGULATOR) == PWR_LowPowerRegulator_ON)) + +/** + * @} + */ + +/** @defgroup PWR_Regulator_state_in_UnderDrive_mode + * @{ + */ +#define PWR_MainRegulator_UnderDrive_ON PWR_CR_MRUDS +#define PWR_LowPowerRegulator_UnderDrive_ON ((uint32_t)(PWR_CR_LPDS | PWR_CR_LPUDS)) + +#define IS_PWR_REGULATOR_UNDERDRIVE(REGULATOR) (((REGULATOR) == PWR_MainRegulator_UnderDrive_ON) || \ + ((REGULATOR) == PWR_LowPowerRegulator_UnderDrive_ON)) + +/** + * @} + */ + +/** @defgroup PWR_STOP_mode_entry + * @{ + */ +#define PWR_STOPEntry_WFI ((uint8_t)0x01) +#define PWR_STOPEntry_WFE ((uint8_t)0x02) +#define IS_PWR_STOP_ENTRY(ENTRY) (((ENTRY) == PWR_STOPEntry_WFI) || ((ENTRY) == PWR_STOPEntry_WFE)) +/** + * @} + */ + +/** @defgroup PWR_Regulator_Voltage_Scale + * @{ + */ +#define PWR_Regulator_Voltage_Scale1 ((uint32_t)0x0000C000) +#define PWR_Regulator_Voltage_Scale2 ((uint32_t)0x00008000) +#define PWR_Regulator_Voltage_Scale3 ((uint32_t)0x00004000) +#define IS_PWR_REGULATOR_VOLTAGE(VOLTAGE) (((VOLTAGE) == PWR_Regulator_Voltage_Scale1) || \ + ((VOLTAGE) == PWR_Regulator_Voltage_Scale2) || \ + ((VOLTAGE) == PWR_Regulator_Voltage_Scale3)) +/** + * @} + */ + +/** @defgroup PWR_Flag + * @{ + */ +#define PWR_FLAG_WU PWR_CSR_WUF +#define PWR_FLAG_SB PWR_CSR_SBF +#define PWR_FLAG_PVDO PWR_CSR_PVDO +#define PWR_FLAG_BRR PWR_CSR_BRR +#define PWR_FLAG_VOSRDY PWR_CSR_VOSRDY +#define PWR_FLAG_ODRDY PWR_CSR_ODRDY +#define PWR_FLAG_ODSWRDY PWR_CSR_ODSWRDY +#define PWR_FLAG_UDRDY PWR_CSR_UDSWRDY + +/* --- FLAG Legacy ---*/ +#define PWR_FLAG_REGRDY PWR_FLAG_VOSRDY + +#define IS_PWR_GET_FLAG(FLAG) (((FLAG) == PWR_FLAG_WU) || ((FLAG) == PWR_FLAG_SB) || \ + ((FLAG) == PWR_FLAG_PVDO) || ((FLAG) == PWR_FLAG_BRR) || \ + ((FLAG) == PWR_FLAG_VOSRDY) || ((FLAG) == PWR_FLAG_ODRDY) || \ + ((FLAG) == PWR_FLAG_ODSWRDY) || ((FLAG) == PWR_FLAG_UDRDY)) + + +#define IS_PWR_CLEAR_FLAG(FLAG) (((FLAG) == PWR_FLAG_WU) || ((FLAG) == PWR_FLAG_SB) || \ + ((FLAG) == PWR_FLAG_UDRDY)) + +/** + * @} + */ + +/** + * @} + */ + +/* Exported macro ------------------------------------------------------------*/ +/* Exported functions --------------------------------------------------------*/ + +/* Function used to set the PWR configuration to the default reset state ******/ +void PWR_DeInit(void); + +/* Backup Domain Access function **********************************************/ +void PWR_BackupAccessCmd(FunctionalState NewState); + +/* PVD configuration functions ************************************************/ +void PWR_PVDLevelConfig(uint32_t PWR_PVDLevel); +void PWR_PVDCmd(FunctionalState NewState); + +/* WakeUp pins configuration functions ****************************************/ +void PWR_WakeUpPinCmd(FunctionalState NewState); + +/* Main and Backup Regulators configuration functions *************************/ +void PWR_BackupRegulatorCmd(FunctionalState NewState); +void PWR_MainRegulatorModeConfig(uint32_t PWR_Regulator_Voltage); +void PWR_OverDriveCmd(FunctionalState NewState); +void PWR_OverDriveSWCmd(FunctionalState NewState); +void PWR_UnderDriveCmd(FunctionalState NewState); +void PWR_MainRegulatorLowVoltageCmd(FunctionalState NewState); +void PWR_LowRegulatorLowVoltageCmd(FunctionalState NewState); + +/* FLASH Power Down configuration functions ***********************************/ +void PWR_FlashPowerDownCmd(FunctionalState NewState); + +/* Low Power modes configuration functions ************************************/ +void PWR_EnterSTOPMode(uint32_t PWR_Regulator, uint8_t PWR_STOPEntry); +void PWR_EnterUnderDriveSTOPMode(uint32_t PWR_Regulator, uint8_t PWR_STOPEntry); +void PWR_EnterSTANDBYMode(void); + +/* Flags management functions *************************************************/ +FlagStatus PWR_GetFlagStatus(uint32_t PWR_FLAG); +void PWR_ClearFlag(uint32_t PWR_FLAG); + +#ifdef __cplusplus +} +#endif + +#endif /* __STM32F4xx_PWR_H */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/inc/stm32f4xx_rcc.h b/FWLIB/inc/stm32f4xx_rcc.h new file mode 100644 index 0000000..2a77e33 --- /dev/null +++ b/FWLIB/inc/stm32f4xx_rcc.h @@ -0,0 +1,630 @@ +/** + ****************************************************************************** + * @file stm32f4xx_rcc.h + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file contains all the functions prototypes for the RCC firmware library. + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Define to prevent recursive inclusion -------------------------------------*/ +#ifndef __STM32F4xx_RCC_H +#define __STM32F4xx_RCC_H + +#ifdef __cplusplus + extern "C" { +#endif + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @addtogroup RCC + * @{ + */ + +/* Exported types ------------------------------------------------------------*/ +typedef struct +{ + uint32_t SYSCLK_Frequency; /*!< SYSCLK clock frequency expressed in Hz */ + uint32_t HCLK_Frequency; /*!< HCLK clock frequency expressed in Hz */ + uint32_t PCLK1_Frequency; /*!< PCLK1 clock frequency expressed in Hz */ + uint32_t PCLK2_Frequency; /*!< PCLK2 clock frequency expressed in Hz */ +}RCC_ClocksTypeDef; + +/* Exported constants --------------------------------------------------------*/ + +/** @defgroup RCC_Exported_Constants + * @{ + */ + +/** @defgroup RCC_HSE_configuration + * @{ + */ +#define RCC_HSE_OFF ((uint8_t)0x00) +#define RCC_HSE_ON ((uint8_t)0x01) +#define RCC_HSE_Bypass ((uint8_t)0x05) +#define IS_RCC_HSE(HSE) (((HSE) == RCC_HSE_OFF) || ((HSE) == RCC_HSE_ON) || \ + ((HSE) == RCC_HSE_Bypass)) +/** + * @} + */ + +/** @defgroup RCC_LSE_Dual_Mode_Selection + * @{ + */ +#define RCC_LSE_LOWPOWER_MODE ((uint8_t)0x00) +#define RCC_LSE_HIGHDRIVE_MODE ((uint8_t)0x01) +#define IS_RCC_LSE_MODE(MODE) (((MODE) == RCC_LSE_LOWPOWER_MODE) || \ + ((MODE) == RCC_LSE_HIGHDRIVE_MODE)) +/** + * @} + */ + +/** @defgroup RCC_PLL_Clock_Source + * @{ + */ +#define RCC_PLLSource_HSI ((uint32_t)0x00000000) +#define RCC_PLLSource_HSE ((uint32_t)0x00400000) +#define IS_RCC_PLL_SOURCE(SOURCE) (((SOURCE) == RCC_PLLSource_HSI) || \ + ((SOURCE) == RCC_PLLSource_HSE)) +#define IS_RCC_PLLM_VALUE(VALUE) ((VALUE) <= 63) +#define IS_RCC_PLLN_VALUE(VALUE) ((192 <= (VALUE)) && ((VALUE) <= 432)) +#define IS_RCC_PLLP_VALUE(VALUE) (((VALUE) == 2) || ((VALUE) == 4) || ((VALUE) == 6) || ((VALUE) == 8)) +#define IS_RCC_PLLQ_VALUE(VALUE) ((4 <= (VALUE)) && ((VALUE) <= 15)) + +#define IS_RCC_PLLI2SN_VALUE(VALUE) ((192 <= (VALUE)) && ((VALUE) <= 432)) +#define IS_RCC_PLLI2SR_VALUE(VALUE) ((2 <= (VALUE)) && ((VALUE) <= 7)) +#define IS_RCC_PLLI2SM_VALUE(VALUE) ((VALUE) <= 63) + +#define IS_RCC_PLLI2SQ_VALUE(VALUE) ((2 <= (VALUE)) && ((VALUE) <= 15)) +#define IS_RCC_PLLSAIN_VALUE(VALUE) ((192 <= (VALUE)) && ((VALUE) <= 432)) +#define IS_RCC_PLLSAIQ_VALUE(VALUE) ((2 <= (VALUE)) && ((VALUE) <= 15)) +#define IS_RCC_PLLSAIR_VALUE(VALUE) ((2 <= (VALUE)) && ((VALUE) <= 7)) + +#define IS_RCC_PLLSAI_DIVQ_VALUE(VALUE) ((1 <= (VALUE)) && ((VALUE) <= 32)) +#define IS_RCC_PLLI2S_DIVQ_VALUE(VALUE) ((1 <= (VALUE)) && ((VALUE) <= 32)) + +#define RCC_PLLSAIDivR_Div2 ((uint32_t)0x00000000) +#define RCC_PLLSAIDivR_Div4 ((uint32_t)0x00010000) +#define RCC_PLLSAIDivR_Div8 ((uint32_t)0x00020000) +#define RCC_PLLSAIDivR_Div16 ((uint32_t)0x00030000) +#define IS_RCC_PLLSAI_DIVR_VALUE(VALUE) (((VALUE) == RCC_PLLSAIDivR_Div2) ||\ + ((VALUE) == RCC_PLLSAIDivR_Div4) ||\ + ((VALUE) == RCC_PLLSAIDivR_Div8) ||\ + ((VALUE) == RCC_PLLSAIDivR_Div16)) + +/** + * @} + */ + +/** @defgroup RCC_System_Clock_Source + * @{ + */ +#define RCC_SYSCLKSource_HSI ((uint32_t)0x00000000) +#define RCC_SYSCLKSource_HSE ((uint32_t)0x00000001) +#define RCC_SYSCLKSource_PLLCLK ((uint32_t)0x00000002) +#define IS_RCC_SYSCLK_SOURCE(SOURCE) (((SOURCE) == RCC_SYSCLKSource_HSI) || \ + ((SOURCE) == RCC_SYSCLKSource_HSE) || \ + ((SOURCE) == RCC_SYSCLKSource_PLLCLK)) +/** + * @} + */ + +/** @defgroup RCC_AHB_Clock_Source + * @{ + */ +#define RCC_SYSCLK_Div1 ((uint32_t)0x00000000) +#define RCC_SYSCLK_Div2 ((uint32_t)0x00000080) +#define RCC_SYSCLK_Div4 ((uint32_t)0x00000090) +#define RCC_SYSCLK_Div8 ((uint32_t)0x000000A0) +#define RCC_SYSCLK_Div16 ((uint32_t)0x000000B0) +#define RCC_SYSCLK_Div64 ((uint32_t)0x000000C0) +#define RCC_SYSCLK_Div128 ((uint32_t)0x000000D0) +#define RCC_SYSCLK_Div256 ((uint32_t)0x000000E0) +#define RCC_SYSCLK_Div512 ((uint32_t)0x000000F0) +#define IS_RCC_HCLK(HCLK) (((HCLK) == RCC_SYSCLK_Div1) || ((HCLK) == RCC_SYSCLK_Div2) || \ + ((HCLK) == RCC_SYSCLK_Div4) || ((HCLK) == RCC_SYSCLK_Div8) || \ + ((HCLK) == RCC_SYSCLK_Div16) || ((HCLK) == RCC_SYSCLK_Div64) || \ + ((HCLK) == RCC_SYSCLK_Div128) || ((HCLK) == RCC_SYSCLK_Div256) || \ + ((HCLK) == RCC_SYSCLK_Div512)) +/** + * @} + */ + +/** @defgroup RCC_APB1_APB2_Clock_Source + * @{ + */ +#define RCC_HCLK_Div1 ((uint32_t)0x00000000) +#define RCC_HCLK_Div2 ((uint32_t)0x00001000) +#define RCC_HCLK_Div4 ((uint32_t)0x00001400) +#define RCC_HCLK_Div8 ((uint32_t)0x00001800) +#define RCC_HCLK_Div16 ((uint32_t)0x00001C00) +#define IS_RCC_PCLK(PCLK) (((PCLK) == RCC_HCLK_Div1) || ((PCLK) == RCC_HCLK_Div2) || \ + ((PCLK) == RCC_HCLK_Div4) || ((PCLK) == RCC_HCLK_Div8) || \ + ((PCLK) == RCC_HCLK_Div16)) +/** + * @} + */ + +/** @defgroup RCC_Interrupt_Source + * @{ + */ +#define RCC_IT_LSIRDY ((uint8_t)0x01) +#define RCC_IT_LSERDY ((uint8_t)0x02) +#define RCC_IT_HSIRDY ((uint8_t)0x04) +#define RCC_IT_HSERDY ((uint8_t)0x08) +#define RCC_IT_PLLRDY ((uint8_t)0x10) +#define RCC_IT_PLLI2SRDY ((uint8_t)0x20) +#define RCC_IT_PLLSAIRDY ((uint8_t)0x40) +#define RCC_IT_CSS ((uint8_t)0x80) + +#define IS_RCC_IT(IT) ((((IT) & (uint8_t)0x80) == 0x00) && ((IT) != 0x00)) +#define IS_RCC_GET_IT(IT) (((IT) == RCC_IT_LSIRDY) || ((IT) == RCC_IT_LSERDY) || \ + ((IT) == RCC_IT_HSIRDY) || ((IT) == RCC_IT_HSERDY) || \ + ((IT) == RCC_IT_PLLRDY) || ((IT) == RCC_IT_CSS) || \ + ((IT) == RCC_IT_PLLSAIRDY) || ((IT) == RCC_IT_PLLI2SRDY)) +#define IS_RCC_CLEAR_IT(IT)((IT) != 0x00) + +/** + * @} + */ + +/** @defgroup RCC_LSE_Configuration + * @{ + */ +#define RCC_LSE_OFF ((uint8_t)0x00) +#define RCC_LSE_ON ((uint8_t)0x01) +#define RCC_LSE_Bypass ((uint8_t)0x04) +#define IS_RCC_LSE(LSE) (((LSE) == RCC_LSE_OFF) || ((LSE) == RCC_LSE_ON) || \ + ((LSE) == RCC_LSE_Bypass)) +/** + * @} + */ + +/** @defgroup RCC_RTC_Clock_Source + * @{ + */ +#define RCC_RTCCLKSource_LSE ((uint32_t)0x00000100) +#define RCC_RTCCLKSource_LSI ((uint32_t)0x00000200) +#define RCC_RTCCLKSource_HSE_Div2 ((uint32_t)0x00020300) +#define RCC_RTCCLKSource_HSE_Div3 ((uint32_t)0x00030300) +#define RCC_RTCCLKSource_HSE_Div4 ((uint32_t)0x00040300) +#define RCC_RTCCLKSource_HSE_Div5 ((uint32_t)0x00050300) +#define RCC_RTCCLKSource_HSE_Div6 ((uint32_t)0x00060300) +#define RCC_RTCCLKSource_HSE_Div7 ((uint32_t)0x00070300) +#define RCC_RTCCLKSource_HSE_Div8 ((uint32_t)0x00080300) +#define RCC_RTCCLKSource_HSE_Div9 ((uint32_t)0x00090300) +#define RCC_RTCCLKSource_HSE_Div10 ((uint32_t)0x000A0300) +#define RCC_RTCCLKSource_HSE_Div11 ((uint32_t)0x000B0300) +#define RCC_RTCCLKSource_HSE_Div12 ((uint32_t)0x000C0300) +#define RCC_RTCCLKSource_HSE_Div13 ((uint32_t)0x000D0300) +#define RCC_RTCCLKSource_HSE_Div14 ((uint32_t)0x000E0300) +#define RCC_RTCCLKSource_HSE_Div15 ((uint32_t)0x000F0300) +#define RCC_RTCCLKSource_HSE_Div16 ((uint32_t)0x00100300) +#define RCC_RTCCLKSource_HSE_Div17 ((uint32_t)0x00110300) +#define RCC_RTCCLKSource_HSE_Div18 ((uint32_t)0x00120300) +#define RCC_RTCCLKSource_HSE_Div19 ((uint32_t)0x00130300) +#define RCC_RTCCLKSource_HSE_Div20 ((uint32_t)0x00140300) +#define RCC_RTCCLKSource_HSE_Div21 ((uint32_t)0x00150300) +#define RCC_RTCCLKSource_HSE_Div22 ((uint32_t)0x00160300) +#define RCC_RTCCLKSource_HSE_Div23 ((uint32_t)0x00170300) +#define RCC_RTCCLKSource_HSE_Div24 ((uint32_t)0x00180300) +#define RCC_RTCCLKSource_HSE_Div25 ((uint32_t)0x00190300) +#define RCC_RTCCLKSource_HSE_Div26 ((uint32_t)0x001A0300) +#define RCC_RTCCLKSource_HSE_Div27 ((uint32_t)0x001B0300) +#define RCC_RTCCLKSource_HSE_Div28 ((uint32_t)0x001C0300) +#define RCC_RTCCLKSource_HSE_Div29 ((uint32_t)0x001D0300) +#define RCC_RTCCLKSource_HSE_Div30 ((uint32_t)0x001E0300) +#define RCC_RTCCLKSource_HSE_Div31 ((uint32_t)0x001F0300) +#define IS_RCC_RTCCLK_SOURCE(SOURCE) (((SOURCE) == RCC_RTCCLKSource_LSE) || \ + ((SOURCE) == RCC_RTCCLKSource_LSI) || \ + ((SOURCE) == RCC_RTCCLKSource_HSE_Div2) || \ + ((SOURCE) == RCC_RTCCLKSource_HSE_Div3) || \ + ((SOURCE) == RCC_RTCCLKSource_HSE_Div4) || \ + ((SOURCE) == RCC_RTCCLKSource_HSE_Div5) || \ + ((SOURCE) == RCC_RTCCLKSource_HSE_Div6) || \ + ((SOURCE) == RCC_RTCCLKSource_HSE_Div7) || \ + ((SOURCE) == RCC_RTCCLKSource_HSE_Div8) || \ + ((SOURCE) == RCC_RTCCLKSource_HSE_Div9) || \ + ((SOURCE) == RCC_RTCCLKSource_HSE_Div10) || \ + ((SOURCE) == RCC_RTCCLKSource_HSE_Div11) || \ + ((SOURCE) == RCC_RTCCLKSource_HSE_Div12) || \ + ((SOURCE) == RCC_RTCCLKSource_HSE_Div13) || \ + ((SOURCE) == RCC_RTCCLKSource_HSE_Div14) || \ + ((SOURCE) == RCC_RTCCLKSource_HSE_Div15) || \ + ((SOURCE) == RCC_RTCCLKSource_HSE_Div16) || \ + ((SOURCE) == RCC_RTCCLKSource_HSE_Div17) || \ + ((SOURCE) == RCC_RTCCLKSource_HSE_Div18) || \ + ((SOURCE) == RCC_RTCCLKSource_HSE_Div19) || \ + ((SOURCE) == RCC_RTCCLKSource_HSE_Div20) || \ + ((SOURCE) == RCC_RTCCLKSource_HSE_Div21) || \ + ((SOURCE) == RCC_RTCCLKSource_HSE_Div22) || \ + ((SOURCE) == RCC_RTCCLKSource_HSE_Div23) || \ + ((SOURCE) == RCC_RTCCLKSource_HSE_Div24) || \ + ((SOURCE) == RCC_RTCCLKSource_HSE_Div25) || \ + ((SOURCE) == RCC_RTCCLKSource_HSE_Div26) || \ + ((SOURCE) == RCC_RTCCLKSource_HSE_Div27) || \ + ((SOURCE) == RCC_RTCCLKSource_HSE_Div28) || \ + ((SOURCE) == RCC_RTCCLKSource_HSE_Div29) || \ + ((SOURCE) == RCC_RTCCLKSource_HSE_Div30) || \ + ((SOURCE) == RCC_RTCCLKSource_HSE_Div31)) +/** + * @} + */ + +/** @defgroup RCC_I2S_Clock_Source + * @{ + */ +#define RCC_I2S2CLKSource_PLLI2S ((uint8_t)0x00) +#define RCC_I2S2CLKSource_Ext ((uint8_t)0x01) + +#define IS_RCC_I2SCLK_SOURCE(SOURCE) (((SOURCE) == RCC_I2S2CLKSource_PLLI2S) || ((SOURCE) == RCC_I2S2CLKSource_Ext)) +/** + * @} + */ + +/** @defgroup RCC_SAI_BlockA_Clock_Source + * @{ + */ +#define RCC_SAIACLKSource_PLLSAI ((uint32_t)0x00000000) +#define RCC_SAIACLKSource_PLLI2S ((uint32_t)0x00100000) +#define RCC_SAIACLKSource_Ext ((uint32_t)0x00200000) + +#define IS_RCC_SAIACLK_SOURCE(SOURCE) (((SOURCE) == RCC_SAIACLKSource_PLLI2S) ||\ + ((SOURCE) == RCC_SAIACLKSource_PLLSAI) ||\ + ((SOURCE) == RCC_SAIACLKSource_Ext)) +/** + * @} + */ + +/** @defgroup RCC_SAI_BlockB_Clock_Source + * @{ + */ +#define RCC_SAIBCLKSource_PLLSAI ((uint32_t)0x00000000) +#define RCC_SAIBCLKSource_PLLI2S ((uint32_t)0x00400000) +#define RCC_SAIBCLKSource_Ext ((uint32_t)0x00800000) + +#define IS_RCC_SAIBCLK_SOURCE(SOURCE) (((SOURCE) == RCC_SAIBCLKSource_PLLI2S) ||\ + ((SOURCE) == RCC_SAIBCLKSource_PLLSAI) ||\ + ((SOURCE) == RCC_SAIBCLKSource_Ext)) +/** + * @} + */ + +/** @defgroup RCC_TIM_PRescaler_Selection + * @{ + */ +#define RCC_TIMPrescDesactivated ((uint8_t)0x00) +#define RCC_TIMPrescActivated ((uint8_t)0x01) + +#define IS_RCC_TIMCLK_PRESCALER(VALUE) (((VALUE) == RCC_TIMPrescDesactivated) || ((VALUE) == RCC_TIMPrescActivated)) +/** + * @} + */ + +/** @defgroup RCC_AHB1_Peripherals + * @{ + */ +#define RCC_AHB1Periph_GPIOA ((uint32_t)0x00000001) +#define RCC_AHB1Periph_GPIOB ((uint32_t)0x00000002) +#define RCC_AHB1Periph_GPIOC ((uint32_t)0x00000004) +#define RCC_AHB1Periph_GPIOD ((uint32_t)0x00000008) +#define RCC_AHB1Periph_GPIOE ((uint32_t)0x00000010) +#define RCC_AHB1Periph_GPIOF ((uint32_t)0x00000020) +#define RCC_AHB1Periph_GPIOG ((uint32_t)0x00000040) +#define RCC_AHB1Periph_GPIOH ((uint32_t)0x00000080) +#define RCC_AHB1Periph_GPIOI ((uint32_t)0x00000100) +#define RCC_AHB1Periph_GPIOJ ((uint32_t)0x00000200) +#define RCC_AHB1Periph_GPIOK ((uint32_t)0x00000400) +#define RCC_AHB1Periph_CRC ((uint32_t)0x00001000) +#define RCC_AHB1Periph_FLITF ((uint32_t)0x00008000) +#define RCC_AHB1Periph_SRAM1 ((uint32_t)0x00010000) +#define RCC_AHB1Periph_SRAM2 ((uint32_t)0x00020000) +#define RCC_AHB1Periph_BKPSRAM ((uint32_t)0x00040000) +#define RCC_AHB1Periph_SRAM3 ((uint32_t)0x00080000) +#define RCC_AHB1Periph_CCMDATARAMEN ((uint32_t)0x00100000) +#define RCC_AHB1Periph_DMA1 ((uint32_t)0x00200000) +#define RCC_AHB1Periph_DMA2 ((uint32_t)0x00400000) +#define RCC_AHB1Periph_DMA2D ((uint32_t)0x00800000) +#define RCC_AHB1Periph_ETH_MAC ((uint32_t)0x02000000) +#define RCC_AHB1Periph_ETH_MAC_Tx ((uint32_t)0x04000000) +#define RCC_AHB1Periph_ETH_MAC_Rx ((uint32_t)0x08000000) +#define RCC_AHB1Periph_ETH_MAC_PTP ((uint32_t)0x10000000) +#define RCC_AHB1Periph_OTG_HS ((uint32_t)0x20000000) +#define RCC_AHB1Periph_OTG_HS_ULPI ((uint32_t)0x40000000) + +#define IS_RCC_AHB1_CLOCK_PERIPH(PERIPH) ((((PERIPH) & 0x810BE800) == 0x00) && ((PERIPH) != 0x00)) +#define IS_RCC_AHB1_RESET_PERIPH(PERIPH) ((((PERIPH) & 0xDD1FE800) == 0x00) && ((PERIPH) != 0x00)) +#define IS_RCC_AHB1_LPMODE_PERIPH(PERIPH) ((((PERIPH) & 0x81106800) == 0x00) && ((PERIPH) != 0x00)) + +/** + * @} + */ + +/** @defgroup RCC_AHB2_Peripherals + * @{ + */ +#define RCC_AHB2Periph_DCMI ((uint32_t)0x00000001) +#define RCC_AHB2Periph_CRYP ((uint32_t)0x00000010) +#define RCC_AHB2Periph_HASH ((uint32_t)0x00000020) +#define RCC_AHB2Periph_RNG ((uint32_t)0x00000040) +#define RCC_AHB2Periph_OTG_FS ((uint32_t)0x00000080) +#define IS_RCC_AHB2_PERIPH(PERIPH) ((((PERIPH) & 0xFFFFFF0E) == 0x00) && ((PERIPH) != 0x00)) +/** + * @} + */ + +/** @defgroup RCC_AHB3_Peripherals + * @{ + */ +#if defined (STM32F40_41xxx) +#define RCC_AHB3Periph_FSMC ((uint32_t)0x00000001) +#endif /* STM32F40_41xxx */ + +#if defined (STM32F427_437xx) || defined (STM32F429_439xx) +#define RCC_AHB3Periph_FMC ((uint32_t)0x00000001) +#endif /* STM32F427_437xx || STM32F429_439xx */ + +#define IS_RCC_AHB3_PERIPH(PERIPH) ((((PERIPH) & 0xFFFFFFFE) == 0x00) && ((PERIPH) != 0x00)) +/** + * @} + */ + +/** @defgroup RCC_APB1_Peripherals + * @{ + */ +#define RCC_APB1Periph_TIM2 ((uint32_t)0x00000001) +#define RCC_APB1Periph_TIM3 ((uint32_t)0x00000002) +#define RCC_APB1Periph_TIM4 ((uint32_t)0x00000004) +#define RCC_APB1Periph_TIM5 ((uint32_t)0x00000008) +#define RCC_APB1Periph_TIM6 ((uint32_t)0x00000010) +#define RCC_APB1Periph_TIM7 ((uint32_t)0x00000020) +#define RCC_APB1Periph_TIM12 ((uint32_t)0x00000040) +#define RCC_APB1Periph_TIM13 ((uint32_t)0x00000080) +#define RCC_APB1Periph_TIM14 ((uint32_t)0x00000100) +#define RCC_APB1Periph_WWDG ((uint32_t)0x00000800) +#define RCC_APB1Periph_SPI2 ((uint32_t)0x00004000) +#define RCC_APB1Periph_SPI3 ((uint32_t)0x00008000) +#define RCC_APB1Periph_USART2 ((uint32_t)0x00020000) +#define RCC_APB1Periph_USART3 ((uint32_t)0x00040000) +#define RCC_APB1Periph_UART4 ((uint32_t)0x00080000) +#define RCC_APB1Periph_UART5 ((uint32_t)0x00100000) +#define RCC_APB1Periph_I2C1 ((uint32_t)0x00200000) +#define RCC_APB1Periph_I2C2 ((uint32_t)0x00400000) +#define RCC_APB1Periph_I2C3 ((uint32_t)0x00800000) +#define RCC_APB1Periph_CAN1 ((uint32_t)0x02000000) +#define RCC_APB1Periph_CAN2 ((uint32_t)0x04000000) +#define RCC_APB1Periph_PWR ((uint32_t)0x10000000) +#define RCC_APB1Periph_DAC ((uint32_t)0x20000000) +#define RCC_APB1Periph_UART7 ((uint32_t)0x40000000) +#define RCC_APB1Periph_UART8 ((uint32_t)0x80000000) +#define IS_RCC_APB1_PERIPH(PERIPH) ((((PERIPH) & 0x09013600) == 0x00) && ((PERIPH) != 0x00)) +/** + * @} + */ + +/** @defgroup RCC_APB2_Peripherals + * @{ + */ +#define RCC_APB2Periph_TIM1 ((uint32_t)0x00000001) +#define RCC_APB2Periph_TIM8 ((uint32_t)0x00000002) +#define RCC_APB2Periph_USART1 ((uint32_t)0x00000010) +#define RCC_APB2Periph_USART6 ((uint32_t)0x00000020) +#define RCC_APB2Periph_ADC ((uint32_t)0x00000100) +#define RCC_APB2Periph_ADC1 ((uint32_t)0x00000100) +#define RCC_APB2Periph_ADC2 ((uint32_t)0x00000200) +#define RCC_APB2Periph_ADC3 ((uint32_t)0x00000400) +#define RCC_APB2Periph_SDIO ((uint32_t)0x00000800) +#define RCC_APB2Periph_SPI1 ((uint32_t)0x00001000) +#define RCC_APB2Periph_SPI4 ((uint32_t)0x00002000) +#define RCC_APB2Periph_SYSCFG ((uint32_t)0x00004000) +#define RCC_APB2Periph_TIM9 ((uint32_t)0x00010000) +#define RCC_APB2Periph_TIM10 ((uint32_t)0x00020000) +#define RCC_APB2Periph_TIM11 ((uint32_t)0x00040000) +#define RCC_APB2Periph_SPI5 ((uint32_t)0x00100000) +#define RCC_APB2Periph_SPI6 ((uint32_t)0x00200000) +#define RCC_APB2Periph_SAI1 ((uint32_t)0x00400000) +#define RCC_APB2Periph_LTDC ((uint32_t)0x04000000) + +#define IS_RCC_APB2_PERIPH(PERIPH) ((((PERIPH) & 0xFB8880CC) == 0x00) && ((PERIPH) != 0x00)) +#define IS_RCC_APB2_RESET_PERIPH(PERIPH) ((((PERIPH) & 0xFB8886CC) == 0x00) && ((PERIPH) != 0x00)) + +/** + * @} + */ + +/** @defgroup RCC_MCO1_Clock_Source_Prescaler + * @{ + */ +#define RCC_MCO1Source_HSI ((uint32_t)0x00000000) +#define RCC_MCO1Source_LSE ((uint32_t)0x00200000) +#define RCC_MCO1Source_HSE ((uint32_t)0x00400000) +#define RCC_MCO1Source_PLLCLK ((uint32_t)0x00600000) +#define RCC_MCO1Div_1 ((uint32_t)0x00000000) +#define RCC_MCO1Div_2 ((uint32_t)0x04000000) +#define RCC_MCO1Div_3 ((uint32_t)0x05000000) +#define RCC_MCO1Div_4 ((uint32_t)0x06000000) +#define RCC_MCO1Div_5 ((uint32_t)0x07000000) +#define IS_RCC_MCO1SOURCE(SOURCE) (((SOURCE) == RCC_MCO1Source_HSI) || ((SOURCE) == RCC_MCO1Source_LSE) || \ + ((SOURCE) == RCC_MCO1Source_HSE) || ((SOURCE) == RCC_MCO1Source_PLLCLK)) + +#define IS_RCC_MCO1DIV(DIV) (((DIV) == RCC_MCO1Div_1) || ((DIV) == RCC_MCO1Div_2) || \ + ((DIV) == RCC_MCO1Div_3) || ((DIV) == RCC_MCO1Div_4) || \ + ((DIV) == RCC_MCO1Div_5)) +/** + * @} + */ + +/** @defgroup RCC_MCO2_Clock_Source_Prescaler + * @{ + */ +#define RCC_MCO2Source_SYSCLK ((uint32_t)0x00000000) +#define RCC_MCO2Source_PLLI2SCLK ((uint32_t)0x40000000) +#define RCC_MCO2Source_HSE ((uint32_t)0x80000000) +#define RCC_MCO2Source_PLLCLK ((uint32_t)0xC0000000) +#define RCC_MCO2Div_1 ((uint32_t)0x00000000) +#define RCC_MCO2Div_2 ((uint32_t)0x20000000) +#define RCC_MCO2Div_3 ((uint32_t)0x28000000) +#define RCC_MCO2Div_4 ((uint32_t)0x30000000) +#define RCC_MCO2Div_5 ((uint32_t)0x38000000) +#define IS_RCC_MCO2SOURCE(SOURCE) (((SOURCE) == RCC_MCO2Source_SYSCLK) || ((SOURCE) == RCC_MCO2Source_PLLI2SCLK)|| \ + ((SOURCE) == RCC_MCO2Source_HSE) || ((SOURCE) == RCC_MCO2Source_PLLCLK)) + +#define IS_RCC_MCO2DIV(DIV) (((DIV) == RCC_MCO2Div_1) || ((DIV) == RCC_MCO2Div_2) || \ + ((DIV) == RCC_MCO2Div_3) || ((DIV) == RCC_MCO2Div_4) || \ + ((DIV) == RCC_MCO2Div_5)) +/** + * @} + */ + +/** @defgroup RCC_Flag + * @{ + */ +#define RCC_FLAG_HSIRDY ((uint8_t)0x21) +#define RCC_FLAG_HSERDY ((uint8_t)0x31) +#define RCC_FLAG_PLLRDY ((uint8_t)0x39) +#define RCC_FLAG_PLLI2SRDY ((uint8_t)0x3B) +#define RCC_FLAG_PLLSAIRDY ((uint8_t)0x3D) +#define RCC_FLAG_LSERDY ((uint8_t)0x41) +#define RCC_FLAG_LSIRDY ((uint8_t)0x61) +#define RCC_FLAG_BORRST ((uint8_t)0x79) +#define RCC_FLAG_PINRST ((uint8_t)0x7A) +#define RCC_FLAG_PORRST ((uint8_t)0x7B) +#define RCC_FLAG_SFTRST ((uint8_t)0x7C) +#define RCC_FLAG_IWDGRST ((uint8_t)0x7D) +#define RCC_FLAG_WWDGRST ((uint8_t)0x7E) +#define RCC_FLAG_LPWRRST ((uint8_t)0x7F) + +#define IS_RCC_FLAG(FLAG) (((FLAG) == RCC_FLAG_HSIRDY) || ((FLAG) == RCC_FLAG_HSERDY) || \ + ((FLAG) == RCC_FLAG_PLLRDY) || ((FLAG) == RCC_FLAG_LSERDY) || \ + ((FLAG) == RCC_FLAG_LSIRDY) || ((FLAG) == RCC_FLAG_BORRST) || \ + ((FLAG) == RCC_FLAG_PINRST) || ((FLAG) == RCC_FLAG_PORRST) || \ + ((FLAG) == RCC_FLAG_SFTRST) || ((FLAG) == RCC_FLAG_IWDGRST)|| \ + ((FLAG) == RCC_FLAG_WWDGRST) || ((FLAG) == RCC_FLAG_LPWRRST)|| \ + ((FLAG) == RCC_FLAG_PLLI2SRDY)|| ((FLAG) == RCC_FLAG_PLLSAIRDY)) + +#define IS_RCC_CALIBRATION_VALUE(VALUE) ((VALUE) <= 0x1F) +/** + * @} + */ + +/** + * @} + */ + +/* Exported macro ------------------------------------------------------------*/ +/* Exported functions --------------------------------------------------------*/ + +/* Function used to set the RCC clock configuration to the default reset state */ +void RCC_DeInit(void); + +/* Internal/external clocks, PLL, CSS and MCO configuration functions *********/ +void RCC_HSEConfig(uint8_t RCC_HSE); +ErrorStatus RCC_WaitForHSEStartUp(void); +void RCC_AdjustHSICalibrationValue(uint8_t HSICalibrationValue); +void RCC_HSICmd(FunctionalState NewState); +void RCC_LSEConfig(uint8_t RCC_LSE); +void RCC_LSICmd(FunctionalState NewState); +void RCC_PLLConfig(uint32_t RCC_PLLSource, uint32_t PLLM, uint32_t PLLN, uint32_t PLLP, uint32_t PLLQ); +void RCC_PLLCmd(FunctionalState NewState); + +#if defined (STM32F40_41xxx) || defined (STM32F401xx) +void RCC_PLLI2SConfig(uint32_t PLLI2SN, uint32_t PLLI2SR); +#elif defined (STM32F411xE) +void RCC_PLLI2SConfig(uint32_t PLLI2SN, uint32_t PLLI2SR, uint32_t PLLI2SM); +#elif defined (STM32F427_437xx) || defined (STM32F429_439xx) +void RCC_PLLI2SConfig(uint32_t PLLI2SN, uint32_t PLLI2SQ, uint32_t PLLI2SR); +#else +#endif /* STM32F40_41xxx || STM32F401xx */ + +void RCC_PLLI2SCmd(FunctionalState NewState); +void RCC_PLLSAIConfig(uint32_t PLLSAIN, uint32_t PLLSAIQ, uint32_t PLLSAIR); +void RCC_PLLSAICmd(FunctionalState NewState); +void RCC_ClockSecuritySystemCmd(FunctionalState NewState); +void RCC_MCO1Config(uint32_t RCC_MCO1Source, uint32_t RCC_MCO1Div); +void RCC_MCO2Config(uint32_t RCC_MCO2Source, uint32_t RCC_MCO2Div); + +/* System, AHB and APB busses clocks configuration functions ******************/ +void RCC_SYSCLKConfig(uint32_t RCC_SYSCLKSource); +uint8_t RCC_GetSYSCLKSource(void); +void RCC_HCLKConfig(uint32_t RCC_SYSCLK); +void RCC_PCLK1Config(uint32_t RCC_HCLK); +void RCC_PCLK2Config(uint32_t RCC_HCLK); +void RCC_GetClocksFreq(RCC_ClocksTypeDef* RCC_Clocks); + +/* Peripheral clocks configuration functions **********************************/ +void RCC_RTCCLKConfig(uint32_t RCC_RTCCLKSource); +void RCC_RTCCLKCmd(FunctionalState NewState); +void RCC_BackupResetCmd(FunctionalState NewState); +void RCC_I2SCLKConfig(uint32_t RCC_I2SCLKSource); +void RCC_SAIPLLI2SClkDivConfig(uint32_t RCC_PLLI2SDivQ); +void RCC_SAIPLLSAIClkDivConfig(uint32_t RCC_PLLSAIDivQ); +void RCC_SAIBlockACLKConfig(uint32_t RCC_SAIBlockACLKSource); +void RCC_SAIBlockBCLKConfig(uint32_t RCC_SAIBlockBCLKSource); +void RCC_LTDCCLKDivConfig(uint32_t RCC_PLLSAIDivR); +void RCC_TIMCLKPresConfig(uint32_t RCC_TIMCLKPrescaler); + +void RCC_AHB1PeriphClockCmd(uint32_t RCC_AHB1Periph, FunctionalState NewState); +void RCC_AHB2PeriphClockCmd(uint32_t RCC_AHB2Periph, FunctionalState NewState); +void RCC_AHB3PeriphClockCmd(uint32_t RCC_AHB3Periph, FunctionalState NewState); +void RCC_APB1PeriphClockCmd(uint32_t RCC_APB1Periph, FunctionalState NewState); +void RCC_APB2PeriphClockCmd(uint32_t RCC_APB2Periph, FunctionalState NewState); + +void RCC_AHB1PeriphResetCmd(uint32_t RCC_AHB1Periph, FunctionalState NewState); +void RCC_AHB2PeriphResetCmd(uint32_t RCC_AHB2Periph, FunctionalState NewState); +void RCC_AHB3PeriphResetCmd(uint32_t RCC_AHB3Periph, FunctionalState NewState); +void RCC_APB1PeriphResetCmd(uint32_t RCC_APB1Periph, FunctionalState NewState); +void RCC_APB2PeriphResetCmd(uint32_t RCC_APB2Periph, FunctionalState NewState); + +void RCC_AHB1PeriphClockLPModeCmd(uint32_t RCC_AHB1Periph, FunctionalState NewState); +void RCC_AHB2PeriphClockLPModeCmd(uint32_t RCC_AHB2Periph, FunctionalState NewState); +void RCC_AHB3PeriphClockLPModeCmd(uint32_t RCC_AHB3Periph, FunctionalState NewState); +void RCC_APB1PeriphClockLPModeCmd(uint32_t RCC_APB1Periph, FunctionalState NewState); +void RCC_APB2PeriphClockLPModeCmd(uint32_t RCC_APB2Periph, FunctionalState NewState); + +void RCC_LSEModeConfig(uint8_t Mode); + +/* Interrupts and flags management functions **********************************/ +void RCC_ITConfig(uint8_t RCC_IT, FunctionalState NewState); +FlagStatus RCC_GetFlagStatus(uint8_t RCC_FLAG); +void RCC_ClearFlag(void); +ITStatus RCC_GetITStatus(uint8_t RCC_IT); +void RCC_ClearITPendingBit(uint8_t RCC_IT); + +#ifdef __cplusplus +} +#endif + +#endif /* __STM32F4xx_RCC_H */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/inc/stm32f4xx_rng.h b/FWLIB/inc/stm32f4xx_rng.h new file mode 100644 index 0000000..58b468d --- /dev/null +++ b/FWLIB/inc/stm32f4xx_rng.h @@ -0,0 +1,120 @@ +/** + ****************************************************************************** + * @file stm32f4xx_rng.h + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file contains all the functions prototypes for the Random + * Number Generator(RNG) firmware library. + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Define to prevent recursive inclusion -------------------------------------*/ +#ifndef __STM32F4xx_RNG_H +#define __STM32F4xx_RNG_H + +#ifdef __cplusplus + extern "C" { +#endif + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @addtogroup RNG + * @{ + */ + +/* Exported types ------------------------------------------------------------*/ +/* Exported constants --------------------------------------------------------*/ + +/** @defgroup RNG_Exported_Constants + * @{ + */ + +/** @defgroup RNG_flags_definition + * @{ + */ +#define RNG_FLAG_DRDY ((uint8_t)0x0001) /*!< Data ready */ +#define RNG_FLAG_CECS ((uint8_t)0x0002) /*!< Clock error current status */ +#define RNG_FLAG_SECS ((uint8_t)0x0004) /*!< Seed error current status */ + +#define IS_RNG_GET_FLAG(RNG_FLAG) (((RNG_FLAG) == RNG_FLAG_DRDY) || \ + ((RNG_FLAG) == RNG_FLAG_CECS) || \ + ((RNG_FLAG) == RNG_FLAG_SECS)) +#define IS_RNG_CLEAR_FLAG(RNG_FLAG) (((RNG_FLAG) == RNG_FLAG_CECS) || \ + ((RNG_FLAG) == RNG_FLAG_SECS)) +/** + * @} + */ + +/** @defgroup RNG_interrupts_definition + * @{ + */ +#define RNG_IT_CEI ((uint8_t)0x20) /*!< Clock error interrupt */ +#define RNG_IT_SEI ((uint8_t)0x40) /*!< Seed error interrupt */ + +#define IS_RNG_IT(IT) ((((IT) & (uint8_t)0x9F) == 0x00) && ((IT) != 0x00)) +#define IS_RNG_GET_IT(RNG_IT) (((RNG_IT) == RNG_IT_CEI) || ((RNG_IT) == RNG_IT_SEI)) +/** + * @} + */ + +/** + * @} + */ + +/* Exported macro ------------------------------------------------------------*/ +/* Exported functions --------------------------------------------------------*/ + +/* Function used to set the RNG configuration to the default reset state *****/ +void RNG_DeInit(void); + +/* Configuration function *****************************************************/ +void RNG_Cmd(FunctionalState NewState); + +/* Get 32 bit Random number function ******************************************/ +uint32_t RNG_GetRandomNumber(void); + +/* Interrupts and flags management functions **********************************/ +void RNG_ITConfig(FunctionalState NewState); +FlagStatus RNG_GetFlagStatus(uint8_t RNG_FLAG); +void RNG_ClearFlag(uint8_t RNG_FLAG); +ITStatus RNG_GetITStatus(uint8_t RNG_IT); +void RNG_ClearITPendingBit(uint8_t RNG_IT); + +#ifdef __cplusplus +} +#endif + +#endif /*__STM32F4xx_RNG_H */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/inc/stm32f4xx_rtc.h b/FWLIB/inc/stm32f4xx_rtc.h new file mode 100644 index 0000000..1c3e6fc --- /dev/null +++ b/FWLIB/inc/stm32f4xx_rtc.h @@ -0,0 +1,881 @@ +/** + ****************************************************************************** + * @file stm32f4xx_rtc.h + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file contains all the functions prototypes for the RTC firmware + * library. + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Define to prevent recursive inclusion -------------------------------------*/ +#ifndef __STM32F4xx_RTC_H +#define __STM32F4xx_RTC_H + +#ifdef __cplusplus + extern "C" { +#endif + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @addtogroup RTC + * @{ + */ + +/* Exported types ------------------------------------------------------------*/ + +/** + * @brief RTC Init structures definition + */ +typedef struct +{ + uint32_t RTC_HourFormat; /*!< Specifies the RTC Hour Format. + This parameter can be a value of @ref RTC_Hour_Formats */ + + uint32_t RTC_AsynchPrediv; /*!< Specifies the RTC Asynchronous Predivider value. + This parameter must be set to a value lower than 0x7F */ + + uint32_t RTC_SynchPrediv; /*!< Specifies the RTC Synchronous Predivider value. + This parameter must be set to a value lower than 0x7FFF */ +}RTC_InitTypeDef; + +/** + * @brief RTC Time structure definition + */ +typedef struct +{ + uint8_t RTC_Hours; /*!< Specifies the RTC Time Hour. + This parameter must be set to a value in the 0-12 range + if the RTC_HourFormat_12 is selected or 0-23 range if + the RTC_HourFormat_24 is selected. */ + + uint8_t RTC_Minutes; /*!< Specifies the RTC Time Minutes. + This parameter must be set to a value in the 0-59 range. */ + + uint8_t RTC_Seconds; /*!< Specifies the RTC Time Seconds. + This parameter must be set to a value in the 0-59 range. */ + + uint8_t RTC_H12; /*!< Specifies the RTC AM/PM Time. + This parameter can be a value of @ref RTC_AM_PM_Definitions */ +}RTC_TimeTypeDef; + +/** + * @brief RTC Date structure definition + */ +typedef struct +{ + uint8_t RTC_WeekDay; /*!< Specifies the RTC Date WeekDay. + This parameter can be a value of @ref RTC_WeekDay_Definitions */ + + uint8_t RTC_Month; /*!< Specifies the RTC Date Month (in BCD format). + This parameter can be a value of @ref RTC_Month_Date_Definitions */ + + uint8_t RTC_Date; /*!< Specifies the RTC Date. + This parameter must be set to a value in the 1-31 range. */ + + uint8_t RTC_Year; /*!< Specifies the RTC Date Year. + This parameter must be set to a value in the 0-99 range. */ +}RTC_DateTypeDef; + +/** + * @brief RTC Alarm structure definition + */ +typedef struct +{ + RTC_TimeTypeDef RTC_AlarmTime; /*!< Specifies the RTC Alarm Time members. */ + + uint32_t RTC_AlarmMask; /*!< Specifies the RTC Alarm Masks. + This parameter can be a value of @ref RTC_AlarmMask_Definitions */ + + uint32_t RTC_AlarmDateWeekDaySel; /*!< Specifies the RTC Alarm is on Date or WeekDay. + This parameter can be a value of @ref RTC_AlarmDateWeekDay_Definitions */ + + uint8_t RTC_AlarmDateWeekDay; /*!< Specifies the RTC Alarm Date/WeekDay. + If the Alarm Date is selected, this parameter + must be set to a value in the 1-31 range. + If the Alarm WeekDay is selected, this + parameter can be a value of @ref RTC_WeekDay_Definitions */ +}RTC_AlarmTypeDef; + +/* Exported constants --------------------------------------------------------*/ + +/** @defgroup RTC_Exported_Constants + * @{ + */ + + +/** @defgroup RTC_Hour_Formats + * @{ + */ +#define RTC_HourFormat_24 ((uint32_t)0x00000000) +#define RTC_HourFormat_12 ((uint32_t)0x00000040) +#define IS_RTC_HOUR_FORMAT(FORMAT) (((FORMAT) == RTC_HourFormat_12) || \ + ((FORMAT) == RTC_HourFormat_24)) +/** + * @} + */ + +/** @defgroup RTC_Asynchronous_Predivider + * @{ + */ +#define IS_RTC_ASYNCH_PREDIV(PREDIV) ((PREDIV) <= 0x7F) + +/** + * @} + */ + + +/** @defgroup RTC_Synchronous_Predivider + * @{ + */ +#define IS_RTC_SYNCH_PREDIV(PREDIV) ((PREDIV) <= 0x7FFF) + +/** + * @} + */ + +/** @defgroup RTC_Time_Definitions + * @{ + */ +#define IS_RTC_HOUR12(HOUR) (((HOUR) > 0) && ((HOUR) <= 12)) +#define IS_RTC_HOUR24(HOUR) ((HOUR) <= 23) +#define IS_RTC_MINUTES(MINUTES) ((MINUTES) <= 59) +#define IS_RTC_SECONDS(SECONDS) ((SECONDS) <= 59) + +/** + * @} + */ + +/** @defgroup RTC_AM_PM_Definitions + * @{ + */ +#define RTC_H12_AM ((uint8_t)0x00) +#define RTC_H12_PM ((uint8_t)0x40) +#define IS_RTC_H12(PM) (((PM) == RTC_H12_AM) || ((PM) == RTC_H12_PM)) + +/** + * @} + */ + +/** @defgroup RTC_Year_Date_Definitions + * @{ + */ +#define IS_RTC_YEAR(YEAR) ((YEAR) <= 99) + +/** + * @} + */ + +/** @defgroup RTC_Month_Date_Definitions + * @{ + */ + +/* Coded in BCD format */ +#define RTC_Month_January ((uint8_t)0x01) +#define RTC_Month_February ((uint8_t)0x02) +#define RTC_Month_March ((uint8_t)0x03) +#define RTC_Month_April ((uint8_t)0x04) +#define RTC_Month_May ((uint8_t)0x05) +#define RTC_Month_June ((uint8_t)0x06) +#define RTC_Month_July ((uint8_t)0x07) +#define RTC_Month_August ((uint8_t)0x08) +#define RTC_Month_September ((uint8_t)0x09) +#define RTC_Month_October ((uint8_t)0x10) +#define RTC_Month_November ((uint8_t)0x11) +#define RTC_Month_December ((uint8_t)0x12) +#define IS_RTC_MONTH(MONTH) (((MONTH) >= 1) && ((MONTH) <= 12)) +#define IS_RTC_DATE(DATE) (((DATE) >= 1) && ((DATE) <= 31)) + +/** + * @} + */ + +/** @defgroup RTC_WeekDay_Definitions + * @{ + */ + +#define RTC_Weekday_Monday ((uint8_t)0x01) +#define RTC_Weekday_Tuesday ((uint8_t)0x02) +#define RTC_Weekday_Wednesday ((uint8_t)0x03) +#define RTC_Weekday_Thursday ((uint8_t)0x04) +#define RTC_Weekday_Friday ((uint8_t)0x05) +#define RTC_Weekday_Saturday ((uint8_t)0x06) +#define RTC_Weekday_Sunday ((uint8_t)0x07) +#define IS_RTC_WEEKDAY(WEEKDAY) (((WEEKDAY) == RTC_Weekday_Monday) || \ + ((WEEKDAY) == RTC_Weekday_Tuesday) || \ + ((WEEKDAY) == RTC_Weekday_Wednesday) || \ + ((WEEKDAY) == RTC_Weekday_Thursday) || \ + ((WEEKDAY) == RTC_Weekday_Friday) || \ + ((WEEKDAY) == RTC_Weekday_Saturday) || \ + ((WEEKDAY) == RTC_Weekday_Sunday)) +/** + * @} + */ + + +/** @defgroup RTC_Alarm_Definitions + * @{ + */ +#define IS_RTC_ALARM_DATE_WEEKDAY_DATE(DATE) (((DATE) > 0) && ((DATE) <= 31)) +#define IS_RTC_ALARM_DATE_WEEKDAY_WEEKDAY(WEEKDAY) (((WEEKDAY) == RTC_Weekday_Monday) || \ + ((WEEKDAY) == RTC_Weekday_Tuesday) || \ + ((WEEKDAY) == RTC_Weekday_Wednesday) || \ + ((WEEKDAY) == RTC_Weekday_Thursday) || \ + ((WEEKDAY) == RTC_Weekday_Friday) || \ + ((WEEKDAY) == RTC_Weekday_Saturday) || \ + ((WEEKDAY) == RTC_Weekday_Sunday)) + +/** + * @} + */ + + +/** @defgroup RTC_AlarmDateWeekDay_Definitions + * @{ + */ +#define RTC_AlarmDateWeekDaySel_Date ((uint32_t)0x00000000) +#define RTC_AlarmDateWeekDaySel_WeekDay ((uint32_t)0x40000000) + +#define IS_RTC_ALARM_DATE_WEEKDAY_SEL(SEL) (((SEL) == RTC_AlarmDateWeekDaySel_Date) || \ + ((SEL) == RTC_AlarmDateWeekDaySel_WeekDay)) + +/** + * @} + */ + + +/** @defgroup RTC_AlarmMask_Definitions + * @{ + */ +#define RTC_AlarmMask_None ((uint32_t)0x00000000) +#define RTC_AlarmMask_DateWeekDay ((uint32_t)0x80000000) +#define RTC_AlarmMask_Hours ((uint32_t)0x00800000) +#define RTC_AlarmMask_Minutes ((uint32_t)0x00008000) +#define RTC_AlarmMask_Seconds ((uint32_t)0x00000080) +#define RTC_AlarmMask_All ((uint32_t)0x80808080) +#define IS_ALARM_MASK(MASK) (((MASK) & 0x7F7F7F7F) == (uint32_t)RESET) + +/** + * @} + */ + +/** @defgroup RTC_Alarms_Definitions + * @{ + */ +#define RTC_Alarm_A ((uint32_t)0x00000100) +#define RTC_Alarm_B ((uint32_t)0x00000200) +#define IS_RTC_ALARM(ALARM) (((ALARM) == RTC_Alarm_A) || ((ALARM) == RTC_Alarm_B)) +#define IS_RTC_CMD_ALARM(ALARM) (((ALARM) & (RTC_Alarm_A | RTC_Alarm_B)) != (uint32_t)RESET) + +/** + * @} + */ + + /** @defgroup RTC_Alarm_Sub_Seconds_Masks_Definitions + * @{ + */ +#define RTC_AlarmSubSecondMask_All ((uint32_t)0x00000000) /*!< All Alarm SS fields are masked. + There is no comparison on sub seconds + for Alarm */ +#define RTC_AlarmSubSecondMask_SS14_1 ((uint32_t)0x01000000) /*!< SS[14:1] are don't care in Alarm + comparison. Only SS[0] is compared. */ +#define RTC_AlarmSubSecondMask_SS14_2 ((uint32_t)0x02000000) /*!< SS[14:2] are don't care in Alarm + comparison. Only SS[1:0] are compared */ +#define RTC_AlarmSubSecondMask_SS14_3 ((uint32_t)0x03000000) /*!< SS[14:3] are don't care in Alarm + comparison. Only SS[2:0] are compared */ +#define RTC_AlarmSubSecondMask_SS14_4 ((uint32_t)0x04000000) /*!< SS[14:4] are don't care in Alarm + comparison. Only SS[3:0] are compared */ +#define RTC_AlarmSubSecondMask_SS14_5 ((uint32_t)0x05000000) /*!< SS[14:5] are don't care in Alarm + comparison. Only SS[4:0] are compared */ +#define RTC_AlarmSubSecondMask_SS14_6 ((uint32_t)0x06000000) /*!< SS[14:6] are don't care in Alarm + comparison. Only SS[5:0] are compared */ +#define RTC_AlarmSubSecondMask_SS14_7 ((uint32_t)0x07000000) /*!< SS[14:7] are don't care in Alarm + comparison. Only SS[6:0] are compared */ +#define RTC_AlarmSubSecondMask_SS14_8 ((uint32_t)0x08000000) /*!< SS[14:8] are don't care in Alarm + comparison. Only SS[7:0] are compared */ +#define RTC_AlarmSubSecondMask_SS14_9 ((uint32_t)0x09000000) /*!< SS[14:9] are don't care in Alarm + comparison. Only SS[8:0] are compared */ +#define RTC_AlarmSubSecondMask_SS14_10 ((uint32_t)0x0A000000) /*!< SS[14:10] are don't care in Alarm + comparison. Only SS[9:0] are compared */ +#define RTC_AlarmSubSecondMask_SS14_11 ((uint32_t)0x0B000000) /*!< SS[14:11] are don't care in Alarm + comparison. Only SS[10:0] are compared */ +#define RTC_AlarmSubSecondMask_SS14_12 ((uint32_t)0x0C000000) /*!< SS[14:12] are don't care in Alarm + comparison.Only SS[11:0] are compared */ +#define RTC_AlarmSubSecondMask_SS14_13 ((uint32_t)0x0D000000) /*!< SS[14:13] are don't care in Alarm + comparison. Only SS[12:0] are compared */ +#define RTC_AlarmSubSecondMask_SS14 ((uint32_t)0x0E000000) /*!< SS[14] is don't care in Alarm + comparison.Only SS[13:0] are compared */ +#define RTC_AlarmSubSecondMask_None ((uint32_t)0x0F000000) /*!< SS[14:0] are compared and must match + to activate alarm. */ +#define IS_RTC_ALARM_SUB_SECOND_MASK(MASK) (((MASK) == RTC_AlarmSubSecondMask_All) || \ + ((MASK) == RTC_AlarmSubSecondMask_SS14_1) || \ + ((MASK) == RTC_AlarmSubSecondMask_SS14_2) || \ + ((MASK) == RTC_AlarmSubSecondMask_SS14_3) || \ + ((MASK) == RTC_AlarmSubSecondMask_SS14_4) || \ + ((MASK) == RTC_AlarmSubSecondMask_SS14_5) || \ + ((MASK) == RTC_AlarmSubSecondMask_SS14_6) || \ + ((MASK) == RTC_AlarmSubSecondMask_SS14_7) || \ + ((MASK) == RTC_AlarmSubSecondMask_SS14_8) || \ + ((MASK) == RTC_AlarmSubSecondMask_SS14_9) || \ + ((MASK) == RTC_AlarmSubSecondMask_SS14_10) || \ + ((MASK) == RTC_AlarmSubSecondMask_SS14_11) || \ + ((MASK) == RTC_AlarmSubSecondMask_SS14_12) || \ + ((MASK) == RTC_AlarmSubSecondMask_SS14_13) || \ + ((MASK) == RTC_AlarmSubSecondMask_SS14) || \ + ((MASK) == RTC_AlarmSubSecondMask_None)) +/** + * @} + */ + +/** @defgroup RTC_Alarm_Sub_Seconds_Value + * @{ + */ + +#define IS_RTC_ALARM_SUB_SECOND_VALUE(VALUE) ((VALUE) <= 0x00007FFF) + +/** + * @} + */ + +/** @defgroup RTC_Wakeup_Timer_Definitions + * @{ + */ +#define RTC_WakeUpClock_RTCCLK_Div16 ((uint32_t)0x00000000) +#define RTC_WakeUpClock_RTCCLK_Div8 ((uint32_t)0x00000001) +#define RTC_WakeUpClock_RTCCLK_Div4 ((uint32_t)0x00000002) +#define RTC_WakeUpClock_RTCCLK_Div2 ((uint32_t)0x00000003) +#define RTC_WakeUpClock_CK_SPRE_16bits ((uint32_t)0x00000004) +#define RTC_WakeUpClock_CK_SPRE_17bits ((uint32_t)0x00000006) +#define IS_RTC_WAKEUP_CLOCK(CLOCK) (((CLOCK) == RTC_WakeUpClock_RTCCLK_Div16) || \ + ((CLOCK) == RTC_WakeUpClock_RTCCLK_Div8) || \ + ((CLOCK) == RTC_WakeUpClock_RTCCLK_Div4) || \ + ((CLOCK) == RTC_WakeUpClock_RTCCLK_Div2) || \ + ((CLOCK) == RTC_WakeUpClock_CK_SPRE_16bits) || \ + ((CLOCK) == RTC_WakeUpClock_CK_SPRE_17bits)) +#define IS_RTC_WAKEUP_COUNTER(COUNTER) ((COUNTER) <= 0xFFFF) +/** + * @} + */ + +/** @defgroup RTC_Time_Stamp_Edges_definitions + * @{ + */ +#define RTC_TimeStampEdge_Rising ((uint32_t)0x00000000) +#define RTC_TimeStampEdge_Falling ((uint32_t)0x00000008) +#define IS_RTC_TIMESTAMP_EDGE(EDGE) (((EDGE) == RTC_TimeStampEdge_Rising) || \ + ((EDGE) == RTC_TimeStampEdge_Falling)) +/** + * @} + */ + +/** @defgroup RTC_Output_selection_Definitions + * @{ + */ +#define RTC_Output_Disable ((uint32_t)0x00000000) +#define RTC_Output_AlarmA ((uint32_t)0x00200000) +#define RTC_Output_AlarmB ((uint32_t)0x00400000) +#define RTC_Output_WakeUp ((uint32_t)0x00600000) + +#define IS_RTC_OUTPUT(OUTPUT) (((OUTPUT) == RTC_Output_Disable) || \ + ((OUTPUT) == RTC_Output_AlarmA) || \ + ((OUTPUT) == RTC_Output_AlarmB) || \ + ((OUTPUT) == RTC_Output_WakeUp)) + +/** + * @} + */ + +/** @defgroup RTC_Output_Polarity_Definitions + * @{ + */ +#define RTC_OutputPolarity_High ((uint32_t)0x00000000) +#define RTC_OutputPolarity_Low ((uint32_t)0x00100000) +#define IS_RTC_OUTPUT_POL(POL) (((POL) == RTC_OutputPolarity_High) || \ + ((POL) == RTC_OutputPolarity_Low)) +/** + * @} + */ + + +/** @defgroup RTC_Digital_Calibration_Definitions + * @{ + */ +#define RTC_CalibSign_Positive ((uint32_t)0x00000000) +#define RTC_CalibSign_Negative ((uint32_t)0x00000080) +#define IS_RTC_CALIB_SIGN(SIGN) (((SIGN) == RTC_CalibSign_Positive) || \ + ((SIGN) == RTC_CalibSign_Negative)) +#define IS_RTC_CALIB_VALUE(VALUE) ((VALUE) < 0x20) + +/** + * @} + */ + + /** @defgroup RTC_Calib_Output_selection_Definitions + * @{ + */ +#define RTC_CalibOutput_512Hz ((uint32_t)0x00000000) +#define RTC_CalibOutput_1Hz ((uint32_t)0x00080000) +#define IS_RTC_CALIB_OUTPUT(OUTPUT) (((OUTPUT) == RTC_CalibOutput_512Hz) || \ + ((OUTPUT) == RTC_CalibOutput_1Hz)) +/** + * @} + */ + +/** @defgroup RTC_Smooth_calib_period_Definitions + * @{ + */ +#define RTC_SmoothCalibPeriod_32sec ((uint32_t)0x00000000) /*!< if RTCCLK = 32768 Hz, Smooth calibation + period is 32s, else 2exp20 RTCCLK seconds */ +#define RTC_SmoothCalibPeriod_16sec ((uint32_t)0x00002000) /*!< if RTCCLK = 32768 Hz, Smooth calibation + period is 16s, else 2exp19 RTCCLK seconds */ +#define RTC_SmoothCalibPeriod_8sec ((uint32_t)0x00004000) /*!< if RTCCLK = 32768 Hz, Smooth calibation + period is 8s, else 2exp18 RTCCLK seconds */ +#define IS_RTC_SMOOTH_CALIB_PERIOD(PERIOD) (((PERIOD) == RTC_SmoothCalibPeriod_32sec) || \ + ((PERIOD) == RTC_SmoothCalibPeriod_16sec) || \ + ((PERIOD) == RTC_SmoothCalibPeriod_8sec)) + +/** + * @} + */ + +/** @defgroup RTC_Smooth_calib_Plus_pulses_Definitions + * @{ + */ +#define RTC_SmoothCalibPlusPulses_Set ((uint32_t)0x00008000) /*!< The number of RTCCLK pulses added + during a X -second window = Y - CALM[8:0]. + with Y = 512, 256, 128 when X = 32, 16, 8 */ +#define RTC_SmoothCalibPlusPulses_Reset ((uint32_t)0x00000000) /*!< The number of RTCCLK pulses subbstited + during a 32-second window = CALM[8:0]. */ +#define IS_RTC_SMOOTH_CALIB_PLUS(PLUS) (((PLUS) == RTC_SmoothCalibPlusPulses_Set) || \ + ((PLUS) == RTC_SmoothCalibPlusPulses_Reset)) + +/** + * @} + */ + +/** @defgroup RTC_Smooth_calib_Minus_pulses_Definitions + * @{ + */ +#define IS_RTC_SMOOTH_CALIB_MINUS(VALUE) ((VALUE) <= 0x000001FF) + +/** + * @} + */ + +/** @defgroup RTC_DayLightSaving_Definitions + * @{ + */ +#define RTC_DayLightSaving_SUB1H ((uint32_t)0x00020000) +#define RTC_DayLightSaving_ADD1H ((uint32_t)0x00010000) +#define IS_RTC_DAYLIGHT_SAVING(SAVE) (((SAVE) == RTC_DayLightSaving_SUB1H) || \ + ((SAVE) == RTC_DayLightSaving_ADD1H)) + +#define RTC_StoreOperation_Reset ((uint32_t)0x00000000) +#define RTC_StoreOperation_Set ((uint32_t)0x00040000) +#define IS_RTC_STORE_OPERATION(OPERATION) (((OPERATION) == RTC_StoreOperation_Reset) || \ + ((OPERATION) == RTC_StoreOperation_Set)) +/** + * @} + */ + +/** @defgroup RTC_Tamper_Trigger_Definitions + * @{ + */ +#define RTC_TamperTrigger_RisingEdge ((uint32_t)0x00000000) +#define RTC_TamperTrigger_FallingEdge ((uint32_t)0x00000001) +#define RTC_TamperTrigger_LowLevel ((uint32_t)0x00000000) +#define RTC_TamperTrigger_HighLevel ((uint32_t)0x00000001) +#define IS_RTC_TAMPER_TRIGGER(TRIGGER) (((TRIGGER) == RTC_TamperTrigger_RisingEdge) || \ + ((TRIGGER) == RTC_TamperTrigger_FallingEdge) || \ + ((TRIGGER) == RTC_TamperTrigger_LowLevel) || \ + ((TRIGGER) == RTC_TamperTrigger_HighLevel)) + +/** + * @} + */ + +/** @defgroup RTC_Tamper_Filter_Definitions + * @{ + */ +#define RTC_TamperFilter_Disable ((uint32_t)0x00000000) /*!< Tamper filter is disabled */ + +#define RTC_TamperFilter_2Sample ((uint32_t)0x00000800) /*!< Tamper is activated after 2 + consecutive samples at the active level */ +#define RTC_TamperFilter_4Sample ((uint32_t)0x00001000) /*!< Tamper is activated after 4 + consecutive samples at the active level */ +#define RTC_TamperFilter_8Sample ((uint32_t)0x00001800) /*!< Tamper is activated after 8 + consecutive samples at the active leve. */ +#define IS_RTC_TAMPER_FILTER(FILTER) (((FILTER) == RTC_TamperFilter_Disable) || \ + ((FILTER) == RTC_TamperFilter_2Sample) || \ + ((FILTER) == RTC_TamperFilter_4Sample) || \ + ((FILTER) == RTC_TamperFilter_8Sample)) +/** + * @} + */ + +/** @defgroup RTC_Tamper_Sampling_Frequencies_Definitions + * @{ + */ +#define RTC_TamperSamplingFreq_RTCCLK_Div32768 ((uint32_t)0x00000000) /*!< Each of the tamper inputs are sampled + with a frequency = RTCCLK / 32768 */ +#define RTC_TamperSamplingFreq_RTCCLK_Div16384 ((uint32_t)0x000000100) /*!< Each of the tamper inputs are sampled + with a frequency = RTCCLK / 16384 */ +#define RTC_TamperSamplingFreq_RTCCLK_Div8192 ((uint32_t)0x00000200) /*!< Each of the tamper inputs are sampled + with a frequency = RTCCLK / 8192 */ +#define RTC_TamperSamplingFreq_RTCCLK_Div4096 ((uint32_t)0x00000300) /*!< Each of the tamper inputs are sampled + with a frequency = RTCCLK / 4096 */ +#define RTC_TamperSamplingFreq_RTCCLK_Div2048 ((uint32_t)0x00000400) /*!< Each of the tamper inputs are sampled + with a frequency = RTCCLK / 2048 */ +#define RTC_TamperSamplingFreq_RTCCLK_Div1024 ((uint32_t)0x00000500) /*!< Each of the tamper inputs are sampled + with a frequency = RTCCLK / 1024 */ +#define RTC_TamperSamplingFreq_RTCCLK_Div512 ((uint32_t)0x00000600) /*!< Each of the tamper inputs are sampled + with a frequency = RTCCLK / 512 */ +#define RTC_TamperSamplingFreq_RTCCLK_Div256 ((uint32_t)0x00000700) /*!< Each of the tamper inputs are sampled + with a frequency = RTCCLK / 256 */ +#define IS_RTC_TAMPER_SAMPLING_FREQ(FREQ) (((FREQ) ==RTC_TamperSamplingFreq_RTCCLK_Div32768) || \ + ((FREQ) ==RTC_TamperSamplingFreq_RTCCLK_Div16384) || \ + ((FREQ) ==RTC_TamperSamplingFreq_RTCCLK_Div8192) || \ + ((FREQ) ==RTC_TamperSamplingFreq_RTCCLK_Div4096) || \ + ((FREQ) ==RTC_TamperSamplingFreq_RTCCLK_Div2048) || \ + ((FREQ) ==RTC_TamperSamplingFreq_RTCCLK_Div1024) || \ + ((FREQ) ==RTC_TamperSamplingFreq_RTCCLK_Div512) || \ + ((FREQ) ==RTC_TamperSamplingFreq_RTCCLK_Div256)) + +/** + * @} + */ + + /** @defgroup RTC_Tamper_Pin_Precharge_Duration_Definitions + * @{ + */ +#define RTC_TamperPrechargeDuration_1RTCCLK ((uint32_t)0x00000000) /*!< Tamper pins are pre-charged before + sampling during 1 RTCCLK cycle */ +#define RTC_TamperPrechargeDuration_2RTCCLK ((uint32_t)0x00002000) /*!< Tamper pins are pre-charged before + sampling during 2 RTCCLK cycles */ +#define RTC_TamperPrechargeDuration_4RTCCLK ((uint32_t)0x00004000) /*!< Tamper pins are pre-charged before + sampling during 4 RTCCLK cycles */ +#define RTC_TamperPrechargeDuration_8RTCCLK ((uint32_t)0x00006000) /*!< Tamper pins are pre-charged before + sampling during 8 RTCCLK cycles */ + +#define IS_RTC_TAMPER_PRECHARGE_DURATION(DURATION) (((DURATION) == RTC_TamperPrechargeDuration_1RTCCLK) || \ + ((DURATION) == RTC_TamperPrechargeDuration_2RTCCLK) || \ + ((DURATION) == RTC_TamperPrechargeDuration_4RTCCLK) || \ + ((DURATION) == RTC_TamperPrechargeDuration_8RTCCLK)) +/** + * @} + */ + +/** @defgroup RTC_Tamper_Pins_Definitions + * @{ + */ +#define RTC_Tamper_1 RTC_TAFCR_TAMP1E +#define IS_RTC_TAMPER(TAMPER) (((TAMPER) == RTC_Tamper_1)) + +/** + * @} + */ + +/** @defgroup RTC_Tamper_Pin_Selection + * @{ + */ +#define RTC_TamperPin_PC13 ((uint32_t)0x00000000) +#define RTC_TamperPin_PI8 ((uint32_t)0x00010000) +#define IS_RTC_TAMPER_PIN(PIN) (((PIN) == RTC_TamperPin_PC13) || \ + ((PIN) == RTC_TamperPin_PI8)) +/** + * @} + */ + +/** @defgroup RTC_TimeStamp_Pin_Selection + * @{ + */ +#define RTC_TimeStampPin_PC13 ((uint32_t)0x00000000) +#define RTC_TimeStampPin_PI8 ((uint32_t)0x00020000) +#define IS_RTC_TIMESTAMP_PIN(PIN) (((PIN) == RTC_TimeStampPin_PC13) || \ + ((PIN) == RTC_TimeStampPin_PI8)) +/** + * @} + */ + +/** @defgroup RTC_Output_Type_ALARM_OUT + * @{ + */ +#define RTC_OutputType_OpenDrain ((uint32_t)0x00000000) +#define RTC_OutputType_PushPull ((uint32_t)0x00040000) +#define IS_RTC_OUTPUT_TYPE(TYPE) (((TYPE) == RTC_OutputType_OpenDrain) || \ + ((TYPE) == RTC_OutputType_PushPull)) + +/** + * @} + */ + +/** @defgroup RTC_Add_1_Second_Parameter_Definitions + * @{ + */ +#define RTC_ShiftAdd1S_Reset ((uint32_t)0x00000000) +#define RTC_ShiftAdd1S_Set ((uint32_t)0x80000000) +#define IS_RTC_SHIFT_ADD1S(SEL) (((SEL) == RTC_ShiftAdd1S_Reset) || \ + ((SEL) == RTC_ShiftAdd1S_Set)) +/** + * @} + */ + +/** @defgroup RTC_Substract_Fraction_Of_Second_Value + * @{ + */ +#define IS_RTC_SHIFT_SUBFS(FS) ((FS) <= 0x00007FFF) + +/** + * @} + */ + +/** @defgroup RTC_Backup_Registers_Definitions + * @{ + */ + +#define RTC_BKP_DR0 ((uint32_t)0x00000000) +#define RTC_BKP_DR1 ((uint32_t)0x00000001) +#define RTC_BKP_DR2 ((uint32_t)0x00000002) +#define RTC_BKP_DR3 ((uint32_t)0x00000003) +#define RTC_BKP_DR4 ((uint32_t)0x00000004) +#define RTC_BKP_DR5 ((uint32_t)0x00000005) +#define RTC_BKP_DR6 ((uint32_t)0x00000006) +#define RTC_BKP_DR7 ((uint32_t)0x00000007) +#define RTC_BKP_DR8 ((uint32_t)0x00000008) +#define RTC_BKP_DR9 ((uint32_t)0x00000009) +#define RTC_BKP_DR10 ((uint32_t)0x0000000A) +#define RTC_BKP_DR11 ((uint32_t)0x0000000B) +#define RTC_BKP_DR12 ((uint32_t)0x0000000C) +#define RTC_BKP_DR13 ((uint32_t)0x0000000D) +#define RTC_BKP_DR14 ((uint32_t)0x0000000E) +#define RTC_BKP_DR15 ((uint32_t)0x0000000F) +#define RTC_BKP_DR16 ((uint32_t)0x00000010) +#define RTC_BKP_DR17 ((uint32_t)0x00000011) +#define RTC_BKP_DR18 ((uint32_t)0x00000012) +#define RTC_BKP_DR19 ((uint32_t)0x00000013) +#define IS_RTC_BKP(BKP) (((BKP) == RTC_BKP_DR0) || \ + ((BKP) == RTC_BKP_DR1) || \ + ((BKP) == RTC_BKP_DR2) || \ + ((BKP) == RTC_BKP_DR3) || \ + ((BKP) == RTC_BKP_DR4) || \ + ((BKP) == RTC_BKP_DR5) || \ + ((BKP) == RTC_BKP_DR6) || \ + ((BKP) == RTC_BKP_DR7) || \ + ((BKP) == RTC_BKP_DR8) || \ + ((BKP) == RTC_BKP_DR9) || \ + ((BKP) == RTC_BKP_DR10) || \ + ((BKP) == RTC_BKP_DR11) || \ + ((BKP) == RTC_BKP_DR12) || \ + ((BKP) == RTC_BKP_DR13) || \ + ((BKP) == RTC_BKP_DR14) || \ + ((BKP) == RTC_BKP_DR15) || \ + ((BKP) == RTC_BKP_DR16) || \ + ((BKP) == RTC_BKP_DR17) || \ + ((BKP) == RTC_BKP_DR18) || \ + ((BKP) == RTC_BKP_DR19)) +/** + * @} + */ + +/** @defgroup RTC_Input_parameter_format_definitions + * @{ + */ +#define RTC_Format_BIN ((uint32_t)0x000000000) +#define RTC_Format_BCD ((uint32_t)0x000000001) +#define IS_RTC_FORMAT(FORMAT) (((FORMAT) == RTC_Format_BIN) || ((FORMAT) == RTC_Format_BCD)) + +/** + * @} + */ + +/** @defgroup RTC_Flags_Definitions + * @{ + */ +#define RTC_FLAG_RECALPF ((uint32_t)0x00010000) +#define RTC_FLAG_TAMP1F ((uint32_t)0x00002000) +#define RTC_FLAG_TSOVF ((uint32_t)0x00001000) +#define RTC_FLAG_TSF ((uint32_t)0x00000800) +#define RTC_FLAG_WUTF ((uint32_t)0x00000400) +#define RTC_FLAG_ALRBF ((uint32_t)0x00000200) +#define RTC_FLAG_ALRAF ((uint32_t)0x00000100) +#define RTC_FLAG_INITF ((uint32_t)0x00000040) +#define RTC_FLAG_RSF ((uint32_t)0x00000020) +#define RTC_FLAG_INITS ((uint32_t)0x00000010) +#define RTC_FLAG_SHPF ((uint32_t)0x00000008) +#define RTC_FLAG_WUTWF ((uint32_t)0x00000004) +#define RTC_FLAG_ALRBWF ((uint32_t)0x00000002) +#define RTC_FLAG_ALRAWF ((uint32_t)0x00000001) +#define IS_RTC_GET_FLAG(FLAG) (((FLAG) == RTC_FLAG_TSOVF) || ((FLAG) == RTC_FLAG_TSF) || \ + ((FLAG) == RTC_FLAG_WUTF) || ((FLAG) == RTC_FLAG_ALRBF) || \ + ((FLAG) == RTC_FLAG_ALRAF) || ((FLAG) == RTC_FLAG_INITF) || \ + ((FLAG) == RTC_FLAG_RSF) || ((FLAG) == RTC_FLAG_WUTWF) || \ + ((FLAG) == RTC_FLAG_ALRBWF) || ((FLAG) == RTC_FLAG_ALRAWF) || \ + ((FLAG) == RTC_FLAG_TAMP1F) || ((FLAG) == RTC_FLAG_RECALPF) || \ + ((FLAG) == RTC_FLAG_SHPF)) +#define IS_RTC_CLEAR_FLAG(FLAG) (((FLAG) != (uint32_t)RESET) && (((FLAG) & 0xFFFF00DF) == (uint32_t)RESET)) +/** + * @} + */ + +/** @defgroup RTC_Interrupts_Definitions + * @{ + */ +#define RTC_IT_TS ((uint32_t)0x00008000) +#define RTC_IT_WUT ((uint32_t)0x00004000) +#define RTC_IT_ALRB ((uint32_t)0x00002000) +#define RTC_IT_ALRA ((uint32_t)0x00001000) +#define RTC_IT_TAMP ((uint32_t)0x00000004) /* Used only to Enable the Tamper Interrupt */ +#define RTC_IT_TAMP1 ((uint32_t)0x00020000) + +#define IS_RTC_CONFIG_IT(IT) (((IT) != (uint32_t)RESET) && (((IT) & 0xFFFF0FFB) == (uint32_t)RESET)) +#define IS_RTC_GET_IT(IT) (((IT) == RTC_IT_TS) || ((IT) == RTC_IT_WUT) || \ + ((IT) == RTC_IT_ALRB) || ((IT) == RTC_IT_ALRA) || \ + ((IT) == RTC_IT_TAMP1)) +#define IS_RTC_CLEAR_IT(IT) (((IT) != (uint32_t)RESET) && (((IT) & 0xFFFD0FFF) == (uint32_t)RESET)) + +/** + * @} + */ + +/** @defgroup RTC_Legacy + * @{ + */ +#define RTC_DigitalCalibConfig RTC_CoarseCalibConfig +#define RTC_DigitalCalibCmd RTC_CoarseCalibCmd + +/** + * @} + */ + +/** + * @} + */ + +/* Exported macro ------------------------------------------------------------*/ +/* Exported functions --------------------------------------------------------*/ + +/* Function used to set the RTC configuration to the default reset state *****/ +ErrorStatus RTC_DeInit(void); + +/* Initialization and Configuration functions *********************************/ +ErrorStatus RTC_Init(RTC_InitTypeDef* RTC_InitStruct); +void RTC_StructInit(RTC_InitTypeDef* RTC_InitStruct); +void RTC_WriteProtectionCmd(FunctionalState NewState); +ErrorStatus RTC_EnterInitMode(void); +void RTC_ExitInitMode(void); +ErrorStatus RTC_WaitForSynchro(void); +ErrorStatus RTC_RefClockCmd(FunctionalState NewState); +void RTC_BypassShadowCmd(FunctionalState NewState); + +/* Time and Date configuration functions **************************************/ +ErrorStatus RTC_SetTime(uint32_t RTC_Format, RTC_TimeTypeDef* RTC_TimeStruct); +void RTC_TimeStructInit(RTC_TimeTypeDef* RTC_TimeStruct); +void RTC_GetTime(uint32_t RTC_Format, RTC_TimeTypeDef* RTC_TimeStruct); +uint32_t RTC_GetSubSecond(void); +ErrorStatus RTC_SetDate(uint32_t RTC_Format, RTC_DateTypeDef* RTC_DateStruct); +void RTC_DateStructInit(RTC_DateTypeDef* RTC_DateStruct); +void RTC_GetDate(uint32_t RTC_Format, RTC_DateTypeDef* RTC_DateStruct); + +/* Alarms (Alarm A and Alarm B) configuration functions **********************/ +void RTC_SetAlarm(uint32_t RTC_Format, uint32_t RTC_Alarm, RTC_AlarmTypeDef* RTC_AlarmStruct); +void RTC_AlarmStructInit(RTC_AlarmTypeDef* RTC_AlarmStruct); +void RTC_GetAlarm(uint32_t RTC_Format, uint32_t RTC_Alarm, RTC_AlarmTypeDef* RTC_AlarmStruct); +ErrorStatus RTC_AlarmCmd(uint32_t RTC_Alarm, FunctionalState NewState); +void RTC_AlarmSubSecondConfig(uint32_t RTC_Alarm, uint32_t RTC_AlarmSubSecondValue, uint32_t RTC_AlarmSubSecondMask); +uint32_t RTC_GetAlarmSubSecond(uint32_t RTC_Alarm); + +/* WakeUp Timer configuration functions ***************************************/ +void RTC_WakeUpClockConfig(uint32_t RTC_WakeUpClock); +void RTC_SetWakeUpCounter(uint32_t RTC_WakeUpCounter); +uint32_t RTC_GetWakeUpCounter(void); +ErrorStatus RTC_WakeUpCmd(FunctionalState NewState); + +/* Daylight Saving configuration functions ************************************/ +void RTC_DayLightSavingConfig(uint32_t RTC_DayLightSaving, uint32_t RTC_StoreOperation); +uint32_t RTC_GetStoreOperation(void); + +/* Output pin Configuration function ******************************************/ +void RTC_OutputConfig(uint32_t RTC_Output, uint32_t RTC_OutputPolarity); + +/* Digital Calibration configuration functions *********************************/ +ErrorStatus RTC_CoarseCalibConfig(uint32_t RTC_CalibSign, uint32_t Value); +ErrorStatus RTC_CoarseCalibCmd(FunctionalState NewState); +void RTC_CalibOutputCmd(FunctionalState NewState); +void RTC_CalibOutputConfig(uint32_t RTC_CalibOutput); +ErrorStatus RTC_SmoothCalibConfig(uint32_t RTC_SmoothCalibPeriod, + uint32_t RTC_SmoothCalibPlusPulses, + uint32_t RTC_SmouthCalibMinusPulsesValue); + +/* TimeStamp configuration functions ******************************************/ +void RTC_TimeStampCmd(uint32_t RTC_TimeStampEdge, FunctionalState NewState); +void RTC_GetTimeStamp(uint32_t RTC_Format, RTC_TimeTypeDef* RTC_StampTimeStruct, + RTC_DateTypeDef* RTC_StampDateStruct); +uint32_t RTC_GetTimeStampSubSecond(void); + +/* Tampers configuration functions ********************************************/ +void RTC_TamperTriggerConfig(uint32_t RTC_Tamper, uint32_t RTC_TamperTrigger); +void RTC_TamperCmd(uint32_t RTC_Tamper, FunctionalState NewState); +void RTC_TamperFilterConfig(uint32_t RTC_TamperFilter); +void RTC_TamperSamplingFreqConfig(uint32_t RTC_TamperSamplingFreq); +void RTC_TamperPinsPrechargeDuration(uint32_t RTC_TamperPrechargeDuration); +void RTC_TimeStampOnTamperDetectionCmd(FunctionalState NewState); +void RTC_TamperPullUpCmd(FunctionalState NewState); + +/* Backup Data Registers configuration functions ******************************/ +void RTC_WriteBackupRegister(uint32_t RTC_BKP_DR, uint32_t Data); +uint32_t RTC_ReadBackupRegister(uint32_t RTC_BKP_DR); + +/* RTC Tamper and TimeStamp Pins Selection and Output Type Config configuration + functions ******************************************************************/ +void RTC_TamperPinSelection(uint32_t RTC_TamperPin); +void RTC_TimeStampPinSelection(uint32_t RTC_TimeStampPin); +void RTC_OutputTypeConfig(uint32_t RTC_OutputType); + +/* RTC_Shift_control_synchonisation_functions *********************************/ +ErrorStatus RTC_SynchroShiftConfig(uint32_t RTC_ShiftAdd1S, uint32_t RTC_ShiftSubFS); + +/* Interrupts and flags management functions **********************************/ +void RTC_ITConfig(uint32_t RTC_IT, FunctionalState NewState); +FlagStatus RTC_GetFlagStatus(uint32_t RTC_FLAG); +void RTC_ClearFlag(uint32_t RTC_FLAG); +ITStatus RTC_GetITStatus(uint32_t RTC_IT); +void RTC_ClearITPendingBit(uint32_t RTC_IT); + +#ifdef __cplusplus +} +#endif + +#endif /*__STM32F4xx_RTC_H */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/inc/stm32f4xx_sai.h b/FWLIB/inc/stm32f4xx_sai.h new file mode 100644 index 0000000..a7805d5 --- /dev/null +++ b/FWLIB/inc/stm32f4xx_sai.h @@ -0,0 +1,611 @@ +/** + ****************************************************************************** + * @file stm32f4xx_sai.h + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file contains all the functions prototypes for the SAI + * firmware library. + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Define to prevent recursive inclusion -------------------------------------*/ +#ifndef __STM32F4xx_SAI_H +#define __STM32F4xx_SAI_H + +#ifdef __cplusplus + extern "C" { +#endif + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @addtogroup SAI + * @{ + */ + +/* Exported types ------------------------------------------------------------*/ + +/** + * @brief SAI Block Init structure definition + */ + +typedef struct +{ + uint32_t SAI_AudioMode; /*!< Specifies the SAI Block Audio Mode. + This parameter can be a value of @ref SAI_Block_Mode */ + + uint32_t SAI_Protocol; /*!< Specifies the SAI Block Protocol. + This parameter can be a value of @ref SAI_Block_Protocol */ + + uint32_t SAI_DataSize; /*!< Specifies the SAI Block data size. + This parameter can be a value of @ref SAI_Block_Data_Size + @note this value is ignored when AC'97 or SPDIF protocols are selected.*/ + + uint32_t SAI_FirstBit; /*!< Specifies whether data transfers start from MSB or LSB bit. + This parameter can be a value of @ref SAI_Block_MSB_LSB_transmission + @note this value has no meaning when AC'97 or SPDIF protocols are selected.*/ + + uint32_t SAI_ClockStrobing; /*!< Specifies the SAI Block clock strobing edge sensitivity. + This parameter can be a value of @ref SAI_Block_Clock_Strobing */ + + uint32_t SAI_Synchro; /*!< Specifies SAI Block synchronization + This parameter can be a value of @ref SAI_Block_Synchronization */ + + uint32_t SAI_OUTDRIV; /*!< Specifies when SAI Block outputs are driven. + This parameter can be a value of @ref SAI_Block_Output_Drive + @note this value has to be set before enabling the audio block + but after the audio block configuration. */ + + uint32_t SAI_NoDivider; /*!< Specifies whether Master Clock will be divided or not. + This parameter can be a value of @ref SAI_Block_NoDivider */ + + uint32_t SAI_MasterDivider; /*!< Specifies SAI Block Master Clock Divider. + @note the Master Clock Frequency is calculated accordingly to the + following formula : MCLK_x = SAI_CK_x/(MCKDIV[3:0]*2)*/ + + uint32_t SAI_FIFOThreshold; /*!< Specifies SAI Block FIFO Threshold. + This parameter can be a value of @ref SAI_Block_Fifo_Threshold */ +}SAI_InitTypeDef; + +/** + * @brief SAI Block Frame Init structure definition + */ + +typedef struct +{ + + uint32_t SAI_FrameLength; /*!< Specifies the Frame Length, the number of SCK clocks + for each audio frame. + This parameter must be a number between 8 and 256. + @note If master Clock MCLK_x pin is declared as an output, the frame length + should be Aligned to a number equal to power of 2 in order to keep + in an audio frame, an integer number of MCLK pulses by bit Clock. + @note this value is ignored when AC'97 or SPDIF protocols are selected.*/ + + uint32_t SAI_ActiveFrameLength; /*!< Specifies the Frame synchronization active level length. + This Parameter specifies the length in number of bit clock (SCK + 1) + of the active level of FS signal in audio frame. + This parameter must be a number between 1 and 128. + @note this value is ignored when AC'97 or SPDIF protocols are selected.*/ + + uint32_t SAI_FSDefinition; /*!< Specifies the Frame Synchronization definition. + This parameter can be a value of @ref SAI_Block_FS_Definition + @note this value is ignored when AC'97 or SPDIF protocols are selected.*/ + + uint32_t SAI_FSPolarity; /*!< Specifies the Frame Synchronization Polarity. + This parameter can be a value of @ref SAI_Block_FS_Polarity + @note this value is ignored when AC'97 or SPDIF protocols are selected.*/ + + uint32_t SAI_FSOffset; /*!< Specifies the Frame Synchronization Offset. + This parameter can be a value of @ref SAI_Block_FS_Offset + @note this value is ignored when AC'97 or SPDIF protocols are selected.*/ + +}SAI_FrameInitTypeDef; + +/** + * @brief SAI Block Slot Init Structure definition + */ + +typedef struct +{ + uint32_t SAI_FirstBitOffset; /*!< Specifies the position of first data transfer bit in the slot. + This parameter must be a number between 0 and 24. + @note this value is ignored when AC'97 or SPDIF protocols are selected.*/ + + uint32_t SAI_SlotSize; /*!< Specifies the Slot Size. + This parameter can be a value of @ref SAI_Block_Slot_Size + @note this value is ignored when AC'97 or SPDIF protocols are selected.*/ + + uint32_t SAI_SlotNumber; /*!< Specifies the number of slot in the audio frame. + This parameter must be a number between 1 and 16. + @note this value is ignored when AC'97 or SPDIF protocols are selected.*/ + + uint32_t SAI_SlotActive; /*!< Specifies the slots in audio frame that will be activated. + This parameter can be a value of @ ref SAI_Block_Slot_Active + @note this value is ignored when AC'97 or SPDIF protocols are selected.*/ +}SAI_SlotInitTypeDef; + +/* Exported constants --------------------------------------------------------*/ + +/** @defgroup SAI_Exported_Constants + * @{ + */ + +#define IS_SAI_PERIPH(PERIPH) ((PERIPH) == SAI1) + +#define IS_SAI_BLOCK_PERIPH(PERIPH) (((PERIPH) == SAI1_Block_A) || \ + ((PERIPH) == SAI1_Block_B)) + + +/** @defgroup SAI_Block_Mode + * @{ + */ +#define SAI_Mode_MasterTx ((uint32_t)0x00000000) +#define SAI_Mode_MasterRx ((uint32_t)0x00000001) +#define SAI_Mode_SlaveTx ((uint32_t)0x00000002) +#define SAI_Mode_SlaveRx ((uint32_t)0x00000003) +#define IS_SAI_BLOCK_MODE(MODE) (((MODE) == SAI_Mode_MasterTx) || \ + ((MODE) == SAI_Mode_MasterRx) || \ + ((MODE) == SAI_Mode_SlaveTx) || \ + ((MODE) == SAI_Mode_SlaveRx)) +/** + * @} + */ + +/** @defgroup SAI_Block_Protocol + * @{ + */ + +#define SAI_Free_Protocol ((uint32_t)0x00000000) +#define SAI_SPDIF_Protocol ((uint32_t)SAI_xCR1_PRTCFG_0) +#define SAI_AC97_Protocol ((uint32_t)SAI_xCR1_PRTCFG_1) +#define IS_SAI_BLOCK_PROTOCOL(PROTOCOL) (((PROTOCOL) == SAI_Free_Protocol) || \ + ((PROTOCOL) == SAI_SPDIF_Protocol) || \ + ((PROTOCOL) == SAI_AC97_Protocol)) +/** + * @} + */ + +/** @defgroup SAI_Block_Data_Size + * @{ + */ + +#define SAI_DataSize_8b ((uint32_t)0x00000040) +#define SAI_DataSize_10b ((uint32_t)0x00000060) +#define SAI_DataSize_16b ((uint32_t)0x00000080) +#define SAI_DataSize_20b ((uint32_t)0x000000A0) +#define SAI_DataSize_24b ((uint32_t)0x000000C0) +#define SAI_DataSize_32b ((uint32_t)0x000000E0) +#define IS_SAI_BLOCK_DATASIZE(DATASIZE) (((DATASIZE) == SAI_DataSize_8b) || \ + ((DATASIZE) == SAI_DataSize_10b) || \ + ((DATASIZE) == SAI_DataSize_16b) || \ + ((DATASIZE) == SAI_DataSize_20b) || \ + ((DATASIZE) == SAI_DataSize_24b) || \ + ((DATASIZE) == SAI_DataSize_32b)) +/** + * @} + */ + +/** @defgroup SAI_Block_MSB_LSB_transmission + * @{ + */ + +#define SAI_FirstBit_MSB ((uint32_t)0x00000000) +#define SAI_FirstBit_LSB ((uint32_t)SAI_xCR1_LSBFIRST) +#define IS_SAI_BLOCK_FIRST_BIT(BIT) (((BIT) == SAI_FirstBit_MSB) || \ + ((BIT) == SAI_FirstBit_LSB)) +/** + * @} + */ + +/** @defgroup SAI_Block_Clock_Strobing + * @{ + */ + +#define SAI_ClockStrobing_FallingEdge ((uint32_t)0x00000000) +#define SAI_ClockStrobing_RisingEdge ((uint32_t)SAI_xCR1_CKSTR) +#define IS_SAI_BLOCK_CLOCK_STROBING(CLOCK) (((CLOCK) == SAI_ClockStrobing_FallingEdge) || \ + ((CLOCK) == SAI_ClockStrobing_RisingEdge)) +/** + * @} + */ + +/** @defgroup SAI_Block_Synchronization + * @{ + */ + +#define SAI_Asynchronous ((uint32_t)0x00000000) +#define SAI_Synchronous ((uint32_t)SAI_xCR1_SYNCEN_0) +#define IS_SAI_BLOCK_SYNCHRO(SYNCHRO) (((SYNCHRO) == SAI_Synchronous) || \ + ((SYNCHRO) == SAI_Asynchronous)) +/** + * @} + */ + +/** @defgroup SAI_Block_Output_Drive + * @{ + */ + +#define SAI_OutputDrive_Disabled ((uint32_t)0x00000000) +#define SAI_OutputDrive_Enabled ((uint32_t)SAI_xCR1_OUTDRIV) +#define IS_SAI_BLOCK_OUTPUT_DRIVE(DRIVE) (((DRIVE) == SAI_OutputDrive_Disabled) || \ + ((DRIVE) == SAI_OutputDrive_Enabled)) +/** + * @} + */ + + + +/** @defgroup SAI_Block_NoDivider + * @{ + */ + +#define SAI_MasterDivider_Enabled ((uint32_t)0x00000000) +#define SAI_MasterDivider_Disabled ((uint32_t)SAI_xCR1_NODIV) +#define IS_SAI_BLOCK_NODIVIDER(NODIVIDER) (((NODIVIDER) == SAI_MasterDivider_Enabled) || \ + ((NODIVIDER) == SAI_MasterDivider_Disabled)) +/** + * @} + */ + + +/** @defgroup SAI_Block_Master_Divider + * @{ + */ +#define IS_SAI_BLOCK_MASTER_DIVIDER(DIVIDER) ((DIVIDER) <= 15) + +/** + * @} + */ + +/** @defgroup SAI_Block_Frame_Length + * @{ + */ +#define IS_SAI_BLOCK_FRAME_LENGTH(LENGTH) ((8 <= (LENGTH)) && ((LENGTH) <= 256)) + +/** + * @} + */ + +/** @defgroup SAI_Block_Active_FrameLength + * @{ + */ +#define IS_SAI_BLOCK_ACTIVE_FRAME(LENGTH) ((1 <= (LENGTH)) && ((LENGTH) <= 128)) + +/** + * @} + */ + +/** @defgroup SAI_Block_FS_Definition + * @{ + */ + +#define SAI_FS_StartFrame ((uint32_t)0x00000000) +#define I2S_FS_ChannelIdentification ((uint32_t)SAI_xFRCR_FSDEF) +#define IS_SAI_BLOCK_FS_DEFINITION(DEFINITION) (((DEFINITION) == SAI_FS_StartFrame) || \ + ((DEFINITION) == I2S_FS_ChannelIdentification)) +/** + * @} + */ + +/** @defgroup SAI_Block_FS_Polarity + * @{ + */ + +#define SAI_FS_ActiveLow ((uint32_t)0x00000000) +#define SAI_FS_ActiveHigh ((uint32_t)SAI_xFRCR_FSPO) +#define IS_SAI_BLOCK_FS_POLARITY(POLARITY) (((POLARITY) == SAI_FS_ActiveLow) || \ + ((POLARITY) == SAI_FS_ActiveHigh)) +/** + * @} + */ + +/** @defgroup SAI_Block_FS_Offset + * @{ + */ + +#define SAI_FS_FirstBit ((uint32_t)0x00000000) +#define SAI_FS_BeforeFirstBit ((uint32_t)SAI_xFRCR_FSOFF) +#define IS_SAI_BLOCK_FS_OFFSET(OFFSET) (((OFFSET) == SAI_FS_FirstBit) || \ + ((OFFSET) == SAI_FS_BeforeFirstBit)) +/** + * @} + */ + +/** @defgroup SAI_Block_Slot_FirstBit_Offset + * @{ + */ +#define IS_SAI_BLOCK_FIRSTBIT_OFFSET(OFFSET) ((OFFSET) <= 24) + +/** + * @} + */ + + /** @defgroup SAI_Block_Slot_Size + * @{ + */ +#define SAI_SlotSize_DataSize ((uint32_t)0x00000000) +#define SAI_SlotSize_16b ((uint32_t)SAI_xSLOTR_SLOTSZ_0) +#define SAI_SlotSize_32b ((uint32_t)SAI_xSLOTR_SLOTSZ_1) +#define IS_SAI_BLOCK_SLOT_SIZE(SIZE) (((SIZE) == SAI_SlotSize_DataSize) || \ + ((SIZE) == SAI_SlotSize_16b) || \ + ((SIZE) == SAI_SlotSize_32b)) + +/** + * @} + */ + +/** @defgroup SAI_Block_Slot_Number + * @{ + */ +#define IS_SAI_BLOCK_SLOT_NUMBER(NUMBER) ((1 <= (NUMBER)) && ((NUMBER) <= 16)) + +/** + * @} + */ + +/** @defgroup SAI_Block_Slot_Active + * @{ + */ +#define SAI_Slot_NotActive ((uint32_t)0x00000000) +#define SAI_SlotActive_0 ((uint32_t)0x00010000) +#define SAI_SlotActive_1 ((uint32_t)0x00020000) +#define SAI_SlotActive_2 ((uint32_t)0x00040000) +#define SAI_SlotActive_3 ((uint32_t)0x00080000) +#define SAI_SlotActive_4 ((uint32_t)0x00100000) +#define SAI_SlotActive_5 ((uint32_t)0x00200000) +#define SAI_SlotActive_6 ((uint32_t)0x00400000) +#define SAI_SlotActive_7 ((uint32_t)0x00800000) +#define SAI_SlotActive_8 ((uint32_t)0x01000000) +#define SAI_SlotActive_9 ((uint32_t)0x02000000) +#define SAI_SlotActive_10 ((uint32_t)0x04000000) +#define SAI_SlotActive_11 ((uint32_t)0x08000000) +#define SAI_SlotActive_12 ((uint32_t)0x10000000) +#define SAI_SlotActive_13 ((uint32_t)0x20000000) +#define SAI_SlotActive_14 ((uint32_t)0x40000000) +#define SAI_SlotActive_15 ((uint32_t)0x80000000) +#define SAI_SlotActive_ALL ((uint32_t)0xFFFF0000) + +#define IS_SAI_SLOT_ACTIVE(ACTIVE) ((ACTIVE) != 0) + +/** + * @} + */ + +/** @defgroup SAI_Mono_Streo_Mode + * @{ + */ + +#define SAI_MonoMode ((uint32_t)SAI_xCR1_MONO) +#define SAI_StreoMode ((uint32_t)0x00000000) +#define IS_SAI_BLOCK_MONO_STREO_MODE(MODE) (((MODE) == SAI_MonoMode) ||\ + ((MODE) == SAI_StreoMode)) +/** + * @} + */ + +/** @defgroup SAI_TRIState_Management + * @{ + */ + +#define SAI_Output_NotReleased ((uint32_t)0x00000000) +#define SAI_Output_Released ((uint32_t)SAI_xCR2_TRIS) +#define IS_SAI_BLOCK_TRISTATE_MANAGEMENT(STATE) (((STATE) == SAI_Output_NotReleased) ||\ + ((STATE) == SAI_Output_Released)) +/** + * @} + */ + +/** @defgroup SAI_Block_Fifo_Threshold + * @{ + */ + +#define SAI_Threshold_FIFOEmpty ((uint32_t)0x00000000) +#define SAI_FIFOThreshold_1QuarterFull ((uint32_t)0x00000001) +#define SAI_FIFOThreshold_HalfFull ((uint32_t)0x00000002) +#define SAI_FIFOThreshold_3QuartersFull ((uint32_t)0x00000003) +#define SAI_FIFOThreshold_Full ((uint32_t)0x00000004) +#define IS_SAI_BLOCK_FIFO_THRESHOLD(THRESHOLD) (((THRESHOLD) == SAI_Threshold_FIFOEmpty) || \ + ((THRESHOLD) == SAI_FIFOThreshold_1QuarterFull) || \ + ((THRESHOLD) == SAI_FIFOThreshold_HalfFull) || \ + ((THRESHOLD) == SAI_FIFOThreshold_3QuartersFull) || \ + ((THRESHOLD) == SAI_FIFOThreshold_Full)) +/** + * @} + */ + +/** @defgroup SAI_Block_Companding_Mode + * @{ + */ + +#define SAI_NoCompanding ((uint32_t)0x00000000) +#define SAI_ULaw_1CPL_Companding ((uint32_t)0x00008000) +#define SAI_ALaw_1CPL_Companding ((uint32_t)0x0000C000) +#define SAI_ULaw_2CPL_Companding ((uint32_t)0x0000A000) +#define SAI_ALaw_2CPL_Companding ((uint32_t)0x0000E000) +#define IS_SAI_BLOCK_COMPANDING_MODE(MODE) (((MODE) == SAI_NoCompanding) || \ + ((MODE) == SAI_ULaw_1CPL_Companding) || \ + ((MODE) == SAI_ALaw_1CPL_Companding) || \ + ((MODE) == SAI_ULaw_2CPL_Companding) || \ + ((MODE) == SAI_ALaw_2CPL_Companding)) +/** + * @} + */ + +/** @defgroup SAI_Block_Mute_Value + * @{ + */ + +#define SAI_ZeroValue ((uint32_t)0x00000000) +#define SAI_LastSentValue ((uint32_t)SAI_xCR2_MUTEVAL) +#define IS_SAI_BLOCK_MUTE_VALUE(VALUE) (((VALUE) == SAI_ZeroValue) || \ + ((VALUE) == SAI_LastSentValue)) +/** + * @} + */ + +/** @defgroup SAI_Block_Mute_Frame_Counter + * @{ + */ + +#define IS_SAI_BLOCK_MUTE_COUNTER(COUNTER) ((COUNTER) <= 63) + +/** + * @} + */ + +/** @defgroup SAI_Block_Interrupts_Definition + * @{ + */ + +#define SAI_IT_OVRUDR ((uint32_t)SAI_xIMR_OVRUDRIE) +#define SAI_IT_MUTEDET ((uint32_t)SAI_xIMR_MUTEDETIE) +#define SAI_IT_WCKCFG ((uint32_t)SAI_xIMR_WCKCFGIE) +#define SAI_IT_FREQ ((uint32_t)SAI_xIMR_FREQIE) +#define SAI_IT_CNRDY ((uint32_t)SAI_xIMR_CNRDYIE) +#define SAI_IT_AFSDET ((uint32_t)SAI_xIMR_AFSDETIE) +#define SAI_IT_LFSDET ((uint32_t)SAI_xIMR_LFSDETIE) + +#define IS_SAI_BLOCK_CONFIG_IT(IT) (((IT) == SAI_IT_OVRUDR) || \ + ((IT) == SAI_IT_MUTEDET) || \ + ((IT) == SAI_IT_WCKCFG) || \ + ((IT) == SAI_IT_FREQ) || \ + ((IT) == SAI_IT_CNRDY) || \ + ((IT) == SAI_IT_AFSDET) || \ + ((IT) == SAI_IT_LFSDET)) +/** + * @} + */ + +/** @defgroup SAI_Block_Flags_Definition + * @{ + */ + +#define SAI_FLAG_OVRUDR ((uint32_t)SAI_xSR_OVRUDR) +#define SAI_FLAG_MUTEDET ((uint32_t)SAI_xSR_MUTEDET) +#define SAI_FLAG_WCKCFG ((uint32_t)SAI_xSR_WCKCFG) +#define SAI_FLAG_FREQ ((uint32_t)SAI_xSR_FREQ) +#define SAI_FLAG_CNRDY ((uint32_t)SAI_xSR_CNRDY) +#define SAI_FLAG_AFSDET ((uint32_t)SAI_xSR_AFSDET) +#define SAI_FLAG_LFSDET ((uint32_t)SAI_xSR_LFSDET) + +#define IS_SAI_BLOCK_GET_FLAG(FLAG) (((FLAG) == SAI_FLAG_OVRUDR) || \ + ((FLAG) == SAI_FLAG_MUTEDET) || \ + ((FLAG) == SAI_FLAG_WCKCFG) || \ + ((FLAG) == SAI_FLAG_FREQ) || \ + ((FLAG) == SAI_FLAG_CNRDY) || \ + ((FLAG) == SAI_FLAG_AFSDET) || \ + ((FLAG) == SAI_FLAG_LFSDET)) + +#define IS_SAI_BLOCK_CLEAR_FLAG(FLAG) (((FLAG) == SAI_FLAG_OVRUDR) || \ + ((FLAG) == SAI_FLAG_MUTEDET) || \ + ((FLAG) == SAI_FLAG_WCKCFG) || \ + ((FLAG) == SAI_FLAG_FREQ) || \ + ((FLAG) == SAI_FLAG_CNRDY) || \ + ((FLAG) == SAI_FLAG_AFSDET) || \ + ((FLAG) == SAI_FLAG_LFSDET)) +/** + * @} + */ + +/** @defgroup SAI_Block_Fifo_Status_Level + * @{ + */ +#define SAI_FIFOStatus_Empty ((uint32_t)0x00000000) +#define SAI_FIFOStatus_Less1QuarterFull ((uint32_t)0x00010000) +#define SAI_FIFOStatus_1QuarterFull ((uint32_t)0x00020000) +#define SAI_FIFOStatus_HalfFull ((uint32_t)0x00030000) +#define SAI_FIFOStatus_3QuartersFull ((uint32_t)0x00040000) +#define SAI_FIFOStatus_Full ((uint32_t)0x00050000) + +#define IS_SAI_BLOCK_FIFO_STATUS(STATUS) (((STATUS) == SAI_FIFOStatus_Less1QuarterFull ) || \ + ((STATUS) == SAI_FIFOStatus_HalfFull) || \ + ((STATUS) == SAI_FIFOStatus_1QuarterFull) || \ + ((STATUS) == SAI_FIFOStatus_3QuartersFull) || \ + ((STATUS) == SAI_FIFOStatus_Full) || \ + ((STATUS) == SAI_FIFOStatus_Empty)) +/** + * @} + */ + + +/** + * @} + */ + +/* Exported macro ------------------------------------------------------------*/ +/* Exported functions --------------------------------------------------------*/ + +/* Function used to set the SAI configuration to the default reset state *****/ +void SAI_DeInit(SAI_TypeDef* SAIx); + +/* Initialization and Configuration functions *********************************/ +void SAI_Init(SAI_Block_TypeDef* SAI_Block_x, SAI_InitTypeDef* SAI_InitStruct); +void SAI_FrameInit(SAI_Block_TypeDef* SAI_Block_x, SAI_FrameInitTypeDef* SAI_FrameInitStruct); +void SAI_SlotInit(SAI_Block_TypeDef* SAI_Block_x, SAI_SlotInitTypeDef* SAI_SlotInitStruct); +void SAI_StructInit(SAI_InitTypeDef* SAI_InitStruct); +void SAI_FrameStructInit(SAI_FrameInitTypeDef* SAI_FrameInitStruct); +void SAI_SlotStructInit(SAI_SlotInitTypeDef* SAI_SlotInitStruct); + +void SAI_Cmd(SAI_Block_TypeDef* SAI_Block_x, FunctionalState NewState); +void SAI_MonoModeConfig(SAI_Block_TypeDef* SAI_Block_x, uint32_t SAI_Mono_StreoMode); +void SAI_TRIStateConfig(SAI_Block_TypeDef* SAI_Block_x, uint32_t SAI_TRIState); +void SAI_CompandingModeConfig(SAI_Block_TypeDef* SAI_Block_x, uint32_t SAI_CompandingMode); +void SAI_MuteModeCmd(SAI_Block_TypeDef* SAI_Block_x, FunctionalState NewState); +void SAI_MuteValueConfig(SAI_Block_TypeDef* SAI_Block_x, uint32_t SAI_MuteValue); +void SAI_MuteFrameCounterConfig(SAI_Block_TypeDef* SAI_Block_x, uint32_t SAI_MuteCounter); +void SAI_FlushFIFO(SAI_Block_TypeDef* SAI_Block_x); + +/* Data transfers functions ***************************************************/ +void SAI_SendData(SAI_Block_TypeDef* SAI_Block_x, uint32_t Data); +uint32_t SAI_ReceiveData(SAI_Block_TypeDef* SAI_Block_x); + +/* DMA transfers management functions *****************************************/ +void SAI_DMACmd(SAI_Block_TypeDef* SAI_Block_x, FunctionalState NewState); + +/* Interrupts and flags management functions **********************************/ +void SAI_ITConfig(SAI_Block_TypeDef* SAI_Block_x, uint32_t SAI_IT, FunctionalState NewState); +FlagStatus SAI_GetFlagStatus(SAI_Block_TypeDef* SAI_Block_x, uint32_t SAI_FLAG); +void SAI_ClearFlag(SAI_Block_TypeDef* SAI_Block_x, uint32_t SAI_FLAG); +ITStatus SAI_GetITStatus(SAI_Block_TypeDef* SAI_Block_x, uint32_t SAI_IT); +void SAI_ClearITPendingBit(SAI_Block_TypeDef* SAI_Block_x, uint32_t SAI_IT); +FunctionalState SAI_GetCmdStatus(SAI_Block_TypeDef* SAI_Block_x); +uint32_t SAI_GetFIFOStatus(SAI_Block_TypeDef* SAI_Block_x); + +#ifdef __cplusplus +} +#endif + +#endif /*__STM32F4xx_SAI_H */ + +/** + * @} + */ + +/** + * @} + */ + +/******************* (C) COPYRIGHT 2011 STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/inc/stm32f4xx_sdio.h b/FWLIB/inc/stm32f4xx_sdio.h new file mode 100644 index 0000000..6b1b2bb --- /dev/null +++ b/FWLIB/inc/stm32f4xx_sdio.h @@ -0,0 +1,536 @@ +/** + ****************************************************************************** + * @file stm32f4xx_sdio.h + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file contains all the functions prototypes for the SDIO firmware + * library. + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Define to prevent recursive inclusion -------------------------------------*/ +#ifndef __STM32F4xx_SDIO_H +#define __STM32F4xx_SDIO_H + +#ifdef __cplusplus + extern "C" { +#endif + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @addtogroup SDIO + * @{ + */ + +/* Exported types ------------------------------------------------------------*/ + +typedef struct +{ + uint32_t SDIO_ClockEdge; /*!< Specifies the clock transition on which the bit capture is made. + This parameter can be a value of @ref SDIO_Clock_Edge */ + + uint32_t SDIO_ClockBypass; /*!< Specifies whether the SDIO Clock divider bypass is + enabled or disabled. + This parameter can be a value of @ref SDIO_Clock_Bypass */ + + uint32_t SDIO_ClockPowerSave; /*!< Specifies whether SDIO Clock output is enabled or + disabled when the bus is idle. + This parameter can be a value of @ref SDIO_Clock_Power_Save */ + + uint32_t SDIO_BusWide; /*!< Specifies the SDIO bus width. + This parameter can be a value of @ref SDIO_Bus_Wide */ + + uint32_t SDIO_HardwareFlowControl; /*!< Specifies whether the SDIO hardware flow control is enabled or disabled. + This parameter can be a value of @ref SDIO_Hardware_Flow_Control */ + + uint8_t SDIO_ClockDiv; /*!< Specifies the clock frequency of the SDIO controller. + This parameter can be a value between 0x00 and 0xFF. */ + +} SDIO_InitTypeDef; + +typedef struct +{ + uint32_t SDIO_Argument; /*!< Specifies the SDIO command argument which is sent + to a card as part of a command message. If a command + contains an argument, it must be loaded into this register + before writing the command to the command register */ + + uint32_t SDIO_CmdIndex; /*!< Specifies the SDIO command index. It must be lower than 0x40. */ + + uint32_t SDIO_Response; /*!< Specifies the SDIO response type. + This parameter can be a value of @ref SDIO_Response_Type */ + + uint32_t SDIO_Wait; /*!< Specifies whether SDIO wait for interrupt request is enabled or disabled. + This parameter can be a value of @ref SDIO_Wait_Interrupt_State */ + + uint32_t SDIO_CPSM; /*!< Specifies whether SDIO Command path state machine (CPSM) + is enabled or disabled. + This parameter can be a value of @ref SDIO_CPSM_State */ +} SDIO_CmdInitTypeDef; + +typedef struct +{ + uint32_t SDIO_DataTimeOut; /*!< Specifies the data timeout period in card bus clock periods. */ + + uint32_t SDIO_DataLength; /*!< Specifies the number of data bytes to be transferred. */ + + uint32_t SDIO_DataBlockSize; /*!< Specifies the data block size for block transfer. + This parameter can be a value of @ref SDIO_Data_Block_Size */ + + uint32_t SDIO_TransferDir; /*!< Specifies the data transfer direction, whether the transfer + is a read or write. + This parameter can be a value of @ref SDIO_Transfer_Direction */ + + uint32_t SDIO_TransferMode; /*!< Specifies whether data transfer is in stream or block mode. + This parameter can be a value of @ref SDIO_Transfer_Type */ + + uint32_t SDIO_DPSM; /*!< Specifies whether SDIO Data path state machine (DPSM) + is enabled or disabled. + This parameter can be a value of @ref SDIO_DPSM_State */ +} SDIO_DataInitTypeDef; + + +/* Exported constants --------------------------------------------------------*/ + +/** @defgroup SDIO_Exported_Constants + * @{ + */ + +/** @defgroup SDIO_Clock_Edge + * @{ + */ + +#define SDIO_ClockEdge_Rising ((uint32_t)0x00000000) +#define SDIO_ClockEdge_Falling ((uint32_t)0x00002000) +#define IS_SDIO_CLOCK_EDGE(EDGE) (((EDGE) == SDIO_ClockEdge_Rising) || \ + ((EDGE) == SDIO_ClockEdge_Falling)) +/** + * @} + */ + +/** @defgroup SDIO_Clock_Bypass + * @{ + */ + +#define SDIO_ClockBypass_Disable ((uint32_t)0x00000000) +#define SDIO_ClockBypass_Enable ((uint32_t)0x00000400) +#define IS_SDIO_CLOCK_BYPASS(BYPASS) (((BYPASS) == SDIO_ClockBypass_Disable) || \ + ((BYPASS) == SDIO_ClockBypass_Enable)) +/** + * @} + */ + +/** @defgroup SDIO_Clock_Power_Save + * @{ + */ + +#define SDIO_ClockPowerSave_Disable ((uint32_t)0x00000000) +#define SDIO_ClockPowerSave_Enable ((uint32_t)0x00000200) +#define IS_SDIO_CLOCK_POWER_SAVE(SAVE) (((SAVE) == SDIO_ClockPowerSave_Disable) || \ + ((SAVE) == SDIO_ClockPowerSave_Enable)) +/** + * @} + */ + +/** @defgroup SDIO_Bus_Wide + * @{ + */ + +#define SDIO_BusWide_1b ((uint32_t)0x00000000) +#define SDIO_BusWide_4b ((uint32_t)0x00000800) +#define SDIO_BusWide_8b ((uint32_t)0x00001000) +#define IS_SDIO_BUS_WIDE(WIDE) (((WIDE) == SDIO_BusWide_1b) || ((WIDE) == SDIO_BusWide_4b) || \ + ((WIDE) == SDIO_BusWide_8b)) + +/** + * @} + */ + +/** @defgroup SDIO_Hardware_Flow_Control + * @{ + */ + +#define SDIO_HardwareFlowControl_Disable ((uint32_t)0x00000000) +#define SDIO_HardwareFlowControl_Enable ((uint32_t)0x00004000) +#define IS_SDIO_HARDWARE_FLOW_CONTROL(CONTROL) (((CONTROL) == SDIO_HardwareFlowControl_Disable) || \ + ((CONTROL) == SDIO_HardwareFlowControl_Enable)) +/** + * @} + */ + +/** @defgroup SDIO_Power_State + * @{ + */ + +#define SDIO_PowerState_OFF ((uint32_t)0x00000000) +#define SDIO_PowerState_ON ((uint32_t)0x00000003) +#define IS_SDIO_POWER_STATE(STATE) (((STATE) == SDIO_PowerState_OFF) || ((STATE) == SDIO_PowerState_ON)) +/** + * @} + */ + + +/** @defgroup SDIO_Interrupt_sources + * @{ + */ + +#define SDIO_IT_CCRCFAIL ((uint32_t)0x00000001) +#define SDIO_IT_DCRCFAIL ((uint32_t)0x00000002) +#define SDIO_IT_CTIMEOUT ((uint32_t)0x00000004) +#define SDIO_IT_DTIMEOUT ((uint32_t)0x00000008) +#define SDIO_IT_TXUNDERR ((uint32_t)0x00000010) +#define SDIO_IT_RXOVERR ((uint32_t)0x00000020) +#define SDIO_IT_CMDREND ((uint32_t)0x00000040) +#define SDIO_IT_CMDSENT ((uint32_t)0x00000080) +#define SDIO_IT_DATAEND ((uint32_t)0x00000100) +#define SDIO_IT_STBITERR ((uint32_t)0x00000200) +#define SDIO_IT_DBCKEND ((uint32_t)0x00000400) +#define SDIO_IT_CMDACT ((uint32_t)0x00000800) +#define SDIO_IT_TXACT ((uint32_t)0x00001000) +#define SDIO_IT_RXACT ((uint32_t)0x00002000) +#define SDIO_IT_TXFIFOHE ((uint32_t)0x00004000) +#define SDIO_IT_RXFIFOHF ((uint32_t)0x00008000) +#define SDIO_IT_TXFIFOF ((uint32_t)0x00010000) +#define SDIO_IT_RXFIFOF ((uint32_t)0x00020000) +#define SDIO_IT_TXFIFOE ((uint32_t)0x00040000) +#define SDIO_IT_RXFIFOE ((uint32_t)0x00080000) +#define SDIO_IT_TXDAVL ((uint32_t)0x00100000) +#define SDIO_IT_RXDAVL ((uint32_t)0x00200000) +#define SDIO_IT_SDIOIT ((uint32_t)0x00400000) +#define SDIO_IT_CEATAEND ((uint32_t)0x00800000) +#define IS_SDIO_IT(IT) ((((IT) & (uint32_t)0xFF000000) == 0x00) && ((IT) != (uint32_t)0x00)) +/** + * @} + */ + +/** @defgroup SDIO_Command_Index + * @{ + */ + +#define IS_SDIO_CMD_INDEX(INDEX) ((INDEX) < 0x40) +/** + * @} + */ + +/** @defgroup SDIO_Response_Type + * @{ + */ + +#define SDIO_Response_No ((uint32_t)0x00000000) +#define SDIO_Response_Short ((uint32_t)0x00000040) +#define SDIO_Response_Long ((uint32_t)0x000000C0) +#define IS_SDIO_RESPONSE(RESPONSE) (((RESPONSE) == SDIO_Response_No) || \ + ((RESPONSE) == SDIO_Response_Short) || \ + ((RESPONSE) == SDIO_Response_Long)) +/** + * @} + */ + +/** @defgroup SDIO_Wait_Interrupt_State + * @{ + */ + +#define SDIO_Wait_No ((uint32_t)0x00000000) /*!< SDIO No Wait, TimeOut is enabled */ +#define SDIO_Wait_IT ((uint32_t)0x00000100) /*!< SDIO Wait Interrupt Request */ +#define SDIO_Wait_Pend ((uint32_t)0x00000200) /*!< SDIO Wait End of transfer */ +#define IS_SDIO_WAIT(WAIT) (((WAIT) == SDIO_Wait_No) || ((WAIT) == SDIO_Wait_IT) || \ + ((WAIT) == SDIO_Wait_Pend)) +/** + * @} + */ + +/** @defgroup SDIO_CPSM_State + * @{ + */ + +#define SDIO_CPSM_Disable ((uint32_t)0x00000000) +#define SDIO_CPSM_Enable ((uint32_t)0x00000400) +#define IS_SDIO_CPSM(CPSM) (((CPSM) == SDIO_CPSM_Enable) || ((CPSM) == SDIO_CPSM_Disable)) +/** + * @} + */ + +/** @defgroup SDIO_Response_Registers + * @{ + */ + +#define SDIO_RESP1 ((uint32_t)0x00000000) +#define SDIO_RESP2 ((uint32_t)0x00000004) +#define SDIO_RESP3 ((uint32_t)0x00000008) +#define SDIO_RESP4 ((uint32_t)0x0000000C) +#define IS_SDIO_RESP(RESP) (((RESP) == SDIO_RESP1) || ((RESP) == SDIO_RESP2) || \ + ((RESP) == SDIO_RESP3) || ((RESP) == SDIO_RESP4)) +/** + * @} + */ + +/** @defgroup SDIO_Data_Length + * @{ + */ + +#define IS_SDIO_DATA_LENGTH(LENGTH) ((LENGTH) <= 0x01FFFFFF) +/** + * @} + */ + +/** @defgroup SDIO_Data_Block_Size + * @{ + */ + +#define SDIO_DataBlockSize_1b ((uint32_t)0x00000000) +#define SDIO_DataBlockSize_2b ((uint32_t)0x00000010) +#define SDIO_DataBlockSize_4b ((uint32_t)0x00000020) +#define SDIO_DataBlockSize_8b ((uint32_t)0x00000030) +#define SDIO_DataBlockSize_16b ((uint32_t)0x00000040) +#define SDIO_DataBlockSize_32b ((uint32_t)0x00000050) +#define SDIO_DataBlockSize_64b ((uint32_t)0x00000060) +#define SDIO_DataBlockSize_128b ((uint32_t)0x00000070) +#define SDIO_DataBlockSize_256b ((uint32_t)0x00000080) +#define SDIO_DataBlockSize_512b ((uint32_t)0x00000090) +#define SDIO_DataBlockSize_1024b ((uint32_t)0x000000A0) +#define SDIO_DataBlockSize_2048b ((uint32_t)0x000000B0) +#define SDIO_DataBlockSize_4096b ((uint32_t)0x000000C0) +#define SDIO_DataBlockSize_8192b ((uint32_t)0x000000D0) +#define SDIO_DataBlockSize_16384b ((uint32_t)0x000000E0) +#define IS_SDIO_BLOCK_SIZE(SIZE) (((SIZE) == SDIO_DataBlockSize_1b) || \ + ((SIZE) == SDIO_DataBlockSize_2b) || \ + ((SIZE) == SDIO_DataBlockSize_4b) || \ + ((SIZE) == SDIO_DataBlockSize_8b) || \ + ((SIZE) == SDIO_DataBlockSize_16b) || \ + ((SIZE) == SDIO_DataBlockSize_32b) || \ + ((SIZE) == SDIO_DataBlockSize_64b) || \ + ((SIZE) == SDIO_DataBlockSize_128b) || \ + ((SIZE) == SDIO_DataBlockSize_256b) || \ + ((SIZE) == SDIO_DataBlockSize_512b) || \ + ((SIZE) == SDIO_DataBlockSize_1024b) || \ + ((SIZE) == SDIO_DataBlockSize_2048b) || \ + ((SIZE) == SDIO_DataBlockSize_4096b) || \ + ((SIZE) == SDIO_DataBlockSize_8192b) || \ + ((SIZE) == SDIO_DataBlockSize_16384b)) +/** + * @} + */ + +/** @defgroup SDIO_Transfer_Direction + * @{ + */ + +#define SDIO_TransferDir_ToCard ((uint32_t)0x00000000) +#define SDIO_TransferDir_ToSDIO ((uint32_t)0x00000002) +#define IS_SDIO_TRANSFER_DIR(DIR) (((DIR) == SDIO_TransferDir_ToCard) || \ + ((DIR) == SDIO_TransferDir_ToSDIO)) +/** + * @} + */ + +/** @defgroup SDIO_Transfer_Type + * @{ + */ + +#define SDIO_TransferMode_Block ((uint32_t)0x00000000) +#define SDIO_TransferMode_Stream ((uint32_t)0x00000004) +#define IS_SDIO_TRANSFER_MODE(MODE) (((MODE) == SDIO_TransferMode_Stream) || \ + ((MODE) == SDIO_TransferMode_Block)) +/** + * @} + */ + +/** @defgroup SDIO_DPSM_State + * @{ + */ + +#define SDIO_DPSM_Disable ((uint32_t)0x00000000) +#define SDIO_DPSM_Enable ((uint32_t)0x00000001) +#define IS_SDIO_DPSM(DPSM) (((DPSM) == SDIO_DPSM_Enable) || ((DPSM) == SDIO_DPSM_Disable)) +/** + * @} + */ + +/** @defgroup SDIO_Flags + * @{ + */ + +#define SDIO_FLAG_CCRCFAIL ((uint32_t)0x00000001) +#define SDIO_FLAG_DCRCFAIL ((uint32_t)0x00000002) +#define SDIO_FLAG_CTIMEOUT ((uint32_t)0x00000004) +#define SDIO_FLAG_DTIMEOUT ((uint32_t)0x00000008) +#define SDIO_FLAG_TXUNDERR ((uint32_t)0x00000010) +#define SDIO_FLAG_RXOVERR ((uint32_t)0x00000020) +#define SDIO_FLAG_CMDREND ((uint32_t)0x00000040) +#define SDIO_FLAG_CMDSENT ((uint32_t)0x00000080) +#define SDIO_FLAG_DATAEND ((uint32_t)0x00000100) +#define SDIO_FLAG_STBITERR ((uint32_t)0x00000200) +#define SDIO_FLAG_DBCKEND ((uint32_t)0x00000400) +#define SDIO_FLAG_CMDACT ((uint32_t)0x00000800) +#define SDIO_FLAG_TXACT ((uint32_t)0x00001000) +#define SDIO_FLAG_RXACT ((uint32_t)0x00002000) +#define SDIO_FLAG_TXFIFOHE ((uint32_t)0x00004000) +#define SDIO_FLAG_RXFIFOHF ((uint32_t)0x00008000) +#define SDIO_FLAG_TXFIFOF ((uint32_t)0x00010000) +#define SDIO_FLAG_RXFIFOF ((uint32_t)0x00020000) +#define SDIO_FLAG_TXFIFOE ((uint32_t)0x00040000) +#define SDIO_FLAG_RXFIFOE ((uint32_t)0x00080000) +#define SDIO_FLAG_TXDAVL ((uint32_t)0x00100000) +#define SDIO_FLAG_RXDAVL ((uint32_t)0x00200000) +#define SDIO_FLAG_SDIOIT ((uint32_t)0x00400000) +#define SDIO_FLAG_CEATAEND ((uint32_t)0x00800000) +#define IS_SDIO_FLAG(FLAG) (((FLAG) == SDIO_FLAG_CCRCFAIL) || \ + ((FLAG) == SDIO_FLAG_DCRCFAIL) || \ + ((FLAG) == SDIO_FLAG_CTIMEOUT) || \ + ((FLAG) == SDIO_FLAG_DTIMEOUT) || \ + ((FLAG) == SDIO_FLAG_TXUNDERR) || \ + ((FLAG) == SDIO_FLAG_RXOVERR) || \ + ((FLAG) == SDIO_FLAG_CMDREND) || \ + ((FLAG) == SDIO_FLAG_CMDSENT) || \ + ((FLAG) == SDIO_FLAG_DATAEND) || \ + ((FLAG) == SDIO_FLAG_STBITERR) || \ + ((FLAG) == SDIO_FLAG_DBCKEND) || \ + ((FLAG) == SDIO_FLAG_CMDACT) || \ + ((FLAG) == SDIO_FLAG_TXACT) || \ + ((FLAG) == SDIO_FLAG_RXACT) || \ + ((FLAG) == SDIO_FLAG_TXFIFOHE) || \ + ((FLAG) == SDIO_FLAG_RXFIFOHF) || \ + ((FLAG) == SDIO_FLAG_TXFIFOF) || \ + ((FLAG) == SDIO_FLAG_RXFIFOF) || \ + ((FLAG) == SDIO_FLAG_TXFIFOE) || \ + ((FLAG) == SDIO_FLAG_RXFIFOE) || \ + ((FLAG) == SDIO_FLAG_TXDAVL) || \ + ((FLAG) == SDIO_FLAG_RXDAVL) || \ + ((FLAG) == SDIO_FLAG_SDIOIT) || \ + ((FLAG) == SDIO_FLAG_CEATAEND)) + +#define IS_SDIO_CLEAR_FLAG(FLAG) ((((FLAG) & (uint32_t)0xFF3FF800) == 0x00) && ((FLAG) != (uint32_t)0x00)) + +#define IS_SDIO_GET_IT(IT) (((IT) == SDIO_IT_CCRCFAIL) || \ + ((IT) == SDIO_IT_DCRCFAIL) || \ + ((IT) == SDIO_IT_CTIMEOUT) || \ + ((IT) == SDIO_IT_DTIMEOUT) || \ + ((IT) == SDIO_IT_TXUNDERR) || \ + ((IT) == SDIO_IT_RXOVERR) || \ + ((IT) == SDIO_IT_CMDREND) || \ + ((IT) == SDIO_IT_CMDSENT) || \ + ((IT) == SDIO_IT_DATAEND) || \ + ((IT) == SDIO_IT_STBITERR) || \ + ((IT) == SDIO_IT_DBCKEND) || \ + ((IT) == SDIO_IT_CMDACT) || \ + ((IT) == SDIO_IT_TXACT) || \ + ((IT) == SDIO_IT_RXACT) || \ + ((IT) == SDIO_IT_TXFIFOHE) || \ + ((IT) == SDIO_IT_RXFIFOHF) || \ + ((IT) == SDIO_IT_TXFIFOF) || \ + ((IT) == SDIO_IT_RXFIFOF) || \ + ((IT) == SDIO_IT_TXFIFOE) || \ + ((IT) == SDIO_IT_RXFIFOE) || \ + ((IT) == SDIO_IT_TXDAVL) || \ + ((IT) == SDIO_IT_RXDAVL) || \ + ((IT) == SDIO_IT_SDIOIT) || \ + ((IT) == SDIO_IT_CEATAEND)) + +#define IS_SDIO_CLEAR_IT(IT) ((((IT) & (uint32_t)0xFF3FF800) == 0x00) && ((IT) != (uint32_t)0x00)) + +/** + * @} + */ + +/** @defgroup SDIO_Read_Wait_Mode + * @{ + */ + +#define SDIO_ReadWaitMode_DATA2 ((uint32_t)0x00000000) +#define SDIO_ReadWaitMode_CLK ((uint32_t)0x00000001) +#define IS_SDIO_READWAIT_MODE(MODE) (((MODE) == SDIO_ReadWaitMode_CLK) || \ + ((MODE) == SDIO_ReadWaitMode_DATA2)) +/** + * @} + */ + +/** + * @} + */ + +/* Exported macro ------------------------------------------------------------*/ +/* Exported functions --------------------------------------------------------*/ +/* Function used to set the SDIO configuration to the default reset state ****/ +void SDIO_DeInit(void); + +/* Initialization and Configuration functions *********************************/ +void SDIO_Init(SDIO_InitTypeDef* SDIO_InitStruct); +void SDIO_StructInit(SDIO_InitTypeDef* SDIO_InitStruct); +void SDIO_ClockCmd(FunctionalState NewState); +void SDIO_SetPowerState(uint32_t SDIO_PowerState); +uint32_t SDIO_GetPowerState(void); + +/* Command path state machine (CPSM) management functions *********************/ +void SDIO_SendCommand(SDIO_CmdInitTypeDef *SDIO_CmdInitStruct); +void SDIO_CmdStructInit(SDIO_CmdInitTypeDef* SDIO_CmdInitStruct); +uint8_t SDIO_GetCommandResponse(void); +uint32_t SDIO_GetResponse(uint32_t SDIO_RESP); + +/* Data path state machine (DPSM) management functions ************************/ +void SDIO_DataConfig(SDIO_DataInitTypeDef* SDIO_DataInitStruct); +void SDIO_DataStructInit(SDIO_DataInitTypeDef* SDIO_DataInitStruct); +uint32_t SDIO_GetDataCounter(void); +uint32_t SDIO_ReadData(void); +void SDIO_WriteData(uint32_t Data); +uint32_t SDIO_GetFIFOCount(void); + +/* SDIO IO Cards mode management functions ************************************/ +void SDIO_StartSDIOReadWait(FunctionalState NewState); +void SDIO_StopSDIOReadWait(FunctionalState NewState); +void SDIO_SetSDIOReadWaitMode(uint32_t SDIO_ReadWaitMode); +void SDIO_SetSDIOOperation(FunctionalState NewState); +void SDIO_SendSDIOSuspendCmd(FunctionalState NewState); + +/* CE-ATA mode management functions *******************************************/ +void SDIO_CommandCompletionCmd(FunctionalState NewState); +void SDIO_CEATAITCmd(FunctionalState NewState); +void SDIO_SendCEATACmd(FunctionalState NewState); + +/* DMA transfers management functions *****************************************/ +void SDIO_DMACmd(FunctionalState NewState); + +/* Interrupts and flags management functions **********************************/ +void SDIO_ITConfig(uint32_t SDIO_IT, FunctionalState NewState); +FlagStatus SDIO_GetFlagStatus(uint32_t SDIO_FLAG); +void SDIO_ClearFlag(uint32_t SDIO_FLAG); +ITStatus SDIO_GetITStatus(uint32_t SDIO_IT); +void SDIO_ClearITPendingBit(uint32_t SDIO_IT); + +#ifdef __cplusplus +} +#endif + +#endif /* __STM32F4xx_SDIO_H */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/inc/stm32f4xx_spi.h b/FWLIB/inc/stm32f4xx_spi.h new file mode 100644 index 0000000..41e8e22 --- /dev/null +++ b/FWLIB/inc/stm32f4xx_spi.h @@ -0,0 +1,549 @@ +/** + ****************************************************************************** + * @file stm32f4xx_spi.h + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file contains all the functions prototypes for the SPI + * firmware library. + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Define to prevent recursive inclusion -------------------------------------*/ +#ifndef __STM32F4xx_SPI_H +#define __STM32F4xx_SPI_H + +#ifdef __cplusplus + extern "C" { +#endif + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @addtogroup SPI + * @{ + */ + +/* Exported types ------------------------------------------------------------*/ + +/** + * @brief SPI Init structure definition + */ + +typedef struct +{ + uint16_t SPI_Direction; /*!< Specifies the SPI unidirectional or bidirectional data mode. + This parameter can be a value of @ref SPI_data_direction */ + + uint16_t SPI_Mode; /*!< Specifies the SPI operating mode. + This parameter can be a value of @ref SPI_mode */ + + uint16_t SPI_DataSize; /*!< Specifies the SPI data size. + This parameter can be a value of @ref SPI_data_size */ + + uint16_t SPI_CPOL; /*!< Specifies the serial clock steady state. + This parameter can be a value of @ref SPI_Clock_Polarity */ + + uint16_t SPI_CPHA; /*!< Specifies the clock active edge for the bit capture. + This parameter can be a value of @ref SPI_Clock_Phase */ + + uint16_t SPI_NSS; /*!< Specifies whether the NSS signal is managed by + hardware (NSS pin) or by software using the SSI bit. + This parameter can be a value of @ref SPI_Slave_Select_management */ + + uint16_t SPI_BaudRatePrescaler; /*!< Specifies the Baud Rate prescaler value which will be + used to configure the transmit and receive SCK clock. + This parameter can be a value of @ref SPI_BaudRate_Prescaler + @note The communication clock is derived from the master + clock. The slave clock does not need to be set. */ + + uint16_t SPI_FirstBit; /*!< Specifies whether data transfers start from MSB or LSB bit. + This parameter can be a value of @ref SPI_MSB_LSB_transmission */ + + uint16_t SPI_CRCPolynomial; /*!< Specifies the polynomial used for the CRC calculation. */ +}SPI_InitTypeDef; + +/** + * @brief I2S Init structure definition + */ + +typedef struct +{ + + uint16_t I2S_Mode; /*!< Specifies the I2S operating mode. + This parameter can be a value of @ref I2S_Mode */ + + uint16_t I2S_Standard; /*!< Specifies the standard used for the I2S communication. + This parameter can be a value of @ref I2S_Standard */ + + uint16_t I2S_DataFormat; /*!< Specifies the data format for the I2S communication. + This parameter can be a value of @ref I2S_Data_Format */ + + uint16_t I2S_MCLKOutput; /*!< Specifies whether the I2S MCLK output is enabled or not. + This parameter can be a value of @ref I2S_MCLK_Output */ + + uint32_t I2S_AudioFreq; /*!< Specifies the frequency selected for the I2S communication. + This parameter can be a value of @ref I2S_Audio_Frequency */ + + uint16_t I2S_CPOL; /*!< Specifies the idle state of the I2S clock. + This parameter can be a value of @ref I2S_Clock_Polarity */ +}I2S_InitTypeDef; + +/* Exported constants --------------------------------------------------------*/ + +/** @defgroup SPI_Exported_Constants + * @{ + */ + +#define IS_SPI_ALL_PERIPH(PERIPH) (((PERIPH) == SPI1) || \ + ((PERIPH) == SPI2) || \ + ((PERIPH) == SPI3) || \ + ((PERIPH) == SPI4) || \ + ((PERIPH) == SPI5) || \ + ((PERIPH) == SPI6)) + +#define IS_SPI_ALL_PERIPH_EXT(PERIPH) (((PERIPH) == SPI1) || \ + ((PERIPH) == SPI2) || \ + ((PERIPH) == SPI3) || \ + ((PERIPH) == SPI4) || \ + ((PERIPH) == SPI5) || \ + ((PERIPH) == SPI6) || \ + ((PERIPH) == I2S2ext) || \ + ((PERIPH) == I2S3ext)) + +#define IS_SPI_23_PERIPH(PERIPH) (((PERIPH) == SPI2) || \ + ((PERIPH) == SPI3)) + +#define IS_SPI_23_PERIPH_EXT(PERIPH) (((PERIPH) == SPI2) || \ + ((PERIPH) == SPI3) || \ + ((PERIPH) == I2S2ext) || \ + ((PERIPH) == I2S3ext)) + +#define IS_I2S_EXT_PERIPH(PERIPH) (((PERIPH) == I2S2ext) || \ + ((PERIPH) == I2S3ext)) + + +/** @defgroup SPI_data_direction + * @{ + */ + +#define SPI_Direction_2Lines_FullDuplex ((uint16_t)0x0000) +#define SPI_Direction_2Lines_RxOnly ((uint16_t)0x0400) +#define SPI_Direction_1Line_Rx ((uint16_t)0x8000) +#define SPI_Direction_1Line_Tx ((uint16_t)0xC000) +#define IS_SPI_DIRECTION_MODE(MODE) (((MODE) == SPI_Direction_2Lines_FullDuplex) || \ + ((MODE) == SPI_Direction_2Lines_RxOnly) || \ + ((MODE) == SPI_Direction_1Line_Rx) || \ + ((MODE) == SPI_Direction_1Line_Tx)) +/** + * @} + */ + +/** @defgroup SPI_mode + * @{ + */ + +#define SPI_Mode_Master ((uint16_t)0x0104) +#define SPI_Mode_Slave ((uint16_t)0x0000) +#define IS_SPI_MODE(MODE) (((MODE) == SPI_Mode_Master) || \ + ((MODE) == SPI_Mode_Slave)) +/** + * @} + */ + +/** @defgroup SPI_data_size + * @{ + */ + +#define SPI_DataSize_16b ((uint16_t)0x0800) +#define SPI_DataSize_8b ((uint16_t)0x0000) +#define IS_SPI_DATASIZE(DATASIZE) (((DATASIZE) == SPI_DataSize_16b) || \ + ((DATASIZE) == SPI_DataSize_8b)) +/** + * @} + */ + +/** @defgroup SPI_Clock_Polarity + * @{ + */ + +#define SPI_CPOL_Low ((uint16_t)0x0000) +#define SPI_CPOL_High ((uint16_t)0x0002) +#define IS_SPI_CPOL(CPOL) (((CPOL) == SPI_CPOL_Low) || \ + ((CPOL) == SPI_CPOL_High)) +/** + * @} + */ + +/** @defgroup SPI_Clock_Phase + * @{ + */ + +#define SPI_CPHA_1Edge ((uint16_t)0x0000) +#define SPI_CPHA_2Edge ((uint16_t)0x0001) +#define IS_SPI_CPHA(CPHA) (((CPHA) == SPI_CPHA_1Edge) || \ + ((CPHA) == SPI_CPHA_2Edge)) +/** + * @} + */ + +/** @defgroup SPI_Slave_Select_management + * @{ + */ + +#define SPI_NSS_Soft ((uint16_t)0x0200) +#define SPI_NSS_Hard ((uint16_t)0x0000) +#define IS_SPI_NSS(NSS) (((NSS) == SPI_NSS_Soft) || \ + ((NSS) == SPI_NSS_Hard)) +/** + * @} + */ + +/** @defgroup SPI_BaudRate_Prescaler + * @{ + */ + +#define SPI_BaudRatePrescaler_2 ((uint16_t)0x0000) +#define SPI_BaudRatePrescaler_4 ((uint16_t)0x0008) +#define SPI_BaudRatePrescaler_8 ((uint16_t)0x0010) +#define SPI_BaudRatePrescaler_16 ((uint16_t)0x0018) +#define SPI_BaudRatePrescaler_32 ((uint16_t)0x0020) +#define SPI_BaudRatePrescaler_64 ((uint16_t)0x0028) +#define SPI_BaudRatePrescaler_128 ((uint16_t)0x0030) +#define SPI_BaudRatePrescaler_256 ((uint16_t)0x0038) +#define IS_SPI_BAUDRATE_PRESCALER(PRESCALER) (((PRESCALER) == SPI_BaudRatePrescaler_2) || \ + ((PRESCALER) == SPI_BaudRatePrescaler_4) || \ + ((PRESCALER) == SPI_BaudRatePrescaler_8) || \ + ((PRESCALER) == SPI_BaudRatePrescaler_16) || \ + ((PRESCALER) == SPI_BaudRatePrescaler_32) || \ + ((PRESCALER) == SPI_BaudRatePrescaler_64) || \ + ((PRESCALER) == SPI_BaudRatePrescaler_128) || \ + ((PRESCALER) == SPI_BaudRatePrescaler_256)) +/** + * @} + */ + +/** @defgroup SPI_MSB_LSB_transmission + * @{ + */ + +#define SPI_FirstBit_MSB ((uint16_t)0x0000) +#define SPI_FirstBit_LSB ((uint16_t)0x0080) +#define IS_SPI_FIRST_BIT(BIT) (((BIT) == SPI_FirstBit_MSB) || \ + ((BIT) == SPI_FirstBit_LSB)) +/** + * @} + */ + +/** @defgroup SPI_I2S_Mode + * @{ + */ + +#define I2S_Mode_SlaveTx ((uint16_t)0x0000) +#define I2S_Mode_SlaveRx ((uint16_t)0x0100) +#define I2S_Mode_MasterTx ((uint16_t)0x0200) +#define I2S_Mode_MasterRx ((uint16_t)0x0300) +#define IS_I2S_MODE(MODE) (((MODE) == I2S_Mode_SlaveTx) || \ + ((MODE) == I2S_Mode_SlaveRx) || \ + ((MODE) == I2S_Mode_MasterTx)|| \ + ((MODE) == I2S_Mode_MasterRx)) +/** + * @} + */ + + +/** @defgroup SPI_I2S_Standard + * @{ + */ + +#define I2S_Standard_Phillips ((uint16_t)0x0000) +#define I2S_Standard_MSB ((uint16_t)0x0010) +#define I2S_Standard_LSB ((uint16_t)0x0020) +#define I2S_Standard_PCMShort ((uint16_t)0x0030) +#define I2S_Standard_PCMLong ((uint16_t)0x00B0) +#define IS_I2S_STANDARD(STANDARD) (((STANDARD) == I2S_Standard_Phillips) || \ + ((STANDARD) == I2S_Standard_MSB) || \ + ((STANDARD) == I2S_Standard_LSB) || \ + ((STANDARD) == I2S_Standard_PCMShort) || \ + ((STANDARD) == I2S_Standard_PCMLong)) +/** + * @} + */ + +/** @defgroup SPI_I2S_Data_Format + * @{ + */ + +#define I2S_DataFormat_16b ((uint16_t)0x0000) +#define I2S_DataFormat_16bextended ((uint16_t)0x0001) +#define I2S_DataFormat_24b ((uint16_t)0x0003) +#define I2S_DataFormat_32b ((uint16_t)0x0005) +#define IS_I2S_DATA_FORMAT(FORMAT) (((FORMAT) == I2S_DataFormat_16b) || \ + ((FORMAT) == I2S_DataFormat_16bextended) || \ + ((FORMAT) == I2S_DataFormat_24b) || \ + ((FORMAT) == I2S_DataFormat_32b)) +/** + * @} + */ + +/** @defgroup SPI_I2S_MCLK_Output + * @{ + */ + +#define I2S_MCLKOutput_Enable ((uint16_t)0x0200) +#define I2S_MCLKOutput_Disable ((uint16_t)0x0000) +#define IS_I2S_MCLK_OUTPUT(OUTPUT) (((OUTPUT) == I2S_MCLKOutput_Enable) || \ + ((OUTPUT) == I2S_MCLKOutput_Disable)) +/** + * @} + */ + +/** @defgroup SPI_I2S_Audio_Frequency + * @{ + */ + +#define I2S_AudioFreq_192k ((uint32_t)192000) +#define I2S_AudioFreq_96k ((uint32_t)96000) +#define I2S_AudioFreq_48k ((uint32_t)48000) +#define I2S_AudioFreq_44k ((uint32_t)44100) +#define I2S_AudioFreq_32k ((uint32_t)32000) +#define I2S_AudioFreq_22k ((uint32_t)22050) +#define I2S_AudioFreq_16k ((uint32_t)16000) +#define I2S_AudioFreq_11k ((uint32_t)11025) +#define I2S_AudioFreq_8k ((uint32_t)8000) +#define I2S_AudioFreq_Default ((uint32_t)2) + +#define IS_I2S_AUDIO_FREQ(FREQ) ((((FREQ) >= I2S_AudioFreq_8k) && \ + ((FREQ) <= I2S_AudioFreq_192k)) || \ + ((FREQ) == I2S_AudioFreq_Default)) +/** + * @} + */ + +/** @defgroup SPI_I2S_Clock_Polarity + * @{ + */ + +#define I2S_CPOL_Low ((uint16_t)0x0000) +#define I2S_CPOL_High ((uint16_t)0x0008) +#define IS_I2S_CPOL(CPOL) (((CPOL) == I2S_CPOL_Low) || \ + ((CPOL) == I2S_CPOL_High)) +/** + * @} + */ + +/** @defgroup SPI_I2S_DMA_transfer_requests + * @{ + */ + +#define SPI_I2S_DMAReq_Tx ((uint16_t)0x0002) +#define SPI_I2S_DMAReq_Rx ((uint16_t)0x0001) +#define IS_SPI_I2S_DMAREQ(DMAREQ) ((((DMAREQ) & (uint16_t)0xFFFC) == 0x00) && ((DMAREQ) != 0x00)) +/** + * @} + */ + +/** @defgroup SPI_NSS_internal_software_management + * @{ + */ + +#define SPI_NSSInternalSoft_Set ((uint16_t)0x0100) +#define SPI_NSSInternalSoft_Reset ((uint16_t)0xFEFF) +#define IS_SPI_NSS_INTERNAL(INTERNAL) (((INTERNAL) == SPI_NSSInternalSoft_Set) || \ + ((INTERNAL) == SPI_NSSInternalSoft_Reset)) +/** + * @} + */ + +/** @defgroup SPI_CRC_Transmit_Receive + * @{ + */ + +#define SPI_CRC_Tx ((uint8_t)0x00) +#define SPI_CRC_Rx ((uint8_t)0x01) +#define IS_SPI_CRC(CRC) (((CRC) == SPI_CRC_Tx) || ((CRC) == SPI_CRC_Rx)) +/** + * @} + */ + +/** @defgroup SPI_direction_transmit_receive + * @{ + */ + +#define SPI_Direction_Rx ((uint16_t)0xBFFF) +#define SPI_Direction_Tx ((uint16_t)0x4000) +#define IS_SPI_DIRECTION(DIRECTION) (((DIRECTION) == SPI_Direction_Rx) || \ + ((DIRECTION) == SPI_Direction_Tx)) +/** + * @} + */ + +/** @defgroup SPI_I2S_interrupts_definition + * @{ + */ + +#define SPI_I2S_IT_TXE ((uint8_t)0x71) +#define SPI_I2S_IT_RXNE ((uint8_t)0x60) +#define SPI_I2S_IT_ERR ((uint8_t)0x50) +#define I2S_IT_UDR ((uint8_t)0x53) +#define SPI_I2S_IT_TIFRFE ((uint8_t)0x58) + +#define IS_SPI_I2S_CONFIG_IT(IT) (((IT) == SPI_I2S_IT_TXE) || \ + ((IT) == SPI_I2S_IT_RXNE) || \ + ((IT) == SPI_I2S_IT_ERR)) + +#define SPI_I2S_IT_OVR ((uint8_t)0x56) +#define SPI_IT_MODF ((uint8_t)0x55) +#define SPI_IT_CRCERR ((uint8_t)0x54) + +#define IS_SPI_I2S_CLEAR_IT(IT) (((IT) == SPI_IT_CRCERR)) + +#define IS_SPI_I2S_GET_IT(IT) (((IT) == SPI_I2S_IT_RXNE)|| ((IT) == SPI_I2S_IT_TXE) || \ + ((IT) == SPI_IT_CRCERR) || ((IT) == SPI_IT_MODF) || \ + ((IT) == SPI_I2S_IT_OVR) || ((IT) == I2S_IT_UDR) ||\ + ((IT) == SPI_I2S_IT_TIFRFE)) +/** + * @} + */ + +/** @defgroup SPI_I2S_flags_definition + * @{ + */ + +#define SPI_I2S_FLAG_RXNE ((uint16_t)0x0001) +#define SPI_I2S_FLAG_TXE ((uint16_t)0x0002) +#define I2S_FLAG_CHSIDE ((uint16_t)0x0004) +#define I2S_FLAG_UDR ((uint16_t)0x0008) +#define SPI_FLAG_CRCERR ((uint16_t)0x0010) +#define SPI_FLAG_MODF ((uint16_t)0x0020) +#define SPI_I2S_FLAG_OVR ((uint16_t)0x0040) +#define SPI_I2S_FLAG_BSY ((uint16_t)0x0080) +#define SPI_I2S_FLAG_TIFRFE ((uint16_t)0x0100) + +#define IS_SPI_I2S_CLEAR_FLAG(FLAG) (((FLAG) == SPI_FLAG_CRCERR)) +#define IS_SPI_I2S_GET_FLAG(FLAG) (((FLAG) == SPI_I2S_FLAG_BSY) || ((FLAG) == SPI_I2S_FLAG_OVR) || \ + ((FLAG) == SPI_FLAG_MODF) || ((FLAG) == SPI_FLAG_CRCERR) || \ + ((FLAG) == I2S_FLAG_UDR) || ((FLAG) == I2S_FLAG_CHSIDE) || \ + ((FLAG) == SPI_I2S_FLAG_TXE) || ((FLAG) == SPI_I2S_FLAG_RXNE)|| \ + ((FLAG) == SPI_I2S_FLAG_TIFRFE)) +/** + * @} + */ + +/** @defgroup SPI_CRC_polynomial + * @{ + */ + +#define IS_SPI_CRC_POLYNOMIAL(POLYNOMIAL) ((POLYNOMIAL) >= 0x1) +/** + * @} + */ + +/** @defgroup SPI_I2S_Legacy + * @{ + */ + +#define SPI_DMAReq_Tx SPI_I2S_DMAReq_Tx +#define SPI_DMAReq_Rx SPI_I2S_DMAReq_Rx +#define SPI_IT_TXE SPI_I2S_IT_TXE +#define SPI_IT_RXNE SPI_I2S_IT_RXNE +#define SPI_IT_ERR SPI_I2S_IT_ERR +#define SPI_IT_OVR SPI_I2S_IT_OVR +#define SPI_FLAG_RXNE SPI_I2S_FLAG_RXNE +#define SPI_FLAG_TXE SPI_I2S_FLAG_TXE +#define SPI_FLAG_OVR SPI_I2S_FLAG_OVR +#define SPI_FLAG_BSY SPI_I2S_FLAG_BSY +#define SPI_DeInit SPI_I2S_DeInit +#define SPI_ITConfig SPI_I2S_ITConfig +#define SPI_DMACmd SPI_I2S_DMACmd +#define SPI_SendData SPI_I2S_SendData +#define SPI_ReceiveData SPI_I2S_ReceiveData +#define SPI_GetFlagStatus SPI_I2S_GetFlagStatus +#define SPI_ClearFlag SPI_I2S_ClearFlag +#define SPI_GetITStatus SPI_I2S_GetITStatus +#define SPI_ClearITPendingBit SPI_I2S_ClearITPendingBit +/** + * @} + */ + +/** + * @} + */ + +/* Exported macro ------------------------------------------------------------*/ +/* Exported functions --------------------------------------------------------*/ + +/* Function used to set the SPI configuration to the default reset state *****/ +void SPI_I2S_DeInit(SPI_TypeDef* SPIx); + +/* Initialization and Configuration functions *********************************/ +void SPI_Init(SPI_TypeDef* SPIx, SPI_InitTypeDef* SPI_InitStruct); +void I2S_Init(SPI_TypeDef* SPIx, I2S_InitTypeDef* I2S_InitStruct); +void SPI_StructInit(SPI_InitTypeDef* SPI_InitStruct); +void I2S_StructInit(I2S_InitTypeDef* I2S_InitStruct); +void SPI_Cmd(SPI_TypeDef* SPIx, FunctionalState NewState); +void I2S_Cmd(SPI_TypeDef* SPIx, FunctionalState NewState); +void SPI_DataSizeConfig(SPI_TypeDef* SPIx, uint16_t SPI_DataSize); +void SPI_BiDirectionalLineConfig(SPI_TypeDef* SPIx, uint16_t SPI_Direction); +void SPI_NSSInternalSoftwareConfig(SPI_TypeDef* SPIx, uint16_t SPI_NSSInternalSoft); +void SPI_SSOutputCmd(SPI_TypeDef* SPIx, FunctionalState NewState); +void SPI_TIModeCmd(SPI_TypeDef* SPIx, FunctionalState NewState); + +void I2S_FullDuplexConfig(SPI_TypeDef* I2Sxext, I2S_InitTypeDef* I2S_InitStruct); + +/* Data transfers functions ***************************************************/ +void SPI_I2S_SendData(SPI_TypeDef* SPIx, uint16_t Data); +uint16_t SPI_I2S_ReceiveData(SPI_TypeDef* SPIx); + +/* Hardware CRC Calculation functions *****************************************/ +void SPI_CalculateCRC(SPI_TypeDef* SPIx, FunctionalState NewState); +void SPI_TransmitCRC(SPI_TypeDef* SPIx); +uint16_t SPI_GetCRC(SPI_TypeDef* SPIx, uint8_t SPI_CRC); +uint16_t SPI_GetCRCPolynomial(SPI_TypeDef* SPIx); + +/* DMA transfers management functions *****************************************/ +void SPI_I2S_DMACmd(SPI_TypeDef* SPIx, uint16_t SPI_I2S_DMAReq, FunctionalState NewState); + +/* Interrupts and flags management functions **********************************/ +void SPI_I2S_ITConfig(SPI_TypeDef* SPIx, uint8_t SPI_I2S_IT, FunctionalState NewState); +FlagStatus SPI_I2S_GetFlagStatus(SPI_TypeDef* SPIx, uint16_t SPI_I2S_FLAG); +void SPI_I2S_ClearFlag(SPI_TypeDef* SPIx, uint16_t SPI_I2S_FLAG); +ITStatus SPI_I2S_GetITStatus(SPI_TypeDef* SPIx, uint8_t SPI_I2S_IT); +void SPI_I2S_ClearITPendingBit(SPI_TypeDef* SPIx, uint8_t SPI_I2S_IT); + +#ifdef __cplusplus +} +#endif + +#endif /*__STM32F4xx_SPI_H */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/inc/stm32f4xx_syscfg.h b/FWLIB/inc/stm32f4xx_syscfg.h new file mode 100644 index 0000000..efbf5b2 --- /dev/null +++ b/FWLIB/inc/stm32f4xx_syscfg.h @@ -0,0 +1,210 @@ +/** + ****************************************************************************** + * @file stm32f4xx_syscfg.h + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file contains all the functions prototypes for the SYSCFG firmware + * library. + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Define to prevent recursive inclusion -------------------------------------*/ +#ifndef __STM32F4xx_SYSCFG_H +#define __STM32F4xx_SYSCFG_H + +#ifdef __cplusplus + extern "C" { +#endif + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @addtogroup SYSCFG + * @{ + */ + +/* Exported types ------------------------------------------------------------*/ +/* Exported constants --------------------------------------------------------*/ + +/** @defgroup SYSCFG_Exported_Constants + * @{ + */ + +/** @defgroup SYSCFG_EXTI_Port_Sources + * @{ + */ +#define EXTI_PortSourceGPIOA ((uint8_t)0x00) +#define EXTI_PortSourceGPIOB ((uint8_t)0x01) +#define EXTI_PortSourceGPIOC ((uint8_t)0x02) +#define EXTI_PortSourceGPIOD ((uint8_t)0x03) +#define EXTI_PortSourceGPIOE ((uint8_t)0x04) +#define EXTI_PortSourceGPIOF ((uint8_t)0x05) +#define EXTI_PortSourceGPIOG ((uint8_t)0x06) +#define EXTI_PortSourceGPIOH ((uint8_t)0x07) +#define EXTI_PortSourceGPIOI ((uint8_t)0x08) +#define EXTI_PortSourceGPIOJ ((uint8_t)0x09) +#define EXTI_PortSourceGPIOK ((uint8_t)0x0A) + +#define IS_EXTI_PORT_SOURCE(PORTSOURCE) (((PORTSOURCE) == EXTI_PortSourceGPIOA) || \ + ((PORTSOURCE) == EXTI_PortSourceGPIOB) || \ + ((PORTSOURCE) == EXTI_PortSourceGPIOC) || \ + ((PORTSOURCE) == EXTI_PortSourceGPIOD) || \ + ((PORTSOURCE) == EXTI_PortSourceGPIOE) || \ + ((PORTSOURCE) == EXTI_PortSourceGPIOF) || \ + ((PORTSOURCE) == EXTI_PortSourceGPIOG) || \ + ((PORTSOURCE) == EXTI_PortSourceGPIOH) || \ + ((PORTSOURCE) == EXTI_PortSourceGPIOI) || \ + ((PORTSOURCE) == EXTI_PortSourceGPIOJ) || \ + ((PORTSOURCE) == EXTI_PortSourceGPIOK)) + +/** + * @} + */ + + +/** @defgroup SYSCFG_EXTI_Pin_Sources + * @{ + */ +#define EXTI_PinSource0 ((uint8_t)0x00) +#define EXTI_PinSource1 ((uint8_t)0x01) +#define EXTI_PinSource2 ((uint8_t)0x02) +#define EXTI_PinSource3 ((uint8_t)0x03) +#define EXTI_PinSource4 ((uint8_t)0x04) +#define EXTI_PinSource5 ((uint8_t)0x05) +#define EXTI_PinSource6 ((uint8_t)0x06) +#define EXTI_PinSource7 ((uint8_t)0x07) +#define EXTI_PinSource8 ((uint8_t)0x08) +#define EXTI_PinSource9 ((uint8_t)0x09) +#define EXTI_PinSource10 ((uint8_t)0x0A) +#define EXTI_PinSource11 ((uint8_t)0x0B) +#define EXTI_PinSource12 ((uint8_t)0x0C) +#define EXTI_PinSource13 ((uint8_t)0x0D) +#define EXTI_PinSource14 ((uint8_t)0x0E) +#define EXTI_PinSource15 ((uint8_t)0x0F) +#define IS_EXTI_PIN_SOURCE(PINSOURCE) (((PINSOURCE) == EXTI_PinSource0) || \ + ((PINSOURCE) == EXTI_PinSource1) || \ + ((PINSOURCE) == EXTI_PinSource2) || \ + ((PINSOURCE) == EXTI_PinSource3) || \ + ((PINSOURCE) == EXTI_PinSource4) || \ + ((PINSOURCE) == EXTI_PinSource5) || \ + ((PINSOURCE) == EXTI_PinSource6) || \ + ((PINSOURCE) == EXTI_PinSource7) || \ + ((PINSOURCE) == EXTI_PinSource8) || \ + ((PINSOURCE) == EXTI_PinSource9) || \ + ((PINSOURCE) == EXTI_PinSource10) || \ + ((PINSOURCE) == EXTI_PinSource11) || \ + ((PINSOURCE) == EXTI_PinSource12) || \ + ((PINSOURCE) == EXTI_PinSource13) || \ + ((PINSOURCE) == EXTI_PinSource14) || \ + ((PINSOURCE) == EXTI_PinSource15)) +/** + * @} + */ + + +/** @defgroup SYSCFG_Memory_Remap_Config + * @{ + */ +#define SYSCFG_MemoryRemap_Flash ((uint8_t)0x00) +#define SYSCFG_MemoryRemap_SystemFlash ((uint8_t)0x01) +#define SYSCFG_MemoryRemap_SRAM ((uint8_t)0x03) +#define SYSCFG_MemoryRemap_SDRAM ((uint8_t)0x04) + +#if defined (STM32F40_41xxx) +#define SYSCFG_MemoryRemap_FSMC ((uint8_t)0x02) +#endif /* STM32F40_41xxx */ + +#if defined (STM32F427_437xx) || defined (STM32F429_439xx) +#define SYSCFG_MemoryRemap_FMC ((uint8_t)0x02) +#endif /* STM32F427_437xx || STM32F429_439xx */ + +#if defined (STM32F40_41xxx) +#define IS_SYSCFG_MEMORY_REMAP_CONFING(REMAP) (((REMAP) == SYSCFG_MemoryRemap_Flash) || \ + ((REMAP) == SYSCFG_MemoryRemap_SystemFlash) || \ + ((REMAP) == SYSCFG_MemoryRemap_SRAM) || \ + ((REMAP) == SYSCFG_MemoryRemap_FSMC)) +#endif /* STM32F40_41xxx */ + +#if defined (STM32F401xx) || defined (STM32F411xE) +#define IS_SYSCFG_MEMORY_REMAP_CONFING(REMAP) (((REMAP) == SYSCFG_MemoryRemap_Flash) || \ + ((REMAP) == SYSCFG_MemoryRemap_SystemFlash) || \ + ((REMAP) == SYSCFG_MemoryRemap_SRAM)) +#endif /* STM32F401xx || STM32F411xE */ + +#if defined (STM32F427_437xx) || defined (STM32F429_439xx) +#define IS_SYSCFG_MEMORY_REMAP_CONFING(REMAP) (((REMAP) == SYSCFG_MemoryRemap_Flash) || \ + ((REMAP) == SYSCFG_MemoryRemap_SystemFlash) || \ + ((REMAP) == SYSCFG_MemoryRemap_SRAM) || \ + ((REMAP) == SYSCFG_MemoryRemap_SDRAM) || \ + ((REMAP) == SYSCFG_MemoryRemap_FMC)) +#endif /* STM32F427_437xx || STM32F429_439xx */ + +/** + * @} + */ + + +/** @defgroup SYSCFG_ETHERNET_Media_Interface + * @{ + */ +#define SYSCFG_ETH_MediaInterface_MII ((uint32_t)0x00000000) +#define SYSCFG_ETH_MediaInterface_RMII ((uint32_t)0x00000001) + +#define IS_SYSCFG_ETH_MEDIA_INTERFACE(INTERFACE) (((INTERFACE) == SYSCFG_ETH_MediaInterface_MII) || \ + ((INTERFACE) == SYSCFG_ETH_MediaInterface_RMII)) +/** + * @} + */ + +/** + * @} + */ + +/* Exported macro ------------------------------------------------------------*/ +/* Exported functions --------------------------------------------------------*/ + +void SYSCFG_DeInit(void); +void SYSCFG_MemoryRemapConfig(uint8_t SYSCFG_MemoryRemap); +void SYSCFG_MemorySwappingBank(FunctionalState NewState); +void SYSCFG_EXTILineConfig(uint8_t EXTI_PortSourceGPIOx, uint8_t EXTI_PinSourcex); +void SYSCFG_ETH_MediaInterfaceConfig(uint32_t SYSCFG_ETH_MediaInterface); +void SYSCFG_CompensationCellCmd(FunctionalState NewState); +FlagStatus SYSCFG_GetCompensationCellStatus(void); + +#ifdef __cplusplus +} +#endif + +#endif /*__STM32F4xx_SYSCFG_H */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/inc/stm32f4xx_tim.h b/FWLIB/inc/stm32f4xx_tim.h new file mode 100644 index 0000000..a7b1db6 --- /dev/null +++ b/FWLIB/inc/stm32f4xx_tim.h @@ -0,0 +1,1150 @@ +/** + ****************************************************************************** + * @file stm32f4xx_tim.h + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file contains all the functions prototypes for the TIM firmware + * library. + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Define to prevent recursive inclusion -------------------------------------*/ +#ifndef __STM32F4xx_TIM_H +#define __STM32F4xx_TIM_H + +#ifdef __cplusplus + extern "C" { +#endif + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @addtogroup TIM + * @{ + */ + +/* Exported types ------------------------------------------------------------*/ + +/** + * @brief TIM Time Base Init structure definition + * @note This structure is used with all TIMx except for TIM6 and TIM7. + */ + +typedef struct +{ + uint16_t TIM_Prescaler; /*!< Specifies the prescaler value used to divide the TIM clock. + This parameter can be a number between 0x0000 and 0xFFFF */ + + uint16_t TIM_CounterMode; /*!< Specifies the counter mode. + This parameter can be a value of @ref TIM_Counter_Mode */ + + uint32_t TIM_Period; /*!< Specifies the period value to be loaded into the active + Auto-Reload Register at the next update event. + This parameter must be a number between 0x0000 and 0xFFFF. */ + + uint16_t TIM_ClockDivision; /*!< Specifies the clock division. + This parameter can be a value of @ref TIM_Clock_Division_CKD */ + + uint8_t TIM_RepetitionCounter; /*!< Specifies the repetition counter value. Each time the RCR downcounter + reaches zero, an update event is generated and counting restarts + from the RCR value (N). + This means in PWM mode that (N+1) corresponds to: + - the number of PWM periods in edge-aligned mode + - the number of half PWM period in center-aligned mode + This parameter must be a number between 0x00 and 0xFF. + @note This parameter is valid only for TIM1 and TIM8. */ +} TIM_TimeBaseInitTypeDef; + +/** + * @brief TIM Output Compare Init structure definition + */ + +typedef struct +{ + uint16_t TIM_OCMode; /*!< Specifies the TIM mode. + This parameter can be a value of @ref TIM_Output_Compare_and_PWM_modes */ + + uint16_t TIM_OutputState; /*!< Specifies the TIM Output Compare state. + This parameter can be a value of @ref TIM_Output_Compare_State */ + + uint16_t TIM_OutputNState; /*!< Specifies the TIM complementary Output Compare state. + This parameter can be a value of @ref TIM_Output_Compare_N_State + @note This parameter is valid only for TIM1 and TIM8. */ + + uint32_t TIM_Pulse; /*!< Specifies the pulse value to be loaded into the Capture Compare Register. + This parameter can be a number between 0x0000 and 0xFFFF */ + + uint16_t TIM_OCPolarity; /*!< Specifies the output polarity. + This parameter can be a value of @ref TIM_Output_Compare_Polarity */ + + uint16_t TIM_OCNPolarity; /*!< Specifies the complementary output polarity. + This parameter can be a value of @ref TIM_Output_Compare_N_Polarity + @note This parameter is valid only for TIM1 and TIM8. */ + + uint16_t TIM_OCIdleState; /*!< Specifies the TIM Output Compare pin state during Idle state. + This parameter can be a value of @ref TIM_Output_Compare_Idle_State + @note This parameter is valid only for TIM1 and TIM8. */ + + uint16_t TIM_OCNIdleState; /*!< Specifies the TIM Output Compare pin state during Idle state. + This parameter can be a value of @ref TIM_Output_Compare_N_Idle_State + @note This parameter is valid only for TIM1 and TIM8. */ +} TIM_OCInitTypeDef; + +/** + * @brief TIM Input Capture Init structure definition + */ + +typedef struct +{ + + uint16_t TIM_Channel; /*!< Specifies the TIM channel. + This parameter can be a value of @ref TIM_Channel */ + + uint16_t TIM_ICPolarity; /*!< Specifies the active edge of the input signal. + This parameter can be a value of @ref TIM_Input_Capture_Polarity */ + + uint16_t TIM_ICSelection; /*!< Specifies the input. + This parameter can be a value of @ref TIM_Input_Capture_Selection */ + + uint16_t TIM_ICPrescaler; /*!< Specifies the Input Capture Prescaler. + This parameter can be a value of @ref TIM_Input_Capture_Prescaler */ + + uint16_t TIM_ICFilter; /*!< Specifies the input capture filter. + This parameter can be a number between 0x0 and 0xF */ +} TIM_ICInitTypeDef; + +/** + * @brief BDTR structure definition + * @note This structure is used only with TIM1 and TIM8. + */ + +typedef struct +{ + + uint16_t TIM_OSSRState; /*!< Specifies the Off-State selection used in Run mode. + This parameter can be a value of @ref TIM_OSSR_Off_State_Selection_for_Run_mode_state */ + + uint16_t TIM_OSSIState; /*!< Specifies the Off-State used in Idle state. + This parameter can be a value of @ref TIM_OSSI_Off_State_Selection_for_Idle_mode_state */ + + uint16_t TIM_LOCKLevel; /*!< Specifies the LOCK level parameters. + This parameter can be a value of @ref TIM_Lock_level */ + + uint16_t TIM_DeadTime; /*!< Specifies the delay time between the switching-off and the + switching-on of the outputs. + This parameter can be a number between 0x00 and 0xFF */ + + uint16_t TIM_Break; /*!< Specifies whether the TIM Break input is enabled or not. + This parameter can be a value of @ref TIM_Break_Input_enable_disable */ + + uint16_t TIM_BreakPolarity; /*!< Specifies the TIM Break Input pin polarity. + This parameter can be a value of @ref TIM_Break_Polarity */ + + uint16_t TIM_AutomaticOutput; /*!< Specifies whether the TIM Automatic Output feature is enabled or not. + This parameter can be a value of @ref TIM_AOE_Bit_Set_Reset */ +} TIM_BDTRInitTypeDef; + +/* Exported constants --------------------------------------------------------*/ + +/** @defgroup TIM_Exported_constants + * @{ + */ + +#define IS_TIM_ALL_PERIPH(PERIPH) (((PERIPH) == TIM1) || \ + ((PERIPH) == TIM2) || \ + ((PERIPH) == TIM3) || \ + ((PERIPH) == TIM4) || \ + ((PERIPH) == TIM5) || \ + ((PERIPH) == TIM6) || \ + ((PERIPH) == TIM7) || \ + ((PERIPH) == TIM8) || \ + ((PERIPH) == TIM9) || \ + ((PERIPH) == TIM10) || \ + ((PERIPH) == TIM11) || \ + ((PERIPH) == TIM12) || \ + (((PERIPH) == TIM13) || \ + ((PERIPH) == TIM14))) +/* LIST1: TIM1, TIM2, TIM3, TIM4, TIM5, TIM8, TIM9, TIM10, TIM11, TIM12, TIM13 and TIM14 */ +#define IS_TIM_LIST1_PERIPH(PERIPH) (((PERIPH) == TIM1) || \ + ((PERIPH) == TIM2) || \ + ((PERIPH) == TIM3) || \ + ((PERIPH) == TIM4) || \ + ((PERIPH) == TIM5) || \ + ((PERIPH) == TIM8) || \ + ((PERIPH) == TIM9) || \ + ((PERIPH) == TIM10) || \ + ((PERIPH) == TIM11) || \ + ((PERIPH) == TIM12) || \ + ((PERIPH) == TIM13) || \ + ((PERIPH) == TIM14)) + +/* LIST2: TIM1, TIM2, TIM3, TIM4, TIM5, TIM8, TIM9 and TIM12 */ +#define IS_TIM_LIST2_PERIPH(PERIPH) (((PERIPH) == TIM1) || \ + ((PERIPH) == TIM2) || \ + ((PERIPH) == TIM3) || \ + ((PERIPH) == TIM4) || \ + ((PERIPH) == TIM5) || \ + ((PERIPH) == TIM8) || \ + ((PERIPH) == TIM9) || \ + ((PERIPH) == TIM12)) +/* LIST3: TIM1, TIM2, TIM3, TIM4, TIM5 and TIM8 */ +#define IS_TIM_LIST3_PERIPH(PERIPH) (((PERIPH) == TIM1) || \ + ((PERIPH) == TIM2) || \ + ((PERIPH) == TIM3) || \ + ((PERIPH) == TIM4) || \ + ((PERIPH) == TIM5) || \ + ((PERIPH) == TIM8)) +/* LIST4: TIM1 and TIM8 */ +#define IS_TIM_LIST4_PERIPH(PERIPH) (((PERIPH) == TIM1) || \ + ((PERIPH) == TIM8)) +/* LIST5: TIM1, TIM2, TIM3, TIM4, TIM5, TIM6, TIM7 and TIM8 */ +#define IS_TIM_LIST5_PERIPH(PERIPH) (((PERIPH) == TIM1) || \ + ((PERIPH) == TIM2) || \ + ((PERIPH) == TIM3) || \ + ((PERIPH) == TIM4) || \ + ((PERIPH) == TIM5) || \ + ((PERIPH) == TIM6) || \ + ((PERIPH) == TIM7) || \ + ((PERIPH) == TIM8)) +/* LIST6: TIM2, TIM5 and TIM11 */ +#define IS_TIM_LIST6_PERIPH(TIMx)(((TIMx) == TIM2) || \ + ((TIMx) == TIM5) || \ + ((TIMx) == TIM11)) + +/** @defgroup TIM_Output_Compare_and_PWM_modes + * @{ + */ + +#define TIM_OCMode_Timing ((uint16_t)0x0000) +#define TIM_OCMode_Active ((uint16_t)0x0010) +#define TIM_OCMode_Inactive ((uint16_t)0x0020) +#define TIM_OCMode_Toggle ((uint16_t)0x0030) +#define TIM_OCMode_PWM1 ((uint16_t)0x0060) +#define TIM_OCMode_PWM2 ((uint16_t)0x0070) +#define IS_TIM_OC_MODE(MODE) (((MODE) == TIM_OCMode_Timing) || \ + ((MODE) == TIM_OCMode_Active) || \ + ((MODE) == TIM_OCMode_Inactive) || \ + ((MODE) == TIM_OCMode_Toggle)|| \ + ((MODE) == TIM_OCMode_PWM1) || \ + ((MODE) == TIM_OCMode_PWM2)) +#define IS_TIM_OCM(MODE) (((MODE) == TIM_OCMode_Timing) || \ + ((MODE) == TIM_OCMode_Active) || \ + ((MODE) == TIM_OCMode_Inactive) || \ + ((MODE) == TIM_OCMode_Toggle)|| \ + ((MODE) == TIM_OCMode_PWM1) || \ + ((MODE) == TIM_OCMode_PWM2) || \ + ((MODE) == TIM_ForcedAction_Active) || \ + ((MODE) == TIM_ForcedAction_InActive)) +/** + * @} + */ + +/** @defgroup TIM_One_Pulse_Mode + * @{ + */ + +#define TIM_OPMode_Single ((uint16_t)0x0008) +#define TIM_OPMode_Repetitive ((uint16_t)0x0000) +#define IS_TIM_OPM_MODE(MODE) (((MODE) == TIM_OPMode_Single) || \ + ((MODE) == TIM_OPMode_Repetitive)) +/** + * @} + */ + +/** @defgroup TIM_Channel + * @{ + */ + +#define TIM_Channel_1 ((uint16_t)0x0000) +#define TIM_Channel_2 ((uint16_t)0x0004) +#define TIM_Channel_3 ((uint16_t)0x0008) +#define TIM_Channel_4 ((uint16_t)0x000C) + +#define IS_TIM_CHANNEL(CHANNEL) (((CHANNEL) == TIM_Channel_1) || \ + ((CHANNEL) == TIM_Channel_2) || \ + ((CHANNEL) == TIM_Channel_3) || \ + ((CHANNEL) == TIM_Channel_4)) + +#define IS_TIM_PWMI_CHANNEL(CHANNEL) (((CHANNEL) == TIM_Channel_1) || \ + ((CHANNEL) == TIM_Channel_2)) +#define IS_TIM_COMPLEMENTARY_CHANNEL(CHANNEL) (((CHANNEL) == TIM_Channel_1) || \ + ((CHANNEL) == TIM_Channel_2) || \ + ((CHANNEL) == TIM_Channel_3)) +/** + * @} + */ + +/** @defgroup TIM_Clock_Division_CKD + * @{ + */ + +#define TIM_CKD_DIV1 ((uint16_t)0x0000) +#define TIM_CKD_DIV2 ((uint16_t)0x0100) +#define TIM_CKD_DIV4 ((uint16_t)0x0200) +#define IS_TIM_CKD_DIV(DIV) (((DIV) == TIM_CKD_DIV1) || \ + ((DIV) == TIM_CKD_DIV2) || \ + ((DIV) == TIM_CKD_DIV4)) +/** + * @} + */ + +/** @defgroup TIM_Counter_Mode + * @{ + */ + +#define TIM_CounterMode_Up ((uint16_t)0x0000) +#define TIM_CounterMode_Down ((uint16_t)0x0010) +#define TIM_CounterMode_CenterAligned1 ((uint16_t)0x0020) +#define TIM_CounterMode_CenterAligned2 ((uint16_t)0x0040) +#define TIM_CounterMode_CenterAligned3 ((uint16_t)0x0060) +#define IS_TIM_COUNTER_MODE(MODE) (((MODE) == TIM_CounterMode_Up) || \ + ((MODE) == TIM_CounterMode_Down) || \ + ((MODE) == TIM_CounterMode_CenterAligned1) || \ + ((MODE) == TIM_CounterMode_CenterAligned2) || \ + ((MODE) == TIM_CounterMode_CenterAligned3)) +/** + * @} + */ + +/** @defgroup TIM_Output_Compare_Polarity + * @{ + */ + +#define TIM_OCPolarity_High ((uint16_t)0x0000) +#define TIM_OCPolarity_Low ((uint16_t)0x0002) +#define IS_TIM_OC_POLARITY(POLARITY) (((POLARITY) == TIM_OCPolarity_High) || \ + ((POLARITY) == TIM_OCPolarity_Low)) +/** + * @} + */ + +/** @defgroup TIM_Output_Compare_N_Polarity + * @{ + */ + +#define TIM_OCNPolarity_High ((uint16_t)0x0000) +#define TIM_OCNPolarity_Low ((uint16_t)0x0008) +#define IS_TIM_OCN_POLARITY(POLARITY) (((POLARITY) == TIM_OCNPolarity_High) || \ + ((POLARITY) == TIM_OCNPolarity_Low)) +/** + * @} + */ + +/** @defgroup TIM_Output_Compare_State + * @{ + */ + +#define TIM_OutputState_Disable ((uint16_t)0x0000) +#define TIM_OutputState_Enable ((uint16_t)0x0001) +#define IS_TIM_OUTPUT_STATE(STATE) (((STATE) == TIM_OutputState_Disable) || \ + ((STATE) == TIM_OutputState_Enable)) +/** + * @} + */ + +/** @defgroup TIM_Output_Compare_N_State + * @{ + */ + +#define TIM_OutputNState_Disable ((uint16_t)0x0000) +#define TIM_OutputNState_Enable ((uint16_t)0x0004) +#define IS_TIM_OUTPUTN_STATE(STATE) (((STATE) == TIM_OutputNState_Disable) || \ + ((STATE) == TIM_OutputNState_Enable)) +/** + * @} + */ + +/** @defgroup TIM_Capture_Compare_State + * @{ + */ + +#define TIM_CCx_Enable ((uint16_t)0x0001) +#define TIM_CCx_Disable ((uint16_t)0x0000) +#define IS_TIM_CCX(CCX) (((CCX) == TIM_CCx_Enable) || \ + ((CCX) == TIM_CCx_Disable)) +/** + * @} + */ + +/** @defgroup TIM_Capture_Compare_N_State + * @{ + */ + +#define TIM_CCxN_Enable ((uint16_t)0x0004) +#define TIM_CCxN_Disable ((uint16_t)0x0000) +#define IS_TIM_CCXN(CCXN) (((CCXN) == TIM_CCxN_Enable) || \ + ((CCXN) == TIM_CCxN_Disable)) +/** + * @} + */ + +/** @defgroup TIM_Break_Input_enable_disable + * @{ + */ + +#define TIM_Break_Enable ((uint16_t)0x1000) +#define TIM_Break_Disable ((uint16_t)0x0000) +#define IS_TIM_BREAK_STATE(STATE) (((STATE) == TIM_Break_Enable) || \ + ((STATE) == TIM_Break_Disable)) +/** + * @} + */ + +/** @defgroup TIM_Break_Polarity + * @{ + */ + +#define TIM_BreakPolarity_Low ((uint16_t)0x0000) +#define TIM_BreakPolarity_High ((uint16_t)0x2000) +#define IS_TIM_BREAK_POLARITY(POLARITY) (((POLARITY) == TIM_BreakPolarity_Low) || \ + ((POLARITY) == TIM_BreakPolarity_High)) +/** + * @} + */ + +/** @defgroup TIM_AOE_Bit_Set_Reset + * @{ + */ + +#define TIM_AutomaticOutput_Enable ((uint16_t)0x4000) +#define TIM_AutomaticOutput_Disable ((uint16_t)0x0000) +#define IS_TIM_AUTOMATIC_OUTPUT_STATE(STATE) (((STATE) == TIM_AutomaticOutput_Enable) || \ + ((STATE) == TIM_AutomaticOutput_Disable)) +/** + * @} + */ + +/** @defgroup TIM_Lock_level + * @{ + */ + +#define TIM_LOCKLevel_OFF ((uint16_t)0x0000) +#define TIM_LOCKLevel_1 ((uint16_t)0x0100) +#define TIM_LOCKLevel_2 ((uint16_t)0x0200) +#define TIM_LOCKLevel_3 ((uint16_t)0x0300) +#define IS_TIM_LOCK_LEVEL(LEVEL) (((LEVEL) == TIM_LOCKLevel_OFF) || \ + ((LEVEL) == TIM_LOCKLevel_1) || \ + ((LEVEL) == TIM_LOCKLevel_2) || \ + ((LEVEL) == TIM_LOCKLevel_3)) +/** + * @} + */ + +/** @defgroup TIM_OSSI_Off_State_Selection_for_Idle_mode_state + * @{ + */ + +#define TIM_OSSIState_Enable ((uint16_t)0x0400) +#define TIM_OSSIState_Disable ((uint16_t)0x0000) +#define IS_TIM_OSSI_STATE(STATE) (((STATE) == TIM_OSSIState_Enable) || \ + ((STATE) == TIM_OSSIState_Disable)) +/** + * @} + */ + +/** @defgroup TIM_OSSR_Off_State_Selection_for_Run_mode_state + * @{ + */ + +#define TIM_OSSRState_Enable ((uint16_t)0x0800) +#define TIM_OSSRState_Disable ((uint16_t)0x0000) +#define IS_TIM_OSSR_STATE(STATE) (((STATE) == TIM_OSSRState_Enable) || \ + ((STATE) == TIM_OSSRState_Disable)) +/** + * @} + */ + +/** @defgroup TIM_Output_Compare_Idle_State + * @{ + */ + +#define TIM_OCIdleState_Set ((uint16_t)0x0100) +#define TIM_OCIdleState_Reset ((uint16_t)0x0000) +#define IS_TIM_OCIDLE_STATE(STATE) (((STATE) == TIM_OCIdleState_Set) || \ + ((STATE) == TIM_OCIdleState_Reset)) +/** + * @} + */ + +/** @defgroup TIM_Output_Compare_N_Idle_State + * @{ + */ + +#define TIM_OCNIdleState_Set ((uint16_t)0x0200) +#define TIM_OCNIdleState_Reset ((uint16_t)0x0000) +#define IS_TIM_OCNIDLE_STATE(STATE) (((STATE) == TIM_OCNIdleState_Set) || \ + ((STATE) == TIM_OCNIdleState_Reset)) +/** + * @} + */ + +/** @defgroup TIM_Input_Capture_Polarity + * @{ + */ + +#define TIM_ICPolarity_Rising ((uint16_t)0x0000) +#define TIM_ICPolarity_Falling ((uint16_t)0x0002) +#define TIM_ICPolarity_BothEdge ((uint16_t)0x000A) +#define IS_TIM_IC_POLARITY(POLARITY) (((POLARITY) == TIM_ICPolarity_Rising) || \ + ((POLARITY) == TIM_ICPolarity_Falling)|| \ + ((POLARITY) == TIM_ICPolarity_BothEdge)) +/** + * @} + */ + +/** @defgroup TIM_Input_Capture_Selection + * @{ + */ + +#define TIM_ICSelection_DirectTI ((uint16_t)0x0001) /*!< TIM Input 1, 2, 3 or 4 is selected to be + connected to IC1, IC2, IC3 or IC4, respectively */ +#define TIM_ICSelection_IndirectTI ((uint16_t)0x0002) /*!< TIM Input 1, 2, 3 or 4 is selected to be + connected to IC2, IC1, IC4 or IC3, respectively. */ +#define TIM_ICSelection_TRC ((uint16_t)0x0003) /*!< TIM Input 1, 2, 3 or 4 is selected to be connected to TRC. */ +#define IS_TIM_IC_SELECTION(SELECTION) (((SELECTION) == TIM_ICSelection_DirectTI) || \ + ((SELECTION) == TIM_ICSelection_IndirectTI) || \ + ((SELECTION) == TIM_ICSelection_TRC)) +/** + * @} + */ + +/** @defgroup TIM_Input_Capture_Prescaler + * @{ + */ + +#define TIM_ICPSC_DIV1 ((uint16_t)0x0000) /*!< Capture performed each time an edge is detected on the capture input. */ +#define TIM_ICPSC_DIV2 ((uint16_t)0x0004) /*!< Capture performed once every 2 events. */ +#define TIM_ICPSC_DIV4 ((uint16_t)0x0008) /*!< Capture performed once every 4 events. */ +#define TIM_ICPSC_DIV8 ((uint16_t)0x000C) /*!< Capture performed once every 8 events. */ +#define IS_TIM_IC_PRESCALER(PRESCALER) (((PRESCALER) == TIM_ICPSC_DIV1) || \ + ((PRESCALER) == TIM_ICPSC_DIV2) || \ + ((PRESCALER) == TIM_ICPSC_DIV4) || \ + ((PRESCALER) == TIM_ICPSC_DIV8)) +/** + * @} + */ + +/** @defgroup TIM_interrupt_sources + * @{ + */ + +#define TIM_IT_Update ((uint16_t)0x0001) +#define TIM_IT_CC1 ((uint16_t)0x0002) +#define TIM_IT_CC2 ((uint16_t)0x0004) +#define TIM_IT_CC3 ((uint16_t)0x0008) +#define TIM_IT_CC4 ((uint16_t)0x0010) +#define TIM_IT_COM ((uint16_t)0x0020) +#define TIM_IT_Trigger ((uint16_t)0x0040) +#define TIM_IT_Break ((uint16_t)0x0080) +#define IS_TIM_IT(IT) ((((IT) & (uint16_t)0xFF00) == 0x0000) && ((IT) != 0x0000)) + +#define IS_TIM_GET_IT(IT) (((IT) == TIM_IT_Update) || \ + ((IT) == TIM_IT_CC1) || \ + ((IT) == TIM_IT_CC2) || \ + ((IT) == TIM_IT_CC3) || \ + ((IT) == TIM_IT_CC4) || \ + ((IT) == TIM_IT_COM) || \ + ((IT) == TIM_IT_Trigger) || \ + ((IT) == TIM_IT_Break)) +/** + * @} + */ + +/** @defgroup TIM_DMA_Base_address + * @{ + */ + +#define TIM_DMABase_CR1 ((uint16_t)0x0000) +#define TIM_DMABase_CR2 ((uint16_t)0x0001) +#define TIM_DMABase_SMCR ((uint16_t)0x0002) +#define TIM_DMABase_DIER ((uint16_t)0x0003) +#define TIM_DMABase_SR ((uint16_t)0x0004) +#define TIM_DMABase_EGR ((uint16_t)0x0005) +#define TIM_DMABase_CCMR1 ((uint16_t)0x0006) +#define TIM_DMABase_CCMR2 ((uint16_t)0x0007) +#define TIM_DMABase_CCER ((uint16_t)0x0008) +#define TIM_DMABase_CNT ((uint16_t)0x0009) +#define TIM_DMABase_PSC ((uint16_t)0x000A) +#define TIM_DMABase_ARR ((uint16_t)0x000B) +#define TIM_DMABase_RCR ((uint16_t)0x000C) +#define TIM_DMABase_CCR1 ((uint16_t)0x000D) +#define TIM_DMABase_CCR2 ((uint16_t)0x000E) +#define TIM_DMABase_CCR3 ((uint16_t)0x000F) +#define TIM_DMABase_CCR4 ((uint16_t)0x0010) +#define TIM_DMABase_BDTR ((uint16_t)0x0011) +#define TIM_DMABase_DCR ((uint16_t)0x0012) +#define TIM_DMABase_OR ((uint16_t)0x0013) +#define IS_TIM_DMA_BASE(BASE) (((BASE) == TIM_DMABase_CR1) || \ + ((BASE) == TIM_DMABase_CR2) || \ + ((BASE) == TIM_DMABase_SMCR) || \ + ((BASE) == TIM_DMABase_DIER) || \ + ((BASE) == TIM_DMABase_SR) || \ + ((BASE) == TIM_DMABase_EGR) || \ + ((BASE) == TIM_DMABase_CCMR1) || \ + ((BASE) == TIM_DMABase_CCMR2) || \ + ((BASE) == TIM_DMABase_CCER) || \ + ((BASE) == TIM_DMABase_CNT) || \ + ((BASE) == TIM_DMABase_PSC) || \ + ((BASE) == TIM_DMABase_ARR) || \ + ((BASE) == TIM_DMABase_RCR) || \ + ((BASE) == TIM_DMABase_CCR1) || \ + ((BASE) == TIM_DMABase_CCR2) || \ + ((BASE) == TIM_DMABase_CCR3) || \ + ((BASE) == TIM_DMABase_CCR4) || \ + ((BASE) == TIM_DMABase_BDTR) || \ + ((BASE) == TIM_DMABase_DCR) || \ + ((BASE) == TIM_DMABase_OR)) +/** + * @} + */ + +/** @defgroup TIM_DMA_Burst_Length + * @{ + */ + +#define TIM_DMABurstLength_1Transfer ((uint16_t)0x0000) +#define TIM_DMABurstLength_2Transfers ((uint16_t)0x0100) +#define TIM_DMABurstLength_3Transfers ((uint16_t)0x0200) +#define TIM_DMABurstLength_4Transfers ((uint16_t)0x0300) +#define TIM_DMABurstLength_5Transfers ((uint16_t)0x0400) +#define TIM_DMABurstLength_6Transfers ((uint16_t)0x0500) +#define TIM_DMABurstLength_7Transfers ((uint16_t)0x0600) +#define TIM_DMABurstLength_8Transfers ((uint16_t)0x0700) +#define TIM_DMABurstLength_9Transfers ((uint16_t)0x0800) +#define TIM_DMABurstLength_10Transfers ((uint16_t)0x0900) +#define TIM_DMABurstLength_11Transfers ((uint16_t)0x0A00) +#define TIM_DMABurstLength_12Transfers ((uint16_t)0x0B00) +#define TIM_DMABurstLength_13Transfers ((uint16_t)0x0C00) +#define TIM_DMABurstLength_14Transfers ((uint16_t)0x0D00) +#define TIM_DMABurstLength_15Transfers ((uint16_t)0x0E00) +#define TIM_DMABurstLength_16Transfers ((uint16_t)0x0F00) +#define TIM_DMABurstLength_17Transfers ((uint16_t)0x1000) +#define TIM_DMABurstLength_18Transfers ((uint16_t)0x1100) +#define IS_TIM_DMA_LENGTH(LENGTH) (((LENGTH) == TIM_DMABurstLength_1Transfer) || \ + ((LENGTH) == TIM_DMABurstLength_2Transfers) || \ + ((LENGTH) == TIM_DMABurstLength_3Transfers) || \ + ((LENGTH) == TIM_DMABurstLength_4Transfers) || \ + ((LENGTH) == TIM_DMABurstLength_5Transfers) || \ + ((LENGTH) == TIM_DMABurstLength_6Transfers) || \ + ((LENGTH) == TIM_DMABurstLength_7Transfers) || \ + ((LENGTH) == TIM_DMABurstLength_8Transfers) || \ + ((LENGTH) == TIM_DMABurstLength_9Transfers) || \ + ((LENGTH) == TIM_DMABurstLength_10Transfers) || \ + ((LENGTH) == TIM_DMABurstLength_11Transfers) || \ + ((LENGTH) == TIM_DMABurstLength_12Transfers) || \ + ((LENGTH) == TIM_DMABurstLength_13Transfers) || \ + ((LENGTH) == TIM_DMABurstLength_14Transfers) || \ + ((LENGTH) == TIM_DMABurstLength_15Transfers) || \ + ((LENGTH) == TIM_DMABurstLength_16Transfers) || \ + ((LENGTH) == TIM_DMABurstLength_17Transfers) || \ + ((LENGTH) == TIM_DMABurstLength_18Transfers)) +/** + * @} + */ + +/** @defgroup TIM_DMA_sources + * @{ + */ + +#define TIM_DMA_Update ((uint16_t)0x0100) +#define TIM_DMA_CC1 ((uint16_t)0x0200) +#define TIM_DMA_CC2 ((uint16_t)0x0400) +#define TIM_DMA_CC3 ((uint16_t)0x0800) +#define TIM_DMA_CC4 ((uint16_t)0x1000) +#define TIM_DMA_COM ((uint16_t)0x2000) +#define TIM_DMA_Trigger ((uint16_t)0x4000) +#define IS_TIM_DMA_SOURCE(SOURCE) ((((SOURCE) & (uint16_t)0x80FF) == 0x0000) && ((SOURCE) != 0x0000)) + +/** + * @} + */ + +/** @defgroup TIM_External_Trigger_Prescaler + * @{ + */ + +#define TIM_ExtTRGPSC_OFF ((uint16_t)0x0000) +#define TIM_ExtTRGPSC_DIV2 ((uint16_t)0x1000) +#define TIM_ExtTRGPSC_DIV4 ((uint16_t)0x2000) +#define TIM_ExtTRGPSC_DIV8 ((uint16_t)0x3000) +#define IS_TIM_EXT_PRESCALER(PRESCALER) (((PRESCALER) == TIM_ExtTRGPSC_OFF) || \ + ((PRESCALER) == TIM_ExtTRGPSC_DIV2) || \ + ((PRESCALER) == TIM_ExtTRGPSC_DIV4) || \ + ((PRESCALER) == TIM_ExtTRGPSC_DIV8)) +/** + * @} + */ + +/** @defgroup TIM_Internal_Trigger_Selection + * @{ + */ + +#define TIM_TS_ITR0 ((uint16_t)0x0000) +#define TIM_TS_ITR1 ((uint16_t)0x0010) +#define TIM_TS_ITR2 ((uint16_t)0x0020) +#define TIM_TS_ITR3 ((uint16_t)0x0030) +#define TIM_TS_TI1F_ED ((uint16_t)0x0040) +#define TIM_TS_TI1FP1 ((uint16_t)0x0050) +#define TIM_TS_TI2FP2 ((uint16_t)0x0060) +#define TIM_TS_ETRF ((uint16_t)0x0070) +#define IS_TIM_TRIGGER_SELECTION(SELECTION) (((SELECTION) == TIM_TS_ITR0) || \ + ((SELECTION) == TIM_TS_ITR1) || \ + ((SELECTION) == TIM_TS_ITR2) || \ + ((SELECTION) == TIM_TS_ITR3) || \ + ((SELECTION) == TIM_TS_TI1F_ED) || \ + ((SELECTION) == TIM_TS_TI1FP1) || \ + ((SELECTION) == TIM_TS_TI2FP2) || \ + ((SELECTION) == TIM_TS_ETRF)) +#define IS_TIM_INTERNAL_TRIGGER_SELECTION(SELECTION) (((SELECTION) == TIM_TS_ITR0) || \ + ((SELECTION) == TIM_TS_ITR1) || \ + ((SELECTION) == TIM_TS_ITR2) || \ + ((SELECTION) == TIM_TS_ITR3)) +/** + * @} + */ + +/** @defgroup TIM_TIx_External_Clock_Source + * @{ + */ + +#define TIM_TIxExternalCLK1Source_TI1 ((uint16_t)0x0050) +#define TIM_TIxExternalCLK1Source_TI2 ((uint16_t)0x0060) +#define TIM_TIxExternalCLK1Source_TI1ED ((uint16_t)0x0040) + +/** + * @} + */ + +/** @defgroup TIM_External_Trigger_Polarity + * @{ + */ +#define TIM_ExtTRGPolarity_Inverted ((uint16_t)0x8000) +#define TIM_ExtTRGPolarity_NonInverted ((uint16_t)0x0000) +#define IS_TIM_EXT_POLARITY(POLARITY) (((POLARITY) == TIM_ExtTRGPolarity_Inverted) || \ + ((POLARITY) == TIM_ExtTRGPolarity_NonInverted)) +/** + * @} + */ + +/** @defgroup TIM_Prescaler_Reload_Mode + * @{ + */ + +#define TIM_PSCReloadMode_Update ((uint16_t)0x0000) +#define TIM_PSCReloadMode_Immediate ((uint16_t)0x0001) +#define IS_TIM_PRESCALER_RELOAD(RELOAD) (((RELOAD) == TIM_PSCReloadMode_Update) || \ + ((RELOAD) == TIM_PSCReloadMode_Immediate)) +/** + * @} + */ + +/** @defgroup TIM_Forced_Action + * @{ + */ + +#define TIM_ForcedAction_Active ((uint16_t)0x0050) +#define TIM_ForcedAction_InActive ((uint16_t)0x0040) +#define IS_TIM_FORCED_ACTION(ACTION) (((ACTION) == TIM_ForcedAction_Active) || \ + ((ACTION) == TIM_ForcedAction_InActive)) +/** + * @} + */ + +/** @defgroup TIM_Encoder_Mode + * @{ + */ + +#define TIM_EncoderMode_TI1 ((uint16_t)0x0001) +#define TIM_EncoderMode_TI2 ((uint16_t)0x0002) +#define TIM_EncoderMode_TI12 ((uint16_t)0x0003) +#define IS_TIM_ENCODER_MODE(MODE) (((MODE) == TIM_EncoderMode_TI1) || \ + ((MODE) == TIM_EncoderMode_TI2) || \ + ((MODE) == TIM_EncoderMode_TI12)) +/** + * @} + */ + + +/** @defgroup TIM_Event_Source + * @{ + */ + +#define TIM_EventSource_Update ((uint16_t)0x0001) +#define TIM_EventSource_CC1 ((uint16_t)0x0002) +#define TIM_EventSource_CC2 ((uint16_t)0x0004) +#define TIM_EventSource_CC3 ((uint16_t)0x0008) +#define TIM_EventSource_CC4 ((uint16_t)0x0010) +#define TIM_EventSource_COM ((uint16_t)0x0020) +#define TIM_EventSource_Trigger ((uint16_t)0x0040) +#define TIM_EventSource_Break ((uint16_t)0x0080) +#define IS_TIM_EVENT_SOURCE(SOURCE) ((((SOURCE) & (uint16_t)0xFF00) == 0x0000) && ((SOURCE) != 0x0000)) + +/** + * @} + */ + +/** @defgroup TIM_Update_Source + * @{ + */ + +#define TIM_UpdateSource_Global ((uint16_t)0x0000) /*!< Source of update is the counter overflow/underflow + or the setting of UG bit, or an update generation + through the slave mode controller. */ +#define TIM_UpdateSource_Regular ((uint16_t)0x0001) /*!< Source of update is counter overflow/underflow. */ +#define IS_TIM_UPDATE_SOURCE(SOURCE) (((SOURCE) == TIM_UpdateSource_Global) || \ + ((SOURCE) == TIM_UpdateSource_Regular)) +/** + * @} + */ + +/** @defgroup TIM_Output_Compare_Preload_State + * @{ + */ + +#define TIM_OCPreload_Enable ((uint16_t)0x0008) +#define TIM_OCPreload_Disable ((uint16_t)0x0000) +#define IS_TIM_OCPRELOAD_STATE(STATE) (((STATE) == TIM_OCPreload_Enable) || \ + ((STATE) == TIM_OCPreload_Disable)) +/** + * @} + */ + +/** @defgroup TIM_Output_Compare_Fast_State + * @{ + */ + +#define TIM_OCFast_Enable ((uint16_t)0x0004) +#define TIM_OCFast_Disable ((uint16_t)0x0000) +#define IS_TIM_OCFAST_STATE(STATE) (((STATE) == TIM_OCFast_Enable) || \ + ((STATE) == TIM_OCFast_Disable)) + +/** + * @} + */ + +/** @defgroup TIM_Output_Compare_Clear_State + * @{ + */ + +#define TIM_OCClear_Enable ((uint16_t)0x0080) +#define TIM_OCClear_Disable ((uint16_t)0x0000) +#define IS_TIM_OCCLEAR_STATE(STATE) (((STATE) == TIM_OCClear_Enable) || \ + ((STATE) == TIM_OCClear_Disable)) +/** + * @} + */ + +/** @defgroup TIM_Trigger_Output_Source + * @{ + */ + +#define TIM_TRGOSource_Reset ((uint16_t)0x0000) +#define TIM_TRGOSource_Enable ((uint16_t)0x0010) +#define TIM_TRGOSource_Update ((uint16_t)0x0020) +#define TIM_TRGOSource_OC1 ((uint16_t)0x0030) +#define TIM_TRGOSource_OC1Ref ((uint16_t)0x0040) +#define TIM_TRGOSource_OC2Ref ((uint16_t)0x0050) +#define TIM_TRGOSource_OC3Ref ((uint16_t)0x0060) +#define TIM_TRGOSource_OC4Ref ((uint16_t)0x0070) +#define IS_TIM_TRGO_SOURCE(SOURCE) (((SOURCE) == TIM_TRGOSource_Reset) || \ + ((SOURCE) == TIM_TRGOSource_Enable) || \ + ((SOURCE) == TIM_TRGOSource_Update) || \ + ((SOURCE) == TIM_TRGOSource_OC1) || \ + ((SOURCE) == TIM_TRGOSource_OC1Ref) || \ + ((SOURCE) == TIM_TRGOSource_OC2Ref) || \ + ((SOURCE) == TIM_TRGOSource_OC3Ref) || \ + ((SOURCE) == TIM_TRGOSource_OC4Ref)) +/** + * @} + */ + +/** @defgroup TIM_Slave_Mode + * @{ + */ + +#define TIM_SlaveMode_Reset ((uint16_t)0x0004) +#define TIM_SlaveMode_Gated ((uint16_t)0x0005) +#define TIM_SlaveMode_Trigger ((uint16_t)0x0006) +#define TIM_SlaveMode_External1 ((uint16_t)0x0007) +#define IS_TIM_SLAVE_MODE(MODE) (((MODE) == TIM_SlaveMode_Reset) || \ + ((MODE) == TIM_SlaveMode_Gated) || \ + ((MODE) == TIM_SlaveMode_Trigger) || \ + ((MODE) == TIM_SlaveMode_External1)) +/** + * @} + */ + +/** @defgroup TIM_Master_Slave_Mode + * @{ + */ + +#define TIM_MasterSlaveMode_Enable ((uint16_t)0x0080) +#define TIM_MasterSlaveMode_Disable ((uint16_t)0x0000) +#define IS_TIM_MSM_STATE(STATE) (((STATE) == TIM_MasterSlaveMode_Enable) || \ + ((STATE) == TIM_MasterSlaveMode_Disable)) +/** + * @} + */ +/** @defgroup TIM_Remap + * @{ + */ + +#define TIM2_TIM8_TRGO ((uint16_t)0x0000) +#define TIM2_ETH_PTP ((uint16_t)0x0400) +#define TIM2_USBFS_SOF ((uint16_t)0x0800) +#define TIM2_USBHS_SOF ((uint16_t)0x0C00) + +#define TIM5_GPIO ((uint16_t)0x0000) +#define TIM5_LSI ((uint16_t)0x0040) +#define TIM5_LSE ((uint16_t)0x0080) +#define TIM5_RTC ((uint16_t)0x00C0) + +#define TIM11_GPIO ((uint16_t)0x0000) +#define TIM11_HSE ((uint16_t)0x0002) + +#define IS_TIM_REMAP(TIM_REMAP) (((TIM_REMAP) == TIM2_TIM8_TRGO)||\ + ((TIM_REMAP) == TIM2_ETH_PTP)||\ + ((TIM_REMAP) == TIM2_USBFS_SOF)||\ + ((TIM_REMAP) == TIM2_USBHS_SOF)||\ + ((TIM_REMAP) == TIM5_GPIO)||\ + ((TIM_REMAP) == TIM5_LSI)||\ + ((TIM_REMAP) == TIM5_LSE)||\ + ((TIM_REMAP) == TIM5_RTC)||\ + ((TIM_REMAP) == TIM11_GPIO)||\ + ((TIM_REMAP) == TIM11_HSE)) + +/** + * @} + */ +/** @defgroup TIM_Flags + * @{ + */ + +#define TIM_FLAG_Update ((uint16_t)0x0001) +#define TIM_FLAG_CC1 ((uint16_t)0x0002) +#define TIM_FLAG_CC2 ((uint16_t)0x0004) +#define TIM_FLAG_CC3 ((uint16_t)0x0008) +#define TIM_FLAG_CC4 ((uint16_t)0x0010) +#define TIM_FLAG_COM ((uint16_t)0x0020) +#define TIM_FLAG_Trigger ((uint16_t)0x0040) +#define TIM_FLAG_Break ((uint16_t)0x0080) +#define TIM_FLAG_CC1OF ((uint16_t)0x0200) +#define TIM_FLAG_CC2OF ((uint16_t)0x0400) +#define TIM_FLAG_CC3OF ((uint16_t)0x0800) +#define TIM_FLAG_CC4OF ((uint16_t)0x1000) +#define IS_TIM_GET_FLAG(FLAG) (((FLAG) == TIM_FLAG_Update) || \ + ((FLAG) == TIM_FLAG_CC1) || \ + ((FLAG) == TIM_FLAG_CC2) || \ + ((FLAG) == TIM_FLAG_CC3) || \ + ((FLAG) == TIM_FLAG_CC4) || \ + ((FLAG) == TIM_FLAG_COM) || \ + ((FLAG) == TIM_FLAG_Trigger) || \ + ((FLAG) == TIM_FLAG_Break) || \ + ((FLAG) == TIM_FLAG_CC1OF) || \ + ((FLAG) == TIM_FLAG_CC2OF) || \ + ((FLAG) == TIM_FLAG_CC3OF) || \ + ((FLAG) == TIM_FLAG_CC4OF)) + +/** + * @} + */ + +/** @defgroup TIM_Input_Capture_Filer_Value + * @{ + */ + +#define IS_TIM_IC_FILTER(ICFILTER) ((ICFILTER) <= 0xF) +/** + * @} + */ + +/** @defgroup TIM_External_Trigger_Filter + * @{ + */ + +#define IS_TIM_EXT_FILTER(EXTFILTER) ((EXTFILTER) <= 0xF) +/** + * @} + */ + +/** @defgroup TIM_Legacy + * @{ + */ + +#define TIM_DMABurstLength_1Byte TIM_DMABurstLength_1Transfer +#define TIM_DMABurstLength_2Bytes TIM_DMABurstLength_2Transfers +#define TIM_DMABurstLength_3Bytes TIM_DMABurstLength_3Transfers +#define TIM_DMABurstLength_4Bytes TIM_DMABurstLength_4Transfers +#define TIM_DMABurstLength_5Bytes TIM_DMABurstLength_5Transfers +#define TIM_DMABurstLength_6Bytes TIM_DMABurstLength_6Transfers +#define TIM_DMABurstLength_7Bytes TIM_DMABurstLength_7Transfers +#define TIM_DMABurstLength_8Bytes TIM_DMABurstLength_8Transfers +#define TIM_DMABurstLength_9Bytes TIM_DMABurstLength_9Transfers +#define TIM_DMABurstLength_10Bytes TIM_DMABurstLength_10Transfers +#define TIM_DMABurstLength_11Bytes TIM_DMABurstLength_11Transfers +#define TIM_DMABurstLength_12Bytes TIM_DMABurstLength_12Transfers +#define TIM_DMABurstLength_13Bytes TIM_DMABurstLength_13Transfers +#define TIM_DMABurstLength_14Bytes TIM_DMABurstLength_14Transfers +#define TIM_DMABurstLength_15Bytes TIM_DMABurstLength_15Transfers +#define TIM_DMABurstLength_16Bytes TIM_DMABurstLength_16Transfers +#define TIM_DMABurstLength_17Bytes TIM_DMABurstLength_17Transfers +#define TIM_DMABurstLength_18Bytes TIM_DMABurstLength_18Transfers +/** + * @} + */ + +/** + * @} + */ + +/* Exported macro ------------------------------------------------------------*/ +/* Exported functions --------------------------------------------------------*/ + +/* TimeBase management ********************************************************/ +void TIM_DeInit(TIM_TypeDef* TIMx); +void TIM_TimeBaseInit(TIM_TypeDef* TIMx, TIM_TimeBaseInitTypeDef* TIM_TimeBaseInitStruct); +void TIM_TimeBaseStructInit(TIM_TimeBaseInitTypeDef* TIM_TimeBaseInitStruct); +void TIM_PrescalerConfig(TIM_TypeDef* TIMx, uint16_t Prescaler, uint16_t TIM_PSCReloadMode); +void TIM_CounterModeConfig(TIM_TypeDef* TIMx, uint16_t TIM_CounterMode); +void TIM_SetCounter(TIM_TypeDef* TIMx, uint32_t Counter); +void TIM_SetAutoreload(TIM_TypeDef* TIMx, uint32_t Autoreload); +uint32_t TIM_GetCounter(TIM_TypeDef* TIMx); +uint16_t TIM_GetPrescaler(TIM_TypeDef* TIMx); +void TIM_UpdateDisableConfig(TIM_TypeDef* TIMx, FunctionalState NewState); +void TIM_UpdateRequestConfig(TIM_TypeDef* TIMx, uint16_t TIM_UpdateSource); +void TIM_ARRPreloadConfig(TIM_TypeDef* TIMx, FunctionalState NewState); +void TIM_SelectOnePulseMode(TIM_TypeDef* TIMx, uint16_t TIM_OPMode); +void TIM_SetClockDivision(TIM_TypeDef* TIMx, uint16_t TIM_CKD); +void TIM_Cmd(TIM_TypeDef* TIMx, FunctionalState NewState); + +/* Output Compare management **************************************************/ +void TIM_OC1Init(TIM_TypeDef* TIMx, TIM_OCInitTypeDef* TIM_OCInitStruct); +void TIM_OC2Init(TIM_TypeDef* TIMx, TIM_OCInitTypeDef* TIM_OCInitStruct); +void TIM_OC3Init(TIM_TypeDef* TIMx, TIM_OCInitTypeDef* TIM_OCInitStruct); +void TIM_OC4Init(TIM_TypeDef* TIMx, TIM_OCInitTypeDef* TIM_OCInitStruct); +void TIM_OCStructInit(TIM_OCInitTypeDef* TIM_OCInitStruct); +void TIM_SelectOCxM(TIM_TypeDef* TIMx, uint16_t TIM_Channel, uint16_t TIM_OCMode); +void TIM_SetCompare1(TIM_TypeDef* TIMx, uint32_t Compare1); +void TIM_SetCompare2(TIM_TypeDef* TIMx, uint32_t Compare2); +void TIM_SetCompare3(TIM_TypeDef* TIMx, uint32_t Compare3); +void TIM_SetCompare4(TIM_TypeDef* TIMx, uint32_t Compare4); +void TIM_ForcedOC1Config(TIM_TypeDef* TIMx, uint16_t TIM_ForcedAction); +void TIM_ForcedOC2Config(TIM_TypeDef* TIMx, uint16_t TIM_ForcedAction); +void TIM_ForcedOC3Config(TIM_TypeDef* TIMx, uint16_t TIM_ForcedAction); +void TIM_ForcedOC4Config(TIM_TypeDef* TIMx, uint16_t TIM_ForcedAction); +void TIM_OC1PreloadConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCPreload); +void TIM_OC2PreloadConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCPreload); +void TIM_OC3PreloadConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCPreload); +void TIM_OC4PreloadConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCPreload); +void TIM_OC1FastConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCFast); +void TIM_OC2FastConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCFast); +void TIM_OC3FastConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCFast); +void TIM_OC4FastConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCFast); +void TIM_ClearOC1Ref(TIM_TypeDef* TIMx, uint16_t TIM_OCClear); +void TIM_ClearOC2Ref(TIM_TypeDef* TIMx, uint16_t TIM_OCClear); +void TIM_ClearOC3Ref(TIM_TypeDef* TIMx, uint16_t TIM_OCClear); +void TIM_ClearOC4Ref(TIM_TypeDef* TIMx, uint16_t TIM_OCClear); +void TIM_OC1PolarityConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCPolarity); +void TIM_OC1NPolarityConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCNPolarity); +void TIM_OC2PolarityConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCPolarity); +void TIM_OC2NPolarityConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCNPolarity); +void TIM_OC3PolarityConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCPolarity); +void TIM_OC3NPolarityConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCNPolarity); +void TIM_OC4PolarityConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCPolarity); +void TIM_CCxCmd(TIM_TypeDef* TIMx, uint16_t TIM_Channel, uint16_t TIM_CCx); +void TIM_CCxNCmd(TIM_TypeDef* TIMx, uint16_t TIM_Channel, uint16_t TIM_CCxN); + +/* Input Capture management ***************************************************/ +void TIM_ICInit(TIM_TypeDef* TIMx, TIM_ICInitTypeDef* TIM_ICInitStruct); +void TIM_ICStructInit(TIM_ICInitTypeDef* TIM_ICInitStruct); +void TIM_PWMIConfig(TIM_TypeDef* TIMx, TIM_ICInitTypeDef* TIM_ICInitStruct); +uint32_t TIM_GetCapture1(TIM_TypeDef* TIMx); +uint32_t TIM_GetCapture2(TIM_TypeDef* TIMx); +uint32_t TIM_GetCapture3(TIM_TypeDef* TIMx); +uint32_t TIM_GetCapture4(TIM_TypeDef* TIMx); +void TIM_SetIC1Prescaler(TIM_TypeDef* TIMx, uint16_t TIM_ICPSC); +void TIM_SetIC2Prescaler(TIM_TypeDef* TIMx, uint16_t TIM_ICPSC); +void TIM_SetIC3Prescaler(TIM_TypeDef* TIMx, uint16_t TIM_ICPSC); +void TIM_SetIC4Prescaler(TIM_TypeDef* TIMx, uint16_t TIM_ICPSC); + +/* Advanced-control timers (TIM1 and TIM8) specific features ******************/ +void TIM_BDTRConfig(TIM_TypeDef* TIMx, TIM_BDTRInitTypeDef *TIM_BDTRInitStruct); +void TIM_BDTRStructInit(TIM_BDTRInitTypeDef* TIM_BDTRInitStruct); +void TIM_CtrlPWMOutputs(TIM_TypeDef* TIMx, FunctionalState NewState); +void TIM_SelectCOM(TIM_TypeDef* TIMx, FunctionalState NewState); +void TIM_CCPreloadControl(TIM_TypeDef* TIMx, FunctionalState NewState); + +/* Interrupts, DMA and flags management ***************************************/ +void TIM_ITConfig(TIM_TypeDef* TIMx, uint16_t TIM_IT, FunctionalState NewState); +void TIM_GenerateEvent(TIM_TypeDef* TIMx, uint16_t TIM_EventSource); +FlagStatus TIM_GetFlagStatus(TIM_TypeDef* TIMx, uint16_t TIM_FLAG); +void TIM_ClearFlag(TIM_TypeDef* TIMx, uint16_t TIM_FLAG); +ITStatus TIM_GetITStatus(TIM_TypeDef* TIMx, uint16_t TIM_IT); +void TIM_ClearITPendingBit(TIM_TypeDef* TIMx, uint16_t TIM_IT); +void TIM_DMAConfig(TIM_TypeDef* TIMx, uint16_t TIM_DMABase, uint16_t TIM_DMABurstLength); +void TIM_DMACmd(TIM_TypeDef* TIMx, uint16_t TIM_DMASource, FunctionalState NewState); +void TIM_SelectCCDMA(TIM_TypeDef* TIMx, FunctionalState NewState); + +/* Clocks management **********************************************************/ +void TIM_InternalClockConfig(TIM_TypeDef* TIMx); +void TIM_ITRxExternalClockConfig(TIM_TypeDef* TIMx, uint16_t TIM_InputTriggerSource); +void TIM_TIxExternalClockConfig(TIM_TypeDef* TIMx, uint16_t TIM_TIxExternalCLKSource, + uint16_t TIM_ICPolarity, uint16_t ICFilter); +void TIM_ETRClockMode1Config(TIM_TypeDef* TIMx, uint16_t TIM_ExtTRGPrescaler, uint16_t TIM_ExtTRGPolarity, + uint16_t ExtTRGFilter); +void TIM_ETRClockMode2Config(TIM_TypeDef* TIMx, uint16_t TIM_ExtTRGPrescaler, + uint16_t TIM_ExtTRGPolarity, uint16_t ExtTRGFilter); + +/* Synchronization management *************************************************/ +void TIM_SelectInputTrigger(TIM_TypeDef* TIMx, uint16_t TIM_InputTriggerSource); +void TIM_SelectOutputTrigger(TIM_TypeDef* TIMx, uint16_t TIM_TRGOSource); +void TIM_SelectSlaveMode(TIM_TypeDef* TIMx, uint16_t TIM_SlaveMode); +void TIM_SelectMasterSlaveMode(TIM_TypeDef* TIMx, uint16_t TIM_MasterSlaveMode); +void TIM_ETRConfig(TIM_TypeDef* TIMx, uint16_t TIM_ExtTRGPrescaler, uint16_t TIM_ExtTRGPolarity, + uint16_t ExtTRGFilter); + +/* Specific interface management **********************************************/ +void TIM_EncoderInterfaceConfig(TIM_TypeDef* TIMx, uint16_t TIM_EncoderMode, + uint16_t TIM_IC1Polarity, uint16_t TIM_IC2Polarity); +void TIM_SelectHallSensor(TIM_TypeDef* TIMx, FunctionalState NewState); + +/* Specific remapping management **********************************************/ +void TIM_RemapConfig(TIM_TypeDef* TIMx, uint16_t TIM_Remap); + +#ifdef __cplusplus +} +#endif + +#endif /*__STM32F4xx_TIM_H */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/inc/stm32f4xx_usart.h b/FWLIB/inc/stm32f4xx_usart.h new file mode 100644 index 0000000..c4f4433 --- /dev/null +++ b/FWLIB/inc/stm32f4xx_usart.h @@ -0,0 +1,431 @@ +/** + ****************************************************************************** + * @file stm32f4xx_usart.h + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file contains all the functions prototypes for the USART + * firmware library. + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Define to prevent recursive inclusion -------------------------------------*/ +#ifndef __STM32F4xx_USART_H +#define __STM32F4xx_USART_H + +#ifdef __cplusplus + extern "C" { +#endif + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @addtogroup USART + * @{ + */ + +/* Exported types ------------------------------------------------------------*/ + +/** + * @brief USART Init Structure definition + */ + +typedef struct +{ + uint32_t USART_BaudRate; /*!< This member configures the USART communication baud rate. + The baud rate is computed using the following formula: + - IntegerDivider = ((PCLKx) / (8 * (OVR8+1) * (USART_InitStruct->USART_BaudRate))) + - FractionalDivider = ((IntegerDivider - ((u32) IntegerDivider)) * 8 * (OVR8+1)) + 0.5 + Where OVR8 is the "oversampling by 8 mode" configuration bit in the CR1 register. */ + + uint16_t USART_WordLength; /*!< Specifies the number of data bits transmitted or received in a frame. + This parameter can be a value of @ref USART_Word_Length */ + + uint16_t USART_StopBits; /*!< Specifies the number of stop bits transmitted. + This parameter can be a value of @ref USART_Stop_Bits */ + + uint16_t USART_Parity; /*!< Specifies the parity mode. + This parameter can be a value of @ref USART_Parity + @note When parity is enabled, the computed parity is inserted + at the MSB position of the transmitted data (9th bit when + the word length is set to 9 data bits; 8th bit when the + word length is set to 8 data bits). */ + + uint16_t USART_Mode; /*!< Specifies wether the Receive or Transmit mode is enabled or disabled. + This parameter can be a value of @ref USART_Mode */ + + uint16_t USART_HardwareFlowControl; /*!< Specifies wether the hardware flow control mode is enabled + or disabled. + This parameter can be a value of @ref USART_Hardware_Flow_Control */ +} USART_InitTypeDef; + +/** + * @brief USART Clock Init Structure definition + */ + +typedef struct +{ + + uint16_t USART_Clock; /*!< Specifies whether the USART clock is enabled or disabled. + This parameter can be a value of @ref USART_Clock */ + + uint16_t USART_CPOL; /*!< Specifies the steady state of the serial clock. + This parameter can be a value of @ref USART_Clock_Polarity */ + + uint16_t USART_CPHA; /*!< Specifies the clock transition on which the bit capture is made. + This parameter can be a value of @ref USART_Clock_Phase */ + + uint16_t USART_LastBit; /*!< Specifies whether the clock pulse corresponding to the last transmitted + data bit (MSB) has to be output on the SCLK pin in synchronous mode. + This parameter can be a value of @ref USART_Last_Bit */ +} USART_ClockInitTypeDef; + +/* Exported constants --------------------------------------------------------*/ + +/** @defgroup USART_Exported_Constants + * @{ + */ + +#define IS_USART_ALL_PERIPH(PERIPH) (((PERIPH) == USART1) || \ + ((PERIPH) == USART2) || \ + ((PERIPH) == USART3) || \ + ((PERIPH) == UART4) || \ + ((PERIPH) == UART5) || \ + ((PERIPH) == USART6) || \ + ((PERIPH) == UART7) || \ + ((PERIPH) == UART8)) + +#define IS_USART_1236_PERIPH(PERIPH) (((PERIPH) == USART1) || \ + ((PERIPH) == USART2) || \ + ((PERIPH) == USART3) || \ + ((PERIPH) == USART6)) + +/** @defgroup USART_Word_Length + * @{ + */ + +#define USART_WordLength_8b ((uint16_t)0x0000) +#define USART_WordLength_9b ((uint16_t)0x1000) + +#define IS_USART_WORD_LENGTH(LENGTH) (((LENGTH) == USART_WordLength_8b) || \ + ((LENGTH) == USART_WordLength_9b)) +/** + * @} + */ + +/** @defgroup USART_Stop_Bits + * @{ + */ + +#define USART_StopBits_1 ((uint16_t)0x0000) +#define USART_StopBits_0_5 ((uint16_t)0x1000) +#define USART_StopBits_2 ((uint16_t)0x2000) +#define USART_StopBits_1_5 ((uint16_t)0x3000) +#define IS_USART_STOPBITS(STOPBITS) (((STOPBITS) == USART_StopBits_1) || \ + ((STOPBITS) == USART_StopBits_0_5) || \ + ((STOPBITS) == USART_StopBits_2) || \ + ((STOPBITS) == USART_StopBits_1_5)) +/** + * @} + */ + +/** @defgroup USART_Parity + * @{ + */ + +#define USART_Parity_No ((uint16_t)0x0000) +#define USART_Parity_Even ((uint16_t)0x0400) +#define USART_Parity_Odd ((uint16_t)0x0600) +#define IS_USART_PARITY(PARITY) (((PARITY) == USART_Parity_No) || \ + ((PARITY) == USART_Parity_Even) || \ + ((PARITY) == USART_Parity_Odd)) +/** + * @} + */ + +/** @defgroup USART_Mode + * @{ + */ + +#define USART_Mode_Rx ((uint16_t)0x0004) +#define USART_Mode_Tx ((uint16_t)0x0008) +#define IS_USART_MODE(MODE) ((((MODE) & (uint16_t)0xFFF3) == 0x00) && ((MODE) != (uint16_t)0x00)) +/** + * @} + */ + +/** @defgroup USART_Hardware_Flow_Control + * @{ + */ +#define USART_HardwareFlowControl_None ((uint16_t)0x0000) +#define USART_HardwareFlowControl_RTS ((uint16_t)0x0100) +#define USART_HardwareFlowControl_CTS ((uint16_t)0x0200) +#define USART_HardwareFlowControl_RTS_CTS ((uint16_t)0x0300) +#define IS_USART_HARDWARE_FLOW_CONTROL(CONTROL)\ + (((CONTROL) == USART_HardwareFlowControl_None) || \ + ((CONTROL) == USART_HardwareFlowControl_RTS) || \ + ((CONTROL) == USART_HardwareFlowControl_CTS) || \ + ((CONTROL) == USART_HardwareFlowControl_RTS_CTS)) +/** + * @} + */ + +/** @defgroup USART_Clock + * @{ + */ +#define USART_Clock_Disable ((uint16_t)0x0000) +#define USART_Clock_Enable ((uint16_t)0x0800) +#define IS_USART_CLOCK(CLOCK) (((CLOCK) == USART_Clock_Disable) || \ + ((CLOCK) == USART_Clock_Enable)) +/** + * @} + */ + +/** @defgroup USART_Clock_Polarity + * @{ + */ + +#define USART_CPOL_Low ((uint16_t)0x0000) +#define USART_CPOL_High ((uint16_t)0x0400) +#define IS_USART_CPOL(CPOL) (((CPOL) == USART_CPOL_Low) || ((CPOL) == USART_CPOL_High)) + +/** + * @} + */ + +/** @defgroup USART_Clock_Phase + * @{ + */ + +#define USART_CPHA_1Edge ((uint16_t)0x0000) +#define USART_CPHA_2Edge ((uint16_t)0x0200) +#define IS_USART_CPHA(CPHA) (((CPHA) == USART_CPHA_1Edge) || ((CPHA) == USART_CPHA_2Edge)) + +/** + * @} + */ + +/** @defgroup USART_Last_Bit + * @{ + */ + +#define USART_LastBit_Disable ((uint16_t)0x0000) +#define USART_LastBit_Enable ((uint16_t)0x0100) +#define IS_USART_LASTBIT(LASTBIT) (((LASTBIT) == USART_LastBit_Disable) || \ + ((LASTBIT) == USART_LastBit_Enable)) +/** + * @} + */ + +/** @defgroup USART_Interrupt_definition + * @{ + */ + +#define USART_IT_PE ((uint16_t)0x0028) +#define USART_IT_TXE ((uint16_t)0x0727) +#define USART_IT_TC ((uint16_t)0x0626) +#define USART_IT_RXNE ((uint16_t)0x0525) +#define USART_IT_ORE_RX ((uint16_t)0x0325) /* In case interrupt is generated if the RXNEIE bit is set */ +#define USART_IT_IDLE ((uint16_t)0x0424) +#define USART_IT_LBD ((uint16_t)0x0846) +#define USART_IT_CTS ((uint16_t)0x096A) +#define USART_IT_ERR ((uint16_t)0x0060) +#define USART_IT_ORE_ER ((uint16_t)0x0360) /* In case interrupt is generated if the EIE bit is set */ +#define USART_IT_NE ((uint16_t)0x0260) +#define USART_IT_FE ((uint16_t)0x0160) + +/** @defgroup USART_Legacy + * @{ + */ +#define USART_IT_ORE USART_IT_ORE_ER +/** + * @} + */ + +#define IS_USART_CONFIG_IT(IT) (((IT) == USART_IT_PE) || ((IT) == USART_IT_TXE) || \ + ((IT) == USART_IT_TC) || ((IT) == USART_IT_RXNE) || \ + ((IT) == USART_IT_IDLE) || ((IT) == USART_IT_LBD) || \ + ((IT) == USART_IT_CTS) || ((IT) == USART_IT_ERR)) +#define IS_USART_GET_IT(IT) (((IT) == USART_IT_PE) || ((IT) == USART_IT_TXE) || \ + ((IT) == USART_IT_TC) || ((IT) == USART_IT_RXNE) || \ + ((IT) == USART_IT_IDLE) || ((IT) == USART_IT_LBD) || \ + ((IT) == USART_IT_CTS) || ((IT) == USART_IT_ORE) || \ + ((IT) == USART_IT_ORE_RX) || ((IT) == USART_IT_ORE_ER) || \ + ((IT) == USART_IT_NE) || ((IT) == USART_IT_FE)) +#define IS_USART_CLEAR_IT(IT) (((IT) == USART_IT_TC) || ((IT) == USART_IT_RXNE) || \ + ((IT) == USART_IT_LBD) || ((IT) == USART_IT_CTS)) +/** + * @} + */ + +/** @defgroup USART_DMA_Requests + * @{ + */ + +#define USART_DMAReq_Tx ((uint16_t)0x0080) +#define USART_DMAReq_Rx ((uint16_t)0x0040) +#define IS_USART_DMAREQ(DMAREQ) ((((DMAREQ) & (uint16_t)0xFF3F) == 0x00) && ((DMAREQ) != (uint16_t)0x00)) + +/** + * @} + */ + +/** @defgroup USART_WakeUp_methods + * @{ + */ + +#define USART_WakeUp_IdleLine ((uint16_t)0x0000) +#define USART_WakeUp_AddressMark ((uint16_t)0x0800) +#define IS_USART_WAKEUP(WAKEUP) (((WAKEUP) == USART_WakeUp_IdleLine) || \ + ((WAKEUP) == USART_WakeUp_AddressMark)) +/** + * @} + */ + +/** @defgroup USART_LIN_Break_Detection_Length + * @{ + */ + +#define USART_LINBreakDetectLength_10b ((uint16_t)0x0000) +#define USART_LINBreakDetectLength_11b ((uint16_t)0x0020) +#define IS_USART_LIN_BREAK_DETECT_LENGTH(LENGTH) \ + (((LENGTH) == USART_LINBreakDetectLength_10b) || \ + ((LENGTH) == USART_LINBreakDetectLength_11b)) +/** + * @} + */ + +/** @defgroup USART_IrDA_Low_Power + * @{ + */ + +#define USART_IrDAMode_LowPower ((uint16_t)0x0004) +#define USART_IrDAMode_Normal ((uint16_t)0x0000) +#define IS_USART_IRDA_MODE(MODE) (((MODE) == USART_IrDAMode_LowPower) || \ + ((MODE) == USART_IrDAMode_Normal)) +/** + * @} + */ + +/** @defgroup USART_Flags + * @{ + */ + +#define USART_FLAG_CTS ((uint16_t)0x0200) +#define USART_FLAG_LBD ((uint16_t)0x0100) +#define USART_FLAG_TXE ((uint16_t)0x0080) +#define USART_FLAG_TC ((uint16_t)0x0040) +#define USART_FLAG_RXNE ((uint16_t)0x0020) +#define USART_FLAG_IDLE ((uint16_t)0x0010) +#define USART_FLAG_ORE ((uint16_t)0x0008) +#define USART_FLAG_NE ((uint16_t)0x0004) +#define USART_FLAG_FE ((uint16_t)0x0002) +#define USART_FLAG_PE ((uint16_t)0x0001) +#define IS_USART_FLAG(FLAG) (((FLAG) == USART_FLAG_PE) || ((FLAG) == USART_FLAG_TXE) || \ + ((FLAG) == USART_FLAG_TC) || ((FLAG) == USART_FLAG_RXNE) || \ + ((FLAG) == USART_FLAG_IDLE) || ((FLAG) == USART_FLAG_LBD) || \ + ((FLAG) == USART_FLAG_CTS) || ((FLAG) == USART_FLAG_ORE) || \ + ((FLAG) == USART_FLAG_NE) || ((FLAG) == USART_FLAG_FE)) + +#define IS_USART_CLEAR_FLAG(FLAG) ((((FLAG) & (uint16_t)0xFC9F) == 0x00) && ((FLAG) != (uint16_t)0x00)) + +#define IS_USART_BAUDRATE(BAUDRATE) (((BAUDRATE) > 0) && ((BAUDRATE) < 7500001)) +#define IS_USART_ADDRESS(ADDRESS) ((ADDRESS) <= 0xF) +#define IS_USART_DATA(DATA) ((DATA) <= 0x1FF) + +/** + * @} + */ + +/** + * @} + */ + +/* Exported macro ------------------------------------------------------------*/ +/* Exported functions --------------------------------------------------------*/ + +/* Function used to set the USART configuration to the default reset state ***/ +void USART_DeInit(USART_TypeDef* USARTx); + +/* Initialization and Configuration functions *********************************/ +void USART_Init(USART_TypeDef* USARTx, USART_InitTypeDef* USART_InitStruct); +void USART_StructInit(USART_InitTypeDef* USART_InitStruct); +void USART_ClockInit(USART_TypeDef* USARTx, USART_ClockInitTypeDef* USART_ClockInitStruct); +void USART_ClockStructInit(USART_ClockInitTypeDef* USART_ClockInitStruct); +void USART_Cmd(USART_TypeDef* USARTx, FunctionalState NewState); +void USART_SetPrescaler(USART_TypeDef* USARTx, uint8_t USART_Prescaler); +void USART_OverSampling8Cmd(USART_TypeDef* USARTx, FunctionalState NewState); +void USART_OneBitMethodCmd(USART_TypeDef* USARTx, FunctionalState NewState); + +/* Data transfers functions ***************************************************/ +void USART_SendData(USART_TypeDef* USARTx, uint16_t Data); +uint16_t USART_ReceiveData(USART_TypeDef* USARTx); + +/* Multi-Processor Communication functions ************************************/ +void USART_SetAddress(USART_TypeDef* USARTx, uint8_t USART_Address); +void USART_WakeUpConfig(USART_TypeDef* USARTx, uint16_t USART_WakeUp); +void USART_ReceiverWakeUpCmd(USART_TypeDef* USARTx, FunctionalState NewState); + +/* LIN mode functions *********************************************************/ +void USART_LINBreakDetectLengthConfig(USART_TypeDef* USARTx, uint16_t USART_LINBreakDetectLength); +void USART_LINCmd(USART_TypeDef* USARTx, FunctionalState NewState); +void USART_SendBreak(USART_TypeDef* USARTx); + +/* Half-duplex mode function **************************************************/ +void USART_HalfDuplexCmd(USART_TypeDef* USARTx, FunctionalState NewState); + +/* Smartcard mode functions ***************************************************/ +void USART_SmartCardCmd(USART_TypeDef* USARTx, FunctionalState NewState); +void USART_SmartCardNACKCmd(USART_TypeDef* USARTx, FunctionalState NewState); +void USART_SetGuardTime(USART_TypeDef* USARTx, uint8_t USART_GuardTime); + +/* IrDA mode functions ********************************************************/ +void USART_IrDAConfig(USART_TypeDef* USARTx, uint16_t USART_IrDAMode); +void USART_IrDACmd(USART_TypeDef* USARTx, FunctionalState NewState); + +/* DMA transfers management functions *****************************************/ +void USART_DMACmd(USART_TypeDef* USARTx, uint16_t USART_DMAReq, FunctionalState NewState); + +/* Interrupts and flags management functions **********************************/ +void USART_ITConfig(USART_TypeDef* USARTx, uint16_t USART_IT, FunctionalState NewState); +FlagStatus USART_GetFlagStatus(USART_TypeDef* USARTx, uint16_t USART_FLAG); +void USART_ClearFlag(USART_TypeDef* USARTx, uint16_t USART_FLAG); +ITStatus USART_GetITStatus(USART_TypeDef* USARTx, uint16_t USART_IT); +void USART_ClearITPendingBit(USART_TypeDef* USARTx, uint16_t USART_IT); + +#ifdef __cplusplus +} +#endif + +#endif /* __STM32F4xx_USART_H */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/inc/stm32f4xx_wwdg.h b/FWLIB/inc/stm32f4xx_wwdg.h new file mode 100644 index 0000000..acd7850 --- /dev/null +++ b/FWLIB/inc/stm32f4xx_wwdg.h @@ -0,0 +1,111 @@ +/** + ****************************************************************************** + * @file stm32f4xx_wwdg.h + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file contains all the functions prototypes for the WWDG firmware + * library. + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Define to prevent recursive inclusion -------------------------------------*/ +#ifndef __STM32F4xx_WWDG_H +#define __STM32F4xx_WWDG_H + +#ifdef __cplusplus + extern "C" { +#endif + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @addtogroup WWDG + * @{ + */ + +/* Exported types ------------------------------------------------------------*/ +/* Exported constants --------------------------------------------------------*/ + +/** @defgroup WWDG_Exported_Constants + * @{ + */ + +/** @defgroup WWDG_Prescaler + * @{ + */ + +#define WWDG_Prescaler_1 ((uint32_t)0x00000000) +#define WWDG_Prescaler_2 ((uint32_t)0x00000080) +#define WWDG_Prescaler_4 ((uint32_t)0x00000100) +#define WWDG_Prescaler_8 ((uint32_t)0x00000180) +#define IS_WWDG_PRESCALER(PRESCALER) (((PRESCALER) == WWDG_Prescaler_1) || \ + ((PRESCALER) == WWDG_Prescaler_2) || \ + ((PRESCALER) == WWDG_Prescaler_4) || \ + ((PRESCALER) == WWDG_Prescaler_8)) +#define IS_WWDG_WINDOW_VALUE(VALUE) ((VALUE) <= 0x7F) +#define IS_WWDG_COUNTER(COUNTER) (((COUNTER) >= 0x40) && ((COUNTER) <= 0x7F)) + +/** + * @} + */ + +/** + * @} + */ + +/* Exported macro ------------------------------------------------------------*/ +/* Exported functions --------------------------------------------------------*/ + +/* Function used to set the WWDG configuration to the default reset state ****/ +void WWDG_DeInit(void); + +/* Prescaler, Refresh window and Counter configuration functions **************/ +void WWDG_SetPrescaler(uint32_t WWDG_Prescaler); +void WWDG_SetWindowValue(uint8_t WindowValue); +void WWDG_EnableIT(void); +void WWDG_SetCounter(uint8_t Counter); + +/* WWDG activation function ***************************************************/ +void WWDG_Enable(uint8_t Counter); + +/* Interrupts and flags management functions **********************************/ +FlagStatus WWDG_GetFlagStatus(void); +void WWDG_ClearFlag(void); + +#ifdef __cplusplus +} +#endif + +#endif /* __STM32F4xx_WWDG_H */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/src/misc.c b/FWLIB/src/misc.c new file mode 100644 index 0000000..dc7d808 --- /dev/null +++ b/FWLIB/src/misc.c @@ -0,0 +1,249 @@ +/** + ****************************************************************************** + * @file misc.c + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file provides all the miscellaneous firmware functions (add-on + * to CMSIS functions). + * + * @verbatim + * + * =================================================================== + * How to configure Interrupts using driver + * =================================================================== + * + * This section provide functions allowing to configure the NVIC interrupts (IRQ). + * The Cortex-M4 exceptions are managed by CMSIS functions. + * + * 1. Configure the NVIC Priority Grouping using NVIC_PriorityGroupConfig() + * function according to the following table. + + * The table below gives the allowed values of the pre-emption priority and subpriority according + * to the Priority Grouping configuration performed by NVIC_PriorityGroupConfig function + * ========================================================================================================================== + * NVIC_PriorityGroup | NVIC_IRQChannelPreemptionPriority | NVIC_IRQChannelSubPriority | Description + * ========================================================================================================================== + * NVIC_PriorityGroup_0 | 0 | 0-15 | 0 bits for pre-emption priority + * | | | 4 bits for subpriority + * -------------------------------------------------------------------------------------------------------------------------- + * NVIC_PriorityGroup_1 | 0-1 | 0-7 | 1 bits for pre-emption priority + * | | | 3 bits for subpriority + * -------------------------------------------------------------------------------------------------------------------------- + * NVIC_PriorityGroup_2 | 0-3 | 0-3 | 2 bits for pre-emption priority + * | | | 2 bits for subpriority + * -------------------------------------------------------------------------------------------------------------------------- + * NVIC_PriorityGroup_3 | 0-7 | 0-1 | 3 bits for pre-emption priority + * | | | 1 bits for subpriority + * -------------------------------------------------------------------------------------------------------------------------- + * NVIC_PriorityGroup_4 | 0-15 | 0 | 4 bits for pre-emption priority + * | | | 0 bits for subpriority + * ========================================================================================================================== + * + * 2. Enable and Configure the priority of the selected IRQ Channels using NVIC_Init() + * + * @note When the NVIC_PriorityGroup_0 is selected, IRQ pre-emption is no more possible. + * The pending IRQ priority will be managed only by the subpriority. + * + * @note IRQ priority order (sorted by highest to lowest priority): + * - Lowest pre-emption priority + * - Lowest subpriority + * - Lowest hardware priority (IRQ number) + * + * @endverbatim + * + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Includes ------------------------------------------------------------------*/ +#include "misc.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @defgroup MISC + * @brief MISC driver modules + * @{ + */ + +/* Private typedef -----------------------------------------------------------*/ +/* Private define ------------------------------------------------------------*/ +#define AIRCR_VECTKEY_MASK ((uint32_t)0x05FA0000) + +/* Private macro -------------------------------------------------------------*/ +/* Private variables ---------------------------------------------------------*/ +/* Private function prototypes -----------------------------------------------*/ +/* Private functions ---------------------------------------------------------*/ + +/** @defgroup MISC_Private_Functions + * @{ + */ + +/** + * @brief Configures the priority grouping: pre-emption priority and subpriority. + * @param NVIC_PriorityGroup: specifies the priority grouping bits length. + * This parameter can be one of the following values: + * @arg NVIC_PriorityGroup_0: 0 bits for pre-emption priority + * 4 bits for subpriority + * @arg NVIC_PriorityGroup_1: 1 bits for pre-emption priority + * 3 bits for subpriority + * @arg NVIC_PriorityGroup_2: 2 bits for pre-emption priority + * 2 bits for subpriority + * @arg NVIC_PriorityGroup_3: 3 bits for pre-emption priority + * 1 bits for subpriority + * @arg NVIC_PriorityGroup_4: 4 bits for pre-emption priority + * 0 bits for subpriority + * @note When the NVIC_PriorityGroup_0 is selected, IRQ pre-emption is no more possible. + * The pending IRQ priority will be managed only by the subpriority. + * @retval None + */ +void NVIC_PriorityGroupConfig(uint32_t NVIC_PriorityGroup) +{ + /* Check the parameters */ + assert_param(IS_NVIC_PRIORITY_GROUP(NVIC_PriorityGroup)); + + /* Set the PRIGROUP[10:8] bits according to NVIC_PriorityGroup value */ + SCB->AIRCR = AIRCR_VECTKEY_MASK | NVIC_PriorityGroup; +} + +/** + * @brief Initializes the NVIC peripheral according to the specified + * parameters in the NVIC_InitStruct. + * @note To configure interrupts priority correctly, the NVIC_PriorityGroupConfig() + * function should be called before. + * @param NVIC_InitStruct: pointer to a NVIC_InitTypeDef structure that contains + * the configuration information for the specified NVIC peripheral. + * @retval None + */ +void NVIC_Init(NVIC_InitTypeDef* NVIC_InitStruct) +{ + uint8_t tmppriority = 0x00, tmppre = 0x00, tmpsub = 0x0F; + + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NVIC_InitStruct->NVIC_IRQChannelCmd)); + assert_param(IS_NVIC_PREEMPTION_PRIORITY(NVIC_InitStruct->NVIC_IRQChannelPreemptionPriority)); + assert_param(IS_NVIC_SUB_PRIORITY(NVIC_InitStruct->NVIC_IRQChannelSubPriority)); + + if (NVIC_InitStruct->NVIC_IRQChannelCmd != DISABLE) + { + /* Compute the Corresponding IRQ Priority --------------------------------*/ + tmppriority = (0x700 - ((SCB->AIRCR) & (uint32_t)0x700))>> 0x08; + tmppre = (0x4 - tmppriority); + tmpsub = tmpsub >> tmppriority; + + tmppriority = NVIC_InitStruct->NVIC_IRQChannelPreemptionPriority << tmppre; + tmppriority |= (uint8_t)(NVIC_InitStruct->NVIC_IRQChannelSubPriority & tmpsub); + + tmppriority = tmppriority << 0x04; + + NVIC->IP[NVIC_InitStruct->NVIC_IRQChannel] = tmppriority; + + /* Enable the Selected IRQ Channels --------------------------------------*/ + NVIC->ISER[NVIC_InitStruct->NVIC_IRQChannel >> 0x05] = + (uint32_t)0x01 << (NVIC_InitStruct->NVIC_IRQChannel & (uint8_t)0x1F); + } + else + { + /* Disable the Selected IRQ Channels -------------------------------------*/ + NVIC->ICER[NVIC_InitStruct->NVIC_IRQChannel >> 0x05] = + (uint32_t)0x01 << (NVIC_InitStruct->NVIC_IRQChannel & (uint8_t)0x1F); + } +} + +/** + * @brief Sets the vector table location and Offset. + * @param NVIC_VectTab: specifies if the vector table is in RAM or FLASH memory. + * This parameter can be one of the following values: + * @arg NVIC_VectTab_RAM: Vector Table in internal SRAM. + * @arg NVIC_VectTab_FLASH: Vector Table in internal FLASH. + * @param Offset: Vector Table base offset field. This value must be a multiple of 0x200. + * @retval None + */ +void NVIC_SetVectorTable(uint32_t NVIC_VectTab, uint32_t Offset) +{ + /* Check the parameters */ + assert_param(IS_NVIC_VECTTAB(NVIC_VectTab)); + assert_param(IS_NVIC_OFFSET(Offset)); + + SCB->VTOR = NVIC_VectTab | (Offset & (uint32_t)0x1FFFFF80); +} + +/** + * @brief Selects the condition for the system to enter low power mode. + * @param LowPowerMode: Specifies the new mode for the system to enter low power mode. + * This parameter can be one of the following values: + * @arg NVIC_LP_SEVONPEND: Low Power SEV on Pend. + * @arg NVIC_LP_SLEEPDEEP: Low Power DEEPSLEEP request. + * @arg NVIC_LP_SLEEPONEXIT: Low Power Sleep on Exit. + * @param NewState: new state of LP condition. This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void NVIC_SystemLPConfig(uint8_t LowPowerMode, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_NVIC_LP(LowPowerMode)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + SCB->SCR |= LowPowerMode; + } + else + { + SCB->SCR &= (uint32_t)(~(uint32_t)LowPowerMode); + } +} + +/** + * @brief Configures the SysTick clock source. + * @param SysTick_CLKSource: specifies the SysTick clock source. + * This parameter can be one of the following values: + * @arg SysTick_CLKSource_HCLK_Div8: AHB clock divided by 8 selected as SysTick clock source. + * @arg SysTick_CLKSource_HCLK: AHB clock selected as SysTick clock source. + * @retval None + */ +void SysTick_CLKSourceConfig(uint32_t SysTick_CLKSource) +{ + /* Check the parameters */ + assert_param(IS_SYSTICK_CLK_SOURCE(SysTick_CLKSource)); + if (SysTick_CLKSource == SysTick_CLKSource_HCLK) + { + SysTick->CTRL |= SysTick_CLKSource_HCLK; + } + else + { + SysTick->CTRL &= SysTick_CLKSource_HCLK_Div8; + } +} + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/src/stm32f4xx_adc.c b/FWLIB/src/stm32f4xx_adc.c new file mode 100644 index 0000000..50d0248 --- /dev/null +++ b/FWLIB/src/stm32f4xx_adc.c @@ -0,0 +1,1745 @@ +/** + ****************************************************************************** + * @file stm32f4xx_adc.c + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file provides firmware functions to manage the following + * functionalities of the Analog to Digital Convertor (ADC) peripheral: + * + Initialization and Configuration (in addition to ADC multi mode + * selection) + * + Analog Watchdog configuration + * + Temperature Sensor & Vrefint (Voltage Reference internal) & VBAT + * management + * + Regular Channels Configuration + * + Regular Channels DMA Configuration + * + Injected channels Configuration + * + Interrupts and flags management + * + @verbatim + =============================================================================== + ##### How to use this driver ##### + =============================================================================== + [..] + (#) Enable the ADC interface clock using + RCC_APB2PeriphClockCmd(RCC_APB2Periph_ADCx, ENABLE); + + (#) ADC pins configuration + (++) Enable the clock for the ADC GPIOs using the following function: + RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOx, ENABLE); + (++) Configure these ADC pins in analog mode using GPIO_Init(); + + (#) Configure the ADC Prescaler, conversion resolution and data + alignment using the ADC_Init() function. + (#) Activate the ADC peripheral using ADC_Cmd() function. + + *** Regular channels group configuration *** + ============================================ + [..] + (+) To configure the ADC regular channels group features, use + ADC_Init() and ADC_RegularChannelConfig() functions. + (+) To activate the continuous mode, use the ADC_continuousModeCmd() + function. + (+) To configurate and activate the Discontinuous mode, use the + ADC_DiscModeChannelCountConfig() and ADC_DiscModeCmd() functions. + (+) To read the ADC converted values, use the ADC_GetConversionValue() + function. + + *** Multi mode ADCs Regular channels configuration *** + ====================================================== + [..] + (+) Refer to "Regular channels group configuration" description to + configure the ADC1, ADC2 and ADC3 regular channels. + (+) Select the Multi mode ADC regular channels features (dual or + triple mode) using ADC_CommonInit() function and configure + the DMA mode using ADC_MultiModeDMARequestAfterLastTransferCmd() + functions. + (+) Read the ADCs converted values using the + ADC_GetMultiModeConversionValue() function. + + *** DMA for Regular channels group features configuration *** + ============================================================= + [..] + (+) To enable the DMA mode for regular channels group, use the + ADC_DMACmd() function. + (+) To enable the generation of DMA requests continuously at the end + of the last DMA transfer, use the ADC_DMARequestAfterLastTransferCmd() + function. + + *** Injected channels group configuration *** + ============================================= + [..] + (+) To configure the ADC Injected channels group features, use + ADC_InjectedChannelConfig() and ADC_InjectedSequencerLengthConfig() + functions. + (+) To activate the continuous mode, use the ADC_continuousModeCmd() + function. + (+) To activate the Injected Discontinuous mode, use the + ADC_InjectedDiscModeCmd() function. + (+) To activate the AutoInjected mode, use the ADC_AutoInjectedConvCmd() + function. + (+) To read the ADC converted values, use the ADC_GetInjectedConversionValue() + function. + + @endverbatim + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx_adc.h" +#include "stm32f4xx_rcc.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @defgroup ADC + * @brief ADC driver modules + * @{ + */ + +/* Private typedef -----------------------------------------------------------*/ +/* Private define ------------------------------------------------------------*/ + +/* ADC DISCNUM mask */ +#define CR1_DISCNUM_RESET ((uint32_t)0xFFFF1FFF) + +/* ADC AWDCH mask */ +#define CR1_AWDCH_RESET ((uint32_t)0xFFFFFFE0) + +/* ADC Analog watchdog enable mode mask */ +#define CR1_AWDMode_RESET ((uint32_t)0xFF3FFDFF) + +/* CR1 register Mask */ +#define CR1_CLEAR_MASK ((uint32_t)0xFCFFFEFF) + +/* ADC EXTEN mask */ +#define CR2_EXTEN_RESET ((uint32_t)0xCFFFFFFF) + +/* ADC JEXTEN mask */ +#define CR2_JEXTEN_RESET ((uint32_t)0xFFCFFFFF) + +/* ADC JEXTSEL mask */ +#define CR2_JEXTSEL_RESET ((uint32_t)0xFFF0FFFF) + +/* CR2 register Mask */ +#define CR2_CLEAR_MASK ((uint32_t)0xC0FFF7FD) + +/* ADC SQx mask */ +#define SQR3_SQ_SET ((uint32_t)0x0000001F) +#define SQR2_SQ_SET ((uint32_t)0x0000001F) +#define SQR1_SQ_SET ((uint32_t)0x0000001F) + +/* ADC L Mask */ +#define SQR1_L_RESET ((uint32_t)0xFF0FFFFF) + +/* ADC JSQx mask */ +#define JSQR_JSQ_SET ((uint32_t)0x0000001F) + +/* ADC JL mask */ +#define JSQR_JL_SET ((uint32_t)0x00300000) +#define JSQR_JL_RESET ((uint32_t)0xFFCFFFFF) + +/* ADC SMPx mask */ +#define SMPR1_SMP_SET ((uint32_t)0x00000007) +#define SMPR2_SMP_SET ((uint32_t)0x00000007) + +/* ADC JDRx registers offset */ +#define JDR_OFFSET ((uint8_t)0x28) + +/* ADC CDR register base address */ +#define CDR_ADDRESS ((uint32_t)0x40012308) + +/* ADC CCR register Mask */ +#define CR_CLEAR_MASK ((uint32_t)0xFFFC30E0) + +/* Private macro -------------------------------------------------------------*/ +/* Private variables ---------------------------------------------------------*/ +/* Private function prototypes -----------------------------------------------*/ +/* Private functions ---------------------------------------------------------*/ + +/** @defgroup ADC_Private_Functions + * @{ + */ + +/** @defgroup ADC_Group1 Initialization and Configuration functions + * @brief Initialization and Configuration functions + * +@verbatim + =============================================================================== + ##### Initialization and Configuration functions ##### + =============================================================================== + [..] This section provides functions allowing to: + (+) Initialize and configure the ADC Prescaler + (+) ADC Conversion Resolution (12bit..6bit) + (+) Scan Conversion Mode (multichannel or one channel) for regular group + (+) ADC Continuous Conversion Mode (Continuous or Single conversion) for + regular group + (+) External trigger Edge and source of regular group, + (+) Converted data alignment (left or right) + (+) The number of ADC conversions that will be done using the sequencer for + regular channel group + (+) Multi ADC mode selection + (+) Direct memory access mode selection for multi ADC mode + (+) Delay between 2 sampling phases (used in dual or triple interleaved modes) + (+) Enable or disable the ADC peripheral +@endverbatim + * @{ + */ + +/** + * @brief Deinitializes all ADCs peripherals registers to their default reset + * values. + * @param None + * @retval None + */ +void ADC_DeInit(void) +{ + /* Enable all ADCs reset state */ + RCC_APB2PeriphResetCmd(RCC_APB2Periph_ADC, ENABLE); + + /* Release all ADCs from reset state */ + RCC_APB2PeriphResetCmd(RCC_APB2Periph_ADC, DISABLE); +} + +/** + * @brief Initializes the ADCx peripheral according to the specified parameters + * in the ADC_InitStruct. + * @note This function is used to configure the global features of the ADC ( + * Resolution and Data Alignment), however, the rest of the configuration + * parameters are specific to the regular channels group (scan mode + * activation, continuous mode activation, External trigger source and + * edge, number of conversion in the regular channels group sequencer). + * @param ADCx: where x can be 1, 2 or 3 to select the ADC peripheral. + * @param ADC_InitStruct: pointer to an ADC_InitTypeDef structure that contains + * the configuration information for the specified ADC peripheral. + * @retval None + */ +void ADC_Init(ADC_TypeDef* ADCx, ADC_InitTypeDef* ADC_InitStruct) +{ + uint32_t tmpreg1 = 0; + uint8_t tmpreg2 = 0; + /* Check the parameters */ + assert_param(IS_ADC_ALL_PERIPH(ADCx)); + assert_param(IS_ADC_RESOLUTION(ADC_InitStruct->ADC_Resolution)); + assert_param(IS_FUNCTIONAL_STATE(ADC_InitStruct->ADC_ScanConvMode)); + assert_param(IS_FUNCTIONAL_STATE(ADC_InitStruct->ADC_ContinuousConvMode)); + assert_param(IS_ADC_EXT_TRIG_EDGE(ADC_InitStruct->ADC_ExternalTrigConvEdge)); + assert_param(IS_ADC_EXT_TRIG(ADC_InitStruct->ADC_ExternalTrigConv)); + assert_param(IS_ADC_DATA_ALIGN(ADC_InitStruct->ADC_DataAlign)); + assert_param(IS_ADC_REGULAR_LENGTH(ADC_InitStruct->ADC_NbrOfConversion)); + + /*---------------------------- ADCx CR1 Configuration -----------------*/ + /* Get the ADCx CR1 value */ + tmpreg1 = ADCx->CR1; + + /* Clear RES and SCAN bits */ + tmpreg1 &= CR1_CLEAR_MASK; + + /* Configure ADCx: scan conversion mode and resolution */ + /* Set SCAN bit according to ADC_ScanConvMode value */ + /* Set RES bit according to ADC_Resolution value */ + tmpreg1 |= (uint32_t)(((uint32_t)ADC_InitStruct->ADC_ScanConvMode << 8) | \ + ADC_InitStruct->ADC_Resolution); + /* Write to ADCx CR1 */ + ADCx->CR1 = tmpreg1; + /*---------------------------- ADCx CR2 Configuration -----------------*/ + /* Get the ADCx CR2 value */ + tmpreg1 = ADCx->CR2; + + /* Clear CONT, ALIGN, EXTEN and EXTSEL bits */ + tmpreg1 &= CR2_CLEAR_MASK; + + /* Configure ADCx: external trigger event and edge, data alignment and + continuous conversion mode */ + /* Set ALIGN bit according to ADC_DataAlign value */ + /* Set EXTEN bits according to ADC_ExternalTrigConvEdge value */ + /* Set EXTSEL bits according to ADC_ExternalTrigConv value */ + /* Set CONT bit according to ADC_ContinuousConvMode value */ + tmpreg1 |= (uint32_t)(ADC_InitStruct->ADC_DataAlign | \ + ADC_InitStruct->ADC_ExternalTrigConv | + ADC_InitStruct->ADC_ExternalTrigConvEdge | \ + ((uint32_t)ADC_InitStruct->ADC_ContinuousConvMode << 1)); + + /* Write to ADCx CR2 */ + ADCx->CR2 = tmpreg1; + /*---------------------------- ADCx SQR1 Configuration -----------------*/ + /* Get the ADCx SQR1 value */ + tmpreg1 = ADCx->SQR1; + + /* Clear L bits */ + tmpreg1 &= SQR1_L_RESET; + + /* Configure ADCx: regular channel sequence length */ + /* Set L bits according to ADC_NbrOfConversion value */ + tmpreg2 |= (uint8_t)(ADC_InitStruct->ADC_NbrOfConversion - (uint8_t)1); + tmpreg1 |= ((uint32_t)tmpreg2 << 20); + + /* Write to ADCx SQR1 */ + ADCx->SQR1 = tmpreg1; +} + +/** + * @brief Fills each ADC_InitStruct member with its default value. + * @note This function is used to initialize the global features of the ADC ( + * Resolution and Data Alignment), however, the rest of the configuration + * parameters are specific to the regular channels group (scan mode + * activation, continuous mode activation, External trigger source and + * edge, number of conversion in the regular channels group sequencer). + * @param ADC_InitStruct: pointer to an ADC_InitTypeDef structure which will + * be initialized. + * @retval None + */ +void ADC_StructInit(ADC_InitTypeDef* ADC_InitStruct) +{ + /* Initialize the ADC_Mode member */ + ADC_InitStruct->ADC_Resolution = ADC_Resolution_12b; + + /* initialize the ADC_ScanConvMode member */ + ADC_InitStruct->ADC_ScanConvMode = DISABLE; + + /* Initialize the ADC_ContinuousConvMode member */ + ADC_InitStruct->ADC_ContinuousConvMode = DISABLE; + + /* Initialize the ADC_ExternalTrigConvEdge member */ + ADC_InitStruct->ADC_ExternalTrigConvEdge = ADC_ExternalTrigConvEdge_None; + + /* Initialize the ADC_ExternalTrigConv member */ + ADC_InitStruct->ADC_ExternalTrigConv = ADC_ExternalTrigConv_T1_CC1; + + /* Initialize the ADC_DataAlign member */ + ADC_InitStruct->ADC_DataAlign = ADC_DataAlign_Right; + + /* Initialize the ADC_NbrOfConversion member */ + ADC_InitStruct->ADC_NbrOfConversion = 1; +} + +/** + * @brief Initializes the ADCs peripherals according to the specified parameters + * in the ADC_CommonInitStruct. + * @param ADC_CommonInitStruct: pointer to an ADC_CommonInitTypeDef structure + * that contains the configuration information for All ADCs peripherals. + * @retval None + */ +void ADC_CommonInit(ADC_CommonInitTypeDef* ADC_CommonInitStruct) +{ + uint32_t tmpreg1 = 0; + /* Check the parameters */ + assert_param(IS_ADC_MODE(ADC_CommonInitStruct->ADC_Mode)); + assert_param(IS_ADC_PRESCALER(ADC_CommonInitStruct->ADC_Prescaler)); + assert_param(IS_ADC_DMA_ACCESS_MODE(ADC_CommonInitStruct->ADC_DMAAccessMode)); + assert_param(IS_ADC_SAMPLING_DELAY(ADC_CommonInitStruct->ADC_TwoSamplingDelay)); + /*---------------------------- ADC CCR Configuration -----------------*/ + /* Get the ADC CCR value */ + tmpreg1 = ADC->CCR; + + /* Clear MULTI, DELAY, DMA and ADCPRE bits */ + tmpreg1 &= CR_CLEAR_MASK; + + /* Configure ADCx: Multi mode, Delay between two sampling time, ADC prescaler, + and DMA access mode for multimode */ + /* Set MULTI bits according to ADC_Mode value */ + /* Set ADCPRE bits according to ADC_Prescaler value */ + /* Set DMA bits according to ADC_DMAAccessMode value */ + /* Set DELAY bits according to ADC_TwoSamplingDelay value */ + tmpreg1 |= (uint32_t)(ADC_CommonInitStruct->ADC_Mode | + ADC_CommonInitStruct->ADC_Prescaler | + ADC_CommonInitStruct->ADC_DMAAccessMode | + ADC_CommonInitStruct->ADC_TwoSamplingDelay); + + /* Write to ADC CCR */ + ADC->CCR = tmpreg1; +} + +/** + * @brief Fills each ADC_CommonInitStruct member with its default value. + * @param ADC_CommonInitStruct: pointer to an ADC_CommonInitTypeDef structure + * which will be initialized. + * @retval None + */ +void ADC_CommonStructInit(ADC_CommonInitTypeDef* ADC_CommonInitStruct) +{ + /* Initialize the ADC_Mode member */ + ADC_CommonInitStruct->ADC_Mode = ADC_Mode_Independent; + + /* initialize the ADC_Prescaler member */ + ADC_CommonInitStruct->ADC_Prescaler = ADC_Prescaler_Div2; + + /* Initialize the ADC_DMAAccessMode member */ + ADC_CommonInitStruct->ADC_DMAAccessMode = ADC_DMAAccessMode_Disabled; + + /* Initialize the ADC_TwoSamplingDelay member */ + ADC_CommonInitStruct->ADC_TwoSamplingDelay = ADC_TwoSamplingDelay_5Cycles; +} + +/** + * @brief Enables or disables the specified ADC peripheral. + * @param ADCx: where x can be 1, 2 or 3 to select the ADC peripheral. + * @param NewState: new state of the ADCx peripheral. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void ADC_Cmd(ADC_TypeDef* ADCx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_ADC_ALL_PERIPH(ADCx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + if (NewState != DISABLE) + { + /* Set the ADON bit to wake up the ADC from power down mode */ + ADCx->CR2 |= (uint32_t)ADC_CR2_ADON; + } + else + { + /* Disable the selected ADC peripheral */ + ADCx->CR2 &= (uint32_t)(~ADC_CR2_ADON); + } +} +/** + * @} + */ + +/** @defgroup ADC_Group2 Analog Watchdog configuration functions + * @brief Analog Watchdog configuration functions + * +@verbatim + =============================================================================== + ##### Analog Watchdog configuration functions ##### + =============================================================================== + [..] This section provides functions allowing to configure the Analog Watchdog + (AWD) feature in the ADC. + + [..] A typical configuration Analog Watchdog is done following these steps : + (#) the ADC guarded channel(s) is (are) selected using the + ADC_AnalogWatchdogSingleChannelConfig() function. + (#) The Analog watchdog lower and higher threshold are configured using the + ADC_AnalogWatchdogThresholdsConfig() function. + (#) The Analog watchdog is enabled and configured to enable the check, on one + or more channels, using the ADC_AnalogWatchdogCmd() function. +@endverbatim + * @{ + */ + +/** + * @brief Enables or disables the analog watchdog on single/all regular or + * injected channels + * @param ADCx: where x can be 1, 2 or 3 to select the ADC peripheral. + * @param ADC_AnalogWatchdog: the ADC analog watchdog configuration. + * This parameter can be one of the following values: + * @arg ADC_AnalogWatchdog_SingleRegEnable: Analog watchdog on a single regular channel + * @arg ADC_AnalogWatchdog_SingleInjecEnable: Analog watchdog on a single injected channel + * @arg ADC_AnalogWatchdog_SingleRegOrInjecEnable: Analog watchdog on a single regular or injected channel + * @arg ADC_AnalogWatchdog_AllRegEnable: Analog watchdog on all regular channel + * @arg ADC_AnalogWatchdog_AllInjecEnable: Analog watchdog on all injected channel + * @arg ADC_AnalogWatchdog_AllRegAllInjecEnable: Analog watchdog on all regular and injected channels + * @arg ADC_AnalogWatchdog_None: No channel guarded by the analog watchdog + * @retval None + */ +void ADC_AnalogWatchdogCmd(ADC_TypeDef* ADCx, uint32_t ADC_AnalogWatchdog) +{ + uint32_t tmpreg = 0; + /* Check the parameters */ + assert_param(IS_ADC_ALL_PERIPH(ADCx)); + assert_param(IS_ADC_ANALOG_WATCHDOG(ADC_AnalogWatchdog)); + + /* Get the old register value */ + tmpreg = ADCx->CR1; + + /* Clear AWDEN, JAWDEN and AWDSGL bits */ + tmpreg &= CR1_AWDMode_RESET; + + /* Set the analog watchdog enable mode */ + tmpreg |= ADC_AnalogWatchdog; + + /* Store the new register value */ + ADCx->CR1 = tmpreg; +} + +/** + * @brief Configures the high and low thresholds of the analog watchdog. + * @param ADCx: where x can be 1, 2 or 3 to select the ADC peripheral. + * @param HighThreshold: the ADC analog watchdog High threshold value. + * This parameter must be a 12-bit value. + * @param LowThreshold: the ADC analog watchdog Low threshold value. + * This parameter must be a 12-bit value. + * @retval None + */ +void ADC_AnalogWatchdogThresholdsConfig(ADC_TypeDef* ADCx, uint16_t HighThreshold, + uint16_t LowThreshold) +{ + /* Check the parameters */ + assert_param(IS_ADC_ALL_PERIPH(ADCx)); + assert_param(IS_ADC_THRESHOLD(HighThreshold)); + assert_param(IS_ADC_THRESHOLD(LowThreshold)); + + /* Set the ADCx high threshold */ + ADCx->HTR = HighThreshold; + + /* Set the ADCx low threshold */ + ADCx->LTR = LowThreshold; +} + +/** + * @brief Configures the analog watchdog guarded single channel + * @param ADCx: where x can be 1, 2 or 3 to select the ADC peripheral. + * @param ADC_Channel: the ADC channel to configure for the analog watchdog. + * This parameter can be one of the following values: + * @arg ADC_Channel_0: ADC Channel0 selected + * @arg ADC_Channel_1: ADC Channel1 selected + * @arg ADC_Channel_2: ADC Channel2 selected + * @arg ADC_Channel_3: ADC Channel3 selected + * @arg ADC_Channel_4: ADC Channel4 selected + * @arg ADC_Channel_5: ADC Channel5 selected + * @arg ADC_Channel_6: ADC Channel6 selected + * @arg ADC_Channel_7: ADC Channel7 selected + * @arg ADC_Channel_8: ADC Channel8 selected + * @arg ADC_Channel_9: ADC Channel9 selected + * @arg ADC_Channel_10: ADC Channel10 selected + * @arg ADC_Channel_11: ADC Channel11 selected + * @arg ADC_Channel_12: ADC Channel12 selected + * @arg ADC_Channel_13: ADC Channel13 selected + * @arg ADC_Channel_14: ADC Channel14 selected + * @arg ADC_Channel_15: ADC Channel15 selected + * @arg ADC_Channel_16: ADC Channel16 selected + * @arg ADC_Channel_17: ADC Channel17 selected + * @arg ADC_Channel_18: ADC Channel18 selected + * @retval None + */ +void ADC_AnalogWatchdogSingleChannelConfig(ADC_TypeDef* ADCx, uint8_t ADC_Channel) +{ + uint32_t tmpreg = 0; + /* Check the parameters */ + assert_param(IS_ADC_ALL_PERIPH(ADCx)); + assert_param(IS_ADC_CHANNEL(ADC_Channel)); + + /* Get the old register value */ + tmpreg = ADCx->CR1; + + /* Clear the Analog watchdog channel select bits */ + tmpreg &= CR1_AWDCH_RESET; + + /* Set the Analog watchdog channel */ + tmpreg |= ADC_Channel; + + /* Store the new register value */ + ADCx->CR1 = tmpreg; +} +/** + * @} + */ + +/** @defgroup ADC_Group3 Temperature Sensor, Vrefint (Voltage Reference internal) + * and VBAT (Voltage BATtery) management functions + * @brief Temperature Sensor, Vrefint and VBAT management functions + * +@verbatim + =============================================================================== + ##### Temperature Sensor, Vrefint and VBAT management functions ##### + =============================================================================== + [..] This section provides functions allowing to enable/ disable the internal + connections between the ADC and the Temperature Sensor, the Vrefint and + the Vbat sources. + + [..] A typical configuration to get the Temperature sensor and Vrefint channels + voltages is done following these steps : + (#) Enable the internal connection of Temperature sensor and Vrefint sources + with the ADC channels using ADC_TempSensorVrefintCmd() function. + (#) Select the ADC_Channel_TempSensor and/or ADC_Channel_Vrefint using + ADC_RegularChannelConfig() or ADC_InjectedChannelConfig() functions + (#) Get the voltage values, using ADC_GetConversionValue() or + ADC_GetInjectedConversionValue(). + + [..] A typical configuration to get the VBAT channel voltage is done following + these steps : + (#) Enable the internal connection of VBAT source with the ADC channel using + ADC_VBATCmd() function. + (#) Select the ADC_Channel_Vbat using ADC_RegularChannelConfig() or + ADC_InjectedChannelConfig() functions + (#) Get the voltage value, using ADC_GetConversionValue() or + ADC_GetInjectedConversionValue(). + +@endverbatim + * @{ + */ + + +/** + * @brief Enables or disables the temperature sensor and Vrefint channels. + * @param NewState: new state of the temperature sensor and Vrefint channels. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void ADC_TempSensorVrefintCmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + if (NewState != DISABLE) + { + /* Enable the temperature sensor and Vrefint channel*/ + ADC->CCR |= (uint32_t)ADC_CCR_TSVREFE; + } + else + { + /* Disable the temperature sensor and Vrefint channel*/ + ADC->CCR &= (uint32_t)(~ADC_CCR_TSVREFE); + } +} + +/** + * @brief Enables or disables the VBAT (Voltage Battery) channel. + * + * @note the Battery voltage measured is equal to VBAT/2 on STM32F40xx and + * STM32F41xx devices and equal to VBAT/4 on STM32F42xx and STM32F43xx devices + * + * @param NewState: new state of the VBAT channel. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void ADC_VBATCmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + if (NewState != DISABLE) + { + /* Enable the VBAT channel*/ + ADC->CCR |= (uint32_t)ADC_CCR_VBATE; + } + else + { + /* Disable the VBAT channel*/ + ADC->CCR &= (uint32_t)(~ADC_CCR_VBATE); + } +} + +/** + * @} + */ + +/** @defgroup ADC_Group4 Regular Channels Configuration functions + * @brief Regular Channels Configuration functions + * +@verbatim + =============================================================================== + ##### Regular Channels Configuration functions ##### + =============================================================================== + + [..] This section provides functions allowing to manage the ADC's regular channels, + it is composed of 2 sub sections : + + (#) Configuration and management functions for regular channels: This subsection + provides functions allowing to configure the ADC regular channels : + (++) Configure the rank in the regular group sequencer for each channel + (++) Configure the sampling time for each channel + (++) select the conversion Trigger for regular channels + (++) select the desired EOC event behavior configuration + (++) Activate the continuous Mode (*) + (++) Activate the Discontinuous Mode + -@@- Please Note that the following features for regular channels + are configurated using the ADC_Init() function : + (+@@) scan mode activation + (+@@) continuous mode activation (**) + (+@@) External trigger source + (+@@) External trigger edge + (+@@) number of conversion in the regular channels group sequencer. + + -@@- (*) and (**) are performing the same configuration + + (#) Get the conversion data: This subsection provides an important function in + the ADC peripheral since it returns the converted data of the current + regular channel. When the Conversion value is read, the EOC Flag is + automatically cleared. + + -@- For multi ADC mode, the last ADC1, ADC2 and ADC3 regular conversions + results data (in the selected multi mode) can be returned in the same + time using ADC_GetMultiModeConversionValue() function. + +@endverbatim + * @{ + */ +/** + * @brief Configures for the selected ADC regular channel its corresponding + * rank in the sequencer and its sample time. + * @param ADCx: where x can be 1, 2 or 3 to select the ADC peripheral. + * @param ADC_Channel: the ADC channel to configure. + * This parameter can be one of the following values: + * @arg ADC_Channel_0: ADC Channel0 selected + * @arg ADC_Channel_1: ADC Channel1 selected + * @arg ADC_Channel_2: ADC Channel2 selected + * @arg ADC_Channel_3: ADC Channel3 selected + * @arg ADC_Channel_4: ADC Channel4 selected + * @arg ADC_Channel_5: ADC Channel5 selected + * @arg ADC_Channel_6: ADC Channel6 selected + * @arg ADC_Channel_7: ADC Channel7 selected + * @arg ADC_Channel_8: ADC Channel8 selected + * @arg ADC_Channel_9: ADC Channel9 selected + * @arg ADC_Channel_10: ADC Channel10 selected + * @arg ADC_Channel_11: ADC Channel11 selected + * @arg ADC_Channel_12: ADC Channel12 selected + * @arg ADC_Channel_13: ADC Channel13 selected + * @arg ADC_Channel_14: ADC Channel14 selected + * @arg ADC_Channel_15: ADC Channel15 selected + * @arg ADC_Channel_16: ADC Channel16 selected + * @arg ADC_Channel_17: ADC Channel17 selected + * @arg ADC_Channel_18: ADC Channel18 selected + * @param Rank: The rank in the regular group sequencer. + * This parameter must be between 1 to 16. + * @param ADC_SampleTime: The sample time value to be set for the selected channel. + * This parameter can be one of the following values: + * @arg ADC_SampleTime_3Cycles: Sample time equal to 3 cycles + * @arg ADC_SampleTime_15Cycles: Sample time equal to 15 cycles + * @arg ADC_SampleTime_28Cycles: Sample time equal to 28 cycles + * @arg ADC_SampleTime_56Cycles: Sample time equal to 56 cycles + * @arg ADC_SampleTime_84Cycles: Sample time equal to 84 cycles + * @arg ADC_SampleTime_112Cycles: Sample time equal to 112 cycles + * @arg ADC_SampleTime_144Cycles: Sample time equal to 144 cycles + * @arg ADC_SampleTime_480Cycles: Sample time equal to 480 cycles + * @retval None + */ +void ADC_RegularChannelConfig(ADC_TypeDef* ADCx, uint8_t ADC_Channel, uint8_t Rank, uint8_t ADC_SampleTime) +{ + uint32_t tmpreg1 = 0, tmpreg2 = 0; + /* Check the parameters */ + assert_param(IS_ADC_ALL_PERIPH(ADCx)); + assert_param(IS_ADC_CHANNEL(ADC_Channel)); + assert_param(IS_ADC_REGULAR_RANK(Rank)); + assert_param(IS_ADC_SAMPLE_TIME(ADC_SampleTime)); + + /* if ADC_Channel_10 ... ADC_Channel_18 is selected */ + if (ADC_Channel > ADC_Channel_9) + { + /* Get the old register value */ + tmpreg1 = ADCx->SMPR1; + + /* Calculate the mask to clear */ + tmpreg2 = SMPR1_SMP_SET << (3 * (ADC_Channel - 10)); + + /* Clear the old sample time */ + tmpreg1 &= ~tmpreg2; + + /* Calculate the mask to set */ + tmpreg2 = (uint32_t)ADC_SampleTime << (3 * (ADC_Channel - 10)); + + /* Set the new sample time */ + tmpreg1 |= tmpreg2; + + /* Store the new register value */ + ADCx->SMPR1 = tmpreg1; + } + else /* ADC_Channel include in ADC_Channel_[0..9] */ + { + /* Get the old register value */ + tmpreg1 = ADCx->SMPR2; + + /* Calculate the mask to clear */ + tmpreg2 = SMPR2_SMP_SET << (3 * ADC_Channel); + + /* Clear the old sample time */ + tmpreg1 &= ~tmpreg2; + + /* Calculate the mask to set */ + tmpreg2 = (uint32_t)ADC_SampleTime << (3 * ADC_Channel); + + /* Set the new sample time */ + tmpreg1 |= tmpreg2; + + /* Store the new register value */ + ADCx->SMPR2 = tmpreg1; + } + /* For Rank 1 to 6 */ + if (Rank < 7) + { + /* Get the old register value */ + tmpreg1 = ADCx->SQR3; + + /* Calculate the mask to clear */ + tmpreg2 = SQR3_SQ_SET << (5 * (Rank - 1)); + + /* Clear the old SQx bits for the selected rank */ + tmpreg1 &= ~tmpreg2; + + /* Calculate the mask to set */ + tmpreg2 = (uint32_t)ADC_Channel << (5 * (Rank - 1)); + + /* Set the SQx bits for the selected rank */ + tmpreg1 |= tmpreg2; + + /* Store the new register value */ + ADCx->SQR3 = tmpreg1; + } + /* For Rank 7 to 12 */ + else if (Rank < 13) + { + /* Get the old register value */ + tmpreg1 = ADCx->SQR2; + + /* Calculate the mask to clear */ + tmpreg2 = SQR2_SQ_SET << (5 * (Rank - 7)); + + /* Clear the old SQx bits for the selected rank */ + tmpreg1 &= ~tmpreg2; + + /* Calculate the mask to set */ + tmpreg2 = (uint32_t)ADC_Channel << (5 * (Rank - 7)); + + /* Set the SQx bits for the selected rank */ + tmpreg1 |= tmpreg2; + + /* Store the new register value */ + ADCx->SQR2 = tmpreg1; + } + /* For Rank 13 to 16 */ + else + { + /* Get the old register value */ + tmpreg1 = ADCx->SQR1; + + /* Calculate the mask to clear */ + tmpreg2 = SQR1_SQ_SET << (5 * (Rank - 13)); + + /* Clear the old SQx bits for the selected rank */ + tmpreg1 &= ~tmpreg2; + + /* Calculate the mask to set */ + tmpreg2 = (uint32_t)ADC_Channel << (5 * (Rank - 13)); + + /* Set the SQx bits for the selected rank */ + tmpreg1 |= tmpreg2; + + /* Store the new register value */ + ADCx->SQR1 = tmpreg1; + } +} + +/** + * @brief Enables the selected ADC software start conversion of the regular channels. + * @param ADCx: where x can be 1, 2 or 3 to select the ADC peripheral. + * @retval None + */ +void ADC_SoftwareStartConv(ADC_TypeDef* ADCx) +{ + /* Check the parameters */ + assert_param(IS_ADC_ALL_PERIPH(ADCx)); + + /* Enable the selected ADC conversion for regular group */ + ADCx->CR2 |= (uint32_t)ADC_CR2_SWSTART; +} + +/** + * @brief Gets the selected ADC Software start regular conversion Status. + * @param ADCx: where x can be 1, 2 or 3 to select the ADC peripheral. + * @retval The new state of ADC software start conversion (SET or RESET). + */ +FlagStatus ADC_GetSoftwareStartConvStatus(ADC_TypeDef* ADCx) +{ + FlagStatus bitstatus = RESET; + /* Check the parameters */ + assert_param(IS_ADC_ALL_PERIPH(ADCx)); + + /* Check the status of SWSTART bit */ + if ((ADCx->CR2 & ADC_CR2_SWSTART) != (uint32_t)RESET) + { + /* SWSTART bit is set */ + bitstatus = SET; + } + else + { + /* SWSTART bit is reset */ + bitstatus = RESET; + } + + /* Return the SWSTART bit status */ + return bitstatus; +} + + +/** + * @brief Enables or disables the EOC on each regular channel conversion + * @param ADCx: where x can be 1, 2 or 3 to select the ADC peripheral. + * @param NewState: new state of the selected ADC EOC flag rising + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void ADC_EOCOnEachRegularChannelCmd(ADC_TypeDef* ADCx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_ADC_ALL_PERIPH(ADCx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the selected ADC EOC rising on each regular channel conversion */ + ADCx->CR2 |= (uint32_t)ADC_CR2_EOCS; + } + else + { + /* Disable the selected ADC EOC rising on each regular channel conversion */ + ADCx->CR2 &= (uint32_t)(~ADC_CR2_EOCS); + } +} + +/** + * @brief Enables or disables the ADC continuous conversion mode + * @param ADCx: where x can be 1, 2 or 3 to select the ADC peripheral. + * @param NewState: new state of the selected ADC continuous conversion mode + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void ADC_ContinuousModeCmd(ADC_TypeDef* ADCx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_ADC_ALL_PERIPH(ADCx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the selected ADC continuous conversion mode */ + ADCx->CR2 |= (uint32_t)ADC_CR2_CONT; + } + else + { + /* Disable the selected ADC continuous conversion mode */ + ADCx->CR2 &= (uint32_t)(~ADC_CR2_CONT); + } +} + +/** + * @brief Configures the discontinuous mode for the selected ADC regular group + * channel. + * @param ADCx: where x can be 1, 2 or 3 to select the ADC peripheral. + * @param Number: specifies the discontinuous mode regular channel count value. + * This number must be between 1 and 8. + * @retval None + */ +void ADC_DiscModeChannelCountConfig(ADC_TypeDef* ADCx, uint8_t Number) +{ + uint32_t tmpreg1 = 0; + uint32_t tmpreg2 = 0; + + /* Check the parameters */ + assert_param(IS_ADC_ALL_PERIPH(ADCx)); + assert_param(IS_ADC_REGULAR_DISC_NUMBER(Number)); + + /* Get the old register value */ + tmpreg1 = ADCx->CR1; + + /* Clear the old discontinuous mode channel count */ + tmpreg1 &= CR1_DISCNUM_RESET; + + /* Set the discontinuous mode channel count */ + tmpreg2 = Number - 1; + tmpreg1 |= tmpreg2 << 13; + + /* Store the new register value */ + ADCx->CR1 = tmpreg1; +} + +/** + * @brief Enables or disables the discontinuous mode on regular group channel + * for the specified ADC + * @param ADCx: where x can be 1, 2 or 3 to select the ADC peripheral. + * @param NewState: new state of the selected ADC discontinuous mode on + * regular group channel. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void ADC_DiscModeCmd(ADC_TypeDef* ADCx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_ADC_ALL_PERIPH(ADCx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the selected ADC regular discontinuous mode */ + ADCx->CR1 |= (uint32_t)ADC_CR1_DISCEN; + } + else + { + /* Disable the selected ADC regular discontinuous mode */ + ADCx->CR1 &= (uint32_t)(~ADC_CR1_DISCEN); + } +} + +/** + * @brief Returns the last ADCx conversion result data for regular channel. + * @param ADCx: where x can be 1, 2 or 3 to select the ADC peripheral. + * @retval The Data conversion value. + */ +uint16_t ADC_GetConversionValue(ADC_TypeDef* ADCx) +{ + /* Check the parameters */ + assert_param(IS_ADC_ALL_PERIPH(ADCx)); + + /* Return the selected ADC conversion value */ + return (uint16_t) ADCx->DR; +} + +/** + * @brief Returns the last ADC1, ADC2 and ADC3 regular conversions results + * data in the selected multi mode. + * @param None + * @retval The Data conversion value. + * @note In dual mode, the value returned by this function is as following + * Data[15:0] : these bits contain the regular data of ADC1. + * Data[31:16]: these bits contain the regular data of ADC2. + * @note In triple mode, the value returned by this function is as following + * Data[15:0] : these bits contain alternatively the regular data of ADC1, ADC3 and ADC2. + * Data[31:16]: these bits contain alternatively the regular data of ADC2, ADC1 and ADC3. + */ +uint32_t ADC_GetMultiModeConversionValue(void) +{ + /* Return the multi mode conversion value */ + return (*(__IO uint32_t *) CDR_ADDRESS); +} +/** + * @} + */ + +/** @defgroup ADC_Group5 Regular Channels DMA Configuration functions + * @brief Regular Channels DMA Configuration functions + * +@verbatim + =============================================================================== + ##### Regular Channels DMA Configuration functions ##### + =============================================================================== + [..] This section provides functions allowing to configure the DMA for ADC + regular channels. + Since converted regular channel values are stored into a unique data + register, it is useful to use DMA for conversion of more than one regular + channel. This avoids the loss of the data already stored in the ADC + Data register. + When the DMA mode is enabled (using the ADC_DMACmd() function), after each + conversion of a regular channel, a DMA request is generated. + [..] Depending on the "DMA disable selection for Independent ADC mode" + configuration (using the ADC_DMARequestAfterLastTransferCmd() function), + at the end of the last DMA transfer, two possibilities are allowed: + (+) No new DMA request is issued to the DMA controller (feature DISABLED) + (+) Requests can continue to be generated (feature ENABLED). + [..] Depending on the "DMA disable selection for multi ADC mode" configuration + (using the void ADC_MultiModeDMARequestAfterLastTransferCmd() function), + at the end of the last DMA transfer, two possibilities are allowed: + (+) No new DMA request is issued to the DMA controller (feature DISABLED) + (+) Requests can continue to be generated (feature ENABLED). + +@endverbatim + * @{ + */ + + /** + * @brief Enables or disables the specified ADC DMA request. + * @param ADCx: where x can be 1, 2 or 3 to select the ADC peripheral. + * @param NewState: new state of the selected ADC DMA transfer. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void ADC_DMACmd(ADC_TypeDef* ADCx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_ADC_ALL_PERIPH(ADCx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + if (NewState != DISABLE) + { + /* Enable the selected ADC DMA request */ + ADCx->CR2 |= (uint32_t)ADC_CR2_DMA; + } + else + { + /* Disable the selected ADC DMA request */ + ADCx->CR2 &= (uint32_t)(~ADC_CR2_DMA); + } +} + +/** + * @brief Enables or disables the ADC DMA request after last transfer (Single-ADC mode) + * @param ADCx: where x can be 1, 2 or 3 to select the ADC peripheral. + * @param NewState: new state of the selected ADC DMA request after last transfer. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void ADC_DMARequestAfterLastTransferCmd(ADC_TypeDef* ADCx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_ADC_ALL_PERIPH(ADCx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + if (NewState != DISABLE) + { + /* Enable the selected ADC DMA request after last transfer */ + ADCx->CR2 |= (uint32_t)ADC_CR2_DDS; + } + else + { + /* Disable the selected ADC DMA request after last transfer */ + ADCx->CR2 &= (uint32_t)(~ADC_CR2_DDS); + } +} + +/** + * @brief Enables or disables the ADC DMA request after last transfer in multi ADC mode + * @param NewState: new state of the selected ADC DMA request after last transfer. + * This parameter can be: ENABLE or DISABLE. + * @note if Enabled, DMA requests are issued as long as data are converted and + * DMA mode for multi ADC mode (selected using ADC_CommonInit() function + * by ADC_CommonInitStruct.ADC_DMAAccessMode structure member) is + * ADC_DMAAccessMode_1, ADC_DMAAccessMode_2 or ADC_DMAAccessMode_3. + * @retval None + */ +void ADC_MultiModeDMARequestAfterLastTransferCmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + if (NewState != DISABLE) + { + /* Enable the selected ADC DMA request after last transfer */ + ADC->CCR |= (uint32_t)ADC_CCR_DDS; + } + else + { + /* Disable the selected ADC DMA request after last transfer */ + ADC->CCR &= (uint32_t)(~ADC_CCR_DDS); + } +} +/** + * @} + */ + +/** @defgroup ADC_Group6 Injected channels Configuration functions + * @brief Injected channels Configuration functions + * +@verbatim + =============================================================================== + ##### Injected channels Configuration functions ##### + =============================================================================== + + [..] This section provide functions allowing to configure the ADC Injected channels, + it is composed of 2 sub sections : + + (#) Configuration functions for Injected channels: This subsection provides + functions allowing to configure the ADC injected channels : + (++) Configure the rank in the injected group sequencer for each channel + (++) Configure the sampling time for each channel + (++) Activate the Auto injected Mode + (++) Activate the Discontinuous Mode + (++) scan mode activation + (++) External/software trigger source + (++) External trigger edge + (++) injected channels sequencer. + + (#) Get the Specified Injected channel conversion data: This subsection + provides an important function in the ADC peripheral since it returns the + converted data of the specific injected channel. + +@endverbatim + * @{ + */ +/** + * @brief Configures for the selected ADC injected channel its corresponding + * rank in the sequencer and its sample time. + * @param ADCx: where x can be 1, 2 or 3 to select the ADC peripheral. + * @param ADC_Channel: the ADC channel to configure. + * This parameter can be one of the following values: + * @arg ADC_Channel_0: ADC Channel0 selected + * @arg ADC_Channel_1: ADC Channel1 selected + * @arg ADC_Channel_2: ADC Channel2 selected + * @arg ADC_Channel_3: ADC Channel3 selected + * @arg ADC_Channel_4: ADC Channel4 selected + * @arg ADC_Channel_5: ADC Channel5 selected + * @arg ADC_Channel_6: ADC Channel6 selected + * @arg ADC_Channel_7: ADC Channel7 selected + * @arg ADC_Channel_8: ADC Channel8 selected + * @arg ADC_Channel_9: ADC Channel9 selected + * @arg ADC_Channel_10: ADC Channel10 selected + * @arg ADC_Channel_11: ADC Channel11 selected + * @arg ADC_Channel_12: ADC Channel12 selected + * @arg ADC_Channel_13: ADC Channel13 selected + * @arg ADC_Channel_14: ADC Channel14 selected + * @arg ADC_Channel_15: ADC Channel15 selected + * @arg ADC_Channel_16: ADC Channel16 selected + * @arg ADC_Channel_17: ADC Channel17 selected + * @arg ADC_Channel_18: ADC Channel18 selected + * @param Rank: The rank in the injected group sequencer. + * This parameter must be between 1 to 4. + * @param ADC_SampleTime: The sample time value to be set for the selected channel. + * This parameter can be one of the following values: + * @arg ADC_SampleTime_3Cycles: Sample time equal to 3 cycles + * @arg ADC_SampleTime_15Cycles: Sample time equal to 15 cycles + * @arg ADC_SampleTime_28Cycles: Sample time equal to 28 cycles + * @arg ADC_SampleTime_56Cycles: Sample time equal to 56 cycles + * @arg ADC_SampleTime_84Cycles: Sample time equal to 84 cycles + * @arg ADC_SampleTime_112Cycles: Sample time equal to 112 cycles + * @arg ADC_SampleTime_144Cycles: Sample time equal to 144 cycles + * @arg ADC_SampleTime_480Cycles: Sample time equal to 480 cycles + * @retval None + */ +void ADC_InjectedChannelConfig(ADC_TypeDef* ADCx, uint8_t ADC_Channel, uint8_t Rank, uint8_t ADC_SampleTime) +{ + uint32_t tmpreg1 = 0, tmpreg2 = 0, tmpreg3 = 0; + /* Check the parameters */ + assert_param(IS_ADC_ALL_PERIPH(ADCx)); + assert_param(IS_ADC_CHANNEL(ADC_Channel)); + assert_param(IS_ADC_INJECTED_RANK(Rank)); + assert_param(IS_ADC_SAMPLE_TIME(ADC_SampleTime)); + /* if ADC_Channel_10 ... ADC_Channel_18 is selected */ + if (ADC_Channel > ADC_Channel_9) + { + /* Get the old register value */ + tmpreg1 = ADCx->SMPR1; + /* Calculate the mask to clear */ + tmpreg2 = SMPR1_SMP_SET << (3*(ADC_Channel - 10)); + /* Clear the old sample time */ + tmpreg1 &= ~tmpreg2; + /* Calculate the mask to set */ + tmpreg2 = (uint32_t)ADC_SampleTime << (3*(ADC_Channel - 10)); + /* Set the new sample time */ + tmpreg1 |= tmpreg2; + /* Store the new register value */ + ADCx->SMPR1 = tmpreg1; + } + else /* ADC_Channel include in ADC_Channel_[0..9] */ + { + /* Get the old register value */ + tmpreg1 = ADCx->SMPR2; + /* Calculate the mask to clear */ + tmpreg2 = SMPR2_SMP_SET << (3 * ADC_Channel); + /* Clear the old sample time */ + tmpreg1 &= ~tmpreg2; + /* Calculate the mask to set */ + tmpreg2 = (uint32_t)ADC_SampleTime << (3 * ADC_Channel); + /* Set the new sample time */ + tmpreg1 |= tmpreg2; + /* Store the new register value */ + ADCx->SMPR2 = tmpreg1; + } + /* Rank configuration */ + /* Get the old register value */ + tmpreg1 = ADCx->JSQR; + /* Get JL value: Number = JL+1 */ + tmpreg3 = (tmpreg1 & JSQR_JL_SET)>> 20; + /* Calculate the mask to clear: ((Rank-1)+(4-JL-1)) */ + tmpreg2 = JSQR_JSQ_SET << (5 * (uint8_t)((Rank + 3) - (tmpreg3 + 1))); + /* Clear the old JSQx bits for the selected rank */ + tmpreg1 &= ~tmpreg2; + /* Calculate the mask to set: ((Rank-1)+(4-JL-1)) */ + tmpreg2 = (uint32_t)ADC_Channel << (5 * (uint8_t)((Rank + 3) - (tmpreg3 + 1))); + /* Set the JSQx bits for the selected rank */ + tmpreg1 |= tmpreg2; + /* Store the new register value */ + ADCx->JSQR = tmpreg1; +} + +/** + * @brief Configures the sequencer length for injected channels + * @param ADCx: where x can be 1, 2 or 3 to select the ADC peripheral. + * @param Length: The sequencer length. + * This parameter must be a number between 1 to 4. + * @retval None + */ +void ADC_InjectedSequencerLengthConfig(ADC_TypeDef* ADCx, uint8_t Length) +{ + uint32_t tmpreg1 = 0; + uint32_t tmpreg2 = 0; + /* Check the parameters */ + assert_param(IS_ADC_ALL_PERIPH(ADCx)); + assert_param(IS_ADC_INJECTED_LENGTH(Length)); + + /* Get the old register value */ + tmpreg1 = ADCx->JSQR; + + /* Clear the old injected sequence length JL bits */ + tmpreg1 &= JSQR_JL_RESET; + + /* Set the injected sequence length JL bits */ + tmpreg2 = Length - 1; + tmpreg1 |= tmpreg2 << 20; + + /* Store the new register value */ + ADCx->JSQR = tmpreg1; +} + +/** + * @brief Set the injected channels conversion value offset + * @param ADCx: where x can be 1, 2 or 3 to select the ADC peripheral. + * @param ADC_InjectedChannel: the ADC injected channel to set its offset. + * This parameter can be one of the following values: + * @arg ADC_InjectedChannel_1: Injected Channel1 selected + * @arg ADC_InjectedChannel_2: Injected Channel2 selected + * @arg ADC_InjectedChannel_3: Injected Channel3 selected + * @arg ADC_InjectedChannel_4: Injected Channel4 selected + * @param Offset: the offset value for the selected ADC injected channel + * This parameter must be a 12bit value. + * @retval None + */ +void ADC_SetInjectedOffset(ADC_TypeDef* ADCx, uint8_t ADC_InjectedChannel, uint16_t Offset) +{ + __IO uint32_t tmp = 0; + /* Check the parameters */ + assert_param(IS_ADC_ALL_PERIPH(ADCx)); + assert_param(IS_ADC_INJECTED_CHANNEL(ADC_InjectedChannel)); + assert_param(IS_ADC_OFFSET(Offset)); + + tmp = (uint32_t)ADCx; + tmp += ADC_InjectedChannel; + + /* Set the selected injected channel data offset */ + *(__IO uint32_t *) tmp = (uint32_t)Offset; +} + + /** + * @brief Configures the ADCx external trigger for injected channels conversion. + * @param ADCx: where x can be 1, 2 or 3 to select the ADC peripheral. + * @param ADC_ExternalTrigInjecConv: specifies the ADC trigger to start injected conversion. + * This parameter can be one of the following values: + * @arg ADC_ExternalTrigInjecConv_T1_CC4: Timer1 capture compare4 selected + * @arg ADC_ExternalTrigInjecConv_T1_TRGO: Timer1 TRGO event selected + * @arg ADC_ExternalTrigInjecConv_T2_CC1: Timer2 capture compare1 selected + * @arg ADC_ExternalTrigInjecConv_T2_TRGO: Timer2 TRGO event selected + * @arg ADC_ExternalTrigInjecConv_T3_CC2: Timer3 capture compare2 selected + * @arg ADC_ExternalTrigInjecConv_T3_CC4: Timer3 capture compare4 selected + * @arg ADC_ExternalTrigInjecConv_T4_CC1: Timer4 capture compare1 selected + * @arg ADC_ExternalTrigInjecConv_T4_CC2: Timer4 capture compare2 selected + * @arg ADC_ExternalTrigInjecConv_T4_CC3: Timer4 capture compare3 selected + * @arg ADC_ExternalTrigInjecConv_T4_TRGO: Timer4 TRGO event selected + * @arg ADC_ExternalTrigInjecConv_T5_CC4: Timer5 capture compare4 selected + * @arg ADC_ExternalTrigInjecConv_T5_TRGO: Timer5 TRGO event selected + * @arg ADC_ExternalTrigInjecConv_T8_CC2: Timer8 capture compare2 selected + * @arg ADC_ExternalTrigInjecConv_T8_CC3: Timer8 capture compare3 selected + * @arg ADC_ExternalTrigInjecConv_T8_CC4: Timer8 capture compare4 selected + * @arg ADC_ExternalTrigInjecConv_Ext_IT15: External interrupt line 15 event selected + * @retval None + */ +void ADC_ExternalTrigInjectedConvConfig(ADC_TypeDef* ADCx, uint32_t ADC_ExternalTrigInjecConv) +{ + uint32_t tmpreg = 0; + /* Check the parameters */ + assert_param(IS_ADC_ALL_PERIPH(ADCx)); + assert_param(IS_ADC_EXT_INJEC_TRIG(ADC_ExternalTrigInjecConv)); + + /* Get the old register value */ + tmpreg = ADCx->CR2; + + /* Clear the old external event selection for injected group */ + tmpreg &= CR2_JEXTSEL_RESET; + + /* Set the external event selection for injected group */ + tmpreg |= ADC_ExternalTrigInjecConv; + + /* Store the new register value */ + ADCx->CR2 = tmpreg; +} + +/** + * @brief Configures the ADCx external trigger edge for injected channels conversion. + * @param ADCx: where x can be 1, 2 or 3 to select the ADC peripheral. + * @param ADC_ExternalTrigInjecConvEdge: specifies the ADC external trigger edge + * to start injected conversion. + * This parameter can be one of the following values: + * @arg ADC_ExternalTrigInjecConvEdge_None: external trigger disabled for + * injected conversion + * @arg ADC_ExternalTrigInjecConvEdge_Rising: detection on rising edge + * @arg ADC_ExternalTrigInjecConvEdge_Falling: detection on falling edge + * @arg ADC_ExternalTrigInjecConvEdge_RisingFalling: detection on both rising + * and falling edge + * @retval None + */ +void ADC_ExternalTrigInjectedConvEdgeConfig(ADC_TypeDef* ADCx, uint32_t ADC_ExternalTrigInjecConvEdge) +{ + uint32_t tmpreg = 0; + /* Check the parameters */ + assert_param(IS_ADC_ALL_PERIPH(ADCx)); + assert_param(IS_ADC_EXT_INJEC_TRIG_EDGE(ADC_ExternalTrigInjecConvEdge)); + /* Get the old register value */ + tmpreg = ADCx->CR2; + /* Clear the old external trigger edge for injected group */ + tmpreg &= CR2_JEXTEN_RESET; + /* Set the new external trigger edge for injected group */ + tmpreg |= ADC_ExternalTrigInjecConvEdge; + /* Store the new register value */ + ADCx->CR2 = tmpreg; +} + +/** + * @brief Enables the selected ADC software start conversion of the injected channels. + * @param ADCx: where x can be 1, 2 or 3 to select the ADC peripheral. + * @retval None + */ +void ADC_SoftwareStartInjectedConv(ADC_TypeDef* ADCx) +{ + /* Check the parameters */ + assert_param(IS_ADC_ALL_PERIPH(ADCx)); + /* Enable the selected ADC conversion for injected group */ + ADCx->CR2 |= (uint32_t)ADC_CR2_JSWSTART; +} + +/** + * @brief Gets the selected ADC Software start injected conversion Status. + * @param ADCx: where x can be 1, 2 or 3 to select the ADC peripheral. + * @retval The new state of ADC software start injected conversion (SET or RESET). + */ +FlagStatus ADC_GetSoftwareStartInjectedConvCmdStatus(ADC_TypeDef* ADCx) +{ + FlagStatus bitstatus = RESET; + /* Check the parameters */ + assert_param(IS_ADC_ALL_PERIPH(ADCx)); + + /* Check the status of JSWSTART bit */ + if ((ADCx->CR2 & ADC_CR2_JSWSTART) != (uint32_t)RESET) + { + /* JSWSTART bit is set */ + bitstatus = SET; + } + else + { + /* JSWSTART bit is reset */ + bitstatus = RESET; + } + /* Return the JSWSTART bit status */ + return bitstatus; +} + +/** + * @brief Enables or disables the selected ADC automatic injected group + * conversion after regular one. + * @param ADCx: where x can be 1, 2 or 3 to select the ADC peripheral. + * @param NewState: new state of the selected ADC auto injected conversion + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void ADC_AutoInjectedConvCmd(ADC_TypeDef* ADCx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_ADC_ALL_PERIPH(ADCx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + if (NewState != DISABLE) + { + /* Enable the selected ADC automatic injected group conversion */ + ADCx->CR1 |= (uint32_t)ADC_CR1_JAUTO; + } + else + { + /* Disable the selected ADC automatic injected group conversion */ + ADCx->CR1 &= (uint32_t)(~ADC_CR1_JAUTO); + } +} + +/** + * @brief Enables or disables the discontinuous mode for injected group + * channel for the specified ADC + * @param ADCx: where x can be 1, 2 or 3 to select the ADC peripheral. + * @param NewState: new state of the selected ADC discontinuous mode on injected + * group channel. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void ADC_InjectedDiscModeCmd(ADC_TypeDef* ADCx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_ADC_ALL_PERIPH(ADCx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + if (NewState != DISABLE) + { + /* Enable the selected ADC injected discontinuous mode */ + ADCx->CR1 |= (uint32_t)ADC_CR1_JDISCEN; + } + else + { + /* Disable the selected ADC injected discontinuous mode */ + ADCx->CR1 &= (uint32_t)(~ADC_CR1_JDISCEN); + } +} + +/** + * @brief Returns the ADC injected channel conversion result + * @param ADCx: where x can be 1, 2 or 3 to select the ADC peripheral. + * @param ADC_InjectedChannel: the converted ADC injected channel. + * This parameter can be one of the following values: + * @arg ADC_InjectedChannel_1: Injected Channel1 selected + * @arg ADC_InjectedChannel_2: Injected Channel2 selected + * @arg ADC_InjectedChannel_3: Injected Channel3 selected + * @arg ADC_InjectedChannel_4: Injected Channel4 selected + * @retval The Data conversion value. + */ +uint16_t ADC_GetInjectedConversionValue(ADC_TypeDef* ADCx, uint8_t ADC_InjectedChannel) +{ + __IO uint32_t tmp = 0; + + /* Check the parameters */ + assert_param(IS_ADC_ALL_PERIPH(ADCx)); + assert_param(IS_ADC_INJECTED_CHANNEL(ADC_InjectedChannel)); + + tmp = (uint32_t)ADCx; + tmp += ADC_InjectedChannel + JDR_OFFSET; + + /* Returns the selected injected channel conversion data value */ + return (uint16_t) (*(__IO uint32_t*) tmp); +} +/** + * @} + */ + +/** @defgroup ADC_Group7 Interrupts and flags management functions + * @brief Interrupts and flags management functions + * +@verbatim + =============================================================================== + ##### Interrupts and flags management functions ##### + =============================================================================== + + [..] This section provides functions allowing to configure the ADC Interrupts + and to get the status and clear flags and Interrupts pending bits. + + [..] Each ADC provides 4 Interrupts sources and 6 Flags which can be divided + into 3 groups: + + *** Flags and Interrupts for ADC regular channels *** + ===================================================== + [..] + (+) Flags : + (##) ADC_FLAG_OVR : Overrun detection when regular converted data are lost + + (##) ADC_FLAG_EOC : Regular channel end of conversion ==> to indicate + (depending on EOCS bit, managed by ADC_EOCOnEachRegularChannelCmd() ) + the end of: + (+++) a regular CHANNEL conversion + (+++) sequence of regular GROUP conversions . + + (##) ADC_FLAG_STRT: Regular channel start ==> to indicate when regular + CHANNEL conversion starts. + [..] + (+) Interrupts : + (##) ADC_IT_OVR : specifies the interrupt source for Overrun detection + event. + (##) ADC_IT_EOC : specifies the interrupt source for Regular channel end + of conversion event. + + + *** Flags and Interrupts for ADC Injected channels *** + ====================================================== + [..] + (+) Flags : + (##) ADC_FLAG_JEOC : Injected channel end of conversion ==> to indicate + at the end of injected GROUP conversion + + (##) ADC_FLAG_JSTRT: Injected channel start ==> to indicate hardware when + injected GROUP conversion starts. + [..] + (+) Interrupts : + (##) ADC_IT_JEOC : specifies the interrupt source for Injected channel + end of conversion event. + + *** General Flags and Interrupts for the ADC *** + ================================================ + [..] + (+)Flags : + (##) ADC_FLAG_AWD: Analog watchdog ==> to indicate if the converted voltage + crosses the programmed thresholds values. + [..] + (+) Interrupts : + (##) ADC_IT_AWD : specifies the interrupt source for Analog watchdog event. + + + [..] The user should identify which mode will be used in his application to + manage the ADC controller events: Polling mode or Interrupt mode. + + [..] In the Polling Mode it is advised to use the following functions: + (+) ADC_GetFlagStatus() : to check if flags events occur. + (+) ADC_ClearFlag() : to clear the flags events. + + [..] In the Interrupt Mode it is advised to use the following functions: + (+) ADC_ITConfig() : to enable or disable the interrupt source. + (+) ADC_GetITStatus() : to check if Interrupt occurs. + (+) ADC_ClearITPendingBit() : to clear the Interrupt pending Bit + (corresponding Flag). +@endverbatim + * @{ + */ +/** + * @brief Enables or disables the specified ADC interrupts. + * @param ADCx: where x can be 1, 2 or 3 to select the ADC peripheral. + * @param ADC_IT: specifies the ADC interrupt sources to be enabled or disabled. + * This parameter can be one of the following values: + * @arg ADC_IT_EOC: End of conversion interrupt mask + * @arg ADC_IT_AWD: Analog watchdog interrupt mask + * @arg ADC_IT_JEOC: End of injected conversion interrupt mask + * @arg ADC_IT_OVR: Overrun interrupt enable + * @param NewState: new state of the specified ADC interrupts. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void ADC_ITConfig(ADC_TypeDef* ADCx, uint16_t ADC_IT, FunctionalState NewState) +{ + uint32_t itmask = 0; + /* Check the parameters */ + assert_param(IS_ADC_ALL_PERIPH(ADCx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + assert_param(IS_ADC_IT(ADC_IT)); + + /* Get the ADC IT index */ + itmask = (uint8_t)ADC_IT; + itmask = (uint32_t)0x01 << itmask; + + if (NewState != DISABLE) + { + /* Enable the selected ADC interrupts */ + ADCx->CR1 |= itmask; + } + else + { + /* Disable the selected ADC interrupts */ + ADCx->CR1 &= (~(uint32_t)itmask); + } +} + +/** + * @brief Checks whether the specified ADC flag is set or not. + * @param ADCx: where x can be 1, 2 or 3 to select the ADC peripheral. + * @param ADC_FLAG: specifies the flag to check. + * This parameter can be one of the following values: + * @arg ADC_FLAG_AWD: Analog watchdog flag + * @arg ADC_FLAG_EOC: End of conversion flag + * @arg ADC_FLAG_JEOC: End of injected group conversion flag + * @arg ADC_FLAG_JSTRT: Start of injected group conversion flag + * @arg ADC_FLAG_STRT: Start of regular group conversion flag + * @arg ADC_FLAG_OVR: Overrun flag + * @retval The new state of ADC_FLAG (SET or RESET). + */ +FlagStatus ADC_GetFlagStatus(ADC_TypeDef* ADCx, uint8_t ADC_FLAG) +{ + FlagStatus bitstatus = RESET; + /* Check the parameters */ + assert_param(IS_ADC_ALL_PERIPH(ADCx)); + assert_param(IS_ADC_GET_FLAG(ADC_FLAG)); + + /* Check the status of the specified ADC flag */ + if ((ADCx->SR & ADC_FLAG) != (uint8_t)RESET) + { + /* ADC_FLAG is set */ + bitstatus = SET; + } + else + { + /* ADC_FLAG is reset */ + bitstatus = RESET; + } + /* Return the ADC_FLAG status */ + return bitstatus; +} + +/** + * @brief Clears the ADCx's pending flags. + * @param ADCx: where x can be 1, 2 or 3 to select the ADC peripheral. + * @param ADC_FLAG: specifies the flag to clear. + * This parameter can be any combination of the following values: + * @arg ADC_FLAG_AWD: Analog watchdog flag + * @arg ADC_FLAG_EOC: End of conversion flag + * @arg ADC_FLAG_JEOC: End of injected group conversion flag + * @arg ADC_FLAG_JSTRT: Start of injected group conversion flag + * @arg ADC_FLAG_STRT: Start of regular group conversion flag + * @arg ADC_FLAG_OVR: Overrun flag + * @retval None + */ +void ADC_ClearFlag(ADC_TypeDef* ADCx, uint8_t ADC_FLAG) +{ + /* Check the parameters */ + assert_param(IS_ADC_ALL_PERIPH(ADCx)); + assert_param(IS_ADC_CLEAR_FLAG(ADC_FLAG)); + + /* Clear the selected ADC flags */ + ADCx->SR = ~(uint32_t)ADC_FLAG; +} + +/** + * @brief Checks whether the specified ADC interrupt has occurred or not. + * @param ADCx: where x can be 1, 2 or 3 to select the ADC peripheral. + * @param ADC_IT: specifies the ADC interrupt source to check. + * This parameter can be one of the following values: + * @arg ADC_IT_EOC: End of conversion interrupt mask + * @arg ADC_IT_AWD: Analog watchdog interrupt mask + * @arg ADC_IT_JEOC: End of injected conversion interrupt mask + * @arg ADC_IT_OVR: Overrun interrupt mask + * @retval The new state of ADC_IT (SET or RESET). + */ +ITStatus ADC_GetITStatus(ADC_TypeDef* ADCx, uint16_t ADC_IT) +{ + ITStatus bitstatus = RESET; + uint32_t itmask = 0, enablestatus = 0; + + /* Check the parameters */ + assert_param(IS_ADC_ALL_PERIPH(ADCx)); + assert_param(IS_ADC_IT(ADC_IT)); + + /* Get the ADC IT index */ + itmask = ADC_IT >> 8; + + /* Get the ADC_IT enable bit status */ + enablestatus = (ADCx->CR1 & ((uint32_t)0x01 << (uint8_t)ADC_IT)) ; + + /* Check the status of the specified ADC interrupt */ + if (((ADCx->SR & itmask) != (uint32_t)RESET) && enablestatus) + { + /* ADC_IT is set */ + bitstatus = SET; + } + else + { + /* ADC_IT is reset */ + bitstatus = RESET; + } + /* Return the ADC_IT status */ + return bitstatus; +} + +/** + * @brief Clears the ADCx's interrupt pending bits. + * @param ADCx: where x can be 1, 2 or 3 to select the ADC peripheral. + * @param ADC_IT: specifies the ADC interrupt pending bit to clear. + * This parameter can be one of the following values: + * @arg ADC_IT_EOC: End of conversion interrupt mask + * @arg ADC_IT_AWD: Analog watchdog interrupt mask + * @arg ADC_IT_JEOC: End of injected conversion interrupt mask + * @arg ADC_IT_OVR: Overrun interrupt mask + * @retval None + */ +void ADC_ClearITPendingBit(ADC_TypeDef* ADCx, uint16_t ADC_IT) +{ + uint8_t itmask = 0; + /* Check the parameters */ + assert_param(IS_ADC_ALL_PERIPH(ADCx)); + assert_param(IS_ADC_IT(ADC_IT)); + /* Get the ADC IT index */ + itmask = (uint8_t)(ADC_IT >> 8); + /* Clear the selected ADC interrupt pending bits */ + ADCx->SR = ~(uint32_t)itmask; +} +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/src/stm32f4xx_can.c b/FWLIB/src/stm32f4xx_can.c new file mode 100644 index 0000000..5a82b4a --- /dev/null +++ b/FWLIB/src/stm32f4xx_can.c @@ -0,0 +1,1700 @@ +/** + ****************************************************************************** + * @file stm32f4xx_can.c + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file provides firmware functions to manage the following + * functionalities of the Controller area network (CAN) peripheral: + * + Initialization and Configuration + * + CAN Frames Transmission + * + CAN Frames Reception + * + Operation modes switch + * + Error management + * + Interrupts and flags + * +@verbatim + =============================================================================== + ##### How to use this driver ##### + =============================================================================== + [..] + (#) Enable the CAN controller interface clock using + RCC_APB1PeriphClockCmd(RCC_APB1Periph_CAN1, ENABLE); for CAN1 + and RCC_APB1PeriphClockCmd(RCC_APB1Periph_CAN2, ENABLE); for CAN2 + -@- In case you are using CAN2 only, you have to enable the CAN1 clock. + + (#) CAN pins configuration + (++) Enable the clock for the CAN GPIOs using the following function: + RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOx, ENABLE); + (++) Connect the involved CAN pins to AF9 using the following function + GPIO_PinAFConfig(GPIOx, GPIO_PinSourcex, GPIO_AF_CANx); + (++) Configure these CAN pins in alternate function mode by calling + the function GPIO_Init(); + + (#) Initialise and configure the CAN using CAN_Init() and + CAN_FilterInit() functions. + + (#) Transmit the desired CAN frame using CAN_Transmit() function. + + (#) Check the transmission of a CAN frame using CAN_TransmitStatus() + function. + + (#) Cancel the transmission of a CAN frame using CAN_CancelTransmit() + function. + + (#) Receive a CAN frame using CAN_Recieve() function. + + (#) Release the receive FIFOs using CAN_FIFORelease() function. + + (#) Return the number of pending received frames using + CAN_MessagePending() function. + + (#) To control CAN events you can use one of the following two methods: + (++) Check on CAN flags using the CAN_GetFlagStatus() function. + (++) Use CAN interrupts through the function CAN_ITConfig() at + initialization phase and CAN_GetITStatus() function into + interrupt routines to check if the event has occurred or not. + After checking on a flag you should clear it using CAN_ClearFlag() + function. And after checking on an interrupt event you should + clear it using CAN_ClearITPendingBit() function. + +@endverbatim + + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx_can.h" +#include "stm32f4xx_rcc.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @defgroup CAN + * @brief CAN driver modules + * @{ + */ +/* Private typedef -----------------------------------------------------------*/ +/* Private define ------------------------------------------------------------*/ + +/* CAN Master Control Register bits */ +#define MCR_DBF ((uint32_t)0x00010000) /* software master reset */ + +/* CAN Mailbox Transmit Request */ +#define TMIDxR_TXRQ ((uint32_t)0x00000001) /* Transmit mailbox request */ + +/* CAN Filter Master Register bits */ +#define FMR_FINIT ((uint32_t)0x00000001) /* Filter init mode */ + +/* Time out for INAK bit */ +#define INAK_TIMEOUT ((uint32_t)0x0000FFFF) +/* Time out for SLAK bit */ +#define SLAK_TIMEOUT ((uint32_t)0x0000FFFF) + +/* Flags in TSR register */ +#define CAN_FLAGS_TSR ((uint32_t)0x08000000) +/* Flags in RF1R register */ +#define CAN_FLAGS_RF1R ((uint32_t)0x04000000) +/* Flags in RF0R register */ +#define CAN_FLAGS_RF0R ((uint32_t)0x02000000) +/* Flags in MSR register */ +#define CAN_FLAGS_MSR ((uint32_t)0x01000000) +/* Flags in ESR register */ +#define CAN_FLAGS_ESR ((uint32_t)0x00F00000) + +/* Mailboxes definition */ +#define CAN_TXMAILBOX_0 ((uint8_t)0x00) +#define CAN_TXMAILBOX_1 ((uint8_t)0x01) +#define CAN_TXMAILBOX_2 ((uint8_t)0x02) + +#define CAN_MODE_MASK ((uint32_t) 0x00000003) + +/* Private macro -------------------------------------------------------------*/ +/* Private variables ---------------------------------------------------------*/ +/* Private function prototypes -----------------------------------------------*/ +/* Private functions ---------------------------------------------------------*/ +static ITStatus CheckITStatus(uint32_t CAN_Reg, uint32_t It_Bit); + +/** @defgroup CAN_Private_Functions + * @{ + */ + +/** @defgroup CAN_Group1 Initialization and Configuration functions + * @brief Initialization and Configuration functions + * +@verbatim + =============================================================================== + ##### Initialization and Configuration functions ##### + =============================================================================== + [..] This section provides functions allowing to + (+) Initialize the CAN peripherals : Prescaler, operating mode, the maximum + number of time quanta to perform resynchronization, the number of time + quanta in Bit Segment 1 and 2 and many other modes. + Refer to @ref CAN_InitTypeDef for more details. + (+) Configures the CAN reception filter. + (+) Select the start bank filter for slave CAN. + (+) Enables or disables the Debug Freeze mode for CAN + (+)Enables or disables the CAN Time Trigger Operation communication mode + +@endverbatim + * @{ + */ + +/** + * @brief Deinitializes the CAN peripheral registers to their default reset values. + * @param CANx: where x can be 1 or 2 to select the CAN peripheral. + * @retval None. + */ +void CAN_DeInit(CAN_TypeDef* CANx) +{ + /* Check the parameters */ + assert_param(IS_CAN_ALL_PERIPH(CANx)); + + if (CANx == CAN1) + { + /* Enable CAN1 reset state */ + RCC_APB1PeriphResetCmd(RCC_APB1Periph_CAN1, ENABLE); + /* Release CAN1 from reset state */ + RCC_APB1PeriphResetCmd(RCC_APB1Periph_CAN1, DISABLE); + } + else + { + /* Enable CAN2 reset state */ + RCC_APB1PeriphResetCmd(RCC_APB1Periph_CAN2, ENABLE); + /* Release CAN2 from reset state */ + RCC_APB1PeriphResetCmd(RCC_APB1Periph_CAN2, DISABLE); + } +} + +/** + * @brief Initializes the CAN peripheral according to the specified + * parameters in the CAN_InitStruct. + * @param CANx: where x can be 1 or 2 to select the CAN peripheral. + * @param CAN_InitStruct: pointer to a CAN_InitTypeDef structure that contains + * the configuration information for the CAN peripheral. + * @retval Constant indicates initialization succeed which will be + * CAN_InitStatus_Failed or CAN_InitStatus_Success. + */ +uint8_t CAN_Init(CAN_TypeDef* CANx, CAN_InitTypeDef* CAN_InitStruct) +{ + uint8_t InitStatus = CAN_InitStatus_Failed; + uint32_t wait_ack = 0x00000000; + /* Check the parameters */ + assert_param(IS_CAN_ALL_PERIPH(CANx)); + assert_param(IS_FUNCTIONAL_STATE(CAN_InitStruct->CAN_TTCM)); + assert_param(IS_FUNCTIONAL_STATE(CAN_InitStruct->CAN_ABOM)); + assert_param(IS_FUNCTIONAL_STATE(CAN_InitStruct->CAN_AWUM)); + assert_param(IS_FUNCTIONAL_STATE(CAN_InitStruct->CAN_NART)); + assert_param(IS_FUNCTIONAL_STATE(CAN_InitStruct->CAN_RFLM)); + assert_param(IS_FUNCTIONAL_STATE(CAN_InitStruct->CAN_TXFP)); + assert_param(IS_CAN_MODE(CAN_InitStruct->CAN_Mode)); + assert_param(IS_CAN_SJW(CAN_InitStruct->CAN_SJW)); + assert_param(IS_CAN_BS1(CAN_InitStruct->CAN_BS1)); + assert_param(IS_CAN_BS2(CAN_InitStruct->CAN_BS2)); + assert_param(IS_CAN_PRESCALER(CAN_InitStruct->CAN_Prescaler)); + + /* Exit from sleep mode */ + CANx->MCR &= (~(uint32_t)CAN_MCR_SLEEP); + + /* Request initialisation */ + CANx->MCR |= CAN_MCR_INRQ ; + + /* Wait the acknowledge */ + while (((CANx->MSR & CAN_MSR_INAK) != CAN_MSR_INAK) && (wait_ack != INAK_TIMEOUT)) + { + wait_ack++; + } + + /* Check acknowledge */ + if ((CANx->MSR & CAN_MSR_INAK) != CAN_MSR_INAK) + { + InitStatus = CAN_InitStatus_Failed; + } + else + { + /* Set the time triggered communication mode */ + if (CAN_InitStruct->CAN_TTCM == ENABLE) + { + CANx->MCR |= CAN_MCR_TTCM; + } + else + { + CANx->MCR &= ~(uint32_t)CAN_MCR_TTCM; + } + + /* Set the automatic bus-off management */ + if (CAN_InitStruct->CAN_ABOM == ENABLE) + { + CANx->MCR |= CAN_MCR_ABOM; + } + else + { + CANx->MCR &= ~(uint32_t)CAN_MCR_ABOM; + } + + /* Set the automatic wake-up mode */ + if (CAN_InitStruct->CAN_AWUM == ENABLE) + { + CANx->MCR |= CAN_MCR_AWUM; + } + else + { + CANx->MCR &= ~(uint32_t)CAN_MCR_AWUM; + } + + /* Set the no automatic retransmission */ + if (CAN_InitStruct->CAN_NART == ENABLE) + { + CANx->MCR |= CAN_MCR_NART; + } + else + { + CANx->MCR &= ~(uint32_t)CAN_MCR_NART; + } + + /* Set the receive FIFO locked mode */ + if (CAN_InitStruct->CAN_RFLM == ENABLE) + { + CANx->MCR |= CAN_MCR_RFLM; + } + else + { + CANx->MCR &= ~(uint32_t)CAN_MCR_RFLM; + } + + /* Set the transmit FIFO priority */ + if (CAN_InitStruct->CAN_TXFP == ENABLE) + { + CANx->MCR |= CAN_MCR_TXFP; + } + else + { + CANx->MCR &= ~(uint32_t)CAN_MCR_TXFP; + } + + /* Set the bit timing register */ + CANx->BTR = (uint32_t)((uint32_t)CAN_InitStruct->CAN_Mode << 30) | \ + ((uint32_t)CAN_InitStruct->CAN_SJW << 24) | \ + ((uint32_t)CAN_InitStruct->CAN_BS1 << 16) | \ + ((uint32_t)CAN_InitStruct->CAN_BS2 << 20) | \ + ((uint32_t)CAN_InitStruct->CAN_Prescaler - 1); + + /* Request leave initialisation */ + CANx->MCR &= ~(uint32_t)CAN_MCR_INRQ; + + /* Wait the acknowledge */ + wait_ack = 0; + + while (((CANx->MSR & CAN_MSR_INAK) == CAN_MSR_INAK) && (wait_ack != INAK_TIMEOUT)) + { + wait_ack++; + } + + /* ...and check acknowledged */ + if ((CANx->MSR & CAN_MSR_INAK) == CAN_MSR_INAK) + { + InitStatus = CAN_InitStatus_Failed; + } + else + { + InitStatus = CAN_InitStatus_Success ; + } + } + + /* At this step, return the status of initialization */ + return InitStatus; +} + +/** + * @brief Configures the CAN reception filter according to the specified + * parameters in the CAN_FilterInitStruct. + * @param CAN_FilterInitStruct: pointer to a CAN_FilterInitTypeDef structure that + * contains the configuration information. + * @retval None + */ +void CAN_FilterInit(CAN_FilterInitTypeDef* CAN_FilterInitStruct) +{ + uint32_t filter_number_bit_pos = 0; + /* Check the parameters */ + assert_param(IS_CAN_FILTER_NUMBER(CAN_FilterInitStruct->CAN_FilterNumber)); + assert_param(IS_CAN_FILTER_MODE(CAN_FilterInitStruct->CAN_FilterMode)); + assert_param(IS_CAN_FILTER_SCALE(CAN_FilterInitStruct->CAN_FilterScale)); + assert_param(IS_CAN_FILTER_FIFO(CAN_FilterInitStruct->CAN_FilterFIFOAssignment)); + assert_param(IS_FUNCTIONAL_STATE(CAN_FilterInitStruct->CAN_FilterActivation)); + + filter_number_bit_pos = ((uint32_t)1) << CAN_FilterInitStruct->CAN_FilterNumber; + + /* Initialisation mode for the filter */ + CAN1->FMR |= FMR_FINIT; + + /* Filter Deactivation */ + CAN1->FA1R &= ~(uint32_t)filter_number_bit_pos; + + /* Filter Scale */ + if (CAN_FilterInitStruct->CAN_FilterScale == CAN_FilterScale_16bit) + { + /* 16-bit scale for the filter */ + CAN1->FS1R &= ~(uint32_t)filter_number_bit_pos; + + /* First 16-bit identifier and First 16-bit mask */ + /* Or First 16-bit identifier and Second 16-bit identifier */ + CAN1->sFilterRegister[CAN_FilterInitStruct->CAN_FilterNumber].FR1 = + ((0x0000FFFF & (uint32_t)CAN_FilterInitStruct->CAN_FilterMaskIdLow) << 16) | + (0x0000FFFF & (uint32_t)CAN_FilterInitStruct->CAN_FilterIdLow); + + /* Second 16-bit identifier and Second 16-bit mask */ + /* Or Third 16-bit identifier and Fourth 16-bit identifier */ + CAN1->sFilterRegister[CAN_FilterInitStruct->CAN_FilterNumber].FR2 = + ((0x0000FFFF & (uint32_t)CAN_FilterInitStruct->CAN_FilterMaskIdHigh) << 16) | + (0x0000FFFF & (uint32_t)CAN_FilterInitStruct->CAN_FilterIdHigh); + } + + if (CAN_FilterInitStruct->CAN_FilterScale == CAN_FilterScale_32bit) + { + /* 32-bit scale for the filter */ + CAN1->FS1R |= filter_number_bit_pos; + /* 32-bit identifier or First 32-bit identifier */ + CAN1->sFilterRegister[CAN_FilterInitStruct->CAN_FilterNumber].FR1 = + ((0x0000FFFF & (uint32_t)CAN_FilterInitStruct->CAN_FilterIdHigh) << 16) | + (0x0000FFFF & (uint32_t)CAN_FilterInitStruct->CAN_FilterIdLow); + /* 32-bit mask or Second 32-bit identifier */ + CAN1->sFilterRegister[CAN_FilterInitStruct->CAN_FilterNumber].FR2 = + ((0x0000FFFF & (uint32_t)CAN_FilterInitStruct->CAN_FilterMaskIdHigh) << 16) | + (0x0000FFFF & (uint32_t)CAN_FilterInitStruct->CAN_FilterMaskIdLow); + } + + /* Filter Mode */ + if (CAN_FilterInitStruct->CAN_FilterMode == CAN_FilterMode_IdMask) + { + /*Id/Mask mode for the filter*/ + CAN1->FM1R &= ~(uint32_t)filter_number_bit_pos; + } + else /* CAN_FilterInitStruct->CAN_FilterMode == CAN_FilterMode_IdList */ + { + /*Identifier list mode for the filter*/ + CAN1->FM1R |= (uint32_t)filter_number_bit_pos; + } + + /* Filter FIFO assignment */ + if (CAN_FilterInitStruct->CAN_FilterFIFOAssignment == CAN_Filter_FIFO0) + { + /* FIFO 0 assignation for the filter */ + CAN1->FFA1R &= ~(uint32_t)filter_number_bit_pos; + } + + if (CAN_FilterInitStruct->CAN_FilterFIFOAssignment == CAN_Filter_FIFO1) + { + /* FIFO 1 assignation for the filter */ + CAN1->FFA1R |= (uint32_t)filter_number_bit_pos; + } + + /* Filter activation */ + if (CAN_FilterInitStruct->CAN_FilterActivation == ENABLE) + { + CAN1->FA1R |= filter_number_bit_pos; + } + + /* Leave the initialisation mode for the filter */ + CAN1->FMR &= ~FMR_FINIT; +} + +/** + * @brief Fills each CAN_InitStruct member with its default value. + * @param CAN_InitStruct: pointer to a CAN_InitTypeDef structure which ill be initialized. + * @retval None + */ +void CAN_StructInit(CAN_InitTypeDef* CAN_InitStruct) +{ + /* Reset CAN init structure parameters values */ + + /* Initialize the time triggered communication mode */ + CAN_InitStruct->CAN_TTCM = DISABLE; + + /* Initialize the automatic bus-off management */ + CAN_InitStruct->CAN_ABOM = DISABLE; + + /* Initialize the automatic wake-up mode */ + CAN_InitStruct->CAN_AWUM = DISABLE; + + /* Initialize the no automatic retransmission */ + CAN_InitStruct->CAN_NART = DISABLE; + + /* Initialize the receive FIFO locked mode */ + CAN_InitStruct->CAN_RFLM = DISABLE; + + /* Initialize the transmit FIFO priority */ + CAN_InitStruct->CAN_TXFP = DISABLE; + + /* Initialize the CAN_Mode member */ + CAN_InitStruct->CAN_Mode = CAN_Mode_Normal; + + /* Initialize the CAN_SJW member */ + CAN_InitStruct->CAN_SJW = CAN_SJW_1tq; + + /* Initialize the CAN_BS1 member */ + CAN_InitStruct->CAN_BS1 = CAN_BS1_4tq; + + /* Initialize the CAN_BS2 member */ + CAN_InitStruct->CAN_BS2 = CAN_BS2_3tq; + + /* Initialize the CAN_Prescaler member */ + CAN_InitStruct->CAN_Prescaler = 1; +} + +/** + * @brief Select the start bank filter for slave CAN. + * @param CAN_BankNumber: Select the start slave bank filter from 1..27. + * @retval None + */ +void CAN_SlaveStartBank(uint8_t CAN_BankNumber) +{ + /* Check the parameters */ + assert_param(IS_CAN_BANKNUMBER(CAN_BankNumber)); + + /* Enter Initialisation mode for the filter */ + CAN1->FMR |= FMR_FINIT; + + /* Select the start slave bank */ + CAN1->FMR &= (uint32_t)0xFFFFC0F1 ; + CAN1->FMR |= (uint32_t)(CAN_BankNumber)<<8; + + /* Leave Initialisation mode for the filter */ + CAN1->FMR &= ~FMR_FINIT; +} + +/** + * @brief Enables or disables the DBG Freeze for CAN. + * @param CANx: where x can be 1 or 2 to to select the CAN peripheral. + * @param NewState: new state of the CAN peripheral. + * This parameter can be: ENABLE (CAN reception/transmission is frozen + * during debug. Reception FIFOs can still be accessed/controlled normally) + * or DISABLE (CAN is working during debug). + * @retval None + */ +void CAN_DBGFreeze(CAN_TypeDef* CANx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_CAN_ALL_PERIPH(CANx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable Debug Freeze */ + CANx->MCR |= MCR_DBF; + } + else + { + /* Disable Debug Freeze */ + CANx->MCR &= ~MCR_DBF; + } +} + + +/** + * @brief Enables or disables the CAN Time TriggerOperation communication mode. + * @note DLC must be programmed as 8 in order Time Stamp (2 bytes) to be + * sent over the CAN bus. + * @param CANx: where x can be 1 or 2 to to select the CAN peripheral. + * @param NewState: Mode new state. This parameter can be: ENABLE or DISABLE. + * When enabled, Time stamp (TIME[15:0]) value is sent in the last two + * data bytes of the 8-byte message: TIME[7:0] in data byte 6 and TIME[15:8] + * in data byte 7. + * @retval None + */ +void CAN_TTComModeCmd(CAN_TypeDef* CANx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_CAN_ALL_PERIPH(CANx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + if (NewState != DISABLE) + { + /* Enable the TTCM mode */ + CANx->MCR |= CAN_MCR_TTCM; + + /* Set TGT bits */ + CANx->sTxMailBox[0].TDTR |= ((uint32_t)CAN_TDT0R_TGT); + CANx->sTxMailBox[1].TDTR |= ((uint32_t)CAN_TDT1R_TGT); + CANx->sTxMailBox[2].TDTR |= ((uint32_t)CAN_TDT2R_TGT); + } + else + { + /* Disable the TTCM mode */ + CANx->MCR &= (uint32_t)(~(uint32_t)CAN_MCR_TTCM); + + /* Reset TGT bits */ + CANx->sTxMailBox[0].TDTR &= ((uint32_t)~CAN_TDT0R_TGT); + CANx->sTxMailBox[1].TDTR &= ((uint32_t)~CAN_TDT1R_TGT); + CANx->sTxMailBox[2].TDTR &= ((uint32_t)~CAN_TDT2R_TGT); + } +} +/** + * @} + */ + + +/** @defgroup CAN_Group2 CAN Frames Transmission functions + * @brief CAN Frames Transmission functions + * +@verbatim + =============================================================================== + ##### CAN Frames Transmission functions ##### + =============================================================================== + [..] This section provides functions allowing to + (+) Initiate and transmit a CAN frame message (if there is an empty mailbox). + (+) Check the transmission status of a CAN Frame + (+) Cancel a transmit request + +@endverbatim + * @{ + */ + +/** + * @brief Initiates and transmits a CAN frame message. + * @param CANx: where x can be 1 or 2 to to select the CAN peripheral. + * @param TxMessage: pointer to a structure which contains CAN Id, CAN DLC and CAN data. + * @retval The number of the mailbox that is used for transmission or + * CAN_TxStatus_NoMailBox if there is no empty mailbox. + */ +uint8_t CAN_Transmit(CAN_TypeDef* CANx, CanTxMsg* TxMessage) +{ + uint8_t transmit_mailbox = 0; + /* Check the parameters */ + assert_param(IS_CAN_ALL_PERIPH(CANx)); + assert_param(IS_CAN_IDTYPE(TxMessage->IDE)); + assert_param(IS_CAN_RTR(TxMessage->RTR)); + assert_param(IS_CAN_DLC(TxMessage->DLC)); + + /* Select one empty transmit mailbox */ + if ((CANx->TSR&CAN_TSR_TME0) == CAN_TSR_TME0) + { + transmit_mailbox = 0; + } + else if ((CANx->TSR&CAN_TSR_TME1) == CAN_TSR_TME1) + { + transmit_mailbox = 1; + } + else if ((CANx->TSR&CAN_TSR_TME2) == CAN_TSR_TME2) + { + transmit_mailbox = 2; + } + else + { + transmit_mailbox = CAN_TxStatus_NoMailBox; + } + + if (transmit_mailbox != CAN_TxStatus_NoMailBox) + { + /* Set up the Id */ + CANx->sTxMailBox[transmit_mailbox].TIR &= TMIDxR_TXRQ; + if (TxMessage->IDE == CAN_Id_Standard) + { + assert_param(IS_CAN_STDID(TxMessage->StdId)); + CANx->sTxMailBox[transmit_mailbox].TIR |= ((TxMessage->StdId << 21) | \ + TxMessage->RTR); + } + else + { + assert_param(IS_CAN_EXTID(TxMessage->ExtId)); + CANx->sTxMailBox[transmit_mailbox].TIR |= ((TxMessage->ExtId << 3) | \ + TxMessage->IDE | \ + TxMessage->RTR); + } + + /* Set up the DLC */ + TxMessage->DLC &= (uint8_t)0x0000000F; + CANx->sTxMailBox[transmit_mailbox].TDTR &= (uint32_t)0xFFFFFFF0; + CANx->sTxMailBox[transmit_mailbox].TDTR |= TxMessage->DLC; + + /* Set up the data field */ + CANx->sTxMailBox[transmit_mailbox].TDLR = (((uint32_t)TxMessage->Data[3] << 24) | + ((uint32_t)TxMessage->Data[2] << 16) | + ((uint32_t)TxMessage->Data[1] << 8) | + ((uint32_t)TxMessage->Data[0])); + CANx->sTxMailBox[transmit_mailbox].TDHR = (((uint32_t)TxMessage->Data[7] << 24) | + ((uint32_t)TxMessage->Data[6] << 16) | + ((uint32_t)TxMessage->Data[5] << 8) | + ((uint32_t)TxMessage->Data[4])); + /* Request transmission */ + CANx->sTxMailBox[transmit_mailbox].TIR |= TMIDxR_TXRQ; + } + return transmit_mailbox; +} + +/** + * @brief Checks the transmission status of a CAN Frame. + * @param CANx: where x can be 1 or 2 to select the CAN peripheral. + * @param TransmitMailbox: the number of the mailbox that is used for transmission. + * @retval CAN_TxStatus_Ok if the CAN driver transmits the message, + * CAN_TxStatus_Failed in an other case. + */ +uint8_t CAN_TransmitStatus(CAN_TypeDef* CANx, uint8_t TransmitMailbox) +{ + uint32_t state = 0; + + /* Check the parameters */ + assert_param(IS_CAN_ALL_PERIPH(CANx)); + assert_param(IS_CAN_TRANSMITMAILBOX(TransmitMailbox)); + + switch (TransmitMailbox) + { + case (CAN_TXMAILBOX_0): + state = CANx->TSR & (CAN_TSR_RQCP0 | CAN_TSR_TXOK0 | CAN_TSR_TME0); + break; + case (CAN_TXMAILBOX_1): + state = CANx->TSR & (CAN_TSR_RQCP1 | CAN_TSR_TXOK1 | CAN_TSR_TME1); + break; + case (CAN_TXMAILBOX_2): + state = CANx->TSR & (CAN_TSR_RQCP2 | CAN_TSR_TXOK2 | CAN_TSR_TME2); + break; + default: + state = CAN_TxStatus_Failed; + break; + } + switch (state) + { + /* transmit pending */ + case (0x0): state = CAN_TxStatus_Pending; + break; + /* transmit failed */ + case (CAN_TSR_RQCP0 | CAN_TSR_TME0): state = CAN_TxStatus_Failed; + break; + case (CAN_TSR_RQCP1 | CAN_TSR_TME1): state = CAN_TxStatus_Failed; + break; + case (CAN_TSR_RQCP2 | CAN_TSR_TME2): state = CAN_TxStatus_Failed; + break; + /* transmit succeeded */ + case (CAN_TSR_RQCP0 | CAN_TSR_TXOK0 | CAN_TSR_TME0):state = CAN_TxStatus_Ok; + break; + case (CAN_TSR_RQCP1 | CAN_TSR_TXOK1 | CAN_TSR_TME1):state = CAN_TxStatus_Ok; + break; + case (CAN_TSR_RQCP2 | CAN_TSR_TXOK2 | CAN_TSR_TME2):state = CAN_TxStatus_Ok; + break; + default: state = CAN_TxStatus_Failed; + break; + } + return (uint8_t) state; +} + +/** + * @brief Cancels a transmit request. + * @param CANx: where x can be 1 or 2 to select the CAN peripheral. + * @param Mailbox: Mailbox number. + * @retval None + */ +void CAN_CancelTransmit(CAN_TypeDef* CANx, uint8_t Mailbox) +{ + /* Check the parameters */ + assert_param(IS_CAN_ALL_PERIPH(CANx)); + assert_param(IS_CAN_TRANSMITMAILBOX(Mailbox)); + /* abort transmission */ + switch (Mailbox) + { + case (CAN_TXMAILBOX_0): CANx->TSR |= CAN_TSR_ABRQ0; + break; + case (CAN_TXMAILBOX_1): CANx->TSR |= CAN_TSR_ABRQ1; + break; + case (CAN_TXMAILBOX_2): CANx->TSR |= CAN_TSR_ABRQ2; + break; + default: + break; + } +} +/** + * @} + */ + + +/** @defgroup CAN_Group3 CAN Frames Reception functions + * @brief CAN Frames Reception functions + * +@verbatim + =============================================================================== + ##### CAN Frames Reception functions ##### + =============================================================================== + [..] This section provides functions allowing to + (+) Receive a correct CAN frame + (+) Release a specified receive FIFO (2 FIFOs are available) + (+) Return the number of the pending received CAN frames + +@endverbatim + * @{ + */ + +/** + * @brief Receives a correct CAN frame. + * @param CANx: where x can be 1 or 2 to select the CAN peripheral. + * @param FIFONumber: Receive FIFO number, CAN_FIFO0 or CAN_FIFO1. + * @param RxMessage: pointer to a structure receive frame which contains CAN Id, + * CAN DLC, CAN data and FMI number. + * @retval None + */ +void CAN_Receive(CAN_TypeDef* CANx, uint8_t FIFONumber, CanRxMsg* RxMessage) +{ + /* Check the parameters */ + assert_param(IS_CAN_ALL_PERIPH(CANx)); + assert_param(IS_CAN_FIFO(FIFONumber)); + /* Get the Id */ + RxMessage->IDE = (uint8_t)0x04 & CANx->sFIFOMailBox[FIFONumber].RIR; + if (RxMessage->IDE == CAN_Id_Standard) + { + RxMessage->StdId = (uint32_t)0x000007FF & (CANx->sFIFOMailBox[FIFONumber].RIR >> 21); + } + else + { + RxMessage->ExtId = (uint32_t)0x1FFFFFFF & (CANx->sFIFOMailBox[FIFONumber].RIR >> 3); + } + + RxMessage->RTR = (uint8_t)0x02 & CANx->sFIFOMailBox[FIFONumber].RIR; + /* Get the DLC */ + RxMessage->DLC = (uint8_t)0x0F & CANx->sFIFOMailBox[FIFONumber].RDTR; + /* Get the FMI */ + RxMessage->FMI = (uint8_t)0xFF & (CANx->sFIFOMailBox[FIFONumber].RDTR >> 8); + /* Get the data field */ + RxMessage->Data[0] = (uint8_t)0xFF & CANx->sFIFOMailBox[FIFONumber].RDLR; + RxMessage->Data[1] = (uint8_t)0xFF & (CANx->sFIFOMailBox[FIFONumber].RDLR >> 8); + RxMessage->Data[2] = (uint8_t)0xFF & (CANx->sFIFOMailBox[FIFONumber].RDLR >> 16); + RxMessage->Data[3] = (uint8_t)0xFF & (CANx->sFIFOMailBox[FIFONumber].RDLR >> 24); + RxMessage->Data[4] = (uint8_t)0xFF & CANx->sFIFOMailBox[FIFONumber].RDHR; + RxMessage->Data[5] = (uint8_t)0xFF & (CANx->sFIFOMailBox[FIFONumber].RDHR >> 8); + RxMessage->Data[6] = (uint8_t)0xFF & (CANx->sFIFOMailBox[FIFONumber].RDHR >> 16); + RxMessage->Data[7] = (uint8_t)0xFF & (CANx->sFIFOMailBox[FIFONumber].RDHR >> 24); + /* Release the FIFO */ + /* Release FIFO0 */ + if (FIFONumber == CAN_FIFO0) + { + CANx->RF0R |= CAN_RF0R_RFOM0; + } + /* Release FIFO1 */ + else /* FIFONumber == CAN_FIFO1 */ + { + CANx->RF1R |= CAN_RF1R_RFOM1; + } +} + +/** + * @brief Releases the specified receive FIFO. + * @param CANx: where x can be 1 or 2 to select the CAN peripheral. + * @param FIFONumber: FIFO to release, CAN_FIFO0 or CAN_FIFO1. + * @retval None + */ +void CAN_FIFORelease(CAN_TypeDef* CANx, uint8_t FIFONumber) +{ + /* Check the parameters */ + assert_param(IS_CAN_ALL_PERIPH(CANx)); + assert_param(IS_CAN_FIFO(FIFONumber)); + /* Release FIFO0 */ + if (FIFONumber == CAN_FIFO0) + { + CANx->RF0R |= CAN_RF0R_RFOM0; + } + /* Release FIFO1 */ + else /* FIFONumber == CAN_FIFO1 */ + { + CANx->RF1R |= CAN_RF1R_RFOM1; + } +} + +/** + * @brief Returns the number of pending received messages. + * @param CANx: where x can be 1 or 2 to select the CAN peripheral. + * @param FIFONumber: Receive FIFO number, CAN_FIFO0 or CAN_FIFO1. + * @retval NbMessage : which is the number of pending message. + */ +uint8_t CAN_MessagePending(CAN_TypeDef* CANx, uint8_t FIFONumber) +{ + uint8_t message_pending=0; + /* Check the parameters */ + assert_param(IS_CAN_ALL_PERIPH(CANx)); + assert_param(IS_CAN_FIFO(FIFONumber)); + if (FIFONumber == CAN_FIFO0) + { + message_pending = (uint8_t)(CANx->RF0R&(uint32_t)0x03); + } + else if (FIFONumber == CAN_FIFO1) + { + message_pending = (uint8_t)(CANx->RF1R&(uint32_t)0x03); + } + else + { + message_pending = 0; + } + return message_pending; +} +/** + * @} + */ + + +/** @defgroup CAN_Group4 CAN Operation modes functions + * @brief CAN Operation modes functions + * +@verbatim + =============================================================================== + ##### CAN Operation modes functions ##### + =============================================================================== + [..] This section provides functions allowing to select the CAN Operation modes + (+) sleep mode + (+) normal mode + (+) initialization mode + +@endverbatim + * @{ + */ + + +/** + * @brief Selects the CAN Operation mode. + * @param CAN_OperatingMode: CAN Operating Mode. + * This parameter can be one of @ref CAN_OperatingMode_TypeDef enumeration. + * @retval status of the requested mode which can be + * - CAN_ModeStatus_Failed: CAN failed entering the specific mode + * - CAN_ModeStatus_Success: CAN Succeed entering the specific mode + */ +uint8_t CAN_OperatingModeRequest(CAN_TypeDef* CANx, uint8_t CAN_OperatingMode) +{ + uint8_t status = CAN_ModeStatus_Failed; + + /* Timeout for INAK or also for SLAK bits*/ + uint32_t timeout = INAK_TIMEOUT; + + /* Check the parameters */ + assert_param(IS_CAN_ALL_PERIPH(CANx)); + assert_param(IS_CAN_OPERATING_MODE(CAN_OperatingMode)); + + if (CAN_OperatingMode == CAN_OperatingMode_Initialization) + { + /* Request initialisation */ + CANx->MCR = (uint32_t)((CANx->MCR & (uint32_t)(~(uint32_t)CAN_MCR_SLEEP)) | CAN_MCR_INRQ); + + /* Wait the acknowledge */ + while (((CANx->MSR & CAN_MODE_MASK) != CAN_MSR_INAK) && (timeout != 0)) + { + timeout--; + } + if ((CANx->MSR & CAN_MODE_MASK) != CAN_MSR_INAK) + { + status = CAN_ModeStatus_Failed; + } + else + { + status = CAN_ModeStatus_Success; + } + } + else if (CAN_OperatingMode == CAN_OperatingMode_Normal) + { + /* Request leave initialisation and sleep mode and enter Normal mode */ + CANx->MCR &= (uint32_t)(~(CAN_MCR_SLEEP|CAN_MCR_INRQ)); + + /* Wait the acknowledge */ + while (((CANx->MSR & CAN_MODE_MASK) != 0) && (timeout!=0)) + { + timeout--; + } + if ((CANx->MSR & CAN_MODE_MASK) != 0) + { + status = CAN_ModeStatus_Failed; + } + else + { + status = CAN_ModeStatus_Success; + } + } + else if (CAN_OperatingMode == CAN_OperatingMode_Sleep) + { + /* Request Sleep mode */ + CANx->MCR = (uint32_t)((CANx->MCR & (uint32_t)(~(uint32_t)CAN_MCR_INRQ)) | CAN_MCR_SLEEP); + + /* Wait the acknowledge */ + while (((CANx->MSR & CAN_MODE_MASK) != CAN_MSR_SLAK) && (timeout!=0)) + { + timeout--; + } + if ((CANx->MSR & CAN_MODE_MASK) != CAN_MSR_SLAK) + { + status = CAN_ModeStatus_Failed; + } + else + { + status = CAN_ModeStatus_Success; + } + } + else + { + status = CAN_ModeStatus_Failed; + } + + return (uint8_t) status; +} + +/** + * @brief Enters the Sleep (low power) mode. + * @param CANx: where x can be 1 or 2 to select the CAN peripheral. + * @retval CAN_Sleep_Ok if sleep entered, CAN_Sleep_Failed otherwise. + */ +uint8_t CAN_Sleep(CAN_TypeDef* CANx) +{ + uint8_t sleepstatus = CAN_Sleep_Failed; + + /* Check the parameters */ + assert_param(IS_CAN_ALL_PERIPH(CANx)); + + /* Request Sleep mode */ + CANx->MCR = (((CANx->MCR) & (uint32_t)(~(uint32_t)CAN_MCR_INRQ)) | CAN_MCR_SLEEP); + + /* Sleep mode status */ + if ((CANx->MSR & (CAN_MSR_SLAK|CAN_MSR_INAK)) == CAN_MSR_SLAK) + { + /* Sleep mode not entered */ + sleepstatus = CAN_Sleep_Ok; + } + /* return sleep mode status */ + return (uint8_t)sleepstatus; +} + +/** + * @brief Wakes up the CAN peripheral from sleep mode . + * @param CANx: where x can be 1 or 2 to select the CAN peripheral. + * @retval CAN_WakeUp_Ok if sleep mode left, CAN_WakeUp_Failed otherwise. + */ +uint8_t CAN_WakeUp(CAN_TypeDef* CANx) +{ + uint32_t wait_slak = SLAK_TIMEOUT; + uint8_t wakeupstatus = CAN_WakeUp_Failed; + + /* Check the parameters */ + assert_param(IS_CAN_ALL_PERIPH(CANx)); + + /* Wake up request */ + CANx->MCR &= ~(uint32_t)CAN_MCR_SLEEP; + + /* Sleep mode status */ + while(((CANx->MSR & CAN_MSR_SLAK) == CAN_MSR_SLAK)&&(wait_slak!=0x00)) + { + wait_slak--; + } + if((CANx->MSR & CAN_MSR_SLAK) != CAN_MSR_SLAK) + { + /* wake up done : Sleep mode exited */ + wakeupstatus = CAN_WakeUp_Ok; + } + /* return wakeup status */ + return (uint8_t)wakeupstatus; +} +/** + * @} + */ + + +/** @defgroup CAN_Group5 CAN Bus Error management functions + * @brief CAN Bus Error management functions + * +@verbatim + =============================================================================== + ##### CAN Bus Error management functions ##### + =============================================================================== + [..] This section provides functions allowing to + (+) Return the CANx's last error code (LEC) + (+) Return the CANx Receive Error Counter (REC) + (+) Return the LSB of the 9-bit CANx Transmit Error Counter(TEC). + + -@- If TEC is greater than 255, The CAN is in bus-off state. + -@- if REC or TEC are greater than 96, an Error warning flag occurs. + -@- if REC or TEC are greater than 127, an Error Passive Flag occurs. + +@endverbatim + * @{ + */ + +/** + * @brief Returns the CANx's last error code (LEC). + * @param CANx: where x can be 1 or 2 to select the CAN peripheral. + * @retval Error code: + * - CAN_ERRORCODE_NoErr: No Error + * - CAN_ERRORCODE_StuffErr: Stuff Error + * - CAN_ERRORCODE_FormErr: Form Error + * - CAN_ERRORCODE_ACKErr : Acknowledgment Error + * - CAN_ERRORCODE_BitRecessiveErr: Bit Recessive Error + * - CAN_ERRORCODE_BitDominantErr: Bit Dominant Error + * - CAN_ERRORCODE_CRCErr: CRC Error + * - CAN_ERRORCODE_SoftwareSetErr: Software Set Error + */ +uint8_t CAN_GetLastErrorCode(CAN_TypeDef* CANx) +{ + uint8_t errorcode=0; + + /* Check the parameters */ + assert_param(IS_CAN_ALL_PERIPH(CANx)); + + /* Get the error code*/ + errorcode = (((uint8_t)CANx->ESR) & (uint8_t)CAN_ESR_LEC); + + /* Return the error code*/ + return errorcode; +} + +/** + * @brief Returns the CANx Receive Error Counter (REC). + * @note In case of an error during reception, this counter is incremented + * by 1 or by 8 depending on the error condition as defined by the CAN + * standard. After every successful reception, the counter is + * decremented by 1 or reset to 120 if its value was higher than 128. + * When the counter value exceeds 127, the CAN controller enters the + * error passive state. + * @param CANx: where x can be 1 or 2 to to select the CAN peripheral. + * @retval CAN Receive Error Counter. + */ +uint8_t CAN_GetReceiveErrorCounter(CAN_TypeDef* CANx) +{ + uint8_t counter=0; + + /* Check the parameters */ + assert_param(IS_CAN_ALL_PERIPH(CANx)); + + /* Get the Receive Error Counter*/ + counter = (uint8_t)((CANx->ESR & CAN_ESR_REC)>> 24); + + /* Return the Receive Error Counter*/ + return counter; +} + + +/** + * @brief Returns the LSB of the 9-bit CANx Transmit Error Counter(TEC). + * @param CANx: where x can be 1 or 2 to to select the CAN peripheral. + * @retval LSB of the 9-bit CAN Transmit Error Counter. + */ +uint8_t CAN_GetLSBTransmitErrorCounter(CAN_TypeDef* CANx) +{ + uint8_t counter=0; + + /* Check the parameters */ + assert_param(IS_CAN_ALL_PERIPH(CANx)); + + /* Get the LSB of the 9-bit CANx Transmit Error Counter(TEC) */ + counter = (uint8_t)((CANx->ESR & CAN_ESR_TEC)>> 16); + + /* Return the LSB of the 9-bit CANx Transmit Error Counter(TEC) */ + return counter; +} +/** + * @} + */ + +/** @defgroup CAN_Group6 Interrupts and flags management functions + * @brief Interrupts and flags management functions + * +@verbatim + =============================================================================== + ##### Interrupts and flags management functions ##### + =============================================================================== + + [..] This section provides functions allowing to configure the CAN Interrupts + and to get the status and clear flags and Interrupts pending bits. + + The CAN provides 14 Interrupts sources and 15 Flags: + + + *** Flags *** + ============= + [..] The 15 flags can be divided on 4 groups: + + (+) Transmit Flags + (++) CAN_FLAG_RQCP0, + (++) CAN_FLAG_RQCP1, + (++) CAN_FLAG_RQCP2 : Request completed MailBoxes 0, 1 and 2 Flags + Set when when the last request (transmit or abort) + has been performed. + + (+) Receive Flags + + + (++) CAN_FLAG_FMP0, + (++) CAN_FLAG_FMP1 : FIFO 0 and 1 Message Pending Flags + set to signal that messages are pending in the receive + FIFO. + These Flags are cleared only by hardware. + + (++) CAN_FLAG_FF0, + (++) CAN_FLAG_FF1 : FIFO 0 and 1 Full Flags + set when three messages are stored in the selected + FIFO. + + (++) CAN_FLAG_FOV0 + (++) CAN_FLAG_FOV1 : FIFO 0 and 1 Overrun Flags + set when a new message has been received and passed + the filter while the FIFO was full. + + (+) Operating Mode Flags + + (++) CAN_FLAG_WKU : Wake up Flag + set to signal that a SOF bit has been detected while + the CAN hardware was in Sleep mode. + + (++) CAN_FLAG_SLAK : Sleep acknowledge Flag + Set to signal that the CAN has entered Sleep Mode. + + (+) Error Flags + + (++) CAN_FLAG_EWG : Error Warning Flag + Set when the warning limit has been reached (Receive + Error Counter or Transmit Error Counter greater than 96). + This Flag is cleared only by hardware. + + (++) CAN_FLAG_EPV : Error Passive Flag + Set when the Error Passive limit has been reached + (Receive Error Counter or Transmit Error Counter + greater than 127). + This Flag is cleared only by hardware. + + (++) CAN_FLAG_BOF : Bus-Off Flag + set when CAN enters the bus-off state. The bus-off + state is entered on TEC overflow, greater than 255. + This Flag is cleared only by hardware. + + (++) CAN_FLAG_LEC : Last error code Flag + set If a message has been transferred (reception or + transmission) with error, and the error code is hold. + + *** Interrupts *** + ================== + [..] The 14 interrupts can be divided on 4 groups: + + (+) Transmit interrupt + + (++) CAN_IT_TME : Transmit mailbox empty Interrupt + if enabled, this interrupt source is pending when + no transmit request are pending for Tx mailboxes. + + (+) Receive Interrupts + + (++) CAN_IT_FMP0, + (++) CAN_IT_FMP1 : FIFO 0 and FIFO1 message pending Interrupts + if enabled, these interrupt sources are pending + when messages are pending in the receive FIFO. + The corresponding interrupt pending bits are cleared + only by hardware. + + (++) CAN_IT_FF0, + (++) CAN_IT_FF1 : FIFO 0 and FIFO1 full Interrupts + if enabled, these interrupt sources are pending + when three messages are stored in the selected FIFO. + + (++) CAN_IT_FOV0, + (++) CAN_IT_FOV1 : FIFO 0 and FIFO1 overrun Interrupts + if enabled, these interrupt sources are pending + when a new message has been received and passed + the filter while the FIFO was full. + + (+) Operating Mode Interrupts + + (++) CAN_IT_WKU : Wake-up Interrupt + if enabled, this interrupt source is pending when + a SOF bit has been detected while the CAN hardware + was in Sleep mode. + + (++) CAN_IT_SLK : Sleep acknowledge Interrupt + if enabled, this interrupt source is pending when + the CAN has entered Sleep Mode. + + (+) Error Interrupts + + (++) CAN_IT_EWG : Error warning Interrupt + if enabled, this interrupt source is pending when + the warning limit has been reached (Receive Error + Counter or Transmit Error Counter=96). + + (++) CAN_IT_EPV : Error passive Interrupt + if enabled, this interrupt source is pending when + the Error Passive limit has been reached (Receive + Error Counter or Transmit Error Counter>127). + + (++) CAN_IT_BOF : Bus-off Interrupt + if enabled, this interrupt source is pending when + CAN enters the bus-off state. The bus-off state is + entered on TEC overflow, greater than 255. + This Flag is cleared only by hardware. + + (++) CAN_IT_LEC : Last error code Interrupt + if enabled, this interrupt source is pending when + a message has been transferred (reception or + transmission) with error, and the error code is hold. + + (++) CAN_IT_ERR : Error Interrupt + if enabled, this interrupt source is pending when + an error condition is pending. + + [..] Managing the CAN controller events : + + The user should identify which mode will be used in his application to + manage the CAN controller events: Polling mode or Interrupt mode. + + (#) In the Polling Mode it is advised to use the following functions: + (++) CAN_GetFlagStatus() : to check if flags events occur. + (++) CAN_ClearFlag() : to clear the flags events. + + + + (#) In the Interrupt Mode it is advised to use the following functions: + (++) CAN_ITConfig() : to enable or disable the interrupt source. + (++) CAN_GetITStatus() : to check if Interrupt occurs. + (++) CAN_ClearITPendingBit() : to clear the Interrupt pending Bit + (corresponding Flag). + -@@- This function has no impact on CAN_IT_FMP0 and CAN_IT_FMP1 Interrupts + pending bits since there are cleared only by hardware. + +@endverbatim + * @{ + */ +/** + * @brief Enables or disables the specified CANx interrupts. + * @param CANx: where x can be 1 or 2 to to select the CAN peripheral. + * @param CAN_IT: specifies the CAN interrupt sources to be enabled or disabled. + * This parameter can be: + * @arg CAN_IT_TME: Transmit mailbox empty Interrupt + * @arg CAN_IT_FMP0: FIFO 0 message pending Interrupt + * @arg CAN_IT_FF0: FIFO 0 full Interrupt + * @arg CAN_IT_FOV0: FIFO 0 overrun Interrupt + * @arg CAN_IT_FMP1: FIFO 1 message pending Interrupt + * @arg CAN_IT_FF1: FIFO 1 full Interrupt + * @arg CAN_IT_FOV1: FIFO 1 overrun Interrupt + * @arg CAN_IT_WKU: Wake-up Interrupt + * @arg CAN_IT_SLK: Sleep acknowledge Interrupt + * @arg CAN_IT_EWG: Error warning Interrupt + * @arg CAN_IT_EPV: Error passive Interrupt + * @arg CAN_IT_BOF: Bus-off Interrupt + * @arg CAN_IT_LEC: Last error code Interrupt + * @arg CAN_IT_ERR: Error Interrupt + * @param NewState: new state of the CAN interrupts. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void CAN_ITConfig(CAN_TypeDef* CANx, uint32_t CAN_IT, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_CAN_ALL_PERIPH(CANx)); + assert_param(IS_CAN_IT(CAN_IT)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the selected CANx interrupt */ + CANx->IER |= CAN_IT; + } + else + { + /* Disable the selected CANx interrupt */ + CANx->IER &= ~CAN_IT; + } +} +/** + * @brief Checks whether the specified CAN flag is set or not. + * @param CANx: where x can be 1 or 2 to to select the CAN peripheral. + * @param CAN_FLAG: specifies the flag to check. + * This parameter can be one of the following values: + * @arg CAN_FLAG_RQCP0: Request MailBox0 Flag + * @arg CAN_FLAG_RQCP1: Request MailBox1 Flag + * @arg CAN_FLAG_RQCP2: Request MailBox2 Flag + * @arg CAN_FLAG_FMP0: FIFO 0 Message Pending Flag + * @arg CAN_FLAG_FF0: FIFO 0 Full Flag + * @arg CAN_FLAG_FOV0: FIFO 0 Overrun Flag + * @arg CAN_FLAG_FMP1: FIFO 1 Message Pending Flag + * @arg CAN_FLAG_FF1: FIFO 1 Full Flag + * @arg CAN_FLAG_FOV1: FIFO 1 Overrun Flag + * @arg CAN_FLAG_WKU: Wake up Flag + * @arg CAN_FLAG_SLAK: Sleep acknowledge Flag + * @arg CAN_FLAG_EWG: Error Warning Flag + * @arg CAN_FLAG_EPV: Error Passive Flag + * @arg CAN_FLAG_BOF: Bus-Off Flag + * @arg CAN_FLAG_LEC: Last error code Flag + * @retval The new state of CAN_FLAG (SET or RESET). + */ +FlagStatus CAN_GetFlagStatus(CAN_TypeDef* CANx, uint32_t CAN_FLAG) +{ + FlagStatus bitstatus = RESET; + + /* Check the parameters */ + assert_param(IS_CAN_ALL_PERIPH(CANx)); + assert_param(IS_CAN_GET_FLAG(CAN_FLAG)); + + + if((CAN_FLAG & CAN_FLAGS_ESR) != (uint32_t)RESET) + { + /* Check the status of the specified CAN flag */ + if ((CANx->ESR & (CAN_FLAG & 0x000FFFFF)) != (uint32_t)RESET) + { + /* CAN_FLAG is set */ + bitstatus = SET; + } + else + { + /* CAN_FLAG is reset */ + bitstatus = RESET; + } + } + else if((CAN_FLAG & CAN_FLAGS_MSR) != (uint32_t)RESET) + { + /* Check the status of the specified CAN flag */ + if ((CANx->MSR & (CAN_FLAG & 0x000FFFFF)) != (uint32_t)RESET) + { + /* CAN_FLAG is set */ + bitstatus = SET; + } + else + { + /* CAN_FLAG is reset */ + bitstatus = RESET; + } + } + else if((CAN_FLAG & CAN_FLAGS_TSR) != (uint32_t)RESET) + { + /* Check the status of the specified CAN flag */ + if ((CANx->TSR & (CAN_FLAG & 0x000FFFFF)) != (uint32_t)RESET) + { + /* CAN_FLAG is set */ + bitstatus = SET; + } + else + { + /* CAN_FLAG is reset */ + bitstatus = RESET; + } + } + else if((CAN_FLAG & CAN_FLAGS_RF0R) != (uint32_t)RESET) + { + /* Check the status of the specified CAN flag */ + if ((CANx->RF0R & (CAN_FLAG & 0x000FFFFF)) != (uint32_t)RESET) + { + /* CAN_FLAG is set */ + bitstatus = SET; + } + else + { + /* CAN_FLAG is reset */ + bitstatus = RESET; + } + } + else /* If(CAN_FLAG & CAN_FLAGS_RF1R != (uint32_t)RESET) */ + { + /* Check the status of the specified CAN flag */ + if ((uint32_t)(CANx->RF1R & (CAN_FLAG & 0x000FFFFF)) != (uint32_t)RESET) + { + /* CAN_FLAG is set */ + bitstatus = SET; + } + else + { + /* CAN_FLAG is reset */ + bitstatus = RESET; + } + } + /* Return the CAN_FLAG status */ + return bitstatus; +} + +/** + * @brief Clears the CAN's pending flags. + * @param CANx: where x can be 1 or 2 to to select the CAN peripheral. + * @param CAN_FLAG: specifies the flag to clear. + * This parameter can be one of the following values: + * @arg CAN_FLAG_RQCP0: Request MailBox0 Flag + * @arg CAN_FLAG_RQCP1: Request MailBox1 Flag + * @arg CAN_FLAG_RQCP2: Request MailBox2 Flag + * @arg CAN_FLAG_FF0: FIFO 0 Full Flag + * @arg CAN_FLAG_FOV0: FIFO 0 Overrun Flag + * @arg CAN_FLAG_FF1: FIFO 1 Full Flag + * @arg CAN_FLAG_FOV1: FIFO 1 Overrun Flag + * @arg CAN_FLAG_WKU: Wake up Flag + * @arg CAN_FLAG_SLAK: Sleep acknowledge Flag + * @arg CAN_FLAG_LEC: Last error code Flag + * @retval None + */ +void CAN_ClearFlag(CAN_TypeDef* CANx, uint32_t CAN_FLAG) +{ + uint32_t flagtmp=0; + /* Check the parameters */ + assert_param(IS_CAN_ALL_PERIPH(CANx)); + assert_param(IS_CAN_CLEAR_FLAG(CAN_FLAG)); + + if (CAN_FLAG == CAN_FLAG_LEC) /* ESR register */ + { + /* Clear the selected CAN flags */ + CANx->ESR = (uint32_t)RESET; + } + else /* MSR or TSR or RF0R or RF1R */ + { + flagtmp = CAN_FLAG & 0x000FFFFF; + + if ((CAN_FLAG & CAN_FLAGS_RF0R)!=(uint32_t)RESET) + { + /* Receive Flags */ + CANx->RF0R = (uint32_t)(flagtmp); + } + else if ((CAN_FLAG & CAN_FLAGS_RF1R)!=(uint32_t)RESET) + { + /* Receive Flags */ + CANx->RF1R = (uint32_t)(flagtmp); + } + else if ((CAN_FLAG & CAN_FLAGS_TSR)!=(uint32_t)RESET) + { + /* Transmit Flags */ + CANx->TSR = (uint32_t)(flagtmp); + } + else /* If((CAN_FLAG & CAN_FLAGS_MSR)!=(uint32_t)RESET) */ + { + /* Operating mode Flags */ + CANx->MSR = (uint32_t)(flagtmp); + } + } +} + +/** + * @brief Checks whether the specified CANx interrupt has occurred or not. + * @param CANx: where x can be 1 or 2 to to select the CAN peripheral. + * @param CAN_IT: specifies the CAN interrupt source to check. + * This parameter can be one of the following values: + * @arg CAN_IT_TME: Transmit mailbox empty Interrupt + * @arg CAN_IT_FMP0: FIFO 0 message pending Interrupt + * @arg CAN_IT_FF0: FIFO 0 full Interrupt + * @arg CAN_IT_FOV0: FIFO 0 overrun Interrupt + * @arg CAN_IT_FMP1: FIFO 1 message pending Interrupt + * @arg CAN_IT_FF1: FIFO 1 full Interrupt + * @arg CAN_IT_FOV1: FIFO 1 overrun Interrupt + * @arg CAN_IT_WKU: Wake-up Interrupt + * @arg CAN_IT_SLK: Sleep acknowledge Interrupt + * @arg CAN_IT_EWG: Error warning Interrupt + * @arg CAN_IT_EPV: Error passive Interrupt + * @arg CAN_IT_BOF: Bus-off Interrupt + * @arg CAN_IT_LEC: Last error code Interrupt + * @arg CAN_IT_ERR: Error Interrupt + * @retval The current state of CAN_IT (SET or RESET). + */ +ITStatus CAN_GetITStatus(CAN_TypeDef* CANx, uint32_t CAN_IT) +{ + ITStatus itstatus = RESET; + /* Check the parameters */ + assert_param(IS_CAN_ALL_PERIPH(CANx)); + assert_param(IS_CAN_IT(CAN_IT)); + + /* check the interrupt enable bit */ + if((CANx->IER & CAN_IT) != RESET) + { + /* in case the Interrupt is enabled, .... */ + switch (CAN_IT) + { + case CAN_IT_TME: + /* Check CAN_TSR_RQCPx bits */ + itstatus = CheckITStatus(CANx->TSR, CAN_TSR_RQCP0|CAN_TSR_RQCP1|CAN_TSR_RQCP2); + break; + case CAN_IT_FMP0: + /* Check CAN_RF0R_FMP0 bit */ + itstatus = CheckITStatus(CANx->RF0R, CAN_RF0R_FMP0); + break; + case CAN_IT_FF0: + /* Check CAN_RF0R_FULL0 bit */ + itstatus = CheckITStatus(CANx->RF0R, CAN_RF0R_FULL0); + break; + case CAN_IT_FOV0: + /* Check CAN_RF0R_FOVR0 bit */ + itstatus = CheckITStatus(CANx->RF0R, CAN_RF0R_FOVR0); + break; + case CAN_IT_FMP1: + /* Check CAN_RF1R_FMP1 bit */ + itstatus = CheckITStatus(CANx->RF1R, CAN_RF1R_FMP1); + break; + case CAN_IT_FF1: + /* Check CAN_RF1R_FULL1 bit */ + itstatus = CheckITStatus(CANx->RF1R, CAN_RF1R_FULL1); + break; + case CAN_IT_FOV1: + /* Check CAN_RF1R_FOVR1 bit */ + itstatus = CheckITStatus(CANx->RF1R, CAN_RF1R_FOVR1); + break; + case CAN_IT_WKU: + /* Check CAN_MSR_WKUI bit */ + itstatus = CheckITStatus(CANx->MSR, CAN_MSR_WKUI); + break; + case CAN_IT_SLK: + /* Check CAN_MSR_SLAKI bit */ + itstatus = CheckITStatus(CANx->MSR, CAN_MSR_SLAKI); + break; + case CAN_IT_EWG: + /* Check CAN_ESR_EWGF bit */ + itstatus = CheckITStatus(CANx->ESR, CAN_ESR_EWGF); + break; + case CAN_IT_EPV: + /* Check CAN_ESR_EPVF bit */ + itstatus = CheckITStatus(CANx->ESR, CAN_ESR_EPVF); + break; + case CAN_IT_BOF: + /* Check CAN_ESR_BOFF bit */ + itstatus = CheckITStatus(CANx->ESR, CAN_ESR_BOFF); + break; + case CAN_IT_LEC: + /* Check CAN_ESR_LEC bit */ + itstatus = CheckITStatus(CANx->ESR, CAN_ESR_LEC); + break; + case CAN_IT_ERR: + /* Check CAN_MSR_ERRI bit */ + itstatus = CheckITStatus(CANx->MSR, CAN_MSR_ERRI); + break; + default: + /* in case of error, return RESET */ + itstatus = RESET; + break; + } + } + else + { + /* in case the Interrupt is not enabled, return RESET */ + itstatus = RESET; + } + + /* Return the CAN_IT status */ + return itstatus; +} + +/** + * @brief Clears the CANx's interrupt pending bits. + * @param CANx: where x can be 1 or 2 to to select the CAN peripheral. + * @param CAN_IT: specifies the interrupt pending bit to clear. + * This parameter can be one of the following values: + * @arg CAN_IT_TME: Transmit mailbox empty Interrupt + * @arg CAN_IT_FF0: FIFO 0 full Interrupt + * @arg CAN_IT_FOV0: FIFO 0 overrun Interrupt + * @arg CAN_IT_FF1: FIFO 1 full Interrupt + * @arg CAN_IT_FOV1: FIFO 1 overrun Interrupt + * @arg CAN_IT_WKU: Wake-up Interrupt + * @arg CAN_IT_SLK: Sleep acknowledge Interrupt + * @arg CAN_IT_EWG: Error warning Interrupt + * @arg CAN_IT_EPV: Error passive Interrupt + * @arg CAN_IT_BOF: Bus-off Interrupt + * @arg CAN_IT_LEC: Last error code Interrupt + * @arg CAN_IT_ERR: Error Interrupt + * @retval None + */ +void CAN_ClearITPendingBit(CAN_TypeDef* CANx, uint32_t CAN_IT) +{ + /* Check the parameters */ + assert_param(IS_CAN_ALL_PERIPH(CANx)); + assert_param(IS_CAN_CLEAR_IT(CAN_IT)); + + switch (CAN_IT) + { + case CAN_IT_TME: + /* Clear CAN_TSR_RQCPx (rc_w1)*/ + CANx->TSR = CAN_TSR_RQCP0|CAN_TSR_RQCP1|CAN_TSR_RQCP2; + break; + case CAN_IT_FF0: + /* Clear CAN_RF0R_FULL0 (rc_w1)*/ + CANx->RF0R = CAN_RF0R_FULL0; + break; + case CAN_IT_FOV0: + /* Clear CAN_RF0R_FOVR0 (rc_w1)*/ + CANx->RF0R = CAN_RF0R_FOVR0; + break; + case CAN_IT_FF1: + /* Clear CAN_RF1R_FULL1 (rc_w1)*/ + CANx->RF1R = CAN_RF1R_FULL1; + break; + case CAN_IT_FOV1: + /* Clear CAN_RF1R_FOVR1 (rc_w1)*/ + CANx->RF1R = CAN_RF1R_FOVR1; + break; + case CAN_IT_WKU: + /* Clear CAN_MSR_WKUI (rc_w1)*/ + CANx->MSR = CAN_MSR_WKUI; + break; + case CAN_IT_SLK: + /* Clear CAN_MSR_SLAKI (rc_w1)*/ + CANx->MSR = CAN_MSR_SLAKI; + break; + case CAN_IT_EWG: + /* Clear CAN_MSR_ERRI (rc_w1) */ + CANx->MSR = CAN_MSR_ERRI; + /* @note the corresponding Flag is cleared by hardware depending on the CAN Bus status*/ + break; + case CAN_IT_EPV: + /* Clear CAN_MSR_ERRI (rc_w1) */ + CANx->MSR = CAN_MSR_ERRI; + /* @note the corresponding Flag is cleared by hardware depending on the CAN Bus status*/ + break; + case CAN_IT_BOF: + /* Clear CAN_MSR_ERRI (rc_w1) */ + CANx->MSR = CAN_MSR_ERRI; + /* @note the corresponding Flag is cleared by hardware depending on the CAN Bus status*/ + break; + case CAN_IT_LEC: + /* Clear LEC bits */ + CANx->ESR = RESET; + /* Clear CAN_MSR_ERRI (rc_w1) */ + CANx->MSR = CAN_MSR_ERRI; + break; + case CAN_IT_ERR: + /*Clear LEC bits */ + CANx->ESR = RESET; + /* Clear CAN_MSR_ERRI (rc_w1) */ + CANx->MSR = CAN_MSR_ERRI; + /* @note BOFF, EPVF and EWGF Flags are cleared by hardware depending on the CAN Bus status*/ + break; + default: + break; + } +} + /** + * @} + */ + +/** + * @brief Checks whether the CAN interrupt has occurred or not. + * @param CAN_Reg: specifies the CAN interrupt register to check. + * @param It_Bit: specifies the interrupt source bit to check. + * @retval The new state of the CAN Interrupt (SET or RESET). + */ +static ITStatus CheckITStatus(uint32_t CAN_Reg, uint32_t It_Bit) +{ + ITStatus pendingbitstatus = RESET; + + if ((CAN_Reg & It_Bit) != (uint32_t)RESET) + { + /* CAN_IT is set */ + pendingbitstatus = SET; + } + else + { + /* CAN_IT is reset */ + pendingbitstatus = RESET; + } + return pendingbitstatus; +} + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/src/stm32f4xx_crc.c b/FWLIB/src/stm32f4xx_crc.c new file mode 100644 index 0000000..ac420ec --- /dev/null +++ b/FWLIB/src/stm32f4xx_crc.c @@ -0,0 +1,133 @@ +/** + ****************************************************************************** + * @file stm32f4xx_crc.c + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file provides all the CRC firmware functions. + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx_crc.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @defgroup CRC + * @brief CRC driver modules + * @{ + */ + +/* Private typedef -----------------------------------------------------------*/ +/* Private define ------------------------------------------------------------*/ +/* Private macro -------------------------------------------------------------*/ +/* Private variables ---------------------------------------------------------*/ +/* Private function prototypes -----------------------------------------------*/ +/* Private functions ---------------------------------------------------------*/ + +/** @defgroup CRC_Private_Functions + * @{ + */ + +/** + * @brief Resets the CRC Data register (DR). + * @param None + * @retval None + */ +void CRC_ResetDR(void) +{ + /* Reset CRC generator */ + CRC->CR = CRC_CR_RESET; +} + +/** + * @brief Computes the 32-bit CRC of a given data word(32-bit). + * @param Data: data word(32-bit) to compute its CRC + * @retval 32-bit CRC + */ +uint32_t CRC_CalcCRC(uint32_t Data) +{ + CRC->DR = Data; + + return (CRC->DR); +} + +/** + * @brief Computes the 32-bit CRC of a given buffer of data word(32-bit). + * @param pBuffer: pointer to the buffer containing the data to be computed + * @param BufferLength: length of the buffer to be computed + * @retval 32-bit CRC + */ +uint32_t CRC_CalcBlockCRC(uint32_t pBuffer[], uint32_t BufferLength) +{ + uint32_t index = 0; + + for(index = 0; index < BufferLength; index++) + { + CRC->DR = pBuffer[index]; + } + return (CRC->DR); +} + +/** + * @brief Returns the current CRC value. + * @param None + * @retval 32-bit CRC + */ +uint32_t CRC_GetCRC(void) +{ + return (CRC->DR); +} + +/** + * @brief Stores a 8-bit data in the Independent Data(ID) register. + * @param IDValue: 8-bit value to be stored in the ID register + * @retval None + */ +void CRC_SetIDRegister(uint8_t IDValue) +{ + CRC->IDR = IDValue; +} + +/** + * @brief Returns the 8-bit data stored in the Independent Data(ID) register + * @param None + * @retval 8-bit value of the ID register + */ +uint8_t CRC_GetIDRegister(void) +{ + return (CRC->IDR); +} + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/src/stm32f4xx_cryp.c b/FWLIB/src/stm32f4xx_cryp.c new file mode 100644 index 0000000..548caec --- /dev/null +++ b/FWLIB/src/stm32f4xx_cryp.c @@ -0,0 +1,934 @@ +/** + ****************************************************************************** + * @file stm32f4xx_cryp.c + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file provides firmware functions to manage the following + * functionalities of the Cryptographic processor (CRYP) peripheral: + * + Initialization and Configuration functions + * + Data treatment functions + * + Context swapping functions + * + DMA interface function + * + Interrupts and flags management + * +@verbatim + =================================================================== + ##### How to use this driver ##### + =================================================================== + [..] + (#) Enable the CRYP controller clock using + RCC_AHB2PeriphClockCmd(RCC_AHB2Periph_CRYP, ENABLE); function. + + (#) Initialise the CRYP using CRYP_Init(), CRYP_KeyInit() and if needed + CRYP_IVInit(). + + (#) Flush the IN and OUT FIFOs by using CRYP_FIFOFlush() function. + + (#) Enable the CRYP controller using the CRYP_Cmd() function. + + (#) If using DMA for Data input and output transfer, activate the needed DMA + Requests using CRYP_DMACmd() function + + (#) If DMA is not used for data transfer, use CRYP_DataIn() and CRYP_DataOut() + functions to enter data to IN FIFO and get result from OUT FIFO. + + (#) To control CRYP events you can use one of the following two methods: + (++) Check on CRYP flags using the CRYP_GetFlagStatus() function. + (++) Use CRYP interrupts through the function CRYP_ITConfig() at + initialization phase and CRYP_GetITStatus() function into interrupt + routines in processing phase. + + (#) Save and restore Cryptographic processor context using CRYP_SaveContext() + and CRYP_RestoreContext() functions. + + + *** Procedure to perform an encryption or a decryption *** + ========================================================== + + *** Initialization *** + ====================== + [..] + (#) Initialize the peripheral using CRYP_Init(), CRYP_KeyInit() and CRYP_IVInit + functions: + (++) Configure the key size (128-, 192- or 256-bit, in the AES only) + (++) Enter the symmetric key + (++) Configure the data type + (++) In case of decryption in AES-ECB or AES-CBC, you must prepare + the key: configure the key preparation mode. Then Enable the CRYP + peripheral using CRYP_Cmd() function: the BUSY flag is set. + Wait until BUSY flag is reset : the key is prepared for decryption + (++) Configure the algorithm and chaining (the DES/TDES in ECB/CBC, the + AES in ECB/CBC/CTR) + (++) Configure the direction (encryption/decryption). + (++) Write the initialization vectors (in CBC or CTR modes only) + + (#) Flush the IN and OUT FIFOs using the CRYP_FIFOFlush() function + + + *** Basic Processing mode (polling mode) *** + ============================================ + [..] + (#) Enable the cryptographic processor using CRYP_Cmd() function. + + (#) Write the first blocks in the input FIFO (2 to 8 words) using + CRYP_DataIn() function. + + (#) Repeat the following sequence until the complete message has been + processed: + + (++) Wait for flag CRYP_FLAG_OFNE occurs (using CRYP_GetFlagStatus() + function), then read the OUT-FIFO using CRYP_DataOut() function + (1 block or until the FIFO is empty) + + (++) Wait for flag CRYP_FLAG_IFNF occurs, (using CRYP_GetFlagStatus() + function then write the IN FIFO using CRYP_DataIn() function + (1 block or until the FIFO is full) + + (#) At the end of the processing, CRYP_FLAG_BUSY flag will be reset and + both FIFOs are empty (CRYP_FLAG_IFEM is set and CRYP_FLAG_OFNE is + reset). You can disable the peripheral using CRYP_Cmd() function. + + *** Interrupts Processing mode *** + ================================== + [..] In this mode, Processing is done when the data are transferred by the + CPU during interrupts. + + (#) Enable the interrupts CRYP_IT_INI and CRYP_IT_OUTI using CRYP_ITConfig() + function. + + (#) Enable the cryptographic processor using CRYP_Cmd() function. + + (#) In the CRYP_IT_INI interrupt handler : load the input message into the + IN FIFO using CRYP_DataIn() function . You can load 2 or 4 words at a + time, or load data until the IN FIFO is full. When the last word of + the message has been entered into the IN FIFO, disable the CRYP_IT_INI + interrupt (using CRYP_ITConfig() function). + + (#) In the CRYP_IT_OUTI interrupt handler : read the output message from + the OUT FIFO using CRYP_DataOut() function. You can read 1 block (2 or + 4 words) at a time or read data until the FIFO is empty. + When the last word has been read, INIM=0, BUSY=0 and both FIFOs are + empty (CRYP_FLAG_IFEM is set and CRYP_FLAG_OFNE is reset). + You can disable the CRYP_IT_OUTI interrupt (using CRYP_ITConfig() + function) and you can disable the peripheral using CRYP_Cmd() function. + + *** DMA Processing mode *** + =========================== + [..] In this mode, Processing is done when the DMA is used to transfer the + data from/to the memory. + + (#) Configure the DMA controller to transfer the input data from the + memory using DMA_Init() function. + The transfer length is the length of the message. + As message padding is not managed by the peripheral, the message + length must be an entire number of blocks. The data are transferred + in burst mode. The burst length is 4 words in the AES and 2 or 4 + words in the DES/TDES. The DMA should be configured to set an + interrupt on transfer completion of the output data to indicate that + the processing is finished. + Refer to DMA peripheral driver for more details. + + (#) Enable the cryptographic processor using CRYP_Cmd() function. + Enable the DMA requests CRYP_DMAReq_DataIN and CRYP_DMAReq_DataOUT + using CRYP_DMACmd() function. + + (#) All the transfers and processing are managed by the DMA and the + cryptographic processor. The DMA transfer complete interrupt indicates + that the processing is complete. Both FIFOs are normally empty and + CRYP_FLAG_BUSY flag is reset. + + @endverbatim + * + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx_cryp.h" +#include "stm32f4xx_rcc.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @defgroup CRYP + * @brief CRYP driver modules + * @{ + */ + +/* Private typedef -----------------------------------------------------------*/ +/* Private define ------------------------------------------------------------*/ +#define FLAG_MASK ((uint8_t)0x20) +#define MAX_TIMEOUT ((uint16_t)0xFFFF) + +/* Private macro -------------------------------------------------------------*/ +/* Private variables ---------------------------------------------------------*/ +/* Private function prototypes -----------------------------------------------*/ +/* Private functions ---------------------------------------------------------*/ + +/** @defgroup CRYP_Private_Functions + * @{ + */ + +/** @defgroup CRYP_Group1 Initialization and Configuration functions + * @brief Initialization and Configuration functions + * +@verbatim + =============================================================================== + ##### Initialization and Configuration functions ##### + =============================================================================== + [..] This section provides functions allowing to + (+) Initialize the cryptographic Processor using CRYP_Init() function + (++) Encrypt or Decrypt + (++) mode : TDES-ECB, TDES-CBC, + DES-ECB, DES-CBC, + AES-ECB, AES-CBC, AES-CTR, AES-Key, AES-GCM, AES-CCM + (++) DataType : 32-bit data, 16-bit data, bit data or bit-string + (++) Key Size (only in AES modes) + (+) Configure the Encrypt or Decrypt Key using CRYP_KeyInit() function + (+) Configure the Initialization Vectors(IV) for CBC and CTR modes using + CRYP_IVInit() function. + (+) Flushes the IN and OUT FIFOs : using CRYP_FIFOFlush() function. + (+) Enable or disable the CRYP Processor using CRYP_Cmd() function + +@endverbatim + * @{ + */ +/** + * @brief Deinitializes the CRYP peripheral registers to their default reset values + * @param None + * @retval None + */ +void CRYP_DeInit(void) +{ + /* Enable CRYP reset state */ + RCC_AHB2PeriphResetCmd(RCC_AHB2Periph_CRYP, ENABLE); + + /* Release CRYP from reset state */ + RCC_AHB2PeriphResetCmd(RCC_AHB2Periph_CRYP, DISABLE); +} + +/** + * @brief Initializes the CRYP peripheral according to the specified parameters + * in the CRYP_InitStruct. + * @param CRYP_InitStruct: pointer to a CRYP_InitTypeDef structure that contains + * the configuration information for the CRYP peripheral. + * @retval None + */ +void CRYP_Init(CRYP_InitTypeDef* CRYP_InitStruct) +{ + /* Check the parameters */ + assert_param(IS_CRYP_ALGOMODE(CRYP_InitStruct->CRYP_AlgoMode)); + assert_param(IS_CRYP_DATATYPE(CRYP_InitStruct->CRYP_DataType)); + assert_param(IS_CRYP_ALGODIR(CRYP_InitStruct->CRYP_AlgoDir)); + + /* Select Algorithm mode*/ + CRYP->CR &= ~CRYP_CR_ALGOMODE; + CRYP->CR |= CRYP_InitStruct->CRYP_AlgoMode; + + /* Select dataType */ + CRYP->CR &= ~CRYP_CR_DATATYPE; + CRYP->CR |= CRYP_InitStruct->CRYP_DataType; + + /* select Key size (used only with AES algorithm) */ + if ((CRYP_InitStruct->CRYP_AlgoMode != CRYP_AlgoMode_TDES_ECB) && + (CRYP_InitStruct->CRYP_AlgoMode != CRYP_AlgoMode_TDES_CBC) && + (CRYP_InitStruct->CRYP_AlgoMode != CRYP_AlgoMode_DES_ECB) && + (CRYP_InitStruct->CRYP_AlgoMode != CRYP_AlgoMode_DES_CBC)) + { + assert_param(IS_CRYP_KEYSIZE(CRYP_InitStruct->CRYP_KeySize)); + CRYP->CR &= ~CRYP_CR_KEYSIZE; + CRYP->CR |= CRYP_InitStruct->CRYP_KeySize; /* Key size and value must be + configured once the key has + been prepared */ + } + + /* Select data Direction */ + CRYP->CR &= ~CRYP_CR_ALGODIR; + CRYP->CR |= CRYP_InitStruct->CRYP_AlgoDir; +} + +/** + * @brief Fills each CRYP_InitStruct member with its default value. + * @param CRYP_InitStruct: pointer to a CRYP_InitTypeDef structure which will + * be initialized. + * @retval None + */ +void CRYP_StructInit(CRYP_InitTypeDef* CRYP_InitStruct) +{ + /* Initialize the CRYP_AlgoDir member */ + CRYP_InitStruct->CRYP_AlgoDir = CRYP_AlgoDir_Encrypt; + + /* initialize the CRYP_AlgoMode member */ + CRYP_InitStruct->CRYP_AlgoMode = CRYP_AlgoMode_TDES_ECB; + + /* initialize the CRYP_DataType member */ + CRYP_InitStruct->CRYP_DataType = CRYP_DataType_32b; + + /* Initialize the CRYP_KeySize member */ + CRYP_InitStruct->CRYP_KeySize = CRYP_KeySize_128b; +} + +/** + * @brief Initializes the CRYP Keys according to the specified parameters in + * the CRYP_KeyInitStruct. + * @param CRYP_KeyInitStruct: pointer to a CRYP_KeyInitTypeDef structure that + * contains the configuration information for the CRYP Keys. + * @retval None + */ +void CRYP_KeyInit(CRYP_KeyInitTypeDef* CRYP_KeyInitStruct) +{ + /* Key Initialisation */ + CRYP->K0LR = CRYP_KeyInitStruct->CRYP_Key0Left; + CRYP->K0RR = CRYP_KeyInitStruct->CRYP_Key0Right; + CRYP->K1LR = CRYP_KeyInitStruct->CRYP_Key1Left; + CRYP->K1RR = CRYP_KeyInitStruct->CRYP_Key1Right; + CRYP->K2LR = CRYP_KeyInitStruct->CRYP_Key2Left; + CRYP->K2RR = CRYP_KeyInitStruct->CRYP_Key2Right; + CRYP->K3LR = CRYP_KeyInitStruct->CRYP_Key3Left; + CRYP->K3RR = CRYP_KeyInitStruct->CRYP_Key3Right; +} + +/** + * @brief Fills each CRYP_KeyInitStruct member with its default value. + * @param CRYP_KeyInitStruct: pointer to a CRYP_KeyInitTypeDef structure + * which will be initialized. + * @retval None + */ +void CRYP_KeyStructInit(CRYP_KeyInitTypeDef* CRYP_KeyInitStruct) +{ + CRYP_KeyInitStruct->CRYP_Key0Left = 0; + CRYP_KeyInitStruct->CRYP_Key0Right = 0; + CRYP_KeyInitStruct->CRYP_Key1Left = 0; + CRYP_KeyInitStruct->CRYP_Key1Right = 0; + CRYP_KeyInitStruct->CRYP_Key2Left = 0; + CRYP_KeyInitStruct->CRYP_Key2Right = 0; + CRYP_KeyInitStruct->CRYP_Key3Left = 0; + CRYP_KeyInitStruct->CRYP_Key3Right = 0; +} +/** + * @brief Initializes the CRYP Initialization Vectors(IV) according to the + * specified parameters in the CRYP_IVInitStruct. + * @param CRYP_IVInitStruct: pointer to a CRYP_IVInitTypeDef structure that contains + * the configuration information for the CRYP Initialization Vectors(IV). + * @retval None + */ +void CRYP_IVInit(CRYP_IVInitTypeDef* CRYP_IVInitStruct) +{ + CRYP->IV0LR = CRYP_IVInitStruct->CRYP_IV0Left; + CRYP->IV0RR = CRYP_IVInitStruct->CRYP_IV0Right; + CRYP->IV1LR = CRYP_IVInitStruct->CRYP_IV1Left; + CRYP->IV1RR = CRYP_IVInitStruct->CRYP_IV1Right; +} + +/** + * @brief Fills each CRYP_IVInitStruct member with its default value. + * @param CRYP_IVInitStruct: pointer to a CRYP_IVInitTypeDef Initialization + * Vectors(IV) structure which will be initialized. + * @retval None + */ +void CRYP_IVStructInit(CRYP_IVInitTypeDef* CRYP_IVInitStruct) +{ + CRYP_IVInitStruct->CRYP_IV0Left = 0; + CRYP_IVInitStruct->CRYP_IV0Right = 0; + CRYP_IVInitStruct->CRYP_IV1Left = 0; + CRYP_IVInitStruct->CRYP_IV1Right = 0; +} + +/** + * @brief Configures the AES-CCM and AES-GCM phases + * @note This function is used only with AES-CCM or AES-GCM Algorithms + * @param CRYP_Phase: specifies the CRYP AES-CCM and AES-GCM phase to be configured. + * This parameter can be one of the following values: + * @arg CRYP_Phase_Init: Initialization phase + * @arg CRYP_Phase_Header: Header phase + * @arg CRYP_Phase_Payload: Payload phase + * @arg CRYP_Phase_Final: Final phase + * @retval None + */ +void CRYP_PhaseConfig(uint32_t CRYP_Phase) +{ uint32_t tempcr = 0; + + /* Check the parameter */ + assert_param(IS_CRYP_PHASE(CRYP_Phase)); + + /* Get the CR register */ + tempcr = CRYP->CR; + + /* Reset the phase configuration bits: GCMP_CCMPH */ + tempcr &= (uint32_t)(~CRYP_CR_GCM_CCMPH); + /* Set the selected phase */ + tempcr |= (uint32_t)CRYP_Phase; + + /* Set the CR register */ + CRYP->CR = tempcr; +} + +/** + * @brief Flushes the IN and OUT FIFOs (that is read and write pointers of the + * FIFOs are reset) + * @note The FIFOs must be flushed only when BUSY flag is reset. + * @param None + * @retval None + */ +void CRYP_FIFOFlush(void) +{ + /* Reset the read and write pointers of the FIFOs */ + CRYP->CR |= CRYP_CR_FFLUSH; +} + +/** + * @brief Enables or disables the CRYP peripheral. + * @param NewState: new state of the CRYP peripheral. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void CRYP_Cmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the Cryptographic processor */ + CRYP->CR |= CRYP_CR_CRYPEN; + } + else + { + /* Disable the Cryptographic processor */ + CRYP->CR &= ~CRYP_CR_CRYPEN; + } +} +/** + * @} + */ + +/** @defgroup CRYP_Group2 CRYP Data processing functions + * @brief CRYP Data processing functions + * +@verbatim + =============================================================================== + ##### CRYP Data processing functions ##### + =============================================================================== + [..] This section provides functions allowing the encryption and decryption + operations: + (+) Enter data to be treated in the IN FIFO : using CRYP_DataIn() function. + (+) Get the data result from the OUT FIFO : using CRYP_DataOut() function. + +@endverbatim + * @{ + */ + +/** + * @brief Writes data in the Data Input register (DIN). + * @note After the DIN register has been read once or several times, + * the FIFO must be flushed (using CRYP_FIFOFlush() function). + * @param Data: data to write in Data Input register + * @retval None + */ +void CRYP_DataIn(uint32_t Data) +{ + CRYP->DR = Data; +} + +/** + * @brief Returns the last data entered into the output FIFO. + * @param None + * @retval Last data entered into the output FIFO. + */ +uint32_t CRYP_DataOut(void) +{ + return CRYP->DOUT; +} +/** + * @} + */ + +/** @defgroup CRYP_Group3 Context swapping functions + * @brief Context swapping functions + * +@verbatim + =============================================================================== + ##### Context swapping functions ##### + =============================================================================== + [..] This section provides functions allowing to save and store CRYP Context + + [..] It is possible to interrupt an encryption/ decryption/ key generation process + to perform another processing with a higher priority, and to complete the + interrupted process later on, when the higher-priority task is complete. To do + so, the context of the interrupted task must be saved from the CRYP registers + to memory, and then be restored from memory to the CRYP registers. + + (#) To save the current context, use CRYP_SaveContext() function + (#) To restore the saved context, use CRYP_RestoreContext() function + +@endverbatim + * @{ + */ + +/** + * @brief Saves the CRYP peripheral Context. + * @note This function stops DMA transfer before to save the context. After + * restoring the context, you have to enable the DMA again (if the DMA + * was previously used). + * @param CRYP_ContextSave: pointer to a CRYP_Context structure that contains + * the repository for current context. + * @param CRYP_KeyInitStruct: pointer to a CRYP_KeyInitTypeDef structure that + * contains the configuration information for the CRYP Keys. + * @retval None + */ +ErrorStatus CRYP_SaveContext(CRYP_Context* CRYP_ContextSave, + CRYP_KeyInitTypeDef* CRYP_KeyInitStruct) +{ + __IO uint32_t timeout = 0; + uint32_t ckeckmask = 0, bitstatus; + ErrorStatus status = ERROR; + + /* Stop DMA transfers on the IN FIFO by clearing the DIEN bit in the CRYP_DMACR */ + CRYP->DMACR &= ~(uint32_t)CRYP_DMACR_DIEN; + + /* Wait until both the IN and OUT FIFOs are empty + (IFEM=1 and OFNE=0 in the CRYP_SR register) and the + BUSY bit is cleared. */ + + if ((CRYP->CR & (uint32_t)(CRYP_CR_ALGOMODE_TDES_ECB | CRYP_CR_ALGOMODE_TDES_CBC)) != (uint32_t)0 )/* TDES */ + { + ckeckmask = CRYP_SR_IFEM | CRYP_SR_BUSY ; + } + else /* AES or DES */ + { + ckeckmask = CRYP_SR_IFEM | CRYP_SR_BUSY | CRYP_SR_OFNE; + } + + do + { + bitstatus = CRYP->SR & ckeckmask; + timeout++; + } + while ((timeout != MAX_TIMEOUT) && (bitstatus != CRYP_SR_IFEM)); + + if ((CRYP->SR & ckeckmask) != CRYP_SR_IFEM) + { + status = ERROR; + } + else + { + /* Stop DMA transfers on the OUT FIFO by + - writing the DOEN bit to 0 in the CRYP_DMACR register + - and clear the CRYPEN bit. */ + + CRYP->DMACR &= ~(uint32_t)CRYP_DMACR_DOEN; + CRYP->CR &= ~(uint32_t)CRYP_CR_CRYPEN; + + /* Save the current configuration (bit 19, bit[17:16] and bits [9:2] in the CRYP_CR register) */ + CRYP_ContextSave->CR_CurrentConfig = CRYP->CR & (CRYP_CR_GCM_CCMPH | + CRYP_CR_KEYSIZE | + CRYP_CR_DATATYPE | + CRYP_CR_ALGOMODE | + CRYP_CR_ALGODIR); + + /* and, if not in ECB mode, the initialization vectors. */ + CRYP_ContextSave->CRYP_IV0LR = CRYP->IV0LR; + CRYP_ContextSave->CRYP_IV0RR = CRYP->IV0RR; + CRYP_ContextSave->CRYP_IV1LR = CRYP->IV1LR; + CRYP_ContextSave->CRYP_IV1RR = CRYP->IV1RR; + + /* save The key value */ + CRYP_ContextSave->CRYP_K0LR = CRYP_KeyInitStruct->CRYP_Key0Left; + CRYP_ContextSave->CRYP_K0RR = CRYP_KeyInitStruct->CRYP_Key0Right; + CRYP_ContextSave->CRYP_K1LR = CRYP_KeyInitStruct->CRYP_Key1Left; + CRYP_ContextSave->CRYP_K1RR = CRYP_KeyInitStruct->CRYP_Key1Right; + CRYP_ContextSave->CRYP_K2LR = CRYP_KeyInitStruct->CRYP_Key2Left; + CRYP_ContextSave->CRYP_K2RR = CRYP_KeyInitStruct->CRYP_Key2Right; + CRYP_ContextSave->CRYP_K3LR = CRYP_KeyInitStruct->CRYP_Key3Left; + CRYP_ContextSave->CRYP_K3RR = CRYP_KeyInitStruct->CRYP_Key3Right; + + /* Save the content of context swap registers */ + CRYP_ContextSave->CRYP_CSGCMCCMR[0] = CRYP->CSGCMCCM0R; + CRYP_ContextSave->CRYP_CSGCMCCMR[1] = CRYP->CSGCMCCM1R; + CRYP_ContextSave->CRYP_CSGCMCCMR[2] = CRYP->CSGCMCCM2R; + CRYP_ContextSave->CRYP_CSGCMCCMR[3] = CRYP->CSGCMCCM3R; + CRYP_ContextSave->CRYP_CSGCMCCMR[4] = CRYP->CSGCMCCM4R; + CRYP_ContextSave->CRYP_CSGCMCCMR[5] = CRYP->CSGCMCCM5R; + CRYP_ContextSave->CRYP_CSGCMCCMR[6] = CRYP->CSGCMCCM6R; + CRYP_ContextSave->CRYP_CSGCMCCMR[7] = CRYP->CSGCMCCM7R; + + CRYP_ContextSave->CRYP_CSGCMR[0] = CRYP->CSGCM0R; + CRYP_ContextSave->CRYP_CSGCMR[1] = CRYP->CSGCM1R; + CRYP_ContextSave->CRYP_CSGCMR[2] = CRYP->CSGCM2R; + CRYP_ContextSave->CRYP_CSGCMR[3] = CRYP->CSGCM3R; + CRYP_ContextSave->CRYP_CSGCMR[4] = CRYP->CSGCM4R; + CRYP_ContextSave->CRYP_CSGCMR[5] = CRYP->CSGCM5R; + CRYP_ContextSave->CRYP_CSGCMR[6] = CRYP->CSGCM6R; + CRYP_ContextSave->CRYP_CSGCMR[7] = CRYP->CSGCM7R; + + /* When needed, save the DMA status (pointers for IN and OUT messages, + number of remaining bytes, etc.) */ + + status = SUCCESS; + } + + return status; +} + +/** + * @brief Restores the CRYP peripheral Context. + * @note Since teh DMA transfer is stopped in CRYP_SaveContext() function, + * after restoring the context, you have to enable the DMA again (if the + * DMA was previously used). + * @param CRYP_ContextRestore: pointer to a CRYP_Context structure that contains + * the repository for saved context. + * @note The data that were saved during context saving must be rewrited into + * the IN FIFO. + * @retval None + */ +void CRYP_RestoreContext(CRYP_Context* CRYP_ContextRestore) +{ + + /* Configure the processor with the saved configuration */ + CRYP->CR = CRYP_ContextRestore->CR_CurrentConfig; + + /* restore The key value */ + CRYP->K0LR = CRYP_ContextRestore->CRYP_K0LR; + CRYP->K0RR = CRYP_ContextRestore->CRYP_K0RR; + CRYP->K1LR = CRYP_ContextRestore->CRYP_K1LR; + CRYP->K1RR = CRYP_ContextRestore->CRYP_K1RR; + CRYP->K2LR = CRYP_ContextRestore->CRYP_K2LR; + CRYP->K2RR = CRYP_ContextRestore->CRYP_K2RR; + CRYP->K3LR = CRYP_ContextRestore->CRYP_K3LR; + CRYP->K3RR = CRYP_ContextRestore->CRYP_K3RR; + + /* and the initialization vectors. */ + CRYP->IV0LR = CRYP_ContextRestore->CRYP_IV0LR; + CRYP->IV0RR = CRYP_ContextRestore->CRYP_IV0RR; + CRYP->IV1LR = CRYP_ContextRestore->CRYP_IV1LR; + CRYP->IV1RR = CRYP_ContextRestore->CRYP_IV1RR; + + /* Restore the content of context swap registers */ + CRYP->CSGCMCCM0R = CRYP_ContextRestore->CRYP_CSGCMCCMR[0]; + CRYP->CSGCMCCM1R = CRYP_ContextRestore->CRYP_CSGCMCCMR[1]; + CRYP->CSGCMCCM2R = CRYP_ContextRestore->CRYP_CSGCMCCMR[2]; + CRYP->CSGCMCCM3R = CRYP_ContextRestore->CRYP_CSGCMCCMR[3]; + CRYP->CSGCMCCM4R = CRYP_ContextRestore->CRYP_CSGCMCCMR[4]; + CRYP->CSGCMCCM5R = CRYP_ContextRestore->CRYP_CSGCMCCMR[5]; + CRYP->CSGCMCCM6R = CRYP_ContextRestore->CRYP_CSGCMCCMR[6]; + CRYP->CSGCMCCM7R = CRYP_ContextRestore->CRYP_CSGCMCCMR[7]; + + CRYP->CSGCM0R = CRYP_ContextRestore->CRYP_CSGCMR[0]; + CRYP->CSGCM1R = CRYP_ContextRestore->CRYP_CSGCMR[1]; + CRYP->CSGCM2R = CRYP_ContextRestore->CRYP_CSGCMR[2]; + CRYP->CSGCM3R = CRYP_ContextRestore->CRYP_CSGCMR[3]; + CRYP->CSGCM4R = CRYP_ContextRestore->CRYP_CSGCMR[4]; + CRYP->CSGCM5R = CRYP_ContextRestore->CRYP_CSGCMR[5]; + CRYP->CSGCM6R = CRYP_ContextRestore->CRYP_CSGCMR[6]; + CRYP->CSGCM7R = CRYP_ContextRestore->CRYP_CSGCMR[7]; + + /* Enable the cryptographic processor */ + CRYP->CR |= CRYP_CR_CRYPEN; +} +/** + * @} + */ + +/** @defgroup CRYP_Group4 CRYP's DMA interface Configuration function + * @brief CRYP's DMA interface Configuration function + * +@verbatim + =============================================================================== + ##### CRYP's DMA interface Configuration function ##### + =============================================================================== + [..] This section provides functions allowing to configure the DMA interface for + CRYP data input and output transfer. + + [..] When the DMA mode is enabled (using the CRYP_DMACmd() function), data can be + transferred: + (+) From memory to the CRYP IN FIFO using the DMA peripheral by enabling + the CRYP_DMAReq_DataIN request. + (+) From the CRYP OUT FIFO to the memory using the DMA peripheral by enabling + the CRYP_DMAReq_DataOUT request. + +@endverbatim + * @{ + */ + +/** + * @brief Enables or disables the CRYP DMA interface. + * @param CRYP_DMAReq: specifies the CRYP DMA transfer request to be enabled or disabled. + * This parameter can be any combination of the following values: + * @arg CRYP_DMAReq_DataOUT: DMA for outgoing(Tx) data transfer + * @arg CRYP_DMAReq_DataIN: DMA for incoming(Rx) data transfer + * @param NewState: new state of the selected CRYP DMA transfer request. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void CRYP_DMACmd(uint8_t CRYP_DMAReq, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_CRYP_DMAREQ(CRYP_DMAReq)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the selected CRYP DMA request */ + CRYP->DMACR |= CRYP_DMAReq; + } + else + { + /* Disable the selected CRYP DMA request */ + CRYP->DMACR &= (uint8_t)~CRYP_DMAReq; + } +} +/** + * @} + */ + +/** @defgroup CRYP_Group5 Interrupts and flags management functions + * @brief Interrupts and flags management functions + * +@verbatim + =============================================================================== + ##### Interrupts and flags management functions ##### + =============================================================================== + + [..] This section provides functions allowing to configure the CRYP Interrupts and + to get the status and Interrupts pending bits. + + [..] The CRYP provides 2 Interrupts sources and 7 Flags: + + *** Flags : *** + =============== + [..] + (#) CRYP_FLAG_IFEM : Set when Input FIFO is empty. This Flag is cleared only + by hardware. + + (#) CRYP_FLAG_IFNF : Set when Input FIFO is not full. This Flag is cleared + only by hardware. + + + (#) CRYP_FLAG_INRIS : Set when Input FIFO Raw interrupt is pending it gives + the raw interrupt state prior to masking of the input FIFO service interrupt. + This Flag is cleared only by hardware. + + (#) CRYP_FLAG_OFNE : Set when Output FIFO not empty. This Flag is cleared + only by hardware. + + (#) CRYP_FLAG_OFFU : Set when Output FIFO is full. This Flag is cleared only + by hardware. + + (#) CRYP_FLAG_OUTRIS : Set when Output FIFO Raw interrupt is pending it gives + the raw interrupt state prior to masking of the output FIFO service interrupt. + This Flag is cleared only by hardware. + + (#) CRYP_FLAG_BUSY : Set when the CRYP core is currently processing a block + of data or a key preparation (for AES decryption). This Flag is cleared + only by hardware. To clear it, the CRYP core must be disabled and the last + processing has completed. + + *** Interrupts : *** + ==================== + [..] + (#) CRYP_IT_INI : The input FIFO service interrupt is asserted when there + are less than 4 words in the input FIFO. This interrupt is associated to + CRYP_FLAG_INRIS flag. + + -@- This interrupt is cleared by performing write operations to the input FIFO + until it holds 4 or more words. The input FIFO service interrupt INMIS is + enabled with the CRYP enable bit. Consequently, when CRYP is disabled, the + INMIS signal is low even if the input FIFO is empty. + + + + (#) CRYP_IT_OUTI : The output FIFO service interrupt is asserted when there + is one or more (32-bit word) data items in the output FIFO. This interrupt + is associated to CRYP_FLAG_OUTRIS flag. + + -@- This interrupt is cleared by reading data from the output FIFO until there + is no valid (32-bit) word left (that is, the interrupt follows the state + of the OFNE (output FIFO not empty) flag). + + *** Managing the CRYP controller events : *** + ============================================= + [..] The user should identify which mode will be used in his application to manage + the CRYP controller events: Polling mode or Interrupt mode. + + (#) In the Polling Mode it is advised to use the following functions: + (++) CRYP_GetFlagStatus() : to check if flags events occur. + + -@@- The CRYPT flags do not need to be cleared since they are cleared as + soon as the associated event are reset. + + + (#) In the Interrupt Mode it is advised to use the following functions: + (++) CRYP_ITConfig() : to enable or disable the interrupt source. + (++) CRYP_GetITStatus() : to check if Interrupt occurs. + + -@@- The CRYPT interrupts have no pending bits, the interrupt is cleared as + soon as the associated event is reset. + +@endverbatim + * @{ + */ + +/** + * @brief Enables or disables the specified CRYP interrupts. + * @param CRYP_IT: specifies the CRYP interrupt source to be enabled or disabled. + * This parameter can be any combination of the following values: + * @arg CRYP_IT_INI: Input FIFO interrupt + * @arg CRYP_IT_OUTI: Output FIFO interrupt + * @param NewState: new state of the specified CRYP interrupt. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void CRYP_ITConfig(uint8_t CRYP_IT, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_CRYP_CONFIG_IT(CRYP_IT)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the selected CRYP interrupt */ + CRYP->IMSCR |= CRYP_IT; + } + else + { + /* Disable the selected CRYP interrupt */ + CRYP->IMSCR &= (uint8_t)~CRYP_IT; + } +} + +/** + * @brief Checks whether the specified CRYP interrupt has occurred or not. + * @note This function checks the status of the masked interrupt (i.e the + * interrupt should be previously enabled). + * @param CRYP_IT: specifies the CRYP (masked) interrupt source to check. + * This parameter can be one of the following values: + * @arg CRYP_IT_INI: Input FIFO interrupt + * @arg CRYP_IT_OUTI: Output FIFO interrupt + * @retval The new state of CRYP_IT (SET or RESET). + */ +ITStatus CRYP_GetITStatus(uint8_t CRYP_IT) +{ + ITStatus bitstatus = RESET; + /* Check the parameters */ + assert_param(IS_CRYP_GET_IT(CRYP_IT)); + + /* Check the status of the specified CRYP interrupt */ + if ((CRYP->MISR & CRYP_IT) != (uint8_t)RESET) + { + /* CRYP_IT is set */ + bitstatus = SET; + } + else + { + /* CRYP_IT is reset */ + bitstatus = RESET; + } + /* Return the CRYP_IT status */ + return bitstatus; +} + +/** + * @brief Returns whether CRYP peripheral is enabled or disabled. + * @param none. + * @retval Current state of the CRYP peripheral (ENABLE or DISABLE). + */ +FunctionalState CRYP_GetCmdStatus(void) +{ + FunctionalState state = DISABLE; + + if ((CRYP->CR & CRYP_CR_CRYPEN) != 0) + { + /* CRYPEN bit is set */ + state = ENABLE; + } + else + { + /* CRYPEN bit is reset */ + state = DISABLE; + } + return state; +} + +/** + * @brief Checks whether the specified CRYP flag is set or not. + * @param CRYP_FLAG: specifies the CRYP flag to check. + * This parameter can be one of the following values: + * @arg CRYP_FLAG_IFEM: Input FIFO Empty flag. + * @arg CRYP_FLAG_IFNF: Input FIFO Not Full flag. + * @arg CRYP_FLAG_OFNE: Output FIFO Not Empty flag. + * @arg CRYP_FLAG_OFFU: Output FIFO Full flag. + * @arg CRYP_FLAG_BUSY: Busy flag. + * @arg CRYP_FLAG_OUTRIS: Output FIFO raw interrupt flag. + * @arg CRYP_FLAG_INRIS: Input FIFO raw interrupt flag. + * @retval The new state of CRYP_FLAG (SET or RESET). + */ +FlagStatus CRYP_GetFlagStatus(uint8_t CRYP_FLAG) +{ + FlagStatus bitstatus = RESET; + uint32_t tempreg = 0; + + /* Check the parameters */ + assert_param(IS_CRYP_GET_FLAG(CRYP_FLAG)); + + /* check if the FLAG is in RISR register */ + if ((CRYP_FLAG & FLAG_MASK) != 0x00) + { + tempreg = CRYP->RISR; + } + else /* The FLAG is in SR register */ + { + tempreg = CRYP->SR; + } + + + /* Check the status of the specified CRYP flag */ + if ((tempreg & CRYP_FLAG ) != (uint8_t)RESET) + { + /* CRYP_FLAG is set */ + bitstatus = SET; + } + else + { + /* CRYP_FLAG is reset */ + bitstatus = RESET; + } + + /* Return the CRYP_FLAG status */ + return bitstatus; +} + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/src/stm32f4xx_cryp_aes.c b/FWLIB/src/stm32f4xx_cryp_aes.c new file mode 100644 index 0000000..af8d7d1 --- /dev/null +++ b/FWLIB/src/stm32f4xx_cryp_aes.c @@ -0,0 +1,1707 @@ +/** + ****************************************************************************** + * @file stm32f4xx_cryp_aes.c + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file provides high level functions to encrypt and decrypt an + * input message using AES in ECB/CBC/CTR/GCM/CCM modes. + * It uses the stm32f4xx_cryp.c/.h drivers to access the STM32F4xx CRYP + * peripheral. + * AES-ECB/CBC/CTR/GCM/CCM modes are available on STM32F437x Devices. + * For STM32F41xx Devices, only AES-ECB/CBC/CTR modes are available. + * +@verbatim + =================================================================== + ##### How to use this driver ##### + =================================================================== + [..] + (#) Enable The CRYP controller clock using + RCC_AHB2PeriphClockCmd(RCC_AHB2Periph_CRYP, ENABLE); function. + + (#) Encrypt and decrypt using AES in ECB Mode using CRYP_AES_ECB() function. + + (#) Encrypt and decrypt using AES in CBC Mode using CRYP_AES_CBC() function. + + (#) Encrypt and decrypt using AES in CTR Mode using CRYP_AES_CTR() function. + + (#) Encrypt and decrypt using AES in GCM Mode using CRYP_AES_GCM() function. + + (#) Encrypt and decrypt using AES in CCM Mode using CRYP_AES_CCM() function. + +@endverbatim + * + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx_cryp.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @defgroup CRYP + * @brief CRYP driver modules + * @{ + */ + +/* Private typedef -----------------------------------------------------------*/ +/* Private define ------------------------------------------------------------*/ +#define AESBUSY_TIMEOUT ((uint32_t) 0x00010000) + +/* Private macro -------------------------------------------------------------*/ +/* Private variables ---------------------------------------------------------*/ +/* Private function prototypes -----------------------------------------------*/ +/* Private functions ---------------------------------------------------------*/ + +/** @defgroup CRYP_Private_Functions + * @{ + */ + +/** @defgroup CRYP_Group6 High Level AES functions + * @brief High Level AES functions + * +@verbatim + =============================================================================== + ##### High Level AES functions ##### + =============================================================================== + +@endverbatim + * @{ + */ + +/** + * @brief Encrypt and decrypt using AES in ECB Mode + * @param Mode: encryption or decryption Mode. + * This parameter can be one of the following values: + * @arg MODE_ENCRYPT: Encryption + * @arg MODE_DECRYPT: Decryption + * @param Key: Key used for AES algorithm. + * @param Keysize: length of the Key, must be a 128, 192 or 256. + * @param Input: pointer to the Input buffer. + * @param Ilength: length of the Input buffer, must be a multiple of 16. + * @param Output: pointer to the returned buffer. + * @retval An ErrorStatus enumeration value: + * - SUCCESS: Operation done + * - ERROR: Operation failed + */ +ErrorStatus CRYP_AES_ECB(uint8_t Mode, uint8_t* Key, uint16_t Keysize, + uint8_t* Input, uint32_t Ilength, uint8_t* Output) +{ + CRYP_InitTypeDef AES_CRYP_InitStructure; + CRYP_KeyInitTypeDef AES_CRYP_KeyInitStructure; + __IO uint32_t counter = 0; + uint32_t busystatus = 0; + ErrorStatus status = SUCCESS; + uint32_t keyaddr = (uint32_t)Key; + uint32_t inputaddr = (uint32_t)Input; + uint32_t outputaddr = (uint32_t)Output; + uint32_t i = 0; + + /* Crypto structures initialisation*/ + CRYP_KeyStructInit(&AES_CRYP_KeyInitStructure); + + switch(Keysize) + { + case 128: + AES_CRYP_InitStructure.CRYP_KeySize = CRYP_KeySize_128b; + AES_CRYP_KeyInitStructure.CRYP_Key2Left = __REV(*(uint32_t*)(keyaddr)); + keyaddr+=4; + AES_CRYP_KeyInitStructure.CRYP_Key2Right= __REV(*(uint32_t*)(keyaddr)); + keyaddr+=4; + AES_CRYP_KeyInitStructure.CRYP_Key3Left = __REV(*(uint32_t*)(keyaddr)); + keyaddr+=4; + AES_CRYP_KeyInitStructure.CRYP_Key3Right= __REV(*(uint32_t*)(keyaddr)); + break; + case 192: + AES_CRYP_InitStructure.CRYP_KeySize = CRYP_KeySize_192b; + AES_CRYP_KeyInitStructure.CRYP_Key1Left = __REV(*(uint32_t*)(keyaddr)); + keyaddr+=4; + AES_CRYP_KeyInitStructure.CRYP_Key1Right= __REV(*(uint32_t*)(keyaddr)); + keyaddr+=4; + AES_CRYP_KeyInitStructure.CRYP_Key2Left = __REV(*(uint32_t*)(keyaddr)); + keyaddr+=4; + AES_CRYP_KeyInitStructure.CRYP_Key2Right= __REV(*(uint32_t*)(keyaddr)); + keyaddr+=4; + AES_CRYP_KeyInitStructure.CRYP_Key3Left = __REV(*(uint32_t*)(keyaddr)); + keyaddr+=4; + AES_CRYP_KeyInitStructure.CRYP_Key3Right= __REV(*(uint32_t*)(keyaddr)); + break; + case 256: + AES_CRYP_InitStructure.CRYP_KeySize = CRYP_KeySize_256b; + AES_CRYP_KeyInitStructure.CRYP_Key0Left = __REV(*(uint32_t*)(keyaddr)); + keyaddr+=4; + AES_CRYP_KeyInitStructure.CRYP_Key0Right= __REV(*(uint32_t*)(keyaddr)); + keyaddr+=4; + AES_CRYP_KeyInitStructure.CRYP_Key1Left = __REV(*(uint32_t*)(keyaddr)); + keyaddr+=4; + AES_CRYP_KeyInitStructure.CRYP_Key1Right= __REV(*(uint32_t*)(keyaddr)); + keyaddr+=4; + AES_CRYP_KeyInitStructure.CRYP_Key2Left = __REV(*(uint32_t*)(keyaddr)); + keyaddr+=4; + AES_CRYP_KeyInitStructure.CRYP_Key2Right= __REV(*(uint32_t*)(keyaddr)); + keyaddr+=4; + AES_CRYP_KeyInitStructure.CRYP_Key3Left = __REV(*(uint32_t*)(keyaddr)); + keyaddr+=4; + AES_CRYP_KeyInitStructure.CRYP_Key3Right= __REV(*(uint32_t*)(keyaddr)); + break; + default: + break; + } + + /*------------------ AES Decryption ------------------*/ + if(Mode == MODE_DECRYPT) /* AES decryption */ + { + /* Flush IN/OUT FIFOs */ + CRYP_FIFOFlush(); + + /* Crypto Init for Key preparation for decryption process */ + AES_CRYP_InitStructure.CRYP_AlgoDir = CRYP_AlgoDir_Decrypt; + AES_CRYP_InitStructure.CRYP_AlgoMode = CRYP_AlgoMode_AES_Key; + AES_CRYP_InitStructure.CRYP_DataType = CRYP_DataType_32b; + CRYP_Init(&AES_CRYP_InitStructure); + + /* Key Initialisation */ + CRYP_KeyInit(&AES_CRYP_KeyInitStructure); + + /* Enable Crypto processor */ + CRYP_Cmd(ENABLE); + + /* wait until the Busy flag is RESET */ + do + { + busystatus = CRYP_GetFlagStatus(CRYP_FLAG_BUSY); + counter++; + }while ((counter != AESBUSY_TIMEOUT) && (busystatus != RESET)); + + if (busystatus != RESET) + { + status = ERROR; + } + else + { + /* Crypto Init for decryption process */ + AES_CRYP_InitStructure.CRYP_AlgoDir = CRYP_AlgoDir_Decrypt; + } + } + /*------------------ AES Encryption ------------------*/ + else /* AES encryption */ + { + + CRYP_KeyInit(&AES_CRYP_KeyInitStructure); + + /* Crypto Init for Encryption process */ + AES_CRYP_InitStructure.CRYP_AlgoDir = CRYP_AlgoDir_Encrypt; + } + + AES_CRYP_InitStructure.CRYP_AlgoMode = CRYP_AlgoMode_AES_ECB; + AES_CRYP_InitStructure.CRYP_DataType = CRYP_DataType_8b; + CRYP_Init(&AES_CRYP_InitStructure); + + /* Flush IN/OUT FIFOs */ + CRYP_FIFOFlush(); + + /* Enable Crypto processor */ + CRYP_Cmd(ENABLE); + + if(CRYP_GetCmdStatus() == DISABLE) + { + /* The CRYP peripheral clock is not enabled or the device doesn't embedd + the CRYP peripheral (please check the device sales type. */ + return(ERROR); + } + + for(i=0; ((i>32)); + CRYP_DataIn(__REV(headerlength)); + CRYP_DataIn(__REV(inputlength>>32)); + CRYP_DataIn(__REV(inputlength)); + /* Wait until the OFNE flag is reset */ + while(CRYP_GetFlagStatus(CRYP_FLAG_OFNE) == RESET) + { + } + + tagaddr = (uint32_t)AuthTAG; + /* Read the Auth TAG in the IN FIFO */ + *(uint32_t*)(tagaddr) = CRYP_DataOut(); + tagaddr+=4; + *(uint32_t*)(tagaddr) = CRYP_DataOut(); + tagaddr+=4; + *(uint32_t*)(tagaddr) = CRYP_DataOut(); + tagaddr+=4; + *(uint32_t*)(tagaddr) = CRYP_DataOut(); + tagaddr+=4; + } + /*------------------ AES Decryption ------------------*/ + else /* AES decryption */ + { + /* Flush IN/OUT FIFOs */ + CRYP_FIFOFlush(); + + /* Key Initialisation */ + CRYP_KeyInit(&AES_CRYP_KeyInitStructure); + + /* CRYP Initialization Vectors */ + CRYP_IVInit(&AES_CRYP_IVInitStructure); + + /* Crypto Init for Key preparation for decryption process */ + AES_CRYP_InitStructure.CRYP_AlgoDir = CRYP_AlgoDir_Decrypt; + AES_CRYP_InitStructure.CRYP_AlgoMode = CRYP_AlgoMode_AES_GCM; + AES_CRYP_InitStructure.CRYP_DataType = CRYP_DataType_8b; + CRYP_Init(&AES_CRYP_InitStructure); + + /***************************** Init phase *********************************/ + /* Select init phase */ + CRYP_PhaseConfig(CRYP_Phase_Init); + + /* Enable Crypto processor */ + CRYP_Cmd(ENABLE); + + /* Wait for CRYPEN bit to be 0 */ + while(CRYP_GetCmdStatus() == ENABLE) + { + } + + /***************************** header phase *******************************/ + if(HLength != 0) + { + /* Select header phase */ + CRYP_PhaseConfig(CRYP_Phase_Header); + + /* Enable Crypto processor */ + CRYP_Cmd(ENABLE); + + if(CRYP_GetCmdStatus() == DISABLE) + { + /* The CRYP peripheral clock is not enabled or the device doesn't embedd + the CRYP peripheral (please check the device sales type. */ + return(ERROR); + } + + for(loopcounter = 0; (loopcounter < HLength); loopcounter+=16) + { + /* Wait until the IFEM flag is reset */ + while(CRYP_GetFlagStatus(CRYP_FLAG_IFEM) == RESET) + { + } + + /* Write the Input block in the IN FIFO */ + CRYP_DataIn(*(uint32_t*)(headeraddr)); + headeraddr+=4; + CRYP_DataIn(*(uint32_t*)(headeraddr)); + headeraddr+=4; + CRYP_DataIn(*(uint32_t*)(headeraddr)); + headeraddr+=4; + CRYP_DataIn(*(uint32_t*)(headeraddr)); + headeraddr+=4; + } + + /* Wait until the complete message has been processed */ + counter = 0; + do + { + busystatus = CRYP_GetFlagStatus(CRYP_FLAG_BUSY); + counter++; + }while ((counter != AESBUSY_TIMEOUT) && (busystatus != RESET)); + + if (busystatus != RESET) + { + status = ERROR; + } + } + + /**************************** payload phase *******************************/ + if(ILength != 0) + { + /* Select payload phase */ + CRYP_PhaseConfig(CRYP_Phase_Payload); + + /* Enable Crypto processor */ + CRYP_Cmd(ENABLE); + + if(CRYP_GetCmdStatus() == DISABLE) + { + /* The CRYP peripheral clock is not enabled or the device doesn't embedd + the CRYP peripheral (please check the device sales type. */ + return(ERROR); + } + + for(loopcounter = 0; ((loopcounter < ILength) && (status != ERROR)); loopcounter+=16) + { + /* Wait until the IFEM flag is reset */ + while(CRYP_GetFlagStatus(CRYP_FLAG_IFEM) == RESET) + { + } + /* Write the Input block in the IN FIFO */ + CRYP_DataIn(*(uint32_t*)(inputaddr)); + inputaddr+=4; + CRYP_DataIn(*(uint32_t*)(inputaddr)); + inputaddr+=4; + CRYP_DataIn(*(uint32_t*)(inputaddr)); + inputaddr+=4; + CRYP_DataIn(*(uint32_t*)(inputaddr)); + inputaddr+=4; + + /* Wait until the complete message has been processed */ + counter = 0; + do + { + busystatus = CRYP_GetFlagStatus(CRYP_FLAG_BUSY); + counter++; + }while ((counter != AESBUSY_TIMEOUT) && (busystatus != RESET)); + + if (busystatus != RESET) + { + status = ERROR; + } + else + { + /* Wait until the OFNE flag is reset */ + while(CRYP_GetFlagStatus(CRYP_FLAG_OFNE) == RESET) + { + } + + /* Read the Output block from the Output FIFO */ + *(uint32_t*)(outputaddr) = CRYP_DataOut(); + outputaddr+=4; + *(uint32_t*)(outputaddr) = CRYP_DataOut(); + outputaddr+=4; + *(uint32_t*)(outputaddr) = CRYP_DataOut(); + outputaddr+=4; + *(uint32_t*)(outputaddr) = CRYP_DataOut(); + outputaddr+=4; + } + } + } + + /***************************** final phase ********************************/ + /* Select final phase */ + CRYP_PhaseConfig(CRYP_Phase_Final); + + /* Enable Crypto processor */ + CRYP_Cmd(ENABLE); + + if(CRYP_GetCmdStatus() == DISABLE) + { + /* The CRYP peripheral clock is not enabled or the device doesn't embedd + the CRYP peripheral (please check the device sales type. */ + return(ERROR); + } + + /* Write number of bits concatenated with header in the IN FIFO */ + CRYP_DataIn(__REV(headerlength>>32)); + CRYP_DataIn(__REV(headerlength)); + CRYP_DataIn(__REV(inputlength>>32)); + CRYP_DataIn(__REV(inputlength)); + /* Wait until the OFNE flag is reset */ + while(CRYP_GetFlagStatus(CRYP_FLAG_OFNE) == RESET) + { + } + + tagaddr = (uint32_t)AuthTAG; + /* Read the Auth TAG in the IN FIFO */ + *(uint32_t*)(tagaddr) = CRYP_DataOut(); + tagaddr+=4; + *(uint32_t*)(tagaddr) = CRYP_DataOut(); + tagaddr+=4; + *(uint32_t*)(tagaddr) = CRYP_DataOut(); + tagaddr+=4; + *(uint32_t*)(tagaddr) = CRYP_DataOut(); + tagaddr+=4; + } + /* Disable Crypto */ + CRYP_Cmd(DISABLE); + + return status; +} + +/** + * @brief Encrypt and decrypt using AES in CCM Mode. The GCM and CCM modes + * are available only on STM32F437x Devices. + * @param Mode: encryption or decryption Mode. + * This parameter can be one of the following values: + * @arg MODE_ENCRYPT: Encryption + * @arg MODE_DECRYPT: Decryption + * @param Nonce: the nounce used for AES algorithm. It shall be unique for each processing. + * @param Key: Key used for AES algorithm. + * @param Keysize: length of the Key, must be a 128, 192 or 256. + * @param Input: pointer to the Input buffer. + * @param Ilength: length of the Input buffer in bytes, must be a multiple of 16. + * @param Header: pointer to the header buffer. + * @param Hlength: length of the header buffer in bytes. + * @param HBuffer: pointer to temporary buffer used to append the header + * HBuffer size must be equal to Hlength + 21 + * @param Output: pointer to the returned buffer. + * @param AuthTAG: pointer to the authentication TAG buffer. + * @param TAGSize: the size of the TAG (called also MAC). + * @retval An ErrorStatus enumeration value: + * - SUCCESS: Operation done + * - ERROR: Operation failed + */ +ErrorStatus CRYP_AES_CCM(uint8_t Mode, + uint8_t* Nonce, uint32_t NonceSize, + uint8_t *Key, uint16_t Keysize, + uint8_t *Input, uint32_t ILength, + uint8_t *Header, uint32_t HLength, uint8_t *HBuffer, + uint8_t *Output, + uint8_t *AuthTAG, uint32_t TAGSize) +{ + CRYP_InitTypeDef AES_CRYP_InitStructure; + CRYP_KeyInitTypeDef AES_CRYP_KeyInitStructure; + CRYP_IVInitTypeDef AES_CRYP_IVInitStructure; + __IO uint32_t counter = 0; + uint32_t busystatus = 0; + ErrorStatus status = SUCCESS; + uint32_t keyaddr = (uint32_t)Key; + uint32_t inputaddr = (uint32_t)Input; + uint32_t outputaddr = (uint32_t)Output; + uint32_t headeraddr = (uint32_t)Header; + uint32_t tagaddr = (uint32_t)AuthTAG; + uint32_t headersize = HLength; + uint32_t loopcounter = 0; + uint32_t bufferidx = 0; + uint8_t blockb0[16] = {0};/* Block B0 */ + uint8_t ctr[16] = {0}; /* Counter */ + uint32_t temptag[4] = {0}; /* temporary TAG (MAC) */ + uint32_t ctraddr = (uint32_t)ctr; + uint32_t b0addr = (uint32_t)blockb0; + + /************************ Formatting the header block ***********************/ + if(headersize != 0) + { + /* Check that the associated data (or header) length is lower than 2^16 - 2^8 = 65536 - 256 = 65280 */ + if(headersize < 65280) + { + HBuffer[bufferidx++] = (uint8_t) ((headersize >> 8) & 0xFF); + HBuffer[bufferidx++] = (uint8_t) ((headersize) & 0xFF); + headersize += 2; + } + else + { + /* header is encoded as 0xff || 0xfe || [headersize]32, i.e., six octets */ + HBuffer[bufferidx++] = 0xFF; + HBuffer[bufferidx++] = 0xFE; + HBuffer[bufferidx++] = headersize & 0xff000000; + HBuffer[bufferidx++] = headersize & 0x00ff0000; + HBuffer[bufferidx++] = headersize & 0x0000ff00; + HBuffer[bufferidx++] = headersize & 0x000000ff; + headersize += 6; + } + /* Copy the header buffer in internal buffer "HBuffer" */ + for(loopcounter = 0; loopcounter < headersize; loopcounter++) + { + HBuffer[bufferidx++] = Header[loopcounter]; + } + /* Check if the header size is modulo 16 */ + if ((headersize % 16) != 0) + { + /* Padd the header buffer with 0s till the HBuffer length is modulo 16 */ + for(loopcounter = headersize; loopcounter <= ((headersize/16) + 1) * 16; loopcounter++) + { + HBuffer[loopcounter] = 0; + } + /* Set the header size to modulo 16 */ + headersize = ((headersize/16) + 1) * 16; + } + /* set the pointer headeraddr to HBuffer */ + headeraddr = (uint32_t)HBuffer; + } + /************************* Formatting the block B0 **************************/ + if(headersize != 0) + { + blockb0[0] = 0x40; + } + /* Flags byte */ + blockb0[0] |= 0u | (((( (uint8_t) TAGSize - 2) / 2) & 0x07 ) << 3 ) | ( ( (uint8_t) (15 - NonceSize) - 1) & 0x07); + + for (loopcounter = 0; loopcounter < NonceSize; loopcounter++) + { + blockb0[loopcounter+1] = Nonce[loopcounter]; + } + for ( ; loopcounter < 13; loopcounter++) + { + blockb0[loopcounter+1] = 0; + } + + blockb0[14] = ((ILength >> 8) & 0xFF); + blockb0[15] = (ILength & 0xFF); + + /************************* Formatting the initial counter *******************/ + /* Byte 0: + Bits 7 and 6 are reserved and shall be set to 0 + Bits 3, 4, and 5 shall also be set to 0, to ensure that all the counter blocks + are distinct from B0 + Bits 0, 1, and 2 contain the same encoding of q as in B0 + */ + ctr[0] = blockb0[0] & 0x07; + /* byte 1 to NonceSize is the IV (Nonce) */ + for(loopcounter = 1; loopcounter < NonceSize + 1; loopcounter++) + { + ctr[loopcounter] = blockb0[loopcounter]; + } + /* Set the LSB to 1 */ + ctr[15] |= 0x01; + + /* Crypto structures initialisation*/ + CRYP_KeyStructInit(&AES_CRYP_KeyInitStructure); + + switch(Keysize) + { + case 128: + AES_CRYP_InitStructure.CRYP_KeySize = CRYP_KeySize_128b; + AES_CRYP_KeyInitStructure.CRYP_Key2Left = __REV(*(uint32_t*)(keyaddr)); + keyaddr+=4; + AES_CRYP_KeyInitStructure.CRYP_Key2Right= __REV(*(uint32_t*)(keyaddr)); + keyaddr+=4; + AES_CRYP_KeyInitStructure.CRYP_Key3Left = __REV(*(uint32_t*)(keyaddr)); + keyaddr+=4; + AES_CRYP_KeyInitStructure.CRYP_Key3Right= __REV(*(uint32_t*)(keyaddr)); + break; + case 192: + AES_CRYP_InitStructure.CRYP_KeySize = CRYP_KeySize_192b; + AES_CRYP_KeyInitStructure.CRYP_Key1Left = __REV(*(uint32_t*)(keyaddr)); + keyaddr+=4; + AES_CRYP_KeyInitStructure.CRYP_Key1Right= __REV(*(uint32_t*)(keyaddr)); + keyaddr+=4; + AES_CRYP_KeyInitStructure.CRYP_Key2Left = __REV(*(uint32_t*)(keyaddr)); + keyaddr+=4; + AES_CRYP_KeyInitStructure.CRYP_Key2Right= __REV(*(uint32_t*)(keyaddr)); + keyaddr+=4; + AES_CRYP_KeyInitStructure.CRYP_Key3Left = __REV(*(uint32_t*)(keyaddr)); + keyaddr+=4; + AES_CRYP_KeyInitStructure.CRYP_Key3Right= __REV(*(uint32_t*)(keyaddr)); + break; + case 256: + AES_CRYP_InitStructure.CRYP_KeySize = CRYP_KeySize_256b; + AES_CRYP_KeyInitStructure.CRYP_Key0Left = __REV(*(uint32_t*)(keyaddr)); + keyaddr+=4; + AES_CRYP_KeyInitStructure.CRYP_Key0Right= __REV(*(uint32_t*)(keyaddr)); + keyaddr+=4; + AES_CRYP_KeyInitStructure.CRYP_Key1Left = __REV(*(uint32_t*)(keyaddr)); + keyaddr+=4; + AES_CRYP_KeyInitStructure.CRYP_Key1Right= __REV(*(uint32_t*)(keyaddr)); + keyaddr+=4; + AES_CRYP_KeyInitStructure.CRYP_Key2Left = __REV(*(uint32_t*)(keyaddr)); + keyaddr+=4; + AES_CRYP_KeyInitStructure.CRYP_Key2Right= __REV(*(uint32_t*)(keyaddr)); + keyaddr+=4; + AES_CRYP_KeyInitStructure.CRYP_Key3Left = __REV(*(uint32_t*)(keyaddr)); + keyaddr+=4; + AES_CRYP_KeyInitStructure.CRYP_Key3Right= __REV(*(uint32_t*)(keyaddr)); + break; + default: + break; + } + + /* CRYP Initialization Vectors */ + AES_CRYP_IVInitStructure.CRYP_IV0Left = (__REV(*(uint32_t*)(ctraddr))); + ctraddr+=4; + AES_CRYP_IVInitStructure.CRYP_IV0Right= (__REV(*(uint32_t*)(ctraddr))); + ctraddr+=4; + AES_CRYP_IVInitStructure.CRYP_IV1Left = (__REV(*(uint32_t*)(ctraddr))); + ctraddr+=4; + AES_CRYP_IVInitStructure.CRYP_IV1Right= (__REV(*(uint32_t*)(ctraddr))); + + /*------------------ AES Encryption ------------------*/ + if(Mode == MODE_ENCRYPT) /* AES encryption */ + { + /* Flush IN/OUT FIFOs */ + CRYP_FIFOFlush(); + + /* Key Initialisation */ + CRYP_KeyInit(&AES_CRYP_KeyInitStructure); + + /* CRYP Initialization Vectors */ + CRYP_IVInit(&AES_CRYP_IVInitStructure); + + /* Crypto Init for Key preparation for decryption process */ + AES_CRYP_InitStructure.CRYP_AlgoDir = CRYP_AlgoDir_Encrypt; + AES_CRYP_InitStructure.CRYP_AlgoMode = CRYP_AlgoMode_AES_CCM; + AES_CRYP_InitStructure.CRYP_DataType = CRYP_DataType_8b; + CRYP_Init(&AES_CRYP_InitStructure); + + /***************************** Init phase *********************************/ + /* Select init phase */ + CRYP_PhaseConfig(CRYP_Phase_Init); + + b0addr = (uint32_t)blockb0; + /* Write the blockb0 block in the IN FIFO */ + CRYP_DataIn((*(uint32_t*)(b0addr))); + b0addr+=4; + CRYP_DataIn((*(uint32_t*)(b0addr))); + b0addr+=4; + CRYP_DataIn((*(uint32_t*)(b0addr))); + b0addr+=4; + CRYP_DataIn((*(uint32_t*)(b0addr))); + + /* Enable Crypto processor */ + CRYP_Cmd(ENABLE); + + /* Wait for CRYPEN bit to be 0 */ + while(CRYP_GetCmdStatus() == ENABLE) + { + } + /***************************** header phase *******************************/ + if(headersize != 0) + { + /* Select header phase */ + CRYP_PhaseConfig(CRYP_Phase_Header); + + /* Enable Crypto processor */ + CRYP_Cmd(ENABLE); + + if(CRYP_GetCmdStatus() == DISABLE) + { + /* The CRYP peripheral clock is not enabled or the device doesn't embedd + the CRYP peripheral (please check the device sales type. */ + return(ERROR); + } + + for(loopcounter = 0; (loopcounter < headersize); loopcounter+=16) + { + /* Wait until the IFEM flag is reset */ + while(CRYP_GetFlagStatus(CRYP_FLAG_IFEM) == RESET) + { + } + + /* Write the Input block in the IN FIFO */ + CRYP_DataIn(*(uint32_t*)(headeraddr)); + headeraddr+=4; + CRYP_DataIn(*(uint32_t*)(headeraddr)); + headeraddr+=4; + CRYP_DataIn(*(uint32_t*)(headeraddr)); + headeraddr+=4; + CRYP_DataIn(*(uint32_t*)(headeraddr)); + headeraddr+=4; + } + + /* Wait until the complete message has been processed */ + counter = 0; + do + { + busystatus = CRYP_GetFlagStatus(CRYP_FLAG_BUSY); + counter++; + }while ((counter != AESBUSY_TIMEOUT) && (busystatus != RESET)); + + if (busystatus != RESET) + { + status = ERROR; + } + } + + /**************************** payload phase *******************************/ + if(ILength != 0) + { + /* Select payload phase */ + CRYP_PhaseConfig(CRYP_Phase_Payload); + + /* Enable Crypto processor */ + CRYP_Cmd(ENABLE); + + if(CRYP_GetCmdStatus() == DISABLE) + { + /* The CRYP peripheral clock is not enabled or the device doesn't embedd + the CRYP peripheral (please check the device sales type. */ + return(ERROR); + } + + for(loopcounter = 0; ((loopcounter < ILength) && (status != ERROR)); loopcounter+=16) + { + /* Wait until the IFEM flag is reset */ + while(CRYP_GetFlagStatus(CRYP_FLAG_IFEM) == RESET) + { + } + + /* Write the Input block in the IN FIFO */ + CRYP_DataIn(*(uint32_t*)(inputaddr)); + inputaddr+=4; + CRYP_DataIn(*(uint32_t*)(inputaddr)); + inputaddr+=4; + CRYP_DataIn(*(uint32_t*)(inputaddr)); + inputaddr+=4; + CRYP_DataIn(*(uint32_t*)(inputaddr)); + inputaddr+=4; + + /* Wait until the complete message has been processed */ + counter = 0; + do + { + busystatus = CRYP_GetFlagStatus(CRYP_FLAG_BUSY); + counter++; + }while ((counter != AESBUSY_TIMEOUT) && (busystatus != RESET)); + + if (busystatus != RESET) + { + status = ERROR; + } + else + { + /* Wait until the OFNE flag is reset */ + while(CRYP_GetFlagStatus(CRYP_FLAG_OFNE) == RESET) + { + } + + /* Read the Output block from the Output FIFO */ + *(uint32_t*)(outputaddr) = CRYP_DataOut(); + outputaddr+=4; + *(uint32_t*)(outputaddr) = CRYP_DataOut(); + outputaddr+=4; + *(uint32_t*)(outputaddr) = CRYP_DataOut(); + outputaddr+=4; + *(uint32_t*)(outputaddr) = CRYP_DataOut(); + outputaddr+=4; + } + } + } + + /***************************** final phase ********************************/ + /* Select final phase */ + CRYP_PhaseConfig(CRYP_Phase_Final); + + /* Enable Crypto processor */ + CRYP_Cmd(ENABLE); + + if(CRYP_GetCmdStatus() == DISABLE) + { + /* The CRYP peripheral clock is not enabled or the device doesn't embedd + the CRYP peripheral (please check the device sales type. */ + return(ERROR); + } + + ctraddr = (uint32_t)ctr; + /* Write the counter block in the IN FIFO */ + CRYP_DataIn(*(uint32_t*)(ctraddr)); + ctraddr+=4; + CRYP_DataIn(*(uint32_t*)(ctraddr)); + ctraddr+=4; + CRYP_DataIn(*(uint32_t*)(ctraddr)); + ctraddr+=4; + /* Reset bit 0 (after 8-bit swap) is equivalent to reset bit 24 (before 8-bit swap) */ + CRYP_DataIn(*(uint32_t*)(ctraddr) & 0xfeffffff); + + /* Wait until the OFNE flag is reset */ + while(CRYP_GetFlagStatus(CRYP_FLAG_OFNE) == RESET) + { + } + + /* Read the Auth TAG in the IN FIFO */ + temptag[0] = CRYP_DataOut(); + temptag[1] = CRYP_DataOut(); + temptag[2] = CRYP_DataOut(); + temptag[3] = CRYP_DataOut(); + } + /*------------------ AES Decryption ------------------*/ + else /* AES decryption */ + { + /* Flush IN/OUT FIFOs */ + CRYP_FIFOFlush(); + + /* Key Initialisation */ + CRYP_KeyInit(&AES_CRYP_KeyInitStructure); + + /* CRYP Initialization Vectors */ + CRYP_IVInit(&AES_CRYP_IVInitStructure); + + /* Crypto Init for Key preparation for decryption process */ + AES_CRYP_InitStructure.CRYP_AlgoDir = CRYP_AlgoDir_Decrypt; + AES_CRYP_InitStructure.CRYP_AlgoMode = CRYP_AlgoMode_AES_CCM; + AES_CRYP_InitStructure.CRYP_DataType = CRYP_DataType_8b; + CRYP_Init(&AES_CRYP_InitStructure); + + /***************************** Init phase *********************************/ + /* Select init phase */ + CRYP_PhaseConfig(CRYP_Phase_Init); + + b0addr = (uint32_t)blockb0; + /* Write the blockb0 block in the IN FIFO */ + CRYP_DataIn((*(uint32_t*)(b0addr))); + b0addr+=4; + CRYP_DataIn((*(uint32_t*)(b0addr))); + b0addr+=4; + CRYP_DataIn((*(uint32_t*)(b0addr))); + b0addr+=4; + CRYP_DataIn((*(uint32_t*)(b0addr))); + + /* Enable Crypto processor */ + CRYP_Cmd(ENABLE); + + /* Wait for CRYPEN bit to be 0 */ + while(CRYP_GetCmdStatus() == ENABLE) + { + } + + /***************************** header phase *******************************/ + if(headersize != 0) + { + /* Select header phase */ + CRYP_PhaseConfig(CRYP_Phase_Header); + + /* Enable Crypto processor */ + CRYP_Cmd(ENABLE); + + if(CRYP_GetCmdStatus() == DISABLE) + { + /* The CRYP peripheral clock is not enabled or the device doesn't embedd + the CRYP peripheral (please check the device sales type. */ + return(ERROR); + } + + for(loopcounter = 0; (loopcounter < headersize); loopcounter+=16) + { + /* Wait until the IFEM flag is reset */ + while(CRYP_GetFlagStatus(CRYP_FLAG_IFEM) == RESET) + { + } + + /* Write the Input block in the IN FIFO */ + CRYP_DataIn(*(uint32_t*)(headeraddr)); + headeraddr+=4; + CRYP_DataIn(*(uint32_t*)(headeraddr)); + headeraddr+=4; + CRYP_DataIn(*(uint32_t*)(headeraddr)); + headeraddr+=4; + CRYP_DataIn(*(uint32_t*)(headeraddr)); + headeraddr+=4; + } + + /* Wait until the complete message has been processed */ + counter = 0; + do + { + busystatus = CRYP_GetFlagStatus(CRYP_FLAG_BUSY); + counter++; + }while ((counter != AESBUSY_TIMEOUT) && (busystatus != RESET)); + + if (busystatus != RESET) + { + status = ERROR; + } + } + + /**************************** payload phase *******************************/ + if(ILength != 0) + { + /* Select payload phase */ + CRYP_PhaseConfig(CRYP_Phase_Payload); + + /* Enable Crypto processor */ + CRYP_Cmd(ENABLE); + + if(CRYP_GetCmdStatus() == DISABLE) + { + /* The CRYP peripheral clock is not enabled or the device doesn't embedd + the CRYP peripheral (please check the device sales type. */ + return(ERROR); + } + + for(loopcounter = 0; ((loopcounter < ILength) && (status != ERROR)); loopcounter+=16) + { + /* Wait until the IFEM flag is reset */ + while(CRYP_GetFlagStatus(CRYP_FLAG_IFEM) == RESET) + { + } + + /* Write the Input block in the IN FIFO */ + CRYP_DataIn(*(uint32_t*)(inputaddr)); + inputaddr+=4; + CRYP_DataIn(*(uint32_t*)(inputaddr)); + inputaddr+=4; + CRYP_DataIn(*(uint32_t*)(inputaddr)); + inputaddr+=4; + CRYP_DataIn(*(uint32_t*)(inputaddr)); + inputaddr+=4; + + /* Wait until the complete message has been processed */ + counter = 0; + do + { + busystatus = CRYP_GetFlagStatus(CRYP_FLAG_BUSY); + counter++; + }while ((counter != AESBUSY_TIMEOUT) && (busystatus != RESET)); + + if (busystatus != RESET) + { + status = ERROR; + } + else + { + /* Wait until the OFNE flag is reset */ + while(CRYP_GetFlagStatus(CRYP_FLAG_OFNE) == RESET) + { + } + + /* Read the Output block from the Output FIFO */ + *(uint32_t*)(outputaddr) = CRYP_DataOut(); + outputaddr+=4; + *(uint32_t*)(outputaddr) = CRYP_DataOut(); + outputaddr+=4; + *(uint32_t*)(outputaddr) = CRYP_DataOut(); + outputaddr+=4; + *(uint32_t*)(outputaddr) = CRYP_DataOut(); + outputaddr+=4; + } + } + } + + /***************************** final phase ********************************/ + /* Select final phase */ + CRYP_PhaseConfig(CRYP_Phase_Final); + + /* Enable Crypto processor */ + CRYP_Cmd(ENABLE); + + if(CRYP_GetCmdStatus() == DISABLE) + { + /* The CRYP peripheral clock is not enabled or the device doesn't embedd + the CRYP peripheral (please check the device sales type. */ + return(ERROR); + } + + ctraddr = (uint32_t)ctr; + /* Write the counter block in the IN FIFO */ + CRYP_DataIn(*(uint32_t*)(ctraddr)); + ctraddr+=4; + CRYP_DataIn(*(uint32_t*)(ctraddr)); + ctraddr+=4; + CRYP_DataIn(*(uint32_t*)(ctraddr)); + ctraddr+=4; + /* Reset bit 0 (after 8-bit swap) is equivalent to reset bit 24 (before 8-bit swap) */ + CRYP_DataIn(*(uint32_t*)(ctraddr) & 0xfeffffff); + + /* Wait until the OFNE flag is reset */ + while(CRYP_GetFlagStatus(CRYP_FLAG_OFNE) == RESET) + { + } + + /* Read the Authentaication TAG (MAC) in the IN FIFO */ + temptag[0] = CRYP_DataOut(); + temptag[1] = CRYP_DataOut(); + temptag[2] = CRYP_DataOut(); + temptag[3] = CRYP_DataOut(); + } + + /* Copy temporary authentication TAG in user TAG buffer */ + for(loopcounter = 0; (loopcounter < TAGSize); loopcounter++) + { + /* Set the authentication TAG buffer */ + *((uint8_t*)tagaddr+loopcounter) = *((uint8_t*)temptag+loopcounter); + } + + /* Disable Crypto */ + CRYP_Cmd(DISABLE); + + return status; +} + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ + diff --git a/FWLIB/src/stm32f4xx_cryp_des.c b/FWLIB/src/stm32f4xx_cryp_des.c new file mode 100644 index 0000000..04d5e95 --- /dev/null +++ b/FWLIB/src/stm32f4xx_cryp_des.c @@ -0,0 +1,308 @@ +/** + ****************************************************************************** + * @file stm32f4xx_cryp_des.c + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file provides high level functions to encrypt and decrypt an + * input message using DES in ECB/CBC modes. + * It uses the stm32f4xx_cryp.c/.h drivers to access the STM32F4xx CRYP + * peripheral. + * +@verbatim + + =================================================================== + ##### How to use this driver ##### + =================================================================== + [..] + (#) Enable The CRYP controller clock using + RCC_AHB2PeriphClockCmd(RCC_AHB2Periph_CRYP, ENABLE); function. + + (#) Encrypt and decrypt using DES in ECB Mode using CRYP_DES_ECB() function. + + (#) Encrypt and decrypt using DES in CBC Mode using CRYP_DES_CBC() function. + +@endverbatim + * + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx_cryp.h" + + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @defgroup CRYP + * @brief CRYP driver modules + * @{ + */ + +/* Private typedef -----------------------------------------------------------*/ +/* Private define ------------------------------------------------------------*/ +#define DESBUSY_TIMEOUT ((uint32_t) 0x00010000) + +/* Private macro -------------------------------------------------------------*/ +/* Private variables ---------------------------------------------------------*/ +/* Private function prototypes -----------------------------------------------*/ +/* Private functions ---------------------------------------------------------*/ + + +/** @defgroup CRYP_Private_Functions + * @{ + */ + +/** @defgroup CRYP_Group8 High Level DES functions + * @brief High Level DES functions + * +@verbatim + =============================================================================== + ##### High Level DES functions ##### + =============================================================================== +@endverbatim + * @{ + */ + +/** + * @brief Encrypt and decrypt using DES in ECB Mode + * @param Mode: encryption or decryption Mode. + * This parameter can be one of the following values: + * @arg MODE_ENCRYPT: Encryption + * @arg MODE_DECRYPT: Decryption + * @param Key: Key used for DES algorithm. + * @param Ilength: length of the Input buffer, must be a multiple of 8. + * @param Input: pointer to the Input buffer. + * @param Output: pointer to the returned buffer. + * @retval An ErrorStatus enumeration value: + * - SUCCESS: Operation done + * - ERROR: Operation failed + */ +ErrorStatus CRYP_DES_ECB(uint8_t Mode, uint8_t Key[8], uint8_t *Input, + uint32_t Ilength, uint8_t *Output) +{ + CRYP_InitTypeDef DES_CRYP_InitStructure; + CRYP_KeyInitTypeDef DES_CRYP_KeyInitStructure; + __IO uint32_t counter = 0; + uint32_t busystatus = 0; + ErrorStatus status = SUCCESS; + uint32_t keyaddr = (uint32_t)Key; + uint32_t inputaddr = (uint32_t)Input; + uint32_t outputaddr = (uint32_t)Output; + uint32_t i = 0; + + /* Crypto structures initialisation*/ + CRYP_KeyStructInit(&DES_CRYP_KeyInitStructure); + + /* Crypto Init for Encryption process */ + if( Mode == MODE_ENCRYPT ) /* DES encryption */ + { + DES_CRYP_InitStructure.CRYP_AlgoDir = CRYP_AlgoDir_Encrypt; + } + else/* if( Mode == MODE_DECRYPT )*/ /* DES decryption */ + { + DES_CRYP_InitStructure.CRYP_AlgoDir = CRYP_AlgoDir_Decrypt; + } + + DES_CRYP_InitStructure.CRYP_AlgoMode = CRYP_AlgoMode_DES_ECB; + DES_CRYP_InitStructure.CRYP_DataType = CRYP_DataType_8b; + CRYP_Init(&DES_CRYP_InitStructure); + + /* Key Initialisation */ + DES_CRYP_KeyInitStructure.CRYP_Key1Left = __REV(*(uint32_t*)(keyaddr)); + keyaddr+=4; + DES_CRYP_KeyInitStructure.CRYP_Key1Right= __REV(*(uint32_t*)(keyaddr)); + CRYP_KeyInit(& DES_CRYP_KeyInitStructure); + + /* Flush IN/OUT FIFO */ + CRYP_FIFOFlush(); + + /* Enable Crypto processor */ + CRYP_Cmd(ENABLE); + + if(CRYP_GetCmdStatus() == DISABLE) + { + /* The CRYP peripheral clock is not enabled or the device doesn't embedd + the CRYP peripheral (please check the device sales type. */ + return(ERROR); + } + for(i=0; ((i
© COPYRIGHT 2014 STMicroelectronics
+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx_cryp.h" + + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @defgroup CRYP + * @brief CRYP driver modules + * @{ + */ + +/* Private typedef -----------------------------------------------------------*/ +/* Private define ------------------------------------------------------------*/ +#define TDESBUSY_TIMEOUT ((uint32_t) 0x00010000) + +/* Private macro -------------------------------------------------------------*/ +/* Private variables ---------------------------------------------------------*/ +/* Private function prototypes -----------------------------------------------*/ +/* Private functions ---------------------------------------------------------*/ + + +/** @defgroup CRYP_Private_Functions + * @{ + */ + +/** @defgroup CRYP_Group7 High Level TDES functions + * @brief High Level TDES functions + * +@verbatim + =============================================================================== + ##### High Level TDES functions ##### + =============================================================================== + +@endverbatim + * @{ + */ + +/** + * @brief Encrypt and decrypt using TDES in ECB Mode + * @param Mode: encryption or decryption Mode. + * This parameter can be one of the following values: + * @arg MODE_ENCRYPT: Encryption + * @arg MODE_DECRYPT: Decryption + * @param Key: Key used for TDES algorithm. + * @param Ilength: length of the Input buffer, must be a multiple of 8. + * @param Input: pointer to the Input buffer. + * @param Output: pointer to the returned buffer. + * @retval An ErrorStatus enumeration value: + * - SUCCESS: Operation done + * - ERROR: Operation failed + */ +ErrorStatus CRYP_TDES_ECB(uint8_t Mode, uint8_t Key[24], uint8_t *Input, + uint32_t Ilength, uint8_t *Output) +{ + CRYP_InitTypeDef TDES_CRYP_InitStructure; + CRYP_KeyInitTypeDef TDES_CRYP_KeyInitStructure; + __IO uint32_t counter = 0; + uint32_t busystatus = 0; + ErrorStatus status = SUCCESS; + uint32_t keyaddr = (uint32_t)Key; + uint32_t inputaddr = (uint32_t)Input; + uint32_t outputaddr = (uint32_t)Output; + uint32_t i = 0; + + /* Crypto structures initialisation*/ + CRYP_KeyStructInit(&TDES_CRYP_KeyInitStructure); + + /* Crypto Init for Encryption process */ + if(Mode == MODE_ENCRYPT) /* TDES encryption */ + { + TDES_CRYP_InitStructure.CRYP_AlgoDir = CRYP_AlgoDir_Encrypt; + } + else /*if(Mode == MODE_DECRYPT)*/ /* TDES decryption */ + { + TDES_CRYP_InitStructure.CRYP_AlgoDir = CRYP_AlgoDir_Decrypt; + } + + TDES_CRYP_InitStructure.CRYP_AlgoMode = CRYP_AlgoMode_TDES_ECB; + TDES_CRYP_InitStructure.CRYP_DataType = CRYP_DataType_8b; + CRYP_Init(&TDES_CRYP_InitStructure); + + /* Key Initialisation */ + TDES_CRYP_KeyInitStructure.CRYP_Key1Left = __REV(*(uint32_t*)(keyaddr)); + keyaddr+=4; + TDES_CRYP_KeyInitStructure.CRYP_Key1Right= __REV(*(uint32_t*)(keyaddr)); + keyaddr+=4; + TDES_CRYP_KeyInitStructure.CRYP_Key2Left = __REV(*(uint32_t*)(keyaddr)); + keyaddr+=4; + TDES_CRYP_KeyInitStructure.CRYP_Key2Right= __REV(*(uint32_t*)(keyaddr)); + keyaddr+=4; + TDES_CRYP_KeyInitStructure.CRYP_Key3Left = __REV(*(uint32_t*)(keyaddr)); + keyaddr+=4; + TDES_CRYP_KeyInitStructure.CRYP_Key3Right= __REV(*(uint32_t*)(keyaddr)); + CRYP_KeyInit(& TDES_CRYP_KeyInitStructure); + + /* Flush IN/OUT FIFO */ + CRYP_FIFOFlush(); + + /* Enable Crypto processor */ + CRYP_Cmd(ENABLE); + + if(CRYP_GetCmdStatus() == DISABLE) + { + /* The CRYP peripheral clock is not enabled or the device doesn't embedd + the CRYP peripheral (please check the device sales type. */ + return(ERROR); + } + for(i=0; ((i
© COPYRIGHT 2014 STMicroelectronics
+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx_dac.h" +#include "stm32f4xx_rcc.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @defgroup DAC + * @brief DAC driver modules + * @{ + */ + +/* Private typedef -----------------------------------------------------------*/ +/* Private define ------------------------------------------------------------*/ + +/* CR register Mask */ +#define CR_CLEAR_MASK ((uint32_t)0x00000FFE) + +/* DAC Dual Channels SWTRIG masks */ +#define DUAL_SWTRIG_SET ((uint32_t)0x00000003) +#define DUAL_SWTRIG_RESET ((uint32_t)0xFFFFFFFC) + +/* DHR registers offsets */ +#define DHR12R1_OFFSET ((uint32_t)0x00000008) +#define DHR12R2_OFFSET ((uint32_t)0x00000014) +#define DHR12RD_OFFSET ((uint32_t)0x00000020) + +/* DOR register offset */ +#define DOR_OFFSET ((uint32_t)0x0000002C) + +/* Private macro -------------------------------------------------------------*/ +/* Private variables ---------------------------------------------------------*/ +/* Private function prototypes -----------------------------------------------*/ +/* Private functions ---------------------------------------------------------*/ + +/** @defgroup DAC_Private_Functions + * @{ + */ + +/** @defgroup DAC_Group1 DAC channels configuration + * @brief DAC channels configuration: trigger, output buffer, data format + * +@verbatim + =============================================================================== + ##### DAC channels configuration: trigger, output buffer, data format ##### + =============================================================================== + +@endverbatim + * @{ + */ + +/** + * @brief Deinitializes the DAC peripheral registers to their default reset values. + * @param None + * @retval None + */ +void DAC_DeInit(void) +{ + /* Enable DAC reset state */ + RCC_APB1PeriphResetCmd(RCC_APB1Periph_DAC, ENABLE); + /* Release DAC from reset state */ + RCC_APB1PeriphResetCmd(RCC_APB1Periph_DAC, DISABLE); +} + +/** + * @brief Initializes the DAC peripheral according to the specified parameters + * in the DAC_InitStruct. + * @param DAC_Channel: the selected DAC channel. + * This parameter can be one of the following values: + * @arg DAC_Channel_1: DAC Channel1 selected + * @arg DAC_Channel_2: DAC Channel2 selected + * @param DAC_InitStruct: pointer to a DAC_InitTypeDef structure that contains + * the configuration information for the specified DAC channel. + * @retval None + */ +void DAC_Init(uint32_t DAC_Channel, DAC_InitTypeDef* DAC_InitStruct) +{ + uint32_t tmpreg1 = 0, tmpreg2 = 0; + + /* Check the DAC parameters */ + assert_param(IS_DAC_TRIGGER(DAC_InitStruct->DAC_Trigger)); + assert_param(IS_DAC_GENERATE_WAVE(DAC_InitStruct->DAC_WaveGeneration)); + assert_param(IS_DAC_LFSR_UNMASK_TRIANGLE_AMPLITUDE(DAC_InitStruct->DAC_LFSRUnmask_TriangleAmplitude)); + assert_param(IS_DAC_OUTPUT_BUFFER_STATE(DAC_InitStruct->DAC_OutputBuffer)); + +/*---------------------------- DAC CR Configuration --------------------------*/ + /* Get the DAC CR value */ + tmpreg1 = DAC->CR; + /* Clear BOFFx, TENx, TSELx, WAVEx and MAMPx bits */ + tmpreg1 &= ~(CR_CLEAR_MASK << DAC_Channel); + /* Configure for the selected DAC channel: buffer output, trigger, + wave generation, mask/amplitude for wave generation */ + /* Set TSELx and TENx bits according to DAC_Trigger value */ + /* Set WAVEx bits according to DAC_WaveGeneration value */ + /* Set MAMPx bits according to DAC_LFSRUnmask_TriangleAmplitude value */ + /* Set BOFFx bit according to DAC_OutputBuffer value */ + tmpreg2 = (DAC_InitStruct->DAC_Trigger | DAC_InitStruct->DAC_WaveGeneration | + DAC_InitStruct->DAC_LFSRUnmask_TriangleAmplitude | \ + DAC_InitStruct->DAC_OutputBuffer); + /* Calculate CR register value depending on DAC_Channel */ + tmpreg1 |= tmpreg2 << DAC_Channel; + /* Write to DAC CR */ + DAC->CR = tmpreg1; +} + +/** + * @brief Fills each DAC_InitStruct member with its default value. + * @param DAC_InitStruct: pointer to a DAC_InitTypeDef structure which will + * be initialized. + * @retval None + */ +void DAC_StructInit(DAC_InitTypeDef* DAC_InitStruct) +{ +/*--------------- Reset DAC init structure parameters values -----------------*/ + /* Initialize the DAC_Trigger member */ + DAC_InitStruct->DAC_Trigger = DAC_Trigger_None; + /* Initialize the DAC_WaveGeneration member */ + DAC_InitStruct->DAC_WaveGeneration = DAC_WaveGeneration_None; + /* Initialize the DAC_LFSRUnmask_TriangleAmplitude member */ + DAC_InitStruct->DAC_LFSRUnmask_TriangleAmplitude = DAC_LFSRUnmask_Bit0; + /* Initialize the DAC_OutputBuffer member */ + DAC_InitStruct->DAC_OutputBuffer = DAC_OutputBuffer_Enable; +} + +/** + * @brief Enables or disables the specified DAC channel. + * @param DAC_Channel: The selected DAC channel. + * This parameter can be one of the following values: + * @arg DAC_Channel_1: DAC Channel1 selected + * @arg DAC_Channel_2: DAC Channel2 selected + * @param NewState: new state of the DAC channel. + * This parameter can be: ENABLE or DISABLE. + * @note When the DAC channel is enabled the trigger source can no more be modified. + * @retval None + */ +void DAC_Cmd(uint32_t DAC_Channel, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_DAC_CHANNEL(DAC_Channel)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the selected DAC channel */ + DAC->CR |= (DAC_CR_EN1 << DAC_Channel); + } + else + { + /* Disable the selected DAC channel */ + DAC->CR &= (~(DAC_CR_EN1 << DAC_Channel)); + } +} + +/** + * @brief Enables or disables the selected DAC channel software trigger. + * @param DAC_Channel: The selected DAC channel. + * This parameter can be one of the following values: + * @arg DAC_Channel_1: DAC Channel1 selected + * @arg DAC_Channel_2: DAC Channel2 selected + * @param NewState: new state of the selected DAC channel software trigger. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void DAC_SoftwareTriggerCmd(uint32_t DAC_Channel, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_DAC_CHANNEL(DAC_Channel)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable software trigger for the selected DAC channel */ + DAC->SWTRIGR |= (uint32_t)DAC_SWTRIGR_SWTRIG1 << (DAC_Channel >> 4); + } + else + { + /* Disable software trigger for the selected DAC channel */ + DAC->SWTRIGR &= ~((uint32_t)DAC_SWTRIGR_SWTRIG1 << (DAC_Channel >> 4)); + } +} + +/** + * @brief Enables or disables simultaneously the two DAC channels software triggers. + * @param NewState: new state of the DAC channels software triggers. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void DAC_DualSoftwareTriggerCmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable software trigger for both DAC channels */ + DAC->SWTRIGR |= DUAL_SWTRIG_SET; + } + else + { + /* Disable software trigger for both DAC channels */ + DAC->SWTRIGR &= DUAL_SWTRIG_RESET; + } +} + +/** + * @brief Enables or disables the selected DAC channel wave generation. + * @param DAC_Channel: The selected DAC channel. + * This parameter can be one of the following values: + * @arg DAC_Channel_1: DAC Channel1 selected + * @arg DAC_Channel_2: DAC Channel2 selected + * @param DAC_Wave: specifies the wave type to enable or disable. + * This parameter can be one of the following values: + * @arg DAC_Wave_Noise: noise wave generation + * @arg DAC_Wave_Triangle: triangle wave generation + * @param NewState: new state of the selected DAC channel wave generation. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void DAC_WaveGenerationCmd(uint32_t DAC_Channel, uint32_t DAC_Wave, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_DAC_CHANNEL(DAC_Channel)); + assert_param(IS_DAC_WAVE(DAC_Wave)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the selected wave generation for the selected DAC channel */ + DAC->CR |= DAC_Wave << DAC_Channel; + } + else + { + /* Disable the selected wave generation for the selected DAC channel */ + DAC->CR &= ~(DAC_Wave << DAC_Channel); + } +} + +/** + * @brief Set the specified data holding register value for DAC channel1. + * @param DAC_Align: Specifies the data alignment for DAC channel1. + * This parameter can be one of the following values: + * @arg DAC_Align_8b_R: 8bit right data alignment selected + * @arg DAC_Align_12b_L: 12bit left data alignment selected + * @arg DAC_Align_12b_R: 12bit right data alignment selected + * @param Data: Data to be loaded in the selected data holding register. + * @retval None + */ +void DAC_SetChannel1Data(uint32_t DAC_Align, uint16_t Data) +{ + __IO uint32_t tmp = 0; + + /* Check the parameters */ + assert_param(IS_DAC_ALIGN(DAC_Align)); + assert_param(IS_DAC_DATA(Data)); + + tmp = (uint32_t)DAC_BASE; + tmp += DHR12R1_OFFSET + DAC_Align; + + /* Set the DAC channel1 selected data holding register */ + *(__IO uint32_t *) tmp = Data; +} + +/** + * @brief Set the specified data holding register value for DAC channel2. + * @param DAC_Align: Specifies the data alignment for DAC channel2. + * This parameter can be one of the following values: + * @arg DAC_Align_8b_R: 8bit right data alignment selected + * @arg DAC_Align_12b_L: 12bit left data alignment selected + * @arg DAC_Align_12b_R: 12bit right data alignment selected + * @param Data: Data to be loaded in the selected data holding register. + * @retval None + */ +void DAC_SetChannel2Data(uint32_t DAC_Align, uint16_t Data) +{ + __IO uint32_t tmp = 0; + + /* Check the parameters */ + assert_param(IS_DAC_ALIGN(DAC_Align)); + assert_param(IS_DAC_DATA(Data)); + + tmp = (uint32_t)DAC_BASE; + tmp += DHR12R2_OFFSET + DAC_Align; + + /* Set the DAC channel2 selected data holding register */ + *(__IO uint32_t *)tmp = Data; +} + +/** + * @brief Set the specified data holding register value for dual channel DAC. + * @param DAC_Align: Specifies the data alignment for dual channel DAC. + * This parameter can be one of the following values: + * @arg DAC_Align_8b_R: 8bit right data alignment selected + * @arg DAC_Align_12b_L: 12bit left data alignment selected + * @arg DAC_Align_12b_R: 12bit right data alignment selected + * @param Data2: Data for DAC Channel2 to be loaded in the selected data holding register. + * @param Data1: Data for DAC Channel1 to be loaded in the selected data holding register. + * @note In dual mode, a unique register access is required to write in both + * DAC channels at the same time. + * @retval None + */ +void DAC_SetDualChannelData(uint32_t DAC_Align, uint16_t Data2, uint16_t Data1) +{ + uint32_t data = 0, tmp = 0; + + /* Check the parameters */ + assert_param(IS_DAC_ALIGN(DAC_Align)); + assert_param(IS_DAC_DATA(Data1)); + assert_param(IS_DAC_DATA(Data2)); + + /* Calculate and set dual DAC data holding register value */ + if (DAC_Align == DAC_Align_8b_R) + { + data = ((uint32_t)Data2 << 8) | Data1; + } + else + { + data = ((uint32_t)Data2 << 16) | Data1; + } + + tmp = (uint32_t)DAC_BASE; + tmp += DHR12RD_OFFSET + DAC_Align; + + /* Set the dual DAC selected data holding register */ + *(__IO uint32_t *)tmp = data; +} + +/** + * @brief Returns the last data output value of the selected DAC channel. + * @param DAC_Channel: The selected DAC channel. + * This parameter can be one of the following values: + * @arg DAC_Channel_1: DAC Channel1 selected + * @arg DAC_Channel_2: DAC Channel2 selected + * @retval The selected DAC channel data output value. + */ +uint16_t DAC_GetDataOutputValue(uint32_t DAC_Channel) +{ + __IO uint32_t tmp = 0; + + /* Check the parameters */ + assert_param(IS_DAC_CHANNEL(DAC_Channel)); + + tmp = (uint32_t) DAC_BASE ; + tmp += DOR_OFFSET + ((uint32_t)DAC_Channel >> 2); + + /* Returns the DAC channel data output register value */ + return (uint16_t) (*(__IO uint32_t*) tmp); +} +/** + * @} + */ + +/** @defgroup DAC_Group2 DMA management functions + * @brief DMA management functions + * +@verbatim + =============================================================================== + ##### DMA management functions ##### + =============================================================================== + +@endverbatim + * @{ + */ + +/** + * @brief Enables or disables the specified DAC channel DMA request. + * @note When enabled DMA1 is generated when an external trigger (EXTI Line9, + * TIM2, TIM4, TIM5, TIM6, TIM7 or TIM8 but not a software trigger) occurs. + * @param DAC_Channel: The selected DAC channel. + * This parameter can be one of the following values: + * @arg DAC_Channel_1: DAC Channel1 selected + * @arg DAC_Channel_2: DAC Channel2 selected + * @param NewState: new state of the selected DAC channel DMA request. + * This parameter can be: ENABLE or DISABLE. + * @note The DAC channel1 is mapped on DMA1 Stream 5 channel7 which must be + * already configured. + * @note The DAC channel2 is mapped on DMA1 Stream 6 channel7 which must be + * already configured. + * @retval None + */ +void DAC_DMACmd(uint32_t DAC_Channel, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_DAC_CHANNEL(DAC_Channel)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the selected DAC channel DMA request */ + DAC->CR |= (DAC_CR_DMAEN1 << DAC_Channel); + } + else + { + /* Disable the selected DAC channel DMA request */ + DAC->CR &= (~(DAC_CR_DMAEN1 << DAC_Channel)); + } +} +/** + * @} + */ + +/** @defgroup DAC_Group3 Interrupts and flags management functions + * @brief Interrupts and flags management functions + * +@verbatim + =============================================================================== + ##### Interrupts and flags management functions ##### + =============================================================================== + +@endverbatim + * @{ + */ + +/** + * @brief Enables or disables the specified DAC interrupts. + * @param DAC_Channel: The selected DAC channel. + * This parameter can be one of the following values: + * @arg DAC_Channel_1: DAC Channel1 selected + * @arg DAC_Channel_2: DAC Channel2 selected + * @param DAC_IT: specifies the DAC interrupt sources to be enabled or disabled. + * This parameter can be the following values: + * @arg DAC_IT_DMAUDR: DMA underrun interrupt mask + * @note The DMA underrun occurs when a second external trigger arrives before the + * acknowledgement for the first external trigger is received (first request). + * @param NewState: new state of the specified DAC interrupts. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void DAC_ITConfig(uint32_t DAC_Channel, uint32_t DAC_IT, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_DAC_CHANNEL(DAC_Channel)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + assert_param(IS_DAC_IT(DAC_IT)); + + if (NewState != DISABLE) + { + /* Enable the selected DAC interrupts */ + DAC->CR |= (DAC_IT << DAC_Channel); + } + else + { + /* Disable the selected DAC interrupts */ + DAC->CR &= (~(uint32_t)(DAC_IT << DAC_Channel)); + } +} + +/** + * @brief Checks whether the specified DAC flag is set or not. + * @param DAC_Channel: The selected DAC channel. + * This parameter can be one of the following values: + * @arg DAC_Channel_1: DAC Channel1 selected + * @arg DAC_Channel_2: DAC Channel2 selected + * @param DAC_FLAG: specifies the flag to check. + * This parameter can be only of the following value: + * @arg DAC_FLAG_DMAUDR: DMA underrun flag + * @note The DMA underrun occurs when a second external trigger arrives before the + * acknowledgement for the first external trigger is received (first request). + * @retval The new state of DAC_FLAG (SET or RESET). + */ +FlagStatus DAC_GetFlagStatus(uint32_t DAC_Channel, uint32_t DAC_FLAG) +{ + FlagStatus bitstatus = RESET; + /* Check the parameters */ + assert_param(IS_DAC_CHANNEL(DAC_Channel)); + assert_param(IS_DAC_FLAG(DAC_FLAG)); + + /* Check the status of the specified DAC flag */ + if ((DAC->SR & (DAC_FLAG << DAC_Channel)) != (uint8_t)RESET) + { + /* DAC_FLAG is set */ + bitstatus = SET; + } + else + { + /* DAC_FLAG is reset */ + bitstatus = RESET; + } + /* Return the DAC_FLAG status */ + return bitstatus; +} + +/** + * @brief Clears the DAC channel's pending flags. + * @param DAC_Channel: The selected DAC channel. + * This parameter can be one of the following values: + * @arg DAC_Channel_1: DAC Channel1 selected + * @arg DAC_Channel_2: DAC Channel2 selected + * @param DAC_FLAG: specifies the flag to clear. + * This parameter can be of the following value: + * @arg DAC_FLAG_DMAUDR: DMA underrun flag + * @note The DMA underrun occurs when a second external trigger arrives before the + * acknowledgement for the first external trigger is received (first request). + * @retval None + */ +void DAC_ClearFlag(uint32_t DAC_Channel, uint32_t DAC_FLAG) +{ + /* Check the parameters */ + assert_param(IS_DAC_CHANNEL(DAC_Channel)); + assert_param(IS_DAC_FLAG(DAC_FLAG)); + + /* Clear the selected DAC flags */ + DAC->SR = (DAC_FLAG << DAC_Channel); +} + +/** + * @brief Checks whether the specified DAC interrupt has occurred or not. + * @param DAC_Channel: The selected DAC channel. + * This parameter can be one of the following values: + * @arg DAC_Channel_1: DAC Channel1 selected + * @arg DAC_Channel_2: DAC Channel2 selected + * @param DAC_IT: specifies the DAC interrupt source to check. + * This parameter can be the following values: + * @arg DAC_IT_DMAUDR: DMA underrun interrupt mask + * @note The DMA underrun occurs when a second external trigger arrives before the + * acknowledgement for the first external trigger is received (first request). + * @retval The new state of DAC_IT (SET or RESET). + */ +ITStatus DAC_GetITStatus(uint32_t DAC_Channel, uint32_t DAC_IT) +{ + ITStatus bitstatus = RESET; + uint32_t enablestatus = 0; + + /* Check the parameters */ + assert_param(IS_DAC_CHANNEL(DAC_Channel)); + assert_param(IS_DAC_IT(DAC_IT)); + + /* Get the DAC_IT enable bit status */ + enablestatus = (DAC->CR & (DAC_IT << DAC_Channel)) ; + + /* Check the status of the specified DAC interrupt */ + if (((DAC->SR & (DAC_IT << DAC_Channel)) != (uint32_t)RESET) && enablestatus) + { + /* DAC_IT is set */ + bitstatus = SET; + } + else + { + /* DAC_IT is reset */ + bitstatus = RESET; + } + /* Return the DAC_IT status */ + return bitstatus; +} + +/** + * @brief Clears the DAC channel's interrupt pending bits. + * @param DAC_Channel: The selected DAC channel. + * This parameter can be one of the following values: + * @arg DAC_Channel_1: DAC Channel1 selected + * @arg DAC_Channel_2: DAC Channel2 selected + * @param DAC_IT: specifies the DAC interrupt pending bit to clear. + * This parameter can be the following values: + * @arg DAC_IT_DMAUDR: DMA underrun interrupt mask + * @note The DMA underrun occurs when a second external trigger arrives before the + * acknowledgement for the first external trigger is received (first request). + * @retval None + */ +void DAC_ClearITPendingBit(uint32_t DAC_Channel, uint32_t DAC_IT) +{ + /* Check the parameters */ + assert_param(IS_DAC_CHANNEL(DAC_Channel)); + assert_param(IS_DAC_IT(DAC_IT)); + + /* Clear the selected DAC interrupt pending bits */ + DAC->SR = (DAC_IT << DAC_Channel); +} + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/src/stm32f4xx_dbgmcu.c b/FWLIB/src/stm32f4xx_dbgmcu.c new file mode 100644 index 0000000..4cc691f --- /dev/null +++ b/FWLIB/src/stm32f4xx_dbgmcu.c @@ -0,0 +1,180 @@ +/** + ****************************************************************************** + * @file stm32f4xx_dbgmcu.c + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file provides all the DBGMCU firmware functions. + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx_dbgmcu.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @defgroup DBGMCU + * @brief DBGMCU driver modules + * @{ + */ + +/* Private typedef -----------------------------------------------------------*/ +/* Private define ------------------------------------------------------------*/ +#define IDCODE_DEVID_MASK ((uint32_t)0x00000FFF) + +/* Private macro -------------------------------------------------------------*/ +/* Private variables ---------------------------------------------------------*/ +/* Private function prototypes -----------------------------------------------*/ +/* Private functions ---------------------------------------------------------*/ + +/** @defgroup DBGMCU_Private_Functions + * @{ + */ + +/** + * @brief Returns the device revision identifier. + * @param None + * @retval Device revision identifier + */ +uint32_t DBGMCU_GetREVID(void) +{ + return(DBGMCU->IDCODE >> 16); +} + +/** + * @brief Returns the device identifier. + * @param None + * @retval Device identifier + */ +uint32_t DBGMCU_GetDEVID(void) +{ + return(DBGMCU->IDCODE & IDCODE_DEVID_MASK); +} + +/** + * @brief Configures low power mode behavior when the MCU is in Debug mode. + * @param DBGMCU_Periph: specifies the low power mode. + * This parameter can be any combination of the following values: + * @arg DBGMCU_SLEEP: Keep debugger connection during SLEEP mode + * @arg DBGMCU_STOP: Keep debugger connection during STOP mode + * @arg DBGMCU_STANDBY: Keep debugger connection during STANDBY mode + * @param NewState: new state of the specified low power mode in Debug mode. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void DBGMCU_Config(uint32_t DBGMCU_Periph, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_DBGMCU_PERIPH(DBGMCU_Periph)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + if (NewState != DISABLE) + { + DBGMCU->CR |= DBGMCU_Periph; + } + else + { + DBGMCU->CR &= ~DBGMCU_Periph; + } +} + +/** + * @brief Configures APB1 peripheral behavior when the MCU is in Debug mode. + * @param DBGMCU_Periph: specifies the APB1 peripheral. + * This parameter can be any combination of the following values: + * @arg DBGMCU_TIM2_STOP: TIM2 counter stopped when Core is halted + * @arg DBGMCU_TIM3_STOP: TIM3 counter stopped when Core is halted + * @arg DBGMCU_TIM4_STOP: TIM4 counter stopped when Core is halted + * @arg DBGMCU_TIM5_STOP: TIM5 counter stopped when Core is halted + * @arg DBGMCU_TIM6_STOP: TIM6 counter stopped when Core is halted + * @arg DBGMCU_TIM7_STOP: TIM7 counter stopped when Core is halted + * @arg DBGMCU_TIM12_STOP: TIM12 counter stopped when Core is halted + * @arg DBGMCU_TIM13_STOP: TIM13 counter stopped when Core is halted + * @arg DBGMCU_TIM14_STOP: TIM14 counter stopped when Core is halted + * @arg DBGMCU_RTC_STOP: RTC Calendar and Wakeup counter stopped when Core is halted. + * @arg DBGMCU_WWDG_STOP: Debug WWDG stopped when Core is halted + * @arg DBGMCU_IWDG_STOP: Debug IWDG stopped when Core is halted + * @arg DBGMCU_I2C1_SMBUS_TIMEOUT: I2C1 SMBUS timeout mode stopped when Core is halted + * @arg DBGMCU_I2C2_SMBUS_TIMEOUT: I2C2 SMBUS timeout mode stopped when Core is halted + * @arg DBGMCU_I2C3_SMBUS_TIMEOUT: I2C3 SMBUS timeout mode stopped when Core is halted + * @arg DBGMCU_CAN2_STOP: Debug CAN1 stopped when Core is halted + * @arg DBGMCU_CAN1_STOP: Debug CAN2 stopped when Core is halted + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void DBGMCU_APB1PeriphConfig(uint32_t DBGMCU_Periph, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_DBGMCU_APB1PERIPH(DBGMCU_Periph)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + DBGMCU->APB1FZ |= DBGMCU_Periph; + } + else + { + DBGMCU->APB1FZ &= ~DBGMCU_Periph; + } +} + +/** + * @brief Configures APB2 peripheral behavior when the MCU is in Debug mode. + * @param DBGMCU_Periph: specifies the APB2 peripheral. + * This parameter can be any combination of the following values: + * @arg DBGMCU_TIM1_STOP: TIM1 counter stopped when Core is halted + * @arg DBGMCU_TIM8_STOP: TIM8 counter stopped when Core is halted + * @arg DBGMCU_TIM9_STOP: TIM9 counter stopped when Core is halted + * @arg DBGMCU_TIM10_STOP: TIM10 counter stopped when Core is halted + * @arg DBGMCU_TIM11_STOP: TIM11 counter stopped when Core is halted + * @param NewState: new state of the specified peripheral in Debug mode. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void DBGMCU_APB2PeriphConfig(uint32_t DBGMCU_Periph, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_DBGMCU_APB2PERIPH(DBGMCU_Periph)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + DBGMCU->APB2FZ |= DBGMCU_Periph; + } + else + { + DBGMCU->APB2FZ &= ~DBGMCU_Periph; + } +} + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/src/stm32f4xx_dcmi.c b/FWLIB/src/stm32f4xx_dcmi.c new file mode 100644 index 0000000..0993dd6 --- /dev/null +++ b/FWLIB/src/stm32f4xx_dcmi.c @@ -0,0 +1,538 @@ +/** + ****************************************************************************** + * @file stm32f4xx_dcmi.c + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file provides firmware functions to manage the following + * functionalities of the DCMI peripheral: + * + Initialization and Configuration + * + Image capture functions + * + Interrupts and flags management + * + @verbatim + =============================================================================== + ##### How to use this driver ##### + =============================================================================== + [..] + The sequence below describes how to use this driver to capture image + from a camera module connected to the DCMI Interface. + This sequence does not take into account the configuration of the + camera module, which should be made before to configure and enable + the DCMI to capture images. + + (#) Enable the clock for the DCMI and associated GPIOs using the following + functions: + RCC_AHB2PeriphClockCmd(RCC_AHB2Periph_DCMI, ENABLE); + RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOx, ENABLE); + + (#) DCMI pins configuration + (++) Connect the involved DCMI pins to AF13 using the following function + GPIO_PinAFConfig(GPIOx, GPIO_PinSourcex, GPIO_AF_DCMI); + (++) Configure these DCMI pins in alternate function mode by calling + the function GPIO_Init(); + + (#) Declare a DCMI_InitTypeDef structure, for example: + DCMI_InitTypeDef DCMI_InitStructure; + and fill the DCMI_InitStructure variable with the allowed values + of the structure member. + + (#) Initialize the DCMI interface by calling the function + DCMI_Init(&DCMI_InitStructure); + + (#) Configure the DMA2_Stream1 channel1 to transfer Data from DCMI DR + register to the destination memory buffer. + + (#) Enable DCMI interface using the function + DCMI_Cmd(ENABLE); + + (#) Start the image capture using the function + DCMI_CaptureCmd(ENABLE); + + (#) At this stage the DCMI interface waits for the first start of frame, + then a DMA request is generated continuously/once (depending on the + mode used, Continuous/Snapshot) to transfer the received data into + the destination memory. + + -@- If you need to capture only a rectangular window from the received + image, you have to use the DCMI_CROPConfig() function to configure + the coordinates and size of the window to be captured, then enable + the Crop feature using DCMI_CROPCmd(ENABLE); + In this case, the Crop configuration should be made before to enable + and start the DCMI interface. + + @endverbatim + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx_dcmi.h" +#include "stm32f4xx_rcc.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @defgroup DCMI + * @brief DCMI driver modules + * @{ + */ + +/* Private typedef -----------------------------------------------------------*/ +/* Private define ------------------------------------------------------------*/ +/* Private macro -------------------------------------------------------------*/ +/* Private variables ---------------------------------------------------------*/ +/* Private function prototypes -----------------------------------------------*/ +/* Private functions ---------------------------------------------------------*/ + +/** @defgroup DCMI_Private_Functions + * @{ + */ + +/** @defgroup DCMI_Group1 Initialization and Configuration functions + * @brief Initialization and Configuration functions + * +@verbatim + =============================================================================== + ##### Initialization and Configuration functions ##### + =============================================================================== + +@endverbatim + * @{ + */ + +/** + * @brief Deinitializes the DCMI registers to their default reset values. + * @param None + * @retval None + */ +void DCMI_DeInit(void) +{ + DCMI->CR = 0x0; + DCMI->IER = 0x0; + DCMI->ICR = 0x1F; + DCMI->ESCR = 0x0; + DCMI->ESUR = 0x0; + DCMI->CWSTRTR = 0x0; + DCMI->CWSIZER = 0x0; +} + +/** + * @brief Initializes the DCMI according to the specified parameters in the DCMI_InitStruct. + * @param DCMI_InitStruct: pointer to a DCMI_InitTypeDef structure that contains + * the configuration information for the DCMI. + * @retval None + */ +void DCMI_Init(DCMI_InitTypeDef* DCMI_InitStruct) +{ + uint32_t temp = 0x0; + + /* Check the parameters */ + assert_param(IS_DCMI_CAPTURE_MODE(DCMI_InitStruct->DCMI_CaptureMode)); + assert_param(IS_DCMI_SYNCHRO(DCMI_InitStruct->DCMI_SynchroMode)); + assert_param(IS_DCMI_PCKPOLARITY(DCMI_InitStruct->DCMI_PCKPolarity)); + assert_param(IS_DCMI_VSPOLARITY(DCMI_InitStruct->DCMI_VSPolarity)); + assert_param(IS_DCMI_HSPOLARITY(DCMI_InitStruct->DCMI_HSPolarity)); + assert_param(IS_DCMI_CAPTURE_RATE(DCMI_InitStruct->DCMI_CaptureRate)); + assert_param(IS_DCMI_EXTENDED_DATA(DCMI_InitStruct->DCMI_ExtendedDataMode)); + + /* The DCMI configuration registers should be programmed correctly before + enabling the CR_ENABLE Bit and the CR_CAPTURE Bit */ + DCMI->CR &= ~(DCMI_CR_ENABLE | DCMI_CR_CAPTURE); + + /* Reset the old DCMI configuration */ + temp = DCMI->CR; + + temp &= ~((uint32_t)DCMI_CR_CM | DCMI_CR_ESS | DCMI_CR_PCKPOL | + DCMI_CR_HSPOL | DCMI_CR_VSPOL | DCMI_CR_FCRC_0 | + DCMI_CR_FCRC_1 | DCMI_CR_EDM_0 | DCMI_CR_EDM_1); + + /* Sets the new configuration of the DCMI peripheral */ + temp |= ((uint32_t)DCMI_InitStruct->DCMI_CaptureMode | + DCMI_InitStruct->DCMI_SynchroMode | + DCMI_InitStruct->DCMI_PCKPolarity | + DCMI_InitStruct->DCMI_VSPolarity | + DCMI_InitStruct->DCMI_HSPolarity | + DCMI_InitStruct->DCMI_CaptureRate | + DCMI_InitStruct->DCMI_ExtendedDataMode); + + DCMI->CR = temp; +} + +/** + * @brief Fills each DCMI_InitStruct member with its default value. + * @param DCMI_InitStruct : pointer to a DCMI_InitTypeDef structure which will + * be initialized. + * @retval None + */ +void DCMI_StructInit(DCMI_InitTypeDef* DCMI_InitStruct) +{ + /* Set the default configuration */ + DCMI_InitStruct->DCMI_CaptureMode = DCMI_CaptureMode_Continuous; + DCMI_InitStruct->DCMI_SynchroMode = DCMI_SynchroMode_Hardware; + DCMI_InitStruct->DCMI_PCKPolarity = DCMI_PCKPolarity_Falling; + DCMI_InitStruct->DCMI_VSPolarity = DCMI_VSPolarity_Low; + DCMI_InitStruct->DCMI_HSPolarity = DCMI_HSPolarity_Low; + DCMI_InitStruct->DCMI_CaptureRate = DCMI_CaptureRate_All_Frame; + DCMI_InitStruct->DCMI_ExtendedDataMode = DCMI_ExtendedDataMode_8b; +} + +/** + * @brief Initializes the DCMI peripheral CROP mode according to the specified + * parameters in the DCMI_CROPInitStruct. + * @note This function should be called before to enable and start the DCMI interface. + * @param DCMI_CROPInitStruct: pointer to a DCMI_CROPInitTypeDef structure that + * contains the configuration information for the DCMI peripheral CROP mode. + * @retval None + */ +void DCMI_CROPConfig(DCMI_CROPInitTypeDef* DCMI_CROPInitStruct) +{ + /* Sets the CROP window coordinates */ + DCMI->CWSTRTR = (uint32_t)((uint32_t)DCMI_CROPInitStruct->DCMI_HorizontalOffsetCount | + ((uint32_t)DCMI_CROPInitStruct->DCMI_VerticalStartLine << 16)); + + /* Sets the CROP window size */ + DCMI->CWSIZER = (uint32_t)(DCMI_CROPInitStruct->DCMI_CaptureCount | + ((uint32_t)DCMI_CROPInitStruct->DCMI_VerticalLineCount << 16)); +} + +/** + * @brief Enables or disables the DCMI Crop feature. + * @note This function should be called before to enable and start the DCMI interface. + * @param NewState: new state of the DCMI Crop feature. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void DCMI_CROPCmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the DCMI Crop feature */ + DCMI->CR |= (uint32_t)DCMI_CR_CROP; + } + else + { + /* Disable the DCMI Crop feature */ + DCMI->CR &= ~(uint32_t)DCMI_CR_CROP; + } +} + +/** + * @brief Sets the embedded synchronization codes + * @param DCMI_CodesInitTypeDef: pointer to a DCMI_CodesInitTypeDef structure that + * contains the embedded synchronization codes for the DCMI peripheral. + * @retval None + */ +void DCMI_SetEmbeddedSynchroCodes(DCMI_CodesInitTypeDef* DCMI_CodesInitStruct) +{ + DCMI->ESCR = (uint32_t)(DCMI_CodesInitStruct->DCMI_FrameStartCode | + ((uint32_t)DCMI_CodesInitStruct->DCMI_LineStartCode << 8)| + ((uint32_t)DCMI_CodesInitStruct->DCMI_LineEndCode << 16)| + ((uint32_t)DCMI_CodesInitStruct->DCMI_FrameEndCode << 24)); +} + +/** + * @brief Enables or disables the DCMI JPEG format. + * @note The Crop and Embedded Synchronization features cannot be used in this mode. + * @param NewState: new state of the DCMI JPEG format. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void DCMI_JPEGCmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the DCMI JPEG format */ + DCMI->CR |= (uint32_t)DCMI_CR_JPEG; + } + else + { + /* Disable the DCMI JPEG format */ + DCMI->CR &= ~(uint32_t)DCMI_CR_JPEG; + } +} +/** + * @} + */ + +/** @defgroup DCMI_Group2 Image capture functions + * @brief Image capture functions + * +@verbatim + =============================================================================== + ##### Image capture functions ##### + =============================================================================== + +@endverbatim + * @{ + */ + +/** + * @brief Enables or disables the DCMI interface. + * @param NewState: new state of the DCMI interface. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void DCMI_Cmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the DCMI by setting ENABLE bit */ + DCMI->CR |= (uint32_t)DCMI_CR_ENABLE; + } + else + { + /* Disable the DCMI by clearing ENABLE bit */ + DCMI->CR &= ~(uint32_t)DCMI_CR_ENABLE; + } +} + +/** + * @brief Enables or disables the DCMI Capture. + * @param NewState: new state of the DCMI capture. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void DCMI_CaptureCmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the DCMI Capture */ + DCMI->CR |= (uint32_t)DCMI_CR_CAPTURE; + } + else + { + /* Disable the DCMI Capture */ + DCMI->CR &= ~(uint32_t)DCMI_CR_CAPTURE; + } +} + +/** + * @brief Reads the data stored in the DR register. + * @param None + * @retval Data register value + */ +uint32_t DCMI_ReadData(void) +{ + return DCMI->DR; +} +/** + * @} + */ + +/** @defgroup DCMI_Group3 Interrupts and flags management functions + * @brief Interrupts and flags management functions + * +@verbatim + =============================================================================== + ##### Interrupts and flags management functions ##### + =============================================================================== + +@endverbatim + * @{ + */ + +/** + * @brief Enables or disables the DCMI interface interrupts. + * @param DCMI_IT: specifies the DCMI interrupt sources to be enabled or disabled. + * This parameter can be any combination of the following values: + * @arg DCMI_IT_FRAME: Frame capture complete interrupt mask + * @arg DCMI_IT_OVF: Overflow interrupt mask + * @arg DCMI_IT_ERR: Synchronization error interrupt mask + * @arg DCMI_IT_VSYNC: VSYNC interrupt mask + * @arg DCMI_IT_LINE: Line interrupt mask + * @param NewState: new state of the specified DCMI interrupts. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void DCMI_ITConfig(uint16_t DCMI_IT, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_DCMI_CONFIG_IT(DCMI_IT)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the Interrupt sources */ + DCMI->IER |= DCMI_IT; + } + else + { + /* Disable the Interrupt sources */ + DCMI->IER &= (uint16_t)(~DCMI_IT); + } +} + +/** + * @brief Checks whether the DCMI interface flag is set or not. + * @param DCMI_FLAG: specifies the flag to check. + * This parameter can be one of the following values: + * @arg DCMI_FLAG_FRAMERI: Frame capture complete Raw flag mask + * @arg DCMI_FLAG_OVFRI: Overflow Raw flag mask + * @arg DCMI_FLAG_ERRRI: Synchronization error Raw flag mask + * @arg DCMI_FLAG_VSYNCRI: VSYNC Raw flag mask + * @arg DCMI_FLAG_LINERI: Line Raw flag mask + * @arg DCMI_FLAG_FRAMEMI: Frame capture complete Masked flag mask + * @arg DCMI_FLAG_OVFMI: Overflow Masked flag mask + * @arg DCMI_FLAG_ERRMI: Synchronization error Masked flag mask + * @arg DCMI_FLAG_VSYNCMI: VSYNC Masked flag mask + * @arg DCMI_FLAG_LINEMI: Line Masked flag mask + * @arg DCMI_FLAG_HSYNC: HSYNC flag mask + * @arg DCMI_FLAG_VSYNC: VSYNC flag mask + * @arg DCMI_FLAG_FNE: Fifo not empty flag mask + * @retval The new state of DCMI_FLAG (SET or RESET). + */ +FlagStatus DCMI_GetFlagStatus(uint16_t DCMI_FLAG) +{ + FlagStatus bitstatus = RESET; + uint32_t dcmireg, tempreg = 0; + + /* Check the parameters */ + assert_param(IS_DCMI_GET_FLAG(DCMI_FLAG)); + + /* Get the DCMI register index */ + dcmireg = (((uint16_t)DCMI_FLAG) >> 12); + + if (dcmireg == 0x00) /* The FLAG is in RISR register */ + { + tempreg= DCMI->RISR; + } + else if (dcmireg == 0x02) /* The FLAG is in SR register */ + { + tempreg = DCMI->SR; + } + else /* The FLAG is in MISR register */ + { + tempreg = DCMI->MISR; + } + + if ((tempreg & DCMI_FLAG) != (uint16_t)RESET ) + { + bitstatus = SET; + } + else + { + bitstatus = RESET; + } + /* Return the DCMI_FLAG status */ + return bitstatus; +} + +/** + * @brief Clears the DCMI's pending flags. + * @param DCMI_FLAG: specifies the flag to clear. + * This parameter can be any combination of the following values: + * @arg DCMI_FLAG_FRAMERI: Frame capture complete Raw flag mask + * @arg DCMI_FLAG_OVFRI: Overflow Raw flag mask + * @arg DCMI_FLAG_ERRRI: Synchronization error Raw flag mask + * @arg DCMI_FLAG_VSYNCRI: VSYNC Raw flag mask + * @arg DCMI_FLAG_LINERI: Line Raw flag mask + * @retval None + */ +void DCMI_ClearFlag(uint16_t DCMI_FLAG) +{ + /* Check the parameters */ + assert_param(IS_DCMI_CLEAR_FLAG(DCMI_FLAG)); + + /* Clear the flag by writing in the ICR register 1 in the corresponding + Flag position*/ + + DCMI->ICR = DCMI_FLAG; +} + +/** + * @brief Checks whether the DCMI interrupt has occurred or not. + * @param DCMI_IT: specifies the DCMI interrupt source to check. + * This parameter can be one of the following values: + * @arg DCMI_IT_FRAME: Frame capture complete interrupt mask + * @arg DCMI_IT_OVF: Overflow interrupt mask + * @arg DCMI_IT_ERR: Synchronization error interrupt mask + * @arg DCMI_IT_VSYNC: VSYNC interrupt mask + * @arg DCMI_IT_LINE: Line interrupt mask + * @retval The new state of DCMI_IT (SET or RESET). + */ +ITStatus DCMI_GetITStatus(uint16_t DCMI_IT) +{ + ITStatus bitstatus = RESET; + uint32_t itstatus = 0; + + /* Check the parameters */ + assert_param(IS_DCMI_GET_IT(DCMI_IT)); + + itstatus = DCMI->MISR & DCMI_IT; /* Only masked interrupts are checked */ + + if ((itstatus != (uint16_t)RESET)) + { + bitstatus = SET; + } + else + { + bitstatus = RESET; + } + return bitstatus; +} + +/** + * @brief Clears the DCMI's interrupt pending bits. + * @param DCMI_IT: specifies the DCMI interrupt pending bit to clear. + * This parameter can be any combination of the following values: + * @arg DCMI_IT_FRAME: Frame capture complete interrupt mask + * @arg DCMI_IT_OVF: Overflow interrupt mask + * @arg DCMI_IT_ERR: Synchronization error interrupt mask + * @arg DCMI_IT_VSYNC: VSYNC interrupt mask + * @arg DCMI_IT_LINE: Line interrupt mask + * @retval None + */ +void DCMI_ClearITPendingBit(uint16_t DCMI_IT) +{ + /* Clear the interrupt pending Bit by writing in the ICR register 1 in the + corresponding pending Bit position*/ + + DCMI->ICR = DCMI_IT; +} +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/src/stm32f4xx_dma.c b/FWLIB/src/stm32f4xx_dma.c new file mode 100644 index 0000000..046f795 --- /dev/null +++ b/FWLIB/src/stm32f4xx_dma.c @@ -0,0 +1,1301 @@ +/** + ****************************************************************************** + * @file stm32f4xx_dma.c + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file provides firmware functions to manage the following + * functionalities of the Direct Memory Access controller (DMA): + * + Initialization and Configuration + * + Data Counter + * + Double Buffer mode configuration and command + * + Interrupts and flags management + * + @verbatim + =============================================================================== + ##### How to use this driver ##### + =============================================================================== + [..] + (#) Enable The DMA controller clock using RCC_AHB1PeriphResetCmd(RCC_AHB1Periph_DMA1, ENABLE) + function for DMA1 or using RCC_AHB1PeriphResetCmd(RCC_AHB1Periph_DMA2, ENABLE) + function for DMA2. + + (#) Enable and configure the peripheral to be connected to the DMA Stream + (except for internal SRAM / FLASH memories: no initialization is + necessary). + + (#) For a given Stream, program the required configuration through following parameters: + Source and Destination addresses, Transfer Direction, Transfer size, Source and Destination + data formats, Circular or Normal mode, Stream Priority level, Source and Destination + Incrementation mode, FIFO mode and its Threshold (if needed), Burst + mode for Source and/or Destination (if needed) using the DMA_Init() function. + To avoid filling unneccessary fields, you can call DMA_StructInit() function + to initialize a given structure with default values (reset values), the modify + only necessary fields + (ie. Source and Destination addresses, Transfer size and Data Formats). + + (#) Enable the NVIC and the corresponding interrupt(s) using the function + DMA_ITConfig() if you need to use DMA interrupts. + + (#) Optionally, if the Circular mode is enabled, you can use the Double buffer mode by configuring + the second Memory address and the first Memory to be used through the function + DMA_DoubleBufferModeConfig(). Then enable the Double buffer mode through the function + DMA_DoubleBufferModeCmd(). These operations must be done before step 6. + + (#) Enable the DMA stream using the DMA_Cmd() function. + + (#) Activate the needed Stream Request using PPP_DMACmd() function for + any PPP peripheral except internal SRAM and FLASH (ie. SPI, USART ...) + The function allowing this operation is provided in each PPP peripheral + driver (ie. SPI_DMACmd for SPI peripheral). + Once the Stream is enabled, it is not possible to modify its configuration + unless the stream is stopped and disabled. + After enabling the Stream, it is advised to monitor the EN bit status using + the function DMA_GetCmdStatus(). In case of configuration errors or bus errors + this bit will remain reset and all transfers on this Stream will remain on hold. + + (#) Optionally, you can configure the number of data to be transferred + when the Stream is disabled (ie. after each Transfer Complete event + or when a Transfer Error occurs) using the function DMA_SetCurrDataCounter(). + And you can get the number of remaining data to be transferred using + the function DMA_GetCurrDataCounter() at run time (when the DMA Stream is + enabled and running). + + (#) To control DMA events you can use one of the following two methods: + (##) Check on DMA Stream flags using the function DMA_GetFlagStatus(). + (##) Use DMA interrupts through the function DMA_ITConfig() at initialization + phase and DMA_GetITStatus() function into interrupt routines in + communication phase. + [..] + After checking on a flag you should clear it using DMA_ClearFlag() + function. And after checking on an interrupt event you should + clear it using DMA_ClearITPendingBit() function. + + (#) Optionally, if Circular mode and Double Buffer mode are enabled, you can modify + the Memory Addresses using the function DMA_MemoryTargetConfig(). Make sure that + the Memory Address to be modified is not the one currently in use by DMA Stream. + This condition can be monitored using the function DMA_GetCurrentMemoryTarget(). + + (#) Optionally, Pause-Resume operations may be performed: + The DMA_Cmd() function may be used to perform Pause-Resume operation. + When a transfer is ongoing, calling this function to disable the + Stream will cause the transfer to be paused. All configuration registers + and the number of remaining data will be preserved. When calling again + this function to re-enable the Stream, the transfer will be resumed from + the point where it was paused. + + -@- Memory-to-Memory transfer is possible by setting the address of the memory into + the Peripheral registers. In this mode, Circular mode and Double Buffer mode + are not allowed. + + -@- The FIFO is used mainly to reduce bus usage and to allow data + packing/unpacking: it is possible to set different Data Sizes for + the Peripheral and the Memory (ie. you can set Half-Word data size + for the peripheral to access its data register and set Word data size + for the Memory to gain in access time. Each two Half-words will be + packed and written in a single access to a Word in the Memory). + + -@- When FIFO is disabled, it is not allowed to configure different + Data Sizes for Source and Destination. In this case the Peripheral + Data Size will be applied to both Source and Destination. + + @endverbatim + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx_dma.h" +#include "stm32f4xx_rcc.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @defgroup DMA + * @brief DMA driver modules + * @{ + */ + +/* Private typedef -----------------------------------------------------------*/ +/* Private define ------------------------------------------------------------*/ + +/* Masks Definition */ +#define TRANSFER_IT_ENABLE_MASK (uint32_t)(DMA_SxCR_TCIE | DMA_SxCR_HTIE | \ + DMA_SxCR_TEIE | DMA_SxCR_DMEIE) + +#define DMA_Stream0_IT_MASK (uint32_t)(DMA_LISR_FEIF0 | DMA_LISR_DMEIF0 | \ + DMA_LISR_TEIF0 | DMA_LISR_HTIF0 | \ + DMA_LISR_TCIF0) + +#define DMA_Stream1_IT_MASK (uint32_t)(DMA_Stream0_IT_MASK << 6) +#define DMA_Stream2_IT_MASK (uint32_t)(DMA_Stream0_IT_MASK << 16) +#define DMA_Stream3_IT_MASK (uint32_t)(DMA_Stream0_IT_MASK << 22) +#define DMA_Stream4_IT_MASK (uint32_t)(DMA_Stream0_IT_MASK | (uint32_t)0x20000000) +#define DMA_Stream5_IT_MASK (uint32_t)(DMA_Stream1_IT_MASK | (uint32_t)0x20000000) +#define DMA_Stream6_IT_MASK (uint32_t)(DMA_Stream2_IT_MASK | (uint32_t)0x20000000) +#define DMA_Stream7_IT_MASK (uint32_t)(DMA_Stream3_IT_MASK | (uint32_t)0x20000000) +#define TRANSFER_IT_MASK (uint32_t)0x0F3C0F3C +#define HIGH_ISR_MASK (uint32_t)0x20000000 +#define RESERVED_MASK (uint32_t)0x0F7D0F7D + +/* Private macro -------------------------------------------------------------*/ +/* Private variables ---------------------------------------------------------*/ +/* Private function prototypes -----------------------------------------------*/ +/* Private functions ---------------------------------------------------------*/ + + +/** @defgroup DMA_Private_Functions + * @{ + */ + +/** @defgroup DMA_Group1 Initialization and Configuration functions + * @brief Initialization and Configuration functions + * +@verbatim + =============================================================================== + ##### Initialization and Configuration functions ##### + =============================================================================== + [..] + This subsection provides functions allowing to initialize the DMA Stream source + and destination addresses, incrementation and data sizes, transfer direction, + buffer size, circular/normal mode selection, memory-to-memory mode selection + and Stream priority value. + [..] + The DMA_Init() function follows the DMA configuration procedures as described in + reference manual (RM0090) except the first point: waiting on EN bit to be reset. + This condition should be checked by user application using the function DMA_GetCmdStatus() + before calling the DMA_Init() function. + +@endverbatim + * @{ + */ + +/** + * @brief Deinitialize the DMAy Streamx registers to their default reset values. + * @param DMAy_Streamx: where y can be 1 or 2 to select the DMA and x can be 0 + * to 7 to select the DMA Stream. + * @retval None + */ +void DMA_DeInit(DMA_Stream_TypeDef* DMAy_Streamx) +{ + /* Check the parameters */ + assert_param(IS_DMA_ALL_PERIPH(DMAy_Streamx)); + + /* Disable the selected DMAy Streamx */ + DMAy_Streamx->CR &= ~((uint32_t)DMA_SxCR_EN); + + /* Reset DMAy Streamx control register */ + DMAy_Streamx->CR = 0; + + /* Reset DMAy Streamx Number of Data to Transfer register */ + DMAy_Streamx->NDTR = 0; + + /* Reset DMAy Streamx peripheral address register */ + DMAy_Streamx->PAR = 0; + + /* Reset DMAy Streamx memory 0 address register */ + DMAy_Streamx->M0AR = 0; + + /* Reset DMAy Streamx memory 1 address register */ + DMAy_Streamx->M1AR = 0; + + /* Reset DMAy Streamx FIFO control register */ + DMAy_Streamx->FCR = (uint32_t)0x00000021; + + /* Reset interrupt pending bits for the selected stream */ + if (DMAy_Streamx == DMA1_Stream0) + { + /* Reset interrupt pending bits for DMA1 Stream0 */ + DMA1->LIFCR = DMA_Stream0_IT_MASK; + } + else if (DMAy_Streamx == DMA1_Stream1) + { + /* Reset interrupt pending bits for DMA1 Stream1 */ + DMA1->LIFCR = DMA_Stream1_IT_MASK; + } + else if (DMAy_Streamx == DMA1_Stream2) + { + /* Reset interrupt pending bits for DMA1 Stream2 */ + DMA1->LIFCR = DMA_Stream2_IT_MASK; + } + else if (DMAy_Streamx == DMA1_Stream3) + { + /* Reset interrupt pending bits for DMA1 Stream3 */ + DMA1->LIFCR = DMA_Stream3_IT_MASK; + } + else if (DMAy_Streamx == DMA1_Stream4) + { + /* Reset interrupt pending bits for DMA1 Stream4 */ + DMA1->HIFCR = DMA_Stream4_IT_MASK; + } + else if (DMAy_Streamx == DMA1_Stream5) + { + /* Reset interrupt pending bits for DMA1 Stream5 */ + DMA1->HIFCR = DMA_Stream5_IT_MASK; + } + else if (DMAy_Streamx == DMA1_Stream6) + { + /* Reset interrupt pending bits for DMA1 Stream6 */ + DMA1->HIFCR = (uint32_t)DMA_Stream6_IT_MASK; + } + else if (DMAy_Streamx == DMA1_Stream7) + { + /* Reset interrupt pending bits for DMA1 Stream7 */ + DMA1->HIFCR = DMA_Stream7_IT_MASK; + } + else if (DMAy_Streamx == DMA2_Stream0) + { + /* Reset interrupt pending bits for DMA2 Stream0 */ + DMA2->LIFCR = DMA_Stream0_IT_MASK; + } + else if (DMAy_Streamx == DMA2_Stream1) + { + /* Reset interrupt pending bits for DMA2 Stream1 */ + DMA2->LIFCR = DMA_Stream1_IT_MASK; + } + else if (DMAy_Streamx == DMA2_Stream2) + { + /* Reset interrupt pending bits for DMA2 Stream2 */ + DMA2->LIFCR = DMA_Stream2_IT_MASK; + } + else if (DMAy_Streamx == DMA2_Stream3) + { + /* Reset interrupt pending bits for DMA2 Stream3 */ + DMA2->LIFCR = DMA_Stream3_IT_MASK; + } + else if (DMAy_Streamx == DMA2_Stream4) + { + /* Reset interrupt pending bits for DMA2 Stream4 */ + DMA2->HIFCR = DMA_Stream4_IT_MASK; + } + else if (DMAy_Streamx == DMA2_Stream5) + { + /* Reset interrupt pending bits for DMA2 Stream5 */ + DMA2->HIFCR = DMA_Stream5_IT_MASK; + } + else if (DMAy_Streamx == DMA2_Stream6) + { + /* Reset interrupt pending bits for DMA2 Stream6 */ + DMA2->HIFCR = DMA_Stream6_IT_MASK; + } + else + { + if (DMAy_Streamx == DMA2_Stream7) + { + /* Reset interrupt pending bits for DMA2 Stream7 */ + DMA2->HIFCR = DMA_Stream7_IT_MASK; + } + } +} + +/** + * @brief Initializes the DMAy Streamx according to the specified parameters in + * the DMA_InitStruct structure. + * @note Before calling this function, it is recommended to check that the Stream + * is actually disabled using the function DMA_GetCmdStatus(). + * @param DMAy_Streamx: where y can be 1 or 2 to select the DMA and x can be 0 + * to 7 to select the DMA Stream. + * @param DMA_InitStruct: pointer to a DMA_InitTypeDef structure that contains + * the configuration information for the specified DMA Stream. + * @retval None + */ +void DMA_Init(DMA_Stream_TypeDef* DMAy_Streamx, DMA_InitTypeDef* DMA_InitStruct) +{ + uint32_t tmpreg = 0; + + /* Check the parameters */ + assert_param(IS_DMA_ALL_PERIPH(DMAy_Streamx)); + assert_param(IS_DMA_CHANNEL(DMA_InitStruct->DMA_Channel)); + assert_param(IS_DMA_DIRECTION(DMA_InitStruct->DMA_DIR)); + assert_param(IS_DMA_BUFFER_SIZE(DMA_InitStruct->DMA_BufferSize)); + assert_param(IS_DMA_PERIPHERAL_INC_STATE(DMA_InitStruct->DMA_PeripheralInc)); + assert_param(IS_DMA_MEMORY_INC_STATE(DMA_InitStruct->DMA_MemoryInc)); + assert_param(IS_DMA_PERIPHERAL_DATA_SIZE(DMA_InitStruct->DMA_PeripheralDataSize)); + assert_param(IS_DMA_MEMORY_DATA_SIZE(DMA_InitStruct->DMA_MemoryDataSize)); + assert_param(IS_DMA_MODE(DMA_InitStruct->DMA_Mode)); + assert_param(IS_DMA_PRIORITY(DMA_InitStruct->DMA_Priority)); + assert_param(IS_DMA_FIFO_MODE_STATE(DMA_InitStruct->DMA_FIFOMode)); + assert_param(IS_DMA_FIFO_THRESHOLD(DMA_InitStruct->DMA_FIFOThreshold)); + assert_param(IS_DMA_MEMORY_BURST(DMA_InitStruct->DMA_MemoryBurst)); + assert_param(IS_DMA_PERIPHERAL_BURST(DMA_InitStruct->DMA_PeripheralBurst)); + + /*------------------------- DMAy Streamx CR Configuration ------------------*/ + /* Get the DMAy_Streamx CR value */ + tmpreg = DMAy_Streamx->CR; + + /* Clear CHSEL, MBURST, PBURST, PL, MSIZE, PSIZE, MINC, PINC, CIRC and DIR bits */ + tmpreg &= ((uint32_t)~(DMA_SxCR_CHSEL | DMA_SxCR_MBURST | DMA_SxCR_PBURST | \ + DMA_SxCR_PL | DMA_SxCR_MSIZE | DMA_SxCR_PSIZE | \ + DMA_SxCR_MINC | DMA_SxCR_PINC | DMA_SxCR_CIRC | \ + DMA_SxCR_DIR)); + + /* Configure DMAy Streamx: */ + /* Set CHSEL bits according to DMA_CHSEL value */ + /* Set DIR bits according to DMA_DIR value */ + /* Set PINC bit according to DMA_PeripheralInc value */ + /* Set MINC bit according to DMA_MemoryInc value */ + /* Set PSIZE bits according to DMA_PeripheralDataSize value */ + /* Set MSIZE bits according to DMA_MemoryDataSize value */ + /* Set CIRC bit according to DMA_Mode value */ + /* Set PL bits according to DMA_Priority value */ + /* Set MBURST bits according to DMA_MemoryBurst value */ + /* Set PBURST bits according to DMA_PeripheralBurst value */ + tmpreg |= DMA_InitStruct->DMA_Channel | DMA_InitStruct->DMA_DIR | + DMA_InitStruct->DMA_PeripheralInc | DMA_InitStruct->DMA_MemoryInc | + DMA_InitStruct->DMA_PeripheralDataSize | DMA_InitStruct->DMA_MemoryDataSize | + DMA_InitStruct->DMA_Mode | DMA_InitStruct->DMA_Priority | + DMA_InitStruct->DMA_MemoryBurst | DMA_InitStruct->DMA_PeripheralBurst; + + /* Write to DMAy Streamx CR register */ + DMAy_Streamx->CR = tmpreg; + + /*------------------------- DMAy Streamx FCR Configuration -----------------*/ + /* Get the DMAy_Streamx FCR value */ + tmpreg = DMAy_Streamx->FCR; + + /* Clear DMDIS and FTH bits */ + tmpreg &= (uint32_t)~(DMA_SxFCR_DMDIS | DMA_SxFCR_FTH); + + /* Configure DMAy Streamx FIFO: + Set DMDIS bits according to DMA_FIFOMode value + Set FTH bits according to DMA_FIFOThreshold value */ + tmpreg |= DMA_InitStruct->DMA_FIFOMode | DMA_InitStruct->DMA_FIFOThreshold; + + /* Write to DMAy Streamx CR */ + DMAy_Streamx->FCR = tmpreg; + + /*------------------------- DMAy Streamx NDTR Configuration ----------------*/ + /* Write to DMAy Streamx NDTR register */ + DMAy_Streamx->NDTR = DMA_InitStruct->DMA_BufferSize; + + /*------------------------- DMAy Streamx PAR Configuration -----------------*/ + /* Write to DMAy Streamx PAR */ + DMAy_Streamx->PAR = DMA_InitStruct->DMA_PeripheralBaseAddr; + + /*------------------------- DMAy Streamx M0AR Configuration ----------------*/ + /* Write to DMAy Streamx M0AR */ + DMAy_Streamx->M0AR = DMA_InitStruct->DMA_Memory0BaseAddr; +} + +/** + * @brief Fills each DMA_InitStruct member with its default value. + * @param DMA_InitStruct : pointer to a DMA_InitTypeDef structure which will + * be initialized. + * @retval None + */ +void DMA_StructInit(DMA_InitTypeDef* DMA_InitStruct) +{ + /*-------------- Reset DMA init structure parameters values ----------------*/ + /* Initialize the DMA_Channel member */ + DMA_InitStruct->DMA_Channel = 0; + + /* Initialize the DMA_PeripheralBaseAddr member */ + DMA_InitStruct->DMA_PeripheralBaseAddr = 0; + + /* Initialize the DMA_Memory0BaseAddr member */ + DMA_InitStruct->DMA_Memory0BaseAddr = 0; + + /* Initialize the DMA_DIR member */ + DMA_InitStruct->DMA_DIR = DMA_DIR_PeripheralToMemory; + + /* Initialize the DMA_BufferSize member */ + DMA_InitStruct->DMA_BufferSize = 0; + + /* Initialize the DMA_PeripheralInc member */ + DMA_InitStruct->DMA_PeripheralInc = DMA_PeripheralInc_Disable; + + /* Initialize the DMA_MemoryInc member */ + DMA_InitStruct->DMA_MemoryInc = DMA_MemoryInc_Disable; + + /* Initialize the DMA_PeripheralDataSize member */ + DMA_InitStruct->DMA_PeripheralDataSize = DMA_PeripheralDataSize_Byte; + + /* Initialize the DMA_MemoryDataSize member */ + DMA_InitStruct->DMA_MemoryDataSize = DMA_MemoryDataSize_Byte; + + /* Initialize the DMA_Mode member */ + DMA_InitStruct->DMA_Mode = DMA_Mode_Normal; + + /* Initialize the DMA_Priority member */ + DMA_InitStruct->DMA_Priority = DMA_Priority_Low; + + /* Initialize the DMA_FIFOMode member */ + DMA_InitStruct->DMA_FIFOMode = DMA_FIFOMode_Disable; + + /* Initialize the DMA_FIFOThreshold member */ + DMA_InitStruct->DMA_FIFOThreshold = DMA_FIFOThreshold_1QuarterFull; + + /* Initialize the DMA_MemoryBurst member */ + DMA_InitStruct->DMA_MemoryBurst = DMA_MemoryBurst_Single; + + /* Initialize the DMA_PeripheralBurst member */ + DMA_InitStruct->DMA_PeripheralBurst = DMA_PeripheralBurst_Single; +} + +/** + * @brief Enables or disables the specified DMAy Streamx. + * @param DMAy_Streamx: where y can be 1 or 2 to select the DMA and x can be 0 + * to 7 to select the DMA Stream. + * @param NewState: new state of the DMAy Streamx. + * This parameter can be: ENABLE or DISABLE. + * + * @note This function may be used to perform Pause-Resume operation. When a + * transfer is ongoing, calling this function to disable the Stream will + * cause the transfer to be paused. All configuration registers and the + * number of remaining data will be preserved. When calling again this + * function to re-enable the Stream, the transfer will be resumed from + * the point where it was paused. + * + * @note After configuring the DMA Stream (DMA_Init() function) and enabling the + * stream, it is recommended to check (or wait until) the DMA Stream is + * effectively enabled. A Stream may remain disabled if a configuration + * parameter is wrong. + * After disabling a DMA Stream, it is also recommended to check (or wait + * until) the DMA Stream is effectively disabled. If a Stream is disabled + * while a data transfer is ongoing, the current data will be transferred + * and the Stream will be effectively disabled only after the transfer of + * this single data is finished. + * + * @retval None + */ +void DMA_Cmd(DMA_Stream_TypeDef* DMAy_Streamx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_DMA_ALL_PERIPH(DMAy_Streamx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the selected DMAy Streamx by setting EN bit */ + DMAy_Streamx->CR |= (uint32_t)DMA_SxCR_EN; + } + else + { + /* Disable the selected DMAy Streamx by clearing EN bit */ + DMAy_Streamx->CR &= ~(uint32_t)DMA_SxCR_EN; + } +} + +/** + * @brief Configures, when the PINC (Peripheral Increment address mode) bit is + * set, if the peripheral address should be incremented with the data + * size (configured with PSIZE bits) or by a fixed offset equal to 4 + * (32-bit aligned addresses). + * + * @note This function has no effect if the Peripheral Increment mode is disabled. + * + * @param DMAy_Streamx: where y can be 1 or 2 to select the DMA and x can be 0 + * to 7 to select the DMA Stream. + * @param DMA_Pincos: specifies the Peripheral increment offset size. + * This parameter can be one of the following values: + * @arg DMA_PINCOS_Psize: Peripheral address increment is done + * accordingly to PSIZE parameter. + * @arg DMA_PINCOS_WordAligned: Peripheral address increment offset is + * fixed to 4 (32-bit aligned addresses). + * @retval None + */ +void DMA_PeriphIncOffsetSizeConfig(DMA_Stream_TypeDef* DMAy_Streamx, uint32_t DMA_Pincos) +{ + /* Check the parameters */ + assert_param(IS_DMA_ALL_PERIPH(DMAy_Streamx)); + assert_param(IS_DMA_PINCOS_SIZE(DMA_Pincos)); + + /* Check the needed Peripheral increment offset */ + if(DMA_Pincos != DMA_PINCOS_Psize) + { + /* Configure DMA_SxCR_PINCOS bit with the input parameter */ + DMAy_Streamx->CR |= (uint32_t)DMA_SxCR_PINCOS; + } + else + { + /* Clear the PINCOS bit: Peripheral address incremented according to PSIZE */ + DMAy_Streamx->CR &= ~(uint32_t)DMA_SxCR_PINCOS; + } +} + +/** + * @brief Configures, when the DMAy Streamx is disabled, the flow controller for + * the next transactions (Peripheral or Memory). + * + * @note Before enabling this feature, check if the used peripheral supports + * the Flow Controller mode or not. + * + * @param DMAy_Streamx: where y can be 1 or 2 to select the DMA and x can be 0 + * to 7 to select the DMA Stream. + * @param DMA_FlowCtrl: specifies the DMA flow controller. + * This parameter can be one of the following values: + * @arg DMA_FlowCtrl_Memory: DMAy_Streamx transactions flow controller is + * the DMA controller. + * @arg DMA_FlowCtrl_Peripheral: DMAy_Streamx transactions flow controller + * is the peripheral. + * @retval None + */ +void DMA_FlowControllerConfig(DMA_Stream_TypeDef* DMAy_Streamx, uint32_t DMA_FlowCtrl) +{ + /* Check the parameters */ + assert_param(IS_DMA_ALL_PERIPH(DMAy_Streamx)); + assert_param(IS_DMA_FLOW_CTRL(DMA_FlowCtrl)); + + /* Check the needed flow controller */ + if(DMA_FlowCtrl != DMA_FlowCtrl_Memory) + { + /* Configure DMA_SxCR_PFCTRL bit with the input parameter */ + DMAy_Streamx->CR |= (uint32_t)DMA_SxCR_PFCTRL; + } + else + { + /* Clear the PFCTRL bit: Memory is the flow controller */ + DMAy_Streamx->CR &= ~(uint32_t)DMA_SxCR_PFCTRL; + } +} +/** + * @} + */ + +/** @defgroup DMA_Group2 Data Counter functions + * @brief Data Counter functions + * +@verbatim + =============================================================================== + ##### Data Counter functions ##### + =============================================================================== + [..] + This subsection provides function allowing to configure and read the buffer size + (number of data to be transferred). + [..] + The DMA data counter can be written only when the DMA Stream is disabled + (ie. after transfer complete event). + [..] + The following function can be used to write the Stream data counter value: + (+) void DMA_SetCurrDataCounter(DMA_Stream_TypeDef* DMAy_Streamx, uint16_t Counter); + -@- It is advised to use this function rather than DMA_Init() in situations + where only the Data buffer needs to be reloaded. + -@- If the Source and Destination Data Sizes are different, then the value + written in data counter, expressing the number of transfers, is relative + to the number of transfers from the Peripheral point of view. + ie. If Memory data size is Word, Peripheral data size is Half-Words, + then the value to be configured in the data counter is the number + of Half-Words to be transferred from/to the peripheral. + [..] + The DMA data counter can be read to indicate the number of remaining transfers for + the relative DMA Stream. This counter is decremented at the end of each data + transfer and when the transfer is complete: + (+) If Normal mode is selected: the counter is set to 0. + (+) If Circular mode is selected: the counter is reloaded with the initial value + (configured before enabling the DMA Stream) + [..] + The following function can be used to read the Stream data counter value: + (+) uint16_t DMA_GetCurrDataCounter(DMA_Stream_TypeDef* DMAy_Streamx); + +@endverbatim + * @{ + */ + +/** + * @brief Writes the number of data units to be transferred on the DMAy Streamx. + * @param DMAy_Streamx: where y can be 1 or 2 to select the DMA and x can be 0 + * to 7 to select the DMA Stream. + * @param Counter: Number of data units to be transferred (from 0 to 65535) + * Number of data items depends only on the Peripheral data format. + * + * @note If Peripheral data format is Bytes: number of data units is equal + * to total number of bytes to be transferred. + * + * @note If Peripheral data format is Half-Word: number of data units is + * equal to total number of bytes to be transferred / 2. + * + * @note If Peripheral data format is Word: number of data units is equal + * to total number of bytes to be transferred / 4. + * + * @note In Memory-to-Memory transfer mode, the memory buffer pointed by + * DMAy_SxPAR register is considered as Peripheral. + * + * @retval The number of remaining data units in the current DMAy Streamx transfer. + */ +void DMA_SetCurrDataCounter(DMA_Stream_TypeDef* DMAy_Streamx, uint16_t Counter) +{ + /* Check the parameters */ + assert_param(IS_DMA_ALL_PERIPH(DMAy_Streamx)); + + /* Write the number of data units to be transferred */ + DMAy_Streamx->NDTR = (uint16_t)Counter; +} + +/** + * @brief Returns the number of remaining data units in the current DMAy Streamx transfer. + * @param DMAy_Streamx: where y can be 1 or 2 to select the DMA and x can be 0 + * to 7 to select the DMA Stream. + * @retval The number of remaining data units in the current DMAy Streamx transfer. + */ +uint16_t DMA_GetCurrDataCounter(DMA_Stream_TypeDef* DMAy_Streamx) +{ + /* Check the parameters */ + assert_param(IS_DMA_ALL_PERIPH(DMAy_Streamx)); + + /* Return the number of remaining data units for DMAy Streamx */ + return ((uint16_t)(DMAy_Streamx->NDTR)); +} +/** + * @} + */ + +/** @defgroup DMA_Group3 Double Buffer mode functions + * @brief Double Buffer mode functions + * +@verbatim + =============================================================================== + ##### Double Buffer mode functions ##### + =============================================================================== + [..] + This subsection provides function allowing to configure and control the double + buffer mode parameters. + + [..] + The Double Buffer mode can be used only when Circular mode is enabled. + The Double Buffer mode cannot be used when transferring data from Memory to Memory. + + [..] + The Double Buffer mode allows to set two different Memory addresses from/to which + the DMA controller will access alternatively (after completing transfer to/from + target memory 0, it will start transfer to/from target memory 1). + This allows to reduce software overhead for double buffering and reduce the CPU + access time. + + [..] + Two functions must be called before calling the DMA_Init() function: + (+) void DMA_DoubleBufferModeConfig(DMA_Stream_TypeDef* DMAy_Streamx, + uint32_t Memory1BaseAddr, uint32_t DMA_CurrentMemory); + (+) void DMA_DoubleBufferModeCmd(DMA_Stream_TypeDef* DMAy_Streamx, FunctionalState NewState); + + [..] + DMA_DoubleBufferModeConfig() is called to configure the Memory 1 base address + and the first Memory target from/to which the transfer will start after + enabling the DMA Stream. Then DMA_DoubleBufferModeCmd() must be called + to enable the Double Buffer mode (or disable it when it should not be used). + + [..] + Two functions can be called dynamically when the transfer is ongoing (or when the DMA Stream is + stopped) to modify on of the target Memories addresses or to check wich Memory target is currently + used: + (+) void DMA_MemoryTargetConfig(DMA_Stream_TypeDef* DMAy_Streamx, + uint32_t MemoryBaseAddr, uint32_t DMA_MemoryTarget); + (+) uint32_t DMA_GetCurrentMemoryTarget(DMA_Stream_TypeDef* DMAy_Streamx); + + [..] + DMA_MemoryTargetConfig() can be called to modify the base address of one of + the two target Memories. + The Memory of which the base address will be modified must not be currently + be used by the DMA Stream (ie. if the DMA Stream is currently transferring + from Memory 1 then you can only modify base address of target Memory 0 and vice versa). + To check this condition, it is recommended to use the function DMA_GetCurrentMemoryTarget() which + returns the index of the Memory target currently in use by the DMA Stream. + +@endverbatim + * @{ + */ + +/** + * @brief Configures, when the DMAy Streamx is disabled, the double buffer mode + * and the current memory target. + * @param DMAy_Streamx: where y can be 1 or 2 to select the DMA and x can be 0 + * to 7 to select the DMA Stream. + * @param Memory1BaseAddr: the base address of the second buffer (Memory 1) + * @param DMA_CurrentMemory: specifies which memory will be first buffer for + * the transactions when the Stream will be enabled. + * This parameter can be one of the following values: + * @arg DMA_Memory_0: Memory 0 is the current buffer. + * @arg DMA_Memory_1: Memory 1 is the current buffer. + * + * @note Memory0BaseAddr is set by the DMA structure configuration in DMA_Init(). + * + * @retval None + */ +void DMA_DoubleBufferModeConfig(DMA_Stream_TypeDef* DMAy_Streamx, uint32_t Memory1BaseAddr, + uint32_t DMA_CurrentMemory) +{ + /* Check the parameters */ + assert_param(IS_DMA_ALL_PERIPH(DMAy_Streamx)); + assert_param(IS_DMA_CURRENT_MEM(DMA_CurrentMemory)); + + if (DMA_CurrentMemory != DMA_Memory_0) + { + /* Set Memory 1 as current memory address */ + DMAy_Streamx->CR |= (uint32_t)(DMA_SxCR_CT); + } + else + { + /* Set Memory 0 as current memory address */ + DMAy_Streamx->CR &= ~(uint32_t)(DMA_SxCR_CT); + } + + /* Write to DMAy Streamx M1AR */ + DMAy_Streamx->M1AR = Memory1BaseAddr; +} + +/** + * @brief Enables or disables the double buffer mode for the selected DMA stream. + * @note This function can be called only when the DMA Stream is disabled. + * @param DMAy_Streamx: where y can be 1 or 2 to select the DMA and x can be 0 + * to 7 to select the DMA Stream. + * @param NewState: new state of the DMAy Streamx double buffer mode. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void DMA_DoubleBufferModeCmd(DMA_Stream_TypeDef* DMAy_Streamx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_DMA_ALL_PERIPH(DMAy_Streamx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + /* Configure the Double Buffer mode */ + if (NewState != DISABLE) + { + /* Enable the Double buffer mode */ + DMAy_Streamx->CR |= (uint32_t)DMA_SxCR_DBM; + } + else + { + /* Disable the Double buffer mode */ + DMAy_Streamx->CR &= ~(uint32_t)DMA_SxCR_DBM; + } +} + +/** + * @brief Configures the Memory address for the next buffer transfer in double + * buffer mode (for dynamic use). This function can be called when the + * DMA Stream is enabled and when the transfer is ongoing. + * @param DMAy_Streamx: where y can be 1 or 2 to select the DMA and x can be 0 + * to 7 to select the DMA Stream. + * @param MemoryBaseAddr: The base address of the target memory buffer + * @param DMA_MemoryTarget: Next memory target to be used. + * This parameter can be one of the following values: + * @arg DMA_Memory_0: To use the memory address 0 + * @arg DMA_Memory_1: To use the memory address 1 + * + * @note It is not allowed to modify the Base Address of a target Memory when + * this target is involved in the current transfer. ie. If the DMA Stream + * is currently transferring to/from Memory 1, then it not possible to + * modify Base address of Memory 1, but it is possible to modify Base + * address of Memory 0. + * To know which Memory is currently used, you can use the function + * DMA_GetCurrentMemoryTarget(). + * + * @retval None + */ +void DMA_MemoryTargetConfig(DMA_Stream_TypeDef* DMAy_Streamx, uint32_t MemoryBaseAddr, + uint32_t DMA_MemoryTarget) +{ + /* Check the parameters */ + assert_param(IS_DMA_ALL_PERIPH(DMAy_Streamx)); + assert_param(IS_DMA_CURRENT_MEM(DMA_MemoryTarget)); + + /* Check the Memory target to be configured */ + if (DMA_MemoryTarget != DMA_Memory_0) + { + /* Write to DMAy Streamx M1AR */ + DMAy_Streamx->M1AR = MemoryBaseAddr; + } + else + { + /* Write to DMAy Streamx M0AR */ + DMAy_Streamx->M0AR = MemoryBaseAddr; + } +} + +/** + * @brief Returns the current memory target used by double buffer transfer. + * @param DMAy_Streamx: where y can be 1 or 2 to select the DMA and x can be 0 + * to 7 to select the DMA Stream. + * @retval The memory target number: 0 for Memory0 or 1 for Memory1. + */ +uint32_t DMA_GetCurrentMemoryTarget(DMA_Stream_TypeDef* DMAy_Streamx) +{ + uint32_t tmp = 0; + + /* Check the parameters */ + assert_param(IS_DMA_ALL_PERIPH(DMAy_Streamx)); + + /* Get the current memory target */ + if ((DMAy_Streamx->CR & DMA_SxCR_CT) != 0) + { + /* Current memory buffer used is Memory 1 */ + tmp = 1; + } + else + { + /* Current memory buffer used is Memory 0 */ + tmp = 0; + } + return tmp; +} +/** + * @} + */ + +/** @defgroup DMA_Group4 Interrupts and flags management functions + * @brief Interrupts and flags management functions + * +@verbatim + =============================================================================== + ##### Interrupts and flags management functions ##### + =============================================================================== + [..] + This subsection provides functions allowing to + (+) Check the DMA enable status + (+) Check the FIFO status + (+) Configure the DMA Interrupts sources and check or clear the flags or + pending bits status. + + [..] + (#) DMA Enable status: + After configuring the DMA Stream (DMA_Init() function) and enabling + the stream, it is recommended to check (or wait until) the DMA Stream + is effectively enabled. A Stream may remain disabled if a configuration + parameter is wrong. After disabling a DMA Stream, it is also recommended + to check (or wait until) the DMA Stream is effectively disabled. + If a Stream is disabled while a data transfer is ongoing, the current + data will be transferred and the Stream will be effectively disabled + only after this data transfer completion. + To monitor this state it is possible to use the following function: + (++) FunctionalState DMA_GetCmdStatus(DMA_Stream_TypeDef* DMAy_Streamx); + + (#) FIFO Status: + It is possible to monitor the FIFO status when a transfer is ongoing + using the following function: + (++) uint32_t DMA_GetFIFOStatus(DMA_Stream_TypeDef* DMAy_Streamx); + + (#) DMA Interrupts and Flags: + The user should identify which mode will be used in his application + to manage the DMA controller events: Polling mode or Interrupt mode. + + *** Polling Mode *** + ==================== + [..] + Each DMA stream can be managed through 4 event Flags: + (x : DMA Stream number ) + (#) DMA_FLAG_FEIFx : to indicate that a FIFO Mode Transfer Error event occurred. + (#) DMA_FLAG_DMEIFx : to indicate that a Direct Mode Transfer Error event occurred. + (#) DMA_FLAG_TEIFx : to indicate that a Transfer Error event occurred. + (#) DMA_FLAG_HTIFx : to indicate that a Half-Transfer Complete event occurred. + (#) DMA_FLAG_TCIFx : to indicate that a Transfer Complete event occurred . + [..] + In this Mode it is advised to use the following functions: + (+) FlagStatus DMA_GetFlagStatus(DMA_Stream_TypeDef* DMAy_Streamx, uint32_t DMA_FLAG); + (+) void DMA_ClearFlag(DMA_Stream_TypeDef* DMAy_Streamx, uint32_t DMA_FLAG); + + *** Interrupt Mode *** + ====================== + [..] + Each DMA Stream can be managed through 4 Interrupts: + + *** Interrupt Source *** + ======================== + [..] + (#) DMA_IT_FEIFx : specifies the interrupt source for the FIFO Mode Transfer Error event. + (#) DMA_IT_DMEIFx : specifies the interrupt source for the Direct Mode Transfer Error event. + (#) DMA_IT_TEIFx : specifies the interrupt source for the Transfer Error event. + (#) DMA_IT_HTIFx : specifies the interrupt source for the Half-Transfer Complete event. + (#) DMA_IT_TCIFx : specifies the interrupt source for the a Transfer Complete event. + [..] + In this Mode it is advised to use the following functions: + (+) void DMA_ITConfig(DMA_Stream_TypeDef* DMAy_Streamx, uint32_t DMA_IT, FunctionalState NewState); + (+) ITStatus DMA_GetITStatus(DMA_Stream_TypeDef* DMAy_Streamx, uint32_t DMA_IT); + (+) void DMA_ClearITPendingBit(DMA_Stream_TypeDef* DMAy_Streamx, uint32_t DMA_IT); + +@endverbatim + * @{ + */ + +/** + * @brief Returns the status of EN bit for the specified DMAy Streamx. + * @param DMAy_Streamx: where y can be 1 or 2 to select the DMA and x can be 0 + * to 7 to select the DMA Stream. + * + * @note After configuring the DMA Stream (DMA_Init() function) and enabling + * the stream, it is recommended to check (or wait until) the DMA Stream + * is effectively enabled. A Stream may remain disabled if a configuration + * parameter is wrong. + * After disabling a DMA Stream, it is also recommended to check (or wait + * until) the DMA Stream is effectively disabled. If a Stream is disabled + * while a data transfer is ongoing, the current data will be transferred + * and the Stream will be effectively disabled only after the transfer + * of this single data is finished. + * + * @retval Current state of the DMAy Streamx (ENABLE or DISABLE). + */ +FunctionalState DMA_GetCmdStatus(DMA_Stream_TypeDef* DMAy_Streamx) +{ + FunctionalState state = DISABLE; + + /* Check the parameters */ + assert_param(IS_DMA_ALL_PERIPH(DMAy_Streamx)); + + if ((DMAy_Streamx->CR & (uint32_t)DMA_SxCR_EN) != 0) + { + /* The selected DMAy Streamx EN bit is set (DMA is still transferring) */ + state = ENABLE; + } + else + { + /* The selected DMAy Streamx EN bit is cleared (DMA is disabled and + all transfers are complete) */ + state = DISABLE; + } + return state; +} + +/** + * @brief Returns the current DMAy Streamx FIFO filled level. + * @param DMAy_Streamx: where y can be 1 or 2 to select the DMA and x can be 0 + * to 7 to select the DMA Stream. + * @retval The FIFO filling state. + * - DMA_FIFOStatus_Less1QuarterFull: when FIFO is less than 1 quarter-full + * and not empty. + * - DMA_FIFOStatus_1QuarterFull: if more than 1 quarter-full. + * - DMA_FIFOStatus_HalfFull: if more than 1 half-full. + * - DMA_FIFOStatus_3QuartersFull: if more than 3 quarters-full. + * - DMA_FIFOStatus_Empty: when FIFO is empty + * - DMA_FIFOStatus_Full: when FIFO is full + */ +uint32_t DMA_GetFIFOStatus(DMA_Stream_TypeDef* DMAy_Streamx) +{ + uint32_t tmpreg = 0; + + /* Check the parameters */ + assert_param(IS_DMA_ALL_PERIPH(DMAy_Streamx)); + + /* Get the FIFO level bits */ + tmpreg = (uint32_t)((DMAy_Streamx->FCR & DMA_SxFCR_FS)); + + return tmpreg; +} + +/** + * @brief Checks whether the specified DMAy Streamx flag is set or not. + * @param DMAy_Streamx: where y can be 1 or 2 to select the DMA and x can be 0 + * to 7 to select the DMA Stream. + * @param DMA_FLAG: specifies the flag to check. + * This parameter can be one of the following values: + * @arg DMA_FLAG_TCIFx: Streamx transfer complete flag + * @arg DMA_FLAG_HTIFx: Streamx half transfer complete flag + * @arg DMA_FLAG_TEIFx: Streamx transfer error flag + * @arg DMA_FLAG_DMEIFx: Streamx direct mode error flag + * @arg DMA_FLAG_FEIFx: Streamx FIFO error flag + * Where x can be 0 to 7 to select the DMA Stream. + * @retval The new state of DMA_FLAG (SET or RESET). + */ +FlagStatus DMA_GetFlagStatus(DMA_Stream_TypeDef* DMAy_Streamx, uint32_t DMA_FLAG) +{ + FlagStatus bitstatus = RESET; + DMA_TypeDef* DMAy; + uint32_t tmpreg = 0; + + /* Check the parameters */ + assert_param(IS_DMA_ALL_PERIPH(DMAy_Streamx)); + assert_param(IS_DMA_GET_FLAG(DMA_FLAG)); + + /* Determine the DMA to which belongs the stream */ + if (DMAy_Streamx < DMA2_Stream0) + { + /* DMAy_Streamx belongs to DMA1 */ + DMAy = DMA1; + } + else + { + /* DMAy_Streamx belongs to DMA2 */ + DMAy = DMA2; + } + + /* Check if the flag is in HISR or LISR */ + if ((DMA_FLAG & HIGH_ISR_MASK) != (uint32_t)RESET) + { + /* Get DMAy HISR register value */ + tmpreg = DMAy->HISR; + } + else + { + /* Get DMAy LISR register value */ + tmpreg = DMAy->LISR; + } + + /* Mask the reserved bits */ + tmpreg &= (uint32_t)RESERVED_MASK; + + /* Check the status of the specified DMA flag */ + if ((tmpreg & DMA_FLAG) != (uint32_t)RESET) + { + /* DMA_FLAG is set */ + bitstatus = SET; + } + else + { + /* DMA_FLAG is reset */ + bitstatus = RESET; + } + + /* Return the DMA_FLAG status */ + return bitstatus; +} + +/** + * @brief Clears the DMAy Streamx's pending flags. + * @param DMAy_Streamx: where y can be 1 or 2 to select the DMA and x can be 0 + * to 7 to select the DMA Stream. + * @param DMA_FLAG: specifies the flag to clear. + * This parameter can be any combination of the following values: + * @arg DMA_FLAG_TCIFx: Streamx transfer complete flag + * @arg DMA_FLAG_HTIFx: Streamx half transfer complete flag + * @arg DMA_FLAG_TEIFx: Streamx transfer error flag + * @arg DMA_FLAG_DMEIFx: Streamx direct mode error flag + * @arg DMA_FLAG_FEIFx: Streamx FIFO error flag + * Where x can be 0 to 7 to select the DMA Stream. + * @retval None + */ +void DMA_ClearFlag(DMA_Stream_TypeDef* DMAy_Streamx, uint32_t DMA_FLAG) +{ + DMA_TypeDef* DMAy; + + /* Check the parameters */ + assert_param(IS_DMA_ALL_PERIPH(DMAy_Streamx)); + assert_param(IS_DMA_CLEAR_FLAG(DMA_FLAG)); + + /* Determine the DMA to which belongs the stream */ + if (DMAy_Streamx < DMA2_Stream0) + { + /* DMAy_Streamx belongs to DMA1 */ + DMAy = DMA1; + } + else + { + /* DMAy_Streamx belongs to DMA2 */ + DMAy = DMA2; + } + + /* Check if LIFCR or HIFCR register is targeted */ + if ((DMA_FLAG & HIGH_ISR_MASK) != (uint32_t)RESET) + { + /* Set DMAy HIFCR register clear flag bits */ + DMAy->HIFCR = (uint32_t)(DMA_FLAG & RESERVED_MASK); + } + else + { + /* Set DMAy LIFCR register clear flag bits */ + DMAy->LIFCR = (uint32_t)(DMA_FLAG & RESERVED_MASK); + } +} + +/** + * @brief Enables or disables the specified DMAy Streamx interrupts. + * @param DMAy_Streamx: where y can be 1 or 2 to select the DMA and x can be 0 + * to 7 to select the DMA Stream. + * @param DMA_IT: specifies the DMA interrupt sources to be enabled or disabled. + * This parameter can be any combination of the following values: + * @arg DMA_IT_TC: Transfer complete interrupt mask + * @arg DMA_IT_HT: Half transfer complete interrupt mask + * @arg DMA_IT_TE: Transfer error interrupt mask + * @arg DMA_IT_FE: FIFO error interrupt mask + * @param NewState: new state of the specified DMA interrupts. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void DMA_ITConfig(DMA_Stream_TypeDef* DMAy_Streamx, uint32_t DMA_IT, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_DMA_ALL_PERIPH(DMAy_Streamx)); + assert_param(IS_DMA_CONFIG_IT(DMA_IT)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + /* Check if the DMA_IT parameter contains a FIFO interrupt */ + if ((DMA_IT & DMA_IT_FE) != 0) + { + if (NewState != DISABLE) + { + /* Enable the selected DMA FIFO interrupts */ + DMAy_Streamx->FCR |= (uint32_t)DMA_IT_FE; + } + else + { + /* Disable the selected DMA FIFO interrupts */ + DMAy_Streamx->FCR &= ~(uint32_t)DMA_IT_FE; + } + } + + /* Check if the DMA_IT parameter contains a Transfer interrupt */ + if (DMA_IT != DMA_IT_FE) + { + if (NewState != DISABLE) + { + /* Enable the selected DMA transfer interrupts */ + DMAy_Streamx->CR |= (uint32_t)(DMA_IT & TRANSFER_IT_ENABLE_MASK); + } + else + { + /* Disable the selected DMA transfer interrupts */ + DMAy_Streamx->CR &= ~(uint32_t)(DMA_IT & TRANSFER_IT_ENABLE_MASK); + } + } +} + +/** + * @brief Checks whether the specified DMAy Streamx interrupt has occurred or not. + * @param DMAy_Streamx: where y can be 1 or 2 to select the DMA and x can be 0 + * to 7 to select the DMA Stream. + * @param DMA_IT: specifies the DMA interrupt source to check. + * This parameter can be one of the following values: + * @arg DMA_IT_TCIFx: Streamx transfer complete interrupt + * @arg DMA_IT_HTIFx: Streamx half transfer complete interrupt + * @arg DMA_IT_TEIFx: Streamx transfer error interrupt + * @arg DMA_IT_DMEIFx: Streamx direct mode error interrupt + * @arg DMA_IT_FEIFx: Streamx FIFO error interrupt + * Where x can be 0 to 7 to select the DMA Stream. + * @retval The new state of DMA_IT (SET or RESET). + */ +ITStatus DMA_GetITStatus(DMA_Stream_TypeDef* DMAy_Streamx, uint32_t DMA_IT) +{ + ITStatus bitstatus = RESET; + DMA_TypeDef* DMAy; + uint32_t tmpreg = 0, enablestatus = 0; + + /* Check the parameters */ + assert_param(IS_DMA_ALL_PERIPH(DMAy_Streamx)); + assert_param(IS_DMA_GET_IT(DMA_IT)); + + /* Determine the DMA to which belongs the stream */ + if (DMAy_Streamx < DMA2_Stream0) + { + /* DMAy_Streamx belongs to DMA1 */ + DMAy = DMA1; + } + else + { + /* DMAy_Streamx belongs to DMA2 */ + DMAy = DMA2; + } + + /* Check if the interrupt enable bit is in the CR or FCR register */ + if ((DMA_IT & TRANSFER_IT_MASK) != (uint32_t)RESET) + { + /* Get the interrupt enable position mask in CR register */ + tmpreg = (uint32_t)((DMA_IT >> 11) & TRANSFER_IT_ENABLE_MASK); + + /* Check the enable bit in CR register */ + enablestatus = (uint32_t)(DMAy_Streamx->CR & tmpreg); + } + else + { + /* Check the enable bit in FCR register */ + enablestatus = (uint32_t)(DMAy_Streamx->FCR & DMA_IT_FE); + } + + /* Check if the interrupt pending flag is in LISR or HISR */ + if ((DMA_IT & HIGH_ISR_MASK) != (uint32_t)RESET) + { + /* Get DMAy HISR register value */ + tmpreg = DMAy->HISR ; + } + else + { + /* Get DMAy LISR register value */ + tmpreg = DMAy->LISR ; + } + + /* mask all reserved bits */ + tmpreg &= (uint32_t)RESERVED_MASK; + + /* Check the status of the specified DMA interrupt */ + if (((tmpreg & DMA_IT) != (uint32_t)RESET) && (enablestatus != (uint32_t)RESET)) + { + /* DMA_IT is set */ + bitstatus = SET; + } + else + { + /* DMA_IT is reset */ + bitstatus = RESET; + } + + /* Return the DMA_IT status */ + return bitstatus; +} + +/** + * @brief Clears the DMAy Streamx's interrupt pending bits. + * @param DMAy_Streamx: where y can be 1 or 2 to select the DMA and x can be 0 + * to 7 to select the DMA Stream. + * @param DMA_IT: specifies the DMA interrupt pending bit to clear. + * This parameter can be any combination of the following values: + * @arg DMA_IT_TCIFx: Streamx transfer complete interrupt + * @arg DMA_IT_HTIFx: Streamx half transfer complete interrupt + * @arg DMA_IT_TEIFx: Streamx transfer error interrupt + * @arg DMA_IT_DMEIFx: Streamx direct mode error interrupt + * @arg DMA_IT_FEIFx: Streamx FIFO error interrupt + * Where x can be 0 to 7 to select the DMA Stream. + * @retval None + */ +void DMA_ClearITPendingBit(DMA_Stream_TypeDef* DMAy_Streamx, uint32_t DMA_IT) +{ + DMA_TypeDef* DMAy; + + /* Check the parameters */ + assert_param(IS_DMA_ALL_PERIPH(DMAy_Streamx)); + assert_param(IS_DMA_CLEAR_IT(DMA_IT)); + + /* Determine the DMA to which belongs the stream */ + if (DMAy_Streamx < DMA2_Stream0) + { + /* DMAy_Streamx belongs to DMA1 */ + DMAy = DMA1; + } + else + { + /* DMAy_Streamx belongs to DMA2 */ + DMAy = DMA2; + } + + /* Check if LIFCR or HIFCR register is targeted */ + if ((DMA_IT & HIGH_ISR_MASK) != (uint32_t)RESET) + { + /* Set DMAy HIFCR register clear interrupt bits */ + DMAy->HIFCR = (uint32_t)(DMA_IT & RESERVED_MASK); + } + else + { + /* Set DMAy LIFCR register clear interrupt bits */ + DMAy->LIFCR = (uint32_t)(DMA_IT & RESERVED_MASK); + } +} + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/src/stm32f4xx_dma2d.c b/FWLIB/src/stm32f4xx_dma2d.c new file mode 100644 index 0000000..6869aab --- /dev/null +++ b/FWLIB/src/stm32f4xx_dma2d.c @@ -0,0 +1,784 @@ +/** + ****************************************************************************** + * @file stm32f4xx_dma2d.c + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file provides firmware functions to manage the following + * functionalities of the DMA2D controller (DMA2D) peripheral: + * + Initialization and configuration + * + Interrupts and flags management + * + @verbatim + =============================================================================== + ##### How to use this driver ##### + =============================================================================== + [..] + (#) Enable DMA2D clock using + RCC_APB2PeriphResetCmd(RCC_APB2Periph_DMA2D, ENABLE) function. + + (#) Configures DMA2D + (++) transfer mode + (++) pixel format, line_number, pixel_per_line + (++) output memory address + (++) alpha value + (++) output offset + (++) Default color (RGB) + + (#) Configures Foreground or/and background + (++) memory address + (++) alpha value + (++) offset and default color + + (#) Call the DMA2D_Start() to enable the DMA2D controller. + + @endverbatim + + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx_dma2d.h" +#include "stm32f4xx_rcc.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @defgroup DMA2D + * @brief DMA2D driver modules + * @{ + */ + +/* Private typedef -----------------------------------------------------------*/ +/* Private define ------------------------------------------------------------*/ +/* Private macro -------------------------------------------------------------*/ +/* Private variables ---------------------------------------------------------*/ +/* Private function prototypes -----------------------------------------------*/ +/* Private functions ---------------------------------------------------------*/ + +#define CR_MASK ((uint32_t)0xFFFCE0FC) /* DMA2D CR Mask */ +#define PFCCR_MASK ((uint32_t)0x00FC00C0) /* DMA2D FGPFCCR Mask */ +#define DEAD_MASK ((uint32_t)0xFFFF00FE) /* DMA2D DEAD Mask */ + +/** @defgroup DMA2D_Private_Functions + * @{ + */ + +/** @defgroup DMA2D_Group1 Initialization and Configuration functions + * @brief Initialization and Configuration functions + * +@verbatim + =============================================================================== + ##### Initialization and Configuration functions ##### + =============================================================================== + [..] This section provides functions allowing to: + (+) Initialize and configure the DMA2D + (+) Start/Abort/Suspend Transfer + (+) Initialize, configure and set Foreground and background + (+) configure and enable DeadTime + (+) configure lineWatermark + + +@endverbatim + * @{ + */ + +/** + * @brief Deinitializes the DMA2D peripheral registers to their default reset + * values. + * @param None + * @retval None + */ + +void DMA2D_DeInit(void) +{ + /* Enable DMA2D reset state */ + RCC_AHB1PeriphResetCmd(RCC_AHB1Periph_DMA2D, ENABLE); + /* Release DMA2D from reset state */ + RCC_AHB1PeriphResetCmd(RCC_AHB1Periph_DMA2D, DISABLE); +} + + +/** + * @brief Initializes the DMA2D peripheral according to the specified parameters + * in the DMA2D_InitStruct. + * @note This function can be used only when the DMA2D is disabled. + * @param DMA2D_InitStruct: pointer to a DMA2D_InitTypeDef structure that contains + * the configuration information for the specified DMA2D peripheral. + * @retval None + */ +void DMA2D_Init(DMA2D_InitTypeDef* DMA2D_InitStruct) +{ + + uint32_t outgreen = 0; + uint32_t outred = 0; + uint32_t outalpha = 0; + uint32_t pixline = 0; + + /* Check the parameters */ + assert_param(IS_DMA2D_MODE(DMA2D_InitStruct->DMA2D_Mode)); + assert_param(IS_DMA2D_CMODE(DMA2D_InitStruct->DMA2D_CMode)); + assert_param(IS_DMA2D_OGREEN(DMA2D_InitStruct->DMA2D_OutputGreen)); + assert_param(IS_DMA2D_ORED(DMA2D_InitStruct->DMA2D_OutputRed)); + assert_param(IS_DMA2D_OBLUE(DMA2D_InitStruct->DMA2D_OutputBlue)); + assert_param(IS_DMA2D_OALPHA(DMA2D_InitStruct->DMA2D_OutputAlpha)); + assert_param(IS_DMA2D_OUTPUT_OFFSET(DMA2D_InitStruct->DMA2D_OutputOffset)); + assert_param(IS_DMA2D_LINE(DMA2D_InitStruct->DMA2D_NumberOfLine)); + assert_param(IS_DMA2D_PIXEL(DMA2D_InitStruct->DMA2D_PixelPerLine)); + + /* Configures the DMA2D operation mode */ + DMA2D->CR &= (uint32_t)CR_MASK; + DMA2D->CR |= (DMA2D_InitStruct->DMA2D_Mode); + + /* Configures the color mode of the output image */ + DMA2D->OPFCCR &= ~(uint32_t)DMA2D_OPFCCR_CM; + DMA2D->OPFCCR |= (DMA2D_InitStruct->DMA2D_CMode); + + /* Configures the output color */ + + if (DMA2D_InitStruct->DMA2D_CMode == DMA2D_ARGB8888) + { + outgreen = DMA2D_InitStruct->DMA2D_OutputGreen << 8; + outred = DMA2D_InitStruct->DMA2D_OutputRed << 16; + outalpha = DMA2D_InitStruct->DMA2D_OutputAlpha << 24; + } + else + + if (DMA2D_InitStruct->DMA2D_CMode == DMA2D_RGB888) + { + outgreen = DMA2D_InitStruct->DMA2D_OutputGreen << 8; + outred = DMA2D_InitStruct->DMA2D_OutputRed << 16; + outalpha = (uint32_t)0x00000000; + } + + else + + if (DMA2D_InitStruct->DMA2D_CMode == DMA2D_RGB565) + { + outgreen = DMA2D_InitStruct->DMA2D_OutputGreen << 5; + outred = DMA2D_InitStruct->DMA2D_OutputRed << 11; + outalpha = (uint32_t)0x00000000; + } + + else + + if (DMA2D_InitStruct->DMA2D_CMode == DMA2D_ARGB1555) + { + outgreen = DMA2D_InitStruct->DMA2D_OutputGreen << 5; + outred = DMA2D_InitStruct->DMA2D_OutputRed << 10; + outalpha = DMA2D_InitStruct->DMA2D_OutputAlpha << 15; + } + + else /* DMA2D_CMode = DMA2D_ARGB4444 */ + { + outgreen = DMA2D_InitStruct->DMA2D_OutputGreen << 4; + outred = DMA2D_InitStruct->DMA2D_OutputRed << 8; + outalpha = DMA2D_InitStruct->DMA2D_OutputAlpha << 12; + } + DMA2D->OCOLR |= ((outgreen) | (outred) | (DMA2D_InitStruct->DMA2D_OutputBlue) | (outalpha)); + + /* Configures the output memory address */ + DMA2D->OMAR = (DMA2D_InitStruct->DMA2D_OutputMemoryAdd); + + /* Configure the line Offset */ + DMA2D->OOR &= ~(uint32_t)DMA2D_OOR_LO; + DMA2D->OOR |= (DMA2D_InitStruct->DMA2D_OutputOffset); + + /* Configure the number of line and pixel per line */ + pixline = DMA2D_InitStruct->DMA2D_PixelPerLine << 16; + DMA2D->NLR &= ~(DMA2D_NLR_NL | DMA2D_NLR_PL); + DMA2D->NLR |= ((DMA2D_InitStruct->DMA2D_NumberOfLine) | (pixline)); + +/** + * @brief Fills each DMA2D_InitStruct member with its default value. + * @param DMA2D_InitStruct: pointer to a DMA2D_InitTypeDef structure which will + * be initialized. + * @retval None + */ +} +void DMA2D_StructInit(DMA2D_InitTypeDef* DMA2D_InitStruct) +{ + /* Initialize the transfer mode member */ + DMA2D_InitStruct->DMA2D_Mode = DMA2D_M2M; + + /* Initialize the output color mode members */ + DMA2D_InitStruct->DMA2D_CMode = DMA2D_ARGB8888; + + /* Initialize the alpha and RGB values */ + DMA2D_InitStruct->DMA2D_OutputGreen = 0x00; + DMA2D_InitStruct->DMA2D_OutputBlue = 0x00; + DMA2D_InitStruct->DMA2D_OutputRed = 0x00; + DMA2D_InitStruct->DMA2D_OutputAlpha = 0x00; + + /* Initialize the output memory address */ + DMA2D_InitStruct->DMA2D_OutputMemoryAdd = 0x00; + + /* Initialize the output offset */ + DMA2D_InitStruct->DMA2D_OutputOffset = 0x00; + + /* Initialize the number of line and the number of pixel per line */ + DMA2D_InitStruct->DMA2D_NumberOfLine = 0x00; + DMA2D_InitStruct->DMA2D_PixelPerLine = 0x00; +} + +/** + * @brief Start the DMA2D transfer. + * @param + * @retval None + */ + +void DMA2D_StartTransfer(void) +{ + /* Start DMA2D transfer by setting START bit */ + DMA2D->CR |= (uint32_t)DMA2D_CR_START; +} + +/** + * @brief Aboart the DMA2D transfer. + * @param + * @retval None + */ + +void DMA2D_AbortTransfer(void) +{ + /* Start DMA2D transfer by setting START bit */ + DMA2D->CR |= (uint32_t)DMA2D_CR_ABORT; + +} + +/** + * @brief Stop or continue the DMA2D transfer. + * @param NewState: new state of the DMA2D peripheral. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void DMA2D_Suspend(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Suspend DMA2D transfer by setting STOP bit */ + DMA2D->CR |= (uint32_t)DMA2D_CR_SUSP; + } + else + { + /* Continue DMA2D transfer by clearing STOP bit */ + DMA2D->CR &= ~(uint32_t)DMA2D_CR_SUSP; + } +} + +/** + * @brief Configures the Foreground according to the specified parameters + * in the DMA2D_FGStruct. + * @note This function can be used only when the transfer is disabled. + * @param DMA2D_FGStruct: pointer to a DMA2D_FGTypeDef structure that contains + * the configuration information for the specified Background. + * @retval None + */ +void DMA2D_FGConfig(DMA2D_FG_InitTypeDef* DMA2D_FG_InitStruct) +{ + + uint32_t fg_clutcolormode = 0; + uint32_t fg_clutsize = 0; + uint32_t fg_alpha_mode = 0; + uint32_t fg_alphavalue = 0; + uint32_t fg_colorgreen = 0; + uint32_t fg_colorred = 0; + + assert_param(IS_DMA2D_FGO(DMA2D_FG_InitStruct->DMA2D_FGO)); + assert_param(IS_DMA2D_FGCM(DMA2D_FG_InitStruct->DMA2D_FGCM)); + assert_param(IS_DMA2D_FG_CLUT_CM(DMA2D_FG_InitStruct->DMA2D_FG_CLUT_CM)); + assert_param(IS_DMA2D_FG_CLUT_SIZE(DMA2D_FG_InitStruct->DMA2D_FG_CLUT_SIZE)); + assert_param(IS_DMA2D_FG_ALPHA_MODE(DMA2D_FG_InitStruct->DMA2D_FGPFC_ALPHA_MODE)); + assert_param(IS_DMA2D_FG_ALPHA_VALUE(DMA2D_FG_InitStruct->DMA2D_FGPFC_ALPHA_VALUE)); + assert_param(IS_DMA2D_FGC_BLUE(DMA2D_FG_InitStruct->DMA2D_FGC_BLUE)); + assert_param(IS_DMA2D_FGC_GREEN(DMA2D_FG_InitStruct->DMA2D_FGC_GREEN)); + assert_param(IS_DMA2D_FGC_RED(DMA2D_FG_InitStruct->DMA2D_FGC_RED)); + + /* Configures the FG memory address */ + DMA2D->FGMAR = (DMA2D_FG_InitStruct->DMA2D_FGMA); + + /* Configures the FG offset */ + DMA2D->FGOR &= ~(uint32_t)DMA2D_FGOR_LO; + DMA2D->FGOR |= (DMA2D_FG_InitStruct->DMA2D_FGO); + + /* Configures foreground Pixel Format Convertor */ + DMA2D->FGPFCCR &= (uint32_t)PFCCR_MASK; + fg_clutcolormode = DMA2D_FG_InitStruct->DMA2D_FG_CLUT_CM << 4; + fg_clutsize = DMA2D_FG_InitStruct->DMA2D_FG_CLUT_SIZE << 8; + fg_alpha_mode = DMA2D_FG_InitStruct->DMA2D_FGPFC_ALPHA_MODE << 16; + fg_alphavalue = DMA2D_FG_InitStruct->DMA2D_FGPFC_ALPHA_VALUE << 24; + DMA2D->FGPFCCR |= (DMA2D_FG_InitStruct->DMA2D_FGCM | fg_clutcolormode | fg_clutsize | \ + fg_alpha_mode | fg_alphavalue); + + /* Configures foreground color */ + DMA2D->FGCOLR &= ~(DMA2D_FGCOLR_BLUE | DMA2D_FGCOLR_GREEN | DMA2D_FGCOLR_RED); + fg_colorgreen = DMA2D_FG_InitStruct->DMA2D_FGC_GREEN << 8; + fg_colorred = DMA2D_FG_InitStruct->DMA2D_FGC_RED << 16; + DMA2D->FGCOLR |= (DMA2D_FG_InitStruct->DMA2D_FGC_BLUE | fg_colorgreen | fg_colorred); + + /* Configures foreground CLUT memory address */ + DMA2D->FGCMAR = DMA2D_FG_InitStruct->DMA2D_FGCMAR; +} + +/** + * @brief Fills each DMA2D_FGStruct member with its default value. + * @param DMA2D_FGStruct: pointer to a DMA2D_FGTypeDef structure which will + * be initialized. + * @retval None + */ +void DMA2D_FG_StructInit(DMA2D_FG_InitTypeDef* DMA2D_FG_InitStruct) +{ + /*!< Initialize the DMA2D foreground memory address */ + DMA2D_FG_InitStruct->DMA2D_FGMA = 0x00; + + /*!< Initialize the DMA2D foreground offset */ + DMA2D_FG_InitStruct->DMA2D_FGO = 0x00; + + /*!< Initialize the DMA2D foreground color mode */ + DMA2D_FG_InitStruct->DMA2D_FGCM = CM_ARGB8888; + + /*!< Initialize the DMA2D foreground CLUT color mode */ + DMA2D_FG_InitStruct->DMA2D_FG_CLUT_CM = CLUT_CM_ARGB8888; + + /*!< Initialize the DMA2D foreground CLUT size */ + DMA2D_FG_InitStruct->DMA2D_FG_CLUT_SIZE = 0x00; + + /*!< Initialize the DMA2D foreground alpha mode */ + DMA2D_FG_InitStruct->DMA2D_FGPFC_ALPHA_MODE = NO_MODIF_ALPHA_VALUE; + + /*!< Initialize the DMA2D foreground alpha value */ + DMA2D_FG_InitStruct->DMA2D_FGPFC_ALPHA_VALUE = 0x00; + + /*!< Initialize the DMA2D foreground blue value */ + DMA2D_FG_InitStruct->DMA2D_FGC_BLUE = 0x00; + + /*!< Initialize the DMA2D foreground green value */ + DMA2D_FG_InitStruct->DMA2D_FGC_GREEN = 0x00; + + /*!< Initialize the DMA2D foreground red value */ + DMA2D_FG_InitStruct->DMA2D_FGC_RED = 0x00; + + /*!< Initialize the DMA2D foreground CLUT memory address */ + DMA2D_FG_InitStruct->DMA2D_FGCMAR = 0x00; +} + + +/** + * @brief Configures the Background according to the specified parameters + * in the DMA2D_BGStruct. + * @note This function can be used only when the transfer is disabled. + * @param DMA2D_BGStruct: pointer to a DMA2D_BGTypeDef structure that contains + * the configuration information for the specified Background. + * @retval None + */ +void DMA2D_BGConfig(DMA2D_BG_InitTypeDef* DMA2D_BG_InitStruct) +{ + + uint32_t bg_clutcolormode = 0; + uint32_t bg_clutsize = 0; + uint32_t bg_alpha_mode = 0; + uint32_t bg_alphavalue = 0; + uint32_t bg_colorgreen = 0; + uint32_t bg_colorred = 0; + + assert_param(IS_DMA2D_BGO(DMA2D_BG_InitStruct->DMA2D_BGO)); + assert_param(IS_DMA2D_BGCM(DMA2D_BG_InitStruct->DMA2D_BGCM)); + assert_param(IS_DMA2D_BG_CLUT_CM(DMA2D_BG_InitStruct->DMA2D_BG_CLUT_CM)); + assert_param(IS_DMA2D_BG_CLUT_SIZE(DMA2D_BG_InitStruct->DMA2D_BG_CLUT_SIZE)); + assert_param(IS_DMA2D_BG_ALPHA_MODE(DMA2D_BG_InitStruct->DMA2D_BGPFC_ALPHA_MODE)); + assert_param(IS_DMA2D_BG_ALPHA_VALUE(DMA2D_BG_InitStruct->DMA2D_BGPFC_ALPHA_VALUE)); + assert_param(IS_DMA2D_BGC_BLUE(DMA2D_BG_InitStruct->DMA2D_BGC_BLUE)); + assert_param(IS_DMA2D_BGC_GREEN(DMA2D_BG_InitStruct->DMA2D_BGC_GREEN)); + assert_param(IS_DMA2D_BGC_RED(DMA2D_BG_InitStruct->DMA2D_BGC_RED)); + + /* Configures the BG memory address */ + DMA2D->BGMAR = (DMA2D_BG_InitStruct->DMA2D_BGMA); + + /* Configures the BG offset */ + DMA2D->BGOR &= ~(uint32_t)DMA2D_BGOR_LO; + DMA2D->BGOR |= (DMA2D_BG_InitStruct->DMA2D_BGO); + + /* Configures background Pixel Format Convertor */ + DMA2D->BGPFCCR &= (uint32_t)PFCCR_MASK; + bg_clutcolormode = DMA2D_BG_InitStruct->DMA2D_BG_CLUT_CM << 4; + bg_clutsize = DMA2D_BG_InitStruct->DMA2D_BG_CLUT_SIZE << 8; + bg_alpha_mode = DMA2D_BG_InitStruct->DMA2D_BGPFC_ALPHA_MODE << 16; + bg_alphavalue = DMA2D_BG_InitStruct->DMA2D_BGPFC_ALPHA_VALUE << 24; + DMA2D->BGPFCCR |= (DMA2D_BG_InitStruct->DMA2D_BGCM | bg_clutcolormode | bg_clutsize | \ + bg_alpha_mode | bg_alphavalue); + + /* Configures background color */ + DMA2D->BGCOLR &= ~(DMA2D_BGCOLR_BLUE | DMA2D_BGCOLR_GREEN | DMA2D_BGCOLR_RED); + bg_colorgreen = DMA2D_BG_InitStruct->DMA2D_BGC_GREEN << 8; + bg_colorred = DMA2D_BG_InitStruct->DMA2D_BGC_RED << 16; + DMA2D->BGCOLR |= (DMA2D_BG_InitStruct->DMA2D_BGC_BLUE | bg_colorgreen | bg_colorred); + + /* Configures background CLUT memory address */ + DMA2D->BGCMAR = DMA2D_BG_InitStruct->DMA2D_BGCMAR; + +} + +/** + * @brief Fills each DMA2D_BGStruct member with its default value. + * @param DMA2D_BGStruct: pointer to a DMA2D_BGTypeDef structure which will + * be initialized. + * @retval None + */ +void DMA2D_BG_StructInit(DMA2D_BG_InitTypeDef* DMA2D_BG_InitStruct) +{ + /*!< Initialize the DMA2D background memory address */ + DMA2D_BG_InitStruct->DMA2D_BGMA = 0x00; + + /*!< Initialize the DMA2D background offset */ + DMA2D_BG_InitStruct->DMA2D_BGO = 0x00; + + /*!< Initialize the DMA2D background color mode */ + DMA2D_BG_InitStruct->DMA2D_BGCM = CM_ARGB8888; + + /*!< Initialize the DMA2D background CLUT color mode */ + DMA2D_BG_InitStruct->DMA2D_BG_CLUT_CM = CLUT_CM_ARGB8888; + + /*!< Initialize the DMA2D background CLUT size */ + DMA2D_BG_InitStruct->DMA2D_BG_CLUT_SIZE = 0x00; + + /*!< Initialize the DMA2D background alpha mode */ + DMA2D_BG_InitStruct->DMA2D_BGPFC_ALPHA_MODE = NO_MODIF_ALPHA_VALUE; + + /*!< Initialize the DMA2D background alpha value */ + DMA2D_BG_InitStruct->DMA2D_BGPFC_ALPHA_VALUE = 0x00; + + /*!< Initialize the DMA2D background blue value */ + DMA2D_BG_InitStruct->DMA2D_BGC_BLUE = 0x00; + + /*!< Initialize the DMA2D background green value */ + DMA2D_BG_InitStruct->DMA2D_BGC_GREEN = 0x00; + + /*!< Initialize the DMA2D background red value */ + DMA2D_BG_InitStruct->DMA2D_BGC_RED = 0x00; + + /*!< Initialize the DMA2D background CLUT memory address */ + DMA2D_BG_InitStruct->DMA2D_BGCMAR = 0x00; +} + +/** + * @brief Start the automatic loading of the CLUT or abort the transfer. + * @param NewState: new state of the DMA2D peripheral. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ + +void DMA2D_FGStart(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Start the automatic loading of the CLUT */ + DMA2D->FGPFCCR |= DMA2D_FGPFCCR_START; + } + else + { + /* abort the transfer */ + DMA2D->FGPFCCR &= (uint32_t)~DMA2D_FGPFCCR_START; + } +} + +/** + * @brief Start the automatic loading of the CLUT or abort the transfer. + * @param NewState: new state of the DMA2D peripheral. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ + +void DMA2D_BGStart(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Start the automatic loading of the CLUT */ + DMA2D->BGPFCCR |= DMA2D_BGPFCCR_START; + } + else + { + /* abort the transfer */ + DMA2D->BGPFCCR &= (uint32_t)~DMA2D_BGPFCCR_START; + } +} + +/** + * @brief Configures the DMA2D dead time. + * @param DMA2D_DeadTime: specifies the DMA2D dead time. + * This parameter can be one of the following values: + * @retval None + */ +void DMA2D_DeadTimeConfig(uint32_t DMA2D_DeadTime, FunctionalState NewState) +{ + uint32_t DeadTime; + + /* Check the parameters */ + assert_param(IS_DMA2D_DEAD_TIME(DMA2D_DeadTime)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable and Configures the dead time */ + DMA2D->AMTCR &= (uint32_t)DEAD_MASK; + DeadTime = DMA2D_DeadTime << 8; + DMA2D->AMTCR |= (DeadTime | DMA2D_AMTCR_EN); + } + else + { + DMA2D->AMTCR &= ~(uint32_t)DMA2D_AMTCR_EN; + } +} + +/** + * @brief Define the configuration of the line watermark . + * @param DMA2D_LWatermarkConfig: Line Watermark configuration. + * @retval None + */ + +void DMA2D_LineWatermarkConfig(uint32_t DMA2D_LWatermarkConfig) +{ + /* Check the parameters */ + assert_param(IS_DMA2D_LineWatermark(DMA2D_LWatermarkConfig)); + + /* Sets the Line watermark configuration */ + DMA2D->LWR = (uint32_t)DMA2D_LWatermarkConfig; +} + +/** + * @} + */ + +/** @defgroup DMA2D_Group2 Interrupts and flags management functions + * @brief Interrupts and flags management functions + * +@verbatim + =============================================================================== + ##### Interrupts and flags management functions ##### + =============================================================================== + + [..] This section provides functions allowing to configure the DMA2D + Interrupts and to get the status and clear flags and Interrupts + pending bits. + [..] The DMA2D provides 6 Interrupts sources and 6 Flags + + *** Flags *** + ============= + [..] + (+) DMA2D_FLAG_CE : Configuration Error Interrupt flag + (+) DMA2D_FLAG_CAE: CLUT Access Error Interrupt flag + (+) DMA2D_FLAG_TW: Transfer Watermark Interrupt flag + (+) DMA2D_FLAG_TC: Transfer Complete interrupt flag + (+) DMA2D_FLAG_TE: Transfer Error interrupt flag + (+) DMA2D_FLAG_CTC: CLUT Transfer Complete Interrupt flag + + *** Interrupts *** + ================== + [..] + (+) DMA2D_IT_CE: Configuration Error Interrupt is generated when a wrong + configuration is detected + (+) DMA2D_IT_CAE: CLUT Access Error Interrupt + (+) DMA2D_IT_TW: Transfer Watermark Interrupt is generated when + the programmed watermark is reached + (+) DMA2D_IT_TE: Transfer Error interrupt is generated when the CPU trying + to access the CLUT while a CLUT loading or a DMA2D1 transfer + is on going + (+) DMA2D_IT_CTC: CLUT Transfer Complete Interrupt + (+) DMA2D_IT_TC: Transfer Complete interrupt +@endverbatim + * @{ + */ +/** + * @brief Enables or disables the specified DMA2D's interrupts. + * @param DMA2D_IT: specifies the DMA2D interrupts sources to be enabled or disabled. + * This parameter can be any combination of the following values: + * @arg DMA2D_IT_CE: Configuration Error Interrupt Enable. + * @arg DMA2D_IT_CTC: CLUT Transfer Complete Interrupt Enable. + * @arg DMA2D_IT_CAE: CLUT Access Error Interrupt Enable. + * @arg DMA2D_IT_TW: Transfer Watermark Interrupt Enable. + * @arg DMA2D_IT_TC: Transfer Complete interrupt enable. + * @arg DMA2D_IT_TE: Transfer Error interrupt enable. + * @param NewState: new state of the specified DMA2D interrupts. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ + +void DMA2D_ITConfig(uint32_t DMA2D_IT, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_DMA2D_IT(DMA2D_IT)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the selected DMA2D interrupts */ + DMA2D->CR |= DMA2D_IT; + } + else + { + /* Disable the selected DMA2D interrupts */ + DMA2D->CR &= (uint32_t)~DMA2D_IT; + } +} + +/** + * @brief Checks whether the specified DMA2D's flag is set or not. + * @param DMA2D_FLAG: specifies the flag to check. + * This parameter can be one of the following values: + * @arg DMA2D_FLAG_CE: Configuration Error Interrupt flag. + * @arg DMA2D_FLAG_CTC: CLUT Transfer Complete Interrupt flag. + * @arg DMA2D_FLAG_CAE: CLUT Access Error Interrupt flag. + * @arg DMA2D_FLAG_TW: Transfer Watermark Interrupt flag. + * @arg DMA2D_FLAG_TC: Transfer Complete interrupt flag. + * @arg DMA2D_FLAG_TE: Transfer Error interrupt flag. + * @retval The new state of DMA2D_FLAG (SET or RESET). + */ + +FlagStatus DMA2D_GetFlagStatus(uint32_t DMA2D_FLAG) +{ + FlagStatus bitstatus = RESET; + + /* Check the parameters */ + assert_param(IS_DMA2D_GET_FLAG(DMA2D_FLAG)); + + /* Check the status of the specified DMA2D flag */ + if (((DMA2D->ISR) & DMA2D_FLAG) != (uint32_t)RESET) + { + /* DMA2D_FLAG is set */ + bitstatus = SET; + } + else + { + /* DMA2D_FLAG is reset */ + bitstatus = RESET; + } + /* Return the DMA2D_FLAG status */ + return bitstatus; +} + +/** + * @brief Clears the DMA2D's pending flags. + * @param DMA2D_FLAG: specifies the flag to clear. + * This parameter can be any combination of the following values: + * @arg DMA2D_FLAG_CE: Configuration Error Interrupt flag. + * @arg DMA2D_FLAG_CTC: CLUT Transfer Complete Interrupt flag. + * @arg DMA2D_FLAG_CAE: CLUT Access Error Interrupt flag. + * @arg DMA2D_FLAG_TW: Transfer Watermark Interrupt flag. + * @arg DMA2D_FLAG_TC: Transfer Complete interrupt flag. + * @arg DMA2D_FLAG_TE: Transfer Error interrupt flag. + * @retval None + */ +void DMA2D_ClearFlag(uint32_t DMA2D_FLAG) +{ + /* Check the parameters */ + assert_param(IS_DMA2D_GET_FLAG(DMA2D_FLAG)); + + /* Clear the corresponding DMA2D flag */ + DMA2D->IFCR = (uint32_t)DMA2D_FLAG; +} + +/** + * @brief Checks whether the specified DMA2D's interrupt has occurred or not. + * @param DMA2D_IT: specifies the DMA2D interrupts sources to check. + * This parameter can be one of the following values: + * @arg DMA2D_IT_CE: Configuration Error Interrupt Enable. + * @arg DMA2D_IT_CTC: CLUT Transfer Complete Interrupt Enable. + * @arg DMA2D_IT_CAE: CLUT Access Error Interrupt Enable. + * @arg DMA2D_IT_TW: Transfer Watermark Interrupt Enable. + * @arg DMA2D_IT_TC: Transfer Complete interrupt enable. + * @arg DMA2D_IT_TE: Transfer Error interrupt enable. + * @retval The new state of the DMA2D_IT (SET or RESET). + */ +ITStatus DMA2D_GetITStatus(uint32_t DMA2D_IT) +{ + ITStatus bitstatus = RESET; + uint32_t DMA2D_IT_FLAG = DMA2D_IT >> 8; + + /* Check the parameters */ + assert_param(IS_DMA2D_IT(DMA2D_IT)); + + if ((DMA2D->ISR & DMA2D_IT_FLAG) != (uint32_t)RESET) + { + bitstatus = SET; + } + else + { + bitstatus = RESET; + } + + if (((DMA2D->CR & DMA2D_IT) != (uint32_t)RESET) && (bitstatus != (uint32_t)RESET)) + { + bitstatus = SET; + } + else + { + bitstatus = RESET; + } + return bitstatus; +} + +/** + * @brief Clears the DMA2D's interrupt pending bits. + * @param DMA2D_IT: specifies the interrupt pending bit to clear. + * This parameter can be any combination of the following values: + * @arg DMA2D_IT_CE: Configuration Error Interrupt. + * @arg DMA2D_IT_CTC: CLUT Transfer Complete Interrupt. + * @arg DMA2D_IT_CAE: CLUT Access Error Interrupt. + * @arg DMA2D_IT_TW: Transfer Watermark Interrupt. + * @arg DMA2D_IT_TC: Transfer Complete interrupt. + * @arg DMA2D_IT_TE: Transfer Error interrupt. + * @retval None + */ +void DMA2D_ClearITPendingBit(uint32_t DMA2D_IT) +{ + /* Check the parameters */ + assert_param(IS_DMA2D_IT(DMA2D_IT)); + DMA2D_IT = DMA2D_IT >> 8; + + /* Clear the corresponding DMA2D Interrupt */ + DMA2D->IFCR = (uint32_t)DMA2D_IT; +} + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/src/stm32f4xx_exti.c b/FWLIB/src/stm32f4xx_exti.c new file mode 100644 index 0000000..433a8bf --- /dev/null +++ b/FWLIB/src/stm32f4xx_exti.c @@ -0,0 +1,311 @@ +/** + ****************************************************************************** + * @file stm32f4xx_exti.c + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file provides firmware functions to manage the following + * functionalities of the EXTI peripheral: + * + Initialization and Configuration + * + Interrupts and flags management + * +@verbatim + + =============================================================================== + ##### EXTI features ##### + =============================================================================== + + [..] External interrupt/event lines are mapped as following: + (#) All available GPIO pins are connected to the 16 external + interrupt/event lines from EXTI0 to EXTI15. + (#) EXTI line 16 is connected to the PVD Output + (#) EXTI line 17 is connected to the RTC Alarm event + (#) EXTI line 18 is connected to the USB OTG FS Wakeup from suspend event + (#) EXTI line 19 is connected to the Ethernet Wakeup event + (#) EXTI line 20 is connected to the USB OTG HS (configured in FS) Wakeup event + (#) EXTI line 21 is connected to the RTC Tamper and Time Stamp events + (#) EXTI line 22 is connected to the RTC Wakeup event + + ##### How to use this driver ##### + =============================================================================== + + [..] In order to use an I/O pin as an external interrupt source, follow steps + below: + (#) Configure the I/O in input mode using GPIO_Init() + (#) Select the input source pin for the EXTI line using SYSCFG_EXTILineConfig() + (#) Select the mode(interrupt, event) and configure the trigger + selection (Rising, falling or both) using EXTI_Init() + (#) Configure NVIC IRQ channel mapped to the EXTI line using NVIC_Init() + + [..] + (@) SYSCFG APB clock must be enabled to get write access to SYSCFG_EXTICRx + registers using RCC_APB2PeriphClockCmd(RCC_APB2Periph_SYSCFG, ENABLE); + +@endverbatim + * + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx_exti.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @defgroup EXTI + * @brief EXTI driver modules + * @{ + */ + +/* Private typedef -----------------------------------------------------------*/ +/* Private define ------------------------------------------------------------*/ + +#define EXTI_LINENONE ((uint32_t)0x00000) /* No interrupt selected */ + +/* Private macro -------------------------------------------------------------*/ +/* Private variables ---------------------------------------------------------*/ +/* Private function prototypes -----------------------------------------------*/ +/* Private functions ---------------------------------------------------------*/ + +/** @defgroup EXTI_Private_Functions + * @{ + */ + +/** @defgroup EXTI_Group1 Initialization and Configuration functions + * @brief Initialization and Configuration functions + * +@verbatim + =============================================================================== + ##### Initialization and Configuration functions ##### + =============================================================================== + +@endverbatim + * @{ + */ + +/** + * @brief Deinitializes the EXTI peripheral registers to their default reset values. + * @param None + * @retval None + */ +void EXTI_DeInit(void) +{ + EXTI->IMR = 0x00000000; + EXTI->EMR = 0x00000000; + EXTI->RTSR = 0x00000000; + EXTI->FTSR = 0x00000000; + EXTI->PR = 0x007FFFFF; +} + +/** + * @brief Initializes the EXTI peripheral according to the specified + * parameters in the EXTI_InitStruct. + * @param EXTI_InitStruct: pointer to a EXTI_InitTypeDef structure + * that contains the configuration information for the EXTI peripheral. + * @retval None + */ +void EXTI_Init(EXTI_InitTypeDef* EXTI_InitStruct) +{ + uint32_t tmp = 0; + + /* Check the parameters */ + assert_param(IS_EXTI_MODE(EXTI_InitStruct->EXTI_Mode)); + assert_param(IS_EXTI_TRIGGER(EXTI_InitStruct->EXTI_Trigger)); + assert_param(IS_EXTI_LINE(EXTI_InitStruct->EXTI_Line)); + assert_param(IS_FUNCTIONAL_STATE(EXTI_InitStruct->EXTI_LineCmd)); + + tmp = (uint32_t)EXTI_BASE; + + if (EXTI_InitStruct->EXTI_LineCmd != DISABLE) + { + /* Clear EXTI line configuration */ + EXTI->IMR &= ~EXTI_InitStruct->EXTI_Line; + EXTI->EMR &= ~EXTI_InitStruct->EXTI_Line; + + tmp += EXTI_InitStruct->EXTI_Mode; + + *(__IO uint32_t *) tmp |= EXTI_InitStruct->EXTI_Line; + + /* Clear Rising Falling edge configuration */ + EXTI->RTSR &= ~EXTI_InitStruct->EXTI_Line; + EXTI->FTSR &= ~EXTI_InitStruct->EXTI_Line; + + /* Select the trigger for the selected external interrupts */ + if (EXTI_InitStruct->EXTI_Trigger == EXTI_Trigger_Rising_Falling) + { + /* Rising Falling edge */ + EXTI->RTSR |= EXTI_InitStruct->EXTI_Line; + EXTI->FTSR |= EXTI_InitStruct->EXTI_Line; + } + else + { + tmp = (uint32_t)EXTI_BASE; + tmp += EXTI_InitStruct->EXTI_Trigger; + + *(__IO uint32_t *) tmp |= EXTI_InitStruct->EXTI_Line; + } + } + else + { + tmp += EXTI_InitStruct->EXTI_Mode; + + /* Disable the selected external lines */ + *(__IO uint32_t *) tmp &= ~EXTI_InitStruct->EXTI_Line; + } +} + +/** + * @brief Fills each EXTI_InitStruct member with its reset value. + * @param EXTI_InitStruct: pointer to a EXTI_InitTypeDef structure which will + * be initialized. + * @retval None + */ +void EXTI_StructInit(EXTI_InitTypeDef* EXTI_InitStruct) +{ + EXTI_InitStruct->EXTI_Line = EXTI_LINENONE; + EXTI_InitStruct->EXTI_Mode = EXTI_Mode_Interrupt; + EXTI_InitStruct->EXTI_Trigger = EXTI_Trigger_Falling; + EXTI_InitStruct->EXTI_LineCmd = DISABLE; +} + +/** + * @brief Generates a Software interrupt on selected EXTI line. + * @param EXTI_Line: specifies the EXTI line on which the software interrupt + * will be generated. + * This parameter can be any combination of EXTI_Linex where x can be (0..22) + * @retval None + */ +void EXTI_GenerateSWInterrupt(uint32_t EXTI_Line) +{ + /* Check the parameters */ + assert_param(IS_EXTI_LINE(EXTI_Line)); + + EXTI->SWIER |= EXTI_Line; +} + +/** + * @} + */ + +/** @defgroup EXTI_Group2 Interrupts and flags management functions + * @brief Interrupts and flags management functions + * +@verbatim + =============================================================================== + ##### Interrupts and flags management functions ##### + =============================================================================== + +@endverbatim + * @{ + */ + +/** + * @brief Checks whether the specified EXTI line flag is set or not. + * @param EXTI_Line: specifies the EXTI line flag to check. + * This parameter can be EXTI_Linex where x can be(0..22) + * @retval The new state of EXTI_Line (SET or RESET). + */ +FlagStatus EXTI_GetFlagStatus(uint32_t EXTI_Line) +{ + FlagStatus bitstatus = RESET; + /* Check the parameters */ + assert_param(IS_GET_EXTI_LINE(EXTI_Line)); + + if ((EXTI->PR & EXTI_Line) != (uint32_t)RESET) + { + bitstatus = SET; + } + else + { + bitstatus = RESET; + } + return bitstatus; +} + +/** + * @brief Clears the EXTI's line pending flags. + * @param EXTI_Line: specifies the EXTI lines flags to clear. + * This parameter can be any combination of EXTI_Linex where x can be (0..22) + * @retval None + */ +void EXTI_ClearFlag(uint32_t EXTI_Line) +{ + /* Check the parameters */ + assert_param(IS_EXTI_LINE(EXTI_Line)); + + EXTI->PR = EXTI_Line; +} + +/** + * @brief Checks whether the specified EXTI line is asserted or not. + * @param EXTI_Line: specifies the EXTI line to check. + * This parameter can be EXTI_Linex where x can be(0..22) + * @retval The new state of EXTI_Line (SET or RESET). + */ +ITStatus EXTI_GetITStatus(uint32_t EXTI_Line) +{ + FlagStatus bitstatus = RESET; + /* Check the parameters */ + assert_param(IS_GET_EXTI_LINE(EXTI_Line)); + + if ((EXTI->PR & EXTI_Line) != (uint32_t)RESET) + { + bitstatus = SET; + } + else + { + bitstatus = RESET; + } + return bitstatus; + +} + +/** + * @brief Clears the EXTI's line pending bits. + * @param EXTI_Line: specifies the EXTI lines to clear. + * This parameter can be any combination of EXTI_Linex where x can be (0..22) + * @retval None + */ +void EXTI_ClearITPendingBit(uint32_t EXTI_Line) +{ + /* Check the parameters */ + assert_param(IS_EXTI_LINE(EXTI_Line)); + + EXTI->PR = EXTI_Line; +} + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/src/stm32f4xx_flash.c b/FWLIB/src/stm32f4xx_flash.c new file mode 100644 index 0000000..c077b6b --- /dev/null +++ b/FWLIB/src/stm32f4xx_flash.c @@ -0,0 +1,1612 @@ +/** + ****************************************************************************** + * @file stm32f4xx_flash.c + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file provides firmware functions to manage the following + * functionalities of the FLASH peripheral: + * + FLASH Interface configuration + * + FLASH Memory Programming + * + Option Bytes Programming + * + Interrupts and flags management + * + @verbatim + =============================================================================== + ##### How to use this driver ##### + =============================================================================== + [..] + This driver provides functions to configure and program the FLASH memory + of all STM32F4xx devices. These functions are split in 4 groups: + + (#) FLASH Interface configuration functions: this group includes the + management of the following features: + (++) Set the latency + (++) Enable/Disable the prefetch buffer + (++) Enable/Disable the Instruction cache and the Data cache + (++) Reset the Instruction cache and the Data cache + + (#) FLASH Memory Programming functions: this group includes all needed + functions to erase and program the main memory: + (++) Lock and Unlock the FLASH interface + (++) Erase function: Erase sector, erase all sectors + (++) Program functions: byte, half word, word and double word + + (#) Option Bytes Programming functions: this group includes all needed + functions to manage the Option Bytes: + (++) Set/Reset the write protection + (++) Set the Read protection Level + (++) Set the BOR level + (++) Program the user Option Bytes + (++) Launch the Option Bytes loader + + (#) Interrupts and flags management functions: this group + includes all needed functions to: + (++) Enable/Disable the FLASH interrupt sources + (++) Get flags status + (++) Clear flags + (++) Get FLASH operation status + (++) Wait for last FLASH operation + @endverbatim + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx_flash.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @defgroup FLASH + * @brief FLASH driver modules + * @{ + */ + +/* Private typedef -----------------------------------------------------------*/ +/* Private define ------------------------------------------------------------*/ +#define SECTOR_MASK ((uint32_t)0xFFFFFF07) + +/* Private macro -------------------------------------------------------------*/ +/* Private variables ---------------------------------------------------------*/ +/* Private function prototypes -----------------------------------------------*/ +/* Private functions ---------------------------------------------------------*/ + +/** @defgroup FLASH_Private_Functions + * @{ + */ + +/** @defgroup FLASH_Group1 FLASH Interface configuration functions + * @brief FLASH Interface configuration functions + * + +@verbatim + =============================================================================== + ##### FLASH Interface configuration functions ##### + =============================================================================== + [..] + This group includes the following functions: + (+) void FLASH_SetLatency(uint32_t FLASH_Latency) + To correctly read data from FLASH memory, the number of wait states (LATENCY) + must be correctly programmed according to the frequency of the CPU clock + (HCLK) and the supply voltage of the device. + [..] + For STM32F405xx/07xx and STM32F415xx/17xx devices + +-------------------------------------------------------------------------------------+ + | Latency | HCLK clock frequency (MHz) | + | |---------------------------------------------------------------------| + | | voltage range | voltage range | voltage range | voltage range | + | | 2.7 V - 3.6 V | 2.4 V - 2.7 V | 2.1 V - 2.4 V | 1.8 V - 2.1 V | + |---------------|----------------|----------------|-----------------|-----------------| + |0WS(1CPU cycle)|0 < HCLK <= 30 |0 < HCLK <= 24 |0 < HCLK <= 22 |0 < HCLK <= 20 | + |---------------|----------------|----------------|-----------------|-----------------| + |1WS(2CPU cycle)|30 < HCLK <= 60 |24 < HCLK <= 48 |22 < HCLK <= 44 |20 < HCLK <= 40 | + |---------------|----------------|----------------|-----------------|-----------------| + |2WS(3CPU cycle)|60 < HCLK <= 90 |48 < HCLK <= 72 |44 < HCLK <= 66 |40 < HCLK <= 60 | + |---------------|----------------|----------------|-----------------|-----------------| + |3WS(4CPU cycle)|90 < HCLK <= 120|72 < HCLK <= 96 |66 < HCLK <= 88 |60 < HCLK <= 80 | + |---------------|----------------|----------------|-----------------|-----------------| + |4WS(5CPU cycle)|120< HCLK <= 150|96 < HCLK <= 120|88 < HCLK <= 110 |80 < HCLK <= 100 | + |---------------|----------------|----------------|-----------------|-----------------| + |5WS(6CPU cycle)|150< HCLK <= 168|120< HCLK <= 144|110 < HCLK <= 132|100 < HCLK <= 120| + |---------------|----------------|----------------|-----------------|-----------------| + |6WS(7CPU cycle)| NA |144< HCLK <= 168|132 < HCLK <= 154|120 < HCLK <= 140| + |---------------|----------------|----------------|-----------------|-----------------| + |7WS(8CPU cycle)| NA | NA |154 < HCLK <= 168|140 < HCLK <= 160| + +---------------|----------------|----------------|-----------------|-----------------+ + + [..] + For STM32F42xxx/43xxx devices + +-------------------------------------------------------------------------------------+ + | Latency | HCLK clock frequency (MHz) | + | |---------------------------------------------------------------------| + | | voltage range | voltage range | voltage range | voltage range | + | | 2.7 V - 3.6 V | 2.4 V - 2.7 V | 2.1 V - 2.4 V | 1.8 V - 2.1 V | + |---------------|----------------|----------------|-----------------|-----------------| + |0WS(1CPU cycle)|0 < HCLK <= 30 |0 < HCLK <= 24 |0 < HCLK <= 22 |0 < HCLK <= 20 | + |---------------|----------------|----------------|-----------------|-----------------| + |1WS(2CPU cycle)|30 < HCLK <= 60 |24 < HCLK <= 48 |22 < HCLK <= 44 |20 < HCLK <= 40 | + |---------------|----------------|----------------|-----------------|-----------------| + |2WS(3CPU cycle)|60 < HCLK <= 90 |48 < HCLK <= 72 |44 < HCLK <= 66 |40 < HCLK <= 60 | + |---------------|----------------|----------------|-----------------|-----------------| + |3WS(4CPU cycle)|90 < HCLK <= 120|72 < HCLK <= 96 |66 < HCLK <= 88 |60 < HCLK <= 80 | + |---------------|----------------|----------------|-----------------|-----------------| + |4WS(5CPU cycle)|120< HCLK <= 150|96 < HCLK <= 120|88 < HCLK <= 110 |80 < HCLK <= 100 | + |---------------|----------------|----------------|-----------------|-----------------| + |5WS(6CPU cycle)|120< HCLK <= 180|120< HCLK <= 144|110 < HCLK <= 132|100 < HCLK <= 120| + |---------------|----------------|----------------|-----------------|-----------------| + |6WS(7CPU cycle)| NA |144< HCLK <= 168|132 < HCLK <= 154|120 < HCLK <= 140| + |---------------|----------------|----------------|-----------------|-----------------| + |7WS(8CPU cycle)| NA |168< HCLK <= 180|154 < HCLK <= 176|140 < HCLK <= 160| + |---------------|----------------|----------------|-----------------|-----------------| + |8WS(9CPU cycle)| NA | NA |176 < HCLK <= 180|160 < HCLK <= 168| + +-------------------------------------------------------------------------------------+ + + [..] + For STM32F401x devices + +-------------------------------------------------------------------------------------+ + | Latency | HCLK clock frequency (MHz) | + | |---------------------------------------------------------------------| + | | voltage range | voltage range | voltage range | voltage range | + | | 2.7 V - 3.6 V | 2.4 V - 2.7 V | 2.1 V - 2.4 V | 1.8 V - 2.1 V | + |---------------|----------------|----------------|-----------------|-----------------| + |0WS(1CPU cycle)|0 < HCLK <= 30 |0 < HCLK <= 24 |0 < HCLK <= 22 |0 < HCLK <= 20 | + |---------------|----------------|----------------|-----------------|-----------------| + |1WS(2CPU cycle)|30 < HCLK <= 60 |24 < HCLK <= 48 |22 < HCLK <= 44 |20 < HCLK <= 40 | + |---------------|----------------|----------------|-----------------|-----------------| + |2WS(3CPU cycle)|60 < HCLK <= 84 |48 < HCLK <= 72 |44 < HCLK <= 66 |40 < HCLK <= 60 | + |---------------|----------------|----------------|-----------------|-----------------| + |3WS(4CPU cycle)| NA |72 < HCLK <= 84 |66 < HCLK <= 84 |60 < HCLK <= 80 | + |---------------|----------------|----------------|-----------------|-----------------| + |4WS(5CPU cycle)| NA | NA | NA |80 < HCLK <= 84 | + +-------------------------------------------------------------------------------------+ + + [..] + For STM32F411xE devices + +-------------------------------------------------------------------------------------+ + | Latency | HCLK clock frequency (MHz) | + | |---------------------------------------------------------------------| + | | voltage range | voltage range | voltage range | voltage range | + | | 2.7 V - 3.6 V | 2.4 V - 2.7 V | 2.1 V - 2.4 V | 1.8 V - 2.1 V | + |---------------|----------------|----------------|-----------------|-----------------| + |0WS(1CPU cycle)|0 < HCLK <= 30 |0 < HCLK <= 24 |0 < HCLK <= 18 |0 < HCLK <= 16 | + |---------------|----------------|----------------|-----------------|-----------------| + |1WS(2CPU cycle)|30 < HCLK <= 64 |24 < HCLK <= 48 |18 < HCLK <= 36 |16 < HCLK <= 32 | + |---------------|----------------|----------------|-----------------|-----------------| + |2WS(3CPU cycle)|64 < HCLK <= 90 |48 < HCLK <= 72 |36 < HCLK <= 54 |32 < HCLK <= 48 | + |---------------|----------------|----------------|-----------------|-----------------| + |3WS(4CPU cycle)|90 < HCLK <= 100|72 < HCLK <= 96 |54 < HCLK <= 72 |48 < HCLK <= 64 | + |---------------|----------------|----------------|-----------------|-----------------| + |4WS(5CPU cycle)| NA |96 < HCLK <= 100|72 < HCLK <= 90 |64 < HCLK <= 80 | + |---------------|----------------|----------------|-----------------|-----------------| + |5WS(6CPU cycle)| NA | NA |90 < HCLK <= 100 |80 < HCLK <= 96 | + |---------------|----------------|----------------|-----------------|-----------------| + |6WS(7CPU cycle)| NA | NA | NA |96 < HCLK <= 100 | + +-------------------------------------------------------------------------------------+ + + [..] + +-------------------------------------------------------------------------------------------------------------------+ + | | voltage range | voltage range | voltage range | voltage range | voltage range 2.7 V - 3.6 V | + | | 2.7 V - 3.6 V | 2.4 V - 2.7 V | 2.1 V - 2.4 V | 1.8 V - 2.1 V | with External Vpp = 9V | + |---------------|----------------|----------------|-----------------|-----------------|-----------------------------| + |Max Parallelism| x32 | x16 | x8 | x64 | + |---------------|----------------|----------------|-----------------|-----------------|-----------------------------| + |PSIZE[1:0] | 10 | 01 | 00 | 11 | + +-------------------------------------------------------------------------------------------------------------------+ + + -@- On STM32F405xx/407xx and STM32F415xx/417xx devices: + (++) when VOS = '0' Scale 2 mode, the maximum value of fHCLK = 144MHz. + (++) when VOS = '1' Scale 1 mode, the maximum value of fHCLK = 168MHz. + [..] + On STM32F42xxx/43xxx devices: + (++) when VOS[1:0] = '0x01' Scale 3 mode, the maximum value of fHCLK is 120MHz. + (++) when VOS[1:0] = '0x10' Scale 2 mode, the maximum value of fHCLK is 144MHz if OverDrive OFF and 168MHz if OverDrive ON. + (++) when VOS[1:0] = '0x11' Scale 1 mode, the maximum value of fHCLK is 168MHz if OverDrive OFF and 180MHz if OverDrive ON. + [..] + On STM32F401x devices: + (++) when VOS[1:0] = '0x01' Scale 3 mode, the maximum value of fHCLK is 60MHz. + (++) when VOS[1:0] = '0x10' Scale 2 mode, the maximum value of fHCLK is 84MHz. + [..] + On STM32F411xE devices: + (++) when VOS[1:0] = '0x01' Scale 3 mode, the maximum value of fHCLK is 64MHz. + (++) when VOS[1:0] = '0x10' Scale 2 mode, the maximum value of fHCLK is 84MHz. + (++) when VOS[1:0] = '0x11' Scale 1 mode, the maximum value of fHCLK is 100MHz. + + For more details please refer product DataSheet + You can use PWR_MainRegulatorModeConfig() function to control VOS bits. + + (+) void FLASH_PrefetchBufferCmd(FunctionalState NewState) + (+) void FLASH_InstructionCacheCmd(FunctionalState NewState) + (+) void FLASH_DataCacheCmd(FunctionalState NewState) + (+) void FLASH_InstructionCacheReset(void) + (+) void FLASH_DataCacheReset(void) + + [..] + The unlock sequence is not needed for these functions. + +@endverbatim + * @{ + */ + +/** + * @brief Sets the code latency value. + * @param FLASH_Latency: specifies the FLASH Latency value. + * This parameter can be one of the following values: + * @arg FLASH_Latency_0: FLASH Zero Latency cycle + * @arg FLASH_Latency_1: FLASH One Latency cycle + * @arg FLASH_Latency_2: FLASH Two Latency cycles + * @arg FLASH_Latency_3: FLASH Three Latency cycles + * @arg FLASH_Latency_4: FLASH Four Latency cycles + * @arg FLASH_Latency_5: FLASH Five Latency cycles + * @arg FLASH_Latency_6: FLASH Six Latency cycles + * @arg FLASH_Latency_7: FLASH Seven Latency cycles + * @arg FLASH_Latency_8: FLASH Eight Latency cycles + * @arg FLASH_Latency_9: FLASH Nine Latency cycles + * @arg FLASH_Latency_10: FLASH Teen Latency cycles + * @arg FLASH_Latency_11: FLASH Eleven Latency cycles + * @arg FLASH_Latency_12: FLASH Twelve Latency cycles + * @arg FLASH_Latency_13: FLASH Thirteen Latency cycles + * @arg FLASH_Latency_14: FLASH Fourteen Latency cycles + * @arg FLASH_Latency_15: FLASH Fifteen Latency cycles + * + * @note For STM32F405xx/407xx, STM32F415xx/417xx and STM32F401xx/411xE devices this parameter + * can be a value between FLASH_Latency_0 and FLASH_Latency_7. + * + * @note For STM32F42xxx/43xxx devices this parameter can be a value between + * FLASH_Latency_0 and FLASH_Latency_15. + * + * @retval None + */ +void FLASH_SetLatency(uint32_t FLASH_Latency) +{ + /* Check the parameters */ + assert_param(IS_FLASH_LATENCY(FLASH_Latency)); + + /* Perform Byte access to FLASH_ACR[8:0] to set the Latency value */ + *(__IO uint8_t *)ACR_BYTE0_ADDRESS = (uint8_t)FLASH_Latency; +} + +/** + * @brief Enables or disables the Prefetch Buffer. + * @param NewState: new state of the Prefetch Buffer. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void FLASH_PrefetchBufferCmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + /* Enable or disable the Prefetch Buffer */ + if(NewState != DISABLE) + { + FLASH->ACR |= FLASH_ACR_PRFTEN; + } + else + { + FLASH->ACR &= (~FLASH_ACR_PRFTEN); + } +} + +/** + * @brief Enables or disables the Instruction Cache feature. + * @param NewState: new state of the Instruction Cache. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void FLASH_InstructionCacheCmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if(NewState != DISABLE) + { + FLASH->ACR |= FLASH_ACR_ICEN; + } + else + { + FLASH->ACR &= (~FLASH_ACR_ICEN); + } +} + +/** + * @brief Enables or disables the Data Cache feature. + * @param NewState: new state of the Data Cache. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void FLASH_DataCacheCmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if(NewState != DISABLE) + { + FLASH->ACR |= FLASH_ACR_DCEN; + } + else + { + FLASH->ACR &= (~FLASH_ACR_DCEN); + } +} + +/** + * @brief Resets the Instruction Cache. + * @note This function must be used only when the Instruction Cache is disabled. + * @param None + * @retval None + */ +void FLASH_InstructionCacheReset(void) +{ + FLASH->ACR |= FLASH_ACR_ICRST; +} + +/** + * @brief Resets the Data Cache. + * @note This function must be used only when the Data Cache is disabled. + * @param None + * @retval None + */ +void FLASH_DataCacheReset(void) +{ + FLASH->ACR |= FLASH_ACR_DCRST; +} + +/** + * @} + */ + +/** @defgroup FLASH_Group2 FLASH Memory Programming functions + * @brief FLASH Memory Programming functions + * +@verbatim + =============================================================================== + ##### FLASH Memory Programming functions ##### + =============================================================================== + [..] + This group includes the following functions: + (+) void FLASH_Unlock(void) + (+) void FLASH_Lock(void) + (+) FLASH_Status FLASH_EraseSector(uint32_t FLASH_Sector, uint8_t VoltageRange) + (+) FLASH_Status FLASH_EraseAllSectors(uint8_t VoltageRange) + (+) FLASH_Status FLASH_ProgramDoubleWord(uint32_t Address, uint64_t Data) + (+) FLASH_Status FLASH_ProgramWord(uint32_t Address, uint32_t Data) + (+) FLASH_Status FLASH_ProgramHalfWord(uint32_t Address, uint16_t Data) + (+) FLASH_Status FLASH_ProgramByte(uint32_t Address, uint8_t Data) + The following functions can be used only for STM32F42xxx/43xxx devices. + (+) FLASH_Status FLASH_EraseAllBank1Sectors(uint8_t VoltageRange) + (+) FLASH_Status FLASH_EraseAllBank2Sectors(uint8_t VoltageRange) + [..] + Any operation of erase or program should follow these steps: + (#) Call the FLASH_Unlock() function to enable the FLASH control register access + + (#) Call the desired function to erase sector(s) or program data + + (#) Call the FLASH_Lock() function to disable the FLASH control register access + (recommended to protect the FLASH memory against possible unwanted operation) + +@endverbatim + * @{ + */ + +/** + * @brief Unlocks the FLASH control register access + * @param None + * @retval None + */ +void FLASH_Unlock(void) +{ + if((FLASH->CR & FLASH_CR_LOCK) != RESET) + { + /* Authorize the FLASH Registers access */ + FLASH->KEYR = FLASH_KEY1; + FLASH->KEYR = FLASH_KEY2; + } +} + +/** + * @brief Locks the FLASH control register access + * @param None + * @retval None + */ +void FLASH_Lock(void) +{ + /* Set the LOCK Bit to lock the FLASH Registers access */ + FLASH->CR |= FLASH_CR_LOCK; +} + +/** + * @brief Erases a specified FLASH Sector. + * + * @note If an erase and a program operations are requested simustaneously, + * the erase operation is performed before the program one. + * + * @param FLASH_Sector: The Sector number to be erased. + * + * @note For STM32F405xx/407xx and STM32F415xx/417xx devices this parameter can + * be a value between FLASH_Sector_0 and FLASH_Sector_11. + * + * For STM32F42xxx/43xxx devices this parameter can be a value between + * FLASH_Sector_0 and FLASH_Sector_23. + * + * For STM32F401xx devices this parameter can be a value between + * FLASH_Sector_0 and FLASH_Sector_5. + * + * For STM32F411xE devices this parameter can be a value between + * FLASH_Sector_0 and FLASH_Sector_7. + * + * @param VoltageRange: The device voltage range which defines the erase parallelism. + * This parameter can be one of the following values: + * @arg VoltageRange_1: when the device voltage range is 1.8V to 2.1V, + * the operation will be done by byte (8-bit) + * @arg VoltageRange_2: when the device voltage range is 2.1V to 2.7V, + * the operation will be done by half word (16-bit) + * @arg VoltageRange_3: when the device voltage range is 2.7V to 3.6V, + * the operation will be done by word (32-bit) + * @arg VoltageRange_4: when the device voltage range is 2.7V to 3.6V + External Vpp, + * the operation will be done by double word (64-bit) + * + * @retval FLASH Status: The returned value can be: FLASH_BUSY, FLASH_ERROR_PROGRAM, + * FLASH_ERROR_WRP, FLASH_ERROR_OPERATION or FLASH_COMPLETE. + */ +FLASH_Status FLASH_EraseSector(uint32_t FLASH_Sector, uint8_t VoltageRange) +{ + uint32_t tmp_psize = 0x0; + FLASH_Status status = FLASH_COMPLETE; + + /* Check the parameters */ + assert_param(IS_FLASH_SECTOR(FLASH_Sector)); + assert_param(IS_VOLTAGERANGE(VoltageRange)); + + if(VoltageRange == VoltageRange_1) + { + tmp_psize = FLASH_PSIZE_BYTE; + } + else if(VoltageRange == VoltageRange_2) + { + tmp_psize = FLASH_PSIZE_HALF_WORD; + } + else if(VoltageRange == VoltageRange_3) + { + tmp_psize = FLASH_PSIZE_WORD; + } + else + { + tmp_psize = FLASH_PSIZE_DOUBLE_WORD; + } + /* Wait for last operation to be completed */ + status = FLASH_WaitForLastOperation(); + + if(status == FLASH_COMPLETE) + { + /* if the previous operation is completed, proceed to erase the sector */ + FLASH->CR &= CR_PSIZE_MASK; + FLASH->CR |= tmp_psize; + FLASH->CR &= SECTOR_MASK; + FLASH->CR |= FLASH_CR_SER | FLASH_Sector; + FLASH->CR |= FLASH_CR_STRT; + + /* Wait for last operation to be completed */ + status = FLASH_WaitForLastOperation(); + + /* if the erase operation is completed, disable the SER Bit */ + FLASH->CR &= (~FLASH_CR_SER); + FLASH->CR &= SECTOR_MASK; + } + /* Return the Erase Status */ + return status; +} + +/** + * @brief Erases all FLASH Sectors. + * + * @note If an erase and a program operations are requested simustaneously, + * the erase operation is performed before the program one. + * + * @param VoltageRange: The device voltage range which defines the erase parallelism. + * This parameter can be one of the following values: + * @arg VoltageRange_1: when the device voltage range is 1.8V to 2.1V, + * the operation will be done by byte (8-bit) + * @arg VoltageRange_2: when the device voltage range is 2.1V to 2.7V, + * the operation will be done by half word (16-bit) + * @arg VoltageRange_3: when the device voltage range is 2.7V to 3.6V, + * the operation will be done by word (32-bit) + * @arg VoltageRange_4: when the device voltage range is 2.7V to 3.6V + External Vpp, + * the operation will be done by double word (64-bit) + * + * @retval FLASH Status: The returned value can be: FLASH_BUSY, FLASH_ERROR_PROGRAM, + * FLASH_ERROR_WRP, FLASH_ERROR_OPERATION or FLASH_COMPLETE. + */ +FLASH_Status FLASH_EraseAllSectors(uint8_t VoltageRange) +{ + uint32_t tmp_psize = 0x0; + FLASH_Status status = FLASH_COMPLETE; + + /* Wait for last operation to be completed */ + status = FLASH_WaitForLastOperation(); + assert_param(IS_VOLTAGERANGE(VoltageRange)); + + if(VoltageRange == VoltageRange_1) + { + tmp_psize = FLASH_PSIZE_BYTE; + } + else if(VoltageRange == VoltageRange_2) + { + tmp_psize = FLASH_PSIZE_HALF_WORD; + } + else if(VoltageRange == VoltageRange_3) + { + tmp_psize = FLASH_PSIZE_WORD; + } + else + { + tmp_psize = FLASH_PSIZE_DOUBLE_WORD; + } + if(status == FLASH_COMPLETE) + { + /* if the previous operation is completed, proceed to erase all sectors */ +#if defined (STM32F427_437xx) || defined (STM32F429_439xx) + FLASH->CR &= CR_PSIZE_MASK; + FLASH->CR |= tmp_psize; + FLASH->CR |= (FLASH_CR_MER1 | FLASH_CR_MER2); + FLASH->CR |= FLASH_CR_STRT; + + /* Wait for last operation to be completed */ + status = FLASH_WaitForLastOperation(); + + /* if the erase operation is completed, disable the MER Bit */ + FLASH->CR &= ~(FLASH_CR_MER1 | FLASH_CR_MER2); +#endif /* STM32F427_437xx || STM32F429_439xx */ + +#if defined (STM32F40_41xxx) || defined (STM32F401xx) || defined (STM32F411xE) + FLASH->CR &= CR_PSIZE_MASK; + FLASH->CR |= tmp_psize; + FLASH->CR |= FLASH_CR_MER; + FLASH->CR |= FLASH_CR_STRT; + + /* Wait for last operation to be completed */ + status = FLASH_WaitForLastOperation(); + + /* if the erase operation is completed, disable the MER Bit */ + FLASH->CR &= (~FLASH_CR_MER); +#endif /* STM32F40_41xxx || STM32F401xx || STM32F411xE */ + + } + /* Return the Erase Status */ + return status; +} + +/** + * @brief Erases all FLASH Sectors in Bank 1. + * + * @note This function can be used only for STM32F42xxx/43xxx devices. + * + * @note If an erase and a program operations are requested simultaneously, + * the erase operation is performed before the program one. + * + * @param VoltageRange: The device voltage range which defines the erase parallelism. + * This parameter can be one of the following values: + * @arg VoltageRange_1: when the device voltage range is 1.8V to 2.1V, + * the operation will be done by byte (8-bit) + * @arg VoltageRange_2: when the device voltage range is 2.1V to 2.7V, + * the operation will be done by half word (16-bit) + * @arg VoltageRange_3: when the device voltage range is 2.7V to 3.6V, + * the operation will be done by word (32-bit) + * @arg VoltageRange_4: when the device voltage range is 2.7V to 3.6V + External Vpp, + * the operation will be done by double word (64-bit) + * + * @retval FLASH Status: The returned value can be: FLASH_BUSY, FLASH_ERROR_PROGRAM, + * FLASH_ERROR_WRP, FLASH_ERROR_OPERATION or FLASH_COMPLETE. + */ +FLASH_Status FLASH_EraseAllBank1Sectors(uint8_t VoltageRange) +{ + uint32_t tmp_psize = 0x0; + FLASH_Status status = FLASH_COMPLETE; + + /* Wait for last operation to be completed */ + status = FLASH_WaitForLastOperation(); + assert_param(IS_VOLTAGERANGE(VoltageRange)); + + if(VoltageRange == VoltageRange_1) + { + tmp_psize = FLASH_PSIZE_BYTE; + } + else if(VoltageRange == VoltageRange_2) + { + tmp_psize = FLASH_PSIZE_HALF_WORD; + } + else if(VoltageRange == VoltageRange_3) + { + tmp_psize = FLASH_PSIZE_WORD; + } + else + { + tmp_psize = FLASH_PSIZE_DOUBLE_WORD; + } + if(status == FLASH_COMPLETE) + { + /* if the previous operation is completed, proceed to erase all sectors */ + FLASH->CR &= CR_PSIZE_MASK; + FLASH->CR |= tmp_psize; + FLASH->CR |= FLASH_CR_MER1; + FLASH->CR |= FLASH_CR_STRT; + + /* Wait for last operation to be completed */ + status = FLASH_WaitForLastOperation(); + + /* if the erase operation is completed, disable the MER Bit */ + FLASH->CR &= (~FLASH_CR_MER1); + + } + /* Return the Erase Status */ + return status; +} + + +/** + * @brief Erases all FLASH Sectors in Bank 2. + * + * @note This function can be used only for STM32F42xxx/43xxx devices. + * + * @note If an erase and a program operations are requested simultaneously, + * the erase operation is performed before the program one. + * + * @param VoltageRange: The device voltage range which defines the erase parallelism. + * This parameter can be one of the following values: + * @arg VoltageRange_1: when the device voltage range is 1.8V to 2.1V, + * the operation will be done by byte (8-bit) + * @arg VoltageRange_2: when the device voltage range is 2.1V to 2.7V, + * the operation will be done by half word (16-bit) + * @arg VoltageRange_3: when the device voltage range is 2.7V to 3.6V, + * the operation will be done by word (32-bit) + * @arg VoltageRange_4: when the device voltage range is 2.7V to 3.6V + External Vpp, + * the operation will be done by double word (64-bit) + * + * @retval FLASH Status: The returned value can be: FLASH_BUSY, FLASH_ERROR_PROGRAM, + * FLASH_ERROR_WRP, FLASH_ERROR_OPERATION or FLASH_COMPLETE. + */ +FLASH_Status FLASH_EraseAllBank2Sectors(uint8_t VoltageRange) +{ + uint32_t tmp_psize = 0x0; + FLASH_Status status = FLASH_COMPLETE; + + /* Wait for last operation to be completed */ + status = FLASH_WaitForLastOperation(); + assert_param(IS_VOLTAGERANGE(VoltageRange)); + + if(VoltageRange == VoltageRange_1) + { + tmp_psize = FLASH_PSIZE_BYTE; + } + else if(VoltageRange == VoltageRange_2) + { + tmp_psize = FLASH_PSIZE_HALF_WORD; + } + else if(VoltageRange == VoltageRange_3) + { + tmp_psize = FLASH_PSIZE_WORD; + } + else + { + tmp_psize = FLASH_PSIZE_DOUBLE_WORD; + } + if(status == FLASH_COMPLETE) + { + /* if the previous operation is completed, proceed to erase all sectors */ + FLASH->CR &= CR_PSIZE_MASK; + FLASH->CR |= tmp_psize; + FLASH->CR |= FLASH_CR_MER2; + FLASH->CR |= FLASH_CR_STRT; + + /* Wait for last operation to be completed */ + status = FLASH_WaitForLastOperation(); + + /* if the erase operation is completed, disable the MER Bit */ + FLASH->CR &= (~FLASH_CR_MER2); + + } + /* Return the Erase Status */ + return status; +} + +/** + * @brief Programs a double word (64-bit) at a specified address. + * @note This function must be used when the device voltage range is from + * 2.7V to 3.6V and an External Vpp is present. + * + * @note If an erase and a program operations are requested simustaneously, + * the erase operation is performed before the program one. + * + * @param Address: specifies the address to be programmed. + * @param Data: specifies the data to be programmed. + * @retval FLASH Status: The returned value can be: FLASH_BUSY, FLASH_ERROR_PROGRAM, + * FLASH_ERROR_WRP, FLASH_ERROR_OPERATION or FLASH_COMPLETE. + */ +FLASH_Status FLASH_ProgramDoubleWord(uint32_t Address, uint64_t Data) +{ + FLASH_Status status = FLASH_COMPLETE; + + /* Check the parameters */ + assert_param(IS_FLASH_ADDRESS(Address)); + + /* Wait for last operation to be completed */ + status = FLASH_WaitForLastOperation(); + + if(status == FLASH_COMPLETE) + { + /* if the previous operation is completed, proceed to program the new data */ + FLASH->CR &= CR_PSIZE_MASK; + FLASH->CR |= FLASH_PSIZE_DOUBLE_WORD; + FLASH->CR |= FLASH_CR_PG; + + *(__IO uint64_t*)Address = Data; + + /* Wait for last operation to be completed */ + status = FLASH_WaitForLastOperation(); + + /* if the program operation is completed, disable the PG Bit */ + FLASH->CR &= (~FLASH_CR_PG); + } + /* Return the Program Status */ + return status; +} + +/** + * @brief Programs a word (32-bit) at a specified address. + * + * @note This function must be used when the device voltage range is from 2.7V to 3.6V. + * + * @note If an erase and a program operations are requested simustaneously, + * the erase operation is performed before the program one. + * + * @param Address: specifies the address to be programmed. + * This parameter can be any address in Program memory zone or in OTP zone. + * @param Data: specifies the data to be programmed. + * @retval FLASH Status: The returned value can be: FLASH_BUSY, FLASH_ERROR_PROGRAM, + * FLASH_ERROR_WRP, FLASH_ERROR_OPERATION or FLASH_COMPLETE. + */ +FLASH_Status FLASH_ProgramWord(uint32_t Address, uint32_t Data) +{ + FLASH_Status status = FLASH_COMPLETE; + + /* Check the parameters */ + assert_param(IS_FLASH_ADDRESS(Address)); + + /* Wait for last operation to be completed */ + status = FLASH_WaitForLastOperation(); + + if(status == FLASH_COMPLETE) + { + /* if the previous operation is completed, proceed to program the new data */ + FLASH->CR &= CR_PSIZE_MASK; + FLASH->CR |= FLASH_PSIZE_WORD; + FLASH->CR |= FLASH_CR_PG; + + *(__IO uint32_t*)Address = Data; + + /* Wait for last operation to be completed */ + status = FLASH_WaitForLastOperation(); + + /* if the program operation is completed, disable the PG Bit */ + FLASH->CR &= (~FLASH_CR_PG); + } + /* Return the Program Status */ + return status; +} + +/** + * @brief Programs a half word (16-bit) at a specified address. + * @note This function must be used when the device voltage range is from 2.1V to 3.6V. + * + * @note If an erase and a program operations are requested simustaneously, + * the erase operation is performed before the program one. + * + * @param Address: specifies the address to be programmed. + * This parameter can be any address in Program memory zone or in OTP zone. + * @param Data: specifies the data to be programmed. + * @retval FLASH Status: The returned value can be: FLASH_BUSY, FLASH_ERROR_PROGRAM, + * FLASH_ERROR_WRP, FLASH_ERROR_OPERATION or FLASH_COMPLETE. + */ +FLASH_Status FLASH_ProgramHalfWord(uint32_t Address, uint16_t Data) +{ + FLASH_Status status = FLASH_COMPLETE; + + /* Check the parameters */ + assert_param(IS_FLASH_ADDRESS(Address)); + + /* Wait for last operation to be completed */ + status = FLASH_WaitForLastOperation(); + + if(status == FLASH_COMPLETE) + { + /* if the previous operation is completed, proceed to program the new data */ + FLASH->CR &= CR_PSIZE_MASK; + FLASH->CR |= FLASH_PSIZE_HALF_WORD; + FLASH->CR |= FLASH_CR_PG; + + *(__IO uint16_t*)Address = Data; + + /* Wait for last operation to be completed */ + status = FLASH_WaitForLastOperation(); + + /* if the program operation is completed, disable the PG Bit */ + FLASH->CR &= (~FLASH_CR_PG); + } + /* Return the Program Status */ + return status; +} + +/** + * @brief Programs a byte (8-bit) at a specified address. + * @note This function can be used within all the device supply voltage ranges. + * + * @note If an erase and a program operations are requested simustaneously, + * the erase operation is performed before the program one. + * + * @param Address: specifies the address to be programmed. + * This parameter can be any address in Program memory zone or in OTP zone. + * @param Data: specifies the data to be programmed. + * @retval FLASH Status: The returned value can be: FLASH_BUSY, FLASH_ERROR_PROGRAM, + * FLASH_ERROR_WRP, FLASH_ERROR_OPERATION or FLASH_COMPLETE. + */ +FLASH_Status FLASH_ProgramByte(uint32_t Address, uint8_t Data) +{ + FLASH_Status status = FLASH_COMPLETE; + + /* Check the parameters */ + assert_param(IS_FLASH_ADDRESS(Address)); + + /* Wait for last operation to be completed */ + status = FLASH_WaitForLastOperation(); + + if(status == FLASH_COMPLETE) + { + /* if the previous operation is completed, proceed to program the new data */ + FLASH->CR &= CR_PSIZE_MASK; + FLASH->CR |= FLASH_PSIZE_BYTE; + FLASH->CR |= FLASH_CR_PG; + + *(__IO uint8_t*)Address = Data; + + /* Wait for last operation to be completed */ + status = FLASH_WaitForLastOperation(); + + /* if the program operation is completed, disable the PG Bit */ + FLASH->CR &= (~FLASH_CR_PG); + } + + /* Return the Program Status */ + return status; +} + +/** + * @} + */ + +/** @defgroup FLASH_Group3 Option Bytes Programming functions + * @brief Option Bytes Programming functions + * +@verbatim + =============================================================================== + ##### Option Bytes Programming functions ##### + =============================================================================== + [..] + This group includes the following functions: + (+) void FLASH_OB_Unlock(void) + (+) void FLASH_OB_Lock(void) + (+) void FLASH_OB_WRPConfig(uint32_t OB_WRP, FunctionalState NewState) + (+) void FLASH_OB_WRP1Config(uint32_t OB_WRP, FunctionalState NewState) + (+) void FLASH_OB_PCROPSelectionConfig(uint8_t OB_PCROPSelect) + (+) void FLASH_OB_PCROPConfig(uint32_t OB_PCROP, FunctionalState NewState) + (+) void FLASH_OB_PCROP1Config(uint32_t OB_PCROP, FunctionalState NewState) + (+) void FLASH_OB_RDPConfig(uint8_t OB_RDP) + (+) void FLASH_OB_UserConfig(uint8_t OB_IWDG, uint8_t OB_STOP, uint8_t OB_STDBY) + (+) void FLASH_OB_BORConfig(uint8_t OB_BOR) + (+) FLASH_Status FLASH_ProgramOTP(uint32_t Address, uint32_t Data) + (+) FLASH_Status FLASH_OB_Launch(void) + (+) uint32_t FLASH_OB_GetUser(void) + (+) uint8_t FLASH_OB_GetWRP(void) + (+) uint8_t FLASH_OB_GetWRP1(void) + (+) uint8_t FLASH_OB_GetPCROP(void) + (+) uint8_t FLASH_OB_GetPCROP1(void) + (+) uint8_t FLASH_OB_GetRDP(void) + (+) uint8_t FLASH_OB_GetBOR(void) + [..] + The following function can be used only for STM32F42xxx/43xxx devices. + (+) void FLASH_OB_BootConfig(uint8_t OB_BOOT) + [..] + Any operation of erase or program should follow these steps: + (#) Call the FLASH_OB_Unlock() function to enable the FLASH option control + register access + + (#) Call one or several functions to program the desired Option Bytes: + (++) void FLASH_OB_WRPConfig(uint32_t OB_WRP, FunctionalState NewState) + => to Enable/Disable the desired sector write protection + (++) void FLASH_OB_RDPConfig(uint8_t OB_RDP) => to set the desired read + Protection Level + (++) void FLASH_OB_UserConfig(uint8_t OB_IWDG, uint8_t OB_STOP, uint8_t OB_STDBY) + => to configure the user Option Bytes. + (++) void FLASH_OB_BORConfig(uint8_t OB_BOR) => to set the BOR Level + + (#) Once all needed Option Bytes to be programmed are correctly written, + call the FLASH_OB_Launch() function to launch the Option Bytes + programming process. + + -@- When changing the IWDG mode from HW to SW or from SW to HW, a system + reset is needed to make the change effective. + + (#) Call the FLASH_OB_Lock() function to disable the FLASH option control + register access (recommended to protect the Option Bytes against + possible unwanted operations) + +@endverbatim + * @{ + */ + +/** + * @brief Unlocks the FLASH Option Control Registers access. + * @param None + * @retval None + */ +void FLASH_OB_Unlock(void) +{ + if((FLASH->OPTCR & FLASH_OPTCR_OPTLOCK) != RESET) + { + /* Authorizes the Option Byte register programming */ + FLASH->OPTKEYR = FLASH_OPT_KEY1; + FLASH->OPTKEYR = FLASH_OPT_KEY2; + } +} + +/** + * @brief Locks the FLASH Option Control Registers access. + * @param None + * @retval None + */ +void FLASH_OB_Lock(void) +{ + /* Set the OPTLOCK Bit to lock the FLASH Option Byte Registers access */ + FLASH->OPTCR |= FLASH_OPTCR_OPTLOCK; +} + +/** + * @brief Enables or disables the write protection of the desired sectors, for the first + * 1 Mb of the Flash + * + * @note When the memory read protection level is selected (RDP level = 1), + * it is not possible to program or erase the flash sector i if CortexM4 + * debug features are connected or boot code is executed in RAM, even if nWRPi = 1 + * @note Active value of nWRPi bits is inverted when PCROP mode is active (SPRMOD =1). + * + * @param OB_WRP: specifies the sector(s) to be write protected or unprotected. + * This parameter can be one of the following values: + * @arg OB_WRP: A value between OB_WRP_Sector0 and OB_WRP_Sector11 + * @arg OB_WRP_Sector_All + * @param Newstate: new state of the Write Protection. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void FLASH_OB_WRPConfig(uint32_t OB_WRP, FunctionalState NewState) +{ + FLASH_Status status = FLASH_COMPLETE; + + /* Check the parameters */ + assert_param(IS_OB_WRP(OB_WRP)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + status = FLASH_WaitForLastOperation(); + + if(status == FLASH_COMPLETE) + { + if(NewState != DISABLE) + { + *(__IO uint16_t*)OPTCR_BYTE2_ADDRESS &= (~OB_WRP); + } + else + { + *(__IO uint16_t*)OPTCR_BYTE2_ADDRESS |= (uint16_t)OB_WRP; + } + } +} + +/** + * @brief Enables or disables the write protection of the desired sectors, for the second + * 1 Mb of the Flash + * + * @note This function can be used only for STM32F42xxx/43xxx devices. + * + * @note When the memory read out protection is selected (RDP level = 1), + * it is not possible to program or erase the flash sector i if CortexM4 + * debug features are connected or boot code is executed in RAM, even if nWRPi = 1 + * @note Active value of nWRPi bits is inverted when PCROP mode is active (SPRMOD =1). + * + * @param OB_WRP: specifies the sector(s) to be write protected or unprotected. + * This parameter can be one of the following values: + * @arg OB_WRP: A value between OB_WRP_Sector12 and OB_WRP_Sector23 + * @arg OB_WRP_Sector_All + * @param Newstate: new state of the Write Protection. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void FLASH_OB_WRP1Config(uint32_t OB_WRP, FunctionalState NewState) +{ + FLASH_Status status = FLASH_COMPLETE; + + /* Check the parameters */ + assert_param(IS_OB_WRP(OB_WRP)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + status = FLASH_WaitForLastOperation(); + + if(status == FLASH_COMPLETE) + { + if(NewState != DISABLE) + { + *(__IO uint16_t*)OPTCR1_BYTE2_ADDRESS &= (~OB_WRP); + } + else + { + *(__IO uint16_t*)OPTCR1_BYTE2_ADDRESS |= (uint16_t)OB_WRP; + } + } +} + +/** + * @brief Select the Protection Mode (SPRMOD). + * + * @note This function can be used only for STM32F42xxx/43xxx and STM32F401xx/411xE devices. + * + * @note After PCROP activation, Option Byte modification is not possible. + * Exception made for the global Read Out Protection modification level (level1 to level0) + * @note Once SPRMOD bit is active unprotection of a protected sector is not possible + * + * @note Read a protected sector will set RDERR Flag and write a protected sector will set WRPERR Flag + * + * @note Some Precautions should be taken when activating the PCROP feature : + * The active value of nWRPi bits is inverted when PCROP mode is active, this means if SPRMOD = 1 + * and WRPi = 1 (default value), then the user sector i is read/write protected. + * In order to avoid activation of PCROP Mode for undesired sectors, please follow the + * below safety sequence : + * - Disable PCROP for all Sectors using FLASH_OB_PCROPConfig(OB_PCROP_Sector_All, DISABLE) function + * for Bank1 or FLASH_OB_PCROP1Config(OB_PCROP_Sector_All, DISABLE) function for Bank2 + * - Enable PCROP for the desired Sector i using FLASH_OB_PCROPConfig(Sector i, ENABLE) function + * - Activate the PCROP Mode FLASH_OB_PCROPSelectionConfig() function. + * + * @param OB_PCROP: Select the Protection Mode of nWPRi bits + * This parameter can be one of the following values: + * @arg OB_PcROP_Disable: nWRPi control the write protection of respective user sectors. + * @arg OB_PcROP_Enable: nWRPi control the read&write protection (PCROP) of respective user sectors. + * @retval None + */ +void FLASH_OB_PCROPSelectionConfig(uint8_t OB_PcROP) +{ + uint8_t optiontmp = 0xFF; + + /* Check the parameters */ + assert_param(IS_OB_PCROP_SELECT(OB_PcROP)); + + /* Mask SPRMOD bit */ + optiontmp = (uint8_t)((*(__IO uint8_t *)OPTCR_BYTE3_ADDRESS) & (uint8_t)0x7F); + /* Update Option Byte */ + *(__IO uint8_t *)OPTCR_BYTE3_ADDRESS = (uint8_t)(OB_PcROP | optiontmp); + +} + +/** + * @brief Enables or disables the read/write protection (PCROP) of the desired + * sectors, for the first 1 MB of the Flash. + * + * @note This function can be used only for STM32F42xxx/43xxx and STM32F401xx/411xE devices. + * + * @param OB_PCROP: specifies the sector(s) to be read/write protected or unprotected. + * This parameter can be one of the following values: + * @arg OB_PCROP: A value between OB_PCROP_Sector0 and OB_PCROP_Sector11 for + * STM32F42xxx/43xxx devices and between OB_PCROP_Sector0 and + * OB_PCROP_Sector5 for STM32F401xx/411xE devices. + * @arg OB_PCROP_Sector_All + * @param Newstate: new state of the Write Protection. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void FLASH_OB_PCROPConfig(uint32_t OB_PCROP, FunctionalState NewState) +{ + FLASH_Status status = FLASH_COMPLETE; + + /* Check the parameters */ + assert_param(IS_OB_PCROP(OB_PCROP)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + status = FLASH_WaitForLastOperation(); + + if(status == FLASH_COMPLETE) + { + if(NewState != DISABLE) + { + *(__IO uint16_t*)OPTCR_BYTE2_ADDRESS |= (uint16_t)OB_PCROP; + } + else + { + *(__IO uint16_t*)OPTCR_BYTE2_ADDRESS &= (~OB_PCROP); + } + } +} + +/** + * @brief Enables or disables the read/write protection (PCROP) of the desired + * sectors + * + * @note This function can be used only for STM32F42xxx/43xxx devices. + * + * @param OB_PCROP: specifies the sector(s) to be read/write protected or unprotected. + * This parameter can be one of the following values: + * @arg OB_PCROP: A value between OB_PCROP_Sector12 and OB_PCROP_Sector23 + * @arg OB_PCROP_Sector_All + * @param Newstate: new state of the Write Protection. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void FLASH_OB_PCROP1Config(uint32_t OB_PCROP, FunctionalState NewState) +{ + FLASH_Status status = FLASH_COMPLETE; + + /* Check the parameters */ + assert_param(IS_OB_PCROP(OB_PCROP)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + status = FLASH_WaitForLastOperation(); + + if(status == FLASH_COMPLETE) + { + if(NewState != DISABLE) + { + *(__IO uint16_t*)OPTCR1_BYTE2_ADDRESS |= (uint16_t)OB_PCROP; + } + else + { + *(__IO uint16_t*)OPTCR1_BYTE2_ADDRESS &= (~OB_PCROP); + } + } +} + + +/** + * @brief Sets the read protection level. + * @param OB_RDP: specifies the read protection level. + * This parameter can be one of the following values: + * @arg OB_RDP_Level_0: No protection + * @arg OB_RDP_Level_1: Read protection of the memory + * @arg OB_RDP_Level_2: Full chip protection + * + * /!\ Warning /!\ When enabling OB_RDP level 2 it's no more possible to go back to level 1 or 0 + * + * @retval None + */ +void FLASH_OB_RDPConfig(uint8_t OB_RDP) +{ + FLASH_Status status = FLASH_COMPLETE; + + /* Check the parameters */ + assert_param(IS_OB_RDP(OB_RDP)); + + status = FLASH_WaitForLastOperation(); + + if(status == FLASH_COMPLETE) + { + *(__IO uint8_t*)OPTCR_BYTE1_ADDRESS = OB_RDP; + + } +} + +/** + * @brief Programs the FLASH User Option Byte: IWDG_SW / RST_STOP / RST_STDBY. + * @param OB_IWDG: Selects the IWDG mode + * This parameter can be one of the following values: + * @arg OB_IWDG_SW: Software IWDG selected + * @arg OB_IWDG_HW: Hardware IWDG selected + * @param OB_STOP: Reset event when entering STOP mode. + * This parameter can be one of the following values: + * @arg OB_STOP_NoRST: No reset generated when entering in STOP + * @arg OB_STOP_RST: Reset generated when entering in STOP + * @param OB_STDBY: Reset event when entering Standby mode. + * This parameter can be one of the following values: + * @arg OB_STDBY_NoRST: No reset generated when entering in STANDBY + * @arg OB_STDBY_RST: Reset generated when entering in STANDBY + * @retval None + */ +void FLASH_OB_UserConfig(uint8_t OB_IWDG, uint8_t OB_STOP, uint8_t OB_STDBY) +{ + uint8_t optiontmp = 0xFF; + FLASH_Status status = FLASH_COMPLETE; + + /* Check the parameters */ + assert_param(IS_OB_IWDG_SOURCE(OB_IWDG)); + assert_param(IS_OB_STOP_SOURCE(OB_STOP)); + assert_param(IS_OB_STDBY_SOURCE(OB_STDBY)); + + /* Wait for last operation to be completed */ + status = FLASH_WaitForLastOperation(); + + if(status == FLASH_COMPLETE) + { +#if defined (STM32F427_437xx) || defined (STM32F429_439xx) + /* Mask OPTLOCK, OPTSTRT, BOR_LEV and BFB2 bits */ + optiontmp = (uint8_t)((*(__IO uint8_t *)OPTCR_BYTE0_ADDRESS) & (uint8_t)0x1F); +#endif /* STM32F427_437xx || STM32F429_439xx */ + +#if defined (STM32F40_41xxx) || defined (STM32F401xx) || defined (STM32F411xE) + /* Mask OPTLOCK, OPTSTRT and BOR_LEV bits */ + optiontmp = (uint8_t)((*(__IO uint8_t *)OPTCR_BYTE0_ADDRESS) & (uint8_t)0x0F); +#endif /* STM32F40_41xxx || STM32F401xx || STM32F411xE */ + + /* Update User Option Byte */ + *(__IO uint8_t *)OPTCR_BYTE0_ADDRESS = OB_IWDG | (uint8_t)(OB_STDBY | (uint8_t)(OB_STOP | ((uint8_t)optiontmp))); + } +} + +/** + * @brief Configure the Dual Bank Boot. + * + * @note This function can be used only for STM32F42xxx/43xxx devices. + * + * @param OB_BOOT: specifies the Dual Bank Boot Option byte. + * This parameter can be one of the following values: + * @arg OB_Dual_BootEnabled: Dual Bank Boot Enable + * @arg OB_Dual_BootDisabled: Dual Bank Boot Disabled + * @retval None + */ +void FLASH_OB_BootConfig(uint8_t OB_BOOT) +{ + /* Check the parameters */ + assert_param(IS_OB_BOOT(OB_BOOT)); + + /* Set Dual Bank Boot */ + *(__IO uint8_t *)OPTCR_BYTE0_ADDRESS &= (~FLASH_OPTCR_BFB2); + *(__IO uint8_t *)OPTCR_BYTE0_ADDRESS |= OB_BOOT; + +} + +/** + * @brief Sets the BOR Level. + * @param OB_BOR: specifies the Option Bytes BOR Reset Level. + * This parameter can be one of the following values: + * @arg OB_BOR_LEVEL3: Supply voltage ranges from 2.7 to 3.6 V + * @arg OB_BOR_LEVEL2: Supply voltage ranges from 2.4 to 2.7 V + * @arg OB_BOR_LEVEL1: Supply voltage ranges from 2.1 to 2.4 V + * @arg OB_BOR_OFF: Supply voltage ranges from 1.62 to 2.1 V + * @retval None + */ +void FLASH_OB_BORConfig(uint8_t OB_BOR) +{ + /* Check the parameters */ + assert_param(IS_OB_BOR(OB_BOR)); + + /* Set the BOR Level */ + *(__IO uint8_t *)OPTCR_BYTE0_ADDRESS &= (~FLASH_OPTCR_BOR_LEV); + *(__IO uint8_t *)OPTCR_BYTE0_ADDRESS |= OB_BOR; + +} + +/** + * @brief Launch the option byte loading. + * @param None + * @retval FLASH Status: The returned value can be: FLASH_BUSY, FLASH_ERROR_PROGRAM, + * FLASH_ERROR_WRP, FLASH_ERROR_OPERATION or FLASH_COMPLETE. + */ +FLASH_Status FLASH_OB_Launch(void) +{ + FLASH_Status status = FLASH_COMPLETE; + + /* Set the OPTSTRT bit in OPTCR register */ + *(__IO uint8_t *)OPTCR_BYTE0_ADDRESS |= FLASH_OPTCR_OPTSTRT; + + /* Wait for last operation to be completed */ + status = FLASH_WaitForLastOperation(); + + return status; +} + +/** + * @brief Returns the FLASH User Option Bytes values. + * @param None + * @retval The FLASH User Option Bytes values: IWDG_SW(Bit0), RST_STOP(Bit1) + * and RST_STDBY(Bit2). + */ +uint8_t FLASH_OB_GetUser(void) +{ + /* Return the User Option Byte */ + return (uint8_t)(FLASH->OPTCR >> 5); +} + +/** + * @brief Returns the FLASH Write Protection Option Bytes value. + * @param None + * @retval The FLASH Write Protection Option Bytes value + */ +uint16_t FLASH_OB_GetWRP(void) +{ + /* Return the FLASH write protection Register value */ + return (*(__IO uint16_t *)(OPTCR_BYTE2_ADDRESS)); +} + +/** + * @brief Returns the FLASH Write Protection Option Bytes value. + * + * @note This function can be used only for STM32F42xxx/43xxx devices. + * + * @param None + * @retval The FLASH Write Protection Option Bytes value + */ +uint16_t FLASH_OB_GetWRP1(void) +{ + /* Return the FLASH write protection Register value */ + return (*(__IO uint16_t *)(OPTCR1_BYTE2_ADDRESS)); +} + +/** + * @brief Returns the FLASH PC Read/Write Protection Option Bytes value. + * + * @note This function can be used only for STM32F42xxx/43xxx devices and STM32F401xx/411xE devices. + * + * @param None + * @retval The FLASH PC Read/Write Protection Option Bytes value + */ +uint16_t FLASH_OB_GetPCROP(void) +{ + /* Return the FLASH PC Read/write protection Register value */ + return (*(__IO uint16_t *)(OPTCR_BYTE2_ADDRESS)); +} + +/** + * @brief Returns the FLASH PC Read/Write Protection Option Bytes value. + * + * @note This function can be used only for STM32F42xxx/43xxx devices. + * + * @param None + * @retval The FLASH PC Read/Write Protection Option Bytes value + */ +uint16_t FLASH_OB_GetPCROP1(void) +{ + /* Return the FLASH write protection Register value */ + return (*(__IO uint16_t *)(OPTCR1_BYTE2_ADDRESS)); +} + +/** + * @brief Returns the FLASH Read Protection level. + * @param None + * @retval FLASH ReadOut Protection Status: + * - SET, when OB_RDP_Level_1 or OB_RDP_Level_2 is set + * - RESET, when OB_RDP_Level_0 is set + */ +FlagStatus FLASH_OB_GetRDP(void) +{ + FlagStatus readstatus = RESET; + + if ((*(__IO uint8_t*)(OPTCR_BYTE1_ADDRESS) != (uint8_t)OB_RDP_Level_0)) + { + readstatus = SET; + } + else + { + readstatus = RESET; + } + return readstatus; +} + +/** + * @brief Returns the FLASH BOR level. + * @param None + * @retval The FLASH BOR level: + * - OB_BOR_LEVEL3: Supply voltage ranges from 2.7 to 3.6 V + * - OB_BOR_LEVEL2: Supply voltage ranges from 2.4 to 2.7 V + * - OB_BOR_LEVEL1: Supply voltage ranges from 2.1 to 2.4 V + * - OB_BOR_OFF : Supply voltage ranges from 1.62 to 2.1 V + */ +uint8_t FLASH_OB_GetBOR(void) +{ + /* Return the FLASH BOR level */ + return (uint8_t)(*(__IO uint8_t *)(OPTCR_BYTE0_ADDRESS) & (uint8_t)0x0C); +} + +/** + * @} + */ + +/** @defgroup FLASH_Group4 Interrupts and flags management functions + * @brief Interrupts and flags management functions + * +@verbatim + =============================================================================== + ##### Interrupts and flags management functions ##### + =============================================================================== +@endverbatim + * @{ + */ + +/** + * @brief Enables or disables the specified FLASH interrupts. + * @param FLASH_IT: specifies the FLASH interrupt sources to be enabled or disabled. + * This parameter can be any combination of the following values: + * @arg FLASH_IT_ERR: FLASH Error Interrupt + * @arg FLASH_IT_EOP: FLASH end of operation Interrupt + * @retval None + */ +void FLASH_ITConfig(uint32_t FLASH_IT, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FLASH_IT(FLASH_IT)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if(NewState != DISABLE) + { + /* Enable the interrupt sources */ + FLASH->CR |= FLASH_IT; + } + else + { + /* Disable the interrupt sources */ + FLASH->CR &= ~(uint32_t)FLASH_IT; + } +} + +/** + * @brief Checks whether the specified FLASH flag is set or not. + * @param FLASH_FLAG: specifies the FLASH flag to check. + * This parameter can be one of the following values: + * @arg FLASH_FLAG_EOP: FLASH End of Operation flag + * @arg FLASH_FLAG_OPERR: FLASH operation Error flag + * @arg FLASH_FLAG_WRPERR: FLASH Write protected error flag + * @arg FLASH_FLAG_PGAERR: FLASH Programming Alignment error flag + * @arg FLASH_FLAG_PGPERR: FLASH Programming Parallelism error flag + * @arg FLASH_FLAG_PGSERR: FLASH Programming Sequence error flag + * @arg FLASH_FLAG_RDERR: FLASH (PCROP) Read Protection error flag (STM32F42xx/43xxx and STM32F401xx/411xE devices) + * @arg FLASH_FLAG_BSY: FLASH Busy flag + * @retval The new state of FLASH_FLAG (SET or RESET). + */ +FlagStatus FLASH_GetFlagStatus(uint32_t FLASH_FLAG) +{ + FlagStatus bitstatus = RESET; + /* Check the parameters */ + assert_param(IS_FLASH_GET_FLAG(FLASH_FLAG)); + + if((FLASH->SR & FLASH_FLAG) != (uint32_t)RESET) + { + bitstatus = SET; + } + else + { + bitstatus = RESET; + } + /* Return the new state of FLASH_FLAG (SET or RESET) */ + return bitstatus; +} + +/** + * @brief Clears the FLASH's pending flags. + * @param FLASH_FLAG: specifies the FLASH flags to clear. + * This parameter can be any combination of the following values: + * @arg FLASH_FLAG_EOP: FLASH End of Operation flag + * @arg FLASH_FLAG_OPERR: FLASH operation Error flag + * @arg FLASH_FLAG_WRPERR: FLASH Write protected error flag + * @arg FLASH_FLAG_PGAERR: FLASH Programming Alignment error flag + * @arg FLASH_FLAG_PGPERR: FLASH Programming Parallelism error flag + * @arg FLASH_FLAG_PGSERR: FLASH Programming Sequence error flag + * @arg FLASH_FLAG_RDERR: FLASH Read Protection error flag (STM32F42xx/43xxx and STM32F401xx/411xE devices) + * @retval None + */ +void FLASH_ClearFlag(uint32_t FLASH_FLAG) +{ + /* Check the parameters */ + assert_param(IS_FLASH_CLEAR_FLAG(FLASH_FLAG)); + + /* Clear the flags */ + FLASH->SR = FLASH_FLAG; +} + +/** + * @brief Returns the FLASH Status. + * @param None + * @retval FLASH Status: The returned value can be: FLASH_BUSY, FLASH_ERROR_PROGRAM, + * FLASH_ERROR_WRP, FLASH_ERROR_RD, FLASH_ERROR_OPERATION or FLASH_COMPLETE. + */ +FLASH_Status FLASH_GetStatus(void) +{ + FLASH_Status flashstatus = FLASH_COMPLETE; + + if((FLASH->SR & FLASH_FLAG_BSY) == FLASH_FLAG_BSY) + { + flashstatus = FLASH_BUSY; + } + else + { + if((FLASH->SR & FLASH_FLAG_WRPERR) != (uint32_t)0x00) + { + flashstatus = FLASH_ERROR_WRP; + } + else + { + if((FLASH->SR & FLASH_FLAG_RDERR) != (uint32_t)0x00) + { + flashstatus = FLASH_ERROR_RD; + } + else + { + if((FLASH->SR & (uint32_t)0xEF) != (uint32_t)0x00) + { + flashstatus = FLASH_ERROR_PROGRAM; + } + else + { + if((FLASH->SR & FLASH_FLAG_OPERR) != (uint32_t)0x00) + { + flashstatus = FLASH_ERROR_OPERATION; + } + else + { + flashstatus = FLASH_COMPLETE; + } + } + } + } + } + /* Return the FLASH Status */ + return flashstatus; +} + +/** + * @brief Waits for a FLASH operation to complete. + * @param None + * @retval FLASH Status: The returned value can be: FLASH_BUSY, FLASH_ERROR_PROGRAM, + * FLASH_ERROR_WRP, FLASH_ERROR_OPERATION or FLASH_COMPLETE. + */ +FLASH_Status FLASH_WaitForLastOperation(void) +{ + __IO FLASH_Status status = FLASH_COMPLETE; + + /* Check for the FLASH Status */ + status = FLASH_GetStatus(); + + /* Wait for the FLASH operation to complete by polling on BUSY flag to be reset. + Even if the FLASH operation fails, the BUSY flag will be reset and an error + flag will be set */ + while(status == FLASH_BUSY) + { + status = FLASH_GetStatus(); + } + /* Return the operation status */ + return status; +} + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/src/stm32f4xx_flash_ramfunc.c b/FWLIB/src/stm32f4xx_flash_ramfunc.c new file mode 100644 index 0000000..11e81b6 --- /dev/null +++ b/FWLIB/src/stm32f4xx_flash_ramfunc.c @@ -0,0 +1,158 @@ +/** + ****************************************************************************** + * @file stm32f4xx_flash_ramfunc.c + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief FLASH RAMFUNC module driver. + * This file provides a FLASH firmware functions which should be + * executed from internal SRAM + * + Stop/Start the flash interface while System Run + * + Enable/Disable the flash sleep while System Run + * + @verbatim + ============================================================================== + ##### APIs executed from Internal RAM ##### + ============================================================================== + [..] + *** ARM Compiler *** + -------------------- + [..] RAM functions are defined using the toolchain options. + Functions that are be executed in RAM should reside in a separate + source module. Using the 'Options for File' dialog you can simply change + the 'Code / Const' area of a module to a memory space in physical RAM. + Available memory areas are declared in the 'Target' tab of the + Options for Target' dialog. + + *** ICCARM Compiler *** + ----------------------- + [..] RAM functions are defined using a specific toolchain keyword "__ramfunc". + + *** GNU Compiler *** + -------------------- + [..] RAM functions are defined using a specific toolchain attribute + "__attribute__((section(".RamFunc")))". + + @endverbatim + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx_flash_ramfunc.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @defgroup FLASH RAMFUNC + * @brief FLASH RAMFUNC driver modules + * @{ + */ + +/* Private typedef -----------------------------------------------------------*/ +/* Private define ------------------------------------------------------------*/ +/* Private macro -------------------------------------------------------------*/ +/* Private variables ---------------------------------------------------------*/ +/* Private function prototypes -----------------------------------------------*/ +/* Private functions ---------------------------------------------------------*/ + +/** @defgroup FLASH_RAMFUNC_Private_Functions + * @{ + */ + +/** @defgroup FLASH_RAMFUNC_Group1 Peripheral features functions executed from internal RAM + * @brief Peripheral Extended features functions + * +@verbatim + + =============================================================================== + ##### ramfunc functions ##### + =============================================================================== + [..] + This subsection provides a set of functions that should be executed from RAM + transfers. + +@endverbatim + * @{ + */ + +/** + * @brief Start/Stop the flash interface while System Run + * @note This mode is only available for STM32F411xx devices. + * @note This mode could n't be set while executing with the flash itself. + * It should be done with specific routine executed from RAM. + * @param NewState: new state of the Smart Card mode. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +__RAM_FUNC FLASH_FlashInterfaceCmd(FunctionalState NewState) +{ + if (NewState != DISABLE) + { + /* Start the flash interface while System Run */ + CLEAR_BIT(PWR->CR, PWR_CR_FISSR); + } + else + { + /* Stop the flash interface while System Run */ + SET_BIT(PWR->CR, PWR_CR_FISSR); + } +} + +/** + * @brief Enable/Disable the flash sleep while System Run + * @note This mode is only available for STM32F411xx devices. + * @note This mode could n't be set while executing with the flash itself. + * It should be done with specific routine executed from RAM. + * @param NewState: new state of the Smart Card mode. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +__RAM_FUNC FLASH_FlashSleepModeCmd(FunctionalState NewState) +{ + if (NewState != DISABLE) + { + /* Enable the flash sleep while System Run */ + SET_BIT(PWR->CR, PWR_CR_FMSSR); + } + else + { + /* Disable the flash sleep while System Run */ + CLEAR_BIT(PWR->CR, PWR_CR_FMSSR); + } +} + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/src/stm32f4xx_fmc.c b/FWLIB/src/stm32f4xx_fmc.c new file mode 100644 index 0000000..fd81167 --- /dev/null +++ b/FWLIB/src/stm32f4xx_fmc.c @@ -0,0 +1,1367 @@ +/** + ****************************************************************************** + * @file stm32f4xx_fmc.c + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file provides firmware functions to manage the following + * functionalities of the FMC peripheral: + * + Interface with SRAM, PSRAM, NOR and OneNAND memories + * + Interface with NAND memories + * + Interface with 16-bit PC Card compatible memories + * + Interface with SDRAM memories + * + Interrupts and flags management + * + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx_fmc.h" +#include "stm32f4xx_rcc.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @defgroup FMC + * @brief FMC driver modules + * @{ + */ + +/* Private typedef -----------------------------------------------------------*/ +const FMC_NORSRAMTimingInitTypeDef FMC_DefaultTimingStruct = {0x0F, /* FMC_AddressSetupTime */ + 0x0F, /* FMC_AddressHoldTime */ + 0xFF, /* FMC_DataSetupTime */ + 0x0F, /* FMC_BusTurnAroundDuration */ + 0x0F, /* FMC_CLKDivision */ + 0x0F, /* FMC_DataLatency */ + FMC_AccessMode_A /* FMC_AccessMode */ + }; +/* --------------------- FMC registers bit mask ---------------------------- */ +/* FMC BCRx Mask */ +#define BCR_MBKEN_SET ((uint32_t)0x00000001) +#define BCR_MBKEN_RESET ((uint32_t)0x000FFFFE) +#define BCR_FACCEN_SET ((uint32_t)0x00000040) + +/* FMC PCRx Mask */ +#define PCR_PBKEN_SET ((uint32_t)0x00000004) +#define PCR_PBKEN_RESET ((uint32_t)0x000FFFFB) +#define PCR_ECCEN_SET ((uint32_t)0x00000040) +#define PCR_ECCEN_RESET ((uint32_t)0x000FFFBF) +#define PCR_MEMORYTYPE_NAND ((uint32_t)0x00000008) + +/* FMC SDCRx write protection Mask*/ +#define SDCR_WriteProtection_RESET ((uint32_t)0x00007DFF) + +/* FMC SDCMR Mask*/ +#define SDCMR_CTB1_RESET ((uint32_t)0x003FFFEF) +#define SDCMR_CTB2_RESET ((uint32_t)0x003FFFF7) +#define SDCMR_CTB1_2_RESET ((uint32_t)0x003FFFE7) + +/* Private macro -------------------------------------------------------------*/ +/* Private variables ---------------------------------------------------------*/ +/* Private function prototypes -----------------------------------------------*/ +/* Private functions ---------------------------------------------------------*/ + +/** @defgroup FMC_Private_Functions + * @{ + */ + +/** @defgroup FMC_Group1 NOR/SRAM Controller functions + * @brief NOR/SRAM Controller functions + * +@verbatim + =============================================================================== + ##### NOR and SRAM Controller functions ##### + =============================================================================== + + [..] The following sequence should be followed to configure the FMC to interface + with SRAM, PSRAM, NOR or OneNAND memory connected to the NOR/SRAM Bank: + + (#) Enable the clock for the FMC and associated GPIOs using the following functions: + RCC_AHB3PeriphClockCmd(RCC_AHB3Periph_FMC, ENABLE); + RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOx, ENABLE); + + (#) FMC pins configuration + (++) Connect the involved FMC pins to AF12 using the following function + GPIO_PinAFConfig(GPIOx, GPIO_PinSourcex, GPIO_AF_FMC); + (++) Configure these FMC pins in alternate function mode by calling the function + GPIO_Init(); + + (#) Declare a FMC_NORSRAMInitTypeDef structure, for example: + FMC_NORSRAMInitTypeDef FMC_NORSRAMInitStructure; + and fill the FMC_NORSRAMInitStructure variable with the allowed values of + the structure member. + + (#) Initialize the NOR/SRAM Controller by calling the function + FMC_NORSRAMInit(&FMC_NORSRAMInitStructure); + + (#) Then enable the NOR/SRAM Bank, for example: + FMC_NORSRAMCmd(FMC_Bank1_NORSRAM2, ENABLE); + + (#) At this stage you can read/write from/to the memory connected to the NOR/SRAM Bank. + +@endverbatim + * @{ + */ + +/** + * @brief De-initializes the FMC NOR/SRAM Banks registers to their default + * reset values. + * @param FMC_Bank: specifies the FMC Bank to be used + * This parameter can be one of the following values: + * @arg FMC_Bank1_NORSRAM1: FMC Bank1 NOR/SRAM1 + * @arg FMC_Bank1_NORSRAM2: FMC Bank1 NOR/SRAM2 + * @arg FMC_Bank1_NORSRAM3: FMC Bank1 NOR/SRAM3 + * @arg FMC_Bank1_NORSRAM4: FMC Bank1 NOR/SRAM4 + * @retval None + */ +void FMC_NORSRAMDeInit(uint32_t FMC_Bank) +{ + /* Check the parameter */ + assert_param(IS_FMC_NORSRAM_BANK(FMC_Bank)); + + /* FMC_Bank1_NORSRAM1 */ + if(FMC_Bank == FMC_Bank1_NORSRAM1) + { + FMC_Bank1->BTCR[FMC_Bank] = 0x000030DB; + } + /* FMC_Bank1_NORSRAM2, FMC_Bank1_NORSRAM3 or FMC_Bank1_NORSRAM4 */ + else + { + FMC_Bank1->BTCR[FMC_Bank] = 0x000030D2; + } + FMC_Bank1->BTCR[FMC_Bank + 1] = 0x0FFFFFFF; + FMC_Bank1E->BWTR[FMC_Bank] = 0x0FFFFFFF; +} + +/** + * @brief Initializes the FMC NOR/SRAM Banks according to the specified + * parameters in the FMC_NORSRAMInitStruct. + * @param FMC_NORSRAMInitStruct : pointer to a FMC_NORSRAMInitTypeDef structure + * that contains the configuration information for the FMC NOR/SRAM + * specified Banks. + * @retval None + */ +void FMC_NORSRAMInit(FMC_NORSRAMInitTypeDef* FMC_NORSRAMInitStruct) +{ + uint32_t tmpr = 0; + + /* Check the parameters */ + assert_param(IS_FMC_NORSRAM_BANK(FMC_NORSRAMInitStruct->FMC_Bank)); + assert_param(IS_FMC_MUX(FMC_NORSRAMInitStruct->FMC_DataAddressMux)); + assert_param(IS_FMC_MEMORY(FMC_NORSRAMInitStruct->FMC_MemoryType)); + assert_param(IS_FMC_NORSRAM_MEMORY_WIDTH(FMC_NORSRAMInitStruct->FMC_MemoryDataWidth)); + assert_param(IS_FMC_BURSTMODE(FMC_NORSRAMInitStruct->FMC_BurstAccessMode)); + assert_param(IS_FMC_WAIT_POLARITY(FMC_NORSRAMInitStruct->FMC_WaitSignalPolarity)); + assert_param(IS_FMC_WRAP_MODE(FMC_NORSRAMInitStruct->FMC_WrapMode)); + assert_param(IS_FMC_WAIT_SIGNAL_ACTIVE(FMC_NORSRAMInitStruct->FMC_WaitSignalActive)); + assert_param(IS_FMC_WRITE_OPERATION(FMC_NORSRAMInitStruct->FMC_WriteOperation)); + assert_param(IS_FMC_WAITE_SIGNAL(FMC_NORSRAMInitStruct->FMC_WaitSignal)); + assert_param(IS_FMC_EXTENDED_MODE(FMC_NORSRAMInitStruct->FMC_ExtendedMode)); + assert_param(IS_FMC_ASYNWAIT(FMC_NORSRAMInitStruct->FMC_AsynchronousWait)); + assert_param(IS_FMC_WRITE_BURST(FMC_NORSRAMInitStruct->FMC_WriteBurst)); + assert_param(IS_FMC_CONTINOUS_CLOCK(FMC_NORSRAMInitStruct->FMC_ContinousClock)); + assert_param(IS_FMC_ADDRESS_SETUP_TIME(FMC_NORSRAMInitStruct->FMC_ReadWriteTimingStruct->FMC_AddressSetupTime)); + assert_param(IS_FMC_ADDRESS_HOLD_TIME(FMC_NORSRAMInitStruct->FMC_ReadWriteTimingStruct->FMC_AddressHoldTime)); + assert_param(IS_FMC_DATASETUP_TIME(FMC_NORSRAMInitStruct->FMC_ReadWriteTimingStruct->FMC_DataSetupTime)); + assert_param(IS_FMC_TURNAROUND_TIME(FMC_NORSRAMInitStruct->FMC_ReadWriteTimingStruct->FMC_BusTurnAroundDuration)); + assert_param(IS_FMC_CLK_DIV(FMC_NORSRAMInitStruct->FMC_ReadWriteTimingStruct->FMC_CLKDivision)); + assert_param(IS_FMC_DATA_LATENCY(FMC_NORSRAMInitStruct->FMC_ReadWriteTimingStruct->FMC_DataLatency)); + assert_param(IS_FMC_ACCESS_MODE(FMC_NORSRAMInitStruct->FMC_ReadWriteTimingStruct->FMC_AccessMode)); + + /* NOR/SRAM Bank control register configuration */ + FMC_Bank1->BTCR[FMC_NORSRAMInitStruct->FMC_Bank] = + (uint32_t)FMC_NORSRAMInitStruct->FMC_DataAddressMux | + FMC_NORSRAMInitStruct->FMC_MemoryType | + FMC_NORSRAMInitStruct->FMC_MemoryDataWidth | + FMC_NORSRAMInitStruct->FMC_BurstAccessMode | + FMC_NORSRAMInitStruct->FMC_WaitSignalPolarity | + FMC_NORSRAMInitStruct->FMC_WrapMode | + FMC_NORSRAMInitStruct->FMC_WaitSignalActive | + FMC_NORSRAMInitStruct->FMC_WriteOperation | + FMC_NORSRAMInitStruct->FMC_WaitSignal | + FMC_NORSRAMInitStruct->FMC_ExtendedMode | + FMC_NORSRAMInitStruct->FMC_AsynchronousWait | + FMC_NORSRAMInitStruct->FMC_WriteBurst | + FMC_NORSRAMInitStruct->FMC_ContinousClock; + + + if(FMC_NORSRAMInitStruct->FMC_MemoryType == FMC_MemoryType_NOR) + { + FMC_Bank1->BTCR[FMC_NORSRAMInitStruct->FMC_Bank] |= (uint32_t)BCR_FACCEN_SET; + } + + /* Configure Continuous clock feature when bank2..4 is used */ + if((FMC_NORSRAMInitStruct->FMC_ContinousClock == FMC_CClock_SyncAsync) && (FMC_NORSRAMInitStruct->FMC_Bank != FMC_Bank1_NORSRAM1)) + { + tmpr = (uint32_t)((FMC_Bank1->BTCR[FMC_Bank1_NORSRAM1+1]) & ~(((uint32_t)0x0F) << 20)); + + FMC_Bank1->BTCR[FMC_Bank1_NORSRAM1] |= FMC_NORSRAMInitStruct->FMC_ContinousClock; + FMC_Bank1->BTCR[FMC_Bank1_NORSRAM1] |= FMC_BurstAccessMode_Enable; + FMC_Bank1->BTCR[FMC_Bank1_NORSRAM1+1] = (uint32_t)(tmpr | (((FMC_NORSRAMInitStruct->FMC_ReadWriteTimingStruct->FMC_CLKDivision)-1) << 20)); + } + + /* NOR/SRAM Bank timing register configuration */ + FMC_Bank1->BTCR[FMC_NORSRAMInitStruct->FMC_Bank+1] = + (uint32_t)FMC_NORSRAMInitStruct->FMC_ReadWriteTimingStruct->FMC_AddressSetupTime | + (FMC_NORSRAMInitStruct->FMC_ReadWriteTimingStruct->FMC_AddressHoldTime << 4) | + (FMC_NORSRAMInitStruct->FMC_ReadWriteTimingStruct->FMC_DataSetupTime << 8) | + (FMC_NORSRAMInitStruct->FMC_ReadWriteTimingStruct->FMC_BusTurnAroundDuration << 16) | + ((FMC_NORSRAMInitStruct->FMC_ReadWriteTimingStruct->FMC_CLKDivision) << 20) | + ((FMC_NORSRAMInitStruct->FMC_ReadWriteTimingStruct->FMC_DataLatency) << 24) | + FMC_NORSRAMInitStruct->FMC_ReadWriteTimingStruct->FMC_AccessMode; + + /* NOR/SRAM Bank timing register for write configuration, if extended mode is used */ + if(FMC_NORSRAMInitStruct->FMC_ExtendedMode == FMC_ExtendedMode_Enable) + { + assert_param(IS_FMC_ADDRESS_SETUP_TIME(FMC_NORSRAMInitStruct->FMC_WriteTimingStruct->FMC_AddressSetupTime)); + assert_param(IS_FMC_ADDRESS_HOLD_TIME(FMC_NORSRAMInitStruct->FMC_WriteTimingStruct->FMC_AddressHoldTime)); + assert_param(IS_FMC_DATASETUP_TIME(FMC_NORSRAMInitStruct->FMC_WriteTimingStruct->FMC_DataSetupTime)); + assert_param(IS_FMC_CLK_DIV(FMC_NORSRAMInitStruct->FMC_WriteTimingStruct->FMC_CLKDivision)); + assert_param(IS_FMC_DATA_LATENCY(FMC_NORSRAMInitStruct->FMC_WriteTimingStruct->FMC_DataLatency)); + assert_param(IS_FMC_ACCESS_MODE(FMC_NORSRAMInitStruct->FMC_WriteTimingStruct->FMC_AccessMode)); + + FMC_Bank1E->BWTR[FMC_NORSRAMInitStruct->FMC_Bank] = + (uint32_t)FMC_NORSRAMInitStruct->FMC_WriteTimingStruct->FMC_AddressSetupTime | + (FMC_NORSRAMInitStruct->FMC_WriteTimingStruct->FMC_AddressHoldTime << 4 )| + (FMC_NORSRAMInitStruct->FMC_WriteTimingStruct->FMC_DataSetupTime << 8) | + ((FMC_NORSRAMInitStruct->FMC_WriteTimingStruct->FMC_CLKDivision) << 20) | + ((FMC_NORSRAMInitStruct->FMC_WriteTimingStruct->FMC_DataLatency) << 24) | + FMC_NORSRAMInitStruct->FMC_WriteTimingStruct->FMC_AccessMode; + } + else + { + FMC_Bank1E->BWTR[FMC_NORSRAMInitStruct->FMC_Bank] = 0x0FFFFFFF; + } + +} + +/** + * @brief Fills each FMC_NORSRAMInitStruct member with its default value. + * @param FMC_NORSRAMInitStruct: pointer to a FMC_NORSRAMInitTypeDef structure + * which will be initialized. + * @retval None + */ +void FMC_NORSRAMStructInit(FMC_NORSRAMInitTypeDef* FMC_NORSRAMInitStruct) +{ + /* Reset NOR/SRAM Init structure parameters values */ + FMC_NORSRAMInitStruct->FMC_Bank = FMC_Bank1_NORSRAM1; + FMC_NORSRAMInitStruct->FMC_DataAddressMux = FMC_DataAddressMux_Enable; + FMC_NORSRAMInitStruct->FMC_MemoryType = FMC_MemoryType_SRAM; + FMC_NORSRAMInitStruct->FMC_MemoryDataWidth = FMC_NORSRAM_MemoryDataWidth_16b; + FMC_NORSRAMInitStruct->FMC_BurstAccessMode = FMC_BurstAccessMode_Disable; + FMC_NORSRAMInitStruct->FMC_AsynchronousWait = FMC_AsynchronousWait_Disable; + FMC_NORSRAMInitStruct->FMC_WaitSignalPolarity = FMC_WaitSignalPolarity_Low; + FMC_NORSRAMInitStruct->FMC_WrapMode = FMC_WrapMode_Disable; + FMC_NORSRAMInitStruct->FMC_WaitSignalActive = FMC_WaitSignalActive_BeforeWaitState; + FMC_NORSRAMInitStruct->FMC_WriteOperation = FMC_WriteOperation_Enable; + FMC_NORSRAMInitStruct->FMC_WaitSignal = FMC_WaitSignal_Enable; + FMC_NORSRAMInitStruct->FMC_ExtendedMode = FMC_ExtendedMode_Disable; + FMC_NORSRAMInitStruct->FMC_WriteBurst = FMC_WriteBurst_Disable; + FMC_NORSRAMInitStruct->FMC_ContinousClock = FMC_CClock_SyncOnly; + + FMC_NORSRAMInitStruct->FMC_ReadWriteTimingStruct = (FMC_NORSRAMTimingInitTypeDef*)&FMC_DefaultTimingStruct; + FMC_NORSRAMInitStruct->FMC_WriteTimingStruct = (FMC_NORSRAMTimingInitTypeDef*)&FMC_DefaultTimingStruct; +} + +/** + * @brief Enables or disables the specified NOR/SRAM Memory Bank. + * @param FMC_Bank: specifies the FMC Bank to be used + * This parameter can be one of the following values: + * @arg FMC_Bank1_NORSRAM1: FMC Bank1 NOR/SRAM1 + * @arg FMC_Bank1_NORSRAM2: FMC Bank1 NOR/SRAM2 + * @arg FMC_Bank1_NORSRAM3: FMC Bank1 NOR/SRAM3 + * @arg FMC_Bank1_NORSRAM4: FMC Bank1 NOR/SRAM4 + * @param NewState: new state of the FMC_Bank. This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void FMC_NORSRAMCmd(uint32_t FMC_Bank, FunctionalState NewState) +{ + assert_param(IS_FMC_NORSRAM_BANK(FMC_Bank)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the selected NOR/SRAM Bank by setting the PBKEN bit in the BCRx register */ + FMC_Bank1->BTCR[FMC_Bank] |= BCR_MBKEN_SET; + } + else + { + /* Disable the selected NOR/SRAM Bank by clearing the PBKEN bit in the BCRx register */ + FMC_Bank1->BTCR[FMC_Bank] &= BCR_MBKEN_RESET; + } +} +/** + * @} + */ + +/** @defgroup FMC_Group2 NAND Controller functions + * @brief NAND Controller functions + * +@verbatim + =============================================================================== + ##### NAND Controller functions ##### + =============================================================================== + + [..] The following sequence should be followed to configure the FMC to interface + with 8-bit or 16-bit NAND memory connected to the NAND Bank: + + (#) Enable the clock for the FMC and associated GPIOs using the following functions: + (++) RCC_AHB3PeriphClockCmd(RCC_AHB3Periph_FMC, ENABLE); + (++) RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOx, ENABLE); + + (#) FMC pins configuration + (++) Connect the involved FMC pins to AF12 using the following function + GPIO_PinAFConfig(GPIOx, GPIO_PinSourcex, GPIO_AF_FMC); + (++) Configure these FMC pins in alternate function mode by calling the function + GPIO_Init(); + + (#) Declare a FMC_NANDInitTypeDef structure, for example: + FMC_NANDInitTypeDef FMC_NANDInitStructure; + and fill the FMC_NANDInitStructure variable with the allowed values of + the structure member. + + (#) Initialize the NAND Controller by calling the function + FMC_NANDInit(&FMC_NANDInitStructure); + + (#) Then enable the NAND Bank, for example: + FMC_NANDCmd(FMC_Bank3_NAND, ENABLE); + + (#) At this stage you can read/write from/to the memory connected to the NAND Bank. + + [..] + (@) To enable the Error Correction Code (ECC), you have to use the function + FMC_NANDECCCmd(FMC_Bank3_NAND, ENABLE); + [..] + (@) and to get the current ECC value you have to use the function + ECCval = FMC_GetECC(FMC_Bank3_NAND); + +@endverbatim + * @{ + */ + +/** + * @brief De-initializes the FMC NAND Banks registers to their default reset values. + * @param FMC_Bank: specifies the FMC Bank to be used + * This parameter can be one of the following values: + * @arg FMC_Bank2_NAND: FMC Bank2 NAND + * @arg FMC_Bank3_NAND: FMC Bank3 NAND + * @retval None + */ +void FMC_NANDDeInit(uint32_t FMC_Bank) +{ + /* Check the parameter */ + assert_param(IS_FMC_NAND_BANK(FMC_Bank)); + + if(FMC_Bank == FMC_Bank2_NAND) + { + /* Set the FMC_Bank2 registers to their reset values */ + FMC_Bank2->PCR2 = 0x00000018; + FMC_Bank2->SR2 = 0x00000040; + FMC_Bank2->PMEM2 = 0xFCFCFCFC; + FMC_Bank2->PATT2 = 0xFCFCFCFC; + } + /* FMC_Bank3_NAND */ + else + { + /* Set the FMC_Bank3 registers to their reset values */ + FMC_Bank3->PCR3 = 0x00000018; + FMC_Bank3->SR3 = 0x00000040; + FMC_Bank3->PMEM3 = 0xFCFCFCFC; + FMC_Bank3->PATT3 = 0xFCFCFCFC; + } +} + +/** + * @brief Initializes the FMC NAND Banks according to the specified parameters + * in the FMC_NANDInitStruct. + * @param FMC_NANDInitStruct : pointer to a FMC_NANDInitTypeDef structure that + * contains the configuration information for the FMC NAND specified Banks. + * @retval None + */ +void FMC_NANDInit(FMC_NANDInitTypeDef* FMC_NANDInitStruct) +{ + uint32_t tmppcr = 0x00000000, tmppmem = 0x00000000, tmppatt = 0x00000000; + + /* Check the parameters */ + assert_param(IS_FMC_NAND_BANK(FMC_NANDInitStruct->FMC_Bank)); + assert_param(IS_FMC_WAIT_FEATURE(FMC_NANDInitStruct->FMC_Waitfeature)); + assert_param(IS_FMC_NAND_MEMORY_WIDTH(FMC_NANDInitStruct->FMC_MemoryDataWidth)); + assert_param(IS_FMC_ECC_STATE(FMC_NANDInitStruct->FMC_ECC)); + assert_param(IS_FMC_ECCPAGE_SIZE(FMC_NANDInitStruct->FMC_ECCPageSize)); + assert_param(IS_FMC_TCLR_TIME(FMC_NANDInitStruct->FMC_TCLRSetupTime)); + assert_param(IS_FMC_TAR_TIME(FMC_NANDInitStruct->FMC_TARSetupTime)); + assert_param(IS_FMC_SETUP_TIME(FMC_NANDInitStruct->FMC_CommonSpaceTimingStruct->FMC_SetupTime)); + assert_param(IS_FMC_WAIT_TIME(FMC_NANDInitStruct->FMC_CommonSpaceTimingStruct->FMC_WaitSetupTime)); + assert_param(IS_FMC_HOLD_TIME(FMC_NANDInitStruct->FMC_CommonSpaceTimingStruct->FMC_HoldSetupTime)); + assert_param(IS_FMC_HIZ_TIME(FMC_NANDInitStruct->FMC_CommonSpaceTimingStruct->FMC_HiZSetupTime)); + assert_param(IS_FMC_SETUP_TIME(FMC_NANDInitStruct->FMC_AttributeSpaceTimingStruct->FMC_SetupTime)); + assert_param(IS_FMC_WAIT_TIME(FMC_NANDInitStruct->FMC_AttributeSpaceTimingStruct->FMC_WaitSetupTime)); + assert_param(IS_FMC_HOLD_TIME(FMC_NANDInitStruct->FMC_AttributeSpaceTimingStruct->FMC_HoldSetupTime)); + assert_param(IS_FMC_HIZ_TIME(FMC_NANDInitStruct->FMC_AttributeSpaceTimingStruct->FMC_HiZSetupTime)); + + /* Set the tmppcr value according to FMC_NANDInitStruct parameters */ + tmppcr = (uint32_t)FMC_NANDInitStruct->FMC_Waitfeature | + PCR_MEMORYTYPE_NAND | + FMC_NANDInitStruct->FMC_MemoryDataWidth | + FMC_NANDInitStruct->FMC_ECC | + FMC_NANDInitStruct->FMC_ECCPageSize | + (FMC_NANDInitStruct->FMC_TCLRSetupTime << 9 )| + (FMC_NANDInitStruct->FMC_TARSetupTime << 13); + + /* Set tmppmem value according to FMC_CommonSpaceTimingStructure parameters */ + tmppmem = (uint32_t)FMC_NANDInitStruct->FMC_CommonSpaceTimingStruct->FMC_SetupTime | + (FMC_NANDInitStruct->FMC_CommonSpaceTimingStruct->FMC_WaitSetupTime << 8) | + (FMC_NANDInitStruct->FMC_CommonSpaceTimingStruct->FMC_HoldSetupTime << 16)| + (FMC_NANDInitStruct->FMC_CommonSpaceTimingStruct->FMC_HiZSetupTime << 24); + + /* Set tmppatt value according to FMC_AttributeSpaceTimingStructure parameters */ + tmppatt = (uint32_t)FMC_NANDInitStruct->FMC_AttributeSpaceTimingStruct->FMC_SetupTime | + (FMC_NANDInitStruct->FMC_AttributeSpaceTimingStruct->FMC_WaitSetupTime << 8) | + (FMC_NANDInitStruct->FMC_AttributeSpaceTimingStruct->FMC_HoldSetupTime << 16)| + (FMC_NANDInitStruct->FMC_AttributeSpaceTimingStruct->FMC_HiZSetupTime << 24); + + if(FMC_NANDInitStruct->FMC_Bank == FMC_Bank2_NAND) + { + /* FMC_Bank2_NAND registers configuration */ + FMC_Bank2->PCR2 = tmppcr; + FMC_Bank2->PMEM2 = tmppmem; + FMC_Bank2->PATT2 = tmppatt; + } + else + { + /* FMC_Bank3_NAND registers configuration */ + FMC_Bank3->PCR3 = tmppcr; + FMC_Bank3->PMEM3 = tmppmem; + FMC_Bank3->PATT3 = tmppatt; + } +} + + +/** + * @brief Fills each FMC_NANDInitStruct member with its default value. + * @param FMC_NANDInitStruct: pointer to a FMC_NANDInitTypeDef structure which + * will be initialized. + * @retval None + */ +void FMC_NANDStructInit(FMC_NANDInitTypeDef* FMC_NANDInitStruct) +{ + /* Reset NAND Init structure parameters values */ + FMC_NANDInitStruct->FMC_Bank = FMC_Bank2_NAND; + FMC_NANDInitStruct->FMC_Waitfeature = FMC_Waitfeature_Disable; + FMC_NANDInitStruct->FMC_MemoryDataWidth = FMC_NAND_MemoryDataWidth_16b; + FMC_NANDInitStruct->FMC_ECC = FMC_ECC_Disable; + FMC_NANDInitStruct->FMC_ECCPageSize = FMC_ECCPageSize_256Bytes; + FMC_NANDInitStruct->FMC_TCLRSetupTime = 0x0; + FMC_NANDInitStruct->FMC_TARSetupTime = 0x0; + FMC_NANDInitStruct->FMC_CommonSpaceTimingStruct->FMC_SetupTime = 252; + FMC_NANDInitStruct->FMC_CommonSpaceTimingStruct->FMC_WaitSetupTime = 252; + FMC_NANDInitStruct->FMC_CommonSpaceTimingStruct->FMC_HoldSetupTime = 252; + FMC_NANDInitStruct->FMC_CommonSpaceTimingStruct->FMC_HiZSetupTime = 252; + FMC_NANDInitStruct->FMC_AttributeSpaceTimingStruct->FMC_SetupTime = 252; + FMC_NANDInitStruct->FMC_AttributeSpaceTimingStruct->FMC_WaitSetupTime = 252; + FMC_NANDInitStruct->FMC_AttributeSpaceTimingStruct->FMC_HoldSetupTime = 252; + FMC_NANDInitStruct->FMC_AttributeSpaceTimingStruct->FMC_HiZSetupTime = 252; +} + +/** + * @brief Enables or disables the specified NAND Memory Bank. + * @param FMC_Bank: specifies the FMC Bank to be used + * This parameter can be one of the following values: + * @arg FMC_Bank2_NAND: FMC Bank2 NAND + * @arg FMC_Bank3_NAND: FMC Bank3 NAND + * @param NewState: new state of the FMC_Bank. This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void FMC_NANDCmd(uint32_t FMC_Bank, FunctionalState NewState) +{ + assert_param(IS_FMC_NAND_BANK(FMC_Bank)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the selected NAND Bank by setting the PBKEN bit in the PCRx register */ + if(FMC_Bank == FMC_Bank2_NAND) + { + FMC_Bank2->PCR2 |= PCR_PBKEN_SET; + } + else + { + FMC_Bank3->PCR3 |= PCR_PBKEN_SET; + } + } + else + { + /* Disable the selected NAND Bank by clearing the PBKEN bit in the PCRx register */ + if(FMC_Bank == FMC_Bank2_NAND) + { + FMC_Bank2->PCR2 &= PCR_PBKEN_RESET; + } + else + { + FMC_Bank3->PCR3 &= PCR_PBKEN_RESET; + } + } +} +/** + * @brief Enables or disables the FMC NAND ECC feature. + * @param FMC_Bank: specifies the FMC Bank to be used + * This parameter can be one of the following values: + * @arg FMC_Bank2_NAND: FMC Bank2 NAND + * @arg FMC_Bank3_NAND: FMC Bank3 NAND + * @param NewState: new state of the FMC NAND ECC feature. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void FMC_NANDECCCmd(uint32_t FMC_Bank, FunctionalState NewState) +{ + assert_param(IS_FMC_NAND_BANK(FMC_Bank)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the selected NAND Bank ECC function by setting the ECCEN bit in the PCRx register */ + if(FMC_Bank == FMC_Bank2_NAND) + { + FMC_Bank2->PCR2 |= PCR_ECCEN_SET; + } + else + { + FMC_Bank3->PCR3 |= PCR_ECCEN_SET; + } + } + else + { + /* Disable the selected NAND Bank ECC function by clearing the ECCEN bit in the PCRx register */ + if(FMC_Bank == FMC_Bank2_NAND) + { + FMC_Bank2->PCR2 &= PCR_ECCEN_RESET; + } + else + { + FMC_Bank3->PCR3 &= PCR_ECCEN_RESET; + } + } +} + +/** + * @brief Returns the error correction code register value. + * @param FMC_Bank: specifies the FMC Bank to be used + * This parameter can be one of the following values: + * @arg FMC_Bank2_NAND: FMC Bank2 NAND + * @arg FMC_Bank3_NAND: FMC Bank3 NAND + * @retval The Error Correction Code (ECC) value. + */ +uint32_t FMC_GetECC(uint32_t FMC_Bank) +{ + uint32_t eccval = 0x00000000; + + if(FMC_Bank == FMC_Bank2_NAND) + { + /* Get the ECCR2 register value */ + eccval = FMC_Bank2->ECCR2; + } + else + { + /* Get the ECCR3 register value */ + eccval = FMC_Bank3->ECCR3; + } + /* Return the error correction code value */ + return(eccval); +} +/** + * @} + */ + +/** @defgroup FMC_Group3 PCCARD Controller functions + * @brief PCCARD Controller functions + * +@verbatim + =============================================================================== + ##### PCCARD Controller functions ##### + =============================================================================== + + [..] he following sequence should be followed to configure the FMC to interface + with 16-bit PC Card compatible memory connected to the PCCARD Bank: + + (#) Enable the clock for the FMC and associated GPIOs using the following functions: + (++) RCC_AHB3PeriphClockCmd(RCC_AHB3Periph_FMC, ENABLE); + (++) RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOx, ENABLE); + + (#) FMC pins configuration + (++) Connect the involved FMC pins to AF12 using the following function + GPIO_PinAFConfig(GPIOx, GPIO_PinSourcex, GPIO_AF_FMC); + (++) Configure these FMC pins in alternate function mode by calling the function + GPIO_Init(); + + (#) Declare a FMC_PCCARDInitTypeDef structure, for example: + FMC_PCCARDInitTypeDef FMC_PCCARDInitStructure; + and fill the FMC_PCCARDInitStructure variable with the allowed values of + the structure member. + + (#) Initialize the PCCARD Controller by calling the function + FMC_PCCARDInit(&FMC_PCCARDInitStructure); + + (#) Then enable the PCCARD Bank: + FMC_PCCARDCmd(ENABLE); + + (#) At this stage you can read/write from/to the memory connected to the PCCARD Bank. + +@endverbatim + * @{ + */ + +/** + * @brief De-initializes the FMC PCCARD Bank registers to their default reset values. + * @param None + * @retval None + */ +void FMC_PCCARDDeInit(void) +{ + /* Set the FMC_Bank4 registers to their reset values */ + FMC_Bank4->PCR4 = 0x00000018; + FMC_Bank4->SR4 = 0x00000000; + FMC_Bank4->PMEM4 = 0xFCFCFCFC; + FMC_Bank4->PATT4 = 0xFCFCFCFC; + FMC_Bank4->PIO4 = 0xFCFCFCFC; +} + +/** + * @brief Initializes the FMC PCCARD Bank according to the specified parameters + * in the FMC_PCCARDInitStruct. + * @param FMC_PCCARDInitStruct : pointer to a FMC_PCCARDInitTypeDef structure + * that contains the configuration information for the FMC PCCARD Bank. + * @retval None + */ +void FMC_PCCARDInit(FMC_PCCARDInitTypeDef* FMC_PCCARDInitStruct) +{ + /* Check the parameters */ + assert_param(IS_FMC_WAIT_FEATURE(FMC_PCCARDInitStruct->FMC_Waitfeature)); + assert_param(IS_FMC_TCLR_TIME(FMC_PCCARDInitStruct->FMC_TCLRSetupTime)); + assert_param(IS_FMC_TAR_TIME(FMC_PCCARDInitStruct->FMC_TARSetupTime)); + + assert_param(IS_FMC_SETUP_TIME(FMC_PCCARDInitStruct->FMC_CommonSpaceTimingStruct->FMC_SetupTime)); + assert_param(IS_FMC_WAIT_TIME(FMC_PCCARDInitStruct->FMC_CommonSpaceTimingStruct->FMC_WaitSetupTime)); + assert_param(IS_FMC_HOLD_TIME(FMC_PCCARDInitStruct->FMC_CommonSpaceTimingStruct->FMC_HoldSetupTime)); + assert_param(IS_FMC_HIZ_TIME(FMC_PCCARDInitStruct->FMC_CommonSpaceTimingStruct->FMC_HiZSetupTime)); + + assert_param(IS_FMC_SETUP_TIME(FMC_PCCARDInitStruct->FMC_AttributeSpaceTimingStruct->FMC_SetupTime)); + assert_param(IS_FMC_WAIT_TIME(FMC_PCCARDInitStruct->FMC_AttributeSpaceTimingStruct->FMC_WaitSetupTime)); + assert_param(IS_FMC_HOLD_TIME(FMC_PCCARDInitStruct->FMC_AttributeSpaceTimingStruct->FMC_HoldSetupTime)); + assert_param(IS_FMC_HIZ_TIME(FMC_PCCARDInitStruct->FMC_AttributeSpaceTimingStruct->FMC_HiZSetupTime)); + assert_param(IS_FMC_SETUP_TIME(FMC_PCCARDInitStruct->FMC_IOSpaceTimingStruct->FMC_SetupTime)); + assert_param(IS_FMC_WAIT_TIME(FMC_PCCARDInitStruct->FMC_IOSpaceTimingStruct->FMC_WaitSetupTime)); + assert_param(IS_FMC_HOLD_TIME(FMC_PCCARDInitStruct->FMC_IOSpaceTimingStruct->FMC_HoldSetupTime)); + assert_param(IS_FMC_HIZ_TIME(FMC_PCCARDInitStruct->FMC_IOSpaceTimingStruct->FMC_HiZSetupTime)); + + /* Set the PCR4 register value according to FMC_PCCARDInitStruct parameters */ + FMC_Bank4->PCR4 = (uint32_t)FMC_PCCARDInitStruct->FMC_Waitfeature | + FMC_NAND_MemoryDataWidth_16b | + (FMC_PCCARDInitStruct->FMC_TCLRSetupTime << 9) | + (FMC_PCCARDInitStruct->FMC_TARSetupTime << 13); + + /* Set PMEM4 register value according to FMC_CommonSpaceTimingStructure parameters */ + FMC_Bank4->PMEM4 = (uint32_t)FMC_PCCARDInitStruct->FMC_CommonSpaceTimingStruct->FMC_SetupTime | + (FMC_PCCARDInitStruct->FMC_CommonSpaceTimingStruct->FMC_WaitSetupTime << 8) | + (FMC_PCCARDInitStruct->FMC_CommonSpaceTimingStruct->FMC_HoldSetupTime << 16)| + (FMC_PCCARDInitStruct->FMC_CommonSpaceTimingStruct->FMC_HiZSetupTime << 24); + + /* Set PATT4 register value according to FMC_AttributeSpaceTimingStructure parameters */ + FMC_Bank4->PATT4 = (uint32_t)FMC_PCCARDInitStruct->FMC_AttributeSpaceTimingStruct->FMC_SetupTime | + (FMC_PCCARDInitStruct->FMC_AttributeSpaceTimingStruct->FMC_WaitSetupTime << 8) | + (FMC_PCCARDInitStruct->FMC_AttributeSpaceTimingStruct->FMC_HoldSetupTime << 16)| + (FMC_PCCARDInitStruct->FMC_AttributeSpaceTimingStruct->FMC_HiZSetupTime << 24); + + /* Set PIO4 register value according to FMC_IOSpaceTimingStructure parameters */ + FMC_Bank4->PIO4 = (uint32_t)FMC_PCCARDInitStruct->FMC_IOSpaceTimingStruct->FMC_SetupTime | + (FMC_PCCARDInitStruct->FMC_IOSpaceTimingStruct->FMC_WaitSetupTime << 8) | + (FMC_PCCARDInitStruct->FMC_IOSpaceTimingStruct->FMC_HoldSetupTime << 16)| + (FMC_PCCARDInitStruct->FMC_IOSpaceTimingStruct->FMC_HiZSetupTime << 24); +} + +/** + * @brief Fills each FMC_PCCARDInitStruct member with its default value. + * @param FMC_PCCARDInitStruct: pointer to a FMC_PCCARDInitTypeDef structure + * which will be initialized. + * @retval None + */ +void FMC_PCCARDStructInit(FMC_PCCARDInitTypeDef* FMC_PCCARDInitStruct) +{ + /* Reset PCCARD Init structure parameters values */ + FMC_PCCARDInitStruct->FMC_Waitfeature = FMC_Waitfeature_Disable; + FMC_PCCARDInitStruct->FMC_TCLRSetupTime = 0; + FMC_PCCARDInitStruct->FMC_TARSetupTime = 0; + FMC_PCCARDInitStruct->FMC_CommonSpaceTimingStruct->FMC_SetupTime = 252; + FMC_PCCARDInitStruct->FMC_CommonSpaceTimingStruct->FMC_WaitSetupTime = 252; + FMC_PCCARDInitStruct->FMC_CommonSpaceTimingStruct->FMC_HoldSetupTime = 252; + FMC_PCCARDInitStruct->FMC_CommonSpaceTimingStruct->FMC_HiZSetupTime = 252; + FMC_PCCARDInitStruct->FMC_AttributeSpaceTimingStruct->FMC_SetupTime = 252; + FMC_PCCARDInitStruct->FMC_AttributeSpaceTimingStruct->FMC_WaitSetupTime = 252; + FMC_PCCARDInitStruct->FMC_AttributeSpaceTimingStruct->FMC_HoldSetupTime = 252; + FMC_PCCARDInitStruct->FMC_AttributeSpaceTimingStruct->FMC_HiZSetupTime = 252; + FMC_PCCARDInitStruct->FMC_IOSpaceTimingStruct->FMC_SetupTime = 252; + FMC_PCCARDInitStruct->FMC_IOSpaceTimingStruct->FMC_WaitSetupTime = 252; + FMC_PCCARDInitStruct->FMC_IOSpaceTimingStruct->FMC_HoldSetupTime = 252; + FMC_PCCARDInitStruct->FMC_IOSpaceTimingStruct->FMC_HiZSetupTime = 252; +} + +/** + * @brief Enables or disables the PCCARD Memory Bank. + * @param NewState: new state of the PCCARD Memory Bank. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void FMC_PCCARDCmd(FunctionalState NewState) +{ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the PCCARD Bank by setting the PBKEN bit in the PCR4 register */ + FMC_Bank4->PCR4 |= PCR_PBKEN_SET; + } + else + { + /* Disable the PCCARD Bank by clearing the PBKEN bit in the PCR4 register */ + FMC_Bank4->PCR4 &= PCR_PBKEN_RESET; + } +} + +/** + * @} + */ + +/** @defgroup FMC_Group4 SDRAM Controller functions + * @brief SDRAM Controller functions + * +@verbatim + =============================================================================== + ##### SDRAM Controller functions ##### + =============================================================================== + + [..] The following sequence should be followed to configure the FMC to interface + with SDRAM memory connected to the SDRAM Bank 1 or SDRAM bank 2: + + (#) Enable the clock for the FMC and associated GPIOs using the following functions: + (++) RCC_AHB3PeriphClockCmd(RCC_AHB3Periph_FMC, ENABLE); + (++) RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOx, ENABLE); + + (#) FMC pins configuration + (++) Connect the involved FMC pins to AF12 using the following function + GPIO_PinAFConfig(GPIOx, GPIO_PinSourcex, GPIO_AF_FMC); + (++) Configure these FMC pins in alternate function mode by calling the function + GPIO_Init(); + + (#) Declare a FMC_SDRAMInitTypeDef structure, for example: + FMC_SDRAMInitTypeDef FMC_SDRAMInitStructure; + and fill the FMC_SDRAMInitStructure variable with the allowed values of + the structure member. + + (#) Initialize the SDRAM Controller by calling the function + FMC_SDRAMInit(&FMC_SDRAMInitStructure); + + (#) Declare a FMC_SDRAMCommandTypeDef structure, for example: + FMC_SDRAMCommandTypeDef FMC_SDRAMCommandStructure; + and fill the FMC_SDRAMCommandStructure variable with the allowed values of + the structure member. + + (#) Configure the SDCMR register with the desired command parameters by calling + the function FMC_SDRAMCmdConfig(&FMC_SDRAMCommandStructure); + + (#) At this stage, the SDRAM memory is ready for any valid command. + +@endverbatim + * @{ + */ + +/** + * @brief De-initializes the FMC SDRAM Banks registers to their default + * reset values. + * @param FMC_Bank: specifies the FMC Bank to be used + * This parameter can be one of the following values: + * @arg FMC_Bank1_SDRAM: FMC Bank1 SDRAM + * @arg FMC_Bank2_SDRAM: FMC Bank2 SDRAM + * @retval None + */ +void FMC_SDRAMDeInit(uint32_t FMC_Bank) +{ + /* Check the parameter */ + assert_param(IS_FMC_SDRAM_BANK(FMC_Bank)); + + FMC_Bank5_6->SDCR[FMC_Bank] = 0x000002D0; + FMC_Bank5_6->SDTR[FMC_Bank] = 0x0FFFFFFF; + FMC_Bank5_6->SDCMR = 0x00000000; + FMC_Bank5_6->SDRTR = 0x00000000; + FMC_Bank5_6->SDSR = 0x00000000; +} + +/** + * @brief Initializes the FMC SDRAM Banks according to the specified + * parameters in the FMC_SDRAMInitStruct. + * @param FMC_SDRAMInitStruct : pointer to a FMC_SDRAMInitTypeDef structure + * that contains the configuration information for the FMC SDRAM + * specified Banks. + * @retval None + */ +void FMC_SDRAMInit(FMC_SDRAMInitTypeDef* FMC_SDRAMInitStruct) +{ + /* temporary registers */ + uint32_t tmpr1 = 0; + uint32_t tmpr2 = 0; + uint32_t tmpr3 = 0; + uint32_t tmpr4 = 0; + + /* Check the parameters */ + + /* Control parameters */ + assert_param(IS_FMC_SDRAM_BANK(FMC_SDRAMInitStruct->FMC_Bank)); + assert_param(IS_FMC_COLUMNBITS_NUMBER(FMC_SDRAMInitStruct->FMC_ColumnBitsNumber)); + assert_param(IS_FMC_ROWBITS_NUMBER(FMC_SDRAMInitStruct->FMC_RowBitsNumber)); + assert_param(IS_FMC_SDMEMORY_WIDTH(FMC_SDRAMInitStruct->FMC_SDMemoryDataWidth)); + assert_param(IS_FMC_INTERNALBANK_NUMBER(FMC_SDRAMInitStruct->FMC_InternalBankNumber)); + assert_param(IS_FMC_CAS_LATENCY(FMC_SDRAMInitStruct->FMC_CASLatency)); + assert_param(IS_FMC_WRITE_PROTECTION(FMC_SDRAMInitStruct->FMC_WriteProtection)); + assert_param(IS_FMC_SDCLOCK_PERIOD(FMC_SDRAMInitStruct->FMC_SDClockPeriod)); + assert_param(IS_FMC_READ_BURST(FMC_SDRAMInitStruct->FMC_ReadBurst)); + assert_param(IS_FMC_READPIPE_DELAY(FMC_SDRAMInitStruct->FMC_ReadPipeDelay)); + + /* Timing parameters */ + assert_param(IS_FMC_LOADTOACTIVE_DELAY(FMC_SDRAMInitStruct->FMC_SDRAMTimingStruct->FMC_LoadToActiveDelay)); + assert_param(IS_FMC_EXITSELFREFRESH_DELAY(FMC_SDRAMInitStruct->FMC_SDRAMTimingStruct->FMC_ExitSelfRefreshDelay)); + assert_param(IS_FMC_SELFREFRESH_TIME(FMC_SDRAMInitStruct->FMC_SDRAMTimingStruct->FMC_SelfRefreshTime)); + assert_param(IS_FMC_ROWCYCLE_DELAY(FMC_SDRAMInitStruct->FMC_SDRAMTimingStruct->FMC_RowCycleDelay)); + assert_param(IS_FMC_WRITE_RECOVERY_TIME(FMC_SDRAMInitStruct->FMC_SDRAMTimingStruct->FMC_WriteRecoveryTime)); + assert_param(IS_FMC_RP_DELAY(FMC_SDRAMInitStruct->FMC_SDRAMTimingStruct->FMC_RPDelay)); + assert_param(IS_FMC_RCD_DELAY(FMC_SDRAMInitStruct->FMC_SDRAMTimingStruct->FMC_RCDDelay)); + + /* SDRAM bank control register configuration */ + tmpr1 = (uint32_t)FMC_SDRAMInitStruct->FMC_ColumnBitsNumber | + FMC_SDRAMInitStruct->FMC_RowBitsNumber | + FMC_SDRAMInitStruct->FMC_SDMemoryDataWidth | + FMC_SDRAMInitStruct->FMC_InternalBankNumber | + FMC_SDRAMInitStruct->FMC_CASLatency | + FMC_SDRAMInitStruct->FMC_WriteProtection | + FMC_SDRAMInitStruct->FMC_SDClockPeriod | + FMC_SDRAMInitStruct->FMC_ReadBurst | + FMC_SDRAMInitStruct->FMC_ReadPipeDelay; + + if(FMC_SDRAMInitStruct->FMC_Bank == FMC_Bank1_SDRAM ) + { + FMC_Bank5_6->SDCR[FMC_SDRAMInitStruct->FMC_Bank] = tmpr1; + } + else /* SDCR2 "don't care" bits configuration */ + { + tmpr3 = (uint32_t)FMC_SDRAMInitStruct->FMC_SDClockPeriod | + FMC_SDRAMInitStruct->FMC_ReadBurst | + FMC_SDRAMInitStruct->FMC_ReadPipeDelay; + + FMC_Bank5_6->SDCR[FMC_Bank1_SDRAM] = tmpr3; + FMC_Bank5_6->SDCR[FMC_SDRAMInitStruct->FMC_Bank] = tmpr1; + } + /* SDRAM bank timing register configuration */ + if(FMC_SDRAMInitStruct->FMC_Bank == FMC_Bank1_SDRAM ) + { + tmpr2 = (uint32_t)((FMC_SDRAMInitStruct->FMC_SDRAMTimingStruct->FMC_LoadToActiveDelay)-1) | + (((FMC_SDRAMInitStruct->FMC_SDRAMTimingStruct->FMC_ExitSelfRefreshDelay)-1) << 4) | + (((FMC_SDRAMInitStruct->FMC_SDRAMTimingStruct->FMC_SelfRefreshTime)-1) << 8) | + (((FMC_SDRAMInitStruct->FMC_SDRAMTimingStruct->FMC_RowCycleDelay)-1) << 12) | + (((FMC_SDRAMInitStruct->FMC_SDRAMTimingStruct->FMC_WriteRecoveryTime)-1) << 16) | + (((FMC_SDRAMInitStruct->FMC_SDRAMTimingStruct->FMC_RPDelay)-1) << 20) | + (((FMC_SDRAMInitStruct->FMC_SDRAMTimingStruct->FMC_RCDDelay)-1) << 24); + + FMC_Bank5_6->SDTR[FMC_SDRAMInitStruct->FMC_Bank] = tmpr2; + } + else /* SDTR "don't care bits configuration */ + { + tmpr2 = (uint32_t)((FMC_SDRAMInitStruct->FMC_SDRAMTimingStruct->FMC_LoadToActiveDelay)-1) | + (((FMC_SDRAMInitStruct->FMC_SDRAMTimingStruct->FMC_ExitSelfRefreshDelay)-1) << 4) | + (((FMC_SDRAMInitStruct->FMC_SDRAMTimingStruct->FMC_SelfRefreshTime)-1) << 8) | + (((FMC_SDRAMInitStruct->FMC_SDRAMTimingStruct->FMC_WriteRecoveryTime)-1) << 16); + + tmpr4 = (uint32_t)(((FMC_SDRAMInitStruct->FMC_SDRAMTimingStruct->FMC_RowCycleDelay)-1) << 12) | + (((FMC_SDRAMInitStruct->FMC_SDRAMTimingStruct->FMC_RPDelay)-1) << 20); + + FMC_Bank5_6->SDTR[FMC_Bank1_SDRAM] = tmpr4; + FMC_Bank5_6->SDTR[FMC_SDRAMInitStruct->FMC_Bank] = tmpr2; + } + +} + +/** + * @brief Fills each FMC_SDRAMInitStruct member with its default value. + * @param FMC_SDRAMInitStruct: pointer to a FMC_SDRAMInitTypeDef structure + * which will be initialized. + * @retval None + */ +void FMC_SDRAMStructInit(FMC_SDRAMInitTypeDef* FMC_SDRAMInitStruct) +{ + /* Reset SDRAM Init structure parameters values */ + FMC_SDRAMInitStruct->FMC_Bank = FMC_Bank1_SDRAM; + FMC_SDRAMInitStruct->FMC_ColumnBitsNumber = FMC_ColumnBits_Number_8b; + FMC_SDRAMInitStruct->FMC_RowBitsNumber = FMC_RowBits_Number_11b; + FMC_SDRAMInitStruct->FMC_SDMemoryDataWidth = FMC_SDMemory_Width_16b; + FMC_SDRAMInitStruct->FMC_InternalBankNumber = FMC_InternalBank_Number_4; + FMC_SDRAMInitStruct->FMC_CASLatency = FMC_CAS_Latency_1; + FMC_SDRAMInitStruct->FMC_WriteProtection = FMC_Write_Protection_Enable; + FMC_SDRAMInitStruct->FMC_SDClockPeriod = FMC_SDClock_Disable; + FMC_SDRAMInitStruct->FMC_ReadBurst = FMC_Read_Burst_Disable; + FMC_SDRAMInitStruct->FMC_ReadPipeDelay = FMC_ReadPipe_Delay_0; + + FMC_SDRAMInitStruct->FMC_SDRAMTimingStruct->FMC_LoadToActiveDelay = 16; + FMC_SDRAMInitStruct->FMC_SDRAMTimingStruct->FMC_ExitSelfRefreshDelay = 16; + FMC_SDRAMInitStruct->FMC_SDRAMTimingStruct->FMC_SelfRefreshTime = 16; + FMC_SDRAMInitStruct->FMC_SDRAMTimingStruct->FMC_RowCycleDelay = 16; + FMC_SDRAMInitStruct->FMC_SDRAMTimingStruct->FMC_WriteRecoveryTime = 16; + FMC_SDRAMInitStruct->FMC_SDRAMTimingStruct->FMC_RPDelay = 16; + FMC_SDRAMInitStruct->FMC_SDRAMTimingStruct->FMC_RCDDelay = 16; + +} + +/** + * @brief Configures the SDRAM memory command issued when the device is accessed. + * @param FMC_SDRAMCommandStruct: pointer to a FMC_SDRAMCommandTypeDef structure + * which will be configured. + * @retval None + */ +void FMC_SDRAMCmdConfig(FMC_SDRAMCommandTypeDef* FMC_SDRAMCommandStruct) +{ + uint32_t tmpr = 0x0; + + /* check parameters */ + assert_param(IS_FMC_COMMAND_MODE(FMC_SDRAMCommandStruct->FMC_CommandMode)); + assert_param(IS_FMC_COMMAND_TARGET(FMC_SDRAMCommandStruct->FMC_CommandTarget)); + assert_param(IS_FMC_AUTOREFRESH_NUMBER(FMC_SDRAMCommandStruct->FMC_AutoRefreshNumber)); + assert_param(IS_FMC_MODE_REGISTER(FMC_SDRAMCommandStruct->FMC_ModeRegisterDefinition)); + + tmpr = (uint32_t)(FMC_SDRAMCommandStruct->FMC_CommandMode | + FMC_SDRAMCommandStruct->FMC_CommandTarget | + (((FMC_SDRAMCommandStruct->FMC_AutoRefreshNumber)-1)<<5) | + ((FMC_SDRAMCommandStruct->FMC_ModeRegisterDefinition)<<9)); + + FMC_Bank5_6->SDCMR = tmpr; + +} + + +/** + * @brief Returns the indicated FMC SDRAM bank mode status. + * @param SDRAM_Bank: Defines the FMC SDRAM bank. This parameter can be + * FMC_Bank1_SDRAM or FMC_Bank2_SDRAM. + * @retval The FMC SDRAM bank mode status + */ +uint32_t FMC_GetModeStatus(uint32_t SDRAM_Bank) +{ + uint32_t tmpreg = 0; + + /* Check the parameter */ + assert_param(IS_FMC_SDRAM_BANK(SDRAM_Bank)); + + /* Get the busy flag status */ + if(SDRAM_Bank == FMC_Bank1_SDRAM) + { + tmpreg = (uint32_t)(FMC_Bank5_6->SDSR & FMC_SDSR_MODES1); + } + else + { + tmpreg = ((uint32_t)(FMC_Bank5_6->SDSR & FMC_SDSR_MODES2) >> 2); + } + + /* Return the mode status */ + return tmpreg; +} + +/** + * @brief defines the SDRAM Memory Refresh rate. + * @param FMC_Count: specifies the Refresh timer count. + * @retval None + */ +void FMC_SetRefreshCount(uint32_t FMC_Count) +{ + /* check the parameters */ + assert_param(IS_FMC_REFRESH_COUNT(FMC_Count)); + + FMC_Bank5_6->SDRTR |= (FMC_Count<<1); + +} + +/** + * @brief Sets the Number of consecutive SDRAM Memory auto Refresh commands. + * @param FMC_Number: specifies the auto Refresh number. + * @retval None + */ +void FMC_SetAutoRefresh_Number(uint32_t FMC_Number) +{ + /* check the parameters */ + assert_param(IS_FMC_AUTOREFRESH_NUMBER(FMC_Number)); + + FMC_Bank5_6->SDCMR |= (FMC_Number << 5); +} + +/** + * @brief Enables or disables write protection to the specified FMC SDRAM Bank. + * @param SDRAM_Bank: Defines the FMC SDRAM bank. This parameter can be + * FMC_Bank1_SDRAM or FMC_Bank2_SDRAM. + * @param NewState: new state of the write protection flag. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void FMC_SDRAMWriteProtectionConfig(uint32_t SDRAM_Bank, FunctionalState NewState) +{ + /* Check the parameter */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + assert_param(IS_FMC_SDRAM_BANK(SDRAM_Bank)); + + if (NewState != DISABLE) + { + FMC_Bank5_6->SDCR[SDRAM_Bank] |= FMC_Write_Protection_Enable; + } + else + { + FMC_Bank5_6->SDCR[SDRAM_Bank] &= SDCR_WriteProtection_RESET; + } + +} + +/** + * @} + */ + +/** @defgroup FMC_Group5 Interrupts and flags management functions + * @brief Interrupts and flags management functions + * +@verbatim + =============================================================================== + ##### Interrupts and flags management functions ##### + =============================================================================== + +@endverbatim + * @{ + */ + +/** + * @brief Enables or disables the specified FMC interrupts. + * @param FMC_Bank: specifies the FMC Bank to be used + * This parameter can be one of the following values: + * @arg FMC_Bank2_NAND: FMC Bank2 NAND + * @arg FMC_Bank3_NAND: FMC Bank3 NAND + * @arg FMC_Bank4_PCCARD: FMC Bank4 PCCARD + * @arg FMC_Bank1_SDRAM: FMC Bank1 SDRAM + * @arg FMC_Bank2_SDRAM: FMC Bank2 SDRAM + * @param FMC_IT: specifies the FMC interrupt sources to be enabled or disabled. + * This parameter can be any combination of the following values: + * @arg FMC_IT_RisingEdge: Rising edge detection interrupt. + * @arg FMC_IT_Level: Level edge detection interrupt. + * @arg FMC_IT_FallingEdge: Falling edge detection interrupt. + * @arg FMC_IT_Refresh: Refresh error detection interrupt. + * @param NewState: new state of the specified FMC interrupts. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void FMC_ITConfig(uint32_t FMC_Bank, uint32_t FMC_IT, FunctionalState NewState) +{ + assert_param(IS_FMC_IT_BANK(FMC_Bank)); + assert_param(IS_FMC_IT(FMC_IT)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the selected FMC_Bank2 interrupts */ + if(FMC_Bank == FMC_Bank2_NAND) + { + FMC_Bank2->SR2 |= FMC_IT; + } + /* Enable the selected FMC_Bank3 interrupts */ + else if (FMC_Bank == FMC_Bank3_NAND) + { + FMC_Bank3->SR3 |= FMC_IT; + } + /* Enable the selected FMC_Bank4 interrupts */ + else if (FMC_Bank == FMC_Bank4_PCCARD) + { + FMC_Bank4->SR4 |= FMC_IT; + } + /* Enable the selected FMC_Bank5_6 interrupt */ + else + { + /* Enables the interrupt if the refresh error flag is set */ + FMC_Bank5_6->SDRTR |= FMC_IT; + } + } + else + { + /* Disable the selected FMC_Bank2 interrupts */ + if(FMC_Bank == FMC_Bank2_NAND) + { + + FMC_Bank2->SR2 &= (uint32_t)~FMC_IT; + } + /* Disable the selected FMC_Bank3 interrupts */ + else if (FMC_Bank == FMC_Bank3_NAND) + { + FMC_Bank3->SR3 &= (uint32_t)~FMC_IT; + } + /* Disable the selected FMC_Bank4 interrupts */ + else if(FMC_Bank == FMC_Bank4_PCCARD) + { + FMC_Bank4->SR4 &= (uint32_t)~FMC_IT; + } + /* Disable the selected FMC_Bank5_6 interrupt */ + else + { + /* Disables the interrupt if the refresh error flag is not set */ + FMC_Bank5_6->SDRTR &= (uint32_t)~FMC_IT; + } + } +} + +/** + * @brief Checks whether the specified FMC flag is set or not. + * @param FMC_Bank: specifies the FMC Bank to be used + * This parameter can be one of the following values: + * @arg FMC_Bank2_NAND: FMC Bank2 NAND + * @arg FMC_Bank3_NAND: FMC Bank3 NAND + * @arg FMC_Bank4_PCCARD: FMC Bank4 PCCARD + * @arg FMC_Bank1_SDRAM: FMC Bank1 SDRAM + * @arg FMC_Bank2_SDRAM: FMC Bank2 SDRAM + * @arg FMC_Bank1_SDRAM | FMC_Bank2_SDRAM: FMC Bank1 or Bank2 SDRAM + * @param FMC_FLAG: specifies the flag to check. + * This parameter can be one of the following values: + * @arg FMC_FLAG_RisingEdge: Rising edge detection Flag. + * @arg FMC_FLAG_Level: Level detection Flag. + * @arg FMC_FLAG_FallingEdge: Falling edge detection Flag. + * @arg FMC_FLAG_FEMPT: Fifo empty Flag. + * @arg FMC_FLAG_Refresh: Refresh error Flag. + * @arg FMC_FLAG_Busy: Busy status Flag. + * @retval The new state of FMC_FLAG (SET or RESET). + */ +FlagStatus FMC_GetFlagStatus(uint32_t FMC_Bank, uint32_t FMC_FLAG) +{ + FlagStatus bitstatus = RESET; + uint32_t tmpsr = 0x00000000; + + /* Check the parameters */ + assert_param(IS_FMC_GETFLAG_BANK(FMC_Bank)); + assert_param(IS_FMC_GET_FLAG(FMC_FLAG)); + + if(FMC_Bank == FMC_Bank2_NAND) + { + tmpsr = FMC_Bank2->SR2; + } + else if(FMC_Bank == FMC_Bank3_NAND) + { + tmpsr = FMC_Bank3->SR3; + } + else if(FMC_Bank == FMC_Bank4_PCCARD) + { + tmpsr = FMC_Bank4->SR4; + } + else + { + tmpsr = FMC_Bank5_6->SDSR; + } + + /* Get the flag status */ + if ((tmpsr & FMC_FLAG) != FMC_FLAG ) + { + bitstatus = RESET; + } + else + { + bitstatus = SET; + } + /* Return the flag status */ + return bitstatus; +} + +/** + * @brief Clears the FMC's pending flags. + * @param FMC_Bank: specifies the FMC Bank to be used + * This parameter can be one of the following values: + * @arg FMC_Bank2_NAND: FMC Bank2 NAND + * @arg FMC_Bank3_NAND: FMC Bank3 NAND + * @arg FMC_Bank4_PCCARD: FMC Bank4 PCCARD + * @arg FMC_Bank1_SDRAM: FMC Bank1 SDRAM + * @arg FMC_Bank2_SDRAM: FMC Bank2 SDRAM + * @param FMC_FLAG: specifies the flag to clear. + * This parameter can be any combination of the following values: + * @arg FMC_FLAG_RisingEdge: Rising edge detection Flag. + * @arg FMC_FLAG_Level: Level detection Flag. + * @arg FMC_FLAG_FallingEdge: Falling edge detection Flag. + * @arg FMC_FLAG_Refresh: Refresh error Flag. + * @retval None + */ +void FMC_ClearFlag(uint32_t FMC_Bank, uint32_t FMC_FLAG) +{ + /* Check the parameters */ + assert_param(IS_FMC_GETFLAG_BANK(FMC_Bank)); + assert_param(IS_FMC_CLEAR_FLAG(FMC_FLAG)) ; + + if(FMC_Bank == FMC_Bank2_NAND) + { + FMC_Bank2->SR2 &= (~FMC_FLAG); + } + else if(FMC_Bank == FMC_Bank3_NAND) + { + FMC_Bank3->SR3 &= (~FMC_FLAG); + } + else if(FMC_Bank == FMC_Bank4_PCCARD) + { + FMC_Bank4->SR4 &= (~FMC_FLAG); + } + /* FMC_Bank5_6 SDRAM*/ + else + { + FMC_Bank5_6->SDRTR &= (~FMC_FLAG); + } + +} + +/** + * @brief Checks whether the specified FMC interrupt has occurred or not. + * @param FMC_Bank: specifies the FMC Bank to be used + * This parameter can be one of the following values: + * @arg FMC_Bank2_NAND: FMC Bank2 NAND + * @arg FMC_Bank3_NAND: FMC Bank3 NAND + * @arg FMC_Bank4_PCCARD: FMC Bank4 PCCARD + * @arg FMC_Bank1_SDRAM: FMC Bank1 SDRAM + * @arg FMC_Bank2_SDRAM: FMC Bank2 SDRAM + * @param FMC_IT: specifies the FMC interrupt source to check. + * This parameter can be one of the following values: + * @arg FMC_IT_RisingEdge: Rising edge detection interrupt. + * @arg FMC_IT_Level: Level edge detection interrupt. + * @arg FMC_IT_FallingEdge: Falling edge detection interrupt. + * @arg FMC_IT_Refresh: Refresh error detection interrupt. + * @retval The new state of FMC_IT (SET or RESET). + */ +ITStatus FMC_GetITStatus(uint32_t FMC_Bank, uint32_t FMC_IT) +{ + ITStatus bitstatus = RESET; + uint32_t tmpsr = 0x0; + uint32_t tmpsr2 = 0x0; + uint32_t itstatus = 0x0; + uint32_t itenable = 0x0; + + /* Check the parameters */ + assert_param(IS_FMC_IT_BANK(FMC_Bank)); + assert_param(IS_FMC_GET_IT(FMC_IT)); + + if(FMC_Bank == FMC_Bank2_NAND) + { + tmpsr = FMC_Bank2->SR2; + } + else if(FMC_Bank == FMC_Bank3_NAND) + { + tmpsr = FMC_Bank3->SR3; + } + else if(FMC_Bank == FMC_Bank4_PCCARD) + { + tmpsr = FMC_Bank4->SR4; + } + /* FMC_Bank5_6 SDRAM*/ + else + { + tmpsr = FMC_Bank5_6->SDRTR; + tmpsr2 = FMC_Bank5_6->SDSR; + } + + /* get the IT enable bit status*/ + itenable = tmpsr & FMC_IT; + + /* get the corresponding IT Flag status*/ + if((FMC_Bank == FMC_Bank1_SDRAM) || (FMC_Bank == FMC_Bank2_SDRAM)) + { + itstatus = tmpsr2 & FMC_SDSR_RE; + } + else + { + itstatus = tmpsr & (FMC_IT >> 3); + } + + if ((itstatus != (uint32_t)RESET) && (itenable != (uint32_t)RESET)) + { + bitstatus = SET; + } + else + { + bitstatus = RESET; + } + return bitstatus; +} + +/** + * @brief Clears the FMC's interrupt pending bits. + * @param FMC_Bank: specifies the FMC Bank to be used + * This parameter can be one of the following values: + * @arg FMC_Bank2_NAND: FMC Bank2 NAND + * @arg FMC_Bank3_NAND: FMC Bank3 NAND + * @arg FMC_Bank4_PCCARD: FMC Bank4 PCCARD + * @arg FMC_Bank1_SDRAM: FMC Bank1 SDRAM + * @arg FMC_Bank2_SDRAM: FMC Bank2 SDRAM + * @param FMC_IT: specifies the interrupt pending bit to clear. + * This parameter can be any combination of the following values: + * @arg FMC_IT_RisingEdge: Rising edge detection interrupt. + * @arg FMC_IT_Level: Level edge detection interrupt. + * @arg FMC_IT_FallingEdge: Falling edge detection interrupt. + * @arg FMC_IT_Refresh: Refresh error detection interrupt. + * @retval None + */ +void FMC_ClearITPendingBit(uint32_t FMC_Bank, uint32_t FMC_IT) +{ + /* Check the parameters */ + assert_param(IS_FMC_IT_BANK(FMC_Bank)); + assert_param(IS_FMC_IT(FMC_IT)); + + if(FMC_Bank == FMC_Bank2_NAND) + { + FMC_Bank2->SR2 &= ~(FMC_IT >> 3); + } + else if(FMC_Bank == FMC_Bank3_NAND) + { + FMC_Bank3->SR3 &= ~(FMC_IT >> 3); + } + else if(FMC_Bank == FMC_Bank4_PCCARD) + { + FMC_Bank4->SR4 &= ~(FMC_IT >> 3); + } + /* FMC_Bank5_6 SDRAM*/ + else + { + FMC_Bank5_6->SDRTR |= FMC_SDRTR_CRE; + } +} + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/src/stm32f4xx_fsmc.c b/FWLIB/src/stm32f4xx_fsmc.c new file mode 100644 index 0000000..38c23a5 --- /dev/null +++ b/FWLIB/src/stm32f4xx_fsmc.c @@ -0,0 +1,985 @@ +/** + ****************************************************************************** + * @file stm32f4xx_fsmc.c + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file provides firmware functions to manage the following + * functionalities of the FSMC peripheral: + * + Interface with SRAM, PSRAM, NOR and OneNAND memories + * + Interface with NAND memories + * + Interface with 16-bit PC Card compatible memories + * + Interrupts and flags management + * + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx_fsmc.h" +#include "stm32f4xx_rcc.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @defgroup FSMC + * @brief FSMC driver modules + * @{ + */ + +/* Private typedef -----------------------------------------------------------*/ +const FSMC_NORSRAMTimingInitTypeDef FSMC_DefaultTimingStruct = {0x0F, /* FSMC_AddressSetupTime */ + 0x0F, /* FSMC_AddressHoldTime */ + 0xFF, /* FSMC_DataSetupTime */ + 0x0F, /* FSMC_BusTurnAroundDuration */ + 0x0F, /* FSMC_CLKDivision */ + 0x0F, /* FSMC_DataLatency */ + FSMC_AccessMode_A /* FSMC_AccessMode */ + }; +/* Private define ------------------------------------------------------------*/ + +/* --------------------- FSMC registers bit mask ---------------------------- */ +/* FSMC BCRx Mask */ +#define BCR_MBKEN_SET ((uint32_t)0x00000001) +#define BCR_MBKEN_RESET ((uint32_t)0x000FFFFE) +#define BCR_FACCEN_SET ((uint32_t)0x00000040) + +/* FSMC PCRx Mask */ +#define PCR_PBKEN_SET ((uint32_t)0x00000004) +#define PCR_PBKEN_RESET ((uint32_t)0x000FFFFB) +#define PCR_ECCEN_SET ((uint32_t)0x00000040) +#define PCR_ECCEN_RESET ((uint32_t)0x000FFFBF) +#define PCR_MEMORYTYPE_NAND ((uint32_t)0x00000008) + +/* Private macro -------------------------------------------------------------*/ +/* Private variables ---------------------------------------------------------*/ +/* Private function prototypes -----------------------------------------------*/ +/* Private functions ---------------------------------------------------------*/ + +/** @defgroup FSMC_Private_Functions + * @{ + */ + +/** @defgroup FSMC_Group1 NOR/SRAM Controller functions + * @brief NOR/SRAM Controller functions + * +@verbatim + =============================================================================== + ##### NOR and SRAM Controller functions ##### + =============================================================================== + + [..] The following sequence should be followed to configure the FSMC to interface + with SRAM, PSRAM, NOR or OneNAND memory connected to the NOR/SRAM Bank: + + (#) Enable the clock for the FSMC and associated GPIOs using the following functions: + RCC_AHB3PeriphClockCmd(RCC_AHB3Periph_FSMC, ENABLE); + RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOx, ENABLE); + + (#) FSMC pins configuration + (++) Connect the involved FSMC pins to AF12 using the following function + GPIO_PinAFConfig(GPIOx, GPIO_PinSourcex, GPIO_AF_FSMC); + (++) Configure these FSMC pins in alternate function mode by calling the function + GPIO_Init(); + + (#) Declare a FSMC_NORSRAMInitTypeDef structure, for example: + FSMC_NORSRAMInitTypeDef FSMC_NORSRAMInitStructure; + and fill the FSMC_NORSRAMInitStructure variable with the allowed values of + the structure member. + + (#) Initialize the NOR/SRAM Controller by calling the function + FSMC_NORSRAMInit(&FSMC_NORSRAMInitStructure); + + (#) Then enable the NOR/SRAM Bank, for example: + FSMC_NORSRAMCmd(FSMC_Bank1_NORSRAM2, ENABLE); + + (#) At this stage you can read/write from/to the memory connected to the NOR/SRAM Bank. + +@endverbatim + * @{ + */ + +/** + * @brief De-initializes the FSMC NOR/SRAM Banks registers to their default + * reset values. + * @param FSMC_Bank: specifies the FSMC Bank to be used + * This parameter can be one of the following values: + * @arg FSMC_Bank1_NORSRAM1: FSMC Bank1 NOR/SRAM1 + * @arg FSMC_Bank1_NORSRAM2: FSMC Bank1 NOR/SRAM2 + * @arg FSMC_Bank1_NORSRAM3: FSMC Bank1 NOR/SRAM3 + * @arg FSMC_Bank1_NORSRAM4: FSMC Bank1 NOR/SRAM4 + * @retval None + */ +void FSMC_NORSRAMDeInit(uint32_t FSMC_Bank) +{ + /* Check the parameter */ + assert_param(IS_FSMC_NORSRAM_BANK(FSMC_Bank)); + + /* FSMC_Bank1_NORSRAM1 */ + if(FSMC_Bank == FSMC_Bank1_NORSRAM1) + { + FSMC_Bank1->BTCR[FSMC_Bank] = 0x000030DB; + } + /* FSMC_Bank1_NORSRAM2, FSMC_Bank1_NORSRAM3 or FSMC_Bank1_NORSRAM4 */ + else + { + FSMC_Bank1->BTCR[FSMC_Bank] = 0x000030D2; + } + FSMC_Bank1->BTCR[FSMC_Bank + 1] = 0x0FFFFFFF; + FSMC_Bank1E->BWTR[FSMC_Bank] = 0x0FFFFFFF; +} + +/** + * @brief Initializes the FSMC NOR/SRAM Banks according to the specified + * parameters in the FSMC_NORSRAMInitStruct. + * @param FSMC_NORSRAMInitStruct : pointer to a FSMC_NORSRAMInitTypeDef structure + * that contains the configuration information for the FSMC NOR/SRAM + * specified Banks. + * @retval None + */ +void FSMC_NORSRAMInit(FSMC_NORSRAMInitTypeDef* FSMC_NORSRAMInitStruct) +{ + /* Check the parameters */ + assert_param(IS_FSMC_NORSRAM_BANK(FSMC_NORSRAMInitStruct->FSMC_Bank)); + assert_param(IS_FSMC_MUX(FSMC_NORSRAMInitStruct->FSMC_DataAddressMux)); + assert_param(IS_FSMC_MEMORY(FSMC_NORSRAMInitStruct->FSMC_MemoryType)); + assert_param(IS_FSMC_MEMORY_WIDTH(FSMC_NORSRAMInitStruct->FSMC_MemoryDataWidth)); + assert_param(IS_FSMC_BURSTMODE(FSMC_NORSRAMInitStruct->FSMC_BurstAccessMode)); + assert_param(IS_FSMC_ASYNWAIT(FSMC_NORSRAMInitStruct->FSMC_AsynchronousWait)); + assert_param(IS_FSMC_WAIT_POLARITY(FSMC_NORSRAMInitStruct->FSMC_WaitSignalPolarity)); + assert_param(IS_FSMC_WRAP_MODE(FSMC_NORSRAMInitStruct->FSMC_WrapMode)); + assert_param(IS_FSMC_WAIT_SIGNAL_ACTIVE(FSMC_NORSRAMInitStruct->FSMC_WaitSignalActive)); + assert_param(IS_FSMC_WRITE_OPERATION(FSMC_NORSRAMInitStruct->FSMC_WriteOperation)); + assert_param(IS_FSMC_WAITE_SIGNAL(FSMC_NORSRAMInitStruct->FSMC_WaitSignal)); + assert_param(IS_FSMC_EXTENDED_MODE(FSMC_NORSRAMInitStruct->FSMC_ExtendedMode)); + assert_param(IS_FSMC_WRITE_BURST(FSMC_NORSRAMInitStruct->FSMC_WriteBurst)); + assert_param(IS_FSMC_ADDRESS_SETUP_TIME(FSMC_NORSRAMInitStruct->FSMC_ReadWriteTimingStruct->FSMC_AddressSetupTime)); + assert_param(IS_FSMC_ADDRESS_HOLD_TIME(FSMC_NORSRAMInitStruct->FSMC_ReadWriteTimingStruct->FSMC_AddressHoldTime)); + assert_param(IS_FSMC_DATASETUP_TIME(FSMC_NORSRAMInitStruct->FSMC_ReadWriteTimingStruct->FSMC_DataSetupTime)); + assert_param(IS_FSMC_TURNAROUND_TIME(FSMC_NORSRAMInitStruct->FSMC_ReadWriteTimingStruct->FSMC_BusTurnAroundDuration)); + assert_param(IS_FSMC_CLK_DIV(FSMC_NORSRAMInitStruct->FSMC_ReadWriteTimingStruct->FSMC_CLKDivision)); + assert_param(IS_FSMC_DATA_LATENCY(FSMC_NORSRAMInitStruct->FSMC_ReadWriteTimingStruct->FSMC_DataLatency)); + assert_param(IS_FSMC_ACCESS_MODE(FSMC_NORSRAMInitStruct->FSMC_ReadWriteTimingStruct->FSMC_AccessMode)); + + /* Bank1 NOR/SRAM control register configuration */ + FSMC_Bank1->BTCR[FSMC_NORSRAMInitStruct->FSMC_Bank] = + (uint32_t)FSMC_NORSRAMInitStruct->FSMC_DataAddressMux | + FSMC_NORSRAMInitStruct->FSMC_MemoryType | + FSMC_NORSRAMInitStruct->FSMC_MemoryDataWidth | + FSMC_NORSRAMInitStruct->FSMC_BurstAccessMode | + FSMC_NORSRAMInitStruct->FSMC_AsynchronousWait | + FSMC_NORSRAMInitStruct->FSMC_WaitSignalPolarity | + FSMC_NORSRAMInitStruct->FSMC_WrapMode | + FSMC_NORSRAMInitStruct->FSMC_WaitSignalActive | + FSMC_NORSRAMInitStruct->FSMC_WriteOperation | + FSMC_NORSRAMInitStruct->FSMC_WaitSignal | + FSMC_NORSRAMInitStruct->FSMC_ExtendedMode | + FSMC_NORSRAMInitStruct->FSMC_WriteBurst; + if(FSMC_NORSRAMInitStruct->FSMC_MemoryType == FSMC_MemoryType_NOR) + { + FSMC_Bank1->BTCR[FSMC_NORSRAMInitStruct->FSMC_Bank] |= (uint32_t)BCR_FACCEN_SET; + } + /* Bank1 NOR/SRAM timing register configuration */ + FSMC_Bank1->BTCR[FSMC_NORSRAMInitStruct->FSMC_Bank+1] = + (uint32_t)FSMC_NORSRAMInitStruct->FSMC_ReadWriteTimingStruct->FSMC_AddressSetupTime | + (FSMC_NORSRAMInitStruct->FSMC_ReadWriteTimingStruct->FSMC_AddressHoldTime << 4) | + (FSMC_NORSRAMInitStruct->FSMC_ReadWriteTimingStruct->FSMC_DataSetupTime << 8) | + (FSMC_NORSRAMInitStruct->FSMC_ReadWriteTimingStruct->FSMC_BusTurnAroundDuration << 16) | + (FSMC_NORSRAMInitStruct->FSMC_ReadWriteTimingStruct->FSMC_CLKDivision << 20) | + (FSMC_NORSRAMInitStruct->FSMC_ReadWriteTimingStruct->FSMC_DataLatency << 24) | + FSMC_NORSRAMInitStruct->FSMC_ReadWriteTimingStruct->FSMC_AccessMode; + + + /* Bank1 NOR/SRAM timing register for write configuration, if extended mode is used */ + if(FSMC_NORSRAMInitStruct->FSMC_ExtendedMode == FSMC_ExtendedMode_Enable) + { + assert_param(IS_FSMC_ADDRESS_SETUP_TIME(FSMC_NORSRAMInitStruct->FSMC_WriteTimingStruct->FSMC_AddressSetupTime)); + assert_param(IS_FSMC_ADDRESS_HOLD_TIME(FSMC_NORSRAMInitStruct->FSMC_WriteTimingStruct->FSMC_AddressHoldTime)); + assert_param(IS_FSMC_DATASETUP_TIME(FSMC_NORSRAMInitStruct->FSMC_WriteTimingStruct->FSMC_DataSetupTime)); + assert_param(IS_FSMC_CLK_DIV(FSMC_NORSRAMInitStruct->FSMC_WriteTimingStruct->FSMC_CLKDivision)); + assert_param(IS_FSMC_DATA_LATENCY(FSMC_NORSRAMInitStruct->FSMC_WriteTimingStruct->FSMC_DataLatency)); + assert_param(IS_FSMC_ACCESS_MODE(FSMC_NORSRAMInitStruct->FSMC_WriteTimingStruct->FSMC_AccessMode)); + FSMC_Bank1E->BWTR[FSMC_NORSRAMInitStruct->FSMC_Bank] = + (uint32_t)FSMC_NORSRAMInitStruct->FSMC_WriteTimingStruct->FSMC_AddressSetupTime | + (FSMC_NORSRAMInitStruct->FSMC_WriteTimingStruct->FSMC_AddressHoldTime << 4 )| + (FSMC_NORSRAMInitStruct->FSMC_WriteTimingStruct->FSMC_DataSetupTime << 8) | + (FSMC_NORSRAMInitStruct->FSMC_WriteTimingStruct->FSMC_CLKDivision << 20) | + (FSMC_NORSRAMInitStruct->FSMC_WriteTimingStruct->FSMC_DataLatency << 24) | + FSMC_NORSRAMInitStruct->FSMC_WriteTimingStruct->FSMC_AccessMode; + } + else + { + FSMC_Bank1E->BWTR[FSMC_NORSRAMInitStruct->FSMC_Bank] = 0x0FFFFFFF; + } +} + +/** + * @brief Fills each FSMC_NORSRAMInitStruct member with its default value. + * @param FSMC_NORSRAMInitStruct: pointer to a FSMC_NORSRAMInitTypeDef structure + * which will be initialized. + * @retval None + */ +void FSMC_NORSRAMStructInit(FSMC_NORSRAMInitTypeDef* FSMC_NORSRAMInitStruct) +{ + /* Reset NOR/SRAM Init structure parameters values */ + FSMC_NORSRAMInitStruct->FSMC_Bank = FSMC_Bank1_NORSRAM1; + FSMC_NORSRAMInitStruct->FSMC_DataAddressMux = FSMC_DataAddressMux_Enable; + FSMC_NORSRAMInitStruct->FSMC_MemoryType = FSMC_MemoryType_SRAM; + FSMC_NORSRAMInitStruct->FSMC_MemoryDataWidth = FSMC_MemoryDataWidth_8b; + FSMC_NORSRAMInitStruct->FSMC_BurstAccessMode = FSMC_BurstAccessMode_Disable; + FSMC_NORSRAMInitStruct->FSMC_AsynchronousWait = FSMC_AsynchronousWait_Disable; + FSMC_NORSRAMInitStruct->FSMC_WaitSignalPolarity = FSMC_WaitSignalPolarity_Low; + FSMC_NORSRAMInitStruct->FSMC_WrapMode = FSMC_WrapMode_Disable; + FSMC_NORSRAMInitStruct->FSMC_WaitSignalActive = FSMC_WaitSignalActive_BeforeWaitState; + FSMC_NORSRAMInitStruct->FSMC_WriteOperation = FSMC_WriteOperation_Enable; + FSMC_NORSRAMInitStruct->FSMC_WaitSignal = FSMC_WaitSignal_Enable; + FSMC_NORSRAMInitStruct->FSMC_ExtendedMode = FSMC_ExtendedMode_Disable; + FSMC_NORSRAMInitStruct->FSMC_WriteBurst = FSMC_WriteBurst_Disable; + FSMC_NORSRAMInitStruct->FSMC_ReadWriteTimingStruct = (FSMC_NORSRAMTimingInitTypeDef*)&FSMC_DefaultTimingStruct; + FSMC_NORSRAMInitStruct->FSMC_WriteTimingStruct = (FSMC_NORSRAMTimingInitTypeDef*)&FSMC_DefaultTimingStruct; +} + +/** + * @brief Enables or disables the specified NOR/SRAM Memory Bank. + * @param FSMC_Bank: specifies the FSMC Bank to be used + * This parameter can be one of the following values: + * @arg FSMC_Bank1_NORSRAM1: FSMC Bank1 NOR/SRAM1 + * @arg FSMC_Bank1_NORSRAM2: FSMC Bank1 NOR/SRAM2 + * @arg FSMC_Bank1_NORSRAM3: FSMC Bank1 NOR/SRAM3 + * @arg FSMC_Bank1_NORSRAM4: FSMC Bank1 NOR/SRAM4 + * @param NewState: new state of the FSMC_Bank. This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void FSMC_NORSRAMCmd(uint32_t FSMC_Bank, FunctionalState NewState) +{ + assert_param(IS_FSMC_NORSRAM_BANK(FSMC_Bank)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the selected NOR/SRAM Bank by setting the PBKEN bit in the BCRx register */ + FSMC_Bank1->BTCR[FSMC_Bank] |= BCR_MBKEN_SET; + } + else + { + /* Disable the selected NOR/SRAM Bank by clearing the PBKEN bit in the BCRx register */ + FSMC_Bank1->BTCR[FSMC_Bank] &= BCR_MBKEN_RESET; + } +} +/** + * @} + */ + +/** @defgroup FSMC_Group2 NAND Controller functions + * @brief NAND Controller functions + * +@verbatim + =============================================================================== + ##### NAND Controller functions ##### + =============================================================================== + + [..] The following sequence should be followed to configure the FSMC to interface + with 8-bit or 16-bit NAND memory connected to the NAND Bank: + + (#) Enable the clock for the FSMC and associated GPIOs using the following functions: + (++) RCC_AHB3PeriphClockCmd(RCC_AHB3Periph_FSMC, ENABLE); + (++) RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOx, ENABLE); + + (#) FSMC pins configuration + (++) Connect the involved FSMC pins to AF12 using the following function + GPIO_PinAFConfig(GPIOx, GPIO_PinSourcex, GPIO_AF_FSMC); + (++) Configure these FSMC pins in alternate function mode by calling the function + GPIO_Init(); + + (#) Declare a FSMC_NANDInitTypeDef structure, for example: + FSMC_NANDInitTypeDef FSMC_NANDInitStructure; + and fill the FSMC_NANDInitStructure variable with the allowed values of + the structure member. + + (#) Initialize the NAND Controller by calling the function + FSMC_NANDInit(&FSMC_NANDInitStructure); + + (#) Then enable the NAND Bank, for example: + FSMC_NANDCmd(FSMC_Bank3_NAND, ENABLE); + + (#) At this stage you can read/write from/to the memory connected to the NAND Bank. + + [..] + (@) To enable the Error Correction Code (ECC), you have to use the function + FSMC_NANDECCCmd(FSMC_Bank3_NAND, ENABLE); + [..] + (@) and to get the current ECC value you have to use the function + ECCval = FSMC_GetECC(FSMC_Bank3_NAND); + +@endverbatim + * @{ + */ + +/** + * @brief De-initializes the FSMC NAND Banks registers to their default reset values. + * @param FSMC_Bank: specifies the FSMC Bank to be used + * This parameter can be one of the following values: + * @arg FSMC_Bank2_NAND: FSMC Bank2 NAND + * @arg FSMC_Bank3_NAND: FSMC Bank3 NAND + * @retval None + */ +void FSMC_NANDDeInit(uint32_t FSMC_Bank) +{ + /* Check the parameter */ + assert_param(IS_FSMC_NAND_BANK(FSMC_Bank)); + + if(FSMC_Bank == FSMC_Bank2_NAND) + { + /* Set the FSMC_Bank2 registers to their reset values */ + FSMC_Bank2->PCR2 = 0x00000018; + FSMC_Bank2->SR2 = 0x00000040; + FSMC_Bank2->PMEM2 = 0xFCFCFCFC; + FSMC_Bank2->PATT2 = 0xFCFCFCFC; + } + /* FSMC_Bank3_NAND */ + else + { + /* Set the FSMC_Bank3 registers to their reset values */ + FSMC_Bank3->PCR3 = 0x00000018; + FSMC_Bank3->SR3 = 0x00000040; + FSMC_Bank3->PMEM3 = 0xFCFCFCFC; + FSMC_Bank3->PATT3 = 0xFCFCFCFC; + } +} + +/** + * @brief Initializes the FSMC NAND Banks according to the specified parameters + * in the FSMC_NANDInitStruct. + * @param FSMC_NANDInitStruct : pointer to a FSMC_NANDInitTypeDef structure that + * contains the configuration information for the FSMC NAND specified Banks. + * @retval None + */ +void FSMC_NANDInit(FSMC_NANDInitTypeDef* FSMC_NANDInitStruct) +{ + uint32_t tmppcr = 0x00000000, tmppmem = 0x00000000, tmppatt = 0x00000000; + + /* Check the parameters */ + assert_param( IS_FSMC_NAND_BANK(FSMC_NANDInitStruct->FSMC_Bank)); + assert_param( IS_FSMC_WAIT_FEATURE(FSMC_NANDInitStruct->FSMC_Waitfeature)); + assert_param( IS_FSMC_MEMORY_WIDTH(FSMC_NANDInitStruct->FSMC_MemoryDataWidth)); + assert_param( IS_FSMC_ECC_STATE(FSMC_NANDInitStruct->FSMC_ECC)); + assert_param( IS_FSMC_ECCPAGE_SIZE(FSMC_NANDInitStruct->FSMC_ECCPageSize)); + assert_param( IS_FSMC_TCLR_TIME(FSMC_NANDInitStruct->FSMC_TCLRSetupTime)); + assert_param( IS_FSMC_TAR_TIME(FSMC_NANDInitStruct->FSMC_TARSetupTime)); + assert_param(IS_FSMC_SETUP_TIME(FSMC_NANDInitStruct->FSMC_CommonSpaceTimingStruct->FSMC_SetupTime)); + assert_param(IS_FSMC_WAIT_TIME(FSMC_NANDInitStruct->FSMC_CommonSpaceTimingStruct->FSMC_WaitSetupTime)); + assert_param(IS_FSMC_HOLD_TIME(FSMC_NANDInitStruct->FSMC_CommonSpaceTimingStruct->FSMC_HoldSetupTime)); + assert_param(IS_FSMC_HIZ_TIME(FSMC_NANDInitStruct->FSMC_CommonSpaceTimingStruct->FSMC_HiZSetupTime)); + assert_param(IS_FSMC_SETUP_TIME(FSMC_NANDInitStruct->FSMC_AttributeSpaceTimingStruct->FSMC_SetupTime)); + assert_param(IS_FSMC_WAIT_TIME(FSMC_NANDInitStruct->FSMC_AttributeSpaceTimingStruct->FSMC_WaitSetupTime)); + assert_param(IS_FSMC_HOLD_TIME(FSMC_NANDInitStruct->FSMC_AttributeSpaceTimingStruct->FSMC_HoldSetupTime)); + assert_param(IS_FSMC_HIZ_TIME(FSMC_NANDInitStruct->FSMC_AttributeSpaceTimingStruct->FSMC_HiZSetupTime)); + + /* Set the tmppcr value according to FSMC_NANDInitStruct parameters */ + tmppcr = (uint32_t)FSMC_NANDInitStruct->FSMC_Waitfeature | + PCR_MEMORYTYPE_NAND | + FSMC_NANDInitStruct->FSMC_MemoryDataWidth | + FSMC_NANDInitStruct->FSMC_ECC | + FSMC_NANDInitStruct->FSMC_ECCPageSize | + (FSMC_NANDInitStruct->FSMC_TCLRSetupTime << 9 )| + (FSMC_NANDInitStruct->FSMC_TARSetupTime << 13); + + /* Set tmppmem value according to FSMC_CommonSpaceTimingStructure parameters */ + tmppmem = (uint32_t)FSMC_NANDInitStruct->FSMC_CommonSpaceTimingStruct->FSMC_SetupTime | + (FSMC_NANDInitStruct->FSMC_CommonSpaceTimingStruct->FSMC_WaitSetupTime << 8) | + (FSMC_NANDInitStruct->FSMC_CommonSpaceTimingStruct->FSMC_HoldSetupTime << 16)| + (FSMC_NANDInitStruct->FSMC_CommonSpaceTimingStruct->FSMC_HiZSetupTime << 24); + + /* Set tmppatt value according to FSMC_AttributeSpaceTimingStructure parameters */ + tmppatt = (uint32_t)FSMC_NANDInitStruct->FSMC_AttributeSpaceTimingStruct->FSMC_SetupTime | + (FSMC_NANDInitStruct->FSMC_AttributeSpaceTimingStruct->FSMC_WaitSetupTime << 8) | + (FSMC_NANDInitStruct->FSMC_AttributeSpaceTimingStruct->FSMC_HoldSetupTime << 16)| + (FSMC_NANDInitStruct->FSMC_AttributeSpaceTimingStruct->FSMC_HiZSetupTime << 24); + + if(FSMC_NANDInitStruct->FSMC_Bank == FSMC_Bank2_NAND) + { + /* FSMC_Bank2_NAND registers configuration */ + FSMC_Bank2->PCR2 = tmppcr; + FSMC_Bank2->PMEM2 = tmppmem; + FSMC_Bank2->PATT2 = tmppatt; + } + else + { + /* FSMC_Bank3_NAND registers configuration */ + FSMC_Bank3->PCR3 = tmppcr; + FSMC_Bank3->PMEM3 = tmppmem; + FSMC_Bank3->PATT3 = tmppatt; + } +} + + +/** + * @brief Fills each FSMC_NANDInitStruct member with its default value. + * @param FSMC_NANDInitStruct: pointer to a FSMC_NANDInitTypeDef structure which + * will be initialized. + * @retval None + */ +void FSMC_NANDStructInit(FSMC_NANDInitTypeDef* FSMC_NANDInitStruct) +{ + /* Reset NAND Init structure parameters values */ + FSMC_NANDInitStruct->FSMC_Bank = FSMC_Bank2_NAND; + FSMC_NANDInitStruct->FSMC_Waitfeature = FSMC_Waitfeature_Disable; + FSMC_NANDInitStruct->FSMC_MemoryDataWidth = FSMC_MemoryDataWidth_8b; + FSMC_NANDInitStruct->FSMC_ECC = FSMC_ECC_Disable; + FSMC_NANDInitStruct->FSMC_ECCPageSize = FSMC_ECCPageSize_256Bytes; + FSMC_NANDInitStruct->FSMC_TCLRSetupTime = 0x0; + FSMC_NANDInitStruct->FSMC_TARSetupTime = 0x0; + FSMC_NANDInitStruct->FSMC_CommonSpaceTimingStruct->FSMC_SetupTime = 0xFC; + FSMC_NANDInitStruct->FSMC_CommonSpaceTimingStruct->FSMC_WaitSetupTime = 0xFC; + FSMC_NANDInitStruct->FSMC_CommonSpaceTimingStruct->FSMC_HoldSetupTime = 0xFC; + FSMC_NANDInitStruct->FSMC_CommonSpaceTimingStruct->FSMC_HiZSetupTime = 0xFC; + FSMC_NANDInitStruct->FSMC_AttributeSpaceTimingStruct->FSMC_SetupTime = 0xFC; + FSMC_NANDInitStruct->FSMC_AttributeSpaceTimingStruct->FSMC_WaitSetupTime = 0xFC; + FSMC_NANDInitStruct->FSMC_AttributeSpaceTimingStruct->FSMC_HoldSetupTime = 0xFC; + FSMC_NANDInitStruct->FSMC_AttributeSpaceTimingStruct->FSMC_HiZSetupTime = 0xFC; +} + +/** + * @brief Enables or disables the specified NAND Memory Bank. + * @param FSMC_Bank: specifies the FSMC Bank to be used + * This parameter can be one of the following values: + * @arg FSMC_Bank2_NAND: FSMC Bank2 NAND + * @arg FSMC_Bank3_NAND: FSMC Bank3 NAND + * @param NewState: new state of the FSMC_Bank. This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void FSMC_NANDCmd(uint32_t FSMC_Bank, FunctionalState NewState) +{ + assert_param(IS_FSMC_NAND_BANK(FSMC_Bank)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the selected NAND Bank by setting the PBKEN bit in the PCRx register */ + if(FSMC_Bank == FSMC_Bank2_NAND) + { + FSMC_Bank2->PCR2 |= PCR_PBKEN_SET; + } + else + { + FSMC_Bank3->PCR3 |= PCR_PBKEN_SET; + } + } + else + { + /* Disable the selected NAND Bank by clearing the PBKEN bit in the PCRx register */ + if(FSMC_Bank == FSMC_Bank2_NAND) + { + FSMC_Bank2->PCR2 &= PCR_PBKEN_RESET; + } + else + { + FSMC_Bank3->PCR3 &= PCR_PBKEN_RESET; + } + } +} +/** + * @brief Enables or disables the FSMC NAND ECC feature. + * @param FSMC_Bank: specifies the FSMC Bank to be used + * This parameter can be one of the following values: + * @arg FSMC_Bank2_NAND: FSMC Bank2 NAND + * @arg FSMC_Bank3_NAND: FSMC Bank3 NAND + * @param NewState: new state of the FSMC NAND ECC feature. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void FSMC_NANDECCCmd(uint32_t FSMC_Bank, FunctionalState NewState) +{ + assert_param(IS_FSMC_NAND_BANK(FSMC_Bank)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the selected NAND Bank ECC function by setting the ECCEN bit in the PCRx register */ + if(FSMC_Bank == FSMC_Bank2_NAND) + { + FSMC_Bank2->PCR2 |= PCR_ECCEN_SET; + } + else + { + FSMC_Bank3->PCR3 |= PCR_ECCEN_SET; + } + } + else + { + /* Disable the selected NAND Bank ECC function by clearing the ECCEN bit in the PCRx register */ + if(FSMC_Bank == FSMC_Bank2_NAND) + { + FSMC_Bank2->PCR2 &= PCR_ECCEN_RESET; + } + else + { + FSMC_Bank3->PCR3 &= PCR_ECCEN_RESET; + } + } +} + +/** + * @brief Returns the error correction code register value. + * @param FSMC_Bank: specifies the FSMC Bank to be used + * This parameter can be one of the following values: + * @arg FSMC_Bank2_NAND: FSMC Bank2 NAND + * @arg FSMC_Bank3_NAND: FSMC Bank3 NAND + * @retval The Error Correction Code (ECC) value. + */ +uint32_t FSMC_GetECC(uint32_t FSMC_Bank) +{ + uint32_t eccval = 0x00000000; + + if(FSMC_Bank == FSMC_Bank2_NAND) + { + /* Get the ECCR2 register value */ + eccval = FSMC_Bank2->ECCR2; + } + else + { + /* Get the ECCR3 register value */ + eccval = FSMC_Bank3->ECCR3; + } + /* Return the error correction code value */ + return(eccval); +} +/** + * @} + */ + +/** @defgroup FSMC_Group3 PCCARD Controller functions + * @brief PCCARD Controller functions + * +@verbatim + =============================================================================== + ##### PCCARD Controller functions ##### + =============================================================================== + + [..] he following sequence should be followed to configure the FSMC to interface + with 16-bit PC Card compatible memory connected to the PCCARD Bank: + + (#) Enable the clock for the FSMC and associated GPIOs using the following functions: + (++) RCC_AHB3PeriphClockCmd(RCC_AHB3Periph_FSMC, ENABLE); + (++) RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOx, ENABLE); + + (#) FSMC pins configuration + (++) Connect the involved FSMC pins to AF12 using the following function + GPIO_PinAFConfig(GPIOx, GPIO_PinSourcex, GPIO_AF_FSMC); + (++) Configure these FSMC pins in alternate function mode by calling the function + GPIO_Init(); + + (#) Declare a FSMC_PCCARDInitTypeDef structure, for example: + FSMC_PCCARDInitTypeDef FSMC_PCCARDInitStructure; + and fill the FSMC_PCCARDInitStructure variable with the allowed values of + the structure member. + + (#) Initialize the PCCARD Controller by calling the function + FSMC_PCCARDInit(&FSMC_PCCARDInitStructure); + + (#) Then enable the PCCARD Bank: + FSMC_PCCARDCmd(ENABLE); + + (#) At this stage you can read/write from/to the memory connected to the PCCARD Bank. + +@endverbatim + * @{ + */ + +/** + * @brief De-initializes the FSMC PCCARD Bank registers to their default reset values. + * @param None + * @retval None + */ +void FSMC_PCCARDDeInit(void) +{ + /* Set the FSMC_Bank4 registers to their reset values */ + FSMC_Bank4->PCR4 = 0x00000018; + FSMC_Bank4->SR4 = 0x00000000; + FSMC_Bank4->PMEM4 = 0xFCFCFCFC; + FSMC_Bank4->PATT4 = 0xFCFCFCFC; + FSMC_Bank4->PIO4 = 0xFCFCFCFC; +} + +/** + * @brief Initializes the FSMC PCCARD Bank according to the specified parameters + * in the FSMC_PCCARDInitStruct. + * @param FSMC_PCCARDInitStruct : pointer to a FSMC_PCCARDInitTypeDef structure + * that contains the configuration information for the FSMC PCCARD Bank. + * @retval None + */ +void FSMC_PCCARDInit(FSMC_PCCARDInitTypeDef* FSMC_PCCARDInitStruct) +{ + /* Check the parameters */ + assert_param(IS_FSMC_WAIT_FEATURE(FSMC_PCCARDInitStruct->FSMC_Waitfeature)); + assert_param(IS_FSMC_TCLR_TIME(FSMC_PCCARDInitStruct->FSMC_TCLRSetupTime)); + assert_param(IS_FSMC_TAR_TIME(FSMC_PCCARDInitStruct->FSMC_TARSetupTime)); + + assert_param(IS_FSMC_SETUP_TIME(FSMC_PCCARDInitStruct->FSMC_CommonSpaceTimingStruct->FSMC_SetupTime)); + assert_param(IS_FSMC_WAIT_TIME(FSMC_PCCARDInitStruct->FSMC_CommonSpaceTimingStruct->FSMC_WaitSetupTime)); + assert_param(IS_FSMC_HOLD_TIME(FSMC_PCCARDInitStruct->FSMC_CommonSpaceTimingStruct->FSMC_HoldSetupTime)); + assert_param(IS_FSMC_HIZ_TIME(FSMC_PCCARDInitStruct->FSMC_CommonSpaceTimingStruct->FSMC_HiZSetupTime)); + + assert_param(IS_FSMC_SETUP_TIME(FSMC_PCCARDInitStruct->FSMC_AttributeSpaceTimingStruct->FSMC_SetupTime)); + assert_param(IS_FSMC_WAIT_TIME(FSMC_PCCARDInitStruct->FSMC_AttributeSpaceTimingStruct->FSMC_WaitSetupTime)); + assert_param(IS_FSMC_HOLD_TIME(FSMC_PCCARDInitStruct->FSMC_AttributeSpaceTimingStruct->FSMC_HoldSetupTime)); + assert_param(IS_FSMC_HIZ_TIME(FSMC_PCCARDInitStruct->FSMC_AttributeSpaceTimingStruct->FSMC_HiZSetupTime)); + assert_param(IS_FSMC_SETUP_TIME(FSMC_PCCARDInitStruct->FSMC_IOSpaceTimingStruct->FSMC_SetupTime)); + assert_param(IS_FSMC_WAIT_TIME(FSMC_PCCARDInitStruct->FSMC_IOSpaceTimingStruct->FSMC_WaitSetupTime)); + assert_param(IS_FSMC_HOLD_TIME(FSMC_PCCARDInitStruct->FSMC_IOSpaceTimingStruct->FSMC_HoldSetupTime)); + assert_param(IS_FSMC_HIZ_TIME(FSMC_PCCARDInitStruct->FSMC_IOSpaceTimingStruct->FSMC_HiZSetupTime)); + + /* Set the PCR4 register value according to FSMC_PCCARDInitStruct parameters */ + FSMC_Bank4->PCR4 = (uint32_t)FSMC_PCCARDInitStruct->FSMC_Waitfeature | + FSMC_MemoryDataWidth_16b | + (FSMC_PCCARDInitStruct->FSMC_TCLRSetupTime << 9) | + (FSMC_PCCARDInitStruct->FSMC_TARSetupTime << 13); + + /* Set PMEM4 register value according to FSMC_CommonSpaceTimingStructure parameters */ + FSMC_Bank4->PMEM4 = (uint32_t)FSMC_PCCARDInitStruct->FSMC_CommonSpaceTimingStruct->FSMC_SetupTime | + (FSMC_PCCARDInitStruct->FSMC_CommonSpaceTimingStruct->FSMC_WaitSetupTime << 8) | + (FSMC_PCCARDInitStruct->FSMC_CommonSpaceTimingStruct->FSMC_HoldSetupTime << 16)| + (FSMC_PCCARDInitStruct->FSMC_CommonSpaceTimingStruct->FSMC_HiZSetupTime << 24); + + /* Set PATT4 register value according to FSMC_AttributeSpaceTimingStructure parameters */ + FSMC_Bank4->PATT4 = (uint32_t)FSMC_PCCARDInitStruct->FSMC_AttributeSpaceTimingStruct->FSMC_SetupTime | + (FSMC_PCCARDInitStruct->FSMC_AttributeSpaceTimingStruct->FSMC_WaitSetupTime << 8) | + (FSMC_PCCARDInitStruct->FSMC_AttributeSpaceTimingStruct->FSMC_HoldSetupTime << 16)| + (FSMC_PCCARDInitStruct->FSMC_AttributeSpaceTimingStruct->FSMC_HiZSetupTime << 24); + + /* Set PIO4 register value according to FSMC_IOSpaceTimingStructure parameters */ + FSMC_Bank4->PIO4 = (uint32_t)FSMC_PCCARDInitStruct->FSMC_IOSpaceTimingStruct->FSMC_SetupTime | + (FSMC_PCCARDInitStruct->FSMC_IOSpaceTimingStruct->FSMC_WaitSetupTime << 8) | + (FSMC_PCCARDInitStruct->FSMC_IOSpaceTimingStruct->FSMC_HoldSetupTime << 16)| + (FSMC_PCCARDInitStruct->FSMC_IOSpaceTimingStruct->FSMC_HiZSetupTime << 24); +} + +/** + * @brief Fills each FSMC_PCCARDInitStruct member with its default value. + * @param FSMC_PCCARDInitStruct: pointer to a FSMC_PCCARDInitTypeDef structure + * which will be initialized. + * @retval None + */ +void FSMC_PCCARDStructInit(FSMC_PCCARDInitTypeDef* FSMC_PCCARDInitStruct) +{ + /* Reset PCCARD Init structure parameters values */ + FSMC_PCCARDInitStruct->FSMC_Waitfeature = FSMC_Waitfeature_Disable; + FSMC_PCCARDInitStruct->FSMC_TCLRSetupTime = 0x0; + FSMC_PCCARDInitStruct->FSMC_TARSetupTime = 0x0; + FSMC_PCCARDInitStruct->FSMC_CommonSpaceTimingStruct->FSMC_SetupTime = 0xFC; + FSMC_PCCARDInitStruct->FSMC_CommonSpaceTimingStruct->FSMC_WaitSetupTime = 0xFC; + FSMC_PCCARDInitStruct->FSMC_CommonSpaceTimingStruct->FSMC_HoldSetupTime = 0xFC; + FSMC_PCCARDInitStruct->FSMC_CommonSpaceTimingStruct->FSMC_HiZSetupTime = 0xFC; + FSMC_PCCARDInitStruct->FSMC_AttributeSpaceTimingStruct->FSMC_SetupTime = 0xFC; + FSMC_PCCARDInitStruct->FSMC_AttributeSpaceTimingStruct->FSMC_WaitSetupTime = 0xFC; + FSMC_PCCARDInitStruct->FSMC_AttributeSpaceTimingStruct->FSMC_HoldSetupTime = 0xFC; + FSMC_PCCARDInitStruct->FSMC_AttributeSpaceTimingStruct->FSMC_HiZSetupTime = 0xFC; + FSMC_PCCARDInitStruct->FSMC_IOSpaceTimingStruct->FSMC_SetupTime = 0xFC; + FSMC_PCCARDInitStruct->FSMC_IOSpaceTimingStruct->FSMC_WaitSetupTime = 0xFC; + FSMC_PCCARDInitStruct->FSMC_IOSpaceTimingStruct->FSMC_HoldSetupTime = 0xFC; + FSMC_PCCARDInitStruct->FSMC_IOSpaceTimingStruct->FSMC_HiZSetupTime = 0xFC; +} + +/** + * @brief Enables or disables the PCCARD Memory Bank. + * @param NewState: new state of the PCCARD Memory Bank. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void FSMC_PCCARDCmd(FunctionalState NewState) +{ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the PCCARD Bank by setting the PBKEN bit in the PCR4 register */ + FSMC_Bank4->PCR4 |= PCR_PBKEN_SET; + } + else + { + /* Disable the PCCARD Bank by clearing the PBKEN bit in the PCR4 register */ + FSMC_Bank4->PCR4 &= PCR_PBKEN_RESET; + } +} +/** + * @} + */ + +/** @defgroup FSMC_Group4 Interrupts and flags management functions + * @brief Interrupts and flags management functions + * +@verbatim + =============================================================================== + ##### Interrupts and flags management functions ##### + =============================================================================== + +@endverbatim + * @{ + */ + +/** + * @brief Enables or disables the specified FSMC interrupts. + * @param FSMC_Bank: specifies the FSMC Bank to be used + * This parameter can be one of the following values: + * @arg FSMC_Bank2_NAND: FSMC Bank2 NAND + * @arg FSMC_Bank3_NAND: FSMC Bank3 NAND + * @arg FSMC_Bank4_PCCARD: FSMC Bank4 PCCARD + * @param FSMC_IT: specifies the FSMC interrupt sources to be enabled or disabled. + * This parameter can be any combination of the following values: + * @arg FSMC_IT_RisingEdge: Rising edge detection interrupt. + * @arg FSMC_IT_Level: Level edge detection interrupt. + * @arg FSMC_IT_FallingEdge: Falling edge detection interrupt. + * @param NewState: new state of the specified FSMC interrupts. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void FSMC_ITConfig(uint32_t FSMC_Bank, uint32_t FSMC_IT, FunctionalState NewState) +{ + assert_param(IS_FSMC_IT_BANK(FSMC_Bank)); + assert_param(IS_FSMC_IT(FSMC_IT)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the selected FSMC_Bank2 interrupts */ + if(FSMC_Bank == FSMC_Bank2_NAND) + { + FSMC_Bank2->SR2 |= FSMC_IT; + } + /* Enable the selected FSMC_Bank3 interrupts */ + else if (FSMC_Bank == FSMC_Bank3_NAND) + { + FSMC_Bank3->SR3 |= FSMC_IT; + } + /* Enable the selected FSMC_Bank4 interrupts */ + else + { + FSMC_Bank4->SR4 |= FSMC_IT; + } + } + else + { + /* Disable the selected FSMC_Bank2 interrupts */ + if(FSMC_Bank == FSMC_Bank2_NAND) + { + + FSMC_Bank2->SR2 &= (uint32_t)~FSMC_IT; + } + /* Disable the selected FSMC_Bank3 interrupts */ + else if (FSMC_Bank == FSMC_Bank3_NAND) + { + FSMC_Bank3->SR3 &= (uint32_t)~FSMC_IT; + } + /* Disable the selected FSMC_Bank4 interrupts */ + else + { + FSMC_Bank4->SR4 &= (uint32_t)~FSMC_IT; + } + } +} + +/** + * @brief Checks whether the specified FSMC flag is set or not. + * @param FSMC_Bank: specifies the FSMC Bank to be used + * This parameter can be one of the following values: + * @arg FSMC_Bank2_NAND: FSMC Bank2 NAND + * @arg FSMC_Bank3_NAND: FSMC Bank3 NAND + * @arg FSMC_Bank4_PCCARD: FSMC Bank4 PCCARD + * @param FSMC_FLAG: specifies the flag to check. + * This parameter can be one of the following values: + * @arg FSMC_FLAG_RisingEdge: Rising edge detection Flag. + * @arg FSMC_FLAG_Level: Level detection Flag. + * @arg FSMC_FLAG_FallingEdge: Falling edge detection Flag. + * @arg FSMC_FLAG_FEMPT: Fifo empty Flag. + * @retval The new state of FSMC_FLAG (SET or RESET). + */ +FlagStatus FSMC_GetFlagStatus(uint32_t FSMC_Bank, uint32_t FSMC_FLAG) +{ + FlagStatus bitstatus = RESET; + uint32_t tmpsr = 0x00000000; + + /* Check the parameters */ + assert_param(IS_FSMC_GETFLAG_BANK(FSMC_Bank)); + assert_param(IS_FSMC_GET_FLAG(FSMC_FLAG)); + + if(FSMC_Bank == FSMC_Bank2_NAND) + { + tmpsr = FSMC_Bank2->SR2; + } + else if(FSMC_Bank == FSMC_Bank3_NAND) + { + tmpsr = FSMC_Bank3->SR3; + } + /* FSMC_Bank4_PCCARD*/ + else + { + tmpsr = FSMC_Bank4->SR4; + } + + /* Get the flag status */ + if ((tmpsr & FSMC_FLAG) != (uint16_t)RESET ) + { + bitstatus = SET; + } + else + { + bitstatus = RESET; + } + /* Return the flag status */ + return bitstatus; +} + +/** + * @brief Clears the FSMC's pending flags. + * @param FSMC_Bank: specifies the FSMC Bank to be used + * This parameter can be one of the following values: + * @arg FSMC_Bank2_NAND: FSMC Bank2 NAND + * @arg FSMC_Bank3_NAND: FSMC Bank3 NAND + * @arg FSMC_Bank4_PCCARD: FSMC Bank4 PCCARD + * @param FSMC_FLAG: specifies the flag to clear. + * This parameter can be any combination of the following values: + * @arg FSMC_FLAG_RisingEdge: Rising edge detection Flag. + * @arg FSMC_FLAG_Level: Level detection Flag. + * @arg FSMC_FLAG_FallingEdge: Falling edge detection Flag. + * @retval None + */ +void FSMC_ClearFlag(uint32_t FSMC_Bank, uint32_t FSMC_FLAG) +{ + /* Check the parameters */ + assert_param(IS_FSMC_GETFLAG_BANK(FSMC_Bank)); + assert_param(IS_FSMC_CLEAR_FLAG(FSMC_FLAG)) ; + + if(FSMC_Bank == FSMC_Bank2_NAND) + { + FSMC_Bank2->SR2 &= ~FSMC_FLAG; + } + else if(FSMC_Bank == FSMC_Bank3_NAND) + { + FSMC_Bank3->SR3 &= ~FSMC_FLAG; + } + /* FSMC_Bank4_PCCARD*/ + else + { + FSMC_Bank4->SR4 &= ~FSMC_FLAG; + } +} + +/** + * @brief Checks whether the specified FSMC interrupt has occurred or not. + * @param FSMC_Bank: specifies the FSMC Bank to be used + * This parameter can be one of the following values: + * @arg FSMC_Bank2_NAND: FSMC Bank2 NAND + * @arg FSMC_Bank3_NAND: FSMC Bank3 NAND + * @arg FSMC_Bank4_PCCARD: FSMC Bank4 PCCARD + * @param FSMC_IT: specifies the FSMC interrupt source to check. + * This parameter can be one of the following values: + * @arg FSMC_IT_RisingEdge: Rising edge detection interrupt. + * @arg FSMC_IT_Level: Level edge detection interrupt. + * @arg FSMC_IT_FallingEdge: Falling edge detection interrupt. + * @retval The new state of FSMC_IT (SET or RESET). + */ +ITStatus FSMC_GetITStatus(uint32_t FSMC_Bank, uint32_t FSMC_IT) +{ + ITStatus bitstatus = RESET; + uint32_t tmpsr = 0x0, itstatus = 0x0, itenable = 0x0; + + /* Check the parameters */ + assert_param(IS_FSMC_IT_BANK(FSMC_Bank)); + assert_param(IS_FSMC_GET_IT(FSMC_IT)); + + if(FSMC_Bank == FSMC_Bank2_NAND) + { + tmpsr = FSMC_Bank2->SR2; + } + else if(FSMC_Bank == FSMC_Bank3_NAND) + { + tmpsr = FSMC_Bank3->SR3; + } + /* FSMC_Bank4_PCCARD*/ + else + { + tmpsr = FSMC_Bank4->SR4; + } + + itstatus = tmpsr & FSMC_IT; + + itenable = tmpsr & (FSMC_IT >> 3); + if ((itstatus != (uint32_t)RESET) && (itenable != (uint32_t)RESET)) + { + bitstatus = SET; + } + else + { + bitstatus = RESET; + } + return bitstatus; +} + +/** + * @brief Clears the FSMC's interrupt pending bits. + * @param FSMC_Bank: specifies the FSMC Bank to be used + * This parameter can be one of the following values: + * @arg FSMC_Bank2_NAND: FSMC Bank2 NAND + * @arg FSMC_Bank3_NAND: FSMC Bank3 NAND + * @arg FSMC_Bank4_PCCARD: FSMC Bank4 PCCARD + * @param FSMC_IT: specifies the interrupt pending bit to clear. + * This parameter can be any combination of the following values: + * @arg FSMC_IT_RisingEdge: Rising edge detection interrupt. + * @arg FSMC_IT_Level: Level edge detection interrupt. + * @arg FSMC_IT_FallingEdge: Falling edge detection interrupt. + * @retval None + */ +void FSMC_ClearITPendingBit(uint32_t FSMC_Bank, uint32_t FSMC_IT) +{ + /* Check the parameters */ + assert_param(IS_FSMC_IT_BANK(FSMC_Bank)); + assert_param(IS_FSMC_IT(FSMC_IT)); + + if(FSMC_Bank == FSMC_Bank2_NAND) + { + FSMC_Bank2->SR2 &= ~(FSMC_IT >> 3); + } + else if(FSMC_Bank == FSMC_Bank3_NAND) + { + FSMC_Bank3->SR3 &= ~(FSMC_IT >> 3); + } + /* FSMC_Bank4_PCCARD*/ + else + { + FSMC_Bank4->SR4 &= ~(FSMC_IT >> 3); + } +} + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/src/stm32f4xx_gpio.c b/FWLIB/src/stm32f4xx_gpio.c new file mode 100644 index 0000000..0523e50 --- /dev/null +++ b/FWLIB/src/stm32f4xx_gpio.c @@ -0,0 +1,611 @@ +/** + ****************************************************************************** + * @file stm32f4xx_gpio.c + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file provides firmware functions to manage the following + * functionalities of the GPIO peripheral: + * + Initialization and Configuration + * + GPIO Read and Write + * + GPIO Alternate functions configuration + * +@verbatim + =============================================================================== + ##### How to use this driver ##### + =============================================================================== + [..] + (#) Enable the GPIO AHB clock using the following function + RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOx, ENABLE); + + (#) Configure the GPIO pin(s) using GPIO_Init() + Four possible configuration are available for each pin: + (++) Input: Floating, Pull-up, Pull-down. + (++) Output: Push-Pull (Pull-up, Pull-down or no Pull) + Open Drain (Pull-up, Pull-down or no Pull). In output mode, the speed + is configurable: 2 MHz, 25 MHz, 50 MHz or 100 MHz. + (++) Alternate Function: Push-Pull (Pull-up, Pull-down or no Pull) Open + Drain (Pull-up, Pull-down or no Pull). + (++) Analog: required mode when a pin is to be used as ADC channel or DAC + output. + + (#) Peripherals alternate function: + (++) For ADC and DAC, configure the desired pin in analog mode using + GPIO_InitStruct->GPIO_Mode = GPIO_Mode_AN; + (+++) For other peripherals (TIM, USART...): + (+++) Connect the pin to the desired peripherals' Alternate + Function (AF) using GPIO_PinAFConfig() function + (+++) Configure the desired pin in alternate function mode using + GPIO_InitStruct->GPIO_Mode = GPIO_Mode_AF + (+++) Select the type, pull-up/pull-down and output speed via + GPIO_PuPd, GPIO_OType and GPIO_Speed members + (+++) Call GPIO_Init() function + + (#) To get the level of a pin configured in input mode use GPIO_ReadInputDataBit() + + (#) To set/reset the level of a pin configured in output mode use + GPIO_SetBits()/GPIO_ResetBits() + + (#) During and just after reset, the alternate functions are not + active and the GPIO pins are configured in input floating mode (except JTAG + pins). + + (#) The LSE oscillator pins OSC32_IN and OSC32_OUT can be used as general purpose + (PC14 and PC15, respectively) when the LSE oscillator is off. The LSE has + priority over the GPIO function. + + (#) The HSE oscillator pins OSC_IN/OSC_OUT can be used as + general purpose PH0 and PH1, respectively, when the HSE oscillator is off. + The HSE has priority over the GPIO function. + +@endverbatim + * + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx_gpio.h" +#include "stm32f4xx_rcc.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @defgroup GPIO + * @brief GPIO driver modules + * @{ + */ + +/* Private typedef -----------------------------------------------------------*/ +/* Private define ------------------------------------------------------------*/ +/* Private macro -------------------------------------------------------------*/ +/* Private variables ---------------------------------------------------------*/ +/* Private function prototypes -----------------------------------------------*/ +/* Private functions ---------------------------------------------------------*/ + +/** @defgroup GPIO_Private_Functions + * @{ + */ + +/** @defgroup GPIO_Group1 Initialization and Configuration + * @brief Initialization and Configuration + * +@verbatim + =============================================================================== + ##### Initialization and Configuration ##### + =============================================================================== + +@endverbatim + * @{ + */ + +/** + * @brief De-initializes the GPIOx peripheral registers to their default reset values. + * @note By default, The GPIO pins are configured in input floating mode (except JTAG pins). + * @param GPIOx: where x can be (A..K) to select the GPIO peripheral for STM32F405xx/407xx and STM32F415xx/417xx devices + * x can be (A..I) to select the GPIO peripheral for STM32F42xxx/43xxx devices. + * x can be (A, B, C, D and H) to select the GPIO peripheral for STM32F401xx devices. + * @retval None + */ +void GPIO_DeInit(GPIO_TypeDef* GPIOx) +{ + /* Check the parameters */ + assert_param(IS_GPIO_ALL_PERIPH(GPIOx)); + + if (GPIOx == GPIOA) + { + RCC_AHB1PeriphResetCmd(RCC_AHB1Periph_GPIOA, ENABLE); + RCC_AHB1PeriphResetCmd(RCC_AHB1Periph_GPIOA, DISABLE); + } + else if (GPIOx == GPIOB) + { + RCC_AHB1PeriphResetCmd(RCC_AHB1Periph_GPIOB, ENABLE); + RCC_AHB1PeriphResetCmd(RCC_AHB1Periph_GPIOB, DISABLE); + } + else if (GPIOx == GPIOC) + { + RCC_AHB1PeriphResetCmd(RCC_AHB1Periph_GPIOC, ENABLE); + RCC_AHB1PeriphResetCmd(RCC_AHB1Periph_GPIOC, DISABLE); + } + else if (GPIOx == GPIOD) + { + RCC_AHB1PeriphResetCmd(RCC_AHB1Periph_GPIOD, ENABLE); + RCC_AHB1PeriphResetCmd(RCC_AHB1Periph_GPIOD, DISABLE); + } + else if (GPIOx == GPIOE) + { + RCC_AHB1PeriphResetCmd(RCC_AHB1Periph_GPIOE, ENABLE); + RCC_AHB1PeriphResetCmd(RCC_AHB1Periph_GPIOE, DISABLE); + } + else if (GPIOx == GPIOF) + { + RCC_AHB1PeriphResetCmd(RCC_AHB1Periph_GPIOF, ENABLE); + RCC_AHB1PeriphResetCmd(RCC_AHB1Periph_GPIOF, DISABLE); + } + else if (GPIOx == GPIOG) + { + RCC_AHB1PeriphResetCmd(RCC_AHB1Periph_GPIOG, ENABLE); + RCC_AHB1PeriphResetCmd(RCC_AHB1Periph_GPIOG, DISABLE); + } + else if (GPIOx == GPIOH) + { + RCC_AHB1PeriphResetCmd(RCC_AHB1Periph_GPIOH, ENABLE); + RCC_AHB1PeriphResetCmd(RCC_AHB1Periph_GPIOH, DISABLE); + } + + else if (GPIOx == GPIOI) + { + RCC_AHB1PeriphResetCmd(RCC_AHB1Periph_GPIOI, ENABLE); + RCC_AHB1PeriphResetCmd(RCC_AHB1Periph_GPIOI, DISABLE); + } + else if (GPIOx == GPIOJ) + { + RCC_AHB1PeriphResetCmd(RCC_AHB1Periph_GPIOJ, ENABLE); + RCC_AHB1PeriphResetCmd(RCC_AHB1Periph_GPIOJ, DISABLE); + } + else + { + if (GPIOx == GPIOK) + { + RCC_AHB1PeriphResetCmd(RCC_AHB1Periph_GPIOK, ENABLE); + RCC_AHB1PeriphResetCmd(RCC_AHB1Periph_GPIOK, DISABLE); + } + } +} + +/** + * @brief Initializes the GPIOx peripheral according to the specified parameters in the GPIO_InitStruct. + * @param GPIOx: where x can be (A..K) to select the GPIO peripheral for STM32F405xx/407xx and STM32F415xx/417xx devices + * x can be (A..I) to select the GPIO peripheral for STM32F42xxx/43xxx devices. + * x can be (A, B, C, D and H) to select the GPIO peripheral for STM32F401xx devices. + * @param GPIO_InitStruct: pointer to a GPIO_InitTypeDef structure that contains + * the configuration information for the specified GPIO peripheral. + * @retval None + */ +void GPIO_Init(GPIO_TypeDef* GPIOx, GPIO_InitTypeDef* GPIO_InitStruct) +{ + uint32_t pinpos = 0x00, pos = 0x00 , currentpin = 0x00; + + /* Check the parameters */ + assert_param(IS_GPIO_ALL_PERIPH(GPIOx)); + assert_param(IS_GPIO_PIN(GPIO_InitStruct->GPIO_Pin)); + assert_param(IS_GPIO_MODE(GPIO_InitStruct->GPIO_Mode)); + assert_param(IS_GPIO_PUPD(GPIO_InitStruct->GPIO_PuPd)); + + /* ------------------------- Configure the port pins ---------------- */ + /*-- GPIO Mode Configuration --*/ + for (pinpos = 0x00; pinpos < 0x10; pinpos++) + { + pos = ((uint32_t)0x01) << pinpos; + /* Get the port pins position */ + currentpin = (GPIO_InitStruct->GPIO_Pin) & pos; + + if (currentpin == pos) + { + GPIOx->MODER &= ~(GPIO_MODER_MODER0 << (pinpos * 2)); + GPIOx->MODER |= (((uint32_t)GPIO_InitStruct->GPIO_Mode) << (pinpos * 2)); + + if ((GPIO_InitStruct->GPIO_Mode == GPIO_Mode_OUT) || (GPIO_InitStruct->GPIO_Mode == GPIO_Mode_AF)) + { + /* Check Speed mode parameters */ + assert_param(IS_GPIO_SPEED(GPIO_InitStruct->GPIO_Speed)); + + /* Speed mode configuration */ + GPIOx->OSPEEDR &= ~(GPIO_OSPEEDER_OSPEEDR0 << (pinpos * 2)); + GPIOx->OSPEEDR |= ((uint32_t)(GPIO_InitStruct->GPIO_Speed) << (pinpos * 2)); + + /* Check Output mode parameters */ + assert_param(IS_GPIO_OTYPE(GPIO_InitStruct->GPIO_OType)); + + /* Output mode configuration*/ + GPIOx->OTYPER &= ~((GPIO_OTYPER_OT_0) << ((uint16_t)pinpos)) ; + GPIOx->OTYPER |= (uint16_t)(((uint16_t)GPIO_InitStruct->GPIO_OType) << ((uint16_t)pinpos)); + } + + /* Pull-up Pull down resistor configuration*/ + GPIOx->PUPDR &= ~(GPIO_PUPDR_PUPDR0 << ((uint16_t)pinpos * 2)); + GPIOx->PUPDR |= (((uint32_t)GPIO_InitStruct->GPIO_PuPd) << (pinpos * 2)); + } + } +} + +/** + * @brief Fills each GPIO_InitStruct member with its default value. + * @param GPIO_InitStruct : pointer to a GPIO_InitTypeDef structure which will be initialized. + * @retval None + */ +void GPIO_StructInit(GPIO_InitTypeDef* GPIO_InitStruct) +{ + /* Reset GPIO init structure parameters values */ + GPIO_InitStruct->GPIO_Pin = GPIO_Pin_All; + GPIO_InitStruct->GPIO_Mode = GPIO_Mode_IN; + GPIO_InitStruct->GPIO_Speed = GPIO_Speed_2MHz; + GPIO_InitStruct->GPIO_OType = GPIO_OType_PP; + GPIO_InitStruct->GPIO_PuPd = GPIO_PuPd_NOPULL; +} + +/** + * @brief Locks GPIO Pins configuration registers. + * @note The locked registers are GPIOx_MODER, GPIOx_OTYPER, GPIOx_OSPEEDR, + * GPIOx_PUPDR, GPIOx_AFRL and GPIOx_AFRH. + * @note The configuration of the locked GPIO pins can no longer be modified + * until the next reset. + * @param GPIOx: where x can be (A..K) to select the GPIO peripheral for STM32F405xx/407xx and STM32F415xx/417xx devices + * x can be (A..I) to select the GPIO peripheral for STM32F42xxx/43xxx devices. + * x can be (A, B, C, D and H) to select the GPIO peripheral for STM32F401xx devices. + * @param GPIO_Pin: specifies the port bit to be locked. + * This parameter can be any combination of GPIO_Pin_x where x can be (0..15). + * @retval None + */ +void GPIO_PinLockConfig(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin) +{ + __IO uint32_t tmp = 0x00010000; + + /* Check the parameters */ + assert_param(IS_GPIO_ALL_PERIPH(GPIOx)); + assert_param(IS_GPIO_PIN(GPIO_Pin)); + + tmp |= GPIO_Pin; + /* Set LCKK bit */ + GPIOx->LCKR = tmp; + /* Reset LCKK bit */ + GPIOx->LCKR = GPIO_Pin; + /* Set LCKK bit */ + GPIOx->LCKR = tmp; + /* Read LCKK bit*/ + tmp = GPIOx->LCKR; + /* Read LCKK bit*/ + tmp = GPIOx->LCKR; +} + +/** + * @} + */ + +/** @defgroup GPIO_Group2 GPIO Read and Write + * @brief GPIO Read and Write + * +@verbatim + =============================================================================== + ##### GPIO Read and Write ##### + =============================================================================== + +@endverbatim + * @{ + */ + +/** + * @brief Reads the specified input port pin. + * @param GPIOx: where x can be (A..K) to select the GPIO peripheral for STM32F405xx/407xx and STM32F415xx/417xx devices + * x can be (A..I) to select the GPIO peripheral for STM32F42xxx/43xxx devices. + * x can be (A, B, C, D and H) to select the GPIO peripheral for STM32F401xx devices. + * @param GPIO_Pin: specifies the port bit to read. + * This parameter can be GPIO_Pin_x where x can be (0..15). + * @retval The input port pin value. + */ +uint8_t GPIO_ReadInputDataBit(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin) +{ + uint8_t bitstatus = 0x00; + + /* Check the parameters */ + assert_param(IS_GPIO_ALL_PERIPH(GPIOx)); + assert_param(IS_GET_GPIO_PIN(GPIO_Pin)); + + if ((GPIOx->IDR & GPIO_Pin) != (uint32_t)Bit_RESET) + { + bitstatus = (uint8_t)Bit_SET; + } + else + { + bitstatus = (uint8_t)Bit_RESET; + } + return bitstatus; +} + +/** + * @brief Reads the specified GPIO input data port. + * @param GPIOx: where x can be (A..K) to select the GPIO peripheral for STM32F405xx/407xx and STM32F415xx/417xx devices + * x can be (A..I) to select the GPIO peripheral for STM32F42xxx/43xxx devices. + * x can be (A, B, C, D and H) to select the GPIO peripheral for STM32F401xx devices. + * @retval GPIO input data port value. + */ +uint16_t GPIO_ReadInputData(GPIO_TypeDef* GPIOx) +{ + /* Check the parameters */ + assert_param(IS_GPIO_ALL_PERIPH(GPIOx)); + + return ((uint16_t)GPIOx->IDR); +} + +/** + * @brief Reads the specified output data port bit. + * @param GPIOx: where x can be (A..K) to select the GPIO peripheral for STM32F405xx/407xx and STM32F415xx/417xx devices + * x can be (A..I) to select the GPIO peripheral for STM32F42xxx/43xxx devices. + * x can be (A, B, C, D and H) to select the GPIO peripheral for STM32F401xx devices. + * @param GPIO_Pin: specifies the port bit to read. + * This parameter can be GPIO_Pin_x where x can be (0..15). + * @retval The output port pin value. + */ +uint8_t GPIO_ReadOutputDataBit(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin) +{ + uint8_t bitstatus = 0x00; + + /* Check the parameters */ + assert_param(IS_GPIO_ALL_PERIPH(GPIOx)); + assert_param(IS_GET_GPIO_PIN(GPIO_Pin)); + + if (((GPIOx->ODR) & GPIO_Pin) != (uint32_t)Bit_RESET) + { + bitstatus = (uint8_t)Bit_SET; + } + else + { + bitstatus = (uint8_t)Bit_RESET; + } + return bitstatus; +} + +/** + * @brief Reads the specified GPIO output data port. + * @param GPIOx: where x can be (A..K) to select the GPIO peripheral for STM32F405xx/407xx and STM32F415xx/417xx devices + * x can be (A..I) to select the GPIO peripheral for STM32F42xxx/43xxx devices. + * x can be (A, B, C, D and H) to select the GPIO peripheral for STM32F401xx devices. + * @retval GPIO output data port value. + */ +uint16_t GPIO_ReadOutputData(GPIO_TypeDef* GPIOx) +{ + /* Check the parameters */ + assert_param(IS_GPIO_ALL_PERIPH(GPIOx)); + + return ((uint16_t)GPIOx->ODR); +} + +/** + * @brief Sets the selected data port bits. + * @note This functions uses GPIOx_BSRR register to allow atomic read/modify + * accesses. In this way, there is no risk of an IRQ occurring between + * the read and the modify access. + * @param GPIOx: where x can be (A..K) to select the GPIO peripheral for STM32F405xx/407xx and STM32F415xx/417xx devices + * x can be (A..I) to select the GPIO peripheral for STM32F42xxx/43xxx devices. + * x can be (A, B, C, D and H) to select the GPIO peripheral for STM32F401xx devices. + * @param GPIO_Pin: specifies the port bits to be written. + * This parameter can be any combination of GPIO_Pin_x where x can be (0..15). + * @retval None + */ +void GPIO_SetBits(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin) +{ + /* Check the parameters */ + assert_param(IS_GPIO_ALL_PERIPH(GPIOx)); + assert_param(IS_GPIO_PIN(GPIO_Pin)); + + GPIOx->BSRRL = GPIO_Pin; +} + +/** + * @brief Clears the selected data port bits. + * @note This functions uses GPIOx_BSRR register to allow atomic read/modify + * accesses. In this way, there is no risk of an IRQ occurring between + * the read and the modify access. + * @param GPIOx: where x can be (A..K) to select the GPIO peripheral for STM32F405xx/407xx and STM32F415xx/417xx devices + * x can be (A..I) to select the GPIO peripheral for STM32F42xxx/43xxx devices. + * x can be (A, B, C, D and H) to select the GPIO peripheral for STM32F401xx devices. + * @param GPIO_Pin: specifies the port bits to be written. + * This parameter can be any combination of GPIO_Pin_x where x can be (0..15). + * @retval None + */ +void GPIO_ResetBits(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin) +{ + /* Check the parameters */ + assert_param(IS_GPIO_ALL_PERIPH(GPIOx)); + assert_param(IS_GPIO_PIN(GPIO_Pin)); + + GPIOx->BSRRH = GPIO_Pin; +} + +/** + * @brief Sets or clears the selected data port bit. + * @param GPIOx: where x can be (A..K) to select the GPIO peripheral for STM32F405xx/407xx and STM32F415xx/417xx devices + * x can be (A..I) to select the GPIO peripheral for STM32F42xxx/43xxx devices. + * x can be (A, B, C, D and H) to select the GPIO peripheral for STM32F401xx devices. + * @param GPIO_Pin: specifies the port bit to be written. + * This parameter can be one of GPIO_Pin_x where x can be (0..15). + * @param BitVal: specifies the value to be written to the selected bit. + * This parameter can be one of the BitAction enum values: + * @arg Bit_RESET: to clear the port pin + * @arg Bit_SET: to set the port pin + * @retval None + */ +void GPIO_WriteBit(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin, BitAction BitVal) +{ + /* Check the parameters */ + assert_param(IS_GPIO_ALL_PERIPH(GPIOx)); + assert_param(IS_GET_GPIO_PIN(GPIO_Pin)); + assert_param(IS_GPIO_BIT_ACTION(BitVal)); + + if (BitVal != Bit_RESET) + { + GPIOx->BSRRL = GPIO_Pin; + } + else + { + GPIOx->BSRRH = GPIO_Pin ; + } +} + +/** + * @brief Writes data to the specified GPIO data port. + * @param GPIOx: where x can be (A..K) to select the GPIO peripheral for STM32F405xx/407xx and STM32F415xx/417xx devices + * x can be (A..I) to select the GPIO peripheral for STM32F42xxx/43xxx devices. + * x can be (A, B, C, D and H) to select the GPIO peripheral for STM32F401xx devices. + * @param PortVal: specifies the value to be written to the port output data register. + * @retval None + */ +void GPIO_Write(GPIO_TypeDef* GPIOx, uint16_t PortVal) +{ + /* Check the parameters */ + assert_param(IS_GPIO_ALL_PERIPH(GPIOx)); + + GPIOx->ODR = PortVal; +} + +/** + * @brief Toggles the specified GPIO pins.. + * @param GPIOx: where x can be (A..K) to select the GPIO peripheral for STM32F405xx/407xx and STM32F415xx/417xx devices + * x can be (A..I) to select the GPIO peripheral for STM32F42xxx/43xxx devices. + * x can be (A, B, C, D and H) to select the GPIO peripheral for STM32F401xx devices. + * @param GPIO_Pin: Specifies the pins to be toggled. + * @retval None + */ +void GPIO_ToggleBits(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin) +{ + /* Check the parameters */ + assert_param(IS_GPIO_ALL_PERIPH(GPIOx)); + + GPIOx->ODR ^= GPIO_Pin; +} + +/** + * @} + */ + +/** @defgroup GPIO_Group3 GPIO Alternate functions configuration function + * @brief GPIO Alternate functions configuration function + * +@verbatim + =============================================================================== + ##### GPIO Alternate functions configuration function ##### + =============================================================================== + +@endverbatim + * @{ + */ + +/** + * @brief Changes the mapping of the specified pin. + * @param GPIOx: where x can be (A..K) to select the GPIO peripheral for STM32F405xx/407xx and STM32F415xx/417xx devices + * x can be (A..I) to select the GPIO peripheral for STM32F42xxx/43xxx devices. + * x can be (A, B, C, D and H) to select the GPIO peripheral for STM32F401xx devices. + * @param GPIO_PinSource: specifies the pin for the Alternate function. + * This parameter can be GPIO_PinSourcex where x can be (0..15). + * @param GPIO_AFSelection: selects the pin to used as Alternate function. + * This parameter can be one of the following values: + * @arg GPIO_AF_RTC_50Hz: Connect RTC_50Hz pin to AF0 (default after reset) + * @arg GPIO_AF_MCO: Connect MCO pin (MCO1 and MCO2) to AF0 (default after reset) + * @arg GPIO_AF_TAMPER: Connect TAMPER pins (TAMPER_1 and TAMPER_2) to AF0 (default after reset) + * @arg GPIO_AF_SWJ: Connect SWJ pins (SWD and JTAG)to AF0 (default after reset) + * @arg GPIO_AF_TRACE: Connect TRACE pins to AF0 (default after reset) + * @arg GPIO_AF_TIM1: Connect TIM1 pins to AF1 + * @arg GPIO_AF_TIM2: Connect TIM2 pins to AF1 + * @arg GPIO_AF_TIM3: Connect TIM3 pins to AF2 + * @arg GPIO_AF_TIM4: Connect TIM4 pins to AF2 + * @arg GPIO_AF_TIM5: Connect TIM5 pins to AF2 + * @arg GPIO_AF_TIM8: Connect TIM8 pins to AF3 + * @arg GPIO_AF_TIM9: Connect TIM9 pins to AF3 + * @arg GPIO_AF_TIM10: Connect TIM10 pins to AF3 + * @arg GPIO_AF_TIM11: Connect TIM11 pins to AF3 + * @arg GPIO_AF_I2C1: Connect I2C1 pins to AF4 + * @arg GPIO_AF_I2C2: Connect I2C2 pins to AF4 + * @arg GPIO_AF_I2C3: Connect I2C3 pins to AF4 + * @arg GPIO_AF_SPI1: Connect SPI1 pins to AF5 + * @arg GPIO_AF_SPI2: Connect SPI2/I2S2 pins to AF5 + * @arg GPIO_AF_SPI4: Connect SPI4 pins to AF5 + * @arg GPIO_AF_SPI5: Connect SPI5 pins to AF5 + * @arg GPIO_AF_SPI6: Connect SPI6 pins to AF5 + * @arg GPIO_AF_SAI1: Connect SAI1 pins to AF6 for STM32F42xxx/43xxx devices. + * @arg GPIO_AF_SPI3: Connect SPI3/I2S3 pins to AF6 + * @arg GPIO_AF_I2S3ext: Connect I2S3ext pins to AF7 + * @arg GPIO_AF_USART1: Connect USART1 pins to AF7 + * @arg GPIO_AF_USART2: Connect USART2 pins to AF7 + * @arg GPIO_AF_USART3: Connect USART3 pins to AF7 + * @arg GPIO_AF_UART4: Connect UART4 pins to AF8 + * @arg GPIO_AF_UART5: Connect UART5 pins to AF8 + * @arg GPIO_AF_USART6: Connect USART6 pins to AF8 + * @arg GPIO_AF_UART7: Connect UART7 pins to AF8 + * @arg GPIO_AF_UART8: Connect UART8 pins to AF8 + * @arg GPIO_AF_CAN1: Connect CAN1 pins to AF9 + * @arg GPIO_AF_CAN2: Connect CAN2 pins to AF9 + * @arg GPIO_AF_TIM12: Connect TIM12 pins to AF9 + * @arg GPIO_AF_TIM13: Connect TIM13 pins to AF9 + * @arg GPIO_AF_TIM14: Connect TIM14 pins to AF9 + * @arg GPIO_AF_OTG_FS: Connect OTG_FS pins to AF10 + * @arg GPIO_AF_OTG_HS: Connect OTG_HS pins to AF10 + * @arg GPIO_AF_ETH: Connect ETHERNET pins to AF11 + * @arg GPIO_AF_FSMC: Connect FSMC pins to AF12 + * @arg GPIO_AF_FMC: Connect FMC pins to AF12 for STM32F42xxx/43xxx devices. + * @arg GPIO_AF_OTG_HS_FS: Connect OTG HS (configured in FS) pins to AF12 + * @arg GPIO_AF_SDIO: Connect SDIO pins to AF12 + * @arg GPIO_AF_DCMI: Connect DCMI pins to AF13 + * @arg GPIO_AF_LTDC: Connect LTDC pins to AF14 for STM32F429xx/439xx devices. + * @arg GPIO_AF_EVENTOUT: Connect EVENTOUT pins to AF15 + * @retval None + */ +void GPIO_PinAFConfig(GPIO_TypeDef* GPIOx, uint16_t GPIO_PinSource, uint8_t GPIO_AF) +{ + uint32_t temp = 0x00; + uint32_t temp_2 = 0x00; + + /* Check the parameters */ + assert_param(IS_GPIO_ALL_PERIPH(GPIOx)); + assert_param(IS_GPIO_PIN_SOURCE(GPIO_PinSource)); + assert_param(IS_GPIO_AF(GPIO_AF)); + + temp = ((uint32_t)(GPIO_AF) << ((uint32_t)((uint32_t)GPIO_PinSource & (uint32_t)0x07) * 4)) ; + GPIOx->AFR[GPIO_PinSource >> 0x03] &= ~((uint32_t)0xF << ((uint32_t)((uint32_t)GPIO_PinSource & (uint32_t)0x07) * 4)) ; + temp_2 = GPIOx->AFR[GPIO_PinSource >> 0x03] | temp; + GPIOx->AFR[GPIO_PinSource >> 0x03] = temp_2; +} + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/src/stm32f4xx_hash.c b/FWLIB/src/stm32f4xx_hash.c new file mode 100644 index 0000000..8808895 --- /dev/null +++ b/FWLIB/src/stm32f4xx_hash.c @@ -0,0 +1,726 @@ +/** + ****************************************************************************** + * @file stm32f4xx_hash.c + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file provides firmware functions to manage the following + * functionalities of the HASH / HMAC Processor (HASH) peripheral: + * - Initialization and Configuration functions + * - Message Digest generation functions + * - context swapping functions + * - DMA interface function + * - Interrupts and flags management + * +@verbatim + =================================================================== + ##### How to use this driver ##### + =================================================================== + + *** HASH operation : *** + ======================== + [..] + (#) Enable the HASH controller clock using + RCC_AHB2PeriphClockCmd(RCC_AHB2Periph_HASH, ENABLE) function. + + (#) Initialise the HASH using HASH_Init() function. + + (#) Reset the HASH processor core, so that the HASH will be ready + to compute he message digest of a new message by using HASH_Reset() function. + + (#) Enable the HASH controller using the HASH_Cmd() function. + + (#) if using DMA for Data input transfer, Activate the DMA Request + using HASH_DMACmd() function + + (#) if DMA is not used for data transfer, use HASH_DataIn() function + to enter data to IN FIFO. + + + (#) Configure the Number of valid bits in last word of the message + using HASH_SetLastWordValidBitsNbr() function. + + (#) if the message length is not an exact multiple of 512 bits, + then the function HASH_StartDigest() must be called to launch the computation + of the final digest. + + (#) Once computed, the digest can be read using HASH_GetDigest() function. + + (#) To control HASH events you can use one of the following wo methods: + (++) Check on HASH flags using the HASH_GetFlagStatus() function. + (++) Use HASH interrupts through the function HASH_ITConfig() at + initialization phase and HASH_GetITStatus() function into + interrupt routines in hashing phase. + After checking on a flag you should clear it using HASH_ClearFlag() + function. And after checking on an interrupt event you should + clear it using HASH_ClearITPendingBit() function. + + (#) Save and restore hash processor context using + HASH_SaveContext() and HASH_RestoreContext() functions. + + + + *** HMAC operation : *** + ======================== + [..] The HMAC algorithm is used for message authentication, by + irreversibly binding the message being processed to a key chosen + by the user. + For HMAC specifications, refer to "HMAC: keyed-hashing for message + authentication, H. Krawczyk, M. Bellare, R. Canetti, February 1997" + + [..] Basically, the HMAC algorithm consists of two nested hash operations: + HMAC(message) = Hash[((key | pad) XOR 0x5C) | Hash(((key | pad) XOR 0x36) | message)] + where: + (+) "pad" is a sequence of zeroes needed to extend the key to the + length of the underlying hash function data block (that is + 512 bits for both the SHA-1 and MD5 hash algorithms) + (+) "|" represents the concatenation operator + + + [..]To compute the HMAC, four different phases are required: + (#) Initialise the HASH using HASH_Init() function to do HMAC + operation. + + (#) The key (to be used for the inner hash function) is then given to the core. + This operation follows the same mechanism as the one used to send the + message in the hash operation (that is, by HASH_DataIn() function and, + finally, HASH_StartDigest() function. + + (#) Once the last word has been entered and computation has started, + the hash processor elaborates the key. It is then ready to accept the message + text using the same mechanism as the one used to send the message in the + hash operation. + + (#) After the first hash round, the hash processor returns "ready" to indicate + that it is ready to receive the key to be used for the outer hash function + (normally, this key is the same as the one used for the inner hash function). + When the last word of the key is entered and computation starts, the HMAC + result is made available using HASH_GetDigest() function. + +@endverbatim + * + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx_hash.h" +#include "stm32f4xx_rcc.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @defgroup HASH + * @brief HASH driver modules + * @{ + */ + +/* Private typedef -----------------------------------------------------------*/ +/* Private define ------------------------------------------------------------*/ +/* Private macro -------------------------------------------------------------*/ +/* Private variables ---------------------------------------------------------*/ +/* Private function prototypes -----------------------------------------------*/ +/* Private functions ---------------------------------------------------------*/ + +/** @defgroup HASH_Private_Functions + * @{ + */ + +/** @defgroup HASH_Group1 Initialization and Configuration functions + * @brief Initialization and Configuration functions + * +@verbatim + =============================================================================== + ##### Initialization and Configuration functions ##### + =============================================================================== + [..] This section provides functions allowing to + (+) Initialize the HASH peripheral + (+) Configure the HASH Processor + (+) MD5/SHA1, + (+) HASH/HMAC, + (+) datatype + (+) HMAC Key (if mode = HMAC) + (+) Reset the HASH Processor + +@endverbatim + * @{ + */ + +/** + * @brief De-initializes the HASH peripheral registers to their default reset values + * @param None + * @retval None + */ +void HASH_DeInit(void) +{ + /* Enable HASH reset state */ + RCC_AHB2PeriphResetCmd(RCC_AHB2Periph_HASH, ENABLE); + /* Release HASH from reset state */ + RCC_AHB2PeriphResetCmd(RCC_AHB2Periph_HASH, DISABLE); +} + +/** + * @brief Initializes the HASH peripheral according to the specified parameters + * in the HASH_InitStruct structure. + * @note the hash processor is reset when calling this function so that the + * HASH will be ready to compute the message digest of a new message. + * There is no need to call HASH_Reset() function. + * @param HASH_InitStruct: pointer to a HASH_InitTypeDef structure that contains + * the configuration information for the HASH peripheral. + * @note The field HASH_HMACKeyType in HASH_InitTypeDef must be filled only + * if the algorithm mode is HMAC. + * @retval None + */ +void HASH_Init(HASH_InitTypeDef* HASH_InitStruct) +{ + /* Check the parameters */ + assert_param(IS_HASH_ALGOSELECTION(HASH_InitStruct->HASH_AlgoSelection)); + assert_param(IS_HASH_DATATYPE(HASH_InitStruct->HASH_DataType)); + assert_param(IS_HASH_ALGOMODE(HASH_InitStruct->HASH_AlgoMode)); + + /* Configure the Algorithm used, algorithm mode and the datatype */ + HASH->CR &= ~ (HASH_CR_ALGO | HASH_CR_DATATYPE | HASH_CR_MODE); + HASH->CR |= (HASH_InitStruct->HASH_AlgoSelection | \ + HASH_InitStruct->HASH_DataType | \ + HASH_InitStruct->HASH_AlgoMode); + + /* if algorithm mode is HMAC, set the Key */ + if(HASH_InitStruct->HASH_AlgoMode == HASH_AlgoMode_HMAC) + { + assert_param(IS_HASH_HMAC_KEYTYPE(HASH_InitStruct->HASH_HMACKeyType)); + HASH->CR &= ~HASH_CR_LKEY; + HASH->CR |= HASH_InitStruct->HASH_HMACKeyType; + } + + /* Reset the HASH processor core, so that the HASH will be ready to compute + the message digest of a new message */ + HASH->CR |= HASH_CR_INIT; +} + +/** + * @brief Fills each HASH_InitStruct member with its default value. + * @param HASH_InitStruct : pointer to a HASH_InitTypeDef structure which will + * be initialized. + * @note The default values set are : Processor mode is HASH, Algorithm selected is SHA1, + * Data type selected is 32b and HMAC Key Type is short key. + * @retval None + */ +void HASH_StructInit(HASH_InitTypeDef* HASH_InitStruct) +{ + /* Initialize the HASH_AlgoSelection member */ + HASH_InitStruct->HASH_AlgoSelection = HASH_AlgoSelection_SHA1; + + /* Initialize the HASH_AlgoMode member */ + HASH_InitStruct->HASH_AlgoMode = HASH_AlgoMode_HASH; + + /* Initialize the HASH_DataType member */ + HASH_InitStruct->HASH_DataType = HASH_DataType_32b; + + /* Initialize the HASH_HMACKeyType member */ + HASH_InitStruct->HASH_HMACKeyType = HASH_HMACKeyType_ShortKey; +} + +/** + * @brief Resets the HASH processor core, so that the HASH will be ready + * to compute the message digest of a new message. + * @note Calling this function will clear the HASH_SR_DCIS (Digest calculation + * completion interrupt status) bit corresponding to HASH_IT_DCI + * interrupt and HASH_FLAG_DCIS flag. + * @param None + * @retval None + */ +void HASH_Reset(void) +{ + /* Reset the HASH processor core */ + HASH->CR |= HASH_CR_INIT; +} +/** + * @} + */ + +/** @defgroup HASH_Group2 Message Digest generation functions + * @brief Message Digest generation functions + * +@verbatim + =============================================================================== + ##### Message Digest generation functions ##### + =============================================================================== + [..] This section provides functions allowing the generation of message digest: + (+) Push data in the IN FIFO : using HASH_DataIn() + (+) Get the number of words set in IN FIFO, use HASH_GetInFIFOWordsNbr() + (+) set the last word valid bits number using HASH_SetLastWordValidBitsNbr() + (+) start digest calculation : using HASH_StartDigest() + (+) Get the Digest message : using HASH_GetDigest() + +@endverbatim + * @{ + */ + + +/** + * @brief Configure the Number of valid bits in last word of the message + * @param ValidNumber: Number of valid bits in last word of the message. + * This parameter must be a number between 0 and 0x1F. + * - 0x00: All 32 bits of the last data written are valid + * - 0x01: Only bit [0] of the last data written is valid + * - 0x02: Only bits[1:0] of the last data written are valid + * - 0x03: Only bits[2:0] of the last data written are valid + * - ... + * - 0x1F: Only bits[30:0] of the last data written are valid + * @note The Number of valid bits must be set before to start the message + * digest competition (in Hash and HMAC) and key treatment(in HMAC). + * @retval None + */ +void HASH_SetLastWordValidBitsNbr(uint16_t ValidNumber) +{ + /* Check the parameters */ + assert_param(IS_HASH_VALIDBITSNUMBER(ValidNumber)); + + /* Configure the Number of valid bits in last word of the message */ + HASH->STR &= ~(HASH_STR_NBW); + HASH->STR |= ValidNumber; +} + +/** + * @brief Writes data in the Data Input FIFO + * @param Data: new data of the message to be processed. + * @retval None + */ +void HASH_DataIn(uint32_t Data) +{ + /* Write in the DIN register a new data */ + HASH->DIN = Data; +} + +/** + * @brief Returns the number of words already pushed into the IN FIFO. + * @param None + * @retval The value of words already pushed into the IN FIFO. + */ +uint8_t HASH_GetInFIFOWordsNbr(void) +{ + /* Return the value of NBW bits */ + return ((HASH->CR & HASH_CR_NBW) >> 8); +} + +/** + * @brief Provides the message digest result. + * @note In MD5 mode, Data[7] to Data[4] filed of HASH_MsgDigest structure is not used + * and is read as zero. + * In SHA-1 mode, Data[7] to Data[5] filed of HASH_MsgDigest structure is not used + * and is read as zero. + * In SHA-224 mode, Data[7] filed of HASH_MsgDigest structure is not used + * and is read as zero. + * @param HASH_MessageDigest: pointer to a HASH_MsgDigest structure which will + * hold the message digest result + * @retval None + */ +void HASH_GetDigest(HASH_MsgDigest* HASH_MessageDigest) +{ + /* Get the data field */ + HASH_MessageDigest->Data[0] = HASH->HR[0]; + HASH_MessageDigest->Data[1] = HASH->HR[1]; + HASH_MessageDigest->Data[2] = HASH->HR[2]; + HASH_MessageDigest->Data[3] = HASH->HR[3]; + HASH_MessageDigest->Data[4] = HASH->HR[4]; + HASH_MessageDigest->Data[5] = HASH_DIGEST->HR[5]; + HASH_MessageDigest->Data[6] = HASH_DIGEST->HR[6]; + HASH_MessageDigest->Data[7] = HASH_DIGEST->HR[7]; +} + +/** + * @brief Starts the message padding and calculation of the final message + * @param None + * @retval None + */ +void HASH_StartDigest(void) +{ + /* Start the Digest calculation */ + HASH->STR |= HASH_STR_DCAL; +} +/** + * @} + */ + +/** @defgroup HASH_Group3 Context swapping functions + * @brief Context swapping functions + * +@verbatim + =============================================================================== + ##### Context swapping functions ##### + =============================================================================== + + [..] This section provides functions allowing to save and store HASH Context + + [..] It is possible to interrupt a HASH/HMAC process to perform another processing + with a higher priority, and to complete the interrupted process later on, when + the higher priority task is complete. To do so, the context of the interrupted + task must be saved from the HASH registers to memory, and then be restored + from memory to the HASH registers. + + (#) To save the current context, use HASH_SaveContext() function + (#) To restore the saved context, use HASH_RestoreContext() function + + +@endverbatim + * @{ + */ + +/** + * @brief Save the Hash peripheral Context. + * @note The context can be saved only when no block is currently being + * processed. So user must wait for DINIS = 1 (the last block has been + * processed and the input FIFO is empty) or NBW != 0 (the FIFO is not + * full and no processing is ongoing). + * @param HASH_ContextSave: pointer to a HASH_Context structure that contains + * the repository for current context. + * @retval None + */ +void HASH_SaveContext(HASH_Context* HASH_ContextSave) +{ + uint8_t i = 0; + + /* save context registers */ + HASH_ContextSave->HASH_IMR = HASH->IMR; + HASH_ContextSave->HASH_STR = HASH->STR; + HASH_ContextSave->HASH_CR = HASH->CR; + for(i=0; i<=53;i++) + { + HASH_ContextSave->HASH_CSR[i] = HASH->CSR[i]; + } +} + +/** + * @brief Restore the Hash peripheral Context. + * @note After calling this function, user can restart the processing from the + * point where it has been interrupted. + * @param HASH_ContextRestore: pointer to a HASH_Context structure that contains + * the repository for saved context. + * @retval None + */ +void HASH_RestoreContext(HASH_Context* HASH_ContextRestore) +{ + uint8_t i = 0; + + /* restore context registers */ + HASH->IMR = HASH_ContextRestore->HASH_IMR; + HASH->STR = HASH_ContextRestore->HASH_STR; + HASH->CR = HASH_ContextRestore->HASH_CR; + + /* Initialize the hash processor */ + HASH->CR |= HASH_CR_INIT; + + /* continue restoring context registers */ + for(i=0; i<=53;i++) + { + HASH->CSR[i] = HASH_ContextRestore->HASH_CSR[i]; + } +} +/** + * @} + */ + +/** @defgroup HASH_Group4 HASH's DMA interface Configuration function + * @brief HASH's DMA interface Configuration function + * +@verbatim + =============================================================================== + ##### HASH's DMA interface Configuration function ##### + =============================================================================== + + [..] This section provides functions allowing to configure the DMA interface for + HASH/ HMAC data input transfer. + + [..] When the DMA mode is enabled (using the HASH_DMACmd() function), data can be + sent to the IN FIFO using the DMA peripheral. + +@endverbatim + * @{ + */ + +/** + * @brief Enables or disables auto-start message padding and + * calculation of the final message digest at the end of DMA transfer. + * @param NewState: new state of the selected HASH DMA transfer request. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void HASH_AutoStartDigest(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the auto start of the final message digest at the end of DMA transfer */ + HASH->CR &= ~HASH_CR_MDMAT; + } + else + { + /* Disable the auto start of the final message digest at the end of DMA transfer */ + HASH->CR |= HASH_CR_MDMAT; + } +} + +/** + * @brief Enables or disables the HASH DMA interface. + * @note The DMA is disabled by hardware after the end of transfer. + * @param NewState: new state of the selected HASH DMA transfer request. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void HASH_DMACmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the HASH DMA request */ + HASH->CR |= HASH_CR_DMAE; + } + else + { + /* Disable the HASH DMA request */ + HASH->CR &= ~HASH_CR_DMAE; + } +} +/** + * @} + */ + +/** @defgroup HASH_Group5 Interrupts and flags management functions + * @brief Interrupts and flags management functions + * +@verbatim + =============================================================================== + ##### Interrupts and flags management functions ##### + =============================================================================== + + [..] This section provides functions allowing to configure the HASH Interrupts and + to get the status and clear flags and Interrupts pending bits. + + [..] The HASH provides 2 Interrupts sources and 5 Flags: + + *** Flags : *** + =============== + [..] + (#) HASH_FLAG_DINIS : set when 16 locations are free in the Data IN FIFO + which means that a new block (512 bit) can be entered into the input buffer. + + (#) HASH_FLAG_DCIS : set when Digest calculation is complete + + (#) HASH_FLAG_DMAS : set when HASH's DMA interface is enabled (DMAE=1) or + a transfer is ongoing. This Flag is cleared only by hardware. + + (#) HASH_FLAG_BUSY : set when The hash core is processing a block of data + This Flag is cleared only by hardware. + + (#) HASH_FLAG_DINNE : set when Data IN FIFO is not empty which means that + the Data IN FIFO contains at least one word of data. This Flag is cleared + only by hardware. + + *** Interrupts : *** + ==================== + [..] + (#) HASH_IT_DINI : if enabled, this interrupt source is pending when 16 + locations are free in the Data IN FIFO which means that a new block (512 bit) + can be entered into the input buffer. This interrupt source is cleared using + HASH_ClearITPendingBit(HASH_IT_DINI) function. + + (#) HASH_IT_DCI : if enabled, this interrupt source is pending when Digest + calculation is complete. This interrupt source is cleared using + HASH_ClearITPendingBit(HASH_IT_DCI) function. + + *** Managing the HASH controller events : *** + ============================================= + [..] The user should identify which mode will be used in his application to manage + the HASH controller events: Polling mode or Interrupt mode. + + (#) In the Polling Mode it is advised to use the following functions: + (++) HASH_GetFlagStatus() : to check if flags events occur. + (++) HASH_ClearFlag() : to clear the flags events. + + (#) In the Interrupt Mode it is advised to use the following functions: + (++) HASH_ITConfig() : to enable or disable the interrupt source. + (++) HASH_GetITStatus() : to check if Interrupt occurs. + (++) HASH_ClearITPendingBit() : to clear the Interrupt pending Bit + (corresponding Flag). + +@endverbatim + * @{ + */ + +/** + * @brief Enables or disables the specified HASH interrupts. + * @param HASH_IT: specifies the HASH interrupt source to be enabled or disabled. + * This parameter can be any combination of the following values: + * @arg HASH_IT_DINI: Data Input interrupt + * @arg HASH_IT_DCI: Digest Calculation Completion Interrupt + * @param NewState: new state of the specified HASH interrupt. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void HASH_ITConfig(uint32_t HASH_IT, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_HASH_IT(HASH_IT)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the selected HASH interrupt */ + HASH->IMR |= HASH_IT; + } + else + { + /* Disable the selected HASH interrupt */ + HASH->IMR &= (uint32_t)(~HASH_IT); + } +} + +/** + * @brief Checks whether the specified HASH flag is set or not. + * @param HASH_FLAG: specifies the HASH flag to check. + * This parameter can be one of the following values: + * @arg HASH_FLAG_DINIS: Data input interrupt status flag + * @arg HASH_FLAG_DCIS: Digest calculation completion interrupt status flag + * @arg HASH_FLAG_BUSY: Busy flag + * @arg HASH_FLAG_DMAS: DMAS Status flag + * @arg HASH_FLAG_DINNE: Data Input register (DIN) not empty status flag + * @retval The new state of HASH_FLAG (SET or RESET) + */ +FlagStatus HASH_GetFlagStatus(uint32_t HASH_FLAG) +{ + FlagStatus bitstatus = RESET; + uint32_t tempreg = 0; + + /* Check the parameters */ + assert_param(IS_HASH_GET_FLAG(HASH_FLAG)); + + /* check if the FLAG is in CR register */ + if ((HASH_FLAG & HASH_FLAG_DINNE) != (uint32_t)RESET ) + { + tempreg = HASH->CR; + } + else /* The FLAG is in SR register */ + { + tempreg = HASH->SR; + } + + /* Check the status of the specified HASH flag */ + if ((tempreg & HASH_FLAG) != (uint32_t)RESET) + { + /* HASH is set */ + bitstatus = SET; + } + else + { + /* HASH_FLAG is reset */ + bitstatus = RESET; + } + + /* Return the HASH_FLAG status */ + return bitstatus; +} +/** + * @brief Clears the HASH flags. + * @param HASH_FLAG: specifies the flag to clear. + * This parameter can be any combination of the following values: + * @arg HASH_FLAG_DINIS: Data Input Flag + * @arg HASH_FLAG_DCIS: Digest Calculation Completion Flag + * @retval None + */ +void HASH_ClearFlag(uint32_t HASH_FLAG) +{ + /* Check the parameters */ + assert_param(IS_HASH_CLEAR_FLAG(HASH_FLAG)); + + /* Clear the selected HASH flags */ + HASH->SR = ~(uint32_t)HASH_FLAG; +} +/** + * @brief Checks whether the specified HASH interrupt has occurred or not. + * @param HASH_IT: specifies the HASH interrupt source to check. + * This parameter can be one of the following values: + * @arg HASH_IT_DINI: Data Input interrupt + * @arg HASH_IT_DCI: Digest Calculation Completion Interrupt + * @retval The new state of HASH_IT (SET or RESET). + */ +ITStatus HASH_GetITStatus(uint32_t HASH_IT) +{ + ITStatus bitstatus = RESET; + uint32_t tmpreg = 0; + + /* Check the parameters */ + assert_param(IS_HASH_GET_IT(HASH_IT)); + + + /* Check the status of the specified HASH interrupt */ + tmpreg = HASH->SR; + + if (((HASH->IMR & tmpreg) & HASH_IT) != RESET) + { + /* HASH_IT is set */ + bitstatus = SET; + } + else + { + /* HASH_IT is reset */ + bitstatus = RESET; + } + /* Return the HASH_IT status */ + return bitstatus; +} + +/** + * @brief Clears the HASH interrupt pending bit(s). + * @param HASH_IT: specifies the HASH interrupt pending bit(s) to clear. + * This parameter can be any combination of the following values: + * @arg HASH_IT_DINI: Data Input interrupt + * @arg HASH_IT_DCI: Digest Calculation Completion Interrupt + * @retval None + */ +void HASH_ClearITPendingBit(uint32_t HASH_IT) +{ + /* Check the parameters */ + assert_param(IS_HASH_IT(HASH_IT)); + + /* Clear the selected HASH interrupt pending bit */ + HASH->SR = (uint32_t)(~HASH_IT); +} + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/src/stm32f4xx_hash_md5.c b/FWLIB/src/stm32f4xx_hash_md5.c new file mode 100644 index 0000000..0a5f1da --- /dev/null +++ b/FWLIB/src/stm32f4xx_hash_md5.c @@ -0,0 +1,320 @@ +/** + ****************************************************************************** + * @file stm32f4xx_hash_md5.c + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file provides high level functions to compute the HASH MD5 and + * HMAC MD5 Digest of an input message. + * It uses the stm32f4xx_hash.c/.h drivers to access the STM32F4xx HASH + * peripheral. + * +@verbatim + =================================================================== + ##### How to use this driver ##### + =================================================================== + [..] + (#) Enable The HASH controller clock using + RCC_AHB2PeriphClockCmd(RCC_AHB2Periph_HASH, ENABLE); function. + + (#) Calculate the HASH MD5 Digest using HASH_MD5() function. + + (#) Calculate the HMAC MD5 Digest using HMAC_MD5() function. + +@endverbatim + * + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx_hash.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @defgroup HASH + * @brief HASH driver modules + * @{ + */ + +/* Private typedef -----------------------------------------------------------*/ +/* Private define ------------------------------------------------------------*/ +#define MD5BUSY_TIMEOUT ((uint32_t) 0x00010000) + +/* Private macro -------------------------------------------------------------*/ +/* Private variables ---------------------------------------------------------*/ +/* Private function prototypes -----------------------------------------------*/ +/* Private functions ---------------------------------------------------------*/ + +/** @defgroup HASH_Private_Functions + * @{ + */ + +/** @defgroup HASH_Group7 High Level MD5 functions + * @brief High Level MD5 Hash and HMAC functions + * +@verbatim + =============================================================================== + ##### High Level MD5 Hash and HMAC functions ##### + =============================================================================== + + +@endverbatim + * @{ + */ + +/** + * @brief Compute the HASH MD5 digest. + * @param Input: pointer to the Input buffer to be treated. + * @param Ilen: length of the Input buffer. + * @param Output: the returned digest + * @retval An ErrorStatus enumeration value: + * - SUCCESS: digest computation done + * - ERROR: digest computation failed + */ +ErrorStatus HASH_MD5(uint8_t *Input, uint32_t Ilen, uint8_t Output[16]) +{ + HASH_InitTypeDef MD5_HASH_InitStructure; + HASH_MsgDigest MD5_MessageDigest; + __IO uint16_t nbvalidbitsdata = 0; + uint32_t i = 0; + __IO uint32_t counter = 0; + uint32_t busystatus = 0; + ErrorStatus status = SUCCESS; + uint32_t inputaddr = (uint32_t)Input; + uint32_t outputaddr = (uint32_t)Output; + + + /* Number of valid bits in last word of the Input data */ + nbvalidbitsdata = 8 * (Ilen % 4); + + /* HASH peripheral initialization */ + HASH_DeInit(); + + /* HASH Configuration */ + MD5_HASH_InitStructure.HASH_AlgoSelection = HASH_AlgoSelection_MD5; + MD5_HASH_InitStructure.HASH_AlgoMode = HASH_AlgoMode_HASH; + MD5_HASH_InitStructure.HASH_DataType = HASH_DataType_8b; + HASH_Init(&MD5_HASH_InitStructure); + + /* Configure the number of valid bits in last word of the data */ + HASH_SetLastWordValidBitsNbr(nbvalidbitsdata); + + /* Write the Input block in the IN FIFO */ + for(i=0; i 64) + { + /* HMAC long Key */ + MD5_HASH_InitStructure.HASH_HMACKeyType = HASH_HMACKeyType_LongKey; + } + else + { + /* HMAC short Key */ + MD5_HASH_InitStructure.HASH_HMACKeyType = HASH_HMACKeyType_ShortKey; + } + HASH_Init(&MD5_HASH_InitStructure); + + /* Configure the number of valid bits in last word of the Key */ + HASH_SetLastWordValidBitsNbr(nbvalidbitskey); + + /* Write the Key */ + for(i=0; i
© COPYRIGHT 2014 STMicroelectronics
+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx_hash.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @defgroup HASH + * @brief HASH driver modules + * @{ + */ + +/* Private typedef -----------------------------------------------------------*/ +/* Private define ------------------------------------------------------------*/ +#define SHA1BUSY_TIMEOUT ((uint32_t) 0x00010000) + +/* Private macro -------------------------------------------------------------*/ +/* Private variables ---------------------------------------------------------*/ +/* Private function prototypes -----------------------------------------------*/ +/* Private functions ---------------------------------------------------------*/ + +/** @defgroup HASH_Private_Functions + * @{ + */ + +/** @defgroup HASH_Group6 High Level SHA1 functions + * @brief High Level SHA1 Hash and HMAC functions + * +@verbatim + =============================================================================== + ##### High Level SHA1 Hash and HMAC functions ##### + =============================================================================== + + +@endverbatim + * @{ + */ + +/** + * @brief Compute the HASH SHA1 digest. + * @param Input: pointer to the Input buffer to be treated. + * @param Ilen: length of the Input buffer. + * @param Output: the returned digest + * @retval An ErrorStatus enumeration value: + * - SUCCESS: digest computation done + * - ERROR: digest computation failed + */ +ErrorStatus HASH_SHA1(uint8_t *Input, uint32_t Ilen, uint8_t Output[20]) +{ + HASH_InitTypeDef SHA1_HASH_InitStructure; + HASH_MsgDigest SHA1_MessageDigest; + __IO uint16_t nbvalidbitsdata = 0; + uint32_t i = 0; + __IO uint32_t counter = 0; + uint32_t busystatus = 0; + ErrorStatus status = SUCCESS; + uint32_t inputaddr = (uint32_t)Input; + uint32_t outputaddr = (uint32_t)Output; + + /* Number of valid bits in last word of the Input data */ + nbvalidbitsdata = 8 * (Ilen % 4); + + /* HASH peripheral initialization */ + HASH_DeInit(); + + /* HASH Configuration */ + SHA1_HASH_InitStructure.HASH_AlgoSelection = HASH_AlgoSelection_SHA1; + SHA1_HASH_InitStructure.HASH_AlgoMode = HASH_AlgoMode_HASH; + SHA1_HASH_InitStructure.HASH_DataType = HASH_DataType_8b; + HASH_Init(&SHA1_HASH_InitStructure); + + /* Configure the number of valid bits in last word of the data */ + HASH_SetLastWordValidBitsNbr(nbvalidbitsdata); + + /* Write the Input block in the IN FIFO */ + for(i=0; i 64) + { + /* HMAC long Key */ + SHA1_HASH_InitStructure.HASH_HMACKeyType = HASH_HMACKeyType_LongKey; + } + else + { + /* HMAC short Key */ + SHA1_HASH_InitStructure.HASH_HMACKeyType = HASH_HMACKeyType_ShortKey; + } + HASH_Init(&SHA1_HASH_InitStructure); + + /* Configure the number of valid bits in last word of the Key */ + HASH_SetLastWordValidBitsNbr(nbvalidbitskey); + + /* Write the Key */ + for(i=0; iGPIO_Mode = GPIO_Mode_AF + (++) Select the type, pull-up/pull-down and output speed via + GPIO_PuPd, GPIO_OType and GPIO_Speed members + (++) Call GPIO_Init() function + Recommended configuration is Push-Pull, Pull-up, Open-Drain. + Add an external pull up if necessary (typically 4.7 KOhm). + + (#) Program the Mode, duty cycle , Own address, Ack, Speed and Acknowledged + Address using the I2C_Init() function. + + (#) Optionally you can enable/configure the following parameters without + re-initialization (i.e there is no need to call again I2C_Init() function): + (++) Enable the acknowledge feature using I2C_AcknowledgeConfig() function + (++) Enable the dual addressing mode using I2C_DualAddressCmd() function + (++) Enable the general call using the I2C_GeneralCallCmd() function + (++) Enable the clock stretching using I2C_StretchClockCmd() function + (++) Enable the fast mode duty cycle using the I2C_FastModeDutyCycleConfig() + function. + (++) Configure the NACK position for Master Receiver mode in case of + 2 bytes reception using the function I2C_NACKPositionConfig(). + (++) Enable the PEC Calculation using I2C_CalculatePEC() function + (++) For SMBus Mode: + (+++) Enable the Address Resolution Protocol (ARP) using I2C_ARPCmd() function + (+++) Configure the SMBusAlert pin using I2C_SMBusAlertConfig() function + + (#) Enable the NVIC and the corresponding interrupt using the function + I2C_ITConfig() if you need to use interrupt mode. + + (#) When using the DMA mode + (++) Configure the DMA using DMA_Init() function + (++) Active the needed channel Request using I2C_DMACmd() or + I2C_DMALastTransferCmd() function. + -@@- When using DMA mode, I2C interrupts may be used at the same time to + control the communication flow (Start/Stop/Ack... events and errors). + + (#) Enable the I2C using the I2C_Cmd() function. + + (#) Enable the DMA using the DMA_Cmd() function when using DMA mode in the + transfers. + + @endverbatim + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx_i2c.h" +#include "stm32f4xx_rcc.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @defgroup I2C + * @brief I2C driver modules + * @{ + */ + +/* Private typedef -----------------------------------------------------------*/ +/* Private define ------------------------------------------------------------*/ + +#define CR1_CLEAR_MASK ((uint16_t)0xFBF5) /*I2C_ClockSpeed)); + assert_param(IS_I2C_MODE(I2C_InitStruct->I2C_Mode)); + assert_param(IS_I2C_DUTY_CYCLE(I2C_InitStruct->I2C_DutyCycle)); + assert_param(IS_I2C_OWN_ADDRESS1(I2C_InitStruct->I2C_OwnAddress1)); + assert_param(IS_I2C_ACK_STATE(I2C_InitStruct->I2C_Ack)); + assert_param(IS_I2C_ACKNOWLEDGE_ADDRESS(I2C_InitStruct->I2C_AcknowledgedAddress)); + +/*---------------------------- I2Cx CR2 Configuration ------------------------*/ + /* Get the I2Cx CR2 value */ + tmpreg = I2Cx->CR2; + /* Clear frequency FREQ[5:0] bits */ + tmpreg &= (uint16_t)~((uint16_t)I2C_CR2_FREQ); + /* Get pclk1 frequency value */ + RCC_GetClocksFreq(&rcc_clocks); + pclk1 = rcc_clocks.PCLK1_Frequency; + /* Set frequency bits depending on pclk1 value */ + freqrange = (uint16_t)(pclk1 / 1000000); + tmpreg |= freqrange; + /* Write to I2Cx CR2 */ + I2Cx->CR2 = tmpreg; + +/*---------------------------- I2Cx CCR Configuration ------------------------*/ + /* Disable the selected I2C peripheral to configure TRISE */ + I2Cx->CR1 &= (uint16_t)~((uint16_t)I2C_CR1_PE); + /* Reset tmpreg value */ + /* Clear F/S, DUTY and CCR[11:0] bits */ + tmpreg = 0; + + /* Configure speed in standard mode */ + if (I2C_InitStruct->I2C_ClockSpeed <= 100000) + { + /* Standard mode speed calculate */ + result = (uint16_t)(pclk1 / (I2C_InitStruct->I2C_ClockSpeed << 1)); + /* Test if CCR value is under 0x4*/ + if (result < 0x04) + { + /* Set minimum allowed value */ + result = 0x04; + } + /* Set speed value for standard mode */ + tmpreg |= result; + /* Set Maximum Rise Time for standard mode */ + I2Cx->TRISE = freqrange + 1; + } + /* Configure speed in fast mode */ + /* To use the I2C at 400 KHz (in fast mode), the PCLK1 frequency (I2C peripheral + input clock) must be a multiple of 10 MHz */ + else /*(I2C_InitStruct->I2C_ClockSpeed <= 400000)*/ + { + if (I2C_InitStruct->I2C_DutyCycle == I2C_DutyCycle_2) + { + /* Fast mode speed calculate: Tlow/Thigh = 2 */ + result = (uint16_t)(pclk1 / (I2C_InitStruct->I2C_ClockSpeed * 3)); + } + else /*I2C_InitStruct->I2C_DutyCycle == I2C_DutyCycle_16_9*/ + { + /* Fast mode speed calculate: Tlow/Thigh = 16/9 */ + result = (uint16_t)(pclk1 / (I2C_InitStruct->I2C_ClockSpeed * 25)); + /* Set DUTY bit */ + result |= I2C_DutyCycle_16_9; + } + + /* Test if CCR value is under 0x1*/ + if ((result & I2C_CCR_CCR) == 0) + { + /* Set minimum allowed value */ + result |= (uint16_t)0x0001; + } + /* Set speed value and set F/S bit for fast mode */ + tmpreg |= (uint16_t)(result | I2C_CCR_FS); + /* Set Maximum Rise Time for fast mode */ + I2Cx->TRISE = (uint16_t)(((freqrange * (uint16_t)300) / (uint16_t)1000) + (uint16_t)1); + } + + /* Write to I2Cx CCR */ + I2Cx->CCR = tmpreg; + /* Enable the selected I2C peripheral */ + I2Cx->CR1 |= I2C_CR1_PE; + +/*---------------------------- I2Cx CR1 Configuration ------------------------*/ + /* Get the I2Cx CR1 value */ + tmpreg = I2Cx->CR1; + /* Clear ACK, SMBTYPE and SMBUS bits */ + tmpreg &= CR1_CLEAR_MASK; + /* Configure I2Cx: mode and acknowledgement */ + /* Set SMBTYPE and SMBUS bits according to I2C_Mode value */ + /* Set ACK bit according to I2C_Ack value */ + tmpreg |= (uint16_t)((uint32_t)I2C_InitStruct->I2C_Mode | I2C_InitStruct->I2C_Ack); + /* Write to I2Cx CR1 */ + I2Cx->CR1 = tmpreg; + +/*---------------------------- I2Cx OAR1 Configuration -----------------------*/ + /* Set I2Cx Own Address1 and acknowledged address */ + I2Cx->OAR1 = (I2C_InitStruct->I2C_AcknowledgedAddress | I2C_InitStruct->I2C_OwnAddress1); +} + +/** + * @brief Fills each I2C_InitStruct member with its default value. + * @param I2C_InitStruct: pointer to an I2C_InitTypeDef structure which will be initialized. + * @retval None + */ +void I2C_StructInit(I2C_InitTypeDef* I2C_InitStruct) +{ +/*---------------- Reset I2C init structure parameters values ----------------*/ + /* initialize the I2C_ClockSpeed member */ + I2C_InitStruct->I2C_ClockSpeed = 5000; + /* Initialize the I2C_Mode member */ + I2C_InitStruct->I2C_Mode = I2C_Mode_I2C; + /* Initialize the I2C_DutyCycle member */ + I2C_InitStruct->I2C_DutyCycle = I2C_DutyCycle_2; + /* Initialize the I2C_OwnAddress1 member */ + I2C_InitStruct->I2C_OwnAddress1 = 0; + /* Initialize the I2C_Ack member */ + I2C_InitStruct->I2C_Ack = I2C_Ack_Disable; + /* Initialize the I2C_AcknowledgedAddress member */ + I2C_InitStruct->I2C_AcknowledgedAddress = I2C_AcknowledgedAddress_7bit; +} + +/** + * @brief Enables or disables the specified I2C peripheral. + * @param I2Cx: where x can be 1, 2 or 3 to select the I2C peripheral. + * @param NewState: new state of the I2Cx peripheral. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void I2C_Cmd(I2C_TypeDef* I2Cx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_I2C_ALL_PERIPH(I2Cx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + if (NewState != DISABLE) + { + /* Enable the selected I2C peripheral */ + I2Cx->CR1 |= I2C_CR1_PE; + } + else + { + /* Disable the selected I2C peripheral */ + I2Cx->CR1 &= (uint16_t)~((uint16_t)I2C_CR1_PE); + } +} + +/** + * @brief Enables or disables the Analog filter of I2C peripheral. + * + * @note This function can be used only for STM32F42xxx/STM3243xxx, STM32F401xx and STM32F411xE devices. + * + * @param I2Cx: where x can be 1, 2 or 3 to select the I2C peripheral. + * @param NewState: new state of the Analog filter. + * This parameter can be: ENABLE or DISABLE. + * @note This function should be called before initializing and enabling + the I2C Peripheral. + * @retval None + */ +void I2C_AnalogFilterCmd(I2C_TypeDef* I2Cx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_I2C_ALL_PERIPH(I2Cx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + if (NewState != DISABLE) + { + /* Enable the analog filter */ + I2Cx->FLTR &= (uint16_t)~((uint16_t)I2C_FLTR_ANOFF); + } + else + { + /* Disable the analog filter */ + I2Cx->FLTR |= I2C_FLTR_ANOFF; + } +} + +/** + * @brief Configures the Digital noise filter of I2C peripheral. + * + * @note This function can be used only for STM32F42xxx/STM3243xxx, STM32F401xx and STM32F411xE devices. + * + * @param I2Cx: where x can be 1, 2 or 3 to select the I2C peripheral. + * @param I2C_DigitalFilter: Coefficient of digital noise filter. + * This parameter can be a number between 0x00 and 0x0F. + * @note This function should be called before initializing and enabling + the I2C Peripheral. + * @retval None + */ +void I2C_DigitalFilterConfig(I2C_TypeDef* I2Cx, uint16_t I2C_DigitalFilter) +{ + uint16_t tmpreg = 0; + + /* Check the parameters */ + assert_param(IS_I2C_ALL_PERIPH(I2Cx)); + assert_param(IS_I2C_DIGITAL_FILTER(I2C_DigitalFilter)); + + /* Get the old register value */ + tmpreg = I2Cx->FLTR; + + /* Reset I2Cx DNF bit [3:0] */ + tmpreg &= (uint16_t)~((uint16_t)I2C_FLTR_DNF); + + /* Set I2Cx DNF coefficient */ + tmpreg |= (uint16_t)((uint16_t)I2C_DigitalFilter & I2C_FLTR_DNF); + + /* Store the new register value */ + I2Cx->FLTR = tmpreg; +} + +/** + * @brief Generates I2Cx communication START condition. + * @param I2Cx: where x can be 1, 2 or 3 to select the I2C peripheral. + * @param NewState: new state of the I2C START condition generation. + * This parameter can be: ENABLE or DISABLE. + * @retval None. + */ +void I2C_GenerateSTART(I2C_TypeDef* I2Cx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_I2C_ALL_PERIPH(I2Cx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + if (NewState != DISABLE) + { + /* Generate a START condition */ + I2Cx->CR1 |= I2C_CR1_START; + } + else + { + /* Disable the START condition generation */ + I2Cx->CR1 &= (uint16_t)~((uint16_t)I2C_CR1_START); + } +} + +/** + * @brief Generates I2Cx communication STOP condition. + * @param I2Cx: where x can be 1, 2 or 3 to select the I2C peripheral. + * @param NewState: new state of the I2C STOP condition generation. + * This parameter can be: ENABLE or DISABLE. + * @retval None. + */ +void I2C_GenerateSTOP(I2C_TypeDef* I2Cx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_I2C_ALL_PERIPH(I2Cx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + if (NewState != DISABLE) + { + /* Generate a STOP condition */ + I2Cx->CR1 |= I2C_CR1_STOP; + } + else + { + /* Disable the STOP condition generation */ + I2Cx->CR1 &= (uint16_t)~((uint16_t)I2C_CR1_STOP); + } +} + +/** + * @brief Transmits the address byte to select the slave device. + * @param I2Cx: where x can be 1, 2 or 3 to select the I2C peripheral. + * @param Address: specifies the slave address which will be transmitted + * @param I2C_Direction: specifies whether the I2C device will be a Transmitter + * or a Receiver. + * This parameter can be one of the following values + * @arg I2C_Direction_Transmitter: Transmitter mode + * @arg I2C_Direction_Receiver: Receiver mode + * @retval None. + */ +void I2C_Send7bitAddress(I2C_TypeDef* I2Cx, uint8_t Address, uint8_t I2C_Direction) +{ + /* Check the parameters */ + assert_param(IS_I2C_ALL_PERIPH(I2Cx)); + assert_param(IS_I2C_DIRECTION(I2C_Direction)); + /* Test on the direction to set/reset the read/write bit */ + if (I2C_Direction != I2C_Direction_Transmitter) + { + /* Set the address bit0 for read */ + Address |= I2C_OAR1_ADD0; + } + else + { + /* Reset the address bit0 for write */ + Address &= (uint8_t)~((uint8_t)I2C_OAR1_ADD0); + } + /* Send the address */ + I2Cx->DR = Address; +} + +/** + * @brief Enables or disables the specified I2C acknowledge feature. + * @param I2Cx: where x can be 1, 2 or 3 to select the I2C peripheral. + * @param NewState: new state of the I2C Acknowledgement. + * This parameter can be: ENABLE or DISABLE. + * @retval None. + */ +void I2C_AcknowledgeConfig(I2C_TypeDef* I2Cx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_I2C_ALL_PERIPH(I2Cx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + if (NewState != DISABLE) + { + /* Enable the acknowledgement */ + I2Cx->CR1 |= I2C_CR1_ACK; + } + else + { + /* Disable the acknowledgement */ + I2Cx->CR1 &= (uint16_t)~((uint16_t)I2C_CR1_ACK); + } +} + +/** + * @brief Configures the specified I2C own address2. + * @param I2Cx: where x can be 1, 2 or 3 to select the I2C peripheral. + * @param Address: specifies the 7bit I2C own address2. + * @retval None. + */ +void I2C_OwnAddress2Config(I2C_TypeDef* I2Cx, uint8_t Address) +{ + uint16_t tmpreg = 0; + + /* Check the parameters */ + assert_param(IS_I2C_ALL_PERIPH(I2Cx)); + + /* Get the old register value */ + tmpreg = I2Cx->OAR2; + + /* Reset I2Cx Own address2 bit [7:1] */ + tmpreg &= (uint16_t)~((uint16_t)I2C_OAR2_ADD2); + + /* Set I2Cx Own address2 */ + tmpreg |= (uint16_t)((uint16_t)Address & (uint16_t)0x00FE); + + /* Store the new register value */ + I2Cx->OAR2 = tmpreg; +} + +/** + * @brief Enables or disables the specified I2C dual addressing mode. + * @param I2Cx: where x can be 1, 2 or 3 to select the I2C peripheral. + * @param NewState: new state of the I2C dual addressing mode. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void I2C_DualAddressCmd(I2C_TypeDef* I2Cx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_I2C_ALL_PERIPH(I2Cx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + if (NewState != DISABLE) + { + /* Enable dual addressing mode */ + I2Cx->OAR2 |= I2C_OAR2_ENDUAL; + } + else + { + /* Disable dual addressing mode */ + I2Cx->OAR2 &= (uint16_t)~((uint16_t)I2C_OAR2_ENDUAL); + } +} + +/** + * @brief Enables or disables the specified I2C general call feature. + * @param I2Cx: where x can be 1, 2 or 3 to select the I2C peripheral. + * @param NewState: new state of the I2C General call. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void I2C_GeneralCallCmd(I2C_TypeDef* I2Cx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_I2C_ALL_PERIPH(I2Cx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + if (NewState != DISABLE) + { + /* Enable generall call */ + I2Cx->CR1 |= I2C_CR1_ENGC; + } + else + { + /* Disable generall call */ + I2Cx->CR1 &= (uint16_t)~((uint16_t)I2C_CR1_ENGC); + } +} + +/** + * @brief Enables or disables the specified I2C software reset. + * @note When software reset is enabled, the I2C IOs are released (this can + * be useful to recover from bus errors). + * @param I2Cx: where x can be 1, 2 or 3 to select the I2C peripheral. + * @param NewState: new state of the I2C software reset. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void I2C_SoftwareResetCmd(I2C_TypeDef* I2Cx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_I2C_ALL_PERIPH(I2Cx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + if (NewState != DISABLE) + { + /* Peripheral under reset */ + I2Cx->CR1 |= I2C_CR1_SWRST; + } + else + { + /* Peripheral not under reset */ + I2Cx->CR1 &= (uint16_t)~((uint16_t)I2C_CR1_SWRST); + } +} + +/** + * @brief Enables or disables the specified I2C Clock stretching. + * @param I2Cx: where x can be 1, 2 or 3 to select the I2C peripheral. + * @param NewState: new state of the I2Cx Clock stretching. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void I2C_StretchClockCmd(I2C_TypeDef* I2Cx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_I2C_ALL_PERIPH(I2Cx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + if (NewState == DISABLE) + { + /* Enable the selected I2C Clock stretching */ + I2Cx->CR1 |= I2C_CR1_NOSTRETCH; + } + else + { + /* Disable the selected I2C Clock stretching */ + I2Cx->CR1 &= (uint16_t)~((uint16_t)I2C_CR1_NOSTRETCH); + } +} + +/** + * @brief Selects the specified I2C fast mode duty cycle. + * @param I2Cx: where x can be 1, 2 or 3 to select the I2C peripheral. + * @param I2C_DutyCycle: specifies the fast mode duty cycle. + * This parameter can be one of the following values: + * @arg I2C_DutyCycle_2: I2C fast mode Tlow/Thigh = 2 + * @arg I2C_DutyCycle_16_9: I2C fast mode Tlow/Thigh = 16/9 + * @retval None + */ +void I2C_FastModeDutyCycleConfig(I2C_TypeDef* I2Cx, uint16_t I2C_DutyCycle) +{ + /* Check the parameters */ + assert_param(IS_I2C_ALL_PERIPH(I2Cx)); + assert_param(IS_I2C_DUTY_CYCLE(I2C_DutyCycle)); + if (I2C_DutyCycle != I2C_DutyCycle_16_9) + { + /* I2C fast mode Tlow/Thigh=2 */ + I2Cx->CCR &= I2C_DutyCycle_2; + } + else + { + /* I2C fast mode Tlow/Thigh=16/9 */ + I2Cx->CCR |= I2C_DutyCycle_16_9; + } +} + +/** + * @brief Selects the specified I2C NACK position in master receiver mode. + * @note This function is useful in I2C Master Receiver mode when the number + * of data to be received is equal to 2. In this case, this function + * should be called (with parameter I2C_NACKPosition_Next) before data + * reception starts,as described in the 2-byte reception procedure + * recommended in Reference Manual in Section: Master receiver. + * @param I2Cx: where x can be 1, 2 or 3 to select the I2C peripheral. + * @param I2C_NACKPosition: specifies the NACK position. + * This parameter can be one of the following values: + * @arg I2C_NACKPosition_Next: indicates that the next byte will be the last + * received byte. + * @arg I2C_NACKPosition_Current: indicates that current byte is the last + * received byte. + * + * @note This function configures the same bit (POS) as I2C_PECPositionConfig() + * but is intended to be used in I2C mode while I2C_PECPositionConfig() + * is intended to used in SMBUS mode. + * + * @retval None + */ +void I2C_NACKPositionConfig(I2C_TypeDef* I2Cx, uint16_t I2C_NACKPosition) +{ + /* Check the parameters */ + assert_param(IS_I2C_ALL_PERIPH(I2Cx)); + assert_param(IS_I2C_NACK_POSITION(I2C_NACKPosition)); + + /* Check the input parameter */ + if (I2C_NACKPosition == I2C_NACKPosition_Next) + { + /* Next byte in shift register is the last received byte */ + I2Cx->CR1 |= I2C_NACKPosition_Next; + } + else + { + /* Current byte in shift register is the last received byte */ + I2Cx->CR1 &= I2C_NACKPosition_Current; + } +} + +/** + * @brief Drives the SMBusAlert pin high or low for the specified I2C. + * @param I2Cx: where x can be 1, 2 or 3 to select the I2C peripheral. + * @param I2C_SMBusAlert: specifies SMBAlert pin level. + * This parameter can be one of the following values: + * @arg I2C_SMBusAlert_Low: SMBAlert pin driven low + * @arg I2C_SMBusAlert_High: SMBAlert pin driven high + * @retval None + */ +void I2C_SMBusAlertConfig(I2C_TypeDef* I2Cx, uint16_t I2C_SMBusAlert) +{ + /* Check the parameters */ + assert_param(IS_I2C_ALL_PERIPH(I2Cx)); + assert_param(IS_I2C_SMBUS_ALERT(I2C_SMBusAlert)); + if (I2C_SMBusAlert == I2C_SMBusAlert_Low) + { + /* Drive the SMBusAlert pin Low */ + I2Cx->CR1 |= I2C_SMBusAlert_Low; + } + else + { + /* Drive the SMBusAlert pin High */ + I2Cx->CR1 &= I2C_SMBusAlert_High; + } +} + +/** + * @brief Enables or disables the specified I2C ARP. + * @param I2Cx: where x can be 1, 2 or 3 to select the I2C peripheral. + * @param NewState: new state of the I2Cx ARP. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void I2C_ARPCmd(I2C_TypeDef* I2Cx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_I2C_ALL_PERIPH(I2Cx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + if (NewState != DISABLE) + { + /* Enable the selected I2C ARP */ + I2Cx->CR1 |= I2C_CR1_ENARP; + } + else + { + /* Disable the selected I2C ARP */ + I2Cx->CR1 &= (uint16_t)~((uint16_t)I2C_CR1_ENARP); + } +} +/** + * @} + */ + +/** @defgroup I2C_Group2 Data transfers functions + * @brief Data transfers functions + * +@verbatim + =============================================================================== + ##### Data transfers functions ##### + =============================================================================== + +@endverbatim + * @{ + */ + +/** + * @brief Sends a data byte through the I2Cx peripheral. + * @param I2Cx: where x can be 1, 2 or 3 to select the I2C peripheral. + * @param Data: Byte to be transmitted.. + * @retval None + */ +void I2C_SendData(I2C_TypeDef* I2Cx, uint8_t Data) +{ + /* Check the parameters */ + assert_param(IS_I2C_ALL_PERIPH(I2Cx)); + /* Write in the DR register the data to be sent */ + I2Cx->DR = Data; +} + +/** + * @brief Returns the most recent received data by the I2Cx peripheral. + * @param I2Cx: where x can be 1, 2 or 3 to select the I2C peripheral. + * @retval The value of the received data. + */ +uint8_t I2C_ReceiveData(I2C_TypeDef* I2Cx) +{ + /* Check the parameters */ + assert_param(IS_I2C_ALL_PERIPH(I2Cx)); + /* Return the data in the DR register */ + return (uint8_t)I2Cx->DR; +} + +/** + * @} + */ + +/** @defgroup I2C_Group3 PEC management functions + * @brief PEC management functions + * +@verbatim + =============================================================================== + ##### PEC management functions ##### + =============================================================================== + +@endverbatim + * @{ + */ + +/** + * @brief Enables or disables the specified I2C PEC transfer. + * @param I2Cx: where x can be 1, 2 or 3 to select the I2C peripheral. + * @param NewState: new state of the I2C PEC transmission. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void I2C_TransmitPEC(I2C_TypeDef* I2Cx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_I2C_ALL_PERIPH(I2Cx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + if (NewState != DISABLE) + { + /* Enable the selected I2C PEC transmission */ + I2Cx->CR1 |= I2C_CR1_PEC; + } + else + { + /* Disable the selected I2C PEC transmission */ + I2Cx->CR1 &= (uint16_t)~((uint16_t)I2C_CR1_PEC); + } +} + +/** + * @brief Selects the specified I2C PEC position. + * @param I2Cx: where x can be 1, 2 or 3 to select the I2C peripheral. + * @param I2C_PECPosition: specifies the PEC position. + * This parameter can be one of the following values: + * @arg I2C_PECPosition_Next: indicates that the next byte is PEC + * @arg I2C_PECPosition_Current: indicates that current byte is PEC + * + * @note This function configures the same bit (POS) as I2C_NACKPositionConfig() + * but is intended to be used in SMBUS mode while I2C_NACKPositionConfig() + * is intended to used in I2C mode. + * + * @retval None + */ +void I2C_PECPositionConfig(I2C_TypeDef* I2Cx, uint16_t I2C_PECPosition) +{ + /* Check the parameters */ + assert_param(IS_I2C_ALL_PERIPH(I2Cx)); + assert_param(IS_I2C_PEC_POSITION(I2C_PECPosition)); + if (I2C_PECPosition == I2C_PECPosition_Next) + { + /* Next byte in shift register is PEC */ + I2Cx->CR1 |= I2C_PECPosition_Next; + } + else + { + /* Current byte in shift register is PEC */ + I2Cx->CR1 &= I2C_PECPosition_Current; + } +} + +/** + * @brief Enables or disables the PEC value calculation of the transferred bytes. + * @param I2Cx: where x can be 1, 2 or 3 to select the I2C peripheral. + * @param NewState: new state of the I2Cx PEC value calculation. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void I2C_CalculatePEC(I2C_TypeDef* I2Cx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_I2C_ALL_PERIPH(I2Cx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + if (NewState != DISABLE) + { + /* Enable the selected I2C PEC calculation */ + I2Cx->CR1 |= I2C_CR1_ENPEC; + } + else + { + /* Disable the selected I2C PEC calculation */ + I2Cx->CR1 &= (uint16_t)~((uint16_t)I2C_CR1_ENPEC); + } +} + +/** + * @brief Returns the PEC value for the specified I2C. + * @param I2Cx: where x can be 1, 2 or 3 to select the I2C peripheral. + * @retval The PEC value. + */ +uint8_t I2C_GetPEC(I2C_TypeDef* I2Cx) +{ + /* Check the parameters */ + assert_param(IS_I2C_ALL_PERIPH(I2Cx)); + /* Return the selected I2C PEC value */ + return ((I2Cx->SR2) >> 8); +} + +/** + * @} + */ + +/** @defgroup I2C_Group4 DMA transfers management functions + * @brief DMA transfers management functions + * +@verbatim + =============================================================================== + ##### DMA transfers management functions ##### + =============================================================================== + This section provides functions allowing to configure the I2C DMA channels + requests. + +@endverbatim + * @{ + */ + +/** + * @brief Enables or disables the specified I2C DMA requests. + * @param I2Cx: where x can be 1, 2 or 3 to select the I2C peripheral. + * @param NewState: new state of the I2C DMA transfer. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void I2C_DMACmd(I2C_TypeDef* I2Cx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_I2C_ALL_PERIPH(I2Cx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + if (NewState != DISABLE) + { + /* Enable the selected I2C DMA requests */ + I2Cx->CR2 |= I2C_CR2_DMAEN; + } + else + { + /* Disable the selected I2C DMA requests */ + I2Cx->CR2 &= (uint16_t)~((uint16_t)I2C_CR2_DMAEN); + } +} + +/** + * @brief Specifies that the next DMA transfer is the last one. + * @param I2Cx: where x can be 1, 2 or 3 to select the I2C peripheral. + * @param NewState: new state of the I2C DMA last transfer. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void I2C_DMALastTransferCmd(I2C_TypeDef* I2Cx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_I2C_ALL_PERIPH(I2Cx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + if (NewState != DISABLE) + { + /* Next DMA transfer is the last transfer */ + I2Cx->CR2 |= I2C_CR2_LAST; + } + else + { + /* Next DMA transfer is not the last transfer */ + I2Cx->CR2 &= (uint16_t)~((uint16_t)I2C_CR2_LAST); + } +} + +/** + * @} + */ + +/** @defgroup I2C_Group5 Interrupts events and flags management functions + * @brief Interrupts, events and flags management functions + * +@verbatim + =============================================================================== + ##### Interrupts, events and flags management functions ##### + =============================================================================== + [..] + This section provides functions allowing to configure the I2C Interrupts + sources and check or clear the flags or pending bits status. + The user should identify which mode will be used in his application to manage + the communication: Polling mode, Interrupt mode or DMA mode. + + + ##### I2C State Monitoring Functions ##### + =============================================================================== + [..] + This I2C driver provides three different ways for I2C state monitoring + depending on the application requirements and constraints: + + + (#) Basic state monitoring (Using I2C_CheckEvent() function) + + It compares the status registers (SR1 and SR2) content to a given event + (can be the combination of one or more flags). + It returns SUCCESS if the current status includes the given flags + and returns ERROR if one or more flags are missing in the current status. + + (++) When to use + (+++) This function is suitable for most applications as well as for startup + activity since the events are fully described in the product reference + manual (RM0090). + (+++) It is also suitable for users who need to define their own events. + + (++) Limitations + If an error occurs (ie. error flags are set besides to the monitored + flags), the I2C_CheckEvent() function may return SUCCESS despite + the communication hold or corrupted real state. + In this case, it is advised to use error interrupts to monitor + the error events and handle them in the interrupt IRQ handler. + + -@@- For error management, it is advised to use the following functions: + (+@@) I2C_ITConfig() to configure and enable the error interrupts (I2C_IT_ERR). + (+@@) I2Cx_ER_IRQHandler() which is called when the error interrupt occurs. + Where x is the peripheral instance (I2C1, I2C2 ...) + (+@@) I2C_GetFlagStatus() or I2C_GetITStatus() to be called into the + I2Cx_ER_IRQHandler() function in order to determine which error occurred. + (+@@) I2C_ClearFlag() or I2C_ClearITPendingBit() and/or I2C_SoftwareResetCmd() + and/or I2C_GenerateStop() in order to clear the error flag and source + and return to correct communication status. + + + (#) Advanced state monitoring (Using the function I2C_GetLastEvent()) + + Using the function I2C_GetLastEvent() which returns the image of both status + registers in a single word (uint32_t) (Status Register 2 value is shifted left + by 16 bits and concatenated to Status Register 1). + + (++) When to use + (+++) This function is suitable for the same applications above but it + allows to overcome the mentioned limitation of I2C_GetFlagStatus() + function. + (+++) The returned value could be compared to events already defined in + the library (stm32f4xx_i2c.h) or to custom values defined by user. + This function is suitable when multiple flags are monitored at the + same time. + (+++) At the opposite of I2C_CheckEvent() function, this function allows + user to choose when an event is accepted (when all events flags are + set and no other flags are set or just when the needed flags are set + like I2C_CheckEvent() function. + + (++) Limitations + (+++) User may need to define his own events. + (+++) Same remark concerning the error management is applicable for this + function if user decides to check only regular communication flags + (and ignores error flags). + + + (#) Flag-based state monitoring (Using the function I2C_GetFlagStatus()) + + Using the function I2C_GetFlagStatus() which simply returns the status of + one single flag (ie. I2C_FLAG_RXNE ...). + + (++) When to use + (+++) This function could be used for specific applications or in debug + phase. + (+++) It is suitable when only one flag checking is needed (most I2C + events are monitored through multiple flags). + (++) Limitations: + (+++) When calling this function, the Status register is accessed. + Some flags are cleared when the status register is accessed. + So checking the status of one Flag, may clear other ones. + (+++) Function may need to be called twice or more in order to monitor + one single event. + + For detailed description of Events, please refer to section I2C_Events in + stm32f4xx_i2c.h file. + +@endverbatim + * @{ + */ + +/** + * @brief Reads the specified I2C register and returns its value. + * @param I2C_Register: specifies the register to read. + * This parameter can be one of the following values: + * @arg I2C_Register_CR1: CR1 register. + * @arg I2C_Register_CR2: CR2 register. + * @arg I2C_Register_OAR1: OAR1 register. + * @arg I2C_Register_OAR2: OAR2 register. + * @arg I2C_Register_DR: DR register. + * @arg I2C_Register_SR1: SR1 register. + * @arg I2C_Register_SR2: SR2 register. + * @arg I2C_Register_CCR: CCR register. + * @arg I2C_Register_TRISE: TRISE register. + * @retval The value of the read register. + */ +uint16_t I2C_ReadRegister(I2C_TypeDef* I2Cx, uint8_t I2C_Register) +{ + __IO uint32_t tmp = 0; + + /* Check the parameters */ + assert_param(IS_I2C_ALL_PERIPH(I2Cx)); + assert_param(IS_I2C_REGISTER(I2C_Register)); + + tmp = (uint32_t) I2Cx; + tmp += I2C_Register; + + /* Return the selected register value */ + return (*(__IO uint16_t *) tmp); +} + +/** + * @brief Enables or disables the specified I2C interrupts. + * @param I2Cx: where x can be 1, 2 or 3 to select the I2C peripheral. + * @param I2C_IT: specifies the I2C interrupts sources to be enabled or disabled. + * This parameter can be any combination of the following values: + * @arg I2C_IT_BUF: Buffer interrupt mask + * @arg I2C_IT_EVT: Event interrupt mask + * @arg I2C_IT_ERR: Error interrupt mask + * @param NewState: new state of the specified I2C interrupts. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void I2C_ITConfig(I2C_TypeDef* I2Cx, uint16_t I2C_IT, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_I2C_ALL_PERIPH(I2Cx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + assert_param(IS_I2C_CONFIG_IT(I2C_IT)); + + if (NewState != DISABLE) + { + /* Enable the selected I2C interrupts */ + I2Cx->CR2 |= I2C_IT; + } + else + { + /* Disable the selected I2C interrupts */ + I2Cx->CR2 &= (uint16_t)~I2C_IT; + } +} + +/* + =============================================================================== + 1. Basic state monitoring + =============================================================================== + */ + +/** + * @brief Checks whether the last I2Cx Event is equal to the one passed + * as parameter. + * @param I2Cx: where x can be 1, 2 or 3 to select the I2C peripheral. + * @param I2C_EVENT: specifies the event to be checked. + * This parameter can be one of the following values: + * @arg I2C_EVENT_SLAVE_TRANSMITTER_ADDRESS_MATCHED: EV1 + * @arg I2C_EVENT_SLAVE_RECEIVER_ADDRESS_MATCHED: EV1 + * @arg I2C_EVENT_SLAVE_TRANSMITTER_SECONDADDRESS_MATCHED: EV1 + * @arg I2C_EVENT_SLAVE_RECEIVER_SECONDADDRESS_MATCHED: EV1 + * @arg I2C_EVENT_SLAVE_GENERALCALLADDRESS_MATCHED: EV1 + * @arg I2C_EVENT_SLAVE_BYTE_RECEIVED: EV2 + * @arg (I2C_EVENT_SLAVE_BYTE_RECEIVED | I2C_FLAG_DUALF): EV2 + * @arg (I2C_EVENT_SLAVE_BYTE_RECEIVED | I2C_FLAG_GENCALL): EV2 + * @arg I2C_EVENT_SLAVE_BYTE_TRANSMITTED: EV3 + * @arg (I2C_EVENT_SLAVE_BYTE_TRANSMITTED | I2C_FLAG_DUALF): EV3 + * @arg (I2C_EVENT_SLAVE_BYTE_TRANSMITTED | I2C_FLAG_GENCALL): EV3 + * @arg I2C_EVENT_SLAVE_ACK_FAILURE: EV3_2 + * @arg I2C_EVENT_SLAVE_STOP_DETECTED: EV4 + * @arg I2C_EVENT_MASTER_MODE_SELECT: EV5 + * @arg I2C_EVENT_MASTER_TRANSMITTER_MODE_SELECTED: EV6 + * @arg I2C_EVENT_MASTER_RECEIVER_MODE_SELECTED: EV6 + * @arg I2C_EVENT_MASTER_BYTE_RECEIVED: EV7 + * @arg I2C_EVENT_MASTER_BYTE_TRANSMITTING: EV8 + * @arg I2C_EVENT_MASTER_BYTE_TRANSMITTED: EV8_2 + * @arg I2C_EVENT_MASTER_MODE_ADDRESS10: EV9 + * + * @note For detailed description of Events, please refer to section I2C_Events + * in stm32f4xx_i2c.h file. + * + * @retval An ErrorStatus enumeration value: + * - SUCCESS: Last event is equal to the I2C_EVENT + * - ERROR: Last event is different from the I2C_EVENT + */ +ErrorStatus I2C_CheckEvent(I2C_TypeDef* I2Cx, uint32_t I2C_EVENT) +{ + uint32_t lastevent = 0; + uint32_t flag1 = 0, flag2 = 0; + ErrorStatus status = ERROR; + + /* Check the parameters */ + assert_param(IS_I2C_ALL_PERIPH(I2Cx)); + assert_param(IS_I2C_EVENT(I2C_EVENT)); + + /* Read the I2Cx status register */ + flag1 = I2Cx->SR1; + flag2 = I2Cx->SR2; + flag2 = flag2 << 16; + + /* Get the last event value from I2C status register */ + lastevent = (flag1 | flag2) & FLAG_MASK; + + /* Check whether the last event contains the I2C_EVENT */ + if ((lastevent & I2C_EVENT) == I2C_EVENT) + { + /* SUCCESS: last event is equal to I2C_EVENT */ + status = SUCCESS; + } + else + { + /* ERROR: last event is different from I2C_EVENT */ + status = ERROR; + } + /* Return status */ + return status; +} + +/* + =============================================================================== + 2. Advanced state monitoring + =============================================================================== + */ + +/** + * @brief Returns the last I2Cx Event. + * @param I2Cx: where x can be 1, 2 or 3 to select the I2C peripheral. + * + * @note For detailed description of Events, please refer to section I2C_Events + * in stm32f4xx_i2c.h file. + * + * @retval The last event + */ +uint32_t I2C_GetLastEvent(I2C_TypeDef* I2Cx) +{ + uint32_t lastevent = 0; + uint32_t flag1 = 0, flag2 = 0; + + /* Check the parameters */ + assert_param(IS_I2C_ALL_PERIPH(I2Cx)); + + /* Read the I2Cx status register */ + flag1 = I2Cx->SR1; + flag2 = I2Cx->SR2; + flag2 = flag2 << 16; + + /* Get the last event value from I2C status register */ + lastevent = (flag1 | flag2) & FLAG_MASK; + + /* Return status */ + return lastevent; +} + +/* + =============================================================================== + 3. Flag-based state monitoring + =============================================================================== + */ + +/** + * @brief Checks whether the specified I2C flag is set or not. + * @param I2Cx: where x can be 1, 2 or 3 to select the I2C peripheral. + * @param I2C_FLAG: specifies the flag to check. + * This parameter can be one of the following values: + * @arg I2C_FLAG_DUALF: Dual flag (Slave mode) + * @arg I2C_FLAG_SMBHOST: SMBus host header (Slave mode) + * @arg I2C_FLAG_SMBDEFAULT: SMBus default header (Slave mode) + * @arg I2C_FLAG_GENCALL: General call header flag (Slave mode) + * @arg I2C_FLAG_TRA: Transmitter/Receiver flag + * @arg I2C_FLAG_BUSY: Bus busy flag + * @arg I2C_FLAG_MSL: Master/Slave flag + * @arg I2C_FLAG_SMBALERT: SMBus Alert flag + * @arg I2C_FLAG_TIMEOUT: Timeout or Tlow error flag + * @arg I2C_FLAG_PECERR: PEC error in reception flag + * @arg I2C_FLAG_OVR: Overrun/Underrun flag (Slave mode) + * @arg I2C_FLAG_AF: Acknowledge failure flag + * @arg I2C_FLAG_ARLO: Arbitration lost flag (Master mode) + * @arg I2C_FLAG_BERR: Bus error flag + * @arg I2C_FLAG_TXE: Data register empty flag (Transmitter) + * @arg I2C_FLAG_RXNE: Data register not empty (Receiver) flag + * @arg I2C_FLAG_STOPF: Stop detection flag (Slave mode) + * @arg I2C_FLAG_ADD10: 10-bit header sent flag (Master mode) + * @arg I2C_FLAG_BTF: Byte transfer finished flag + * @arg I2C_FLAG_ADDR: Address sent flag (Master mode) "ADSL" + * Address matched flag (Slave mode)"ENDAD" + * @arg I2C_FLAG_SB: Start bit flag (Master mode) + * @retval The new state of I2C_FLAG (SET or RESET). + */ +FlagStatus I2C_GetFlagStatus(I2C_TypeDef* I2Cx, uint32_t I2C_FLAG) +{ + FlagStatus bitstatus = RESET; + __IO uint32_t i2creg = 0, i2cxbase = 0; + + /* Check the parameters */ + assert_param(IS_I2C_ALL_PERIPH(I2Cx)); + assert_param(IS_I2C_GET_FLAG(I2C_FLAG)); + + /* Get the I2Cx peripheral base address */ + i2cxbase = (uint32_t)I2Cx; + + /* Read flag register index */ + i2creg = I2C_FLAG >> 28; + + /* Get bit[23:0] of the flag */ + I2C_FLAG &= FLAG_MASK; + + if(i2creg != 0) + { + /* Get the I2Cx SR1 register address */ + i2cxbase += 0x14; + } + else + { + /* Flag in I2Cx SR2 Register */ + I2C_FLAG = (uint32_t)(I2C_FLAG >> 16); + /* Get the I2Cx SR2 register address */ + i2cxbase += 0x18; + } + + if(((*(__IO uint32_t *)i2cxbase) & I2C_FLAG) != (uint32_t)RESET) + { + /* I2C_FLAG is set */ + bitstatus = SET; + } + else + { + /* I2C_FLAG is reset */ + bitstatus = RESET; + } + + /* Return the I2C_FLAG status */ + return bitstatus; +} + +/** + * @brief Clears the I2Cx's pending flags. + * @param I2Cx: where x can be 1, 2 or 3 to select the I2C peripheral. + * @param I2C_FLAG: specifies the flag to clear. + * This parameter can be any combination of the following values: + * @arg I2C_FLAG_SMBALERT: SMBus Alert flag + * @arg I2C_FLAG_TIMEOUT: Timeout or Tlow error flag + * @arg I2C_FLAG_PECERR: PEC error in reception flag + * @arg I2C_FLAG_OVR: Overrun/Underrun flag (Slave mode) + * @arg I2C_FLAG_AF: Acknowledge failure flag + * @arg I2C_FLAG_ARLO: Arbitration lost flag (Master mode) + * @arg I2C_FLAG_BERR: Bus error flag + * + * @note STOPF (STOP detection) is cleared by software sequence: a read operation + * to I2C_SR1 register (I2C_GetFlagStatus()) followed by a write operation + * to I2C_CR1 register (I2C_Cmd() to re-enable the I2C peripheral). + * @note ADD10 (10-bit header sent) is cleared by software sequence: a read + * operation to I2C_SR1 (I2C_GetFlagStatus()) followed by writing the + * second byte of the address in DR register. + * @note BTF (Byte Transfer Finished) is cleared by software sequence: a read + * operation to I2C_SR1 register (I2C_GetFlagStatus()) followed by a + * read/write to I2C_DR register (I2C_SendData()). + * @note ADDR (Address sent) is cleared by software sequence: a read operation to + * I2C_SR1 register (I2C_GetFlagStatus()) followed by a read operation to + * I2C_SR2 register ((void)(I2Cx->SR2)). + * @note SB (Start Bit) is cleared software sequence: a read operation to I2C_SR1 + * register (I2C_GetFlagStatus()) followed by a write operation to I2C_DR + * register (I2C_SendData()). + * + * @retval None + */ +void I2C_ClearFlag(I2C_TypeDef* I2Cx, uint32_t I2C_FLAG) +{ + uint32_t flagpos = 0; + /* Check the parameters */ + assert_param(IS_I2C_ALL_PERIPH(I2Cx)); + assert_param(IS_I2C_CLEAR_FLAG(I2C_FLAG)); + /* Get the I2C flag position */ + flagpos = I2C_FLAG & FLAG_MASK; + /* Clear the selected I2C flag */ + I2Cx->SR1 = (uint16_t)~flagpos; +} + +/** + * @brief Checks whether the specified I2C interrupt has occurred or not. + * @param I2Cx: where x can be 1, 2 or 3 to select the I2C peripheral. + * @param I2C_IT: specifies the interrupt source to check. + * This parameter can be one of the following values: + * @arg I2C_IT_SMBALERT: SMBus Alert flag + * @arg I2C_IT_TIMEOUT: Timeout or Tlow error flag + * @arg I2C_IT_PECERR: PEC error in reception flag + * @arg I2C_IT_OVR: Overrun/Underrun flag (Slave mode) + * @arg I2C_IT_AF: Acknowledge failure flag + * @arg I2C_IT_ARLO: Arbitration lost flag (Master mode) + * @arg I2C_IT_BERR: Bus error flag + * @arg I2C_IT_TXE: Data register empty flag (Transmitter) + * @arg I2C_IT_RXNE: Data register not empty (Receiver) flag + * @arg I2C_IT_STOPF: Stop detection flag (Slave mode) + * @arg I2C_IT_ADD10: 10-bit header sent flag (Master mode) + * @arg I2C_IT_BTF: Byte transfer finished flag + * @arg I2C_IT_ADDR: Address sent flag (Master mode) "ADSL" + * Address matched flag (Slave mode)"ENDAD" + * @arg I2C_IT_SB: Start bit flag (Master mode) + * @retval The new state of I2C_IT (SET or RESET). + */ +ITStatus I2C_GetITStatus(I2C_TypeDef* I2Cx, uint32_t I2C_IT) +{ + ITStatus bitstatus = RESET; + uint32_t enablestatus = 0; + + /* Check the parameters */ + assert_param(IS_I2C_ALL_PERIPH(I2Cx)); + assert_param(IS_I2C_GET_IT(I2C_IT)); + + /* Check if the interrupt source is enabled or not */ + enablestatus = (uint32_t)(((I2C_IT & ITEN_MASK) >> 16) & (I2Cx->CR2)) ; + + /* Get bit[23:0] of the flag */ + I2C_IT &= FLAG_MASK; + + /* Check the status of the specified I2C flag */ + if (((I2Cx->SR1 & I2C_IT) != (uint32_t)RESET) && enablestatus) + { + /* I2C_IT is set */ + bitstatus = SET; + } + else + { + /* I2C_IT is reset */ + bitstatus = RESET; + } + /* Return the I2C_IT status */ + return bitstatus; +} + +/** + * @brief Clears the I2Cx's interrupt pending bits. + * @param I2Cx: where x can be 1, 2 or 3 to select the I2C peripheral. + * @param I2C_IT: specifies the interrupt pending bit to clear. + * This parameter can be any combination of the following values: + * @arg I2C_IT_SMBALERT: SMBus Alert interrupt + * @arg I2C_IT_TIMEOUT: Timeout or Tlow error interrupt + * @arg I2C_IT_PECERR: PEC error in reception interrupt + * @arg I2C_IT_OVR: Overrun/Underrun interrupt (Slave mode) + * @arg I2C_IT_AF: Acknowledge failure interrupt + * @arg I2C_IT_ARLO: Arbitration lost interrupt (Master mode) + * @arg I2C_IT_BERR: Bus error interrupt + * + * @note STOPF (STOP detection) is cleared by software sequence: a read operation + * to I2C_SR1 register (I2C_GetITStatus()) followed by a write operation to + * I2C_CR1 register (I2C_Cmd() to re-enable the I2C peripheral). + * @note ADD10 (10-bit header sent) is cleared by software sequence: a read + * operation to I2C_SR1 (I2C_GetITStatus()) followed by writing the second + * byte of the address in I2C_DR register. + * @note BTF (Byte Transfer Finished) is cleared by software sequence: a read + * operation to I2C_SR1 register (I2C_GetITStatus()) followed by a + * read/write to I2C_DR register (I2C_SendData()). + * @note ADDR (Address sent) is cleared by software sequence: a read operation to + * I2C_SR1 register (I2C_GetITStatus()) followed by a read operation to + * I2C_SR2 register ((void)(I2Cx->SR2)). + * @note SB (Start Bit) is cleared by software sequence: a read operation to + * I2C_SR1 register (I2C_GetITStatus()) followed by a write operation to + * I2C_DR register (I2C_SendData()). + * @retval None + */ +void I2C_ClearITPendingBit(I2C_TypeDef* I2Cx, uint32_t I2C_IT) +{ + uint32_t flagpos = 0; + /* Check the parameters */ + assert_param(IS_I2C_ALL_PERIPH(I2Cx)); + assert_param(IS_I2C_CLEAR_IT(I2C_IT)); + + /* Get the I2C flag position */ + flagpos = I2C_IT & FLAG_MASK; + + /* Clear the selected I2C flag */ + I2Cx->SR1 = (uint16_t)~flagpos; +} + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/src/stm32f4xx_iwdg.c b/FWLIB/src/stm32f4xx_iwdg.c new file mode 100644 index 0000000..4adc69b --- /dev/null +++ b/FWLIB/src/stm32f4xx_iwdg.c @@ -0,0 +1,266 @@ +/** + ****************************************************************************** + * @file stm32f4xx_iwdg.c + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file provides firmware functions to manage the following + * functionalities of the Independent watchdog (IWDG) peripheral: + * + Prescaler and Counter configuration + * + IWDG activation + * + Flag management + * + @verbatim + =============================================================================== + ##### IWDG features ##### + =============================================================================== + [..] + The IWDG can be started by either software or hardware (configurable + through option byte). + + The IWDG is clocked by its own dedicated low-speed clock (LSI) and + thus stays active even if the main clock fails. + Once the IWDG is started, the LSI is forced ON and cannot be disabled + (LSI cannot be disabled too), and the counter starts counting down from + the reset value of 0xFFF. When it reaches the end of count value (0x000) + a system reset is generated. + The IWDG counter should be reloaded at regular intervals to prevent + an MCU reset. + + The IWDG is implemented in the VDD voltage domain that is still functional + in STOP and STANDBY mode (IWDG reset can wake-up from STANDBY). + + IWDGRST flag in RCC_CSR register can be used to inform when a IWDG + reset occurs. + + Min-max timeout value @32KHz (LSI): ~125us / ~32.7s + The IWDG timeout may vary due to LSI frequency dispersion. STM32F4xx + devices provide the capability to measure the LSI frequency (LSI clock + connected internally to TIM5 CH4 input capture). The measured value + can be used to have an IWDG timeout with an acceptable accuracy. + For more information, please refer to the STM32F4xx Reference manual + + ##### How to use this driver ##### + =============================================================================== + [..] + (#) Enable write access to IWDG_PR and IWDG_RLR registers using + IWDG_WriteAccessCmd(IWDG_WriteAccess_Enable) function + + (#) Configure the IWDG prescaler using IWDG_SetPrescaler() function + + (#) Configure the IWDG counter value using IWDG_SetReload() function. + This value will be loaded in the IWDG counter each time the counter + is reloaded, then the IWDG will start counting down from this value. + + (#) Start the IWDG using IWDG_Enable() function, when the IWDG is used + in software mode (no need to enable the LSI, it will be enabled + by hardware) + + (#) Then the application program must reload the IWDG counter at regular + intervals during normal operation to prevent an MCU reset, using + IWDG_ReloadCounter() function. + + @endverbatim + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx_iwdg.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @defgroup IWDG + * @brief IWDG driver modules + * @{ + */ + +/* Private typedef -----------------------------------------------------------*/ +/* Private define ------------------------------------------------------------*/ + +/* KR register bit mask */ +#define KR_KEY_RELOAD ((uint16_t)0xAAAA) +#define KR_KEY_ENABLE ((uint16_t)0xCCCC) + +/* Private macro -------------------------------------------------------------*/ +/* Private variables ---------------------------------------------------------*/ +/* Private function prototypes -----------------------------------------------*/ +/* Private functions ---------------------------------------------------------*/ + +/** @defgroup IWDG_Private_Functions + * @{ + */ + +/** @defgroup IWDG_Group1 Prescaler and Counter configuration functions + * @brief Prescaler and Counter configuration functions + * +@verbatim + =============================================================================== + ##### Prescaler and Counter configuration functions ##### + =============================================================================== + +@endverbatim + * @{ + */ + +/** + * @brief Enables or disables write access to IWDG_PR and IWDG_RLR registers. + * @param IWDG_WriteAccess: new state of write access to IWDG_PR and IWDG_RLR registers. + * This parameter can be one of the following values: + * @arg IWDG_WriteAccess_Enable: Enable write access to IWDG_PR and IWDG_RLR registers + * @arg IWDG_WriteAccess_Disable: Disable write access to IWDG_PR and IWDG_RLR registers + * @retval None + */ +void IWDG_WriteAccessCmd(uint16_t IWDG_WriteAccess) +{ + /* Check the parameters */ + assert_param(IS_IWDG_WRITE_ACCESS(IWDG_WriteAccess)); + IWDG->KR = IWDG_WriteAccess; +} + +/** + * @brief Sets IWDG Prescaler value. + * @param IWDG_Prescaler: specifies the IWDG Prescaler value. + * This parameter can be one of the following values: + * @arg IWDG_Prescaler_4: IWDG prescaler set to 4 + * @arg IWDG_Prescaler_8: IWDG prescaler set to 8 + * @arg IWDG_Prescaler_16: IWDG prescaler set to 16 + * @arg IWDG_Prescaler_32: IWDG prescaler set to 32 + * @arg IWDG_Prescaler_64: IWDG prescaler set to 64 + * @arg IWDG_Prescaler_128: IWDG prescaler set to 128 + * @arg IWDG_Prescaler_256: IWDG prescaler set to 256 + * @retval None + */ +void IWDG_SetPrescaler(uint8_t IWDG_Prescaler) +{ + /* Check the parameters */ + assert_param(IS_IWDG_PRESCALER(IWDG_Prescaler)); + IWDG->PR = IWDG_Prescaler; +} + +/** + * @brief Sets IWDG Reload value. + * @param Reload: specifies the IWDG Reload value. + * This parameter must be a number between 0 and 0x0FFF. + * @retval None + */ +void IWDG_SetReload(uint16_t Reload) +{ + /* Check the parameters */ + assert_param(IS_IWDG_RELOAD(Reload)); + IWDG->RLR = Reload; +} + +/** + * @brief Reloads IWDG counter with value defined in the reload register + * (write access to IWDG_PR and IWDG_RLR registers disabled). + * @param None + * @retval None + */ +void IWDG_ReloadCounter(void) +{ + IWDG->KR = KR_KEY_RELOAD; +} + +/** + * @} + */ + +/** @defgroup IWDG_Group2 IWDG activation function + * @brief IWDG activation function + * +@verbatim + =============================================================================== + ##### IWDG activation function ##### + =============================================================================== + +@endverbatim + * @{ + */ + +/** + * @brief Enables IWDG (write access to IWDG_PR and IWDG_RLR registers disabled). + * @param None + * @retval None + */ +void IWDG_Enable(void) +{ + IWDG->KR = KR_KEY_ENABLE; +} + +/** + * @} + */ + +/** @defgroup IWDG_Group3 Flag management function + * @brief Flag management function + * +@verbatim + =============================================================================== + ##### Flag management function ##### + =============================================================================== + +@endverbatim + * @{ + */ + +/** + * @brief Checks whether the specified IWDG flag is set or not. + * @param IWDG_FLAG: specifies the flag to check. + * This parameter can be one of the following values: + * @arg IWDG_FLAG_PVU: Prescaler Value Update on going + * @arg IWDG_FLAG_RVU: Reload Value Update on going + * @retval The new state of IWDG_FLAG (SET or RESET). + */ +FlagStatus IWDG_GetFlagStatus(uint16_t IWDG_FLAG) +{ + FlagStatus bitstatus = RESET; + /* Check the parameters */ + assert_param(IS_IWDG_FLAG(IWDG_FLAG)); + if ((IWDG->SR & IWDG_FLAG) != (uint32_t)RESET) + { + bitstatus = SET; + } + else + { + bitstatus = RESET; + } + /* Return the flag status */ + return bitstatus; +} + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/src/stm32f4xx_ltdc.c b/FWLIB/src/stm32f4xx_ltdc.c new file mode 100644 index 0000000..ded1928 --- /dev/null +++ b/FWLIB/src/stm32f4xx_ltdc.c @@ -0,0 +1,1110 @@ +/** + ****************************************************************************** + * @file stm32f4xx_ltdc.c + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file provides firmware functions to manage the following + * functionalities of the LTDC controller (LTDC) peripheral: + * + Initialization and configuration + * + Interrupts and flags management + * + * @verbatim + + =============================================================================== + ##### How to use this driver ##### + =============================================================================== + [..] + (#) Enable LTDC clock using + RCC_APB2PeriphResetCmd(RCC_APB2Periph_LTDC, ENABLE) function. + (#) Configures LTDC + (++) Configure the required Pixel clock following the panel datasheet + (++) Configure the Synchronous timings: VSYNC, HSYNC, Vertical and + Horizontal back proch, active data area and the front proch + timings + (++) Configure the synchronous signals and clock polarity in the + LTDC_GCR register + (#) Configures Layer1/2 parameters + (++) The Layer window horizontal and vertical position in the LTDC_LxWHPCR and + LTDC_WVPCR registers. The layer window must be in the active data area. + (++) The pixel input format in the LTDC_LxPFCR register + (++) The color frame buffer start address in the LTDC_LxCFBAR register + (++) The line length and pitch of the color frame buffer in the + LTDC_LxCFBLR register + (++) The number of lines of the color frame buffer in + the LTDC_LxCFBLNR register + (++) if needed, load the CLUT with the RGB values and the address + in the LTDC_LxCLUTWR register + (++) If needed, configure the default color and the blending factors + respectively in the LTDC_LxDCCR and LTDC_LxBFCR registers + + (++) If needed, Dithering and color keying can be be enabled respectively + in the LTDC_GCR and LTDC_LxCKCR registers. It can be also enabled + on the fly. + (#) Enable Layer1/2 and if needed the CLUT in the LTDC_LxCR register + + (#) Reload the shadow registers to active register through + the LTDC_SRCR register. + -@- All layer parameters can be be modified on the fly except the CLUT. + The new configuration has to be either reloaded immediately + or during vertical blanking period by configuring the LTDC_SRCR register. + (#) Call the LTDC_Cmd() to enable the LTDC controller. + + @endverbatim + + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx_ltdc.h" +#include "stm32f4xx_rcc.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @defgroup LTDC + * @brief LTDC driver modules + * @{ + */ + +/* Private typedef -----------------------------------------------------------*/ +/* Private define ------------------------------------------------------------*/ +/* Private macro -------------------------------------------------------------*/ +/* Private variables ---------------------------------------------------------*/ +/* Private function prototypes -----------------------------------------------*/ +/* Private functions ---------------------------------------------------------*/ + +#define GCR_MASK ((uint32_t)0x0FFE888F) /* LTDC GCR Mask */ + + +/** @defgroup LTDC_Private_Functions + * @{ + */ + +/** @defgroup LTDC_Group1 Initialization and Configuration functions + * @brief Initialization and Configuration functions + * +@verbatim + =============================================================================== + ##### Initialization and Configuration functions ##### + =============================================================================== + [..] This section provides functions allowing to: + (+) Initialize and configure the LTDC + (+) Enable or Disable Dither + (+) Define the position of the line interrupt + (+) reload layers registers with new parameters + (+) Initialize and configure layer1 and layer2 + (+) Set and configure the color keying functionality + (+) Configure and Enables or disables CLUT + +@endverbatim + * @{ + */ + +/** + * @brief Deinitializes the LTDC peripheral registers to their default reset + * values. + * @param None + * @retval None + */ + +void LTDC_DeInit(void) +{ + /* Enable LTDC reset state */ + RCC_APB2PeriphResetCmd(RCC_APB2Periph_LTDC, ENABLE); + /* Release LTDC from reset state */ + RCC_APB2PeriphResetCmd(RCC_APB2Periph_LTDC, DISABLE); +} + +/** + * @brief Initializes the LTDC peripheral according to the specified parameters + * in the LTDC_InitStruct. + * @note This function can be used only when the LTDC is disabled. + * @param LTDC_InitStruct: pointer to a LTDC_InitTypeDef structure that contains + * the configuration information for the specified LTDC peripheral. + * @retval None + */ + +void LTDC_Init(LTDC_InitTypeDef* LTDC_InitStruct) +{ + uint32_t horizontalsync = 0; + uint32_t accumulatedHBP = 0; + uint32_t accumulatedactiveW = 0; + uint32_t totalwidth = 0; + uint32_t backgreen = 0; + uint32_t backred = 0; + + /* Check function parameters */ + assert_param(IS_LTDC_HSYNC(LTDC_InitStruct->LTDC_HorizontalSync)); + assert_param(IS_LTDC_VSYNC(LTDC_InitStruct->LTDC_VerticalSync)); + assert_param(IS_LTDC_AHBP(LTDC_InitStruct->LTDC_AccumulatedHBP)); + assert_param(IS_LTDC_AVBP(LTDC_InitStruct->LTDC_AccumulatedVBP)); + assert_param(IS_LTDC_AAH(LTDC_InitStruct->LTDC_AccumulatedActiveH)); + assert_param(IS_LTDC_AAW(LTDC_InitStruct->LTDC_AccumulatedActiveW)); + assert_param(IS_LTDC_TOTALH(LTDC_InitStruct->LTDC_TotalHeigh)); + assert_param(IS_LTDC_TOTALW(LTDC_InitStruct->LTDC_TotalWidth)); + assert_param(IS_LTDC_HSPOL(LTDC_InitStruct->LTDC_HSPolarity)); + assert_param(IS_LTDC_VSPOL(LTDC_InitStruct->LTDC_VSPolarity)); + assert_param(IS_LTDC_DEPOL(LTDC_InitStruct->LTDC_DEPolarity)); + assert_param(IS_LTDC_PCPOL(LTDC_InitStruct->LTDC_PCPolarity)); + assert_param(IS_LTDC_BackBlueValue(LTDC_InitStruct->LTDC_BackgroundBlueValue)); + assert_param(IS_LTDC_BackGreenValue(LTDC_InitStruct->LTDC_BackgroundGreenValue)); + assert_param(IS_LTDC_BackRedValue(LTDC_InitStruct->LTDC_BackgroundRedValue)); + + /* Sets Synchronization size */ + LTDC->SSCR &= ~(LTDC_SSCR_VSH | LTDC_SSCR_HSW); + horizontalsync = (LTDC_InitStruct->LTDC_HorizontalSync << 16); + LTDC->SSCR |= (horizontalsync | LTDC_InitStruct->LTDC_VerticalSync); + + /* Sets Accumulated Back porch */ + LTDC->BPCR &= ~(LTDC_BPCR_AVBP | LTDC_BPCR_AHBP); + accumulatedHBP = (LTDC_InitStruct->LTDC_AccumulatedHBP << 16); + LTDC->BPCR |= (accumulatedHBP | LTDC_InitStruct->LTDC_AccumulatedVBP); + + /* Sets Accumulated Active Width */ + LTDC->AWCR &= ~(LTDC_AWCR_AAH | LTDC_AWCR_AAW); + accumulatedactiveW = (LTDC_InitStruct->LTDC_AccumulatedActiveW << 16); + LTDC->AWCR |= (accumulatedactiveW | LTDC_InitStruct->LTDC_AccumulatedActiveH); + + /* Sets Total Width */ + LTDC->TWCR &= ~(LTDC_TWCR_TOTALH | LTDC_TWCR_TOTALW); + totalwidth = (LTDC_InitStruct->LTDC_TotalWidth << 16); + LTDC->TWCR |= (totalwidth | LTDC_InitStruct->LTDC_TotalHeigh); + + LTDC->GCR &= (uint32_t)GCR_MASK; + LTDC->GCR |= (uint32_t)(LTDC_InitStruct->LTDC_HSPolarity | LTDC_InitStruct->LTDC_VSPolarity | \ + LTDC_InitStruct->LTDC_DEPolarity | LTDC_InitStruct->LTDC_PCPolarity); + + /* sets the background color value */ + backgreen = (LTDC_InitStruct->LTDC_BackgroundGreenValue << 8); + backred = (LTDC_InitStruct->LTDC_BackgroundRedValue << 16); + + LTDC->BCCR &= ~(LTDC_BCCR_BCBLUE | LTDC_BCCR_BCGREEN | LTDC_BCCR_BCRED); + LTDC->BCCR |= (backred | backgreen | LTDC_InitStruct->LTDC_BackgroundBlueValue); +} + +/** + * @brief Fills each LTDC_InitStruct member with its default value. + * @param LTDC_InitStruct: pointer to a LTDC_InitTypeDef structure which will + * be initialized. + * @retval None + */ + +void LTDC_StructInit(LTDC_InitTypeDef* LTDC_InitStruct) +{ + /*--------------- Reset LTDC init structure parameters values ----------------*/ + LTDC_InitStruct->LTDC_HSPolarity = LTDC_HSPolarity_AL; /*!< Initialize the LTDC_HSPolarity member */ + LTDC_InitStruct->LTDC_VSPolarity = LTDC_VSPolarity_AL; /*!< Initialize the LTDC_VSPolarity member */ + LTDC_InitStruct->LTDC_DEPolarity = LTDC_DEPolarity_AL; /*!< Initialize the LTDC_DEPolarity member */ + LTDC_InitStruct->LTDC_PCPolarity = LTDC_PCPolarity_IPC; /*!< Initialize the LTDC_PCPolarity member */ + LTDC_InitStruct->LTDC_HorizontalSync = 0x00; /*!< Initialize the LTDC_HorizontalSync member */ + LTDC_InitStruct->LTDC_VerticalSync = 0x00; /*!< Initialize the LTDC_VerticalSync member */ + LTDC_InitStruct->LTDC_AccumulatedHBP = 0x00; /*!< Initialize the LTDC_AccumulatedHBP member */ + LTDC_InitStruct->LTDC_AccumulatedVBP = 0x00; /*!< Initialize the LTDC_AccumulatedVBP member */ + LTDC_InitStruct->LTDC_AccumulatedActiveW = 0x00; /*!< Initialize the LTDC_AccumulatedActiveW member */ + LTDC_InitStruct->LTDC_AccumulatedActiveH = 0x00; /*!< Initialize the LTDC_AccumulatedActiveH member */ + LTDC_InitStruct->LTDC_TotalWidth = 0x00; /*!< Initialize the LTDC_TotalWidth member */ + LTDC_InitStruct->LTDC_TotalHeigh = 0x00; /*!< Initialize the LTDC_TotalHeigh member */ + LTDC_InitStruct->LTDC_BackgroundRedValue = 0x00; /*!< Initialize the LTDC_BackgroundRedValue member */ + LTDC_InitStruct->LTDC_BackgroundGreenValue = 0x00; /*!< Initialize the LTDC_BackgroundGreenValue member */ + LTDC_InitStruct->LTDC_BackgroundBlueValue = 0x00; /*!< Initialize the LTDC_BackgroundBlueValue member */ +} + +/** + * @brief Enables or disables the LTDC Controller. + * @param NewState: new state of the LTDC peripheral. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ + +void LTDC_Cmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable LTDC by setting LTDCEN bit */ + LTDC->GCR |= (uint32_t)LTDC_GCR_LTDCEN; + } + else + { + /* Disable LTDC by clearing LTDCEN bit */ + LTDC->GCR &= ~(uint32_t)LTDC_GCR_LTDCEN; + } +} + +/** + * @brief Enables or disables Dither. + * @param NewState: new state of the Dither. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ + +void LTDC_DitherCmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable Dither by setting DTEN bit */ + LTDC->GCR |= (uint32_t)LTDC_GCR_DTEN; + } + else + { + /* Disable Dither by clearing DTEN bit */ + LTDC->GCR &= ~(uint32_t)LTDC_GCR_DTEN; + } +} + +/** + * @brief Get the dither RGB width. + * @param LTDC_RGB_InitStruct: pointer to a LTDC_RGBTypeDef structure that contains + * the Dither RGB width. + * @retval None + */ + +LTDC_RGBTypeDef LTDC_GetRGBWidth(void) +{ + LTDC_RGBTypeDef LTDC_RGB_InitStruct; + + LTDC->GCR &= (uint32_t)GCR_MASK; + + LTDC_RGB_InitStruct.LTDC_BlueWidth = (uint32_t)((LTDC->GCR >> 4) & 0x7); + LTDC_RGB_InitStruct.LTDC_GreenWidth = (uint32_t)((LTDC->GCR >> 8) & 0x7); + LTDC_RGB_InitStruct.LTDC_RedWidth = (uint32_t)((LTDC->GCR >> 12) & 0x7); + + return LTDC_RGB_InitStruct; +} + +/** + * @brief Fills each LTDC_RGBStruct member with its default value. + * @param LTDC_RGB_InitStruct: pointer to a LTDC_RGBTypeDef structure which will + * be initialized. + * @retval None + */ + +void LTDC_RGBStructInit(LTDC_RGBTypeDef* LTDC_RGB_InitStruct) +{ + LTDC_RGB_InitStruct->LTDC_BlueWidth = 0x02; + LTDC_RGB_InitStruct->LTDC_GreenWidth = 0x02; + LTDC_RGB_InitStruct->LTDC_RedWidth = 0x02; +} + + +/** + * @brief Define the position of the line interrupt . + * @param LTDC_LIPositionConfig: Line Interrupt Position. + * @retval None + */ + +void LTDC_LIPConfig(uint32_t LTDC_LIPositionConfig) +{ + /* Check the parameters */ + assert_param(IS_LTDC_LIPOS(LTDC_LIPositionConfig)); + + /* Sets the Line Interrupt position */ + LTDC->LIPCR = (uint32_t)LTDC_LIPositionConfig; +} + +/** + * @brief reload layers registers with new parameters + * @param LTDC_Reload: specifies the type of reload. + * This parameter can be one of the following values: + * @arg LTDC_IMReload: Vertical blanking reload. + * @arg LTDC_VBReload: Immediate reload. + * @retval None + */ + +void LTDC_ReloadConfig(uint32_t LTDC_Reload) +{ + /* Check the parameters */ + assert_param(IS_LTDC_RELOAD(LTDC_Reload)); + + /* Sets the Reload type */ + LTDC->SRCR = (uint32_t)LTDC_Reload; +} + + +/** + * @brief Initializes the LTDC Layer according to the specified parameters + * in the LTDC_LayerStruct. + * @note This function can be used only when the LTDC is disabled. + * @param LTDC_layerx: Select the layer to be configured, this parameter can be + * one of the following values: LTDC_Layer1, LTDC_Layer2 + * @param LTDC_LayerStruct: pointer to a LTDC_LayerTypeDef structure that contains + * the configuration information for the specified LTDC peripheral. + * @retval None + */ + +void LTDC_LayerInit(LTDC_Layer_TypeDef* LTDC_Layerx, LTDC_Layer_InitTypeDef* LTDC_Layer_InitStruct) +{ + + uint32_t whsppos = 0; + uint32_t wvsppos = 0; + uint32_t dcgreen = 0; + uint32_t dcred = 0; + uint32_t dcalpha = 0; + uint32_t cfbp = 0; + +/* Check the parameters */ + assert_param(IS_LTDC_Pixelformat(LTDC_Layer_InitStruct->LTDC_PixelFormat)); + assert_param(IS_LTDC_BlendingFactor1(LTDC_Layer_InitStruct->LTDC_BlendingFactor_1)); + assert_param(IS_LTDC_BlendingFactor2(LTDC_Layer_InitStruct->LTDC_BlendingFactor_2)); + assert_param(IS_LTDC_HCONFIGST(LTDC_Layer_InitStruct->LTDC_HorizontalStart)); + assert_param(IS_LTDC_HCONFIGSP(LTDC_Layer_InitStruct->LTDC_HorizontalStop)); + assert_param(IS_LTDC_VCONFIGST(LTDC_Layer_InitStruct->LTDC_VerticalStart)); + assert_param(IS_LTDC_VCONFIGSP(LTDC_Layer_InitStruct->LTDC_VerticalStop)); + assert_param(IS_LTDC_DEFAULTCOLOR(LTDC_Layer_InitStruct->LTDC_DefaultColorBlue)); + assert_param(IS_LTDC_DEFAULTCOLOR(LTDC_Layer_InitStruct->LTDC_DefaultColorGreen)); + assert_param(IS_LTDC_DEFAULTCOLOR(LTDC_Layer_InitStruct->LTDC_DefaultColorRed)); + assert_param(IS_LTDC_DEFAULTCOLOR(LTDC_Layer_InitStruct->LTDC_DefaultColorAlpha)); + assert_param(IS_LTDC_CFBP(LTDC_Layer_InitStruct->LTDC_CFBPitch)); + assert_param(IS_LTDC_CFBLL(LTDC_Layer_InitStruct->LTDC_CFBLineLength)); + assert_param(IS_LTDC_CFBLNBR(LTDC_Layer_InitStruct->LTDC_CFBLineNumber)); + + /* Configures the horizontal start and stop position */ + whsppos = LTDC_Layer_InitStruct->LTDC_HorizontalStop << 16; + LTDC_Layerx->WHPCR &= ~(LTDC_LxWHPCR_WHSTPOS | LTDC_LxWHPCR_WHSPPOS); + LTDC_Layerx->WHPCR = (LTDC_Layer_InitStruct->LTDC_HorizontalStart | whsppos); + + /* Configures the vertical start and stop position */ + wvsppos = LTDC_Layer_InitStruct->LTDC_VerticalStop << 16; + LTDC_Layerx->WVPCR &= ~(LTDC_LxWVPCR_WVSTPOS | LTDC_LxWVPCR_WVSPPOS); + LTDC_Layerx->WVPCR = (LTDC_Layer_InitStruct->LTDC_VerticalStart | wvsppos); + + /* Specifies the pixel format */ + LTDC_Layerx->PFCR &= ~(LTDC_LxPFCR_PF); + LTDC_Layerx->PFCR = (LTDC_Layer_InitStruct->LTDC_PixelFormat); + + /* Configures the default color values */ + dcgreen = (LTDC_Layer_InitStruct->LTDC_DefaultColorGreen << 8); + dcred = (LTDC_Layer_InitStruct->LTDC_DefaultColorRed << 16); + dcalpha = (LTDC_Layer_InitStruct->LTDC_DefaultColorAlpha << 24); + LTDC_Layerx->DCCR &= ~(LTDC_LxDCCR_DCBLUE | LTDC_LxDCCR_DCGREEN | LTDC_LxDCCR_DCRED | LTDC_LxDCCR_DCALPHA); + LTDC_Layerx->DCCR = (LTDC_Layer_InitStruct->LTDC_DefaultColorBlue | dcgreen | \ + dcred | dcalpha); + + /* Specifies the constant alpha value */ + LTDC_Layerx->CACR &= ~(LTDC_LxCACR_CONSTA); + LTDC_Layerx->CACR = (LTDC_Layer_InitStruct->LTDC_ConstantAlpha); + + /* Specifies the blending factors */ + LTDC_Layerx->BFCR &= ~(LTDC_LxBFCR_BF2 | LTDC_LxBFCR_BF1); + LTDC_Layerx->BFCR = (LTDC_Layer_InitStruct->LTDC_BlendingFactor_1 | LTDC_Layer_InitStruct->LTDC_BlendingFactor_2); + + /* Configures the color frame buffer start address */ + LTDC_Layerx->CFBAR &= ~(LTDC_LxCFBAR_CFBADD); + LTDC_Layerx->CFBAR = (LTDC_Layer_InitStruct->LTDC_CFBStartAdress); + + /* Configures the color frame buffer pitch in byte */ + cfbp = (LTDC_Layer_InitStruct->LTDC_CFBPitch << 16); + LTDC_Layerx->CFBLR &= ~(LTDC_LxCFBLR_CFBLL | LTDC_LxCFBLR_CFBP); + LTDC_Layerx->CFBLR = (LTDC_Layer_InitStruct->LTDC_CFBLineLength | cfbp); + + /* Configures the frame buffer line number */ + LTDC_Layerx->CFBLNR &= ~(LTDC_LxCFBLNR_CFBLNBR); + LTDC_Layerx->CFBLNR = (LTDC_Layer_InitStruct->LTDC_CFBLineNumber); + +} + +/** + * @brief Fills each LTDC_Layer_InitStruct member with its default value. + * @param LTDC_Layer_InitStruct: pointer to a LTDC_LayerTypeDef structure which will + * be initialized. + * @retval None + */ + +void LTDC_LayerStructInit(LTDC_Layer_InitTypeDef * LTDC_Layer_InitStruct) +{ + /*--------------- Reset Layer structure parameters values -------------------*/ + + /*!< Initialize the horizontal limit member */ + LTDC_Layer_InitStruct->LTDC_HorizontalStart = 0x00; + LTDC_Layer_InitStruct->LTDC_HorizontalStop = 0x00; + + /*!< Initialize the vertical limit member */ + LTDC_Layer_InitStruct->LTDC_VerticalStart = 0x00; + LTDC_Layer_InitStruct->LTDC_VerticalStop = 0x00; + + /*!< Initialize the pixel format member */ + LTDC_Layer_InitStruct->LTDC_PixelFormat = LTDC_Pixelformat_ARGB8888; + + /*!< Initialize the constant alpha value */ + LTDC_Layer_InitStruct->LTDC_ConstantAlpha = 0xFF; + + /*!< Initialize the default color values */ + LTDC_Layer_InitStruct->LTDC_DefaultColorBlue = 0x00; + LTDC_Layer_InitStruct->LTDC_DefaultColorGreen = 0x00; + LTDC_Layer_InitStruct->LTDC_DefaultColorRed = 0x00; + LTDC_Layer_InitStruct->LTDC_DefaultColorAlpha = 0x00; + + /*!< Initialize the blending factors */ + LTDC_Layer_InitStruct->LTDC_BlendingFactor_1 = LTDC_BlendingFactor1_PAxCA; + LTDC_Layer_InitStruct->LTDC_BlendingFactor_2 = LTDC_BlendingFactor2_PAxCA; + + /*!< Initialize the frame buffer start address */ + LTDC_Layer_InitStruct->LTDC_CFBStartAdress = 0x00; + + /*!< Initialize the frame buffer pitch and line length */ + LTDC_Layer_InitStruct->LTDC_CFBLineLength = 0x00; + LTDC_Layer_InitStruct->LTDC_CFBPitch = 0x00; + + /*!< Initialize the frame buffer line number */ + LTDC_Layer_InitStruct->LTDC_CFBLineNumber = 0x00; +} + + +/** + * @brief Enables or disables the LTDC_Layer Controller. + * @param LTDC_layerx: Select the layer to be configured, this parameter can be + * one of the following values: LTDC_Layer1, LTDC_Layer2 + * @param NewState: new state of the LTDC_Layer peripheral. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ + +void LTDC_LayerCmd(LTDC_Layer_TypeDef* LTDC_Layerx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable LTDC_Layer by setting LEN bit */ + LTDC_Layerx->CR |= (uint32_t)LTDC_LxCR_LEN; + } + else + { + /* Disable LTDC_Layer by clearing LEN bit */ + LTDC_Layerx->CR &= ~(uint32_t)LTDC_LxCR_LEN; + } +} + + +/** + * @brief Get the current position. + * @param LTDC_Pos_InitStruct: pointer to a LTDC_PosTypeDef structure that contains + * the current position. + * @retval None + */ + +LTDC_PosTypeDef LTDC_GetPosStatus(void) +{ + LTDC_PosTypeDef LTDC_Pos_InitStruct; + + LTDC->CPSR &= ~(LTDC_CPSR_CYPOS | LTDC_CPSR_CXPOS); + + LTDC_Pos_InitStruct.LTDC_POSX = (uint32_t)(LTDC->CPSR >> 16); + LTDC_Pos_InitStruct.LTDC_POSY = (uint32_t)(LTDC->CPSR & 0xFFFF); + + return LTDC_Pos_InitStruct; +} + +/** + * @brief Fills each LTDC_Pos_InitStruct member with its default value. + * @param LTDC_Pos_InitStruct: pointer to a LTDC_PosTypeDef structure which will + * be initialized. + * @retval None + */ + +void LTDC_PosStructInit(LTDC_PosTypeDef* LTDC_Pos_InitStruct) +{ + LTDC_Pos_InitStruct->LTDC_POSX = 0x00; + LTDC_Pos_InitStruct->LTDC_POSY = 0x00; +} + +/** + * @brief Checks whether the specified LTDC's flag is set or not. + * @param LTDC_CD: specifies the flag to check. + * This parameter can be one of the following values: + * @arg LTDC_CD_VDES: vertical data enable current status. + * @arg LTDC_CD_HDES: horizontal data enable current status. + * @arg LTDC_CD_VSYNC: Vertical Synchronization current status. + * @arg LTDC_CD_HSYNC: Horizontal Synchronization current status. + * @retval The new state of LTDC_CD (SET or RESET). + */ + +FlagStatus LTDC_GetCDStatus(uint32_t LTDC_CD) +{ + FlagStatus bitstatus; + + /* Check the parameters */ + assert_param(IS_LTDC_GET_CD(LTDC_CD)); + + if ((LTDC->CDSR & LTDC_CD) != (uint32_t)RESET) + { + bitstatus = SET; + } + else + { + bitstatus = RESET; + } + return bitstatus; +} + +/** + * @brief Set and configure the color keying. + * @param LTDC_colorkeying_InitStruct: pointer to a LTDC_ColorKeying_InitTypeDef + * structure that contains the color keying configuration. + * @param LTDC_layerx: Select the layer to be configured, this parameter can be + * one of the following values: LTDC_Layer1, LTDC_Layer2 + * @retval None + */ + +void LTDC_ColorKeyingConfig(LTDC_Layer_TypeDef* LTDC_Layerx, LTDC_ColorKeying_InitTypeDef* LTDC_colorkeying_InitStruct, FunctionalState NewState) +{ + uint32_t ckgreen = 0; + uint32_t ckred = 0; + + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + assert_param(IS_LTDC_CKEYING(LTDC_colorkeying_InitStruct->LTDC_ColorKeyBlue)); + assert_param(IS_LTDC_CKEYING(LTDC_colorkeying_InitStruct->LTDC_ColorKeyGreen)); + assert_param(IS_LTDC_CKEYING(LTDC_colorkeying_InitStruct->LTDC_ColorKeyRed)); + + if (NewState != DISABLE) + { + /* Enable LTDC color keying by setting COLKEN bit */ + LTDC_Layerx->CR |= (uint32_t)LTDC_LxCR_COLKEN; + + /* Sets the color keying values */ + ckgreen = (LTDC_colorkeying_InitStruct->LTDC_ColorKeyGreen << 8); + ckred = (LTDC_colorkeying_InitStruct->LTDC_ColorKeyRed << 16); + LTDC_Layerx->CKCR &= ~(LTDC_LxCKCR_CKBLUE | LTDC_LxCKCR_CKGREEN | LTDC_LxCKCR_CKRED); + LTDC_Layerx->CKCR |= (LTDC_colorkeying_InitStruct->LTDC_ColorKeyBlue | ckgreen | ckred); + } + else + { + /* Disable LTDC color keying by clearing COLKEN bit */ + LTDC_Layerx->CR &= ~(uint32_t)LTDC_LxCR_COLKEN; + } + + /* Reload shadow register */ + LTDC->SRCR = LTDC_IMReload; +} + +/** + * @brief Fills each LTDC_colorkeying_InitStruct member with its default value. + * @param LTDC_colorkeying_InitStruct: pointer to a LTDC_ColorKeying_InitTypeDef structure which will + * be initialized. + * @retval None + */ + +void LTDC_ColorKeyingStructInit(LTDC_ColorKeying_InitTypeDef* LTDC_colorkeying_InitStruct) +{ + /*!< Initialize the color keying values */ + LTDC_colorkeying_InitStruct->LTDC_ColorKeyBlue = 0x00; + LTDC_colorkeying_InitStruct->LTDC_ColorKeyGreen = 0x00; + LTDC_colorkeying_InitStruct->LTDC_ColorKeyRed = 0x00; +} + + +/** + * @brief Enables or disables CLUT. + * @param NewState: new state of CLUT. + * @param LTDC_layerx: Select the layer to be configured, this parameter can be + * one of the following values: LTDC_Layer1, LTDC_Layer2 + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ + +void LTDC_CLUTCmd(LTDC_Layer_TypeDef* LTDC_Layerx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable CLUT by setting CLUTEN bit */ + LTDC_Layerx->CR |= (uint32_t)LTDC_LxCR_CLUTEN; + } + else + { + /* Disable CLUT by clearing CLUTEN bit */ + LTDC_Layerx->CR &= ~(uint32_t)LTDC_LxCR_CLUTEN; + } + + /* Reload shadow register */ + LTDC->SRCR = LTDC_IMReload; +} + +/** + * @brief configure the CLUT. + * @param LTDC_CLUT_InitStruct: pointer to a LTDC_CLUT_InitTypeDef structure that contains + * the CLUT configuration. + * @param LTDC_layerx: Select the layer to be configured, this parameter can be + * one of the following values: LTDC_Layer1, LTDC_Layer2 + * @retval None + */ + +void LTDC_CLUTInit(LTDC_Layer_TypeDef* LTDC_Layerx, LTDC_CLUT_InitTypeDef* LTDC_CLUT_InitStruct) +{ + uint32_t green = 0; + uint32_t red = 0; + uint32_t clutadd = 0; + + /* Check the parameters */ + assert_param(IS_LTDC_CLUTWR(LTDC_CLUT_InitStruct->LTDC_CLUTAdress)); + assert_param(IS_LTDC_CLUTWR(LTDC_CLUT_InitStruct->LTDC_RedValue)); + assert_param(IS_LTDC_CLUTWR(LTDC_CLUT_InitStruct->LTDC_GreenValue)); + assert_param(IS_LTDC_CLUTWR(LTDC_CLUT_InitStruct->LTDC_BlueValue)); + + /* Specifies the CLUT address and RGB value */ + green = (LTDC_CLUT_InitStruct->LTDC_GreenValue << 8); + red = (LTDC_CLUT_InitStruct->LTDC_RedValue << 16); + clutadd = (LTDC_CLUT_InitStruct->LTDC_CLUTAdress << 24); + LTDC_Layerx->CLUTWR = (clutadd | LTDC_CLUT_InitStruct->LTDC_BlueValue | \ + green | red); +} + +/** + * @brief Fills each LTDC_CLUT_InitStruct member with its default value. + * @param LTDC_CLUT_InitStruct: pointer to a LTDC_CLUT_InitTypeDef structure which will + * be initialized. + * @retval None + */ + +void LTDC_CLUTStructInit(LTDC_CLUT_InitTypeDef* LTDC_CLUT_InitStruct) +{ + /*!< Initialize the CLUT adress and RGB values */ + LTDC_CLUT_InitStruct->LTDC_CLUTAdress = 0x00; + LTDC_CLUT_InitStruct->LTDC_BlueValue = 0x00; + LTDC_CLUT_InitStruct->LTDC_GreenValue = 0x00; + LTDC_CLUT_InitStruct->LTDC_RedValue = 0x00; +} + + +/** + * @brief reconfigure the layer position. + * @param OffsetX: horizontal offset from start active width . + * @param OffsetY: vertical offset from start active height. + * @param LTDC_layerx: Select the layer to be configured, this parameter can be + * one of the following values: LTDC_Layer1, LTDC_Layer2 + * @retval Reload of the shadow registers values must be applied after layer + * position reconfiguration. + */ + +void LTDC_LayerPosition(LTDC_Layer_TypeDef* LTDC_Layerx, uint16_t OffsetX, uint16_t OffsetY) +{ + + uint32_t tempreg, temp; + uint32_t horizontal_start; + uint32_t horizontal_stop; + uint32_t vertical_start; + uint32_t vertical_stop; + + LTDC_Layerx->WHPCR &= ~(LTDC_LxWHPCR_WHSTPOS | LTDC_LxWHPCR_WHSPPOS); + LTDC_Layerx->WVPCR &= ~(LTDC_LxWVPCR_WVSTPOS | LTDC_LxWVPCR_WVSPPOS); + + /* Reconfigures the horizontal and vertical start position */ + tempreg = LTDC->BPCR; + horizontal_start = (tempreg >> 16) + 1 + OffsetX; + vertical_start = (tempreg & 0xFFFF) + 1 + OffsetY; + + /* Reconfigures the horizontal and vertical stop position */ + /* Get the number of byte per pixel */ + + tempreg = LTDC_Layerx->PFCR; + + if (tempreg == LTDC_Pixelformat_ARGB8888) + { + temp = 4; + } + else if (tempreg == LTDC_Pixelformat_RGB888) + { + temp = 3; + } + else if ((tempreg == LTDC_Pixelformat_ARGB4444) || + (tempreg == LTDC_Pixelformat_RGB565) || + (tempreg == LTDC_Pixelformat_ARGB1555) || + (tempreg == LTDC_Pixelformat_AL88)) + { + temp = 2; + } + else + { + temp = 1; + } + + tempreg = LTDC_Layerx->CFBLR; + horizontal_stop = (((tempreg & 0x1FFF) - 3)/temp) + horizontal_start - 1; + + tempreg = LTDC_Layerx->CFBLNR; + vertical_stop = (tempreg & 0x7FF) + vertical_start - 1; + + LTDC_Layerx->WHPCR = horizontal_start | (horizontal_stop << 16); + LTDC_Layerx->WVPCR = vertical_start | (vertical_stop << 16); +} + +/** + * @brief reconfigure constant alpha. + * @param ConstantAlpha: constant alpha value. + * @param LTDC_layerx: Select the layer to be configured, this parameter can be + * one of the following values: LTDC_Layer1, LTDC_Layer2 + * @retval Reload of the shadow registers values must be applied after constant + * alpha reconfiguration. + */ + +void LTDC_LayerAlpha(LTDC_Layer_TypeDef* LTDC_Layerx, uint8_t ConstantAlpha) +{ + /* reconfigure the constant alpha value */ + LTDC_Layerx->CACR = ConstantAlpha; +} + +/** + * @brief reconfigure layer address. + * @param Address: The color frame buffer start address. + * @param LTDC_layerx: Select the layer to be configured, this parameter can be + * one of the following values: LTDC_Layer1, LTDC_Layer2 + * @retval Reload of the shadow registers values must be applied after layer + * address reconfiguration. + */ + +void LTDC_LayerAddress(LTDC_Layer_TypeDef* LTDC_Layerx, uint32_t Address) +{ + /* Reconfigures the color frame buffer start address */ + LTDC_Layerx->CFBAR = Address; +} + +/** + * @brief reconfigure layer size. + * @param Width: layer window width. + * @param Height: layer window height. + * @param LTDC_layerx: Select the layer to be configured, this parameter can be + * one of the following values: LTDC_Layer1, LTDC_Layer2 + * @retval Reload of the shadow registers values must be applied after layer + * size reconfiguration. + */ + +void LTDC_LayerSize(LTDC_Layer_TypeDef* LTDC_Layerx, uint32_t Width, uint32_t Height) +{ + + uint8_t temp; + uint32_t tempreg; + uint32_t horizontal_start; + uint32_t horizontal_stop; + uint32_t vertical_start; + uint32_t vertical_stop; + + tempreg = LTDC_Layerx->PFCR; + + if (tempreg == LTDC_Pixelformat_ARGB8888) + { + temp = 4; + } + else if (tempreg == LTDC_Pixelformat_RGB888) + { + temp = 3; + } + else if ((tempreg == LTDC_Pixelformat_ARGB4444) || \ + (tempreg == LTDC_Pixelformat_RGB565) || \ + (tempreg == LTDC_Pixelformat_ARGB1555) || \ + (tempreg == LTDC_Pixelformat_AL88)) + { + temp = 2; + } + else + { + temp = 1; + } + + /* update horizontal and vertical stop */ + tempreg = LTDC_Layerx->WHPCR; + horizontal_start = (tempreg & 0x1FFF); + horizontal_stop = Width + horizontal_start - 1; + + tempreg = LTDC_Layerx->WVPCR; + vertical_start = (tempreg & 0x1FFF); + vertical_stop = Height + vertical_start - 1; + + LTDC_Layerx->WHPCR = horizontal_start | (horizontal_stop << 16); + LTDC_Layerx->WVPCR = vertical_start | (vertical_stop << 16); + + /* Reconfigures the color frame buffer pitch in byte */ + LTDC_Layerx->CFBLR = ((Width * temp) << 16) | ((Width * temp) + 3); + + /* Reconfigures the frame buffer line number */ + LTDC_Layerx->CFBLNR = Height; + +} + +/** + * @brief reconfigure layer pixel format. + * @param PixelFormat: reconfigure the pixel format, this parameter can be + * one of the following values:@ref LTDC_Pixelformat. + * @param LTDC_layerx: Select the layer to be configured, this parameter can be + * one of the following values: LTDC_Layer1, LTDC_Layer2 + * @retval Reload of the shadow registers values must be applied after layer + * pixel format reconfiguration. + */ + +void LTDC_LayerPixelFormat(LTDC_Layer_TypeDef* LTDC_Layerx, uint32_t PixelFormat) +{ + + uint8_t temp; + uint32_t tempreg; + + tempreg = LTDC_Layerx->PFCR; + + if (tempreg == LTDC_Pixelformat_ARGB8888) + { + temp = 4; + } + else if (tempreg == LTDC_Pixelformat_RGB888) + { + temp = 3; + } + else if ((tempreg == LTDC_Pixelformat_ARGB4444) || \ + (tempreg == LTDC_Pixelformat_RGB565) || \ + (tempreg == LTDC_Pixelformat_ARGB1555) || \ + (tempreg == LTDC_Pixelformat_AL88)) + { + temp = 2; + } + else + { + temp = 1; + } + + tempreg = (LTDC_Layerx->CFBLR >> 16); + tempreg = (tempreg / temp); + + if (PixelFormat == LTDC_Pixelformat_ARGB8888) + { + temp = 4; + } + else if (PixelFormat == LTDC_Pixelformat_RGB888) + { + temp = 3; + } + else if ((PixelFormat == LTDC_Pixelformat_ARGB4444) || \ + (PixelFormat == LTDC_Pixelformat_RGB565) || \ + (PixelFormat == LTDC_Pixelformat_ARGB1555) || \ + (PixelFormat == LTDC_Pixelformat_AL88)) + { + temp = 2; + } + else + { + temp = 1; + } + + /* Reconfigures the color frame buffer pitch in byte */ + LTDC_Layerx->CFBLR = ((tempreg * temp) << 16) | ((tempreg * temp) + 3); + + /* Reconfigures the color frame buffer start address */ + LTDC_Layerx->PFCR = PixelFormat; + +} + +/** + * @} + */ + +/** @defgroup LTDC_Group2 Interrupts and flags management functions + * @brief Interrupts and flags management functions + * +@verbatim + =============================================================================== + ##### Interrupts and flags management functions ##### + =============================================================================== + + [..] This section provides functions allowing to configure the LTDC Interrupts + and to get the status and clear flags and Interrupts pending bits. + + [..] The LTDC provides 4 Interrupts sources and 4 Flags + + *** Flags *** + ============= + [..] + (+) LTDC_FLAG_LI: Line Interrupt flag. + (+) LTDC_FLAG_FU: FIFO Underrun Interrupt flag. + (+) LTDC_FLAG_TERR: Transfer Error Interrupt flag. + (+) LTDC_FLAG_RR: Register Reload interrupt flag. + + *** Interrupts *** + ================== + [..] + (+) LTDC_IT_LI: Line Interrupt is generated when a programmed line + is reached. The line interrupt position is programmed in + the LTDC_LIPR register. + (+) LTDC_IT_FU: FIFO Underrun interrupt is generated when a pixel is requested + from an empty layer FIFO + (+) LTDC_IT_TERR: Transfer Error interrupt is generated when an AHB bus + error occurs during data transfer. + (+) LTDC_IT_RR: Register Reload interrupt is generated when the shadow + registers reload was performed during the vertical blanking + period. + +@endverbatim + * @{ + */ + +/** + * @brief Enables or disables the specified LTDC's interrupts. + * @param LTDC_IT: specifies the LTDC interrupts sources to be enabled or disabled. + * This parameter can be any combination of the following values: + * @arg LTDC_IT_LI: Line Interrupt Enable. + * @arg LTDC_IT_FU: FIFO Underrun Interrupt Enable. + * @arg LTDC_IT_TERR: Transfer Error Interrupt Enable. + * @arg LTDC_IT_RR: Register Reload interrupt enable. + * @param NewState: new state of the specified LTDC interrupts. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void LTDC_ITConfig(uint32_t LTDC_IT, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_LTDC_IT(LTDC_IT)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + LTDC->IER |= LTDC_IT; + } + else + { + LTDC->IER &= (uint32_t)~LTDC_IT; + } +} + +/** + * @brief Checks whether the specified LTDC's flag is set or not. + * @param LTDC_FLAG: specifies the flag to check. + * This parameter can be one of the following values: + * @arg LTDC_FLAG_LI: Line Interrupt flag. + * @arg LTDC_FLAG_FU: FIFO Underrun Interrupt flag. + * @arg LTDC_FLAG_TERR: Transfer Error Interrupt flag. + * @arg LTDC_FLAG_RR: Register Reload interrupt flag. + * @retval The new state of LTDC_FLAG (SET or RESET). + */ +FlagStatus LTDC_GetFlagStatus(uint32_t LTDC_FLAG) +{ + FlagStatus bitstatus = RESET; + + /* Check the parameters */ + assert_param(IS_LTDC_FLAG(LTDC_FLAG)); + + if ((LTDC->ISR & LTDC_FLAG) != (uint32_t)RESET) + { + bitstatus = SET; + } + else + { + bitstatus = RESET; + } + return bitstatus; +} + +/** + * @brief Clears the LTDC's pending flags. + * @param LTDC_FLAG: specifies the flag to clear. + * This parameter can be any combination of the following values: + * @arg LTDC_FLAG_LI: Line Interrupt flag. + * @arg LTDC_FLAG_FU: FIFO Underrun Interrupt flag. + * @arg LTDC_FLAG_TERR: Transfer Error Interrupt flag. + * @arg LTDC_FLAG_RR: Register Reload interrupt flag. + * @retval None + */ +void LTDC_ClearFlag(uint32_t LTDC_FLAG) +{ + /* Check the parameters */ + assert_param(IS_LTDC_FLAG(LTDC_FLAG)); + + /* Clear the corresponding LTDC flag */ + LTDC->ICR = (uint32_t)LTDC_FLAG; +} + +/** + * @brief Checks whether the specified LTDC's interrupt has occurred or not. + * @param LTDC_IT: specifies the LTDC interrupts sources to check. + * This parameter can be one of the following values: + * @arg LTDC_IT_LI: Line Interrupt Enable. + * @arg LTDC_IT_FU: FIFO Underrun Interrupt Enable. + * @arg LTDC_IT_TERR: Transfer Error Interrupt Enable. + * @arg LTDC_IT_RR: Register Reload interrupt Enable. + * @retval The new state of the LTDC_IT (SET or RESET). + */ +ITStatus LTDC_GetITStatus(uint32_t LTDC_IT) +{ + ITStatus bitstatus = RESET; + + /* Check the parameters */ + assert_param(IS_LTDC_IT(LTDC_IT)); + + if ((LTDC->ISR & LTDC_IT) != (uint32_t)RESET) + { + bitstatus = SET; + } + else + { + bitstatus = RESET; + } + + if (((LTDC->IER & LTDC_IT) != (uint32_t)RESET) && (bitstatus != (uint32_t)RESET)) + { + bitstatus = SET; + } + else + { + bitstatus = RESET; + } + return bitstatus; +} + + +/** + * @brief Clears the LTDC's interrupt pending bits. + * @param LTDC_IT: specifies the interrupt pending bit to clear. + * This parameter can be any combination of the following values: + * @arg LTDC_IT_LIE: Line Interrupt. + * @arg LTDC_IT_FUIE: FIFO Underrun Interrupt. + * @arg LTDC_IT_TERRIE: Transfer Error Interrupt. + * @arg LTDC_IT_RRIE: Register Reload interrupt. + * @retval None + */ +void LTDC_ClearITPendingBit(uint32_t LTDC_IT) +{ + /* Check the parameters */ + assert_param(IS_LTDC_IT(LTDC_IT)); + + /* Clear the corresponding LTDC Interrupt */ + LTDC->ICR = (uint32_t)LTDC_IT; +} +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/src/stm32f4xx_pwr.c b/FWLIB/src/stm32f4xx_pwr.c new file mode 100644 index 0000000..1c79782 --- /dev/null +++ b/FWLIB/src/stm32f4xx_pwr.c @@ -0,0 +1,939 @@ +/** + ****************************************************************************** + * @file stm32f4xx_pwr.c + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file provides firmware functions to manage the following + * functionalities of the Power Controller (PWR) peripheral: + * + Backup Domain Access + * + PVD configuration + * + WakeUp pin configuration + * + Main and Backup Regulators configuration + * + FLASH Power Down configuration + * + Low Power modes configuration + * + Flags management + * + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx_pwr.h" +#include "stm32f4xx_rcc.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @defgroup PWR + * @brief PWR driver modules + * @{ + */ + +/* Private typedef -----------------------------------------------------------*/ +/* Private define ------------------------------------------------------------*/ +/* --------- PWR registers bit address in the alias region ---------- */ +#define PWR_OFFSET (PWR_BASE - PERIPH_BASE) + +/* --- CR Register ---*/ + +/* Alias word address of DBP bit */ +#define CR_OFFSET (PWR_OFFSET + 0x00) +#define DBP_BitNumber 0x08 +#define CR_DBP_BB (PERIPH_BB_BASE + (CR_OFFSET * 32) + (DBP_BitNumber * 4)) + +/* Alias word address of PVDE bit */ +#define PVDE_BitNumber 0x04 +#define CR_PVDE_BB (PERIPH_BB_BASE + (CR_OFFSET * 32) + (PVDE_BitNumber * 4)) + +/* Alias word address of FPDS bit */ +#define FPDS_BitNumber 0x09 +#define CR_FPDS_BB (PERIPH_BB_BASE + (CR_OFFSET * 32) + (FPDS_BitNumber * 4)) + +/* Alias word address of PMODE bit */ +#define PMODE_BitNumber 0x0E +#define CR_PMODE_BB (PERIPH_BB_BASE + (CR_OFFSET * 32) + (PMODE_BitNumber * 4)) + +/* Alias word address of ODEN bit */ +#define ODEN_BitNumber 0x10 +#define CR_ODEN_BB (PERIPH_BB_BASE + (CR_OFFSET * 32) + (ODEN_BitNumber * 4)) + +/* Alias word address of ODSWEN bit */ +#define ODSWEN_BitNumber 0x11 +#define CR_ODSWEN_BB (PERIPH_BB_BASE + (CR_OFFSET * 32) + (ODSWEN_BitNumber * 4)) + +/* Alias word address of MRLVDS bit */ +#define MRLVDS_BitNumber 0x0B +#define CR_MRLVDS_BB (PERIPH_BB_BASE + (CR_OFFSET * 32) + (MRLVDS_BitNumber * 4)) + +/* Alias word address of LPLVDS bit */ +#define LPLVDS_BitNumber 0x0A +#define CR_LPLVDS_BB (PERIPH_BB_BASE + (CR_OFFSET * 32) + (LPLVDS_BitNumber * 4)) + +/* --- CSR Register ---*/ + +/* Alias word address of EWUP bit */ +#define CSR_OFFSET (PWR_OFFSET + 0x04) +#define EWUP_BitNumber 0x08 +#define CSR_EWUP_BB (PERIPH_BB_BASE + (CSR_OFFSET * 32) + (EWUP_BitNumber * 4)) + +/* Alias word address of BRE bit */ +#define BRE_BitNumber 0x09 +#define CSR_BRE_BB (PERIPH_BB_BASE + (CSR_OFFSET * 32) + (BRE_BitNumber * 4)) + +/* ------------------ PWR registers bit mask ------------------------ */ + +/* CR register bit mask */ +#define CR_DS_MASK ((uint32_t)0xFFFFF3FC) +#define CR_PLS_MASK ((uint32_t)0xFFFFFF1F) +#define CR_VOS_MASK ((uint32_t)0xFFFF3FFF) + +/* Private macro -------------------------------------------------------------*/ +/* Private variables ---------------------------------------------------------*/ +/* Private function prototypes -----------------------------------------------*/ +/* Private functions ---------------------------------------------------------*/ + +/** @defgroup PWR_Private_Functions + * @{ + */ + +/** @defgroup PWR_Group1 Backup Domain Access function + * @brief Backup Domain Access function + * +@verbatim + =============================================================================== + ##### Backup Domain Access function ##### + =============================================================================== + [..] + After reset, the backup domain (RTC registers, RTC backup data + registers and backup SRAM) is protected against possible unwanted + write accesses. + To enable access to the RTC Domain and RTC registers, proceed as follows: + (+) Enable the Power Controller (PWR) APB1 interface clock using the + RCC_APB1PeriphClockCmd() function. + (+) Enable access to RTC domain using the PWR_BackupAccessCmd() function. + +@endverbatim + * @{ + */ + +/** + * @brief Deinitializes the PWR peripheral registers to their default reset values. + * @param None + * @retval None + */ +void PWR_DeInit(void) +{ + RCC_APB1PeriphResetCmd(RCC_APB1Periph_PWR, ENABLE); + RCC_APB1PeriphResetCmd(RCC_APB1Periph_PWR, DISABLE); +} + +/** + * @brief Enables or disables access to the backup domain (RTC registers, RTC + * backup data registers and backup SRAM). + * @note If the HSE divided by 2, 3, ..31 is used as the RTC clock, the + * Backup Domain Access should be kept enabled. + * @param NewState: new state of the access to the backup domain. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void PWR_BackupAccessCmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + *(__IO uint32_t *) CR_DBP_BB = (uint32_t)NewState; +} + +/** + * @} + */ + +/** @defgroup PWR_Group2 PVD configuration functions + * @brief PVD configuration functions + * +@verbatim + =============================================================================== + ##### PVD configuration functions ##### + =============================================================================== + [..] + (+) The PVD is used to monitor the VDD power supply by comparing it to a + threshold selected by the PVD Level (PLS[2:0] bits in the PWR_CR). + (+) A PVDO flag is available to indicate if VDD/VDDA is higher or lower + than the PVD threshold. This event is internally connected to the EXTI + line16 and can generate an interrupt if enabled through the EXTI registers. + (+) The PVD is stopped in Standby mode. + +@endverbatim + * @{ + */ + +/** + * @brief Configures the voltage threshold detected by the Power Voltage Detector(PVD). + * @param PWR_PVDLevel: specifies the PVD detection level + * This parameter can be one of the following values: + * @arg PWR_PVDLevel_0 + * @arg PWR_PVDLevel_1 + * @arg PWR_PVDLevel_2 + * @arg PWR_PVDLevel_3 + * @arg PWR_PVDLevel_4 + * @arg PWR_PVDLevel_5 + * @arg PWR_PVDLevel_6 + * @arg PWR_PVDLevel_7 + * @note Refer to the electrical characteristics of your device datasheet for + * more details about the voltage threshold corresponding to each + * detection level. + * @retval None + */ +void PWR_PVDLevelConfig(uint32_t PWR_PVDLevel) +{ + uint32_t tmpreg = 0; + + /* Check the parameters */ + assert_param(IS_PWR_PVD_LEVEL(PWR_PVDLevel)); + + tmpreg = PWR->CR; + + /* Clear PLS[7:5] bits */ + tmpreg &= CR_PLS_MASK; + + /* Set PLS[7:5] bits according to PWR_PVDLevel value */ + tmpreg |= PWR_PVDLevel; + + /* Store the new value */ + PWR->CR = tmpreg; +} + +/** + * @brief Enables or disables the Power Voltage Detector(PVD). + * @param NewState: new state of the PVD. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void PWR_PVDCmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + *(__IO uint32_t *) CR_PVDE_BB = (uint32_t)NewState; +} + +/** + * @} + */ + +/** @defgroup PWR_Group3 WakeUp pin configuration functions + * @brief WakeUp pin configuration functions + * +@verbatim + =============================================================================== + ##### WakeUp pin configuration functions ##### + =============================================================================== + [..] + (+) WakeUp pin is used to wakeup the system from Standby mode. This pin is + forced in input pull down configuration and is active on rising edges. + (+) There is only one WakeUp pin: WakeUp Pin 1 on PA.00. + +@endverbatim + * @{ + */ + +/** + * @brief Enables or disables the WakeUp Pin functionality. + * @param NewState: new state of the WakeUp Pin functionality. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void PWR_WakeUpPinCmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + *(__IO uint32_t *) CSR_EWUP_BB = (uint32_t)NewState; +} + +/** + * @} + */ + +/** @defgroup PWR_Group4 Main and Backup Regulators configuration functions + * @brief Main and Backup Regulators configuration functions + * +@verbatim + =============================================================================== + ##### Main and Backup Regulators configuration functions ##### + =============================================================================== + [..] + (+) The backup domain includes 4 Kbytes of backup SRAM accessible only from + the CPU, and address in 32-bit, 16-bit or 8-bit mode. Its content is + retained even in Standby or VBAT mode when the low power backup regulator + is enabled. It can be considered as an internal EEPROM when VBAT is + always present. You can use the PWR_BackupRegulatorCmd() function to + enable the low power backup regulator and use the PWR_GetFlagStatus + (PWR_FLAG_BRR) to check if it is ready or not. + + (+) When the backup domain is supplied by VDD (analog switch connected to VDD) + the backup SRAM is powered from VDD which replaces the VBAT power supply to + save battery life. + + (+) The backup SRAM is not mass erased by an tamper event. It is read + protected to prevent confidential data, such as cryptographic private + key, from being accessed. The backup SRAM can be erased only through + the Flash interface when a protection level change from level 1 to + level 0 is requested. + -@- Refer to the description of Read protection (RDP) in the reference manual. + + (+) The main internal regulator can be configured to have a tradeoff between + performance and power consumption when the device does not operate at + the maximum frequency. + (+) For STM32F405xx/407xx and STM32F415xx/417xx Devices, the regulator can be + configured on the fly through PWR_MainRegulatorModeConfig() function which + configure VOS bit in PWR_CR register: + (++) When this bit is set (Regulator voltage output Scale 1 mode selected) + the System frequency can go up to 168 MHz. + (++) When this bit is reset (Regulator voltage output Scale 2 mode selected) + the System frequency can go up to 144 MHz. + + (+) For STM32F42xxx/43xxx Devices, the regulator can be configured through + PWR_MainRegulatorModeConfig() function which configure VOS[1:0] bits in + PWR_CR register: + which configure VOS[1:0] bits in PWR_CR register: + (++) When VOS[1:0] = 11 (Regulator voltage output Scale 1 mode selected) + the System frequency can go up to 168 MHz. + (++) When VOS[1:0] = 10 (Regulator voltage output Scale 2 mode selected) + the System frequency can go up to 144 MHz. + (++) When VOS[1:0] = 01 (Regulator voltage output Scale 3 mode selected) + the System frequency can go up to 120 MHz. + + (+) For STM32F42xxx/43xxx Devices, the scale can be modified only when the PLL + is OFF and the HSI or HSE clock source is selected as system clock. + The new value programmed is active only when the PLL is ON. + When the PLL is OFF, the voltage scale 3 is automatically selected. + Refer to the datasheets for more details. + + (+) For STM32F42xxx/43xxx Devices, in Run mode: the main regulator has + 2 operating modes available: + (++) Normal mode: The CPU and core logic operate at maximum frequency at a given + voltage scaling (scale 1, scale 2 or scale 3) + (++) Over-drive mode: This mode allows the CPU and the core logic to operate at a + higher frequency than the normal mode for a given voltage scaling (scale 1, + scale 2 or scale 3). This mode is enabled through PWR_OverDriveCmd() function and + PWR_OverDriveSWCmd() function, to enter or exit from Over-drive mode please follow + the sequence described in Reference manual. + + (+) For STM32F42xxx/43xxx Devices, in Stop mode: the main regulator or low power regulator + supplies a low power voltage to the 1.2V domain, thus preserving the content of registers + and internal SRAM. 2 operating modes are available: + (++) Normal mode: the 1.2V domain is preserved in nominal leakage mode. This mode is only + available when the main regulator or the low power regulator is used in Scale 3 or + low voltage mode. + (++) Under-drive mode: the 1.2V domain is preserved in reduced leakage mode. This mode is only + available when the main regulator or the low power regulator is in low voltage mode. + This mode is enabled through PWR_UnderDriveCmd() function. + +@endverbatim + * @{ + */ + +/** + * @brief Enables or disables the Backup Regulator. + * @param NewState: new state of the Backup Regulator. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void PWR_BackupRegulatorCmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + *(__IO uint32_t *) CSR_BRE_BB = (uint32_t)NewState; +} + +/** + * @brief Configures the main internal regulator output voltage. + * @param PWR_Regulator_Voltage: specifies the regulator output voltage to achieve + * a tradeoff between performance and power consumption when the device does + * not operate at the maximum frequency (refer to the datasheets for more details). + * This parameter can be one of the following values: + * @arg PWR_Regulator_Voltage_Scale1: Regulator voltage output Scale 1 mode, + * System frequency up to 168 MHz. + * @arg PWR_Regulator_Voltage_Scale2: Regulator voltage output Scale 2 mode, + * System frequency up to 144 MHz. + * @arg PWR_Regulator_Voltage_Scale3: Regulator voltage output Scale 3 mode, + * System frequency up to 120 MHz (only for STM32F42xxx/43xxx devices) + * @retval None + */ +void PWR_MainRegulatorModeConfig(uint32_t PWR_Regulator_Voltage) +{ + uint32_t tmpreg = 0; + + /* Check the parameters */ + assert_param(IS_PWR_REGULATOR_VOLTAGE(PWR_Regulator_Voltage)); + + tmpreg = PWR->CR; + + /* Clear VOS[15:14] bits */ + tmpreg &= CR_VOS_MASK; + + /* Set VOS[15:14] bits according to PWR_Regulator_Voltage value */ + tmpreg |= PWR_Regulator_Voltage; + + /* Store the new value */ + PWR->CR = tmpreg; +} + +/** + * @brief Enables or disables the Over-Drive. + * + * @note This function can be used only for STM32F42xxx/STM3243xxx devices. + * This mode allows the CPU and the core logic to operate at a higher frequency + * than the normal mode for a given voltage scaling (scale 1, scale 2 or scale 3). + * + * @note It is recommended to enter or exit Over-drive mode when the application is not running + * critical tasks and when the system clock source is either HSI or HSE. + * During the Over-drive switch activation, no peripheral clocks should be enabled. + * The peripheral clocks must be enabled once the Over-drive mode is activated. + * + * @param NewState: new state of the Over Drive mode. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void PWR_OverDriveCmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + /* Set/Reset the ODEN bit to enable/disable the Over Drive mode */ + *(__IO uint32_t *) CR_ODEN_BB = (uint32_t)NewState; +} + +/** + * @brief Enables or disables the Over-Drive switching. + * + * @note This function can be used only for STM32F42xxx/STM3243xxx devices. + * + * @param NewState: new state of the Over Drive switching mode. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void PWR_OverDriveSWCmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + /* Set/Reset the ODSWEN bit to enable/disable the Over Drive switching mode */ + *(__IO uint32_t *) CR_ODSWEN_BB = (uint32_t)NewState; +} + +/** + * @brief Enables or disables the Under-Drive mode. + * + * @note This function can be used only for STM32F42xxx/STM3243xxx devices. + * @note This mode is enabled only with STOP low power mode. + * In this mode, the 1.2V domain is preserved in reduced leakage mode. This + * mode is only available when the main regulator or the low power regulator + * is in low voltage mode + * + * @note If the Under-drive mode was enabled, it is automatically disabled after + * exiting Stop mode. + * When the voltage regulator operates in Under-drive mode, an additional + * startup delay is induced when waking up from Stop mode. + * + * @param NewState: new state of the Under Drive mode. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void PWR_UnderDriveCmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Set the UDEN[1:0] bits to enable the Under Drive mode */ + PWR->CR |= (uint32_t)PWR_CR_UDEN; + } + else + { + /* Reset the UDEN[1:0] bits to disable the Under Drive mode */ + PWR->CR &= (uint32_t)(~PWR_CR_UDEN); + } +} + +/** + * @brief Enables or disables the Main Regulator low voltage mode. + * + * @note This mode is only available for STM32F401xx/STM32F411xx devices. + * + * @param NewState: new state of the Under Drive mode. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void PWR_MainRegulatorLowVoltageCmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + *(__IO uint32_t *) CR_MRLVDS_BB = (uint32_t)ENABLE; + } + else + { + *(__IO uint32_t *) CR_MRLVDS_BB = (uint32_t)DISABLE; + } +} + +/** + * @brief Enables or disables the Low Power Regulator low voltage mode. + * + * @note This mode is only available for STM32F401xx/STM32F411xx devices. + * + * @param NewState: new state of the Under Drive mode. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void PWR_LowRegulatorLowVoltageCmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + *(__IO uint32_t *) CR_LPLVDS_BB = (uint32_t)ENABLE; + } + else + { + *(__IO uint32_t *) CR_LPLVDS_BB = (uint32_t)DISABLE; + } +} + +/** + * @} + */ + +/** @defgroup PWR_Group5 FLASH Power Down configuration functions + * @brief FLASH Power Down configuration functions + * +@verbatim + =============================================================================== + ##### FLASH Power Down configuration functions ##### + =============================================================================== + [..] + (+) By setting the FPDS bit in the PWR_CR register by using the + PWR_FlashPowerDownCmd() function, the Flash memory also enters power + down mode when the device enters Stop mode. When the Flash memory + is in power down mode, an additional startup delay is incurred when + waking up from Stop mode. +@endverbatim + * @{ + */ + +/** + * @brief Enables or disables the Flash Power Down in STOP mode. + * @param NewState: new state of the Flash power mode. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void PWR_FlashPowerDownCmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + *(__IO uint32_t *) CR_FPDS_BB = (uint32_t)NewState; +} + +/** + * @} + */ + +/** @defgroup PWR_Group6 Low Power modes configuration functions + * @brief Low Power modes configuration functions + * +@verbatim + =============================================================================== + ##### Low Power modes configuration functions ##### + =============================================================================== + [..] + The devices feature 3 low-power modes: + (+) Sleep mode: Cortex-M4 core stopped, peripherals kept running. + (+) Stop mode: all clocks are stopped, regulator running, regulator + in low power mode + (+) Standby mode: 1.2V domain powered off. + + *** Sleep mode *** + ================== + [..] + (+) Entry: + (++) The Sleep mode is entered by using the __WFI() or __WFE() functions. + (+) Exit: + (++) Any peripheral interrupt acknowledged by the nested vectored interrupt + controller (NVIC) can wake up the device from Sleep mode. + + *** Stop mode *** + ================= + [..] + In Stop mode, all clocks in the 1.2V domain are stopped, the PLL, the HSI, + and the HSE RC oscillators are disabled. Internal SRAM and register contents + are preserved. + The voltage regulator can be configured either in normal or low-power mode. + To minimize the consumption In Stop mode, FLASH can be powered off before + entering the Stop mode. It can be switched on again by software after exiting + the Stop mode using the PWR_FlashPowerDownCmd() function. + + (+) Entry: + (++) The Stop mode is entered using the PWR_EnterSTOPMode(PWR_MainRegulator_ON) + function with: + (+++) Main regulator ON. + (+++) Low Power regulator ON. + (+) Exit: + (++) Any EXTI Line (Internal or External) configured in Interrupt/Event mode. + + *** Standby mode *** + ==================== + [..] + The Standby mode allows to achieve the lowest power consumption. It is based + on the Cortex-M4 deepsleep mode, with the voltage regulator disabled. + The 1.2V domain is consequently powered off. The PLL, the HSI oscillator and + the HSE oscillator are also switched off. SRAM and register contents are lost + except for the RTC registers, RTC backup registers, backup SRAM and Standby + circuitry. + + The voltage regulator is OFF. + + (+) Entry: + (++) The Standby mode is entered using the PWR_EnterSTANDBYMode() function. + (+) Exit: + (++) WKUP pin rising edge, RTC alarm (Alarm A and Alarm B), RTC wakeup, + tamper event, time-stamp event, external reset in NRST pin, IWDG reset. + + *** Auto-wakeup (AWU) from low-power mode *** + ============================================= + [..] + The MCU can be woken up from low-power mode by an RTC Alarm event, an RTC + Wakeup event, a tamper event, a time-stamp event, or a comparator event, + without depending on an external interrupt (Auto-wakeup mode). + + (#) RTC auto-wakeup (AWU) from the Stop mode + + (++) To wake up from the Stop mode with an RTC alarm event, it is necessary to: + (+++) Configure the EXTI Line 17 to be sensitive to rising edges (Interrupt + or Event modes) using the EXTI_Init() function. + (+++) Enable the RTC Alarm Interrupt using the RTC_ITConfig() function + (+++) Configure the RTC to generate the RTC alarm using the RTC_SetAlarm() + and RTC_AlarmCmd() functions. + (++) To wake up from the Stop mode with an RTC Tamper or time stamp event, it + is necessary to: + (+++) Configure the EXTI Line 21 to be sensitive to rising edges (Interrupt + or Event modes) using the EXTI_Init() function. + (+++) Enable the RTC Tamper or time stamp Interrupt using the RTC_ITConfig() + function + (+++) Configure the RTC to detect the tamper or time stamp event using the + RTC_TimeStampConfig(), RTC_TamperTriggerConfig() and RTC_TamperCmd() + functions. + (++) To wake up from the Stop mode with an RTC WakeUp event, it is necessary to: + (+++) Configure the EXTI Line 22 to be sensitive to rising edges (Interrupt + or Event modes) using the EXTI_Init() function. + (+++) Enable the RTC WakeUp Interrupt using the RTC_ITConfig() function + (+++) Configure the RTC to generate the RTC WakeUp event using the RTC_WakeUpClockConfig(), + RTC_SetWakeUpCounter() and RTC_WakeUpCmd() functions. + + (#) RTC auto-wakeup (AWU) from the Standby mode + + (++) To wake up from the Standby mode with an RTC alarm event, it is necessary to: + (+++) Enable the RTC Alarm Interrupt using the RTC_ITConfig() function + (+++) Configure the RTC to generate the RTC alarm using the RTC_SetAlarm() + and RTC_AlarmCmd() functions. + (++) To wake up from the Standby mode with an RTC Tamper or time stamp event, it + is necessary to: + (+++) Enable the RTC Tamper or time stamp Interrupt using the RTC_ITConfig() + function + (+++) Configure the RTC to detect the tamper or time stamp event using the + RTC_TimeStampConfig(), RTC_TamperTriggerConfig() and RTC_TamperCmd() + functions. + (++) To wake up from the Standby mode with an RTC WakeUp event, it is necessary to: + (+++) Enable the RTC WakeUp Interrupt using the RTC_ITConfig() function + (+++) Configure the RTC to generate the RTC WakeUp event using the RTC_WakeUpClockConfig(), + RTC_SetWakeUpCounter() and RTC_WakeUpCmd() functions. + +@endverbatim + * @{ + */ + +/** + * @brief Enters STOP mode. + * + * @note In Stop mode, all I/O pins keep the same state as in Run mode. + * @note When exiting Stop mode by issuing an interrupt or a wakeup event, + * the HSI RC oscillator is selected as system clock. + * @note When the voltage regulator operates in low power mode, an additional + * startup delay is incurred when waking up from Stop mode. + * By keeping the internal regulator ON during Stop mode, the consumption + * is higher although the startup time is reduced. + * + * @param PWR_Regulator: specifies the regulator state in STOP mode. + * This parameter can be one of the following values: + * @arg PWR_MainRegulator_ON: STOP mode with regulator ON + * @arg PWR_LowPowerRegulator_ON: STOP mode with low power regulator ON + * @param PWR_STOPEntry: specifies if STOP mode in entered with WFI or WFE instruction. + * This parameter can be one of the following values: + * @arg PWR_STOPEntry_WFI: enter STOP mode with WFI instruction + * @arg PWR_STOPEntry_WFE: enter STOP mode with WFE instruction + * @retval None + */ +void PWR_EnterSTOPMode(uint32_t PWR_Regulator, uint8_t PWR_STOPEntry) +{ + uint32_t tmpreg = 0; + + /* Check the parameters */ + assert_param(IS_PWR_REGULATOR(PWR_Regulator)); + assert_param(IS_PWR_STOP_ENTRY(PWR_STOPEntry)); + + /* Select the regulator state in STOP mode ---------------------------------*/ + tmpreg = PWR->CR; + /* Clear PDDS and LPDS bits */ + tmpreg &= CR_DS_MASK; + + /* Set LPDS, MRLVDS and LPLVDS bits according to PWR_Regulator value */ + tmpreg |= PWR_Regulator; + + /* Store the new value */ + PWR->CR = tmpreg; + + /* Set SLEEPDEEP bit of Cortex System Control Register */ + SCB->SCR |= SCB_SCR_SLEEPDEEP_Msk; + + /* Select STOP mode entry --------------------------------------------------*/ + if(PWR_STOPEntry == PWR_STOPEntry_WFI) + { + /* Request Wait For Interrupt */ + __WFI(); + } + else + { + /* Request Wait For Event */ + __WFE(); + } + /* Reset SLEEPDEEP bit of Cortex System Control Register */ + SCB->SCR &= (uint32_t)~((uint32_t)SCB_SCR_SLEEPDEEP_Msk); +} + +/** + * @brief Enters in Under-Drive STOP mode. + * + * @note This mode is only available for STM32F42xxx/STM3243xxx devices. + * + * @note This mode can be selected only when the Under-Drive is already active + * + * @note In Stop mode, all I/O pins keep the same state as in Run mode. + * @note When exiting Stop mode by issuing an interrupt or a wakeup event, + * the HSI RC oscillator is selected as system clock. + * @note When the voltage regulator operates in low power mode, an additional + * startup delay is incurred when waking up from Stop mode. + * By keeping the internal regulator ON during Stop mode, the consumption + * is higher although the startup time is reduced. + * + * @param PWR_Regulator: specifies the regulator state in STOP mode. + * This parameter can be one of the following values: + * @arg PWR_MainRegulator_UnderDrive_ON: Main Regulator in under-drive mode + * and Flash memory in power-down when the device is in Stop under-drive mode + * @arg PWR_LowPowerRegulator_UnderDrive_ON: Low Power Regulator in under-drive mode + * and Flash memory in power-down when the device is in Stop under-drive mode + * @param PWR_STOPEntry: specifies if STOP mode in entered with WFI or WFE instruction. + * This parameter can be one of the following values: + * @arg PWR_STOPEntry_WFI: enter STOP mode with WFI instruction + * @arg PWR_STOPEntry_WFE: enter STOP mode with WFE instruction + * @retval None + */ +void PWR_EnterUnderDriveSTOPMode(uint32_t PWR_Regulator, uint8_t PWR_STOPEntry) +{ + uint32_t tmpreg = 0; + + /* Check the parameters */ + assert_param(IS_PWR_REGULATOR_UNDERDRIVE(PWR_Regulator)); + assert_param(IS_PWR_STOP_ENTRY(PWR_STOPEntry)); + + /* Select the regulator state in STOP mode ---------------------------------*/ + tmpreg = PWR->CR; + /* Clear PDDS and LPDS bits */ + tmpreg &= CR_DS_MASK; + + /* Set LPDS, MRLUDS and LPLUDS bits according to PWR_Regulator value */ + tmpreg |= PWR_Regulator; + + /* Store the new value */ + PWR->CR = tmpreg; + + /* Set SLEEPDEEP bit of Cortex System Control Register */ + SCB->SCR |= SCB_SCR_SLEEPDEEP_Msk; + + /* Select STOP mode entry --------------------------------------------------*/ + if(PWR_STOPEntry == PWR_STOPEntry_WFI) + { + /* Request Wait For Interrupt */ + __WFI(); + } + else + { + /* Request Wait For Event */ + __WFE(); + } + /* Reset SLEEPDEEP bit of Cortex System Control Register */ + SCB->SCR &= (uint32_t)~((uint32_t)SCB_SCR_SLEEPDEEP_Msk); +} + +/** + * @brief Enters STANDBY mode. + * @note In Standby mode, all I/O pins are high impedance except for: + * - Reset pad (still available) + * - RTC_AF1 pin (PC13) if configured for tamper, time-stamp, RTC + * Alarm out, or RTC clock calibration out. + * - RTC_AF2 pin (PI8) if configured for tamper or time-stamp. + * - WKUP pin 1 (PA0) if enabled. + * @note The Wakeup flag (WUF) need to be cleared at application level before to call this function + * @param None + * @retval None + */ +void PWR_EnterSTANDBYMode(void) +{ + /* Select STANDBY mode */ + PWR->CR |= PWR_CR_PDDS; + + /* Set SLEEPDEEP bit of Cortex System Control Register */ + SCB->SCR |= SCB_SCR_SLEEPDEEP_Msk; + + /* This option is used to ensure that store operations are completed */ +#if defined ( __CC_ARM ) + __force_stores(); +#endif + /* Request Wait For Interrupt */ + __WFI(); +} + +/** + * @} + */ + +/** @defgroup PWR_Group7 Flags management functions + * @brief Flags management functions + * +@verbatim + =============================================================================== + ##### Flags management functions ##### + =============================================================================== + +@endverbatim + * @{ + */ + +/** + * @brief Checks whether the specified PWR flag is set or not. + * @param PWR_FLAG: specifies the flag to check. + * This parameter can be one of the following values: + * @arg PWR_FLAG_WU: Wake Up flag. This flag indicates that a wakeup event + * was received from the WKUP pin or from the RTC alarm (Alarm A + * or Alarm B), RTC Tamper event, RTC TimeStamp event or RTC Wakeup. + * An additional wakeup event is detected if the WKUP pin is enabled + * (by setting the EWUP bit) when the WKUP pin level is already high. + * @arg PWR_FLAG_SB: StandBy flag. This flag indicates that the system was + * resumed from StandBy mode. + * @arg PWR_FLAG_PVDO: PVD Output. This flag is valid only if PVD is enabled + * by the PWR_PVDCmd() function. The PVD is stopped by Standby mode + * For this reason, this bit is equal to 0 after Standby or reset + * until the PVDE bit is set. + * @arg PWR_FLAG_BRR: Backup regulator ready flag. This bit is not reset + * when the device wakes up from Standby mode or by a system reset + * or power reset. + * @arg PWR_FLAG_VOSRDY: This flag indicates that the Regulator voltage + * scaling output selection is ready. + * @arg PWR_FLAG_ODRDY: This flag indicates that the Over-drive mode + * is ready (STM32F42xxx/43xxx devices) + * @arg PWR_FLAG_ODSWRDY: This flag indicates that the Over-drive mode + * switcching is ready (STM32F42xxx/43xxx devices) + * @arg PWR_FLAG_UDRDY: This flag indicates that the Under-drive mode + * is enabled in Stop mode (STM32F42xxx/43xxx devices) + * @retval The new state of PWR_FLAG (SET or RESET). + */ +FlagStatus PWR_GetFlagStatus(uint32_t PWR_FLAG) +{ + FlagStatus bitstatus = RESET; + + /* Check the parameters */ + assert_param(IS_PWR_GET_FLAG(PWR_FLAG)); + + if ((PWR->CSR & PWR_FLAG) != (uint32_t)RESET) + { + bitstatus = SET; + } + else + { + bitstatus = RESET; + } + /* Return the flag status */ + return bitstatus; +} + +/** + * @brief Clears the PWR's pending flags. + * @param PWR_FLAG: specifies the flag to clear. + * This parameter can be one of the following values: + * @arg PWR_FLAG_WU: Wake Up flag + * @arg PWR_FLAG_SB: StandBy flag + * @arg PWR_FLAG_UDRDY: Under-drive ready flag (STM32F42xxx/43xxx devices) + * @retval None + */ +void PWR_ClearFlag(uint32_t PWR_FLAG) +{ + /* Check the parameters */ + assert_param(IS_PWR_CLEAR_FLAG(PWR_FLAG)); + +#if defined (STM32F427_437xx) || defined (STM32F429_439xx) + if (PWR_FLAG != PWR_FLAG_UDRDY) + { + PWR->CR |= PWR_FLAG << 2; + } + else + { + PWR->CSR |= PWR_FLAG_UDRDY; + } +#endif /* STM32F427_437xx || STM32F429_439xx */ + +#if defined (STM32F40_41xxx) || defined (STM32F401xx) || defined (STM32F411xE) + PWR->CR |= PWR_FLAG << 2; +#endif /* STM32F40_41xxx || STM32F401xx || STM32F411xE */ +} + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/src/stm32f4xx_rcc.c b/FWLIB/src/stm32f4xx_rcc.c new file mode 100644 index 0000000..7082975 --- /dev/null +++ b/FWLIB/src/stm32f4xx_rcc.c @@ -0,0 +1,2307 @@ +/** + ****************************************************************************** + * @file stm32f4xx_rcc.c + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file provides firmware functions to manage the following + * functionalities of the Reset and clock control (RCC) peripheral: + * + Internal/external clocks, PLL, CSS and MCO configuration + * + System, AHB and APB busses clocks configuration + * + Peripheral clocks configuration + * + Interrupts and flags management + * + @verbatim + =============================================================================== + ##### RCC specific features ##### + =============================================================================== + [..] + After reset the device is running from Internal High Speed oscillator + (HSI 16MHz) with Flash 0 wait state, Flash prefetch buffer, D-Cache + and I-Cache are disabled, and all peripherals are off except internal + SRAM, Flash and JTAG. + (+) There is no prescaler on High speed (AHB) and Low speed (APB) busses; + all peripherals mapped on these busses are running at HSI speed. + (+) The clock for all peripherals is switched off, except the SRAM and FLASH. + (+) All GPIOs are in input floating state, except the JTAG pins which + are assigned to be used for debug purpose. + [..] + Once the device started from reset, the user application has to: + (+) Configure the clock source to be used to drive the System clock + (if the application needs higher frequency/performance) + (+) Configure the System clock frequency and Flash settings + (+) Configure the AHB and APB busses prescalers + (+) Enable the clock for the peripheral(s) to be used + (+) Configure the clock source(s) for peripherals which clocks are not + derived from the System clock (I2S, RTC, ADC, USB OTG FS/SDIO/RNG) + @endverbatim + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx_rcc.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @defgroup RCC + * @brief RCC driver modules + * @{ + */ + +/* Private typedef -----------------------------------------------------------*/ +/* Private define ------------------------------------------------------------*/ +/* ------------ RCC registers bit address in the alias region ----------- */ +#define RCC_OFFSET (RCC_BASE - PERIPH_BASE) +/* --- CR Register ---*/ +/* Alias word address of HSION bit */ +#define CR_OFFSET (RCC_OFFSET + 0x00) +#define HSION_BitNumber 0x00 +#define CR_HSION_BB (PERIPH_BB_BASE + (CR_OFFSET * 32) + (HSION_BitNumber * 4)) +/* Alias word address of CSSON bit */ +#define CSSON_BitNumber 0x13 +#define CR_CSSON_BB (PERIPH_BB_BASE + (CR_OFFSET * 32) + (CSSON_BitNumber * 4)) +/* Alias word address of PLLON bit */ +#define PLLON_BitNumber 0x18 +#define CR_PLLON_BB (PERIPH_BB_BASE + (CR_OFFSET * 32) + (PLLON_BitNumber * 4)) +/* Alias word address of PLLI2SON bit */ +#define PLLI2SON_BitNumber 0x1A +#define CR_PLLI2SON_BB (PERIPH_BB_BASE + (CR_OFFSET * 32) + (PLLI2SON_BitNumber * 4)) + +/* Alias word address of PLLSAION bit */ +#define PLLSAION_BitNumber 0x1C +#define CR_PLLSAION_BB (PERIPH_BB_BASE + (CR_OFFSET * 32) + (PLLSAION_BitNumber * 4)) + +/* --- CFGR Register ---*/ +/* Alias word address of I2SSRC bit */ +#define CFGR_OFFSET (RCC_OFFSET + 0x08) +#define I2SSRC_BitNumber 0x17 +#define CFGR_I2SSRC_BB (PERIPH_BB_BASE + (CFGR_OFFSET * 32) + (I2SSRC_BitNumber * 4)) + +/* --- BDCR Register ---*/ +/* Alias word address of RTCEN bit */ +#define BDCR_OFFSET (RCC_OFFSET + 0x70) +#define RTCEN_BitNumber 0x0F +#define BDCR_RTCEN_BB (PERIPH_BB_BASE + (BDCR_OFFSET * 32) + (RTCEN_BitNumber * 4)) +/* Alias word address of BDRST bit */ +#define BDRST_BitNumber 0x10 +#define BDCR_BDRST_BB (PERIPH_BB_BASE + (BDCR_OFFSET * 32) + (BDRST_BitNumber * 4)) + +/* --- CSR Register ---*/ +/* Alias word address of LSION bit */ +#define CSR_OFFSET (RCC_OFFSET + 0x74) +#define LSION_BitNumber 0x00 +#define CSR_LSION_BB (PERIPH_BB_BASE + (CSR_OFFSET * 32) + (LSION_BitNumber * 4)) + +/* --- DCKCFGR Register ---*/ +/* Alias word address of TIMPRE bit */ +#define DCKCFGR_OFFSET (RCC_OFFSET + 0x8C) +#define TIMPRE_BitNumber 0x18 +#define DCKCFGR_TIMPRE_BB (PERIPH_BB_BASE + (DCKCFGR_OFFSET * 32) + (TIMPRE_BitNumber * 4)) +/* ---------------------- RCC registers bit mask ------------------------ */ +/* CFGR register bit mask */ +#define CFGR_MCO2_RESET_MASK ((uint32_t)0x07FFFFFF) +#define CFGR_MCO1_RESET_MASK ((uint32_t)0xF89FFFFF) + +/* RCC Flag Mask */ +#define FLAG_MASK ((uint8_t)0x1F) + +/* CR register byte 3 (Bits[23:16]) base address */ +#define CR_BYTE3_ADDRESS ((uint32_t)0x40023802) + +/* CIR register byte 2 (Bits[15:8]) base address */ +#define CIR_BYTE2_ADDRESS ((uint32_t)(RCC_BASE + 0x0C + 0x01)) + +/* CIR register byte 3 (Bits[23:16]) base address */ +#define CIR_BYTE3_ADDRESS ((uint32_t)(RCC_BASE + 0x0C + 0x02)) + +/* BDCR register base address */ +#define BDCR_ADDRESS (PERIPH_BASE + BDCR_OFFSET) + +/* Private macro -------------------------------------------------------------*/ +/* Private variables ---------------------------------------------------------*/ +static __I uint8_t APBAHBPrescTable[16] = {0, 0, 0, 0, 1, 2, 3, 4, 1, 2, 3, 4, 6, 7, 8, 9}; + +/* Private function prototypes -----------------------------------------------*/ +/* Private functions ---------------------------------------------------------*/ + +/** @defgroup RCC_Private_Functions + * @{ + */ + +/** @defgroup RCC_Group1 Internal and external clocks, PLL, CSS and MCO configuration functions + * @brief Internal and external clocks, PLL, CSS and MCO configuration functions + * +@verbatim + =================================================================================== + ##### Internal and external clocks, PLL, CSS and MCO configuration functions ##### + =================================================================================== + [..] + This section provide functions allowing to configure the internal/external clocks, + PLLs, CSS and MCO pins. + + (#) HSI (high-speed internal), 16 MHz factory-trimmed RC used directly or through + the PLL as System clock source. + + (#) LSI (low-speed internal), 32 KHz low consumption RC used as IWDG and/or RTC + clock source. + + (#) HSE (high-speed external), 4 to 26 MHz crystal oscillator used directly or + through the PLL as System clock source. Can be used also as RTC clock source. + + (#) LSE (low-speed external), 32 KHz oscillator used as RTC clock source. + + (#) PLL (clocked by HSI or HSE), featuring two different output clocks: + (++) The first output is used to generate the high speed system clock (up to 168 MHz) + (++) The second output is used to generate the clock for the USB OTG FS (48 MHz), + the random analog generator (<=48 MHz) and the SDIO (<= 48 MHz). + + (#) PLLI2S (clocked by HSI or HSE), used to generate an accurate clock to achieve + high-quality audio performance on the I2S interface or SAI interface in case + of STM32F429x/439x devices. + + (#) PLLSAI clocked by (HSI or HSE), used to generate an accurate clock to SAI + interface and LCD TFT controller available only for STM32F42xxx/43xxx devices. + + (#) CSS (Clock security system), once enable and if a HSE clock failure occurs + (HSE used directly or through PLL as System clock source), the System clock + is automatically switched to HSI and an interrupt is generated if enabled. + The interrupt is linked to the Cortex-M4 NMI (Non-Maskable Interrupt) + exception vector. + + (#) MCO1 (microcontroller clock output), used to output HSI, LSE, HSE or PLL + clock (through a configurable prescaler) on PA8 pin. + + (#) MCO2 (microcontroller clock output), used to output HSE, PLL, SYSCLK or PLLI2S + clock (through a configurable prescaler) on PC9 pin. + @endverbatim + * @{ + */ + +/** + * @brief Resets the RCC clock configuration to the default reset state. + * @note The default reset state of the clock configuration is given below: + * - HSI ON and used as system clock source + * - HSE, PLL and PLLI2S OFF + * - AHB, APB1 and APB2 prescaler set to 1. + * - CSS, MCO1 and MCO2 OFF + * - All interrupts disabled + * @note This function doesn't modify the configuration of the + * - Peripheral clocks + * - LSI, LSE and RTC clocks + * @param None + * @retval None + */ +void RCC_DeInit(void) +{ + /* Set HSION bit */ + RCC->CR |= (uint32_t)0x00000001; + + /* Reset CFGR register */ + RCC->CFGR = 0x00000000; + + /* Reset HSEON, CSSON, PLLON, PLLI2S and PLLSAI(STM32F42/43xxx devices) bits */ + RCC->CR &= (uint32_t)0xEAF6FFFF; + + /* Reset PLLCFGR register */ + RCC->PLLCFGR = 0x24003010; + + /* Reset PLLI2SCFGR register */ + RCC->PLLI2SCFGR = 0x20003000; + + /* Reset PLLSAICFGR register, only available for STM32F42/43xxx devices */ + RCC->PLLSAICFGR = 0x24003000; + + /* Reset HSEBYP bit */ + RCC->CR &= (uint32_t)0xFFFBFFFF; + + /* Disable all interrupts */ + RCC->CIR = 0x00000000; + + /* Disable Timers clock prescalers selection, only available for STM32F42/43xxx devices */ + RCC->DCKCFGR = 0x00000000; +} + +/** + * @brief Configures the External High Speed oscillator (HSE). + * @note After enabling the HSE (RCC_HSE_ON or RCC_HSE_Bypass), the application + * software should wait on HSERDY flag to be set indicating that HSE clock + * is stable and can be used to clock the PLL and/or system clock. + * @note HSE state can not be changed if it is used directly or through the + * PLL as system clock. In this case, you have to select another source + * of the system clock then change the HSE state (ex. disable it). + * @note The HSE is stopped by hardware when entering STOP and STANDBY modes. + * @note This function reset the CSSON bit, so if the Clock security system(CSS) + * was previously enabled you have to enable it again after calling this + * function. + * @param RCC_HSE: specifies the new state of the HSE. + * This parameter can be one of the following values: + * @arg RCC_HSE_OFF: turn OFF the HSE oscillator, HSERDY flag goes low after + * 6 HSE oscillator clock cycles. + * @arg RCC_HSE_ON: turn ON the HSE oscillator + * @arg RCC_HSE_Bypass: HSE oscillator bypassed with external clock + * @retval None + */ +void RCC_HSEConfig(uint8_t RCC_HSE) +{ + /* Check the parameters */ + assert_param(IS_RCC_HSE(RCC_HSE)); + + /* Reset HSEON and HSEBYP bits before configuring the HSE ------------------*/ + *(__IO uint8_t *) CR_BYTE3_ADDRESS = RCC_HSE_OFF; + + /* Set the new HSE configuration -------------------------------------------*/ + *(__IO uint8_t *) CR_BYTE3_ADDRESS = RCC_HSE; +} + +/** + * @brief Waits for HSE start-up. + * @note This functions waits on HSERDY flag to be set and return SUCCESS if + * this flag is set, otherwise returns ERROR if the timeout is reached + * and this flag is not set. The timeout value is defined by the constant + * HSE_STARTUP_TIMEOUT in stm32f4xx.h file. You can tailor it depending + * on the HSE crystal used in your application. + * @param None + * @retval An ErrorStatus enumeration value: + * - SUCCESS: HSE oscillator is stable and ready to use + * - ERROR: HSE oscillator not yet ready + */ +ErrorStatus RCC_WaitForHSEStartUp(void) +{ + __IO uint32_t startupcounter = 0; + ErrorStatus status = ERROR; + FlagStatus hsestatus = RESET; + /* Wait till HSE is ready and if Time out is reached exit */ + do + { + hsestatus = RCC_GetFlagStatus(RCC_FLAG_HSERDY); + startupcounter++; + } while((startupcounter != HSE_STARTUP_TIMEOUT) && (hsestatus == RESET)); + + if (RCC_GetFlagStatus(RCC_FLAG_HSERDY) != RESET) + { + status = SUCCESS; + } + else + { + status = ERROR; + } + return (status); +} + +/** + * @brief Adjusts the Internal High Speed oscillator (HSI) calibration value. + * @note The calibration is used to compensate for the variations in voltage + * and temperature that influence the frequency of the internal HSI RC. + * @param HSICalibrationValue: specifies the calibration trimming value. + * This parameter must be a number between 0 and 0x1F. + * @retval None + */ +void RCC_AdjustHSICalibrationValue(uint8_t HSICalibrationValue) +{ + uint32_t tmpreg = 0; + /* Check the parameters */ + assert_param(IS_RCC_CALIBRATION_VALUE(HSICalibrationValue)); + + tmpreg = RCC->CR; + + /* Clear HSITRIM[4:0] bits */ + tmpreg &= ~RCC_CR_HSITRIM; + + /* Set the HSITRIM[4:0] bits according to HSICalibrationValue value */ + tmpreg |= (uint32_t)HSICalibrationValue << 3; + + /* Store the new value */ + RCC->CR = tmpreg; +} + +/** + * @brief Enables or disables the Internal High Speed oscillator (HSI). + * @note The HSI is stopped by hardware when entering STOP and STANDBY modes. + * It is used (enabled by hardware) as system clock source after startup + * from Reset, wakeup from STOP and STANDBY mode, or in case of failure + * of the HSE used directly or indirectly as system clock (if the Clock + * Security System CSS is enabled). + * @note HSI can not be stopped if it is used as system clock source. In this case, + * you have to select another source of the system clock then stop the HSI. + * @note After enabling the HSI, the application software should wait on HSIRDY + * flag to be set indicating that HSI clock is stable and can be used as + * system clock source. + * @param NewState: new state of the HSI. + * This parameter can be: ENABLE or DISABLE. + * @note When the HSI is stopped, HSIRDY flag goes low after 6 HSI oscillator + * clock cycles. + * @retval None + */ +void RCC_HSICmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + *(__IO uint32_t *) CR_HSION_BB = (uint32_t)NewState; +} + +/** + * @brief Configures the External Low Speed oscillator (LSE). + * @note As the LSE is in the Backup domain and write access is denied to + * this domain after reset, you have to enable write access using + * PWR_BackupAccessCmd(ENABLE) function before to configure the LSE + * (to be done once after reset). + * @note After enabling the LSE (RCC_LSE_ON or RCC_LSE_Bypass), the application + * software should wait on LSERDY flag to be set indicating that LSE clock + * is stable and can be used to clock the RTC. + * @param RCC_LSE: specifies the new state of the LSE. + * This parameter can be one of the following values: + * @arg RCC_LSE_OFF: turn OFF the LSE oscillator, LSERDY flag goes low after + * 6 LSE oscillator clock cycles. + * @arg RCC_LSE_ON: turn ON the LSE oscillator + * @arg RCC_LSE_Bypass: LSE oscillator bypassed with external clock + * @retval None + */ +void RCC_LSEConfig(uint8_t RCC_LSE) +{ + /* Check the parameters */ + assert_param(IS_RCC_LSE(RCC_LSE)); + + /* Reset LSEON and LSEBYP bits before configuring the LSE ------------------*/ + /* Reset LSEON bit */ + *(__IO uint8_t *) BDCR_ADDRESS = RCC_LSE_OFF; + + /* Reset LSEBYP bit */ + *(__IO uint8_t *) BDCR_ADDRESS = RCC_LSE_OFF; + + /* Configure LSE (RCC_LSE_OFF is already covered by the code section above) */ + switch (RCC_LSE) + { + case RCC_LSE_ON: + /* Set LSEON bit */ + *(__IO uint8_t *) BDCR_ADDRESS = RCC_LSE_ON; + break; + case RCC_LSE_Bypass: + /* Set LSEBYP and LSEON bits */ + *(__IO uint8_t *) BDCR_ADDRESS = RCC_LSE_Bypass | RCC_LSE_ON; + break; + default: + break; + } +} + +/** + * @brief Enables or disables the Internal Low Speed oscillator (LSI). + * @note After enabling the LSI, the application software should wait on + * LSIRDY flag to be set indicating that LSI clock is stable and can + * be used to clock the IWDG and/or the RTC. + * @note LSI can not be disabled if the IWDG is running. + * @param NewState: new state of the LSI. + * This parameter can be: ENABLE or DISABLE. + * @note When the LSI is stopped, LSIRDY flag goes low after 6 LSI oscillator + * clock cycles. + * @retval None + */ +void RCC_LSICmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + *(__IO uint32_t *) CSR_LSION_BB = (uint32_t)NewState; +} + +/** + * @brief Configures the main PLL clock source, multiplication and division factors. + * @note This function must be used only when the main PLL is disabled. + * + * @param RCC_PLLSource: specifies the PLL entry clock source. + * This parameter can be one of the following values: + * @arg RCC_PLLSource_HSI: HSI oscillator clock selected as PLL clock entry + * @arg RCC_PLLSource_HSE: HSE oscillator clock selected as PLL clock entry + * @note This clock source (RCC_PLLSource) is common for the main PLL and PLLI2S. + * + * @param PLLM: specifies the division factor for PLL VCO input clock + * This parameter must be a number between 0 and 63. + * @note You have to set the PLLM parameter correctly to ensure that the VCO input + * frequency ranges from 1 to 2 MHz. It is recommended to select a frequency + * of 2 MHz to limit PLL jitter. + * + * @param PLLN: specifies the multiplication factor for PLL VCO output clock + * This parameter must be a number between 192 and 432. + * @note You have to set the PLLN parameter correctly to ensure that the VCO + * output frequency is between 192 and 432 MHz. + * + * @param PLLP: specifies the division factor for main system clock (SYSCLK) + * This parameter must be a number in the range {2, 4, 6, or 8}. + * @note You have to set the PLLP parameter correctly to not exceed 168 MHz on + * the System clock frequency. + * + * @param PLLQ: specifies the division factor for OTG FS, SDIO and RNG clocks + * This parameter must be a number between 4 and 15. + * @note If the USB OTG FS is used in your application, you have to set the + * PLLQ parameter correctly to have 48 MHz clock for the USB. However, + * the SDIO and RNG need a frequency lower than or equal to 48 MHz to work + * correctly. + * + * @retval None + */ +void RCC_PLLConfig(uint32_t RCC_PLLSource, uint32_t PLLM, uint32_t PLLN, uint32_t PLLP, uint32_t PLLQ) +{ + /* Check the parameters */ + assert_param(IS_RCC_PLL_SOURCE(RCC_PLLSource)); + assert_param(IS_RCC_PLLM_VALUE(PLLM)); + assert_param(IS_RCC_PLLN_VALUE(PLLN)); + assert_param(IS_RCC_PLLP_VALUE(PLLP)); + assert_param(IS_RCC_PLLQ_VALUE(PLLQ)); + + RCC->PLLCFGR = PLLM | (PLLN << 6) | (((PLLP >> 1) -1) << 16) | (RCC_PLLSource) | + (PLLQ << 24); +} + +/** + * @brief Enables or disables the main PLL. + * @note After enabling the main PLL, the application software should wait on + * PLLRDY flag to be set indicating that PLL clock is stable and can + * be used as system clock source. + * @note The main PLL can not be disabled if it is used as system clock source + * @note The main PLL is disabled by hardware when entering STOP and STANDBY modes. + * @param NewState: new state of the main PLL. This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void RCC_PLLCmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + *(__IO uint32_t *) CR_PLLON_BB = (uint32_t)NewState; +} + +#if defined (STM32F40_41xxx) || defined (STM32F401xx) +/** + * @brief Configures the PLLI2S clock multiplication and division factors. + * + * @note This function can be used only for STM32F405xx/407xx, STM32F415xx/417xx + * or STM32F401xx devices. + * + * @note This function must be used only when the PLLI2S is disabled. + * @note PLLI2S clock source is common with the main PLL (configured in + * RCC_PLLConfig function ) + * + * @param PLLI2SN: specifies the multiplication factor for PLLI2S VCO output clock + * This parameter must be a number between 192 and 432. + * @note You have to set the PLLI2SN parameter correctly to ensure that the VCO + * output frequency is between 192 and 432 MHz. + * + * @param PLLI2SR: specifies the division factor for I2S clock + * This parameter must be a number between 2 and 7. + * @note You have to set the PLLI2SR parameter correctly to not exceed 192 MHz + * on the I2S clock frequency. + * + * @retval None + */ +void RCC_PLLI2SConfig(uint32_t PLLI2SN, uint32_t PLLI2SR) +{ + /* Check the parameters */ + assert_param(IS_RCC_PLLI2SN_VALUE(PLLI2SN)); + assert_param(IS_RCC_PLLI2SR_VALUE(PLLI2SR)); + + RCC->PLLI2SCFGR = (PLLI2SN << 6) | (PLLI2SR << 28); +} + +#elif defined (STM32F411xE) +/** + * @brief Configures the PLLI2S clock multiplication and division factors. + * + * @note This function can be used only for STM32F411xE devices. + * + * @note This function must be used only when the PLLI2S is disabled. + * @note PLLI2S clock source is common with the main PLL (configured in + * RCC_PLLConfig function ) + * + * @param PLLI2SM: specifies the division factor for PLLI2S VCO input clock + * This parameter must be a number between Min_Data = 2 and Max_Data = 63. + * @note You have to set the PLLI2SM parameter correctly to ensure that the VCO input + * frequency ranges from 1 to 2 MHz. It is recommended to select a frequency + * of 2 MHz to limit PLLI2S jitter. + * + * @param PLLI2SN: specifies the multiplication factor for PLLI2S VCO output clock + * This parameter must be a number between 192 and 432. + * @note You have to set the PLLI2SN parameter correctly to ensure that the VCO + * output frequency is between 192 and 432 MHz. + * + * @param PLLI2SR: specifies the division factor for I2S clock + * This parameter must be a number between 2 and 7. + * @note You have to set the PLLI2SR parameter correctly to not exceed 192 MHz + * on the I2S clock frequency. + * + * @retval None + */ +void RCC_PLLI2SConfig(uint32_t PLLI2SN, uint32_t PLLI2SR, uint32_t PLLI2SM) +{ + /* Check the parameters */ + assert_param(IS_RCC_PLLI2SN_VALUE(PLLI2SN)); + assert_param(IS_RCC_PLLI2SM_VALUE(PLLI2SM)); + assert_param(IS_RCC_PLLI2SR_VALUE(PLLI2SR)); + + RCC->PLLI2SCFGR = (PLLI2SN << 6) | (PLLI2SR << 28) | PLLI2SM; +} + +#elif defined (STM32F427_437xx) || defined (STM32F429_439xx) +/** + * @brief Configures the PLLI2S clock multiplication and division factors. + * + * @note This function can be used only for STM32F42xxx/43xxx devices + * + * @note This function must be used only when the PLLI2S is disabled. + * @note PLLI2S clock source is common with the main PLL (configured in + * RCC_PLLConfig function ) + * + * @param PLLI2SN: specifies the multiplication factor for PLLI2S VCO output clock + * This parameter must be a number between 192 and 432. + * @note You have to set the PLLI2SN parameter correctly to ensure that the VCO + * output frequency is between 192 and 432 MHz. + * + * @param PLLI2SQ: specifies the division factor for SAI1 clock + * This parameter must be a number between 2 and 15. + * + * @param PLLI2SR: specifies the division factor for I2S clock + * This parameter must be a number between 2 and 7. + * @note You have to set the PLLI2SR parameter correctly to not exceed 192 MHz + * on the I2S clock frequency. + * @note the PLLI2SR parameter is only available with STM32F42xxx/43xxx devices. + * + * @retval None + */ +void RCC_PLLI2SConfig(uint32_t PLLI2SN, uint32_t PLLI2SQ, uint32_t PLLI2SR) +{ + /* Check the parameters */ + assert_param(IS_RCC_PLLI2SN_VALUE(PLLI2SN)); + assert_param(IS_RCC_PLLI2SQ_VALUE(PLLI2SQ)); + assert_param(IS_RCC_PLLI2SR_VALUE(PLLI2SR)); + + RCC->PLLI2SCFGR = (PLLI2SN << 6) | (PLLI2SQ << 24) | (PLLI2SR << 28); +} +#else +#endif /* STM32F40_41xxx || STM32F401xx */ + +/** + * @brief Enables or disables the PLLI2S. + * @note The PLLI2S is disabled by hardware when entering STOP and STANDBY modes. + * @param NewState: new state of the PLLI2S. This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void RCC_PLLI2SCmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + *(__IO uint32_t *) CR_PLLI2SON_BB = (uint32_t)NewState; +} + +/** + * @brief Configures the PLLSAI clock multiplication and division factors. + * + * @note This function can be used only for STM32F42xxx/43xxx devices + * + * @note This function must be used only when the PLLSAI is disabled. + * @note PLLSAI clock source is common with the main PLL (configured in + * RCC_PLLConfig function ) + * + * @param PLLSAIN: specifies the multiplication factor for PLLSAI VCO output clock + * This parameter must be a number between 192 and 432. + * @note You have to set the PLLSAIN parameter correctly to ensure that the VCO + * output frequency is between 192 and 432 MHz. + * + * @param PLLSAIQ: specifies the division factor for SAI1 clock + * This parameter must be a number between 2 and 15. + * + * @param PLLSAIR: specifies the division factor for LTDC clock + * This parameter must be a number between 2 and 7. + * + * @retval None + */ +void RCC_PLLSAIConfig(uint32_t PLLSAIN, uint32_t PLLSAIQ, uint32_t PLLSAIR) +{ + /* Check the parameters */ + assert_param(IS_RCC_PLLSAIN_VALUE(PLLSAIN)); + assert_param(IS_RCC_PLLSAIR_VALUE(PLLSAIR)); + + RCC->PLLSAICFGR = (PLLSAIN << 6) | (PLLSAIQ << 24) | (PLLSAIR << 28); +} + +/** + * @brief Enables or disables the PLLSAI. + * + * @note This function can be used only for STM32F42xxx/43xxx devices + * + * @note The PLLSAI is disabled by hardware when entering STOP and STANDBY modes. + * @param NewState: new state of the PLLSAI. This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void RCC_PLLSAICmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + *(__IO uint32_t *) CR_PLLSAION_BB = (uint32_t)NewState; +} + +/** + * @brief Enables or disables the Clock Security System. + * @note If a failure is detected on the HSE oscillator clock, this oscillator + * is automatically disabled and an interrupt is generated to inform the + * software about the failure (Clock Security System Interrupt, CSSI), + * allowing the MCU to perform rescue operations. The CSSI is linked to + * the Cortex-M4 NMI (Non-Maskable Interrupt) exception vector. + * @param NewState: new state of the Clock Security System. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void RCC_ClockSecuritySystemCmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + *(__IO uint32_t *) CR_CSSON_BB = (uint32_t)NewState; +} + +/** + * @brief Selects the clock source to output on MCO1 pin(PA8). + * @note PA8 should be configured in alternate function mode. + * @param RCC_MCO1Source: specifies the clock source to output. + * This parameter can be one of the following values: + * @arg RCC_MCO1Source_HSI: HSI clock selected as MCO1 source + * @arg RCC_MCO1Source_LSE: LSE clock selected as MCO1 source + * @arg RCC_MCO1Source_HSE: HSE clock selected as MCO1 source + * @arg RCC_MCO1Source_PLLCLK: main PLL clock selected as MCO1 source + * @param RCC_MCO1Div: specifies the MCO1 prescaler. + * This parameter can be one of the following values: + * @arg RCC_MCO1Div_1: no division applied to MCO1 clock + * @arg RCC_MCO1Div_2: division by 2 applied to MCO1 clock + * @arg RCC_MCO1Div_3: division by 3 applied to MCO1 clock + * @arg RCC_MCO1Div_4: division by 4 applied to MCO1 clock + * @arg RCC_MCO1Div_5: division by 5 applied to MCO1 clock + * @retval None + */ +void RCC_MCO1Config(uint32_t RCC_MCO1Source, uint32_t RCC_MCO1Div) +{ + uint32_t tmpreg = 0; + + /* Check the parameters */ + assert_param(IS_RCC_MCO1SOURCE(RCC_MCO1Source)); + assert_param(IS_RCC_MCO1DIV(RCC_MCO1Div)); + + tmpreg = RCC->CFGR; + + /* Clear MCO1[1:0] and MCO1PRE[2:0] bits */ + tmpreg &= CFGR_MCO1_RESET_MASK; + + /* Select MCO1 clock source and prescaler */ + tmpreg |= RCC_MCO1Source | RCC_MCO1Div; + + /* Store the new value */ + RCC->CFGR = tmpreg; +} + +/** + * @brief Selects the clock source to output on MCO2 pin(PC9). + * @note PC9 should be configured in alternate function mode. + * @param RCC_MCO2Source: specifies the clock source to output. + * This parameter can be one of the following values: + * @arg RCC_MCO2Source_SYSCLK: System clock (SYSCLK) selected as MCO2 source + * @arg RCC_MCO2Source_PLLI2SCLK: PLLI2S clock selected as MCO2 source + * @arg RCC_MCO2Source_HSE: HSE clock selected as MCO2 source + * @arg RCC_MCO2Source_PLLCLK: main PLL clock selected as MCO2 source + * @param RCC_MCO2Div: specifies the MCO2 prescaler. + * This parameter can be one of the following values: + * @arg RCC_MCO2Div_1: no division applied to MCO2 clock + * @arg RCC_MCO2Div_2: division by 2 applied to MCO2 clock + * @arg RCC_MCO2Div_3: division by 3 applied to MCO2 clock + * @arg RCC_MCO2Div_4: division by 4 applied to MCO2 clock + * @arg RCC_MCO2Div_5: division by 5 applied to MCO2 clock + * @retval None + */ +void RCC_MCO2Config(uint32_t RCC_MCO2Source, uint32_t RCC_MCO2Div) +{ + uint32_t tmpreg = 0; + + /* Check the parameters */ + assert_param(IS_RCC_MCO2SOURCE(RCC_MCO2Source)); + assert_param(IS_RCC_MCO2DIV(RCC_MCO2Div)); + + tmpreg = RCC->CFGR; + + /* Clear MCO2 and MCO2PRE[2:0] bits */ + tmpreg &= CFGR_MCO2_RESET_MASK; + + /* Select MCO2 clock source and prescaler */ + tmpreg |= RCC_MCO2Source | RCC_MCO2Div; + + /* Store the new value */ + RCC->CFGR = tmpreg; +} + +/** + * @} + */ + +/** @defgroup RCC_Group2 System AHB and APB busses clocks configuration functions + * @brief System, AHB and APB busses clocks configuration functions + * +@verbatim + =============================================================================== + ##### System, AHB and APB busses clocks configuration functions ##### + =============================================================================== + [..] + This section provide functions allowing to configure the System, AHB, APB1 and + APB2 busses clocks. + + (#) Several clock sources can be used to drive the System clock (SYSCLK): HSI, + HSE and PLL. + The AHB clock (HCLK) is derived from System clock through configurable + prescaler and used to clock the CPU, memory and peripherals mapped + on AHB bus (DMA, GPIO...). APB1 (PCLK1) and APB2 (PCLK2) clocks are derived + from AHB clock through configurable prescalers and used to clock + the peripherals mapped on these busses. You can use + "RCC_GetClocksFreq()" function to retrieve the frequencies of these clocks. + + -@- All the peripheral clocks are derived from the System clock (SYSCLK) except: + (+@) I2S: the I2S clock can be derived either from a specific PLL (PLLI2S) or + from an external clock mapped on the I2S_CKIN pin. + You have to use RCC_I2SCLKConfig() function to configure this clock. + (+@) RTC: the RTC clock can be derived either from the LSI, LSE or HSE clock + divided by 2 to 31. You have to use RCC_RTCCLKConfig() and RCC_RTCCLKCmd() + functions to configure this clock. + (+@) USB OTG FS, SDIO and RTC: USB OTG FS require a frequency equal to 48 MHz + to work correctly, while the SDIO require a frequency equal or lower than + to 48. This clock is derived of the main PLL through PLLQ divider. + (+@) IWDG clock which is always the LSI clock. + + (#) For STM32F405xx/407xx and STM32F415xx/417xx devices, the maximum frequency + of the SYSCLK and HCLK is 168 MHz, PCLK2 84 MHz and PCLK1 42 MHz. Depending + on the device voltage range, the maximum frequency should be adapted accordingly: + +-------------------------------------------------------------------------------------+ + | Latency | HCLK clock frequency (MHz) | + | |---------------------------------------------------------------------| + | | voltage range | voltage range | voltage range | voltage range | + | | 2.7 V - 3.6 V | 2.4 V - 2.7 V | 2.1 V - 2.4 V | 1.8 V - 2.1 V | + |---------------|----------------|----------------|-----------------|-----------------| + |0WS(1CPU cycle)|0 < HCLK <= 30 |0 < HCLK <= 24 |0 < HCLK <= 22 |0 < HCLK <= 20 | + |---------------|----------------|----------------|-----------------|-----------------| + |1WS(2CPU cycle)|30 < HCLK <= 60 |24 < HCLK <= 48 |22 < HCLK <= 44 |20 < HCLK <= 40 | + |---------------|----------------|----------------|-----------------|-----------------| + |2WS(3CPU cycle)|60 < HCLK <= 90 |48 < HCLK <= 72 |44 < HCLK <= 66 |40 < HCLK <= 60 | + |---------------|----------------|----------------|-----------------|-----------------| + |3WS(4CPU cycle)|90 < HCLK <= 120|72 < HCLK <= 96 |66 < HCLK <= 88 |60 < HCLK <= 80 | + |---------------|----------------|----------------|-----------------|-----------------| + |4WS(5CPU cycle)|120< HCLK <= 150|96 < HCLK <= 120|88 < HCLK <= 110 |80 < HCLK <= 100 | + |---------------|----------------|----------------|-----------------|-----------------| + |5WS(6CPU cycle)|150< HCLK <= 168|120< HCLK <= 144|110 < HCLK <= 132|100 < HCLK <= 120| + |---------------|----------------|----------------|-----------------|-----------------| + |6WS(7CPU cycle)| NA |144< HCLK <= 168|132 < HCLK <= 154|120 < HCLK <= 140| + |---------------|----------------|----------------|-----------------|-----------------| + |7WS(8CPU cycle)| NA | NA |154 < HCLK <= 168|140 < HCLK <= 160| + +---------------|----------------|----------------|-----------------|-----------------+ + (#) For STM32F42xxx/43xxx devices, the maximum frequency of the SYSCLK and HCLK is 180 MHz, + PCLK2 90 MHz and PCLK1 45 MHz. Depending on the device voltage range, the maximum + frequency should be adapted accordingly: + +-------------------------------------------------------------------------------------+ + | Latency | HCLK clock frequency (MHz) | + | |---------------------------------------------------------------------| + | | voltage range | voltage range | voltage range | voltage range | + | | 2.7 V - 3.6 V | 2.4 V - 2.7 V | 2.1 V - 2.4 V | 1.8 V - 2.1 V | + |---------------|----------------|----------------|-----------------|-----------------| + |0WS(1CPU cycle)|0 < HCLK <= 30 |0 < HCLK <= 24 |0 < HCLK <= 22 |0 < HCLK <= 20 | + |---------------|----------------|----------------|-----------------|-----------------| + |1WS(2CPU cycle)|30 < HCLK <= 60 |24 < HCLK <= 48 |22 < HCLK <= 44 |20 < HCLK <= 40 | + |---------------|----------------|----------------|-----------------|-----------------| + |2WS(3CPU cycle)|60 < HCLK <= 90 |48 < HCLK <= 72 |44 < HCLK <= 66 |40 < HCLK <= 60 | + |---------------|----------------|----------------|-----------------|-----------------| + |3WS(4CPU cycle)|90 < HCLK <= 120|72 < HCLK <= 96 |66 < HCLK <= 88 |60 < HCLK <= 80 | + |---------------|----------------|----------------|-----------------|-----------------| + |4WS(5CPU cycle)|120< HCLK <= 150|96 < HCLK <= 120|88 < HCLK <= 110 |80 < HCLK <= 100 | + |---------------|----------------|----------------|-----------------|-----------------| + |5WS(6CPU cycle)|120< HCLK <= 180|120< HCLK <= 144|110 < HCLK <= 132|100 < HCLK <= 120| + |---------------|----------------|----------------|-----------------|-----------------| + |6WS(7CPU cycle)| NA |144< HCLK <= 168|132 < HCLK <= 154|120 < HCLK <= 140| + |---------------|----------------|----------------|-----------------|-----------------| + |7WS(8CPU cycle)| NA |168< HCLK <= 180|154 < HCLK <= 176|140 < HCLK <= 160| + |---------------|----------------|----------------|-----------------|-----------------| + |8WS(9CPU cycle)| NA | NA |176 < HCLK <= 180|160 < HCLK <= 168| + +-------------------------------------------------------------------------------------+ + + (#) For STM32F401xx devices, the maximum frequency of the SYSCLK and HCLK is 84 MHz, + PCLK2 84 MHz and PCLK1 42 MHz. Depending on the device voltage range, the maximum + frequency should be adapted accordingly: + +-------------------------------------------------------------------------------------+ + | Latency | HCLK clock frequency (MHz) | + | |---------------------------------------------------------------------| + | | voltage range | voltage range | voltage range | voltage range | + | | 2.7 V - 3.6 V | 2.4 V - 2.7 V | 2.1 V - 2.4 V | 1.8 V - 2.1 V | + |---------------|----------------|----------------|-----------------|-----------------| + |0WS(1CPU cycle)|0 < HCLK <= 30 |0 < HCLK <= 24 |0 < HCLK <= 22 |0 < HCLK <= 20 | + |---------------|----------------|----------------|-----------------|-----------------| + |1WS(2CPU cycle)|30 < HCLK <= 60 |24 < HCLK <= 48 |22 < HCLK <= 44 |20 < HCLK <= 40 | + |---------------|----------------|----------------|-----------------|-----------------| + |2WS(3CPU cycle)|60 < HCLK <= 84 |48 < HCLK <= 72 |44 < HCLK <= 66 |40 < HCLK <= 60 | + |---------------|----------------|----------------|-----------------|-----------------| + |3WS(4CPU cycle)| NA |72 < HCLK <= 84 |66 < HCLK <= 84 |60 < HCLK <= 80 | + |---------------|----------------|----------------|-----------------|-----------------| + |4WS(5CPU cycle)| NA | NA | NA |80 < HCLK <= 84 | + +-------------------------------------------------------------------------------------+ + + (#) For STM32F411xE devices, the maximum frequency of the SYSCLK and HCLK is 100 MHz, + PCLK2 100 MHz and PCLK1 50 MHz. Depending on the device voltage range, the maximum + frequency should be adapted accordingly: + +-------------------------------------------------------------------------------------+ + | Latency | HCLK clock frequency (MHz) | + | |---------------------------------------------------------------------| + | | voltage range | voltage range | voltage range | voltage range | + | | 2.7 V - 3.6 V | 2.4 V - 2.7 V | 2.1 V - 2.4 V | 1.8 V - 2.1 V | + |---------------|----------------|----------------|-----------------|-----------------| + |0WS(1CPU cycle)|0 < HCLK <= 30 |0 < HCLK <= 24 |0 < HCLK <= 18 |0 < HCLK <= 16 | + |---------------|----------------|----------------|-----------------|-----------------| + |1WS(2CPU cycle)|30 < HCLK <= 64 |24 < HCLK <= 48 |18 < HCLK <= 36 |16 < HCLK <= 32 | + |---------------|----------------|----------------|-----------------|-----------------| + |2WS(3CPU cycle)|64 < HCLK <= 90 |48 < HCLK <= 72 |36 < HCLK <= 54 |32 < HCLK <= 48 | + |---------------|----------------|----------------|-----------------|-----------------| + |3WS(4CPU cycle)|90 < HCLK <= 100|72 < HCLK <= 96 |54 < HCLK <= 72 |48 < HCLK <= 64 | + |---------------|----------------|----------------|-----------------|-----------------| + |4WS(5CPU cycle)| NA |96 < HCLK <= 100|72 < HCLK <= 90 |64 < HCLK <= 80 | + |---------------|----------------|----------------|-----------------|-----------------| + |5WS(6CPU cycle)| NA | NA |90 < HCLK <= 100 |80 < HCLK <= 96 | + |---------------|----------------|----------------|-----------------|-----------------| + |6WS(7CPU cycle)| NA | NA | NA |96 < HCLK <= 100 | + +-------------------------------------------------------------------------------------+ + + -@- On STM32F405xx/407xx and STM32F415xx/417xx devices: + (++) when VOS = '0', the maximum value of fHCLK = 144MHz. + (++) when VOS = '1', the maximum value of fHCLK = 168MHz. + [..] + On STM32F42xxx/43xxx devices: + (++) when VOS[1:0] = '0x01', the maximum value of fHCLK is 120MHz. + (++) when VOS[1:0] = '0x10', the maximum value of fHCLK is 144MHz. + (++) when VOS[1:0] = '0x11', the maximum value of f is 168MHz + [..] + On STM32F401x devices: + (++) when VOS[1:0] = '0x01', the maximum value of fHCLK is 64MHz. + (++) when VOS[1:0] = '0x10', the maximum value of fHCLK is 84MHz. + On STM32F411xE devices: + (++) when VOS[1:0] = '0x01' the maximum value of fHCLK is 64MHz. + (++) when VOS[1:0] = '0x10' the maximum value of fHCLK is 84MHz. + (++) when VOS[1:0] = '0x11' the maximum value of fHCLK is 100MHz. + + You can use PWR_MainRegulatorModeConfig() function to control VOS bits. + +@endverbatim + * @{ + */ + +/** + * @brief Configures the system clock (SYSCLK). + * @note The HSI is used (enabled by hardware) as system clock source after + * startup from Reset, wake-up from STOP and STANDBY mode, or in case + * of failure of the HSE used directly or indirectly as system clock + * (if the Clock Security System CSS is enabled). + * @note A switch from one clock source to another occurs only if the target + * clock source is ready (clock stable after startup delay or PLL locked). + * If a clock source which is not yet ready is selected, the switch will + * occur when the clock source will be ready. + * You can use RCC_GetSYSCLKSource() function to know which clock is + * currently used as system clock source. + * @param RCC_SYSCLKSource: specifies the clock source used as system clock. + * This parameter can be one of the following values: + * @arg RCC_SYSCLKSource_HSI: HSI selected as system clock source + * @arg RCC_SYSCLKSource_HSE: HSE selected as system clock source + * @arg RCC_SYSCLKSource_PLLCLK: PLL selected as system clock source + * @retval None + */ +void RCC_SYSCLKConfig(uint32_t RCC_SYSCLKSource) +{ + uint32_t tmpreg = 0; + + /* Check the parameters */ + assert_param(IS_RCC_SYSCLK_SOURCE(RCC_SYSCLKSource)); + + tmpreg = RCC->CFGR; + + /* Clear SW[1:0] bits */ + tmpreg &= ~RCC_CFGR_SW; + + /* Set SW[1:0] bits according to RCC_SYSCLKSource value */ + tmpreg |= RCC_SYSCLKSource; + + /* Store the new value */ + RCC->CFGR = tmpreg; +} + +/** + * @brief Returns the clock source used as system clock. + * @param None + * @retval The clock source used as system clock. The returned value can be one + * of the following: + * - 0x00: HSI used as system clock + * - 0x04: HSE used as system clock + * - 0x08: PLL used as system clock + */ +uint8_t RCC_GetSYSCLKSource(void) +{ + return ((uint8_t)(RCC->CFGR & RCC_CFGR_SWS)); +} + +/** + * @brief Configures the AHB clock (HCLK). + * @note Depending on the device voltage range, the software has to set correctly + * these bits to ensure that HCLK not exceed the maximum allowed frequency + * (for more details refer to section above + * "CPU, AHB and APB busses clocks configuration functions") + * @param RCC_SYSCLK: defines the AHB clock divider. This clock is derived from + * the system clock (SYSCLK). + * This parameter can be one of the following values: + * @arg RCC_SYSCLK_Div1: AHB clock = SYSCLK + * @arg RCC_SYSCLK_Div2: AHB clock = SYSCLK/2 + * @arg RCC_SYSCLK_Div4: AHB clock = SYSCLK/4 + * @arg RCC_SYSCLK_Div8: AHB clock = SYSCLK/8 + * @arg RCC_SYSCLK_Div16: AHB clock = SYSCLK/16 + * @arg RCC_SYSCLK_Div64: AHB clock = SYSCLK/64 + * @arg RCC_SYSCLK_Div128: AHB clock = SYSCLK/128 + * @arg RCC_SYSCLK_Div256: AHB clock = SYSCLK/256 + * @arg RCC_SYSCLK_Div512: AHB clock = SYSCLK/512 + * @retval None + */ +void RCC_HCLKConfig(uint32_t RCC_SYSCLK) +{ + uint32_t tmpreg = 0; + + /* Check the parameters */ + assert_param(IS_RCC_HCLK(RCC_SYSCLK)); + + tmpreg = RCC->CFGR; + + /* Clear HPRE[3:0] bits */ + tmpreg &= ~RCC_CFGR_HPRE; + + /* Set HPRE[3:0] bits according to RCC_SYSCLK value */ + tmpreg |= RCC_SYSCLK; + + /* Store the new value */ + RCC->CFGR = tmpreg; +} + + +/** + * @brief Configures the Low Speed APB clock (PCLK1). + * @param RCC_HCLK: defines the APB1 clock divider. This clock is derived from + * the AHB clock (HCLK). + * This parameter can be one of the following values: + * @arg RCC_HCLK_Div1: APB1 clock = HCLK + * @arg RCC_HCLK_Div2: APB1 clock = HCLK/2 + * @arg RCC_HCLK_Div4: APB1 clock = HCLK/4 + * @arg RCC_HCLK_Div8: APB1 clock = HCLK/8 + * @arg RCC_HCLK_Div16: APB1 clock = HCLK/16 + * @retval None + */ +void RCC_PCLK1Config(uint32_t RCC_HCLK) +{ + uint32_t tmpreg = 0; + + /* Check the parameters */ + assert_param(IS_RCC_PCLK(RCC_HCLK)); + + tmpreg = RCC->CFGR; + + /* Clear PPRE1[2:0] bits */ + tmpreg &= ~RCC_CFGR_PPRE1; + + /* Set PPRE1[2:0] bits according to RCC_HCLK value */ + tmpreg |= RCC_HCLK; + + /* Store the new value */ + RCC->CFGR = tmpreg; +} + +/** + * @brief Configures the High Speed APB clock (PCLK2). + * @param RCC_HCLK: defines the APB2 clock divider. This clock is derived from + * the AHB clock (HCLK). + * This parameter can be one of the following values: + * @arg RCC_HCLK_Div1: APB2 clock = HCLK + * @arg RCC_HCLK_Div2: APB2 clock = HCLK/2 + * @arg RCC_HCLK_Div4: APB2 clock = HCLK/4 + * @arg RCC_HCLK_Div8: APB2 clock = HCLK/8 + * @arg RCC_HCLK_Div16: APB2 clock = HCLK/16 + * @retval None + */ +void RCC_PCLK2Config(uint32_t RCC_HCLK) +{ + uint32_t tmpreg = 0; + + /* Check the parameters */ + assert_param(IS_RCC_PCLK(RCC_HCLK)); + + tmpreg = RCC->CFGR; + + /* Clear PPRE2[2:0] bits */ + tmpreg &= ~RCC_CFGR_PPRE2; + + /* Set PPRE2[2:0] bits according to RCC_HCLK value */ + tmpreg |= RCC_HCLK << 3; + + /* Store the new value */ + RCC->CFGR = tmpreg; +} + +/** + * @brief Returns the frequencies of different on chip clocks; SYSCLK, HCLK, + * PCLK1 and PCLK2. + * + * @note The system frequency computed by this function is not the real + * frequency in the chip. It is calculated based on the predefined + * constant and the selected clock source: + * @note If SYSCLK source is HSI, function returns values based on HSI_VALUE(*) + * @note If SYSCLK source is HSE, function returns values based on HSE_VALUE(**) + * @note If SYSCLK source is PLL, function returns values based on HSE_VALUE(**) + * or HSI_VALUE(*) multiplied/divided by the PLL factors. + * @note (*) HSI_VALUE is a constant defined in stm32f4xx.h file (default value + * 16 MHz) but the real value may vary depending on the variations + * in voltage and temperature. + * @note (**) HSE_VALUE is a constant defined in stm32f4xx.h file (default value + * 25 MHz), user has to ensure that HSE_VALUE is same as the real + * frequency of the crystal used. Otherwise, this function may + * have wrong result. + * + * @note The result of this function could be not correct when using fractional + * value for HSE crystal. + * + * @param RCC_Clocks: pointer to a RCC_ClocksTypeDef structure which will hold + * the clocks frequencies. + * + * @note This function can be used by the user application to compute the + * baudrate for the communication peripherals or configure other parameters. + * @note Each time SYSCLK, HCLK, PCLK1 and/or PCLK2 clock changes, this function + * must be called to update the structure's field. Otherwise, any + * configuration based on this function will be incorrect. + * + * @retval None + */ +void RCC_GetClocksFreq(RCC_ClocksTypeDef* RCC_Clocks) +{ + uint32_t tmp = 0, presc = 0, pllvco = 0, pllp = 2, pllsource = 0, pllm = 2; + + /* Get SYSCLK source -------------------------------------------------------*/ + tmp = RCC->CFGR & RCC_CFGR_SWS; + + switch (tmp) + { + case 0x00: /* HSI used as system clock source */ + RCC_Clocks->SYSCLK_Frequency = HSI_VALUE; + break; + case 0x04: /* HSE used as system clock source */ + RCC_Clocks->SYSCLK_Frequency = HSE_VALUE; + break; + case 0x08: /* PLL used as system clock source */ + + /* PLL_VCO = (HSE_VALUE or HSI_VALUE / PLLM) * PLLN + SYSCLK = PLL_VCO / PLLP + */ + pllsource = (RCC->PLLCFGR & RCC_PLLCFGR_PLLSRC) >> 22; + pllm = RCC->PLLCFGR & RCC_PLLCFGR_PLLM; + + if (pllsource != 0) + { + /* HSE used as PLL clock source */ + pllvco = (HSE_VALUE / pllm) * ((RCC->PLLCFGR & RCC_PLLCFGR_PLLN) >> 6); + } + else + { + /* HSI used as PLL clock source */ + pllvco = (HSI_VALUE / pllm) * ((RCC->PLLCFGR & RCC_PLLCFGR_PLLN) >> 6); + } + + pllp = (((RCC->PLLCFGR & RCC_PLLCFGR_PLLP) >>16) + 1 ) *2; + RCC_Clocks->SYSCLK_Frequency = pllvco/pllp; + break; + default: + RCC_Clocks->SYSCLK_Frequency = HSI_VALUE; + break; + } + /* Compute HCLK, PCLK1 and PCLK2 clocks frequencies ------------------------*/ + + /* Get HCLK prescaler */ + tmp = RCC->CFGR & RCC_CFGR_HPRE; + tmp = tmp >> 4; + presc = APBAHBPrescTable[tmp]; + /* HCLK clock frequency */ + RCC_Clocks->HCLK_Frequency = RCC_Clocks->SYSCLK_Frequency >> presc; + + /* Get PCLK1 prescaler */ + tmp = RCC->CFGR & RCC_CFGR_PPRE1; + tmp = tmp >> 10; + presc = APBAHBPrescTable[tmp]; + /* PCLK1 clock frequency */ + RCC_Clocks->PCLK1_Frequency = RCC_Clocks->HCLK_Frequency >> presc; + + /* Get PCLK2 prescaler */ + tmp = RCC->CFGR & RCC_CFGR_PPRE2; + tmp = tmp >> 13; + presc = APBAHBPrescTable[tmp]; + /* PCLK2 clock frequency */ + RCC_Clocks->PCLK2_Frequency = RCC_Clocks->HCLK_Frequency >> presc; +} + +/** + * @} + */ + +/** @defgroup RCC_Group3 Peripheral clocks configuration functions + * @brief Peripheral clocks configuration functions + * +@verbatim + =============================================================================== + ##### Peripheral clocks configuration functions ##### + =============================================================================== + [..] This section provide functions allowing to configure the Peripheral clocks. + + (#) The RTC clock which is derived from the LSI, LSE or HSE clock divided + by 2 to 31. + + (#) After restart from Reset or wakeup from STANDBY, all peripherals are off + except internal SRAM, Flash and JTAG. Before to start using a peripheral + you have to enable its interface clock. You can do this using + RCC_AHBPeriphClockCmd(), RCC_APB2PeriphClockCmd() and RCC_APB1PeriphClockCmd() functions. + + (#) To reset the peripherals configuration (to the default state after device reset) + you can use RCC_AHBPeriphResetCmd(), RCC_APB2PeriphResetCmd() and + RCC_APB1PeriphResetCmd() functions. + + (#) To further reduce power consumption in SLEEP mode the peripheral clocks + can be disabled prior to executing the WFI or WFE instructions. + You can do this using RCC_AHBPeriphClockLPModeCmd(), + RCC_APB2PeriphClockLPModeCmd() and RCC_APB1PeriphClockLPModeCmd() functions. + +@endverbatim + * @{ + */ + +/** + * @brief Configures the RTC clock (RTCCLK). + * @note As the RTC clock configuration bits are in the Backup domain and write + * access is denied to this domain after reset, you have to enable write + * access using PWR_BackupAccessCmd(ENABLE) function before to configure + * the RTC clock source (to be done once after reset). + * @note Once the RTC clock is configured it can't be changed unless the + * Backup domain is reset using RCC_BackupResetCmd() function, or by + * a Power On Reset (POR). + * + * @param RCC_RTCCLKSource: specifies the RTC clock source. + * This parameter can be one of the following values: + * @arg RCC_RTCCLKSource_LSE: LSE selected as RTC clock + * @arg RCC_RTCCLKSource_LSI: LSI selected as RTC clock + * @arg RCC_RTCCLKSource_HSE_Divx: HSE clock divided by x selected + * as RTC clock, where x:[2,31] + * + * @note If the LSE or LSI is used as RTC clock source, the RTC continues to + * work in STOP and STANDBY modes, and can be used as wakeup source. + * However, when the HSE clock is used as RTC clock source, the RTC + * cannot be used in STOP and STANDBY modes. + * @note The maximum input clock frequency for RTC is 1MHz (when using HSE as + * RTC clock source). + * + * @retval None + */ +void RCC_RTCCLKConfig(uint32_t RCC_RTCCLKSource) +{ + uint32_t tmpreg = 0; + + /* Check the parameters */ + assert_param(IS_RCC_RTCCLK_SOURCE(RCC_RTCCLKSource)); + + if ((RCC_RTCCLKSource & 0x00000300) == 0x00000300) + { /* If HSE is selected as RTC clock source, configure HSE division factor for RTC clock */ + tmpreg = RCC->CFGR; + + /* Clear RTCPRE[4:0] bits */ + tmpreg &= ~RCC_CFGR_RTCPRE; + + /* Configure HSE division factor for RTC clock */ + tmpreg |= (RCC_RTCCLKSource & 0xFFFFCFF); + + /* Store the new value */ + RCC->CFGR = tmpreg; + } + + /* Select the RTC clock source */ + RCC->BDCR |= (RCC_RTCCLKSource & 0x00000FFF); +} + +/** + * @brief Enables or disables the RTC clock. + * @note This function must be used only after the RTC clock source was selected + * using the RCC_RTCCLKConfig function. + * @param NewState: new state of the RTC clock. This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void RCC_RTCCLKCmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + *(__IO uint32_t *) BDCR_RTCEN_BB = (uint32_t)NewState; +} + +/** + * @brief Forces or releases the Backup domain reset. + * @note This function resets the RTC peripheral (including the backup registers) + * and the RTC clock source selection in RCC_CSR register. + * @note The BKPSRAM is not affected by this reset. + * @param NewState: new state of the Backup domain reset. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void RCC_BackupResetCmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + *(__IO uint32_t *) BDCR_BDRST_BB = (uint32_t)NewState; +} + +/** + * @brief Configures the I2S clock source (I2SCLK). + * @note This function must be called before enabling the I2S APB clock. + * @param RCC_I2SCLKSource: specifies the I2S clock source. + * This parameter can be one of the following values: + * @arg RCC_I2S2CLKSource_PLLI2S: PLLI2S clock used as I2S clock source + * @arg RCC_I2S2CLKSource_Ext: External clock mapped on the I2S_CKIN pin + * used as I2S clock source + * @retval None + */ +void RCC_I2SCLKConfig(uint32_t RCC_I2SCLKSource) +{ + /* Check the parameters */ + assert_param(IS_RCC_I2SCLK_SOURCE(RCC_I2SCLKSource)); + + *(__IO uint32_t *) CFGR_I2SSRC_BB = RCC_I2SCLKSource; +} + +/** + * @brief Configures the SAI clock Divider coming from PLLI2S. + * + * @note This function can be used only for STM32F42xxx/43xxx devices. + * + * @note This function must be called before enabling the PLLI2S. + * + * @param RCC_PLLI2SDivQ: specifies the PLLI2S division factor for SAI1 clock . + * This parameter must be a number between 1 and 32. + * SAI1 clock frequency = f(PLLI2S_Q) / RCC_PLLI2SDivQ + * + * @retval None + */ +void RCC_SAIPLLI2SClkDivConfig(uint32_t RCC_PLLI2SDivQ) +{ + uint32_t tmpreg = 0; + + /* Check the parameters */ + assert_param(IS_RCC_PLLI2S_DIVQ_VALUE(RCC_PLLI2SDivQ)); + + tmpreg = RCC->DCKCFGR; + + /* Clear PLLI2SDIVQ[4:0] bits */ + tmpreg &= ~(RCC_DCKCFGR_PLLI2SDIVQ); + + /* Set PLLI2SDIVQ values */ + tmpreg |= (RCC_PLLI2SDivQ - 1); + + /* Store the new value */ + RCC->DCKCFGR = tmpreg; +} + +/** + * @brief Configures the SAI clock Divider coming from PLLSAI. + * + * @note This function can be used only for STM32F42xxx/43xxx devices. + * + * @note This function must be called before enabling the PLLSAI. + * + * @param RCC_PLLSAIDivQ: specifies the PLLSAI division factor for SAI1 clock . + * This parameter must be a number between 1 and 32. + * SAI1 clock frequency = f(PLLSAI_Q) / RCC_PLLSAIDivQ + * + * @retval None + */ +void RCC_SAIPLLSAIClkDivConfig(uint32_t RCC_PLLSAIDivQ) +{ + uint32_t tmpreg = 0; + + /* Check the parameters */ + assert_param(IS_RCC_PLLSAI_DIVQ_VALUE(RCC_PLLSAIDivQ)); + + tmpreg = RCC->DCKCFGR; + + /* Clear PLLI2SDIVQ[4:0] and PLLSAIDIVQ[4:0] bits */ + tmpreg &= ~(RCC_DCKCFGR_PLLSAIDIVQ); + + /* Set PLLSAIDIVQ values */ + tmpreg |= ((RCC_PLLSAIDivQ - 1) << 8); + + /* Store the new value */ + RCC->DCKCFGR = tmpreg; +} + +/** + * @brief Configures SAI1BlockA clock source selection. + * + * @note This function can be used only for STM32F42xxx/43xxx devices. + * + * @note This function must be called before enabling PLLSAI, PLLI2S and + * the SAI clock. + * @param RCC_SAIBlockACLKSource: specifies the SAI Block A clock source. + * This parameter can be one of the following values: + * @arg RCC_SAIACLKSource_PLLI2S: PLLI2S_Q clock divided by PLLI2SDIVQ used + * as SAI1 Block A clock + * @arg RCC_SAIACLKSource_PLLSAI: PLLISAI_Q clock divided by PLLSAIDIVQ used + * as SAI1 Block A clock + * @arg RCC_SAIACLKSource_Ext: External clock mapped on the I2S_CKIN pin + * used as SAI1 Block A clock + * @retval None + */ +void RCC_SAIBlockACLKConfig(uint32_t RCC_SAIBlockACLKSource) +{ + uint32_t tmpreg = 0; + + /* Check the parameters */ + assert_param(IS_RCC_SAIACLK_SOURCE(RCC_SAIBlockACLKSource)); + + tmpreg = RCC->DCKCFGR; + + /* Clear RCC_DCKCFGR_SAI1ASRC[1:0] bits */ + tmpreg &= ~RCC_DCKCFGR_SAI1ASRC; + + /* Set SAI Block A source selection value */ + tmpreg |= RCC_SAIBlockACLKSource; + + /* Store the new value */ + RCC->DCKCFGR = tmpreg; +} + +/** + * @brief Configures SAI1BlockB clock source selection. + * + * @note This function can be used only for STM32F42xxx/43xxx devices. + * + * @note This function must be called before enabling PLLSAI, PLLI2S and + * the SAI clock. + * @param RCC_SAIBlockBCLKSource: specifies the SAI Block B clock source. + * This parameter can be one of the following values: + * @arg RCC_SAIBCLKSource_PLLI2S: PLLI2S_Q clock divided by PLLI2SDIVQ used + * as SAI1 Block B clock + * @arg RCC_SAIBCLKSource_PLLSAI: PLLISAI_Q clock divided by PLLSAIDIVQ used + * as SAI1 Block B clock + * @arg RCC_SAIBCLKSource_Ext: External clock mapped on the I2S_CKIN pin + * used as SAI1 Block B clock + * @retval None + */ +void RCC_SAIBlockBCLKConfig(uint32_t RCC_SAIBlockBCLKSource) +{ + uint32_t tmpreg = 0; + + /* Check the parameters */ + assert_param(IS_RCC_SAIBCLK_SOURCE(RCC_SAIBlockBCLKSource)); + + tmpreg = RCC->DCKCFGR; + + /* Clear RCC_DCKCFGR_SAI1BSRC[1:0] bits */ + tmpreg &= ~RCC_DCKCFGR_SAI1BSRC; + + /* Set SAI Block B source selection value */ + tmpreg |= RCC_SAIBlockBCLKSource; + + /* Store the new value */ + RCC->DCKCFGR = tmpreg; +} + + +/** + * @brief Configures the LTDC clock Divider coming from PLLSAI. + * + * @note The LTDC peripheral is only available with STM32F429xx/439xx Devices. + * + * @note This function must be called before enabling the PLLSAI. + * + * @param RCC_PLLSAIDivR: specifies the PLLSAI division factor for LTDC clock . + * This parameter must be a number between 2 and 16. + * LTDC clock frequency = f(PLLSAI_R) / RCC_PLLSAIDivR + * + * @retval None + */ +void RCC_LTDCCLKDivConfig(uint32_t RCC_PLLSAIDivR) +{ + uint32_t tmpreg = 0; + + /* Check the parameters */ + assert_param(IS_RCC_PLLSAI_DIVR_VALUE(RCC_PLLSAIDivR)); + + tmpreg = RCC->DCKCFGR; + + /* Clear PLLSAIDIVR[2:0] bits */ + tmpreg &= ~RCC_DCKCFGR_PLLSAIDIVR; + + /* Set PLLSAIDIVR values */ + tmpreg |= RCC_PLLSAIDivR; + + /* Store the new value */ + RCC->DCKCFGR = tmpreg; +} + +/** + * @brief Configures the Timers clocks prescalers selection. + * + * @note This function can be used only for STM32F42xxx/43xxx and STM32F401xx/411xE devices. + * + * @param RCC_TIMCLKPrescaler : specifies the Timers clocks prescalers selection + * This parameter can be one of the following values: + * @arg RCC_TIMPrescDesactivated: The Timers kernels clocks prescaler is + * equal to HPRE if PPREx is corresponding to division by 1 or 2, + * else it is equal to [(HPRE * PPREx) / 2] if PPREx is corresponding to + * division by 4 or more. + * + * @arg RCC_TIMPrescActivated: The Timers kernels clocks prescaler is + * equal to HPRE if PPREx is corresponding to division by 1, 2 or 4, + * else it is equal to [(HPRE * PPREx) / 4] if PPREx is corresponding + * to division by 8 or more. + * @retval None + */ +void RCC_TIMCLKPresConfig(uint32_t RCC_TIMCLKPrescaler) +{ + /* Check the parameters */ + assert_param(IS_RCC_TIMCLK_PRESCALER(RCC_TIMCLKPrescaler)); + + *(__IO uint32_t *) DCKCFGR_TIMPRE_BB = RCC_TIMCLKPrescaler; + +} + +/** + * @brief Enables or disables the AHB1 peripheral clock. + * @note After reset, the peripheral clock (used for registers read/write access) + * is disabled and the application software has to enable this clock before + * using it. + * @param RCC_AHBPeriph: specifies the AHB1 peripheral to gates its clock. + * This parameter can be any combination of the following values: + * @arg RCC_AHB1Periph_GPIOA: GPIOA clock + * @arg RCC_AHB1Periph_GPIOB: GPIOB clock + * @arg RCC_AHB1Periph_GPIOC: GPIOC clock + * @arg RCC_AHB1Periph_GPIOD: GPIOD clock + * @arg RCC_AHB1Periph_GPIOE: GPIOE clock + * @arg RCC_AHB1Periph_GPIOF: GPIOF clock + * @arg RCC_AHB1Periph_GPIOG: GPIOG clock + * @arg RCC_AHB1Periph_GPIOG: GPIOG clock + * @arg RCC_AHB1Periph_GPIOI: GPIOI clock + * @arg RCC_AHB1Periph_GPIOJ: GPIOJ clock (STM32F42xxx/43xxx devices) + * @arg RCC_AHB1Periph_GPIOK: GPIOK clock (STM32F42xxx/43xxx devices) + * @arg RCC_AHB1Periph_CRC: CRC clock + * @arg RCC_AHB1Periph_BKPSRAM: BKPSRAM interface clock + * @arg RCC_AHB1Periph_CCMDATARAMEN CCM data RAM interface clock + * @arg RCC_AHB1Periph_DMA1: DMA1 clock + * @arg RCC_AHB1Periph_DMA2: DMA2 clock + * @arg RCC_AHB1Periph_DMA2D: DMA2D clock (STM32F429xx/439xx devices) + * @arg RCC_AHB1Periph_ETH_MAC: Ethernet MAC clock + * @arg RCC_AHB1Periph_ETH_MAC_Tx: Ethernet Transmission clock + * @arg RCC_AHB1Periph_ETH_MAC_Rx: Ethernet Reception clock + * @arg RCC_AHB1Periph_ETH_MAC_PTP: Ethernet PTP clock + * @arg RCC_AHB1Periph_OTG_HS: USB OTG HS clock + * @arg RCC_AHB1Periph_OTG_HS_ULPI: USB OTG HS ULPI clock + * @param NewState: new state of the specified peripheral clock. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void RCC_AHB1PeriphClockCmd(uint32_t RCC_AHB1Periph, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_RCC_AHB1_CLOCK_PERIPH(RCC_AHB1Periph)); + + assert_param(IS_FUNCTIONAL_STATE(NewState)); + if (NewState != DISABLE) + { + RCC->AHB1ENR |= RCC_AHB1Periph; + } + else + { + RCC->AHB1ENR &= ~RCC_AHB1Periph; + } +} + +/** + * @brief Enables or disables the AHB2 peripheral clock. + * @note After reset, the peripheral clock (used for registers read/write access) + * is disabled and the application software has to enable this clock before + * using it. + * @param RCC_AHBPeriph: specifies the AHB2 peripheral to gates its clock. + * This parameter can be any combination of the following values: + * @arg RCC_AHB2Periph_DCMI: DCMI clock + * @arg RCC_AHB2Periph_CRYP: CRYP clock + * @arg RCC_AHB2Periph_HASH: HASH clock + * @arg RCC_AHB2Periph_RNG: RNG clock + * @arg RCC_AHB2Periph_OTG_FS: USB OTG FS clock + * @param NewState: new state of the specified peripheral clock. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void RCC_AHB2PeriphClockCmd(uint32_t RCC_AHB2Periph, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_RCC_AHB2_PERIPH(RCC_AHB2Periph)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + RCC->AHB2ENR |= RCC_AHB2Periph; + } + else + { + RCC->AHB2ENR &= ~RCC_AHB2Periph; + } +} + +/** + * @brief Enables or disables the AHB3 peripheral clock. + * @note After reset, the peripheral clock (used for registers read/write access) + * is disabled and the application software has to enable this clock before + * using it. + * @param RCC_AHBPeriph: specifies the AHB3 peripheral to gates its clock. + * This parameter must be: RCC_AHB3Periph_FSMC + * or RCC_AHB3Periph_FMC (STM32F42xxx/43xxx devices) + * @param NewState: new state of the specified peripheral clock. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void RCC_AHB3PeriphClockCmd(uint32_t RCC_AHB3Periph, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_RCC_AHB3_PERIPH(RCC_AHB3Periph)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + RCC->AHB3ENR |= RCC_AHB3Periph; + } + else + { + RCC->AHB3ENR &= ~RCC_AHB3Periph; + } +} + +/** + * @brief Enables or disables the Low Speed APB (APB1) peripheral clock. + * @note After reset, the peripheral clock (used for registers read/write access) + * is disabled and the application software has to enable this clock before + * using it. + * @param RCC_APB1Periph: specifies the APB1 peripheral to gates its clock. + * This parameter can be any combination of the following values: + * @arg RCC_APB1Periph_TIM2: TIM2 clock + * @arg RCC_APB1Periph_TIM3: TIM3 clock + * @arg RCC_APB1Periph_TIM4: TIM4 clock + * @arg RCC_APB1Periph_TIM5: TIM5 clock + * @arg RCC_APB1Periph_TIM6: TIM6 clock + * @arg RCC_APB1Periph_TIM7: TIM7 clock + * @arg RCC_APB1Periph_TIM12: TIM12 clock + * @arg RCC_APB1Periph_TIM13: TIM13 clock + * @arg RCC_APB1Periph_TIM14: TIM14 clock + * @arg RCC_APB1Periph_WWDG: WWDG clock + * @arg RCC_APB1Periph_SPI2: SPI2 clock + * @arg RCC_APB1Periph_SPI3: SPI3 clock + * @arg RCC_APB1Periph_USART2: USART2 clock + * @arg RCC_APB1Periph_USART3: USART3 clock + * @arg RCC_APB1Periph_UART4: UART4 clock + * @arg RCC_APB1Periph_UART5: UART5 clock + * @arg RCC_APB1Periph_I2C1: I2C1 clock + * @arg RCC_APB1Periph_I2C2: I2C2 clock + * @arg RCC_APB1Periph_I2C3: I2C3 clock + * @arg RCC_APB1Periph_CAN1: CAN1 clock + * @arg RCC_APB1Periph_CAN2: CAN2 clock + * @arg RCC_APB1Periph_PWR: PWR clock + * @arg RCC_APB1Periph_DAC: DAC clock + * @arg RCC_APB1Periph_UART7: UART7 clock + * @arg RCC_APB1Periph_UART8: UART8 clock + * @param NewState: new state of the specified peripheral clock. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void RCC_APB1PeriphClockCmd(uint32_t RCC_APB1Periph, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_RCC_APB1_PERIPH(RCC_APB1Periph)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + RCC->APB1ENR |= RCC_APB1Periph; + } + else + { + RCC->APB1ENR &= ~RCC_APB1Periph; + } +} + +/** + * @brief Enables or disables the High Speed APB (APB2) peripheral clock. + * @note After reset, the peripheral clock (used for registers read/write access) + * is disabled and the application software has to enable this clock before + * using it. + * @param RCC_APB2Periph: specifies the APB2 peripheral to gates its clock. + * This parameter can be any combination of the following values: + * @arg RCC_APB2Periph_TIM1: TIM1 clock + * @arg RCC_APB2Periph_TIM8: TIM8 clock + * @arg RCC_APB2Periph_USART1: USART1 clock + * @arg RCC_APB2Periph_USART6: USART6 clock + * @arg RCC_APB2Periph_ADC1: ADC1 clock + * @arg RCC_APB2Periph_ADC2: ADC2 clock + * @arg RCC_APB2Periph_ADC3: ADC3 clock + * @arg RCC_APB2Periph_SDIO: SDIO clock + * @arg RCC_APB2Periph_SPI1: SPI1 clock + * @arg RCC_APB2Periph_SPI4: SPI4 clock + * @arg RCC_APB2Periph_SYSCFG: SYSCFG clock + * @arg RCC_APB2Periph_TIM9: TIM9 clock + * @arg RCC_APB2Periph_TIM10: TIM10 clock + * @arg RCC_APB2Periph_TIM11: TIM11 clock + * @arg RCC_APB2Periph_SPI5: SPI5 clock + * @arg RCC_APB2Periph_SPI6: SPI6 clock + * @arg RCC_APB2Periph_SAI1: SAI1 clock (STM32F42xxx/43xxx devices) + * @arg RCC_APB2Periph_LTDC: LTDC clock (STM32F429xx/439xx devices) + * @param NewState: new state of the specified peripheral clock. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void RCC_APB2PeriphClockCmd(uint32_t RCC_APB2Periph, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_RCC_APB2_PERIPH(RCC_APB2Periph)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + RCC->APB2ENR |= RCC_APB2Periph; + } + else + { + RCC->APB2ENR &= ~RCC_APB2Periph; + } +} + +/** + * @brief Forces or releases AHB1 peripheral reset. + * @param RCC_AHB1Periph: specifies the AHB1 peripheral to reset. + * This parameter can be any combination of the following values: + * @arg RCC_AHB1Periph_GPIOA: GPIOA clock + * @arg RCC_AHB1Periph_GPIOB: GPIOB clock + * @arg RCC_AHB1Periph_GPIOC: GPIOC clock + * @arg RCC_AHB1Periph_GPIOD: GPIOD clock + * @arg RCC_AHB1Periph_GPIOE: GPIOE clock + * @arg RCC_AHB1Periph_GPIOF: GPIOF clock + * @arg RCC_AHB1Periph_GPIOG: GPIOG clock + * @arg RCC_AHB1Periph_GPIOG: GPIOG clock + * @arg RCC_AHB1Periph_GPIOI: GPIOI clock + * @arg RCC_AHB1Periph_GPIOJ: GPIOJ clock (STM32F42xxx/43xxx devices) + * @arg RCC_AHB1Periph_GPIOK: GPIOK clock (STM32F42xxx/43xxxdevices) + * @arg RCC_AHB1Periph_CRC: CRC clock + * @arg RCC_AHB1Periph_DMA1: DMA1 clock + * @arg RCC_AHB1Periph_DMA2: DMA2 clock + * @arg RCC_AHB1Periph_DMA2D: DMA2D clock (STM32F429xx/439xx devices) + * @arg RCC_AHB1Periph_ETH_MAC: Ethernet MAC clock + * @arg RCC_AHB1Periph_OTG_HS: USB OTG HS clock + * + * @param NewState: new state of the specified peripheral reset. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void RCC_AHB1PeriphResetCmd(uint32_t RCC_AHB1Periph, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_RCC_AHB1_RESET_PERIPH(RCC_AHB1Periph)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + RCC->AHB1RSTR |= RCC_AHB1Periph; + } + else + { + RCC->AHB1RSTR &= ~RCC_AHB1Periph; + } +} + +/** + * @brief Forces or releases AHB2 peripheral reset. + * @param RCC_AHB2Periph: specifies the AHB2 peripheral to reset. + * This parameter can be any combination of the following values: + * @arg RCC_AHB2Periph_DCMI: DCMI clock + * @arg RCC_AHB2Periph_CRYP: CRYP clock + * @arg RCC_AHB2Periph_HASH: HASH clock + * @arg RCC_AHB2Periph_RNG: RNG clock + * @arg RCC_AHB2Periph_OTG_FS: USB OTG FS clock + * @param NewState: new state of the specified peripheral reset. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void RCC_AHB2PeriphResetCmd(uint32_t RCC_AHB2Periph, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_RCC_AHB2_PERIPH(RCC_AHB2Periph)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + RCC->AHB2RSTR |= RCC_AHB2Periph; + } + else + { + RCC->AHB2RSTR &= ~RCC_AHB2Periph; + } +} + +/** + * @brief Forces or releases AHB3 peripheral reset. + * @param RCC_AHB3Periph: specifies the AHB3 peripheral to reset. + * This parameter must be: RCC_AHB3Periph_FSMC + * or RCC_AHB3Periph_FMC (STM32F42xxx/43xxx devices) + * @param NewState: new state of the specified peripheral reset. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void RCC_AHB3PeriphResetCmd(uint32_t RCC_AHB3Periph, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_RCC_AHB3_PERIPH(RCC_AHB3Periph)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + RCC->AHB3RSTR |= RCC_AHB3Periph; + } + else + { + RCC->AHB3RSTR &= ~RCC_AHB3Periph; + } +} + +/** + * @brief Forces or releases Low Speed APB (APB1) peripheral reset. + * @param RCC_APB1Periph: specifies the APB1 peripheral to reset. + * This parameter can be any combination of the following values: + * @arg RCC_APB1Periph_TIM2: TIM2 clock + * @arg RCC_APB1Periph_TIM3: TIM3 clock + * @arg RCC_APB1Periph_TIM4: TIM4 clock + * @arg RCC_APB1Periph_TIM5: TIM5 clock + * @arg RCC_APB1Periph_TIM6: TIM6 clock + * @arg RCC_APB1Periph_TIM7: TIM7 clock + * @arg RCC_APB1Periph_TIM12: TIM12 clock + * @arg RCC_APB1Periph_TIM13: TIM13 clock + * @arg RCC_APB1Periph_TIM14: TIM14 clock + * @arg RCC_APB1Periph_WWDG: WWDG clock + * @arg RCC_APB1Periph_SPI2: SPI2 clock + * @arg RCC_APB1Periph_SPI3: SPI3 clock + * @arg RCC_APB1Periph_USART2: USART2 clock + * @arg RCC_APB1Periph_USART3: USART3 clock + * @arg RCC_APB1Periph_UART4: UART4 clock + * @arg RCC_APB1Periph_UART5: UART5 clock + * @arg RCC_APB1Periph_I2C1: I2C1 clock + * @arg RCC_APB1Periph_I2C2: I2C2 clock + * @arg RCC_APB1Periph_I2C3: I2C3 clock + * @arg RCC_APB1Periph_CAN1: CAN1 clock + * @arg RCC_APB1Periph_CAN2: CAN2 clock + * @arg RCC_APB1Periph_PWR: PWR clock + * @arg RCC_APB1Periph_DAC: DAC clock + * @arg RCC_APB1Periph_UART7: UART7 clock + * @arg RCC_APB1Periph_UART8: UART8 clock + * @param NewState: new state of the specified peripheral reset. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void RCC_APB1PeriphResetCmd(uint32_t RCC_APB1Periph, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_RCC_APB1_PERIPH(RCC_APB1Periph)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + if (NewState != DISABLE) + { + RCC->APB1RSTR |= RCC_APB1Periph; + } + else + { + RCC->APB1RSTR &= ~RCC_APB1Periph; + } +} + +/** + * @brief Forces or releases High Speed APB (APB2) peripheral reset. + * @param RCC_APB2Periph: specifies the APB2 peripheral to reset. + * This parameter can be any combination of the following values: + * @arg RCC_APB2Periph_TIM1: TIM1 clock + * @arg RCC_APB2Periph_TIM8: TIM8 clock + * @arg RCC_APB2Periph_USART1: USART1 clock + * @arg RCC_APB2Periph_USART6: USART6 clock + * @arg RCC_APB2Periph_ADC1: ADC1 clock + * @arg RCC_APB2Periph_ADC2: ADC2 clock + * @arg RCC_APB2Periph_ADC3: ADC3 clock + * @arg RCC_APB2Periph_SDIO: SDIO clock + * @arg RCC_APB2Periph_SPI1: SPI1 clock + * @arg RCC_APB2Periph_SPI4: SPI4 clock + * @arg RCC_APB2Periph_SYSCFG: SYSCFG clock + * @arg RCC_APB2Periph_TIM9: TIM9 clock + * @arg RCC_APB2Periph_TIM10: TIM10 clock + * @arg RCC_APB2Periph_TIM11: TIM11 clock + * @arg RCC_APB2Periph_SPI5: SPI5 clock + * @arg RCC_APB2Periph_SPI6: SPI6 clock + * @arg RCC_APB2Periph_SAI1: SAI1 clock (STM32F42xxx/43xxx devices) + * @arg RCC_APB2Periph_LTDC: LTDC clock (STM32F429xx/439xx devices) + * @param NewState: new state of the specified peripheral reset. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void RCC_APB2PeriphResetCmd(uint32_t RCC_APB2Periph, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_RCC_APB2_RESET_PERIPH(RCC_APB2Periph)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + if (NewState != DISABLE) + { + RCC->APB2RSTR |= RCC_APB2Periph; + } + else + { + RCC->APB2RSTR &= ~RCC_APB2Periph; + } +} + +/** + * @brief Enables or disables the AHB1 peripheral clock during Low Power (Sleep) mode. + * @note Peripheral clock gating in SLEEP mode can be used to further reduce + * power consumption. + * @note After wakeup from SLEEP mode, the peripheral clock is enabled again. + * @note By default, all peripheral clocks are enabled during SLEEP mode. + * @param RCC_AHBPeriph: specifies the AHB1 peripheral to gates its clock. + * This parameter can be any combination of the following values: + * @arg RCC_AHB1Periph_GPIOA: GPIOA clock + * @arg RCC_AHB1Periph_GPIOB: GPIOB clock + * @arg RCC_AHB1Periph_GPIOC: GPIOC clock + * @arg RCC_AHB1Periph_GPIOD: GPIOD clock + * @arg RCC_AHB1Periph_GPIOE: GPIOE clock + * @arg RCC_AHB1Periph_GPIOF: GPIOF clock + * @arg RCC_AHB1Periph_GPIOG: GPIOG clock + * @arg RCC_AHB1Periph_GPIOG: GPIOG clock + * @arg RCC_AHB1Periph_GPIOI: GPIOI clock + * @arg RCC_AHB1Periph_GPIOJ: GPIOJ clock (STM32F42xxx/43xxx devices) + * @arg RCC_AHB1Periph_GPIOK: GPIOK clock (STM32F42xxx/43xxx devices) + * @arg RCC_AHB1Periph_CRC: CRC clock + * @arg RCC_AHB1Periph_BKPSRAM: BKPSRAM interface clock + * @arg RCC_AHB1Periph_DMA1: DMA1 clock + * @arg RCC_AHB1Periph_DMA2: DMA2 clock + * @arg RCC_AHB1Periph_DMA2D: DMA2D clock (STM32F429xx/439xx devices) + * @arg RCC_AHB1Periph_ETH_MAC: Ethernet MAC clock + * @arg RCC_AHB1Periph_ETH_MAC_Tx: Ethernet Transmission clock + * @arg RCC_AHB1Periph_ETH_MAC_Rx: Ethernet Reception clock + * @arg RCC_AHB1Periph_ETH_MAC_PTP: Ethernet PTP clock + * @arg RCC_AHB1Periph_OTG_HS: USB OTG HS clock + * @arg RCC_AHB1Periph_OTG_HS_ULPI: USB OTG HS ULPI clock + * @param NewState: new state of the specified peripheral clock. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void RCC_AHB1PeriphClockLPModeCmd(uint32_t RCC_AHB1Periph, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_RCC_AHB1_LPMODE_PERIPH(RCC_AHB1Periph)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + if (NewState != DISABLE) + { + RCC->AHB1LPENR |= RCC_AHB1Periph; + } + else + { + RCC->AHB1LPENR &= ~RCC_AHB1Periph; + } +} + +/** + * @brief Enables or disables the AHB2 peripheral clock during Low Power (Sleep) mode. + * @note Peripheral clock gating in SLEEP mode can be used to further reduce + * power consumption. + * @note After wakeup from SLEEP mode, the peripheral clock is enabled again. + * @note By default, all peripheral clocks are enabled during SLEEP mode. + * @param RCC_AHBPeriph: specifies the AHB2 peripheral to gates its clock. + * This parameter can be any combination of the following values: + * @arg RCC_AHB2Periph_DCMI: DCMI clock + * @arg RCC_AHB2Periph_CRYP: CRYP clock + * @arg RCC_AHB2Periph_HASH: HASH clock + * @arg RCC_AHB2Periph_RNG: RNG clock + * @arg RCC_AHB2Periph_OTG_FS: USB OTG FS clock + * @param NewState: new state of the specified peripheral clock. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void RCC_AHB2PeriphClockLPModeCmd(uint32_t RCC_AHB2Periph, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_RCC_AHB2_PERIPH(RCC_AHB2Periph)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + if (NewState != DISABLE) + { + RCC->AHB2LPENR |= RCC_AHB2Periph; + } + else + { + RCC->AHB2LPENR &= ~RCC_AHB2Periph; + } +} + +/** + * @brief Enables or disables the AHB3 peripheral clock during Low Power (Sleep) mode. + * @note Peripheral clock gating in SLEEP mode can be used to further reduce + * power consumption. + * @note After wakeup from SLEEP mode, the peripheral clock is enabled again. + * @note By default, all peripheral clocks are enabled during SLEEP mode. + * @param RCC_AHBPeriph: specifies the AHB3 peripheral to gates its clock. + * This parameter must be: RCC_AHB3Periph_FSMC + * or RCC_AHB3Periph_FMC (STM32F429x/439x devices) + * @param NewState: new state of the specified peripheral clock. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void RCC_AHB3PeriphClockLPModeCmd(uint32_t RCC_AHB3Periph, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_RCC_AHB3_PERIPH(RCC_AHB3Periph)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + if (NewState != DISABLE) + { + RCC->AHB3LPENR |= RCC_AHB3Periph; + } + else + { + RCC->AHB3LPENR &= ~RCC_AHB3Periph; + } +} + +/** + * @brief Enables or disables the APB1 peripheral clock during Low Power (Sleep) mode. + * @note Peripheral clock gating in SLEEP mode can be used to further reduce + * power consumption. + * @note After wakeup from SLEEP mode, the peripheral clock is enabled again. + * @note By default, all peripheral clocks are enabled during SLEEP mode. + * @param RCC_APB1Periph: specifies the APB1 peripheral to gates its clock. + * This parameter can be any combination of the following values: + * @arg RCC_APB1Periph_TIM2: TIM2 clock + * @arg RCC_APB1Periph_TIM3: TIM3 clock + * @arg RCC_APB1Periph_TIM4: TIM4 clock + * @arg RCC_APB1Periph_TIM5: TIM5 clock + * @arg RCC_APB1Periph_TIM6: TIM6 clock + * @arg RCC_APB1Periph_TIM7: TIM7 clock + * @arg RCC_APB1Periph_TIM12: TIM12 clock + * @arg RCC_APB1Periph_TIM13: TIM13 clock + * @arg RCC_APB1Periph_TIM14: TIM14 clock + * @arg RCC_APB1Periph_WWDG: WWDG clock + * @arg RCC_APB1Periph_SPI2: SPI2 clock + * @arg RCC_APB1Periph_SPI3: SPI3 clock + * @arg RCC_APB1Periph_USART2: USART2 clock + * @arg RCC_APB1Periph_USART3: USART3 clock + * @arg RCC_APB1Periph_UART4: UART4 clock + * @arg RCC_APB1Periph_UART5: UART5 clock + * @arg RCC_APB1Periph_I2C1: I2C1 clock + * @arg RCC_APB1Periph_I2C2: I2C2 clock + * @arg RCC_APB1Periph_I2C3: I2C3 clock + * @arg RCC_APB1Periph_CAN1: CAN1 clock + * @arg RCC_APB1Periph_CAN2: CAN2 clock + * @arg RCC_APB1Periph_PWR: PWR clock + * @arg RCC_APB1Periph_DAC: DAC clock + * @arg RCC_APB1Periph_UART7: UART7 clock + * @arg RCC_APB1Periph_UART8: UART8 clock + * @param NewState: new state of the specified peripheral clock. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void RCC_APB1PeriphClockLPModeCmd(uint32_t RCC_APB1Periph, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_RCC_APB1_PERIPH(RCC_APB1Periph)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + if (NewState != DISABLE) + { + RCC->APB1LPENR |= RCC_APB1Periph; + } + else + { + RCC->APB1LPENR &= ~RCC_APB1Periph; + } +} + +/** + * @brief Enables or disables the APB2 peripheral clock during Low Power (Sleep) mode. + * @note Peripheral clock gating in SLEEP mode can be used to further reduce + * power consumption. + * @note After wakeup from SLEEP mode, the peripheral clock is enabled again. + * @note By default, all peripheral clocks are enabled during SLEEP mode. + * @param RCC_APB2Periph: specifies the APB2 peripheral to gates its clock. + * This parameter can be any combination of the following values: + * @arg RCC_APB2Periph_TIM1: TIM1 clock + * @arg RCC_APB2Periph_TIM8: TIM8 clock + * @arg RCC_APB2Periph_USART1: USART1 clock + * @arg RCC_APB2Periph_USART6: USART6 clock + * @arg RCC_APB2Periph_ADC1: ADC1 clock + * @arg RCC_APB2Periph_ADC2: ADC2 clock + * @arg RCC_APB2Periph_ADC3: ADC3 clock + * @arg RCC_APB2Periph_SDIO: SDIO clock + * @arg RCC_APB2Periph_SPI1: SPI1 clock + * @arg RCC_APB2Periph_SPI4: SPI4 clock + * @arg RCC_APB2Periph_SYSCFG: SYSCFG clock + * @arg RCC_APB2Periph_TIM9: TIM9 clock + * @arg RCC_APB2Periph_TIM10: TIM10 clock + * @arg RCC_APB2Periph_TIM11: TIM11 clock + * @arg RCC_APB2Periph_SPI5: SPI5 clock + * @arg RCC_APB2Periph_SPI6: SPI6 clock + * @arg RCC_APB2Periph_SAI1: SAI1 clock (STM32F42xxx/43xxx devices) + * @arg RCC_APB2Periph_LTDC: LTDC clock (STM32F429xx/439xx devices) + * @param NewState: new state of the specified peripheral clock. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void RCC_APB2PeriphClockLPModeCmd(uint32_t RCC_APB2Periph, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_RCC_APB2_PERIPH(RCC_APB2Periph)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + if (NewState != DISABLE) + { + RCC->APB2LPENR |= RCC_APB2Periph; + } + else + { + RCC->APB2LPENR &= ~RCC_APB2Periph; + } +} + +/** + * @brief Configures the External Low Speed oscillator mode (LSE mode). + * @note This mode is only available for STM32F411xx devices. + * @param Mode: specifies the LSE mode. + * This parameter can be one of the following values: + * @arg RCC_LSE_LOWPOWER_MODE: LSE oscillator in low power mode. + * @arg RCC_LSE_HIGHDRIVE_MODE: LSE oscillator in High Drive mode. + * @retval None + */ +void RCC_LSEModeConfig(uint8_t Mode) +{ + /* Check the parameters */ + assert_param(IS_RCC_LSE_MODE(Mode)); + + if(Mode == RCC_LSE_HIGHDRIVE_MODE) + { + SET_BIT(RCC->BDCR, RCC_BDCR_LSEMOD); + } + else + { + CLEAR_BIT(RCC->BDCR, RCC_BDCR_LSEMOD); + } +} + +/** + * @} + */ + +/** @defgroup RCC_Group4 Interrupts and flags management functions + * @brief Interrupts and flags management functions + * +@verbatim + =============================================================================== + ##### Interrupts and flags management functions ##### + =============================================================================== + +@endverbatim + * @{ + */ + +/** + * @brief Enables or disables the specified RCC interrupts. + * @param RCC_IT: specifies the RCC interrupt sources to be enabled or disabled. + * This parameter can be any combination of the following values: + * @arg RCC_IT_LSIRDY: LSI ready interrupt + * @arg RCC_IT_LSERDY: LSE ready interrupt + * @arg RCC_IT_HSIRDY: HSI ready interrupt + * @arg RCC_IT_HSERDY: HSE ready interrupt + * @arg RCC_IT_PLLRDY: main PLL ready interrupt + * @arg RCC_IT_PLLI2SRDY: PLLI2S ready interrupt + * @arg RCC_IT_PLLSAIRDY: PLLSAI ready interrupt (only for STM32F42xxx/43xxx devices) + * @param NewState: new state of the specified RCC interrupts. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void RCC_ITConfig(uint8_t RCC_IT, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_RCC_IT(RCC_IT)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + if (NewState != DISABLE) + { + /* Perform Byte access to RCC_CIR[14:8] bits to enable the selected interrupts */ + *(__IO uint8_t *) CIR_BYTE2_ADDRESS |= RCC_IT; + } + else + { + /* Perform Byte access to RCC_CIR[14:8] bits to disable the selected interrupts */ + *(__IO uint8_t *) CIR_BYTE2_ADDRESS &= (uint8_t)~RCC_IT; + } +} + +/** + * @brief Checks whether the specified RCC flag is set or not. + * @param RCC_FLAG: specifies the flag to check. + * This parameter can be one of the following values: + * @arg RCC_FLAG_HSIRDY: HSI oscillator clock ready + * @arg RCC_FLAG_HSERDY: HSE oscillator clock ready + * @arg RCC_FLAG_PLLRDY: main PLL clock ready + * @arg RCC_FLAG_PLLI2SRDY: PLLI2S clock ready + * @arg RCC_FLAG_PLLSAIRDY: PLLSAI clock ready (only for STM32F42xxx/43xxx devices) + * @arg RCC_FLAG_LSERDY: LSE oscillator clock ready + * @arg RCC_FLAG_LSIRDY: LSI oscillator clock ready + * @arg RCC_FLAG_BORRST: POR/PDR or BOR reset + * @arg RCC_FLAG_PINRST: Pin reset + * @arg RCC_FLAG_PORRST: POR/PDR reset + * @arg RCC_FLAG_SFTRST: Software reset + * @arg RCC_FLAG_IWDGRST: Independent Watchdog reset + * @arg RCC_FLAG_WWDGRST: Window Watchdog reset + * @arg RCC_FLAG_LPWRRST: Low Power reset + * @retval The new state of RCC_FLAG (SET or RESET). + */ +FlagStatus RCC_GetFlagStatus(uint8_t RCC_FLAG) +{ + uint32_t tmp = 0; + uint32_t statusreg = 0; + FlagStatus bitstatus = RESET; + + /* Check the parameters */ + assert_param(IS_RCC_FLAG(RCC_FLAG)); + + /* Get the RCC register index */ + tmp = RCC_FLAG >> 5; + if (tmp == 1) /* The flag to check is in CR register */ + { + statusreg = RCC->CR; + } + else if (tmp == 2) /* The flag to check is in BDCR register */ + { + statusreg = RCC->BDCR; + } + else /* The flag to check is in CSR register */ + { + statusreg = RCC->CSR; + } + + /* Get the flag position */ + tmp = RCC_FLAG & FLAG_MASK; + if ((statusreg & ((uint32_t)1 << tmp)) != (uint32_t)RESET) + { + bitstatus = SET; + } + else + { + bitstatus = RESET; + } + /* Return the flag status */ + return bitstatus; +} + +/** + * @brief Clears the RCC reset flags. + * The reset flags are: RCC_FLAG_PINRST, RCC_FLAG_PORRST, RCC_FLAG_SFTRST, + * RCC_FLAG_IWDGRST, RCC_FLAG_WWDGRST, RCC_FLAG_LPWRRST + * @param None + * @retval None + */ +void RCC_ClearFlag(void) +{ + /* Set RMVF bit to clear the reset flags */ + RCC->CSR |= RCC_CSR_RMVF; +} + +/** + * @brief Checks whether the specified RCC interrupt has occurred or not. + * @param RCC_IT: specifies the RCC interrupt source to check. + * This parameter can be one of the following values: + * @arg RCC_IT_LSIRDY: LSI ready interrupt + * @arg RCC_IT_LSERDY: LSE ready interrupt + * @arg RCC_IT_HSIRDY: HSI ready interrupt + * @arg RCC_IT_HSERDY: HSE ready interrupt + * @arg RCC_IT_PLLRDY: main PLL ready interrupt + * @arg RCC_IT_PLLI2SRDY: PLLI2S ready interrupt + * @arg RCC_IT_PLLSAIRDY: PLLSAI clock ready interrupt (only for STM32F42xxx/43xxx devices) + * @arg RCC_IT_CSS: Clock Security System interrupt + * @retval The new state of RCC_IT (SET or RESET). + */ +ITStatus RCC_GetITStatus(uint8_t RCC_IT) +{ + ITStatus bitstatus = RESET; + + /* Check the parameters */ + assert_param(IS_RCC_GET_IT(RCC_IT)); + + /* Check the status of the specified RCC interrupt */ + if ((RCC->CIR & RCC_IT) != (uint32_t)RESET) + { + bitstatus = SET; + } + else + { + bitstatus = RESET; + } + /* Return the RCC_IT status */ + return bitstatus; +} + +/** + * @brief Clears the RCC's interrupt pending bits. + * @param RCC_IT: specifies the interrupt pending bit to clear. + * This parameter can be any combination of the following values: + * @arg RCC_IT_LSIRDY: LSI ready interrupt + * @arg RCC_IT_LSERDY: LSE ready interrupt + * @arg RCC_IT_HSIRDY: HSI ready interrupt + * @arg RCC_IT_HSERDY: HSE ready interrupt + * @arg RCC_IT_PLLRDY: main PLL ready interrupt + * @arg RCC_IT_PLLI2SRDY: PLLI2S ready interrupt + * @arg RCC_IT_PLLSAIRDY: PLLSAI ready interrupt (only for STM32F42xxx/43xxx devices) + * @arg RCC_IT_CSS: Clock Security System interrupt + * @retval None + */ +void RCC_ClearITPendingBit(uint8_t RCC_IT) +{ + /* Check the parameters */ + assert_param(IS_RCC_CLEAR_IT(RCC_IT)); + + /* Perform Byte access to RCC_CIR[23:16] bits to clear the selected interrupt + pending bits */ + *(__IO uint8_t *) CIR_BYTE3_ADDRESS = RCC_IT; +} + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/src/stm32f4xx_rng.c b/FWLIB/src/stm32f4xx_rng.c new file mode 100644 index 0000000..ed851c7 --- /dev/null +++ b/FWLIB/src/stm32f4xx_rng.c @@ -0,0 +1,397 @@ +/** + ****************************************************************************** + * @file stm32f4xx_rng.c + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file provides firmware functions to manage the following + * functionalities of the Random Number Generator (RNG) peripheral: + * + Initialization and Configuration + * + Get 32 bit Random number + * + Interrupts and flags management + * +@verbatim + + =================================================================== + ##### How to use this driver ##### + =================================================================== + [..] + (#) Enable The RNG controller clock using + RCC_AHB2PeriphClockCmd(RCC_AHB2Periph_RNG, ENABLE) function. + + (#) Activate the RNG peripheral using RNG_Cmd() function. + + (#) Wait until the 32 bit Random number Generator contains a valid random data + (using polling/interrupt mode). For more details, refer to "Interrupts and + flags management functions" module description. + + (#) Get the 32 bit Random number using RNG_GetRandomNumber() function + + (#) To get another 32 bit Random number, go to step 3. + + +@endverbatim + * + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx_rng.h" +#include "stm32f4xx_rcc.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @defgroup RNG + * @brief RNG driver modules + * @{ + */ + +/* Private typedef -----------------------------------------------------------*/ +/* Private define ------------------------------------------------------------*/ +/* Private macro -------------------------------------------------------------*/ +/* Private variables ---------------------------------------------------------*/ +/* Private function prototypes -----------------------------------------------*/ +/* Private functions ---------------------------------------------------------*/ + +/** @defgroup RNG_Private_Functions + * @{ + */ + +/** @defgroup RNG_Group1 Initialization and Configuration functions + * @brief Initialization and Configuration functions + * +@verbatim + =============================================================================== + ##### Initialization and Configuration functions ##### + =============================================================================== + [..] This section provides functions allowing to + (+) Initialize the RNG peripheral + (+) Enable or disable the RNG peripheral + +@endverbatim + * @{ + */ + +/** + * @brief De-initializes the RNG peripheral registers to their default reset values. + * @param None + * @retval None + */ +void RNG_DeInit(void) +{ + /* Enable RNG reset state */ + RCC_AHB2PeriphResetCmd(RCC_AHB2Periph_RNG, ENABLE); + + /* Release RNG from reset state */ + RCC_AHB2PeriphResetCmd(RCC_AHB2Periph_RNG, DISABLE); +} + +/** + * @brief Enables or disables the RNG peripheral. + * @param NewState: new state of the RNG peripheral. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void RNG_Cmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the RNG */ + RNG->CR |= RNG_CR_RNGEN; + } + else + { + /* Disable the RNG */ + RNG->CR &= ~RNG_CR_RNGEN; + } +} +/** + * @} + */ + +/** @defgroup RNG_Group2 Get 32 bit Random number function + * @brief Get 32 bit Random number function + * + +@verbatim + =============================================================================== + ##### Get 32 bit Random number function ##### + =============================================================================== + [..] This section provides a function allowing to get the 32 bit Random number + + (@) Before to call this function you have to wait till DRDY flag is set, + using RNG_GetFlagStatus(RNG_FLAG_DRDY) function. + +@endverbatim + * @{ + */ + + +/** + * @brief Returns a 32-bit random number. + * + * @note Before to call this function you have to wait till DRDY (data ready) + * flag is set, using RNG_GetFlagStatus(RNG_FLAG_DRDY) function. + * @note Each time the the Random number data is read (using RNG_GetRandomNumber() + * function), the RNG_FLAG_DRDY flag is automatically cleared. + * @note In the case of a seed error, the generation of random numbers is + * interrupted for as long as the SECS bit is '1'. If a number is + * available in the RNG_DR register, it must not be used because it may + * not have enough entropy. In this case, it is recommended to clear the + * SEIS bit(using RNG_ClearFlag(RNG_FLAG_SECS) function), then disable + * and enable the RNG peripheral (using RNG_Cmd() function) to + * reinitialize and restart the RNG. + * @note In the case of a clock error, the RNG is no more able to generate + * random numbers because the PLL48CLK clock is not correct. User have + * to check that the clock controller is correctly configured to provide + * the RNG clock and clear the CEIS bit (using RNG_ClearFlag(RNG_FLAG_CECS) + * function) . The clock error has no impact on the previously generated + * random numbers, and the RNG_DR register contents can be used. + * + * @param None + * @retval 32-bit random number. + */ +uint32_t RNG_GetRandomNumber(void) +{ + /* Return the 32 bit random number from the DR register */ + return RNG->DR; +} + + +/** + * @} + */ + +/** @defgroup RNG_Group3 Interrupts and flags management functions + * @brief Interrupts and flags management functions + * +@verbatim + =============================================================================== + ##### Interrupts and flags management functions ##### + =============================================================================== + + [..] This section provides functions allowing to configure the RNG Interrupts and + to get the status and clear flags and Interrupts pending bits. + + [..] The RNG provides 3 Interrupts sources and 3 Flags: + + *** Flags : *** + =============== + [..] + (#) RNG_FLAG_DRDY : In the case of the RNG_DR register contains valid + random data. it is cleared by reading the valid data(using + RNG_GetRandomNumber() function). + + (#) RNG_FLAG_CECS : In the case of a seed error detection. + + (#) RNG_FLAG_SECS : In the case of a clock error detection. + + *** Interrupts *** + ================== + [..] If enabled, an RNG interrupt is pending : + + (#) In the case of the RNG_DR register contains valid random data. + This interrupt source is cleared once the RNG_DR register has been read + (using RNG_GetRandomNumber() function) until a new valid value is + computed; or + (#) In the case of a seed error : One of the following faulty sequences has + been detected: + (++) More than 64 consecutive bits at the same value (0 or 1) + (++) More than 32 consecutive alternance of 0 and 1 (0101010101...01) + This interrupt source is cleared using RNG_ClearITPendingBit(RNG_IT_SEI) + function; or + (#) In the case of a clock error : the PLL48CLK (RNG peripheral clock source) + was not correctly detected (fPLL48CLK< fHCLK/16). This interrupt source is + cleared using RNG_ClearITPendingBit(RNG_IT_CEI) function. + -@- note In this case, User have to check that the clock controller is + correctly configured to provide the RNG clock. + + *** Managing the RNG controller events : *** + ============================================ + [..] The user should identify which mode will be used in his application to manage + the RNG controller events: Polling mode or Interrupt mode. + + (#) In the Polling Mode it is advised to use the following functions: + (++) RNG_GetFlagStatus() : to check if flags events occur. + (++) RNG_ClearFlag() : to clear the flags events. + + -@@- RNG_FLAG_DRDY can not be cleared by RNG_ClearFlag(). it is cleared only + by reading the Random number data. + + (#) In the Interrupt Mode it is advised to use the following functions: + (++) RNG_ITConfig() : to enable or disable the interrupt source. + (++) RNG_GetITStatus() : to check if Interrupt occurs. + (++) RNG_ClearITPendingBit() : to clear the Interrupt pending Bit + (corresponding Flag). + +@endverbatim + * @{ + */ + +/** + * @brief Enables or disables the RNG interrupt. + * @note The RNG provides 3 interrupt sources, + * - Computed data is ready event (DRDY), and + * - Seed error Interrupt (SEI) and + * - Clock error Interrupt (CEI), + * all these interrupts sources are enabled by setting the IE bit in + * CR register. However, each interrupt have its specific status bit + * (see RNG_GetITStatus() function) and clear bit except the DRDY event + * (see RNG_ClearITPendingBit() function). + * @param NewState: new state of the RNG interrupt. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void RNG_ITConfig(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the RNG interrupt */ + RNG->CR |= RNG_CR_IE; + } + else + { + /* Disable the RNG interrupt */ + RNG->CR &= ~RNG_CR_IE; + } +} + +/** + * @brief Checks whether the specified RNG flag is set or not. + * @param RNG_FLAG: specifies the RNG flag to check. + * This parameter can be one of the following values: + * @arg RNG_FLAG_DRDY: Data Ready flag. + * @arg RNG_FLAG_CECS: Clock Error Current flag. + * @arg RNG_FLAG_SECS: Seed Error Current flag. + * @retval The new state of RNG_FLAG (SET or RESET). + */ +FlagStatus RNG_GetFlagStatus(uint8_t RNG_FLAG) +{ + FlagStatus bitstatus = RESET; + /* Check the parameters */ + assert_param(IS_RNG_GET_FLAG(RNG_FLAG)); + + /* Check the status of the specified RNG flag */ + if ((RNG->SR & RNG_FLAG) != (uint8_t)RESET) + { + /* RNG_FLAG is set */ + bitstatus = SET; + } + else + { + /* RNG_FLAG is reset */ + bitstatus = RESET; + } + /* Return the RNG_FLAG status */ + return bitstatus; +} + + +/** + * @brief Clears the RNG flags. + * @param RNG_FLAG: specifies the flag to clear. + * This parameter can be any combination of the following values: + * @arg RNG_FLAG_CECS: Clock Error Current flag. + * @arg RNG_FLAG_SECS: Seed Error Current flag. + * @note RNG_FLAG_DRDY can not be cleared by RNG_ClearFlag() function. + * This flag is cleared only by reading the Random number data (using + * RNG_GetRandomNumber() function). + * @retval None + */ +void RNG_ClearFlag(uint8_t RNG_FLAG) +{ + /* Check the parameters */ + assert_param(IS_RNG_CLEAR_FLAG(RNG_FLAG)); + /* Clear the selected RNG flags */ + RNG->SR = ~(uint32_t)(((uint32_t)RNG_FLAG) << 4); +} + +/** + * @brief Checks whether the specified RNG interrupt has occurred or not. + * @param RNG_IT: specifies the RNG interrupt source to check. + * This parameter can be one of the following values: + * @arg RNG_IT_CEI: Clock Error Interrupt. + * @arg RNG_IT_SEI: Seed Error Interrupt. + * @retval The new state of RNG_IT (SET or RESET). + */ +ITStatus RNG_GetITStatus(uint8_t RNG_IT) +{ + ITStatus bitstatus = RESET; + /* Check the parameters */ + assert_param(IS_RNG_GET_IT(RNG_IT)); + + /* Check the status of the specified RNG interrupt */ + if ((RNG->SR & RNG_IT) != (uint8_t)RESET) + { + /* RNG_IT is set */ + bitstatus = SET; + } + else + { + /* RNG_IT is reset */ + bitstatus = RESET; + } + /* Return the RNG_IT status */ + return bitstatus; +} + + +/** + * @brief Clears the RNG interrupt pending bit(s). + * @param RNG_IT: specifies the RNG interrupt pending bit(s) to clear. + * This parameter can be any combination of the following values: + * @arg RNG_IT_CEI: Clock Error Interrupt. + * @arg RNG_IT_SEI: Seed Error Interrupt. + * @retval None + */ +void RNG_ClearITPendingBit(uint8_t RNG_IT) +{ + /* Check the parameters */ + assert_param(IS_RNG_IT(RNG_IT)); + + /* Clear the selected RNG interrupt pending bit */ + RNG->SR = (uint8_t)~RNG_IT; +} +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/src/stm32f4xx_rtc.c b/FWLIB/src/stm32f4xx_rtc.c new file mode 100644 index 0000000..4861ade --- /dev/null +++ b/FWLIB/src/stm32f4xx_rtc.c @@ -0,0 +1,2761 @@ +/** + ****************************************************************************** + * @file stm32f4xx_rtc.c + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file provides firmware functions to manage the following + * functionalities of the Real-Time Clock (RTC) peripheral: + * + Initialization + * + Calendar (Time and Date) configuration + * + Alarms (Alarm A and Alarm B) configuration + * + WakeUp Timer configuration + * + Daylight Saving configuration + * + Output pin Configuration + * + Coarse digital Calibration configuration + * + Smooth digital Calibration configuration + * + TimeStamp configuration + * + Tampers configuration + * + Backup Data Registers configuration + * + Shift control synchronisation + * + RTC Tamper and TimeStamp Pins Selection and Output Type Config configuration + * + Interrupts and flags management + * +@verbatim + + =================================================================== + ##### Backup Domain Operating Condition ##### + =================================================================== + [..] The real-time clock (RTC), the RTC backup registers, and the backup + SRAM (BKP SRAM) can be powered from the VBAT voltage when the main + VDD supply is powered off. + To retain the content of the RTC backup registers, backup SRAM, and supply + the RTC when VDD is turned off, VBAT pin can be connected to an optional + standby voltage supplied by a battery or by another source. + + [..] To allow the RTC to operate even when the main digital supply (VDD) is turned + off, the VBAT pin powers the following blocks: + (#) The RTC + (#) The LSE oscillator + (#) The backup SRAM when the low power backup regulator is enabled + (#) PC13 to PC15 I/Os, plus PI8 I/O (when available) + + [..] When the backup domain is supplied by VDD (analog switch connected to VDD), + the following functions are available: + (#) PC14 and PC15 can be used as either GPIO or LSE pins + (#) PC13 can be used as a GPIO or as the RTC_AF1 pin + (#) PI8 can be used as a GPIO or as the RTC_AF2 pin + + [..] When the backup domain is supplied by VBAT (analog switch connected to VBAT + because VDD is not present), the following functions are available: + (#) PC14 and PC15 can be used as LSE pins only + (#) PC13 can be used as the RTC_AF1 pin + (#) PI8 can be used as the RTC_AF2 pin + + + ##### Backup Domain Reset ##### + =================================================================== + [..] The backup domain reset sets all RTC registers and the RCC_BDCR register + to their reset values. The BKPSRAM is not affected by this reset. The only + way of resetting the BKPSRAM is through the Flash interface by requesting + a protection level change from 1 to 0. + [..] A backup domain reset is generated when one of the following events occurs: + (#) Software reset, triggered by setting the BDRST bit in the + RCC Backup domain control register (RCC_BDCR). You can use the + RCC_BackupResetCmd(). + (#) VDD or VBAT power on, if both supplies have previously been powered off. + + + ##### Backup Domain Access ##### + =================================================================== + [..] After reset, the backup domain (RTC registers, RTC backup data + registers and backup SRAM) is protected against possible unwanted write + accesses. + [..] To enable access to the RTC Domain and RTC registers, proceed as follows: + (+) Enable the Power Controller (PWR) APB1 interface clock using the + RCC_APB1PeriphClockCmd() function. + (+) Enable access to RTC domain using the PWR_BackupAccessCmd() function. + (+) Select the RTC clock source using the RCC_RTCCLKConfig() function. + (+) Enable RTC Clock using the RCC_RTCCLKCmd() function. + + + ##### How to use RTC Driver ##### + =================================================================== + [..] + (+) Enable the RTC domain access (see description in the section above) + (+) Configure the RTC Prescaler (Asynchronous and Synchronous) and RTC hour + format using the RTC_Init() function. + + *** Time and Date configuration *** + =================================== + [..] + (+) To configure the RTC Calendar (Time and Date) use the RTC_SetTime() + and RTC_SetDate() functions. + (+) To read the RTC Calendar, use the RTC_GetTime() and RTC_GetDate() functions. + (+) Use the RTC_DayLightSavingConfig() function to add or sub one + hour to the RTC Calendar. + + *** Alarm configuration *** + =========================== + [..] + (+) To configure the RTC Alarm use the RTC_SetAlarm() function. + (+) Enable the selected RTC Alarm using the RTC_AlarmCmd() function + (+) To read the RTC Alarm, use the RTC_GetAlarm() function. + (+) To read the RTC alarm SubSecond, use the RTC_GetAlarmSubSecond() function. + + *** RTC Wakeup configuration *** + ================================ + [..] + (+) Configure the RTC Wakeup Clock source use the RTC_WakeUpClockConfig() + function. + (+) Configure the RTC WakeUp Counter using the RTC_SetWakeUpCounter() function + (+) Enable the RTC WakeUp using the RTC_WakeUpCmd() function + (+) To read the RTC WakeUp Counter register, use the RTC_GetWakeUpCounter() + function. + + *** Outputs configuration *** + ============================= + [..] The RTC has 2 different outputs: + (+) AFO_ALARM: this output is used to manage the RTC Alarm A, Alarm B + and WaKeUp signals. To output the selected RTC signal on RTC_AF1 pin, use the + RTC_OutputConfig() function. + (+) AFO_CALIB: this output is 512Hz signal or 1Hz. To output the RTC Clock on + RTC_AF1 pin, use the RTC_CalibOutputCmd() function. + + *** Smooth digital Calibration configuration *** + ================================================ + [..] + (+) Configure the RTC Original Digital Calibration Value and the corresponding + calibration cycle period (32s,16s and 8s) using the RTC_SmoothCalibConfig() + function. + + *** Coarse digital Calibration configuration *** + ================================================ + [..] + (+) Configure the RTC Coarse Calibration Value and the corresponding + sign using the RTC_CoarseCalibConfig() function. + (+) Enable the RTC Coarse Calibration using the RTC_CoarseCalibCmd() function + + *** TimeStamp configuration *** + =============================== + [..] + (+) Configure the RTC_AF1 trigger and enables the RTC TimeStamp using the RTC + _TimeStampCmd() function. + (+) To read the RTC TimeStamp Time and Date register, use the RTC_GetTimeStamp() + function. + (+) To read the RTC TimeStamp SubSecond register, use the + RTC_GetTimeStampSubSecond() function. + (+) The TAMPER1 alternate function can be mapped either to RTC_AF1(PC13) + or RTC_AF2 (PI8) depending on the value of TAMP1INSEL bit in + RTC_TAFCR register. You can use the RTC_TamperPinSelection() function to + select the corresponding pin. + + *** Tamper configuration *** + ============================ + [..] + (+) Enable the RTC Tamper using the RTC_TamperCmd() function. + (+) Configure the Tamper filter count using RTC_TamperFilterConfig() + function. + (+) Configure the RTC Tamper trigger Edge or Level according to the Tamper + filter (if equal to 0 Edge else Level) value using the RTC_TamperConfig() + function. + (+) Configure the Tamper sampling frequency using RTC_TamperSamplingFreqConfig() + function. + (+) Configure the Tamper precharge or discharge duration using + RTC_TamperPinsPrechargeDuration() function. + (+) Enable the Tamper Pull-UP using RTC_TamperPullUpDisableCmd() function. + (+) Enable the Time stamp on Tamper detection event using + TC_TSOnTamperDetecCmd() function. + (+) The TIMESTAMP alternate function can be mapped to either RTC_AF1 + or RTC_AF2 depending on the value of the TSINSEL bit in the RTC_TAFCR + register. You can use the RTC_TimeStampPinSelection() function to select + the corresponding pin. + + *** Backup Data Registers configuration *** + =========================================== + [..] + (+) To write to the RTC Backup Data registers, use the RTC_WriteBackupRegister() + function. + (+) To read the RTC Backup Data registers, use the RTC_ReadBackupRegister() + function. + + + ##### RTC and low power modes ##### + =================================================================== + [..] The MCU can be woken up from a low power mode by an RTC alternate + function. + [..] The RTC alternate functions are the RTC alarms (Alarm A and Alarm B), + RTC wakeup, RTC tamper event detection and RTC time stamp event detection. + These RTC alternate functions can wake up the system from the Stop and + Standby lowpower modes. + [..] The system can also wake up from low power modes without depending + on an external interrupt (Auto-wakeup mode), by using the RTC alarm + or the RTC wakeup events. + [..] The RTC provides a programmable time base for waking up from the + Stop or Standby mode at regular intervals. + Wakeup from STOP and Standby modes is possible only when the RTC clock source + is LSE or LSI. + + + ##### Selection of RTC_AF1 alternate functions ##### + =================================================================== + [..] The RTC_AF1 pin (PC13) can be used for the following purposes: + (+) AFO_ALARM output + (+) AFO_CALIB output + (+) AFI_TAMPER + (+) AFI_TIMESTAMP + + [..] + +-------------------------------------------------------------------------------------------------------------+ + | Pin |AFO_ALARM |AFO_CALIB |AFI_TAMPER |AFI_TIMESTAMP | TAMP1INSEL | TSINSEL |ALARMOUTTYPE | + | configuration | ENABLED | ENABLED | ENABLED | ENABLED |TAMPER1 pin |TIMESTAMP pin | AFO_ALARM | + | and function | | | | | selection | selection |Configuration | + |-----------------|----------|----------|-----------|--------------|------------|--------------|--------------| + | Alarm out | | | | | Don't | Don't | | + | output OD | 1 |Don't care|Don't care | Don't care | care | care | 0 | + |-----------------|----------|----------|-----------|--------------|------------|--------------|--------------| + | Alarm out | | | | | Don't | Don't | | + | output PP | 1 |Don't care|Don't care | Don't care | care | care | 1 | + |-----------------|----------|----------|-----------|--------------|------------|--------------|--------------| + | Calibration out | | | | | Don't | Don't | | + | output PP | 0 | 1 |Don't care | Don't care | care | care | Don't care | + |-----------------|----------|----------|-----------|--------------|------------|--------------|--------------| + | TAMPER input | | | | | | Don't | | + | floating | 0 | 0 | 1 | 0 | 0 | care | Don't care | + |-----------------|----------|----------|-----------|--------------|------------|--------------|--------------| + | TIMESTAMP and | | | | | | | | + | TAMPER input | 0 | 0 | 1 | 1 | 0 | 0 | Don't care | + | floating | | | | | | | | + |-----------------|----------|----------|-----------|--------------|------------|--------------|--------------| + | TIMESTAMP input | | | | | Don't | | | + | floating | 0 | 0 | 0 | 1 | care | 0 | Don't care | + |-----------------|----------|----------|-----------|--------------|------------|--------------|--------------| + | Standard GPIO | 0 | 0 | 0 | 0 | Don't care | Don't care | Don't care | + +-------------------------------------------------------------------------------------------------------------+ + + + ##### Selection of RTC_AF2 alternate functions ##### + =================================================================== + [..] The RTC_AF2 pin (PI8) can be used for the following purposes: + (+) AFI_TAMPER + (+) AFI_TIMESTAMP + [..] + +---------------------------------------------------------------------------------------+ + | Pin |AFI_TAMPER |AFI_TIMESTAMP | TAMP1INSEL | TSINSEL |ALARMOUTTYPE | + | configuration | ENABLED | ENABLED |TAMPER1 pin |TIMESTAMP pin | AFO_ALARM | + | and function | | | selection | selection |Configuration | + |-----------------|-----------|--------------|------------|--------------|--------------| + | TAMPER input | | | | Don't | | + | floating | 1 | 0 | 1 | care | Don't care | + |-----------------|-----------|--------------|------------|--------------|--------------| + | TIMESTAMP and | | | | | | + | TAMPER input | 1 | 1 | 1 | 1 | Don't care | + | floating | | | | | | + |-----------------|-----------|--------------|------------|--------------|--------------| + | TIMESTAMP input | | | Don't | | | + | floating | 0 | 1 | care | 1 | Don't care | + |-----------------|-----------|--------------|------------|--------------|--------------| + | Standard GPIO | 0 | 0 | Don't care | Don't care | Don't care | + +---------------------------------------------------------------------------------------+ + + +@endverbatim + + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx_rtc.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @defgroup RTC + * @brief RTC driver modules + * @{ + */ + +/* Private typedef -----------------------------------------------------------*/ +/* Private define ------------------------------------------------------------*/ + +/* Masks Definition */ +#define RTC_TR_RESERVED_MASK ((uint32_t)0x007F7F7F) +#define RTC_DR_RESERVED_MASK ((uint32_t)0x00FFFF3F) +#define RTC_INIT_MASK ((uint32_t)0xFFFFFFFF) +#define RTC_RSF_MASK ((uint32_t)0xFFFFFF5F) +#define RTC_FLAGS_MASK ((uint32_t)(RTC_FLAG_TSOVF | RTC_FLAG_TSF | RTC_FLAG_WUTF | \ + RTC_FLAG_ALRBF | RTC_FLAG_ALRAF | RTC_FLAG_INITF | \ + RTC_FLAG_RSF | RTC_FLAG_INITS | RTC_FLAG_WUTWF | \ + RTC_FLAG_ALRBWF | RTC_FLAG_ALRAWF | RTC_FLAG_TAMP1F | \ + RTC_FLAG_RECALPF | RTC_FLAG_SHPF)) + +#define INITMODE_TIMEOUT ((uint32_t) 0x00010000) +#define SYNCHRO_TIMEOUT ((uint32_t) 0x00020000) +#define RECALPF_TIMEOUT ((uint32_t) 0x00020000) +#define SHPF_TIMEOUT ((uint32_t) 0x00001000) + +/* Private macro -------------------------------------------------------------*/ +/* Private variables ---------------------------------------------------------*/ +/* Private function prototypes -----------------------------------------------*/ +static uint8_t RTC_ByteToBcd2(uint8_t Value); +static uint8_t RTC_Bcd2ToByte(uint8_t Value); + +/* Private functions ---------------------------------------------------------*/ + +/** @defgroup RTC_Private_Functions + * @{ + */ + +/** @defgroup RTC_Group1 Initialization and Configuration functions + * @brief Initialization and Configuration functions + * +@verbatim + =============================================================================== + ##### Initialization and Configuration functions ##### + =============================================================================== + + [..] This section provide functions allowing to initialize and configure the RTC + Prescaler (Synchronous and Asynchronous), RTC Hour format, disable RTC registers + Write protection, enter and exit the RTC initialization mode, RTC registers + synchronization check and reference clock detection enable. + + (#) The RTC Prescaler is programmed to generate the RTC 1Hz time base. It is + split into 2 programmable prescalers to minimize power consumption. + (++) A 7-bit asynchronous prescaler and A 13-bit synchronous prescaler. + (++) When both prescalers are used, it is recommended to configure the + asynchronous prescaler to a high value to minimize consumption. + + (#) All RTC registers are Write protected. Writing to the RTC registers + is enabled by writing a key into the Write Protection register, RTC_WPR. + + (#) To Configure the RTC Calendar, user application should enter initialization + mode. In this mode, the calendar counter is stopped and its value can be + updated. When the initialization sequence is complete, the calendar restarts + counting after 4 RTCCLK cycles. + + (#) To read the calendar through the shadow registers after Calendar initialization, + calendar update or after wakeup from low power modes the software must first + clear the RSF flag. The software must then wait until it is set again before + reading the calendar, which means that the calendar registers have been + correctly copied into the RTC_TR and RTC_DR shadow registers. + The RTC_WaitForSynchro() function implements the above software sequence + (RSF clear and RSF check). + +@endverbatim + * @{ + */ + +/** + * @brief Deinitializes the RTC registers to their default reset values. + * @note This function doesn't reset the RTC Clock source and RTC Backup Data + * registers. + * @param None + * @retval An ErrorStatus enumeration value: + * - SUCCESS: RTC registers are deinitialized + * - ERROR: RTC registers are not deinitialized + */ +ErrorStatus RTC_DeInit(void) +{ + __IO uint32_t wutcounter = 0x00; + uint32_t wutwfstatus = 0x00; + ErrorStatus status = ERROR; + + /* Disable the write protection for RTC registers */ + RTC->WPR = 0xCA; + RTC->WPR = 0x53; + + /* Set Initialization mode */ + if (RTC_EnterInitMode() == ERROR) + { + status = ERROR; + } + else + { + /* Reset TR, DR and CR registers */ + RTC->TR = (uint32_t)0x00000000; + RTC->DR = (uint32_t)0x00002101; + /* Reset All CR bits except CR[2:0] */ + RTC->CR &= (uint32_t)0x00000007; + + /* Wait till RTC WUTWF flag is set and if Time out is reached exit */ + do + { + wutwfstatus = RTC->ISR & RTC_ISR_WUTWF; + wutcounter++; + } while((wutcounter != INITMODE_TIMEOUT) && (wutwfstatus == 0x00)); + + if ((RTC->ISR & RTC_ISR_WUTWF) == RESET) + { + status = ERROR; + } + else + { + /* Reset all RTC CR register bits */ + RTC->CR &= (uint32_t)0x00000000; + RTC->WUTR = (uint32_t)0x0000FFFF; + RTC->PRER = (uint32_t)0x007F00FF; + RTC->CALIBR = (uint32_t)0x00000000; + RTC->ALRMAR = (uint32_t)0x00000000; + RTC->ALRMBR = (uint32_t)0x00000000; + RTC->SHIFTR = (uint32_t)0x00000000; + RTC->CALR = (uint32_t)0x00000000; + RTC->ALRMASSR = (uint32_t)0x00000000; + RTC->ALRMBSSR = (uint32_t)0x00000000; + + /* Reset ISR register and exit initialization mode */ + RTC->ISR = (uint32_t)0x00000000; + + /* Reset Tamper and alternate functions configuration register */ + RTC->TAFCR = 0x00000000; + + if(RTC_WaitForSynchro() == ERROR) + { + status = ERROR; + } + else + { + status = SUCCESS; + } + } + } + + /* Enable the write protection for RTC registers */ + RTC->WPR = 0xFF; + + return status; +} + +/** + * @brief Initializes the RTC registers according to the specified parameters + * in RTC_InitStruct. + * @param RTC_InitStruct: pointer to a RTC_InitTypeDef structure that contains + * the configuration information for the RTC peripheral. + * @note The RTC Prescaler register is write protected and can be written in + * initialization mode only. + * @retval An ErrorStatus enumeration value: + * - SUCCESS: RTC registers are initialized + * - ERROR: RTC registers are not initialized + */ +ErrorStatus RTC_Init(RTC_InitTypeDef* RTC_InitStruct) +{ + ErrorStatus status = ERROR; + + /* Check the parameters */ + assert_param(IS_RTC_HOUR_FORMAT(RTC_InitStruct->RTC_HourFormat)); + assert_param(IS_RTC_ASYNCH_PREDIV(RTC_InitStruct->RTC_AsynchPrediv)); + assert_param(IS_RTC_SYNCH_PREDIV(RTC_InitStruct->RTC_SynchPrediv)); + + /* Disable the write protection for RTC registers */ + RTC->WPR = 0xCA; + RTC->WPR = 0x53; + + /* Set Initialization mode */ + if (RTC_EnterInitMode() == ERROR) + { + status = ERROR; + } + else + { + /* Clear RTC CR FMT Bit */ + RTC->CR &= ((uint32_t)~(RTC_CR_FMT)); + /* Set RTC_CR register */ + RTC->CR |= ((uint32_t)(RTC_InitStruct->RTC_HourFormat)); + + /* Configure the RTC PRER */ + RTC->PRER = (uint32_t)(RTC_InitStruct->RTC_SynchPrediv); + RTC->PRER |= (uint32_t)(RTC_InitStruct->RTC_AsynchPrediv << 16); + + /* Exit Initialization mode */ + RTC_ExitInitMode(); + + status = SUCCESS; + } + /* Enable the write protection for RTC registers */ + RTC->WPR = 0xFF; + + return status; +} + +/** + * @brief Fills each RTC_InitStruct member with its default value. + * @param RTC_InitStruct: pointer to a RTC_InitTypeDef structure which will be + * initialized. + * @retval None + */ +void RTC_StructInit(RTC_InitTypeDef* RTC_InitStruct) +{ + /* Initialize the RTC_HourFormat member */ + RTC_InitStruct->RTC_HourFormat = RTC_HourFormat_24; + + /* Initialize the RTC_AsynchPrediv member */ + RTC_InitStruct->RTC_AsynchPrediv = (uint32_t)0x7F; + + /* Initialize the RTC_SynchPrediv member */ + RTC_InitStruct->RTC_SynchPrediv = (uint32_t)0xFF; +} + +/** + * @brief Enables or disables the RTC registers write protection. + * @note All the RTC registers are write protected except for RTC_ISR[13:8], + * RTC_TAFCR and RTC_BKPxR. + * @note Writing a wrong key reactivates the write protection. + * @note The protection mechanism is not affected by system reset. + * @param NewState: new state of the write protection. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void RTC_WriteProtectionCmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the write protection for RTC registers */ + RTC->WPR = 0xFF; + } + else + { + /* Disable the write protection for RTC registers */ + RTC->WPR = 0xCA; + RTC->WPR = 0x53; + } +} + +/** + * @brief Enters the RTC Initialization mode. + * @note The RTC Initialization mode is write protected, use the + * RTC_WriteProtectionCmd(DISABLE) before calling this function. + * @param None + * @retval An ErrorStatus enumeration value: + * - SUCCESS: RTC is in Init mode + * - ERROR: RTC is not in Init mode + */ +ErrorStatus RTC_EnterInitMode(void) +{ + __IO uint32_t initcounter = 0x00; + ErrorStatus status = ERROR; + uint32_t initstatus = 0x00; + + /* Check if the Initialization mode is set */ + if ((RTC->ISR & RTC_ISR_INITF) == (uint32_t)RESET) + { + /* Set the Initialization mode */ + RTC->ISR = (uint32_t)RTC_INIT_MASK; + + /* Wait till RTC is in INIT state and if Time out is reached exit */ + do + { + initstatus = RTC->ISR & RTC_ISR_INITF; + initcounter++; + } while((initcounter != INITMODE_TIMEOUT) && (initstatus == 0x00)); + + if ((RTC->ISR & RTC_ISR_INITF) != RESET) + { + status = SUCCESS; + } + else + { + status = ERROR; + } + } + else + { + status = SUCCESS; + } + + return (status); +} + +/** + * @brief Exits the RTC Initialization mode. + * @note When the initialization sequence is complete, the calendar restarts + * counting after 4 RTCCLK cycles. + * @note The RTC Initialization mode is write protected, use the + * RTC_WriteProtectionCmd(DISABLE) before calling this function. + * @param None + * @retval None + */ +void RTC_ExitInitMode(void) +{ + /* Exit Initialization mode */ + RTC->ISR &= (uint32_t)~RTC_ISR_INIT; +} + +/** + * @brief Waits until the RTC Time and Date registers (RTC_TR and RTC_DR) are + * synchronized with RTC APB clock. + * @note The RTC Resynchronization mode is write protected, use the + * RTC_WriteProtectionCmd(DISABLE) before calling this function. + * @note To read the calendar through the shadow registers after Calendar + * initialization, calendar update or after wakeup from low power modes + * the software must first clear the RSF flag. + * The software must then wait until it is set again before reading + * the calendar, which means that the calendar registers have been + * correctly copied into the RTC_TR and RTC_DR shadow registers. + * @param None + * @retval An ErrorStatus enumeration value: + * - SUCCESS: RTC registers are synchronised + * - ERROR: RTC registers are not synchronised + */ +ErrorStatus RTC_WaitForSynchro(void) +{ + __IO uint32_t synchrocounter = 0; + ErrorStatus status = ERROR; + uint32_t synchrostatus = 0x00; + + /* Disable the write protection for RTC registers */ + RTC->WPR = 0xCA; + RTC->WPR = 0x53; + + /* Clear RSF flag */ + RTC->ISR &= (uint32_t)RTC_RSF_MASK; + + /* Wait the registers to be synchronised */ + do + { + synchrostatus = RTC->ISR & RTC_ISR_RSF; + synchrocounter++; + } while((synchrocounter != SYNCHRO_TIMEOUT) && (synchrostatus == 0x00)); + + if ((RTC->ISR & RTC_ISR_RSF) != RESET) + { + status = SUCCESS; + } + else + { + status = ERROR; + } + + /* Enable the write protection for RTC registers */ + RTC->WPR = 0xFF; + + return (status); +} + +/** + * @brief Enables or disables the RTC reference clock detection. + * @param NewState: new state of the RTC reference clock. + * This parameter can be: ENABLE or DISABLE. + * @retval An ErrorStatus enumeration value: + * - SUCCESS: RTC reference clock detection is enabled + * - ERROR: RTC reference clock detection is disabled + */ +ErrorStatus RTC_RefClockCmd(FunctionalState NewState) +{ + ErrorStatus status = ERROR; + + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + /* Disable the write protection for RTC registers */ + RTC->WPR = 0xCA; + RTC->WPR = 0x53; + + /* Set Initialization mode */ + if (RTC_EnterInitMode() == ERROR) + { + status = ERROR; + } + else + { + if (NewState != DISABLE) + { + /* Enable the RTC reference clock detection */ + RTC->CR |= RTC_CR_REFCKON; + } + else + { + /* Disable the RTC reference clock detection */ + RTC->CR &= ~RTC_CR_REFCKON; + } + /* Exit Initialization mode */ + RTC_ExitInitMode(); + + status = SUCCESS; + } + + /* Enable the write protection for RTC registers */ + RTC->WPR = 0xFF; + + return status; +} + +/** + * @brief Enables or Disables the Bypass Shadow feature. + * @note When the Bypass Shadow is enabled the calendar value are taken + * directly from the Calendar counter. + * @param NewState: new state of the Bypass Shadow feature. + * This parameter can be: ENABLE or DISABLE. + * @retval None +*/ +void RTC_BypassShadowCmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + /* Disable the write protection for RTC registers */ + RTC->WPR = 0xCA; + RTC->WPR = 0x53; + + if (NewState != DISABLE) + { + /* Set the BYPSHAD bit */ + RTC->CR |= (uint8_t)RTC_CR_BYPSHAD; + } + else + { + /* Reset the BYPSHAD bit */ + RTC->CR &= (uint8_t)~RTC_CR_BYPSHAD; + } + + /* Enable the write protection for RTC registers */ + RTC->WPR = 0xFF; +} + +/** + * @} + */ + +/** @defgroup RTC_Group2 Time and Date configuration functions + * @brief Time and Date configuration functions + * +@verbatim + =============================================================================== + ##### Time and Date configuration functions ##### + =============================================================================== + + [..] This section provide functions allowing to program and read the RTC Calendar + (Time and Date). + +@endverbatim + * @{ + */ + +/** + * @brief Set the RTC current time. + * @param RTC_Format: specifies the format of the entered parameters. + * This parameter can be one of the following values: + * @arg RTC_Format_BIN: Binary data format + * @arg RTC_Format_BCD: BCD data format + * @param RTC_TimeStruct: pointer to a RTC_TimeTypeDef structure that contains + * the time configuration information for the RTC. + * @retval An ErrorStatus enumeration value: + * - SUCCESS: RTC Time register is configured + * - ERROR: RTC Time register is not configured + */ +ErrorStatus RTC_SetTime(uint32_t RTC_Format, RTC_TimeTypeDef* RTC_TimeStruct) +{ + uint32_t tmpreg = 0; + ErrorStatus status = ERROR; + + /* Check the parameters */ + assert_param(IS_RTC_FORMAT(RTC_Format)); + + if (RTC_Format == RTC_Format_BIN) + { + if ((RTC->CR & RTC_CR_FMT) != (uint32_t)RESET) + { + assert_param(IS_RTC_HOUR12(RTC_TimeStruct->RTC_Hours)); + assert_param(IS_RTC_H12(RTC_TimeStruct->RTC_H12)); + } + else + { + RTC_TimeStruct->RTC_H12 = 0x00; + assert_param(IS_RTC_HOUR24(RTC_TimeStruct->RTC_Hours)); + } + assert_param(IS_RTC_MINUTES(RTC_TimeStruct->RTC_Minutes)); + assert_param(IS_RTC_SECONDS(RTC_TimeStruct->RTC_Seconds)); + } + else + { + if ((RTC->CR & RTC_CR_FMT) != (uint32_t)RESET) + { + tmpreg = RTC_Bcd2ToByte(RTC_TimeStruct->RTC_Hours); + assert_param(IS_RTC_HOUR12(tmpreg)); + assert_param(IS_RTC_H12(RTC_TimeStruct->RTC_H12)); + } + else + { + RTC_TimeStruct->RTC_H12 = 0x00; + assert_param(IS_RTC_HOUR24(RTC_Bcd2ToByte(RTC_TimeStruct->RTC_Hours))); + } + assert_param(IS_RTC_MINUTES(RTC_Bcd2ToByte(RTC_TimeStruct->RTC_Minutes))); + assert_param(IS_RTC_SECONDS(RTC_Bcd2ToByte(RTC_TimeStruct->RTC_Seconds))); + } + + /* Check the input parameters format */ + if (RTC_Format != RTC_Format_BIN) + { + tmpreg = (((uint32_t)(RTC_TimeStruct->RTC_Hours) << 16) | \ + ((uint32_t)(RTC_TimeStruct->RTC_Minutes) << 8) | \ + ((uint32_t)RTC_TimeStruct->RTC_Seconds) | \ + ((uint32_t)(RTC_TimeStruct->RTC_H12) << 16)); + } + else + { + tmpreg = (uint32_t)(((uint32_t)RTC_ByteToBcd2(RTC_TimeStruct->RTC_Hours) << 16) | \ + ((uint32_t)RTC_ByteToBcd2(RTC_TimeStruct->RTC_Minutes) << 8) | \ + ((uint32_t)RTC_ByteToBcd2(RTC_TimeStruct->RTC_Seconds)) | \ + (((uint32_t)RTC_TimeStruct->RTC_H12) << 16)); + } + + /* Disable the write protection for RTC registers */ + RTC->WPR = 0xCA; + RTC->WPR = 0x53; + + /* Set Initialization mode */ + if (RTC_EnterInitMode() == ERROR) + { + status = ERROR; + } + else + { + /* Set the RTC_TR register */ + RTC->TR = (uint32_t)(tmpreg & RTC_TR_RESERVED_MASK); + + /* Exit Initialization mode */ + RTC_ExitInitMode(); + + /* If RTC_CR_BYPSHAD bit = 0, wait for synchro else this check is not needed */ + if ((RTC->CR & RTC_CR_BYPSHAD) == RESET) + { + if(RTC_WaitForSynchro() == ERROR) + { + status = ERROR; + } + else + { + status = SUCCESS; + } + } + else + { + status = SUCCESS; + } + } + /* Enable the write protection for RTC registers */ + RTC->WPR = 0xFF; + + return status; +} + +/** + * @brief Fills each RTC_TimeStruct member with its default value + * (Time = 00h:00min:00sec). + * @param RTC_TimeStruct: pointer to a RTC_TimeTypeDef structure which will be + * initialized. + * @retval None + */ +void RTC_TimeStructInit(RTC_TimeTypeDef* RTC_TimeStruct) +{ + /* Time = 00h:00min:00sec */ + RTC_TimeStruct->RTC_H12 = RTC_H12_AM; + RTC_TimeStruct->RTC_Hours = 0; + RTC_TimeStruct->RTC_Minutes = 0; + RTC_TimeStruct->RTC_Seconds = 0; +} + +/** + * @brief Get the RTC current Time. + * @param RTC_Format: specifies the format of the returned parameters. + * This parameter can be one of the following values: + * @arg RTC_Format_BIN: Binary data format + * @arg RTC_Format_BCD: BCD data format + * @param RTC_TimeStruct: pointer to a RTC_TimeTypeDef structure that will + * contain the returned current time configuration. + * @retval None + */ +void RTC_GetTime(uint32_t RTC_Format, RTC_TimeTypeDef* RTC_TimeStruct) +{ + uint32_t tmpreg = 0; + + /* Check the parameters */ + assert_param(IS_RTC_FORMAT(RTC_Format)); + + /* Get the RTC_TR register */ + tmpreg = (uint32_t)(RTC->TR & RTC_TR_RESERVED_MASK); + + /* Fill the structure fields with the read parameters */ + RTC_TimeStruct->RTC_Hours = (uint8_t)((tmpreg & (RTC_TR_HT | RTC_TR_HU)) >> 16); + RTC_TimeStruct->RTC_Minutes = (uint8_t)((tmpreg & (RTC_TR_MNT | RTC_TR_MNU)) >>8); + RTC_TimeStruct->RTC_Seconds = (uint8_t)(tmpreg & (RTC_TR_ST | RTC_TR_SU)); + RTC_TimeStruct->RTC_H12 = (uint8_t)((tmpreg & (RTC_TR_PM)) >> 16); + + /* Check the input parameters format */ + if (RTC_Format == RTC_Format_BIN) + { + /* Convert the structure parameters to Binary format */ + RTC_TimeStruct->RTC_Hours = (uint8_t)RTC_Bcd2ToByte(RTC_TimeStruct->RTC_Hours); + RTC_TimeStruct->RTC_Minutes = (uint8_t)RTC_Bcd2ToByte(RTC_TimeStruct->RTC_Minutes); + RTC_TimeStruct->RTC_Seconds = (uint8_t)RTC_Bcd2ToByte(RTC_TimeStruct->RTC_Seconds); + } +} + +/** + * @brief Gets the RTC current Calendar Sub seconds value. + * @note This function freeze the Time and Date registers after reading the + * SSR register. + * @param None + * @retval RTC current Calendar Sub seconds value. + */ +uint32_t RTC_GetSubSecond(void) +{ + uint32_t tmpreg = 0; + + /* Get sub seconds values from the correspondent registers*/ + tmpreg = (uint32_t)(RTC->SSR); + + /* Read DR register to unfroze calendar registers */ + (void) (RTC->DR); + + return (tmpreg); +} + +/** + * @brief Set the RTC current date. + * @param RTC_Format: specifies the format of the entered parameters. + * This parameter can be one of the following values: + * @arg RTC_Format_BIN: Binary data format + * @arg RTC_Format_BCD: BCD data format + * @param RTC_DateStruct: pointer to a RTC_DateTypeDef structure that contains + * the date configuration information for the RTC. + * @retval An ErrorStatus enumeration value: + * - SUCCESS: RTC Date register is configured + * - ERROR: RTC Date register is not configured + */ +ErrorStatus RTC_SetDate(uint32_t RTC_Format, RTC_DateTypeDef* RTC_DateStruct) +{ + uint32_t tmpreg = 0; + ErrorStatus status = ERROR; + + /* Check the parameters */ + assert_param(IS_RTC_FORMAT(RTC_Format)); + + if ((RTC_Format == RTC_Format_BIN) && ((RTC_DateStruct->RTC_Month & 0x10) == 0x10)) + { + RTC_DateStruct->RTC_Month = (RTC_DateStruct->RTC_Month & (uint32_t)~(0x10)) + 0x0A; + } + if (RTC_Format == RTC_Format_BIN) + { + assert_param(IS_RTC_YEAR(RTC_DateStruct->RTC_Year)); + assert_param(IS_RTC_MONTH(RTC_DateStruct->RTC_Month)); + assert_param(IS_RTC_DATE(RTC_DateStruct->RTC_Date)); + } + else + { + assert_param(IS_RTC_YEAR(RTC_Bcd2ToByte(RTC_DateStruct->RTC_Year))); + tmpreg = RTC_Bcd2ToByte(RTC_DateStruct->RTC_Month); + assert_param(IS_RTC_MONTH(tmpreg)); + tmpreg = RTC_Bcd2ToByte(RTC_DateStruct->RTC_Date); + assert_param(IS_RTC_DATE(tmpreg)); + } + assert_param(IS_RTC_WEEKDAY(RTC_DateStruct->RTC_WeekDay)); + + /* Check the input parameters format */ + if (RTC_Format != RTC_Format_BIN) + { + tmpreg = ((((uint32_t)RTC_DateStruct->RTC_Year) << 16) | \ + (((uint32_t)RTC_DateStruct->RTC_Month) << 8) | \ + ((uint32_t)RTC_DateStruct->RTC_Date) | \ + (((uint32_t)RTC_DateStruct->RTC_WeekDay) << 13)); + } + else + { + tmpreg = (((uint32_t)RTC_ByteToBcd2(RTC_DateStruct->RTC_Year) << 16) | \ + ((uint32_t)RTC_ByteToBcd2(RTC_DateStruct->RTC_Month) << 8) | \ + ((uint32_t)RTC_ByteToBcd2(RTC_DateStruct->RTC_Date)) | \ + ((uint32_t)RTC_DateStruct->RTC_WeekDay << 13)); + } + + /* Disable the write protection for RTC registers */ + RTC->WPR = 0xCA; + RTC->WPR = 0x53; + + /* Set Initialization mode */ + if (RTC_EnterInitMode() == ERROR) + { + status = ERROR; + } + else + { + /* Set the RTC_DR register */ + RTC->DR = (uint32_t)(tmpreg & RTC_DR_RESERVED_MASK); + + /* Exit Initialization mode */ + RTC_ExitInitMode(); + + /* If RTC_CR_BYPSHAD bit = 0, wait for synchro else this check is not needed */ + if ((RTC->CR & RTC_CR_BYPSHAD) == RESET) + { + if(RTC_WaitForSynchro() == ERROR) + { + status = ERROR; + } + else + { + status = SUCCESS; + } + } + else + { + status = SUCCESS; + } + } + /* Enable the write protection for RTC registers */ + RTC->WPR = 0xFF; + + return status; +} + +/** + * @brief Fills each RTC_DateStruct member with its default value + * (Monday, January 01 xx00). + * @param RTC_DateStruct: pointer to a RTC_DateTypeDef structure which will be + * initialized. + * @retval None + */ +void RTC_DateStructInit(RTC_DateTypeDef* RTC_DateStruct) +{ + /* Monday, January 01 xx00 */ + RTC_DateStruct->RTC_WeekDay = RTC_Weekday_Monday; + RTC_DateStruct->RTC_Date = 1; + RTC_DateStruct->RTC_Month = RTC_Month_January; + RTC_DateStruct->RTC_Year = 0; +} + +/** + * @brief Get the RTC current date. + * @param RTC_Format: specifies the format of the returned parameters. + * This parameter can be one of the following values: + * @arg RTC_Format_BIN: Binary data format + * @arg RTC_Format_BCD: BCD data format + * @param RTC_DateStruct: pointer to a RTC_DateTypeDef structure that will + * contain the returned current date configuration. + * @retval None + */ +void RTC_GetDate(uint32_t RTC_Format, RTC_DateTypeDef* RTC_DateStruct) +{ + uint32_t tmpreg = 0; + + /* Check the parameters */ + assert_param(IS_RTC_FORMAT(RTC_Format)); + + /* Get the RTC_TR register */ + tmpreg = (uint32_t)(RTC->DR & RTC_DR_RESERVED_MASK); + + /* Fill the structure fields with the read parameters */ + RTC_DateStruct->RTC_Year = (uint8_t)((tmpreg & (RTC_DR_YT | RTC_DR_YU)) >> 16); + RTC_DateStruct->RTC_Month = (uint8_t)((tmpreg & (RTC_DR_MT | RTC_DR_MU)) >> 8); + RTC_DateStruct->RTC_Date = (uint8_t)(tmpreg & (RTC_DR_DT | RTC_DR_DU)); + RTC_DateStruct->RTC_WeekDay = (uint8_t)((tmpreg & (RTC_DR_WDU)) >> 13); + + /* Check the input parameters format */ + if (RTC_Format == RTC_Format_BIN) + { + /* Convert the structure parameters to Binary format */ + RTC_DateStruct->RTC_Year = (uint8_t)RTC_Bcd2ToByte(RTC_DateStruct->RTC_Year); + RTC_DateStruct->RTC_Month = (uint8_t)RTC_Bcd2ToByte(RTC_DateStruct->RTC_Month); + RTC_DateStruct->RTC_Date = (uint8_t)RTC_Bcd2ToByte(RTC_DateStruct->RTC_Date); + } +} + +/** + * @} + */ + +/** @defgroup RTC_Group3 Alarms configuration functions + * @brief Alarms (Alarm A and Alarm B) configuration functions + * +@verbatim + =============================================================================== + ##### Alarms A and B configuration functions ##### + =============================================================================== + + [..] This section provide functions allowing to program and read the RTC Alarms. + +@endverbatim + * @{ + */ + +/** + * @brief Set the specified RTC Alarm. + * @note The Alarm register can only be written when the corresponding Alarm + * is disabled (Use the RTC_AlarmCmd(DISABLE)). + * @param RTC_Format: specifies the format of the returned parameters. + * This parameter can be one of the following values: + * @arg RTC_Format_BIN: Binary data format + * @arg RTC_Format_BCD: BCD data format + * @param RTC_Alarm: specifies the alarm to be configured. + * This parameter can be one of the following values: + * @arg RTC_Alarm_A: to select Alarm A + * @arg RTC_Alarm_B: to select Alarm B + * @param RTC_AlarmStruct: pointer to a RTC_AlarmTypeDef structure that + * contains the alarm configuration parameters. + * @retval None + */ +void RTC_SetAlarm(uint32_t RTC_Format, uint32_t RTC_Alarm, RTC_AlarmTypeDef* RTC_AlarmStruct) +{ + uint32_t tmpreg = 0; + + /* Check the parameters */ + assert_param(IS_RTC_FORMAT(RTC_Format)); + assert_param(IS_RTC_ALARM(RTC_Alarm)); + assert_param(IS_ALARM_MASK(RTC_AlarmStruct->RTC_AlarmMask)); + assert_param(IS_RTC_ALARM_DATE_WEEKDAY_SEL(RTC_AlarmStruct->RTC_AlarmDateWeekDaySel)); + + if (RTC_Format == RTC_Format_BIN) + { + if ((RTC->CR & RTC_CR_FMT) != (uint32_t)RESET) + { + assert_param(IS_RTC_HOUR12(RTC_AlarmStruct->RTC_AlarmTime.RTC_Hours)); + assert_param(IS_RTC_H12(RTC_AlarmStruct->RTC_AlarmTime.RTC_H12)); + } + else + { + RTC_AlarmStruct->RTC_AlarmTime.RTC_H12 = 0x00; + assert_param(IS_RTC_HOUR24(RTC_AlarmStruct->RTC_AlarmTime.RTC_Hours)); + } + assert_param(IS_RTC_MINUTES(RTC_AlarmStruct->RTC_AlarmTime.RTC_Minutes)); + assert_param(IS_RTC_SECONDS(RTC_AlarmStruct->RTC_AlarmTime.RTC_Seconds)); + + if(RTC_AlarmStruct->RTC_AlarmDateWeekDaySel == RTC_AlarmDateWeekDaySel_Date) + { + assert_param(IS_RTC_ALARM_DATE_WEEKDAY_DATE(RTC_AlarmStruct->RTC_AlarmDateWeekDay)); + } + else + { + assert_param(IS_RTC_ALARM_DATE_WEEKDAY_WEEKDAY(RTC_AlarmStruct->RTC_AlarmDateWeekDay)); + } + } + else + { + if ((RTC->CR & RTC_CR_FMT) != (uint32_t)RESET) + { + tmpreg = RTC_Bcd2ToByte(RTC_AlarmStruct->RTC_AlarmTime.RTC_Hours); + assert_param(IS_RTC_HOUR12(tmpreg)); + assert_param(IS_RTC_H12(RTC_AlarmStruct->RTC_AlarmTime.RTC_H12)); + } + else + { + RTC_AlarmStruct->RTC_AlarmTime.RTC_H12 = 0x00; + assert_param(IS_RTC_HOUR24(RTC_Bcd2ToByte(RTC_AlarmStruct->RTC_AlarmTime.RTC_Hours))); + } + + assert_param(IS_RTC_MINUTES(RTC_Bcd2ToByte(RTC_AlarmStruct->RTC_AlarmTime.RTC_Minutes))); + assert_param(IS_RTC_SECONDS(RTC_Bcd2ToByte(RTC_AlarmStruct->RTC_AlarmTime.RTC_Seconds))); + + if(RTC_AlarmStruct->RTC_AlarmDateWeekDaySel == RTC_AlarmDateWeekDaySel_Date) + { + tmpreg = RTC_Bcd2ToByte(RTC_AlarmStruct->RTC_AlarmDateWeekDay); + assert_param(IS_RTC_ALARM_DATE_WEEKDAY_DATE(tmpreg)); + } + else + { + tmpreg = RTC_Bcd2ToByte(RTC_AlarmStruct->RTC_AlarmDateWeekDay); + assert_param(IS_RTC_ALARM_DATE_WEEKDAY_WEEKDAY(tmpreg)); + } + } + + /* Check the input parameters format */ + if (RTC_Format != RTC_Format_BIN) + { + tmpreg = (((uint32_t)(RTC_AlarmStruct->RTC_AlarmTime.RTC_Hours) << 16) | \ + ((uint32_t)(RTC_AlarmStruct->RTC_AlarmTime.RTC_Minutes) << 8) | \ + ((uint32_t)RTC_AlarmStruct->RTC_AlarmTime.RTC_Seconds) | \ + ((uint32_t)(RTC_AlarmStruct->RTC_AlarmTime.RTC_H12) << 16) | \ + ((uint32_t)(RTC_AlarmStruct->RTC_AlarmDateWeekDay) << 24) | \ + ((uint32_t)RTC_AlarmStruct->RTC_AlarmDateWeekDaySel) | \ + ((uint32_t)RTC_AlarmStruct->RTC_AlarmMask)); + } + else + { + tmpreg = (((uint32_t)RTC_ByteToBcd2(RTC_AlarmStruct->RTC_AlarmTime.RTC_Hours) << 16) | \ + ((uint32_t)RTC_ByteToBcd2(RTC_AlarmStruct->RTC_AlarmTime.RTC_Minutes) << 8) | \ + ((uint32_t)RTC_ByteToBcd2(RTC_AlarmStruct->RTC_AlarmTime.RTC_Seconds)) | \ + ((uint32_t)(RTC_AlarmStruct->RTC_AlarmTime.RTC_H12) << 16) | \ + ((uint32_t)RTC_ByteToBcd2(RTC_AlarmStruct->RTC_AlarmDateWeekDay) << 24) | \ + ((uint32_t)RTC_AlarmStruct->RTC_AlarmDateWeekDaySel) | \ + ((uint32_t)RTC_AlarmStruct->RTC_AlarmMask)); + } + + /* Disable the write protection for RTC registers */ + RTC->WPR = 0xCA; + RTC->WPR = 0x53; + + /* Configure the Alarm register */ + if (RTC_Alarm == RTC_Alarm_A) + { + RTC->ALRMAR = (uint32_t)tmpreg; + } + else + { + RTC->ALRMBR = (uint32_t)tmpreg; + } + + /* Enable the write protection for RTC registers */ + RTC->WPR = 0xFF; +} + +/** + * @brief Fills each RTC_AlarmStruct member with its default value + * (Time = 00h:00mn:00sec / Date = 1st day of the month/Mask = + * all fields are masked). + * @param RTC_AlarmStruct: pointer to a @ref RTC_AlarmTypeDef structure which + * will be initialized. + * @retval None + */ +void RTC_AlarmStructInit(RTC_AlarmTypeDef* RTC_AlarmStruct) +{ + /* Alarm Time Settings : Time = 00h:00mn:00sec */ + RTC_AlarmStruct->RTC_AlarmTime.RTC_H12 = RTC_H12_AM; + RTC_AlarmStruct->RTC_AlarmTime.RTC_Hours = 0; + RTC_AlarmStruct->RTC_AlarmTime.RTC_Minutes = 0; + RTC_AlarmStruct->RTC_AlarmTime.RTC_Seconds = 0; + + /* Alarm Date Settings : Date = 1st day of the month */ + RTC_AlarmStruct->RTC_AlarmDateWeekDaySel = RTC_AlarmDateWeekDaySel_Date; + RTC_AlarmStruct->RTC_AlarmDateWeekDay = 1; + + /* Alarm Masks Settings : Mask = all fields are not masked */ + RTC_AlarmStruct->RTC_AlarmMask = RTC_AlarmMask_None; +} + +/** + * @brief Get the RTC Alarm value and masks. + * @param RTC_Format: specifies the format of the output parameters. + * This parameter can be one of the following values: + * @arg RTC_Format_BIN: Binary data format + * @arg RTC_Format_BCD: BCD data format + * @param RTC_Alarm: specifies the alarm to be read. + * This parameter can be one of the following values: + * @arg RTC_Alarm_A: to select Alarm A + * @arg RTC_Alarm_B: to select Alarm B + * @param RTC_AlarmStruct: pointer to a RTC_AlarmTypeDef structure that will + * contains the output alarm configuration values. + * @retval None + */ +void RTC_GetAlarm(uint32_t RTC_Format, uint32_t RTC_Alarm, RTC_AlarmTypeDef* RTC_AlarmStruct) +{ + uint32_t tmpreg = 0; + + /* Check the parameters */ + assert_param(IS_RTC_FORMAT(RTC_Format)); + assert_param(IS_RTC_ALARM(RTC_Alarm)); + + /* Get the RTC_ALRMxR register */ + if (RTC_Alarm == RTC_Alarm_A) + { + tmpreg = (uint32_t)(RTC->ALRMAR); + } + else + { + tmpreg = (uint32_t)(RTC->ALRMBR); + } + + /* Fill the structure with the read parameters */ + RTC_AlarmStruct->RTC_AlarmTime.RTC_Hours = (uint32_t)((tmpreg & (RTC_ALRMAR_HT | \ + RTC_ALRMAR_HU)) >> 16); + RTC_AlarmStruct->RTC_AlarmTime.RTC_Minutes = (uint32_t)((tmpreg & (RTC_ALRMAR_MNT | \ + RTC_ALRMAR_MNU)) >> 8); + RTC_AlarmStruct->RTC_AlarmTime.RTC_Seconds = (uint32_t)(tmpreg & (RTC_ALRMAR_ST | \ + RTC_ALRMAR_SU)); + RTC_AlarmStruct->RTC_AlarmTime.RTC_H12 = (uint32_t)((tmpreg & RTC_ALRMAR_PM) >> 16); + RTC_AlarmStruct->RTC_AlarmDateWeekDay = (uint32_t)((tmpreg & (RTC_ALRMAR_DT | RTC_ALRMAR_DU)) >> 24); + RTC_AlarmStruct->RTC_AlarmDateWeekDaySel = (uint32_t)(tmpreg & RTC_ALRMAR_WDSEL); + RTC_AlarmStruct->RTC_AlarmMask = (uint32_t)(tmpreg & RTC_AlarmMask_All); + + if (RTC_Format == RTC_Format_BIN) + { + RTC_AlarmStruct->RTC_AlarmTime.RTC_Hours = RTC_Bcd2ToByte(RTC_AlarmStruct-> \ + RTC_AlarmTime.RTC_Hours); + RTC_AlarmStruct->RTC_AlarmTime.RTC_Minutes = RTC_Bcd2ToByte(RTC_AlarmStruct-> \ + RTC_AlarmTime.RTC_Minutes); + RTC_AlarmStruct->RTC_AlarmTime.RTC_Seconds = RTC_Bcd2ToByte(RTC_AlarmStruct-> \ + RTC_AlarmTime.RTC_Seconds); + RTC_AlarmStruct->RTC_AlarmDateWeekDay = RTC_Bcd2ToByte(RTC_AlarmStruct->RTC_AlarmDateWeekDay); + } +} + +/** + * @brief Enables or disables the specified RTC Alarm. + * @param RTC_Alarm: specifies the alarm to be configured. + * This parameter can be any combination of the following values: + * @arg RTC_Alarm_A: to select Alarm A + * @arg RTC_Alarm_B: to select Alarm B + * @param NewState: new state of the specified alarm. + * This parameter can be: ENABLE or DISABLE. + * @retval An ErrorStatus enumeration value: + * - SUCCESS: RTC Alarm is enabled/disabled + * - ERROR: RTC Alarm is not enabled/disabled + */ +ErrorStatus RTC_AlarmCmd(uint32_t RTC_Alarm, FunctionalState NewState) +{ + __IO uint32_t alarmcounter = 0x00; + uint32_t alarmstatus = 0x00; + ErrorStatus status = ERROR; + + /* Check the parameters */ + assert_param(IS_RTC_CMD_ALARM(RTC_Alarm)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + /* Disable the write protection for RTC registers */ + RTC->WPR = 0xCA; + RTC->WPR = 0x53; + + /* Configure the Alarm state */ + if (NewState != DISABLE) + { + RTC->CR |= (uint32_t)RTC_Alarm; + + status = SUCCESS; + } + else + { + /* Disable the Alarm in RTC_CR register */ + RTC->CR &= (uint32_t)~RTC_Alarm; + + /* Wait till RTC ALRxWF flag is set and if Time out is reached exit */ + do + { + alarmstatus = RTC->ISR & (RTC_Alarm >> 8); + alarmcounter++; + } while((alarmcounter != INITMODE_TIMEOUT) && (alarmstatus == 0x00)); + + if ((RTC->ISR & (RTC_Alarm >> 8)) == RESET) + { + status = ERROR; + } + else + { + status = SUCCESS; + } + } + + /* Enable the write protection for RTC registers */ + RTC->WPR = 0xFF; + + return status; +} + +/** + * @brief Configure the RTC AlarmA/B Sub seconds value and mask.* + * @note This function is performed only when the Alarm is disabled. + * @param RTC_Alarm: specifies the alarm to be configured. + * This parameter can be one of the following values: + * @arg RTC_Alarm_A: to select Alarm A + * @arg RTC_Alarm_B: to select Alarm B + * @param RTC_AlarmSubSecondValue: specifies the Sub seconds value. + * This parameter can be a value from 0 to 0x00007FFF. + * @param RTC_AlarmSubSecondMask: specifies the Sub seconds Mask. + * This parameter can be any combination of the following values: + * @arg RTC_AlarmSubSecondMask_All : All Alarm SS fields are masked. + * There is no comparison on sub seconds for Alarm. + * @arg RTC_AlarmSubSecondMask_SS14_1 : SS[14:1] are don't care in Alarm comparison. + * Only SS[0] is compared + * @arg RTC_AlarmSubSecondMask_SS14_2 : SS[14:2] are don't care in Alarm comparison. + * Only SS[1:0] are compared + * @arg RTC_AlarmSubSecondMask_SS14_3 : SS[14:3] are don't care in Alarm comparison. + * Only SS[2:0] are compared + * @arg RTC_AlarmSubSecondMask_SS14_4 : SS[14:4] are don't care in Alarm comparison. + * Only SS[3:0] are compared + * @arg RTC_AlarmSubSecondMask_SS14_5 : SS[14:5] are don't care in Alarm comparison. + * Only SS[4:0] are compared + * @arg RTC_AlarmSubSecondMask_SS14_6 : SS[14:6] are don't care in Alarm comparison. + * Only SS[5:0] are compared + * @arg RTC_AlarmSubSecondMask_SS14_7 : SS[14:7] are don't care in Alarm comparison. + * Only SS[6:0] are compared + * @arg RTC_AlarmSubSecondMask_SS14_8 : SS[14:8] are don't care in Alarm comparison. + * Only SS[7:0] are compared + * @arg RTC_AlarmSubSecondMask_SS14_9 : SS[14:9] are don't care in Alarm comparison. + * Only SS[8:0] are compared + * @arg RTC_AlarmSubSecondMask_SS14_10: SS[14:10] are don't care in Alarm comparison. + * Only SS[9:0] are compared + * @arg RTC_AlarmSubSecondMask_SS14_11: SS[14:11] are don't care in Alarm comparison. + * Only SS[10:0] are compared + * @arg RTC_AlarmSubSecondMask_SS14_12: SS[14:12] are don't care in Alarm comparison. + * Only SS[11:0] are compared + * @arg RTC_AlarmSubSecondMask_SS14_13: SS[14:13] are don't care in Alarm comparison. + * Only SS[12:0] are compared + * @arg RTC_AlarmSubSecondMask_SS14 : SS[14] is don't care in Alarm comparison. + * Only SS[13:0] are compared + * @arg RTC_AlarmSubSecondMask_None : SS[14:0] are compared and must match + * to activate alarm + * @retval None + */ +void RTC_AlarmSubSecondConfig(uint32_t RTC_Alarm, uint32_t RTC_AlarmSubSecondValue, uint32_t RTC_AlarmSubSecondMask) +{ + uint32_t tmpreg = 0; + + /* Check the parameters */ + assert_param(IS_RTC_ALARM(RTC_Alarm)); + assert_param(IS_RTC_ALARM_SUB_SECOND_VALUE(RTC_AlarmSubSecondValue)); + assert_param(IS_RTC_ALARM_SUB_SECOND_MASK(RTC_AlarmSubSecondMask)); + + /* Disable the write protection for RTC registers */ + RTC->WPR = 0xCA; + RTC->WPR = 0x53; + + /* Configure the Alarm A or Alarm B Sub Second registers */ + tmpreg = (uint32_t) (uint32_t)(RTC_AlarmSubSecondValue) | (uint32_t)(RTC_AlarmSubSecondMask); + + if (RTC_Alarm == RTC_Alarm_A) + { + /* Configure the Alarm A Sub Second register */ + RTC->ALRMASSR = tmpreg; + } + else + { + /* Configure the Alarm B Sub Second register */ + RTC->ALRMBSSR = tmpreg; + } + + /* Enable the write protection for RTC registers */ + RTC->WPR = 0xFF; + +} + +/** + * @brief Gets the RTC Alarm Sub seconds value. + * @param RTC_Alarm: specifies the alarm to be read. + * This parameter can be one of the following values: + * @arg RTC_Alarm_A: to select Alarm A + * @arg RTC_Alarm_B: to select Alarm B + * @param None + * @retval RTC Alarm Sub seconds value. + */ +uint32_t RTC_GetAlarmSubSecond(uint32_t RTC_Alarm) +{ + uint32_t tmpreg = 0; + + /* Get the RTC_ALRMxR register */ + if (RTC_Alarm == RTC_Alarm_A) + { + tmpreg = (uint32_t)((RTC->ALRMASSR) & RTC_ALRMASSR_SS); + } + else + { + tmpreg = (uint32_t)((RTC->ALRMBSSR) & RTC_ALRMBSSR_SS); + } + + return (tmpreg); +} + +/** + * @} + */ + +/** @defgroup RTC_Group4 WakeUp Timer configuration functions + * @brief WakeUp Timer configuration functions + * +@verbatim + =============================================================================== + ##### WakeUp Timer configuration functions ##### + =============================================================================== + + [..] This section provide functions allowing to program and read the RTC WakeUp. + +@endverbatim + * @{ + */ + +/** + * @brief Configures the RTC Wakeup clock source. + * @note The WakeUp Clock source can only be changed when the RTC WakeUp + * is disabled (Use the RTC_WakeUpCmd(DISABLE)). + * @param RTC_WakeUpClock: Wakeup Clock source. + * This parameter can be one of the following values: + * @arg RTC_WakeUpClock_RTCCLK_Div16: RTC Wakeup Counter Clock = RTCCLK/16 + * @arg RTC_WakeUpClock_RTCCLK_Div8: RTC Wakeup Counter Clock = RTCCLK/8 + * @arg RTC_WakeUpClock_RTCCLK_Div4: RTC Wakeup Counter Clock = RTCCLK/4 + * @arg RTC_WakeUpClock_RTCCLK_Div2: RTC Wakeup Counter Clock = RTCCLK/2 + * @arg RTC_WakeUpClock_CK_SPRE_16bits: RTC Wakeup Counter Clock = CK_SPRE + * @arg RTC_WakeUpClock_CK_SPRE_17bits: RTC Wakeup Counter Clock = CK_SPRE + * @retval None + */ +void RTC_WakeUpClockConfig(uint32_t RTC_WakeUpClock) +{ + /* Check the parameters */ + assert_param(IS_RTC_WAKEUP_CLOCK(RTC_WakeUpClock)); + + /* Disable the write protection for RTC registers */ + RTC->WPR = 0xCA; + RTC->WPR = 0x53; + + /* Clear the Wakeup Timer clock source bits in CR register */ + RTC->CR &= (uint32_t)~RTC_CR_WUCKSEL; + + /* Configure the clock source */ + RTC->CR |= (uint32_t)RTC_WakeUpClock; + + /* Enable the write protection for RTC registers */ + RTC->WPR = 0xFF; +} + +/** + * @brief Configures the RTC Wakeup counter. + * @note The RTC WakeUp counter can only be written when the RTC WakeUp + * is disabled (Use the RTC_WakeUpCmd(DISABLE)). + * @param RTC_WakeUpCounter: specifies the WakeUp counter. + * This parameter can be a value from 0x0000 to 0xFFFF. + * @retval None + */ +void RTC_SetWakeUpCounter(uint32_t RTC_WakeUpCounter) +{ + /* Check the parameters */ + assert_param(IS_RTC_WAKEUP_COUNTER(RTC_WakeUpCounter)); + + /* Disable the write protection for RTC registers */ + RTC->WPR = 0xCA; + RTC->WPR = 0x53; + + /* Configure the Wakeup Timer counter */ + RTC->WUTR = (uint32_t)RTC_WakeUpCounter; + + /* Enable the write protection for RTC registers */ + RTC->WPR = 0xFF; +} + +/** + * @brief Returns the RTC WakeUp timer counter value. + * @param None + * @retval The RTC WakeUp Counter value. + */ +uint32_t RTC_GetWakeUpCounter(void) +{ + /* Get the counter value */ + return ((uint32_t)(RTC->WUTR & RTC_WUTR_WUT)); +} + +/** + * @brief Enables or Disables the RTC WakeUp timer. + * @param NewState: new state of the WakeUp timer. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +ErrorStatus RTC_WakeUpCmd(FunctionalState NewState) +{ + __IO uint32_t wutcounter = 0x00; + uint32_t wutwfstatus = 0x00; + ErrorStatus status = ERROR; + + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + /* Disable the write protection for RTC registers */ + RTC->WPR = 0xCA; + RTC->WPR = 0x53; + + if (NewState != DISABLE) + { + /* Enable the Wakeup Timer */ + RTC->CR |= (uint32_t)RTC_CR_WUTE; + status = SUCCESS; + } + else + { + /* Disable the Wakeup Timer */ + RTC->CR &= (uint32_t)~RTC_CR_WUTE; + /* Wait till RTC WUTWF flag is set and if Time out is reached exit */ + do + { + wutwfstatus = RTC->ISR & RTC_ISR_WUTWF; + wutcounter++; + } while((wutcounter != INITMODE_TIMEOUT) && (wutwfstatus == 0x00)); + + if ((RTC->ISR & RTC_ISR_WUTWF) == RESET) + { + status = ERROR; + } + else + { + status = SUCCESS; + } + } + + /* Enable the write protection for RTC registers */ + RTC->WPR = 0xFF; + + return status; +} + +/** + * @} + */ + +/** @defgroup RTC_Group5 Daylight Saving configuration functions + * @brief Daylight Saving configuration functions + * +@verbatim + =============================================================================== + ##### Daylight Saving configuration functions ##### + =============================================================================== + + [..] This section provide functions allowing to configure the RTC DayLight Saving. + +@endverbatim + * @{ + */ + +/** + * @brief Adds or substract one hour from the current time. + * @param RTC_DayLightSaveOperation: the value of hour adjustment. + * This parameter can be one of the following values: + * @arg RTC_DayLightSaving_SUB1H: Substract one hour (winter time) + * @arg RTC_DayLightSaving_ADD1H: Add one hour (summer time) + * @param RTC_StoreOperation: Specifies the value to be written in the BCK bit + * in CR register to store the operation. + * This parameter can be one of the following values: + * @arg RTC_StoreOperation_Reset: BCK Bit Reset + * @arg RTC_StoreOperation_Set: BCK Bit Set + * @retval None + */ +void RTC_DayLightSavingConfig(uint32_t RTC_DayLightSaving, uint32_t RTC_StoreOperation) +{ + /* Check the parameters */ + assert_param(IS_RTC_DAYLIGHT_SAVING(RTC_DayLightSaving)); + assert_param(IS_RTC_STORE_OPERATION(RTC_StoreOperation)); + + /* Disable the write protection for RTC registers */ + RTC->WPR = 0xCA; + RTC->WPR = 0x53; + + /* Clear the bits to be configured */ + RTC->CR &= (uint32_t)~(RTC_CR_BCK); + + /* Configure the RTC_CR register */ + RTC->CR |= (uint32_t)(RTC_DayLightSaving | RTC_StoreOperation); + + /* Enable the write protection for RTC registers */ + RTC->WPR = 0xFF; +} + +/** + * @brief Returns the RTC Day Light Saving stored operation. + * @param None + * @retval RTC Day Light Saving stored operation. + * - RTC_StoreOperation_Reset + * - RTC_StoreOperation_Set + */ +uint32_t RTC_GetStoreOperation(void) +{ + return (RTC->CR & RTC_CR_BCK); +} + +/** + * @} + */ + +/** @defgroup RTC_Group6 Output pin Configuration function + * @brief Output pin Configuration function + * +@verbatim + =============================================================================== + ##### Output pin Configuration function ##### + =============================================================================== + + [..] This section provide functions allowing to configure the RTC Output source. + +@endverbatim + * @{ + */ + +/** + * @brief Configures the RTC output source (AFO_ALARM). + * @param RTC_Output: Specifies which signal will be routed to the RTC output. + * This parameter can be one of the following values: + * @arg RTC_Output_Disable: No output selected + * @arg RTC_Output_AlarmA: signal of AlarmA mapped to output + * @arg RTC_Output_AlarmB: signal of AlarmB mapped to output + * @arg RTC_Output_WakeUp: signal of WakeUp mapped to output + * @param RTC_OutputPolarity: Specifies the polarity of the output signal. + * This parameter can be one of the following: + * @arg RTC_OutputPolarity_High: The output pin is high when the + * ALRAF/ALRBF/WUTF is high (depending on OSEL) + * @arg RTC_OutputPolarity_Low: The output pin is low when the + * ALRAF/ALRBF/WUTF is high (depending on OSEL) + * @retval None + */ +void RTC_OutputConfig(uint32_t RTC_Output, uint32_t RTC_OutputPolarity) +{ + /* Check the parameters */ + assert_param(IS_RTC_OUTPUT(RTC_Output)); + assert_param(IS_RTC_OUTPUT_POL(RTC_OutputPolarity)); + + /* Disable the write protection for RTC registers */ + RTC->WPR = 0xCA; + RTC->WPR = 0x53; + + /* Clear the bits to be configured */ + RTC->CR &= (uint32_t)~(RTC_CR_OSEL | RTC_CR_POL); + + /* Configure the output selection and polarity */ + RTC->CR |= (uint32_t)(RTC_Output | RTC_OutputPolarity); + + /* Enable the write protection for RTC registers */ + RTC->WPR = 0xFF; +} + +/** + * @} + */ + +/** @defgroup RTC_Group7 Digital Calibration configuration functions + * @brief Coarse Calibration configuration functions + * +@verbatim + =============================================================================== + ##### Digital Calibration configuration functions ##### + =============================================================================== + +@endverbatim + * @{ + */ + +/** + * @brief Configures the Coarse calibration parameters. + * @param RTC_CalibSign: specifies the sign of the coarse calibration value. + * This parameter can be one of the following values: + * @arg RTC_CalibSign_Positive: The value sign is positive + * @arg RTC_CalibSign_Negative: The value sign is negative + * @param Value: value of coarse calibration expressed in ppm (coded on 5 bits). + * + * @note This Calibration value should be between 0 and 63 when using negative + * sign with a 2-ppm step. + * + * @note This Calibration value should be between 0 and 126 when using positive + * sign with a 4-ppm step. + * + * @retval An ErrorStatus enumeration value: + * - SUCCESS: RTC Coarse calibration are initialized + * - ERROR: RTC Coarse calibration are not initialized + */ +ErrorStatus RTC_CoarseCalibConfig(uint32_t RTC_CalibSign, uint32_t Value) +{ + ErrorStatus status = ERROR; + + /* Check the parameters */ + assert_param(IS_RTC_CALIB_SIGN(RTC_CalibSign)); + assert_param(IS_RTC_CALIB_VALUE(Value)); + + /* Disable the write protection for RTC registers */ + RTC->WPR = 0xCA; + RTC->WPR = 0x53; + + /* Set Initialization mode */ + if (RTC_EnterInitMode() == ERROR) + { + status = ERROR; + } + else + { + /* Set the coarse calibration value */ + RTC->CALIBR = (uint32_t)(RTC_CalibSign | Value); + /* Exit Initialization mode */ + RTC_ExitInitMode(); + + status = SUCCESS; + } + + /* Enable the write protection for RTC registers */ + RTC->WPR = 0xFF; + + return status; +} + +/** + * @brief Enables or disables the Coarse calibration process. + * @param NewState: new state of the Coarse calibration. + * This parameter can be: ENABLE or DISABLE. + * @retval An ErrorStatus enumeration value: + * - SUCCESS: RTC Coarse calibration are enabled/disabled + * - ERROR: RTC Coarse calibration are not enabled/disabled + */ +ErrorStatus RTC_CoarseCalibCmd(FunctionalState NewState) +{ + ErrorStatus status = ERROR; + + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + /* Disable the write protection for RTC registers */ + RTC->WPR = 0xCA; + RTC->WPR = 0x53; + + /* Set Initialization mode */ + if (RTC_EnterInitMode() == ERROR) + { + status = ERROR; + } + else + { + if (NewState != DISABLE) + { + /* Enable the Coarse Calibration */ + RTC->CR |= (uint32_t)RTC_CR_DCE; + } + else + { + /* Disable the Coarse Calibration */ + RTC->CR &= (uint32_t)~RTC_CR_DCE; + } + /* Exit Initialization mode */ + RTC_ExitInitMode(); + + status = SUCCESS; + } + + /* Enable the write protection for RTC registers */ + RTC->WPR = 0xFF; + + return status; +} + +/** + * @brief Enables or disables the RTC clock to be output through the relative pin. + * @param NewState: new state of the digital calibration Output. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void RTC_CalibOutputCmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + /* Disable the write protection for RTC registers */ + RTC->WPR = 0xCA; + RTC->WPR = 0x53; + + if (NewState != DISABLE) + { + /* Enable the RTC clock output */ + RTC->CR |= (uint32_t)RTC_CR_COE; + } + else + { + /* Disable the RTC clock output */ + RTC->CR &= (uint32_t)~RTC_CR_COE; + } + + /* Enable the write protection for RTC registers */ + RTC->WPR = 0xFF; +} + +/** + * @brief Configure the Calibration Pinout (RTC_CALIB) Selection (1Hz or 512Hz). + * @param RTC_CalibOutput : Select the Calibration output Selection . + * This parameter can be one of the following values: + * @arg RTC_CalibOutput_512Hz: A signal has a regular waveform at 512Hz. + * @arg RTC_CalibOutput_1Hz : A signal has a regular waveform at 1Hz. + * @retval None +*/ +void RTC_CalibOutputConfig(uint32_t RTC_CalibOutput) +{ + /* Check the parameters */ + assert_param(IS_RTC_CALIB_OUTPUT(RTC_CalibOutput)); + + /* Disable the write protection for RTC registers */ + RTC->WPR = 0xCA; + RTC->WPR = 0x53; + + /*clear flags before configuration */ + RTC->CR &= (uint32_t)~(RTC_CR_COSEL); + + /* Configure the RTC_CR register */ + RTC->CR |= (uint32_t)RTC_CalibOutput; + + /* Enable the write protection for RTC registers */ + RTC->WPR = 0xFF; +} + +/** + * @brief Configures the Smooth Calibration Settings. + * @param RTC_SmoothCalibPeriod : Select the Smooth Calibration Period. + * This parameter can be can be one of the following values: + * @arg RTC_SmoothCalibPeriod_32sec : The smooth calibration period is 32s. + * @arg RTC_SmoothCalibPeriod_16sec : The smooth calibration period is 16s. + * @arg RTC_SmoothCalibPeriod_8sec : The smooth calibartion period is 8s. + * @param RTC_SmoothCalibPlusPulses : Select to Set or reset the CALP bit. + * This parameter can be one of the following values: + * @arg RTC_SmoothCalibPlusPulses_Set : Add one RTCCLK puls every 2**11 pulses. + * @arg RTC_SmoothCalibPlusPulses_Reset: No RTCCLK pulses are added. + * @param RTC_SmouthCalibMinusPulsesValue: Select the value of CALM[8:0] bits. + * This parameter can be one any value from 0 to 0x000001FF. + * @retval An ErrorStatus enumeration value: + * - SUCCESS: RTC Calib registers are configured + * - ERROR: RTC Calib registers are not configured +*/ +ErrorStatus RTC_SmoothCalibConfig(uint32_t RTC_SmoothCalibPeriod, + uint32_t RTC_SmoothCalibPlusPulses, + uint32_t RTC_SmouthCalibMinusPulsesValue) +{ + ErrorStatus status = ERROR; + uint32_t recalpfcount = 0; + + /* Check the parameters */ + assert_param(IS_RTC_SMOOTH_CALIB_PERIOD(RTC_SmoothCalibPeriod)); + assert_param(IS_RTC_SMOOTH_CALIB_PLUS(RTC_SmoothCalibPlusPulses)); + assert_param(IS_RTC_SMOOTH_CALIB_MINUS(RTC_SmouthCalibMinusPulsesValue)); + + /* Disable the write protection for RTC registers */ + RTC->WPR = 0xCA; + RTC->WPR = 0x53; + + /* check if a calibration is pending*/ + if ((RTC->ISR & RTC_ISR_RECALPF) != RESET) + { + /* wait until the Calibration is completed*/ + while (((RTC->ISR & RTC_ISR_RECALPF) != RESET) && (recalpfcount != RECALPF_TIMEOUT)) + { + recalpfcount++; + } + } + + /* check if the calibration pending is completed or if there is no calibration operation at all*/ + if ((RTC->ISR & RTC_ISR_RECALPF) == RESET) + { + /* Configure the Smooth calibration settings */ + RTC->CALR = (uint32_t)((uint32_t)RTC_SmoothCalibPeriod | (uint32_t)RTC_SmoothCalibPlusPulses | (uint32_t)RTC_SmouthCalibMinusPulsesValue); + + status = SUCCESS; + } + else + { + status = ERROR; + } + + /* Enable the write protection for RTC registers */ + RTC->WPR = 0xFF; + + return (ErrorStatus)(status); +} + +/** + * @} + */ + + +/** @defgroup RTC_Group8 TimeStamp configuration functions + * @brief TimeStamp configuration functions + * +@verbatim + =============================================================================== + ##### TimeStamp configuration functions ##### + =============================================================================== + +@endverbatim + * @{ + */ + +/** + * @brief Enables or Disables the RTC TimeStamp functionality with the + * specified time stamp pin stimulating edge. + * @param RTC_TimeStampEdge: Specifies the pin edge on which the TimeStamp is + * activated. + * This parameter can be one of the following: + * @arg RTC_TimeStampEdge_Rising: the Time stamp event occurs on the rising + * edge of the related pin. + * @arg RTC_TimeStampEdge_Falling: the Time stamp event occurs on the + * falling edge of the related pin. + * @param NewState: new state of the TimeStamp. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void RTC_TimeStampCmd(uint32_t RTC_TimeStampEdge, FunctionalState NewState) +{ + uint32_t tmpreg = 0; + + /* Check the parameters */ + assert_param(IS_RTC_TIMESTAMP_EDGE(RTC_TimeStampEdge)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + /* Get the RTC_CR register and clear the bits to be configured */ + tmpreg = (uint32_t)(RTC->CR & (uint32_t)~(RTC_CR_TSEDGE | RTC_CR_TSE)); + + /* Get the new configuration */ + if (NewState != DISABLE) + { + tmpreg |= (uint32_t)(RTC_TimeStampEdge | RTC_CR_TSE); + } + else + { + tmpreg |= (uint32_t)(RTC_TimeStampEdge); + } + + /* Disable the write protection for RTC registers */ + RTC->WPR = 0xCA; + RTC->WPR = 0x53; + + /* Configure the Time Stamp TSEDGE and Enable bits */ + RTC->CR = (uint32_t)tmpreg; + + /* Enable the write protection for RTC registers */ + RTC->WPR = 0xFF; +} + +/** + * @brief Get the RTC TimeStamp value and masks. + * @param RTC_Format: specifies the format of the output parameters. + * This parameter can be one of the following values: + * @arg RTC_Format_BIN: Binary data format + * @arg RTC_Format_BCD: BCD data format + * @param RTC_StampTimeStruct: pointer to a RTC_TimeTypeDef structure that will + * contains the TimeStamp time values. + * @param RTC_StampDateStruct: pointer to a RTC_DateTypeDef structure that will + * contains the TimeStamp date values. + * @retval None + */ +void RTC_GetTimeStamp(uint32_t RTC_Format, RTC_TimeTypeDef* RTC_StampTimeStruct, + RTC_DateTypeDef* RTC_StampDateStruct) +{ + uint32_t tmptime = 0, tmpdate = 0; + + /* Check the parameters */ + assert_param(IS_RTC_FORMAT(RTC_Format)); + + /* Get the TimeStamp time and date registers values */ + tmptime = (uint32_t)(RTC->TSTR & RTC_TR_RESERVED_MASK); + tmpdate = (uint32_t)(RTC->TSDR & RTC_DR_RESERVED_MASK); + + /* Fill the Time structure fields with the read parameters */ + RTC_StampTimeStruct->RTC_Hours = (uint8_t)((tmptime & (RTC_TR_HT | RTC_TR_HU)) >> 16); + RTC_StampTimeStruct->RTC_Minutes = (uint8_t)((tmptime & (RTC_TR_MNT | RTC_TR_MNU)) >> 8); + RTC_StampTimeStruct->RTC_Seconds = (uint8_t)(tmptime & (RTC_TR_ST | RTC_TR_SU)); + RTC_StampTimeStruct->RTC_H12 = (uint8_t)((tmptime & (RTC_TR_PM)) >> 16); + + /* Fill the Date structure fields with the read parameters */ + RTC_StampDateStruct->RTC_Year = 0; + RTC_StampDateStruct->RTC_Month = (uint8_t)((tmpdate & (RTC_DR_MT | RTC_DR_MU)) >> 8); + RTC_StampDateStruct->RTC_Date = (uint8_t)(tmpdate & (RTC_DR_DT | RTC_DR_DU)); + RTC_StampDateStruct->RTC_WeekDay = (uint8_t)((tmpdate & (RTC_DR_WDU)) >> 13); + + /* Check the input parameters format */ + if (RTC_Format == RTC_Format_BIN) + { + /* Convert the Time structure parameters to Binary format */ + RTC_StampTimeStruct->RTC_Hours = (uint8_t)RTC_Bcd2ToByte(RTC_StampTimeStruct->RTC_Hours); + RTC_StampTimeStruct->RTC_Minutes = (uint8_t)RTC_Bcd2ToByte(RTC_StampTimeStruct->RTC_Minutes); + RTC_StampTimeStruct->RTC_Seconds = (uint8_t)RTC_Bcd2ToByte(RTC_StampTimeStruct->RTC_Seconds); + + /* Convert the Date structure parameters to Binary format */ + RTC_StampDateStruct->RTC_Month = (uint8_t)RTC_Bcd2ToByte(RTC_StampDateStruct->RTC_Month); + RTC_StampDateStruct->RTC_Date = (uint8_t)RTC_Bcd2ToByte(RTC_StampDateStruct->RTC_Date); + RTC_StampDateStruct->RTC_WeekDay = (uint8_t)RTC_Bcd2ToByte(RTC_StampDateStruct->RTC_WeekDay); + } +} + +/** + * @brief Get the RTC timestamp Sub seconds value. + * @param None + * @retval RTC current timestamp Sub seconds value. + */ +uint32_t RTC_GetTimeStampSubSecond(void) +{ + /* Get timestamp sub seconds values from the correspondent registers */ + return (uint32_t)(RTC->TSSSR); +} + +/** + * @} + */ + +/** @defgroup RTC_Group9 Tampers configuration functions + * @brief Tampers configuration functions + * +@verbatim + =============================================================================== + ##### Tampers configuration functions ##### + =============================================================================== + +@endverbatim + * @{ + */ + +/** + * @brief Configures the select Tamper pin edge. + * @param RTC_Tamper: Selected tamper pin. + * This parameter can be RTC_Tamper_1. + * @param RTC_TamperTrigger: Specifies the trigger on the tamper pin that + * stimulates tamper event. + * This parameter can be one of the following values: + * @arg RTC_TamperTrigger_RisingEdge: Rising Edge of the tamper pin causes tamper event. + * @arg RTC_TamperTrigger_FallingEdge: Falling Edge of the tamper pin causes tamper event. + * @arg RTC_TamperTrigger_LowLevel: Low Level of the tamper pin causes tamper event. + * @arg RTC_TamperTrigger_HighLevel: High Level of the tamper pin causes tamper event. + * @retval None + */ +void RTC_TamperTriggerConfig(uint32_t RTC_Tamper, uint32_t RTC_TamperTrigger) +{ + /* Check the parameters */ + assert_param(IS_RTC_TAMPER(RTC_Tamper)); + assert_param(IS_RTC_TAMPER_TRIGGER(RTC_TamperTrigger)); + + if (RTC_TamperTrigger == RTC_TamperTrigger_RisingEdge) + { + /* Configure the RTC_TAFCR register */ + RTC->TAFCR &= (uint32_t)((uint32_t)~(RTC_Tamper << 1)); + } + else + { + /* Configure the RTC_TAFCR register */ + RTC->TAFCR |= (uint32_t)(RTC_Tamper << 1); + } +} + +/** + * @brief Enables or Disables the Tamper detection. + * @param RTC_Tamper: Selected tamper pin. + * This parameter can be RTC_Tamper_1. + * @param NewState: new state of the tamper pin. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void RTC_TamperCmd(uint32_t RTC_Tamper, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_RTC_TAMPER(RTC_Tamper)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the selected Tamper pin */ + RTC->TAFCR |= (uint32_t)RTC_Tamper; + } + else + { + /* Disable the selected Tamper pin */ + RTC->TAFCR &= (uint32_t)~RTC_Tamper; + } +} + +/** + * @brief Configures the Tampers Filter. + * @param RTC_TamperFilter: Specifies the tampers filter. + * This parameter can be one of the following values: + * @arg RTC_TamperFilter_Disable: Tamper filter is disabled. + * @arg RTC_TamperFilter_2Sample: Tamper is activated after 2 consecutive + * samples at the active level + * @arg RTC_TamperFilter_4Sample: Tamper is activated after 4 consecutive + * samples at the active level + * @arg RTC_TamperFilter_8Sample: Tamper is activated after 8 consecutive + * samples at the active level + * @retval None + */ +void RTC_TamperFilterConfig(uint32_t RTC_TamperFilter) +{ + /* Check the parameters */ + assert_param(IS_RTC_TAMPER_FILTER(RTC_TamperFilter)); + + /* Clear TAMPFLT[1:0] bits in the RTC_TAFCR register */ + RTC->TAFCR &= (uint32_t)~(RTC_TAFCR_TAMPFLT); + + /* Configure the RTC_TAFCR register */ + RTC->TAFCR |= (uint32_t)RTC_TamperFilter; +} + +/** + * @brief Configures the Tampers Sampling Frequency. + * @param RTC_TamperSamplingFreq: Specifies the tampers Sampling Frequency. + * This parameter can be one of the following values: + * @arg RTC_TamperSamplingFreq_RTCCLK_Div32768: Each of the tamper inputs are sampled + * with a frequency = RTCCLK / 32768 + * @arg RTC_TamperSamplingFreq_RTCCLK_Div16384: Each of the tamper inputs are sampled + * with a frequency = RTCCLK / 16384 + * @arg RTC_TamperSamplingFreq_RTCCLK_Div8192: Each of the tamper inputs are sampled + * with a frequency = RTCCLK / 8192 + * @arg RTC_TamperSamplingFreq_RTCCLK_Div4096: Each of the tamper inputs are sampled + * with a frequency = RTCCLK / 4096 + * @arg RTC_TamperSamplingFreq_RTCCLK_Div2048: Each of the tamper inputs are sampled + * with a frequency = RTCCLK / 2048 + * @arg RTC_TamperSamplingFreq_RTCCLK_Div1024: Each of the tamper inputs are sampled + * with a frequency = RTCCLK / 1024 + * @arg RTC_TamperSamplingFreq_RTCCLK_Div512: Each of the tamper inputs are sampled + * with a frequency = RTCCLK / 512 + * @arg RTC_TamperSamplingFreq_RTCCLK_Div256: Each of the tamper inputs are sampled + * with a frequency = RTCCLK / 256 + * @retval None + */ +void RTC_TamperSamplingFreqConfig(uint32_t RTC_TamperSamplingFreq) +{ + /* Check the parameters */ + assert_param(IS_RTC_TAMPER_SAMPLING_FREQ(RTC_TamperSamplingFreq)); + + /* Clear TAMPFREQ[2:0] bits in the RTC_TAFCR register */ + RTC->TAFCR &= (uint32_t)~(RTC_TAFCR_TAMPFREQ); + + /* Configure the RTC_TAFCR register */ + RTC->TAFCR |= (uint32_t)RTC_TamperSamplingFreq; +} + +/** + * @brief Configures the Tampers Pins input Precharge Duration. + * @param RTC_TamperPrechargeDuration: Specifies the Tampers Pins input + * Precharge Duration. + * This parameter can be one of the following values: + * @arg RTC_TamperPrechargeDuration_1RTCCLK: Tamper pins are precharged before sampling during 1 RTCCLK cycle + * @arg RTC_TamperPrechargeDuration_2RTCCLK: Tamper pins are precharged before sampling during 2 RTCCLK cycle + * @arg RTC_TamperPrechargeDuration_4RTCCLK: Tamper pins are precharged before sampling during 4 RTCCLK cycle + * @arg RTC_TamperPrechargeDuration_8RTCCLK: Tamper pins are precharged before sampling during 8 RTCCLK cycle + * @retval None + */ +void RTC_TamperPinsPrechargeDuration(uint32_t RTC_TamperPrechargeDuration) +{ + /* Check the parameters */ + assert_param(IS_RTC_TAMPER_PRECHARGE_DURATION(RTC_TamperPrechargeDuration)); + + /* Clear TAMPPRCH[1:0] bits in the RTC_TAFCR register */ + RTC->TAFCR &= (uint32_t)~(RTC_TAFCR_TAMPPRCH); + + /* Configure the RTC_TAFCR register */ + RTC->TAFCR |= (uint32_t)RTC_TamperPrechargeDuration; +} + +/** + * @brief Enables or Disables the TimeStamp on Tamper Detection Event. + * @note The timestamp is valid even the TSE bit in tamper control register + * is reset. + * @param NewState: new state of the timestamp on tamper event. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void RTC_TimeStampOnTamperDetectionCmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Save timestamp on tamper detection event */ + RTC->TAFCR |= (uint32_t)RTC_TAFCR_TAMPTS; + } + else + { + /* Tamper detection does not cause a timestamp to be saved */ + RTC->TAFCR &= (uint32_t)~RTC_TAFCR_TAMPTS; + } +} + +/** + * @brief Enables or Disables the Precharge of Tamper pin. + * @param NewState: new state of tamper pull up. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void RTC_TamperPullUpCmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable precharge of the selected Tamper pin */ + RTC->TAFCR &= (uint32_t)~RTC_TAFCR_TAMPPUDIS; + } + else + { + /* Disable precharge of the selected Tamper pin */ + RTC->TAFCR |= (uint32_t)RTC_TAFCR_TAMPPUDIS; + } +} + +/** + * @} + */ + +/** @defgroup RTC_Group10 Backup Data Registers configuration functions + * @brief Backup Data Registers configuration functions + * +@verbatim + =============================================================================== + ##### Backup Data Registers configuration functions ##### + =============================================================================== + +@endverbatim + * @{ + */ + +/** + * @brief Writes a data in a specified RTC Backup data register. + * @param RTC_BKP_DR: RTC Backup data Register number. + * This parameter can be: RTC_BKP_DRx where x can be from 0 to 19 to + * specify the register. + * @param Data: Data to be written in the specified RTC Backup data register. + * @retval None + */ +void RTC_WriteBackupRegister(uint32_t RTC_BKP_DR, uint32_t Data) +{ + __IO uint32_t tmp = 0; + + /* Check the parameters */ + assert_param(IS_RTC_BKP(RTC_BKP_DR)); + + tmp = RTC_BASE + 0x50; + tmp += (RTC_BKP_DR * 4); + + /* Write the specified register */ + *(__IO uint32_t *)tmp = (uint32_t)Data; +} + +/** + * @brief Reads data from the specified RTC Backup data Register. + * @param RTC_BKP_DR: RTC Backup data Register number. + * This parameter can be: RTC_BKP_DRx where x can be from 0 to 19 to + * specify the register. + * @retval None + */ +uint32_t RTC_ReadBackupRegister(uint32_t RTC_BKP_DR) +{ + __IO uint32_t tmp = 0; + + /* Check the parameters */ + assert_param(IS_RTC_BKP(RTC_BKP_DR)); + + tmp = RTC_BASE + 0x50; + tmp += (RTC_BKP_DR * 4); + + /* Read the specified register */ + return (*(__IO uint32_t *)tmp); +} + +/** + * @} + */ + +/** @defgroup RTC_Group11 RTC Tamper and TimeStamp Pins Selection and Output Type Config configuration functions + * @brief RTC Tamper and TimeStamp Pins Selection and Output Type Config + * configuration functions + * +@verbatim + ================================================================================================== + ##### RTC Tamper and TimeStamp Pins Selection and Output Type Config configuration functions ##### + ================================================================================================== + +@endverbatim + * @{ + */ + +/** + * @brief Selects the RTC Tamper Pin. + * @param RTC_TamperPin: specifies the RTC Tamper Pin. + * This parameter can be one of the following values: + * @arg RTC_TamperPin_PC13: PC13 is selected as RTC Tamper Pin. + * @arg RTC_TamperPin_PI8: PI8 is selected as RTC Tamper Pin. + * @retval None + */ +void RTC_TamperPinSelection(uint32_t RTC_TamperPin) +{ + /* Check the parameters */ + assert_param(IS_RTC_TAMPER_PIN(RTC_TamperPin)); + + RTC->TAFCR &= (uint32_t)~(RTC_TAFCR_TAMPINSEL); + RTC->TAFCR |= (uint32_t)(RTC_TamperPin); +} + +/** + * @brief Selects the RTC TimeStamp Pin. + * @param RTC_TimeStampPin: specifies the RTC TimeStamp Pin. + * This parameter can be one of the following values: + * @arg RTC_TimeStampPin_PC13: PC13 is selected as RTC TimeStamp Pin. + * @arg RTC_TimeStampPin_PI8: PI8 is selected as RTC TimeStamp Pin. + * @retval None + */ +void RTC_TimeStampPinSelection(uint32_t RTC_TimeStampPin) +{ + /* Check the parameters */ + assert_param(IS_RTC_TIMESTAMP_PIN(RTC_TimeStampPin)); + + RTC->TAFCR &= (uint32_t)~(RTC_TAFCR_TSINSEL); + RTC->TAFCR |= (uint32_t)(RTC_TimeStampPin); +} + +/** + * @brief Configures the RTC Output Pin mode. + * @param RTC_OutputType: specifies the RTC Output (PC13) pin mode. + * This parameter can be one of the following values: + * @arg RTC_OutputType_OpenDrain: RTC Output (PC13) is configured in + * Open Drain mode. + * @arg RTC_OutputType_PushPull: RTC Output (PC13) is configured in + * Push Pull mode. + * @retval None + */ +void RTC_OutputTypeConfig(uint32_t RTC_OutputType) +{ + /* Check the parameters */ + assert_param(IS_RTC_OUTPUT_TYPE(RTC_OutputType)); + + RTC->TAFCR &= (uint32_t)~(RTC_TAFCR_ALARMOUTTYPE); + RTC->TAFCR |= (uint32_t)(RTC_OutputType); +} + +/** + * @} + */ + +/** @defgroup RTC_Group12 Shift control synchronisation functions + * @brief Shift control synchronisation functions + * +@verbatim + =============================================================================== + ##### Shift control synchronisation functions ##### + =============================================================================== + +@endverbatim + * @{ + */ + +/** + * @brief Configures the Synchronization Shift Control Settings. + * @note When REFCKON is set, firmware must not write to Shift control register + * @param RTC_ShiftAdd1S : Select to add or not 1 second to the time Calendar. + * This parameter can be one of the following values : + * @arg RTC_ShiftAdd1S_Set : Add one second to the clock calendar. + * @arg RTC_ShiftAdd1S_Reset: No effect. + * @param RTC_ShiftSubFS: Select the number of Second Fractions to Substitute. + * This parameter can be one any value from 0 to 0x7FFF. + * @retval An ErrorStatus enumeration value: + * - SUCCESS: RTC Shift registers are configured + * - ERROR: RTC Shift registers are not configured +*/ +ErrorStatus RTC_SynchroShiftConfig(uint32_t RTC_ShiftAdd1S, uint32_t RTC_ShiftSubFS) +{ + ErrorStatus status = ERROR; + uint32_t shpfcount = 0; + + /* Check the parameters */ + assert_param(IS_RTC_SHIFT_ADD1S(RTC_ShiftAdd1S)); + assert_param(IS_RTC_SHIFT_SUBFS(RTC_ShiftSubFS)); + + /* Disable the write protection for RTC registers */ + RTC->WPR = 0xCA; + RTC->WPR = 0x53; + + /* Check if a Shift is pending*/ + if ((RTC->ISR & RTC_ISR_SHPF) != RESET) + { + /* Wait until the shift is completed*/ + while (((RTC->ISR & RTC_ISR_SHPF) != RESET) && (shpfcount != SHPF_TIMEOUT)) + { + shpfcount++; + } + } + + /* Check if the Shift pending is completed or if there is no Shift operation at all*/ + if ((RTC->ISR & RTC_ISR_SHPF) == RESET) + { + /* check if the reference clock detection is disabled */ + if((RTC->CR & RTC_CR_REFCKON) == RESET) + { + /* Configure the Shift settings */ + RTC->SHIFTR = (uint32_t)(uint32_t)(RTC_ShiftSubFS) | (uint32_t)(RTC_ShiftAdd1S); + + if(RTC_WaitForSynchro() == ERROR) + { + status = ERROR; + } + else + { + status = SUCCESS; + } + } + else + { + status = ERROR; + } + } + else + { + status = ERROR; + } + + /* Enable the write protection for RTC registers */ + RTC->WPR = 0xFF; + + return (ErrorStatus)(status); +} + +/** + * @} + */ + +/** @defgroup RTC_Group13 Interrupts and flags management functions + * @brief Interrupts and flags management functions + * +@verbatim + =============================================================================== + ##### Interrupts and flags management functions ##### + =============================================================================== + [..] All RTC interrupts are connected to the EXTI controller. + + (+) To enable the RTC Alarm interrupt, the following sequence is required: + (++) Configure and enable the EXTI Line 17 in interrupt mode and select + the rising edge sensitivity using the EXTI_Init() function. + (++) Configure and enable the RTC_Alarm IRQ channel in the NVIC using the + NVIC_Init() function. + (++) Configure the RTC to generate RTC alarms (Alarm A and/or Alarm B) using + the RTC_SetAlarm() and RTC_AlarmCmd() functions. + + (+) To enable the RTC Wakeup interrupt, the following sequence is required: + (++) Configure and enable the EXTI Line 22 in interrupt mode and select the + rising edge sensitivity using the EXTI_Init() function. + (++) Configure and enable the RTC_WKUP IRQ channel in the NVIC using the + NVIC_Init() function. + (++) Configure the RTC to generate the RTC wakeup timer event using the + RTC_WakeUpClockConfig(), RTC_SetWakeUpCounter() and RTC_WakeUpCmd() + functions. + + (+) To enable the RTC Tamper interrupt, the following sequence is required: + (++) Configure and enable the EXTI Line 21 in interrupt mode and select + the rising edge sensitivity using the EXTI_Init() function. + (++) Configure and enable the TAMP_STAMP IRQ channel in the NVIC using the + NVIC_Init() function. + (++) Configure the RTC to detect the RTC tamper event using the + RTC_TamperTriggerConfig() and RTC_TamperCmd() functions. + + (+) To enable the RTC TimeStamp interrupt, the following sequence is required: + (++) Configure and enable the EXTI Line 21 in interrupt mode and select the + rising edge sensitivity using the EXTI_Init() function. + (++) Configure and enable the TAMP_STAMP IRQ channel in the NVIC using the + NVIC_Init() function. + (++) Configure the RTC to detect the RTC time stamp event using the + RTC_TimeStampCmd() functions. + +@endverbatim + * @{ + */ + +/** + * @brief Enables or disables the specified RTC interrupts. + * @param RTC_IT: specifies the RTC interrupt sources to be enabled or disabled. + * This parameter can be any combination of the following values: + * @arg RTC_IT_TS: Time Stamp interrupt mask + * @arg RTC_IT_WUT: WakeUp Timer interrupt mask + * @arg RTC_IT_ALRB: Alarm B interrupt mask + * @arg RTC_IT_ALRA: Alarm A interrupt mask + * @arg RTC_IT_TAMP: Tamper event interrupt mask + * @param NewState: new state of the specified RTC interrupts. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void RTC_ITConfig(uint32_t RTC_IT, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_RTC_CONFIG_IT(RTC_IT)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + /* Disable the write protection for RTC registers */ + RTC->WPR = 0xCA; + RTC->WPR = 0x53; + + if (NewState != DISABLE) + { + /* Configure the Interrupts in the RTC_CR register */ + RTC->CR |= (uint32_t)(RTC_IT & ~RTC_TAFCR_TAMPIE); + /* Configure the Tamper Interrupt in the RTC_TAFCR */ + RTC->TAFCR |= (uint32_t)(RTC_IT & RTC_TAFCR_TAMPIE); + } + else + { + /* Configure the Interrupts in the RTC_CR register */ + RTC->CR &= (uint32_t)~(RTC_IT & (uint32_t)~RTC_TAFCR_TAMPIE); + /* Configure the Tamper Interrupt in the RTC_TAFCR */ + RTC->TAFCR &= (uint32_t)~(RTC_IT & RTC_TAFCR_TAMPIE); + } + /* Enable the write protection for RTC registers */ + RTC->WPR = 0xFF; +} + +/** + * @brief Checks whether the specified RTC flag is set or not. + * @param RTC_FLAG: specifies the flag to check. + * This parameter can be one of the following values: + * @arg RTC_FLAG_RECALPF: RECALPF event flag. + * @arg RTC_FLAG_TAMP1F: Tamper 1 event flag + * @arg RTC_FLAG_TSOVF: Time Stamp OverFlow flag + * @arg RTC_FLAG_TSF: Time Stamp event flag + * @arg RTC_FLAG_WUTF: WakeUp Timer flag + * @arg RTC_FLAG_ALRBF: Alarm B flag + * @arg RTC_FLAG_ALRAF: Alarm A flag + * @arg RTC_FLAG_INITF: Initialization mode flag + * @arg RTC_FLAG_RSF: Registers Synchronized flag + * @arg RTC_FLAG_INITS: Registers Configured flag + * @arg RTC_FLAG_SHPF: Shift operation pending flag. + * @arg RTC_FLAG_WUTWF: WakeUp Timer Write flag + * @arg RTC_FLAG_ALRBWF: Alarm B Write flag + * @arg RTC_FLAG_ALRAWF: Alarm A write flag + * @retval The new state of RTC_FLAG (SET or RESET). + */ +FlagStatus RTC_GetFlagStatus(uint32_t RTC_FLAG) +{ + FlagStatus bitstatus = RESET; + uint32_t tmpreg = 0; + + /* Check the parameters */ + assert_param(IS_RTC_GET_FLAG(RTC_FLAG)); + + /* Get all the flags */ + tmpreg = (uint32_t)(RTC->ISR & RTC_FLAGS_MASK); + + /* Return the status of the flag */ + if ((tmpreg & RTC_FLAG) != (uint32_t)RESET) + { + bitstatus = SET; + } + else + { + bitstatus = RESET; + } + return bitstatus; +} + +/** + * @brief Clears the RTC's pending flags. + * @param RTC_FLAG: specifies the RTC flag to clear. + * This parameter can be any combination of the following values: + * @arg RTC_FLAG_TAMP1F: Tamper 1 event flag + * @arg RTC_FLAG_TSOVF: Time Stamp Overflow flag + * @arg RTC_FLAG_TSF: Time Stamp event flag + * @arg RTC_FLAG_WUTF: WakeUp Timer flag + * @arg RTC_FLAG_ALRBF: Alarm B flag + * @arg RTC_FLAG_ALRAF: Alarm A flag + * @arg RTC_FLAG_RSF: Registers Synchronized flag + * @retval None + */ +void RTC_ClearFlag(uint32_t RTC_FLAG) +{ + /* Check the parameters */ + assert_param(IS_RTC_CLEAR_FLAG(RTC_FLAG)); + + /* Clear the Flags in the RTC_ISR register */ + RTC->ISR = (uint32_t)((uint32_t)(~((RTC_FLAG | RTC_ISR_INIT)& 0x0000FFFF) | (uint32_t)(RTC->ISR & RTC_ISR_INIT))); +} + +/** + * @brief Checks whether the specified RTC interrupt has occurred or not. + * @param RTC_IT: specifies the RTC interrupt source to check. + * This parameter can be one of the following values: + * @arg RTC_IT_TS: Time Stamp interrupt + * @arg RTC_IT_WUT: WakeUp Timer interrupt + * @arg RTC_IT_ALRB: Alarm B interrupt + * @arg RTC_IT_ALRA: Alarm A interrupt + * @arg RTC_IT_TAMP1: Tamper 1 event interrupt + * @retval The new state of RTC_IT (SET or RESET). + */ +ITStatus RTC_GetITStatus(uint32_t RTC_IT) +{ + ITStatus bitstatus = RESET; + uint32_t tmpreg = 0, enablestatus = 0; + + /* Check the parameters */ + assert_param(IS_RTC_GET_IT(RTC_IT)); + + /* Get the TAMPER Interrupt enable bit and pending bit */ + tmpreg = (uint32_t)(RTC->TAFCR & (RTC_TAFCR_TAMPIE)); + + /* Get the Interrupt enable Status */ + enablestatus = (uint32_t)((RTC->CR & RTC_IT) | (tmpreg & (RTC_IT >> 15))); + + /* Get the Interrupt pending bit */ + tmpreg = (uint32_t)((RTC->ISR & (uint32_t)(RTC_IT >> 4))); + + /* Get the status of the Interrupt */ + if ((enablestatus != (uint32_t)RESET) && ((tmpreg & 0x0000FFFF) != (uint32_t)RESET)) + { + bitstatus = SET; + } + else + { + bitstatus = RESET; + } + return bitstatus; +} + +/** + * @brief Clears the RTC's interrupt pending bits. + * @param RTC_IT: specifies the RTC interrupt pending bit to clear. + * This parameter can be any combination of the following values: + * @arg RTC_IT_TS: Time Stamp interrupt + * @arg RTC_IT_WUT: WakeUp Timer interrupt + * @arg RTC_IT_ALRB: Alarm B interrupt + * @arg RTC_IT_ALRA: Alarm A interrupt + * @arg RTC_IT_TAMP1: Tamper 1 event interrupt + * @retval None + */ +void RTC_ClearITPendingBit(uint32_t RTC_IT) +{ + uint32_t tmpreg = 0; + + /* Check the parameters */ + assert_param(IS_RTC_CLEAR_IT(RTC_IT)); + + /* Get the RTC_ISR Interrupt pending bits mask */ + tmpreg = (uint32_t)(RTC_IT >> 4); + + /* Clear the interrupt pending bits in the RTC_ISR register */ + RTC->ISR = (uint32_t)((uint32_t)(~((tmpreg | RTC_ISR_INIT)& 0x0000FFFF) | (uint32_t)(RTC->ISR & RTC_ISR_INIT))); +} + +/** + * @} + */ + +/** + * @brief Converts a 2 digit decimal to BCD format. + * @param Value: Byte to be converted. + * @retval Converted byte + */ +static uint8_t RTC_ByteToBcd2(uint8_t Value) +{ + uint8_t bcdhigh = 0; + + while (Value >= 10) + { + bcdhigh++; + Value -= 10; + } + + return ((uint8_t)(bcdhigh << 4) | Value); +} + +/** + * @brief Convert from 2 digit BCD to Binary. + * @param Value: BCD value to be converted. + * @retval Converted word + */ +static uint8_t RTC_Bcd2ToByte(uint8_t Value) +{ + uint8_t tmp = 0; + tmp = ((uint8_t)(Value & (uint8_t)0xF0) >> (uint8_t)0x4) * 10; + return (tmp + (Value & (uint8_t)0x0F)); +} + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/src/stm32f4xx_sai.c b/FWLIB/src/stm32f4xx_sai.c new file mode 100644 index 0000000..d05b519 --- /dev/null +++ b/FWLIB/src/stm32f4xx_sai.c @@ -0,0 +1,1079 @@ +/** + ****************************************************************************** + * @file stm32f4xx_sai.c + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file provides firmware functions to manage the following + * functionalities of the Serial Audio Interface (SAI): + * + Initialization and Configuration + * + Data transfers functions + * + DMA transfers management + * + Interrupts and flags management + * + @verbatim + =============================================================================== + ##### How to use this driver ##### + =============================================================================== + [..] + + (#) Enable peripheral clock using the following functions + RCC_APB2PeriphClockCmd(RCC_APB2Periph_SAI1, ENABLE) for SAI1 + + (#) For each SAI Block A/B enable SCK, SD, FS and MCLK GPIO clocks + using RCC_AHB1PeriphClockCmd() function. + + (#) Peripherals alternate function: + (++) Connect the pin to the desired peripherals' Alternate + Function (AF) using GPIO_PinAFConfig() function. + (++) Configure the desired pin in alternate function by: + GPIO_InitStruct->GPIO_Mode = GPIO_Mode_AF + (++) Select the type, pull-up/pull-down and output speed via + GPIO_PuPd, GPIO_OType and GPIO_Speed members + (++) Call GPIO_Init() function + -@@- If an external clock source is used then the I2S CKIN pin should be + also configured in Alternate function Push-pull pull-up mode. + + (#) The SAI clock can be generated from different clock source : + PLL I2S, PLL SAI or external clock source. + (++) The PLL I2S is configured using the following functions RCC_PLLI2SConfig(), + RCC_PLLI2SCmd(ENABLE), RCC_GetFlagStatus(RCC_FLAG_PLLI2SRDY) and + RCC_SAIPLLI2SClkDivConfig() or; + + (++) The PLL SAI is configured using the following functions RCC_PLLSAIConfig(), + RCC_PLLSAICmd(ENABLE), RCC_GetFlagStatus(RCC_FLAG_PLLSAIRDY) and + RCC_SAIPLLSAIClkDivConfig()or; + + (++) External clock source is configured using the function + RCC_I2SCLKConfig(RCC_I2S2CLKSource_Ext) and after setting correctly the + define constant I2S_EXTERNAL_CLOCK_VAL in the stm32f4xx_conf.h file. + + (#) Each SAI Block A or B has its own clock generator to make these two blocks + completely independent. The Clock generator is configured using RCC_SAIBlockACLKConfig() and + RCC_SAIBlockBCLKConfig() functions. + + (#) Each SAI Block A or B can be configured separetely : + (++) Program the Master clock divider, Audio mode, Protocol, Data Length, Clock Strobing Edge, + Synchronous mode, Output drive and FIFO Thresold using SAI_Init() function. + In case of master mode, program the Master clock divider (MCKDIV) using + the following formula : + (+++) MCLK_x = SAI_CK_x / (MCKDIV * 2) with MCLK_x = 256 * FS + (+++) FS = SAI_CK_x / (MCKDIV * 2) * 256 + (+++) MCKDIV = SAI_CK_x / FS * 512 + (++) Program the Frame Length, Frame active Length, FS Definition, FS Polarity, + FS Offset using SAI_FrameInit() function. + (++) Program the Slot First Bit Offset, Slot Size, Slot Number, Slot Active + using SAI_SlotInit() function. + + (#) Enable the NVIC and the corresponding interrupt using the function + SAI_ITConfig() if you need to use interrupt mode. + + (#) When using the DMA mode + (++) Configure the DMA using DMA_Init() function + (++) Active the needed channel Request using SAI_DMACmd() function + + (#) Enable the SAI using the SAI_Cmd() function. + + (#) Enable the DMA using the DMA_Cmd() function when using DMA mode. + + (#) The SAI has some specific functions which can be useful depending + on the audio protocol selected. + (++) Enable Mute mode when the audio block is a transmitter using SAI_MuteModeCmd() + function and configure the value transmitted during mute using SAI_MuteValueConfig(). + (++) Detect the Mute mode when audio block is a receiver using SAI_MuteFrameCounterConfig(). + (++) Enable the MONO mode without any data preprocessing in memory when the number + of slot is equal to 2 using SAI_MonoModeConfig() function. + (++) Enable data companding algorithm (U law and A law) using SAI_CompandingModeConfig(). + (++) Choose the behavior of the SD line in output when an inactive slot is sent + on the data line using SAI_TRIStateConfig() function. + [..] + (@) In master TX mode: enabling the audio block immediately generates the bit clock + for the external slaves even if there is no data in the FIFO, However FS signal + generation is conditioned by the presence of data in the FIFO. + + (@) In master RX mode: enabling the audio block immediately generates the bit clock + and FS signal for the external slaves. + + (@) It is mandatory to respect the following conditions in order to avoid bad SAI behavior: + (+@) First bit Offset <= (SLOT size - Data size) + (+@) Data size <= SLOT size + (+@) Number of SLOT x SLOT size = Frame length + (+@) The number of slots should be even when bit FSDEF in the SAI_xFRCR is set. + + @endverbatim + + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx_sai.h" +#include "stm32f4xx_rcc.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @defgroup SAI + * @brief SAI driver modules + * @{ + */ + +/* Private typedef -----------------------------------------------------------*/ +/* Private define ------------------------------------------------------------*/ + +/* *SAI registers Masks */ +#define CR1_CLEAR_MASK ((uint32_t)0xFF07C010) +#define FRCR_CLEAR_MASK ((uint32_t)0xFFF88000) +#define SLOTR_CLEAR_MASK ((uint32_t)0x0000F020) + +/* Private macro -------------------------------------------------------------*/ +/* Private variables ---------------------------------------------------------*/ +/* Private function prototypes -----------------------------------------------*/ +/* Private functions ---------------------------------------------------------*/ + +/** @defgroup SAI_Private_Functions + * @{ + */ + +/** @defgroup SAI_Group1 Initialization and Configuration functions + * @brief Initialization and Configuration functions + * +@verbatim + =============================================================================== + ##### Initialization and Configuration functions ##### + =============================================================================== + [..] + This section provides a set of functions allowing to initialize the SAI Audio + Block Mode, Audio Protocol, Data size, Synchronization between audio block, + Master clock Divider, Fifo threshold, Frame configuration, slot configuration, + Tristate mode, Companding mode and Mute mode. + [..] + The SAI_Init(), SAI_FrameInit() and SAI_SlotInit() functions follows the SAI Block + configuration procedures for Master mode and Slave mode (details for these procedures + are available in reference manual(RM0090). + +@endverbatim + * @{ + */ + +/** + * @brief Deinitialize the SAIx peripheral registers to their default reset values. + * @param SAIx: To select the SAIx peripheral, where x can be the different instances + * + * @retval None + */ +void SAI_DeInit(SAI_TypeDef* SAIx) +{ + /* Check the parameters */ + assert_param(IS_SAI_PERIPH(SAIx)); + + /* Enable SAI1 reset state */ + RCC_APB2PeriphResetCmd(RCC_APB2Periph_SAI1, ENABLE); + /* Release SAI1 from reset state */ + RCC_APB2PeriphResetCmd(RCC_APB2Periph_SAI1, DISABLE); +} + +/** + * @brief Initializes the SAI Block x peripheral according to the specified + * parameters in the SAI_InitStruct. + * + * @note SAI clock is generated from a specific output of the PLLSAI or a specific + * output of the PLLI2S or from an alternate function bypassing the PLL I2S. + * + * @param SAI_Block_x: where x can be A or B to select the SAI Block peripheral. + * @param SAI_InitStruct: pointer to a SAI_InitTypeDef structure that + * contains the configuration information for the specified SAI Block peripheral. + * @retval None + */ +void SAI_Init(SAI_Block_TypeDef* SAI_Block_x, SAI_InitTypeDef* SAI_InitStruct) +{ + uint32_t tmpreg = 0; + + /* Check the parameters */ + assert_param(IS_SAI_BLOCK_PERIPH(SAI_Block_x)); + + /* Check the SAI Block parameters */ + assert_param(IS_SAI_BLOCK_MODE(SAI_InitStruct->SAI_AudioMode)); + assert_param(IS_SAI_BLOCK_PROTOCOL(SAI_InitStruct->SAI_Protocol)); + assert_param(IS_SAI_BLOCK_DATASIZE(SAI_InitStruct->SAI_DataSize)); + assert_param(IS_SAI_BLOCK_FIRST_BIT(SAI_InitStruct->SAI_FirstBit)); + assert_param(IS_SAI_BLOCK_CLOCK_STROBING(SAI_InitStruct->SAI_ClockStrobing)); + assert_param(IS_SAI_BLOCK_SYNCHRO(SAI_InitStruct->SAI_Synchro)); + assert_param(IS_SAI_BLOCK_OUTPUT_DRIVE(SAI_InitStruct->SAI_OUTDRIV)); + assert_param(IS_SAI_BLOCK_NODIVIDER(SAI_InitStruct->SAI_NoDivider)); + assert_param(IS_SAI_BLOCK_MASTER_DIVIDER(SAI_InitStruct->SAI_MasterDivider)); + assert_param(IS_SAI_BLOCK_FIFO_THRESHOLD(SAI_InitStruct->SAI_FIFOThreshold)); + + /* SAI Block_x CR1 Configuration */ + /* Get the SAI Block_x CR1 value */ + tmpreg = SAI_Block_x->CR1; + /* Clear MODE, PRTCFG, DS, LSBFIRST, CKSTR, SYNCEN, OUTDRIV, NODIV, and MCKDIV bits */ + tmpreg &= CR1_CLEAR_MASK; + /* Configure SAI_Block_x: Audio mode, Protocol, Data Size, first transmitted bit, Clock strobing + edge, Synchronization mode, Output drive, Master Divider and FIFO level */ + /* Set MODE bits according to SAI_AudioMode value */ + /* Set PRTCFG bits according to SAI_Protocol value */ + /* Set DS bits according to SAI_DataSize value */ + /* Set LSBFIRST bit according to SAI_FirstBit value */ + /* Set CKSTR bit according to SAI_ClockStrobing value */ + /* Set SYNCEN bit according to SAI_Synchro value */ + /* Set OUTDRIV bit according to SAI_OUTDRIV value */ + /* Set NODIV bit according to SAI_NoDivider value */ + /* Set MCKDIV bits according to SAI_MasterDivider value */ + tmpreg |= (uint32_t)(SAI_InitStruct->SAI_AudioMode | SAI_InitStruct->SAI_Protocol | + SAI_InitStruct->SAI_DataSize | SAI_InitStruct->SAI_FirstBit | + SAI_InitStruct->SAI_ClockStrobing | SAI_InitStruct->SAI_Synchro | + SAI_InitStruct->SAI_OUTDRIV | SAI_InitStruct->SAI_NoDivider | + (uint32_t)((SAI_InitStruct->SAI_MasterDivider) << 20)); + /* Write to SAI_Block_x CR1 */ + SAI_Block_x->CR1 = tmpreg; + + /* SAI Block_x CR2 Configuration */ + /* Get the SAIBlock_x CR2 value */ + tmpreg = SAI_Block_x->CR2; + /* Clear FTH bits */ + tmpreg &= ~(SAI_xCR2_FTH); + /* Configure the FIFO Level */ + /* Set FTH bits according to SAI_FIFOThreshold value */ + tmpreg |= (uint32_t)(SAI_InitStruct->SAI_FIFOThreshold); + /* Write to SAI_Block_x CR2 */ + SAI_Block_x->CR2 = tmpreg; +} + +/** + * @brief Initializes the SAI Block Audio frame according to the specified + * parameters in the SAI_FrameInitStruct. + * + * @note this function has no meaning if the AC'97 or SPDIF audio protocol + * are selected. + * + * @param SAI_Block_x: where x can be A or B to select the SAI Block peripheral. + * @param SAI_FrameInitStruct: pointer to an SAI_FrameInitTypeDef structure that + * contains the configuration of audio frame for a specified SAI Block + * @retval None + */ +void SAI_FrameInit(SAI_Block_TypeDef* SAI_Block_x, SAI_FrameInitTypeDef* SAI_FrameInitStruct) +{ + uint32_t tmpreg = 0; + + /* Check the parameters */ + assert_param(IS_SAI_BLOCK_PERIPH(SAI_Block_x)); + + /* Check the SAI Block frame parameters */ + assert_param(IS_SAI_BLOCK_FRAME_LENGTH(SAI_FrameInitStruct->SAI_FrameLength)); + assert_param(IS_SAI_BLOCK_ACTIVE_FRAME(SAI_FrameInitStruct->SAI_ActiveFrameLength)); + assert_param(IS_SAI_BLOCK_FS_DEFINITION(SAI_FrameInitStruct->SAI_FSDefinition)); + assert_param(IS_SAI_BLOCK_FS_POLARITY(SAI_FrameInitStruct->SAI_FSPolarity)); + assert_param(IS_SAI_BLOCK_FS_OFFSET(SAI_FrameInitStruct->SAI_FSOffset)); + + /* SAI Block_x FRCR Configuration */ + /* Get the SAI Block_x FRCR value */ + tmpreg = SAI_Block_x->FRCR; + /* Clear FRL, FSALL, FSDEF, FSPOL, FSOFF bits */ + tmpreg &= FRCR_CLEAR_MASK; + /* Configure SAI_Block_x Frame: Frame Length, Active Frame Length, Frame Synchronization + Definition, Frame Synchronization Polarity and Frame Synchronization Polarity */ + /* Set FRL bits according to SAI_FrameLength value */ + /* Set FSALL bits according to SAI_ActiveFrameLength value */ + /* Set FSDEF bit according to SAI_FSDefinition value */ + /* Set FSPOL bit according to SAI_FSPolarity value */ + /* Set FSOFF bit according to SAI_FSOffset value */ + tmpreg |= (uint32_t)((uint32_t)(SAI_FrameInitStruct->SAI_FrameLength - 1) | + SAI_FrameInitStruct->SAI_FSOffset | + SAI_FrameInitStruct->SAI_FSDefinition | + SAI_FrameInitStruct->SAI_FSPolarity | + (uint32_t)((SAI_FrameInitStruct->SAI_ActiveFrameLength - 1) << 8)); + + /* Write to SAI_Block_x FRCR */ + SAI_Block_x->FRCR = tmpreg; +} + +/** + * @brief Initializes the SAI Block audio Slot according to the specified + * parameters in the SAI_SlotInitStruct. + * + * @note this function has no meaning if the AC'97 or SPDIF audio protocol + * are selected. + * + * @param SAI_Block_x: where x can be A or B to select the SAI Block peripheral. + * @param SAI_SlotInitStruct: pointer to an SAI_SlotInitTypeDef structure that + * contains the configuration of audio slot for a specified SAI Block + * @retval None + */ +void SAI_SlotInit(SAI_Block_TypeDef* SAI_Block_x, SAI_SlotInitTypeDef* SAI_SlotInitStruct) +{ + uint32_t tmpreg = 0; + + /* Check the parameters */ + assert_param(IS_SAI_BLOCK_PERIPH(SAI_Block_x)); + + /* Check the SAI Block Slot parameters */ + assert_param(IS_SAI_BLOCK_FIRSTBIT_OFFSET(SAI_SlotInitStruct->SAI_FirstBitOffset)); + assert_param(IS_SAI_BLOCK_SLOT_SIZE(SAI_SlotInitStruct->SAI_SlotSize)); + assert_param(IS_SAI_BLOCK_SLOT_NUMBER(SAI_SlotInitStruct->SAI_SlotNumber)); + assert_param(IS_SAI_SLOT_ACTIVE(SAI_SlotInitStruct->SAI_SlotActive)); + + /* SAI Block_x SLOTR Configuration */ + /* Get the SAI Block_x SLOTR value */ + tmpreg = SAI_Block_x->SLOTR; + /* Clear FBOFF, SLOTSZ, NBSLOT, SLOTEN bits */ + tmpreg &= SLOTR_CLEAR_MASK; + /* Configure SAI_Block_x Slot: First bit offset, Slot size, Number of Slot in + audio frame and slots activated in audio frame */ + /* Set FBOFF bits according to SAI_FirstBitOffset value */ + /* Set SLOTSZ bits according to SAI_SlotSize value */ + /* Set NBSLOT bits according to SAI_SlotNumber value */ + /* Set SLOTEN bits according to SAI_SlotActive value */ + tmpreg |= (uint32_t)(SAI_SlotInitStruct->SAI_FirstBitOffset | + SAI_SlotInitStruct->SAI_SlotSize | + SAI_SlotInitStruct->SAI_SlotActive | + (uint32_t)((SAI_SlotInitStruct->SAI_SlotNumber - 1) << 8)); + + /* Write to SAI_Block_x SLOTR */ + SAI_Block_x->SLOTR = tmpreg; +} + +/** + * @brief Fills each SAI_InitStruct member with its default value. + * @param SAI_InitStruct: pointer to a SAI_InitTypeDef structure which will + * be initialized. + * @retval None + */ +void SAI_StructInit(SAI_InitTypeDef* SAI_InitStruct) +{ + /* Reset SAI init structure parameters values */ + /* Initialize the SAI_AudioMode member */ + SAI_InitStruct->SAI_AudioMode = SAI_Mode_MasterTx; + /* Initialize the SAI_Protocol member */ + SAI_InitStruct->SAI_Protocol = SAI_Free_Protocol; + /* Initialize the SAI_DataSize member */ + SAI_InitStruct->SAI_DataSize = SAI_DataSize_8b; + /* Initialize the SAI_FirstBit member */ + SAI_InitStruct->SAI_FirstBit = SAI_FirstBit_MSB; + /* Initialize the SAI_ClockStrobing member */ + SAI_InitStruct->SAI_ClockStrobing = SAI_ClockStrobing_FallingEdge; + /* Initialize the SAI_Synchro member */ + SAI_InitStruct->SAI_Synchro = SAI_Asynchronous; + /* Initialize the SAI_OUTDRIV member */ + SAI_InitStruct->SAI_OUTDRIV = SAI_OutputDrive_Disabled; + /* Initialize the SAI_NoDivider member */ + SAI_InitStruct->SAI_NoDivider = SAI_MasterDivider_Enabled; + /* Initialize the SAI_MasterDivider member */ + SAI_InitStruct->SAI_MasterDivider = 0; + /* Initialize the SAI_FIFOThreshold member */ + SAI_InitStruct->SAI_FIFOThreshold = SAI_Threshold_FIFOEmpty; +} + +/** + * @brief Fills each SAI_FrameInitStruct member with its default value. + * @param SAI_FrameInitStruct: pointer to a SAI_FrameInitTypeDef structure + * which will be initialized. + * @retval None + */ +void SAI_FrameStructInit(SAI_FrameInitTypeDef* SAI_FrameInitStruct) +{ + /* Reset SAI Frame init structure parameters values */ + /* Initialize the SAI_FrameLength member */ + SAI_FrameInitStruct->SAI_FrameLength = 8; + /* Initialize the SAI_ActiveFrameLength member */ + SAI_FrameInitStruct->SAI_ActiveFrameLength = 1; + /* Initialize the SAI_FSDefinition member */ + SAI_FrameInitStruct->SAI_FSDefinition = SAI_FS_StartFrame; + /* Initialize the SAI_FSPolarity member */ + SAI_FrameInitStruct->SAI_FSPolarity = SAI_FS_ActiveLow; + /* Initialize the SAI_FSOffset member */ + SAI_FrameInitStruct->SAI_FSOffset = SAI_FS_FirstBit; +} + +/** + * @brief Fills each SAI_SlotInitStruct member with its default value. + * @param SAI_SlotInitStruct: pointer to a SAI_SlotInitTypeDef structure + * which will be initialized. + * @retval None + */ +void SAI_SlotStructInit(SAI_SlotInitTypeDef* SAI_SlotInitStruct) +{ + /* Reset SAI Slot init structure parameters values */ + /* Initialize the SAI_FirstBitOffset member */ + SAI_SlotInitStruct->SAI_FirstBitOffset = 0; + /* Initialize the SAI_SlotSize member */ + SAI_SlotInitStruct->SAI_SlotSize = SAI_SlotSize_DataSize; + /* Initialize the SAI_SlotNumber member */ + SAI_SlotInitStruct->SAI_SlotNumber = 1; + /* Initialize the SAI_SlotActive member */ + SAI_SlotInitStruct->SAI_SlotActive = SAI_Slot_NotActive; + +} + +/** + * @brief Enables or disables the specified SAI Block peripheral. + * @param SAI_Block_x: where x can be A or B to select the SAI Block peripheral. + * @param NewState: new state of the SAI_Block_x peripheral. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void SAI_Cmd(SAI_Block_TypeDef* SAI_Block_x, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_SAI_BLOCK_PERIPH(SAI_Block_x)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + if (NewState != DISABLE) + { + /* Enable the selected SAI peripheral */ + SAI_Block_x->CR1 |= SAI_xCR1_SAIEN; + } + else + { + /* Disable the selected SAI peripheral */ + SAI_Block_x->CR1 &= ~(SAI_xCR1_SAIEN); + } +} + +/** + * @brief Configures the mono mode for the selected SAI block. + * + * @note This function has a meaning only when the number of slot is equal to 2. + * + * @param SAI_Block_x: where x can be A or B to select the SAI Block peripheral. + * @param SAI_MonoMode: specifies the SAI block mono mode. + * This parameter can be one of the following values: + * @arg SAI_MonoMode : Set mono audio mode + * @arg SAI_StreoMode : Set streo audio mode + * @retval None + */ +void SAI_MonoModeConfig(SAI_Block_TypeDef* SAI_Block_x, uint32_t SAI_Mono_StreoMode) +{ + /* Check the parameters */ + assert_param(IS_SAI_BLOCK_PERIPH(SAI_Block_x)); + assert_param(IS_SAI_BLOCK_MONO_STREO_MODE(SAI_MonoMode)); + /* Clear MONO bit */ + SAI_Block_x->CR1 &= ~(SAI_xCR1_MONO); + /* Set new Mono Mode value */ + SAI_Block_x->CR1 |= SAI_MonoMode; +} + +/** + * @brief Configures the TRIState managment on data line for the selected SAI block. + * + * @note This function has a meaning only when the SAI block is configured in transmitter + * + * @param SAI_Block_x: where x can be A or B to select the SAI Block peripheral. + * @param SAI_TRIState: specifies the SAI block TRIState management. + * This parameter can be one of the following values: + * @arg SAI_Output_NotReleased : SD output line is still drived by the SAI. + * @arg SAI_Output_Released : SD output line is released (HI-Z) + * @retval None + */ +void SAI_TRIStateConfig(SAI_Block_TypeDef* SAI_Block_x, uint32_t SAI_TRIState) +{ + /* Check the parameters */ + assert_param(IS_SAI_BLOCK_PERIPH(SAI_Block_x)); + assert_param(IS_SAI_BLOCK_TRISTATE_MANAGEMENT(SAI_TRIState)); + /* Clear MONO bit */ + SAI_Block_x->CR1 &= ~(SAI_xCR1_MONO); + /* Set new Mono Mode value */ + SAI_Block_x->CR1 |= SAI_MonoMode; + +} + +/** + * @brief Configures the companding mode for the selected SAI block. + * + * @note The data expansion or data compression are determined by the state of + * SAI block selected (transmitter or receiver). + + * @param SAI_Block_x: where x can be A or B to select the SAI Block peripheral. + * @param SAI_CompandingMode: specifies the SAI block companding mode. + * This parameter can be one of the following values: + * @arg SAI_NoCompanding : no companding algorithm set + * @arg SAI_ULaw_1CPL_Companding : Set U law (algorithm 1's complement representation) + * @arg SAI_ALaw_1CPL_Companding : Set A law (algorithm 1's complement repesentation) + * @arg SAI_ULaw_2CPL_Companding : Set U law (algorithm 2's complement representation) + * @arg SAI_ALaw_2CPL_Companding : Set A law (algorithm 2's complement repesentation) + * @retval None + */ +void SAI_CompandingModeConfig(SAI_Block_TypeDef* SAI_Block_x, uint32_t SAI_CompandingMode) +{ + /* Check the parameters */ + assert_param(IS_SAI_BLOCK_PERIPH(SAI_Block_x)); + assert_param(IS_SAI_BLOCK_COMPANDING_MODE(SAI_CompandingMode)); + /* Clear Companding Mode bits */ + SAI_Block_x->CR2 &= ~(SAI_xCR2_COMP); + /* Set new Companding Mode value */ + SAI_Block_x->CR2 |= SAI_CompandingMode; +} + +/** + * @brief Enables or disables the Mute mode for the selected SAI block. + * + * @note This function has a meaning only when the audio block is transmitter + * @note Mute mode is applied for an entire frame for all the valid slot + * It becomes active at the end of an audio frame when set somewhere in a frame. + * Mute mode exit occurs at the end of the frame in which the bit MUTE has been set. + * + * @param SAI_Block_x: where x can be A or B to select the SAI Block peripheral. + * @param NewState: new state of the SAIx block. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void SAI_MuteModeCmd(SAI_Block_TypeDef* SAI_Block_x, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_SAI_BLOCK_PERIPH(SAI_Block_x)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + if (NewState != DISABLE) + { + /* Enable the selected SAI block mute mode */ + SAI_Block_x->CR2 |= SAI_xCR2_MUTE; + } + else + { + /* Disable the selected SAI SS output */ + SAI_Block_x->CR2 &= ~(SAI_xCR2_MUTE); + } +} + +/** + * @brief Configure the mute value for the selected SAI block. + * + * @note This function has a meaning only when the audio block is transmitter + * @note the configuration last value sent during mute mode has only a meaning + * when the number of slot is lower or equal to 2 and if the MUTE bit is set. + * + * @param SAI_Block_x: where x can be A or B to select the SAI Block peripheral. + * @param SAI_MuteValue: specifies the SAI block mute value. + * This parameter can be one of the following values: + * @arg SAI_ZeroValue : bit value 0 is sent during Mute Mode + * @arg SAI_LastSentValue : Last value is sent during Mute Mode + * @retval None + */ +void SAI_MuteValueConfig(SAI_Block_TypeDef* SAI_Block_x, uint32_t SAI_MuteValue) +{ + /* Check the parameters */ + assert_param(IS_SAI_BLOCK_PERIPH(SAI_Block_x)); + assert_param(IS_SAI_BLOCK_MUTE_VALUE(SAI_MuteValue)); + + /* Clear Mute value bits */ + SAI_Block_x->CR2 &= ~(SAI_xCR2_MUTEVAL); + /* Set new Mute value */ + SAI_Block_x->CR2 |= SAI_MuteValue; +} + +/** + * @brief Enables or disables the Mute mode for the selected SAI block. + * + * @note This function has a meaning only when the audio block is Receiver + * @param SAI_Block_x: where x can be A or B to select the SAI Block peripheral. + * @param SAI_MuteCounter: specifies the SAI block mute value. + * This parameter can be a number between 0 and 63. + + * @retval None + */ +void SAI_MuteFrameCounterConfig(SAI_Block_TypeDef* SAI_Block_x, uint32_t SAI_MuteCounter) +{ + /* Check the parameters */ + assert_param(IS_SAI_BLOCK_PERIPH(SAI_Block_x)); + assert_param(IS_SAI_BLOCK_MUTE_COUNTER(SAI_MuteCounter)); + + /* Clear Mute value bits */ + SAI_Block_x->CR2 &= ~(SAI_xCR2_MUTECNT); + /* Set new Mute value */ + SAI_Block_x->CR2 |= (SAI_MuteCounter << 7); +} + +/** + * @brief Reinitialize the FIFO pointer + * + * @note The FIFO pointers can be reinitialized at anytime The data present + * into the FIFO, if it is not empty, will be lost. + * + * @param SAI_Block_x: where x can be A or B to select the SAI Block peripheral. + * @param NewState: new state of the selected SAI TI communication mode. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void SAI_FlushFIFO(SAI_Block_TypeDef* SAI_Block_x) +{ + /* Check the parameters */ + assert_param(IS_SAI_BLOCK_PERIPH(SAI_Block_x)); + + /* FIFO flush */ + SAI_Block_x->CR2 |= SAI_xCR2_FFLUSH; +} + +/** + * @} + */ + +/** @defgroup SAI_Group2 Data transfers functions + * @brief Data transfers functions + * +@verbatim + =============================================================================== + ##### Data transfers functions ##### + =============================================================================== + [..] + This section provides a set of functions allowing to manage the SAI data transfers. + [..] + In reception, data are received and then stored into an internal FIFO while + In transmission, data are first stored into an internal FIFO before being + transmitted. + [..] + The read access of the SAI_xDR register can be done using the SAI_ReceiveData() + function and returns the Rx buffered value. Whereas a write access to the SAI_DR + can be done using SAI_SendData() function and stores the written data into + Tx buffer. + +@endverbatim + * @{ + */ + +/** + * @brief Returns the most recent received data by the SAI block x peripheral. + * @param SAI_Block_x: where x can be A or B to select the SAI Block peripheral. + * + * @retval The value of the received data. + */ +uint32_t SAI_ReceiveData(SAI_Block_TypeDef* SAI_Block_x) +{ + /* Check the parameters */ + assert_param(IS_SAI_BLOCK_PERIPH(SAI_Block_x)); + + /* Return the data in the DR register */ + return SAI_Block_x->DR; +} + +/** + * @brief Transmits a Data through the SAI block x peripheral. + * @param SAI_Block_x: where x can be A or B to select the SAI Block peripheral. + * + * @param Data: Data to be transmitted. + * @retval None + */ +void SAI_SendData(SAI_Block_TypeDef* SAI_Block_x, uint32_t Data) +{ + /* Check the parameters */ + assert_param(IS_SAI_BLOCK_PERIPH(SAI_Block_x)); + + /* Write in the DR register the data to be sent */ + SAI_Block_x->DR = Data; +} + +/** + * @} + */ + +/** @defgroup SAI_Group3 DMA transfers management functions + * @brief DMA transfers management functions + * +@verbatim + =============================================================================== + ##### DMA transfers management functions ##### + =============================================================================== + +@endverbatim + * @{ + */ + +/** + * @brief Enables or disables the SAI Block x DMA interface. + * @param SAI_Block_x: where x can be A or B to select the SAI Block peripheral. + * @param NewState: new state of the selected SAI block DMA transfer request. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void SAI_DMACmd(SAI_Block_TypeDef* SAI_Block_x, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_SAI_BLOCK_PERIPH(SAI_Block_x)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the selected SAI block mute mode */ + SAI_Block_x->CR1 |= SAI_xCR1_DMAEN; + } + else + { + /* Disable the selected SAI SS output */ + SAI_Block_x->CR1 &= ~(SAI_xCR1_DMAEN); + } +} + +/** + * @} + */ + +/** @defgroup SAI_Group4 Interrupts and flags management functions + * @brief Interrupts and flags management functions + * +@verbatim + =============================================================================== + ##### Interrupts and flags management functions ##### + =============================================================================== + [..] + This section provides a set of functions allowing to configure the SAI Interrupts + sources and check or clear the flags or pending bits status. + The user should identify which mode will be used in his application to manage + the communication: Polling mode, Interrupt mode or DMA mode. + + *** Polling Mode *** + ==================== + [..] + In Polling Mode, the SAI communication can be managed by 7 flags: + (#) SAI_FLAG_FREQ : to indicate if there is a FIFO Request to write or to read. + (#) SAI_FLAG_MUTEDET : to indicate if a MUTE frame detected + (#) SAI_FLAG_OVRUDR : to indicate if an Overrun or Underrun error occur + (#) SAI_FLAG_AFSDET : to indicate if there is the detection of a audio frame + synchronisation (FS) earlier than expected + (#) SAI_FLAG_LFSDET : to indicate if there is the detection of a audio frame + synchronisation (FS) later than expected + (#) SAI_FLAG_CNRDY : to indicate if the codec is not ready to communicate during + the reception of the TAG 0 (slot0) of the AC97 audio frame + (#) SAI_FLAG_WCKCFG: to indicate if wrong clock configuration in master mode + error occurs. + [..] + In this Mode it is advised to use the following functions: + (+) FlagStatus SAI_GetFlagStatus(SAI_Block_TypeDef* SAI_Block_x, uint32_t SAI_FLAG); + (+) void SAI_ClearFlag(SAI_Block_TypeDef* SAI_Block_x, uint32_t SAI_FLAG); + + *** Interrupt Mode *** + ====================== + [..] + In Interrupt Mode, the SAI communication can be managed by 7 interrupt sources + and 7 pending bits: + (+) Pending Bits: + (##) SAI_IT_FREQ : to indicate if there is a FIFO Request to write or to read. + (##) SAI_IT_MUTEDET : to indicate if a MUTE frame detected. + (##) SAI_IT_OVRUDR : to indicate if an Overrun or Underrun error occur. + (##) SAI_IT_AFSDET : to indicate if there is the detection of a audio frame + synchronisation (FS) earlier than expected. + (##) SAI_IT_LFSDET : to indicate if there is the detection of a audio frame + synchronisation (FS) later than expected. + (##) SAI_IT_CNRDY : to indicate if the codec is not ready to communicate during + the reception of the TAG 0 (slot0) of the AC97 audio frame. + (##) SAI_IT_WCKCFG: to indicate if wrong clock configuration in master mode + error occurs. + + (+) Interrupt Source: + (##) SAI_IT_FREQ : specifies the interrupt source for FIFO Request. + (##) SAI_IT_MUTEDET : specifies the interrupt source for MUTE frame detected. + (##) SAI_IT_OVRUDR : specifies the interrupt source for overrun or underrun error. + (##) SAI_IT_AFSDET : specifies the interrupt source for anticipated frame synchronization + detection interrupt. + (##) SAI_IT_LFSDET : specifies the interrupt source for late frame synchronization + detection interrupt. + (##) SAI_IT_CNRDY : specifies the interrupt source for codec not ready interrupt + (##) SAI_IT_WCKCFG: specifies the interrupt source for wrong clock configuration + interrupt. + [..] + In this Mode it is advised to use the following functions: + (+) void SAI_ITConfig(SAI_Block_TypeDef* SAI_Block_x, uint32_t SAI_IT, FunctionalState NewState); + (+) ITStatus SAI_GetITStatus(SAI_Block_TypeDef* SAI_Block_x, uint32_t SAI_IT); + (+) void SAI_ClearITPendingBit(SAI_Block_TypeDef* SAI_Block_x, uint32_t SAI_IT); + + *** DMA Mode *** + ================ + [..] + In DMA Mode, each SAI audio block has an independent DMA interface in order to + read or to write into the SAI_xDR register (to hit the internal FIFO). + There is one DMA channel by audio block following basic DMA request/acknowledge + protocol. + [..] + In this Mode it is advised to use the following function: + (+) void SAI_DMACmd(SAI_Block_TypeDef* SAI_Block_x, FunctionalState NewState); + [..] + This section provides also functions allowing to + (+) Check the SAI Block enable status + (+)Check the FIFO status + + *** SAI Block Enable status *** + =============================== + [..] + After disabling a SAI Block, it is recommended to check (or wait until) the SAI Block + is effectively disabled. If a Block is disabled while an audio frame transfer is ongoing + the current frame will be transferred and the block will be effectively disabled only at + the end of audio frame. + To monitor this state it is possible to use the following function: + (+) FunctionalState SAI_GetCmdStatus(SAI_Block_TypeDef* SAI_Block_x); + + *** SAI Block FIFO status *** + ============================= + [..] + It is possible to monitor the FIFO status when a transfer is ongoing using the following + function: + (+) uint32_t SAI_GetFIFOStatus(SAI_Block_TypeDef* SAI_Block_x); + +@endverbatim + * @{ + */ + +/** + * @brief Enables or disables the specified SAI Block interrupts. + * @param SAI_Block_x: where x can be A or B to select the SAI Block peripheral. + * @param SAI_IT: specifies the SAI interrupt source to be enabled or disabled. + * This parameter can be one of the following values: + * @arg SAI_IT_FREQ: FIFO Request interrupt mask + * @arg SAI_IT_MUTEDET: MUTE detection interrupt mask + * @arg SAI_IT_OVRUDR: overrun/underrun interrupt mask + * @arg SAI_IT_AFSDET: anticipated frame synchronization detection + * interrupt mask + * @arg SAI_IT_LFSDET: late frame synchronization detection interrupt + * mask + * @arg SAI_IT_CNRDY: codec not ready interrupt mask + * @arg SAI_IT_WCKCFG: wrong clock configuration interrupt mask + * @param NewState: new state of the specified SAI interrupt. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void SAI_ITConfig(SAI_Block_TypeDef* SAI_Block_x, uint32_t SAI_IT, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_SAI_BLOCK_PERIPH(SAI_Block_x)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + assert_param(IS_SAI_BLOCK_CONFIG_IT(SAI_IT)); + + if (NewState != DISABLE) + { + /* Enable the selected SAI Block interrupt */ + SAI_Block_x->IMR |= SAI_IT; + } + else + { + /* Disable the selected SAI Block interrupt */ + SAI_Block_x->IMR &= ~(SAI_IT); + } +} + +/** + * @brief Checks whether the specified SAI block x flag is set or not. + * @param SAI_Block_x: where x can be A or B to select the SAI Block peripheral. + * @param SAI_FLAG: specifies the SAI block flag to check. + * This parameter can be one of the following values: + * @arg SAI_FLAG_FREQ: FIFO Request flag. + * @arg SAI_FLAG_MUTEDET: MUTE detection flag. + * @arg SAI_FLAG_OVRUDR: overrun/underrun flag. + * @arg SAI_FLAG_WCKCFG: wrong clock configuration flag. + * @arg SAI_FLAG_CNRDY: codec not ready flag. + * @arg SAI_FLAG_AFSDET: anticipated frame synchronization detection flag. + * @arg SAI_FLAG_LFSDET: late frame synchronization detection flag. + * @retval The new state of SAI_FLAG (SET or RESET). + */ +FlagStatus SAI_GetFlagStatus(SAI_Block_TypeDef* SAI_Block_x, uint32_t SAI_FLAG) +{ + FlagStatus bitstatus = RESET; + + /* Check the parameters */ + assert_param(IS_SAI_BLOCK_PERIPH(SAI_Block_x)); + assert_param(IS_SAI_BLOCK_GET_FLAG(SAI_FLAG)); + + /* Check the status of the specified SAI flag */ + if ((SAI_Block_x->SR & SAI_FLAG) != (uint32_t)RESET) + { + /* SAI_FLAG is set */ + bitstatus = SET; + } + else + { + /* SAI_FLAG is reset */ + bitstatus = RESET; + } + /* Return the SAI_FLAG status */ + return bitstatus; +} + +/** + * @brief Clears the specified SAI Block x flag. + * @param SAI_Block_x: where x can be A or B to select the SAI Block peripheral. + * @param SAI_FLAG: specifies the SAI block flag to check. + * This parameter can be one of the following values: + * @arg SAI_FLAG_MUTEDET: MUTE detection flag. + * @arg SAI_FLAG_OVRUDR: overrun/underrun flag. + * @arg SAI_FLAG_WCKCFG: wrong clock configuration flag. + * @arg SAI_FLAG_CNRDY: codec not ready flag. + * @arg SAI_FLAG_AFSDET: anticipated frame synchronization detection flag. + * @arg SAI_FLAG_LFSDET: late frame synchronization detection flag. + * + * @note FREQ (FIFO Request) flag is cleared : + * - When the audio block is transmitter and the FIFO is full or the FIFO + * has one data (one buffer mode) depending the bit FTH in the + * SAI_xCR2 register. + * - When the audio block is receiver and the FIFO is not empty + * + * @retval None + */ +void SAI_ClearFlag(SAI_Block_TypeDef* SAI_Block_x, uint32_t SAI_FLAG) +{ + /* Check the parameters */ + assert_param(IS_SAI_BLOCK_PERIPH(SAI_Block_x)); + assert_param(IS_SAI_BLOCK_CLEAR_FLAG(SAI_FLAG)); + + /* Clear the selected SAI Block flag */ + SAI_Block_x->CLRFR |= SAI_FLAG; +} + +/** + * @brief Checks whether the specified SAI Block x interrupt has occurred or not. + * @param SAI_Block_x: where x can be A or B to select the SAI Block peripheral. + * @param SAI_IT: specifies the SAI interrupt source to be enabled or disabled. + * This parameter can be one of the following values: + * @arg SAI_IT_FREQ: FIFO Request interrupt + * @arg SAI_IT_MUTEDET: MUTE detection interrupt + * @arg SAI_IT_OVRUDR: overrun/underrun interrupt + * @arg SAI_IT_AFSDET: anticipated frame synchronization detection interrupt + * @arg SAI_IT_LFSDET: late frame synchronization detection interrupt + * @arg SAI_IT_CNRDY: codec not ready interrupt + * @arg SAI_IT_WCKCFG: wrong clock configuration interrupt + * + * @retval The new state of SAI_IT (SET or RESET). + */ +ITStatus SAI_GetITStatus(SAI_Block_TypeDef* SAI_Block_x, uint32_t SAI_IT) +{ + ITStatus bitstatus = RESET; + uint32_t enablestatus = 0; + + /* Check the parameters */ + assert_param(IS_SAI_BLOCK_PERIPH(SAI_Block_x)); + assert_param(IS_SAI_BLOCK_CONFIG_IT(SAI_IT)); + + /* Get the SAI_IT enable bit status */ + enablestatus = (SAI_Block_x->IMR & SAI_IT) ; + + /* Check the status of the specified SAI interrupt */ + if (((SAI_Block_x->SR & SAI_IT) != (uint32_t)RESET) && (enablestatus != (uint32_t)RESET)) + { + /* SAI_IT is set */ + bitstatus = SET; + } + else + { + /* SAI_IT is reset */ + bitstatus = RESET; + } + /* Return the SAI_IT status */ + return bitstatus; +} + +/** + * @brief Clears the SAI Block x interrupt pending bit. + * @param SAI_Block_x: where x can be A or B to select the SAI Block peripheral. + * @param SAI_IT: specifies the SAI Block interrupt pending bit to clear. + * This parameter can be one of the following values: + * @arg SAI_IT_MUTEDET: MUTE detection interrupt. + * @arg SAI_IT_OVRUDR: overrun/underrun interrupt. + * @arg SAI_IT_WCKCFG: wrong clock configuration interrupt. + * @arg SAI_IT_CNRDY: codec not ready interrupt. + * @arg SAI_IT_AFSDET: anticipated frame synchronization detection interrupt. + * @arg SAI_IT_LFSDET: late frame synchronization detection interrupt. + * + * @note FREQ (FIFO Request) flag is cleared : + * - When the audio block is transmitter and the FIFO is full or the FIFO + * has one data (one buffer mode) depending the bit FTH in the + * SAI_xCR2 register. + * - When the audio block is receiver and the FIFO is not empty + * + * @retval None + */ +void SAI_ClearITPendingBit(SAI_Block_TypeDef* SAI_Block_x, uint32_t SAI_IT) +{ + /* Check the parameters */ + assert_param(IS_SAI_BLOCK_PERIPH(SAI_Block_x)); + assert_param(IS_SAI_BLOCK_CONFIG_IT(SAI_IT)); + + /* Clear the selected SAI Block x interrupt pending bit */ + SAI_Block_x->CLRFR |= SAI_IT; +} + +/** + * @brief Returns the status of EN bit for the specified SAI Block x. + * @param SAI_Block_x: where x can be A or B to select the SAI Block peripheral. + * + * @note After disabling a SAI Block, it is recommended to check (or wait until) + * the SAI Block is effectively disabled. If a Block is disabled while + * an audio frame transfer is ongoing, the current frame will be + * transferred and the block will be effectively disabled only at + * the end of audio frame. + * + * @retval Current state of the DMAy Streamx (ENABLE or DISABLE). + */ +FunctionalState SAI_GetCmdStatus(SAI_Block_TypeDef* SAI_Block_x) +{ + FunctionalState state = DISABLE; + + /* Check the parameters */ + assert_param(IS_SAI_BLOCK_PERIPH(SAI_Block_x)); + if ((SAI_Block_x->CR1 & (uint32_t)SAI_xCR1_SAIEN) != 0) + { + /* The selected SAI Block x EN bit is set (audio frame transfer is ongoing) */ + state = ENABLE; + } + else + { + /* The selected SAI Block x EN bit is cleared (SAI Block is disabled and + all transfers are complete) */ + state = DISABLE; + } + return state; +} + +/** + * @brief Returns the current SAI Block x FIFO filled level. + * @param SAI_Block_x: where x can be A or B to select the SAI Block peripheral. + * + * @retval The FIFO filling state. + * - SAI_FIFOStatus_Empty: when FIFO is empty + * - SAI_FIFOStatus_Less1QuarterFull: when FIFO is less than 1 quarter-full + * and not empty. + * - SAI_FIFOStatus_1QuarterFull: if more than 1 quarter-full. + * - SAI_FIFOStatus_HalfFull: if more than 1 half-full. + * - SAI_FIFOStatus_3QuartersFull: if more than 3 quarters-full. + * - SAI_FIFOStatus_Full: when FIFO is full + */ +uint32_t SAI_GetFIFOStatus(SAI_Block_TypeDef* SAI_Block_x) +{ + uint32_t tmpreg = 0; + + /* Check the parameters */ + assert_param(IS_SAI_BLOCK_PERIPH(SAI_Block_x)); + + /* Get the FIFO level bits */ + tmpreg = (uint32_t)((SAI_Block_x->SR & SAI_xSR_FLVL)); + + return tmpreg; +} + + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/src/stm32f4xx_sdio.c b/FWLIB/src/stm32f4xx_sdio.c new file mode 100644 index 0000000..ca1c895 --- /dev/null +++ b/FWLIB/src/stm32f4xx_sdio.c @@ -0,0 +1,1011 @@ +/** + ****************************************************************************** + * @file stm32f4xx_sdio.c + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file provides firmware functions to manage the following + * functionalities of the Secure digital input/output interface (SDIO) + * peripheral: + * + Initialization and Configuration + * + Command path state machine (CPSM) management + * + Data path state machine (DPSM) management + * + SDIO IO Cards mode management + * + CE-ATA mode management + * + DMA transfers management + * + Interrupts and flags management + * +@verbatim + + =================================================================== + ##### How to use this driver ##### + =================================================================== + [..] + (#) The SDIO clock (SDIOCLK = 48 MHz) is coming from a specific output of PLL + (PLL48CLK). Before to start working with SDIO peripheral make sure that the + PLL is well configured. + The SDIO peripheral uses two clock signals: + (++) SDIO adapter clock (SDIOCLK = 48 MHz) + (++) APB2 bus clock (PCLK2) + + -@@- PCLK2 and SDIO_CK clock frequencies must respect the following condition: + Frequency(PCLK2) >= (3 / 8 x Frequency(SDIO_CK)) + + (#) Enable peripheral clock using RCC_APB2PeriphClockCmd(RCC_APB2Periph_SDIO, ENABLE). + + (#) According to the SDIO mode, enable the GPIO clocks using + RCC_AHB1PeriphClockCmd() function. + The I/O can be one of the following configurations: + (++) 1-bit data length: SDIO_CMD, SDIO_CK and D0. + (++) 4-bit data length: SDIO_CMD, SDIO_CK and D[3:0]. + (++) 8-bit data length: SDIO_CMD, SDIO_CK and D[7:0]. + + (#) Peripheral alternate function: + (++) Connect the pin to the desired peripherals' Alternate Function (AF) + using GPIO_PinAFConfig() function + (++) Configure the desired pin in alternate function by: + GPIO_InitStruct->GPIO_Mode = GPIO_Mode_AF + (++) Select the type, pull-up/pull-down and output speed via GPIO_PuPd, + GPIO_OType and GPIO_Speed members + (++) Call GPIO_Init() function + + (#) Program the Clock Edge, Clock Bypass, Clock Power Save, Bus Wide, + hardware, flow control and the Clock Divider using the SDIO_Init() + function. + + (#) Enable the Power ON State using the SDIO_SetPowerState(SDIO_PowerState_ON) + function. + + (#) Enable the clock using the SDIO_ClockCmd() function. + + (#) Enable the NVIC and the corresponding interrupt using the function + SDIO_ITConfig() if you need to use interrupt mode. + + (#) When using the DMA mode + (++) Configure the DMA using DMA_Init() function + (++) Active the needed channel Request using SDIO_DMACmd() function + + (#) Enable the DMA using the DMA_Cmd() function, when using DMA mode. + + (#) To control the CPSM (Command Path State Machine) and send + commands to the card use the SDIO_SendCommand(), + SDIO_GetCommandResponse() and SDIO_GetResponse() functions. First, user has + to fill the command structure (pointer to SDIO_CmdInitTypeDef) according + to the selected command to be sent. + The parameters that should be filled are: + (++) Command Argument + (++) Command Index + (++) Command Response type + (++) Command Wait + (++) CPSM Status (Enable or Disable). + + -@@- To check if the command is well received, read the SDIO_CMDRESP + register using the SDIO_GetCommandResponse(). + The SDIO responses registers (SDIO_RESP1 to SDIO_RESP2), use the + SDIO_GetResponse() function. + + (#) To control the DPSM (Data Path State Machine) and send/receive + data to/from the card use the SDIO_DataConfig(), SDIO_GetDataCounter(), + SDIO_ReadData(), SDIO_WriteData() and SDIO_GetFIFOCount() functions. + + *** Read Operations *** + ======================= + [..] + (#) First, user has to fill the data structure (pointer to + SDIO_DataInitTypeDef) according to the selected data type to be received. + The parameters that should be filled are: + (++) Data TimeOut + (++) Data Length + (++) Data Block size + (++) Data Transfer direction: should be from card (To SDIO) + (++) Data Transfer mode + (++) DPSM Status (Enable or Disable) + + (#) Configure the SDIO resources to receive the data from the card + according to selected transfer mode (Refer to Step 8, 9 and 10). + + (#) Send the selected Read command (refer to step 11). + + (#) Use the SDIO flags/interrupts to check the transfer status. + + *** Write Operations *** + ======================== + [..] + (#) First, user has to fill the data structure (pointer to + SDIO_DataInitTypeDef) according to the selected data type to be received. + The parameters that should be filled are: + (++) Data TimeOut + (++) Data Length + (++) Data Block size + (++) Data Transfer direction: should be to card (To CARD) + (++) Data Transfer mode + (++) DPSM Status (Enable or Disable) + + (#) Configure the SDIO resources to send the data to the card according to + selected transfer mode (Refer to Step 8, 9 and 10). + + (#) Send the selected Write command (refer to step 11). + + (#) Use the SDIO flags/interrupts to check the transfer status. + + +@endverbatim + * + * + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx_sdio.h" +#include "stm32f4xx_rcc.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @defgroup SDIO + * @brief SDIO driver modules + * @{ + */ + +/* Private typedef -----------------------------------------------------------*/ +/* Private define ------------------------------------------------------------*/ + +/* ------------ SDIO registers bit address in the alias region ----------- */ +#define SDIO_OFFSET (SDIO_BASE - PERIPH_BASE) + +/* --- CLKCR Register ---*/ +/* Alias word address of CLKEN bit */ +#define CLKCR_OFFSET (SDIO_OFFSET + 0x04) +#define CLKEN_BitNumber 0x08 +#define CLKCR_CLKEN_BB (PERIPH_BB_BASE + (CLKCR_OFFSET * 32) + (CLKEN_BitNumber * 4)) + +/* --- CMD Register ---*/ +/* Alias word address of SDIOSUSPEND bit */ +#define CMD_OFFSET (SDIO_OFFSET + 0x0C) +#define SDIOSUSPEND_BitNumber 0x0B +#define CMD_SDIOSUSPEND_BB (PERIPH_BB_BASE + (CMD_OFFSET * 32) + (SDIOSUSPEND_BitNumber * 4)) + +/* Alias word address of ENCMDCOMPL bit */ +#define ENCMDCOMPL_BitNumber 0x0C +#define CMD_ENCMDCOMPL_BB (PERIPH_BB_BASE + (CMD_OFFSET * 32) + (ENCMDCOMPL_BitNumber * 4)) + +/* Alias word address of NIEN bit */ +#define NIEN_BitNumber 0x0D +#define CMD_NIEN_BB (PERIPH_BB_BASE + (CMD_OFFSET * 32) + (NIEN_BitNumber * 4)) + +/* Alias word address of ATACMD bit */ +#define ATACMD_BitNumber 0x0E +#define CMD_ATACMD_BB (PERIPH_BB_BASE + (CMD_OFFSET * 32) + (ATACMD_BitNumber * 4)) + +/* --- DCTRL Register ---*/ +/* Alias word address of DMAEN bit */ +#define DCTRL_OFFSET (SDIO_OFFSET + 0x2C) +#define DMAEN_BitNumber 0x03 +#define DCTRL_DMAEN_BB (PERIPH_BB_BASE + (DCTRL_OFFSET * 32) + (DMAEN_BitNumber * 4)) + +/* Alias word address of RWSTART bit */ +#define RWSTART_BitNumber 0x08 +#define DCTRL_RWSTART_BB (PERIPH_BB_BASE + (DCTRL_OFFSET * 32) + (RWSTART_BitNumber * 4)) + +/* Alias word address of RWSTOP bit */ +#define RWSTOP_BitNumber 0x09 +#define DCTRL_RWSTOP_BB (PERIPH_BB_BASE + (DCTRL_OFFSET * 32) + (RWSTOP_BitNumber * 4)) + +/* Alias word address of RWMOD bit */ +#define RWMOD_BitNumber 0x0A +#define DCTRL_RWMOD_BB (PERIPH_BB_BASE + (DCTRL_OFFSET * 32) + (RWMOD_BitNumber * 4)) + +/* Alias word address of SDIOEN bit */ +#define SDIOEN_BitNumber 0x0B +#define DCTRL_SDIOEN_BB (PERIPH_BB_BASE + (DCTRL_OFFSET * 32) + (SDIOEN_BitNumber * 4)) + +/* ---------------------- SDIO registers bit mask ------------------------ */ +/* --- CLKCR Register ---*/ +/* CLKCR register clear mask */ +#define CLKCR_CLEAR_MASK ((uint32_t)0xFFFF8100) + +/* --- PWRCTRL Register ---*/ +/* SDIO PWRCTRL Mask */ +#define PWR_PWRCTRL_MASK ((uint32_t)0xFFFFFFFC) + +/* --- DCTRL Register ---*/ +/* SDIO DCTRL Clear Mask */ +#define DCTRL_CLEAR_MASK ((uint32_t)0xFFFFFF08) + +/* --- CMD Register ---*/ +/* CMD Register clear mask */ +#define CMD_CLEAR_MASK ((uint32_t)0xFFFFF800) + +/* SDIO RESP Registers Address */ +#define SDIO_RESP_ADDR ((uint32_t)(SDIO_BASE + 0x14)) + +/* Private macro -------------------------------------------------------------*/ +/* Private variables ---------------------------------------------------------*/ +/* Private function prototypes -----------------------------------------------*/ +/* Private functions ---------------------------------------------------------*/ + +/** @defgroup SDIO_Private_Functions + * @{ + */ + +/** @defgroup SDIO_Group1 Initialization and Configuration functions + * @brief Initialization and Configuration functions + * +@verbatim + =============================================================================== + ##### Initialization and Configuration functions ##### + =============================================================================== + +@endverbatim + * @{ + */ + +/** + * @brief Deinitializes the SDIO peripheral registers to their default reset values. + * @param None + * @retval None + */ +void SDIO_DeInit(void) +{ + RCC_APB2PeriphResetCmd(RCC_APB2Periph_SDIO, ENABLE); + RCC_APB2PeriphResetCmd(RCC_APB2Periph_SDIO, DISABLE); +} + +/** + * @brief Initializes the SDIO peripheral according to the specified + * parameters in the SDIO_InitStruct. + * @param SDIO_InitStruct : pointer to a SDIO_InitTypeDef structure + * that contains the configuration information for the SDIO peripheral. + * @retval None + */ +void SDIO_Init(SDIO_InitTypeDef* SDIO_InitStruct) +{ + uint32_t tmpreg = 0; + + /* Check the parameters */ + assert_param(IS_SDIO_CLOCK_EDGE(SDIO_InitStruct->SDIO_ClockEdge)); + assert_param(IS_SDIO_CLOCK_BYPASS(SDIO_InitStruct->SDIO_ClockBypass)); + assert_param(IS_SDIO_CLOCK_POWER_SAVE(SDIO_InitStruct->SDIO_ClockPowerSave)); + assert_param(IS_SDIO_BUS_WIDE(SDIO_InitStruct->SDIO_BusWide)); + assert_param(IS_SDIO_HARDWARE_FLOW_CONTROL(SDIO_InitStruct->SDIO_HardwareFlowControl)); + +/*---------------------------- SDIO CLKCR Configuration ------------------------*/ + /* Get the SDIO CLKCR value */ + tmpreg = SDIO->CLKCR; + + /* Clear CLKDIV, PWRSAV, BYPASS, WIDBUS, NEGEDGE, HWFC_EN bits */ + tmpreg &= CLKCR_CLEAR_MASK; + + /* Set CLKDIV bits according to SDIO_ClockDiv value */ + /* Set PWRSAV bit according to SDIO_ClockPowerSave value */ + /* Set BYPASS bit according to SDIO_ClockBypass value */ + /* Set WIDBUS bits according to SDIO_BusWide value */ + /* Set NEGEDGE bits according to SDIO_ClockEdge value */ + /* Set HWFC_EN bits according to SDIO_HardwareFlowControl value */ + tmpreg |= (SDIO_InitStruct->SDIO_ClockDiv | SDIO_InitStruct->SDIO_ClockPowerSave | + SDIO_InitStruct->SDIO_ClockBypass | SDIO_InitStruct->SDIO_BusWide | + SDIO_InitStruct->SDIO_ClockEdge | SDIO_InitStruct->SDIO_HardwareFlowControl); + + /* Write to SDIO CLKCR */ + SDIO->CLKCR = tmpreg; +} + +/** + * @brief Fills each SDIO_InitStruct member with its default value. + * @param SDIO_InitStruct: pointer to an SDIO_InitTypeDef structure which + * will be initialized. + * @retval None + */ +void SDIO_StructInit(SDIO_InitTypeDef* SDIO_InitStruct) +{ + /* SDIO_InitStruct members default value */ + SDIO_InitStruct->SDIO_ClockDiv = 0x00; + SDIO_InitStruct->SDIO_ClockEdge = SDIO_ClockEdge_Rising; + SDIO_InitStruct->SDIO_ClockBypass = SDIO_ClockBypass_Disable; + SDIO_InitStruct->SDIO_ClockPowerSave = SDIO_ClockPowerSave_Disable; + SDIO_InitStruct->SDIO_BusWide = SDIO_BusWide_1b; + SDIO_InitStruct->SDIO_HardwareFlowControl = SDIO_HardwareFlowControl_Disable; +} + +/** + * @brief Enables or disables the SDIO Clock. + * @param NewState: new state of the SDIO Clock. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void SDIO_ClockCmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + *(__IO uint32_t *) CLKCR_CLKEN_BB = (uint32_t)NewState; +} + +/** + * @brief Sets the power status of the controller. + * @param SDIO_PowerState: new state of the Power state. + * This parameter can be one of the following values: + * @arg SDIO_PowerState_OFF: SDIO Power OFF + * @arg SDIO_PowerState_ON: SDIO Power ON + * @retval None + */ +void SDIO_SetPowerState(uint32_t SDIO_PowerState) +{ + /* Check the parameters */ + assert_param(IS_SDIO_POWER_STATE(SDIO_PowerState)); + + SDIO->POWER = SDIO_PowerState; +} + +/** + * @brief Gets the power status of the controller. + * @param None + * @retval Power status of the controller. The returned value can be one of the + * following values: + * - 0x00: Power OFF + * - 0x02: Power UP + * - 0x03: Power ON + */ +uint32_t SDIO_GetPowerState(void) +{ + return (SDIO->POWER & (~PWR_PWRCTRL_MASK)); +} + +/** + * @} + */ + +/** @defgroup SDIO_Group2 Command path state machine (CPSM) management functions + * @brief Command path state machine (CPSM) management functions + * +@verbatim + =============================================================================== + ##### Command path state machine (CPSM) management functions ##### + =============================================================================== + + This section provide functions allowing to program and read the Command path + state machine (CPSM). + +@endverbatim + * @{ + */ + +/** + * @brief Initializes the SDIO Command according to the specified + * parameters in the SDIO_CmdInitStruct and send the command. + * @param SDIO_CmdInitStruct : pointer to a SDIO_CmdInitTypeDef + * structure that contains the configuration information for the SDIO + * command. + * @retval None + */ +void SDIO_SendCommand(SDIO_CmdInitTypeDef *SDIO_CmdInitStruct) +{ + uint32_t tmpreg = 0; + + /* Check the parameters */ + assert_param(IS_SDIO_CMD_INDEX(SDIO_CmdInitStruct->SDIO_CmdIndex)); + assert_param(IS_SDIO_RESPONSE(SDIO_CmdInitStruct->SDIO_Response)); + assert_param(IS_SDIO_WAIT(SDIO_CmdInitStruct->SDIO_Wait)); + assert_param(IS_SDIO_CPSM(SDIO_CmdInitStruct->SDIO_CPSM)); + +/*---------------------------- SDIO ARG Configuration ------------------------*/ + /* Set the SDIO Argument value */ + SDIO->ARG = SDIO_CmdInitStruct->SDIO_Argument; + +/*---------------------------- SDIO CMD Configuration ------------------------*/ + /* Get the SDIO CMD value */ + tmpreg = SDIO->CMD; + /* Clear CMDINDEX, WAITRESP, WAITINT, WAITPEND, CPSMEN bits */ + tmpreg &= CMD_CLEAR_MASK; + /* Set CMDINDEX bits according to SDIO_CmdIndex value */ + /* Set WAITRESP bits according to SDIO_Response value */ + /* Set WAITINT and WAITPEND bits according to SDIO_Wait value */ + /* Set CPSMEN bits according to SDIO_CPSM value */ + tmpreg |= (uint32_t)SDIO_CmdInitStruct->SDIO_CmdIndex | SDIO_CmdInitStruct->SDIO_Response + | SDIO_CmdInitStruct->SDIO_Wait | SDIO_CmdInitStruct->SDIO_CPSM; + + /* Write to SDIO CMD */ + SDIO->CMD = tmpreg; +} + +/** + * @brief Fills each SDIO_CmdInitStruct member with its default value. + * @param SDIO_CmdInitStruct: pointer to an SDIO_CmdInitTypeDef + * structure which will be initialized. + * @retval None + */ +void SDIO_CmdStructInit(SDIO_CmdInitTypeDef* SDIO_CmdInitStruct) +{ + /* SDIO_CmdInitStruct members default value */ + SDIO_CmdInitStruct->SDIO_Argument = 0x00; + SDIO_CmdInitStruct->SDIO_CmdIndex = 0x00; + SDIO_CmdInitStruct->SDIO_Response = SDIO_Response_No; + SDIO_CmdInitStruct->SDIO_Wait = SDIO_Wait_No; + SDIO_CmdInitStruct->SDIO_CPSM = SDIO_CPSM_Disable; +} + +/** + * @brief Returns command index of last command for which response received. + * @param None + * @retval Returns the command index of the last command response received. + */ +uint8_t SDIO_GetCommandResponse(void) +{ + return (uint8_t)(SDIO->RESPCMD); +} + +/** + * @brief Returns response received from the card for the last command. + * @param SDIO_RESP: Specifies the SDIO response register. + * This parameter can be one of the following values: + * @arg SDIO_RESP1: Response Register 1 + * @arg SDIO_RESP2: Response Register 2 + * @arg SDIO_RESP3: Response Register 3 + * @arg SDIO_RESP4: Response Register 4 + * @retval The Corresponding response register value. + */ +uint32_t SDIO_GetResponse(uint32_t SDIO_RESP) +{ + __IO uint32_t tmp = 0; + + /* Check the parameters */ + assert_param(IS_SDIO_RESP(SDIO_RESP)); + + tmp = SDIO_RESP_ADDR + SDIO_RESP; + + return (*(__IO uint32_t *) tmp); +} + +/** + * @} + */ + +/** @defgroup SDIO_Group3 Data path state machine (DPSM) management functions + * @brief Data path state machine (DPSM) management functions + * +@verbatim + =============================================================================== + ##### Data path state machine (DPSM) management functions ##### + =============================================================================== + + This section provide functions allowing to program and read the Data path + state machine (DPSM). + +@endverbatim + * @{ + */ + +/** + * @brief Initializes the SDIO data path according to the specified + * parameters in the SDIO_DataInitStruct. + * @param SDIO_DataInitStruct : pointer to a SDIO_DataInitTypeDef structure + * that contains the configuration information for the SDIO command. + * @retval None + */ +void SDIO_DataConfig(SDIO_DataInitTypeDef* SDIO_DataInitStruct) +{ + uint32_t tmpreg = 0; + + /* Check the parameters */ + assert_param(IS_SDIO_DATA_LENGTH(SDIO_DataInitStruct->SDIO_DataLength)); + assert_param(IS_SDIO_BLOCK_SIZE(SDIO_DataInitStruct->SDIO_DataBlockSize)); + assert_param(IS_SDIO_TRANSFER_DIR(SDIO_DataInitStruct->SDIO_TransferDir)); + assert_param(IS_SDIO_TRANSFER_MODE(SDIO_DataInitStruct->SDIO_TransferMode)); + assert_param(IS_SDIO_DPSM(SDIO_DataInitStruct->SDIO_DPSM)); + +/*---------------------------- SDIO DTIMER Configuration ---------------------*/ + /* Set the SDIO Data TimeOut value */ + SDIO->DTIMER = SDIO_DataInitStruct->SDIO_DataTimeOut; + +/*---------------------------- SDIO DLEN Configuration -----------------------*/ + /* Set the SDIO DataLength value */ + SDIO->DLEN = SDIO_DataInitStruct->SDIO_DataLength; + +/*---------------------------- SDIO DCTRL Configuration ----------------------*/ + /* Get the SDIO DCTRL value */ + tmpreg = SDIO->DCTRL; + /* Clear DEN, DTMODE, DTDIR and DBCKSIZE bits */ + tmpreg &= DCTRL_CLEAR_MASK; + /* Set DEN bit according to SDIO_DPSM value */ + /* Set DTMODE bit according to SDIO_TransferMode value */ + /* Set DTDIR bit according to SDIO_TransferDir value */ + /* Set DBCKSIZE bits according to SDIO_DataBlockSize value */ + tmpreg |= (uint32_t)SDIO_DataInitStruct->SDIO_DataBlockSize | SDIO_DataInitStruct->SDIO_TransferDir + | SDIO_DataInitStruct->SDIO_TransferMode | SDIO_DataInitStruct->SDIO_DPSM; + + /* Write to SDIO DCTRL */ + SDIO->DCTRL = tmpreg; +} + +/** + * @brief Fills each SDIO_DataInitStruct member with its default value. + * @param SDIO_DataInitStruct: pointer to an SDIO_DataInitTypeDef structure + * which will be initialized. + * @retval None + */ +void SDIO_DataStructInit(SDIO_DataInitTypeDef* SDIO_DataInitStruct) +{ + /* SDIO_DataInitStruct members default value */ + SDIO_DataInitStruct->SDIO_DataTimeOut = 0xFFFFFFFF; + SDIO_DataInitStruct->SDIO_DataLength = 0x00; + SDIO_DataInitStruct->SDIO_DataBlockSize = SDIO_DataBlockSize_1b; + SDIO_DataInitStruct->SDIO_TransferDir = SDIO_TransferDir_ToCard; + SDIO_DataInitStruct->SDIO_TransferMode = SDIO_TransferMode_Block; + SDIO_DataInitStruct->SDIO_DPSM = SDIO_DPSM_Disable; +} + +/** + * @brief Returns number of remaining data bytes to be transferred. + * @param None + * @retval Number of remaining data bytes to be transferred + */ +uint32_t SDIO_GetDataCounter(void) +{ + return SDIO->DCOUNT; +} + +/** + * @brief Read one data word from Rx FIFO. + * @param None + * @retval Data received + */ +uint32_t SDIO_ReadData(void) +{ + return SDIO->FIFO; +} + +/** + * @brief Write one data word to Tx FIFO. + * @param Data: 32-bit data word to write. + * @retval None + */ +void SDIO_WriteData(uint32_t Data) +{ + SDIO->FIFO = Data; +} + +/** + * @brief Returns the number of words left to be written to or read from FIFO. + * @param None + * @retval Remaining number of words. + */ +uint32_t SDIO_GetFIFOCount(void) +{ + return SDIO->FIFOCNT; +} + +/** + * @} + */ + +/** @defgroup SDIO_Group4 SDIO IO Cards mode management functions + * @brief SDIO IO Cards mode management functions + * +@verbatim + =============================================================================== + ##### SDIO IO Cards mode management functions ##### + =============================================================================== + + This section provide functions allowing to program and read the SDIO IO Cards. + +@endverbatim + * @{ + */ + +/** + * @brief Starts the SD I/O Read Wait operation. + * @param NewState: new state of the Start SDIO Read Wait operation. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void SDIO_StartSDIOReadWait(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + *(__IO uint32_t *) DCTRL_RWSTART_BB = (uint32_t) NewState; +} + +/** + * @brief Stops the SD I/O Read Wait operation. + * @param NewState: new state of the Stop SDIO Read Wait operation. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void SDIO_StopSDIOReadWait(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + *(__IO uint32_t *) DCTRL_RWSTOP_BB = (uint32_t) NewState; +} + +/** + * @brief Sets one of the two options of inserting read wait interval. + * @param SDIO_ReadWaitMode: SD I/O Read Wait operation mode. + * This parameter can be: + * @arg SDIO_ReadWaitMode_CLK: Read Wait control by stopping SDIOCLK + * @arg SDIO_ReadWaitMode_DATA2: Read Wait control using SDIO_DATA2 + * @retval None + */ +void SDIO_SetSDIOReadWaitMode(uint32_t SDIO_ReadWaitMode) +{ + /* Check the parameters */ + assert_param(IS_SDIO_READWAIT_MODE(SDIO_ReadWaitMode)); + + *(__IO uint32_t *) DCTRL_RWMOD_BB = SDIO_ReadWaitMode; +} + +/** + * @brief Enables or disables the SD I/O Mode Operation. + * @param NewState: new state of SDIO specific operation. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void SDIO_SetSDIOOperation(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + *(__IO uint32_t *) DCTRL_SDIOEN_BB = (uint32_t)NewState; +} + +/** + * @brief Enables or disables the SD I/O Mode suspend command sending. + * @param NewState: new state of the SD I/O Mode suspend command. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void SDIO_SendSDIOSuspendCmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + *(__IO uint32_t *) CMD_SDIOSUSPEND_BB = (uint32_t)NewState; +} + +/** + * @} + */ + +/** @defgroup SDIO_Group5 CE-ATA mode management functions + * @brief CE-ATA mode management functions + * +@verbatim + =============================================================================== + ##### CE-ATA mode management functions ##### + =============================================================================== + + This section provide functions allowing to program and read the CE-ATA card. + +@endverbatim + * @{ + */ + +/** + * @brief Enables or disables the command completion signal. + * @param NewState: new state of command completion signal. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void SDIO_CommandCompletionCmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + *(__IO uint32_t *) CMD_ENCMDCOMPL_BB = (uint32_t)NewState; +} + +/** + * @brief Enables or disables the CE-ATA interrupt. + * @param NewState: new state of CE-ATA interrupt. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void SDIO_CEATAITCmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + *(__IO uint32_t *) CMD_NIEN_BB = (uint32_t)((~((uint32_t)NewState)) & ((uint32_t)0x1)); +} + +/** + * @brief Sends CE-ATA command (CMD61). + * @param NewState: new state of CE-ATA command. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void SDIO_SendCEATACmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + *(__IO uint32_t *) CMD_ATACMD_BB = (uint32_t)NewState; +} + +/** + * @} + */ + +/** @defgroup SDIO_Group6 DMA transfers management functions + * @brief DMA transfers management functions + * +@verbatim + =============================================================================== + ##### DMA transfers management functions ##### + =============================================================================== + + This section provide functions allowing to program SDIO DMA transfer. + +@endverbatim + * @{ + */ + +/** + * @brief Enables or disables the SDIO DMA request. + * @param NewState: new state of the selected SDIO DMA request. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void SDIO_DMACmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + *(__IO uint32_t *) DCTRL_DMAEN_BB = (uint32_t)NewState; +} + +/** + * @} + */ + +/** @defgroup SDIO_Group7 Interrupts and flags management functions + * @brief Interrupts and flags management functions + * +@verbatim + =============================================================================== + ##### Interrupts and flags management functions ##### + =============================================================================== + + +@endverbatim + * @{ + */ + +/** + * @brief Enables or disables the SDIO interrupts. + * @param SDIO_IT: specifies the SDIO interrupt sources to be enabled or disabled. + * This parameter can be one or a combination of the following values: + * @arg SDIO_IT_CCRCFAIL: Command response received (CRC check failed) interrupt + * @arg SDIO_IT_DCRCFAIL: Data block sent/received (CRC check failed) interrupt + * @arg SDIO_IT_CTIMEOUT: Command response timeout interrupt + * @arg SDIO_IT_DTIMEOUT: Data timeout interrupt + * @arg SDIO_IT_TXUNDERR: Transmit FIFO underrun error interrupt + * @arg SDIO_IT_RXOVERR: Received FIFO overrun error interrupt + * @arg SDIO_IT_CMDREND: Command response received (CRC check passed) interrupt + * @arg SDIO_IT_CMDSENT: Command sent (no response required) interrupt + * @arg SDIO_IT_DATAEND: Data end (data counter, SDIDCOUNT, is zero) interrupt + * @arg SDIO_IT_STBITERR: Start bit not detected on all data signals in wide + * bus mode interrupt + * @arg SDIO_IT_DBCKEND: Data block sent/received (CRC check passed) interrupt + * @arg SDIO_IT_CMDACT: Command transfer in progress interrupt + * @arg SDIO_IT_TXACT: Data transmit in progress interrupt + * @arg SDIO_IT_RXACT: Data receive in progress interrupt + * @arg SDIO_IT_TXFIFOHE: Transmit FIFO Half Empty interrupt + * @arg SDIO_IT_RXFIFOHF: Receive FIFO Half Full interrupt + * @arg SDIO_IT_TXFIFOF: Transmit FIFO full interrupt + * @arg SDIO_IT_RXFIFOF: Receive FIFO full interrupt + * @arg SDIO_IT_TXFIFOE: Transmit FIFO empty interrupt + * @arg SDIO_IT_RXFIFOE: Receive FIFO empty interrupt + * @arg SDIO_IT_TXDAVL: Data available in transmit FIFO interrupt + * @arg SDIO_IT_RXDAVL: Data available in receive FIFO interrupt + * @arg SDIO_IT_SDIOIT: SD I/O interrupt received interrupt + * @arg SDIO_IT_CEATAEND: CE-ATA command completion signal received for CMD61 interrupt + * @param NewState: new state of the specified SDIO interrupts. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void SDIO_ITConfig(uint32_t SDIO_IT, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_SDIO_IT(SDIO_IT)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the SDIO interrupts */ + SDIO->MASK |= SDIO_IT; + } + else + { + /* Disable the SDIO interrupts */ + SDIO->MASK &= ~SDIO_IT; + } +} + +/** + * @brief Checks whether the specified SDIO flag is set or not. + * @param SDIO_FLAG: specifies the flag to check. + * This parameter can be one of the following values: + * @arg SDIO_FLAG_CCRCFAIL: Command response received (CRC check failed) + * @arg SDIO_FLAG_DCRCFAIL: Data block sent/received (CRC check failed) + * @arg SDIO_FLAG_CTIMEOUT: Command response timeout + * @arg SDIO_FLAG_DTIMEOUT: Data timeout + * @arg SDIO_FLAG_TXUNDERR: Transmit FIFO underrun error + * @arg SDIO_FLAG_RXOVERR: Received FIFO overrun error + * @arg SDIO_FLAG_CMDREND: Command response received (CRC check passed) + * @arg SDIO_FLAG_CMDSENT: Command sent (no response required) + * @arg SDIO_FLAG_DATAEND: Data end (data counter, SDIDCOUNT, is zero) + * @arg SDIO_FLAG_STBITERR: Start bit not detected on all data signals in wide bus mode. + * @arg SDIO_FLAG_DBCKEND: Data block sent/received (CRC check passed) + * @arg SDIO_FLAG_CMDACT: Command transfer in progress + * @arg SDIO_FLAG_TXACT: Data transmit in progress + * @arg SDIO_FLAG_RXACT: Data receive in progress + * @arg SDIO_FLAG_TXFIFOHE: Transmit FIFO Half Empty + * @arg SDIO_FLAG_RXFIFOHF: Receive FIFO Half Full + * @arg SDIO_FLAG_TXFIFOF: Transmit FIFO full + * @arg SDIO_FLAG_RXFIFOF: Receive FIFO full + * @arg SDIO_FLAG_TXFIFOE: Transmit FIFO empty + * @arg SDIO_FLAG_RXFIFOE: Receive FIFO empty + * @arg SDIO_FLAG_TXDAVL: Data available in transmit FIFO + * @arg SDIO_FLAG_RXDAVL: Data available in receive FIFO + * @arg SDIO_FLAG_SDIOIT: SD I/O interrupt received + * @arg SDIO_FLAG_CEATAEND: CE-ATA command completion signal received for CMD61 + * @retval The new state of SDIO_FLAG (SET or RESET). + */ +FlagStatus SDIO_GetFlagStatus(uint32_t SDIO_FLAG) +{ + FlagStatus bitstatus = RESET; + + /* Check the parameters */ + assert_param(IS_SDIO_FLAG(SDIO_FLAG)); + + if ((SDIO->STA & SDIO_FLAG) != (uint32_t)RESET) + { + bitstatus = SET; + } + else + { + bitstatus = RESET; + } + return bitstatus; +} + +/** + * @brief Clears the SDIO's pending flags. + * @param SDIO_FLAG: specifies the flag to clear. + * This parameter can be one or a combination of the following values: + * @arg SDIO_FLAG_CCRCFAIL: Command response received (CRC check failed) + * @arg SDIO_FLAG_DCRCFAIL: Data block sent/received (CRC check failed) + * @arg SDIO_FLAG_CTIMEOUT: Command response timeout + * @arg SDIO_FLAG_DTIMEOUT: Data timeout + * @arg SDIO_FLAG_TXUNDERR: Transmit FIFO underrun error + * @arg SDIO_FLAG_RXOVERR: Received FIFO overrun error + * @arg SDIO_FLAG_CMDREND: Command response received (CRC check passed) + * @arg SDIO_FLAG_CMDSENT: Command sent (no response required) + * @arg SDIO_FLAG_DATAEND: Data end (data counter, SDIDCOUNT, is zero) + * @arg SDIO_FLAG_STBITERR: Start bit not detected on all data signals in wide bus mode + * @arg SDIO_FLAG_DBCKEND: Data block sent/received (CRC check passed) + * @arg SDIO_FLAG_SDIOIT: SD I/O interrupt received + * @arg SDIO_FLAG_CEATAEND: CE-ATA command completion signal received for CMD61 + * @retval None + */ +void SDIO_ClearFlag(uint32_t SDIO_FLAG) +{ + /* Check the parameters */ + assert_param(IS_SDIO_CLEAR_FLAG(SDIO_FLAG)); + + SDIO->ICR = SDIO_FLAG; +} + +/** + * @brief Checks whether the specified SDIO interrupt has occurred or not. + * @param SDIO_IT: specifies the SDIO interrupt source to check. + * This parameter can be one of the following values: + * @arg SDIO_IT_CCRCFAIL: Command response received (CRC check failed) interrupt + * @arg SDIO_IT_DCRCFAIL: Data block sent/received (CRC check failed) interrupt + * @arg SDIO_IT_CTIMEOUT: Command response timeout interrupt + * @arg SDIO_IT_DTIMEOUT: Data timeout interrupt + * @arg SDIO_IT_TXUNDERR: Transmit FIFO underrun error interrupt + * @arg SDIO_IT_RXOVERR: Received FIFO overrun error interrupt + * @arg SDIO_IT_CMDREND: Command response received (CRC check passed) interrupt + * @arg SDIO_IT_CMDSENT: Command sent (no response required) interrupt + * @arg SDIO_IT_DATAEND: Data end (data counter, SDIDCOUNT, is zero) interrupt + * @arg SDIO_IT_STBITERR: Start bit not detected on all data signals in wide + * bus mode interrupt + * @arg SDIO_IT_DBCKEND: Data block sent/received (CRC check passed) interrupt + * @arg SDIO_IT_CMDACT: Command transfer in progress interrupt + * @arg SDIO_IT_TXACT: Data transmit in progress interrupt + * @arg SDIO_IT_RXACT: Data receive in progress interrupt + * @arg SDIO_IT_TXFIFOHE: Transmit FIFO Half Empty interrupt + * @arg SDIO_IT_RXFIFOHF: Receive FIFO Half Full interrupt + * @arg SDIO_IT_TXFIFOF: Transmit FIFO full interrupt + * @arg SDIO_IT_RXFIFOF: Receive FIFO full interrupt + * @arg SDIO_IT_TXFIFOE: Transmit FIFO empty interrupt + * @arg SDIO_IT_RXFIFOE: Receive FIFO empty interrupt + * @arg SDIO_IT_TXDAVL: Data available in transmit FIFO interrupt + * @arg SDIO_IT_RXDAVL: Data available in receive FIFO interrupt + * @arg SDIO_IT_SDIOIT: SD I/O interrupt received interrupt + * @arg SDIO_IT_CEATAEND: CE-ATA command completion signal received for CMD61 interrupt + * @retval The new state of SDIO_IT (SET or RESET). + */ +ITStatus SDIO_GetITStatus(uint32_t SDIO_IT) +{ + ITStatus bitstatus = RESET; + + /* Check the parameters */ + assert_param(IS_SDIO_GET_IT(SDIO_IT)); + if ((SDIO->STA & SDIO_IT) != (uint32_t)RESET) + { + bitstatus = SET; + } + else + { + bitstatus = RESET; + } + return bitstatus; +} + +/** + * @brief Clears the SDIO's interrupt pending bits. + * @param SDIO_IT: specifies the interrupt pending bit to clear. + * This parameter can be one or a combination of the following values: + * @arg SDIO_IT_CCRCFAIL: Command response received (CRC check failed) interrupt + * @arg SDIO_IT_DCRCFAIL: Data block sent/received (CRC check failed) interrupt + * @arg SDIO_IT_CTIMEOUT: Command response timeout interrupt + * @arg SDIO_IT_DTIMEOUT: Data timeout interrupt + * @arg SDIO_IT_TXUNDERR: Transmit FIFO underrun error interrupt + * @arg SDIO_IT_RXOVERR: Received FIFO overrun error interrupt + * @arg SDIO_IT_CMDREND: Command response received (CRC check passed) interrupt + * @arg SDIO_IT_CMDSENT: Command sent (no response required) interrupt + * @arg SDIO_IT_DATAEND: Data end (data counter, SDIO_DCOUNT, is zero) interrupt + * @arg SDIO_IT_STBITERR: Start bit not detected on all data signals in wide + * bus mode interrupt + * @arg SDIO_IT_SDIOIT: SD I/O interrupt received interrupt + * @arg SDIO_IT_CEATAEND: CE-ATA command completion signal received for CMD61 + * @retval None + */ +void SDIO_ClearITPendingBit(uint32_t SDIO_IT) +{ + /* Check the parameters */ + assert_param(IS_SDIO_CLEAR_IT(SDIO_IT)); + + SDIO->ICR = SDIO_IT; +} + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/src/stm32f4xx_spi.c b/FWLIB/src/stm32f4xx_spi.c new file mode 100644 index 0000000..fa70307 --- /dev/null +++ b/FWLIB/src/stm32f4xx_spi.c @@ -0,0 +1,1319 @@ +/** + ****************************************************************************** + * @file stm32f4xx_spi.c + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file provides firmware functions to manage the following + * functionalities of the Serial peripheral interface (SPI): + * + Initialization and Configuration + * + Data transfers functions + * + Hardware CRC Calculation + * + DMA transfers management + * + Interrupts and flags management + * +@verbatim + + =================================================================== + ##### How to use this driver ##### + =================================================================== + [..] + (#) Enable peripheral clock using the following functions + RCC_APB2PeriphClockCmd(RCC_APB2Periph_SPI1, ENABLE) for SPI1 + RCC_APB1PeriphClockCmd(RCC_APB1Periph_SPI2, ENABLE) for SPI2 + RCC_APB1PeriphResetCmd(RCC_APB1Periph_SPI3, ENABLE) for SPI3 + RCC_APB1PeriphResetCmd(RCC_APB1Periph_SPI3, ENABLE) for SPI4 + RCC_APB1PeriphResetCmd(RCC_APB1Periph_SPI3, ENABLE) for SPI5 + RCC_APB1PeriphResetCmd(RCC_APB1Periph_SPI3, ENABLE) for SPI6. + + (#) Enable SCK, MOSI, MISO and NSS GPIO clocks using RCC_AHB1PeriphClockCmd() + function. In I2S mode, if an external clock source is used then the I2S + CKIN pin GPIO clock should also be enabled. + + (#) Peripherals alternate function: + (++) Connect the pin to the desired peripherals' Alternate Function (AF) + using GPIO_PinAFConfig() function + (++) Configure the desired pin in alternate function by: + GPIO_InitStruct->GPIO_Mode = GPIO_Mode_AF + (++) Select the type, pull-up/pull-down and output speed via GPIO_PuPd, + GPIO_OType and GPIO_Speed members + (++) Call GPIO_Init() function In I2S mode, if an external clock source is + used then the I2S CKIN pin should be also configured in Alternate + function Push-pull pull-up mode. + + (#) Program the Polarity, Phase, First Data, Baud Rate Prescaler, Slave + Management, Peripheral Mode and CRC Polynomial values using the SPI_Init() + function. + In I2S mode, program the Mode, Standard, Data Format, MCLK Output, Audio + frequency and Polarity using I2S_Init() function. For I2S mode, make sure + that either: + (++) I2S PLL is configured using the functions + RCC_I2SCLKConfig(RCC_I2S2CLKSource_PLLI2S), RCC_PLLI2SCmd(ENABLE) and + RCC_GetFlagStatus(RCC_FLAG_PLLI2SRDY); or + (++) External clock source is configured using the function + RCC_I2SCLKConfig(RCC_I2S2CLKSource_Ext) and after setting correctly + the define constant I2S_EXTERNAL_CLOCK_VAL in the stm32f4xx_conf.h file. + + (#) Enable the NVIC and the corresponding interrupt using the function + SPI_ITConfig() if you need to use interrupt mode. + + (#) When using the DMA mode + (++) Configure the DMA using DMA_Init() function + (++) Active the needed channel Request using SPI_I2S_DMACmd() function + + (#) Enable the SPI using the SPI_Cmd() function or enable the I2S using + I2S_Cmd(). + + (#) Enable the DMA using the DMA_Cmd() function when using DMA mode. + + (#) Optionally, you can enable/configure the following parameters without + re-initialization (i.e there is no need to call again SPI_Init() function): + (++) When bidirectional mode (SPI_Direction_1Line_Rx or SPI_Direction_1Line_Tx) + is programmed as Data direction parameter using the SPI_Init() function + it can be possible to switch between SPI_Direction_Tx or SPI_Direction_Rx + using the SPI_BiDirectionalLineConfig() function. + (++) When SPI_NSS_Soft is selected as Slave Select Management parameter + using the SPI_Init() function it can be possible to manage the + NSS internal signal using the SPI_NSSInternalSoftwareConfig() function. + (++) Reconfigure the data size using the SPI_DataSizeConfig() function + (++) Enable or disable the SS output using the SPI_SSOutputCmd() function + + (#) To use the CRC Hardware calculation feature refer to the Peripheral + CRC hardware Calculation subsection. + + + [..] It is possible to use SPI in I2S full duplex mode, in this case, each SPI + peripheral is able to manage sending and receiving data simultaneously + using two data lines. Each SPI peripheral has an extended block called I2Sxext + (ie. I2S2ext for SPI2 and I2S3ext for SPI3). + The extension block is not a full SPI IP, it is used only as I2S slave to + implement full duplex mode. The extension block uses the same clock sources + as its master. + To configure I2S full duplex you have to: + + (#) Configure SPIx in I2S mode (I2S_Init() function) as described above. + + (#) Call the I2S_FullDuplexConfig() function using the same strucutre passed to + I2S_Init() function. + + (#) Call I2S_Cmd() for SPIx then for its extended block. + + (#) To configure interrupts or DMA requests and to get/clear flag status, + use I2Sxext instance for the extension block. + + [..] Functions that can be called with I2Sxext instances are: I2S_Cmd(), + I2S_FullDuplexConfig(), SPI_I2S_ReceiveData(), SPI_I2S_SendData(), + SPI_I2S_DMACmd(), SPI_I2S_ITConfig(), SPI_I2S_GetFlagStatus(), + SPI_I2S_ClearFlag(), SPI_I2S_GetITStatus() and SPI_I2S_ClearITPendingBit(). + + Example: To use SPI3 in Full duplex mode (SPI3 is Master Tx, I2S3ext is Slave Rx): + + RCC_APB1PeriphClockCmd(RCC_APB1Periph_SPI3, ENABLE); + I2S_StructInit(&I2SInitStruct); + I2SInitStruct.Mode = I2S_Mode_MasterTx; + I2S_Init(SPI3, &I2SInitStruct); + I2S_FullDuplexConfig(SPI3ext, &I2SInitStruct) + I2S_Cmd(SPI3, ENABLE); + I2S_Cmd(SPI3ext, ENABLE); + ... + while (SPI_I2S_GetFlagStatus(SPI2, SPI_FLAG_TXE) == RESET) + {} + SPI_I2S_SendData(SPI3, txdata[i]); + ... + while (SPI_I2S_GetFlagStatus(I2S3ext, SPI_FLAG_RXNE) == RESET) + {} + rxdata[i] = SPI_I2S_ReceiveData(I2S3ext); + ... + + [..] + (@) In I2S mode: if an external clock is used as source clock for the I2S, + then the define I2S_EXTERNAL_CLOCK_VAL in file stm32f4xx_conf.h should + be enabled and set to the value of the source clock frequency (in Hz). + + (@) In SPI mode: To use the SPI TI mode, call the function SPI_TIModeCmd() + just after calling the function SPI_Init(). + +@endverbatim + * + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx_spi.h" +#include "stm32f4xx_rcc.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @defgroup SPI + * @brief SPI driver modules + * @{ + */ + +/* Private typedef -----------------------------------------------------------*/ +/* Private define ------------------------------------------------------------*/ + +/* SPI registers Masks */ +#define CR1_CLEAR_MASK ((uint16_t)0x3040) +#define I2SCFGR_CLEAR_MASK ((uint16_t)0xF040) + +/* RCC PLLs masks */ +#define PLLCFGR_PPLR_MASK ((uint32_t)0x70000000) +#define PLLCFGR_PPLN_MASK ((uint32_t)0x00007FC0) + +#define SPI_CR2_FRF ((uint16_t)0x0010) +#define SPI_SR_TIFRFE ((uint16_t)0x0100) + +/* Private macro -------------------------------------------------------------*/ +/* Private variables ---------------------------------------------------------*/ +/* Private function prototypes -----------------------------------------------*/ +/* Private functions ---------------------------------------------------------*/ + +/** @defgroup SPI_Private_Functions + * @{ + */ + +/** @defgroup SPI_Group1 Initialization and Configuration functions + * @brief Initialization and Configuration functions + * +@verbatim + =============================================================================== + ##### Initialization and Configuration functions ##### + =============================================================================== + [..] This section provides a set of functions allowing to initialize the SPI + Direction, SPI Mode, SPI Data Size, SPI Polarity, SPI Phase, SPI NSS + Management, SPI Baud Rate Prescaler, SPI First Bit and SPI CRC Polynomial. + + [..] The SPI_Init() function follows the SPI configuration procedures for Master + mode and Slave mode (details for these procedures are available in reference + manual (RM0090)). + +@endverbatim + * @{ + */ + +/** + * @brief De-initialize the SPIx peripheral registers to their default reset values. + * @param SPIx: To select the SPIx/I2Sx peripheral, where x can be: 1, 2, 3, 4, 5 or 6 + * in SPI mode or 2 or 3 in I2S mode. + * + * @note The extended I2S blocks (ie. I2S2ext and I2S3ext blocks) are de-initialized + * when the relative I2S peripheral is de-initialized (the extended block's clock + * is managed by the I2S peripheral clock). + * + * @retval None + */ +void SPI_I2S_DeInit(SPI_TypeDef* SPIx) +{ + /* Check the parameters */ + assert_param(IS_SPI_ALL_PERIPH(SPIx)); + + if (SPIx == SPI1) + { + /* Enable SPI1 reset state */ + RCC_APB2PeriphResetCmd(RCC_APB2Periph_SPI1, ENABLE); + /* Release SPI1 from reset state */ + RCC_APB2PeriphResetCmd(RCC_APB2Periph_SPI1, DISABLE); + } + else if (SPIx == SPI2) + { + /* Enable SPI2 reset state */ + RCC_APB1PeriphResetCmd(RCC_APB1Periph_SPI2, ENABLE); + /* Release SPI2 from reset state */ + RCC_APB1PeriphResetCmd(RCC_APB1Periph_SPI2, DISABLE); + } + else if (SPIx == SPI3) + { + /* Enable SPI3 reset state */ + RCC_APB1PeriphResetCmd(RCC_APB1Periph_SPI3, ENABLE); + /* Release SPI3 from reset state */ + RCC_APB1PeriphResetCmd(RCC_APB1Periph_SPI3, DISABLE); + } + else if (SPIx == SPI4) + { + /* Enable SPI4 reset state */ + RCC_APB2PeriphResetCmd(RCC_APB2Periph_SPI4, ENABLE); + /* Release SPI4 from reset state */ + RCC_APB2PeriphResetCmd(RCC_APB2Periph_SPI4, DISABLE); + } + else if (SPIx == SPI5) + { + /* Enable SPI5 reset state */ + RCC_APB2PeriphResetCmd(RCC_APB2Periph_SPI5, ENABLE); + /* Release SPI5 from reset state */ + RCC_APB2PeriphResetCmd(RCC_APB2Periph_SPI5, DISABLE); + } + else + { + if (SPIx == SPI6) + { + /* Enable SPI6 reset state */ + RCC_APB2PeriphResetCmd(RCC_APB2Periph_SPI6, ENABLE); + /* Release SPI6 from reset state */ + RCC_APB2PeriphResetCmd(RCC_APB2Periph_SPI6, DISABLE); + } + } +} + +/** + * @brief Initializes the SPIx peripheral according to the specified + * parameters in the SPI_InitStruct. + * @param SPIx: where x can be 1, 2, 3, 4, 5 or 6 to select the SPI peripheral. + * @param SPI_InitStruct: pointer to a SPI_InitTypeDef structure that + * contains the configuration information for the specified SPI peripheral. + * @retval None + */ +void SPI_Init(SPI_TypeDef* SPIx, SPI_InitTypeDef* SPI_InitStruct) +{ + uint16_t tmpreg = 0; + + /* check the parameters */ + assert_param(IS_SPI_ALL_PERIPH(SPIx)); + + /* Check the SPI parameters */ + assert_param(IS_SPI_DIRECTION_MODE(SPI_InitStruct->SPI_Direction)); + assert_param(IS_SPI_MODE(SPI_InitStruct->SPI_Mode)); + assert_param(IS_SPI_DATASIZE(SPI_InitStruct->SPI_DataSize)); + assert_param(IS_SPI_CPOL(SPI_InitStruct->SPI_CPOL)); + assert_param(IS_SPI_CPHA(SPI_InitStruct->SPI_CPHA)); + assert_param(IS_SPI_NSS(SPI_InitStruct->SPI_NSS)); + assert_param(IS_SPI_BAUDRATE_PRESCALER(SPI_InitStruct->SPI_BaudRatePrescaler)); + assert_param(IS_SPI_FIRST_BIT(SPI_InitStruct->SPI_FirstBit)); + assert_param(IS_SPI_CRC_POLYNOMIAL(SPI_InitStruct->SPI_CRCPolynomial)); + +/*---------------------------- SPIx CR1 Configuration ------------------------*/ + /* Get the SPIx CR1 value */ + tmpreg = SPIx->CR1; + /* Clear BIDIMode, BIDIOE, RxONLY, SSM, SSI, LSBFirst, BR, MSTR, CPOL and CPHA bits */ + tmpreg &= CR1_CLEAR_MASK; + /* Configure SPIx: direction, NSS management, first transmitted bit, BaudRate prescaler + master/salve mode, CPOL and CPHA */ + /* Set BIDImode, BIDIOE and RxONLY bits according to SPI_Direction value */ + /* Set SSM, SSI and MSTR bits according to SPI_Mode and SPI_NSS values */ + /* Set LSBFirst bit according to SPI_FirstBit value */ + /* Set BR bits according to SPI_BaudRatePrescaler value */ + /* Set CPOL bit according to SPI_CPOL value */ + /* Set CPHA bit according to SPI_CPHA value */ + tmpreg |= (uint16_t)((uint32_t)SPI_InitStruct->SPI_Direction | SPI_InitStruct->SPI_Mode | + SPI_InitStruct->SPI_DataSize | SPI_InitStruct->SPI_CPOL | + SPI_InitStruct->SPI_CPHA | SPI_InitStruct->SPI_NSS | + SPI_InitStruct->SPI_BaudRatePrescaler | SPI_InitStruct->SPI_FirstBit); + /* Write to SPIx CR1 */ + SPIx->CR1 = tmpreg; + + /* Activate the SPI mode (Reset I2SMOD bit in I2SCFGR register) */ + SPIx->I2SCFGR &= (uint16_t)~((uint16_t)SPI_I2SCFGR_I2SMOD); +/*---------------------------- SPIx CRCPOLY Configuration --------------------*/ + /* Write to SPIx CRCPOLY */ + SPIx->CRCPR = SPI_InitStruct->SPI_CRCPolynomial; +} + +/** + * @brief Initializes the SPIx peripheral according to the specified + * parameters in the I2S_InitStruct. + * @param SPIx: where x can be 2 or 3 to select the SPI peripheral (configured in I2S mode). + * @param I2S_InitStruct: pointer to an I2S_InitTypeDef structure that + * contains the configuration information for the specified SPI peripheral + * configured in I2S mode. + * + * @note The function calculates the optimal prescaler needed to obtain the most + * accurate audio frequency (depending on the I2S clock source, the PLL values + * and the product configuration). But in case the prescaler value is greater + * than 511, the default value (0x02) will be configured instead. + * + * @note if an external clock is used as source clock for the I2S, then the define + * I2S_EXTERNAL_CLOCK_VAL in file stm32f4xx_conf.h should be enabled and set + * to the value of the the source clock frequency (in Hz). + * + * @retval None + */ +void I2S_Init(SPI_TypeDef* SPIx, I2S_InitTypeDef* I2S_InitStruct) +{ + uint16_t tmpreg = 0, i2sdiv = 2, i2sodd = 0, packetlength = 1; + uint32_t tmp = 0, i2sclk = 0; +#ifndef I2S_EXTERNAL_CLOCK_VAL + uint32_t pllm = 0, plln = 0, pllr = 0; +#endif /* I2S_EXTERNAL_CLOCK_VAL */ + + /* Check the I2S parameters */ + assert_param(IS_SPI_23_PERIPH(SPIx)); + assert_param(IS_I2S_MODE(I2S_InitStruct->I2S_Mode)); + assert_param(IS_I2S_STANDARD(I2S_InitStruct->I2S_Standard)); + assert_param(IS_I2S_DATA_FORMAT(I2S_InitStruct->I2S_DataFormat)); + assert_param(IS_I2S_MCLK_OUTPUT(I2S_InitStruct->I2S_MCLKOutput)); + assert_param(IS_I2S_AUDIO_FREQ(I2S_InitStruct->I2S_AudioFreq)); + assert_param(IS_I2S_CPOL(I2S_InitStruct->I2S_CPOL)); + +/*----------------------- SPIx I2SCFGR & I2SPR Configuration -----------------*/ + /* Clear I2SMOD, I2SE, I2SCFG, PCMSYNC, I2SSTD, CKPOL, DATLEN and CHLEN bits */ + SPIx->I2SCFGR &= I2SCFGR_CLEAR_MASK; + SPIx->I2SPR = 0x0002; + + /* Get the I2SCFGR register value */ + tmpreg = SPIx->I2SCFGR; + + /* If the default value has to be written, reinitialize i2sdiv and i2sodd*/ + if(I2S_InitStruct->I2S_AudioFreq == I2S_AudioFreq_Default) + { + i2sodd = (uint16_t)0; + i2sdiv = (uint16_t)2; + } + /* If the requested audio frequency is not the default, compute the prescaler */ + else + { + /* Check the frame length (For the Prescaler computing) *******************/ + if(I2S_InitStruct->I2S_DataFormat == I2S_DataFormat_16b) + { + /* Packet length is 16 bits */ + packetlength = 1; + } + else + { + /* Packet length is 32 bits */ + packetlength = 2; + } + + /* Get I2S source Clock frequency ****************************************/ + + /* If an external I2S clock has to be used, this define should be set + in the project configuration or in the stm32f4xx_conf.h file */ + #ifdef I2S_EXTERNAL_CLOCK_VAL + /* Set external clock as I2S clock source */ + if ((RCC->CFGR & RCC_CFGR_I2SSRC) == 0) + { + RCC->CFGR |= (uint32_t)RCC_CFGR_I2SSRC; + } + + /* Set the I2S clock to the external clock value */ + i2sclk = I2S_EXTERNAL_CLOCK_VAL; + + #else /* There is no define for External I2S clock source */ + /* Set PLLI2S as I2S clock source */ + if ((RCC->CFGR & RCC_CFGR_I2SSRC) != 0) + { + RCC->CFGR &= ~(uint32_t)RCC_CFGR_I2SSRC; + } + + /* Get the PLLI2SN value */ + plln = (uint32_t)(((RCC->PLLI2SCFGR & RCC_PLLI2SCFGR_PLLI2SN) >> 6) & \ + (RCC_PLLI2SCFGR_PLLI2SN >> 6)); + + /* Get the PLLI2SR value */ + pllr = (uint32_t)(((RCC->PLLI2SCFGR & RCC_PLLI2SCFGR_PLLI2SR) >> 28) & \ + (RCC_PLLI2SCFGR_PLLI2SR >> 28)); + + /* Get the PLLM value */ + pllm = (uint32_t)(RCC->PLLCFGR & RCC_PLLCFGR_PLLM); + + if((RCC->PLLCFGR & RCC_PLLCFGR_PLLSRC) == RCC_PLLCFGR_PLLSRC_HSE) + { + /* Get the I2S source clock value */ + i2sclk = (uint32_t)(((HSE_VALUE / pllm) * plln) / pllr); + } + else + { /* Get the I2S source clock value */ + i2sclk = (uint32_t)(((HSI_VALUE / pllm) * plln) / pllr); + } + #endif /* I2S_EXTERNAL_CLOCK_VAL */ + + /* Compute the Real divider depending on the MCLK output state, with a floating point */ + if(I2S_InitStruct->I2S_MCLKOutput == I2S_MCLKOutput_Enable) + { + /* MCLK output is enabled */ + tmp = (uint16_t)(((((i2sclk / 256) * 10) / I2S_InitStruct->I2S_AudioFreq)) + 5); + } + else + { + /* MCLK output is disabled */ + tmp = (uint16_t)(((((i2sclk / (32 * packetlength)) *10 ) / I2S_InitStruct->I2S_AudioFreq)) + 5); + } + + /* Remove the flatting point */ + tmp = tmp / 10; + + /* Check the parity of the divider */ + i2sodd = (uint16_t)(tmp & (uint16_t)0x0001); + + /* Compute the i2sdiv prescaler */ + i2sdiv = (uint16_t)((tmp - i2sodd) / 2); + + /* Get the Mask for the Odd bit (SPI_I2SPR[8]) register */ + i2sodd = (uint16_t) (i2sodd << 8); + } + + /* Test if the divider is 1 or 0 or greater than 0xFF */ + if ((i2sdiv < 2) || (i2sdiv > 0xFF)) + { + /* Set the default values */ + i2sdiv = 2; + i2sodd = 0; + } + + /* Write to SPIx I2SPR register the computed value */ + SPIx->I2SPR = (uint16_t)((uint16_t)i2sdiv | (uint16_t)(i2sodd | (uint16_t)I2S_InitStruct->I2S_MCLKOutput)); + + /* Configure the I2S with the SPI_InitStruct values */ + tmpreg |= (uint16_t)((uint16_t)SPI_I2SCFGR_I2SMOD | (uint16_t)(I2S_InitStruct->I2S_Mode | \ + (uint16_t)(I2S_InitStruct->I2S_Standard | (uint16_t)(I2S_InitStruct->I2S_DataFormat | \ + (uint16_t)I2S_InitStruct->I2S_CPOL)))); + + /* Write to SPIx I2SCFGR */ + SPIx->I2SCFGR = tmpreg; +} + +/** + * @brief Fills each SPI_InitStruct member with its default value. + * @param SPI_InitStruct: pointer to a SPI_InitTypeDef structure which will be initialized. + * @retval None + */ +void SPI_StructInit(SPI_InitTypeDef* SPI_InitStruct) +{ +/*--------------- Reset SPI init structure parameters values -----------------*/ + /* Initialize the SPI_Direction member */ + SPI_InitStruct->SPI_Direction = SPI_Direction_2Lines_FullDuplex; + /* initialize the SPI_Mode member */ + SPI_InitStruct->SPI_Mode = SPI_Mode_Slave; + /* initialize the SPI_DataSize member */ + SPI_InitStruct->SPI_DataSize = SPI_DataSize_8b; + /* Initialize the SPI_CPOL member */ + SPI_InitStruct->SPI_CPOL = SPI_CPOL_Low; + /* Initialize the SPI_CPHA member */ + SPI_InitStruct->SPI_CPHA = SPI_CPHA_1Edge; + /* Initialize the SPI_NSS member */ + SPI_InitStruct->SPI_NSS = SPI_NSS_Hard; + /* Initialize the SPI_BaudRatePrescaler member */ + SPI_InitStruct->SPI_BaudRatePrescaler = SPI_BaudRatePrescaler_2; + /* Initialize the SPI_FirstBit member */ + SPI_InitStruct->SPI_FirstBit = SPI_FirstBit_MSB; + /* Initialize the SPI_CRCPolynomial member */ + SPI_InitStruct->SPI_CRCPolynomial = 7; +} + +/** + * @brief Fills each I2S_InitStruct member with its default value. + * @param I2S_InitStruct: pointer to a I2S_InitTypeDef structure which will be initialized. + * @retval None + */ +void I2S_StructInit(I2S_InitTypeDef* I2S_InitStruct) +{ +/*--------------- Reset I2S init structure parameters values -----------------*/ + /* Initialize the I2S_Mode member */ + I2S_InitStruct->I2S_Mode = I2S_Mode_SlaveTx; + + /* Initialize the I2S_Standard member */ + I2S_InitStruct->I2S_Standard = I2S_Standard_Phillips; + + /* Initialize the I2S_DataFormat member */ + I2S_InitStruct->I2S_DataFormat = I2S_DataFormat_16b; + + /* Initialize the I2S_MCLKOutput member */ + I2S_InitStruct->I2S_MCLKOutput = I2S_MCLKOutput_Disable; + + /* Initialize the I2S_AudioFreq member */ + I2S_InitStruct->I2S_AudioFreq = I2S_AudioFreq_Default; + + /* Initialize the I2S_CPOL member */ + I2S_InitStruct->I2S_CPOL = I2S_CPOL_Low; +} + +/** + * @brief Enables or disables the specified SPI peripheral. + * @param SPIx: where x can be 1, 2, 3, 4, 5 or 6 to select the SPI peripheral. + * @param NewState: new state of the SPIx peripheral. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void SPI_Cmd(SPI_TypeDef* SPIx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_SPI_ALL_PERIPH(SPIx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + if (NewState != DISABLE) + { + /* Enable the selected SPI peripheral */ + SPIx->CR1 |= SPI_CR1_SPE; + } + else + { + /* Disable the selected SPI peripheral */ + SPIx->CR1 &= (uint16_t)~((uint16_t)SPI_CR1_SPE); + } +} + +/** + * @brief Enables or disables the specified SPI peripheral (in I2S mode). + * @param SPIx: where x can be 2 or 3 to select the SPI peripheral (or I2Sxext + * for full duplex mode). + * @param NewState: new state of the SPIx peripheral. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void I2S_Cmd(SPI_TypeDef* SPIx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_SPI_23_PERIPH_EXT(SPIx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the selected SPI peripheral (in I2S mode) */ + SPIx->I2SCFGR |= SPI_I2SCFGR_I2SE; + } + else + { + /* Disable the selected SPI peripheral in I2S mode */ + SPIx->I2SCFGR &= (uint16_t)~((uint16_t)SPI_I2SCFGR_I2SE); + } +} + +/** + * @brief Configures the data size for the selected SPI. + * @param SPIx: where x can be 1, 2, 3, 4, 5 or 6 to select the SPI peripheral. + * @param SPI_DataSize: specifies the SPI data size. + * This parameter can be one of the following values: + * @arg SPI_DataSize_16b: Set data frame format to 16bit + * @arg SPI_DataSize_8b: Set data frame format to 8bit + * @retval None + */ +void SPI_DataSizeConfig(SPI_TypeDef* SPIx, uint16_t SPI_DataSize) +{ + /* Check the parameters */ + assert_param(IS_SPI_ALL_PERIPH(SPIx)); + assert_param(IS_SPI_DATASIZE(SPI_DataSize)); + /* Clear DFF bit */ + SPIx->CR1 &= (uint16_t)~SPI_DataSize_16b; + /* Set new DFF bit value */ + SPIx->CR1 |= SPI_DataSize; +} + +/** + * @brief Selects the data transfer direction in bidirectional mode for the specified SPI. + * @param SPIx: where x can be 1, 2, 3, 4, 5 or 6 to select the SPI peripheral. + * @param SPI_Direction: specifies the data transfer direction in bidirectional mode. + * This parameter can be one of the following values: + * @arg SPI_Direction_Tx: Selects Tx transmission direction + * @arg SPI_Direction_Rx: Selects Rx receive direction + * @retval None + */ +void SPI_BiDirectionalLineConfig(SPI_TypeDef* SPIx, uint16_t SPI_Direction) +{ + /* Check the parameters */ + assert_param(IS_SPI_ALL_PERIPH(SPIx)); + assert_param(IS_SPI_DIRECTION(SPI_Direction)); + if (SPI_Direction == SPI_Direction_Tx) + { + /* Set the Tx only mode */ + SPIx->CR1 |= SPI_Direction_Tx; + } + else + { + /* Set the Rx only mode */ + SPIx->CR1 &= SPI_Direction_Rx; + } +} + +/** + * @brief Configures internally by software the NSS pin for the selected SPI. + * @param SPIx: where x can be 1, 2, 3, 4, 5 or 6 to select the SPI peripheral. + * @param SPI_NSSInternalSoft: specifies the SPI NSS internal state. + * This parameter can be one of the following values: + * @arg SPI_NSSInternalSoft_Set: Set NSS pin internally + * @arg SPI_NSSInternalSoft_Reset: Reset NSS pin internally + * @retval None + */ +void SPI_NSSInternalSoftwareConfig(SPI_TypeDef* SPIx, uint16_t SPI_NSSInternalSoft) +{ + /* Check the parameters */ + assert_param(IS_SPI_ALL_PERIPH(SPIx)); + assert_param(IS_SPI_NSS_INTERNAL(SPI_NSSInternalSoft)); + if (SPI_NSSInternalSoft != SPI_NSSInternalSoft_Reset) + { + /* Set NSS pin internally by software */ + SPIx->CR1 |= SPI_NSSInternalSoft_Set; + } + else + { + /* Reset NSS pin internally by software */ + SPIx->CR1 &= SPI_NSSInternalSoft_Reset; + } +} + +/** + * @brief Enables or disables the SS output for the selected SPI. + * @param SPIx: where x can be 1, 2, 3, 4, 5 or 6 to select the SPI peripheral. + * @param NewState: new state of the SPIx SS output. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void SPI_SSOutputCmd(SPI_TypeDef* SPIx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_SPI_ALL_PERIPH(SPIx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + if (NewState != DISABLE) + { + /* Enable the selected SPI SS output */ + SPIx->CR2 |= (uint16_t)SPI_CR2_SSOE; + } + else + { + /* Disable the selected SPI SS output */ + SPIx->CR2 &= (uint16_t)~((uint16_t)SPI_CR2_SSOE); + } +} + +/** + * @brief Enables or disables the SPIx/I2Sx DMA interface. + * + * @note This function can be called only after the SPI_Init() function has + * been called. + * @note When TI mode is selected, the control bits SSM, SSI, CPOL and CPHA + * are not taken into consideration and are configured by hardware + * respectively to the TI mode requirements. + * + * @param SPIx: where x can be 1, 2, 3, 4, 5 or 6 + * @param NewState: new state of the selected SPI TI communication mode. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void SPI_TIModeCmd(SPI_TypeDef* SPIx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_SPI_ALL_PERIPH(SPIx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the TI mode for the selected SPI peripheral */ + SPIx->CR2 |= SPI_CR2_FRF; + } + else + { + /* Disable the TI mode for the selected SPI peripheral */ + SPIx->CR2 &= (uint16_t)~SPI_CR2_FRF; + } +} + +/** + * @brief Configures the full duplex mode for the I2Sx peripheral using its + * extension I2Sxext according to the specified parameters in the + * I2S_InitStruct. + * @param I2Sxext: where x can be 2 or 3 to select the I2S peripheral extension block. + * @param I2S_InitStruct: pointer to an I2S_InitTypeDef structure that + * contains the configuration information for the specified I2S peripheral + * extension. + * + * @note The structure pointed by I2S_InitStruct parameter should be the same + * used for the master I2S peripheral. In this case, if the master is + * configured as transmitter, the slave will be receiver and vice versa. + * Or you can force a different mode by modifying the field I2S_Mode to the + * value I2S_SlaveRx or I2S_SlaveTx indepedently of the master configuration. + * + * @note The I2S full duplex extension can be configured in slave mode only. + * + * @retval None + */ +void I2S_FullDuplexConfig(SPI_TypeDef* I2Sxext, I2S_InitTypeDef* I2S_InitStruct) +{ + uint16_t tmpreg = 0, tmp = 0; + + /* Check the I2S parameters */ + assert_param(IS_I2S_EXT_PERIPH(I2Sxext)); + assert_param(IS_I2S_MODE(I2S_InitStruct->I2S_Mode)); + assert_param(IS_I2S_STANDARD(I2S_InitStruct->I2S_Standard)); + assert_param(IS_I2S_DATA_FORMAT(I2S_InitStruct->I2S_DataFormat)); + assert_param(IS_I2S_CPOL(I2S_InitStruct->I2S_CPOL)); + +/*----------------------- SPIx I2SCFGR & I2SPR Configuration -----------------*/ + /* Clear I2SMOD, I2SE, I2SCFG, PCMSYNC, I2SSTD, CKPOL, DATLEN and CHLEN bits */ + I2Sxext->I2SCFGR &= I2SCFGR_CLEAR_MASK; + I2Sxext->I2SPR = 0x0002; + + /* Get the I2SCFGR register value */ + tmpreg = I2Sxext->I2SCFGR; + + /* Get the mode to be configured for the extended I2S */ + if ((I2S_InitStruct->I2S_Mode == I2S_Mode_MasterTx) || (I2S_InitStruct->I2S_Mode == I2S_Mode_SlaveTx)) + { + tmp = I2S_Mode_SlaveRx; + } + else + { + if ((I2S_InitStruct->I2S_Mode == I2S_Mode_MasterRx) || (I2S_InitStruct->I2S_Mode == I2S_Mode_SlaveRx)) + { + tmp = I2S_Mode_SlaveTx; + } + } + + + /* Configure the I2S with the SPI_InitStruct values */ + tmpreg |= (uint16_t)((uint16_t)SPI_I2SCFGR_I2SMOD | (uint16_t)(tmp | \ + (uint16_t)(I2S_InitStruct->I2S_Standard | (uint16_t)(I2S_InitStruct->I2S_DataFormat | \ + (uint16_t)I2S_InitStruct->I2S_CPOL)))); + + /* Write to SPIx I2SCFGR */ + I2Sxext->I2SCFGR = tmpreg; +} + +/** + * @} + */ + +/** @defgroup SPI_Group2 Data transfers functions + * @brief Data transfers functions + * +@verbatim + =============================================================================== + ##### Data transfers functions ##### + =============================================================================== + + [..] This section provides a set of functions allowing to manage the SPI data + transfers. In reception, data are received and then stored into an internal + Rx buffer while. In transmission, data are first stored into an internal Tx + buffer before being transmitted. + + [..] The read access of the SPI_DR register can be done using the SPI_I2S_ReceiveData() + function and returns the Rx buffered value. Whereas a write access to the SPI_DR + can be done using SPI_I2S_SendData() function and stores the written data into + Tx buffer. + +@endverbatim + * @{ + */ + +/** + * @brief Returns the most recent received data by the SPIx/I2Sx peripheral. + * @param SPIx: To select the SPIx/I2Sx peripheral, where x can be: 1, 2, 3, 4, 5 or 6 + * in SPI mode or 2 or 3 in I2S mode or I2Sxext for I2S full duplex mode. + * @retval The value of the received data. + */ +uint16_t SPI_I2S_ReceiveData(SPI_TypeDef* SPIx) +{ + /* Check the parameters */ + assert_param(IS_SPI_ALL_PERIPH_EXT(SPIx)); + + /* Return the data in the DR register */ + return SPIx->DR; +} + +/** + * @brief Transmits a Data through the SPIx/I2Sx peripheral. + * @param SPIx: To select the SPIx/I2Sx peripheral, where x can be: 1, 2, 3, 4, 5 or 6 + * in SPI mode or 2 or 3 in I2S mode or I2Sxext for I2S full duplex mode. + * @param Data: Data to be transmitted. + * @retval None + */ +void SPI_I2S_SendData(SPI_TypeDef* SPIx, uint16_t Data) +{ + /* Check the parameters */ + assert_param(IS_SPI_ALL_PERIPH_EXT(SPIx)); + + /* Write in the DR register the data to be sent */ + SPIx->DR = Data; +} + +/** + * @} + */ + +/** @defgroup SPI_Group3 Hardware CRC Calculation functions + * @brief Hardware CRC Calculation functions + * +@verbatim + =============================================================================== + ##### Hardware CRC Calculation functions ##### + =============================================================================== + + [..] This section provides a set of functions allowing to manage the SPI CRC hardware + calculation + + [..] SPI communication using CRC is possible through the following procedure: + (#) Program the Data direction, Polarity, Phase, First Data, Baud Rate Prescaler, + Slave Management, Peripheral Mode and CRC Polynomial values using the SPI_Init() + function. + (#) Enable the CRC calculation using the SPI_CalculateCRC() function. + (#) Enable the SPI using the SPI_Cmd() function + (#) Before writing the last data to the TX buffer, set the CRCNext bit using the + SPI_TransmitCRC() function to indicate that after transmission of the last + data, the CRC should be transmitted. + (#) After transmitting the last data, the SPI transmits the CRC. The SPI_CR1_CRCNEXT + bit is reset. The CRC is also received and compared against the SPI_RXCRCR + value. + If the value does not match, the SPI_FLAG_CRCERR flag is set and an interrupt + can be generated when the SPI_I2S_IT_ERR interrupt is enabled. + + [..] + (@) It is advised not to read the calculated CRC values during the communication. + + (@) When the SPI is in slave mode, be careful to enable CRC calculation only + when the clock is stable, that is, when the clock is in the steady state. + If not, a wrong CRC calculation may be done. In fact, the CRC is sensitive + to the SCK slave input clock as soon as CRCEN is set, and this, whatever + the value of the SPE bit. + + (@) With high bitrate frequencies, be careful when transmitting the CRC. + As the number of used CPU cycles has to be as low as possible in the CRC + transfer phase, it is forbidden to call software functions in the CRC + transmission sequence to avoid errors in the last data and CRC reception. + In fact, CRCNEXT bit has to be written before the end of the transmission/reception + of the last data. + + (@) For high bit rate frequencies, it is advised to use the DMA mode to avoid the + degradation of the SPI speed performance due to CPU accesses impacting the + SPI bandwidth. + + (@) When the STM32F4xx is configured as slave and the NSS hardware mode is + used, the NSS pin needs to be kept low between the data phase and the CRC + phase. + + (@) When the SPI is configured in slave mode with the CRC feature enabled, CRC + calculation takes place even if a high level is applied on the NSS pin. + This may happen for example in case of a multi-slave environment where the + communication master addresses slaves alternately. + + (@) Between a slave de-selection (high level on NSS) and a new slave selection + (low level on NSS), the CRC value should be cleared on both master and slave + sides in order to resynchronize the master and slave for their respective + CRC calculation. + + (@) To clear the CRC, follow the procedure below: + (#@) Disable SPI using the SPI_Cmd() function + (#@) Disable the CRC calculation using the SPI_CalculateCRC() function. + (#@) Enable the CRC calculation using the SPI_CalculateCRC() function. + (#@) Enable SPI using the SPI_Cmd() function. + +@endverbatim + * @{ + */ + +/** + * @brief Enables or disables the CRC value calculation of the transferred bytes. + * @param SPIx: where x can be 1, 2, 3, 4, 5 or 6 to select the SPI peripheral. + * @param NewState: new state of the SPIx CRC value calculation. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void SPI_CalculateCRC(SPI_TypeDef* SPIx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_SPI_ALL_PERIPH(SPIx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + if (NewState != DISABLE) + { + /* Enable the selected SPI CRC calculation */ + SPIx->CR1 |= SPI_CR1_CRCEN; + } + else + { + /* Disable the selected SPI CRC calculation */ + SPIx->CR1 &= (uint16_t)~((uint16_t)SPI_CR1_CRCEN); + } +} + +/** + * @brief Transmit the SPIx CRC value. + * @param SPIx: where x can be 1, 2, 3, 4, 5 or 6 to select the SPI peripheral. + * @retval None + */ +void SPI_TransmitCRC(SPI_TypeDef* SPIx) +{ + /* Check the parameters */ + assert_param(IS_SPI_ALL_PERIPH(SPIx)); + + /* Enable the selected SPI CRC transmission */ + SPIx->CR1 |= SPI_CR1_CRCNEXT; +} + +/** + * @brief Returns the transmit or the receive CRC register value for the specified SPI. + * @param SPIx: where x can be 1, 2, 3, 4, 5 or 6 to select the SPI peripheral. + * @param SPI_CRC: specifies the CRC register to be read. + * This parameter can be one of the following values: + * @arg SPI_CRC_Tx: Selects Tx CRC register + * @arg SPI_CRC_Rx: Selects Rx CRC register + * @retval The selected CRC register value.. + */ +uint16_t SPI_GetCRC(SPI_TypeDef* SPIx, uint8_t SPI_CRC) +{ + uint16_t crcreg = 0; + /* Check the parameters */ + assert_param(IS_SPI_ALL_PERIPH(SPIx)); + assert_param(IS_SPI_CRC(SPI_CRC)); + if (SPI_CRC != SPI_CRC_Rx) + { + /* Get the Tx CRC register */ + crcreg = SPIx->TXCRCR; + } + else + { + /* Get the Rx CRC register */ + crcreg = SPIx->RXCRCR; + } + /* Return the selected CRC register */ + return crcreg; +} + +/** + * @brief Returns the CRC Polynomial register value for the specified SPI. + * @param SPIx: where x can be 1, 2, 3, 4, 5 or 6 to select the SPI peripheral. + * @retval The CRC Polynomial register value. + */ +uint16_t SPI_GetCRCPolynomial(SPI_TypeDef* SPIx) +{ + /* Check the parameters */ + assert_param(IS_SPI_ALL_PERIPH(SPIx)); + + /* Return the CRC polynomial register */ + return SPIx->CRCPR; +} + +/** + * @} + */ + +/** @defgroup SPI_Group4 DMA transfers management functions + * @brief DMA transfers management functions + * +@verbatim + =============================================================================== + ##### DMA transfers management functions ##### + =============================================================================== + +@endverbatim + * @{ + */ + +/** + * @brief Enables or disables the SPIx/I2Sx DMA interface. + * @param SPIx: To select the SPIx/I2Sx peripheral, where x can be: 1, 2, 3, 4, 5 or 6 + * in SPI mode or 2 or 3 in I2S mode or I2Sxext for I2S full duplex mode. + * @param SPI_I2S_DMAReq: specifies the SPI DMA transfer request to be enabled or disabled. + * This parameter can be any combination of the following values: + * @arg SPI_I2S_DMAReq_Tx: Tx buffer DMA transfer request + * @arg SPI_I2S_DMAReq_Rx: Rx buffer DMA transfer request + * @param NewState: new state of the selected SPI DMA transfer request. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void SPI_I2S_DMACmd(SPI_TypeDef* SPIx, uint16_t SPI_I2S_DMAReq, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_SPI_ALL_PERIPH_EXT(SPIx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + assert_param(IS_SPI_I2S_DMAREQ(SPI_I2S_DMAReq)); + + if (NewState != DISABLE) + { + /* Enable the selected SPI DMA requests */ + SPIx->CR2 |= SPI_I2S_DMAReq; + } + else + { + /* Disable the selected SPI DMA requests */ + SPIx->CR2 &= (uint16_t)~SPI_I2S_DMAReq; + } +} + +/** + * @} + */ + +/** @defgroup SPI_Group5 Interrupts and flags management functions + * @brief Interrupts and flags management functions + * +@verbatim + =============================================================================== + ##### Interrupts and flags management functions ##### + =============================================================================== + + [..] This section provides a set of functions allowing to configure the SPI Interrupts + sources and check or clear the flags or pending bits status. + The user should identify which mode will be used in his application to manage + the communication: Polling mode, Interrupt mode or DMA mode. + + *** Polling Mode *** + ==================== +[..] In Polling Mode, the SPI/I2S communication can be managed by 9 flags: + (#) SPI_I2S_FLAG_TXE : to indicate the status of the transmit buffer register + (#) SPI_I2S_FLAG_RXNE : to indicate the status of the receive buffer register + (#) SPI_I2S_FLAG_BSY : to indicate the state of the communication layer of the SPI. + (#) SPI_FLAG_CRCERR : to indicate if a CRC Calculation error occur + (#) SPI_FLAG_MODF : to indicate if a Mode Fault error occur + (#) SPI_I2S_FLAG_OVR : to indicate if an Overrun error occur + (#) I2S_FLAG_TIFRFE: to indicate a Frame Format error occurs. + (#) I2S_FLAG_UDR: to indicate an Underrun error occurs. + (#) I2S_FLAG_CHSIDE: to indicate Channel Side. + + (@) Do not use the BSY flag to handle each data transmission or reception. It is + better to use the TXE and RXNE flags instead. + + [..] In this Mode it is advised to use the following functions: + (+) FlagStatus SPI_I2S_GetFlagStatus(SPI_TypeDef* SPIx, uint16_t SPI_I2S_FLAG); + (+) void SPI_I2S_ClearFlag(SPI_TypeDef* SPIx, uint16_t SPI_I2S_FLAG); + + *** Interrupt Mode *** + ====================== + [..] In Interrupt Mode, the SPI communication can be managed by 3 interrupt sources + and 7 pending bits: + (+) Pending Bits: + (##) SPI_I2S_IT_TXE : to indicate the status of the transmit buffer register + (##) SPI_I2S_IT_RXNE : to indicate the status of the receive buffer register + (##) SPI_IT_CRCERR : to indicate if a CRC Calculation error occur (available in SPI mode only) + (##) SPI_IT_MODF : to indicate if a Mode Fault error occur (available in SPI mode only) + (##) SPI_I2S_IT_OVR : to indicate if an Overrun error occur + (##) I2S_IT_UDR : to indicate an Underrun Error occurs (available in I2S mode only). + (##) I2S_FLAG_TIFRFE : to indicate a Frame Format error occurs (available in TI mode only). + + (+) Interrupt Source: + (##) SPI_I2S_IT_TXE: specifies the interrupt source for the Tx buffer empty + interrupt. + (##) SPI_I2S_IT_RXNE : specifies the interrupt source for the Rx buffer not + empty interrupt. + (##) SPI_I2S_IT_ERR : specifies the interrupt source for the errors interrupt. + + [..] In this Mode it is advised to use the following functions: + (+) void SPI_I2S_ITConfig(SPI_TypeDef* SPIx, uint8_t SPI_I2S_IT, FunctionalState NewState); + (+) ITStatus SPI_I2S_GetITStatus(SPI_TypeDef* SPIx, uint8_t SPI_I2S_IT); + (+) void SPI_I2S_ClearITPendingBit(SPI_TypeDef* SPIx, uint8_t SPI_I2S_IT); + + *** DMA Mode *** + ================ + [..] In DMA Mode, the SPI communication can be managed by 2 DMA Channel requests: + (#) SPI_I2S_DMAReq_Tx: specifies the Tx buffer DMA transfer request + (#) SPI_I2S_DMAReq_Rx: specifies the Rx buffer DMA transfer request + + [..] In this Mode it is advised to use the following function: + (+) void SPI_I2S_DMACmd(SPI_TypeDef* SPIx, uint16_t SPI_I2S_DMAReq, FunctionalState + NewState); + +@endverbatim + * @{ + */ + +/** + * @brief Enables or disables the specified SPI/I2S interrupts. + * @param SPIx: To select the SPIx/I2Sx peripheral, where x can be: 1, 2, 3, 4, 5 or 6 + * in SPI mode or 2 or 3 in I2S mode or I2Sxext for I2S full duplex mode. + * @param SPI_I2S_IT: specifies the SPI interrupt source to be enabled or disabled. + * This parameter can be one of the following values: + * @arg SPI_I2S_IT_TXE: Tx buffer empty interrupt mask + * @arg SPI_I2S_IT_RXNE: Rx buffer not empty interrupt mask + * @arg SPI_I2S_IT_ERR: Error interrupt mask + * @param NewState: new state of the specified SPI interrupt. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void SPI_I2S_ITConfig(SPI_TypeDef* SPIx, uint8_t SPI_I2S_IT, FunctionalState NewState) +{ + uint16_t itpos = 0, itmask = 0 ; + + /* Check the parameters */ + assert_param(IS_SPI_ALL_PERIPH_EXT(SPIx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + assert_param(IS_SPI_I2S_CONFIG_IT(SPI_I2S_IT)); + + /* Get the SPI IT index */ + itpos = SPI_I2S_IT >> 4; + + /* Set the IT mask */ + itmask = (uint16_t)1 << (uint16_t)itpos; + + if (NewState != DISABLE) + { + /* Enable the selected SPI interrupt */ + SPIx->CR2 |= itmask; + } + else + { + /* Disable the selected SPI interrupt */ + SPIx->CR2 &= (uint16_t)~itmask; + } +} + +/** + * @brief Checks whether the specified SPIx/I2Sx flag is set or not. + * @param SPIx: To select the SPIx/I2Sx peripheral, where x can be: 1, 2, 3, 4, 5 or 6 + * in SPI mode or 2 or 3 in I2S mode or I2Sxext for I2S full duplex mode. + * @param SPI_I2S_FLAG: specifies the SPI flag to check. + * This parameter can be one of the following values: + * @arg SPI_I2S_FLAG_TXE: Transmit buffer empty flag. + * @arg SPI_I2S_FLAG_RXNE: Receive buffer not empty flag. + * @arg SPI_I2S_FLAG_BSY: Busy flag. + * @arg SPI_I2S_FLAG_OVR: Overrun flag. + * @arg SPI_FLAG_MODF: Mode Fault flag. + * @arg SPI_FLAG_CRCERR: CRC Error flag. + * @arg SPI_I2S_FLAG_TIFRFE: Format Error. + * @arg I2S_FLAG_UDR: Underrun Error flag. + * @arg I2S_FLAG_CHSIDE: Channel Side flag. + * @retval The new state of SPI_I2S_FLAG (SET or RESET). + */ +FlagStatus SPI_I2S_GetFlagStatus(SPI_TypeDef* SPIx, uint16_t SPI_I2S_FLAG) +{ + FlagStatus bitstatus = RESET; + /* Check the parameters */ + assert_param(IS_SPI_ALL_PERIPH_EXT(SPIx)); + assert_param(IS_SPI_I2S_GET_FLAG(SPI_I2S_FLAG)); + + /* Check the status of the specified SPI flag */ + if ((SPIx->SR & SPI_I2S_FLAG) != (uint16_t)RESET) + { + /* SPI_I2S_FLAG is set */ + bitstatus = SET; + } + else + { + /* SPI_I2S_FLAG is reset */ + bitstatus = RESET; + } + /* Return the SPI_I2S_FLAG status */ + return bitstatus; +} + +/** + * @brief Clears the SPIx CRC Error (CRCERR) flag. + * @param SPIx: To select the SPIx/I2Sx peripheral, where x can be: 1, 2, 3, 4, 5 or 6 + * in SPI mode or 2 or 3 in I2S mode or I2Sxext for I2S full duplex mode. + * @param SPI_I2S_FLAG: specifies the SPI flag to clear. + * This function clears only CRCERR flag. + * @arg SPI_FLAG_CRCERR: CRC Error flag. + * + * @note OVR (OverRun error) flag is cleared by software sequence: a read + * operation to SPI_DR register (SPI_I2S_ReceiveData()) followed by a read + * operation to SPI_SR register (SPI_I2S_GetFlagStatus()). + * @note UDR (UnderRun error) flag is cleared by a read operation to + * SPI_SR register (SPI_I2S_GetFlagStatus()). + * @note MODF (Mode Fault) flag is cleared by software sequence: a read/write + * operation to SPI_SR register (SPI_I2S_GetFlagStatus()) followed by a + * write operation to SPI_CR1 register (SPI_Cmd() to enable the SPI). + * + * @retval None + */ +void SPI_I2S_ClearFlag(SPI_TypeDef* SPIx, uint16_t SPI_I2S_FLAG) +{ + /* Check the parameters */ + assert_param(IS_SPI_ALL_PERIPH_EXT(SPIx)); + assert_param(IS_SPI_I2S_CLEAR_FLAG(SPI_I2S_FLAG)); + + /* Clear the selected SPI CRC Error (CRCERR) flag */ + SPIx->SR = (uint16_t)~SPI_I2S_FLAG; +} + +/** + * @brief Checks whether the specified SPIx/I2Sx interrupt has occurred or not. + * @param SPIx: To select the SPIx/I2Sx peripheral, where x can be: 1, 2, 3, 4, 5 or 6 + * in SPI mode or 2 or 3 in I2S mode or I2Sxext for I2S full duplex mode. + * @param SPI_I2S_IT: specifies the SPI interrupt source to check. + * This parameter can be one of the following values: + * @arg SPI_I2S_IT_TXE: Transmit buffer empty interrupt. + * @arg SPI_I2S_IT_RXNE: Receive buffer not empty interrupt. + * @arg SPI_I2S_IT_OVR: Overrun interrupt. + * @arg SPI_IT_MODF: Mode Fault interrupt. + * @arg SPI_IT_CRCERR: CRC Error interrupt. + * @arg I2S_IT_UDR: Underrun interrupt. + * @arg SPI_I2S_IT_TIFRFE: Format Error interrupt. + * @retval The new state of SPI_I2S_IT (SET or RESET). + */ +ITStatus SPI_I2S_GetITStatus(SPI_TypeDef* SPIx, uint8_t SPI_I2S_IT) +{ + ITStatus bitstatus = RESET; + uint16_t itpos = 0, itmask = 0, enablestatus = 0; + + /* Check the parameters */ + assert_param(IS_SPI_ALL_PERIPH_EXT(SPIx)); + assert_param(IS_SPI_I2S_GET_IT(SPI_I2S_IT)); + + /* Get the SPI_I2S_IT index */ + itpos = 0x01 << (SPI_I2S_IT & 0x0F); + + /* Get the SPI_I2S_IT IT mask */ + itmask = SPI_I2S_IT >> 4; + + /* Set the IT mask */ + itmask = 0x01 << itmask; + + /* Get the SPI_I2S_IT enable bit status */ + enablestatus = (SPIx->CR2 & itmask) ; + + /* Check the status of the specified SPI interrupt */ + if (((SPIx->SR & itpos) != (uint16_t)RESET) && enablestatus) + { + /* SPI_I2S_IT is set */ + bitstatus = SET; + } + else + { + /* SPI_I2S_IT is reset */ + bitstatus = RESET; + } + /* Return the SPI_I2S_IT status */ + return bitstatus; +} + +/** + * @brief Clears the SPIx CRC Error (CRCERR) interrupt pending bit. + * @param SPIx: To select the SPIx/I2Sx peripheral, where x can be: 1, 2, 3, 4, 5 or 6 + * in SPI mode or 2 or 3 in I2S mode or I2Sxext for I2S full duplex mode. + * @param SPI_I2S_IT: specifies the SPI interrupt pending bit to clear. + * This function clears only CRCERR interrupt pending bit. + * @arg SPI_IT_CRCERR: CRC Error interrupt. + * + * @note OVR (OverRun Error) interrupt pending bit is cleared by software + * sequence: a read operation to SPI_DR register (SPI_I2S_ReceiveData()) + * followed by a read operation to SPI_SR register (SPI_I2S_GetITStatus()). + * @note UDR (UnderRun Error) interrupt pending bit is cleared by a read + * operation to SPI_SR register (SPI_I2S_GetITStatus()). + * @note MODF (Mode Fault) interrupt pending bit is cleared by software sequence: + * a read/write operation to SPI_SR register (SPI_I2S_GetITStatus()) + * followed by a write operation to SPI_CR1 register (SPI_Cmd() to enable + * the SPI). + * @retval None + */ +void SPI_I2S_ClearITPendingBit(SPI_TypeDef* SPIx, uint8_t SPI_I2S_IT) +{ + uint16_t itpos = 0; + /* Check the parameters */ + assert_param(IS_SPI_ALL_PERIPH_EXT(SPIx)); + assert_param(IS_SPI_I2S_CLEAR_IT(SPI_I2S_IT)); + + /* Get the SPI_I2S IT index */ + itpos = 0x01 << (SPI_I2S_IT & 0x0F); + + /* Clear the selected SPI CRC Error (CRCERR) interrupt pending bit */ + SPIx->SR = (uint16_t)~itpos; +} + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/src/stm32f4xx_syscfg.c b/FWLIB/src/stm32f4xx_syscfg.c new file mode 100644 index 0000000..29f472d --- /dev/null +++ b/FWLIB/src/stm32f4xx_syscfg.c @@ -0,0 +1,240 @@ +/** + ****************************************************************************** + * @file stm32f4xx_syscfg.c + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file provides firmware functions to manage the SYSCFG peripheral. + * + @verbatim + + =============================================================================== + ##### How to use this driver ##### + =============================================================================== + [..] This driver provides functions for: + + (#) Remapping the memory accessible in the code area using SYSCFG_MemoryRemapConfig() + + (#) Swapping the internal flash Bank1 and Bank2 this features is only visible for + STM32F42xxx/43xxx devices Devices. + + (#) Manage the EXTI lines connection to the GPIOs using SYSCFG_EXTILineConfig() + + (#) Select the ETHERNET media interface (RMII/RII) using SYSCFG_ETH_MediaInterfaceConfig() + + -@- SYSCFG APB clock must be enabled to get write access to SYSCFG registers, + using RCC_APB2PeriphClockCmd(RCC_APB2Periph_SYSCFG, ENABLE); + + @endverbatim + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx_syscfg.h" +#include "stm32f4xx_rcc.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @defgroup SYSCFG + * @brief SYSCFG driver modules + * @{ + */ + +/* Private typedef -----------------------------------------------------------*/ +/* Private define ------------------------------------------------------------*/ +/* ------------ RCC registers bit address in the alias region ----------- */ +#define SYSCFG_OFFSET (SYSCFG_BASE - PERIPH_BASE) +/* --- MEMRMP Register ---*/ +/* Alias word address of UFB_MODE bit */ +#define MEMRMP_OFFSET SYSCFG_OFFSET +#define UFB_MODE_BitNumber ((uint8_t)0x8) +#define UFB_MODE_BB (PERIPH_BB_BASE + (MEMRMP_OFFSET * 32) + (UFB_MODE_BitNumber * 4)) + + +/* --- PMC Register ---*/ +/* Alias word address of MII_RMII_SEL bit */ +#define PMC_OFFSET (SYSCFG_OFFSET + 0x04) +#define MII_RMII_SEL_BitNumber ((uint8_t)0x17) +#define PMC_MII_RMII_SEL_BB (PERIPH_BB_BASE + (PMC_OFFSET * 32) + (MII_RMII_SEL_BitNumber * 4)) + +/* --- CMPCR Register ---*/ +/* Alias word address of CMP_PD bit */ +#define CMPCR_OFFSET (SYSCFG_OFFSET + 0x20) +#define CMP_PD_BitNumber ((uint8_t)0x00) +#define CMPCR_CMP_PD_BB (PERIPH_BB_BASE + (CMPCR_OFFSET * 32) + (CMP_PD_BitNumber * 4)) + +/* Private macro -------------------------------------------------------------*/ +/* Private variables ---------------------------------------------------------*/ +/* Private function prototypes -----------------------------------------------*/ +/* Private functions ---------------------------------------------------------*/ + +/** @defgroup SYSCFG_Private_Functions + * @{ + */ + +/** + * @brief Deinitializes the Alternate Functions (remap and EXTI configuration) + * registers to their default reset values. + * @param None + * @retval None + */ +void SYSCFG_DeInit(void) +{ + RCC_APB2PeriphResetCmd(RCC_APB2Periph_SYSCFG, ENABLE); + RCC_APB2PeriphResetCmd(RCC_APB2Periph_SYSCFG, DISABLE); +} + +/** + * @brief Changes the mapping of the specified pin. + * @param SYSCFG_Memory: selects the memory remapping. + * This parameter can be one of the following values: + * @arg SYSCFG_MemoryRemap_Flash: Main Flash memory mapped at 0x00000000 + * @arg SYSCFG_MemoryRemap_SystemFlash: System Flash memory mapped at 0x00000000 + * @arg SYSCFG_MemoryRemap_FSMC: FSMC (Bank1 (NOR/PSRAM 1 and 2) mapped at 0x00000000 for STM32F405xx/407xx and STM32F415xx/417xx devices. + * @arg SYSCFG_MemoryRemap_FMC: FMC (Bank1 (NOR/PSRAM 1 and 2) mapped at 0x00000000 for STM32F42xxx/43xxx devices. + * @arg SYSCFG_MemoryRemap_SRAM: Embedded SRAM (112kB) mapped at 0x00000000 + * @arg SYSCFG_MemoryRemap_SDRAM: FMC (External SDRAM) mapped at 0x00000000 for STM32F42xxx/43xxx devices. + * @retval None + */ +void SYSCFG_MemoryRemapConfig(uint8_t SYSCFG_MemoryRemap) +{ + /* Check the parameters */ + assert_param(IS_SYSCFG_MEMORY_REMAP_CONFING(SYSCFG_MemoryRemap)); + + SYSCFG->MEMRMP = SYSCFG_MemoryRemap; +} + +/** + * @brief Enables or disables the Interal FLASH Bank Swapping. + * + * @note This function can be used only for STM32F42xxx/43xxx devices. + * + * @param NewState: new state of Interal FLASH Bank swapping. + * This parameter can be one of the following values: + * @arg ENABLE: Flash Bank2 mapped at 0x08000000 (and aliased @0x00000000) + * and Flash Bank1 mapped at 0x08100000 (and aliased at 0x00100000) + * @arg DISABLE:(the default state) Flash Bank1 mapped at 0x08000000 (and aliased @0x0000 0000) + and Flash Bank2 mapped at 0x08100000 (and aliased at 0x00100000) + * @retval None + */ +void SYSCFG_MemorySwappingBank(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + *(__IO uint32_t *) UFB_MODE_BB = (uint32_t)NewState; +} + +/** + * @brief Selects the GPIO pin used as EXTI Line. + * @param EXTI_PortSourceGPIOx : selects the GPIO port to be used as source for + * EXTI lines where x can be (A..K) for STM32F42xxx/43xxx devices, (A..I) + * for STM32F405xx/407xx and STM32F415xx/417xx devices or (A, B, C, D and H) + * for STM32401xx devices. + * + * @param EXTI_PinSourcex: specifies the EXTI line to be configured. + * This parameter can be EXTI_PinSourcex where x can be (0..15, except + * for EXTI_PortSourceGPIOI x can be (0..11) for STM32F405xx/407xx + * and STM32F405xx/407xx devices and for EXTI_PortSourceGPIOK x can + * be (0..7) for STM32F42xxx/43xxx devices. + * + * @retval None + */ +void SYSCFG_EXTILineConfig(uint8_t EXTI_PortSourceGPIOx, uint8_t EXTI_PinSourcex) +{ + uint32_t tmp = 0x00; + + /* Check the parameters */ + assert_param(IS_EXTI_PORT_SOURCE(EXTI_PortSourceGPIOx)); + assert_param(IS_EXTI_PIN_SOURCE(EXTI_PinSourcex)); + + tmp = ((uint32_t)0x0F) << (0x04 * (EXTI_PinSourcex & (uint8_t)0x03)); + SYSCFG->EXTICR[EXTI_PinSourcex >> 0x02] &= ~tmp; + SYSCFG->EXTICR[EXTI_PinSourcex >> 0x02] |= (((uint32_t)EXTI_PortSourceGPIOx) << (0x04 * (EXTI_PinSourcex & (uint8_t)0x03))); +} + +/** + * @brief Selects the ETHERNET media interface + * @param SYSCFG_ETH_MediaInterface: specifies the Media Interface mode. + * This parameter can be one of the following values: + * @arg SYSCFG_ETH_MediaInterface_MII: MII mode selected + * @arg SYSCFG_ETH_MediaInterface_RMII: RMII mode selected + * @retval None + */ +void SYSCFG_ETH_MediaInterfaceConfig(uint32_t SYSCFG_ETH_MediaInterface) +{ + assert_param(IS_SYSCFG_ETH_MEDIA_INTERFACE(SYSCFG_ETH_MediaInterface)); + /* Configure MII_RMII selection bit */ + *(__IO uint32_t *) PMC_MII_RMII_SEL_BB = SYSCFG_ETH_MediaInterface; +} + +/** + * @brief Enables or disables the I/O Compensation Cell. + * @note The I/O compensation cell can be used only when the device supply + * voltage ranges from 2.4 to 3.6 V. + * @param NewState: new state of the I/O Compensation Cell. + * This parameter can be one of the following values: + * @arg ENABLE: I/O compensation cell enabled + * @arg DISABLE: I/O compensation cell power-down mode + * @retval None + */ +void SYSCFG_CompensationCellCmd(FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + *(__IO uint32_t *) CMPCR_CMP_PD_BB = (uint32_t)NewState; +} + +/** + * @brief Checks whether the I/O Compensation Cell ready flag is set or not. + * @param None + * @retval The new state of the I/O Compensation Cell ready flag (SET or RESET) + */ +FlagStatus SYSCFG_GetCompensationCellStatus(void) +{ + FlagStatus bitstatus = RESET; + + if ((SYSCFG->CMPCR & SYSCFG_CMPCR_READY ) != (uint32_t)RESET) + { + bitstatus = SET; + } + else + { + bitstatus = RESET; + } + return bitstatus; +} + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/src/stm32f4xx_tim.c b/FWLIB/src/stm32f4xx_tim.c new file mode 100644 index 0000000..79bd265 --- /dev/null +++ b/FWLIB/src/stm32f4xx_tim.c @@ -0,0 +1,3365 @@ +/** + ****************************************************************************** + * @file stm32f4xx_tim.c + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file provides firmware functions to manage the following + * functionalities of the TIM peripheral: + * + TimeBase management + * + Output Compare management + * + Input Capture management + * + Advanced-control timers (TIM1 and TIM8) specific features + * + Interrupts, DMA and flags management + * + Clocks management + * + Synchronization management + * + Specific interface management + * + Specific remapping management + * + @verbatim + =============================================================================== + ##### How to use this driver ##### + =============================================================================== + [..] + This driver provides functions to configure and program the TIM + of all STM32F4xx devices. + These functions are split in 9 groups: + + (#) TIM TimeBase management: this group includes all needed functions + to configure the TM Timebase unit: + (++) Set/Get Prescaler + (++) Set/Get Autoreload + (++) Counter modes configuration + (++) Set Clock division + (++) Select the One Pulse mode + (++) Update Request Configuration + (++) Update Disable Configuration + (++) Auto-Preload Configuration + (++) Enable/Disable the counter + + (#) TIM Output Compare management: this group includes all needed + functions to configure the Capture/Compare unit used in Output + compare mode: + (++) Configure each channel, independently, in Output Compare mode + (++) Select the output compare modes + (++) Select the Polarities of each channel + (++) Set/Get the Capture/Compare register values + (++) Select the Output Compare Fast mode + (++) Select the Output Compare Forced mode + (++) Output Compare-Preload Configuration + (++) Clear Output Compare Reference + (++) Select the OCREF Clear signal + (++) Enable/Disable the Capture/Compare Channels + + (#) TIM Input Capture management: this group includes all needed + functions to configure the Capture/Compare unit used in + Input Capture mode: + (++) Configure each channel in input capture mode + (++) Configure Channel1/2 in PWM Input mode + (++) Set the Input Capture Prescaler + (++) Get the Capture/Compare values + + (#) Advanced-control timers (TIM1 and TIM8) specific features + (++) Configures the Break input, dead time, Lock level, the OSSI, + the OSSR State and the AOE(automatic output enable) + (++) Enable/Disable the TIM peripheral Main Outputs + (++) Select the Commutation event + (++) Set/Reset the Capture Compare Preload Control bit + + (#) TIM interrupts, DMA and flags management + (++) Enable/Disable interrupt sources + (++) Get flags status + (++) Clear flags/ Pending bits + (++) Enable/Disable DMA requests + (++) Configure DMA burst mode + (++) Select CaptureCompare DMA request + + (#) TIM clocks management: this group includes all needed functions + to configure the clock controller unit: + (++) Select internal/External clock + (++) Select the external clock mode: ETR(Mode1/Mode2), TIx or ITRx + + (#) TIM synchronization management: this group includes all needed + functions to configure the Synchronization unit: + (++) Select Input Trigger + (++) Select Output Trigger + (++) Select Master Slave Mode + (++) ETR Configuration when used as external trigger + + (#) TIM specific interface management, this group includes all + needed functions to use the specific TIM interface: + (++) Encoder Interface Configuration + (++) Select Hall Sensor + + (#) TIM specific remapping management includes the Remapping + configuration of specific timers + + @endverbatim + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx_tim.h" +#include "stm32f4xx_rcc.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @defgroup TIM + * @brief TIM driver modules + * @{ + */ + +/* Private typedef -----------------------------------------------------------*/ +/* Private define ------------------------------------------------------------*/ + +/* ---------------------- TIM registers bit mask ------------------------ */ +#define SMCR_ETR_MASK ((uint16_t)0x00FF) +#define CCMR_OFFSET ((uint16_t)0x0018) +#define CCER_CCE_SET ((uint16_t)0x0001) +#define CCER_CCNE_SET ((uint16_t)0x0004) +#define CCMR_OC13M_MASK ((uint16_t)0xFF8F) +#define CCMR_OC24M_MASK ((uint16_t)0x8FFF) + +/* Private macro -------------------------------------------------------------*/ +/* Private variables ---------------------------------------------------------*/ +/* Private function prototypes -----------------------------------------------*/ +static void TI1_Config(TIM_TypeDef* TIMx, uint16_t TIM_ICPolarity, uint16_t TIM_ICSelection, + uint16_t TIM_ICFilter); +static void TI2_Config(TIM_TypeDef* TIMx, uint16_t TIM_ICPolarity, uint16_t TIM_ICSelection, + uint16_t TIM_ICFilter); +static void TI3_Config(TIM_TypeDef* TIMx, uint16_t TIM_ICPolarity, uint16_t TIM_ICSelection, + uint16_t TIM_ICFilter); +static void TI4_Config(TIM_TypeDef* TIMx, uint16_t TIM_ICPolarity, uint16_t TIM_ICSelection, + uint16_t TIM_ICFilter); + +/* Private functions ---------------------------------------------------------*/ + +/** @defgroup TIM_Private_Functions + * @{ + */ + +/** @defgroup TIM_Group1 TimeBase management functions + * @brief TimeBase management functions + * +@verbatim + =============================================================================== + ##### TimeBase management functions ##### + =============================================================================== + + + ##### TIM Driver: how to use it in Timing(Time base) Mode ##### + =============================================================================== + [..] + To use the Timer in Timing(Time base) mode, the following steps are mandatory: + + (#) Enable TIM clock using RCC_APBxPeriphClockCmd(RCC_APBxPeriph_TIMx, ENABLE) function + + (#) Fill the TIM_TimeBaseInitStruct with the desired parameters. + + (#) Call TIM_TimeBaseInit(TIMx, &TIM_TimeBaseInitStruct) to configure the Time Base unit + with the corresponding configuration + + (#) Enable the NVIC if you need to generate the update interrupt. + + (#) Enable the corresponding interrupt using the function TIM_ITConfig(TIMx, TIM_IT_Update) + + (#) Call the TIM_Cmd(ENABLE) function to enable the TIM counter. + + -@- All other functions can be used separately to modify, if needed, + a specific feature of the Timer. + +@endverbatim + * @{ + */ + +/** + * @brief Deinitializes the TIMx peripheral registers to their default reset values. + * @param TIMx: where x can be 1 to 14 to select the TIM peripheral. + * @retval None + + */ +void TIM_DeInit(TIM_TypeDef* TIMx) +{ + /* Check the parameters */ + assert_param(IS_TIM_ALL_PERIPH(TIMx)); + + if (TIMx == TIM1) + { + RCC_APB2PeriphResetCmd(RCC_APB2Periph_TIM1, ENABLE); + RCC_APB2PeriphResetCmd(RCC_APB2Periph_TIM1, DISABLE); + } + else if (TIMx == TIM2) + { + RCC_APB1PeriphResetCmd(RCC_APB1Periph_TIM2, ENABLE); + RCC_APB1PeriphResetCmd(RCC_APB1Periph_TIM2, DISABLE); + } + else if (TIMx == TIM3) + { + RCC_APB1PeriphResetCmd(RCC_APB1Periph_TIM3, ENABLE); + RCC_APB1PeriphResetCmd(RCC_APB1Periph_TIM3, DISABLE); + } + else if (TIMx == TIM4) + { + RCC_APB1PeriphResetCmd(RCC_APB1Periph_TIM4, ENABLE); + RCC_APB1PeriphResetCmd(RCC_APB1Periph_TIM4, DISABLE); + } + else if (TIMx == TIM5) + { + RCC_APB1PeriphResetCmd(RCC_APB1Periph_TIM5, ENABLE); + RCC_APB1PeriphResetCmd(RCC_APB1Periph_TIM5, DISABLE); + } + else if (TIMx == TIM6) + { + RCC_APB1PeriphResetCmd(RCC_APB1Periph_TIM6, ENABLE); + RCC_APB1PeriphResetCmd(RCC_APB1Periph_TIM6, DISABLE); + } + else if (TIMx == TIM7) + { + RCC_APB1PeriphResetCmd(RCC_APB1Periph_TIM7, ENABLE); + RCC_APB1PeriphResetCmd(RCC_APB1Periph_TIM7, DISABLE); + } + else if (TIMx == TIM8) + { + RCC_APB2PeriphResetCmd(RCC_APB2Periph_TIM8, ENABLE); + RCC_APB2PeriphResetCmd(RCC_APB2Periph_TIM8, DISABLE); + } + else if (TIMx == TIM9) + { + RCC_APB2PeriphResetCmd(RCC_APB2Periph_TIM9, ENABLE); + RCC_APB2PeriphResetCmd(RCC_APB2Periph_TIM9, DISABLE); + } + else if (TIMx == TIM10) + { + RCC_APB2PeriphResetCmd(RCC_APB2Periph_TIM10, ENABLE); + RCC_APB2PeriphResetCmd(RCC_APB2Periph_TIM10, DISABLE); + } + else if (TIMx == TIM11) + { + RCC_APB2PeriphResetCmd(RCC_APB2Periph_TIM11, ENABLE); + RCC_APB2PeriphResetCmd(RCC_APB2Periph_TIM11, DISABLE); + } + else if (TIMx == TIM12) + { + RCC_APB1PeriphResetCmd(RCC_APB1Periph_TIM12, ENABLE); + RCC_APB1PeriphResetCmd(RCC_APB1Periph_TIM12, DISABLE); + } + else if (TIMx == TIM13) + { + RCC_APB1PeriphResetCmd(RCC_APB1Periph_TIM13, ENABLE); + RCC_APB1PeriphResetCmd(RCC_APB1Periph_TIM13, DISABLE); + } + else + { + if (TIMx == TIM14) + { + RCC_APB1PeriphResetCmd(RCC_APB1Periph_TIM14, ENABLE); + RCC_APB1PeriphResetCmd(RCC_APB1Periph_TIM14, DISABLE); + } + } +} + +/** + * @brief Initializes the TIMx Time Base Unit peripheral according to + * the specified parameters in the TIM_TimeBaseInitStruct. + * @param TIMx: where x can be 1 to 14 to select the TIM peripheral. + * @param TIM_TimeBaseInitStruct: pointer to a TIM_TimeBaseInitTypeDef structure + * that contains the configuration information for the specified TIM peripheral. + * @retval None + */ +void TIM_TimeBaseInit(TIM_TypeDef* TIMx, TIM_TimeBaseInitTypeDef* TIM_TimeBaseInitStruct) +{ + uint16_t tmpcr1 = 0; + + /* Check the parameters */ + assert_param(IS_TIM_ALL_PERIPH(TIMx)); + assert_param(IS_TIM_COUNTER_MODE(TIM_TimeBaseInitStruct->TIM_CounterMode)); + assert_param(IS_TIM_CKD_DIV(TIM_TimeBaseInitStruct->TIM_ClockDivision)); + + tmpcr1 = TIMx->CR1; + + if((TIMx == TIM1) || (TIMx == TIM8)|| + (TIMx == TIM2) || (TIMx == TIM3)|| + (TIMx == TIM4) || (TIMx == TIM5)) + { + /* Select the Counter Mode */ + tmpcr1 &= (uint16_t)(~(TIM_CR1_DIR | TIM_CR1_CMS)); + tmpcr1 |= (uint32_t)TIM_TimeBaseInitStruct->TIM_CounterMode; + } + + if((TIMx != TIM6) && (TIMx != TIM7)) + { + /* Set the clock division */ + tmpcr1 &= (uint16_t)(~TIM_CR1_CKD); + tmpcr1 |= (uint32_t)TIM_TimeBaseInitStruct->TIM_ClockDivision; + } + + TIMx->CR1 = tmpcr1; + + /* Set the Autoreload value */ + TIMx->ARR = TIM_TimeBaseInitStruct->TIM_Period ; + + /* Set the Prescaler value */ + TIMx->PSC = TIM_TimeBaseInitStruct->TIM_Prescaler; + + if ((TIMx == TIM1) || (TIMx == TIM8)) + { + /* Set the Repetition Counter value */ + TIMx->RCR = TIM_TimeBaseInitStruct->TIM_RepetitionCounter; + } + + /* Generate an update event to reload the Prescaler + and the repetition counter(only for TIM1 and TIM8) value immediatly */ + TIMx->EGR = TIM_PSCReloadMode_Immediate; +} + +/** + * @brief Fills each TIM_TimeBaseInitStruct member with its default value. + * @param TIM_TimeBaseInitStruct : pointer to a TIM_TimeBaseInitTypeDef + * structure which will be initialized. + * @retval None + */ +void TIM_TimeBaseStructInit(TIM_TimeBaseInitTypeDef* TIM_TimeBaseInitStruct) +{ + /* Set the default configuration */ + TIM_TimeBaseInitStruct->TIM_Period = 0xFFFFFFFF; + TIM_TimeBaseInitStruct->TIM_Prescaler = 0x0000; + TIM_TimeBaseInitStruct->TIM_ClockDivision = TIM_CKD_DIV1; + TIM_TimeBaseInitStruct->TIM_CounterMode = TIM_CounterMode_Up; + TIM_TimeBaseInitStruct->TIM_RepetitionCounter = 0x0000; +} + +/** + * @brief Configures the TIMx Prescaler. + * @param TIMx: where x can be 1 to 14 to select the TIM peripheral. + * @param Prescaler: specifies the Prescaler Register value + * @param TIM_PSCReloadMode: specifies the TIM Prescaler Reload mode + * This parameter can be one of the following values: + * @arg TIM_PSCReloadMode_Update: The Prescaler is loaded at the update event. + * @arg TIM_PSCReloadMode_Immediate: The Prescaler is loaded immediatly. + * @retval None + */ +void TIM_PrescalerConfig(TIM_TypeDef* TIMx, uint16_t Prescaler, uint16_t TIM_PSCReloadMode) +{ + /* Check the parameters */ + assert_param(IS_TIM_ALL_PERIPH(TIMx)); + assert_param(IS_TIM_PRESCALER_RELOAD(TIM_PSCReloadMode)); + /* Set the Prescaler value */ + TIMx->PSC = Prescaler; + /* Set or reset the UG Bit */ + TIMx->EGR = TIM_PSCReloadMode; +} + +/** + * @brief Specifies the TIMx Counter Mode to be used. + * @param TIMx: where x can be 1, 2, 3, 4, 5 or 8 to select the TIM peripheral. + * @param TIM_CounterMode: specifies the Counter Mode to be used + * This parameter can be one of the following values: + * @arg TIM_CounterMode_Up: TIM Up Counting Mode + * @arg TIM_CounterMode_Down: TIM Down Counting Mode + * @arg TIM_CounterMode_CenterAligned1: TIM Center Aligned Mode1 + * @arg TIM_CounterMode_CenterAligned2: TIM Center Aligned Mode2 + * @arg TIM_CounterMode_CenterAligned3: TIM Center Aligned Mode3 + * @retval None + */ +void TIM_CounterModeConfig(TIM_TypeDef* TIMx, uint16_t TIM_CounterMode) +{ + uint16_t tmpcr1 = 0; + + /* Check the parameters */ + assert_param(IS_TIM_LIST3_PERIPH(TIMx)); + assert_param(IS_TIM_COUNTER_MODE(TIM_CounterMode)); + + tmpcr1 = TIMx->CR1; + + /* Reset the CMS and DIR Bits */ + tmpcr1 &= (uint16_t)~(TIM_CR1_DIR | TIM_CR1_CMS); + + /* Set the Counter Mode */ + tmpcr1 |= TIM_CounterMode; + + /* Write to TIMx CR1 register */ + TIMx->CR1 = tmpcr1; +} + +/** + * @brief Sets the TIMx Counter Register value + * @param TIMx: where x can be 1 to 14 to select the TIM peripheral. + * @param Counter: specifies the Counter register new value. + * @retval None + */ +void TIM_SetCounter(TIM_TypeDef* TIMx, uint32_t Counter) +{ + /* Check the parameters */ + assert_param(IS_TIM_ALL_PERIPH(TIMx)); + + /* Set the Counter Register value */ + TIMx->CNT = Counter; +} + +/** + * @brief Sets the TIMx Autoreload Register value + * @param TIMx: where x can be 1 to 14 to select the TIM peripheral. + * @param Autoreload: specifies the Autoreload register new value. + * @retval None + */ +void TIM_SetAutoreload(TIM_TypeDef* TIMx, uint32_t Autoreload) +{ + /* Check the parameters */ + assert_param(IS_TIM_ALL_PERIPH(TIMx)); + + /* Set the Autoreload Register value */ + TIMx->ARR = Autoreload; +} + +/** + * @brief Gets the TIMx Counter value. + * @param TIMx: where x can be 1 to 14 to select the TIM peripheral. + * @retval Counter Register value + */ +uint32_t TIM_GetCounter(TIM_TypeDef* TIMx) +{ + /* Check the parameters */ + assert_param(IS_TIM_ALL_PERIPH(TIMx)); + + /* Get the Counter Register value */ + return TIMx->CNT; +} + +/** + * @brief Gets the TIMx Prescaler value. + * @param TIMx: where x can be 1 to 14 to select the TIM peripheral. + * @retval Prescaler Register value. + */ +uint16_t TIM_GetPrescaler(TIM_TypeDef* TIMx) +{ + /* Check the parameters */ + assert_param(IS_TIM_ALL_PERIPH(TIMx)); + + /* Get the Prescaler Register value */ + return TIMx->PSC; +} + +/** + * @brief Enables or Disables the TIMx Update event. + * @param TIMx: where x can be 1 to 14 to select the TIM peripheral. + * @param NewState: new state of the TIMx UDIS bit + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void TIM_UpdateDisableConfig(TIM_TypeDef* TIMx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_TIM_ALL_PERIPH(TIMx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Set the Update Disable Bit */ + TIMx->CR1 |= TIM_CR1_UDIS; + } + else + { + /* Reset the Update Disable Bit */ + TIMx->CR1 &= (uint16_t)~TIM_CR1_UDIS; + } +} + +/** + * @brief Configures the TIMx Update Request Interrupt source. + * @param TIMx: where x can be 1 to 14 to select the TIM peripheral. + * @param TIM_UpdateSource: specifies the Update source. + * This parameter can be one of the following values: + * @arg TIM_UpdateSource_Global: Source of update is the counter + * overflow/underflow or the setting of UG bit, or an update + * generation through the slave mode controller. + * @arg TIM_UpdateSource_Regular: Source of update is counter overflow/underflow. + * @retval None + */ +void TIM_UpdateRequestConfig(TIM_TypeDef* TIMx, uint16_t TIM_UpdateSource) +{ + /* Check the parameters */ + assert_param(IS_TIM_ALL_PERIPH(TIMx)); + assert_param(IS_TIM_UPDATE_SOURCE(TIM_UpdateSource)); + + if (TIM_UpdateSource != TIM_UpdateSource_Global) + { + /* Set the URS Bit */ + TIMx->CR1 |= TIM_CR1_URS; + } + else + { + /* Reset the URS Bit */ + TIMx->CR1 &= (uint16_t)~TIM_CR1_URS; + } +} + +/** + * @brief Enables or disables TIMx peripheral Preload register on ARR. + * @param TIMx: where x can be 1 to 14 to select the TIM peripheral. + * @param NewState: new state of the TIMx peripheral Preload register + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void TIM_ARRPreloadConfig(TIM_TypeDef* TIMx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_TIM_ALL_PERIPH(TIMx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Set the ARR Preload Bit */ + TIMx->CR1 |= TIM_CR1_ARPE; + } + else + { + /* Reset the ARR Preload Bit */ + TIMx->CR1 &= (uint16_t)~TIM_CR1_ARPE; + } +} + +/** + * @brief Selects the TIMx's One Pulse Mode. + * @param TIMx: where x can be 1 to 14 to select the TIM peripheral. + * @param TIM_OPMode: specifies the OPM Mode to be used. + * This parameter can be one of the following values: + * @arg TIM_OPMode_Single + * @arg TIM_OPMode_Repetitive + * @retval None + */ +void TIM_SelectOnePulseMode(TIM_TypeDef* TIMx, uint16_t TIM_OPMode) +{ + /* Check the parameters */ + assert_param(IS_TIM_ALL_PERIPH(TIMx)); + assert_param(IS_TIM_OPM_MODE(TIM_OPMode)); + + /* Reset the OPM Bit */ + TIMx->CR1 &= (uint16_t)~TIM_CR1_OPM; + + /* Configure the OPM Mode */ + TIMx->CR1 |= TIM_OPMode; +} + +/** + * @brief Sets the TIMx Clock Division value. + * @param TIMx: where x can be 1 to 14 except 6 and 7, to select the TIM peripheral. + * @param TIM_CKD: specifies the clock division value. + * This parameter can be one of the following value: + * @arg TIM_CKD_DIV1: TDTS = Tck_tim + * @arg TIM_CKD_DIV2: TDTS = 2*Tck_tim + * @arg TIM_CKD_DIV4: TDTS = 4*Tck_tim + * @retval None + */ +void TIM_SetClockDivision(TIM_TypeDef* TIMx, uint16_t TIM_CKD) +{ + /* Check the parameters */ + assert_param(IS_TIM_LIST1_PERIPH(TIMx)); + assert_param(IS_TIM_CKD_DIV(TIM_CKD)); + + /* Reset the CKD Bits */ + TIMx->CR1 &= (uint16_t)(~TIM_CR1_CKD); + + /* Set the CKD value */ + TIMx->CR1 |= TIM_CKD; +} + +/** + * @brief Enables or disables the specified TIM peripheral. + * @param TIMx: where x can be 1 to 14 to select the TIMx peripheral. + * @param NewState: new state of the TIMx peripheral. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void TIM_Cmd(TIM_TypeDef* TIMx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_TIM_ALL_PERIPH(TIMx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the TIM Counter */ + TIMx->CR1 |= TIM_CR1_CEN; + } + else + { + /* Disable the TIM Counter */ + TIMx->CR1 &= (uint16_t)~TIM_CR1_CEN; + } +} +/** + * @} + */ + +/** @defgroup TIM_Group2 Output Compare management functions + * @brief Output Compare management functions + * +@verbatim + =============================================================================== + ##### Output Compare management functions ##### + =============================================================================== + + + ##### TIM Driver: how to use it in Output Compare Mode ##### + =============================================================================== + [..] + To use the Timer in Output Compare mode, the following steps are mandatory: + + (#) Enable TIM clock using RCC_APBxPeriphClockCmd(RCC_APBxPeriph_TIMx, ENABLE) + function + + (#) Configure the TIM pins by configuring the corresponding GPIO pins + + (#) Configure the Time base unit as described in the first part of this driver, + (++) if needed, else the Timer will run with the default configuration: + Autoreload value = 0xFFFF + (++) Prescaler value = 0x0000 + (++) Counter mode = Up counting + (++) Clock Division = TIM_CKD_DIV1 + + (#) Fill the TIM_OCInitStruct with the desired parameters including: + (++) The TIM Output Compare mode: TIM_OCMode + (++) TIM Output State: TIM_OutputState + (++) TIM Pulse value: TIM_Pulse + (++) TIM Output Compare Polarity : TIM_OCPolarity + + (#) Call TIM_OCxInit(TIMx, &TIM_OCInitStruct) to configure the desired + channel with the corresponding configuration + + (#) Call the TIM_Cmd(ENABLE) function to enable the TIM counter. + + -@- All other functions can be used separately to modify, if needed, + a specific feature of the Timer. + + -@- In case of PWM mode, this function is mandatory: + TIM_OCxPreloadConfig(TIMx, TIM_OCPreload_ENABLE); + + -@- If the corresponding interrupt or DMA request are needed, the user should: + (+@) Enable the NVIC (or the DMA) to use the TIM interrupts (or DMA requests). + (+@) Enable the corresponding interrupt (or DMA request) using the function + TIM_ITConfig(TIMx, TIM_IT_CCx) (or TIM_DMA_Cmd(TIMx, TIM_DMA_CCx)) + +@endverbatim + * @{ + */ + +/** + * @brief Initializes the TIMx Channel1 according to the specified parameters in + * the TIM_OCInitStruct. + * @param TIMx: where x can be 1 to 14 except 6 and 7, to select the TIM peripheral. + * @param TIM_OCInitStruct: pointer to a TIM_OCInitTypeDef structure that contains + * the configuration information for the specified TIM peripheral. + * @retval None + */ +void TIM_OC1Init(TIM_TypeDef* TIMx, TIM_OCInitTypeDef* TIM_OCInitStruct) +{ + uint16_t tmpccmrx = 0, tmpccer = 0, tmpcr2 = 0; + + /* Check the parameters */ + assert_param(IS_TIM_LIST1_PERIPH(TIMx)); + assert_param(IS_TIM_OC_MODE(TIM_OCInitStruct->TIM_OCMode)); + assert_param(IS_TIM_OUTPUT_STATE(TIM_OCInitStruct->TIM_OutputState)); + assert_param(IS_TIM_OC_POLARITY(TIM_OCInitStruct->TIM_OCPolarity)); + + /* Disable the Channel 1: Reset the CC1E Bit */ + TIMx->CCER &= (uint16_t)~TIM_CCER_CC1E; + + /* Get the TIMx CCER register value */ + tmpccer = TIMx->CCER; + /* Get the TIMx CR2 register value */ + tmpcr2 = TIMx->CR2; + + /* Get the TIMx CCMR1 register value */ + tmpccmrx = TIMx->CCMR1; + + /* Reset the Output Compare Mode Bits */ + tmpccmrx &= (uint16_t)~TIM_CCMR1_OC1M; + tmpccmrx &= (uint16_t)~TIM_CCMR1_CC1S; + /* Select the Output Compare Mode */ + tmpccmrx |= TIM_OCInitStruct->TIM_OCMode; + + /* Reset the Output Polarity level */ + tmpccer &= (uint16_t)~TIM_CCER_CC1P; + /* Set the Output Compare Polarity */ + tmpccer |= TIM_OCInitStruct->TIM_OCPolarity; + + /* Set the Output State */ + tmpccer |= TIM_OCInitStruct->TIM_OutputState; + + if((TIMx == TIM1) || (TIMx == TIM8)) + { + assert_param(IS_TIM_OUTPUTN_STATE(TIM_OCInitStruct->TIM_OutputNState)); + assert_param(IS_TIM_OCN_POLARITY(TIM_OCInitStruct->TIM_OCNPolarity)); + assert_param(IS_TIM_OCNIDLE_STATE(TIM_OCInitStruct->TIM_OCNIdleState)); + assert_param(IS_TIM_OCIDLE_STATE(TIM_OCInitStruct->TIM_OCIdleState)); + + /* Reset the Output N Polarity level */ + tmpccer &= (uint16_t)~TIM_CCER_CC1NP; + /* Set the Output N Polarity */ + tmpccer |= TIM_OCInitStruct->TIM_OCNPolarity; + /* Reset the Output N State */ + tmpccer &= (uint16_t)~TIM_CCER_CC1NE; + + /* Set the Output N State */ + tmpccer |= TIM_OCInitStruct->TIM_OutputNState; + /* Reset the Output Compare and Output Compare N IDLE State */ + tmpcr2 &= (uint16_t)~TIM_CR2_OIS1; + tmpcr2 &= (uint16_t)~TIM_CR2_OIS1N; + /* Set the Output Idle state */ + tmpcr2 |= TIM_OCInitStruct->TIM_OCIdleState; + /* Set the Output N Idle state */ + tmpcr2 |= TIM_OCInitStruct->TIM_OCNIdleState; + } + /* Write to TIMx CR2 */ + TIMx->CR2 = tmpcr2; + + /* Write to TIMx CCMR1 */ + TIMx->CCMR1 = tmpccmrx; + + /* Set the Capture Compare Register value */ + TIMx->CCR1 = TIM_OCInitStruct->TIM_Pulse; + + /* Write to TIMx CCER */ + TIMx->CCER = tmpccer; +} + +/** + * @brief Initializes the TIMx Channel2 according to the specified parameters + * in the TIM_OCInitStruct. + * @param TIMx: where x can be 1, 2, 3, 4, 5, 8, 9 or 12 to select the TIM + * peripheral. + * @param TIM_OCInitStruct: pointer to a TIM_OCInitTypeDef structure that contains + * the configuration information for the specified TIM peripheral. + * @retval None + */ +void TIM_OC2Init(TIM_TypeDef* TIMx, TIM_OCInitTypeDef* TIM_OCInitStruct) +{ + uint16_t tmpccmrx = 0, tmpccer = 0, tmpcr2 = 0; + + /* Check the parameters */ + assert_param(IS_TIM_LIST2_PERIPH(TIMx)); + assert_param(IS_TIM_OC_MODE(TIM_OCInitStruct->TIM_OCMode)); + assert_param(IS_TIM_OUTPUT_STATE(TIM_OCInitStruct->TIM_OutputState)); + assert_param(IS_TIM_OC_POLARITY(TIM_OCInitStruct->TIM_OCPolarity)); + + /* Disable the Channel 2: Reset the CC2E Bit */ + TIMx->CCER &= (uint16_t)~TIM_CCER_CC2E; + + /* Get the TIMx CCER register value */ + tmpccer = TIMx->CCER; + /* Get the TIMx CR2 register value */ + tmpcr2 = TIMx->CR2; + + /* Get the TIMx CCMR1 register value */ + tmpccmrx = TIMx->CCMR1; + + /* Reset the Output Compare mode and Capture/Compare selection Bits */ + tmpccmrx &= (uint16_t)~TIM_CCMR1_OC2M; + tmpccmrx &= (uint16_t)~TIM_CCMR1_CC2S; + + /* Select the Output Compare Mode */ + tmpccmrx |= (uint16_t)(TIM_OCInitStruct->TIM_OCMode << 8); + + /* Reset the Output Polarity level */ + tmpccer &= (uint16_t)~TIM_CCER_CC2P; + /* Set the Output Compare Polarity */ + tmpccer |= (uint16_t)(TIM_OCInitStruct->TIM_OCPolarity << 4); + + /* Set the Output State */ + tmpccer |= (uint16_t)(TIM_OCInitStruct->TIM_OutputState << 4); + + if((TIMx == TIM1) || (TIMx == TIM8)) + { + assert_param(IS_TIM_OUTPUTN_STATE(TIM_OCInitStruct->TIM_OutputNState)); + assert_param(IS_TIM_OCN_POLARITY(TIM_OCInitStruct->TIM_OCNPolarity)); + assert_param(IS_TIM_OCNIDLE_STATE(TIM_OCInitStruct->TIM_OCNIdleState)); + assert_param(IS_TIM_OCIDLE_STATE(TIM_OCInitStruct->TIM_OCIdleState)); + + /* Reset the Output N Polarity level */ + tmpccer &= (uint16_t)~TIM_CCER_CC2NP; + /* Set the Output N Polarity */ + tmpccer |= (uint16_t)(TIM_OCInitStruct->TIM_OCNPolarity << 4); + /* Reset the Output N State */ + tmpccer &= (uint16_t)~TIM_CCER_CC2NE; + + /* Set the Output N State */ + tmpccer |= (uint16_t)(TIM_OCInitStruct->TIM_OutputNState << 4); + /* Reset the Output Compare and Output Compare N IDLE State */ + tmpcr2 &= (uint16_t)~TIM_CR2_OIS2; + tmpcr2 &= (uint16_t)~TIM_CR2_OIS2N; + /* Set the Output Idle state */ + tmpcr2 |= (uint16_t)(TIM_OCInitStruct->TIM_OCIdleState << 2); + /* Set the Output N Idle state */ + tmpcr2 |= (uint16_t)(TIM_OCInitStruct->TIM_OCNIdleState << 2); + } + /* Write to TIMx CR2 */ + TIMx->CR2 = tmpcr2; + + /* Write to TIMx CCMR1 */ + TIMx->CCMR1 = tmpccmrx; + + /* Set the Capture Compare Register value */ + TIMx->CCR2 = TIM_OCInitStruct->TIM_Pulse; + + /* Write to TIMx CCER */ + TIMx->CCER = tmpccer; +} + +/** + * @brief Initializes the TIMx Channel3 according to the specified parameters + * in the TIM_OCInitStruct. + * @param TIMx: where x can be 1, 2, 3, 4, 5 or 8 to select the TIM peripheral. + * @param TIM_OCInitStruct: pointer to a TIM_OCInitTypeDef structure that contains + * the configuration information for the specified TIM peripheral. + * @retval None + */ +void TIM_OC3Init(TIM_TypeDef* TIMx, TIM_OCInitTypeDef* TIM_OCInitStruct) +{ + uint16_t tmpccmrx = 0, tmpccer = 0, tmpcr2 = 0; + + /* Check the parameters */ + assert_param(IS_TIM_LIST3_PERIPH(TIMx)); + assert_param(IS_TIM_OC_MODE(TIM_OCInitStruct->TIM_OCMode)); + assert_param(IS_TIM_OUTPUT_STATE(TIM_OCInitStruct->TIM_OutputState)); + assert_param(IS_TIM_OC_POLARITY(TIM_OCInitStruct->TIM_OCPolarity)); + + /* Disable the Channel 3: Reset the CC2E Bit */ + TIMx->CCER &= (uint16_t)~TIM_CCER_CC3E; + + /* Get the TIMx CCER register value */ + tmpccer = TIMx->CCER; + /* Get the TIMx CR2 register value */ + tmpcr2 = TIMx->CR2; + + /* Get the TIMx CCMR2 register value */ + tmpccmrx = TIMx->CCMR2; + + /* Reset the Output Compare mode and Capture/Compare selection Bits */ + tmpccmrx &= (uint16_t)~TIM_CCMR2_OC3M; + tmpccmrx &= (uint16_t)~TIM_CCMR2_CC3S; + /* Select the Output Compare Mode */ + tmpccmrx |= TIM_OCInitStruct->TIM_OCMode; + + /* Reset the Output Polarity level */ + tmpccer &= (uint16_t)~TIM_CCER_CC3P; + /* Set the Output Compare Polarity */ + tmpccer |= (uint16_t)(TIM_OCInitStruct->TIM_OCPolarity << 8); + + /* Set the Output State */ + tmpccer |= (uint16_t)(TIM_OCInitStruct->TIM_OutputState << 8); + + if((TIMx == TIM1) || (TIMx == TIM8)) + { + assert_param(IS_TIM_OUTPUTN_STATE(TIM_OCInitStruct->TIM_OutputNState)); + assert_param(IS_TIM_OCN_POLARITY(TIM_OCInitStruct->TIM_OCNPolarity)); + assert_param(IS_TIM_OCNIDLE_STATE(TIM_OCInitStruct->TIM_OCNIdleState)); + assert_param(IS_TIM_OCIDLE_STATE(TIM_OCInitStruct->TIM_OCIdleState)); + + /* Reset the Output N Polarity level */ + tmpccer &= (uint16_t)~TIM_CCER_CC3NP; + /* Set the Output N Polarity */ + tmpccer |= (uint16_t)(TIM_OCInitStruct->TIM_OCNPolarity << 8); + /* Reset the Output N State */ + tmpccer &= (uint16_t)~TIM_CCER_CC3NE; + + /* Set the Output N State */ + tmpccer |= (uint16_t)(TIM_OCInitStruct->TIM_OutputNState << 8); + /* Reset the Output Compare and Output Compare N IDLE State */ + tmpcr2 &= (uint16_t)~TIM_CR2_OIS3; + tmpcr2 &= (uint16_t)~TIM_CR2_OIS3N; + /* Set the Output Idle state */ + tmpcr2 |= (uint16_t)(TIM_OCInitStruct->TIM_OCIdleState << 4); + /* Set the Output N Idle state */ + tmpcr2 |= (uint16_t)(TIM_OCInitStruct->TIM_OCNIdleState << 4); + } + /* Write to TIMx CR2 */ + TIMx->CR2 = tmpcr2; + + /* Write to TIMx CCMR2 */ + TIMx->CCMR2 = tmpccmrx; + + /* Set the Capture Compare Register value */ + TIMx->CCR3 = TIM_OCInitStruct->TIM_Pulse; + + /* Write to TIMx CCER */ + TIMx->CCER = tmpccer; +} + +/** + * @brief Initializes the TIMx Channel4 according to the specified parameters + * in the TIM_OCInitStruct. + * @param TIMx: where x can be 1, 2, 3, 4, 5 or 8 to select the TIM peripheral. + * @param TIM_OCInitStruct: pointer to a TIM_OCInitTypeDef structure that contains + * the configuration information for the specified TIM peripheral. + * @retval None + */ +void TIM_OC4Init(TIM_TypeDef* TIMx, TIM_OCInitTypeDef* TIM_OCInitStruct) +{ + uint16_t tmpccmrx = 0, tmpccer = 0, tmpcr2 = 0; + + /* Check the parameters */ + assert_param(IS_TIM_LIST3_PERIPH(TIMx)); + assert_param(IS_TIM_OC_MODE(TIM_OCInitStruct->TIM_OCMode)); + assert_param(IS_TIM_OUTPUT_STATE(TIM_OCInitStruct->TIM_OutputState)); + assert_param(IS_TIM_OC_POLARITY(TIM_OCInitStruct->TIM_OCPolarity)); + + /* Disable the Channel 4: Reset the CC4E Bit */ + TIMx->CCER &= (uint16_t)~TIM_CCER_CC4E; + + /* Get the TIMx CCER register value */ + tmpccer = TIMx->CCER; + /* Get the TIMx CR2 register value */ + tmpcr2 = TIMx->CR2; + + /* Get the TIMx CCMR2 register value */ + tmpccmrx = TIMx->CCMR2; + + /* Reset the Output Compare mode and Capture/Compare selection Bits */ + tmpccmrx &= (uint16_t)~TIM_CCMR2_OC4M; + tmpccmrx &= (uint16_t)~TIM_CCMR2_CC4S; + + /* Select the Output Compare Mode */ + tmpccmrx |= (uint16_t)(TIM_OCInitStruct->TIM_OCMode << 8); + + /* Reset the Output Polarity level */ + tmpccer &= (uint16_t)~TIM_CCER_CC4P; + /* Set the Output Compare Polarity */ + tmpccer |= (uint16_t)(TIM_OCInitStruct->TIM_OCPolarity << 12); + + /* Set the Output State */ + tmpccer |= (uint16_t)(TIM_OCInitStruct->TIM_OutputState << 12); + + if((TIMx == TIM1) || (TIMx == TIM8)) + { + assert_param(IS_TIM_OCIDLE_STATE(TIM_OCInitStruct->TIM_OCIdleState)); + /* Reset the Output Compare IDLE State */ + tmpcr2 &=(uint16_t) ~TIM_CR2_OIS4; + /* Set the Output Idle state */ + tmpcr2 |= (uint16_t)(TIM_OCInitStruct->TIM_OCIdleState << 6); + } + /* Write to TIMx CR2 */ + TIMx->CR2 = tmpcr2; + + /* Write to TIMx CCMR2 */ + TIMx->CCMR2 = tmpccmrx; + + /* Set the Capture Compare Register value */ + TIMx->CCR4 = TIM_OCInitStruct->TIM_Pulse; + + /* Write to TIMx CCER */ + TIMx->CCER = tmpccer; +} + +/** + * @brief Fills each TIM_OCInitStruct member with its default value. + * @param TIM_OCInitStruct: pointer to a TIM_OCInitTypeDef structure which will + * be initialized. + * @retval None + */ +void TIM_OCStructInit(TIM_OCInitTypeDef* TIM_OCInitStruct) +{ + /* Set the default configuration */ + TIM_OCInitStruct->TIM_OCMode = TIM_OCMode_Timing; + TIM_OCInitStruct->TIM_OutputState = TIM_OutputState_Disable; + TIM_OCInitStruct->TIM_OutputNState = TIM_OutputNState_Disable; + TIM_OCInitStruct->TIM_Pulse = 0x00000000; + TIM_OCInitStruct->TIM_OCPolarity = TIM_OCPolarity_High; + TIM_OCInitStruct->TIM_OCNPolarity = TIM_OCPolarity_High; + TIM_OCInitStruct->TIM_OCIdleState = TIM_OCIdleState_Reset; + TIM_OCInitStruct->TIM_OCNIdleState = TIM_OCNIdleState_Reset; +} + +/** + * @brief Selects the TIM Output Compare Mode. + * @note This function disables the selected channel before changing the Output + * Compare Mode. If needed, user has to enable this channel using + * TIM_CCxCmd() and TIM_CCxNCmd() functions. + * @param TIMx: where x can be 1 to 14 except 6 and 7, to select the TIM peripheral. + * @param TIM_Channel: specifies the TIM Channel + * This parameter can be one of the following values: + * @arg TIM_Channel_1: TIM Channel 1 + * @arg TIM_Channel_2: TIM Channel 2 + * @arg TIM_Channel_3: TIM Channel 3 + * @arg TIM_Channel_4: TIM Channel 4 + * @param TIM_OCMode: specifies the TIM Output Compare Mode. + * This parameter can be one of the following values: + * @arg TIM_OCMode_Timing + * @arg TIM_OCMode_Active + * @arg TIM_OCMode_Toggle + * @arg TIM_OCMode_PWM1 + * @arg TIM_OCMode_PWM2 + * @arg TIM_ForcedAction_Active + * @arg TIM_ForcedAction_InActive + * @retval None + */ +void TIM_SelectOCxM(TIM_TypeDef* TIMx, uint16_t TIM_Channel, uint16_t TIM_OCMode) +{ + uint32_t tmp = 0; + uint16_t tmp1 = 0; + + /* Check the parameters */ + assert_param(IS_TIM_LIST1_PERIPH(TIMx)); + assert_param(IS_TIM_CHANNEL(TIM_Channel)); + assert_param(IS_TIM_OCM(TIM_OCMode)); + + tmp = (uint32_t) TIMx; + tmp += CCMR_OFFSET; + + tmp1 = CCER_CCE_SET << (uint16_t)TIM_Channel; + + /* Disable the Channel: Reset the CCxE Bit */ + TIMx->CCER &= (uint16_t) ~tmp1; + + if((TIM_Channel == TIM_Channel_1) ||(TIM_Channel == TIM_Channel_3)) + { + tmp += (TIM_Channel>>1); + + /* Reset the OCxM bits in the CCMRx register */ + *(__IO uint32_t *) tmp &= CCMR_OC13M_MASK; + + /* Configure the OCxM bits in the CCMRx register */ + *(__IO uint32_t *) tmp |= TIM_OCMode; + } + else + { + tmp += (uint16_t)(TIM_Channel - (uint16_t)4)>> (uint16_t)1; + + /* Reset the OCxM bits in the CCMRx register */ + *(__IO uint32_t *) tmp &= CCMR_OC24M_MASK; + + /* Configure the OCxM bits in the CCMRx register */ + *(__IO uint32_t *) tmp |= (uint16_t)(TIM_OCMode << 8); + } +} + +/** + * @brief Sets the TIMx Capture Compare1 Register value + * @param TIMx: where x can be 1 to 14 except 6 and 7, to select the TIM peripheral. + * @param Compare1: specifies the Capture Compare1 register new value. + * @retval None + */ +void TIM_SetCompare1(TIM_TypeDef* TIMx, uint32_t Compare1) +{ + /* Check the parameters */ + assert_param(IS_TIM_LIST1_PERIPH(TIMx)); + + /* Set the Capture Compare1 Register value */ + TIMx->CCR1 = Compare1; +} + +/** + * @brief Sets the TIMx Capture Compare2 Register value + * @param TIMx: where x can be 1, 2, 3, 4, 5, 8, 9 or 12 to select the TIM + * peripheral. + * @param Compare2: specifies the Capture Compare2 register new value. + * @retval None + */ +void TIM_SetCompare2(TIM_TypeDef* TIMx, uint32_t Compare2) +{ + /* Check the parameters */ + assert_param(IS_TIM_LIST2_PERIPH(TIMx)); + + /* Set the Capture Compare2 Register value */ + TIMx->CCR2 = Compare2; +} + +/** + * @brief Sets the TIMx Capture Compare3 Register value + * @param TIMx: where x can be 1, 2, 3, 4, 5 or 8 to select the TIM peripheral. + * @param Compare3: specifies the Capture Compare3 register new value. + * @retval None + */ +void TIM_SetCompare3(TIM_TypeDef* TIMx, uint32_t Compare3) +{ + /* Check the parameters */ + assert_param(IS_TIM_LIST3_PERIPH(TIMx)); + + /* Set the Capture Compare3 Register value */ + TIMx->CCR3 = Compare3; +} + +/** + * @brief Sets the TIMx Capture Compare4 Register value + * @param TIMx: where x can be 1, 2, 3, 4, 5 or 8 to select the TIM peripheral. + * @param Compare4: specifies the Capture Compare4 register new value. + * @retval None + */ +void TIM_SetCompare4(TIM_TypeDef* TIMx, uint32_t Compare4) +{ + /* Check the parameters */ + assert_param(IS_TIM_LIST3_PERIPH(TIMx)); + + /* Set the Capture Compare4 Register value */ + TIMx->CCR4 = Compare4; +} + +/** + * @brief Forces the TIMx output 1 waveform to active or inactive level. + * @param TIMx: where x can be 1 to 14 except 6 and 7, to select the TIM peripheral. + * @param TIM_ForcedAction: specifies the forced Action to be set to the output waveform. + * This parameter can be one of the following values: + * @arg TIM_ForcedAction_Active: Force active level on OC1REF + * @arg TIM_ForcedAction_InActive: Force inactive level on OC1REF. + * @retval None + */ +void TIM_ForcedOC1Config(TIM_TypeDef* TIMx, uint16_t TIM_ForcedAction) +{ + uint16_t tmpccmr1 = 0; + + /* Check the parameters */ + assert_param(IS_TIM_LIST1_PERIPH(TIMx)); + assert_param(IS_TIM_FORCED_ACTION(TIM_ForcedAction)); + tmpccmr1 = TIMx->CCMR1; + + /* Reset the OC1M Bits */ + tmpccmr1 &= (uint16_t)~TIM_CCMR1_OC1M; + + /* Configure The Forced output Mode */ + tmpccmr1 |= TIM_ForcedAction; + + /* Write to TIMx CCMR1 register */ + TIMx->CCMR1 = tmpccmr1; +} + +/** + * @brief Forces the TIMx output 2 waveform to active or inactive level. + * @param TIMx: where x can be 1, 2, 3, 4, 5, 8, 9 or 12 to select the TIM + * peripheral. + * @param TIM_ForcedAction: specifies the forced Action to be set to the output waveform. + * This parameter can be one of the following values: + * @arg TIM_ForcedAction_Active: Force active level on OC2REF + * @arg TIM_ForcedAction_InActive: Force inactive level on OC2REF. + * @retval None + */ +void TIM_ForcedOC2Config(TIM_TypeDef* TIMx, uint16_t TIM_ForcedAction) +{ + uint16_t tmpccmr1 = 0; + + /* Check the parameters */ + assert_param(IS_TIM_LIST2_PERIPH(TIMx)); + assert_param(IS_TIM_FORCED_ACTION(TIM_ForcedAction)); + tmpccmr1 = TIMx->CCMR1; + + /* Reset the OC2M Bits */ + tmpccmr1 &= (uint16_t)~TIM_CCMR1_OC2M; + + /* Configure The Forced output Mode */ + tmpccmr1 |= (uint16_t)(TIM_ForcedAction << 8); + + /* Write to TIMx CCMR1 register */ + TIMx->CCMR1 = tmpccmr1; +} + +/** + * @brief Forces the TIMx output 3 waveform to active or inactive level. + * @param TIMx: where x can be 1, 2, 3, 4, 5 or 8 to select the TIM peripheral. + * @param TIM_ForcedAction: specifies the forced Action to be set to the output waveform. + * This parameter can be one of the following values: + * @arg TIM_ForcedAction_Active: Force active level on OC3REF + * @arg TIM_ForcedAction_InActive: Force inactive level on OC3REF. + * @retval None + */ +void TIM_ForcedOC3Config(TIM_TypeDef* TIMx, uint16_t TIM_ForcedAction) +{ + uint16_t tmpccmr2 = 0; + + /* Check the parameters */ + assert_param(IS_TIM_LIST3_PERIPH(TIMx)); + assert_param(IS_TIM_FORCED_ACTION(TIM_ForcedAction)); + + tmpccmr2 = TIMx->CCMR2; + + /* Reset the OC1M Bits */ + tmpccmr2 &= (uint16_t)~TIM_CCMR2_OC3M; + + /* Configure The Forced output Mode */ + tmpccmr2 |= TIM_ForcedAction; + + /* Write to TIMx CCMR2 register */ + TIMx->CCMR2 = tmpccmr2; +} + +/** + * @brief Forces the TIMx output 4 waveform to active or inactive level. + * @param TIMx: where x can be 1, 2, 3, 4, 5 or 8 to select the TIM peripheral. + * @param TIM_ForcedAction: specifies the forced Action to be set to the output waveform. + * This parameter can be one of the following values: + * @arg TIM_ForcedAction_Active: Force active level on OC4REF + * @arg TIM_ForcedAction_InActive: Force inactive level on OC4REF. + * @retval None + */ +void TIM_ForcedOC4Config(TIM_TypeDef* TIMx, uint16_t TIM_ForcedAction) +{ + uint16_t tmpccmr2 = 0; + + /* Check the parameters */ + assert_param(IS_TIM_LIST3_PERIPH(TIMx)); + assert_param(IS_TIM_FORCED_ACTION(TIM_ForcedAction)); + tmpccmr2 = TIMx->CCMR2; + + /* Reset the OC2M Bits */ + tmpccmr2 &= (uint16_t)~TIM_CCMR2_OC4M; + + /* Configure The Forced output Mode */ + tmpccmr2 |= (uint16_t)(TIM_ForcedAction << 8); + + /* Write to TIMx CCMR2 register */ + TIMx->CCMR2 = tmpccmr2; +} + +/** + * @brief Enables or disables the TIMx peripheral Preload register on CCR1. + * @param TIMx: where x can be 1 to 14 except 6 and 7, to select the TIM peripheral. + * @param TIM_OCPreload: new state of the TIMx peripheral Preload register + * This parameter can be one of the following values: + * @arg TIM_OCPreload_Enable + * @arg TIM_OCPreload_Disable + * @retval None + */ +void TIM_OC1PreloadConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCPreload) +{ + uint16_t tmpccmr1 = 0; + + /* Check the parameters */ + assert_param(IS_TIM_LIST1_PERIPH(TIMx)); + assert_param(IS_TIM_OCPRELOAD_STATE(TIM_OCPreload)); + + tmpccmr1 = TIMx->CCMR1; + + /* Reset the OC1PE Bit */ + tmpccmr1 &= (uint16_t)(~TIM_CCMR1_OC1PE); + + /* Enable or Disable the Output Compare Preload feature */ + tmpccmr1 |= TIM_OCPreload; + + /* Write to TIMx CCMR1 register */ + TIMx->CCMR1 = tmpccmr1; +} + +/** + * @brief Enables or disables the TIMx peripheral Preload register on CCR2. + * @param TIMx: where x can be 1, 2, 3, 4, 5, 8, 9 or 12 to select the TIM + * peripheral. + * @param TIM_OCPreload: new state of the TIMx peripheral Preload register + * This parameter can be one of the following values: + * @arg TIM_OCPreload_Enable + * @arg TIM_OCPreload_Disable + * @retval None + */ +void TIM_OC2PreloadConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCPreload) +{ + uint16_t tmpccmr1 = 0; + + /* Check the parameters */ + assert_param(IS_TIM_LIST2_PERIPH(TIMx)); + assert_param(IS_TIM_OCPRELOAD_STATE(TIM_OCPreload)); + + tmpccmr1 = TIMx->CCMR1; + + /* Reset the OC2PE Bit */ + tmpccmr1 &= (uint16_t)(~TIM_CCMR1_OC2PE); + + /* Enable or Disable the Output Compare Preload feature */ + tmpccmr1 |= (uint16_t)(TIM_OCPreload << 8); + + /* Write to TIMx CCMR1 register */ + TIMx->CCMR1 = tmpccmr1; +} + +/** + * @brief Enables or disables the TIMx peripheral Preload register on CCR3. + * @param TIMx: where x can be 1, 2, 3, 4, 5 or 8 to select the TIM peripheral. + * @param TIM_OCPreload: new state of the TIMx peripheral Preload register + * This parameter can be one of the following values: + * @arg TIM_OCPreload_Enable + * @arg TIM_OCPreload_Disable + * @retval None + */ +void TIM_OC3PreloadConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCPreload) +{ + uint16_t tmpccmr2 = 0; + + /* Check the parameters */ + assert_param(IS_TIM_LIST3_PERIPH(TIMx)); + assert_param(IS_TIM_OCPRELOAD_STATE(TIM_OCPreload)); + + tmpccmr2 = TIMx->CCMR2; + + /* Reset the OC3PE Bit */ + tmpccmr2 &= (uint16_t)(~TIM_CCMR2_OC3PE); + + /* Enable or Disable the Output Compare Preload feature */ + tmpccmr2 |= TIM_OCPreload; + + /* Write to TIMx CCMR2 register */ + TIMx->CCMR2 = tmpccmr2; +} + +/** + * @brief Enables or disables the TIMx peripheral Preload register on CCR4. + * @param TIMx: where x can be 1, 2, 3, 4, 5 or 8 to select the TIM peripheral. + * @param TIM_OCPreload: new state of the TIMx peripheral Preload register + * This parameter can be one of the following values: + * @arg TIM_OCPreload_Enable + * @arg TIM_OCPreload_Disable + * @retval None + */ +void TIM_OC4PreloadConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCPreload) +{ + uint16_t tmpccmr2 = 0; + + /* Check the parameters */ + assert_param(IS_TIM_LIST3_PERIPH(TIMx)); + assert_param(IS_TIM_OCPRELOAD_STATE(TIM_OCPreload)); + + tmpccmr2 = TIMx->CCMR2; + + /* Reset the OC4PE Bit */ + tmpccmr2 &= (uint16_t)(~TIM_CCMR2_OC4PE); + + /* Enable or Disable the Output Compare Preload feature */ + tmpccmr2 |= (uint16_t)(TIM_OCPreload << 8); + + /* Write to TIMx CCMR2 register */ + TIMx->CCMR2 = tmpccmr2; +} + +/** + * @brief Configures the TIMx Output Compare 1 Fast feature. + * @param TIMx: where x can be 1 to 14 except 6 and 7, to select the TIM peripheral. + * @param TIM_OCFast: new state of the Output Compare Fast Enable Bit. + * This parameter can be one of the following values: + * @arg TIM_OCFast_Enable: TIM output compare fast enable + * @arg TIM_OCFast_Disable: TIM output compare fast disable + * @retval None + */ +void TIM_OC1FastConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCFast) +{ + uint16_t tmpccmr1 = 0; + + /* Check the parameters */ + assert_param(IS_TIM_LIST1_PERIPH(TIMx)); + assert_param(IS_TIM_OCFAST_STATE(TIM_OCFast)); + + /* Get the TIMx CCMR1 register value */ + tmpccmr1 = TIMx->CCMR1; + + /* Reset the OC1FE Bit */ + tmpccmr1 &= (uint16_t)~TIM_CCMR1_OC1FE; + + /* Enable or Disable the Output Compare Fast Bit */ + tmpccmr1 |= TIM_OCFast; + + /* Write to TIMx CCMR1 */ + TIMx->CCMR1 = tmpccmr1; +} + +/** + * @brief Configures the TIMx Output Compare 2 Fast feature. + * @param TIMx: where x can be 1, 2, 3, 4, 5, 8, 9 or 12 to select the TIM + * peripheral. + * @param TIM_OCFast: new state of the Output Compare Fast Enable Bit. + * This parameter can be one of the following values: + * @arg TIM_OCFast_Enable: TIM output compare fast enable + * @arg TIM_OCFast_Disable: TIM output compare fast disable + * @retval None + */ +void TIM_OC2FastConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCFast) +{ + uint16_t tmpccmr1 = 0; + + /* Check the parameters */ + assert_param(IS_TIM_LIST2_PERIPH(TIMx)); + assert_param(IS_TIM_OCFAST_STATE(TIM_OCFast)); + + /* Get the TIMx CCMR1 register value */ + tmpccmr1 = TIMx->CCMR1; + + /* Reset the OC2FE Bit */ + tmpccmr1 &= (uint16_t)(~TIM_CCMR1_OC2FE); + + /* Enable or Disable the Output Compare Fast Bit */ + tmpccmr1 |= (uint16_t)(TIM_OCFast << 8); + + /* Write to TIMx CCMR1 */ + TIMx->CCMR1 = tmpccmr1; +} + +/** + * @brief Configures the TIMx Output Compare 3 Fast feature. + * @param TIMx: where x can be 1, 2, 3, 4, 5 or 8 to select the TIM peripheral. + * @param TIM_OCFast: new state of the Output Compare Fast Enable Bit. + * This parameter can be one of the following values: + * @arg TIM_OCFast_Enable: TIM output compare fast enable + * @arg TIM_OCFast_Disable: TIM output compare fast disable + * @retval None + */ +void TIM_OC3FastConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCFast) +{ + uint16_t tmpccmr2 = 0; + + /* Check the parameters */ + assert_param(IS_TIM_LIST3_PERIPH(TIMx)); + assert_param(IS_TIM_OCFAST_STATE(TIM_OCFast)); + + /* Get the TIMx CCMR2 register value */ + tmpccmr2 = TIMx->CCMR2; + + /* Reset the OC3FE Bit */ + tmpccmr2 &= (uint16_t)~TIM_CCMR2_OC3FE; + + /* Enable or Disable the Output Compare Fast Bit */ + tmpccmr2 |= TIM_OCFast; + + /* Write to TIMx CCMR2 */ + TIMx->CCMR2 = tmpccmr2; +} + +/** + * @brief Configures the TIMx Output Compare 4 Fast feature. + * @param TIMx: where x can be 1, 2, 3, 4, 5 or 8 to select the TIM peripheral. + * @param TIM_OCFast: new state of the Output Compare Fast Enable Bit. + * This parameter can be one of the following values: + * @arg TIM_OCFast_Enable: TIM output compare fast enable + * @arg TIM_OCFast_Disable: TIM output compare fast disable + * @retval None + */ +void TIM_OC4FastConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCFast) +{ + uint16_t tmpccmr2 = 0; + + /* Check the parameters */ + assert_param(IS_TIM_LIST3_PERIPH(TIMx)); + assert_param(IS_TIM_OCFAST_STATE(TIM_OCFast)); + + /* Get the TIMx CCMR2 register value */ + tmpccmr2 = TIMx->CCMR2; + + /* Reset the OC4FE Bit */ + tmpccmr2 &= (uint16_t)(~TIM_CCMR2_OC4FE); + + /* Enable or Disable the Output Compare Fast Bit */ + tmpccmr2 |= (uint16_t)(TIM_OCFast << 8); + + /* Write to TIMx CCMR2 */ + TIMx->CCMR2 = tmpccmr2; +} + +/** + * @brief Clears or safeguards the OCREF1 signal on an external event + * @param TIMx: where x can be 1 to 14 except 6 and 7, to select the TIM peripheral. + * @param TIM_OCClear: new state of the Output Compare Clear Enable Bit. + * This parameter can be one of the following values: + * @arg TIM_OCClear_Enable: TIM Output clear enable + * @arg TIM_OCClear_Disable: TIM Output clear disable + * @retval None + */ +void TIM_ClearOC1Ref(TIM_TypeDef* TIMx, uint16_t TIM_OCClear) +{ + uint16_t tmpccmr1 = 0; + + /* Check the parameters */ + assert_param(IS_TIM_LIST1_PERIPH(TIMx)); + assert_param(IS_TIM_OCCLEAR_STATE(TIM_OCClear)); + + tmpccmr1 = TIMx->CCMR1; + + /* Reset the OC1CE Bit */ + tmpccmr1 &= (uint16_t)~TIM_CCMR1_OC1CE; + + /* Enable or Disable the Output Compare Clear Bit */ + tmpccmr1 |= TIM_OCClear; + + /* Write to TIMx CCMR1 register */ + TIMx->CCMR1 = tmpccmr1; +} + +/** + * @brief Clears or safeguards the OCREF2 signal on an external event + * @param TIMx: where x can be 1, 2, 3, 4, 5, 8, 9 or 12 to select the TIM + * peripheral. + * @param TIM_OCClear: new state of the Output Compare Clear Enable Bit. + * This parameter can be one of the following values: + * @arg TIM_OCClear_Enable: TIM Output clear enable + * @arg TIM_OCClear_Disable: TIM Output clear disable + * @retval None + */ +void TIM_ClearOC2Ref(TIM_TypeDef* TIMx, uint16_t TIM_OCClear) +{ + uint16_t tmpccmr1 = 0; + + /* Check the parameters */ + assert_param(IS_TIM_LIST2_PERIPH(TIMx)); + assert_param(IS_TIM_OCCLEAR_STATE(TIM_OCClear)); + + tmpccmr1 = TIMx->CCMR1; + + /* Reset the OC2CE Bit */ + tmpccmr1 &= (uint16_t)~TIM_CCMR1_OC2CE; + + /* Enable or Disable the Output Compare Clear Bit */ + tmpccmr1 |= (uint16_t)(TIM_OCClear << 8); + + /* Write to TIMx CCMR1 register */ + TIMx->CCMR1 = tmpccmr1; +} + +/** + * @brief Clears or safeguards the OCREF3 signal on an external event + * @param TIMx: where x can be 1, 2, 3, 4, 5 or 8 to select the TIM peripheral. + * @param TIM_OCClear: new state of the Output Compare Clear Enable Bit. + * This parameter can be one of the following values: + * @arg TIM_OCClear_Enable: TIM Output clear enable + * @arg TIM_OCClear_Disable: TIM Output clear disable + * @retval None + */ +void TIM_ClearOC3Ref(TIM_TypeDef* TIMx, uint16_t TIM_OCClear) +{ + uint16_t tmpccmr2 = 0; + + /* Check the parameters */ + assert_param(IS_TIM_LIST3_PERIPH(TIMx)); + assert_param(IS_TIM_OCCLEAR_STATE(TIM_OCClear)); + + tmpccmr2 = TIMx->CCMR2; + + /* Reset the OC3CE Bit */ + tmpccmr2 &= (uint16_t)~TIM_CCMR2_OC3CE; + + /* Enable or Disable the Output Compare Clear Bit */ + tmpccmr2 |= TIM_OCClear; + + /* Write to TIMx CCMR2 register */ + TIMx->CCMR2 = tmpccmr2; +} + +/** + * @brief Clears or safeguards the OCREF4 signal on an external event + * @param TIMx: where x can be 1, 2, 3, 4, 5 or 8 to select the TIM peripheral. + * @param TIM_OCClear: new state of the Output Compare Clear Enable Bit. + * This parameter can be one of the following values: + * @arg TIM_OCClear_Enable: TIM Output clear enable + * @arg TIM_OCClear_Disable: TIM Output clear disable + * @retval None + */ +void TIM_ClearOC4Ref(TIM_TypeDef* TIMx, uint16_t TIM_OCClear) +{ + uint16_t tmpccmr2 = 0; + + /* Check the parameters */ + assert_param(IS_TIM_LIST3_PERIPH(TIMx)); + assert_param(IS_TIM_OCCLEAR_STATE(TIM_OCClear)); + + tmpccmr2 = TIMx->CCMR2; + + /* Reset the OC4CE Bit */ + tmpccmr2 &= (uint16_t)~TIM_CCMR2_OC4CE; + + /* Enable or Disable the Output Compare Clear Bit */ + tmpccmr2 |= (uint16_t)(TIM_OCClear << 8); + + /* Write to TIMx CCMR2 register */ + TIMx->CCMR2 = tmpccmr2; +} + +/** + * @brief Configures the TIMx channel 1 polarity. + * @param TIMx: where x can be 1 to 14 except 6 and 7, to select the TIM peripheral. + * @param TIM_OCPolarity: specifies the OC1 Polarity + * This parameter can be one of the following values: + * @arg TIM_OCPolarity_High: Output Compare active high + * @arg TIM_OCPolarity_Low: Output Compare active low + * @retval None + */ +void TIM_OC1PolarityConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCPolarity) +{ + uint16_t tmpccer = 0; + + /* Check the parameters */ + assert_param(IS_TIM_LIST1_PERIPH(TIMx)); + assert_param(IS_TIM_OC_POLARITY(TIM_OCPolarity)); + + tmpccer = TIMx->CCER; + + /* Set or Reset the CC1P Bit */ + tmpccer &= (uint16_t)(~TIM_CCER_CC1P); + tmpccer |= TIM_OCPolarity; + + /* Write to TIMx CCER register */ + TIMx->CCER = tmpccer; +} + +/** + * @brief Configures the TIMx Channel 1N polarity. + * @param TIMx: where x can be 1 or 8 to select the TIM peripheral. + * @param TIM_OCNPolarity: specifies the OC1N Polarity + * This parameter can be one of the following values: + * @arg TIM_OCNPolarity_High: Output Compare active high + * @arg TIM_OCNPolarity_Low: Output Compare active low + * @retval None + */ +void TIM_OC1NPolarityConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCNPolarity) +{ + uint16_t tmpccer = 0; + /* Check the parameters */ + assert_param(IS_TIM_LIST4_PERIPH(TIMx)); + assert_param(IS_TIM_OCN_POLARITY(TIM_OCNPolarity)); + + tmpccer = TIMx->CCER; + + /* Set or Reset the CC1NP Bit */ + tmpccer &= (uint16_t)~TIM_CCER_CC1NP; + tmpccer |= TIM_OCNPolarity; + + /* Write to TIMx CCER register */ + TIMx->CCER = tmpccer; +} + +/** + * @brief Configures the TIMx channel 2 polarity. + * @param TIMx: where x can be 1, 2, 3, 4, 5, 8, 9 or 12 to select the TIM + * peripheral. + * @param TIM_OCPolarity: specifies the OC2 Polarity + * This parameter can be one of the following values: + * @arg TIM_OCPolarity_High: Output Compare active high + * @arg TIM_OCPolarity_Low: Output Compare active low + * @retval None + */ +void TIM_OC2PolarityConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCPolarity) +{ + uint16_t tmpccer = 0; + + /* Check the parameters */ + assert_param(IS_TIM_LIST2_PERIPH(TIMx)); + assert_param(IS_TIM_OC_POLARITY(TIM_OCPolarity)); + + tmpccer = TIMx->CCER; + + /* Set or Reset the CC2P Bit */ + tmpccer &= (uint16_t)(~TIM_CCER_CC2P); + tmpccer |= (uint16_t)(TIM_OCPolarity << 4); + + /* Write to TIMx CCER register */ + TIMx->CCER = tmpccer; +} + +/** + * @brief Configures the TIMx Channel 2N polarity. + * @param TIMx: where x can be 1 or 8 to select the TIM peripheral. + * @param TIM_OCNPolarity: specifies the OC2N Polarity + * This parameter can be one of the following values: + * @arg TIM_OCNPolarity_High: Output Compare active high + * @arg TIM_OCNPolarity_Low: Output Compare active low + * @retval None + */ +void TIM_OC2NPolarityConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCNPolarity) +{ + uint16_t tmpccer = 0; + + /* Check the parameters */ + assert_param(IS_TIM_LIST4_PERIPH(TIMx)); + assert_param(IS_TIM_OCN_POLARITY(TIM_OCNPolarity)); + + tmpccer = TIMx->CCER; + + /* Set or Reset the CC2NP Bit */ + tmpccer &= (uint16_t)~TIM_CCER_CC2NP; + tmpccer |= (uint16_t)(TIM_OCNPolarity << 4); + + /* Write to TIMx CCER register */ + TIMx->CCER = tmpccer; +} + +/** + * @brief Configures the TIMx channel 3 polarity. + * @param TIMx: where x can be 1, 2, 3, 4, 5 or 8 to select the TIM peripheral. + * @param TIM_OCPolarity: specifies the OC3 Polarity + * This parameter can be one of the following values: + * @arg TIM_OCPolarity_High: Output Compare active high + * @arg TIM_OCPolarity_Low: Output Compare active low + * @retval None + */ +void TIM_OC3PolarityConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCPolarity) +{ + uint16_t tmpccer = 0; + + /* Check the parameters */ + assert_param(IS_TIM_LIST3_PERIPH(TIMx)); + assert_param(IS_TIM_OC_POLARITY(TIM_OCPolarity)); + + tmpccer = TIMx->CCER; + + /* Set or Reset the CC3P Bit */ + tmpccer &= (uint16_t)~TIM_CCER_CC3P; + tmpccer |= (uint16_t)(TIM_OCPolarity << 8); + + /* Write to TIMx CCER register */ + TIMx->CCER = tmpccer; +} + +/** + * @brief Configures the TIMx Channel 3N polarity. + * @param TIMx: where x can be 1 or 8 to select the TIM peripheral. + * @param TIM_OCNPolarity: specifies the OC3N Polarity + * This parameter can be one of the following values: + * @arg TIM_OCNPolarity_High: Output Compare active high + * @arg TIM_OCNPolarity_Low: Output Compare active low + * @retval None + */ +void TIM_OC3NPolarityConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCNPolarity) +{ + uint16_t tmpccer = 0; + + /* Check the parameters */ + assert_param(IS_TIM_LIST4_PERIPH(TIMx)); + assert_param(IS_TIM_OCN_POLARITY(TIM_OCNPolarity)); + + tmpccer = TIMx->CCER; + + /* Set or Reset the CC3NP Bit */ + tmpccer &= (uint16_t)~TIM_CCER_CC3NP; + tmpccer |= (uint16_t)(TIM_OCNPolarity << 8); + + /* Write to TIMx CCER register */ + TIMx->CCER = tmpccer; +} + +/** + * @brief Configures the TIMx channel 4 polarity. + * @param TIMx: where x can be 1, 2, 3, 4, 5 or 8 to select the TIM peripheral. + * @param TIM_OCPolarity: specifies the OC4 Polarity + * This parameter can be one of the following values: + * @arg TIM_OCPolarity_High: Output Compare active high + * @arg TIM_OCPolarity_Low: Output Compare active low + * @retval None + */ +void TIM_OC4PolarityConfig(TIM_TypeDef* TIMx, uint16_t TIM_OCPolarity) +{ + uint16_t tmpccer = 0; + + /* Check the parameters */ + assert_param(IS_TIM_LIST3_PERIPH(TIMx)); + assert_param(IS_TIM_OC_POLARITY(TIM_OCPolarity)); + + tmpccer = TIMx->CCER; + + /* Set or Reset the CC4P Bit */ + tmpccer &= (uint16_t)~TIM_CCER_CC4P; + tmpccer |= (uint16_t)(TIM_OCPolarity << 12); + + /* Write to TIMx CCER register */ + TIMx->CCER = tmpccer; +} + +/** + * @brief Enables or disables the TIM Capture Compare Channel x. + * @param TIMx: where x can be 1 to 14 except 6 and 7, to select the TIM peripheral. + * @param TIM_Channel: specifies the TIM Channel + * This parameter can be one of the following values: + * @arg TIM_Channel_1: TIM Channel 1 + * @arg TIM_Channel_2: TIM Channel 2 + * @arg TIM_Channel_3: TIM Channel 3 + * @arg TIM_Channel_4: TIM Channel 4 + * @param TIM_CCx: specifies the TIM Channel CCxE bit new state. + * This parameter can be: TIM_CCx_Enable or TIM_CCx_Disable. + * @retval None + */ +void TIM_CCxCmd(TIM_TypeDef* TIMx, uint16_t TIM_Channel, uint16_t TIM_CCx) +{ + uint16_t tmp = 0; + + /* Check the parameters */ + assert_param(IS_TIM_LIST1_PERIPH(TIMx)); + assert_param(IS_TIM_CHANNEL(TIM_Channel)); + assert_param(IS_TIM_CCX(TIM_CCx)); + + tmp = CCER_CCE_SET << TIM_Channel; + + /* Reset the CCxE Bit */ + TIMx->CCER &= (uint16_t)~ tmp; + + /* Set or reset the CCxE Bit */ + TIMx->CCER |= (uint16_t)(TIM_CCx << TIM_Channel); +} + +/** + * @brief Enables or disables the TIM Capture Compare Channel xN. + * @param TIMx: where x can be 1 or 8 to select the TIM peripheral. + * @param TIM_Channel: specifies the TIM Channel + * This parameter can be one of the following values: + * @arg TIM_Channel_1: TIM Channel 1 + * @arg TIM_Channel_2: TIM Channel 2 + * @arg TIM_Channel_3: TIM Channel 3 + * @param TIM_CCxN: specifies the TIM Channel CCxNE bit new state. + * This parameter can be: TIM_CCxN_Enable or TIM_CCxN_Disable. + * @retval None + */ +void TIM_CCxNCmd(TIM_TypeDef* TIMx, uint16_t TIM_Channel, uint16_t TIM_CCxN) +{ + uint16_t tmp = 0; + + /* Check the parameters */ + assert_param(IS_TIM_LIST4_PERIPH(TIMx)); + assert_param(IS_TIM_COMPLEMENTARY_CHANNEL(TIM_Channel)); + assert_param(IS_TIM_CCXN(TIM_CCxN)); + + tmp = CCER_CCNE_SET << TIM_Channel; + + /* Reset the CCxNE Bit */ + TIMx->CCER &= (uint16_t) ~tmp; + + /* Set or reset the CCxNE Bit */ + TIMx->CCER |= (uint16_t)(TIM_CCxN << TIM_Channel); +} +/** + * @} + */ + +/** @defgroup TIM_Group3 Input Capture management functions + * @brief Input Capture management functions + * +@verbatim + =============================================================================== + ##### Input Capture management functions ##### + =============================================================================== + + ##### TIM Driver: how to use it in Input Capture Mode ##### + =============================================================================== + [..] + To use the Timer in Input Capture mode, the following steps are mandatory: + + (#) Enable TIM clock using RCC_APBxPeriphClockCmd(RCC_APBxPeriph_TIMx, ENABLE) + function + + (#) Configure the TIM pins by configuring the corresponding GPIO pins + + (#) Configure the Time base unit as described in the first part of this driver, + if needed, else the Timer will run with the default configuration: + (++) Autoreload value = 0xFFFF + (++) Prescaler value = 0x0000 + (++) Counter mode = Up counting + (++) Clock Division = TIM_CKD_DIV1 + + (#) Fill the TIM_ICInitStruct with the desired parameters including: + (++) TIM Channel: TIM_Channel + (++) TIM Input Capture polarity: TIM_ICPolarity + (++) TIM Input Capture selection: TIM_ICSelection + (++) TIM Input Capture Prescaler: TIM_ICPrescaler + (++) TIM Input CApture filter value: TIM_ICFilter + + (#) Call TIM_ICInit(TIMx, &TIM_ICInitStruct) to configure the desired channel + with the corresponding configuration and to measure only frequency + or duty cycle of the input signal, or, Call TIM_PWMIConfig(TIMx, &TIM_ICInitStruct) + to configure the desired channels with the corresponding configuration + and to measure the frequency and the duty cycle of the input signal + + (#) Enable the NVIC or the DMA to read the measured frequency. + + (#) Enable the corresponding interrupt (or DMA request) to read the Captured + value, using the function TIM_ITConfig(TIMx, TIM_IT_CCx) + (or TIM_DMA_Cmd(TIMx, TIM_DMA_CCx)) + + (#) Call the TIM_Cmd(ENABLE) function to enable the TIM counter. + + (#) Use TIM_GetCapturex(TIMx); to read the captured value. + + -@- All other functions can be used separately to modify, if needed, + a specific feature of the Timer. + +@endverbatim + * @{ + */ + +/** + * @brief Initializes the TIM peripheral according to the specified parameters + * in the TIM_ICInitStruct. + * @param TIMx: where x can be 1 to 14 except 6 and 7, to select the TIM peripheral. + * @param TIM_ICInitStruct: pointer to a TIM_ICInitTypeDef structure that contains + * the configuration information for the specified TIM peripheral. + * @retval None + */ +void TIM_ICInit(TIM_TypeDef* TIMx, TIM_ICInitTypeDef* TIM_ICInitStruct) +{ + /* Check the parameters */ + assert_param(IS_TIM_LIST1_PERIPH(TIMx)); + assert_param(IS_TIM_IC_POLARITY(TIM_ICInitStruct->TIM_ICPolarity)); + assert_param(IS_TIM_IC_SELECTION(TIM_ICInitStruct->TIM_ICSelection)); + assert_param(IS_TIM_IC_PRESCALER(TIM_ICInitStruct->TIM_ICPrescaler)); + assert_param(IS_TIM_IC_FILTER(TIM_ICInitStruct->TIM_ICFilter)); + + if (TIM_ICInitStruct->TIM_Channel == TIM_Channel_1) + { + /* TI1 Configuration */ + TI1_Config(TIMx, TIM_ICInitStruct->TIM_ICPolarity, + TIM_ICInitStruct->TIM_ICSelection, + TIM_ICInitStruct->TIM_ICFilter); + /* Set the Input Capture Prescaler value */ + TIM_SetIC1Prescaler(TIMx, TIM_ICInitStruct->TIM_ICPrescaler); + } + else if (TIM_ICInitStruct->TIM_Channel == TIM_Channel_2) + { + /* TI2 Configuration */ + assert_param(IS_TIM_LIST2_PERIPH(TIMx)); + TI2_Config(TIMx, TIM_ICInitStruct->TIM_ICPolarity, + TIM_ICInitStruct->TIM_ICSelection, + TIM_ICInitStruct->TIM_ICFilter); + /* Set the Input Capture Prescaler value */ + TIM_SetIC2Prescaler(TIMx, TIM_ICInitStruct->TIM_ICPrescaler); + } + else if (TIM_ICInitStruct->TIM_Channel == TIM_Channel_3) + { + /* TI3 Configuration */ + assert_param(IS_TIM_LIST3_PERIPH(TIMx)); + TI3_Config(TIMx, TIM_ICInitStruct->TIM_ICPolarity, + TIM_ICInitStruct->TIM_ICSelection, + TIM_ICInitStruct->TIM_ICFilter); + /* Set the Input Capture Prescaler value */ + TIM_SetIC3Prescaler(TIMx, TIM_ICInitStruct->TIM_ICPrescaler); + } + else + { + /* TI4 Configuration */ + assert_param(IS_TIM_LIST3_PERIPH(TIMx)); + TI4_Config(TIMx, TIM_ICInitStruct->TIM_ICPolarity, + TIM_ICInitStruct->TIM_ICSelection, + TIM_ICInitStruct->TIM_ICFilter); + /* Set the Input Capture Prescaler value */ + TIM_SetIC4Prescaler(TIMx, TIM_ICInitStruct->TIM_ICPrescaler); + } +} + +/** + * @brief Fills each TIM_ICInitStruct member with its default value. + * @param TIM_ICInitStruct: pointer to a TIM_ICInitTypeDef structure which will + * be initialized. + * @retval None + */ +void TIM_ICStructInit(TIM_ICInitTypeDef* TIM_ICInitStruct) +{ + /* Set the default configuration */ + TIM_ICInitStruct->TIM_Channel = TIM_Channel_1; + TIM_ICInitStruct->TIM_ICPolarity = TIM_ICPolarity_Rising; + TIM_ICInitStruct->TIM_ICSelection = TIM_ICSelection_DirectTI; + TIM_ICInitStruct->TIM_ICPrescaler = TIM_ICPSC_DIV1; + TIM_ICInitStruct->TIM_ICFilter = 0x00; +} + +/** + * @brief Configures the TIM peripheral according to the specified parameters + * in the TIM_ICInitStruct to measure an external PWM signal. + * @param TIMx: where x can be 1, 2, 3, 4, 5,8, 9 or 12 to select the TIM + * peripheral. + * @param TIM_ICInitStruct: pointer to a TIM_ICInitTypeDef structure that contains + * the configuration information for the specified TIM peripheral. + * @retval None + */ +void TIM_PWMIConfig(TIM_TypeDef* TIMx, TIM_ICInitTypeDef* TIM_ICInitStruct) +{ + uint16_t icoppositepolarity = TIM_ICPolarity_Rising; + uint16_t icoppositeselection = TIM_ICSelection_DirectTI; + + /* Check the parameters */ + assert_param(IS_TIM_LIST2_PERIPH(TIMx)); + + /* Select the Opposite Input Polarity */ + if (TIM_ICInitStruct->TIM_ICPolarity == TIM_ICPolarity_Rising) + { + icoppositepolarity = TIM_ICPolarity_Falling; + } + else + { + icoppositepolarity = TIM_ICPolarity_Rising; + } + /* Select the Opposite Input */ + if (TIM_ICInitStruct->TIM_ICSelection == TIM_ICSelection_DirectTI) + { + icoppositeselection = TIM_ICSelection_IndirectTI; + } + else + { + icoppositeselection = TIM_ICSelection_DirectTI; + } + if (TIM_ICInitStruct->TIM_Channel == TIM_Channel_1) + { + /* TI1 Configuration */ + TI1_Config(TIMx, TIM_ICInitStruct->TIM_ICPolarity, TIM_ICInitStruct->TIM_ICSelection, + TIM_ICInitStruct->TIM_ICFilter); + /* Set the Input Capture Prescaler value */ + TIM_SetIC1Prescaler(TIMx, TIM_ICInitStruct->TIM_ICPrescaler); + /* TI2 Configuration */ + TI2_Config(TIMx, icoppositepolarity, icoppositeselection, TIM_ICInitStruct->TIM_ICFilter); + /* Set the Input Capture Prescaler value */ + TIM_SetIC2Prescaler(TIMx, TIM_ICInitStruct->TIM_ICPrescaler); + } + else + { + /* TI2 Configuration */ + TI2_Config(TIMx, TIM_ICInitStruct->TIM_ICPolarity, TIM_ICInitStruct->TIM_ICSelection, + TIM_ICInitStruct->TIM_ICFilter); + /* Set the Input Capture Prescaler value */ + TIM_SetIC2Prescaler(TIMx, TIM_ICInitStruct->TIM_ICPrescaler); + /* TI1 Configuration */ + TI1_Config(TIMx, icoppositepolarity, icoppositeselection, TIM_ICInitStruct->TIM_ICFilter); + /* Set the Input Capture Prescaler value */ + TIM_SetIC1Prescaler(TIMx, TIM_ICInitStruct->TIM_ICPrescaler); + } +} + +/** + * @brief Gets the TIMx Input Capture 1 value. + * @param TIMx: where x can be 1 to 14 except 6 and 7, to select the TIM peripheral. + * @retval Capture Compare 1 Register value. + */ +uint32_t TIM_GetCapture1(TIM_TypeDef* TIMx) +{ + /* Check the parameters */ + assert_param(IS_TIM_LIST1_PERIPH(TIMx)); + + /* Get the Capture 1 Register value */ + return TIMx->CCR1; +} + +/** + * @brief Gets the TIMx Input Capture 2 value. + * @param TIMx: where x can be 1, 2, 3, 4, 5, 8, 9 or 12 to select the TIM + * peripheral. + * @retval Capture Compare 2 Register value. + */ +uint32_t TIM_GetCapture2(TIM_TypeDef* TIMx) +{ + /* Check the parameters */ + assert_param(IS_TIM_LIST2_PERIPH(TIMx)); + + /* Get the Capture 2 Register value */ + return TIMx->CCR2; +} + +/** + * @brief Gets the TIMx Input Capture 3 value. + * @param TIMx: where x can be 1, 2, 3, 4, 5 or 8 to select the TIM peripheral. + * @retval Capture Compare 3 Register value. + */ +uint32_t TIM_GetCapture3(TIM_TypeDef* TIMx) +{ + /* Check the parameters */ + assert_param(IS_TIM_LIST3_PERIPH(TIMx)); + + /* Get the Capture 3 Register value */ + return TIMx->CCR3; +} + +/** + * @brief Gets the TIMx Input Capture 4 value. + * @param TIMx: where x can be 1, 2, 3, 4, 5 or 8 to select the TIM peripheral. + * @retval Capture Compare 4 Register value. + */ +uint32_t TIM_GetCapture4(TIM_TypeDef* TIMx) +{ + /* Check the parameters */ + assert_param(IS_TIM_LIST3_PERIPH(TIMx)); + + /* Get the Capture 4 Register value */ + return TIMx->CCR4; +} + +/** + * @brief Sets the TIMx Input Capture 1 prescaler. + * @param TIMx: where x can be 1 to 14 except 6 and 7, to select the TIM peripheral. + * @param TIM_ICPSC: specifies the Input Capture1 prescaler new value. + * This parameter can be one of the following values: + * @arg TIM_ICPSC_DIV1: no prescaler + * @arg TIM_ICPSC_DIV2: capture is done once every 2 events + * @arg TIM_ICPSC_DIV4: capture is done once every 4 events + * @arg TIM_ICPSC_DIV8: capture is done once every 8 events + * @retval None + */ +void TIM_SetIC1Prescaler(TIM_TypeDef* TIMx, uint16_t TIM_ICPSC) +{ + /* Check the parameters */ + assert_param(IS_TIM_LIST1_PERIPH(TIMx)); + assert_param(IS_TIM_IC_PRESCALER(TIM_ICPSC)); + + /* Reset the IC1PSC Bits */ + TIMx->CCMR1 &= (uint16_t)~TIM_CCMR1_IC1PSC; + + /* Set the IC1PSC value */ + TIMx->CCMR1 |= TIM_ICPSC; +} + +/** + * @brief Sets the TIMx Input Capture 2 prescaler. + * @param TIMx: where x can be 1, 2, 3, 4, 5, 8, 9 or 12 to select the TIM + * peripheral. + * @param TIM_ICPSC: specifies the Input Capture2 prescaler new value. + * This parameter can be one of the following values: + * @arg TIM_ICPSC_DIV1: no prescaler + * @arg TIM_ICPSC_DIV2: capture is done once every 2 events + * @arg TIM_ICPSC_DIV4: capture is done once every 4 events + * @arg TIM_ICPSC_DIV8: capture is done once every 8 events + * @retval None + */ +void TIM_SetIC2Prescaler(TIM_TypeDef* TIMx, uint16_t TIM_ICPSC) +{ + /* Check the parameters */ + assert_param(IS_TIM_LIST2_PERIPH(TIMx)); + assert_param(IS_TIM_IC_PRESCALER(TIM_ICPSC)); + + /* Reset the IC2PSC Bits */ + TIMx->CCMR1 &= (uint16_t)~TIM_CCMR1_IC2PSC; + + /* Set the IC2PSC value */ + TIMx->CCMR1 |= (uint16_t)(TIM_ICPSC << 8); +} + +/** + * @brief Sets the TIMx Input Capture 3 prescaler. + * @param TIMx: where x can be 1, 2, 3, 4, 5 or 8 to select the TIM peripheral. + * @param TIM_ICPSC: specifies the Input Capture3 prescaler new value. + * This parameter can be one of the following values: + * @arg TIM_ICPSC_DIV1: no prescaler + * @arg TIM_ICPSC_DIV2: capture is done once every 2 events + * @arg TIM_ICPSC_DIV4: capture is done once every 4 events + * @arg TIM_ICPSC_DIV8: capture is done once every 8 events + * @retval None + */ +void TIM_SetIC3Prescaler(TIM_TypeDef* TIMx, uint16_t TIM_ICPSC) +{ + /* Check the parameters */ + assert_param(IS_TIM_LIST3_PERIPH(TIMx)); + assert_param(IS_TIM_IC_PRESCALER(TIM_ICPSC)); + + /* Reset the IC3PSC Bits */ + TIMx->CCMR2 &= (uint16_t)~TIM_CCMR2_IC3PSC; + + /* Set the IC3PSC value */ + TIMx->CCMR2 |= TIM_ICPSC; +} + +/** + * @brief Sets the TIMx Input Capture 4 prescaler. + * @param TIMx: where x can be 1, 2, 3, 4, 5 or 8 to select the TIM peripheral. + * @param TIM_ICPSC: specifies the Input Capture4 prescaler new value. + * This parameter can be one of the following values: + * @arg TIM_ICPSC_DIV1: no prescaler + * @arg TIM_ICPSC_DIV2: capture is done once every 2 events + * @arg TIM_ICPSC_DIV4: capture is done once every 4 events + * @arg TIM_ICPSC_DIV8: capture is done once every 8 events + * @retval None + */ +void TIM_SetIC4Prescaler(TIM_TypeDef* TIMx, uint16_t TIM_ICPSC) +{ + /* Check the parameters */ + assert_param(IS_TIM_LIST3_PERIPH(TIMx)); + assert_param(IS_TIM_IC_PRESCALER(TIM_ICPSC)); + + /* Reset the IC4PSC Bits */ + TIMx->CCMR2 &= (uint16_t)~TIM_CCMR2_IC4PSC; + + /* Set the IC4PSC value */ + TIMx->CCMR2 |= (uint16_t)(TIM_ICPSC << 8); +} +/** + * @} + */ + +/** @defgroup TIM_Group4 Advanced-control timers (TIM1 and TIM8) specific features + * @brief Advanced-control timers (TIM1 and TIM8) specific features + * +@verbatim + =============================================================================== + ##### Advanced-control timers (TIM1 and TIM8) specific features ##### + =============================================================================== + + ##### TIM Driver: how to use the Break feature ##### + =============================================================================== + [..] + After configuring the Timer channel(s) in the appropriate Output Compare mode: + + (#) Fill the TIM_BDTRInitStruct with the desired parameters for the Timer + Break Polarity, dead time, Lock level, the OSSI/OSSR State and the + AOE(automatic output enable). + + (#) Call TIM_BDTRConfig(TIMx, &TIM_BDTRInitStruct) to configure the Timer + + (#) Enable the Main Output using TIM_CtrlPWMOutputs(TIM1, ENABLE) + + (#) Once the break even occurs, the Timer's output signals are put in reset + state or in a known state (according to the configuration made in + TIM_BDTRConfig() function). + +@endverbatim + * @{ + */ + +/** + * @brief Configures the Break feature, dead time, Lock level, OSSI/OSSR State + * and the AOE(automatic output enable). + * @param TIMx: where x can be 1 or 8 to select the TIM + * @param TIM_BDTRInitStruct: pointer to a TIM_BDTRInitTypeDef structure that + * contains the BDTR Register configuration information for the TIM peripheral. + * @retval None + */ +void TIM_BDTRConfig(TIM_TypeDef* TIMx, TIM_BDTRInitTypeDef *TIM_BDTRInitStruct) +{ + /* Check the parameters */ + assert_param(IS_TIM_LIST4_PERIPH(TIMx)); + assert_param(IS_TIM_OSSR_STATE(TIM_BDTRInitStruct->TIM_OSSRState)); + assert_param(IS_TIM_OSSI_STATE(TIM_BDTRInitStruct->TIM_OSSIState)); + assert_param(IS_TIM_LOCK_LEVEL(TIM_BDTRInitStruct->TIM_LOCKLevel)); + assert_param(IS_TIM_BREAK_STATE(TIM_BDTRInitStruct->TIM_Break)); + assert_param(IS_TIM_BREAK_POLARITY(TIM_BDTRInitStruct->TIM_BreakPolarity)); + assert_param(IS_TIM_AUTOMATIC_OUTPUT_STATE(TIM_BDTRInitStruct->TIM_AutomaticOutput)); + + /* Set the Lock level, the Break enable Bit and the Polarity, the OSSR State, + the OSSI State, the dead time value and the Automatic Output Enable Bit */ + TIMx->BDTR = (uint32_t)TIM_BDTRInitStruct->TIM_OSSRState | TIM_BDTRInitStruct->TIM_OSSIState | + TIM_BDTRInitStruct->TIM_LOCKLevel | TIM_BDTRInitStruct->TIM_DeadTime | + TIM_BDTRInitStruct->TIM_Break | TIM_BDTRInitStruct->TIM_BreakPolarity | + TIM_BDTRInitStruct->TIM_AutomaticOutput; +} + +/** + * @brief Fills each TIM_BDTRInitStruct member with its default value. + * @param TIM_BDTRInitStruct: pointer to a TIM_BDTRInitTypeDef structure which + * will be initialized. + * @retval None + */ +void TIM_BDTRStructInit(TIM_BDTRInitTypeDef* TIM_BDTRInitStruct) +{ + /* Set the default configuration */ + TIM_BDTRInitStruct->TIM_OSSRState = TIM_OSSRState_Disable; + TIM_BDTRInitStruct->TIM_OSSIState = TIM_OSSIState_Disable; + TIM_BDTRInitStruct->TIM_LOCKLevel = TIM_LOCKLevel_OFF; + TIM_BDTRInitStruct->TIM_DeadTime = 0x00; + TIM_BDTRInitStruct->TIM_Break = TIM_Break_Disable; + TIM_BDTRInitStruct->TIM_BreakPolarity = TIM_BreakPolarity_Low; + TIM_BDTRInitStruct->TIM_AutomaticOutput = TIM_AutomaticOutput_Disable; +} + +/** + * @brief Enables or disables the TIM peripheral Main Outputs. + * @param TIMx: where x can be 1 or 8 to select the TIMx peripheral. + * @param NewState: new state of the TIM peripheral Main Outputs. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void TIM_CtrlPWMOutputs(TIM_TypeDef* TIMx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_TIM_LIST4_PERIPH(TIMx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the TIM Main Output */ + TIMx->BDTR |= TIM_BDTR_MOE; + } + else + { + /* Disable the TIM Main Output */ + TIMx->BDTR &= (uint16_t)~TIM_BDTR_MOE; + } +} + +/** + * @brief Selects the TIM peripheral Commutation event. + * @param TIMx: where x can be 1 or 8 to select the TIMx peripheral + * @param NewState: new state of the Commutation event. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void TIM_SelectCOM(TIM_TypeDef* TIMx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_TIM_LIST4_PERIPH(TIMx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Set the COM Bit */ + TIMx->CR2 |= TIM_CR2_CCUS; + } + else + { + /* Reset the COM Bit */ + TIMx->CR2 &= (uint16_t)~TIM_CR2_CCUS; + } +} + +/** + * @brief Sets or Resets the TIM peripheral Capture Compare Preload Control bit. + * @param TIMx: where x can be 1 or 8 to select the TIMx peripheral + * @param NewState: new state of the Capture Compare Preload Control bit + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void TIM_CCPreloadControl(TIM_TypeDef* TIMx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_TIM_LIST4_PERIPH(TIMx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + if (NewState != DISABLE) + { + /* Set the CCPC Bit */ + TIMx->CR2 |= TIM_CR2_CCPC; + } + else + { + /* Reset the CCPC Bit */ + TIMx->CR2 &= (uint16_t)~TIM_CR2_CCPC; + } +} +/** + * @} + */ + +/** @defgroup TIM_Group5 Interrupts DMA and flags management functions + * @brief Interrupts, DMA and flags management functions + * +@verbatim + =============================================================================== + ##### Interrupts, DMA and flags management functions ##### + =============================================================================== + +@endverbatim + * @{ + */ + +/** + * @brief Enables or disables the specified TIM interrupts. + * @param TIMx: where x can be 1 to 14 to select the TIMx peripheral. + * @param TIM_IT: specifies the TIM interrupts sources to be enabled or disabled. + * This parameter can be any combination of the following values: + * @arg TIM_IT_Update: TIM update Interrupt source + * @arg TIM_IT_CC1: TIM Capture Compare 1 Interrupt source + * @arg TIM_IT_CC2: TIM Capture Compare 2 Interrupt source + * @arg TIM_IT_CC3: TIM Capture Compare 3 Interrupt source + * @arg TIM_IT_CC4: TIM Capture Compare 4 Interrupt source + * @arg TIM_IT_COM: TIM Commutation Interrupt source + * @arg TIM_IT_Trigger: TIM Trigger Interrupt source + * @arg TIM_IT_Break: TIM Break Interrupt source + * + * @note For TIM6 and TIM7 only the parameter TIM_IT_Update can be used + * @note For TIM9 and TIM12 only one of the following parameters can be used: TIM_IT_Update, + * TIM_IT_CC1, TIM_IT_CC2 or TIM_IT_Trigger. + * @note For TIM10, TIM11, TIM13 and TIM14 only one of the following parameters can + * be used: TIM_IT_Update or TIM_IT_CC1 + * @note TIM_IT_COM and TIM_IT_Break can be used only with TIM1 and TIM8 + * + * @param NewState: new state of the TIM interrupts. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void TIM_ITConfig(TIM_TypeDef* TIMx, uint16_t TIM_IT, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_TIM_ALL_PERIPH(TIMx)); + assert_param(IS_TIM_IT(TIM_IT)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the Interrupt sources */ + TIMx->DIER |= TIM_IT; + } + else + { + /* Disable the Interrupt sources */ + TIMx->DIER &= (uint16_t)~TIM_IT; + } +} + +/** + * @brief Configures the TIMx event to be generate by software. + * @param TIMx: where x can be 1 to 14 to select the TIM peripheral. + * @param TIM_EventSource: specifies the event source. + * This parameter can be one or more of the following values: + * @arg TIM_EventSource_Update: Timer update Event source + * @arg TIM_EventSource_CC1: Timer Capture Compare 1 Event source + * @arg TIM_EventSource_CC2: Timer Capture Compare 2 Event source + * @arg TIM_EventSource_CC3: Timer Capture Compare 3 Event source + * @arg TIM_EventSource_CC4: Timer Capture Compare 4 Event source + * @arg TIM_EventSource_COM: Timer COM event source + * @arg TIM_EventSource_Trigger: Timer Trigger Event source + * @arg TIM_EventSource_Break: Timer Break event source + * + * @note TIM6 and TIM7 can only generate an update event. + * @note TIM_EventSource_COM and TIM_EventSource_Break are used only with TIM1 and TIM8. + * + * @retval None + */ +void TIM_GenerateEvent(TIM_TypeDef* TIMx, uint16_t TIM_EventSource) +{ + /* Check the parameters */ + assert_param(IS_TIM_ALL_PERIPH(TIMx)); + assert_param(IS_TIM_EVENT_SOURCE(TIM_EventSource)); + + /* Set the event sources */ + TIMx->EGR = TIM_EventSource; +} + +/** + * @brief Checks whether the specified TIM flag is set or not. + * @param TIMx: where x can be 1 to 14 to select the TIM peripheral. + * @param TIM_FLAG: specifies the flag to check. + * This parameter can be one of the following values: + * @arg TIM_FLAG_Update: TIM update Flag + * @arg TIM_FLAG_CC1: TIM Capture Compare 1 Flag + * @arg TIM_FLAG_CC2: TIM Capture Compare 2 Flag + * @arg TIM_FLAG_CC3: TIM Capture Compare 3 Flag + * @arg TIM_FLAG_CC4: TIM Capture Compare 4 Flag + * @arg TIM_FLAG_COM: TIM Commutation Flag + * @arg TIM_FLAG_Trigger: TIM Trigger Flag + * @arg TIM_FLAG_Break: TIM Break Flag + * @arg TIM_FLAG_CC1OF: TIM Capture Compare 1 over capture Flag + * @arg TIM_FLAG_CC2OF: TIM Capture Compare 2 over capture Flag + * @arg TIM_FLAG_CC3OF: TIM Capture Compare 3 over capture Flag + * @arg TIM_FLAG_CC4OF: TIM Capture Compare 4 over capture Flag + * + * @note TIM6 and TIM7 can have only one update flag. + * @note TIM_FLAG_COM and TIM_FLAG_Break are used only with TIM1 and TIM8. + * + * @retval The new state of TIM_FLAG (SET or RESET). + */ +FlagStatus TIM_GetFlagStatus(TIM_TypeDef* TIMx, uint16_t TIM_FLAG) +{ + ITStatus bitstatus = RESET; + /* Check the parameters */ + assert_param(IS_TIM_ALL_PERIPH(TIMx)); + assert_param(IS_TIM_GET_FLAG(TIM_FLAG)); + + + if ((TIMx->SR & TIM_FLAG) != (uint16_t)RESET) + { + bitstatus = SET; + } + else + { + bitstatus = RESET; + } + return bitstatus; +} + +/** + * @brief Clears the TIMx's pending flags. + * @param TIMx: where x can be 1 to 14 to select the TIM peripheral. + * @param TIM_FLAG: specifies the flag bit to clear. + * This parameter can be any combination of the following values: + * @arg TIM_FLAG_Update: TIM update Flag + * @arg TIM_FLAG_CC1: TIM Capture Compare 1 Flag + * @arg TIM_FLAG_CC2: TIM Capture Compare 2 Flag + * @arg TIM_FLAG_CC3: TIM Capture Compare 3 Flag + * @arg TIM_FLAG_CC4: TIM Capture Compare 4 Flag + * @arg TIM_FLAG_COM: TIM Commutation Flag + * @arg TIM_FLAG_Trigger: TIM Trigger Flag + * @arg TIM_FLAG_Break: TIM Break Flag + * @arg TIM_FLAG_CC1OF: TIM Capture Compare 1 over capture Flag + * @arg TIM_FLAG_CC2OF: TIM Capture Compare 2 over capture Flag + * @arg TIM_FLAG_CC3OF: TIM Capture Compare 3 over capture Flag + * @arg TIM_FLAG_CC4OF: TIM Capture Compare 4 over capture Flag + * + * @note TIM6 and TIM7 can have only one update flag. + * @note TIM_FLAG_COM and TIM_FLAG_Break are used only with TIM1 and TIM8. + * + * @retval None + */ +void TIM_ClearFlag(TIM_TypeDef* TIMx, uint16_t TIM_FLAG) +{ + /* Check the parameters */ + assert_param(IS_TIM_ALL_PERIPH(TIMx)); + + /* Clear the flags */ + TIMx->SR = (uint16_t)~TIM_FLAG; +} + +/** + * @brief Checks whether the TIM interrupt has occurred or not. + * @param TIMx: where x can be 1 to 14 to select the TIM peripheral. + * @param TIM_IT: specifies the TIM interrupt source to check. + * This parameter can be one of the following values: + * @arg TIM_IT_Update: TIM update Interrupt source + * @arg TIM_IT_CC1: TIM Capture Compare 1 Interrupt source + * @arg TIM_IT_CC2: TIM Capture Compare 2 Interrupt source + * @arg TIM_IT_CC3: TIM Capture Compare 3 Interrupt source + * @arg TIM_IT_CC4: TIM Capture Compare 4 Interrupt source + * @arg TIM_IT_COM: TIM Commutation Interrupt source + * @arg TIM_IT_Trigger: TIM Trigger Interrupt source + * @arg TIM_IT_Break: TIM Break Interrupt source + * + * @note TIM6 and TIM7 can generate only an update interrupt. + * @note TIM_IT_COM and TIM_IT_Break are used only with TIM1 and TIM8. + * + * @retval The new state of the TIM_IT(SET or RESET). + */ +ITStatus TIM_GetITStatus(TIM_TypeDef* TIMx, uint16_t TIM_IT) +{ + ITStatus bitstatus = RESET; + uint16_t itstatus = 0x0, itenable = 0x0; + /* Check the parameters */ + assert_param(IS_TIM_ALL_PERIPH(TIMx)); + assert_param(IS_TIM_GET_IT(TIM_IT)); + + itstatus = TIMx->SR & TIM_IT; + + itenable = TIMx->DIER & TIM_IT; + if ((itstatus != (uint16_t)RESET) && (itenable != (uint16_t)RESET)) + { + bitstatus = SET; + } + else + { + bitstatus = RESET; + } + return bitstatus; +} + +/** + * @brief Clears the TIMx's interrupt pending bits. + * @param TIMx: where x can be 1 to 14 to select the TIM peripheral. + * @param TIM_IT: specifies the pending bit to clear. + * This parameter can be any combination of the following values: + * @arg TIM_IT_Update: TIM1 update Interrupt source + * @arg TIM_IT_CC1: TIM Capture Compare 1 Interrupt source + * @arg TIM_IT_CC2: TIM Capture Compare 2 Interrupt source + * @arg TIM_IT_CC3: TIM Capture Compare 3 Interrupt source + * @arg TIM_IT_CC4: TIM Capture Compare 4 Interrupt source + * @arg TIM_IT_COM: TIM Commutation Interrupt source + * @arg TIM_IT_Trigger: TIM Trigger Interrupt source + * @arg TIM_IT_Break: TIM Break Interrupt source + * + * @note TIM6 and TIM7 can generate only an update interrupt. + * @note TIM_IT_COM and TIM_IT_Break are used only with TIM1 and TIM8. + * + * @retval None + */ +void TIM_ClearITPendingBit(TIM_TypeDef* TIMx, uint16_t TIM_IT) +{ + /* Check the parameters */ + assert_param(IS_TIM_ALL_PERIPH(TIMx)); + + /* Clear the IT pending Bit */ + TIMx->SR = (uint16_t)~TIM_IT; +} + +/** + * @brief Configures the TIMx's DMA interface. + * @param TIMx: where x can be 1, 2, 3, 4, 5 or 8 to select the TIM peripheral. + * @param TIM_DMABase: DMA Base address. + * This parameter can be one of the following values: + * @arg TIM_DMABase_CR1 + * @arg TIM_DMABase_CR2 + * @arg TIM_DMABase_SMCR + * @arg TIM_DMABase_DIER + * @arg TIM1_DMABase_SR + * @arg TIM_DMABase_EGR + * @arg TIM_DMABase_CCMR1 + * @arg TIM_DMABase_CCMR2 + * @arg TIM_DMABase_CCER + * @arg TIM_DMABase_CNT + * @arg TIM_DMABase_PSC + * @arg TIM_DMABase_ARR + * @arg TIM_DMABase_RCR + * @arg TIM_DMABase_CCR1 + * @arg TIM_DMABase_CCR2 + * @arg TIM_DMABase_CCR3 + * @arg TIM_DMABase_CCR4 + * @arg TIM_DMABase_BDTR + * @arg TIM_DMABase_DCR + * @param TIM_DMABurstLength: DMA Burst length. This parameter can be one value + * between: TIM_DMABurstLength_1Transfer and TIM_DMABurstLength_18Transfers. + * @retval None + */ +void TIM_DMAConfig(TIM_TypeDef* TIMx, uint16_t TIM_DMABase, uint16_t TIM_DMABurstLength) +{ + /* Check the parameters */ + assert_param(IS_TIM_LIST3_PERIPH(TIMx)); + assert_param(IS_TIM_DMA_BASE(TIM_DMABase)); + assert_param(IS_TIM_DMA_LENGTH(TIM_DMABurstLength)); + + /* Set the DMA Base and the DMA Burst Length */ + TIMx->DCR = TIM_DMABase | TIM_DMABurstLength; +} + +/** + * @brief Enables or disables the TIMx's DMA Requests. + * @param TIMx: where x can be 1, 2, 3, 4, 5, 6, 7 or 8 to select the TIM peripheral. + * @param TIM_DMASource: specifies the DMA Request sources. + * This parameter can be any combination of the following values: + * @arg TIM_DMA_Update: TIM update Interrupt source + * @arg TIM_DMA_CC1: TIM Capture Compare 1 DMA source + * @arg TIM_DMA_CC2: TIM Capture Compare 2 DMA source + * @arg TIM_DMA_CC3: TIM Capture Compare 3 DMA source + * @arg TIM_DMA_CC4: TIM Capture Compare 4 DMA source + * @arg TIM_DMA_COM: TIM Commutation DMA source + * @arg TIM_DMA_Trigger: TIM Trigger DMA source + * @param NewState: new state of the DMA Request sources. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void TIM_DMACmd(TIM_TypeDef* TIMx, uint16_t TIM_DMASource, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_TIM_LIST5_PERIPH(TIMx)); + assert_param(IS_TIM_DMA_SOURCE(TIM_DMASource)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the DMA sources */ + TIMx->DIER |= TIM_DMASource; + } + else + { + /* Disable the DMA sources */ + TIMx->DIER &= (uint16_t)~TIM_DMASource; + } +} + +/** + * @brief Selects the TIMx peripheral Capture Compare DMA source. + * @param TIMx: where x can be 1, 2, 3, 4, 5 or 8 to select the TIM peripheral. + * @param NewState: new state of the Capture Compare DMA source + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void TIM_SelectCCDMA(TIM_TypeDef* TIMx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_TIM_LIST3_PERIPH(TIMx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Set the CCDS Bit */ + TIMx->CR2 |= TIM_CR2_CCDS; + } + else + { + /* Reset the CCDS Bit */ + TIMx->CR2 &= (uint16_t)~TIM_CR2_CCDS; + } +} +/** + * @} + */ + +/** @defgroup TIM_Group6 Clocks management functions + * @brief Clocks management functions + * +@verbatim + =============================================================================== + ##### Clocks management functions ##### + =============================================================================== + +@endverbatim + * @{ + */ + +/** + * @brief Configures the TIMx internal Clock + * @param TIMx: where x can be 1, 2, 3, 4, 5, 8, 9 or 12 to select the TIM + * peripheral. + * @retval None + */ +void TIM_InternalClockConfig(TIM_TypeDef* TIMx) +{ + /* Check the parameters */ + assert_param(IS_TIM_LIST2_PERIPH(TIMx)); + + /* Disable slave mode to clock the prescaler directly with the internal clock */ + TIMx->SMCR &= (uint16_t)~TIM_SMCR_SMS; +} + +/** + * @brief Configures the TIMx Internal Trigger as External Clock + * @param TIMx: where x can be 1, 2, 3, 4, 5, 8, 9 or 12 to select the TIM + * peripheral. + * @param TIM_InputTriggerSource: Trigger source. + * This parameter can be one of the following values: + * @arg TIM_TS_ITR0: Internal Trigger 0 + * @arg TIM_TS_ITR1: Internal Trigger 1 + * @arg TIM_TS_ITR2: Internal Trigger 2 + * @arg TIM_TS_ITR3: Internal Trigger 3 + * @retval None + */ +void TIM_ITRxExternalClockConfig(TIM_TypeDef* TIMx, uint16_t TIM_InputTriggerSource) +{ + /* Check the parameters */ + assert_param(IS_TIM_LIST2_PERIPH(TIMx)); + assert_param(IS_TIM_INTERNAL_TRIGGER_SELECTION(TIM_InputTriggerSource)); + + /* Select the Internal Trigger */ + TIM_SelectInputTrigger(TIMx, TIM_InputTriggerSource); + + /* Select the External clock mode1 */ + TIMx->SMCR |= TIM_SlaveMode_External1; +} + +/** + * @brief Configures the TIMx Trigger as External Clock + * @param TIMx: where x can be 1, 2, 3, 4, 5, 8, 9, 10, 11, 12, 13 or 14 + * to select the TIM peripheral. + * @param TIM_TIxExternalCLKSource: Trigger source. + * This parameter can be one of the following values: + * @arg TIM_TIxExternalCLK1Source_TI1ED: TI1 Edge Detector + * @arg TIM_TIxExternalCLK1Source_TI1: Filtered Timer Input 1 + * @arg TIM_TIxExternalCLK1Source_TI2: Filtered Timer Input 2 + * @param TIM_ICPolarity: specifies the TIx Polarity. + * This parameter can be one of the following values: + * @arg TIM_ICPolarity_Rising + * @arg TIM_ICPolarity_Falling + * @param ICFilter: specifies the filter value. + * This parameter must be a value between 0x0 and 0xF. + * @retval None + */ +void TIM_TIxExternalClockConfig(TIM_TypeDef* TIMx, uint16_t TIM_TIxExternalCLKSource, + uint16_t TIM_ICPolarity, uint16_t ICFilter) +{ + /* Check the parameters */ + assert_param(IS_TIM_LIST1_PERIPH(TIMx)); + assert_param(IS_TIM_IC_POLARITY(TIM_ICPolarity)); + assert_param(IS_TIM_IC_FILTER(ICFilter)); + + /* Configure the Timer Input Clock Source */ + if (TIM_TIxExternalCLKSource == TIM_TIxExternalCLK1Source_TI2) + { + TI2_Config(TIMx, TIM_ICPolarity, TIM_ICSelection_DirectTI, ICFilter); + } + else + { + TI1_Config(TIMx, TIM_ICPolarity, TIM_ICSelection_DirectTI, ICFilter); + } + /* Select the Trigger source */ + TIM_SelectInputTrigger(TIMx, TIM_TIxExternalCLKSource); + /* Select the External clock mode1 */ + TIMx->SMCR |= TIM_SlaveMode_External1; +} + +/** + * @brief Configures the External clock Mode1 + * @param TIMx: where x can be 1, 2, 3, 4, 5 or 8 to select the TIM peripheral. + * @param TIM_ExtTRGPrescaler: The external Trigger Prescaler. + * This parameter can be one of the following values: + * @arg TIM_ExtTRGPSC_OFF: ETRP Prescaler OFF. + * @arg TIM_ExtTRGPSC_DIV2: ETRP frequency divided by 2. + * @arg TIM_ExtTRGPSC_DIV4: ETRP frequency divided by 4. + * @arg TIM_ExtTRGPSC_DIV8: ETRP frequency divided by 8. + * @param TIM_ExtTRGPolarity: The external Trigger Polarity. + * This parameter can be one of the following values: + * @arg TIM_ExtTRGPolarity_Inverted: active low or falling edge active. + * @arg TIM_ExtTRGPolarity_NonInverted: active high or rising edge active. + * @param ExtTRGFilter: External Trigger Filter. + * This parameter must be a value between 0x00 and 0x0F + * @retval None + */ +void TIM_ETRClockMode1Config(TIM_TypeDef* TIMx, uint16_t TIM_ExtTRGPrescaler, + uint16_t TIM_ExtTRGPolarity, uint16_t ExtTRGFilter) +{ + uint16_t tmpsmcr = 0; + + /* Check the parameters */ + assert_param(IS_TIM_LIST3_PERIPH(TIMx)); + assert_param(IS_TIM_EXT_PRESCALER(TIM_ExtTRGPrescaler)); + assert_param(IS_TIM_EXT_POLARITY(TIM_ExtTRGPolarity)); + assert_param(IS_TIM_EXT_FILTER(ExtTRGFilter)); + /* Configure the ETR Clock source */ + TIM_ETRConfig(TIMx, TIM_ExtTRGPrescaler, TIM_ExtTRGPolarity, ExtTRGFilter); + + /* Get the TIMx SMCR register value */ + tmpsmcr = TIMx->SMCR; + + /* Reset the SMS Bits */ + tmpsmcr &= (uint16_t)~TIM_SMCR_SMS; + + /* Select the External clock mode1 */ + tmpsmcr |= TIM_SlaveMode_External1; + + /* Select the Trigger selection : ETRF */ + tmpsmcr &= (uint16_t)~TIM_SMCR_TS; + tmpsmcr |= TIM_TS_ETRF; + + /* Write to TIMx SMCR */ + TIMx->SMCR = tmpsmcr; +} + +/** + * @brief Configures the External clock Mode2 + * @param TIMx: where x can be 1, 2, 3, 4, 5 or 8 to select the TIM peripheral. + * @param TIM_ExtTRGPrescaler: The external Trigger Prescaler. + * This parameter can be one of the following values: + * @arg TIM_ExtTRGPSC_OFF: ETRP Prescaler OFF. + * @arg TIM_ExtTRGPSC_DIV2: ETRP frequency divided by 2. + * @arg TIM_ExtTRGPSC_DIV4: ETRP frequency divided by 4. + * @arg TIM_ExtTRGPSC_DIV8: ETRP frequency divided by 8. + * @param TIM_ExtTRGPolarity: The external Trigger Polarity. + * This parameter can be one of the following values: + * @arg TIM_ExtTRGPolarity_Inverted: active low or falling edge active. + * @arg TIM_ExtTRGPolarity_NonInverted: active high or rising edge active. + * @param ExtTRGFilter: External Trigger Filter. + * This parameter must be a value between 0x00 and 0x0F + * @retval None + */ +void TIM_ETRClockMode2Config(TIM_TypeDef* TIMx, uint16_t TIM_ExtTRGPrescaler, + uint16_t TIM_ExtTRGPolarity, uint16_t ExtTRGFilter) +{ + /* Check the parameters */ + assert_param(IS_TIM_LIST3_PERIPH(TIMx)); + assert_param(IS_TIM_EXT_PRESCALER(TIM_ExtTRGPrescaler)); + assert_param(IS_TIM_EXT_POLARITY(TIM_ExtTRGPolarity)); + assert_param(IS_TIM_EXT_FILTER(ExtTRGFilter)); + + /* Configure the ETR Clock source */ + TIM_ETRConfig(TIMx, TIM_ExtTRGPrescaler, TIM_ExtTRGPolarity, ExtTRGFilter); + + /* Enable the External clock mode2 */ + TIMx->SMCR |= TIM_SMCR_ECE; +} +/** + * @} + */ + +/** @defgroup TIM_Group7 Synchronization management functions + * @brief Synchronization management functions + * +@verbatim + =============================================================================== + ##### Synchronization management functions ##### + =============================================================================== + + ##### TIM Driver: how to use it in synchronization Mode ##### + =============================================================================== + [..] + + *** Case of two/several Timers *** + ================================== + [..] + (#) Configure the Master Timers using the following functions: + (++) void TIM_SelectOutputTrigger(TIM_TypeDef* TIMx, uint16_t TIM_TRGOSource); + (++) void TIM_SelectMasterSlaveMode(TIM_TypeDef* TIMx, uint16_t TIM_MasterSlaveMode); + (#) Configure the Slave Timers using the following functions: + (++) void TIM_SelectInputTrigger(TIM_TypeDef* TIMx, uint16_t TIM_InputTriggerSource); + (++) void TIM_SelectSlaveMode(TIM_TypeDef* TIMx, uint16_t TIM_SlaveMode); + + *** Case of Timers and external trigger(ETR pin) *** + ==================================================== + [..] + (#) Configure the External trigger using this function: + (++) void TIM_ETRConfig(TIM_TypeDef* TIMx, uint16_t TIM_ExtTRGPrescaler, uint16_t TIM_ExtTRGPolarity, + uint16_t ExtTRGFilter); + (#) Configure the Slave Timers using the following functions: + (++) void TIM_SelectInputTrigger(TIM_TypeDef* TIMx, uint16_t TIM_InputTriggerSource); + (++) void TIM_SelectSlaveMode(TIM_TypeDef* TIMx, uint16_t TIM_SlaveMode); + +@endverbatim + * @{ + */ + +/** + * @brief Selects the Input Trigger source + * @param TIMx: where x can be 1, 2, 3, 4, 5, 8, 9, 10, 11, 12, 13 or 14 + * to select the TIM peripheral. + * @param TIM_InputTriggerSource: The Input Trigger source. + * This parameter can be one of the following values: + * @arg TIM_TS_ITR0: Internal Trigger 0 + * @arg TIM_TS_ITR1: Internal Trigger 1 + * @arg TIM_TS_ITR2: Internal Trigger 2 + * @arg TIM_TS_ITR3: Internal Trigger 3 + * @arg TIM_TS_TI1F_ED: TI1 Edge Detector + * @arg TIM_TS_TI1FP1: Filtered Timer Input 1 + * @arg TIM_TS_TI2FP2: Filtered Timer Input 2 + * @arg TIM_TS_ETRF: External Trigger input + * @retval None + */ +void TIM_SelectInputTrigger(TIM_TypeDef* TIMx, uint16_t TIM_InputTriggerSource) +{ + uint16_t tmpsmcr = 0; + + /* Check the parameters */ + assert_param(IS_TIM_LIST1_PERIPH(TIMx)); + assert_param(IS_TIM_TRIGGER_SELECTION(TIM_InputTriggerSource)); + + /* Get the TIMx SMCR register value */ + tmpsmcr = TIMx->SMCR; + + /* Reset the TS Bits */ + tmpsmcr &= (uint16_t)~TIM_SMCR_TS; + + /* Set the Input Trigger source */ + tmpsmcr |= TIM_InputTriggerSource; + + /* Write to TIMx SMCR */ + TIMx->SMCR = tmpsmcr; +} + +/** + * @brief Selects the TIMx Trigger Output Mode. + * @param TIMx: where x can be 1, 2, 3, 4, 5, 6, 7 or 8 to select the TIM peripheral. + * + * @param TIM_TRGOSource: specifies the Trigger Output source. + * This parameter can be one of the following values: + * + * - For all TIMx + * @arg TIM_TRGOSource_Reset: The UG bit in the TIM_EGR register is used as the trigger output(TRGO) + * @arg TIM_TRGOSource_Enable: The Counter Enable CEN is used as the trigger output(TRGO) + * @arg TIM_TRGOSource_Update: The update event is selected as the trigger output(TRGO) + * + * - For all TIMx except TIM6 and TIM7 + * @arg TIM_TRGOSource_OC1: The trigger output sends a positive pulse when the CC1IF flag + * is to be set, as soon as a capture or compare match occurs(TRGO) + * @arg TIM_TRGOSource_OC1Ref: OC1REF signal is used as the trigger output(TRGO) + * @arg TIM_TRGOSource_OC2Ref: OC2REF signal is used as the trigger output(TRGO) + * @arg TIM_TRGOSource_OC3Ref: OC3REF signal is used as the trigger output(TRGO) + * @arg TIM_TRGOSource_OC4Ref: OC4REF signal is used as the trigger output(TRGO) + * + * @retval None + */ +void TIM_SelectOutputTrigger(TIM_TypeDef* TIMx, uint16_t TIM_TRGOSource) +{ + /* Check the parameters */ + assert_param(IS_TIM_LIST5_PERIPH(TIMx)); + assert_param(IS_TIM_TRGO_SOURCE(TIM_TRGOSource)); + + /* Reset the MMS Bits */ + TIMx->CR2 &= (uint16_t)~TIM_CR2_MMS; + /* Select the TRGO source */ + TIMx->CR2 |= TIM_TRGOSource; +} + +/** + * @brief Selects the TIMx Slave Mode. + * @param TIMx: where x can be 1, 2, 3, 4, 5, 8, 9 or 12 to select the TIM peripheral. + * @param TIM_SlaveMode: specifies the Timer Slave Mode. + * This parameter can be one of the following values: + * @arg TIM_SlaveMode_Reset: Rising edge of the selected trigger signal(TRGI) reinitialize + * the counter and triggers an update of the registers + * @arg TIM_SlaveMode_Gated: The counter clock is enabled when the trigger signal (TRGI) is high + * @arg TIM_SlaveMode_Trigger: The counter starts at a rising edge of the trigger TRGI + * @arg TIM_SlaveMode_External1: Rising edges of the selected trigger (TRGI) clock the counter + * @retval None + */ +void TIM_SelectSlaveMode(TIM_TypeDef* TIMx, uint16_t TIM_SlaveMode) +{ + /* Check the parameters */ + assert_param(IS_TIM_LIST2_PERIPH(TIMx)); + assert_param(IS_TIM_SLAVE_MODE(TIM_SlaveMode)); + + /* Reset the SMS Bits */ + TIMx->SMCR &= (uint16_t)~TIM_SMCR_SMS; + + /* Select the Slave Mode */ + TIMx->SMCR |= TIM_SlaveMode; +} + +/** + * @brief Sets or Resets the TIMx Master/Slave Mode. + * @param TIMx: where x can be 1, 2, 3, 4, 5, 8, 9 or 12 to select the TIM peripheral. + * @param TIM_MasterSlaveMode: specifies the Timer Master Slave Mode. + * This parameter can be one of the following values: + * @arg TIM_MasterSlaveMode_Enable: synchronization between the current timer + * and its slaves (through TRGO) + * @arg TIM_MasterSlaveMode_Disable: No action + * @retval None + */ +void TIM_SelectMasterSlaveMode(TIM_TypeDef* TIMx, uint16_t TIM_MasterSlaveMode) +{ + /* Check the parameters */ + assert_param(IS_TIM_LIST2_PERIPH(TIMx)); + assert_param(IS_TIM_MSM_STATE(TIM_MasterSlaveMode)); + + /* Reset the MSM Bit */ + TIMx->SMCR &= (uint16_t)~TIM_SMCR_MSM; + + /* Set or Reset the MSM Bit */ + TIMx->SMCR |= TIM_MasterSlaveMode; +} + +/** + * @brief Configures the TIMx External Trigger (ETR). + * @param TIMx: where x can be 1, 2, 3, 4, 5 or 8 to select the TIM peripheral. + * @param TIM_ExtTRGPrescaler: The external Trigger Prescaler. + * This parameter can be one of the following values: + * @arg TIM_ExtTRGPSC_OFF: ETRP Prescaler OFF. + * @arg TIM_ExtTRGPSC_DIV2: ETRP frequency divided by 2. + * @arg TIM_ExtTRGPSC_DIV4: ETRP frequency divided by 4. + * @arg TIM_ExtTRGPSC_DIV8: ETRP frequency divided by 8. + * @param TIM_ExtTRGPolarity: The external Trigger Polarity. + * This parameter can be one of the following values: + * @arg TIM_ExtTRGPolarity_Inverted: active low or falling edge active. + * @arg TIM_ExtTRGPolarity_NonInverted: active high or rising edge active. + * @param ExtTRGFilter: External Trigger Filter. + * This parameter must be a value between 0x00 and 0x0F + * @retval None + */ +void TIM_ETRConfig(TIM_TypeDef* TIMx, uint16_t TIM_ExtTRGPrescaler, + uint16_t TIM_ExtTRGPolarity, uint16_t ExtTRGFilter) +{ + uint16_t tmpsmcr = 0; + + /* Check the parameters */ + assert_param(IS_TIM_LIST3_PERIPH(TIMx)); + assert_param(IS_TIM_EXT_PRESCALER(TIM_ExtTRGPrescaler)); + assert_param(IS_TIM_EXT_POLARITY(TIM_ExtTRGPolarity)); + assert_param(IS_TIM_EXT_FILTER(ExtTRGFilter)); + + tmpsmcr = TIMx->SMCR; + + /* Reset the ETR Bits */ + tmpsmcr &= SMCR_ETR_MASK; + + /* Set the Prescaler, the Filter value and the Polarity */ + tmpsmcr |= (uint16_t)(TIM_ExtTRGPrescaler | (uint16_t)(TIM_ExtTRGPolarity | (uint16_t)(ExtTRGFilter << (uint16_t)8))); + + /* Write to TIMx SMCR */ + TIMx->SMCR = tmpsmcr; +} +/** + * @} + */ + +/** @defgroup TIM_Group8 Specific interface management functions + * @brief Specific interface management functions + * +@verbatim + =============================================================================== + ##### Specific interface management functions ##### + =============================================================================== + +@endverbatim + * @{ + */ + +/** + * @brief Configures the TIMx Encoder Interface. + * @param TIMx: where x can be 1, 2, 3, 4, 5, 8, 9 or 12 to select the TIM + * peripheral. + * @param TIM_EncoderMode: specifies the TIMx Encoder Mode. + * This parameter can be one of the following values: + * @arg TIM_EncoderMode_TI1: Counter counts on TI1FP1 edge depending on TI2FP2 level. + * @arg TIM_EncoderMode_TI2: Counter counts on TI2FP2 edge depending on TI1FP1 level. + * @arg TIM_EncoderMode_TI12: Counter counts on both TI1FP1 and TI2FP2 edges depending + * on the level of the other input. + * @param TIM_IC1Polarity: specifies the IC1 Polarity + * This parameter can be one of the following values: + * @arg TIM_ICPolarity_Falling: IC Falling edge. + * @arg TIM_ICPolarity_Rising: IC Rising edge. + * @param TIM_IC2Polarity: specifies the IC2 Polarity + * This parameter can be one of the following values: + * @arg TIM_ICPolarity_Falling: IC Falling edge. + * @arg TIM_ICPolarity_Rising: IC Rising edge. + * @retval None + */ +void TIM_EncoderInterfaceConfig(TIM_TypeDef* TIMx, uint16_t TIM_EncoderMode, + uint16_t TIM_IC1Polarity, uint16_t TIM_IC2Polarity) +{ + uint16_t tmpsmcr = 0; + uint16_t tmpccmr1 = 0; + uint16_t tmpccer = 0; + + /* Check the parameters */ + assert_param(IS_TIM_LIST2_PERIPH(TIMx)); + assert_param(IS_TIM_ENCODER_MODE(TIM_EncoderMode)); + assert_param(IS_TIM_IC_POLARITY(TIM_IC1Polarity)); + assert_param(IS_TIM_IC_POLARITY(TIM_IC2Polarity)); + + /* Get the TIMx SMCR register value */ + tmpsmcr = TIMx->SMCR; + + /* Get the TIMx CCMR1 register value */ + tmpccmr1 = TIMx->CCMR1; + + /* Get the TIMx CCER register value */ + tmpccer = TIMx->CCER; + + /* Set the encoder Mode */ + tmpsmcr &= (uint16_t)~TIM_SMCR_SMS; + tmpsmcr |= TIM_EncoderMode; + + /* Select the Capture Compare 1 and the Capture Compare 2 as input */ + tmpccmr1 &= ((uint16_t)~TIM_CCMR1_CC1S) & ((uint16_t)~TIM_CCMR1_CC2S); + tmpccmr1 |= TIM_CCMR1_CC1S_0 | TIM_CCMR1_CC2S_0; + + /* Set the TI1 and the TI2 Polarities */ + tmpccer &= ((uint16_t)~TIM_CCER_CC1P) & ((uint16_t)~TIM_CCER_CC2P); + tmpccer |= (uint16_t)(TIM_IC1Polarity | (uint16_t)(TIM_IC2Polarity << (uint16_t)4)); + + /* Write to TIMx SMCR */ + TIMx->SMCR = tmpsmcr; + + /* Write to TIMx CCMR1 */ + TIMx->CCMR1 = tmpccmr1; + + /* Write to TIMx CCER */ + TIMx->CCER = tmpccer; +} + +/** + * @brief Enables or disables the TIMx's Hall sensor interface. + * @param TIMx: where x can be 1, 2, 3, 4, 5, 8, 9 or 12 to select the TIM + * peripheral. + * @param NewState: new state of the TIMx Hall sensor interface. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void TIM_SelectHallSensor(TIM_TypeDef* TIMx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_TIM_LIST2_PERIPH(TIMx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Set the TI1S Bit */ + TIMx->CR2 |= TIM_CR2_TI1S; + } + else + { + /* Reset the TI1S Bit */ + TIMx->CR2 &= (uint16_t)~TIM_CR2_TI1S; + } +} +/** + * @} + */ + +/** @defgroup TIM_Group9 Specific remapping management function + * @brief Specific remapping management function + * +@verbatim + =============================================================================== + ##### Specific remapping management function ##### + =============================================================================== + +@endverbatim + * @{ + */ + +/** + * @brief Configures the TIM2, TIM5 and TIM11 Remapping input capabilities. + * @param TIMx: where x can be 2, 5 or 11 to select the TIM peripheral. + * @param TIM_Remap: specifies the TIM input remapping source. + * This parameter can be one of the following values: + * @arg TIM2_TIM8_TRGO: TIM2 ITR1 input is connected to TIM8 Trigger output(default) + * @arg TIM2_ETH_PTP: TIM2 ITR1 input is connected to ETH PTP trogger output. + * @arg TIM2_USBFS_SOF: TIM2 ITR1 input is connected to USB FS SOF. + * @arg TIM2_USBHS_SOF: TIM2 ITR1 input is connected to USB HS SOF. + * @arg TIM5_GPIO: TIM5 CH4 input is connected to dedicated Timer pin(default) + * @arg TIM5_LSI: TIM5 CH4 input is connected to LSI clock. + * @arg TIM5_LSE: TIM5 CH4 input is connected to LSE clock. + * @arg TIM5_RTC: TIM5 CH4 input is connected to RTC Output event. + * @arg TIM11_GPIO: TIM11 CH4 input is connected to dedicated Timer pin(default) + * @arg TIM11_HSE: TIM11 CH4 input is connected to HSE_RTC clock + * (HSE divided by a programmable prescaler) + * @retval None + */ +void TIM_RemapConfig(TIM_TypeDef* TIMx, uint16_t TIM_Remap) +{ + /* Check the parameters */ + assert_param(IS_TIM_LIST6_PERIPH(TIMx)); + assert_param(IS_TIM_REMAP(TIM_Remap)); + + /* Set the Timer remapping configuration */ + TIMx->OR = TIM_Remap; +} +/** + * @} + */ + +/** + * @brief Configure the TI1 as Input. + * @param TIMx: where x can be 1, 2, 3, 4, 5, 8, 9, 10, 11, 12, 13 or 14 + * to select the TIM peripheral. + * @param TIM_ICPolarity : The Input Polarity. + * This parameter can be one of the following values: + * @arg TIM_ICPolarity_Rising + * @arg TIM_ICPolarity_Falling + * @arg TIM_ICPolarity_BothEdge + * @param TIM_ICSelection: specifies the input to be used. + * This parameter can be one of the following values: + * @arg TIM_ICSelection_DirectTI: TIM Input 1 is selected to be connected to IC1. + * @arg TIM_ICSelection_IndirectTI: TIM Input 1 is selected to be connected to IC2. + * @arg TIM_ICSelection_TRC: TIM Input 1 is selected to be connected to TRC. + * @param TIM_ICFilter: Specifies the Input Capture Filter. + * This parameter must be a value between 0x00 and 0x0F. + * @retval None + */ +static void TI1_Config(TIM_TypeDef* TIMx, uint16_t TIM_ICPolarity, uint16_t TIM_ICSelection, + uint16_t TIM_ICFilter) +{ + uint16_t tmpccmr1 = 0, tmpccer = 0; + + /* Disable the Channel 1: Reset the CC1E Bit */ + TIMx->CCER &= (uint16_t)~TIM_CCER_CC1E; + tmpccmr1 = TIMx->CCMR1; + tmpccer = TIMx->CCER; + + /* Select the Input and set the filter */ + tmpccmr1 &= ((uint16_t)~TIM_CCMR1_CC1S) & ((uint16_t)~TIM_CCMR1_IC1F); + tmpccmr1 |= (uint16_t)(TIM_ICSelection | (uint16_t)(TIM_ICFilter << (uint16_t)4)); + + /* Select the Polarity and set the CC1E Bit */ + tmpccer &= (uint16_t)~(TIM_CCER_CC1P | TIM_CCER_CC1NP); + tmpccer |= (uint16_t)(TIM_ICPolarity | (uint16_t)TIM_CCER_CC1E); + + /* Write to TIMx CCMR1 and CCER registers */ + TIMx->CCMR1 = tmpccmr1; + TIMx->CCER = tmpccer; +} + +/** + * @brief Configure the TI2 as Input. + * @param TIMx: where x can be 1, 2, 3, 4, 5, 8, 9 or 12 to select the TIM + * peripheral. + * @param TIM_ICPolarity : The Input Polarity. + * This parameter can be one of the following values: + * @arg TIM_ICPolarity_Rising + * @arg TIM_ICPolarity_Falling + * @arg TIM_ICPolarity_BothEdge + * @param TIM_ICSelection: specifies the input to be used. + * This parameter can be one of the following values: + * @arg TIM_ICSelection_DirectTI: TIM Input 2 is selected to be connected to IC2. + * @arg TIM_ICSelection_IndirectTI: TIM Input 2 is selected to be connected to IC1. + * @arg TIM_ICSelection_TRC: TIM Input 2 is selected to be connected to TRC. + * @param TIM_ICFilter: Specifies the Input Capture Filter. + * This parameter must be a value between 0x00 and 0x0F. + * @retval None + */ +static void TI2_Config(TIM_TypeDef* TIMx, uint16_t TIM_ICPolarity, uint16_t TIM_ICSelection, + uint16_t TIM_ICFilter) +{ + uint16_t tmpccmr1 = 0, tmpccer = 0, tmp = 0; + + /* Disable the Channel 2: Reset the CC2E Bit */ + TIMx->CCER &= (uint16_t)~TIM_CCER_CC2E; + tmpccmr1 = TIMx->CCMR1; + tmpccer = TIMx->CCER; + tmp = (uint16_t)(TIM_ICPolarity << 4); + + /* Select the Input and set the filter */ + tmpccmr1 &= ((uint16_t)~TIM_CCMR1_CC2S) & ((uint16_t)~TIM_CCMR1_IC2F); + tmpccmr1 |= (uint16_t)(TIM_ICFilter << 12); + tmpccmr1 |= (uint16_t)(TIM_ICSelection << 8); + + /* Select the Polarity and set the CC2E Bit */ + tmpccer &= (uint16_t)~(TIM_CCER_CC2P | TIM_CCER_CC2NP); + tmpccer |= (uint16_t)(tmp | (uint16_t)TIM_CCER_CC2E); + + /* Write to TIMx CCMR1 and CCER registers */ + TIMx->CCMR1 = tmpccmr1 ; + TIMx->CCER = tmpccer; +} + +/** + * @brief Configure the TI3 as Input. + * @param TIMx: where x can be 1, 2, 3, 4, 5 or 8 to select the TIM peripheral. + * @param TIM_ICPolarity : The Input Polarity. + * This parameter can be one of the following values: + * @arg TIM_ICPolarity_Rising + * @arg TIM_ICPolarity_Falling + * @arg TIM_ICPolarity_BothEdge + * @param TIM_ICSelection: specifies the input to be used. + * This parameter can be one of the following values: + * @arg TIM_ICSelection_DirectTI: TIM Input 3 is selected to be connected to IC3. + * @arg TIM_ICSelection_IndirectTI: TIM Input 3 is selected to be connected to IC4. + * @arg TIM_ICSelection_TRC: TIM Input 3 is selected to be connected to TRC. + * @param TIM_ICFilter: Specifies the Input Capture Filter. + * This parameter must be a value between 0x00 and 0x0F. + * @retval None + */ +static void TI3_Config(TIM_TypeDef* TIMx, uint16_t TIM_ICPolarity, uint16_t TIM_ICSelection, + uint16_t TIM_ICFilter) +{ + uint16_t tmpccmr2 = 0, tmpccer = 0, tmp = 0; + + /* Disable the Channel 3: Reset the CC3E Bit */ + TIMx->CCER &= (uint16_t)~TIM_CCER_CC3E; + tmpccmr2 = TIMx->CCMR2; + tmpccer = TIMx->CCER; + tmp = (uint16_t)(TIM_ICPolarity << 8); + + /* Select the Input and set the filter */ + tmpccmr2 &= ((uint16_t)~TIM_CCMR1_CC1S) & ((uint16_t)~TIM_CCMR2_IC3F); + tmpccmr2 |= (uint16_t)(TIM_ICSelection | (uint16_t)(TIM_ICFilter << (uint16_t)4)); + + /* Select the Polarity and set the CC3E Bit */ + tmpccer &= (uint16_t)~(TIM_CCER_CC3P | TIM_CCER_CC3NP); + tmpccer |= (uint16_t)(tmp | (uint16_t)TIM_CCER_CC3E); + + /* Write to TIMx CCMR2 and CCER registers */ + TIMx->CCMR2 = tmpccmr2; + TIMx->CCER = tmpccer; +} + +/** + * @brief Configure the TI4 as Input. + * @param TIMx: where x can be 1, 2, 3, 4, 5 or 8 to select the TIM peripheral. + * @param TIM_ICPolarity : The Input Polarity. + * This parameter can be one of the following values: + * @arg TIM_ICPolarity_Rising + * @arg TIM_ICPolarity_Falling + * @arg TIM_ICPolarity_BothEdge + * @param TIM_ICSelection: specifies the input to be used. + * This parameter can be one of the following values: + * @arg TIM_ICSelection_DirectTI: TIM Input 4 is selected to be connected to IC4. + * @arg TIM_ICSelection_IndirectTI: TIM Input 4 is selected to be connected to IC3. + * @arg TIM_ICSelection_TRC: TIM Input 4 is selected to be connected to TRC. + * @param TIM_ICFilter: Specifies the Input Capture Filter. + * This parameter must be a value between 0x00 and 0x0F. + * @retval None + */ +static void TI4_Config(TIM_TypeDef* TIMx, uint16_t TIM_ICPolarity, uint16_t TIM_ICSelection, + uint16_t TIM_ICFilter) +{ + uint16_t tmpccmr2 = 0, tmpccer = 0, tmp = 0; + + /* Disable the Channel 4: Reset the CC4E Bit */ + TIMx->CCER &= (uint16_t)~TIM_CCER_CC4E; + tmpccmr2 = TIMx->CCMR2; + tmpccer = TIMx->CCER; + tmp = (uint16_t)(TIM_ICPolarity << 12); + + /* Select the Input and set the filter */ + tmpccmr2 &= ((uint16_t)~TIM_CCMR1_CC2S) & ((uint16_t)~TIM_CCMR1_IC2F); + tmpccmr2 |= (uint16_t)(TIM_ICSelection << 8); + tmpccmr2 |= (uint16_t)(TIM_ICFilter << 12); + + /* Select the Polarity and set the CC4E Bit */ + tmpccer &= (uint16_t)~(TIM_CCER_CC4P | TIM_CCER_CC4NP); + tmpccer |= (uint16_t)(tmp | (uint16_t)TIM_CCER_CC4E); + + /* Write to TIMx CCMR2 and CCER registers */ + TIMx->CCMR2 = tmpccmr2; + TIMx->CCER = tmpccer ; +} + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/src/stm32f4xx_usart.c b/FWLIB/src/stm32f4xx_usart.c new file mode 100644 index 0000000..2757478 --- /dev/null +++ b/FWLIB/src/stm32f4xx_usart.c @@ -0,0 +1,1486 @@ +/** + ****************************************************************************** + * @file stm32f4xx_usart.c + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file provides firmware functions to manage the following + * functionalities of the Universal synchronous asynchronous receiver + * transmitter (USART): + * + Initialization and Configuration + * + Data transfers + * + Multi-Processor Communication + * + LIN mode + * + Half-duplex mode + * + Smartcard mode + * + IrDA mode + * + DMA transfers management + * + Interrupts and flags management + * + @verbatim + =============================================================================== + ##### How to use this driver ##### + =============================================================================== + [..] + (#) Enable peripheral clock using the following functions + RCC_APB2PeriphClockCmd(RCC_APB2Periph_USARTx, ENABLE) for USART1 and USART6 + RCC_APB1PeriphClockCmd(RCC_APB1Periph_USARTx, ENABLE) for USART2, USART3, + UART4 or UART5. + + (#) According to the USART mode, enable the GPIO clocks using + RCC_AHB1PeriphClockCmd() function. (The I/O can be TX, RX, CTS, + or/and SCLK). + + (#) Peripheral's alternate function: + (++) Connect the pin to the desired peripherals' Alternate + Function (AF) using GPIO_PinAFConfig() function + (++) Configure the desired pin in alternate function by: + GPIO_InitStruct->GPIO_Mode = GPIO_Mode_AF + (++) Select the type, pull-up/pull-down and output speed via + GPIO_PuPd, GPIO_OType and GPIO_Speed members + (++) Call GPIO_Init() function + + (#) Program the Baud Rate, Word Length , Stop Bit, Parity, Hardware + flow control and Mode(Receiver/Transmitter) using the USART_Init() + function. + + (#) For synchronous mode, enable the clock and program the polarity, + phase and last bit using the USART_ClockInit() function. + + (#) Enable the NVIC and the corresponding interrupt using the function + USART_ITConfig() if you need to use interrupt mode. + + (#) When using the DMA mode + (++) Configure the DMA using DMA_Init() function + (++) Active the needed channel Request using USART_DMACmd() function + + (#) Enable the USART using the USART_Cmd() function. + + (#) Enable the DMA using the DMA_Cmd() function, when using DMA mode. + + -@- Refer to Multi-Processor, LIN, half-duplex, Smartcard, IrDA sub-sections + for more details + + [..] + In order to reach higher communication baudrates, it is possible to + enable the oversampling by 8 mode using the function USART_OverSampling8Cmd(). + This function should be called after enabling the USART clock (RCC_APBxPeriphClockCmd()) + and before calling the function USART_Init(). + + @endverbatim + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx_usart.h" +#include "stm32f4xx_rcc.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @defgroup USART + * @brief USART driver modules + * @{ + */ + +/* Private typedef -----------------------------------------------------------*/ +/* Private define ------------------------------------------------------------*/ + +/*!< USART CR1 register clear Mask ((~(uint16_t)0xE9F3)) */ +#define CR1_CLEAR_MASK ((uint16_t)(USART_CR1_M | USART_CR1_PCE | \ + USART_CR1_PS | USART_CR1_TE | \ + USART_CR1_RE)) + +/*!< USART CR2 register clock bits clear Mask ((~(uint16_t)0xF0FF)) */ +#define CR2_CLOCK_CLEAR_MASK ((uint16_t)(USART_CR2_CLKEN | USART_CR2_CPOL | \ + USART_CR2_CPHA | USART_CR2_LBCL)) + +/*!< USART CR3 register clear Mask ((~(uint16_t)0xFCFF)) */ +#define CR3_CLEAR_MASK ((uint16_t)(USART_CR3_RTSE | USART_CR3_CTSE)) + +/*!< USART Interrupts mask */ +#define IT_MASK ((uint16_t)0x001F) + +/* Private macro -------------------------------------------------------------*/ +/* Private variables ---------------------------------------------------------*/ +/* Private function prototypes -----------------------------------------------*/ +/* Private functions ---------------------------------------------------------*/ + +/** @defgroup USART_Private_Functions + * @{ + */ + +/** @defgroup USART_Group1 Initialization and Configuration functions + * @brief Initialization and Configuration functions + * +@verbatim + =============================================================================== + ##### Initialization and Configuration functions ##### + =============================================================================== + [..] + This subsection provides a set of functions allowing to initialize the USART + in asynchronous and in synchronous modes. + (+) For the asynchronous mode only these parameters can be configured: + (++) Baud Rate + (++) Word Length + (++) Stop Bit + (++) Parity: If the parity is enabled, then the MSB bit of the data written + in the data register is transmitted but is changed by the parity bit. + Depending on the frame length defined by the M bit (8-bits or 9-bits), + the possible USART frame formats are as listed in the following table: + +-------------------------------------------------------------+ + | M bit | PCE bit | USART frame | + |---------------------|---------------------------------------| + | 0 | 0 | | SB | 8 bit data | STB | | + |---------|-----------|---------------------------------------| + | 0 | 1 | | SB | 7 bit data | PB | STB | | + |---------|-----------|---------------------------------------| + | 1 | 0 | | SB | 9 bit data | STB | | + |---------|-----------|---------------------------------------| + | 1 | 1 | | SB | 8 bit data | PB | STB | | + +-------------------------------------------------------------+ + (++) Hardware flow control + (++) Receiver/transmitter modes + + [..] + The USART_Init() function follows the USART asynchronous configuration + procedure (details for the procedure are available in reference manual (RM0090)). + + (+) For the synchronous mode in addition to the asynchronous mode parameters these + parameters should be also configured: + (++) USART Clock Enabled + (++) USART polarity + (++) USART phase + (++) USART LastBit + + [..] + These parameters can be configured using the USART_ClockInit() function. + +@endverbatim + * @{ + */ + +/** + * @brief Deinitializes the USARTx peripheral registers to their default reset values. + * @param USARTx: where x can be 1, 2, 3, 4, 5, 6, 7 or 8 to select the USART or + * UART peripheral. + * @retval None + */ +void USART_DeInit(USART_TypeDef* USARTx) +{ + /* Check the parameters */ + assert_param(IS_USART_ALL_PERIPH(USARTx)); + + if (USARTx == USART1) + { + RCC_APB2PeriphResetCmd(RCC_APB2Periph_USART1, ENABLE); + RCC_APB2PeriphResetCmd(RCC_APB2Periph_USART1, DISABLE); + } + else if (USARTx == USART2) + { + RCC_APB1PeriphResetCmd(RCC_APB1Periph_USART2, ENABLE); + RCC_APB1PeriphResetCmd(RCC_APB1Periph_USART2, DISABLE); + } + else if (USARTx == USART3) + { + RCC_APB1PeriphResetCmd(RCC_APB1Periph_USART3, ENABLE); + RCC_APB1PeriphResetCmd(RCC_APB1Periph_USART3, DISABLE); + } + else if (USARTx == UART4) + { + RCC_APB1PeriphResetCmd(RCC_APB1Periph_UART4, ENABLE); + RCC_APB1PeriphResetCmd(RCC_APB1Periph_UART4, DISABLE); + } + else if (USARTx == UART5) + { + RCC_APB1PeriphResetCmd(RCC_APB1Periph_UART5, ENABLE); + RCC_APB1PeriphResetCmd(RCC_APB1Periph_UART5, DISABLE); + } + else if (USARTx == USART6) + { + RCC_APB2PeriphResetCmd(RCC_APB2Periph_USART6, ENABLE); + RCC_APB2PeriphResetCmd(RCC_APB2Periph_USART6, DISABLE); + } + else if (USARTx == UART7) + { + RCC_APB1PeriphResetCmd(RCC_APB1Periph_UART7, ENABLE); + RCC_APB1PeriphResetCmd(RCC_APB1Periph_UART7, DISABLE); + } + else + { + if (USARTx == UART8) + { + RCC_APB1PeriphResetCmd(RCC_APB1Periph_UART8, ENABLE); + RCC_APB1PeriphResetCmd(RCC_APB1Periph_UART8, DISABLE); + } + } +} + +/** + * @brief Initializes the USARTx peripheral according to the specified + * parameters in the USART_InitStruct . + * @param USARTx: where x can be 1, 2, 3, 4, 5, 6, 7 or 8 to select the USART or + * UART peripheral. + * @param USART_InitStruct: pointer to a USART_InitTypeDef structure that contains + * the configuration information for the specified USART peripheral. + * @retval None + */ +void USART_Init(USART_TypeDef* USARTx, USART_InitTypeDef* USART_InitStruct) +{ + uint32_t tmpreg = 0x00, apbclock = 0x00; + uint32_t integerdivider = 0x00; + uint32_t fractionaldivider = 0x00; + RCC_ClocksTypeDef RCC_ClocksStatus; + + /* Check the parameters */ + assert_param(IS_USART_ALL_PERIPH(USARTx)); + assert_param(IS_USART_BAUDRATE(USART_InitStruct->USART_BaudRate)); + assert_param(IS_USART_WORD_LENGTH(USART_InitStruct->USART_WordLength)); + assert_param(IS_USART_STOPBITS(USART_InitStruct->USART_StopBits)); + assert_param(IS_USART_PARITY(USART_InitStruct->USART_Parity)); + assert_param(IS_USART_MODE(USART_InitStruct->USART_Mode)); + assert_param(IS_USART_HARDWARE_FLOW_CONTROL(USART_InitStruct->USART_HardwareFlowControl)); + + /* The hardware flow control is available only for USART1, USART2, USART3 and USART6 */ + if (USART_InitStruct->USART_HardwareFlowControl != USART_HardwareFlowControl_None) + { + assert_param(IS_USART_1236_PERIPH(USARTx)); + } + +/*---------------------------- USART CR2 Configuration -----------------------*/ + tmpreg = USARTx->CR2; + + /* Clear STOP[13:12] bits */ + tmpreg &= (uint32_t)~((uint32_t)USART_CR2_STOP); + + /* Configure the USART Stop Bits, Clock, CPOL, CPHA and LastBit : + Set STOP[13:12] bits according to USART_StopBits value */ + tmpreg |= (uint32_t)USART_InitStruct->USART_StopBits; + + /* Write to USART CR2 */ + USARTx->CR2 = (uint16_t)tmpreg; + +/*---------------------------- USART CR1 Configuration -----------------------*/ + tmpreg = USARTx->CR1; + + /* Clear M, PCE, PS, TE and RE bits */ + tmpreg &= (uint32_t)~((uint32_t)CR1_CLEAR_MASK); + + /* Configure the USART Word Length, Parity and mode: + Set the M bits according to USART_WordLength value + Set PCE and PS bits according to USART_Parity value + Set TE and RE bits according to USART_Mode value */ + tmpreg |= (uint32_t)USART_InitStruct->USART_WordLength | USART_InitStruct->USART_Parity | + USART_InitStruct->USART_Mode; + + /* Write to USART CR1 */ + USARTx->CR1 = (uint16_t)tmpreg; + +/*---------------------------- USART CR3 Configuration -----------------------*/ + tmpreg = USARTx->CR3; + + /* Clear CTSE and RTSE bits */ + tmpreg &= (uint32_t)~((uint32_t)CR3_CLEAR_MASK); + + /* Configure the USART HFC : + Set CTSE and RTSE bits according to USART_HardwareFlowControl value */ + tmpreg |= USART_InitStruct->USART_HardwareFlowControl; + + /* Write to USART CR3 */ + USARTx->CR3 = (uint16_t)tmpreg; + +/*---------------------------- USART BRR Configuration -----------------------*/ + /* Configure the USART Baud Rate */ + RCC_GetClocksFreq(&RCC_ClocksStatus); + + if ((USARTx == USART1) || (USARTx == USART6)) + { + apbclock = RCC_ClocksStatus.PCLK2_Frequency; + } + else + { + apbclock = RCC_ClocksStatus.PCLK1_Frequency; + } + + /* Determine the integer part */ + if ((USARTx->CR1 & USART_CR1_OVER8) != 0) + { + /* Integer part computing in case Oversampling mode is 8 Samples */ + integerdivider = ((25 * apbclock) / (2 * (USART_InitStruct->USART_BaudRate))); + } + else /* if ((USARTx->CR1 & USART_CR1_OVER8) == 0) */ + { + /* Integer part computing in case Oversampling mode is 16 Samples */ + integerdivider = ((25 * apbclock) / (4 * (USART_InitStruct->USART_BaudRate))); + } + tmpreg = (integerdivider / 100) << 4; + + /* Determine the fractional part */ + fractionaldivider = integerdivider - (100 * (tmpreg >> 4)); + + /* Implement the fractional part in the register */ + if ((USARTx->CR1 & USART_CR1_OVER8) != 0) + { + tmpreg |= ((((fractionaldivider * 8) + 50) / 100)) & ((uint8_t)0x07); + } + else /* if ((USARTx->CR1 & USART_CR1_OVER8) == 0) */ + { + tmpreg |= ((((fractionaldivider * 16) + 50) / 100)) & ((uint8_t)0x0F); + } + + /* Write to USART BRR register */ + USARTx->BRR = (uint16_t)tmpreg; +} + +/** + * @brief Fills each USART_InitStruct member with its default value. + * @param USART_InitStruct: pointer to a USART_InitTypeDef structure which will + * be initialized. + * @retval None + */ +void USART_StructInit(USART_InitTypeDef* USART_InitStruct) +{ + /* USART_InitStruct members default value */ + USART_InitStruct->USART_BaudRate = 9600; + USART_InitStruct->USART_WordLength = USART_WordLength_8b; + USART_InitStruct->USART_StopBits = USART_StopBits_1; + USART_InitStruct->USART_Parity = USART_Parity_No ; + USART_InitStruct->USART_Mode = USART_Mode_Rx | USART_Mode_Tx; + USART_InitStruct->USART_HardwareFlowControl = USART_HardwareFlowControl_None; +} + +/** + * @brief Initializes the USARTx peripheral Clock according to the + * specified parameters in the USART_ClockInitStruct . + * @param USARTx: where x can be 1, 2, 3 or 6 to select the USART peripheral. + * @param USART_ClockInitStruct: pointer to a USART_ClockInitTypeDef structure that + * contains the configuration information for the specified USART peripheral. + * @note The Smart Card and Synchronous modes are not available for UART4 and UART5. + * @retval None + */ +void USART_ClockInit(USART_TypeDef* USARTx, USART_ClockInitTypeDef* USART_ClockInitStruct) +{ + uint32_t tmpreg = 0x00; + /* Check the parameters */ + assert_param(IS_USART_1236_PERIPH(USARTx)); + assert_param(IS_USART_CLOCK(USART_ClockInitStruct->USART_Clock)); + assert_param(IS_USART_CPOL(USART_ClockInitStruct->USART_CPOL)); + assert_param(IS_USART_CPHA(USART_ClockInitStruct->USART_CPHA)); + assert_param(IS_USART_LASTBIT(USART_ClockInitStruct->USART_LastBit)); + +/*---------------------------- USART CR2 Configuration -----------------------*/ + tmpreg = USARTx->CR2; + /* Clear CLKEN, CPOL, CPHA and LBCL bits */ + tmpreg &= (uint32_t)~((uint32_t)CR2_CLOCK_CLEAR_MASK); + /* Configure the USART Clock, CPOL, CPHA and LastBit ------------*/ + /* Set CLKEN bit according to USART_Clock value */ + /* Set CPOL bit according to USART_CPOL value */ + /* Set CPHA bit according to USART_CPHA value */ + /* Set LBCL bit according to USART_LastBit value */ + tmpreg |= (uint32_t)USART_ClockInitStruct->USART_Clock | USART_ClockInitStruct->USART_CPOL | + USART_ClockInitStruct->USART_CPHA | USART_ClockInitStruct->USART_LastBit; + /* Write to USART CR2 */ + USARTx->CR2 = (uint16_t)tmpreg; +} + +/** + * @brief Fills each USART_ClockInitStruct member with its default value. + * @param USART_ClockInitStruct: pointer to a USART_ClockInitTypeDef structure + * which will be initialized. + * @retval None + */ +void USART_ClockStructInit(USART_ClockInitTypeDef* USART_ClockInitStruct) +{ + /* USART_ClockInitStruct members default value */ + USART_ClockInitStruct->USART_Clock = USART_Clock_Disable; + USART_ClockInitStruct->USART_CPOL = USART_CPOL_Low; + USART_ClockInitStruct->USART_CPHA = USART_CPHA_1Edge; + USART_ClockInitStruct->USART_LastBit = USART_LastBit_Disable; +} + +/** + * @brief Enables or disables the specified USART peripheral. + * @param USARTx: where x can be 1, 2, 3, 4, 5, 6, 7 or 8 to select the USART or + * UART peripheral. + * @param NewState: new state of the USARTx peripheral. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void USART_Cmd(USART_TypeDef* USARTx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_USART_ALL_PERIPH(USARTx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the selected USART by setting the UE bit in the CR1 register */ + USARTx->CR1 |= USART_CR1_UE; + } + else + { + /* Disable the selected USART by clearing the UE bit in the CR1 register */ + USARTx->CR1 &= (uint16_t)~((uint16_t)USART_CR1_UE); + } +} + +/** + * @brief Sets the system clock prescaler. + * @param USARTx: where x can be 1, 2, 3, 4, 5, 6, 7 or 8 to select the USART or + * UART peripheral. + * @param USART_Prescaler: specifies the prescaler clock. + * @note The function is used for IrDA mode with UART4 and UART5. + * @retval None + */ +void USART_SetPrescaler(USART_TypeDef* USARTx, uint8_t USART_Prescaler) +{ + /* Check the parameters */ + assert_param(IS_USART_ALL_PERIPH(USARTx)); + + /* Clear the USART prescaler */ + USARTx->GTPR &= USART_GTPR_GT; + /* Set the USART prescaler */ + USARTx->GTPR |= USART_Prescaler; +} + +/** + * @brief Enables or disables the USART's 8x oversampling mode. + * @note This function has to be called before calling USART_Init() function + * in order to have correct baudrate Divider value. + * @param USARTx: where x can be 1, 2, 3, 4, 5, 6, 7 or 8 to select the USART or + * UART peripheral. + * @param NewState: new state of the USART 8x oversampling mode. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void USART_OverSampling8Cmd(USART_TypeDef* USARTx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_USART_ALL_PERIPH(USARTx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the 8x Oversampling mode by setting the OVER8 bit in the CR1 register */ + USARTx->CR1 |= USART_CR1_OVER8; + } + else + { + /* Disable the 8x Oversampling mode by clearing the OVER8 bit in the CR1 register */ + USARTx->CR1 &= (uint16_t)~((uint16_t)USART_CR1_OVER8); + } +} + +/** + * @brief Enables or disables the USART's one bit sampling method. + * @param USARTx: where x can be 1, 2, 3, 4, 5, 6, 7 or 8 to select the USART or + * UART peripheral. + * @param NewState: new state of the USART one bit sampling method. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void USART_OneBitMethodCmd(USART_TypeDef* USARTx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_USART_ALL_PERIPH(USARTx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the one bit method by setting the ONEBITE bit in the CR3 register */ + USARTx->CR3 |= USART_CR3_ONEBIT; + } + else + { + /* Disable the one bit method by clearing the ONEBITE bit in the CR3 register */ + USARTx->CR3 &= (uint16_t)~((uint16_t)USART_CR3_ONEBIT); + } +} + +/** + * @} + */ + +/** @defgroup USART_Group2 Data transfers functions + * @brief Data transfers functions + * +@verbatim + =============================================================================== + ##### Data transfers functions ##### + =============================================================================== + [..] + This subsection provides a set of functions allowing to manage the USART data + transfers. + [..] + During an USART reception, data shifts in least significant bit first through + the RX pin. In this mode, the USART_DR register consists of a buffer (RDR) + between the internal bus and the received shift register. + [..] + When a transmission is taking place, a write instruction to the USART_DR register + stores the data in the TDR register and which is copied in the shift register + at the end of the current transmission. + [..] + The read access of the USART_DR register can be done using the USART_ReceiveData() + function and returns the RDR buffered value. Whereas a write access to the USART_DR + can be done using USART_SendData() function and stores the written data into + TDR buffer. + +@endverbatim + * @{ + */ + +/** + * @brief Transmits single data through the USARTx peripheral. + * @param USARTx: where x can be 1, 2, 3, 4, 5, 6, 7 or 8 to select the USART or + * UART peripheral. + * @param Data: the data to transmit. + * @retval None + */ +void USART_SendData(USART_TypeDef* USARTx, uint16_t Data) +{ + /* Check the parameters */ + assert_param(IS_USART_ALL_PERIPH(USARTx)); + assert_param(IS_USART_DATA(Data)); + + /* Transmit Data */ + USARTx->DR = (Data & (uint16_t)0x01FF); +} + +/** + * @brief Returns the most recent received data by the USARTx peripheral. + * @param USARTx: where x can be 1, 2, 3, 4, 5, 6, 7 or 8 to select the USART or + * UART peripheral. + * @retval The received data. + */ +uint16_t USART_ReceiveData(USART_TypeDef* USARTx) +{ + /* Check the parameters */ + assert_param(IS_USART_ALL_PERIPH(USARTx)); + + /* Receive Data */ + return (uint16_t)(USARTx->DR & (uint16_t)0x01FF); +} + +/** + * @} + */ + +/** @defgroup USART_Group3 MultiProcessor Communication functions + * @brief Multi-Processor Communication functions + * +@verbatim + =============================================================================== + ##### Multi-Processor Communication functions ##### + =============================================================================== + [..] + This subsection provides a set of functions allowing to manage the USART + multiprocessor communication. + [..] + For instance one of the USARTs can be the master, its TX output is connected + to the RX input of the other USART. The others are slaves, their respective + TX outputs are logically ANDed together and connected to the RX input of the + master. + [..] + USART multiprocessor communication is possible through the following procedure: + (#) Program the Baud rate, Word length = 9 bits, Stop bits, Parity, Mode + transmitter or Mode receiver and hardware flow control values using + the USART_Init() function. + (#) Configures the USART address using the USART_SetAddress() function. + (#) Configures the wake up method (USART_WakeUp_IdleLine or USART_WakeUp_AddressMark) + using USART_WakeUpConfig() function only for the slaves. + (#) Enable the USART using the USART_Cmd() function. + (#) Enter the USART slaves in mute mode using USART_ReceiverWakeUpCmd() function. + [..] + The USART Slave exit from mute mode when receive the wake up condition. + +@endverbatim + * @{ + */ + +/** + * @brief Sets the address of the USART node. + * @param USARTx: where x can be 1, 2, 3, 4, 5, 6, 7 or 8 to select the USART or + * UART peripheral. + * @param USART_Address: Indicates the address of the USART node. + * @retval None + */ +void USART_SetAddress(USART_TypeDef* USARTx, uint8_t USART_Address) +{ + /* Check the parameters */ + assert_param(IS_USART_ALL_PERIPH(USARTx)); + assert_param(IS_USART_ADDRESS(USART_Address)); + + /* Clear the USART address */ + USARTx->CR2 &= (uint16_t)~((uint16_t)USART_CR2_ADD); + /* Set the USART address node */ + USARTx->CR2 |= USART_Address; +} + +/** + * @brief Determines if the USART is in mute mode or not. + * @param USARTx: where x can be 1, 2, 3, 4, 5, 6, 7 or 8 to select the USART or + * UART peripheral. + * @param NewState: new state of the USART mute mode. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void USART_ReceiverWakeUpCmd(USART_TypeDef* USARTx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_USART_ALL_PERIPH(USARTx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the USART mute mode by setting the RWU bit in the CR1 register */ + USARTx->CR1 |= USART_CR1_RWU; + } + else + { + /* Disable the USART mute mode by clearing the RWU bit in the CR1 register */ + USARTx->CR1 &= (uint16_t)~((uint16_t)USART_CR1_RWU); + } +} +/** + * @brief Selects the USART WakeUp method. + * @param USARTx: where x can be 1, 2, 3, 4, 5, 6, 7 or 8 to select the USART or + * UART peripheral. + * @param USART_WakeUp: specifies the USART wakeup method. + * This parameter can be one of the following values: + * @arg USART_WakeUp_IdleLine: WakeUp by an idle line detection + * @arg USART_WakeUp_AddressMark: WakeUp by an address mark + * @retval None + */ +void USART_WakeUpConfig(USART_TypeDef* USARTx, uint16_t USART_WakeUp) +{ + /* Check the parameters */ + assert_param(IS_USART_ALL_PERIPH(USARTx)); + assert_param(IS_USART_WAKEUP(USART_WakeUp)); + + USARTx->CR1 &= (uint16_t)~((uint16_t)USART_CR1_WAKE); + USARTx->CR1 |= USART_WakeUp; +} + +/** + * @} + */ + +/** @defgroup USART_Group4 LIN mode functions + * @brief LIN mode functions + * +@verbatim + =============================================================================== + ##### LIN mode functions ##### + =============================================================================== + [..] + This subsection provides a set of functions allowing to manage the USART LIN + Mode communication. + [..] + In LIN mode, 8-bit data format with 1 stop bit is required in accordance with + the LIN standard. + [..] + Only this LIN Feature is supported by the USART IP: + (+) LIN Master Synchronous Break send capability and LIN slave break detection + capability : 13-bit break generation and 10/11 bit break detection + + [..] + USART LIN Master transmitter communication is possible through the following + procedure: + (#) Program the Baud rate, Word length = 8bits, Stop bits = 1bit, Parity, + Mode transmitter or Mode receiver and hardware flow control values using + the USART_Init() function. + (#) Enable the USART using the USART_Cmd() function. + (#) Enable the LIN mode using the USART_LINCmd() function. + (#) Send the break character using USART_SendBreak() function. + [..] + USART LIN Master receiver communication is possible through the following procedure: + (#) Program the Baud rate, Word length = 8bits, Stop bits = 1bit, Parity, + Mode transmitter or Mode receiver and hardware flow control values using + the USART_Init() function. + (#) Enable the USART using the USART_Cmd() function. + (#) Configures the break detection length using the USART_LINBreakDetectLengthConfig() + function. + (#) Enable the LIN mode using the USART_LINCmd() function. + + -@- In LIN mode, the following bits must be kept cleared: + (+@) CLKEN in the USART_CR2 register, + (+@) STOP[1:0], SCEN, HDSEL and IREN in the USART_CR3 register. + +@endverbatim + * @{ + */ + +/** + * @brief Sets the USART LIN Break detection length. + * @param USARTx: where x can be 1, 2, 3, 4, 5, 6, 7 or 8 to select the USART or + * UART peripheral. + * @param USART_LINBreakDetectLength: specifies the LIN break detection length. + * This parameter can be one of the following values: + * @arg USART_LINBreakDetectLength_10b: 10-bit break detection + * @arg USART_LINBreakDetectLength_11b: 11-bit break detection + * @retval None + */ +void USART_LINBreakDetectLengthConfig(USART_TypeDef* USARTx, uint16_t USART_LINBreakDetectLength) +{ + /* Check the parameters */ + assert_param(IS_USART_ALL_PERIPH(USARTx)); + assert_param(IS_USART_LIN_BREAK_DETECT_LENGTH(USART_LINBreakDetectLength)); + + USARTx->CR2 &= (uint16_t)~((uint16_t)USART_CR2_LBDL); + USARTx->CR2 |= USART_LINBreakDetectLength; +} + +/** + * @brief Enables or disables the USART's LIN mode. + * @param USARTx: where x can be 1, 2, 3, 4, 5, 6, 7 or 8 to select the USART or + * UART peripheral. + * @param NewState: new state of the USART LIN mode. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void USART_LINCmd(USART_TypeDef* USARTx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_USART_ALL_PERIPH(USARTx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the LIN mode by setting the LINEN bit in the CR2 register */ + USARTx->CR2 |= USART_CR2_LINEN; + } + else + { + /* Disable the LIN mode by clearing the LINEN bit in the CR2 register */ + USARTx->CR2 &= (uint16_t)~((uint16_t)USART_CR2_LINEN); + } +} + +/** + * @brief Transmits break characters. + * @param USARTx: where x can be 1, 2, 3, 4, 5, 6, 7 or 8 to select the USART or + * UART peripheral. + * @retval None + */ +void USART_SendBreak(USART_TypeDef* USARTx) +{ + /* Check the parameters */ + assert_param(IS_USART_ALL_PERIPH(USARTx)); + + /* Send break characters */ + USARTx->CR1 |= USART_CR1_SBK; +} + +/** + * @} + */ + +/** @defgroup USART_Group5 Halfduplex mode function + * @brief Half-duplex mode function + * +@verbatim + =============================================================================== + ##### Half-duplex mode function ##### + =============================================================================== + [..] + This subsection provides a set of functions allowing to manage the USART + Half-duplex communication. + [..] + The USART can be configured to follow a single-wire half-duplex protocol where + the TX and RX lines are internally connected. + [..] + USART Half duplex communication is possible through the following procedure: + (#) Program the Baud rate, Word length, Stop bits, Parity, Mode transmitter + or Mode receiver and hardware flow control values using the USART_Init() + function. + (#) Configures the USART address using the USART_SetAddress() function. + (#) Enable the USART using the USART_Cmd() function. + (#) Enable the half duplex mode using USART_HalfDuplexCmd() function. + + + -@- The RX pin is no longer used + -@- In Half-duplex mode the following bits must be kept cleared: + (+@) LINEN and CLKEN bits in the USART_CR2 register. + (+@) SCEN and IREN bits in the USART_CR3 register. + +@endverbatim + * @{ + */ + +/** + * @brief Enables or disables the USART's Half Duplex communication. + * @param USARTx: where x can be 1, 2, 3, 4, 5, 6, 7 or 8 to select the USART or + * UART peripheral. + * @param NewState: new state of the USART Communication. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void USART_HalfDuplexCmd(USART_TypeDef* USARTx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_USART_ALL_PERIPH(USARTx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the Half-Duplex mode by setting the HDSEL bit in the CR3 register */ + USARTx->CR3 |= USART_CR3_HDSEL; + } + else + { + /* Disable the Half-Duplex mode by clearing the HDSEL bit in the CR3 register */ + USARTx->CR3 &= (uint16_t)~((uint16_t)USART_CR3_HDSEL); + } +} + +/** + * @} + */ + + +/** @defgroup USART_Group6 Smartcard mode functions + * @brief Smartcard mode functions + * +@verbatim + =============================================================================== + ##### Smartcard mode functions ##### + =============================================================================== + [..] + This subsection provides a set of functions allowing to manage the USART + Smartcard communication. + [..] + The Smartcard interface is designed to support asynchronous protocol Smartcards as + defined in the ISO 7816-3 standard. + [..] + The USART can provide a clock to the smartcard through the SCLK output. + In smartcard mode, SCLK is not associated to the communication but is simply derived + from the internal peripheral input clock through a 5-bit prescaler. + [..] + Smartcard communication is possible through the following procedure: + (#) Configures the Smartcard Prescaler using the USART_SetPrescaler() function. + (#) Configures the Smartcard Guard Time using the USART_SetGuardTime() function. + (#) Program the USART clock using the USART_ClockInit() function as following: + (++) USART Clock enabled + (++) USART CPOL Low + (++) USART CPHA on first edge + (++) USART Last Bit Clock Enabled + (#) Program the Smartcard interface using the USART_Init() function as following: + (++) Word Length = 9 Bits + (++) 1.5 Stop Bit + (++) Even parity + (++) BaudRate = 12096 baud + (++) Hardware flow control disabled (RTS and CTS signals) + (++) Tx and Rx enabled + (#) POptionally you can enable the parity error interrupt using the USART_ITConfig() + function + (#) PEnable the USART using the USART_Cmd() function. + (#) PEnable the Smartcard NACK using the USART_SmartCardNACKCmd() function. + (#) PEnable the Smartcard interface using the USART_SmartCardCmd() function. + + Please refer to the ISO 7816-3 specification for more details. + + -@- It is also possible to choose 0.5 stop bit for receiving but it is recommended + to use 1.5 stop bits for both transmitting and receiving to avoid switching + between the two configurations. + -@- In smartcard mode, the following bits must be kept cleared: + (+@) LINEN bit in the USART_CR2 register. + (+@) HDSEL and IREN bits in the USART_CR3 register. + -@- Smartcard mode is available on USART peripherals only (not available on UART4 + and UART5 peripherals). + +@endverbatim + * @{ + */ + +/** + * @brief Sets the specified USART guard time. + * @param USARTx: where x can be 1, 2, 3 or 6 to select the USART or + * UART peripheral. + * @param USART_GuardTime: specifies the guard time. + * @retval None + */ +void USART_SetGuardTime(USART_TypeDef* USARTx, uint8_t USART_GuardTime) +{ + /* Check the parameters */ + assert_param(IS_USART_1236_PERIPH(USARTx)); + + /* Clear the USART Guard time */ + USARTx->GTPR &= USART_GTPR_PSC; + /* Set the USART guard time */ + USARTx->GTPR |= (uint16_t)((uint16_t)USART_GuardTime << 0x08); +} + +/** + * @brief Enables or disables the USART's Smart Card mode. + * @param USARTx: where x can be 1, 2, 3 or 6 to select the USART or + * UART peripheral. + * @param NewState: new state of the Smart Card mode. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void USART_SmartCardCmd(USART_TypeDef* USARTx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_USART_1236_PERIPH(USARTx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + if (NewState != DISABLE) + { + /* Enable the SC mode by setting the SCEN bit in the CR3 register */ + USARTx->CR3 |= USART_CR3_SCEN; + } + else + { + /* Disable the SC mode by clearing the SCEN bit in the CR3 register */ + USARTx->CR3 &= (uint16_t)~((uint16_t)USART_CR3_SCEN); + } +} + +/** + * @brief Enables or disables NACK transmission. + * @param USARTx: where x can be 1, 2, 3 or 6 to select the USART or + * UART peripheral. + * @param NewState: new state of the NACK transmission. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void USART_SmartCardNACKCmd(USART_TypeDef* USARTx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_USART_1236_PERIPH(USARTx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + if (NewState != DISABLE) + { + /* Enable the NACK transmission by setting the NACK bit in the CR3 register */ + USARTx->CR3 |= USART_CR3_NACK; + } + else + { + /* Disable the NACK transmission by clearing the NACK bit in the CR3 register */ + USARTx->CR3 &= (uint16_t)~((uint16_t)USART_CR3_NACK); + } +} + +/** + * @} + */ + +/** @defgroup USART_Group7 IrDA mode functions + * @brief IrDA mode functions + * +@verbatim + =============================================================================== + ##### IrDA mode functions ##### + =============================================================================== + [..] + This subsection provides a set of functions allowing to manage the USART + IrDA communication. + [..] + IrDA is a half duplex communication protocol. If the Transmitter is busy, any data + on the IrDA receive line will be ignored by the IrDA decoder and if the Receiver + is busy, data on the TX from the USART to IrDA will not be encoded by IrDA. + While receiving data, transmission should be avoided as the data to be transmitted + could be corrupted. + [..] + IrDA communication is possible through the following procedure: + (#) Program the Baud rate, Word length = 8 bits, Stop bits, Parity, Transmitter/Receiver + modes and hardware flow control values using the USART_Init() function. + (#) Enable the USART using the USART_Cmd() function. + (#) Configures the IrDA pulse width by configuring the prescaler using + the USART_SetPrescaler() function. + (#) Configures the IrDA USART_IrDAMode_LowPower or USART_IrDAMode_Normal mode + using the USART_IrDAConfig() function. + (#) Enable the IrDA using the USART_IrDACmd() function. + + -@- A pulse of width less than two and greater than one PSC period(s) may or may + not be rejected. + -@- The receiver set up time should be managed by software. The IrDA physical layer + specification specifies a minimum of 10 ms delay between transmission and + reception (IrDA is a half duplex protocol). + -@- In IrDA mode, the following bits must be kept cleared: + (+@) LINEN, STOP and CLKEN bits in the USART_CR2 register. + (+@) SCEN and HDSEL bits in the USART_CR3 register. + +@endverbatim + * @{ + */ + +/** + * @brief Configures the USART's IrDA interface. + * @param USARTx: where x can be 1, 2, 3, 4, 5, 6, 7 or 8 to select the USART or + * UART peripheral. + * @param USART_IrDAMode: specifies the IrDA mode. + * This parameter can be one of the following values: + * @arg USART_IrDAMode_LowPower + * @arg USART_IrDAMode_Normal + * @retval None + */ +void USART_IrDAConfig(USART_TypeDef* USARTx, uint16_t USART_IrDAMode) +{ + /* Check the parameters */ + assert_param(IS_USART_ALL_PERIPH(USARTx)); + assert_param(IS_USART_IRDA_MODE(USART_IrDAMode)); + + USARTx->CR3 &= (uint16_t)~((uint16_t)USART_CR3_IRLP); + USARTx->CR3 |= USART_IrDAMode; +} + +/** + * @brief Enables or disables the USART's IrDA interface. + * @param USARTx: where x can be 1, 2, 3, 4, 5, 6, 7 or 8 to select the USART or + * UART peripheral. + * @param NewState: new state of the IrDA mode. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void USART_IrDACmd(USART_TypeDef* USARTx, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_USART_ALL_PERIPH(USARTx)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the IrDA mode by setting the IREN bit in the CR3 register */ + USARTx->CR3 |= USART_CR3_IREN; + } + else + { + /* Disable the IrDA mode by clearing the IREN bit in the CR3 register */ + USARTx->CR3 &= (uint16_t)~((uint16_t)USART_CR3_IREN); + } +} + +/** + * @} + */ + +/** @defgroup USART_Group8 DMA transfers management functions + * @brief DMA transfers management functions + * +@verbatim + =============================================================================== + ##### DMA transfers management functions ##### + =============================================================================== + +@endverbatim + * @{ + */ + +/** + * @brief Enables or disables the USART's DMA interface. + * @param USARTx: where x can be 1, 2, 3, 4, 5, 6, 7 or 8 to select the USART or + * UART peripheral. + * @param USART_DMAReq: specifies the DMA request. + * This parameter can be any combination of the following values: + * @arg USART_DMAReq_Tx: USART DMA transmit request + * @arg USART_DMAReq_Rx: USART DMA receive request + * @param NewState: new state of the DMA Request sources. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void USART_DMACmd(USART_TypeDef* USARTx, uint16_t USART_DMAReq, FunctionalState NewState) +{ + /* Check the parameters */ + assert_param(IS_USART_ALL_PERIPH(USARTx)); + assert_param(IS_USART_DMAREQ(USART_DMAReq)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + if (NewState != DISABLE) + { + /* Enable the DMA transfer for selected requests by setting the DMAT and/or + DMAR bits in the USART CR3 register */ + USARTx->CR3 |= USART_DMAReq; + } + else + { + /* Disable the DMA transfer for selected requests by clearing the DMAT and/or + DMAR bits in the USART CR3 register */ + USARTx->CR3 &= (uint16_t)~USART_DMAReq; + } +} + +/** + * @} + */ + +/** @defgroup USART_Group9 Interrupts and flags management functions + * @brief Interrupts and flags management functions + * +@verbatim + =============================================================================== + ##### Interrupts and flags management functions ##### + =============================================================================== + [..] + This subsection provides a set of functions allowing to configure the USART + Interrupts sources, DMA channels requests and check or clear the flags or + pending bits status. + The user should identify which mode will be used in his application to manage + the communication: Polling mode, Interrupt mode or DMA mode. + + *** Polling Mode *** + ==================== + [..] + In Polling Mode, the SPI communication can be managed by 10 flags: + (#) USART_FLAG_TXE : to indicate the status of the transmit buffer register + (#) USART_FLAG_RXNE : to indicate the status of the receive buffer register + (#) USART_FLAG_TC : to indicate the status of the transmit operation + (#) USART_FLAG_IDLE : to indicate the status of the Idle Line + (#) USART_FLAG_CTS : to indicate the status of the nCTS input + (#) USART_FLAG_LBD : to indicate the status of the LIN break detection + (#) USART_FLAG_NE : to indicate if a noise error occur + (#) USART_FLAG_FE : to indicate if a frame error occur + (#) USART_FLAG_PE : to indicate if a parity error occur + (#) USART_FLAG_ORE : to indicate if an Overrun error occur + [..] + In this Mode it is advised to use the following functions: + (+) FlagStatus USART_GetFlagStatus(USART_TypeDef* USARTx, uint16_t USART_FLAG); + (+) void USART_ClearFlag(USART_TypeDef* USARTx, uint16_t USART_FLAG); + + *** Interrupt Mode *** + ====================== + [..] + In Interrupt Mode, the USART communication can be managed by 8 interrupt sources + and 10 pending bits: + + (#) Pending Bits: + + (##) USART_IT_TXE : to indicate the status of the transmit buffer register + (##) USART_IT_RXNE : to indicate the status of the receive buffer register + (##) USART_IT_TC : to indicate the status of the transmit operation + (##) USART_IT_IDLE : to indicate the status of the Idle Line + (##) USART_IT_CTS : to indicate the status of the nCTS input + (##) USART_IT_LBD : to indicate the status of the LIN break detection + (##) USART_IT_NE : to indicate if a noise error occur + (##) USART_IT_FE : to indicate if a frame error occur + (##) USART_IT_PE : to indicate if a parity error occur + (##) USART_IT_ORE : to indicate if an Overrun error occur + + (#) Interrupt Source: + + (##) USART_IT_TXE : specifies the interrupt source for the Tx buffer empty + interrupt. + (##) USART_IT_RXNE : specifies the interrupt source for the Rx buffer not + empty interrupt. + (##) USART_IT_TC : specifies the interrupt source for the Transmit complete + interrupt. + (##) USART_IT_IDLE : specifies the interrupt source for the Idle Line interrupt. + (##) USART_IT_CTS : specifies the interrupt source for the CTS interrupt. + (##) USART_IT_LBD : specifies the interrupt source for the LIN break detection + interrupt. + (##) USART_IT_PE : specifies the interrupt source for the parity error interrupt. + (##) USART_IT_ERR : specifies the interrupt source for the errors interrupt. + + -@@- Some parameters are coded in order to use them as interrupt source + or as pending bits. + [..] + In this Mode it is advised to use the following functions: + (+) void USART_ITConfig(USART_TypeDef* USARTx, uint16_t USART_IT, FunctionalState NewState); + (+) ITStatus USART_GetITStatus(USART_TypeDef* USARTx, uint16_t USART_IT); + (+) void USART_ClearITPendingBit(USART_TypeDef* USARTx, uint16_t USART_IT); + + *** DMA Mode *** + ================ + [..] + In DMA Mode, the USART communication can be managed by 2 DMA Channel requests: + (#) USART_DMAReq_Tx: specifies the Tx buffer DMA transfer request + (#) USART_DMAReq_Rx: specifies the Rx buffer DMA transfer request + [..] + In this Mode it is advised to use the following function: + (+) void USART_DMACmd(USART_TypeDef* USARTx, uint16_t USART_DMAReq, FunctionalState NewState); + +@endverbatim + * @{ + */ + +/** + * @brief Enables or disables the specified USART interrupts. + * @param USARTx: where x can be 1, 2, 3, 4, 5, 6, 7 or 8 to select the USART or + * UART peripheral. + * @param USART_IT: specifies the USART interrupt sources to be enabled or disabled. + * This parameter can be one of the following values: + * @arg USART_IT_CTS: CTS change interrupt + * @arg USART_IT_LBD: LIN Break detection interrupt + * @arg USART_IT_TXE: Transmit Data Register empty interrupt + * @arg USART_IT_TC: Transmission complete interrupt + * @arg USART_IT_RXNE: Receive Data register not empty interrupt + * @arg USART_IT_IDLE: Idle line detection interrupt + * @arg USART_IT_PE: Parity Error interrupt + * @arg USART_IT_ERR: Error interrupt(Frame error, noise error, overrun error) + * @param NewState: new state of the specified USARTx interrupts. + * This parameter can be: ENABLE or DISABLE. + * @retval None + */ +void USART_ITConfig(USART_TypeDef* USARTx, uint16_t USART_IT, FunctionalState NewState) +{ + uint32_t usartreg = 0x00, itpos = 0x00, itmask = 0x00; + uint32_t usartxbase = 0x00; + /* Check the parameters */ + assert_param(IS_USART_ALL_PERIPH(USARTx)); + assert_param(IS_USART_CONFIG_IT(USART_IT)); + assert_param(IS_FUNCTIONAL_STATE(NewState)); + + /* The CTS interrupt is not available for UART4 and UART5 */ + if (USART_IT == USART_IT_CTS) + { + assert_param(IS_USART_1236_PERIPH(USARTx)); + } + + usartxbase = (uint32_t)USARTx; + + /* Get the USART register index */ + usartreg = (((uint8_t)USART_IT) >> 0x05); + + /* Get the interrupt position */ + itpos = USART_IT & IT_MASK; + itmask = (((uint32_t)0x01) << itpos); + + if (usartreg == 0x01) /* The IT is in CR1 register */ + { + usartxbase += 0x0C; + } + else if (usartreg == 0x02) /* The IT is in CR2 register */ + { + usartxbase += 0x10; + } + else /* The IT is in CR3 register */ + { + usartxbase += 0x14; + } + if (NewState != DISABLE) + { + *(__IO uint32_t*)usartxbase |= itmask; + } + else + { + *(__IO uint32_t*)usartxbase &= ~itmask; + } +} + +/** + * @brief Checks whether the specified USART flag is set or not. + * @param USARTx: where x can be 1, 2, 3, 4, 5, 6, 7 or 8 to select the USART or + * UART peripheral. + * @param USART_FLAG: specifies the flag to check. + * This parameter can be one of the following values: + * @arg USART_FLAG_CTS: CTS Change flag (not available for UART4 and UART5) + * @arg USART_FLAG_LBD: LIN Break detection flag + * @arg USART_FLAG_TXE: Transmit data register empty flag + * @arg USART_FLAG_TC: Transmission Complete flag + * @arg USART_FLAG_RXNE: Receive data register not empty flag + * @arg USART_FLAG_IDLE: Idle Line detection flag + * @arg USART_FLAG_ORE: OverRun Error flag + * @arg USART_FLAG_NE: Noise Error flag + * @arg USART_FLAG_FE: Framing Error flag + * @arg USART_FLAG_PE: Parity Error flag + * @retval The new state of USART_FLAG (SET or RESET). + */ +FlagStatus USART_GetFlagStatus(USART_TypeDef* USARTx, uint16_t USART_FLAG) +{ + FlagStatus bitstatus = RESET; + /* Check the parameters */ + assert_param(IS_USART_ALL_PERIPH(USARTx)); + assert_param(IS_USART_FLAG(USART_FLAG)); + + /* The CTS flag is not available for UART4 and UART5 */ + if (USART_FLAG == USART_FLAG_CTS) + { + assert_param(IS_USART_1236_PERIPH(USARTx)); + } + + if ((USARTx->SR & USART_FLAG) != (uint16_t)RESET) + { + bitstatus = SET; + } + else + { + bitstatus = RESET; + } + return bitstatus; +} + +/** + * @brief Clears the USARTx's pending flags. + * @param USARTx: where x can be 1, 2, 3, 4, 5, 6, 7 or 8 to select the USART or + * UART peripheral. + * @param USART_FLAG: specifies the flag to clear. + * This parameter can be any combination of the following values: + * @arg USART_FLAG_CTS: CTS Change flag (not available for UART4 and UART5). + * @arg USART_FLAG_LBD: LIN Break detection flag. + * @arg USART_FLAG_TC: Transmission Complete flag. + * @arg USART_FLAG_RXNE: Receive data register not empty flag. + * + * @note PE (Parity error), FE (Framing error), NE (Noise error), ORE (OverRun + * error) and IDLE (Idle line detected) flags are cleared by software + * sequence: a read operation to USART_SR register (USART_GetFlagStatus()) + * followed by a read operation to USART_DR register (USART_ReceiveData()). + * @note RXNE flag can be also cleared by a read to the USART_DR register + * (USART_ReceiveData()). + * @note TC flag can be also cleared by software sequence: a read operation to + * USART_SR register (USART_GetFlagStatus()) followed by a write operation + * to USART_DR register (USART_SendData()). + * @note TXE flag is cleared only by a write to the USART_DR register + * (USART_SendData()). + * + * @retval None + */ +void USART_ClearFlag(USART_TypeDef* USARTx, uint16_t USART_FLAG) +{ + /* Check the parameters */ + assert_param(IS_USART_ALL_PERIPH(USARTx)); + assert_param(IS_USART_CLEAR_FLAG(USART_FLAG)); + + /* The CTS flag is not available for UART4 and UART5 */ + if ((USART_FLAG & USART_FLAG_CTS) == USART_FLAG_CTS) + { + assert_param(IS_USART_1236_PERIPH(USARTx)); + } + + USARTx->SR = (uint16_t)~USART_FLAG; +} + +/** + * @brief Checks whether the specified USART interrupt has occurred or not. + * @param USARTx: where x can be 1, 2, 3, 4, 5, 6, 7 or 8 to select the USART or + * UART peripheral. + * @param USART_IT: specifies the USART interrupt source to check. + * This parameter can be one of the following values: + * @arg USART_IT_CTS: CTS change interrupt (not available for UART4 and UART5) + * @arg USART_IT_LBD: LIN Break detection interrupt + * @arg USART_IT_TXE: Transmit Data Register empty interrupt + * @arg USART_IT_TC: Transmission complete interrupt + * @arg USART_IT_RXNE: Receive Data register not empty interrupt + * @arg USART_IT_IDLE: Idle line detection interrupt + * @arg USART_IT_ORE_RX : OverRun Error interrupt if the RXNEIE bit is set + * @arg USART_IT_ORE_ER : OverRun Error interrupt if the EIE bit is set + * @arg USART_IT_NE: Noise Error interrupt + * @arg USART_IT_FE: Framing Error interrupt + * @arg USART_IT_PE: Parity Error interrupt + * @retval The new state of USART_IT (SET or RESET). + */ +ITStatus USART_GetITStatus(USART_TypeDef* USARTx, uint16_t USART_IT) +{ + uint32_t bitpos = 0x00, itmask = 0x00, usartreg = 0x00; + ITStatus bitstatus = RESET; + /* Check the parameters */ + assert_param(IS_USART_ALL_PERIPH(USARTx)); + assert_param(IS_USART_GET_IT(USART_IT)); + + /* The CTS interrupt is not available for UART4 and UART5 */ + if (USART_IT == USART_IT_CTS) + { + assert_param(IS_USART_1236_PERIPH(USARTx)); + } + + /* Get the USART register index */ + usartreg = (((uint8_t)USART_IT) >> 0x05); + /* Get the interrupt position */ + itmask = USART_IT & IT_MASK; + itmask = (uint32_t)0x01 << itmask; + + if (usartreg == 0x01) /* The IT is in CR1 register */ + { + itmask &= USARTx->CR1; + } + else if (usartreg == 0x02) /* The IT is in CR2 register */ + { + itmask &= USARTx->CR2; + } + else /* The IT is in CR3 register */ + { + itmask &= USARTx->CR3; + } + + bitpos = USART_IT >> 0x08; + bitpos = (uint32_t)0x01 << bitpos; + bitpos &= USARTx->SR; + if ((itmask != (uint16_t)RESET)&&(bitpos != (uint16_t)RESET)) + { + bitstatus = SET; + } + else + { + bitstatus = RESET; + } + + return bitstatus; +} + +/** + * @brief Clears the USARTx's interrupt pending bits. + * @param USARTx: where x can be 1, 2, 3, 4, 5, 6, 7 or 8 to select the USART or + * UART peripheral. + * @param USART_IT: specifies the interrupt pending bit to clear. + * This parameter can be one of the following values: + * @arg USART_IT_CTS: CTS change interrupt (not available for UART4 and UART5) + * @arg USART_IT_LBD: LIN Break detection interrupt + * @arg USART_IT_TC: Transmission complete interrupt. + * @arg USART_IT_RXNE: Receive Data register not empty interrupt. + * + * @note PE (Parity error), FE (Framing error), NE (Noise error), ORE (OverRun + * error) and IDLE (Idle line detected) pending bits are cleared by + * software sequence: a read operation to USART_SR register + * (USART_GetITStatus()) followed by a read operation to USART_DR register + * (USART_ReceiveData()). + * @note RXNE pending bit can be also cleared by a read to the USART_DR register + * (USART_ReceiveData()). + * @note TC pending bit can be also cleared by software sequence: a read + * operation to USART_SR register (USART_GetITStatus()) followed by a write + * operation to USART_DR register (USART_SendData()). + * @note TXE pending bit is cleared only by a write to the USART_DR register + * (USART_SendData()). + * + * @retval None + */ +void USART_ClearITPendingBit(USART_TypeDef* USARTx, uint16_t USART_IT) +{ + uint16_t bitpos = 0x00, itmask = 0x00; + /* Check the parameters */ + assert_param(IS_USART_ALL_PERIPH(USARTx)); + assert_param(IS_USART_CLEAR_IT(USART_IT)); + + /* The CTS interrupt is not available for UART4 and UART5 */ + if (USART_IT == USART_IT_CTS) + { + assert_param(IS_USART_1236_PERIPH(USARTx)); + } + + bitpos = USART_IT >> 0x08; + itmask = ((uint16_t)0x01 << (uint16_t)bitpos); + USARTx->SR = (uint16_t)~itmask; +} + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FWLIB/src/stm32f4xx_wwdg.c b/FWLIB/src/stm32f4xx_wwdg.c new file mode 100644 index 0000000..5ddbee8 --- /dev/null +++ b/FWLIB/src/stm32f4xx_wwdg.c @@ -0,0 +1,307 @@ +/** + ****************************************************************************** + * @file stm32f4xx_wwdg.c + * @author MCD Application Team + * @version V1.4.0 + * @date 04-August-2014 + * @brief This file provides firmware functions to manage the following + * functionalities of the Window watchdog (WWDG) peripheral: + * + Prescaler, Refresh window and Counter configuration + * + WWDG activation + * + Interrupts and flags management + * + @verbatim + =============================================================================== + ##### WWDG features ##### + =============================================================================== + [..] + Once enabled the WWDG generates a system reset on expiry of a programmed + time period, unless the program refreshes the counter (downcounter) + before to reach 0x3F value (i.e. a reset is generated when the counter + value rolls over from 0x40 to 0x3F). + An MCU reset is also generated if the counter value is refreshed + before the counter has reached the refresh window value. This + implies that the counter must be refreshed in a limited window. + + Once enabled the WWDG cannot be disabled except by a system reset. + + WWDGRST flag in RCC_CSR register can be used to inform when a WWDG + reset occurs. + + The WWDG counter input clock is derived from the APB clock divided + by a programmable prescaler. + + WWDG counter clock = PCLK1 / Prescaler + WWDG timeout = (WWDG counter clock) * (counter value) + + Min-max timeout value @42 MHz(PCLK1): ~97.5 us / ~49.9 ms + + ##### How to use this driver ##### + =============================================================================== + [..] + (#) Enable WWDG clock using RCC_APB1PeriphClockCmd(RCC_APB1Periph_WWDG, ENABLE) function + + (#) Configure the WWDG prescaler using WWDG_SetPrescaler() function + + (#) Configure the WWDG refresh window using WWDG_SetWindowValue() function + + (#) Set the WWDG counter value and start it using WWDG_Enable() function. + When the WWDG is enabled the counter value should be configured to + a value greater than 0x40 to prevent generating an immediate reset. + + (#) Optionally you can enable the Early wakeup interrupt which is + generated when the counter reach 0x40. + Once enabled this interrupt cannot be disabled except by a system reset. + + (#) Then the application program must refresh the WWDG counter at regular + intervals during normal operation to prevent an MCU reset, using + WWDG_SetCounter() function. This operation must occur only when + the counter value is lower than the refresh window value, + programmed using WWDG_SetWindowValue(). + + @endverbatim + ****************************************************************************** + * @attention + * + *

© COPYRIGHT 2014 STMicroelectronics

+ * + * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); + * You may not use this file except in compliance with the License. + * You may obtain a copy of the License at: + * + * http://www.st.com/software_license_agreement_liberty_v2 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + ****************************************************************************** + */ + +/* Includes ------------------------------------------------------------------*/ +#include "stm32f4xx_wwdg.h" +#include "stm32f4xx_rcc.h" + +/** @addtogroup STM32F4xx_StdPeriph_Driver + * @{ + */ + +/** @defgroup WWDG + * @brief WWDG driver modules + * @{ + */ + +/* Private typedef -----------------------------------------------------------*/ +/* Private define ------------------------------------------------------------*/ + +/* ----------- WWDG registers bit address in the alias region ----------- */ +#define WWDG_OFFSET (WWDG_BASE - PERIPH_BASE) +/* Alias word address of EWI bit */ +#define CFR_OFFSET (WWDG_OFFSET + 0x04) +#define EWI_BitNumber 0x09 +#define CFR_EWI_BB (PERIPH_BB_BASE + (CFR_OFFSET * 32) + (EWI_BitNumber * 4)) + +/* --------------------- WWDG registers bit mask ------------------------ */ +/* CFR register bit mask */ +#define CFR_WDGTB_MASK ((uint32_t)0xFFFFFE7F) +#define CFR_W_MASK ((uint32_t)0xFFFFFF80) +#define BIT_MASK ((uint8_t)0x7F) + +/* Private macro -------------------------------------------------------------*/ +/* Private variables ---------------------------------------------------------*/ +/* Private function prototypes -----------------------------------------------*/ +/* Private functions ---------------------------------------------------------*/ + +/** @defgroup WWDG_Private_Functions + * @{ + */ + +/** @defgroup WWDG_Group1 Prescaler, Refresh window and Counter configuration functions + * @brief Prescaler, Refresh window and Counter configuration functions + * +@verbatim + =============================================================================== + ##### Prescaler, Refresh window and Counter configuration functions ##### + =============================================================================== + +@endverbatim + * @{ + */ + +/** + * @brief Deinitializes the WWDG peripheral registers to their default reset values. + * @param None + * @retval None + */ +void WWDG_DeInit(void) +{ + RCC_APB1PeriphResetCmd(RCC_APB1Periph_WWDG, ENABLE); + RCC_APB1PeriphResetCmd(RCC_APB1Periph_WWDG, DISABLE); +} + +/** + * @brief Sets the WWDG Prescaler. + * @param WWDG_Prescaler: specifies the WWDG Prescaler. + * This parameter can be one of the following values: + * @arg WWDG_Prescaler_1: WWDG counter clock = (PCLK1/4096)/1 + * @arg WWDG_Prescaler_2: WWDG counter clock = (PCLK1/4096)/2 + * @arg WWDG_Prescaler_4: WWDG counter clock = (PCLK1/4096)/4 + * @arg WWDG_Prescaler_8: WWDG counter clock = (PCLK1/4096)/8 + * @retval None + */ +void WWDG_SetPrescaler(uint32_t WWDG_Prescaler) +{ + uint32_t tmpreg = 0; + /* Check the parameters */ + assert_param(IS_WWDG_PRESCALER(WWDG_Prescaler)); + /* Clear WDGTB[1:0] bits */ + tmpreg = WWDG->CFR & CFR_WDGTB_MASK; + /* Set WDGTB[1:0] bits according to WWDG_Prescaler value */ + tmpreg |= WWDG_Prescaler; + /* Store the new value */ + WWDG->CFR = tmpreg; +} + +/** + * @brief Sets the WWDG window value. + * @param WindowValue: specifies the window value to be compared to the downcounter. + * This parameter value must be lower than 0x80. + * @retval None + */ +void WWDG_SetWindowValue(uint8_t WindowValue) +{ + __IO uint32_t tmpreg = 0; + + /* Check the parameters */ + assert_param(IS_WWDG_WINDOW_VALUE(WindowValue)); + /* Clear W[6:0] bits */ + + tmpreg = WWDG->CFR & CFR_W_MASK; + + /* Set W[6:0] bits according to WindowValue value */ + tmpreg |= WindowValue & (uint32_t) BIT_MASK; + + /* Store the new value */ + WWDG->CFR = tmpreg; +} + +/** + * @brief Enables the WWDG Early Wakeup interrupt(EWI). + * @note Once enabled this interrupt cannot be disabled except by a system reset. + * @param None + * @retval None + */ +void WWDG_EnableIT(void) +{ + *(__IO uint32_t *) CFR_EWI_BB = (uint32_t)ENABLE; +} + +/** + * @brief Sets the WWDG counter value. + * @param Counter: specifies the watchdog counter value. + * This parameter must be a number between 0x40 and 0x7F (to prevent generating + * an immediate reset) + * @retval None + */ +void WWDG_SetCounter(uint8_t Counter) +{ + /* Check the parameters */ + assert_param(IS_WWDG_COUNTER(Counter)); + /* Write to T[6:0] bits to configure the counter value, no need to do + a read-modify-write; writing a 0 to WDGA bit does nothing */ + WWDG->CR = Counter & BIT_MASK; +} +/** + * @} + */ + +/** @defgroup WWDG_Group2 WWDG activation functions + * @brief WWDG activation functions + * +@verbatim + =============================================================================== + ##### WWDG activation function ##### + =============================================================================== + +@endverbatim + * @{ + */ + +/** + * @brief Enables WWDG and load the counter value. + * @param Counter: specifies the watchdog counter value. + * This parameter must be a number between 0x40 and 0x7F (to prevent generating + * an immediate reset) + * @retval None + */ +void WWDG_Enable(uint8_t Counter) +{ + /* Check the parameters */ + assert_param(IS_WWDG_COUNTER(Counter)); + WWDG->CR = WWDG_CR_WDGA | Counter; +} +/** + * @} + */ + +/** @defgroup WWDG_Group3 Interrupts and flags management functions + * @brief Interrupts and flags management functions + * +@verbatim + =============================================================================== + ##### Interrupts and flags management functions ##### + =============================================================================== + +@endverbatim + * @{ + */ + +/** + * @brief Checks whether the Early Wakeup interrupt flag is set or not. + * @param None + * @retval The new state of the Early Wakeup interrupt flag (SET or RESET) + */ +FlagStatus WWDG_GetFlagStatus(void) +{ + FlagStatus bitstatus = RESET; + + if ((WWDG->SR) != (uint32_t)RESET) + { + bitstatus = SET; + } + else + { + bitstatus = RESET; + } + return bitstatus; +} + +/** + * @brief Clears Early Wakeup interrupt flag. + * @param None + * @retval None + */ +void WWDG_ClearFlag(void) +{ + WWDG->SR = (uint32_t)RESET; +} + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/** + * @} + */ + +/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ diff --git a/FreeRTOS/croutine.c b/FreeRTOS/croutine.c new file mode 100644 index 0000000..993e09b --- /dev/null +++ b/FreeRTOS/croutine.c @@ -0,0 +1,395 @@ +/* + FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd. + All rights reserved + + VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION. + + This file is part of the FreeRTOS distribution. + + FreeRTOS is free software; you can redistribute it and/or modify it under + the terms of the GNU General Public License (version 2) as published by the + Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception. + + *************************************************************************** + >>! NOTE: The modification to the GPL is included to allow you to !<< + >>! distribute a combined work that includes FreeRTOS without being !<< + >>! obliged to provide the source code for proprietary components !<< + >>! outside of the FreeRTOS kernel. !<< + *************************************************************************** + + FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY + WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS + FOR A PARTICULAR PURPOSE. Full license text is available on the following + link: http://www.freertos.org/a00114.html + + *************************************************************************** + * * + * FreeRTOS provides completely free yet professionally developed, * + * robust, strictly quality controlled, supported, and cross * + * platform software that is more than just the market leader, it * + * is the industry's de facto standard. * + * * + * Help yourself get started quickly while simultaneously helping * + * to support the FreeRTOS project by purchasing a FreeRTOS * + * tutorial book, reference manual, or both: * + * http://www.FreeRTOS.org/Documentation * + * * + *************************************************************************** + + http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading + the FAQ page "My application does not run, what could be wrong?". Have you + defined configASSERT()? + + http://www.FreeRTOS.org/support - In return for receiving this top quality + embedded software for free we request you assist our global community by + participating in the support forum. + + http://www.FreeRTOS.org/training - Investing in training allows your team to + be as productive as possible as early as possible. Now you can receive + FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers + Ltd, and the world's leading authority on the world's leading RTOS. + + http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products, + including FreeRTOS+Trace - an indispensable productivity tool, a DOS + compatible FAT file system, and our tiny thread aware UDP/IP stack. + + http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate. + Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS. + + http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High + Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS + licenses offer ticketed support, indemnification and commercial middleware. + + http://www.SafeRTOS.com - High Integrity Systems also provide a safety + engineered and independently SIL3 certified version for use in safety and + mission critical applications that require provable dependability. + + 1 tab == 4 spaces! +*/ + +#include "FreeRTOS.h" +#include "task.h" +#include "croutine.h" + +/* Remove the whole file is co-routines are not being used. */ +#if( configUSE_CO_ROUTINES != 0 ) + +/* + * Some kernel aware debuggers require data to be viewed to be global, rather + * than file scope. + */ +#ifdef portREMOVE_STATIC_QUALIFIER + #define static +#endif + + +/* Lists for ready and blocked co-routines. --------------------*/ +static List_t pxReadyCoRoutineLists[ configMAX_CO_ROUTINE_PRIORITIES ]; /*< Prioritised ready co-routines. */ +static List_t xDelayedCoRoutineList1; /*< Delayed co-routines. */ +static List_t xDelayedCoRoutineList2; /*< Delayed co-routines (two lists are used - one for delays that have overflowed the current tick count. */ +static List_t * pxDelayedCoRoutineList; /*< Points to the delayed co-routine list currently being used. */ +static List_t * pxOverflowDelayedCoRoutineList; /*< Points to the delayed co-routine list currently being used to hold co-routines that have overflowed the current tick count. */ +static List_t xPendingReadyCoRoutineList; /*< Holds co-routines that have been readied by an external event. They cannot be added directly to the ready lists as the ready lists cannot be accessed by interrupts. */ + +/* Other file private variables. --------------------------------*/ +CRCB_t * pxCurrentCoRoutine = NULL; +static UBaseType_t uxTopCoRoutineReadyPriority = 0; +static TickType_t xCoRoutineTickCount = 0, xLastTickCount = 0, xPassedTicks = 0; + +/* The initial state of the co-routine when it is created. */ +#define corINITIAL_STATE ( 0 ) + +/* + * Place the co-routine represented by pxCRCB into the appropriate ready queue + * for the priority. It is inserted at the end of the list. + * + * This macro accesses the co-routine ready lists and therefore must not be + * used from within an ISR. + */ +#define prvAddCoRoutineToReadyQueue( pxCRCB ) \ +{ \ + if( pxCRCB->uxPriority > uxTopCoRoutineReadyPriority ) \ + { \ + uxTopCoRoutineReadyPriority = pxCRCB->uxPriority; \ + } \ + vListInsertEnd( ( List_t * ) &( pxReadyCoRoutineLists[ pxCRCB->uxPriority ] ), &( pxCRCB->xGenericListItem ) ); \ +} + +/* + * Utility to ready all the lists used by the scheduler. This is called + * automatically upon the creation of the first co-routine. + */ +static void prvInitialiseCoRoutineLists( void ); + +/* + * Co-routines that are readied by an interrupt cannot be placed directly into + * the ready lists (there is no mutual exclusion). Instead they are placed in + * in the pending ready list in order that they can later be moved to the ready + * list by the co-routine scheduler. + */ +static void prvCheckPendingReadyList( void ); + +/* + * Macro that looks at the list of co-routines that are currently delayed to + * see if any require waking. + * + * Co-routines are stored in the queue in the order of their wake time - + * meaning once one co-routine has been found whose timer has not expired + * we need not look any further down the list. + */ +static void prvCheckDelayedList( void ); + +/*-----------------------------------------------------------*/ + +BaseType_t xCoRoutineCreate( crCOROUTINE_CODE pxCoRoutineCode, UBaseType_t uxPriority, UBaseType_t uxIndex ) +{ +BaseType_t xReturn; +CRCB_t *pxCoRoutine; + + /* Allocate the memory that will store the co-routine control block. */ + pxCoRoutine = ( CRCB_t * ) pvPortMalloc( sizeof( CRCB_t ) ); + if( pxCoRoutine ) + { + /* If pxCurrentCoRoutine is NULL then this is the first co-routine to + be created and the co-routine data structures need initialising. */ + if( pxCurrentCoRoutine == NULL ) + { + pxCurrentCoRoutine = pxCoRoutine; + prvInitialiseCoRoutineLists(); + } + + /* Check the priority is within limits. */ + if( uxPriority >= configMAX_CO_ROUTINE_PRIORITIES ) + { + uxPriority = configMAX_CO_ROUTINE_PRIORITIES - 1; + } + + /* Fill out the co-routine control block from the function parameters. */ + pxCoRoutine->uxState = corINITIAL_STATE; + pxCoRoutine->uxPriority = uxPriority; + pxCoRoutine->uxIndex = uxIndex; + pxCoRoutine->pxCoRoutineFunction = pxCoRoutineCode; + + /* Initialise all the other co-routine control block parameters. */ + vListInitialiseItem( &( pxCoRoutine->xGenericListItem ) ); + vListInitialiseItem( &( pxCoRoutine->xEventListItem ) ); + + /* Set the co-routine control block as a link back from the ListItem_t. + This is so we can get back to the containing CRCB from a generic item + in a list. */ + listSET_LIST_ITEM_OWNER( &( pxCoRoutine->xGenericListItem ), pxCoRoutine ); + listSET_LIST_ITEM_OWNER( &( pxCoRoutine->xEventListItem ), pxCoRoutine ); + + /* Event lists are always in priority order. */ + listSET_LIST_ITEM_VALUE( &( pxCoRoutine->xEventListItem ), ( ( TickType_t ) configMAX_CO_ROUTINE_PRIORITIES - ( TickType_t ) uxPriority ) ); + + /* Now the co-routine has been initialised it can be added to the ready + list at the correct priority. */ + prvAddCoRoutineToReadyQueue( pxCoRoutine ); + + xReturn = pdPASS; + } + else + { + xReturn = errCOULD_NOT_ALLOCATE_REQUIRED_MEMORY; + } + + return xReturn; +} +/*-----------------------------------------------------------*/ + +void vCoRoutineAddToDelayedList( TickType_t xTicksToDelay, List_t *pxEventList ) +{ +TickType_t xTimeToWake; + + /* Calculate the time to wake - this may overflow but this is + not a problem. */ + xTimeToWake = xCoRoutineTickCount + xTicksToDelay; + + /* We must remove ourselves from the ready list before adding + ourselves to the blocked list as the same list item is used for + both lists. */ + ( void ) uxListRemove( ( ListItem_t * ) &( pxCurrentCoRoutine->xGenericListItem ) ); + + /* The list item will be inserted in wake time order. */ + listSET_LIST_ITEM_VALUE( &( pxCurrentCoRoutine->xGenericListItem ), xTimeToWake ); + + if( xTimeToWake < xCoRoutineTickCount ) + { + /* Wake time has overflowed. Place this item in the + overflow list. */ + vListInsert( ( List_t * ) pxOverflowDelayedCoRoutineList, ( ListItem_t * ) &( pxCurrentCoRoutine->xGenericListItem ) ); + } + else + { + /* The wake time has not overflowed, so we can use the + current block list. */ + vListInsert( ( List_t * ) pxDelayedCoRoutineList, ( ListItem_t * ) &( pxCurrentCoRoutine->xGenericListItem ) ); + } + + if( pxEventList ) + { + /* Also add the co-routine to an event list. If this is done then the + function must be called with interrupts disabled. */ + vListInsert( pxEventList, &( pxCurrentCoRoutine->xEventListItem ) ); + } +} +/*-----------------------------------------------------------*/ + +static void prvCheckPendingReadyList( void ) +{ + /* Are there any co-routines waiting to get moved to the ready list? These + are co-routines that have been readied by an ISR. The ISR cannot access + the ready lists itself. */ + while( listLIST_IS_EMPTY( &xPendingReadyCoRoutineList ) == pdFALSE ) + { + CRCB_t *pxUnblockedCRCB; + + /* The pending ready list can be accessed by an ISR. */ + portDISABLE_INTERRUPTS(); + { + pxUnblockedCRCB = ( CRCB_t * ) listGET_OWNER_OF_HEAD_ENTRY( (&xPendingReadyCoRoutineList) ); + ( void ) uxListRemove( &( pxUnblockedCRCB->xEventListItem ) ); + } + portENABLE_INTERRUPTS(); + + ( void ) uxListRemove( &( pxUnblockedCRCB->xGenericListItem ) ); + prvAddCoRoutineToReadyQueue( pxUnblockedCRCB ); + } +} +/*-----------------------------------------------------------*/ + +static void prvCheckDelayedList( void ) +{ +CRCB_t *pxCRCB; + + xPassedTicks = xTaskGetTickCount() - xLastTickCount; + while( xPassedTicks ) + { + xCoRoutineTickCount++; + xPassedTicks--; + + /* If the tick count has overflowed we need to swap the ready lists. */ + if( xCoRoutineTickCount == 0 ) + { + List_t * pxTemp; + + /* Tick count has overflowed so we need to swap the delay lists. If there are + any items in pxDelayedCoRoutineList here then there is an error! */ + pxTemp = pxDelayedCoRoutineList; + pxDelayedCoRoutineList = pxOverflowDelayedCoRoutineList; + pxOverflowDelayedCoRoutineList = pxTemp; + } + + /* See if this tick has made a timeout expire. */ + while( listLIST_IS_EMPTY( pxDelayedCoRoutineList ) == pdFALSE ) + { + pxCRCB = ( CRCB_t * ) listGET_OWNER_OF_HEAD_ENTRY( pxDelayedCoRoutineList ); + + if( xCoRoutineTickCount < listGET_LIST_ITEM_VALUE( &( pxCRCB->xGenericListItem ) ) ) + { + /* Timeout not yet expired. */ + break; + } + + portDISABLE_INTERRUPTS(); + { + /* The event could have occurred just before this critical + section. If this is the case then the generic list item will + have been moved to the pending ready list and the following + line is still valid. Also the pvContainer parameter will have + been set to NULL so the following lines are also valid. */ + ( void ) uxListRemove( &( pxCRCB->xGenericListItem ) ); + + /* Is the co-routine waiting on an event also? */ + if( pxCRCB->xEventListItem.pvContainer ) + { + ( void ) uxListRemove( &( pxCRCB->xEventListItem ) ); + } + } + portENABLE_INTERRUPTS(); + + prvAddCoRoutineToReadyQueue( pxCRCB ); + } + } + + xLastTickCount = xCoRoutineTickCount; +} +/*-----------------------------------------------------------*/ + +void vCoRoutineSchedule( void ) +{ + /* See if any co-routines readied by events need moving to the ready lists. */ + prvCheckPendingReadyList(); + + /* See if any delayed co-routines have timed out. */ + prvCheckDelayedList(); + + /* Find the highest priority queue that contains ready co-routines. */ + while( listLIST_IS_EMPTY( &( pxReadyCoRoutineLists[ uxTopCoRoutineReadyPriority ] ) ) ) + { + if( uxTopCoRoutineReadyPriority == 0 ) + { + /* No more co-routines to check. */ + return; + } + --uxTopCoRoutineReadyPriority; + } + + /* listGET_OWNER_OF_NEXT_ENTRY walks through the list, so the co-routines + of the same priority get an equal share of the processor time. */ + listGET_OWNER_OF_NEXT_ENTRY( pxCurrentCoRoutine, &( pxReadyCoRoutineLists[ uxTopCoRoutineReadyPriority ] ) ); + + /* Call the co-routine. */ + ( pxCurrentCoRoutine->pxCoRoutineFunction )( pxCurrentCoRoutine, pxCurrentCoRoutine->uxIndex ); + + return; +} +/*-----------------------------------------------------------*/ + +static void prvInitialiseCoRoutineLists( void ) +{ +UBaseType_t uxPriority; + + for( uxPriority = 0; uxPriority < configMAX_CO_ROUTINE_PRIORITIES; uxPriority++ ) + { + vListInitialise( ( List_t * ) &( pxReadyCoRoutineLists[ uxPriority ] ) ); + } + + vListInitialise( ( List_t * ) &xDelayedCoRoutineList1 ); + vListInitialise( ( List_t * ) &xDelayedCoRoutineList2 ); + vListInitialise( ( List_t * ) &xPendingReadyCoRoutineList ); + + /* Start with pxDelayedCoRoutineList using list1 and the + pxOverflowDelayedCoRoutineList using list2. */ + pxDelayedCoRoutineList = &xDelayedCoRoutineList1; + pxOverflowDelayedCoRoutineList = &xDelayedCoRoutineList2; +} +/*-----------------------------------------------------------*/ + +BaseType_t xCoRoutineRemoveFromEventList( const List_t *pxEventList ) +{ +CRCB_t *pxUnblockedCRCB; +BaseType_t xReturn; + + /* This function is called from within an interrupt. It can only access + event lists and the pending ready list. This function assumes that a + check has already been made to ensure pxEventList is not empty. */ + pxUnblockedCRCB = ( CRCB_t * ) listGET_OWNER_OF_HEAD_ENTRY( pxEventList ); + ( void ) uxListRemove( &( pxUnblockedCRCB->xEventListItem ) ); + vListInsertEnd( ( List_t * ) &( xPendingReadyCoRoutineList ), &( pxUnblockedCRCB->xEventListItem ) ); + + if( pxUnblockedCRCB->uxPriority >= pxCurrentCoRoutine->uxPriority ) + { + xReturn = pdTRUE; + } + else + { + xReturn = pdFALSE; + } + + return xReturn; +} + +#endif /* configUSE_CO_ROUTINES == 0 */ + diff --git a/FreeRTOS/event_groups.c b/FreeRTOS/event_groups.c new file mode 100644 index 0000000..b8df5fd --- /dev/null +++ b/FreeRTOS/event_groups.c @@ -0,0 +1,752 @@ +/* + FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd. + All rights reserved + + VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION. + + This file is part of the FreeRTOS distribution. + + FreeRTOS is free software; you can redistribute it and/or modify it under + the terms of the GNU General Public License (version 2) as published by the + Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception. + + *************************************************************************** + >>! NOTE: The modification to the GPL is included to allow you to !<< + >>! distribute a combined work that includes FreeRTOS without being !<< + >>! obliged to provide the source code for proprietary components !<< + >>! outside of the FreeRTOS kernel. !<< + *************************************************************************** + + FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY + WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS + FOR A PARTICULAR PURPOSE. Full license text is available on the following + link: http://www.freertos.org/a00114.html + + *************************************************************************** + * * + * FreeRTOS provides completely free yet professionally developed, * + * robust, strictly quality controlled, supported, and cross * + * platform software that is more than just the market leader, it * + * is the industry's de facto standard. * + * * + * Help yourself get started quickly while simultaneously helping * + * to support the FreeRTOS project by purchasing a FreeRTOS * + * tutorial book, reference manual, or both: * + * http://www.FreeRTOS.org/Documentation * + * * + *************************************************************************** + + http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading + the FAQ page "My application does not run, what could be wrong?". Have you + defined configASSERT()? + + http://www.FreeRTOS.org/support - In return for receiving this top quality + embedded software for free we request you assist our global community by + participating in the support forum. + + http://www.FreeRTOS.org/training - Investing in training allows your team to + be as productive as possible as early as possible. Now you can receive + FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers + Ltd, and the world's leading authority on the world's leading RTOS. + + http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products, + including FreeRTOS+Trace - an indispensable productivity tool, a DOS + compatible FAT file system, and our tiny thread aware UDP/IP stack. + + http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate. + Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS. + + http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High + Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS + licenses offer ticketed support, indemnification and commercial middleware. + + http://www.SafeRTOS.com - High Integrity Systems also provide a safety + engineered and independently SIL3 certified version for use in safety and + mission critical applications that require provable dependability. + + 1 tab == 4 spaces! +*/ + +/* Standard includes. */ +#include + +/* Defining MPU_WRAPPERS_INCLUDED_FROM_API_FILE prevents task.h from redefining +all the API functions to use the MPU wrappers. That should only be done when +task.h is included from an application file. */ +#define MPU_WRAPPERS_INCLUDED_FROM_API_FILE + +/* FreeRTOS includes. */ +#include "FreeRTOS.h" +#include "task.h" +#include "timers.h" +#include "event_groups.h" + +/* Lint e961 and e750 are suppressed as a MISRA exception justified because the +MPU ports require MPU_WRAPPERS_INCLUDED_FROM_API_FILE to be defined for the +header files above, but not in this file, in order to generate the correct +privileged Vs unprivileged linkage and placement. */ +#undef MPU_WRAPPERS_INCLUDED_FROM_API_FILE /*lint !e961 !e750. */ + +/* The following bit fields convey control information in a task's event list +item value. It is important they don't clash with the +taskEVENT_LIST_ITEM_VALUE_IN_USE definition. */ +#if configUSE_16_BIT_TICKS == 1 + #define eventCLEAR_EVENTS_ON_EXIT_BIT 0x0100U + #define eventUNBLOCKED_DUE_TO_BIT_SET 0x0200U + #define eventWAIT_FOR_ALL_BITS 0x0400U + #define eventEVENT_BITS_CONTROL_BYTES 0xff00U +#else + #define eventCLEAR_EVENTS_ON_EXIT_BIT 0x01000000UL + #define eventUNBLOCKED_DUE_TO_BIT_SET 0x02000000UL + #define eventWAIT_FOR_ALL_BITS 0x04000000UL + #define eventEVENT_BITS_CONTROL_BYTES 0xff000000UL +#endif + +typedef struct xEventGroupDefinition +{ + EventBits_t uxEventBits; + List_t xTasksWaitingForBits; /*< List of tasks waiting for a bit to be set. */ + + #if( configUSE_TRACE_FACILITY == 1 ) + UBaseType_t uxEventGroupNumber; + #endif + + #if( ( configSUPPORT_STATIC_ALLOCATION == 1 ) && ( configSUPPORT_DYNAMIC_ALLOCATION == 1 ) ) + uint8_t ucStaticallyAllocated; /*< Set to pdTRUE if the event group is statically allocated to ensure no attempt is made to free the memory. */ + #endif +} EventGroup_t; + +/*-----------------------------------------------------------*/ + +/* + * Test the bits set in uxCurrentEventBits to see if the wait condition is met. + * The wait condition is defined by xWaitForAllBits. If xWaitForAllBits is + * pdTRUE then the wait condition is met if all the bits set in uxBitsToWaitFor + * are also set in uxCurrentEventBits. If xWaitForAllBits is pdFALSE then the + * wait condition is met if any of the bits set in uxBitsToWait for are also set + * in uxCurrentEventBits. + */ +static BaseType_t prvTestWaitCondition( const EventBits_t uxCurrentEventBits, const EventBits_t uxBitsToWaitFor, const BaseType_t xWaitForAllBits ) PRIVILEGED_FUNCTION; + +/*-----------------------------------------------------------*/ + +#if( configSUPPORT_STATIC_ALLOCATION == 1 ) + + EventGroupHandle_t xEventGroupCreateStatic( StaticEventGroup_t *pxEventGroupBuffer ) + { + EventGroup_t *pxEventBits; + + /* A StaticEventGroup_t object must be provided. */ + configASSERT( pxEventGroupBuffer ); + + /* The user has provided a statically allocated event group - use it. */ + pxEventBits = ( EventGroup_t * ) pxEventGroupBuffer; /*lint !e740 EventGroup_t and StaticEventGroup_t are guaranteed to have the same size and alignment requirement - checked by configASSERT(). */ + + if( pxEventBits != NULL ) + { + pxEventBits->uxEventBits = 0; + vListInitialise( &( pxEventBits->xTasksWaitingForBits ) ); + + #if( configSUPPORT_DYNAMIC_ALLOCATION == 1 ) + { + /* Both static and dynamic allocation can be used, so note that + this event group was created statically in case the event group + is later deleted. */ + pxEventBits->ucStaticallyAllocated = pdTRUE; + } + #endif /* configSUPPORT_DYNAMIC_ALLOCATION */ + + traceEVENT_GROUP_CREATE( pxEventBits ); + } + else + { + traceEVENT_GROUP_CREATE_FAILED(); + } + + return ( EventGroupHandle_t ) pxEventBits; + } + +#endif /* configSUPPORT_STATIC_ALLOCATION */ +/*-----------------------------------------------------------*/ + +#if( configSUPPORT_DYNAMIC_ALLOCATION == 1 ) + + EventGroupHandle_t xEventGroupCreate( void ) + { + EventGroup_t *pxEventBits; + + /* Allocate the event group. */ + pxEventBits = ( EventGroup_t * ) pvPortMalloc( sizeof( EventGroup_t ) ); + + if( pxEventBits != NULL ) + { + pxEventBits->uxEventBits = 0; + vListInitialise( &( pxEventBits->xTasksWaitingForBits ) ); + + #if( configSUPPORT_STATIC_ALLOCATION == 1 ) + { + /* Both static and dynamic allocation can be used, so note this + event group was allocated statically in case the event group is + later deleted. */ + pxEventBits->ucStaticallyAllocated = pdFALSE; + } + #endif /* configSUPPORT_STATIC_ALLOCATION */ + + traceEVENT_GROUP_CREATE( pxEventBits ); + } + else + { + traceEVENT_GROUP_CREATE_FAILED(); + } + + return ( EventGroupHandle_t ) pxEventBits; + } + +#endif /* configSUPPORT_DYNAMIC_ALLOCATION */ +/*-----------------------------------------------------------*/ + +EventBits_t xEventGroupSync( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToSet, const EventBits_t uxBitsToWaitFor, TickType_t xTicksToWait ) +{ +EventBits_t uxOriginalBitValue, uxReturn; +EventGroup_t *pxEventBits = ( EventGroup_t * ) xEventGroup; +BaseType_t xAlreadyYielded; +BaseType_t xTimeoutOccurred = pdFALSE; + + configASSERT( ( uxBitsToWaitFor & eventEVENT_BITS_CONTROL_BYTES ) == 0 ); + configASSERT( uxBitsToWaitFor != 0 ); + #if ( ( INCLUDE_xTaskGetSchedulerState == 1 ) || ( configUSE_TIMERS == 1 ) ) + { + configASSERT( !( ( xTaskGetSchedulerState() == taskSCHEDULER_SUSPENDED ) && ( xTicksToWait != 0 ) ) ); + } + #endif + + vTaskSuspendAll(); + { + uxOriginalBitValue = pxEventBits->uxEventBits; + + ( void ) xEventGroupSetBits( xEventGroup, uxBitsToSet ); + + if( ( ( uxOriginalBitValue | uxBitsToSet ) & uxBitsToWaitFor ) == uxBitsToWaitFor ) + { + /* All the rendezvous bits are now set - no need to block. */ + uxReturn = ( uxOriginalBitValue | uxBitsToSet ); + + /* Rendezvous always clear the bits. They will have been cleared + already unless this is the only task in the rendezvous. */ + pxEventBits->uxEventBits &= ~uxBitsToWaitFor; + + xTicksToWait = 0; + } + else + { + if( xTicksToWait != ( TickType_t ) 0 ) + { + traceEVENT_GROUP_SYNC_BLOCK( xEventGroup, uxBitsToSet, uxBitsToWaitFor ); + + /* Store the bits that the calling task is waiting for in the + task's event list item so the kernel knows when a match is + found. Then enter the blocked state. */ + vTaskPlaceOnUnorderedEventList( &( pxEventBits->xTasksWaitingForBits ), ( uxBitsToWaitFor | eventCLEAR_EVENTS_ON_EXIT_BIT | eventWAIT_FOR_ALL_BITS ), xTicksToWait ); + + /* This assignment is obsolete as uxReturn will get set after + the task unblocks, but some compilers mistakenly generate a + warning about uxReturn being returned without being set if the + assignment is omitted. */ + uxReturn = 0; + } + else + { + /* The rendezvous bits were not set, but no block time was + specified - just return the current event bit value. */ + uxReturn = pxEventBits->uxEventBits; + } + } + } + xAlreadyYielded = xTaskResumeAll(); + + if( xTicksToWait != ( TickType_t ) 0 ) + { + if( xAlreadyYielded == pdFALSE ) + { + portYIELD_WITHIN_API(); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + /* The task blocked to wait for its required bits to be set - at this + point either the required bits were set or the block time expired. If + the required bits were set they will have been stored in the task's + event list item, and they should now be retrieved then cleared. */ + uxReturn = uxTaskResetEventItemValue(); + + if( ( uxReturn & eventUNBLOCKED_DUE_TO_BIT_SET ) == ( EventBits_t ) 0 ) + { + /* The task timed out, just return the current event bit value. */ + taskENTER_CRITICAL(); + { + uxReturn = pxEventBits->uxEventBits; + + /* Although the task got here because it timed out before the + bits it was waiting for were set, it is possible that since it + unblocked another task has set the bits. If this is the case + then it needs to clear the bits before exiting. */ + if( ( uxReturn & uxBitsToWaitFor ) == uxBitsToWaitFor ) + { + pxEventBits->uxEventBits &= ~uxBitsToWaitFor; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + taskEXIT_CRITICAL(); + + xTimeoutOccurred = pdTRUE; + } + else + { + /* The task unblocked because the bits were set. */ + } + + /* Control bits might be set as the task had blocked should not be + returned. */ + uxReturn &= ~eventEVENT_BITS_CONTROL_BYTES; + } + + traceEVENT_GROUP_SYNC_END( xEventGroup, uxBitsToSet, uxBitsToWaitFor, xTimeoutOccurred ); + + return uxReturn; +} +/*-----------------------------------------------------------*/ + +EventBits_t xEventGroupWaitBits( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToWaitFor, const BaseType_t xClearOnExit, const BaseType_t xWaitForAllBits, TickType_t xTicksToWait ) +{ +EventGroup_t *pxEventBits = ( EventGroup_t * ) xEventGroup; +EventBits_t uxReturn, uxControlBits = 0; +BaseType_t xWaitConditionMet, xAlreadyYielded; +BaseType_t xTimeoutOccurred = pdFALSE; + + /* Check the user is not attempting to wait on the bits used by the kernel + itself, and that at least one bit is being requested. */ + configASSERT( xEventGroup ); + configASSERT( ( uxBitsToWaitFor & eventEVENT_BITS_CONTROL_BYTES ) == 0 ); + configASSERT( uxBitsToWaitFor != 0 ); + #if ( ( INCLUDE_xTaskGetSchedulerState == 1 ) || ( configUSE_TIMERS == 1 ) ) + { + configASSERT( !( ( xTaskGetSchedulerState() == taskSCHEDULER_SUSPENDED ) && ( xTicksToWait != 0 ) ) ); + } + #endif + + vTaskSuspendAll(); + { + const EventBits_t uxCurrentEventBits = pxEventBits->uxEventBits; + + /* Check to see if the wait condition is already met or not. */ + xWaitConditionMet = prvTestWaitCondition( uxCurrentEventBits, uxBitsToWaitFor, xWaitForAllBits ); + + if( xWaitConditionMet != pdFALSE ) + { + /* The wait condition has already been met so there is no need to + block. */ + uxReturn = uxCurrentEventBits; + xTicksToWait = ( TickType_t ) 0; + + /* Clear the wait bits if requested to do so. */ + if( xClearOnExit != pdFALSE ) + { + pxEventBits->uxEventBits &= ~uxBitsToWaitFor; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else if( xTicksToWait == ( TickType_t ) 0 ) + { + /* The wait condition has not been met, but no block time was + specified, so just return the current value. */ + uxReturn = uxCurrentEventBits; + } + else + { + /* The task is going to block to wait for its required bits to be + set. uxControlBits are used to remember the specified behaviour of + this call to xEventGroupWaitBits() - for use when the event bits + unblock the task. */ + if( xClearOnExit != pdFALSE ) + { + uxControlBits |= eventCLEAR_EVENTS_ON_EXIT_BIT; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + if( xWaitForAllBits != pdFALSE ) + { + uxControlBits |= eventWAIT_FOR_ALL_BITS; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + /* Store the bits that the calling task is waiting for in the + task's event list item so the kernel knows when a match is + found. Then enter the blocked state. */ + vTaskPlaceOnUnorderedEventList( &( pxEventBits->xTasksWaitingForBits ), ( uxBitsToWaitFor | uxControlBits ), xTicksToWait ); + + /* This is obsolete as it will get set after the task unblocks, but + some compilers mistakenly generate a warning about the variable + being returned without being set if it is not done. */ + uxReturn = 0; + + traceEVENT_GROUP_WAIT_BITS_BLOCK( xEventGroup, uxBitsToWaitFor ); + } + } + xAlreadyYielded = xTaskResumeAll(); + + if( xTicksToWait != ( TickType_t ) 0 ) + { + if( xAlreadyYielded == pdFALSE ) + { + portYIELD_WITHIN_API(); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + /* The task blocked to wait for its required bits to be set - at this + point either the required bits were set or the block time expired. If + the required bits were set they will have been stored in the task's + event list item, and they should now be retrieved then cleared. */ + uxReturn = uxTaskResetEventItemValue(); + + if( ( uxReturn & eventUNBLOCKED_DUE_TO_BIT_SET ) == ( EventBits_t ) 0 ) + { + taskENTER_CRITICAL(); + { + /* The task timed out, just return the current event bit value. */ + uxReturn = pxEventBits->uxEventBits; + + /* It is possible that the event bits were updated between this + task leaving the Blocked state and running again. */ + if( prvTestWaitCondition( uxReturn, uxBitsToWaitFor, xWaitForAllBits ) != pdFALSE ) + { + if( xClearOnExit != pdFALSE ) + { + pxEventBits->uxEventBits &= ~uxBitsToWaitFor; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + taskEXIT_CRITICAL(); + + /* Prevent compiler warnings when trace macros are not used. */ + xTimeoutOccurred = pdFALSE; + } + else + { + /* The task unblocked because the bits were set. */ + } + + /* The task blocked so control bits may have been set. */ + uxReturn &= ~eventEVENT_BITS_CONTROL_BYTES; + } + traceEVENT_GROUP_WAIT_BITS_END( xEventGroup, uxBitsToWaitFor, xTimeoutOccurred ); + + return uxReturn; +} +/*-----------------------------------------------------------*/ + +EventBits_t xEventGroupClearBits( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToClear ) +{ +EventGroup_t *pxEventBits = ( EventGroup_t * ) xEventGroup; +EventBits_t uxReturn; + + /* Check the user is not attempting to clear the bits used by the kernel + itself. */ + configASSERT( xEventGroup ); + configASSERT( ( uxBitsToClear & eventEVENT_BITS_CONTROL_BYTES ) == 0 ); + + taskENTER_CRITICAL(); + { + traceEVENT_GROUP_CLEAR_BITS( xEventGroup, uxBitsToClear ); + + /* The value returned is the event group value prior to the bits being + cleared. */ + uxReturn = pxEventBits->uxEventBits; + + /* Clear the bits. */ + pxEventBits->uxEventBits &= ~uxBitsToClear; + } + taskEXIT_CRITICAL(); + + return uxReturn; +} +/*-----------------------------------------------------------*/ + +#if ( ( configUSE_TRACE_FACILITY == 1 ) && ( INCLUDE_xTimerPendFunctionCall == 1 ) && ( configUSE_TIMERS == 1 ) ) + + BaseType_t xEventGroupClearBitsFromISR( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToClear ) + { + BaseType_t xReturn; + + traceEVENT_GROUP_CLEAR_BITS_FROM_ISR( xEventGroup, uxBitsToClear ); + xReturn = xTimerPendFunctionCallFromISR( vEventGroupClearBitsCallback, ( void * ) xEventGroup, ( uint32_t ) uxBitsToClear, NULL ); + + return xReturn; + } + +#endif +/*-----------------------------------------------------------*/ + +EventBits_t xEventGroupGetBitsFromISR( EventGroupHandle_t xEventGroup ) +{ +UBaseType_t uxSavedInterruptStatus; +EventGroup_t *pxEventBits = ( EventGroup_t * ) xEventGroup; +EventBits_t uxReturn; + + uxSavedInterruptStatus = portSET_INTERRUPT_MASK_FROM_ISR(); + { + uxReturn = pxEventBits->uxEventBits; + } + portCLEAR_INTERRUPT_MASK_FROM_ISR( uxSavedInterruptStatus ); + + return uxReturn; +} +/*-----------------------------------------------------------*/ + +EventBits_t xEventGroupSetBits( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToSet ) +{ +ListItem_t *pxListItem, *pxNext; +ListItem_t const *pxListEnd; +List_t *pxList; +EventBits_t uxBitsToClear = 0, uxBitsWaitedFor, uxControlBits; +EventGroup_t *pxEventBits = ( EventGroup_t * ) xEventGroup; +BaseType_t xMatchFound = pdFALSE; + + /* Check the user is not attempting to set the bits used by the kernel + itself. */ + configASSERT( xEventGroup ); + configASSERT( ( uxBitsToSet & eventEVENT_BITS_CONTROL_BYTES ) == 0 ); + + pxList = &( pxEventBits->xTasksWaitingForBits ); + pxListEnd = listGET_END_MARKER( pxList ); /*lint !e826 !e740 The mini list structure is used as the list end to save RAM. This is checked and valid. */ + vTaskSuspendAll(); + { + traceEVENT_GROUP_SET_BITS( xEventGroup, uxBitsToSet ); + + pxListItem = listGET_HEAD_ENTRY( pxList ); + + /* Set the bits. */ + pxEventBits->uxEventBits |= uxBitsToSet; + + /* See if the new bit value should unblock any tasks. */ + while( pxListItem != pxListEnd ) + { + pxNext = listGET_NEXT( pxListItem ); + uxBitsWaitedFor = listGET_LIST_ITEM_VALUE( pxListItem ); + xMatchFound = pdFALSE; + + /* Split the bits waited for from the control bits. */ + uxControlBits = uxBitsWaitedFor & eventEVENT_BITS_CONTROL_BYTES; + uxBitsWaitedFor &= ~eventEVENT_BITS_CONTROL_BYTES; + + if( ( uxControlBits & eventWAIT_FOR_ALL_BITS ) == ( EventBits_t ) 0 ) + { + /* Just looking for single bit being set. */ + if( ( uxBitsWaitedFor & pxEventBits->uxEventBits ) != ( EventBits_t ) 0 ) + { + xMatchFound = pdTRUE; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else if( ( uxBitsWaitedFor & pxEventBits->uxEventBits ) == uxBitsWaitedFor ) + { + /* All bits are set. */ + xMatchFound = pdTRUE; + } + else + { + /* Need all bits to be set, but not all the bits were set. */ + } + + if( xMatchFound != pdFALSE ) + { + /* The bits match. Should the bits be cleared on exit? */ + if( ( uxControlBits & eventCLEAR_EVENTS_ON_EXIT_BIT ) != ( EventBits_t ) 0 ) + { + uxBitsToClear |= uxBitsWaitedFor; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + + /* Store the actual event flag value in the task's event list + item before removing the task from the event list. The + eventUNBLOCKED_DUE_TO_BIT_SET bit is set so the task knows + that is was unblocked due to its required bits matching, rather + than because it timed out. */ + ( void ) xTaskRemoveFromUnorderedEventList( pxListItem, pxEventBits->uxEventBits | eventUNBLOCKED_DUE_TO_BIT_SET ); + } + + /* Move onto the next list item. Note pxListItem->pxNext is not + used here as the list item may have been removed from the event list + and inserted into the ready/pending reading list. */ + pxListItem = pxNext; + } + + /* Clear any bits that matched when the eventCLEAR_EVENTS_ON_EXIT_BIT + bit was set in the control word. */ + pxEventBits->uxEventBits &= ~uxBitsToClear; + } + ( void ) xTaskResumeAll(); + + return pxEventBits->uxEventBits; +} +/*-----------------------------------------------------------*/ + +void vEventGroupDelete( EventGroupHandle_t xEventGroup ) +{ +EventGroup_t *pxEventBits = ( EventGroup_t * ) xEventGroup; +const List_t *pxTasksWaitingForBits = &( pxEventBits->xTasksWaitingForBits ); + + vTaskSuspendAll(); + { + traceEVENT_GROUP_DELETE( xEventGroup ); + + while( listCURRENT_LIST_LENGTH( pxTasksWaitingForBits ) > ( UBaseType_t ) 0 ) + { + /* Unblock the task, returning 0 as the event list is being deleted + and cannot therefore have any bits set. */ + configASSERT( pxTasksWaitingForBits->xListEnd.pxNext != ( ListItem_t * ) &( pxTasksWaitingForBits->xListEnd ) ); + ( void ) xTaskRemoveFromUnorderedEventList( pxTasksWaitingForBits->xListEnd.pxNext, eventUNBLOCKED_DUE_TO_BIT_SET ); + } + + #if( ( configSUPPORT_DYNAMIC_ALLOCATION == 1 ) && ( configSUPPORT_STATIC_ALLOCATION == 0 ) ) + { + /* The event group can only have been allocated dynamically - free + it again. */ + vPortFree( pxEventBits ); + } + #elif( ( configSUPPORT_DYNAMIC_ALLOCATION == 1 ) && ( configSUPPORT_STATIC_ALLOCATION == 1 ) ) + { + /* The event group could have been allocated statically or + dynamically, so check before attempting to free the memory. */ + if( pxEventBits->ucStaticallyAllocated == ( uint8_t ) pdFALSE ) + { + vPortFree( pxEventBits ); + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + #endif /* configSUPPORT_DYNAMIC_ALLOCATION */ + } + ( void ) xTaskResumeAll(); +} +/*-----------------------------------------------------------*/ + +/* For internal use only - execute a 'set bits' command that was pended from +an interrupt. */ +void vEventGroupSetBitsCallback( void *pvEventGroup, const uint32_t ulBitsToSet ) +{ + ( void ) xEventGroupSetBits( pvEventGroup, ( EventBits_t ) ulBitsToSet ); +} +/*-----------------------------------------------------------*/ + +/* For internal use only - execute a 'clear bits' command that was pended from +an interrupt. */ +void vEventGroupClearBitsCallback( void *pvEventGroup, const uint32_t ulBitsToClear ) +{ + ( void ) xEventGroupClearBits( pvEventGroup, ( EventBits_t ) ulBitsToClear ); +} +/*-----------------------------------------------------------*/ + +static BaseType_t prvTestWaitCondition( const EventBits_t uxCurrentEventBits, const EventBits_t uxBitsToWaitFor, const BaseType_t xWaitForAllBits ) +{ +BaseType_t xWaitConditionMet = pdFALSE; + + if( xWaitForAllBits == pdFALSE ) + { + /* Task only has to wait for one bit within uxBitsToWaitFor to be + set. Is one already set? */ + if( ( uxCurrentEventBits & uxBitsToWaitFor ) != ( EventBits_t ) 0 ) + { + xWaitConditionMet = pdTRUE; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + else + { + /* Task has to wait for all the bits in uxBitsToWaitFor to be set. + Are they set already? */ + if( ( uxCurrentEventBits & uxBitsToWaitFor ) == uxBitsToWaitFor ) + { + xWaitConditionMet = pdTRUE; + } + else + { + mtCOVERAGE_TEST_MARKER(); + } + } + + return xWaitConditionMet; +} +/*-----------------------------------------------------------*/ + +#if ( ( configUSE_TRACE_FACILITY == 1 ) && ( INCLUDE_xTimerPendFunctionCall == 1 ) && ( configUSE_TIMERS == 1 ) ) + + BaseType_t xEventGroupSetBitsFromISR( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToSet, BaseType_t *pxHigherPriorityTaskWoken ) + { + BaseType_t xReturn; + + traceEVENT_GROUP_SET_BITS_FROM_ISR( xEventGroup, uxBitsToSet ); + xReturn = xTimerPendFunctionCallFromISR( vEventGroupSetBitsCallback, ( void * ) xEventGroup, ( uint32_t ) uxBitsToSet, pxHigherPriorityTaskWoken ); + + return xReturn; + } + +#endif +/*-----------------------------------------------------------*/ + +#if (configUSE_TRACE_FACILITY == 1) + + UBaseType_t uxEventGroupGetNumber( void* xEventGroup ) + { + UBaseType_t xReturn; + EventGroup_t *pxEventBits = ( EventGroup_t * ) xEventGroup; + + if( xEventGroup == NULL ) + { + xReturn = 0; + } + else + { + xReturn = pxEventBits->uxEventGroupNumber; + } + + return xReturn; + } + +#endif + diff --git a/FreeRTOS/include/FreeRTOS.h b/FreeRTOS/include/FreeRTOS.h new file mode 100644 index 0000000..f81172d --- /dev/null +++ b/FreeRTOS/include/FreeRTOS.h @@ -0,0 +1,1063 @@ +/* + FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd. + All rights reserved + + VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION. + + This file is part of the FreeRTOS distribution. + + FreeRTOS is free software; you can redistribute it and/or modify it under + the terms of the GNU General Public License (version 2) as published by the + Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception. + + *************************************************************************** + >>! NOTE: The modification to the GPL is included to allow you to !<< + >>! distribute a combined work that includes FreeRTOS without being !<< + >>! obliged to provide the source code for proprietary components !<< + >>! outside of the FreeRTOS kernel. !<< + *************************************************************************** + + FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY + WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS + FOR A PARTICULAR PURPOSE. Full license text is available on the following + link: http://www.freertos.org/a00114.html + + *************************************************************************** + * * + * FreeRTOS provides completely free yet professionally developed, * + * robust, strictly quality controlled, supported, and cross * + * platform software that is more than just the market leader, it * + * is the industry's de facto standard. * + * * + * Help yourself get started quickly while simultaneously helping * + * to support the FreeRTOS project by purchasing a FreeRTOS * + * tutorial book, reference manual, or both: * + * http://www.FreeRTOS.org/Documentation * + * * + *************************************************************************** + + http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading + the FAQ page "My application does not run, what could be wrong?". Have you + defined configASSERT()? + + http://www.FreeRTOS.org/support - In return for receiving this top quality + embedded software for free we request you assist our global community by + participating in the support forum. + + http://www.FreeRTOS.org/training - Investing in training allows your team to + be as productive as possible as early as possible. Now you can receive + FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers + Ltd, and the world's leading authority on the world's leading RTOS. + + http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products, + including FreeRTOS+Trace - an indispensable productivity tool, a DOS + compatible FAT file system, and our tiny thread aware UDP/IP stack. + + http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate. + Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS. + + http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High + Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS + licenses offer ticketed support, indemnification and commercial middleware. + + http://www.SafeRTOS.com - High Integrity Systems also provide a safety + engineered and independently SIL3 certified version for use in safety and + mission critical applications that require provable dependability. + + 1 tab == 4 spaces! +*/ + +#ifndef INC_FREERTOS_H +#define INC_FREERTOS_H + +/* + * Include the generic headers required for the FreeRTOS port being used. + */ +#include + +/* + * If stdint.h cannot be located then: + * + If using GCC ensure the -nostdint options is *not* being used. + * + Ensure the project's include path includes the directory in which your + * compiler stores stdint.h. + * + Set any compiler options necessary for it to support C99, as technically + * stdint.h is only mandatory with C99 (FreeRTOS does not require C99 in any + * other way). + * + The FreeRTOS download includes a simple stdint.h definition that can be + * used in cases where none is provided by the compiler. The files only + * contains the typedefs required to build FreeRTOS. Read the instructions + * in FreeRTOS/source/stdint.readme for more information. + */ +#include /* READ COMMENT ABOVE. */ + +#ifdef __cplusplus +extern "C" { +#endif + +/* Application specific configuration options. */ +#include "FreeRTOSConfig.h" + +/* Basic FreeRTOS definitions. */ +#include "projdefs.h" + +/* Definitions specific to the port being used. */ +#include "portable.h" + +/* Must be defaulted before configUSE_NEWLIB_REENTRANT is used below. */ +#ifndef configUSE_NEWLIB_REENTRANT + #define configUSE_NEWLIB_REENTRANT 0 +#endif + +/* Required if struct _reent is used. */ +#if ( configUSE_NEWLIB_REENTRANT == 1 ) + #include +#endif +/* + * Check all the required application specific macros have been defined. + * These macros are application specific and (as downloaded) are defined + * within FreeRTOSConfig.h. + */ + +#ifndef configMINIMAL_STACK_SIZE + #error Missing definition: configMINIMAL_STACK_SIZE must be defined in FreeRTOSConfig.h. configMINIMAL_STACK_SIZE defines the size (in words) of the stack allocated to the idle task. Refer to the demo project provided for your port for a suitable value. +#endif + +#ifndef configMAX_PRIORITIES + #error Missing definition: configMAX_PRIORITIES must be defined in FreeRTOSConfig.h. See the Configuration section of the FreeRTOS API documentation for details. +#endif + +#ifndef configUSE_PREEMPTION + #error Missing definition: configUSE_PREEMPTION must be defined in FreeRTOSConfig.h as either 1 or 0. See the Configuration section of the FreeRTOS API documentation for details. +#endif + +#ifndef configUSE_IDLE_HOOK + #error Missing definition: configUSE_IDLE_HOOK must be defined in FreeRTOSConfig.h as either 1 or 0. See the Configuration section of the FreeRTOS API documentation for details. +#endif + +#ifndef configUSE_TICK_HOOK + #error Missing definition: configUSE_TICK_HOOK must be defined in FreeRTOSConfig.h as either 1 or 0. See the Configuration section of the FreeRTOS API documentation for details. +#endif + +#ifndef configUSE_16_BIT_TICKS + #error Missing definition: configUSE_16_BIT_TICKS must be defined in FreeRTOSConfig.h as either 1 or 0. See the Configuration section of the FreeRTOS API documentation for details. +#endif + +#ifndef configMAX_PRIORITIES + #error configMAX_PRIORITIES must be defined to be greater than or equal to 1. +#endif + +#ifndef configUSE_CO_ROUTINES + #define configUSE_CO_ROUTINES 0 +#endif + +#ifndef INCLUDE_vTaskPrioritySet + #define INCLUDE_vTaskPrioritySet 0 +#endif + +#ifndef INCLUDE_uxTaskPriorityGet + #define INCLUDE_uxTaskPriorityGet 0 +#endif + +#ifndef INCLUDE_vTaskDelete + #define INCLUDE_vTaskDelete 0 +#endif + +#ifndef INCLUDE_vTaskSuspend + #define INCLUDE_vTaskSuspend 0 +#endif + +#ifndef INCLUDE_vTaskDelayUntil + #define INCLUDE_vTaskDelayUntil 0 +#endif + +#ifndef INCLUDE_vTaskDelay + #define INCLUDE_vTaskDelay 0 +#endif + +#ifndef INCLUDE_xTaskGetIdleTaskHandle + #define INCLUDE_xTaskGetIdleTaskHandle 0 +#endif + +#ifndef INCLUDE_xTaskAbortDelay + #define INCLUDE_xTaskAbortDelay 0 +#endif + +#ifndef INCLUDE_xQueueGetMutexHolder + #define INCLUDE_xQueueGetMutexHolder 0 +#endif + +#ifndef INCLUDE_xSemaphoreGetMutexHolder + #define INCLUDE_xSemaphoreGetMutexHolder INCLUDE_xQueueGetMutexHolder +#endif + +#ifndef INCLUDE_xTaskGetHandle + #define INCLUDE_xTaskGetHandle 0 +#endif + +#ifndef INCLUDE_uxTaskGetStackHighWaterMark + #define INCLUDE_uxTaskGetStackHighWaterMark 0 +#endif + +#ifndef INCLUDE_eTaskGetState + #define INCLUDE_eTaskGetState 0 +#endif + +#ifndef INCLUDE_xTaskResumeFromISR + #define INCLUDE_xTaskResumeFromISR 1 +#endif + +#ifndef INCLUDE_xTimerPendFunctionCall + #define INCLUDE_xTimerPendFunctionCall 0 +#endif + +#ifndef INCLUDE_xTaskGetSchedulerState + #define INCLUDE_xTaskGetSchedulerState 0 +#endif + +#ifndef INCLUDE_xTaskGetCurrentTaskHandle + #define INCLUDE_xTaskGetCurrentTaskHandle 0 +#endif + +#if configUSE_CO_ROUTINES != 0 + #ifndef configMAX_CO_ROUTINE_PRIORITIES + #error configMAX_CO_ROUTINE_PRIORITIES must be greater than or equal to 1. + #endif +#endif + +#ifndef configUSE_DAEMON_TASK_STARTUP_HOOK + #define configUSE_DAEMON_TASK_STARTUP_HOOK 0 +#endif + +#ifndef configUSE_APPLICATION_TASK_TAG + #define configUSE_APPLICATION_TASK_TAG 0 +#endif + +#ifndef configNUM_THREAD_LOCAL_STORAGE_POINTERS + #define configNUM_THREAD_LOCAL_STORAGE_POINTERS 0 +#endif + +#ifndef configUSE_RECURSIVE_MUTEXES + #define configUSE_RECURSIVE_MUTEXES 0 +#endif + +#ifndef configUSE_MUTEXES + #define configUSE_MUTEXES 0 +#endif + +#ifndef configUSE_TIMERS + #define configUSE_TIMERS 0 +#endif + +#ifndef configUSE_COUNTING_SEMAPHORES + #define configUSE_COUNTING_SEMAPHORES 0 +#endif + +#ifndef configUSE_ALTERNATIVE_API + #define configUSE_ALTERNATIVE_API 0 +#endif + +#ifndef portCRITICAL_NESTING_IN_TCB + #define portCRITICAL_NESTING_IN_TCB 0 +#endif + +#ifndef configMAX_TASK_NAME_LEN + #define configMAX_TASK_NAME_LEN 16 +#endif + +#ifndef configIDLE_SHOULD_YIELD + #define configIDLE_SHOULD_YIELD 1 +#endif + +#if configMAX_TASK_NAME_LEN < 1 + #error configMAX_TASK_NAME_LEN must be set to a minimum of 1 in FreeRTOSConfig.h +#endif + +#ifndef configASSERT + #define configASSERT( x ) + #define configASSERT_DEFINED 0 +#else + #define configASSERT_DEFINED 1 +#endif + +/* The timers module relies on xTaskGetSchedulerState(). */ +#if configUSE_TIMERS == 1 + + #ifndef configTIMER_TASK_PRIORITY + #error If configUSE_TIMERS is set to 1 then configTIMER_TASK_PRIORITY must also be defined. + #endif /* configTIMER_TASK_PRIORITY */ + + #ifndef configTIMER_QUEUE_LENGTH + #error If configUSE_TIMERS is set to 1 then configTIMER_QUEUE_LENGTH must also be defined. + #endif /* configTIMER_QUEUE_LENGTH */ + + #ifndef configTIMER_TASK_STACK_DEPTH + #error If configUSE_TIMERS is set to 1 then configTIMER_TASK_STACK_DEPTH must also be defined. + #endif /* configTIMER_TASK_STACK_DEPTH */ + +#endif /* configUSE_TIMERS */ + +#ifndef portSET_INTERRUPT_MASK_FROM_ISR + #define portSET_INTERRUPT_MASK_FROM_ISR() 0 +#endif + +#ifndef portCLEAR_INTERRUPT_MASK_FROM_ISR + #define portCLEAR_INTERRUPT_MASK_FROM_ISR( uxSavedStatusValue ) ( void ) uxSavedStatusValue +#endif + +#ifndef portCLEAN_UP_TCB + #define portCLEAN_UP_TCB( pxTCB ) ( void ) pxTCB +#endif + +#ifndef portPRE_TASK_DELETE_HOOK + #define portPRE_TASK_DELETE_HOOK( pvTaskToDelete, pxYieldPending ) +#endif + +#ifndef portSETUP_TCB + #define portSETUP_TCB( pxTCB ) ( void ) pxTCB +#endif + +#ifndef configQUEUE_REGISTRY_SIZE + #define configQUEUE_REGISTRY_SIZE 0U +#endif + +#if ( configQUEUE_REGISTRY_SIZE < 1 ) + #define vQueueAddToRegistry( xQueue, pcName ) + #define vQueueUnregisterQueue( xQueue ) + #define pcQueueGetName( xQueue ) +#endif + +#ifndef portPOINTER_SIZE_TYPE + #define portPOINTER_SIZE_TYPE uint32_t +#endif + +/* Remove any unused trace macros. */ +#ifndef traceSTART + /* Used to perform any necessary initialisation - for example, open a file + into which trace is to be written. */ + #define traceSTART() +#endif + +#ifndef traceEND + /* Use to close a trace, for example close a file into which trace has been + written. */ + #define traceEND() +#endif + +#ifndef traceTASK_SWITCHED_IN + /* Called after a task has been selected to run. pxCurrentTCB holds a pointer + to the task control block of the selected task. */ + #define traceTASK_SWITCHED_IN() +#endif + +#ifndef traceINCREASE_TICK_COUNT + /* Called before stepping the tick count after waking from tickless idle + sleep. */ + #define traceINCREASE_TICK_COUNT( x ) +#endif + +#ifndef traceLOW_POWER_IDLE_BEGIN + /* Called immediately before entering tickless idle. */ + #define traceLOW_POWER_IDLE_BEGIN() +#endif + +#ifndef traceLOW_POWER_IDLE_END + /* Called when returning to the Idle task after a tickless idle. */ + #define traceLOW_POWER_IDLE_END() +#endif + +#ifndef traceTASK_SWITCHED_OUT + /* Called before a task has been selected to run. pxCurrentTCB holds a pointer + to the task control block of the task being switched out. */ + #define traceTASK_SWITCHED_OUT() +#endif + +#ifndef traceTASK_PRIORITY_INHERIT + /* Called when a task attempts to take a mutex that is already held by a + lower priority task. pxTCBOfMutexHolder is a pointer to the TCB of the task + that holds the mutex. uxInheritedPriority is the priority the mutex holder + will inherit (the priority of the task that is attempting to obtain the + muted. */ + #define traceTASK_PRIORITY_INHERIT( pxTCBOfMutexHolder, uxInheritedPriority ) +#endif + +#ifndef traceTASK_PRIORITY_DISINHERIT + /* Called when a task releases a mutex, the holding of which had resulted in + the task inheriting the priority of a higher priority task. + pxTCBOfMutexHolder is a pointer to the TCB of the task that is releasing the + mutex. uxOriginalPriority is the task's configured (base) priority. */ + #define traceTASK_PRIORITY_DISINHERIT( pxTCBOfMutexHolder, uxOriginalPriority ) +#endif + +#ifndef traceBLOCKING_ON_QUEUE_RECEIVE + /* Task is about to block because it cannot read from a + queue/mutex/semaphore. pxQueue is a pointer to the queue/mutex/semaphore + upon which the read was attempted. pxCurrentTCB points to the TCB of the + task that attempted the read. */ + #define traceBLOCKING_ON_QUEUE_RECEIVE( pxQueue ) +#endif + +#ifndef traceBLOCKING_ON_QUEUE_SEND + /* Task is about to block because it cannot write to a + queue/mutex/semaphore. pxQueue is a pointer to the queue/mutex/semaphore + upon which the write was attempted. pxCurrentTCB points to the TCB of the + task that attempted the write. */ + #define traceBLOCKING_ON_QUEUE_SEND( pxQueue ) +#endif + +#ifndef configCHECK_FOR_STACK_OVERFLOW + #define configCHECK_FOR_STACK_OVERFLOW 0 +#endif + +/* The following event macros are embedded in the kernel API calls. */ + +#ifndef traceMOVED_TASK_TO_READY_STATE + #define traceMOVED_TASK_TO_READY_STATE( pxTCB ) +#endif + +#ifndef tracePOST_MOVED_TASK_TO_READY_STATE + #define tracePOST_MOVED_TASK_TO_READY_STATE( pxTCB ) +#endif + +#ifndef traceQUEUE_CREATE + #define traceQUEUE_CREATE( pxNewQueue ) +#endif + +#ifndef traceQUEUE_CREATE_FAILED + #define traceQUEUE_CREATE_FAILED( ucQueueType ) +#endif + +#ifndef traceCREATE_MUTEX + #define traceCREATE_MUTEX( pxNewQueue ) +#endif + +#ifndef traceCREATE_MUTEX_FAILED + #define traceCREATE_MUTEX_FAILED() +#endif + +#ifndef traceGIVE_MUTEX_RECURSIVE + #define traceGIVE_MUTEX_RECURSIVE( pxMutex ) +#endif + +#ifndef traceGIVE_MUTEX_RECURSIVE_FAILED + #define traceGIVE_MUTEX_RECURSIVE_FAILED( pxMutex ) +#endif + +#ifndef traceTAKE_MUTEX_RECURSIVE + #define traceTAKE_MUTEX_RECURSIVE( pxMutex ) +#endif + +#ifndef traceTAKE_MUTEX_RECURSIVE_FAILED + #define traceTAKE_MUTEX_RECURSIVE_FAILED( pxMutex ) +#endif + +#ifndef traceCREATE_COUNTING_SEMAPHORE + #define traceCREATE_COUNTING_SEMAPHORE() +#endif + +#ifndef traceCREATE_COUNTING_SEMAPHORE_FAILED + #define traceCREATE_COUNTING_SEMAPHORE_FAILED() +#endif + +#ifndef traceQUEUE_SEND + #define traceQUEUE_SEND( pxQueue ) +#endif + +#ifndef traceQUEUE_SEND_FAILED + #define traceQUEUE_SEND_FAILED( pxQueue ) +#endif + +#ifndef traceQUEUE_RECEIVE + #define traceQUEUE_RECEIVE( pxQueue ) +#endif + +#ifndef traceQUEUE_PEEK + #define traceQUEUE_PEEK( pxQueue ) +#endif + +#ifndef traceQUEUE_PEEK_FROM_ISR + #define traceQUEUE_PEEK_FROM_ISR( pxQueue ) +#endif + +#ifndef traceQUEUE_RECEIVE_FAILED + #define traceQUEUE_RECEIVE_FAILED( pxQueue ) +#endif + +#ifndef traceQUEUE_SEND_FROM_ISR + #define traceQUEUE_SEND_FROM_ISR( pxQueue ) +#endif + +#ifndef traceQUEUE_SEND_FROM_ISR_FAILED + #define traceQUEUE_SEND_FROM_ISR_FAILED( pxQueue ) +#endif + +#ifndef traceQUEUE_RECEIVE_FROM_ISR + #define traceQUEUE_RECEIVE_FROM_ISR( pxQueue ) +#endif + +#ifndef traceQUEUE_RECEIVE_FROM_ISR_FAILED + #define traceQUEUE_RECEIVE_FROM_ISR_FAILED( pxQueue ) +#endif + +#ifndef traceQUEUE_PEEK_FROM_ISR_FAILED + #define traceQUEUE_PEEK_FROM_ISR_FAILED( pxQueue ) +#endif + +#ifndef traceQUEUE_DELETE + #define traceQUEUE_DELETE( pxQueue ) +#endif + +#ifndef traceTASK_CREATE + #define traceTASK_CREATE( pxNewTCB ) +#endif + +#ifndef traceTASK_CREATE_FAILED + #define traceTASK_CREATE_FAILED() +#endif + +#ifndef traceTASK_DELETE + #define traceTASK_DELETE( pxTaskToDelete ) +#endif + +#ifndef traceTASK_DELAY_UNTIL + #define traceTASK_DELAY_UNTIL( x ) +#endif + +#ifndef traceTASK_DELAY + #define traceTASK_DELAY() +#endif + +#ifndef traceTASK_PRIORITY_SET + #define traceTASK_PRIORITY_SET( pxTask, uxNewPriority ) +#endif + +#ifndef traceTASK_SUSPEND + #define traceTASK_SUSPEND( pxTaskToSuspend ) +#endif + +#ifndef traceTASK_RESUME + #define traceTASK_RESUME( pxTaskToResume ) +#endif + +#ifndef traceTASK_RESUME_FROM_ISR + #define traceTASK_RESUME_FROM_ISR( pxTaskToResume ) +#endif + +#ifndef traceTASK_INCREMENT_TICK + #define traceTASK_INCREMENT_TICK( xTickCount ) +#endif + +#ifndef traceTIMER_CREATE + #define traceTIMER_CREATE( pxNewTimer ) +#endif + +#ifndef traceTIMER_CREATE_FAILED + #define traceTIMER_CREATE_FAILED() +#endif + +#ifndef traceTIMER_COMMAND_SEND + #define traceTIMER_COMMAND_SEND( xTimer, xMessageID, xMessageValueValue, xReturn ) +#endif + +#ifndef traceTIMER_EXPIRED + #define traceTIMER_EXPIRED( pxTimer ) +#endif + +#ifndef traceTIMER_COMMAND_RECEIVED + #define traceTIMER_COMMAND_RECEIVED( pxTimer, xMessageID, xMessageValue ) +#endif + +#ifndef traceMALLOC + #define traceMALLOC( pvAddress, uiSize ) +#endif + +#ifndef traceFREE + #define traceFREE( pvAddress, uiSize ) +#endif + +#ifndef traceEVENT_GROUP_CREATE + #define traceEVENT_GROUP_CREATE( xEventGroup ) +#endif + +#ifndef traceEVENT_GROUP_CREATE_FAILED + #define traceEVENT_GROUP_CREATE_FAILED() +#endif + +#ifndef traceEVENT_GROUP_SYNC_BLOCK + #define traceEVENT_GROUP_SYNC_BLOCK( xEventGroup, uxBitsToSet, uxBitsToWaitFor ) +#endif + +#ifndef traceEVENT_GROUP_SYNC_END + #define traceEVENT_GROUP_SYNC_END( xEventGroup, uxBitsToSet, uxBitsToWaitFor, xTimeoutOccurred ) ( void ) xTimeoutOccurred +#endif + +#ifndef traceEVENT_GROUP_WAIT_BITS_BLOCK + #define traceEVENT_GROUP_WAIT_BITS_BLOCK( xEventGroup, uxBitsToWaitFor ) +#endif + +#ifndef traceEVENT_GROUP_WAIT_BITS_END + #define traceEVENT_GROUP_WAIT_BITS_END( xEventGroup, uxBitsToWaitFor, xTimeoutOccurred ) ( void ) xTimeoutOccurred +#endif + +#ifndef traceEVENT_GROUP_CLEAR_BITS + #define traceEVENT_GROUP_CLEAR_BITS( xEventGroup, uxBitsToClear ) +#endif + +#ifndef traceEVENT_GROUP_CLEAR_BITS_FROM_ISR + #define traceEVENT_GROUP_CLEAR_BITS_FROM_ISR( xEventGroup, uxBitsToClear ) +#endif + +#ifndef traceEVENT_GROUP_SET_BITS + #define traceEVENT_GROUP_SET_BITS( xEventGroup, uxBitsToSet ) +#endif + +#ifndef traceEVENT_GROUP_SET_BITS_FROM_ISR + #define traceEVENT_GROUP_SET_BITS_FROM_ISR( xEventGroup, uxBitsToSet ) +#endif + +#ifndef traceEVENT_GROUP_DELETE + #define traceEVENT_GROUP_DELETE( xEventGroup ) +#endif + +#ifndef tracePEND_FUNC_CALL + #define tracePEND_FUNC_CALL(xFunctionToPend, pvParameter1, ulParameter2, ret) +#endif + +#ifndef tracePEND_FUNC_CALL_FROM_ISR + #define tracePEND_FUNC_CALL_FROM_ISR(xFunctionToPend, pvParameter1, ulParameter2, ret) +#endif + +#ifndef traceQUEUE_REGISTRY_ADD + #define traceQUEUE_REGISTRY_ADD(xQueue, pcQueueName) +#endif + +#ifndef traceTASK_NOTIFY_TAKE_BLOCK + #define traceTASK_NOTIFY_TAKE_BLOCK() +#endif + +#ifndef traceTASK_NOTIFY_TAKE + #define traceTASK_NOTIFY_TAKE() +#endif + +#ifndef traceTASK_NOTIFY_WAIT_BLOCK + #define traceTASK_NOTIFY_WAIT_BLOCK() +#endif + +#ifndef traceTASK_NOTIFY_WAIT + #define traceTASK_NOTIFY_WAIT() +#endif + +#ifndef traceTASK_NOTIFY + #define traceTASK_NOTIFY() +#endif + +#ifndef traceTASK_NOTIFY_FROM_ISR + #define traceTASK_NOTIFY_FROM_ISR() +#endif + +#ifndef traceTASK_NOTIFY_GIVE_FROM_ISR + #define traceTASK_NOTIFY_GIVE_FROM_ISR() +#endif + +#ifndef configGENERATE_RUN_TIME_STATS + #define configGENERATE_RUN_TIME_STATS 0 +#endif + +#if ( configGENERATE_RUN_TIME_STATS == 1 ) + + #ifndef portCONFIGURE_TIMER_FOR_RUN_TIME_STATS + #error If configGENERATE_RUN_TIME_STATS is defined then portCONFIGURE_TIMER_FOR_RUN_TIME_STATS must also be defined. portCONFIGURE_TIMER_FOR_RUN_TIME_STATS should call a port layer function to setup a peripheral timer/counter that can then be used as the run time counter time base. + #endif /* portCONFIGURE_TIMER_FOR_RUN_TIME_STATS */ + + #ifndef portGET_RUN_TIME_COUNTER_VALUE + #ifndef portALT_GET_RUN_TIME_COUNTER_VALUE + #error If configGENERATE_RUN_TIME_STATS is defined then either portGET_RUN_TIME_COUNTER_VALUE or portALT_GET_RUN_TIME_COUNTER_VALUE must also be defined. See the examples provided and the FreeRTOS web site for more information. + #endif /* portALT_GET_RUN_TIME_COUNTER_VALUE */ + #endif /* portGET_RUN_TIME_COUNTER_VALUE */ + +#endif /* configGENERATE_RUN_TIME_STATS */ + +#ifndef portCONFIGURE_TIMER_FOR_RUN_TIME_STATS + #define portCONFIGURE_TIMER_FOR_RUN_TIME_STATS() +#endif + +#ifndef configUSE_MALLOC_FAILED_HOOK + #define configUSE_MALLOC_FAILED_HOOK 0 +#endif + +#ifndef portPRIVILEGE_BIT + #define portPRIVILEGE_BIT ( ( UBaseType_t ) 0x00 ) +#endif + +#ifndef portYIELD_WITHIN_API + #define portYIELD_WITHIN_API portYIELD +#endif + +#ifndef portSUPPRESS_TICKS_AND_SLEEP + #define portSUPPRESS_TICKS_AND_SLEEP( xExpectedIdleTime ) +#endif + +#ifndef configEXPECTED_IDLE_TIME_BEFORE_SLEEP + #define configEXPECTED_IDLE_TIME_BEFORE_SLEEP 2 +#endif + +#if configEXPECTED_IDLE_TIME_BEFORE_SLEEP < 2 + #error configEXPECTED_IDLE_TIME_BEFORE_SLEEP must not be less than 2 +#endif + +#ifndef configUSE_TICKLESS_IDLE + #define configUSE_TICKLESS_IDLE 0 +#endif + +#ifndef configPRE_SLEEP_PROCESSING + #define configPRE_SLEEP_PROCESSING( x ) +#endif + +#ifndef configPOST_SLEEP_PROCESSING + #define configPOST_SLEEP_PROCESSING( x ) +#endif + +#ifndef configUSE_QUEUE_SETS + #define configUSE_QUEUE_SETS 0 +#endif + +#ifndef portTASK_USES_FLOATING_POINT + #define portTASK_USES_FLOATING_POINT() +#endif + +#ifndef configUSE_TIME_SLICING + #define configUSE_TIME_SLICING 1 +#endif + +#ifndef configINCLUDE_APPLICATION_DEFINED_PRIVILEGED_FUNCTIONS + #define configINCLUDE_APPLICATION_DEFINED_PRIVILEGED_FUNCTIONS 0 +#endif + +#ifndef configUSE_STATS_FORMATTING_FUNCTIONS + #define configUSE_STATS_FORMATTING_FUNCTIONS 0 +#endif + +#ifndef portASSERT_IF_INTERRUPT_PRIORITY_INVALID + #define portASSERT_IF_INTERRUPT_PRIORITY_INVALID() +#endif + +#ifndef configUSE_TRACE_FACILITY + #define configUSE_TRACE_FACILITY 0 +#endif + +#ifndef mtCOVERAGE_TEST_MARKER + #define mtCOVERAGE_TEST_MARKER() +#endif + +#ifndef mtCOVERAGE_TEST_DELAY + #define mtCOVERAGE_TEST_DELAY() +#endif + +#ifndef portASSERT_IF_IN_ISR + #define portASSERT_IF_IN_ISR() +#endif + +#ifndef configUSE_PORT_OPTIMISED_TASK_SELECTION + #define configUSE_PORT_OPTIMISED_TASK_SELECTION 0 +#endif + +#ifndef configAPPLICATION_ALLOCATED_HEAP + #define configAPPLICATION_ALLOCATED_HEAP 0 +#endif + +#ifndef configUSE_TASK_NOTIFICATIONS + #define configUSE_TASK_NOTIFICATIONS 1 +#endif + +#ifndef portTICK_TYPE_IS_ATOMIC + #define portTICK_TYPE_IS_ATOMIC 0 +#endif + +#ifndef configSUPPORT_STATIC_ALLOCATION + /* Defaults to 0 for backward compatibility. */ + #define configSUPPORT_STATIC_ALLOCATION 0 +#endif + +#ifndef configSUPPORT_DYNAMIC_ALLOCATION + /* Defaults to 1 for backward compatibility. */ + #define configSUPPORT_DYNAMIC_ALLOCATION 1 +#endif + +/* Sanity check the configuration. */ +#if( configUSE_TICKLESS_IDLE != 0 ) + #if( INCLUDE_vTaskSuspend != 1 ) + #error INCLUDE_vTaskSuspend must be set to 1 if configUSE_TICKLESS_IDLE is not set to 0 + #endif /* INCLUDE_vTaskSuspend */ +#endif /* configUSE_TICKLESS_IDLE */ + +#if( ( configSUPPORT_STATIC_ALLOCATION == 0 ) && ( configSUPPORT_DYNAMIC_ALLOCATION == 0 ) ) + #error configSUPPORT_STATIC_ALLOCATION and configSUPPORT_DYNAMIC_ALLOCATION cannot both be 0, but can both be 1. +#endif + +#if( ( configUSE_RECURSIVE_MUTEXES == 1 ) && ( configUSE_MUTEXES != 1 ) ) + #error configUSE_MUTEXES must be set to 1 to use recursive mutexes +#endif + +#if( portTICK_TYPE_IS_ATOMIC == 0 ) + /* Either variables of tick type cannot be read atomically, or + portTICK_TYPE_IS_ATOMIC was not set - map the critical sections used when + the tick count is returned to the standard critical section macros. */ + #define portTICK_TYPE_ENTER_CRITICAL() portENTER_CRITICAL() + #define portTICK_TYPE_EXIT_CRITICAL() portEXIT_CRITICAL() + #define portTICK_TYPE_SET_INTERRUPT_MASK_FROM_ISR() portSET_INTERRUPT_MASK_FROM_ISR() + #define portTICK_TYPE_CLEAR_INTERRUPT_MASK_FROM_ISR( x ) portCLEAR_INTERRUPT_MASK_FROM_ISR( ( x ) ) +#else + /* The tick type can be read atomically, so critical sections used when the + tick count is returned can be defined away. */ + #define portTICK_TYPE_ENTER_CRITICAL() + #define portTICK_TYPE_EXIT_CRITICAL() + #define portTICK_TYPE_SET_INTERRUPT_MASK_FROM_ISR() 0 + #define portTICK_TYPE_CLEAR_INTERRUPT_MASK_FROM_ISR( x ) ( void ) x +#endif + +/* Definitions to allow backward compatibility with FreeRTOS versions prior to +V8 if desired. */ +#ifndef configENABLE_BACKWARD_COMPATIBILITY + #define configENABLE_BACKWARD_COMPATIBILITY 1 +#endif + +#if configENABLE_BACKWARD_COMPATIBILITY == 1 + #define eTaskStateGet eTaskGetState + #define portTickType TickType_t + #define xTaskHandle TaskHandle_t + #define xQueueHandle QueueHandle_t + #define xSemaphoreHandle SemaphoreHandle_t + #define xQueueSetHandle QueueSetHandle_t + #define xQueueSetMemberHandle QueueSetMemberHandle_t + #define xTimeOutType TimeOut_t + #define xMemoryRegion MemoryRegion_t + #define xTaskParameters TaskParameters_t + #define xTaskStatusType TaskStatus_t + #define xTimerHandle TimerHandle_t + #define xCoRoutineHandle CoRoutineHandle_t + #define pdTASK_HOOK_CODE TaskHookFunction_t + #define portTICK_RATE_MS portTICK_PERIOD_MS + #define pcTaskGetTaskName pcTaskGetName + #define pcTimerGetTimerName pcTimerGetName + #define pcQueueGetQueueName pcQueueGetName + #define vTaskGetTaskInfo vTaskGetInfo + + /* Backward compatibility within the scheduler code only - these definitions + are not really required but are included for completeness. */ + #define tmrTIMER_CALLBACK TimerCallbackFunction_t + #define pdTASK_CODE TaskFunction_t + #define xListItem ListItem_t + #define xList List_t +#endif /* configENABLE_BACKWARD_COMPATIBILITY */ + +#if( configUSE_ALTERNATIVE_API != 0 ) + #error The alternative API was deprecated some time ago, and was removed in FreeRTOS V9.0 0 +#endif + +/* Set configUSE_TASK_FPU_SUPPORT to 0 to omit floating point support even +if floating point hardware is otherwise supported by the FreeRTOS port in use. +This constant is not supported by all FreeRTOS ports that include floating +point support. */ +#ifndef configUSE_TASK_FPU_SUPPORT + #define configUSE_TASK_FPU_SUPPORT 1 +#endif + +/* + * In line with software engineering best practice, FreeRTOS implements a strict + * data hiding policy, so the real structures used by FreeRTOS to maintain the + * state of tasks, queues, semaphores, etc. are not accessible to the application + * code. However, if the application writer wants to statically allocate such + * an object then the size of the object needs to be know. Dummy structures + * that are guaranteed to have the same size and alignment requirements of the + * real objects are used for this purpose. The dummy list and list item + * structures below are used for inclusion in such a dummy structure. + */ +struct xSTATIC_LIST_ITEM +{ + TickType_t xDummy1; + void *pvDummy2[ 4 ]; +}; +typedef struct xSTATIC_LIST_ITEM StaticListItem_t; + +/* See the comments above the struct xSTATIC_LIST_ITEM definition. */ +struct xSTATIC_MINI_LIST_ITEM +{ + TickType_t xDummy1; + void *pvDummy2[ 2 ]; +}; +typedef struct xSTATIC_MINI_LIST_ITEM StaticMiniListItem_t; + +/* See the comments above the struct xSTATIC_LIST_ITEM definition. */ +typedef struct xSTATIC_LIST +{ + UBaseType_t uxDummy1; + void *pvDummy2; + StaticMiniListItem_t xDummy3; +} StaticList_t; + +/* + * In line with software engineering best practice, especially when supplying a + * library that is likely to change in future versions, FreeRTOS implements a + * strict data hiding policy. This means the Task structure used internally by + * FreeRTOS is not accessible to application code. However, if the application + * writer wants to statically allocate the memory required to create a task then + * the size of the task object needs to be know. The StaticTask_t structure + * below is provided for this purpose. Its sizes and alignment requirements are + * guaranteed to match those of the genuine structure, no matter which + * architecture is being used, and no matter how the values in FreeRTOSConfig.h + * are set. Its contents are somewhat obfuscated in the hope users will + * recognise that it would be unwise to make direct use of the structure members. + */ +typedef struct xSTATIC_TCB +{ + void *pxDummy1; + #if ( portUSING_MPU_WRAPPERS == 1 ) + xMPU_SETTINGS xDummy2; + #endif + StaticListItem_t xDummy3[ 2 ]; + UBaseType_t uxDummy5; + void *pxDummy6; + uint8_t ucDummy7[ configMAX_TASK_NAME_LEN ]; + #if ( portSTACK_GROWTH > 0 ) + void *pxDummy8; + #endif + #if ( portCRITICAL_NESTING_IN_TCB == 1 ) + UBaseType_t uxDummy9; + #endif + #if ( configUSE_TRACE_FACILITY == 1 ) + UBaseType_t uxDummy10[ 2 ]; + #endif + #if ( configUSE_MUTEXES == 1 ) + UBaseType_t uxDummy12[ 2 ]; + #endif + #if ( configUSE_APPLICATION_TASK_TAG == 1 ) + void *pxDummy14; + #endif + #if( configNUM_THREAD_LOCAL_STORAGE_POINTERS > 0 ) + void *pvDummy15[ configNUM_THREAD_LOCAL_STORAGE_POINTERS ]; + #endif + #if ( configGENERATE_RUN_TIME_STATS == 1 ) + uint32_t ulDummy16; + #endif + #if ( configUSE_NEWLIB_REENTRANT == 1 ) + struct _reent xDummy17; + #endif + #if ( configUSE_TASK_NOTIFICATIONS == 1 ) + uint32_t ulDummy18; + uint8_t ucDummy19; + #endif + #if( ( configSUPPORT_STATIC_ALLOCATION == 1 ) && ( configSUPPORT_DYNAMIC_ALLOCATION == 1 ) ) + uint8_t uxDummy20; + #endif + +} StaticTask_t; + +/* + * In line with software engineering best practice, especially when supplying a + * library that is likely to change in future versions, FreeRTOS implements a + * strict data hiding policy. This means the Queue structure used internally by + * FreeRTOS is not accessible to application code. However, if the application + * writer wants to statically allocate the memory required to create a queue + * then the size of the queue object needs to be know. The StaticQueue_t + * structure below is provided for this purpose. Its sizes and alignment + * requirements are guaranteed to match those of the genuine structure, no + * matter which architecture is being used, and no matter how the values in + * FreeRTOSConfig.h are set. Its contents are somewhat obfuscated in the hope + * users will recognise that it would be unwise to make direct use of the + * structure members. + */ +typedef struct xSTATIC_QUEUE +{ + void *pvDummy1[ 3 ]; + + union + { + void *pvDummy2; + UBaseType_t uxDummy2; + } u; + + StaticList_t xDummy3[ 2 ]; + UBaseType_t uxDummy4[ 3 ]; + uint8_t ucDummy5[ 2 ]; + + #if( ( configSUPPORT_STATIC_ALLOCATION == 1 ) && ( configSUPPORT_DYNAMIC_ALLOCATION == 1 ) ) + uint8_t ucDummy6; + #endif + + #if ( configUSE_QUEUE_SETS == 1 ) + void *pvDummy7; + #endif + + #if ( configUSE_TRACE_FACILITY == 1 ) + UBaseType_t uxDummy8; + uint8_t ucDummy9; + #endif + +} StaticQueue_t; +typedef StaticQueue_t StaticSemaphore_t; + +/* + * In line with software engineering best practice, especially when supplying a + * library that is likely to change in future versions, FreeRTOS implements a + * strict data hiding policy. This means the event group structure used + * internally by FreeRTOS is not accessible to application code. However, if + * the application writer wants to statically allocate the memory required to + * create an event group then the size of the event group object needs to be + * know. The StaticEventGroup_t structure below is provided for this purpose. + * Its sizes and alignment requirements are guaranteed to match those of the + * genuine structure, no matter which architecture is being used, and no matter + * how the values in FreeRTOSConfig.h are set. Its contents are somewhat + * obfuscated in the hope users will recognise that it would be unwise to make + * direct use of the structure members. + */ +typedef struct xSTATIC_EVENT_GROUP +{ + TickType_t xDummy1; + StaticList_t xDummy2; + + #if( configUSE_TRACE_FACILITY == 1 ) + UBaseType_t uxDummy3; + #endif + + #if( ( configSUPPORT_STATIC_ALLOCATION == 1 ) && ( configSUPPORT_DYNAMIC_ALLOCATION == 1 ) ) + uint8_t ucDummy4; + #endif + +} StaticEventGroup_t; + +/* + * In line with software engineering best practice, especially when supplying a + * library that is likely to change in future versions, FreeRTOS implements a + * strict data hiding policy. This means the software timer structure used + * internally by FreeRTOS is not accessible to application code. However, if + * the application writer wants to statically allocate the memory required to + * create a software timer then the size of the queue object needs to be know. + * The StaticTimer_t structure below is provided for this purpose. Its sizes + * and alignment requirements are guaranteed to match those of the genuine + * structure, no matter which architecture is being used, and no matter how the + * values in FreeRTOSConfig.h are set. Its contents are somewhat obfuscated in + * the hope users will recognise that it would be unwise to make direct use of + * the structure members. + */ +typedef struct xSTATIC_TIMER +{ + void *pvDummy1; + StaticListItem_t xDummy2; + TickType_t xDummy3; + UBaseType_t uxDummy4; + void *pvDummy5[ 2 ]; + #if( configUSE_TRACE_FACILITY == 1 ) + UBaseType_t uxDummy6; + #endif + + #if( ( configSUPPORT_STATIC_ALLOCATION == 1 ) && ( configSUPPORT_DYNAMIC_ALLOCATION == 1 ) ) + uint8_t ucDummy7; + #endif + +} StaticTimer_t; + +#ifdef __cplusplus +} +#endif + +#endif /* INC_FREERTOS_H */ + diff --git a/FreeRTOS/include/FreeRTOSConfig.h b/FreeRTOS/include/FreeRTOSConfig.h new file mode 100644 index 0000000..f6368c8 --- /dev/null +++ b/FreeRTOS/include/FreeRTOSConfig.h @@ -0,0 +1,191 @@ +/* + FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd. + All rights reserved + + VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION. + + This file is part of the FreeRTOS distribution. + + FreeRTOS is free software; you can redistribute it and/or modify it under + the terms of the GNU General Public License (version 2) as published by the + Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception. + + *************************************************************************** + >>! NOTE: The modification to the GPL is included to allow you to !<< + >>! distribute a combined work that includes FreeRTOS without being !<< + >>! obliged to provide the source code for proprietary components !<< + >>! outside of the FreeRTOS kernel. !<< + *************************************************************************** + + FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY + WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS + FOR A PARTICULAR PURPOSE. Full license text is available on the following + link: http://www.freertos.org/a00114.html + + *************************************************************************** + * * + * FreeRTOS provides completely free yet professionally developed, * + * robust, strictly quality controlled, supported, and cross * + * platform software that is more than just the market leader, it * + * is the industry's de facto standard. * + * * + * Help yourself get started quickly while simultaneously helping * + * to support the FreeRTOS project by purchasing a FreeRTOS * + * tutorial book, reference manual, or both: * + * http://www.FreeRTOS.org/Documentation * + * * + *************************************************************************** + + http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading + the FAQ page "My application does not run, what could be wrong?". Have you + defined configASSERT()? + + http://www.FreeRTOS.org/support - In return for receiving this top quality + embedded software for free we request you assist our global community by + participating in the support forum. + + http://www.FreeRTOS.org/training - Investing in training allows your team to + be as productive as possible as early as possible. Now you can receive + FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers + Ltd, and the world's leading authority on the world's leading RTOS. + + http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products, + including FreeRTOS+Trace - an indispensable productivity tool, a DOS + compatible FAT file system, and our tiny thread aware UDP/IP stack. + + http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate. + Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS. + + http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High + Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS + licenses offer ticketed support, indemnification and commercial middleware. + + http://www.SafeRTOS.com - High Integrity Systems also provide a safety + engineered and independently SIL3 certified version for use in safety and + mission critical applications that require provable dependability. + + 1 tab == 4 spaces! +*/ + + +#ifndef FREERTOS_CONFIG_H +#define FREERTOS_CONFIG_H + +#include "sys.h" +#include "usart.h" +//针对不同的编译器调用不同的stdint.h文件 +#if defined(__ICCARM__) || defined(__CC_ARM) || defined(__GNUC__) + #include + extern uint32_t SystemCoreClock; +#endif + +//断言 +#define vAssertCalled(char,int) printf("Error:%s,%d\r\n",char,int) +#define configASSERT(x) if((x)==0) vAssertCalled(__FILE__,__LINE__) + +/***************************************************************************************************************/ +/* FreeRTOS基础配置配置选项 */ +/***************************************************************************************************************/ +#define configUSE_PREEMPTION 1 //1使用抢占式内核，0使用协程 +#define configUSE_TIME_SLICING 1 //1使能时间片调度(默认式使能的) +#define configUSE_PORT_OPTIMISED_TASK_SELECTION 1 //1启用特殊方法来选择下一个要运行的任务 + //一般是硬件计算前导零指令，如果所使用的 + //MCU没有这些硬件指令的话此宏应该设置为0！ +#define configUSE_TICKLESS_IDLE 0 //1启用低功耗tickless模式 +#define configUSE_QUEUE_SETS 1 //为1时启用队列 +#define configCPU_CLOCK_HZ (SystemCoreClock) //CPU频率 +#define configTICK_RATE_HZ (1000) //时钟节拍频率，这里设置为1000，周期就是1ms +#define configMAX_PRIORITIES (32) //可使用的最大优先级 +#define configMINIMAL_STACK_SIZE ((unsigned short)130) //空闲任务使用的堆栈大小 +#define configMAX_TASK_NAME_LEN (16) //任务名字字符串长度 + +#define configUSE_16_BIT_TICKS 0 //系统节拍计数器变量数据类型， + //1表示为16位无符号整形，0表示为32位无符号整形 +#define configIDLE_SHOULD_YIELD 1 //为1时空闲任务放弃CPU使用权给其他同优先级的用户任务 +#define configUSE_TASK_NOTIFICATIONS 1 //为1时开启任务通知功能，默认开启 +#define configUSE_MUTEXES 1 //为1时使用互斥信号量 +#define configQUEUE_REGISTRY_SIZE 8 //不为0时表示启用队列记录，具体的值是可以 + //记录的队列和信号量最大数目。 +#define configCHECK_FOR_STACK_OVERFLOW 0 //大于0时启用堆栈溢出检测功能，如果使用此功能 + //用户必须提供一个栈溢出钩子函数，如果使用的话 + //此值可以为1或者2，因为有两种栈溢出检测方法。 +#define configUSE_RECURSIVE_MUTEXES 1 //为1时使用递归互斥信号量 +#define configUSE_MALLOC_FAILED_HOOK 0 //1使用内存申请失败钩子函数 +#define configUSE_APPLICATION_TASK_TAG 0 +#define configUSE_COUNTING_SEMAPHORES 1 //为1时使用计数信号量 + +/***************************************************************************************************************/ +/* FreeRTOS与内存申请有关配置选项 */ +/***************************************************************************************************************/ +#define configSUPPORT_DYNAMIC_ALLOCATION 1 //支持动态内存申请 +#define configTOTAL_HEAP_SIZE ((size_t)(20*1024)) //系统所有总的堆大小 + +/***************************************************************************************************************/ +/* FreeRTOS与钩子函数有关的配置选项 */ +/***************************************************************************************************************/ +#define configUSE_IDLE_HOOK 0 //1，使用空闲钩子；0，不使用 +#define configUSE_TICK_HOOK 0 //1，使用时间片钩子；0，不使用 + +/***************************************************************************************************************/ +/* FreeRTOS与运行时间和任务状态收集有关的配置选项 */ +/***************************************************************************************************************/ +#define configGENERATE_RUN_TIME_STATS 0 //为1时启用运行时间统计功能 +#define configUSE_TRACE_FACILITY 1 //为1启用可视化跟踪调试 +#define configUSE_STATS_FORMATTING_FUNCTIONS 1 //与宏configUSE_TRACE_FACILITY同时为1时会编译下面3个函数 + //prvWriteNameToBuffer(),vTaskList(), + //vTaskGetRunTimeStats() + +/***************************************************************************************************************/ +/* FreeRTOS与协程有关的配置选项 */ +/***************************************************************************************************************/ +#define configUSE_CO_ROUTINES 0 //为1时启用协程，启用协程以后必须添加文件croutine.c +#define configMAX_CO_ROUTINE_PRIORITIES ( 2 ) //协程的有效优先级数目 + +/***************************************************************************************************************/ +/* FreeRTOS与软件定时器有关的配置选项 */ +/***************************************************************************************************************/ +#define configUSE_TIMERS 1 //为1时启用软件定时器 +#define configTIMER_TASK_PRIORITY (configMAX_PRIORITIES-1) //软件定时器优先级 +#define configTIMER_QUEUE_LENGTH 5 //软件定时器队列长度 +#define configTIMER_TASK_STACK_DEPTH (configMINIMAL_STACK_SIZE*2) //软件定时器任务堆栈大小 + +/***************************************************************************************************************/ +/* FreeRTOS可选函数配置选项 */ +/***************************************************************************************************************/ +#define INCLUDE_xTaskGetSchedulerState 1 +#define INCLUDE_vTaskPrioritySet 1 +#define INCLUDE_uxTaskPriorityGet 1 +#define INCLUDE_vTaskDelete 1 +#define INCLUDE_vTaskCleanUpResources 1 +#define INCLUDE_vTaskSuspend 1 +#define INCLUDE_vTaskDelayUntil 1 +#define INCLUDE_vTaskDelay 1 +#define INCLUDE_eTaskGetState 1 +#define INCLUDE_xTimerPendFunctionCall 1 + +/***************************************************************************************************************/ +/* FreeRTOS与中断有关的配置选项 */ +/***************************************************************************************************************/ +#ifdef __NVIC_PRIO_BITS + #define configPRIO_BITS __NVIC_PRIO_BITS +#else + #define configPRIO_BITS 4 +#endif + +#define configLIBRARY_LOWEST_INTERRUPT_PRIORITY 15 //中断最低优先级 +#define configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY 5 //系统可管理的最高中断优先级 +#define configKERNEL_INTERRUPT_PRIORITY ( configLIBRARY_LOWEST_INTERRUPT_PRIORITY << (8 - configPRIO_BITS) ) +#define configMAX_SYSCALL_INTERRUPT_PRIORITY ( configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY << (8 - configPRIO_BITS) ) + +/***************************************************************************************************************/ +/* FreeRTOS与中断服务函数有关的配置选项 */ +/***************************************************************************************************************/ +#define xPortPendSVHandler PendSV_Handler +#define vPortSVCHandler SVC_Handler + +//ms to OS Ticks +#define M2T(X) ((unsigned int)((X)*(configTICK_RATE_HZ/1000.0))) +#define F2T(X) ((unsigned int)((configTICK_RATE_HZ/(X)))) + +#endif /* FREERTOS_CONFIG_H */ + diff --git a/FreeRTOS/include/StackMacros.h b/FreeRTOS/include/StackMacros.h new file mode 100644 index 0000000..13c6b82 --- /dev/null +++ b/FreeRTOS/include/StackMacros.h @@ -0,0 +1,171 @@ +/* + FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd. + All rights reserved + + VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION. + + This file is part of the FreeRTOS distribution. + + FreeRTOS is free software; you can redistribute it and/or modify it under + the terms of the GNU General Public License (version 2) as published by the + Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception. + + *************************************************************************** + >>! NOTE: The modification to the GPL is included to allow you to !<< + >>! distribute a combined work that includes FreeRTOS without being !<< + >>! obliged to provide the source code for proprietary components !<< + >>! outside of the FreeRTOS kernel. !<< + *************************************************************************** + + FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY + WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS + FOR A PARTICULAR PURPOSE. Full license text is available on the following + link: http://www.freertos.org/a00114.html + + *************************************************************************** + * * + * FreeRTOS provides completely free yet professionally developed, * + * robust, strictly quality controlled, supported, and cross * + * platform software that is more than just the market leader, it * + * is the industry's de facto standard. * + * * + * Help yourself get started quickly while simultaneously helping * + * to support the FreeRTOS project by purchasing a FreeRTOS * + * tutorial book, reference manual, or both: * + * http://www.FreeRTOS.org/Documentation * + * * + *************************************************************************** + + http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading + the FAQ page "My application does not run, what could be wrong?". Have you + defined configASSERT()? + + http://www.FreeRTOS.org/support - In return for receiving this top quality + embedded software for free we request you assist our global community by + participating in the support forum. + + http://www.FreeRTOS.org/training - Investing in training allows your team to + be as productive as possible as early as possible. Now you can receive + FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers + Ltd, and the world's leading authority on the world's leading RTOS. + + http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products, + including FreeRTOS+Trace - an indispensable productivity tool, a DOS + compatible FAT file system, and our tiny thread aware UDP/IP stack. + + http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate. + Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS. + + http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High + Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS + licenses offer ticketed support, indemnification and commercial middleware. + + http://www.SafeRTOS.com - High Integrity Systems also provide a safety + engineered and independently SIL3 certified version for use in safety and + mission critical applications that require provable dependability. + + 1 tab == 4 spaces! +*/ + +#ifndef STACK_MACROS_H +#define STACK_MACROS_H + +/* + * Call the stack overflow hook function if the stack of the task being swapped + * out is currently overflowed, or looks like it might have overflowed in the + * past. + * + * Setting configCHECK_FOR_STACK_OVERFLOW to 1 will cause the macro to check + * the current stack state only - comparing the current top of stack value to + * the stack limit. Setting configCHECK_FOR_STACK_OVERFLOW to greater than 1 + * will also cause the last few stack bytes to be checked to ensure the value + * to which the bytes were set when the task was created have not been + * overwritten. Note this second test does not guarantee that an overflowed + * stack will always be recognised. + */ + +/*-----------------------------------------------------------*/ + +#if( ( configCHECK_FOR_STACK_OVERFLOW == 1 ) && ( portSTACK_GROWTH < 0 ) ) + + /* Only the current stack state is to be checked. */ + #define taskCHECK_FOR_STACK_OVERFLOW() \ + { \ + /* Is the currently saved stack pointer within the stack limit? */ \ + if( pxCurrentTCB->pxTopOfStack <= pxCurrentTCB->pxStack ) \ + { \ + vApplicationStackOverflowHook( ( TaskHandle_t ) pxCurrentTCB, pxCurrentTCB->pcTaskName ); \ + } \ + } + +#endif /* configCHECK_FOR_STACK_OVERFLOW == 1 */ +/*-----------------------------------------------------------*/ + +#if( ( configCHECK_FOR_STACK_OVERFLOW == 1 ) && ( portSTACK_GROWTH > 0 ) ) + + /* Only the current stack state is to be checked. */ + #define taskCHECK_FOR_STACK_OVERFLOW() \ + { \ + \ + /* Is the currently saved stack pointer within the stack limit? */ \ + if( pxCurrentTCB->pxTopOfStack >= pxCurrentTCB->pxEndOfStack ) \ + { \ + vApplicationStackOverflowHook( ( TaskHandle_t ) pxCurrentTCB, pxCurrentTCB->pcTaskName ); \ + } \ + } + +#endif /* configCHECK_FOR_STACK_OVERFLOW == 1 */ +/*-----------------------------------------------------------*/ + +#if( ( configCHECK_FOR_STACK_OVERFLOW > 1 ) && ( portSTACK_GROWTH < 0 ) ) + + #define taskCHECK_FOR_STACK_OVERFLOW() \ + { \ + const uint32_t * const pulStack = ( uint32_t * ) pxCurrentTCB->pxStack; \ + const uint32_t ulCheckValue = ( uint32_t ) 0xa5a5a5a5; \ + \ + if( ( pulStack[ 0 ] != ulCheckValue ) || \ + ( pulStack[ 1 ] != ulCheckValue ) || \ + ( pulStack[ 2 ] != ulCheckValue ) || \ + ( pulStack[ 3 ] != ulCheckValue ) ) \ + { \ + vApplicationStackOverflowHook( ( TaskHandle_t ) pxCurrentTCB, pxCurrentTCB->pcTaskName ); \ + } \ + } + +#endif /* #if( configCHECK_FOR_STACK_OVERFLOW > 1 ) */ +/*-----------------------------------------------------------*/ + +#if( ( configCHECK_FOR_STACK_OVERFLOW > 1 ) && ( portSTACK_GROWTH > 0 ) ) + + #define taskCHECK_FOR_STACK_OVERFLOW() \ + { \ + int8_t *pcEndOfStack = ( int8_t * ) pxCurrentTCB->pxEndOfStack; \ + static const uint8_t ucExpectedStackBytes[] = { tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE, \ + tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE, \ + tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE, \ + tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE, \ + tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE, tskSTACK_FILL_BYTE }; \ + \ + \ + pcEndOfStack -= sizeof( ucExpectedStackBytes ); \ + \ + /* Has the extremity of the task stack ever been written over? */ \ + if( memcmp( ( void * ) pcEndOfStack, ( void * ) ucExpectedStackBytes, sizeof( ucExpectedStackBytes ) ) != 0 ) \ + { \ + vApplicationStackOverflowHook( ( TaskHandle_t ) pxCurrentTCB, pxCurrentTCB->pcTaskName ); \ + } \ + } + +#endif /* #if( configCHECK_FOR_STACK_OVERFLOW > 1 ) */ +/*-----------------------------------------------------------*/ + +/* Remove stack overflow macro if not being used. */ +#ifndef taskCHECK_FOR_STACK_OVERFLOW + #define taskCHECK_FOR_STACK_OVERFLOW() +#endif + + + +#endif /* STACK_MACROS_H */ + diff --git a/FreeRTOS/include/croutine.h b/FreeRTOS/include/croutine.h new file mode 100644 index 0000000..4f003a0 --- /dev/null +++ b/FreeRTOS/include/croutine.h @@ -0,0 +1,762 @@ +/* + FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd. + All rights reserved + + VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION. + + This file is part of the FreeRTOS distribution. + + FreeRTOS is free software; you can redistribute it and/or modify it under + the terms of the GNU General Public License (version 2) as published by the + Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception. + + *************************************************************************** + >>! NOTE: The modification to the GPL is included to allow you to !<< + >>! distribute a combined work that includes FreeRTOS without being !<< + >>! obliged to provide the source code for proprietary components !<< + >>! outside of the FreeRTOS kernel. !<< + *************************************************************************** + + FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY + WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS + FOR A PARTICULAR PURPOSE. Full license text is available on the following + link: http://www.freertos.org/a00114.html + + *************************************************************************** + * * + * FreeRTOS provides completely free yet professionally developed, * + * robust, strictly quality controlled, supported, and cross * + * platform software that is more than just the market leader, it * + * is the industry's de facto standard. * + * * + * Help yourself get started quickly while simultaneously helping * + * to support the FreeRTOS project by purchasing a FreeRTOS * + * tutorial book, reference manual, or both: * + * http://www.FreeRTOS.org/Documentation * + * * + *************************************************************************** + + http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading + the FAQ page "My application does not run, what could be wrong?". Have you + defined configASSERT()? + + http://www.FreeRTOS.org/support - In return for receiving this top quality + embedded software for free we request you assist our global community by + participating in the support forum. + + http://www.FreeRTOS.org/training - Investing in training allows your team to + be as productive as possible as early as possible. Now you can receive + FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers + Ltd, and the world's leading authority on the world's leading RTOS. + + http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products, + including FreeRTOS+Trace - an indispensable productivity tool, a DOS + compatible FAT file system, and our tiny thread aware UDP/IP stack. + + http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate. + Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS. + + http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High + Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS + licenses offer ticketed support, indemnification and commercial middleware. + + http://www.SafeRTOS.com - High Integrity Systems also provide a safety + engineered and independently SIL3 certified version for use in safety and + mission critical applications that require provable dependability. + + 1 tab == 4 spaces! +*/ + +#ifndef CO_ROUTINE_H +#define CO_ROUTINE_H + +#ifndef INC_FREERTOS_H + #error "include FreeRTOS.h must appear in source files before include croutine.h" +#endif + +#include "list.h" + +#ifdef __cplusplus +extern "C" { +#endif + +/* Used to hide the implementation of the co-routine control block. The +control block structure however has to be included in the header due to +the macro implementation of the co-routine functionality. */ +typedef void * CoRoutineHandle_t; + +/* Defines the prototype to which co-routine functions must conform. */ +typedef void (*crCOROUTINE_CODE)( CoRoutineHandle_t, UBaseType_t ); + +typedef struct corCoRoutineControlBlock +{ + crCOROUTINE_CODE pxCoRoutineFunction; + ListItem_t xGenericListItem; /*< List item used to place the CRCB in ready and blocked queues. */ + ListItem_t xEventListItem; /*< List item used to place the CRCB in event lists. */ + UBaseType_t uxPriority; /*< The priority of the co-routine in relation to other co-routines. */ + UBaseType_t uxIndex; /*< Used to distinguish between co-routines when multiple co-routines use the same co-routine function. */ + uint16_t uxState; /*< Used internally by the co-routine implementation. */ +} CRCB_t; /* Co-routine control block. Note must be identical in size down to uxPriority with TCB_t. */ + +/** + * croutine. h + *
+ BaseType_t xCoRoutineCreate(
+                                 crCOROUTINE_CODE pxCoRoutineCode,
+                                 UBaseType_t uxPriority,
+                                 UBaseType_t uxIndex
+                               );
+ * + * Create a new co-routine and add it to the list of co-routines that are + * ready to run. + * + * @param pxCoRoutineCode Pointer to the co-routine function. Co-routine + * functions require special syntax - see the co-routine section of the WEB + * documentation for more information. + * + * @param uxPriority The priority with respect to other co-routines at which + * the co-routine will run. + * + * @param uxIndex Used to distinguish between different co-routines that + * execute the same function. See the example below and the co-routine section + * of the WEB documentation for further information. + * + * @return pdPASS if the co-routine was successfully created and added to a ready + * list, otherwise an error code defined with ProjDefs.h. + * + * Example usage: + 
+ // Co-routine to be created.
+ void vFlashCoRoutine( CoRoutineHandle_t xHandle, UBaseType_t uxIndex )
+ {
+ // Variables in co-routines must be declared static if they must maintain value across a blocking call.
+ // This may not be necessary for const variables.
+ static const char cLedToFlash[ 2 ] = { 5, 6 };
+ static const TickType_t uxFlashRates[ 2 ] = { 200, 400 };
+
+     // Must start every co-routine with a call to crSTART();
+     crSTART( xHandle );
+
+     for( ;; )
+     {
+         // This co-routine just delays for a fixed period, then toggles
+         // an LED.  Two co-routines are created using this function, so
+         // the uxIndex parameter is used to tell the co-routine which
+         // LED to flash and how int32_t to delay.  This assumes xQueue has
+         // already been created.
+         vParTestToggleLED( cLedToFlash[ uxIndex ] );
+         crDELAY( xHandle, uxFlashRates[ uxIndex ] );
+     }
+
+     // Must end every co-routine with a call to crEND();
+     crEND();
+ }
+
+ // Function that creates two co-routines.
+ void vOtherFunction( void )
+ {
+ uint8_t ucParameterToPass;
+ TaskHandle_t xHandle;
+
+     // Create two co-routines at priority 0.  The first is given index 0
+     // so (from the code above) toggles LED 5 every 200 ticks.  The second
+     // is given index 1 so toggles LED 6 every 400 ticks.
+     for( uxIndex = 0; uxIndex < 2; uxIndex++ )
+     {
+         xCoRoutineCreate( vFlashCoRoutine, 0, uxIndex );
+     }
+ }
+
+ * \defgroup xCoRoutineCreate xCoRoutineCreate + * \ingroup Tasks + */ +BaseType_t xCoRoutineCreate( crCOROUTINE_CODE pxCoRoutineCode, UBaseType_t uxPriority, UBaseType_t uxIndex ); + + +/** + * croutine. h + *
+ void vCoRoutineSchedule( void );
+ * + * Run a co-routine. + * + * vCoRoutineSchedule() executes the highest priority co-routine that is able + * to run. The co-routine will execute until it either blocks, yields or is + * preempted by a task. Co-routines execute cooperatively so one + * co-routine cannot be preempted by another, but can be preempted by a task. + * + * If an application comprises of both tasks and co-routines then + * vCoRoutineSchedule should be called from the idle task (in an idle task + * hook). + * + * Example usage: + 
+ // This idle task hook will schedule a co-routine each time it is called.
+ // The rest of the idle task will execute between co-routine calls.
+ void vApplicationIdleHook( void )
+ {
+	vCoRoutineSchedule();
+ }
+
+ // Alternatively, if you do not require any other part of the idle task to
+ // execute, the idle task hook can call vCoRoutineScheduler() within an
+ // infinite loop.
+ void vApplicationIdleHook( void )
+ {
+    for( ;; )
+    {
+        vCoRoutineSchedule();
+    }
+ }
+
+ * \defgroup vCoRoutineSchedule vCoRoutineSchedule + * \ingroup Tasks + */ +void vCoRoutineSchedule( void ); + +/** + * croutine. h + * 
+ crSTART( CoRoutineHandle_t xHandle );
+ * + * This macro MUST always be called at the start of a co-routine function. + * + * Example usage: + 
+ // Co-routine to be created.
+ void vACoRoutine( CoRoutineHandle_t xHandle, UBaseType_t uxIndex )
+ {
+ // Variables in co-routines must be declared static if they must maintain value across a blocking call.
+ static int32_t ulAVariable;
+
+     // Must start every co-routine with a call to crSTART();
+     crSTART( xHandle );
+
+     for( ;; )
+     {
+          // Co-routine functionality goes here.
+     }
+
+     // Must end every co-routine with a call to crEND();
+     crEND();
+ }
+ * \defgroup crSTART crSTART + * \ingroup Tasks + */ +#define crSTART( pxCRCB ) switch( ( ( CRCB_t * )( pxCRCB ) )->uxState ) { case 0: + +/** + * croutine. h + * 
+ crEND();
+ * + * This macro MUST always be called at the end of a co-routine function. + * + * Example usage: + 
+ // Co-routine to be created.
+ void vACoRoutine( CoRoutineHandle_t xHandle, UBaseType_t uxIndex )
+ {
+ // Variables in co-routines must be declared static if they must maintain value across a blocking call.
+ static int32_t ulAVariable;
+
+     // Must start every co-routine with a call to crSTART();
+     crSTART( xHandle );
+
+     for( ;; )
+     {
+          // Co-routine functionality goes here.
+     }
+
+     // Must end every co-routine with a call to crEND();
+     crEND();
+ }
+ * \defgroup crSTART crSTART + * \ingroup Tasks + */ +#define crEND() } + +/* + * These macros are intended for internal use by the co-routine implementation + * only. The macros should not be used directly by application writers. + */ +#define crSET_STATE0( xHandle ) ( ( CRCB_t * )( xHandle ) )->uxState = (__LINE__ * 2); return; case (__LINE__ * 2): +#define crSET_STATE1( xHandle ) ( ( CRCB_t * )( xHandle ) )->uxState = ((__LINE__ * 2)+1); return; case ((__LINE__ * 2)+1): + +/** + * croutine. h + *
+ crDELAY( CoRoutineHandle_t xHandle, TickType_t xTicksToDelay );
+ * + * Delay a co-routine for a fixed period of time. + * + * crDELAY can only be called from the co-routine function itself - not + * from within a function called by the co-routine function. This is because + * co-routines do not maintain their own stack. + * + * @param xHandle The handle of the co-routine to delay. This is the xHandle + * parameter of the co-routine function. + * + * @param xTickToDelay The number of ticks that the co-routine should delay + * for. The actual amount of time this equates to is defined by + * configTICK_RATE_HZ (set in FreeRTOSConfig.h). The constant portTICK_PERIOD_MS + * can be used to convert ticks to milliseconds. + * + * Example usage: + 
+ // Co-routine to be created.
+ void vACoRoutine( CoRoutineHandle_t xHandle, UBaseType_t uxIndex )
+ {
+ // Variables in co-routines must be declared static if they must maintain value across a blocking call.
+ // This may not be necessary for const variables.
+ // We are to delay for 200ms.
+ static const xTickType xDelayTime = 200 / portTICK_PERIOD_MS;
+
+     // Must start every co-routine with a call to crSTART();
+     crSTART( xHandle );
+
+     for( ;; )
+     {
+        // Delay for 200ms.
+        crDELAY( xHandle, xDelayTime );
+
+        // Do something here.
+     }
+
+     // Must end every co-routine with a call to crEND();
+     crEND();
+ }
+ * \defgroup crDELAY crDELAY + * \ingroup Tasks + */ +#define crDELAY( xHandle, xTicksToDelay ) \ + if( ( xTicksToDelay ) > 0 ) \ + { \ + vCoRoutineAddToDelayedList( ( xTicksToDelay ), NULL ); \ + } \ + crSET_STATE0( ( xHandle ) ); + +/** + * 
+ crQUEUE_SEND(
+                  CoRoutineHandle_t xHandle,
+                  QueueHandle_t pxQueue,
+                  void *pvItemToQueue,
+                  TickType_t xTicksToWait,
+                  BaseType_t *pxResult
+             )
+ * + * The macro's crQUEUE_SEND() and crQUEUE_RECEIVE() are the co-routine + * equivalent to the xQueueSend() and xQueueReceive() functions used by tasks. + * + * crQUEUE_SEND and crQUEUE_RECEIVE can only be used from a co-routine whereas + * xQueueSend() and xQueueReceive() can only be used from tasks. + * + * crQUEUE_SEND can only be called from the co-routine function itself - not + * from within a function called by the co-routine function. This is because + * co-routines do not maintain their own stack. + * + * See the co-routine section of the WEB documentation for information on + * passing data between tasks and co-routines and between ISR's and + * co-routines. + * + * @param xHandle The handle of the calling co-routine. This is the xHandle + * parameter of the co-routine function. + * + * @param pxQueue The handle of the queue on which the data will be posted. + * The handle is obtained as the return value when the queue is created using + * the xQueueCreate() API function. + * + * @param pvItemToQueue A pointer to the data being posted onto the queue. + * The number of bytes of each queued item is specified when the queue is + * created. This number of bytes is copied from pvItemToQueue into the queue + * itself. + * + * @param xTickToDelay The number of ticks that the co-routine should block + * to wait for space to become available on the queue, should space not be + * available immediately. The actual amount of time this equates to is defined + * by configTICK_RATE_HZ (set in FreeRTOSConfig.h). The constant + * portTICK_PERIOD_MS can be used to convert ticks to milliseconds (see example + * below). + * + * @param pxResult The variable pointed to by pxResult will be set to pdPASS if + * data was successfully posted onto the queue, otherwise it will be set to an + * error defined within ProjDefs.h. + * + * Example usage: + 
+ // Co-routine function that blocks for a fixed period then posts a number onto
+ // a queue.
+ static void prvCoRoutineFlashTask( CoRoutineHandle_t xHandle, UBaseType_t uxIndex )
+ {
+ // Variables in co-routines must be declared static if they must maintain value across a blocking call.
+ static BaseType_t xNumberToPost = 0;
+ static BaseType_t xResult;
+
+    // Co-routines must begin with a call to crSTART().
+    crSTART( xHandle );
+
+    for( ;; )
+    {
+        // This assumes the queue has already been created.
+        crQUEUE_SEND( xHandle, xCoRoutineQueue, &xNumberToPost, NO_DELAY, &xResult );
+
+        if( xResult != pdPASS )
+        {
+            // The message was not posted!
+        }
+
+        // Increment the number to be posted onto the queue.
+        xNumberToPost++;
+
+        // Delay for 100 ticks.
+        crDELAY( xHandle, 100 );
+    }
+
+    // Co-routines must end with a call to crEND().
+    crEND();
+ }
+ * \defgroup crQUEUE_SEND crQUEUE_SEND + * \ingroup Tasks + */ +#define crQUEUE_SEND( xHandle, pxQueue, pvItemToQueue, xTicksToWait, pxResult ) \ +{ \ + *( pxResult ) = xQueueCRSend( ( pxQueue) , ( pvItemToQueue) , ( xTicksToWait ) ); \ + if( *( pxResult ) == errQUEUE_BLOCKED ) \ + { \ + crSET_STATE0( ( xHandle ) ); \ + *pxResult = xQueueCRSend( ( pxQueue ), ( pvItemToQueue ), 0 ); \ + } \ + if( *pxResult == errQUEUE_YIELD ) \ + { \ + crSET_STATE1( ( xHandle ) ); \ + *pxResult = pdPASS; \ + } \ +} + +/** + * croutine. h + * 
+  crQUEUE_RECEIVE(
+                     CoRoutineHandle_t xHandle,
+                     QueueHandle_t pxQueue,
+                     void *pvBuffer,
+                     TickType_t xTicksToWait,
+                     BaseType_t *pxResult
+                 )
+ * + * The macro's crQUEUE_SEND() and crQUEUE_RECEIVE() are the co-routine + * equivalent to the xQueueSend() and xQueueReceive() functions used by tasks. + * + * crQUEUE_SEND and crQUEUE_RECEIVE can only be used from a co-routine whereas + * xQueueSend() and xQueueReceive() can only be used from tasks. + * + * crQUEUE_RECEIVE can only be called from the co-routine function itself - not + * from within a function called by the co-routine function. This is because + * co-routines do not maintain their own stack. + * + * See the co-routine section of the WEB documentation for information on + * passing data between tasks and co-routines and between ISR's and + * co-routines. + * + * @param xHandle The handle of the calling co-routine. This is the xHandle + * parameter of the co-routine function. + * + * @param pxQueue The handle of the queue from which the data will be received. + * The handle is obtained as the return value when the queue is created using + * the xQueueCreate() API function. + * + * @param pvBuffer The buffer into which the received item is to be copied. + * The number of bytes of each queued item is specified when the queue is + * created. This number of bytes is copied into pvBuffer. + * + * @param xTickToDelay The number of ticks that the co-routine should block + * to wait for data to become available from the queue, should data not be + * available immediately. The actual amount of time this equates to is defined + * by configTICK_RATE_HZ (set in FreeRTOSConfig.h). The constant + * portTICK_PERIOD_MS can be used to convert ticks to milliseconds (see the + * crQUEUE_SEND example). + * + * @param pxResult The variable pointed to by pxResult will be set to pdPASS if + * data was successfully retrieved from the queue, otherwise it will be set to + * an error code as defined within ProjDefs.h. + * + * Example usage: + 
+ // A co-routine receives the number of an LED to flash from a queue.  It
+ // blocks on the queue until the number is received.
+ static void prvCoRoutineFlashWorkTask( CoRoutineHandle_t xHandle, UBaseType_t uxIndex )
+ {
+ // Variables in co-routines must be declared static if they must maintain value across a blocking call.
+ static BaseType_t xResult;
+ static UBaseType_t uxLEDToFlash;
+
+    // All co-routines must start with a call to crSTART().
+    crSTART( xHandle );
+
+    for( ;; )
+    {
+        // Wait for data to become available on the queue.
+        crQUEUE_RECEIVE( xHandle, xCoRoutineQueue, &uxLEDToFlash, portMAX_DELAY, &xResult );
+
+        if( xResult == pdPASS )
+        {
+            // We received the LED to flash - flash it!
+            vParTestToggleLED( uxLEDToFlash );
+        }
+    }
+
+    crEND();
+ }
+ * \defgroup crQUEUE_RECEIVE crQUEUE_RECEIVE + * \ingroup Tasks + */ +#define crQUEUE_RECEIVE( xHandle, pxQueue, pvBuffer, xTicksToWait, pxResult ) \ +{ \ + *( pxResult ) = xQueueCRReceive( ( pxQueue) , ( pvBuffer ), ( xTicksToWait ) ); \ + if( *( pxResult ) == errQUEUE_BLOCKED ) \ + { \ + crSET_STATE0( ( xHandle ) ); \ + *( pxResult ) = xQueueCRReceive( ( pxQueue) , ( pvBuffer ), 0 ); \ + } \ + if( *( pxResult ) == errQUEUE_YIELD ) \ + { \ + crSET_STATE1( ( xHandle ) ); \ + *( pxResult ) = pdPASS; \ + } \ +} + +/** + * croutine. h + * 
+  crQUEUE_SEND_FROM_ISR(
+                            QueueHandle_t pxQueue,
+                            void *pvItemToQueue,
+                            BaseType_t xCoRoutinePreviouslyWoken
+                       )
+ * + * The macro's crQUEUE_SEND_FROM_ISR() and crQUEUE_RECEIVE_FROM_ISR() are the + * co-routine equivalent to the xQueueSendFromISR() and xQueueReceiveFromISR() + * functions used by tasks. + * + * crQUEUE_SEND_FROM_ISR() and crQUEUE_RECEIVE_FROM_ISR() can only be used to + * pass data between a co-routine and and ISR, whereas xQueueSendFromISR() and + * xQueueReceiveFromISR() can only be used to pass data between a task and and + * ISR. + * + * crQUEUE_SEND_FROM_ISR can only be called from an ISR to send data to a queue + * that is being used from within a co-routine. + * + * See the co-routine section of the WEB documentation for information on + * passing data between tasks and co-routines and between ISR's and + * co-routines. + * + * @param xQueue The handle to the queue on which the item is to be posted. + * + * @param pvItemToQueue A pointer to the item that is to be placed on the + * queue. The size of the items the queue will hold was defined when the + * queue was created, so this many bytes will be copied from pvItemToQueue + * into the queue storage area. + * + * @param xCoRoutinePreviouslyWoken This is included so an ISR can post onto + * the same queue multiple times from a single interrupt. The first call + * should always pass in pdFALSE. Subsequent calls should pass in + * the value returned from the previous call. + * + * @return pdTRUE if a co-routine was woken by posting onto the queue. This is + * used by the ISR to determine if a context switch may be required following + * the ISR. + * + * Example usage: + 
+ // A co-routine that blocks on a queue waiting for characters to be received.
+ static void vReceivingCoRoutine( CoRoutineHandle_t xHandle, UBaseType_t uxIndex )
+ {
+ char cRxedChar;
+ BaseType_t xResult;
+
+     // All co-routines must start with a call to crSTART().
+     crSTART( xHandle );
+
+     for( ;; )
+     {
+         // Wait for data to become available on the queue.  This assumes the
+         // queue xCommsRxQueue has already been created!
+         crQUEUE_RECEIVE( xHandle, xCommsRxQueue, &uxLEDToFlash, portMAX_DELAY, &xResult );
+
+         // Was a character received?
+         if( xResult == pdPASS )
+         {
+             // Process the character here.
+         }
+     }
+
+     // All co-routines must end with a call to crEND().
+     crEND();
+ }
+
+ // An ISR that uses a queue to send characters received on a serial port to
+ // a co-routine.
+ void vUART_ISR( void )
+ {
+ char cRxedChar;
+ BaseType_t xCRWokenByPost = pdFALSE;
+
+     // We loop around reading characters until there are none left in the UART.
+     while( UART_RX_REG_NOT_EMPTY() )
+     {
+         // Obtain the character from the UART.
+         cRxedChar = UART_RX_REG;
+
+         // Post the character onto a queue.  xCRWokenByPost will be pdFALSE
+         // the first time around the loop.  If the post causes a co-routine
+         // to be woken (unblocked) then xCRWokenByPost will be set to pdTRUE.
+         // In this manner we can ensure that if more than one co-routine is
+         // blocked on the queue only one is woken by this ISR no matter how
+         // many characters are posted to the queue.
+         xCRWokenByPost = crQUEUE_SEND_FROM_ISR( xCommsRxQueue, &cRxedChar, xCRWokenByPost );
+     }
+ }
+ * \defgroup crQUEUE_SEND_FROM_ISR crQUEUE_SEND_FROM_ISR + * \ingroup Tasks + */ +#define crQUEUE_SEND_FROM_ISR( pxQueue, pvItemToQueue, xCoRoutinePreviouslyWoken ) xQueueCRSendFromISR( ( pxQueue ), ( pvItemToQueue ), ( xCoRoutinePreviouslyWoken ) ) + + +/** + * croutine. h + * 
+  crQUEUE_SEND_FROM_ISR(
+                            QueueHandle_t pxQueue,
+                            void *pvBuffer,
+                            BaseType_t * pxCoRoutineWoken
+                       )
+ * + * The macro's crQUEUE_SEND_FROM_ISR() and crQUEUE_RECEIVE_FROM_ISR() are the + * co-routine equivalent to the xQueueSendFromISR() and xQueueReceiveFromISR() + * functions used by tasks. + * + * crQUEUE_SEND_FROM_ISR() and crQUEUE_RECEIVE_FROM_ISR() can only be used to + * pass data between a co-routine and and ISR, whereas xQueueSendFromISR() and + * xQueueReceiveFromISR() can only be used to pass data between a task and and + * ISR. + * + * crQUEUE_RECEIVE_FROM_ISR can only be called from an ISR to receive data + * from a queue that is being used from within a co-routine (a co-routine + * posted to the queue). + * + * See the co-routine section of the WEB documentation for information on + * passing data between tasks and co-routines and between ISR's and + * co-routines. + * + * @param xQueue The handle to the queue on which the item is to be posted. + * + * @param pvBuffer A pointer to a buffer into which the received item will be + * placed. The size of the items the queue will hold was defined when the + * queue was created, so this many bytes will be copied from the queue into + * pvBuffer. + * + * @param pxCoRoutineWoken A co-routine may be blocked waiting for space to become + * available on the queue. If crQUEUE_RECEIVE_FROM_ISR causes such a + * co-routine to unblock *pxCoRoutineWoken will get set to pdTRUE, otherwise + * *pxCoRoutineWoken will remain unchanged. + * + * @return pdTRUE an item was successfully received from the queue, otherwise + * pdFALSE. + * + * Example usage: + 
+ // A co-routine that posts a character to a queue then blocks for a fixed
+ // period.  The character is incremented each time.
+ static void vSendingCoRoutine( CoRoutineHandle_t xHandle, UBaseType_t uxIndex )
+ {
+ // cChar holds its value while this co-routine is blocked and must therefore
+ // be declared static.
+ static char cCharToTx = 'a';
+ BaseType_t xResult;
+
+     // All co-routines must start with a call to crSTART().
+     crSTART( xHandle );
+
+     for( ;; )
+     {
+         // Send the next character to the queue.
+         crQUEUE_SEND( xHandle, xCoRoutineQueue, &cCharToTx, NO_DELAY, &xResult );
+
+         if( xResult == pdPASS )
+         {
+             // The character was successfully posted to the queue.
+         }
+		 else
+		 {
+			// Could not post the character to the queue.
+		 }
+
+         // Enable the UART Tx interrupt to cause an interrupt in this
+		 // hypothetical UART.  The interrupt will obtain the character
+		 // from the queue and send it.
+		 ENABLE_RX_INTERRUPT();
+
+		 // Increment to the next character then block for a fixed period.
+		 // cCharToTx will maintain its value across the delay as it is
+		 // declared static.
+		 cCharToTx++;
+		 if( cCharToTx > 'x' )
+		 {
+			cCharToTx = 'a';
+		 }
+		 crDELAY( 100 );
+     }
+
+     // All co-routines must end with a call to crEND().
+     crEND();
+ }
+
+ // An ISR that uses a queue to receive characters to send on a UART.
+ void vUART_ISR( void )
+ {
+ char cCharToTx;
+ BaseType_t xCRWokenByPost = pdFALSE;
+
+     while( UART_TX_REG_EMPTY() )
+     {
+         // Are there any characters in the queue waiting to be sent?
+		 // xCRWokenByPost will automatically be set to pdTRUE if a co-routine
+		 // is woken by the post - ensuring that only a single co-routine is
+		 // woken no matter how many times we go around this loop.
+         if( crQUEUE_RECEIVE_FROM_ISR( pxQueue, &cCharToTx, &xCRWokenByPost ) )
+		 {
+			 SEND_CHARACTER( cCharToTx );
+		 }
+     }
+ }
+ * \defgroup crQUEUE_RECEIVE_FROM_ISR crQUEUE_RECEIVE_FROM_ISR + * \ingroup Tasks + */ +#define crQUEUE_RECEIVE_FROM_ISR( pxQueue, pvBuffer, pxCoRoutineWoken ) xQueueCRReceiveFromISR( ( pxQueue ), ( pvBuffer ), ( pxCoRoutineWoken ) ) + +/* + * This function is intended for internal use by the co-routine macros only. + * The macro nature of the co-routine implementation requires that the + * prototype appears here. The function should not be used by application + * writers. + * + * Removes the current co-routine from its ready list and places it in the + * appropriate delayed list. + */ +void vCoRoutineAddToDelayedList( TickType_t xTicksToDelay, List_t *pxEventList ); + +/* + * This function is intended for internal use by the queue implementation only. + * The function should not be used by application writers. + * + * Removes the highest priority co-routine from the event list and places it in + * the pending ready list. + */ +BaseType_t xCoRoutineRemoveFromEventList( const List_t *pxEventList ); + +#ifdef __cplusplus +} +#endif + +#endif /* CO_ROUTINE_H */ diff --git a/FreeRTOS/include/deprecated_definitions.h b/FreeRTOS/include/deprecated_definitions.h new file mode 100644 index 0000000..4ea816c --- /dev/null +++ b/FreeRTOS/include/deprecated_definitions.h @@ -0,0 +1,321 @@ +/* + FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd. + All rights reserved + + VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION. + + This file is part of the FreeRTOS distribution. + + FreeRTOS is free software; you can redistribute it and/or modify it under + the terms of the GNU General Public License (version 2) as published by the + Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception. + + *************************************************************************** + >>! NOTE: The modification to the GPL is included to allow you to !<< + >>! distribute a combined work that includes FreeRTOS without being !<< + >>! obliged to provide the source code for proprietary components !<< + >>! outside of the FreeRTOS kernel. !<< + *************************************************************************** + + FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY + WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS + FOR A PARTICULAR PURPOSE. Full license text is available on the following + link: http://www.freertos.org/a00114.html + + *************************************************************************** + * * + * FreeRTOS provides completely free yet professionally developed, * + * robust, strictly quality controlled, supported, and cross * + * platform software that is more than just the market leader, it * + * is the industry's de facto standard. * + * * + * Help yourself get started quickly while simultaneously helping * + * to support the FreeRTOS project by purchasing a FreeRTOS * + * tutorial book, reference manual, or both: * + * http://www.FreeRTOS.org/Documentation * + * * + *************************************************************************** + + http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading + the FAQ page "My application does not run, what could be wrong?". Have you + defined configASSERT()? + + http://www.FreeRTOS.org/support - In return for receiving this top quality + embedded software for free we request you assist our global community by + participating in the support forum. + + http://www.FreeRTOS.org/training - Investing in training allows your team to + be as productive as possible as early as possible. Now you can receive + FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers + Ltd, and the world's leading authority on the world's leading RTOS. + + http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products, + including FreeRTOS+Trace - an indispensable productivity tool, a DOS + compatible FAT file system, and our tiny thread aware UDP/IP stack. + + http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate. + Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS. + + http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High + Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS + licenses offer ticketed support, indemnification and commercial middleware. + + http://www.SafeRTOS.com - High Integrity Systems also provide a safety + engineered and independently SIL3 certified version for use in safety and + mission critical applications that require provable dependability. + + 1 tab == 4 spaces! +*/ + +#ifndef DEPRECATED_DEFINITIONS_H +#define DEPRECATED_DEFINITIONS_H + + +/* Each FreeRTOS port has a unique portmacro.h header file. Originally a +pre-processor definition was used to ensure the pre-processor found the correct +portmacro.h file for the port being used. That scheme was deprecated in favour +of setting the compiler's include path such that it found the correct +portmacro.h file - removing the need for the constant and allowing the +portmacro.h file to be located anywhere in relation to the port being used. The +definitions below remain in the code for backward compatibility only. New +projects should not use them. */ + +#ifdef OPEN_WATCOM_INDUSTRIAL_PC_PORT + #include "..\..\Source\portable\owatcom\16bitdos\pc\portmacro.h" + typedef void ( __interrupt __far *pxISR )(); +#endif + +#ifdef OPEN_WATCOM_FLASH_LITE_186_PORT + #include "..\..\Source\portable\owatcom\16bitdos\flsh186\portmacro.h" + typedef void ( __interrupt __far *pxISR )(); +#endif + +#ifdef GCC_MEGA_AVR + #include "../portable/GCC/ATMega323/portmacro.h" +#endif + +#ifdef IAR_MEGA_AVR + #include "../portable/IAR/ATMega323/portmacro.h" +#endif + +#ifdef MPLAB_PIC24_PORT + #include "../../Source/portable/MPLAB/PIC24_dsPIC/portmacro.h" +#endif + +#ifdef MPLAB_DSPIC_PORT + #include "../../Source/portable/MPLAB/PIC24_dsPIC/portmacro.h" +#endif + +#ifdef MPLAB_PIC18F_PORT + #include "../../Source/portable/MPLAB/PIC18F/portmacro.h" +#endif + +#ifdef MPLAB_PIC32MX_PORT + #include "../../Source/portable/MPLAB/PIC32MX/portmacro.h" +#endif + +#ifdef _FEDPICC + #include "libFreeRTOS/Include/portmacro.h" +#endif + +#ifdef SDCC_CYGNAL + #include "../../Source/portable/SDCC/Cygnal/portmacro.h" +#endif + +#ifdef GCC_ARM7 + #include "../../Source/portable/GCC/ARM7_LPC2000/portmacro.h" +#endif + +#ifdef GCC_ARM7_ECLIPSE + #include "portmacro.h" +#endif + +#ifdef ROWLEY_LPC23xx + #include "../../Source/portable/GCC/ARM7_LPC23xx/portmacro.h" +#endif + +#ifdef IAR_MSP430 + #include "..\..\Source\portable\IAR\MSP430\portmacro.h" +#endif + +#ifdef GCC_MSP430 + #include "../../Source/portable/GCC/MSP430F449/portmacro.h" +#endif + +#ifdef ROWLEY_MSP430 + #include "../../Source/portable/Rowley/MSP430F449/portmacro.h" +#endif + +#ifdef ARM7_LPC21xx_KEIL_RVDS + #include "..\..\Source\portable\RVDS\ARM7_LPC21xx\portmacro.h" +#endif + +#ifdef SAM7_GCC + #include "../../Source/portable/GCC/ARM7_AT91SAM7S/portmacro.h" +#endif + +#ifdef SAM7_IAR + #include "..\..\Source\portable\IAR\AtmelSAM7S64\portmacro.h" +#endif + +#ifdef SAM9XE_IAR + #include "..\..\Source\portable\IAR\AtmelSAM9XE\portmacro.h" +#endif + +#ifdef LPC2000_IAR + #include "..\..\Source\portable\IAR\LPC2000\portmacro.h" +#endif + +#ifdef STR71X_IAR + #include "..\..\Source\portable\IAR\STR71x\portmacro.h" +#endif + +#ifdef STR75X_IAR + #include "..\..\Source\portable\IAR\STR75x\portmacro.h" +#endif + +#ifdef STR75X_GCC + #include "..\..\Source\portable\GCC\STR75x\portmacro.h" +#endif + +#ifdef STR91X_IAR + #include "..\..\Source\portable\IAR\STR91x\portmacro.h" +#endif + +#ifdef GCC_H8S + #include "../../Source/portable/GCC/H8S2329/portmacro.h" +#endif + +#ifdef GCC_AT91FR40008 + #include "../../Source/portable/GCC/ARM7_AT91FR40008/portmacro.h" +#endif + +#ifdef RVDS_ARMCM3_LM3S102 + #include "../../Source/portable/RVDS/ARM_CM3/portmacro.h" +#endif + +#ifdef GCC_ARMCM3_LM3S102 + #include "../../Source/portable/GCC/ARM_CM3/portmacro.h" +#endif + +#ifdef GCC_ARMCM3 + #include "../../Source/portable/GCC/ARM_CM3/portmacro.h" +#endif + +#ifdef IAR_ARM_CM3 + #include "../../Source/portable/IAR/ARM_CM3/portmacro.h" +#endif + +#ifdef IAR_ARMCM3_LM + #include "../../Source/portable/IAR/ARM_CM3/portmacro.h" +#endif + +#ifdef HCS12_CODE_WARRIOR + #include "../../Source/portable/CodeWarrior/HCS12/portmacro.h" +#endif + +#ifdef MICROBLAZE_GCC + #include "../../Source/portable/GCC/MicroBlaze/portmacro.h" +#endif + +#ifdef TERN_EE + #include "..\..\Source\portable\Paradigm\Tern_EE\small\portmacro.h" +#endif + +#ifdef GCC_HCS12 + #include "../../Source/portable/GCC/HCS12/portmacro.h" +#endif + +#ifdef GCC_MCF5235 + #include "../../Source/portable/GCC/MCF5235/portmacro.h" +#endif + +#ifdef COLDFIRE_V2_GCC + #include "../../../Source/portable/GCC/ColdFire_V2/portmacro.h" +#endif + +#ifdef COLDFIRE_V2_CODEWARRIOR + #include "../../Source/portable/CodeWarrior/ColdFire_V2/portmacro.h" +#endif + +#ifdef GCC_PPC405 + #include "../../Source/portable/GCC/PPC405_Xilinx/portmacro.h" +#endif + +#ifdef GCC_PPC440 + #include "../../Source/portable/GCC/PPC440_Xilinx/portmacro.h" +#endif + +#ifdef _16FX_SOFTUNE + #include "..\..\Source\portable\Softune\MB96340\portmacro.h" +#endif + +#ifdef BCC_INDUSTRIAL_PC_PORT + /* A short file name has to be used in place of the normal + FreeRTOSConfig.h when using the Borland compiler. */ + #include "frconfig.h" + #include "..\portable\BCC\16BitDOS\PC\prtmacro.h" + typedef void ( __interrupt __far *pxISR )(); +#endif + +#ifdef BCC_FLASH_LITE_186_PORT + /* A short file name has to be used in place of the normal + FreeRTOSConfig.h when using the Borland compiler. */ + #include "frconfig.h" + #include "..\portable\BCC\16BitDOS\flsh186\prtmacro.h" + typedef void ( __interrupt __far *pxISR )(); +#endif + +#ifdef __GNUC__ + #ifdef __AVR32_AVR32A__ + #include "portmacro.h" + #endif +#endif + +#ifdef __ICCAVR32__ + #ifdef __CORE__ + #if __CORE__ == __AVR32A__ + #include "portmacro.h" + #endif + #endif +#endif + +#ifdef __91467D + #include "portmacro.h" +#endif + +#ifdef __96340 + #include "portmacro.h" +#endif + + +#ifdef __IAR_V850ES_Fx3__ + #include "../../Source/portable/IAR/V850ES/portmacro.h" +#endif + +#ifdef __IAR_V850ES_Jx3__ + #include "../../Source/portable/IAR/V850ES/portmacro.h" +#endif + +#ifdef __IAR_V850ES_Jx3_L__ + #include "../../Source/portable/IAR/V850ES/portmacro.h" +#endif + +#ifdef __IAR_V850ES_Jx2__ + #include "../../Source/portable/IAR/V850ES/portmacro.h" +#endif + +#ifdef __IAR_V850ES_Hx2__ + #include "../../Source/portable/IAR/V850ES/portmacro.h" +#endif + +#ifdef __IAR_78K0R_Kx3__ + #include "../../Source/portable/IAR/78K0R/portmacro.h" +#endif + +#ifdef __IAR_78K0R_Kx3L__ + #include "../../Source/portable/IAR/78K0R/portmacro.h" +#endif + +#endif /* DEPRECATED_DEFINITIONS_H */ + diff --git a/FreeRTOS/include/event_groups.h b/FreeRTOS/include/event_groups.h new file mode 100644 index 0000000..7331c91 --- /dev/null +++ b/FreeRTOS/include/event_groups.h @@ -0,0 +1,797 @@ +/* + FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd. + All rights reserved + + VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION. + + This file is part of the FreeRTOS distribution. + + FreeRTOS is free software; you can redistribute it and/or modify it under + the terms of the GNU General Public License (version 2) as published by the + Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception. + + *************************************************************************** + >>! NOTE: The modification to the GPL is included to allow you to !<< + >>! distribute a combined work that includes FreeRTOS without being !<< + >>! obliged to provide the source code for proprietary components !<< + >>! outside of the FreeRTOS kernel. !<< + *************************************************************************** + + FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY + WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS + FOR A PARTICULAR PURPOSE. Full license text is available on the following + link: http://www.freertos.org/a00114.html + + *************************************************************************** + * * + * FreeRTOS provides completely free yet professionally developed, * + * robust, strictly quality controlled, supported, and cross * + * platform software that is more than just the market leader, it * + * is the industry's de facto standard. * + * * + * Help yourself get started quickly while simultaneously helping * + * to support the FreeRTOS project by purchasing a FreeRTOS * + * tutorial book, reference manual, or both: * + * http://www.FreeRTOS.org/Documentation * + * * + *************************************************************************** + + http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading + the FAQ page "My application does not run, what could be wrong?". Have you + defined configASSERT()? + + http://www.FreeRTOS.org/support - In return for receiving this top quality + embedded software for free we request you assist our global community by + participating in the support forum. + + http://www.FreeRTOS.org/training - Investing in training allows your team to + be as productive as possible as early as possible. Now you can receive + FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers + Ltd, and the world's leading authority on the world's leading RTOS. + + http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products, + including FreeRTOS+Trace - an indispensable productivity tool, a DOS + compatible FAT file system, and our tiny thread aware UDP/IP stack. + + http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate. + Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS. + + http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High + Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS + licenses offer ticketed support, indemnification and commercial middleware. + + http://www.SafeRTOS.com - High Integrity Systems also provide a safety + engineered and independently SIL3 certified version for use in safety and + mission critical applications that require provable dependability. + + 1 tab == 4 spaces! +*/ + +#ifndef EVENT_GROUPS_H +#define EVENT_GROUPS_H + +#ifndef INC_FREERTOS_H + #error "include FreeRTOS.h" must appear in source files before "include event_groups.h" +#endif + +/* FreeRTOS includes. */ +#include "timers.h" + +#ifdef __cplusplus +extern "C" { +#endif + +/** + * An event group is a collection of bits to which an application can assign a + * meaning. For example, an application may create an event group to convey + * the status of various CAN bus related events in which bit 0 might mean "A CAN + * message has been received and is ready for processing", bit 1 might mean "The + * application has queued a message that is ready for sending onto the CAN + * network", and bit 2 might mean "It is time to send a SYNC message onto the + * CAN network" etc. A task can then test the bit values to see which events + * are active, and optionally enter the Blocked state to wait for a specified + * bit or a group of specified bits to be active. To continue the CAN bus + * example, a CAN controlling task can enter the Blocked state (and therefore + * not consume any processing time) until either bit 0, bit 1 or bit 2 are + * active, at which time the bit that was actually active would inform the task + * which action it had to take (process a received message, send a message, or + * send a SYNC). + * + * The event groups implementation contains intelligence to avoid race + * conditions that would otherwise occur were an application to use a simple + * variable for the same purpose. This is particularly important with respect + * to when a bit within an event group is to be cleared, and when bits have to + * be set and then tested atomically - as is the case where event groups are + * used to create a synchronisation point between multiple tasks (a + * 'rendezvous'). + * + * \defgroup EventGroup + */ + + + +/** + * event_groups.h + * + * Type by which event groups are referenced. For example, a call to + * xEventGroupCreate() returns an EventGroupHandle_t variable that can then + * be used as a parameter to other event group functions. + * + * \defgroup EventGroupHandle_t EventGroupHandle_t + * \ingroup EventGroup + */ +typedef void * EventGroupHandle_t; + +/* + * The type that holds event bits always matches TickType_t - therefore the + * number of bits it holds is set by configUSE_16_BIT_TICKS (16 bits if set to 1, + * 32 bits if set to 0. + * + * \defgroup EventBits_t EventBits_t + * \ingroup EventGroup + */ +typedef TickType_t EventBits_t; + +/** + * event_groups.h + *
+ EventGroupHandle_t xEventGroupCreate( void );
+
+ * + * Create a new event group. + * + * Internally, within the FreeRTOS implementation, event groups use a [small] + * block of memory, in which the event group's structure is stored. If an event + * groups is created using xEventGropuCreate() then the required memory is + * automatically dynamically allocated inside the xEventGroupCreate() function. + * (see http://www.freertos.org/a00111.html). If an event group is created + * using xEventGropuCreateStatic() then the application writer must instead + * provide the memory that will get used by the event group. + * xEventGroupCreateStatic() therefore allows an event group to be created + * without using any dynamic memory allocation. + * + * Although event groups are not related to ticks, for internal implementation + * reasons the number of bits available for use in an event group is dependent + * on the configUSE_16_BIT_TICKS setting in FreeRTOSConfig.h. If + * configUSE_16_BIT_TICKS is 1 then each event group contains 8 usable bits (bit + * 0 to bit 7). If configUSE_16_BIT_TICKS is set to 0 then each event group has + * 24 usable bits (bit 0 to bit 23). The EventBits_t type is used to store + * event bits within an event group. + * + * @return If the event group was created then a handle to the event group is + * returned. If there was insufficient FreeRTOS heap available to create the + * event group then NULL is returned. See http://www.freertos.org/a00111.html + * + * Example usage: + 
+	// Declare a variable to hold the created event group.
+	EventGroupHandle_t xCreatedEventGroup;
+
+	// Attempt to create the event group.
+	xCreatedEventGroup = xEventGroupCreate();
+
+	// Was the event group created successfully?
+	if( xCreatedEventGroup == NULL )
+	{
+		// The event group was not created because there was insufficient
+		// FreeRTOS heap available.
+	}
+	else
+	{
+		// The event group was created.
+	}
+
+ * \defgroup xEventGroupCreate xEventGroupCreate + * \ingroup EventGroup + */ +#if( configSUPPORT_DYNAMIC_ALLOCATION == 1 ) + EventGroupHandle_t xEventGroupCreate( void ) PRIVILEGED_FUNCTION; +#endif + +/** + * event_groups.h + *
+ EventGroupHandle_t xEventGroupCreateStatic( EventGroupHandle_t * pxEventGroupBuffer );
+
+ * + * Create a new event group. + * + * Internally, within the FreeRTOS implementation, event groups use a [small] + * block of memory, in which the event group's structure is stored. If an event + * groups is created using xEventGropuCreate() then the required memory is + * automatically dynamically allocated inside the xEventGroupCreate() function. + * (see http://www.freertos.org/a00111.html). If an event group is created + * using xEventGropuCreateStatic() then the application writer must instead + * provide the memory that will get used by the event group. + * xEventGroupCreateStatic() therefore allows an event group to be created + * without using any dynamic memory allocation. + * + * Although event groups are not related to ticks, for internal implementation + * reasons the number of bits available for use in an event group is dependent + * on the configUSE_16_BIT_TICKS setting in FreeRTOSConfig.h. If + * configUSE_16_BIT_TICKS is 1 then each event group contains 8 usable bits (bit + * 0 to bit 7). If configUSE_16_BIT_TICKS is set to 0 then each event group has + * 24 usable bits (bit 0 to bit 23). The EventBits_t type is used to store + * event bits within an event group. + * + * @param pxEventGroupBuffer pxEventGroupBuffer must point to a variable of type + * StaticEventGroup_t, which will be then be used to hold the event group's data + * structures, removing the need for the memory to be allocated dynamically. + * + * @return If the event group was created then a handle to the event group is + * returned. If pxEventGroupBuffer was NULL then NULL is returned. + * + * Example usage: + 
+	// StaticEventGroup_t is a publicly accessible structure that has the same
+	// size and alignment requirements as the real event group structure.  It is
+	// provided as a mechanism for applications to know the size of the event
+	// group (which is dependent on the architecture and configuration file
+	// settings) without breaking the strict data hiding policy by exposing the
+	// real event group internals.  This StaticEventGroup_t variable is passed
+	// into the xSemaphoreCreateEventGroupStatic() function and is used to store
+	// the event group's data structures
+	StaticEventGroup_t xEventGroupBuffer;
+
+	// Create the event group without dynamically allocating any memory.
+	xEventGroup = xEventGroupCreateStatic( &xEventGroupBuffer );
+
+ */ +#if( configSUPPORT_STATIC_ALLOCATION == 1 ) + EventGroupHandle_t xEventGroupCreateStatic( StaticEventGroup_t *pxEventGroupBuffer ) PRIVILEGED_FUNCTION; +#endif + +/** + * event_groups.h + *
+	EventBits_t xEventGroupWaitBits( 	EventGroupHandle_t xEventGroup,
+										const EventBits_t uxBitsToWaitFor,
+										const BaseType_t xClearOnExit,
+										const BaseType_t xWaitForAllBits,
+										const TickType_t xTicksToWait );
+
+ * + * [Potentially] block to wait for one or more bits to be set within a + * previously created event group. + * + * This function cannot be called from an interrupt. + * + * @param xEventGroup The event group in which the bits are being tested. The + * event group must have previously been created using a call to + * xEventGroupCreate(). + * + * @param uxBitsToWaitFor A bitwise value that indicates the bit or bits to test + * inside the event group. For example, to wait for bit 0 and/or bit 2 set + * uxBitsToWaitFor to 0x05. To wait for bits 0 and/or bit 1 and/or bit 2 set + * uxBitsToWaitFor to 0x07. Etc. + * + * @param xClearOnExit If xClearOnExit is set to pdTRUE then any bits within + * uxBitsToWaitFor that are set within the event group will be cleared before + * xEventGroupWaitBits() returns if the wait condition was met (if the function + * returns for a reason other than a timeout). If xClearOnExit is set to + * pdFALSE then the bits set in the event group are not altered when the call to + * xEventGroupWaitBits() returns. + * + * @param xWaitForAllBits If xWaitForAllBits is set to pdTRUE then + * xEventGroupWaitBits() will return when either all the bits in uxBitsToWaitFor + * are set or the specified block time expires. If xWaitForAllBits is set to + * pdFALSE then xEventGroupWaitBits() will return when any one of the bits set + * in uxBitsToWaitFor is set or the specified block time expires. The block + * time is specified by the xTicksToWait parameter. + * + * @param xTicksToWait The maximum amount of time (specified in 'ticks') to wait + * for one/all (depending on the xWaitForAllBits value) of the bits specified by + * uxBitsToWaitFor to become set. + * + * @return The value of the event group at the time either the bits being waited + * for became set, or the block time expired. Test the return value to know + * which bits were set. If xEventGroupWaitBits() returned because its timeout + * expired then not all the bits being waited for will be set. If + * xEventGroupWaitBits() returned because the bits it was waiting for were set + * then the returned value is the event group value before any bits were + * automatically cleared in the case that xClearOnExit parameter was set to + * pdTRUE. + * + * Example usage: + 
+   #define BIT_0	( 1 << 0 )
+   #define BIT_4	( 1 << 4 )
+
+   void aFunction( EventGroupHandle_t xEventGroup )
+   {
+   EventBits_t uxBits;
+   const TickType_t xTicksToWait = 100 / portTICK_PERIOD_MS;
+
+		// Wait a maximum of 100ms for either bit 0 or bit 4 to be set within
+		// the event group.  Clear the bits before exiting.
+		uxBits = xEventGroupWaitBits(
+					xEventGroup,	// The event group being tested.
+					BIT_0 | BIT_4,	// The bits within the event group to wait for.
+					pdTRUE,			// BIT_0 and BIT_4 should be cleared before returning.
+					pdFALSE,		// Don't wait for both bits, either bit will do.
+					xTicksToWait );	// Wait a maximum of 100ms for either bit to be set.
+
+		if( ( uxBits & ( BIT_0 | BIT_4 ) ) == ( BIT_0 | BIT_4 ) )
+		{
+			// xEventGroupWaitBits() returned because both bits were set.
+		}
+		else if( ( uxBits & BIT_0 ) != 0 )
+		{
+			// xEventGroupWaitBits() returned because just BIT_0 was set.
+		}
+		else if( ( uxBits & BIT_4 ) != 0 )
+		{
+			// xEventGroupWaitBits() returned because just BIT_4 was set.
+		}
+		else
+		{
+			// xEventGroupWaitBits() returned because xTicksToWait ticks passed
+			// without either BIT_0 or BIT_4 becoming set.
+		}
+   }
+
+ * \defgroup xEventGroupWaitBits xEventGroupWaitBits + * \ingroup EventGroup + */ +EventBits_t xEventGroupWaitBits( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToWaitFor, const BaseType_t xClearOnExit, const BaseType_t xWaitForAllBits, TickType_t xTicksToWait ) PRIVILEGED_FUNCTION; + +/** + * event_groups.h + *
+	EventBits_t xEventGroupClearBits( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToClear );
+
+ * + * Clear bits within an event group. This function cannot be called from an + * interrupt. + * + * @param xEventGroup The event group in which the bits are to be cleared. + * + * @param uxBitsToClear A bitwise value that indicates the bit or bits to clear + * in the event group. For example, to clear bit 3 only, set uxBitsToClear to + * 0x08. To clear bit 3 and bit 0 set uxBitsToClear to 0x09. + * + * @return The value of the event group before the specified bits were cleared. + * + * Example usage: + 
+   #define BIT_0	( 1 << 0 )
+   #define BIT_4	( 1 << 4 )
+
+   void aFunction( EventGroupHandle_t xEventGroup )
+   {
+   EventBits_t uxBits;
+
+		// Clear bit 0 and bit 4 in xEventGroup.
+		uxBits = xEventGroupClearBits(
+								xEventGroup,	// The event group being updated.
+								BIT_0 | BIT_4 );// The bits being cleared.
+
+		if( ( uxBits & ( BIT_0 | BIT_4 ) ) == ( BIT_0 | BIT_4 ) )
+		{
+			// Both bit 0 and bit 4 were set before xEventGroupClearBits() was
+			// called.  Both will now be clear (not set).
+		}
+		else if( ( uxBits & BIT_0 ) != 0 )
+		{
+			// Bit 0 was set before xEventGroupClearBits() was called.  It will
+			// now be clear.
+		}
+		else if( ( uxBits & BIT_4 ) != 0 )
+		{
+			// Bit 4 was set before xEventGroupClearBits() was called.  It will
+			// now be clear.
+		}
+		else
+		{
+			// Neither bit 0 nor bit 4 were set in the first place.
+		}
+   }
+
+ * \defgroup xEventGroupClearBits xEventGroupClearBits + * \ingroup EventGroup + */ +EventBits_t xEventGroupClearBits( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToClear ) PRIVILEGED_FUNCTION; + +/** + * event_groups.h + *
+	BaseType_t xEventGroupClearBitsFromISR( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToSet );
+
+ * + * A version of xEventGroupClearBits() that can be called from an interrupt. + * + * Setting bits in an event group is not a deterministic operation because there + * are an unknown number of tasks that may be waiting for the bit or bits being + * set. FreeRTOS does not allow nondeterministic operations to be performed + * while interrupts are disabled, so protects event groups that are accessed + * from tasks by suspending the scheduler rather than disabling interrupts. As + * a result event groups cannot be accessed directly from an interrupt service + * routine. Therefore xEventGroupClearBitsFromISR() sends a message to the + * timer task to have the clear operation performed in the context of the timer + * task. + * + * @param xEventGroup The event group in which the bits are to be cleared. + * + * @param uxBitsToClear A bitwise value that indicates the bit or bits to clear. + * For example, to clear bit 3 only, set uxBitsToClear to 0x08. To clear bit 3 + * and bit 0 set uxBitsToClear to 0x09. + * + * @return If the request to execute the function was posted successfully then + * pdPASS is returned, otherwise pdFALSE is returned. pdFALSE will be returned + * if the timer service queue was full. + * + * Example usage: + 
+   #define BIT_0	( 1 << 0 )
+   #define BIT_4	( 1 << 4 )
+
+   // An event group which it is assumed has already been created by a call to
+   // xEventGroupCreate().
+   EventGroupHandle_t xEventGroup;
+
+   void anInterruptHandler( void )
+   {
+		// Clear bit 0 and bit 4 in xEventGroup.
+		xResult = xEventGroupClearBitsFromISR(
+							xEventGroup,	 // The event group being updated.
+							BIT_0 | BIT_4 ); // The bits being set.
+
+		if( xResult == pdPASS )
+		{
+			// The message was posted successfully.
+		}
+  }
+
+ * \defgroup xEventGroupClearBitsFromISR xEventGroupClearBitsFromISR + * \ingroup EventGroup + */ +#if( configUSE_TRACE_FACILITY == 1 ) + BaseType_t xEventGroupClearBitsFromISR( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToSet ) PRIVILEGED_FUNCTION; +#else + #define xEventGroupClearBitsFromISR( xEventGroup, uxBitsToClear ) xTimerPendFunctionCallFromISR( vEventGroupClearBitsCallback, ( void * ) xEventGroup, ( uint32_t ) uxBitsToClear, NULL ) +#endif + +/** + * event_groups.h + *
+	EventBits_t xEventGroupSetBits( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToSet );
+
+ * + * Set bits within an event group. + * This function cannot be called from an interrupt. xEventGroupSetBitsFromISR() + * is a version that can be called from an interrupt. + * + * Setting bits in an event group will automatically unblock tasks that are + * blocked waiting for the bits. + * + * @param xEventGroup The event group in which the bits are to be set. + * + * @param uxBitsToSet A bitwise value that indicates the bit or bits to set. + * For example, to set bit 3 only, set uxBitsToSet to 0x08. To set bit 3 + * and bit 0 set uxBitsToSet to 0x09. + * + * @return The value of the event group at the time the call to + * xEventGroupSetBits() returns. There are two reasons why the returned value + * might have the bits specified by the uxBitsToSet parameter cleared. First, + * if setting a bit results in a task that was waiting for the bit leaving the + * blocked state then it is possible the bit will be cleared automatically + * (see the xClearBitOnExit parameter of xEventGroupWaitBits()). Second, any + * unblocked (or otherwise Ready state) task that has a priority above that of + * the task that called xEventGroupSetBits() will execute and may change the + * event group value before the call to xEventGroupSetBits() returns. + * + * Example usage: + 
+   #define BIT_0	( 1 << 0 )
+   #define BIT_4	( 1 << 4 )
+
+   void aFunction( EventGroupHandle_t xEventGroup )
+   {
+   EventBits_t uxBits;
+
+		// Set bit 0 and bit 4 in xEventGroup.
+		uxBits = xEventGroupSetBits(
+							xEventGroup,	// The event group being updated.
+							BIT_0 | BIT_4 );// The bits being set.
+
+		if( ( uxBits & ( BIT_0 | BIT_4 ) ) == ( BIT_0 | BIT_4 ) )
+		{
+			// Both bit 0 and bit 4 remained set when the function returned.
+		}
+		else if( ( uxBits & BIT_0 ) != 0 )
+		{
+			// Bit 0 remained set when the function returned, but bit 4 was
+			// cleared.  It might be that bit 4 was cleared automatically as a
+			// task that was waiting for bit 4 was removed from the Blocked
+			// state.
+		}
+		else if( ( uxBits & BIT_4 ) != 0 )
+		{
+			// Bit 4 remained set when the function returned, but bit 0 was
+			// cleared.  It might be that bit 0 was cleared automatically as a
+			// task that was waiting for bit 0 was removed from the Blocked
+			// state.
+		}
+		else
+		{
+			// Neither bit 0 nor bit 4 remained set.  It might be that a task
+			// was waiting for both of the bits to be set, and the bits were
+			// cleared as the task left the Blocked state.
+		}
+   }
+
+ * \defgroup xEventGroupSetBits xEventGroupSetBits + * \ingroup EventGroup + */ +EventBits_t xEventGroupSetBits( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToSet ) PRIVILEGED_FUNCTION; + +/** + * event_groups.h + *
+	BaseType_t xEventGroupSetBitsFromISR( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToSet, BaseType_t *pxHigherPriorityTaskWoken );
+
+ * + * A version of xEventGroupSetBits() that can be called from an interrupt. + * + * Setting bits in an event group is not a deterministic operation because there + * are an unknown number of tasks that may be waiting for the bit or bits being + * set. FreeRTOS does not allow nondeterministic operations to be performed in + * interrupts or from critical sections. Therefore xEventGroupSetBitsFromISR() + * sends a message to the timer task to have the set operation performed in the + * context of the timer task - where a scheduler lock is used in place of a + * critical section. + * + * @param xEventGroup The event group in which the bits are to be set. + * + * @param uxBitsToSet A bitwise value that indicates the bit or bits to set. + * For example, to set bit 3 only, set uxBitsToSet to 0x08. To set bit 3 + * and bit 0 set uxBitsToSet to 0x09. + * + * @param pxHigherPriorityTaskWoken As mentioned above, calling this function + * will result in a message being sent to the timer daemon task. If the + * priority of the timer daemon task is higher than the priority of the + * currently running task (the task the interrupt interrupted) then + * *pxHigherPriorityTaskWoken will be set to pdTRUE by + * xEventGroupSetBitsFromISR(), indicating that a context switch should be + * requested before the interrupt exits. For that reason + * *pxHigherPriorityTaskWoken must be initialised to pdFALSE. See the + * example code below. + * + * @return If the request to execute the function was posted successfully then + * pdPASS is returned, otherwise pdFALSE is returned. pdFALSE will be returned + * if the timer service queue was full. + * + * Example usage: + 
+   #define BIT_0	( 1 << 0 )
+   #define BIT_4	( 1 << 4 )
+
+   // An event group which it is assumed has already been created by a call to
+   // xEventGroupCreate().
+   EventGroupHandle_t xEventGroup;
+
+   void anInterruptHandler( void )
+   {
+   BaseType_t xHigherPriorityTaskWoken, xResult;
+
+		// xHigherPriorityTaskWoken must be initialised to pdFALSE.
+		xHigherPriorityTaskWoken = pdFALSE;
+
+		// Set bit 0 and bit 4 in xEventGroup.
+		xResult = xEventGroupSetBitsFromISR(
+							xEventGroup,	// The event group being updated.
+							BIT_0 | BIT_4   // The bits being set.
+							&xHigherPriorityTaskWoken );
+
+		// Was the message posted successfully?
+		if( xResult == pdPASS )
+		{
+			// If xHigherPriorityTaskWoken is now set to pdTRUE then a context
+			// switch should be requested.  The macro used is port specific and
+			// will be either portYIELD_FROM_ISR() or portEND_SWITCHING_ISR() -
+			// refer to the documentation page for the port being used.
+			portYIELD_FROM_ISR( xHigherPriorityTaskWoken );
+		}
+  }
+
+ * \defgroup xEventGroupSetBitsFromISR xEventGroupSetBitsFromISR + * \ingroup EventGroup + */ +#if( configUSE_TRACE_FACILITY == 1 ) + BaseType_t xEventGroupSetBitsFromISR( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToSet, BaseType_t *pxHigherPriorityTaskWoken ) PRIVILEGED_FUNCTION; +#else + #define xEventGroupSetBitsFromISR( xEventGroup, uxBitsToSet, pxHigherPriorityTaskWoken ) xTimerPendFunctionCallFromISR( vEventGroupSetBitsCallback, ( void * ) xEventGroup, ( uint32_t ) uxBitsToSet, pxHigherPriorityTaskWoken ) +#endif + +/** + * event_groups.h + *
+	EventBits_t xEventGroupSync(	EventGroupHandle_t xEventGroup,
+									const EventBits_t uxBitsToSet,
+									const EventBits_t uxBitsToWaitFor,
+									TickType_t xTicksToWait );
+
+ * + * Atomically set bits within an event group, then wait for a combination of + * bits to be set within the same event group. This functionality is typically + * used to synchronise multiple tasks, where each task has to wait for the other + * tasks to reach a synchronisation point before proceeding. + * + * This function cannot be used from an interrupt. + * + * The function will return before its block time expires if the bits specified + * by the uxBitsToWait parameter are set, or become set within that time. In + * this case all the bits specified by uxBitsToWait will be automatically + * cleared before the function returns. + * + * @param xEventGroup The event group in which the bits are being tested. The + * event group must have previously been created using a call to + * xEventGroupCreate(). + * + * @param uxBitsToSet The bits to set in the event group before determining + * if, and possibly waiting for, all the bits specified by the uxBitsToWait + * parameter are set. + * + * @param uxBitsToWaitFor A bitwise value that indicates the bit or bits to test + * inside the event group. For example, to wait for bit 0 and bit 2 set + * uxBitsToWaitFor to 0x05. To wait for bits 0 and bit 1 and bit 2 set + * uxBitsToWaitFor to 0x07. Etc. + * + * @param xTicksToWait The maximum amount of time (specified in 'ticks') to wait + * for all of the bits specified by uxBitsToWaitFor to become set. + * + * @return The value of the event group at the time either the bits being waited + * for became set, or the block time expired. Test the return value to know + * which bits were set. If xEventGroupSync() returned because its timeout + * expired then not all the bits being waited for will be set. If + * xEventGroupSync() returned because all the bits it was waiting for were + * set then the returned value is the event group value before any bits were + * automatically cleared. + * + * Example usage: + 
+ // Bits used by the three tasks.
+ #define TASK_0_BIT		( 1 << 0 )
+ #define TASK_1_BIT		( 1 << 1 )
+ #define TASK_2_BIT		( 1 << 2 )
+
+ #define ALL_SYNC_BITS ( TASK_0_BIT | TASK_1_BIT | TASK_2_BIT )
+
+ // Use an event group to synchronise three tasks.  It is assumed this event
+ // group has already been created elsewhere.
+ EventGroupHandle_t xEventBits;
+
+ void vTask0( void *pvParameters )
+ {
+ EventBits_t uxReturn;
+ TickType_t xTicksToWait = 100 / portTICK_PERIOD_MS;
+
+	 for( ;; )
+	 {
+		// Perform task functionality here.
+
+		// Set bit 0 in the event flag to note this task has reached the
+		// sync point.  The other two tasks will set the other two bits defined
+		// by ALL_SYNC_BITS.  All three tasks have reached the synchronisation
+		// point when all the ALL_SYNC_BITS are set.  Wait a maximum of 100ms
+		// for this to happen.
+		uxReturn = xEventGroupSync( xEventBits, TASK_0_BIT, ALL_SYNC_BITS, xTicksToWait );
+
+		if( ( uxReturn & ALL_SYNC_BITS ) == ALL_SYNC_BITS )
+		{
+			// All three tasks reached the synchronisation point before the call
+			// to xEventGroupSync() timed out.
+		}
+	}
+ }
+
+ void vTask1( void *pvParameters )
+ {
+	 for( ;; )
+	 {
+		// Perform task functionality here.
+
+		// Set bit 1 in the event flag to note this task has reached the
+		// synchronisation point.  The other two tasks will set the other two
+		// bits defined by ALL_SYNC_BITS.  All three tasks have reached the
+		// synchronisation point when all the ALL_SYNC_BITS are set.  Wait
+		// indefinitely for this to happen.
+		xEventGroupSync( xEventBits, TASK_1_BIT, ALL_SYNC_BITS, portMAX_DELAY );
+
+		// xEventGroupSync() was called with an indefinite block time, so
+		// this task will only reach here if the syncrhonisation was made by all
+		// three tasks, so there is no need to test the return value.
+	 }
+ }
+
+ void vTask2( void *pvParameters )
+ {
+	 for( ;; )
+	 {
+		// Perform task functionality here.
+
+		// Set bit 2 in the event flag to note this task has reached the
+		// synchronisation point.  The other two tasks will set the other two
+		// bits defined by ALL_SYNC_BITS.  All three tasks have reached the
+		// synchronisation point when all the ALL_SYNC_BITS are set.  Wait
+		// indefinitely for this to happen.
+		xEventGroupSync( xEventBits, TASK_2_BIT, ALL_SYNC_BITS, portMAX_DELAY );
+
+		// xEventGroupSync() was called with an indefinite block time, so
+		// this task will only reach here if the syncrhonisation was made by all
+		// three tasks, so there is no need to test the return value.
+	}
+ }
+
+
+ * \defgroup xEventGroupSync xEventGroupSync + * \ingroup EventGroup + */ +EventBits_t xEventGroupSync( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToSet, const EventBits_t uxBitsToWaitFor, TickType_t xTicksToWait ) PRIVILEGED_FUNCTION; + + +/** + * event_groups.h + *
+	EventBits_t xEventGroupGetBits( EventGroupHandle_t xEventGroup );
+
+ * + * Returns the current value of the bits in an event group. This function + * cannot be used from an interrupt. + * + * @param xEventGroup The event group being queried. + * + * @return The event group bits at the time xEventGroupGetBits() was called. + * + * \defgroup xEventGroupGetBits xEventGroupGetBits + * \ingroup EventGroup + */ +#define xEventGroupGetBits( xEventGroup ) xEventGroupClearBits( xEventGroup, 0 ) + +/** + * event_groups.h + *
+	EventBits_t xEventGroupGetBitsFromISR( EventGroupHandle_t xEventGroup );
+
+ * + * A version of xEventGroupGetBits() that can be called from an ISR. + * + * @param xEventGroup The event group being queried. + * + * @return The event group bits at the time xEventGroupGetBitsFromISR() was called. + * + * \defgroup xEventGroupGetBitsFromISR xEventGroupGetBitsFromISR + * \ingroup EventGroup + */ +EventBits_t xEventGroupGetBitsFromISR( EventGroupHandle_t xEventGroup ) PRIVILEGED_FUNCTION; + +/** + * event_groups.h + *
+	void xEventGroupDelete( EventGroupHandle_t xEventGroup );
+
+ * + * Delete an event group that was previously created by a call to + * xEventGroupCreate(). Tasks that are blocked on the event group will be + * unblocked and obtain 0 as the event group's value. + * + * @param xEventGroup The event group being deleted. + */ +void vEventGroupDelete( EventGroupHandle_t xEventGroup ) PRIVILEGED_FUNCTION; + +/* For internal use only. */ +void vEventGroupSetBitsCallback( void *pvEventGroup, const uint32_t ulBitsToSet ) PRIVILEGED_FUNCTION; +void vEventGroupClearBitsCallback( void *pvEventGroup, const uint32_t ulBitsToClear ) PRIVILEGED_FUNCTION; + + +#if (configUSE_TRACE_FACILITY == 1) + UBaseType_t uxEventGroupGetNumber( void* xEventGroup ) PRIVILEGED_FUNCTION; +#endif + +#ifdef __cplusplus +} +#endif + +#endif /* EVENT_GROUPS_H */ + + diff --git a/FreeRTOS/include/list.h b/FreeRTOS/include/list.h new file mode 100644 index 0000000..a080d27 --- /dev/null +++ b/FreeRTOS/include/list.h @@ -0,0 +1,453 @@ +/* + FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd. + All rights reserved + + VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION. + + This file is part of the FreeRTOS distribution. + + FreeRTOS is free software; you can redistribute it and/or modify it under + the terms of the GNU General Public License (version 2) as published by the + Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception. + + *************************************************************************** + >>! NOTE: The modification to the GPL is included to allow you to !<< + >>! distribute a combined work that includes FreeRTOS without being !<< + >>! obliged to provide the source code for proprietary components !<< + >>! outside of the FreeRTOS kernel. !<< + *************************************************************************** + + FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY + WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS + FOR A PARTICULAR PURPOSE. Full license text is available on the following + link: http://www.freertos.org/a00114.html + + *************************************************************************** + * * + * FreeRTOS provides completely free yet professionally developed, * + * robust, strictly quality controlled, supported, and cross * + * platform software that is more than just the market leader, it * + * is the industry's de facto standard. * + * * + * Help yourself get started quickly while simultaneously helping * + * to support the FreeRTOS project by purchasing a FreeRTOS * + * tutorial book, reference manual, or both: * + * http://www.FreeRTOS.org/Documentation * + * * + *************************************************************************** + + http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading + the FAQ page "My application does not run, what could be wrong?". Have you + defined configASSERT()? + + http://www.FreeRTOS.org/support - In return for receiving this top quality + embedded software for free we request you assist our global community by + participating in the support forum. + + http://www.FreeRTOS.org/training - Investing in training allows your team to + be as productive as possible as early as possible. Now you can receive + FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers + Ltd, and the world's leading authority on the world's leading RTOS. + + http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products, + including FreeRTOS+Trace - an indispensable productivity tool, a DOS + compatible FAT file system, and our tiny thread aware UDP/IP stack. + + http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate. + Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS. + + http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High + Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS + licenses offer ticketed support, indemnification and commercial middleware. + + http://www.SafeRTOS.com - High Integrity Systems also provide a safety + engineered and independently SIL3 certified version for use in safety and + mission critical applications that require provable dependability. + + 1 tab == 4 spaces! +*/ + +/* + * This is the list implementation used by the scheduler. While it is tailored + * heavily for the schedulers needs, it is also available for use by + * application code. + * + * list_ts can only store pointers to list_item_ts. Each ListItem_t contains a + * numeric value (xItemValue). Most of the time the lists are sorted in + * descending item value order. + * + * Lists are created already containing one list item. The value of this + * item is the maximum possible that can be stored, it is therefore always at + * the end of the list and acts as a marker. The list member pxHead always + * points to this marker - even though it is at the tail of the list. This + * is because the tail contains a wrap back pointer to the true head of + * the list. + * + * In addition to it's value, each list item contains a pointer to the next + * item in the list (pxNext), a pointer to the list it is in (pxContainer) + * and a pointer to back to the object that contains it. These later two + * pointers are included for efficiency of list manipulation. There is + * effectively a two way link between the object containing the list item and + * the list item itself. + * + * + * \page ListIntroduction List Implementation + * \ingroup FreeRTOSIntro + */ + +#ifndef INC_FREERTOS_H + #error FreeRTOS.h must be included before list.h +#endif + +#ifndef LIST_H +#define LIST_H + +/* + * The list structure members are modified from within interrupts, and therefore + * by rights should be declared volatile. However, they are only modified in a + * functionally atomic way (within critical sections of with the scheduler + * suspended) and are either passed by reference into a function or indexed via + * a volatile variable. Therefore, in all use cases tested so far, the volatile + * qualifier can be omitted in order to provide a moderate performance + * improvement without adversely affecting functional behaviour. The assembly + * instructions generated by the IAR, ARM and GCC compilers when the respective + * compiler's options were set for maximum optimisation has been inspected and + * deemed to be as intended. That said, as compiler technology advances, and + * especially if aggressive cross module optimisation is used (a use case that + * has not been exercised to any great extend) then it is feasible that the + * volatile qualifier will be needed for correct optimisation. It is expected + * that a compiler removing essential code because, without the volatile + * qualifier on the list structure members and with aggressive cross module + * optimisation, the compiler deemed the code unnecessary will result in + * complete and obvious failure of the scheduler. If this is ever experienced + * then the volatile qualifier can be inserted in the relevant places within the + * list structures by simply defining configLIST_VOLATILE to volatile in + * FreeRTOSConfig.h (as per the example at the bottom of this comment block). + * If configLIST_VOLATILE is not defined then the preprocessor directives below + * will simply #define configLIST_VOLATILE away completely. + * + * To use volatile list structure members then add the following line to + * FreeRTOSConfig.h (without the quotes): + * "#define configLIST_VOLATILE volatile" + */ +#ifndef configLIST_VOLATILE + #define configLIST_VOLATILE +#endif /* configSUPPORT_CROSS_MODULE_OPTIMISATION */ + +#ifdef __cplusplus +extern "C" { +#endif + +/* Macros that can be used to place known values within the list structures, +then check that the known values do not get corrupted during the execution of +the application. These may catch the list data structures being overwritten in +memory. They will not catch data errors caused by incorrect configuration or +use of FreeRTOS.*/ +#if( configUSE_LIST_DATA_INTEGRITY_CHECK_BYTES == 0 ) + /* Define the macros to do nothing. */ + #define listFIRST_LIST_ITEM_INTEGRITY_CHECK_VALUE + #define listSECOND_LIST_ITEM_INTEGRITY_CHECK_VALUE + #define listFIRST_LIST_INTEGRITY_CHECK_VALUE + #define listSECOND_LIST_INTEGRITY_CHECK_VALUE + #define listSET_FIRST_LIST_ITEM_INTEGRITY_CHECK_VALUE( pxItem ) + #define listSET_SECOND_LIST_ITEM_INTEGRITY_CHECK_VALUE( pxItem ) + #define listSET_LIST_INTEGRITY_CHECK_1_VALUE( pxList ) + #define listSET_LIST_INTEGRITY_CHECK_2_VALUE( pxList ) + #define listTEST_LIST_ITEM_INTEGRITY( pxItem ) + #define listTEST_LIST_INTEGRITY( pxList ) +#else + /* Define macros that add new members into the list structures. */ + #define listFIRST_LIST_ITEM_INTEGRITY_CHECK_VALUE TickType_t xListItemIntegrityValue1; + #define listSECOND_LIST_ITEM_INTEGRITY_CHECK_VALUE TickType_t xListItemIntegrityValue2; + #define listFIRST_LIST_INTEGRITY_CHECK_VALUE TickType_t xListIntegrityValue1; + #define listSECOND_LIST_INTEGRITY_CHECK_VALUE TickType_t xListIntegrityValue2; + + /* Define macros that set the new structure members to known values. */ + #define listSET_FIRST_LIST_ITEM_INTEGRITY_CHECK_VALUE( pxItem ) ( pxItem )->xListItemIntegrityValue1 = pdINTEGRITY_CHECK_VALUE + #define listSET_SECOND_LIST_ITEM_INTEGRITY_CHECK_VALUE( pxItem ) ( pxItem )->xListItemIntegrityValue2 = pdINTEGRITY_CHECK_VALUE + #define listSET_LIST_INTEGRITY_CHECK_1_VALUE( pxList ) ( pxList )->xListIntegrityValue1 = pdINTEGRITY_CHECK_VALUE + #define listSET_LIST_INTEGRITY_CHECK_2_VALUE( pxList ) ( pxList )->xListIntegrityValue2 = pdINTEGRITY_CHECK_VALUE + + /* Define macros that will assert if one of the structure members does not + contain its expected value. */ + #define listTEST_LIST_ITEM_INTEGRITY( pxItem ) configASSERT( ( ( pxItem )->xListItemIntegrityValue1 == pdINTEGRITY_CHECK_VALUE ) && ( ( pxItem )->xListItemIntegrityValue2 == pdINTEGRITY_CHECK_VALUE ) ) + #define listTEST_LIST_INTEGRITY( pxList ) configASSERT( ( ( pxList )->xListIntegrityValue1 == pdINTEGRITY_CHECK_VALUE ) && ( ( pxList )->xListIntegrityValue2 == pdINTEGRITY_CHECK_VALUE ) ) +#endif /* configUSE_LIST_DATA_INTEGRITY_CHECK_BYTES */ + + +/* + * Definition of the only type of object that a list can contain. + */ +struct xLIST_ITEM +{ + listFIRST_LIST_ITEM_INTEGRITY_CHECK_VALUE /*< Set to a known value if configUSE_LIST_DATA_INTEGRITY_CHECK_BYTES is set to 1. */ + configLIST_VOLATILE TickType_t xItemValue; /*< The value being listed. In most cases this is used to sort the list in descending order. */ + struct xLIST_ITEM * configLIST_VOLATILE pxNext; /*< Pointer to the next ListItem_t in the list. */ + struct xLIST_ITEM * configLIST_VOLATILE pxPrevious; /*< Pointer to the previous ListItem_t in the list. */ + void * pvOwner; /*< Pointer to the object (normally a TCB) that contains the list item. There is therefore a two way link between the object containing the list item and the list item itself. */ + void * configLIST_VOLATILE pvContainer; /*< Pointer to the list in which this list item is placed (if any). */ + listSECOND_LIST_ITEM_INTEGRITY_CHECK_VALUE /*< Set to a known value if configUSE_LIST_DATA_INTEGRITY_CHECK_BYTES is set to 1. */ +}; +typedef struct xLIST_ITEM ListItem_t; /* For some reason lint wants this as two separate definitions. */ + +struct xMINI_LIST_ITEM +{ + listFIRST_LIST_ITEM_INTEGRITY_CHECK_VALUE /*< Set to a known value if configUSE_LIST_DATA_INTEGRITY_CHECK_BYTES is set to 1. */ + configLIST_VOLATILE TickType_t xItemValue; + struct xLIST_ITEM * configLIST_VOLATILE pxNext; + struct xLIST_ITEM * configLIST_VOLATILE pxPrevious; +}; +typedef struct xMINI_LIST_ITEM MiniListItem_t; + +/* + * Definition of the type of queue used by the scheduler. + */ +typedef struct xLIST +{ + listFIRST_LIST_INTEGRITY_CHECK_VALUE /*< Set to a known value if configUSE_LIST_DATA_INTEGRITY_CHECK_BYTES is set to 1. */ + configLIST_VOLATILE UBaseType_t uxNumberOfItems; + ListItem_t * configLIST_VOLATILE pxIndex; /*< Used to walk through the list. Points to the last item returned by a call to listGET_OWNER_OF_NEXT_ENTRY (). */ + MiniListItem_t xListEnd; /*< List item that contains the maximum possible item value meaning it is always at the end of the list and is therefore used as a marker. */ + listSECOND_LIST_INTEGRITY_CHECK_VALUE /*< Set to a known value if configUSE_LIST_DATA_INTEGRITY_CHECK_BYTES is set to 1. */ +} List_t; + +/* + * Access macro to set the owner of a list item. The owner of a list item + * is the object (usually a TCB) that contains the list item. + * + * \page listSET_LIST_ITEM_OWNER listSET_LIST_ITEM_OWNER + * \ingroup LinkedList + */ +#define listSET_LIST_ITEM_OWNER( pxListItem, pxOwner ) ( ( pxListItem )->pvOwner = ( void * ) ( pxOwner ) ) + +/* + * Access macro to get the owner of a list item. The owner of a list item + * is the object (usually a TCB) that contains the list item. + * + * \page listSET_LIST_ITEM_OWNER listSET_LIST_ITEM_OWNER + * \ingroup LinkedList + */ +#define listGET_LIST_ITEM_OWNER( pxListItem ) ( ( pxListItem )->pvOwner ) + +/* + * Access macro to set the value of the list item. In most cases the value is + * used to sort the list in descending order. + * + * \page listSET_LIST_ITEM_VALUE listSET_LIST_ITEM_VALUE + * \ingroup LinkedList + */ +#define listSET_LIST_ITEM_VALUE( pxListItem, xValue ) ( ( pxListItem )->xItemValue = ( xValue ) ) + +/* + * Access macro to retrieve the value of the list item. The value can + * represent anything - for example the priority of a task, or the time at + * which a task should be unblocked. + * + * \page listGET_LIST_ITEM_VALUE listGET_LIST_ITEM_VALUE + * \ingroup LinkedList + */ +#define listGET_LIST_ITEM_VALUE( pxListItem ) ( ( pxListItem )->xItemValue ) + +/* + * Access macro to retrieve the value of the list item at the head of a given + * list. + * + * \page listGET_LIST_ITEM_VALUE listGET_LIST_ITEM_VALUE + * \ingroup LinkedList + */ +#define listGET_ITEM_VALUE_OF_HEAD_ENTRY( pxList ) ( ( ( pxList )->xListEnd ).pxNext->xItemValue ) + +/* + * Return the list item at the head of the list. + * + * \page listGET_HEAD_ENTRY listGET_HEAD_ENTRY + * \ingroup LinkedList + */ +#define listGET_HEAD_ENTRY( pxList ) ( ( ( pxList )->xListEnd ).pxNext ) + +/* + * Return the list item at the head of the list. + * + * \page listGET_NEXT listGET_NEXT + * \ingroup LinkedList + */ +#define listGET_NEXT( pxListItem ) ( ( pxListItem )->pxNext ) + +/* + * Return the list item that marks the end of the list + * + * \page listGET_END_MARKER listGET_END_MARKER + * \ingroup LinkedList + */ +#define listGET_END_MARKER( pxList ) ( ( ListItem_t const * ) ( &( ( pxList )->xListEnd ) ) ) + +/* + * Access macro to determine if a list contains any items. The macro will + * only have the value true if the list is empty. + * + * \page listLIST_IS_EMPTY listLIST_IS_EMPTY + * \ingroup LinkedList + */ +#define listLIST_IS_EMPTY( pxList ) ( ( BaseType_t ) ( ( pxList )->uxNumberOfItems == ( UBaseType_t ) 0 ) ) + +/* + * Access macro to return the number of items in the list. + */ +#define listCURRENT_LIST_LENGTH( pxList ) ( ( pxList )->uxNumberOfItems ) + +/* + * Access function to obtain the owner of the next entry in a list. + * + * The list member pxIndex is used to walk through a list. Calling + * listGET_OWNER_OF_NEXT_ENTRY increments pxIndex to the next item in the list + * and returns that entry's pxOwner parameter. Using multiple calls to this + * function it is therefore possible to move through every item contained in + * a list. + * + * The pxOwner parameter of a list item is a pointer to the object that owns + * the list item. In the scheduler this is normally a task control block. + * The pxOwner parameter effectively creates a two way link between the list + * item and its owner. + * + * @param pxTCB pxTCB is set to the address of the owner of the next list item. + * @param pxList The list from which the next item owner is to be returned. + * + * \page listGET_OWNER_OF_NEXT_ENTRY listGET_OWNER_OF_NEXT_ENTRY + * \ingroup LinkedList + */ +#define listGET_OWNER_OF_NEXT_ENTRY( pxTCB, pxList ) \ +{ \ +List_t * const pxConstList = ( pxList ); \ + /* Increment the index to the next item and return the item, ensuring */ \ + /* we don't return the marker used at the end of the list. */ \ + ( pxConstList )->pxIndex = ( pxConstList )->pxIndex->pxNext; \ + if( ( void * ) ( pxConstList )->pxIndex == ( void * ) &( ( pxConstList )->xListEnd ) ) \ + { \ + ( pxConstList )->pxIndex = ( pxConstList )->pxIndex->pxNext; \ + } \ + ( pxTCB ) = ( pxConstList )->pxIndex->pvOwner; \ +} + + +/* + * Access function to obtain the owner of the first entry in a list. Lists + * are normally sorted in ascending item value order. + * + * This function returns the pxOwner member of the first item in the list. + * The pxOwner parameter of a list item is a pointer to the object that owns + * the list item. In the scheduler this is normally a task control block. + * The pxOwner parameter effectively creates a two way link between the list + * item and its owner. + * + * @param pxList The list from which the owner of the head item is to be + * returned. + * + * \page listGET_OWNER_OF_HEAD_ENTRY listGET_OWNER_OF_HEAD_ENTRY + * \ingroup LinkedList + */ +#define listGET_OWNER_OF_HEAD_ENTRY( pxList ) ( (&( ( pxList )->xListEnd ))->pxNext->pvOwner ) + +/* + * Check to see if a list item is within a list. The list item maintains a + * "container" pointer that points to the list it is in. All this macro does + * is check to see if the container and the list match. + * + * @param pxList The list we want to know if the list item is within. + * @param pxListItem The list item we want to know if is in the list. + * @return pdTRUE if the list item is in the list, otherwise pdFALSE. + */ +#define listIS_CONTAINED_WITHIN( pxList, pxListItem ) ( ( BaseType_t ) ( ( pxListItem )->pvContainer == ( void * ) ( pxList ) ) ) + +/* + * Return the list a list item is contained within (referenced from). + * + * @param pxListItem The list item being queried. + * @return A pointer to the List_t object that references the pxListItem + */ +#define listLIST_ITEM_CONTAINER( pxListItem ) ( ( pxListItem )->pvContainer ) + +/* + * This provides a crude means of knowing if a list has been initialised, as + * pxList->xListEnd.xItemValue is set to portMAX_DELAY by the vListInitialise() + * function. + */ +#define listLIST_IS_INITIALISED( pxList ) ( ( pxList )->xListEnd.xItemValue == portMAX_DELAY ) + +/* + * Must be called before a list is used! This initialises all the members + * of the list structure and inserts the xListEnd item into the list as a + * marker to the back of the list. + * + * @param pxList Pointer to the list being initialised. + * + * \page vListInitialise vListInitialise + * \ingroup LinkedList + */ +void vListInitialise( List_t * const pxList ) PRIVILEGED_FUNCTION; + +/* + * Must be called before a list item is used. This sets the list container to + * null so the item does not think that it is already contained in a list. + * + * @param pxItem Pointer to the list item being initialised. + * + * \page vListInitialiseItem vListInitialiseItem + * \ingroup LinkedList + */ +void vListInitialiseItem( ListItem_t * const pxItem ) PRIVILEGED_FUNCTION; + +/* + * Insert a list item into a list. The item will be inserted into the list in + * a position determined by its item value (descending item value order). + * + * @param pxList The list into which the item is to be inserted. + * + * @param pxNewListItem The item that is to be placed in the list. + * + * \page vListInsert vListInsert + * \ingroup LinkedList + */ +void vListInsert( List_t * const pxList, ListItem_t * const pxNewListItem ) PRIVILEGED_FUNCTION; + +/* + * Insert a list item into a list. The item will be inserted in a position + * such that it will be the last item within the list returned by multiple + * calls to listGET_OWNER_OF_NEXT_ENTRY. + * + * The list member pxIndex is used to walk through a list. Calling + * listGET_OWNER_OF_NEXT_ENTRY increments pxIndex to the next item in the list. + * Placing an item in a list using vListInsertEnd effectively places the item + * in the list position pointed to by pxIndex. This means that every other + * item within the list will be returned by listGET_OWNER_OF_NEXT_ENTRY before + * the pxIndex parameter again points to the item being inserted. + * + * @param pxList The list into which the item is to be inserted. + * + * @param pxNewListItem The list item to be inserted into the list. + * + * \page vListInsertEnd vListInsertEnd + * \ingroup LinkedList + */ +void vListInsertEnd( List_t * const pxList, ListItem_t * const pxNewListItem ) PRIVILEGED_FUNCTION; + +/* + * Remove an item from a list. The list item has a pointer to the list that + * it is in, so only the list item need be passed into the function. + * + * @param uxListRemove The item to be removed. The item will remove itself from + * the list pointed to by it's pxContainer parameter. + * + * @return The number of items that remain in the list after the list item has + * been removed. + * + * \page uxListRemove uxListRemove + * \ingroup LinkedList + */ +UBaseType_t uxListRemove( ListItem_t * const pxItemToRemove ) PRIVILEGED_FUNCTION; + +#ifdef __cplusplus +} +#endif + +#endif + diff --git a/FreeRTOS/include/mpu_prototypes.h b/FreeRTOS/include/mpu_prototypes.h new file mode 100644 index 0000000..8f7500b --- /dev/null +++ b/FreeRTOS/include/mpu_prototypes.h @@ -0,0 +1,177 @@ +/* + FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd. + All rights reserved + + VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION. + + This file is part of the FreeRTOS distribution. + + FreeRTOS is free software; you can redistribute it and/or modify it under + the terms of the GNU General Public License (version 2) as published by the + Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception. + + *************************************************************************** + >>! NOTE: The modification to the GPL is included to allow you to !<< + >>! distribute a combined work that includes FreeRTOS without being !<< + >>! obliged to provide the source code for proprietary components !<< + >>! outside of the FreeRTOS kernel. !<< + *************************************************************************** + + FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY + WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS + FOR A PARTICULAR PURPOSE. Full license text is available on the following + link: http://www.freertos.org/a00114.html + + *************************************************************************** + * * + * FreeRTOS provides completely free yet professionally developed, * + * robust, strictly quality controlled, supported, and cross * + * platform software that is more than just the market leader, it * + * is the industry's de facto standard. * + * * + * Help yourself get started quickly while simultaneously helping * + * to support the FreeRTOS project by purchasing a FreeRTOS * + * tutorial book, reference manual, or both: * + * http://www.FreeRTOS.org/Documentation * + * * + *************************************************************************** + + http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading + the FAQ page "My application does not run, what could be wrong?". Have you + defined configASSERT()? + + http://www.FreeRTOS.org/support - In return for receiving this top quality + embedded software for free we request you assist our global community by + participating in the support forum. + + http://www.FreeRTOS.org/training - Investing in training allows your team to + be as productive as possible as early as possible. Now you can receive + FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers + Ltd, and the world's leading authority on the world's leading RTOS. + + http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products, + including FreeRTOS+Trace - an indispensable productivity tool, a DOS + compatible FAT file system, and our tiny thread aware UDP/IP stack. + + http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate. + Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS. + + http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High + Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS + licenses offer ticketed support, indemnification and commercial middleware. + + http://www.SafeRTOS.com - High Integrity Systems also provide a safety + engineered and independently SIL3 certified version for use in safety and + mission critical applications that require provable dependability. + + 1 tab == 4 spaces! +*/ + +/* + * When the MPU is used the standard (non MPU) API functions are mapped to + * equivalents that start "MPU_", the prototypes for which are defined in this + * header files. This will cause the application code to call the MPU_ version + * which wraps the non-MPU version with privilege promoting then demoting code, + * so the kernel code always runs will full privileges. + */ + + +#ifndef MPU_PROTOTYPES_H +#define MPU_PROTOTYPES_H + +/* MPU versions of tasks.h API function. */ +BaseType_t MPU_xTaskCreate( TaskFunction_t pxTaskCode, const char * const pcName, const uint16_t usStackDepth, void * const pvParameters, UBaseType_t uxPriority, TaskHandle_t * const pxCreatedTask ); +TaskHandle_t MPU_xTaskCreateStatic( TaskFunction_t pxTaskCode, const char * const pcName, const uint32_t ulStackDepth, void * const pvParameters, UBaseType_t uxPriority, StackType_t * const puxStackBuffer, StaticTask_t * const pxTaskBuffer ); +BaseType_t MPU_xTaskCreateRestricted( const TaskParameters_t * const pxTaskDefinition, TaskHandle_t *pxCreatedTask ); +void MPU_vTaskAllocateMPURegions( TaskHandle_t xTask, const MemoryRegion_t * const pxRegions ); +void MPU_vTaskDelete( TaskHandle_t xTaskToDelete ); +void MPU_vTaskDelay( const TickType_t xTicksToDelay ); +void MPU_vTaskDelayUntil( TickType_t * const pxPreviousWakeTime, const TickType_t xTimeIncrement ); +BaseType_t MPU_xTaskAbortDelay( TaskHandle_t xTask ); +UBaseType_t MPU_uxTaskPriorityGet( TaskHandle_t xTask ); +eTaskState MPU_eTaskGetState( TaskHandle_t xTask ); +void MPU_vTaskGetInfo( TaskHandle_t xTask, TaskStatus_t *pxTaskStatus, BaseType_t xGetFreeStackSpace, eTaskState eState ); +void MPU_vTaskPrioritySet( TaskHandle_t xTask, UBaseType_t uxNewPriority ); +void MPU_vTaskSuspend( TaskHandle_t xTaskToSuspend ); +void MPU_vTaskResume( TaskHandle_t xTaskToResume ); +void MPU_vTaskStartScheduler( void ); +void MPU_vTaskSuspendAll( void ); +BaseType_t MPU_xTaskResumeAll( void ); +TickType_t MPU_xTaskGetTickCount( void ); +UBaseType_t MPU_uxTaskGetNumberOfTasks( void ); +char * MPU_pcTaskGetName( TaskHandle_t xTaskToQuery ); +TaskHandle_t MPU_xTaskGetHandle( const char *pcNameToQuery ); +UBaseType_t MPU_uxTaskGetStackHighWaterMark( TaskHandle_t xTask ); +void MPU_vTaskSetApplicationTaskTag( TaskHandle_t xTask, TaskHookFunction_t pxHookFunction ); +TaskHookFunction_t MPU_xTaskGetApplicationTaskTag( TaskHandle_t xTask ); +void MPU_vTaskSetThreadLocalStoragePointer( TaskHandle_t xTaskToSet, BaseType_t xIndex, void *pvValue ); +void * MPU_pvTaskGetThreadLocalStoragePointer( TaskHandle_t xTaskToQuery, BaseType_t xIndex ); +BaseType_t MPU_xTaskCallApplicationTaskHook( TaskHandle_t xTask, void *pvParameter ); +TaskHandle_t MPU_xTaskGetIdleTaskHandle( void ); +UBaseType_t MPU_uxTaskGetSystemState( TaskStatus_t * const pxTaskStatusArray, const UBaseType_t uxArraySize, uint32_t * const pulTotalRunTime ); +void MPU_vTaskList( char * pcWriteBuffer ); +void MPU_vTaskGetRunTimeStats( char *pcWriteBuffer ); +BaseType_t MPU_xTaskGenericNotify( TaskHandle_t xTaskToNotify, uint32_t ulValue, eNotifyAction eAction, uint32_t *pulPreviousNotificationValue ); +BaseType_t MPU_xTaskNotifyWait( uint32_t ulBitsToClearOnEntry, uint32_t ulBitsToClearOnExit, uint32_t *pulNotificationValue, TickType_t xTicksToWait ); +uint32_t MPU_ulTaskNotifyTake( BaseType_t xClearCountOnExit, TickType_t xTicksToWait ); +BaseType_t MPU_xTaskNotifyStateClear( TaskHandle_t xTask ); +BaseType_t MPU_xTaskIncrementTick( void ); +TaskHandle_t MPU_xTaskGetCurrentTaskHandle( void ); +void MPU_vTaskSetTimeOutState( TimeOut_t * const pxTimeOut ); +BaseType_t MPU_xTaskCheckForTimeOut( TimeOut_t * const pxTimeOut, TickType_t * const pxTicksToWait ); +void MPU_vTaskMissedYield( void ); +BaseType_t MPU_xTaskGetSchedulerState( void ); + +/* MPU versions of queue.h API function. */ +BaseType_t MPU_xQueueGenericSend( QueueHandle_t xQueue, const void * const pvItemToQueue, TickType_t xTicksToWait, const BaseType_t xCopyPosition ); +BaseType_t MPU_xQueueGenericReceive( QueueHandle_t xQueue, void * const pvBuffer, TickType_t xTicksToWait, const BaseType_t xJustPeek ); +UBaseType_t MPU_uxQueueMessagesWaiting( const QueueHandle_t xQueue ); +UBaseType_t MPU_uxQueueSpacesAvailable( const QueueHandle_t xQueue ); +void MPU_vQueueDelete( QueueHandle_t xQueue ); +QueueHandle_t MPU_xQueueCreateMutex( const uint8_t ucQueueType ); +QueueHandle_t MPU_xQueueCreateMutexStatic( const uint8_t ucQueueType, StaticQueue_t *pxStaticQueue ); +QueueHandle_t MPU_xQueueCreateCountingSemaphore( const UBaseType_t uxMaxCount, const UBaseType_t uxInitialCount ); +QueueHandle_t MPU_xQueueCreateCountingSemaphoreStatic( const UBaseType_t uxMaxCount, const UBaseType_t uxInitialCount, StaticQueue_t *pxStaticQueue ); +void* MPU_xQueueGetMutexHolder( QueueHandle_t xSemaphore ); +BaseType_t MPU_xQueueTakeMutexRecursive( QueueHandle_t xMutex, TickType_t xTicksToWait ); +BaseType_t MPU_xQueueGiveMutexRecursive( QueueHandle_t pxMutex ); +void MPU_vQueueAddToRegistry( QueueHandle_t xQueue, const char *pcName ); +void MPU_vQueueUnregisterQueue( QueueHandle_t xQueue ); +const char * MPU_pcQueueGetName( QueueHandle_t xQueue ); +QueueHandle_t MPU_xQueueGenericCreate( const UBaseType_t uxQueueLength, const UBaseType_t uxItemSize, const uint8_t ucQueueType ); +QueueHandle_t MPU_xQueueGenericCreateStatic( const UBaseType_t uxQueueLength, const UBaseType_t uxItemSize, uint8_t *pucQueueStorage, StaticQueue_t *pxStaticQueue, const uint8_t ucQueueType ); +QueueSetHandle_t MPU_xQueueCreateSet( const UBaseType_t uxEventQueueLength ); +BaseType_t MPU_xQueueAddToSet( QueueSetMemberHandle_t xQueueOrSemaphore, QueueSetHandle_t xQueueSet ); +BaseType_t MPU_xQueueRemoveFromSet( QueueSetMemberHandle_t xQueueOrSemaphore, QueueSetHandle_t xQueueSet ); +QueueSetMemberHandle_t MPU_xQueueSelectFromSet( QueueSetHandle_t xQueueSet, const TickType_t xTicksToWait ); +BaseType_t MPU_xQueueGenericReset( QueueHandle_t xQueue, BaseType_t xNewQueue ); +void MPU_vQueueSetQueueNumber( QueueHandle_t xQueue, UBaseType_t uxQueueNumber ); +UBaseType_t MPU_uxQueueGetQueueNumber( QueueHandle_t xQueue ); +uint8_t MPU_ucQueueGetQueueType( QueueHandle_t xQueue ); + +/* MPU versions of timers.h API function. */ +TimerHandle_t MPU_xTimerCreate( const char * const pcTimerName, const TickType_t xTimerPeriodInTicks, const UBaseType_t uxAutoReload, void * const pvTimerID, TimerCallbackFunction_t pxCallbackFunction ); +TimerHandle_t MPU_xTimerCreateStatic( const char * const pcTimerName, const TickType_t xTimerPeriodInTicks, const UBaseType_t uxAutoReload, void * const pvTimerID, TimerCallbackFunction_t pxCallbackFunction, StaticTimer_t *pxTimerBuffer ); +void * MPU_pvTimerGetTimerID( const TimerHandle_t xTimer ); +void MPU_vTimerSetTimerID( TimerHandle_t xTimer, void *pvNewID ); +BaseType_t MPU_xTimerIsTimerActive( TimerHandle_t xTimer ); +TaskHandle_t MPU_xTimerGetTimerDaemonTaskHandle( void ); +BaseType_t MPU_xTimerPendFunctionCall( PendedFunction_t xFunctionToPend, void *pvParameter1, uint32_t ulParameter2, TickType_t xTicksToWait ); +const char * MPU_pcTimerGetName( TimerHandle_t xTimer ); +TickType_t MPU_xTimerGetPeriod( TimerHandle_t xTimer ); +TickType_t MPU_xTimerGetExpiryTime( TimerHandle_t xTimer ); +BaseType_t MPU_xTimerCreateTimerTask( void ); +BaseType_t MPU_xTimerGenericCommand( TimerHandle_t xTimer, const BaseType_t xCommandID, const TickType_t xOptionalValue, BaseType_t * const pxHigherPriorityTaskWoken, const TickType_t xTicksToWait ); + +/* MPU versions of event_group.h API function. */ +EventGroupHandle_t MPU_xEventGroupCreate( void ); +EventGroupHandle_t MPU_xEventGroupCreateStatic( StaticEventGroup_t *pxEventGroupBuffer ); +EventBits_t MPU_xEventGroupWaitBits( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToWaitFor, const BaseType_t xClearOnExit, const BaseType_t xWaitForAllBits, TickType_t xTicksToWait ); +EventBits_t MPU_xEventGroupClearBits( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToClear ); +EventBits_t MPU_xEventGroupSetBits( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToSet ); +EventBits_t MPU_xEventGroupSync( EventGroupHandle_t xEventGroup, const EventBits_t uxBitsToSet, const EventBits_t uxBitsToWaitFor, TickType_t xTicksToWait ); +void MPU_vEventGroupDelete( EventGroupHandle_t xEventGroup ); +UBaseType_t MPU_uxEventGroupGetNumber( void* xEventGroup ); + +#endif /* MPU_PROTOTYPES_H */ + diff --git a/FreeRTOS/include/mpu_wrappers.h b/FreeRTOS/include/mpu_wrappers.h new file mode 100644 index 0000000..78f5a9a --- /dev/null +++ b/FreeRTOS/include/mpu_wrappers.h @@ -0,0 +1,201 @@ +/* + FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd. + All rights reserved + + VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION. + + This file is part of the FreeRTOS distribution. + + FreeRTOS is free software; you can redistribute it and/or modify it under + the terms of the GNU General Public License (version 2) as published by the + Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception. + + *************************************************************************** + >>! NOTE: The modification to the GPL is included to allow you to !<< + >>! distribute a combined work that includes FreeRTOS without being !<< + >>! obliged to provide the source code for proprietary components !<< + >>! outside of the FreeRTOS kernel. !<< + *************************************************************************** + + FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY + WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS + FOR A PARTICULAR PURPOSE. Full license text is available on the following + link: http://www.freertos.org/a00114.html + + *************************************************************************** + * * + * FreeRTOS provides completely free yet professionally developed, * + * robust, strictly quality controlled, supported, and cross * + * platform software that is more than just the market leader, it * + * is the industry's de facto standard. * + * * + * Help yourself get started quickly while simultaneously helping * + * to support the FreeRTOS project by purchasing a FreeRTOS * + * tutorial book, reference manual, or both: * + * http://www.FreeRTOS.org/Documentation * + * * + *************************************************************************** + + http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading + the FAQ page "My application does not run, what could be wrong?". Have you + defined configASSERT()? + + http://www.FreeRTOS.org/support - In return for receiving this top quality + embedded software for free we request you assist our global community by + participating in the support forum. + + http://www.FreeRTOS.org/training - Investing in training allows your team to + be as productive as possible as early as possible. Now you can receive + FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers + Ltd, and the world's leading authority on the world's leading RTOS. + + http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products, + including FreeRTOS+Trace - an indispensable productivity tool, a DOS + compatible FAT file system, and our tiny thread aware UDP/IP stack. + + http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate. + Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS. + + http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High + Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS + licenses offer ticketed support, indemnification and commercial middleware. + + http://www.SafeRTOS.com - High Integrity Systems also provide a safety + engineered and independently SIL3 certified version for use in safety and + mission critical applications that require provable dependability. + + 1 tab == 4 spaces! +*/ + +#ifndef MPU_WRAPPERS_H +#define MPU_WRAPPERS_H + +/* This file redefines API functions to be called through a wrapper macro, but +only for ports that are using the MPU. */ +#ifdef portUSING_MPU_WRAPPERS + + /* MPU_WRAPPERS_INCLUDED_FROM_API_FILE will be defined when this file is + included from queue.c or task.c to prevent it from having an effect within + those files. */ + #ifndef MPU_WRAPPERS_INCLUDED_FROM_API_FILE + + /* + * Map standard (non MPU) API functions to equivalents that start + * "MPU_". This will cause the application code to call the MPU_ + * version, which wraps the non-MPU version with privilege promoting + * then demoting code, so the kernel code always runs will full + * privileges. + */ + + /* Map standard tasks.h API functions to the MPU equivalents. */ + #define xTaskCreate MPU_xTaskCreate + #define xTaskCreateStatic MPU_xTaskCreateStatic + #define xTaskCreateRestricted MPU_xTaskCreateRestricted + #define vTaskAllocateMPURegions MPU_vTaskAllocateMPURegions + #define vTaskDelete MPU_vTaskDelete + #define vTaskDelay MPU_vTaskDelay + #define vTaskDelayUntil MPU_vTaskDelayUntil + #define xTaskAbortDelay MPU_xTaskAbortDelay + #define uxTaskPriorityGet MPU_uxTaskPriorityGet + #define eTaskGetState MPU_eTaskGetState + #define vTaskGetInfo MPU_vTaskGetInfo + #define vTaskPrioritySet MPU_vTaskPrioritySet + #define vTaskSuspend MPU_vTaskSuspend + #define vTaskResume MPU_vTaskResume + #define vTaskSuspendAll MPU_vTaskSuspendAll + #define xTaskResumeAll MPU_xTaskResumeAll + #define xTaskGetTickCount MPU_xTaskGetTickCount + #define uxTaskGetNumberOfTasks MPU_uxTaskGetNumberOfTasks + #define pcTaskGetName MPU_pcTaskGetName + #define xTaskGetHandle MPU_xTaskGetHandle + #define uxTaskGetStackHighWaterMark MPU_uxTaskGetStackHighWaterMark + #define vTaskSetApplicationTaskTag MPU_vTaskSetApplicationTaskTag + #define xTaskGetApplicationTaskTag MPU_xTaskGetApplicationTaskTag + #define vTaskSetThreadLocalStoragePointer MPU_vTaskSetThreadLocalStoragePointer + #define pvTaskGetThreadLocalStoragePointer MPU_pvTaskGetThreadLocalStoragePointer + #define xTaskCallApplicationTaskHook MPU_xTaskCallApplicationTaskHook + #define xTaskGetIdleTaskHandle MPU_xTaskGetIdleTaskHandle + #define uxTaskGetSystemState MPU_uxTaskGetSystemState + #define vTaskList MPU_vTaskList + #define vTaskGetRunTimeStats MPU_vTaskGetRunTimeStats + #define xTaskGenericNotify MPU_xTaskGenericNotify + #define xTaskNotifyWait MPU_xTaskNotifyWait + #define ulTaskNotifyTake MPU_ulTaskNotifyTake + #define xTaskNotifyStateClear MPU_xTaskNotifyStateClear + + #define xTaskGetCurrentTaskHandle MPU_xTaskGetCurrentTaskHandle + #define vTaskSetTimeOutState MPU_vTaskSetTimeOutState + #define xTaskCheckForTimeOut MPU_xTaskCheckForTimeOut + #define xTaskGetSchedulerState MPU_xTaskGetSchedulerState + + /* Map standard queue.h API functions to the MPU equivalents. */ + #define xQueueGenericSend MPU_xQueueGenericSend + #define xQueueGenericReceive MPU_xQueueGenericReceive + #define uxQueueMessagesWaiting MPU_uxQueueMessagesWaiting + #define uxQueueSpacesAvailable MPU_uxQueueSpacesAvailable + #define vQueueDelete MPU_vQueueDelete + #define xQueueCreateMutex MPU_xQueueCreateMutex + #define xQueueCreateMutexStatic MPU_xQueueCreateMutexStatic + #define xQueueCreateCountingSemaphore MPU_xQueueCreateCountingSemaphore + #define xQueueCreateCountingSemaphoreStatic MPU_xQueueCreateCountingSemaphoreStatic + #define xQueueGetMutexHolder MPU_xQueueGetMutexHolder + #define xQueueTakeMutexRecursive MPU_xQueueTakeMutexRecursive + #define xQueueGiveMutexRecursive MPU_xQueueGiveMutexRecursive + #define xQueueGenericCreate MPU_xQueueGenericCreate + #define xQueueGenericCreateStatic MPU_xQueueGenericCreateStatic + #define xQueueCreateSet MPU_xQueueCreateSet + #define xQueueAddToSet MPU_xQueueAddToSet + #define xQueueRemoveFromSet MPU_xQueueRemoveFromSet + #define xQueueSelectFromSet MPU_xQueueSelectFromSet + #define xQueueGenericReset MPU_xQueueGenericReset + + #if( configQUEUE_REGISTRY_SIZE > 0 ) + #define vQueueAddToRegistry MPU_vQueueAddToRegistry + #define vQueueUnregisterQueue MPU_vQueueUnregisterQueue + #define pcQueueGetName MPU_pcQueueGetName + #endif + + /* Map standard timer.h API functions to the MPU equivalents. */ + #define xTimerCreate MPU_xTimerCreate + #define xTimerCreateStatic MPU_xTimerCreateStatic + #define pvTimerGetTimerID MPU_pvTimerGetTimerID + #define vTimerSetTimerID MPU_vTimerSetTimerID + #define xTimerIsTimerActive MPU_xTimerIsTimerActive + #define xTimerGetTimerDaemonTaskHandle MPU_xTimerGetTimerDaemonTaskHandle + #define xTimerPendFunctionCall MPU_xTimerPendFunctionCall + #define pcTimerGetName MPU_pcTimerGetName + #define xTimerGetPeriod MPU_xTimerGetPeriod + #define xTimerGetExpiryTime MPU_xTimerGetExpiryTime + #define xTimerGenericCommand MPU_xTimerGenericCommand + + /* Map standard event_group.h API functions to the MPU equivalents. */ + #define xEventGroupCreate MPU_xEventGroupCreate + #define xEventGroupCreateStatic MPU_xEventGroupCreateStatic + #define xEventGroupWaitBits MPU_xEventGroupWaitBits + #define xEventGroupClearBits MPU_xEventGroupClearBits + #define xEventGroupSetBits MPU_xEventGroupSetBits + #define xEventGroupSync MPU_xEventGroupSync + #define vEventGroupDelete MPU_vEventGroupDelete + + /* Remove the privileged function macro. */ + #define PRIVILEGED_FUNCTION + + #else /* MPU_WRAPPERS_INCLUDED_FROM_API_FILE */ + + /* Ensure API functions go in the privileged execution section. */ + #define PRIVILEGED_FUNCTION __attribute__((section("privileged_functions"))) + #define PRIVILEGED_DATA __attribute__((section("privileged_data"))) + + #endif /* MPU_WRAPPERS_INCLUDED_FROM_API_FILE */ + +#else /* portUSING_MPU_WRAPPERS */ + + #define PRIVILEGED_FUNCTION + #define PRIVILEGED_DATA + #define portUSING_MPU_WRAPPERS 0 + +#endif /* portUSING_MPU_WRAPPERS */ + + +#endif /* MPU_WRAPPERS_H */ + diff --git a/FreeRTOS/include/portable.h b/FreeRTOS/include/portable.h new file mode 100644 index 0000000..b9f8be3 --- /dev/null +++ b/FreeRTOS/include/portable.h @@ -0,0 +1,207 @@ +/* + FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd. + All rights reserved + + VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION. + + This file is part of the FreeRTOS distribution. + + FreeRTOS is free software; you can redistribute it and/or modify it under + the terms of the GNU General Public License (version 2) as published by the + Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception. + + *************************************************************************** + >>! NOTE: The modification to the GPL is included to allow you to !<< + >>! distribute a combined work that includes FreeRTOS without being !<< + >>! obliged to provide the source code for proprietary components !<< + >>! outside of the FreeRTOS kernel. !<< + *************************************************************************** + + FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY + WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS + FOR A PARTICULAR PURPOSE. Full license text is available on the following + link: http://www.freertos.org/a00114.html + + *************************************************************************** + * * + * FreeRTOS provides completely free yet professionally developed, * + * robust, strictly quality controlled, supported, and cross * + * platform software that is more than just the market leader, it * + * is the industry's de facto standard. * + * * + * Help yourself get started quickly while simultaneously helping * + * to support the FreeRTOS project by purchasing a FreeRTOS * + * tutorial book, reference manual, or both: * + * http://www.FreeRTOS.org/Documentation * + * * + *************************************************************************** + + http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading + the FAQ page "My application does not run, what could be wrong?". Have you + defined configASSERT()? + + http://www.FreeRTOS.org/support - In return for receiving this top quality + embedded software for free we request you assist our global community by + participating in the support forum. + + http://www.FreeRTOS.org/training - Investing in training allows your team to + be as productive as possible as early as possible. Now you can receive + FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers + Ltd, and the world's leading authority on the world's leading RTOS. + + http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products, + including FreeRTOS+Trace - an indispensable productivity tool, a DOS + compatible FAT file system, and our tiny thread aware UDP/IP stack. + + http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate. + Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS. + + http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High + Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS + licenses offer ticketed support, indemnification and commercial middleware. + + http://www.SafeRTOS.com - High Integrity Systems also provide a safety + engineered and independently SIL3 certified version for use in safety and + mission critical applications that require provable dependability. + + 1 tab == 4 spaces! +*/ + +/*----------------------------------------------------------- + * Portable layer API. Each function must be defined for each port. + *----------------------------------------------------------*/ + +#ifndef PORTABLE_H +#define PORTABLE_H + +/* Each FreeRTOS port has a unique portmacro.h header file. Originally a +pre-processor definition was used to ensure the pre-processor found the correct +portmacro.h file for the port being used. That scheme was deprecated in favour +of setting the compiler's include path such that it found the correct +portmacro.h file - removing the need for the constant and allowing the +portmacro.h file to be located anywhere in relation to the port being used. +Purely for reasons of backward compatibility the old method is still valid, but +to make it clear that new projects should not use it, support for the port +specific constants has been moved into the deprecated_definitions.h header +file. */ +#include "deprecated_definitions.h" + +/* If portENTER_CRITICAL is not defined then including deprecated_definitions.h +did not result in a portmacro.h header file being included - and it should be +included here. In this case the path to the correct portmacro.h header file +must be set in the compiler's include path. */ +#ifndef portENTER_CRITICAL + #include "portmacro.h" +#endif + +#if portBYTE_ALIGNMENT == 32 + #define portBYTE_ALIGNMENT_MASK ( 0x001f ) +#endif + +#if portBYTE_ALIGNMENT == 16 + #define portBYTE_ALIGNMENT_MASK ( 0x000f ) +#endif + +#if portBYTE_ALIGNMENT == 8 + #define portBYTE_ALIGNMENT_MASK ( 0x0007 ) +#endif + +#if portBYTE_ALIGNMENT == 4 + #define portBYTE_ALIGNMENT_MASK ( 0x0003 ) +#endif + +#if portBYTE_ALIGNMENT == 2 + #define portBYTE_ALIGNMENT_MASK ( 0x0001 ) +#endif + +#if portBYTE_ALIGNMENT == 1 + #define portBYTE_ALIGNMENT_MASK ( 0x0000 ) +#endif + +#ifndef portBYTE_ALIGNMENT_MASK + #error "Invalid portBYTE_ALIGNMENT definition" +#endif + +#ifndef portNUM_CONFIGURABLE_REGIONS + #define portNUM_CONFIGURABLE_REGIONS 1 +#endif + +#ifdef __cplusplus +extern "C" { +#endif + +#include "mpu_wrappers.h" + +/* + * Setup the stack of a new task so it is ready to be placed under the + * scheduler control. The registers have to be placed on the stack in + * the order that the port expects to find them. + * + */ +#if( portUSING_MPU_WRAPPERS == 1 ) + StackType_t *pxPortInitialiseStack( StackType_t *pxTopOfStack, TaskFunction_t pxCode, void *pvParameters, BaseType_t xRunPrivileged ) PRIVILEGED_FUNCTION; +#else + StackType_t *pxPortInitialiseStack( StackType_t *pxTopOfStack, TaskFunction_t pxCode, void *pvParameters ) PRIVILEGED_FUNCTION; +#endif + +/* Used by heap_5.c. */ +typedef struct HeapRegion +{ + uint8_t *pucStartAddress; + size_t xSizeInBytes; +} HeapRegion_t; + +/* + * Used to define multiple heap regions for use by heap_5.c. This function + * must be called before any calls to pvPortMalloc() - not creating a task, + * queue, semaphore, mutex, software timer, event group, etc. will result in + * pvPortMalloc being called. + * + * pxHeapRegions passes in an array of HeapRegion_t structures - each of which + * defines a region of memory that can be used as the heap. The array is + * terminated by a HeapRegions_t structure that has a size of 0. The region + * with the lowest start address must appear first in the array. + */ +void vPortDefineHeapRegions( const HeapRegion_t * const pxHeapRegions ) PRIVILEGED_FUNCTION; + + +/* + * Map to the memory management routines required for the port. + */ +void *pvPortMalloc( size_t xSize ) PRIVILEGED_FUNCTION; +void vPortFree( void *pv ) PRIVILEGED_FUNCTION; +void vPortInitialiseBlocks( void ) PRIVILEGED_FUNCTION; +size_t xPortGetFreeHeapSize( void ) PRIVILEGED_FUNCTION; +size_t xPortGetMinimumEverFreeHeapSize( void ) PRIVILEGED_FUNCTION; + +/* + * Setup the hardware ready for the scheduler to take control. This generally + * sets up a tick interrupt and sets timers for the correct tick frequency. + */ +BaseType_t xPortStartScheduler( void ) PRIVILEGED_FUNCTION; + +/* + * Undo any hardware/ISR setup that was performed by xPortStartScheduler() so + * the hardware is left in its original condition after the scheduler stops + * executing. + */ +void vPortEndScheduler( void ) PRIVILEGED_FUNCTION; + +/* + * The structures and methods of manipulating the MPU are contained within the + * port layer. + * + * Fills the xMPUSettings structure with the memory region information + * contained in xRegions. + */ +#if( portUSING_MPU_WRAPPERS == 1 ) + struct xMEMORY_REGION; + void vPortStoreTaskMPUSettings( xMPU_SETTINGS *xMPUSettings, const struct xMEMORY_REGION * const xRegions, StackType_t *pxBottomOfStack, uint32_t ulStackDepth ) PRIVILEGED_FUNCTION; +#endif + +#ifdef __cplusplus +} +#endif + +#endif /* PORTABLE_H */ + diff --git a/FreeRTOS/include/projdefs.h b/FreeRTOS/include/projdefs.h new file mode 100644 index 0000000..0b63fd8 --- /dev/null +++ b/FreeRTOS/include/projdefs.h @@ -0,0 +1,161 @@ +/* + FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd. + All rights reserved + + VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION. + + This file is part of the FreeRTOS distribution. + + FreeRTOS is free software; you can redistribute it and/or modify it under + the terms of the GNU General Public License (version 2) as published by the + Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception. + + *************************************************************************** + >>! NOTE: The modification to the GPL is included to allow you to !<< + >>! distribute a combined work that includes FreeRTOS without being !<< + >>! obliged to provide the source code for proprietary components !<< + >>! outside of the FreeRTOS kernel. !<< + *************************************************************************** + + FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY + WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS + FOR A PARTICULAR PURPOSE. Full license text is available on the following + link: http://www.freertos.org/a00114.html + + *************************************************************************** + * * + * FreeRTOS provides completely free yet professionally developed, * + * robust, strictly quality controlled, supported, and cross * + * platform software that is more than just the market leader, it * + * is the industry's de facto standard. * + * * + * Help yourself get started quickly while simultaneously helping * + * to support the FreeRTOS project by purchasing a FreeRTOS * + * tutorial book, reference manual, or both: * + * http://www.FreeRTOS.org/Documentation * + * * + *************************************************************************** + + http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading + the FAQ page "My application does not run, what could be wrong?". Have you + defined configASSERT()? + + http://www.FreeRTOS.org/support - In return for receiving this top quality + embedded software for free we request you assist our global community by + participating in the support forum. + + http://www.FreeRTOS.org/training - Investing in training allows your team to + be as productive as possible as early as possible. Now you can receive + FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers + Ltd, and the world's leading authority on the world's leading RTOS. + + http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products, + including FreeRTOS+Trace - an indispensable productivity tool, a DOS + compatible FAT file system, and our tiny thread aware UDP/IP stack. + + http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate. + Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS. + + http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High + Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS + licenses offer ticketed support, indemnification and commercial middleware. + + http://www.SafeRTOS.com - High Integrity Systems also provide a safety + engineered and independently SIL3 certified version for use in safety and + mission critical applications that require provable dependability. + + 1 tab == 4 spaces! +*/ + +#ifndef PROJDEFS_H +#define PROJDEFS_H + +/* + * Defines the prototype to which task functions must conform. Defined in this + * file to ensure the type is known before portable.h is included. + */ +typedef void (*TaskFunction_t)( void * ); + +/* Converts a time in milliseconds to a time in ticks. This macro can be +overridden by a macro of the same name defined in FreeRTOSConfig.h in case the +definition here is not suitable for your application. */ +#ifndef pdMS_TO_TICKS + #define pdMS_TO_TICKS( xTimeInMs ) ( ( TickType_t ) ( ( ( TickType_t ) ( xTimeInMs ) * ( TickType_t ) configTICK_RATE_HZ ) / ( TickType_t ) 1000 ) ) +#endif + +#define pdFALSE ( ( BaseType_t ) 0 ) +#define pdTRUE ( ( BaseType_t ) 1 ) + +#define pdPASS ( pdTRUE ) +#define pdFAIL ( pdFALSE ) +#define errQUEUE_EMPTY ( ( BaseType_t ) 0 ) +#define errQUEUE_FULL ( ( BaseType_t ) 0 ) + +/* FreeRTOS error definitions. */ +#define errCOULD_NOT_ALLOCATE_REQUIRED_MEMORY ( -1 ) +#define errQUEUE_BLOCKED ( -4 ) +#define errQUEUE_YIELD ( -5 ) + +/* Macros used for basic data corruption checks. */ +#ifndef configUSE_LIST_DATA_INTEGRITY_CHECK_BYTES + #define configUSE_LIST_DATA_INTEGRITY_CHECK_BYTES 0 +#endif + +#if( configUSE_16_BIT_TICKS == 1 ) + #define pdINTEGRITY_CHECK_VALUE 0x5a5a +#else + #define pdINTEGRITY_CHECK_VALUE 0x5a5a5a5aUL +#endif + +/* The following errno values are used by FreeRTOS+ components, not FreeRTOS +itself. */ +#define pdFREERTOS_ERRNO_NONE 0 /* No errors */ +#define pdFREERTOS_ERRNO_ENOENT 2 /* No such file or directory */ +#define pdFREERTOS_ERRNO_EINTR 4 /* Interrupted system call */ +#define pdFREERTOS_ERRNO_EIO 5 /* I/O error */ +#define pdFREERTOS_ERRNO_ENXIO 6 /* No such device or address */ +#define pdFREERTOS_ERRNO_EBADF 9 /* Bad file number */ +#define pdFREERTOS_ERRNO_EAGAIN 11 /* No more processes */ +#define pdFREERTOS_ERRNO_EWOULDBLOCK 11 /* Operation would block */ +#define pdFREERTOS_ERRNO_ENOMEM 12 /* Not enough memory */ +#define pdFREERTOS_ERRNO_EACCES 13 /* Permission denied */ +#define pdFREERTOS_ERRNO_EFAULT 14 /* Bad address */ +#define pdFREERTOS_ERRNO_EBUSY 16 /* Mount device busy */ +#define pdFREERTOS_ERRNO_EEXIST 17 /* File exists */ +#define pdFREERTOS_ERRNO_EXDEV 18 /* Cross-device link */ +#define pdFREERTOS_ERRNO_ENODEV 19 /* No such device */ +#define pdFREERTOS_ERRNO_ENOTDIR 20 /* Not a directory */ +#define pdFREERTOS_ERRNO_EISDIR 21 /* Is a directory */ +#define pdFREERTOS_ERRNO_EINVAL 22 /* Invalid argument */ +#define pdFREERTOS_ERRNO_ENOSPC 28 /* No space left on device */ +#define pdFREERTOS_ERRNO_ESPIPE 29 /* Illegal seek */ +#define pdFREERTOS_ERRNO_EROFS 30 /* Read only file system */ +#define pdFREERTOS_ERRNO_EUNATCH 42 /* Protocol driver not attached */ +#define pdFREERTOS_ERRNO_EBADE 50 /* Invalid exchange */ +#define pdFREERTOS_ERRNO_EFTYPE 79 /* Inappropriate file type or format */ +#define pdFREERTOS_ERRNO_ENMFILE 89 /* No more files */ +#define pdFREERTOS_ERRNO_ENOTEMPTY 90 /* Directory not empty */ +#define pdFREERTOS_ERRNO_ENAMETOOLONG 91 /* File or path name too long */ +#define pdFREERTOS_ERRNO_EOPNOTSUPP 95 /* Operation not supported on transport endpoint */ +#define pdFREERTOS_ERRNO_ENOBUFS 105 /* No buffer space available */ +#define pdFREERTOS_ERRNO_ENOPROTOOPT 109 /* Protocol not available */ +#define pdFREERTOS_ERRNO_EADDRINUSE 112 /* Address already in use */ +#define pdFREERTOS_ERRNO_ETIMEDOUT 116 /* Connection timed out */ +#define pdFREERTOS_ERRNO_EINPROGRESS 119 /* Connection already in progress */ +#define pdFREERTOS_ERRNO_EALREADY 120 /* Socket already connected */ +#define pdFREERTOS_ERRNO_EADDRNOTAVAIL 125 /* Address not available */ +#define pdFREERTOS_ERRNO_EISCONN 127 /* Socket is already connected */ +#define pdFREERTOS_ERRNO_ENOTCONN 128 /* Socket is not connected */ +#define pdFREERTOS_ERRNO_ENOMEDIUM 135 /* No medium inserted */ +#define pdFREERTOS_ERRNO_EILSEQ 138 /* An invalid UTF-16 sequence was encountered. */ +#define pdFREERTOS_ERRNO_ECANCELED 140 /* Operation canceled. */ + +/* The following endian values are used by FreeRTOS+ components, not FreeRTOS +itself. */ +#define pdFREERTOS_LITTLE_ENDIAN 0 +#define pdFREERTOS_BIG_ENDIAN 1 + +#endif /* PROJDEFS_H */ + + + diff --git a/FreeRTOS/include/queue.h b/FreeRTOS/include/queue.h new file mode 100644 index 0000000..30be360 --- /dev/null +++ b/FreeRTOS/include/queue.h @@ -0,0 +1,1798 @@ +/* + FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd. + All rights reserved + + VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION. + + This file is part of the FreeRTOS distribution. + + FreeRTOS is free software; you can redistribute it and/or modify it under + the terms of the GNU General Public License (version 2) as published by the + Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception. + + *************************************************************************** + >>! NOTE: The modification to the GPL is included to allow you to !<< + >>! distribute a combined work that includes FreeRTOS without being !<< + >>! obliged to provide the source code for proprietary components !<< + >>! outside of the FreeRTOS kernel. !<< + *************************************************************************** + + FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY + WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS + FOR A PARTICULAR PURPOSE. Full license text is available on the following + link: http://www.freertos.org/a00114.html + + *************************************************************************** + * * + * FreeRTOS provides completely free yet professionally developed, * + * robust, strictly quality controlled, supported, and cross * + * platform software that is more than just the market leader, it * + * is the industry's de facto standard. * + * * + * Help yourself get started quickly while simultaneously helping * + * to support the FreeRTOS project by purchasing a FreeRTOS * + * tutorial book, reference manual, or both: * + * http://www.FreeRTOS.org/Documentation * + * * + *************************************************************************** + + http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading + the FAQ page "My application does not run, what could be wrong?". Have you + defined configASSERT()? + + http://www.FreeRTOS.org/support - In return for receiving this top quality + embedded software for free we request you assist our global community by + participating in the support forum. + + http://www.FreeRTOS.org/training - Investing in training allows your team to + be as productive as possible as early as possible. Now you can receive + FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers + Ltd, and the world's leading authority on the world's leading RTOS. + + http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products, + including FreeRTOS+Trace - an indispensable productivity tool, a DOS + compatible FAT file system, and our tiny thread aware UDP/IP stack. + + http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate. + Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS. + + http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High + Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS + licenses offer ticketed support, indemnification and commercial middleware. + + http://www.SafeRTOS.com - High Integrity Systems also provide a safety + engineered and independently SIL3 certified version for use in safety and + mission critical applications that require provable dependability. + + 1 tab == 4 spaces! +*/ + + +#ifndef QUEUE_H +#define QUEUE_H + +#ifndef INC_FREERTOS_H + #error "include FreeRTOS.h" must appear in source files before "include queue.h" +#endif + +#ifdef __cplusplus +extern "C" { +#endif + + +/** + * Type by which queues are referenced. For example, a call to xQueueCreate() + * returns an QueueHandle_t variable that can then be used as a parameter to + * xQueueSend(), xQueueReceive(), etc. + */ +typedef void * QueueHandle_t; + +/** + * Type by which queue sets are referenced. For example, a call to + * xQueueCreateSet() returns an xQueueSet variable that can then be used as a + * parameter to xQueueSelectFromSet(), xQueueAddToSet(), etc. + */ +typedef void * QueueSetHandle_t; + +/** + * Queue sets can contain both queues and semaphores, so the + * QueueSetMemberHandle_t is defined as a type to be used where a parameter or + * return value can be either an QueueHandle_t or an SemaphoreHandle_t. + */ +typedef void * QueueSetMemberHandle_t; + +/* For internal use only. */ +#define queueSEND_TO_BACK ( ( BaseType_t ) 0 ) +#define queueSEND_TO_FRONT ( ( BaseType_t ) 1 ) +#define queueOVERWRITE ( ( BaseType_t ) 2 ) + +/* For internal use only. These definitions *must* match those in queue.c. */ +#define queueQUEUE_TYPE_BASE ( ( uint8_t ) 0U ) +#define queueQUEUE_TYPE_SET ( ( uint8_t ) 0U ) +#define queueQUEUE_TYPE_MUTEX ( ( uint8_t ) 1U ) +#define queueQUEUE_TYPE_COUNTING_SEMAPHORE ( ( uint8_t ) 2U ) +#define queueQUEUE_TYPE_BINARY_SEMAPHORE ( ( uint8_t ) 3U ) +#define queueQUEUE_TYPE_RECURSIVE_MUTEX ( ( uint8_t ) 4U ) + +/** + * queue. h + * 
+ QueueHandle_t xQueueCreate(
+							  UBaseType_t uxQueueLength,
+							  UBaseType_t uxItemSize
+						  );
+ *
+ * + * Creates a new queue instance, and returns a handle by which the new queue + * can be referenced. + * + * Internally, within the FreeRTOS implementation, queues use two blocks of + * memory. The first block is used to hold the queue's data structures. The + * second block is used to hold items placed into the queue. If a queue is + * created using xQueueCreate() then both blocks of memory are automatically + * dynamically allocated inside the xQueueCreate() function. (see + * http://www.freertos.org/a00111.html). If a queue is created using + * xQueueCreateStatic() then the application writer must provide the memory that + * will get used by the queue. xQueueCreateStatic() therefore allows a queue to + * be created without using any dynamic memory allocation. + * + * http://www.FreeRTOS.org/Embedded-RTOS-Queues.html + * + * @param uxQueueLength The maximum number of items that the queue can contain. + * + * @param uxItemSize The number of bytes each item in the queue will require. + * Items are queued by copy, not by reference, so this is the number of bytes + * that will be copied for each posted item. Each item on the queue must be + * the same size. + * + * @return If the queue is successfully create then a handle to the newly + * created queue is returned. If the queue cannot be created then 0 is + * returned. + * + * Example usage: + 
+ struct AMessage
+ {
+	char ucMessageID;
+	char ucData[ 20 ];
+ };
+
+ void vATask( void *pvParameters )
+ {
+ QueueHandle_t xQueue1, xQueue2;
+
+	// Create a queue capable of containing 10 uint32_t values.
+	xQueue1 = xQueueCreate( 10, sizeof( uint32_t ) );
+	if( xQueue1 == 0 )
+	{
+		// Queue was not created and must not be used.
+	}
+
+	// Create a queue capable of containing 10 pointers to AMessage structures.
+	// These should be passed by pointer as they contain a lot of data.
+	xQueue2 = xQueueCreate( 10, sizeof( struct AMessage * ) );
+	if( xQueue2 == 0 )
+	{
+		// Queue was not created and must not be used.
+	}
+
+	// ... Rest of task code.
+ }
+
+ * \defgroup xQueueCreate xQueueCreate + * \ingroup QueueManagement + */ +#if( configSUPPORT_DYNAMIC_ALLOCATION == 1 ) + #define xQueueCreate( uxQueueLength, uxItemSize ) xQueueGenericCreate( ( uxQueueLength ), ( uxItemSize ), ( queueQUEUE_TYPE_BASE ) ) +#endif + +/** + * queue. h + * 
+ QueueHandle_t xQueueCreateStatic(
+							  UBaseType_t uxQueueLength,
+							  UBaseType_t uxItemSize,
+							  uint8_t *pucQueueStorageBuffer,
+							  StaticQueue_t *pxQueueBuffer
+						  );
+ *
+ * + * Creates a new queue instance, and returns a handle by which the new queue + * can be referenced. + * + * Internally, within the FreeRTOS implementation, queues use two blocks of + * memory. The first block is used to hold the queue's data structures. The + * second block is used to hold items placed into the queue. If a queue is + * created using xQueueCreate() then both blocks of memory are automatically + * dynamically allocated inside the xQueueCreate() function. (see + * http://www.freertos.org/a00111.html). If a queue is created using + * xQueueCreateStatic() then the application writer must provide the memory that + * will get used by the queue. xQueueCreateStatic() therefore allows a queue to + * be created without using any dynamic memory allocation. + * + * http://www.FreeRTOS.org/Embedded-RTOS-Queues.html + * + * @param uxQueueLength The maximum number of items that the queue can contain. + * + * @param uxItemSize The number of bytes each item in the queue will require. + * Items are queued by copy, not by reference, so this is the number of bytes + * that will be copied for each posted item. Each item on the queue must be + * the same size. + * + * @param pucQueueStorageBuffer If uxItemSize is not zero then + * pucQueueStorageBuffer must point to a uint8_t array that is at least large + * enough to hold the maximum number of items that can be in the queue at any + * one time - which is ( uxQueueLength * uxItemsSize ) bytes. If uxItemSize is + * zero then pucQueueStorageBuffer can be NULL. + * + * @param pxQueueBuffer Must point to a variable of type StaticQueue_t, which + * will be used to hold the queue's data structure. + * + * @return If the queue is created then a handle to the created queue is + * returned. If pxQueueBuffer is NULL then NULL is returned. + * + * Example usage: + 
+ struct AMessage
+ {
+	char ucMessageID;
+	char ucData[ 20 ];
+ };
+
+ #define QUEUE_LENGTH 10
+ #define ITEM_SIZE sizeof( uint32_t )
+
+ // xQueueBuffer will hold the queue structure.
+ StaticQueue_t xQueueBuffer;
+
+ // ucQueueStorage will hold the items posted to the queue.  Must be at least
+ // [(queue length) * ( queue item size)] bytes long.
+ uint8_t ucQueueStorage[ QUEUE_LENGTH * ITEM_SIZE ];
+
+ void vATask( void *pvParameters )
+ {
+ QueueHandle_t xQueue1;
+
+	// Create a queue capable of containing 10 uint32_t values.
+	xQueue1 = xQueueCreate( QUEUE_LENGTH, // The number of items the queue can hold.
+							ITEM_SIZE	  // The size of each item in the queue
+							&( ucQueueStorage[ 0 ] ), // The buffer that will hold the items in the queue.
+							&xQueueBuffer ); // The buffer that will hold the queue structure.
+
+	// The queue is guaranteed to be created successfully as no dynamic memory
+	// allocation is used.  Therefore xQueue1 is now a handle to a valid queue.
+
+	// ... Rest of task code.
+ }
+
+ * \defgroup xQueueCreateStatic xQueueCreateStatic + * \ingroup QueueManagement + */ +#if( configSUPPORT_STATIC_ALLOCATION == 1 ) + #define xQueueCreateStatic( uxQueueLength, uxItemSize, pucQueueStorage, pxQueueBuffer ) xQueueGenericCreateStatic( ( uxQueueLength ), ( uxItemSize ), ( pucQueueStorage ), ( pxQueueBuffer ), ( queueQUEUE_TYPE_BASE ) ) +#endif /* configSUPPORT_STATIC_ALLOCATION */ + +/** + * queue. h + * 
+ BaseType_t xQueueSendToToFront(
+								   QueueHandle_t	xQueue,
+								   const void		*pvItemToQueue,
+								   TickType_t		xTicksToWait
+							   );
+ *
+ * + * This is a macro that calls xQueueGenericSend(). + * + * Post an item to the front of a queue. The item is queued by copy, not by + * reference. This function must not be called from an interrupt service + * routine. See xQueueSendFromISR () for an alternative which may be used + * in an ISR. + * + * @param xQueue The handle to the queue on which the item is to be posted. + * + * @param pvItemToQueue A pointer to the item that is to be placed on the + * queue. The size of the items the queue will hold was defined when the + * queue was created, so this many bytes will be copied from pvItemToQueue + * into the queue storage area. + * + * @param xTicksToWait The maximum amount of time the task should block + * waiting for space to become available on the queue, should it already + * be full. The call will return immediately if this is set to 0 and the + * queue is full. The time is defined in tick periods so the constant + * portTICK_PERIOD_MS should be used to convert to real time if this is required. + * + * @return pdTRUE if the item was successfully posted, otherwise errQUEUE_FULL. + * + * Example usage: + 
+ struct AMessage
+ {
+	char ucMessageID;
+	char ucData[ 20 ];
+ } xMessage;
+
+ uint32_t ulVar = 10UL;
+
+ void vATask( void *pvParameters )
+ {
+ QueueHandle_t xQueue1, xQueue2;
+ struct AMessage *pxMessage;
+
+	// Create a queue capable of containing 10 uint32_t values.
+	xQueue1 = xQueueCreate( 10, sizeof( uint32_t ) );
+
+	// Create a queue capable of containing 10 pointers to AMessage structures.
+	// These should be passed by pointer as they contain a lot of data.
+	xQueue2 = xQueueCreate( 10, sizeof( struct AMessage * ) );
+
+	// ...
+
+	if( xQueue1 != 0 )
+	{
+		// Send an uint32_t.  Wait for 10 ticks for space to become
+		// available if necessary.
+		if( xQueueSendToFront( xQueue1, ( void * ) &ulVar, ( TickType_t ) 10 ) != pdPASS )
+		{
+			// Failed to post the message, even after 10 ticks.
+		}
+	}
+
+	if( xQueue2 != 0 )
+	{
+		// Send a pointer to a struct AMessage object.  Don't block if the
+		// queue is already full.
+		pxMessage = & xMessage;
+		xQueueSendToFront( xQueue2, ( void * ) &pxMessage, ( TickType_t ) 0 );
+	}
+
+	// ... Rest of task code.
+ }
+
+ * \defgroup xQueueSend xQueueSend + * \ingroup QueueManagement + */ +#define xQueueSendToFront( xQueue, pvItemToQueue, xTicksToWait ) xQueueGenericSend( ( xQueue ), ( pvItemToQueue ), ( xTicksToWait ), queueSEND_TO_FRONT ) + +/** + * queue. h + * 
+ BaseType_t xQueueSendToBack(
+								   QueueHandle_t	xQueue,
+								   const void		*pvItemToQueue,
+								   TickType_t		xTicksToWait
+							   );
+ *
+ * + * This is a macro that calls xQueueGenericSend(). + * + * Post an item to the back of a queue. The item is queued by copy, not by + * reference. This function must not be called from an interrupt service + * routine. See xQueueSendFromISR () for an alternative which may be used + * in an ISR. + * + * @param xQueue The handle to the queue on which the item is to be posted. + * + * @param pvItemToQueue A pointer to the item that is to be placed on the + * queue. The size of the items the queue will hold was defined when the + * queue was created, so this many bytes will be copied from pvItemToQueue + * into the queue storage area. + * + * @param xTicksToWait The maximum amount of time the task should block + * waiting for space to become available on the queue, should it already + * be full. The call will return immediately if this is set to 0 and the queue + * is full. The time is defined in tick periods so the constant + * portTICK_PERIOD_MS should be used to convert to real time if this is required. + * + * @return pdTRUE if the item was successfully posted, otherwise errQUEUE_FULL. + * + * Example usage: + 
+ struct AMessage
+ {
+	char ucMessageID;
+	char ucData[ 20 ];
+ } xMessage;
+
+ uint32_t ulVar = 10UL;
+
+ void vATask( void *pvParameters )
+ {
+ QueueHandle_t xQueue1, xQueue2;
+ struct AMessage *pxMessage;
+
+	// Create a queue capable of containing 10 uint32_t values.
+	xQueue1 = xQueueCreate( 10, sizeof( uint32_t ) );
+
+	// Create a queue capable of containing 10 pointers to AMessage structures.
+	// These should be passed by pointer as they contain a lot of data.
+	xQueue2 = xQueueCreate( 10, sizeof( struct AMessage * ) );
+
+	// ...
+
+	if( xQueue1 != 0 )
+	{
+		// Send an uint32_t.  Wait for 10 ticks for space to become
+		// available if necessary.
+		if( xQueueSendToBack( xQueue1, ( void * ) &ulVar, ( TickType_t ) 10 ) != pdPASS )
+		{
+			// Failed to post the message, even after 10 ticks.
+		}
+	}
+
+	if( xQueue2 != 0 )
+	{
+		// Send a pointer to a struct AMessage object.  Don't block if the
+		// queue is already full.
+		pxMessage = & xMessage;
+		xQueueSendToBack( xQueue2, ( void * ) &pxMessage, ( TickType_t ) 0 );
+	}
+
+	// ... Rest of task code.
+ }
+
+ * \defgroup xQueueSend xQueueSend + * \ingroup QueueManagement + */ +#define xQueueSendToBack( xQueue, pvItemToQueue, xTicksToWait ) xQueueGenericSend( ( xQueue ), ( pvItemToQueue ), ( xTicksToWait ), queueSEND_TO_BACK ) + +/** + * queue. h + * 
+ BaseType_t xQueueSend(
+							  QueueHandle_t xQueue,
+							  const void * pvItemToQueue,
+							  TickType_t xTicksToWait
+						 );
+ *
+ * + * This is a macro that calls xQueueGenericSend(). It is included for + * backward compatibility with versions of FreeRTOS.org that did not + * include the xQueueSendToFront() and xQueueSendToBack() macros. It is + * equivalent to xQueueSendToBack(). + * + * Post an item on a queue. The item is queued by copy, not by reference. + * This function must not be called from an interrupt service routine. + * See xQueueSendFromISR () for an alternative which may be used in an ISR. + * + * @param xQueue The handle to the queue on which the item is to be posted. + * + * @param pvItemToQueue A pointer to the item that is to be placed on the + * queue. The size of the items the queue will hold was defined when the + * queue was created, so this many bytes will be copied from pvItemToQueue + * into the queue storage area. + * + * @param xTicksToWait The maximum amount of time the task should block + * waiting for space to become available on the queue, should it already + * be full. The call will return immediately if this is set to 0 and the + * queue is full. The time is defined in tick periods so the constant + * portTICK_PERIOD_MS should be used to convert to real time if this is required. + * + * @return pdTRUE if the item was successfully posted, otherwise errQUEUE_FULL. + * + * Example usage: + 
+ struct AMessage
+ {
+	char ucMessageID;
+	char ucData[ 20 ];
+ } xMessage;
+
+ uint32_t ulVar = 10UL;
+
+ void vATask( void *pvParameters )
+ {
+ QueueHandle_t xQueue1, xQueue2;
+ struct AMessage *pxMessage;
+
+	// Create a queue capable of containing 10 uint32_t values.
+	xQueue1 = xQueueCreate( 10, sizeof( uint32_t ) );
+
+	// Create a queue capable of containing 10 pointers to AMessage structures.
+	// These should be passed by pointer as they contain a lot of data.
+	xQueue2 = xQueueCreate( 10, sizeof( struct AMessage * ) );
+
+	// ...
+
+	if( xQueue1 != 0 )
+	{
+		// Send an uint32_t.  Wait for 10 ticks for space to become
+		// available if necessary.
+		if( xQueueSend( xQueue1, ( void * ) &ulVar, ( TickType_t ) 10 ) != pdPASS )
+		{
+			// Failed to post the message, even after 10 ticks.
+		}
+	}
+
+	if( xQueue2 != 0 )
+	{
+		// Send a pointer to a struct AMessage object.  Don't block if the
+		// queue is already full.
+		pxMessage = & xMessage;
+		xQueueSend( xQueue2, ( void * ) &pxMessage, ( TickType_t ) 0 );
+	}
+
+	// ... Rest of task code.
+ }
+
+ * \defgroup xQueueSend xQueueSend + * \ingroup QueueManagement + */ +#define xQueueSend( xQueue, pvItemToQueue, xTicksToWait ) xQueueGenericSend( ( xQueue ), ( pvItemToQueue ), ( xTicksToWait ), queueSEND_TO_BACK ) + +/** + * queue. h + * 
+ BaseType_t xQueueOverwrite(
+							  QueueHandle_t xQueue,
+							  const void * pvItemToQueue
+						 );
+ *
+ * + * Only for use with queues that have a length of one - so the queue is either + * empty or full. + * + * Post an item on a queue. If the queue is already full then overwrite the + * value held in the queue. The item is queued by copy, not by reference. + * + * This function must not be called from an interrupt service routine. + * See xQueueOverwriteFromISR () for an alternative which may be used in an ISR. + * + * @param xQueue The handle of the queue to which the data is being sent. + * + * @param pvItemToQueue A pointer to the item that is to be placed on the + * queue. The size of the items the queue will hold was defined when the + * queue was created, so this many bytes will be copied from pvItemToQueue + * into the queue storage area. + * + * @return xQueueOverwrite() is a macro that calls xQueueGenericSend(), and + * therefore has the same return values as xQueueSendToFront(). However, pdPASS + * is the only value that can be returned because xQueueOverwrite() will write + * to the queue even when the queue is already full. + * + * Example usage: + 
+
+ void vFunction( void *pvParameters )
+ {
+ QueueHandle_t xQueue;
+ uint32_t ulVarToSend, ulValReceived;
+
+	// Create a queue to hold one uint32_t value.  It is strongly
+	// recommended *not* to use xQueueOverwrite() on queues that can
+	// contain more than one value, and doing so will trigger an assertion
+	// if configASSERT() is defined.
+	xQueue = xQueueCreate( 1, sizeof( uint32_t ) );
+
+	// Write the value 10 to the queue using xQueueOverwrite().
+	ulVarToSend = 10;
+	xQueueOverwrite( xQueue, &ulVarToSend );
+
+	// Peeking the queue should now return 10, but leave the value 10 in
+	// the queue.  A block time of zero is used as it is known that the
+	// queue holds a value.
+	ulValReceived = 0;
+	xQueuePeek( xQueue, &ulValReceived, 0 );
+
+	if( ulValReceived != 10 )
+	{
+		// Error unless the item was removed by a different task.
+	}
+
+	// The queue is still full.  Use xQueueOverwrite() to overwrite the
+	// value held in the queue with 100.
+	ulVarToSend = 100;
+	xQueueOverwrite( xQueue, &ulVarToSend );
+
+	// This time read from the queue, leaving the queue empty once more.
+	// A block time of 0 is used again.
+	xQueueReceive( xQueue, &ulValReceived, 0 );
+
+	// The value read should be the last value written, even though the
+	// queue was already full when the value was written.
+	if( ulValReceived != 100 )
+	{
+		// Error!
+	}
+
+	// ...
+}
+
+ * \defgroup xQueueOverwrite xQueueOverwrite + * \ingroup QueueManagement + */ +#define xQueueOverwrite( xQueue, pvItemToQueue ) xQueueGenericSend( ( xQueue ), ( pvItemToQueue ), 0, queueOVERWRITE ) + + +/** + * queue. h + * 
+ BaseType_t xQueueGenericSend(
+									QueueHandle_t xQueue,
+									const void * pvItemToQueue,
+									TickType_t xTicksToWait
+									BaseType_t xCopyPosition
+								);
+ *
+ * + * It is preferred that the macros xQueueSend(), xQueueSendToFront() and + * xQueueSendToBack() are used in place of calling this function directly. + * + * Post an item on a queue. The item is queued by copy, not by reference. + * This function must not be called from an interrupt service routine. + * See xQueueSendFromISR () for an alternative which may be used in an ISR. + * + * @param xQueue The handle to the queue on which the item is to be posted. + * + * @param pvItemToQueue A pointer to the item that is to be placed on the + * queue. The size of the items the queue will hold was defined when the + * queue was created, so this many bytes will be copied from pvItemToQueue + * into the queue storage area. + * + * @param xTicksToWait The maximum amount of time the task should block + * waiting for space to become available on the queue, should it already + * be full. The call will return immediately if this is set to 0 and the + * queue is full. The time is defined in tick periods so the constant + * portTICK_PERIOD_MS should be used to convert to real time if this is required. + * + * @param xCopyPosition Can take the value queueSEND_TO_BACK to place the + * item at the back of the queue, or queueSEND_TO_FRONT to place the item + * at the front of the queue (for high priority messages). + * + * @return pdTRUE if the item was successfully posted, otherwise errQUEUE_FULL. + * + * Example usage: + 
+ struct AMessage
+ {
+	char ucMessageID;
+	char ucData[ 20 ];
+ } xMessage;
+
+ uint32_t ulVar = 10UL;
+
+ void vATask( void *pvParameters )
+ {
+ QueueHandle_t xQueue1, xQueue2;
+ struct AMessage *pxMessage;
+
+	// Create a queue capable of containing 10 uint32_t values.
+	xQueue1 = xQueueCreate( 10, sizeof( uint32_t ) );
+
+	// Create a queue capable of containing 10 pointers to AMessage structures.
+	// These should be passed by pointer as they contain a lot of data.
+	xQueue2 = xQueueCreate( 10, sizeof( struct AMessage * ) );
+
+	// ...
+
+	if( xQueue1 != 0 )
+	{
+		// Send an uint32_t.  Wait for 10 ticks for space to become
+		// available if necessary.
+		if( xQueueGenericSend( xQueue1, ( void * ) &ulVar, ( TickType_t ) 10, queueSEND_TO_BACK ) != pdPASS )
+		{
+			// Failed to post the message, even after 10 ticks.
+		}
+	}
+
+	if( xQueue2 != 0 )
+	{
+		// Send a pointer to a struct AMessage object.  Don't block if the
+		// queue is already full.
+		pxMessage = & xMessage;
+		xQueueGenericSend( xQueue2, ( void * ) &pxMessage, ( TickType_t ) 0, queueSEND_TO_BACK );
+	}
+
+	// ... Rest of task code.
+ }
+
+ * \defgroup xQueueSend xQueueSend + * \ingroup QueueManagement + */ +BaseType_t xQueueGenericSend( QueueHandle_t xQueue, const void * const pvItemToQueue, TickType_t xTicksToWait, const BaseType_t xCopyPosition ) PRIVILEGED_FUNCTION; + +/** + * queue. h + * 
+ BaseType_t xQueuePeek(
+							 QueueHandle_t xQueue,
+							 void *pvBuffer,
+							 TickType_t xTicksToWait
+						 );
+ * + * This is a macro that calls the xQueueGenericReceive() function. + * + * Receive an item from a queue without removing the item from the queue. + * The item is received by copy so a buffer of adequate size must be + * provided. The number of bytes copied into the buffer was defined when + * the queue was created. + * + * Successfully received items remain on the queue so will be returned again + * by the next call, or a call to xQueueReceive(). + * + * This macro must not be used in an interrupt service routine. See + * xQueuePeekFromISR() for an alternative that can be called from an interrupt + * service routine. + * + * @param xQueue The handle to the queue from which the item is to be + * received. + * + * @param pvBuffer Pointer to the buffer into which the received item will + * be copied. + * + * @param xTicksToWait The maximum amount of time the task should block + * waiting for an item to receive should the queue be empty at the time + * of the call. The time is defined in tick periods so the constant + * portTICK_PERIOD_MS should be used to convert to real time if this is required. + * xQueuePeek() will return immediately if xTicksToWait is 0 and the queue + * is empty. + * + * @return pdTRUE if an item was successfully received from the queue, + * otherwise pdFALSE. + * + * Example usage: + 
+ struct AMessage
+ {
+	char ucMessageID;
+	char ucData[ 20 ];
+ } xMessage;
+
+ QueueHandle_t xQueue;
+
+ // Task to create a queue and post a value.
+ void vATask( void *pvParameters )
+ {
+ struct AMessage *pxMessage;
+
+	// Create a queue capable of containing 10 pointers to AMessage structures.
+	// These should be passed by pointer as they contain a lot of data.
+	xQueue = xQueueCreate( 10, sizeof( struct AMessage * ) );
+	if( xQueue == 0 )
+	{
+		// Failed to create the queue.
+	}
+
+	// ...
+
+	// Send a pointer to a struct AMessage object.  Don't block if the
+	// queue is already full.
+	pxMessage = & xMessage;
+	xQueueSend( xQueue, ( void * ) &pxMessage, ( TickType_t ) 0 );
+
+	// ... Rest of task code.
+ }
+
+ // Task to peek the data from the queue.
+ void vADifferentTask( void *pvParameters )
+ {
+ struct AMessage *pxRxedMessage;
+
+	if( xQueue != 0 )
+	{
+		// Peek a message on the created queue.  Block for 10 ticks if a
+		// message is not immediately available.
+		if( xQueuePeek( xQueue, &( pxRxedMessage ), ( TickType_t ) 10 ) )
+		{
+			// pcRxedMessage now points to the struct AMessage variable posted
+			// by vATask, but the item still remains on the queue.
+		}
+	}
+
+	// ... Rest of task code.
+ }
+
+ * \defgroup xQueueReceive xQueueReceive + * \ingroup QueueManagement + */ +#define xQueuePeek( xQueue, pvBuffer, xTicksToWait ) xQueueGenericReceive( ( xQueue ), ( pvBuffer ), ( xTicksToWait ), pdTRUE ) + +/** + * queue. h + * 
+ BaseType_t xQueuePeekFromISR(
+									QueueHandle_t xQueue,
+									void *pvBuffer,
+								);
+ * + * A version of xQueuePeek() that can be called from an interrupt service + * routine (ISR). + * + * Receive an item from a queue without removing the item from the queue. + * The item is received by copy so a buffer of adequate size must be + * provided. The number of bytes copied into the buffer was defined when + * the queue was created. + * + * Successfully received items remain on the queue so will be returned again + * by the next call, or a call to xQueueReceive(). + * + * @param xQueue The handle to the queue from which the item is to be + * received. + * + * @param pvBuffer Pointer to the buffer into which the received item will + * be copied. + * + * @return pdTRUE if an item was successfully received from the queue, + * otherwise pdFALSE. + * + * \defgroup xQueuePeekFromISR xQueuePeekFromISR + * \ingroup QueueManagement + */ +BaseType_t xQueuePeekFromISR( QueueHandle_t xQueue, void * const pvBuffer ) PRIVILEGED_FUNCTION; + +/** + * queue. h + * 
+ BaseType_t xQueueReceive(
+								 QueueHandle_t xQueue,
+								 void *pvBuffer,
+								 TickType_t xTicksToWait
+							);
+ * + * This is a macro that calls the xQueueGenericReceive() function. + * + * Receive an item from a queue. The item is received by copy so a buffer of + * adequate size must be provided. The number of bytes copied into the buffer + * was defined when the queue was created. + * + * Successfully received items are removed from the queue. + * + * This function must not be used in an interrupt service routine. See + * xQueueReceiveFromISR for an alternative that can. + * + * @param xQueue The handle to the queue from which the item is to be + * received. + * + * @param pvBuffer Pointer to the buffer into which the received item will + * be copied. + * + * @param xTicksToWait The maximum amount of time the task should block + * waiting for an item to receive should the queue be empty at the time + * of the call. xQueueReceive() will return immediately if xTicksToWait + * is zero and the queue is empty. The time is defined in tick periods so the + * constant portTICK_PERIOD_MS should be used to convert to real time if this is + * required. + * + * @return pdTRUE if an item was successfully received from the queue, + * otherwise pdFALSE. + * + * Example usage: + 
+ struct AMessage
+ {
+	char ucMessageID;
+	char ucData[ 20 ];
+ } xMessage;
+
+ QueueHandle_t xQueue;
+
+ // Task to create a queue and post a value.
+ void vATask( void *pvParameters )
+ {
+ struct AMessage *pxMessage;
+
+	// Create a queue capable of containing 10 pointers to AMessage structures.
+	// These should be passed by pointer as they contain a lot of data.
+	xQueue = xQueueCreate( 10, sizeof( struct AMessage * ) );
+	if( xQueue == 0 )
+	{
+		// Failed to create the queue.
+	}
+
+	// ...
+
+	// Send a pointer to a struct AMessage object.  Don't block if the
+	// queue is already full.
+	pxMessage = & xMessage;
+	xQueueSend( xQueue, ( void * ) &pxMessage, ( TickType_t ) 0 );
+
+	// ... Rest of task code.
+ }
+
+ // Task to receive from the queue.
+ void vADifferentTask( void *pvParameters )
+ {
+ struct AMessage *pxRxedMessage;
+
+	if( xQueue != 0 )
+	{
+		// Receive a message on the created queue.  Block for 10 ticks if a
+		// message is not immediately available.
+		if( xQueueReceive( xQueue, &( pxRxedMessage ), ( TickType_t ) 10 ) )
+		{
+			// pcRxedMessage now points to the struct AMessage variable posted
+			// by vATask.
+		}
+	}
+
+	// ... Rest of task code.
+ }
+
+ * \defgroup xQueueReceive xQueueReceive + * \ingroup QueueManagement + */ +#define xQueueReceive( xQueue, pvBuffer, xTicksToWait ) xQueueGenericReceive( ( xQueue ), ( pvBuffer ), ( xTicksToWait ), pdFALSE ) + + +/** + * queue. h + * 
+ BaseType_t xQueueGenericReceive(
+									   QueueHandle_t	xQueue,
+									   void	*pvBuffer,
+									   TickType_t	xTicksToWait
+									   BaseType_t	xJustPeek
+									);
+ * + * It is preferred that the macro xQueueReceive() be used rather than calling + * this function directly. + * + * Receive an item from a queue. The item is received by copy so a buffer of + * adequate size must be provided. The number of bytes copied into the buffer + * was defined when the queue was created. + * + * This function must not be used in an interrupt service routine. See + * xQueueReceiveFromISR for an alternative that can. + * + * @param xQueue The handle to the queue from which the item is to be + * received. + * + * @param pvBuffer Pointer to the buffer into which the received item will + * be copied. + * + * @param xTicksToWait The maximum amount of time the task should block + * waiting for an item to receive should the queue be empty at the time + * of the call. The time is defined in tick periods so the constant + * portTICK_PERIOD_MS should be used to convert to real time if this is required. + * xQueueGenericReceive() will return immediately if the queue is empty and + * xTicksToWait is 0. + * + * @param xJustPeek When set to true, the item received from the queue is not + * actually removed from the queue - meaning a subsequent call to + * xQueueReceive() will return the same item. When set to false, the item + * being received from the queue is also removed from the queue. + * + * @return pdTRUE if an item was successfully received from the queue, + * otherwise pdFALSE. + * + * Example usage: + 
+ struct AMessage
+ {
+	char ucMessageID;
+	char ucData[ 20 ];
+ } xMessage;
+
+ QueueHandle_t xQueue;
+
+ // Task to create a queue and post a value.
+ void vATask( void *pvParameters )
+ {
+ struct AMessage *pxMessage;
+
+	// Create a queue capable of containing 10 pointers to AMessage structures.
+	// These should be passed by pointer as they contain a lot of data.
+	xQueue = xQueueCreate( 10, sizeof( struct AMessage * ) );
+	if( xQueue == 0 )
+	{
+		// Failed to create the queue.
+	}
+
+	// ...
+
+	// Send a pointer to a struct AMessage object.  Don't block if the
+	// queue is already full.
+	pxMessage = & xMessage;
+	xQueueSend( xQueue, ( void * ) &pxMessage, ( TickType_t ) 0 );
+
+	// ... Rest of task code.
+ }
+
+ // Task to receive from the queue.
+ void vADifferentTask( void *pvParameters )
+ {
+ struct AMessage *pxRxedMessage;
+
+	if( xQueue != 0 )
+	{
+		// Receive a message on the created queue.  Block for 10 ticks if a
+		// message is not immediately available.
+		if( xQueueGenericReceive( xQueue, &( pxRxedMessage ), ( TickType_t ) 10 ) )
+		{
+			// pcRxedMessage now points to the struct AMessage variable posted
+			// by vATask.
+		}
+	}
+
+	// ... Rest of task code.
+ }
+
+ * \defgroup xQueueReceive xQueueReceive + * \ingroup QueueManagement + */ +BaseType_t xQueueGenericReceive( QueueHandle_t xQueue, void * const pvBuffer, TickType_t xTicksToWait, const BaseType_t xJustPeek ) PRIVILEGED_FUNCTION; + +/** + * queue. h + * 
UBaseType_t uxQueueMessagesWaiting( const QueueHandle_t xQueue );
+ * + * Return the number of messages stored in a queue. + * + * @param xQueue A handle to the queue being queried. + * + * @return The number of messages available in the queue. + * + * \defgroup uxQueueMessagesWaiting uxQueueMessagesWaiting + * \ingroup QueueManagement + */ +UBaseType_t uxQueueMessagesWaiting( const QueueHandle_t xQueue ) PRIVILEGED_FUNCTION; + +/** + * queue. h + * 
UBaseType_t uxQueueSpacesAvailable( const QueueHandle_t xQueue );
+ * + * Return the number of free spaces available in a queue. This is equal to the + * number of items that can be sent to the queue before the queue becomes full + * if no items are removed. + * + * @param xQueue A handle to the queue being queried. + * + * @return The number of spaces available in the queue. + * + * \defgroup uxQueueMessagesWaiting uxQueueMessagesWaiting + * \ingroup QueueManagement + */ +UBaseType_t uxQueueSpacesAvailable( const QueueHandle_t xQueue ) PRIVILEGED_FUNCTION; + +/** + * queue. h + * 
void vQueueDelete( QueueHandle_t xQueue );
+ * + * Delete a queue - freeing all the memory allocated for storing of items + * placed on the queue. + * + * @param xQueue A handle to the queue to be deleted. + * + * \defgroup vQueueDelete vQueueDelete + * \ingroup QueueManagement + */ +void vQueueDelete( QueueHandle_t xQueue ) PRIVILEGED_FUNCTION; + +/** + * queue. h + * 
+ BaseType_t xQueueSendToFrontFromISR(
+										 QueueHandle_t xQueue,
+										 const void *pvItemToQueue,
+										 BaseType_t *pxHigherPriorityTaskWoken
+									  );
+
+ * + * This is a macro that calls xQueueGenericSendFromISR(). + * + * Post an item to the front of a queue. It is safe to use this macro from + * within an interrupt service routine. + * + * Items are queued by copy not reference so it is preferable to only + * queue small items, especially when called from an ISR. In most cases + * it would be preferable to store a pointer to the item being queued. + * + * @param xQueue The handle to the queue on which the item is to be posted. + * + * @param pvItemToQueue A pointer to the item that is to be placed on the + * queue. The size of the items the queue will hold was defined when the + * queue was created, so this many bytes will be copied from pvItemToQueue + * into the queue storage area. + * + * @param pxHigherPriorityTaskWoken xQueueSendToFrontFromISR() will set + * *pxHigherPriorityTaskWoken to pdTRUE if sending to the queue caused a task + * to unblock, and the unblocked task has a priority higher than the currently + * running task. If xQueueSendToFromFromISR() sets this value to pdTRUE then + * a context switch should be requested before the interrupt is exited. + * + * @return pdTRUE if the data was successfully sent to the queue, otherwise + * errQUEUE_FULL. + * + * Example usage for buffered IO (where the ISR can obtain more than one value + * per call): + 
+ void vBufferISR( void )
+ {
+ char cIn;
+ BaseType_t xHigherPrioritTaskWoken;
+
+	// We have not woken a task at the start of the ISR.
+	xHigherPriorityTaskWoken = pdFALSE;
+
+	// Loop until the buffer is empty.
+	do
+	{
+		// Obtain a byte from the buffer.
+		cIn = portINPUT_BYTE( RX_REGISTER_ADDRESS );
+
+		// Post the byte.
+		xQueueSendToFrontFromISR( xRxQueue, &cIn, &xHigherPriorityTaskWoken );
+
+	} while( portINPUT_BYTE( BUFFER_COUNT ) );
+
+	// Now the buffer is empty we can switch context if necessary.
+	if( xHigherPriorityTaskWoken )
+	{
+		taskYIELD ();
+	}
+ }
+
+ * + * \defgroup xQueueSendFromISR xQueueSendFromISR + * \ingroup QueueManagement + */ +#define xQueueSendToFrontFromISR( xQueue, pvItemToQueue, pxHigherPriorityTaskWoken ) xQueueGenericSendFromISR( ( xQueue ), ( pvItemToQueue ), ( pxHigherPriorityTaskWoken ), queueSEND_TO_FRONT ) + + +/** + * queue. h + * 
+ BaseType_t xQueueSendToBackFromISR(
+										 QueueHandle_t xQueue,
+										 const void *pvItemToQueue,
+										 BaseType_t *pxHigherPriorityTaskWoken
+									  );
+
+ * + * This is a macro that calls xQueueGenericSendFromISR(). + * + * Post an item to the back of a queue. It is safe to use this macro from + * within an interrupt service routine. + * + * Items are queued by copy not reference so it is preferable to only + * queue small items, especially when called from an ISR. In most cases + * it would be preferable to store a pointer to the item being queued. + * + * @param xQueue The handle to the queue on which the item is to be posted. + * + * @param pvItemToQueue A pointer to the item that is to be placed on the + * queue. The size of the items the queue will hold was defined when the + * queue was created, so this many bytes will be copied from pvItemToQueue + * into the queue storage area. + * + * @param pxHigherPriorityTaskWoken xQueueSendToBackFromISR() will set + * *pxHigherPriorityTaskWoken to pdTRUE if sending to the queue caused a task + * to unblock, and the unblocked task has a priority higher than the currently + * running task. If xQueueSendToBackFromISR() sets this value to pdTRUE then + * a context switch should be requested before the interrupt is exited. + * + * @return pdTRUE if the data was successfully sent to the queue, otherwise + * errQUEUE_FULL. + * + * Example usage for buffered IO (where the ISR can obtain more than one value + * per call): + 
+ void vBufferISR( void )
+ {
+ char cIn;
+ BaseType_t xHigherPriorityTaskWoken;
+
+	// We have not woken a task at the start of the ISR.
+	xHigherPriorityTaskWoken = pdFALSE;
+
+	// Loop until the buffer is empty.
+	do
+	{
+		// Obtain a byte from the buffer.
+		cIn = portINPUT_BYTE( RX_REGISTER_ADDRESS );
+
+		// Post the byte.
+		xQueueSendToBackFromISR( xRxQueue, &cIn, &xHigherPriorityTaskWoken );
+
+	} while( portINPUT_BYTE( BUFFER_COUNT ) );
+
+	// Now the buffer is empty we can switch context if necessary.
+	if( xHigherPriorityTaskWoken )
+	{
+		taskYIELD ();
+	}
+ }
+
+ * + * \defgroup xQueueSendFromISR xQueueSendFromISR + * \ingroup QueueManagement + */ +#define xQueueSendToBackFromISR( xQueue, pvItemToQueue, pxHigherPriorityTaskWoken ) xQueueGenericSendFromISR( ( xQueue ), ( pvItemToQueue ), ( pxHigherPriorityTaskWoken ), queueSEND_TO_BACK ) + +/** + * queue. h + * 
+ BaseType_t xQueueOverwriteFromISR(
+							  QueueHandle_t xQueue,
+							  const void * pvItemToQueue,
+							  BaseType_t *pxHigherPriorityTaskWoken
+						 );
+ *
+ * + * A version of xQueueOverwrite() that can be used in an interrupt service + * routine (ISR). + * + * Only for use with queues that can hold a single item - so the queue is either + * empty or full. + * + * Post an item on a queue. If the queue is already full then overwrite the + * value held in the queue. The item is queued by copy, not by reference. + * + * @param xQueue The handle to the queue on which the item is to be posted. + * + * @param pvItemToQueue A pointer to the item that is to be placed on the + * queue. The size of the items the queue will hold was defined when the + * queue was created, so this many bytes will be copied from pvItemToQueue + * into the queue storage area. + * + * @param pxHigherPriorityTaskWoken xQueueOverwriteFromISR() will set + * *pxHigherPriorityTaskWoken to pdTRUE if sending to the queue caused a task + * to unblock, and the unblocked task has a priority higher than the currently + * running task. If xQueueOverwriteFromISR() sets this value to pdTRUE then + * a context switch should be requested before the interrupt is exited. + * + * @return xQueueOverwriteFromISR() is a macro that calls + * xQueueGenericSendFromISR(), and therefore has the same return values as + * xQueueSendToFrontFromISR(). However, pdPASS is the only value that can be + * returned because xQueueOverwriteFromISR() will write to the queue even when + * the queue is already full. + * + * Example usage: + 
+
+ QueueHandle_t xQueue;
+
+ void vFunction( void *pvParameters )
+ {
+ 	// Create a queue to hold one uint32_t value.  It is strongly
+	// recommended *not* to use xQueueOverwriteFromISR() on queues that can
+	// contain more than one value, and doing so will trigger an assertion
+	// if configASSERT() is defined.
+	xQueue = xQueueCreate( 1, sizeof( uint32_t ) );
+}
+
+void vAnInterruptHandler( void )
+{
+// xHigherPriorityTaskWoken must be set to pdFALSE before it is used.
+BaseType_t xHigherPriorityTaskWoken = pdFALSE;
+uint32_t ulVarToSend, ulValReceived;
+
+	// Write the value 10 to the queue using xQueueOverwriteFromISR().
+	ulVarToSend = 10;
+	xQueueOverwriteFromISR( xQueue, &ulVarToSend, &xHigherPriorityTaskWoken );
+
+	// The queue is full, but calling xQueueOverwriteFromISR() again will still
+	// pass because the value held in the queue will be overwritten with the
+	// new value.
+	ulVarToSend = 100;
+	xQueueOverwriteFromISR( xQueue, &ulVarToSend, &xHigherPriorityTaskWoken );
+
+	// Reading from the queue will now return 100.
+
+	// ...
+
+	if( xHigherPrioritytaskWoken == pdTRUE )
+	{
+		// Writing to the queue caused a task to unblock and the unblocked task
+		// has a priority higher than or equal to the priority of the currently
+		// executing task (the task this interrupt interrupted).  Perform a context
+		// switch so this interrupt returns directly to the unblocked task.
+		portYIELD_FROM_ISR(); // or portEND_SWITCHING_ISR() depending on the port.
+	}
+}
+
+ * \defgroup xQueueOverwriteFromISR xQueueOverwriteFromISR + * \ingroup QueueManagement + */ +#define xQueueOverwriteFromISR( xQueue, pvItemToQueue, pxHigherPriorityTaskWoken ) xQueueGenericSendFromISR( ( xQueue ), ( pvItemToQueue ), ( pxHigherPriorityTaskWoken ), queueOVERWRITE ) + +/** + * queue. h + * 
+ BaseType_t xQueueSendFromISR(
+									 QueueHandle_t xQueue,
+									 const void *pvItemToQueue,
+									 BaseType_t *pxHigherPriorityTaskWoken
+								);
+
+ * + * This is a macro that calls xQueueGenericSendFromISR(). It is included + * for backward compatibility with versions of FreeRTOS.org that did not + * include the xQueueSendToBackFromISR() and xQueueSendToFrontFromISR() + * macros. + * + * Post an item to the back of a queue. It is safe to use this function from + * within an interrupt service routine. + * + * Items are queued by copy not reference so it is preferable to only + * queue small items, especially when called from an ISR. In most cases + * it would be preferable to store a pointer to the item being queued. + * + * @param xQueue The handle to the queue on which the item is to be posted. + * + * @param pvItemToQueue A pointer to the item that is to be placed on the + * queue. The size of the items the queue will hold was defined when the + * queue was created, so this many bytes will be copied from pvItemToQueue + * into the queue storage area. + * + * @param pxHigherPriorityTaskWoken xQueueSendFromISR() will set + * *pxHigherPriorityTaskWoken to pdTRUE if sending to the queue caused a task + * to unblock, and the unblocked task has a priority higher than the currently + * running task. If xQueueSendFromISR() sets this value to pdTRUE then + * a context switch should be requested before the interrupt is exited. + * + * @return pdTRUE if the data was successfully sent to the queue, otherwise + * errQUEUE_FULL. + * + * Example usage for buffered IO (where the ISR can obtain more than one value + * per call): + 
+ void vBufferISR( void )
+ {
+ char cIn;
+ BaseType_t xHigherPriorityTaskWoken;
+
+	// We have not woken a task at the start of the ISR.
+	xHigherPriorityTaskWoken = pdFALSE;
+
+	// Loop until the buffer is empty.
+	do
+	{
+		// Obtain a byte from the buffer.
+		cIn = portINPUT_BYTE( RX_REGISTER_ADDRESS );
+
+		// Post the byte.
+		xQueueSendFromISR( xRxQueue, &cIn, &xHigherPriorityTaskWoken );
+
+	} while( portINPUT_BYTE( BUFFER_COUNT ) );
+
+	// Now the buffer is empty we can switch context if necessary.
+	if( xHigherPriorityTaskWoken )
+	{
+		// Actual macro used here is port specific.
+		portYIELD_FROM_ISR ();
+	}
+ }
+
+ * + * \defgroup xQueueSendFromISR xQueueSendFromISR + * \ingroup QueueManagement + */ +#define xQueueSendFromISR( xQueue, pvItemToQueue, pxHigherPriorityTaskWoken ) xQueueGenericSendFromISR( ( xQueue ), ( pvItemToQueue ), ( pxHigherPriorityTaskWoken ), queueSEND_TO_BACK ) + +/** + * queue. h + * 
+ BaseType_t xQueueGenericSendFromISR(
+										   QueueHandle_t		xQueue,
+										   const	void	*pvItemToQueue,
+										   BaseType_t	*pxHigherPriorityTaskWoken,
+										   BaseType_t	xCopyPosition
+									   );
+
+ * + * It is preferred that the macros xQueueSendFromISR(), + * xQueueSendToFrontFromISR() and xQueueSendToBackFromISR() be used in place + * of calling this function directly. xQueueGiveFromISR() is an + * equivalent for use by semaphores that don't actually copy any data. + * + * Post an item on a queue. It is safe to use this function from within an + * interrupt service routine. + * + * Items are queued by copy not reference so it is preferable to only + * queue small items, especially when called from an ISR. In most cases + * it would be preferable to store a pointer to the item being queued. + * + * @param xQueue The handle to the queue on which the item is to be posted. + * + * @param pvItemToQueue A pointer to the item that is to be placed on the + * queue. The size of the items the queue will hold was defined when the + * queue was created, so this many bytes will be copied from pvItemToQueue + * into the queue storage area. + * + * @param pxHigherPriorityTaskWoken xQueueGenericSendFromISR() will set + * *pxHigherPriorityTaskWoken to pdTRUE if sending to the queue caused a task + * to unblock, and the unblocked task has a priority higher than the currently + * running task. If xQueueGenericSendFromISR() sets this value to pdTRUE then + * a context switch should be requested before the interrupt is exited. + * + * @param xCopyPosition Can take the value queueSEND_TO_BACK to place the + * item at the back of the queue, or queueSEND_TO_FRONT to place the item + * at the front of the queue (for high priority messages). + * + * @return pdTRUE if the data was successfully sent to the queue, otherwise + * errQUEUE_FULL. + * + * Example usage for buffered IO (where the ISR can obtain more than one value + * per call): + 
+ void vBufferISR( void )
+ {
+ char cIn;
+ BaseType_t xHigherPriorityTaskWokenByPost;
+
+	// We have not woken a task at the start of the ISR.
+	xHigherPriorityTaskWokenByPost = pdFALSE;
+
+	// Loop until the buffer is empty.
+	do
+	{
+		// Obtain a byte from the buffer.
+		cIn = portINPUT_BYTE( RX_REGISTER_ADDRESS );
+
+		// Post each byte.
+		xQueueGenericSendFromISR( xRxQueue, &cIn, &xHigherPriorityTaskWokenByPost, queueSEND_TO_BACK );
+
+	} while( portINPUT_BYTE( BUFFER_COUNT ) );
+
+	// Now the buffer is empty we can switch context if necessary.  Note that the
+	// name of the yield function required is port specific.
+	if( xHigherPriorityTaskWokenByPost )
+	{
+		taskYIELD_YIELD_FROM_ISR();
+	}
+ }
+
+ * + * \defgroup xQueueSendFromISR xQueueSendFromISR + * \ingroup QueueManagement + */ +BaseType_t xQueueGenericSendFromISR( QueueHandle_t xQueue, const void * const pvItemToQueue, BaseType_t * const pxHigherPriorityTaskWoken, const BaseType_t xCopyPosition ) PRIVILEGED_FUNCTION; +BaseType_t xQueueGiveFromISR( QueueHandle_t xQueue, BaseType_t * const pxHigherPriorityTaskWoken ) PRIVILEGED_FUNCTION; + +/** + * queue. h + * 
+ BaseType_t xQueueReceiveFromISR(
+									   QueueHandle_t	xQueue,
+									   void	*pvBuffer,
+									   BaseType_t *pxTaskWoken
+								   );
+ *
+ * + * Receive an item from a queue. It is safe to use this function from within an + * interrupt service routine. + * + * @param xQueue The handle to the queue from which the item is to be + * received. + * + * @param pvBuffer Pointer to the buffer into which the received item will + * be copied. + * + * @param pxTaskWoken A task may be blocked waiting for space to become + * available on the queue. If xQueueReceiveFromISR causes such a task to + * unblock *pxTaskWoken will get set to pdTRUE, otherwise *pxTaskWoken will + * remain unchanged. + * + * @return pdTRUE if an item was successfully received from the queue, + * otherwise pdFALSE. + * + * Example usage: + 
+
+ QueueHandle_t xQueue;
+
+ // Function to create a queue and post some values.
+ void vAFunction( void *pvParameters )
+ {
+ char cValueToPost;
+ const TickType_t xTicksToWait = ( TickType_t )0xff;
+
+	// Create a queue capable of containing 10 characters.
+	xQueue = xQueueCreate( 10, sizeof( char ) );
+	if( xQueue == 0 )
+	{
+		// Failed to create the queue.
+	}
+
+	// ...
+
+	// Post some characters that will be used within an ISR.  If the queue
+	// is full then this task will block for xTicksToWait ticks.
+	cValueToPost = 'a';
+	xQueueSend( xQueue, ( void * ) &cValueToPost, xTicksToWait );
+	cValueToPost = 'b';
+	xQueueSend( xQueue, ( void * ) &cValueToPost, xTicksToWait );
+
+	// ... keep posting characters ... this task may block when the queue
+	// becomes full.
+
+	cValueToPost = 'c';
+	xQueueSend( xQueue, ( void * ) &cValueToPost, xTicksToWait );
+ }
+
+ // ISR that outputs all the characters received on the queue.
+ void vISR_Routine( void )
+ {
+ BaseType_t xTaskWokenByReceive = pdFALSE;
+ char cRxedChar;
+
+	while( xQueueReceiveFromISR( xQueue, ( void * ) &cRxedChar, &xTaskWokenByReceive) )
+	{
+		// A character was received.  Output the character now.
+		vOutputCharacter( cRxedChar );
+
+		// If removing the character from the queue woke the task that was
+		// posting onto the queue cTaskWokenByReceive will have been set to
+		// pdTRUE.  No matter how many times this loop iterates only one
+		// task will be woken.
+	}
+
+	if( cTaskWokenByPost != ( char ) pdFALSE;
+	{
+		taskYIELD ();
+	}
+ }
+
+ * \defgroup xQueueReceiveFromISR xQueueReceiveFromISR + * \ingroup QueueManagement + */ +BaseType_t xQueueReceiveFromISR( QueueHandle_t xQueue, void * const pvBuffer, BaseType_t * const pxHigherPriorityTaskWoken ) PRIVILEGED_FUNCTION; + +/* + * Utilities to query queues that are safe to use from an ISR. These utilities + * should be used only from witin an ISR, or within a critical section. + */ +BaseType_t xQueueIsQueueEmptyFromISR( const QueueHandle_t xQueue ) PRIVILEGED_FUNCTION; +BaseType_t xQueueIsQueueFullFromISR( const QueueHandle_t xQueue ) PRIVILEGED_FUNCTION; +UBaseType_t uxQueueMessagesWaitingFromISR( const QueueHandle_t xQueue ) PRIVILEGED_FUNCTION; + +/* + * The functions defined above are for passing data to and from tasks. The + * functions below are the equivalents for passing data to and from + * co-routines. + * + * These functions are called from the co-routine macro implementation and + * should not be called directly from application code. Instead use the macro + * wrappers defined within croutine.h. + */ +BaseType_t xQueueCRSendFromISR( QueueHandle_t xQueue, const void *pvItemToQueue, BaseType_t xCoRoutinePreviouslyWoken ); +BaseType_t xQueueCRReceiveFromISR( QueueHandle_t xQueue, void *pvBuffer, BaseType_t *pxTaskWoken ); +BaseType_t xQueueCRSend( QueueHandle_t xQueue, const void *pvItemToQueue, TickType_t xTicksToWait ); +BaseType_t xQueueCRReceive( QueueHandle_t xQueue, void *pvBuffer, TickType_t xTicksToWait ); + +/* + * For internal use only. Use xSemaphoreCreateMutex(), + * xSemaphoreCreateCounting() or xSemaphoreGetMutexHolder() instead of calling + * these functions directly. + */ +QueueHandle_t xQueueCreateMutex( const uint8_t ucQueueType ) PRIVILEGED_FUNCTION; +QueueHandle_t xQueueCreateMutexStatic( const uint8_t ucQueueType, StaticQueue_t *pxStaticQueue ) PRIVILEGED_FUNCTION; +QueueHandle_t xQueueCreateCountingSemaphore( const UBaseType_t uxMaxCount, const UBaseType_t uxInitialCount ) PRIVILEGED_FUNCTION; +QueueHandle_t xQueueCreateCountingSemaphoreStatic( const UBaseType_t uxMaxCount, const UBaseType_t uxInitialCount, StaticQueue_t *pxStaticQueue ) PRIVILEGED_FUNCTION; +void* xQueueGetMutexHolder( QueueHandle_t xSemaphore ) PRIVILEGED_FUNCTION; + +/* + * For internal use only. Use xSemaphoreTakeMutexRecursive() or + * xSemaphoreGiveMutexRecursive() instead of calling these functions directly. + */ +BaseType_t xQueueTakeMutexRecursive( QueueHandle_t xMutex, TickType_t xTicksToWait ) PRIVILEGED_FUNCTION; +BaseType_t xQueueGiveMutexRecursive( QueueHandle_t pxMutex ) PRIVILEGED_FUNCTION; + +/* + * Reset a queue back to its original empty state. The return value is now + * obsolete and is always set to pdPASS. + */ +#define xQueueReset( xQueue ) xQueueGenericReset( xQueue, pdFALSE ) + +/* + * The registry is provided as a means for kernel aware debuggers to + * locate queues, semaphores and mutexes. Call vQueueAddToRegistry() add + * a queue, semaphore or mutex handle to the registry if you want the handle + * to be available to a kernel aware debugger. If you are not using a kernel + * aware debugger then this function can be ignored. + * + * configQUEUE_REGISTRY_SIZE defines the maximum number of handles the + * registry can hold. configQUEUE_REGISTRY_SIZE must be greater than 0 + * within FreeRTOSConfig.h for the registry to be available. Its value + * does not effect the number of queues, semaphores and mutexes that can be + * created - just the number that the registry can hold. + * + * @param xQueue The handle of the queue being added to the registry. This + * is the handle returned by a call to xQueueCreate(). Semaphore and mutex + * handles can also be passed in here. + * + * @param pcName The name to be associated with the handle. This is the + * name that the kernel aware debugger will display. The queue registry only + * stores a pointer to the string - so the string must be persistent (global or + * preferably in ROM/Flash), not on the stack. + */ +#if( configQUEUE_REGISTRY_SIZE > 0 ) + void vQueueAddToRegistry( QueueHandle_t xQueue, const char *pcName ) PRIVILEGED_FUNCTION; /*lint !e971 Unqualified char types are allowed for strings and single characters only. */ +#endif + +/* + * The registry is provided as a means for kernel aware debuggers to + * locate queues, semaphores and mutexes. Call vQueueAddToRegistry() add + * a queue, semaphore or mutex handle to the registry if you want the handle + * to be available to a kernel aware debugger, and vQueueUnregisterQueue() to + * remove the queue, semaphore or mutex from the register. If you are not using + * a kernel aware debugger then this function can be ignored. + * + * @param xQueue The handle of the queue being removed from the registry. + */ +#if( configQUEUE_REGISTRY_SIZE > 0 ) + void vQueueUnregisterQueue( QueueHandle_t xQueue ) PRIVILEGED_FUNCTION; +#endif + +/* + * The queue registry is provided as a means for kernel aware debuggers to + * locate queues, semaphores and mutexes. Call pcQueueGetName() to look + * up and return the name of a queue in the queue registry from the queue's + * handle. + * + * @param xQueue The handle of the queue the name of which will be returned. + * @return If the queue is in the registry then a pointer to the name of the + * queue is returned. If the queue is not in the registry then NULL is + * returned. + */ +#if( configQUEUE_REGISTRY_SIZE > 0 ) + const char *pcQueueGetName( QueueHandle_t xQueue ) PRIVILEGED_FUNCTION; /*lint !e971 Unqualified char types are allowed for strings and single characters only. */ +#endif + +/* + * Generic version of the function used to creaet a queue using dynamic memory + * allocation. This is called by other functions and macros that create other + * RTOS objects that use the queue structure as their base. + */ +#if( configSUPPORT_DYNAMIC_ALLOCATION == 1 ) + QueueHandle_t xQueueGenericCreate( const UBaseType_t uxQueueLength, const UBaseType_t uxItemSize, const uint8_t ucQueueType ) PRIVILEGED_FUNCTION; +#endif + +/* + * Generic version of the function used to creaet a queue using dynamic memory + * allocation. This is called by other functions and macros that create other + * RTOS objects that use the queue structure as their base. + */ +#if( configSUPPORT_STATIC_ALLOCATION == 1 ) + QueueHandle_t xQueueGenericCreateStatic( const UBaseType_t uxQueueLength, const UBaseType_t uxItemSize, uint8_t *pucQueueStorage, StaticQueue_t *pxStaticQueue, const uint8_t ucQueueType ) PRIVILEGED_FUNCTION; +#endif + +/* + * Queue sets provide a mechanism to allow a task to block (pend) on a read + * operation from multiple queues or semaphores simultaneously. + * + * See FreeRTOS/Source/Demo/Common/Minimal/QueueSet.c for an example using this + * function. + * + * A queue set must be explicitly created using a call to xQueueCreateSet() + * before it can be used. Once created, standard FreeRTOS queues and semaphores + * can be added to the set using calls to xQueueAddToSet(). + * xQueueSelectFromSet() is then used to determine which, if any, of the queues + * or semaphores contained in the set is in a state where a queue read or + * semaphore take operation would be successful. + * + * Note 1: See the documentation on http://wwwFreeRTOS.org/RTOS-queue-sets.html + * for reasons why queue sets are very rarely needed in practice as there are + * simpler methods of blocking on multiple objects. + * + * Note 2: Blocking on a queue set that contains a mutex will not cause the + * mutex holder to inherit the priority of the blocked task. + * + * Note 3: An additional 4 bytes of RAM is required for each space in a every + * queue added to a queue set. Therefore counting semaphores that have a high + * maximum count value should not be added to a queue set. + * + * Note 4: A receive (in the case of a queue) or take (in the case of a + * semaphore) operation must not be performed on a member of a queue set unless + * a call to xQueueSelectFromSet() has first returned a handle to that set member. + * + * @param uxEventQueueLength Queue sets store events that occur on + * the queues and semaphores contained in the set. uxEventQueueLength specifies + * the maximum number of events that can be queued at once. To be absolutely + * certain that events are not lost uxEventQueueLength should be set to the + * total sum of the length of the queues added to the set, where binary + * semaphores and mutexes have a length of 1, and counting semaphores have a + * length set by their maximum count value. Examples: + * + If a queue set is to hold a queue of length 5, another queue of length 12, + * and a binary semaphore, then uxEventQueueLength should be set to + * (5 + 12 + 1), or 18. + * + If a queue set is to hold three binary semaphores then uxEventQueueLength + * should be set to (1 + 1 + 1 ), or 3. + * + If a queue set is to hold a counting semaphore that has a maximum count of + * 5, and a counting semaphore that has a maximum count of 3, then + * uxEventQueueLength should be set to (5 + 3), or 8. + * + * @return If the queue set is created successfully then a handle to the created + * queue set is returned. Otherwise NULL is returned. + */ +QueueSetHandle_t xQueueCreateSet( const UBaseType_t uxEventQueueLength ) PRIVILEGED_FUNCTION; + +/* + * Adds a queue or semaphore to a queue set that was previously created by a + * call to xQueueCreateSet(). + * + * See FreeRTOS/Source/Demo/Common/Minimal/QueueSet.c for an example using this + * function. + * + * Note 1: A receive (in the case of a queue) or take (in the case of a + * semaphore) operation must not be performed on a member of a queue set unless + * a call to xQueueSelectFromSet() has first returned a handle to that set member. + * + * @param xQueueOrSemaphore The handle of the queue or semaphore being added to + * the queue set (cast to an QueueSetMemberHandle_t type). + * + * @param xQueueSet The handle of the queue set to which the queue or semaphore + * is being added. + * + * @return If the queue or semaphore was successfully added to the queue set + * then pdPASS is returned. If the queue could not be successfully added to the + * queue set because it is already a member of a different queue set then pdFAIL + * is returned. + */ +BaseType_t xQueueAddToSet( QueueSetMemberHandle_t xQueueOrSemaphore, QueueSetHandle_t xQueueSet ) PRIVILEGED_FUNCTION; + +/* + * Removes a queue or semaphore from a queue set. A queue or semaphore can only + * be removed from a set if the queue or semaphore is empty. + * + * See FreeRTOS/Source/Demo/Common/Minimal/QueueSet.c for an example using this + * function. + * + * @param xQueueOrSemaphore The handle of the queue or semaphore being removed + * from the queue set (cast to an QueueSetMemberHandle_t type). + * + * @param xQueueSet The handle of the queue set in which the queue or semaphore + * is included. + * + * @return If the queue or semaphore was successfully removed from the queue set + * then pdPASS is returned. If the queue was not in the queue set, or the + * queue (or semaphore) was not empty, then pdFAIL is returned. + */ +BaseType_t xQueueRemoveFromSet( QueueSetMemberHandle_t xQueueOrSemaphore, QueueSetHandle_t xQueueSet ) PRIVILEGED_FUNCTION; + +/* + * xQueueSelectFromSet() selects from the members of a queue set a queue or + * semaphore that either contains data (in the case of a queue) or is available + * to take (in the case of a semaphore). xQueueSelectFromSet() effectively + * allows a task to block (pend) on a read operation on all the queues and + * semaphores in a queue set simultaneously. + * + * See FreeRTOS/Source/Demo/Common/Minimal/QueueSet.c for an example using this + * function. + * + * Note 1: See the documentation on http://wwwFreeRTOS.org/RTOS-queue-sets.html + * for reasons why queue sets are very rarely needed in practice as there are + * simpler methods of blocking on multiple objects. + * + * Note 2: Blocking on a queue set that contains a mutex will not cause the + * mutex holder to inherit the priority of the blocked task. + * + * Note 3: A receive (in the case of a queue) or take (in the case of a + * semaphore) operation must not be performed on a member of a queue set unless + * a call to xQueueSelectFromSet() has first returned a handle to that set member. + * + * @param xQueueSet The queue set on which the task will (potentially) block. + * + * @param xTicksToWait The maximum time, in ticks, that the calling task will + * remain in the Blocked state (with other tasks executing) to wait for a member + * of the queue set to be ready for a successful queue read or semaphore take + * operation. + * + * @return xQueueSelectFromSet() will return the handle of a queue (cast to + * a QueueSetMemberHandle_t type) contained in the queue set that contains data, + * or the handle of a semaphore (cast to a QueueSetMemberHandle_t type) contained + * in the queue set that is available, or NULL if no such queue or semaphore + * exists before before the specified block time expires. + */ +QueueSetMemberHandle_t xQueueSelectFromSet( QueueSetHandle_t xQueueSet, const TickType_t xTicksToWait ) PRIVILEGED_FUNCTION; + +/* + * A version of xQueueSelectFromSet() that can be used from an ISR. + */ +QueueSetMemberHandle_t xQueueSelectFromSetFromISR( QueueSetHandle_t xQueueSet ) PRIVILEGED_FUNCTION; + +/* Not public API functions. */ +void vQueueWaitForMessageRestricted( QueueHandle_t xQueue, TickType_t xTicksToWait, const BaseType_t xWaitIndefinitely ) PRIVILEGED_FUNCTION; +BaseType_t xQueueGenericReset( QueueHandle_t xQueue, BaseType_t xNewQueue ) PRIVILEGED_FUNCTION; +void vQueueSetQueueNumber( QueueHandle_t xQueue, UBaseType_t uxQueueNumber ) PRIVILEGED_FUNCTION; +UBaseType_t uxQueueGetQueueNumber( QueueHandle_t xQueue ) PRIVILEGED_FUNCTION; +uint8_t ucQueueGetQueueType( QueueHandle_t xQueue ) PRIVILEGED_FUNCTION; + + +#ifdef __cplusplus +} +#endif + +#endif /* QUEUE_H */ + diff --git a/FreeRTOS/include/semphr.h b/FreeRTOS/include/semphr.h new file mode 100644 index 0000000..a674b02 --- /dev/null +++ b/FreeRTOS/include/semphr.h @@ -0,0 +1,1171 @@ +/* + FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd. + All rights reserved + + VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION. + + This file is part of the FreeRTOS distribution. + + FreeRTOS is free software; you can redistribute it and/or modify it under + the terms of the GNU General Public License (version 2) as published by the + Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception. + + *************************************************************************** + >>! NOTE: The modification to the GPL is included to allow you to !<< + >>! distribute a combined work that includes FreeRTOS without being !<< + >>! obliged to provide the source code for proprietary components !<< + >>! outside of the FreeRTOS kernel. !<< + *************************************************************************** + + FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY + WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS + FOR A PARTICULAR PURPOSE. Full license text is available on the following + link: http://www.freertos.org/a00114.html + + *************************************************************************** + * * + * FreeRTOS provides completely free yet professionally developed, * + * robust, strictly quality controlled, supported, and cross * + * platform software that is more than just the market leader, it * + * is the industry's de facto standard. * + * * + * Help yourself get started quickly while simultaneously helping * + * to support the FreeRTOS project by purchasing a FreeRTOS * + * tutorial book, reference manual, or both: * + * http://www.FreeRTOS.org/Documentation * + * * + *************************************************************************** + + http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading + the FAQ page "My application does not run, what could be wrong?". Have you + defined configASSERT()? + + http://www.FreeRTOS.org/support - In return for receiving this top quality + embedded software for free we request you assist our global community by + participating in the support forum. + + http://www.FreeRTOS.org/training - Investing in training allows your team to + be as productive as possible as early as possible. Now you can receive + FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers + Ltd, and the world's leading authority on the world's leading RTOS. + + http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products, + including FreeRTOS+Trace - an indispensable productivity tool, a DOS + compatible FAT file system, and our tiny thread aware UDP/IP stack. + + http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate. + Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS. + + http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High + Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS + licenses offer ticketed support, indemnification and commercial middleware. + + http://www.SafeRTOS.com - High Integrity Systems also provide a safety + engineered and independently SIL3 certified version for use in safety and + mission critical applications that require provable dependability. + + 1 tab == 4 spaces! +*/ + +#ifndef SEMAPHORE_H +#define SEMAPHORE_H + +#ifndef INC_FREERTOS_H + #error "include FreeRTOS.h" must appear in source files before "include semphr.h" +#endif + +#include "queue.h" + +typedef QueueHandle_t SemaphoreHandle_t; + +#define semBINARY_SEMAPHORE_QUEUE_LENGTH ( ( uint8_t ) 1U ) +#define semSEMAPHORE_QUEUE_ITEM_LENGTH ( ( uint8_t ) 0U ) +#define semGIVE_BLOCK_TIME ( ( TickType_t ) 0U ) + + +/** + * semphr. h + * 
vSemaphoreCreateBinary( SemaphoreHandle_t xSemaphore )
+ * + * In many usage scenarios it is faster and more memory efficient to use a + * direct to task notification in place of a binary semaphore! + * http://www.freertos.org/RTOS-task-notifications.html + * + * This old vSemaphoreCreateBinary() macro is now deprecated in favour of the + * xSemaphoreCreateBinary() function. Note that binary semaphores created using + * the vSemaphoreCreateBinary() macro are created in a state such that the + * first call to 'take' the semaphore would pass, whereas binary semaphores + * created using xSemaphoreCreateBinary() are created in a state such that the + * the semaphore must first be 'given' before it can be 'taken'. + * + * Macro that implements a semaphore by using the existing queue mechanism. + * The queue length is 1 as this is a binary semaphore. The data size is 0 + * as we don't want to actually store any data - we just want to know if the + * queue is empty or full. + * + * This type of semaphore can be used for pure synchronisation between tasks or + * between an interrupt and a task. The semaphore need not be given back once + * obtained, so one task/interrupt can continuously 'give' the semaphore while + * another continuously 'takes' the semaphore. For this reason this type of + * semaphore does not use a priority inheritance mechanism. For an alternative + * that does use priority inheritance see xSemaphoreCreateMutex(). + * + * @param xSemaphore Handle to the created semaphore. Should be of type SemaphoreHandle_t. + * + * Example usage: + 
+ SemaphoreHandle_t xSemaphore = NULL;
+
+ void vATask( void * pvParameters )
+ {
+    // Semaphore cannot be used before a call to vSemaphoreCreateBinary ().
+    // This is a macro so pass the variable in directly.
+    vSemaphoreCreateBinary( xSemaphore );
+
+    if( xSemaphore != NULL )
+    {
+        // The semaphore was created successfully.
+        // The semaphore can now be used.
+    }
+ }
+
+ * \defgroup vSemaphoreCreateBinary vSemaphoreCreateBinary + * \ingroup Semaphores + */ +#if( configSUPPORT_DYNAMIC_ALLOCATION == 1 ) + #define vSemaphoreCreateBinary( xSemaphore ) \ + { \ + ( xSemaphore ) = xQueueGenericCreate( ( UBaseType_t ) 1, semSEMAPHORE_QUEUE_ITEM_LENGTH, queueQUEUE_TYPE_BINARY_SEMAPHORE ); \ + if( ( xSemaphore ) != NULL ) \ + { \ + ( void ) xSemaphoreGive( ( xSemaphore ) ); \ + } \ + } +#endif + +/** + * semphr. h + * 
SemaphoreHandle_t xSemaphoreCreateBinary( void )
+ * + * Creates a new binary semaphore instance, and returns a handle by which the + * new semaphore can be referenced. + * + * In many usage scenarios it is faster and more memory efficient to use a + * direct to task notification in place of a binary semaphore! + * http://www.freertos.org/RTOS-task-notifications.html + * + * Internally, within the FreeRTOS implementation, binary semaphores use a block + * of memory, in which the semaphore structure is stored. If a binary semaphore + * is created using xSemaphoreCreateBinary() then the required memory is + * automatically dynamically allocated inside the xSemaphoreCreateBinary() + * function. (see http://www.freertos.org/a00111.html). If a binary semaphore + * is created using xSemaphoreCreateBinaryStatic() then the application writer + * must provide the memory. xSemaphoreCreateBinaryStatic() therefore allows a + * binary semaphore to be created without using any dynamic memory allocation. + * + * The old vSemaphoreCreateBinary() macro is now deprecated in favour of this + * xSemaphoreCreateBinary() function. Note that binary semaphores created using + * the vSemaphoreCreateBinary() macro are created in a state such that the + * first call to 'take' the semaphore would pass, whereas binary semaphores + * created using xSemaphoreCreateBinary() are created in a state such that the + * the semaphore must first be 'given' before it can be 'taken'. + * + * This type of semaphore can be used for pure synchronisation between tasks or + * between an interrupt and a task. The semaphore need not be given back once + * obtained, so one task/interrupt can continuously 'give' the semaphore while + * another continuously 'takes' the semaphore. For this reason this type of + * semaphore does not use a priority inheritance mechanism. For an alternative + * that does use priority inheritance see xSemaphoreCreateMutex(). + * + * @return Handle to the created semaphore, or NULL if the memory required to + * hold the semaphore's data structures could not be allocated. + * + * Example usage: + 
+ SemaphoreHandle_t xSemaphore = NULL;
+
+ void vATask( void * pvParameters )
+ {
+    // Semaphore cannot be used before a call to xSemaphoreCreateBinary().
+    // This is a macro so pass the variable in directly.
+    xSemaphore = xSemaphoreCreateBinary();
+
+    if( xSemaphore != NULL )
+    {
+        // The semaphore was created successfully.
+        // The semaphore can now be used.
+    }
+ }
+
+ * \defgroup xSemaphoreCreateBinary xSemaphoreCreateBinary + * \ingroup Semaphores + */ +#if( configSUPPORT_DYNAMIC_ALLOCATION == 1 ) + #define xSemaphoreCreateBinary() xQueueGenericCreate( ( UBaseType_t ) 1, semSEMAPHORE_QUEUE_ITEM_LENGTH, queueQUEUE_TYPE_BINARY_SEMAPHORE ) +#endif + +/** + * semphr. h + * 
SemaphoreHandle_t xSemaphoreCreateBinaryStatic( StaticSemaphore_t *pxSemaphoreBuffer )
+ * + * Creates a new binary semaphore instance, and returns a handle by which the + * new semaphore can be referenced. + * + * NOTE: In many usage scenarios it is faster and more memory efficient to use a + * direct to task notification in place of a binary semaphore! + * http://www.freertos.org/RTOS-task-notifications.html + * + * Internally, within the FreeRTOS implementation, binary semaphores use a block + * of memory, in which the semaphore structure is stored. If a binary semaphore + * is created using xSemaphoreCreateBinary() then the required memory is + * automatically dynamically allocated inside the xSemaphoreCreateBinary() + * function. (see http://www.freertos.org/a00111.html). If a binary semaphore + * is created using xSemaphoreCreateBinaryStatic() then the application writer + * must provide the memory. xSemaphoreCreateBinaryStatic() therefore allows a + * binary semaphore to be created without using any dynamic memory allocation. + * + * This type of semaphore can be used for pure synchronisation between tasks or + * between an interrupt and a task. The semaphore need not be given back once + * obtained, so one task/interrupt can continuously 'give' the semaphore while + * another continuously 'takes' the semaphore. For this reason this type of + * semaphore does not use a priority inheritance mechanism. For an alternative + * that does use priority inheritance see xSemaphoreCreateMutex(). + * + * @param pxSemaphoreBuffer Must point to a variable of type StaticSemaphore_t, + * which will then be used to hold the semaphore's data structure, removing the + * need for the memory to be allocated dynamically. + * + * @return If the semaphore is created then a handle to the created semaphore is + * returned. If pxSemaphoreBuffer is NULL then NULL is returned. + * + * Example usage: + 
+ SemaphoreHandle_t xSemaphore = NULL;
+ StaticSemaphore_t xSemaphoreBuffer;
+
+ void vATask( void * pvParameters )
+ {
+    // Semaphore cannot be used before a call to xSemaphoreCreateBinary().
+    // The semaphore's data structures will be placed in the xSemaphoreBuffer
+    // variable, the address of which is passed into the function.  The
+    // function's parameter is not NULL, so the function will not attempt any
+    // dynamic memory allocation, and therefore the function will not return
+    // return NULL.
+    xSemaphore = xSemaphoreCreateBinary( &xSemaphoreBuffer );
+
+    // Rest of task code goes here.
+ }
+
+ * \defgroup xSemaphoreCreateBinaryStatic xSemaphoreCreateBinaryStatic + * \ingroup Semaphores + */ +#if( configSUPPORT_STATIC_ALLOCATION == 1 ) + #define xSemaphoreCreateBinaryStatic( pxStaticSemaphore ) xQueueGenericCreateStatic( ( UBaseType_t ) 1, semSEMAPHORE_QUEUE_ITEM_LENGTH, NULL, pxStaticSemaphore, queueQUEUE_TYPE_BINARY_SEMAPHORE ) +#endif /* configSUPPORT_STATIC_ALLOCATION */ + +/** + * semphr. h + * 
xSemaphoreTake(
+ *                   SemaphoreHandle_t xSemaphore,
+ *                   TickType_t xBlockTime
+ *               )
+ * + * Macro to obtain a semaphore. The semaphore must have previously been + * created with a call to xSemaphoreCreateBinary(), xSemaphoreCreateMutex() or + * xSemaphoreCreateCounting(). + * + * @param xSemaphore A handle to the semaphore being taken - obtained when + * the semaphore was created. + * + * @param xBlockTime The time in ticks to wait for the semaphore to become + * available. The macro portTICK_PERIOD_MS can be used to convert this to a + * real time. A block time of zero can be used to poll the semaphore. A block + * time of portMAX_DELAY can be used to block indefinitely (provided + * INCLUDE_vTaskSuspend is set to 1 in FreeRTOSConfig.h). + * + * @return pdTRUE if the semaphore was obtained. pdFALSE + * if xBlockTime expired without the semaphore becoming available. + * + * Example usage: + 
+ SemaphoreHandle_t xSemaphore = NULL;
+
+ // A task that creates a semaphore.
+ void vATask( void * pvParameters )
+ {
+    // Create the semaphore to guard a shared resource.
+    xSemaphore = xSemaphoreCreateBinary();
+ }
+
+ // A task that uses the semaphore.
+ void vAnotherTask( void * pvParameters )
+ {
+    // ... Do other things.
+
+    if( xSemaphore != NULL )
+    {
+        // See if we can obtain the semaphore.  If the semaphore is not available
+        // wait 10 ticks to see if it becomes free.
+        if( xSemaphoreTake( xSemaphore, ( TickType_t ) 10 ) == pdTRUE )
+        {
+            // We were able to obtain the semaphore and can now access the
+            // shared resource.
+
+            // ...
+
+            // We have finished accessing the shared resource.  Release the
+            // semaphore.
+            xSemaphoreGive( xSemaphore );
+        }
+        else
+        {
+            // We could not obtain the semaphore and can therefore not access
+            // the shared resource safely.
+        }
+    }
+ }
+
+ * \defgroup xSemaphoreTake xSemaphoreTake + * \ingroup Semaphores + */ +#define xSemaphoreTake( xSemaphore, xBlockTime ) xQueueGenericReceive( ( QueueHandle_t ) ( xSemaphore ), NULL, ( xBlockTime ), pdFALSE ) + +/** + * semphr. h + * xSemaphoreTakeRecursive( + * SemaphoreHandle_t xMutex, + * TickType_t xBlockTime + * ) + * + * Macro to recursively obtain, or 'take', a mutex type semaphore. + * The mutex must have previously been created using a call to + * xSemaphoreCreateRecursiveMutex(); + * + * configUSE_RECURSIVE_MUTEXES must be set to 1 in FreeRTOSConfig.h for this + * macro to be available. + * + * This macro must not be used on mutexes created using xSemaphoreCreateMutex(). + * + * A mutex used recursively can be 'taken' repeatedly by the owner. The mutex + * doesn't become available again until the owner has called + * xSemaphoreGiveRecursive() for each successful 'take' request. For example, + * if a task successfully 'takes' the same mutex 5 times then the mutex will + * not be available to any other task until it has also 'given' the mutex back + * exactly five times. + * + * @param xMutex A handle to the mutex being obtained. This is the + * handle returned by xSemaphoreCreateRecursiveMutex(); + * + * @param xBlockTime The time in ticks to wait for the semaphore to become + * available. The macro portTICK_PERIOD_MS can be used to convert this to a + * real time. A block time of zero can be used to poll the semaphore. If + * the task already owns the semaphore then xSemaphoreTakeRecursive() will + * return immediately no matter what the value of xBlockTime. + * + * @return pdTRUE if the semaphore was obtained. pdFALSE if xBlockTime + * expired without the semaphore becoming available. + * + * Example usage: + 
+ SemaphoreHandle_t xMutex = NULL;
+
+ // A task that creates a mutex.
+ void vATask( void * pvParameters )
+ {
+    // Create the mutex to guard a shared resource.
+    xMutex = xSemaphoreCreateRecursiveMutex();
+ }
+
+ // A task that uses the mutex.
+ void vAnotherTask( void * pvParameters )
+ {
+    // ... Do other things.
+
+    if( xMutex != NULL )
+    {
+        // See if we can obtain the mutex.  If the mutex is not available
+        // wait 10 ticks to see if it becomes free.
+        if( xSemaphoreTakeRecursive( xSemaphore, ( TickType_t ) 10 ) == pdTRUE )
+        {
+            // We were able to obtain the mutex and can now access the
+            // shared resource.
+
+            // ...
+            // For some reason due to the nature of the code further calls to
+			// xSemaphoreTakeRecursive() are made on the same mutex.  In real
+			// code these would not be just sequential calls as this would make
+			// no sense.  Instead the calls are likely to be buried inside
+			// a more complex call structure.
+            xSemaphoreTakeRecursive( xMutex, ( TickType_t ) 10 );
+            xSemaphoreTakeRecursive( xMutex, ( TickType_t ) 10 );
+
+            // The mutex has now been 'taken' three times, so will not be
+			// available to another task until it has also been given back
+			// three times.  Again it is unlikely that real code would have
+			// these calls sequentially, but instead buried in a more complex
+			// call structure.  This is just for illustrative purposes.
+            xSemaphoreGiveRecursive( xMutex );
+			xSemaphoreGiveRecursive( xMutex );
+			xSemaphoreGiveRecursive( xMutex );
+
+			// Now the mutex can be taken by other tasks.
+        }
+        else
+        {
+            // We could not obtain the mutex and can therefore not access
+            // the shared resource safely.
+        }
+    }
+ }
+
+ * \defgroup xSemaphoreTakeRecursive xSemaphoreTakeRecursive + * \ingroup Semaphores + */ +#if( configUSE_RECURSIVE_MUTEXES == 1 ) + #define xSemaphoreTakeRecursive( xMutex, xBlockTime ) xQueueTakeMutexRecursive( ( xMutex ), ( xBlockTime ) ) +#endif + +/** + * semphr. h + * 
xSemaphoreGive( SemaphoreHandle_t xSemaphore )
+ * + * Macro to release a semaphore. The semaphore must have previously been + * created with a call to xSemaphoreCreateBinary(), xSemaphoreCreateMutex() or + * xSemaphoreCreateCounting(). and obtained using sSemaphoreTake(). + * + * This macro must not be used from an ISR. See xSemaphoreGiveFromISR () for + * an alternative which can be used from an ISR. + * + * This macro must also not be used on semaphores created using + * xSemaphoreCreateRecursiveMutex(). + * + * @param xSemaphore A handle to the semaphore being released. This is the + * handle returned when the semaphore was created. + * + * @return pdTRUE if the semaphore was released. pdFALSE if an error occurred. + * Semaphores are implemented using queues. An error can occur if there is + * no space on the queue to post a message - indicating that the + * semaphore was not first obtained correctly. + * + * Example usage: + 
+ SemaphoreHandle_t xSemaphore = NULL;
+
+ void vATask( void * pvParameters )
+ {
+    // Create the semaphore to guard a shared resource.
+    xSemaphore = vSemaphoreCreateBinary();
+
+    if( xSemaphore != NULL )
+    {
+        if( xSemaphoreGive( xSemaphore ) != pdTRUE )
+        {
+            // We would expect this call to fail because we cannot give
+            // a semaphore without first "taking" it!
+        }
+
+        // Obtain the semaphore - don't block if the semaphore is not
+        // immediately available.
+        if( xSemaphoreTake( xSemaphore, ( TickType_t ) 0 ) )
+        {
+            // We now have the semaphore and can access the shared resource.
+
+            // ...
+
+            // We have finished accessing the shared resource so can free the
+            // semaphore.
+            if( xSemaphoreGive( xSemaphore ) != pdTRUE )
+            {
+                // We would not expect this call to fail because we must have
+                // obtained the semaphore to get here.
+            }
+        }
+    }
+ }
+
+ * \defgroup xSemaphoreGive xSemaphoreGive + * \ingroup Semaphores + */ +#define xSemaphoreGive( xSemaphore ) xQueueGenericSend( ( QueueHandle_t ) ( xSemaphore ), NULL, semGIVE_BLOCK_TIME, queueSEND_TO_BACK ) + +/** + * semphr. h + * 
xSemaphoreGiveRecursive( SemaphoreHandle_t xMutex )
+ * + * Macro to recursively release, or 'give', a mutex type semaphore. + * The mutex must have previously been created using a call to + * xSemaphoreCreateRecursiveMutex(); + * + * configUSE_RECURSIVE_MUTEXES must be set to 1 in FreeRTOSConfig.h for this + * macro to be available. + * + * This macro must not be used on mutexes created using xSemaphoreCreateMutex(). + * + * A mutex used recursively can be 'taken' repeatedly by the owner. The mutex + * doesn't become available again until the owner has called + * xSemaphoreGiveRecursive() for each successful 'take' request. For example, + * if a task successfully 'takes' the same mutex 5 times then the mutex will + * not be available to any other task until it has also 'given' the mutex back + * exactly five times. + * + * @param xMutex A handle to the mutex being released, or 'given'. This is the + * handle returned by xSemaphoreCreateMutex(); + * + * @return pdTRUE if the semaphore was given. + * + * Example usage: + 
+ SemaphoreHandle_t xMutex = NULL;
+
+ // A task that creates a mutex.
+ void vATask( void * pvParameters )
+ {
+    // Create the mutex to guard a shared resource.
+    xMutex = xSemaphoreCreateRecursiveMutex();
+ }
+
+ // A task that uses the mutex.
+ void vAnotherTask( void * pvParameters )
+ {
+    // ... Do other things.
+
+    if( xMutex != NULL )
+    {
+        // See if we can obtain the mutex.  If the mutex is not available
+        // wait 10 ticks to see if it becomes free.
+        if( xSemaphoreTakeRecursive( xMutex, ( TickType_t ) 10 ) == pdTRUE )
+        {
+            // We were able to obtain the mutex and can now access the
+            // shared resource.
+
+            // ...
+            // For some reason due to the nature of the code further calls to
+			// xSemaphoreTakeRecursive() are made on the same mutex.  In real
+			// code these would not be just sequential calls as this would make
+			// no sense.  Instead the calls are likely to be buried inside
+			// a more complex call structure.
+            xSemaphoreTakeRecursive( xMutex, ( TickType_t ) 10 );
+            xSemaphoreTakeRecursive( xMutex, ( TickType_t ) 10 );
+
+            // The mutex has now been 'taken' three times, so will not be
+			// available to another task until it has also been given back
+			// three times.  Again it is unlikely that real code would have
+			// these calls sequentially, it would be more likely that the calls
+			// to xSemaphoreGiveRecursive() would be called as a call stack
+			// unwound.  This is just for demonstrative purposes.
+            xSemaphoreGiveRecursive( xMutex );
+			xSemaphoreGiveRecursive( xMutex );
+			xSemaphoreGiveRecursive( xMutex );
+
+			// Now the mutex can be taken by other tasks.
+        }
+        else
+        {
+            // We could not obtain the mutex and can therefore not access
+            // the shared resource safely.
+        }
+    }
+ }
+
+ * \defgroup xSemaphoreGiveRecursive xSemaphoreGiveRecursive + * \ingroup Semaphores + */ +#if( configUSE_RECURSIVE_MUTEXES == 1 ) + #define xSemaphoreGiveRecursive( xMutex ) xQueueGiveMutexRecursive( ( xMutex ) ) +#endif + +/** + * semphr. h + * 
+ xSemaphoreGiveFromISR(
+                          SemaphoreHandle_t xSemaphore,
+                          BaseType_t *pxHigherPriorityTaskWoken
+                      )
+ * + * Macro to release a semaphore. The semaphore must have previously been + * created with a call to xSemaphoreCreateBinary() or xSemaphoreCreateCounting(). + * + * Mutex type semaphores (those created using a call to xSemaphoreCreateMutex()) + * must not be used with this macro. + * + * This macro can be used from an ISR. + * + * @param xSemaphore A handle to the semaphore being released. This is the + * handle returned when the semaphore was created. + * + * @param pxHigherPriorityTaskWoken xSemaphoreGiveFromISR() will set + * *pxHigherPriorityTaskWoken to pdTRUE if giving the semaphore caused a task + * to unblock, and the unblocked task has a priority higher than the currently + * running task. If xSemaphoreGiveFromISR() sets this value to pdTRUE then + * a context switch should be requested before the interrupt is exited. + * + * @return pdTRUE if the semaphore was successfully given, otherwise errQUEUE_FULL. + * + * Example usage: + 
+ \#define LONG_TIME 0xffff
+ \#define TICKS_TO_WAIT	10
+ SemaphoreHandle_t xSemaphore = NULL;
+
+ // Repetitive task.
+ void vATask( void * pvParameters )
+ {
+    for( ;; )
+    {
+        // We want this task to run every 10 ticks of a timer.  The semaphore
+        // was created before this task was started.
+
+        // Block waiting for the semaphore to become available.
+        if( xSemaphoreTake( xSemaphore, LONG_TIME ) == pdTRUE )
+        {
+            // It is time to execute.
+
+            // ...
+
+            // We have finished our task.  Return to the top of the loop where
+            // we will block on the semaphore until it is time to execute
+            // again.  Note when using the semaphore for synchronisation with an
+			// ISR in this manner there is no need to 'give' the semaphore back.
+        }
+    }
+ }
+
+ // Timer ISR
+ void vTimerISR( void * pvParameters )
+ {
+ static uint8_t ucLocalTickCount = 0;
+ static BaseType_t xHigherPriorityTaskWoken;
+
+    // A timer tick has occurred.
+
+    // ... Do other time functions.
+
+    // Is it time for vATask () to run?
+	xHigherPriorityTaskWoken = pdFALSE;
+    ucLocalTickCount++;
+    if( ucLocalTickCount >= TICKS_TO_WAIT )
+    {
+        // Unblock the task by releasing the semaphore.
+        xSemaphoreGiveFromISR( xSemaphore, &xHigherPriorityTaskWoken );
+
+        // Reset the count so we release the semaphore again in 10 ticks time.
+        ucLocalTickCount = 0;
+    }
+
+    if( xHigherPriorityTaskWoken != pdFALSE )
+    {
+        // We can force a context switch here.  Context switching from an
+        // ISR uses port specific syntax.  Check the demo task for your port
+        // to find the syntax required.
+    }
+ }
+
+ * \defgroup xSemaphoreGiveFromISR xSemaphoreGiveFromISR + * \ingroup Semaphores + */ +#define xSemaphoreGiveFromISR( xSemaphore, pxHigherPriorityTaskWoken ) xQueueGiveFromISR( ( QueueHandle_t ) ( xSemaphore ), ( pxHigherPriorityTaskWoken ) ) + +/** + * semphr. h + * 
+ xSemaphoreTakeFromISR(
+                          SemaphoreHandle_t xSemaphore,
+                          BaseType_t *pxHigherPriorityTaskWoken
+                      )
+ * + * Macro to take a semaphore from an ISR. The semaphore must have + * previously been created with a call to xSemaphoreCreateBinary() or + * xSemaphoreCreateCounting(). + * + * Mutex type semaphores (those created using a call to xSemaphoreCreateMutex()) + * must not be used with this macro. + * + * This macro can be used from an ISR, however taking a semaphore from an ISR + * is not a common operation. It is likely to only be useful when taking a + * counting semaphore when an interrupt is obtaining an object from a resource + * pool (when the semaphore count indicates the number of resources available). + * + * @param xSemaphore A handle to the semaphore being taken. This is the + * handle returned when the semaphore was created. + * + * @param pxHigherPriorityTaskWoken xSemaphoreTakeFromISR() will set + * *pxHigherPriorityTaskWoken to pdTRUE if taking the semaphore caused a task + * to unblock, and the unblocked task has a priority higher than the currently + * running task. If xSemaphoreTakeFromISR() sets this value to pdTRUE then + * a context switch should be requested before the interrupt is exited. + * + * @return pdTRUE if the semaphore was successfully taken, otherwise + * pdFALSE + */ +#define xSemaphoreTakeFromISR( xSemaphore, pxHigherPriorityTaskWoken ) xQueueReceiveFromISR( ( QueueHandle_t ) ( xSemaphore ), NULL, ( pxHigherPriorityTaskWoken ) ) + +/** + * semphr. h + * 
SemaphoreHandle_t xSemaphoreCreateMutex( void )
+ * + * Creates a new mutex type semaphore instance, and returns a handle by which + * the new mutex can be referenced. + * + * Internally, within the FreeRTOS implementation, mutex semaphores use a block + * of memory, in which the mutex structure is stored. If a mutex is created + * using xSemaphoreCreateMutex() then the required memory is automatically + * dynamically allocated inside the xSemaphoreCreateMutex() function. (see + * http://www.freertos.org/a00111.html). If a mutex is created using + * xSemaphoreCreateMutexStatic() then the application writer must provided the + * memory. xSemaphoreCreateMutexStatic() therefore allows a mutex to be created + * without using any dynamic memory allocation. + * + * Mutexes created using this function can be accessed using the xSemaphoreTake() + * and xSemaphoreGive() macros. The xSemaphoreTakeRecursive() and + * xSemaphoreGiveRecursive() macros must not be used. + * + * This type of semaphore uses a priority inheritance mechanism so a task + * 'taking' a semaphore MUST ALWAYS 'give' the semaphore back once the + * semaphore it is no longer required. + * + * Mutex type semaphores cannot be used from within interrupt service routines. + * + * See xSemaphoreCreateBinary() for an alternative implementation that can be + * used for pure synchronisation (where one task or interrupt always 'gives' the + * semaphore and another always 'takes' the semaphore) and from within interrupt + * service routines. + * + * @return If the mutex was successfully created then a handle to the created + * semaphore is returned. If there was not enough heap to allocate the mutex + * data structures then NULL is returned. + * + * Example usage: + 
+ SemaphoreHandle_t xSemaphore;
+
+ void vATask( void * pvParameters )
+ {
+    // Semaphore cannot be used before a call to xSemaphoreCreateMutex().
+    // This is a macro so pass the variable in directly.
+    xSemaphore = xSemaphoreCreateMutex();
+
+    if( xSemaphore != NULL )
+    {
+        // The semaphore was created successfully.
+        // The semaphore can now be used.
+    }
+ }
+
+ * \defgroup xSemaphoreCreateMutex xSemaphoreCreateMutex + * \ingroup Semaphores + */ +#if( configSUPPORT_DYNAMIC_ALLOCATION == 1 ) + #define xSemaphoreCreateMutex() xQueueCreateMutex( queueQUEUE_TYPE_MUTEX ) +#endif + +/** + * semphr. h + * 
SemaphoreHandle_t xSemaphoreCreateMutexStatic( StaticSemaphore_t *pxMutexBuffer )
+ * + * Creates a new mutex type semaphore instance, and returns a handle by which + * the new mutex can be referenced. + * + * Internally, within the FreeRTOS implementation, mutex semaphores use a block + * of memory, in which the mutex structure is stored. If a mutex is created + * using xSemaphoreCreateMutex() then the required memory is automatically + * dynamically allocated inside the xSemaphoreCreateMutex() function. (see + * http://www.freertos.org/a00111.html). If a mutex is created using + * xSemaphoreCreateMutexStatic() then the application writer must provided the + * memory. xSemaphoreCreateMutexStatic() therefore allows a mutex to be created + * without using any dynamic memory allocation. + * + * Mutexes created using this function can be accessed using the xSemaphoreTake() + * and xSemaphoreGive() macros. The xSemaphoreTakeRecursive() and + * xSemaphoreGiveRecursive() macros must not be used. + * + * This type of semaphore uses a priority inheritance mechanism so a task + * 'taking' a semaphore MUST ALWAYS 'give' the semaphore back once the + * semaphore it is no longer required. + * + * Mutex type semaphores cannot be used from within interrupt service routines. + * + * See xSemaphoreCreateBinary() for an alternative implementation that can be + * used for pure synchronisation (where one task or interrupt always 'gives' the + * semaphore and another always 'takes' the semaphore) and from within interrupt + * service routines. + * + * @param pxMutexBuffer Must point to a variable of type StaticSemaphore_t, + * which will be used to hold the mutex's data structure, removing the need for + * the memory to be allocated dynamically. + * + * @return If the mutex was successfully created then a handle to the created + * mutex is returned. If pxMutexBuffer was NULL then NULL is returned. + * + * Example usage: + 
+ SemaphoreHandle_t xSemaphore;
+ StaticSemaphore_t xMutexBuffer;
+
+ void vATask( void * pvParameters )
+ {
+    // A mutex cannot be used before it has been created.  xMutexBuffer is
+    // into xSemaphoreCreateMutexStatic() so no dynamic memory allocation is
+    // attempted.
+    xSemaphore = xSemaphoreCreateMutexStatic( &xMutexBuffer );
+
+    // As no dynamic memory allocation was performed, xSemaphore cannot be NULL,
+    // so there is no need to check it.
+ }
+
+ * \defgroup xSemaphoreCreateMutexStatic xSemaphoreCreateMutexStatic + * \ingroup Semaphores + */ + #if( configSUPPORT_STATIC_ALLOCATION == 1 ) + #define xSemaphoreCreateMutexStatic( pxMutexBuffer ) xQueueCreateMutexStatic( queueQUEUE_TYPE_MUTEX, ( pxMutexBuffer ) ) +#endif /* configSUPPORT_STATIC_ALLOCATION */ + + +/** + * semphr. h + * 
SemaphoreHandle_t xSemaphoreCreateRecursiveMutex( void )
+ * + * Creates a new recursive mutex type semaphore instance, and returns a handle + * by which the new recursive mutex can be referenced. + * + * Internally, within the FreeRTOS implementation, recursive mutexs use a block + * of memory, in which the mutex structure is stored. If a recursive mutex is + * created using xSemaphoreCreateRecursiveMutex() then the required memory is + * automatically dynamically allocated inside the + * xSemaphoreCreateRecursiveMutex() function. (see + * http://www.freertos.org/a00111.html). If a recursive mutex is created using + * xSemaphoreCreateRecursiveMutexStatic() then the application writer must + * provide the memory that will get used by the mutex. + * xSemaphoreCreateRecursiveMutexStatic() therefore allows a recursive mutex to + * be created without using any dynamic memory allocation. + * + * Mutexes created using this macro can be accessed using the + * xSemaphoreTakeRecursive() and xSemaphoreGiveRecursive() macros. The + * xSemaphoreTake() and xSemaphoreGive() macros must not be used. + * + * A mutex used recursively can be 'taken' repeatedly by the owner. The mutex + * doesn't become available again until the owner has called + * xSemaphoreGiveRecursive() for each successful 'take' request. For example, + * if a task successfully 'takes' the same mutex 5 times then the mutex will + * not be available to any other task until it has also 'given' the mutex back + * exactly five times. + * + * This type of semaphore uses a priority inheritance mechanism so a task + * 'taking' a semaphore MUST ALWAYS 'give' the semaphore back once the + * semaphore it is no longer required. + * + * Mutex type semaphores cannot be used from within interrupt service routines. + * + * See xSemaphoreCreateBinary() for an alternative implementation that can be + * used for pure synchronisation (where one task or interrupt always 'gives' the + * semaphore and another always 'takes' the semaphore) and from within interrupt + * service routines. + * + * @return xSemaphore Handle to the created mutex semaphore. Should be of type + * SemaphoreHandle_t. + * + * Example usage: + 
+ SemaphoreHandle_t xSemaphore;
+
+ void vATask( void * pvParameters )
+ {
+    // Semaphore cannot be used before a call to xSemaphoreCreateMutex().
+    // This is a macro so pass the variable in directly.
+    xSemaphore = xSemaphoreCreateRecursiveMutex();
+
+    if( xSemaphore != NULL )
+    {
+        // The semaphore was created successfully.
+        // The semaphore can now be used.
+    }
+ }
+
+ * \defgroup xSemaphoreCreateRecursiveMutex xSemaphoreCreateRecursiveMutex + * \ingroup Semaphores + */ +#if( ( configSUPPORT_DYNAMIC_ALLOCATION == 1 ) && ( configUSE_RECURSIVE_MUTEXES == 1 ) ) + #define xSemaphoreCreateRecursiveMutex() xQueueCreateMutex( queueQUEUE_TYPE_RECURSIVE_MUTEX ) +#endif + +/** + * semphr. h + * 
SemaphoreHandle_t xSemaphoreCreateRecursiveMutexStatic( StaticSemaphore_t *pxMutexBuffer )
+ * + * Creates a new recursive mutex type semaphore instance, and returns a handle + * by which the new recursive mutex can be referenced. + * + * Internally, within the FreeRTOS implementation, recursive mutexs use a block + * of memory, in which the mutex structure is stored. If a recursive mutex is + * created using xSemaphoreCreateRecursiveMutex() then the required memory is + * automatically dynamically allocated inside the + * xSemaphoreCreateRecursiveMutex() function. (see + * http://www.freertos.org/a00111.html). If a recursive mutex is created using + * xSemaphoreCreateRecursiveMutexStatic() then the application writer must + * provide the memory that will get used by the mutex. + * xSemaphoreCreateRecursiveMutexStatic() therefore allows a recursive mutex to + * be created without using any dynamic memory allocation. + * + * Mutexes created using this macro can be accessed using the + * xSemaphoreTakeRecursive() and xSemaphoreGiveRecursive() macros. The + * xSemaphoreTake() and xSemaphoreGive() macros must not be used. + * + * A mutex used recursively can be 'taken' repeatedly by the owner. The mutex + * doesn't become available again until the owner has called + * xSemaphoreGiveRecursive() for each successful 'take' request. For example, + * if a task successfully 'takes' the same mutex 5 times then the mutex will + * not be available to any other task until it has also 'given' the mutex back + * exactly five times. + * + * This type of semaphore uses a priority inheritance mechanism so a task + * 'taking' a semaphore MUST ALWAYS 'give' the semaphore back once the + * semaphore it is no longer required. + * + * Mutex type semaphores cannot be used from within interrupt service routines. + * + * See xSemaphoreCreateBinary() for an alternative implementation that can be + * used for pure synchronisation (where one task or interrupt always 'gives' the + * semaphore and another always 'takes' the semaphore) and from within interrupt + * service routines. + * + * @param pxMutexBuffer Must point to a variable of type StaticSemaphore_t, + * which will then be used to hold the recursive mutex's data structure, + * removing the need for the memory to be allocated dynamically. + * + * @return If the recursive mutex was successfully created then a handle to the + * created recursive mutex is returned. If pxMutexBuffer was NULL then NULL is + * returned. + * + * Example usage: + 
+ SemaphoreHandle_t xSemaphore;
+ StaticSemaphore_t xMutexBuffer;
+
+ void vATask( void * pvParameters )
+ {
+    // A recursive semaphore cannot be used before it is created.  Here a
+    // recursive mutex is created using xSemaphoreCreateRecursiveMutexStatic().
+    // The address of xMutexBuffer is passed into the function, and will hold
+    // the mutexes data structures - so no dynamic memory allocation will be
+    // attempted.
+    xSemaphore = xSemaphoreCreateRecursiveMutexStatic( &xMutexBuffer );
+
+    // As no dynamic memory allocation was performed, xSemaphore cannot be NULL,
+    // so there is no need to check it.
+ }
+
+ * \defgroup xSemaphoreCreateRecursiveMutexStatic xSemaphoreCreateRecursiveMutexStatic + * \ingroup Semaphores + */ +#if( ( configSUPPORT_STATIC_ALLOCATION == 1 ) && ( configUSE_RECURSIVE_MUTEXES == 1 ) ) + #define xSemaphoreCreateRecursiveMutexStatic( pxStaticSemaphore ) xQueueCreateMutexStatic( queueQUEUE_TYPE_RECURSIVE_MUTEX, pxStaticSemaphore ) +#endif /* configSUPPORT_STATIC_ALLOCATION */ + +/** + * semphr. h + * 
SemaphoreHandle_t xSemaphoreCreateCounting( UBaseType_t uxMaxCount, UBaseType_t uxInitialCount )
+ * + * Creates a new counting semaphore instance, and returns a handle by which the + * new counting semaphore can be referenced. + * + * In many usage scenarios it is faster and more memory efficient to use a + * direct to task notification in place of a counting semaphore! + * http://www.freertos.org/RTOS-task-notifications.html + * + * Internally, within the FreeRTOS implementation, counting semaphores use a + * block of memory, in which the counting semaphore structure is stored. If a + * counting semaphore is created using xSemaphoreCreateCounting() then the + * required memory is automatically dynamically allocated inside the + * xSemaphoreCreateCounting() function. (see + * http://www.freertos.org/a00111.html). If a counting semaphore is created + * using xSemaphoreCreateCountingStatic() then the application writer can + * instead optionally provide the memory that will get used by the counting + * semaphore. xSemaphoreCreateCountingStatic() therefore allows a counting + * semaphore to be created without using any dynamic memory allocation. + * + * Counting semaphores are typically used for two things: + * + * 1) Counting events. + * + * In this usage scenario an event handler will 'give' a semaphore each time + * an event occurs (incrementing the semaphore count value), and a handler + * task will 'take' a semaphore each time it processes an event + * (decrementing the semaphore count value). The count value is therefore + * the difference between the number of events that have occurred and the + * number that have been processed. In this case it is desirable for the + * initial count value to be zero. + * + * 2) Resource management. + * + * In this usage scenario the count value indicates the number of resources + * available. To obtain control of a resource a task must first obtain a + * semaphore - decrementing the semaphore count value. When the count value + * reaches zero there are no free resources. When a task finishes with the + * resource it 'gives' the semaphore back - incrementing the semaphore count + * value. In this case it is desirable for the initial count value to be + * equal to the maximum count value, indicating that all resources are free. + * + * @param uxMaxCount The maximum count value that can be reached. When the + * semaphore reaches this value it can no longer be 'given'. + * + * @param uxInitialCount The count value assigned to the semaphore when it is + * created. + * + * @return Handle to the created semaphore. Null if the semaphore could not be + * created. + * + * Example usage: + 
+ SemaphoreHandle_t xSemaphore;
+
+ void vATask( void * pvParameters )
+ {
+ SemaphoreHandle_t xSemaphore = NULL;
+
+    // Semaphore cannot be used before a call to xSemaphoreCreateCounting().
+    // The max value to which the semaphore can count should be 10, and the
+    // initial value assigned to the count should be 0.
+    xSemaphore = xSemaphoreCreateCounting( 10, 0 );
+
+    if( xSemaphore != NULL )
+    {
+        // The semaphore was created successfully.
+        // The semaphore can now be used.
+    }
+ }
+
+ * \defgroup xSemaphoreCreateCounting xSemaphoreCreateCounting + * \ingroup Semaphores + */ +#if( configSUPPORT_DYNAMIC_ALLOCATION == 1 ) + #define xSemaphoreCreateCounting( uxMaxCount, uxInitialCount ) xQueueCreateCountingSemaphore( ( uxMaxCount ), ( uxInitialCount ) ) +#endif + +/** + * semphr. h + * 
SemaphoreHandle_t xSemaphoreCreateCountingStatic( UBaseType_t uxMaxCount, UBaseType_t uxInitialCount, StaticSemaphore_t *pxSemaphoreBuffer )
+ * + * Creates a new counting semaphore instance, and returns a handle by which the + * new counting semaphore can be referenced. + * + * In many usage scenarios it is faster and more memory efficient to use a + * direct to task notification in place of a counting semaphore! + * http://www.freertos.org/RTOS-task-notifications.html + * + * Internally, within the FreeRTOS implementation, counting semaphores use a + * block of memory, in which the counting semaphore structure is stored. If a + * counting semaphore is created using xSemaphoreCreateCounting() then the + * required memory is automatically dynamically allocated inside the + * xSemaphoreCreateCounting() function. (see + * http://www.freertos.org/a00111.html). If a counting semaphore is created + * using xSemaphoreCreateCountingStatic() then the application writer must + * provide the memory. xSemaphoreCreateCountingStatic() therefore allows a + * counting semaphore to be created without using any dynamic memory allocation. + * + * Counting semaphores are typically used for two things: + * + * 1) Counting events. + * + * In this usage scenario an event handler will 'give' a semaphore each time + * an event occurs (incrementing the semaphore count value), and a handler + * task will 'take' a semaphore each time it processes an event + * (decrementing the semaphore count value). The count value is therefore + * the difference between the number of events that have occurred and the + * number that have been processed. In this case it is desirable for the + * initial count value to be zero. + * + * 2) Resource management. + * + * In this usage scenario the count value indicates the number of resources + * available. To obtain control of a resource a task must first obtain a + * semaphore - decrementing the semaphore count value. When the count value + * reaches zero there are no free resources. When a task finishes with the + * resource it 'gives' the semaphore back - incrementing the semaphore count + * value. In this case it is desirable for the initial count value to be + * equal to the maximum count value, indicating that all resources are free. + * + * @param uxMaxCount The maximum count value that can be reached. When the + * semaphore reaches this value it can no longer be 'given'. + * + * @param uxInitialCount The count value assigned to the semaphore when it is + * created. + * + * @param pxSemaphoreBuffer Must point to a variable of type StaticSemaphore_t, + * which will then be used to hold the semaphore's data structure, removing the + * need for the memory to be allocated dynamically. + * + * @return If the counting semaphore was successfully created then a handle to + * the created counting semaphore is returned. If pxSemaphoreBuffer was NULL + * then NULL is returned. + * + * Example usage: + 
+ SemaphoreHandle_t xSemaphore;
+ StaticSemaphore_t xSemaphoreBuffer;
+
+ void vATask( void * pvParameters )
+ {
+ SemaphoreHandle_t xSemaphore = NULL;
+
+    // Counting semaphore cannot be used before they have been created.  Create
+    // a counting semaphore using xSemaphoreCreateCountingStatic().  The max
+    // value to which the semaphore can count is 10, and the initial value
+    // assigned to the count will be 0.  The address of xSemaphoreBuffer is
+    // passed in and will be used to hold the semaphore structure, so no dynamic
+    // memory allocation will be used.
+    xSemaphore = xSemaphoreCreateCounting( 10, 0, &xSemaphoreBuffer );
+
+    // No memory allocation was attempted so xSemaphore cannot be NULL, so there
+    // is no need to check its value.
+ }
+
+ * \defgroup xSemaphoreCreateCountingStatic xSemaphoreCreateCountingStatic + * \ingroup Semaphores + */ +#if( configSUPPORT_STATIC_ALLOCATION == 1 ) + #define xSemaphoreCreateCountingStatic( uxMaxCount, uxInitialCount, pxSemaphoreBuffer ) xQueueCreateCountingSemaphoreStatic( ( uxMaxCount ), ( uxInitialCount ), ( pxSemaphoreBuffer ) ) +#endif /* configSUPPORT_STATIC_ALLOCATION */ + +/** + * semphr. h + * 
void vSemaphoreDelete( SemaphoreHandle_t xSemaphore );
+ * + * Delete a semaphore. This function must be used with care. For example, + * do not delete a mutex type semaphore if the mutex is held by a task. + * + * @param xSemaphore A handle to the semaphore to be deleted. + * + * \defgroup vSemaphoreDelete vSemaphoreDelete + * \ingroup Semaphores + */ +#define vSemaphoreDelete( xSemaphore ) vQueueDelete( ( QueueHandle_t ) ( xSemaphore ) ) + +/** + * semphr.h + * 
TaskHandle_t xSemaphoreGetMutexHolder( SemaphoreHandle_t xMutex );
+ * + * If xMutex is indeed a mutex type semaphore, return the current mutex holder. + * If xMutex is not a mutex type semaphore, or the mutex is available (not held + * by a task), return NULL. + * + * Note: This is a good way of determining if the calling task is the mutex + * holder, but not a good way of determining the identity of the mutex holder as + * the holder may change between the function exiting and the returned value + * being tested. + */ +#define xSemaphoreGetMutexHolder( xSemaphore ) xQueueGetMutexHolder( ( xSemaphore ) ) + +/** + * semphr.h + * 
UBaseType_t uxSemaphoreGetCount( SemaphoreHandle_t xSemaphore );
+ * + * If the semaphore is a counting semaphore then uxSemaphoreGetCount() returns + * its current count value. If the semaphore is a binary semaphore then + * uxSemaphoreGetCount() returns 1 if the semaphore is available, and 0 if the + * semaphore is not available. + * + */ +#define uxSemaphoreGetCount( xSemaphore ) uxQueueMessagesWaiting( ( QueueHandle_t ) ( xSemaphore ) ) + +#endif /* SEMAPHORE_H */ + + diff --git a/FreeRTOS/include/stdint.readme b/FreeRTOS/include/stdint.readme new file mode 100644 index 0000000..4414c29 --- /dev/null +++ b/FreeRTOS/include/stdint.readme @@ -0,0 +1,27 @@ + +#ifndef FREERTOS_STDINT +#define FREERTOS_STDINT + +/******************************************************************************* + * THIS IS NOT A FULL stdint.h IMPLEMENTATION - It only contains the definitions + * necessary to build the FreeRTOS code. It is provided to allow FreeRTOS to be + * built using compilers that do not provide their own stdint.h definition. + * + * To use this file: + * + * 1) Copy this file into the directory that contains your FreeRTOSConfig.h + * header file, as that directory will already be in the compilers include + * path. + * + * 2) Rename the copied file stdint.h. + * + */ + +typedef signed char int8_t; +typedef unsigned char uint8_t; +typedef short int16_t; +typedef unsigned short uint16_t; +typedef long int32_t; +typedef unsigned long uint32_t; + +#endif /* FREERTOS_STDINT */ diff --git a/FreeRTOS/include/task.h b/FreeRTOS/include/task.h new file mode 100644 index 0000000..d0643c0 --- /dev/null +++ b/FreeRTOS/include/task.h @@ -0,0 +1,2267 @@ +/* + FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd. + All rights reserved + + VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION. + + This file is part of the FreeRTOS distribution. + + FreeRTOS is free software; you can redistribute it and/or modify it under + the terms of the GNU General Public License (version 2) as published by the + Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception. + + *************************************************************************** + >>! NOTE: The modification to the GPL is included to allow you to !<< + >>! distribute a combined work that includes FreeRTOS without being !<< + >>! obliged to provide the source code for proprietary components !<< + >>! outside of the FreeRTOS kernel. !<< + *************************************************************************** + + FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY + WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS + FOR A PARTICULAR PURPOSE. Full license text is available on the following + link: http://www.freertos.org/a00114.html + + *************************************************************************** + * * + * FreeRTOS provides completely free yet professionally developed, * + * robust, strictly quality controlled, supported, and cross * + * platform software that is more than just the market leader, it * + * is the industry's de facto standard. * + * * + * Help yourself get started quickly while simultaneously helping * + * to support the FreeRTOS project by purchasing a FreeRTOS * + * tutorial book, reference manual, or both: * + * http://www.FreeRTOS.org/Documentation * + * * + *************************************************************************** + + http://www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading + the FAQ page "My application does not run, what could be wrong?". Have you + defined configASSERT()? + + http://www.FreeRTOS.org/support - In return for receiving this top quality + embedded software for free we request you assist our global community by + participating in the support forum. + + http://www.FreeRTOS.org/training - Investing in training allows your team to + be as productive as possible as early as possible. Now you can receive + FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers + Ltd, and the world's leading authority on the world's leading RTOS. + + http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products, + including FreeRTOS+Trace - an indispensable productivity tool, a DOS + compatible FAT file system, and our tiny thread aware UDP/IP stack. + + http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate. + Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS. + + http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High + Integrity Systems ltd. to sell under the OpenRTOS brand. Low cost OpenRTOS + licenses offer ticketed support, indemnification and commercial middleware. + + http://www.SafeRTOS.com - High Integrity Systems also provide a safety + engineered and independently SIL3 certified version for use in safety and + mission critical applications that require provable dependability. + + 1 tab == 4 spaces! +*/ + + +#ifndef INC_TASK_H +#define INC_TASK_H + +#ifndef INC_FREERTOS_H + #error "include FreeRTOS.h must appear in source files before include task.h" +#endif + +#include "list.h" + +#ifdef __cplusplus +extern "C" { +#endif + +/*----------------------------------------------------------- + * MACROS AND DEFINITIONS + *----------------------------------------------------------*/ + +#define tskKERNEL_VERSION_NUMBER "V9.0.0" +#define tskKERNEL_VERSION_MAJOR 9 +#define tskKERNEL_VERSION_MINOR 0 +#define tskKERNEL_VERSION_BUILD 0 + +/** + * task. h + * + * Type by which tasks are referenced. For example, a call to xTaskCreate + * returns (via a pointer parameter) an TaskHandle_t variable that can then + * be used as a parameter to vTaskDelete to delete the task. + * + * \defgroup TaskHandle_t TaskHandle_t + * \ingroup Tasks + */ +typedef void * TaskHandle_t; + +/* + * Defines the prototype to which the application task hook function must + * conform. + */ +typedef BaseType_t (*TaskHookFunction_t)( void * ); + +/* Task states returned by eTaskGetState. */ +typedef enum +{ + eRunning = 0, /* A task is querying the state of itself, so must be running. */ + eReady, /* The task being queried is in a read or pending ready list. */ + eBlocked, /* The task being queried is in the Blocked state. */ + eSuspended, /* The task being queried is in the Suspended state, or is in the Blocked state with an infinite time out. */ + eDeleted, /* The task being queried has been deleted, but its TCB has not yet been freed. */ + eInvalid /* Used as an 'invalid state' value. */ +} eTaskState; + +/* Actions that can be performed when vTaskNotify() is called. */ +typedef enum +{ + eNoAction = 0, /* Notify the task without updating its notify value. */ + eSetBits, /* Set bits in the task's notification value. */ + eIncrement, /* Increment the task's notification value. */ + eSetValueWithOverwrite, /* Set the task's notification value to a specific value even if the previous value has not yet been read by the task. */ + eSetValueWithoutOverwrite /* Set the task's notification value if the previous value has been read by the task. */ +} eNotifyAction; + +/* + * Used internally only. + */ +typedef struct xTIME_OUT +{ + BaseType_t xOverflowCount; + TickType_t xTimeOnEntering; +} TimeOut_t; + +/* + * Defines the memory ranges allocated to the task when an MPU is used. + */ +typedef struct xMEMORY_REGION +{ + void *pvBaseAddress; + uint32_t ulLengthInBytes; + uint32_t ulParameters; +} MemoryRegion_t; + +/* + * Parameters required to create an MPU protected task. + */ +typedef struct xTASK_PARAMETERS +{ + TaskFunction_t pvTaskCode; + const char * const pcName; /*lint !e971 Unqualified char types are allowed for strings and single characters only. */ + uint16_t usStackDepth; + void *pvParameters; + UBaseType_t uxPriority; + StackType_t *puxStackBuffer; + MemoryRegion_t xRegions[ portNUM_CONFIGURABLE_REGIONS ]; +} TaskParameters_t; + +/* Used with the uxTaskGetSystemState() function to return the state of each task +in the system. */ +typedef struct xTASK_STATUS +{ + TaskHandle_t xHandle; /* The handle of the task to which the rest of the information in the structure relates. */ + const char *pcTaskName; /* A pointer to the task's name. This value will be invalid if the task was deleted since the structure was populated! */ /*lint !e971 Unqualified char types are allowed for strings and single characters only. */ + UBaseType_t xTaskNumber; /* A number unique to the task. */ + eTaskState eCurrentState; /* The state in which the task existed when the structure was populated. */ + UBaseType_t uxCurrentPriority; /* The priority at which the task was running (may be inherited) when the structure was populated. */ + UBaseType_t uxBasePriority; /* The priority to which the task will return if the task's current priority has been inherited to avoid unbounded priority inversion when obtaining a mutex. Only valid if configUSE_MUTEXES is defined as 1 in FreeRTOSConfig.h. */ + uint32_t ulRunTimeCounter; /* The total run time allocated to the task so far, as defined by the run time stats clock. See http://www.freertos.org/rtos-run-time-stats.html. Only valid when configGENERATE_RUN_TIME_STATS is defined as 1 in FreeRTOSConfig.h. */ + StackType_t *pxStackBase; /* Points to the lowest address of the task's stack area. */ + uint16_t usStackHighWaterMark; /* The minimum amount of stack space that has remained for the task since the task was created. The closer this value is to zero the closer the task has come to overflowing its stack. */ +} TaskStatus_t; + +/* Possible return values for eTaskConfirmSleepModeStatus(). */ +typedef enum +{ + eAbortSleep = 0, /* A task has been made ready or a context switch pended since portSUPPORESS_TICKS_AND_SLEEP() was called - abort entering a sleep mode. */ + eStandardSleep, /* Enter a sleep mode that will not last any longer than the expected idle time. */ + eNoTasksWaitingTimeout /* No tasks are waiting for a timeout so it is safe to enter a sleep mode that can only be exited by an external interrupt. */ +} eSleepModeStatus; + +/** + * Defines the priority used by the idle task. This must not be modified. + * + * \ingroup TaskUtils + */ +#define tskIDLE_PRIORITY ( ( UBaseType_t ) 0U ) + +/** + * task. h + * + * Macro for forcing a context switch. + * + * \defgroup taskYIELD taskYIELD + * \ingroup SchedulerControl + */ +#define taskYIELD() portYIELD() + +/** + * task. h + * + * Macro to mark the start of a critical code region. Preemptive context + * switches cannot occur when in a critical region. + * + * NOTE: This may alter the stack (depending on the portable implementation) + * so must be used with care! + * + * \defgroup taskENTER_CRITICAL taskENTER_CRITICAL + * \ingroup SchedulerControl + */ +#define taskENTER_CRITICAL() portENTER_CRITICAL() +#define taskENTER_CRITICAL_FROM_ISR() portSET_INTERRUPT_MASK_FROM_ISR() + +/** + * task. h + * + * Macro to mark the end of a critical code region. Preemptive context + * switches cannot occur when in a critical region. + * + * NOTE: This may alter the stack (depending on the portable implementation) + * so must be used with care! + * + * \defgroup taskEXIT_CRITICAL taskEXIT_CRITICAL + * \ingroup SchedulerControl + */ +#define taskEXIT_CRITICAL() portEXIT_CRITICAL() +#define taskEXIT_CRITICAL_FROM_ISR( x ) portCLEAR_INTERRUPT_MASK_FROM_ISR( x ) +/** + * task. h + * + * Macro to disable all maskable interrupts. + * + * \defgroup taskDISABLE_INTERRUPTS taskDISABLE_INTERRUPTS + * \ingroup SchedulerControl + */ +#define taskDISABLE_INTERRUPTS() portDISABLE_INTERRUPTS() + +/** + * task. h + * + * Macro to enable microcontroller interrupts. + * + * \defgroup taskENABLE_INTERRUPTS taskENABLE_INTERRUPTS + * \ingroup SchedulerControl + */ +#define taskENABLE_INTERRUPTS() portENABLE_INTERRUPTS() + +/* Definitions returned by xTaskGetSchedulerState(). taskSCHEDULER_SUSPENDED is +0 to generate more optimal code when configASSERT() is defined as the constant +is used in assert() statements. */ +#define taskSCHEDULER_SUSPENDED ( ( BaseType_t ) 0 ) +#define taskSCHEDULER_NOT_STARTED ( ( BaseType_t ) 1 ) +#define taskSCHEDULER_RUNNING ( ( BaseType_t ) 2 ) + + +/*----------------------------------------------------------- + * TASK CREATION API + *----------------------------------------------------------*/ + +/** + * task. h + *
+ BaseType_t xTaskCreate(
+							  TaskFunction_t pvTaskCode,
+							  const char * const pcName,
+							  uint16_t usStackDepth,
+							  void *pvParameters,
+							  UBaseType_t uxPriority,
+							  TaskHandle_t *pvCreatedTask
+						  );
+ * + * Create a new task and add it to the list of tasks that are ready to run. + * + * Internally, within the FreeRTOS implementation, tasks use two blocks of + * memory. The first block is used to hold the task's data structures. The + * second block is used by the task as its stack. If a task is created using + * xTaskCreate() then both blocks of memory are automatically dynamically + * allocated inside the xTaskCreate() function. (see + * http://www.freertos.org/a00111.html). If a task is created using + * xTaskCreateStatic() then the application writer must provide the required + * memory. xTaskCreateStatic() therefore allows a task to be created without + * using any dynamic memory allocation. + * + * See xTaskCreateStatic() for a version that does not use any dynamic memory + * allocation. + * + * xTaskCreate() can only be used to create a task that has unrestricted + * access to the entire microcontroller memory map. Systems that include MPU + * support can alternatively create an MPU constrained task using + * xTaskCreateRestricted(). + * + * @param pvTaskCode Pointer to the task entry function. Tasks + * must be implemented to never return (i.e. continuous loop). + * + * @param pcName A descriptive name for the task. This is mainly used to + * facilitate debugging. Max length defined by configMAX_TASK_NAME_LEN - default + * is 16. + * + * @param usStackDepth The size of the task stack specified as the number of + * variables the stack can hold - not the number of bytes. For example, if + * the stack is 16 bits wide and usStackDepth is defined as 100, 200 bytes + * will be allocated for stack storage. + * + * @param pvParameters Pointer that will be used as the parameter for the task + * being created. + * + * @param uxPriority The priority at which the task should run. Systems that + * include MPU support can optionally create tasks in a privileged (system) + * mode by setting bit portPRIVILEGE_BIT of the priority parameter. For + * example, to create a privileged task at priority 2 the uxPriority parameter + * should be set to ( 2 | portPRIVILEGE_BIT ). + * + * @param pvCreatedTask Used to pass back a handle by which the created task + * can be referenced. + * + * @return pdPASS if the task was successfully created and added to a ready + * list, otherwise an error code defined in the file projdefs.h + * + * Example usage: + 
+ // Task to be created.
+ void vTaskCode( void * pvParameters )
+ {
+	 for( ;; )
+	 {
+		 // Task code goes here.
+	 }
+ }
+
+ // Function that creates a task.
+ void vOtherFunction( void )
+ {
+ static uint8_t ucParameterToPass;
+ TaskHandle_t xHandle = NULL;
+
+	 // Create the task, storing the handle.  Note that the passed parameter ucParameterToPass
+	 // must exist for the lifetime of the task, so in this case is declared static.  If it was just an
+	 // an automatic stack variable it might no longer exist, or at least have been corrupted, by the time
+	 // the new task attempts to access it.
+	 xTaskCreate( vTaskCode, "NAME", STACK_SIZE, &ucParameterToPass, tskIDLE_PRIORITY, &xHandle );
+     configASSERT( xHandle );
+
+	 // Use the handle to delete the task.
+     if( xHandle != NULL )
+     {
+	     vTaskDelete( xHandle );
+     }
+ }
+
+ * \defgroup xTaskCreate xTaskCreate + * \ingroup Tasks + */ +#if( configSUPPORT_DYNAMIC_ALLOCATION == 1 ) + BaseType_t xTaskCreate( TaskFunction_t pxTaskCode, + const char * const pcName, + const uint16_t usStackDepth, + void * const pvParameters, + UBaseType_t uxPriority, + TaskHandle_t * const pxCreatedTask ) PRIVILEGED_FUNCTION; /*lint !e971 Unqualified char types are allowed for strings and single characters only. */ +#endif + +/** + * task. h + *
+ TaskHandle_t xTaskCreateStatic( TaskFunction_t pvTaskCode,
+								 const char * const pcName,
+								 uint32_t ulStackDepth,
+								 void *pvParameters,
+								 UBaseType_t uxPriority,
+								 StackType_t *pxStackBuffer,
+								 StaticTask_t *pxTaskBuffer );
+ * + * Create a new task and add it to the list of tasks that are ready to run. + * + * Internally, within the FreeRTOS implementation, tasks use two blocks of + * memory. The first block is used to hold the task's data structures. The + * second block is used by the task as its stack. If a task is created using + * xTaskCreate() then both blocks of memory are automatically dynamically + * allocated inside the xTaskCreate() function. (see + * http://www.freertos.org/a00111.html). If a task is created using + * xTaskCreateStatic() then the application writer must provide the required + * memory. xTaskCreateStatic() therefore allows a task to be created without + * using any dynamic memory allocation. + * + * @param pvTaskCode Pointer to the task entry function. Tasks + * must be implemented to never return (i.e. continuous loop). + * + * @param pcName A descriptive name for the task. This is mainly used to + * facilitate debugging. The maximum length of the string is defined by + * configMAX_TASK_NAME_LEN in FreeRTOSConfig.h. + * + * @param ulStackDepth The size of the task stack specified as the number of + * variables the stack can hold - not the number of bytes. For example, if + * the stack is 32-bits wide and ulStackDepth is defined as 100 then 400 bytes + * will be allocated for stack storage. + * + * @param pvParameters Pointer that will be used as the parameter for the task + * being created. + * + * @param uxPriority The priority at which the task will run. + * + * @param pxStackBuffer Must point to a StackType_t array that has at least + * ulStackDepth indexes - the array will then be used as the task's stack, + * removing the need for the stack to be allocated dynamically. + * + * @param pxTaskBuffer Must point to a variable of type StaticTask_t, which will + * then be used to hold the task's data structures, removing the need for the + * memory to be allocated dynamically. + * + * @return If neither pxStackBuffer or pxTaskBuffer are NULL, then the task will + * be created and pdPASS is returned. If either pxStackBuffer or pxTaskBuffer + * are NULL then the task will not be created and + * errCOULD_NOT_ALLOCATE_REQUIRED_MEMORY is returned. + * + * Example usage: + 
+
+    // Dimensions the buffer that the task being created will use as its stack.
+    // NOTE:  This is the number of words the stack will hold, not the number of
+    // bytes.  For example, if each stack item is 32-bits, and this is set to 100,
+    // then 400 bytes (100 * 32-bits) will be allocated.
+    #define STACK_SIZE 200
+
+    // Structure that will hold the TCB of the task being created.
+    StaticTask_t xTaskBuffer;
+
+    // Buffer that the task being created will use as its stack.  Note this is
+    // an array of StackType_t variables.  The size of StackType_t is dependent on
+    // the RTOS port.
+    StackType_t xStack[ STACK_SIZE ];
+
+    // Function that implements the task being created.
+    void vTaskCode( void * pvParameters )
+    {
+        // The parameter value is expected to be 1 as 1 is passed in the
+        // pvParameters value in the call to xTaskCreateStatic().
+        configASSERT( ( uint32_t ) pvParameters == 1UL );
+
+        for( ;; )
+        {
+            // Task code goes here.
+        }
+    }
+
+    // Function that creates a task.
+    void vOtherFunction( void )
+    {
+        TaskHandle_t xHandle = NULL;
+
+        // Create the task without using any dynamic memory allocation.
+        xHandle = xTaskCreateStatic(
+                      vTaskCode,       // Function that implements the task.
+                      "NAME",          // Text name for the task.
+                      STACK_SIZE,      // Stack size in words, not bytes.
+                      ( void * ) 1,    // Parameter passed into the task.
+                      tskIDLE_PRIORITY,// Priority at which the task is created.
+                      xStack,          // Array to use as the task's stack.
+                      &xTaskBuffer );  // Variable to hold the task's data structure.
+
+        // puxStackBuffer and pxTaskBuffer were not NULL, so the task will have
+        // been created, and xHandle will be the task's handle.  Use the handle
+        // to suspend the task.
+        vTaskSuspend( xHandle );
+    }
+
+ * \defgroup xTaskCreateStatic xTaskCreateStatic + * \ingroup Tasks + */ +#if( configSUPPORT_STATIC_ALLOCATION == 1 ) + TaskHandle_t xTaskCreateStatic( TaskFunction_t pxTaskCode, + const char * const pcName, + const uint32_t ulStackDepth, + void * const pvParameters, + UBaseType_t uxPriority, + StackType_t * const puxStackBuffer, + StaticTask_t * const pxTaskBuffer ) PRIVILEGED_FUNCTION; /*lint !e971 Unqualified char types are allowed for strings and single characters only. */ +#endif /* configSUPPORT_STATIC_ALLOCATION */ + +/** + * task. h + *
+ BaseType_t xTaskCreateRestricted( TaskParameters_t *pxTaskDefinition, TaskHandle_t *pxCreatedTask );
+ * + * xTaskCreateRestricted() should only be used in systems that include an MPU + * implementation. + * + * Create a new task and add it to the list of tasks that are ready to run. + * The function parameters define the memory regions and associated access + * permissions allocated to the task. + * + * @param pxTaskDefinition Pointer to a structure that contains a member + * for each of the normal xTaskCreate() parameters (see the xTaskCreate() API + * documentation) plus an optional stack buffer and the memory region + * definitions. + * + * @param pxCreatedTask Used to pass back a handle by which the created task + * can be referenced. + * + * @return pdPASS if the task was successfully created and added to a ready + * list, otherwise an error code defined in the file projdefs.h + * + * Example usage: + 
+// Create an TaskParameters_t structure that defines the task to be created.
+static const TaskParameters_t xCheckTaskParameters =
+{
+	vATask,		// pvTaskCode - the function that implements the task.
+	"ATask",	// pcName - just a text name for the task to assist debugging.
+	100,		// usStackDepth	- the stack size DEFINED IN WORDS.
+	NULL,		// pvParameters - passed into the task function as the function parameters.
+	( 1UL | portPRIVILEGE_BIT ),// uxPriority - task priority, set the portPRIVILEGE_BIT if the task should run in a privileged state.
+	cStackBuffer,// puxStackBuffer - the buffer to be used as the task stack.
+
+	// xRegions - Allocate up to three separate memory regions for access by
+	// the task, with appropriate access permissions.  Different processors have
+	// different memory alignment requirements - refer to the FreeRTOS documentation
+	// for full information.
+	{
+		// Base address					Length	Parameters
+        { cReadWriteArray,				32,		portMPU_REGION_READ_WRITE },
+        { cReadOnlyArray,				32,		portMPU_REGION_READ_ONLY },
+        { cPrivilegedOnlyAccessArray,	128,	portMPU_REGION_PRIVILEGED_READ_WRITE }
+	}
+};
+
+int main( void )
+{
+TaskHandle_t xHandle;
+
+	// Create a task from the const structure defined above.  The task handle
+	// is requested (the second parameter is not NULL) but in this case just for
+	// demonstration purposes as its not actually used.
+	xTaskCreateRestricted( &xRegTest1Parameters, &xHandle );
+
+	// Start the scheduler.
+	vTaskStartScheduler();
+
+	// Will only get here if there was insufficient memory to create the idle
+	// and/or timer task.
+	for( ;; );
+}
+
+ * \defgroup xTaskCreateRestricted xTaskCreateRestricted + * \ingroup Tasks + */ +#if( portUSING_MPU_WRAPPERS == 1 ) + BaseType_t xTaskCreateRestricted( const TaskParameters_t * const pxTaskDefinition, TaskHandle_t *pxCreatedTask ) PRIVILEGED_FUNCTION; +#endif + +/** + * task. h + *
+ void vTaskAllocateMPURegions( TaskHandle_t xTask, const MemoryRegion_t * const pxRegions );
+ * + * Memory regions are assigned to a restricted task when the task is created by + * a call to xTaskCreateRestricted(). These regions can be redefined using + * vTaskAllocateMPURegions(). + * + * @param xTask The handle of the task being updated. + * + * @param xRegions A pointer to an MemoryRegion_t structure that contains the + * new memory region definitions. + * + * Example usage: + 
+// Define an array of MemoryRegion_t structures that configures an MPU region
+// allowing read/write access for 1024 bytes starting at the beginning of the
+// ucOneKByte array.  The other two of the maximum 3 definable regions are
+// unused so set to zero.
+static const MemoryRegion_t xAltRegions[ portNUM_CONFIGURABLE_REGIONS ] =
+{
+	// Base address		Length		Parameters
+	{ ucOneKByte,		1024,		portMPU_REGION_READ_WRITE },
+	{ 0,				0,			0 },
+	{ 0,				0,			0 }
+};
+
+void vATask( void *pvParameters )
+{
+	// This task was created such that it has access to certain regions of
+	// memory as defined by the MPU configuration.  At some point it is
+	// desired that these MPU regions are replaced with that defined in the
+	// xAltRegions const struct above.  Use a call to vTaskAllocateMPURegions()
+	// for this purpose.  NULL is used as the task handle to indicate that this
+	// function should modify the MPU regions of the calling task.
+	vTaskAllocateMPURegions( NULL, xAltRegions );
+
+	// Now the task can continue its function, but from this point on can only
+	// access its stack and the ucOneKByte array (unless any other statically
+	// defined or shared regions have been declared elsewhere).
+}
+
+ * \defgroup xTaskCreateRestricted xTaskCreateRestricted + * \ingroup Tasks + */ +void vTaskAllocateMPURegions( TaskHandle_t xTask, const MemoryRegion_t * const pxRegions ) PRIVILEGED_FUNCTION; + +/** + * task. h + * 
void vTaskDelete( TaskHandle_t xTask );
+ * + * INCLUDE_vTaskDelete must be defined as 1 for this function to be available. + * See the configuration section for more information. + * + * Remove a task from the RTOS real time kernel's management. The task being + * deleted will be removed from all ready, blocked, suspended and event lists. + * + * NOTE: The idle task is responsible for freeing the kernel allocated + * memory from tasks that have been deleted. It is therefore important that + * the idle task is not starved of microcontroller processing time if your + * application makes any calls to vTaskDelete (). Memory allocated by the + * task code is not automatically freed, and should be freed before the task + * is deleted. + * + * See the demo application file death.c for sample code that utilises + * vTaskDelete (). + * + * @param xTask The handle of the task to be deleted. Passing NULL will + * cause the calling task to be deleted. + * + * Example usage: + 
+ void vOtherFunction( void )
+ {
+ TaskHandle_t xHandle;
+
+	 // Create the task, storing the handle.
+	 xTaskCreate( vTaskCode, "NAME", STACK_SIZE, NULL, tskIDLE_PRIORITY, &xHandle );
+
+	 // Use the handle to delete the task.
+	 vTaskDelete( xHandle );
+ }
+
+ * \defgroup vTaskDelete vTaskDelete + * \ingroup Tasks + */ +void vTaskDelete( TaskHandle_t xTaskToDelete ) PRIVILEGED_FUNCTION; + +/*----------------------------------------------------------- + * TASK CONTROL API + *----------------------------------------------------------*/ + +/** + * task. h + * 
void vTaskDelay( const TickType_t xTicksToDelay );
+ * + * Delay a task for a given number of ticks. The actual time that the + * task remains blocked depends on the tick rate. The constant + * portTICK_PERIOD_MS can be used to calculate real time from the tick + * rate - with the resolution of one tick period. + * + * INCLUDE_vTaskDelay must be defined as 1 for this function to be available. + * See the configuration section for more information. + * + * + * vTaskDelay() specifies a time at which the task wishes to unblock relative to + * the time at which vTaskDelay() is called. For example, specifying a block + * period of 100 ticks will cause the task to unblock 100 ticks after + * vTaskDelay() is called. vTaskDelay() does not therefore provide a good method + * of controlling the frequency of a periodic task as the path taken through the + * code, as well as other task and interrupt activity, will effect the frequency + * at which vTaskDelay() gets called and therefore the time at which the task + * next executes. See vTaskDelayUntil() for an alternative API function designed + * to facilitate fixed frequency execution. It does this by specifying an + * absolute time (rather than a relative time) at which the calling task should + * unblock. + * + * @param xTicksToDelay The amount of time, in tick periods, that + * the calling task should block. + * + * Example usage: + + void vTaskFunction( void * pvParameters ) + { + // Block for 500ms. + const TickType_t xDelay = 500 / portTICK_PERIOD_MS; + + for( ;; ) + { + // Simply toggle the LED every 500ms, blocking between each toggle. + vToggleLED(); + vTaskDelay( xDelay ); + } + } + + * \defgroup vTaskDelay vTaskDelay + * \ingroup TaskCtrl + */ +void vTaskDelay( const TickType_t xTicksToDelay ) PRIVILEGED_FUNCTION; + +/** + * task. h + * 
void vTaskDelayUntil( TickType_t *pxPreviousWakeTime, const TickType_t xTimeIncrement );
+ * + * INCLUDE_vTaskDelayUntil must be defined as 1 for this function to be available. + * See the configuration section for more information. + * + * Delay a task until a specified time. This function can be used by periodic + * tasks to ensure a constant execution frequency. + * + * This function differs from vTaskDelay () in one important aspect: vTaskDelay () will + * cause a task to block for the specified number of ticks from the time vTaskDelay () is + * called. It is therefore difficult to use vTaskDelay () by itself to generate a fixed + * execution frequency as the time between a task starting to execute and that task + * calling vTaskDelay () may not be fixed [the task may take a different path though the + * code between calls, or may get interrupted or preempted a different number of times + * each time it executes]. + * + * Whereas vTaskDelay () specifies a wake time relative to the time at which the function + * is called, vTaskDelayUntil () specifies the absolute (exact) time at which it wishes to + * unblock. + * + * The constant portTICK_PERIOD_MS can be used to calculate real time from the tick + * rate - with the resolution of one tick period. + * + * @param pxPreviousWakeTime Pointer to a variable that holds the time at which the + * task was last unblocked. The variable must be initialised with the current time + * prior to its first use (see the example below). Following this the variable is + * automatically updated within vTaskDelayUntil (). + * + * @param xTimeIncrement The cycle time period. The task will be unblocked at + * time *pxPreviousWakeTime + xTimeIncrement. Calling vTaskDelayUntil with the + * same xTimeIncrement parameter value will cause the task to execute with + * a fixed interface period. + * + * Example usage: + 
+ // Perform an action every 10 ticks.
+ void vTaskFunction( void * pvParameters )
+ {
+ TickType_t xLastWakeTime;
+ const TickType_t xFrequency = 10;
+
+	 // Initialise the xLastWakeTime variable with the current time.
+	 xLastWakeTime = xTaskGetTickCount ();
+	 for( ;; )
+	 {
+		 // Wait for the next cycle.
+		 vTaskDelayUntil( &xLastWakeTime, xFrequency );
+
+		 // Perform action here.
+	 }
+ }
+
+ * \defgroup vTaskDelayUntil vTaskDelayUntil + * \ingroup TaskCtrl + */ +void vTaskDelayUntil( TickType_t * const pxPreviousWakeTime, const TickType_t xTimeIncrement ) PRIVILEGED_FUNCTION; + +/** + * task. h + * 
BaseType_t xTaskAbortDelay( TaskHandle_t xTask );
+ * + * INCLUDE_xTaskAbortDelay must be defined as 1 in FreeRTOSConfig.h for this + * function to be available. + * + * A task will enter the Blocked state when it is waiting for an event. The + * event it is waiting for can be a temporal event (waiting for a time), such + * as when vTaskDelay() is called, or an event on an object, such as when + * xQueueReceive() or ulTaskNotifyTake() is called. If the handle of a task + * that is in the Blocked state is used in a call to xTaskAbortDelay() then the + * task will leave the Blocked state, and return from whichever function call + * placed the task into the Blocked state. + * + * @param xTask The handle of the task to remove from the Blocked state. + * + * @return If the task referenced by xTask was not in the Blocked state then + * pdFAIL is returned. Otherwise pdPASS is returned. + * + * \defgroup xTaskAbortDelay xTaskAbortDelay + * \ingroup TaskCtrl + */ +BaseType_t xTaskAbortDelay( TaskHandle_t xTask ) PRIVILEGED_FUNCTION; + +/** + * task. h + * 
UBaseType_t uxTaskPriorityGet( TaskHandle_t xTask );
+ * + * INCLUDE_uxTaskPriorityGet must be defined as 1 for this function to be available. + * See the configuration section for more information. + * + * Obtain the priority of any task. + * + * @param xTask Handle of the task to be queried. Passing a NULL + * handle results in the priority of the calling task being returned. + * + * @return The priority of xTask. + * + * Example usage: + 
+ void vAFunction( void )
+ {
+ TaskHandle_t xHandle;
+
+	 // Create a task, storing the handle.
+	 xTaskCreate( vTaskCode, "NAME", STACK_SIZE, NULL, tskIDLE_PRIORITY, &xHandle );
+
+	 // ...
+
+	 // Use the handle to obtain the priority of the created task.
+	 // It was created with tskIDLE_PRIORITY, but may have changed
+	 // it itself.
+	 if( uxTaskPriorityGet( xHandle ) != tskIDLE_PRIORITY )
+	 {
+		 // The task has changed it's priority.
+	 }
+
+	 // ...
+
+	 // Is our priority higher than the created task?
+	 if( uxTaskPriorityGet( xHandle ) < uxTaskPriorityGet( NULL ) )
+	 {
+		 // Our priority (obtained using NULL handle) is higher.
+	 }
+ }
+
+ * \defgroup uxTaskPriorityGet uxTaskPriorityGet + * \ingroup TaskCtrl + */ +UBaseType_t uxTaskPriorityGet( TaskHandle_t xTask ) PRIVILEGED_FUNCTION; + +/** + * task. h + * 
UBaseType_t uxTaskPriorityGetFromISR( TaskHandle_t xTask );
+ * + * A version of uxTaskPriorityGet() that can be used from an ISR. + */ +UBaseType_t uxTaskPriorityGetFromISR( TaskHandle_t xTask ) PRIVILEGED_FUNCTION; + +/** + * task. h + * 
eTaskState eTaskGetState( TaskHandle_t xTask );
+ * + * INCLUDE_eTaskGetState must be defined as 1 for this function to be available. + * See the configuration section for more information. + * + * Obtain the state of any task. States are encoded by the eTaskState + * enumerated type. + * + * @param xTask Handle of the task to be queried. + * + * @return The state of xTask at the time the function was called. Note the + * state of the task might change between the function being called, and the + * functions return value being tested by the calling task. + */ +eTaskState eTaskGetState( TaskHandle_t xTask ) PRIVILEGED_FUNCTION; + +/** + * task. h + * 
void vTaskGetInfo( TaskHandle_t xTask, TaskStatus_t *pxTaskStatus, BaseType_t xGetFreeStackSpace, eTaskState eState );
+ * + * configUSE_TRACE_FACILITY must be defined as 1 for this function to be + * available. See the configuration section for more information. + * + * Populates a TaskStatus_t structure with information about a task. + * + * @param xTask Handle of the task being queried. If xTask is NULL then + * information will be returned about the calling task. + * + * @param pxTaskStatus A pointer to the TaskStatus_t structure that will be + * filled with information about the task referenced by the handle passed using + * the xTask parameter. + * + * @xGetFreeStackSpace The TaskStatus_t structure contains a member to report + * the stack high water mark of the task being queried. Calculating the stack + * high water mark takes a relatively long time, and can make the system + * temporarily unresponsive - so the xGetFreeStackSpace parameter is provided to + * allow the high water mark checking to be skipped. The high watermark value + * will only be written to the TaskStatus_t structure if xGetFreeStackSpace is + * not set to pdFALSE; + * + * @param eState The TaskStatus_t structure contains a member to report the + * state of the task being queried. Obtaining the task state is not as fast as + * a simple assignment - so the eState parameter is provided to allow the state + * information to be omitted from the TaskStatus_t structure. To obtain state + * information then set eState to eInvalid - otherwise the value passed in + * eState will be reported as the task state in the TaskStatus_t structure. + * + * Example usage: + 
+ void vAFunction( void )
+ {
+ TaskHandle_t xHandle;
+ TaskStatus_t xTaskDetails;
+
+    // Obtain the handle of a task from its name.
+    xHandle = xTaskGetHandle( "Task_Name" );
+
+    // Check the handle is not NULL.
+    configASSERT( xHandle );
+
+    // Use the handle to obtain further information about the task.
+    vTaskGetInfo( xHandle,
+                  &xTaskDetails,
+                  pdTRUE, // Include the high water mark in xTaskDetails.
+                  eInvalid ); // Include the task state in xTaskDetails.
+ }
+
+ * \defgroup vTaskGetInfo vTaskGetInfo + * \ingroup TaskCtrl + */ +void vTaskGetInfo( TaskHandle_t xTask, TaskStatus_t *pxTaskStatus, BaseType_t xGetFreeStackSpace, eTaskState eState ) PRIVILEGED_FUNCTION; + +/** + * task. h + * 
void vTaskPrioritySet( TaskHandle_t xTask, UBaseType_t uxNewPriority );
+ * + * INCLUDE_vTaskPrioritySet must be defined as 1 for this function to be available. + * See the configuration section for more information. + * + * Set the priority of any task. + * + * A context switch will occur before the function returns if the priority + * being set is higher than the currently executing task. + * + * @param xTask Handle to the task for which the priority is being set. + * Passing a NULL handle results in the priority of the calling task being set. + * + * @param uxNewPriority The priority to which the task will be set. + * + * Example usage: + 
+ void vAFunction( void )
+ {
+ TaskHandle_t xHandle;
+
+	 // Create a task, storing the handle.
+	 xTaskCreate( vTaskCode, "NAME", STACK_SIZE, NULL, tskIDLE_PRIORITY, &xHandle );
+
+	 // ...
+
+	 // Use the handle to raise the priority of the created task.
+	 vTaskPrioritySet( xHandle, tskIDLE_PRIORITY + 1 );
+
+	 // ...
+
+	 // Use a NULL handle to raise our priority to the same value.
+	 vTaskPrioritySet( NULL, tskIDLE_PRIORITY + 1 );
+ }
+
+ * \defgroup vTaskPrioritySet vTaskPrioritySet + * \ingroup TaskCtrl + */ +void vTaskPrioritySet( TaskHandle_t xTask, UBaseType_t uxNewPriority ) PRIVILEGED_FUNCTION; + +/** + * task. h + * 
void vTaskSuspend( TaskHandle_t xTaskToSuspend );
+ * + * INCLUDE_vTaskSuspend must be defined as 1 for this function to be available. + * See the configuration section for more information. + * + * Suspend any task. When suspended a task will never get any microcontroller + * processing time, no matter what its priority. + * + * Calls to vTaskSuspend are not accumulative - + * i.e. calling vTaskSuspend () twice on the same task still only requires one + * call to vTaskResume () to ready the suspended task. + * + * @param xTaskToSuspend Handle to the task being suspended. Passing a NULL + * handle will cause the calling task to be suspended. + * + * Example usage: + 
+ void vAFunction( void )
+ {
+ TaskHandle_t xHandle;
+
+	 // Create a task, storing the handle.
+	 xTaskCreate( vTaskCode, "NAME", STACK_SIZE, NULL, tskIDLE_PRIORITY, &xHandle );
+
+	 // ...
+
+	 // Use the handle to suspend the created task.
+	 vTaskSuspend( xHandle );
+
+	 // ...
+
+	 // The created task will not run during this period, unless
+	 // another task calls vTaskResume( xHandle ).
+
+	 //...
+
+
+	 // Suspend ourselves.
+	 vTaskSuspend( NULL );
+
+	 // We cannot get here unless another task calls vTaskResume
+	 // with our handle as the parameter.
+ }
+
+ * \defgroup vTaskSuspend vTaskSuspend + * \ingroup TaskCtrl + */ +void vTaskSuspend( TaskHandle_t xTaskToSuspend ) PRIVILEGED_FUNCTION; + +/** + * task. h + * 
void vTaskResume( TaskHandle_t xTaskToResume );
+ * + * INCLUDE_vTaskSuspend must be defined as 1 for this function to be available. + * See the configuration section for more information. + * + * Resumes a suspended task. + * + * A task that has been suspended by one or more calls to vTaskSuspend () + * will be made available for running again by a single call to + * vTaskResume (). + * + * @param xTaskToResume Handle to the task being readied. + * + * Example usage: + 
+ void vAFunction( void )
+ {
+ TaskHandle_t xHandle;
+
+	 // Create a task, storing the handle.
+	 xTaskCreate( vTaskCode, "NAME", STACK_SIZE, NULL, tskIDLE_PRIORITY, &xHandle );
+
+	 // ...
+
+	 // Use the handle to suspend the created task.
+	 vTaskSuspend( xHandle );
+
+	 // ...
+
+	 // The created task will not run during this period, unless
+	 // another task calls vTaskResume( xHandle ).
+
+	 //...
+
+
+	 // Resume the suspended task ourselves.
+	 vTaskResume( xHandle );
+
+	 // The created task will once again get microcontroller processing
+	 // time in accordance with its priority within the system.
+ }
+
+ * \defgroup vTaskResume vTaskResume + * \ingroup TaskCtrl + */ +void vTaskResume( TaskHandle_t xTaskToResume ) PRIVILEGED_FUNCTION; + +/** + * task. h + * 
void xTaskResumeFromISR( TaskHandle_t xTaskToResume );
+ * + * INCLUDE_xTaskResumeFromISR must be defined as 1 for this function to be + * available. See the configuration section for more information. + * + * An implementation of vTaskResume() that can be called from within an ISR. + * + * A task that has been suspended by one or more calls to vTaskSuspend () + * will be made available for running again by a single call to + * xTaskResumeFromISR (). + * + * xTaskResumeFromISR() should not be used to synchronise a task with an + * interrupt if there is a chance that the interrupt could arrive prior to the + * task being suspended - as this can lead to interrupts being missed. Use of a + * semaphore as a synchronisation mechanism would avoid this eventuality. + * + * @param xTaskToResume Handle to the task being readied. + * + * @return pdTRUE if resuming the task should result in a context switch, + * otherwise pdFALSE. This is used by the ISR to determine if a context switch + * may be required following the ISR. + * + * \defgroup vTaskResumeFromISR vTaskResumeFromISR + * \ingroup TaskCtrl + */ +BaseType_t xTaskResumeFromISR( TaskHandle_t xTaskToResume ) PRIVILEGED_FUNCTION; + +/*----------------------------------------------------------- + * SCHEDULER CONTROL + *----------------------------------------------------------*/ + +/** + * task. h + * 
void vTaskStartScheduler( void );
+ * + * Starts the real time kernel tick processing. After calling the kernel + * has control over which tasks are executed and when. + * + * See the demo application file main.c for an example of creating + * tasks and starting the kernel. + * + * Example usage: + 
+ void vAFunction( void )
+ {
+	 // Create at least one task before starting the kernel.
+	 xTaskCreate( vTaskCode, "NAME", STACK_SIZE, NULL, tskIDLE_PRIORITY, NULL );
+
+	 // Start the real time kernel with preemption.
+	 vTaskStartScheduler ();
+
+	 // Will not get here unless a task calls vTaskEndScheduler ()
+ }
+
+ * + * \defgroup vTaskStartScheduler vTaskStartScheduler + * \ingroup SchedulerControl + */ +void vTaskStartScheduler( void ) PRIVILEGED_FUNCTION; + +/** + * task. h + * 
void vTaskEndScheduler( void );
+ * + * NOTE: At the time of writing only the x86 real mode port, which runs on a PC + * in place of DOS, implements this function. + * + * Stops the real time kernel tick. All created tasks will be automatically + * deleted and multitasking (either preemptive or cooperative) will + * stop. Execution then resumes from the point where vTaskStartScheduler () + * was called, as if vTaskStartScheduler () had just returned. + * + * See the demo application file main. c in the demo/PC directory for an + * example that uses vTaskEndScheduler (). + * + * vTaskEndScheduler () requires an exit function to be defined within the + * portable layer (see vPortEndScheduler () in port. c for the PC port). This + * performs hardware specific operations such as stopping the kernel tick. + * + * vTaskEndScheduler () will cause all of the resources allocated by the + * kernel to be freed - but will not free resources allocated by application + * tasks. + * + * Example usage: + 
+ void vTaskCode( void * pvParameters )
+ {
+	 for( ;; )
+	 {
+		 // Task code goes here.
+
+		 // At some point we want to end the real time kernel processing
+		 // so call ...
+		 vTaskEndScheduler ();
+	 }
+ }
+
+ void vAFunction( void )
+ {
+	 // Create at least one task before starting the kernel.
+	 xTaskCreate( vTaskCode, "NAME", STACK_SIZE, NULL, tskIDLE_PRIORITY, NULL );
+
+	 // Start the real time kernel with preemption.
+	 vTaskStartScheduler ();
+
+	 // Will only get here when the vTaskCode () task has called
+	 // vTaskEndScheduler ().  When we get here we are back to single task
+	 // execution.
+ }
+
+ * + * \defgroup vTaskEndScheduler vTaskEndScheduler + * \ingroup SchedulerControl + */ +void vTaskEndScheduler( void ) PRIVILEGED_FUNCTION; + +/** + * task. h + * 
void vTaskSuspendAll( void );
+ * + * Suspends the scheduler without disabling interrupts. Context switches will + * not occur while the scheduler is suspended. + * + * After calling vTaskSuspendAll () the calling task will continue to execute + * without risk of being swapped out until a call to xTaskResumeAll () has been + * made. + * + * API functions that have the potential to cause a context switch (for example, + * vTaskDelayUntil(), xQueueSend(), etc.) must not be called while the scheduler + * is suspended. + * + * Example usage: + 
+ void vTask1( void * pvParameters )
+ {
+	 for( ;; )
+	 {
+		 // Task code goes here.
+
+		 // ...
+
+		 // At some point the task wants to perform a long operation during
+		 // which it does not want to get swapped out.  It cannot use
+		 // taskENTER_CRITICAL ()/taskEXIT_CRITICAL () as the length of the
+		 // operation may cause interrupts to be missed - including the
+		 // ticks.
+
+		 // Prevent the real time kernel swapping out the task.
+		 vTaskSuspendAll ();
+
+		 // Perform the operation here.  There is no need to use critical
+		 // sections as we have all the microcontroller processing time.
+		 // During this time interrupts will still operate and the kernel
+		 // tick count will be maintained.
+
+		 // ...
+
+		 // The operation is complete.  Restart the kernel.
+		 xTaskResumeAll ();
+	 }
+ }
+
+ * \defgroup vTaskSuspendAll vTaskSuspendAll + * \ingroup SchedulerControl + */ +void vTaskSuspendAll( void ) PRIVILEGED_FUNCTION; + +/** + * task. h + * 
BaseType_t xTaskResumeAll( void );
+ * + * Resumes scheduler activity after it was suspended by a call to + * vTaskSuspendAll(). + * + * xTaskResumeAll() only resumes the scheduler. It does not unsuspend tasks + * that were previously suspended by a call to vTaskSuspend(). + * + * @return If resuming the scheduler caused a context switch then pdTRUE is + * returned, otherwise pdFALSE is returned. + * + * Example usage: + 
+ void vTask1( void * pvParameters )
+ {
+	 for( ;; )
+	 {
+		 // Task code goes here.
+
+		 // ...
+
+		 // At some point the task wants to perform a long operation during
+		 // which it does not want to get swapped out.  It cannot use
+		 // taskENTER_CRITICAL ()/taskEXIT_CRITICAL () as the length of the
+		 // operation may cause interrupts to be missed - including the
+		 // ticks.
+
+		 // Prevent the real time kernel swapping out the task.
+		 vTaskSuspendAll ();
+
+		 // Perform the operation here.  There is no need to use critical
+		 // sections as we have all the microcontroller processing time.
+		 // During this time interrupts will still operate and the real
+		 // time kernel tick count will be maintained.
+
+		 // ...
+
+		 // The operation is complete.  Restart the kernel.  We want to force
+		 // a context switch - but there is no point if resuming the scheduler
+		 // caused a context switch already.
+		 if( !xTaskResumeAll () )
+		 {
+			  taskYIELD ();
+		 }
+	 }
+ }
+
+ * \defgroup xTaskResumeAll xTaskResumeAll + * \ingroup SchedulerControl + */ +BaseType_t xTaskResumeAll( void ) PRIVILEGED_FUNCTION; + +/*----------------------------------------------------------- + * TASK UTILITIES + *----------------------------------------------------------*/ + +/** + * task. h + * 
TickType_t xTaskGetTickCount( void );
+ * + * @return The count of ticks since vTaskStartScheduler was called. + * + * \defgroup xTaskGetTickCount xTaskGetTickCount + * \ingroup TaskUtils + */ +TickType_t xTaskGetTickCount( void ) PRIVILEGED_FUNCTION; + +/** + * task. h + * 
TickType_t xTaskGetTickCountFromISR( void );
+ * + * @return The count of ticks since vTaskStartScheduler was called. + * + * This is a version of xTaskGetTickCount() that is safe to be called from an + * ISR - provided that TickType_t is the natural word size of the + * microcontroller being used or interrupt nesting is either not supported or + * not being used. + * + * \defgroup xTaskGetTickCountFromISR xTaskGetTickCountFromISR + * \ingroup TaskUtils + */ +TickType_t xTaskGetTickCountFromISR( void ) PRIVILEGED_FUNCTION; + +/** + * task. h + * 
uint16_t uxTaskGetNumberOfTasks( void );
+ * + * @return The number of tasks that the real time kernel is currently managing. + * This includes all ready, blocked and suspended tasks. A task that + * has been deleted but not yet freed by the idle task will also be + * included in the count. + * + * \defgroup uxTaskGetNumberOfTasks uxTaskGetNumberOfTasks + * \ingroup TaskUtils + */ +UBaseType_t uxTaskGetNumberOfTasks( void ) PRIVILEGED_FUNCTION; + +/** + * task. h + * 
char *pcTaskGetName( TaskHandle_t xTaskToQuery );
+ * + * @return The text (human readable) name of the task referenced by the handle + * xTaskToQuery. A task can query its own name by either passing in its own + * handle, or by setting xTaskToQuery to NULL. + * + * \defgroup pcTaskGetName pcTaskGetName + * \ingroup TaskUtils + */ +char *pcTaskGetName( TaskHandle_t xTaskToQuery ) PRIVILEGED_FUNCTION; /*lint !e971 Unqualified char types are allowed for strings and single characters only. */ + +/** + * task. h + * 
TaskHandle_t xTaskGetHandle( const char *pcNameToQuery );
+ * + * NOTE: This function takes a relatively long time to complete and should be + * used sparingly. + * + * @return The handle of the task that has the human readable name pcNameToQuery. + * NULL is returned if no matching name is found. INCLUDE_xTaskGetHandle + * must be set to 1 in FreeRTOSConfig.h for pcTaskGetHandle() to be available. + * + * \defgroup pcTaskGetHandle pcTaskGetHandle + * \ingroup TaskUtils + */ +TaskHandle_t xTaskGetHandle( const char *pcNameToQuery ) PRIVILEGED_FUNCTION; /*lint !e971 Unqualified char types are allowed for strings and single characters only. */ + +/** + * task.h + * 
UBaseType_t uxTaskGetStackHighWaterMark( TaskHandle_t xTask );
+ * + * INCLUDE_uxTaskGetStackHighWaterMark must be set to 1 in FreeRTOSConfig.h for + * this function to be available. + * + * Returns the high water mark of the stack associated with xTask. That is, + * the minimum free stack space there has been (in words, so on a 32 bit machine + * a value of 1 means 4 bytes) since the task started. The smaller the returned + * number the closer the task has come to overflowing its stack. + * + * @param xTask Handle of the task associated with the stack to be checked. + * Set xTask to NULL to check the stack of the calling task. + * + * @return The smallest amount of free stack space there has been (in words, so + * actual spaces on the stack rather than bytes) since the task referenced by + * xTask was created. + */ +UBaseType_t uxTaskGetStackHighWaterMark( TaskHandle_t xTask ) PRIVILEGED_FUNCTION; + +/* When using trace macros it is sometimes necessary to include task.h before +FreeRTOS.h. When this is done TaskHookFunction_t will not yet have been defined, +so the following two prototypes will cause a compilation error. This can be +fixed by simply guarding against the inclusion of these two prototypes unless +they are explicitly required by the configUSE_APPLICATION_TASK_TAG configuration +constant. */ +#ifdef configUSE_APPLICATION_TASK_TAG + #if configUSE_APPLICATION_TASK_TAG == 1 + /** + * task.h + * 
void vTaskSetApplicationTaskTag( TaskHandle_t xTask, TaskHookFunction_t pxHookFunction );
+ * + * Sets pxHookFunction to be the task hook function used by the task xTask. + * Passing xTask as NULL has the effect of setting the calling tasks hook + * function. + */ + void vTaskSetApplicationTaskTag( TaskHandle_t xTask, TaskHookFunction_t pxHookFunction ) PRIVILEGED_FUNCTION; + + /** + * task.h + * 
void xTaskGetApplicationTaskTag( TaskHandle_t xTask );
+ * + * Returns the pxHookFunction value assigned to the task xTask. + */ + TaskHookFunction_t xTaskGetApplicationTaskTag( TaskHandle_t xTask ) PRIVILEGED_FUNCTION; + #endif /* configUSE_APPLICATION_TASK_TAG ==1 */ +#endif /* ifdef configUSE_APPLICATION_TASK_TAG */ + +#if( configNUM_THREAD_LOCAL_STORAGE_POINTERS > 0 ) + + /* Each task contains an array of pointers that is dimensioned by the + configNUM_THREAD_LOCAL_STORAGE_POINTERS setting in FreeRTOSConfig.h. The + kernel does not use the pointers itself, so the application writer can use + the pointers for any purpose they wish. The following two functions are + used to set and query a pointer respectively. */ + void vTaskSetThreadLocalStoragePointer( TaskHandle_t xTaskToSet, BaseType_t xIndex, void *pvValue ) PRIVILEGED_FUNCTION; + void *pvTaskGetThreadLocalStoragePointer( TaskHandle_t xTaskToQuery, BaseType_t xIndex ) PRIVILEGED_FUNCTION; + +#endif + +/** + * task.h + * 
BaseType_t xTaskCallApplicationTaskHook( TaskHandle_t xTask, void *pvParameter );
+ * + * Calls the hook function associated with xTask. Passing xTask as NULL has + * the effect of calling the Running tasks (the calling task) hook function. + * + * pvParameter is passed to the hook function for the task to interpret as it + * wants. The return value is the value returned by the task hook function + * registered by the user. + */ +BaseType_t xTaskCallApplicationTaskHook( TaskHandle_t xTask, void *pvParameter ) PRIVILEGED_FUNCTION; + +/** + * xTaskGetIdleTaskHandle() is only available if + * INCLUDE_xTaskGetIdleTaskHandle is set to 1 in FreeRTOSConfig.h. + * + * Simply returns the handle of the idle task. It is not valid to call + * xTaskGetIdleTaskHandle() before the scheduler has been started. + */ +TaskHandle_t xTaskGetIdleTaskHandle( void ) PRIVILEGED_FUNCTION; + +/** + * configUSE_TRACE_FACILITY must be defined as 1 in FreeRTOSConfig.h for + * uxTaskGetSystemState() to be available. + * + * uxTaskGetSystemState() populates an TaskStatus_t structure for each task in + * the system. TaskStatus_t structures contain, among other things, members + * for the task handle, task name, task priority, task state, and total amount + * of run time consumed by the task. See the TaskStatus_t structure + * definition in this file for the full member list. + * + * NOTE: This function is intended for debugging use only as its use results in + * the scheduler remaining suspended for an extended period. + * + * @param pxTaskStatusArray A pointer to an array of TaskStatus_t structures. + * The array must contain at least one TaskStatus_t structure for each task + * that is under the control of the RTOS. The number of tasks under the control + * of the RTOS can be determined using the uxTaskGetNumberOfTasks() API function. + * + * @param uxArraySize The size of the array pointed to by the pxTaskStatusArray + * parameter. The size is specified as the number of indexes in the array, or + * the number of TaskStatus_t structures contained in the array, not by the + * number of bytes in the array. + * + * @param pulTotalRunTime If configGENERATE_RUN_TIME_STATS is set to 1 in + * FreeRTOSConfig.h then *pulTotalRunTime is set by uxTaskGetSystemState() to the + * total run time (as defined by the run time stats clock, see + * http://www.freertos.org/rtos-run-time-stats.html) since the target booted. + * pulTotalRunTime can be set to NULL to omit the total run time information. + * + * @return The number of TaskStatus_t structures that were populated by + * uxTaskGetSystemState(). This should equal the number returned by the + * uxTaskGetNumberOfTasks() API function, but will be zero if the value passed + * in the uxArraySize parameter was too small. + * + * Example usage: + 
+    // This example demonstrates how a human readable table of run time stats
+	// information is generated from raw data provided by uxTaskGetSystemState().
+	// The human readable table is written to pcWriteBuffer
+	void vTaskGetRunTimeStats( char *pcWriteBuffer )
+	{
+	TaskStatus_t *pxTaskStatusArray;
+	volatile UBaseType_t uxArraySize, x;
+	uint32_t ulTotalRunTime, ulStatsAsPercentage;
+
+		// Make sure the write buffer does not contain a string.
+		*pcWriteBuffer = 0x00;
+
+		// Take a snapshot of the number of tasks in case it changes while this
+		// function is executing.
+		uxArraySize = uxTaskGetNumberOfTasks();
+
+		// Allocate a TaskStatus_t structure for each task.  An array could be
+		// allocated statically at compile time.
+		pxTaskStatusArray = pvPortMalloc( uxArraySize * sizeof( TaskStatus_t ) );
+
+		if( pxTaskStatusArray != NULL )
+		{
+			// Generate raw status information about each task.
+			uxArraySize = uxTaskGetSystemState( pxTaskStatusArray, uxArraySize, &ulTotalRunTime );
+
+			// For percentage calculations.
+			ulTotalRunTime /= 100UL;
+
+			// Avoid divide by zero errors.
+			if( ulTotalRunTime > 0 )
+			{
+				// For each populated position in the pxTaskStatusArray array,
+				// format the raw data as human readable ASCII data
+				for( x = 0; x < uxArraySize; x++ )
+				{
+					// What percentage of the total run time has the task used?
+					// This will always be rounded down to the nearest integer.
+					// ulTotalRunTimeDiv100 has already been divided by 100.
+					ulStatsAsPercentage = pxTaskStatusArray[ x ].ulRunTimeCounter / ulTotalRunTime;
+
+					if( ulStatsAsPercentage > 0UL )
+					{
+						sprintf( pcWriteBuffer, "%s\t\t%lu\t\t%lu%%\r\n", pxTaskStatusArray[ x ].pcTaskName, pxTaskStatusArray[ x ].ulRunTimeCounter, ulStatsAsPercentage );
+					}
+					else
+					{
+						// If the percentage is zero here then the task has
+						// consumed less than 1% of the total run time.
+						sprintf( pcWriteBuffer, "%s\t\t%lu\t\t<1%%\r\n", pxTaskStatusArray[ x ].pcTaskName, pxTaskStatusArray[ x ].ulRunTimeCounter );
+					}
+
+					pcWriteBuffer += strlen( ( char * ) pcWriteBuffer );
+				}
+			}
+
+			// The array is no longer needed, free the memory it consumes.
+			vPortFree( pxTaskStatusArray );
+		}
+	}
+
+ */ +UBaseType_t uxTaskGetSystemState( TaskStatus_t * const pxTaskStatusArray, const UBaseType_t uxArraySize, uint32_t * const pulTotalRunTime ) PRIVILEGED_FUNCTION; + +/** + * task. h + * 
void vTaskList( char *pcWriteBuffer );
+ * + * configUSE_TRACE_FACILITY and configUSE_STATS_FORMATTING_FUNCTIONS must + * both be defined as 1 for this function to be available. See the + * configuration section of the FreeRTOS.org website for more information. + * + * NOTE 1: This function will disable interrupts for its duration. It is + * not intended for normal application runtime use but as a debug aid. + * + * Lists all the current tasks, along with their current state and stack + * usage high water mark. + * + * Tasks are reported as blocked ('B'), ready ('R'), deleted ('D') or + * suspended ('S'). + * + * PLEASE NOTE: + * + * This function is provided for convenience only, and is used by many of the + * demo applications. Do not consider it to be part of the scheduler. + * + * vTaskList() calls uxTaskGetSystemState(), then formats part of the + * uxTaskGetSystemState() output into a human readable table that displays task + * names, states and stack usage. + * + * vTaskList() has a dependency on the sprintf() C library function that might + * bloat the code size, use a lot of stack, and provide different results on + * different platforms. An alternative, tiny, third party, and limited + * functionality implementation of sprintf() is provided in many of the + * FreeRTOS/Demo sub-directories in a file called printf-stdarg.c (note + * printf-stdarg.c does not provide a full snprintf() implementation!). + * + * It is recommended that production systems call uxTaskGetSystemState() + * directly to get access to raw stats data, rather than indirectly through a + * call to vTaskList(). + * + * @param pcWriteBuffer A buffer into which the above mentioned details + * will be written, in ASCII form. This buffer is assumed to be large + * enough to contain the generated report. Approximately 40 bytes per + * task should be sufficient. + * + * \defgroup vTaskList vTaskList + * \ingroup TaskUtils + */ +void vTaskList( char * pcWriteBuffer ) PRIVILEGED_FUNCTION; /*lint !e971 Unqualified char types are allowed for strings and single characters only. */ + +/** + * task. h + * 
void vTaskGetRunTimeStats( char *pcWriteBuffer );
+ * + * configGENERATE_RUN_TIME_STATS and configUSE_STATS_FORMATTING_FUNCTIONS + * must both be defined as 1 for this function to be available. The application + * must also then provide definitions for + * portCONFIGURE_TIMER_FOR_RUN_TIME_STATS() and portGET_RUN_TIME_COUNTER_VALUE() + * to configure a peripheral timer/counter and return the timers current count + * value respectively. The counter should be at least 10 times the frequency of + * the tick count. + * + * NOTE 1: This function will disable interrupts for its duration. It is + * not intended for normal application runtime use but as a debug aid. + * + * Setting configGENERATE_RUN_TIME_STATS to 1 will result in a total + * accumulated execution time being stored for each task. The resolution + * of the accumulated time value depends on the frequency of the timer + * configured by the portCONFIGURE_TIMER_FOR_RUN_TIME_STATS() macro. + * Calling vTaskGetRunTimeStats() writes the total execution time of each + * task into a buffer, both as an absolute count value and as a percentage + * of the total system execution time. + * + * NOTE 2: + * + * This function is provided for convenience only, and is used by many of the + * demo applications. Do not consider it to be part of the scheduler. + * + * vTaskGetRunTimeStats() calls uxTaskGetSystemState(), then formats part of the + * uxTaskGetSystemState() output into a human readable table that displays the + * amount of time each task has spent in the Running state in both absolute and + * percentage terms. + * + * vTaskGetRunTimeStats() has a dependency on the sprintf() C library function + * that might bloat the code size, use a lot of stack, and provide different + * results on different platforms. An alternative, tiny, third party, and + * limited functionality implementation of sprintf() is provided in many of the + * FreeRTOS/Demo sub-directories in a file called printf-stdarg.c (note + * printf-stdarg.c does not provide a full snprintf() implementation!). + * + * It is recommended that production systems call uxTaskGetSystemState() directly + * to get access to raw stats data, rather than indirectly through a call to + * vTaskGetRunTimeStats(). + * + * @param pcWriteBuffer A buffer into which the execution times will be + * written, in ASCII form. This buffer is assumed to be large enough to + * contain the generated report. Approximately 40 bytes per task should + * be sufficient. + * + * \defgroup vTaskGetRunTimeStats vTaskGetRunTimeStats + * \ingroup TaskUtils + */ +void vTaskGetRunTimeStats( char *pcWriteBuffer ) PRIVILEGED_FUNCTION; /*lint !e971 Unqualified char types are allowed for strings and single characters only. */ + +/** + * task. h + * 
BaseType_t xTaskNotify( TaskHandle_t xTaskToNotify, uint32_t ulValue, eNotifyAction eAction );
+ * + * configUSE_TASK_NOTIFICATIONS must be undefined or defined as 1 for this + * function to be available. + * + * When configUSE_TASK_NOTIFICATIONS is set to one each task has its own private + * "notification value", which is a 32-bit unsigned integer (uint32_t). + * + * Events can be sent to a task using an intermediary object. Examples of such + * objects are queues, semaphores, mutexes and event groups. Task notifications + * are a method of sending an event directly to a task without the need for such + * an intermediary object. + * + * A notification sent to a task can optionally perform an action, such as + * update, overwrite or increment the task's notification value. In that way + * task notifications can be used to send data to a task, or be used as light + * weight and fast binary or counting semaphores. + * + * A notification sent to a task will remain pending until it is cleared by the + * task calling xTaskNotifyWait() or ulTaskNotifyTake(). If the task was + * already in the Blocked state to wait for a notification when the notification + * arrives then the task will automatically be removed from the Blocked state + * (unblocked) and the notification cleared. + * + * A task can use xTaskNotifyWait() to [optionally] block to wait for a + * notification to be pending, or ulTaskNotifyTake() to [optionally] block + * to wait for its notification value to have a non-zero value. The task does + * not consume any CPU time while it is in the Blocked state. + * + * See http://www.FreeRTOS.org/RTOS-task-notifications.html for details. + * + * @param xTaskToNotify The handle of the task being notified. The handle to a + * task can be returned from the xTaskCreate() API function used to create the + * task, and the handle of the currently running task can be obtained by calling + * xTaskGetCurrentTaskHandle(). + * + * @param ulValue Data that can be sent with the notification. How the data is + * used depends on the value of the eAction parameter. + * + * @param eAction Specifies how the notification updates the task's notification + * value, if at all. Valid values for eAction are as follows: + * + * eSetBits - + * The task's notification value is bitwise ORed with ulValue. xTaskNofify() + * always returns pdPASS in this case. + * + * eIncrement - + * The task's notification value is incremented. ulValue is not used and + * xTaskNotify() always returns pdPASS in this case. + * + * eSetValueWithOverwrite - + * The task's notification value is set to the value of ulValue, even if the + * task being notified had not yet processed the previous notification (the + * task already had a notification pending). xTaskNotify() always returns + * pdPASS in this case. + * + * eSetValueWithoutOverwrite - + * If the task being notified did not already have a notification pending then + * the task's notification value is set to ulValue and xTaskNotify() will + * return pdPASS. If the task being notified already had a notification + * pending then no action is performed and pdFAIL is returned. + * + * eNoAction - + * The task receives a notification without its notification value being + * updated. ulValue is not used and xTaskNotify() always returns pdPASS in + * this case. + * + * pulPreviousNotificationValue - + * Can be used to pass out the subject task's notification value before any + * bits are modified by the notify function. + * + * @return Dependent on the value of eAction. See the description of the + * eAction parameter. + * + * \defgroup xTaskNotify xTaskNotify + * \ingroup TaskNotifications + */ +BaseType_t xTaskGenericNotify( TaskHandle_t xTaskToNotify, uint32_t ulValue, eNotifyAction eAction, uint32_t *pulPreviousNotificationValue ) PRIVILEGED_FUNCTION; +#define xTaskNotify( xTaskToNotify, ulValue, eAction ) xTaskGenericNotify( ( xTaskToNotify ), ( ulValue ), ( eAction ), NULL ) +#define xTaskNotifyAndQuery( xTaskToNotify, ulValue, eAction, pulPreviousNotifyValue ) xTaskGenericNotify( ( xTaskToNotify ), ( ulValue ), ( eAction ), ( pulPreviousNotifyValue ) ) + +/** + * task. h + * 
BaseType_t xTaskNotifyFromISR( TaskHandle_t xTaskToNotify, uint32_t ulValue, eNotifyAction eAction, BaseType_t *pxHigherPriorityTaskWoken );
+ * + * configUSE_TASK_NOTIFICATIONS must be undefined or defined as 1 for this + * function to be available. + * + * When configUSE_TASK_NOTIFICATIONS is set to one each task has its own private + * "notification value", which is a 32-bit unsigned integer (uint32_t). + * + * A version of xTaskNotify() that can be used from an interrupt service routine + * (ISR). + * + * Events can be sent to a task using an intermediary object. Examples of such + * objects are queues, semaphores, mutexes and event groups. Task notifications + * are a method of sending an event directly to a task without the need for such + * an intermediary object. + * + * A notification sent to a task can optionally perform an action, such as + * update, overwrite or increment the task's notification value. In that way + * task notifications can be used to send data to a task, or be used as light + * weight and fast binary or counting semaphores. + * + * A notification sent to a task will remain pending until it is cleared by the + * task calling xTaskNotifyWait() or ulTaskNotifyTake(). If the task was + * already in the Blocked state to wait for a notification when the notification + * arrives then the task will automatically be removed from the Blocked state + * (unblocked) and the notification cleared. + * + * A task can use xTaskNotifyWait() to [optionally] block to wait for a + * notification to be pending, or ulTaskNotifyTake() to [optionally] block + * to wait for its notification value to have a non-zero value. The task does + * not consume any CPU time while it is in the Blocked state. + * + * See http://www.FreeRTOS.org/RTOS-task-notifications.html for details. + * + * @param xTaskToNotify The handle of the task being notified. The handle to a + * task can be returned from the xTaskCreate() API function used to create the + * task, and the handle of the currently running task can be obtained by calling + * xTaskGetCurrentTaskHandle(). + * + * @param ulValue Data that can be sent with the notification. How the data is + * used depends on the value of the eAction parameter. + * + * @param eAction Specifies how the notification updates the task's notification + * value, if at all. Valid values for eAction are as follows: + * + * eSetBits - + * The task's notification value is bitwise ORed with ulValue. xTaskNofify() + * always returns pdPASS in this case. + * + * eIncrement - + * The task's notification value is incremented. ulValue is not used and + * xTaskNotify() always returns pdPASS in this case. + * + * eSetValueWithOverwrite - + * The task's notification value is set to the value of ulValue, even if the + * task being notified had not yet processed the previous notification (the + * task already had a notification pending). xTaskNotify() always returns + * pdPASS in this case. + * + * eSetValueWithoutOverwrite - + * If the task being notified did not already have a notification pending then + * the task's notification value is set to ulValue and xTaskNotify() will + * return pdPASS. If the task being notified already had a notification + * pending then no action is performed and pdFAIL is returned. + * + * eNoAction - + * The task receives a notification without its notification value being + * updated. ulValue is not used and xTaskNotify() always returns pdPASS in + * this case. + * + * @param pxHigherPriorityTaskWoken xTaskNotifyFromISR() will set + * *pxHigherPriorityTaskWoken to pdTRUE if sending the notification caused the + * task to which the notification was sent to leave the Blocked state, and the + * unblocked task has a priority higher than the currently running task. If + * xTaskNotifyFromISR() sets this value to pdTRUE then a context switch should + * be requested before the interrupt is exited. How a context switch is + * requested from an ISR is dependent on the port - see the documentation page + * for the port in use. + * + * @return Dependent on the value of eAction. See the description of the + * eAction parameter. + * + * \defgroup xTaskNotify xTaskNotify + * \ingroup TaskNotifications + */ +BaseType_t xTaskGenericNotifyFromISR( TaskHandle_t xTaskToNotify, uint32_t ulValue, eNotifyAction eAction, uint32_t *pulPreviousNotificationValue, BaseType_t *pxHigherPriorityTaskWoken ) PRIVILEGED_FUNCTION; +#define xTaskNotifyFromISR( xTaskToNotify, ulValue, eAction, pxHigherPriorityTaskWoken ) xTaskGenericNotifyFromISR( ( xTaskToNotify ), ( ulValue ), ( eAction ), NULL, ( pxHigherPriorityTaskWoken ) ) +#define xTaskNotifyAndQueryFromISR( xTaskToNotify, ulValue, eAction, pulPreviousNotificationValue, pxHigherPriorityTaskWoken ) xTaskGenericNotifyFromISR( ( xTaskToNotify ), ( ulValue ), ( eAction ), ( pulPreviousNotificationValue ), ( pxHigherPriorityTaskWoken ) ) + +/** + * task. h + * 
BaseType_t xTaskNotifyWait( uint32_t ulBitsToClearOnEntry, uint32_t ulBitsToClearOnExit, uint32_t *pulNotificationValue, TickType_t xTicksToWait );
+ * + * configUSE_TASK_NOTIFICATIONS must be undefined or defined as 1 for this + * function to be available. + * + * When configUSE_TASK_NOTIFICATIONS is set to one each task has its own private + * "notification value", which is a 32-bit unsigned integer (uint32_t). + * + * Events can be sent to a task using an intermediary object. Examples of such + * objects are queues, semaphores, mutexes and event groups. Task notifications + * are a method of sending an event directly to a task without the need for such + * an intermediary object. + * + * A notification sent to a task can optionally perform an action, such as + * update, overwrite or increment the task's notification value. In that way + * task notifications can be used to send data to a task, or be used as light + * weight and fast binary or counting semaphores. + * + * A notification sent to a task will remain pending until it is cleared by the + * task calling xTaskNotifyWait() or ulTaskNotifyTake(). If the task was + * already in the Blocked state to wait for a notification when the notification + * arrives then the task will automatically be removed from the Blocked state + * (unblocked) and the notification cleared. + * + * A task can use xTaskNotifyWait() to [optionally] block to wait for a + * notification to be pending, or ulTaskNotifyTake() to [optionally] block + * to wait for its notification value to have a non-zero value. The task does + * not consume any CPU time while it is in the Blocked state. + * + * See http://www.FreeRTOS.org/RTOS-task-notifications.html for details. + * + * @param ulBitsToClearOnEntry Bits that are set in ulBitsToClearOnEntry value + * will be cleared in the calling task's notification value before the task + * checks to see if any notifications are pending, and optionally blocks if no + * notifications are pending. Setting ulBitsToClearOnEntry to ULONG_MAX (if + * limits.h is included) or 0xffffffffUL (if limits.h is not included) will have + * the effect of resetting the task's notification value to 0. Setting + * ulBitsToClearOnEntry to 0 will leave the task's notification value unchanged. + * + * @param ulBitsToClearOnExit If a notification is pending or received before + * the calling task exits the xTaskNotifyWait() function then the task's + * notification value (see the xTaskNotify() API function) is passed out using + * the pulNotificationValue parameter. Then any bits that are set in + * ulBitsToClearOnExit will be cleared in the task's notification value (note + * *pulNotificationValue is set before any bits are cleared). Setting + * ulBitsToClearOnExit to ULONG_MAX (if limits.h is included) or 0xffffffffUL + * (if limits.h is not included) will have the effect of resetting the task's + * notification value to 0 before the function exits. Setting + * ulBitsToClearOnExit to 0 will leave the task's notification value unchanged + * when the function exits (in which case the value passed out in + * pulNotificationValue will match the task's notification value). + * + * @param pulNotificationValue Used to pass the task's notification value out + * of the function. Note the value passed out will not be effected by the + * clearing of any bits caused by ulBitsToClearOnExit being non-zero. + * + * @param xTicksToWait The maximum amount of time that the task should wait in + * the Blocked state for a notification to be received, should a notification + * not already be pending when xTaskNotifyWait() was called. The task + * will not consume any processing time while it is in the Blocked state. This + * is specified in kernel ticks, the macro pdMS_TO_TICSK( value_in_ms ) can be + * used to convert a time specified in milliseconds to a time specified in + * ticks. + * + * @return If a notification was received (including notifications that were + * already pending when xTaskNotifyWait was called) then pdPASS is + * returned. Otherwise pdFAIL is returned. + * + * \defgroup xTaskNotifyWait xTaskNotifyWait + * \ingroup TaskNotifications + */ +BaseType_t xTaskNotifyWait( uint32_t ulBitsToClearOnEntry, uint32_t ulBitsToClearOnExit, uint32_t *pulNotificationValue, TickType_t xTicksToWait ) PRIVILEGED_FUNCTION; + +/** + * task. h + * 
BaseType_t xTaskNotifyGive( TaskHandle_t xTaskToNotify );
+ * + * configUSE_TASK_NOTIFICATIONS must be undefined or defined as 1 for this macro + * to be available. + * + * When configUSE_TASK_NOTIFICATIONS is set to one each task has its own private + * "notification value", which is a 32-bit unsigned integer (uint32_t). + * + * Events can be sent to a task using an intermediary object. Examples of such + * objects are queues, semaphores, mutexes and event groups. Task notifications + * are a method of sending an event directly to a task without the need for such + * an intermediary object. + * + * A notification sent to a task can optionally perform an action, such as + * update, overwrite or increment the task's notification value. In that way + * task notifications can be used to send data to a task, or be used as light + * weight and fast binary or counting semaphores. + * + * xTaskNotifyGive() is a helper macro intended for use when task notifications + * are used as light weight and faster binary or counting semaphore equivalents. + * Actual FreeRTOS semaphores are given using the xSemaphoreGive() API function, + * the equivalent action that instead uses a task notification is + * xTaskNotifyGive(). + * + * When task notifications are being used as a binary or counting semaphore + * equivalent then the task being notified should wait for the notification + * using the ulTaskNotificationTake() API function rather than the + * xTaskNotifyWait() API function. + * + * See http://www.FreeRTOS.org/RTOS-task-notifications.html for more details. + * + * @param xTaskToNotify The handle of the task being notified. The handle to a + * task can be returned from the xTaskCreate() API function used to create the + * task, and the handle of the currently running task can be obtained by calling + * xTaskGetCurrentTaskHandle(). + * + * @return xTaskNotifyGive() is a macro that calls xTaskNotify() with the + * eAction parameter set to eIncrement - so pdPASS is always returned. + * + * \defgroup xTaskNotifyGive xTaskNotifyGive + * \ingroup TaskNotifications + */ +#define xTaskNotifyGive( xTaskToNotify ) xTaskGenericNotify( ( xTaskToNotify ), ( 0 ), eIncrement, NULL ) + +/** + * task. h + * 
void vTaskNotifyGiveFromISR( TaskHandle_t xTaskHandle, BaseType_t *pxHigherPriorityTaskWoken );
+ *
+ * configUSE_TASK_NOTIFICATIONS must be undefined or defined as 1 for this macro
+ * to be available.
+ *
+ * When configUSE_TASK_NOTIFICATIONS is set to one each task has its own private
+ * "notification value", which is a 32-bit unsigned integer (uint32_t).
+ *
+ * A version of xTaskNotifyGive() that can be called from an interrupt service
+ * routine (ISR).
+ *
+ * Events can be sent to a task using an intermediary object.  Examples of such
+ * objects are queues, semaphores, mutexes and event groups.  Task notifications
+ * are a method of sending an event directly to a task without the need for such
+ * an intermediary object.
+ *
+ * A notification sent to a task can optionally perform an action, such as
+ * update, overwrite or increment the task's notification value.  In that way
+ * task notifications can be used to send data to a task, or be used as light
+ * weight and fast binary or counting semaphores.
+ *
+ * vTaskNotifyGiveFromISR() is intended for use when task notifications are
+ * used as light weight and faster binary or counting semaphore equivalents.
+ * Actual FreeRTOS semaphores are given from an ISR using the
+ * xSemaphoreGiveFromISR() API function, the equivalent action that instead uses
+ * a task notification is vTaskNotifyGiveFromISR().
+ *
+ * When task notifications are being used as a binary or counting semaphore
+ * equivalent then the task being notified should wait for the notification
+ * using the ulTaskNotificationTake() API function rather than the
+ * xTaskNotifyWait() API function.
+ *
+ * See http://www.FreeRTOS.org/RTOS-task-notifications.html for more details.
+ *
+ * @param xTaskToNotify The handle of the task being notified.  The handle to a
+ * task can be returned from the xTaskCreate() API function used to create the
+ * task, and the handle of the currently running task can be obtained by calling
+ * xTaskGetCurrentTaskHandle().
+ *
+ * @param pxHigherPriorityTaskWoken  vTaskNotifyGiveFromISR() will set
+ * *pxHigherPriorityTaskWoken to pdTRUE if sending the notification caused the
+ * task to which the notification was sent to leave the Blocked state, and the
+ * unblocked task has a priority higher than the currently running task.  If
+ * vTaskNotifyGiveFromISR() sets this value to pdTRUE then a context switch
+ * should be requested before the interrupt is exited.  How a context switch is
+ * requested from an ISR is dependent on the port - see the documentation page
+ * for the port in use.
+ *
+ * \defgroup xTaskNotifyWait xTaskNotifyWait
+ * \ingroup TaskNotifications
+ */
+void vTaskNotifyGiveFromISR( TaskHandle_t xTaskToNotify, BaseType_t *pxHigherPriorityTaskWoken ) PRIVILEGED_FUNCTION;
+
+/**
+ * task. h
+ * 
uint32_t ulTaskNotifyTake( BaseType_t xClearCountOnExit, TickType_t xTicksToWait );

+ *
+ * configUSE_TASK_NOTIFICATIONS must be undefined or defined as 1 for this
+ * function to be available.
+ *
+ * When configUSE_TASK_NOTIFICATIONS is set to one each task has its own private
+ * "notification value", which is a 32-bit unsigned integer (uint32_t).
+ *
+ * Events can be sent to a task using an intermediary object.  Examples of such
+ * objects are queues, semaphores, mutexes and event groups.  Task notifications
+ * are a method of sending an event directly to a task without the need for such
+ * an intermediary object.
+ *
+ * A notification sent to a task can optionally perform an action, such as
+ * update, overwrite or increment the task's notification value.  In that way
+ * task notifications can be used to send data to a task, or be used as light
+ * weight and fast binary or counting semaphores.
+ *
+ * ulTaskNotifyTake() is intended for use when a task notification is used as a
+ * faster and lighter weight binary or counting semaphore alternative.  Actual
+ * FreeRTOS semaphores are taken using the xSemaphoreTake() API function, the
+ * equivalent action that instead uses a task notification is
+ * ulTaskNotifyTake().
+ *
+ * When a task is using its notification value as a binary or counting semaphore
+ * other tasks should send notifications to it using the xTaskNotifyGive()
+ * macro, or xTaskNotify() function with the eAction parameter set to
+ * eIncrement.
+ *
+ * ulTaskNotifyTake() can either clear the task's notification value to
+ * zero on exit, in which case the notification value acts like a binary
+ * semaphore, or decrement the task's notification value on exit, in which case
+ * the notification value acts like a counting semaphore.
+ *
+ * A task can use ulTaskNotifyTake() to [optionally] block to wait for a
+ * the task's notification value to be non-zero.  The task does not consume any
+ * CPU time while it is in the Blocked state.
+ *
+ * Where as xTaskNotifyWait() will return when a notification is pending,
+ * ulTaskNotifyTake() will return when the task's notification value is
+ * not zero.
+ *
+ * See http://www.FreeRTOS.org/RTOS-task-notifications.html for details.
+ *
+ * @param xClearCountOnExit if xClearCountOnExit is pdFALSE then the task's
+ * notification value is decremented when the function exits.  In this way the
+ * notification value acts like a counting semaphore.  If xClearCountOnExit is
+ * not pdFALSE then the task's notification value is cleared to zero when the
+ * function exits.  In this way the notification value acts like a binary
+ * semaphore.
+ *
+ * @param xTicksToWait The maximum amount of time that the task should wait in
+ * the Blocked state for the task's notification value to be greater than zero,
+ * should the count not already be greater than zero when
+ * ulTaskNotifyTake() was called.  The task will not consume any processing
+ * time while it is in the Blocked state.  This is specified in kernel ticks,
+ * the macro pdMS_TO_TICSK( value_in_ms ) can be used to convert a time
+ * specified in milliseconds to a time specified in ticks.
+ *
+ * @return The task's notification count before it is either cleared to zero or
+ * decremented (see the xClearCountOnExit parameter).
+ *
+ * \defgroup ulTaskNotifyTake ulTaskNotifyTake
+ * \ingroup TaskNotifications
+ */
+uint32_t ulTaskNotifyTake( BaseType_t xClearCountOnExit, TickType_t xTicksToWait ) PRIVILEGED_FUNCTION;
+
+/**
+ * task. h
+ * 
BaseType_t xTaskNotifyStateClear( TaskHandle_t xTask );

+ *
+ * If the notification state of the task referenced by the handle xTask is
+ * eNotified, then set the task's notification state to eNotWaitingNotification.
+ * The task's notification value is not altered.  Set xTask to NULL to clear the
+ * notification state of the calling task.
+ *
+ * @return pdTRUE if the task's notification state was set to
+ * eNotWaitingNotification, otherwise pdFALSE.
+ * \defgroup xTaskNotifyStateClear xTaskNotifyStateClear
+ * \ingroup TaskNotifications
+ */
+BaseType_t xTaskNotifyStateClear( TaskHandle_t xTask );
+
+/*-----------------------------------------------------------
+ * SCHEDULER INTERNALS AVAILABLE FOR PORTING PURPOSES
+ *----------------------------------------------------------*/
+
+/*
+ * THIS FUNCTION MUST NOT BE USED FROM APPLICATION CODE.  IT IS ONLY
+ * INTENDED FOR USE WHEN IMPLEMENTING A PORT OF THE SCHEDULER AND IS
+ * AN INTERFACE WHICH IS FOR THE EXCLUSIVE USE OF THE SCHEDULER.
+ *
+ * Called from the real time kernel tick (either preemptive or cooperative),
+ * this increments the tick count and checks if any tasks that are blocked
+ * for a finite period required removing from a blocked list and placing on
+ * a ready list.  If a non-zero value is returned then a context switch is
+ * required because either:
+ *   + A task was removed from a blocked list because its timeout had expired,
+ *     or
+ *   + Time slicing is in use and there is a task of equal priority to the
+ *     currently running task.
+ */
+BaseType_t xTaskIncrementTick( void ) PRIVILEGED_FUNCTION;
+
+/*
+ * THIS FUNCTION MUST NOT BE USED FROM APPLICATION CODE.  IT IS AN
+ * INTERFACE WHICH IS FOR THE EXCLUSIVE USE OF THE SCHEDULER.
+ *
+ * THIS FUNCTION MUST BE CALLED WITH INTERRUPTS DISABLED.
+ *
+ * Removes the calling task from the ready list and places it both
+ * on the list of tasks waiting for a particular event, and the
+ * list of delayed tasks.  The task will be removed from both lists
+ * and replaced on the ready list should either the event occur (and
+ * there be no higher priority tasks waiting on the same event) or
+ * the delay period expires.
+ *
+ * The 'unordered' version replaces the event list item value with the
+ * xItemValue value, and inserts the list item at the end of the list.
+ *
+ * The 'ordered' version uses the existing event list item value (which is the
+ * owning tasks priority) to insert the list item into the event list is task
+ * priority order.
+ *
+ * @param pxEventList The list containing tasks that are blocked waiting
+ * for the event to occur.
+ *
+ * @param xItemValue The item value to use for the event list item when the
+ * event list is not ordered by task priority.
+ *
+ * @param xTicksToWait The maximum amount of time that the task should wait
+ * for the event to occur.  This is specified in kernel ticks,the constant
+ * portTICK_PERIOD_MS can be used to convert kernel ticks into a real time
+ * period.
+ */
+void vTaskPlaceOnEventList( List_t * const pxEventList, const TickType_t xTicksToWait ) PRIVILEGED_FUNCTION;
+void vTaskPlaceOnUnorderedEventList( List_t * pxEventList, const TickType_t xItemValue, const TickType_t xTicksToWait ) PRIVILEGED_FUNCTION;
+
+/*
+ * THIS FUNCTION MUST NOT BE USED FROM APPLICATION CODE.  IT IS AN
+ * INTERFACE WHICH IS FOR THE EXCLUSIVE USE OF THE SCHEDULER.
+ *
+ * THIS FUNCTION MUST BE CALLED WITH INTERRUPTS DISABLED.
+ *
+ * This function performs nearly the same function as vTaskPlaceOnEventList().
+ * The difference being that this function does not permit tasks to block
+ * indefinitely, whereas vTaskPlaceOnEventList() does.
+ *
+ */
+void vTaskPlaceOnEventListRestricted( List_t * const pxEventList, TickType_t xTicksToWait, const BaseType_t xWaitIndefinitely ) PRIVILEGED_FUNCTION;
+
+/*
+ * THIS FUNCTION MUST NOT BE USED FROM APPLICATION CODE.  IT IS AN
+ * INTERFACE WHICH IS FOR THE EXCLUSIVE USE OF THE SCHEDULER.
+ *
+ * THIS FUNCTION MUST BE CALLED WITH INTERRUPTS DISABLED.
+ *
+ * Removes a task from both the specified event list and the list of blocked
+ * tasks, and places it on a ready queue.
+ *
+ * xTaskRemoveFromEventList()/xTaskRemoveFromUnorderedEventList() will be called
+ * if either an event occurs to unblock a task, or the block timeout period
+ * expires.
+ *
+ * xTaskRemoveFromEventList() is used when the event list is in task priority
+ * order.  It removes the list item from the head of the event list as that will
+ * have the highest priority owning task of all the tasks on the event list.
+ * xTaskRemoveFromUnorderedEventList() is used when the event list is not
+ * ordered and the event list items hold something other than the owning tasks
+ * priority.  In this case the event list item value is updated to the value
+ * passed in the xItemValue parameter.
+ *
+ * @return pdTRUE if the task being removed has a higher priority than the task
+ * making the call, otherwise pdFALSE.
+ */
+BaseType_t xTaskRemoveFromEventList( const List_t * const pxEventList ) PRIVILEGED_FUNCTION;
+BaseType_t xTaskRemoveFromUnorderedEventList( ListItem_t * pxEventListItem, const TickType_t xItemValue ) PRIVILEGED_FUNCTION;
+
+/*
+ * THIS FUNCTION MUST NOT BE USED FROM APPLICATION CODE.  IT IS ONLY
+ * INTENDED FOR USE WHEN IMPLEMENTING A PORT OF THE SCHEDULER AND IS
+ * AN INTERFACE WHICH IS FOR THE EXCLUSIVE USE OF THE SCHEDULER.
+ *
+ * Sets the pointer to the current TCB to the TCB of the highest priority task
+ * that is ready to run.
+ */
+void vTaskSwitchContext( void ) PRIVILEGED_FUNCTION;
+
+/*
+ * THESE FUNCTIONS MUST NOT BE USED FROM APPLICATION CODE.  THEY ARE USED BY
+ * THE EVENT BITS MODULE.
+ */
+TickType_t uxTaskResetEventItemValue( void ) PRIVILEGED_FUNCTION;
+
+/*
+ * Return the handle of the calling task.
+ */
+TaskHandle_t xTaskGetCurrentTaskHandle( void ) PRIVILEGED_FUNCTION;
+
+/*
+ * Capture the current time status for future reference.
+ */
+void vTaskSetTimeOutState( TimeOut_t * const pxTimeOut ) PRIVILEGED_FUNCTION;
+
+/*
+ * Compare the time status now with that previously captured to see if the
+ * timeout has expired.
+ */
+BaseType_t xTaskCheckForTimeOut( TimeOut_t * const pxTimeOut, TickType_t * const pxTicksToWait ) PRIVILEGED_FUNCTION;
+
+/*
+ * Shortcut used by the queue implementation to prevent unnecessary call to
+ * taskYIELD();
+ */
+void vTaskMissedYield( void ) PRIVILEGED_FUNCTION;
+
+/*
+ * Returns the scheduler state as taskSCHEDULER_RUNNING,
+ * taskSCHEDULER_NOT_STARTED or taskSCHEDULER_SUSPENDED.
+ */
+BaseType_t xTaskGetSchedulerState( void ) PRIVILEGED_FUNCTION;
+
+/*
+ * Raises the priority of the mutex holder to that of the calling task should
+ * the mutex holder have a priority less than the calling task.
+ */
+void vTaskPriorityInherit( TaskHandle_t const pxMutexHolder ) PRIVILEGED_FUNCTION;
+
+/*
+ * Set the priority of a task back to its proper priority in the case that it
+ * inherited a higher priority while it was holding a semaphore.
+ */
+BaseType_t xTaskPriorityDisinherit( TaskHandle_t const pxMutexHolder ) PRIVILEGED_FUNCTION;
+
+/*
+ * Get the uxTCBNumber assigned to the task referenced by the xTask parameter.
+ */
+UBaseType_t uxTaskGetTaskNumber( TaskHandle_t xTask ) PRIVILEGED_FUNCTION;
+
+/*
+ * Set the uxTaskNumber of the task referenced by the xTask parameter to
+ * uxHandle.
+ */
+void vTaskSetTaskNumber( TaskHandle_t xTask, const UBaseType_t uxHandle ) PRIVILEGED_FUNCTION;
+
+/*
+ * Only available when configUSE_TICKLESS_IDLE is set to 1.
+ * If tickless mode is being used, or a low power mode is implemented, then
+ * the tick interrupt will not execute during idle periods.  When this is the
+ * case, the tick count value maintained by the scheduler needs to be kept up
+ * to date with the actual execution time by being skipped forward by a time
+ * equal to the idle period.
+ */
+void vTaskStepTick( const TickType_t xTicksToJump ) PRIVILEGED_FUNCTION;
+
+/*
+ * Only avilable when configUSE_TICKLESS_IDLE is set to 1.
+ * Provided for use within portSUPPRESS_TICKS_AND_SLEEP() to allow the port
+ * specific sleep function to determine if it is ok to proceed with the sleep,
+ * and if it is ok to proceed, if it is ok to sleep indefinitely.
+ *
+ * This function is necessary because portSUPPRESS_TICKS_AND_SLEEP() is only
+ * called with the scheduler suspended, not from within a critical section.  It
+ * is therefore possible for an interrupt to request a context switch between
+ * portSUPPRESS_TICKS_AND_SLEEP() and the low power mode actually being
+ * entered.  eTaskConfirmSleepModeStatus() should be called from a short
+ * critical section between the timer being stopped and the sleep mode being
+ * entered to ensure it is ok to proceed into the sleep mode.
+ */
+eSleepModeStatus eTaskConfirmSleepModeStatus( void ) PRIVILEGED_FUNCTION;
+
+/*
+ * For internal use only.  Increment the mutex held count when a mutex is
+ * taken and return the handle of the task that has taken the mutex.
+ */
+void *pvTaskIncrementMutexHeldCount( void ) PRIVILEGED_FUNCTION;
+
+#ifdef __cplusplus
+}
+#endif
+#endif /* INC_TASK_H */
+
+
+
diff --git a/FreeRTOS/include/timers.h b/FreeRTOS/include/timers.h
new file mode 100644
index 0000000..798c955
--- /dev/null
+++ b/FreeRTOS/include/timers.h
@@ -0,0 +1,1314 @@
+/*
+    FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd.
+    All rights reserved
+
+    VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION.
+
+    This file is part of the FreeRTOS distribution.
+
+    FreeRTOS is free software; you can redistribute it and/or modify it under
+    the terms of the GNU General Public License (version 2) as published by the
+    Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception.
+
+    ***************************************************************************
+    >>!   NOTE: The modification to the GPL is included to allow you to     !<<
+    >>!   distribute a combined work that includes FreeRTOS without being   !<<
+    >>!   obliged to provide the source code for proprietary components     !<<
+    >>!   outside of the FreeRTOS kernel.                                   !<<
+    ***************************************************************************
+
+    FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY
+    WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+    FOR A PARTICULAR PURPOSE.  Full license text is available on the following
+    link: http://www.freertos.org/a00114.html
+
+    ***************************************************************************
+     *                                                                       *
+     *    FreeRTOS provides completely free yet professionally developed,    *
+     *    robust, strictly quality controlled, supported, and cross          *
+     *    platform software that is more than just the market leader, it     *
+     *    is the industry's de facto standard.                               *
+     *                                                                       *
+     *    Help yourself get started quickly while simultaneously helping     *
+     *    to support the FreeRTOS project by purchasing a FreeRTOS           *
+     *    tutorial book, reference manual, or both:                          *
+     *    http://www.FreeRTOS.org/Documentation                              *
+     *                                                                       *
+    ***************************************************************************
+
+    http://www.FreeRTOS.org/FAQHelp.html - Having a problem?  Start by reading
+    the FAQ page "My application does not run, what could be wrong?".  Have you
+    defined configASSERT()?
+
+    http://www.FreeRTOS.org/support - In return for receiving this top quality
+    embedded software for free we request you assist our global community by
+    participating in the support forum.
+
+    http://www.FreeRTOS.org/training - Investing in training allows your team to
+    be as productive as possible as early as possible.  Now you can receive
+    FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers
+    Ltd, and the world's leading authority on the world's leading RTOS.
+
+    http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products,
+    including FreeRTOS+Trace - an indispensable productivity tool, a DOS
+    compatible FAT file system, and our tiny thread aware UDP/IP stack.
+
+    http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate.
+    Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS.
+
+    http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High
+    Integrity Systems ltd. to sell under the OpenRTOS brand.  Low cost OpenRTOS
+    licenses offer ticketed support, indemnification and commercial middleware.
+
+    http://www.SafeRTOS.com - High Integrity Systems also provide a safety
+    engineered and independently SIL3 certified version for use in safety and
+    mission critical applications that require provable dependability.
+
+    1 tab == 4 spaces!
+*/
+
+
+#ifndef TIMERS_H
+#define TIMERS_H
+
+#ifndef INC_FREERTOS_H
+	#error "include FreeRTOS.h must appear in source files before include timers.h"
+#endif
+
+/*lint -e537 This headers are only multiply included if the application code
+happens to also be including task.h. */
+#include "task.h"
+/*lint +e537 */
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/*-----------------------------------------------------------
+ * MACROS AND DEFINITIONS
+ *----------------------------------------------------------*/
+
+/* IDs for commands that can be sent/received on the timer queue.  These are to
+be used solely through the macros that make up the public software timer API,
+as defined below.  The commands that are sent from interrupts must use the
+highest numbers as tmrFIRST_FROM_ISR_COMMAND is used to determine if the task
+or interrupt version of the queue send function should be used. */
+#define tmrCOMMAND_EXECUTE_CALLBACK_FROM_ISR 	( ( BaseType_t ) -2 )
+#define tmrCOMMAND_EXECUTE_CALLBACK				( ( BaseType_t ) -1 )
+#define tmrCOMMAND_START_DONT_TRACE				( ( BaseType_t ) 0 )
+#define tmrCOMMAND_START					    ( ( BaseType_t ) 1 )
+#define tmrCOMMAND_RESET						( ( BaseType_t ) 2 )
+#define tmrCOMMAND_STOP							( ( BaseType_t ) 3 )
+#define tmrCOMMAND_CHANGE_PERIOD				( ( BaseType_t ) 4 )
+#define tmrCOMMAND_DELETE						( ( BaseType_t ) 5 )
+
+#define tmrFIRST_FROM_ISR_COMMAND				( ( BaseType_t ) 6 )
+#define tmrCOMMAND_START_FROM_ISR				( ( BaseType_t ) 6 )
+#define tmrCOMMAND_RESET_FROM_ISR				( ( BaseType_t ) 7 )
+#define tmrCOMMAND_STOP_FROM_ISR				( ( BaseType_t ) 8 )
+#define tmrCOMMAND_CHANGE_PERIOD_FROM_ISR		( ( BaseType_t ) 9 )
+
+
+/**
+ * Type by which software timers are referenced.  For example, a call to
+ * xTimerCreate() returns an TimerHandle_t variable that can then be used to
+ * reference the subject timer in calls to other software timer API functions
+ * (for example, xTimerStart(), xTimerReset(), etc.).
+ */
+typedef void * TimerHandle_t;
+
+/*
+ * Defines the prototype to which timer callback functions must conform.
+ */
+typedef void (*TimerCallbackFunction_t)( TimerHandle_t xTimer );
+
+/*
+ * Defines the prototype to which functions used with the
+ * xTimerPendFunctionCallFromISR() function must conform.
+ */
+typedef void (*PendedFunction_t)( void *, uint32_t );
+
+/**
+ * TimerHandle_t xTimerCreate( 	const char * const pcTimerName,
+ * 								TickType_t xTimerPeriodInTicks,
+ * 								UBaseType_t uxAutoReload,
+ * 								void * pvTimerID,
+ * 								TimerCallbackFunction_t pxCallbackFunction );
+ *
+ * Creates a new software timer instance, and returns a handle by which the
+ * created software timer can be referenced.
+ *
+ * Internally, within the FreeRTOS implementation, software timers use a block
+ * of memory, in which the timer data structure is stored.  If a software timer
+ * is created using xTimerCreate() then the required memory is automatically
+ * dynamically allocated inside the xTimerCreate() function.  (see
+ * http://www.freertos.org/a00111.html).  If a software timer is created using
+ * xTimerCreateStatic() then the application writer must provide the memory that
+ * will get used by the software timer.  xTimerCreateStatic() therefore allows a
+ * software timer to be created without using any dynamic memory allocation.
+ *
+ * Timers are created in the dormant state.  The xTimerStart(), xTimerReset(),
+ * xTimerStartFromISR(), xTimerResetFromISR(), xTimerChangePeriod() and
+ * xTimerChangePeriodFromISR() API functions can all be used to transition a
+ * timer into the active state.
+ *
+ * @param pcTimerName A text name that is assigned to the timer.  This is done
+ * purely to assist debugging.  The kernel itself only ever references a timer
+ * by its handle, and never by its name.
+ *
+ * @param xTimerPeriodInTicks The timer period.  The time is defined in tick
+ * periods so the constant portTICK_PERIOD_MS can be used to convert a time that
+ * has been specified in milliseconds.  For example, if the timer must expire
+ * after 100 ticks, then xTimerPeriodInTicks should be set to 100.
+ * Alternatively, if the timer must expire after 500ms, then xPeriod can be set
+ * to ( 500 / portTICK_PERIOD_MS ) provided configTICK_RATE_HZ is less than or
+ * equal to 1000.
+ *
+ * @param uxAutoReload If uxAutoReload is set to pdTRUE then the timer will
+ * expire repeatedly with a frequency set by the xTimerPeriodInTicks parameter.
+ * If uxAutoReload is set to pdFALSE then the timer will be a one-shot timer and
+ * enter the dormant state after it expires.
+ *
+ * @param pvTimerID An identifier that is assigned to the timer being created.
+ * Typically this would be used in the timer callback function to identify which
+ * timer expired when the same callback function is assigned to more than one
+ * timer.
+ *
+ * @param pxCallbackFunction The function to call when the timer expires.
+ * Callback functions must have the prototype defined by TimerCallbackFunction_t,
+ * which is	"void vCallbackFunction( TimerHandle_t xTimer );".
+ *
+ * @return If the timer is successfully created then a handle to the newly
+ * created timer is returned.  If the timer cannot be created (because either
+ * there is insufficient FreeRTOS heap remaining to allocate the timer
+ * structures, or the timer period was set to 0) then NULL is returned.
+ *
+ * Example usage:
+ * @verbatim
+ * #define NUM_TIMERS 5
+ *
+ * // An array to hold handles to the created timers.
+ * TimerHandle_t xTimers[ NUM_TIMERS ];
+ *
+ * // An array to hold a count of the number of times each timer expires.
+ * int32_t lExpireCounters[ NUM_TIMERS ] = { 0 };
+ *
+ * // Define a callback function that will be used by multiple timer instances.
+ * // The callback function does nothing but count the number of times the
+ * // associated timer expires, and stop the timer once the timer has expired
+ * // 10 times.
+ * void vTimerCallback( TimerHandle_t pxTimer )
+ * {
+ * int32_t lArrayIndex;
+ * const int32_t xMaxExpiryCountBeforeStopping = 10;
+ *
+ * 	   // Optionally do something if the pxTimer parameter is NULL.
+ * 	   configASSERT( pxTimer );
+ *
+ *     // Which timer expired?
+ *     lArrayIndex = ( int32_t ) pvTimerGetTimerID( pxTimer );
+ *
+ *     // Increment the number of times that pxTimer has expired.
+ *     lExpireCounters[ lArrayIndex ] += 1;
+ *
+ *     // If the timer has expired 10 times then stop it from running.
+ *     if( lExpireCounters[ lArrayIndex ] == xMaxExpiryCountBeforeStopping )
+ *     {
+ *         // Do not use a block time if calling a timer API function from a
+ *         // timer callback function, as doing so could cause a deadlock!
+ *         xTimerStop( pxTimer, 0 );
+ *     }
+ * }
+ *
+ * void main( void )
+ * {
+ * int32_t x;
+ *
+ *     // Create then start some timers.  Starting the timers before the scheduler
+ *     // has been started means the timers will start running immediately that
+ *     // the scheduler starts.
+ *     for( x = 0; x < NUM_TIMERS; x++ )
+ *     {
+ *         xTimers[ x ] = xTimerCreate(    "Timer",       // Just a text name, not used by the kernel.
+ *                                         ( 100 * x ),   // The timer period in ticks.
+ *                                         pdTRUE,        // The timers will auto-reload themselves when they expire.
+ *                                         ( void * ) x,  // Assign each timer a unique id equal to its array index.
+ *                                         vTimerCallback // Each timer calls the same callback when it expires.
+ *                                     );
+ *
+ *         if( xTimers[ x ] == NULL )
+ *         {
+ *             // The timer was not created.
+ *         }
+ *         else
+ *         {
+ *             // Start the timer.  No block time is specified, and even if one was
+ *             // it would be ignored because the scheduler has not yet been
+ *             // started.
+ *             if( xTimerStart( xTimers[ x ], 0 ) != pdPASS )
+ *             {
+ *                 // The timer could not be set into the Active state.
+ *             }
+ *         }
+ *     }
+ *
+ *     // ...
+ *     // Create tasks here.
+ *     // ...
+ *
+ *     // Starting the scheduler will start the timers running as they have already
+ *     // been set into the active state.
+ *     vTaskStartScheduler();
+ *
+ *     // Should not reach here.
+ *     for( ;; );
+ * }
+ * @endverbatim
+ */
+#if( configSUPPORT_DYNAMIC_ALLOCATION == 1 )
+	TimerHandle_t xTimerCreate(	const char * const pcTimerName,
+								const TickType_t xTimerPeriodInTicks,
+								const UBaseType_t uxAutoReload,
+								void * const pvTimerID,
+								TimerCallbackFunction_t pxCallbackFunction ) PRIVILEGED_FUNCTION; /*lint !e971 Unqualified char types are allowed for strings and single characters only. */
+#endif
+
+/**
+ * TimerHandle_t xTimerCreateStatic(const char * const pcTimerName,
+ * 									TickType_t xTimerPeriodInTicks,
+ * 									UBaseType_t uxAutoReload,
+ * 									void * pvTimerID,
+ * 									TimerCallbackFunction_t pxCallbackFunction,
+ *									StaticTimer_t *pxTimerBuffer );
+ *
+ * Creates a new software timer instance, and returns a handle by which the
+ * created software timer can be referenced.
+ *
+ * Internally, within the FreeRTOS implementation, software timers use a block
+ * of memory, in which the timer data structure is stored.  If a software timer
+ * is created using xTimerCreate() then the required memory is automatically
+ * dynamically allocated inside the xTimerCreate() function.  (see
+ * http://www.freertos.org/a00111.html).  If a software timer is created using
+ * xTimerCreateStatic() then the application writer must provide the memory that
+ * will get used by the software timer.  xTimerCreateStatic() therefore allows a
+ * software timer to be created without using any dynamic memory allocation.
+ *
+ * Timers are created in the dormant state.  The xTimerStart(), xTimerReset(),
+ * xTimerStartFromISR(), xTimerResetFromISR(), xTimerChangePeriod() and
+ * xTimerChangePeriodFromISR() API functions can all be used to transition a
+ * timer into the active state.
+ *
+ * @param pcTimerName A text name that is assigned to the timer.  This is done
+ * purely to assist debugging.  The kernel itself only ever references a timer
+ * by its handle, and never by its name.
+ *
+ * @param xTimerPeriodInTicks The timer period.  The time is defined in tick
+ * periods so the constant portTICK_PERIOD_MS can be used to convert a time that
+ * has been specified in milliseconds.  For example, if the timer must expire
+ * after 100 ticks, then xTimerPeriodInTicks should be set to 100.
+ * Alternatively, if the timer must expire after 500ms, then xPeriod can be set
+ * to ( 500 / portTICK_PERIOD_MS ) provided configTICK_RATE_HZ is less than or
+ * equal to 1000.
+ *
+ * @param uxAutoReload If uxAutoReload is set to pdTRUE then the timer will
+ * expire repeatedly with a frequency set by the xTimerPeriodInTicks parameter.
+ * If uxAutoReload is set to pdFALSE then the timer will be a one-shot timer and
+ * enter the dormant state after it expires.
+ *
+ * @param pvTimerID An identifier that is assigned to the timer being created.
+ * Typically this would be used in the timer callback function to identify which
+ * timer expired when the same callback function is assigned to more than one
+ * timer.
+ *
+ * @param pxCallbackFunction The function to call when the timer expires.
+ * Callback functions must have the prototype defined by TimerCallbackFunction_t,
+ * which is "void vCallbackFunction( TimerHandle_t xTimer );".
+ *
+ * @param pxTimerBuffer Must point to a variable of type StaticTimer_t, which
+ * will be then be used to hold the software timer's data structures, removing
+ * the need for the memory to be allocated dynamically.
+ *
+ * @return If the timer is created then a handle to the created timer is
+ * returned.  If pxTimerBuffer was NULL then NULL is returned.
+ *
+ * Example usage:
+ * @verbatim
+ *
+ * // The buffer used to hold the software timer's data structure.
+ * static StaticTimer_t xTimerBuffer;
+ *
+ * // A variable that will be incremented by the software timer's callback
+ * // function.
+ * UBaseType_t uxVariableToIncrement = 0;
+ *
+ * // A software timer callback function that increments a variable passed to
+ * // it when the software timer was created.  After the 5th increment the
+ * // callback function stops the software timer.
+ * static void prvTimerCallback( TimerHandle_t xExpiredTimer )
+ * {
+ * UBaseType_t *puxVariableToIncrement;
+ * BaseType_t xReturned;
+ *
+ *     // Obtain the address of the variable to increment from the timer ID.
+ *     puxVariableToIncrement = ( UBaseType_t * ) pvTimerGetTimerID( xExpiredTimer );
+ *
+ *     // Increment the variable to show the timer callback has executed.
+ *     ( *puxVariableToIncrement )++;
+ *
+ *     // If this callback has executed the required number of times, stop the
+ *     // timer.
+ *     if( *puxVariableToIncrement == 5 )
+ *     {
+ *         // This is called from a timer callback so must not block.
+ *         xTimerStop( xExpiredTimer, staticDONT_BLOCK );
+ *     }
+ * }
+ *
+ *
+ * void main( void )
+ * {
+ *     // Create the software time.  xTimerCreateStatic() has an extra parameter
+ *     // than the normal xTimerCreate() API function.  The parameter is a pointer
+ *     // to the StaticTimer_t structure that will hold the software timer
+ *     // structure.  If the parameter is passed as NULL then the structure will be
+ *     // allocated dynamically, just as if xTimerCreate() had been called.
+ *     xTimer = xTimerCreateStatic( "T1",             // Text name for the task.  Helps debugging only.  Not used by FreeRTOS.
+ *                                  xTimerPeriod,     // The period of the timer in ticks.
+ *                                  pdTRUE,           // This is an auto-reload timer.
+ *                                  ( void * ) &uxVariableToIncrement,    // A variable incremented by the software timer's callback function
+ *                                  prvTimerCallback, // The function to execute when the timer expires.
+ *                                  &xTimerBuffer );  // The buffer that will hold the software timer structure.
+ *
+ *     // The scheduler has not started yet so a block time is not used.
+ *     xReturned = xTimerStart( xTimer, 0 );
+ *
+ *     // ...
+ *     // Create tasks here.
+ *     // ...
+ *
+ *     // Starting the scheduler will start the timers running as they have already
+ *     // been set into the active state.
+ *     vTaskStartScheduler();
+ *
+ *     // Should not reach here.
+ *     for( ;; );
+ * }
+ * @endverbatim
+ */
+#if( configSUPPORT_STATIC_ALLOCATION == 1 )
+	TimerHandle_t xTimerCreateStatic(	const char * const pcTimerName,
+										const TickType_t xTimerPeriodInTicks,
+										const UBaseType_t uxAutoReload,
+										void * const pvTimerID,
+										TimerCallbackFunction_t pxCallbackFunction,
+										StaticTimer_t *pxTimerBuffer ) PRIVILEGED_FUNCTION; /*lint !e971 Unqualified char types are allowed for strings and single characters only. */
+#endif /* configSUPPORT_STATIC_ALLOCATION */
+
+/**
+ * void *pvTimerGetTimerID( TimerHandle_t xTimer );
+ *
+ * Returns the ID assigned to the timer.
+ *
+ * IDs are assigned to timers using the pvTimerID parameter of the call to
+ * xTimerCreated() that was used to create the timer, and by calling the
+ * vTimerSetTimerID() API function.
+ *
+ * If the same callback function is assigned to multiple timers then the timer
+ * ID can be used as time specific (timer local) storage.
+ *
+ * @param xTimer The timer being queried.
+ *
+ * @return The ID assigned to the timer being queried.
+ *
+ * Example usage:
+ *
+ * See the xTimerCreate() API function example usage scenario.
+ */
+void *pvTimerGetTimerID( const TimerHandle_t xTimer ) PRIVILEGED_FUNCTION;
+
+/**
+ * void vTimerSetTimerID( TimerHandle_t xTimer, void *pvNewID );
+ *
+ * Sets the ID assigned to the timer.
+ *
+ * IDs are assigned to timers using the pvTimerID parameter of the call to
+ * xTimerCreated() that was used to create the timer.
+ *
+ * If the same callback function is assigned to multiple timers then the timer
+ * ID can be used as time specific (timer local) storage.
+ *
+ * @param xTimer The timer being updated.
+ *
+ * @param pvNewID The ID to assign to the timer.
+ *
+ * Example usage:
+ *
+ * See the xTimerCreate() API function example usage scenario.
+ */
+void vTimerSetTimerID( TimerHandle_t xTimer, void *pvNewID ) PRIVILEGED_FUNCTION;
+
+/**
+ * BaseType_t xTimerIsTimerActive( TimerHandle_t xTimer );
+ *
+ * Queries a timer to see if it is active or dormant.
+ *
+ * A timer will be dormant if:
+ *     1) It has been created but not started, or
+ *     2) It is an expired one-shot timer that has not been restarted.
+ *
+ * Timers are created in the dormant state.  The xTimerStart(), xTimerReset(),
+ * xTimerStartFromISR(), xTimerResetFromISR(), xTimerChangePeriod() and
+ * xTimerChangePeriodFromISR() API functions can all be used to transition a timer into the
+ * active state.
+ *
+ * @param xTimer The timer being queried.
+ *
+ * @return pdFALSE will be returned if the timer is dormant.  A value other than
+ * pdFALSE will be returned if the timer is active.
+ *
+ * Example usage:
+ * @verbatim
+ * // This function assumes xTimer has already been created.
+ * void vAFunction( TimerHandle_t xTimer )
+ * {
+ *     if( xTimerIsTimerActive( xTimer ) != pdFALSE ) // or more simply and equivalently "if( xTimerIsTimerActive( xTimer ) )"
+ *     {
+ *         // xTimer is active, do something.
+ *     }
+ *     else
+ *     {
+ *         // xTimer is not active, do something else.
+ *     }
+ * }
+ * @endverbatim
+ */
+BaseType_t xTimerIsTimerActive( TimerHandle_t xTimer ) PRIVILEGED_FUNCTION;
+
+/**
+ * TaskHandle_t xTimerGetTimerDaemonTaskHandle( void );
+ *
+ * Simply returns the handle of the timer service/daemon task.  It it not valid
+ * to call xTimerGetTimerDaemonTaskHandle() before the scheduler has been started.
+ */
+TaskHandle_t xTimerGetTimerDaemonTaskHandle( void ) PRIVILEGED_FUNCTION;
+
+/**
+ * BaseType_t xTimerStart( TimerHandle_t xTimer, TickType_t xTicksToWait );
+ *
+ * Timer functionality is provided by a timer service/daemon task.  Many of the
+ * public FreeRTOS timer API functions send commands to the timer service task
+ * through a queue called the timer command queue.  The timer command queue is
+ * private to the kernel itself and is not directly accessible to application
+ * code.  The length of the timer command queue is set by the
+ * configTIMER_QUEUE_LENGTH configuration constant.
+ *
+ * xTimerStart() starts a timer that was previously created using the
+ * xTimerCreate() API function.  If the timer had already been started and was
+ * already in the active state, then xTimerStart() has equivalent functionality
+ * to the xTimerReset() API function.
+ *
+ * Starting a timer ensures the timer is in the active state.  If the timer
+ * is not stopped, deleted, or reset in the mean time, the callback function
+ * associated with the timer will get called 'n' ticks after xTimerStart() was
+ * called, where 'n' is the timers defined period.
+ *
+ * It is valid to call xTimerStart() before the scheduler has been started, but
+ * when this is done the timer will not actually start until the scheduler is
+ * started, and the timers expiry time will be relative to when the scheduler is
+ * started, not relative to when xTimerStart() was called.
+ *
+ * The configUSE_TIMERS configuration constant must be set to 1 for xTimerStart()
+ * to be available.
+ *
+ * @param xTimer The handle of the timer being started/restarted.
+ *
+ * @param xTicksToWait Specifies the time, in ticks, that the calling task should
+ * be held in the Blocked state to wait for the start command to be successfully
+ * sent to the timer command queue, should the queue already be full when
+ * xTimerStart() was called.  xTicksToWait is ignored if xTimerStart() is called
+ * before the scheduler is started.
+ *
+ * @return pdFAIL will be returned if the start command could not be sent to
+ * the timer command queue even after xTicksToWait ticks had passed.  pdPASS will
+ * be returned if the command was successfully sent to the timer command queue.
+ * When the command is actually processed will depend on the priority of the
+ * timer service/daemon task relative to other tasks in the system, although the
+ * timers expiry time is relative to when xTimerStart() is actually called.  The
+ * timer service/daemon task priority is set by the configTIMER_TASK_PRIORITY
+ * configuration constant.
+ *
+ * Example usage:
+ *
+ * See the xTimerCreate() API function example usage scenario.
+ *
+ */
+#define xTimerStart( xTimer, xTicksToWait ) xTimerGenericCommand( ( xTimer ), tmrCOMMAND_START, ( xTaskGetTickCount() ), NULL, ( xTicksToWait ) )
+
+/**
+ * BaseType_t xTimerStop( TimerHandle_t xTimer, TickType_t xTicksToWait );
+ *
+ * Timer functionality is provided by a timer service/daemon task.  Many of the
+ * public FreeRTOS timer API functions send commands to the timer service task
+ * through a queue called the timer command queue.  The timer command queue is
+ * private to the kernel itself and is not directly accessible to application
+ * code.  The length of the timer command queue is set by the
+ * configTIMER_QUEUE_LENGTH configuration constant.
+ *
+ * xTimerStop() stops a timer that was previously started using either of the
+ * The xTimerStart(), xTimerReset(), xTimerStartFromISR(), xTimerResetFromISR(),
+ * xTimerChangePeriod() or xTimerChangePeriodFromISR() API functions.
+ *
+ * Stopping a timer ensures the timer is not in the active state.
+ *
+ * The configUSE_TIMERS configuration constant must be set to 1 for xTimerStop()
+ * to be available.
+ *
+ * @param xTimer The handle of the timer being stopped.
+ *
+ * @param xTicksToWait Specifies the time, in ticks, that the calling task should
+ * be held in the Blocked state to wait for the stop command to be successfully
+ * sent to the timer command queue, should the queue already be full when
+ * xTimerStop() was called.  xTicksToWait is ignored if xTimerStop() is called
+ * before the scheduler is started.
+ *
+ * @return pdFAIL will be returned if the stop command could not be sent to
+ * the timer command queue even after xTicksToWait ticks had passed.  pdPASS will
+ * be returned if the command was successfully sent to the timer command queue.
+ * When the command is actually processed will depend on the priority of the
+ * timer service/daemon task relative to other tasks in the system.  The timer
+ * service/daemon task priority is set by the configTIMER_TASK_PRIORITY
+ * configuration constant.
+ *
+ * Example usage:
+ *
+ * See the xTimerCreate() API function example usage scenario.
+ *
+ */
+#define xTimerStop( xTimer, xTicksToWait ) xTimerGenericCommand( ( xTimer ), tmrCOMMAND_STOP, 0U, NULL, ( xTicksToWait ) )
+
+/**
+ * BaseType_t xTimerChangePeriod( 	TimerHandle_t xTimer,
+ *										TickType_t xNewPeriod,
+ *										TickType_t xTicksToWait );
+ *
+ * Timer functionality is provided by a timer service/daemon task.  Many of the
+ * public FreeRTOS timer API functions send commands to the timer service task
+ * through a queue called the timer command queue.  The timer command queue is
+ * private to the kernel itself and is not directly accessible to application
+ * code.  The length of the timer command queue is set by the
+ * configTIMER_QUEUE_LENGTH configuration constant.
+ *
+ * xTimerChangePeriod() changes the period of a timer that was previously
+ * created using the xTimerCreate() API function.
+ *
+ * xTimerChangePeriod() can be called to change the period of an active or
+ * dormant state timer.
+ *
+ * The configUSE_TIMERS configuration constant must be set to 1 for
+ * xTimerChangePeriod() to be available.
+ *
+ * @param xTimer The handle of the timer that is having its period changed.
+ *
+ * @param xNewPeriod The new period for xTimer. Timer periods are specified in
+ * tick periods, so the constant portTICK_PERIOD_MS can be used to convert a time
+ * that has been specified in milliseconds.  For example, if the timer must
+ * expire after 100 ticks, then xNewPeriod should be set to 100.  Alternatively,
+ * if the timer must expire after 500ms, then xNewPeriod can be set to
+ * ( 500 / portTICK_PERIOD_MS ) provided configTICK_RATE_HZ is less than
+ * or equal to 1000.
+ *
+ * @param xTicksToWait Specifies the time, in ticks, that the calling task should
+ * be held in the Blocked state to wait for the change period command to be
+ * successfully sent to the timer command queue, should the queue already be
+ * full when xTimerChangePeriod() was called.  xTicksToWait is ignored if
+ * xTimerChangePeriod() is called before the scheduler is started.
+ *
+ * @return pdFAIL will be returned if the change period command could not be
+ * sent to the timer command queue even after xTicksToWait ticks had passed.
+ * pdPASS will be returned if the command was successfully sent to the timer
+ * command queue.  When the command is actually processed will depend on the
+ * priority of the timer service/daemon task relative to other tasks in the
+ * system.  The timer service/daemon task priority is set by the
+ * configTIMER_TASK_PRIORITY configuration constant.
+ *
+ * Example usage:
+ * @verbatim
+ * // This function assumes xTimer has already been created.  If the timer
+ * // referenced by xTimer is already active when it is called, then the timer
+ * // is deleted.  If the timer referenced by xTimer is not active when it is
+ * // called, then the period of the timer is set to 500ms and the timer is
+ * // started.
+ * void vAFunction( TimerHandle_t xTimer )
+ * {
+ *     if( xTimerIsTimerActive( xTimer ) != pdFALSE ) // or more simply and equivalently "if( xTimerIsTimerActive( xTimer ) )"
+ *     {
+ *         // xTimer is already active - delete it.
+ *         xTimerDelete( xTimer );
+ *     }
+ *     else
+ *     {
+ *         // xTimer is not active, change its period to 500ms.  This will also
+ *         // cause the timer to start.  Block for a maximum of 100 ticks if the
+ *         // change period command cannot immediately be sent to the timer
+ *         // command queue.
+ *         if( xTimerChangePeriod( xTimer, 500 / portTICK_PERIOD_MS, 100 ) == pdPASS )
+ *         {
+ *             // The command was successfully sent.
+ *         }
+ *         else
+ *         {
+ *             // The command could not be sent, even after waiting for 100 ticks
+ *             // to pass.  Take appropriate action here.
+ *         }
+ *     }
+ * }
+ * @endverbatim
+ */
+ #define xTimerChangePeriod( xTimer, xNewPeriod, xTicksToWait ) xTimerGenericCommand( ( xTimer ), tmrCOMMAND_CHANGE_PERIOD, ( xNewPeriod ), NULL, ( xTicksToWait ) )
+
+/**
+ * BaseType_t xTimerDelete( TimerHandle_t xTimer, TickType_t xTicksToWait );
+ *
+ * Timer functionality is provided by a timer service/daemon task.  Many of the
+ * public FreeRTOS timer API functions send commands to the timer service task
+ * through a queue called the timer command queue.  The timer command queue is
+ * private to the kernel itself and is not directly accessible to application
+ * code.  The length of the timer command queue is set by the
+ * configTIMER_QUEUE_LENGTH configuration constant.
+ *
+ * xTimerDelete() deletes a timer that was previously created using the
+ * xTimerCreate() API function.
+ *
+ * The configUSE_TIMERS configuration constant must be set to 1 for
+ * xTimerDelete() to be available.
+ *
+ * @param xTimer The handle of the timer being deleted.
+ *
+ * @param xTicksToWait Specifies the time, in ticks, that the calling task should
+ * be held in the Blocked state to wait for the delete command to be
+ * successfully sent to the timer command queue, should the queue already be
+ * full when xTimerDelete() was called.  xTicksToWait is ignored if xTimerDelete()
+ * is called before the scheduler is started.
+ *
+ * @return pdFAIL will be returned if the delete command could not be sent to
+ * the timer command queue even after xTicksToWait ticks had passed.  pdPASS will
+ * be returned if the command was successfully sent to the timer command queue.
+ * When the command is actually processed will depend on the priority of the
+ * timer service/daemon task relative to other tasks in the system.  The timer
+ * service/daemon task priority is set by the configTIMER_TASK_PRIORITY
+ * configuration constant.
+ *
+ * Example usage:
+ *
+ * See the xTimerChangePeriod() API function example usage scenario.
+ */
+#define xTimerDelete( xTimer, xTicksToWait ) xTimerGenericCommand( ( xTimer ), tmrCOMMAND_DELETE, 0U, NULL, ( xTicksToWait ) )
+
+/**
+ * BaseType_t xTimerReset( TimerHandle_t xTimer, TickType_t xTicksToWait );
+ *
+ * Timer functionality is provided by a timer service/daemon task.  Many of the
+ * public FreeRTOS timer API functions send commands to the timer service task
+ * through a queue called the timer command queue.  The timer command queue is
+ * private to the kernel itself and is not directly accessible to application
+ * code.  The length of the timer command queue is set by the
+ * configTIMER_QUEUE_LENGTH configuration constant.
+ *
+ * xTimerReset() re-starts a timer that was previously created using the
+ * xTimerCreate() API function.  If the timer had already been started and was
+ * already in the active state, then xTimerReset() will cause the timer to
+ * re-evaluate its expiry time so that it is relative to when xTimerReset() was
+ * called.  If the timer was in the dormant state then xTimerReset() has
+ * equivalent functionality to the xTimerStart() API function.
+ *
+ * Resetting a timer ensures the timer is in the active state.  If the timer
+ * is not stopped, deleted, or reset in the mean time, the callback function
+ * associated with the timer will get called 'n' ticks after xTimerReset() was
+ * called, where 'n' is the timers defined period.
+ *
+ * It is valid to call xTimerReset() before the scheduler has been started, but
+ * when this is done the timer will not actually start until the scheduler is
+ * started, and the timers expiry time will be relative to when the scheduler is
+ * started, not relative to when xTimerReset() was called.
+ *
+ * The configUSE_TIMERS configuration constant must be set to 1 for xTimerReset()
+ * to be available.
+ *
+ * @param xTimer The handle of the timer being reset/started/restarted.
+ *
+ * @param xTicksToWait Specifies the time, in ticks, that the calling task should
+ * be held in the Blocked state to wait for the reset command to be successfully
+ * sent to the timer command queue, should the queue already be full when
+ * xTimerReset() was called.  xTicksToWait is ignored if xTimerReset() is called
+ * before the scheduler is started.
+ *
+ * @return pdFAIL will be returned if the reset command could not be sent to
+ * the timer command queue even after xTicksToWait ticks had passed.  pdPASS will
+ * be returned if the command was successfully sent to the timer command queue.
+ * When the command is actually processed will depend on the priority of the
+ * timer service/daemon task relative to other tasks in the system, although the
+ * timers expiry time is relative to when xTimerStart() is actually called.  The
+ * timer service/daemon task priority is set by the configTIMER_TASK_PRIORITY
+ * configuration constant.
+ *
+ * Example usage:
+ * @verbatim
+ * // When a key is pressed, an LCD back-light is switched on.  If 5 seconds pass
+ * // without a key being pressed, then the LCD back-light is switched off.  In
+ * // this case, the timer is a one-shot timer.
+ *
+ * TimerHandle_t xBacklightTimer = NULL;
+ *
+ * // The callback function assigned to the one-shot timer.  In this case the
+ * // parameter is not used.
+ * void vBacklightTimerCallback( TimerHandle_t pxTimer )
+ * {
+ *     // The timer expired, therefore 5 seconds must have passed since a key
+ *     // was pressed.  Switch off the LCD back-light.
+ *     vSetBacklightState( BACKLIGHT_OFF );
+ * }
+ *
+ * // The key press event handler.
+ * void vKeyPressEventHandler( char cKey )
+ * {
+ *     // Ensure the LCD back-light is on, then reset the timer that is
+ *     // responsible for turning the back-light off after 5 seconds of
+ *     // key inactivity.  Wait 10 ticks for the command to be successfully sent
+ *     // if it cannot be sent immediately.
+ *     vSetBacklightState( BACKLIGHT_ON );
+ *     if( xTimerReset( xBacklightTimer, 100 ) != pdPASS )
+ *     {
+ *         // The reset command was not executed successfully.  Take appropriate
+ *         // action here.
+ *     }
+ *
+ *     // Perform the rest of the key processing here.
+ * }
+ *
+ * void main( void )
+ * {
+ * int32_t x;
+ *
+ *     // Create then start the one-shot timer that is responsible for turning
+ *     // the back-light off if no keys are pressed within a 5 second period.
+ *     xBacklightTimer = xTimerCreate( "BacklightTimer",           // Just a text name, not used by the kernel.
+ *                                     ( 5000 / portTICK_PERIOD_MS), // The timer period in ticks.
+ *                                     pdFALSE,                    // The timer is a one-shot timer.
+ *                                     0,                          // The id is not used by the callback so can take any value.
+ *                                     vBacklightTimerCallback     // The callback function that switches the LCD back-light off.
+ *                                   );
+ *
+ *     if( xBacklightTimer == NULL )
+ *     {
+ *         // The timer was not created.
+ *     }
+ *     else
+ *     {
+ *         // Start the timer.  No block time is specified, and even if one was
+ *         // it would be ignored because the scheduler has not yet been
+ *         // started.
+ *         if( xTimerStart( xBacklightTimer, 0 ) != pdPASS )
+ *         {
+ *             // The timer could not be set into the Active state.
+ *         }
+ *     }
+ *
+ *     // ...
+ *     // Create tasks here.
+ *     // ...
+ *
+ *     // Starting the scheduler will start the timer running as it has already
+ *     // been set into the active state.
+ *     vTaskStartScheduler();
+ *
+ *     // Should not reach here.
+ *     for( ;; );
+ * }
+ * @endverbatim
+ */
+#define xTimerReset( xTimer, xTicksToWait ) xTimerGenericCommand( ( xTimer ), tmrCOMMAND_RESET, ( xTaskGetTickCount() ), NULL, ( xTicksToWait ) )
+
+/**
+ * BaseType_t xTimerStartFromISR( 	TimerHandle_t xTimer,
+ *									BaseType_t *pxHigherPriorityTaskWoken );
+ *
+ * A version of xTimerStart() that can be called from an interrupt service
+ * routine.
+ *
+ * @param xTimer The handle of the timer being started/restarted.
+ *
+ * @param pxHigherPriorityTaskWoken The timer service/daemon task spends most
+ * of its time in the Blocked state, waiting for messages to arrive on the timer
+ * command queue.  Calling xTimerStartFromISR() writes a message to the timer
+ * command queue, so has the potential to transition the timer service/daemon
+ * task out of the Blocked state.  If calling xTimerStartFromISR() causes the
+ * timer service/daemon task to leave the Blocked state, and the timer service/
+ * daemon task has a priority equal to or greater than the currently executing
+ * task (the task that was interrupted), then *pxHigherPriorityTaskWoken will
+ * get set to pdTRUE internally within the xTimerStartFromISR() function.  If
+ * xTimerStartFromISR() sets this value to pdTRUE then a context switch should
+ * be performed before the interrupt exits.
+ *
+ * @return pdFAIL will be returned if the start command could not be sent to
+ * the timer command queue.  pdPASS will be returned if the command was
+ * successfully sent to the timer command queue.  When the command is actually
+ * processed will depend on the priority of the timer service/daemon task
+ * relative to other tasks in the system, although the timers expiry time is
+ * relative to when xTimerStartFromISR() is actually called.  The timer
+ * service/daemon task priority is set by the configTIMER_TASK_PRIORITY
+ * configuration constant.
+ *
+ * Example usage:
+ * @verbatim
+ * // This scenario assumes xBacklightTimer has already been created.  When a
+ * // key is pressed, an LCD back-light is switched on.  If 5 seconds pass
+ * // without a key being pressed, then the LCD back-light is switched off.  In
+ * // this case, the timer is a one-shot timer, and unlike the example given for
+ * // the xTimerReset() function, the key press event handler is an interrupt
+ * // service routine.
+ *
+ * // The callback function assigned to the one-shot timer.  In this case the
+ * // parameter is not used.
+ * void vBacklightTimerCallback( TimerHandle_t pxTimer )
+ * {
+ *     // The timer expired, therefore 5 seconds must have passed since a key
+ *     // was pressed.  Switch off the LCD back-light.
+ *     vSetBacklightState( BACKLIGHT_OFF );
+ * }
+ *
+ * // The key press interrupt service routine.
+ * void vKeyPressEventInterruptHandler( void )
+ * {
+ * BaseType_t xHigherPriorityTaskWoken = pdFALSE;
+ *
+ *     // Ensure the LCD back-light is on, then restart the timer that is
+ *     // responsible for turning the back-light off after 5 seconds of
+ *     // key inactivity.  This is an interrupt service routine so can only
+ *     // call FreeRTOS API functions that end in "FromISR".
+ *     vSetBacklightState( BACKLIGHT_ON );
+ *
+ *     // xTimerStartFromISR() or xTimerResetFromISR() could be called here
+ *     // as both cause the timer to re-calculate its expiry time.
+ *     // xHigherPriorityTaskWoken was initialised to pdFALSE when it was
+ *     // declared (in this function).
+ *     if( xTimerStartFromISR( xBacklightTimer, &xHigherPriorityTaskWoken ) != pdPASS )
+ *     {
+ *         // The start command was not executed successfully.  Take appropriate
+ *         // action here.
+ *     }
+ *
+ *     // Perform the rest of the key processing here.
+ *
+ *     // If xHigherPriorityTaskWoken equals pdTRUE, then a context switch
+ *     // should be performed.  The syntax required to perform a context switch
+ *     // from inside an ISR varies from port to port, and from compiler to
+ *     // compiler.  Inspect the demos for the port you are using to find the
+ *     // actual syntax required.
+ *     if( xHigherPriorityTaskWoken != pdFALSE )
+ *     {
+ *         // Call the interrupt safe yield function here (actual function
+ *         // depends on the FreeRTOS port being used).
+ *     }
+ * }
+ * @endverbatim
+ */
+#define xTimerStartFromISR( xTimer, pxHigherPriorityTaskWoken ) xTimerGenericCommand( ( xTimer ), tmrCOMMAND_START_FROM_ISR, ( xTaskGetTickCountFromISR() ), ( pxHigherPriorityTaskWoken ), 0U )
+
+/**
+ * BaseType_t xTimerStopFromISR( 	TimerHandle_t xTimer,
+ *									BaseType_t *pxHigherPriorityTaskWoken );
+ *
+ * A version of xTimerStop() that can be called from an interrupt service
+ * routine.
+ *
+ * @param xTimer The handle of the timer being stopped.
+ *
+ * @param pxHigherPriorityTaskWoken The timer service/daemon task spends most
+ * of its time in the Blocked state, waiting for messages to arrive on the timer
+ * command queue.  Calling xTimerStopFromISR() writes a message to the timer
+ * command queue, so has the potential to transition the timer service/daemon
+ * task out of the Blocked state.  If calling xTimerStopFromISR() causes the
+ * timer service/daemon task to leave the Blocked state, and the timer service/
+ * daemon task has a priority equal to or greater than the currently executing
+ * task (the task that was interrupted), then *pxHigherPriorityTaskWoken will
+ * get set to pdTRUE internally within the xTimerStopFromISR() function.  If
+ * xTimerStopFromISR() sets this value to pdTRUE then a context switch should
+ * be performed before the interrupt exits.
+ *
+ * @return pdFAIL will be returned if the stop command could not be sent to
+ * the timer command queue.  pdPASS will be returned if the command was
+ * successfully sent to the timer command queue.  When the command is actually
+ * processed will depend on the priority of the timer service/daemon task
+ * relative to other tasks in the system.  The timer service/daemon task
+ * priority is set by the configTIMER_TASK_PRIORITY configuration constant.
+ *
+ * Example usage:
+ * @verbatim
+ * // This scenario assumes xTimer has already been created and started.  When
+ * // an interrupt occurs, the timer should be simply stopped.
+ *
+ * // The interrupt service routine that stops the timer.
+ * void vAnExampleInterruptServiceRoutine( void )
+ * {
+ * BaseType_t xHigherPriorityTaskWoken = pdFALSE;
+ *
+ *     // The interrupt has occurred - simply stop the timer.
+ *     // xHigherPriorityTaskWoken was set to pdFALSE where it was defined
+ *     // (within this function).  As this is an interrupt service routine, only
+ *     // FreeRTOS API functions that end in "FromISR" can be used.
+ *     if( xTimerStopFromISR( xTimer, &xHigherPriorityTaskWoken ) != pdPASS )
+ *     {
+ *         // The stop command was not executed successfully.  Take appropriate
+ *         // action here.
+ *     }
+ *
+ *     // If xHigherPriorityTaskWoken equals pdTRUE, then a context switch
+ *     // should be performed.  The syntax required to perform a context switch
+ *     // from inside an ISR varies from port to port, and from compiler to
+ *     // compiler.  Inspect the demos for the port you are using to find the
+ *     // actual syntax required.
+ *     if( xHigherPriorityTaskWoken != pdFALSE )
+ *     {
+ *         // Call the interrupt safe yield function here (actual function
+ *         // depends on the FreeRTOS port being used).
+ *     }
+ * }
+ * @endverbatim
+ */
+#define xTimerStopFromISR( xTimer, pxHigherPriorityTaskWoken ) xTimerGenericCommand( ( xTimer ), tmrCOMMAND_STOP_FROM_ISR, 0, ( pxHigherPriorityTaskWoken ), 0U )
+
+/**
+ * BaseType_t xTimerChangePeriodFromISR( TimerHandle_t xTimer,
+ *										 TickType_t xNewPeriod,
+ *										 BaseType_t *pxHigherPriorityTaskWoken );
+ *
+ * A version of xTimerChangePeriod() that can be called from an interrupt
+ * service routine.
+ *
+ * @param xTimer The handle of the timer that is having its period changed.
+ *
+ * @param xNewPeriod The new period for xTimer. Timer periods are specified in
+ * tick periods, so the constant portTICK_PERIOD_MS can be used to convert a time
+ * that has been specified in milliseconds.  For example, if the timer must
+ * expire after 100 ticks, then xNewPeriod should be set to 100.  Alternatively,
+ * if the timer must expire after 500ms, then xNewPeriod can be set to
+ * ( 500 / portTICK_PERIOD_MS ) provided configTICK_RATE_HZ is less than
+ * or equal to 1000.
+ *
+ * @param pxHigherPriorityTaskWoken The timer service/daemon task spends most
+ * of its time in the Blocked state, waiting for messages to arrive on the timer
+ * command queue.  Calling xTimerChangePeriodFromISR() writes a message to the
+ * timer command queue, so has the potential to transition the timer service/
+ * daemon task out of the Blocked state.  If calling xTimerChangePeriodFromISR()
+ * causes the timer service/daemon task to leave the Blocked state, and the
+ * timer service/daemon task has a priority equal to or greater than the
+ * currently executing task (the task that was interrupted), then
+ * *pxHigherPriorityTaskWoken will get set to pdTRUE internally within the
+ * xTimerChangePeriodFromISR() function.  If xTimerChangePeriodFromISR() sets
+ * this value to pdTRUE then a context switch should be performed before the
+ * interrupt exits.
+ *
+ * @return pdFAIL will be returned if the command to change the timers period
+ * could not be sent to the timer command queue.  pdPASS will be returned if the
+ * command was successfully sent to the timer command queue.  When the command
+ * is actually processed will depend on the priority of the timer service/daemon
+ * task relative to other tasks in the system.  The timer service/daemon task
+ * priority is set by the configTIMER_TASK_PRIORITY configuration constant.
+ *
+ * Example usage:
+ * @verbatim
+ * // This scenario assumes xTimer has already been created and started.  When
+ * // an interrupt occurs, the period of xTimer should be changed to 500ms.
+ *
+ * // The interrupt service routine that changes the period of xTimer.
+ * void vAnExampleInterruptServiceRoutine( void )
+ * {
+ * BaseType_t xHigherPriorityTaskWoken = pdFALSE;
+ *
+ *     // The interrupt has occurred - change the period of xTimer to 500ms.
+ *     // xHigherPriorityTaskWoken was set to pdFALSE where it was defined
+ *     // (within this function).  As this is an interrupt service routine, only
+ *     // FreeRTOS API functions that end in "FromISR" can be used.
+ *     if( xTimerChangePeriodFromISR( xTimer, &xHigherPriorityTaskWoken ) != pdPASS )
+ *     {
+ *         // The command to change the timers period was not executed
+ *         // successfully.  Take appropriate action here.
+ *     }
+ *
+ *     // If xHigherPriorityTaskWoken equals pdTRUE, then a context switch
+ *     // should be performed.  The syntax required to perform a context switch
+ *     // from inside an ISR varies from port to port, and from compiler to
+ *     // compiler.  Inspect the demos for the port you are using to find the
+ *     // actual syntax required.
+ *     if( xHigherPriorityTaskWoken != pdFALSE )
+ *     {
+ *         // Call the interrupt safe yield function here (actual function
+ *         // depends on the FreeRTOS port being used).
+ *     }
+ * }
+ * @endverbatim
+ */
+#define xTimerChangePeriodFromISR( xTimer, xNewPeriod, pxHigherPriorityTaskWoken ) xTimerGenericCommand( ( xTimer ), tmrCOMMAND_CHANGE_PERIOD_FROM_ISR, ( xNewPeriod ), ( pxHigherPriorityTaskWoken ), 0U )
+
+/**
+ * BaseType_t xTimerResetFromISR( 	TimerHandle_t xTimer,
+ *									BaseType_t *pxHigherPriorityTaskWoken );
+ *
+ * A version of xTimerReset() that can be called from an interrupt service
+ * routine.
+ *
+ * @param xTimer The handle of the timer that is to be started, reset, or
+ * restarted.
+ *
+ * @param pxHigherPriorityTaskWoken The timer service/daemon task spends most
+ * of its time in the Blocked state, waiting for messages to arrive on the timer
+ * command queue.  Calling xTimerResetFromISR() writes a message to the timer
+ * command queue, so has the potential to transition the timer service/daemon
+ * task out of the Blocked state.  If calling xTimerResetFromISR() causes the
+ * timer service/daemon task to leave the Blocked state, and the timer service/
+ * daemon task has a priority equal to or greater than the currently executing
+ * task (the task that was interrupted), then *pxHigherPriorityTaskWoken will
+ * get set to pdTRUE internally within the xTimerResetFromISR() function.  If
+ * xTimerResetFromISR() sets this value to pdTRUE then a context switch should
+ * be performed before the interrupt exits.
+ *
+ * @return pdFAIL will be returned if the reset command could not be sent to
+ * the timer command queue.  pdPASS will be returned if the command was
+ * successfully sent to the timer command queue.  When the command is actually
+ * processed will depend on the priority of the timer service/daemon task
+ * relative to other tasks in the system, although the timers expiry time is
+ * relative to when xTimerResetFromISR() is actually called.  The timer service/daemon
+ * task priority is set by the configTIMER_TASK_PRIORITY configuration constant.
+ *
+ * Example usage:
+ * @verbatim
+ * // This scenario assumes xBacklightTimer has already been created.  When a
+ * // key is pressed, an LCD back-light is switched on.  If 5 seconds pass
+ * // without a key being pressed, then the LCD back-light is switched off.  In
+ * // this case, the timer is a one-shot timer, and unlike the example given for
+ * // the xTimerReset() function, the key press event handler is an interrupt
+ * // service routine.
+ *
+ * // The callback function assigned to the one-shot timer.  In this case the
+ * // parameter is not used.
+ * void vBacklightTimerCallback( TimerHandle_t pxTimer )
+ * {
+ *     // The timer expired, therefore 5 seconds must have passed since a key
+ *     // was pressed.  Switch off the LCD back-light.
+ *     vSetBacklightState( BACKLIGHT_OFF );
+ * }
+ *
+ * // The key press interrupt service routine.
+ * void vKeyPressEventInterruptHandler( void )
+ * {
+ * BaseType_t xHigherPriorityTaskWoken = pdFALSE;
+ *
+ *     // Ensure the LCD back-light is on, then reset the timer that is
+ *     // responsible for turning the back-light off after 5 seconds of
+ *     // key inactivity.  This is an interrupt service routine so can only
+ *     // call FreeRTOS API functions that end in "FromISR".
+ *     vSetBacklightState( BACKLIGHT_ON );
+ *
+ *     // xTimerStartFromISR() or xTimerResetFromISR() could be called here
+ *     // as both cause the timer to re-calculate its expiry time.
+ *     // xHigherPriorityTaskWoken was initialised to pdFALSE when it was
+ *     // declared (in this function).
+ *     if( xTimerResetFromISR( xBacklightTimer, &xHigherPriorityTaskWoken ) != pdPASS )
+ *     {
+ *         // The reset command was not executed successfully.  Take appropriate
+ *         // action here.
+ *     }
+ *
+ *     // Perform the rest of the key processing here.
+ *
+ *     // If xHigherPriorityTaskWoken equals pdTRUE, then a context switch
+ *     // should be performed.  The syntax required to perform a context switch
+ *     // from inside an ISR varies from port to port, and from compiler to
+ *     // compiler.  Inspect the demos for the port you are using to find the
+ *     // actual syntax required.
+ *     if( xHigherPriorityTaskWoken != pdFALSE )
+ *     {
+ *         // Call the interrupt safe yield function here (actual function
+ *         // depends on the FreeRTOS port being used).
+ *     }
+ * }
+ * @endverbatim
+ */
+#define xTimerResetFromISR( xTimer, pxHigherPriorityTaskWoken ) xTimerGenericCommand( ( xTimer ), tmrCOMMAND_RESET_FROM_ISR, ( xTaskGetTickCountFromISR() ), ( pxHigherPriorityTaskWoken ), 0U )
+
+
+/**
+ * BaseType_t xTimerPendFunctionCallFromISR( PendedFunction_t xFunctionToPend,
+ *                                          void *pvParameter1,
+ *                                          uint32_t ulParameter2,
+ *                                          BaseType_t *pxHigherPriorityTaskWoken );
+ *
+ *
+ * Used from application interrupt service routines to defer the execution of a
+ * function to the RTOS daemon task (the timer service task, hence this function
+ * is implemented in timers.c and is prefixed with 'Timer').
+ *
+ * Ideally an interrupt service routine (ISR) is kept as short as possible, but
+ * sometimes an ISR either has a lot of processing to do, or needs to perform
+ * processing that is not deterministic.  In these cases
+ * xTimerPendFunctionCallFromISR() can be used to defer processing of a function
+ * to the RTOS daemon task.
+ *
+ * A mechanism is provided that allows the interrupt to return directly to the
+ * task that will subsequently execute the pended callback function.  This
+ * allows the callback function to execute contiguously in time with the
+ * interrupt - just as if the callback had executed in the interrupt itself.
+ *
+ * @param xFunctionToPend The function to execute from the timer service/
+ * daemon task.  The function must conform to the PendedFunction_t
+ * prototype.
+ *
+ * @param pvParameter1 The value of the callback function's first parameter.
+ * The parameter has a void * type to allow it to be used to pass any type.
+ * For example, unsigned longs can be cast to a void *, or the void * can be
+ * used to point to a structure.
+ *
+ * @param ulParameter2 The value of the callback function's second parameter.
+ *
+ * @param pxHigherPriorityTaskWoken As mentioned above, calling this function
+ * will result in a message being sent to the timer daemon task.  If the
+ * priority of the timer daemon task (which is set using
+ * configTIMER_TASK_PRIORITY in FreeRTOSConfig.h) is higher than the priority of
+ * the currently running task (the task the interrupt interrupted) then
+ * *pxHigherPriorityTaskWoken will be set to pdTRUE within
+ * xTimerPendFunctionCallFromISR(), indicating that a context switch should be
+ * requested before the interrupt exits.  For that reason
+ * *pxHigherPriorityTaskWoken must be initialised to pdFALSE.  See the
+ * example code below.
+ *
+ * @return pdPASS is returned if the message was successfully sent to the
+ * timer daemon task, otherwise pdFALSE is returned.
+ *
+ * Example usage:
+ * @verbatim
+ *
+ *	// The callback function that will execute in the context of the daemon task.
+ *  // Note callback functions must all use this same prototype.
+ *  void vProcessInterface( void *pvParameter1, uint32_t ulParameter2 )
+ *	{
+ *		BaseType_t xInterfaceToService;
+ *
+ *		// The interface that requires servicing is passed in the second
+ *      // parameter.  The first parameter is not used in this case.
+ *		xInterfaceToService = ( BaseType_t ) ulParameter2;
+ *
+ *		// ...Perform the processing here...
+ *	}
+ *
+ *	// An ISR that receives data packets from multiple interfaces
+ *  void vAnISR( void )
+ *	{
+ *		BaseType_t xInterfaceToService, xHigherPriorityTaskWoken;
+ *
+ *		// Query the hardware to determine which interface needs processing.
+ *		xInterfaceToService = prvCheckInterfaces();
+ *
+ *      // The actual processing is to be deferred to a task.  Request the
+ *      // vProcessInterface() callback function is executed, passing in the
+ *		// number of the interface that needs processing.  The interface to
+ *		// service is passed in the second parameter.  The first parameter is
+ *		// not used in this case.
+ *		xHigherPriorityTaskWoken = pdFALSE;
+ *		xTimerPendFunctionCallFromISR( vProcessInterface, NULL, ( uint32_t ) xInterfaceToService, &xHigherPriorityTaskWoken );
+ *
+ *		// If xHigherPriorityTaskWoken is now set to pdTRUE then a context
+ *		// switch should be requested.  The macro used is port specific and will
+ *		// be either portYIELD_FROM_ISR() or portEND_SWITCHING_ISR() - refer to
+ *		// the documentation page for the port being used.
+ *		portYIELD_FROM_ISR( xHigherPriorityTaskWoken );
+ *
+ *	}
+ * @endverbatim
+ */
+BaseType_t xTimerPendFunctionCallFromISR( PendedFunction_t xFunctionToPend, void *pvParameter1, uint32_t ulParameter2, BaseType_t *pxHigherPriorityTaskWoken ) PRIVILEGED_FUNCTION;
+
+ /**
+  * BaseType_t xTimerPendFunctionCall( PendedFunction_t xFunctionToPend,
+  *                                    void *pvParameter1,
+  *                                    uint32_t ulParameter2,
+  *                                    TickType_t xTicksToWait );
+  *
+  *
+  * Used to defer the execution of a function to the RTOS daemon task (the timer
+  * service task, hence this function is implemented in timers.c and is prefixed
+  * with 'Timer').
+  *
+  * @param xFunctionToPend The function to execute from the timer service/
+  * daemon task.  The function must conform to the PendedFunction_t
+  * prototype.
+  *
+  * @param pvParameter1 The value of the callback function's first parameter.
+  * The parameter has a void * type to allow it to be used to pass any type.
+  * For example, unsigned longs can be cast to a void *, or the void * can be
+  * used to point to a structure.
+  *
+  * @param ulParameter2 The value of the callback function's second parameter.
+  *
+  * @param xTicksToWait Calling this function will result in a message being
+  * sent to the timer daemon task on a queue.  xTicksToWait is the amount of
+  * time the calling task should remain in the Blocked state (so not using any
+  * processing time) for space to become available on the timer queue if the
+  * queue is found to be full.
+  *
+  * @return pdPASS is returned if the message was successfully sent to the
+  * timer daemon task, otherwise pdFALSE is returned.
+  *
+  */
+BaseType_t xTimerPendFunctionCall( PendedFunction_t xFunctionToPend, void *pvParameter1, uint32_t ulParameter2, TickType_t xTicksToWait ) PRIVILEGED_FUNCTION;
+
+/**
+ * const char * const pcTimerGetName( TimerHandle_t xTimer );
+ *
+ * Returns the name that was assigned to a timer when the timer was created.
+ *
+ * @param xTimer The handle of the timer being queried.
+ *
+ * @return The name assigned to the timer specified by the xTimer parameter.
+ */
+const char * pcTimerGetName( TimerHandle_t xTimer ) PRIVILEGED_FUNCTION; /*lint !e971 Unqualified char types are allowed for strings and single characters only. */
+
+/**
+ * TickType_t xTimerGetPeriod( TimerHandle_t xTimer );
+ *
+ * Returns the period of a timer.
+ *
+ * @param xTimer The handle of the timer being queried.
+ *
+ * @return The period of the timer in ticks.
+ */
+TickType_t xTimerGetPeriod( TimerHandle_t xTimer ) PRIVILEGED_FUNCTION;
+
+/**
+* TickType_t xTimerGetExpiryTime( TimerHandle_t xTimer );
+*
+* Returns the time in ticks at which the timer will expire.  If this is less
+* than the current tick count then the expiry time has overflowed from the
+* current time.
+*
+* @param xTimer The handle of the timer being queried.
+*
+* @return If the timer is running then the time in ticks at which the timer
+* will next expire is returned.  If the timer is not running then the return
+* value is undefined.
+*/
+TickType_t xTimerGetExpiryTime( TimerHandle_t xTimer ) PRIVILEGED_FUNCTION;
+
+/*
+ * Functions beyond this part are not part of the public API and are intended
+ * for use by the kernel only.
+ */
+BaseType_t xTimerCreateTimerTask( void ) PRIVILEGED_FUNCTION;
+BaseType_t xTimerGenericCommand( TimerHandle_t xTimer, const BaseType_t xCommandID, const TickType_t xOptionalValue, BaseType_t * const pxHigherPriorityTaskWoken, const TickType_t xTicksToWait ) PRIVILEGED_FUNCTION;
+
+#ifdef __cplusplus
+}
+#endif
+#endif /* TIMERS_H */
+
+
+
diff --git a/FreeRTOS/list.c b/FreeRTOS/list.c
new file mode 100644
index 0000000..5e207c1
--- /dev/null
+++ b/FreeRTOS/list.c
@@ -0,0 +1,240 @@
+/*
+    FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd.
+    All rights reserved
+
+    VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION.
+
+    This file is part of the FreeRTOS distribution.
+
+    FreeRTOS is free software; you can redistribute it and/or modify it under
+    the terms of the GNU General Public License (version 2) as published by the
+    Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception.
+
+    ***************************************************************************
+    >>!   NOTE: The modification to the GPL is included to allow you to     !<<
+    >>!   distribute a combined work that includes FreeRTOS without being   !<<
+    >>!   obliged to provide the source code for proprietary components     !<<
+    >>!   outside of the FreeRTOS kernel.                                   !<<
+    ***************************************************************************
+
+    FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY
+    WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+    FOR A PARTICULAR PURPOSE.  Full license text is available on the following
+    link: http://www.freertos.org/a00114.html
+
+    ***************************************************************************
+     *                                                                       *
+     *    FreeRTOS provides completely free yet professionally developed,    *
+     *    robust, strictly quality controlled, supported, and cross          *
+     *    platform software that is more than just the market leader, it     *
+     *    is the industry's de facto standard.                               *
+     *                                                                       *
+     *    Help yourself get started quickly while simultaneously helping     *
+     *    to support the FreeRTOS project by purchasing a FreeRTOS           *
+     *    tutorial book, reference manual, or both:                          *
+     *    http://www.FreeRTOS.org/Documentation                              *
+     *                                                                       *
+    ***************************************************************************
+
+    http://www.FreeRTOS.org/FAQHelp.html - Having a problem?  Start by reading
+    the FAQ page "My application does not run, what could be wrong?".  Have you
+    defined configASSERT()?
+
+    http://www.FreeRTOS.org/support - In return for receiving this top quality
+    embedded software for free we request you assist our global community by
+    participating in the support forum.
+
+    http://www.FreeRTOS.org/training - Investing in training allows your team to
+    be as productive as possible as early as possible.  Now you can receive
+    FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers
+    Ltd, and the world's leading authority on the world's leading RTOS.
+
+    http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products,
+    including FreeRTOS+Trace - an indispensable productivity tool, a DOS
+    compatible FAT file system, and our tiny thread aware UDP/IP stack.
+
+    http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate.
+    Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS.
+
+    http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High
+    Integrity Systems ltd. to sell under the OpenRTOS brand.  Low cost OpenRTOS
+    licenses offer ticketed support, indemnification and commercial middleware.
+
+    http://www.SafeRTOS.com - High Integrity Systems also provide a safety
+    engineered and independently SIL3 certified version for use in safety and
+    mission critical applications that require provable dependability.
+
+    1 tab == 4 spaces!
+*/
+
+
+#include 
+#include "FreeRTOS.h"
+#include "list.h"
+
+/*-----------------------------------------------------------
+ * PUBLIC LIST API documented in list.h
+ *----------------------------------------------------------*/
+
+void vListInitialise( List_t * const pxList )
+{
+	/* The list structure contains a list item which is used to mark the
+	end of the list.  To initialise the list the list end is inserted
+	as the only list entry. */
+	pxList->pxIndex = ( ListItem_t * ) &( pxList->xListEnd );			/*lint !e826 !e740 The mini list structure is used as the list end to save RAM.  This is checked and valid. */
+
+	/* The list end value is the highest possible value in the list to
+	ensure it remains at the end of the list. */
+	pxList->xListEnd.xItemValue = portMAX_DELAY;
+
+	/* The list end next and previous pointers point to itself so we know
+	when the list is empty. */
+	pxList->xListEnd.pxNext = ( ListItem_t * ) &( pxList->xListEnd );	/*lint !e826 !e740 The mini list structure is used as the list end to save RAM.  This is checked and valid. */
+	pxList->xListEnd.pxPrevious = ( ListItem_t * ) &( pxList->xListEnd );/*lint !e826 !e740 The mini list structure is used as the list end to save RAM.  This is checked and valid. */
+
+	pxList->uxNumberOfItems = ( UBaseType_t ) 0U;
+
+	/* Write known values into the list if
+	configUSE_LIST_DATA_INTEGRITY_CHECK_BYTES is set to 1. */
+	listSET_LIST_INTEGRITY_CHECK_1_VALUE( pxList );
+	listSET_LIST_INTEGRITY_CHECK_2_VALUE( pxList );
+}
+/*-----------------------------------------------------------*/
+
+void vListInitialiseItem( ListItem_t * const pxItem )
+{
+	/* Make sure the list item is not recorded as being on a list. */
+	pxItem->pvContainer = NULL;
+
+	/* Write known values into the list item if
+	configUSE_LIST_DATA_INTEGRITY_CHECK_BYTES is set to 1. */
+	listSET_FIRST_LIST_ITEM_INTEGRITY_CHECK_VALUE( pxItem );
+	listSET_SECOND_LIST_ITEM_INTEGRITY_CHECK_VALUE( pxItem );
+}
+/*-----------------------------------------------------------*/
+
+void vListInsertEnd( List_t * const pxList, ListItem_t * const pxNewListItem )
+{
+ListItem_t * const pxIndex = pxList->pxIndex;
+
+	/* Only effective when configASSERT() is also defined, these tests may catch
+	the list data structures being overwritten in memory.  They will not catch
+	data errors caused by incorrect configuration or use of FreeRTOS. */
+	listTEST_LIST_INTEGRITY( pxList );
+	listTEST_LIST_ITEM_INTEGRITY( pxNewListItem );
+
+	/* Insert a new list item into pxList, but rather than sort the list,
+	makes the new list item the last item to be removed by a call to
+	listGET_OWNER_OF_NEXT_ENTRY(). */
+	pxNewListItem->pxNext = pxIndex;
+	pxNewListItem->pxPrevious = pxIndex->pxPrevious;
+
+	/* Only used during decision coverage testing. */
+	mtCOVERAGE_TEST_DELAY();
+
+	pxIndex->pxPrevious->pxNext = pxNewListItem;
+	pxIndex->pxPrevious = pxNewListItem;
+
+	/* Remember which list the item is in. */
+	pxNewListItem->pvContainer = ( void * ) pxList;
+
+	( pxList->uxNumberOfItems )++;
+}
+/*-----------------------------------------------------------*/
+
+void vListInsert( List_t * const pxList, ListItem_t * const pxNewListItem )
+{
+ListItem_t *pxIterator;
+const TickType_t xValueOfInsertion = pxNewListItem->xItemValue;
+
+	/* Only effective when configASSERT() is also defined, these tests may catch
+	the list data structures being overwritten in memory.  They will not catch
+	data errors caused by incorrect configuration or use of FreeRTOS. */
+	listTEST_LIST_INTEGRITY( pxList );
+	listTEST_LIST_ITEM_INTEGRITY( pxNewListItem );
+
+	/* Insert the new list item into the list, sorted in xItemValue order.
+
+	If the list already contains a list item with the same item value then the
+	new list item should be placed after it.  This ensures that TCB's which are
+	stored in ready lists (all of which have the same xItemValue value) get a
+	share of the CPU.  However, if the xItemValue is the same as the back marker
+	the iteration loop below will not end.  Therefore the value is checked
+	first, and the algorithm slightly modified if necessary. */
+	if( xValueOfInsertion == portMAX_DELAY )
+	{
+		pxIterator = pxList->xListEnd.pxPrevious;
+	}
+	else
+	{
+		/* *** NOTE ***********************************************************
+		If you find your application is crashing here then likely causes are
+		listed below.  In addition see http://www.freertos.org/FAQHelp.html for
+		more tips, and ensure configASSERT() is defined!
+		http://www.freertos.org/a00110.html#configASSERT
+
+			1) Stack overflow -
+			   see http://www.freertos.org/Stacks-and-stack-overflow-checking.html
+			2) Incorrect interrupt priority assignment, especially on Cortex-M
+			   parts where numerically high priority values denote low actual
+			   interrupt priorities, which can seem counter intuitive.  See
+			   http://www.freertos.org/RTOS-Cortex-M3-M4.html and the definition
+			   of configMAX_SYSCALL_INTERRUPT_PRIORITY on
+			   http://www.freertos.org/a00110.html
+			3) Calling an API function from within a critical section or when
+			   the scheduler is suspended, or calling an API function that does
+			   not end in "FromISR" from an interrupt.
+			4) Using a queue or semaphore before it has been initialised or
+			   before the scheduler has been started (are interrupts firing
+			   before vTaskStartScheduler() has been called?).
+		**********************************************************************/
+
+		for( pxIterator = ( ListItem_t * ) &( pxList->xListEnd ); pxIterator->pxNext->xItemValue <= xValueOfInsertion; pxIterator = pxIterator->pxNext ) /*lint !e826 !e740 The mini list structure is used as the list end to save RAM.  This is checked and valid. */
+		{
+			/* There is nothing to do here, just iterating to the wanted
+			insertion position. */
+		}
+	}
+
+	pxNewListItem->pxNext = pxIterator->pxNext;
+	pxNewListItem->pxNext->pxPrevious = pxNewListItem;
+	pxNewListItem->pxPrevious = pxIterator;
+	pxIterator->pxNext = pxNewListItem;
+
+	/* Remember which list the item is in.  This allows fast removal of the
+	item later. */
+	pxNewListItem->pvContainer = ( void * ) pxList;
+
+	( pxList->uxNumberOfItems )++;
+}
+/*-----------------------------------------------------------*/
+
+UBaseType_t uxListRemove( ListItem_t * const pxItemToRemove )
+{
+/* The list item knows which list it is in.  Obtain the list from the list
+item. */
+List_t * const pxList = ( List_t * ) pxItemToRemove->pvContainer;
+
+	pxItemToRemove->pxNext->pxPrevious = pxItemToRemove->pxPrevious;
+	pxItemToRemove->pxPrevious->pxNext = pxItemToRemove->pxNext;
+
+	/* Only used during decision coverage testing. */
+	mtCOVERAGE_TEST_DELAY();
+
+	/* Make sure the index is left pointing to a valid item. */
+	if( pxList->pxIndex == pxItemToRemove )
+	{
+		pxList->pxIndex = pxItemToRemove->pxPrevious;
+	}
+	else
+	{
+		mtCOVERAGE_TEST_MARKER();
+	}
+
+	pxItemToRemove->pvContainer = NULL;
+	( pxList->uxNumberOfItems )--;
+
+	return pxList->uxNumberOfItems;
+}
+/*-----------------------------------------------------------*/
+
diff --git a/FreeRTOS/portable/Keil/See-also-the-RVDS-directory.txt b/FreeRTOS/portable/Keil/See-also-the-RVDS-directory.txt
new file mode 100644
index 0000000..bd7fab7
--- /dev/null
+++ b/FreeRTOS/portable/Keil/See-also-the-RVDS-directory.txt
@@ -0,0 +1 @@
+Nothing to see here.
\ No newline at end of file
diff --git a/FreeRTOS/portable/MemMang/ReadMe.url b/FreeRTOS/portable/MemMang/ReadMe.url
new file mode 100644
index 0000000..6c23737
--- /dev/null
+++ b/FreeRTOS/portable/MemMang/ReadMe.url
@@ -0,0 +1,5 @@
+[{000214A0-0000-0000-C000-000000000046}]
+Prop3=19,2
+[InternetShortcut]
+URL=http://www.freertos.org/a00111.html
+IDList=
diff --git a/FreeRTOS/portable/MemMang/heap_1.c b/FreeRTOS/portable/MemMang/heap_1.c
new file mode 100644
index 0000000..6dfb3cb
--- /dev/null
+++ b/FreeRTOS/portable/MemMang/heap_1.c
@@ -0,0 +1,188 @@
+/*
+    FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd.
+    All rights reserved
+
+    VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION.
+
+    This file is part of the FreeRTOS distribution.
+
+    FreeRTOS is free software; you can redistribute it and/or modify it under
+    the terms of the GNU General Public License (version 2) as published by the
+    Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception.
+
+    ***************************************************************************
+    >>!   NOTE: The modification to the GPL is included to allow you to     !<<
+    >>!   distribute a combined work that includes FreeRTOS without being   !<<
+    >>!   obliged to provide the source code for proprietary components     !<<
+    >>!   outside of the FreeRTOS kernel.                                   !<<
+    ***************************************************************************
+
+    FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY
+    WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+    FOR A PARTICULAR PURPOSE.  Full license text is available on the following
+    link: http://www.freertos.org/a00114.html
+
+    ***************************************************************************
+     *                                                                       *
+     *    FreeRTOS provides completely free yet professionally developed,    *
+     *    robust, strictly quality controlled, supported, and cross          *
+     *    platform software that is more than just the market leader, it     *
+     *    is the industry's de facto standard.                               *
+     *                                                                       *
+     *    Help yourself get started quickly while simultaneously helping     *
+     *    to support the FreeRTOS project by purchasing a FreeRTOS           *
+     *    tutorial book, reference manual, or both:                          *
+     *    http://www.FreeRTOS.org/Documentation                              *
+     *                                                                       *
+    ***************************************************************************
+
+    http://www.FreeRTOS.org/FAQHelp.html - Having a problem?  Start by reading
+    the FAQ page "My application does not run, what could be wrong?".  Have you
+    defined configASSERT()?
+
+    http://www.FreeRTOS.org/support - In return for receiving this top quality
+    embedded software for free we request you assist our global community by
+    participating in the support forum.
+
+    http://www.FreeRTOS.org/training - Investing in training allows your team to
+    be as productive as possible as early as possible.  Now you can receive
+    FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers
+    Ltd, and the world's leading authority on the world's leading RTOS.
+
+    http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products,
+    including FreeRTOS+Trace - an indispensable productivity tool, a DOS
+    compatible FAT file system, and our tiny thread aware UDP/IP stack.
+
+    http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate.
+    Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS.
+
+    http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High
+    Integrity Systems ltd. to sell under the OpenRTOS brand.  Low cost OpenRTOS
+    licenses offer ticketed support, indemnification and commercial middleware.
+
+    http://www.SafeRTOS.com - High Integrity Systems also provide a safety
+    engineered and independently SIL3 certified version for use in safety and
+    mission critical applications that require provable dependability.
+
+    1 tab == 4 spaces!
+*/
+
+
+/*
+ * The simplest possible implementation of pvPortMalloc().  Note that this
+ * implementation does NOT allow allocated memory to be freed again.
+ *
+ * See heap_2.c, heap_3.c and heap_4.c for alternative implementations, and the
+ * memory management pages of http://www.FreeRTOS.org for more information.
+ */
+#include 
+
+/* Defining MPU_WRAPPERS_INCLUDED_FROM_API_FILE prevents task.h from redefining
+all the API functions to use the MPU wrappers.  That should only be done when
+task.h is included from an application file. */
+#define MPU_WRAPPERS_INCLUDED_FROM_API_FILE
+
+#include "FreeRTOS.h"
+#include "task.h"
+
+#undef MPU_WRAPPERS_INCLUDED_FROM_API_FILE
+
+#if( configSUPPORT_DYNAMIC_ALLOCATION == 0 )
+	#error This file must not be used if configSUPPORT_DYNAMIC_ALLOCATION is 0
+#endif
+
+/* A few bytes might be lost to byte aligning the heap start address. */
+#define configADJUSTED_HEAP_SIZE	( configTOTAL_HEAP_SIZE - portBYTE_ALIGNMENT )
+
+/* Allocate the memory for the heap. */
+/* Allocate the memory for the heap. */
+#if( configAPPLICATION_ALLOCATED_HEAP == 1 )
+	/* The application writer has already defined the array used for the RTOS
+	heap - probably so it can be placed in a special segment or address. */
+	extern uint8_t ucHeap[ configTOTAL_HEAP_SIZE ];
+#else
+	static uint8_t ucHeap[ configTOTAL_HEAP_SIZE ];
+#endif /* configAPPLICATION_ALLOCATED_HEAP */
+
+static size_t xNextFreeByte = ( size_t ) 0;
+
+/*-----------------------------------------------------------*/
+
+void *pvPortMalloc( size_t xWantedSize )
+{
+void *pvReturn = NULL;
+static uint8_t *pucAlignedHeap = NULL;
+
+	/* Ensure that blocks are always aligned to the required number of bytes. */
+	#if( portBYTE_ALIGNMENT != 1 )
+	{
+		if( xWantedSize & portBYTE_ALIGNMENT_MASK )
+		{
+			/* Byte alignment required. */
+			xWantedSize += ( portBYTE_ALIGNMENT - ( xWantedSize & portBYTE_ALIGNMENT_MASK ) );
+		}
+	}
+	#endif
+
+	vTaskSuspendAll();
+	{
+		if( pucAlignedHeap == NULL )
+		{
+			/* Ensure the heap starts on a correctly aligned boundary. */
+			pucAlignedHeap = ( uint8_t * ) ( ( ( portPOINTER_SIZE_TYPE ) &ucHeap[ portBYTE_ALIGNMENT ] ) & ( ~( ( portPOINTER_SIZE_TYPE ) portBYTE_ALIGNMENT_MASK ) ) );
+		}
+
+		/* Check there is enough room left for the allocation. */
+		if( ( ( xNextFreeByte + xWantedSize ) < configADJUSTED_HEAP_SIZE ) &&
+			( ( xNextFreeByte + xWantedSize ) > xNextFreeByte )	)/* Check for overflow. */
+		{
+			/* Return the next free byte then increment the index past this
+			block. */
+			pvReturn = pucAlignedHeap + xNextFreeByte;
+			xNextFreeByte += xWantedSize;
+		}
+
+		traceMALLOC( pvReturn, xWantedSize );
+	}
+	( void ) xTaskResumeAll();
+
+	#if( configUSE_MALLOC_FAILED_HOOK == 1 )
+	{
+		if( pvReturn == NULL )
+		{
+			extern void vApplicationMallocFailedHook( void );
+			vApplicationMallocFailedHook();
+		}
+	}
+	#endif
+
+	return pvReturn;
+}
+/*-----------------------------------------------------------*/
+
+void vPortFree( void *pv )
+{
+	/* Memory cannot be freed using this scheme.  See heap_2.c, heap_3.c and
+	heap_4.c for alternative implementations, and the memory management pages of
+	http://www.FreeRTOS.org for more information. */
+	( void ) pv;
+
+	/* Force an assert as it is invalid to call this function. */
+	configASSERT( pv == NULL );
+}
+/*-----------------------------------------------------------*/
+
+void vPortInitialiseBlocks( void )
+{
+	/* Only required when static memory is not cleared. */
+	xNextFreeByte = ( size_t ) 0;
+}
+/*-----------------------------------------------------------*/
+
+size_t xPortGetFreeHeapSize( void )
+{
+	return ( configADJUSTED_HEAP_SIZE - xNextFreeByte );
+}
+
+
+
diff --git a/FreeRTOS/portable/MemMang/heap_2.c b/FreeRTOS/portable/MemMang/heap_2.c
new file mode 100644
index 0000000..bba8554
--- /dev/null
+++ b/FreeRTOS/portable/MemMang/heap_2.c
@@ -0,0 +1,314 @@
+/*
+    FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd.
+    All rights reserved
+
+    VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION.
+
+    This file is part of the FreeRTOS distribution.
+
+    FreeRTOS is free software; you can redistribute it and/or modify it under
+    the terms of the GNU General Public License (version 2) as published by the
+    Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception.
+
+    ***************************************************************************
+    >>!   NOTE: The modification to the GPL is included to allow you to     !<<
+    >>!   distribute a combined work that includes FreeRTOS without being   !<<
+    >>!   obliged to provide the source code for proprietary components     !<<
+    >>!   outside of the FreeRTOS kernel.                                   !<<
+    ***************************************************************************
+
+    FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY
+    WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+    FOR A PARTICULAR PURPOSE.  Full license text is available on the following
+    link: http://www.freertos.org/a00114.html
+
+    ***************************************************************************
+     *                                                                       *
+     *    FreeRTOS provides completely free yet professionally developed,    *
+     *    robust, strictly quality controlled, supported, and cross          *
+     *    platform software that is more than just the market leader, it     *
+     *    is the industry's de facto standard.                               *
+     *                                                                       *
+     *    Help yourself get started quickly while simultaneously helping     *
+     *    to support the FreeRTOS project by purchasing a FreeRTOS           *
+     *    tutorial book, reference manual, or both:                          *
+     *    http://www.FreeRTOS.org/Documentation                              *
+     *                                                                       *
+    ***************************************************************************
+
+    http://www.FreeRTOS.org/FAQHelp.html - Having a problem?  Start by reading
+    the FAQ page "My application does not run, what could be wrong?".  Have you
+    defined configASSERT()?
+
+    http://www.FreeRTOS.org/support - In return for receiving this top quality
+    embedded software for free we request you assist our global community by
+    participating in the support forum.
+
+    http://www.FreeRTOS.org/training - Investing in training allows your team to
+    be as productive as possible as early as possible.  Now you can receive
+    FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers
+    Ltd, and the world's leading authority on the world's leading RTOS.
+
+    http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products,
+    including FreeRTOS+Trace - an indispensable productivity tool, a DOS
+    compatible FAT file system, and our tiny thread aware UDP/IP stack.
+
+    http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate.
+    Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS.
+
+    http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High
+    Integrity Systems ltd. to sell under the OpenRTOS brand.  Low cost OpenRTOS
+    licenses offer ticketed support, indemnification and commercial middleware.
+
+    http://www.SafeRTOS.com - High Integrity Systems also provide a safety
+    engineered and independently SIL3 certified version for use in safety and
+    mission critical applications that require provable dependability.
+
+    1 tab == 4 spaces!
+*/
+
+/*
+ * A sample implementation of pvPortMalloc() and vPortFree() that permits
+ * allocated blocks to be freed, but does not combine adjacent free blocks
+ * into a single larger block (and so will fragment memory).  See heap_4.c for
+ * an equivalent that does combine adjacent blocks into single larger blocks.
+ *
+ * See heap_1.c, heap_3.c and heap_4.c for alternative implementations, and the
+ * memory management pages of http://www.FreeRTOS.org for more information.
+ */
+#include 
+
+/* Defining MPU_WRAPPERS_INCLUDED_FROM_API_FILE prevents task.h from redefining
+all the API functions to use the MPU wrappers.  That should only be done when
+task.h is included from an application file. */
+#define MPU_WRAPPERS_INCLUDED_FROM_API_FILE
+
+#include "FreeRTOS.h"
+#include "task.h"
+
+#undef MPU_WRAPPERS_INCLUDED_FROM_API_FILE
+
+#if( configSUPPORT_DYNAMIC_ALLOCATION == 0 )
+	#error This file must not be used if configSUPPORT_DYNAMIC_ALLOCATION is 0
+#endif
+
+/* A few bytes might be lost to byte aligning the heap start address. */
+#define configADJUSTED_HEAP_SIZE	( configTOTAL_HEAP_SIZE - portBYTE_ALIGNMENT )
+
+/*
+ * Initialises the heap structures before their first use.
+ */
+static void prvHeapInit( void );
+
+/* Allocate the memory for the heap. */
+#if( configAPPLICATION_ALLOCATED_HEAP == 1 )
+	/* The application writer has already defined the array used for the RTOS
+	heap - probably so it can be placed in a special segment or address. */
+	extern uint8_t ucHeap[ configTOTAL_HEAP_SIZE ];
+#else
+	static uint8_t ucHeap[ configTOTAL_HEAP_SIZE ];
+#endif /* configAPPLICATION_ALLOCATED_HEAP */
+
+
+/* Define the linked list structure.  This is used to link free blocks in order
+of their size. */
+typedef struct A_BLOCK_LINK
+{
+	struct A_BLOCK_LINK *pxNextFreeBlock;	/*<< The next free block in the list. */
+	size_t xBlockSize;						/*<< The size of the free block. */
+} BlockLink_t;
+
+
+static const uint16_t heapSTRUCT_SIZE	= ( ( sizeof ( BlockLink_t ) + ( portBYTE_ALIGNMENT - 1 ) ) & ~portBYTE_ALIGNMENT_MASK );
+#define heapMINIMUM_BLOCK_SIZE	( ( size_t ) ( heapSTRUCT_SIZE * 2 ) )
+
+/* Create a couple of list links to mark the start and end of the list. */
+static BlockLink_t xStart, xEnd;
+
+/* Keeps track of the number of free bytes remaining, but says nothing about
+fragmentation. */
+static size_t xFreeBytesRemaining = configADJUSTED_HEAP_SIZE;
+
+/* STATIC FUNCTIONS ARE DEFINED AS MACROS TO MINIMIZE THE FUNCTION CALL DEPTH. */
+
+/*
+ * Insert a block into the list of free blocks - which is ordered by size of
+ * the block.  Small blocks at the start of the list and large blocks at the end
+ * of the list.
+ */
+#define prvInsertBlockIntoFreeList( pxBlockToInsert )								\
+{																					\
+BlockLink_t *pxIterator;															\
+size_t xBlockSize;																	\
+																					\
+	xBlockSize = pxBlockToInsert->xBlockSize;										\
+																					\
+	/* Iterate through the list until a block is found that has a larger size */	\
+	/* than the block we are inserting. */											\
+	for( pxIterator = &xStart; pxIterator->pxNextFreeBlock->xBlockSize < xBlockSize; pxIterator = pxIterator->pxNextFreeBlock )	\
+	{																				\
+		/* There is nothing to do here - just iterate to the correct position. */	\
+	}																				\
+																					\
+	/* Update the list to include the block being inserted in the correct */		\
+	/* position. */																	\
+	pxBlockToInsert->pxNextFreeBlock = pxIterator->pxNextFreeBlock;					\
+	pxIterator->pxNextFreeBlock = pxBlockToInsert;									\
+}
+/*-----------------------------------------------------------*/
+
+void *pvPortMalloc( size_t xWantedSize )
+{
+BlockLink_t *pxBlock, *pxPreviousBlock, *pxNewBlockLink;
+static BaseType_t xHeapHasBeenInitialised = pdFALSE;
+void *pvReturn = NULL;
+
+	vTaskSuspendAll();
+	{
+		/* If this is the first call to malloc then the heap will require
+		initialisation to setup the list of free blocks. */
+		if( xHeapHasBeenInitialised == pdFALSE )
+		{
+			prvHeapInit();
+			xHeapHasBeenInitialised = pdTRUE;
+		}
+
+		/* The wanted size is increased so it can contain a BlockLink_t
+		structure in addition to the requested amount of bytes. */
+		if( xWantedSize > 0 )
+		{
+			xWantedSize += heapSTRUCT_SIZE;
+
+			/* Ensure that blocks are always aligned to the required number of bytes. */
+			if( ( xWantedSize & portBYTE_ALIGNMENT_MASK ) != 0 )
+			{
+				/* Byte alignment required. */
+				xWantedSize += ( portBYTE_ALIGNMENT - ( xWantedSize & portBYTE_ALIGNMENT_MASK ) );
+			}
+		}
+
+		if( ( xWantedSize > 0 ) && ( xWantedSize < configADJUSTED_HEAP_SIZE ) )
+		{
+			/* Blocks are stored in byte order - traverse the list from the start
+			(smallest) block until one of adequate size is found. */
+			pxPreviousBlock = &xStart;
+			pxBlock = xStart.pxNextFreeBlock;
+			while( ( pxBlock->xBlockSize < xWantedSize ) && ( pxBlock->pxNextFreeBlock != NULL ) )
+			{
+				pxPreviousBlock = pxBlock;
+				pxBlock = pxBlock->pxNextFreeBlock;
+			}
+
+			/* If we found the end marker then a block of adequate size was not found. */
+			if( pxBlock != &xEnd )
+			{
+				/* Return the memory space - jumping over the BlockLink_t structure
+				at its start. */
+				pvReturn = ( void * ) ( ( ( uint8_t * ) pxPreviousBlock->pxNextFreeBlock ) + heapSTRUCT_SIZE );
+
+				/* This block is being returned for use so must be taken out of the
+				list of free blocks. */
+				pxPreviousBlock->pxNextFreeBlock = pxBlock->pxNextFreeBlock;
+
+				/* If the block is larger than required it can be split into two. */
+				if( ( pxBlock->xBlockSize - xWantedSize ) > heapMINIMUM_BLOCK_SIZE )
+				{
+					/* This block is to be split into two.  Create a new block
+					following the number of bytes requested. The void cast is
+					used to prevent byte alignment warnings from the compiler. */
+					pxNewBlockLink = ( void * ) ( ( ( uint8_t * ) pxBlock ) + xWantedSize );
+
+					/* Calculate the sizes of two blocks split from the single
+					block. */
+					pxNewBlockLink->xBlockSize = pxBlock->xBlockSize - xWantedSize;
+					pxBlock->xBlockSize = xWantedSize;
+
+					/* Insert the new block into the list of free blocks. */
+					prvInsertBlockIntoFreeList( ( pxNewBlockLink ) );
+				}
+
+				xFreeBytesRemaining -= pxBlock->xBlockSize;
+			}
+		}
+
+		traceMALLOC( pvReturn, xWantedSize );
+	}
+	( void ) xTaskResumeAll();
+
+	#if( configUSE_MALLOC_FAILED_HOOK == 1 )
+	{
+		if( pvReturn == NULL )
+		{
+			extern void vApplicationMallocFailedHook( void );
+			vApplicationMallocFailedHook();
+		}
+	}
+	#endif
+
+	return pvReturn;
+}
+/*-----------------------------------------------------------*/
+
+void vPortFree( void *pv )
+{
+uint8_t *puc = ( uint8_t * ) pv;
+BlockLink_t *pxLink;
+
+	if( pv != NULL )
+	{
+		/* The memory being freed will have an BlockLink_t structure immediately
+		before it. */
+		puc -= heapSTRUCT_SIZE;
+
+		/* This unexpected casting is to keep some compilers from issuing
+		byte alignment warnings. */
+		pxLink = ( void * ) puc;
+
+		vTaskSuspendAll();
+		{
+			/* Add this block to the list of free blocks. */
+			prvInsertBlockIntoFreeList( ( ( BlockLink_t * ) pxLink ) );
+			xFreeBytesRemaining += pxLink->xBlockSize;
+			traceFREE( pv, pxLink->xBlockSize );
+		}
+		( void ) xTaskResumeAll();
+	}
+}
+/*-----------------------------------------------------------*/
+
+size_t xPortGetFreeHeapSize( void )
+{
+	return xFreeBytesRemaining;
+}
+/*-----------------------------------------------------------*/
+
+void vPortInitialiseBlocks( void )
+{
+	/* This just exists to keep the linker quiet. */
+}
+/*-----------------------------------------------------------*/
+
+static void prvHeapInit( void )
+{
+BlockLink_t *pxFirstFreeBlock;
+uint8_t *pucAlignedHeap;
+
+	/* Ensure the heap starts on a correctly aligned boundary. */
+	pucAlignedHeap = ( uint8_t * ) ( ( ( portPOINTER_SIZE_TYPE ) &ucHeap[ portBYTE_ALIGNMENT ] ) & ( ~( ( portPOINTER_SIZE_TYPE ) portBYTE_ALIGNMENT_MASK ) ) );
+
+	/* xStart is used to hold a pointer to the first item in the list of free
+	blocks.  The void cast is used to prevent compiler warnings. */
+	xStart.pxNextFreeBlock = ( void * ) pucAlignedHeap;
+	xStart.xBlockSize = ( size_t ) 0;
+
+	/* xEnd is used to mark the end of the list of free blocks. */
+	xEnd.xBlockSize = configADJUSTED_HEAP_SIZE;
+	xEnd.pxNextFreeBlock = NULL;
+
+	/* To start with there is a single free block that is sized to take up the
+	entire heap space. */
+	pxFirstFreeBlock = ( void * ) pucAlignedHeap;
+	pxFirstFreeBlock->xBlockSize = configADJUSTED_HEAP_SIZE;
+	pxFirstFreeBlock->pxNextFreeBlock = &xEnd;
+}
+/*-----------------------------------------------------------*/
diff --git a/FreeRTOS/portable/MemMang/heap_3.c b/FreeRTOS/portable/MemMang/heap_3.c
new file mode 100644
index 0000000..f922001
--- /dev/null
+++ b/FreeRTOS/portable/MemMang/heap_3.c
@@ -0,0 +1,139 @@
+/*
+    FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd.
+    All rights reserved
+
+    VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION.
+
+    This file is part of the FreeRTOS distribution.
+
+    FreeRTOS is free software; you can redistribute it and/or modify it under
+    the terms of the GNU General Public License (version 2) as published by the
+    Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception.
+
+    ***************************************************************************
+    >>!   NOTE: The modification to the GPL is included to allow you to     !<<
+    >>!   distribute a combined work that includes FreeRTOS without being   !<<
+    >>!   obliged to provide the source code for proprietary components     !<<
+    >>!   outside of the FreeRTOS kernel.                                   !<<
+    ***************************************************************************
+
+    FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY
+    WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+    FOR A PARTICULAR PURPOSE.  Full license text is available on the following
+    link: http://www.freertos.org/a00114.html
+
+    ***************************************************************************
+     *                                                                       *
+     *    FreeRTOS provides completely free yet professionally developed,    *
+     *    robust, strictly quality controlled, supported, and cross          *
+     *    platform software that is more than just the market leader, it     *
+     *    is the industry's de facto standard.                               *
+     *                                                                       *
+     *    Help yourself get started quickly while simultaneously helping     *
+     *    to support the FreeRTOS project by purchasing a FreeRTOS           *
+     *    tutorial book, reference manual, or both:                          *
+     *    http://www.FreeRTOS.org/Documentation                              *
+     *                                                                       *
+    ***************************************************************************
+
+    http://www.FreeRTOS.org/FAQHelp.html - Having a problem?  Start by reading
+    the FAQ page "My application does not run, what could be wrong?".  Have you
+    defined configASSERT()?
+
+    http://www.FreeRTOS.org/support - In return for receiving this top quality
+    embedded software for free we request you assist our global community by
+    participating in the support forum.
+
+    http://www.FreeRTOS.org/training - Investing in training allows your team to
+    be as productive as possible as early as possible.  Now you can receive
+    FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers
+    Ltd, and the world's leading authority on the world's leading RTOS.
+
+    http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products,
+    including FreeRTOS+Trace - an indispensable productivity tool, a DOS
+    compatible FAT file system, and our tiny thread aware UDP/IP stack.
+
+    http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate.
+    Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS.
+
+    http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High
+    Integrity Systems ltd. to sell under the OpenRTOS brand.  Low cost OpenRTOS
+    licenses offer ticketed support, indemnification and commercial middleware.
+
+    http://www.SafeRTOS.com - High Integrity Systems also provide a safety
+    engineered and independently SIL3 certified version for use in safety and
+    mission critical applications that require provable dependability.
+
+    1 tab == 4 spaces!
+*/
+
+
+/*
+ * Implementation of pvPortMalloc() and vPortFree() that relies on the
+ * compilers own malloc() and free() implementations.
+ *
+ * This file can only be used if the linker is configured to to generate
+ * a heap memory area.
+ *
+ * See heap_1.c, heap_2.c and heap_4.c for alternative implementations, and the
+ * memory management pages of http://www.FreeRTOS.org for more information.
+ */
+
+#include 
+
+/* Defining MPU_WRAPPERS_INCLUDED_FROM_API_FILE prevents task.h from redefining
+all the API functions to use the MPU wrappers.  That should only be done when
+task.h is included from an application file. */
+#define MPU_WRAPPERS_INCLUDED_FROM_API_FILE
+
+#include "FreeRTOS.h"
+#include "task.h"
+
+#undef MPU_WRAPPERS_INCLUDED_FROM_API_FILE
+
+#if( configSUPPORT_DYNAMIC_ALLOCATION == 0 )
+	#error This file must not be used if configSUPPORT_DYNAMIC_ALLOCATION is 0
+#endif
+
+/*-----------------------------------------------------------*/
+
+void *pvPortMalloc( size_t xWantedSize )
+{
+void *pvReturn;
+
+	vTaskSuspendAll();
+	{
+		pvReturn = malloc( xWantedSize );
+		traceMALLOC( pvReturn, xWantedSize );
+	}
+	( void ) xTaskResumeAll();
+
+	#if( configUSE_MALLOC_FAILED_HOOK == 1 )
+	{
+		if( pvReturn == NULL )
+		{
+			extern void vApplicationMallocFailedHook( void );
+			vApplicationMallocFailedHook();
+		}
+	}
+	#endif
+
+	return pvReturn;
+}
+/*-----------------------------------------------------------*/
+
+void vPortFree( void *pv )
+{
+	if( pv )
+	{
+		vTaskSuspendAll();
+		{
+			free( pv );
+			traceFREE( pv, 0 );
+		}
+		( void ) xTaskResumeAll();
+	}
+}
+
+
+
diff --git a/FreeRTOS/portable/MemMang/heap_4.c b/FreeRTOS/portable/MemMang/heap_4.c
new file mode 100644
index 0000000..e7c7ade
--- /dev/null
+++ b/FreeRTOS/portable/MemMang/heap_4.c
@@ -0,0 +1,478 @@
+/*
+    FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd.
+    All rights reserved
+
+    VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION.
+
+    This file is part of the FreeRTOS distribution.
+
+    FreeRTOS is free software; you can redistribute it and/or modify it under
+    the terms of the GNU General Public License (version 2) as published by the
+    Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception.
+
+    ***************************************************************************
+    >>!   NOTE: The modification to the GPL is included to allow you to     !<<
+    >>!   distribute a combined work that includes FreeRTOS without being   !<<
+    >>!   obliged to provide the source code for proprietary components     !<<
+    >>!   outside of the FreeRTOS kernel.                                   !<<
+    ***************************************************************************
+
+    FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY
+    WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+    FOR A PARTICULAR PURPOSE.  Full license text is available on the following
+    link: http://www.freertos.org/a00114.html
+
+    ***************************************************************************
+     *                                                                       *
+     *    FreeRTOS provides completely free yet professionally developed,    *
+     *    robust, strictly quality controlled, supported, and cross          *
+     *    platform software that is more than just the market leader, it     *
+     *    is the industry's de facto standard.                               *
+     *                                                                       *
+     *    Help yourself get started quickly while simultaneously helping     *
+     *    to support the FreeRTOS project by purchasing a FreeRTOS           *
+     *    tutorial book, reference manual, or both:                          *
+     *    http://www.FreeRTOS.org/Documentation                              *
+     *                                                                       *
+    ***************************************************************************
+
+    http://www.FreeRTOS.org/FAQHelp.html - Having a problem?  Start by reading
+    the FAQ page "My application does not run, what could be wrong?".  Have you
+    defined configASSERT()?
+
+    http://www.FreeRTOS.org/support - In return for receiving this top quality
+    embedded software for free we request you assist our global community by
+    participating in the support forum.
+
+    http://www.FreeRTOS.org/training - Investing in training allows your team to
+    be as productive as possible as early as possible.  Now you can receive
+    FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers
+    Ltd, and the world's leading authority on the world's leading RTOS.
+
+    http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products,
+    including FreeRTOS+Trace - an indispensable productivity tool, a DOS
+    compatible FAT file system, and our tiny thread aware UDP/IP stack.
+
+    http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate.
+    Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS.
+
+    http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High
+    Integrity Systems ltd. to sell under the OpenRTOS brand.  Low cost OpenRTOS
+    licenses offer ticketed support, indemnification and commercial middleware.
+
+    http://www.SafeRTOS.com - High Integrity Systems also provide a safety
+    engineered and independently SIL3 certified version for use in safety and
+    mission critical applications that require provable dependability.
+
+    1 tab == 4 spaces!
+*/
+
+/*
+ * A sample implementation of pvPortMalloc() and vPortFree() that combines
+ * (coalescences) adjacent memory blocks as they are freed, and in so doing
+ * limits memory fragmentation.
+ *
+ * See heap_1.c, heap_2.c and heap_3.c for alternative implementations, and the
+ * memory management pages of http://www.FreeRTOS.org for more information.
+ */
+#include 
+
+/* Defining MPU_WRAPPERS_INCLUDED_FROM_API_FILE prevents task.h from redefining
+all the API functions to use the MPU wrappers.  That should only be done when
+task.h is included from an application file. */
+#define MPU_WRAPPERS_INCLUDED_FROM_API_FILE
+
+#include "FreeRTOS.h"
+#include "task.h"
+
+#undef MPU_WRAPPERS_INCLUDED_FROM_API_FILE
+
+#if( configSUPPORT_DYNAMIC_ALLOCATION == 0 )
+	#error This file must not be used if configSUPPORT_DYNAMIC_ALLOCATION is 0
+#endif
+
+/* Block sizes must not get too small. */
+#define heapMINIMUM_BLOCK_SIZE	( ( size_t ) ( xHeapStructSize << 1 ) )
+
+/* Assumes 8bit bytes! */
+#define heapBITS_PER_BYTE		( ( size_t ) 8 )
+
+/* Allocate the memory for the heap. */
+#if( configAPPLICATION_ALLOCATED_HEAP == 1 )
+	/* The application writer has already defined the array used for the RTOS
+	heap - probably so it can be placed in a special segment or address. */
+	extern uint8_t ucHeap[ configTOTAL_HEAP_SIZE ];
+#else
+	static uint8_t ucHeap[ configTOTAL_HEAP_SIZE ];
+#endif /* configAPPLICATION_ALLOCATED_HEAP */
+
+/* Define the linked list structure.  This is used to link free blocks in order
+of their memory address. */
+typedef struct A_BLOCK_LINK
+{
+	struct A_BLOCK_LINK *pxNextFreeBlock;	/*<< The next free block in the list. */
+	size_t xBlockSize;						/*<< The size of the free block. */
+} BlockLink_t;
+
+/*-----------------------------------------------------------*/
+
+/*
+ * Inserts a block of memory that is being freed into the correct position in
+ * the list of free memory blocks.  The block being freed will be merged with
+ * the block in front it and/or the block behind it if the memory blocks are
+ * adjacent to each other.
+ */
+static void prvInsertBlockIntoFreeList( BlockLink_t *pxBlockToInsert );
+
+/*
+ * Called automatically to setup the required heap structures the first time
+ * pvPortMalloc() is called.
+ */
+static void prvHeapInit( void );
+
+/*-----------------------------------------------------------*/
+
+/* The size of the structure placed at the beginning of each allocated memory
+block must by correctly byte aligned. */
+static const size_t xHeapStructSize	= ( sizeof( BlockLink_t ) + ( ( size_t ) ( portBYTE_ALIGNMENT - 1 ) ) ) & ~( ( size_t ) portBYTE_ALIGNMENT_MASK );
+
+/* Create a couple of list links to mark the start and end of the list. */
+static BlockLink_t xStart, *pxEnd = NULL;
+
+/* Keeps track of the number of free bytes remaining, but says nothing about
+fragmentation. */
+static size_t xFreeBytesRemaining = 0U;
+static size_t xMinimumEverFreeBytesRemaining = 0U;
+
+/* Gets set to the top bit of an size_t type.  When this bit in the xBlockSize
+member of an BlockLink_t structure is set then the block belongs to the
+application.  When the bit is free the block is still part of the free heap
+space. */
+static size_t xBlockAllocatedBit = 0;
+
+/*-----------------------------------------------------------*/
+
+void *pvPortMalloc( size_t xWantedSize )
+{
+BlockLink_t *pxBlock, *pxPreviousBlock, *pxNewBlockLink;
+void *pvReturn = NULL;
+
+	vTaskSuspendAll();
+	{
+		/* If this is the first call to malloc then the heap will require
+		initialisation to setup the list of free blocks. */
+		if( pxEnd == NULL )
+		{
+			prvHeapInit();
+		}
+		else
+		{
+			mtCOVERAGE_TEST_MARKER();
+		}
+
+		/* Check the requested block size is not so large that the top bit is
+		set.  The top bit of the block size member of the BlockLink_t structure
+		is used to determine who owns the block - the application or the
+		kernel, so it must be free. */
+		if( ( xWantedSize & xBlockAllocatedBit ) == 0 )
+		{
+			/* The wanted size is increased so it can contain a BlockLink_t
+			structure in addition to the requested amount of bytes. */
+			if( xWantedSize > 0 )
+			{
+				xWantedSize += xHeapStructSize;
+
+				/* Ensure that blocks are always aligned to the required number
+				of bytes. */
+				if( ( xWantedSize & portBYTE_ALIGNMENT_MASK ) != 0x00 )
+				{
+					/* Byte alignment required. */
+					xWantedSize += ( portBYTE_ALIGNMENT - ( xWantedSize & portBYTE_ALIGNMENT_MASK ) );
+					configASSERT( ( xWantedSize & portBYTE_ALIGNMENT_MASK ) == 0 );
+				}
+				else
+				{
+					mtCOVERAGE_TEST_MARKER();
+				}
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+
+			if( ( xWantedSize > 0 ) && ( xWantedSize <= xFreeBytesRemaining ) )
+			{
+				/* Traverse the list from the start	(lowest address) block until
+				one	of adequate size is found. */
+				pxPreviousBlock = &xStart;
+				pxBlock = xStart.pxNextFreeBlock;
+				while( ( pxBlock->xBlockSize < xWantedSize ) && ( pxBlock->pxNextFreeBlock != NULL ) )
+				{
+					pxPreviousBlock = pxBlock;
+					pxBlock = pxBlock->pxNextFreeBlock;
+				}
+
+				/* If the end marker was reached then a block of adequate size
+				was	not found. */
+				if( pxBlock != pxEnd )
+				{
+					/* Return the memory space pointed to - jumping over the
+					BlockLink_t structure at its start. */
+					pvReturn = ( void * ) ( ( ( uint8_t * ) pxPreviousBlock->pxNextFreeBlock ) + xHeapStructSize );
+
+					/* This block is being returned for use so must be taken out
+					of the list of free blocks. */
+					pxPreviousBlock->pxNextFreeBlock = pxBlock->pxNextFreeBlock;
+
+					/* If the block is larger than required it can be split into
+					two. */
+					if( ( pxBlock->xBlockSize - xWantedSize ) > heapMINIMUM_BLOCK_SIZE )
+					{
+						/* This block is to be split into two.  Create a new
+						block following the number of bytes requested. The void
+						cast is used to prevent byte alignment warnings from the
+						compiler. */
+						pxNewBlockLink = ( void * ) ( ( ( uint8_t * ) pxBlock ) + xWantedSize );
+						configASSERT( ( ( ( size_t ) pxNewBlockLink ) & portBYTE_ALIGNMENT_MASK ) == 0 );
+
+						/* Calculate the sizes of two blocks split from the
+						single block. */
+						pxNewBlockLink->xBlockSize = pxBlock->xBlockSize - xWantedSize;
+						pxBlock->xBlockSize = xWantedSize;
+
+						/* Insert the new block into the list of free blocks. */
+						prvInsertBlockIntoFreeList( pxNewBlockLink );
+					}
+					else
+					{
+						mtCOVERAGE_TEST_MARKER();
+					}
+
+					xFreeBytesRemaining -= pxBlock->xBlockSize;
+
+					if( xFreeBytesRemaining < xMinimumEverFreeBytesRemaining )
+					{
+						xMinimumEverFreeBytesRemaining = xFreeBytesRemaining;
+					}
+					else
+					{
+						mtCOVERAGE_TEST_MARKER();
+					}
+
+					/* The block is being returned - it is allocated and owned
+					by the application and has no "next" block. */
+					pxBlock->xBlockSize |= xBlockAllocatedBit;
+					pxBlock->pxNextFreeBlock = NULL;
+				}
+				else
+				{
+					mtCOVERAGE_TEST_MARKER();
+				}
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+		}
+		else
+		{
+			mtCOVERAGE_TEST_MARKER();
+		}
+
+		traceMALLOC( pvReturn, xWantedSize );
+	}
+	( void ) xTaskResumeAll();
+
+	#if( configUSE_MALLOC_FAILED_HOOK == 1 )
+	{
+		if( pvReturn == NULL )
+		{
+			extern void vApplicationMallocFailedHook( void );
+			vApplicationMallocFailedHook();
+		}
+		else
+		{
+			mtCOVERAGE_TEST_MARKER();
+		}
+	}
+	#endif
+
+	configASSERT( ( ( ( size_t ) pvReturn ) & ( size_t ) portBYTE_ALIGNMENT_MASK ) == 0 );
+	return pvReturn;
+}
+/*-----------------------------------------------------------*/
+
+void vPortFree( void *pv )
+{
+uint8_t *puc = ( uint8_t * ) pv;
+BlockLink_t *pxLink;
+
+	if( pv != NULL )
+	{
+		/* The memory being freed will have an BlockLink_t structure immediately
+		before it. */
+		puc -= xHeapStructSize;
+
+		/* This casting is to keep the compiler from issuing warnings. */
+		pxLink = ( void * ) puc;
+
+		/* Check the block is actually allocated. */
+		configASSERT( ( pxLink->xBlockSize & xBlockAllocatedBit ) != 0 );
+		configASSERT( pxLink->pxNextFreeBlock == NULL );
+
+		if( ( pxLink->xBlockSize & xBlockAllocatedBit ) != 0 )
+		{
+			if( pxLink->pxNextFreeBlock == NULL )
+			{
+				/* The block is being returned to the heap - it is no longer
+				allocated. */
+				pxLink->xBlockSize &= ~xBlockAllocatedBit;
+
+				vTaskSuspendAll();
+				{
+					/* Add this block to the list of free blocks. */
+					xFreeBytesRemaining += pxLink->xBlockSize;
+					traceFREE( pv, pxLink->xBlockSize );
+					prvInsertBlockIntoFreeList( ( ( BlockLink_t * ) pxLink ) );
+				}
+				( void ) xTaskResumeAll();
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+		}
+		else
+		{
+			mtCOVERAGE_TEST_MARKER();
+		}
+	}
+}
+/*-----------------------------------------------------------*/
+
+size_t xPortGetFreeHeapSize( void )
+{
+	return xFreeBytesRemaining;
+}
+/*-----------------------------------------------------------*/
+
+size_t xPortGetMinimumEverFreeHeapSize( void )
+{
+	return xMinimumEverFreeBytesRemaining;
+}
+/*-----------------------------------------------------------*/
+
+void vPortInitialiseBlocks( void )
+{
+	/* This just exists to keep the linker quiet. */
+}
+/*-----------------------------------------------------------*/
+
+static void prvHeapInit( void )
+{
+BlockLink_t *pxFirstFreeBlock;
+uint8_t *pucAlignedHeap;
+size_t uxAddress;
+size_t xTotalHeapSize = configTOTAL_HEAP_SIZE;
+
+	/* Ensure the heap starts on a correctly aligned boundary. */
+	uxAddress = ( size_t ) ucHeap;
+
+	if( ( uxAddress & portBYTE_ALIGNMENT_MASK ) != 0 )
+	{
+		uxAddress += ( portBYTE_ALIGNMENT - 1 );
+		uxAddress &= ~( ( size_t ) portBYTE_ALIGNMENT_MASK );
+		xTotalHeapSize -= uxAddress - ( size_t ) ucHeap;
+	}
+
+	pucAlignedHeap = ( uint8_t * ) uxAddress;
+
+	/* xStart is used to hold a pointer to the first item in the list of free
+	blocks.  The void cast is used to prevent compiler warnings. */
+	xStart.pxNextFreeBlock = ( void * ) pucAlignedHeap;
+	xStart.xBlockSize = ( size_t ) 0;
+
+	/* pxEnd is used to mark the end of the list of free blocks and is inserted
+	at the end of the heap space. */
+	uxAddress = ( ( size_t ) pucAlignedHeap ) + xTotalHeapSize;
+	uxAddress -= xHeapStructSize;
+	uxAddress &= ~( ( size_t ) portBYTE_ALIGNMENT_MASK );
+	pxEnd = ( void * ) uxAddress;
+	pxEnd->xBlockSize = 0;
+	pxEnd->pxNextFreeBlock = NULL;
+
+	/* To start with there is a single free block that is sized to take up the
+	entire heap space, minus the space taken by pxEnd. */
+	pxFirstFreeBlock = ( void * ) pucAlignedHeap;
+	pxFirstFreeBlock->xBlockSize = uxAddress - ( size_t ) pxFirstFreeBlock;
+	pxFirstFreeBlock->pxNextFreeBlock = pxEnd;
+
+	/* Only one block exists - and it covers the entire usable heap space. */
+	xMinimumEverFreeBytesRemaining = pxFirstFreeBlock->xBlockSize;
+	xFreeBytesRemaining = pxFirstFreeBlock->xBlockSize;
+
+	/* Work out the position of the top bit in a size_t variable. */
+	xBlockAllocatedBit = ( ( size_t ) 1 ) << ( ( sizeof( size_t ) * heapBITS_PER_BYTE ) - 1 );
+}
+/*-----------------------------------------------------------*/
+
+static void prvInsertBlockIntoFreeList( BlockLink_t *pxBlockToInsert )
+{
+BlockLink_t *pxIterator;
+uint8_t *puc;
+
+	/* Iterate through the list until a block is found that has a higher address
+	than the block being inserted. */
+	for( pxIterator = &xStart; pxIterator->pxNextFreeBlock < pxBlockToInsert; pxIterator = pxIterator->pxNextFreeBlock )
+	{
+		/* Nothing to do here, just iterate to the right position. */
+	}
+
+	/* Do the block being inserted, and the block it is being inserted after
+	make a contiguous block of memory? */
+	puc = ( uint8_t * ) pxIterator;
+	if( ( puc + pxIterator->xBlockSize ) == ( uint8_t * ) pxBlockToInsert )
+	{
+		pxIterator->xBlockSize += pxBlockToInsert->xBlockSize;
+		pxBlockToInsert = pxIterator;
+	}
+	else
+	{
+		mtCOVERAGE_TEST_MARKER();
+	}
+
+	/* Do the block being inserted, and the block it is being inserted before
+	make a contiguous block of memory? */
+	puc = ( uint8_t * ) pxBlockToInsert;
+	if( ( puc + pxBlockToInsert->xBlockSize ) == ( uint8_t * ) pxIterator->pxNextFreeBlock )
+	{
+		if( pxIterator->pxNextFreeBlock != pxEnd )
+		{
+			/* Form one big block from the two blocks. */
+			pxBlockToInsert->xBlockSize += pxIterator->pxNextFreeBlock->xBlockSize;
+			pxBlockToInsert->pxNextFreeBlock = pxIterator->pxNextFreeBlock->pxNextFreeBlock;
+		}
+		else
+		{
+			pxBlockToInsert->pxNextFreeBlock = pxEnd;
+		}
+	}
+	else
+	{
+		pxBlockToInsert->pxNextFreeBlock = pxIterator->pxNextFreeBlock;
+	}
+
+	/* If the block being inserted plugged a gab, so was merged with the block
+	before and the block after, then it's pxNextFreeBlock pointer will have
+	already been set, and should not be set here as that would make it point
+	to itself. */
+	if( pxIterator != pxBlockToInsert )
+	{
+		pxIterator->pxNextFreeBlock = pxBlockToInsert;
+	}
+	else
+	{
+		mtCOVERAGE_TEST_MARKER();
+	}
+}
+
diff --git a/FreeRTOS/portable/MemMang/heap_5.c b/FreeRTOS/portable/MemMang/heap_5.c
new file mode 100644
index 0000000..d53e41e
--- /dev/null
+++ b/FreeRTOS/portable/MemMang/heap_5.c
@@ -0,0 +1,527 @@
+/*
+    FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd.
+    All rights reserved
+
+    VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION.
+
+    This file is part of the FreeRTOS distribution.
+
+    FreeRTOS is free software; you can redistribute it and/or modify it under
+    the terms of the GNU General Public License (version 2) as published by the
+    Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception.
+
+    ***************************************************************************
+    >>!   NOTE: The modification to the GPL is included to allow you to     !<<
+    >>!   distribute a combined work that includes FreeRTOS without being   !<<
+    >>!   obliged to provide the source code for proprietary components     !<<
+    >>!   outside of the FreeRTOS kernel.                                   !<<
+    ***************************************************************************
+
+    FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY
+    WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+    FOR A PARTICULAR PURPOSE.  Full license text is available on the following
+    link: http://www.freertos.org/a00114.html
+
+    ***************************************************************************
+     *                                                                       *
+     *    FreeRTOS provides completely free yet professionally developed,    *
+     *    robust, strictly quality controlled, supported, and cross          *
+     *    platform software that is more than just the market leader, it     *
+     *    is the industry's de facto standard.                               *
+     *                                                                       *
+     *    Help yourself get started quickly while simultaneously helping     *
+     *    to support the FreeRTOS project by purchasing a FreeRTOS           *
+     *    tutorial book, reference manual, or both:                          *
+     *    http://www.FreeRTOS.org/Documentation                              *
+     *                                                                       *
+    ***************************************************************************
+
+    http://www.FreeRTOS.org/FAQHelp.html - Having a problem?  Start by reading
+    the FAQ page "My application does not run, what could be wrong?".  Have you
+    defined configASSERT()?
+
+    http://www.FreeRTOS.org/support - In return for receiving this top quality
+    embedded software for free we request you assist our global community by
+    participating in the support forum.
+
+    http://www.FreeRTOS.org/training - Investing in training allows your team to
+    be as productive as possible as early as possible.  Now you can receive
+    FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers
+    Ltd, and the world's leading authority on the world's leading RTOS.
+
+    http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products,
+    including FreeRTOS+Trace - an indispensable productivity tool, a DOS
+    compatible FAT file system, and our tiny thread aware UDP/IP stack.
+
+    http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate.
+    Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS.
+
+    http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High
+    Integrity Systems ltd. to sell under the OpenRTOS brand.  Low cost OpenRTOS
+    licenses offer ticketed support, indemnification and commercial middleware.
+
+    http://www.SafeRTOS.com - High Integrity Systems also provide a safety
+    engineered and independently SIL3 certified version for use in safety and
+    mission critical applications that require provable dependability.
+
+    1 tab == 4 spaces!
+*/
+
+/*
+ * A sample implementation of pvPortMalloc() that allows the heap to be defined
+ * across multiple non-contigous blocks and combines (coalescences) adjacent
+ * memory blocks as they are freed.
+ *
+ * See heap_1.c, heap_2.c, heap_3.c and heap_4.c for alternative
+ * implementations, and the memory management pages of http://www.FreeRTOS.org
+ * for more information.
+ *
+ * Usage notes:
+ *
+ * vPortDefineHeapRegions() ***must*** be called before pvPortMalloc().
+ * pvPortMalloc() will be called if any task objects (tasks, queues, event
+ * groups, etc.) are created, therefore vPortDefineHeapRegions() ***must*** be
+ * called before any other objects are defined.
+ *
+ * vPortDefineHeapRegions() takes a single parameter.  The parameter is an array
+ * of HeapRegion_t structures.  HeapRegion_t is defined in portable.h as
+ *
+ * typedef struct HeapRegion
+ * {
+ *	uint8_t *pucStartAddress; << Start address of a block of memory that will be part of the heap.
+ *	size_t xSizeInBytes;	  << Size of the block of memory.
+ * } HeapRegion_t;
+ *
+ * The array is terminated using a NULL zero sized region definition, and the
+ * memory regions defined in the array ***must*** appear in address order from
+ * low address to high address.  So the following is a valid example of how
+ * to use the function.
+ *
+ * HeapRegion_t xHeapRegions[] =
+ * {
+ * 	{ ( uint8_t * ) 0x80000000UL, 0x10000 }, << Defines a block of 0x10000 bytes starting at address 0x80000000
+ * 	{ ( uint8_t * ) 0x90000000UL, 0xa0000 }, << Defines a block of 0xa0000 bytes starting at address of 0x90000000
+ * 	{ NULL, 0 }                << Terminates the array.
+ * };
+ *
+ * vPortDefineHeapRegions( xHeapRegions ); << Pass the array into vPortDefineHeapRegions().
+ *
+ * Note 0x80000000 is the lower address so appears in the array first.
+ *
+ */
+#include 
+
+/* Defining MPU_WRAPPERS_INCLUDED_FROM_API_FILE prevents task.h from redefining
+all the API functions to use the MPU wrappers.  That should only be done when
+task.h is included from an application file. */
+#define MPU_WRAPPERS_INCLUDED_FROM_API_FILE
+
+#include "FreeRTOS.h"
+#include "task.h"
+
+#undef MPU_WRAPPERS_INCLUDED_FROM_API_FILE
+
+#if( configSUPPORT_DYNAMIC_ALLOCATION == 0 )
+	#error This file must not be used if configSUPPORT_DYNAMIC_ALLOCATION is 0
+#endif
+
+/* Block sizes must not get too small. */
+#define heapMINIMUM_BLOCK_SIZE	( ( size_t ) ( xHeapStructSize << 1 ) )
+
+/* Assumes 8bit bytes! */
+#define heapBITS_PER_BYTE		( ( size_t ) 8 )
+
+/* Define the linked list structure.  This is used to link free blocks in order
+of their memory address. */
+typedef struct A_BLOCK_LINK
+{
+	struct A_BLOCK_LINK *pxNextFreeBlock;	/*<< The next free block in the list. */
+	size_t xBlockSize;						/*<< The size of the free block. */
+} BlockLink_t;
+
+/*-----------------------------------------------------------*/
+
+/*
+ * Inserts a block of memory that is being freed into the correct position in
+ * the list of free memory blocks.  The block being freed will be merged with
+ * the block in front it and/or the block behind it if the memory blocks are
+ * adjacent to each other.
+ */
+static void prvInsertBlockIntoFreeList( BlockLink_t *pxBlockToInsert );
+
+/*-----------------------------------------------------------*/
+
+/* The size of the structure placed at the beginning of each allocated memory
+block must by correctly byte aligned. */
+static const size_t xHeapStructSize	= ( sizeof( BlockLink_t ) + ( ( size_t ) ( portBYTE_ALIGNMENT - 1 ) ) ) & ~( ( size_t ) portBYTE_ALIGNMENT_MASK );
+
+/* Create a couple of list links to mark the start and end of the list. */
+static BlockLink_t xStart, *pxEnd = NULL;
+
+/* Keeps track of the number of free bytes remaining, but says nothing about
+fragmentation. */
+static size_t xFreeBytesRemaining = 0U;
+static size_t xMinimumEverFreeBytesRemaining = 0U;
+
+/* Gets set to the top bit of an size_t type.  When this bit in the xBlockSize
+member of an BlockLink_t structure is set then the block belongs to the
+application.  When the bit is free the block is still part of the free heap
+space. */
+static size_t xBlockAllocatedBit = 0;
+
+/*-----------------------------------------------------------*/
+
+void *pvPortMalloc( size_t xWantedSize )
+{
+BlockLink_t *pxBlock, *pxPreviousBlock, *pxNewBlockLink;
+void *pvReturn = NULL;
+
+	/* The heap must be initialised before the first call to
+	prvPortMalloc(). */
+	configASSERT( pxEnd );
+
+	vTaskSuspendAll();
+	{
+		/* Check the requested block size is not so large that the top bit is
+		set.  The top bit of the block size member of the BlockLink_t structure
+		is used to determine who owns the block - the application or the
+		kernel, so it must be free. */
+		if( ( xWantedSize & xBlockAllocatedBit ) == 0 )
+		{
+			/* The wanted size is increased so it can contain a BlockLink_t
+			structure in addition to the requested amount of bytes. */
+			if( xWantedSize > 0 )
+			{
+				xWantedSize += xHeapStructSize;
+
+				/* Ensure that blocks are always aligned to the required number
+				of bytes. */
+				if( ( xWantedSize & portBYTE_ALIGNMENT_MASK ) != 0x00 )
+				{
+					/* Byte alignment required. */
+					xWantedSize += ( portBYTE_ALIGNMENT - ( xWantedSize & portBYTE_ALIGNMENT_MASK ) );
+				}
+				else
+				{
+					mtCOVERAGE_TEST_MARKER();
+				}
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+
+			if( ( xWantedSize > 0 ) && ( xWantedSize <= xFreeBytesRemaining ) )
+			{
+				/* Traverse the list from the start	(lowest address) block until
+				one	of adequate size is found. */
+				pxPreviousBlock = &xStart;
+				pxBlock = xStart.pxNextFreeBlock;
+				while( ( pxBlock->xBlockSize < xWantedSize ) && ( pxBlock->pxNextFreeBlock != NULL ) )
+				{
+					pxPreviousBlock = pxBlock;
+					pxBlock = pxBlock->pxNextFreeBlock;
+				}
+
+				/* If the end marker was reached then a block of adequate size
+				was	not found. */
+				if( pxBlock != pxEnd )
+				{
+					/* Return the memory space pointed to - jumping over the
+					BlockLink_t structure at its start. */
+					pvReturn = ( void * ) ( ( ( uint8_t * ) pxPreviousBlock->pxNextFreeBlock ) + xHeapStructSize );
+
+					/* This block is being returned for use so must be taken out
+					of the list of free blocks. */
+					pxPreviousBlock->pxNextFreeBlock = pxBlock->pxNextFreeBlock;
+
+					/* If the block is larger than required it can be split into
+					two. */
+					if( ( pxBlock->xBlockSize - xWantedSize ) > heapMINIMUM_BLOCK_SIZE )
+					{
+						/* This block is to be split into two.  Create a new
+						block following the number of bytes requested. The void
+						cast is used to prevent byte alignment warnings from the
+						compiler. */
+						pxNewBlockLink = ( void * ) ( ( ( uint8_t * ) pxBlock ) + xWantedSize );
+
+						/* Calculate the sizes of two blocks split from the
+						single block. */
+						pxNewBlockLink->xBlockSize = pxBlock->xBlockSize - xWantedSize;
+						pxBlock->xBlockSize = xWantedSize;
+
+						/* Insert the new block into the list of free blocks. */
+						prvInsertBlockIntoFreeList( ( pxNewBlockLink ) );
+					}
+					else
+					{
+						mtCOVERAGE_TEST_MARKER();
+					}
+
+					xFreeBytesRemaining -= pxBlock->xBlockSize;
+
+					if( xFreeBytesRemaining < xMinimumEverFreeBytesRemaining )
+					{
+						xMinimumEverFreeBytesRemaining = xFreeBytesRemaining;
+					}
+					else
+					{
+						mtCOVERAGE_TEST_MARKER();
+					}
+
+					/* The block is being returned - it is allocated and owned
+					by the application and has no "next" block. */
+					pxBlock->xBlockSize |= xBlockAllocatedBit;
+					pxBlock->pxNextFreeBlock = NULL;
+				}
+				else
+				{
+					mtCOVERAGE_TEST_MARKER();
+				}
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+		}
+		else
+		{
+			mtCOVERAGE_TEST_MARKER();
+		}
+
+		traceMALLOC( pvReturn, xWantedSize );
+	}
+	( void ) xTaskResumeAll();
+
+	#if( configUSE_MALLOC_FAILED_HOOK == 1 )
+	{
+		if( pvReturn == NULL )
+		{
+			extern void vApplicationMallocFailedHook( void );
+			vApplicationMallocFailedHook();
+		}
+		else
+		{
+			mtCOVERAGE_TEST_MARKER();
+		}
+	}
+	#endif
+
+	return pvReturn;
+}
+/*-----------------------------------------------------------*/
+
+void vPortFree( void *pv )
+{
+uint8_t *puc = ( uint8_t * ) pv;
+BlockLink_t *pxLink;
+
+	if( pv != NULL )
+	{
+		/* The memory being freed will have an BlockLink_t structure immediately
+		before it. */
+		puc -= xHeapStructSize;
+
+		/* This casting is to keep the compiler from issuing warnings. */
+		pxLink = ( void * ) puc;
+
+		/* Check the block is actually allocated. */
+		configASSERT( ( pxLink->xBlockSize & xBlockAllocatedBit ) != 0 );
+		configASSERT( pxLink->pxNextFreeBlock == NULL );
+
+		if( ( pxLink->xBlockSize & xBlockAllocatedBit ) != 0 )
+		{
+			if( pxLink->pxNextFreeBlock == NULL )
+			{
+				/* The block is being returned to the heap - it is no longer
+				allocated. */
+				pxLink->xBlockSize &= ~xBlockAllocatedBit;
+
+				vTaskSuspendAll();
+				{
+					/* Add this block to the list of free blocks. */
+					xFreeBytesRemaining += pxLink->xBlockSize;
+					traceFREE( pv, pxLink->xBlockSize );
+					prvInsertBlockIntoFreeList( ( ( BlockLink_t * ) pxLink ) );
+				}
+				( void ) xTaskResumeAll();
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+		}
+		else
+		{
+			mtCOVERAGE_TEST_MARKER();
+		}
+	}
+}
+/*-----------------------------------------------------------*/
+
+size_t xPortGetFreeHeapSize( void )
+{
+	return xFreeBytesRemaining;
+}
+/*-----------------------------------------------------------*/
+
+size_t xPortGetMinimumEverFreeHeapSize( void )
+{
+	return xMinimumEverFreeBytesRemaining;
+}
+/*-----------------------------------------------------------*/
+
+static void prvInsertBlockIntoFreeList( BlockLink_t *pxBlockToInsert )
+{
+BlockLink_t *pxIterator;
+uint8_t *puc;
+
+	/* Iterate through the list until a block is found that has a higher address
+	than the block being inserted. */
+	for( pxIterator = &xStart; pxIterator->pxNextFreeBlock < pxBlockToInsert; pxIterator = pxIterator->pxNextFreeBlock )
+	{
+		/* Nothing to do here, just iterate to the right position. */
+	}
+
+	/* Do the block being inserted, and the block it is being inserted after
+	make a contiguous block of memory? */
+	puc = ( uint8_t * ) pxIterator;
+	if( ( puc + pxIterator->xBlockSize ) == ( uint8_t * ) pxBlockToInsert )
+	{
+		pxIterator->xBlockSize += pxBlockToInsert->xBlockSize;
+		pxBlockToInsert = pxIterator;
+	}
+	else
+	{
+		mtCOVERAGE_TEST_MARKER();
+	}
+
+	/* Do the block being inserted, and the block it is being inserted before
+	make a contiguous block of memory? */
+	puc = ( uint8_t * ) pxBlockToInsert;
+	if( ( puc + pxBlockToInsert->xBlockSize ) == ( uint8_t * ) pxIterator->pxNextFreeBlock )
+	{
+		if( pxIterator->pxNextFreeBlock != pxEnd )
+		{
+			/* Form one big block from the two blocks. */
+			pxBlockToInsert->xBlockSize += pxIterator->pxNextFreeBlock->xBlockSize;
+			pxBlockToInsert->pxNextFreeBlock = pxIterator->pxNextFreeBlock->pxNextFreeBlock;
+		}
+		else
+		{
+			pxBlockToInsert->pxNextFreeBlock = pxEnd;
+		}
+	}
+	else
+	{
+		pxBlockToInsert->pxNextFreeBlock = pxIterator->pxNextFreeBlock;
+	}
+
+	/* If the block being inserted plugged a gab, so was merged with the block
+	before and the block after, then it's pxNextFreeBlock pointer will have
+	already been set, and should not be set here as that would make it point
+	to itself. */
+	if( pxIterator != pxBlockToInsert )
+	{
+		pxIterator->pxNextFreeBlock = pxBlockToInsert;
+	}
+	else
+	{
+		mtCOVERAGE_TEST_MARKER();
+	}
+}
+/*-----------------------------------------------------------*/
+
+void vPortDefineHeapRegions( const HeapRegion_t * const pxHeapRegions )
+{
+BlockLink_t *pxFirstFreeBlockInRegion = NULL, *pxPreviousFreeBlock;
+size_t xAlignedHeap;
+size_t xTotalRegionSize, xTotalHeapSize = 0;
+BaseType_t xDefinedRegions = 0;
+size_t xAddress;
+const HeapRegion_t *pxHeapRegion;
+
+	/* Can only call once! */
+	configASSERT( pxEnd == NULL );
+
+	pxHeapRegion = &( pxHeapRegions[ xDefinedRegions ] );
+
+	while( pxHeapRegion->xSizeInBytes > 0 )
+	{
+		xTotalRegionSize = pxHeapRegion->xSizeInBytes;
+
+		/* Ensure the heap region starts on a correctly aligned boundary. */
+		xAddress = ( size_t ) pxHeapRegion->pucStartAddress;
+		if( ( xAddress & portBYTE_ALIGNMENT_MASK ) != 0 )
+		{
+			xAddress += ( portBYTE_ALIGNMENT - 1 );
+			xAddress &= ~portBYTE_ALIGNMENT_MASK;
+
+			/* Adjust the size for the bytes lost to alignment. */
+			xTotalRegionSize -= xAddress - ( size_t ) pxHeapRegion->pucStartAddress;
+		}
+
+		xAlignedHeap = xAddress;
+
+		/* Set xStart if it has not already been set. */
+		if( xDefinedRegions == 0 )
+		{
+			/* xStart is used to hold a pointer to the first item in the list of
+			free blocks.  The void cast is used to prevent compiler warnings. */
+			xStart.pxNextFreeBlock = ( BlockLink_t * ) xAlignedHeap;
+			xStart.xBlockSize = ( size_t ) 0;
+		}
+		else
+		{
+			/* Should only get here if one region has already been added to the
+			heap. */
+			configASSERT( pxEnd != NULL );
+
+			/* Check blocks are passed in with increasing start addresses. */
+			configASSERT( xAddress > ( size_t ) pxEnd );
+		}
+
+		/* Remember the location of the end marker in the previous region, if
+		any. */
+		pxPreviousFreeBlock = pxEnd;
+
+		/* pxEnd is used to mark the end of the list of free blocks and is
+		inserted at the end of the region space. */
+		xAddress = xAlignedHeap + xTotalRegionSize;
+		xAddress -= xHeapStructSize;
+		xAddress &= ~portBYTE_ALIGNMENT_MASK;
+		pxEnd = ( BlockLink_t * ) xAddress;
+		pxEnd->xBlockSize = 0;
+		pxEnd->pxNextFreeBlock = NULL;
+
+		/* To start with there is a single free block in this region that is
+		sized to take up the entire heap region minus the space taken by the
+		free block structure. */
+		pxFirstFreeBlockInRegion = ( BlockLink_t * ) xAlignedHeap;
+		pxFirstFreeBlockInRegion->xBlockSize = xAddress - ( size_t ) pxFirstFreeBlockInRegion;
+		pxFirstFreeBlockInRegion->pxNextFreeBlock = pxEnd;
+
+		/* If this is not the first region that makes up the entire heap space
+		then link the previous region to this region. */
+		if( pxPreviousFreeBlock != NULL )
+		{
+			pxPreviousFreeBlock->pxNextFreeBlock = pxFirstFreeBlockInRegion;
+		}
+
+		xTotalHeapSize += pxFirstFreeBlockInRegion->xBlockSize;
+
+		/* Move onto the next HeapRegion_t structure. */
+		xDefinedRegions++;
+		pxHeapRegion = &( pxHeapRegions[ xDefinedRegions ] );
+	}
+
+	xMinimumEverFreeBytesRemaining = xTotalHeapSize;
+	xFreeBytesRemaining = xTotalHeapSize;
+
+	/* Check something was actually defined before it is accessed. */
+	configASSERT( xTotalHeapSize );
+
+	/* Work out the position of the top bit in a size_t variable. */
+	xBlockAllocatedBit = ( ( size_t ) 1 ) << ( ( sizeof( size_t ) * heapBITS_PER_BYTE ) - 1 );
+}
+
diff --git a/FreeRTOS/portable/RVDS/ARM7_LPC21xx/port.c b/FreeRTOS/portable/RVDS/ARM7_LPC21xx/port.c
new file mode 100644
index 0000000..4ce12db
--- /dev/null
+++ b/FreeRTOS/portable/RVDS/ARM7_LPC21xx/port.c
@@ -0,0 +1,333 @@
+/*
+    FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd.
+    All rights reserved
+
+    VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION.
+
+    This file is part of the FreeRTOS distribution.
+
+    FreeRTOS is free software; you can redistribute it and/or modify it under
+    the terms of the GNU General Public License (version 2) as published by the
+    Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception.
+
+    ***************************************************************************
+    >>!   NOTE: The modification to the GPL is included to allow you to     !<<
+    >>!   distribute a combined work that includes FreeRTOS without being   !<<
+    >>!   obliged to provide the source code for proprietary components     !<<
+    >>!   outside of the FreeRTOS kernel.                                   !<<
+    ***************************************************************************
+
+    FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY
+    WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+    FOR A PARTICULAR PURPOSE.  Full license text is available on the following
+    link: http://www.freertos.org/a00114.html
+
+    ***************************************************************************
+     *                                                                       *
+     *    FreeRTOS provides completely free yet professionally developed,    *
+     *    robust, strictly quality controlled, supported, and cross          *
+     *    platform software that is more than just the market leader, it     *
+     *    is the industry's de facto standard.                               *
+     *                                                                       *
+     *    Help yourself get started quickly while simultaneously helping     *
+     *    to support the FreeRTOS project by purchasing a FreeRTOS           *
+     *    tutorial book, reference manual, or both:                          *
+     *    http://www.FreeRTOS.org/Documentation                              *
+     *                                                                       *
+    ***************************************************************************
+
+    http://www.FreeRTOS.org/FAQHelp.html - Having a problem?  Start by reading
+    the FAQ page "My application does not run, what could be wrong?".  Have you
+    defined configASSERT()?
+
+    http://www.FreeRTOS.org/support - In return for receiving this top quality
+    embedded software for free we request you assist our global community by
+    participating in the support forum.
+
+    http://www.FreeRTOS.org/training - Investing in training allows your team to
+    be as productive as possible as early as possible.  Now you can receive
+    FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers
+    Ltd, and the world's leading authority on the world's leading RTOS.
+
+    http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products,
+    including FreeRTOS+Trace - an indispensable productivity tool, a DOS
+    compatible FAT file system, and our tiny thread aware UDP/IP stack.
+
+    http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate.
+    Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS.
+
+    http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High
+    Integrity Systems ltd. to sell under the OpenRTOS brand.  Low cost OpenRTOS
+    licenses offer ticketed support, indemnification and commercial middleware.
+
+    http://www.SafeRTOS.com - High Integrity Systems also provide a safety
+    engineered and independently SIL3 certified version for use in safety and
+    mission critical applications that require provable dependability.
+
+    1 tab == 4 spaces!
+*/
+
+
+/* Standard includes. */
+#include 
+
+/* Scheduler includes. */
+#include "FreeRTOS.h"
+#include "task.h"
+
+/* Constants required to setup the initial task context. */
+#define portINITIAL_SPSR				( ( StackType_t ) 0x1f ) /* System mode, ARM mode, interrupts enabled. */
+#define portTHUMB_MODE_BIT				( ( StackType_t ) 0x20 )
+#define portINSTRUCTION_SIZE			( ( StackType_t ) 4 )
+#define portNO_CRITICAL_SECTION_NESTING	( ( StackType_t ) 0 )
+
+/* Constants required to setup the tick ISR. */
+#define portENABLE_TIMER			( ( uint8_t ) 0x01 )
+#define portPRESCALE_VALUE			0x00
+#define portINTERRUPT_ON_MATCH		( ( uint32_t ) 0x01 )
+#define portRESET_COUNT_ON_MATCH	( ( uint32_t ) 0x02 )
+
+/* Constants required to setup the VIC for the tick ISR. */
+#define portTIMER_VIC_CHANNEL		( ( uint32_t ) 0x0004 )
+#define portTIMER_VIC_CHANNEL_BIT	( ( uint32_t ) 0x0010 )
+#define portTIMER_VIC_ENABLE		( ( uint32_t ) 0x0020 )
+
+/* Constants required to handle interrupts. */
+#define portTIMER_MATCH_ISR_BIT		( ( uint8_t ) 0x01 )
+#define portCLEAR_VIC_INTERRUPT		( ( uint32_t ) 0 )
+
+/*-----------------------------------------------------------*/
+
+/* The code generated by the Keil compiler does not maintain separate
+stack and frame pointers. The portENTER_CRITICAL macro cannot therefore
+use the stack as per other ports.  Instead a variable is used to keep
+track of the critical section nesting.  This variable has to be stored
+as part of the task context and must be initialised to a non zero value. */
+
+#define portNO_CRITICAL_NESTING		( ( uint32_t ) 0 )
+volatile uint32_t ulCriticalNesting = 9999UL;
+
+/*-----------------------------------------------------------*/
+
+/* Setup the timer to generate the tick interrupts. */
+static void prvSetupTimerInterrupt( void );
+
+/* 
+ * The scheduler can only be started from ARM mode, so 
+ * vPortStartFirstSTask() is defined in portISR.c. 
+ */
+extern __asm void vPortStartFirstTask( void );
+
+/*-----------------------------------------------------------*/
+
+/* 
+ * See header file for description. 
+ */
+StackType_t *pxPortInitialiseStack( StackType_t *pxTopOfStack, TaskFunction_t pxCode, void *pvParameters )
+{
+StackType_t *pxOriginalTOS;
+
+	/* Setup the initial stack of the task.  The stack is set exactly as 
+	expected by the portRESTORE_CONTEXT() macro.
+
+	Remember where the top of the (simulated) stack is before we place 
+	anything on it. */
+	pxOriginalTOS = pxTopOfStack;
+	
+	/* To ensure asserts in tasks.c don't fail, although in this case the assert
+	is not really required. */
+	pxTopOfStack--;
+
+	/* First on the stack is the return address - which in this case is the
+	start of the task.  The offset is added to make the return address appear
+	as it would within an IRQ ISR. */
+	*pxTopOfStack = ( StackType_t ) pxCode + portINSTRUCTION_SIZE;		
+	pxTopOfStack--;
+
+	*pxTopOfStack = ( StackType_t ) 0xaaaaaaaa;	/* R14 */
+	pxTopOfStack--;	
+	*pxTopOfStack = ( StackType_t ) pxOriginalTOS; /* Stack used when task starts goes in R13. */
+	pxTopOfStack--;
+	*pxTopOfStack = ( StackType_t ) 0x12121212;	/* R12 */
+	pxTopOfStack--;	
+	*pxTopOfStack = ( StackType_t ) 0x11111111;	/* R11 */
+	pxTopOfStack--;	
+	*pxTopOfStack = ( StackType_t ) 0x10101010;	/* R10 */
+	pxTopOfStack--;	
+	*pxTopOfStack = ( StackType_t ) 0x09090909;	/* R9 */
+	pxTopOfStack--;	
+	*pxTopOfStack = ( StackType_t ) 0x08080808;	/* R8 */
+	pxTopOfStack--;	
+	*pxTopOfStack = ( StackType_t ) 0x07070707;	/* R7 */
+	pxTopOfStack--;	
+	*pxTopOfStack = ( StackType_t ) 0x06060606;	/* R6 */
+	pxTopOfStack--;	
+	*pxTopOfStack = ( StackType_t ) 0x05050505;	/* R5 */
+	pxTopOfStack--;	
+	*pxTopOfStack = ( StackType_t ) 0x04040404;	/* R4 */
+	pxTopOfStack--;	
+	*pxTopOfStack = ( StackType_t ) 0x03030303;	/* R3 */
+	pxTopOfStack--;	
+	*pxTopOfStack = ( StackType_t ) 0x02020202;	/* R2 */
+	pxTopOfStack--;	
+	*pxTopOfStack = ( StackType_t ) 0x01010101;	/* R1 */
+	pxTopOfStack--;	
+	*pxTopOfStack = ( StackType_t ) pvParameters; /* R0 */
+	pxTopOfStack--;
+
+	/* The last thing onto the stack is the status register, which is set for
+	system mode, with interrupts enabled. */
+	*pxTopOfStack = ( StackType_t ) portINITIAL_SPSR;
+
+	if( ( ( uint32_t ) pxCode & 0x01UL ) != 0x00UL )
+	{
+		/* We want the task to start in thumb mode. */
+		*pxTopOfStack |= portTHUMB_MODE_BIT;
+	}
+
+	pxTopOfStack--;
+
+	/* The code generated by the Keil compiler does not maintain separate
+	stack and frame pointers. The portENTER_CRITICAL macro cannot therefore
+	use the stack as per other ports.  Instead a variable is used to keep
+	track of the critical section nesting.  This variable has to be stored
+	as part of the task context and is initially set to zero. */
+	*pxTopOfStack = portNO_CRITICAL_SECTION_NESTING;
+
+	return pxTopOfStack;
+}
+/*-----------------------------------------------------------*/
+
+BaseType_t xPortStartScheduler( void )
+{
+	/* Start the timer that generates the tick ISR. */
+	prvSetupTimerInterrupt();
+
+	/* Start the first task.  This is done from portISR.c as ARM mode must be
+	used. */
+	vPortStartFirstTask();
+
+	/* Should not get here! */
+	return 0;
+}
+/*-----------------------------------------------------------*/
+
+void vPortEndScheduler( void )
+{
+	/* It is unlikely that the ARM port will require this function as there
+	is nothing to return to.  If this is required - stop the tick ISR then
+	return back to main. */
+}
+/*-----------------------------------------------------------*/
+
+#if configUSE_PREEMPTION == 0
+
+	/* 
+	 * The cooperative scheduler requires a normal IRQ service routine to 
+	 * simply increment the system tick. 
+	 */
+	void vNonPreemptiveTick( void ) __irq;
+	void vNonPreemptiveTick( void ) __irq
+	{
+		/* Increment the tick count - this may make a delaying task ready
+		to run - but a context switch is not performed. */		
+		xTaskIncrementTick();
+
+		T0IR = portTIMER_MATCH_ISR_BIT;				/* Clear the timer event */
+		VICVectAddr = portCLEAR_VIC_INTERRUPT;		/* Acknowledge the Interrupt */
+	}
+
+ #else
+
+	/*
+	 **************************************************************************
+	 * The preemptive scheduler ISR is written in assembler and can be found   
+	 * in the portASM.s file. This will only get used if portUSE_PREEMPTION
+	 * is set to 1 in portmacro.h
+	 ************************************************************************** 
+	 */
+
+	  void vPreemptiveTick( void );
+
+#endif
+/*-----------------------------------------------------------*/
+
+static void prvSetupTimerInterrupt( void )
+{
+uint32_t ulCompareMatch;
+
+	/* A 1ms tick does not require the use of the timer prescale.  This is
+	defaulted to zero but can be used if necessary. */
+	T0PR = portPRESCALE_VALUE;
+
+	/* Calculate the match value required for our wanted tick rate. */
+	ulCompareMatch = configCPU_CLOCK_HZ / configTICK_RATE_HZ;
+
+	/* Protect against divide by zero.  Using an if() statement still results
+	in a warning - hence the #if. */
+	#if portPRESCALE_VALUE != 0
+	{
+		ulCompareMatch /= ( portPRESCALE_VALUE + 1 );
+	}
+	#endif
+
+	T0MR0 = ulCompareMatch;
+
+	/* Generate tick with timer 0 compare match. */
+	T0MCR = portRESET_COUNT_ON_MATCH | portINTERRUPT_ON_MATCH;
+
+	/* Setup the VIC for the timer. */
+	VICIntSelect &= ~( portTIMER_VIC_CHANNEL_BIT );
+	VICIntEnable |= portTIMER_VIC_CHANNEL_BIT;
+	
+	/* The ISR installed depends on whether the preemptive or cooperative
+	scheduler is being used. */
+	#if configUSE_PREEMPTION == 1
+	{	
+		VICVectAddr0 = ( uint32_t ) vPreemptiveTick;
+	}
+	#else
+	{
+		VICVectAddr0 = ( uint32_t ) vNonPreemptiveTick;
+	}
+	#endif
+
+	VICVectCntl0 = portTIMER_VIC_CHANNEL | portTIMER_VIC_ENABLE;
+
+	/* Start the timer - interrupts are disabled when this function is called
+	so it is okay to do this here. */
+	T0TCR = portENABLE_TIMER;
+}
+/*-----------------------------------------------------------*/
+
+void vPortEnterCritical( void )
+{
+	/* Disable interrupts as per portDISABLE_INTERRUPTS(); 							*/
+	__disable_irq();
+
+	/* Now interrupts are disabled ulCriticalNesting can be accessed 
+	directly.  Increment ulCriticalNesting to keep a count of how many times
+	portENTER_CRITICAL() has been called. */
+	ulCriticalNesting++;
+}
+/*-----------------------------------------------------------*/
+
+void vPortExitCritical( void )
+{
+	if( ulCriticalNesting > portNO_CRITICAL_NESTING )
+	{
+		/* Decrement the nesting count as we are leaving a critical section. */
+		ulCriticalNesting--;
+
+		/* If the nesting level has reached zero then interrupts should be
+		re-enabled. */
+		if( ulCriticalNesting == portNO_CRITICAL_NESTING )
+		{
+			/* Enable interrupts as per portEXIT_CRITICAL(). */
+			__enable_irq();
+		}
+	}
+}
+/*-----------------------------------------------------------*/
+
+
diff --git a/FreeRTOS/portable/RVDS/ARM7_LPC21xx/portASM.s b/FreeRTOS/portable/RVDS/ARM7_LPC21xx/portASM.s
new file mode 100644
index 0000000..8b29d72
--- /dev/null
+++ b/FreeRTOS/portable/RVDS/ARM7_LPC21xx/portASM.s
@@ -0,0 +1,151 @@
+;/*
+;    FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd.
+;    All rights reserved
+;	
+;
+;    ***************************************************************************
+;     *                                                                       *
+;     *    FreeRTOS tutorial books are available in pdf and paperback.        *
+;     *    Complete, revised, and edited pdf reference manuals are also       *
+;     *    available.                                                         *
+;     *                                                                       *
+;     *    Purchasing FreeRTOS documentation will not only help you, by       *
+;     *    ensuring you get running as quickly as possible and with an        *
+;     *    in-depth knowledge of how to use FreeRTOS, it will also help       *
+;     *    the FreeRTOS project to continue with its mission of providing     *
+;     *    professional grade, cross platform, de facto standard solutions    *
+;     *    for microcontrollers - completely free of charge!                  *
+;     *                                                                       *
+;     *    >>> See http://www.FreeRTOS.org/Documentation for details. <<<     *
+;     *                                                                       *
+;     *    Thank you for using FreeRTOS, and thank you for your support!      *
+;     *                                                                       *
+;    ***************************************************************************
+;
+;
+;    This file is part of the FreeRTOS distribution.
+;
+;    FreeRTOS is free software; you can redistribute it and/or modify it under
+;    the terms of the GNU General Public License (version 2) as published by the
+;    Free Software Foundation AND MODIFIED BY the FreeRTOS exception.
+;    >>>NOTE<<< The modification to the GPL is included to allow you to
+;    distribute a combined work that includes FreeRTOS without being obliged to
+;    provide the source code for proprietary components outside of the FreeRTOS
+;    kernel.  FreeRTOS is distributed in the hope that it will be useful, but
+;    WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+;    or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+;    more details. You should have received a copy of the GNU General Public
+;    License and the FreeRTOS license exception along with FreeRTOS; if not it
+;    can be viewed here: http://www.freertos.org/a00114.html and also obtained
+;    by writing to Richard Barry, contact details for whom are available on the
+;    FreeRTOS WEB site.
+;
+;    1 tab == 4 spaces!
+;
+;    http://www.FreeRTOS.org - Documentation, latest information, license and
+;    contact details.
+;
+;    http://www.SafeRTOS.com - A version that is certified for use in safety
+;    critical systems.
+;
+;    http://www.OpenRTOS.com - Commercial support, development, porting,
+;    licensing and training services.
+;*/
+
+	INCLUDE portmacro.inc
+
+	IMPORT	vTaskSwitchContext
+	IMPORT	xTaskIncrementTick
+
+	EXPORT	vPortYieldProcessor
+	EXPORT	vPortStartFirstTask
+	EXPORT	vPreemptiveTick
+	EXPORT	vPortYield
+
+
+VICVECTADDR	EQU	0xFFFFF030
+T0IR		EQU	0xE0004000
+T0MATCHBIT	EQU	0x00000001
+
+	ARM
+	AREA	PORT_ASM, CODE, READONLY
+
+
+
+;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
+; Starting the first task is done by just restoring the context 
+; setup by pxPortInitialiseStack
+;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
+vPortStartFirstTask
+
+	PRESERVE8
+
+	portRESTORE_CONTEXT
+
+vPortYield
+
+	PRESERVE8
+
+	SVC 0
+	bx lr
+
+;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
+; Interrupt service routine for the SWI interrupt.  The vector table is
+; configured in the startup.s file.
+;
+; vPortYieldProcessor() is used to manually force a context switch.  The
+; SWI interrupt is generated by a call to taskYIELD() or portYIELD().
+;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
+
+vPortYieldProcessor
+
+	PRESERVE8
+
+	; Within an IRQ ISR the link register has an offset from the true return 
+	; address, but an SWI ISR does not.  Add the offset manually so the same 
+	; ISR return code can be used in both cases.
+	ADD	LR, LR, #4
+
+	; Perform the context switch.
+	portSAVE_CONTEXT					; Save current task context				
+	LDR R0, =vTaskSwitchContext			; Get the address of the context switch function
+	MOV LR, PC							; Store the return address
+	BX	R0								; Call the contedxt switch function
+	portRESTORE_CONTEXT					; restore the context of the selected task	
+
+
+
+;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
+; Interrupt service routine for preemptive scheduler tick timer
+; Only used if portUSE_PREEMPTION is set to 1 in portmacro.h
+;
+; Uses timer 0 of LPC21XX Family
+;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;	
+
+vPreemptiveTick
+
+	PRESERVE8
+
+	portSAVE_CONTEXT					; Save the context of the current task.	
+
+	LDR R0, =xTaskIncrementTick			; Increment the tick count.  
+	MOV LR, PC							; This may make a delayed task ready
+	BX R0								; to run.
+
+	CMP R0, #0
+	BEQ SkipContextSwitch
+	LDR R0, =vTaskSwitchContext			; Find the highest priority task that 
+	MOV LR, PC							; is ready to run.
+	BX R0
+SkipContextSwitch
+	MOV R0, #T0MATCHBIT					; Clear the timer event
+	LDR R1, =T0IR
+	STR R0, [R1] 
+
+	LDR	R0, =VICVECTADDR				; Acknowledge the interrupt	
+	STR	R0,[R0]
+
+	portRESTORE_CONTEXT					; Restore the context of the highest 
+										; priority task that is ready to run.
+	END
+
diff --git a/FreeRTOS/portable/RVDS/ARM7_LPC21xx/portmacro.h b/FreeRTOS/portable/RVDS/ARM7_LPC21xx/portmacro.h
new file mode 100644
index 0000000..098fd34
--- /dev/null
+++ b/FreeRTOS/portable/RVDS/ARM7_LPC21xx/portmacro.h
@@ -0,0 +1,188 @@
+/*
+    FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd.
+    All rights reserved
+
+    VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION.
+
+    This file is part of the FreeRTOS distribution.
+
+    FreeRTOS is free software; you can redistribute it and/or modify it under
+    the terms of the GNU General Public License (version 2) as published by the
+    Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception.
+
+    ***************************************************************************
+    >>!   NOTE: The modification to the GPL is included to allow you to     !<<
+    >>!   distribute a combined work that includes FreeRTOS without being   !<<
+    >>!   obliged to provide the source code for proprietary components     !<<
+    >>!   outside of the FreeRTOS kernel.                                   !<<
+    ***************************************************************************
+
+    FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY
+    WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+    FOR A PARTICULAR PURPOSE.  Full license text is available on the following
+    link: http://www.freertos.org/a00114.html
+
+    ***************************************************************************
+     *                                                                       *
+     *    FreeRTOS provides completely free yet professionally developed,    *
+     *    robust, strictly quality controlled, supported, and cross          *
+     *    platform software that is more than just the market leader, it     *
+     *    is the industry's de facto standard.                               *
+     *                                                                       *
+     *    Help yourself get started quickly while simultaneously helping     *
+     *    to support the FreeRTOS project by purchasing a FreeRTOS           *
+     *    tutorial book, reference manual, or both:                          *
+     *    http://www.FreeRTOS.org/Documentation                              *
+     *                                                                       *
+    ***************************************************************************
+
+    http://www.FreeRTOS.org/FAQHelp.html - Having a problem?  Start by reading
+    the FAQ page "My application does not run, what could be wrong?".  Have you
+    defined configASSERT()?
+
+    http://www.FreeRTOS.org/support - In return for receiving this top quality
+    embedded software for free we request you assist our global community by
+    participating in the support forum.
+
+    http://www.FreeRTOS.org/training - Investing in training allows your team to
+    be as productive as possible as early as possible.  Now you can receive
+    FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers
+    Ltd, and the world's leading authority on the world's leading RTOS.
+
+    http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products,
+    including FreeRTOS+Trace - an indispensable productivity tool, a DOS
+    compatible FAT file system, and our tiny thread aware UDP/IP stack.
+
+    http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate.
+    Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS.
+
+    http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High
+    Integrity Systems ltd. to sell under the OpenRTOS brand.  Low cost OpenRTOS
+    licenses offer ticketed support, indemnification and commercial middleware.
+
+    http://www.SafeRTOS.com - High Integrity Systems also provide a safety
+    engineered and independently SIL3 certified version for use in safety and
+    mission critical applications that require provable dependability.
+
+    1 tab == 4 spaces!
+*/
+
+
+#ifndef PORTMACRO_H
+#define PORTMACRO_H
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/*-----------------------------------------------------------
+ * Port specific definitions.
+ *
+ * The settings in this file configure FreeRTOS correctly for the
+ * given hardware and compiler.
+ *
+ * These settings should not be altered.
+ *-----------------------------------------------------------
+ */
+
+/* Type definitions. */
+#define portCHAR		char
+#define portFLOAT		float
+#define portDOUBLE		double
+#define portLONG		long
+#define portSHORT		short
+#define portSTACK_TYPE	uint32_t
+#define portBASE_TYPE	long
+
+typedef portSTACK_TYPE StackType_t;
+typedef long BaseType_t;
+typedef unsigned long UBaseType_t;
+
+
+#if( configUSE_16_BIT_TICKS == 1 )
+	typedef uint16_t TickType_t;
+	#define portMAX_DELAY ( TickType_t ) 0xffff
+#else
+	typedef uint32_t TickType_t;
+	#define portMAX_DELAY ( TickType_t ) 0xffffffffUL
+#endif
+/*-----------------------------------------------------------*/
+
+/* Hardware specifics. */
+#define portSTACK_GROWTH			( -1 )
+#define portTICK_PERIOD_MS			( ( TickType_t ) 1000 / configTICK_RATE_HZ )
+#define portBYTE_ALIGNMENT			8
+/*-----------------------------------------------------------*/
+
+/* Task utilities. */
+
+/*-----------------------------------------------------------
+ * ISR entry and exit macros.  These are only required if a task switch
+ * is required from an ISR.
+ *----------------------------------------------------------*/
+
+/* If a switch is required then we just need to call */
+/* vTaskSwitchContext() as the context has already been */
+/* saved. */
+
+#define portEXIT_SWITCHING_ISR(SwitchRequired)				 \
+{															 \
+extern void vTaskSwitchContext(void);						 \
+															 \
+		if(SwitchRequired)									 \
+		{													 \
+			vTaskSwitchContext();							 \
+		}													 \
+}															 \
+
+extern void vPortYield( void );
+#define portYIELD() vPortYield()
+
+
+/* Critical section management. */
+
+/*
+ ******************************************************************
+ * We don't need to worry about whether we're in ARM or
+ * THUMB mode with the Keil Real View compiler when enabling
+ * or disabling interrupts as the compiler's intrinsic functions
+ * take care of that for us.
+ *******************************************************************
+ */
+#define portDISABLE_INTERRUPTS()	__disable_irq()
+#define portENABLE_INTERRUPTS()		__enable_irq()
+
+
+/*-----------------------------------------------------------
+ * Critical section control
+ *
+ * The code generated by the Keil compiler does not maintain separate
+ * stack and frame pointers. The portENTER_CRITICAL macro cannot therefore
+ * use the stack as per other ports.  Instead a variable is used to keep
+ * track of the critical section nesting.  This necessitates the use of a
+ * function in place of the macro.
+ *----------------------------------------------------------*/
+
+extern void vPortEnterCritical( void );
+extern void vPortExitCritical( void );
+
+#define portENTER_CRITICAL()		vPortEnterCritical();
+#define portEXIT_CRITICAL()			vPortExitCritical();
+/*-----------------------------------------------------------*/
+
+/* Compiler specifics. */
+#define inline
+#define register
+#define portNOP()	__asm{ NOP }
+/*-----------------------------------------------------------*/
+
+/* Task function macros as described on the FreeRTOS.org WEB site. */
+#define portTASK_FUNCTION_PROTO( vFunction, pvParameters )	void vFunction( void *pvParameters )
+#define portTASK_FUNCTION( vFunction, pvParameters )	void vFunction( void *pvParameters )
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* PORTMACRO_H */
+
diff --git a/FreeRTOS/portable/RVDS/ARM7_LPC21xx/portmacro.inc b/FreeRTOS/portable/RVDS/ARM7_LPC21xx/portmacro.inc
new file mode 100644
index 0000000..68533db
--- /dev/null
+++ b/FreeRTOS/portable/RVDS/ARM7_LPC21xx/portmacro.inc
@@ -0,0 +1,118 @@
+;/*
+;    FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd.
+;    All rights reserved
+;	
+;
+;    ***************************************************************************
+;     *                                                                       *
+;     *    FreeRTOS tutorial books are available in pdf and paperback.        *
+;     *    Complete, revised, and edited pdf reference manuals are also       *
+;     *    available.                                                         *
+;     *                                                                       *
+;     *    Purchasing FreeRTOS documentation will not only help you, by       *
+;     *    ensuring you get running as quickly as possible and with an        *
+;     *    in-depth knowledge of how to use FreeRTOS, it will also help       *
+;     *    the FreeRTOS project to continue with its mission of providing     *
+;     *    professional grade, cross platform, de facto standard solutions    *
+;     *    for microcontrollers - completely free of charge!                  *
+;     *                                                                       *
+;     *    >>> See http://www.FreeRTOS.org/Documentation for details. <<<     *
+;     *                                                                       *
+;     *    Thank you for using FreeRTOS, and thank you for your support!      *
+;     *                                                                       *
+;    ***************************************************************************
+;
+;
+;    This file is part of the FreeRTOS distribution.
+;
+;    FreeRTOS is free software; you can redistribute it and/or modify it under
+;    the terms of the GNU General Public License (version 2) as published by the
+;    Free Software Foundation AND MODIFIED BY the FreeRTOS exception.
+;    >>>NOTE<<< The modification to the GPL is included to allow you to
+;    distribute a combined work that includes FreeRTOS without being obliged to
+;    provide the source code for proprietary components outside of the FreeRTOS
+;    kernel.  FreeRTOS is distributed in the hope that it will be useful, but
+;    WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+;    or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+;    more details. You should have received a copy of the GNU General Public
+;    License and the FreeRTOS license exception along with FreeRTOS; if not it
+;    can be viewed here: http://www.freertos.org/a00114.html and also obtained
+;    by writing to Richard Barry, contact details for whom are available on the
+;    FreeRTOS WEB site.
+;
+;    1 tab == 4 spaces!
+;
+;    http://www.FreeRTOS.org - Documentation, latest information, license and
+;    contact details.
+;
+;    http://www.SafeRTOS.com - A version that is certified for use in safety
+;    critical systems.
+;
+;    http://www.OpenRTOS.com - Commercial support, development, porting,
+;    licensing and training services.
+;*/
+
+	IMPORT  ulCriticalNesting		;
+	IMPORT	pxCurrentTCB			;
+
+
+	MACRO
+	portRESTORE_CONTEXT
+
+
+	LDR		R0, =pxCurrentTCB		; Set the LR to the task stack.  The location was...
+	LDR		R0, [R0]				; ... stored in pxCurrentTCB
+	LDR		LR, [R0]
+
+	LDR		R0, =ulCriticalNesting	; The critical nesting depth is the first item on... 
+	LDMFD	LR!, {R1}				; ...the stack.  Load it into the ulCriticalNesting var.
+	STR		R1, [R0]				;
+
+	LDMFD	LR!, {R0}				; Get the SPSR from the stack.
+	MSR		SPSR_cxsf, R0			;
+
+	LDMFD	LR, {R0-R14}^			; Restore all system mode registers for the task.
+	NOP								;
+
+	LDR		LR, [LR, #+60]			; Restore the return address
+
+									; And return - correcting the offset in the LR to obtain ...
+	SUBS	PC, LR, #4				; ...the correct address.
+
+	MEND
+
+; /**********************************************************************/
+
+	MACRO
+	portSAVE_CONTEXT
+
+
+	STMDB 	SP!, {R0}				; Store R0 first as we need to use it.
+
+	STMDB	SP,{SP}^				; Set R0 to point to the task stack pointer.
+	NOP								;
+	SUB		SP, SP, #4				;
+	LDMIA	SP!,{R0}				;
+
+	STMDB	R0!, {LR}				; Push the return address onto the stack.
+	MOV		LR, R0					; Now we have saved LR we can use it instead of R0.
+	LDMIA	SP!, {R0}				; Pop R0 so we can save it onto the system mode stack.
+
+	STMDB	LR,{R0-LR}^				; Push all the system mode registers onto the task stack.
+	NOP								;
+	SUB		LR, LR, #60				;
+
+	MRS		R0, SPSR				; Push the SPSR onto the task stack.
+	STMDB	LR!, {R0}				;
+
+	LDR		R0, =ulCriticalNesting	;
+	LDR		R0, [R0]				;
+	STMDB	LR!, {R0}				;
+
+	LDR		R0, =pxCurrentTCB		; Store the new top of stack for the task.
+	LDR		R1, [R0]				; 		 
+	STR		LR, [R1]				;
+	
+	MEND
+	
+	END
diff --git a/FreeRTOS/portable/RVDS/ARM_CA9/port.c b/FreeRTOS/portable/RVDS/ARM_CA9/port.c
new file mode 100644
index 0000000..13fa2b7
--- /dev/null
+++ b/FreeRTOS/portable/RVDS/ARM_CA9/port.c
@@ -0,0 +1,522 @@
+/*
+    FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd.
+    All rights reserved
+
+    VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION.
+
+    This file is part of the FreeRTOS distribution.
+
+    FreeRTOS is free software; you can redistribute it and/or modify it under
+    the terms of the GNU General Public License (version 2) as published by the
+    Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception.
+
+    ***************************************************************************
+    >>!   NOTE: The modification to the GPL is included to allow you to     !<<
+    >>!   distribute a combined work that includes FreeRTOS without being   !<<
+    >>!   obliged to provide the source code for proprietary components     !<<
+    >>!   outside of the FreeRTOS kernel.                                   !<<
+    ***************************************************************************
+
+    FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY
+    WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+    FOR A PARTICULAR PURPOSE.  Full license text is available on the following
+    link: http://www.freertos.org/a00114.html
+
+    ***************************************************************************
+     *                                                                       *
+     *    FreeRTOS provides completely free yet professionally developed,    *
+     *    robust, strictly quality controlled, supported, and cross          *
+     *    platform software that is more than just the market leader, it     *
+     *    is the industry's de facto standard.                               *
+     *                                                                       *
+     *    Help yourself get started quickly while simultaneously helping     *
+     *    to support the FreeRTOS project by purchasing a FreeRTOS           *
+     *    tutorial book, reference manual, or both:                          *
+     *    http://www.FreeRTOS.org/Documentation                              *
+     *                                                                       *
+    ***************************************************************************
+
+    http://www.FreeRTOS.org/FAQHelp.html - Having a problem?  Start by reading
+    the FAQ page "My application does not run, what could be wrong?".  Have you
+    defined configASSERT()?
+
+    http://www.FreeRTOS.org/support - In return for receiving this top quality
+    embedded software for free we request you assist our global community by
+    participating in the support forum.
+
+    http://www.FreeRTOS.org/training - Investing in training allows your team to
+    be as productive as possible as early as possible.  Now you can receive
+    FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers
+    Ltd, and the world's leading authority on the world's leading RTOS.
+
+    http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products,
+    including FreeRTOS+Trace - an indispensable productivity tool, a DOS
+    compatible FAT file system, and our tiny thread aware UDP/IP stack.
+
+    http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate.
+    Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS.
+
+    http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High
+    Integrity Systems ltd. to sell under the OpenRTOS brand.  Low cost OpenRTOS
+    licenses offer ticketed support, indemnification and commercial middleware.
+
+    http://www.SafeRTOS.com - High Integrity Systems also provide a safety
+    engineered and independently SIL3 certified version for use in safety and
+    mission critical applications that require provable dependability.
+
+    1 tab == 4 spaces!
+*/
+
+/* Standard includes. */
+#include 
+
+/* Scheduler includes. */
+#include "FreeRTOS.h"
+#include "task.h"
+
+#ifndef configINTERRUPT_CONTROLLER_BASE_ADDRESS
+	#error configINTERRUPT_CONTROLLER_BASE_ADDRESS must be defined.  See http://www.freertos.org/Using-FreeRTOS-on-Cortex-A-Embedded-Processors.html
+#endif
+
+#ifndef configINTERRUPT_CONTROLLER_CPU_INTERFACE_OFFSET
+	#error configINTERRUPT_CONTROLLER_CPU_INTERFACE_OFFSET must be defined.  See http://www.freertos.org/Using-FreeRTOS-on-Cortex-A-Embedded-Processors.html
+#endif
+
+#ifndef configUNIQUE_INTERRUPT_PRIORITIES
+	#error configUNIQUE_INTERRUPT_PRIORITIES must be defined.  See http://www.freertos.org/Using-FreeRTOS-on-Cortex-A-Embedded-Processors.html
+#endif
+
+#ifndef configSETUP_TICK_INTERRUPT
+	#error configSETUP_TICK_INTERRUPT() must be defined.  See http://www.freertos.org/Using-FreeRTOS-on-Cortex-A-Embedded-Processors.html
+#endif /* configSETUP_TICK_INTERRUPT */
+
+#ifndef configMAX_API_CALL_INTERRUPT_PRIORITY
+	#error configMAX_API_CALL_INTERRUPT_PRIORITY must be defined.  See http://www.freertos.org/Using-FreeRTOS-on-Cortex-A-Embedded-Processors.html
+#endif
+
+#if configMAX_API_CALL_INTERRUPT_PRIORITY == 0
+	#error configMAX_API_CALL_INTERRUPT_PRIORITY must not be set to 0
+#endif
+
+#if configMAX_API_CALL_INTERRUPT_PRIORITY > configUNIQUE_INTERRUPT_PRIORITIES
+	#error configMAX_API_CALL_INTERRUPT_PRIORITY must be less than or equal to configUNIQUE_INTERRUPT_PRIORITIES as the lower the numeric priority value the higher the logical interrupt priority
+#endif
+
+#if configUSE_PORT_OPTIMISED_TASK_SELECTION == 1
+	/* Check the configuration. */
+	#if( configMAX_PRIORITIES > 32 )
+		#error configUSE_PORT_OPTIMISED_TASK_SELECTION can only be set to 1 when configMAX_PRIORITIES is less than or equal to 32.  It is very rare that a system requires more than 10 to 15 difference priorities as tasks that share a priority will time slice.
+	#endif
+#endif /* configUSE_PORT_OPTIMISED_TASK_SELECTION */
+
+/* In case security extensions are implemented. */
+#if configMAX_API_CALL_INTERRUPT_PRIORITY <= ( configUNIQUE_INTERRUPT_PRIORITIES / 2 )
+	#error configMAX_API_CALL_INTERRUPT_PRIORITY must be greater than ( configUNIQUE_INTERRUPT_PRIORITIES / 2 )
+#endif
+
+#ifndef configCLEAR_TICK_INTERRUPT
+	#define configCLEAR_TICK_INTERRUPT()
+#endif
+
+/* The number of bits to shift for an interrupt priority is dependent on the
+number of bits implemented by the interrupt controller. */
+#if configUNIQUE_INTERRUPT_PRIORITIES == 16
+	#define portPRIORITY_SHIFT 4
+	#define portMAX_BINARY_POINT_VALUE	3
+#elif configUNIQUE_INTERRUPT_PRIORITIES == 32
+	#define portPRIORITY_SHIFT 3
+	#define portMAX_BINARY_POINT_VALUE	2
+#elif configUNIQUE_INTERRUPT_PRIORITIES == 64
+	#define portPRIORITY_SHIFT 2
+	#define portMAX_BINARY_POINT_VALUE	1
+#elif configUNIQUE_INTERRUPT_PRIORITIES == 128
+	#define portPRIORITY_SHIFT 1
+	#define portMAX_BINARY_POINT_VALUE	0
+#elif configUNIQUE_INTERRUPT_PRIORITIES == 256
+	#define portPRIORITY_SHIFT 0
+	#define portMAX_BINARY_POINT_VALUE	0
+#else
+	#error Invalid configUNIQUE_INTERRUPT_PRIORITIES setting.  configUNIQUE_INTERRUPT_PRIORITIES must be set to the number of unique priorities implemented by the target hardware
+#endif
+
+/* A critical section is exited when the critical section nesting count reaches
+this value. */
+#define portNO_CRITICAL_NESTING			( ( uint32_t ) 0 )
+
+/* In all GICs 255 can be written to the priority mask register to unmask all
+(but the lowest) interrupt priority. */
+#define portUNMASK_VALUE				( 0xFFUL )
+
+/* Tasks are not created with a floating point context, but can be given a
+floating point context after they have been created.  A variable is stored as
+part of the tasks context that holds portNO_FLOATING_POINT_CONTEXT if the task
+does not have an FPU context, or any other value if the task does have an FPU
+context. */
+#define portNO_FLOATING_POINT_CONTEXT	( ( StackType_t ) 0 )
+
+/* Interrupt controller access addresses. */
+#define portICCPMR_PRIORITY_MASK_OFFSET  		( 0x04 )
+#define portICCIAR_INTERRUPT_ACKNOWLEDGE_OFFSET ( 0x0C )
+#define portICCEOIR_END_OF_INTERRUPT_OFFSET 	( 0x10 )
+#define portICCBPR_BINARY_POINT_OFFSET			( 0x08 )
+#define portICCRPR_RUNNING_PRIORITY_OFFSET		( 0x14 )
+#define portINTERRUPT_CONTROLLER_CPU_INTERFACE_ADDRESS 		( configINTERRUPT_CONTROLLER_BASE_ADDRESS + configINTERRUPT_CONTROLLER_CPU_INTERFACE_OFFSET )
+#define portICCPMR_PRIORITY_MASK_REGISTER 					( *( ( volatile uint32_t * ) ( portINTERRUPT_CONTROLLER_CPU_INTERFACE_ADDRESS + portICCPMR_PRIORITY_MASK_OFFSET ) ) )
+#define portICCIAR_INTERRUPT_ACKNOWLEDGE_REGISTER_ADDRESS 	( portINTERRUPT_CONTROLLER_CPU_INTERFACE_ADDRESS + portICCIAR_INTERRUPT_ACKNOWLEDGE_OFFSET )
+#define portICCEOIR_END_OF_INTERRUPT_REGISTER_ADDRESS 		( portINTERRUPT_CONTROLLER_CPU_INTERFACE_ADDRESS + portICCEOIR_END_OF_INTERRUPT_OFFSET )
+#define portICCPMR_PRIORITY_MASK_REGISTER_ADDRESS 			( portINTERRUPT_CONTROLLER_CPU_INTERFACE_ADDRESS + portICCPMR_PRIORITY_MASK_OFFSET )
+#define portICCBPR_BINARY_POINT_REGISTER 					( *( ( const volatile uint32_t * ) ( portINTERRUPT_CONTROLLER_CPU_INTERFACE_ADDRESS + portICCBPR_BINARY_POINT_OFFSET ) ) )
+#define portICCRPR_RUNNING_PRIORITY_REGISTER 				( *( ( const volatile uint32_t * ) ( portINTERRUPT_CONTROLLER_CPU_INTERFACE_ADDRESS + portICCRPR_RUNNING_PRIORITY_OFFSET ) ) )
+
+/* Used by portASSERT_IF_INTERRUPT_PRIORITY_INVALID() when ensuring the binary
+point is zero. */
+#define portBINARY_POINT_BITS			( ( uint8_t ) 0x03 )
+
+/* Constants required to setup the initial task context. */
+#define portINITIAL_SPSR				( ( StackType_t ) 0x1f ) /* System mode, ARM mode, interrupts enabled. */
+#define portTHUMB_MODE_BIT				( ( StackType_t ) 0x20 )
+#define portTHUMB_MODE_ADDRESS			( 0x01UL )
+
+/* Masks all bits in the APSR other than the mode bits. */
+#define portAPSR_MODE_BITS_MASK			( 0x1F )
+
+/* The value of the mode bits in the APSR when the CPU is executing in user
+mode. */
+#define portAPSR_USER_MODE				( 0x10 )
+
+/* Macro to unmask all interrupt priorities. */
+#define portCLEAR_INTERRUPT_MASK()											\
+{																			\
+	__disable_irq();														\
+	portICCPMR_PRIORITY_MASK_REGISTER = portUNMASK_VALUE;					\
+	__asm(	"DSB		\n"													\
+			"ISB		\n" );												\
+	__enable_irq();															\
+}
+
+/*-----------------------------------------------------------*/
+
+/*
+ * Starts the first task executing.  This function is necessarily written in
+ * assembly code so is implemented in portASM.s.
+ */
+extern void vPortRestoreTaskContext( void );
+
+/*
+ * Used to catch tasks that attempt to return from their implementing function.
+ */
+static void prvTaskExitError( void );
+
+/*-----------------------------------------------------------*/
+
+/* A variable is used to keep track of the critical section nesting.  This
+variable has to be stored as part of the task context and must be initialised to
+a non zero value to ensure interrupts don't inadvertently become unmasked before
+the scheduler starts.  As it is stored as part of the task context it will
+automatically be set to 0 when the first task is started. */
+volatile uint32_t ulCriticalNesting = 9999UL;
+
+/* Used to pass constants into the ASM code.  The address at which variables are
+placed is the constant value so indirect loads in the asm code are not
+required. */
+uint32_t ulICCIAR __attribute__( ( at( portICCIAR_INTERRUPT_ACKNOWLEDGE_REGISTER_ADDRESS ) ) );
+uint32_t ulICCEOIR __attribute__( ( at( portICCEOIR_END_OF_INTERRUPT_REGISTER_ADDRESS ) ) );
+uint32_t ulICCPMR __attribute__( ( at( portICCPMR_PRIORITY_MASK_REGISTER_ADDRESS ) ) );
+uint32_t ulAsmAPIPriorityMask __attribute__( ( at( configMAX_API_CALL_INTERRUPT_PRIORITY << portPRIORITY_SHIFT ) ) );
+
+/* Saved as part of the task context.  If ulPortTaskHasFPUContext is non-zero then
+a floating point context must be saved and restored for the task. */
+uint32_t ulPortTaskHasFPUContext = pdFALSE;
+
+/* Set to 1 to pend a context switch from an ISR. */
+uint32_t ulPortYieldRequired = pdFALSE;
+
+/* Counts the interrupt nesting depth.  A context switch is only performed if
+if the nesting depth is 0. */
+uint32_t ulPortInterruptNesting = 0UL;
+
+/*-----------------------------------------------------------*/
+
+/*
+ * See header file for description.
+ */
+StackType_t *pxPortInitialiseStack( StackType_t *pxTopOfStack, TaskFunction_t pxCode, void *pvParameters )
+{
+	/* Setup the initial stack of the task.  The stack is set exactly as
+	expected by the portRESTORE_CONTEXT() macro.
+
+	The fist real value on the stack is the status register, which is set for
+	system mode, with interrupts enabled.  A few NULLs are added first to ensure
+	GDB does not try decoding a non-existent return address. */
+	*pxTopOfStack = NULL;
+	pxTopOfStack--;
+	*pxTopOfStack = NULL;
+	pxTopOfStack--;
+	*pxTopOfStack = NULL;
+	pxTopOfStack--;
+	*pxTopOfStack = ( StackType_t ) portINITIAL_SPSR;
+
+	if( ( ( uint32_t ) pxCode & portTHUMB_MODE_ADDRESS ) != 0x00UL )
+	{
+		/* The task will start in THUMB mode. */
+		*pxTopOfStack |= portTHUMB_MODE_BIT;
+	}
+
+	pxTopOfStack--;
+
+	/* Next the return address, which in this case is the start of the task. */
+	*pxTopOfStack = ( StackType_t ) pxCode;
+	pxTopOfStack--;
+
+	/* Next all the registers other than the stack pointer. */
+	*pxTopOfStack = ( StackType_t ) prvTaskExitError;	/* R14 */
+	pxTopOfStack--;
+	*pxTopOfStack = ( StackType_t ) 0x12121212;	/* R12 */
+	pxTopOfStack--;
+	*pxTopOfStack = ( StackType_t ) 0x11111111;	/* R11 */
+	pxTopOfStack--;
+	*pxTopOfStack = ( StackType_t ) 0x10101010;	/* R10 */
+	pxTopOfStack--;
+	*pxTopOfStack = ( StackType_t ) 0x09090909;	/* R9 */
+	pxTopOfStack--;
+	*pxTopOfStack = ( StackType_t ) 0x08080808;	/* R8 */
+	pxTopOfStack--;
+	*pxTopOfStack = ( StackType_t ) 0x07070707;	/* R7 */
+	pxTopOfStack--;
+	*pxTopOfStack = ( StackType_t ) 0x06060606;	/* R6 */
+	pxTopOfStack--;
+	*pxTopOfStack = ( StackType_t ) 0x05050505;	/* R5 */
+	pxTopOfStack--;
+	*pxTopOfStack = ( StackType_t ) 0x04040404;	/* R4 */
+	pxTopOfStack--;
+	*pxTopOfStack = ( StackType_t ) 0x03030303;	/* R3 */
+	pxTopOfStack--;
+	*pxTopOfStack = ( StackType_t ) 0x02020202;	/* R2 */
+	pxTopOfStack--;
+	*pxTopOfStack = ( StackType_t ) 0x01010101;	/* R1 */
+	pxTopOfStack--;
+	*pxTopOfStack = ( StackType_t ) pvParameters; /* R0 */
+	pxTopOfStack--;
+
+	/* The task will start with a critical nesting count of 0 as interrupts are
+	enabled. */
+	*pxTopOfStack = portNO_CRITICAL_NESTING;
+	pxTopOfStack--;
+
+	/* The task will start without a floating point context.  A task that uses
+	the floating point hardware must call vPortTaskUsesFPU() before executing
+	any floating point instructions. */
+	*pxTopOfStack = portNO_FLOATING_POINT_CONTEXT;
+
+	return pxTopOfStack;
+}
+/*-----------------------------------------------------------*/
+
+static void prvTaskExitError( void )
+{
+	/* A function that implements a task must not exit or attempt to return to
+	its caller as there is nothing to return to.  If a task wants to exit it
+	should instead call vTaskDelete( NULL ).
+
+	Artificially force an assert() to be triggered if configASSERT() is
+	defined, then stop here so application writers can catch the error. */
+	configASSERT( ulPortInterruptNesting == ~0UL );
+	portDISABLE_INTERRUPTS();
+	for( ;; );
+}
+/*-----------------------------------------------------------*/
+
+BaseType_t xPortStartScheduler( void )
+{
+uint32_t ulAPSR;
+
+	/* Only continue if the CPU is not in User mode.  The CPU must be in a
+	Privileged mode for the scheduler to start. */
+	__asm( "MRS ulAPSR, APSR" );
+	ulAPSR &= portAPSR_MODE_BITS_MASK;
+	configASSERT( ulAPSR != portAPSR_USER_MODE );
+
+	if( ulAPSR != portAPSR_USER_MODE )
+	{
+		/* Only continue if the binary point value is set to its lowest possible
+		setting.  See the comments in vPortValidateInterruptPriority() below for
+		more information. */
+		configASSERT( ( portICCBPR_BINARY_POINT_REGISTER & portBINARY_POINT_BITS ) <= portMAX_BINARY_POINT_VALUE );
+
+		if( ( portICCBPR_BINARY_POINT_REGISTER & portBINARY_POINT_BITS ) <= portMAX_BINARY_POINT_VALUE )
+		{
+			/* Start the timer that generates the tick ISR. */
+			configSETUP_TICK_INTERRUPT();
+
+			__enable_irq();
+			vPortRestoreTaskContext();
+		}
+	}
+
+	/* Will only get here if vTaskStartScheduler() was called with the CPU in
+	a non-privileged mode or the binary point register was not set to its lowest
+	possible value. */
+	return 0;
+}
+/*-----------------------------------------------------------*/
+
+void vPortEndScheduler( void )
+{
+	/* Not implemented in ports where there is nothing to return to.
+	Artificially force an assert. */
+	configASSERT( ulCriticalNesting == 1000UL );
+}
+/*-----------------------------------------------------------*/
+
+void vPortEnterCritical( void )
+{
+	/* Disable interrupts as per portDISABLE_INTERRUPTS(); 	*/
+	ulPortSetInterruptMask();
+
+	/* Now interrupts are disabled ulCriticalNesting can be accessed
+	directly.  Increment ulCriticalNesting to keep a count of how many times
+	portENTER_CRITICAL() has been called. */
+	ulCriticalNesting++;
+
+	/* This is not the interrupt safe version of the enter critical function so
+	assert() if it is being called from an interrupt context.  Only API
+	functions that end in "FromISR" can be used in an interrupt.  Only assert if
+	the critical nesting count is 1 to protect against recursive calls if the
+	assert function also uses a critical section. */
+	if( ulCriticalNesting == 1 )
+	{
+		configASSERT( ulPortInterruptNesting == 0 );
+	}
+}
+/*-----------------------------------------------------------*/
+
+void vPortExitCritical( void )
+{
+	if( ulCriticalNesting > portNO_CRITICAL_NESTING )
+	{
+		/* Decrement the nesting count as the critical section is being
+		exited. */
+		ulCriticalNesting--;
+
+		/* If the nesting level has reached zero then all interrupt
+		priorities must be re-enabled. */
+		if( ulCriticalNesting == portNO_CRITICAL_NESTING )
+		{
+			/* Critical nesting has reached zero so all interrupt priorities
+			should be unmasked. */
+			portCLEAR_INTERRUPT_MASK();
+		}
+	}
+}
+/*-----------------------------------------------------------*/
+
+void FreeRTOS_Tick_Handler( void )
+{
+	/* Set interrupt mask before altering scheduler structures.   The tick
+	handler runs at the lowest priority, so interrupts cannot already be masked,
+	so there is no need to save and restore the current mask value. */
+	__disable_irq();
+	portICCPMR_PRIORITY_MASK_REGISTER = ( uint32_t ) ( configMAX_API_CALL_INTERRUPT_PRIORITY << portPRIORITY_SHIFT );
+	__asm(	"DSB		\n"
+			"ISB		\n" );
+	__enable_irq();
+
+	/* Increment the RTOS tick. */
+	if( xTaskIncrementTick() != pdFALSE )
+	{
+		ulPortYieldRequired = pdTRUE;
+	}
+
+	/* Ensure all interrupt priorities are active again. */
+	portCLEAR_INTERRUPT_MASK();
+	configCLEAR_TICK_INTERRUPT();
+}
+/*-----------------------------------------------------------*/
+
+void vPortTaskUsesFPU( void )
+{
+uint32_t ulInitialFPSCR = 0;
+
+	/* A task is registering the fact that it needs an FPU context.  Set the
+	FPU flag (which is saved as part of the task context). */
+	ulPortTaskHasFPUContext = pdTRUE;
+
+	/* Initialise the floating point status register. */
+	__asm( "FMXR 	FPSCR, ulInitialFPSCR" );
+}
+/*-----------------------------------------------------------*/
+
+void vPortClearInterruptMask( uint32_t ulNewMaskValue )
+{
+	if( ulNewMaskValue == pdFALSE )
+	{
+		portCLEAR_INTERRUPT_MASK();
+	}
+}
+/*-----------------------------------------------------------*/
+
+uint32_t ulPortSetInterruptMask( void )
+{
+uint32_t ulReturn;
+
+	__disable_irq();
+	if( portICCPMR_PRIORITY_MASK_REGISTER == ( uint32_t ) ( configMAX_API_CALL_INTERRUPT_PRIORITY << portPRIORITY_SHIFT ) )
+	{
+		/* Interrupts were already masked. */
+		ulReturn = pdTRUE;
+	}
+	else
+	{
+		ulReturn = pdFALSE;
+		portICCPMR_PRIORITY_MASK_REGISTER = ( uint32_t ) ( configMAX_API_CALL_INTERRUPT_PRIORITY << portPRIORITY_SHIFT );
+		__asm(	"DSB		\n"
+				"ISB		\n" );
+	}
+	__enable_irq();
+
+	return ulReturn;
+}
+/*-----------------------------------------------------------*/
+
+#if( configASSERT_DEFINED == 1 )
+
+	void vPortValidateInterruptPriority( void )
+	{
+		/* The following assertion will fail if a service routine (ISR) for
+		an interrupt that has been assigned a priority above
+		configMAX_SYSCALL_INTERRUPT_PRIORITY calls an ISR safe FreeRTOS API
+		function.  ISR safe FreeRTOS API functions must *only* be called
+		from interrupts that have been assigned a priority at or below
+		configMAX_SYSCALL_INTERRUPT_PRIORITY.
+
+		Numerically low interrupt priority numbers represent logically high
+		interrupt priorities, therefore the priority of the interrupt must
+		be set to a value equal to or numerically *higher* than
+		configMAX_SYSCALL_INTERRUPT_PRIORITY.
+
+		FreeRTOS maintains separate thread and ISR API functions to ensure
+		interrupt entry is as fast and simple as possible.
+
+		The following links provide detailed information:
+		http://www.freertos.org/RTOS-Cortex-M3-M4.html
+		http://www.freertos.org/FAQHelp.html */
+		configASSERT( portICCRPR_RUNNING_PRIORITY_REGISTER >= ( configMAX_API_CALL_INTERRUPT_PRIORITY << portPRIORITY_SHIFT ) );
+
+		/* Priority grouping:  The interrupt controller (GIC) allows the bits
+		that define each interrupt's priority to be split between bits that
+		define the interrupt's pre-emption priority bits and bits that define
+		the interrupt's sub-priority.  For simplicity all bits must be defined
+		to be pre-emption priority bits.  The following assertion will fail if
+		this is not the case (if some bits represent a sub-priority).
+
+		The priority grouping is configured by the GIC's binary point register
+		(ICCBPR).  Writting 0 to ICCBPR will ensure it is set to its lowest
+		possible value (which may be above 0). */
+		configASSERT( portICCBPR_BINARY_POINT_REGISTER <= portMAX_BINARY_POINT_VALUE );
+	}
+
+#endif /* configASSERT_DEFINED */
+
+
+
+
diff --git a/FreeRTOS/portable/RVDS/ARM_CA9/portASM.s b/FreeRTOS/portable/RVDS/ARM_CA9/portASM.s
new file mode 100644
index 0000000..dcc83df
--- /dev/null
+++ b/FreeRTOS/portable/RVDS/ARM_CA9/portASM.s
@@ -0,0 +1,200 @@
+;/*
+;    FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd.
+;    All rights reserved
+;
+;
+;    ***************************************************************************
+;     *                                                                       *
+;     *    FreeRTOS tutorial books are available in pdf and paperback.        *
+;     *    Complete, revised, and edited pdf reference manuals are also       *
+;     *    available.                                                         *
+;     *                                                                       *
+;     *    Purchasing FreeRTOS documentation will not only help you, by       *
+;     *    ensuring you get running as quickly as possible and with an        *
+;     *    in-depth knowledge of how to use FreeRTOS, it will also help       *
+;     *    the FreeRTOS project to continue with its mission of providing     *
+;     *    professional grade, cross platform, de facto standard solutions    *
+;     *    for microcontrollers - completely free of charge!                  *
+;     *                                                                       *
+;     *    >>> See http://www.FreeRTOS.org/Documentation for details. <<<     *
+;     *                                                                       *
+;     *    Thank you for using FreeRTOS, and thank you for your support!      *
+;     *                                                                       *
+;    ***************************************************************************
+;
+;
+;    This file is part of the FreeRTOS distribution.
+;
+;    FreeRTOS is free software; you can redistribute it and/or modify it under
+;    the terms of the GNU General Public License (version 2) as published by the
+;    Free Software Foundation AND MODIFIED BY the FreeRTOS exception.
+;    >>>NOTE<<< The modification to the GPL is included to allow you to
+;    distribute a combined work that includes FreeRTOS without being obliged to
+;    provide the source code for proprietary components outside of the FreeRTOS
+;    kernel.  FreeRTOS is distributed in the hope that it will be useful, but
+;    WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+;    or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+;    more details. You should have received a copy of the GNU General Public
+;    License and the FreeRTOS license exception along with FreeRTOS; if not it
+;    can be viewed here: http://www.freertos.org/a00114.html and also obtained
+;    by writing to Richard Barry, contact details for whom are available on the
+;    FreeRTOS WEB site.
+;
+;    1 tab == 4 spaces!
+;
+;    http://www.FreeRTOS.org - Documentation, latest information, license and
+;    contact details.
+;
+;    http://www.SafeRTOS.com - A version that is certified for use in safety
+;    critical systems.
+;
+;    http://www.OpenRTOS.com - Commercial support, development, porting,
+;    licensing and training services.
+;*/
+
+	INCLUDE portmacro.inc
+
+	IMPORT	vApplicationIRQHandler
+	IMPORT	vTaskSwitchContext
+	IMPORT	ulPortYieldRequired
+	IMPORT	ulPortInterruptNesting
+	IMPORT	vTaskSwitchContext
+	IMPORT	ulICCIAR
+	IMPORT	ulICCEOIR
+
+	EXPORT	FreeRTOS_SWI_Handler
+	EXPORT  FreeRTOS_IRQ_Handler
+	EXPORT 	vPortRestoreTaskContext
+
+	ARM
+	AREA	PORT_ASM, CODE, READONLY
+
+
+;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
+; SVC handler is used to yield a task.
+;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
+FreeRTOS_SWI_Handler
+
+	PRESERVE8
+
+	; Save the context of the current task and select a new task to run.
+	portSAVE_CONTEXT
+	LDR R0, =vTaskSwitchContext
+	BLX	R0
+	portRESTORE_CONTEXT
+
+;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
+; vPortRestoreTaskContext is used to start the scheduler.
+;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
+vPortRestoreTaskContext
+	; Switch to system mode
+	CPS		#SYS_MODE
+	portRESTORE_CONTEXT
+
+;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
+; PL390 GIC interrupt handler
+;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
+FreeRTOS_IRQ_Handler
+
+	; Return to the interrupted instruction.
+	SUB		lr, lr, #4
+
+	; Push the return address and SPSR
+	PUSH	{lr}
+	MRS		lr, SPSR
+	PUSH	{lr}
+
+	; Change to supervisor mode to allow reentry.
+	CPS		#SVC_MODE
+
+	; Push used registers.
+	PUSH	{r0-r4, r12}
+
+	; Increment nesting count.  r3 holds the address of ulPortInterruptNesting
+	; for future use.  r1 holds the original ulPortInterruptNesting value for
+	; future use.
+	LDR		r3, =ulPortInterruptNesting
+	LDR		r1, [r3]
+	ADD		r4, r1, #1
+	STR		r4, [r3]
+
+	; Read value from the interrupt acknowledge register, which is stored in r0
+	; for future parameter and interrupt clearing use.
+	LDR 	r2, =ulICCIAR
+	LDR		r0, [r2]
+
+	; Ensure bit 2 of the stack pointer is clear.  r2 holds the bit 2 value for
+	; future use.
+	MOV		r2, sp
+	AND		r2, r2, #4
+	SUB		sp, sp, r2
+
+	; Call the interrupt handler
+	PUSH	{r0-r3, lr}
+	LDR		r1, =vApplicationIRQHandler
+	BLX		r1
+	POP		{r0-r3, lr}
+	ADD		sp, sp, r2
+
+	CPSID 	i
+
+	; Write the value read from ICCIAR to ICCEOIR
+	LDR 	r4, =ulICCEOIR
+	STR		r0, [r4]
+
+	; Restore the old nesting count
+	STR		r1, [r3]
+
+	; A context switch is never performed if the nesting count is not 0
+	CMP		r1, #0
+	BNE		exit_without_switch
+
+	; Did the interrupt request a context switch?  r1 holds the address of
+	; ulPortYieldRequired and r0 the value of ulPortYieldRequired for future
+	; use.
+	LDR		r1, =ulPortYieldRequired
+	LDR		r0, [r1]
+	CMP		r0, #0
+	BNE		switch_before_exit
+
+exit_without_switch
+	; No context switch.  Restore used registers, LR_irq and SPSR before
+	; returning.
+	POP		{r0-r4, r12}
+	CPS		#IRQ_MODE
+	POP		{LR}
+	MSR		SPSR_cxsf, LR
+	POP		{LR}
+	MOVS	PC, LR
+
+switch_before_exit
+	; A context swtich is to be performed.  Clear the context switch pending
+	; flag.
+	MOV		r0, #0
+	STR		r0, [r1]
+
+	; Restore used registers, LR-irq and SPSR before saving the context
+	; to the task stack.
+	POP		{r0-r4, r12}
+	CPS		#IRQ_MODE
+	POP		{LR}
+	MSR		SPSR_cxsf, LR
+	POP		{LR}
+	portSAVE_CONTEXT
+
+	; Call the function that selects the new task to execute.
+	; vTaskSwitchContext() if vTaskSwitchContext() uses LDRD or STRD
+	; instructions, or 8 byte aligned stack allocated data.  LR does not need
+	; saving as a new LR will be loaded by portRESTORE_CONTEXT anyway.
+	LDR		r0, =vTaskSwitchContext
+	BLX		r0
+
+	; Restore the context of, and branch to, the task selected to execute next.
+	portRESTORE_CONTEXT
+
+
+	END
+
+
+
+
diff --git a/FreeRTOS/portable/RVDS/ARM_CA9/portmacro.h b/FreeRTOS/portable/RVDS/ARM_CA9/portmacro.h
new file mode 100644
index 0000000..4acd983
--- /dev/null
+++ b/FreeRTOS/portable/RVDS/ARM_CA9/portmacro.h
@@ -0,0 +1,205 @@
+/*
+    FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd.
+    All rights reserved
+
+    VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION.
+
+    This file is part of the FreeRTOS distribution.
+
+    FreeRTOS is free software; you can redistribute it and/or modify it under
+    the terms of the GNU General Public License (version 2) as published by the
+    Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception.
+
+    ***************************************************************************
+    >>!   NOTE: The modification to the GPL is included to allow you to     !<<
+    >>!   distribute a combined work that includes FreeRTOS without being   !<<
+    >>!   obliged to provide the source code for proprietary components     !<<
+    >>!   outside of the FreeRTOS kernel.                                   !<<
+    ***************************************************************************
+
+    FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY
+    WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+    FOR A PARTICULAR PURPOSE.  Full license text is available on the following
+    link: http://www.freertos.org/a00114.html
+
+    ***************************************************************************
+     *                                                                       *
+     *    FreeRTOS provides completely free yet professionally developed,    *
+     *    robust, strictly quality controlled, supported, and cross          *
+     *    platform software that is more than just the market leader, it     *
+     *    is the industry's de facto standard.                               *
+     *                                                                       *
+     *    Help yourself get started quickly while simultaneously helping     *
+     *    to support the FreeRTOS project by purchasing a FreeRTOS           *
+     *    tutorial book, reference manual, or both:                          *
+     *    http://www.FreeRTOS.org/Documentation                              *
+     *                                                                       *
+    ***************************************************************************
+
+    http://www.FreeRTOS.org/FAQHelp.html - Having a problem?  Start by reading
+    the FAQ page "My application does not run, what could be wrong?".  Have you
+    defined configASSERT()?
+
+    http://www.FreeRTOS.org/support - In return for receiving this top quality
+    embedded software for free we request you assist our global community by
+    participating in the support forum.
+
+    http://www.FreeRTOS.org/training - Investing in training allows your team to
+    be as productive as possible as early as possible.  Now you can receive
+    FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers
+    Ltd, and the world's leading authority on the world's leading RTOS.
+
+    http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products,
+    including FreeRTOS+Trace - an indispensable productivity tool, a DOS
+    compatible FAT file system, and our tiny thread aware UDP/IP stack.
+
+    http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate.
+    Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS.
+
+    http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High
+    Integrity Systems ltd. to sell under the OpenRTOS brand.  Low cost OpenRTOS
+    licenses offer ticketed support, indemnification and commercial middleware.
+
+    http://www.SafeRTOS.com - High Integrity Systems also provide a safety
+    engineered and independently SIL3 certified version for use in safety and
+    mission critical applications that require provable dependability.
+
+    1 tab == 4 spaces!
+*/
+
+#ifndef PORTMACRO_H
+#define PORTMACRO_H
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/*-----------------------------------------------------------
+ * Port specific definitions.
+ *
+ * The settings in this file configure FreeRTOS correctly for the given hardware
+ * and compiler.
+ *
+ * These settings should not be altered.
+ *-----------------------------------------------------------
+ */
+
+/* Type definitions. */
+#define portCHAR		char
+#define portFLOAT		float
+#define portDOUBLE		double
+#define portLONG		long
+#define portSHORT		short
+#define portSTACK_TYPE	uint32_t
+#define portBASE_TYPE	long
+
+typedef portSTACK_TYPE StackType_t;
+typedef long BaseType_t;
+typedef unsigned long UBaseType_t;
+
+
+#if( configUSE_16_BIT_TICKS == 1 )
+	typedef uint16_t TickType_t;
+	#define portMAX_DELAY ( TickType_t ) 0xffff
+#else
+	typedef uint32_t TickType_t;
+	#define portMAX_DELAY ( TickType_t ) 0xffffffffUL
+
+	/* 32-bit tick type on a 32-bit architecture, so reads of the tick count do
+	not need to be guarded with a critical section. */
+	#define portTICK_TYPE_IS_ATOMIC 1
+#endif
+/*-----------------------------------------------------------*/
+
+/* Hardware specifics. */
+#define portSTACK_GROWTH			( -1 )
+#define portTICK_PERIOD_MS			( ( TickType_t ) 1000 / configTICK_RATE_HZ )
+#define portBYTE_ALIGNMENT			8
+
+/*-----------------------------------------------------------*/
+
+/* Task utilities. */
+
+/* Called at the end of an ISR that can cause a context switch. */
+#define portEND_SWITCHING_ISR( xSwitchRequired )\
+{												\
+extern uint32_t ulPortYieldRequired;			\
+												\
+	if( xSwitchRequired != pdFALSE )			\
+	{											\
+		ulPortYieldRequired = pdTRUE;			\
+	}											\
+}
+
+#define portYIELD_FROM_ISR( x ) portEND_SWITCHING_ISR( x )
+#define portYIELD() __asm( "SWI 0" );
+
+
+/*-----------------------------------------------------------
+ * Critical section control
+ *----------------------------------------------------------*/
+
+extern void vPortEnterCritical( void );
+extern void vPortExitCritical( void );
+extern uint32_t ulPortSetInterruptMask( void );
+extern void vPortClearInterruptMask( uint32_t ulNewMaskValue );
+
+/* These macros do not globally disable/enable interrupts.  They do mask off
+interrupts that have a priority below configMAX_API_CALL_INTERRUPT_PRIORITY. */
+#define portENTER_CRITICAL()		vPortEnterCritical();
+#define portEXIT_CRITICAL()			vPortExitCritical();
+#define portDISABLE_INTERRUPTS()	ulPortSetInterruptMask()
+#define portENABLE_INTERRUPTS()		vPortClearInterruptMask( 0 )
+#define portSET_INTERRUPT_MASK_FROM_ISR()		ulPortSetInterruptMask()
+#define portCLEAR_INTERRUPT_MASK_FROM_ISR(x)	vPortClearInterruptMask(x)
+
+/*-----------------------------------------------------------*/
+
+/* Task function macros as described on the FreeRTOS.org WEB site.  These are
+not required for this port but included in case common demo code that uses these
+macros is used. */
+#define portTASK_FUNCTION_PROTO( vFunction, pvParameters )	void vFunction( void *pvParameters )
+#define portTASK_FUNCTION( vFunction, pvParameters )	void vFunction( void *pvParameters )
+
+/* Prototype of the FreeRTOS tick handler.  This must be installed as the
+handler for whichever peripheral is used to generate the RTOS tick. */
+void FreeRTOS_Tick_Handler( void );
+
+/* Any task that uses the floating point unit MUST call vPortTaskUsesFPU()
+before any floating point instructions are executed. */
+void vPortTaskUsesFPU( void );
+#define portTASK_USES_FLOATING_POINT() vPortTaskUsesFPU()
+
+#define portLOWEST_INTERRUPT_PRIORITY ( ( ( uint32_t ) configUNIQUE_INTERRUPT_PRIORITIES ) - 1UL )
+#define portLOWEST_USABLE_INTERRUPT_PRIORITY ( portLOWEST_INTERRUPT_PRIORITY - 1UL )
+
+/* Architecture specific optimisations. */
+#ifndef configUSE_PORT_OPTIMISED_TASK_SELECTION
+	#define configUSE_PORT_OPTIMISED_TASK_SELECTION 1
+#endif
+
+#if configUSE_PORT_OPTIMISED_TASK_SELECTION == 1
+
+	/* Store/clear the ready priorities in a bit map. */
+	#define portRECORD_READY_PRIORITY( uxPriority, uxReadyPriorities ) ( uxReadyPriorities ) |= ( 1UL << ( uxPriority ) )
+	#define portRESET_READY_PRIORITY( uxPriority, uxReadyPriorities ) ( uxReadyPriorities ) &= ~( 1UL << ( uxPriority ) )
+
+	/*-----------------------------------------------------------*/
+
+	#define portGET_HIGHEST_PRIORITY( uxTopPriority, uxReadyPriorities ) uxTopPriority = ( 31 - __clz( uxReadyPriorities ) )
+
+#endif /* configUSE_PORT_OPTIMISED_TASK_SELECTION */
+
+#ifdef configASSERT
+	void vPortValidateInterruptPriority( void );
+	#define portASSERT_IF_INTERRUPT_PRIORITY_INVALID() 	vPortValidateInterruptPriority()
+#endif
+
+#define portNOP() __nop()
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* PORTMACRO_H */
+
diff --git a/FreeRTOS/portable/RVDS/ARM_CA9/portmacro.inc b/FreeRTOS/portable/RVDS/ARM_CA9/portmacro.inc
new file mode 100644
index 0000000..b0c3232
--- /dev/null
+++ b/FreeRTOS/portable/RVDS/ARM_CA9/portmacro.inc
@@ -0,0 +1,147 @@
+;/*
+;    FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd.
+;    All rights reserved
+;
+;
+;    ***************************************************************************
+;     *                                                                       *
+;     *    FreeRTOS tutorial books are available in pdf and paperback.        *
+;     *    Complete, revised, and edited pdf reference manuals are also       *
+;     *    available.                                                         *
+;     *                                                                       *
+;     *    Purchasing FreeRTOS documentation will not only help you, by       *
+;     *    ensuring you get running as quickly as possible and with an        *
+;     *    in-depth knowledge of how to use FreeRTOS, it will also help       *
+;     *    the FreeRTOS project to continue with its mission of providing     *
+;     *    professional grade, cross platform, de facto standard solutions    *
+;     *    for microcontrollers - completely free of charge!                  *
+;     *                                                                       *
+;     *    >>> See http://www.FreeRTOS.org/Documentation for details. <<<     *
+;     *                                                                       *
+;     *    Thank you for using FreeRTOS, and thank you for your support!      *
+;     *                                                                       *
+;    ***************************************************************************
+;
+;
+;    This file is part of the FreeRTOS distribution.
+;
+;    FreeRTOS is free software; you can redistribute it and/or modify it under
+;    the terms of the GNU General Public License (version 2) as published by the
+;    Free Software Foundation AND MODIFIED BY the FreeRTOS exception.
+;    >>>NOTE<<< The modification to the GPL is included to allow you to
+;    distribute a combined work that includes FreeRTOS without being obliged to
+;    provide the source code for proprietary components outside of the FreeRTOS
+;    kernel.  FreeRTOS is distributed in the hope that it will be useful, but
+;    WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+;    or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+;    more details. You should have received a copy of the GNU General Public
+;    License and the FreeRTOS license exception along with FreeRTOS; if not it
+;    can be viewed here: http://www.freertos.org/a00114.html and also obtained
+;    by writing to Richard Barry, contact details for whom are available on the
+;    FreeRTOS WEB site.
+;
+;    1 tab == 4 spaces!
+;
+;    http://www.FreeRTOS.org - Documentation, latest information, license and
+;    contact details.
+;
+;    http://www.SafeRTOS.com - A version that is certified for use in safety
+;    critical systems.
+;
+;    http://www.OpenRTOS.com - Commercial support, development, porting,
+;    licensing and training services.
+;*/
+
+SYS_MODE			EQU		0x1f
+SVC_MODE			EQU		0x13
+IRQ_MODE			EQU		0x12
+
+	IMPORT  ulCriticalNesting
+	IMPORT	pxCurrentTCB
+	IMPORT	ulPortTaskHasFPUContext
+	IMPORT  ulAsmAPIPriorityMask
+	IMPORT	ulICCPMR
+
+
+	MACRO
+	portSAVE_CONTEXT
+
+	; Save the LR and SPSR onto the system mode stack before switching to
+	; system mode to save the remaining system mode registers
+	SRSDB	sp!, #SYS_MODE
+	CPS		#SYS_MODE
+	PUSH	{R0-R12, R14}
+
+	; Push the critical nesting count
+	LDR		R2, =ulCriticalNesting
+	LDR		R1, [R2]
+	PUSH	{R1}
+
+	; Does the task have a floating point context that needs saving?  If
+	; ulPortTaskHasFPUContext is 0 then no.
+	LDR		R2, =ulPortTaskHasFPUContext
+	LDR		R3, [R2]
+	CMP		R3, #0
+
+	; Save the floating point context, if any
+	FMRXNE  R1,  FPSCR
+	VPUSHNE {D0-D15}
+	VPUSHNE	{D16-D31}
+	PUSHNE	{R1}
+
+	; Save ulPortTaskHasFPUContext itself
+	PUSH	{R3}
+
+	; Save the stack pointer in the TCB
+	LDR		R0, =pxCurrentTCB
+	LDR		R1, [R0]
+	STR		SP, [R1]
+
+	MEND
+
+; /**********************************************************************/
+
+	MACRO
+	portRESTORE_CONTEXT
+
+	; Set the SP to point to the stack of the task being restored.
+	LDR		R0, =pxCurrentTCB
+	LDR		R1, [R0]
+	LDR		SP, [R1]
+
+	; Is there a floating point context to restore?  If the restored
+	; ulPortTaskHasFPUContext is zero then no.
+	LDR		R0, =ulPortTaskHasFPUContext
+	POP		{R1}
+	STR		R1, [R0]
+	CMP		R1, #0
+
+	; Restore the floating point context, if any
+	POPNE	{R0}
+	VPOPNE	{D16-D31}
+	VPOPNE	{D0-D15}
+	VMSRNE  FPSCR, R0
+
+	; Restore the critical section nesting depth
+	LDR		R0, =ulCriticalNesting
+	POP		{R1}
+	STR		R1, [R0]
+
+	; Ensure the priority mask is correct for the critical nesting depth
+	LDR		R2, =ulICCPMR
+	CMP		R1, #0
+	MOVEQ	R4, #255
+	LDRNE	R4, =ulAsmAPIPriorityMask
+	STR		R4, [r2]
+
+	; Restore all system mode registers other than the SP (which is already
+	; being used)
+	POP		{R0-R12, R14}
+
+	; Return to the task code, loading CPSR on the way.
+	RFEIA	sp!
+
+	MEND
+
+	END
+
diff --git a/FreeRTOS/portable/RVDS/ARM_CM0/port.c b/FreeRTOS/portable/RVDS/ARM_CM0/port.c
new file mode 100644
index 0000000..58138cd
--- /dev/null
+++ b/FreeRTOS/portable/RVDS/ARM_CM0/port.c
@@ -0,0 +1,349 @@
+/*
+    FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd.
+    All rights reserved
+
+    VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION.
+
+    This file is part of the FreeRTOS distribution.
+
+    FreeRTOS is free software; you can redistribute it and/or modify it under
+    the terms of the GNU General Public License (version 2) as published by the
+    Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception.
+
+    ***************************************************************************
+    >>!   NOTE: The modification to the GPL is included to allow you to     !<<
+    >>!   distribute a combined work that includes FreeRTOS without being   !<<
+    >>!   obliged to provide the source code for proprietary components     !<<
+    >>!   outside of the FreeRTOS kernel.                                   !<<
+    ***************************************************************************
+
+    FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY
+    WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+    FOR A PARTICULAR PURPOSE.  Full license text is available on the following
+    link: http://www.freertos.org/a00114.html
+
+    ***************************************************************************
+     *                                                                       *
+     *    FreeRTOS provides completely free yet professionally developed,    *
+     *    robust, strictly quality controlled, supported, and cross          *
+     *    platform software that is more than just the market leader, it     *
+     *    is the industry's de facto standard.                               *
+     *                                                                       *
+     *    Help yourself get started quickly while simultaneously helping     *
+     *    to support the FreeRTOS project by purchasing a FreeRTOS           *
+     *    tutorial book, reference manual, or both:                          *
+     *    http://www.FreeRTOS.org/Documentation                              *
+     *                                                                       *
+    ***************************************************************************
+
+    http://www.FreeRTOS.org/FAQHelp.html - Having a problem?  Start by reading
+    the FAQ page "My application does not run, what could be wrong?".  Have you
+    defined configASSERT()?
+
+    http://www.FreeRTOS.org/support - In return for receiving this top quality
+    embedded software for free we request you assist our global community by
+    participating in the support forum.
+
+    http://www.FreeRTOS.org/training - Investing in training allows your team to
+    be as productive as possible as early as possible.  Now you can receive
+    FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers
+    Ltd, and the world's leading authority on the world's leading RTOS.
+
+    http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products,
+    including FreeRTOS+Trace - an indispensable productivity tool, a DOS
+    compatible FAT file system, and our tiny thread aware UDP/IP stack.
+
+    http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate.
+    Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS.
+
+    http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High
+    Integrity Systems ltd. to sell under the OpenRTOS brand.  Low cost OpenRTOS
+    licenses offer ticketed support, indemnification and commercial middleware.
+
+    http://www.SafeRTOS.com - High Integrity Systems also provide a safety
+    engineered and independently SIL3 certified version for use in safety and
+    mission critical applications that require provable dependability.
+
+    1 tab == 4 spaces!
+*/
+
+/*-----------------------------------------------------------
+ * Implementation of functions defined in portable.h for the ARM CM0 port.
+ *----------------------------------------------------------*/
+
+/* Scheduler includes. */
+#include "FreeRTOS.h"
+#include "task.h"
+
+/* Constants required to manipulate the NVIC. */
+#define portNVIC_SYSTICK_CTRL		( ( volatile uint32_t *) 0xe000e010 )
+#define portNVIC_SYSTICK_LOAD		( ( volatile uint32_t *) 0xe000e014 )
+#define portNVIC_INT_CTRL			( ( volatile uint32_t *) 0xe000ed04 )
+#define portNVIC_SYSPRI2			( ( volatile uint32_t *) 0xe000ed20 )
+#define portNVIC_SYSTICK_CLK		0x00000004
+#define portNVIC_SYSTICK_INT		0x00000002
+#define portNVIC_SYSTICK_ENABLE		0x00000001
+#define portNVIC_PENDSVSET			0x10000000
+#define portMIN_INTERRUPT_PRIORITY	( 255UL )
+#define portNVIC_PENDSV_PRI			( portMIN_INTERRUPT_PRIORITY << 16UL )
+#define portNVIC_SYSTICK_PRI		( portMIN_INTERRUPT_PRIORITY << 24UL )
+
+/* Constants required to set up the initial stack. */
+#define portINITIAL_XPSR			( 0x01000000 )
+
+/* Constants used with memory barrier intrinsics. */
+#define portSY_FULL_READ_WRITE		( 15 )
+
+/* Each task maintains its own interrupt status in the critical nesting
+variable. */
+static UBaseType_t uxCriticalNesting = 0xaaaaaaaa;
+
+/*
+ * Setup the timer to generate the tick interrupts.
+ */
+static void prvSetupTimerInterrupt( void );
+
+/*
+ * Exception handlers.
+ */
+void xPortPendSVHandler( void );
+void xPortSysTickHandler( void );
+void vPortSVCHandler( void );
+
+/*
+ * Start first task is a separate function so it can be tested in isolation.
+ */
+static void prvPortStartFirstTask( void );
+
+/*
+ * Used to catch tasks that attempt to return from their implementing function.
+ */
+static void prvTaskExitError( void );
+
+/*-----------------------------------------------------------*/
+
+/*
+ * See header file for description.
+ */
+StackType_t *pxPortInitialiseStack( StackType_t *pxTopOfStack, TaskFunction_t pxCode, void *pvParameters )
+{
+	/* Simulate the stack frame as it would be created by a context switch
+	interrupt. */
+	pxTopOfStack--; /* Offset added to account for the way the MCU uses the stack on entry/exit of interrupts. */
+	*pxTopOfStack = portINITIAL_XPSR;	/* xPSR */
+	pxTopOfStack--;
+	*pxTopOfStack = ( StackType_t ) pxCode;	/* PC */
+	pxTopOfStack--;
+	*pxTopOfStack = ( StackType_t ) prvTaskExitError;	/* LR */
+	pxTopOfStack -= 5;	/* R12, R3, R2 and R1. */
+	*pxTopOfStack = ( StackType_t ) pvParameters;	/* R0 */
+	pxTopOfStack -= 8; /* R11..R4. */
+
+	return pxTopOfStack;
+}
+/*-----------------------------------------------------------*/
+
+static void prvTaskExitError( void )
+{
+	/* A function that implements a task must not exit or attempt to return to
+	its caller as there is nothing to return to.  If a task wants to exit it
+	should instead call vTaskDelete( NULL ).
+
+	Artificially force an assert() to be triggered if configASSERT() is
+	defined, then stop here so application writers can catch the error. */
+	configASSERT( uxCriticalNesting == ~0UL );
+	portDISABLE_INTERRUPTS();
+	for( ;; );
+}
+/*-----------------------------------------------------------*/
+
+void vPortSVCHandler( void )
+{
+	/* This function is no longer used, but retained for backward
+	compatibility. */
+}
+/*-----------------------------------------------------------*/
+
+__asm void prvPortStartFirstTask( void )
+{
+	extern pxCurrentTCB;
+
+	PRESERVE8
+
+	/* The MSP stack is not reset as, unlike on M3/4 parts, there is no vector
+	table offset register that can be used to locate the initial stack value.
+	Not all M0 parts have the application vector table at address 0. */
+
+	ldr	r3, =pxCurrentTCB	/* Obtain location of pxCurrentTCB. */
+	ldr r1, [r3]
+	ldr r0, [r1]			/* The first item in pxCurrentTCB is the task top of stack. */
+	adds r0, #32			/* Discard everything up to r0. */
+	msr psp, r0				/* This is now the new top of stack to use in the task. */
+	movs r0, #2				/* Switch to the psp stack. */
+	msr CONTROL, r0
+	isb
+	pop {r0-r5}				/* Pop the registers that are saved automatically. */
+	mov lr, r5				/* lr is now in r5. */
+	pop {r3}				/* The return address is now in r3. */
+	pop {r2}				/* Pop and discard the XPSR. */
+	cpsie i					/* The first task has its context and interrupts can be enabled. */
+	bx r3					/* Finally, jump to the user defined task code. */
+
+	ALIGN
+}
+/*-----------------------------------------------------------*/
+
+/*
+ * See header file for description.
+ */
+BaseType_t xPortStartScheduler( void )
+{
+	/* Make PendSV, CallSV and SysTick the same priroity as the kernel. */
+	*(portNVIC_SYSPRI2) |= portNVIC_PENDSV_PRI;
+	*(portNVIC_SYSPRI2) |= portNVIC_SYSTICK_PRI;
+
+	/* Start the timer that generates the tick ISR.  Interrupts are disabled
+	here already. */
+	prvSetupTimerInterrupt();
+
+	/* Initialise the critical nesting count ready for the first task. */
+	uxCriticalNesting = 0;
+
+	/* Start the first task. */
+	prvPortStartFirstTask();
+
+	/* Should not get here! */
+	return 0;
+}
+/*-----------------------------------------------------------*/
+
+void vPortEndScheduler( void )
+{
+	/* Not implemented in ports where there is nothing to return to.
+	Artificially force an assert. */
+	configASSERT( uxCriticalNesting == 1000UL );
+}
+/*-----------------------------------------------------------*/
+
+void vPortYield( void )
+{
+	/* Set a PendSV to request a context switch. */
+	*( portNVIC_INT_CTRL ) = portNVIC_PENDSVSET;
+
+	/* Barriers are normally not required but do ensure the code is completely
+	within the specified behaviour for the architecture. */
+	__dsb( portSY_FULL_READ_WRITE );
+	__isb( portSY_FULL_READ_WRITE );
+}
+/*-----------------------------------------------------------*/
+
+void vPortEnterCritical( void )
+{
+    portDISABLE_INTERRUPTS();
+    uxCriticalNesting++;
+	__dsb( portSY_FULL_READ_WRITE );
+	__isb( portSY_FULL_READ_WRITE );
+}
+/*-----------------------------------------------------------*/
+
+void vPortExitCritical( void )
+{
+	configASSERT( uxCriticalNesting );
+    uxCriticalNesting--;
+    if( uxCriticalNesting == 0 )
+    {
+        portENABLE_INTERRUPTS();
+    }
+}
+/*-----------------------------------------------------------*/
+
+__asm uint32_t ulSetInterruptMaskFromISR( void )
+{
+	mrs r0, PRIMASK
+	cpsid i
+	bx lr
+}
+/*-----------------------------------------------------------*/
+
+__asm void vClearInterruptMaskFromISR( uint32_t ulMask )
+{
+	msr PRIMASK, r0
+	bx lr
+}
+/*-----------------------------------------------------------*/
+
+__asm void xPortPendSVHandler( void )
+{
+	extern vTaskSwitchContext
+	extern pxCurrentTCB
+
+	PRESERVE8
+
+	mrs r0, psp
+
+	ldr	r3, =pxCurrentTCB 	/* Get the location of the current TCB. */
+	ldr	r2, [r3]
+
+	subs r0, #32			/* Make space for the remaining low registers. */
+	str r0, [r2]			/* Save the new top of stack. */
+	stmia r0!, {r4-r7}		/* Store the low registers that are not saved automatically. */
+	mov r4, r8				/* Store the high registers. */
+	mov r5, r9
+	mov r6, r10
+	mov r7, r11
+	stmia r0!, {r4-r7}
+
+	push {r3, r14}
+	cpsid i
+	bl vTaskSwitchContext
+	cpsie i
+	pop {r2, r3}			/* lr goes in r3. r2 now holds tcb pointer. */
+
+	ldr r1, [r2]
+	ldr r0, [r1]			/* The first item in pxCurrentTCB is the task top of stack. */
+	adds r0, #16			/* Move to the high registers. */
+	ldmia r0!, {r4-r7}		/* Pop the high registers. */
+	mov r8, r4
+	mov r9, r5
+	mov r10, r6
+	mov r11, r7
+
+	msr psp, r0				/* Remember the new top of stack for the task. */
+
+	subs r0, #32			/* Go back for the low registers that are not automatically restored. */
+	ldmia r0!, {r4-r7}      /* Pop low registers.  */
+
+	bx r3
+	ALIGN
+}
+/*-----------------------------------------------------------*/
+
+void xPortSysTickHandler( void )
+{
+uint32_t ulPreviousMask;
+
+	ulPreviousMask = portSET_INTERRUPT_MASK_FROM_ISR();
+	{
+		/* Increment the RTOS tick. */
+		if( xTaskIncrementTick() != pdFALSE )
+		{
+			/* Pend a context switch. */
+			*(portNVIC_INT_CTRL) = portNVIC_PENDSVSET;
+		}
+	}
+	portCLEAR_INTERRUPT_MASK_FROM_ISR( ulPreviousMask );
+}
+/*-----------------------------------------------------------*/
+
+/*
+ * Setup the systick timer to generate the tick interrupts at the required
+ * frequency.
+ */
+void prvSetupTimerInterrupt( void )
+{
+	/* Configure SysTick to interrupt at the requested rate. */
+	*(portNVIC_SYSTICK_LOAD) = ( configCPU_CLOCK_HZ / configTICK_RATE_HZ ) - 1UL;
+	*(portNVIC_SYSTICK_CTRL) = portNVIC_SYSTICK_CLK | portNVIC_SYSTICK_INT | portNVIC_SYSTICK_ENABLE;
+}
+/*-----------------------------------------------------------*/
+
diff --git a/FreeRTOS/portable/RVDS/ARM_CM0/portmacro.h b/FreeRTOS/portable/RVDS/ARM_CM0/portmacro.h
new file mode 100644
index 0000000..81c15e8
--- /dev/null
+++ b/FreeRTOS/portable/RVDS/ARM_CM0/portmacro.h
@@ -0,0 +1,156 @@
+/*
+    FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd.
+    All rights reserved
+
+    VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION.
+
+    This file is part of the FreeRTOS distribution.
+
+    FreeRTOS is free software; you can redistribute it and/or modify it under
+    the terms of the GNU General Public License (version 2) as published by the
+    Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception.
+
+    ***************************************************************************
+    >>!   NOTE: The modification to the GPL is included to allow you to     !<<
+    >>!   distribute a combined work that includes FreeRTOS without being   !<<
+    >>!   obliged to provide the source code for proprietary components     !<<
+    >>!   outside of the FreeRTOS kernel.                                   !<<
+    ***************************************************************************
+
+    FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY
+    WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+    FOR A PARTICULAR PURPOSE.  Full license text is available on the following
+    link: http://www.freertos.org/a00114.html
+
+    ***************************************************************************
+     *                                                                       *
+     *    FreeRTOS provides completely free yet professionally developed,    *
+     *    robust, strictly quality controlled, supported, and cross          *
+     *    platform software that is more than just the market leader, it     *
+     *    is the industry's de facto standard.                               *
+     *                                                                       *
+     *    Help yourself get started quickly while simultaneously helping     *
+     *    to support the FreeRTOS project by purchasing a FreeRTOS           *
+     *    tutorial book, reference manual, or both:                          *
+     *    http://www.FreeRTOS.org/Documentation                              *
+     *                                                                       *
+    ***************************************************************************
+
+    http://www.FreeRTOS.org/FAQHelp.html - Having a problem?  Start by reading
+    the FAQ page "My application does not run, what could be wrong?".  Have you
+    defined configASSERT()?
+
+    http://www.FreeRTOS.org/support - In return for receiving this top quality
+    embedded software for free we request you assist our global community by
+    participating in the support forum.
+
+    http://www.FreeRTOS.org/training - Investing in training allows your team to
+    be as productive as possible as early as possible.  Now you can receive
+    FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers
+    Ltd, and the world's leading authority on the world's leading RTOS.
+
+    http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products,
+    including FreeRTOS+Trace - an indispensable productivity tool, a DOS
+    compatible FAT file system, and our tiny thread aware UDP/IP stack.
+
+    http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate.
+    Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS.
+
+    http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High
+    Integrity Systems ltd. to sell under the OpenRTOS brand.  Low cost OpenRTOS
+    licenses offer ticketed support, indemnification and commercial middleware.
+
+    http://www.SafeRTOS.com - High Integrity Systems also provide a safety
+    engineered and independently SIL3 certified version for use in safety and
+    mission critical applications that require provable dependability.
+
+    1 tab == 4 spaces!
+*/
+
+
+#ifndef PORTMACRO_H
+#define PORTMACRO_H
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/*-----------------------------------------------------------
+ * Port specific definitions.
+ *
+ * The settings in this file configure FreeRTOS correctly for the
+ * given hardware and compiler.
+ *
+ * These settings should not be altered.
+ *-----------------------------------------------------------
+ */
+
+/* Type definitions. */
+#define portCHAR		char
+#define portFLOAT		float
+#define portDOUBLE		double
+#define portLONG		long
+#define portSHORT		short
+#define portSTACK_TYPE	uint32_t
+#define portBASE_TYPE	long
+
+typedef portSTACK_TYPE StackType_t;
+typedef long BaseType_t;
+typedef unsigned long UBaseType_t;
+
+#if( configUSE_16_BIT_TICKS == 1 )
+	typedef uint16_t TickType_t;
+	#define portMAX_DELAY ( TickType_t ) 0xffff
+#else
+	typedef uint32_t TickType_t;
+	#define portMAX_DELAY ( TickType_t ) 0xffffffffUL
+
+	/* 32-bit tick type on a 32-bit architecture, so reads of the tick count do
+	not need to be guarded with a critical section. */
+	#define portTICK_TYPE_IS_ATOMIC 1
+#endif
+/*-----------------------------------------------------------*/
+
+/* Architecture specifics. */
+#define portSTACK_GROWTH			( -1 )
+#define portTICK_PERIOD_MS			( ( TickType_t ) 1000 / configTICK_RATE_HZ )
+#define portBYTE_ALIGNMENT			8
+/*-----------------------------------------------------------*/
+
+
+/* Scheduler utilities. */
+extern void vPortYield( void );
+#define portNVIC_INT_CTRL_REG		( * ( ( volatile uint32_t * ) 0xe000ed04 ) )
+#define portNVIC_PENDSVSET_BIT		( 1UL << 28UL )
+#define portYIELD()					vPortYield()
+#define portEND_SWITCHING_ISR( xSwitchRequired ) if( xSwitchRequired ) portNVIC_INT_CTRL_REG = portNVIC_PENDSVSET_BIT
+#define portYIELD_FROM_ISR( x ) portEND_SWITCHING_ISR( x )
+/*-----------------------------------------------------------*/
+
+/* Critical section management. */
+extern void vPortEnterCritical( void );
+extern void vPortExitCritical( void );
+extern uint32_t ulSetInterruptMaskFromISR( void );
+extern void vClearInterruptMaskFromISR( uint32_t ulMask );
+
+#define portSET_INTERRUPT_MASK_FROM_ISR()		ulSetInterruptMaskFromISR()
+#define portCLEAR_INTERRUPT_MASK_FROM_ISR(x)	vClearInterruptMaskFromISR( x )
+#define portDISABLE_INTERRUPTS()				__disable_irq()
+#define portENABLE_INTERRUPTS()					__enable_irq()
+#define portENTER_CRITICAL()					vPortEnterCritical()
+#define portEXIT_CRITICAL()						vPortExitCritical()
+
+/*-----------------------------------------------------------*/
+
+/* Task function macros as described on the FreeRTOS.org WEB site. */
+#define portTASK_FUNCTION_PROTO( vFunction, pvParameters ) void vFunction( void *pvParameters )
+#define portTASK_FUNCTION( vFunction, pvParameters ) void vFunction( void *pvParameters )
+
+#define portNOP()
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* PORTMACRO_H */
+
diff --git a/FreeRTOS/portable/RVDS/ARM_CM3/port.c b/FreeRTOS/portable/RVDS/ARM_CM3/port.c
new file mode 100644
index 0000000..1c43bc5
--- /dev/null
+++ b/FreeRTOS/portable/RVDS/ARM_CM3/port.c
@@ -0,0 +1,701 @@
+/*
+    FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd.
+    All rights reserved
+
+    VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION.
+
+    This file is part of the FreeRTOS distribution.
+
+    FreeRTOS is free software; you can redistribute it and/or modify it under
+    the terms of the GNU General Public License (version 2) as published by the
+    Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception.
+
+    ***************************************************************************
+    >>!   NOTE: The modification to the GPL is included to allow you to     !<<
+    >>!   distribute a combined work that includes FreeRTOS without being   !<<
+    >>!   obliged to provide the source code for proprietary components     !<<
+    >>!   outside of the FreeRTOS kernel.                                   !<<
+    ***************************************************************************
+
+    FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY
+    WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+    FOR A PARTICULAR PURPOSE.  Full license text is available on the following
+    link: http://www.freertos.org/a00114.html
+
+    ***************************************************************************
+     *                                                                       *
+     *    FreeRTOS provides completely free yet professionally developed,    *
+     *    robust, strictly quality controlled, supported, and cross          *
+     *    platform software that is more than just the market leader, it     *
+     *    is the industry's de facto standard.                               *
+     *                                                                       *
+     *    Help yourself get started quickly while simultaneously helping     *
+     *    to support the FreeRTOS project by purchasing a FreeRTOS           *
+     *    tutorial book, reference manual, or both:                          *
+     *    http://www.FreeRTOS.org/Documentation                              *
+     *                                                                       *
+    ***************************************************************************
+
+    http://www.FreeRTOS.org/FAQHelp.html - Having a problem?  Start by reading
+    the FAQ page "My application does not run, what could be wrong?".  Have you
+    defined configASSERT()?
+
+    http://www.FreeRTOS.org/support - In return for receiving this top quality
+    embedded software for free we request you assist our global community by
+    participating in the support forum.
+
+    http://www.FreeRTOS.org/training - Investing in training allows your team to
+    be as productive as possible as early as possible.  Now you can receive
+    FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers
+    Ltd, and the world's leading authority on the world's leading RTOS.
+
+    http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products,
+    including FreeRTOS+Trace - an indispensable productivity tool, a DOS
+    compatible FAT file system, and our tiny thread aware UDP/IP stack.
+
+    http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate.
+    Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS.
+
+    http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High
+    Integrity Systems ltd. to sell under the OpenRTOS brand.  Low cost OpenRTOS
+    licenses offer ticketed support, indemnification and commercial middleware.
+
+    http://www.SafeRTOS.com - High Integrity Systems also provide a safety
+    engineered and independently SIL3 certified version for use in safety and
+    mission critical applications that require provable dependability.
+
+    1 tab == 4 spaces!
+*/
+
+/*-----------------------------------------------------------
+ * Implementation of functions defined in portable.h for the ARM CM3 port.
+ *----------------------------------------------------------*/
+
+/* Scheduler includes. */
+#include "FreeRTOS.h"
+#include "task.h"
+
+#ifndef configKERNEL_INTERRUPT_PRIORITY
+	#define configKERNEL_INTERRUPT_PRIORITY 255
+#endif
+
+#if configMAX_SYSCALL_INTERRUPT_PRIORITY == 0
+	#error configMAX_SYSCALL_INTERRUPT_PRIORITY must not be set to 0.  See http://www.FreeRTOS.org/RTOS-Cortex-M3-M4.html
+#endif
+
+#ifndef configSYSTICK_CLOCK_HZ
+	#define configSYSTICK_CLOCK_HZ configCPU_CLOCK_HZ
+	/* Ensure the SysTick is clocked at the same frequency as the core. */
+	#define portNVIC_SYSTICK_CLK_BIT	( 1UL << 2UL )
+#else
+	/* The way the SysTick is clocked is not modified in case it is not the same
+	as the core. */
+	#define portNVIC_SYSTICK_CLK_BIT	( 0 )
+#endif
+
+/* The __weak attribute does not work as you might expect with the Keil tools
+so the configOVERRIDE_DEFAULT_TICK_CONFIGURATION constant must be set to 1 if
+the application writer wants to provide their own implementation of
+vPortSetupTimerInterrupt().  Ensure configOVERRIDE_DEFAULT_TICK_CONFIGURATION
+is defined. */
+#ifndef configOVERRIDE_DEFAULT_TICK_CONFIGURATION
+	#define configOVERRIDE_DEFAULT_TICK_CONFIGURATION 0
+#endif
+
+/* Constants required to manipulate the core.  Registers first... */
+#define portNVIC_SYSTICK_CTRL_REG			( * ( ( volatile uint32_t * ) 0xe000e010 ) )
+#define portNVIC_SYSTICK_LOAD_REG			( * ( ( volatile uint32_t * ) 0xe000e014 ) )
+#define portNVIC_SYSTICK_CURRENT_VALUE_REG	( * ( ( volatile uint32_t * ) 0xe000e018 ) )
+#define portNVIC_SYSPRI2_REG				( * ( ( volatile uint32_t * ) 0xe000ed20 ) )
+/* ...then bits in the registers. */
+#define portNVIC_SYSTICK_INT_BIT			( 1UL << 1UL )
+#define portNVIC_SYSTICK_ENABLE_BIT			( 1UL << 0UL )
+#define portNVIC_SYSTICK_COUNT_FLAG_BIT		( 1UL << 16UL )
+#define portNVIC_PENDSVCLEAR_BIT 			( 1UL << 27UL )
+#define portNVIC_PEND_SYSTICK_CLEAR_BIT		( 1UL << 25UL )
+
+/* Masks off all bits but the VECTACTIVE bits in the ICSR register. */
+#define portVECTACTIVE_MASK					( 0xFFUL )
+
+#define portNVIC_PENDSV_PRI					( ( ( uint32_t ) configKERNEL_INTERRUPT_PRIORITY ) << 16UL )
+#define portNVIC_SYSTICK_PRI				( ( ( uint32_t ) configKERNEL_INTERRUPT_PRIORITY ) << 24UL )
+
+/* Constants required to check the validity of an interrupt priority. */
+#define portFIRST_USER_INTERRUPT_NUMBER		( 16 )
+#define portNVIC_IP_REGISTERS_OFFSET_16 	( 0xE000E3F0 )
+#define portAIRCR_REG						( * ( ( volatile uint32_t * ) 0xE000ED0C ) )
+#define portMAX_8_BIT_VALUE					( ( uint8_t ) 0xff )
+#define portTOP_BIT_OF_BYTE					( ( uint8_t ) 0x80 )
+#define portMAX_PRIGROUP_BITS				( ( uint8_t ) 7 )
+#define portPRIORITY_GROUP_MASK				( 0x07UL << 8UL )
+#define portPRIGROUP_SHIFT					( 8UL )
+
+/* Constants required to set up the initial stack. */
+#define portINITIAL_XPSR			( 0x01000000 )
+
+/* The systick is a 24-bit counter. */
+#define portMAX_24_BIT_NUMBER				( 0xffffffUL )
+
+/* A fiddle factor to estimate the number of SysTick counts that would have
+occurred while the SysTick counter is stopped during tickless idle
+calculations. */
+#define portMISSED_COUNTS_FACTOR			( 45UL )
+
+/* For strict compliance with the Cortex-M spec the task start address should
+have bit-0 clear, as it is loaded into the PC on exit from an ISR. */
+#define portSTART_ADDRESS_MASK				( ( StackType_t ) 0xfffffffeUL )
+
+/* Each task maintains its own interrupt status in the critical nesting
+variable. */
+static UBaseType_t uxCriticalNesting = 0xaaaaaaaa;
+
+/*
+ * Setup the timer to generate the tick interrupts.  The implementation in this
+ * file is weak to allow application writers to change the timer used to
+ * generate the tick interrupt.
+ */
+void vPortSetupTimerInterrupt( void );
+
+/*
+ * Exception handlers.
+ */
+void xPortPendSVHandler( void );
+void xPortSysTickHandler( void );
+void vPortSVCHandler( void );
+
+/*
+ * Start first task is a separate function so it can be tested in isolation.
+ */
+static void prvStartFirstTask( void );
+
+/*
+ * Used to catch tasks that attempt to return from their implementing function.
+ */
+static void prvTaskExitError( void );
+
+/*-----------------------------------------------------------*/
+
+/*
+ * The number of SysTick increments that make up one tick period.
+ */
+#if configUSE_TICKLESS_IDLE == 1
+	static uint32_t ulTimerCountsForOneTick = 0;
+#endif /* configUSE_TICKLESS_IDLE */
+
+/*
+ * The maximum number of tick periods that can be suppressed is limited by the
+ * 24 bit resolution of the SysTick timer.
+ */
+#if configUSE_TICKLESS_IDLE == 1
+	static uint32_t xMaximumPossibleSuppressedTicks = 0;
+#endif /* configUSE_TICKLESS_IDLE */
+
+/*
+ * Compensate for the CPU cycles that pass while the SysTick is stopped (low
+ * power functionality only.
+ */
+#if configUSE_TICKLESS_IDLE == 1
+	static uint32_t ulStoppedTimerCompensation = 0;
+#endif /* configUSE_TICKLESS_IDLE */
+
+/*
+ * Used by the portASSERT_IF_INTERRUPT_PRIORITY_INVALID() macro to ensure
+ * FreeRTOS API functions are not called from interrupts that have been assigned
+ * a priority above configMAX_SYSCALL_INTERRUPT_PRIORITY.
+ */
+#if ( configASSERT_DEFINED == 1 )
+	 static uint8_t ucMaxSysCallPriority = 0;
+	 static uint32_t ulMaxPRIGROUPValue = 0;
+	 static const volatile uint8_t * const pcInterruptPriorityRegisters = ( uint8_t * ) portNVIC_IP_REGISTERS_OFFSET_16;
+#endif /* configASSERT_DEFINED */
+
+/*-----------------------------------------------------------*/
+
+/*
+ * See header file for description.
+ */
+StackType_t *pxPortInitialiseStack( StackType_t *pxTopOfStack, TaskFunction_t pxCode, void *pvParameters )
+{
+	/* Simulate the stack frame as it would be created by a context switch
+	interrupt. */
+	pxTopOfStack--; /* Offset added to account for the way the MCU uses the stack on entry/exit of interrupts. */
+	*pxTopOfStack = portINITIAL_XPSR;	/* xPSR */
+	pxTopOfStack--;
+	*pxTopOfStack = ( ( StackType_t ) pxCode ) & portSTART_ADDRESS_MASK;	/* PC */
+	pxTopOfStack--;
+	*pxTopOfStack = ( StackType_t ) prvTaskExitError;	/* LR */
+
+	pxTopOfStack -= 5;	/* R12, R3, R2 and R1. */
+	*pxTopOfStack = ( StackType_t ) pvParameters;	/* R0 */
+	pxTopOfStack -= 8;	/* R11, R10, R9, R8, R7, R6, R5 and R4. */
+
+	return pxTopOfStack;
+}
+/*-----------------------------------------------------------*/
+
+static void prvTaskExitError( void )
+{
+	/* A function that implements a task must not exit or attempt to return to
+	its caller as there is nothing to return to.  If a task wants to exit it
+	should instead call vTaskDelete( NULL ).
+
+	Artificially force an assert() to be triggered if configASSERT() is
+	defined, then stop here so application writers can catch the error. */
+	configASSERT( uxCriticalNesting == ~0UL );
+	portDISABLE_INTERRUPTS();
+	for( ;; );
+}
+/*-----------------------------------------------------------*/
+
+__asm void vPortSVCHandler( void )
+{
+	PRESERVE8
+
+	ldr	r3, =pxCurrentTCB	/* Restore the context. */
+	ldr r1, [r3]			/* Use pxCurrentTCBConst to get the pxCurrentTCB address. */
+	ldr r0, [r1]			/* The first item in pxCurrentTCB is the task top of stack. */
+	ldmia r0!, {r4-r11}		/* Pop the registers that are not automatically saved on exception entry and the critical nesting count. */
+	msr psp, r0				/* Restore the task stack pointer. */
+	isb
+	mov r0, #0
+	msr	basepri, r0
+	orr r14, #0xd
+	bx r14
+}
+/*-----------------------------------------------------------*/
+
+__asm void prvStartFirstTask( void )
+{
+	PRESERVE8
+
+	/* Use the NVIC offset register to locate the stack. */
+	ldr r0, =0xE000ED08
+	ldr r0, [r0]
+	ldr r0, [r0]
+
+	/* Set the msp back to the start of the stack. */
+	msr msp, r0
+	/* Globally enable interrupts. */
+	cpsie i
+	cpsie f
+	dsb
+	isb
+	/* Call SVC to start the first task. */
+	svc 0
+	nop
+	nop
+}
+/*-----------------------------------------------------------*/
+
+/*
+ * See header file for description.
+ */
+BaseType_t xPortStartScheduler( void )
+{
+	#if( configASSERT_DEFINED == 1 )
+	{
+		volatile uint32_t ulOriginalPriority;
+		volatile uint8_t * const pucFirstUserPriorityRegister = ( uint8_t * ) ( portNVIC_IP_REGISTERS_OFFSET_16 + portFIRST_USER_INTERRUPT_NUMBER );
+		volatile uint8_t ucMaxPriorityValue;
+
+		/* Determine the maximum priority from which ISR safe FreeRTOS API
+		functions can be called.  ISR safe functions are those that end in
+		"FromISR".  FreeRTOS maintains separate thread and ISR API functions to
+		ensure interrupt entry is as fast and simple as possible.
+
+		Save the interrupt priority value that is about to be clobbered. */
+		ulOriginalPriority = *pucFirstUserPriorityRegister;
+
+		/* Determine the number of priority bits available.  First write to all
+		possible bits. */
+		*pucFirstUserPriorityRegister = portMAX_8_BIT_VALUE;
+
+		/* Read the value back to see how many bits stuck. */
+		ucMaxPriorityValue = *pucFirstUserPriorityRegister;
+
+		/* Use the same mask on the maximum system call priority. */
+		ucMaxSysCallPriority = configMAX_SYSCALL_INTERRUPT_PRIORITY & ucMaxPriorityValue;
+
+		/* Calculate the maximum acceptable priority group value for the number
+		of bits read back. */
+		ulMaxPRIGROUPValue = portMAX_PRIGROUP_BITS;
+		while( ( ucMaxPriorityValue & portTOP_BIT_OF_BYTE ) == portTOP_BIT_OF_BYTE )
+		{
+			ulMaxPRIGROUPValue--;
+			ucMaxPriorityValue <<= ( uint8_t ) 0x01;
+		}
+
+		/* Shift the priority group value back to its position within the AIRCR
+		register. */
+		ulMaxPRIGROUPValue <<= portPRIGROUP_SHIFT;
+		ulMaxPRIGROUPValue &= portPRIORITY_GROUP_MASK;
+
+		/* Restore the clobbered interrupt priority register to its original
+		value. */
+		*pucFirstUserPriorityRegister = ulOriginalPriority;
+	}
+	#endif /* conifgASSERT_DEFINED */
+
+	/* Make PendSV and SysTick the lowest priority interrupts. */
+	portNVIC_SYSPRI2_REG |= portNVIC_PENDSV_PRI;
+	portNVIC_SYSPRI2_REG |= portNVIC_SYSTICK_PRI;
+
+	/* Start the timer that generates the tick ISR.  Interrupts are disabled
+	here already. */
+	vPortSetupTimerInterrupt();
+
+	/* Initialise the critical nesting count ready for the first task. */
+	uxCriticalNesting = 0;
+
+	/* Start the first task. */
+	prvStartFirstTask();
+
+	/* Should not get here! */
+	return 0;
+}
+/*-----------------------------------------------------------*/
+
+void vPortEndScheduler( void )
+{
+	/* Not implemented in ports where there is nothing to return to.
+	Artificially force an assert. */
+	configASSERT( uxCriticalNesting == 1000UL );
+}
+/*-----------------------------------------------------------*/
+
+void vPortEnterCritical( void )
+{
+	portDISABLE_INTERRUPTS();
+	uxCriticalNesting++;
+
+	/* This is not the interrupt safe version of the enter critical function so
+	assert() if it is being called from an interrupt context.  Only API
+	functions that end in "FromISR" can be used in an interrupt.  Only assert if
+	the critical nesting count is 1 to protect against recursive calls if the
+	assert function also uses a critical section. */
+	if( uxCriticalNesting == 1 )
+	{
+		configASSERT( ( portNVIC_INT_CTRL_REG & portVECTACTIVE_MASK ) == 0 );
+	}
+}
+/*-----------------------------------------------------------*/
+
+void vPortExitCritical( void )
+{
+	configASSERT( uxCriticalNesting );
+	uxCriticalNesting--;
+	if( uxCriticalNesting == 0 )
+	{
+		portENABLE_INTERRUPTS();
+	}
+}
+/*-----------------------------------------------------------*/
+
+__asm void xPortPendSVHandler( void )
+{
+	extern uxCriticalNesting;
+	extern pxCurrentTCB;
+	extern vTaskSwitchContext;
+
+	PRESERVE8
+
+	mrs r0, psp
+	isb
+
+	ldr	r3, =pxCurrentTCB		/* Get the location of the current TCB. */
+	ldr	r2, [r3]
+
+	stmdb r0!, {r4-r11}			/* Save the remaining registers. */
+	str r0, [r2]				/* Save the new top of stack into the first member of the TCB. */
+
+	stmdb sp!, {r3, r14}
+	mov r0, #configMAX_SYSCALL_INTERRUPT_PRIORITY
+	msr basepri, r0
+	dsb
+	isb
+	bl vTaskSwitchContext
+	mov r0, #0
+	msr basepri, r0
+	ldmia sp!, {r3, r14}
+
+	ldr r1, [r3]
+	ldr r0, [r1]				/* The first item in pxCurrentTCB is the task top of stack. */
+	ldmia r0!, {r4-r11}			/* Pop the registers and the critical nesting count. */
+	msr psp, r0
+	isb
+	bx r14
+	nop
+}
+/*-----------------------------------------------------------*/
+
+void xPortSysTickHandler( void )
+{
+	/* The SysTick runs at the lowest interrupt priority, so when this interrupt
+	executes all interrupts must be unmasked.  There is therefore no need to
+	save and then restore the interrupt mask value as its value is already
+	known - therefore the slightly faster vPortRaiseBASEPRI() function is used
+	in place of portSET_INTERRUPT_MASK_FROM_ISR(). */
+	vPortRaiseBASEPRI();
+	{
+		/* Increment the RTOS tick. */
+		if( xTaskIncrementTick() != pdFALSE )
+		{
+			/* A context switch is required.  Context switching is performed in
+			the PendSV interrupt.  Pend the PendSV interrupt. */
+			portNVIC_INT_CTRL_REG = portNVIC_PENDSVSET_BIT;
+		}
+	}
+	vPortClearBASEPRIFromISR();
+}
+/*-----------------------------------------------------------*/
+
+#if configUSE_TICKLESS_IDLE == 1
+
+	__weak void vPortSuppressTicksAndSleep( TickType_t xExpectedIdleTime )
+	{
+	uint32_t ulReloadValue, ulCompleteTickPeriods, ulCompletedSysTickDecrements, ulSysTickCTRL;
+	TickType_t xModifiableIdleTime;
+
+		/* Make sure the SysTick reload value does not overflow the counter. */
+		if( xExpectedIdleTime > xMaximumPossibleSuppressedTicks )
+		{
+			xExpectedIdleTime = xMaximumPossibleSuppressedTicks;
+		}
+
+		/* Stop the SysTick momentarily.  The time the SysTick is stopped for
+		is accounted for as best it can be, but using the tickless mode will
+		inevitably result in some tiny drift of the time maintained by the
+		kernel with respect to calendar time. */
+		portNVIC_SYSTICK_CTRL_REG &= ~portNVIC_SYSTICK_ENABLE_BIT;
+
+		/* Calculate the reload value required to wait xExpectedIdleTime
+		tick periods.  -1 is used because this code will execute part way
+		through one of the tick periods. */
+		ulReloadValue = portNVIC_SYSTICK_CURRENT_VALUE_REG + ( ulTimerCountsForOneTick * ( xExpectedIdleTime - 1UL ) );
+		if( ulReloadValue > ulStoppedTimerCompensation )
+		{
+			ulReloadValue -= ulStoppedTimerCompensation;
+		}
+
+		/* Enter a critical section but don't use the taskENTER_CRITICAL()
+		method as that will mask interrupts that should exit sleep mode. */
+		__disable_irq();
+		__dsb( portSY_FULL_READ_WRITE );
+		__isb( portSY_FULL_READ_WRITE );
+
+		/* If a context switch is pending or a task is waiting for the scheduler
+		to be unsuspended then abandon the low power entry. */
+		if( eTaskConfirmSleepModeStatus() == eAbortSleep )
+		{
+			/* Restart from whatever is left in the count register to complete
+			this tick period. */
+			portNVIC_SYSTICK_LOAD_REG = portNVIC_SYSTICK_CURRENT_VALUE_REG;
+
+			/* Restart SysTick. */
+			portNVIC_SYSTICK_CTRL_REG |= portNVIC_SYSTICK_ENABLE_BIT;
+
+			/* Reset the reload register to the value required for normal tick
+			periods. */
+			portNVIC_SYSTICK_LOAD_REG = ulTimerCountsForOneTick - 1UL;
+
+			/* Re-enable interrupts - see comments above __disable_irq() call
+			above. */
+			__enable_irq();
+		}
+		else
+		{
+			/* Set the new reload value. */
+			portNVIC_SYSTICK_LOAD_REG = ulReloadValue;
+
+			/* Clear the SysTick count flag and set the count value back to
+			zero. */
+			portNVIC_SYSTICK_CURRENT_VALUE_REG = 0UL;
+
+			/* Restart SysTick. */
+			portNVIC_SYSTICK_CTRL_REG |= portNVIC_SYSTICK_ENABLE_BIT;
+
+			/* Sleep until something happens.  configPRE_SLEEP_PROCESSING() can
+			set its parameter to 0 to indicate that its implementation contains
+			its own wait for interrupt or wait for event instruction, and so wfi
+			should not be executed again.  However, the original expected idle
+			time variable must remain unmodified, so a copy is taken. */
+			xModifiableIdleTime = xExpectedIdleTime;
+			configPRE_SLEEP_PROCESSING( xModifiableIdleTime );
+			if( xModifiableIdleTime > 0 )
+			{
+				__dsb( portSY_FULL_READ_WRITE );
+				__wfi();
+				__isb( portSY_FULL_READ_WRITE );
+			}
+			configPOST_SLEEP_PROCESSING( xExpectedIdleTime );
+
+			/* Stop SysTick.  Again, the time the SysTick is stopped for is
+			accounted for as best it can be, but using the tickless mode will
+			inevitably result in some tiny drift of the time maintained by the
+			kernel with respect to calendar time. */
+			ulSysTickCTRL = portNVIC_SYSTICK_CTRL_REG;
+			portNVIC_SYSTICK_CTRL_REG = ( ulSysTickCTRL & ~portNVIC_SYSTICK_ENABLE_BIT );
+
+			/* Re-enable interrupts - see comments above __disable_irq() call
+			above. */
+			__enable_irq();
+
+			if( ( ulSysTickCTRL & portNVIC_SYSTICK_COUNT_FLAG_BIT ) != 0 )
+			{
+				uint32_t ulCalculatedLoadValue;
+
+				/* The tick interrupt has already executed, and the SysTick
+				count reloaded with ulReloadValue.  Reset the
+				portNVIC_SYSTICK_LOAD_REG with whatever remains of this tick
+				period. */
+				ulCalculatedLoadValue = ( ulTimerCountsForOneTick - 1UL ) - ( ulReloadValue - portNVIC_SYSTICK_CURRENT_VALUE_REG );
+
+				/* Don't allow a tiny value, or values that have somehow
+				underflowed because the post sleep hook did something
+				that took too long. */
+				if( ( ulCalculatedLoadValue < ulStoppedTimerCompensation ) || ( ulCalculatedLoadValue > ulTimerCountsForOneTick ) )
+				{
+					ulCalculatedLoadValue = ( ulTimerCountsForOneTick - 1UL );
+				}
+
+				portNVIC_SYSTICK_LOAD_REG = ulCalculatedLoadValue;
+
+				/* The tick interrupt handler will already have pended the tick
+				processing in the kernel.  As the pending tick will be
+				processed as soon as this function exits, the tick value
+				maintained by the tick is stepped forward by one less than the
+				time spent waiting. */
+				ulCompleteTickPeriods = xExpectedIdleTime - 1UL;
+			}
+			else
+			{
+				/* Something other than the tick interrupt ended the sleep.
+				Work out how long the sleep lasted rounded to complete tick
+				periods (not the ulReload value which accounted for part
+				ticks). */
+				ulCompletedSysTickDecrements = ( xExpectedIdleTime * ulTimerCountsForOneTick ) - portNVIC_SYSTICK_CURRENT_VALUE_REG;
+
+				/* How many complete tick periods passed while the processor
+				was waiting? */
+				ulCompleteTickPeriods = ulCompletedSysTickDecrements / ulTimerCountsForOneTick;
+
+				/* The reload value is set to whatever fraction of a single tick
+				period remains. */
+				portNVIC_SYSTICK_LOAD_REG = ( ( ulCompleteTickPeriods + 1UL ) * ulTimerCountsForOneTick ) - ulCompletedSysTickDecrements;
+			}
+
+			/* Restart SysTick so it runs from portNVIC_SYSTICK_LOAD_REG
+			again, then set portNVIC_SYSTICK_LOAD_REG back to its standard
+			value.  The critical section is used to ensure the tick interrupt
+			can only execute once in the case that the reload register is near
+			zero. */
+			portNVIC_SYSTICK_CURRENT_VALUE_REG = 0UL;
+			portENTER_CRITICAL();
+			{
+				portNVIC_SYSTICK_CTRL_REG |= portNVIC_SYSTICK_ENABLE_BIT;
+				vTaskStepTick( ulCompleteTickPeriods );
+				portNVIC_SYSTICK_LOAD_REG = ulTimerCountsForOneTick - 1UL;
+			}
+			portEXIT_CRITICAL();
+		}
+	}
+
+#endif /* #if configUSE_TICKLESS_IDLE */
+
+/*-----------------------------------------------------------*/
+
+/*
+ * Setup the SysTick timer to generate the tick interrupts at the required
+ * frequency.
+ */
+#if configOVERRIDE_DEFAULT_TICK_CONFIGURATION == 0
+
+	void vPortSetupTimerInterrupt( void )
+	{
+		/* Calculate the constants required to configure the tick interrupt. */
+		#if configUSE_TICKLESS_IDLE == 1
+		{
+			ulTimerCountsForOneTick = ( configSYSTICK_CLOCK_HZ / configTICK_RATE_HZ );
+			xMaximumPossibleSuppressedTicks = portMAX_24_BIT_NUMBER / ulTimerCountsForOneTick;
+			ulStoppedTimerCompensation = portMISSED_COUNTS_FACTOR / ( configCPU_CLOCK_HZ / configSYSTICK_CLOCK_HZ );
+		}
+		#endif /* configUSE_TICKLESS_IDLE */
+
+		/* Configure SysTick to interrupt at the requested rate. */
+		portNVIC_SYSTICK_LOAD_REG = ( configSYSTICK_CLOCK_HZ / configTICK_RATE_HZ ) - 1UL;
+		portNVIC_SYSTICK_CTRL_REG = ( portNVIC_SYSTICK_CLK_BIT | portNVIC_SYSTICK_INT_BIT | portNVIC_SYSTICK_ENABLE_BIT );
+	}
+
+#endif /* configOVERRIDE_DEFAULT_TICK_CONFIGURATION */
+/*-----------------------------------------------------------*/
+
+__asm uint32_t vPortGetIPSR( void )
+{
+	PRESERVE8
+
+	mrs r0, ipsr
+	bx r14
+}
+/*-----------------------------------------------------------*/
+
+#if( configASSERT_DEFINED == 1 )
+
+	void vPortValidateInterruptPriority( void )
+	{
+	uint32_t ulCurrentInterrupt;
+	uint8_t ucCurrentPriority;
+
+		/* Obtain the number of the currently executing interrupt. */
+		ulCurrentInterrupt = vPortGetIPSR();
+
+		/* Is the interrupt number a user defined interrupt? */
+		if( ulCurrentInterrupt >= portFIRST_USER_INTERRUPT_NUMBER )
+		{
+			/* Look up the interrupt's priority. */
+			ucCurrentPriority = pcInterruptPriorityRegisters[ ulCurrentInterrupt ];
+
+			/* The following assertion will fail if a service routine (ISR) for
+			an interrupt that has been assigned a priority above
+			configMAX_SYSCALL_INTERRUPT_PRIORITY calls an ISR safe FreeRTOS API
+			function.  ISR safe FreeRTOS API functions must *only* be called
+			from interrupts that have been assigned a priority at or below
+			configMAX_SYSCALL_INTERRUPT_PRIORITY.
+
+			Numerically low interrupt priority numbers represent logically high
+			interrupt priorities, therefore the priority of the interrupt must
+			be set to a value equal to or numerically *higher* than
+			configMAX_SYSCALL_INTERRUPT_PRIORITY.
+
+			Interrupts that	use the FreeRTOS API must not be left at their
+			default priority of	zero as that is the highest possible priority,
+			which is guaranteed to be above configMAX_SYSCALL_INTERRUPT_PRIORITY,
+			and	therefore also guaranteed to be invalid.
+
+			FreeRTOS maintains separate thread and ISR API functions to ensure
+			interrupt entry is as fast and simple as possible.
+
+			The following links provide detailed information:
+			http://www.freertos.org/RTOS-Cortex-M3-M4.html
+			http://www.freertos.org/FAQHelp.html */
+			configASSERT( ucCurrentPriority >= ucMaxSysCallPriority );
+		}
+
+		/* Priority grouping:  The interrupt controller (NVIC) allows the bits
+		that define each interrupt's priority to be split between bits that
+		define the interrupt's pre-emption priority bits and bits that define
+		the interrupt's sub-priority.  For simplicity all bits must be defined
+		to be pre-emption priority bits.  The following assertion will fail if
+		this is not the case (if some bits represent a sub-priority).
+
+		If the application only uses CMSIS libraries for interrupt
+		configuration then the correct setting can be achieved on all Cortex-M
+		devices by calling NVIC_SetPriorityGrouping( 0 ); before starting the
+		scheduler.  Note however that some vendor specific peripheral libraries
+		assume a non-zero priority group setting, in which cases using a value
+		of zero will result in unpredicable behaviour. */
+		configASSERT( ( portAIRCR_REG & portPRIORITY_GROUP_MASK ) <= ulMaxPRIGROUPValue );
+	}
+
+#endif /* configASSERT_DEFINED */
+
+
diff --git a/FreeRTOS/portable/RVDS/ARM_CM3/portmacro.h b/FreeRTOS/portable/RVDS/ARM_CM3/portmacro.h
new file mode 100644
index 0000000..0b6eb5a
--- /dev/null
+++ b/FreeRTOS/portable/RVDS/ARM_CM3/portmacro.h
@@ -0,0 +1,294 @@
+/*
+    FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd.
+    All rights reserved
+
+    VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION.
+
+    This file is part of the FreeRTOS distribution.
+
+    FreeRTOS is free software; you can redistribute it and/or modify it under
+    the terms of the GNU General Public License (version 2) as published by the
+    Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception.
+
+    ***************************************************************************
+    >>!   NOTE: The modification to the GPL is included to allow you to     !<<
+    >>!   distribute a combined work that includes FreeRTOS without being   !<<
+    >>!   obliged to provide the source code for proprietary components     !<<
+    >>!   outside of the FreeRTOS kernel.                                   !<<
+    ***************************************************************************
+
+    FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY
+    WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+    FOR A PARTICULAR PURPOSE.  Full license text is available on the following
+    link: http://www.freertos.org/a00114.html
+
+    ***************************************************************************
+     *                                                                       *
+     *    FreeRTOS provides completely free yet professionally developed,    *
+     *    robust, strictly quality controlled, supported, and cross          *
+     *    platform software that is more than just the market leader, it     *
+     *    is the industry's de facto standard.                               *
+     *                                                                       *
+     *    Help yourself get started quickly while simultaneously helping     *
+     *    to support the FreeRTOS project by purchasing a FreeRTOS           *
+     *    tutorial book, reference manual, or both:                          *
+     *    http://www.FreeRTOS.org/Documentation                              *
+     *                                                                       *
+    ***************************************************************************
+
+    http://www.FreeRTOS.org/FAQHelp.html - Having a problem?  Start by reading
+    the FAQ page "My application does not run, what could be wrong?".  Have you
+    defined configASSERT()?
+
+    http://www.FreeRTOS.org/support - In return for receiving this top quality
+    embedded software for free we request you assist our global community by
+    participating in the support forum.
+
+    http://www.FreeRTOS.org/training - Investing in training allows your team to
+    be as productive as possible as early as possible.  Now you can receive
+    FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers
+    Ltd, and the world's leading authority on the world's leading RTOS.
+
+    http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products,
+    including FreeRTOS+Trace - an indispensable productivity tool, a DOS
+    compatible FAT file system, and our tiny thread aware UDP/IP stack.
+
+    http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate.
+    Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS.
+
+    http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High
+    Integrity Systems ltd. to sell under the OpenRTOS brand.  Low cost OpenRTOS
+    licenses offer ticketed support, indemnification and commercial middleware.
+
+    http://www.SafeRTOS.com - High Integrity Systems also provide a safety
+    engineered and independently SIL3 certified version for use in safety and
+    mission critical applications that require provable dependability.
+
+    1 tab == 4 spaces!
+*/
+
+
+#ifndef PORTMACRO_H
+#define PORTMACRO_H
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/*-----------------------------------------------------------
+ * Port specific definitions.
+ *
+ * The settings in this file configure FreeRTOS correctly for the
+ * given hardware and compiler.
+ *
+ * These settings should not be altered.
+ *-----------------------------------------------------------
+ */
+
+/* Type definitions. */
+#define portCHAR		char
+#define portFLOAT		float
+#define portDOUBLE		double
+#define portLONG		long
+#define portSHORT		short
+#define portSTACK_TYPE	uint32_t
+#define portBASE_TYPE	long
+
+typedef portSTACK_TYPE StackType_t;
+typedef long BaseType_t;
+typedef unsigned long UBaseType_t;
+
+#if( configUSE_16_BIT_TICKS == 1 )
+	typedef uint16_t TickType_t;
+	#define portMAX_DELAY ( TickType_t ) 0xffff
+#else
+	typedef uint32_t TickType_t;
+	#define portMAX_DELAY ( TickType_t ) 0xffffffffUL
+
+	/* 32-bit tick type on a 32-bit architecture, so reads of the tick count do
+	not need to be guarded with a critical section. */
+	#define portTICK_TYPE_IS_ATOMIC 1
+#endif
+/*-----------------------------------------------------------*/
+
+/* Architecture specifics. */
+#define portSTACK_GROWTH			( -1 )
+#define portTICK_PERIOD_MS			( ( TickType_t ) 1000 / configTICK_RATE_HZ )
+#define portBYTE_ALIGNMENT			8
+
+/* Constants used with memory barrier intrinsics. */
+#define portSY_FULL_READ_WRITE		( 15 )
+
+/*-----------------------------------------------------------*/
+
+/* Scheduler utilities. */
+#define portYIELD()																\
+{																				\
+	/* Set a PendSV to request a context switch. */								\
+	portNVIC_INT_CTRL_REG = portNVIC_PENDSVSET_BIT;								\
+																				\
+	/* Barriers are normally not required but do ensure the code is completely	\
+	within the specified behaviour for the architecture. */						\
+	__dsb( portSY_FULL_READ_WRITE );											\
+	__isb( portSY_FULL_READ_WRITE );											\
+}
+/*-----------------------------------------------------------*/
+
+#define portNVIC_INT_CTRL_REG		( * ( ( volatile uint32_t * ) 0xe000ed04 ) )
+#define portNVIC_PENDSVSET_BIT		( 1UL << 28UL )
+#define portEND_SWITCHING_ISR( xSwitchRequired ) if( xSwitchRequired != pdFALSE ) portYIELD()
+#define portYIELD_FROM_ISR( x ) portEND_SWITCHING_ISR( x )
+/*-----------------------------------------------------------*/
+
+/* Critical section management. */
+extern void vPortEnterCritical( void );
+extern void vPortExitCritical( void );
+
+#define portDISABLE_INTERRUPTS()				vPortRaiseBASEPRI()
+#define portENABLE_INTERRUPTS()					vPortSetBASEPRI( 0 )
+#define portENTER_CRITICAL()					vPortEnterCritical()
+#define portEXIT_CRITICAL()						vPortExitCritical()
+#define portSET_INTERRUPT_MASK_FROM_ISR()		ulPortRaiseBASEPRI()
+#define portCLEAR_INTERRUPT_MASK_FROM_ISR(x)	vPortSetBASEPRI(x)
+
+/*-----------------------------------------------------------*/
+
+/* Tickless idle/low power functionality. */
+#ifndef portSUPPRESS_TICKS_AND_SLEEP
+	extern void vPortSuppressTicksAndSleep( TickType_t xExpectedIdleTime );
+	#define portSUPPRESS_TICKS_AND_SLEEP( xExpectedIdleTime ) vPortSuppressTicksAndSleep( xExpectedIdleTime )
+#endif
+/*-----------------------------------------------------------*/
+
+/* Port specific optimisations. */
+#ifndef configUSE_PORT_OPTIMISED_TASK_SELECTION
+	#define configUSE_PORT_OPTIMISED_TASK_SELECTION 1
+#endif
+
+#if configUSE_PORT_OPTIMISED_TASK_SELECTION == 1
+
+	/* Check the configuration. */
+	#if( configMAX_PRIORITIES > 32 )
+		#error configUSE_PORT_OPTIMISED_TASK_SELECTION can only be set to 1 when configMAX_PRIORITIES is less than or equal to 32.  It is very rare that a system requires more than 10 to 15 difference priorities as tasks that share a priority will time slice.
+	#endif
+
+	/* Store/clear the ready priorities in a bit map. */
+	#define portRECORD_READY_PRIORITY( uxPriority, uxReadyPriorities ) ( uxReadyPriorities ) |= ( 1UL << ( uxPriority ) )
+	#define portRESET_READY_PRIORITY( uxPriority, uxReadyPriorities ) ( uxReadyPriorities ) &= ~( 1UL << ( uxPriority ) )
+
+	/*-----------------------------------------------------------*/
+
+	#define portGET_HIGHEST_PRIORITY( uxTopPriority, uxReadyPriorities ) uxTopPriority = ( 31UL - ( uint32_t ) __clz( ( uxReadyPriorities ) ) )
+
+#endif /* taskRECORD_READY_PRIORITY */
+/*-----------------------------------------------------------*/
+
+/* Task function macros as described on the FreeRTOS.org WEB site.  These are
+not necessary for to use this port.  They are defined so the common demo files
+(which build with all the ports) will build. */
+#define portTASK_FUNCTION_PROTO( vFunction, pvParameters ) void vFunction( void *pvParameters )
+#define portTASK_FUNCTION( vFunction, pvParameters ) void vFunction( void *pvParameters )
+/*-----------------------------------------------------------*/
+
+#ifdef configASSERT
+	void vPortValidateInterruptPriority( void );
+	#define portASSERT_IF_INTERRUPT_PRIORITY_INVALID() 	vPortValidateInterruptPriority()
+#endif
+
+/* portNOP() is not required by this port. */
+#define portNOP()
+
+#define portINLINE __inline
+
+#ifndef portFORCE_INLINE
+	#define portFORCE_INLINE __forceinline
+#endif
+
+/*-----------------------------------------------------------*/
+
+static portFORCE_INLINE void vPortSetBASEPRI( uint32_t ulBASEPRI )
+{
+	__asm
+	{
+		/* Barrier instructions are not used as this function is only used to
+		lower the BASEPRI value. */
+		msr basepri, ulBASEPRI
+	}
+}
+/*-----------------------------------------------------------*/
+
+static portFORCE_INLINE void vPortRaiseBASEPRI( void )
+{
+uint32_t ulNewBASEPRI = configMAX_SYSCALL_INTERRUPT_PRIORITY;
+
+	__asm
+	{
+		/* Set BASEPRI to the max syscall priority to effect a critical
+		section. */
+		msr basepri, ulNewBASEPRI
+		dsb
+		isb
+	}
+}
+/*-----------------------------------------------------------*/
+
+static portFORCE_INLINE void vPortClearBASEPRIFromISR( void )
+{
+	__asm
+	{
+		/* Set BASEPRI to 0 so no interrupts are masked.  This function is only
+		used to lower the mask in an interrupt, so memory barriers are not 
+		used. */
+		msr basepri, #0
+	}
+}
+/*-----------------------------------------------------------*/
+
+static portFORCE_INLINE uint32_t ulPortRaiseBASEPRI( void )
+{
+uint32_t ulReturn, ulNewBASEPRI = configMAX_SYSCALL_INTERRUPT_PRIORITY;
+
+	__asm
+	{
+		/* Set BASEPRI to the max syscall priority to effect a critical
+		section. */
+		mrs ulReturn, basepri
+		msr basepri, ulNewBASEPRI
+		dsb
+		isb
+	}
+
+	return ulReturn;
+}
+/*-----------------------------------------------------------*/
+
+static portFORCE_INLINE BaseType_t xPortIsInsideInterrupt( void )
+{
+uint32_t ulCurrentInterrupt;
+BaseType_t xReturn;
+
+	/* Obtain the number of the currently executing interrupt. */
+	__asm
+	{
+		mrs ulCurrentInterrupt, ipsr
+	}
+
+	if( ulCurrentInterrupt == 0 )
+	{
+		xReturn = pdFALSE;
+	}
+	else
+	{
+		xReturn = pdTRUE;
+	}
+
+	return xReturn;
+}
+
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* PORTMACRO_H */
+
diff --git a/FreeRTOS/portable/RVDS/ARM_CM4F/port.c b/FreeRTOS/portable/RVDS/ARM_CM4F/port.c
new file mode 100644
index 0000000..ab1766c
--- /dev/null
+++ b/FreeRTOS/portable/RVDS/ARM_CM4F/port.c
@@ -0,0 +1,789 @@
+/*
+    FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd.
+    All rights reserved
+
+    VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION.
+
+    This file is part of the FreeRTOS distribution.
+
+    FreeRTOS is free software; you can redistribute it and/or modify it under
+    the terms of the GNU General Public License (version 2) as published by the
+    Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception.
+
+    ***************************************************************************
+    >>!   NOTE: The modification to the GPL is included to allow you to     !<<
+    >>!   distribute a combined work that includes FreeRTOS without being   !<<
+    >>!   obliged to provide the source code for proprietary components     !<<
+    >>!   outside of the FreeRTOS kernel.                                   !<<
+    ***************************************************************************
+
+    FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY
+    WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+    FOR A PARTICULAR PURPOSE.  Full license text is available on the following
+    link: http://www.freertos.org/a00114.html
+
+    ***************************************************************************
+     *                                                                       *
+     *    FreeRTOS provides completely free yet professionally developed,    *
+     *    robust, strictly quality controlled, supported, and cross          *
+     *    platform software that is more than just the market leader, it     *
+     *    is the industry's de facto standard.                               *
+     *                                                                       *
+     *    Help yourself get started quickly while simultaneously helping     *
+     *    to support the FreeRTOS project by purchasing a FreeRTOS           *
+     *    tutorial book, reference manual, or both:                          *
+     *    http://www.FreeRTOS.org/Documentation                              *
+     *                                                                       *
+    ***************************************************************************
+
+    http://www.FreeRTOS.org/FAQHelp.html - Having a problem?  Start by reading
+    the FAQ page "My application does not run, what could be wrong?".  Have you
+    defined configASSERT()?
+
+    http://www.FreeRTOS.org/support - In return for receiving this top quality
+    embedded software for free we request you assist our global community by
+    participating in the support forum.
+
+    http://www.FreeRTOS.org/training - Investing in training allows your team to
+    be as productive as possible as early as possible.  Now you can receive
+    FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers
+    Ltd, and the world's leading authority on the world's leading RTOS.
+
+    http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products,
+    including FreeRTOS+Trace - an indispensable productivity tool, a DOS
+    compatible FAT file system, and our tiny thread aware UDP/IP stack.
+
+    http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate.
+    Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS.
+
+    http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High
+    Integrity Systems ltd. to sell under the OpenRTOS brand.  Low cost OpenRTOS
+    licenses offer ticketed support, indemnification and commercial middleware.
+
+    http://www.SafeRTOS.com - High Integrity Systems also provide a safety
+    engineered and independently SIL3 certified version for use in safety and
+    mission critical applications that require provable dependability.
+
+    1 tab == 4 spaces!
+*/
+
+/*-----------------------------------------------------------
+ * Implementation of functions defined in portable.h for the ARM CM4F port.
+ *----------------------------------------------------------*/
+
+/* Scheduler includes. */
+#include "FreeRTOS.h"
+#include "task.h"
+
+#ifndef __TARGET_FPU_VFP
+	#error This port can only be used when the project options are configured to enable hardware floating point support.
+#endif
+
+#if configMAX_SYSCALL_INTERRUPT_PRIORITY == 0
+	#error configMAX_SYSCALL_INTERRUPT_PRIORITY must not be set to 0.  See http://www.FreeRTOS.org/RTOS-Cortex-M3-M4.html
+#endif
+
+#ifndef configSYSTICK_CLOCK_HZ
+	#define configSYSTICK_CLOCK_HZ configCPU_CLOCK_HZ
+	/* Ensure the SysTick is clocked at the same frequency as the core. */
+	#define portNVIC_SYSTICK_CLK_BIT	( 1UL << 2UL )
+#else
+	/* The way the SysTick is clocked is not modified in case it is not the same
+	as the core. */
+	#define portNVIC_SYSTICK_CLK_BIT	( 0 )
+#endif
+
+/* The __weak attribute does not work as you might expect with the Keil tools
+so the configOVERRIDE_DEFAULT_TICK_CONFIGURATION constant must be set to 1 if
+the application writer wants to provide their own implementation of
+vPortSetupTimerInterrupt().  Ensure configOVERRIDE_DEFAULT_TICK_CONFIGURATION
+is defined. */
+#ifndef configOVERRIDE_DEFAULT_TICK_CONFIGURATION
+	#define configOVERRIDE_DEFAULT_TICK_CONFIGURATION 0
+#endif
+
+/* Constants required to manipulate the core.  Registers first... */
+#define portNVIC_SYSTICK_CTRL_REG			( * ( ( volatile uint32_t * ) 0xe000e010 ) )
+#define portNVIC_SYSTICK_LOAD_REG			( * ( ( volatile uint32_t * ) 0xe000e014 ) )
+#define portNVIC_SYSTICK_CURRENT_VALUE_REG	( * ( ( volatile uint32_t * ) 0xe000e018 ) )
+#define portNVIC_SYSPRI2_REG				( * ( ( volatile uint32_t * ) 0xe000ed20 ) )
+/* ...then bits in the registers. */
+#define portNVIC_SYSTICK_INT_BIT			( 1UL << 1UL )
+#define portNVIC_SYSTICK_ENABLE_BIT			( 1UL << 0UL )
+#define portNVIC_SYSTICK_COUNT_FLAG_BIT		( 1UL << 16UL )
+#define portNVIC_PENDSVCLEAR_BIT 			( 1UL << 27UL )
+#define portNVIC_PEND_SYSTICK_CLEAR_BIT		( 1UL << 25UL )
+
+/* Constants used to detect a Cortex-M7 r0p1 core, which should use the ARM_CM7
+r0p1 port. */
+#define portCPUID							( * ( ( volatile uint32_t * ) 0xE000ed00 ) )
+#define portCORTEX_M7_r0p1_ID				( 0x410FC271UL )
+#define portCORTEX_M7_r0p0_ID				( 0x410FC270UL )
+
+#define portNVIC_PENDSV_PRI					( ( ( uint32_t ) configKERNEL_INTERRUPT_PRIORITY ) << 16UL )
+#define portNVIC_SYSTICK_PRI				( ( ( uint32_t ) configKERNEL_INTERRUPT_PRIORITY ) << 24UL )
+
+/* Constants required to check the validity of an interrupt priority. */
+#define portFIRST_USER_INTERRUPT_NUMBER		( 16 )
+#define portNVIC_IP_REGISTERS_OFFSET_16 	( 0xE000E3F0 )
+#define portAIRCR_REG						( * ( ( volatile uint32_t * ) 0xE000ED0C ) )
+#define portMAX_8_BIT_VALUE					( ( uint8_t ) 0xff )
+#define portTOP_BIT_OF_BYTE					( ( uint8_t ) 0x80 )
+#define portMAX_PRIGROUP_BITS				( ( uint8_t ) 7 )
+#define portPRIORITY_GROUP_MASK				( 0x07UL << 8UL )
+#define portPRIGROUP_SHIFT					( 8UL )
+
+/* Masks off all bits but the VECTACTIVE bits in the ICSR register. */
+#define portVECTACTIVE_MASK					( 0xFFUL )
+
+/* Constants required to manipulate the VFP. */
+#define portFPCCR					( ( volatile uint32_t * ) 0xe000ef34 ) /* Floating point context control register. */
+#define portASPEN_AND_LSPEN_BITS	( 0x3UL << 30UL )
+
+/* Constants required to set up the initial stack. */
+#define portINITIAL_XPSR			( 0x01000000 )
+#define portINITIAL_EXEC_RETURN		( 0xfffffffd )
+
+/* The systick is a 24-bit counter. */
+#define portMAX_24_BIT_NUMBER		( 0xffffffUL )
+
+/* A fiddle factor to estimate the number of SysTick counts that would have
+occurred while the SysTick counter is stopped during tickless idle
+calculations. */
+#define portMISSED_COUNTS_FACTOR	( 45UL )
+
+/* For strict compliance with the Cortex-M spec the task start address should
+have bit-0 clear, as it is loaded into the PC on exit from an ISR. */
+#define portSTART_ADDRESS_MASK		( ( StackType_t ) 0xfffffffeUL )
+
+/* Each task maintains its own interrupt status in the critical nesting
+variable. */
+static UBaseType_t uxCriticalNesting = 0xaaaaaaaa;
+
+/*
+ * Setup the timer to generate the tick interrupts.  The implementation in this
+ * file is weak to allow application writers to change the timer used to
+ * generate the tick interrupt.
+ */
+void vPortSetupTimerInterrupt( void );
+
+/*
+ * Exception handlers.
+ */
+void xPortPendSVHandler( void );
+void xPortSysTickHandler( void );
+void vPortSVCHandler( void );
+
+/*
+ * Start first task is a separate function so it can be tested in isolation.
+ */
+static void prvStartFirstTask( void );
+
+/*
+ * Functions defined in portasm.s to enable the VFP.
+ */
+static void prvEnableVFP( void );
+
+/*
+ * Used to catch tasks that attempt to return from their implementing function.
+ */
+static void prvTaskExitError( void );
+
+/*-----------------------------------------------------------*/
+
+/*
+ * The number of SysTick increments that make up one tick period.
+ */
+#if configUSE_TICKLESS_IDLE == 1
+	static uint32_t ulTimerCountsForOneTick = 0;
+#endif /* configUSE_TICKLESS_IDLE */
+
+/*
+ * The maximum number of tick periods that can be suppressed is limited by the
+ * 24 bit resolution of the SysTick timer.
+ */
+#if configUSE_TICKLESS_IDLE == 1
+	static uint32_t xMaximumPossibleSuppressedTicks = 0;
+#endif /* configUSE_TICKLESS_IDLE */
+
+/*
+ * Compensate for the CPU cycles that pass while the SysTick is stopped (low
+ * power functionality only.
+ */
+#if configUSE_TICKLESS_IDLE == 1
+	static uint32_t ulStoppedTimerCompensation = 0;
+#endif /* configUSE_TICKLESS_IDLE */
+
+/*
+ * Used by the portASSERT_IF_INTERRUPT_PRIORITY_INVALID() macro to ensure
+ * FreeRTOS API functions are not called from interrupts that have been assigned
+ * a priority above configMAX_SYSCALL_INTERRUPT_PRIORITY.
+ */
+#if ( configASSERT_DEFINED == 1 )
+	 static uint8_t ucMaxSysCallPriority = 0;
+	 static uint32_t ulMaxPRIGROUPValue = 0;
+	 static const volatile uint8_t * const pcInterruptPriorityRegisters = ( uint8_t * ) portNVIC_IP_REGISTERS_OFFSET_16;
+#endif /* configASSERT_DEFINED */
+
+/*-----------------------------------------------------------*/
+
+/*
+ * See header file for description.
+ */
+StackType_t *pxPortInitialiseStack( StackType_t *pxTopOfStack, TaskFunction_t pxCode, void *pvParameters )
+{
+	/* Simulate the stack frame as it would be created by a context switch
+	interrupt. */
+
+	/* Offset added to account for the way the MCU uses the stack on entry/exit
+	of interrupts, and to ensure alignment. */
+	pxTopOfStack--;
+
+	*pxTopOfStack = portINITIAL_XPSR;	/* xPSR */
+	pxTopOfStack--;
+	*pxTopOfStack = ( ( StackType_t ) pxCode ) & portSTART_ADDRESS_MASK;	/* PC */
+	pxTopOfStack--;
+	*pxTopOfStack = ( StackType_t ) prvTaskExitError;	/* LR */
+
+	/* Save code space by skipping register initialisation. */
+	pxTopOfStack -= 5;	/* R12, R3, R2 and R1. */
+	*pxTopOfStack = ( StackType_t ) pvParameters;	/* R0 */
+
+	/* A save method is being used that requires each task to maintain its
+	own exec return value. */
+	pxTopOfStack--;
+	*pxTopOfStack = portINITIAL_EXEC_RETURN;
+
+	pxTopOfStack -= 8;	/* R11, R10, R9, R8, R7, R6, R5 and R4. */
+
+	return pxTopOfStack;
+}
+/*-----------------------------------------------------------*/
+
+static void prvTaskExitError( void )
+{
+	/* A function that implements a task must not exit or attempt to return to
+	its caller as there is nothing to return to.  If a task wants to exit it
+	should instead call vTaskDelete( NULL ).
+
+	Artificially force an assert() to be triggered if configASSERT() is
+	defined, then stop here so application writers can catch the error. */
+	configASSERT( uxCriticalNesting == ~0UL );
+	portDISABLE_INTERRUPTS();
+	for( ;; );
+}
+/*-----------------------------------------------------------*/
+
+__asm void vPortSVCHandler( void )
+{
+	PRESERVE8
+
+	/* Get the location of the current TCB. */
+	ldr	r3, =pxCurrentTCB
+	ldr r1, [r3]
+	ldr r0, [r1]
+	/* Pop the core registers. */
+	ldmia r0!, {r4-r11, r14}
+	msr psp, r0
+	isb
+	mov r0, #0
+	msr	basepri, r0
+	bx r14
+}
+/*-----------------------------------------------------------*/
+
+__asm void prvStartFirstTask( void )
+{
+	PRESERVE8
+
+	/* Use the NVIC offset register to locate the stack. */
+	ldr r0, =0xE000ED08
+	ldr r0, [r0]
+	ldr r0, [r0]
+	/* Set the msp back to the start of the stack. */
+	msr msp, r0
+	/* Globally enable interrupts. */
+	cpsie i
+	cpsie f
+	dsb
+	isb
+	/* Call SVC to start the first task. */
+	svc 0
+	nop
+	nop
+}
+/*-----------------------------------------------------------*/
+
+__asm void prvEnableVFP( void )
+{
+	PRESERVE8
+
+	/* The FPU enable bits are in the CPACR. */
+	ldr.w r0, =0xE000ED88
+	ldr	r1, [r0]
+
+	/* Enable CP10 and CP11 coprocessors, then save back. */
+	orr	r1, r1, #( 0xf << 20 )
+	str r1, [r0]
+	bx	r14
+	nop
+}
+/*-----------------------------------------------------------*/
+
+/*
+ * See header file for description.
+ */
+BaseType_t xPortStartScheduler( void )
+{
+	/* configMAX_SYSCALL_INTERRUPT_PRIORITY must not be set to 0.
+	See http://www.FreeRTOS.org/RTOS-Cortex-M3-M4.html */
+	configASSERT( configMAX_SYSCALL_INTERRUPT_PRIORITY );
+
+	/* This port can be used on all revisions of the Cortex-M7 core other than
+	the r0p1 parts.  r0p1 parts should use the port from the
+	/source/portable/GCC/ARM_CM7/r0p1 directory. */
+	configASSERT( portCPUID != portCORTEX_M7_r0p1_ID );
+	configASSERT( portCPUID != portCORTEX_M7_r0p0_ID );
+
+	#if( configASSERT_DEFINED == 1 )
+	{
+		volatile uint32_t ulOriginalPriority;
+		volatile uint8_t * const pucFirstUserPriorityRegister = ( uint8_t * ) ( portNVIC_IP_REGISTERS_OFFSET_16 + portFIRST_USER_INTERRUPT_NUMBER );
+		volatile uint8_t ucMaxPriorityValue;
+
+		/* Determine the maximum priority from which ISR safe FreeRTOS API
+		functions can be called.  ISR safe functions are those that end in
+		"FromISR".  FreeRTOS maintains separate thread and ISR API functions to
+		ensure interrupt entry is as fast and simple as possible.
+
+		Save the interrupt priority value that is about to be clobbered. */
+		ulOriginalPriority = *pucFirstUserPriorityRegister;
+
+		/* Determine the number of priority bits available.  First write to all
+		possible bits. */
+		*pucFirstUserPriorityRegister = portMAX_8_BIT_VALUE;
+
+		/* Read the value back to see how many bits stuck. */
+		ucMaxPriorityValue = *pucFirstUserPriorityRegister;
+
+		/* The kernel interrupt priority should be set to the lowest
+		priority. */
+		configASSERT( ucMaxPriorityValue == ( configKERNEL_INTERRUPT_PRIORITY & ucMaxPriorityValue ) );
+
+		/* Use the same mask on the maximum system call priority. */
+		ucMaxSysCallPriority = configMAX_SYSCALL_INTERRUPT_PRIORITY & ucMaxPriorityValue;
+
+		/* Calculate the maximum acceptable priority group value for the number
+		of bits read back. */
+		ulMaxPRIGROUPValue = portMAX_PRIGROUP_BITS;
+		while( ( ucMaxPriorityValue & portTOP_BIT_OF_BYTE ) == portTOP_BIT_OF_BYTE )
+		{
+			ulMaxPRIGROUPValue--;
+			ucMaxPriorityValue <<= ( uint8_t ) 0x01;
+		}
+
+		/* Shift the priority group value back to its position within the AIRCR
+		register. */
+		ulMaxPRIGROUPValue <<= portPRIGROUP_SHIFT;
+		ulMaxPRIGROUPValue &= portPRIORITY_GROUP_MASK;
+
+		/* Restore the clobbered interrupt priority register to its original
+		value. */
+		*pucFirstUserPriorityRegister = ulOriginalPriority;
+	}
+	#endif /* conifgASSERT_DEFINED */
+
+	/* Make PendSV and SysTick the lowest priority interrupts. */
+	portNVIC_SYSPRI2_REG |= portNVIC_PENDSV_PRI;
+	portNVIC_SYSPRI2_REG |= portNVIC_SYSTICK_PRI;
+
+	/* Start the timer that generates the tick ISR.  Interrupts are disabled
+	here already. */
+	vPortSetupTimerInterrupt();
+
+	/* Initialise the critical nesting count ready for the first task. */
+	uxCriticalNesting = 0;
+
+	/* Ensure the VFP is enabled - it should be anyway. */
+	prvEnableVFP();
+
+	/* Lazy save always. */
+	*( portFPCCR ) |= portASPEN_AND_LSPEN_BITS;
+
+	/* Start the first task. */
+	prvStartFirstTask();
+
+	/* Should not get here! */
+	return 0;
+}
+/*-----------------------------------------------------------*/
+
+void vPortEndScheduler( void )
+{
+	/* Not implemented in ports where there is nothing to return to.
+	Artificially force an assert. */
+	configASSERT( uxCriticalNesting == 1000UL );
+}
+/*-----------------------------------------------------------*/
+
+void vPortEnterCritical( void )
+{
+	portDISABLE_INTERRUPTS();
+	uxCriticalNesting++;
+
+	/* This is not the interrupt safe version of the enter critical function so
+	assert() if it is being called from an interrupt context.  Only API
+	functions that end in "FromISR" can be used in an interrupt.  Only assert if
+	the critical nesting count is 1 to protect against recursive calls if the
+	assert function also uses a critical section. */
+	if( uxCriticalNesting == 1 )
+	{
+		configASSERT( ( portNVIC_INT_CTRL_REG & portVECTACTIVE_MASK ) == 0 );
+	}
+}
+/*-----------------------------------------------------------*/
+
+void vPortExitCritical( void )
+{
+	configASSERT( uxCriticalNesting );
+	uxCriticalNesting--;
+	if( uxCriticalNesting == 0 )
+	{
+		portENABLE_INTERRUPTS();
+	}
+}
+/*-----------------------------------------------------------*/
+
+__asm void xPortPendSVHandler( void )
+{
+	extern uxCriticalNesting;
+	extern pxCurrentTCB;
+	extern vTaskSwitchContext;
+
+	PRESERVE8
+
+	mrs r0, psp
+	isb
+	/* Get the location of the current TCB. */
+	ldr	r3, =pxCurrentTCB
+	ldr	r2, [r3]
+
+	/* Is the task using the FPU context?  If so, push high vfp registers. */
+	tst r14, #0x10
+	it eq
+	vstmdbeq r0!, {s16-s31}
+
+	/* Save the core registers. */
+	stmdb r0!, {r4-r11, r14}
+
+	/* Save the new top of stack into the first member of the TCB. */
+	str r0, [r2]
+
+	stmdb sp!, {r3}
+	mov r0, #configMAX_SYSCALL_INTERRUPT_PRIORITY
+	msr basepri, r0
+	dsb
+	isb
+	bl vTaskSwitchContext
+	mov r0, #0
+	msr basepri, r0
+	ldmia sp!, {r3}
+
+	/* The first item in pxCurrentTCB is the task top of stack. */
+	ldr r1, [r3]
+	ldr r0, [r1]
+
+	/* Pop the core registers. */
+	ldmia r0!, {r4-r11, r14}
+
+	/* Is the task using the FPU context?  If so, pop the high vfp registers
+	too. */
+	tst r14, #0x10
+	it eq
+	vldmiaeq r0!, {s16-s31}
+
+	msr psp, r0
+	isb
+	#ifdef WORKAROUND_PMU_CM001 /* XMC4000 specific errata */
+		#if WORKAROUND_PMU_CM001 == 1
+			push { r14 }
+			pop { pc }
+			nop
+		#endif
+	#endif
+
+	bx r14
+}
+/*-----------------------------------------------------------*/
+
+void xPortSysTickHandler( void )
+{
+	/* The SysTick runs at the lowest interrupt priority, so when this interrupt
+	executes all interrupts must be unmasked.  There is therefore no need to
+	save and then restore the interrupt mask value as its value is already
+	known - therefore the slightly faster vPortRaiseBASEPRI() function is used
+	in place of portSET_INTERRUPT_MASK_FROM_ISR(). */
+	vPortRaiseBASEPRI();
+	{
+		/* Increment the RTOS tick. */
+		if( xTaskIncrementTick() != pdFALSE )
+		{
+			/* A context switch is required.  Context switching is performed in
+			the PendSV interrupt.  Pend the PendSV interrupt. */
+			portNVIC_INT_CTRL_REG = portNVIC_PENDSVSET_BIT;
+		}
+	}
+	vPortClearBASEPRIFromISR();
+}
+/*-----------------------------------------------------------*/
+
+#if configUSE_TICKLESS_IDLE == 1
+
+	__weak void vPortSuppressTicksAndSleep( TickType_t xExpectedIdleTime )
+	{
+	uint32_t ulReloadValue, ulCompleteTickPeriods, ulCompletedSysTickDecrements, ulSysTickCTRL;
+	TickType_t xModifiableIdleTime;
+
+		/* Make sure the SysTick reload value does not overflow the counter. */
+		if( xExpectedIdleTime > xMaximumPossibleSuppressedTicks )
+		{
+			xExpectedIdleTime = xMaximumPossibleSuppressedTicks;
+		}
+
+		/* Stop the SysTick momentarily.  The time the SysTick is stopped for
+		is accounted for as best it can be, but using the tickless mode will
+		inevitably result in some tiny drift of the time maintained by the
+		kernel with respect to calendar time. */
+		portNVIC_SYSTICK_CTRL_REG &= ~portNVIC_SYSTICK_ENABLE_BIT;
+
+		/* Calculate the reload value required to wait xExpectedIdleTime
+		tick periods.  -1 is used because this code will execute part way
+		through one of the tick periods. */
+		ulReloadValue = portNVIC_SYSTICK_CURRENT_VALUE_REG + ( ulTimerCountsForOneTick * ( xExpectedIdleTime - 1UL ) );
+		if( ulReloadValue > ulStoppedTimerCompensation )
+		{
+			ulReloadValue -= ulStoppedTimerCompensation;
+		}
+
+		/* Enter a critical section but don't use the taskENTER_CRITICAL()
+		method as that will mask interrupts that should exit sleep mode. */
+		__disable_irq();
+		__dsb( portSY_FULL_READ_WRITE );
+		__isb( portSY_FULL_READ_WRITE );
+
+		/* If a context switch is pending or a task is waiting for the scheduler
+		to be unsuspended then abandon the low power entry. */
+		if( eTaskConfirmSleepModeStatus() == eAbortSleep )
+		{
+			/* Restart from whatever is left in the count register to complete
+			this tick period. */
+			portNVIC_SYSTICK_LOAD_REG = portNVIC_SYSTICK_CURRENT_VALUE_REG;
+
+			/* Restart SysTick. */
+			portNVIC_SYSTICK_CTRL_REG |= portNVIC_SYSTICK_ENABLE_BIT;
+
+			/* Reset the reload register to the value required for normal tick
+			periods. */
+			portNVIC_SYSTICK_LOAD_REG = ulTimerCountsForOneTick - 1UL;
+
+			/* Re-enable interrupts - see comments above __disable_irq() call
+			above. */
+			__enable_irq();
+		}
+		else
+		{
+			/* Set the new reload value. */
+			portNVIC_SYSTICK_LOAD_REG = ulReloadValue;
+
+			/* Clear the SysTick count flag and set the count value back to
+			zero. */
+			portNVIC_SYSTICK_CURRENT_VALUE_REG = 0UL;
+
+			/* Restart SysTick. */
+			portNVIC_SYSTICK_CTRL_REG |= portNVIC_SYSTICK_ENABLE_BIT;
+
+			/* Sleep until something happens.  configPRE_SLEEP_PROCESSING() can
+			set its parameter to 0 to indicate that its implementation contains
+			its own wait for interrupt or wait for event instruction, and so wfi
+			should not be executed again.  However, the original expected idle
+			time variable must remain unmodified, so a copy is taken. */
+			xModifiableIdleTime = xExpectedIdleTime;
+			configPRE_SLEEP_PROCESSING( xModifiableIdleTime );
+			if( xModifiableIdleTime > 0 )
+			{
+				__dsb( portSY_FULL_READ_WRITE );
+				__wfi();
+				__isb( portSY_FULL_READ_WRITE );
+			}
+			configPOST_SLEEP_PROCESSING( xExpectedIdleTime );
+
+			/* Stop SysTick.  Again, the time the SysTick is stopped for is
+			accounted for as best it can be, but using the tickless mode will
+			inevitably result in some tiny drift of the time maintained by the
+			kernel with respect to calendar time. */
+			ulSysTickCTRL = portNVIC_SYSTICK_CTRL_REG;
+			portNVIC_SYSTICK_CTRL_REG = ( ulSysTickCTRL & ~portNVIC_SYSTICK_ENABLE_BIT );
+
+			/* Re-enable interrupts - see comments above __disable_irq() call
+			above. */
+			__enable_irq();
+
+			if( ( ulSysTickCTRL & portNVIC_SYSTICK_COUNT_FLAG_BIT ) != 0 )
+			{
+				uint32_t ulCalculatedLoadValue;
+
+				/* The tick interrupt has already executed, and the SysTick
+				count reloaded with ulReloadValue.  Reset the
+				portNVIC_SYSTICK_LOAD_REG with whatever remains of this tick
+				period. */
+				ulCalculatedLoadValue = ( ulTimerCountsForOneTick - 1UL ) - ( ulReloadValue - portNVIC_SYSTICK_CURRENT_VALUE_REG );
+
+				/* Don't allow a tiny value, or values that have somehow
+				underflowed because the post sleep hook did something
+				that took too long. */
+				if( ( ulCalculatedLoadValue < ulStoppedTimerCompensation ) || ( ulCalculatedLoadValue > ulTimerCountsForOneTick ) )
+				{
+					ulCalculatedLoadValue = ( ulTimerCountsForOneTick - 1UL );
+				}
+
+				portNVIC_SYSTICK_LOAD_REG = ulCalculatedLoadValue;
+
+				/* The tick interrupt handler will already have pended the tick
+				processing in the kernel.  As the pending tick will be
+				processed as soon as this function exits, the tick value
+				maintained by the tick is stepped forward by one less than the
+				time spent waiting. */
+				ulCompleteTickPeriods = xExpectedIdleTime - 1UL;
+			}
+			else
+			{
+				/* Something other than the tick interrupt ended the sleep.
+				Work out how long the sleep lasted rounded to complete tick
+				periods (not the ulReload value which accounted for part
+				ticks). */
+				ulCompletedSysTickDecrements = ( xExpectedIdleTime * ulTimerCountsForOneTick ) - portNVIC_SYSTICK_CURRENT_VALUE_REG;
+
+				/* How many complete tick periods passed while the processor
+				was waiting? */
+				ulCompleteTickPeriods = ulCompletedSysTickDecrements / ulTimerCountsForOneTick;
+
+				/* The reload value is set to whatever fraction of a single tick
+				period remains. */
+				portNVIC_SYSTICK_LOAD_REG = ( ( ulCompleteTickPeriods + 1UL ) * ulTimerCountsForOneTick ) - ulCompletedSysTickDecrements;
+			}
+
+			/* Restart SysTick so it runs from portNVIC_SYSTICK_LOAD_REG
+			again, then set portNVIC_SYSTICK_LOAD_REG back to its standard
+			value.  The critical section is used to ensure the tick interrupt
+			can only execute once in the case that the reload register is near
+			zero. */
+			portNVIC_SYSTICK_CURRENT_VALUE_REG = 0UL;
+			portENTER_CRITICAL();
+			{
+				portNVIC_SYSTICK_CTRL_REG |= portNVIC_SYSTICK_ENABLE_BIT;
+				vTaskStepTick( ulCompleteTickPeriods );
+				portNVIC_SYSTICK_LOAD_REG = ulTimerCountsForOneTick - 1UL;
+			}
+			portEXIT_CRITICAL();
+		}
+	}
+
+#endif /* #if configUSE_TICKLESS_IDLE */
+
+/*-----------------------------------------------------------*/
+
+/*
+ * Setup the SysTick timer to generate the tick interrupts at the required
+ * frequency.
+ */
+#if configOVERRIDE_DEFAULT_TICK_CONFIGURATION == 0
+
+	void vPortSetupTimerInterrupt( void )
+	{
+		/* Calculate the constants required to configure the tick interrupt. */
+		#if configUSE_TICKLESS_IDLE == 1
+		{
+			ulTimerCountsForOneTick = ( configSYSTICK_CLOCK_HZ / configTICK_RATE_HZ );
+			xMaximumPossibleSuppressedTicks = portMAX_24_BIT_NUMBER / ulTimerCountsForOneTick;
+			ulStoppedTimerCompensation = portMISSED_COUNTS_FACTOR / ( configCPU_CLOCK_HZ / configSYSTICK_CLOCK_HZ );
+		}
+		#endif /* configUSE_TICKLESS_IDLE */
+
+		/* Configure SysTick to interrupt at the requested rate. */
+		portNVIC_SYSTICK_LOAD_REG = ( configSYSTICK_CLOCK_HZ / configTICK_RATE_HZ ) - 1UL;
+		portNVIC_SYSTICK_CTRL_REG = ( portNVIC_SYSTICK_CLK_BIT | portNVIC_SYSTICK_INT_BIT | portNVIC_SYSTICK_ENABLE_BIT );
+	}
+
+#endif /* configOVERRIDE_DEFAULT_TICK_CONFIGURATION */
+/*-----------------------------------------------------------*/
+
+__asm uint32_t vPortGetIPSR( void )
+{
+	PRESERVE8
+
+	mrs r0, ipsr
+	bx r14
+}
+/*-----------------------------------------------------------*/
+
+#if( configASSERT_DEFINED == 1 )
+
+	void vPortValidateInterruptPriority( void )
+	{
+	uint32_t ulCurrentInterrupt;
+	uint8_t ucCurrentPriority;
+
+		/* Obtain the number of the currently executing interrupt. */
+		ulCurrentInterrupt = vPortGetIPSR();
+
+		/* Is the interrupt number a user defined interrupt? */
+		if( ulCurrentInterrupt >= portFIRST_USER_INTERRUPT_NUMBER )
+		{
+			/* Look up the interrupt's priority. */
+			ucCurrentPriority = pcInterruptPriorityRegisters[ ulCurrentInterrupt ];
+
+			/* The following assertion will fail if a service routine (ISR) for
+			an interrupt that has been assigned a priority above
+			configMAX_SYSCALL_INTERRUPT_PRIORITY calls an ISR safe FreeRTOS API
+			function.  ISR safe FreeRTOS API functions must *only* be called
+			from interrupts that have been assigned a priority at or below
+			configMAX_SYSCALL_INTERRUPT_PRIORITY.
+
+			Numerically low interrupt priority numbers represent logically high
+			interrupt priorities, therefore the priority of the interrupt must
+			be set to a value equal to or numerically *higher* than
+			configMAX_SYSCALL_INTERRUPT_PRIORITY.
+
+			Interrupts that	use the FreeRTOS API must not be left at their
+			default priority of	zero as that is the highest possible priority,
+			which is guaranteed to be above configMAX_SYSCALL_INTERRUPT_PRIORITY,
+			and	therefore also guaranteed to be invalid.
+
+			FreeRTOS maintains separate thread and ISR API functions to ensure
+			interrupt entry is as fast and simple as possible.
+
+			The following links provide detailed information:
+			http://www.freertos.org/RTOS-Cortex-M3-M4.html
+			http://www.freertos.org/FAQHelp.html */
+			configASSERT( ucCurrentPriority >= ucMaxSysCallPriority );
+		}
+
+		/* Priority grouping:  The interrupt controller (NVIC) allows the bits
+		that define each interrupt's priority to be split between bits that
+		define the interrupt's pre-emption priority bits and bits that define
+		the interrupt's sub-priority.  For simplicity all bits must be defined
+		to be pre-emption priority bits.  The following assertion will fail if
+		this is not the case (if some bits represent a sub-priority).
+
+		If the application only uses CMSIS libraries for interrupt
+		configuration then the correct setting can be achieved on all Cortex-M
+		devices by calling NVIC_SetPriorityGrouping( 0 ); before starting the
+		scheduler.  Note however that some vendor specific peripheral libraries
+		assume a non-zero priority group setting, in which cases using a value
+		of zero will result in unpredicable behaviour. */
+		configASSERT( ( portAIRCR_REG & portPRIORITY_GROUP_MASK ) <= ulMaxPRIGROUPValue );
+	}
+
+#endif /* configASSERT_DEFINED */
+
+
diff --git a/FreeRTOS/portable/RVDS/ARM_CM4F/portmacro.h b/FreeRTOS/portable/RVDS/ARM_CM4F/portmacro.h
new file mode 100644
index 0000000..0b6eb5a
--- /dev/null
+++ b/FreeRTOS/portable/RVDS/ARM_CM4F/portmacro.h
@@ -0,0 +1,294 @@
+/*
+    FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd.
+    All rights reserved
+
+    VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION.
+
+    This file is part of the FreeRTOS distribution.
+
+    FreeRTOS is free software; you can redistribute it and/or modify it under
+    the terms of the GNU General Public License (version 2) as published by the
+    Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception.
+
+    ***************************************************************************
+    >>!   NOTE: The modification to the GPL is included to allow you to     !<<
+    >>!   distribute a combined work that includes FreeRTOS without being   !<<
+    >>!   obliged to provide the source code for proprietary components     !<<
+    >>!   outside of the FreeRTOS kernel.                                   !<<
+    ***************************************************************************
+
+    FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY
+    WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+    FOR A PARTICULAR PURPOSE.  Full license text is available on the following
+    link: http://www.freertos.org/a00114.html
+
+    ***************************************************************************
+     *                                                                       *
+     *    FreeRTOS provides completely free yet professionally developed,    *
+     *    robust, strictly quality controlled, supported, and cross          *
+     *    platform software that is more than just the market leader, it     *
+     *    is the industry's de facto standard.                               *
+     *                                                                       *
+     *    Help yourself get started quickly while simultaneously helping     *
+     *    to support the FreeRTOS project by purchasing a FreeRTOS           *
+     *    tutorial book, reference manual, or both:                          *
+     *    http://www.FreeRTOS.org/Documentation                              *
+     *                                                                       *
+    ***************************************************************************
+
+    http://www.FreeRTOS.org/FAQHelp.html - Having a problem?  Start by reading
+    the FAQ page "My application does not run, what could be wrong?".  Have you
+    defined configASSERT()?
+
+    http://www.FreeRTOS.org/support - In return for receiving this top quality
+    embedded software for free we request you assist our global community by
+    participating in the support forum.
+
+    http://www.FreeRTOS.org/training - Investing in training allows your team to
+    be as productive as possible as early as possible.  Now you can receive
+    FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers
+    Ltd, and the world's leading authority on the world's leading RTOS.
+
+    http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products,
+    including FreeRTOS+Trace - an indispensable productivity tool, a DOS
+    compatible FAT file system, and our tiny thread aware UDP/IP stack.
+
+    http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate.
+    Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS.
+
+    http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High
+    Integrity Systems ltd. to sell under the OpenRTOS brand.  Low cost OpenRTOS
+    licenses offer ticketed support, indemnification and commercial middleware.
+
+    http://www.SafeRTOS.com - High Integrity Systems also provide a safety
+    engineered and independently SIL3 certified version for use in safety and
+    mission critical applications that require provable dependability.
+
+    1 tab == 4 spaces!
+*/
+
+
+#ifndef PORTMACRO_H
+#define PORTMACRO_H
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/*-----------------------------------------------------------
+ * Port specific definitions.
+ *
+ * The settings in this file configure FreeRTOS correctly for the
+ * given hardware and compiler.
+ *
+ * These settings should not be altered.
+ *-----------------------------------------------------------
+ */
+
+/* Type definitions. */
+#define portCHAR		char
+#define portFLOAT		float
+#define portDOUBLE		double
+#define portLONG		long
+#define portSHORT		short
+#define portSTACK_TYPE	uint32_t
+#define portBASE_TYPE	long
+
+typedef portSTACK_TYPE StackType_t;
+typedef long BaseType_t;
+typedef unsigned long UBaseType_t;
+
+#if( configUSE_16_BIT_TICKS == 1 )
+	typedef uint16_t TickType_t;
+	#define portMAX_DELAY ( TickType_t ) 0xffff
+#else
+	typedef uint32_t TickType_t;
+	#define portMAX_DELAY ( TickType_t ) 0xffffffffUL
+
+	/* 32-bit tick type on a 32-bit architecture, so reads of the tick count do
+	not need to be guarded with a critical section. */
+	#define portTICK_TYPE_IS_ATOMIC 1
+#endif
+/*-----------------------------------------------------------*/
+
+/* Architecture specifics. */
+#define portSTACK_GROWTH			( -1 )
+#define portTICK_PERIOD_MS			( ( TickType_t ) 1000 / configTICK_RATE_HZ )
+#define portBYTE_ALIGNMENT			8
+
+/* Constants used with memory barrier intrinsics. */
+#define portSY_FULL_READ_WRITE		( 15 )
+
+/*-----------------------------------------------------------*/
+
+/* Scheduler utilities. */
+#define portYIELD()																\
+{																				\
+	/* Set a PendSV to request a context switch. */								\
+	portNVIC_INT_CTRL_REG = portNVIC_PENDSVSET_BIT;								\
+																				\
+	/* Barriers are normally not required but do ensure the code is completely	\
+	within the specified behaviour for the architecture. */						\
+	__dsb( portSY_FULL_READ_WRITE );											\
+	__isb( portSY_FULL_READ_WRITE );											\
+}
+/*-----------------------------------------------------------*/
+
+#define portNVIC_INT_CTRL_REG		( * ( ( volatile uint32_t * ) 0xe000ed04 ) )
+#define portNVIC_PENDSVSET_BIT		( 1UL << 28UL )
+#define portEND_SWITCHING_ISR( xSwitchRequired ) if( xSwitchRequired != pdFALSE ) portYIELD()
+#define portYIELD_FROM_ISR( x ) portEND_SWITCHING_ISR( x )
+/*-----------------------------------------------------------*/
+
+/* Critical section management. */
+extern void vPortEnterCritical( void );
+extern void vPortExitCritical( void );
+
+#define portDISABLE_INTERRUPTS()				vPortRaiseBASEPRI()
+#define portENABLE_INTERRUPTS()					vPortSetBASEPRI( 0 )
+#define portENTER_CRITICAL()					vPortEnterCritical()
+#define portEXIT_CRITICAL()						vPortExitCritical()
+#define portSET_INTERRUPT_MASK_FROM_ISR()		ulPortRaiseBASEPRI()
+#define portCLEAR_INTERRUPT_MASK_FROM_ISR(x)	vPortSetBASEPRI(x)
+
+/*-----------------------------------------------------------*/
+
+/* Tickless idle/low power functionality. */
+#ifndef portSUPPRESS_TICKS_AND_SLEEP
+	extern void vPortSuppressTicksAndSleep( TickType_t xExpectedIdleTime );
+	#define portSUPPRESS_TICKS_AND_SLEEP( xExpectedIdleTime ) vPortSuppressTicksAndSleep( xExpectedIdleTime )
+#endif
+/*-----------------------------------------------------------*/
+
+/* Port specific optimisations. */
+#ifndef configUSE_PORT_OPTIMISED_TASK_SELECTION
+	#define configUSE_PORT_OPTIMISED_TASK_SELECTION 1
+#endif
+
+#if configUSE_PORT_OPTIMISED_TASK_SELECTION == 1
+
+	/* Check the configuration. */
+	#if( configMAX_PRIORITIES > 32 )
+		#error configUSE_PORT_OPTIMISED_TASK_SELECTION can only be set to 1 when configMAX_PRIORITIES is less than or equal to 32.  It is very rare that a system requires more than 10 to 15 difference priorities as tasks that share a priority will time slice.
+	#endif
+
+	/* Store/clear the ready priorities in a bit map. */
+	#define portRECORD_READY_PRIORITY( uxPriority, uxReadyPriorities ) ( uxReadyPriorities ) |= ( 1UL << ( uxPriority ) )
+	#define portRESET_READY_PRIORITY( uxPriority, uxReadyPriorities ) ( uxReadyPriorities ) &= ~( 1UL << ( uxPriority ) )
+
+	/*-----------------------------------------------------------*/
+
+	#define portGET_HIGHEST_PRIORITY( uxTopPriority, uxReadyPriorities ) uxTopPriority = ( 31UL - ( uint32_t ) __clz( ( uxReadyPriorities ) ) )
+
+#endif /* taskRECORD_READY_PRIORITY */
+/*-----------------------------------------------------------*/
+
+/* Task function macros as described on the FreeRTOS.org WEB site.  These are
+not necessary for to use this port.  They are defined so the common demo files
+(which build with all the ports) will build. */
+#define portTASK_FUNCTION_PROTO( vFunction, pvParameters ) void vFunction( void *pvParameters )
+#define portTASK_FUNCTION( vFunction, pvParameters ) void vFunction( void *pvParameters )
+/*-----------------------------------------------------------*/
+
+#ifdef configASSERT
+	void vPortValidateInterruptPriority( void );
+	#define portASSERT_IF_INTERRUPT_PRIORITY_INVALID() 	vPortValidateInterruptPriority()
+#endif
+
+/* portNOP() is not required by this port. */
+#define portNOP()
+
+#define portINLINE __inline
+
+#ifndef portFORCE_INLINE
+	#define portFORCE_INLINE __forceinline
+#endif
+
+/*-----------------------------------------------------------*/
+
+static portFORCE_INLINE void vPortSetBASEPRI( uint32_t ulBASEPRI )
+{
+	__asm
+	{
+		/* Barrier instructions are not used as this function is only used to
+		lower the BASEPRI value. */
+		msr basepri, ulBASEPRI
+	}
+}
+/*-----------------------------------------------------------*/
+
+static portFORCE_INLINE void vPortRaiseBASEPRI( void )
+{
+uint32_t ulNewBASEPRI = configMAX_SYSCALL_INTERRUPT_PRIORITY;
+
+	__asm
+	{
+		/* Set BASEPRI to the max syscall priority to effect a critical
+		section. */
+		msr basepri, ulNewBASEPRI
+		dsb
+		isb
+	}
+}
+/*-----------------------------------------------------------*/
+
+static portFORCE_INLINE void vPortClearBASEPRIFromISR( void )
+{
+	__asm
+	{
+		/* Set BASEPRI to 0 so no interrupts are masked.  This function is only
+		used to lower the mask in an interrupt, so memory barriers are not 
+		used. */
+		msr basepri, #0
+	}
+}
+/*-----------------------------------------------------------*/
+
+static portFORCE_INLINE uint32_t ulPortRaiseBASEPRI( void )
+{
+uint32_t ulReturn, ulNewBASEPRI = configMAX_SYSCALL_INTERRUPT_PRIORITY;
+
+	__asm
+	{
+		/* Set BASEPRI to the max syscall priority to effect a critical
+		section. */
+		mrs ulReturn, basepri
+		msr basepri, ulNewBASEPRI
+		dsb
+		isb
+	}
+
+	return ulReturn;
+}
+/*-----------------------------------------------------------*/
+
+static portFORCE_INLINE BaseType_t xPortIsInsideInterrupt( void )
+{
+uint32_t ulCurrentInterrupt;
+BaseType_t xReturn;
+
+	/* Obtain the number of the currently executing interrupt. */
+	__asm
+	{
+		mrs ulCurrentInterrupt, ipsr
+	}
+
+	if( ulCurrentInterrupt == 0 )
+	{
+		xReturn = pdFALSE;
+	}
+	else
+	{
+		xReturn = pdTRUE;
+	}
+
+	return xReturn;
+}
+
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* PORTMACRO_H */
+
diff --git a/FreeRTOS/portable/RVDS/ARM_CM4_MPU/port.c b/FreeRTOS/portable/RVDS/ARM_CM4_MPU/port.c
new file mode 100644
index 0000000..4c5ee33
--- /dev/null
+++ b/FreeRTOS/portable/RVDS/ARM_CM4_MPU/port.c
@@ -0,0 +1,845 @@
+/*
+    FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd.
+    All rights reserved
+
+    VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION.
+
+    This file is part of the FreeRTOS distribution.
+
+    FreeRTOS is free software; you can redistribute it and/or modify it under
+    the terms of the GNU General Public License (version 2) as published by the
+    Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception.
+
+    ***************************************************************************
+    >>!   NOTE: The modification to the GPL is included to allow you to     !<<
+    >>!   distribute a combined work that includes FreeRTOS without being   !<<
+    >>!   obliged to provide the source code for proprietary components     !<<
+    >>!   outside of the FreeRTOS kernel.                                   !<<
+    ***************************************************************************
+
+    FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY
+    WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+    FOR A PARTICULAR PURPOSE.  Full license text is available on the following
+    link: http://www.freertos.org/a00114.html
+
+    ***************************************************************************
+     *                                                                       *
+     *    FreeRTOS provides completely free yet professionally developed,    *
+     *    robust, strictly quality controlled, supported, and cross          *
+     *    platform software that is more than just the market leader, it     *
+     *    is the industry's de facto standard.                               *
+     *                                                                       *
+     *    Help yourself get started quickly while simultaneously helping     *
+     *    to support the FreeRTOS project by purchasing a FreeRTOS           *
+     *    tutorial book, reference manual, or both:                          *
+     *    http://www.FreeRTOS.org/Documentation                              *
+     *                                                                       *
+    ***************************************************************************
+
+    http://www.FreeRTOS.org/FAQHelp.html - Having a problem?  Start by reading
+    the FAQ page "My application does not run, what could be wrong?".  Have you
+    defined configASSERT()?
+
+    http://www.FreeRTOS.org/support - In return for receiving this top quality
+    embedded software for free we request you assist our global community by
+    participating in the support forum.
+
+    http://www.FreeRTOS.org/training - Investing in training allows your team to
+    be as productive as possible as early as possible.  Now you can receive
+    FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers
+    Ltd, and the world's leading authority on the world's leading RTOS.
+
+    http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products,
+    including FreeRTOS+Trace - an indispensable productivity tool, a DOS
+    compatible FAT file system, and our tiny thread aware UDP/IP stack.
+
+    http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate.
+    Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS.
+
+    http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High
+    Integrity Systems ltd. to sell under the OpenRTOS brand.  Low cost OpenRTOS
+    licenses offer ticketed support, indemnification and commercial middleware.
+
+    http://www.SafeRTOS.com - High Integrity Systems also provide a safety
+    engineered and independently SIL3 certified version for use in safety and
+    mission critical applications that require provable dependability.
+
+    1 tab == 4 spaces!
+*/
+
+/*-----------------------------------------------------------
+ * Implementation of functions defined in portable.h for the ARM CM3 port.
+ *----------------------------------------------------------*/
+
+/* Defining MPU_WRAPPERS_INCLUDED_FROM_API_FILE prevents task.h from redefining
+all the API functions to use the MPU wrappers.  That should only be done when
+task.h is included from an application file. */
+#define MPU_WRAPPERS_INCLUDED_FROM_API_FILE
+
+/* Scheduler includes. */
+#include "FreeRTOS.h"
+#include "queue.h"
+#include "event_groups.h"
+#include "mpu_prototypes.h"
+
+#ifndef __TARGET_FPU_VFP
+	#error This port can only be used when the project options are configured to enable hardware floating point support.
+#endif
+
+#undef MPU_WRAPPERS_INCLUDED_FROM_API_FILE
+
+/* Constants required to access and manipulate the NVIC. */
+#define portNVIC_SYSTICK_CTRL_REG				( * ( ( volatile uint32_t * ) 0xe000e010 ) )
+#define portNVIC_SYSTICK_LOAD_REG				( * ( ( volatile uint32_t * ) 0xe000e014 ) )
+#define portNVIC_SYSPRI2_REG					( *	( ( volatile uint32_t * ) 0xe000ed20 ) )
+#define portNVIC_SYSPRI1_REG					( * ( ( volatile uint32_t * ) 0xe000ed1c ) )
+#define portNVIC_SYS_CTRL_STATE_REG				( * ( ( volatile uint32_t * ) 0xe000ed24 ) )
+#define portNVIC_MEM_FAULT_ENABLE				( 1UL << 16UL )
+
+/* Constants required to access and manipulate the MPU. */
+#define portMPU_TYPE_REG						( * ( ( volatile uint32_t * ) 0xe000ed90 ) )
+#define portMPU_REGION_BASE_ADDRESS_REG			( * ( ( volatile uint32_t * ) 0xe000ed9C ) )
+#define portMPU_REGION_ATTRIBUTE_REG			( * ( ( volatile uint32_t * ) 0xe000edA0 ) )
+#define portMPU_CTRL_REG						( * ( ( volatile uint32_t * ) 0xe000ed94 ) )
+#define portEXPECTED_MPU_TYPE_VALUE				( 8UL << 8UL ) /* 8 regions, unified. */
+#define portMPU_ENABLE							( 0x01UL )
+#define portMPU_BACKGROUND_ENABLE				( 1UL << 2UL )
+#define portPRIVILEGED_EXECUTION_START_ADDRESS	( 0UL )
+#define portMPU_REGION_VALID					( 0x10UL )
+#define portMPU_REGION_ENABLE					( 0x01UL )
+#define portPERIPHERALS_START_ADDRESS			0x40000000UL
+#define portPERIPHERALS_END_ADDRESS				0x5FFFFFFFUL
+
+/* Constants required to access and manipulate the SysTick. */
+#define portNVIC_SYSTICK_CLK					( 0x00000004UL )
+#define portNVIC_SYSTICK_INT					( 0x00000002UL )
+#define portNVIC_SYSTICK_ENABLE					( 0x00000001UL )
+#define portNVIC_PENDSV_PRI						( ( ( uint32_t ) configKERNEL_INTERRUPT_PRIORITY ) << 16UL )
+#define portNVIC_SYSTICK_PRI					( ( ( uint32_t ) configKERNEL_INTERRUPT_PRIORITY ) << 24UL )
+#define portNVIC_SVC_PRI						( ( ( uint32_t ) configMAX_SYSCALL_INTERRUPT_PRIORITY - 1UL ) << 24UL )
+
+/* Constants required to manipulate the VFP. */
+#define portFPCCR								( ( volatile uint32_t * ) 0xe000ef34UL ) /* Floating point context control register. */
+#define portASPEN_AND_LSPEN_BITS				( 0x3UL << 30UL )
+
+/* Constants required to set up the initial stack. */
+#define portINITIAL_XPSR						( 0x01000000UL )
+#define portINITIAL_EXEC_RETURN					( 0xfffffffdUL )
+#define portINITIAL_CONTROL_IF_UNPRIVILEGED		( 0x03 )
+#define portINITIAL_CONTROL_IF_PRIVILEGED		( 0x02 )
+
+/* Constants required to check the validity of an interrupt priority. */
+#define portFIRST_USER_INTERRUPT_NUMBER		( 16 )
+#define portNVIC_IP_REGISTERS_OFFSET_16 	( 0xE000E3F0 )
+#define portAIRCR_REG						( * ( ( volatile uint32_t * ) 0xE000ED0C ) )
+#define portMAX_8_BIT_VALUE					( ( uint8_t ) 0xff )
+#define portTOP_BIT_OF_BYTE					( ( uint8_t ) 0x80 )
+#define portMAX_PRIGROUP_BITS				( ( uint8_t ) 7 )
+#define portPRIORITY_GROUP_MASK				( 0x07UL << 8UL )
+#define portPRIGROUP_SHIFT					( 8UL )
+
+/* Offsets in the stack to the parameters when inside the SVC handler. */
+#define portOFFSET_TO_PC						( 6 )
+
+/* For strict compliance with the Cortex-M spec the task start address should
+have bit-0 clear, as it is loaded into the PC on exit from an ISR. */
+#define portSTART_ADDRESS_MASK				( ( StackType_t ) 0xfffffffeUL )
+
+/* Each task maintains its own interrupt status in the critical nesting
+variable.  Note this is not saved as part of the task context as context
+switches can only occur when uxCriticalNesting is zero. */
+static UBaseType_t uxCriticalNesting = 0xaaaaaaaa;
+
+/*
+ * Setup the timer to generate the tick interrupts.
+ */
+static void prvSetupTimerInterrupt( void ) PRIVILEGED_FUNCTION;
+
+/*
+ * Configure a number of standard MPU regions that are used by all tasks.
+ */
+static void prvSetupMPU( void ) PRIVILEGED_FUNCTION;
+
+/*
+ * Start first task is a separate function so it can be tested in isolation.
+ */
+static void prvStartFirstTask( void ) PRIVILEGED_FUNCTION;
+
+/*
+ * Return the smallest MPU region size that a given number of bytes will fit
+ * into.  The region size is returned as the value that should be programmed
+ * into the region attribute register for that region.
+ */
+static uint32_t prvGetMPURegionSizeSetting( uint32_t ulActualSizeInBytes ) PRIVILEGED_FUNCTION;
+
+/*
+ * Checks to see if being called from the context of an unprivileged task, and
+ * if so raises the privilege level and returns false - otherwise does nothing
+ * other than return true.
+ */
+BaseType_t xPortRaisePrivilege( void );
+
+/*
+ * Standard FreeRTOS exception handlers.
+ */
+void xPortPendSVHandler( void ) PRIVILEGED_FUNCTION;
+void xPortSysTickHandler( void ) PRIVILEGED_FUNCTION;
+void vPortSVCHandler( void ) PRIVILEGED_FUNCTION;
+
+/*
+ * Starts the scheduler by restoring the context of the first task to run.
+ */
+static void prvRestoreContextOfFirstTask( void ) PRIVILEGED_FUNCTION;
+
+/*
+ * C portion of the SVC handler.  The SVC handler is split between an asm entry
+ * and a C wrapper for simplicity of coding and maintenance.
+ */
+void prvSVCHandler( uint32_t *pulRegisters ) __attribute__((used)) PRIVILEGED_FUNCTION;
+
+/*
+ * Function to enable the VFP.
+ */
+static void vPortEnableVFP( void );
+
+/*
+ * Utility function.
+ */
+static uint32_t prvPortGetIPSR( void );
+	
+/*
+ * Used by the portASSERT_IF_INTERRUPT_PRIORITY_INVALID() macro to ensure
+ * FreeRTOS API functions are not called from interrupts that have been assigned
+ * a priority above configMAX_SYSCALL_INTERRUPT_PRIORITY.
+ */
+#if ( configASSERT_DEFINED == 1 )
+	 static uint8_t ucMaxSysCallPriority = 0;
+	 static uint32_t ulMaxPRIGROUPValue = 0;
+	 static const volatile uint8_t * const pcInterruptPriorityRegisters = ( const uint8_t * ) portNVIC_IP_REGISTERS_OFFSET_16;
+#endif /* configASSERT_DEFINED */
+
+/*-----------------------------------------------------------*/
+
+/*
+ * See header file for description.
+ */
+StackType_t *pxPortInitialiseStack( StackType_t *pxTopOfStack, TaskFunction_t pxCode, void *pvParameters, BaseType_t xRunPrivileged )
+{
+	/* Simulate the stack frame as it would be created by a context switch
+	interrupt. */
+	pxTopOfStack--; /* Offset added to account for the way the MCU uses the stack on entry/exit of interrupts. */
+	*pxTopOfStack = portINITIAL_XPSR;	/* xPSR */
+	pxTopOfStack--;
+	*pxTopOfStack = ( ( StackType_t ) pxCode ) & portSTART_ADDRESS_MASK;	/* PC */
+	pxTopOfStack--;
+	*pxTopOfStack = 0;	/* LR */
+	pxTopOfStack -= 5;	/* R12, R3, R2 and R1. */
+	*pxTopOfStack = ( StackType_t ) pvParameters;	/* R0 */
+
+	/* A save method is being used that requires each task to maintain its
+	own exec return value. */
+	pxTopOfStack--;
+	*pxTopOfStack = portINITIAL_EXEC_RETURN;
+
+	pxTopOfStack -= 9;	/* R11, R10, R9, R8, R7, R6, R5 and R4. */
+
+	if( xRunPrivileged == pdTRUE )
+	{
+		*pxTopOfStack = portINITIAL_CONTROL_IF_PRIVILEGED;
+	}
+	else
+	{
+		*pxTopOfStack = portINITIAL_CONTROL_IF_UNPRIVILEGED;
+	}
+
+	return pxTopOfStack;
+}
+/*-----------------------------------------------------------*/
+
+void prvSVCHandler( uint32_t *pulParam )
+{
+uint8_t ucSVCNumber;
+uint32_t ulReg;
+
+	/* The stack contains: r0, r1, r2, r3, r12, r14, the return address and
+	xPSR.  The first argument (r0) is pulParam[ 0 ]. */
+	ucSVCNumber = ( ( uint8_t * ) pulParam[ portOFFSET_TO_PC ] )[ -2 ];
+	switch( ucSVCNumber )
+	{
+		case portSVC_START_SCHEDULER	:	portNVIC_SYSPRI1_REG |= portNVIC_SVC_PRI;
+											prvRestoreContextOfFirstTask();
+											break;
+
+		case portSVC_YIELD				:	portNVIC_INT_CTRL_REG = portNVIC_PENDSVSET_BIT;
+											/* Barriers are normally not required
+											but do ensure the code is completely
+											within the specified behaviour for the
+											architecture. */
+											__asm volatile( "dsb" );
+											__asm volatile( "isb" );
+
+											break;
+
+		case portSVC_RAISE_PRIVILEGE	:	__asm
+											{
+												mrs ulReg, control	/* Obtain current control value. */
+												bic ulReg, #1		/* Set privilege bit. */
+												msr control, ulReg	/* Write back new control value. */
+											}
+											break;
+
+		default							:	/* Unknown SVC call. */
+											break;
+	}
+}
+/*-----------------------------------------------------------*/
+
+__asm void vPortSVCHandler( void )
+{
+	extern prvSVCHandler
+		
+	PRESERVE8
+
+	/* Assumes psp was in use. */
+	#ifndef USE_PROCESS_STACK	/* Code should not be required if a main() is using the process stack. */
+		tst lr, #4
+		ite eq
+		mrseq r0, msp
+		mrsne r0, psp
+	#else
+		mrs r0, psp
+	#endif
+		b prvSVCHandler
+}
+/*-----------------------------------------------------------*/
+
+__asm void prvRestoreContextOfFirstTask( void )
+{
+	PRESERVE8
+
+	ldr r0, =0xE000ED08				/* Use the NVIC offset register to locate the stack. */
+	ldr r0, [r0]
+	ldr r0, [r0]
+	msr msp, r0						/* Set the msp back to the start of the stack. */
+	ldr	r3, =pxCurrentTCB			/* Restore the context. */
+	ldr r1, [r3]
+	ldr r0, [r1]					/* The first item in the TCB is the task top of stack. */
+	add r1, r1, #4					/* Move onto the second item in the TCB... */
+	ldr r2, =0xe000ed9c				/* Region Base Address register. */
+	ldmia r1!, {r4-r11}				/* Read 4 sets of MPU registers. */
+	stmia r2!, {r4-r11}				/* Write 4 sets of MPU registers. */
+	ldmia r0!, {r3-r11, r14}	/* Pop the registers that are not automatically saved on exception entry. */
+	msr control, r3
+	msr psp, r0						/* Restore the task stack pointer. */
+	mov r0, #0
+	msr	basepri, r0
+	bx r14
+	nop
+}
+/*-----------------------------------------------------------*/
+
+/*
+ * See header file for description.
+ */
+BaseType_t xPortStartScheduler( void )
+{
+	/* configMAX_SYSCALL_INTERRUPT_PRIORITY must not be set to 0.  See
+	http://www.FreeRTOS.org/RTOS-Cortex-M3-M4.html */
+	configASSERT( ( configMAX_SYSCALL_INTERRUPT_PRIORITY ) );
+
+	#if( configASSERT_DEFINED == 1 )
+	{
+		volatile uint32_t ulOriginalPriority;
+		volatile uint8_t * const pucFirstUserPriorityRegister = ( volatile uint8_t * ) ( portNVIC_IP_REGISTERS_OFFSET_16 + portFIRST_USER_INTERRUPT_NUMBER );
+		volatile uint8_t ucMaxPriorityValue;
+
+		/* Determine the maximum priority from which ISR safe FreeRTOS API
+		functions can be called.  ISR safe functions are those that end in
+		"FromISR".  FreeRTOS maintains separate thread and ISR API functions to
+		ensure interrupt entry is as fast and simple as possible.
+
+		Save the interrupt priority value that is about to be clobbered. */
+		ulOriginalPriority = *pucFirstUserPriorityRegister;
+
+		/* Determine the number of priority bits available.  First write to all
+		possible bits. */
+		*pucFirstUserPriorityRegister = portMAX_8_BIT_VALUE;
+
+		/* Read the value back to see how many bits stuck. */
+		ucMaxPriorityValue = *pucFirstUserPriorityRegister;
+
+		/* Use the same mask on the maximum system call priority. */
+		ucMaxSysCallPriority = configMAX_SYSCALL_INTERRUPT_PRIORITY & ucMaxPriorityValue;
+
+		/* Calculate the maximum acceptable priority group value for the number
+		of bits read back. */
+		ulMaxPRIGROUPValue = portMAX_PRIGROUP_BITS;
+		while( ( ucMaxPriorityValue & portTOP_BIT_OF_BYTE ) == portTOP_BIT_OF_BYTE )
+		{
+			ulMaxPRIGROUPValue--;
+			ucMaxPriorityValue <<= ( uint8_t ) 0x01;
+		}
+
+		/* Shift the priority group value back to its position within the AIRCR
+		register. */
+		ulMaxPRIGROUPValue <<= portPRIGROUP_SHIFT;
+		ulMaxPRIGROUPValue &= portPRIORITY_GROUP_MASK;
+
+		/* Restore the clobbered interrupt priority register to its original
+		value. */
+		*pucFirstUserPriorityRegister = ulOriginalPriority;
+	}
+	#endif /* conifgASSERT_DEFINED */
+
+	/* Make PendSV and SysTick the same priority as the kernel, and the SVC
+	handler higher priority so it can be used to exit a critical section (where
+	lower priorities are masked). */
+	portNVIC_SYSPRI2_REG |= portNVIC_PENDSV_PRI;
+	portNVIC_SYSPRI2_REG |= portNVIC_SYSTICK_PRI;
+
+	/* Configure the regions in the MPU that are common to all tasks. */
+	prvSetupMPU();
+
+	/* Start the timer that generates the tick ISR.  Interrupts are disabled
+	here already. */
+	prvSetupTimerInterrupt();
+
+	/* Initialise the critical nesting count ready for the first task. */
+	uxCriticalNesting = 0;
+
+	/* Ensure the VFP is enabled - it should be anyway. */
+	vPortEnableVFP();
+
+	/* Lazy save always. */
+	*( portFPCCR ) |= portASPEN_AND_LSPEN_BITS;
+
+	/* Start the first task. */
+	prvStartFirstTask();
+
+	/* Should not get here! */
+	return 0;
+}
+/*-----------------------------------------------------------*/
+
+__asm void prvStartFirstTask( void )
+{
+	PRESERVE8
+	
+	ldr r0, =0xE000ED08	/* Use the NVIC offset register to locate the stack. */
+	ldr r0, [r0]
+	ldr r0, [r0]
+	msr msp, r0			/* Set the msp back to the start of the stack. */
+	cpsie i				/* Globally enable interrupts. */
+	cpsie f
+	dsb
+	isb
+	svc portSVC_START_SCHEDULER	/* System call to start first task. */
+	nop
+	nop
+}
+
+void vPortEndScheduler( void )
+{
+	/* Not implemented in ports where there is nothing to return to.
+	Artificially force an assert. */
+	configASSERT( uxCriticalNesting == 1000UL );
+}
+/*-----------------------------------------------------------*/
+
+void vPortEnterCritical( void )
+{
+BaseType_t xRunningPrivileged = xPortRaisePrivilege();
+
+	portDISABLE_INTERRUPTS();
+	uxCriticalNesting++;
+
+	vPortResetPrivilege( xRunningPrivileged );
+}
+/*-----------------------------------------------------------*/
+
+void vPortExitCritical( void )
+{
+BaseType_t xRunningPrivileged = xPortRaisePrivilege();
+
+	configASSERT( uxCriticalNesting );
+	uxCriticalNesting--;
+	if( uxCriticalNesting == 0 )
+	{
+		portENABLE_INTERRUPTS();
+	}
+	vPortResetPrivilege( xRunningPrivileged );
+}
+/*-----------------------------------------------------------*/
+
+__asm void xPortPendSVHandler( void )
+{
+	extern uxCriticalNesting;
+	extern pxCurrentTCB;
+	extern vTaskSwitchContext;
+
+	PRESERVE8
+
+	mrs r0, psp
+
+	ldr	r3, =pxCurrentTCB			/* Get the location of the current TCB. */
+	ldr	r2, [r3]
+
+	tst r14, #0x10					/* Is the task using the FPU context?  If so, push high vfp registers. */
+	it eq
+	vstmdbeq r0!, {s16-s31}
+
+	mrs r1, control
+	stmdb r0!, {r1, r4-r11, r14}	/* Save the remaining registers. */
+	str r0, [r2]					/* Save the new top of stack into the first member of the TCB. */
+
+	stmdb sp!, {r3}
+	mov r0, #configMAX_SYSCALL_INTERRUPT_PRIORITY
+	msr basepri, r0
+	dsb
+	isb
+	bl vTaskSwitchContext
+	mov r0, #0
+	msr basepri, r0
+	ldmia sp!, {r3}
+									/* Restore the context. */
+	ldr r1, [r3]
+	ldr r0, [r1]					/* The first item in the TCB is the task top of stack. */
+	add r1, r1, #4					/* Move onto the second item in the TCB... */
+	ldr r2, =0xe000ed9c				/* Region Base Address register. */
+	ldmia r1!, {r4-r11}				/* Read 4 sets of MPU registers. */
+	stmia r2!, {r4-r11}				/* Write 4 sets of MPU registers. */
+	ldmia r0!, {r3-r11, r14}		/* Pop the registers that are not automatically saved on exception entry. */
+	msr control, r3
+
+	tst r14, #0x10					/* Is the task using the FPU context?  If so, pop the high vfp registers too. */
+	it eq
+	vldmiaeq r0!, {s16-s31}
+
+	msr psp, r0
+	bx r14
+	nop
+}
+/*-----------------------------------------------------------*/
+
+void xPortSysTickHandler( void )
+{
+uint32_t ulDummy;
+
+	ulDummy = portSET_INTERRUPT_MASK_FROM_ISR();
+	{
+		/* Increment the RTOS tick. */
+		if( xTaskIncrementTick() != pdFALSE )
+		{
+			/* Pend a context switch. */
+			portNVIC_INT_CTRL_REG = portNVIC_PENDSVSET_BIT;
+		}
+	}
+	portCLEAR_INTERRUPT_MASK_FROM_ISR( ulDummy );
+}
+/*-----------------------------------------------------------*/
+
+/*
+ * Setup the systick timer to generate the tick interrupts at the required
+ * frequency.
+ */
+static void prvSetupTimerInterrupt( void )
+{
+	/* Configure SysTick to interrupt at the requested rate. */
+	portNVIC_SYSTICK_LOAD_REG = ( configCPU_CLOCK_HZ / configTICK_RATE_HZ ) - 1UL;
+	portNVIC_SYSTICK_CTRL_REG = portNVIC_SYSTICK_CLK | portNVIC_SYSTICK_INT | portNVIC_SYSTICK_ENABLE;
+}
+/*-----------------------------------------------------------*/
+
+__asm void vPortSwitchToUserMode( void )
+{
+	PRESERVE8
+	
+	mrs r0, control
+	orr r0, #1
+	msr control, r0
+	bx r14
+}
+/*-----------------------------------------------------------*/
+	
+__asm void vPortEnableVFP( void )
+{
+	PRESERVE8
+	
+	ldr.w r0, =0xE000ED88		/* The FPU enable bits are in the CPACR. */
+	ldr r1, [r0]
+
+	orr r1, r1, #( 0xf << 20 )	/* Enable CP10 and CP11 coprocessors, then save back. */
+	str r1, [r0]
+	bx r14
+	nop
+	nop
+}
+/*-----------------------------------------------------------*/
+
+static void prvSetupMPU( void )
+{
+extern uint32_t __privileged_functions_end__;
+extern uint32_t __FLASH_segment_start__;
+extern uint32_t __FLASH_segment_end__;
+extern uint32_t __privileged_data_start__;
+extern uint32_t __privileged_data_end__;
+
+	/* Check the expected MPU is present. */
+	if( portMPU_TYPE_REG == portEXPECTED_MPU_TYPE_VALUE )
+	{
+		/* First setup the entire flash for unprivileged read only access. */
+		portMPU_REGION_BASE_ADDRESS_REG =	( ( uint32_t ) __FLASH_segment_start__ ) | /* Base address. */
+											( portMPU_REGION_VALID ) |
+											( portUNPRIVILEGED_FLASH_REGION );
+
+		portMPU_REGION_ATTRIBUTE_REG =	( portMPU_REGION_READ_ONLY ) |
+										( portMPU_REGION_CACHEABLE_BUFFERABLE ) |
+										( prvGetMPURegionSizeSetting( ( uint32_t ) __FLASH_segment_end__ - ( uint32_t ) __FLASH_segment_start__ ) ) |
+										( portMPU_REGION_ENABLE );
+
+		/* Setup the first 16K for privileged only access (even though less
+		than 10K is actually being used).  This is where the kernel code is
+		placed. */
+		portMPU_REGION_BASE_ADDRESS_REG =	( ( uint32_t ) __FLASH_segment_start__ ) | /* Base address. */
+											( portMPU_REGION_VALID ) |
+											( portPRIVILEGED_FLASH_REGION );
+
+		portMPU_REGION_ATTRIBUTE_REG =	( portMPU_REGION_PRIVILEGED_READ_ONLY ) |
+										( portMPU_REGION_CACHEABLE_BUFFERABLE ) |
+										( prvGetMPURegionSizeSetting( ( uint32_t ) __privileged_functions_end__ - ( uint32_t ) __FLASH_segment_start__ ) ) |
+										( portMPU_REGION_ENABLE );
+
+		/* Setup the privileged data RAM region.  This is where the kernel data
+		is placed. */
+		portMPU_REGION_BASE_ADDRESS_REG =	( ( uint32_t ) __privileged_data_start__ ) | /* Base address. */
+											( portMPU_REGION_VALID ) |
+											( portPRIVILEGED_RAM_REGION );
+
+		portMPU_REGION_ATTRIBUTE_REG =	( portMPU_REGION_PRIVILEGED_READ_WRITE ) |
+										( portMPU_REGION_CACHEABLE_BUFFERABLE ) |
+										prvGetMPURegionSizeSetting( ( uint32_t ) __privileged_data_end__ - ( uint32_t ) __privileged_data_start__ ) |
+										( portMPU_REGION_ENABLE );
+
+		/* By default allow everything to access the general peripherals.  The
+		system peripherals and registers are protected. */
+		portMPU_REGION_BASE_ADDRESS_REG =	( portPERIPHERALS_START_ADDRESS ) |
+											( portMPU_REGION_VALID ) |
+											( portGENERAL_PERIPHERALS_REGION );
+
+		portMPU_REGION_ATTRIBUTE_REG =	( portMPU_REGION_READ_WRITE | portMPU_REGION_EXECUTE_NEVER ) |
+										( prvGetMPURegionSizeSetting( portPERIPHERALS_END_ADDRESS - portPERIPHERALS_START_ADDRESS ) ) |
+										( portMPU_REGION_ENABLE );
+
+		/* Enable the memory fault exception. */
+		portNVIC_SYS_CTRL_STATE_REG |= portNVIC_MEM_FAULT_ENABLE;
+
+		/* Enable the MPU with the background region configured. */
+		portMPU_CTRL_REG |= ( portMPU_ENABLE | portMPU_BACKGROUND_ENABLE );
+	}
+}
+/*-----------------------------------------------------------*/
+
+static uint32_t prvGetMPURegionSizeSetting( uint32_t ulActualSizeInBytes )
+{
+uint32_t ulRegionSize, ulReturnValue = 4;
+
+	/* 32 is the smallest region size, 31 is the largest valid value for
+	ulReturnValue. */
+	for( ulRegionSize = 32UL; ulReturnValue < 31UL; ( ulRegionSize <<= 1UL ) )
+	{
+		if( ulActualSizeInBytes <= ulRegionSize )
+		{
+			break;
+		}
+		else
+		{
+			ulReturnValue++;
+		}
+	}
+
+	/* Shift the code by one before returning so it can be written directly
+	into the the correct bit position of the attribute register. */
+	return ( ulReturnValue << 1UL );
+}
+/*-----------------------------------------------------------*/
+
+__asm BaseType_t xPortRaisePrivilege( void )
+{
+	mrs r0, control
+	tst r0, #1						/* Is the task running privileged? */
+	itte ne
+	movne r0, #0					/* CONTROL[0]!=0, return false. */
+	svcne portSVC_RAISE_PRIVILEGE	/* Switch to privileged. */
+	moveq r0, #1					/* CONTROL[0]==0, return true. */
+	bx lr
+}
+/*-----------------------------------------------------------*/
+
+void vPortStoreTaskMPUSettings( xMPU_SETTINGS *xMPUSettings, const struct xMEMORY_REGION * const xRegions, StackType_t *pxBottomOfStack, uint32_t ulStackDepth )
+{
+extern uint32_t __SRAM_segment_start__;
+extern uint32_t __SRAM_segment_end__;
+extern uint32_t __privileged_data_start__;
+extern uint32_t __privileged_data_end__;
+
+	
+int32_t lIndex;
+uint32_t ul;
+
+	if( xRegions == NULL )
+	{
+		/* No MPU regions are specified so allow access to all RAM. */
+		xMPUSettings->xRegion[ 0 ].ulRegionBaseAddress =
+				( ( uint32_t ) __SRAM_segment_start__ ) | /* Base address. */
+				( portMPU_REGION_VALID ) |
+				( portSTACK_REGION );
+
+		xMPUSettings->xRegion[ 0 ].ulRegionAttribute =
+				( portMPU_REGION_READ_WRITE ) |
+				( portMPU_REGION_CACHEABLE_BUFFERABLE ) |
+				( prvGetMPURegionSizeSetting( ( uint32_t ) __SRAM_segment_end__ - ( uint32_t ) __SRAM_segment_start__ ) ) |
+				( portMPU_REGION_ENABLE );
+
+		/* Re-instate the privileged only RAM region as xRegion[ 0 ] will have
+		just removed the privileged only parameters. */
+		xMPUSettings->xRegion[ 1 ].ulRegionBaseAddress =
+				( ( uint32_t ) __privileged_data_start__ ) | /* Base address. */
+				( portMPU_REGION_VALID ) |
+				( portSTACK_REGION + 1 );
+
+		xMPUSettings->xRegion[ 1 ].ulRegionAttribute =
+				( portMPU_REGION_PRIVILEGED_READ_WRITE ) |
+				( portMPU_REGION_CACHEABLE_BUFFERABLE ) |
+				prvGetMPURegionSizeSetting( ( uint32_t ) __privileged_data_end__ - ( uint32_t ) __privileged_data_start__ ) |
+				( portMPU_REGION_ENABLE );
+
+		/* Invalidate all other regions. */
+		for( ul = 2; ul <= portNUM_CONFIGURABLE_REGIONS; ul++ )
+		{
+			xMPUSettings->xRegion[ ul ].ulRegionBaseAddress = ( portSTACK_REGION + ul ) | portMPU_REGION_VALID;
+			xMPUSettings->xRegion[ ul ].ulRegionAttribute = 0UL;
+		}
+	}
+	else
+	{
+		/* This function is called automatically when the task is created - in
+		which case the stack region parameters will be valid.  At all other
+		times the stack parameters will not be valid and it is assumed that the
+		stack region has already been configured. */
+		if( ulStackDepth > 0 )
+		{
+			/* Define the region that allows access to the stack. */
+			xMPUSettings->xRegion[ 0 ].ulRegionBaseAddress =
+					( ( uint32_t ) pxBottomOfStack ) |
+					( portMPU_REGION_VALID ) |
+					( portSTACK_REGION ); /* Region number. */
+
+			xMPUSettings->xRegion[ 0 ].ulRegionAttribute =
+					( portMPU_REGION_READ_WRITE ) | /* Read and write. */
+					( prvGetMPURegionSizeSetting( ulStackDepth * ( uint32_t ) sizeof( StackType_t ) ) ) |
+					( portMPU_REGION_CACHEABLE_BUFFERABLE ) |
+					( portMPU_REGION_ENABLE );
+		}
+
+		lIndex = 0;
+
+		for( ul = 1; ul <= portNUM_CONFIGURABLE_REGIONS; ul++ )
+		{
+			if( ( xRegions[ lIndex ] ).ulLengthInBytes > 0UL )
+			{
+				/* Translate the generic region definition contained in
+				xRegions into the CM3 specific MPU settings that are then
+				stored in xMPUSettings. */
+				xMPUSettings->xRegion[ ul ].ulRegionBaseAddress =
+						( ( uint32_t ) xRegions[ lIndex ].pvBaseAddress ) |
+						( portMPU_REGION_VALID ) |
+						( portSTACK_REGION + ul ); /* Region number. */
+
+				xMPUSettings->xRegion[ ul ].ulRegionAttribute =
+						( prvGetMPURegionSizeSetting( xRegions[ lIndex ].ulLengthInBytes ) ) |
+						( xRegions[ lIndex ].ulParameters ) |
+						( portMPU_REGION_ENABLE );
+			}
+			else
+			{
+				/* Invalidate the region. */
+				xMPUSettings->xRegion[ ul ].ulRegionBaseAddress = ( portSTACK_REGION + ul ) | portMPU_REGION_VALID;
+				xMPUSettings->xRegion[ ul ].ulRegionAttribute = 0UL;
+			}
+
+			lIndex++;
+		}
+	}
+}
+/*-----------------------------------------------------------*/
+
+__asm uint32_t prvPortGetIPSR( void )
+{
+	PRESERVE8
+
+	mrs r0, ipsr
+	bx r14
+}
+/*-----------------------------------------------------------*/
+
+#if( configASSERT_DEFINED == 1 )
+
+	void vPortValidateInterruptPriority( void )
+	{
+	uint32_t ulCurrentInterrupt;
+	uint8_t ucCurrentPriority;
+
+		/* Obtain the number of the currently executing interrupt. */
+		ulCurrentInterrupt = prvPortGetIPSR();
+
+		/* Is the interrupt number a user defined interrupt? */
+		if( ulCurrentInterrupt >= portFIRST_USER_INTERRUPT_NUMBER )
+		{
+			/* Look up the interrupt's priority. */
+			ucCurrentPriority = pcInterruptPriorityRegisters[ ulCurrentInterrupt ];
+
+			/* The following assertion will fail if a service routine (ISR) for
+			an interrupt that has been assigned a priority above
+			configMAX_SYSCALL_INTERRUPT_PRIORITY calls an ISR safe FreeRTOS API
+			function.  ISR safe FreeRTOS API functions must *only* be called
+			from interrupts that have been assigned a priority at or below
+			configMAX_SYSCALL_INTERRUPT_PRIORITY.
+
+			Numerically low interrupt priority numbers represent logically high
+			interrupt priorities, therefore the priority of the interrupt must
+			be set to a value equal to or numerically *higher* than
+			configMAX_SYSCALL_INTERRUPT_PRIORITY.
+
+			Interrupts that	use the FreeRTOS API must not be left at their
+			default priority of	zero as that is the highest possible priority,
+			which is guaranteed to be above configMAX_SYSCALL_INTERRUPT_PRIORITY,
+			and	therefore also guaranteed to be invalid.
+
+			FreeRTOS maintains separate thread and ISR API functions to ensure
+			interrupt entry is as fast and simple as possible.
+
+			The following links provide detailed information:
+			http://www.freertos.org/RTOS-Cortex-M3-M4.html
+			http://www.freertos.org/FAQHelp.html */
+			configASSERT( ucCurrentPriority >= ucMaxSysCallPriority );
+		}
+
+		/* Priority grouping:  The interrupt controller (NVIC) allows the bits
+		that define each interrupt's priority to be split between bits that
+		define the interrupt's pre-emption priority bits and bits that define
+		the interrupt's sub-priority.  For simplicity all bits must be defined
+		to be pre-emption priority bits.  The following assertion will fail if
+		this is not the case (if some bits represent a sub-priority).
+
+		If the application only uses CMSIS libraries for interrupt
+		configuration then the correct setting can be achieved on all Cortex-M
+		devices by calling NVIC_SetPriorityGrouping( 0 ); before starting the
+		scheduler.  Note however that some vendor specific peripheral libraries
+		assume a non-zero priority group setting, in which cases using a value
+		of zero will result in unpredicable behaviour. */
+		configASSERT( ( portAIRCR_REG & portPRIORITY_GROUP_MASK ) <= ulMaxPRIGROUPValue );
+	}
+
+#endif /* configASSERT_DEFINED */
+
+
diff --git a/FreeRTOS/portable/RVDS/ARM_CM4_MPU/portmacro.h b/FreeRTOS/portable/RVDS/ARM_CM4_MPU/portmacro.h
new file mode 100644
index 0000000..43b8323
--- /dev/null
+++ b/FreeRTOS/portable/RVDS/ARM_CM4_MPU/portmacro.h
@@ -0,0 +1,348 @@
+/*
+    FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd.
+    All rights reserved
+
+    VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION.
+
+    This file is part of the FreeRTOS distribution.
+
+    FreeRTOS is free software; you can redistribute it and/or modify it under
+    the terms of the GNU General Public License (version 2) as published by the
+    Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception.
+
+    ***************************************************************************
+    >>!   NOTE: The modification to the GPL is included to allow you to     !<<
+    >>!   distribute a combined work that includes FreeRTOS without being   !<<
+    >>!   obliged to provide the source code for proprietary components     !<<
+    >>!   outside of the FreeRTOS kernel.                                   !<<
+    ***************************************************************************
+
+    FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY
+    WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+    FOR A PARTICULAR PURPOSE.  Full license text is available on the following
+    link: http://www.freertos.org/a00114.html
+
+    ***************************************************************************
+     *                                                                       *
+     *    FreeRTOS provides completely free yet professionally developed,    *
+     *    robust, strictly quality controlled, supported, and cross          *
+     *    platform software that is more than just the market leader, it     *
+     *    is the industry's de facto standard.                               *
+     *                                                                       *
+     *    Help yourself get started quickly while simultaneously helping     *
+     *    to support the FreeRTOS project by purchasing a FreeRTOS           *
+     *    tutorial book, reference manual, or both:                          *
+     *    http://www.FreeRTOS.org/Documentation                              *
+     *                                                                       *
+    ***************************************************************************
+
+    http://www.FreeRTOS.org/FAQHelp.html - Having a problem?  Start by reading
+    the FAQ page "My application does not run, what could be wrong?".  Have you
+    defined configASSERT()?
+
+    http://www.FreeRTOS.org/support - In return for receiving this top quality
+    embedded software for free we request you assist our global community by
+    participating in the support forum.
+
+    http://www.FreeRTOS.org/training - Investing in training allows your team to
+    be as productive as possible as early as possible.  Now you can receive
+    FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers
+    Ltd, and the world's leading authority on the world's leading RTOS.
+
+    http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products,
+    including FreeRTOS+Trace - an indispensable productivity tool, a DOS
+    compatible FAT file system, and our tiny thread aware UDP/IP stack.
+
+    http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate.
+    Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS.
+
+    http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High
+    Integrity Systems ltd. to sell under the OpenRTOS brand.  Low cost OpenRTOS
+    licenses offer ticketed support, indemnification and commercial middleware.
+
+    http://www.SafeRTOS.com - High Integrity Systems also provide a safety
+    engineered and independently SIL3 certified version for use in safety and
+    mission critical applications that require provable dependability.
+
+    1 tab == 4 spaces!
+*/
+
+
+#ifndef PORTMACRO_H
+#define PORTMACRO_H
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/*-----------------------------------------------------------
+ * Port specific definitions.
+ *
+ * The settings in this file configure FreeRTOS correctly for the
+ * given hardware and compiler.
+ *
+ * These settings should not be altered.
+ *-----------------------------------------------------------
+ */
+
+/* Type definitions. */
+#define portCHAR		char
+#define portFLOAT		float
+#define portDOUBLE		double
+#define portLONG		long
+#define portSHORT		short
+#define portSTACK_TYPE	uint32_t
+#define portBASE_TYPE	long
+
+typedef portSTACK_TYPE StackType_t;
+typedef long BaseType_t;
+typedef unsigned long UBaseType_t;
+
+#if( configUSE_16_BIT_TICKS == 1 )
+	typedef uint16_t TickType_t;
+	#define portMAX_DELAY ( TickType_t ) 0xffff
+#else
+	typedef uint32_t TickType_t;
+	#define portMAX_DELAY ( TickType_t ) 0xffffffffUL
+
+	/* 32-bit tick type on a 32-bit architecture, so reads of the tick count do
+	not need to be guarded with a critical section. */
+	#define portTICK_TYPE_IS_ATOMIC 1
+#endif
+/*-----------------------------------------------------------*/
+
+/* MPU specific constants. */
+#define portUSING_MPU_WRAPPERS		1
+#define portPRIVILEGE_BIT			( 0x80000000UL )
+
+#define portMPU_REGION_READ_WRITE				( 0x03UL << 24UL )
+#define portMPU_REGION_PRIVILEGED_READ_ONLY		( 0x05UL << 24UL )
+#define portMPU_REGION_READ_ONLY				( 0x06UL << 24UL )
+#define portMPU_REGION_PRIVILEGED_READ_WRITE	( 0x01UL << 24UL )
+#define portMPU_REGION_CACHEABLE_BUFFERABLE		( 0x07UL << 16UL )
+#define portMPU_REGION_EXECUTE_NEVER			( 0x01UL << 28UL )
+
+#define portUNPRIVILEGED_FLASH_REGION		( 0UL )
+#define portPRIVILEGED_FLASH_REGION			( 1UL )
+#define portPRIVILEGED_RAM_REGION			( 2UL )
+#define portGENERAL_PERIPHERALS_REGION		( 3UL )
+#define portSTACK_REGION					( 4UL )
+#define portFIRST_CONFIGURABLE_REGION	    ( 5UL )
+#define portLAST_CONFIGURABLE_REGION		( 7UL )
+#define portNUM_CONFIGURABLE_REGIONS		( ( portLAST_CONFIGURABLE_REGION - portFIRST_CONFIGURABLE_REGION ) + 1 )
+#define portTOTAL_NUM_REGIONS				( portNUM_CONFIGURABLE_REGIONS + 1 ) /* Plus one to make space for the stack region. */
+
+void vPortSwitchToUserMode( void );
+#define portSWITCH_TO_USER_MODE()	vPortSwitchToUserMode()
+
+typedef struct MPU_REGION_REGISTERS
+{
+	uint32_t ulRegionBaseAddress;
+	uint32_t ulRegionAttribute;
+} xMPU_REGION_REGISTERS;
+
+/* Plus 1 to create space for the stack region. */
+typedef struct MPU_SETTINGS
+{
+	xMPU_REGION_REGISTERS xRegion[ portTOTAL_NUM_REGIONS ];
+} xMPU_SETTINGS;
+
+/* Architecture specifics. */
+#define portSTACK_GROWTH			( -1 )
+#define portTICK_PERIOD_MS			( ( TickType_t ) 1000 / configTICK_RATE_HZ )
+#define portBYTE_ALIGNMENT			8
+
+/* Constants used with memory barrier intrinsics. */
+#define portSY_FULL_READ_WRITE		( 15 )
+
+/*-----------------------------------------------------------*/
+
+/* SVC numbers for various services. */
+#define portSVC_START_SCHEDULER				0
+#define portSVC_YIELD						1
+#define portSVC_RAISE_PRIVILEGE				2
+
+/* Scheduler utilities. */
+
+#define portYIELD()				__asm{ SVC portSVC_YIELD }
+#define portYIELD_WITHIN_API() 													\
+{																				\
+	/* Set a PendSV to request a context switch. */								\
+	portNVIC_INT_CTRL_REG = portNVIC_PENDSVSET_BIT;								\
+																				\
+	/* Barriers are normally not required but do ensure the code is completely	\
+	within the specified behaviour for the architecture. */						\
+	__dsb( portSY_FULL_READ_WRITE );											\
+	__isb( portSY_FULL_READ_WRITE );											\
+}
+/*-----------------------------------------------------------*/
+
+#define portNVIC_INT_CTRL_REG		( * ( ( volatile uint32_t * ) 0xe000ed04 ) )
+#define portNVIC_PENDSVSET_BIT		( 1UL << 28UL )
+#define portEND_SWITCHING_ISR( xSwitchRequired ) if( xSwitchRequired ) portNVIC_INT_CTRL_REG = portNVIC_PENDSVSET
+#define portYIELD_FROM_ISR( x ) portEND_SWITCHING_ISR( x )
+/*-----------------------------------------------------------*/
+
+/* Critical section management. */
+extern void vPortEnterCritical( void );
+extern void vPortExitCritical( void );
+
+#define portDISABLE_INTERRUPTS()				vPortRaiseBASEPRI()
+#define portENABLE_INTERRUPTS()					vPortSetBASEPRI(0)
+#define portENTER_CRITICAL()					vPortEnterCritical()
+#define portEXIT_CRITICAL()						vPortExitCritical()
+#define portSET_INTERRUPT_MASK_FROM_ISR()		ulPortRaiseBASEPRI()
+#define portCLEAR_INTERRUPT_MASK_FROM_ISR(x)	vPortSetBASEPRI(x)
+
+/*-----------------------------------------------------------*/
+
+/* Architecture specific optimisations. */
+#ifndef configUSE_PORT_OPTIMISED_TASK_SELECTION
+	#define configUSE_PORT_OPTIMISED_TASK_SELECTION 1
+#endif
+
+#if configUSE_PORT_OPTIMISED_TASK_SELECTION == 1
+
+	/* Check the configuration. */
+	#if( configMAX_PRIORITIES > 32 )
+		#error configUSE_PORT_OPTIMISED_TASK_SELECTION can only be set to 1 when configMAX_PRIORITIES is less than or equal to 32.  It is very rare that a system requires more than 10 to 15 difference priorities as tasks that share a priority will time slice.
+	#endif
+
+	/* Store/clear the ready priorities in a bit map. */
+	#define portRECORD_READY_PRIORITY( uxPriority, uxReadyPriorities ) ( uxReadyPriorities ) |= ( 1UL << ( uxPriority ) )
+	#define portRESET_READY_PRIORITY( uxPriority, uxReadyPriorities ) ( uxReadyPriorities ) &= ~( 1UL << ( uxPriority ) )
+
+	/*-----------------------------------------------------------*/
+
+	#define portGET_HIGHEST_PRIORITY( uxTopPriority, uxReadyPriorities ) uxTopPriority = ( 31UL - ( uint32_t ) __clz( ( uxReadyPriorities ) ) )
+
+#endif /* configUSE_PORT_OPTIMISED_TASK_SELECTION */
+/*-----------------------------------------------------------*/
+
+/* Task function macros as described on the FreeRTOS.org WEB site.  These are
+not necessary for to use this port.  They are defined so the common demo files
+(which build with all the ports) will build. */
+#define portTASK_FUNCTION_PROTO( vFunction, pvParameters ) void vFunction( void *pvParameters )
+#define portTASK_FUNCTION( vFunction, pvParameters ) void vFunction( void *pvParameters )
+/*-----------------------------------------------------------*/
+
+#ifdef configASSERT
+	void vPortValidateInterruptPriority( void );
+	#define portASSERT_IF_INTERRUPT_PRIORITY_INVALID() 	vPortValidateInterruptPriority()
+#endif
+
+/* portNOP() is not required by this port. */
+#define portNOP()
+
+#define portINLINE __inline
+
+#ifndef portFORCE_INLINE
+	#define portFORCE_INLINE __forceinline
+#endif
+
+/*-----------------------------------------------------------*/
+
+static portFORCE_INLINE void vPortSetBASEPRI( uint32_t ulBASEPRI )
+{
+	__asm
+	{
+		/* Barrier instructions are not used as this function is only used to
+		lower the BASEPRI value. */
+		msr basepri, ulBASEPRI
+	}
+}
+/*-----------------------------------------------------------*/
+
+static portFORCE_INLINE void vPortRaiseBASEPRI( void )
+{
+uint32_t ulNewBASEPRI = configMAX_SYSCALL_INTERRUPT_PRIORITY;
+
+	__asm
+	{
+		/* Set BASEPRI to the max syscall priority to effect a critical
+		section. */
+		msr basepri, ulNewBASEPRI
+		dsb
+		isb
+	}
+}
+/*-----------------------------------------------------------*/
+
+static portFORCE_INLINE void vPortClearBASEPRIFromISR( void )
+{
+	__asm
+	{
+		/* Set BASEPRI to 0 so no interrupts are masked.  This function is only
+		used to lower the mask in an interrupt, so memory barriers are not 
+		used. */
+		msr basepri, #0
+	}
+}
+/*-----------------------------------------------------------*/
+
+static portFORCE_INLINE uint32_t ulPortRaiseBASEPRI( void )
+{
+uint32_t ulReturn, ulNewBASEPRI = configMAX_SYSCALL_INTERRUPT_PRIORITY;
+
+	__asm
+	{
+		/* Set BASEPRI to the max syscall priority to effect a critical
+		section. */
+		mrs ulReturn, basepri
+		msr basepri, ulNewBASEPRI
+		dsb
+		isb
+	}
+
+	return ulReturn;
+}
+/*-----------------------------------------------------------*/
+
+static portFORCE_INLINE BaseType_t xPortIsInsideInterrupt( void )
+{
+uint32_t ulCurrentInterrupt;
+BaseType_t xReturn;
+
+	/* Obtain the number of the currently executing interrupt. */
+	__asm
+	{
+		mrs ulCurrentInterrupt, ipsr
+	}
+
+	if( ulCurrentInterrupt == 0 )
+	{
+		xReturn = pdFALSE;
+	}
+	else
+	{
+		xReturn = pdTRUE;
+	}
+
+	return xReturn;
+}
+/*-----------------------------------------------------------*/
+
+/* Set the privilege level to user mode if xRunningPrivileged is false. */
+portFORCE_INLINE static void vPortResetPrivilege( BaseType_t xRunningPrivileged )
+{
+uint32_t ulReg;
+	
+	if( xRunningPrivileged != pdTRUE ) 
+	{
+		__asm 
+		{
+			mrs ulReg, control
+			orr ulReg, #1
+			msr control, ulReg
+		}
+	}
+}
+/*-----------------------------------------------------------*/
+
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* PORTMACRO_H */
+
diff --git a/FreeRTOS/portable/RVDS/ARM_CM7/ReadMe.txt b/FreeRTOS/portable/RVDS/ARM_CM7/ReadMe.txt
new file mode 100644
index 0000000..0a2e7fd
--- /dev/null
+++ b/FreeRTOS/portable/RVDS/ARM_CM7/ReadMe.txt
@@ -0,0 +1,18 @@
+There are two options for running FreeRTOS on ARM Cortex-M7 microcontrollers.
+The best option depends on the revision of the ARM Cortex-M7 core in use.  The
+revision is specified by an 'r' number, and a 'p' number, so will look something
+like 'r0p1'.  Check the documentation for the microcontroller in use to find the 
+revision of the Cortex-M7 core used in that microcontroller.  If in doubt, use 
+the FreeRTOS port provided specifically for r0p1 revisions, as that can be used
+with all core revisions.
+
+The first option is to use the ARM Cortex-M4F port, and the second option is to
+use the Cortex-M7 r0p1 port - the latter containing a minor errata workaround.
+
+If the revision of the ARM Cortex-M7 core is not r0p1 then either option can be
+used, but it is recommended to use the FreeRTOS ARM Cortex-M4F port located in 
+the /FreeRTOS/Source/portable/RVDS/ARM_CM4F directory.
+
+If the revision of the ARM Cortex-M7 core is r0p1 then use the FreeRTOS ARM
+Cortex-M7 r0p1 port located in the /FreeRTOS/Source/portable/RVDS/ARM_CM7/r0p1
+directory.
\ No newline at end of file
diff --git a/FreeRTOS/portable/RVDS/ARM_CM7/r0p1/port.c b/FreeRTOS/portable/RVDS/ARM_CM7/r0p1/port.c
new file mode 100644
index 0000000..d7c8f87
--- /dev/null
+++ b/FreeRTOS/portable/RVDS/ARM_CM7/r0p1/port.c
@@ -0,0 +1,775 @@
+/*
+    FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd.
+    All rights reserved
+
+    VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION.
+
+    This file is part of the FreeRTOS distribution.
+
+    FreeRTOS is free software; you can redistribute it and/or modify it under
+    the terms of the GNU General Public License (version 2) as published by the
+    Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception.
+
+    ***************************************************************************
+    >>!   NOTE: The modification to the GPL is included to allow you to     !<<
+    >>!   distribute a combined work that includes FreeRTOS without being   !<<
+    >>!   obliged to provide the source code for proprietary components     !<<
+    >>!   outside of the FreeRTOS kernel.                                   !<<
+    ***************************************************************************
+
+    FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY
+    WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+    FOR A PARTICULAR PURPOSE.  Full license text is available on the following
+    link: http://www.freertos.org/a00114.html
+
+    ***************************************************************************
+     *                                                                       *
+     *    FreeRTOS provides completely free yet professionally developed,    *
+     *    robust, strictly quality controlled, supported, and cross          *
+     *    platform software that is more than just the market leader, it     *
+     *    is the industry's de facto standard.                               *
+     *                                                                       *
+     *    Help yourself get started quickly while simultaneously helping     *
+     *    to support the FreeRTOS project by purchasing a FreeRTOS           *
+     *    tutorial book, reference manual, or both:                          *
+     *    http://www.FreeRTOS.org/Documentation                              *
+     *                                                                       *
+    ***************************************************************************
+
+    http://www.FreeRTOS.org/FAQHelp.html - Having a problem?  Start by reading
+    the FAQ page "My application does not run, what could be wrong?".  Have you
+    defined configASSERT()?
+
+    http://www.FreeRTOS.org/support - In return for receiving this top quality
+    embedded software for free we request you assist our global community by
+    participating in the support forum.
+
+    http://www.FreeRTOS.org/training - Investing in training allows your team to
+    be as productive as possible as early as possible.  Now you can receive
+    FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers
+    Ltd, and the world's leading authority on the world's leading RTOS.
+
+    http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products,
+    including FreeRTOS+Trace - an indispensable productivity tool, a DOS
+    compatible FAT file system, and our tiny thread aware UDP/IP stack.
+
+    http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate.
+    Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS.
+
+    http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High
+    Integrity Systems ltd. to sell under the OpenRTOS brand.  Low cost OpenRTOS
+    licenses offer ticketed support, indemnification and commercial middleware.
+
+    http://www.SafeRTOS.com - High Integrity Systems also provide a safety
+    engineered and independently SIL3 certified version for use in safety and
+    mission critical applications that require provable dependability.
+
+    1 tab == 4 spaces!
+*/
+
+/*-----------------------------------------------------------
+ * Implementation of functions defined in portable.h for the ARM CM4F port.
+ *----------------------------------------------------------*/
+
+/* Scheduler includes. */
+#include "FreeRTOS.h"
+#include "task.h"
+
+#ifndef __TARGET_FPU_VFP
+	#error This port can only be used when the project options are configured to enable hardware floating point support.
+#endif
+
+#if configMAX_SYSCALL_INTERRUPT_PRIORITY == 0
+	#error configMAX_SYSCALL_INTERRUPT_PRIORITY must not be set to 0.  See http://www.FreeRTOS.org/RTOS-Cortex-M3-M4.html
+#endif
+
+#ifndef configSYSTICK_CLOCK_HZ
+	#define configSYSTICK_CLOCK_HZ configCPU_CLOCK_HZ
+	/* Ensure the SysTick is clocked at the same frequency as the core. */
+	#define portNVIC_SYSTICK_CLK_BIT	( 1UL << 2UL )
+#else
+	/* The way the SysTick is clocked is not modified in case it is not the same
+	as the core. */
+	#define portNVIC_SYSTICK_CLK_BIT	( 0 )
+#endif
+
+/* The __weak attribute does not work as you might expect with the Keil tools
+so the configOVERRIDE_DEFAULT_TICK_CONFIGURATION constant must be set to 1 if
+the application writer wants to provide their own implementation of
+vPortSetupTimerInterrupt().  Ensure configOVERRIDE_DEFAULT_TICK_CONFIGURATION
+is defined. */
+#ifndef configOVERRIDE_DEFAULT_TICK_CONFIGURATION
+	#define configOVERRIDE_DEFAULT_TICK_CONFIGURATION 0
+#endif
+
+/* Constants required to manipulate the core.  Registers first... */
+#define portNVIC_SYSTICK_CTRL_REG			( * ( ( volatile uint32_t * ) 0xe000e010 ) )
+#define portNVIC_SYSTICK_LOAD_REG			( * ( ( volatile uint32_t * ) 0xe000e014 ) )
+#define portNVIC_SYSTICK_CURRENT_VALUE_REG	( * ( ( volatile uint32_t * ) 0xe000e018 ) )
+#define portNVIC_SYSPRI2_REG				( * ( ( volatile uint32_t * ) 0xe000ed20 ) )
+/* ...then bits in the registers. */
+#define portNVIC_SYSTICK_INT_BIT			( 1UL << 1UL )
+#define portNVIC_SYSTICK_ENABLE_BIT			( 1UL << 0UL )
+#define portNVIC_SYSTICK_COUNT_FLAG_BIT		( 1UL << 16UL )
+#define portNVIC_PENDSVCLEAR_BIT 			( 1UL << 27UL )
+#define portNVIC_PEND_SYSTICK_CLEAR_BIT		( 1UL << 25UL )
+
+#define portNVIC_PENDSV_PRI					( ( ( uint32_t ) configKERNEL_INTERRUPT_PRIORITY ) << 16UL )
+#define portNVIC_SYSTICK_PRI				( ( ( uint32_t ) configKERNEL_INTERRUPT_PRIORITY ) << 24UL )
+
+/* Constants required to check the validity of an interrupt priority. */
+#define portFIRST_USER_INTERRUPT_NUMBER		( 16 )
+#define portNVIC_IP_REGISTERS_OFFSET_16 	( 0xE000E3F0 )
+#define portAIRCR_REG						( * ( ( volatile uint32_t * ) 0xE000ED0C ) )
+#define portMAX_8_BIT_VALUE					( ( uint8_t ) 0xff )
+#define portTOP_BIT_OF_BYTE					( ( uint8_t ) 0x80 )
+#define portMAX_PRIGROUP_BITS				( ( uint8_t ) 7 )
+#define portPRIORITY_GROUP_MASK				( 0x07UL << 8UL )
+#define portPRIGROUP_SHIFT					( 8UL )
+
+/* Masks off all bits but the VECTACTIVE bits in the ICSR register. */
+#define portVECTACTIVE_MASK					( 0xFFUL )
+
+/* Constants required to manipulate the VFP. */
+#define portFPCCR					( ( volatile uint32_t * ) 0xe000ef34 ) /* Floating point context control register. */
+#define portASPEN_AND_LSPEN_BITS	( 0x3UL << 30UL )
+
+/* Constants required to set up the initial stack. */
+#define portINITIAL_XPSR			( 0x01000000 )
+#define portINITIAL_EXEC_RETURN		( 0xfffffffd )
+
+/* The systick is a 24-bit counter. */
+#define portMAX_24_BIT_NUMBER				( 0xffffffUL )
+
+/* A fiddle factor to estimate the number of SysTick counts that would have
+occurred while the SysTick counter is stopped during tickless idle
+calculations. */
+#define portMISSED_COUNTS_FACTOR			( 45UL )
+
+/* For strict compliance with the Cortex-M spec the task start address should
+have bit-0 clear, as it is loaded into the PC on exit from an ISR. */
+#define portSTART_ADDRESS_MASK				( ( StackType_t ) 0xfffffffeUL )
+
+/* Each task maintains its own interrupt status in the critical nesting
+variable. */
+static UBaseType_t uxCriticalNesting = 0xaaaaaaaa;
+
+/*
+ * Setup the timer to generate the tick interrupts.  The implementation in this
+ * file is weak to allow application writers to change the timer used to
+ * generate the tick interrupt.
+ */
+void vPortSetupTimerInterrupt( void );
+
+/*
+ * Exception handlers.
+ */
+void xPortPendSVHandler( void );
+void xPortSysTickHandler( void );
+void vPortSVCHandler( void );
+
+/*
+ * Start first task is a separate function so it can be tested in isolation.
+ */
+static void prvStartFirstTask( void );
+
+/*
+ * Functions defined in portasm.s to enable the VFP.
+ */
+static void prvEnableVFP( void );
+
+/*
+ * Used to catch tasks that attempt to return from their implementing function.
+ */
+static void prvTaskExitError( void );
+
+/*-----------------------------------------------------------*/
+
+/*
+ * The number of SysTick increments that make up one tick period.
+ */
+#if configUSE_TICKLESS_IDLE == 1
+	static uint32_t ulTimerCountsForOneTick = 0;
+#endif /* configUSE_TICKLESS_IDLE */
+
+/*
+ * The maximum number of tick periods that can be suppressed is limited by the
+ * 24 bit resolution of the SysTick timer.
+ */
+#if configUSE_TICKLESS_IDLE == 1
+	static uint32_t xMaximumPossibleSuppressedTicks = 0;
+#endif /* configUSE_TICKLESS_IDLE */
+
+/*
+ * Compensate for the CPU cycles that pass while the SysTick is stopped (low
+ * power functionality only.
+ */
+#if configUSE_TICKLESS_IDLE == 1
+	static uint32_t ulStoppedTimerCompensation = 0;
+#endif /* configUSE_TICKLESS_IDLE */
+
+/*
+ * Used by the portASSERT_IF_INTERRUPT_PRIORITY_INVALID() macro to ensure
+ * FreeRTOS API functions are not called from interrupts that have been assigned
+ * a priority above configMAX_SYSCALL_INTERRUPT_PRIORITY.
+ */
+#if ( configASSERT_DEFINED == 1 )
+	 static uint8_t ucMaxSysCallPriority = 0;
+	 static uint32_t ulMaxPRIGROUPValue = 0;
+	 static const volatile uint8_t * const pcInterruptPriorityRegisters = ( uint8_t * ) portNVIC_IP_REGISTERS_OFFSET_16;
+#endif /* configASSERT_DEFINED */
+
+/*-----------------------------------------------------------*/
+
+/*
+ * See header file for description.
+ */
+StackType_t *pxPortInitialiseStack( StackType_t *pxTopOfStack, TaskFunction_t pxCode, void *pvParameters )
+{
+	/* Simulate the stack frame as it would be created by a context switch
+	interrupt. */
+
+	/* Offset added to account for the way the MCU uses the stack on entry/exit
+	of interrupts, and to ensure alignment. */
+	pxTopOfStack--;
+
+	*pxTopOfStack = portINITIAL_XPSR;	/* xPSR */
+	pxTopOfStack--;
+	*pxTopOfStack = ( ( StackType_t ) pxCode ) & portSTART_ADDRESS_MASK;	/* PC */
+	pxTopOfStack--;
+	*pxTopOfStack = ( StackType_t ) prvTaskExitError;	/* LR */
+
+	/* Save code space by skipping register initialisation. */
+	pxTopOfStack -= 5;	/* R12, R3, R2 and R1. */
+	*pxTopOfStack = ( StackType_t ) pvParameters;	/* R0 */
+
+	/* A save method is being used that requires each task to maintain its
+	own exec return value. */
+	pxTopOfStack--;
+	*pxTopOfStack = portINITIAL_EXEC_RETURN;
+
+	pxTopOfStack -= 8;	/* R11, R10, R9, R8, R7, R6, R5 and R4. */
+
+	return pxTopOfStack;
+}
+/*-----------------------------------------------------------*/
+
+static void prvTaskExitError( void )
+{
+	/* A function that implements a task must not exit or attempt to return to
+	its caller as there is nothing to return to.  If a task wants to exit it
+	should instead call vTaskDelete( NULL ).
+
+	Artificially force an assert() to be triggered if configASSERT() is
+	defined, then stop here so application writers can catch the error. */
+	configASSERT( uxCriticalNesting == ~0UL );
+	portDISABLE_INTERRUPTS();
+	for( ;; );
+}
+/*-----------------------------------------------------------*/
+
+__asm void vPortSVCHandler( void )
+{
+	PRESERVE8
+
+	/* Get the location of the current TCB. */
+	ldr	r3, =pxCurrentTCB
+	ldr r1, [r3]
+	ldr r0, [r1]
+	/* Pop the core registers. */
+	ldmia r0!, {r4-r11, r14}
+	msr psp, r0
+	isb
+	mov r0, #0
+	msr	basepri, r0
+	bx r14
+}
+/*-----------------------------------------------------------*/
+
+__asm void prvStartFirstTask( void )
+{
+	PRESERVE8
+
+	/* Use the NVIC offset register to locate the stack. */
+	ldr r0, =0xE000ED08
+	ldr r0, [r0]
+	ldr r0, [r0]
+	/* Set the msp back to the start of the stack. */
+	msr msp, r0
+	/* Globally enable interrupts. */
+	cpsie i
+	cpsie f
+	dsb
+	isb
+	/* Call SVC to start the first task. */
+	svc 0
+	nop
+	nop
+}
+/*-----------------------------------------------------------*/
+
+__asm void prvEnableVFP( void )
+{
+	PRESERVE8
+
+	/* The FPU enable bits are in the CPACR. */
+	ldr.w r0, =0xE000ED88
+	ldr	r1, [r0]
+
+	/* Enable CP10 and CP11 coprocessors, then save back. */
+	orr	r1, r1, #( 0xf << 20 )
+	str r1, [r0]
+	bx	r14
+	nop
+}
+/*-----------------------------------------------------------*/
+
+/*
+ * See header file for description.
+ */
+BaseType_t xPortStartScheduler( void )
+{
+	#if( configASSERT_DEFINED == 1 )
+	{
+		volatile uint32_t ulOriginalPriority;
+		volatile uint8_t * const pucFirstUserPriorityRegister = ( uint8_t * ) ( portNVIC_IP_REGISTERS_OFFSET_16 + portFIRST_USER_INTERRUPT_NUMBER );
+		volatile uint8_t ucMaxPriorityValue;
+
+		/* Determine the maximum priority from which ISR safe FreeRTOS API
+		functions can be called.  ISR safe functions are those that end in
+		"FromISR".  FreeRTOS maintains separate thread and ISR API functions to
+		ensure interrupt entry is as fast and simple as possible.
+
+		Save the interrupt priority value that is about to be clobbered. */
+		ulOriginalPriority = *pucFirstUserPriorityRegister;
+
+		/* Determine the number of priority bits available.  First write to all
+		possible bits. */
+		*pucFirstUserPriorityRegister = portMAX_8_BIT_VALUE;
+
+		/* Read the value back to see how many bits stuck. */
+		ucMaxPriorityValue = *pucFirstUserPriorityRegister;
+
+		/* The kernel interrupt priority should be set to the lowest
+		priority. */
+		configASSERT( ucMaxPriorityValue == ( configKERNEL_INTERRUPT_PRIORITY & ucMaxPriorityValue ) );
+
+		/* Use the same mask on the maximum system call priority. */
+		ucMaxSysCallPriority = configMAX_SYSCALL_INTERRUPT_PRIORITY & ucMaxPriorityValue;
+
+		/* Calculate the maximum acceptable priority group value for the number
+		of bits read back. */
+		ulMaxPRIGROUPValue = portMAX_PRIGROUP_BITS;
+		while( ( ucMaxPriorityValue & portTOP_BIT_OF_BYTE ) == portTOP_BIT_OF_BYTE )
+		{
+			ulMaxPRIGROUPValue--;
+			ucMaxPriorityValue <<= ( uint8_t ) 0x01;
+		}
+
+		/* Shift the priority group value back to its position within the AIRCR
+		register. */
+		ulMaxPRIGROUPValue <<= portPRIGROUP_SHIFT;
+		ulMaxPRIGROUPValue &= portPRIORITY_GROUP_MASK;
+
+		/* Restore the clobbered interrupt priority register to its original
+		value. */
+		*pucFirstUserPriorityRegister = ulOriginalPriority;
+	}
+	#endif /* conifgASSERT_DEFINED */
+
+	/* Make PendSV and SysTick the lowest priority interrupts. */
+	portNVIC_SYSPRI2_REG |= portNVIC_PENDSV_PRI;
+	portNVIC_SYSPRI2_REG |= portNVIC_SYSTICK_PRI;
+
+	/* Start the timer that generates the tick ISR.  Interrupts are disabled
+	here already. */
+	vPortSetupTimerInterrupt();
+
+	/* Initialise the critical nesting count ready for the first task. */
+	uxCriticalNesting = 0;
+
+	/* Ensure the VFP is enabled - it should be anyway. */
+	prvEnableVFP();
+
+	/* Lazy save always. */
+	*( portFPCCR ) |= portASPEN_AND_LSPEN_BITS;
+
+	/* Start the first task. */
+	prvStartFirstTask();
+
+	/* Should not get here! */
+	return 0;
+}
+/*-----------------------------------------------------------*/
+
+void vPortEndScheduler( void )
+{
+	/* Not implemented in ports where there is nothing to return to.
+	Artificially force an assert. */
+	configASSERT( uxCriticalNesting == 1000UL );
+}
+/*-----------------------------------------------------------*/
+
+void vPortEnterCritical( void )
+{
+	portDISABLE_INTERRUPTS();
+	uxCriticalNesting++;
+
+	/* This is not the interrupt safe version of the enter critical function so
+	assert() if it is being called from an interrupt context.  Only API
+	functions that end in "FromISR" can be used in an interrupt.  Only assert if
+	the critical nesting count is 1 to protect against recursive calls if the
+	assert function also uses a critical section. */
+	if( uxCriticalNesting == 1 )
+	{
+		configASSERT( ( portNVIC_INT_CTRL_REG & portVECTACTIVE_MASK ) == 0 );
+	}
+}
+/*-----------------------------------------------------------*/
+
+void vPortExitCritical( void )
+{
+	configASSERT( uxCriticalNesting );
+	uxCriticalNesting--;
+	if( uxCriticalNesting == 0 )
+	{
+		portENABLE_INTERRUPTS();
+	}
+}
+/*-----------------------------------------------------------*/
+
+__asm void xPortPendSVHandler( void )
+{
+	extern uxCriticalNesting;
+	extern pxCurrentTCB;
+	extern vTaskSwitchContext;
+
+	PRESERVE8
+
+	mrs r0, psp
+	isb
+	/* Get the location of the current TCB. */
+	ldr	r3, =pxCurrentTCB
+	ldr	r2, [r3]
+
+	/* Is the task using the FPU context?  If so, push high vfp registers. */
+	tst r14, #0x10
+	it eq
+	vstmdbeq r0!, {s16-s31}
+
+	/* Save the core registers. */
+	stmdb r0!, {r4-r11, r14}
+
+	/* Save the new top of stack into the first member of the TCB. */
+	str r0, [r2]
+
+	stmdb sp!, {r3}
+	mov r0, #configMAX_SYSCALL_INTERRUPT_PRIORITY
+	cpsid i
+	msr basepri, r0
+	dsb
+	isb
+	cpsie i
+	bl vTaskSwitchContext
+	mov r0, #0
+	msr basepri, r0
+	ldmia sp!, {r3}
+
+	/* The first item in pxCurrentTCB is the task top of stack. */
+	ldr r1, [r3]
+	ldr r0, [r1]
+
+	/* Pop the core registers. */
+	ldmia r0!, {r4-r11, r14}
+
+	/* Is the task using the FPU context?  If so, pop the high vfp registers
+	too. */
+	tst r14, #0x10
+	it eq
+	vldmiaeq r0!, {s16-s31}
+
+	msr psp, r0
+	isb
+	#ifdef WORKAROUND_PMU_CM001 /* XMC4000 specific errata */
+		#if WORKAROUND_PMU_CM001 == 1
+			push { r14 }
+			pop { pc }
+			nop
+		#endif
+	#endif
+
+	bx r14
+}
+/*-----------------------------------------------------------*/
+
+void xPortSysTickHandler( void )
+{
+	/* The SysTick runs at the lowest interrupt priority, so when this interrupt
+	executes all interrupts must be unmasked.  There is therefore no need to
+	save and then restore the interrupt mask value as its value is already
+	known - therefore the slightly faster vPortRaiseBASEPRI() function is used
+	in place of portSET_INTERRUPT_MASK_FROM_ISR(). */
+	vPortRaiseBASEPRI();
+	{
+		/* Increment the RTOS tick. */
+		if( xTaskIncrementTick() != pdFALSE )
+		{
+			/* A context switch is required.  Context switching is performed in
+			the PendSV interrupt.  Pend the PendSV interrupt. */
+			portNVIC_INT_CTRL_REG = portNVIC_PENDSVSET_BIT;
+		}
+	}
+	vPortClearBASEPRIFromISR();
+}
+/*-----------------------------------------------------------*/
+
+#if configUSE_TICKLESS_IDLE == 1
+
+	__weak void vPortSuppressTicksAndSleep( TickType_t xExpectedIdleTime )
+	{
+	uint32_t ulReloadValue, ulCompleteTickPeriods, ulCompletedSysTickDecrements, ulSysTickCTRL;
+	TickType_t xModifiableIdleTime;
+
+		/* Make sure the SysTick reload value does not overflow the counter. */
+		if( xExpectedIdleTime > xMaximumPossibleSuppressedTicks )
+		{
+			xExpectedIdleTime = xMaximumPossibleSuppressedTicks;
+		}
+
+		/* Stop the SysTick momentarily.  The time the SysTick is stopped for
+		is accounted for as best it can be, but using the tickless mode will
+		inevitably result in some tiny drift of the time maintained by the
+		kernel with respect to calendar time. */
+		portNVIC_SYSTICK_CTRL_REG &= ~portNVIC_SYSTICK_ENABLE_BIT;
+
+		/* Calculate the reload value required to wait xExpectedIdleTime
+		tick periods.  -1 is used because this code will execute part way
+		through one of the tick periods. */
+		ulReloadValue = portNVIC_SYSTICK_CURRENT_VALUE_REG + ( ulTimerCountsForOneTick * ( xExpectedIdleTime - 1UL ) );
+		if( ulReloadValue > ulStoppedTimerCompensation )
+		{
+			ulReloadValue -= ulStoppedTimerCompensation;
+		}
+
+		/* Enter a critical section but don't use the taskENTER_CRITICAL()
+		method as that will mask interrupts that should exit sleep mode. */
+		__disable_irq();
+		__dsb( portSY_FULL_READ_WRITE );
+		__isb( portSY_FULL_READ_WRITE );
+
+		/* If a context switch is pending or a task is waiting for the scheduler
+		to be unsuspended then abandon the low power entry. */
+		if( eTaskConfirmSleepModeStatus() == eAbortSleep )
+		{
+			/* Restart from whatever is left in the count register to complete
+			this tick period. */
+			portNVIC_SYSTICK_LOAD_REG = portNVIC_SYSTICK_CURRENT_VALUE_REG;
+
+			/* Restart SysTick. */
+			portNVIC_SYSTICK_CTRL_REG |= portNVIC_SYSTICK_ENABLE_BIT;
+
+			/* Reset the reload register to the value required for normal tick
+			periods. */
+			portNVIC_SYSTICK_LOAD_REG = ulTimerCountsForOneTick - 1UL;
+
+			/* Re-enable interrupts - see comments above __disable_irq() call
+			above. */
+			__enable_irq();
+		}
+		else
+		{
+			/* Set the new reload value. */
+			portNVIC_SYSTICK_LOAD_REG = ulReloadValue;
+
+			/* Clear the SysTick count flag and set the count value back to
+			zero. */
+			portNVIC_SYSTICK_CURRENT_VALUE_REG = 0UL;
+
+			/* Restart SysTick. */
+			portNVIC_SYSTICK_CTRL_REG |= portNVIC_SYSTICK_ENABLE_BIT;
+
+			/* Sleep until something happens.  configPRE_SLEEP_PROCESSING() can
+			set its parameter to 0 to indicate that its implementation contains
+			its own wait for interrupt or wait for event instruction, and so wfi
+			should not be executed again.  However, the original expected idle
+			time variable must remain unmodified, so a copy is taken. */
+			xModifiableIdleTime = xExpectedIdleTime;
+			configPRE_SLEEP_PROCESSING( xModifiableIdleTime );
+			if( xModifiableIdleTime > 0 )
+			{
+				__dsb( portSY_FULL_READ_WRITE );
+				__wfi();
+				__isb( portSY_FULL_READ_WRITE );
+			}
+			configPOST_SLEEP_PROCESSING( xExpectedIdleTime );
+
+			/* Stop SysTick.  Again, the time the SysTick is stopped for is
+			accounted for as best it can be, but using the tickless mode will
+			inevitably result in some tiny drift of the time maintained by the
+			kernel with respect to calendar time. */
+			ulSysTickCTRL = portNVIC_SYSTICK_CTRL_REG;
+			portNVIC_SYSTICK_CTRL_REG = ( ulSysTickCTRL & ~portNVIC_SYSTICK_ENABLE_BIT );
+
+			/* Re-enable interrupts - see comments above __disable_irq() call
+			above. */
+			__enable_irq();
+
+			if( ( ulSysTickCTRL & portNVIC_SYSTICK_COUNT_FLAG_BIT ) != 0 )
+			{
+				uint32_t ulCalculatedLoadValue;
+
+				/* The tick interrupt has already executed, and the SysTick
+				count reloaded with ulReloadValue.  Reset the
+				portNVIC_SYSTICK_LOAD_REG with whatever remains of this tick
+				period. */
+				ulCalculatedLoadValue = ( ulTimerCountsForOneTick - 1UL ) - ( ulReloadValue - portNVIC_SYSTICK_CURRENT_VALUE_REG );
+
+				/* Don't allow a tiny value, or values that have somehow
+				underflowed because the post sleep hook did something
+				that took too long. */
+				if( ( ulCalculatedLoadValue < ulStoppedTimerCompensation ) || ( ulCalculatedLoadValue > ulTimerCountsForOneTick ) )
+				{
+					ulCalculatedLoadValue = ( ulTimerCountsForOneTick - 1UL );
+				}
+
+				portNVIC_SYSTICK_LOAD_REG = ulCalculatedLoadValue;
+
+				/* The tick interrupt handler will already have pended the tick
+				processing in the kernel.  As the pending tick will be
+				processed as soon as this function exits, the tick value
+				maintained by the tick is stepped forward by one less than the
+				time spent waiting. */
+				ulCompleteTickPeriods = xExpectedIdleTime - 1UL;
+			}
+			else
+			{
+				/* Something other than the tick interrupt ended the sleep.
+				Work out how long the sleep lasted rounded to complete tick
+				periods (not the ulReload value which accounted for part
+				ticks). */
+				ulCompletedSysTickDecrements = ( xExpectedIdleTime * ulTimerCountsForOneTick ) - portNVIC_SYSTICK_CURRENT_VALUE_REG;
+
+				/* How many complete tick periods passed while the processor
+				was waiting? */
+				ulCompleteTickPeriods = ulCompletedSysTickDecrements / ulTimerCountsForOneTick;
+
+				/* The reload value is set to whatever fraction of a single tick
+				period remains. */
+				portNVIC_SYSTICK_LOAD_REG = ( ( ulCompleteTickPeriods + 1UL ) * ulTimerCountsForOneTick ) - ulCompletedSysTickDecrements;
+			}
+
+			/* Restart SysTick so it runs from portNVIC_SYSTICK_LOAD_REG
+			again, then set portNVIC_SYSTICK_LOAD_REG back to its standard
+			value.  The critical section is used to ensure the tick interrupt
+			can only execute once in the case that the reload register is near
+			zero. */
+			portNVIC_SYSTICK_CURRENT_VALUE_REG = 0UL;
+			portENTER_CRITICAL();
+			{
+				portNVIC_SYSTICK_CTRL_REG |= portNVIC_SYSTICK_ENABLE_BIT;
+				vTaskStepTick( ulCompleteTickPeriods );
+				portNVIC_SYSTICK_LOAD_REG = ulTimerCountsForOneTick - 1UL;
+			}
+			portEXIT_CRITICAL();
+		}
+	}
+
+#endif /* #if configUSE_TICKLESS_IDLE */
+
+/*-----------------------------------------------------------*/
+
+/*
+ * Setup the SysTick timer to generate the tick interrupts at the required
+ * frequency.
+ */
+#if configOVERRIDE_DEFAULT_TICK_CONFIGURATION == 0
+
+	void vPortSetupTimerInterrupt( void )
+	{
+		/* Calculate the constants required to configure the tick interrupt. */
+		#if configUSE_TICKLESS_IDLE == 1
+		{
+			ulTimerCountsForOneTick = ( configSYSTICK_CLOCK_HZ / configTICK_RATE_HZ );
+			xMaximumPossibleSuppressedTicks = portMAX_24_BIT_NUMBER / ulTimerCountsForOneTick;
+			ulStoppedTimerCompensation = portMISSED_COUNTS_FACTOR / ( configCPU_CLOCK_HZ / configSYSTICK_CLOCK_HZ );
+		}
+		#endif /* configUSE_TICKLESS_IDLE */
+
+		/* Configure SysTick to interrupt at the requested rate. */
+		portNVIC_SYSTICK_LOAD_REG = ( configSYSTICK_CLOCK_HZ / configTICK_RATE_HZ ) - 1UL;
+		portNVIC_SYSTICK_CTRL_REG = ( portNVIC_SYSTICK_CLK_BIT | portNVIC_SYSTICK_INT_BIT | portNVIC_SYSTICK_ENABLE_BIT );
+	}
+
+#endif /* configOVERRIDE_DEFAULT_TICK_CONFIGURATION */
+/*-----------------------------------------------------------*/
+
+__asm uint32_t vPortGetIPSR( void )
+{
+	PRESERVE8
+
+	mrs r0, ipsr
+	bx r14
+}
+/*-----------------------------------------------------------*/
+
+#if( configASSERT_DEFINED == 1 )
+
+	void vPortValidateInterruptPriority( void )
+	{
+	uint32_t ulCurrentInterrupt;
+	uint8_t ucCurrentPriority;
+
+		/* Obtain the number of the currently executing interrupt. */
+		ulCurrentInterrupt = vPortGetIPSR();
+
+		/* Is the interrupt number a user defined interrupt? */
+		if( ulCurrentInterrupt >= portFIRST_USER_INTERRUPT_NUMBER )
+		{
+			/* Look up the interrupt's priority. */
+			ucCurrentPriority = pcInterruptPriorityRegisters[ ulCurrentInterrupt ];
+
+			/* The following assertion will fail if a service routine (ISR) for
+			an interrupt that has been assigned a priority above
+			configMAX_SYSCALL_INTERRUPT_PRIORITY calls an ISR safe FreeRTOS API
+			function.  ISR safe FreeRTOS API functions must *only* be called
+			from interrupts that have been assigned a priority at or below
+			configMAX_SYSCALL_INTERRUPT_PRIORITY.
+
+			Numerically low interrupt priority numbers represent logically high
+			interrupt priorities, therefore the priority of the interrupt must
+			be set to a value equal to or numerically *higher* than
+			configMAX_SYSCALL_INTERRUPT_PRIORITY.
+
+			Interrupts that	use the FreeRTOS API must not be left at their
+			default priority of	zero as that is the highest possible priority,
+			which is guaranteed to be above configMAX_SYSCALL_INTERRUPT_PRIORITY,
+			and	therefore also guaranteed to be invalid.
+
+			FreeRTOS maintains separate thread and ISR API functions to ensure
+			interrupt entry is as fast and simple as possible.
+
+			The following links provide detailed information:
+			http://www.freertos.org/RTOS-Cortex-M3-M4.html
+			http://www.freertos.org/FAQHelp.html */
+			configASSERT( ucCurrentPriority >= ucMaxSysCallPriority );
+		}
+
+		/* Priority grouping:  The interrupt controller (NVIC) allows the bits
+		that define each interrupt's priority to be split between bits that
+		define the interrupt's pre-emption priority bits and bits that define
+		the interrupt's sub-priority.  For simplicity all bits must be defined
+		to be pre-emption priority bits.  The following assertion will fail if
+		this is not the case (if some bits represent a sub-priority).
+
+		If the application only uses CMSIS libraries for interrupt
+		configuration then the correct setting can be achieved on all Cortex-M
+		devices by calling NVIC_SetPriorityGrouping( 0 ); before starting the
+		scheduler.  Note however that some vendor specific peripheral libraries
+		assume a non-zero priority group setting, in which cases using a value
+		of zero will result in unpredicable behaviour. */
+		configASSERT( ( portAIRCR_REG & portPRIORITY_GROUP_MASK ) <= ulMaxPRIGROUPValue );
+	}
+
+#endif /* configASSERT_DEFINED */
+
+
diff --git a/FreeRTOS/portable/RVDS/ARM_CM7/r0p1/portmacro.h b/FreeRTOS/portable/RVDS/ARM_CM7/r0p1/portmacro.h
new file mode 100644
index 0000000..e621353
--- /dev/null
+++ b/FreeRTOS/portable/RVDS/ARM_CM7/r0p1/portmacro.h
@@ -0,0 +1,298 @@
+/*
+    FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd.
+    All rights reserved
+
+    VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION.
+
+    This file is part of the FreeRTOS distribution.
+
+    FreeRTOS is free software; you can redistribute it and/or modify it under
+    the terms of the GNU General Public License (version 2) as published by the
+    Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception.
+
+    ***************************************************************************
+    >>!   NOTE: The modification to the GPL is included to allow you to     !<<
+    >>!   distribute a combined work that includes FreeRTOS without being   !<<
+    >>!   obliged to provide the source code for proprietary components     !<<
+    >>!   outside of the FreeRTOS kernel.                                   !<<
+    ***************************************************************************
+
+    FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY
+    WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+    FOR A PARTICULAR PURPOSE.  Full license text is available on the following
+    link: http://www.freertos.org/a00114.html
+
+    ***************************************************************************
+     *                                                                       *
+     *    FreeRTOS provides completely free yet professionally developed,    *
+     *    robust, strictly quality controlled, supported, and cross          *
+     *    platform software that is more than just the market leader, it     *
+     *    is the industry's de facto standard.                               *
+     *                                                                       *
+     *    Help yourself get started quickly while simultaneously helping     *
+     *    to support the FreeRTOS project by purchasing a FreeRTOS           *
+     *    tutorial book, reference manual, or both:                          *
+     *    http://www.FreeRTOS.org/Documentation                              *
+     *                                                                       *
+    ***************************************************************************
+
+    http://www.FreeRTOS.org/FAQHelp.html - Having a problem?  Start by reading
+    the FAQ page "My application does not run, what could be wrong?".  Have you
+    defined configASSERT()?
+
+    http://www.FreeRTOS.org/support - In return for receiving this top quality
+    embedded software for free we request you assist our global community by
+    participating in the support forum.
+
+    http://www.FreeRTOS.org/training - Investing in training allows your team to
+    be as productive as possible as early as possible.  Now you can receive
+    FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers
+    Ltd, and the world's leading authority on the world's leading RTOS.
+
+    http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products,
+    including FreeRTOS+Trace - an indispensable productivity tool, a DOS
+    compatible FAT file system, and our tiny thread aware UDP/IP stack.
+
+    http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate.
+    Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS.
+
+    http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High
+    Integrity Systems ltd. to sell under the OpenRTOS brand.  Low cost OpenRTOS
+    licenses offer ticketed support, indemnification and commercial middleware.
+
+    http://www.SafeRTOS.com - High Integrity Systems also provide a safety
+    engineered and independently SIL3 certified version for use in safety and
+    mission critical applications that require provable dependability.
+
+    1 tab == 4 spaces!
+*/
+
+
+#ifndef PORTMACRO_H
+#define PORTMACRO_H
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/*-----------------------------------------------------------
+ * Port specific definitions.
+ *
+ * The settings in this file configure FreeRTOS correctly for the
+ * given hardware and compiler.
+ *
+ * These settings should not be altered.
+ *-----------------------------------------------------------
+ */
+
+/* Type definitions. */
+#define portCHAR		char
+#define portFLOAT		float
+#define portDOUBLE		double
+#define portLONG		long
+#define portSHORT		short
+#define portSTACK_TYPE	uint32_t
+#define portBASE_TYPE	long
+
+typedef portSTACK_TYPE StackType_t;
+typedef long BaseType_t;
+typedef unsigned long UBaseType_t;
+
+#if( configUSE_16_BIT_TICKS == 1 )
+	typedef uint16_t TickType_t;
+	#define portMAX_DELAY ( TickType_t ) 0xffff
+#else
+	typedef uint32_t TickType_t;
+	#define portMAX_DELAY ( TickType_t ) 0xffffffffUL
+
+	/* 32-bit tick type on a 32-bit architecture, so reads of the tick count do
+	not need to be guarded with a critical section. */
+	#define portTICK_TYPE_IS_ATOMIC 1
+#endif
+/*-----------------------------------------------------------*/
+
+/* Architecture specifics. */
+#define portSTACK_GROWTH			( -1 )
+#define portTICK_PERIOD_MS			( ( TickType_t ) 1000 / configTICK_RATE_HZ )
+#define portBYTE_ALIGNMENT			8
+
+/* Constants used with memory barrier intrinsics. */
+#define portSY_FULL_READ_WRITE		( 15 )
+
+/*-----------------------------------------------------------*/
+
+/* Scheduler utilities. */
+#define portYIELD()																\
+{																				\
+	/* Set a PendSV to request a context switch. */								\
+	portNVIC_INT_CTRL_REG = portNVIC_PENDSVSET_BIT;								\
+																				\
+	/* Barriers are normally not required but do ensure the code is completely	\
+	within the specified behaviour for the architecture. */						\
+	__dsb( portSY_FULL_READ_WRITE );											\
+	__isb( portSY_FULL_READ_WRITE );											\
+}
+/*-----------------------------------------------------------*/
+
+#define portNVIC_INT_CTRL_REG		( * ( ( volatile uint32_t * ) 0xe000ed04 ) )
+#define portNVIC_PENDSVSET_BIT		( 1UL << 28UL )
+#define portEND_SWITCHING_ISR( xSwitchRequired ) if( xSwitchRequired != pdFALSE ) portYIELD()
+#define portYIELD_FROM_ISR( x ) portEND_SWITCHING_ISR( x )
+/*-----------------------------------------------------------*/
+
+/* Critical section management. */
+extern void vPortEnterCritical( void );
+extern void vPortExitCritical( void );
+
+#define portDISABLE_INTERRUPTS()				vPortRaiseBASEPRI()
+#define portENABLE_INTERRUPTS()					vPortSetBASEPRI( 0 )
+#define portENTER_CRITICAL()					vPortEnterCritical()
+#define portEXIT_CRITICAL()						vPortExitCritical()
+#define portSET_INTERRUPT_MASK_FROM_ISR()		ulPortRaiseBASEPRI()
+#define portCLEAR_INTERRUPT_MASK_FROM_ISR( x )	vPortSetBASEPRI( x )
+
+/*-----------------------------------------------------------*/
+
+/* Tickless idle/low power functionality. */
+#ifndef portSUPPRESS_TICKS_AND_SLEEP
+	extern void vPortSuppressTicksAndSleep( TickType_t xExpectedIdleTime );
+	#define portSUPPRESS_TICKS_AND_SLEEP( xExpectedIdleTime ) vPortSuppressTicksAndSleep( xExpectedIdleTime )
+#endif
+/*-----------------------------------------------------------*/
+
+/* Port specific optimisations. */
+#ifndef configUSE_PORT_OPTIMISED_TASK_SELECTION
+	#define configUSE_PORT_OPTIMISED_TASK_SELECTION 1
+#endif
+
+#if configUSE_PORT_OPTIMISED_TASK_SELECTION == 1
+
+	/* Check the configuration. */
+	#if( configMAX_PRIORITIES > 32 )
+		#error configUSE_PORT_OPTIMISED_TASK_SELECTION can only be set to 1 when configMAX_PRIORITIES is less than or equal to 32.  It is very rare that a system requires more than 10 to 15 difference priorities as tasks that share a priority will time slice.
+	#endif
+
+	/* Store/clear the ready priorities in a bit map. */
+	#define portRECORD_READY_PRIORITY( uxPriority, uxReadyPriorities ) ( uxReadyPriorities ) |= ( 1UL << ( uxPriority ) )
+	#define portRESET_READY_PRIORITY( uxPriority, uxReadyPriorities ) ( uxReadyPriorities ) &= ~( 1UL << ( uxPriority ) )
+
+	/*-----------------------------------------------------------*/
+
+	#define portGET_HIGHEST_PRIORITY( uxTopPriority, uxReadyPriorities ) uxTopPriority = ( 31UL - ( uint32_t ) __clz( ( uxReadyPriorities ) ) )
+
+#endif /* taskRECORD_READY_PRIORITY */
+/*-----------------------------------------------------------*/
+
+/* Task function macros as described on the FreeRTOS.org WEB site.  These are
+not necessary for to use this port.  They are defined so the common demo files
+(which build with all the ports) will build. */
+#define portTASK_FUNCTION_PROTO( vFunction, pvParameters ) void vFunction( void *pvParameters )
+#define portTASK_FUNCTION( vFunction, pvParameters ) void vFunction( void *pvParameters )
+/*-----------------------------------------------------------*/
+
+#ifdef configASSERT
+	void vPortValidateInterruptPriority( void );
+	#define portASSERT_IF_INTERRUPT_PRIORITY_INVALID() 	vPortValidateInterruptPriority()
+#endif
+
+/* portNOP() is not required by this port. */
+#define portNOP()
+
+#define portINLINE __inline
+
+#ifndef portFORCE_INLINE
+	#define portFORCE_INLINE __forceinline
+#endif
+
+/*-----------------------------------------------------------*/
+
+static portFORCE_INLINE void vPortSetBASEPRI( uint32_t ulBASEPRI )
+{
+	__asm
+	{
+		/* Barrier instructions are not used as this function is only used to
+		lower the BASEPRI value. */
+		msr basepri, ulBASEPRI
+	}
+}
+/*-----------------------------------------------------------*/
+
+static portFORCE_INLINE void vPortRaiseBASEPRI( void )
+{
+uint32_t ulNewBASEPRI = configMAX_SYSCALL_INTERRUPT_PRIORITY;
+
+	__asm
+	{
+		/* Set BASEPRI to the max syscall priority to effect a critical
+		section. */
+		cpsid i
+		msr basepri, ulNewBASEPRI
+		dsb
+		isb
+		cpsie i
+	}
+}
+/*-----------------------------------------------------------*/
+
+static portFORCE_INLINE void vPortClearBASEPRIFromISR( void )
+{
+	__asm
+	{
+		/* Set BASEPRI to 0 so no interrupts are masked.  This function is only
+		used to lower the mask in an interrupt, so memory barriers are not 
+		used. */
+		msr basepri, #0
+	}
+}
+/*-----------------------------------------------------------*/
+
+static portFORCE_INLINE uint32_t ulPortRaiseBASEPRI( void )
+{
+uint32_t ulReturn, ulNewBASEPRI = configMAX_SYSCALL_INTERRUPT_PRIORITY;
+
+	__asm
+	{
+		/* Set BASEPRI to the max syscall priority to effect a critical
+		section. */
+		mrs ulReturn, basepri
+		cpsid i
+		msr basepri, ulNewBASEPRI
+		dsb
+		isb
+		cpsie i
+	}
+
+	return ulReturn;
+}
+/*-----------------------------------------------------------*/
+
+static portFORCE_INLINE BaseType_t xPortIsInsideInterrupt( void )
+{
+uint32_t ulCurrentInterrupt;
+BaseType_t xReturn;
+
+	/* Obtain the number of the currently executing interrupt. */
+	__asm
+	{
+		mrs ulCurrentInterrupt, ipsr
+	}
+
+	if( ulCurrentInterrupt == 0 )
+	{
+		xReturn = pdFALSE;
+	}
+	else
+	{
+		xReturn = pdTRUE;
+	}
+
+	return xReturn;
+}
+
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* PORTMACRO_H */
+
diff --git a/FreeRTOS/portable/readme.txt b/FreeRTOS/portable/readme.txt
new file mode 100644
index 0000000..b68d2d5
--- /dev/null
+++ b/FreeRTOS/portable/readme.txt
@@ -0,0 +1,20 @@
+Each real time kernel port consists of three files that contain the core kernel
+components and are common to every port, and one or more files that are
+specific to a particular microcontroller and/or compiler.
+
+
++ The FreeRTOS/Source/Portable/MemMang directory contains the five sample
+memory allocators as described on the http://www.FreeRTOS.org WEB site.
+
++ The other directories each contain files specific to a particular
+microcontroller or compiler, where the directory name denotes the compiler
+specific files the directory contains.
+
+
+
+For example, if you are interested in the [compiler] port for the [architecture]
+microcontroller, then the port specific files are contained in
+FreeRTOS/Source/Portable/[compiler]/[architecture] directory.  If this is the
+only port you are interested in then all the other directories can be
+ignored.
+
diff --git a/FreeRTOS/queue.c b/FreeRTOS/queue.c
new file mode 100644
index 0000000..ce623be
--- /dev/null
+++ b/FreeRTOS/queue.c
@@ -0,0 +1,2566 @@
+/*
+    FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd.
+    All rights reserved
+
+    VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION.
+
+    This file is part of the FreeRTOS distribution.
+
+    FreeRTOS is free software; you can redistribute it and/or modify it under
+    the terms of the GNU General Public License (version 2) as published by the
+    Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception.
+
+    ***************************************************************************
+    >>!   NOTE: The modification to the GPL is included to allow you to     !<<
+    >>!   distribute a combined work that includes FreeRTOS without being   !<<
+    >>!   obliged to provide the source code for proprietary components     !<<
+    >>!   outside of the FreeRTOS kernel.                                   !<<
+    ***************************************************************************
+
+    FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY
+    WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+    FOR A PARTICULAR PURPOSE.  Full license text is available on the following
+    link: http://www.freertos.org/a00114.html
+
+    ***************************************************************************
+     *                                                                       *
+     *    FreeRTOS provides completely free yet professionally developed,    *
+     *    robust, strictly quality controlled, supported, and cross          *
+     *    platform software that is more than just the market leader, it     *
+     *    is the industry's de facto standard.                               *
+     *                                                                       *
+     *    Help yourself get started quickly while simultaneously helping     *
+     *    to support the FreeRTOS project by purchasing a FreeRTOS           *
+     *    tutorial book, reference manual, or both:                          *
+     *    http://www.FreeRTOS.org/Documentation                              *
+     *                                                                       *
+    ***************************************************************************
+
+    http://www.FreeRTOS.org/FAQHelp.html - Having a problem?  Start by reading
+    the FAQ page "My application does not run, what could be wrong?".  Have you
+    defined configASSERT()?
+
+    http://www.FreeRTOS.org/support - In return for receiving this top quality
+    embedded software for free we request you assist our global community by
+    participating in the support forum.
+
+    http://www.FreeRTOS.org/training - Investing in training allows your team to
+    be as productive as possible as early as possible.  Now you can receive
+    FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers
+    Ltd, and the world's leading authority on the world's leading RTOS.
+
+    http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products,
+    including FreeRTOS+Trace - an indispensable productivity tool, a DOS
+    compatible FAT file system, and our tiny thread aware UDP/IP stack.
+
+    http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate.
+    Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS.
+
+    http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High
+    Integrity Systems ltd. to sell under the OpenRTOS brand.  Low cost OpenRTOS
+    licenses offer ticketed support, indemnification and commercial middleware.
+
+    http://www.SafeRTOS.com - High Integrity Systems also provide a safety
+    engineered and independently SIL3 certified version for use in safety and
+    mission critical applications that require provable dependability.
+
+    1 tab == 4 spaces!
+*/
+
+#include 
+#include 
+
+/* Defining MPU_WRAPPERS_INCLUDED_FROM_API_FILE prevents task.h from redefining
+all the API functions to use the MPU wrappers.  That should only be done when
+task.h is included from an application file. */
+#define MPU_WRAPPERS_INCLUDED_FROM_API_FILE
+
+#include "FreeRTOS.h"
+#include "task.h"
+#include "queue.h"
+
+#if ( configUSE_CO_ROUTINES == 1 )
+	#include "croutine.h"
+#endif
+
+/* Lint e961 and e750 are suppressed as a MISRA exception justified because the
+MPU ports require MPU_WRAPPERS_INCLUDED_FROM_API_FILE to be defined for the
+header files above, but not in this file, in order to generate the correct
+privileged Vs unprivileged linkage and placement. */
+#undef MPU_WRAPPERS_INCLUDED_FROM_API_FILE /*lint !e961 !e750. */
+
+
+/* Constants used with the cRxLock and cTxLock structure members. */
+#define queueUNLOCKED					( ( int8_t ) -1 )
+#define queueLOCKED_UNMODIFIED			( ( int8_t ) 0 )
+
+/* When the Queue_t structure is used to represent a base queue its pcHead and
+pcTail members are used as pointers into the queue storage area.  When the
+Queue_t structure is used to represent a mutex pcHead and pcTail pointers are
+not necessary, and the pcHead pointer is set to NULL to indicate that the
+pcTail pointer actually points to the mutex holder (if any).  Map alternative
+names to the pcHead and pcTail structure members to ensure the readability of
+the code is maintained despite this dual use of two structure members.  An
+alternative implementation would be to use a union, but use of a union is
+against the coding standard (although an exception to the standard has been
+permitted where the dual use also significantly changes the type of the
+structure member). */
+#define pxMutexHolder					pcTail
+#define uxQueueType						pcHead
+#define queueQUEUE_IS_MUTEX				NULL
+
+/* Semaphores do not actually store or copy data, so have an item size of
+zero. */
+#define queueSEMAPHORE_QUEUE_ITEM_LENGTH ( ( UBaseType_t ) 0 )
+#define queueMUTEX_GIVE_BLOCK_TIME		 ( ( TickType_t ) 0U )
+
+#if( configUSE_PREEMPTION == 0 )
+	/* If the cooperative scheduler is being used then a yield should not be
+	performed just because a higher priority task has been woken. */
+	#define queueYIELD_IF_USING_PREEMPTION()
+#else
+	#define queueYIELD_IF_USING_PREEMPTION() portYIELD_WITHIN_API()
+#endif
+
+/*
+ * Definition of the queue used by the scheduler.
+ * Items are queued by copy, not reference.  See the following link for the
+ * rationale: http://www.freertos.org/Embedded-RTOS-Queues.html
+ */
+typedef struct QueueDefinition
+{
+	int8_t *pcHead;					/*< Points to the beginning of the queue storage area. */
+	int8_t *pcTail;					/*< Points to the byte at the end of the queue storage area.  Once more byte is allocated than necessary to store the queue items, this is used as a marker. */
+	int8_t *pcWriteTo;				/*< Points to the free next place in the storage area. */
+
+	union							/* Use of a union is an exception to the coding standard to ensure two mutually exclusive structure members don't appear simultaneously (wasting RAM). */
+	{
+		int8_t *pcReadFrom;			/*< Points to the last place that a queued item was read from when the structure is used as a queue. */
+		UBaseType_t uxRecursiveCallCount;/*< Maintains a count of the number of times a recursive mutex has been recursively 'taken' when the structure is used as a mutex. */
+	} u;
+
+	List_t xTasksWaitingToSend;		/*< List of tasks that are blocked waiting to post onto this queue.  Stored in priority order. */
+	List_t xTasksWaitingToReceive;	/*< List of tasks that are blocked waiting to read from this queue.  Stored in priority order. */
+
+	volatile UBaseType_t uxMessagesWaiting;/*< The number of items currently in the queue. */
+	UBaseType_t uxLength;			/*< The length of the queue defined as the number of items it will hold, not the number of bytes. */
+	UBaseType_t uxItemSize;			/*< The size of each items that the queue will hold. */
+
+	volatile int8_t cRxLock;		/*< Stores the number of items received from the queue (removed from the queue) while the queue was locked.  Set to queueUNLOCKED when the queue is not locked. */
+	volatile int8_t cTxLock;		/*< Stores the number of items transmitted to the queue (added to the queue) while the queue was locked.  Set to queueUNLOCKED when the queue is not locked. */
+
+	#if( ( configSUPPORT_STATIC_ALLOCATION == 1 ) && ( configSUPPORT_DYNAMIC_ALLOCATION == 1 ) )
+		uint8_t ucStaticallyAllocated;	/*< Set to pdTRUE if the memory used by the queue was statically allocated to ensure no attempt is made to free the memory. */
+	#endif
+
+	#if ( configUSE_QUEUE_SETS == 1 )
+		struct QueueDefinition *pxQueueSetContainer;
+	#endif
+
+	#if ( configUSE_TRACE_FACILITY == 1 )
+		UBaseType_t uxQueueNumber;
+		uint8_t ucQueueType;
+	#endif
+
+} xQUEUE;
+
+/* The old xQUEUE name is maintained above then typedefed to the new Queue_t
+name below to enable the use of older kernel aware debuggers. */
+typedef xQUEUE Queue_t;
+
+/*-----------------------------------------------------------*/
+
+/*
+ * The queue registry is just a means for kernel aware debuggers to locate
+ * queue structures.  It has no other purpose so is an optional component.
+ */
+#if ( configQUEUE_REGISTRY_SIZE > 0 )
+
+	/* The type stored within the queue registry array.  This allows a name
+	to be assigned to each queue making kernel aware debugging a little
+	more user friendly. */
+	typedef struct QUEUE_REGISTRY_ITEM
+	{
+		const char *pcQueueName; /*lint !e971 Unqualified char types are allowed for strings and single characters only. */
+		QueueHandle_t xHandle;
+	} xQueueRegistryItem;
+
+	/* The old xQueueRegistryItem name is maintained above then typedefed to the
+	new xQueueRegistryItem name below to enable the use of older kernel aware
+	debuggers. */
+	typedef xQueueRegistryItem QueueRegistryItem_t;
+
+	/* The queue registry is simply an array of QueueRegistryItem_t structures.
+	The pcQueueName member of a structure being NULL is indicative of the
+	array position being vacant. */
+	PRIVILEGED_DATA QueueRegistryItem_t xQueueRegistry[ configQUEUE_REGISTRY_SIZE ];
+
+#endif /* configQUEUE_REGISTRY_SIZE */
+
+/*
+ * Unlocks a queue locked by a call to prvLockQueue.  Locking a queue does not
+ * prevent an ISR from adding or removing items to the queue, but does prevent
+ * an ISR from removing tasks from the queue event lists.  If an ISR finds a
+ * queue is locked it will instead increment the appropriate queue lock count
+ * to indicate that a task may require unblocking.  When the queue in unlocked
+ * these lock counts are inspected, and the appropriate action taken.
+ */
+static void prvUnlockQueue( Queue_t * const pxQueue ) PRIVILEGED_FUNCTION;
+
+/*
+ * Uses a critical section to determine if there is any data in a queue.
+ *
+ * @return pdTRUE if the queue contains no items, otherwise pdFALSE.
+ */
+static BaseType_t prvIsQueueEmpty( const Queue_t *pxQueue ) PRIVILEGED_FUNCTION;
+
+/*
+ * Uses a critical section to determine if there is any space in a queue.
+ *
+ * @return pdTRUE if there is no space, otherwise pdFALSE;
+ */
+static BaseType_t prvIsQueueFull( const Queue_t *pxQueue ) PRIVILEGED_FUNCTION;
+
+/*
+ * Copies an item into the queue, either at the front of the queue or the
+ * back of the queue.
+ */
+static BaseType_t prvCopyDataToQueue( Queue_t * const pxQueue, const void *pvItemToQueue, const BaseType_t xPosition ) PRIVILEGED_FUNCTION;
+
+/*
+ * Copies an item out of a queue.
+ */
+static void prvCopyDataFromQueue( Queue_t * const pxQueue, void * const pvBuffer ) PRIVILEGED_FUNCTION;
+
+#if ( configUSE_QUEUE_SETS == 1 )
+	/*
+	 * Checks to see if a queue is a member of a queue set, and if so, notifies
+	 * the queue set that the queue contains data.
+	 */
+	static BaseType_t prvNotifyQueueSetContainer( const Queue_t * const pxQueue, const BaseType_t xCopyPosition ) PRIVILEGED_FUNCTION;
+#endif
+
+/*
+ * Called after a Queue_t structure has been allocated either statically or
+ * dynamically to fill in the structure's members.
+ */
+static void prvInitialiseNewQueue( const UBaseType_t uxQueueLength, const UBaseType_t uxItemSize, uint8_t *pucQueueStorage, const uint8_t ucQueueType, Queue_t *pxNewQueue ) PRIVILEGED_FUNCTION;
+
+/*
+ * Mutexes are a special type of queue.  When a mutex is created, first the
+ * queue is created, then prvInitialiseMutex() is called to configure the queue
+ * as a mutex.
+ */
+#if( configUSE_MUTEXES == 1 )
+	static void prvInitialiseMutex( Queue_t *pxNewQueue ) PRIVILEGED_FUNCTION;
+#endif
+
+/*-----------------------------------------------------------*/
+
+/*
+ * Macro to mark a queue as locked.  Locking a queue prevents an ISR from
+ * accessing the queue event lists.
+ */
+#define prvLockQueue( pxQueue )								\
+	taskENTER_CRITICAL();									\
+	{														\
+		if( ( pxQueue )->cRxLock == queueUNLOCKED )			\
+		{													\
+			( pxQueue )->cRxLock = queueLOCKED_UNMODIFIED;	\
+		}													\
+		if( ( pxQueue )->cTxLock == queueUNLOCKED )			\
+		{													\
+			( pxQueue )->cTxLock = queueLOCKED_UNMODIFIED;	\
+		}													\
+	}														\
+	taskEXIT_CRITICAL()
+/*-----------------------------------------------------------*/
+
+BaseType_t xQueueGenericReset( QueueHandle_t xQueue, BaseType_t xNewQueue )
+{
+Queue_t * const pxQueue = ( Queue_t * ) xQueue;
+
+	configASSERT( pxQueue );
+
+	taskENTER_CRITICAL();
+	{
+		pxQueue->pcTail = pxQueue->pcHead + ( pxQueue->uxLength * pxQueue->uxItemSize );
+		pxQueue->uxMessagesWaiting = ( UBaseType_t ) 0U;
+		pxQueue->pcWriteTo = pxQueue->pcHead;
+		pxQueue->u.pcReadFrom = pxQueue->pcHead + ( ( pxQueue->uxLength - ( UBaseType_t ) 1U ) * pxQueue->uxItemSize );
+		pxQueue->cRxLock = queueUNLOCKED;
+		pxQueue->cTxLock = queueUNLOCKED;
+
+		if( xNewQueue == pdFALSE )
+		{
+			/* If there are tasks blocked waiting to read from the queue, then
+			the tasks will remain blocked as after this function exits the queue
+			will still be empty.  If there are tasks blocked waiting to write to
+			the queue, then one should be unblocked as after this function exits
+			it will be possible to write to it. */
+			if( listLIST_IS_EMPTY( &( pxQueue->xTasksWaitingToSend ) ) == pdFALSE )
+			{
+				if( xTaskRemoveFromEventList( &( pxQueue->xTasksWaitingToSend ) ) != pdFALSE )
+				{
+					queueYIELD_IF_USING_PREEMPTION();
+				}
+				else
+				{
+					mtCOVERAGE_TEST_MARKER();
+				}
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+		}
+		else
+		{
+			/* Ensure the event queues start in the correct state. */
+			vListInitialise( &( pxQueue->xTasksWaitingToSend ) );
+			vListInitialise( &( pxQueue->xTasksWaitingToReceive ) );
+		}
+	}
+	taskEXIT_CRITICAL();
+
+	/* A value is returned for calling semantic consistency with previous
+	versions. */
+	return pdPASS;
+}
+/*-----------------------------------------------------------*/
+
+#if( configSUPPORT_STATIC_ALLOCATION == 1 )
+
+	QueueHandle_t xQueueGenericCreateStatic( const UBaseType_t uxQueueLength, const UBaseType_t uxItemSize, uint8_t *pucQueueStorage, StaticQueue_t *pxStaticQueue, const uint8_t ucQueueType )
+	{
+	Queue_t *pxNewQueue;
+
+		configASSERT( uxQueueLength > ( UBaseType_t ) 0 );
+
+		/* The StaticQueue_t structure and the queue storage area must be
+		supplied. */
+		configASSERT( pxStaticQueue != NULL );
+
+		/* A queue storage area should be provided if the item size is not 0, and
+		should not be provided if the item size is 0. */
+		configASSERT( !( ( pucQueueStorage != NULL ) && ( uxItemSize == 0 ) ) );
+		configASSERT( !( ( pucQueueStorage == NULL ) && ( uxItemSize != 0 ) ) );
+
+		#if( configASSERT_DEFINED == 1 )
+		{
+			/* Sanity check that the size of the structure used to declare a
+			variable of type StaticQueue_t or StaticSemaphore_t equals the size of
+			the real queue and semaphore structures. */
+			volatile size_t xSize = sizeof( StaticQueue_t );
+			configASSERT( xSize == sizeof( Queue_t ) );
+		}
+		#endif /* configASSERT_DEFINED */
+
+		/* The address of a statically allocated queue was passed in, use it.
+		The address of a statically allocated storage area was also passed in
+		but is already set. */
+		pxNewQueue = ( Queue_t * ) pxStaticQueue; /*lint !e740 Unusual cast is ok as the structures are designed to have the same alignment, and the size is checked by an assert. */
+
+		if( pxNewQueue != NULL )
+		{
+			#if( configSUPPORT_DYNAMIC_ALLOCATION == 1 )
+			{
+				/* Queues can be allocated wither statically or dynamically, so
+				note this queue was allocated statically in case the queue is
+				later deleted. */
+				pxNewQueue->ucStaticallyAllocated = pdTRUE;
+			}
+			#endif /* configSUPPORT_DYNAMIC_ALLOCATION */
+
+			prvInitialiseNewQueue( uxQueueLength, uxItemSize, pucQueueStorage, ucQueueType, pxNewQueue );
+		}
+
+		return pxNewQueue;
+	}
+
+#endif /* configSUPPORT_STATIC_ALLOCATION */
+/*-----------------------------------------------------------*/
+
+#if( configSUPPORT_DYNAMIC_ALLOCATION == 1 )
+
+	QueueHandle_t xQueueGenericCreate( const UBaseType_t uxQueueLength, const UBaseType_t uxItemSize, const uint8_t ucQueueType )
+	{
+	Queue_t *pxNewQueue;
+	size_t xQueueSizeInBytes;
+	uint8_t *pucQueueStorage;
+
+		configASSERT( uxQueueLength > ( UBaseType_t ) 0 );
+
+		if( uxItemSize == ( UBaseType_t ) 0 )
+		{
+			/* There is not going to be a queue storage area. */
+			xQueueSizeInBytes = ( size_t ) 0;
+		}
+		else
+		{
+			/* Allocate enough space to hold the maximum number of items that
+			can be in the queue at any time. */
+			xQueueSizeInBytes = ( size_t ) ( uxQueueLength * uxItemSize ); /*lint !e961 MISRA exception as the casts are only redundant for some ports. */
+		}
+
+		pxNewQueue = ( Queue_t * ) pvPortMalloc( sizeof( Queue_t ) + xQueueSizeInBytes );
+
+		if( pxNewQueue != NULL )
+		{
+			/* Jump past the queue structure to find the location of the queue
+			storage area. */
+			pucQueueStorage = ( ( uint8_t * ) pxNewQueue ) + sizeof( Queue_t );
+
+			#if( configSUPPORT_STATIC_ALLOCATION == 1 )
+			{
+				/* Queues can be created either statically or dynamically, so
+				note this task was created dynamically in case it is later
+				deleted. */
+				pxNewQueue->ucStaticallyAllocated = pdFALSE;
+			}
+			#endif /* configSUPPORT_STATIC_ALLOCATION */
+
+			prvInitialiseNewQueue( uxQueueLength, uxItemSize, pucQueueStorage, ucQueueType, pxNewQueue );
+		}
+
+		return pxNewQueue;
+	}
+
+#endif /* configSUPPORT_STATIC_ALLOCATION */
+/*-----------------------------------------------------------*/
+
+static void prvInitialiseNewQueue( const UBaseType_t uxQueueLength, const UBaseType_t uxItemSize, uint8_t *pucQueueStorage, const uint8_t ucQueueType, Queue_t *pxNewQueue )
+{
+	/* Remove compiler warnings about unused parameters should
+	configUSE_TRACE_FACILITY not be set to 1. */
+	( void ) ucQueueType;
+
+	if( uxItemSize == ( UBaseType_t ) 0 )
+	{
+		/* No RAM was allocated for the queue storage area, but PC head cannot
+		be set to NULL because NULL is used as a key to say the queue is used as
+		a mutex.  Therefore just set pcHead to point to the queue as a benign
+		value that is known to be within the memory map. */
+		pxNewQueue->pcHead = ( int8_t * ) pxNewQueue;
+	}
+	else
+	{
+		/* Set the head to the start of the queue storage area. */
+		pxNewQueue->pcHead = ( int8_t * ) pucQueueStorage;
+	}
+
+	/* Initialise the queue members as described where the queue type is
+	defined. */
+	pxNewQueue->uxLength = uxQueueLength;
+	pxNewQueue->uxItemSize = uxItemSize;
+	( void ) xQueueGenericReset( pxNewQueue, pdTRUE );
+
+	#if ( configUSE_TRACE_FACILITY == 1 )
+	{
+		pxNewQueue->ucQueueType = ucQueueType;
+	}
+	#endif /* configUSE_TRACE_FACILITY */
+
+	#if( configUSE_QUEUE_SETS == 1 )
+	{
+		pxNewQueue->pxQueueSetContainer = NULL;
+	}
+	#endif /* configUSE_QUEUE_SETS */
+
+	traceQUEUE_CREATE( pxNewQueue );
+}
+/*-----------------------------------------------------------*/
+
+#if( configUSE_MUTEXES == 1 )
+
+	static void prvInitialiseMutex( Queue_t *pxNewQueue )
+	{
+		if( pxNewQueue != NULL )
+		{
+			/* The queue create function will set all the queue structure members
+			correctly for a generic queue, but this function is creating a
+			mutex.  Overwrite those members that need to be set differently -
+			in particular the information required for priority inheritance. */
+			pxNewQueue->pxMutexHolder = NULL;
+			pxNewQueue->uxQueueType = queueQUEUE_IS_MUTEX;
+
+			/* In case this is a recursive mutex. */
+			pxNewQueue->u.uxRecursiveCallCount = 0;
+
+			traceCREATE_MUTEX( pxNewQueue );
+
+			/* Start with the semaphore in the expected state. */
+			( void ) xQueueGenericSend( pxNewQueue, NULL, ( TickType_t ) 0U, queueSEND_TO_BACK );
+		}
+		else
+		{
+			traceCREATE_MUTEX_FAILED();
+		}
+	}
+
+#endif /* configUSE_MUTEXES */
+/*-----------------------------------------------------------*/
+
+#if( ( configUSE_MUTEXES == 1 ) && ( configSUPPORT_DYNAMIC_ALLOCATION == 1 ) )
+
+	QueueHandle_t xQueueCreateMutex( const uint8_t ucQueueType )
+	{
+	Queue_t *pxNewQueue;
+	const UBaseType_t uxMutexLength = ( UBaseType_t ) 1, uxMutexSize = ( UBaseType_t ) 0;
+
+		pxNewQueue = ( Queue_t * ) xQueueGenericCreate( uxMutexLength, uxMutexSize, ucQueueType );
+		prvInitialiseMutex( pxNewQueue );
+
+		return pxNewQueue;
+	}
+
+#endif /* configUSE_MUTEXES */
+/*-----------------------------------------------------------*/
+
+#if( ( configUSE_MUTEXES == 1 ) && ( configSUPPORT_STATIC_ALLOCATION == 1 ) )
+
+	QueueHandle_t xQueueCreateMutexStatic( const uint8_t ucQueueType, StaticQueue_t *pxStaticQueue )
+	{
+	Queue_t *pxNewQueue;
+	const UBaseType_t uxMutexLength = ( UBaseType_t ) 1, uxMutexSize = ( UBaseType_t ) 0;
+
+		/* Prevent compiler warnings about unused parameters if
+		configUSE_TRACE_FACILITY does not equal 1. */
+		( void ) ucQueueType;
+
+		pxNewQueue = ( Queue_t * ) xQueueGenericCreateStatic( uxMutexLength, uxMutexSize, NULL, pxStaticQueue, ucQueueType );
+		prvInitialiseMutex( pxNewQueue );
+
+		return pxNewQueue;
+	}
+
+#endif /* configUSE_MUTEXES */
+/*-----------------------------------------------------------*/
+
+#if ( ( configUSE_MUTEXES == 1 ) && ( INCLUDE_xSemaphoreGetMutexHolder == 1 ) )
+
+	void* xQueueGetMutexHolder( QueueHandle_t xSemaphore )
+	{
+	void *pxReturn;
+
+		/* This function is called by xSemaphoreGetMutexHolder(), and should not
+		be called directly.  Note:  This is a good way of determining if the
+		calling task is the mutex holder, but not a good way of determining the
+		identity of the mutex holder, as the holder may change between the
+		following critical section exiting and the function returning. */
+		taskENTER_CRITICAL();
+		{
+			if( ( ( Queue_t * ) xSemaphore )->uxQueueType == queueQUEUE_IS_MUTEX )
+			{
+				pxReturn = ( void * ) ( ( Queue_t * ) xSemaphore )->pxMutexHolder;
+			}
+			else
+			{
+				pxReturn = NULL;
+			}
+		}
+		taskEXIT_CRITICAL();
+
+		return pxReturn;
+	} /*lint !e818 xSemaphore cannot be a pointer to const because it is a typedef. */
+
+#endif
+/*-----------------------------------------------------------*/
+
+#if ( configUSE_RECURSIVE_MUTEXES == 1 )
+
+	BaseType_t xQueueGiveMutexRecursive( QueueHandle_t xMutex )
+	{
+	BaseType_t xReturn;
+	Queue_t * const pxMutex = ( Queue_t * ) xMutex;
+
+		configASSERT( pxMutex );
+
+		/* If this is the task that holds the mutex then pxMutexHolder will not
+		change outside of this task.  If this task does not hold the mutex then
+		pxMutexHolder can never coincidentally equal the tasks handle, and as
+		this is the only condition we are interested in it does not matter if
+		pxMutexHolder is accessed simultaneously by another task.  Therefore no
+		mutual exclusion is required to test the pxMutexHolder variable. */
+		if( pxMutex->pxMutexHolder == ( void * ) xTaskGetCurrentTaskHandle() ) /*lint !e961 Not a redundant cast as TaskHandle_t is a typedef. */
+		{
+			traceGIVE_MUTEX_RECURSIVE( pxMutex );
+
+			/* uxRecursiveCallCount cannot be zero if pxMutexHolder is equal to
+			the task handle, therefore no underflow check is required.  Also,
+			uxRecursiveCallCount is only modified by the mutex holder, and as
+			there can only be one, no mutual exclusion is required to modify the
+			uxRecursiveCallCount member. */
+			( pxMutex->u.uxRecursiveCallCount )--;
+
+			/* Has the recursive call count unwound to 0? */
+			if( pxMutex->u.uxRecursiveCallCount == ( UBaseType_t ) 0 )
+			{
+				/* Return the mutex.  This will automatically unblock any other
+				task that might be waiting to access the mutex. */
+				( void ) xQueueGenericSend( pxMutex, NULL, queueMUTEX_GIVE_BLOCK_TIME, queueSEND_TO_BACK );
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+
+			xReturn = pdPASS;
+		}
+		else
+		{
+			/* The mutex cannot be given because the calling task is not the
+			holder. */
+			xReturn = pdFAIL;
+
+			traceGIVE_MUTEX_RECURSIVE_FAILED( pxMutex );
+		}
+
+		return xReturn;
+	}
+
+#endif /* configUSE_RECURSIVE_MUTEXES */
+/*-----------------------------------------------------------*/
+
+#if ( configUSE_RECURSIVE_MUTEXES == 1 )
+
+	BaseType_t xQueueTakeMutexRecursive( QueueHandle_t xMutex, TickType_t xTicksToWait )
+	{
+	BaseType_t xReturn;
+	Queue_t * const pxMutex = ( Queue_t * ) xMutex;
+
+		configASSERT( pxMutex );
+
+		/* Comments regarding mutual exclusion as per those within
+		xQueueGiveMutexRecursive(). */
+
+		traceTAKE_MUTEX_RECURSIVE( pxMutex );
+
+		if( pxMutex->pxMutexHolder == ( void * ) xTaskGetCurrentTaskHandle() ) /*lint !e961 Cast is not redundant as TaskHandle_t is a typedef. */
+		{
+			( pxMutex->u.uxRecursiveCallCount )++;
+			xReturn = pdPASS;
+		}
+		else
+		{
+			xReturn = xQueueGenericReceive( pxMutex, NULL, xTicksToWait, pdFALSE );
+
+			/* pdPASS will only be returned if the mutex was successfully
+			obtained.  The calling task may have entered the Blocked state
+			before reaching here. */
+			if( xReturn != pdFAIL )
+			{
+				( pxMutex->u.uxRecursiveCallCount )++;
+			}
+			else
+			{
+				traceTAKE_MUTEX_RECURSIVE_FAILED( pxMutex );
+			}
+		}
+
+		return xReturn;
+	}
+
+#endif /* configUSE_RECURSIVE_MUTEXES */
+/*-----------------------------------------------------------*/
+
+#if( ( configUSE_COUNTING_SEMAPHORES == 1 ) && ( configSUPPORT_STATIC_ALLOCATION == 1 ) )
+
+	QueueHandle_t xQueueCreateCountingSemaphoreStatic( const UBaseType_t uxMaxCount, const UBaseType_t uxInitialCount, StaticQueue_t *pxStaticQueue )
+	{
+	QueueHandle_t xHandle;
+
+		configASSERT( uxMaxCount != 0 );
+		configASSERT( uxInitialCount <= uxMaxCount );
+
+		xHandle = xQueueGenericCreateStatic( uxMaxCount, queueSEMAPHORE_QUEUE_ITEM_LENGTH, NULL, pxStaticQueue, queueQUEUE_TYPE_COUNTING_SEMAPHORE );
+
+		if( xHandle != NULL )
+		{
+			( ( Queue_t * ) xHandle )->uxMessagesWaiting = uxInitialCount;
+
+			traceCREATE_COUNTING_SEMAPHORE();
+		}
+		else
+		{
+			traceCREATE_COUNTING_SEMAPHORE_FAILED();
+		}
+
+		return xHandle;
+	}
+
+#endif /* ( ( configUSE_COUNTING_SEMAPHORES == 1 ) && ( configSUPPORT_DYNAMIC_ALLOCATION == 1 ) ) */
+/*-----------------------------------------------------------*/
+
+#if( ( configUSE_COUNTING_SEMAPHORES == 1 ) && ( configSUPPORT_DYNAMIC_ALLOCATION == 1 ) )
+
+	QueueHandle_t xQueueCreateCountingSemaphore( const UBaseType_t uxMaxCount, const UBaseType_t uxInitialCount )
+	{
+	QueueHandle_t xHandle;
+
+		configASSERT( uxMaxCount != 0 );
+		configASSERT( uxInitialCount <= uxMaxCount );
+
+		xHandle = xQueueGenericCreate( uxMaxCount, queueSEMAPHORE_QUEUE_ITEM_LENGTH, queueQUEUE_TYPE_COUNTING_SEMAPHORE );
+
+		if( xHandle != NULL )
+		{
+			( ( Queue_t * ) xHandle )->uxMessagesWaiting = uxInitialCount;
+
+			traceCREATE_COUNTING_SEMAPHORE();
+		}
+		else
+		{
+			traceCREATE_COUNTING_SEMAPHORE_FAILED();
+		}
+
+		return xHandle;
+	}
+
+#endif /* ( ( configUSE_COUNTING_SEMAPHORES == 1 ) && ( configSUPPORT_DYNAMIC_ALLOCATION == 1 ) ) */
+/*-----------------------------------------------------------*/
+
+BaseType_t xQueueGenericSend( QueueHandle_t xQueue, const void * const pvItemToQueue, TickType_t xTicksToWait, const BaseType_t xCopyPosition )
+{
+BaseType_t xEntryTimeSet = pdFALSE, xYieldRequired;
+TimeOut_t xTimeOut;
+Queue_t * const pxQueue = ( Queue_t * ) xQueue;
+
+	configASSERT( pxQueue );
+	configASSERT( !( ( pvItemToQueue == NULL ) && ( pxQueue->uxItemSize != ( UBaseType_t ) 0U ) ) );
+	configASSERT( !( ( xCopyPosition == queueOVERWRITE ) && ( pxQueue->uxLength != 1 ) ) );
+	#if ( ( INCLUDE_xTaskGetSchedulerState == 1 ) || ( configUSE_TIMERS == 1 ) )
+	{
+		configASSERT( !( ( xTaskGetSchedulerState() == taskSCHEDULER_SUSPENDED ) && ( xTicksToWait != 0 ) ) );
+	}
+	#endif
+
+
+	/* This function relaxes the coding standard somewhat to allow return
+	statements within the function itself.  This is done in the interest
+	of execution time efficiency. */
+	for( ;; )
+	{
+		taskENTER_CRITICAL();
+		{
+			/* Is there room on the queue now?  The running task must be the
+			highest priority task wanting to access the queue.  If the head item
+			in the queue is to be overwritten then it does not matter if the
+			queue is full. */
+			if( ( pxQueue->uxMessagesWaiting < pxQueue->uxLength ) || ( xCopyPosition == queueOVERWRITE ) )
+			{
+				traceQUEUE_SEND( pxQueue );
+				xYieldRequired = prvCopyDataToQueue( pxQueue, pvItemToQueue, xCopyPosition );
+
+				#if ( configUSE_QUEUE_SETS == 1 )
+				{
+					if( pxQueue->pxQueueSetContainer != NULL )
+					{
+						if( prvNotifyQueueSetContainer( pxQueue, xCopyPosition ) != pdFALSE )
+						{
+							/* The queue is a member of a queue set, and posting
+							to the queue set caused a higher priority task to
+							unblock. A context switch is required. */
+							queueYIELD_IF_USING_PREEMPTION();
+						}
+						else
+						{
+							mtCOVERAGE_TEST_MARKER();
+						}
+					}
+					else
+					{
+						/* If there was a task waiting for data to arrive on the
+						queue then unblock it now. */
+						if( listLIST_IS_EMPTY( &( pxQueue->xTasksWaitingToReceive ) ) == pdFALSE )
+						{
+							if( xTaskRemoveFromEventList( &( pxQueue->xTasksWaitingToReceive ) ) != pdFALSE )
+							{
+								/* The unblocked task has a priority higher than
+								our own so yield immediately.  Yes it is ok to
+								do this from within the critical section - the
+								kernel takes care of that. */
+								queueYIELD_IF_USING_PREEMPTION();
+							}
+							else
+							{
+								mtCOVERAGE_TEST_MARKER();
+							}
+						}
+						else if( xYieldRequired != pdFALSE )
+						{
+							/* This path is a special case that will only get
+							executed if the task was holding multiple mutexes
+							and the mutexes were given back in an order that is
+							different to that in which they were taken. */
+							queueYIELD_IF_USING_PREEMPTION();
+						}
+						else
+						{
+							mtCOVERAGE_TEST_MARKER();
+						}
+					}
+				}
+				#else /* configUSE_QUEUE_SETS */
+				{
+					/* If there was a task waiting for data to arrive on the
+					queue then unblock it now. */
+					if( listLIST_IS_EMPTY( &( pxQueue->xTasksWaitingToReceive ) ) == pdFALSE )
+					{
+						if( xTaskRemoveFromEventList( &( pxQueue->xTasksWaitingToReceive ) ) != pdFALSE )
+						{
+							/* The unblocked task has a priority higher than
+							our own so yield immediately.  Yes it is ok to do
+							this from within the critical section - the kernel
+							takes care of that. */
+							queueYIELD_IF_USING_PREEMPTION();
+						}
+						else
+						{
+							mtCOVERAGE_TEST_MARKER();
+						}
+					}
+					else if( xYieldRequired != pdFALSE )
+					{
+						/* This path is a special case that will only get
+						executed if the task was holding multiple mutexes and
+						the mutexes were given back in an order that is
+						different to that in which they were taken. */
+						queueYIELD_IF_USING_PREEMPTION();
+					}
+					else
+					{
+						mtCOVERAGE_TEST_MARKER();
+					}
+				}
+				#endif /* configUSE_QUEUE_SETS */
+
+				taskEXIT_CRITICAL();
+				return pdPASS;
+			}
+			else
+			{
+				if( xTicksToWait == ( TickType_t ) 0 )
+				{
+					/* The queue was full and no block time is specified (or
+					the block time has expired) so leave now. */
+					taskEXIT_CRITICAL();
+
+					/* Return to the original privilege level before exiting
+					the function. */
+					traceQUEUE_SEND_FAILED( pxQueue );
+					return errQUEUE_FULL;
+				}
+				else if( xEntryTimeSet == pdFALSE )
+				{
+					/* The queue was full and a block time was specified so
+					configure the timeout structure. */
+					vTaskSetTimeOutState( &xTimeOut );
+					xEntryTimeSet = pdTRUE;
+				}
+				else
+				{
+					/* Entry time was already set. */
+					mtCOVERAGE_TEST_MARKER();
+				}
+			}
+		}
+		taskEXIT_CRITICAL();
+
+		/* Interrupts and other tasks can send to and receive from the queue
+		now the critical section has been exited. */
+
+		vTaskSuspendAll();
+		prvLockQueue( pxQueue );
+
+		/* Update the timeout state to see if it has expired yet. */
+		if( xTaskCheckForTimeOut( &xTimeOut, &xTicksToWait ) == pdFALSE )
+		{
+			if( prvIsQueueFull( pxQueue ) != pdFALSE )
+			{
+				traceBLOCKING_ON_QUEUE_SEND( pxQueue );
+				vTaskPlaceOnEventList( &( pxQueue->xTasksWaitingToSend ), xTicksToWait );
+
+				/* Unlocking the queue means queue events can effect the
+				event list.  It is possible	that interrupts occurring now
+				remove this task from the event	list again - but as the
+				scheduler is suspended the task will go onto the pending
+				ready last instead of the actual ready list. */
+				prvUnlockQueue( pxQueue );
+
+				/* Resuming the scheduler will move tasks from the pending
+				ready list into the ready list - so it is feasible that this
+				task is already in a ready list before it yields - in which
+				case the yield will not cause a context switch unless there
+				is also a higher priority task in the pending ready list. */
+				if( xTaskResumeAll() == pdFALSE )
+				{
+					portYIELD_WITHIN_API();
+				}
+			}
+			else
+			{
+				/* Try again. */
+				prvUnlockQueue( pxQueue );
+				( void ) xTaskResumeAll();
+			}
+		}
+		else
+		{
+			/* The timeout has expired. */
+			prvUnlockQueue( pxQueue );
+			( void ) xTaskResumeAll();
+
+			traceQUEUE_SEND_FAILED( pxQueue );
+			return errQUEUE_FULL;
+		}
+	}
+}
+/*-----------------------------------------------------------*/
+
+BaseType_t xQueueGenericSendFromISR( QueueHandle_t xQueue, const void * const pvItemToQueue, BaseType_t * const pxHigherPriorityTaskWoken, const BaseType_t xCopyPosition )
+{
+BaseType_t xReturn;
+UBaseType_t uxSavedInterruptStatus;
+Queue_t * const pxQueue = ( Queue_t * ) xQueue;
+
+	configASSERT( pxQueue );
+	configASSERT( !( ( pvItemToQueue == NULL ) && ( pxQueue->uxItemSize != ( UBaseType_t ) 0U ) ) );
+	configASSERT( !( ( xCopyPosition == queueOVERWRITE ) && ( pxQueue->uxLength != 1 ) ) );
+
+	/* RTOS ports that support interrupt nesting have the concept of a maximum
+	system call (or maximum API call) interrupt priority.  Interrupts that are
+	above the maximum system call priority are kept permanently enabled, even
+	when the RTOS kernel is in a critical section, but cannot make any calls to
+	FreeRTOS API functions.  If configASSERT() is defined in FreeRTOSConfig.h
+	then portASSERT_IF_INTERRUPT_PRIORITY_INVALID() will result in an assertion
+	failure if a FreeRTOS API function is called from an interrupt that has been
+	assigned a priority above the configured maximum system call priority.
+	Only FreeRTOS functions that end in FromISR can be called from interrupts
+	that have been assigned a priority at or (logically) below the maximum
+	system call	interrupt priority.  FreeRTOS maintains a separate interrupt
+	safe API to ensure interrupt entry is as fast and as simple as possible.
+	More information (albeit Cortex-M specific) is provided on the following
+	link: http://www.freertos.org/RTOS-Cortex-M3-M4.html */
+	portASSERT_IF_INTERRUPT_PRIORITY_INVALID();
+
+	/* Similar to xQueueGenericSend, except without blocking if there is no room
+	in the queue.  Also don't directly wake a task that was blocked on a queue
+	read, instead return a flag to say whether a context switch is required or
+	not (i.e. has a task with a higher priority than us been woken by this
+	post). */
+	uxSavedInterruptStatus = portSET_INTERRUPT_MASK_FROM_ISR();
+	{
+		if( ( pxQueue->uxMessagesWaiting < pxQueue->uxLength ) || ( xCopyPosition == queueOVERWRITE ) )
+		{
+			const int8_t cTxLock = pxQueue->cTxLock;
+
+			traceQUEUE_SEND_FROM_ISR( pxQueue );
+
+			/* Semaphores use xQueueGiveFromISR(), so pxQueue will not be a
+			semaphore or mutex.  That means prvCopyDataToQueue() cannot result
+			in a task disinheriting a priority and prvCopyDataToQueue() can be
+			called here even though the disinherit function does not check if
+			the scheduler is suspended before accessing the ready lists. */
+			( void ) prvCopyDataToQueue( pxQueue, pvItemToQueue, xCopyPosition );
+
+			/* The event list is not altered if the queue is locked.  This will
+			be done when the queue is unlocked later. */
+			if( cTxLock == queueUNLOCKED )
+			{
+				#if ( configUSE_QUEUE_SETS == 1 )
+				{
+					if( pxQueue->pxQueueSetContainer != NULL )
+					{
+						if( prvNotifyQueueSetContainer( pxQueue, xCopyPosition ) != pdFALSE )
+						{
+							/* The queue is a member of a queue set, and posting
+							to the queue set caused a higher priority task to
+							unblock.  A context switch is required. */
+							if( pxHigherPriorityTaskWoken != NULL )
+							{
+								*pxHigherPriorityTaskWoken = pdTRUE;
+							}
+							else
+							{
+								mtCOVERAGE_TEST_MARKER();
+							}
+						}
+						else
+						{
+							mtCOVERAGE_TEST_MARKER();
+						}
+					}
+					else
+					{
+						if( listLIST_IS_EMPTY( &( pxQueue->xTasksWaitingToReceive ) ) == pdFALSE )
+						{
+							if( xTaskRemoveFromEventList( &( pxQueue->xTasksWaitingToReceive ) ) != pdFALSE )
+							{
+								/* The task waiting has a higher priority so
+								record that a context switch is required. */
+								if( pxHigherPriorityTaskWoken != NULL )
+								{
+									*pxHigherPriorityTaskWoken = pdTRUE;
+								}
+								else
+								{
+									mtCOVERAGE_TEST_MARKER();
+								}
+							}
+							else
+							{
+								mtCOVERAGE_TEST_MARKER();
+							}
+						}
+						else
+						{
+							mtCOVERAGE_TEST_MARKER();
+						}
+					}
+				}
+				#else /* configUSE_QUEUE_SETS */
+				{
+					if( listLIST_IS_EMPTY( &( pxQueue->xTasksWaitingToReceive ) ) == pdFALSE )
+					{
+						if( xTaskRemoveFromEventList( &( pxQueue->xTasksWaitingToReceive ) ) != pdFALSE )
+						{
+							/* The task waiting has a higher priority so record that a
+							context	switch is required. */
+							if( pxHigherPriorityTaskWoken != NULL )
+							{
+								*pxHigherPriorityTaskWoken = pdTRUE;
+							}
+							else
+							{
+								mtCOVERAGE_TEST_MARKER();
+							}
+						}
+						else
+						{
+							mtCOVERAGE_TEST_MARKER();
+						}
+					}
+					else
+					{
+						mtCOVERAGE_TEST_MARKER();
+					}
+				}
+				#endif /* configUSE_QUEUE_SETS */
+			}
+			else
+			{
+				/* Increment the lock count so the task that unlocks the queue
+				knows that data was posted while it was locked. */
+				pxQueue->cTxLock = ( int8_t ) ( cTxLock + 1 );
+			}
+
+			xReturn = pdPASS;
+		}
+		else
+		{
+			traceQUEUE_SEND_FROM_ISR_FAILED( pxQueue );
+			xReturn = errQUEUE_FULL;
+		}
+	}
+	portCLEAR_INTERRUPT_MASK_FROM_ISR( uxSavedInterruptStatus );
+
+	return xReturn;
+}
+/*-----------------------------------------------------------*/
+
+BaseType_t xQueueGiveFromISR( QueueHandle_t xQueue, BaseType_t * const pxHigherPriorityTaskWoken )
+{
+BaseType_t xReturn;
+UBaseType_t uxSavedInterruptStatus;
+Queue_t * const pxQueue = ( Queue_t * ) xQueue;
+
+	/* Similar to xQueueGenericSendFromISR() but used with semaphores where the
+	item size is 0.  Don't directly wake a task that was blocked on a queue
+	read, instead return a flag to say whether a context switch is required or
+	not (i.e. has a task with a higher priority than us been woken by this
+	post). */
+
+	configASSERT( pxQueue );
+
+	/* xQueueGenericSendFromISR() should be used instead of xQueueGiveFromISR()
+	if the item size is not 0. */
+	configASSERT( pxQueue->uxItemSize == 0 );
+
+	/* Normally a mutex would not be given from an interrupt, especially if
+	there is a mutex holder, as priority inheritance makes no sense for an
+	interrupts, only tasks. */
+	configASSERT( !( ( pxQueue->uxQueueType == queueQUEUE_IS_MUTEX ) && ( pxQueue->pxMutexHolder != NULL ) ) );
+
+	/* RTOS ports that support interrupt nesting have the concept of a maximum
+	system call (or maximum API call) interrupt priority.  Interrupts that are
+	above the maximum system call priority are kept permanently enabled, even
+	when the RTOS kernel is in a critical section, but cannot make any calls to
+	FreeRTOS API functions.  If configASSERT() is defined in FreeRTOSConfig.h
+	then portASSERT_IF_INTERRUPT_PRIORITY_INVALID() will result in an assertion
+	failure if a FreeRTOS API function is called from an interrupt that has been
+	assigned a priority above the configured maximum system call priority.
+	Only FreeRTOS functions that end in FromISR can be called from interrupts
+	that have been assigned a priority at or (logically) below the maximum
+	system call	interrupt priority.  FreeRTOS maintains a separate interrupt
+	safe API to ensure interrupt entry is as fast and as simple as possible.
+	More information (albeit Cortex-M specific) is provided on the following
+	link: http://www.freertos.org/RTOS-Cortex-M3-M4.html */
+	portASSERT_IF_INTERRUPT_PRIORITY_INVALID();
+
+	uxSavedInterruptStatus = portSET_INTERRUPT_MASK_FROM_ISR();
+	{
+		const UBaseType_t uxMessagesWaiting = pxQueue->uxMessagesWaiting;
+
+		/* When the queue is used to implement a semaphore no data is ever
+		moved through the queue but it is still valid to see if the queue 'has
+		space'. */
+		if( uxMessagesWaiting < pxQueue->uxLength )
+		{
+			const int8_t cTxLock = pxQueue->cTxLock;
+
+			traceQUEUE_SEND_FROM_ISR( pxQueue );
+
+			/* A task can only have an inherited priority if it is a mutex
+			holder - and if there is a mutex holder then the mutex cannot be
+			given from an ISR.  As this is the ISR version of the function it
+			can be assumed there is no mutex holder and no need to determine if
+			priority disinheritance is needed.  Simply increase the count of
+			messages (semaphores) available. */
+			pxQueue->uxMessagesWaiting = uxMessagesWaiting + 1;
+
+			/* The event list is not altered if the queue is locked.  This will
+			be done when the queue is unlocked later. */
+			if( cTxLock == queueUNLOCKED )
+			{
+				#if ( configUSE_QUEUE_SETS == 1 )
+				{
+					if( pxQueue->pxQueueSetContainer != NULL )
+					{
+						if( prvNotifyQueueSetContainer( pxQueue, queueSEND_TO_BACK ) != pdFALSE )
+						{
+							/* The semaphore is a member of a queue set, and
+							posting	to the queue set caused a higher priority
+							task to	unblock.  A context switch is required. */
+							if( pxHigherPriorityTaskWoken != NULL )
+							{
+								*pxHigherPriorityTaskWoken = pdTRUE;
+							}
+							else
+							{
+								mtCOVERAGE_TEST_MARKER();
+							}
+						}
+						else
+						{
+							mtCOVERAGE_TEST_MARKER();
+						}
+					}
+					else
+					{
+						if( listLIST_IS_EMPTY( &( pxQueue->xTasksWaitingToReceive ) ) == pdFALSE )
+						{
+							if( xTaskRemoveFromEventList( &( pxQueue->xTasksWaitingToReceive ) ) != pdFALSE )
+							{
+								/* The task waiting has a higher priority so
+								record that a context switch is required. */
+								if( pxHigherPriorityTaskWoken != NULL )
+								{
+									*pxHigherPriorityTaskWoken = pdTRUE;
+								}
+								else
+								{
+									mtCOVERAGE_TEST_MARKER();
+								}
+							}
+							else
+							{
+								mtCOVERAGE_TEST_MARKER();
+							}
+						}
+						else
+						{
+							mtCOVERAGE_TEST_MARKER();
+						}
+					}
+				}
+				#else /* configUSE_QUEUE_SETS */
+				{
+					if( listLIST_IS_EMPTY( &( pxQueue->xTasksWaitingToReceive ) ) == pdFALSE )
+					{
+						if( xTaskRemoveFromEventList( &( pxQueue->xTasksWaitingToReceive ) ) != pdFALSE )
+						{
+							/* The task waiting has a higher priority so record that a
+							context	switch is required. */
+							if( pxHigherPriorityTaskWoken != NULL )
+							{
+								*pxHigherPriorityTaskWoken = pdTRUE;
+							}
+							else
+							{
+								mtCOVERAGE_TEST_MARKER();
+							}
+						}
+						else
+						{
+							mtCOVERAGE_TEST_MARKER();
+						}
+					}
+					else
+					{
+						mtCOVERAGE_TEST_MARKER();
+					}
+				}
+				#endif /* configUSE_QUEUE_SETS */
+			}
+			else
+			{
+				/* Increment the lock count so the task that unlocks the queue
+				knows that data was posted while it was locked. */
+				pxQueue->cTxLock = ( int8_t ) ( cTxLock + 1 );
+			}
+
+			xReturn = pdPASS;
+		}
+		else
+		{
+			traceQUEUE_SEND_FROM_ISR_FAILED( pxQueue );
+			xReturn = errQUEUE_FULL;
+		}
+	}
+	portCLEAR_INTERRUPT_MASK_FROM_ISR( uxSavedInterruptStatus );
+
+	return xReturn;
+}
+/*-----------------------------------------------------------*/
+
+BaseType_t xQueueGenericReceive( QueueHandle_t xQueue, void * const pvBuffer, TickType_t xTicksToWait, const BaseType_t xJustPeeking )
+{
+BaseType_t xEntryTimeSet = pdFALSE;
+TimeOut_t xTimeOut;
+int8_t *pcOriginalReadPosition;
+Queue_t * const pxQueue = ( Queue_t * ) xQueue;
+
+	configASSERT( pxQueue );
+	configASSERT( !( ( pvBuffer == NULL ) && ( pxQueue->uxItemSize != ( UBaseType_t ) 0U ) ) );
+	#if ( ( INCLUDE_xTaskGetSchedulerState == 1 ) || ( configUSE_TIMERS == 1 ) )
+	{
+		configASSERT( !( ( xTaskGetSchedulerState() == taskSCHEDULER_SUSPENDED ) && ( xTicksToWait != 0 ) ) );
+	}
+	#endif
+
+	/* This function relaxes the coding standard somewhat to allow return
+	statements within the function itself.  This is done in the interest
+	of execution time efficiency. */
+
+	for( ;; )
+	{
+		taskENTER_CRITICAL();
+		{
+			const UBaseType_t uxMessagesWaiting = pxQueue->uxMessagesWaiting;
+
+			/* Is there data in the queue now?  To be running the calling task
+			must be the highest priority task wanting to access the queue. */
+			if( uxMessagesWaiting > ( UBaseType_t ) 0 )
+			{
+				/* Remember the read position in case the queue is only being
+				peeked. */
+				pcOriginalReadPosition = pxQueue->u.pcReadFrom;
+
+				prvCopyDataFromQueue( pxQueue, pvBuffer );
+
+				if( xJustPeeking == pdFALSE )
+				{
+					traceQUEUE_RECEIVE( pxQueue );
+
+					/* Actually removing data, not just peeking. */
+					pxQueue->uxMessagesWaiting = uxMessagesWaiting - 1;
+
+					#if ( configUSE_MUTEXES == 1 )
+					{
+						if( pxQueue->uxQueueType == queueQUEUE_IS_MUTEX )
+						{
+							/* Record the information required to implement
+							priority inheritance should it become necessary. */
+							pxQueue->pxMutexHolder = ( int8_t * ) pvTaskIncrementMutexHeldCount(); /*lint !e961 Cast is not redundant as TaskHandle_t is a typedef. */
+						}
+						else
+						{
+							mtCOVERAGE_TEST_MARKER();
+						}
+					}
+					#endif /* configUSE_MUTEXES */
+
+					if( listLIST_IS_EMPTY( &( pxQueue->xTasksWaitingToSend ) ) == pdFALSE )
+					{
+						if( xTaskRemoveFromEventList( &( pxQueue->xTasksWaitingToSend ) ) != pdFALSE )
+						{
+							queueYIELD_IF_USING_PREEMPTION();
+						}
+						else
+						{
+							mtCOVERAGE_TEST_MARKER();
+						}
+					}
+					else
+					{
+						mtCOVERAGE_TEST_MARKER();
+					}
+				}
+				else
+				{
+					traceQUEUE_PEEK( pxQueue );
+
+					/* The data is not being removed, so reset the read
+					pointer. */
+					pxQueue->u.pcReadFrom = pcOriginalReadPosition;
+
+					/* The data is being left in the queue, so see if there are
+					any other tasks waiting for the data. */
+					if( listLIST_IS_EMPTY( &( pxQueue->xTasksWaitingToReceive ) ) == pdFALSE )
+					{
+						if( xTaskRemoveFromEventList( &( pxQueue->xTasksWaitingToReceive ) ) != pdFALSE )
+						{
+							/* The task waiting has a higher priority than this task. */
+							queueYIELD_IF_USING_PREEMPTION();
+						}
+						else
+						{
+							mtCOVERAGE_TEST_MARKER();
+						}
+					}
+					else
+					{
+						mtCOVERAGE_TEST_MARKER();
+					}
+				}
+
+				taskEXIT_CRITICAL();
+				return pdPASS;
+			}
+			else
+			{
+				if( xTicksToWait == ( TickType_t ) 0 )
+				{
+					/* The queue was empty and no block time is specified (or
+					the block time has expired) so leave now. */
+					taskEXIT_CRITICAL();
+					traceQUEUE_RECEIVE_FAILED( pxQueue );
+					return errQUEUE_EMPTY;
+				}
+				else if( xEntryTimeSet == pdFALSE )
+				{
+					/* The queue was empty and a block time was specified so
+					configure the timeout structure. */
+					vTaskSetTimeOutState( &xTimeOut );
+					xEntryTimeSet = pdTRUE;
+				}
+				else
+				{
+					/* Entry time was already set. */
+					mtCOVERAGE_TEST_MARKER();
+				}
+			}
+		}
+		taskEXIT_CRITICAL();
+
+		/* Interrupts and other tasks can send to and receive from the queue
+		now the critical section has been exited. */
+
+		vTaskSuspendAll();
+		prvLockQueue( pxQueue );
+
+		/* Update the timeout state to see if it has expired yet. */
+		if( xTaskCheckForTimeOut( &xTimeOut, &xTicksToWait ) == pdFALSE )
+		{
+			if( prvIsQueueEmpty( pxQueue ) != pdFALSE )
+			{
+				traceBLOCKING_ON_QUEUE_RECEIVE( pxQueue );
+
+				#if ( configUSE_MUTEXES == 1 )
+				{
+					if( pxQueue->uxQueueType == queueQUEUE_IS_MUTEX )
+					{
+						taskENTER_CRITICAL();
+						{
+							vTaskPriorityInherit( ( void * ) pxQueue->pxMutexHolder );
+						}
+						taskEXIT_CRITICAL();
+					}
+					else
+					{
+						mtCOVERAGE_TEST_MARKER();
+					}
+				}
+				#endif
+
+				vTaskPlaceOnEventList( &( pxQueue->xTasksWaitingToReceive ), xTicksToWait );
+				prvUnlockQueue( pxQueue );
+				if( xTaskResumeAll() == pdFALSE )
+				{
+					portYIELD_WITHIN_API();
+				}
+				else
+				{
+					mtCOVERAGE_TEST_MARKER();
+				}
+			}
+			else
+			{
+				/* Try again. */
+				prvUnlockQueue( pxQueue );
+				( void ) xTaskResumeAll();
+			}
+		}
+		else
+		{
+			prvUnlockQueue( pxQueue );
+			( void ) xTaskResumeAll();
+
+			if( prvIsQueueEmpty( pxQueue ) != pdFALSE )
+			{
+				traceQUEUE_RECEIVE_FAILED( pxQueue );
+				return errQUEUE_EMPTY;
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+		}
+	}
+}
+/*-----------------------------------------------------------*/
+
+BaseType_t xQueueReceiveFromISR( QueueHandle_t xQueue, void * const pvBuffer, BaseType_t * const pxHigherPriorityTaskWoken )
+{
+BaseType_t xReturn;
+UBaseType_t uxSavedInterruptStatus;
+Queue_t * const pxQueue = ( Queue_t * ) xQueue;
+
+	configASSERT( pxQueue );
+	configASSERT( !( ( pvBuffer == NULL ) && ( pxQueue->uxItemSize != ( UBaseType_t ) 0U ) ) );
+
+	/* RTOS ports that support interrupt nesting have the concept of a maximum
+	system call (or maximum API call) interrupt priority.  Interrupts that are
+	above the maximum system call priority are kept permanently enabled, even
+	when the RTOS kernel is in a critical section, but cannot make any calls to
+	FreeRTOS API functions.  If configASSERT() is defined in FreeRTOSConfig.h
+	then portASSERT_IF_INTERRUPT_PRIORITY_INVALID() will result in an assertion
+	failure if a FreeRTOS API function is called from an interrupt that has been
+	assigned a priority above the configured maximum system call priority.
+	Only FreeRTOS functions that end in FromISR can be called from interrupts
+	that have been assigned a priority at or (logically) below the maximum
+	system call	interrupt priority.  FreeRTOS maintains a separate interrupt
+	safe API to ensure interrupt entry is as fast and as simple as possible.
+	More information (albeit Cortex-M specific) is provided on the following
+	link: http://www.freertos.org/RTOS-Cortex-M3-M4.html */
+	portASSERT_IF_INTERRUPT_PRIORITY_INVALID();
+
+	uxSavedInterruptStatus = portSET_INTERRUPT_MASK_FROM_ISR();
+	{
+		const UBaseType_t uxMessagesWaiting = pxQueue->uxMessagesWaiting;
+
+		/* Cannot block in an ISR, so check there is data available. */
+		if( uxMessagesWaiting > ( UBaseType_t ) 0 )
+		{
+			const int8_t cRxLock = pxQueue->cRxLock;
+
+			traceQUEUE_RECEIVE_FROM_ISR( pxQueue );
+
+			prvCopyDataFromQueue( pxQueue, pvBuffer );
+			pxQueue->uxMessagesWaiting = uxMessagesWaiting - 1;
+
+			/* If the queue is locked the event list will not be modified.
+			Instead update the lock count so the task that unlocks the queue
+			will know that an ISR has removed data while the queue was
+			locked. */
+			if( cRxLock == queueUNLOCKED )
+			{
+				if( listLIST_IS_EMPTY( &( pxQueue->xTasksWaitingToSend ) ) == pdFALSE )
+				{
+					if( xTaskRemoveFromEventList( &( pxQueue->xTasksWaitingToSend ) ) != pdFALSE )
+					{
+						/* The task waiting has a higher priority than us so
+						force a context switch. */
+						if( pxHigherPriorityTaskWoken != NULL )
+						{
+							*pxHigherPriorityTaskWoken = pdTRUE;
+						}
+						else
+						{
+							mtCOVERAGE_TEST_MARKER();
+						}
+					}
+					else
+					{
+						mtCOVERAGE_TEST_MARKER();
+					}
+				}
+				else
+				{
+					mtCOVERAGE_TEST_MARKER();
+				}
+			}
+			else
+			{
+				/* Increment the lock count so the task that unlocks the queue
+				knows that data was removed while it was locked. */
+				pxQueue->cRxLock = ( int8_t ) ( cRxLock + 1 );
+			}
+
+			xReturn = pdPASS;
+		}
+		else
+		{
+			xReturn = pdFAIL;
+			traceQUEUE_RECEIVE_FROM_ISR_FAILED( pxQueue );
+		}
+	}
+	portCLEAR_INTERRUPT_MASK_FROM_ISR( uxSavedInterruptStatus );
+
+	return xReturn;
+}
+/*-----------------------------------------------------------*/
+
+BaseType_t xQueuePeekFromISR( QueueHandle_t xQueue,  void * const pvBuffer )
+{
+BaseType_t xReturn;
+UBaseType_t uxSavedInterruptStatus;
+int8_t *pcOriginalReadPosition;
+Queue_t * const pxQueue = ( Queue_t * ) xQueue;
+
+	configASSERT( pxQueue );
+	configASSERT( !( ( pvBuffer == NULL ) && ( pxQueue->uxItemSize != ( UBaseType_t ) 0U ) ) );
+	configASSERT( pxQueue->uxItemSize != 0 ); /* Can't peek a semaphore. */
+
+	/* RTOS ports that support interrupt nesting have the concept of a maximum
+	system call (or maximum API call) interrupt priority.  Interrupts that are
+	above the maximum system call priority are kept permanently enabled, even
+	when the RTOS kernel is in a critical section, but cannot make any calls to
+	FreeRTOS API functions.  If configASSERT() is defined in FreeRTOSConfig.h
+	then portASSERT_IF_INTERRUPT_PRIORITY_INVALID() will result in an assertion
+	failure if a FreeRTOS API function is called from an interrupt that has been
+	assigned a priority above the configured maximum system call priority.
+	Only FreeRTOS functions that end in FromISR can be called from interrupts
+	that have been assigned a priority at or (logically) below the maximum
+	system call	interrupt priority.  FreeRTOS maintains a separate interrupt
+	safe API to ensure interrupt entry is as fast and as simple as possible.
+	More information (albeit Cortex-M specific) is provided on the following
+	link: http://www.freertos.org/RTOS-Cortex-M3-M4.html */
+	portASSERT_IF_INTERRUPT_PRIORITY_INVALID();
+
+	uxSavedInterruptStatus = portSET_INTERRUPT_MASK_FROM_ISR();
+	{
+		/* Cannot block in an ISR, so check there is data available. */
+		if( pxQueue->uxMessagesWaiting > ( UBaseType_t ) 0 )
+		{
+			traceQUEUE_PEEK_FROM_ISR( pxQueue );
+
+			/* Remember the read position so it can be reset as nothing is
+			actually being removed from the queue. */
+			pcOriginalReadPosition = pxQueue->u.pcReadFrom;
+			prvCopyDataFromQueue( pxQueue, pvBuffer );
+			pxQueue->u.pcReadFrom = pcOriginalReadPosition;
+
+			xReturn = pdPASS;
+		}
+		else
+		{
+			xReturn = pdFAIL;
+			traceQUEUE_PEEK_FROM_ISR_FAILED( pxQueue );
+		}
+	}
+	portCLEAR_INTERRUPT_MASK_FROM_ISR( uxSavedInterruptStatus );
+
+	return xReturn;
+}
+/*-----------------------------------------------------------*/
+
+UBaseType_t uxQueueMessagesWaiting( const QueueHandle_t xQueue )
+{
+UBaseType_t uxReturn;
+
+	configASSERT( xQueue );
+
+	taskENTER_CRITICAL();
+	{
+		uxReturn = ( ( Queue_t * ) xQueue )->uxMessagesWaiting;
+	}
+	taskEXIT_CRITICAL();
+
+	return uxReturn;
+} /*lint !e818 Pointer cannot be declared const as xQueue is a typedef not pointer. */
+/*-----------------------------------------------------------*/
+
+UBaseType_t uxQueueSpacesAvailable( const QueueHandle_t xQueue )
+{
+UBaseType_t uxReturn;
+Queue_t *pxQueue;
+
+	pxQueue = ( Queue_t * ) xQueue;
+	configASSERT( pxQueue );
+
+	taskENTER_CRITICAL();
+	{
+		uxReturn = pxQueue->uxLength - pxQueue->uxMessagesWaiting;
+	}
+	taskEXIT_CRITICAL();
+
+	return uxReturn;
+} /*lint !e818 Pointer cannot be declared const as xQueue is a typedef not pointer. */
+/*-----------------------------------------------------------*/
+
+UBaseType_t uxQueueMessagesWaitingFromISR( const QueueHandle_t xQueue )
+{
+UBaseType_t uxReturn;
+
+	configASSERT( xQueue );
+
+	uxReturn = ( ( Queue_t * ) xQueue )->uxMessagesWaiting;
+
+	return uxReturn;
+} /*lint !e818 Pointer cannot be declared const as xQueue is a typedef not pointer. */
+/*-----------------------------------------------------------*/
+
+void vQueueDelete( QueueHandle_t xQueue )
+{
+Queue_t * const pxQueue = ( Queue_t * ) xQueue;
+
+	configASSERT( pxQueue );
+	traceQUEUE_DELETE( pxQueue );
+
+	#if ( configQUEUE_REGISTRY_SIZE > 0 )
+	{
+		vQueueUnregisterQueue( pxQueue );
+	}
+	#endif
+
+	#if( ( configSUPPORT_DYNAMIC_ALLOCATION == 1 ) && ( configSUPPORT_STATIC_ALLOCATION == 0 ) )
+	{
+		/* The queue can only have been allocated dynamically - free it
+		again. */
+		vPortFree( pxQueue );
+	}
+	#elif( ( configSUPPORT_DYNAMIC_ALLOCATION == 1 ) && ( configSUPPORT_STATIC_ALLOCATION == 1 ) )
+	{
+		/* The queue could have been allocated statically or dynamically, so
+		check before attempting to free the memory. */
+		if( pxQueue->ucStaticallyAllocated == ( uint8_t ) pdFALSE )
+		{
+			vPortFree( pxQueue );
+		}
+		else
+		{
+			mtCOVERAGE_TEST_MARKER();
+		}
+	}
+	#else
+	{
+		/* The queue must have been statically allocated, so is not going to be
+		deleted.  Avoid compiler warnings about the unused parameter. */
+		( void ) pxQueue;
+	}
+	#endif /* configSUPPORT_DYNAMIC_ALLOCATION */
+}
+/*-----------------------------------------------------------*/
+
+#if ( configUSE_TRACE_FACILITY == 1 )
+
+	UBaseType_t uxQueueGetQueueNumber( QueueHandle_t xQueue )
+	{
+		return ( ( Queue_t * ) xQueue )->uxQueueNumber;
+	}
+
+#endif /* configUSE_TRACE_FACILITY */
+/*-----------------------------------------------------------*/
+
+#if ( configUSE_TRACE_FACILITY == 1 )
+
+	void vQueueSetQueueNumber( QueueHandle_t xQueue, UBaseType_t uxQueueNumber )
+	{
+		( ( Queue_t * ) xQueue )->uxQueueNumber = uxQueueNumber;
+	}
+
+#endif /* configUSE_TRACE_FACILITY */
+/*-----------------------------------------------------------*/
+
+#if ( configUSE_TRACE_FACILITY == 1 )
+
+	uint8_t ucQueueGetQueueType( QueueHandle_t xQueue )
+	{
+		return ( ( Queue_t * ) xQueue )->ucQueueType;
+	}
+
+#endif /* configUSE_TRACE_FACILITY */
+/*-----------------------------------------------------------*/
+
+static BaseType_t prvCopyDataToQueue( Queue_t * const pxQueue, const void *pvItemToQueue, const BaseType_t xPosition )
+{
+BaseType_t xReturn = pdFALSE;
+UBaseType_t uxMessagesWaiting;
+
+	/* This function is called from a critical section. */
+
+	uxMessagesWaiting = pxQueue->uxMessagesWaiting;
+
+	if( pxQueue->uxItemSize == ( UBaseType_t ) 0 )
+	{
+		#if ( configUSE_MUTEXES == 1 )
+		{
+			if( pxQueue->uxQueueType == queueQUEUE_IS_MUTEX )
+			{
+				/* The mutex is no longer being held. */
+				xReturn = xTaskPriorityDisinherit( ( void * ) pxQueue->pxMutexHolder );
+				pxQueue->pxMutexHolder = NULL;
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+		}
+		#endif /* configUSE_MUTEXES */
+	}
+	else if( xPosition == queueSEND_TO_BACK )
+	{
+		( void ) memcpy( ( void * ) pxQueue->pcWriteTo, pvItemToQueue, ( size_t ) pxQueue->uxItemSize ); /*lint !e961 !e418 MISRA exception as the casts are only redundant for some ports, plus previous logic ensures a null pointer can only be passed to memcpy() if the copy size is 0. */
+		pxQueue->pcWriteTo += pxQueue->uxItemSize;
+		if( pxQueue->pcWriteTo >= pxQueue->pcTail ) /*lint !e946 MISRA exception justified as comparison of pointers is the cleanest solution. */
+		{
+			pxQueue->pcWriteTo = pxQueue->pcHead;
+		}
+		else
+		{
+			mtCOVERAGE_TEST_MARKER();
+		}
+	}
+	else
+	{
+		( void ) memcpy( ( void * ) pxQueue->u.pcReadFrom, pvItemToQueue, ( size_t ) pxQueue->uxItemSize ); /*lint !e961 MISRA exception as the casts are only redundant for some ports. */
+		pxQueue->u.pcReadFrom -= pxQueue->uxItemSize;
+		if( pxQueue->u.pcReadFrom < pxQueue->pcHead ) /*lint !e946 MISRA exception justified as comparison of pointers is the cleanest solution. */
+		{
+			pxQueue->u.pcReadFrom = ( pxQueue->pcTail - pxQueue->uxItemSize );
+		}
+		else
+		{
+			mtCOVERAGE_TEST_MARKER();
+		}
+
+		if( xPosition == queueOVERWRITE )
+		{
+			if( uxMessagesWaiting > ( UBaseType_t ) 0 )
+			{
+				/* An item is not being added but overwritten, so subtract
+				one from the recorded number of items in the queue so when
+				one is added again below the number of recorded items remains
+				correct. */
+				--uxMessagesWaiting;
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+		}
+		else
+		{
+			mtCOVERAGE_TEST_MARKER();
+		}
+	}
+
+	pxQueue->uxMessagesWaiting = uxMessagesWaiting + 1;
+
+	return xReturn;
+}
+/*-----------------------------------------------------------*/
+
+static void prvCopyDataFromQueue( Queue_t * const pxQueue, void * const pvBuffer )
+{
+	if( pxQueue->uxItemSize != ( UBaseType_t ) 0 )
+	{
+		pxQueue->u.pcReadFrom += pxQueue->uxItemSize;
+		if( pxQueue->u.pcReadFrom >= pxQueue->pcTail ) /*lint !e946 MISRA exception justified as use of the relational operator is the cleanest solutions. */
+		{
+			pxQueue->u.pcReadFrom = pxQueue->pcHead;
+		}
+		else
+		{
+			mtCOVERAGE_TEST_MARKER();
+		}
+		( void ) memcpy( ( void * ) pvBuffer, ( void * ) pxQueue->u.pcReadFrom, ( size_t ) pxQueue->uxItemSize ); /*lint !e961 !e418 MISRA exception as the casts are only redundant for some ports.  Also previous logic ensures a null pointer can only be passed to memcpy() when the count is 0. */
+	}
+}
+/*-----------------------------------------------------------*/
+
+static void prvUnlockQueue( Queue_t * const pxQueue )
+{
+	/* THIS FUNCTION MUST BE CALLED WITH THE SCHEDULER SUSPENDED. */
+
+	/* The lock counts contains the number of extra data items placed or
+	removed from the queue while the queue was locked.  When a queue is
+	locked items can be added or removed, but the event lists cannot be
+	updated. */
+	taskENTER_CRITICAL();
+	{
+		int8_t cTxLock = pxQueue->cTxLock;
+
+		/* See if data was added to the queue while it was locked. */
+		while( cTxLock > queueLOCKED_UNMODIFIED )
+		{
+			/* Data was posted while the queue was locked.  Are any tasks
+			blocked waiting for data to become available? */
+			#if ( configUSE_QUEUE_SETS == 1 )
+			{
+				if( pxQueue->pxQueueSetContainer != NULL )
+				{
+					if( prvNotifyQueueSetContainer( pxQueue, queueSEND_TO_BACK ) != pdFALSE )
+					{
+						/* The queue is a member of a queue set, and posting to
+						the queue set caused a higher priority task to unblock.
+						A context switch is required. */
+						vTaskMissedYield();
+					}
+					else
+					{
+						mtCOVERAGE_TEST_MARKER();
+					}
+				}
+				else
+				{
+					/* Tasks that are removed from the event list will get
+					added to the pending ready list as the scheduler is still
+					suspended. */
+					if( listLIST_IS_EMPTY( &( pxQueue->xTasksWaitingToReceive ) ) == pdFALSE )
+					{
+						if( xTaskRemoveFromEventList( &( pxQueue->xTasksWaitingToReceive ) ) != pdFALSE )
+						{
+							/* The task waiting has a higher priority so record that a
+							context	switch is required. */
+							vTaskMissedYield();
+						}
+						else
+						{
+							mtCOVERAGE_TEST_MARKER();
+						}
+					}
+					else
+					{
+						break;
+					}
+				}
+			}
+			#else /* configUSE_QUEUE_SETS */
+			{
+				/* Tasks that are removed from the event list will get added to
+				the pending ready list as the scheduler is still suspended. */
+				if( listLIST_IS_EMPTY( &( pxQueue->xTasksWaitingToReceive ) ) == pdFALSE )
+				{
+					if( xTaskRemoveFromEventList( &( pxQueue->xTasksWaitingToReceive ) ) != pdFALSE )
+					{
+						/* The task waiting has a higher priority so record that
+						a context switch is required. */
+						vTaskMissedYield();
+					}
+					else
+					{
+						mtCOVERAGE_TEST_MARKER();
+					}
+				}
+				else
+				{
+					break;
+				}
+			}
+			#endif /* configUSE_QUEUE_SETS */
+
+			--cTxLock;
+		}
+
+		pxQueue->cTxLock = queueUNLOCKED;
+	}
+	taskEXIT_CRITICAL();
+
+	/* Do the same for the Rx lock. */
+	taskENTER_CRITICAL();
+	{
+		int8_t cRxLock = pxQueue->cRxLock;
+
+		while( cRxLock > queueLOCKED_UNMODIFIED )
+		{
+			if( listLIST_IS_EMPTY( &( pxQueue->xTasksWaitingToSend ) ) == pdFALSE )
+			{
+				if( xTaskRemoveFromEventList( &( pxQueue->xTasksWaitingToSend ) ) != pdFALSE )
+				{
+					vTaskMissedYield();
+				}
+				else
+				{
+					mtCOVERAGE_TEST_MARKER();
+				}
+
+				--cRxLock;
+			}
+			else
+			{
+				break;
+			}
+		}
+
+		pxQueue->cRxLock = queueUNLOCKED;
+	}
+	taskEXIT_CRITICAL();
+}
+/*-----------------------------------------------------------*/
+
+static BaseType_t prvIsQueueEmpty( const Queue_t *pxQueue )
+{
+BaseType_t xReturn;
+
+	taskENTER_CRITICAL();
+	{
+		if( pxQueue->uxMessagesWaiting == ( UBaseType_t )  0 )
+		{
+			xReturn = pdTRUE;
+		}
+		else
+		{
+			xReturn = pdFALSE;
+		}
+	}
+	taskEXIT_CRITICAL();
+
+	return xReturn;
+}
+/*-----------------------------------------------------------*/
+
+BaseType_t xQueueIsQueueEmptyFromISR( const QueueHandle_t xQueue )
+{
+BaseType_t xReturn;
+
+	configASSERT( xQueue );
+	if( ( ( Queue_t * ) xQueue )->uxMessagesWaiting == ( UBaseType_t ) 0 )
+	{
+		xReturn = pdTRUE;
+	}
+	else
+	{
+		xReturn = pdFALSE;
+	}
+
+	return xReturn;
+} /*lint !e818 xQueue could not be pointer to const because it is a typedef. */
+/*-----------------------------------------------------------*/
+
+static BaseType_t prvIsQueueFull( const Queue_t *pxQueue )
+{
+BaseType_t xReturn;
+
+	taskENTER_CRITICAL();
+	{
+		if( pxQueue->uxMessagesWaiting == pxQueue->uxLength )
+		{
+			xReturn = pdTRUE;
+		}
+		else
+		{
+			xReturn = pdFALSE;
+		}
+	}
+	taskEXIT_CRITICAL();
+
+	return xReturn;
+}
+/*-----------------------------------------------------------*/
+
+BaseType_t xQueueIsQueueFullFromISR( const QueueHandle_t xQueue )
+{
+BaseType_t xReturn;
+
+	configASSERT( xQueue );
+	if( ( ( Queue_t * ) xQueue )->uxMessagesWaiting == ( ( Queue_t * ) xQueue )->uxLength )
+	{
+		xReturn = pdTRUE;
+	}
+	else
+	{
+		xReturn = pdFALSE;
+	}
+
+	return xReturn;
+} /*lint !e818 xQueue could not be pointer to const because it is a typedef. */
+/*-----------------------------------------------------------*/
+
+#if ( configUSE_CO_ROUTINES == 1 )
+
+	BaseType_t xQueueCRSend( QueueHandle_t xQueue, const void *pvItemToQueue, TickType_t xTicksToWait )
+	{
+	BaseType_t xReturn;
+	Queue_t * const pxQueue = ( Queue_t * ) xQueue;
+
+		/* If the queue is already full we may have to block.  A critical section
+		is required to prevent an interrupt removing something from the queue
+		between the check to see if the queue is full and blocking on the queue. */
+		portDISABLE_INTERRUPTS();
+		{
+			if( prvIsQueueFull( pxQueue ) != pdFALSE )
+			{
+				/* The queue is full - do we want to block or just leave without
+				posting? */
+				if( xTicksToWait > ( TickType_t ) 0 )
+				{
+					/* As this is called from a coroutine we cannot block directly, but
+					return indicating that we need to block. */
+					vCoRoutineAddToDelayedList( xTicksToWait, &( pxQueue->xTasksWaitingToSend ) );
+					portENABLE_INTERRUPTS();
+					return errQUEUE_BLOCKED;
+				}
+				else
+				{
+					portENABLE_INTERRUPTS();
+					return errQUEUE_FULL;
+				}
+			}
+		}
+		portENABLE_INTERRUPTS();
+
+		portDISABLE_INTERRUPTS();
+		{
+			if( pxQueue->uxMessagesWaiting < pxQueue->uxLength )
+			{
+				/* There is room in the queue, copy the data into the queue. */
+				prvCopyDataToQueue( pxQueue, pvItemToQueue, queueSEND_TO_BACK );
+				xReturn = pdPASS;
+
+				/* Were any co-routines waiting for data to become available? */
+				if( listLIST_IS_EMPTY( &( pxQueue->xTasksWaitingToReceive ) ) == pdFALSE )
+				{
+					/* In this instance the co-routine could be placed directly
+					into the ready list as we are within a critical section.
+					Instead the same pending ready list mechanism is used as if
+					the event were caused from within an interrupt. */
+					if( xCoRoutineRemoveFromEventList( &( pxQueue->xTasksWaitingToReceive ) ) != pdFALSE )
+					{
+						/* The co-routine waiting has a higher priority so record
+						that a yield might be appropriate. */
+						xReturn = errQUEUE_YIELD;
+					}
+					else
+					{
+						mtCOVERAGE_TEST_MARKER();
+					}
+				}
+				else
+				{
+					mtCOVERAGE_TEST_MARKER();
+				}
+			}
+			else
+			{
+				xReturn = errQUEUE_FULL;
+			}
+		}
+		portENABLE_INTERRUPTS();
+
+		return xReturn;
+	}
+
+#endif /* configUSE_CO_ROUTINES */
+/*-----------------------------------------------------------*/
+
+#if ( configUSE_CO_ROUTINES == 1 )
+
+	BaseType_t xQueueCRReceive( QueueHandle_t xQueue, void *pvBuffer, TickType_t xTicksToWait )
+	{
+	BaseType_t xReturn;
+	Queue_t * const pxQueue = ( Queue_t * ) xQueue;
+
+		/* If the queue is already empty we may have to block.  A critical section
+		is required to prevent an interrupt adding something to the queue
+		between the check to see if the queue is empty and blocking on the queue. */
+		portDISABLE_INTERRUPTS();
+		{
+			if( pxQueue->uxMessagesWaiting == ( UBaseType_t ) 0 )
+			{
+				/* There are no messages in the queue, do we want to block or just
+				leave with nothing? */
+				if( xTicksToWait > ( TickType_t ) 0 )
+				{
+					/* As this is a co-routine we cannot block directly, but return
+					indicating that we need to block. */
+					vCoRoutineAddToDelayedList( xTicksToWait, &( pxQueue->xTasksWaitingToReceive ) );
+					portENABLE_INTERRUPTS();
+					return errQUEUE_BLOCKED;
+				}
+				else
+				{
+					portENABLE_INTERRUPTS();
+					return errQUEUE_FULL;
+				}
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+		}
+		portENABLE_INTERRUPTS();
+
+		portDISABLE_INTERRUPTS();
+		{
+			if( pxQueue->uxMessagesWaiting > ( UBaseType_t ) 0 )
+			{
+				/* Data is available from the queue. */
+				pxQueue->u.pcReadFrom += pxQueue->uxItemSize;
+				if( pxQueue->u.pcReadFrom >= pxQueue->pcTail )
+				{
+					pxQueue->u.pcReadFrom = pxQueue->pcHead;
+				}
+				else
+				{
+					mtCOVERAGE_TEST_MARKER();
+				}
+				--( pxQueue->uxMessagesWaiting );
+				( void ) memcpy( ( void * ) pvBuffer, ( void * ) pxQueue->u.pcReadFrom, ( unsigned ) pxQueue->uxItemSize );
+
+				xReturn = pdPASS;
+
+				/* Were any co-routines waiting for space to become available? */
+				if( listLIST_IS_EMPTY( &( pxQueue->xTasksWaitingToSend ) ) == pdFALSE )
+				{
+					/* In this instance the co-routine could be placed directly
+					into the ready list as we are within a critical section.
+					Instead the same pending ready list mechanism is used as if
+					the event were caused from within an interrupt. */
+					if( xCoRoutineRemoveFromEventList( &( pxQueue->xTasksWaitingToSend ) ) != pdFALSE )
+					{
+						xReturn = errQUEUE_YIELD;
+					}
+					else
+					{
+						mtCOVERAGE_TEST_MARKER();
+					}
+				}
+				else
+				{
+					mtCOVERAGE_TEST_MARKER();
+				}
+			}
+			else
+			{
+				xReturn = pdFAIL;
+			}
+		}
+		portENABLE_INTERRUPTS();
+
+		return xReturn;
+	}
+
+#endif /* configUSE_CO_ROUTINES */
+/*-----------------------------------------------------------*/
+
+#if ( configUSE_CO_ROUTINES == 1 )
+
+	BaseType_t xQueueCRSendFromISR( QueueHandle_t xQueue, const void *pvItemToQueue, BaseType_t xCoRoutinePreviouslyWoken )
+	{
+	Queue_t * const pxQueue = ( Queue_t * ) xQueue;
+
+		/* Cannot block within an ISR so if there is no space on the queue then
+		exit without doing anything. */
+		if( pxQueue->uxMessagesWaiting < pxQueue->uxLength )
+		{
+			prvCopyDataToQueue( pxQueue, pvItemToQueue, queueSEND_TO_BACK );
+
+			/* We only want to wake one co-routine per ISR, so check that a
+			co-routine has not already been woken. */
+			if( xCoRoutinePreviouslyWoken == pdFALSE )
+			{
+				if( listLIST_IS_EMPTY( &( pxQueue->xTasksWaitingToReceive ) ) == pdFALSE )
+				{
+					if( xCoRoutineRemoveFromEventList( &( pxQueue->xTasksWaitingToReceive ) ) != pdFALSE )
+					{
+						return pdTRUE;
+					}
+					else
+					{
+						mtCOVERAGE_TEST_MARKER();
+					}
+				}
+				else
+				{
+					mtCOVERAGE_TEST_MARKER();
+				}
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+		}
+		else
+		{
+			mtCOVERAGE_TEST_MARKER();
+		}
+
+		return xCoRoutinePreviouslyWoken;
+	}
+
+#endif /* configUSE_CO_ROUTINES */
+/*-----------------------------------------------------------*/
+
+#if ( configUSE_CO_ROUTINES == 1 )
+
+	BaseType_t xQueueCRReceiveFromISR( QueueHandle_t xQueue, void *pvBuffer, BaseType_t *pxCoRoutineWoken )
+	{
+	BaseType_t xReturn;
+	Queue_t * const pxQueue = ( Queue_t * ) xQueue;
+
+		/* We cannot block from an ISR, so check there is data available. If
+		not then just leave without doing anything. */
+		if( pxQueue->uxMessagesWaiting > ( UBaseType_t ) 0 )
+		{
+			/* Copy the data from the queue. */
+			pxQueue->u.pcReadFrom += pxQueue->uxItemSize;
+			if( pxQueue->u.pcReadFrom >= pxQueue->pcTail )
+			{
+				pxQueue->u.pcReadFrom = pxQueue->pcHead;
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+			--( pxQueue->uxMessagesWaiting );
+			( void ) memcpy( ( void * ) pvBuffer, ( void * ) pxQueue->u.pcReadFrom, ( unsigned ) pxQueue->uxItemSize );
+
+			if( ( *pxCoRoutineWoken ) == pdFALSE )
+			{
+				if( listLIST_IS_EMPTY( &( pxQueue->xTasksWaitingToSend ) ) == pdFALSE )
+				{
+					if( xCoRoutineRemoveFromEventList( &( pxQueue->xTasksWaitingToSend ) ) != pdFALSE )
+					{
+						*pxCoRoutineWoken = pdTRUE;
+					}
+					else
+					{
+						mtCOVERAGE_TEST_MARKER();
+					}
+				}
+				else
+				{
+					mtCOVERAGE_TEST_MARKER();
+				}
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+
+			xReturn = pdPASS;
+		}
+		else
+		{
+			xReturn = pdFAIL;
+		}
+
+		return xReturn;
+	}
+
+#endif /* configUSE_CO_ROUTINES */
+/*-----------------------------------------------------------*/
+
+#if ( configQUEUE_REGISTRY_SIZE > 0 )
+
+	void vQueueAddToRegistry( QueueHandle_t xQueue, const char *pcQueueName ) /*lint !e971 Unqualified char types are allowed for strings and single characters only. */
+	{
+	UBaseType_t ux;
+
+		/* See if there is an empty space in the registry.  A NULL name denotes
+		a free slot. */
+		for( ux = ( UBaseType_t ) 0U; ux < ( UBaseType_t ) configQUEUE_REGISTRY_SIZE; ux++ )
+		{
+			if( xQueueRegistry[ ux ].pcQueueName == NULL )
+			{
+				/* Store the information on this queue. */
+				xQueueRegistry[ ux ].pcQueueName = pcQueueName;
+				xQueueRegistry[ ux ].xHandle = xQueue;
+
+				traceQUEUE_REGISTRY_ADD( xQueue, pcQueueName );
+				break;
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+		}
+	}
+
+#endif /* configQUEUE_REGISTRY_SIZE */
+/*-----------------------------------------------------------*/
+
+#if ( configQUEUE_REGISTRY_SIZE > 0 )
+
+	const char *pcQueueGetName( QueueHandle_t xQueue ) /*lint !e971 Unqualified char types are allowed for strings and single characters only. */
+	{
+	UBaseType_t ux;
+	const char *pcReturn = NULL; /*lint !e971 Unqualified char types are allowed for strings and single characters only. */
+
+		/* Note there is nothing here to protect against another task adding or
+		removing entries from the registry while it is being searched. */
+		for( ux = ( UBaseType_t ) 0U; ux < ( UBaseType_t ) configQUEUE_REGISTRY_SIZE; ux++ )
+		{
+			if( xQueueRegistry[ ux ].xHandle == xQueue )
+			{
+				pcReturn = xQueueRegistry[ ux ].pcQueueName;
+				break;
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+		}
+
+		return pcReturn;
+	}
+
+#endif /* configQUEUE_REGISTRY_SIZE */
+/*-----------------------------------------------------------*/
+
+#if ( configQUEUE_REGISTRY_SIZE > 0 )
+
+	void vQueueUnregisterQueue( QueueHandle_t xQueue )
+	{
+	UBaseType_t ux;
+
+		/* See if the handle of the queue being unregistered in actually in the
+		registry. */
+		for( ux = ( UBaseType_t ) 0U; ux < ( UBaseType_t ) configQUEUE_REGISTRY_SIZE; ux++ )
+		{
+			if( xQueueRegistry[ ux ].xHandle == xQueue )
+			{
+				/* Set the name to NULL to show that this slot if free again. */
+				xQueueRegistry[ ux ].pcQueueName = NULL;
+
+				/* Set the handle to NULL to ensure the same queue handle cannot
+				appear in the registry twice if it is added, removed, then
+				added again. */
+				xQueueRegistry[ ux ].xHandle = ( QueueHandle_t ) 0;
+				break;
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+		}
+
+	} /*lint !e818 xQueue could not be pointer to const because it is a typedef. */
+
+#endif /* configQUEUE_REGISTRY_SIZE */
+/*-----------------------------------------------------------*/
+
+#if ( configUSE_TIMERS == 1 )
+
+	void vQueueWaitForMessageRestricted( QueueHandle_t xQueue, TickType_t xTicksToWait, const BaseType_t xWaitIndefinitely )
+	{
+	Queue_t * const pxQueue = ( Queue_t * ) xQueue;
+
+		/* This function should not be called by application code hence the
+		'Restricted' in its name.  It is not part of the public API.  It is
+		designed for use by kernel code, and has special calling requirements.
+		It can result in vListInsert() being called on a list that can only
+		possibly ever have one item in it, so the list will be fast, but even
+		so it should be called with the scheduler locked and not from a critical
+		section. */
+
+		/* Only do anything if there are no messages in the queue.  This function
+		will not actually cause the task to block, just place it on a blocked
+		list.  It will not block until the scheduler is unlocked - at which
+		time a yield will be performed.  If an item is added to the queue while
+		the queue is locked, and the calling task blocks on the queue, then the
+		calling task will be immediately unblocked when the queue is unlocked. */
+		prvLockQueue( pxQueue );
+		if( pxQueue->uxMessagesWaiting == ( UBaseType_t ) 0U )
+		{
+			/* There is nothing in the queue, block for the specified period. */
+			vTaskPlaceOnEventListRestricted( &( pxQueue->xTasksWaitingToReceive ), xTicksToWait, xWaitIndefinitely );
+		}
+		else
+		{
+			mtCOVERAGE_TEST_MARKER();
+		}
+		prvUnlockQueue( pxQueue );
+	}
+
+#endif /* configUSE_TIMERS */
+/*-----------------------------------------------------------*/
+
+#if( ( configUSE_QUEUE_SETS == 1 ) && ( configSUPPORT_DYNAMIC_ALLOCATION == 1 ) )
+
+	QueueSetHandle_t xQueueCreateSet( const UBaseType_t uxEventQueueLength )
+	{
+	QueueSetHandle_t pxQueue;
+
+		pxQueue = xQueueGenericCreate( uxEventQueueLength, sizeof( Queue_t * ), queueQUEUE_TYPE_SET );
+
+		return pxQueue;
+	}
+
+#endif /* configUSE_QUEUE_SETS */
+/*-----------------------------------------------------------*/
+
+#if ( configUSE_QUEUE_SETS == 1 )
+
+	BaseType_t xQueueAddToSet( QueueSetMemberHandle_t xQueueOrSemaphore, QueueSetHandle_t xQueueSet )
+	{
+	BaseType_t xReturn;
+
+		taskENTER_CRITICAL();
+		{
+			if( ( ( Queue_t * ) xQueueOrSemaphore )->pxQueueSetContainer != NULL )
+			{
+				/* Cannot add a queue/semaphore to more than one queue set. */
+				xReturn = pdFAIL;
+			}
+			else if( ( ( Queue_t * ) xQueueOrSemaphore )->uxMessagesWaiting != ( UBaseType_t ) 0 )
+			{
+				/* Cannot add a queue/semaphore to a queue set if there are already
+				items in the queue/semaphore. */
+				xReturn = pdFAIL;
+			}
+			else
+			{
+				( ( Queue_t * ) xQueueOrSemaphore )->pxQueueSetContainer = xQueueSet;
+				xReturn = pdPASS;
+			}
+		}
+		taskEXIT_CRITICAL();
+
+		return xReturn;
+	}
+
+#endif /* configUSE_QUEUE_SETS */
+/*-----------------------------------------------------------*/
+
+#if ( configUSE_QUEUE_SETS == 1 )
+
+	BaseType_t xQueueRemoveFromSet( QueueSetMemberHandle_t xQueueOrSemaphore, QueueSetHandle_t xQueueSet )
+	{
+	BaseType_t xReturn;
+	Queue_t * const pxQueueOrSemaphore = ( Queue_t * ) xQueueOrSemaphore;
+
+		if( pxQueueOrSemaphore->pxQueueSetContainer != xQueueSet )
+		{
+			/* The queue was not a member of the set. */
+			xReturn = pdFAIL;
+		}
+		else if( pxQueueOrSemaphore->uxMessagesWaiting != ( UBaseType_t ) 0 )
+		{
+			/* It is dangerous to remove a queue from a set when the queue is
+			not empty because the queue set will still hold pending events for
+			the queue. */
+			xReturn = pdFAIL;
+		}
+		else
+		{
+			taskENTER_CRITICAL();
+			{
+				/* The queue is no longer contained in the set. */
+				pxQueueOrSemaphore->pxQueueSetContainer = NULL;
+			}
+			taskEXIT_CRITICAL();
+			xReturn = pdPASS;
+		}
+
+		return xReturn;
+	} /*lint !e818 xQueueSet could not be declared as pointing to const as it is a typedef. */
+
+#endif /* configUSE_QUEUE_SETS */
+/*-----------------------------------------------------------*/
+
+#if ( configUSE_QUEUE_SETS == 1 )
+
+	QueueSetMemberHandle_t xQueueSelectFromSet( QueueSetHandle_t xQueueSet, TickType_t const xTicksToWait )
+	{
+	QueueSetMemberHandle_t xReturn = NULL;
+
+		( void ) xQueueGenericReceive( ( QueueHandle_t ) xQueueSet, &xReturn, xTicksToWait, pdFALSE ); /*lint !e961 Casting from one typedef to another is not redundant. */
+		return xReturn;
+	}
+
+#endif /* configUSE_QUEUE_SETS */
+/*-----------------------------------------------------------*/
+
+#if ( configUSE_QUEUE_SETS == 1 )
+
+	QueueSetMemberHandle_t xQueueSelectFromSetFromISR( QueueSetHandle_t xQueueSet )
+	{
+	QueueSetMemberHandle_t xReturn = NULL;
+
+		( void ) xQueueReceiveFromISR( ( QueueHandle_t ) xQueueSet, &xReturn, NULL ); /*lint !e961 Casting from one typedef to another is not redundant. */
+		return xReturn;
+	}
+
+#endif /* configUSE_QUEUE_SETS */
+/*-----------------------------------------------------------*/
+
+#if ( configUSE_QUEUE_SETS == 1 )
+
+	static BaseType_t prvNotifyQueueSetContainer( const Queue_t * const pxQueue, const BaseType_t xCopyPosition )
+	{
+	Queue_t *pxQueueSetContainer = pxQueue->pxQueueSetContainer;
+	BaseType_t xReturn = pdFALSE;
+
+		/* This function must be called form a critical section. */
+
+		configASSERT( pxQueueSetContainer );
+		configASSERT( pxQueueSetContainer->uxMessagesWaiting < pxQueueSetContainer->uxLength );
+
+		if( pxQueueSetContainer->uxMessagesWaiting < pxQueueSetContainer->uxLength )
+		{
+			const int8_t cTxLock = pxQueueSetContainer->cTxLock;
+
+			traceQUEUE_SEND( pxQueueSetContainer );
+
+			/* The data copied is the handle of the queue that contains data. */
+			xReturn = prvCopyDataToQueue( pxQueueSetContainer, &pxQueue, xCopyPosition );
+
+			if( cTxLock == queueUNLOCKED )
+			{
+				if( listLIST_IS_EMPTY( &( pxQueueSetContainer->xTasksWaitingToReceive ) ) == pdFALSE )
+				{
+					if( xTaskRemoveFromEventList( &( pxQueueSetContainer->xTasksWaitingToReceive ) ) != pdFALSE )
+					{
+						/* The task waiting has a higher priority. */
+						xReturn = pdTRUE;
+					}
+					else
+					{
+						mtCOVERAGE_TEST_MARKER();
+					}
+				}
+				else
+				{
+					mtCOVERAGE_TEST_MARKER();
+				}
+			}
+			else
+			{
+				pxQueueSetContainer->cTxLock = ( int8_t ) ( cTxLock + 1 );
+			}
+		}
+		else
+		{
+			mtCOVERAGE_TEST_MARKER();
+		}
+
+		return xReturn;
+	}
+
+#endif /* configUSE_QUEUE_SETS */
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/FreeRTOS/readme.txt b/FreeRTOS/readme.txt
new file mode 100644
index 0000000..58480c5
--- /dev/null
+++ b/FreeRTOS/readme.txt
@@ -0,0 +1,17 @@
+Each real time kernel port consists of three files that contain the core kernel
+components and are common to every port, and one or more files that are 
+specific to a particular microcontroller and or compiler.
+
++ The FreeRTOS/Source directory contains the three files that are common to 
+every port - list.c, queue.c and tasks.c.  The kernel is contained within these 
+three files.  croutine.c implements the optional co-routine functionality - which
+is normally only used on very memory limited systems.
+
++ The FreeRTOS/Source/Portable directory contains the files that are specific to 
+a particular microcontroller and or compiler.
+
++ The FreeRTOS/Source/include directory contains the real time kernel header 
+files.
+
+See the readme file in the FreeRTOS/Source/Portable directory for more 
+information.
\ No newline at end of file
diff --git a/FreeRTOS/tasks.c b/FreeRTOS/tasks.c
new file mode 100644
index 0000000..6c261a6
--- /dev/null
+++ b/FreeRTOS/tasks.c
@@ -0,0 +1,4807 @@
+/*
+    FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd.
+    All rights reserved
+
+    VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION.
+
+    This file is part of the FreeRTOS distribution.
+
+    FreeRTOS is free software; you can redistribute it and/or modify it under
+    the terms of the GNU General Public License (version 2) as published by the
+    Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception.
+
+    ***************************************************************************
+    >>!   NOTE: The modification to the GPL is included to allow you to     !<<
+    >>!   distribute a combined work that includes FreeRTOS without being   !<<
+    >>!   obliged to provide the source code for proprietary components     !<<
+    >>!   outside of the FreeRTOS kernel.                                   !<<
+    ***************************************************************************
+
+    FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY
+    WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+    FOR A PARTICULAR PURPOSE.  Full license text is available on the following
+    link: http://www.freertos.org/a00114.html
+
+    ***************************************************************************
+     *                                                                       *
+     *    FreeRTOS provides completely free yet professionally developed,    *
+     *    robust, strictly quality controlled, supported, and cross          *
+     *    platform software that is more than just the market leader, it     *
+     *    is the industry's de facto standard.                               *
+     *                                                                       *
+     *    Help yourself get started quickly while simultaneously helping     *
+     *    to support the FreeRTOS project by purchasing a FreeRTOS           *
+     *    tutorial book, reference manual, or both:                          *
+     *    http://www.FreeRTOS.org/Documentation                              *
+     *                                                                       *
+    ***************************************************************************
+
+    http://www.FreeRTOS.org/FAQHelp.html - Having a problem?  Start by reading
+    the FAQ page "My application does not run, what could be wrong?".  Have you
+    defined configASSERT()?
+
+    http://www.FreeRTOS.org/support - In return for receiving this top quality
+    embedded software for free we request you assist our global community by
+    participating in the support forum.
+
+    http://www.FreeRTOS.org/training - Investing in training allows your team to
+    be as productive as possible as early as possible.  Now you can receive
+    FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers
+    Ltd, and the world's leading authority on the world's leading RTOS.
+
+    http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products,
+    including FreeRTOS+Trace - an indispensable productivity tool, a DOS
+    compatible FAT file system, and our tiny thread aware UDP/IP stack.
+
+    http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate.
+    Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS.
+
+    http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High
+    Integrity Systems ltd. to sell under the OpenRTOS brand.  Low cost OpenRTOS
+    licenses offer ticketed support, indemnification and commercial middleware.
+
+    http://www.SafeRTOS.com - High Integrity Systems also provide a safety
+    engineered and independently SIL3 certified version for use in safety and
+    mission critical applications that require provable dependability.
+
+    1 tab == 4 spaces!
+*/
+
+/* Standard includes. */
+#include 
+#include 
+
+/* Defining MPU_WRAPPERS_INCLUDED_FROM_API_FILE prevents task.h from redefining
+all the API functions to use the MPU wrappers.  That should only be done when
+task.h is included from an application file. */
+#define MPU_WRAPPERS_INCLUDED_FROM_API_FILE
+
+/* FreeRTOS includes. */
+#include "FreeRTOS.h"
+#include "task.h"
+#include "timers.h"
+#include "StackMacros.h"
+
+/* Lint e961 and e750 are suppressed as a MISRA exception justified because the
+MPU ports require MPU_WRAPPERS_INCLUDED_FROM_API_FILE to be defined for the
+header files above, but not in this file, in order to generate the correct
+privileged Vs unprivileged linkage and placement. */
+#undef MPU_WRAPPERS_INCLUDED_FROM_API_FILE /*lint !e961 !e750. */
+
+/* Set configUSE_STATS_FORMATTING_FUNCTIONS to 2 to include the stats formatting
+functions but without including stdio.h here. */
+#if ( configUSE_STATS_FORMATTING_FUNCTIONS == 1 )
+	/* At the bottom of this file are two optional functions that can be used
+	to generate human readable text from the raw data generated by the
+	uxTaskGetSystemState() function.  Note the formatting functions are provided
+	for convenience only, and are NOT considered part of the kernel. */
+	#include 
+#endif /* configUSE_STATS_FORMATTING_FUNCTIONS == 1 ) */
+
+#if( configUSE_PREEMPTION == 0 )
+	/* If the cooperative scheduler is being used then a yield should not be
+	performed just because a higher priority task has been woken. */
+	#define taskYIELD_IF_USING_PREEMPTION()
+#else
+	#define taskYIELD_IF_USING_PREEMPTION() portYIELD_WITHIN_API()
+#endif
+
+/* Values that can be assigned to the ucNotifyState member of the TCB. */
+#define taskNOT_WAITING_NOTIFICATION	( ( uint8_t ) 0 )
+#define taskWAITING_NOTIFICATION		( ( uint8_t ) 1 )
+#define taskNOTIFICATION_RECEIVED		( ( uint8_t ) 2 )
+
+/*
+ * The value used to fill the stack of a task when the task is created.  This
+ * is used purely for checking the high water mark for tasks.
+ */
+#define tskSTACK_FILL_BYTE	( 0xa5U )
+
+/* Sometimes the FreeRTOSConfig.h settings only allow a task to be created using
+dynamically allocated RAM, in which case when any task is deleted it is known
+that both the task's stack and TCB need to be freed.  Sometimes the
+FreeRTOSConfig.h settings only allow a task to be created using statically
+allocated RAM, in which case when any task is deleted it is known that neither
+the task's stack or TCB should be freed.  Sometimes the FreeRTOSConfig.h
+settings allow a task to be created using either statically or dynamically
+allocated RAM, in which case a member of the TCB is used to record whether the
+stack and/or TCB were allocated statically or dynamically, so when a task is
+deleted the RAM that was allocated dynamically is freed again and no attempt is
+made to free the RAM that was allocated statically.
+tskSTATIC_AND_DYNAMIC_ALLOCATION_POSSIBLE is only true if it is possible for a
+task to be created using either statically or dynamically allocated RAM.  Note
+that if portUSING_MPU_WRAPPERS is 1 then a protected task can be created with
+a statically allocated stack and a dynamically allocated TCB. */
+#define tskSTATIC_AND_DYNAMIC_ALLOCATION_POSSIBLE ( ( ( configSUPPORT_STATIC_ALLOCATION == 1 ) && ( configSUPPORT_DYNAMIC_ALLOCATION == 1 ) ) || ( portUSING_MPU_WRAPPERS == 1 ) )
+#define tskDYNAMICALLY_ALLOCATED_STACK_AND_TCB 		( ( uint8_t ) 0 )
+#define tskSTATICALLY_ALLOCATED_STACK_ONLY 			( ( uint8_t ) 1 )
+#define tskSTATICALLY_ALLOCATED_STACK_AND_TCB		( ( uint8_t ) 2 )
+
+/*
+ * Macros used by vListTask to indicate which state a task is in.
+ */
+#define tskBLOCKED_CHAR		( 'B' )
+#define tskREADY_CHAR		( 'R' )
+#define tskDELETED_CHAR		( 'D' )
+#define tskSUSPENDED_CHAR	( 'S' )
+
+/*
+ * Some kernel aware debuggers require the data the debugger needs access to be
+ * global, rather than file scope.
+ */
+#ifdef portREMOVE_STATIC_QUALIFIER
+	#define static
+#endif
+
+#if ( configUSE_PORT_OPTIMISED_TASK_SELECTION == 0 )
+
+	/* If configUSE_PORT_OPTIMISED_TASK_SELECTION is 0 then task selection is
+	performed in a generic way that is not optimised to any particular
+	microcontroller architecture. */
+
+	/* uxTopReadyPriority holds the priority of the highest priority ready
+	state task. */
+	#define taskRECORD_READY_PRIORITY( uxPriority )														\
+	{																									\
+		if( ( uxPriority ) > uxTopReadyPriority )														\
+		{																								\
+			uxTopReadyPriority = ( uxPriority );														\
+		}																								\
+	} /* taskRECORD_READY_PRIORITY */
+
+	/*-----------------------------------------------------------*/
+
+	#define taskSELECT_HIGHEST_PRIORITY_TASK()															\
+	{																									\
+	UBaseType_t uxTopPriority = uxTopReadyPriority;														\
+																										\
+		/* Find the highest priority queue that contains ready tasks. */								\
+		while( listLIST_IS_EMPTY( &( pxReadyTasksLists[ uxTopPriority ] ) ) )							\
+		{																								\
+			configASSERT( uxTopPriority );																\
+			--uxTopPriority;																			\
+		}																								\
+																										\
+		/* listGET_OWNER_OF_NEXT_ENTRY indexes through the list, so the tasks of						\
+		the	same priority get an equal share of the processor time. */									\
+		listGET_OWNER_OF_NEXT_ENTRY( pxCurrentTCB, &( pxReadyTasksLists[ uxTopPriority ] ) );			\
+		uxTopReadyPriority = uxTopPriority;																\
+	} /* taskSELECT_HIGHEST_PRIORITY_TASK */
+
+	/*-----------------------------------------------------------*/
+
+	/* Define away taskRESET_READY_PRIORITY() and portRESET_READY_PRIORITY() as
+	they are only required when a port optimised method of task selection is
+	being used. */
+	#define taskRESET_READY_PRIORITY( uxPriority )
+	#define portRESET_READY_PRIORITY( uxPriority, uxTopReadyPriority )
+
+#else /* configUSE_PORT_OPTIMISED_TASK_SELECTION */
+
+	/* If configUSE_PORT_OPTIMISED_TASK_SELECTION is 1 then task selection is
+	performed in a way that is tailored to the particular microcontroller
+	architecture being used. */
+
+	/* A port optimised version is provided.  Call the port defined macros. */
+	#define taskRECORD_READY_PRIORITY( uxPriority )	portRECORD_READY_PRIORITY( uxPriority, uxTopReadyPriority )
+
+	/*-----------------------------------------------------------*/
+
+	#define taskSELECT_HIGHEST_PRIORITY_TASK()														\
+	{																								\
+	UBaseType_t uxTopPriority;																		\
+																									\
+		/* Find the highest priority list that contains ready tasks. */								\
+		portGET_HIGHEST_PRIORITY( uxTopPriority, uxTopReadyPriority );								\
+		configASSERT( listCURRENT_LIST_LENGTH( &( pxReadyTasksLists[ uxTopPriority ] ) ) > 0 );		\
+		listGET_OWNER_OF_NEXT_ENTRY( pxCurrentTCB, &( pxReadyTasksLists[ uxTopPriority ] ) );		\
+	} /* taskSELECT_HIGHEST_PRIORITY_TASK() */
+
+	/*-----------------------------------------------------------*/
+
+	/* A port optimised version is provided, call it only if the TCB being reset
+	is being referenced from a ready list.  If it is referenced from a delayed
+	or suspended list then it won't be in a ready list. */
+	#define taskRESET_READY_PRIORITY( uxPriority )														\
+	{																									\
+		if( listCURRENT_LIST_LENGTH( &( pxReadyTasksLists[ ( uxPriority ) ] ) ) == ( UBaseType_t ) 0 )	\
+		{																								\
+			portRESET_READY_PRIORITY( ( uxPriority ), ( uxTopReadyPriority ) );							\
+		}																								\
+	}
+
+#endif /* configUSE_PORT_OPTIMISED_TASK_SELECTION */
+
+/*-----------------------------------------------------------*/
+
+/* pxDelayedTaskList and pxOverflowDelayedTaskList are switched when the tick
+count overflows. */
+#define taskSWITCH_DELAYED_LISTS()																	\
+{																									\
+	List_t *pxTemp;																					\
+																									\
+	/* The delayed tasks list should be empty when the lists are switched. */						\
+	configASSERT( ( listLIST_IS_EMPTY( pxDelayedTaskList ) ) );										\
+																									\
+	pxTemp = pxDelayedTaskList;																		\
+	pxDelayedTaskList = pxOverflowDelayedTaskList;													\
+	pxOverflowDelayedTaskList = pxTemp;																\
+	xNumOfOverflows++;																				\
+	prvResetNextTaskUnblockTime();																	\
+}
+
+/*-----------------------------------------------------------*/
+
+/*
+ * Place the task represented by pxTCB into the appropriate ready list for
+ * the task.  It is inserted at the end of the list.
+ */
+#define prvAddTaskToReadyList( pxTCB )																\
+	traceMOVED_TASK_TO_READY_STATE( pxTCB );														\
+	taskRECORD_READY_PRIORITY( ( pxTCB )->uxPriority );												\
+	vListInsertEnd( &( pxReadyTasksLists[ ( pxTCB )->uxPriority ] ), &( ( pxTCB )->xStateListItem ) ); \
+	tracePOST_MOVED_TASK_TO_READY_STATE( pxTCB )
+/*-----------------------------------------------------------*/
+
+/*
+ * Several functions take an TaskHandle_t parameter that can optionally be NULL,
+ * where NULL is used to indicate that the handle of the currently executing
+ * task should be used in place of the parameter.  This macro simply checks to
+ * see if the parameter is NULL and returns a pointer to the appropriate TCB.
+ */
+#define prvGetTCBFromHandle( pxHandle ) ( ( ( pxHandle ) == NULL ) ? ( TCB_t * ) pxCurrentTCB : ( TCB_t * ) ( pxHandle ) )
+
+/* The item value of the event list item is normally used to hold the priority
+of the task to which it belongs (coded to allow it to be held in reverse
+priority order).  However, it is occasionally borrowed for other purposes.  It
+is important its value is not updated due to a task priority change while it is
+being used for another purpose.  The following bit definition is used to inform
+the scheduler that the value should not be changed - in which case it is the
+responsibility of whichever module is using the value to ensure it gets set back
+to its original value when it is released. */
+#if( configUSE_16_BIT_TICKS == 1 )
+	#define taskEVENT_LIST_ITEM_VALUE_IN_USE	0x8000U
+#else
+	#define taskEVENT_LIST_ITEM_VALUE_IN_USE	0x80000000UL
+#endif
+
+/*
+ * Task control block.  A task control block (TCB) is allocated for each task,
+ * and stores task state information, including a pointer to the task's context
+ * (the task's run time environment, including register values)
+ */
+typedef struct tskTaskControlBlock
+{
+	volatile StackType_t	*pxTopOfStack;	/*< Points to the location of the last item placed on the tasks stack.  THIS MUST BE THE FIRST MEMBER OF THE TCB STRUCT. */
+
+	#if ( portUSING_MPU_WRAPPERS == 1 )
+		xMPU_SETTINGS	xMPUSettings;		/*< The MPU settings are defined as part of the port layer.  THIS MUST BE THE SECOND MEMBER OF THE TCB STRUCT. */
+	#endif
+
+	ListItem_t			xStateListItem;	/*< The list that the state list item of a task is reference from denotes the state of that task (Ready, Blocked, Suspended ). */
+	ListItem_t			xEventListItem;		/*< Used to reference a task from an event list. */
+	UBaseType_t			uxPriority;			/*< The priority of the task.  0 is the lowest priority. */
+	StackType_t			*pxStack;			/*< Points to the start of the stack. */
+	char				pcTaskName[ configMAX_TASK_NAME_LEN ];/*< Descriptive name given to the task when created.  Facilitates debugging only. */ /*lint !e971 Unqualified char types are allowed for strings and single characters only. */
+
+	#if ( portSTACK_GROWTH > 0 )
+		StackType_t		*pxEndOfStack;		/*< Points to the end of the stack on architectures where the stack grows up from low memory. */
+	#endif
+
+	#if ( portCRITICAL_NESTING_IN_TCB == 1 )
+		UBaseType_t		uxCriticalNesting;	/*< Holds the critical section nesting depth for ports that do not maintain their own count in the port layer. */
+	#endif
+
+	#if ( configUSE_TRACE_FACILITY == 1 )
+		UBaseType_t		uxTCBNumber;		/*< Stores a number that increments each time a TCB is created.  It allows debuggers to determine when a task has been deleted and then recreated. */
+		UBaseType_t		uxTaskNumber;		/*< Stores a number specifically for use by third party trace code. */
+	#endif
+
+	#if ( configUSE_MUTEXES == 1 )
+		UBaseType_t		uxBasePriority;		/*< The priority last assigned to the task - used by the priority inheritance mechanism. */
+		UBaseType_t		uxMutexesHeld;
+	#endif
+
+	#if ( configUSE_APPLICATION_TASK_TAG == 1 )
+		TaskHookFunction_t pxTaskTag;
+	#endif
+
+	#if( configNUM_THREAD_LOCAL_STORAGE_POINTERS > 0 )
+		void *pvThreadLocalStoragePointers[ configNUM_THREAD_LOCAL_STORAGE_POINTERS ];
+	#endif
+
+	#if( configGENERATE_RUN_TIME_STATS == 1 )
+		uint32_t		ulRunTimeCounter;	/*< Stores the amount of time the task has spent in the Running state. */
+	#endif
+
+	#if ( configUSE_NEWLIB_REENTRANT == 1 )
+		/* Allocate a Newlib reent structure that is specific to this task.
+		Note Newlib support has been included by popular demand, but is not
+		used by the FreeRTOS maintainers themselves.  FreeRTOS is not
+		responsible for resulting newlib operation.  User must be familiar with
+		newlib and must provide system-wide implementations of the necessary
+		stubs. Be warned that (at the time of writing) the current newlib design
+		implements a system-wide malloc() that must be provided with locks. */
+		struct	_reent xNewLib_reent;
+	#endif
+
+	#if( configUSE_TASK_NOTIFICATIONS == 1 )
+		volatile uint32_t ulNotifiedValue;
+		volatile uint8_t ucNotifyState;
+	#endif
+
+	/* See the comments above the definition of
+	tskSTATIC_AND_DYNAMIC_ALLOCATION_POSSIBLE. */
+	#if( tskSTATIC_AND_DYNAMIC_ALLOCATION_POSSIBLE != 0 )
+		uint8_t	ucStaticallyAllocated; 		/*< Set to pdTRUE if the task is a statically allocated to ensure no attempt is made to free the memory. */
+	#endif
+
+	#if( INCLUDE_xTaskAbortDelay == 1 )
+		uint8_t ucDelayAborted;
+	#endif
+
+} tskTCB;
+
+/* The old tskTCB name is maintained above then typedefed to the new TCB_t name
+below to enable the use of older kernel aware debuggers. */
+typedef tskTCB TCB_t;
+
+/*lint -e956 A manual analysis and inspection has been used to determine which
+static variables must be declared volatile. */
+
+PRIVILEGED_DATA TCB_t * volatile pxCurrentTCB = NULL;
+
+/* Lists for ready and blocked tasks. --------------------*/
+PRIVILEGED_DATA static List_t pxReadyTasksLists[ configMAX_PRIORITIES ];/*< Prioritised ready tasks. */
+PRIVILEGED_DATA static List_t xDelayedTaskList1;						/*< Delayed tasks. */
+PRIVILEGED_DATA static List_t xDelayedTaskList2;						/*< Delayed tasks (two lists are used - one for delays that have overflowed the current tick count. */
+PRIVILEGED_DATA static List_t * volatile pxDelayedTaskList;				/*< Points to the delayed task list currently being used. */
+PRIVILEGED_DATA static List_t * volatile pxOverflowDelayedTaskList;		/*< Points to the delayed task list currently being used to hold tasks that have overflowed the current tick count. */
+PRIVILEGED_DATA static List_t xPendingReadyList;						/*< Tasks that have been readied while the scheduler was suspended.  They will be moved to the ready list when the scheduler is resumed. */
+
+#if( INCLUDE_vTaskDelete == 1 )
+
+	PRIVILEGED_DATA static List_t xTasksWaitingTermination;				/*< Tasks that have been deleted - but their memory not yet freed. */
+	PRIVILEGED_DATA static volatile UBaseType_t uxDeletedTasksWaitingCleanUp = ( UBaseType_t ) 0U;
+
+#endif
+
+#if ( INCLUDE_vTaskSuspend == 1 )
+
+	PRIVILEGED_DATA static List_t xSuspendedTaskList;					/*< Tasks that are currently suspended. */
+
+#endif
+
+/* Other file private variables. --------------------------------*/
+PRIVILEGED_DATA static volatile UBaseType_t uxCurrentNumberOfTasks 	= ( UBaseType_t ) 0U;
+PRIVILEGED_DATA static volatile TickType_t xTickCount 				= ( TickType_t ) 0U;
+PRIVILEGED_DATA static volatile UBaseType_t uxTopReadyPriority 		= tskIDLE_PRIORITY;
+PRIVILEGED_DATA static volatile BaseType_t xSchedulerRunning 		= pdFALSE;
+PRIVILEGED_DATA static volatile UBaseType_t uxPendedTicks 			= ( UBaseType_t ) 0U;
+PRIVILEGED_DATA static volatile BaseType_t xYieldPending 			= pdFALSE;
+PRIVILEGED_DATA static volatile BaseType_t xNumOfOverflows 			= ( BaseType_t ) 0;
+PRIVILEGED_DATA static UBaseType_t uxTaskNumber 					= ( UBaseType_t ) 0U;
+PRIVILEGED_DATA static volatile TickType_t xNextTaskUnblockTime		= ( TickType_t ) 0U; /* Initialised to portMAX_DELAY before the scheduler starts. */
+PRIVILEGED_DATA static TaskHandle_t xIdleTaskHandle					= NULL;			/*< Holds the handle of the idle task.  The idle task is created automatically when the scheduler is started. */
+
+/* Context switches are held pending while the scheduler is suspended.  Also,
+interrupts must not manipulate the xStateListItem of a TCB, or any of the
+lists the xStateListItem can be referenced from, if the scheduler is suspended.
+If an interrupt needs to unblock a task while the scheduler is suspended then it
+moves the task's event list item into the xPendingReadyList, ready for the
+kernel to move the task from the pending ready list into the real ready list
+when the scheduler is unsuspended.  The pending ready list itself can only be
+accessed from a critical section. */
+PRIVILEGED_DATA static volatile UBaseType_t uxSchedulerSuspended	= ( UBaseType_t ) pdFALSE;
+
+#if ( configGENERATE_RUN_TIME_STATS == 1 )
+
+	PRIVILEGED_DATA static uint32_t ulTaskSwitchedInTime = 0UL;	/*< Holds the value of a timer/counter the last time a task was switched in. */
+	PRIVILEGED_DATA static uint32_t ulTotalRunTime = 0UL;		/*< Holds the total amount of execution time as defined by the run time counter clock. */
+
+#endif
+
+/*lint +e956 */
+
+/*-----------------------------------------------------------*/
+
+/* Callback function prototypes. --------------------------*/
+#if(  configCHECK_FOR_STACK_OVERFLOW > 0 )
+	extern void vApplicationStackOverflowHook( TaskHandle_t xTask, char *pcTaskName );
+#endif
+
+#if( configUSE_TICK_HOOK > 0 )
+	extern void vApplicationTickHook( void );
+#endif
+
+#if( configSUPPORT_STATIC_ALLOCATION == 1 )
+	extern void vApplicationGetIdleTaskMemory( StaticTask_t **ppxIdleTaskTCBBuffer, StackType_t **ppxIdleTaskStackBuffer, uint32_t *pulIdleTaskStackSize );
+#endif
+
+/* File private functions. --------------------------------*/
+
+/**
+ * Utility task that simply returns pdTRUE if the task referenced by xTask is
+ * currently in the Suspended state, or pdFALSE if the task referenced by xTask
+ * is in any other state.
+ */
+#if ( INCLUDE_vTaskSuspend == 1 )
+	static BaseType_t prvTaskIsTaskSuspended( const TaskHandle_t xTask ) PRIVILEGED_FUNCTION;
+#endif /* INCLUDE_vTaskSuspend */
+
+/*
+ * Utility to ready all the lists used by the scheduler.  This is called
+ * automatically upon the creation of the first task.
+ */
+static void prvInitialiseTaskLists( void ) PRIVILEGED_FUNCTION;
+
+/*
+ * The idle task, which as all tasks is implemented as a never ending loop.
+ * The idle task is automatically created and added to the ready lists upon
+ * creation of the first user task.
+ *
+ * The portTASK_FUNCTION_PROTO() macro is used to allow port/compiler specific
+ * language extensions.  The equivalent prototype for this function is:
+ *
+ * void prvIdleTask( void *pvParameters );
+ *
+ */
+static portTASK_FUNCTION_PROTO( prvIdleTask, pvParameters );
+
+/*
+ * Utility to free all memory allocated by the scheduler to hold a TCB,
+ * including the stack pointed to by the TCB.
+ *
+ * This does not free memory allocated by the task itself (i.e. memory
+ * allocated by calls to pvPortMalloc from within the tasks application code).
+ */
+#if ( INCLUDE_vTaskDelete == 1 )
+
+	static void prvDeleteTCB( TCB_t *pxTCB ) PRIVILEGED_FUNCTION;
+
+#endif
+
+/*
+ * Used only by the idle task.  This checks to see if anything has been placed
+ * in the list of tasks waiting to be deleted.  If so the task is cleaned up
+ * and its TCB deleted.
+ */
+static void prvCheckTasksWaitingTermination( void ) PRIVILEGED_FUNCTION;
+
+/*
+ * The currently executing task is entering the Blocked state.  Add the task to
+ * either the current or the overflow delayed task list.
+ */
+static void prvAddCurrentTaskToDelayedList( TickType_t xTicksToWait, const BaseType_t xCanBlockIndefinitely ) PRIVILEGED_FUNCTION;
+
+/*
+ * Fills an TaskStatus_t structure with information on each task that is
+ * referenced from the pxList list (which may be a ready list, a delayed list,
+ * a suspended list, etc.).
+ *
+ * THIS FUNCTION IS INTENDED FOR DEBUGGING ONLY, AND SHOULD NOT BE CALLED FROM
+ * NORMAL APPLICATION CODE.
+ */
+#if ( configUSE_TRACE_FACILITY == 1 )
+
+	static UBaseType_t prvListTasksWithinSingleList( TaskStatus_t *pxTaskStatusArray, List_t *pxList, eTaskState eState ) PRIVILEGED_FUNCTION;
+
+#endif
+
+/*
+ * Searches pxList for a task with name pcNameToQuery - returning a handle to
+ * the task if it is found, or NULL if the task is not found.
+ */
+#if ( INCLUDE_xTaskGetHandle == 1 )
+
+	static TCB_t *prvSearchForNameWithinSingleList( List_t *pxList, const char pcNameToQuery[] ) PRIVILEGED_FUNCTION;
+
+#endif
+
+/*
+ * When a task is created, the stack of the task is filled with a known value.
+ * This function determines the 'high water mark' of the task stack by
+ * determining how much of the stack remains at the original preset value.
+ */
+#if ( ( configUSE_TRACE_FACILITY == 1 ) || ( INCLUDE_uxTaskGetStackHighWaterMark == 1 ) )
+
+	static uint16_t prvTaskCheckFreeStackSpace( const uint8_t * pucStackByte ) PRIVILEGED_FUNCTION;
+
+#endif
+
+/*
+ * Return the amount of time, in ticks, that will pass before the kernel will
+ * next move a task from the Blocked state to the Running state.
+ *
+ * This conditional compilation should use inequality to 0, not equality to 1.
+ * This is to ensure portSUPPRESS_TICKS_AND_SLEEP() can be called when user
+ * defined low power mode implementations require configUSE_TICKLESS_IDLE to be
+ * set to a value other than 1.
+ */
+#if ( configUSE_TICKLESS_IDLE != 0 )
+
+	static TickType_t prvGetExpectedIdleTime( void ) PRIVILEGED_FUNCTION;
+
+#endif
+
+/*
+ * Set xNextTaskUnblockTime to the time at which the next Blocked state task
+ * will exit the Blocked state.
+ */
+static void prvResetNextTaskUnblockTime( void );
+
+#if ( ( configUSE_TRACE_FACILITY == 1 ) && ( configUSE_STATS_FORMATTING_FUNCTIONS > 0 ) )
+
+	/*
+	 * Helper function used to pad task names with spaces when printing out
+	 * human readable tables of task information.
+	 */
+	static char *prvWriteNameToBuffer( char *pcBuffer, const char *pcTaskName ) PRIVILEGED_FUNCTION;
+
+#endif
+
+/*
+ * Called after a Task_t structure has been allocated either statically or
+ * dynamically to fill in the structure's members.
+ */
+static void prvInitialiseNewTask( 	TaskFunction_t pxTaskCode,
+									const char * const pcName,
+									const uint32_t ulStackDepth,
+									void * const pvParameters,
+									UBaseType_t uxPriority,
+									TaskHandle_t * const pxCreatedTask,
+									TCB_t *pxNewTCB,
+									const MemoryRegion_t * const xRegions ) PRIVILEGED_FUNCTION; /*lint !e971 Unqualified char types are allowed for strings and single characters only. */
+
+/*
+ * Called after a new task has been created and initialised to place the task
+ * under the control of the scheduler.
+ */
+static void prvAddNewTaskToReadyList( TCB_t *pxNewTCB ) PRIVILEGED_FUNCTION;
+
+/*-----------------------------------------------------------*/
+
+#if( configSUPPORT_STATIC_ALLOCATION == 1 )
+
+	TaskHandle_t xTaskCreateStatic(	TaskFunction_t pxTaskCode,
+									const char * const pcName,
+									const uint32_t ulStackDepth,
+									void * const pvParameters,
+									UBaseType_t uxPriority,
+									StackType_t * const puxStackBuffer,
+									StaticTask_t * const pxTaskBuffer ) /*lint !e971 Unqualified char types are allowed for strings and single characters only. */
+	{
+	TCB_t *pxNewTCB;
+	TaskHandle_t xReturn;
+
+		configASSERT( puxStackBuffer != NULL );
+		configASSERT( pxTaskBuffer != NULL );
+
+		if( ( pxTaskBuffer != NULL ) && ( puxStackBuffer != NULL ) )
+		{
+			/* The memory used for the task's TCB and stack are passed into this
+			function - use them. */
+			pxNewTCB = ( TCB_t * ) pxTaskBuffer; /*lint !e740 Unusual cast is ok as the structures are designed to have the same alignment, and the size is checked by an assert. */
+			pxNewTCB->pxStack = ( StackType_t * ) puxStackBuffer;
+
+			#if( tskSTATIC_AND_DYNAMIC_ALLOCATION_POSSIBLE != 0 )
+			{
+				/* Tasks can be created statically or dynamically, so note this
+				task was created statically in case the task is later deleted. */
+				pxNewTCB->ucStaticallyAllocated = tskSTATICALLY_ALLOCATED_STACK_AND_TCB;
+			}
+			#endif /* configSUPPORT_DYNAMIC_ALLOCATION */
+
+			prvInitialiseNewTask( pxTaskCode, pcName, ulStackDepth, pvParameters, uxPriority, &xReturn, pxNewTCB, NULL );
+			prvAddNewTaskToReadyList( pxNewTCB );
+		}
+		else
+		{
+			xReturn = NULL;
+		}
+
+		return xReturn;
+	}
+
+#endif /* SUPPORT_STATIC_ALLOCATION */
+/*-----------------------------------------------------------*/
+
+#if( portUSING_MPU_WRAPPERS == 1 )
+
+	BaseType_t xTaskCreateRestricted( const TaskParameters_t * const pxTaskDefinition, TaskHandle_t *pxCreatedTask )
+	{
+	TCB_t *pxNewTCB;
+	BaseType_t xReturn = errCOULD_NOT_ALLOCATE_REQUIRED_MEMORY;
+
+		configASSERT( pxTaskDefinition->puxStackBuffer );
+
+		if( pxTaskDefinition->puxStackBuffer != NULL )
+		{
+			/* Allocate space for the TCB.  Where the memory comes from depends
+			on the implementation of the port malloc function and whether or
+			not static allocation is being used. */
+			pxNewTCB = ( TCB_t * ) pvPortMalloc( sizeof( TCB_t ) );
+
+			if( pxNewTCB != NULL )
+			{
+				/* Store the stack location in the TCB. */
+				pxNewTCB->pxStack = pxTaskDefinition->puxStackBuffer;
+
+				/* Tasks can be created statically or dynamically, so note
+				this task had a statically allocated stack in case it is
+				later deleted.  The TCB was allocated dynamically. */
+				pxNewTCB->ucStaticallyAllocated = tskSTATICALLY_ALLOCATED_STACK_ONLY;
+
+				prvInitialiseNewTask(	pxTaskDefinition->pvTaskCode,
+										pxTaskDefinition->pcName,
+										( uint32_t ) pxTaskDefinition->usStackDepth,
+										pxTaskDefinition->pvParameters,
+										pxTaskDefinition->uxPriority,
+										pxCreatedTask, pxNewTCB,
+										pxTaskDefinition->xRegions );
+
+				prvAddNewTaskToReadyList( pxNewTCB );
+				xReturn = pdPASS;
+			}
+		}
+
+		return xReturn;
+	}
+
+#endif /* portUSING_MPU_WRAPPERS */
+/*-----------------------------------------------------------*/
+
+#if( configSUPPORT_DYNAMIC_ALLOCATION == 1 )
+
+	BaseType_t xTaskCreate(	TaskFunction_t pxTaskCode,
+							const char * const pcName,
+							const uint16_t usStackDepth,
+							void * const pvParameters,
+							UBaseType_t uxPriority,
+							TaskHandle_t * const pxCreatedTask ) /*lint !e971 Unqualified char types are allowed for strings and single characters only. */
+	{
+	TCB_t *pxNewTCB;
+	BaseType_t xReturn;
+
+		/* If the stack grows down then allocate the stack then the TCB so the stack
+		does not grow into the TCB.  Likewise if the stack grows up then allocate
+		the TCB then the stack. */
+		#if( portSTACK_GROWTH > 0 )
+		{
+			/* Allocate space for the TCB.  Where the memory comes from depends on
+			the implementation of the port malloc function and whether or not static
+			allocation is being used. */
+			pxNewTCB = ( TCB_t * ) pvPortMalloc( sizeof( TCB_t ) );
+
+			if( pxNewTCB != NULL )
+			{
+				/* Allocate space for the stack used by the task being created.
+				The base of the stack memory stored in the TCB so the task can
+				be deleted later if required. */
+				pxNewTCB->pxStack = ( StackType_t * ) pvPortMalloc( ( ( ( size_t ) usStackDepth ) * sizeof( StackType_t ) ) ); /*lint !e961 MISRA exception as the casts are only redundant for some ports. */
+
+				if( pxNewTCB->pxStack == NULL )
+				{
+					/* Could not allocate the stack.  Delete the allocated TCB. */
+					vPortFree( pxNewTCB );
+					pxNewTCB = NULL;
+				}
+			}
+		}
+		#else /* portSTACK_GROWTH */
+		{
+		StackType_t *pxStack;
+
+			/* Allocate space for the stack used by the task being created. */
+			pxStack = ( StackType_t * ) pvPortMalloc( ( ( ( size_t ) usStackDepth ) * sizeof( StackType_t ) ) ); /*lint !e961 MISRA exception as the casts are only redundant for some ports. */
+
+			if( pxStack != NULL )
+			{
+				/* Allocate space for the TCB. */
+				pxNewTCB = ( TCB_t * ) pvPortMalloc( sizeof( TCB_t ) ); /*lint !e961 MISRA exception as the casts are only redundant for some paths. */
+
+				if( pxNewTCB != NULL )
+				{
+					/* Store the stack location in the TCB. */
+					pxNewTCB->pxStack = pxStack;
+				}
+				else
+				{
+					/* The stack cannot be used as the TCB was not created.  Free
+					it again. */
+					vPortFree( pxStack );
+				}
+			}
+			else
+			{
+				pxNewTCB = NULL;
+			}
+		}
+		#endif /* portSTACK_GROWTH */
+
+		if( pxNewTCB != NULL )
+		{
+			#if( tskSTATIC_AND_DYNAMIC_ALLOCATION_POSSIBLE != 0 )
+			{
+				/* Tasks can be created statically or dynamically, so note this
+				task was created dynamically in case it is later deleted. */
+				pxNewTCB->ucStaticallyAllocated = tskDYNAMICALLY_ALLOCATED_STACK_AND_TCB;
+			}
+			#endif /* configSUPPORT_STATIC_ALLOCATION */
+
+			prvInitialiseNewTask( pxTaskCode, pcName, ( uint32_t ) usStackDepth, pvParameters, uxPriority, pxCreatedTask, pxNewTCB, NULL );
+			prvAddNewTaskToReadyList( pxNewTCB );
+			xReturn = pdPASS;
+		}
+		else
+		{
+			xReturn = errCOULD_NOT_ALLOCATE_REQUIRED_MEMORY;
+		}
+
+		return xReturn;
+	}
+
+#endif /* configSUPPORT_DYNAMIC_ALLOCATION */
+/*-----------------------------------------------------------*/
+
+static void prvInitialiseNewTask( 	TaskFunction_t pxTaskCode,
+									const char * const pcName,
+									const uint32_t ulStackDepth,
+									void * const pvParameters,
+									UBaseType_t uxPriority,
+									TaskHandle_t * const pxCreatedTask,
+									TCB_t *pxNewTCB,
+									const MemoryRegion_t * const xRegions ) /*lint !e971 Unqualified char types are allowed for strings and single characters only. */
+{
+StackType_t *pxTopOfStack;
+UBaseType_t x;
+
+	#if( portUSING_MPU_WRAPPERS == 1 )
+		/* Should the task be created in privileged mode? */
+		BaseType_t xRunPrivileged;
+		if( ( uxPriority & portPRIVILEGE_BIT ) != 0U )
+		{
+			xRunPrivileged = pdTRUE;
+		}
+		else
+		{
+			xRunPrivileged = pdFALSE;
+		}
+		uxPriority &= ~portPRIVILEGE_BIT;
+	#endif /* portUSING_MPU_WRAPPERS == 1 */
+
+	/* Avoid dependency on memset() if it is not required. */
+	#if( ( configCHECK_FOR_STACK_OVERFLOW > 1 ) || ( configUSE_TRACE_FACILITY == 1 ) || ( INCLUDE_uxTaskGetStackHighWaterMark == 1 ) )
+	{
+		/* Fill the stack with a known value to assist debugging. */
+		( void ) memset( pxNewTCB->pxStack, ( int ) tskSTACK_FILL_BYTE, ( size_t ) ulStackDepth * sizeof( StackType_t ) );
+	}
+	#endif /* ( ( configCHECK_FOR_STACK_OVERFLOW > 1 ) || ( ( configUSE_TRACE_FACILITY == 1 ) || ( INCLUDE_uxTaskGetStackHighWaterMark == 1 ) ) ) */
+
+	/* Calculate the top of stack address.  This depends on whether the stack
+	grows from high memory to low (as per the 80x86) or vice versa.
+	portSTACK_GROWTH is used to make the result positive or negative as required
+	by the port. */
+	#if( portSTACK_GROWTH < 0 )
+	{
+		pxTopOfStack = pxNewTCB->pxStack + ( ulStackDepth - ( uint32_t ) 1 );
+		pxTopOfStack = ( StackType_t * ) ( ( ( portPOINTER_SIZE_TYPE ) pxTopOfStack ) & ( ~( ( portPOINTER_SIZE_TYPE ) portBYTE_ALIGNMENT_MASK ) ) ); /*lint !e923 MISRA exception.  Avoiding casts between pointers and integers is not practical.  Size differences accounted for using portPOINTER_SIZE_TYPE type. */
+
+		/* Check the alignment of the calculated top of stack is correct. */
+		configASSERT( ( ( ( portPOINTER_SIZE_TYPE ) pxTopOfStack & ( portPOINTER_SIZE_TYPE ) portBYTE_ALIGNMENT_MASK ) == 0UL ) );
+	}
+	#else /* portSTACK_GROWTH */
+	{
+		pxTopOfStack = pxNewTCB->pxStack;
+
+		/* Check the alignment of the stack buffer is correct. */
+		configASSERT( ( ( ( portPOINTER_SIZE_TYPE ) pxNewTCB->pxStack & ( portPOINTER_SIZE_TYPE ) portBYTE_ALIGNMENT_MASK ) == 0UL ) );
+
+		/* The other extreme of the stack space is required if stack checking is
+		performed. */
+		pxNewTCB->pxEndOfStack = pxNewTCB->pxStack + ( ulStackDepth - ( uint32_t ) 1 );
+	}
+	#endif /* portSTACK_GROWTH */
+
+	/* Store the task name in the TCB. */
+	for( x = ( UBaseType_t ) 0; x < ( UBaseType_t ) configMAX_TASK_NAME_LEN; x++ )
+	{
+		pxNewTCB->pcTaskName[ x ] = pcName[ x ];
+
+		/* Don't copy all configMAX_TASK_NAME_LEN if the string is shorter than
+		configMAX_TASK_NAME_LEN characters just in case the memory after the
+		string is not accessible (extremely unlikely). */
+		if( pcName[ x ] == 0x00 )
+		{
+			break;
+		}
+		else
+		{
+			mtCOVERAGE_TEST_MARKER();
+		}
+	}
+
+	/* Ensure the name string is terminated in the case that the string length
+	was greater or equal to configMAX_TASK_NAME_LEN. */
+	pxNewTCB->pcTaskName[ configMAX_TASK_NAME_LEN - 1 ] = '\0';
+
+	/* This is used as an array index so must ensure it's not too large.  First
+	remove the privilege bit if one is present. */
+	if( uxPriority >= ( UBaseType_t ) configMAX_PRIORITIES )
+	{
+		uxPriority = ( UBaseType_t ) configMAX_PRIORITIES - ( UBaseType_t ) 1U;
+	}
+	else
+	{
+		mtCOVERAGE_TEST_MARKER();
+	}
+
+	pxNewTCB->uxPriority = uxPriority;
+	#if ( configUSE_MUTEXES == 1 )
+	{
+		pxNewTCB->uxBasePriority = uxPriority;
+		pxNewTCB->uxMutexesHeld = 0;
+	}
+	#endif /* configUSE_MUTEXES */
+
+	vListInitialiseItem( &( pxNewTCB->xStateListItem ) );
+	vListInitialiseItem( &( pxNewTCB->xEventListItem ) );
+
+	/* Set the pxNewTCB as a link back from the ListItem_t.  This is so we can get
+	back to	the containing TCB from a generic item in a list. */
+	listSET_LIST_ITEM_OWNER( &( pxNewTCB->xStateListItem ), pxNewTCB );
+
+	/* Event lists are always in priority order. */
+	listSET_LIST_ITEM_VALUE( &( pxNewTCB->xEventListItem ), ( TickType_t ) configMAX_PRIORITIES - ( TickType_t ) uxPriority ); /*lint !e961 MISRA exception as the casts are only redundant for some ports. */
+	listSET_LIST_ITEM_OWNER( &( pxNewTCB->xEventListItem ), pxNewTCB );
+
+	#if ( portCRITICAL_NESTING_IN_TCB == 1 )
+	{
+		pxNewTCB->uxCriticalNesting = ( UBaseType_t ) 0U;
+	}
+	#endif /* portCRITICAL_NESTING_IN_TCB */
+
+	#if ( configUSE_APPLICATION_TASK_TAG == 1 )
+	{
+		pxNewTCB->pxTaskTag = NULL;
+	}
+	#endif /* configUSE_APPLICATION_TASK_TAG */
+
+	#if ( configGENERATE_RUN_TIME_STATS == 1 )
+	{
+		pxNewTCB->ulRunTimeCounter = 0UL;
+	}
+	#endif /* configGENERATE_RUN_TIME_STATS */
+
+	#if ( portUSING_MPU_WRAPPERS == 1 )
+	{
+		vPortStoreTaskMPUSettings( &( pxNewTCB->xMPUSettings ), xRegions, pxNewTCB->pxStack, ulStackDepth );
+	}
+	#else
+	{
+		/* Avoid compiler warning about unreferenced parameter. */
+		( void ) xRegions;
+	}
+	#endif
+
+	#if( configNUM_THREAD_LOCAL_STORAGE_POINTERS != 0 )
+	{
+		for( x = 0; x < ( UBaseType_t ) configNUM_THREAD_LOCAL_STORAGE_POINTERS; x++ )
+		{
+			pxNewTCB->pvThreadLocalStoragePointers[ x ] = NULL;
+		}
+	}
+	#endif
+
+	#if ( configUSE_TASK_NOTIFICATIONS == 1 )
+	{
+		pxNewTCB->ulNotifiedValue = 0;
+		pxNewTCB->ucNotifyState = taskNOT_WAITING_NOTIFICATION;
+	}
+	#endif
+
+	#if ( configUSE_NEWLIB_REENTRANT == 1 )
+	{
+		/* Initialise this task's Newlib reent structure. */
+		_REENT_INIT_PTR( ( &( pxNewTCB->xNewLib_reent ) ) );
+	}
+	#endif
+
+	#if( INCLUDE_xTaskAbortDelay == 1 )
+	{
+		pxNewTCB->ucDelayAborted = pdFALSE;
+	}
+	#endif
+
+	/* Initialize the TCB stack to look as if the task was already running,
+	but had been interrupted by the scheduler.  The return address is set
+	to the start of the task function. Once the stack has been initialised
+	the	top of stack variable is updated. */
+	#if( portUSING_MPU_WRAPPERS == 1 )
+	{
+		pxNewTCB->pxTopOfStack = pxPortInitialiseStack( pxTopOfStack, pxTaskCode, pvParameters, xRunPrivileged );
+	}
+	#else /* portUSING_MPU_WRAPPERS */
+	{
+		pxNewTCB->pxTopOfStack = pxPortInitialiseStack( pxTopOfStack, pxTaskCode, pvParameters );
+	}
+	#endif /* portUSING_MPU_WRAPPERS */
+
+	if( ( void * ) pxCreatedTask != NULL )
+	{
+		/* Pass the handle out in an anonymous way.  The handle can be used to
+		change the created task's priority, delete the created task, etc.*/
+		*pxCreatedTask = ( TaskHandle_t ) pxNewTCB;
+	}
+	else
+	{
+		mtCOVERAGE_TEST_MARKER();
+	}
+}
+/*-----------------------------------------------------------*/
+
+static void prvAddNewTaskToReadyList( TCB_t *pxNewTCB )
+{
+	/* Ensure interrupts don't access the task lists while the lists are being
+	updated. */
+	taskENTER_CRITICAL();
+	{
+		uxCurrentNumberOfTasks++;
+		if( pxCurrentTCB == NULL )
+		{
+			/* There are no other tasks, or all the other tasks are in
+			the suspended state - make this the current task. */
+			pxCurrentTCB = pxNewTCB;
+
+			if( uxCurrentNumberOfTasks == ( UBaseType_t ) 1 )
+			{
+				/* This is the first task to be created so do the preliminary
+				initialisation required.  We will not recover if this call
+				fails, but we will report the failure. */
+				prvInitialiseTaskLists();
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+		}
+		else
+		{
+			/* If the scheduler is not already running, make this task the
+			current task if it is the highest priority task to be created
+			so far. */
+			if( xSchedulerRunning == pdFALSE )
+			{
+				if( pxCurrentTCB->uxPriority <= pxNewTCB->uxPriority )
+				{
+					pxCurrentTCB = pxNewTCB;
+				}
+				else
+				{
+					mtCOVERAGE_TEST_MARKER();
+				}
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+		}
+
+		uxTaskNumber++;
+
+		#if ( configUSE_TRACE_FACILITY == 1 )
+		{
+			/* Add a counter into the TCB for tracing only. */
+			pxNewTCB->uxTCBNumber = uxTaskNumber;
+		}
+		#endif /* configUSE_TRACE_FACILITY */
+		traceTASK_CREATE( pxNewTCB );
+
+		prvAddTaskToReadyList( pxNewTCB );
+
+		portSETUP_TCB( pxNewTCB );
+	}
+	taskEXIT_CRITICAL();
+
+	if( xSchedulerRunning != pdFALSE )
+	{
+		/* If the created task is of a higher priority than the current task
+		then it should run now. */
+		if( pxCurrentTCB->uxPriority < pxNewTCB->uxPriority )
+		{
+			taskYIELD_IF_USING_PREEMPTION();
+		}
+		else
+		{
+			mtCOVERAGE_TEST_MARKER();
+		}
+	}
+	else
+	{
+		mtCOVERAGE_TEST_MARKER();
+	}
+}
+/*-----------------------------------------------------------*/
+
+#if ( INCLUDE_vTaskDelete == 1 )
+
+	void vTaskDelete( TaskHandle_t xTaskToDelete )
+	{
+	TCB_t *pxTCB;
+
+		taskENTER_CRITICAL();
+		{
+			/* If null is passed in here then it is the calling task that is
+			being deleted. */
+			pxTCB = prvGetTCBFromHandle( xTaskToDelete );
+
+			/* Remove task from the ready list. */
+			if( uxListRemove( &( pxTCB->xStateListItem ) ) == ( UBaseType_t ) 0 )
+			{
+				taskRESET_READY_PRIORITY( pxTCB->uxPriority );
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+
+			/* Is the task waiting on an event also? */
+			if( listLIST_ITEM_CONTAINER( &( pxTCB->xEventListItem ) ) != NULL )
+			{
+				( void ) uxListRemove( &( pxTCB->xEventListItem ) );
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+
+			/* Increment the uxTaskNumber also so kernel aware debuggers can
+			detect that the task lists need re-generating.  This is done before
+			portPRE_TASK_DELETE_HOOK() as in the Windows port that macro will
+			not return. */
+			uxTaskNumber++;
+
+			if( pxTCB == pxCurrentTCB )
+			{
+				/* A task is deleting itself.  This cannot complete within the
+				task itself, as a context switch to another task is required.
+				Place the task in the termination list.  The idle task will
+				check the termination list and free up any memory allocated by
+				the scheduler for the TCB and stack of the deleted task. */
+				vListInsertEnd( &xTasksWaitingTermination, &( pxTCB->xStateListItem ) );
+
+				/* Increment the ucTasksDeleted variable so the idle task knows
+				there is a task that has been deleted and that it should therefore
+				check the xTasksWaitingTermination list. */
+				++uxDeletedTasksWaitingCleanUp;
+
+				/* The pre-delete hook is primarily for the Windows simulator,
+				in which Windows specific clean up operations are performed,
+				after which it is not possible to yield away from this task -
+				hence xYieldPending is used to latch that a context switch is
+				required. */
+				portPRE_TASK_DELETE_HOOK( pxTCB, &xYieldPending );
+			}
+			else
+			{
+				--uxCurrentNumberOfTasks;
+				prvDeleteTCB( pxTCB );
+
+				/* Reset the next expected unblock time in case it referred to
+				the task that has just been deleted. */
+				prvResetNextTaskUnblockTime();
+			}
+
+			traceTASK_DELETE( pxTCB );
+		}
+		taskEXIT_CRITICAL();
+
+		/* Force a reschedule if it is the currently running task that has just
+		been deleted. */
+		if( xSchedulerRunning != pdFALSE )
+		{
+			if( pxTCB == pxCurrentTCB )
+			{
+				configASSERT( uxSchedulerSuspended == 0 );
+				portYIELD_WITHIN_API();
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+		}
+	}
+
+#endif /* INCLUDE_vTaskDelete */
+/*-----------------------------------------------------------*/
+
+#if ( INCLUDE_vTaskDelayUntil == 1 )
+
+	void vTaskDelayUntil( TickType_t * const pxPreviousWakeTime, const TickType_t xTimeIncrement )
+	{
+	TickType_t xTimeToWake;
+	BaseType_t xAlreadyYielded, xShouldDelay = pdFALSE;
+
+		configASSERT( pxPreviousWakeTime );
+		configASSERT( ( xTimeIncrement > 0U ) );
+		configASSERT( uxSchedulerSuspended == 0 );
+
+		vTaskSuspendAll();
+		{
+			/* Minor optimisation.  The tick count cannot change in this
+			block. */
+			const TickType_t xConstTickCount = xTickCount;
+
+			/* Generate the tick time at which the task wants to wake. */
+			xTimeToWake = *pxPreviousWakeTime + xTimeIncrement;
+
+			if( xConstTickCount < *pxPreviousWakeTime )
+			{
+				/* The tick count has overflowed since this function was
+				lasted called.  In this case the only time we should ever
+				actually delay is if the wake time has also	overflowed,
+				and the wake time is greater than the tick time.  When this
+				is the case it is as if neither time had overflowed. */
+				if( ( xTimeToWake < *pxPreviousWakeTime ) && ( xTimeToWake > xConstTickCount ) )
+				{
+					xShouldDelay = pdTRUE;
+				}
+				else
+				{
+					mtCOVERAGE_TEST_MARKER();
+				}
+			}
+			else
+			{
+				/* The tick time has not overflowed.  In this case we will
+				delay if either the wake time has overflowed, and/or the
+				tick time is less than the wake time. */
+				if( ( xTimeToWake < *pxPreviousWakeTime ) || ( xTimeToWake > xConstTickCount ) )
+				{
+					xShouldDelay = pdTRUE;
+				}
+				else
+				{
+					mtCOVERAGE_TEST_MARKER();
+				}
+			}
+
+			/* Update the wake time ready for the next call. */
+			*pxPreviousWakeTime = xTimeToWake;
+
+			if( xShouldDelay != pdFALSE )
+			{
+				traceTASK_DELAY_UNTIL( xTimeToWake );
+
+				/* prvAddCurrentTaskToDelayedList() needs the block time, not
+				the time to wake, so subtract the current tick count. */
+				prvAddCurrentTaskToDelayedList( xTimeToWake - xConstTickCount, pdFALSE );
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+		}
+		xAlreadyYielded = xTaskResumeAll();
+
+		/* Force a reschedule if xTaskResumeAll has not already done so, we may
+		have put ourselves to sleep. */
+		if( xAlreadyYielded == pdFALSE )
+		{
+			portYIELD_WITHIN_API();
+		}
+		else
+		{
+			mtCOVERAGE_TEST_MARKER();
+		}
+	}
+
+#endif /* INCLUDE_vTaskDelayUntil */
+/*-----------------------------------------------------------*/
+
+#if ( INCLUDE_vTaskDelay == 1 )
+
+	void vTaskDelay( const TickType_t xTicksToDelay )
+	{
+	BaseType_t xAlreadyYielded = pdFALSE;
+
+		/* A delay time of zero just forces a reschedule. */
+		if( xTicksToDelay > ( TickType_t ) 0U )
+		{
+			configASSERT( uxSchedulerSuspended == 0 );
+			vTaskSuspendAll();
+			{
+				traceTASK_DELAY();
+
+				/* A task that is removed from the event list while the
+				scheduler is suspended will not get placed in the ready
+				list or removed from the blocked list until the scheduler
+				is resumed.
+
+				This task cannot be in an event list as it is the currently
+				executing task. */
+				prvAddCurrentTaskToDelayedList( xTicksToDelay, pdFALSE );
+			}
+			xAlreadyYielded = xTaskResumeAll();
+		}
+		else
+		{
+			mtCOVERAGE_TEST_MARKER();
+		}
+
+		/* Force a reschedule if xTaskResumeAll has not already done so, we may
+		have put ourselves to sleep. */
+		if( xAlreadyYielded == pdFALSE )
+		{
+			portYIELD_WITHIN_API();
+		}
+		else
+		{
+			mtCOVERAGE_TEST_MARKER();
+		}
+	}
+
+#endif /* INCLUDE_vTaskDelay */
+/*-----------------------------------------------------------*/
+
+#if( ( INCLUDE_eTaskGetState == 1 ) || ( configUSE_TRACE_FACILITY == 1 ) )
+
+	eTaskState eTaskGetState( TaskHandle_t xTask )
+	{
+	eTaskState eReturn;
+	List_t *pxStateList;
+	const TCB_t * const pxTCB = ( TCB_t * ) xTask;
+
+		configASSERT( pxTCB );
+
+		if( pxTCB == pxCurrentTCB )
+		{
+			/* The task calling this function is querying its own state. */
+			eReturn = eRunning;
+		}
+		else
+		{
+			taskENTER_CRITICAL();
+			{
+				pxStateList = ( List_t * ) listLIST_ITEM_CONTAINER( &( pxTCB->xStateListItem ) );
+			}
+			taskEXIT_CRITICAL();
+
+			if( ( pxStateList == pxDelayedTaskList ) || ( pxStateList == pxOverflowDelayedTaskList ) )
+			{
+				/* The task being queried is referenced from one of the Blocked
+				lists. */
+				eReturn = eBlocked;
+			}
+
+			#if ( INCLUDE_vTaskSuspend == 1 )
+				else if( pxStateList == &xSuspendedTaskList )
+				{
+					/* The task being queried is referenced from the suspended
+					list.  Is it genuinely suspended or is it block
+					indefinitely? */
+					if( listLIST_ITEM_CONTAINER( &( pxTCB->xEventListItem ) ) == NULL )
+					{
+						eReturn = eSuspended;
+					}
+					else
+					{
+						eReturn = eBlocked;
+					}
+				}
+			#endif
+
+			#if ( INCLUDE_vTaskDelete == 1 )
+				else if( ( pxStateList == &xTasksWaitingTermination ) || ( pxStateList == NULL ) )
+				{
+					/* The task being queried is referenced from the deleted
+					tasks list, or it is not referenced from any lists at
+					all. */
+					eReturn = eDeleted;
+				}
+			#endif
+
+			else /*lint !e525 Negative indentation is intended to make use of pre-processor clearer. */
+			{
+				/* If the task is not in any other state, it must be in the
+				Ready (including pending ready) state. */
+				eReturn = eReady;
+			}
+		}
+
+		return eReturn;
+	} /*lint !e818 xTask cannot be a pointer to const because it is a typedef. */
+
+#endif /* INCLUDE_eTaskGetState */
+/*-----------------------------------------------------------*/
+
+#if ( INCLUDE_uxTaskPriorityGet == 1 )
+
+	UBaseType_t uxTaskPriorityGet( TaskHandle_t xTask )
+	{
+	TCB_t *pxTCB;
+	UBaseType_t uxReturn;
+
+		taskENTER_CRITICAL();
+		{
+			/* If null is passed in here then it is the priority of the that
+			called uxTaskPriorityGet() that is being queried. */
+			pxTCB = prvGetTCBFromHandle( xTask );
+			uxReturn = pxTCB->uxPriority;
+		}
+		taskEXIT_CRITICAL();
+
+		return uxReturn;
+	}
+
+#endif /* INCLUDE_uxTaskPriorityGet */
+/*-----------------------------------------------------------*/
+
+#if ( INCLUDE_uxTaskPriorityGet == 1 )
+
+	UBaseType_t uxTaskPriorityGetFromISR( TaskHandle_t xTask )
+	{
+	TCB_t *pxTCB;
+	UBaseType_t uxReturn, uxSavedInterruptState;
+
+		/* RTOS ports that support interrupt nesting have the concept of a
+		maximum	system call (or maximum API call) interrupt priority.
+		Interrupts that are	above the maximum system call priority are keep
+		permanently enabled, even when the RTOS kernel is in a critical section,
+		but cannot make any calls to FreeRTOS API functions.  If configASSERT()
+		is defined in FreeRTOSConfig.h then
+		portASSERT_IF_INTERRUPT_PRIORITY_INVALID() will result in an assertion
+		failure if a FreeRTOS API function is called from an interrupt that has
+		been assigned a priority above the configured maximum system call
+		priority.  Only FreeRTOS functions that end in FromISR can be called
+		from interrupts	that have been assigned a priority at or (logically)
+		below the maximum system call interrupt priority.  FreeRTOS maintains a
+		separate interrupt safe API to ensure interrupt entry is as fast and as
+		simple as possible.  More information (albeit Cortex-M specific) is
+		provided on the following link:
+		http://www.freertos.org/RTOS-Cortex-M3-M4.html */
+		portASSERT_IF_INTERRUPT_PRIORITY_INVALID();
+
+		uxSavedInterruptState = portSET_INTERRUPT_MASK_FROM_ISR();
+		{
+			/* If null is passed in here then it is the priority of the calling
+			task that is being queried. */
+			pxTCB = prvGetTCBFromHandle( xTask );
+			uxReturn = pxTCB->uxPriority;
+		}
+		portCLEAR_INTERRUPT_MASK_FROM_ISR( uxSavedInterruptState );
+
+		return uxReturn;
+	}
+
+#endif /* INCLUDE_uxTaskPriorityGet */
+/*-----------------------------------------------------------*/
+
+#if ( INCLUDE_vTaskPrioritySet == 1 )
+
+	void vTaskPrioritySet( TaskHandle_t xTask, UBaseType_t uxNewPriority )
+	{
+	TCB_t *pxTCB;
+	UBaseType_t uxCurrentBasePriority, uxPriorityUsedOnEntry;
+	BaseType_t xYieldRequired = pdFALSE;
+
+		configASSERT( ( uxNewPriority < configMAX_PRIORITIES ) );
+
+		/* Ensure the new priority is valid. */
+		if( uxNewPriority >= ( UBaseType_t ) configMAX_PRIORITIES )
+		{
+			uxNewPriority = ( UBaseType_t ) configMAX_PRIORITIES - ( UBaseType_t ) 1U;
+		}
+		else
+		{
+			mtCOVERAGE_TEST_MARKER();
+		}
+
+		taskENTER_CRITICAL();
+		{
+			/* If null is passed in here then it is the priority of the calling
+			task that is being changed. */
+			pxTCB = prvGetTCBFromHandle( xTask );
+
+			traceTASK_PRIORITY_SET( pxTCB, uxNewPriority );
+
+			#if ( configUSE_MUTEXES == 1 )
+			{
+				uxCurrentBasePriority = pxTCB->uxBasePriority;
+			}
+			#else
+			{
+				uxCurrentBasePriority = pxTCB->uxPriority;
+			}
+			#endif
+
+			if( uxCurrentBasePriority != uxNewPriority )
+			{
+				/* The priority change may have readied a task of higher
+				priority than the calling task. */
+				if( uxNewPriority > uxCurrentBasePriority )
+				{
+					if( pxTCB != pxCurrentTCB )
+					{
+						/* The priority of a task other than the currently
+						running task is being raised.  Is the priority being
+						raised above that of the running task? */
+						if( uxNewPriority >= pxCurrentTCB->uxPriority )
+						{
+							xYieldRequired = pdTRUE;
+						}
+						else
+						{
+							mtCOVERAGE_TEST_MARKER();
+						}
+					}
+					else
+					{
+						/* The priority of the running task is being raised,
+						but the running task must already be the highest
+						priority task able to run so no yield is required. */
+					}
+				}
+				else if( pxTCB == pxCurrentTCB )
+				{
+					/* Setting the priority of the running task down means
+					there may now be another task of higher priority that
+					is ready to execute. */
+					xYieldRequired = pdTRUE;
+				}
+				else
+				{
+					/* Setting the priority of any other task down does not
+					require a yield as the running task must be above the
+					new priority of the task being modified. */
+				}
+
+				/* Remember the ready list the task might be referenced from
+				before its uxPriority member is changed so the
+				taskRESET_READY_PRIORITY() macro can function correctly. */
+				uxPriorityUsedOnEntry = pxTCB->uxPriority;
+
+				#if ( configUSE_MUTEXES == 1 )
+				{
+					/* Only change the priority being used if the task is not
+					currently using an inherited priority. */
+					if( pxTCB->uxBasePriority == pxTCB->uxPriority )
+					{
+						pxTCB->uxPriority = uxNewPriority;
+					}
+					else
+					{
+						mtCOVERAGE_TEST_MARKER();
+					}
+
+					/* The base priority gets set whatever. */
+					pxTCB->uxBasePriority = uxNewPriority;
+				}
+				#else
+				{
+					pxTCB->uxPriority = uxNewPriority;
+				}
+				#endif
+
+				/* Only reset the event list item value if the value is not
+				being used for anything else. */
+				if( ( listGET_LIST_ITEM_VALUE( &( pxTCB->xEventListItem ) ) & taskEVENT_LIST_ITEM_VALUE_IN_USE ) == 0UL )
+				{
+					listSET_LIST_ITEM_VALUE( &( pxTCB->xEventListItem ), ( ( TickType_t ) configMAX_PRIORITIES - ( TickType_t ) uxNewPriority ) ); /*lint !e961 MISRA exception as the casts are only redundant for some ports. */
+				}
+				else
+				{
+					mtCOVERAGE_TEST_MARKER();
+				}
+
+				/* If the task is in the blocked or suspended list we need do
+				nothing more than change it's priority variable. However, if
+				the task is in a ready list it needs to be removed and placed
+				in the list appropriate to its new priority. */
+				if( listIS_CONTAINED_WITHIN( &( pxReadyTasksLists[ uxPriorityUsedOnEntry ] ), &( pxTCB->xStateListItem ) ) != pdFALSE )
+				{
+					/* The task is currently in its ready list - remove before adding
+					it to it's new ready list.  As we are in a critical section we
+					can do this even if the scheduler is suspended. */
+					if( uxListRemove( &( pxTCB->xStateListItem ) ) == ( UBaseType_t ) 0 )
+					{
+						/* It is known that the task is in its ready list so
+						there is no need to check again and the port level
+						reset macro can be called directly. */
+						portRESET_READY_PRIORITY( uxPriorityUsedOnEntry, uxTopReadyPriority );
+					}
+					else
+					{
+						mtCOVERAGE_TEST_MARKER();
+					}
+					prvAddTaskToReadyList( pxTCB );
+				}
+				else
+				{
+					mtCOVERAGE_TEST_MARKER();
+				}
+
+				if( xYieldRequired != pdFALSE )
+				{
+					taskYIELD_IF_USING_PREEMPTION();
+				}
+				else
+				{
+					mtCOVERAGE_TEST_MARKER();
+				}
+
+				/* Remove compiler warning about unused variables when the port
+				optimised task selection is not being used. */
+				( void ) uxPriorityUsedOnEntry;
+			}
+		}
+		taskEXIT_CRITICAL();
+	}
+
+#endif /* INCLUDE_vTaskPrioritySet */
+/*-----------------------------------------------------------*/
+
+#if ( INCLUDE_vTaskSuspend == 1 )
+
+	void vTaskSuspend( TaskHandle_t xTaskToSuspend )
+	{
+	TCB_t *pxTCB;
+
+		taskENTER_CRITICAL();
+		{
+			/* If null is passed in here then it is the running task that is
+			being suspended. */
+			pxTCB = prvGetTCBFromHandle( xTaskToSuspend );
+
+			traceTASK_SUSPEND( pxTCB );
+
+			/* Remove task from the ready/delayed list and place in the
+			suspended list. */
+			if( uxListRemove( &( pxTCB->xStateListItem ) ) == ( UBaseType_t ) 0 )
+			{
+				taskRESET_READY_PRIORITY( pxTCB->uxPriority );
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+
+			/* Is the task waiting on an event also? */
+			if( listLIST_ITEM_CONTAINER( &( pxTCB->xEventListItem ) ) != NULL )
+			{
+				( void ) uxListRemove( &( pxTCB->xEventListItem ) );
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+
+			vListInsertEnd( &xSuspendedTaskList, &( pxTCB->xStateListItem ) );
+		}
+		taskEXIT_CRITICAL();
+
+		if( xSchedulerRunning != pdFALSE )
+		{
+			/* Reset the next expected unblock time in case it referred to the
+			task that is now in the Suspended state. */
+			taskENTER_CRITICAL();
+			{
+				prvResetNextTaskUnblockTime();
+			}
+			taskEXIT_CRITICAL();
+		}
+		else
+		{
+			mtCOVERAGE_TEST_MARKER();
+		}
+
+		if( pxTCB == pxCurrentTCB )
+		{
+			if( xSchedulerRunning != pdFALSE )
+			{
+				/* The current task has just been suspended. */
+				configASSERT( uxSchedulerSuspended == 0 );
+				portYIELD_WITHIN_API();
+			}
+			else
+			{
+				/* The scheduler is not running, but the task that was pointed
+				to by pxCurrentTCB has just been suspended and pxCurrentTCB
+				must be adjusted to point to a different task. */
+				if( listCURRENT_LIST_LENGTH( &xSuspendedTaskList ) == uxCurrentNumberOfTasks )
+				{
+					/* No other tasks are ready, so set pxCurrentTCB back to
+					NULL so when the next task is created pxCurrentTCB will
+					be set to point to it no matter what its relative priority
+					is. */
+					pxCurrentTCB = NULL;
+				}
+				else
+				{
+					vTaskSwitchContext();
+				}
+			}
+		}
+		else
+		{
+			mtCOVERAGE_TEST_MARKER();
+		}
+	}
+
+#endif /* INCLUDE_vTaskSuspend */
+/*-----------------------------------------------------------*/
+
+#if ( INCLUDE_vTaskSuspend == 1 )
+
+	static BaseType_t prvTaskIsTaskSuspended( const TaskHandle_t xTask )
+	{
+	BaseType_t xReturn = pdFALSE;
+	const TCB_t * const pxTCB = ( TCB_t * ) xTask;
+
+		/* Accesses xPendingReadyList so must be called from a critical
+		section. */
+
+		/* It does not make sense to check if the calling task is suspended. */
+		configASSERT( xTask );
+
+		/* Is the task being resumed actually in the suspended list? */
+		if( listIS_CONTAINED_WITHIN( &xSuspendedTaskList, &( pxTCB->xStateListItem ) ) != pdFALSE )
+		{
+			/* Has the task already been resumed from within an ISR? */
+			if( listIS_CONTAINED_WITHIN( &xPendingReadyList, &( pxTCB->xEventListItem ) ) == pdFALSE )
+			{
+				/* Is it in the suspended list because it is in the	Suspended
+				state, or because is is blocked with no timeout? */
+				if( listIS_CONTAINED_WITHIN( NULL, &( pxTCB->xEventListItem ) ) != pdFALSE )
+				{
+					xReturn = pdTRUE;
+				}
+				else
+				{
+					mtCOVERAGE_TEST_MARKER();
+				}
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+		}
+		else
+		{
+			mtCOVERAGE_TEST_MARKER();
+		}
+
+		return xReturn;
+	} /*lint !e818 xTask cannot be a pointer to const because it is a typedef. */
+
+#endif /* INCLUDE_vTaskSuspend */
+/*-----------------------------------------------------------*/
+
+#if ( INCLUDE_vTaskSuspend == 1 )
+
+	void vTaskResume( TaskHandle_t xTaskToResume )
+	{
+	TCB_t * const pxTCB = ( TCB_t * ) xTaskToResume;
+
+		/* It does not make sense to resume the calling task. */
+		configASSERT( xTaskToResume );
+
+		/* The parameter cannot be NULL as it is impossible to resume the
+		currently executing task. */
+		if( ( pxTCB != NULL ) && ( pxTCB != pxCurrentTCB ) )
+		{
+			taskENTER_CRITICAL();
+			{
+				if( prvTaskIsTaskSuspended( pxTCB ) != pdFALSE )
+				{
+					traceTASK_RESUME( pxTCB );
+
+					/* As we are in a critical section we can access the ready
+					lists even if the scheduler is suspended. */
+					( void ) uxListRemove(  &( pxTCB->xStateListItem ) );
+					prvAddTaskToReadyList( pxTCB );
+
+					/* We may have just resumed a higher priority task. */
+					if( pxTCB->uxPriority >= pxCurrentTCB->uxPriority )
+					{
+						/* This yield may not cause the task just resumed to run,
+						but will leave the lists in the correct state for the
+						next yield. */
+						taskYIELD_IF_USING_PREEMPTION();
+					}
+					else
+					{
+						mtCOVERAGE_TEST_MARKER();
+					}
+				}
+				else
+				{
+					mtCOVERAGE_TEST_MARKER();
+				}
+			}
+			taskEXIT_CRITICAL();
+		}
+		else
+		{
+			mtCOVERAGE_TEST_MARKER();
+		}
+	}
+
+#endif /* INCLUDE_vTaskSuspend */
+
+/*-----------------------------------------------------------*/
+
+#if ( ( INCLUDE_xTaskResumeFromISR == 1 ) && ( INCLUDE_vTaskSuspend == 1 ) )
+
+	BaseType_t xTaskResumeFromISR( TaskHandle_t xTaskToResume )
+	{
+	BaseType_t xYieldRequired = pdFALSE;
+	TCB_t * const pxTCB = ( TCB_t * ) xTaskToResume;
+	UBaseType_t uxSavedInterruptStatus;
+
+		configASSERT( xTaskToResume );
+
+		/* RTOS ports that support interrupt nesting have the concept of a
+		maximum	system call (or maximum API call) interrupt priority.
+		Interrupts that are	above the maximum system call priority are keep
+		permanently enabled, even when the RTOS kernel is in a critical section,
+		but cannot make any calls to FreeRTOS API functions.  If configASSERT()
+		is defined in FreeRTOSConfig.h then
+		portASSERT_IF_INTERRUPT_PRIORITY_INVALID() will result in an assertion
+		failure if a FreeRTOS API function is called from an interrupt that has
+		been assigned a priority above the configured maximum system call
+		priority.  Only FreeRTOS functions that end in FromISR can be called
+		from interrupts	that have been assigned a priority at or (logically)
+		below the maximum system call interrupt priority.  FreeRTOS maintains a
+		separate interrupt safe API to ensure interrupt entry is as fast and as
+		simple as possible.  More information (albeit Cortex-M specific) is
+		provided on the following link:
+		http://www.freertos.org/RTOS-Cortex-M3-M4.html */
+		portASSERT_IF_INTERRUPT_PRIORITY_INVALID();
+
+		uxSavedInterruptStatus = portSET_INTERRUPT_MASK_FROM_ISR();
+		{
+			if( prvTaskIsTaskSuspended( pxTCB ) != pdFALSE )
+			{
+				traceTASK_RESUME_FROM_ISR( pxTCB );
+
+				/* Check the ready lists can be accessed. */
+				if( uxSchedulerSuspended == ( UBaseType_t ) pdFALSE )
+				{
+					/* Ready lists can be accessed so move the task from the
+					suspended list to the ready list directly. */
+					if( pxTCB->uxPriority >= pxCurrentTCB->uxPriority )
+					{
+						xYieldRequired = pdTRUE;
+					}
+					else
+					{
+						mtCOVERAGE_TEST_MARKER();
+					}
+
+					( void ) uxListRemove( &( pxTCB->xStateListItem ) );
+					prvAddTaskToReadyList( pxTCB );
+				}
+				else
+				{
+					/* The delayed or ready lists cannot be accessed so the task
+					is held in the pending ready list until the scheduler is
+					unsuspended. */
+					vListInsertEnd( &( xPendingReadyList ), &( pxTCB->xEventListItem ) );
+				}
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+		}
+		portCLEAR_INTERRUPT_MASK_FROM_ISR( uxSavedInterruptStatus );
+
+		return xYieldRequired;
+	}
+
+#endif /* ( ( INCLUDE_xTaskResumeFromISR == 1 ) && ( INCLUDE_vTaskSuspend == 1 ) ) */
+/*-----------------------------------------------------------*/
+
+void vTaskStartScheduler( void )
+{
+BaseType_t xReturn;
+
+	/* Add the idle task at the lowest priority. */
+	#if( configSUPPORT_STATIC_ALLOCATION == 1 )
+	{
+		StaticTask_t *pxIdleTaskTCBBuffer = NULL;
+		StackType_t *pxIdleTaskStackBuffer = NULL;
+		uint32_t ulIdleTaskStackSize;
+
+		/* The Idle task is created using user provided RAM - obtain the
+		address of the RAM then create the idle task. */
+		vApplicationGetIdleTaskMemory( &pxIdleTaskTCBBuffer, &pxIdleTaskStackBuffer, &ulIdleTaskStackSize );
+		xIdleTaskHandle = xTaskCreateStatic(	prvIdleTask,
+												"IDLE",
+												ulIdleTaskStackSize,
+												( void * ) NULL,
+												( tskIDLE_PRIORITY | portPRIVILEGE_BIT ),
+												pxIdleTaskStackBuffer,
+												pxIdleTaskTCBBuffer ); /*lint !e961 MISRA exception, justified as it is not a redundant explicit cast to all supported compilers. */
+
+		if( xIdleTaskHandle != NULL )
+		{
+			xReturn = pdPASS;
+		}
+		else
+		{
+			xReturn = pdFAIL;
+		}
+	}
+	#else
+	{
+		/* The Idle task is being created using dynamically allocated RAM. */
+		xReturn = xTaskCreate(	prvIdleTask,
+								"IDLE", configMINIMAL_STACK_SIZE,
+								( void * ) NULL,
+								( tskIDLE_PRIORITY | portPRIVILEGE_BIT ),
+								&xIdleTaskHandle ); /*lint !e961 MISRA exception, justified as it is not a redundant explicit cast to all supported compilers. */
+	}
+	#endif /* configSUPPORT_STATIC_ALLOCATION */
+
+	#if ( configUSE_TIMERS == 1 )
+	{
+		if( xReturn == pdPASS )
+		{
+			xReturn = xTimerCreateTimerTask();
+		}
+		else
+		{
+			mtCOVERAGE_TEST_MARKER();
+		}
+	}
+	#endif /* configUSE_TIMERS */
+
+	if( xReturn == pdPASS )
+	{
+		/* Interrupts are turned off here, to ensure a tick does not occur
+		before or during the call to xPortStartScheduler().  The stacks of
+		the created tasks contain a status word with interrupts switched on
+		so interrupts will automatically get re-enabled when the first task
+		starts to run. */
+		portDISABLE_INTERRUPTS();
+
+		#if ( configUSE_NEWLIB_REENTRANT == 1 )
+		{
+			/* Switch Newlib's _impure_ptr variable to point to the _reent
+			structure specific to the task that will run first. */
+			_impure_ptr = &( pxCurrentTCB->xNewLib_reent );
+		}
+		#endif /* configUSE_NEWLIB_REENTRANT */
+
+		xNextTaskUnblockTime = portMAX_DELAY;
+		xSchedulerRunning = pdTRUE;
+		xTickCount = ( TickType_t ) 0U;
+
+		/* If configGENERATE_RUN_TIME_STATS is defined then the following
+		macro must be defined to configure the timer/counter used to generate
+		the run time counter time base. */
+		portCONFIGURE_TIMER_FOR_RUN_TIME_STATS();
+
+		/* Setting up the timer tick is hardware specific and thus in the
+		portable interface. */
+		if( xPortStartScheduler() != pdFALSE )
+		{
+			/* Should not reach here as if the scheduler is running the
+			function will not return. */
+		}
+		else
+		{
+			/* Should only reach here if a task calls xTaskEndScheduler(). */
+		}
+	}
+	else
+	{
+		/* This line will only be reached if the kernel could not be started,
+		because there was not enough FreeRTOS heap to create the idle task
+		or the timer task. */
+		configASSERT( xReturn != errCOULD_NOT_ALLOCATE_REQUIRED_MEMORY );
+	}
+
+	/* Prevent compiler warnings if INCLUDE_xTaskGetIdleTaskHandle is set to 0,
+	meaning xIdleTaskHandle is not used anywhere else. */
+	( void ) xIdleTaskHandle;
+}
+/*-----------------------------------------------------------*/
+
+void vTaskEndScheduler( void )
+{
+	/* Stop the scheduler interrupts and call the portable scheduler end
+	routine so the original ISRs can be restored if necessary.  The port
+	layer must ensure interrupts enable	bit is left in the correct state. */
+	portDISABLE_INTERRUPTS();
+	xSchedulerRunning = pdFALSE;
+	vPortEndScheduler();
+}
+/*----------------------------------------------------------*/
+
+void vTaskSuspendAll( void )
+{
+	/* A critical section is not required as the variable is of type
+	BaseType_t.  Please read Richard Barry's reply in the following link to a
+	post in the FreeRTOS support forum before reporting this as a bug! -
+	http://goo.gl/wu4acr */
+	++uxSchedulerSuspended;
+}
+/*----------------------------------------------------------*/
+
+#if ( configUSE_TICKLESS_IDLE != 0 )
+
+	static TickType_t prvGetExpectedIdleTime( void )
+	{
+	TickType_t xReturn;
+	UBaseType_t uxHigherPriorityReadyTasks = pdFALSE;
+
+		/* uxHigherPriorityReadyTasks takes care of the case where
+		configUSE_PREEMPTION is 0, so there may be tasks above the idle priority
+		task that are in the Ready state, even though the idle task is
+		running. */
+		#if( configUSE_PORT_OPTIMISED_TASK_SELECTION == 0 )
+		{
+			if( uxTopReadyPriority > tskIDLE_PRIORITY )
+			{
+				uxHigherPriorityReadyTasks = pdTRUE;
+			}
+		}
+		#else
+		{
+			const UBaseType_t uxLeastSignificantBit = ( UBaseType_t ) 0x01;
+
+			/* When port optimised task selection is used the uxTopReadyPriority
+			variable is used as a bit map.  If bits other than the least
+			significant bit are set then there are tasks that have a priority
+			above the idle priority that are in the Ready state.  This takes
+			care of the case where the co-operative scheduler is in use. */
+			if( uxTopReadyPriority > uxLeastSignificantBit )
+			{
+				uxHigherPriorityReadyTasks = pdTRUE;
+			}
+		}
+		#endif
+
+		if( pxCurrentTCB->uxPriority > tskIDLE_PRIORITY )
+		{
+			xReturn = 0;
+		}
+		else if( listCURRENT_LIST_LENGTH( &( pxReadyTasksLists[ tskIDLE_PRIORITY ] ) ) > 1 )
+		{
+			/* There are other idle priority tasks in the ready state.  If
+			time slicing is used then the very next tick interrupt must be
+			processed. */
+			xReturn = 0;
+		}
+		else if( uxHigherPriorityReadyTasks != pdFALSE )
+		{
+			/* There are tasks in the Ready state that have a priority above the
+			idle priority.  This path can only be reached if
+			configUSE_PREEMPTION is 0. */
+			xReturn = 0;
+		}
+		else
+		{
+			xReturn = xNextTaskUnblockTime - xTickCount;
+		}
+
+		return xReturn;
+	}
+
+#endif /* configUSE_TICKLESS_IDLE */
+/*----------------------------------------------------------*/
+
+BaseType_t xTaskResumeAll( void )
+{
+TCB_t *pxTCB = NULL;
+BaseType_t xAlreadyYielded = pdFALSE;
+
+	/* If uxSchedulerSuspended is zero then this function does not match a
+	previous call to vTaskSuspendAll(). */
+	configASSERT( uxSchedulerSuspended );
+
+	/* It is possible that an ISR caused a task to be removed from an event
+	list while the scheduler was suspended.  If this was the case then the
+	removed task will have been added to the xPendingReadyList.  Once the
+	scheduler has been resumed it is safe to move all the pending ready
+	tasks from this list into their appropriate ready list. */
+	taskENTER_CRITICAL();
+	{
+		--uxSchedulerSuspended;
+
+		if( uxSchedulerSuspended == ( UBaseType_t ) pdFALSE )
+		{
+			if( uxCurrentNumberOfTasks > ( UBaseType_t ) 0U )
+			{
+				/* Move any readied tasks from the pending list into the
+				appropriate ready list. */
+				while( listLIST_IS_EMPTY( &xPendingReadyList ) == pdFALSE )
+				{
+					pxTCB = ( TCB_t * ) listGET_OWNER_OF_HEAD_ENTRY( ( &xPendingReadyList ) );
+					( void ) uxListRemove( &( pxTCB->xEventListItem ) );
+					( void ) uxListRemove( &( pxTCB->xStateListItem ) );
+					prvAddTaskToReadyList( pxTCB );
+
+					/* If the moved task has a priority higher than the current
+					task then a yield must be performed. */
+					if( pxTCB->uxPriority >= pxCurrentTCB->uxPriority )
+					{
+						xYieldPending = pdTRUE;
+					}
+					else
+					{
+						mtCOVERAGE_TEST_MARKER();
+					}
+				}
+
+				if( pxTCB != NULL )
+				{
+					/* A task was unblocked while the scheduler was suspended,
+					which may have prevented the next unblock time from being
+					re-calculated, in which case re-calculate it now.  Mainly
+					important for low power tickless implementations, where
+					this can prevent an unnecessary exit from low power
+					state. */
+					prvResetNextTaskUnblockTime();
+				}
+
+				/* If any ticks occurred while the scheduler was suspended then
+				they should be processed now.  This ensures the tick count does
+				not	slip, and that any delayed tasks are resumed at the correct
+				time. */
+				{
+					UBaseType_t uxPendedCounts = uxPendedTicks; /* Non-volatile copy. */
+
+					if( uxPendedCounts > ( UBaseType_t ) 0U )
+					{
+						do
+						{
+							if( xTaskIncrementTick() != pdFALSE )
+							{
+								xYieldPending = pdTRUE;
+							}
+							else
+							{
+								mtCOVERAGE_TEST_MARKER();
+							}
+							--uxPendedCounts;
+						} while( uxPendedCounts > ( UBaseType_t ) 0U );
+
+						uxPendedTicks = 0;
+					}
+					else
+					{
+						mtCOVERAGE_TEST_MARKER();
+					}
+				}
+
+				if( xYieldPending != pdFALSE )
+				{
+					#if( configUSE_PREEMPTION != 0 )
+					{
+						xAlreadyYielded = pdTRUE;
+					}
+					#endif
+					taskYIELD_IF_USING_PREEMPTION();
+				}
+				else
+				{
+					mtCOVERAGE_TEST_MARKER();
+				}
+			}
+		}
+		else
+		{
+			mtCOVERAGE_TEST_MARKER();
+		}
+	}
+	taskEXIT_CRITICAL();
+
+	return xAlreadyYielded;
+}
+/*-----------------------------------------------------------*/
+
+TickType_t xTaskGetTickCount( void )
+{
+TickType_t xTicks;
+
+	/* Critical section required if running on a 16 bit processor. */
+	portTICK_TYPE_ENTER_CRITICAL();
+	{
+		xTicks = xTickCount;
+	}
+	portTICK_TYPE_EXIT_CRITICAL();
+
+	return xTicks;
+}
+/*-----------------------------------------------------------*/
+
+TickType_t xTaskGetTickCountFromISR( void )
+{
+TickType_t xReturn;
+UBaseType_t uxSavedInterruptStatus;
+
+	/* RTOS ports that support interrupt nesting have the concept of a maximum
+	system call (or maximum API call) interrupt priority.  Interrupts that are
+	above the maximum system call priority are kept permanently enabled, even
+	when the RTOS kernel is in a critical section, but cannot make any calls to
+	FreeRTOS API functions.  If configASSERT() is defined in FreeRTOSConfig.h
+	then portASSERT_IF_INTERRUPT_PRIORITY_INVALID() will result in an assertion
+	failure if a FreeRTOS API function is called from an interrupt that has been
+	assigned a priority above the configured maximum system call priority.
+	Only FreeRTOS functions that end in FromISR can be called from interrupts
+	that have been assigned a priority at or (logically) below the maximum
+	system call	interrupt priority.  FreeRTOS maintains a separate interrupt
+	safe API to ensure interrupt entry is as fast and as simple as possible.
+	More information (albeit Cortex-M specific) is provided on the following
+	link: http://www.freertos.org/RTOS-Cortex-M3-M4.html */
+	portASSERT_IF_INTERRUPT_PRIORITY_INVALID();
+
+	uxSavedInterruptStatus = portTICK_TYPE_SET_INTERRUPT_MASK_FROM_ISR();
+	{
+		xReturn = xTickCount;
+	}
+	portTICK_TYPE_CLEAR_INTERRUPT_MASK_FROM_ISR( uxSavedInterruptStatus );
+
+	return xReturn;
+}
+/*-----------------------------------------------------------*/
+
+UBaseType_t uxTaskGetNumberOfTasks( void )
+{
+	/* A critical section is not required because the variables are of type
+	BaseType_t. */
+	return uxCurrentNumberOfTasks;
+}
+/*-----------------------------------------------------------*/
+
+char *pcTaskGetName( TaskHandle_t xTaskToQuery ) /*lint !e971 Unqualified char types are allowed for strings and single characters only. */
+{
+TCB_t *pxTCB;
+
+	/* If null is passed in here then the name of the calling task is being
+	queried. */
+	pxTCB = prvGetTCBFromHandle( xTaskToQuery );
+	configASSERT( pxTCB );
+	return &( pxTCB->pcTaskName[ 0 ] );
+}
+/*-----------------------------------------------------------*/
+
+#if ( INCLUDE_xTaskGetHandle == 1 )
+
+	static TCB_t *prvSearchForNameWithinSingleList( List_t *pxList, const char pcNameToQuery[] )
+	{
+	TCB_t *pxNextTCB, *pxFirstTCB, *pxReturn = NULL;
+	UBaseType_t x;
+	char cNextChar;
+
+		/* This function is called with the scheduler suspended. */
+
+		if( listCURRENT_LIST_LENGTH( pxList ) > ( UBaseType_t ) 0 )
+		{
+			listGET_OWNER_OF_NEXT_ENTRY( pxFirstTCB, pxList );
+
+			do
+			{
+				listGET_OWNER_OF_NEXT_ENTRY( pxNextTCB, pxList );
+
+				/* Check each character in the name looking for a match or
+				mismatch. */
+				for( x = ( UBaseType_t ) 0; x < ( UBaseType_t ) configMAX_TASK_NAME_LEN; x++ )
+				{
+					cNextChar = pxNextTCB->pcTaskName[ x ];
+
+					if( cNextChar != pcNameToQuery[ x ] )
+					{
+						/* Characters didn't match. */
+						break;
+					}
+					else if( cNextChar == 0x00 )
+					{
+						/* Both strings terminated, a match must have been
+						found. */
+						pxReturn = pxNextTCB;
+						break;
+					}
+					else
+					{
+						mtCOVERAGE_TEST_MARKER();
+					}
+				}
+
+				if( pxReturn != NULL )
+				{
+					/* The handle has been found. */
+					break;
+				}
+
+			} while( pxNextTCB != pxFirstTCB );
+		}
+		else
+		{
+			mtCOVERAGE_TEST_MARKER();
+		}
+
+		return pxReturn;
+	}
+
+#endif /* INCLUDE_xTaskGetHandle */
+/*-----------------------------------------------------------*/
+
+#if ( INCLUDE_xTaskGetHandle == 1 )
+
+	TaskHandle_t xTaskGetHandle( const char *pcNameToQuery ) /*lint !e971 Unqualified char types are allowed for strings and single characters only. */
+	{
+	UBaseType_t uxQueue = configMAX_PRIORITIES;
+	TCB_t* pxTCB;
+
+		/* Task names will be truncated to configMAX_TASK_NAME_LEN - 1 bytes. */
+		configASSERT( strlen( pcNameToQuery ) < configMAX_TASK_NAME_LEN );
+
+		vTaskSuspendAll();
+		{
+			/* Search the ready lists. */
+			do
+			{
+				uxQueue--;
+				pxTCB = prvSearchForNameWithinSingleList( ( List_t * ) &( pxReadyTasksLists[ uxQueue ] ), pcNameToQuery );
+
+				if( pxTCB != NULL )
+				{
+					/* Found the handle. */
+					break;
+				}
+
+			} while( uxQueue > ( UBaseType_t ) tskIDLE_PRIORITY ); /*lint !e961 MISRA exception as the casts are only redundant for some ports. */
+
+			/* Search the delayed lists. */
+			if( pxTCB == NULL )
+			{
+				pxTCB = prvSearchForNameWithinSingleList( ( List_t * ) pxDelayedTaskList, pcNameToQuery );
+			}
+
+			if( pxTCB == NULL )
+			{
+				pxTCB = prvSearchForNameWithinSingleList( ( List_t * ) pxOverflowDelayedTaskList, pcNameToQuery );
+			}
+
+			#if ( INCLUDE_vTaskSuspend == 1 )
+			{
+				if( pxTCB == NULL )
+				{
+					/* Search the suspended list. */
+					pxTCB = prvSearchForNameWithinSingleList( &xSuspendedTaskList, pcNameToQuery );
+				}
+			}
+			#endif
+
+			#if( INCLUDE_vTaskDelete == 1 )
+			{
+				if( pxTCB == NULL )
+				{
+					/* Search the deleted list. */
+					pxTCB = prvSearchForNameWithinSingleList( &xTasksWaitingTermination, pcNameToQuery );
+				}
+			}
+			#endif
+		}
+		( void ) xTaskResumeAll();
+
+		return ( TaskHandle_t ) pxTCB;
+	}
+
+#endif /* INCLUDE_xTaskGetHandle */
+/*-----------------------------------------------------------*/
+
+#if ( configUSE_TRACE_FACILITY == 1 )
+
+	UBaseType_t uxTaskGetSystemState( TaskStatus_t * const pxTaskStatusArray, const UBaseType_t uxArraySize, uint32_t * const pulTotalRunTime )
+	{
+	UBaseType_t uxTask = 0, uxQueue = configMAX_PRIORITIES;
+
+		vTaskSuspendAll();
+		{
+			/* Is there a space in the array for each task in the system? */
+			if( uxArraySize >= uxCurrentNumberOfTasks )
+			{
+				/* Fill in an TaskStatus_t structure with information on each
+				task in the Ready state. */
+				do
+				{
+					uxQueue--;
+					uxTask += prvListTasksWithinSingleList( &( pxTaskStatusArray[ uxTask ] ), &( pxReadyTasksLists[ uxQueue ] ), eReady );
+
+				} while( uxQueue > ( UBaseType_t ) tskIDLE_PRIORITY ); /*lint !e961 MISRA exception as the casts are only redundant for some ports. */
+
+				/* Fill in an TaskStatus_t structure with information on each
+				task in the Blocked state. */
+				uxTask += prvListTasksWithinSingleList( &( pxTaskStatusArray[ uxTask ] ), ( List_t * ) pxDelayedTaskList, eBlocked );
+				uxTask += prvListTasksWithinSingleList( &( pxTaskStatusArray[ uxTask ] ), ( List_t * ) pxOverflowDelayedTaskList, eBlocked );
+
+				#if( INCLUDE_vTaskDelete == 1 )
+				{
+					/* Fill in an TaskStatus_t structure with information on
+					each task that has been deleted but not yet cleaned up. */
+					uxTask += prvListTasksWithinSingleList( &( pxTaskStatusArray[ uxTask ] ), &xTasksWaitingTermination, eDeleted );
+				}
+				#endif
+
+				#if ( INCLUDE_vTaskSuspend == 1 )
+				{
+					/* Fill in an TaskStatus_t structure with information on
+					each task in the Suspended state. */
+					uxTask += prvListTasksWithinSingleList( &( pxTaskStatusArray[ uxTask ] ), &xSuspendedTaskList, eSuspended );
+				}
+				#endif
+
+				#if ( configGENERATE_RUN_TIME_STATS == 1)
+				{
+					if( pulTotalRunTime != NULL )
+					{
+						#ifdef portALT_GET_RUN_TIME_COUNTER_VALUE
+							portALT_GET_RUN_TIME_COUNTER_VALUE( ( *pulTotalRunTime ) );
+						#else
+							*pulTotalRunTime = portGET_RUN_TIME_COUNTER_VALUE();
+						#endif
+					}
+				}
+				#else
+				{
+					if( pulTotalRunTime != NULL )
+					{
+						*pulTotalRunTime = 0;
+					}
+				}
+				#endif
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+		}
+		( void ) xTaskResumeAll();
+
+		return uxTask;
+	}
+
+#endif /* configUSE_TRACE_FACILITY */
+/*----------------------------------------------------------*/
+
+#if ( INCLUDE_xTaskGetIdleTaskHandle == 1 )
+
+	TaskHandle_t xTaskGetIdleTaskHandle( void )
+	{
+		/* If xTaskGetIdleTaskHandle() is called before the scheduler has been
+		started, then xIdleTaskHandle will be NULL. */
+		configASSERT( ( xIdleTaskHandle != NULL ) );
+		return xIdleTaskHandle;
+	}
+
+#endif /* INCLUDE_xTaskGetIdleTaskHandle */
+/*----------------------------------------------------------*/
+
+/* This conditional compilation should use inequality to 0, not equality to 1.
+This is to ensure vTaskStepTick() is available when user defined low power mode
+implementations require configUSE_TICKLESS_IDLE to be set to a value other than
+1. */
+#if ( configUSE_TICKLESS_IDLE != 0 )
+
+	void vTaskStepTick( const TickType_t xTicksToJump )
+	{
+		/* Correct the tick count value after a period during which the tick
+		was suppressed.  Note this does *not* call the tick hook function for
+		each stepped tick. */
+		configASSERT( ( xTickCount + xTicksToJump ) <= xNextTaskUnblockTime );
+		xTickCount += xTicksToJump;
+		traceINCREASE_TICK_COUNT( xTicksToJump );
+	}
+
+#endif /* configUSE_TICKLESS_IDLE */
+/*----------------------------------------------------------*/
+
+#if ( INCLUDE_xTaskAbortDelay == 1 )
+
+	BaseType_t xTaskAbortDelay( TaskHandle_t xTask )
+	{
+	TCB_t *pxTCB = ( TCB_t * ) xTask;
+	BaseType_t xReturn = pdFALSE;
+
+		configASSERT( pxTCB );
+
+		vTaskSuspendAll();
+		{
+			/* A task can only be prematurely removed from the Blocked state if
+			it is actually in the Blocked state. */
+			if( eTaskGetState( xTask ) == eBlocked )
+			{
+				/* Remove the reference to the task from the blocked list.  An
+				interrupt won't touch the xStateListItem because the
+				scheduler is suspended. */
+				( void ) uxListRemove( &( pxTCB->xStateListItem ) );
+
+				/* Is the task waiting on an event also?  If so remove it from
+				the event list too.  Interrupts can touch the event list item,
+				even though the scheduler is suspended, so a critical section
+				is used. */
+				taskENTER_CRITICAL();
+				{
+					if( listLIST_ITEM_CONTAINER( &( pxTCB->xEventListItem ) ) != NULL )
+					{
+						( void ) uxListRemove( &( pxTCB->xEventListItem ) );
+						pxTCB->ucDelayAborted = pdTRUE;
+					}
+					else
+					{
+						mtCOVERAGE_TEST_MARKER();
+					}
+				}
+				taskEXIT_CRITICAL();
+
+				/* Place the unblocked task into the appropriate ready list. */
+				prvAddTaskToReadyList( pxTCB );
+
+				/* A task being unblocked cannot cause an immediate context
+				switch if preemption is turned off. */
+				#if (  configUSE_PREEMPTION == 1 )
+				{
+					/* Preemption is on, but a context switch should only be
+					performed if the unblocked task has a priority that is
+					equal to or higher than the currently executing task. */
+					if( pxTCB->uxPriority > pxCurrentTCB->uxPriority )
+					{
+						/* Pend the yield to be performed when the scheduler
+						is unsuspended. */
+						xYieldPending = pdTRUE;
+					}
+					else
+					{
+						mtCOVERAGE_TEST_MARKER();
+					}
+				}
+				#endif /* configUSE_PREEMPTION */
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+		}
+		xTaskResumeAll();
+
+		return xReturn;
+	}
+
+#endif /* INCLUDE_xTaskAbortDelay */
+/*----------------------------------------------------------*/
+
+BaseType_t xTaskIncrementTick( void )
+{
+TCB_t * pxTCB;
+TickType_t xItemValue;
+BaseType_t xSwitchRequired = pdFALSE;
+
+	/* Called by the portable layer each time a tick interrupt occurs.
+	Increments the tick then checks to see if the new tick value will cause any
+	tasks to be unblocked. */
+	traceTASK_INCREMENT_TICK( xTickCount );
+	if( uxSchedulerSuspended == ( UBaseType_t ) pdFALSE )
+	{
+		/* Minor optimisation.  The tick count cannot change in this
+		block. */
+		const TickType_t xConstTickCount = xTickCount + 1;
+
+		/* Increment the RTOS tick, switching the delayed and overflowed
+		delayed lists if it wraps to 0. */
+		xTickCount = xConstTickCount;
+
+		if( xConstTickCount == ( TickType_t ) 0U )
+		{
+			taskSWITCH_DELAYED_LISTS();
+		}
+		else
+		{
+			mtCOVERAGE_TEST_MARKER();
+		}
+
+		/* See if this tick has made a timeout expire.  Tasks are stored in
+		the	queue in the order of their wake time - meaning once one task
+		has been found whose block time has not expired there is no need to
+		look any further down the list. */
+		if( xConstTickCount >= xNextTaskUnblockTime )
+		{
+			for( ;; )
+			{
+				if( listLIST_IS_EMPTY( pxDelayedTaskList ) != pdFALSE )
+				{
+					/* The delayed list is empty.  Set xNextTaskUnblockTime
+					to the maximum possible value so it is extremely
+					unlikely that the
+					if( xTickCount >= xNextTaskUnblockTime ) test will pass
+					next time through. */
+					xNextTaskUnblockTime = portMAX_DELAY; /*lint !e961 MISRA exception as the casts are only redundant for some ports. */
+					break;
+				}
+				else
+				{
+					/* The delayed list is not empty, get the value of the
+					item at the head of the delayed list.  This is the time
+					at which the task at the head of the delayed list must
+					be removed from the Blocked state. */
+					pxTCB = ( TCB_t * ) listGET_OWNER_OF_HEAD_ENTRY( pxDelayedTaskList );
+					xItemValue = listGET_LIST_ITEM_VALUE( &( pxTCB->xStateListItem ) );
+
+					if( xConstTickCount < xItemValue )
+					{
+						/* It is not time to unblock this item yet, but the
+						item value is the time at which the task at the head
+						of the blocked list must be removed from the Blocked
+						state -	so record the item value in
+						xNextTaskUnblockTime. */
+						xNextTaskUnblockTime = xItemValue;
+						break;
+					}
+					else
+					{
+						mtCOVERAGE_TEST_MARKER();
+					}
+
+					/* It is time to remove the item from the Blocked state. */
+					( void ) uxListRemove( &( pxTCB->xStateListItem ) );
+
+					/* Is the task waiting on an event also?  If so remove
+					it from the event list. */
+					if( listLIST_ITEM_CONTAINER( &( pxTCB->xEventListItem ) ) != NULL )
+					{
+						( void ) uxListRemove( &( pxTCB->xEventListItem ) );
+					}
+					else
+					{
+						mtCOVERAGE_TEST_MARKER();
+					}
+
+					/* Place the unblocked task into the appropriate ready
+					list. */
+					prvAddTaskToReadyList( pxTCB );
+
+					/* A task being unblocked cannot cause an immediate
+					context switch if preemption is turned off. */
+					#if (  configUSE_PREEMPTION == 1 )
+					{
+						/* Preemption is on, but a context switch should
+						only be performed if the unblocked task has a
+						priority that is equal to or higher than the
+						currently executing task. */
+						if( pxTCB->uxPriority >= pxCurrentTCB->uxPriority )
+						{
+							xSwitchRequired = pdTRUE;
+						}
+						else
+						{
+							mtCOVERAGE_TEST_MARKER();
+						}
+					}
+					#endif /* configUSE_PREEMPTION */
+				}
+			}
+		}
+
+		/* Tasks of equal priority to the currently running task will share
+		processing time (time slice) if preemption is on, and the application
+		writer has not explicitly turned time slicing off. */
+		#if ( ( configUSE_PREEMPTION == 1 ) && ( configUSE_TIME_SLICING == 1 ) )
+		{
+			if( listCURRENT_LIST_LENGTH( &( pxReadyTasksLists[ pxCurrentTCB->uxPriority ] ) ) > ( UBaseType_t ) 1 )
+			{
+				xSwitchRequired = pdTRUE;
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+		}
+		#endif /* ( ( configUSE_PREEMPTION == 1 ) && ( configUSE_TIME_SLICING == 1 ) ) */
+
+		#if ( configUSE_TICK_HOOK == 1 )
+		{
+			/* Guard against the tick hook being called when the pended tick
+			count is being unwound (when the scheduler is being unlocked). */
+			if( uxPendedTicks == ( UBaseType_t ) 0U )
+			{
+				vApplicationTickHook();
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+		}
+		#endif /* configUSE_TICK_HOOK */
+	}
+	else
+	{
+		++uxPendedTicks;
+
+		/* The tick hook gets called at regular intervals, even if the
+		scheduler is locked. */
+		#if ( configUSE_TICK_HOOK == 1 )
+		{
+			vApplicationTickHook();
+		}
+		#endif
+	}
+
+	#if ( configUSE_PREEMPTION == 1 )
+	{
+		if( xYieldPending != pdFALSE )
+		{
+			xSwitchRequired = pdTRUE;
+		}
+		else
+		{
+			mtCOVERAGE_TEST_MARKER();
+		}
+	}
+	#endif /* configUSE_PREEMPTION */
+
+	return xSwitchRequired;
+}
+/*-----------------------------------------------------------*/
+
+#if ( configUSE_APPLICATION_TASK_TAG == 1 )
+
+	void vTaskSetApplicationTaskTag( TaskHandle_t xTask, TaskHookFunction_t pxHookFunction )
+	{
+	TCB_t *xTCB;
+
+		/* If xTask is NULL then it is the task hook of the calling task that is
+		getting set. */
+		if( xTask == NULL )
+		{
+			xTCB = ( TCB_t * ) pxCurrentTCB;
+		}
+		else
+		{
+			xTCB = ( TCB_t * ) xTask;
+		}
+
+		/* Save the hook function in the TCB.  A critical section is required as
+		the value can be accessed from an interrupt. */
+		taskENTER_CRITICAL();
+			xTCB->pxTaskTag = pxHookFunction;
+		taskEXIT_CRITICAL();
+	}
+
+#endif /* configUSE_APPLICATION_TASK_TAG */
+/*-----------------------------------------------------------*/
+
+#if ( configUSE_APPLICATION_TASK_TAG == 1 )
+
+	TaskHookFunction_t xTaskGetApplicationTaskTag( TaskHandle_t xTask )
+	{
+	TCB_t *xTCB;
+	TaskHookFunction_t xReturn;
+
+		/* If xTask is NULL then we are setting our own task hook. */
+		if( xTask == NULL )
+		{
+			xTCB = ( TCB_t * ) pxCurrentTCB;
+		}
+		else
+		{
+			xTCB = ( TCB_t * ) xTask;
+		}
+
+		/* Save the hook function in the TCB.  A critical section is required as
+		the value can be accessed from an interrupt. */
+		taskENTER_CRITICAL();
+		{
+			xReturn = xTCB->pxTaskTag;
+		}
+		taskEXIT_CRITICAL();
+
+		return xReturn;
+	}
+
+#endif /* configUSE_APPLICATION_TASK_TAG */
+/*-----------------------------------------------------------*/
+
+#if ( configUSE_APPLICATION_TASK_TAG == 1 )
+
+	BaseType_t xTaskCallApplicationTaskHook( TaskHandle_t xTask, void *pvParameter )
+	{
+	TCB_t *xTCB;
+	BaseType_t xReturn;
+
+		/* If xTask is NULL then we are calling our own task hook. */
+		if( xTask == NULL )
+		{
+			xTCB = ( TCB_t * ) pxCurrentTCB;
+		}
+		else
+		{
+			xTCB = ( TCB_t * ) xTask;
+		}
+
+		if( xTCB->pxTaskTag != NULL )
+		{
+			xReturn = xTCB->pxTaskTag( pvParameter );
+		}
+		else
+		{
+			xReturn = pdFAIL;
+		}
+
+		return xReturn;
+	}
+
+#endif /* configUSE_APPLICATION_TASK_TAG */
+/*-----------------------------------------------------------*/
+
+void vTaskSwitchContext( void )
+{
+	if( uxSchedulerSuspended != ( UBaseType_t ) pdFALSE )
+	{
+		/* The scheduler is currently suspended - do not allow a context
+		switch. */
+		xYieldPending = pdTRUE;
+	}
+	else
+	{
+		xYieldPending = pdFALSE;
+		traceTASK_SWITCHED_OUT();
+
+		#if ( configGENERATE_RUN_TIME_STATS == 1 )
+		{
+				#ifdef portALT_GET_RUN_TIME_COUNTER_VALUE
+					portALT_GET_RUN_TIME_COUNTER_VALUE( ulTotalRunTime );
+				#else
+					ulTotalRunTime = portGET_RUN_TIME_COUNTER_VALUE();
+				#endif
+
+				/* Add the amount of time the task has been running to the
+				accumulated time so far.  The time the task started running was
+				stored in ulTaskSwitchedInTime.  Note that there is no overflow
+				protection here so count values are only valid until the timer
+				overflows.  The guard against negative values is to protect
+				against suspect run time stat counter implementations - which
+				are provided by the application, not the kernel. */
+				if( ulTotalRunTime > ulTaskSwitchedInTime )
+				{
+					pxCurrentTCB->ulRunTimeCounter += ( ulTotalRunTime - ulTaskSwitchedInTime );
+				}
+				else
+				{
+					mtCOVERAGE_TEST_MARKER();
+				}
+				ulTaskSwitchedInTime = ulTotalRunTime;
+		}
+		#endif /* configGENERATE_RUN_TIME_STATS */
+
+		/* Check for stack overflow, if configured. */
+		taskCHECK_FOR_STACK_OVERFLOW();
+
+		/* Select a new task to run using either the generic C or port
+		optimised asm code. */
+		taskSELECT_HIGHEST_PRIORITY_TASK();
+		traceTASK_SWITCHED_IN();
+
+		#if ( configUSE_NEWLIB_REENTRANT == 1 )
+		{
+			/* Switch Newlib's _impure_ptr variable to point to the _reent
+			structure specific to this task. */
+			_impure_ptr = &( pxCurrentTCB->xNewLib_reent );
+		}
+		#endif /* configUSE_NEWLIB_REENTRANT */
+	}
+}
+/*-----------------------------------------------------------*/
+
+void vTaskPlaceOnEventList( List_t * const pxEventList, const TickType_t xTicksToWait )
+{
+	configASSERT( pxEventList );
+
+	/* THIS FUNCTION MUST BE CALLED WITH EITHER INTERRUPTS DISABLED OR THE
+	SCHEDULER SUSPENDED AND THE QUEUE BEING ACCESSED LOCKED. */
+
+	/* Place the event list item of the TCB in the appropriate event list.
+	This is placed in the list in priority order so the highest priority task
+	is the first to be woken by the event.  The queue that contains the event
+	list is locked, preventing simultaneous access from interrupts. */
+	vListInsert( pxEventList, &( pxCurrentTCB->xEventListItem ) );
+
+	prvAddCurrentTaskToDelayedList( xTicksToWait, pdTRUE );
+}
+/*-----------------------------------------------------------*/
+
+void vTaskPlaceOnUnorderedEventList( List_t * pxEventList, const TickType_t xItemValue, const TickType_t xTicksToWait )
+{
+	configASSERT( pxEventList );
+
+	/* THIS FUNCTION MUST BE CALLED WITH THE SCHEDULER SUSPENDED.  It is used by
+	the event groups implementation. */
+	configASSERT( uxSchedulerSuspended != 0 );
+
+	/* Store the item value in the event list item.  It is safe to access the
+	event list item here as interrupts won't access the event list item of a
+	task that is not in the Blocked state. */
+	listSET_LIST_ITEM_VALUE( &( pxCurrentTCB->xEventListItem ), xItemValue | taskEVENT_LIST_ITEM_VALUE_IN_USE );
+
+	/* Place the event list item of the TCB at the end of the appropriate event
+	list.  It is safe to access the event list here because it is part of an
+	event group implementation - and interrupts don't access event groups
+	directly (instead they access them indirectly by pending function calls to
+	the task level). */
+	vListInsertEnd( pxEventList, &( pxCurrentTCB->xEventListItem ) );
+
+	prvAddCurrentTaskToDelayedList( xTicksToWait, pdTRUE );
+}
+/*-----------------------------------------------------------*/
+
+#if( configUSE_TIMERS == 1 )
+
+	void vTaskPlaceOnEventListRestricted( List_t * const pxEventList, TickType_t xTicksToWait, const BaseType_t xWaitIndefinitely )
+	{
+		configASSERT( pxEventList );
+
+		/* This function should not be called by application code hence the
+		'Restricted' in its name.  It is not part of the public API.  It is
+		designed for use by kernel code, and has special calling requirements -
+		it should be called with the scheduler suspended. */
+
+
+		/* Place the event list item of the TCB in the appropriate event list.
+		In this case it is assume that this is the only task that is going to
+		be waiting on this event list, so the faster vListInsertEnd() function
+		can be used in place of vListInsert. */
+		vListInsertEnd( pxEventList, &( pxCurrentTCB->xEventListItem ) );
+
+		/* If the task should block indefinitely then set the block time to a
+		value that will be recognised as an indefinite delay inside the
+		prvAddCurrentTaskToDelayedList() function. */
+		if( xWaitIndefinitely != pdFALSE )
+		{
+			xTicksToWait = portMAX_DELAY;
+		}
+
+		traceTASK_DELAY_UNTIL( ( xTickCount + xTicksToWait ) );
+		prvAddCurrentTaskToDelayedList( xTicksToWait, xWaitIndefinitely );
+	}
+
+#endif /* configUSE_TIMERS */
+/*-----------------------------------------------------------*/
+
+BaseType_t xTaskRemoveFromEventList( const List_t * const pxEventList )
+{
+TCB_t *pxUnblockedTCB;
+BaseType_t xReturn;
+
+	/* THIS FUNCTION MUST BE CALLED FROM A CRITICAL SECTION.  It can also be
+	called from a critical section within an ISR. */
+
+	/* The event list is sorted in priority order, so the first in the list can
+	be removed as it is known to be the highest priority.  Remove the TCB from
+	the delayed list, and add it to the ready list.
+
+	If an event is for a queue that is locked then this function will never
+	get called - the lock count on the queue will get modified instead.  This
+	means exclusive access to the event list is guaranteed here.
+
+	This function assumes that a check has already been made to ensure that
+	pxEventList is not empty. */
+	pxUnblockedTCB = ( TCB_t * ) listGET_OWNER_OF_HEAD_ENTRY( pxEventList );
+	configASSERT( pxUnblockedTCB );
+	( void ) uxListRemove( &( pxUnblockedTCB->xEventListItem ) );
+
+	if( uxSchedulerSuspended == ( UBaseType_t ) pdFALSE )
+	{
+		( void ) uxListRemove( &( pxUnblockedTCB->xStateListItem ) );
+		prvAddTaskToReadyList( pxUnblockedTCB );
+	}
+	else
+	{
+		/* The delayed and ready lists cannot be accessed, so hold this task
+		pending until the scheduler is resumed. */
+		vListInsertEnd( &( xPendingReadyList ), &( pxUnblockedTCB->xEventListItem ) );
+	}
+
+	if( pxUnblockedTCB->uxPriority > pxCurrentTCB->uxPriority )
+	{
+		/* Return true if the task removed from the event list has a higher
+		priority than the calling task.  This allows the calling task to know if
+		it should force a context switch now. */
+		xReturn = pdTRUE;
+
+		/* Mark that a yield is pending in case the user is not using the
+		"xHigherPriorityTaskWoken" parameter to an ISR safe FreeRTOS function. */
+		xYieldPending = pdTRUE;
+	}
+	else
+	{
+		xReturn = pdFALSE;
+	}
+
+	#if( configUSE_TICKLESS_IDLE != 0 )
+	{
+		/* If a task is blocked on a kernel object then xNextTaskUnblockTime
+		might be set to the blocked task's time out time.  If the task is
+		unblocked for a reason other than a timeout xNextTaskUnblockTime is
+		normally left unchanged, because it is automatically reset to a new
+		value when the tick count equals xNextTaskUnblockTime.  However if
+		tickless idling is used it might be more important to enter sleep mode
+		at the earliest possible time - so reset xNextTaskUnblockTime here to
+		ensure it is updated at the earliest possible time. */
+		prvResetNextTaskUnblockTime();
+	}
+	#endif
+
+	return xReturn;
+}
+/*-----------------------------------------------------------*/
+
+BaseType_t xTaskRemoveFromUnorderedEventList( ListItem_t * pxEventListItem, const TickType_t xItemValue )
+{
+TCB_t *pxUnblockedTCB;
+BaseType_t xReturn;
+
+	/* THIS FUNCTION MUST BE CALLED WITH THE SCHEDULER SUSPENDED.  It is used by
+	the event flags implementation. */
+	configASSERT( uxSchedulerSuspended != pdFALSE );
+
+	/* Store the new item value in the event list. */
+	listSET_LIST_ITEM_VALUE( pxEventListItem, xItemValue | taskEVENT_LIST_ITEM_VALUE_IN_USE );
+
+	/* Remove the event list form the event flag.  Interrupts do not access
+	event flags. */
+	pxUnblockedTCB = ( TCB_t * ) listGET_LIST_ITEM_OWNER( pxEventListItem );
+	configASSERT( pxUnblockedTCB );
+	( void ) uxListRemove( pxEventListItem );
+
+	/* Remove the task from the delayed list and add it to the ready list.  The
+	scheduler is suspended so interrupts will not be accessing the ready
+	lists. */
+	( void ) uxListRemove( &( pxUnblockedTCB->xStateListItem ) );
+	prvAddTaskToReadyList( pxUnblockedTCB );
+
+	if( pxUnblockedTCB->uxPriority > pxCurrentTCB->uxPriority )
+	{
+		/* Return true if the task removed from the event list has
+		a higher priority than the calling task.  This allows
+		the calling task to know if it should force a context
+		switch now. */
+		xReturn = pdTRUE;
+
+		/* Mark that a yield is pending in case the user is not using the
+		"xHigherPriorityTaskWoken" parameter to an ISR safe FreeRTOS function. */
+		xYieldPending = pdTRUE;
+	}
+	else
+	{
+		xReturn = pdFALSE;
+	}
+
+	return xReturn;
+}
+/*-----------------------------------------------------------*/
+
+void vTaskSetTimeOutState( TimeOut_t * const pxTimeOut )
+{
+	configASSERT( pxTimeOut );
+	pxTimeOut->xOverflowCount = xNumOfOverflows;
+	pxTimeOut->xTimeOnEntering = xTickCount;
+}
+/*-----------------------------------------------------------*/
+
+BaseType_t xTaskCheckForTimeOut( TimeOut_t * const pxTimeOut, TickType_t * const pxTicksToWait )
+{
+BaseType_t xReturn;
+
+	configASSERT( pxTimeOut );
+	configASSERT( pxTicksToWait );
+
+	taskENTER_CRITICAL();
+	{
+		/* Minor optimisation.  The tick count cannot change in this block. */
+		const TickType_t xConstTickCount = xTickCount;
+
+		#if( INCLUDE_xTaskAbortDelay == 1 )
+			if( pxCurrentTCB->ucDelayAborted != pdFALSE )
+			{
+				/* The delay was aborted, which is not the same as a time out,
+				but has the same result. */
+				pxCurrentTCB->ucDelayAborted = pdFALSE;
+				xReturn = pdTRUE;
+			}
+			else
+		#endif
+
+		#if ( INCLUDE_vTaskSuspend == 1 )
+			if( *pxTicksToWait == portMAX_DELAY )
+			{
+				/* If INCLUDE_vTaskSuspend is set to 1 and the block time
+				specified is the maximum block time then the task should block
+				indefinitely, and therefore never time out. */
+				xReturn = pdFALSE;
+			}
+			else
+		#endif
+
+		if( ( xNumOfOverflows != pxTimeOut->xOverflowCount ) && ( xConstTickCount >= pxTimeOut->xTimeOnEntering ) ) /*lint !e525 Indentation preferred as is to make code within pre-processor directives clearer. */
+		{
+			/* The tick count is greater than the time at which
+			vTaskSetTimeout() was called, but has also overflowed since
+			vTaskSetTimeOut() was called.  It must have wrapped all the way
+			around and gone past again. This passed since vTaskSetTimeout()
+			was called. */
+			xReturn = pdTRUE;
+		}
+		else if( ( ( TickType_t ) ( xConstTickCount - pxTimeOut->xTimeOnEntering ) ) < *pxTicksToWait ) /*lint !e961 Explicit casting is only redundant with some compilers, whereas others require it to prevent integer conversion errors. */
+		{
+			/* Not a genuine timeout. Adjust parameters for time remaining. */
+			*pxTicksToWait -= ( xConstTickCount - pxTimeOut->xTimeOnEntering );
+			vTaskSetTimeOutState( pxTimeOut );
+			xReturn = pdFALSE;
+		}
+		else
+		{
+			xReturn = pdTRUE;
+		}
+	}
+	taskEXIT_CRITICAL();
+
+	return xReturn;
+}
+/*-----------------------------------------------------------*/
+
+void vTaskMissedYield( void )
+{
+	xYieldPending = pdTRUE;
+}
+/*-----------------------------------------------------------*/
+
+#if ( configUSE_TRACE_FACILITY == 1 )
+
+	UBaseType_t uxTaskGetTaskNumber( TaskHandle_t xTask )
+	{
+	UBaseType_t uxReturn;
+	TCB_t *pxTCB;
+
+		if( xTask != NULL )
+		{
+			pxTCB = ( TCB_t * ) xTask;
+			uxReturn = pxTCB->uxTaskNumber;
+		}
+		else
+		{
+			uxReturn = 0U;
+		}
+
+		return uxReturn;
+	}
+
+#endif /* configUSE_TRACE_FACILITY */
+/*-----------------------------------------------------------*/
+
+#if ( configUSE_TRACE_FACILITY == 1 )
+
+	void vTaskSetTaskNumber( TaskHandle_t xTask, const UBaseType_t uxHandle )
+	{
+	TCB_t *pxTCB;
+
+		if( xTask != NULL )
+		{
+			pxTCB = ( TCB_t * ) xTask;
+			pxTCB->uxTaskNumber = uxHandle;
+		}
+	}
+
+#endif /* configUSE_TRACE_FACILITY */
+
+/*
+ * -----------------------------------------------------------
+ * The Idle task.
+ * ----------------------------------------------------------
+ *
+ * The portTASK_FUNCTION() macro is used to allow port/compiler specific
+ * language extensions.  The equivalent prototype for this function is:
+ *
+ * void prvIdleTask( void *pvParameters );
+ *
+ */
+static portTASK_FUNCTION( prvIdleTask, pvParameters )
+{
+	/* Stop warnings. */
+	( void ) pvParameters;
+
+	/** THIS IS THE RTOS IDLE TASK - WHICH IS CREATED AUTOMATICALLY WHEN THE
+	SCHEDULER IS STARTED. **/
+
+	for( ;; )
+	{
+		/* See if any tasks have deleted themselves - if so then the idle task
+		is responsible for freeing the deleted task's TCB and stack. */
+		prvCheckTasksWaitingTermination();
+
+		#if ( configUSE_PREEMPTION == 0 )
+		{
+			/* If we are not using preemption we keep forcing a task switch to
+			see if any other task has become available.  If we are using
+			preemption we don't need to do this as any task becoming available
+			will automatically get the processor anyway. */
+			taskYIELD();
+		}
+		#endif /* configUSE_PREEMPTION */
+
+		#if ( ( configUSE_PREEMPTION == 1 ) && ( configIDLE_SHOULD_YIELD == 1 ) )
+		{
+			/* When using preemption tasks of equal priority will be
+			timesliced.  If a task that is sharing the idle priority is ready
+			to run then the idle task should yield before the end of the
+			timeslice.
+
+			A critical region is not required here as we are just reading from
+			the list, and an occasional incorrect value will not matter.  If
+			the ready list at the idle priority contains more than one task
+			then a task other than the idle task is ready to execute. */
+			if( listCURRENT_LIST_LENGTH( &( pxReadyTasksLists[ tskIDLE_PRIORITY ] ) ) > ( UBaseType_t ) 1 )
+			{
+				taskYIELD();
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+		}
+		#endif /* ( ( configUSE_PREEMPTION == 1 ) && ( configIDLE_SHOULD_YIELD == 1 ) ) */
+
+		#if ( configUSE_IDLE_HOOK == 1 )
+		{
+			extern void vApplicationIdleHook( void );
+
+			/* Call the user defined function from within the idle task.  This
+			allows the application designer to add background functionality
+			without the overhead of a separate task.
+			NOTE: vApplicationIdleHook() MUST NOT, UNDER ANY CIRCUMSTANCES,
+			CALL A FUNCTION THAT MIGHT BLOCK. */
+			vApplicationIdleHook();
+		}
+		#endif /* configUSE_IDLE_HOOK */
+
+		/* This conditional compilation should use inequality to 0, not equality
+		to 1.  This is to ensure portSUPPRESS_TICKS_AND_SLEEP() is called when
+		user defined low power mode	implementations require
+		configUSE_TICKLESS_IDLE to be set to a value other than 1. */
+		#if ( configUSE_TICKLESS_IDLE != 0 )
+		{
+		TickType_t xExpectedIdleTime;
+
+			/* It is not desirable to suspend then resume the scheduler on
+			each iteration of the idle task.  Therefore, a preliminary
+			test of the expected idle time is performed without the
+			scheduler suspended.  The result here is not necessarily
+			valid. */
+			xExpectedIdleTime = prvGetExpectedIdleTime();
+
+			if( xExpectedIdleTime >= configEXPECTED_IDLE_TIME_BEFORE_SLEEP )
+			{
+				vTaskSuspendAll();
+				{
+					/* Now the scheduler is suspended, the expected idle
+					time can be sampled again, and this time its value can
+					be used. */
+					configASSERT( xNextTaskUnblockTime >= xTickCount );
+					xExpectedIdleTime = prvGetExpectedIdleTime();
+
+					if( xExpectedIdleTime >= configEXPECTED_IDLE_TIME_BEFORE_SLEEP )
+					{
+						traceLOW_POWER_IDLE_BEGIN();
+						portSUPPRESS_TICKS_AND_SLEEP( xExpectedIdleTime );
+						traceLOW_POWER_IDLE_END();
+					}
+					else
+					{
+						mtCOVERAGE_TEST_MARKER();
+					}
+				}
+				( void ) xTaskResumeAll();
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+		}
+		#endif /* configUSE_TICKLESS_IDLE */
+	}
+}
+/*-----------------------------------------------------------*/
+
+#if( configUSE_TICKLESS_IDLE != 0 )
+
+	eSleepModeStatus eTaskConfirmSleepModeStatus( void )
+	{
+	/* The idle task exists in addition to the application tasks. */
+	const UBaseType_t uxNonApplicationTasks = 1;
+	eSleepModeStatus eReturn = eStandardSleep;
+
+		if( listCURRENT_LIST_LENGTH( &xPendingReadyList ) != 0 )
+		{
+			/* A task was made ready while the scheduler was suspended. */
+			eReturn = eAbortSleep;
+		}
+		else if( xYieldPending != pdFALSE )
+		{
+			/* A yield was pended while the scheduler was suspended. */
+			eReturn = eAbortSleep;
+		}
+		else
+		{
+			/* If all the tasks are in the suspended list (which might mean they
+			have an infinite block time rather than actually being suspended)
+			then it is safe to turn all clocks off and just wait for external
+			interrupts. */
+			if( listCURRENT_LIST_LENGTH( &xSuspendedTaskList ) == ( uxCurrentNumberOfTasks - uxNonApplicationTasks ) )
+			{
+				eReturn = eNoTasksWaitingTimeout;
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+		}
+
+		return eReturn;
+	}
+
+#endif /* configUSE_TICKLESS_IDLE */
+/*-----------------------------------------------------------*/
+
+#if ( configNUM_THREAD_LOCAL_STORAGE_POINTERS != 0 )
+
+	void vTaskSetThreadLocalStoragePointer( TaskHandle_t xTaskToSet, BaseType_t xIndex, void *pvValue )
+	{
+	TCB_t *pxTCB;
+
+		if( xIndex < configNUM_THREAD_LOCAL_STORAGE_POINTERS )
+		{
+			pxTCB = prvGetTCBFromHandle( xTaskToSet );
+			pxTCB->pvThreadLocalStoragePointers[ xIndex ] = pvValue;
+		}
+	}
+
+#endif /* configNUM_THREAD_LOCAL_STORAGE_POINTERS */
+/*-----------------------------------------------------------*/
+
+#if ( configNUM_THREAD_LOCAL_STORAGE_POINTERS != 0 )
+
+	void *pvTaskGetThreadLocalStoragePointer( TaskHandle_t xTaskToQuery, BaseType_t xIndex )
+	{
+	void *pvReturn = NULL;
+	TCB_t *pxTCB;
+
+		if( xIndex < configNUM_THREAD_LOCAL_STORAGE_POINTERS )
+		{
+			pxTCB = prvGetTCBFromHandle( xTaskToQuery );
+			pvReturn = pxTCB->pvThreadLocalStoragePointers[ xIndex ];
+		}
+		else
+		{
+			pvReturn = NULL;
+		}
+
+		return pvReturn;
+	}
+
+#endif /* configNUM_THREAD_LOCAL_STORAGE_POINTERS */
+/*-----------------------------------------------------------*/
+
+#if ( portUSING_MPU_WRAPPERS == 1 )
+
+	void vTaskAllocateMPURegions( TaskHandle_t xTaskToModify, const MemoryRegion_t * const xRegions )
+	{
+	TCB_t *pxTCB;
+
+		/* If null is passed in here then we are modifying the MPU settings of
+		the calling task. */
+		pxTCB = prvGetTCBFromHandle( xTaskToModify );
+
+		vPortStoreTaskMPUSettings( &( pxTCB->xMPUSettings ), xRegions, NULL, 0 );
+	}
+
+#endif /* portUSING_MPU_WRAPPERS */
+/*-----------------------------------------------------------*/
+
+static void prvInitialiseTaskLists( void )
+{
+UBaseType_t uxPriority;
+
+	for( uxPriority = ( UBaseType_t ) 0U; uxPriority < ( UBaseType_t ) configMAX_PRIORITIES; uxPriority++ )
+	{
+		vListInitialise( &( pxReadyTasksLists[ uxPriority ] ) );
+	}
+
+	vListInitialise( &xDelayedTaskList1 );
+	vListInitialise( &xDelayedTaskList2 );
+	vListInitialise( &xPendingReadyList );
+
+	#if ( INCLUDE_vTaskDelete == 1 )
+	{
+		vListInitialise( &xTasksWaitingTermination );
+	}
+	#endif /* INCLUDE_vTaskDelete */
+
+	#if ( INCLUDE_vTaskSuspend == 1 )
+	{
+		vListInitialise( &xSuspendedTaskList );
+	}
+	#endif /* INCLUDE_vTaskSuspend */
+
+	/* Start with pxDelayedTaskList using list1 and the pxOverflowDelayedTaskList
+	using list2. */
+	pxDelayedTaskList = &xDelayedTaskList1;
+	pxOverflowDelayedTaskList = &xDelayedTaskList2;
+}
+/*-----------------------------------------------------------*/
+
+static void prvCheckTasksWaitingTermination( void )
+{
+
+	/** THIS FUNCTION IS CALLED FROM THE RTOS IDLE TASK **/
+
+	#if ( INCLUDE_vTaskDelete == 1 )
+	{
+		BaseType_t xListIsEmpty;
+
+		/* ucTasksDeleted is used to prevent vTaskSuspendAll() being called
+		too often in the idle task. */
+		while( uxDeletedTasksWaitingCleanUp > ( UBaseType_t ) 0U )
+		{
+			vTaskSuspendAll();
+			{
+				xListIsEmpty = listLIST_IS_EMPTY( &xTasksWaitingTermination );
+			}
+			( void ) xTaskResumeAll();
+
+			if( xListIsEmpty == pdFALSE )
+			{
+				TCB_t *pxTCB;
+
+				taskENTER_CRITICAL();
+				{
+					pxTCB = ( TCB_t * ) listGET_OWNER_OF_HEAD_ENTRY( ( &xTasksWaitingTermination ) );
+					( void ) uxListRemove( &( pxTCB->xStateListItem ) );
+					--uxCurrentNumberOfTasks;
+					--uxDeletedTasksWaitingCleanUp;
+				}
+				taskEXIT_CRITICAL();
+
+				prvDeleteTCB( pxTCB );
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+		}
+	}
+	#endif /* INCLUDE_vTaskDelete */
+}
+/*-----------------------------------------------------------*/
+
+#if( configUSE_TRACE_FACILITY == 1 )
+
+	void vTaskGetInfo( TaskHandle_t xTask, TaskStatus_t *pxTaskStatus, BaseType_t xGetFreeStackSpace, eTaskState eState )
+	{
+	TCB_t *pxTCB;
+
+		/* xTask is NULL then get the state of the calling task. */
+		pxTCB = prvGetTCBFromHandle( xTask );
+
+		pxTaskStatus->xHandle = ( TaskHandle_t ) pxTCB;
+		pxTaskStatus->pcTaskName = ( const char * ) &( pxTCB->pcTaskName [ 0 ] );
+		pxTaskStatus->uxCurrentPriority = pxTCB->uxPriority;
+		pxTaskStatus->pxStackBase = pxTCB->pxStack;
+		pxTaskStatus->xTaskNumber = pxTCB->uxTCBNumber;
+
+		#if ( INCLUDE_vTaskSuspend == 1 )
+		{
+			/* If the task is in the suspended list then there is a chance it is
+			actually just blocked indefinitely - so really it should be reported as
+			being in the Blocked state. */
+			if( pxTaskStatus->eCurrentState == eSuspended )
+			{
+				vTaskSuspendAll();
+				{
+					if( listLIST_ITEM_CONTAINER( &( pxTCB->xEventListItem ) ) != NULL )
+					{
+						pxTaskStatus->eCurrentState = eBlocked;
+					}
+				}
+				xTaskResumeAll();
+			}
+		}
+		#endif /* INCLUDE_vTaskSuspend */
+
+		#if ( configUSE_MUTEXES == 1 )
+		{
+			pxTaskStatus->uxBasePriority = pxTCB->uxBasePriority;
+		}
+		#else
+		{
+			pxTaskStatus->uxBasePriority = 0;
+		}
+		#endif
+
+		#if ( configGENERATE_RUN_TIME_STATS == 1 )
+		{
+			pxTaskStatus->ulRunTimeCounter = pxTCB->ulRunTimeCounter;
+		}
+		#else
+		{
+			pxTaskStatus->ulRunTimeCounter = 0;
+		}
+		#endif
+
+		/* Obtaining the task state is a little fiddly, so is only done if the value
+		of eState passed into this function is eInvalid - otherwise the state is
+		just set to whatever is passed in. */
+		if( eState != eInvalid )
+		{
+			pxTaskStatus->eCurrentState = eState;
+		}
+		else
+		{
+			pxTaskStatus->eCurrentState = eTaskGetState( xTask );
+		}
+
+		/* Obtaining the stack space takes some time, so the xGetFreeStackSpace
+		parameter is provided to allow it to be skipped. */
+		if( xGetFreeStackSpace != pdFALSE )
+		{
+			#if ( portSTACK_GROWTH > 0 )
+			{
+				pxTaskStatus->usStackHighWaterMark = prvTaskCheckFreeStackSpace( ( uint8_t * ) pxTCB->pxEndOfStack );
+			}
+			#else
+			{
+				pxTaskStatus->usStackHighWaterMark = prvTaskCheckFreeStackSpace( ( uint8_t * ) pxTCB->pxStack );
+			}
+			#endif
+		}
+		else
+		{
+			pxTaskStatus->usStackHighWaterMark = 0;
+		}
+	}
+
+#endif /* configUSE_TRACE_FACILITY */
+/*-----------------------------------------------------------*/
+
+#if ( configUSE_TRACE_FACILITY == 1 )
+
+	static UBaseType_t prvListTasksWithinSingleList( TaskStatus_t *pxTaskStatusArray, List_t *pxList, eTaskState eState )
+	{
+	volatile TCB_t *pxNextTCB, *pxFirstTCB;
+	UBaseType_t uxTask = 0;
+
+		if( listCURRENT_LIST_LENGTH( pxList ) > ( UBaseType_t ) 0 )
+		{
+			listGET_OWNER_OF_NEXT_ENTRY( pxFirstTCB, pxList );
+
+			/* Populate an TaskStatus_t structure within the
+			pxTaskStatusArray array for each task that is referenced from
+			pxList.  See the definition of TaskStatus_t in task.h for the
+			meaning of each TaskStatus_t structure member. */
+			do
+			{
+				listGET_OWNER_OF_NEXT_ENTRY( pxNextTCB, pxList );
+				vTaskGetInfo( ( TaskHandle_t ) pxNextTCB, &( pxTaskStatusArray[ uxTask ] ), pdTRUE, eState );
+				uxTask++;
+			} while( pxNextTCB != pxFirstTCB );
+		}
+		else
+		{
+			mtCOVERAGE_TEST_MARKER();
+		}
+
+		return uxTask;
+	}
+
+#endif /* configUSE_TRACE_FACILITY */
+/*-----------------------------------------------------------*/
+
+#if ( ( configUSE_TRACE_FACILITY == 1 ) || ( INCLUDE_uxTaskGetStackHighWaterMark == 1 ) )
+
+	static uint16_t prvTaskCheckFreeStackSpace( const uint8_t * pucStackByte )
+	{
+	uint32_t ulCount = 0U;
+
+		while( *pucStackByte == ( uint8_t ) tskSTACK_FILL_BYTE )
+		{
+			pucStackByte -= portSTACK_GROWTH;
+			ulCount++;
+		}
+
+		ulCount /= ( uint32_t ) sizeof( StackType_t ); /*lint !e961 Casting is not redundant on smaller architectures. */
+
+		return ( uint16_t ) ulCount;
+	}
+
+#endif /* ( ( configUSE_TRACE_FACILITY == 1 ) || ( INCLUDE_uxTaskGetStackHighWaterMark == 1 ) ) */
+/*-----------------------------------------------------------*/
+
+#if ( INCLUDE_uxTaskGetStackHighWaterMark == 1 )
+
+	UBaseType_t uxTaskGetStackHighWaterMark( TaskHandle_t xTask )
+	{
+	TCB_t *pxTCB;
+	uint8_t *pucEndOfStack;
+	UBaseType_t uxReturn;
+
+		pxTCB = prvGetTCBFromHandle( xTask );
+
+		#if portSTACK_GROWTH < 0
+		{
+			pucEndOfStack = ( uint8_t * ) pxTCB->pxStack;
+		}
+		#else
+		{
+			pucEndOfStack = ( uint8_t * ) pxTCB->pxEndOfStack;
+		}
+		#endif
+
+		uxReturn = ( UBaseType_t ) prvTaskCheckFreeStackSpace( pucEndOfStack );
+
+		return uxReturn;
+	}
+
+#endif /* INCLUDE_uxTaskGetStackHighWaterMark */
+/*-----------------------------------------------------------*/
+
+#if ( INCLUDE_vTaskDelete == 1 )
+
+	static void prvDeleteTCB( TCB_t *pxTCB )
+	{
+		/* This call is required specifically for the TriCore port.  It must be
+		above the vPortFree() calls.  The call is also used by ports/demos that
+		want to allocate and clean RAM statically. */
+		portCLEAN_UP_TCB( pxTCB );
+
+		/* Free up the memory allocated by the scheduler for the task.  It is up
+		to the task to free any memory allocated at the application level. */
+		#if ( configUSE_NEWLIB_REENTRANT == 1 )
+		{
+			_reclaim_reent( &( pxTCB->xNewLib_reent ) );
+		}
+		#endif /* configUSE_NEWLIB_REENTRANT */
+
+		#if( ( configSUPPORT_DYNAMIC_ALLOCATION == 1 ) && ( configSUPPORT_STATIC_ALLOCATION == 0 ) && ( portUSING_MPU_WRAPPERS == 0 ) )
+		{
+			/* The task can only have been allocated dynamically - free both
+			the stack and TCB. */
+			vPortFree( pxTCB->pxStack );
+			vPortFree( pxTCB );
+		}
+		#elif( tskSTATIC_AND_DYNAMIC_ALLOCATION_POSSIBLE == 1 )
+		{
+			/* The task could have been allocated statically or dynamically, so
+			check what was statically allocated before trying to free the
+			memory. */
+			if( pxTCB->ucStaticallyAllocated == tskDYNAMICALLY_ALLOCATED_STACK_AND_TCB )
+			{
+				/* Both the stack and TCB were allocated dynamically, so both
+				must be freed. */
+				vPortFree( pxTCB->pxStack );
+				vPortFree( pxTCB );
+			}
+			else if( pxTCB->ucStaticallyAllocated == tskSTATICALLY_ALLOCATED_STACK_ONLY )
+			{
+				/* Only the stack was statically allocated, so the TCB is the
+				only memory that must be freed. */
+				vPortFree( pxTCB );
+			}
+			else
+			{
+				/* Neither the stack nor the TCB were allocated dynamically, so
+				nothing needs to be freed. */
+				configASSERT( pxTCB->ucStaticallyAllocated == tskSTATICALLY_ALLOCATED_STACK_AND_TCB	)
+				mtCOVERAGE_TEST_MARKER();
+			}
+		}
+		#endif /* configSUPPORT_DYNAMIC_ALLOCATION */
+	}
+
+#endif /* INCLUDE_vTaskDelete */
+/*-----------------------------------------------------------*/
+
+static void prvResetNextTaskUnblockTime( void )
+{
+TCB_t *pxTCB;
+
+	if( listLIST_IS_EMPTY( pxDelayedTaskList ) != pdFALSE )
+	{
+		/* The new current delayed list is empty.  Set xNextTaskUnblockTime to
+		the maximum possible value so it is	extremely unlikely that the
+		if( xTickCount >= xNextTaskUnblockTime ) test will pass until
+		there is an item in the delayed list. */
+		xNextTaskUnblockTime = portMAX_DELAY;
+	}
+	else
+	{
+		/* The new current delayed list is not empty, get the value of
+		the item at the head of the delayed list.  This is the time at
+		which the task at the head of the delayed list should be removed
+		from the Blocked state. */
+		( pxTCB ) = ( TCB_t * ) listGET_OWNER_OF_HEAD_ENTRY( pxDelayedTaskList );
+		xNextTaskUnblockTime = listGET_LIST_ITEM_VALUE( &( ( pxTCB )->xStateListItem ) );
+	}
+}
+/*-----------------------------------------------------------*/
+
+#if ( ( INCLUDE_xTaskGetCurrentTaskHandle == 1 ) || ( configUSE_MUTEXES == 1 ) )
+
+	TaskHandle_t xTaskGetCurrentTaskHandle( void )
+	{
+	TaskHandle_t xReturn;
+
+		/* A critical section is not required as this is not called from
+		an interrupt and the current TCB will always be the same for any
+		individual execution thread. */
+		xReturn = pxCurrentTCB;
+
+		return xReturn;
+	}
+
+#endif /* ( ( INCLUDE_xTaskGetCurrentTaskHandle == 1 ) || ( configUSE_MUTEXES == 1 ) ) */
+/*-----------------------------------------------------------*/
+
+#if ( ( INCLUDE_xTaskGetSchedulerState == 1 ) || ( configUSE_TIMERS == 1 ) )
+
+	BaseType_t xTaskGetSchedulerState( void )
+	{
+	BaseType_t xReturn;
+
+		if( xSchedulerRunning == pdFALSE )
+		{
+			xReturn = taskSCHEDULER_NOT_STARTED;
+		}
+		else
+		{
+			if( uxSchedulerSuspended == ( UBaseType_t ) pdFALSE )
+			{
+				xReturn = taskSCHEDULER_RUNNING;
+			}
+			else
+			{
+				xReturn = taskSCHEDULER_SUSPENDED;
+			}
+		}
+
+		return xReturn;
+	}
+
+#endif /* ( ( INCLUDE_xTaskGetSchedulerState == 1 ) || ( configUSE_TIMERS == 1 ) ) */
+/*-----------------------------------------------------------*/
+
+#if ( configUSE_MUTEXES == 1 )
+
+	void vTaskPriorityInherit( TaskHandle_t const pxMutexHolder )
+	{
+	TCB_t * const pxTCB = ( TCB_t * ) pxMutexHolder;
+
+		/* If the mutex was given back by an interrupt while the queue was
+		locked then the mutex holder might now be NULL. */
+		if( pxMutexHolder != NULL )
+		{
+			/* If the holder of the mutex has a priority below the priority of
+			the task attempting to obtain the mutex then it will temporarily
+			inherit the priority of the task attempting to obtain the mutex. */
+			if( pxTCB->uxPriority < pxCurrentTCB->uxPriority )
+			{
+				/* Adjust the mutex holder state to account for its new
+				priority.  Only reset the event list item value if the value is
+				not	being used for anything else. */
+				if( ( listGET_LIST_ITEM_VALUE( &( pxTCB->xEventListItem ) ) & taskEVENT_LIST_ITEM_VALUE_IN_USE ) == 0UL )
+				{
+					listSET_LIST_ITEM_VALUE( &( pxTCB->xEventListItem ), ( TickType_t ) configMAX_PRIORITIES - ( TickType_t ) pxCurrentTCB->uxPriority ); /*lint !e961 MISRA exception as the casts are only redundant for some ports. */
+				}
+				else
+				{
+					mtCOVERAGE_TEST_MARKER();
+				}
+
+				/* If the task being modified is in the ready state it will need
+				to be moved into a new list. */
+				if( listIS_CONTAINED_WITHIN( &( pxReadyTasksLists[ pxTCB->uxPriority ] ), &( pxTCB->xStateListItem ) ) != pdFALSE )
+				{
+					if( uxListRemove( &( pxTCB->xStateListItem ) ) == ( UBaseType_t ) 0 )
+					{
+						taskRESET_READY_PRIORITY( pxTCB->uxPriority );
+					}
+					else
+					{
+						mtCOVERAGE_TEST_MARKER();
+					}
+
+					/* Inherit the priority before being moved into the new list. */
+					pxTCB->uxPriority = pxCurrentTCB->uxPriority;
+					prvAddTaskToReadyList( pxTCB );
+				}
+				else
+				{
+					/* Just inherit the priority. */
+					pxTCB->uxPriority = pxCurrentTCB->uxPriority;
+				}
+
+				traceTASK_PRIORITY_INHERIT( pxTCB, pxCurrentTCB->uxPriority );
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+		}
+		else
+		{
+			mtCOVERAGE_TEST_MARKER();
+		}
+	}
+
+#endif /* configUSE_MUTEXES */
+/*-----------------------------------------------------------*/
+
+#if ( configUSE_MUTEXES == 1 )
+
+	BaseType_t xTaskPriorityDisinherit( TaskHandle_t const pxMutexHolder )
+	{
+	TCB_t * const pxTCB = ( TCB_t * ) pxMutexHolder;
+	BaseType_t xReturn = pdFALSE;
+
+		if( pxMutexHolder != NULL )
+		{
+			/* A task can only have an inherited priority if it holds the mutex.
+			If the mutex is held by a task then it cannot be given from an
+			interrupt, and if a mutex is given by the holding task then it must
+			be the running state task. */
+			configASSERT( pxTCB == pxCurrentTCB );
+
+			configASSERT( pxTCB->uxMutexesHeld );
+			( pxTCB->uxMutexesHeld )--;
+
+			/* Has the holder of the mutex inherited the priority of another
+			task? */
+			if( pxTCB->uxPriority != pxTCB->uxBasePriority )
+			{
+				/* Only disinherit if no other mutexes are held. */
+				if( pxTCB->uxMutexesHeld == ( UBaseType_t ) 0 )
+				{
+					/* A task can only have an inherited priority if it holds
+					the mutex.  If the mutex is held by a task then it cannot be
+					given from an interrupt, and if a mutex is given by the
+					holding	task then it must be the running state task.  Remove
+					the	holding task from the ready	list. */
+					if( uxListRemove( &( pxTCB->xStateListItem ) ) == ( UBaseType_t ) 0 )
+					{
+						taskRESET_READY_PRIORITY( pxTCB->uxPriority );
+					}
+					else
+					{
+						mtCOVERAGE_TEST_MARKER();
+					}
+
+					/* Disinherit the priority before adding the task into the
+					new	ready list. */
+					traceTASK_PRIORITY_DISINHERIT( pxTCB, pxTCB->uxBasePriority );
+					pxTCB->uxPriority = pxTCB->uxBasePriority;
+
+					/* Reset the event list item value.  It cannot be in use for
+					any other purpose if this task is running, and it must be
+					running to give back the mutex. */
+					listSET_LIST_ITEM_VALUE( &( pxTCB->xEventListItem ), ( TickType_t ) configMAX_PRIORITIES - ( TickType_t ) pxTCB->uxPriority ); /*lint !e961 MISRA exception as the casts are only redundant for some ports. */
+					prvAddTaskToReadyList( pxTCB );
+
+					/* Return true to indicate that a context switch is required.
+					This is only actually required in the corner case whereby
+					multiple mutexes were held and the mutexes were given back
+					in an order different to that in which they were taken.
+					If a context switch did not occur when the first mutex was
+					returned, even if a task was waiting on it, then a context
+					switch should occur when the last mutex is returned whether
+					a task is waiting on it or not. */
+					xReturn = pdTRUE;
+				}
+				else
+				{
+					mtCOVERAGE_TEST_MARKER();
+				}
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+		}
+		else
+		{
+			mtCOVERAGE_TEST_MARKER();
+		}
+
+		return xReturn;
+	}
+
+#endif /* configUSE_MUTEXES */
+/*-----------------------------------------------------------*/
+
+#if ( portCRITICAL_NESTING_IN_TCB == 1 )
+
+	void vTaskEnterCritical( void )
+	{
+		portDISABLE_INTERRUPTS();
+
+		if( xSchedulerRunning != pdFALSE )
+		{
+			( pxCurrentTCB->uxCriticalNesting )++;
+
+			/* This is not the interrupt safe version of the enter critical
+			function so	assert() if it is being called from an interrupt
+			context.  Only API functions that end in "FromISR" can be used in an
+			interrupt.  Only assert if the critical nesting count is 1 to
+			protect against recursive calls if the assert function also uses a
+			critical section. */
+			if( pxCurrentTCB->uxCriticalNesting == 1 )
+			{
+				portASSERT_IF_IN_ISR();
+			}
+		}
+		else
+		{
+			mtCOVERAGE_TEST_MARKER();
+		}
+	}
+
+#endif /* portCRITICAL_NESTING_IN_TCB */
+/*-----------------------------------------------------------*/
+
+#if ( portCRITICAL_NESTING_IN_TCB == 1 )
+
+	void vTaskExitCritical( void )
+	{
+		if( xSchedulerRunning != pdFALSE )
+		{
+			if( pxCurrentTCB->uxCriticalNesting > 0U )
+			{
+				( pxCurrentTCB->uxCriticalNesting )--;
+
+				if( pxCurrentTCB->uxCriticalNesting == 0U )
+				{
+					portENABLE_INTERRUPTS();
+				}
+				else
+				{
+					mtCOVERAGE_TEST_MARKER();
+				}
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+		}
+		else
+		{
+			mtCOVERAGE_TEST_MARKER();
+		}
+	}
+
+#endif /* portCRITICAL_NESTING_IN_TCB */
+/*-----------------------------------------------------------*/
+
+#if ( ( configUSE_TRACE_FACILITY == 1 ) && ( configUSE_STATS_FORMATTING_FUNCTIONS > 0 ) )
+
+	static char *prvWriteNameToBuffer( char *pcBuffer, const char *pcTaskName )
+	{
+	size_t x;
+
+		/* Start by copying the entire string. */
+		strcpy( pcBuffer, pcTaskName );
+
+		/* Pad the end of the string with spaces to ensure columns line up when
+		printed out. */
+		for( x = strlen( pcBuffer ); x < ( size_t ) ( configMAX_TASK_NAME_LEN - 1 ); x++ )
+		{
+			pcBuffer[ x ] = ' ';
+		}
+
+		/* Terminate. */
+		pcBuffer[ x ] = 0x00;
+
+		/* Return the new end of string. */
+		return &( pcBuffer[ x ] );
+	}
+
+#endif /* ( configUSE_TRACE_FACILITY == 1 ) && ( configUSE_STATS_FORMATTING_FUNCTIONS > 0 ) */
+/*-----------------------------------------------------------*/
+
+#if ( ( configUSE_TRACE_FACILITY == 1 ) && ( configUSE_STATS_FORMATTING_FUNCTIONS > 0 ) )
+
+	void vTaskList( char * pcWriteBuffer )
+	{
+	TaskStatus_t *pxTaskStatusArray;
+	volatile UBaseType_t uxArraySize, x;
+	char cStatus;
+
+		/*
+		 * PLEASE NOTE:
+		 *
+		 * This function is provided for convenience only, and is used by many
+		 * of the demo applications.  Do not consider it to be part of the
+		 * scheduler.
+		 *
+		 * vTaskList() calls uxTaskGetSystemState(), then formats part of the
+		 * uxTaskGetSystemState() output into a human readable table that
+		 * displays task names, states and stack usage.
+		 *
+		 * vTaskList() has a dependency on the sprintf() C library function that
+		 * might bloat the code size, use a lot of stack, and provide different
+		 * results on different platforms.  An alternative, tiny, third party,
+		 * and limited functionality implementation of sprintf() is provided in
+		 * many of the FreeRTOS/Demo sub-directories in a file called
+		 * printf-stdarg.c (note printf-stdarg.c does not provide a full
+		 * snprintf() implementation!).
+		 *
+		 * It is recommended that production systems call uxTaskGetSystemState()
+		 * directly to get access to raw stats data, rather than indirectly
+		 * through a call to vTaskList().
+		 */
+
+
+		/* Make sure the write buffer does not contain a string. */
+		*pcWriteBuffer = 0x00;
+
+		/* Take a snapshot of the number of tasks in case it changes while this
+		function is executing. */
+		uxArraySize = uxCurrentNumberOfTasks;
+
+		/* Allocate an array index for each task.  NOTE!  if
+		configSUPPORT_DYNAMIC_ALLOCATION is set to 0 then pvPortMalloc() will
+		equate to NULL. */
+		pxTaskStatusArray = pvPortMalloc( uxCurrentNumberOfTasks * sizeof( TaskStatus_t ) );
+
+		if( pxTaskStatusArray != NULL )
+		{
+			/* Generate the (binary) data. */
+			uxArraySize = uxTaskGetSystemState( pxTaskStatusArray, uxArraySize, NULL );
+
+			/* Create a human readable table from the binary data. */
+			for( x = 0; x < uxArraySize; x++ )
+			{
+				switch( pxTaskStatusArray[ x ].eCurrentState )
+				{
+					case eReady:		cStatus = tskREADY_CHAR;
+										break;
+
+					case eBlocked:		cStatus = tskBLOCKED_CHAR;
+										break;
+
+					case eSuspended:	cStatus = tskSUSPENDED_CHAR;
+										break;
+
+					case eDeleted:		cStatus = tskDELETED_CHAR;
+										break;
+
+					default:			/* Should not get here, but it is included
+										to prevent static checking errors. */
+										cStatus = 0x00;
+										break;
+				}
+
+				/* Write the task name to the string, padding with spaces so it
+				can be printed in tabular form more easily. */
+				pcWriteBuffer = prvWriteNameToBuffer( pcWriteBuffer, pxTaskStatusArray[ x ].pcTaskName );
+
+				/* Write the rest of the string. */
+				sprintf( pcWriteBuffer, "\t%c\t%u\t%u\t%u\r\n", cStatus, ( unsigned int ) pxTaskStatusArray[ x ].uxCurrentPriority, ( unsigned int ) pxTaskStatusArray[ x ].usStackHighWaterMark, ( unsigned int ) pxTaskStatusArray[ x ].xTaskNumber );
+				pcWriteBuffer += strlen( pcWriteBuffer );
+			}
+
+			/* Free the array again.  NOTE!  If configSUPPORT_DYNAMIC_ALLOCATION
+			is 0 then vPortFree() will be #defined to nothing. */
+			vPortFree( pxTaskStatusArray );
+		}
+		else
+		{
+			mtCOVERAGE_TEST_MARKER();
+		}
+	}
+
+#endif /* ( ( configUSE_TRACE_FACILITY == 1 ) && ( configUSE_STATS_FORMATTING_FUNCTIONS > 0 ) ) */
+/*----------------------------------------------------------*/
+
+#if ( ( configGENERATE_RUN_TIME_STATS == 1 ) && ( configUSE_STATS_FORMATTING_FUNCTIONS > 0 ) )
+
+	void vTaskGetRunTimeStats( char *pcWriteBuffer )
+	{
+	TaskStatus_t *pxTaskStatusArray;
+	volatile UBaseType_t uxArraySize, x;
+	uint32_t ulTotalTime, ulStatsAsPercentage;
+
+		#if( configUSE_TRACE_FACILITY != 1 )
+		{
+			#error configUSE_TRACE_FACILITY must also be set to 1 in FreeRTOSConfig.h to use vTaskGetRunTimeStats().
+		}
+		#endif
+
+		/*
+		 * PLEASE NOTE:
+		 *
+		 * This function is provided for convenience only, and is used by many
+		 * of the demo applications.  Do not consider it to be part of the
+		 * scheduler.
+		 *
+		 * vTaskGetRunTimeStats() calls uxTaskGetSystemState(), then formats part
+		 * of the uxTaskGetSystemState() output into a human readable table that
+		 * displays the amount of time each task has spent in the Running state
+		 * in both absolute and percentage terms.
+		 *
+		 * vTaskGetRunTimeStats() has a dependency on the sprintf() C library
+		 * function that might bloat the code size, use a lot of stack, and
+		 * provide different results on different platforms.  An alternative,
+		 * tiny, third party, and limited functionality implementation of
+		 * sprintf() is provided in many of the FreeRTOS/Demo sub-directories in
+		 * a file called printf-stdarg.c (note printf-stdarg.c does not provide
+		 * a full snprintf() implementation!).
+		 *
+		 * It is recommended that production systems call uxTaskGetSystemState()
+		 * directly to get access to raw stats data, rather than indirectly
+		 * through a call to vTaskGetRunTimeStats().
+		 */
+
+		/* Make sure the write buffer does not contain a string. */
+		*pcWriteBuffer = 0x00;
+
+		/* Take a snapshot of the number of tasks in case it changes while this
+		function is executing. */
+		uxArraySize = uxCurrentNumberOfTasks;
+
+		/* Allocate an array index for each task.  NOTE!  If
+		configSUPPORT_DYNAMIC_ALLOCATION is set to 0 then pvPortMalloc() will
+		equate to NULL. */
+		pxTaskStatusArray = pvPortMalloc( uxCurrentNumberOfTasks * sizeof( TaskStatus_t ) );
+
+		if( pxTaskStatusArray != NULL )
+		{
+			/* Generate the (binary) data. */
+			uxArraySize = uxTaskGetSystemState( pxTaskStatusArray, uxArraySize, &ulTotalTime );
+
+			/* For percentage calculations. */
+			ulTotalTime /= 100UL;
+
+			/* Avoid divide by zero errors. */
+			if( ulTotalTime > 0 )
+			{
+				/* Create a human readable table from the binary data. */
+				for( x = 0; x < uxArraySize; x++ )
+				{
+					/* What percentage of the total run time has the task used?
+					This will always be rounded down to the nearest integer.
+					ulTotalRunTimeDiv100 has already been divided by 100. */
+					ulStatsAsPercentage = pxTaskStatusArray[ x ].ulRunTimeCounter / ulTotalTime;
+
+					/* Write the task name to the string, padding with
+					spaces so it can be printed in tabular form more
+					easily. */
+					pcWriteBuffer = prvWriteNameToBuffer( pcWriteBuffer, pxTaskStatusArray[ x ].pcTaskName );
+
+					if( ulStatsAsPercentage > 0UL )
+					{
+						#ifdef portLU_PRINTF_SPECIFIER_REQUIRED
+						{
+							sprintf( pcWriteBuffer, "\t%lu\t\t%lu%%\r\n", pxTaskStatusArray[ x ].ulRunTimeCounter, ulStatsAsPercentage );
+						}
+						#else
+						{
+							/* sizeof( int ) == sizeof( long ) so a smaller
+							printf() library can be used. */
+							sprintf( pcWriteBuffer, "\t%u\t\t%u%%\r\n", ( unsigned int ) pxTaskStatusArray[ x ].ulRunTimeCounter, ( unsigned int ) ulStatsAsPercentage );
+						}
+						#endif
+					}
+					else
+					{
+						/* If the percentage is zero here then the task has
+						consumed less than 1% of the total run time. */
+						#ifdef portLU_PRINTF_SPECIFIER_REQUIRED
+						{
+							sprintf( pcWriteBuffer, "\t%lu\t\t<1%%\r\n", pxTaskStatusArray[ x ].ulRunTimeCounter );
+						}
+						#else
+						{
+							/* sizeof( int ) == sizeof( long ) so a smaller
+							printf() library can be used. */
+							sprintf( pcWriteBuffer, "\t%u\t\t<1%%\r\n", ( unsigned int ) pxTaskStatusArray[ x ].ulRunTimeCounter );
+						}
+						#endif
+					}
+
+					pcWriteBuffer += strlen( pcWriteBuffer );
+				}
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+
+			/* Free the array again.  NOTE!  If configSUPPORT_DYNAMIC_ALLOCATION
+			is 0 then vPortFree() will be #defined to nothing. */
+			vPortFree( pxTaskStatusArray );
+		}
+		else
+		{
+			mtCOVERAGE_TEST_MARKER();
+		}
+	}
+
+#endif /* ( ( configGENERATE_RUN_TIME_STATS == 1 ) && ( configUSE_STATS_FORMATTING_FUNCTIONS > 0 ) ) */
+/*-----------------------------------------------------------*/
+
+TickType_t uxTaskResetEventItemValue( void )
+{
+TickType_t uxReturn;
+
+	uxReturn = listGET_LIST_ITEM_VALUE( &( pxCurrentTCB->xEventListItem ) );
+
+	/* Reset the event list item to its normal value - so it can be used with
+	queues and semaphores. */
+	listSET_LIST_ITEM_VALUE( &( pxCurrentTCB->xEventListItem ), ( ( TickType_t ) configMAX_PRIORITIES - ( TickType_t ) pxCurrentTCB->uxPriority ) ); /*lint !e961 MISRA exception as the casts are only redundant for some ports. */
+
+	return uxReturn;
+}
+/*-----------------------------------------------------------*/
+
+#if ( configUSE_MUTEXES == 1 )
+
+	void *pvTaskIncrementMutexHeldCount( void )
+	{
+		/* If xSemaphoreCreateMutex() is called before any tasks have been created
+		then pxCurrentTCB will be NULL. */
+		if( pxCurrentTCB != NULL )
+		{
+			( pxCurrentTCB->uxMutexesHeld )++;
+		}
+
+		return pxCurrentTCB;
+	}
+
+#endif /* configUSE_MUTEXES */
+/*-----------------------------------------------------------*/
+
+#if( configUSE_TASK_NOTIFICATIONS == 1 )
+
+	uint32_t ulTaskNotifyTake( BaseType_t xClearCountOnExit, TickType_t xTicksToWait )
+	{
+	uint32_t ulReturn;
+
+		taskENTER_CRITICAL();
+		{
+			/* Only block if the notification count is not already non-zero. */
+			if( pxCurrentTCB->ulNotifiedValue == 0UL )
+			{
+				/* Mark this task as waiting for a notification. */
+				pxCurrentTCB->ucNotifyState = taskWAITING_NOTIFICATION;
+
+				if( xTicksToWait > ( TickType_t ) 0 )
+				{
+					prvAddCurrentTaskToDelayedList( xTicksToWait, pdTRUE );
+					traceTASK_NOTIFY_TAKE_BLOCK();
+
+					/* All ports are written to allow a yield in a critical
+					section (some will yield immediately, others wait until the
+					critical section exits) - but it is not something that
+					application code should ever do. */
+					portYIELD_WITHIN_API();
+				}
+				else
+				{
+					mtCOVERAGE_TEST_MARKER();
+				}
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+		}
+		taskEXIT_CRITICAL();
+
+		taskENTER_CRITICAL();
+		{
+			traceTASK_NOTIFY_TAKE();
+			ulReturn = pxCurrentTCB->ulNotifiedValue;
+
+			if( ulReturn != 0UL )
+			{
+				if( xClearCountOnExit != pdFALSE )
+				{
+					pxCurrentTCB->ulNotifiedValue = 0UL;
+				}
+				else
+				{
+					pxCurrentTCB->ulNotifiedValue = ulReturn - 1;
+				}
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+
+			pxCurrentTCB->ucNotifyState = taskNOT_WAITING_NOTIFICATION;
+		}
+		taskEXIT_CRITICAL();
+
+		return ulReturn;
+	}
+
+#endif /* configUSE_TASK_NOTIFICATIONS */
+/*-----------------------------------------------------------*/
+
+#if( configUSE_TASK_NOTIFICATIONS == 1 )
+
+	BaseType_t xTaskNotifyWait( uint32_t ulBitsToClearOnEntry, uint32_t ulBitsToClearOnExit, uint32_t *pulNotificationValue, TickType_t xTicksToWait )
+	{
+	BaseType_t xReturn;
+
+		taskENTER_CRITICAL();
+		{
+			/* Only block if a notification is not already pending. */
+			if( pxCurrentTCB->ucNotifyState != taskNOTIFICATION_RECEIVED )
+			{
+				/* Clear bits in the task's notification value as bits may get
+				set	by the notifying task or interrupt.  This can be used to
+				clear the value to zero. */
+				pxCurrentTCB->ulNotifiedValue &= ~ulBitsToClearOnEntry;
+
+				/* Mark this task as waiting for a notification. */
+				pxCurrentTCB->ucNotifyState = taskWAITING_NOTIFICATION;
+
+				if( xTicksToWait > ( TickType_t ) 0 )
+				{
+					prvAddCurrentTaskToDelayedList( xTicksToWait, pdTRUE );
+					traceTASK_NOTIFY_WAIT_BLOCK();
+
+					/* All ports are written to allow a yield in a critical
+					section (some will yield immediately, others wait until the
+					critical section exits) - but it is not something that
+					application code should ever do. */
+					portYIELD_WITHIN_API();
+				}
+				else
+				{
+					mtCOVERAGE_TEST_MARKER();
+				}
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+		}
+		taskEXIT_CRITICAL();
+
+		taskENTER_CRITICAL();
+		{
+			traceTASK_NOTIFY_WAIT();
+
+			if( pulNotificationValue != NULL )
+			{
+				/* Output the current notification value, which may or may not
+				have changed. */
+				*pulNotificationValue = pxCurrentTCB->ulNotifiedValue;
+			}
+
+			/* If ucNotifyValue is set then either the task never entered the
+			blocked state (because a notification was already pending) or the
+			task unblocked because of a notification.  Otherwise the task
+			unblocked because of a timeout. */
+			if( pxCurrentTCB->ucNotifyState == taskWAITING_NOTIFICATION )
+			{
+				/* A notification was not received. */
+				xReturn = pdFALSE;
+			}
+			else
+			{
+				/* A notification was already pending or a notification was
+				received while the task was waiting. */
+				pxCurrentTCB->ulNotifiedValue &= ~ulBitsToClearOnExit;
+				xReturn = pdTRUE;
+			}
+
+			pxCurrentTCB->ucNotifyState = taskNOT_WAITING_NOTIFICATION;
+		}
+		taskEXIT_CRITICAL();
+
+		return xReturn;
+	}
+
+#endif /* configUSE_TASK_NOTIFICATIONS */
+/*-----------------------------------------------------------*/
+
+#if( configUSE_TASK_NOTIFICATIONS == 1 )
+
+	BaseType_t xTaskGenericNotify( TaskHandle_t xTaskToNotify, uint32_t ulValue, eNotifyAction eAction, uint32_t *pulPreviousNotificationValue )
+	{
+	TCB_t * pxTCB;
+	BaseType_t xReturn = pdPASS;
+	uint8_t ucOriginalNotifyState;
+
+		configASSERT( xTaskToNotify );
+		pxTCB = ( TCB_t * ) xTaskToNotify;
+
+		taskENTER_CRITICAL();
+		{
+			if( pulPreviousNotificationValue != NULL )
+			{
+				*pulPreviousNotificationValue = pxTCB->ulNotifiedValue;
+			}
+
+			ucOriginalNotifyState = pxTCB->ucNotifyState;
+
+			pxTCB->ucNotifyState = taskNOTIFICATION_RECEIVED;
+
+			switch( eAction )
+			{
+				case eSetBits	:
+					pxTCB->ulNotifiedValue |= ulValue;
+					break;
+
+				case eIncrement	:
+					( pxTCB->ulNotifiedValue )++;
+					break;
+
+				case eSetValueWithOverwrite	:
+					pxTCB->ulNotifiedValue = ulValue;
+					break;
+
+				case eSetValueWithoutOverwrite :
+					if( ucOriginalNotifyState != taskNOTIFICATION_RECEIVED )
+					{
+						pxTCB->ulNotifiedValue = ulValue;
+					}
+					else
+					{
+						/* The value could not be written to the task. */
+						xReturn = pdFAIL;
+					}
+					break;
+
+				case eNoAction:
+					/* The task is being notified without its notify value being
+					updated. */
+					break;
+			}
+
+			traceTASK_NOTIFY();
+
+			/* If the task is in the blocked state specifically to wait for a
+			notification then unblock it now. */
+			if( ucOriginalNotifyState == taskWAITING_NOTIFICATION )
+			{
+				( void ) uxListRemove( &( pxTCB->xStateListItem ) );
+				prvAddTaskToReadyList( pxTCB );
+
+				/* The task should not have been on an event list. */
+				configASSERT( listLIST_ITEM_CONTAINER( &( pxTCB->xEventListItem ) ) == NULL );
+
+				#if( configUSE_TICKLESS_IDLE != 0 )
+				{
+					/* If a task is blocked waiting for a notification then
+					xNextTaskUnblockTime might be set to the blocked task's time
+					out time.  If the task is unblocked for a reason other than
+					a timeout xNextTaskUnblockTime is normally left unchanged,
+					because it will automatically get reset to a new value when
+					the tick count equals xNextTaskUnblockTime.  However if
+					tickless idling is used it might be more important to enter
+					sleep mode at the earliest possible time - so reset
+					xNextTaskUnblockTime here to ensure it is updated at the
+					earliest possible time. */
+					prvResetNextTaskUnblockTime();
+				}
+				#endif
+
+				if( pxTCB->uxPriority > pxCurrentTCB->uxPriority )
+				{
+					/* The notified task has a priority above the currently
+					executing task so a yield is required. */
+					taskYIELD_IF_USING_PREEMPTION();
+				}
+				else
+				{
+					mtCOVERAGE_TEST_MARKER();
+				}
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+		}
+		taskEXIT_CRITICAL();
+
+		return xReturn;
+	}
+
+#endif /* configUSE_TASK_NOTIFICATIONS */
+/*-----------------------------------------------------------*/
+
+#if( configUSE_TASK_NOTIFICATIONS == 1 )
+
+	BaseType_t xTaskGenericNotifyFromISR( TaskHandle_t xTaskToNotify, uint32_t ulValue, eNotifyAction eAction, uint32_t *pulPreviousNotificationValue, BaseType_t *pxHigherPriorityTaskWoken )
+	{
+	TCB_t * pxTCB;
+	uint8_t ucOriginalNotifyState;
+	BaseType_t xReturn = pdPASS;
+	UBaseType_t uxSavedInterruptStatus;
+
+		configASSERT( xTaskToNotify );
+
+		/* RTOS ports that support interrupt nesting have the concept of a
+		maximum	system call (or maximum API call) interrupt priority.
+		Interrupts that are	above the maximum system call priority are keep
+		permanently enabled, even when the RTOS kernel is in a critical section,
+		but cannot make any calls to FreeRTOS API functions.  If configASSERT()
+		is defined in FreeRTOSConfig.h then
+		portASSERT_IF_INTERRUPT_PRIORITY_INVALID() will result in an assertion
+		failure if a FreeRTOS API function is called from an interrupt that has
+		been assigned a priority above the configured maximum system call
+		priority.  Only FreeRTOS functions that end in FromISR can be called
+		from interrupts	that have been assigned a priority at or (logically)
+		below the maximum system call interrupt priority.  FreeRTOS maintains a
+		separate interrupt safe API to ensure interrupt entry is as fast and as
+		simple as possible.  More information (albeit Cortex-M specific) is
+		provided on the following link:
+		http://www.freertos.org/RTOS-Cortex-M3-M4.html */
+		portASSERT_IF_INTERRUPT_PRIORITY_INVALID();
+
+		pxTCB = ( TCB_t * ) xTaskToNotify;
+
+		uxSavedInterruptStatus = portSET_INTERRUPT_MASK_FROM_ISR();
+		{
+			if( pulPreviousNotificationValue != NULL )
+			{
+				*pulPreviousNotificationValue = pxTCB->ulNotifiedValue;
+			}
+
+			ucOriginalNotifyState = pxTCB->ucNotifyState;
+			pxTCB->ucNotifyState = taskNOTIFICATION_RECEIVED;
+
+			switch( eAction )
+			{
+				case eSetBits	:
+					pxTCB->ulNotifiedValue |= ulValue;
+					break;
+
+				case eIncrement	:
+					( pxTCB->ulNotifiedValue )++;
+					break;
+
+				case eSetValueWithOverwrite	:
+					pxTCB->ulNotifiedValue = ulValue;
+					break;
+
+				case eSetValueWithoutOverwrite :
+					if( ucOriginalNotifyState != taskNOTIFICATION_RECEIVED )
+					{
+						pxTCB->ulNotifiedValue = ulValue;
+					}
+					else
+					{
+						/* The value could not be written to the task. */
+						xReturn = pdFAIL;
+					}
+					break;
+
+				case eNoAction :
+					/* The task is being notified without its notify value being
+					updated. */
+					break;
+			}
+
+			traceTASK_NOTIFY_FROM_ISR();
+
+			/* If the task is in the blocked state specifically to wait for a
+			notification then unblock it now. */
+			if( ucOriginalNotifyState == taskWAITING_NOTIFICATION )
+			{
+				/* The task should not have been on an event list. */
+				configASSERT( listLIST_ITEM_CONTAINER( &( pxTCB->xEventListItem ) ) == NULL );
+
+				if( uxSchedulerSuspended == ( UBaseType_t ) pdFALSE )
+				{
+					( void ) uxListRemove( &( pxTCB->xStateListItem ) );
+					prvAddTaskToReadyList( pxTCB );
+				}
+				else
+				{
+					/* The delayed and ready lists cannot be accessed, so hold
+					this task pending until the scheduler is resumed. */
+					vListInsertEnd( &( xPendingReadyList ), &( pxTCB->xEventListItem ) );
+				}
+
+				if( pxTCB->uxPriority > pxCurrentTCB->uxPriority )
+				{
+					/* The notified task has a priority above the currently
+					executing task so a yield is required. */
+					if( pxHigherPriorityTaskWoken != NULL )
+					{
+						*pxHigherPriorityTaskWoken = pdTRUE;
+					}
+					else
+					{
+						/* Mark that a yield is pending in case the user is not
+						using the "xHigherPriorityTaskWoken" parameter to an ISR
+						safe FreeRTOS function. */
+						xYieldPending = pdTRUE;
+					}
+				}
+				else
+				{
+					mtCOVERAGE_TEST_MARKER();
+				}
+			}
+		}
+		portCLEAR_INTERRUPT_MASK_FROM_ISR( uxSavedInterruptStatus );
+
+		return xReturn;
+	}
+
+#endif /* configUSE_TASK_NOTIFICATIONS */
+/*-----------------------------------------------------------*/
+
+#if( configUSE_TASK_NOTIFICATIONS == 1 )
+
+	void vTaskNotifyGiveFromISR( TaskHandle_t xTaskToNotify, BaseType_t *pxHigherPriorityTaskWoken )
+	{
+	TCB_t * pxTCB;
+	uint8_t ucOriginalNotifyState;
+	UBaseType_t uxSavedInterruptStatus;
+
+		configASSERT( xTaskToNotify );
+
+		/* RTOS ports that support interrupt nesting have the concept of a
+		maximum	system call (or maximum API call) interrupt priority.
+		Interrupts that are	above the maximum system call priority are keep
+		permanently enabled, even when the RTOS kernel is in a critical section,
+		but cannot make any calls to FreeRTOS API functions.  If configASSERT()
+		is defined in FreeRTOSConfig.h then
+		portASSERT_IF_INTERRUPT_PRIORITY_INVALID() will result in an assertion
+		failure if a FreeRTOS API function is called from an interrupt that has
+		been assigned a priority above the configured maximum system call
+		priority.  Only FreeRTOS functions that end in FromISR can be called
+		from interrupts	that have been assigned a priority at or (logically)
+		below the maximum system call interrupt priority.  FreeRTOS maintains a
+		separate interrupt safe API to ensure interrupt entry is as fast and as
+		simple as possible.  More information (albeit Cortex-M specific) is
+		provided on the following link:
+		http://www.freertos.org/RTOS-Cortex-M3-M4.html */
+		portASSERT_IF_INTERRUPT_PRIORITY_INVALID();
+
+		pxTCB = ( TCB_t * ) xTaskToNotify;
+
+		uxSavedInterruptStatus = portSET_INTERRUPT_MASK_FROM_ISR();
+		{
+			ucOriginalNotifyState = pxTCB->ucNotifyState;
+			pxTCB->ucNotifyState = taskNOTIFICATION_RECEIVED;
+
+			/* 'Giving' is equivalent to incrementing a count in a counting
+			semaphore. */
+			( pxTCB->ulNotifiedValue )++;
+
+			traceTASK_NOTIFY_GIVE_FROM_ISR();
+
+			/* If the task is in the blocked state specifically to wait for a
+			notification then unblock it now. */
+			if( ucOriginalNotifyState == taskWAITING_NOTIFICATION )
+			{
+				/* The task should not have been on an event list. */
+				configASSERT( listLIST_ITEM_CONTAINER( &( pxTCB->xEventListItem ) ) == NULL );
+
+				if( uxSchedulerSuspended == ( UBaseType_t ) pdFALSE )
+				{
+					( void ) uxListRemove( &( pxTCB->xStateListItem ) );
+					prvAddTaskToReadyList( pxTCB );
+				}
+				else
+				{
+					/* The delayed and ready lists cannot be accessed, so hold
+					this task pending until the scheduler is resumed. */
+					vListInsertEnd( &( xPendingReadyList ), &( pxTCB->xEventListItem ) );
+				}
+
+				if( pxTCB->uxPriority > pxCurrentTCB->uxPriority )
+				{
+					/* The notified task has a priority above the currently
+					executing task so a yield is required. */
+					if( pxHigherPriorityTaskWoken != NULL )
+					{
+						*pxHigherPriorityTaskWoken = pdTRUE;
+					}
+					else
+					{
+						/* Mark that a yield is pending in case the user is not
+						using the "xHigherPriorityTaskWoken" parameter in an ISR
+						safe FreeRTOS function. */
+						xYieldPending = pdTRUE;
+					}
+				}
+				else
+				{
+					mtCOVERAGE_TEST_MARKER();
+				}
+			}
+		}
+		portCLEAR_INTERRUPT_MASK_FROM_ISR( uxSavedInterruptStatus );
+	}
+
+#endif /* configUSE_TASK_NOTIFICATIONS */
+
+/*-----------------------------------------------------------*/
+
+#if( configUSE_TASK_NOTIFICATIONS == 1 )
+
+	BaseType_t xTaskNotifyStateClear( TaskHandle_t xTask )
+	{
+	TCB_t *pxTCB;
+	BaseType_t xReturn;
+
+		/* If null is passed in here then it is the calling task that is having
+		its notification state cleared. */
+		pxTCB = prvGetTCBFromHandle( xTask );
+
+		taskENTER_CRITICAL();
+		{
+			if( pxTCB->ucNotifyState == taskNOTIFICATION_RECEIVED )
+			{
+				pxTCB->ucNotifyState = taskNOT_WAITING_NOTIFICATION;
+				xReturn = pdPASS;
+			}
+			else
+			{
+				xReturn = pdFAIL;
+			}
+		}
+		taskEXIT_CRITICAL();
+
+		return xReturn;
+	}
+
+#endif /* configUSE_TASK_NOTIFICATIONS */
+/*-----------------------------------------------------------*/
+
+
+static void prvAddCurrentTaskToDelayedList( TickType_t xTicksToWait, const BaseType_t xCanBlockIndefinitely )
+{
+TickType_t xTimeToWake;
+const TickType_t xConstTickCount = xTickCount;
+
+	#if( INCLUDE_xTaskAbortDelay == 1 )
+	{
+		/* About to enter a delayed list, so ensure the ucDelayAborted flag is
+		reset to pdFALSE so it can be detected as having been set to pdTRUE
+		when the task leaves the Blocked state. */
+		pxCurrentTCB->ucDelayAborted = pdFALSE;
+	}
+	#endif
+
+	/* Remove the task from the ready list before adding it to the blocked list
+	as the same list item is used for both lists. */
+	if( uxListRemove( &( pxCurrentTCB->xStateListItem ) ) == ( UBaseType_t ) 0 )
+	{
+		/* The current task must be in a ready list, so there is no need to
+		check, and the port reset macro can be called directly. */
+		portRESET_READY_PRIORITY( pxCurrentTCB->uxPriority, uxTopReadyPriority );
+	}
+	else
+	{
+		mtCOVERAGE_TEST_MARKER();
+	}
+
+	#if ( INCLUDE_vTaskSuspend == 1 )
+	{
+		if( ( xTicksToWait == portMAX_DELAY ) && ( xCanBlockIndefinitely != pdFALSE ) )
+		{
+			/* Add the task to the suspended task list instead of a delayed task
+			list to ensure it is not woken by a timing event.  It will block
+			indefinitely. */
+			vListInsertEnd( &xSuspendedTaskList, &( pxCurrentTCB->xStateListItem ) );
+		}
+		else
+		{
+			/* Calculate the time at which the task should be woken if the event
+			does not occur.  This may overflow but this doesn't matter, the
+			kernel will manage it correctly. */
+			xTimeToWake = xConstTickCount + xTicksToWait;
+
+			/* The list item will be inserted in wake time order. */
+			listSET_LIST_ITEM_VALUE( &( pxCurrentTCB->xStateListItem ), xTimeToWake );
+
+			if( xTimeToWake < xConstTickCount )
+			{
+				/* Wake time has overflowed.  Place this item in the overflow
+				list. */
+				vListInsert( pxOverflowDelayedTaskList, &( pxCurrentTCB->xStateListItem ) );
+			}
+			else
+			{
+				/* The wake time has not overflowed, so the current block list
+				is used. */
+				vListInsert( pxDelayedTaskList, &( pxCurrentTCB->xStateListItem ) );
+
+				/* If the task entering the blocked state was placed at the
+				head of the list of blocked tasks then xNextTaskUnblockTime
+				needs to be updated too. */
+				if( xTimeToWake < xNextTaskUnblockTime )
+				{
+					xNextTaskUnblockTime = xTimeToWake;
+				}
+				else
+				{
+					mtCOVERAGE_TEST_MARKER();
+				}
+			}
+		}
+	}
+	#else /* INCLUDE_vTaskSuspend */
+	{
+		/* Calculate the time at which the task should be woken if the event
+		does not occur.  This may overflow but this doesn't matter, the kernel
+		will manage it correctly. */
+		xTimeToWake = xConstTickCount + xTicksToWait;
+
+		/* The list item will be inserted in wake time order. */
+		listSET_LIST_ITEM_VALUE( &( pxCurrentTCB->xStateListItem ), xTimeToWake );
+
+		if( xTimeToWake < xConstTickCount )
+		{
+			/* Wake time has overflowed.  Place this item in the overflow list. */
+			vListInsert( pxOverflowDelayedTaskList, &( pxCurrentTCB->xStateListItem ) );
+		}
+		else
+		{
+			/* The wake time has not overflowed, so the current block list is used. */
+			vListInsert( pxDelayedTaskList, &( pxCurrentTCB->xStateListItem ) );
+
+			/* If the task entering the blocked state was placed at the head of the
+			list of blocked tasks then xNextTaskUnblockTime needs to be updated
+			too. */
+			if( xTimeToWake < xNextTaskUnblockTime )
+			{
+				xNextTaskUnblockTime = xTimeToWake;
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+		}
+
+		/* Avoid compiler warning when INCLUDE_vTaskSuspend is not 1. */
+		( void ) xCanBlockIndefinitely;
+	}
+	#endif /* INCLUDE_vTaskSuspend */
+}
+
+
+#ifdef FREERTOS_MODULE_TEST
+	#include "tasks_test_access_functions.h"
+#endif
+
diff --git a/FreeRTOS/timers.c b/FreeRTOS/timers.c
new file mode 100644
index 0000000..d4a821a
--- /dev/null
+++ b/FreeRTOS/timers.c
@@ -0,0 +1,1092 @@
+/*
+    FreeRTOS V9.0.0 - Copyright (C) 2016 Real Time Engineers Ltd.
+    All rights reserved
+
+    VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION.
+
+    This file is part of the FreeRTOS distribution.
+
+    FreeRTOS is free software; you can redistribute it and/or modify it under
+    the terms of the GNU General Public License (version 2) as published by the
+    Free Software Foundation >>>> AND MODIFIED BY <<<< the FreeRTOS exception.
+
+    ***************************************************************************
+    >>!   NOTE: The modification to the GPL is included to allow you to     !<<
+    >>!   distribute a combined work that includes FreeRTOS without being   !<<
+    >>!   obliged to provide the source code for proprietary components     !<<
+    >>!   outside of the FreeRTOS kernel.                                   !<<
+    ***************************************************************************
+
+    FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY
+    WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+    FOR A PARTICULAR PURPOSE.  Full license text is available on the following
+    link: http://www.freertos.org/a00114.html
+
+    ***************************************************************************
+     *                                                                       *
+     *    FreeRTOS provides completely free yet professionally developed,    *
+     *    robust, strictly quality controlled, supported, and cross          *
+     *    platform software that is more than just the market leader, it     *
+     *    is the industry's de facto standard.                               *
+     *                                                                       *
+     *    Help yourself get started quickly while simultaneously helping     *
+     *    to support the FreeRTOS project by purchasing a FreeRTOS           *
+     *    tutorial book, reference manual, or both:                          *
+     *    http://www.FreeRTOS.org/Documentation                              *
+     *                                                                       *
+    ***************************************************************************
+
+    http://www.FreeRTOS.org/FAQHelp.html - Having a problem?  Start by reading
+    the FAQ page "My application does not run, what could be wrong?".  Have you
+    defined configASSERT()?
+
+    http://www.FreeRTOS.org/support - In return for receiving this top quality
+    embedded software for free we request you assist our global community by
+    participating in the support forum.
+
+    http://www.FreeRTOS.org/training - Investing in training allows your team to
+    be as productive as possible as early as possible.  Now you can receive
+    FreeRTOS training directly from Richard Barry, CEO of Real Time Engineers
+    Ltd, and the world's leading authority on the world's leading RTOS.
+
+    http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products,
+    including FreeRTOS+Trace - an indispensable productivity tool, a DOS
+    compatible FAT file system, and our tiny thread aware UDP/IP stack.
+
+    http://www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate.
+    Come and try FreeRTOS+TCP, our new open source TCP/IP stack for FreeRTOS.
+
+    http://www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High
+    Integrity Systems ltd. to sell under the OpenRTOS brand.  Low cost OpenRTOS
+    licenses offer ticketed support, indemnification and commercial middleware.
+
+    http://www.SafeRTOS.com - High Integrity Systems also provide a safety
+    engineered and independently SIL3 certified version for use in safety and
+    mission critical applications that require provable dependability.
+
+    1 tab == 4 spaces!
+*/
+
+/* Standard includes. */
+#include 
+
+/* Defining MPU_WRAPPERS_INCLUDED_FROM_API_FILE prevents task.h from redefining
+all the API functions to use the MPU wrappers.  That should only be done when
+task.h is included from an application file. */
+#define MPU_WRAPPERS_INCLUDED_FROM_API_FILE
+
+#include "FreeRTOS.h"
+#include "task.h"
+#include "queue.h"
+#include "timers.h"
+
+#if ( INCLUDE_xTimerPendFunctionCall == 1 ) && ( configUSE_TIMERS == 0 )
+	#error configUSE_TIMERS must be set to 1 to make the xTimerPendFunctionCall() function available.
+#endif
+
+/* Lint e961 and e750 are suppressed as a MISRA exception justified because the
+MPU ports require MPU_WRAPPERS_INCLUDED_FROM_API_FILE to be defined for the
+header files above, but not in this file, in order to generate the correct
+privileged Vs unprivileged linkage and placement. */
+#undef MPU_WRAPPERS_INCLUDED_FROM_API_FILE /*lint !e961 !e750. */
+
+
+/* This entire source file will be skipped if the application is not configured
+to include software timer functionality.  This #if is closed at the very bottom
+of this file.  If you want to include software timer functionality then ensure
+configUSE_TIMERS is set to 1 in FreeRTOSConfig.h. */
+#if ( configUSE_TIMERS == 1 )
+
+/* Misc definitions. */
+#define tmrNO_DELAY		( TickType_t ) 0U
+
+/* The definition of the timers themselves. */
+typedef struct tmrTimerControl
+{
+	const char				*pcTimerName;		/*<< Text name.  This is not used by the kernel, it is included simply to make debugging easier. */ /*lint !e971 Unqualified char types are allowed for strings and single characters only. */
+	ListItem_t				xTimerListItem;		/*<< Standard linked list item as used by all kernel features for event management. */
+	TickType_t				xTimerPeriodInTicks;/*<< How quickly and often the timer expires. */
+	UBaseType_t				uxAutoReload;		/*<< Set to pdTRUE if the timer should be automatically restarted once expired.  Set to pdFALSE if the timer is, in effect, a one-shot timer. */
+	void 					*pvTimerID;			/*<< An ID to identify the timer.  This allows the timer to be identified when the same callback is used for multiple timers. */
+	TimerCallbackFunction_t	pxCallbackFunction;	/*<< The function that will be called when the timer expires. */
+	#if( configUSE_TRACE_FACILITY == 1 )
+		UBaseType_t			uxTimerNumber;		/*<< An ID assigned by trace tools such as FreeRTOS+Trace */
+	#endif
+
+	#if( ( configSUPPORT_STATIC_ALLOCATION == 1 ) && ( configSUPPORT_DYNAMIC_ALLOCATION == 1 ) )
+		uint8_t 			ucStaticallyAllocated; /*<< Set to pdTRUE if the timer was created statically so no attempt is made to free the memory again if the timer is later deleted. */
+	#endif
+} xTIMER;
+
+/* The old xTIMER name is maintained above then typedefed to the new Timer_t
+name below to enable the use of older kernel aware debuggers. */
+typedef xTIMER Timer_t;
+
+/* The definition of messages that can be sent and received on the timer queue.
+Two types of message can be queued - messages that manipulate a software timer,
+and messages that request the execution of a non-timer related callback.  The
+two message types are defined in two separate structures, xTimerParametersType
+and xCallbackParametersType respectively. */
+typedef struct tmrTimerParameters
+{
+	TickType_t			xMessageValue;		/*<< An optional value used by a subset of commands, for example, when changing the period of a timer. */
+	Timer_t *			pxTimer;			/*<< The timer to which the command will be applied. */
+} TimerParameter_t;
+
+
+typedef struct tmrCallbackParameters
+{
+	PendedFunction_t	pxCallbackFunction;	/* << The callback function to execute. */
+	void *pvParameter1;						/* << The value that will be used as the callback functions first parameter. */
+	uint32_t ulParameter2;					/* << The value that will be used as the callback functions second parameter. */
+} CallbackParameters_t;
+
+/* The structure that contains the two message types, along with an identifier
+that is used to determine which message type is valid. */
+typedef struct tmrTimerQueueMessage
+{
+	BaseType_t			xMessageID;			/*<< The command being sent to the timer service task. */
+	union
+	{
+		TimerParameter_t xTimerParameters;
+
+		/* Don't include xCallbackParameters if it is not going to be used as
+		it makes the structure (and therefore the timer queue) larger. */
+		#if ( INCLUDE_xTimerPendFunctionCall == 1 )
+			CallbackParameters_t xCallbackParameters;
+		#endif /* INCLUDE_xTimerPendFunctionCall */
+	} u;
+} DaemonTaskMessage_t;
+
+/*lint -e956 A manual analysis and inspection has been used to determine which
+static variables must be declared volatile. */
+
+/* The list in which active timers are stored.  Timers are referenced in expire
+time order, with the nearest expiry time at the front of the list.  Only the
+timer service task is allowed to access these lists. */
+PRIVILEGED_DATA static List_t xActiveTimerList1;
+PRIVILEGED_DATA static List_t xActiveTimerList2;
+PRIVILEGED_DATA static List_t *pxCurrentTimerList;
+PRIVILEGED_DATA static List_t *pxOverflowTimerList;
+
+/* A queue that is used to send commands to the timer service task. */
+PRIVILEGED_DATA static QueueHandle_t xTimerQueue = NULL;
+PRIVILEGED_DATA static TaskHandle_t xTimerTaskHandle = NULL;
+
+/*lint +e956 */
+
+/*-----------------------------------------------------------*/
+
+#if( configSUPPORT_STATIC_ALLOCATION == 1 )
+
+	/* If static allocation is supported then the application must provide the
+	following callback function - which enables the application to optionally
+	provide the memory that will be used by the timer task as the task's stack
+	and TCB. */
+	extern void vApplicationGetTimerTaskMemory( StaticTask_t **ppxTimerTaskTCBBuffer, StackType_t **ppxTimerTaskStackBuffer, uint32_t *pulTimerTaskStackSize );
+
+#endif
+
+/*
+ * Initialise the infrastructure used by the timer service task if it has not
+ * been initialised already.
+ */
+static void prvCheckForValidListAndQueue( void ) PRIVILEGED_FUNCTION;
+
+/*
+ * The timer service task (daemon).  Timer functionality is controlled by this
+ * task.  Other tasks communicate with the timer service task using the
+ * xTimerQueue queue.
+ */
+static void prvTimerTask( void *pvParameters ) PRIVILEGED_FUNCTION;
+
+/*
+ * Called by the timer service task to interpret and process a command it
+ * received on the timer queue.
+ */
+static void prvProcessReceivedCommands( void ) PRIVILEGED_FUNCTION;
+
+/*
+ * Insert the timer into either xActiveTimerList1, or xActiveTimerList2,
+ * depending on if the expire time causes a timer counter overflow.
+ */
+static BaseType_t prvInsertTimerInActiveList( Timer_t * const pxTimer, const TickType_t xNextExpiryTime, const TickType_t xTimeNow, const TickType_t xCommandTime ) PRIVILEGED_FUNCTION;
+
+/*
+ * An active timer has reached its expire time.  Reload the timer if it is an
+ * auto reload timer, then call its callback.
+ */
+static void prvProcessExpiredTimer( const TickType_t xNextExpireTime, const TickType_t xTimeNow ) PRIVILEGED_FUNCTION;
+
+/*
+ * The tick count has overflowed.  Switch the timer lists after ensuring the
+ * current timer list does not still reference some timers.
+ */
+static void prvSwitchTimerLists( void ) PRIVILEGED_FUNCTION;
+
+/*
+ * Obtain the current tick count, setting *pxTimerListsWereSwitched to pdTRUE
+ * if a tick count overflow occurred since prvSampleTimeNow() was last called.
+ */
+static TickType_t prvSampleTimeNow( BaseType_t * const pxTimerListsWereSwitched ) PRIVILEGED_FUNCTION;
+
+/*
+ * If the timer list contains any active timers then return the expire time of
+ * the timer that will expire first and set *pxListWasEmpty to false.  If the
+ * timer list does not contain any timers then return 0 and set *pxListWasEmpty
+ * to pdTRUE.
+ */
+static TickType_t prvGetNextExpireTime( BaseType_t * const pxListWasEmpty ) PRIVILEGED_FUNCTION;
+
+/*
+ * If a timer has expired, process it.  Otherwise, block the timer service task
+ * until either a timer does expire or a command is received.
+ */
+static void prvProcessTimerOrBlockTask( const TickType_t xNextExpireTime, BaseType_t xListWasEmpty ) PRIVILEGED_FUNCTION;
+
+/*
+ * Called after a Timer_t structure has been allocated either statically or
+ * dynamically to fill in the structure's members.
+ */
+static void prvInitialiseNewTimer(	const char * const pcTimerName,
+									const TickType_t xTimerPeriodInTicks,
+									const UBaseType_t uxAutoReload,
+									void * const pvTimerID,
+									TimerCallbackFunction_t pxCallbackFunction,
+									Timer_t *pxNewTimer ) PRIVILEGED_FUNCTION; /*lint !e971 Unqualified char types are allowed for strings and single characters only. */
+/*-----------------------------------------------------------*/
+
+BaseType_t xTimerCreateTimerTask( void )
+{
+BaseType_t xReturn = pdFAIL;
+
+	/* This function is called when the scheduler is started if
+	configUSE_TIMERS is set to 1.  Check that the infrastructure used by the
+	timer service task has been created/initialised.  If timers have already
+	been created then the initialisation will already have been performed. */
+	prvCheckForValidListAndQueue();
+
+	if( xTimerQueue != NULL )
+	{
+		#if( configSUPPORT_STATIC_ALLOCATION == 1 )
+		{
+			StaticTask_t *pxTimerTaskTCBBuffer = NULL;
+			StackType_t *pxTimerTaskStackBuffer = NULL;
+			uint32_t ulTimerTaskStackSize;
+
+			vApplicationGetTimerTaskMemory( &pxTimerTaskTCBBuffer, &pxTimerTaskStackBuffer, &ulTimerTaskStackSize );
+			xTimerTaskHandle = xTaskCreateStatic(	prvTimerTask,
+													"Tmr Svc",
+													ulTimerTaskStackSize,
+													NULL,
+													( ( UBaseType_t ) configTIMER_TASK_PRIORITY ) | portPRIVILEGE_BIT,
+													pxTimerTaskStackBuffer,
+													pxTimerTaskTCBBuffer );
+
+			if( xTimerTaskHandle != NULL )
+			{
+				xReturn = pdPASS;
+			}
+		}
+		#else
+		{
+			xReturn = xTaskCreate(	prvTimerTask,
+									"Tmr Svc",
+									configTIMER_TASK_STACK_DEPTH,
+									NULL,
+									( ( UBaseType_t ) configTIMER_TASK_PRIORITY ) | portPRIVILEGE_BIT,
+									&xTimerTaskHandle );
+		}
+		#endif /* configSUPPORT_STATIC_ALLOCATION */
+	}
+	else
+	{
+		mtCOVERAGE_TEST_MARKER();
+	}
+
+	configASSERT( xReturn );
+	return xReturn;
+}
+/*-----------------------------------------------------------*/
+
+#if( configSUPPORT_DYNAMIC_ALLOCATION == 1 )
+
+	TimerHandle_t xTimerCreate(	const char * const pcTimerName,
+								const TickType_t xTimerPeriodInTicks,
+								const UBaseType_t uxAutoReload,
+								void * const pvTimerID,
+								TimerCallbackFunction_t pxCallbackFunction ) /*lint !e971 Unqualified char types are allowed for strings and single characters only. */
+	{
+	Timer_t *pxNewTimer;
+
+		pxNewTimer = ( Timer_t * ) pvPortMalloc( sizeof( Timer_t ) );
+
+		if( pxNewTimer != NULL )
+		{
+			prvInitialiseNewTimer( pcTimerName, xTimerPeriodInTicks, uxAutoReload, pvTimerID, pxCallbackFunction, pxNewTimer );
+
+			#if( configSUPPORT_STATIC_ALLOCATION == 1 )
+			{
+				/* Timers can be created statically or dynamically, so note this
+				timer was created dynamically in case the timer is later
+				deleted. */
+				pxNewTimer->ucStaticallyAllocated = pdFALSE;
+			}
+			#endif /* configSUPPORT_STATIC_ALLOCATION */
+		}
+
+		return pxNewTimer;
+	}
+
+#endif /* configSUPPORT_STATIC_ALLOCATION */
+/*-----------------------------------------------------------*/
+
+#if( configSUPPORT_STATIC_ALLOCATION == 1 )
+
+	TimerHandle_t xTimerCreateStatic(	const char * const pcTimerName,
+										const TickType_t xTimerPeriodInTicks,
+										const UBaseType_t uxAutoReload,
+										void * const pvTimerID,
+										TimerCallbackFunction_t pxCallbackFunction,
+										StaticTimer_t *pxTimerBuffer ) /*lint !e971 Unqualified char types are allowed for strings and single characters only. */
+	{
+	Timer_t *pxNewTimer;
+
+		#if( configASSERT_DEFINED == 1 )
+		{
+			/* Sanity check that the size of the structure used to declare a
+			variable of type StaticTimer_t equals the size of the real timer
+			structures. */
+			volatile size_t xSize = sizeof( StaticTimer_t );
+			configASSERT( xSize == sizeof( Timer_t ) );
+		}
+		#endif /* configASSERT_DEFINED */
+
+		/* A pointer to a StaticTimer_t structure MUST be provided, use it. */
+		configASSERT( pxTimerBuffer );
+		pxNewTimer = ( Timer_t * ) pxTimerBuffer; /*lint !e740 Unusual cast is ok as the structures are designed to have the same alignment, and the size is checked by an assert. */
+
+		if( pxNewTimer != NULL )
+		{
+			prvInitialiseNewTimer( pcTimerName, xTimerPeriodInTicks, uxAutoReload, pvTimerID, pxCallbackFunction, pxNewTimer );
+
+			#if( configSUPPORT_DYNAMIC_ALLOCATION == 1 )
+			{
+				/* Timers can be created statically or dynamically so note this
+				timer was created statically in case it is later deleted. */
+				pxNewTimer->ucStaticallyAllocated = pdTRUE;
+			}
+			#endif /* configSUPPORT_DYNAMIC_ALLOCATION */
+		}
+
+		return pxNewTimer;
+	}
+
+#endif /* configSUPPORT_STATIC_ALLOCATION */
+/*-----------------------------------------------------------*/
+
+static void prvInitialiseNewTimer(	const char * const pcTimerName,
+									const TickType_t xTimerPeriodInTicks,
+									const UBaseType_t uxAutoReload,
+									void * const pvTimerID,
+									TimerCallbackFunction_t pxCallbackFunction,
+									Timer_t *pxNewTimer ) /*lint !e971 Unqualified char types are allowed for strings and single characters only. */
+{
+	/* 0 is not a valid value for xTimerPeriodInTicks. */
+	configASSERT( ( xTimerPeriodInTicks > 0 ) );
+
+	if( pxNewTimer != NULL )
+	{
+		/* Ensure the infrastructure used by the timer service task has been
+		created/initialised. */
+		prvCheckForValidListAndQueue();
+
+		/* Initialise the timer structure members using the function
+		parameters. */
+		pxNewTimer->pcTimerName = pcTimerName;
+		pxNewTimer->xTimerPeriodInTicks = xTimerPeriodInTicks;
+		pxNewTimer->uxAutoReload = uxAutoReload;
+		pxNewTimer->pvTimerID = pvTimerID;
+		pxNewTimer->pxCallbackFunction = pxCallbackFunction;
+		vListInitialiseItem( &( pxNewTimer->xTimerListItem ) );
+		traceTIMER_CREATE( pxNewTimer );
+	}
+}
+/*-----------------------------------------------------------*/
+
+BaseType_t xTimerGenericCommand( TimerHandle_t xTimer, const BaseType_t xCommandID, const TickType_t xOptionalValue, BaseType_t * const pxHigherPriorityTaskWoken, const TickType_t xTicksToWait )
+{
+BaseType_t xReturn = pdFAIL;
+DaemonTaskMessage_t xMessage;
+
+	configASSERT( xTimer );
+
+	/* Send a message to the timer service task to perform a particular action
+	on a particular timer definition. */
+	if( xTimerQueue != NULL )
+	{
+		/* Send a command to the timer service task to start the xTimer timer. */
+		xMessage.xMessageID = xCommandID;
+		xMessage.u.xTimerParameters.xMessageValue = xOptionalValue;
+		xMessage.u.xTimerParameters.pxTimer = ( Timer_t * ) xTimer;
+
+		if( xCommandID < tmrFIRST_FROM_ISR_COMMAND )
+		{
+			if( xTaskGetSchedulerState() == taskSCHEDULER_RUNNING )
+			{
+				xReturn = xQueueSendToBack( xTimerQueue, &xMessage, xTicksToWait );
+			}
+			else
+			{
+				xReturn = xQueueSendToBack( xTimerQueue, &xMessage, tmrNO_DELAY );
+			}
+		}
+		else
+		{
+			xReturn = xQueueSendToBackFromISR( xTimerQueue, &xMessage, pxHigherPriorityTaskWoken );
+		}
+
+		traceTIMER_COMMAND_SEND( xTimer, xCommandID, xOptionalValue, xReturn );
+	}
+	else
+	{
+		mtCOVERAGE_TEST_MARKER();
+	}
+
+	return xReturn;
+}
+/*-----------------------------------------------------------*/
+
+TaskHandle_t xTimerGetTimerDaemonTaskHandle( void )
+{
+	/* If xTimerGetTimerDaemonTaskHandle() is called before the scheduler has been
+	started, then xTimerTaskHandle will be NULL. */
+	configASSERT( ( xTimerTaskHandle != NULL ) );
+	return xTimerTaskHandle;
+}
+/*-----------------------------------------------------------*/
+
+TickType_t xTimerGetPeriod( TimerHandle_t xTimer )
+{
+Timer_t *pxTimer = ( Timer_t * ) xTimer;
+
+	configASSERT( xTimer );
+	return pxTimer->xTimerPeriodInTicks;
+}
+/*-----------------------------------------------------------*/
+
+TickType_t xTimerGetExpiryTime( TimerHandle_t xTimer )
+{
+Timer_t * pxTimer = ( Timer_t * ) xTimer;
+TickType_t xReturn;
+
+	configASSERT( xTimer );
+	xReturn = listGET_LIST_ITEM_VALUE( &( pxTimer->xTimerListItem ) );
+	return xReturn;
+}
+/*-----------------------------------------------------------*/
+
+const char * pcTimerGetName( TimerHandle_t xTimer ) /*lint !e971 Unqualified char types are allowed for strings and single characters only. */
+{
+Timer_t *pxTimer = ( Timer_t * ) xTimer;
+
+	configASSERT( xTimer );
+	return pxTimer->pcTimerName;
+}
+/*-----------------------------------------------------------*/
+
+static void prvProcessExpiredTimer( const TickType_t xNextExpireTime, const TickType_t xTimeNow )
+{
+BaseType_t xResult;
+Timer_t * const pxTimer = ( Timer_t * ) listGET_OWNER_OF_HEAD_ENTRY( pxCurrentTimerList );
+
+	/* Remove the timer from the list of active timers.  A check has already
+	been performed to ensure the list is not empty. */
+	( void ) uxListRemove( &( pxTimer->xTimerListItem ) );
+	traceTIMER_EXPIRED( pxTimer );
+
+	/* If the timer is an auto reload timer then calculate the next
+	expiry time and re-insert the timer in the list of active timers. */
+	if( pxTimer->uxAutoReload == ( UBaseType_t ) pdTRUE )
+	{
+		/* The timer is inserted into a list using a time relative to anything
+		other than the current time.  It will therefore be inserted into the
+		correct list relative to the time this task thinks it is now. */
+		if( prvInsertTimerInActiveList( pxTimer, ( xNextExpireTime + pxTimer->xTimerPeriodInTicks ), xTimeNow, xNextExpireTime ) != pdFALSE )
+		{
+			/* The timer expired before it was added to the active timer
+			list.  Reload it now.  */
+			xResult = xTimerGenericCommand( pxTimer, tmrCOMMAND_START_DONT_TRACE, xNextExpireTime, NULL, tmrNO_DELAY );
+			configASSERT( xResult );
+			( void ) xResult;
+		}
+		else
+		{
+			mtCOVERAGE_TEST_MARKER();
+		}
+	}
+	else
+	{
+		mtCOVERAGE_TEST_MARKER();
+	}
+
+	/* Call the timer callback. */
+	pxTimer->pxCallbackFunction( ( TimerHandle_t ) pxTimer );
+}
+/*-----------------------------------------------------------*/
+
+static void prvTimerTask( void *pvParameters )
+{
+TickType_t xNextExpireTime;
+BaseType_t xListWasEmpty;
+
+	/* Just to avoid compiler warnings. */
+	( void ) pvParameters;
+
+	#if( configUSE_DAEMON_TASK_STARTUP_HOOK == 1 )
+	{
+		extern void vApplicationDaemonTaskStartupHook( void );
+
+		/* Allow the application writer to execute some code in the context of
+		this task at the point the task starts executing.  This is useful if the
+		application includes initialisation code that would benefit from
+		executing after the scheduler has been started. */
+		vApplicationDaemonTaskStartupHook();
+	}
+	#endif /* configUSE_DAEMON_TASK_STARTUP_HOOK */
+
+	for( ;; )
+	{
+		/* Query the timers list to see if it contains any timers, and if so,
+		obtain the time at which the next timer will expire. */
+		xNextExpireTime = prvGetNextExpireTime( &xListWasEmpty );
+
+		/* If a timer has expired, process it.  Otherwise, block this task
+		until either a timer does expire, or a command is received. */
+		prvProcessTimerOrBlockTask( xNextExpireTime, xListWasEmpty );
+
+		/* Empty the command queue. */
+		prvProcessReceivedCommands();
+	}
+}
+/*-----------------------------------------------------------*/
+
+static void prvProcessTimerOrBlockTask( const TickType_t xNextExpireTime, BaseType_t xListWasEmpty )
+{
+TickType_t xTimeNow;
+BaseType_t xTimerListsWereSwitched;
+
+	vTaskSuspendAll();
+	{
+		/* Obtain the time now to make an assessment as to whether the timer
+		has expired or not.  If obtaining the time causes the lists to switch
+		then don't process this timer as any timers that remained in the list
+		when the lists were switched will have been processed within the
+		prvSampleTimeNow() function. */
+		xTimeNow = prvSampleTimeNow( &xTimerListsWereSwitched );
+		if( xTimerListsWereSwitched == pdFALSE )
+		{
+			/* The tick count has not overflowed, has the timer expired? */
+			if( ( xListWasEmpty == pdFALSE ) && ( xNextExpireTime <= xTimeNow ) )
+			{
+				( void ) xTaskResumeAll();
+				prvProcessExpiredTimer( xNextExpireTime, xTimeNow );
+			}
+			else
+			{
+				/* The tick count has not overflowed, and the next expire
+				time has not been reached yet.  This task should therefore
+				block to wait for the next expire time or a command to be
+				received - whichever comes first.  The following line cannot
+				be reached unless xNextExpireTime > xTimeNow, except in the
+				case when the current timer list is empty. */
+				if( xListWasEmpty != pdFALSE )
+				{
+					/* The current timer list is empty - is the overflow list
+					also empty? */
+					xListWasEmpty = listLIST_IS_EMPTY( pxOverflowTimerList );
+				}
+
+				vQueueWaitForMessageRestricted( xTimerQueue, ( xNextExpireTime - xTimeNow ), xListWasEmpty );
+
+				if( xTaskResumeAll() == pdFALSE )
+				{
+					/* Yield to wait for either a command to arrive, or the
+					block time to expire.  If a command arrived between the
+					critical section being exited and this yield then the yield
+					will not cause the task to block. */
+					portYIELD_WITHIN_API();
+				}
+				else
+				{
+					mtCOVERAGE_TEST_MARKER();
+				}
+			}
+		}
+		else
+		{
+			( void ) xTaskResumeAll();
+		}
+	}
+}
+/*-----------------------------------------------------------*/
+
+static TickType_t prvGetNextExpireTime( BaseType_t * const pxListWasEmpty )
+{
+TickType_t xNextExpireTime;
+
+	/* Timers are listed in expiry time order, with the head of the list
+	referencing the task that will expire first.  Obtain the time at which
+	the timer with the nearest expiry time will expire.  If there are no
+	active timers then just set the next expire time to 0.  That will cause
+	this task to unblock when the tick count overflows, at which point the
+	timer lists will be switched and the next expiry time can be
+	re-assessed.  */
+	*pxListWasEmpty = listLIST_IS_EMPTY( pxCurrentTimerList );
+	if( *pxListWasEmpty == pdFALSE )
+	{
+		xNextExpireTime = listGET_ITEM_VALUE_OF_HEAD_ENTRY( pxCurrentTimerList );
+	}
+	else
+	{
+		/* Ensure the task unblocks when the tick count rolls over. */
+		xNextExpireTime = ( TickType_t ) 0U;
+	}
+
+	return xNextExpireTime;
+}
+/*-----------------------------------------------------------*/
+
+static TickType_t prvSampleTimeNow( BaseType_t * const pxTimerListsWereSwitched )
+{
+TickType_t xTimeNow;
+PRIVILEGED_DATA static TickType_t xLastTime = ( TickType_t ) 0U; /*lint !e956 Variable is only accessible to one task. */
+
+	xTimeNow = xTaskGetTickCount();
+
+	if( xTimeNow < xLastTime )
+	{
+		prvSwitchTimerLists();
+		*pxTimerListsWereSwitched = pdTRUE;
+	}
+	else
+	{
+		*pxTimerListsWereSwitched = pdFALSE;
+	}
+
+	xLastTime = xTimeNow;
+
+	return xTimeNow;
+}
+/*-----------------------------------------------------------*/
+
+static BaseType_t prvInsertTimerInActiveList( Timer_t * const pxTimer, const TickType_t xNextExpiryTime, const TickType_t xTimeNow, const TickType_t xCommandTime )
+{
+BaseType_t xProcessTimerNow = pdFALSE;
+
+	listSET_LIST_ITEM_VALUE( &( pxTimer->xTimerListItem ), xNextExpiryTime );
+	listSET_LIST_ITEM_OWNER( &( pxTimer->xTimerListItem ), pxTimer );
+
+	if( xNextExpiryTime <= xTimeNow )
+	{
+		/* Has the expiry time elapsed between the command to start/reset a
+		timer was issued, and the time the command was processed? */
+		if( ( ( TickType_t ) ( xTimeNow - xCommandTime ) ) >= pxTimer->xTimerPeriodInTicks ) /*lint !e961 MISRA exception as the casts are only redundant for some ports. */
+		{
+			/* The time between a command being issued and the command being
+			processed actually exceeds the timers period.  */
+			xProcessTimerNow = pdTRUE;
+		}
+		else
+		{
+			vListInsert( pxOverflowTimerList, &( pxTimer->xTimerListItem ) );
+		}
+	}
+	else
+	{
+		if( ( xTimeNow < xCommandTime ) && ( xNextExpiryTime >= xCommandTime ) )
+		{
+			/* If, since the command was issued, the tick count has overflowed
+			but the expiry time has not, then the timer must have already passed
+			its expiry time and should be processed immediately. */
+			xProcessTimerNow = pdTRUE;
+		}
+		else
+		{
+			vListInsert( pxCurrentTimerList, &( pxTimer->xTimerListItem ) );
+		}
+	}
+
+	return xProcessTimerNow;
+}
+/*-----------------------------------------------------------*/
+
+static void	prvProcessReceivedCommands( void )
+{
+DaemonTaskMessage_t xMessage;
+Timer_t *pxTimer;
+BaseType_t xTimerListsWereSwitched, xResult;
+TickType_t xTimeNow;
+
+	while( xQueueReceive( xTimerQueue, &xMessage, tmrNO_DELAY ) != pdFAIL ) /*lint !e603 xMessage does not have to be initialised as it is passed out, not in, and it is not used unless xQueueReceive() returns pdTRUE. */
+	{
+		#if ( INCLUDE_xTimerPendFunctionCall == 1 )
+		{
+			/* Negative commands are pended function calls rather than timer
+			commands. */
+			if( xMessage.xMessageID < ( BaseType_t ) 0 )
+			{
+				const CallbackParameters_t * const pxCallback = &( xMessage.u.xCallbackParameters );
+
+				/* The timer uses the xCallbackParameters member to request a
+				callback be executed.  Check the callback is not NULL. */
+				configASSERT( pxCallback );
+
+				/* Call the function. */
+				pxCallback->pxCallbackFunction( pxCallback->pvParameter1, pxCallback->ulParameter2 );
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+		}
+		#endif /* INCLUDE_xTimerPendFunctionCall */
+
+		/* Commands that are positive are timer commands rather than pended
+		function calls. */
+		if( xMessage.xMessageID >= ( BaseType_t ) 0 )
+		{
+			/* The messages uses the xTimerParameters member to work on a
+			software timer. */
+			pxTimer = xMessage.u.xTimerParameters.pxTimer;
+
+			if( listIS_CONTAINED_WITHIN( NULL, &( pxTimer->xTimerListItem ) ) == pdFALSE )
+			{
+				/* The timer is in a list, remove it. */
+				( void ) uxListRemove( &( pxTimer->xTimerListItem ) );
+			}
+			else
+			{
+				mtCOVERAGE_TEST_MARKER();
+			}
+
+			traceTIMER_COMMAND_RECEIVED( pxTimer, xMessage.xMessageID, xMessage.u.xTimerParameters.xMessageValue );
+
+			/* In this case the xTimerListsWereSwitched parameter is not used, but
+			it must be present in the function call.  prvSampleTimeNow() must be
+			called after the message is received from xTimerQueue so there is no
+			possibility of a higher priority task adding a message to the message
+			queue with a time that is ahead of the timer daemon task (because it
+			pre-empted the timer daemon task after the xTimeNow value was set). */
+			xTimeNow = prvSampleTimeNow( &xTimerListsWereSwitched );
+
+			switch( xMessage.xMessageID )
+			{
+				case tmrCOMMAND_START :
+			    case tmrCOMMAND_START_FROM_ISR :
+			    case tmrCOMMAND_RESET :
+			    case tmrCOMMAND_RESET_FROM_ISR :
+				case tmrCOMMAND_START_DONT_TRACE :
+					/* Start or restart a timer. */
+					if( prvInsertTimerInActiveList( pxTimer,  xMessage.u.xTimerParameters.xMessageValue + pxTimer->xTimerPeriodInTicks, xTimeNow, xMessage.u.xTimerParameters.xMessageValue ) != pdFALSE )
+					{
+						/* The timer expired before it was added to the active
+						timer list.  Process it now. */
+						pxTimer->pxCallbackFunction( ( TimerHandle_t ) pxTimer );
+						traceTIMER_EXPIRED( pxTimer );
+
+						if( pxTimer->uxAutoReload == ( UBaseType_t ) pdTRUE )
+						{
+							xResult = xTimerGenericCommand( pxTimer, tmrCOMMAND_START_DONT_TRACE, xMessage.u.xTimerParameters.xMessageValue + pxTimer->xTimerPeriodInTicks, NULL, tmrNO_DELAY );
+							configASSERT( xResult );
+							( void ) xResult;
+						}
+						else
+						{
+							mtCOVERAGE_TEST_MARKER();
+						}
+					}
+					else
+					{
+						mtCOVERAGE_TEST_MARKER();
+					}
+					break;
+
+				case tmrCOMMAND_STOP :
+				case tmrCOMMAND_STOP_FROM_ISR :
+					/* The timer has already been removed from the active list.
+					There is nothing to do here. */
+					break;
+
+				case tmrCOMMAND_CHANGE_PERIOD :
+				case tmrCOMMAND_CHANGE_PERIOD_FROM_ISR :
+					pxTimer->xTimerPeriodInTicks = xMessage.u.xTimerParameters.xMessageValue;
+					configASSERT( ( pxTimer->xTimerPeriodInTicks > 0 ) );
+
+					/* The new period does not really have a reference, and can
+					be longer or shorter than the old one.  The command time is
+					therefore set to the current time, and as the period cannot
+					be zero the next expiry time can only be in the future,
+					meaning (unlike for the xTimerStart() case above) there is
+					no fail case that needs to be handled here. */
+					( void ) prvInsertTimerInActiveList( pxTimer, ( xTimeNow + pxTimer->xTimerPeriodInTicks ), xTimeNow, xTimeNow );
+					break;
+
+				case tmrCOMMAND_DELETE :
+					/* The timer has already been removed from the active list,
+					just free up the memory if the memory was dynamically
+					allocated. */
+					#if( ( configSUPPORT_DYNAMIC_ALLOCATION == 1 ) && ( configSUPPORT_STATIC_ALLOCATION == 0 ) )
+					{
+						/* The timer can only have been allocated dynamically -
+						free it again. */
+						vPortFree( pxTimer );
+					}
+					#elif( ( configSUPPORT_DYNAMIC_ALLOCATION == 1 ) && ( configSUPPORT_STATIC_ALLOCATION == 1 ) )
+					{
+						/* The timer could have been allocated statically or
+						dynamically, so check before attempting to free the
+						memory. */
+						if( pxTimer->ucStaticallyAllocated == ( uint8_t ) pdFALSE )
+						{
+							vPortFree( pxTimer );
+						}
+						else
+						{
+							mtCOVERAGE_TEST_MARKER();
+						}
+					}
+					#endif /* configSUPPORT_DYNAMIC_ALLOCATION */
+					break;
+
+				default	:
+					/* Don't expect to get here. */
+					break;
+			}
+		}
+	}
+}
+/*-----------------------------------------------------------*/
+
+static void prvSwitchTimerLists( void )
+{
+TickType_t xNextExpireTime, xReloadTime;
+List_t *pxTemp;
+Timer_t *pxTimer;
+BaseType_t xResult;
+
+	/* The tick count has overflowed.  The timer lists must be switched.
+	If there are any timers still referenced from the current timer list
+	then they must have expired and should be processed before the lists
+	are switched. */
+	while( listLIST_IS_EMPTY( pxCurrentTimerList ) == pdFALSE )
+	{
+		xNextExpireTime = listGET_ITEM_VALUE_OF_HEAD_ENTRY( pxCurrentTimerList );
+
+		/* Remove the timer from the list. */
+		pxTimer = ( Timer_t * ) listGET_OWNER_OF_HEAD_ENTRY( pxCurrentTimerList );
+		( void ) uxListRemove( &( pxTimer->xTimerListItem ) );
+		traceTIMER_EXPIRED( pxTimer );
+
+		/* Execute its callback, then send a command to restart the timer if
+		it is an auto-reload timer.  It cannot be restarted here as the lists
+		have not yet been switched. */
+		pxTimer->pxCallbackFunction( ( TimerHandle_t ) pxTimer );
+
+		if( pxTimer->uxAutoReload == ( UBaseType_t ) pdTRUE )
+		{
+			/* Calculate the reload value, and if the reload value results in
+			the timer going into the same timer list then it has already expired
+			and the timer should be re-inserted into the current list so it is
+			processed again within this loop.  Otherwise a command should be sent
+			to restart the timer to ensure it is only inserted into a list after
+			the lists have been swapped. */
+			xReloadTime = ( xNextExpireTime + pxTimer->xTimerPeriodInTicks );
+			if( xReloadTime > xNextExpireTime )
+			{
+				listSET_LIST_ITEM_VALUE( &( pxTimer->xTimerListItem ), xReloadTime );
+				listSET_LIST_ITEM_OWNER( &( pxTimer->xTimerListItem ), pxTimer );
+				vListInsert( pxCurrentTimerList, &( pxTimer->xTimerListItem ) );
+			}
+			else
+			{
+				xResult = xTimerGenericCommand( pxTimer, tmrCOMMAND_START_DONT_TRACE, xNextExpireTime, NULL, tmrNO_DELAY );
+				configASSERT( xResult );
+				( void ) xResult;
+			}
+		}
+		else
+		{
+			mtCOVERAGE_TEST_MARKER();
+		}
+	}
+
+	pxTemp = pxCurrentTimerList;
+	pxCurrentTimerList = pxOverflowTimerList;
+	pxOverflowTimerList = pxTemp;
+}
+/*-----------------------------------------------------------*/
+
+static void prvCheckForValidListAndQueue( void )
+{
+	/* Check that the list from which active timers are referenced, and the
+	queue used to communicate with the timer service, have been
+	initialised. */
+	taskENTER_CRITICAL();
+	{
+		if( xTimerQueue == NULL )
+		{
+			vListInitialise( &xActiveTimerList1 );
+			vListInitialise( &xActiveTimerList2 );
+			pxCurrentTimerList = &xActiveTimerList1;
+			pxOverflowTimerList = &xActiveTimerList2;
+
+			#if( configSUPPORT_STATIC_ALLOCATION == 1 )
+			{
+				/* The timer queue is allocated statically in case
+				configSUPPORT_DYNAMIC_ALLOCATION is 0. */
+				static StaticQueue_t xStaticTimerQueue;
+				static uint8_t ucStaticTimerQueueStorage[ configTIMER_QUEUE_LENGTH * sizeof( DaemonTaskMessage_t ) ];
+
+				xTimerQueue = xQueueCreateStatic( ( UBaseType_t ) configTIMER_QUEUE_LENGTH, sizeof( DaemonTaskMessage_t ), &( ucStaticTimerQueueStorage[ 0 ] ), &xStaticTimerQueue );
+			}
+			#else
+			{
+				xTimerQueue = xQueueCreate( ( UBaseType_t ) configTIMER_QUEUE_LENGTH, sizeof( DaemonTaskMessage_t ) );
+			}
+			#endif
+
+			#if ( configQUEUE_REGISTRY_SIZE > 0 )
+			{
+				if( xTimerQueue != NULL )
+				{
+					vQueueAddToRegistry( xTimerQueue, "TmrQ" );
+				}
+				else
+				{
+					mtCOVERAGE_TEST_MARKER();
+				}
+			}
+			#endif /* configQUEUE_REGISTRY_SIZE */
+		}
+		else
+		{
+			mtCOVERAGE_TEST_MARKER();
+		}
+	}
+	taskEXIT_CRITICAL();
+}
+/*-----------------------------------------------------------*/
+
+BaseType_t xTimerIsTimerActive( TimerHandle_t xTimer )
+{
+BaseType_t xTimerIsInActiveList;
+Timer_t *pxTimer = ( Timer_t * ) xTimer;
+
+	configASSERT( xTimer );
+
+	/* Is the timer in the list of active timers? */
+	taskENTER_CRITICAL();
+	{
+		/* Checking to see if it is in the NULL list in effect checks to see if
+		it is referenced from either the current or the overflow timer lists in
+		one go, but the logic has to be reversed, hence the '!'. */
+		xTimerIsInActiveList = ( BaseType_t ) !( listIS_CONTAINED_WITHIN( NULL, &( pxTimer->xTimerListItem ) ) );
+	}
+	taskEXIT_CRITICAL();
+
+	return xTimerIsInActiveList;
+} /*lint !e818 Can't be pointer to const due to the typedef. */
+/*-----------------------------------------------------------*/
+
+void *pvTimerGetTimerID( const TimerHandle_t xTimer )
+{
+Timer_t * const pxTimer = ( Timer_t * ) xTimer;
+void *pvReturn;
+
+	configASSERT( xTimer );
+
+	taskENTER_CRITICAL();
+	{
+		pvReturn = pxTimer->pvTimerID;
+	}
+	taskEXIT_CRITICAL();
+
+	return pvReturn;
+}
+/*-----------------------------------------------------------*/
+
+void vTimerSetTimerID( TimerHandle_t xTimer, void *pvNewID )
+{
+Timer_t * const pxTimer = ( Timer_t * ) xTimer;
+
+	configASSERT( xTimer );
+
+	taskENTER_CRITICAL();
+	{
+		pxTimer->pvTimerID = pvNewID;
+	}
+	taskEXIT_CRITICAL();
+}
+/*-----------------------------------------------------------*/
+
+#if( INCLUDE_xTimerPendFunctionCall == 1 )
+
+	BaseType_t xTimerPendFunctionCallFromISR( PendedFunction_t xFunctionToPend, void *pvParameter1, uint32_t ulParameter2, BaseType_t *pxHigherPriorityTaskWoken )
+	{
+	DaemonTaskMessage_t xMessage;
+	BaseType_t xReturn;
+
+		/* Complete the message with the function parameters and post it to the
+		daemon task. */
+		xMessage.xMessageID = tmrCOMMAND_EXECUTE_CALLBACK_FROM_ISR;
+		xMessage.u.xCallbackParameters.pxCallbackFunction = xFunctionToPend;
+		xMessage.u.xCallbackParameters.pvParameter1 = pvParameter1;
+		xMessage.u.xCallbackParameters.ulParameter2 = ulParameter2;
+
+		xReturn = xQueueSendFromISR( xTimerQueue, &xMessage, pxHigherPriorityTaskWoken );
+
+		tracePEND_FUNC_CALL_FROM_ISR( xFunctionToPend, pvParameter1, ulParameter2, xReturn );
+
+		return xReturn;
+	}
+
+#endif /* INCLUDE_xTimerPendFunctionCall */
+/*-----------------------------------------------------------*/
+
+#if( INCLUDE_xTimerPendFunctionCall == 1 )
+
+	BaseType_t xTimerPendFunctionCall( PendedFunction_t xFunctionToPend, void *pvParameter1, uint32_t ulParameter2, TickType_t xTicksToWait )
+	{
+	DaemonTaskMessage_t xMessage;
+	BaseType_t xReturn;
+
+		/* This function can only be called after a timer has been created or
+		after the scheduler has been started because, until then, the timer
+		queue does not exist. */
+		configASSERT( xTimerQueue );
+
+		/* Complete the message with the function parameters and post it to the
+		daemon task. */
+		xMessage.xMessageID = tmrCOMMAND_EXECUTE_CALLBACK;
+		xMessage.u.xCallbackParameters.pxCallbackFunction = xFunctionToPend;
+		xMessage.u.xCallbackParameters.pvParameter1 = pvParameter1;
+		xMessage.u.xCallbackParameters.ulParameter2 = ulParameter2;
+
+		xReturn = xQueueSendToBack( xTimerQueue, &xMessage, xTicksToWait );
+
+		tracePEND_FUNC_CALL( xFunctionToPend, pvParameter1, ulParameter2, xReturn );
+
+		return xReturn;
+	}
+
+#endif /* INCLUDE_xTimerPendFunctionCall */
+/*-----------------------------------------------------------*/
+
+/* This entire source file will be skipped if the application is not configured
+to include software timer functionality.  If you want to include software timer
+functionality then ensure configUSE_TIMERS is set to 1 in FreeRTOSConfig.h. */
+#endif /* configUSE_TIMERS == 1 */
+
+
+
diff --git a/HARDWARE/DataScope_DP.C b/HARDWARE/DataScope_DP.C
new file mode 100644
index 0000000..d78ee1a
--- /dev/null
+++ b/HARDWARE/DataScope_DP.C
@@ -0,0 +1,85 @@
+ #include "DataScope_DP.h"
+unsigned char DataScope_OutPut_Buffer[42] = {0};	   //串口发送缓冲区
+
+
+//函数说明：将单精度浮点数据转成4字节数据并存入指定地址 
+//附加说明：用户无需直接操作此函数 
+//target:目标单精度数据
+//buf:待写入数组
+//beg:指定从数组第几个元素开始写入
+//函数无返回 
+void Float2Byte(float *target,unsigned char *buf,unsigned char beg)
+{
+    unsigned char *point;
+    point = (unsigned char*)target;	  //得到float的地址
+    buf[beg]   = point[0];
+    buf[beg+1] = point[1];
+    buf[beg+2] = point[2];
+    buf[beg+3] = point[3];
+}
+ 
+ 
+//函数说明：将待发送通道的单精度浮点数据写入发送缓冲区
+//Data：通道数据
+//Channel：选择通道（1-10）
+//函数无返回 
+void DataScope_Get_Channel_Data(float Data,unsigned char Channel)
+{
+	if ( (Channel > 10) || (Channel == 0) ) return;  //通道个数大于10或等于0，直接跳出，不执行函数
+  else
+  {
+     switch (Channel)
+		{
+      case 1:  Float2Byte(&Data,DataScope_OutPut_Buffer,1); break;
+      case 2:  Float2Byte(&Data,DataScope_OutPut_Buffer,5); break;
+		  case 3:  Float2Byte(&Data,DataScope_OutPut_Buffer,9); break;
+		  case 4:  Float2Byte(&Data,DataScope_OutPut_Buffer,13); break;
+		  case 5:  Float2Byte(&Data,DataScope_OutPut_Buffer,17); break;
+		  case 6:  Float2Byte(&Data,DataScope_OutPut_Buffer,21); break;
+		  case 7:  Float2Byte(&Data,DataScope_OutPut_Buffer,25); break;
+		  case 8:  Float2Byte(&Data,DataScope_OutPut_Buffer,29); break;
+		  case 9:  Float2Byte(&Data,DataScope_OutPut_Buffer,33); break;
+		  case 10: Float2Byte(&Data,DataScope_OutPut_Buffer,37); break;
+		}
+  }	 
+}
+
+
+//函数说明：生成 DataScopeV1.0 能正确识别的帧格式
+//Channel_Number，需要发送的通道个数
+//返回发送缓冲区数据个数
+//返回0表示帧格式生成失败 
+unsigned char DataScope_Data_Generate(unsigned char Channel_Number)
+{
+	if ( (Channel_Number > 10) || (Channel_Number == 0) ) { return 0; }  //通道个数大于10或等于0，直接跳出，不执行函数
+  else
+  {	
+	 DataScope_OutPut_Buffer[0] = '$';  //帧头
+		
+	 switch(Channel_Number)   
+   { 
+		 case 1:   DataScope_OutPut_Buffer[5]  =  5; return  6;  
+		 case 2:   DataScope_OutPut_Buffer[9]  =  9; return 10;
+		 case 3:   DataScope_OutPut_Buffer[13] = 13; return 14; 
+		 case 4:   DataScope_OutPut_Buffer[17] = 17; return 18;
+		 case 5:   DataScope_OutPut_Buffer[21] = 21; return 22;  
+		 case 6:   DataScope_OutPut_Buffer[25] = 25; return 26;
+		 case 7:   DataScope_OutPut_Buffer[29] = 29; return 30; 
+		 case 8:   DataScope_OutPut_Buffer[33] = 33; return 34; 
+		 case 9:   DataScope_OutPut_Buffer[37] = 37; return 38;
+     case 10:  DataScope_OutPut_Buffer[41] = 41; return 42; 
+   }	 
+  }
+	return 0;
+}
+
+
+
+
+
+
+
+
+
+
+
diff --git a/HARDWARE/DataScope_DP.h b/HARDWARE/DataScope_DP.h
new file mode 100644
index 0000000..12edeee
--- /dev/null
+++ b/HARDWARE/DataScope_DP.h
@@ -0,0 +1,16 @@
+#ifndef __DATA_PRTOCOL_H
+#define __DATA_PRTOCOL_H
+#include "system.h"
+ 
+extern unsigned char DataScope_OutPut_Buffer[42];	   //待发送帧数据缓存区
+
+
+void DataScope_Get_Channel_Data(float Data,unsigned char Channel);    // 写通道数据至 待发送帧数据缓存区
+
+unsigned char DataScope_Data_Generate(unsigned char Channel_Number);  // 发送帧数据生成函数 
+ 
+ 
+#endif 
+
+
+
diff --git a/HARDWARE/LED.C b/HARDWARE/LED.C
new file mode 100644
index 0000000..258e4da
--- /dev/null
+++ b/HARDWARE/LED.C
@@ -0,0 +1,81 @@
+#include "led.h"
+
+int Led_Count=500; //LED flicker time control //LED闪烁时间控制
+
+/**************************************************************************
+Function: LED interface initialization
+Input   : none
+Output  : none
+函数功能：LED接口初始化
+入口参数：无 
+返回  值：无
+**************************************************************************/
+void LED_Init(void)
+{
+	GPIO_InitTypeDef  GPIO_InitStructure;
+	
+  RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOA, ENABLE);//使能GPIOB时钟
+  GPIO_InitStructure.GPIO_Pin =  LED_PIN;//LED对应IO口
+  GPIO_InitStructure.GPIO_Mode = GPIO_Mode_OUT;//普通输出模式
+  GPIO_InitStructure.GPIO_OType = GPIO_OType_PP;//推挽输出
+  GPIO_InitStructure.GPIO_Speed = GPIO_Speed_100MHz;//100MHz
+  GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_UP;//上拉
+  GPIO_Init(GPIOA, &GPIO_InitStructure);//初始化GPIO
+	GPIO_SetBits(GPIOA,GPIO_Pin_12);
+}
+/**************************************************************************
+Function: Buzzer interface initialized
+Input   : none
+Output  : none
+函数功能：蜂鸣器接口初始化
+入口参数：无 
+返回  值：无
+**************************************************************************/
+void Buzzer_Init(void)
+{	
+	GPIO_InitTypeDef  GPIO_InitStructure;
+	
+  RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOA, ENABLE);//使能GPIOB时钟
+  GPIO_InitStructure.GPIO_Pin =  Buzzer_PIN;//LED对应IO口
+  GPIO_InitStructure.GPIO_Mode = GPIO_Mode_OUT;//普通输出模式
+  GPIO_InitStructure.GPIO_OType = GPIO_OType_PP;//推挽输出
+  GPIO_InitStructure.GPIO_Speed = GPIO_Speed_100MHz;//100MHz
+  GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_UP;//上拉
+  GPIO_Init(GPIOA, &GPIO_InitStructure);//初始化GPIO
+}
+/**************************************************************************
+Function: LED light flashing task
+Input   : none
+Output  : none
+函数功能：LED灯闪烁任务
+入口参数：无 
+返回  值：无
+**************************************************************************/
+void led_task(void *pvParameters)
+{
+    while(1)
+    {
+			//The status of the LED is reversed. 0 is on and 1 is off
+			//LED状态取反，0是点亮，1是熄灭    
+      LED=~LED;              
+      //The LED flicker task is very simple, requires low frequency accuracy, and uses the relative delay function	
+      //LED闪烁任务非常简单，对频率精度要求低，使用相对延时函数			
+      vTaskDelay(Led_Count); 
+    }
+}  
+
+/**************************************************************************
+Function: The LED flashing
+Input   : none
+Output  : blink time
+函数功能：LED闪烁
+入口参数：闪烁时间
+返 回 值：无
+**************************************************************************/
+void Led_Flash(u16 time)
+{
+	  static int temp;
+	  if(0==time) LED=0;
+	  else		if(++temp==time)	LED=~LED,temp=0;
+}
+
diff --git a/HARDWARE/LED.H b/HARDWARE/LED.H
new file mode 100644
index 0000000..c5fc135
--- /dev/null
+++ b/HARDWARE/LED.H
@@ -0,0 +1,27 @@
+#ifndef __LED_H
+#define __LED_H
+#include "sys.h"
+#include "system.h"
+
+#define LED_TASK_PRIO		3     //Task priority //任务优先级
+#define LED_STK_SIZE 		128   //Task stack size //任务堆栈大小
+
+
+/*--------Buzzer control pin--------*/
+#define Buzzer_PORT GPIOA
+#define Buzzer_PIN GPIO_Pin_8
+#define Buzzer PAout(8)
+/*----------------------------------*/
+
+/*--------LED control pin--------*/
+#define LED_PORT GPIOA
+#define LED_PIN GPIO_Pin_12
+#define LED PAout(12) 
+/*----------------------------------*/
+
+void LED_Init(void);  
+void Buzzer_Init(void); 
+void Led_Flash(u16 time);
+void led_task(void *pvParameters);
+extern int Led_Count;
+#endif
diff --git a/HARDWARE/MPU6050/I2C.c b/HARDWARE/MPU6050/I2C.c
new file mode 100644
index 0000000..93261ff
--- /dev/null
+++ b/HARDWARE/MPU6050/I2C.c
@@ -0,0 +1,352 @@
+#include "I2C.h"
+/**************************************************************************
+Function: IIC pin initialization
+Input   : none
+Output  : none
+函数功能：IIC引脚初始化
+入口参数：无
+返回  值：无
+**************************************************************************/
+void I2C_GPIOInit(void)
+{
+	
+	GPIO_InitTypeDef  GPIO_InitStructure;
+  RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOB, ENABLE);//使能GPIOB时钟
+
+  GPIO_InitStructure.GPIO_Pin = GPIO_Pin_10|GPIO_Pin_11;
+  GPIO_InitStructure.GPIO_Mode = GPIO_Mode_OUT;//普通输出模式
+  GPIO_InitStructure.GPIO_OType = GPIO_OType_PP;//推挽输出
+  GPIO_InitStructure.GPIO_Speed = GPIO_Speed_100MHz;//100MHz
+  GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_UP;//上拉
+  GPIO_Init(GPIOB, &GPIO_InitStructure);//初始化
+
+	IIC_SCL=1;
+	IIC_SDA=1;
+
+}
+
+/**************************************************************************
+Function: Simulate IIC start signal
+Input   : none
+Output  : none
+函数功能：模拟IIC起始信号
+入口参数：无
+返回  值：无
+**************************************************************************/
+void I2C_Start(void)
+{
+	SDA_OUT();     //sda线输出
+	IIC_SDA=1;
+	if(!READ_SDA)return ;	
+	IIC_SCL=1;
+	delay_us(1);
+ 	IIC_SDA=0;//START:when CLK is high,DATA change form high to low 
+	if(READ_SDA)return ;
+	delay_us(1);
+	IIC_SCL=0;//钳住I2C总线，准备发送或接收数据 
+	return ;
+}
+
+/**************************************************************************
+Function: Analog IIC end signal
+Input   : none
+Output  : none
+函数功能：模拟IIC结束信号
+入口参数：无
+返回  值：无
+**************************************************************************/
+void I2C_Stop(void)
+{
+	SDA_OUT();//sda线输出
+	IIC_SCL=0;
+	IIC_SDA=0;//STOP:when CLK is high DATA change form low to high
+ 	delay_us(1);
+	IIC_SCL=1; 
+	IIC_SDA=1;//发送I2C总线结束信号
+	delay_us(1);	
+}
+
+
+
+bool I2C_WaiteForAck(void)
+{
+	u8 ucErrTime=0;
+	SDA_IN();      //SDA设置为输入  
+	IIC_SDA=1;
+	delay_us(1);	   
+	IIC_SCL=1;
+	delay_us(1);	 
+	while(READ_SDA)
+	{
+		ucErrTime++;
+		if(ucErrTime>50)
+		{
+			I2C_Stop();
+			return 0;
+		}
+	  delay_us(1);
+	}
+	IIC_SCL=0;//时钟输出0 	   
+	return 1;
+}
+
+/**************************************************************************
+Function: IIC response
+Input   : none
+Output  : none
+函数功能：IIC应答
+入口参数：无
+返回  值：无
+**************************************************************************/
+void I2C_Ack(void)
+{
+	IIC_SCL=0;
+	SDA_OUT();
+	IIC_SDA=0;
+	delay_us(1);
+	IIC_SCL=1;
+	delay_us(1);
+	IIC_SCL=0;
+}
+
+/**************************************************************************
+Function: IIC don't reply
+Input   : none
+Output  : none
+函数功能：IIC不应答
+入口参数：无
+返回  值：无
+**************************************************************************/ 
+void I2C_NAck(void)
+{
+	IIC_SCL=0;
+	SDA_OUT();
+	IIC_SDA=1;
+	delay_us(1);
+	IIC_SCL=1;
+	delay_us(1);
+	IIC_SCL=0;
+}
+
+
+
+bool I2C_WriteOneBit(uint8_t DevAddr, uint8_t RegAddr, uint8_t BitNum, uint8_t Data)
+{
+    uint8_t Dat;
+    
+    Dat =I2C_ReadOneByte(DevAddr, RegAddr);
+    Dat = (Data != 0) ? (Dat | (1 << BitNum)) : (Dat & ~(1 << BitNum));
+    I2C_WriteOneByte(DevAddr, RegAddr, Dat);
+    
+    return true;
+}
+
+
+
+
+bool I2C_WriteBits(uint8_t DevAddr, uint8_t RegAddr, uint8_t BitStart, uint8_t Length, uint8_t Data)
+{
+
+    uint8_t Dat, Mask;
+    
+	Dat = I2C_ReadOneByte(DevAddr, RegAddr);
+    Mask = (0xFF << (BitStart + 1)) | 0xFF >> ((8 - BitStart) + Length - 1);
+    Data <<= (8 - Length);
+    Data >>= (7 - BitStart);
+    Dat &= Mask;
+    Dat |= Data;
+    I2C_WriteOneByte(DevAddr, RegAddr, Dat);
+    
+    return true;
+}
+
+/**************************************************************************
+Function: IIC sends a bit
+Input   : none
+Output  : none
+函数功能：IIC发送一个位
+入口参数：无
+返回  值：无
+**************************************************************************/
+void I2C_WriteByte(uint8_t Data)
+{
+    u8 t;   
+	SDA_OUT(); 	    
+    IIC_SCL=0;//拉低时钟开始数据传输
+    for(t=0;t<8;t++)
+    {              
+        IIC_SDA=(Data&0x80)>>7;
+        Data<<=1; 	  
+		delay_us(1);   
+		IIC_SCL=1;
+		delay_us(1); 
+		IIC_SCL=0;	
+		delay_us(1);
+    }	 
+}
+
+
+u8 I2C_WriteOneByte(uint8_t DevAddr, uint8_t RegAddr, uint8_t Data)
+{
+	I2C_Start();
+	I2C_WriteByte(DevAddr | I2C_Direction_Transmitter);
+	I2C_WaiteForAck();
+	I2C_WriteByte(RegAddr);
+	I2C_WaiteForAck();
+	I2C_WriteByte(Data);
+	I2C_WaiteForAck();
+	I2C_Stop();
+	return 1;
+}
+
+
+bool I2C_WriteBuff(uint8_t DevAddr, uint8_t RegAddr, uint8_t Num, uint8_t *pBuff)
+{
+	uint8_t i;
+
+	if(0 == Num || NULL == pBuff)
+	{
+		return false;
+	}
+	
+	I2C_Start();
+	I2C_WriteByte(DevAddr | I2C_Direction_Transmitter);
+	I2C_WaiteForAck();
+	I2C_WriteByte(RegAddr);
+	I2C_WaiteForAck();
+	
+	for(i = 0; i < Num; i ++)
+	{
+		I2C_WriteByte(*(pBuff + i));
+		I2C_WaiteForAck();
+	}
+	I2C_Stop();
+
+	return true;
+}
+
+/**************************************************************************
+Function: IIC reads a bit
+Input   : none
+Output  : none
+函数功能：IIC读取一个位
+入口参数：无
+返回  值：无
+**************************************************************************/
+uint8_t I2C_ReadByte(uint8_t Ack)
+{
+	uint8_t i, RecDat = 0;
+
+	SDA_IN();
+	for(i = 0; i < 8; i ++)
+	{
+	//	I2C_SCL_Clr();
+		IIC_SCL=0;
+		delay_us(1);
+//		I2C_SCL_Set();
+				IIC_SCL=1;
+		RecDat <<= 1;
+		if(READ_SDA)
+			RecDat |= 0x01;
+		else
+			RecDat &= ~0x01;
+		delay_us(1);
+	}
+	if(I2C_ACK == Ack)
+		I2C_Ack();
+	else
+		I2C_NAck();
+
+	return RecDat;
+}
+
+
+
+
+uint8_t I2C_ReadOneByte(uint8_t DevAddr, uint8_t RegAddr)
+{
+	uint8_t TempVal = 0;
+	
+	I2C_Start();
+	I2C_WriteByte(DevAddr | I2C_Direction_Transmitter);
+	I2C_WaiteForAck();
+	I2C_WriteByte(RegAddr);
+	I2C_WaiteForAck();
+	I2C_Start();
+	I2C_WriteByte(DevAddr | I2C_Direction_Receiver);
+	I2C_WaiteForAck();
+	TempVal = I2C_ReadByte(I2C_NACK);
+	I2C_Stop();
+	
+	return TempVal;
+}
+
+bool I2C_ReadBuff(uint8_t DevAddr, uint8_t RegAddr, uint8_t Num, uint8_t *pBuff)
+{
+	uint8_t i;
+
+	if(0 == Num || NULL == pBuff)
+	{
+		return false;
+	}
+	
+	I2C_Start();
+	I2C_WriteByte(DevAddr | I2C_Direction_Transmitter);
+	I2C_WaiteForAck();
+	I2C_WriteByte(RegAddr);
+	I2C_WaiteForAck();
+	I2C_Start();
+	I2C_WriteByte(DevAddr | I2C_Direction_Receiver);
+	I2C_WaiteForAck();
+
+	for(i = 0; i < Num; i ++)
+	{
+		if((Num - 1) == i)
+		{
+			*(pBuff + i) = I2C_ReadByte(I2C_NACK);
+		}
+		else
+		{
+			*(pBuff + i) = I2C_ReadByte(I2C_ACK);
+		}
+	}
+
+	I2C_Stop();
+	
+	return true;
+}
+
+
+///**************************************************************************
+//Function: IIC continuous reading data
+//Input   : dev：Target device IIC address；reg:Register address；
+//					length：Number of bytes；*data:The pointer where the read data will be stored
+//Output  : count：Number of bytes read out-1
+//函数功能：IIC连续读数据
+//入口参数：dev：目标设备IIC地址；reg:寄存器地址；length：字节数；
+//					*data:读出的数据将要存放的指针
+//返回  值：count：读出来的字节数量-1
+//**************************************************************************/ 
+//u8 IICreadBytes(u8 dev, u8 reg, u8 length, u8 *data){
+//    u8 count = 0;
+//	
+//	IIC_Start();
+//	IIC_Send_Byte(dev);	   //发送写命令
+//	IIC_Wait_Ack();
+//	IIC_Send_Byte(reg);   //发送地址
+//  IIC_Wait_Ack();	  
+//	IIC_Start();
+//	IIC_Send_Byte(dev+1);  //进入接收模式	
+//	IIC_Wait_Ack();
+//	
+//    for(count=0;countMODER&=~(3<<(11*2));GPIOB->MODER|=0<<11*2;}	//PB5输入模式
+#define SDA_OUT() {GPIOB->MODER&=~(3<<(11*2));GPIOB->MODER|=1<<11*2;} //PB5输出模式
+
+//IO操作函数	 
+#define IIC_SCL    PBout(10) //SCL
+#define IIC_SDA    PBout(11) //SDA	 
+#define READ_SDA   PBin(11)  //输入SDA 
+
+
+#ifndef I2C_Direction_Transmitter
+	#define  I2C_Direction_Transmitter      ((uint8_t)0x00)
+#endif
+
+#ifndef I2C_Direction_Receiver
+	#define  I2C_Direction_Receiver         ((uint8_t)0x01)
+#endif
+
+enum
+{
+	I2C_ACK,
+	I2C_NACK
+};
+
+void I2C_SDAMode(uint8_t Mode);
+void I2C_Start(void);
+void I2C_Stop(void);
+bool I2C_WaiteForAck(void);
+void I2C_Ack(void);
+void I2C_NAck(void);
+bool I2C_WriteOneBit(uint8_t DevAddr, uint8_t RegAddr, uint8_t BitNum, uint8_t Data);
+bool I2C_WriteBits(uint8_t DevAddr, uint8_t RegAddr, uint8_t BitStart, uint8_t Length, uint8_t Data);
+void I2C_WriteByte(uint8_t Data);
+uint8_t I2C_ReadByte(uint8_t Ack);
+u8 I2C_WriteOneByte(uint8_t DevAddr, uint8_t RegAddr, uint8_t Data);
+uint8_t I2C_ReadOneByte(uint8_t DevAddr, uint8_t RegAddr);
+bool I2C_WriteBuff(uint8_t DevAddr, uint8_t RegAddr, uint8_t Num, uint8_t *pBuff);
+bool I2C_ReadBuff(uint8_t DevAddr, uint8_t RegAddr, uint8_t Num, uint8_t *pBuff);
+
+void I2C_GPIOInit(void);
+
+#endif
+
diff --git a/HARDWARE/MPU6050/MPU6050.c b/HARDWARE/MPU6050/MPU6050.c
new file mode 100644
index 0000000..9bb2332
--- /dev/null
+++ b/HARDWARE/MPU6050/MPU6050.c
@@ -0,0 +1,545 @@
+#include "MPU6050.h"
+#include "I2C.h"
+#include "usart.h"
+#define PRINT_ACCEL     (0x01)
+#define PRINT_GYRO      (0x02)
+#define PRINT_QUAT      (0x04)
+#define ACCEL_ON        (0x01)
+#define GYRO_ON         (0x02)
+#define MOTION          (0)
+#define NO_MOTION       (1)
+#define DEFAULT_MPU_HZ  (200)
+#define FLASH_SIZE      (512)
+#define FLASH_MEM_START ((void*)0x1800)
+#define q30  1073741824.0f
+short gyro[3], accel[3], sensors;
+//零点漂移计数
+int Deviation_Count;
+
+short sum_gyro[3];
+short sum_accel[3];
+
+// Gyro static error, raw data
+//陀螺仪静差，原始数据
+short Deviation_gyro[3],Original_gyro[3];  
+short Deviation_accel[3],Original_accel[3]; 
+float q0=1.0f,q1=0.0f,q2=0.0f,q3=0.0f;
+//static signed char gyro_orientation[9] = {-1, 0, 0,
+//                                           0,-1, 0,
+//                                           0, 0, 1};
+
+//static  unsigned short inv_row_2_scale(const signed char *row)
+//{
+//    unsigned short b;
+
+//    if (row[0] > 0)
+//        b = 0;
+//    else if (row[0] < 0)
+//        b = 4;
+//    else if (row[1] > 0)
+//        b = 1;
+//    else if (row[1] < 0)
+//        b = 5;
+//    else if (row[2] > 0)
+//        b = 2;
+//    else if (row[2] < 0)
+//        b = 6;
+//    else
+//        b = 7;      // error
+//    return b;
+//}
+
+void MPU6050_task(void *pvParameters)
+{
+    u32 lastWakeTime = getSysTickCnt();
+    while(1)
+    {	
+			//This task runs at 100Hz
+			//此任务以100Hz的频率运行
+			vTaskDelayUntil(&lastWakeTime, F2T(RATE_100_HZ));	
+		
+			//Read the gyroscope zero before starting
+      //开机前，读取陀螺仪零点			
+		  if(Deviation_Count32768) Temp-=65536;	//数据类型转换
+		Temp=(36.53f+Temp/340)*10;	  //温度放大十倍存放
+	  return (int)Temp;
+}
+
+/**************************************************************************
+Function: Initialize TIM2 as the encoder interface mode
+Input   : LPF: Digital low-pass filtering frequency (Hz)
+Output  : 0: Settings successful, others: Settings failed
+函数功能：设置MPUrobot_select_init.h的数字低通滤波器
+入口参数：lpf:数字低通滤波频率(Hz)
+返回  值：0:设置成功, 其他:设置失败
+**************************************************************************/
+unsigned char MPU6050_Set_LPF(u16 lpf)
+{
+	u8 data=0;
+	if(lpf>=188)data=1;
+	else if(lpf>=98)data=2;
+	else if(lpf>=42)data=3;
+	else if(lpf>=20)data=4;
+	else if(lpf>=10)data=5;
+	else data=6; 
+	return I2C_WriteOneByte(devAddr,MPU6050_RA_CONFIG,data); //Set the digital lowpass filter//设置数字低通滤波器  
+}
+/**************************************************************************
+Function: Initialize TIM2 as the encoder interface mode
+Input   : rate:4~1000(Hz)
+Output  : 0: Settings successful, others: Settings failed
+函数功能：设置MPUrobot_select_init.h的采样率(假定Fs=1KHz)
+入口参数：rate:4~1000(Hz)
+返回  值：0:设置成功, 其他:设置失败
+**************************************************************************/
+unsigned char MPU6050_Set_Rate(u16 rate)
+{
+	u8 data;
+	if(rate>1000)rate=1000;
+	if(rate<4)rate=4;
+	data=1000/rate-1;
+	data=I2C_WriteOneByte(devAddr,MPU6050_RA_SMPLRT_DIV,data);	//Set the digital lowpass filter//设置数字低通滤波器  
+ 	return MPU6050_Set_LPF(rate/2);	//Automatically sets LPF to half of the sampling rate //自动设置LPF为采样率的一半
+}
+
+/**************************************************************************
+Function: Initialize TIM2 as the encoder interface mode
+Input   : Gx, Gy, Gz: raw readings (plus or minus) of the x,y, and z axes of the gyroscope
+Output  : 0: success, others: error code
+函数功能：获得陀螺仪值(原始值)
+**************************************************************************/
+void MPU_Get_Gyroscope(void)
+{
+		gyro[0]=(I2C_ReadOneByte(devAddr,MPU6050_RA_GYRO_XOUT_H)<<8)+I2C_ReadOneByte(devAddr,MPU6050_RA_GYRO_XOUT_L);    //读取X轴陀螺仪
+		gyro[1]=(I2C_ReadOneByte(devAddr,MPU6050_RA_GYRO_YOUT_H)<<8)+I2C_ReadOneByte(devAddr,MPU6050_RA_GYRO_YOUT_L);    //读取Y轴陀螺仪
+		gyro[2]=(I2C_ReadOneByte(devAddr,MPU6050_RA_GYRO_ZOUT_H)<<8)+I2C_ReadOneByte(devAddr,MPU6050_RA_GYRO_ZOUT_L);    //读取Z轴陀螺仪
+	
+	if(Deviation_CountMCR=0x0000;	//Exit sleep mode (setting all bits to 0 at the same time) //退出睡眠模式(同时设置所有位为0)
+	CAN1->MCR|=1<<0;	//Request CAN1 to enter initialization mode //请求CAN1进入初始化模式
+	while((CAN1->MSR&1<<0)==0)
+	{
+		i++;
+		if(i>100)return 2; //Failed to enter initialization mode //进入初始化模式失败
+	}
+	//Non-time triggered communication mode
+	//非时间触发通信模式
+	CAN1->MCR|=0<<7;
+  //Software automatic offline management	
+	//软件自动离线管理
+	CAN1->MCR|=0<<6;	
+	//Sleep mode is awakened by software (clear CAN1- >;
+  //睡眠模式通过软件唤醒(清除CAN1->MCR的SLEEP位)	
+	CAN1->MCR|=0<<5;
+	//Disallow automatic message transmission
+  //禁止报文自动传送	
+	CAN1->MCR|=1<<4;
+	//Messages are not locked, the new overwrites the old
+  //报文不锁定,新的覆盖旧的	
+	CAN1->MCR|=0<<3;
+	//The priority is determined by the message identifier	
+  //优先级由报文标识符决定  
+	CAN1->MCR|=0<<2;
+  //Clear the original Settings	
+  //清除原来的设置	
+	CAN1->BTR=0x00000000; 
+	//Mode set to 0, normal mode;1. Loop mode;
+	//模式设置 0,普通模式;1,回环模式;
+	CAN1->BTR|=mode<<30;
+  //Resynchronization jump width (TSJW) is TSJW +1 time unit	
+	//重新同步跳跃宽度(Tsjw)为tsjw+1个时间单位
+	CAN1->BTR|=tsjw<<24; 
+  //Tbs2= Tbs2 +1 time unit	
+	//Tbs2=tbs2+1个时间单位
+	CAN1->BTR|=tbs2<<20; 
+	//Tbs1= Tbs1 +1 time unit	
+  //Tbs1=tbs1+1个时间单位	
+	CAN1->BTR|=tbs1<<16;
+	//Frequency division coefficient (Fdiv) is brp +1, boulder rate: Fpclk1/((Tbs1+Tbs2+1)*Fdiv)
+  //分频系数(Fdiv)为brp+1，波特率:Fpclk1/((Tbs1+Tbs2+1)*Fdiv)
+	CAN1->BTR|=brp<<0;  
+  //Request CAN1 to exit initialization mode	
+  //请求CAN1退出初始化模式			
+	CAN1->MCR&=~(1<<0);	  
+	while((CAN1->MSR&1<<0)==1)
+	{
+		i++;
+		if(i>0XFFF0)return 3; //Failed to exit initialization mode //退出初始化模式失败
+	}
+	/*** Filter initialization || 过滤器初始化 ***/
+	//Filter groups work in initialization mode
+	//过滤器组工作在初始化模式
+	CAN1->FMR|=1<<0;	
+	//Filter 0 is not active
+  //过滤器0不激活	
+	CAN1->FA1R&=~(1<<0);	
+	//The filter bit width is 32 bits
+  //过滤器位宽为32位	
+	CAN1->FS1R|=1<<0; 
+	//Filter 0 works in identifier masking bit mode
+  //过滤器0工作在标识符屏蔽位模式	
+	CAN1->FM1R|=0<<0;	
+	//Filter 0 is associated with FIFO0
+  //过滤器0关联到FIFO0	
+	CAN1->FFA1R|=0<<0;	
+  //32 bit ID	
+	//32位ID
+	CAN1->sFilterRegister[0].FR1=0X00000000;
+	//32-bit MASK
+	//32位MASK
+	CAN1->sFilterRegister[0].FR2=0X00000000;
+	//Activation filter 0
+	//激活过滤器0
+	CAN1->FA1R|=1<<0;	
+	//Filter group enters normal mode
+  //过滤器组进入正常模式	
+	CAN1->FMR&=0<<0;			
+
+#if CAN1_RX0_INT_ENABLE
+  //Enable to interrupt reception //使能中断接收
+	
+	//FIFO0消息挂号中断允许
+	CAN1->IER|=1<<1;			
+	
+	//Configure CAN to receive interrupts
+	//配置CAN接收中断
+  NVIC_InitStructure.NVIC_IRQChannel = CAN1_RX0_IRQn;
+  //Preemption priority	
+	//抢占优先级
+	NVIC_InitStructure.NVIC_IRQChannelPreemptionPriority=1 ;
+	//Son priority
+	//子优先级
+	NVIC_InitStructure.NVIC_IRQChannelSubPriority = 3;
+  //IRQ channel enablement
+	//IRQ通道使能	
+	NVIC_InitStructure.NVIC_IRQChannelCmd = ENABLE;	
+  //Initializes the VIC register according to the specified parameters 
+	//根据指定的参数初始化VIC寄存器	
+	NVIC_Init(&NVIC_InitStructure);	
+
+  CAN_ITConfig(CAN1, CAN_IT_FMP0, ENABLE);
+	
+#endif
+	return 0;
+}   
+/**************************************************************************
+Function: CAN sends data
+Input   : id:Standard ID(11 bits)/ Extended ID(11 bits +18 bits)
+			    ide:0, standard frame;1, extension frames
+			    rtr:0, data frame;1, remote frame
+			    len:Length of data to be sent (fixed at 8 bytes, valid data is 6 bytes in time-triggered mode) 
+			    *dat:Pointer to the data
+Output  : 0~3, mailbox number. 0xFF, no valid mailbox
+函数功能：CAN发送数据
+入口参数：id:标准ID(11位)/扩展ID(11位+18位)	    
+			    ide:0,标准帧;1,扩展帧
+			    rtr:0,数据帧;1,远程帧
+			    len:要发送的数据长度(固定为8个字节,在时间触发模式下,有效数据为6个字节)
+			    *dat:数据指针.
+返回  值：0~3,邮箱编号.0XFF,无有效邮箱
+**************************************************************************/
+u8 CAN1_Tx_Msg(u32 id,u8 ide,u8 rtr,u8 len,u8 *dat)
+{	   
+	u8 mbox;	  
+	if(CAN1->TSR&(1<<26))mbox=0;		  //Mailbox 0 is empty //邮箱0为空
+	else if(CAN1->TSR&(1<<27))mbox=1;	//Mailbox 1 is empty //邮箱1为空
+	else if(CAN1->TSR&(1<<28))mbox=2;	//Mailbox 2 is empty //邮箱2为空
+	else return 0XFF;					        //No empty mailbox, cannot send //无空邮箱,无法发送 
+	
+	CAN1->sTxMailBox[mbox].TIR=0; //Clear the previous Settings //清除之前的设置		
+	if(ide==0) //The standard frame //标准帧
+	{
+		id&=0x7ff; //Take the low 11 bit STDID //取低11位stdid
+		id<<=21;		  
+	}else	//Extend the frame //扩展帧
+	{
+		id&=0X1FFFFFFF; //Take a low 32-bit extid //取低32位extid
+		id<<=3;									   
+	}
+	CAN1->sTxMailBox[mbox].TIR|=id;		 
+	CAN1->sTxMailBox[mbox].TIR|=ide<<2;	  
+	CAN1->sTxMailBox[mbox].TIR|=rtr<<1;
+	len&=0X0F; //Get lower 4 bits //得到低四位
+	CAN1->sTxMailBox[mbox].TDTR&=~(0X0000000F);
+	CAN1->sTxMailBox[mbox].TDTR|=len;	//Set the DLC	//设置DLC
+	//The data to be sent is stored in the mailbox
+	//待发送数据存入邮箱
+	CAN1->sTxMailBox[mbox].TDHR=(((u32)dat[7]<<24)|
+								((u32)dat[6]<<16)|
+ 								((u32)dat[5]<<8)|
+								((u32)dat[4]));
+	CAN1->sTxMailBox[mbox].TDLR=(((u32)dat[3]<<24)|
+								((u32)dat[2]<<16)|
+ 								((u32)dat[1]<<8)|
+								((u32)dat[0]));
+	CAN1->sTxMailBox[mbox].TIR|=1<<0; //Request to send mailbox data//请求发送邮箱数据
+	return mbox;
+}
+/**************************************************************************
+Function: Get the send status
+Input   : Mbox: mailbox number
+Output  : 0, hang;0X05, send failed;0X07, successful transmission
+函数功能：获得发送状态
+入口参数：mbox：邮箱编号
+返回  值：0,挂起;0X05,发送失败;0X07,发送成功
+**************************************************************************/
+u8 CAN1_Tx_Staus(u8 mbox)
+{	
+	u8 sta=0;					    
+	switch (mbox)
+	{
+		case 0: 
+			sta |= CAN1->TSR&(1<<0);			   //RQCP0
+			sta |= CAN1->TSR&(1<<1);			   //TXOK0
+			sta |=((CAN1->TSR&(1<<26))>>24); //TME0
+			break;
+		case 1: 
+			sta |= CAN1->TSR&(1<<8)>>8;		   //RQCP1
+			sta |= CAN1->TSR&(1<<9)>>8;		   //TXOK1
+			sta |=((CAN1->TSR&(1<<27))>>25); //TME1	   
+			break;
+		case 2: 
+			sta |= CAN1->TSR&(1<<16)>>16;	   //RQCP2
+			sta |= CAN1->TSR&(1<<17)>>16;	   //TXOK2
+			sta |=((CAN1->TSR&(1<<28))>>26); //TME2
+			break;
+		default:
+			sta=0X05; //Wrong email number, failed //邮箱号不对,失败
+		break;
+	}
+	return sta;
+} 
+/**************************************************************************
+Function: Returns the number of packets received in FIFO0/FIFO1
+Input   : Fifox: FIFO number (0, 1)
+Output  : Number of packets in FIFO0/FIFO1
+函数功能：得到在FIFO0/FIFO1中接收到的报文个数
+入口参数：fifox：FIFO编号（0、1）
+返回  值：FIFO0/FIFO1中的报文个数
+**************************************************************************/
+u8 CAN1_Msg_Pend(u8 fifox)
+{
+	if(fifox==0)return CAN1->RF0R&0x03; 
+	else if(fifox==1)return CAN1->RF1R&0x03; 
+	else return 0;
+}
+/**************************************************************************
+Function: Receive data
+Input   : fifox：Email
+		    	id:Standard ID(11 bits)/ Extended ID(11 bits +18 bits)
+			    ide:0, standard frame;1, extension frames 
+			    rtr:0, data frame;1, remote frame
+			    len:Length of data received (fixed at 8 bytes, valid at 6 bytes in time-triggered mode)
+			    dat:Data cache
+Output  : none
+函数功能：接收数据
+入口参数：fifox：邮箱号
+		    	id:标准ID(11位)/扩展ID(11位+18位)
+			    ide:0,标准帧;1,扩展帧
+			    rtr:0,数据帧;1,远程帧
+			    len:接收到的数据长度(固定为8个字节,在时间触发模式下,有效数据为6个字节)
+			    dat:数据缓存区
+返回  值：无 
+**************************************************************************/
+void CAN1_Rx_Msg(u8 fifox,u32 *id,u8 *ide,u8 *rtr,u8 *len,u8 *dat)
+{	   
+	*ide=CAN1->sFIFOMailBox[fifox].RIR&0x04; //Gets the value of the identifier selection bit //得到标识符选择位的值  
+ 	if(*ide==0) //Standard identifier //标准标识符
+	{
+		*id=CAN1->sFIFOMailBox[fifox].RIR>>21;
+	}else	     //Extended identifier //扩展标识符
+	{
+		*id=CAN1->sFIFOMailBox[fifox].RIR>>3;
+	}
+	*rtr=CAN1->sFIFOMailBox[fifox].RIR&0x02;	//Gets the remote send request value //得到远程发送请求值
+	*len=CAN1->sFIFOMailBox[fifox].RDTR&0x0F; //Get the DLC //得到DLC
+ 	//*fmi=(CAN1->sFIFOMailBox[FIFONumber].RDTR>>8)&0xFF; //Get the FMI //得到FMI
+	//Receive data //接收数据
+	dat[0]=CAN1->sFIFOMailBox[fifox].RDLR&0XFF;
+	dat[1]=(CAN1->sFIFOMailBox[fifox].RDLR>>8)&0XFF;
+	dat[2]=(CAN1->sFIFOMailBox[fifox].RDLR>>16)&0XFF;
+	dat[3]=(CAN1->sFIFOMailBox[fifox].RDLR>>24)&0XFF;    
+	dat[4]=CAN1->sFIFOMailBox[fifox].RDHR&0XFF;
+	dat[5]=(CAN1->sFIFOMailBox[fifox].RDHR>>8)&0XFF;
+	dat[6]=(CAN1->sFIFOMailBox[fifox].RDHR>>16)&0XFF;
+	dat[7]=(CAN1->sFIFOMailBox[fifox].RDHR>>24)&0XFF;    
+  if(fifox==0)CAN1->RF0R|=0X20;      //Free the FIFO0 mailbox //释放FIFO0邮箱
+	else if(fifox==1)CAN1->RF1R|=0X20; //Free the FIFO1 mailbox //释放FIFO1邮箱	 
+}
+/**************************************************************************
+Function: CAN receives interrupt service function, conditional compilation
+Input   : none
+Output  : none
+函数功能：CAN接收中断服务函数，条件编译
+入口参数：无
+返回  值：无 
+**************************************************************************/
+#if CAN1_RX0_INT_ENABLE	//Enable RX0 interrupt //使能RX0中断	    
+void CAN1_RX0_IRQHandler(void)
+{
+	u32 id;
+	u8 ide,rtr,len;     
+
+	u8 temp_rxbuf[8];
+
+ 	CAN1_Rx_Msg(0,&id,&ide,&rtr,&len,temp_rxbuf);
+	if(id==0x181)
+	{
+		float Vz;
+		CAN_ON_Flag=1, PS2_ON_Flag=0,Remote_ON_Flag=0,APP_ON_Flag=0,Usart1_ON_Flag=0,Usart5_ON_Flag=0;
+    command_lost_count=0; //CAN/串口控制命令丢失计数清零
+
+		//Calculate the three-axis target velocity, unit: m/s
+		//计算三轴目标速度，单位：m/s
+		Move_X=((float)((short)((temp_rxbuf[0]<<8)+(temp_rxbuf[1]))))/1000; 
+		Move_Y=((float)((short)((temp_rxbuf[2]<<8)+(temp_rxbuf[3]))))/1000;
+		Vz    =((float)((short)((temp_rxbuf[4]<<8)+(temp_rxbuf[5]))))/1000;
+		if(Car_Mode==Akm_Car)
+		{
+			Move_Z=Vz_to_Akm_Angle(Move_X, Vz);
+		}
+		else
+		{
+			Move_Z=((float)((short)((temp_rxbuf[4]<<8)+(temp_rxbuf[5]))))/1000;
+		}
+	}
+}
+#endif
+
+/**************************************************************************
+Function: CAN1 sends a set of data (fixed format :ID 0X601, standard frame, data frame)
+Input   : msg:Pointer to the data
+    			len:Data length (up to 8)
+Output  : 0, success, others, failure;
+函数功能：CAN1发送一组数据(固定格式:ID为0X601,标准帧,数据帧)
+入口参数：msg:数据指针
+    			len:数据长度(最大为8)
+返回  值：0,成功，其他,失败;
+**************************************************************************/
+u8 CAN1_Send_Msg(u8* msg,u8 len)
+{	
+	u8 mbox;
+	u16 i=0;	  	 						       
+  mbox=CAN1_Tx_Msg(0X601,0,0,len,msg);   
+	while((CAN1_Tx_Staus(mbox)!=0X07)&&(i<0XFFF))i++; //Waiting for the end of sending //等待发送结束
+	if(i>=0XFFF)return 1; //Send failure //发送失败
+	return 0;	//Send a success //发送成功									
+}
+/**************************************************************************
+Function: The CAN1 port receives data queries
+Input   : Buf: The data cache
+Output  : 0, number of data received, other, length of data received
+函数功能：CAN1口接收数据查询
+入口参数：buf:数据缓存区
+返回  值：0,无数据被收到，其他,接收的数据长度
+**************************************************************************/
+u8 CAN1_Receive_Msg(u8 *buf)
+{		   		   
+	u32 id;
+	u8 ide,rtr,len; 
+	if(CAN1_Msg_Pend(0)==0)return 0;			   //No data received, exit directly //没有接收到数据,直接退出 	 
+  	CAN1_Rx_Msg(0,&id,&ide,&rtr,&len,buf); //Read the data //读取数据
+    if(id!=0x12||ide!=0||rtr!=0)len=0;		 //Receive error //接收错误	   
+	return len;	
+}
+/**************************************************************************
+Function: Can1 sends a set of data tests
+Input   : msg:Pointer to the data
+			    len:Data length (up to 8)
+Output  : 0, success, 1, failure
+函数功能：CAN1发送一组数据测试
+入口参数：msg:数据指针
+			    len:数据长度(最大为8)
+返回  值：0,成功，1,失败
+**************************************************************************/
+u8 CAN1_Send_MsgTEST(u8* msg,u8 len)
+{	
+	u8 mbox;
+	u16 i=0;	  	 						       
+    mbox=CAN1_Tx_Msg(0X701,0,0,len,msg);   
+	while((CAN1_Tx_Staus(mbox)!=0X07)&&(i<0XFFF))i++; //Waiting for the end of sending //等待发送结束
+	if(i>=0XFFF)return 1;	//Send failure //发送失败
+	return 0;	//Send a success //发送成功
+}
+/**************************************************************************
+Function: Sends an array to the given ID
+Input   : id：ID no.
+			    msg：The transmitted data pointer
+Output  : 0, success, 1, failure
+函数功能：给给定的id发送一个数组的命令
+入口参数：id：ID号
+			    msg：被输送数据指针
+返回  值：0,成功，1,失败
+**************************************************************************/
+u8 CAN1_Send_Num(u32 id,u8* msg)
+{
+	u8 mbox;
+	u16 i=0;	  	 						       
+  mbox=CAN1_Tx_Msg(id,0,0,8,msg);   
+	while((CAN1_Tx_Staus(mbox)!=0X07)&&(i<0XFFF))i++; //Waiting for the end of sending //等待发送结束
+	if(i>=0XFFF)return 1;	//Send failure //发送失败
+	return 0;
+}
diff --git a/HARDWARE/can.h b/HARDWARE/can.h
new file mode 100644
index 0000000..a013d27
--- /dev/null
+++ b/HARDWARE/can.h
@@ -0,0 +1,40 @@
+#ifndef __CAN_H
+#define __CAN_H	 
+#include "sys.h"	    
+#include "system.h"
+ 
+//CAN1 receives RX0 interrupt enablement
+//CAN1接收RX0中断使能
+#define CAN1_RX0_INT_ENABLE	1	//0, not enabling;1, can make //0,不使能; 1,使能								    		
+
+u8 CAN1_Mode_Init(u8 tsjw,u8 tbs2,u8 tbs1,u16 brp,u8 mode);
+u8 CAN1_Tx_Msg(u32 id,u8 ide,u8 rtr,u8 len,u8 *dat);		
+u8 CAN1_Msg_Pend(u8 fifox);							
+void CAN1_Rx_Msg(u8 fifox,u32 *id,u8 *ide,u8 *rtr,u8 *len,u8 *dat);
+u8 CAN1_Tx_Staus(u8 mbox);  								
+u8 CAN1_Send_Msg(u8* msg,u8 len);						
+u8 CAN1_Receive_Msg(u8 *buf);						
+
+u8 CAN1_Send_MsgTEST(u8* msg,u8 len);
+u8 CAN1_Send_Num(u32 id,u8* msg);
+
+void can_data_transition(void);
+
+#endif
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/HARDWARE/dma.c b/HARDWARE/dma.c
new file mode 100644
index 0000000..16cdcbf
--- /dev/null
+++ b/HARDWARE/dma.c
@@ -0,0 +1,78 @@
+#include "dma.h"
+#include "sys.h"
+
+DMA_InitTypeDef DMA_InitStructure;
+u16 DMA1_MEM_LEN2;//保存DMA每次数据传送的长度
+
+/**************************************************************************
+函数功能：串口2DMA初始化
+入口参数：DMA通道，数据的目标地址，数据的起始地址，发送的数据数量
+返回  值：无
+**************************************************************************/
+void MYDMA_Init2(DMA_Channel_TypeDef* DMA_CHx,u32 cpar,u32 cmar,u16 cndtr)
+{
+ 	RCC_AHBPeriphClockCmd(RCC_AHBPeriph_DMA1, ENABLE);	//使能DMA传输
+	
+  DMA_DeInit(DMA_CHx);	//将DMA的通道1寄存器重设为缺省值
+	DMA1_MEM_LEN2=cndtr;		//数据传输量 
+	DMA_InitStructure.DMA_PeripheralBaseAddr = cpar;  //DMA外设ADC基地址
+	DMA_InitStructure.DMA_MemoryBaseAddr = cmar;  //DMA内存基地址
+	DMA_InitStructure.DMA_DIR = DMA_DIR_PeripheralDST;  //数据传输方向，从内存读取发送到外设
+	DMA_InitStructure.DMA_BufferSize = cndtr;  //DMA通道的DMA缓存的大小
+	DMA_InitStructure.DMA_PeripheralInc = DMA_PeripheralInc_Disable;  //外设地址寄存器不变
+	DMA_InitStructure.DMA_MemoryInc = DMA_MemoryInc_Enable;  //内存地址寄存器递增
+	DMA_InitStructure.DMA_PeripheralDataSize = DMA_PeripheralDataSize_Byte;  //数据宽度为8位
+	DMA_InitStructure.DMA_MemoryDataSize = DMA_MemoryDataSize_Byte; //数据宽度为8位
+	DMA_InitStructure.DMA_Mode = DMA_Mode_Normal;  //工作在正常缓存模式
+	DMA_InitStructure.DMA_Priority = DMA_Priority_High; //DMA通道 x拥有高优先级 
+	DMA_InitStructure.DMA_M2M = DMA_M2M_Disable;  //DMA通道x没有设置为内存到内存传输
+	DMA_Init(DMA_CHx, &DMA_InitStructure);  //根据DMA_InitStruct中指定的参数初始化DMA的通道USART1_Tx_DMA_Channel所标识的寄存器 	
+} 
+/**************************************************************************
+函数功能：开启一次DMA传输
+入口参数：DMA通道，数据的目标地址，数据的起始地址，发送的数据数量
+返回  值：无
+**************************************************************************/
+void MYDMA_Enable2(DMA_Channel_TypeDef*DMA_CHx)
+{ 
+	DMA_Cmd(DMA_CHx, DISABLE );  //关闭USART1 TX DMA1 所指示的通道      
+ 	DMA_SetCurrDataCounter(DMA1_Channel7,DMA1_MEM_LEN2);//DMA通道的DMA缓存的大小
+ 	DMA_Cmd(DMA_CHx, ENABLE);  //使能USART1 TX DMA1 所指示的通道 
+}	  
+
+///**************************************************************************
+//函数功能：DMA方式的printf
+//入口参数：要打印的内容
+//返回  值：无
+//**************************************************************************/
+void DMA_printf(const char *format,...)
+{
+	u32 length;
+	va_list args;
+	
+	va_start(args, format);
+	length = vsnprintf((char*)t2xbuf, sizeof(t2xbuf), (char*)format, args);
+    va_end(args);
+	USART_SendBuffer((const char*)t2xbuf,length);
+}
+
+u32 USART_SendBuffer(const char* buffer, u32 length)
+{
+	if( (buffer==NULL) || (length==0) )
+	{
+		return 0;
+	}
+ 
+	DMA_Cmd(DMA1_Channel7, DISABLE); //失能DMA通道
+	DMA_SetCurrDataCounter(DMA1_Channel7, length);
+	DMA_Cmd(DMA1_Channel7, ENABLE); //使能DMA通道
+	while(1)
+	{
+		if(DMA_GetITStatus(DMA1_IT_TC7)!=RESET)	//判断通道7（uart2_tx）传输完成
+		{
+			DMA_ClearFlag(DMA1_IT_TC7);//清除通道7传输完成标志
+			break;
+		}
+	}
+	return length;
+}
diff --git a/HARDWARE/dma.h b/HARDWARE/dma.h
new file mode 100644
index 0000000..2cb90c4
--- /dev/null
+++ b/HARDWARE/dma.h
@@ -0,0 +1,21 @@
+/**************************************************************************
+作者：平衡小车之家
+我的淘宝小店：http://shop114407458.taobao.com/
+**************************************************************************/
+#ifndef __DMA_H
+#define __DMA_H
+
+#include "stm32f10x_dma.h"
+#include "sys.h"
+#include "system.h"
+
+void MYDMA_Init2(DMA_Channel_TypeDef*DMA_CHx,u32 cpar,u32 cmar,u16 cndtr);
+void MYDMA_Enable2(DMA_Channel_TypeDef*DMA_CHx);
+
+void DMA_printf(const char *format,...);
+u32 USART_SendBuffer(const char* buffer, u32 length);
+
+#endif
+
+
+
diff --git a/HARDWARE/encoder.c b/HARDWARE/encoder.c
new file mode 100644
index 0000000..3f04072
--- /dev/null
+++ b/HARDWARE/encoder.c
@@ -0,0 +1,279 @@
+#include "encoder.h"
+
+/**************************************************************************
+Function: Initialize TIM2 as the encoder interface mode
+Input   : none
+Output  : none
+函数功能：把TIM2初始化为编码器接口模式
+入口参数：无
+返 回 值：无
+**************************************************************************/
+void Encoder_Init_TIM2(void)
+{
+	TIM_TimeBaseInitTypeDef TIM_TimeBaseStructure;  
+  TIM_ICInitTypeDef TIM_ICInitStructure;  
+  GPIO_InitTypeDef GPIO_InitStructure;
+	
+  RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM2, ENABLE);   //使能定时器
+  RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOA|RCC_AHB1Periph_GPIOB, ENABLE);  //使用A B口
+ 
+  GPIO_InitStructure.GPIO_Pin = GPIO_Pin_15;  //PA15
+  GPIO_InitStructure.GPIO_Speed = GPIO_Speed_100MHz;
+  GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF;
+  GPIO_InitStructure.GPIO_OType = GPIO_OType_OD;
+  GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_UP;
+  GPIO_Init(GPIOA, &GPIO_InitStructure);  
+	
+	GPIO_InitStructure.GPIO_Pin = GPIO_Pin_3;  //PB3
+  GPIO_InitStructure.GPIO_Speed = GPIO_Speed_100MHz;
+  GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF;
+  GPIO_InitStructure.GPIO_OType = GPIO_OType_OD;
+  GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_UP;
+  GPIO_Init(GPIOB, &GPIO_InitStructure);  
+
+  GPIO_PinAFConfig(GPIOA,GPIO_PinSource15,GPIO_AF_TIM2);   //复用为TIM2 编码器接口
+  GPIO_PinAFConfig(GPIOB,GPIO_PinSource3,GPIO_AF_TIM2);   //复用为TIM2 编码器接口
+  
+  TIM_TimeBaseStructInit(&TIM_TimeBaseStructure);
+  
+  TIM_TimeBaseStructure.TIM_Prescaler = 0x0; 							// No prescaling     //不分频
+  TIM_TimeBaseStructure.TIM_Period = ENCODER_TIM_PERIOD;  //设定计数器自动重装值
+  TIM_TimeBaseStructure.TIM_ClockDivision = TIM_CKD_DIV1; //选择时钟分频：不分频
+  TIM_TimeBaseStructure.TIM_CounterMode = TIM_CounterMode_Up; //TIM向上计数    
+  TIM_TimeBaseInit(TIM2, &TIM_TimeBaseStructure);  //初始化定时器
+  
+  TIM_EncoderInterfaceConfig(TIM2, TIM_EncoderMode_TI12, TIM_ICPolarity_Rising, TIM_ICPolarity_Rising);//使用编码器模式3
+  TIM_ICStructInit(&TIM_ICInitStructure);
+  TIM_ICInitStructure.TIM_ICFilter = 0;
+  TIM_ICInit(TIM2, &TIM_ICInitStructure);
+  
+  TIM_ClearFlag(TIM2, TIM_FLAG_Update);//清除TIM的更新标志位
+  TIM_ITConfig(TIM2, TIM_IT_Update, ENABLE);
+  TIM_SetCounter(TIM2,0);
+  TIM_Cmd(TIM2, ENABLE); 
+}
+
+/**************************************************************************
+Function: Initialize TIM3 as the encoder interface mode
+Input   : none
+Output  : none
+函数功能：把TIM3初始化为编码器接口模式
+入口参数：无
+返回  值：无
+**************************************************************************/
+void Encoder_Init_TIM3(void)
+{
+	TIM_TimeBaseInitTypeDef TIM_TimeBaseStructure;  
+  TIM_ICInitTypeDef TIM_ICInitStructure;  
+  GPIO_InitTypeDef GPIO_InitStructure;
+	
+  RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM3, ENABLE);   //使能定时器
+  RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOB, ENABLE);  //使用A口
+
+  GPIO_InitStructure.GPIO_Pin = GPIO_Pin_4 | GPIO_Pin_5;  //PB4 PB5
+  GPIO_InitStructure.GPIO_Speed = GPIO_Speed_100MHz;
+  GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF;
+  GPIO_InitStructure.GPIO_OType = GPIO_OType_OD;
+  GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_UP;
+  GPIO_Init(GPIOB, &GPIO_InitStructure);  
+
+  GPIO_PinAFConfig(GPIOB,GPIO_PinSource4,GPIO_AF_TIM3);   //复用为TIM2 编码器接口
+  GPIO_PinAFConfig(GPIOB,GPIO_PinSource5,GPIO_AF_TIM3);   //复用为TIM2 编码器接口
+  
+  TIM_TimeBaseStructInit(&TIM_TimeBaseStructure);  
+  TIM_TimeBaseStructure.TIM_Prescaler = 0x0; 							// No prescaling     //不分频
+  TIM_TimeBaseStructure.TIM_Period = ENCODER_TIM_PERIOD;  //设定计数器自动重装值
+  TIM_TimeBaseStructure.TIM_ClockDivision = TIM_CKD_DIV1; //选择时钟分频：不分频
+  TIM_TimeBaseStructure.TIM_CounterMode = TIM_CounterMode_Up; //TIM向上计数    
+  TIM_TimeBaseInit(TIM3, &TIM_TimeBaseStructure);  //初始化定时器
+  
+  TIM_EncoderInterfaceConfig(TIM3, TIM_EncoderMode_TI12, TIM_ICPolarity_Rising, TIM_ICPolarity_Rising);//使用编码器模式3
+  TIM_ICStructInit(&TIM_ICInitStructure);
+  TIM_ICInitStructure.TIM_ICFilter = 0;
+  TIM_ICInit(TIM3, &TIM_ICInitStructure);  
+	
+  TIM_ClearFlag(TIM3, TIM_FLAG_Update);//清除TIM的更新标志位
+  TIM_ITConfig(TIM3, TIM_IT_Update, ENABLE);
+	TIM_SetCounter(TIM3,0);
+  TIM_Cmd(TIM3, ENABLE); 
+}
+/**************************************************************************
+Function: Initialize TIM4 as the encoder interface mode
+Input   : none
+Output  : none
+函数功能：把TIM4初始化为编码器接口模式
+入口参数：无
+返 回 值：无
+**************************************************************************/
+void Encoder_Init_TIM4(void)
+{
+	TIM_TimeBaseInitTypeDef TIM_TimeBaseStructure;  
+  TIM_ICInitTypeDef TIM_ICInitStructure;  
+  GPIO_InitTypeDef GPIO_InitStructure;
+  RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM4, ENABLE);//使能定时器4的时钟
+  RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOB, ENABLE);//使能PB端口时钟
+  GPIO_InitStructure.GPIO_Pin = GPIO_Pin_6 | GPIO_Pin_7;//端口配置
+  GPIO_InitStructure.GPIO_Speed = GPIO_Speed_100MHz;
+  GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF;
+  GPIO_InitStructure.GPIO_OType = GPIO_OType_OD;
+  GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_UP;
+  GPIO_Init(GPIOB, &GPIO_InitStructure);   //根据设定参数初始化GPIOB
+
+  GPIO_PinAFConfig(GPIOB,GPIO_PinSource6,GPIO_AF_TIM4); //复用为TIM4 编码器接口
+  GPIO_PinAFConfig(GPIOB,GPIO_PinSource7,GPIO_AF_TIM4); //复用为TIM4 编码器接口
+  
+  TIM_TimeBaseStructInit(&TIM_TimeBaseStructure);
+  
+  TIM_TimeBaseStructure.TIM_Prescaler = 0x0; // No prescaling 
+  TIM_TimeBaseStructure.TIM_Period = ENCODER_TIM_PERIOD; //设定计数器自动重装值
+  TIM_TimeBaseStructure.TIM_ClockDivision = TIM_CKD_DIV1;//选择时钟分频：不分频
+  TIM_TimeBaseStructure.TIM_CounterMode = TIM_CounterMode_Up;   //TIM向上计数  
+  TIM_TimeBaseInit(TIM4, &TIM_TimeBaseStructure);
+  
+  TIM_EncoderInterfaceConfig(TIM4, TIM_EncoderMode_TI12, TIM_ICPolarity_Rising, TIM_ICPolarity_Rising);//使用编码器模式3
+  TIM_ICStructInit(&TIM_ICInitStructure);
+  TIM_ICInitStructure.TIM_ICFilter = 0;
+  TIM_ICInit(TIM4, &TIM_ICInitStructure);
+  
+  TIM_ClearFlag(TIM4, TIM_FLAG_Update);
+  TIM_ITConfig(TIM4, TIM_IT_Update, ENABLE);
+	TIM_SetCounter(TIM4,0);
+  TIM_Cmd(TIM4, ENABLE); 
+}
+/**************************************************************************
+Function: Initialize TIM5 as the encoder interface mode
+Input   : none
+Output  : none
+函数功能：把TIM5初始化为编码器接口模式
+入口参数：无
+返回  值：无
+**************************************************************************/
+void Encoder_Init_TIM5(void)
+{
+	TIM_TimeBaseInitTypeDef TIM_TimeBaseStructure;  
+  TIM_ICInitTypeDef TIM_ICInitStructure;  
+  GPIO_InitTypeDef GPIO_InitStructure;
+  RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM5, ENABLE);//使能定时器4的时钟
+  RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOA, ENABLE);//使能PB端口时钟
+	
+	 GPIO_PinAFConfig(GPIOA,GPIO_PinSource0,GPIO_AF_TIM5); //复用为TIM4 编码器接口
+  GPIO_PinAFConfig(GPIOA,GPIO_PinSource1,GPIO_AF_TIM5); //复用为TIM4 编码器接口
+	
+  GPIO_InitStructure.GPIO_Pin = GPIO_Pin_0 | GPIO_Pin_1;//端口配置
+  GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
+  GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF;
+  GPIO_InitStructure.GPIO_OType = GPIO_OType_OD;
+  GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_UP;
+  GPIO_Init(GPIOA, &GPIO_InitStructure);   //根据设定参数初始化GPIOB
+
+  TIM_TimeBaseStructInit(&TIM_TimeBaseStructure);
+  
+  TIM_TimeBaseStructure.TIM_Prescaler = 0x0; // No prescaling 
+  TIM_TimeBaseStructure.TIM_Period = ENCODER_TIM_PERIOD; //设定计数器自动重装值
+  TIM_TimeBaseStructure.TIM_ClockDivision = TIM_CKD_DIV1;//选择时钟分频：不分频
+  TIM_TimeBaseStructure.TIM_CounterMode = TIM_CounterMode_Up;   //TIM向上计数  
+  TIM_TimeBaseInit(TIM5, &TIM_TimeBaseStructure);
+  
+  TIM_EncoderInterfaceConfig(TIM5, TIM_EncoderMode_TI12, TIM_ICPolarity_Rising, TIM_ICPolarity_Rising);//使用编码器模式3
+  TIM_ICStructInit(&TIM_ICInitStructure);
+  TIM_ICInitStructure.TIM_ICFilter = 0;
+  TIM_ICInit(TIM5, &TIM_ICInitStructure);
+  
+  TIM_ClearFlag(TIM5, TIM_FLAG_Update);
+  TIM_ITConfig(TIM5, TIM_IT_Update, ENABLE);
+	TIM_SetCounter(TIM5,0);
+  TIM_Cmd(TIM5, ENABLE); 
+}
+
+/**************************************************************************
+Function: Read the encoder count
+Input   : The timer
+Output  : Encoder value (representing speed)
+函数功能：读取编码器计数
+入口参数：定时器
+返回  值：编码器数值(代表速度)
+**************************************************************************/
+int Read_Encoder(u8 TIMX)
+{
+ int Encoder_TIM;    
+ switch(TIMX)
+ {
+	case 2:  Encoder_TIM= (short)TIM2 -> CNT;   TIM2 -> CNT=0;  break;
+	case 3:  Encoder_TIM= (short)TIM3 -> CNT;   TIM3 -> CNT=0;  break;
+	case 4:  Encoder_TIM= (short)TIM4 -> CNT;   TIM4 -> CNT=0;  break;	
+	case 5:  Encoder_TIM= (short)TIM5 -> CNT;   TIM5 -> CNT=0;  break;	
+	default: Encoder_TIM=0;
+ }
+	return Encoder_TIM;
+}
+
+/**************************************************************************
+Function: Tim2 interrupt service function
+Input   : none
+Output  : none
+函数功能：TIM2中断服务函数
+入口参数：无
+返 回 值：无
+**************************************************************************/
+void TIM2_IRQHandler(void)
+{ 		    		  			    
+	if(TIM2->SR&0X0001) //Overflow interrupt //溢出中断
+	{    				   				     	    	
+	}				   
+	TIM2->SR&=~(1<<0); //Clear the interrupt flag bit //清除中断标志位 	    
+}
+/**************************************************************************
+Function: Tim3 interrupt service function
+Input   : none
+Output  : none
+函数功能：TIM3中断服务函数
+入口参数：无
+返 回 值：无
+**************************************************************************/
+void TIM3_IRQHandler(void)
+{ 		    		  			    
+	if(TIM3->SR&0X0001) //Overflow interrupt //溢出中断
+	{    				   				     	    	
+	}				   
+	TIM3->SR&=~(1<<0); //Clear the interrupt flag bit //清除中断标志位  	    
+}
+/**************************************************************************
+Function: Tim4 interrupt service function
+Input   : none
+Output  : none
+函数功能：TIM4中断服务函数
+入口参数：无
+返 回 值：无
+**************************************************************************/
+void TIM4_IRQHandler(void)
+{ 		    		  			    
+	if(TIM4->SR&0X0001) //Overflow interrupt //溢出中断
+	{    				   				     	    	
+	}				   
+	TIM4->SR&=~(1<<0); //Clear the interrupt flag bit //清除中断标志位  	    
+}
+
+/**************************************************************************
+Function: Tim9 interrupt service function
+Input   : none
+Output  : none
+函数功能：TIM9中断服务函数
+入口参数：无
+返 回 值：无
+**************************************************************************/
+void TIM5_IRQHandler(void)
+{ 		    		  			    
+	if(TIM5->SR&0X0001) //Overflow interrupt //溢出中断
+	{    				   				     	    	
+	}				   
+	TIM5->SR&=~(1<<0); //Clear the interrupt flag bit //清除中断标志位  	    
+}
+
+void TIM8_BRK_TIM12_IRQHandler(void)
+{
+	if(TIM12->SR&0X0001) //Overflow interrupt //溢出中断
+	{    				   				     	    	
+	}				   
+	TIM12->SR&=~(1<<0); //Clear the interrupt flag bit //清除中断标志位  	 
+
+}
diff --git a/HARDWARE/encoder.h b/HARDWARE/encoder.h
new file mode 100644
index 0000000..b56f27e
--- /dev/null
+++ b/HARDWARE/encoder.h
@@ -0,0 +1,24 @@
+#ifndef __ENCODER_H
+#define __ENCODER_H
+#include 	 
+#include "system.h"
+
+// No larger than 65535, because the timer of STM32F103 is 16 bit
+//不可大于65535，因为STM32F103的定时器是16位的
+#define ENCODER_TIM_PERIOD (u16)(65535)   
+
+void Encoder_Init_TIM2(void);
+void Encoder_Init_TIM3(void);
+void Encoder_Init_TIM4(void);
+void Encoder_Init_TIM5(void);
+
+
+int Read_Encoder(u8 TIMX);
+
+void TIM2_IRQHandler(void);
+void TIM3_IRQHandler(void);
+void TIM4_IRQHandler(void);
+void TIM5_IRQHandler(void);
+void TIM8_BRK_TIM12_IRQHandler(void);
+
+#endif
diff --git a/HARDWARE/exti.c b/HARDWARE/exti.c
new file mode 100644
index 0000000..783734b
--- /dev/null
+++ b/HARDWARE/exti.c
@@ -0,0 +1,29 @@
+#include "exti.h"
+  /**************************************************************************
+作者：平衡小车之家
+我的淘宝小店：http://shop114407458.taobao.com/
+**************************************************************************/
+/**************************************************************************
+函数功能：外部中断初始化
+入口参数：无
+返回  值：无 
+**************************************************************************/
+void EXTI1_Init(void)
+{
+//	RCC->APB2ENR|=1<<3;    //使能PORTB时钟	   	 
+//	GPIOB->CRH&=0X0FFFFFFF; 
+//	GPIOB->CRH|=0X80000000;//PB5上拉输入
+//  GPIOB->ODR|=1<<15;      //PB5上拉	
+//	Ex_NVIC_Config(GPIO_B,15,FTIR);		//下降沿触发
+//	MY_NVIC_Init(2,1,EXTI15_10_IRQn,2);  	//抢占2，子优先级1，组2
+}
+
+
+
+
+
+
+
+
+
+
diff --git a/HARDWARE/exti.h b/HARDWARE/exti.h
new file mode 100644
index 0000000..cf279d9
--- /dev/null
+++ b/HARDWARE/exti.h
@@ -0,0 +1,35 @@
+#ifndef __EXTI_H
+#define __EXIT_H	 
+#include "sys.h"
+  /**************************************************************************
+作者：平衡小车之家
+我的淘宝小店：http://shop114407458.taobao.com/
+**************************************************************************/
+#define INT PBin(15)   //PB5连接到MPU6050的中断引脚
+void EXTI_Init(void);	//外部中断初始化		 					    
+#endif
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/HARDWARE/key.c b/HARDWARE/key.c
new file mode 100644
index 0000000..0e91c6e
--- /dev/null
+++ b/HARDWARE/key.c
@@ -0,0 +1,185 @@
+#include "key.h"
+
+/**************************************************************************
+Function: Key initialization
+Input   : none
+Output  : none
+函数功能：按键初始化
+入口参数：无
+返回  值：无 
+**************************************************************************/
+void KEY_Init(void)
+{
+	GPIO_InitTypeDef  GPIO_InitStructure;
+  RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOE, ENABLE);//使能GPIOB时钟
+  GPIO_InitStructure.GPIO_Pin = KEY_PIN; //KEY对应引脚
+  GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IN;//普通输入模式
+  GPIO_InitStructure.GPIO_Speed = GPIO_Speed_100MHz;//100M
+  GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_UP;//上拉
+  GPIO_Init(GPIOE, &GPIO_InitStructure);//初始化GPIOB14	
+} 
+/**************************************************************************
+Function: Buttons to scan
+Input   : none
+Output  : none
+函数功能：按键扫描
+入口参数：无
+返回  值：按键状态 0：无动作 1：单击 
+**************************************************************************/
+u8 click(void)
+{
+	//Press the release sign
+	//按键按松开标志
+	static u8 flag_key=1;
+	
+	if(flag_key&&KEY==0)
+	{
+	 flag_key=0; //The key is pressed //按键按下
+	 return 1;	
+	}
+	else if(1==KEY)			
+		flag_key=1;
+	return 0; //No key is pressed //无按键按下
+}
+/**************************************************************************
+Function: Delay function
+Input   : none
+Output  : none
+函数功能：延迟函数
+入口参数：无
+返 回 值：无
+**************************************************************************/
+void Delay_ms(void)
+{
+   int ii,i;    
+   for(ii=0;ii<50;ii++)
+   {
+	   for(i=0;i<50;i++);
+	 }	
+}
+/**************************************************************************
+Function: Buttons to scan
+Input   : Double click wait time
+Output  : Button status: 0- no action, 1- click, 2- double click
+函数功能：按键扫描
+入口参数：双击等待时间
+返回  值：按键状态: 0-无动作, 1-单击, 2-双击 
+**************************************************************************/
+u8 click_N_Double (u8 time)
+{
+		static	u8 flag_key,count_key,double_key;	
+		static	u16 count_single,Forever_count;
+	
+	  if(KEY==0)  Forever_count++;   
+    else        Forever_count=0;
+	
+		if(0==KEY&&0==flag_key)		flag_key=1;	
+	  if(0==count_key)
+		{
+				if(flag_key==1) 
+				{
+					double_key++;
+					count_key=1;	
+				}
+				if(double_key==2) 
+				{
+					double_key=0;
+					count_single=0;
+					return 2; //Double click //双击
+				}
+		}
+		if(1==KEY)			flag_key=0,count_key=0;
+		
+		if(1==double_key)
+		{
+			count_single++;
+			if(count_single>time&&Forever_counttime)
+			{
+			double_key=0;
+			count_single=0;	
+			}
+		}	
+		return 0;
+}
+/**************************************************************************
+Function: Button scan.Because static variables are used, a function with a different name needs to be defined when the keystroke scan function is used multiple times
+Input   : none
+Output  : Button status: 0- no action, 1- click, 2- double click
+函数功能：按键扫描。因为使用到了静态变量，当多处需要使用按键扫描函数时，需要再定义一个不同名函数
+入口参数：无
+返 回 值：按键状态: 0-无动作, 1-单击, 2-双击 
+**************************************************************************/
+u8 click_N_Double_MPU6050 (u8 time)
+{
+		static	u8 flag_key,count_key,double_key;	
+		static	u16 count_single,Forever_count;
+	
+	  if(KEY==0)  Forever_count++;  
+    else        Forever_count=0;
+		if(0==KEY&&0==flag_key)		flag_key=1;	
+	  if(0==count_key)
+		{
+				if(flag_key==1) 
+				{
+					double_key++;
+					count_key=1;	
+				}
+				if(double_key==2) 
+				{
+					double_key=0;
+					count_single=0;
+					return 2; //Double click //双击
+				}
+		}
+		if(1==KEY)			flag_key=0,count_key=0;
+		
+		if(1==double_key)
+		{
+			count_single++;
+			if(count_single>time&&Forever_counttime)
+			{
+			double_key=0;
+			count_single=0;	
+			}
+		}	
+		return 0;
+}
+/**************************************************************************
+Function: Long according to the test
+Input   : none
+Output  : Key state 0: no action 1: long press 3s
+函数功能：长按检测
+入口参数：无
+返回  值：按键状态 0：无动作 1：长按3s
+**************************************************************************/
+u8 Long_Press(void)
+{
+	static u16 Long_Press_count,Long_Press;
+
+	if(Long_Press==0&&KEY==0)  Long_Press_count++; 
+	else                       Long_Press_count=0;
+
+	if(Long_Press_count>15)	//3 seconds //3秒	
+	{
+		Long_Press=1;	
+		Long_Press_count=0;
+		return 1;
+	}				
+	 if(Long_Press==1) //Long press position 1 //长按标志位置1
+	{
+			Long_Press=0;
+	}
+	return 0;
+}
diff --git a/HARDWARE/key.h b/HARDWARE/key.h
new file mode 100644
index 0000000..a88cbcb
--- /dev/null
+++ b/HARDWARE/key.h
@@ -0,0 +1,19 @@
+#ifndef __KEY_H
+#define __KEY_H	 
+#include "sys.h"
+#include "system.h"
+
+void KEY_Init(void);
+u8 click(void);
+void Delay_ms(void);
+u8 click_N_Double (u8 time);
+u8 click_N_Double_MPU6050 (u8 time);
+u8 Long_Press(void);
+
+/*--------KEY control pin--------*/
+#define KEY_PORT	GPIOE
+#define KEY_PIN		GPIO_Pin_0
+#define KEY			PEin(0) 
+/*----------------------------------*/
+
+#endif 
diff --git a/HARDWARE/motor.c b/HARDWARE/motor.c
new file mode 100644
index 0000000..16a49e1
--- /dev/null
+++ b/HARDWARE/motor.c
@@ -0,0 +1,222 @@
+#include "motor.h"
+
+
+/**************************************************************************
+Function: Enable switch pin initialization
+Input   : none
+Output  : none
+函数功能：使能开关引脚初始化
+入口参数：无
+返回  值：无 
+**************************************************************************/
+void Enable_Pin(void)
+{
+	GPIO_InitTypeDef  GPIO_InitStructure;
+  RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOD, ENABLE);//使能GPIOB时钟
+  GPIO_InitStructure.GPIO_Pin = GPIO_Pin_3; //KEY对应引脚
+  GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IN;//普通输入模式
+  GPIO_InitStructure.GPIO_Speed = GPIO_Speed_100MHz;//100M
+  GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_UP;//上拉
+  GPIO_Init(GPIOD, &GPIO_InitStructure);//初始化GPIOB14
+} 
+
+void TIM1_PWM_Init(u16 arr,u16 psc)
+{
+	GPIO_InitTypeDef GPIO_InitStructure;
+	TIM_TimeBaseInitTypeDef  TIM_TimeBaseStructure;
+	TIM_OCInitTypeDef  TIM_OCInitStructure;
+	
+	RCC_APB2PeriphClockCmd(RCC_APB2Periph_TIM1,ENABLE);  	  //TIM8时钟使能    
+	RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOE, ENABLE); 	//使能PORTC时钟	
+	
+	GPIO_PinAFConfig(GPIOE,GPIO_PinSource9,GPIO_AF_TIM1); 
+	GPIO_PinAFConfig(GPIOE,GPIO_PinSource11,GPIO_AF_TIM1); 
+	GPIO_PinAFConfig(GPIOE,GPIO_PinSource13,GPIO_AF_TIM1); 
+	GPIO_PinAFConfig(GPIOE,GPIO_PinSource14,GPIO_AF_TIM1); 
+	
+	GPIO_InitStructure.GPIO_Pin = GPIO_Pin_9|GPIO_Pin_11|GPIO_Pin_13|GPIO_Pin_14;   //GPIO
+	GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF;        //复用功能
+	GPIO_InitStructure.GPIO_Speed = GPIO_Speed_100MHz;	//速度100MHz
+	GPIO_InitStructure.GPIO_OType = GPIO_OType_PP;      //推挽复用输出
+	GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_UP;        //上拉
+	GPIO_Init(GPIOE,&GPIO_InitStructure);              //初始化PC口
+	
+	//Sets the value of the auto-reload register cycle for the next update event load activity
+	//设置在下一个更新事件装入活动的自动重装载寄存器周期的值	 
+	TIM_TimeBaseStructure.TIM_Period = arr; 
+	//Sets the pre-divider value used as the TIMX clock frequency divisor
+	//设置用来作为TIMx时钟频率除数的预分频值
+	TIM_TimeBaseStructure.TIM_Prescaler =psc; 
+	//Set the clock split :TDTS = Tck_tim
+	//设置时钟分割:TDTS = Tck_tim
+	TIM_TimeBaseStructure.TIM_ClockDivision = 1; 
+	//Up counting mode 
+	//向上计数模式  
+	TIM_TimeBaseStructure.TIM_CounterMode = TIM_CounterMode_Up;  
+	//Initializes the timebase unit for TIMX based on the parameter specified in TIM_TIMEBASEINITSTRUCT
+	//根据TIM_TimeBaseInitStruct中指定的参数初始化TIMx的时间基数单位
+	TIM_TimeBaseInit(TIM1, &TIM_TimeBaseStructure); 
+
+  //Select Timer mode :TIM Pulse Width Modulation mode 1
+  //选择定时器模式:TIM脉冲宽度调制模式1
+ 	TIM_OCInitStructure.TIM_OCMode = TIM_OCMode_PWM1; 
+	//Compare output enablement
+	//比较输出使能
+	TIM_OCInitStructure.TIM_OutputState = TIM_OutputState_Enable; 
+  //Output polarity :TIM output polarity is higher	
+  //输出极性:TIM输出比较极性高	
+	TIM_OCInitStructure.TIM_OCPolarity = TIM_OCPolarity_High;     
+	//Initialize the peripheral TIMX based on the parameter specified in TIM_OCINITSTRUCT
+  //根据TIM_OCInitStruct中指定的参数初始化外设TIMx	
+	TIM_OC1Init(TIM1, &TIM_OCInitStructure); 
+	TIM_OC2Init(TIM1, &TIM_OCInitStructure); 
+	TIM_OC3Init(TIM1, &TIM_OCInitStructure); 
+	TIM_OC4Init(TIM1, &TIM_OCInitStructure); 
+	
+	// Advanced timer output must be enabled
+	//高级定时器输出必须使能这句		
+	TIM_CtrlPWMOutputs(TIM1,ENABLE);
+	
+	//CH1 is pre-loaded and enabled
+	//CH1预装载使能	 
+	TIM_OC1PreloadConfig(TIM1, TIM_OCPreload_Enable); 
+	TIM_OC2PreloadConfig(TIM1, TIM_OCPreload_Enable);  
+	TIM_OC3PreloadConfig(TIM1, TIM_OCPreload_Enable);  
+	TIM_OC4PreloadConfig(TIM1, TIM_OCPreload_Enable);  
+
+  // Enable the TIMX preloaded register on the ARR
+  //使能TIMx在ARR上的预装载寄存器	
+	TIM_ARRPreloadConfig(TIM1, ENABLE); 
+	
+	//Enable TIM8
+	//使能TIM8
+	TIM_Cmd(TIM1, ENABLE);  
+}
+
+void TIM9_PWM_Init(u16 arr,u16 psc)
+{
+TIM_TimeBaseInitTypeDef TIM_TimeBaseInitStructure;
+GPIO_InitTypeDef GPIO_InitStructure;
+TIM_OCInitTypeDef TIM_OCInitStructure;
+
+RCC_APB2PeriphClockCmd(RCC_APB2Periph_TIM9,ENABLE);/*使能定时器11时钟*/
+RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOE,ENABLE);/*使能GPIOF时钟*/
+
+GPIO_PinAFConfig(GPIOE,GPIO_PinSource5,GPIO_AF_TIM9);/*复用*/
+GPIO_PinAFConfig(GPIOE,GPIO_PinSource6,GPIO_AF_TIM9);/*复用*/
+
+GPIO_InitStructure.GPIO_Pin = GPIO_Pin_5|GPIO_Pin_6;           //GPIOF9
+GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF;        //复用功能
+GPIO_InitStructure.GPIO_Speed = GPIO_Speed_100MHz;	//速度100MHz
+GPIO_InitStructure.GPIO_OType = GPIO_OType_PP;      //推挽复用输出
+GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_UP;        //上拉
+GPIO_Init(GPIOE,&GPIO_InitStructure);              //初始化PF9
+
+TIM_TimeBaseInitStructure.TIM_Period = arr;/*自动重装载*/
+TIM_TimeBaseInitStructure.TIM_Prescaler = psc;/*预分频*/
+TIM_TimeBaseInitStructure.TIM_ClockDivision = TIM_CKD_DIV1;/*时钟分频*/
+TIM_TimeBaseInitStructure.TIM_CounterMode = TIM_CounterMode_Up;/*向上计数*/
+TIM_TimeBaseInit(TIM9,&TIM_TimeBaseInitStructure);/*初始化*/
+
+TIM_OCInitStructure.TIM_OCMode = TIM_OCMode_PWM1;/*PWM模式*/
+TIM_OCInitStructure.TIM_OutputState = TIM_OutputState_Enable;/*输出*/
+TIM_OCInitStructure.TIM_OCPolarity = TIM_OCPolarity_High;/*比较极性高*/
+TIM_OC1Init(TIM9,&TIM_OCInitStructure);
+TIM_OC2Init(TIM9,&TIM_OCInitStructure);
+
+TIM_OC1PreloadConfig(TIM9,TIM_OCPreload_Enable);/*输出比较预装载使能*/
+TIM_OC2PreloadConfig(TIM9,TIM_OCPreload_Enable);/*输出比较预装载使能*/
+
+TIM_ARRPreloadConfig(TIM9,ENABLE);/*自动重载预装载使能*/
+
+TIM_Cmd(TIM9,ENABLE);/*计数使能*/
+
+}
+
+
+void TIM10_PWM_Init(u16 arr,u16 psc)
+{
+TIM_TimeBaseInitTypeDef TIM_TimeBaseInitStructure;
+GPIO_InitTypeDef GPIO_InitStructure;
+TIM_OCInitTypeDef TIM_OCInitStructure;
+
+RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOB,ENABLE);/*使能GPIOF时钟*/
+RCC_APB2PeriphClockCmd(RCC_APB2Periph_TIM10,ENABLE);/*使能定时器11时钟*/
+
+GPIO_PinAFConfig(GPIOB,GPIO_PinSource8,GPIO_AF_TIM10);/*复用*/
+
+GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF;/*复用*/
+GPIO_InitStructure.GPIO_OType = GPIO_OType_PP;/*推挽输出*/
+GPIO_InitStructure.GPIO_Pin   = GPIO_Pin_8;/*PF7*/
+GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_UP;/*上拉*/
+GPIO_InitStructure.GPIO_Speed = GPIO_Speed_100MHz;/**/
+GPIO_Init(GPIOB,&GPIO_InitStructure);/*初始化IO*/
+
+TIM_TimeBaseInitStructure.TIM_Period = arr;/*自动重装载*/
+TIM_TimeBaseInitStructure.TIM_Prescaler = psc;/*预分频*/
+TIM_TimeBaseInitStructure.TIM_ClockDivision = TIM_CKD_DIV1;/*时钟分频*/
+TIM_TimeBaseInitStructure.TIM_CounterMode = TIM_CounterMode_Up;/*向上计数*/
+TIM_TimeBaseInit(TIM10,&TIM_TimeBaseInitStructure);/*初始化*/
+
+TIM_OCInitStructure.TIM_OCMode = TIM_OCMode_PWM1;/*PWM模式*/
+TIM_OCInitStructure.TIM_OutputState = TIM_OutputState_Enable;/*输出*/
+TIM_OCInitStructure.TIM_OCPolarity = TIM_OCPolarity_High;/*比较极性高*/
+TIM_OC1Init(TIM10,&TIM_OCInitStructure);
+
+TIM_OC1PreloadConfig(TIM10,TIM_OCPreload_Enable);/*输出比较预装载使能*/
+
+//TIM_CtrlPWMOutputs(TIM10,ENABLE);
+
+TIM_ARRPreloadConfig(TIM10,ENABLE);/*自动重载预装载使能*/
+
+TIM_Cmd(TIM10,ENABLE);/*计数使能*/
+
+}
+
+void TIM11_PWM_Init(u16 arr,u16 psc)
+{
+
+TIM_TimeBaseInitTypeDef TIM_TimeBaseInitStructure;
+GPIO_InitTypeDef GPIO_InitStructure;
+TIM_OCInitTypeDef TIM_OCInitStructure;
+
+RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOB,ENABLE);/*使能GPIOF时钟*/
+RCC_APB2PeriphClockCmd(RCC_APB2Periph_TIM11,ENABLE);/*使能定时器11时钟*/
+
+GPIO_PinAFConfig(GPIOB,GPIO_PinSource9,GPIO_AF_TIM11);/*复用*/
+
+GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF;/*复用*/
+GPIO_InitStructure.GPIO_OType = GPIO_OType_PP;/*推挽输出*/
+GPIO_InitStructure.GPIO_Pin   = GPIO_Pin_9;/*PF7*/
+GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_UP;/*上拉*/
+GPIO_InitStructure.GPIO_Speed = GPIO_Speed_100MHz;/**/
+GPIO_Init(GPIOB,&GPIO_InitStructure);/*初始化IO*/
+
+TIM_TimeBaseInitStructure.TIM_Period = arr;/*自动重装载*/
+TIM_TimeBaseInitStructure.TIM_Prescaler = psc;/*预分频*/
+TIM_TimeBaseInitStructure.TIM_ClockDivision = TIM_CKD_DIV1;/*时钟分频*/
+TIM_TimeBaseInitStructure.TIM_CounterMode = TIM_CounterMode_Up;/*向上计数*/
+TIM_TimeBaseInit(TIM11,&TIM_TimeBaseInitStructure);/*初始化*/
+
+TIM_OCInitStructure.TIM_OCMode = TIM_OCMode_PWM1;/*PWM模式*/
+TIM_OCInitStructure.TIM_OutputState = TIM_OutputState_Enable;/*输出*/
+TIM_OCInitStructure.TIM_OCPolarity = TIM_OCPolarity_High;/*比较极性高*/
+TIM_OC1Init(TIM11,&TIM_OCInitStructure);
+
+TIM_OC1PreloadConfig(TIM11,TIM_OCPreload_Enable);/*输出比较预装载使能*/
+
+TIM_CtrlPWMOutputs(TIM11,ENABLE);
+
+TIM_ARRPreloadConfig(TIM11,ENABLE);/*自动重载预装载使能*/
+
+TIM_Cmd(TIM11,ENABLE);/*计数使能*/
+
+}
+
+
+
+
+
+
+
+
diff --git a/HARDWARE/motor.h b/HARDWARE/motor.h
new file mode 100644
index 0000000..72c9a71
--- /dev/null
+++ b/HARDWARE/motor.h
@@ -0,0 +1,63 @@
+
+#ifndef __MOTOR_H
+#define __MOTOR_H
+
+#include "system.h"
+
+/*--------Motor_A control pins--------*/
+#define PWM_PORTA1 GPIOB			 //PWMA
+#define PWM_PIN_A1 GPIO_Pin_8 //PWMA
+#define PWMA1 	  TIM10->CCR1	 //PWMA
+
+#define PWM_PORTA2 GPIOB			 //PWMA
+#define PWM_PIN_A2 GPIO_Pin_9 //PWMA
+#define PWMA2 	  TIM11->CCR1	 //PWMA
+/*------------------------------------*/
+
+/*--------Motor_B control pins--------*/
+#define PWM_PORTB1 GPIOE			 //PWMB
+#define PWM_PIN_B1 GPIO_Pin_5 //PWMB
+#define PWMB1 	  TIM9->CCR1	 //PWMB
+
+#define PWM_PORTB2 GPIOE			 //PWMB
+#define PWM_PIN_B2 GPIO_Pin_6 //PWMB
+#define PWMB2 	  TIM9->CCR2	 //PWMB
+
+/*------------------------------------*/
+
+/*--------Motor_C control pins--------*/
+#define PWM_PORTC1 GPIOE			 //PWMC
+#define PWM_PIN_C1 GPIO_Pin_11 //PWMC
+#define PWMC1 	  TIM1->CCR2	 //PWMC
+
+#define PWM_PORTC2 GPIOE			 //PWMC
+#define PWM_PIN_C2 GPIO_Pin_9 //PWMC
+#define PWMC2 	  TIM1->CCR1	 //PWMC
+
+/*------------------------------------*/
+
+/*--------Motor_D control pins--------*/
+#define PWM_PORTD1 GPIOE			 //PWMD
+#define PWM_PIN_D1 GPIO_Pin_14 //PWMD
+#define PWMD1 	  TIM1->CCR4	 //PWMD
+
+#define PWM_PORTD2 GPIOE			 //PWMD
+#define PWM_PIN_D2 GPIO_Pin_13 //PWMD
+#define PWMD2 	  TIM1->CCR3	 //PWMD
+
+/*------------------------------------*/
+#define EN     PDin(3)  
+
+#define Servo_PWM  TIM12->CCR2
+#define SERVO_INIT 1600  //Servo zero point //舵机零点
+
+void Enable_Pin(void);
+void Servo_PWM_Init(u16 arr,u16 psc);
+void TIM1_PWM_Init(u16 arr,u16 psc);
+void TIM9_PWM_Init(u16 arr,u16 psc);
+void TIM10_PWM_Init(u16 arr,u16 psc);
+void TIM11_PWM_Init(u16 arr,u16 psc);			
+	
+
+
+#endif
diff --git a/HARDWARE/oled.c b/HARDWARE/oled.c
new file mode 100644
index 0000000..afa47e3
--- /dev/null
+++ b/HARDWARE/oled.c
@@ -0,0 +1,325 @@
+#include "oled.h"
+#include "stdlib.h"
+#include "oledfont.h"  	 
+#include "delay.h"
+
+u8 OLED_GRAM[128][8];	 
+/**************************************************************************
+Function: Refresh the OLED screen
+Input   : none
+Output  : none
+函数功能：刷新OLED屏幕
+入口参数：无
+返回  值：无
+**************************************************************************/
+void OLED_Refresh_Gram(void)
+{
+	u8 i,n;		    
+	for(i=0;i<8;i++)  
+	{  
+		OLED_WR_Byte (0xb0+i,OLED_CMD);    //Set page address (0~7) //设置页地址（0~7）
+		OLED_WR_Byte (0x00,OLED_CMD);      //Set the display location - column low address //设置显示位置—列低地址
+		OLED_WR_Byte (0x10,OLED_CMD);      //Set the display location - column height address //设置显示位置—列高地址   
+		for(n=0;n<128;n++)OLED_WR_Byte(OLED_GRAM[n][i],OLED_DATA); 
+	}   
+}
+/**************************************************************************
+Function: Refresh the OLED screen
+Input   : Dat: data/command to write, CMD: data/command flag 0, represents the command;1, represents data
+Output  : none
+函数功能：向OLED写入一个字节
+入口参数：dat:要写入的数据/命令，cmd:数据/命令标志 0,表示命令;1,表示数据
+返回  值：无
+**************************************************************************/  
+void OLED_WR_Byte(u8 dat,u8 cmd)
+{	
+	u8 i;			  
+	if(cmd)
+	  OLED_RS_Set();
+	else 
+	  OLED_RS_Clr();		  
+	for(i=0;i<8;i++)
+	{			  
+		OLED_SCLK_Clr();
+		if(dat&0x80)
+		   OLED_SDIN_Set();
+		else 
+		   OLED_SDIN_Clr();
+		OLED_SCLK_Set();
+		dat<<=1;   
+	}				 		  
+	OLED_RS_Set();   	  
+} 
+/**************************************************************************
+Function: Turn on the OLED display
+Input   : none
+Output  : none
+函数功能：开启OLED显示 
+入口参数：无
+返回  值：无
+**************************************************************************/  
+void OLED_Display_On(void)
+{
+	OLED_WR_Byte(0X8D,OLED_CMD);  //SET DCDC command //SET DCDC命令
+	OLED_WR_Byte(0X14,OLED_CMD);  //DCDC ON
+	OLED_WR_Byte(0XAF,OLED_CMD);  //DISPLAY ON
+}
+/**************************************************************************
+Function: Turn off the OLED display
+Input   : none
+Output  : none
+函数功能：关闭OLED显示 
+入口参数：无			  
+返回  值：无
+**************************************************************************/  
+void OLED_Display_Off(void)
+{
+	OLED_WR_Byte(0X8D,OLED_CMD);  //SET DCDC command //SET DCDC命令
+	OLED_WR_Byte(0X10,OLED_CMD);  //DCDC OFF
+	OLED_WR_Byte(0XAE,OLED_CMD);  //DISPLAY OFF
+}	
+/**************************************************************************
+Function: Screen clear function, clear the screen, the entire screen is black, and did not light up the same
+Input   : none
+Output  : none
+函数功能：清屏函数,清完屏,整个屏幕是黑色的，和没点亮一样
+入口参数：无		  
+返回  值：无
+**************************************************************************/  
+void OLED_Clear(void)  
+{  
+	u8 i,n;  
+	for(i=0;i<8;i++)for(n=0;n<128;n++)OLED_GRAM[n][i]=0X00;  
+	OLED_Refresh_Gram(); //Update the display //更新显示
+}
+/**************************************************************************
+Function: Draw point
+Input   : x,y: starting coordinate;T :1, fill,0, empty
+Output  : none
+函数功能：画点 
+入口参数：x,y :起点坐标; t:1,填充,0,清空			  
+返回  值：无
+**************************************************************************/ 
+void OLED_DrawPoint(u8 x,u8 y,u8 t)
+{
+	u8 pos,bx,temp=0;
+	if(x>127||y>63)return;//超出范围了.
+	pos=7-y/8;
+	bx=y%8;
+	temp=1<<(7-bx);
+	if(t)OLED_GRAM[x][pos]|=temp;
+	else OLED_GRAM[x][pos]&=~temp;	    
+}
+/**************************************************************************
+Function: Displays a character, including partial characters, at the specified position
+Input   : x,y: starting coordinate;Len: The number of digits;Size: font size;Mode :0, anti-white display,1, normal display
+Output  : none
+函数功能：在指定位置显示一个字符,包括部分字符
+入口参数：x,y :起点坐标; len :数字的位数; size:字体大小; mode:0,反白显示,1,正常显示	   
+返回  值：无
+**************************************************************************/
+void OLED_ShowChar(u8 x,u8 y,u8 chr,u8 size,u8 mode)
+{      			    
+	u8 temp,t,t1;
+	u8 y0=y;
+	chr=chr-' '; //Get the offset value //得到偏移后的值				   
+    for(t=0;tMAX_CHAR_POSX){x=0;y+=16;}
+        if(y>MAX_CHAR_POSY){y=x=0;OLED_Clear();}
+        OLED_ShowChar(x,y,*p,12,1);	 
+        x+=8;
+        p++;
+    }  
+}	 
+/**************************************************************************
+Function: Initialize the OLED
+Input   : none
+Output  : none
+函数功能：初始化OLED	
+入口参数: 无 
+返回  值：无
+**************************************************************************/	    
+void OLED_Init(void)
+{ 	
+  GPIO_InitTypeDef GPIO_InitStructure;
+	
+	//Enable pB port clock
+	//使能PB端口时钟
+	RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOD  , ENABLE);  //使能GPIOC
+
+	//Port configuration
+	//端口配置
+	GPIO_InitStructure.GPIO_Pin = GPIO_Pin_11|GPIO_Pin_12|GPIO_Pin_13|GPIO_Pin_14;
+	GPIO_InitStructure.GPIO_Mode = GPIO_Mode_OUT;   //输出
+	GPIO_InitStructure.GPIO_OType =GPIO_OType_PP;
+	GPIO_InitStructure.GPIO_Speed =GPIO_Speed_2MHz;  //2M
+	GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_NOPULL;//根据设定参数初始化GPIO
+	GPIO_Init(GPIOD, &GPIO_InitStructure);				      
+
+	RCC_APB1PeriphClockCmd(RCC_APB1Periph_PWR  , ENABLE);    //PWR使能
+	//Allows you to modify RTC and backup registers
+  //允许修改RTC和后备寄存器
+	PWR_BackupAccessCmd(ENABLE);
+	//Turn off the external low speed external clock signal function, PC13, PC14, PC15 can be used as normal IO
+	//关闭外部低速外部时钟信号功能 后，PC13 PC14 PC15 才可以当普通IO用
+	RCC_LSEConfig(RCC_LSE_OFF);
+	//Do not modify the backup register
+	//禁止修改后备寄存器
+	PWR_BackupAccessCmd(DISABLE);
+
+	OLED_RST_Clr();
+	delay_ms(100);
+	OLED_RST_Set(); 
+				  
+	OLED_WR_Byte(0xAE,OLED_CMD); //Close display //关闭显示
+	OLED_WR_Byte(0xD5,OLED_CMD); //The frequency frequency factor, the frequency of the shock //设置时钟分频因子,震荡频率
+	OLED_WR_Byte(80,OLED_CMD);   //[3:0], the frequency dividing factor;[7:4], oscillation frequency //[3:0],分频因子;[7:4],震荡频率
+	OLED_WR_Byte(0xA8,OLED_CMD); //Set the number of driver paths //设置驱动路数
+	OLED_WR_Byte(0X3F,OLED_CMD); //Default 0x3f(1/64) //默认0X3F(1/64) 
+	OLED_WR_Byte(0xD3,OLED_CMD); //Setting display deviation //设置显示偏移
+	OLED_WR_Byte(0X00,OLED_CMD); //Default is 0//默认为0
+
+	OLED_WR_Byte(0x40,OLED_CMD); //Sets the number of rows to display starting line [5:0] //设置显示开始行 [5:0],行数
+													
+	OLED_WR_Byte(0x8D,OLED_CMD); //Charge pump setup //电荷泵设置
+	OLED_WR_Byte(0x14,OLED_CMD); //Bit2, on/off //bit2，开启/关闭
+	OLED_WR_Byte(0x20,OLED_CMD); //Set up the memory address mode //设置内存地址模式
+	OLED_WR_Byte(0x02,OLED_CMD); //[1:0],00, column address mode;01, line address mode;10. Page address mode;The default 10; //[1:0],00，列地址模式;01，行地址模式;10,页地址模式;默认10;
+	OLED_WR_Byte(0xA1,OLED_CMD); //Segment redefine setting,bit0:0,0- >;0;1, 0 - & gt;127; //段重定义设置,bit0:0,0->0;1,0->127;
+	OLED_WR_Byte(0xC0,OLED_CMD); //Set the COM scan direction;Bit3:0, normal mode;1, Re-define schema COM[n-1]- >;COM0;N: Number of driving paths//设置COM扫描方向;bit3:0,普通模式;1,重定义模式 COM[N-1]->COM0;N:驱动路数
+	OLED_WR_Byte(0xDA,OLED_CMD); //Set the COM hardware pin configuration //设置COM硬件引脚配置
+	OLED_WR_Byte(0x12,OLED_CMD); //[5:4]configuration //[5:4]配置
+	 
+	OLED_WR_Byte(0x81,OLED_CMD); //Contrast Settings //对比度设置
+	OLED_WR_Byte(0xEF,OLED_CMD); //1~ 255; Default 0x7f (brightness Settings, the bigger the brighter) //1~255;默认0X7F (亮度设置,越大越亮)
+	OLED_WR_Byte(0xD9,OLED_CMD); //Set the pre-charging cycle //设置预充电周期
+	OLED_WR_Byte(0xf1,OLED_CMD); //[3:0],PHASE 1;[7:4],PHASE 2;
+	OLED_WR_Byte(0xDB,OLED_CMD); //Setting vcomh voltage multiplier//设置VCOMH 电压倍率
+	OLED_WR_Byte(0x30,OLED_CMD); //[6:4] 000,0.65*vcc;001,0.77*vcc;011,0.83*vcc;
+
+	OLED_WR_Byte(0xA4,OLED_CMD); //Global display; Bit0:1, open; 0, close; (white screen/black screen)//全局显示开启;bit0:1,开启;0,关闭;(白屏/黑屏)
+	OLED_WR_Byte(0xA6,OLED_CMD); //Settings display mode; Bit0:1, anti-phase display; 0, normal display//设置显示方式;bit0:1,反相显示;0,正常显示	    						   
+	OLED_WR_Byte(0xAF,OLED_CMD); //Open display //开启显示	 
+	OLED_Clear();
+}  
+
+/**************************************************************************
+Function: Display character
+Input   : x: indicates the horizontal coordinates displayed; Y: the vertical coordinates that show the display;
+          no: the line number in the array of the Chinese character (module) in the hzk-and "array", which is determined by the line number to determine the characters shown in the array,
+          The value of the width of the font here must be consistent with the size of the dot matrix value of the use of the word mold.
+          font_height: the font is high for the use of the word mold, because my screen pixels are 32hours, 128----0~ 7, and four bits per page
+Output  : none
+Note: this method is used to show that the Chinese character must satisfy the size of the word that the word model generates the software to generate the same size as the dot matrix
+函数功能：显示汉字	
+入口参数: x：表示显示的水平坐标; y: 表示显示的垂直坐标;
+          no: 表示要显示的汉字（模组）在hzk[][]数组中的行号,通过行号来确定在数组中要显示的汉字,
+              这里字体的宽font_width的值必须与用字模制作软件生成字模时的点阵值大小一致;
+          font_height:为用字模制作软件生成字模时字体的高,由于我的屏像素为32*128-----0~7共8页，每页4个位
+返回  值：无
+注意：用这种方法来显示汉字一定要满足用字模生成软件生成的字宽与点阵大小相同才行，否者容易乱码
+**************************************************************************/	    
+void OLED_ShowCHinese(u8 x,u8 y,u8 no,u8 font_width,u8 font_height)
+{     			    
+	 u8 t, i;
+   for(i=0;i<(font_height/8);i++)	//The maximum height of font_height is 32. this screen is only 8 pages (line), four digits per page
+	                                //font_height最大值为32，这张屏只有8个页（行），每页4个位
+	 {
+			OLED_Set_Pos(x,y+i);	
+			for(t=0;t>4)|0x10,OLED_CMD);
+	 OLED_WR_Byte((x&0x0f),OLED_CMD); 
+} 
+
+
diff --git a/HARDWARE/oled.h b/HARDWARE/oled.h
new file mode 100644
index 0000000..ece3040
--- /dev/null
+++ b/HARDWARE/oled.h
@@ -0,0 +1,41 @@
+#ifndef __OLED_H
+#define __OLED_H			  	 
+#include "sys.h"
+#include "system.h"
+
+//Oled port macro definition
+//OLED端口宏定义
+#define OLED_RST_Clr() PDout(12)=0   //RST
+#define OLED_RST_Set() PDout(12)=1   //RST
+
+#define OLED_RS_Clr()  PDout(11)=0   //DC
+#define OLED_RS_Set()  PDout(11)=1   //DC
+
+#define OLED_SCLK_Clr()  PDout(14)=0   //SCL
+#define OLED_SCLK_Set()  PDout(14)=1   //SCL
+
+#define OLED_SDIN_Clr()  PDout(13)=0   //SDA
+#define OLED_SDIN_Set()  PDout(13)=1   //SDA
+#define OLED_CMD  0	//Command //写命令
+#define OLED_DATA 1	//Data //写数据
+
+//Oled control function
+//OLED控制用函数
+void OLED_WR_Byte(u8 dat,u8 cmd);	    
+void OLED_Display_On(void);
+void OLED_Display_Off(void);
+void OLED_Refresh_Gram(void);		   				   		    
+void OLED_Init(void);
+void OLED_Clear(void);
+void OLED_DrawPoint(u8 x,u8 y,u8 t);
+void OLED_ShowChar(u8 x,u8 y,u8 chr,u8 size,u8 mode);
+void OLED_ShowNumber(u8 x,u8 y,u32 num,u8 len,u8 size);
+void OLED_ShowString(u8 x,u8 y,const u8 *p);
+
+#define CNSizeWidth  16
+#define CNSizeHeight 16
+//extern char Hzk16[][16];
+void OLED_ShowCHinese(u8 x,u8 y,u8 no,u8 font_width,u8 font_height);	
+void OLED_Set_Pos(unsigned char x, unsigned char y);
+#endif  
+	 
diff --git a/HARDWARE/oledfont.h b/HARDWARE/oledfont.h
new file mode 100644
index 0000000..e34faf2
--- /dev/null
+++ b/HARDWARE/oledfont.h
@@ -0,0 +1,398 @@
+#ifndef __OLEDFONT_H
+#define __OLEDFONT_H 	 
+
+//Common ASCII tables
+//Offset
+//Ascii character set
+//Offset
+//Size: 1
+//常用ASCII表
+//偏移量32
+//ASCII字符集
+//偏移量32
+//大小:12*6
+const unsigned char oled_asc2_1206[95][12]={
+{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00},/*" ",0*/
+{0x00,0x00,0x00,0x00,0x3F,0x40,0x00,0x00,0x00,0x00,0x00,0x00},/*"!",1*/
+{0x00,0x00,0x30,0x00,0x40,0x00,0x30,0x00,0x40,0x00,0x00,0x00},/*""",2*/
+{0x09,0x00,0x0B,0xC0,0x3D,0x00,0x0B,0xC0,0x3D,0x00,0x09,0x00},/*"#",3*/
+{0x18,0xC0,0x24,0x40,0x7F,0xE0,0x22,0x40,0x31,0x80,0x00,0x00},/*"$",4*/
+{0x18,0x00,0x24,0xC0,0x1B,0x00,0x0D,0x80,0x32,0x40,0x01,0x80},/*"%",5*/
+{0x03,0x80,0x1C,0x40,0x27,0x40,0x1C,0x80,0x07,0x40,0x00,0x40},/*"&",6*/
+{0x10,0x00,0x60,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00},/*"'",7*/
+{0x00,0x00,0x00,0x00,0x00,0x00,0x1F,0x80,0x20,0x40,0x40,0x20},/*"(",8*/
+{0x00,0x00,0x40,0x20,0x20,0x40,0x1F,0x80,0x00,0x00,0x00,0x00},/*")",9*/
+{0x09,0x00,0x06,0x00,0x1F,0x80,0x06,0x00,0x09,0x00,0x00,0x00},/*"*",10*/
+{0x04,0x00,0x04,0x00,0x3F,0x80,0x04,0x00,0x04,0x00,0x00,0x00},/*"+",11*/
+{0x00,0x10,0x00,0x60,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00},/*",",12*/
+{0x04,0x00,0x04,0x00,0x04,0x00,0x04,0x00,0x04,0x00,0x00,0x00},/*"-",13*/
+{0x00,0x00,0x00,0x40,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00},/*".",14*/
+{0x00,0x20,0x01,0xC0,0x06,0x00,0x38,0x00,0x40,0x00,0x00,0x00},/*"/",15*/
+{0x1F,0x80,0x20,0x40,0x20,0x40,0x20,0x40,0x1F,0x80,0x00,0x00},/*"0",16*/
+{0x00,0x00,0x10,0x40,0x3F,0xC0,0x00,0x40,0x00,0x00,0x00,0x00},/*"1",17*/
+{0x18,0xC0,0x21,0x40,0x22,0x40,0x24,0x40,0x18,0x40,0x00,0x00},/*"2",18*/
+{0x10,0x80,0x20,0x40,0x24,0x40,0x24,0x40,0x1B,0x80,0x00,0x00},/*"3",19*/
+{0x02,0x00,0x0D,0x00,0x11,0x00,0x3F,0xC0,0x01,0x40,0x00,0x00},/*"4",20*/
+{0x3C,0x80,0x24,0x40,0x24,0x40,0x24,0x40,0x23,0x80,0x00,0x00},/*"5",21*/
+{0x1F,0x80,0x24,0x40,0x24,0x40,0x34,0x40,0x03,0x80,0x00,0x00},/*"6",22*/
+{0x30,0x00,0x20,0x00,0x27,0xC0,0x38,0x00,0x20,0x00,0x00,0x00},/*"7",23*/
+{0x1B,0x80,0x24,0x40,0x24,0x40,0x24,0x40,0x1B,0x80,0x00,0x00},/*"8",24*/
+{0x1C,0x00,0x22,0xC0,0x22,0x40,0x22,0x40,0x1F,0x80,0x00,0x00},/*"9",25*/
+{0x00,0x00,0x00,0x00,0x08,0x40,0x00,0x00,0x00,0x00,0x00,0x00},/*":",26*/
+{0x00,0x00,0x00,0x00,0x04,0x60,0x00,0x00,0x00,0x00,0x00,0x00},/*";",27*/
+{0x00,0x00,0x04,0x00,0x0A,0x00,0x11,0x00,0x20,0x80,0x40,0x40},/*"<",28*/
+{0x09,0x00,0x09,0x00,0x09,0x00,0x09,0x00,0x09,0x00,0x00,0x00},/*"=",29*/
+{0x00,0x00,0x40,0x40,0x20,0x80,0x11,0x00,0x0A,0x00,0x04,0x00},/*">",30*/
+{0x18,0x00,0x20,0x00,0x23,0x40,0x24,0x00,0x18,0x00,0x00,0x00},/*"?",31*/
+{0x1F,0x80,0x20,0x40,0x27,0x40,0x29,0x40,0x1F,0x40,0x00,0x00},/*"@",32*/
+{0x00,0x40,0x07,0xC0,0x39,0x00,0x0F,0x00,0x01,0xC0,0x00,0x40},/*"A",33*/
+{0x20,0x40,0x3F,0xC0,0x24,0x40,0x24,0x40,0x1B,0x80,0x00,0x00},/*"B",34*/
+{0x1F,0x80,0x20,0x40,0x20,0x40,0x20,0x40,0x30,0x80,0x00,0x00},/*"C",35*/
+{0x20,0x40,0x3F,0xC0,0x20,0x40,0x20,0x40,0x1F,0x80,0x00,0x00},/*"D",36*/
+{0x20,0x40,0x3F,0xC0,0x24,0x40,0x2E,0x40,0x30,0xC0,0x00,0x00},/*"E",37*/
+{0x20,0x40,0x3F,0xC0,0x24,0x40,0x2E,0x00,0x30,0x00,0x00,0x00},/*"F",38*/
+{0x0F,0x00,0x10,0x80,0x20,0x40,0x22,0x40,0x33,0x80,0x02,0x00},/*"G",39*/
+{0x20,0x40,0x3F,0xC0,0x04,0x00,0x04,0x00,0x3F,0xC0,0x20,0x40},/*"H",40*/
+{0x20,0x40,0x20,0x40,0x3F,0xC0,0x20,0x40,0x20,0x40,0x00,0x00},/*"I",41*/
+{0x00,0x60,0x20,0x20,0x20,0x20,0x3F,0xC0,0x20,0x00,0x20,0x00},/*"J",42*/
+{0x20,0x40,0x3F,0xC0,0x24,0x40,0x0B,0x00,0x30,0xC0,0x20,0x40},/*"K",43*/
+{0x20,0x40,0x3F,0xC0,0x20,0x40,0x00,0x40,0x00,0x40,0x00,0xC0},/*"L",44*/
+{0x3F,0xC0,0x3C,0x00,0x03,0xC0,0x3C,0x00,0x3F,0xC0,0x00,0x00},/*"M",45*/
+{0x20,0x40,0x3F,0xC0,0x0C,0x40,0x23,0x00,0x3F,0xC0,0x20,0x00},/*"N",46*/
+{0x1F,0x80,0x20,0x40,0x20,0x40,0x20,0x40,0x1F,0x80,0x00,0x00},/*"O",47*/
+{0x20,0x40,0x3F,0xC0,0x24,0x40,0x24,0x00,0x18,0x00,0x00,0x00},/*"P",48*/
+{0x1F,0x80,0x21,0x40,0x21,0x40,0x20,0xE0,0x1F,0xA0,0x00,0x00},/*"Q",49*/
+{0x20,0x40,0x3F,0xC0,0x24,0x40,0x26,0x00,0x19,0xC0,0x00,0x40},/*"R",50*/
+{0x18,0xC0,0x24,0x40,0x24,0x40,0x22,0x40,0x31,0x80,0x00,0x00},/*"S",51*/
+{0x30,0x00,0x20,0x40,0x3F,0xC0,0x20,0x40,0x30,0x00,0x00,0x00},/*"T",52*/
+{0x20,0x00,0x3F,0x80,0x00,0x40,0x00,0x40,0x3F,0x80,0x20,0x00},/*"U",53*/
+{0x20,0x00,0x3E,0x00,0x01,0xC0,0x07,0x00,0x38,0x00,0x20,0x00},/*"V",54*/
+{0x38,0x00,0x07,0xC0,0x3C,0x00,0x07,0xC0,0x38,0x00,0x00,0x00},/*"W",55*/
+{0x20,0x40,0x39,0xC0,0x06,0x00,0x39,0xC0,0x20,0x40,0x00,0x00},/*"X",56*/
+{0x20,0x00,0x38,0x40,0x07,0xC0,0x38,0x40,0x20,0x00,0x00,0x00},/*"Y",57*/
+{0x30,0x40,0x21,0xC0,0x26,0x40,0x38,0x40,0x20,0xC0,0x00,0x00},/*"Z",58*/
+{0x00,0x00,0x00,0x00,0x7F,0xE0,0x40,0x20,0x40,0x20,0x00,0x00},/*"[",59*/
+{0x00,0x00,0x70,0x00,0x0C,0x00,0x03,0x80,0x00,0x40,0x00,0x00},/*"\",60*/
+{0x00,0x00,0x40,0x20,0x40,0x20,0x7F,0xE0,0x00,0x00,0x00,0x00},/*"]",61*/
+{0x00,0x00,0x20,0x00,0x40,0x00,0x20,0x00,0x00,0x00,0x00,0x00},/*"^",62*/
+{0x00,0x10,0x00,0x10,0x00,0x10,0x00,0x10,0x00,0x10,0x00,0x10},/*"_",63*/
+{0x00,0x00,0x00,0x00,0x40,0x00,0x00,0x00,0x00,0x00,0x00,0x00},/*"`",64*/
+{0x00,0x00,0x02,0x80,0x05,0x40,0x05,0x40,0x03,0xC0,0x00,0x40},/*"a",65*/
+{0x20,0x00,0x3F,0xC0,0x04,0x40,0x04,0x40,0x03,0x80,0x00,0x00},/*"b",66*/
+{0x00,0x00,0x03,0x80,0x04,0x40,0x04,0x40,0x06,0x40,0x00,0x00},/*"c",67*/
+{0x00,0x00,0x03,0x80,0x04,0x40,0x24,0x40,0x3F,0xC0,0x00,0x40},/*"d",68*/
+{0x00,0x00,0x03,0x80,0x05,0x40,0x05,0x40,0x03,0x40,0x00,0x00},/*"e",69*/
+{0x00,0x00,0x04,0x40,0x1F,0xC0,0x24,0x40,0x24,0x40,0x20,0x00},/*"f",70*/
+{0x00,0x00,0x02,0xE0,0x05,0x50,0x05,0x50,0x06,0x50,0x04,0x20},/*"g",71*/
+{0x20,0x40,0x3F,0xC0,0x04,0x40,0x04,0x00,0x03,0xC0,0x00,0x40},/*"h",72*/
+{0x00,0x00,0x04,0x40,0x27,0xC0,0x00,0x40,0x00,0x00,0x00,0x00},/*"i",73*/
+{0x00,0x10,0x00,0x10,0x04,0x10,0x27,0xE0,0x00,0x00,0x00,0x00},/*"j",74*/
+{0x20,0x40,0x3F,0xC0,0x01,0x40,0x07,0x00,0x04,0xC0,0x04,0x40},/*"k",75*/
+{0x20,0x40,0x20,0x40,0x3F,0xC0,0x00,0x40,0x00,0x40,0x00,0x00},/*"l",76*/
+{0x07,0xC0,0x04,0x00,0x07,0xC0,0x04,0x00,0x03,0xC0,0x00,0x00},/*"m",77*/
+{0x04,0x40,0x07,0xC0,0x04,0x40,0x04,0x00,0x03,0xC0,0x00,0x40},/*"n",78*/
+{0x00,0x00,0x03,0x80,0x04,0x40,0x04,0x40,0x03,0x80,0x00,0x00},/*"o",79*/
+{0x04,0x10,0x07,0xF0,0x04,0x50,0x04,0x40,0x03,0x80,0x00,0x00},/*"p",80*/
+{0x00,0x00,0x03,0x80,0x04,0x40,0x04,0x50,0x07,0xF0,0x00,0x10},/*"q",81*/
+{0x04,0x40,0x07,0xC0,0x02,0x40,0x04,0x00,0x04,0x00,0x00,0x00},/*"r",82*/
+{0x00,0x00,0x06,0x40,0x05,0x40,0x05,0x40,0x04,0xC0,0x00,0x00},/*"s",83*/
+{0x00,0x00,0x04,0x00,0x1F,0x80,0x04,0x40,0x00,0x40,0x00,0x00},/*"t",84*/
+{0x04,0x00,0x07,0x80,0x00,0x40,0x04,0x40,0x07,0xC0,0x00,0x40},/*"u",85*/
+{0x04,0x00,0x07,0x00,0x04,0xC0,0x01,0x80,0x06,0x00,0x04,0x00},/*"v",86*/
+{0x06,0x00,0x01,0xC0,0x07,0x00,0x01,0xC0,0x06,0x00,0x00,0x00},/*"w",87*/
+{0x04,0x40,0x06,0xC0,0x01,0x00,0x06,0xC0,0x04,0x40,0x00,0x00},/*"x",88*/
+{0x04,0x10,0x07,0x10,0x04,0xE0,0x01,0x80,0x06,0x00,0x04,0x00},/*"y",89*/
+{0x00,0x00,0x04,0x40,0x05,0xC0,0x06,0x40,0x04,0x40,0x00,0x00},/*"z",90*/
+{0x00,0x00,0x00,0x00,0x04,0x00,0x7B,0xE0,0x40,0x20,0x00,0x00},/*"{",91*/
+{0x00,0x00,0x00,0x00,0x00,0x00,0xFF,0xF0,0x00,0x00,0x00,0x00},/*"|",92*/
+{0x00,0x00,0x40,0x20,0x7B,0xE0,0x04,0x00,0x00,0x00,0x00,0x00},/*"}",93*/
+{0x40,0x00,0x80,0x00,0x40,0x00,0x20,0x00,0x20,0x00,0x40,0x00},/*"~",94*/
+}; 
+const unsigned char oled_asc2_1608[95][16]={	  
+{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00},/*" ",0*/
+{0x00,0x00,0x00,0x00,0x00,0x00,0x1F,0xCC,0x00,0x0C,0x00,0x00,0x00,0x00,0x00,0x00},/*"!",1*/
+{0x00,0x00,0x08,0x00,0x30,0x00,0x60,0x00,0x08,0x00,0x30,0x00,0x60,0x00,0x00,0x00},/*""",2*/
+{0x02,0x20,0x03,0xFC,0x1E,0x20,0x02,0x20,0x03,0xFC,0x1E,0x20,0x02,0x20,0x00,0x00},/*"#",3*/
+{0x00,0x00,0x0E,0x18,0x11,0x04,0x3F,0xFF,0x10,0x84,0x0C,0x78,0x00,0x00,0x00,0x00},/*"$",4*/
+{0x0F,0x00,0x10,0x84,0x0F,0x38,0x00,0xC0,0x07,0x78,0x18,0x84,0x00,0x78,0x00,0x00},/*"%",5*/
+{0x00,0x78,0x0F,0x84,0x10,0xC4,0x11,0x24,0x0E,0x98,0x00,0xE4,0x00,0x84,0x00,0x08},/*"&",6*/
+{0x08,0x00,0x68,0x00,0x70,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00},/*"'",7*/
+{0x00,0x00,0x00,0x00,0x00,0x00,0x07,0xE0,0x18,0x18,0x20,0x04,0x40,0x02,0x00,0x00},/*"(",8*/
+{0x00,0x00,0x40,0x02,0x20,0x04,0x18,0x18,0x07,0xE0,0x00,0x00,0x00,0x00,0x00,0x00},/*")",9*/
+{0x02,0x40,0x02,0x40,0x01,0x80,0x0F,0xF0,0x01,0x80,0x02,0x40,0x02,0x40,0x00,0x00},/*"*",10*/
+{0x00,0x80,0x00,0x80,0x00,0x80,0x0F,0xF8,0x00,0x80,0x00,0x80,0x00,0x80,0x00,0x00},/*"+",11*/
+{0x00,0x01,0x00,0x0D,0x00,0x0E,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00},/*",",12*/
+{0x00,0x00,0x00,0x80,0x00,0x80,0x00,0x80,0x00,0x80,0x00,0x80,0x00,0x80,0x00,0x80},/*"-",13*/
+{0x00,0x00,0x00,0x0C,0x00,0x0C,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00},/*".",14*/
+{0x00,0x00,0x00,0x06,0x00,0x18,0x00,0x60,0x01,0x80,0x06,0x00,0x18,0x00,0x20,0x00},/*"/",15*/
+{0x00,0x00,0x07,0xF0,0x08,0x08,0x10,0x04,0x10,0x04,0x08,0x08,0x07,0xF0,0x00,0x00},/*"0",16*/
+{0x00,0x00,0x08,0x04,0x08,0x04,0x1F,0xFC,0x00,0x04,0x00,0x04,0x00,0x00,0x00,0x00},/*"1",17*/
+{0x00,0x00,0x0E,0x0C,0x10,0x14,0x10,0x24,0x10,0x44,0x11,0x84,0x0E,0x0C,0x00,0x00},/*"2",18*/
+{0x00,0x00,0x0C,0x18,0x10,0x04,0x11,0x04,0x11,0x04,0x12,0x88,0x0C,0x70,0x00,0x00},/*"3",19*/
+{0x00,0x00,0x00,0xE0,0x03,0x20,0x04,0x24,0x08,0x24,0x1F,0xFC,0x00,0x24,0x00,0x00},/*"4",20*/
+{0x00,0x00,0x1F,0x98,0x10,0x84,0x11,0x04,0x11,0x04,0x10,0x88,0x10,0x70,0x00,0x00},/*"5",21*/
+{0x00,0x00,0x07,0xF0,0x08,0x88,0x11,0x04,0x11,0x04,0x18,0x88,0x00,0x70,0x00,0x00},/*"6",22*/
+{0x00,0x00,0x1C,0x00,0x10,0x00,0x10,0xFC,0x13,0x00,0x1C,0x00,0x10,0x00,0x00,0x00},/*"7",23*/
+{0x00,0x00,0x0E,0x38,0x11,0x44,0x10,0x84,0x10,0x84,0x11,0x44,0x0E,0x38,0x00,0x00},/*"8",24*/
+{0x00,0x00,0x07,0x00,0x08,0x8C,0x10,0x44,0x10,0x44,0x08,0x88,0x07,0xF0,0x00,0x00},/*"9",25*/
+{0x00,0x00,0x00,0x00,0x00,0x00,0x03,0x0C,0x03,0x0C,0x00,0x00,0x00,0x00,0x00,0x00},/*":",26*/
+{0x00,0x00,0x00,0x00,0x00,0x01,0x01,0x06,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00},/*";",27*/
+{0x00,0x00,0x00,0x80,0x01,0x40,0x02,0x20,0x04,0x10,0x08,0x08,0x10,0x04,0x00,0x00},/*"<",28*/
+{0x02,0x20,0x02,0x20,0x02,0x20,0x02,0x20,0x02,0x20,0x02,0x20,0x02,0x20,0x00,0x00},/*"=",29*/
+{0x00,0x00,0x10,0x04,0x08,0x08,0x04,0x10,0x02,0x20,0x01,0x40,0x00,0x80,0x00,0x00},/*">",30*/
+{0x00,0x00,0x0E,0x00,0x12,0x00,0x10,0x0C,0x10,0x6C,0x10,0x80,0x0F,0x00,0x00,0x00},/*"?",31*/
+{0x03,0xE0,0x0C,0x18,0x13,0xE4,0x14,0x24,0x17,0xC4,0x08,0x28,0x07,0xD0,0x00,0x00},/*"@",32*/
+{0x00,0x04,0x00,0x3C,0x03,0xC4,0x1C,0x40,0x07,0x40,0x00,0xE4,0x00,0x1C,0x00,0x04},/*"A",33*/
+{0x10,0x04,0x1F,0xFC,0x11,0x04,0x11,0x04,0x11,0x04,0x0E,0x88,0x00,0x70,0x00,0x00},/*"B",34*/
+{0x03,0xE0,0x0C,0x18,0x10,0x04,0x10,0x04,0x10,0x04,0x10,0x08,0x1C,0x10,0x00,0x00},/*"C",35*/
+{0x10,0x04,0x1F,0xFC,0x10,0x04,0x10,0x04,0x10,0x04,0x08,0x08,0x07,0xF0,0x00,0x00},/*"D",36*/
+{0x10,0x04,0x1F,0xFC,0x11,0x04,0x11,0x04,0x17,0xC4,0x10,0x04,0x08,0x18,0x00,0x00},/*"E",37*/
+{0x10,0x04,0x1F,0xFC,0x11,0x04,0x11,0x00,0x17,0xC0,0x10,0x00,0x08,0x00,0x00,0x00},/*"F",38*/
+{0x03,0xE0,0x0C,0x18,0x10,0x04,0x10,0x04,0x10,0x44,0x1C,0x78,0x00,0x40,0x00,0x00},/*"G",39*/
+{0x10,0x04,0x1F,0xFC,0x10,0x84,0x00,0x80,0x00,0x80,0x10,0x84,0x1F,0xFC,0x10,0x04},/*"H",40*/
+{0x00,0x00,0x10,0x04,0x10,0x04,0x1F,0xFC,0x10,0x04,0x10,0x04,0x00,0x00,0x00,0x00},/*"I",41*/
+{0x00,0x03,0x00,0x01,0x10,0x01,0x10,0x01,0x1F,0xFE,0x10,0x00,0x10,0x00,0x00,0x00},/*"J",42*/
+{0x10,0x04,0x1F,0xFC,0x11,0x04,0x03,0x80,0x14,0x64,0x18,0x1C,0x10,0x04,0x00,0x00},/*"K",43*/
+{0x10,0x04,0x1F,0xFC,0x10,0x04,0x00,0x04,0x00,0x04,0x00,0x04,0x00,0x0C,0x00,0x00},/*"L",44*/
+{0x10,0x04,0x1F,0xFC,0x1F,0x00,0x00,0xFC,0x1F,0x00,0x1F,0xFC,0x10,0x04,0x00,0x00},/*"M",45*/
+{0x10,0x04,0x1F,0xFC,0x0C,0x04,0x03,0x00,0x00,0xE0,0x10,0x18,0x1F,0xFC,0x10,0x00},/*"N",46*/
+{0x07,0xF0,0x08,0x08,0x10,0x04,0x10,0x04,0x10,0x04,0x08,0x08,0x07,0xF0,0x00,0x00},/*"O",47*/
+{0x10,0x04,0x1F,0xFC,0x10,0x84,0x10,0x80,0x10,0x80,0x10,0x80,0x0F,0x00,0x00,0x00},/*"P",48*/
+{0x07,0xF0,0x08,0x18,0x10,0x24,0x10,0x24,0x10,0x1C,0x08,0x0A,0x07,0xF2,0x00,0x00},/*"Q",49*/
+{0x10,0x04,0x1F,0xFC,0x11,0x04,0x11,0x00,0x11,0xC0,0x11,0x30,0x0E,0x0C,0x00,0x04},/*"R",50*/
+{0x00,0x00,0x0E,0x1C,0x11,0x04,0x10,0x84,0x10,0x84,0x10,0x44,0x1C,0x38,0x00,0x00},/*"S",51*/
+{0x18,0x00,0x10,0x00,0x10,0x04,0x1F,0xFC,0x10,0x04,0x10,0x00,0x18,0x00,0x00,0x00},/*"T",52*/
+{0x10,0x00,0x1F,0xF8,0x10,0x04,0x00,0x04,0x00,0x04,0x10,0x04,0x1F,0xF8,0x10,0x00},/*"U",53*/
+{0x10,0x00,0x1E,0x00,0x11,0xE0,0x00,0x1C,0x00,0x70,0x13,0x80,0x1C,0x00,0x10,0x00},/*"V",54*/
+{0x1F,0xC0,0x10,0x3C,0x00,0xE0,0x1F,0x00,0x00,0xE0,0x10,0x3C,0x1F,0xC0,0x00,0x00},/*"W",55*/
+{0x10,0x04,0x18,0x0C,0x16,0x34,0x01,0xC0,0x01,0xC0,0x16,0x34,0x18,0x0C,0x10,0x04},/*"X",56*/
+{0x10,0x00,0x1C,0x00,0x13,0x04,0x00,0xFC,0x13,0x04,0x1C,0x00,0x10,0x00,0x00,0x00},/*"Y",57*/
+{0x08,0x04,0x10,0x1C,0x10,0x64,0x10,0x84,0x13,0x04,0x1C,0x04,0x10,0x18,0x00,0x00},/*"Z",58*/
+{0x00,0x00,0x00,0x00,0x00,0x00,0x7F,0xFE,0x40,0x02,0x40,0x02,0x40,0x02,0x00,0x00},/*"[",59*/
+{0x00,0x00,0x30,0x00,0x0C,0x00,0x03,0x80,0x00,0x60,0x00,0x1C,0x00,0x03,0x00,0x00},/*"\",60*/
+{0x00,0x00,0x40,0x02,0x40,0x02,0x40,0x02,0x7F,0xFE,0x00,0x00,0x00,0x00,0x00,0x00},/*"]",61*/
+{0x00,0x00,0x00,0x00,0x20,0x00,0x40,0x00,0x40,0x00,0x40,0x00,0x20,0x00,0x00,0x00},/*"^",62*/
+{0x00,0x01,0x00,0x01,0x00,0x01,0x00,0x01,0x00,0x01,0x00,0x01,0x00,0x01,0x00,0x01},/*"_",63*/
+{0x00,0x00,0x40,0x00,0x40,0x00,0x20,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00},/*"`",64*/
+{0x00,0x00,0x00,0x98,0x01,0x24,0x01,0x44,0x01,0x44,0x01,0x44,0x00,0xFC,0x00,0x04},/*"a",65*/
+{0x10,0x00,0x1F,0xFC,0x00,0x88,0x01,0x04,0x01,0x04,0x00,0x88,0x00,0x70,0x00,0x00},/*"b",66*/
+{0x00,0x00,0x00,0x70,0x00,0x88,0x01,0x04,0x01,0x04,0x01,0x04,0x00,0x88,0x00,0x00},/*"c",67*/
+{0x00,0x00,0x00,0x70,0x00,0x88,0x01,0x04,0x01,0x04,0x11,0x08,0x1F,0xFC,0x00,0x04},/*"d",68*/
+{0x00,0x00,0x00,0xF8,0x01,0x44,0x01,0x44,0x01,0x44,0x01,0x44,0x00,0xC8,0x00,0x00},/*"e",69*/
+{0x00,0x00,0x01,0x04,0x01,0x04,0x0F,0xFC,0x11,0x04,0x11,0x04,0x11,0x00,0x18,0x00},/*"f",70*/
+{0x00,0x00,0x00,0xD6,0x01,0x29,0x01,0x29,0x01,0x29,0x01,0xC9,0x01,0x06,0x00,0x00},/*"g",71*/
+{0x10,0x04,0x1F,0xFC,0x00,0x84,0x01,0x00,0x01,0x00,0x01,0x04,0x00,0xFC,0x00,0x04},/*"h",72*/
+{0x00,0x00,0x01,0x04,0x19,0x04,0x19,0xFC,0x00,0x04,0x00,0x04,0x00,0x00,0x00,0x00},/*"i",73*/
+{0x00,0x00,0x00,0x03,0x00,0x01,0x01,0x01,0x19,0x01,0x19,0xFE,0x00,0x00,0x00,0x00},/*"j",74*/
+{0x10,0x04,0x1F,0xFC,0x00,0x24,0x00,0x40,0x01,0xB4,0x01,0x0C,0x01,0x04,0x00,0x00},/*"k",75*/
+{0x00,0x00,0x10,0x04,0x10,0x04,0x1F,0xFC,0x00,0x04,0x00,0x04,0x00,0x00,0x00,0x00},/*"l",76*/
+{0x01,0x04,0x01,0xFC,0x01,0x04,0x01,0x00,0x01,0xFC,0x01,0x04,0x01,0x00,0x00,0xFC},/*"m",77*/
+{0x01,0x04,0x01,0xFC,0x00,0x84,0x01,0x00,0x01,0x00,0x01,0x04,0x00,0xFC,0x00,0x04},/*"n",78*/
+{0x00,0x00,0x00,0xF8,0x01,0x04,0x01,0x04,0x01,0x04,0x01,0x04,0x00,0xF8,0x00,0x00},/*"o",79*/
+{0x01,0x01,0x01,0xFF,0x00,0x85,0x01,0x04,0x01,0x04,0x00,0x88,0x00,0x70,0x00,0x00},/*"p",80*/
+{0x00,0x00,0x00,0x70,0x00,0x88,0x01,0x04,0x01,0x04,0x01,0x05,0x01,0xFF,0x00,0x01},/*"q",81*/
+{0x01,0x04,0x01,0x04,0x01,0xFC,0x00,0x84,0x01,0x04,0x01,0x00,0x01,0x80,0x00,0x00},/*"r",82*/
+{0x00,0x00,0x00,0xCC,0x01,0x24,0x01,0x24,0x01,0x24,0x01,0x24,0x01,0x98,0x00,0x00},/*"s",83*/
+{0x00,0x00,0x01,0x00,0x01,0x00,0x07,0xF8,0x01,0x04,0x01,0x04,0x00,0x00,0x00,0x00},/*"t",84*/
+{0x01,0x00,0x01,0xF8,0x00,0x04,0x00,0x04,0x00,0x04,0x01,0x08,0x01,0xFC,0x00,0x04},/*"u",85*/
+{0x01,0x00,0x01,0x80,0x01,0x70,0x00,0x0C,0x00,0x10,0x01,0x60,0x01,0x80,0x01,0x00},/*"v",86*/
+{0x01,0xF0,0x01,0x0C,0x00,0x30,0x01,0xC0,0x00,0x30,0x01,0x0C,0x01,0xF0,0x01,0x00},/*"w",87*/
+{0x00,0x00,0x01,0x04,0x01,0x8C,0x00,0x74,0x01,0x70,0x01,0x8C,0x01,0x04,0x00,0x00},/*"x",88*/
+{0x01,0x01,0x01,0x81,0x01,0x71,0x00,0x0E,0x00,0x18,0x01,0x60,0x01,0x80,0x01,0x00},/*"y",89*/
+{0x00,0x00,0x01,0x84,0x01,0x0C,0x01,0x34,0x01,0x44,0x01,0x84,0x01,0x0C,0x00,0x00},/*"z",90*/
+{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x01,0x00,0x3E,0xFC,0x40,0x02,0x40,0x02},/*"{",91*/
+{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0xFF,0xFF,0x00,0x00,0x00,0x00,0x00,0x00},/*"|",92*/
+{0x00,0x00,0x40,0x02,0x40,0x02,0x3E,0xFC,0x01,0x00,0x00,0x00,0x00,0x00,0x00,0x00},/*"}",93*/
+{0x00,0x00,0x60,0x00,0x80,0x00,0x80,0x00,0x40,0x00,0x40,0x00,0x20,0x00,0x20,0x00},/*"~",94*/
+};   
+
+const unsigned char Hzk16[164][16]=
+{
+	 //按下用户按键确认开始自检无操作秒后退出正在自检，秒后完成轴角速度自检完成错误代码
+	
+	 //16*16
+	{0x40,0x42,0x81,0xFE,0x00,0x00,0x01,0x21,0xD2,0x14,0x08,0x14,0xE2,0x01,0x00,0x00},
+	{0x08,0x08,0x08,0xFF,0x09,0x04,0x19,0x11,0x11,0x97,0x71,0x11,0x11,0x15,0x19,0x00},/*"按",0*/
+	{0x00,0x00,0x00,0x00,0x00,0x00,0xFF,0x00,0x00,0x00,0x00,0x80,0x60,0x00,0x00,0x00},
+	{0x40,0x40,0x40,0x40,0x40,0x40,0x7F,0x40,0x40,0x42,0x41,0x40,0x40,0x40,0x40,0x00},/*"下",1*/
+	{0x01,0x06,0xF8,0x40,0x40,0x40,0x40,0xFE,0x40,0x40,0x42,0x41,0xFE,0x00,0x00,0x00},
+	{0x00,0x00,0x7F,0x44,0x44,0x44,0x44,0x7F,0x44,0x44,0x44,0x44,0x7F,0x00,0x00,0x00},/*"用",2*/
+	{0x00,0x01,0x06,0xF8,0x80,0x80,0x80,0x80,0x80,0x80,0x80,0x80,0xC0,0x00,0x00,0x00},
+	{0x00,0x00,0x00,0x1F,0x10,0x10,0x90,0x70,0x10,0x10,0x10,0x10,0x1F,0x00,0x00,0x00},/*"户",3*/
+	{0x40,0x42,0x81,0xFE,0x00,0x00,0x01,0x21,0xD2,0x14,0x08,0x14,0xE2,0x01,0x00,0x00},
+	{0x08,0x08,0x08,0xFF,0x09,0x04,0x19,0x11,0x11,0x97,0x71,0x11,0x11,0x15,0x19,0x00},/*"按",4*/
+	{0x80,0x80,0xFE,0x84,0x8A,0x64,0x18,0xE4,0x22,0xA2,0xA2,0xFA,0xA2,0xA2,0x22,0x00},
+	{0x02,0x0C,0xF7,0x24,0x24,0x01,0x27,0x39,0x08,0x2A,0x2A,0xFF,0x2A,0x3E,0x08,0x00},/*"键",5*/
+	{0x40,0x80,0xFE,0x08,0x08,0xFC,0x01,0x06,0xF8,0x90,0x90,0xFC,0x92,0x91,0xFE,0x00},
+	{0x20,0x21,0x27,0x3A,0x22,0x23,0x04,0x08,0x17,0xE4,0x24,0x27,0x2C,0x34,0x07,0x00},/*"确",6*/
+	{0x00,0x00,0x00,0xFC,0x09,0x12,0x04,0x18,0xE0,0x00,0xE0,0x18,0x04,0x02,0x01,0x00},
+	{0x02,0x02,0x42,0x33,0x00,0x00,0x00,0x00,0x00,0xFF,0x00,0x00,0x00,0x00,0x00,0x00},/*"认",7*/
+	{0x00,0x01,0x02,0x0C,0xF0,0x00,0x00,0x00,0x00,0x00,0xFF,0x00,0x00,0x00,0x00,0x00},
+	{0x01,0x41,0x41,0x41,0x7F,0x41,0x41,0x41,0x41,0x41,0x7F,0x41,0x41,0x41,0x01,0x00},/*"开",8*/
+	{0x02,0x44,0xA8,0x10,0x68,0x84,0x00,0x00,0x7F,0x42,0x42,0x42,0x42,0x7F,0x00,0x00},
+	{0x08,0x08,0x0F,0xF8,0x08,0x0F,0x00,0x02,0x07,0x1A,0xE2,0x02,0x0A,0x06,0x03,0x00},/*"始",9*/
+	{0x00,0x00,0x00,0xFF,0x22,0x22,0x22,0x22,0x22,0x22,0x22,0xFF,0x00,0x00,0x00,0x00},
+	{0x00,0x00,0x00,0x1F,0x11,0x31,0x51,0x91,0x11,0x11,0x11,0x1F,0x00,0x00,0x00,0x00},/*"自",10*/
+	{0x20,0xC0,0x00,0xFF,0x00,0x82,0x22,0x1A,0x82,0x72,0x06,0x1A,0xE2,0x02,0x02,0x00},
+	{0x08,0x08,0x0B,0xFF,0x09,0x0A,0x04,0x0A,0x32,0xC2,0x32,0x0A,0x04,0x02,0x02,0x00},/*"检",11*/
+
+	{0x01,0x02,0x04,0x08,0x30,0xC0,0x00,0x00,0xFC,0x02,0x02,0x02,0x02,0x0E,0x00,0x00},
+	{0x00,0x02,0x42,0x42,0x42,0x43,0x7E,0x42,0x43,0x42,0x42,0x42,0x02,0x02,0x00,0x00},/*"无",12*/
+	{0x42,0x41,0xFE,0x82,0x22,0xA4,0xA8,0xB0,0xA0,0x7F,0xB0,0xA8,0xA4,0xA2,0x22,0x00},
+	{0x08,0x08,0xFF,0x08,0x09,0x07,0xF4,0x94,0x97,0x90,0x97,0x94,0xF4,0x07,0x00,0x00},/*"操",13*/
+	{0x80,0x00,0x00,0xFF,0x00,0x00,0x00,0x00,0xFF,0x10,0x10,0x10,0x10,0x10,0x00,0x00},
+	{0x00,0x01,0x06,0x1F,0xE0,0x02,0x0C,0xF0,0x1F,0x11,0x11,0x11,0x11,0x10,0x10,0x00},/*"作",14*/
+	{0x10,0x60,0x80,0xFF,0x80,0x60,0x81,0x01,0x02,0x02,0xE4,0x08,0x30,0xC0,0x00,0x00},
+	{0x24,0x24,0x25,0x7F,0xC4,0x44,0x00,0x03,0x1C,0x00,0xFF,0x00,0x10,0x08,0x06,0x00},/*"秒",15*/
+	{0x02,0x04,0x18,0xE0,0x00,0x7F,0x42,0x42,0x42,0x42,0x42,0x42,0x7F,0x00,0x00,0x00},
+	{0x00,0x00,0x00,0x3F,0x24,0x24,0x24,0x24,0x44,0x44,0x44,0xC4,0x44,0x04,0x04,0x00},/*"后",16*/
+	{0x00,0x02,0x04,0xF8,0x04,0x02,0xFA,0x12,0x22,0x02,0x82,0x42,0xA2,0x1A,0x02,0x00},
+	{0x02,0x02,0x42,0x33,0x00,0x00,0xFF,0x92,0x92,0x93,0x92,0x92,0xFE,0x01,0x00,0x00},/*"退",17*/
+	{0x00,0x3E,0x02,0x02,0x02,0x02,0x02,0xFE,0x02,0x02,0x02,0x02,0x02,0x3F,0x00,0x00},
+	{0x00,0x00,0x3E,0x02,0x02,0x02,0x02,0xFF,0x02,0x02,0x02,0x02,0x3F,0x00,0x00,0x00},/*"出",18*/
+
+	{0x02,0x02,0x02,0xFE,0x02,0x02,0x02,0xFE,0x02,0x02,0x02,0x02,0x02,0x02,0x02,0x00},
+	{0x00,0x40,0x40,0x43,0x40,0x40,0x40,0x7F,0x41,0x41,0x41,0x41,0x41,0x40,0x00,0x00},/*"正",19*/
+	{0x40,0x80,0x00,0xFF,0x02,0x82,0x82,0x82,0x82,0xFE,0x82,0x82,0x82,0x82,0x02,0x00},
+	{0x10,0x10,0x11,0x13,0x1C,0x30,0xD0,0x10,0x10,0x17,0x10,0x10,0x10,0x10,0x10,0x00},/*"在",20*/
+	{0x00,0x00,0x00,0xFF,0x22,0x22,0x22,0x22,0x22,0x22,0x22,0xFF,0x00,0x00,0x00,0x00},
+	{0x00,0x00,0x00,0x1F,0x11,0x31,0x51,0x91,0x11,0x11,0x11,0x1F,0x00,0x00,0x00,0x00},/*"自",21*/
+	{0x20,0xC0,0x00,0xFF,0x00,0x82,0x22,0x1A,0x82,0x72,0x06,0x1A,0xE2,0x02,0x02,0x00},
+	{0x08,0x08,0x0B,0xFF,0x09,0x0A,0x04,0x0A,0x32,0xC2,0x32,0x0A,0x04,0x02,0x02,0x00},/*"检",22*/
+	{0x00,0x00,0x1A,0x1C,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00},
+	{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00},/*"，",23*/
+	{0x10,0x60,0x80,0xFF,0x80,0x60,0x81,0x01,0x02,0x02,0xE4,0x08,0x30,0xC0,0x00,0x00},
+	{0x24,0x24,0x25,0x7F,0xC4,0x44,0x00,0x03,0x1C,0x00,0xFF,0x00,0x10,0x08,0x06,0x00},/*"秒",24*/
+	{0x02,0x04,0x18,0xE0,0x00,0x7F,0x42,0x42,0x42,0x42,0x42,0x42,0x7F,0x00,0x00,0x00},
+	{0x00,0x00,0x00,0x3F,0x24,0x24,0x24,0x24,0x44,0x44,0x44,0xC4,0x44,0x04,0x04,0x00},/*"后",25*/
+	{0x00,0x81,0x81,0x82,0x8C,0xF0,0x80,0x80,0x80,0xFE,0x81,0x81,0x81,0x8F,0x00,0x00},
+	{0x08,0x30,0x20,0x24,0x24,0x24,0xA4,0x64,0x24,0x24,0x24,0x24,0x20,0x28,0x30,0x00},/*"完",26*/
+	{0x01,0x06,0xF8,0x00,0x08,0x04,0xF8,0x01,0x02,0x84,0x68,0x18,0x64,0x82,0x1F,0x00},
+	{0x00,0x00,0x1F,0x11,0x11,0x11,0x11,0x10,0x10,0xFF,0x10,0x90,0x50,0x13,0x10,0x00},/*"成",27*/
+
+	{0x10,0x18,0x10,0xFF,0x20,0x20,0x00,0xFF,0x42,0x42,0xFE,0x42,0x42,0xFF,0x00,0x00},
+	{0x13,0x1D,0xF1,0x17,0x11,0x11,0x00,0x0F,0x08,0x08,0xFF,0x08,0x08,0x0F,0x00,0x00},/*"轴",28*/
+	{0x01,0x06,0xF8,0x90,0x90,0x90,0x90,0xFE,0x90,0x90,0x92,0x91,0xFE,0x00,0x00,0x00},
+	{0x04,0x08,0x17,0x24,0xE4,0x24,0x24,0x27,0x24,0x2C,0x34,0x04,0x07,0x00,0x00,0x00},/*"角",29*/
+	{0x00,0x02,0x04,0xF8,0x04,0x12,0x22,0x42,0x82,0xFA,0x82,0x42,0x22,0x12,0x02,0x00},
+	{0x02,0x02,0x42,0x33,0x00,0x20,0x2F,0x29,0x29,0xFF,0x29,0x29,0x2F,0x20,0x00,0x00},/*"速",30*/
+	{0x02,0x0C,0xF1,0x01,0x21,0x32,0xAA,0xA4,0xA4,0xA4,0xAA,0x32,0x01,0x01,0x01,0x00},
+	{0x00,0x00,0x3F,0x24,0x24,0x24,0x3F,0xA4,0x64,0x24,0x3F,0x24,0x24,0x24,0x20,0x00},/*"度",31*/
+
+	{0x00,0x00,0x00,0xFF,0x22,0x22,0x22,0x22,0x22,0x22,0x22,0xFF,0x00,0x00,0x00,0x00},
+	{0x00,0x00,0x00,0x1F,0x11,0x31,0x51,0x91,0x11,0x11,0x11,0x1F,0x00,0x00,0x00,0x00},/*"自",32*/
+	{0x20,0xC0,0x00,0xFF,0x00,0x82,0x22,0x1A,0x82,0x72,0x06,0x1A,0xE2,0x02,0x02,0x00},
+	{0x08,0x08,0x0B,0xFF,0x09,0x0A,0x04,0x0A,0x32,0xC2,0x32,0x0A,0x04,0x02,0x02,0x00},/*"检",33*/
+	{0x00,0x81,0x81,0x82,0x8C,0xF0,0x80,0x80,0x80,0xFE,0x81,0x81,0x81,0x8F,0x00,0x00},
+	{0x08,0x30,0x20,0x24,0x24,0x24,0xA4,0x64,0x24,0x24,0x24,0x24,0x20,0x28,0x30,0x00},/*"完",34*/
+	{0x01,0x06,0xF8,0x00,0x08,0x04,0xF8,0x01,0x02,0x84,0x68,0x18,0x64,0x82,0x1F,0x00},
+	{0x00,0x00,0x1F,0x11,0x11,0x11,0x11,0x10,0x10,0xFF,0x10,0x90,0x50,0x13,0x10,0x00},/*"成",35*/
+
+	{0x80,0x80,0xFE,0x84,0x88,0x00,0xFF,0x92,0x92,0x92,0x92,0x92,0xFF,0x00,0x00,0x00},
+	{0x02,0x0C,0xF7,0x24,0x26,0x12,0x12,0xFE,0x12,0x12,0x12,0xFE,0x12,0x12,0x02,0x00},/*"错",36*/
+	{0x00,0x00,0xFE,0x04,0x29,0x21,0x22,0x24,0x28,0xF0,0x28,0x24,0x22,0x21,0x21,0x00},
+	{0x02,0x42,0x33,0x00,0x00,0x01,0x79,0x49,0x49,0x49,0x49,0x49,0x79,0x01,0x00,0x00},/*"误",37*/
+	{0x80,0x00,0x00,0xFF,0x00,0x00,0x00,0x00,0x00,0xC0,0x30,0x08,0x04,0x02,0x1F,0x00},
+	{0x00,0x01,0x06,0x1F,0xE0,0x04,0x04,0x04,0xFE,0x05,0x08,0x88,0x68,0x08,0x08,0x00},/*"代",38*/
+	{0x40,0x80,0xFE,0x08,0x08,0xFC,0x00,0x10,0x10,0x10,0x10,0x12,0x11,0x02,0xFC,0x00},
+	{0x20,0x21,0x27,0x3A,0x22,0x23,0x00,0x40,0x4F,0x41,0x41,0x41,0x7F,0x01,0x01,0x00},/*"码",39*/
+	
+	{0x00,0x00,0xF8,0x10,0x10,0x10,0x10,0xFE,0x11,0x11,0x11,0x11,0xF9,0x01,0x0F,0x00},
+	{0x00,0x00,0x1F,0x11,0x11,0x11,0x11,0xFF,0x11,0x11,0x11,0x11,0x1F,0x00,0x00,0x00},/*"电",40*/
+	{0x01,0x06,0xF8,0x02,0x02,0x02,0x02,0x02,0xFE,0x02,0x02,0x22,0x1A,0x02,0x02,0x00},
+	{0x00,0x00,0x7F,0x40,0x41,0x41,0x41,0x41,0x5F,0x41,0x41,0x41,0x41,0x41,0x40,0x00},/*"压",41*/
+	{0x00,0x02,0x04,0xF8,0x04,0x02,0x02,0x82,0x02,0x12,0x0A,0xF2,0x02,0x02,0x02,0x00},
+	{0x02,0x02,0x42,0x33,0x00,0x10,0x12,0x11,0x10,0x10,0x10,0xFF,0x10,0x10,0x10,0x00},/*"过",42*/
+	{0x80,0x00,0x00,0xFF,0x00,0x00,0xFF,0x02,0x04,0x00,0x82,0x71,0x0C,0x02,0x1F,0x00},
+	{0x00,0x01,0x06,0x1F,0xE0,0x00,0x3F,0x21,0x21,0x21,0x7F,0x41,0xC1,0x41,0x01,0x00},/*"低",43*/
+	
+	{0x00,0x00,0xFF,0x00,0x01,0x81,0xA2,0x94,0x88,0xF4,0x82,0x82,0x81,0x81,0x01,0x00},
+	{0x01,0x06,0x1F,0xE0,0x20,0x27,0x24,0x24,0x24,0xFF,0x24,0x24,0x24,0x27,0x20,0x00},/*"使",44*/
+	{0x00,0xFF,0x48,0x48,0x4A,0x49,0xFE,0x00,0x00,0x7E,0x11,0x11,0x21,0x41,0x07,0x00},
+	{0x10,0x33,0x52,0x92,0x12,0x52,0x33,0x18,0x00,0xFE,0x11,0x11,0x21,0x41,0x07,0x00},/*"能",45*/
+	{0x00,0x01,0x02,0x0C,0xF0,0x00,0x00,0x00,0x00,0x00,0xFF,0x00,0x00,0x00,0x00,0x00},
+	{0x01,0x41,0x41,0x41,0x7F,0x41,0x41,0x41,0x41,0x41,0x7F,0x41,0x41,0x41,0x01,0x00},/*"开",46*/
+	{0x81,0x81,0x82,0x82,0x84,0x88,0xB0,0xC0,0xB0,0x88,0x84,0x82,0x82,0x81,0x81,0x00},
+	{0x00,0x00,0x08,0x88,0x68,0x08,0x08,0x0F,0x08,0x08,0x28,0xC8,0x08,0x00,0x00,0x00},/*"关",47*/
+	{0x81,0x81,0x82,0x82,0x84,0x88,0xB0,0xC0,0xB0,0x88,0x84,0x82,0x82,0x81,0x81,0x00},
+	{0x00,0x00,0x08,0x88,0x68,0x08,0x08,0x0F,0x08,0x08,0x28,0xC8,0x08,0x00,0x00,0x00},/*"关",48*/
+	{0x00,0xFF,0x00,0x10,0x20,0x40,0x88,0x04,0xF8,0x00,0x00,0x02,0x01,0xFE,0x00,0x00},
+	{0x00,0x1F,0x80,0x44,0x04,0x44,0x44,0x45,0x5F,0x44,0x44,0x44,0x40,0x7F,0x00,0x00},/*"闭",49*/
+	
+	{0x10,0x18,0x12,0x21,0x22,0xFC,0x00,0xFE,0x0A,0x12,0x62,0x82,0x62,0x1A,0x02,0x00},
+	{0x40,0x5F,0x41,0x41,0x7F,0x01,0x00,0x7F,0x40,0x48,0x46,0x41,0x46,0x58,0x40,0x00},/*"驱",49*/
+	{0x08,0x3C,0xC8,0x08,0x28,0x1D,0x02,0x0C,0x70,0x80,0x02,0x01,0x02,0xFC,0x00,0x00},
+	{0x02,0x22,0x23,0x22,0x22,0x22,0x02,0x08,0x08,0xFF,0x08,0x08,0x08,0x0F,0x00,0x00},/*"动",50*/
+	{0x44,0xE6,0x44,0x48,0x48,0x48,0x02,0x02,0x04,0xC8,0x30,0x28,0x44,0x82,0x1F,0x00},
+	{0x04,0x0C,0x35,0xC6,0x04,0x18,0x01,0x09,0x09,0xFF,0x09,0x92,0x52,0x12,0x02,0x00},/*"线",51*/
+	{0x02,0x0C,0xF1,0x01,0x02,0x02,0xC4,0x28,0x10,0x28,0x44,0x82,0x02,0x01,0x01,0x00},
+	{0x00,0x00,0x3F,0x24,0x24,0x27,0x24,0x24,0x44,0x44,0x44,0xC5,0x46,0x00,0x00,0x00},/*"反",52*/
+	{0x20,0x22,0x41,0xFE,0x80,0x41,0x41,0x52,0x6A,0xC4,0x44,0x4A,0x72,0x41,0x40,0x00},
+	{0x08,0x08,0x08,0xFF,0x08,0x0A,0x22,0x2A,0xA6,0x63,0x22,0x26,0x2A,0x22,0x02,0x00},/*"接",53*/
+	
+	{0x10,0x18,0x12,0x21,0x22,0xFC,0x00,0xFE,0x0A,0x12,0x62,0x82,0x62,0x1A,0x02,0x00},
+	{0x40,0x5F,0x41,0x41,0x7F,0x01,0x00,0x7F,0x40,0x48,0x46,0x41,0x46,0x58,0x40,0x00},/*"驱",54*/
+	{0x08,0x3C,0xC8,0x08,0x28,0x1D,0x02,0x0C,0x70,0x80,0x02,0x01,0x02,0xFC,0x00,0x00},
+	{0x02,0x22,0x23,0x22,0x22,0x22,0x02,0x08,0x08,0xFF,0x08,0x08,0x08,0x0F,0x00,0x00},/*"动",55*/
+	{0x20,0x22,0x41,0xFE,0x80,0x00,0x01,0xF1,0x02,0x0C,0xF0,0x08,0x04,0xF3,0x00,0x00},
+	{0x08,0x08,0x08,0xFF,0x08,0x09,0x00,0x03,0x7A,0x4A,0x4A,0x4A,0x7A,0x03,0x00,0x00},/*"损",56*/
+	{0x10,0x18,0x10,0xE0,0x20,0x28,0x10,0x20,0x40,0x80,0xFF,0x00,0x00,0xC0,0x30,0x00},
+	{0x04,0x04,0x04,0xFF,0x04,0x04,0x20,0x20,0x20,0x21,0x27,0x38,0x21,0x20,0x20,0x00},/*"坏",57*/
+	
+	{0x44,0xE6,0x44,0x48,0x4A,0x1C,0xE0,0xFF,0x90,0xFE,0x90,0xFC,0x91,0xFF,0x00,0x00},
+	{0x04,0x0C,0x35,0xC6,0x0C,0x00,0x3F,0x24,0xA4,0x64,0x24,0x24,0x24,0x3C,0x00,0x00},/*"编",58*/
+	{0x40,0x80,0xFE,0x08,0x08,0xFC,0x00,0x10,0x10,0x10,0x10,0x12,0x11,0x02,0xFC,0x00},
+	{0x20,0x21,0x27,0x3A,0x22,0x23,0x00,0x40,0x4F,0x41,0x41,0x41,0x7F,0x01,0x01,0x00},/*"码",59*/
+	{0x10,0x10,0x2F,0x29,0x49,0x49,0x8F,0x00,0x80,0x4F,0x49,0x29,0x29,0x1F,0x10,0x00},
+	{0x01,0x01,0x79,0x49,0x49,0x49,0x79,0x07,0x01,0x79,0x4D,0x4B,0x49,0x79,0x01,0x00},/*"器",60*/
+	{0x20,0x22,0x41,0xFE,0x80,0x00,0x01,0xF1,0x02,0x0C,0xF0,0x08,0x04,0xF3,0x00,0x00},
+	{0x08,0x08,0x08,0xFF,0x08,0x09,0x00,0x03,0x7A,0x4A,0x4A,0x4A,0x7A,0x03,0x00,0x00},/*"损",61*/
+	{0x10,0x18,0x10,0xE0,0x20,0x28,0x10,0x20,0x40,0x80,0xFF,0x00,0x00,0xC0,0x30,0x00},
+	{0x04,0x04,0x04,0xFF,0x04,0x04,0x20,0x20,0x20,0x21,0x27,0x38,0x21,0x20,0x20,0x00},/*"坏",62*/
+	
+	{0x00,0x00,0xF8,0x10,0x10,0x10,0x10,0xFE,0x11,0x11,0x11,0x11,0xF9,0x01,0x0F,0x00},
+	{0x00,0x00,0x1F,0x11,0x11,0x11,0x11,0xFF,0x11,0x11,0x11,0x11,0x1F,0x00,0x00,0x00},/*"电",63*/
+	{0x20,0x20,0x7E,0x82,0x0C,0xF0,0x04,0xC8,0x92,0x81,0xFE,0x80,0x90,0xC8,0x04,0x00},
+	{0x08,0x06,0x40,0x31,0x00,0x7F,0x40,0x4F,0x4A,0x5A,0x6A,0x4A,0x4A,0x4F,0x40,0x00},/*"源",64*/
+	{0x08,0x10,0x20,0x40,0x80,0x00,0x00,0xFF,0x00,0x00,0x00,0x80,0x40,0x30,0x00,0x00},
+	{0x00,0x40,0x40,0x40,0x40,0x41,0x42,0x4F,0x70,0x42,0x41,0x40,0x40,0x40,0x00,0x00},/*"不",65*/
+	{0x10,0x60,0x80,0xFF,0x00,0xC1,0x06,0x20,0x26,0x31,0x2D,0x21,0x23,0xE8,0x06,0x00},
+	{0x24,0x24,0x25,0x7F,0xC5,0x44,0x10,0x29,0x49,0xC9,0x49,0x59,0x69,0x0F,0x00,0x00},/*"稳",66*/
+	{0x01,0x02,0x04,0x78,0x04,0x02,0x02,0xFE,0x22,0x22,0x22,0x22,0x22,0x02,0x02,0x00},
+	{0x08,0x30,0x22,0x22,0x22,0x22,0xA2,0x63,0x22,0x22,0x22,0x22,0x22,0x28,0x30,0x00},/*"定",67*/
+	
+	{0x20,0x20,0x7E,0x80,0x02,0x7E,0x42,0x42,0x7E,0x42,0x7E,0x42,0x42,0x7E,0x02,0x00},
+	{0x08,0x06,0x40,0x31,0x00,0x00,0x7F,0x49,0x49,0x49,0x49,0x49,0x7F,0x00,0x00,0x00},/*"温",68*/
+	{0x02,0x0C,0xF1,0x01,0x21,0x32,0xAA,0xA4,0xA4,0xA4,0xAA,0x32,0x01,0x01,0x01,0x00},
+	{0x00,0x00,0x3F,0x24,0x24,0x24,0x3F,0xA4,0x64,0x24,0x3F,0x24,0x24,0x24,0x20,0x00},/*"度",69*/
+	{0x00,0x02,0x04,0xF8,0x04,0x02,0x02,0x82,0x02,0x12,0x0A,0xF2,0x02,0x02,0x02,0x00},
+	{0x02,0x02,0x42,0x33,0x00,0x10,0x12,0x11,0x10,0x10,0x10,0xFF,0x10,0x10,0x10,0x00},/*"过",70*/
+	{0x00,0x7F,0x40,0x40,0x5E,0x52,0x52,0x52,0x52,0x52,0x5E,0x40,0x41,0x7F,0x00,0x00},
+	{0x20,0x20,0x20,0x20,0x2F,0x29,0xA9,0x69,0x29,0x29,0x2F,0x20,0x20,0x20,0x20,0x00},/*"高",71*/
+	
+	{0x00,0x00,0xF8,0x10,0x10,0x10,0x10,0xFE,0x11,0x11,0x11,0x11,0xF9,0x01,0x0F,0x00},
+	{0x00,0x00,0x1F,0x11,0x11,0x11,0x11,0xFF,0x11,0x11,0x11,0x11,0x1F,0x00,0x00,0x00},/*"电",72*/
+	{0x20,0xC0,0x00,0xFF,0x00,0xC1,0x06,0xF8,0x00,0x00,0x00,0xFC,0x02,0x02,0x1E,0x00},
+	{0x08,0x08,0x0B,0xFF,0x09,0x08,0x00,0x7F,0x40,0x40,0x40,0x7F,0x00,0x00,0x00,0x00},/*"机",73*/
+	{0x44,0xE6,0x44,0x48,0x48,0x48,0x02,0x02,0x04,0xC8,0x30,0x28,0x44,0x82,0x1F,0x00},
+	{0x04,0x0C,0x35,0xC6,0x04,0x18,0x01,0x09,0x09,0xFF,0x09,0x92,0x52,0x12,0x02,0x00},/*"线",74*/
+	{0x20,0x22,0x41,0xFE,0x80,0x41,0x41,0x52,0x6A,0xC4,0x44,0x4A,0x72,0x41,0x40,0x00},
+	{0x08,0x08,0x08,0xFF,0x08,0x0A,0x22,0x2A,0xA6,0x63,0x22,0x26,0x2A,0x22,0x02,0x00},/*"接",75*/
+	{0x80,0x80,0xFE,0x84,0x88,0x00,0xFF,0x92,0x92,0x92,0x92,0x92,0xFF,0x00,0x00,0x00},
+	{0x02,0x0C,0xF7,0x24,0x26,0x12,0x12,0xFE,0x12,0x12,0x12,0xFE,0x12,0x12,0x02,0x00},/*"错",76*/
+	
+	{0x10,0x20,0xC0,0x00,0x00,0x02,0x01,0xFE,0x00,0x00,0x00,0x00,0x00,0x80,0x70,0x00},
+	{0x00,0x00,0x00,0x07,0x00,0x00,0x00,0xFF,0x00,0x00,0x00,0x04,0x02,0x01,0x00,0x00},/*"小",77*/
+	{0x10,0x10,0x90,0x90,0x90,0x90,0x90,0xFF,0x90,0x90,0x90,0x90,0x90,0x10,0x10,0x00},
+	{0x00,0x10,0x11,0x12,0x14,0x18,0xF0,0x17,0x10,0x10,0x10,0x10,0x10,0x10,0x00,0x00},/*"车",78*/
+	{0x02,0x02,0x02,0xFE,0x02,0x02,0x02,0xFE,0x02,0x02,0x02,0x02,0x02,0x02,0x02,0x00},
+	{0x00,0x40,0x40,0x43,0x40,0x40,0x40,0x7F,0x41,0x41,0x41,0x41,0x41,0x40,0x00,0x00},/*"正",79*/
+	{0x00,0x00,0x7C,0x40,0x40,0x40,0x40,0xFF,0x40,0x40,0x48,0x44,0x78,0x00,0x00,0x00},
+	{0x04,0x18,0x10,0x57,0x35,0x15,0x15,0xF5,0x15,0x15,0x35,0x57,0x10,0x14,0x18,0x00},/*"常",80*/
+
+
+   //16*16
+	
+};
+
+#endif
diff --git a/HARDWARE/pstwo.c b/HARDWARE/pstwo.c
new file mode 100644
index 0000000..7c09e45
--- /dev/null
+++ b/HARDWARE/pstwo.c
@@ -0,0 +1,424 @@
+#include "pstwo.h"
+#define DELAY_TIME  delay_us(5); 
+
+//Button value reading, zero time storage
+//按键值读取，零时存储
+u16 Handkey;	
+//Start the order. Request data
+//开始命令。请求数据
+u8 Comd[2]={0x01,0x42};	
+//Data store array
+//数据存储数组
+u8 Data[9]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}; 
+
+u16 MASK[]={
+    PSB_SELECT,
+    PSB_L3,
+    PSB_R3 ,
+    PSB_START,
+    PSB_PAD_UP,
+    PSB_PAD_RIGHT,
+    PSB_PAD_DOWN,
+    PSB_PAD_LEFT,
+    PSB_L2,
+    PSB_R2,
+    PSB_L1,
+    PSB_R1 ,
+    PSB_GREEN,
+    PSB_RED,
+    PSB_BLUE,
+    PSB_PINK
+	}; //Key value and key name //按键值与按键名
+/**************************************************************************
+Function: Ps2 handle task
+Input   : none
+Output  : none
+函数功能：PS2手柄任务
+入口参数：无
+返回  值：无
+**************************************************************************/	
+void pstwo_task(void *pvParameters)
+{
+    u32 lastWakeTime = getSysTickCnt();
+    while(1)
+    {	
+			//The task is run at 100hz
+			//此任务以100Hz的频率运行 	
+			vTaskDelayUntil(&lastWakeTime, F2T(RATE_100_HZ));
+			//Read the ps2 data
+			//读取PS2的数据	
+      PS2_Read(); 	
+    }
+}  
+/**************************************************************************
+Function: Ps2 handle initializer
+Input   : none
+Output  : none
+函数功能：PS2手柄初始化
+入口参数：无
+返回  值：无
+**************************************************************************/	
+void PS2_Init(void)
+{
+  GPIO_InitTypeDef GPIO_InitStructure;
+	
+	//Enable the ability port clock
+	//使能端口时钟
+	RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOE, ENABLE);
+
+	GPIO_InitStructure.GPIO_Pin = GPIO_Pin_15;			//端口配置
+  GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IN;		//普通输入模式
+	GPIO_InitStructure.GPIO_Speed = GPIO_Speed_100MHz;	//100M
+	GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_DOWN;		//下拉
+	GPIO_Init(GPIOE, &GPIO_InitStructure);
+
+	GPIO_InitStructure.GPIO_Pin = GPIO_Pin_8|GPIO_Pin_10|GPIO_Pin_12;		  
+	GPIO_InitStructure.GPIO_Mode=GPIO_Mode_OUT;          
+	GPIO_InitStructure.GPIO_OType=GPIO_OType_PP;        
+	GPIO_InitStructure.GPIO_Speed=GPIO_Speed_50MHz;     
+	GPIO_InitStructure.GPIO_PuPd=GPIO_PuPd_UP;         
+	GPIO_Init(GPIOE, &GPIO_InitStructure);
+}
+/**************************************************************************
+Function: Read the control of the ps2 handle
+Input   : none
+Output  : none
+函数功能：读取PS2手柄的控制量
+入口参数：无
+返回  值：无
+**************************************************************************/	
+void PS2_Read(void)
+{
+	static int Strat;
+
+	//Reading key
+  //读取按键键值
+	PS2_KEY=PS2_DataKey(); 
+	//Read the analog of the remote sensing x axis on the left
+  //读取左边遥感X轴方向的模拟量	
+	PS2_LX=PS2_AnologData(PSS_LX); 
+	//Read the analog of the directional direction of remote sensing on the left
+  //读取左边遥感Y轴方向的模拟量	
+	PS2_LY=PS2_AnologData(PSS_LY);
+	//Read the analog of the remote sensing x axis
+  //读取右边遥感X轴方向的模拟量  
+	PS2_RX=PS2_AnologData(PSS_RX);
+	//Read the analog of the directional direction of the remote sensing y axis
+  //读取右边遥感Y轴方向的模拟量  
+	PS2_RY=PS2_AnologData(PSS_RY);  
+
+	if(PS2_KEY==4&&PS2_ON_Flag==0) 
+		//The start button on the // handle is pressed
+		//手柄上的Start按键被按下
+		Strat=1; 
+	
+	if(Strat&&(PS2_LY<118)&&PS2_ON_Flag==0&&Deviation_Count>=CONTROL_DELAY)
+		//When the button is pressed, you need to push the right side forward to the formal ps2 control car
+		//Start按键被按下后，需要推下右边前进杆，才可以正式PS2控制小车
+		PS2_ON_Flag=1,Remote_ON_Flag=0,APP_ON_Flag=0,CAN_ON_Flag=0,Usart1_ON_Flag=0,Usart5_ON_Flag=0;  
+}
+/**************************************************************************
+Function: Send commands to the handle
+Input   : none
+Output  : none
+函数功能：向手柄发送命令
+入口参数：无
+返回  值：无
+**************************************************************************/	
+void PS2_Cmd(u8 CMD)
+{
+	volatile u16 ref=0x01;
+	Data[1] = 0;
+	for(ref=0x01;ref<0x0100;ref<<=1)
+	{
+		if(ref&CMD)
+		{
+			DO_H;     //Output a control bit //输出一位控制位
+		}
+		else DO_L;
+
+		CLK_H;      //Clock lift //时钟拉高
+		DELAY_TIME;
+		CLK_L;
+		DELAY_TIME;
+		CLK_H;
+		if(DI)
+			Data[1] = ref|Data[1];
+	}
+	delay_us(16);
+}
+/**************************************************************************
+Function: Whether it is a red light mode, 0x41= analog green light, 0x73= analog red light
+Input   : none
+Output  : 0: red light mode, other: other modes
+函数功能：判断是否为红灯模式,0x41=模拟绿灯，0x73=模拟红灯
+入口参数：无
+返回  值：0：红灯模式，其他：其他模式
+**************************************************************************/	
+u8 PS2_RedLight(void)
+{
+	CS_L;
+	PS2_Cmd(Comd[0]);  //Start orders //开始命令
+	PS2_Cmd(Comd[1]);  //Request data //请求数据
+	CS_H;
+	if( Data[1] == 0X73)   return 0 ;
+	else return 1;
+
+}
+/**************************************************************************
+Function: Read the handle data
+Input   : none
+Output  : none
+函数功能：读取手柄数据
+入口参数：无
+返回  值：无
+**************************************************************************/	
+void PS2_ReadData(void)
+{
+	volatile u8 byte=0;
+	volatile u16 ref=0x01;
+	CS_L;
+	PS2_Cmd(Comd[0]);  //Start orders //开始命令
+	PS2_Cmd(Comd[1]);  //Request data //请求数据
+	for(byte=2;byte<9;byte++) //Start receiving data //开始接受数据
+	{
+		for(ref=0x01;ref<0x100;ref<<=1)
+		{
+			CLK_H;
+			DELAY_TIME;
+			CLK_L;
+			DELAY_TIME;
+			CLK_H;
+		      if(DI)
+		      Data[byte] = ref|Data[byte];
+		}
+        delay_us(16);
+	}
+	CS_H;
+}
+/**************************************************************************
+Function: Handle the data of the read 2 and handle only the key parts
+Input   : none
+Output  : 0: only one button presses the next time; No press
+函数功能：对读出来的PS2的数据进行处理,只处理按键部分 
+入口参数：无
+返回  值：0: 只有一个按键按下时按下; 1: 未按下
+**************************************************************************/	
+u8 PS2_DataKey()
+{
+	u8 index;
+
+	PS2_ClearData();
+	PS2_ReadData();
+
+	Handkey=(Data[4]<<8)|Data[3]; //This is 16 buttons, pressed down to 0, and not pressed for 1  //这是16个按键，按下为0，未按下为1
+	for(index=0;index<16;index++)
+	{	    
+		if((Handkey&(1<<(MASK[index]-1)))==0)
+		return index+1;
+	}
+	return 0;  //No buttons //没有任何按键按下
+}
+/**************************************************************************
+Function: Get a simulation of a rocker
+Input   : Rocker
+Output  : Simulation of rocker, range 0~ 256
+函数功能：得到一个摇杆的模拟量
+入口参数：摇杆
+返回  值：摇杆的模拟量, 范围0~256
+**************************************************************************/
+u8 PS2_AnologData(u8 button)
+{
+	return Data[button];
+}
+/**************************************************************************
+Function: Clear data buffer
+Input   : none
+Output  : none
+函数功能：清除数据缓冲区
+入口参数：无
+返回  值：无
+**************************************************************************/
+void PS2_ClearData()
+{
+	u8 a;
+	for(a=0;a<9;a++)
+		Data[a]=0x00;
+}
+/******************************************************
+Function: Handle vibration function
+Input   : motor1: the right small vibrator, 0x00, other
+          motor2: the left big shock motor 0x40~ 0xff motor is open, and the value is greater
+Output  : none
+函数功能：手柄震动函数
+入口参数：motor1:右侧小震动电机 0x00关，其他开
+	        motor2:左侧大震动电机 0x40~0xFF 电机开，值越大 震动越大
+返回  值：无
+******************************************************/
+void PS2_Vibration(u8 motor1, u8 motor2)
+{
+	CS_L;
+	delay_us(16);
+  PS2_Cmd(0x01); //Start order //开始命令
+	PS2_Cmd(0x42); //Request data //请求数据
+	PS2_Cmd(0X00);
+	PS2_Cmd(motor1);
+	PS2_Cmd(motor2);
+	PS2_Cmd(0X00);
+	PS2_Cmd(0X00);
+	PS2_Cmd(0X00);
+	PS2_Cmd(0X00);
+	CS_H;
+	delay_us(16);  
+}
+/**************************************************************************
+Function: Short press
+Input   : none
+Output  : none
+函数功能：短按
+入口参数：无
+返回  值：无
+**************************************************************************/
+void PS2_ShortPoll(void)
+{
+	CS_L;
+	delay_us(16);
+	PS2_Cmd(0x01);  
+	PS2_Cmd(0x42);  
+	PS2_Cmd(0X00);
+	PS2_Cmd(0x00);
+	PS2_Cmd(0x00);
+	CS_H;
+	delay_us(16);	
+}
+/**************************************************************************
+Function: Enter configuration
+Input   : none
+Output  : none
+函数功能：进入配置
+入口参数：无
+返回  值：无
+**************************************************************************/
+void PS2_EnterConfing(void)
+{
+  CS_L;
+	delay_us(16);
+	PS2_Cmd(0x01);  
+	PS2_Cmd(0x43);  
+	PS2_Cmd(0X00);
+	PS2_Cmd(0x01);
+	PS2_Cmd(0x00);
+	PS2_Cmd(0X00);
+	PS2_Cmd(0X00);
+	PS2_Cmd(0X00);
+	PS2_Cmd(0X00);
+	CS_H;
+	delay_us(16);
+}
+/**************************************************************************
+Function: Send mode Settings
+Input   : none
+Output  : none
+函数功能：发送模式设置
+入口参数：无
+返回  值：无
+**************************************************************************/
+void PS2_TurnOnAnalogMode(void)
+{
+	CS_L;
+	PS2_Cmd(0x01);  
+	PS2_Cmd(0x44);  
+	PS2_Cmd(0X00);
+	PS2_Cmd(0x01); //analog=0x01;digital=0x00  Software Settings send mode 软件设置发送模式
+	PS2_Cmd(0x03); //0x03 lock storage setup, which cannot be set by the key "mode" set mode. //0x03锁存设置，即不可通过按键“MODE”设置模式。
+				         //0xee non-locking software Settings can be set by the key "mode" set mode.//0xEE不锁存软件设置，可通过按键“MODE”设置模式。
+	PS2_Cmd(0X00);
+	PS2_Cmd(0X00);
+	PS2_Cmd(0X00);
+	PS2_Cmd(0X00);
+	CS_H;
+	delay_us(16);
+}
+/**************************************************************************
+Function: Vibration setting
+Input   : none
+Output  : none
+函数功能：振动设置
+入口参数：无
+返回  值：无
+**************************************************************************/
+void PS2_VibrationMode(void)
+{
+	CS_L;
+	delay_us(16);
+	PS2_Cmd(0x01);  
+	PS2_Cmd(0x4D);  
+	PS2_Cmd(0X00);
+	PS2_Cmd(0x00);
+	PS2_Cmd(0X01);
+	CS_H;
+	delay_us(16);	
+}
+/**************************************************************************
+Function: Complete and save the configuration
+Input   : none
+Output  : none
+函数功能：完成并保存配置
+入口参数：无
+返回  值：无
+**************************************************************************/
+void PS2_ExitConfing(void)
+{
+    CS_L;
+	delay_us(16);
+	PS2_Cmd(0x01);  
+	PS2_Cmd(0x43);  
+	PS2_Cmd(0X00);
+	PS2_Cmd(0x00);
+	PS2_Cmd(0x5A);
+	PS2_Cmd(0x5A);
+	PS2_Cmd(0x5A);
+	PS2_Cmd(0x5A);
+	PS2_Cmd(0x5A);
+	CS_H;
+	delay_us(16);
+}
+/**************************************************************************
+Function: Handle configuration initialization
+Input   : none
+Output  : none
+函数功能：手柄配置初始化
+入口参数：无
+返回  值：无
+**************************************************************************/
+void PS2_SetInit(void)
+{
+	PS2_ShortPoll();
+	PS2_ShortPoll();
+	PS2_ShortPoll();
+	PS2_EnterConfing();		  //Enter configuration mode //进入配置模式
+	PS2_TurnOnAnalogMode();	//The "traffic light" configuration mode and select whether to save //“红绿灯”配置模式，并选择是否保存
+	//PS2_VibrationMode();	//Open vibration mode //开启震动模式
+	PS2_ExitConfing();		  //Complete and save the configuration //完成并保存配置
+}
+/**************************************************************************
+Function: Read the handle information
+Input   : none
+Output  : none
+函数功能：读取手柄信息
+入口参数：无
+返回  值：无
+**************************************************************************/
+void PS2_Receive (void)
+{
+	if(PS2_ON_Flag)
+		{
+		PS2_LX=PS2_AnologData(PSS_LX);
+		PS2_LY=PS2_AnologData(PSS_LY);
+		PS2_RX=PS2_AnologData(PSS_RX);
+		PS2_RY=PS2_AnologData(PSS_RY);
+		}
+		PS2_KEY=PS2_DataKey();
+}
+
+
diff --git a/HARDWARE/pstwo.h b/HARDWARE/pstwo.h
new file mode 100644
index 0000000..f2fd343
--- /dev/null
+++ b/HARDWARE/pstwo.h
@@ -0,0 +1,75 @@
+#ifndef __PSTWO_H
+#define __PSTWO_H
+#include "delay.h"
+#include "sys.h"
+#include "system.h"
+      
+#define PS2_TASK_PRIO		4     //Task priority //任务优先级
+#define PS2_STK_SIZE 		256   //Task stack size //任务堆栈大小
+
+
+#define DI   PEin(15)     //Input pin //输入引脚
+
+#define DO_H PEout(12)=1   //Command height //命令位高
+#define DO_L PEout(12)=0   //Command low //命令位低
+
+#define CS_H PEout(10)=1  //Cs pull up //CS拉高
+#define CS_L PEout(10)=0  //Cs drawdown //CS拉低
+
+#define CLK_H PEout(8)=1 //Clock lift //时钟拉高
+#define CLK_L PEout(8)=0 //Clock down //时钟拉低
+
+//These are our button constants
+#define PSB_SELECT      1
+#define PSB_L3          2
+#define PSB_R3          3
+#define PSB_START       4
+#define PSB_PAD_UP      5
+#define PSB_PAD_RIGHT   6
+#define PSB_PAD_DOWN    7
+#define PSB_PAD_LEFT    8
+#define PSB_L2          9
+#define PSB_R2          10
+#define PSB_L1          11
+#define PSB_R1          12
+#define PSB_GREEN       13
+#define PSB_RED         14
+#define PSB_BLUE        15
+#define PSB_PINK        16
+
+#define PSB_TRIANGLE    13
+#define PSB_CIRCLE      14
+#define PSB_CROSS       15
+#define PSB_SQUARE      16
+
+#define PSS_RX 5   //Right rocker x shaft data   //右摇杆X轴数据
+#define PSS_RY 6   //The left rocker y axis data //左摇杆Y轴数据
+#define PSS_LX 7   //Right rocker x axis data    //右摇杆X轴数据
+#define PSS_LY 8   //The left rocker y axis data //左摇杆Y轴数据
+
+extern u8 Data[9];
+extern u16 MASK[16];
+extern u16 Handkey;
+void PS2_Read(void);
+void PS2_Init(void);
+u8 PS2_RedLight(void);   
+void PS2_ReadData(void); 
+void PS2_Cmd(u8 CMD);		 
+u8 PS2_DataKey(void);		 
+u8 PS2_AnologData(u8 button); 
+void PS2_ClearData(void);	    
+void PS2_Vibration(u8 motor1, u8 motor2);
+
+void PS2_EnterConfing(void);	   
+void PS2_TurnOnAnalogMode(void); 
+void PS2_VibrationMode(void);  
+void PS2_ExitConfing(void);	 
+void PS2_SetInit(void);		    
+void PS2_Receive (void);
+void pstwo_task(void *pvParameters);
+#endif
+
+
+
+
+
diff --git a/HARDWARE/stmflash.c b/HARDWARE/stmflash.c
new file mode 100644
index 0000000..e22cbad
--- /dev/null
+++ b/HARDWARE/stmflash.c
@@ -0,0 +1,220 @@
+#include "stmflash.h"
+#include "delay.h"
+#include "stmflash.h"  
+#define FLASH_SAVE_ADDR  0X0800E000 	//设置FLASH 保存地址(必须为偶数，且其值要大于本代码所占用FLASH的大小+0X08000000)
+//解锁STM32的FLASH
+void STMFLASH_Unlock(void)
+{
+  FLASH->KEYR=FLASH_KEY1;//写入解锁序列.
+  FLASH->KEYR=FLASH_KEY2;
+}
+//flash上锁
+void STMFLASH_Lock(void)
+{
+  FLASH->CR|=1<<7;//上锁
+}
+//得到FLASH状态
+u8 STMFLASH_GetStatus(void)
+{	
+	u32 res;		
+	res=FLASH->SR; 
+	if(res&(1<<0))return 1;		    //忙
+	else if(res&(1<<2))return 2;	//编程错误
+	else if(res&(1<<4))return 3;	//写保护错误
+	return 0;						//操作完成
+}
+//等待操作完成
+//time:要延时的长短
+//返回值:状态.
+u8 STMFLASH_WaitDone(u16 time)
+{
+	u8 res;
+	do
+	{
+		res=STMFLASH_GetStatus();
+		if(res!=1)break;//非忙,无需等待了,直接退出.
+		delay_us(1);
+		time--;
+	 }while(time);
+	 if(time==0)res=0xff;//TIMEOUT
+	 return res;
+}
+//擦除页
+//paddr:页地址
+//返回值:执行情况
+u8 STMFLASH_ErasePage(u32 paddr)
+{
+	u8 res=0;
+	res=STMFLASH_WaitDone(0X5FFF);//等待上次操作结束,>20ms    
+	if(res==0)
+	{ 
+		FLASH->CR|=1<<1;//页擦除
+		FLASH->AR=paddr;//设置页地址 
+		FLASH->CR|=1<<6;//开始擦除		  
+		res=STMFLASH_WaitDone(0X5FFF);//等待操作结束,>20ms  
+		if(res!=1)//非忙
+		{
+			FLASH->CR&=~(1<<1);//清除页擦除标志.
+		}
+	}
+	return res;
+}
+//在FLASH指定地址写入半字
+//faddr:指定地址(此地址必须为2的倍数!!)
+//dat:要写入的数据
+//返回值:写入的情况
+u8 STMFLASH_WriteHalfWord(u32 faddr, u16 dat)
+{
+	u8 res;	   	    
+	res=STMFLASH_WaitDone(0XFF);	 
+	if(res==0)//OK
+	{
+		FLASH->CR|=1<<0;//编程使能
+		*(vu16*)faddr=dat;//写入数据
+		res=STMFLASH_WaitDone(0XFF);//等待操作完成
+		if(res!=1)//操作成功
+		{
+			FLASH->CR&=~(1<<0);//清除PG位.
+		}
+	} 
+	return res;
+} 
+//读取指定地址的半字(16位数据) 
+//faddr:读地址 
+//返回值:对应数据.
+u16 STMFLASH_ReadHalfWord(u32 faddr)
+{
+	return *(vu16*)faddr; 
+}
+#if STM32_FLASH_WREN	//如果使能了写   
+//不检查的写入
+//WriteAddr:起始地址
+//pBuffer:数据指针
+//NumToWrite:半字(16位)数   
+void STMFLASH_Write_NoCheck(u32 WriteAddr,u16 *pBuffer,u16 NumToWrite)   
+{ 			 		 
+	u16 i;
+	for(i=0;i=(STM32_FLASH_BASE+1024*STM32_FLASH_SIZE)))return;//非法地址
+	STMFLASH_Unlock();						//解锁
+	offaddr=WriteAddr-STM32_FLASH_BASE;		//实际偏移地址.
+	secpos=offaddr/STM_SECTOR_SIZE;			//扇区地址  0~127 for STM32F103RBT6
+	secoff=(offaddr%STM_SECTOR_SIZE)/2;		//在扇区内的偏移(2个字节为基本单位.)
+	secremain=STM_SECTOR_SIZE/2-secoff;		//扇区剩余空间大小   
+	if(NumToWrite<=secremain)secremain=NumToWrite;//不大于该扇区范围
+	while(1) 
+	{	
+		STMFLASH_Read(secpos*STM_SECTOR_SIZE+STM32_FLASH_BASE,STMFLASH_BUF,STM_SECTOR_SIZE/2);//读出整个扇区的内容
+		for(i=0;i(STM_SECTOR_SIZE/2))secremain=STM_SECTOR_SIZE/2;//下一个扇区还是写不完
+			else secremain=NumToWrite;//下一个扇区可以写完了
+		}	 
+	};	
+	STMFLASH_Lock();//上锁
+}
+#endif
+//从指定地址开始读出指定长度的数据
+//ReadAddr:起始地址
+//pBuffer:数据指针
+//NumToWrite:半字(16位)数
+void STMFLASH_Read(u32 ReadAddr,u16 *pBuffer,u16 NumToRead)   	
+{
+	u16 i;
+	for(i=0;i1600&&Remote_ON_Flag==0&&Deviation_Count>=CONTROL_DELAY)
+  {
+		//Model aircraft remote control mark position 1, other marks position 0
+		//航模遥控标志位置1，其它标志位置0
+		Remote_ON_Flag=1;
+	  APP_ON_Flag=0;
+		PS2_ON_Flag=0;
+		CAN_ON_Flag=0;
+		//Usart_ON_Flag=0; 
+		Usart1_ON_Flag=0;
+		Usart5_ON_Flag=0;
+	}
+	
+
+
+//	//Channel 1 //通道一
+	if ((TIM8CH1_CAPTURE_STA & 0X80) == 0) 			
+	{
+		if (TIM_GetITStatus(TIM8, TIM_IT_CC1) != RESET) //A capture event occurred on channel 1 //通道1发生捕获事件
+		{
+			TIM_ClearITPendingBit(TIM8, TIM_IT_CC1); //Clear the interrupt flag bit //清除中断标志位
+			if (TIM8CH1_CAPTURE_STA & 0X40)	//A falling edge is caught //捕获到一个下降沿
+			{
+				TIM8CH1_CAPTURE_DOWNVAL = TIM_GetCapture1(TIM8); //Record the timer value at this point //记录下此时的定时器计数值
+				if (TIM8CH1_CAPTURE_DOWNVAL < TIM8CH1_CAPTURE_UPVAL)
+				{
+					TIM8_T1 = 9999;
+				}
+				else
+					TIM8_T1 = 0;
+				Remoter_Ch1 = TIM8CH1_CAPTURE_DOWNVAL - TIM8CH1_CAPTURE_UPVAL + TIM8_T1;	//Time to get the total high level //得到总的高电平的时间
+				if(abs(Remoter_Ch1-L_Remoter_Ch1)>500) Remoter_Ch1=L_Remoter_Ch1; //Filter //滤波
+					 L_Remoter_Ch1=Remoter_Ch1;
+				
+				TIM8CH1_CAPTURE_STA = 0; //Capture flag bit to zero	//捕获标志位清零
+				TIM_OC1PolarityConfig(TIM8, TIM_ICPolarity_Rising); //Set to rising edge capture //设置为上升沿捕获		  
+			}
+			else 
+			{
+				//When the capture time occurs but not the falling edge, the first time the rising edge is captured, record the timer value at this time
+				//发生捕获时间但不是下降沿，第一次捕获到上升沿，记录此时的定时器计数值
+				TIM8CH1_CAPTURE_UPVAL = TIM_GetCapture1(TIM8); //Obtain rising edge data //获取上升沿数据
+				TIM8CH1_CAPTURE_STA |= 0X40; //The flag has been caught on the rising edge //标记已捕获到上升沿
+				TIM_OC1PolarityConfig(TIM8, TIM_ICPolarity_Falling); //Set to Falling Edge Capture //设置为下降沿捕获
+			}
+		}
+	}
+  //Channel 2 //通道二
+	if ((TIM8CH2_CAPTURE_STA & 0X80) == 0)		
+	{
+		if (TIM_GetITStatus(TIM8, TIM_IT_CC2) != RESET)	//A capture event occurred on channel 2 //通道2发生捕获事件
+		{
+			TIM_ClearITPendingBit(TIM8, TIM_IT_CC2); //Clear the interrupt flag bit //清除中断标志位
+			if (TIM8CH2_CAPTURE_STA & 0X40)	//A falling edge is caught //捕获到一个下降沿
+			{
+				TIM8CH2_CAPTURE_DOWNVAL = TIM_GetCapture2(TIM8); //Record the timer value at this point //记录下此时的定时器计数值
+				if (TIM8CH2_CAPTURE_DOWNVAL < TIM8CH2_CAPTURE_UPVAL)
+				{
+					TIM8_T2 = 9999;
+				}
+				else
+					TIM8_T2 = 0;
+				Remoter_Ch2 = TIM8CH2_CAPTURE_DOWNVAL - TIM8CH2_CAPTURE_UPVAL + TIM8_T2; //Time to get the total high level //得到总的高电平的时间
+				if(abs(Remoter_Ch2-L_Remoter_Ch2)>500)Remoter_Ch2=L_Remoter_Ch2; //Filter //滤波
+				L_Remoter_Ch2=Remoter_Ch2;
+				
+				TIM8CH2_CAPTURE_STA = 0; //Capture flag bit to zero	//捕获标志位清零
+				TIM_OC2PolarityConfig(TIM8, TIM_ICPolarity_Rising); //Set to rising edge capture //设置为上升沿捕获		  
+			}
+			else 
+			{
+				//When the capture time occurs but not the falling edge, the first time the rising edge is captured, record the timer value at this time
+				//发生捕获时间但不是下降沿，第一次捕获到上升沿，记录此时的定时器计数值
+				TIM8CH2_CAPTURE_UPVAL = TIM_GetCapture2(TIM8); //Obtain rising edge data //获取上升沿数据
+				TIM8CH2_CAPTURE_STA |= 0X40; //The flag has been caught on the rising edge //标记已捕获到上升沿
+				TIM_OC2PolarityConfig(TIM8, TIM_ICPolarity_Falling); //Set to Falling Edge Capture //设置为下降沿捕获
+			}
+		}
+	}
+  //Channel 3 //通道三
+	if ((TIM8CH3_CAPTURE_STA & 0X80) == 0)			
+	{
+		if (TIM_GetITStatus(TIM8, TIM_IT_CC3) != RESET)	//A capture event occurred on channel 3 //通道3发生捕获事件
+		{
+			TIM_ClearITPendingBit(TIM8, TIM_IT_CC3); //Clear the interrupt flag bit //清除中断标志位
+			if (TIM8CH3_CAPTURE_STA & 0X40)	//A falling edge is caught //捕获到一个下降沿
+			{
+				TIM8CH3_CAPTURE_DOWNVAL = TIM_GetCapture3(TIM8); //Record the timer value at this point //记录下此时的定时器计数值
+				if (TIM8CH3_CAPTURE_DOWNVAL < TIM8CH3_CAPTURE_UPVAL)
+				{
+					TIM8_T3 = 9999;
+				}
+				else
+					TIM8_T3 = 0;
+				Remoter_Ch3 = TIM8CH3_CAPTURE_DOWNVAL - TIM8CH3_CAPTURE_UPVAL + TIM8_T3; //Time to get the total high level //得到总的高电平的时间
+				if(abs(Remoter_Ch3-L_Remoter_Ch3)>500)Remoter_Ch3=L_Remoter_Ch3; //Filter //滤波
+									L_Remoter_Ch3=Remoter_Ch3;
+				TIM8CH3_CAPTURE_STA = 0; //Capture flag bit to zero	//捕获标志位清零
+				TIM_OC3PolarityConfig(TIM8, TIM_ICPolarity_Rising); //Set to rising edge capture //设置为上升沿捕获		  
+			}
+			else 
+			{
+				//When the capture time occurs but not the falling edge, the first time the rising edge is captured, record the timer value at this time
+				//发生捕获时间但不是下降沿，第一次捕获到上升沿，记录此时的定时器计数值
+				TIM8CH3_CAPTURE_UPVAL = TIM_GetCapture3(TIM8); //Obtain rising edge data //获取上升沿数据
+				TIM8CH3_CAPTURE_STA |= 0X40; //The flag has been caught on the rising edge //标记已捕获到上升沿
+				TIM_OC3PolarityConfig(TIM8, TIM_ICPolarity_Falling); //Set to Falling Edge Capture //设置为下降沿捕获
+			}
+		}
+	}
+//	
+
+		//Channel 4 //通道四
+		if ((TIM8CH4_CAPTURE_STA & 0X80) == 0)		
+		{
+			if (TIM_GetITStatus(TIM8, TIM_IT_CC4) != RESET)	//A capture event occurred on channel 4 //通道4发生捕获事件
+			{
+				TIM_ClearITPendingBit(TIM8, TIM_IT_CC4); //Clear the interrupt flag bit //清除中断标志位
+				if (TIM8CH4_CAPTURE_STA & 0X40)	//A falling edge is caught //捕获到一个下降沿
+				{
+					TIM8CH4_CAPTURE_DOWNVAL = TIM_GetCapture4(TIM8); //Record the timer value at this point //记录下此时的定时器计数值
+					if (TIM8CH4_CAPTURE_DOWNVAL < TIM8CH4_CAPTURE_UPVAL)
+					{
+						TIM8_T4 = 9999;
+					}
+					else
+						TIM8_T4 = 0;
+					Remoter_Ch4 = TIM8CH4_CAPTURE_DOWNVAL - TIM8CH4_CAPTURE_UPVAL + TIM8_T4; //Time to get the total high level //得到总的高电平的时间
+					if(abs(Remoter_Ch4-L_Remoter_Ch4)>500)Remoter_Ch4=L_Remoter_Ch4; //Filter //滤波
+					L_Remoter_Ch4=Remoter_Ch4;				
+					TIM8CH4_CAPTURE_STA = 0; //Capture flag bit to zero	//捕获标志位清零
+					TIM_OC4PolarityConfig(TIM8, TIM_ICPolarity_Rising); //Set to rising edge capture //设置为上升沿捕获		  
+				}
+				else 
+				{
+					//When the capture time occurs but not the falling edge, the first time the rising edge is captured, record the timer value at this time
+				  //发生捕获时间但不是下降沿，第一次捕获到上升沿，记录此时的定时器计数值
+					TIM8CH4_CAPTURE_UPVAL = TIM_GetCapture4(TIM8); //Obtain rising edge data //获取上升沿数据
+					TIM8CH4_CAPTURE_STA |= 0X40; //The flag has been caught on the rising edge //标记已捕获到上升沿
+					TIM_OC4PolarityConfig(TIM8, TIM_ICPolarity_Falling); //Set to Falling Edge Capture //设置为下降沿捕获
+				}
+			}
+		}
+}
+/**************************************************************************
+Function: TIM1 Update Interrupt
+Input   : none
+Output  : none
+函数功能：定时器8更新中断
+入口参数：无
+返回  值：无 
+**************************************************************************/
+void TIM8_UP_TIM13_IRQHandler(void) 
+{ 
+	//Clear the interrupt flag bit
+	//清除中断标志位 
+  TIM8->SR&=~(1<<0);	    
+}
+
+void TIM8_SERVO_Init(u16 arr,u16 psc)
+{
+	GPIO_InitTypeDef GPIO_InitStructure;           //IO
+	TIM_TimeBaseInitTypeDef TIM_TimeBaseStructure; //定时器
+	TIM_OCInitTypeDef  TIM_OCInitStructure;        //PWM输出
+	
+	RCC_APB2PeriphClockCmd(RCC_APB2Periph_TIM8,ENABLE);  	//TIM1时钟使能    
+	RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOC, ENABLE); 	//使能PORTE时钟	
+		
+	GPIO_InitStructure.GPIO_Mode=GPIO_Mode_AF; 
+	GPIO_InitStructure.GPIO_Pin = GPIO_Pin_6|GPIO_Pin_7|GPIO_Pin_8|GPIO_Pin_9;
+  GPIO_InitStructure.GPIO_Speed=GPIO_Speed_100MHz; 	
+	GPIO_InitStructure.GPIO_OType=GPIO_OType_PP;
+	GPIO_InitStructure.GPIO_PuPd=GPIO_PuPd_UP;
+	GPIO_Init(GPIOC, &GPIO_InitStructure);
+	
+	GPIO_PinAFConfig(GPIOC,GPIO_PinSource6,GPIO_AF_TIM8); 
+	GPIO_PinAFConfig(GPIOC,GPIO_PinSource7,GPIO_AF_TIM8); 
+	GPIO_PinAFConfig(GPIOC,GPIO_PinSource8,GPIO_AF_TIM8); 
+	GPIO_PinAFConfig(GPIOC,GPIO_PinSource9,GPIO_AF_TIM8); 
+
+
+	/*** Initialize timer 1 || 初始化定时器1 ***/
+	//Set the counter to automatically reload //设定计数器自动重装值 
+	TIM_TimeBaseStructure.TIM_Period = arr; 
+	//Pre-divider //预分频器 
+	TIM_TimeBaseStructure.TIM_Prescaler = psc; 	
+	//Set the clock split: TDTS = Tck_tim //设置时钟分割:TDTS = Tck_tim
+	TIM_TimeBaseStructure.TIM_ClockDivision = TIM_CKD_DIV1; 
+	//TIM up count mode //TIM向上计数模式	
+	TIM_TimeBaseStructure.TIM_CounterMode = TIM_CounterMode_Up; 
+	//Initializes the timebase unit for TIMX based on the parameter specified in TIM_TimeBaseInitStruct
+	//根据TIM_TimeBaseInitStruct中指定的参数初始化TIMx的时间基数单位
+	TIM_TimeBaseInit(TIM8, &TIM_TimeBaseStructure); 
+
+
+	//-----------舵机初始化-----------//
+	//Select Timer mode :TIM Pulse Width Modulation mode 1
+  //选择定时器模式:TIM脉冲宽度调制模式1
+ 	TIM_OCInitStructure.TIM_OCMode = TIM_OCMode_PWM1; 
+	//Compare output enablement
+	//比较输出使能
+	TIM_OCInitStructure.TIM_OutputState = TIM_OutputState_Enable; 
+	//Set the pulse value of the capture comparison register to be loaded
+	//设置待装入捕获比较寄存器的脉冲值
+	TIM_OCInitStructure.TIM_Pulse = 0; 
+  //Output polarity :TIM output polarity is higher	
+  //输出极性:TIM输出比较极性高	
+	TIM_OCInitStructure.TIM_OCPolarity = TIM_OCPolarity_High;   
+	TIM_OCInitStructure.TIM_OCIdleState = TIM_OCIdleState_Reset;   
+	
+	//Initialize the peripheral TIMX based on the parameter specified in TIM_OCINITSTRUCT
+  //根据TIM_OCInitStruct中指定的参数初始化外设TIMx	
+	TIM_OC1Init(TIM8, &TIM_OCInitStructure); 
+	TIM_OC2Init(TIM8, &TIM_OCInitStructure); 
+	TIM_OC3Init(TIM8, &TIM_OCInitStructure); 
+	TIM_OC4Init(TIM8, &TIM_OCInitStructure); 
+	//Channel preload enable
+	//通道预装载使能	 
+	TIM_OC1PreloadConfig(TIM8, TIM_OCPreload_Enable);
+	TIM_OC2PreloadConfig(TIM8, TIM_OCPreload_Enable);
+	TIM_OC3PreloadConfig(TIM8, TIM_OCPreload_Enable);
+	TIM_OC4PreloadConfig(TIM8, TIM_OCPreload_Enable);
+	//-----------舵机初始化-----------//
+
+	TIM_CtrlPWMOutputs(TIM8,ENABLE); 	
+	//Enable timer //使能定时器
+	TIM_Cmd(TIM8, ENABLE); 		 
+
+  //The channel value is initialized to 1500, corresponding to the steering gear zero
+	//通道值初始化为1500，舵机零点对应值
+//	TIM8->CCR1=1500;
+//	TIM8->CCR2=1500;
+//	TIM8->CCR3=1500;
+//	TIM8->CCR4=1500;
+}
+
+
+void TIM12_SERVO_Init(u16 arr,u16 psc)
+{
+	GPIO_InitTypeDef GPIO_InitStructure;           //IO
+	TIM_TimeBaseInitTypeDef TIM_TimeBaseStructure; //定时器
+	TIM_OCInitTypeDef  TIM_OCInitStructure;        //PWM输出
+	
+	RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM12,ENABLE);  	//TIM1时钟使能    
+	RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOB, ENABLE); 	//使能PORTE时钟	
+		
+	GPIO_InitStructure.GPIO_Mode=GPIO_Mode_AF; 
+	GPIO_InitStructure.GPIO_Pin = GPIO_Pin_14|GPIO_Pin_15;
+  GPIO_InitStructure.GPIO_Speed=GPIO_Speed_100MHz; 	
+	GPIO_InitStructure.GPIO_OType=GPIO_OType_PP;
+	GPIO_InitStructure.GPIO_PuPd=GPIO_PuPd_UP;
+	GPIO_Init(GPIOB, &GPIO_InitStructure);
+	
+	GPIO_PinAFConfig(GPIOB,GPIO_PinSource14,GPIO_AF_TIM12); 
+	GPIO_PinAFConfig(GPIOB,GPIO_PinSource15,GPIO_AF_TIM12); 
+
+
+	/*** Initialize timer 1 || 初始化定时器1 ***/
+	//Set the counter to automatically reload //设定计数器自动重装值 
+	TIM_TimeBaseStructure.TIM_Period = arr; 
+	//Pre-divider //预分频器 
+	TIM_TimeBaseStructure.TIM_Prescaler = psc; 	
+	//Set the clock split: TDTS = Tck_tim //设置时钟分割:TDTS = Tck_tim
+	TIM_TimeBaseStructure.TIM_ClockDivision = TIM_CKD_DIV1; 
+	//TIM up count mode //TIM向上计数模式	
+	TIM_TimeBaseStructure.TIM_CounterMode = TIM_CounterMode_Up; 
+	//Initializes the timebase unit for TIMX based on the parameter specified in TIM_TimeBaseInitStruct
+	//根据TIM_TimeBaseInitStruct中指定的参数初始化TIMx的时间基数单位
+	TIM_TimeBaseInit(TIM12, &TIM_TimeBaseStructure); 
+
+
+	//-----------舵机初始化-----------//
+	//Select Timer mode :TIM Pulse Width Modulation mode 1
+  //选择定时器模式:TIM脉冲宽度调制模式1
+ 	TIM_OCInitStructure.TIM_OCMode = TIM_OCMode_PWM1; 
+	//Compare output enablement
+	//比较输出使能
+	TIM_OCInitStructure.TIM_OutputState = TIM_OutputState_Enable; 
+	//Set the pulse value of the capture comparison register to be loaded
+	//设置待装入捕获比较寄存器的脉冲值
+	TIM_OCInitStructure.TIM_Pulse = 0; 
+  //Output polarity :TIM output polarity is higher	
+  //输出极性:TIM输出比较极性高	
+	TIM_OCInitStructure.TIM_OCPolarity = TIM_OCPolarity_High;   
+	TIM_OCInitStructure.TIM_OCIdleState = TIM_OCIdleState_Reset;   
+	
+	//Initialize the peripheral TIMX based on the parameter specified in TIM_OCINITSTRUCT
+  //根据TIM_OCInitStruct中指定的参数初始化外设TIMx	
+	TIM_OC1Init(TIM12, &TIM_OCInitStructure); 
+		TIM_OC2Init(TIM12, &TIM_OCInitStructure); 
+	//Channel preload enable
+	//通道预装载使能	 
+	TIM_OC1PreloadConfig(TIM12, TIM_OCPreload_Enable);
+		TIM_OC2PreloadConfig(TIM12, TIM_OCPreload_Enable);
+	//-----------舵机初始化-----------//
+
+
+	TIM_CtrlPWMOutputs(TIM12,ENABLE); 	
+	//Enable timer //使能定时器
+	TIM_Cmd(TIM12, ENABLE); 		 
+
+  //The channel value is initialized to 1500, corresponding to the steering gear zero
+	//通道值初始化为1500，舵机零点对应值
+	TIM12->CCR2=1500;
+	TIM12->CCR1=1500;
+
+}
+
diff --git a/HARDWARE/timer.h b/HARDWARE/timer.h
new file mode 100644
index 0000000..598f2ee
--- /dev/null
+++ b/HARDWARE/timer.h
@@ -0,0 +1,11 @@
+#ifndef __TIMER_H
+#define __TIMER_H
+#include "system.h"
+void TIM8_Cap_Init(u16 arr, u16 psc);
+void TIM12_SERVO_Init(u16 arr,u16 psc);
+void TIM8_SERVO_Init(u16 arr,u16 psc);
+
+extern int L_Remoter_Ch1,L_Remoter_Ch2,L_Remoter_Ch3,L_Remoter_Ch4;
+extern int Remoter_Ch1,Remoter_Ch2,Remoter_Ch3,Remoter_Ch4;
+
+#endif
diff --git a/HARDWARE/usartx.c b/HARDWARE/usartx.c
new file mode 100644
index 0000000..9fa47ef
--- /dev/null
+++ b/HARDWARE/usartx.c
@@ -0,0 +1,936 @@
+#include "usartx.h"
+SEND_DATA Send_Data;
+RECEIVE_DATA Receive_Data;
+extern int Time_count;
+
+/**************************************************************************
+Function: Usartx3, Usartx1,Usartx5 and CAN send data task 
+Input   : none
+Output  : none
+函数功能：串口3、串口1、串口5、CAN发送数据任务
+入口参数：无
+返回  值：无
+**************************************************************************/
+void data_task(void *pvParameters)
+{
+	 u32 lastWakeTime = getSysTickCnt();
+	
+   while(1)
+    {	
+			//The task is run at 20hz
+			//此任务以20Hz的频率运行
+			vTaskDelayUntil(&lastWakeTime, F2T(RATE_20_HZ));
+			//Assign the data to be sent
+			//对要进行发送的数据进行赋值
+			data_transition(); 
+			USART1_SEND();     //Serial port 1 sends data //串口1发送数据
+			USART3_SEND();     //Serial port 3 (ROS) sends data  //串口3(ROS)发送数据
+			USART5_SEND();		 //Serial port 5 sends data //串口5发送数据
+			CAN_SEND();        //CAN send data //CAN发送数据	
+		}
+}
+/**************************************************************************
+Function: The data sent by the serial port is assigned
+Input   : none
+Output  : none
+函数功能：串口发送的数据进行赋值
+入口参数：无
+返回  值：无
+**************************************************************************/
+void data_transition(void)
+{
+	Send_Data.Sensor_Str.Frame_Header = FRAME_HEADER; //Frame_header //帧头
+	Send_Data.Sensor_Str.Frame_Tail = FRAME_TAIL;     //Frame_tail //帧尾
+	
+	//According to different vehicle types, different kinematics algorithms were selected to carry out the forward kinematics solution, 
+	//and the three-axis velocity was obtained from each wheel velocity
+	//根据不同车型选择不同运动学算法进行运动学正解，从各车轮速度求出三轴速度
+	switch(Car_Mode)
+	{	
+		case Mec_Car:      
+			Send_Data.Sensor_Str.X_speed = ((MOTOR_A.Encoder+MOTOR_B.Encoder+MOTOR_C.Encoder+MOTOR_D.Encoder)/4)*1000;
+	    Send_Data.Sensor_Str.Y_speed = ((MOTOR_A.Encoder-MOTOR_B.Encoder+MOTOR_C.Encoder-MOTOR_D.Encoder)/4)*1000; 
+	    Send_Data.Sensor_Str.Z_speed = ((-MOTOR_A.Encoder-MOTOR_B.Encoder+MOTOR_C.Encoder+MOTOR_D.Encoder)/4/(Axle_spacing+Wheel_spacing))*1000;         
+		  break; 
+		
+    case Omni_Car:      
+			Send_Data.Sensor_Str.X_speed = ((MOTOR_C.Encoder-MOTOR_B.Encoder)/2/X_PARAMETER)*1000; 
+	    Send_Data.Sensor_Str.Y_speed = ((MOTOR_A.Encoder*2-MOTOR_B.Encoder-MOTOR_C.Encoder)/3)*1000; 
+	    Send_Data.Sensor_Str.Z_speed = ((MOTOR_A.Encoder+MOTOR_B.Encoder+MOTOR_C.Encoder)/3/Omni_turn_radiaus)*1000;      
+		  break; 
+    
+		case Akm_Car:  
+			Send_Data.Sensor_Str.X_speed = ((MOTOR_A.Encoder+MOTOR_B.Encoder)/2)*1000; 
+			Send_Data.Sensor_Str.Y_speed = 0;
+			Send_Data.Sensor_Str.Z_speed = ((MOTOR_B.Encoder-MOTOR_A.Encoder)/Wheel_spacing)*1000;
+		  break; 
+		
+		case Diff_Car: 
+			Send_Data.Sensor_Str.X_speed = ((MOTOR_A.Encoder+MOTOR_B.Encoder)/2)*1000; 
+			Send_Data.Sensor_Str.Y_speed = 0;
+			Send_Data.Sensor_Str.Z_speed = ((MOTOR_B.Encoder-MOTOR_A.Encoder)/Wheel_spacing)*1000;
+			break; 
+		
+		case FourWheel_Car:
+      Send_Data.Sensor_Str.X_speed = ((MOTOR_A.Encoder+MOTOR_B.Encoder+MOTOR_C.Encoder+MOTOR_D.Encoder)/4)*1000; 
+	    Send_Data.Sensor_Str.Y_speed = 0;
+	    Send_Data.Sensor_Str.Z_speed = ((-MOTOR_B.Encoder-MOTOR_A.Encoder+MOTOR_C.Encoder+MOTOR_D.Encoder)/2/(Axle_spacing+Wheel_spacing))*1000;
+		 break; 
+		
+		case Tank_Car:   
+			Send_Data.Sensor_Str.X_speed = ((MOTOR_A.Encoder+MOTOR_B.Encoder)/2)*1000; 
+			Send_Data.Sensor_Str.Y_speed = 0;
+			Send_Data.Sensor_Str.Z_speed = ((MOTOR_B.Encoder-MOTOR_A.Encoder)/(Wheel_spacing)*1000);
+			break; 
+	}
+	
+	//The acceleration of the triaxial acceleration //加速度计三轴加速度
+	Send_Data.Sensor_Str.Accelerometer.X_data= accel[1]; //The accelerometer Y-axis is converted to the ros coordinate X axis //加速度计Y轴转换到ROS坐标X轴
+	Send_Data.Sensor_Str.Accelerometer.Y_data=-accel[0]; //The accelerometer X-axis is converted to the ros coordinate y axis //加速度计X轴转换到ROS坐标Y轴
+	Send_Data.Sensor_Str.Accelerometer.Z_data= accel[2]; //The accelerometer Z-axis is converted to the ros coordinate Z axis //加速度计Z轴转换到ROS坐标Z轴
+	
+	//The Angle velocity of the triaxial velocity //角速度计三轴角速度
+	Send_Data.Sensor_Str.Gyroscope.X_data= gyro[1]; //The Y-axis is converted to the ros coordinate X axis //角速度计Y轴转换到ROS坐标X轴
+	Send_Data.Sensor_Str.Gyroscope.Y_data=-gyro[0]; //The X-axis is converted to the ros coordinate y axis //角速度计X轴转换到ROS坐标Y轴
+	if(Flag_Stop==0) 
+		//If the motor control bit makes energy state, the z-axis velocity is sent normall
+	  //如果电机控制位使能状态，那么正常发送Z轴角速度
+		Send_Data.Sensor_Str.Gyroscope.Z_data=gyro[2];  
+	else  
+		//If the robot is static (motor control dislocation), the z-axis is 0
+    //如果机器人是静止的（电机控制位失能），那么发送的Z轴角速度为0		
+		Send_Data.Sensor_Str.Gyroscope.Z_data=0;        
+	
+	//Battery voltage (this is a thousand times larger floating point number, which will be reduced by a thousand times as well as receiving the data).
+	//电池电压(这里将浮点数放大一千倍传输，相应的在接收端在接收到数据后也会缩小一千倍)
+	Send_Data.Sensor_Str.Power_Voltage = Voltage*1000; 
+	
+	Send_Data.buffer[0]=Send_Data.Sensor_Str.Frame_Header; //Frame_heade //帧头
+  Send_Data.buffer[1]=Flag_Stop; //Car software loss marker //小车软件失能标志位
+	
+	//The three-axis speed of / / car is split into two eight digit Numbers
+	//小车三轴速度,各轴都拆分为两个8位数据再发送
+	Send_Data.buffer[2]=Send_Data.Sensor_Str.X_speed >>8; 
+	Send_Data.buffer[3]=Send_Data.Sensor_Str.X_speed ;    
+	Send_Data.buffer[4]=Send_Data.Sensor_Str.Y_speed>>8;  
+	Send_Data.buffer[5]=Send_Data.Sensor_Str.Y_speed;     
+	Send_Data.buffer[6]=Send_Data.Sensor_Str.Z_speed >>8; 
+	Send_Data.buffer[7]=Send_Data.Sensor_Str.Z_speed ;    
+	
+	//The acceleration of the triaxial axis of / / imu accelerometer is divided into two eight digit reams
+	//IMU加速度计三轴加速度,各轴都拆分为两个8位数据再发送
+	Send_Data.buffer[8]=Send_Data.Sensor_Str.Accelerometer.X_data>>8; 
+	Send_Data.buffer[9]=Send_Data.Sensor_Str.Accelerometer.X_data;   
+	Send_Data.buffer[10]=Send_Data.Sensor_Str.Accelerometer.Y_data>>8;
+	Send_Data.buffer[11]=Send_Data.Sensor_Str.Accelerometer.Y_data;
+	Send_Data.buffer[12]=Send_Data.Sensor_Str.Accelerometer.Z_data>>8;
+	Send_Data.buffer[13]=Send_Data.Sensor_Str.Accelerometer.Z_data;
+	
+	//The axis of the triaxial velocity of the / /imu is divided into two eight digits
+	//IMU角速度计三轴角速度,各轴都拆分为两个8位数据再发送
+	Send_Data.buffer[14]=Send_Data.Sensor_Str.Gyroscope.X_data>>8;
+	Send_Data.buffer[15]=Send_Data.Sensor_Str.Gyroscope.X_data;
+	Send_Data.buffer[16]=Send_Data.Sensor_Str.Gyroscope.Y_data>>8;
+	Send_Data.buffer[17]=Send_Data.Sensor_Str.Gyroscope.Y_data;
+	Send_Data.buffer[18]=Send_Data.Sensor_Str.Gyroscope.Z_data>>8;
+	Send_Data.buffer[19]=Send_Data.Sensor_Str.Gyroscope.Z_data;
+	
+	//Battery voltage, split into two 8 digit Numbers
+	//电池电压,拆分为两个8位数据发送
+	Send_Data.buffer[20]=Send_Data.Sensor_Str.Power_Voltage >>8; 
+	Send_Data.buffer[21]=Send_Data.Sensor_Str.Power_Voltage; 
+
+  //Data check digit calculation, Pattern 1 is a data check
+  //数据校验位计算，模式1是发送数据校验
+	Send_Data.buffer[22]=Check_Sum(22,1); 
+	
+	Send_Data.buffer[23]=Send_Data.Sensor_Str.Frame_Tail; //Frame_tail //帧尾
+}
+/**************************************************************************
+Function: Serial port 1 sends data
+Input   : none
+Output  : none
+函数功能：串口1发送数据
+入口参数：无
+返回  值：无
+**************************************************************************/
+void USART1_SEND(void)
+{
+  unsigned char i = 0;	
+	
+	for(i=0; i<24; i++)
+	{
+		usart1_send(Send_Data.buffer[i]);
+	}	 
+}
+/**************************************************************************
+Function: Serial port 3 sends data
+Input   : none
+Output  : none
+函数功能：串口3发送数据
+入口参数：无
+返回  值：无
+**************************************************************************/
+void USART3_SEND(void)
+{
+  unsigned char i = 0;	
+	for(i=0; i<24; i++)
+	{
+		usart3_send(Send_Data.buffer[i]);
+	}	 
+}
+/**************************************************************************
+Function: Serial port 5 sends data
+Input   : none
+Output  : none
+函数功能：串口5发送数据
+入口参数：无
+返回  值：无
+**************************************************************************/
+void USART5_SEND(void)
+{
+  unsigned char i = 0;	
+	for(i=0; i<24; i++)
+	{
+		usart5_send(Send_Data.buffer[i]);
+	}	 
+}
+/**************************************************************************
+Function: CAN sends data
+Input   : none
+Output  : none
+函数功能：CAN发送数据
+入口参数：无
+返 回 值：无
+**************************************************************************/
+void CAN_SEND(void) 
+{
+	u8 CAN_SENT[8],i;
+	
+	for(i=0;i<8;i++)
+	{
+	  CAN_SENT[i]=Send_Data.buffer[i];
+	}
+	CAN1_Send_Num(0x101,CAN_SENT);
+	
+	for(i=0;i<8;i++)
+	{
+	  CAN_SENT[i]=Send_Data.buffer[i+8];
+	}
+	CAN1_Send_Num(0x102,CAN_SENT);
+	
+	for(i=0;i<8;i++)
+	{
+	  CAN_SENT[i]=Send_Data.buffer[i+16];
+	}
+	CAN1_Send_Num(0x103,CAN_SENT);
+}
+/**************************************************************************
+Function: Serial port 1 initialization
+Input   : none
+Output  : none
+函数功能：串口1初始化
+入口参数：无
+返 回 值：无
+**************************************************************************/
+void uart1_init(u32 bound)
+{  	 
+	GPIO_InitTypeDef GPIO_InitStructure;
+	USART_InitTypeDef USART_InitStructure;
+	NVIC_InitTypeDef NVIC_InitStructure;
+	
+	RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOA, ENABLE);	 //Enable the gpio clock //使能GPIO时钟
+	RCC_APB2PeriphClockCmd(RCC_APB2Periph_USART1, ENABLE); //Enable the Usart clock //使能USART时钟
+
+	GPIO_PinAFConfig(GPIOA,GPIO_PinSource9,GPIO_AF_USART1);	
+	GPIO_PinAFConfig(GPIOA,GPIO_PinSource10 ,GPIO_AF_USART1);	 
+	
+	GPIO_InitStructure.GPIO_Pin = GPIO_Pin_9|GPIO_Pin_10;
+	GPIO_InitStructure.GPIO_Mode=GPIO_Mode_AF;            //输出模式
+	GPIO_InitStructure.GPIO_OType=GPIO_OType_PP;          //推挽输出
+	GPIO_InitStructure.GPIO_Speed=GPIO_Speed_50MHz;       //高速50MHZ
+	GPIO_InitStructure.GPIO_PuPd=GPIO_PuPd_UP;            //上拉
+	GPIO_Init(GPIOA, &GPIO_InitStructure);  		          //初始化
+	
+  //UsartNVIC configuration //UsartNVIC配置
+	NVIC_InitStructure.NVIC_IRQChannel = USART1_IRQn;
+	//Preempt priority //抢占优先级
+	NVIC_InitStructure.NVIC_IRQChannelPreemptionPriority=1 ;
+	//Subpriority //子优先级
+	NVIC_InitStructure.NVIC_IRQChannelSubPriority = 0;		
+	//Enable the IRQ channel //IRQ通道使能
+	NVIC_InitStructure.NVIC_IRQChannelCmd = ENABLE;	
+  //Initialize the VIC register with the specified parameters 
+	//根据指定的参数初始化VIC寄存器	
+	NVIC_Init(&NVIC_InitStructure);	
+	
+  //USART Initialization Settings 初始化设置
+	USART_InitStructure.USART_BaudRate = bound; //Port rate //串口波特率
+	USART_InitStructure.USART_WordLength = USART_WordLength_8b; //The word length is 8 bit data format //字长为8位数据格式
+	USART_InitStructure.USART_StopBits = USART_StopBits_1; //A stop bit //一个停止位
+	USART_InitStructure.USART_Parity = USART_Parity_No; //Prosaic parity bits //无奇偶校验位
+	USART_InitStructure.USART_HardwareFlowControl = USART_HardwareFlowControl_None; //No hardware data flow control //无硬件数据流控制
+	USART_InitStructure.USART_Mode = USART_Mode_Rx | USART_Mode_Tx;	//Sending and receiving mode //收发模式
+	USART_Init(USART1, &USART_InitStructure); //Initialize serial port 1 //初始化串口1
+	
+	USART_ITConfig(USART1, USART_IT_RXNE, ENABLE); //Open the serial port to accept interrupts //开启串口接受中断
+	USART_Cmd(USART1, ENABLE);                     //Enable serial port 1 //使能串口1
+}
+/**************************************************************************
+Function: Serial port 2 initialization
+Input   : none
+Output  : none
+函数功能：串口2初始化
+入口参数：无
+返回  值：无
+**************************************************************************/
+void uart2_init(u32 bound)
+{  	 
+	GPIO_InitTypeDef GPIO_InitStructure;
+	USART_InitTypeDef USART_InitStructure;
+	NVIC_InitTypeDef NVIC_InitStructure;
+
+	RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOD, ENABLE);	 //Enable the gpio clock  //使能GPIO时钟
+	RCC_APB1PeriphClockCmd(RCC_APB1Periph_USART2, ENABLE); //Enable the Usart clock //使能USART时钟
+	
+	GPIO_PinAFConfig(GPIOD,GPIO_PinSource5,GPIO_AF_USART2);	
+	GPIO_PinAFConfig(GPIOD,GPIO_PinSource6 ,GPIO_AF_USART2);	 
+	
+	GPIO_InitStructure.GPIO_Pin = GPIO_Pin_5|GPIO_Pin_6;
+	GPIO_InitStructure.GPIO_Mode=GPIO_Mode_AF;            //输出模式
+	GPIO_InitStructure.GPIO_OType=GPIO_OType_PP;          //推挽输出
+	GPIO_InitStructure.GPIO_Speed=GPIO_Speed_50MHz;       //高速50MHZ
+	GPIO_InitStructure.GPIO_PuPd=GPIO_PuPd_UP;            //上拉
+	GPIO_Init(GPIOD, &GPIO_InitStructure);  		          //初始化
+	
+	//UsartNVIC configuration //UsartNVIC配置
+	NVIC_InitStructure.NVIC_IRQChannel = USART2_IRQn;
+	//Preempt priority //抢占优先级
+	NVIC_InitStructure.NVIC_IRQChannelPreemptionPriority=1 ;
+	//Subpriority //子优先级
+	NVIC_InitStructure.NVIC_IRQChannelSubPriority = 0;	
+  //Enable the IRQ channel //IRQ通道使能	
+	NVIC_InitStructure.NVIC_IRQChannelCmd = ENABLE;
+  //Initialize the VIC register with the specified parameters 
+	//根据指定的参数初始化VIC寄存器		
+	NVIC_Init(&NVIC_InitStructure);	
+	
+	//USART Initialization Settings 初始化设置
+	USART_InitStructure.USART_BaudRate = bound; //Port rate //串口波特率
+	USART_InitStructure.USART_WordLength = USART_WordLength_8b; //The word length is 8 bit data format //字长为8位数据格式
+	USART_InitStructure.USART_StopBits = USART_StopBits_1; //A stop bit //一个停止
+	USART_InitStructure.USART_Parity = USART_Parity_No; //Prosaic parity bits //无奇偶校验位
+	USART_InitStructure.USART_HardwareFlowControl = USART_HardwareFlowControl_None; //No hardware data flow control //无硬件数据流控制
+	USART_InitStructure.USART_Mode = USART_Mode_Rx | USART_Mode_Tx;	//Sending and receiving mode //收发模式
+	USART_Init(USART2, &USART_InitStructure);      //Initialize serial port 2 //初始化串口2
+	
+	USART_ITConfig(USART2, USART_IT_RXNE, ENABLE); //Open the serial port to accept interrupts //开启串口接受中断
+	USART_Cmd(USART2, ENABLE);                     //Enable serial port 2 //使能串口2 
+}
+/**************************************************************************
+Function: Serial port 3 initialization
+Input   : none
+Output  : none
+函数功能：串口3初始化
+入口参数：无
+返回  值：无
+**************************************************************************/
+void uart3_init(u32 bound)
+{  	 
+  GPIO_InitTypeDef GPIO_InitStructure;
+	USART_InitTypeDef USART_InitStructure;
+	NVIC_InitTypeDef NVIC_InitStructure;
+	
+	RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOD, ENABLE);	 //Enable the gpio clock  //使能GPIO时钟
+  RCC_APB1PeriphClockCmd(RCC_APB1Periph_USART3, ENABLE); //Enable the Usart clock //使能USART时钟
+	
+	GPIO_PinAFConfig(GPIOD,GPIO_PinSource8,GPIO_AF_USART3);	
+	GPIO_PinAFConfig(GPIOD,GPIO_PinSource9,GPIO_AF_USART3);	 
+	
+	GPIO_InitStructure.GPIO_Pin = GPIO_Pin_8|GPIO_Pin_9;
+	GPIO_InitStructure.GPIO_Mode=GPIO_Mode_AF;            //输出模式
+	GPIO_InitStructure.GPIO_OType=GPIO_OType_PP;          //推挽输出
+	GPIO_InitStructure.GPIO_Speed=GPIO_Speed_50MHz;       //高速50MHZ
+	GPIO_InitStructure.GPIO_PuPd=GPIO_PuPd_UP;            //上拉
+	GPIO_Init(GPIOD, &GPIO_InitStructure);  		          //初始化
+	
+  //UsartNVIC configuration //UsartNVIC配置
+  NVIC_InitStructure.NVIC_IRQChannel = USART3_IRQn;
+	//Preempt priority //抢占优先级
+	NVIC_InitStructure.NVIC_IRQChannelPreemptionPriority=2 ;
+	//Preempt priority //抢占优先级
+	NVIC_InitStructure.NVIC_IRQChannelSubPriority = 0;		
+	//Enable the IRQ channel //IRQ通道使能	
+	NVIC_InitStructure.NVIC_IRQChannelCmd = ENABLE;	
+  //Initialize the VIC register with the specified parameters 
+	//根据指定的参数初始化VIC寄存器		
+	NVIC_Init(&NVIC_InitStructure);
+	
+  //USART Initialization Settings 初始化设置
+	USART_InitStructure.USART_BaudRate = bound; //Port rate //串口波特率
+	USART_InitStructure.USART_WordLength = USART_WordLength_8b; //The word length is 8 bit data format //字长为8位数据格式
+	USART_InitStructure.USART_StopBits = USART_StopBits_1; //A stop bit //一个停止
+	USART_InitStructure.USART_Parity = USART_Parity_No; //Prosaic parity bits //无奇偶校验位
+	USART_InitStructure.USART_HardwareFlowControl = USART_HardwareFlowControl_None; //No hardware data flow control //无硬件数据流控制
+	USART_InitStructure.USART_Mode = USART_Mode_Rx | USART_Mode_Tx;	//Sending and receiving mode //收发模式
+  USART_Init(USART3, &USART_InitStructure);      //Initialize serial port 3 //初始化串口3
+	
+  USART_ITConfig(USART3, USART_IT_RXNE, ENABLE); //Open the serial port to accept interrupts //开启串口接受中断
+  USART_Cmd(USART3, ENABLE);                     //Enable serial port 3 //使能串口3 
+}
+/**************************************************************************
+Function: Serial port 5 initialization
+Input   : none
+Output  : none
+函数功能：串口5初始化
+入口参数：无
+返回  值：无
+**************************************************************************/
+void uart5_init(u32 bound)
+{  	 
+  GPIO_InitTypeDef GPIO_InitStructure;
+	USART_InitTypeDef USART_InitStructure;
+	NVIC_InitTypeDef NVIC_InitStructure;
+	
+	//PC12 TX
+	RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOC, ENABLE);	 //Enable the gpio clock  //使能GPIO时钟
+		//PD2 RX
+	RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOD, ENABLE);	 //Enable the gpio clock  //使能GPIO时钟
+  RCC_APB1PeriphClockCmd(RCC_APB1Periph_UART5, ENABLE); //Enable the Usart clock //使能USART时钟
+
+	GPIO_PinAFConfig(GPIOC,GPIO_PinSource12,GPIO_AF_UART5);	
+	GPIO_PinAFConfig(GPIOD,GPIO_PinSource2 ,GPIO_AF_UART5);	 
+	
+	GPIO_InitStructure.GPIO_Pin = GPIO_Pin_12;
+	GPIO_InitStructure.GPIO_Mode=GPIO_Mode_AF;            //输出模式
+	GPIO_InitStructure.GPIO_OType=GPIO_OType_PP;          //推挽输出
+	GPIO_InitStructure.GPIO_Speed=GPIO_Speed_50MHz;       //高速50MHZ
+	GPIO_InitStructure.GPIO_PuPd=GPIO_PuPd_UP;            //上拉
+	GPIO_Init(GPIOC, &GPIO_InitStructure);  		          //初始化
+
+	GPIO_InitStructure.GPIO_Pin = GPIO_Pin_2;
+	GPIO_InitStructure.GPIO_Mode=GPIO_Mode_AF;            //输出模式
+	GPIO_InitStructure.GPIO_OType=GPIO_OType_PP;          //推挽输出
+	GPIO_InitStructure.GPIO_Speed=GPIO_Speed_50MHz;       //高速50MHZ
+	GPIO_InitStructure.GPIO_PuPd=GPIO_PuPd_UP;            //上拉
+	GPIO_Init(GPIOD, &GPIO_InitStructure);  		          //初始化
+	
+  //UsartNVIC configuration //UsartNVIC配置
+  NVIC_InitStructure.NVIC_IRQChannel = UART5_IRQn;
+	//Preempt priority //抢占优先级
+	NVIC_InitStructure.NVIC_IRQChannelPreemptionPriority=2 ;
+	//Preempt priority //抢占优先级
+	NVIC_InitStructure.NVIC_IRQChannelSubPriority = 0;		
+	//Enable the IRQ channel //IRQ通道使能	
+	NVIC_InitStructure.NVIC_IRQChannelCmd = ENABLE;	
+  //Initialize the VIC register with the specified parameters 
+	//根据指定的参数初始化VIC寄存器		
+	NVIC_Init(&NVIC_InitStructure);
+	
+  //USART Initialization Settings 初始化设置
+	USART_InitStructure.USART_BaudRate = bound; //Port rate //串口波特率
+	USART_InitStructure.USART_WordLength = USART_WordLength_8b; //The word length is 8 bit data format //字长为8位数据格式
+	USART_InitStructure.USART_StopBits = USART_StopBits_1; //A stop bit //一个停止
+	USART_InitStructure.USART_Parity = USART_Parity_No; //Prosaic parity bits //无奇偶校验位
+	USART_InitStructure.USART_HardwareFlowControl = USART_HardwareFlowControl_None; //No hardware data flow control //无硬件数据流控制
+	USART_InitStructure.USART_Mode = USART_Mode_Rx | USART_Mode_Tx;	//Sending and receiving mode //收发模式
+  USART_Init(UART5, &USART_InitStructure);      //Initialize serial port 5 //初始化串口5
+  USART_ITConfig(UART5, USART_IT_RXNE, ENABLE); //Open the serial port to accept interrupts //开启串口接受中断
+  USART_Cmd(UART5, ENABLE);                     //Enable serial port 5 //使能串口5
+}
+/**************************************************************************
+Function: Serial port 1 receives interrupted
+Input   : none
+Output  : none
+函数功能：串口1接收中断
+入口参数：无
+返 回 值：无
+**************************************************************************/
+int USART1_IRQHandler(void)
+{	
+	if(USART_GetITStatus(USART1, USART_IT_RXNE) != RESET) //Check if data is received //判断是否接收到数据
+	{
+		u8 Usart_Receive;
+		static u8 Count;
+		static u8 rxbuf[11];
+		int check=0,error=1,i;
+		
+		Usart_Receive = USART_ReceiveData(USART1); //Read the data //读取数据
+		if(Time_count0) 
+			Count++; 
+		else 
+			Count=0;
+		
+		if (Count == 11) //Verify the length of the packet //验证数据包的长度
+		{   
+				Count=0; //Prepare for the serial port data to be refill into the array //为串口数据重新填入数组做准备
+				if(rxbuf[10] == FRAME_TAIL) //Verify the frame tail of the packet //验证数据包的帧尾
+				{			
+					for(i=0; i<9; i++)
+					{
+						//XOR bit check, used to detect data error
+						//异或位校验，用于检测数据是否出错
+						check=rxbuf[i]^check; 
+					}
+					if(check==rxbuf[9]) 
+						//XOR bit check successful
+					  //异或位校验成功
+					  error=0; 
+					
+					if(error==0)	 
+				  {		
+						float Vz;
+            if(Usart1_ON_Flag==0)
+						{	
+							//Serial port 1 controls flag position 1, other flag position 0
+							//串口1控制标志位置1，其它标志位置0
+							//Usart_ON_Flag=1;
+							Usart1_ON_Flag=1;
+							APP_ON_Flag=0;
+							PS2_ON_Flag=0;
+							Remote_ON_Flag=0;
+							CAN_ON_Flag=0;
+						}		
+							command_lost_count=0; //CAN/串口控制命令丢失计数清零
+		
+						//Calculate the 3-axis target velocity from the serial data, which is divided into 8-bit high and 8-bit low units mm/s
+						//从串口数据求三轴目标速度，分高8位和低8位 单位mm/s
+						Move_X=XYZ_Target_Speed_transition(rxbuf[3],rxbuf[4]);
+						Move_Y=XYZ_Target_Speed_transition(rxbuf[5],rxbuf[6]);
+						Vz    =XYZ_Target_Speed_transition(rxbuf[7],rxbuf[8]);
+						if(Car_Mode==Akm_Car)
+						{
+							Move_Z=Vz_to_Akm_Angle(Move_X, Vz);
+						}
+						else
+						{
+							Move_Z=XYZ_Target_Speed_transition(rxbuf[7],rxbuf[8]);
+						}		
+					}
+			  }
+		 }
+	}
+		return 0;	
+}
+/**************************************************************************
+Function: Refresh the OLED screen
+Input   : none
+Output  : none
+函数功能：串口2接收中断
+入口参数：无
+返回  值：无
+**************************************************************************/
+int USART2_IRQHandler(void)
+{	
+	int Usart_Receive;
+	if(USART_GetITStatus(USART2, USART_IT_RXNE) != RESET) //Check if data is received //判断是否接收到数据
+	{	      
+		static u8 Flag_PID,i,j,Receive[50],Last_Usart_Receive;
+		static float Data;
+				
+		Usart_Receive=USART2->DR; //Read the data //读取数据
+		
+		if(Deviation_Count=0x41&&Usart_Receive<=0x48)  
+			{	
+				Flag_Direction=Usart_Receive-0x40;
+			}
+			else	if(Usart_Receive<=8)   
+			{			
+				Flag_Direction=Usart_Receive;
+			}	
+			else  Flag_Direction=0;
+		}
+		else if(Turn_Flag==1)
+		{
+			//APP steering control interface command
+			//APP转向控制界面命令
+			if     (Usart_Receive==0x43) Flag_Left=0,Flag_Right=1; //Right rotation //右自转
+			else if(Usart_Receive==0x47) Flag_Left=1,Flag_Right=0; //Left rotation  //左自转
+			else                         Flag_Left=0,Flag_Right=0;
+			if     (Usart_Receive==0x41||Usart_Receive==0x45) Flag_Direction=Usart_Receive-0x40;
+			else  Flag_Direction=0;
+		}
+		if(Usart_Receive==0x58)  RC_Velocity=RC_Velocity+100; //Accelerate the keys, +100mm/s //加速按键，+100mm/s
+		if(Usart_Receive==0x59)  RC_Velocity=RC_Velocity-100; //Slow down buttons,   -100mm/s //减速按键，-100mm/s
+	  
+	 // The following is the communication with the APP debugging interface
+	 //以下是与APP调试界面通讯
+	 if(Usart_Receive==0x7B) Flag_PID=1;   //The start bit of the APP parameter instruction //APP参数指令起始位
+	 if(Usart_Receive==0x7D) Flag_PID=2;   //The APP parameter instruction stops the bit    //APP参数指令停止位
+
+	 if(Flag_PID==1) //Collect data //采集数据
+	 {
+		Receive[i]=Usart_Receive;
+		i++;
+	 }
+	 if(Flag_PID==2) //Analyze the data //分析数据
+	 {
+			if(Receive[3]==0x50) 	 PID_Send=1;
+			else  if(Receive[1]!=0x23) 
+      {								
+				for(j=i;j>=4;j--)
+				{
+					Data+=(Receive[j-1]-48)*pow(10,i-j);
+				}
+				switch(Receive[1])
+				 {
+					 case 0x30:  RC_Velocity=Data;break;
+					 case 0x31:  Velocity_KP=Data;break;
+					 case 0x32:  Velocity_KI=Data;break;
+					 case 0x33:  break;
+					 case 0x34:  break;
+					 case 0x35:  break;
+					 case 0x36:  break;
+					 case 0x37:  break;
+					 case 0x38:  break; 	
+				 }
+      }		
+      //Relevant flag position is cleared			
+      //相关标志位清零			
+			Flag_PID=0;
+			i=0;
+			j=0;
+			Data=0;
+			memset(Receive, 0, sizeof(u8)*50); //Clear the array to zero//数组清零
+	 }
+   if(RC_Velocity<0)   RC_Velocity=0; 	 
+  }
+  return 0;	
+}
+/**************************************************************************
+Function: Serial port 3 receives interrupted
+Input   : none
+Output  : none
+函数功能：串口3接收中断
+入口参数：无
+返回  值：无
+**************************************************************************/
+float test_movz = 0;
+int USART3_IRQHandler(void)
+{	
+	static u8 Count=0;
+	u8 Usart_Receive;
+
+	if(USART_GetITStatus(USART3, USART_IT_RXNE) != RESET) //Check if data is received //判断是否接收到数据
+	{
+		Usart_Receive = USART_ReceiveData(USART3);//Read the data //读取数据
+		if(Time_count0) 
+			Count++; 
+		else 
+			Count=0;
+		
+		if (Count == 11) //Verify the length of the packet //验证数据包的长度
+		{   
+				Count=0; //Prepare for the serial port data to be refill into the array //为串口数据重新填入数组做准备
+				if(Receive_Data.buffer[10] == FRAME_TAIL) //Verify the frame tail of the packet //验证数据包的帧尾
+				{
+					//Data exclusionary or bit check calculation, mode 0 is sent data check
+					//数据异或位校验计算，模式0是发送数据校验
+					if(Receive_Data.buffer[9] ==Check_Sum(9,0))	 
+				  {	
+						float Vz;						
+						//All modes flag position 0, USART3 control mode
+            //所有模式标志位置0，为Usart3控制模式						
+						PS2_ON_Flag=0;
+						Remote_ON_Flag=0;
+						APP_ON_Flag=0;
+						CAN_ON_Flag=0;
+						Usart1_ON_Flag=0;
+						Usart5_ON_Flag=0;
+						command_lost_count=0; //CAN/串口控制命令丢失计数清零
+
+						//Calculate the target speed of three axis from serial data, unit m/s
+						//从串口数据求三轴目标速度， 单位m/s
+						Move_X=XYZ_Target_Speed_transition(Receive_Data.buffer[3],Receive_Data.buffer[4]);
+						Move_Y=XYZ_Target_Speed_transition(Receive_Data.buffer[5],Receive_Data.buffer[6]);
+						Vz    =XYZ_Target_Speed_transition(Receive_Data.buffer[7],Receive_Data.buffer[8]);
+						test_movz = Vz;
+						if(Car_Mode==Akm_Car)
+						{
+							Move_Z=Vz_to_Akm_Angle(Move_X, Vz);
+						}
+						else
+						{
+							Move_Z=XYZ_Target_Speed_transition(Receive_Data.buffer[7],Receive_Data.buffer[8]);
+						}				  }
+
+			}
+		}
+	} 
+  return 0;	
+}
+
+/**************************************************************************
+Function: Serial port 5 receives interrupted
+Input   : none
+Output  : none
+函数功能：串口5接收中断
+入口参数：无
+返回  值：无
+**************************************************************************/
+int UART5_IRQHandler(void)
+{	
+	static u8 Count=0;
+	u8 Usart_Receive;
+
+	if(USART_GetITStatus(UART5, USART_IT_RXNE) != RESET) //Check if data is received //判断是否接收到数据
+	{
+		Usart_Receive = USART_ReceiveData(UART5);//Read the data //读取数据
+		if(Time_count0) 
+			Count++; 
+		else 
+			Count=0;
+		
+		if (Count == 11) //Verify the length of the packet //验证数据包的长度
+		{   
+				Count=0; //Prepare for the serial port data to be refill into the array //为串口数据重新填入数组做准备
+				if(Receive_Data.buffer[10] == FRAME_TAIL) //Verify the frame tail of the packet //验证数据包的帧尾
+				{
+					//Data exclusionary or bit check calculation, mode 0 is sent data check
+					//数据异或位校验计算，模式0是发送数据校验
+					if(Receive_Data.buffer[9] ==Check_Sum(9,0))	 
+				  {	
+						float Vz;						
+						//All modes flag position 0, USART3 control mode
+            //所有模式标志位置0，为Usart5控制模式						
+						PS2_ON_Flag=0;
+						Remote_ON_Flag=0;
+						APP_ON_Flag=0;
+						CAN_ON_Flag=0;
+						Usart5_ON_Flag=0;
+						command_lost_count=0; //CAN/串口控制命令丢失计数清零
+
+						//Calculate the target speed of three axis from serial data, unit m/s
+						//从串口数据求三轴目标速度， 单位m/s
+						Move_X=XYZ_Target_Speed_transition(Receive_Data.buffer[3],Receive_Data.buffer[4]);
+						Move_Y=XYZ_Target_Speed_transition(Receive_Data.buffer[5],Receive_Data.buffer[6]);
+						Vz    =XYZ_Target_Speed_transition(Receive_Data.buffer[7],Receive_Data.buffer[8]);
+						if(Car_Mode==Akm_Car)
+						{
+							Move_Z=Vz_to_Akm_Angle(Move_X, Vz);
+						}
+						else
+						{
+							Move_Z=XYZ_Target_Speed_transition(Receive_Data.buffer[7],Receive_Data.buffer[8]);
+						}				  }
+					
+			}
+		}
+	} 
+  return 0;	
+}
+/**************************************************************************
+Function: After the top 8 and low 8 figures are integrated into a short type data, the unit reduction is converted
+Input   : 8 bits high, 8 bits low
+Output  : The target velocity of the robot on the X/Y/Z axis
+函数功能：将上位机发过来目标前进速度Vx、目标角速度Vz，转换为阿克曼小车的右前轮转角
+入口参数：目标前进速度Vx、目标角速度Vz，单位：m/s，rad/s
+返回  值：阿克曼小车的右前轮转角，单位：rad
+**************************************************************************/
+
+float test_z=0;
+float Vz_to_Akm_Angle(float Vx, float Vz)
+{
+	float R, AngleR, Min_Turn_Radius;
+	//float AngleL;
+	
+	//Ackermann car needs to set minimum turning radius
+	//If the target speed requires a turn radius less than the minimum turn radius,
+	//This will greatly improve the friction force of the car, which will seriously affect the control effect
+	//阿克曼小车需要设置最小转弯半径
+	//如果目标速度要求的转弯半径小于最小转弯半径，
+	//会导致小车运动摩擦力大大提高，严重影响控制效果
+	Min_Turn_Radius=MINI_AKM_MIN_TURN_RADIUS;
+	
+	if(Vz!=0 && Vx!=0)
+	{
+		//If the target speed requires a turn radius less than the minimum turn radius
+		//如果目标速度要求的转弯半径小于最小转弯半径
+//		if(float_abs(Vx/Vz)<=Min_Turn_Radius)
+//		{
+//			//Reduce the target angular velocity and increase the turning radius to the minimum turning radius in conjunction with the forward speed
+//			//降低目标角速度，配合前进速度，提高转弯半径到最小转弯半径
+//			if(Vz>0)
+//				Vz= float_abs(Vx)/(Min_Turn_Radius);
+//			else	
+//				Vz=-float_abs(Vx)/(Min_Turn_Radius);	
+//		}		
+		//R=Vx/Vz;
+		R=Vx/Vz;
+		//AngleL=atan(Axle_spacing/(R+0.5*Wheel_spacing));
+		AngleR=atan(Axle_spacing/(R+0.05*Wheel_spacing));//2025.7.20edit
+	}
+	else
+	{
+		AngleR=0;
+	}
+	test_z = AngleR;//test
+	return AngleR;
+}
+/**************************************************************************
+Function: After the top 8 and low 8 figures are integrated into a short type data, the unit reduction is converted
+Input   : 8 bits high, 8 bits low
+Output  : The target velocity of the robot on the X/Y/Z axis
+函数功能：将上位机发过来的高8位和低8位数据整合成一个short型数据后，再做单位还原换算
+入口参数：高8位，低8位
+返回  值：机器人X/Y/Z轴的目标速度
+**************************************************************************/
+float XYZ_Target_Speed_transition(u8 High,u8 Low)
+{
+	//Data conversion intermediate variable
+	//数据转换的中间变量
+	short transition; 
+	
+	//将高8位和低8位整合成一个16位的short型数据
+	//The high 8 and low 8 bits are integrated into a 16-bit short data
+	transition=((High<<8)+Low); 
+	return 
+		transition/1000+(transition%1000)*0.001; //Unit conversion, mm/s->m/s //单位转换, mm/s->m/s						
+}
+/**************************************************************************
+Function: Serial port 1 sends data
+Input   : The data to send
+Output  : none
+函数功能：串口1发送数据
+入口参数：要发送的数据
+返回  值：无
+**************************************************************************/
+void usart1_send(u8 data)
+{
+	USART1->DR = data;
+	while((USART1->SR&0x40)==0);	
+}
+/**************************************************************************
+Function: Serial port 2 sends data
+Input   : The data to send
+Output  : none
+函数功能：串口2发送数据
+入口参数：要发送的数据
+返回  值：无
+**************************************************************************/
+void usart2_send(u8 data)
+{
+	USART2->DR = data;
+	while((USART2->SR&0x40)==0);	
+}
+/**************************************************************************
+Function: Serial port 3 sends data
+Input   : The data to send
+Output  : none
+函数功能：串口3发送数据
+入口参数：要发送的数据
+返回  值：无
+**************************************************************************/
+void usart3_send(u8 data)
+{
+	USART3->DR = data;
+	while((USART3->SR&0x40)==0);	
+}
+
+/**************************************************************************
+Function: Serial port 5 sends data
+Input   : The data to send
+Output  : none
+函数功能：串口5发送数据
+入口参数：要发送的数据
+返回  值：无
+**************************************************************************/
+void usart5_send(u8 data)
+{
+	UART5->DR = data;
+	while((UART5->SR&0x40)==0);	
+}
+/**************************************************************************
+Function: Calculates the check bits of data to be sent/received
+Input   : Count_Number: The first few digits of a check; Mode: 0-Verify the received data, 1-Validate the sent data
+Output  : Check result
+函数功能：计算要发送/接收的数据校验结果
+入口参数：Count_Number：校验的前几位数；Mode：0-对接收数据进行校验，1-对发送数据进行校验
+返回  值：校验结果
+**************************************************************************/
+u8 Check_Sum(unsigned char Count_Number,unsigned char Mode)
+{
+	unsigned char check_sum=0,k;
+	
+	//Validate the data to be sent
+	//对要发送的数据进行校验
+	if(Mode==1)
+	for(k=0;kN==sKwXAI
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�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∈+o5n@i^H8R|K1>6-~WtsNc6;IX)&WV
zOX>1=uj2h
znbkAX&0~w^@#!}+kG(fYIes$lO)SU5Y_C24KgIK~W)tOYy0rSK(&`I5GMdW~(QP6>
zXron}E`GFW9uLIxIGyFVP5JRU2F%~Iay+5@`0IEcZaE&FX8qW!wE7VDWPl%Nj5a}W
z>prZCC2B|;{!q8k0;Mj;cp*kCv^iz-$xb(>2PD3t2U&S~nz%ivH2w-EWhcUoI8lc9
zB#sVl+T=?J2HZr-5Gop)u^H13);L&;PMt2^&ne%2ib3v)@TSZcq3Qn_yjLmSpF9QL
z?0b;j&eO_*gEvE2LO$8@liqNH-r7C0LJT>Xt{wS`_5;4jJvY)1;E=M;hzLKY3;$__
z|AAugwXa{g{WMS8zfWM`Q4PM+K$9OU%)izxdSpO3ddF%`Qjb47&ANGz@E7}^{a;$3u(F3KFZ{go2{w?QU1^?D8mChhLsbMGs&{ySu+?(U6
zjAuYOXVH})uMzy06Mx_T5OtEHQ>7bBp6Z-->9SKv_~kzJlOYQWi1q{H=O`7X%)n){
zC-AOm^5VGi0$cGtfaRBu7E@Z!64G&8t%Af3^S)9@&xHk;N5On$*az3X|1H2KZ%j8F
z7@csOR1Xk}X&!s3Q1N>Dq?EtlcNU6`$T~U6$ZxOI)bB(4fC6X>Xy|Rm*_uwRJzuxM
zvb~mR6A?G6b=md^(PIc~J*sa;kTxZap-DR!8P@lc)5iBD#rH3CISMCJ-?BJejl)8T
zFOSm)I>1*LMfr~-OtckY98HQjN}`UbJBSpQE9P|4bZGk8KB4I!(JC-n$;hkLz3IU2
zWBGlbQ;}}%Giy9vnl^n`DenKOH3EX3UW)@&%hTs-y-?~w9!OhO1TooAEx8uqtzq?8
z${^TvIQ3uKYT9@zAqW8j*i+aJm(R~F$QyjfI=t12e=Tbl=eYMunY!^`V%_5GLab)x
zCLBs0Zw{fd7QL$TC*R=C6cH&M8YEXrwKF5|zozgX<~YKe0snD@|4(eM-wgQoDE$95
zw+Q?fg~wBBGa~dUyGCl3PRo
zPOLbOo-d613RUGo)B1)VMcIb}gBPHyY&JnTwLdkD{JzipeE*YFpKQGW^J$U2X~3MP
zW%zTeGRxEFNfTOzwccFoDiw+fkP14
zAJ$YZW8>!ekYi{S;N2p4Z=Wj94-JeObto>gdm8Y%1zz#>q2U~I4gxv&ShG;{`&xQ!
zTB*Uk;8Ml&cxiB#ZxPA32XNWAufvybSQkwb&k9?En~MkBK?K%L(6C1kXcYb`ou*u_
z`EofIlv@D|Uui^s{&FKFZu?dH6=6Ip&{Z
zUPjmA=ow~8w>p-yWsW}HU#P#4^BDmjB!O>%6*!4T6`hh*G3v+K>8>7_t%*gIxc5?=)y}4dsNpSi`-i
zT=0goYfzJUz=~a$Hz`>xQmz-N@H{L_hp9x&XA4)&L2lrs+Ta^eib8VURNGm9L#^lt
zsej{Wb)|x&lN~n-;J?s;0ds&4g+*3fra24Zqor=iJ3GMWOVi`>+X
zCV%DRN(kN+2q(FLaO9?)P8RTHQ!Af4@
z-^P;4mH@0xX731m#DA5zua^G~@zGP8wdUxC9DM&1F`+~R0g9j*pH^d}0=17iOk<$1qj-b8Bzq3p}$E905(<1MSgXx0WdB5GZ}W2X*k
z?$wm?2G&<{fLmM`LTVJMw{y5p2G$~b%jN!YEO$Sf3Ah`D&$3{R66q`%{43+$JE`Ap
zVJQc)&89#N?;^0^Qk>x-Uk-t#Ci-6OjS}j4V!zPgBe_GMwgDrOTF++lv3#9n2To%E4*#!zRu
zo0YMxtxtT*%Fn4If)Qr4!oZ%74J&L`?nmtg)A-?ECF4LgVsXfQ&Bo(
zS%|IBxnz7#=sEm9*4~kxK}t5d__}yn_cZYxES0`b-YIgyaV*)_fQ|KRN{Nmmk91?t
z%#m3=gXR3g=s=<@wpr{6)r$M`2P2F1v~d5
ziJ2y!kFsBO=b{HDV_Dp%^{1bEv-x-5t=szZ$tHppvX8oRU#YwuUn0EyO}o7nyGq!+
zV81GMQM0jFfj!hTNai3%QUg0BV1pD49O}yETiTw|Ygf%6pwuAbLs%F);HVQ2b>!vy(I6i5~v*RjbO)Vvs=hZIJ
ziGQL^a;{FjB5lId>GR_@q0gttN;&RtIW5QZMWUMY+j{b)cO{gRl@y^~x98UQqA>OB
z38+)F2(-6ZTG>*m8!Cms_3+y$=iARB6A;s|0dzG3v0}I+V^#)QC)T)QLW(!v>9$YCiTm5Mr}Ae!=1miwEja}W
zq9U!bd#=`Y)FKFebRT6@AGmM&2_Knwv0w9{nxJj3Yj7q(V++IRm%b~6#`kiHg9oq)
zY1}7@A)PMMexI0Zy^rPd#-)Fn=F3j;U=o$3pHL7T~vzwN9M|CzJ+{Oh^NpdoD*Qcd2ym
zzD#(3CCR?r)C6n)+N}6A$}}zrQfoN(wzovtd+|}pAKeBlQ~}x380Ai}#hWF)>bd?g
z?V7M2Jy~KNPih&z4O?Fec?}BG=-ds+&whOqY5}~5q?s>+t_}x?xn$|ph
zb#b~9P!^}JlK*!3H`@e>ua3b?T@IR57XO0nrX0=6I?uWuU?kUAr92%A#9xY!s@z5t
z=1b<-`cHCAgC8erz>mOxUGj#lL7vR_-zkMv+bTCc{(Oo2cPWrwlHTGrVTwTrXNv<^GtUt|O0fXfS-u
zwkYyQ?bNCB=vmUq^G~1*0Jtbu1fY&W2V=-vdMP={kf61nedDfg1Q!BY18)C7v-T(*C|GX$#I9yZD)J`-SHH6_*H$UlFoV
zH`20jb)pen(TyBekwHH^-DZk<(}-x^lVKBuGhMOpn7^_VbkcQ{Q!eWp+oY^tQE|qq
zEYy7#2#P^`^)ju>RWDZK#m2JkW}i$|`YO98xeYWle6cx3hjTU)6B5v#Q*|nwrGDNy@O6m7GnOrMu^
zjmJM|85RhA0Dqo=AHbdTZ%3APei9>qTmV9Z)819uZ!IzJ$29M6v3b{_r==(?=9XB(
zjC46!Yi%28M+itFqXnfXG|={gQJ-@jcDveJp+
zIXeb-e`zvwg{t^9X7m*&$dL6=5^Rn_n}IlKFOeZKjv#o>N83pp4QU`Dd<)y1lY-ME
z+8zDoX{bQUbbN&EymV~QAd7HPcd^&y>Qd_#ktOc*FlC5DWa7xJvh!$(I3Co!vG`aE
zaOBXy>A{dqg-o;oir=@Z*-?XC;P>>OplxYJ9-Gj5}4Wkf2g*2gePhr3V?ZZ9>a*~
zaQr)Vs@i^2&0`Ont+c-lS#ScHi)PVSALG&RppA}8OcmxE^Mx`{HM$&^RCi_1xRp90
z`v-*wQ_bhZTO}VZl$K?`#q!aqdOMbTVzPPNg6}McnhJ?9C*(h&%{xCUflrw7-wYYD
zJ1A=mw4|tzJndH+G*}&|K#)?zp%MpOzf%$p-{I;t&;M7-gYuDZZ@3s9$LFiK-qpNJj90!zD!ZFeOa;6X!^JyBfu&Tq%7GDNLw)VS0!b10)n5
zRa3_dODmty*z;c~Qa
z@50-`JCI6~DjCgPXx?U7J!0ZXFrH?ITiNR0p;}
z)Z<3!MC=!9$MDH;sXBPtw#E9>xVC+GGDG@qXo8!TWiOH%Bcjy-$U=EsuTLa!sDzI*(e4oV=#i7W5gIsh?D^Xj^pb
z6KH|mU_9cTsz`-cLF*IiV?z<*JM%KushBOsW>?+36E$<Pqz_s|o
z-Ql^N=f_6J`gv*|G_j0LX`gozwvoaDBD7R077L$0tTWFz#oEqU)TH0ahMrdR;`BP{
z`>K6}uccwn{MBw!UeE7L7SA`!`Z?Lx`>i=w|_S=ec7_T+t;h}6Zf_&gST
zV9eql3JL$w#jw-`W9B}LP&GYT;YtQaxPV{Q`)R*!s`TktBshLZag^yS;6}F7q}d{Q
zU_w=V@FvWsoZFkiVBAQzQI~Aal6BQ62$GB1rmd&rZBxZ>tX%N>7Ik(R$C9M{u+FU*
z1{;Z}k;(WAn2nCZD6qgGrN-t|T{l%c4yqhIsrp%~)iRNqS*%>?RfXKh_FOQ@?;|Pj
z0Rm!*$TSZ)?!#A3h(I3XW)R)i;Le&G?*{L^km#w)VCC6DKmD@aEPnEq+5l`yFXw`gqacA=luEcVGp#VT|9nIa+y#XWlyL;1bV`#KtU=M>L4!|-2NI^iEXsvOr*`255!DvQm|JmC+$
z2Y+O%HfHx^>$#o|V028TLTLPml?^ORE(=hFA^ZFg3uJ$|B)G3#C~)sqxMyRC%o#Z&
zkr#oyB(oi;LnDSf%|5EVCFQw%jpS+CbD1R*qOQ^b+@y4j!||@t@_1D@4|0|f2%jpC
z2TLl)p1D$vs#rToxo{Ht>
zG0@E%b$gnwlH%lz9>b%@wbUqvf;n^pj^pP#e$MG^l5b*Rps1X~PB@bvMUa8|inM;Y
z+y9qDP$hkVYor_(;6JY~>6}V4Fs3{p?Vi>JegB4fVRXLoaw;%>&a(`B|5d<9&yl8s
zvO0A*ug@1ae=}V;3v^5A*QX2TdFoi-|Kli}snfVzr$8{yM-r1ZeZr?3@t;>;Tyqs}
zGh>TN1nYHVXy4FScC>%6fB#r^;4t{8+s2RCk3L)bm5l`R(SGZFMe@n5ot)zQv0&pO
znlO9p%r5pm*^delL`0n=RwV#;ikJxvn&9#iR~5m{?v&k=+hQy0I|&b^%YB<#%6Wyr
z;yD0?=ve@ketbnYWrI$N3!zLheJ+3Z%hpmZ#pOTNx3RAg`fQzi`G!Y^Ztm+pV5luL
z-X$=&dbJ>pa%Yr7FnYQgIw7y2lF#P4SYzhAFYr-%Swb^H^%Hedft}k`ALe2}f}e_O
z+f?9%P_oW`?a=lDs-+(NB!HSpOkwe)-
zy<-PWd@Iq}{X>TjC`8l|GX~36Ft5H$7E6;Q(i@$r^<*{P^V|1By#wYR9@u;GGm(=RC1(Wyh=xILn#_%xhc=lZ3bJR$|Sbi~>1p
znSiute?M_Y;vqHz6q;n>jtm}h&Bs6eyaWez!fPH}UZRT+4ebeo;Fu$!oqT9$w;Ng}
zq1W@Fp}XDCKtenC&`|z|7qt`66D@U(x)+3ja5%6T>?I<2v4CEpgAWaj;6>Oe(%~Vx
z`fwws2y_QG2FIXB)3dFKr&p?V@}W&pgr*ApdOkF?815Q60q!JOJZ}egrE6Y#OINo3
zaFdkb#j@G(Yt)?=o}-<~Ka9cFS8WQ;fyhN3=rCbXJeX=CJmR?!u8XHBM}&h>9^Dhm
z;oW$@3pZp0|8nic|J}H~L>`{G@)}GdIkE77!v}+>oZjKrDbtrD15hfGzmuN96XrkN
z^k3HeLw?_j_a`LNkdAnR!6GD~(_SvW{v4hY@tY6}h3ELdotSP6R;*B<4=O@%%
z!RJYJhdjV*Vjb=vasPXgAJ2&Uq`u$FclSD1{of7$4BaR7{r!B0GrX3<1$c~?p!=l0
zGag*I%fx#Z(>w9*iNj;#0(gv~m+{XlN4&gF`b?M@4wtuImiL@0Wjr^0T*Jd=gS1Gkb7*iIA7XQoSOY
z#3{pGNf6;Q^T^p@JMo5GLP{|^62zet6R1~&QuGenwoQ0(ktGVGOH39cX)0rB*5Q5Q
zDbm!((l8%Zgo*OO$bO`V+X*9|H}N`(SkgQjTa&N$BBl--=&fE6LaSGVGu4O*GBH7T
zktX!xvqs$^HyFtcZ_@BkCTw`f2UCc=2r>GsMZyVf3`U6A7{nvY=Kx-SbSU~1&OS*)
zfeJ6J4cGI*6tUWn5-;iFYiOhw?UtK@=Vpgjcl{H2!$VMVodlZbvIH$yV{|A#<3*sXBNQ{^jahh4|#^8)J}LU=SY+EiOQMVD%5M1K%nTP{`-xI=NmYl7$kFFqLTC5qvtp~djh&|-LLXaui9dVsQ+
z~0RTRg=hyXaDJhb3l
z5eji!6M99;PdH8;YEnR9VM(4w+_Bv04Sw;#6b`z06P?O(lk!jChC73YT=(PuGq@df
z$OdVPD~!2M+^W8<)Iw!>?XuGP9m7L_IYvUl_#g?7a;;bGD&zTwL17<
za18necnLki_;6H6yimLuL>h!TnXE@PTln0g0bdixUJY1_hg@WCHExGREbd=b
zBIozw_7XSByZNKHY3BFBnM^#e%Y?{7gJr&h!H(E4*pU$pjYzgbQw@zkW?4}@w~mn_
zay8=rG2D)btP8!uJXpvla06$eDVOzg7{D+Sjd{vt{T!0fUrQ@iibDER$B5&+Qn0|+&P_at;V3(
zgqN0F_{`uKpPjO4XsFZ(z$u%CM(Pe3SG2Db=@=19(1;HviuI)EZRO=h>JH`Q@9<7P
z2kpD?`igjkJnX~kQSk~Z-QLhEf(Z?JR0=*6Y^1z%Bvj-;LnGyNXr-YMPCK;H(1;AN
zjD}WpGBS!>$>(>~UBl-O)Scn;q$@H!`ei(^@(Wr
zmz7DqB4wbrvA{JnBI!yUX*V=9LOVx}H8esySB^Iz7ZjeEg_i@H!H#-h6q3xykA_Ct
zGs4c*v6Xm>Lw9gvZ~^GKI%HV0ky#S4czh;gNhk
zs8`4>L~?sV8XBRcLn{ppna{LNSv54mr6{e=Mf?e9#o!pNTt0p0?385#tZ|94-Jj*l-{M{vj}MoK5&H>y<=9AdPT~oUJ=?*
zW#{9fiae55y&`D~m&2(eN`?rS|Hx@bp1gWcfM%2l2m$Uy;;_0G;1OP|@el|;7#!1<
z4t+EHIlMfAzfOP7MhDPd(dPVrkBInD55+cIPBDBfj
zPq1SXf6UU!^#qrnBV)$!l1b_94
z;P9(Vf3l>2esg44nbwJT;Z=Z-|Iy%(rxTY;D^sLg>J^cV(^amSichru4uk5bzY9W1
zfrEZAJ)mA4ZmcMrhY%EpL%$dt^_l?ABL(2lF9t`wCV(?i01o|PaMUXTXFB%ebkec{
z=j&ustq~Sp>J`D6vO1Y|`5@xu=Rw~XUDPWtj{^0RS(jv2F=0`7kw(-Mn2!RvmBBl|
zOimg`h!u}kbsoLc;*OM=G7hQ6t;6tcOULNX;C4VWC-sUzc~)XY>=E_qL_l~MH2Kib
z0!^fh_i1RPiCl_A`81%fgB^2HuLyQ);GIVcdOAZdOiCIUe$jcYct!1e`o%I-16TU-
z8X75c3?|DIS0eN)4pT$(U|OCTB+CIqF7`^Aa63ht6MBX8CJQvyPPpV^G1QAWhF5_i
zsaHgP^Jowe1tO5oJ4b#QAx44a1=G;CKt!joh=9CQrulqP-IaKRm&uL~1{dsj3O_Y8
zq#6OR?aeO>ePej3S40l~Z%j-1mAXU6U*mQa1YX52M*j+U=hZiQ#^S~5Mk8Xxq0=v>
zd(|rdx@F)%f$dQj42`Q?Bphe-ZrR#U;5J-$7xGiRw%{u!&%5XX=u*PrY`+CD&5?t5+Vc
zLK!4KfqVYmfM*bZSTBhk_a%LKAwkD;CJ7$lRSp-5BI~i~W*oeKz}+jr$n(^n@x*Q7
z<*nr>S%H?c(Jp!SsecWh2h`1ihnH5L>-k`?Lo!A&N{bH-&7(_BHy8}c`20)Uz@~!F
zm(@+A!iz6p7#|Fd$x0Glh2ee%A%x54U`3z$b&@7R`1A_M*UD$>&w-j(~F0Z87Qa2rov4CB_GXV_Kd(2S54H
z&`!9*%Z1H~2s{`wyvpH{a)v%|(9@~Y3_2AYR^L20^qeA`Qt&w-_~o=SUL*Ljz$o`T
zKL14BHGIBc{P74ct#vZD&)}G}8K(20p%FWJKD?1n2#XGvZX2+l2;oI}Py8&NjjDnx
z`D{`*)lqmkcrv&+o*Ej#)5U2OAWno+_bI~LP7!{p^jDlBJ%t(gg)J{$@or>|4r
cxvi3@^$rV2AH?xOqRO;d$lB<^Apg
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
-2$SFVOVw|A?d0dPatZXz7~HUd5L8
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�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	#2Y`=0(8>78*iQuy
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
EAEflo1ONa4

literal 0
HcmV?d00001

diff --git a/OBJ/OriginCar.build_log.htm b/OBJ/OriginCar.build_log.htm
new file mode 100644
index 0000000..f393e52
--- /dev/null
+++ b/OBJ/OriginCar.build_log.htm
@@ -0,0 +1,94 @@
+
+
+
+
礦ision Build Log

+
Tool Versions:

+IDE-Version: μVision V5.31.0.0
+Copyright (C) 2020 ARM Ltd and ARM Germany GmbH. All rights reserved.
+License Information: cyy 3289288508@qq.com, cyy, LIC=LJWP0-B9SZ1-INEA7-EASNE-5UIX9-6I4GD
+ 
+Tool Versions:
+Toolchain:       MDK-ARM Professional  Version: 5.31.0.0
+Toolchain Path:  D:\Keil_v5\ARM\ARMCC\Bin
+C Compiler:      Armcc.exe V5.06 update 6 (build 750)
+Assembler:       Armasm.exe V5.06 update 6 (build 750)
+Linker/Locator:  ArmLink.exe V5.06 update 6 (build 750)
+Library Manager: ArmAr.exe V5.06 update 6 (build 750)
+Hex Converter:   FromElf.exe V5.06 update 6 (build 750)
+CPU DLL:         SARMCM3.DLL V5.31.0.0
+Dialog DLL:      DCM.DLL V1.17.3.0
+Target DLL:      CMSIS_AGDI.dll V1.32.6.0
+Dialog DLL:      TCM.DLL V1.46.0.0
+ 
+
Project:

+E:\race_save\smart_car2025\OriginCar智能机器人资料\OriginCar主板\OriginCar主板源码\origincar_controller\USER\OriginCar.uvprojx
+Project File Date:  06/06/2025
+
+
Output:

+*** Using Compiler 'V5.06 update 6 (build 750)', folder: 'D:\Keil_v5\ARM\ARMCC\Bin'
+Rebuild target 'FreeRTOS'
+compiling stm32f4xx_it.c...
+compiling can.c...
+compiling timer.c...
+compiling sys.c...
+compiling system_stm32f4xx.c...
+assembling startup_stm32f40_41xxx.s...
+compiling oled.c...
+compiling LED.C...
+compiling motor.c...
+compiling delay.c...
+compiling encoder.c...
+compiling adc.c...
+compiling main.c...
+compiling pstwo.c...
+compiling key.c...
+compiling usartx.c...
+..\HARDWARE\usartx.c(820): warning:  #1035-D: single-precision operand implicitly converted to double-precision
+  		AngleR=atan(Axle_spacing/(R+0.05*Wheel_spacing));//2025.7.20edit
+..\HARDWARE\usartx.c(793): warning:  #550-D: variable "Min_Turn_Radius"  was set but never used
+  	float R, AngleR, Min_Turn_Radius;
+..\HARDWARE\usartx.c: 2 warnings, 0 errors
+compiling misc.c...
+compiling usart.c...
+compiling stm32f4xx_gpio.c...
+compiling stm32f4xx_usart.c...
+compiling stm32f4xx_syscfg.c...
+compiling stm32f4xx_rcc.c...
+compiling stm32f4xx_adc.c...
+compiling stm32f4xx_pwr.c...
+compiling stm32f4xx_can.c...
+compiling croutine.c...
+compiling stm32f4xx_tim.c...
+compiling event_groups.c...
+compiling list.c...
+compiling queue.c...
+compiling tasks.c...
+compiling port.c...
+compiling timers.c...
+compiling heap_4.c...
+compiling system.c...
+compiling robot_select_init.c...
+compiling balance.c...
+compiling MPU6050.c...
+compiling show.c...
+compiling I2C.c...
+linking...
+Program Size: Code=51306 RO-data=6302 RW-data=640 ZI-data=24272  
+FromELF: creating hex file...
+"..\OBJ\OriginCar.axf" - 0 Error(s), 2 Warning(s).
+
+
Software Packages used:

+
+Package Vendor: Keil
+                http://www.keil.com/pack/Keil.STM32F4xx_DFP.2.13.0.pack
+                Keil.STM32F4xx_DFP.2.13.0
+                STMicroelectronics STM32F4 Series Device Support, Drivers and Examples
+
+
Collection of Component include folders:

+  D:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Drivers\CMSIS\Device\ST\STM32F4xx\Include
+
+
Collection of Component Files used:

+Build Time Elapsed:  00:00:03
+

+
+
diff --git a/OBJ/OriginCar.hex b/OBJ/OriginCar.hex
new file mode 100644
index 0000000..5883b0c
--- /dev/null
+++ b/OBJ/OriginCar.hex
@@ -0,0 +1,3610 @@
+:020000040800F2
+:10000000506100203103000815340008C1280008A1
+:1000100011340008F50E0008FB6200080000000023
+:10002000000000000000000000000000790200084D
+:10003000B515000800000000CD020008CD490008F9
+:100040004B0300084B0300084B0300084B03000858
+:100050004B0300084B0300084B0300084B03000848
+:100060004B0300084B0300084B0300084B03000838
+:100070004B0300084B0300084B0300084B03000828
+:100080004B0300084B0300084B0300084B03000818
+:10009000251100084B0300084B0300084B03000820
+:1000A0004B0300084B0300084B0300084B030008F8
+:1000B000754E00088D4E0008A54E00084B03000841
+:1000C0004B0300084B0300084B0300084B030008D8
+:1000D0004B030008815B0008F55C0008E55F000841
+:1000E0004B0300084B0300084B030008D54E0008E3
+:1000F000E95300084B030008ED4E00084B030008CD
+:100100004B0300084B030008BD4E00084B030008DA
+:100110004B030008515A00084B0300084B0300082A
+:100120004B0300084B0300084B0300084B03000877
+:100130004B0300084B0300084B0300084B03000867
+:100140004B0300084B0300084B0300084B03000857
+:100150004B0300084B0300084B0300084B03000847
+:100160004B0300084B0300084B0300084B03000837
+:100170004B0300084B0300084B0300084B03000827
+:100180004B0300084B03000800F002F800F064F88D
+:100190000AA090E8000C82448344AAF10107DA45E2
+:1001A00001D100F059F8AFF2090EBAE80F0013F0D0
+:1001B000010F18BFFB1A43F0010318472CDF0000A2
+:1001C0004CDF00000A444FF0000C10F8013B13F024
+:1001D000070408BF10F8014B1D1108BF10F8015BA0
+:1001E000641E05D010F8016B641E01F8016BF9D193
+:1001F00013F0080F1EBF10F8014BAD1C0C1B09D1EA
+:100200006D1E58BF01F801CBFAD505E014F8016B5B
+:1002100001F8016B6D1EF9D59142D6D370470000ED
+:100220000023002400250026103A28BF78C1FBD8FF
+:10023000520728BF30C148BF0B607047642900F0E7
+:100240000381732900F03E82002070471FB50CF037
+:100250004EFB1FBD10B510BD00F0B0FA1146FFF700
+:10026000F5FF08F08DF900F0CEFA03B4FFF7F2FFC6
+:1002700003BC07F0B1FD00002A4B19680868B0E81C
+:10028000F04F80F30988BFF36F8F4FF0000080F3C9
+:10029000118870470000000006480068006880F37D
+:1002A000088862B661B6BFF34F8FBFF36F8F00DF70
+:1002B00000BF00BF08ED00E0DFF80C00016841F46A
+:1002C00070010160704700BF88ED00E0EFF3098026
+:1002D000BFF36F8F134B1A681EF0100F08BF20ED8D
+:1002E000108A20E9F04F106008B44FF0500080F3FE
+:1002F0001188BFF34F8FBFF36F8F0AF085FD4FF06A
+:10030000000080F3118808BC19680868B0E8F04F55
+:100310001EF0100F08BFB0EC108A80F30988BFF3FD
+:100320006F8F7047E8000020EFF3058070470000F2
+:100330000948804709480047FEE7FEE7FEE7FEE779
+:10034000FEE7FEE7FEE7FEE7FEE7FEE704480549B5
+:10035000054A064B70470000DD4900088901000886
+:10036000505B002050610020505D0020505D002057
+:10037000704700000FB4044910B503AA029800F0BA
+:10038000A5F910BC5DF814FBD00000202DE9F04168
+:100390000E460446002020622046E168884730B3BC
+:1003A000252805D0D4E901219047206A401CF2E7B6
+:1003B000E168204600278847050018D0A5F14100D4
+:1003C000192802D820354FF40067324629462046C6
+:1003D0002760FFF733FF40B1012804D0F61D26F057
+:1003E00007060836D8E7361DD6E72846DAE7206A3A
+:1003F000BDE8F08170B50C460546012A05D0287885
+:10040000800600D5EA69002302E0012305E05B1CB9
+:10041000934202D2E05C0028F9D1A869E618C01A1C
+:10042000A861286A184428622846AFF3008004E0D7
+:10043000D5E9012114F8010B9047B442F8D32846BE
+:10044000AFF3008070BD00002DE9F04106460024A6
+:1004500010687529314616A510D0AFF3008000282A
+:1004600002DA404213A507E031688A0701D512A5D8
+:1004700002E0490704D511A5012401E0AFF3008093
+:1004800000210A2206F1240709E0B0FBF2FCB0FBD0
+:10049000F2F302FB1C00303078541846491C002847
+:1004A000F3D123462A463046BDE8F04100F086B835
+:1004B000000000002D0000002B00000020000000C4
+:1004C000032A40F2308010F0030C00F0158011F880
+:1004D000013BBCF1020F624498BF11F801CB00F858
+:1004E000013B38BF11F8013BA2F1040298BF00F8AC
+:1004F00001CB38BF00F8013B11F0030300F0F88096
+:10050000083AC0F0088051F8043B083A51F804CB8F
+:10051000A0E80810F5E7121D5CBF51F8043B40F855
+:10052000043BAFF30080D20724BF11F8013B11F860
+:1005300001CB48BF11F8012B24BF00F8013B00F8A4
+:1005400001CB48BF00F8012B704702F0FF0343EADC
+:10055000032242EA024200F002B84FF000020429EE
+:10056000C0F0128010F0030C00F0F680CCF1040C07
+:10057000BCF1020F18BF00F8012BA8BF20F8022B16
+:10058000A1EB0C0100F0E8B85FEAC17C24BF00F8E1
+:10059000012B00F8012B48BF00F8012B7047704772
+:1005A00070477047704710B500F0FCF8006810BD48
+:1005B00010B5044600F0F6F8046010BD2DE9F047D0
+:1005C0000D4699469246044600F1240801688806C3
+:1005D00004D5E06921F01001216000E00120A8426B
+:1005E00001DD471B00E00027A1697A1902EB090031
+:1005F000081AA0612078C00602D42046AFF300801C
+:10060000002608E0D4E901211AF806009047206A84
+:10061000401C761C20624E45F4DB2078C0060AD5CB
+:100620002046AFF3008006E0D4E901213020904756
+:10063000206A401C2062381EA7F10107F4DC07E0A5
+:10064000D4E9012118F805009047206A401C206277
+:10065000281EA5F10105F3DC2046AFF300802078C9
+:10066000000602D50220BDE8F0870120FBE700006C
+:1006700001694A1C02610878704700B58FB0CDE966
+:1006800001310021059105497944CDE90310114656
+:100690006846FFF77BFE0FB000BD0000E5FFFFFFDF
+:1006A00010B5436913B1AFF3008001E0FFF7A2FE7C
+:1006B000012010BD127800F124010A7000224A7056
+:1006C0000122EDE711684FF0FF32E9E7074B70B503
+:1006D0000D467B44FFF7D1FF0446284600F066F83C
+:1006E00010B14FF0FF3070BD204670BD4F7E00004E
+:1006F00010B5203AC0F00B80B1E81850203AA0E8BD
+:100700001850B1E81850A0E81850BFF4F5AF5FEAF0
+:10071000027C24BFB1E81850A0E8185044BF18C9A3
+:1007200018C0BDE810405FEA827C24BF51F8043B4A
+:1007300040F8043B08BF7047D20728BF31F8023B9E
+:1007400048BF11F8012B28BF20F8023B48BF00F832
+:10075000012B70474FF0000200B5134694469646B1
+:10076000203922BFA0E80C50A0E80C50B1F12001C4
+:10077000BFF4F7AF090728BFA0E80C5048BF0CC072
+:100780005DF804EB890028BF40F8042B08BF7047D0
+:1007900048BF20F8022B11F0804F18BF00F8012B42
+:1007A0007047000000487047EC5A0020007B00F0C2
+:1007B0008000704700487047EC5A00207546FFF7EC
+:1007C000F9FFAE4605006946534620F0070085460E
+:1007D00018B020B5FFF7BAFDBDE820404FF0000685
+:1007E0004FF000074FF000084FF0000B21F0070119
+:1007F000AC46ACE8C009ACE8C009ACE8C009ACE85C
+:10080000C0098D46704710B50446AFF300802046FE
+:10081000BDE81040FFF729BD21B1826842F0010216
+:10082000826003E0826822F001028260704700006B
+:100830000021084A1168084A1140D0E900231A43F0
+:1008400083681A43C3681A431143044AC2F8041365
+:100850007047000004230140E030FCFF002001400D
+:100860000146C86C80B270470246002013680B40F6
+:100870000BB1012000E000207047000030B50246B7
+:10088000002000235068104C20400D790C6844EA89
+:1008900005242043506090680C4C2040D1E903545B
+:1008A0002C438D682C434D7944EA450420439060E5
+:1008B000D06A20F470000C7D641EE4B2234340EA49
+:1008C0000350D06230BD0000FFFEFFFCFDF7FFC00B
+:1008D000F0B504460D4600200021092D11DDE06829
+:1008E000A5F10A0606EB4607072606FA07F1884334
+:1008F000A5F10A0606EB460603FA06F10843E06096
+:100900000CE0206905EB4507072606FA07F1884346
+:1009100005EB450603FA06F108432061072A0FDAC2
+:10092000606B561E06EB86071F2606FA07F1884302
+:10093000561E06EB860605FA06F10843606322E0C0
+:100940000D2A0FDA206BD61F06EB86071F2606FA44
+:1009500007F18843D61F06EB860605FA06F1084321
+:10096000206310E0E06AA2F10D0606EB86071F2661
+:1009700006FA07F18843A2F10D0606EB860605FA92
+:1009800006F10843E062F0BD816841F0804181607A
+:1009900070470000F8B53848D0ED000A9FED371ACF
+:1009A0009FED370A10EE810AF3EE0B0A80EE201A53
+:1009B000BDEEC10A10EE106A642E00DD64263148D7
+:1009C00090ED000ADFED300A20EE200ABDEEC00AED
+:1009D00010EE104A002C00DA64422C4890ED000A18
+:1009E000DFED290A20EE200ABDEEC00A10EE105AF3
+:1009F000002D00DA6D422648007808B9012000E099
+:100A00000020234908702348007801281BD1224880
+:100A100090ED000ABDEEC00A10EE103A1F4890EDAE
+:100A2000000ABDEEC00A10EE102A1D4890ED000A23
+:100A3000BDEEC00A10EE101A1AA0FFF79BFC0020B2
+:100A40001449087017E01248007850B91948B0F9F5
+:100A50000400EAB2E1B23346009017A0FFF78AFC27
+:100A600009E01448B0F90430B0F90220B0F90010E0
+:100A700015A0FFF77FFCF8BD1800002000007A44A5
+:100A800000401C46745A00200000C842885A0020CA
+:100A90002C020020A2010020800100207C01002007
+:100AA0006C0100207B4325643A25643A25647D244B
+:100AB00000000000300200207B4125643A25643AA2
+:100AC00025643A25647D24007B4225643A25643AF6
+:100AD00025647D240000000000B58DB001210220B6
+:100AE00003F052FA0121080203F06EFA02200B9083
+:100AF00003208DF8300000208DF833000BA9154835
+:100B000001F004FB0121080203F06EFA00214FF40A
+:100B1000807003F069FA002007900A9009904FF462
+:100B20000030089007A8FFF783FE002001908DF8A1
+:100B300008008DF809000390059001208DF8180039
+:100B400001A90548FFF79AFE01210348FFF764FE5B
+:100B50000DB000BD000402400020014000B58DB082
+:100B60000121022003F010FA0121480203F02CFABF
+:100B700001200B9003208DF8300000208DF8330009
+:100B80000BA9154801F0C2FA0121480203F02CFA22
+:100B900000214FF4007003F027FA002007900A901C
+:100BA00009904FF40030089007A8FFF741FE00209D
+:100BB00001908DF808008DF8090003900590012040
+:100BC0008DF8180001A90548FFF758FE01210348D8
+:100BD000FFF722FE0DB000BD0004024000210140DD
+:100BE0001CB507F0ADFC019063E10A2101A809F0F2
+:100BF000DDFEB048006840F6B831884204DAAD48FE
+:100C00000068401CAB49086001F0EEFCAA4800688F
+:100C10000028E9D1A948007810B101F015FB16E0D1
+:100C2000A748007810B103F0ABFA10E0A5480078AF
+:100C300010B103F073F80AE0A34890ED001AA3483E
+:100C4000D0ED000AA24890ED000A00F0B5FC02F0D9
+:100C50007BF9A04890ED000ABDEEC00A10EE100A24
+:100C600004F0CEFE002879D19B4890ED021AF0EEF8
+:100C7000410A90ED001AB0EE410A01F0EDFF00EEDE
+:100C8000100AB8EEC00A944880ED010A934890ED2E
+:100C9000021AF0EE410A90ED001AB0EE410A02F09D
+:100CA00033F800EE100AB8EEC00A8C4880ED010A55
+:100CB0008B4890ED021AF0EE410A90ED001AB0EE6A
+:100CC000410A02F079F800EE100AB8EEC00A844832
+:100CD00080ED010A834890ED021AF0EE410A90ED92
+:100CE000001AB0EE410A02F0BFF800EE100AB8EEAA
+:100CF000C00A7C4880ED010A44F23C1002F060F921
+:100D000079480078062828D2DFE800F003294E64ED
+:100D100085AA0020734C009094ED010ABDEEC00A34
+:100D200010EE103A6E4C94ED010AB1EE400ABDEEA1
+:100D3000C00A10EE102A694C94ED010AB1EE400A87
+:100D4000BDEEC00A10EE101A634C94ED010ABDEE20
+:100D5000C00A10EE100A03F0F9FCA2E0A2E00020A5
+:100D6000604C009094ED010ABDEEC00A10EE103AFE
+:100D70005B4C94ED010AB1EE400ABDEEC00A10EEE4
+:100D8000102A564C94ED010ABDEEC00A10EE101A5E
+:100D9000514C94ED010AB1EE400ABDEEC00A10EECE
+:100DA000100A03F0D3FC7CE0504800684B4A0090E6
+:100DB00092ED010ABDEEC00A10EE101A464A92EDFD
+:100DC000010ABDEEC00A10EE100A494B5A4203F068
+:100DD000BDFC66E00020434C009094ED010ABDEE9E
+:100DE000C00A10EE103A3E4C94ED010ABDEEC00A66
+:100DF00010EE102A394C94ED010ABDEEC00A10EE37
+:100E0000101A354C94ED010ABDEEC00A10EE100A1E
+:100E100003F09CFC45E00020324C009094ED010A68
+:100E2000BDEEC00A10EE103A2D4C94ED010AB1EE61
+:100E3000400ABDEEC00A10EE102A284C94ED010ABB
+:100E4000B1EE400ABDEEC00A10EE101A224C94ED2D
+:100E5000010ABDEEC00A10EE100A03F077FC20E094
+:100E60000020204C009094ED010ABDEEC00A10EE67
+:100E7000103A1B4C94ED010ABDEEC00A10EE102A88
+:100E8000164C94ED010ABDEEC00A10EE101A124C79
+:100E900094ED010ABDEEC00A10EE100A03F056FCF4
+:100EA00000BF06E00020034602460146009003F022
+:100EB0004DFC9AE6D4010020B801002099010020E1
+:100EC0009A01002098010020780100207401002080
+:100ED0007001002018000020745A0020885A002059
+:100EE0009C5A0020B05A00206401002068010020B4
+:100EF00061BEFFFF00BFFEE71CB50121084603F0FD
+:100F000043F84FF48070009001208DF80400002019
+:100F10008DF8060003208DF8050001208DF80700EC
+:100F20006946024801F0F2F81CBD000000000240D2
+:100F30002DE9FE4304460D4616461F46DDF828906F
+:100F40004FF0000814B10DB106B117B90120BDE88A
+:100F5000FE83601EC4B2681EC5B2701EC6B2781E83
+:100F600087B20121082003F00FF80121480603F0A1
+:100F70001BF80320019002208DF8080000208DF856
+:100F80000A0003208DF8090001208DF80B0001A94B
+:100F9000614801F0BBF8092200215F4801F0FEF82A
+:100FA000092201215C4801F0F9F800205B49086042
+:100FB0000846006840F00100086008E008F1010000
+:100FC0001FFA80F8B8F1640F01DD0220BFE7534833
+:100FD000001D006800F001000028EFD04F480068B5
+:100FE0004E490860084600680860084600680860C6
+:100FF0000846006840F01000086008460068086075
+:10100000084600680860002044491C310860084612
+:10101000006840EA897008600846006840EA046099
+:1010200008600846006840EA055008600846006805
+:1010300040EA0640086008460068384308603748C0
+:10104000006820F001003549086009E008F101005E
+:101050001FFA80F84FF6F070804501DD032076E737
+:101060002E48001D006800F001000028EED12C4839
+:10107000006840F001002A49086029481C300068D7
+:1010800020F0010026491C31086025480C3000681A
+:1010900040F0010022490C3108602148001D006821
+:1010A0001F49091D08601E48143000681C4914318E
+:1010B000086000201A494031086000211848443077
+:1010C000016017481C30006840F0010014491C31D1
+:1010D0000860134800680020114908600F48143068
+:1010E000006840F002000D491431086014208DF8AA
+:1010F000000001208DF8010003208DF8020001207E
+:101100008DF80300684602F087F9012202210348A6
+:1011100000F0F2F900201AE7000C024000640040E1
+:101120000066004000B52DED028B89B003A805A92B
+:1011300006AB07AACDE9001008A9002000F088F846
+:1011400040F281110898884266D101203449087024
+:101150000020344908703449087034490870344913
+:10116000087034490870344908709DF80D009DF8E6
+:101170000C1000EB012000B200EE100AB8EEC00A1D
+:10118000DFED2E0A80EE201A2D4880ED001A9DF822
+:101190000F009DF80E1000EB012000B200EE100AC7
+:1011A000B8EEC00ADFED250A80EE201A254880ED52
+:1011B000001A9DF811009DF8101000EB012000B2FC
+:1011C00000EE100AB8EEC00ADFED1C0A80EE201A0D
+:1011D000B0EE418A1C48007802280AD1F0EE480A95
+:1011E000174890ED000A05F08BF8184880ED000ACA
+:1011F00011E09DF811009DF8101000EB012000B2E5
+:1012000000EE100AB8EEC00ADFED0C0A80EE201ADC
+:101210000E4880ED001A00BF09B0BDEC028B00BD86
+:101220009B010020980100209A01002099010020D4
+:101230009C0100209D010020DE01002000007A4476
+:10124000700100207401002064010020780100205A
+:10125000F0B5DDE90554324E06EB0016366806F0AF
+:1012600004061670167836B92D4E06EB0016366851
+:10127000760D0E6005E02A4E06EB00163668F6087D
+:101280000E60274E06EB0016366806F002061E704A
+:10129000234E06EB0016766806F00F062E70204EE1
+:1012A00006EB0016B66826701D4E06EB0016B668F3
+:1012B000360A66701A4E06EB0016B668360CA67033
+:1012C000174E06EB0016B668360EE670144E06EBA7
+:1012D0000016F6682671124E06EB0016F668360AFE
+:1012E00066710F4E06EB0016F668360CA6710C4EB2
+:1012F00006EB0016F668360EE67130B9094E366810
+:1013000046F02006074F3E6009E0012807D1054E50
+:10131000361D366846F02006024F3F1D3E60F0BD88
+:10132000B06500400C640040F8B506460D46002448
+:101330000823002211463046009500F015F80746B4
+:1013400001E0601C84B2384600F094F8072803D00E
+:1013500040F6FF708442F4DB40F6FF70844201DB0C
+:101360000120F8BD0020FCE7F0B505460E46059CBF
+:101370003E48006800F0806008B100210FE03B4863
+:10138000006800F0006008B1012108E037480068FB
+:1013900000F0805008B1022101E0FF20F0BD0027DD
+:1013A000334800EB011007601EB9C5F30A056D054F
+:1013B00002E025F06045ED002D4800EB01100068CB
+:1013C00028432B4F07EB01173860294800EB011029
+:1013D000006840EA8607264800EB011007602448B1
+:1013E00000EB0110006840EA4207214800EB0110C1
+:1013F000076003F00F031E4800EB0110406820F067
+:101400000F071B4800EB01104760194800EB011063
+:1014100040681843164F07EB01177860E079000623
+:10142000A77940EA0740677940EA07272079074310
+:101430000F4800EB0110C760E0780006A77840EA8B
+:101440000740677840EA072027783843084F07EBC2
+:101450000117B860064800EB0110006840F0010772
+:10146000034800EB01100760084697E70864004056
+:10147000806500400146002021B1012913D00229D6
+:1014800033D121E01B4A126802F001021043194ACD
+:10149000126802F002021043164A126802F08062DB
+:1014A00040EA126023E0134A126802F0010210437E
+:1014B000104A126802F0020210430E4A126802F04B
+:1014C000006240EA526012E00A4A126802F0010229
+:1014D0001043084A126802F002021043054A1268DB
+:1014E00002F0805240EA926001E0052000BF00BF98
+:1014F00070470000086400401AB143690B43436120
+:1015000002E043698B434361704700001CB500242F
+:1015100005E01848005D0DF80400601CC4B2082CFA
+:10152000F7DB694640F20110FFF7FEFE002407E0FA
+:10153000104904F10800085C0DF80400601CC4B2F6
+:10154000082CF5DB69464FF48170FFF7EDFE0024AF
+:1015500007E0084904F11000085C0DF80400601C65
+:10156000C4B2082CF5DB694640F20310FFF7DCFE3D
+:101570001CBD00008C06002010B502460B46002062
+:10158000012B08D1002104E0084C645C60404C1C35
+:10159000E1B29142F8DB43B9002104E0044C645C01
+:1015A00060404C1CE1B29142F8DB10BD8C0600207B
+:1015B000BC0600207047000000B52DED108B89B0EF
+:1015C000B0EE408AF0EE609AF0EE418AB0EE0C0A7E
+:1015D000B0EE409AFC48007818B1FB48007801282A
+:1015E00014D1B0EE681AF0EE690AB0EE480A03F0C2
+:1015F000FBF8F64890ED000AB0EE408A90ED010A43
+:10160000F0EE409A90ED020AF0EE408AEE48007843
+:10161000002879D139EE880AED48D0ED000AED486E
+:1016200090ED001A70EE810A08EEE00AEA4880EDBB
+:10163000020AB1EE690A30EE080AE548D0ED000A68
+:10164000E44890ED001A70EE810A08EEE00AE348E3
+:1016500080ED020A39EE880ADD48D0ED000ADD4847
+:1016600090ED001A70EE810A08EEA00ADC4880EDC9
+:10167000020AB1EE690A30EE080AD548D0ED000A38
+:10168000D44890ED001A70EE810A08EEA00AD54801
+:1016900080ED020AD048D0ED020AB0EE600AB0EE4A
+:1016A000491AF1EE490A08F0CAFDCB4880ED020A5A
+:1016B000CA48D0ED020AB0EE600AB0EE491AF1EE67
+:1016C000490A08F0BCFDC54880ED020AC448D0EDC7
+:1016D000020AB0EE600AB0EE491AF1EE490A08F0CB
+:1016E000AEFDBF4880ED020ABE48D0ED020AB0EE62
+:1016F000600AB0EE491AF1EE490A08F0A0FDB948B7
+:1017000080ED020A38E3FFE7AF48007801287AD17C
+:10171000B548D0ED000AB0EE690A00EEA80AAE485E
+:1017200080ED020AB04890ED000A20EE280A10EE83
+:10173000101A08460BF06AF841EC1B0BB6EE000AD3
+:1017400029EE800A10EE101A08460BF05FF8CDE97A
+:10175000040118EE100A0BF059F841EC1C0B9FED38
+:10176000A30B05F01DFEB0EE40FAF0EE60FA9FED1F
+:10177000A10B53EC102B51EC1F0B0AF063FB41EC57
+:101780001D0B0AF065FA41EC1E0B53EC1C2B0AF002
+:1017900047FDCDE902019DED040B53EC102B9DEDAF
+:1017A000020B51EC100B0AF047FF53EC1B2BCDE959
+:1017B00006019DED060B51EC100B0AF087FA41EC87
+:1017C0001A0B0AF051FA85498860874890ED000AA3
+:1017D00020EE280A10EE101A08460BF017F841EC1C
+:1017E0001B0BB6EE000A29EE800A10EE101A08460E
+:1017F0000BF00CF841EC1C0B18EE100A0BF006F87D
+:1018000041EC1D0B00E05BE09FED780B05F0C8FD9F
+:101810008DED040B9FED770B53EC102B9DED040B1E
+:1018200051EC100B0AF00EFB53EC1D2BCDE9060119
+:101830009DED060B51EC100B0AF0F2FC41EC1F0B76
+:1018400053EC1C2B0AF0F8FE41EC1E0B53EC1B2B47
+:101850000AF03CFA41EC1A0B0AF006FA604988607B
+:101860005D48D0ED020AB0EE600AB0EE491AF1EE22
+:10187000490A08F0E4FC584880ED020A5748D0EDC8
+:10188000020AB0EE600AB0EE491AF1EE490A08F019
+:10189000D6FC524880ED020A5148D0ED020AB0EE63
+:1018A000600AB0EE491AF1EE490A08F0C8FC4C484B
+:1018B00080ED020A9FED510A4A4880ED020A5BE280
+:1018C0004148007802287DD19FED4D0AF0EE40DAC4
+:1018D000B0EE68AA3F4890ED000AF6EE000A20EE4E
+:1018E000200A10EE101A08460AF090FF41EC1B0B7C
+:1018F0001AEE100A0AF08AFFCDE904019DED040BEF
+:1019000005F08EFDB0EE40EAF0EE60EA3048006887
+:101910000AF07CFF41EC1F0B53EC1E2B0AF092FAED
+:1019200041EC1C0B53EC1B2B0AF086FECDE90601A3
+:101930009DED060B51EC100B0AF096F90AEE900A99
+:101940009FED301ADFED300AB0EE4A0A08F077FC5E
+:10195000B0EE40AAB5EEC0AAF1EE10FA20D01D48B4
+:10196000D0ED000AB6EE001AB0EE6A0A01EE600A87
+:1019700020EE080AC0EE2A0A1748C0ED020A1548F0
+:10198000D0ED000AB6EE001AB0EE6A0A01EE200AA7
+:1019900020EE080AC0EE2A0A1048C0ED020A05E04F
+:1019A0000D4880ED028A0D4880ED028A9FED170AEE
+:1019B0002AEE000A10EE101A08460AF027FF41EC42
+:1019C0001E0B25E0C0E0000064010020685A0020E2
+:1019D000900100208C010020745A0020885A0020B9
+:1019E0009C5A0020B05A0020940100200000000002
+:1019F000000008400000000000000040000000005F
+:101A0000D7231F449A99193F9A9919BFE5D0E23F0D
+:101A10001AEE100A0AF0FAFE41EC1C0B1FED0B1B2C
+:101A2000B0EE4C0AF0EE6C0A04F092FEB0EE40BA52
+:101A3000F0EE60BA9FEDD20B53EC102B51EC1B0B68
+:101A40000AF0EEFBCDE902011AEE100A0AF0DEFE02
+:101A500041EC1B0B1FED1B1BB0EE4B0AF0EE6B0AAB
+:101A600004F076FEB0EE40CAF0EE60CA9FEDC60B01
+:101A700053EC102B51EC1C0B0AF0D2FBCDE900010A
+:101A80009DED020B53EC102B9DED000B51EC100B58
+:101A90000AF01CF941EC1F0B53EC1E2B0AF0CCFD95
+:101AA0009FEDBB0B53EC102BCDE904019DED040B16
+:101AB00051EC100B0AF00AF9CDE906019DED060B79
+:101AC00051EC100B0AF0D0F80DEE100A9FEDB20A9F
+:101AD0007DEE400A9FEDB10A00EEAD0ABDEEC00AF0
+:101AE000AF4880ED000AAF48D0ED020AB0EE600AC0
+:101AF000B0EE491AF1EE490A08F0A1FBA94880EDC1
+:101B0000020AA948D0ED020AB0EE600AB0EE491A06
+:101B1000F1EE490A08F093FBA34880ED020A1FED9D
+:101B2000490AA24880ED020A1FED4C0AA04880ED48
+:101B3000020A40F698024FF448719948006808F08C
+:101B400093FB9749086017E19A480078032842D12F
+:101B5000994890ED000A68EE800AB0EE001A80EE17
+:101B6000810A38EE400A8F4880ED020A924890EDD3
+:101B7000000A68EE800AB0EE001A80EE810A30EEAC
+:101B8000080A894880ED020A8648D0ED020AB0EEC4
+:101B9000600AB0EE491AF1EE490A08F050FB81489C
+:101BA00080ED020A8048D0ED020AB0EE600AB0EE85
+:101BB000491AF1EE490A08F042FB7B4880ED020A1F
+:101BC0001FED720A794880ED020A1FED740A784809
+:101BD00080ED020AD0E07748007804287DD176486D
+:101BE00090ED000A7548D0ED000A30EE200A60EE54
+:101BF000280AB0EE001A80EE810A38EE400A6948E1
+:101C000080ED020A6C4890ED000A6C48D0ED000AA5
+:101C100030EE200A60EE280AB0EE001A80EE810A4B
+:101C200038EE400A604880ED020A634890ED000AF1
+:101C30006248D0ED000A30EE200A60EE280AB0EECD
+:101C4000001A80EE810A30EE080A584880ED020A38
+:101C5000594890ED000A5948D0ED000A30EE200AAC
+:101C600060EE280AB0EE001A80EE810A30EE080A13
+:101C70004F4880ED020A4B48D0ED020AB0EE600AF0
+:101C8000B0EE491AF1EE490A08F0D9FA454880ED5C
+:101C9000020A4548D0ED020AB0EE600AB0EE491AD9
+:101CA000F1EE490A08F0CBFA3F4880ED020A3F48BE
+:101CB000D0ED020AB0EE600AB0EE491AF1EE490A20
+:101CC00008F0BDFA394880ED020A3948D0ED020A21
+:101CD000B0EE600AB0EE491A00E007E0F1EE490A02
+:101CE00008F0ADFA324880ED020A45E0314800784C
+:101CF000052841D1304890ED000A68EE800AB0EE28
+:101D0000001A80EE810A38EE400A264880ED020A69
+:101D1000294890ED000A68EE800AB0EE001A80EEC5
+:101D2000810A30EE080A204880ED020A1D48D0EDF5
+:101D3000020AB0EE600AB0EE491AF1EE490A08F064
+:101D40007EFA184880ED020A1748D0ED020AB0EE7C
+:101D5000600AB0EE491AF1EE490A08F070FA12482A
+:101D600080ED020A1FEDDB0A104880ED020A1FED2C
+:101D7000DD0A0F4880ED020A09B0BDEC108B00BDF2
+:101D800000000000D34DF43F000000809318E4BF32
+:101D900000000000022BF93F4C37C93F0000C84447
+:101DA00068010020745A0020885A00209C5A0020A4
+:101DB000B05A0020640100208C0100209001002016
+:101DC0001CB50121082002F0DFF808200090002057
+:101DD0008DF8040003208DF8050001208DF8070020
+:101DE0006946024800F092F91CBD0000000C024058
+:101DF00000B589B00121084602F0D6F80121032080
+:101E000002F0C2F84FF40040019003208DF8090061
+:101E100002208DF8080001208DF80A008DF80B00D3
+:101E200001A92B4800F072F90820019003208DF8D9
+:101E3000090002208DF8080001208DF80A008DF8B5
+:101E40000B0001A9234800F061F901220F2120486D
+:101E500000F0A4F9012203211E4800F09FF906A812
+:101E600003F0C4FD0020ADF818004FF6FF70079096
+:101E70000020ADF82000ADF81A0006A94FF0804010
+:101E800003F072FD00231A4603214FF0804003F057
+:101E90003EFB03A803F0B0FB0020ADF8140003A93B
+:101EA0004FF0804003F071FB0121880703F00EFB27
+:101EB00001221146900703F0A8FB00214FF080405B
+:101EC00003F024FD0121880703F006FB09B000BDE3
+:101ED000000002400004024000B589B00121022048
+:101EE00002F062F80121022002F04EF83020019049
+:101EF00003208DF8090002208DF8080001208DF8DC
+:101F00000A008DF80B0001A9204800F0FFF802221A
+:101F100004211E4800F042F9022205211B4800F06E
+:101F20003DF906A803F062FD0020ADF818004FF659
+:101F3000FF7007900020ADF82000ADF81A0006A948
+:101F4000134803F011FD00231A460321104803F043
+:101F5000DEFA03A803F050FB0020ADF8140003A93B
+:101F60000B4803F012FB0121094803F0AFFA0122EC
+:101F70001146074803F049FB0021054803F0C6FC61
+:101F80000121034803F0A8FA09B000BD0004024093
+:101F90000004004000B589B00121042002F004F8DB
+:101FA0000121022001F0F0FFC020019003208DF8F4
+:101FB000090002208DF8080001208DF80A008DF834
+:101FC0000B0001A9204800F0A1F8022206211E48BA
+:101FD00000F0E4F8022207211B4800F0DFF806A811
+:101FE00003F004FD0020ADF818004FF6FF700790D5
+:101FF0000020ADF82000ADF81A0006A9134803F040
+:10200000B3FC00231A460321104803F080FA03A80A
+:1020100003F0F2FA0020ADF8140003A90B4803F016
+:10202000B4FA0121094803F051FA01221146074888
+:1020300003F0EBFA0021054803F068FC0121034896
+:1020400003F04AFA09B000BD000402400008004055
+:1020500000B589B00121082001F0A6FF0121084642
+:1020600001F092FF02220021264800F097F8022298
+:102070000121244800F092F80320019002208DF8FD
+:1020800009008DF8080001208DF80A008DF80B007A
+:1020900001A91C4800F03AF806A803F0A7FC0020AC
+:1020A000ADF818004FF6FF7007900020ADF8200043
+:1020B000ADF81A0006A9144803F056FC00231A468E
+:1020C0000321114803F023FA03A803F095FA002036
+:1020D000ADF8140003A90C4803F057FA01210A488F
+:1020E00003F0F4F901221146074803F08EFA0021AB
+:1020F000054803F00BFC0121034803F0EDF909B09A
+:1021000000BD000000000240000C0040F0B50A468F
+:1021100000210023002400BF3DE0012505FA01F362
+:10212000156805EA03049C4234D105684F00032674
+:10213000BE40B543056015794E00B540066835438D
+:1021400005601579012D02D01579022D16D185680B
+:102150004F000326BE40B543856055794E00B5401B
+:10216000866835438560456801268E40B5434560E5
+:10217000456896798E40B6B235434560C5684F00D4
+:102180000326BE40B543C560D5794E00B540C6684C
+:102190003543C560491C1029BFD3F0BDF0B50023FD
+:1021A00000244D07ED0E02FA05F3CE1000F12005D4
+:1021B00055F826504E07F70E0F26BE40B543CF10F8
+:1021C00000F1200646F82750CE1000F1200555F802
+:1021D000265045EA0304CE1000F1200545F82640BC
+:1021E000F0BD01837047000010B5044607230122AB
+:1021F00021460848FEF76CFB0648FEF7C5FB00BF0A
+:1022000002210448FEF730FB0028F9D00148FEF710
+:1022100027FB10BD0020014010B504460723012212
+:1022200021460848FEF754FB0648FEF7ADFB00BF09
+:1022300002210448FEF718FB0028F9D00148FEF7F8
+:102240000FFB10BD0021014010B50124D9480078D2
+:1022500018B1D8480078012874D1D74800780928E7
+:1022600071D2DFE800F07F05122231435262710023
+:10227000D24890ED000AD24880ED000A9FEDD10AC5
+:10228000D14880ED000A012478E0CC4890ED000AA6
+:10229000CB4880ED000AC94890ED000AB1EE400A33
+:1022A000C94880ED000A012468E09FEDC60AC448D1
+:1022B00080ED000AC14890ED000AB1EE400AC24824
+:1022C00080ED000A012459E0BC4890ED000AB1EE0F
+:1022D000400ABB4880ED000AB84890ED000AB1EE14
+:1022E000400AB94880ED000A012447E0B34890ED68
+:1022F000000AB1EE400AB24880ED000A9FEDB10A33
+:10230000B14880ED000A012438E0AC4890ED000AA5
+:10231000B1EE400AAA4880ED000AA84890ED000AF4
+:10232000A94880ED000A012428E09FEDA60AA448F0
+:1023300080ED000AA14890ED000AA34880ED000A54
+:1023400001241BE049E00DE09C4890ED000A9C4808
+:1023500080ED000A994890ED000A9B4880ED000A44
+:1023600001240BE09FED970A954880ED000A9FED50
+:10237000950A954880ED000A002400BF00BF002C9C
+:1023800011D19248007801280ED18C4890ED000AB6
+:10239000DFED8F0A80EE201A9FED8E0A21EE000AF3
+:1023A0008D4880ED000AA6E08C48007801280ED107
+:1023B000824890ED000ADFED860A80EE201A9FED3C
+:1023C000880A21EE000A844880ED000A93E09FED20
+:1023D0007D0A814880ED000A8DE077480078092861
+:1023E0006AD2DFE800F06905111D283644525D000D
+:1023F000724890ED000A724880ED000A9FED710A64
+:10240000754880ED000A62E06C4890ED000A6C4867
+:1024100080ED000A9FED720A6F4880ED000A56E0D9
+:102420009FED680A664880ED000A9FED6D0A6A48D4
+:1024300080ED000A4BE0614890ED000AB1EE400AE1
+:102440005F4880ED000A9FED660A634880ED000A50
+:102450003DE05A4890ED000AB1EE400A584880ED40
+:10246000000A9FED580A5C4880ED000A2FE05348AF
+:1024700090ED000AB1EE400A514880ED000A9FED50
+:10248000550A554880ED000A21E09FED4E0A4C4860
+:1024900080ED000A9FED4F0A4F4880ED000A16E0DC
+:1024A000464890ED000A464880ED000A9FED490A33
+:1024B000494880ED000A0AE09FED420A404880ED5D
+:1024C000000A9FED400A444880ED000A00BF00BFAB
+:1024D0003E480078012805D19FED3E0A3E4880ED38
+:1024E000000A08E03D480078012804D19FED3C0A2D
+:1024F000394880ED000A2F48007802280DD136486F
+:1025000090ED000AF0EE000A20EE200AF2EE020A38
+:1025100080EE201A80ED001A29E026480078032872
+:1025200007D024480078052803D0224800780428E2
+:102530001DD1234890ED000AB5EEC00AF1EE10FA65
+:1025400006D2254890ED000AB1EE400A80ED000A5F
+:10255000214890ED000A1948D0ED000A20EE200A2B
+:10256000DFED1B0A80EE201A1B4880ED001A14488C
+:1025700090ED000ADFED1B0A80EE201A80ED001AB4
+:10258000114890ED000ADFED170A80EE201A80ED69
+:10259000001A114890ED000A80ED000A90ED001A33
+:1025A0000948D0ED000A064890ED000AFFF704F84C
+:1025B00010BD000064010020A00100206C0100207B
+:1025C0007001002000000000740100209E01002026
+:1025D0000000FA43DB0FC93F780100209F01002073
+:1025E000DB0FC9BF00007A4410B52DED048B02202B
+:1025F00001F094FD75490860032001F08FFD7349D7
+:102600004860042001F08AFD70498860052001F0CF
+:1026100085FD6E49C8606E48007806281AD2DFE84A
+:1026200000F0031A374C6178684890ED000AB8EE64
+:10263000C08A90ED010AF8EEC08A8068404200EE40
+:10264000100AB8EEC09A6148C068404200EE100A15
+:10265000F8EEC09A72E05D480068404200EE100A51
+:10266000B8EEC08A59484068404200EE100AF8EEC1
+:10267000C08A56488068404200EE100AB8EEC09A00
+:102680005248C068404200EE100AF8EEC09A55E089
+:102690004E4890ED000AB8EEC08A4068404200EE15
+:1026A000100AF8EEC08A494890ED020AB8EEC09AC6
+:1026B00090ED030AF8EEC09A40E0444890ED000A1D
+:1026C000B8EEC08A4068404200EE100AF8EEC08AB8
+:1026D0003E4890ED020AB8EEC09A90ED030AF8EE7B
+:1026E000C09A2BE0394890ED000AB8EEC08A90ED10
+:1026F000010AF8EEC08A8068404200EE100AB8EE87
+:10270000C09A3248C068404200EE100AF8EEC09A03
+:1027100014E02E4890ED000AB8EEC08A40684042AE
+:1027200000EE100AF8EEC08A284890ED020AB8EED2
+:10273000C09A90ED030AF8EEC09A00BF00BF9FED6B
+:10274000250A28EE000A2448D0ED000A20EE200ACF
+:102750002248D0ED000A80EE201A214880ED001AB0
+:102760009FED1C0A28EE800A1B48D0ED000A20EEDF
+:10277000200A1A48D0ED000A80EE201A194880ED90
+:10278000001A9FED140A29EE000A1348D0ED000A42
+:1027900020EE200A1148D0ED000A80EE201A1248DF
+:1027A00080ED001A9FED0B0A29EE800A0A48D0ED51
+:1027B000000A20EE200A0948D0ED000A80EE201A17
+:1027C0000A4880ED001ABDEC048B10BDC45A0020ED
+:1027D000640100200000C84288010020840100201C
+:1027E000745A0020885A00209C5A0020B05A0020B9
+:1027F0002DE9F04107460C460025002608E0384642
+:10280000FFF7F2FC0544052005F02EFE701CC6B251
+:10281000A642F4DBB5FBF4F080B2BDE8F081000025
+:1028200010B52DED0E8B0820FFF7F6FC044609F0DD
+:10283000A7FC41EC1E0B9FED180B53EC102B09F07D
+:10284000EFFC41EC1D0B9FED160B53EC102B09F028
+:10285000E7FC41EC1C0B9FED140B53EC102B09F023
+:10286000DFFC41EC1B0B9FED120B53EC102B09F01E
+:10287000E9FA41EC1A0B9FED100B53EC102B09F009
+:10288000E1FA41EC190B09F0EFF908EE100AB0EE8D
+:10289000480ABDEC0E8B10BD6666666666660A4029
+:1028A00000000000000026400000008014AEEF3F52
+:1028B000000000000000F03F000000000000B040F9
+:1028C00000BFFEE710B500200E4908600E48006802
+:1028D00020F440000C4908600846006840F480007D
+:1028E000086000200949C1F8AC02012005F0DCFDB8
+:1028F00001200449086005F0D7FD00200349C1F814
+:10290000A80210BDA882404200040240008040425C
+:102910001CB50121022001F037FB4FF4406000900C
+:1029200001208DF8040000208DF8060003208DF8AA
+:10293000050001208DF8070069460548FFF7E6FB12
+:102940000120044908600449C1F8AC021CBD000024
+:1029500000040240A88240420080404210B500209E
+:102960000E4908600E48006820F440000C490860D9
+:102970000846006840F48000086001200949C1F859
+:10298000AC0205F091FD01200449086005F08CFDC2
+:1029900000200449C1F8A80210BD0000A8824042EE
+:1029A000000402400080404270B5054600241748EC
+:1029B000006820F440001549086008460068086077
+:1029C000002619E0002012490860012005F06CFD86
+:1029D00001201049C1F8A8026006040E0C487C389A
+:1029E000006810B144F0010401E024F0010401206A
+:1029F00005F05AFD701CC6B2082EE3DB15B9FFF7CF
+:102A000061FF01E0FFF7AAFF204670BD000402400D
+:102A1000A88240420080404270B504460D46002620
+:102A200000F01AF8204600F0CBF800F06BF82846CA
+:102A300000F0C6F800F066F800F00EF844F001006F
+:102A400000F0BEF800F05EF80120FFF7ADFF06468B
+:102A500000F034F8304670BD10B51548006820F419
+:102A60004000134908600846006840F48000086090
+:102A70000120104908601048D0F82C0200B910BDA0
+:102A800001200C49091F086005F00EFD00200A49CD
+:102A9000C1F8AC0207488038006800B1EFE70120B8
+:102AA00005F002FD00200349091F086000BFE6E7AA
+:102AB00000040240AC8240420080404210B50E4803
+:102AC000006820F440000C4908600846006840F4A3
+:102AD000800008600020094908600949C1F8AC027B
+:102AE000012005F0E1FC0120044908600449C1F817
+:102AF000AC0205F0D9FC10BD00040240A88240429F
+:102B00000080404210B500241448006820F44000C2
+:102B100012490860084600680860012010490860F2
+:102B200005F0C2FC01200F49C1F8A80205F0BCFC69
+:102B30000AE0601CC4B2322C03DDFFF7BFFF0020A7
+:102B400010BD012005F0B0FC054880380068002861
+:102B5000EFD10349091F08600120F1E7000402409A
+:102B6000AC824042008040422DE9F04780468946D1
+:102B700014461D46089E49464046FFF74DFF07464E
+:102B8000601CFF2101FA00F0C4F108012944491E2C
+:102B9000FF220A41104300F0FF0AC5F1080006FABF
+:102BA00000F0C6B2C4F10700064107EA0A0737433E
+:102BB0003A464946404600F035F80120BDE8F08726
+:102BC00070B504461448006820F4400012490860BB
+:102BD0000846006840F48000086000200F49086043
+:102BE000002516E0E0090D49091D08606006040E85
+:102BF000012005F059FC01200949C1F8A80205F09F
+:102C000053FC002005490860012005F04DFC681CBC
+:102C1000C5B2082DE6DB70BD00040240A882404228
+:102C20000080404270B504460D461646FFF714FF7B
+:102C30002046FFF7C5FFFFF765FF2846FFF7C0FFF7
+:102C4000FFF760FF3046FFF7BBFFFFF75BFFFFF7C3
+:102C500035FF012070BD000030EEC01A234880ED22
+:102C6000001A90ED001A2248D0ED001A31EE611AD8
+:102C70002048D0ED001A21EE211A1F48D0ED001A8D
+:102C80001A4890ED002A01EE821A1C48D0ED001A75
+:102C900031EE211A80ED001A90ED001ADFED181ABE
+:102CA000B4EEE11AF1EE10FA03DD9FED151A80ED96
+:102CB000001A124890ED001ADFED121AB4EEE11A74
+:102CC000F1EE10FA03D29FED0F1A80ED001A0748BB
+:102CD00090ED001A064880ED001A084890ED001AA1
+:102CE000BDEEC11A11EE100A70470000E00100208D
+:102CF000E80100207C01002080010020E401002088
+:102D000000788246007882C630EEC01A234880EDF3
+:102D1000001A90ED001A2248D0ED001A31EE611A27
+:102D20002048D0ED001A21EE211A1F48D0ED001ADC
+:102D30001A4890ED002A01EE821A1C48D0ED001AC4
+:102D400031EE211A80ED001A90ED001ADFED181A0D
+:102D5000B4EEE11AF1EE10FA03DD9FED151A80EDE5
+:102D6000001A124890ED001ADFED121AB4EEE11AC3
+:102D7000F1EE10FA03D29FED0F1A80ED001A07480A
+:102D800090ED001A064880ED001A084890ED001AF0
+:102D9000BDEEC11A11EE100A70470000EC010020D0
+:102DA000F40100207C01002080010020F0010020BF
+:102DB00000788246007882C630EEC01A234880ED43
+:102DC000001A90ED001A2248D0ED001A31EE611A77
+:102DD0002048D0ED001A21EE211A1F48D0ED001A2C
+:102DE0001A4890ED002A01EE821A1C48D0ED001A14
+:102DF00031EE211A80ED001A90ED001ADFED181A5D
+:102E0000B4EEE11AF1EE10FA03DD9FED151A80ED34
+:102E1000001A124890ED001ADFED121AB4EEE11A12
+:102E2000F1EE10FA03D29FED0F1A80ED001A074859
+:102E300090ED001A064880ED001A084890ED001A3F
+:102E4000BDEEC11A11EE100A70470000F801002013
+:102E5000000200207C01002080010020FC010020F5
+:102E600000788246007882C630EEC01A234880ED92
+:102E7000001A90ED001A2248D0ED001A31EE611AC6
+:102E80002048D0ED001A21EE211A1F48D0ED001A7B
+:102E90001A4890ED002A01EE821A1C48D0ED001A63
+:102EA00031EE211A80ED001A90ED001ADFED181AAC
+:102EB000B4EEE11AF1EE10FA03DD9FED151A80ED84
+:102EC000001A124890ED001ADFED121AB4EEE11A62
+:102ED000F1EE10FA03D29FED0F1A80ED001A0748A9
+:102EE00090ED001A064880ED001A084890ED001A8F
+:102EF000BDEEC11A11EE100A704700000402002056
+:102F00000C0200207C01002080010020080200202B
+:102F100000788246007882C61CB50121102001F09D
+:102F200033F80120009000208DF8040003208DF874
+:102F3000050001208DF8070069460248FFF7E6F812
+:102F40001CBD00000010024010B5322004F046FF06
+:102F50000446022C0BD1064806490A68026089889B
+:102F60008180054805490A6802608988818010BD12
+:102F700050020020560200205C0200206202002065
+:102F80001CB50121084600F0FFFF4FF4805000906F
+:102F900001208DF8040000208DF8060003208DF834
+:102FA000050001208DF8070069460448FFF7AEF8D8
+:102FB0004FF480510148FFF714F91CBD0000024096
+:102FC00000B52649D1ED010AB0EE600A00EE900A84
+:102FD000B8EEE01A414200EE901AF8EEE00A07F06F
+:102FE0002EF91E4981ED010A1D49D1ED010AB0EE0D
+:102FF000600A00EE900AB8EEE01A414200EE901A24
+:10300000F8EEE00A07F01BF9154981ED010A1549B0
+:10301000D1ED010AB0EE600A00EE900AB8EEE01AB7
+:10302000414200EE901AF8EEE00A07F008F90D4967
+:1030300081ED010A0C49D1ED010AB0EE600A00EE03
+:10304000900AB8EEE01A414200EE901AF8EEE00A5B
+:1030500007F0F5F8044981ED010A00BD745A00201B
+:10306000885A00209C5A0020B05A002070B50446AF
+:103070000025BC2C01DB012510E0622C01DB0225C0
+:103080000CE02A2C01DB032508E0142C01DB0425CD
+:1030900004E00A2C01DB052500E006252A461A215A
+:1030A000D020FFF7BFFD70BD70B50446B4F57A7F40
+:1030B00001DD4FF47A74042C00DA04244FF47A70A2
+:1030C00090FBF4F0401EC5B22A461921D020FFF72C
+:1030D000A9FD0546264604EBD671C1F34F00FFF764
+:1030E000C5FF70BD10B580226B21D020FFF79AFD7F
+:1030F000C82005F0B9F900226B21D020FFF792FD1E
+:10310000012000F03DF8002000F030F83220FFF7F9
+:10311000CBFF00223821D020FFF784FD00226A2156
+:10312000D020FFF77FFD00222321D020FFF77AFD7A
+:1031300080223721D020FFF775FD7521D020FFF7C1
+:103140006BFC0446682C0DD101226B21D020FFF7C7
+:1031500069FD00226C21D020FFF764FD3220FFF7CB
+:10316000A3FF01E0012010BD0020FCE738B50446B4
+:10317000022304221C21D0200094FFF7F5FC38BD67
+:1031800038B50446022304221B21D0200094FFF707
+:10319000EBFC38BD08B505F0D3F9009058E00A21E2
+:1031A000684607F003FC2B480068B0F57A7F4BDADD
+:1031B00028480068401C274908602748008827499C
+:1031C0000988084400B224490880084640882349F9
+:1031D0004988084400B220494880084680881F4931
+:1031E0008988084400B21C4988801D4800881D4910
+:1031F0000988084400B21A490880084640881949DD
+:103200004988084400B21649488008468088154914
+:103210008988084400B21249888000200CE00E49D9
+:1032200031F910100B4A128812B291FBF2F109B277
+:103230000D4A22F81010401C0328F0DB0B48094906
+:103240000A6802608988818000F070F800F010F848
+:10325000A5E70000400200204402002030020020C8
+:103260004A02002036020020500200205C020020AA
+:1032700010B53C21D020FFF7CFFB04463B21D020E6
+:10328000FFF7CAFB04EB002000B2244908803E216E
+:10329000D020FFF7C1FB04463D21D020FFF7BCFB47
+:1032A00004EB002000B21D4948804021D020FFF7E8
+:1032B000B3FB04463F21D020FFF7AEFB04EB002018
+:1032C00000B21649888016480068B0F57A7F23DB83
+:1032D00008460088134908801048408848800F48F5
+:1032E00080888880084600880F490988401A00B203
+:1032F0000A4908800B4840880B494988401A00B2A7
+:10330000064948800748808807498988401A00F59F
+:10331000804000B20149888010BD000036020020C4
+:1033200040020020620200205C02002010B544210F
+:10333000D020FFF771FB04464321D020FFF76CFB40
+:1033400004EB002000B22C4908804621D020FFF772
+:1033500063FB04464521D020FFF75EFB04EB002011
+:1033600000B2254948804821D020FFF755FB04468C
+:103370004721D020FFF750FB04EB002000B21E498C
+:1033800088801E480068B0F57A7F05DA01201C4964
+:1033900008601C4908702DE018480068B0F57A7F75
+:1033A00002D10020174908704FF496701449086044
+:1033B00011480088144908800F48408848800E480A
+:1033C000808888800846008810490988401A00B221
+:1033D000094908800C4840880C494988401A00B2C5
+:1033E000054948800848808808498988401A00B201
+:1033F0000149888010BD00003002002040020020FA
+:10340000380000205C0100205602002050020020FD
+:1034100000BFFEE77047000070B5002100230F22B7
+:10342000C4781CB3174C246804F4E064C4F5E06469
+:10343000C4F30721C1F10404E3B20A4144789C407B
+:10344000E1B28478144021430C07210E0E4C05781C
+:103450006155047804F01F050124AC4005786D1116
+:10346000AD0005F1E025C5F8004109E0047804F05D
+:103470001F050124AC40054D0678761145F826401D
+:1034800070BD00000CED00E000E400E080E100E031
+:1034900002490143024A1160704700000000FA052A
+:1034A0000CED00E030B500240CE0002506E0002023
+:1034B000074901EBC5010855681CC5B2802DF6DB34
+:1034C000601CC4B2082CF0DB00F0D2F830BD000064
+:1034D00080020020F0B5144600267F2801DC3F2939
+:1034E00000DDF0BD0B46CF1701EB5777FF10C7F19A
+:1034F0000707FAB2CF1701EB5777FF10A1EBC70709
+:10350000FDB2C5F107070123BB40DEB24CB10A4B47
+:1035100003EBC0039B5C3343074F07EBC007BB546F
+:1035200008E0054B03EBC0039B5CB343024F07EB82
+:10353000C007BB5400BFD4E7800200201CB50121A6
+:10354000082000F021FD4FF4F040009001208DF89C
+:10355000040000208DF806008DF805008DF80700A6
+:1035600069464048FEF7D2FD0121080700F01CFD26
+:10357000012000F003FD002000F0BAFD002000F063
+:10358000FDFC002038490860642004F06DFF012034
+:103590003649C1F8B0020021AE2000F04FF90021F9
+:1035A000D52000F04BF90021502000F047F9002110
+:1035B000A82000F043F900213F2000F03FF900214E
+:1035C000D32000F03BF90021084600F037F9002134
+:1035D000402000F033F900218D2000F02FF9002168
+:1035E000142000F02BF90021202000F027F9002101
+:1035F000022000F023F90021A12000F01FF9002192
+:10360000C02000F01BF90021DA2000F017F900219A
+:10361000122000F013F90021812000F00FF90021A1
+:10362000EF2000F00BF90021D92000F007F900216C
+:10363000F12000F003F90021DB2000F0FFF8002169
+:10364000302000F0FBF80021A42000F0F7F8002162
+:10365000A62000F0F3F80021AF2000F0EFF8FFF70C
+:1036600021FF1CBD000C0240B0824142008041425B
+:1036700030B500241CE004F1B001C8B2002100F014
+:10368000DDF80021084600F0D9F80021102000F0F4
+:10369000D5F8002508E0084901EBC501085D0121C6
+:1036A00000F0CCF8681CC5B2802DF4DB601CC4B2FD
+:1036B000082CE0DB30BD0000800200202DE9F04F37
+:1036C00080460C4615461E46A346A5F12000C5B20D
+:1036D00000273EE00C2E07D105EB45001F4901EB0A
+:1036E000800010F8079004E01D4800EB051010F86A
+:1036F00007904FF0000A26E009F0800028B121462B
+:103700004046099AFFF7E6FE09E0099808B901204A
+:1037100000E00020024621464046FFF7DBFE4FEA6C
+:1037200049604FEA1069601CC4B2A4EB0B00B042C0
+:1037300005D15C4608F1010000F0FF0806E00AF13F
+:10374000010000F0FF0ABAF1080FD5DB00BF781CBA
+:10375000C7B2B742BEDBBDE8F08F0000F2C9000877
+:1037600066CE00082DE9FF4F81B0074691461E4600
+:103770000E9D4FF0000A002439E0301B401EC1B2FC
+:103780000A2004F019FFB9FBF0F00A21B0FBF1F2B6
+:1037900001FB1208BAF1000F16D1701EA04213DD12
+:1037A000B8F1000F0ED10120AB4605EBDB714910DB
+:1037B00001FB04710090C8B22B4620220299FFF74A
+:1037C0007DFF12E04FF0010A0120AB4605EBDB71F3
+:1037D000491001FB04710090C8B208F13001CAB26F
+:1037E0002B460299FFF76AFF00BF601CC4B2B442C7
+:1037F000C3DB05B0BDE8F08F78B505460E4614462C
+:1038000018E07A2D03DD002506F11000C6B23A2E2D
+:1038100004DD002005460646FFF744FE0120009027
+:1038200022780C2331462846FFF748FF05F10800AF
+:10383000C5B2641C20780028E3D178BD10B50A46D3
+:103840001AB10123124C236002E00023104C2360C4
+:10385000002116E000230E4C0C34236000F080039E
+:103860001BB10123241F236003E00023084C08340C
+:1038700023600123064C0C3423604306180E4B1CB6
+:10388000D9B20829E6DB0123014C236010BD0000FA
+:10389000AC82414201460148405C704780060020EE
+:1038A000002004E00021034A1154411CC8B2092839
+:1038B000F8DB70478006002038B5044601200090F0
+:1038C00000201E494870012000902EE0BDF8000045
+:1038D000204018B101201A49086002E00020184970
+:1038E00008600120164910390860052004F0DCFD4D
+:1038F00000201449C1F8A002052004F0D5FD0120E4
+:103900001049C1F8A0020846D0F83C0230B10B487B
+:103910004078BDF80010084308494870BDF8000021
+:103920004FF6FF7101EA40000090BDF80000FF284B
+:10393000CCDD102004F0B8FD38BD0000800600206A
+:10394000B00242420000424210B5FFF7A9FF00F06A
+:103950002FF90F48C0780E49097940EA01200D4936
+:10396000088000240FE00C4810F81400401E0121CC
+:1039700001FA00F007490988084010B9601CC0B27C
+:1039800010BD601CC4B2102CEDDB0020F8E7000075
+:1039900080060020400000204400002010B50020D8
+:1039A00013490860102004F07FFD0120FFF784FF19
+:1039B0004320FFF781FF0020FFF77EFF0120FFF784
+:1039C0007BFF0020FFF778FF0020FFF775FF002046
+:1039D000FFF772FF0020FFF76FFF0020FFF76CFF7B
+:1039E00001200449C1F8A802102004F05DFD10BDBB
+:1039F000A80242420000424210B50020134908606C
+:103A0000102004F051FD0120FFF756FF4320FFF77F
+:103A100053FF0020FFF750FF0020FFF74DFF5A2013
+:103A2000FFF74AFF5A20FFF747FF5A20FFF744FFEE
+:103A30005A20FFF741FF5A20FFF73EFF01200449BB
+:103A4000C1F8A802102004F02FFD10BDA8024242C8
+:103A5000000042421CB50121102000F095FA4FF4FD
+:103A60000040009000208DF8040003208DF8050030
+:103A700002208DF8070069460B48FEF747FB4FF41C
+:103A8000A850009001208DF8040000208DF8060059
+:103A900002208DF8050001208DF8070069460248D4
+:103AA000FEF734FB1CBD00000010024010B5FFF70C
+:103AB0004BFF00EE100AB8EE400A2F4880ED000AD6
+:103AC0000720FFF7E7FE00EE100AB8EE400A2B4889
+:103AD00080ED000A0820FFF7DDFE00EE100AB8EEC8
+:103AE000400A274880ED000A0520FFF7D3FE00EECC
+:103AF000100AB8EE400A234880ED000A0620FFF7BE
+:103B0000C9FE00EE100AB8EE400A1F4880ED000A18
+:103B1000194890ED000AF1EE000AB4EE600AF1EEE9
+:103B200010FA05D11948007810B901201849086029
+:103B300017480068F8B1124890ED000ADFED150A49
+:103B4000B4EEE00AF1EE10FA15D21048007890B900
+:103B500011480068B0F57A7F0DDB01200B49087031
+:103B600000200E4908700E4908700E4908700E4971
+:103B700008700E49087010BDB4010020A401002097
+:103B8000A8010020AC010020B00100209801002015
+:103B9000640000200000EC42400200209A01002056
+:103BA000990100209B0100209C0100209D01002024
+:103BB0001CB50020019001200090002025490860DC
+:103BC00025490878FFF778FE23494878FFF774FE07
+:103BD0000220019036E00120009027E001201D49DD
+:103BE00008390860052004F05FFC00201B49C1F87B
+:103BF000A002052004F058FC01201849C1F8A002D9
+:103C00000846D0F83C0250B115489DF80410405CBD
+:103C1000BDF80010084312499DF804208854BDF8EF
+:103C200000004FF6FF7101EA40000090BDF800006F
+:103C3000FF28D3DD102004F037FC9DF80400401C61
+:103C4000C0B201909DF804000928C4DB012001499D
+:103C500008601CBDA802424242000020000042420F
+:103C60008006002010B500F00BF800F009F800F015
+:103C700007F8FFF793FE00F025F8FFF7BDFE10BD33
+:103C800010B500200D490860102004F00DFC012043
+:103C9000FFF712FE4220FFF70FFE0020FFF70CFE99
+:103CA0000020FFF709FE0020FFF706FE012004496F
+:103CB000C1F8A802102004F0F7FB10BDA802424290
+:103CC0000000424210B50020124908600120FFF7B1
+:103CD000F3FD4420FFF7F0FD0020FFF7EDFD01208C
+:103CE000FFF7EAFD0320FFF7E7FD0020FFF7E4FD03
+:103CF0000020FFF7E1FD0020FFF7DEFD0020FFF7C9
+:103D0000DBFD01200449C1F8A802102004F0CCFB1F
+:103D100010BD0000A8024242000042422DE9F041DD
+:103D20001424884890ED000ADFED870A30EE600A1F
+:103D3000B1EE400ABDEEC00A10EE106A834890ED65
+:103D4000000ADFED810A30EE600AB1EE400ABDEEF6
+:103D5000C00A10EE105A7E4890ED000ADFED7A0A94
+:103D600030EE600AB1EE400ABDEEC00A10EE107AE5
+:103D70006042854202DDA54200DA002560428642AB
+:103D800002DDA64200DA00266042874202DDA74239
+:103D900000DA00276F4890ED000AF2EE060AB4EE52
+:103DA000600AF1EE10FA09D16B4890ED000AF1EECD
+:103DB000040A30EE200A80ED000A12E0654890ED1A
+:103DC000000AF2EE020AB4EE600AF1EE10FA08D12F
+:103DD000614890ED000AF1EE040A30EE600A80EDD1
+:103DE000000A5D4890ED000AB5EEC00AF1EE10FA47
+:103DF00003D29FED5A0A80ED000A00EE105AB8EE89
+:103E0000C00A5548D0ED000A20EE200ADFED4E0A28
+:103E100080EE201A524880ED001A00EE106AB8EECB
+:103E2000C00A4D48D0ED000A20EE200ADFED460A18
+:103E300080EE201A4B4880ED001A00EE107AB8EEA2
+:103E4000C00ADFED490A20EE200ADFED3F0A80EECE
+:103E5000201A464880ED001A4548007818B14448B9
+:103E6000007801280FD1414890ED000A3A48D0ED82
+:103E7000000A20EE200ADFED3F0A80EE201A3B48C0
+:103E800080ED001A3BE03A48007802280DD137480F
+:103E900090ED000AF0EE000A20EE200AF2EE020A8F
+:103EA00080EE201A80ED001A29E0314800780328BE
+:103EB00007D02F480078052803D02D480078042823
+:103EC0001DD1274890ED000AB5EEC00AF1EE10FAB8
+:103ED00006D2264890ED000AB1EE400A80ED000AB5
+:103EE000224890ED000A1C48D0ED000A20EE200A7E
+:103EF000DFED200A80EE201A1C4880ED001A1848D9
+:103F000090ED000ADFED1C0A80EE201A80ED001A09
+:103F1000144890ED000ADFED180A80EE201A80EDBB
+:103F2000001A124890ED000A80ED000A90ED001A88
+:103F30000C48D0ED000A0A4890ED000AFDF73CFB62
+:103F4000BDE8F081A401002000000043A80100208A
+:103F5000AC010020B40100206C0100200000000032
+:103F60007001002074010020DB0FC93F78010020A0
+:103F7000640100200000FA4300007A44014908620D
+:103F80007047000000000E4229B1064A1268024341
+:103F9000044B1A6004E0034A12688243014B1A6022
+:103FA000704700003038024029B1064A12680243C7
+:103FB000044B1A6004E0034A12688243014B1A6002
+:103FC000704700004038024029B1064A1268024397
+:103FD000044B1A6004E0034A12688243014B1A60E2
+:103FE000704700004438024029B1064A1268024373
+:103FF000044B1A6004E0034A12688243014B1A60C2
+:104000007047000024380240F0B50021002200244F
+:10401000022500260223324F3F6807F00C0121B130
+:10402000042905D0082937D105E02E4F076036E076
+:104030002D4F076033E02A4F3F1F3F68C7F380567C
+:10404000274F3F1F3F6807F03F036EB1264FB7FB76
+:10405000F3F7DFF88CC0ACF1040CDCF800C0CCF353
+:10406000881C07FB0CF40CE01E4FB7FBF3F7DFF8DE
+:1040700070C0ACF1040CDCF800C0CCF3881C07FB6A
+:104080000CF4174F3F1F3F68C7F301477F1C7D00AB
+:10409000B4FBF5F7076002E0124F076000BF00BFF6
+:1040A0000F4F3F6807F0F0010909104F7A5C07686D
+:1040B000D74047600A4F3F6807F4E051890A0B4F29
+:1040C0007A5C4768D7408760054F3F6807F46041D6
+:1040D000490B064F7A5C4768D740C760F0BD0000C7
+:1040E000083802400024F40000127A00D6000020B4
+:1040F0000021094A11701170012802D0042808D14A
+:1041000003E00121044A117004E00521024A117004
+:1041100000E000BF00BF704770380240014602292E
+:1041200006D003290DD0042912D005291ED116E08E
+:104130004FF08042526A10B200224FF080435A6220
+:1041400016E00C4A126810B200220A4B1A600FE007
+:10415000094A126810B20022074B1A6008E0074AA9
+:10416000126810B20022054B1A6001E0002000BF67
+:1041700000BF70472404004024080040240C004085
+:104180002DE9F04764254FF4FA6251108748006822
+:1041900006F06AF8854908604FF4FA6251108448C5
+:1041A000006806F061F8824908604FF4FA62511025
+:1041B0008048006806F058F87E4908604FF4FA62BB
+:1041C00051107D48006806F04FF87B490860784838
+:1041D0000068A0F2DC5708460068A0F2DC58754879
+:1041E0000068A0F2DC5671480068A0F2DC59684211
+:1041F000874202DDAF4200DA00276842804503DDD6
+:10420000A84501DA4FF000086842864202DDAE425E
+:1042100000DA00266842814503DDA94501DA4FF046
+:1042200000096648D0ED000A00EE106AB8EEC00A38
+:1042300030EE800ABDEEC00A10EE104A002C00DA03
+:10424000002407FB04F04FF4FA7190FBF1F000EE4C
+:10425000100AB8EEC00A5A4880ED000AC8F1000002
+:10426000604390FBF1F000EE100AB8EEC00A55482A
+:1042700080ED000AC9F1000000EE100AB8EEC00A95
+:10428000DFED510A20EE200ADFED500A80EE201A01
+:104290004F4880ED001A4F48007818B14D4800781B
+:1042A00001280FD14A48D0ED000A00EE104AB8EEBE
+:1042B000C00A20EE800ADFED450A80EE201A80ED6C
+:1042C000001A3BE04348007802280DD1404890EDA9
+:1042D000000AF0EE000A20EE200AF2EE020A80EE5A
+:1042E000201A80ED001A29E03A480078032807D008
+:1042F00038480078052803D03648007804281DD1B6
+:104300002F4890ED000AB5EEC00AF1EE10FA06D281
+:104310002F4890ED000AB1EE400A80ED000A2C48CB
+:10432000D0ED000A00EE104AB8EEC00A20EE800A76
+:10433000DFED260A80EE201A80ED001A204890ED6D
+:10434000000ADFED250A80EE201A80ED001A1D48D4
+:1043500090ED000ADFED200A80EE201A80ED001AB1
+:104360001B4890ED000A80ED000A1C4800780028E8
+:104370000EDD9FED1B0A124880ED000A9FED180A22
+:10438000134880ED000A15480078401E1349087054
+:104390000F4890ED001A0B48D0ED000A084890ED48
+:1043A000000AFDF709F9BDE8F08700009000002041
+:1043B00094000020980000209C0000206C01002048
+:1043C0007001002074010020DB0FC93F0000FA4398
+:1043D000780100206401002000007A4410020020CF
+:1043E0000000000010B52DED088BB0EE40BAF0EEE5
+:1043F00060BAB0EE418AF0EE618AB0EE429AF0EE19
+:10440000629AB0EE43AA51EC1B0B07F02DFC1D493C
+:104410000860084680ED018AC0ED058ABDEEC90A34
+:1044200080ED020ABDEEE90A80ED030A80ED04AAE0
+:10443000C06880008968484300EE100AB8EEC00AE0
+:10444000114880ED000A0F4890ED040ADFED0F0AD5
+:1044500020EE200A0E4880ED000A0A4890ED000A7E
+:104460000C4880ED000A074890ED010A0A4880EDEB
+:10447000000A044890ED050A084880ED000ABDECEA
+:10448000088B10BDD45A002084010020DB0F494066
+:10449000880100208C010020900100209401002060
+:1044A00010B54FF4AD70554908600A210920FEF798
+:1044B0009FF95249096890FBF1F05149087008468C
+:1044C0000078052801DD052008704D480078062891
+:1044D0005ED2DFE800F0031221303F4E9FED493AF3
+:1044E000F2EE0A2AB3EE0E2ADFED471A9FED471AC5
+:1044F0009FED470BFFF776FF4AE09FED473AF2EE5C
+:104500000A2AB3EE0E2ADFED451A9FED3F1A9FED02
+:10451000440BFFF767FF3BE09FED433AF2EE0A2AB8
+:10452000B3EE0E2ADFED381A9FED401A9FED400BD7
+:10453000FFF758FF2CE09FED3C3AF2EE0A2AB3EE6B
+:104540000E2ADFED311A9FED301A9FED3B0BFFF77E
+:1045500049FF1DE09FED343AF2EE0A2AB3EE0E2A2F
+:10456000DFED291A9FED361A9FED360BFFF73AFF64
+:104570000EE09FED363AF2EE0A2AB3EE0E2ADFED98
+:10458000221A9FED211A9FED320BFFF72BFF00BF80
+:1045900000BF1B48007806282ED2DFE800F0030A8F
+:1045A00011181F2608202C4908600E202B4908608E
+:1045B00022E00620284908600A20284908601BE0FC
+:1045C00004202549086007202449086014E00420DD
+:1045D000214908600720214908600DE008201E4994
+:1045E00008600B201D49086006E004201A49086095
+:1045F00007201A49086000BF00BF10BD60010020FD
+:10460000640100209A99993D000000007B14AE3DA2
+:10461000022B8716D9CEB73F8FC2753D643BDF3D75
+:104620000000000000000000B81E853DBC74133E71
+:10463000000000806ABCC43F000000A0EFA7C63F96
+:10464000295C8F3E00000000D7A3D03FC520303D3D
+:10465000000000E07A14CE3FC8010020CC01002009
+:104660000CB50020019000903448006840F4803080
+:104670003249086000BF3148006800F40030009003
+:104680000198401C0190009818B90198B0F5A04F0E
+:10469000F1D12A48006800F4003010B101200090E8
+:1046A00001E0002000900098012846D123484030C6
+:1046B000006840F08050214940310860204800687F
+:1046C00040F440401E4908601C48083000681B49FF
+:1046D000083108600846006840F400400860084659
+:1046E000006840F4A05008601648091F0860081FC1
+:1046F000006840F08070091F086000BF0F48006824
+:1047000000F000700028F9D040F205700E490860F2
+:104710000A480830006820F00300084908310860A2
+:104720000846006840F00200086000BF03480830F7
+:10473000006800F00C000828F8D10CBD00380240D9
+:104740000070004008544007003C024070B5049CD3
+:10475000002807DA44F29F151E4E356005441E4EB0
+:10476000356006E044F29F151B4E35602D1A194E38
+:104770003560002906DA44F29F15184E75630D4422
+:10478000B56305E044F29F15144EB5636D1A756369
+:10479000002A06DA44F29F15114EB563154475637D
+:1047A00005E044F29F150E4E7563AD1AB563002BFC
+:1047B00006DA44F29F150A4E35641D44F56305E0A0
+:1047C00044F29F15064EF563ED1A3564054D2C60D5
+:1047D00070BD0000344401403448014000400140B5
+:1047E000000001403818004000B5F0EE403AF0EE0D
+:1047F000602AB0EE413A9FED680AB0EE402AF5EE2D
+:10480000C03AF1EE10FA07DD644890ED000A30EE90
+:10481000020A80ED000A1AE0F5EEC03AF1EE10FA55
+:1048200007D25E4890ED000A30EE420A80ED000AA1
+:104830000DE0F5EEC03AF1EE10FA08D1574890EDD0
+:10484000000ADFED570A20EE200A80ED000AF5EE9F
+:10485000C02AF1EE10FA07DD504890ED010A30EE63
+:10486000020A80ED010A1AE0F5EEC02AF1EE10FA14
+:1048700007D24A4890ED010A30EE420A80ED010A63
+:104880000DE0F5EEC02AF1EE10FA08D1434890EDA4
+:10489000010ADFED430A20EE200A80ED010AB5EEA1
+:1048A000C03AF1EE10FA07DD3C4890ED020A30EE16
+:1048B000020A80ED020A1AE0B5EEC03AF1EE10FAF3
+:1048C00007D2364890ED020A30EE420A80ED020A25
+:1048D0000DE0B5EEC03AF1EE10FA08D12F4890ED98
+:1048E000020ADFED2F0A20EE200A80ED020AB0EE68
+:1048F000630A03F009FEB0EE404AB0EE630A03F02B
+:1049000003FEB1EE400AF0EE404A2448D0ED000A22
+:10491000B0EE600AB0EE441AF0EE640A05F08FFCC7
+:104920001E4880ED000AB0EE620A03F0EDFDB0EE25
+:10493000404AB0EE620A03F0E7FDB1EE400AF0EE45
+:10494000404A1648D0ED010AB0EE600AB0EE441AB3
+:10495000F0EE640A05F073FC104880ED010AB0EE39
+:10496000430A03F0D1FDB0EE404AB0EE430A03F033
+:10497000CBFDB1EE400AF0EE404A0848D0ED020A05
+:10498000B0EE600AB0EE441AF0EE640A05F057FC8F
+:10499000024880ED020A00BD0AD7233C685A002075
+:1049A0006666663F042808D14FF0E021096941F0AE
+:1049B00004014FF0E022116107E04FF0E0210969A6
+:1049C00021F004014FF0E0221161704710B506F0AC
+:1049D00097FE012801D006F019FB10BD10B515484F
+:1049E000006840F47000134908601348006840F004
+:1049F00001001149086000200F49083108600E4885
+:104A000000680E4908400C4908600D48091D0860FF
+:104A1000081F006820F48020091F08600020064954
+:104A20000C310860FFF71CFE4FF00060014980392F
+:104A3000086010BD88ED00E000380240FFFFF6FE80
+:104A400010300024F0B50C46154600210022068CDB
+:104A50004FF6FE773E400684018B028C4FF60C76B3
+:104A600031407E1C06EA03162E4331434FF6F5769D
+:104A7000324044F00106324301830284F0BDF0B5B8
+:104A80000C461546002100220026078C4FF6EF7CCD
+:104A900007EA0C070784018B028C4FF6FF7707EAC1
+:104AA000041640F6FF4739404FF6FF7707EA033711
+:104AB00039434FF6FF7707EA052739434FF65F770B
+:104AC0003A4046F010073A4301830284F0BDF0B546
+:104AD0000C461546002100220026078C4FF6FF6C7D
+:104AE00007EA0C070784818B028C4FF6FF7707EAF1
+:104AF00004264FF60C7739404FF6FF7707EA031785
+:104B00002F4339434FF2FF573A4046F480773A43F8
+:104B100081830284F0BDF0B50C46154600210022C9
+:104B20000026078C4EF6FF7C07EA0C070784818B72
+:104B3000028C4FF6FF7707EA043640F6FF4739400C
+:104B40004FF6FF7707EA052739434FF6FF7707EA65
+:104B50000337394345F6FF773A4046F480573A43E6
+:104B600081830284F0BD000030B58BB005460C4651
+:104B700001210220FFF708FA01214804FFF724FA77
+:104B8000032208211E48FDF709FB02208DF81C00B6
+:104B900000208DF81E004FF48070069001208DF8E3
+:104BA0001F0003208DF81D0006A91548FDF7AEFA79
+:104BB0000995ADF820400020ADF82800ADF822009E
+:104BC00008A9104800F0D0FE6020ADF804000120D4
+:104BD000ADF806000020ADF8100001A9094800F06A
+:104BE0001DFD0821074800F060FD0121054800F087
+:104BF00061FC0121034800F06FFC0BB030BD0000E8
+:104C0000000402400044014030B58BB005460C461C
+:104C100001210220FFF7B8F901218804FFF7D4F938
+:104C2000032209212048FDF7B9FA02208DF81C0063
+:104C300000208DF81E004FF40070069001208DF8C2
+:104C40001F0003208DF81D0006A91748FDF75EFA26
+:104C50000995ADF820400020ADF82800ADF82200FD
+:104C600008A9124800F080FE6020ADF80400012081
+:104C7000ADF806000020ADF8100001A90B4800F0C7
+:104C8000CDFC0821094800F010FD0121074800F083
+:104C90002FFC0121054800F00DFC0121034800F024
+:104CA0001BFC0BB030BD0000000402400048014076
+:104CB00030B58BB005460C4601214020FFF774F952
+:104CC00001210220FFF760F902208DF828004FF43F
+:104CD0004040099003208DF8290000208DF82A001B
+:104CE00001208DF82B0009A92248FDF70FFA0922AF
+:104CF0000E212048FDF752FA09220F211D48FDF729
+:104D00004DFA0795ADF818400020ADF82000ADF839
+:104D10001A0006A9184800F027FE6020ADF804002C
+:104D20000120ADF8060000200390ADF81000ADF8AA
+:104D3000140001A9104800F071FC01A90E4800F010
+:104D4000BDFC08210C4800F0B0FC08210A4800F026
+:104D500014FD0121084800F0CBFB0121064800F0BA
+:104D6000BBFB40F2DC50044938310860091F086081
+:104D70000BB030BD000402400018004030B58BB0CD
+:104D800005460C4601210846FFF71EF901211020B7
+:104D9000FFF7FAF8012209213448FDF7FFF9012253
+:104DA0000B213248FDF7FAF901220D212F48FDF7BA
+:104DB000F5F901220E212D48FDF7F0F94FF4D4400A
+:104DC000099002208DF8280003208DF8290000208A
+:104DD0008DF82A0001208DF82B0009A92348FDF742
+:104DE00095F90795ADF818400120ADF82000002096
+:104DF000ADF81A0006A91E4800F0B6FD6020ADF817
+:104E000004000120ADF806000020ADF8100001A953
+:104E1000174800F003FC01A9154800F04FFC01A958
+:104E2000134800F0B7FC01A9114800F019FD012159
+:104E30000F4800F05DFB08210D4800F036FC08210A
+:104E40000B4800F09AFC0821094800F000FD0821F9
+:104E5000074800F04EFD0121054800F02BFB012121
+:104E6000034800F039FB0BB030BD000000100240D9
+:104E7000000001404FF08040008A4FF08040008ADF
+:104E800020F001004FF080410882704704480088FC
+:104E90000348008820F001000149088070470000A5
+:104EA00010040040044800880348008820F00100F6
+:104EB000014908807047000010080040044800883D
+:104EC0000348008820F00100014908807047000075
+:104ED000100C0040044800880348008820F00100BE
+:104EE00001490880704700001018004010B5CA48FA
+:104EF0000068B0F5C86F15DDC848007890B9C8489B
+:104F00000068B0F57A7F0DDB0120C44908700020ED
+:104F1000C4490870C4490870C4490870C44908707D
+:104F2000C4490870C448007800F08000002857D1B8
+:104F30000221C24800F018FB002851D00221BF48CE
+:104F400000F0C7FABC48007800F04000C0B3BB488E
+:104F500000F0FEFABA49088008460088B949098875
+:104F6000884204DA42F20F70B749086002E000207C
+:104F7000B5490860B2480088B2490988401AB24968
+:104F800009680844B14908600968B14A1268881A7A
+:104F9000002801DB014600E04142B1F5FA7F03DD64
+:104FA000AB480068A9490860A8480068A84908609B
+:104FB0000020A14908700021A04800F06DFB0FE01F
+:104FC000FFE79E4800F0C4FA9E4908809A4800789E
+:104FD00040F04000984908700221984800F05CFBBE
+:104FE0009C48007800F08000002857D104219348A5
+:104FF00000F0BAFA002851D00421904800F069FA74
+:105000009448007800F04000C0B38C4800F0A3FA48
+:10501000914908800846008890490988884204DA46
+:1050200042F20F708E49086002E000208C4908604F
+:105030008948008889490988401A894909680844CB
+:10504000754908600968874A1268881A002801DBD8
+:10505000014600E04142B1F5FA7F03DD8148006876
+:105060006D4908606C4800687E49086000207949F5
+:1050700008700021714800F073FB0FE0FFE76F48F4
+:1050800000F069FA754908807248007840F04000E5
+:10509000704908700221694800F062FB724800788C
+:1050A00000F08000002857D10821644800F05CFA25
+:1050B000002851D00821614800F00BFA6A480078B6
+:1050C00000F04000C0B35D4800F048FA674908802E
+:1050D0000846008866490988884204DA42F20F705F
+:1050E0006449086002E00020624908605F48008867
+:1050F0005F490988401A5F49096808445E490860A9
+:1051000009685E4A1268881A002801DB014600E03F
+:105110004142B1F5FA7F03DD5848006856490860FE
+:10512000554800685549086000204F490870002123
+:10513000424800F07FFB0FE0FFE7404800F00EFA26
+:105140004B4908804848007840F0400046490870C4
+:1051500002213A4800F06EFB4948007800F08000D8
+:10516000002857D11021354800F0FEF9002851D011
+:105170001021324800F0ADF94148007800F04000BD
+:10518000C0B32E4800F0EDF93E490880084600887B
+:105190003D490988884204DA42F20F703B490860B1
+:1051A00002E00020394908603648008836490988FD
+:1051B000401A364909680844354908600968354A83
+:1051C0001268881A002801DB014600E04142B1F56F
+:1051D000FA7F03DD2F4800682D4908602C480068DD
+:1051E0002C4908600020264908700021134800F06F
+:1051F00073FB0FE0FFE7114800F0B3F92249088084
+:105200001F48007840F040001D49087002210B48FB
+:1052100000F062FB10BD0000940000209A01002005
+:105220004002002099010020980100209B010020ED
+:105230009C0100209D010020680000200004014026
+:105240006C0000206A0000208000002090000020F8
+:10525000A00000206E0000207200002070000020DE
+:1052600084000020A40000207400002078000020AA
+:10527000760000208800002098000020A800002070
+:105280007A0000207E0000207C0000208C0000209E
+:105290009C000020AC00002030B589B005460C46CB
+:1052A00001210220FEF790FE01210420FEF76CFE92
+:1052B0004FF47070079002208DF8200003208DF8C5
+:1052C000210000208DF8220002208DF8230007A97C
+:1052D0004348FCF71BFF032206214148FCF75EFF11
+:1052E000032207213E48FCF759FF032208213C48CE
+:1052F000FCF754FF032209213948FCF74FFF0595BD
+:10530000ADF810400020ADF81800ADF8120004A967
+:10531000344800F029FB0020ADF80000ADF8020091
+:105320000120ADF804000020ADF806000F20ADF814
+:10533000080069462B4800F028F90420ADF8000069
+:105340000020ADF802000120ADF804000020ADF807
+:105350000600ADF808006946224800F016F908205A
+:10536000ADF800000020ADF802000120ADF8040007
+:105370000020ADF80600ADF808006946194800F0B5
+:1053800004F90C20ADF800000020ADF80200012067
+:10539000ADF804000020ADF80600ADF8080069463D
+:1053A000104800F0F2F82E208DF80C0002208DF845
+:1053B0000D008DF80E0001208DF80F0003A8FEF7F8
+:1053C0002BF801221E21074800F01FF90121054892
+:1053D00000F08EF80121034800F07EF809B030BDDE
+:1053E00000080240000401400348008820F001004A
+:1053F00001490880704700001004014030B58BB0AF
+:1054000005460C4601210804FEF7DEFD01211020AF
+:10541000FEF7BAFD032205212448FCF7BFFE032254
+:1054200006212248FCF7BAFE6020069002208DF883
+:105430001C0003208DF81D0000208DF81E000120A7
+:105440008DF81F0006A91948FCF760FE0995ADF814
+:1054500020400020ADF82800ADF8220008A914482B
+:1054600000F082FA6020ADF804000120ADF80600DB
+:105470000020ADF8100001A90D4800F0CFF801A9F7
+:105480000B4800F01BF90821094800F00EF908212B
+:10549000074800F072F90121054800F00BF80121DE
+:1054A000034800F019F80BB030BD000000100240B6
+:1054B0000040014021B1028842F08002028004E0F5
+:1054C00002884FF67F731A4002807047CA430282F7
+:1054D0007047CA430282704721B1028842F001023C
+:1054E000028004E002884FF6FE731A400280704783
+:1054F00031B1B0F8442042F40042A0F8442005E065
+:10550000B0F84420C2F30E02A0F844207047F0B572
+:105510000C4615461E460021002200230189028BFD
+:10552000038C4FF6F877394021434FF6FC473A4059
+:1055300040F201173A434FF6DD773B404FF6FF77D5
+:1055400007EA06172F433B43018102830384F0BD22
+:105550000146486B70470146886B70470146C86B2F
+:1055600070470146086C704730B5024600200023A2
+:105570000024158A05EA0103958905EA010413B19F
+:105580000CB1012000E0002030BD70B505460C468E
+:10559000208850B92389A28861882846FFF752FAEB
+:1055A000E188284600F0B4F925E0208804280AD1D3
+:1055B0002389A28861882846FFF761FAE188284696
+:1055C00000F0AFF917E0208808280AD12389A288C3
+:1055D00061882846FFF77BFAE188284600F0AEF99B
+:1055E00009E02389A28861882846FFF794FAE188B8
+:1055F000284600F0ACF970BD0021018041800121F6
+:1056000081800021C180018170471AB183890B43D9
+:10561000838102E083898B438381704770B50024C6
+:1056200000220023058C4FF6FE7635400584028C5F
+:105630008388048B4FF68F752C40B51E2C400D8847
+:105640002C43751E2A408D892A434D882A43104DCC
+:10565000A84202D00F4DA84213D14FF6F7752A4049
+:10566000CD892A434FF6FB752A408D882A434FF691
+:10567000FF652B404FF6FF552B400D8A2B434D8A7B
+:105680002B43838004838D684563028470BD0000D2
+:1056900000000140000401400A460021018C4FF641
+:1056A000FD7319401143018470470A460021018BA4
+:1056B0004FF6F773194011430183704770B500240A
+:1056C00000220023058C4FF6EF7635400584028CCE
+:1056D0008388048B48F6FF752C404FF6FF452C401D
+:1056E0000D884FF6FF7606EA05252C434FF6DF7549
+:1056F0002A408D8906EA05152A434D8806EA0515D4
+:105700002A43154DA84202D0144DA8421DD14FF690
+:105710007F752A40CD894FF6FF7606EA05152A43A4
+:105720004FF6BF752A408D8806EA05152A434FF6C5
+:10573000FF352B404FF2FF752B400D8A06EA850599
+:105740002B434D8A06EA85052B43838004838D68AD
+:105750008563028470BD0000000001400004014028
+:105760000A460021018C4FF6DF7319404FF6FF7394
+:1057700003EA02131943018470470A460021018B92
+:105780004FF2FF7319404FF6FF7303EA02231943E8
+:105790000183704770B5002400220023058C4FF66A
+:1057A000FF6635400584028C8388848B4FF68F75A5
+:1057B0002C404FF6FC752C400D882C434FF6FF55BE
+:1057C0002A408D894FF6FF7606EA05252A434D8843
+:1057D00006EA05252A43154DA84202D0144DA842D9
+:1057E0001DD14FF2FF752A40CD894FF6FF7606EAAC
+:1057F00005252A434FF6FF352A408D8806EA052500
+:105800002A434EF6FF752B404DF6FF752B400D8A4F
+:1058100006EA05152B434D8A06EA05152B438380BE
+:1058200084838D68C563028470BD00000000014060
+:10583000000401400A460021018C4FF6FF53194035
+:105840004FF6FF7303EA02231943018470470A46A7
+:105850000021818B4FF6F773194011438183704704
+:1058600070B5002200230024058C4EF6FF763540EB
+:105870000584038C8488828B48F6FF752A404FF696
+:10588000FF452A400D884FF6FF7606EA05252A4394
+:105890004DF6FF752B408D8906EA05352B434D8863
+:1058A00006EA05352B430A4DA84202D0094DA8420D
+:1058B00008D14BF6FF752C400D8A4FF6FF7606EAAD
+:1058C00085152C43848082838D680564038470BDB4
+:1058D00000000140000401400A460021018C4DF601
+:1058E000FF7319404FF6FF7303EA02331943018433
+:1058F00070470A460021818B4FF2FF7319404FF623
+:10590000FF7303EA022319438183704741627047A2
+:10591000028B4FF6F3731A400283028B0A43028311
+:105920007047028B4FF2FF331A400283028B4FF60F
+:10593000FF7303EA01231A4302837047828B4FF6F9
+:10594000F3731A408283828B0A4382837047828B6F
+:105950004FF2FF331A408283828B4FF6FF7303EAC4
+:1059600001231A438283704700220288184B984211
+:105970000ED0184B98420BD0B0F1804F08D0164B88
+:10598000984205D0154B984202D0154B984204D14D
+:105990004FF68F731A404B881A43124B984207D028
+:1059A000114B984204D04FF6FF431A400B891A431B
+:1059B00002804B68C3620B880385054B984202D076
+:1059C000044B984201D18B7A03860123838270476E
+:1059D00000000140000401400004004000080040B5
+:1059E000000C004000100040001400404FF0FF3158
+:1059F0004160002101800181418081727047000077
+:105A000001460A2906DB0C4A12681AB10B4A1278C1
+:105A1000012A0ED101200022094B1A60094B1A609D
+:105A2000094B5A639A63094B9A639A631A64DA635F
+:105A300000E00020704700000C8241425C01002021
+:105A4000344401403448014000400140000001401E
+:105A500010B52DED028B40F225513B4800F08EFB36
+:105A600000286ED0384800F043FCC4B237480068C4
+:105A7000B0F57A7F03DA0020BDEC028B10BD34480C
+:105A80003449097844547B2C03D0324800780028EC
+:105A900005DD30480078401C2E49087002E00020E7
+:105AA0002C4908702B4800780B284AD1002029493E
+:105AB00008702748807A7D2843D100210920FBF710
+:105AC0005BFD2349497A88423BD100202249087076
+:105AD000224908702249087022490870224908703A
+:105AE000224908701A4A1179D07800F075FC2048D4
+:105AF00080ED000A164A9179507900F06DFC1D483E
+:105B000080ED000A124A117AD07900F065FCB0EEFF
+:105B1000408A1948007802280AD1F0EE480A144851
+:105B200090ED000A00F0ECFB144880ED000A07E05D
+:105B3000074A117AD07900F04FFC104880ED000A36
+:105B400000BF002098E7000000500040D401002072
+:105B5000BC060020C5000020980100209A0100200A
+:105B6000990100209B0100209D010020DE01002002
+:105B700070010020740100206401002078010020E1
+:105B80002DE9F0412DED028B40F22551434800F004
+:105B9000F5FA00287FD000260127404800F0A8FB36
+:105BA000C5B23F480068B0F57A7F04DA0020BDEC4A
+:105BB000028BBDE8F0813B483B49097845547B2D79
+:105BC00003D039480078002805DD37480078401CAC
+:105BD0003549087002E000203349087032480078E7
+:105BE0000B2857D10020304908702E48807A7D2834
+:105BF00050D1002403E02B48005D4640641C092C72
+:105C0000F9DB2848407AB04200D10027002F41D16B
+:105C10002648007858B901202449087000202449FA
+:105C2000087024490870244908702449087000202D
+:105C3000234908701B4A1179D07800F0CDFB214828
+:105C400080ED000A174A9179507900F0C5FB1E4893
+:105C500080ED000A134A117AD07900F0BDFBB0EE56
+:105C6000408A1A48007802280BD1F0EE480A1548FD
+:105C700090ED000A00F044FB154880ED000A08E0B2
+:105C800009E0084A117AD07900F0A6FB104880EDAF
+:105C9000000A00BF00BF002089E70000001001409B
+:105CA000D4010020DC060020B80000209C01002068
+:105CB00099010020980100209A0100209B010020FA
+:105CC000DE0100207001002074010020640100202A
+:105CD0007801002000B5002200BF05E00449885C7F
+:105CE00004F046FC501CC2B2182AF7DB00BD0000CD
+:105CF0008C06002010B52DED0C8B40F225519F48ED
+:105D000000F03CFA00287DD09C48001D04889C4887
+:105D10000068B0F57A7F03DA0020BDEC0C8B10BD73
+:105D2000412C15D197480078412811D19648007828
+:105D300070B9002095490870954908700120924972
+:105D400008700020934908709349087093490870BF
+:105D50008C490C704B2C03D101209149087006E04E
+:105D6000492C01D04A2C02D100208D4908708C4862
+:105D7000007888B9412C06DB482C04DCA4F14000F3
+:105D8000884908702FE0082C02DC86490C702AE054
+:105D900000208449087026E081480078012822D13B
+:105DA000432C06D100208049087001207F490870EB
+:105DB0000DE0472C06D101207B49087000207B496B
+:105DC000087004E000207849087078490870412C78
+:105DD00001D0452C04D1A4F140007249087002E0C2
+:105DE000002070490870582C08D1714890ED000AC5
+:105DF000DFED700A30EE200A80ED000A592C0AD13E
+:105E00006B4800E0B7E090ED000ADFED6A0A30EE83
+:105E1000600A80ED000A7B2C02D1012066490870DF
+:105E20007D2C02D102206449087063480078012863
+:105E300008D16249624A12788C5461480078401C4B
+:105E40005F4908705C480078022870D15B48C078D0
+:105E5000502803D101205B49087070E05748407812
+:105E600023286CD056480078574908703AE05449C6
+:105E70000978554A1278881A06F06BF941EC1D0B27
+:105E8000B0EE4D1AF0EE6D1A9FED500B00F060FC75
+:105E9000B0EE40BAF0EE60BA4B490978491E474A65
+:105EA000515CA1F1300006F054F941EC1C0B53ECAD
+:105EB0001B2B06F0B5F941EC190B4648006806F0BB
+:105EC000A5FC41EC1A0B53EC192B05F0FFFE41EC3D
+:105ED000180B05F0C9FE3F4908603B480078401E9A
+:105EE00039490870384800780428C0DA33484078C7
+:105EF0003038092822D2DFE800F0050C131B1C1DE6
+:105F00001E1F2000334890ED000A294880ED000A4A
+:105F100014E0304890ED000A2F4880ED000A0DE0B3
+:105F20002C4890ED000A2D4880ED000A06E016E0AE
+:105F300004E003E002E001E000E000BF00BF002059
+:105F40001D4908701E4908701F4908709FED240AFA
+:105F5000204880ED000A32211848FAF7FEFA14486A
+:105F600090ED000AB5EEC00AF1EE10FA03D29FEDF3
+:105F70001C0A80ED000A0020CFE60000004400402B
+:105F800040020020BC000020990100209801002060
+:105F90009A0100209B0100209C0100209D0100200F
+:105FA000A1010020A00100209E0100209F010020EF
+:105FB0006C0100200000C842B9000020E706002064
+:105FC000BA000020A2010020BB0000200000000059
+:105FD00000002440C00000207C010020800100203F
+:105FE0000000000010B52DED028B40F225513D4818
+:105FF00000F0C4F8002873D03A4800F079F9C4B230
+:1060000039480068B0F57A7F03DA0020BDEC028BD6
+:1060100010BD36483649097844547B2C03D03448A7
+:106020000078002805DD32480078401C30490870AF
+:1060300002E000202E4908702D4800780B284FD12F
+:1060400000202B4908702948807A7D2848D10021FA
+:106050000920FBF791FA2549497A884240D100206E
+:10606000244908702449087024490870244908709C
+:106070002449087024490870244908701B4A117982
+:10608000D07800F0A9F9224880ED000A174A9179EA
+:10609000507900F0A1F91F4880ED000A134A117AE7
+:1060A000D07900F099F9B0EE408A1B4880ED008A63
+:1060B0001A48007802280AD1F0EE480A144890EDF8
+:1060C000000A00F01DF9164880ED000A07E0074AB3
+:1060D000117AD07900F080F9114880ED000A00BFF4
+:1060E000002093E700480040D4010020BC060020B7
+:1060F000C4000020980100209A010020990100208E
+:106100009B0100209C0100209D010020DE01002059
+:106110007001002074010020B00000206401002004
+:106120007801002000B5002200BF05E00449885C2A
+:1061300004F02AFA501CC2B2182AF7DB00BD000096
+:106140008C06002000B5002200BF05E00449885CF1
+:1061500004F028FA501CC2B2182AF7DB00BD000078
+:106160008C06002021B1828942F40052828104E031
+:1061700082894DF6FF731A408281704770B50246DE
+:10618000002400230025002040F66A16B14200D109
+:1061900000BFC1F3421501F01F03012606FA03F305
+:1061A000012D02D19689334006E0022D02D1168AD4
+:1061B000334001E0968A33400C12012606FA04F4BB
+:1061C0001688344013B10CB1012000E0002070BDEE
+:1061D000F0B50346002400260025002040F66A178B
+:1061E000B94200D100BF1846C1F3421401F01F06A6
+:1061F000012707FA06F5012C01D10C3004E0022C2E
+:1062000001D1103000E014301AB107682F43076045
+:1062100002E00768AF430760F0BD00002DE9FF47CB
+:1062200005460E460024A14600BFA046B08900B135
+:1062300000BF2C8A24F44054F08804432C82AC899B
+:1062400041F20C608443B088318908437189084366
+:106250000443AC81AC8A24F44074B0890443AC821A
+:106260006846FDF7D1FE2048854202D01F4885428E
+:1062700002D1DDF80C9001E0DDF80890A88900F467
+:10628000004040B109EBC90000EB0910316849003A
+:10629000B0FBF1F707E009EBC90000EB091031682A
+:1062A0008900B0FBF1F76420B7FBF0F0040120098E
+:1062B000642101FB1078A88900F4004040B132202D
+:1062C00000EBC800B0FBF1F000F00700044308E069
+:1062D000322000EB08106421B0FBF1F000F00F0059
+:1062E00004432C81BDE8FF870010014000140140E9
+:1062F00001468888C0F30800704700BFFEE7000031
+:1063000000B52DED108B83B0F0EE408AB0EE60FA50
+:106310009FED2A0A8DED020AB5EEC0FAF1EE10FAF1
+:1063200041D0F5EEC08AF1EE10FA3CD0C8EE8FFAFB
+:106330002348006806F06AFA41EC1E0B9FED210B22
+:1063400053EC102B05F06CFF41EC1C0B1FEE900A78
+:1063500006F05CFA41EC1D0B53EC1C2B05F0B6FC6F
+:1063600041EC1B0B1948006806F050FA53EC1B2B4C
+:10637000CDE900019DED000B51EC100B05F062FD25
+:1063800041EC1A0BB0EE4A0AF0EE6A0A00F074F81B
+:10639000B0EE409AF0EE609A51EC190B05F064FCF7
+:1063A00008EE100A01E09FED0A8A0A4880ED008A93
+:1063B000B0EE480A03B0BDEC108B00BD3333B33EE2
+:1063C0008C0100209A9999999999A93F90010020F0
+:1063D00000000000B40000202DE9F0412DED088BF5
+:1063E00004460D4605EB042006B24FF47A7096FB86
+:1063F000F0F100FB1167384605F0ABFE41EC1B0BDA
+:106400009FED0F0B53EC102B05F00AFF41EC190B1D
+:106410004FF47A7096FBF0F7384605F09AFE41EC9F
+:106420001A0B53EC192B05F051FC41EC180B05F03D
+:106430001BFC00EE100ABDEC088BBDE8F0810000EB
+:10644000FCA9F1D24D62503F03B40198410000987D
+:1064500050EAC12018BF04204A0D18BF40F00100C7
+:1064600040F2FF72B2EB515F08BF40F0020001281A
+:1064700008BF052002B0704770B59B482DED020B98
+:106480002DED068B079D25F00044A04218DC9748AF
+:10649000844202DC0AD1069840B19DED060BBDECAA
+:1064A000068B02B0BDE8704001F052BC002DCCBF9D
+:1064B0009FED8F0B9FED900BBDEC068B02B070BD76
+:1064C0008F48A04215DD8F48A042D8BF4FF0FF345F
+:1064D00058DD9DED060B51EC100BFFF7B5FF0428BE
+:1064E00008BF01F069FC9DED060BBDEC068B02B008
+:1064F00070BD9DED060B51EC100B01F0F9FFCDE9DD
+:10650000060181489FED828BA0423CDD8248A0427B
+:106510001FDD00249FED82AB9DED060B53EC1A2B83
+:1065200051EC100B05F0D2FB9DED060B41EC190B65
+:1065300053EC1A2B51EC100B05F072FE53EC182B98
+:1065400006F07AF853EC192B05F07CFCCDE9060136
+:1065500049E09DED060B012453EC182B51EC100B78
+:1065600005F0B4FB9DED060B41EC190B53EC182B19
+:1065700051EC100B06F060F853EC192B05F062FC9F
+:10658000CDE906012FE06848A0421FDD02249FEDFF
+:10659000689B9DED060B53EC192B51EC100B05F08D
+:1065A0003FFE53EC182B05F091FB9DED060B41ECE3
+:1065B000180B53EC192B51EC100B06F03DF853EC73
+:1065C000182B05F03FFCCDE906010CE09DED060B14
+:1065D000032453EC102B9FED580B51EC100B05F0DE
+:1065E00031FCCDE906019DED060B53EC102B51EC6F
+:1065F000100B05F015FE41EC180B53EC182B05F0B1
+:106600000FFE41EC190B4E480621B0EE490AF0EEA0
+:10661000690A784401F060F953EC182B51EC100B27
+:1066200005F0FEFD41EC180B4648B0EE490AF0EECD
+:10663000690A0521784401F04FF953EC192B51EC0C
+:10664000100B05F0EDFD41EC100B51EC180B53EC69
+:10665000102B002C0EDA05F039FB9DED061B53ECD8
+:10666000112B05F0DDFD9DED061B53EC112B05F004
+:106670000BFF35E005F02AFB9DED061B53EC112BBB
+:1066800005F0CEFD41EC100B2F48784400EBC40020
+:1066900090ED001B51EC100B53EC112B05F0CCFFCF
+:1066A0009DED061B53EC112B05F0C6FF41EC100BC2
+:1066B0002648784400EBC40090ED001B51EC100B11
+:1066C00053EC112B05F0E0FE41EC100B002DA2BFA6
+:1066D000BDEC068B02B070BD51EC100B05F0B8FAA2
+:1066E00041EC100B01E70000000010440000F07FB7
+:1066F000182D4454FB21F93F182D4454FB21F9BFB8
+:106700000000DC3F0000203E0000F33F00000000DE
+:10671000000000000000F03F0000E63F0000000025
+:106720000000000000000040008003400000000066
+:10673000000000000000F83F000000000000F0BF73
+:10674000EA780000A07800002A780000E2770000D4
+:106750002DE9F04D2DED040B2DED0E8B96B0DDE9FE
+:106760002550279CDDF890A025F0004624F0004835
+:10677000BAF1000F14BF0121002101EB4502FC49D1
+:1067800053184A1093422AD3002814BF0123002330
+:1067900003EB44030B44F7498B4220D358EA000132
+:1067A0009FEDF59B76D0DFF8D8B35D4503D1BAF104
+:1067B000000F05D188E0BAF1000F08BF002100D01A
+:1067C000012101EB450111F5001F08D8002814BF75
+:1067D0000121002101EB440111F5001F0BD99DEDB2
+:1067E000261B9DED240B16B0BDEC0E8B04B0BDE84E
+:1067F000F04D01F0B7BA0027002DBCBFE149884534
+:1068000021DAE1498845A8BF02271CDAC3451ADC12
+:10681000DE4901EB2851142908DDC1F1340220FAC8
+:1068200002F101FA02F282420DD108E058B9C1F139
+:10683000140228FA02F101FA02F2424503D101F0F2
+:106840000101C1F1020756EA0A0124D1002C22DA23
+:10685000002D18BF022F01D0012F0AD00220F9F716
+:10686000A7FE16B0BDEC0E8B04B0BDE8F04D01F0F4
+:1068700057BA0220F9F79CFE01F052FA51EC100BC6
+:1068800005F0E6F941EC100B16B0BDEC0E8B04B030
+:10689000BDE8F08D18E09FEDBEAB9FEDBF8B0028EB
+:1068A00071D1B848804522D105F1804010F58010A3
+:1068B00008BFBAF1000F07D0B3450ADC002CA8BF0F
+:1068C0009DED260BE0DA0DE0B0EE490AF0EE690A24
+:1068D000DAE7002C06DA9DED260B51EC100B05F0E3
+:1068E000B7F96FE0AE48784490ED000BCCE7D8459F
+:1068F0004DD1002C48DA2EB186423AD1BAF1000FC0
+:1069000042D126E0BAF1000F13D00220F9F750FE71
+:1069100001F042FA8DED020B9DED240B8DED000B85
+:1069200010EE900A039961F31E0003909DED020B97
+:10693000AAE78DED02AB9DED240B1AEE901A10EE36
+:10694000900A8DED000B61F31E0003909DED020B8C
+:106950009AE78DED028B9DED240B18EE901A10EE48
+:10696000900A8DED000B61F31E0003909DED020B6C
+:106970008AE709DA9DED240B51EC190B53EC102B2F
+:1069800005F060FA1EE020E09DED240B7CE78642D6
+:106990001BDAB4F1804F0DD0A4F10050B0F1FF50DC
+:1069A00013D1002D11DB9DED240B51EC100B03F0E6
+:1069B0002FFB07E09DED240B53EC102B51EC100B3B
+:1069C00000F0C2BC41EC100B5EE79DED240B51ECD6
+:1069D000100B01F08DFDBAF1000FCDE90E0142D18F
+:1069E0009FED710B46B3A6F1E040B0F17F600CD093
+:1069F0005E4538D1002D00DAA7B3022F0CBF01206D
+:106A00004FF0FF3005F0A5FBDCE7002D01DD002C89
+:106A10000DDA002D01DD002C1FDB002D16DA002C15
+:106A200014DB012F08BF9FED620B3FF42DAFB0EEDA
+:106A30004A0AF0EE6A0A27E7022F18BF002D0CD091
+:106A4000012F0AD1002DFFF61FAF06E0002DB8BFC1
+:106A5000002C08DA012F3FF417AFB0EE480AF0EE31
+:106A6000680A11E71BE0012000EBE57050EA07011E
+:106A700015D0791EB0EE498AF0EE698A084308BF46
+:106A80009FED4D8B4E480025804570DD4D494E48A9
+:106A9000884514DDB0420DDB002C19DB2FE001200E
+:106AA000F9F786FD16B0BDEC0E8B04B0BDE8F04DD5
+:106AB00001F062B9B34502DC002C09DC1FE086421C
+:106AC00002DA002C1BDA03E05E452BDD002C16DD1C
+:106AD0000220F9F76DFD01F05FF98DED020B53EC2B
+:106AE0001A2B51EC180B05F09BFBCDE90001039923
+:106AF000019861F31E0003909DED020BC4E6022095
+:106B0000F9F756FD01F058F910EE901A18EE900AB8
+:106B10008DED020B8DED008B61F31E0003909DED5A
+:106B2000020BB1E69DED0E0B53EC192B51EC100B43
+:106B300005F082FD9FED260BCDE9080153EC102BEB
+:106B40009DED080B51EC100B05F06AFB9FED221B2D
+:106B500053EC112B05F098FC9DED081B53EC112B09
+:106B600005F05EFB9FED1E1B53EC112B3CE08CE00F
+:106B7000FFFF1F00FFFF0F00000000000000F03FBC
+:106B80000000F03F0000F07F0000404301FCFFFFE9
+:106B9000000000000000F07F000000000000000086
+:106BA000CE76000000000000000000000000008021
+:106BB000000000000000F0FF000000000000F0BF37
+:106BC0000000E0410000F043FFFFEF3F0000000045
+:106BD000000000000000D03F555555555555D53F94
+:106BE000000000000000E03F05F04EFC9DED080BAA
+:106BF00041EC1A0B53EC102B51EC100B05F010FB71
+:106C000053EC1A2B05F00CFB41EC1A0B9FEDFE0B1D
+:106C100053EC102B9DED080B51EC100B05F000FB15
+:106C200041EC1B0B9FEDFA0B51EC1A0B53EC102BA4
+:106C300005F0F6FA41EC1A0B9FEDF70B53EC102B15
+:106C40009DED080B51EC100B05F0EAFA53EC1A2BF2
+:106C500005F0F2FC41EC1A0B51EC1B0B53EC1A2B18
+:106C600005F034F80690CDE906519DED060B53EC86
+:106C70001B2B51EC100B05F0DFFC53EC1A2B05F02D
+:106C800003FC41EC100B00F0A1B90020B6F5801F09
+:106C90000EDA9FEDE30B53EC102B9DED0E0B51EC38
+:106CA000100B05F0BDFACDE90E016FF034000E4671
+:106CB00000EB2650A0F2FF37C6F31300DA4940F08C
+:106CC0007F6646F040568842D8BF002408DDD74989
+:106CD0008142C8BF012403DC0024A6F580167F1C76
+:106CE000D348784400EBC4000F9690ED00CB9DEDA7
+:106CF0000E0B53EC1C2B51EC100B05F09DFC9DED85
+:106D00000E0B41EC1B0B53EC1C2B51EC100B04F045
+:106D1000DDFF41EC100B51EC190B53EC102B05F07F
+:106D200091F841EC1D0B51EC1B0B53EC1D2B05F0A6
+:106D300077FA41EC1A0BBF488DED10AB78441095F3
+:106D400090ED000B4FF0005040EA660000EB8440ED
+:106D50008DED080B00F5002009909DED080B53EC1C
+:106D60001C2B51EC100B05F067FC9DED0E1B53EC3A
+:106D7000112B05F089FB41EC100B53EC102B9DED12
+:106D8000100B51EC100B05F04BFA9DED080B41EC8C
+:106D90001C0B53EC102B9DED100B51EC100B05F060
+:106DA0003FFA53EC1B2B05F06FFB53EC1C2B05F04B
+:106DB00043FC53EC1D2B05F033FA41EC1C0B53EC58
+:106DC0001A2B51EC1A0B05F02BFA41EC1B0B9A48CD
+:106DD0000621B0EE4B0AF0EE6B0A784400F07CFD21
+:106DE000B0EE401AF0EE601AB0EE41DAF0EE61DA81
+:106DF00053EC1B2B51EC1B0B05F012FA53EC1D2B23
+:106E000005F00EFA9DED100B41EC1B0B53EC1A2B09
+:106E100051EC100B04F05AFF53EC1C2B05F000FA58
+:106E200053EC1B2B04F052FF9DED100B41EC1B0BA0
+:106E300053EC102B51EC100B05F0F2F941EC1D0B4B
+:106E40009FED7FEB53EC1E2B04F040FF53EC1B2B0C
+:106E500004F03CFF0890CDE908519DED080B53EC80
+:106E60001E2B51EC100B05F0E7FB53EC1D2B05F02E
+:106E7000E3FB53EC1B2B05F007FB9DED080B41ECEE
+:106E80001D0B53EC102B9DED100B51EC100B05F06E
+:106E9000C7F941EC1B0B53EC1A2B51EC1D0B05F001
+:106EA000BFF99DED080B41EC1A0B53EC102B51EC84
+:106EB0001C0B05F0B5F953EC1A2B04F007FF41EC5D
+:106EC0001A0B51EC1B0B53EC1A2B04F0FFFE0C9029
+:106ED000CDE90C519DED0C0B53EC1B2B51EC100B21
+:106EE00005F0AAFB53EC1A2B05F0CEFA41EC1B0B74
+:106EF0009FED550B53EC102B9DED0C0B51EC100B33
+:106F000005F08EF941EC1A0B9FED510B51EC1B0B68
+:106F100053EC102B05F084F941EC1B0B9FED4E0B4D
+:106F200053EC102B9DED0C0B51EC100B05F078F988
+:106F300053EC1B2B04F0CAFE41EC100B484878447C
+:106F400000EBC40090ED001B51EC100B53EC112B27
+:106F500004F0BCFE41EC1B0B384605F0FAF8CDE915
+:106F6000080153EC1B2B51EC1A0B04F0AFFE41EC63
+:106F7000100B3C48784400EBC40090ED00CB51EC82
+:106F8000100B53EC1C2B04F0A1FE9DED081B53ECE1
+:106F9000112B04F09BFE0690CDE906519DED080BE8
+:106FA00053EC102B9DED060B51EC100B05F044FB40
+:106FB00053EC1C2B05F040FB53EC1A2B05F03CFB6B
+:106FC00053EC1B2B05F060FA41EC100B9DED261BDA
+:106FD00053EC102B8DED001B00959DED260B51EC15
+:106FE000100B05F01DF99DED000B41EC1A0B53EC55
+:106FF000102B9DED260B51EC100B05F01DFB9DEDAC
+:10700000061B53EC112B2FE0000000604715F73FE3
+:10701000FE822B654715F73F44DF5DF80BAE543E0B
+:1070200000000000000040438E9803007AB60B0079
+:107030004A720000787200008271000000000000B7
+:107040000000000000000840000000E009C7EE3F1B
+:10705000FD033ADC09C7EE3FF5015B14E02F3EBEAD
+:107060000E700000C86F000005F0DAF853EC1A2B20
+:1070700004F02CFE9DED060B41EC1A0B53EC102B8B
+:107080009DED000B51EC100B05F0CAF8CDE90C0199
+:107090009DED0C0B51EC1A0B53EC102B04F016FE6B
+:1070A000CDE902010C46AA498C422FDB611A084344
+:1070B00018D19DED0C0B53EC102B9DED020B51ECF8
+:1070C000100B05F0B9FA41EC1B0B9FEDA30B51EC33
+:1070D0001A0B53EC102B04F0F9FD53EC1B2B05F0AD
+:1070E0009DF92DD20220F9F763FA00F055FE10EE5B
+:1070F000901A18EE900A8DED020B8DED008B61F366
+:107100001E0003909DED020BFFF7BEBB944A24F0D6
+:107110000041914214D39349214408437FF4EFACDA
+:107120009DED0C0B53EC102B9DED020B51EC100B55
+:1071300005F082FA53EC1A2B05F070F97FF6DFACFC
+:1071400024F000408849894A002601EB2051824200
+:107150002BDA481C4FF4801121FA00F02044844AB5
+:10716000C0F30A517A44A1F2FF3192ED000B814A3B
+:107170008DED080BCA4020EA0202C0F3130040F470
+:107180008010C1F1140120FA01F60992002CB8BF59
+:1071900076429DED080B53EC102B9DED0C0B51EC42
+:1071A000100B05F049FACDE90C019DED0C0B51ECEB
+:1071B0001A0B53EC102B04F089FD9FED6F0B089018
+:1071C000CDE9085153EC102B9DED080B51EC100B41
+:1071D00005F026F841EC1B0B9FED690B53EC102BCF
+:1071E0009DED080B51EC100B05F01AF89DED0C0B02
+:1071F00041EC1C0B53EC102B9DED080B51EC100BCC
+:1072000005F01AFA53EC1A2B05F03EF99FED5E1BC0
+:1072100053EC112B05F004F853EC1C2B04F056FD35
+:1072200041EC1A0B51EC1B0B53EC1A2B04F04EFDE6
+:10723000CDE902019DED020B53EC1B2B51EC100B21
+:1072400005F0FAF953EC1A2B05F01EF99DED020B2F
+:1072500041EC1A0B53EC102B51EC100B04F0E0FF37
+:10726000CDE908014A489DED080B0521784400F05E
+:1072700033FB9DED081B51EC100B53EC112B04F06C
+:10728000CFFF9DED021B53EC112B05F0FDF8CDE96E
+:1072900006019DED020B53EC1A2B51EC100B04F080
+:1072A000BFFF53EC1A2B04F011FD9FED3B0B41EC9B
+:1072B0001A0B53EC102B9DED060B51EC100B05F047
+:1072C000BBF99DED060B41EC1B0B53EC102B9DED18
+:1072D000020B51EC100B04F0A3FF53EC1B2B04F03A
+:1072E000B1FD53EC1A2B05F0A7F99DED021B53ECF1
+:1072F000112B05F0A1F953EC192B05F0C5F8CDE9D8
+:10730000020101EB065001150029C8BF039015DCEE
+:107310009DED020B324651EC100B05F024FBFFF7FC
+:1073200093F8042808BF00F047FD32469DED020B9C
+:1073300051EC100B05F017FBCDE902019DED020B9E
+:1073400051EC180B53EC102B04F06AFFFFF73ABB1B
+:107350000000904000000000FE822B654715973C1E
+:1073600000CC904000346F3F01FCFFFF0000E03F85
+:10737000506E0000FFFF0F0000000000432EE63FAC
+:10738000396CA80C615C20BEEF39FAFE422EE63F54
+:10739000206D000000000000000000000000004020
+:1073A00000B52DED048BB0EE409AF0EE609A83B0FC
+:1073B00051EC190B05F074F841EC180B18EE100A9B
+:1073C00018EE901A8DED008B002818BF012008439D
+:1073D00020F00040C0F17F6000F1E040C00F14D009
+:1073E00019EE101A19EE900A8DED009B002918BFB6
+:1073F0000121084320F00040C0F17F6000F1E0402F
+:10740000C00F04BF0120F9F7D3F8B0EE480A03B06B
+:10741000F0EE680ABDEC048B00BD00000000000027
+:1074200010B51D499FED1A1B2DED020B84B0059878
+:1074300020F000408842DCBF01209DED040B21DDDF
+:107440001649884209D1049840B94FF00100F9F774
+:10745000AFF800F091FC06B010BD05DB9DED040B0C
+:1074600000F076FC06B010BD68469DED040B00F000
+:1074700017F800F001000121A1EB40009DED021B77
+:107480009DED000B00F0A4FA06B010BD0000000056
+:107490000000000000000000FB21E93F0000F07F39
+:1074A0002DE9F14F04462DED020B2DED088B8AB02E
+:1074B0009FEDE70B80ED020B139EE74826F0004599
+:1074C00085420ADC9DED120B002084ED000B0AB012
+:1074D000BDEC088B03B0BDE8F08FE0489FEDE0AB5A
+:1074E0009FEDE1BBA84247DDE14F9FEDE39B9FEDA0
+:1074F000E48B9DED120B53EC1A2B51EC100B002E6C
+:107500001CDD05F099F841EC100BBD4208D053EC9E
+:107510001B2B51EC100B05F08FF8C4E900010BE0B8
+:1075200053EC192B51EC100B05F086F853EC182B8B
+:1075300005F082F8C4E900010120C8E704F0C6FBA9
+:1075400041EC100BBD4208D053EC1B2B51EC100B3F
+:1075500004F0BCFBC4E900010BE053EC192B51EC27
+:10756000100B04F0B3FB53EC182B04F0AFFBC4E991
+:1075700000014FF0FF30AAE7C348A84279DB9DED38
+:10758000120B51EC100B00F0B3FF41EC180B9FED08
+:10759000C00B53EC102B04F043FE9FEDBF1B53ECCC
+:1075A000112B04F093FB04F0A5FD074604F0D1FD78
+:1075B00041EC190B53EC1A2B04F032FE53EC182B50
+:1075C00004F062FF41EC180B53EC1B2B51EC190B30
+:1075D00004F026FEDFF8C8A241EC100B4FEA155864
+:1075E0000125FA4453EC102B51EC180B05F024F84C
+:1075F000032DC4E900013DD0C1F30A5005EB45114C
+:10760000A8EB00001139814234DA0AEB051BB0EE19
+:1076100048AA9BED000BF0EE68AA53EC102B51EC3E
+:10762000190B04F0FDFD41EC1B0B51EC1A0B53EC54
+:107630001B2B05F001F841EC180B51EC1A0B53EC25
+:10764000182B04F0F9FF53EC1B2B04F0F5FF9BED16
+:10765000020B41EC1A0B53EC102B51EC190B04F0FC
+:10766000DFFD53EC1A2B04F0E7FF41EC100B6D1C0F
+:10767000B8E70EE0002EA8BF3846BFF628AF94ED5D
+:10768000000B51EC100B04F0E3FAC4E9000178425E
+:107690001DE7C6F3130040F4801EC6F30A50A0F2A3
+:1076A000F530471100F01F05C5F12000DDF848B0A6
+:1076B00008900020069007900520EC467949002D9F
+:1076C00007EB0002794408BF51F8221009D051F8A5
+:1076D000223001EB8201AB404A68089922FA01F19D
+:1076E0001943A1FB0E26A1FB0B131A449A4234BF87
+:1076F0000123002303EB06080CEB8003D3E901A66A
+:107700000E448E4234BF0121002192448A4411B1BB
+:10771000924502D903E0924501D2012100E0002107
+:10772000C3E901A641444CF82010011EA0F101005C
+:10773000C4DC029800F10050850F0298DDE9036770
+:107740008000DDF8148004F004FD41EC1A0B304693
+:1077500004F016FD9FED541B53EC112B04F060FD5B
+:1077600041EC1B0B384604F00BFD9FED511B53EC15
+:10777000112B04F055FD41EC180B404604F000FDC0
+:107780009FED4D1B53EC112B04F04AFD41EC190BFE
+:1077900051EC180B53EC192B04F098FA53EC1B2BFB
+:1077A00004F094FA53EC1A2B04F090FACDE9080196
+:1077B000002008909DED080B53EC1A2B51EC100B98
+:1077C00004F03AFF53EC1B2B04F036FF53EC182B5C
+:1077D00004F032FF53EC192B04F056FE9FED381BDA
+:1077E00053EC112B04F01CFD9FED370B41EC180BF3
+:1077F00053EC102B9DED080B51EC100B04F010FD19
+:1078000053EC182B04F062FA9FED310B41EC180B8E
+:1078100053EC102B9DED080B51EC100B04F000FD08
+:1078200053EC182B04F052FA41EC100B139810F0A3
+:10783000004F06D06D4251EC100B04F009FA41ECF8
+:10784000100B284684ED000B41E60000000000000C
+:107850000000000000000000FB21E93F7CD902404D
+:1078600000004054FB21F93F3163621A61B4D03DFE
+:10787000FB21F93F000000000000601A61B4D03D18
+:107880007370032E8A19A33BFB21394100000000CD
+:1078900083C8C96D305FE43F000000000000E03F96
+:1078A000DA69000028690000000000000000103EB6
+:1078B000000000000000103C000000000000103A32
+:1078C000182D4454FB21F93D3326A611460B113CDB
+:1078D00000000054FB21F93D70B504462DED028BEC
+:1078E0004D1E00EBC500B0EE408AF0EE608A90EDD0
+:1078F000000B35F0060017D053EC182B51EC100B91
+:1079000004F08EFC41EC100B6D1E04EBC50090EDF5
+:10791000001B51EC100B53EC112B04F0D7F941EC88
+:10792000100B35F00600E7D1022D36D0042D1CD007
+:10793000062D1CBFBDEC028B70BD53EC182B51EC17
+:10794000100B04F06DFC94ED0A1B53EC112B04F0AA
+:10795000BDF953EC182B04F063FC94ED081B53ECB9
+:10796000112B04F0B3F941EC100B53EC182B51EC34
+:10797000100B04F055FC94ED061B53EC112B04F096
+:10798000A5F953EC182B04F04BFC94ED040B53ECCD
+:10799000102B04F09BF941EC100B53EC182B51EC1D
+:1079A000100B04F03DFC94ED021B53EC112B04F082
+:1079B0008DF953EC182B04F033FC94ED001B53ECC1
+:1079C000112B04F083F9BDEC028B41EC100B70BD60
+:1079D000F1B506462DED040BBD482DED0C8B8AB09C
+:1079E000B0EE418AF0EE618A179D25F000449FEDCC
+:1079F000BABB9FEDBBCB844208DA9DED160B51EC70
+:107A0000100B04F077FB002800F0E980B64FA74286
+:107A100031DC002D0DDA9DED160B51EC100B04F04E
+:107A200017F9CDE9160151EC180B04F011F941ECEE
+:107A3000180B9FEDAF0B53EC102B9DED160B51EC7B
+:107A4000100B04F021FD53EC182B9FEDAB0BCDE98F
+:107A5000040151EC100B04F0EFFD41EC100B53EC62
+:107A6000102B9DED040B51EC100B04F02FF99FED42
+:107A7000A48BCDE916019DED160B53EC102B51ECA8
+:107A8000100B04F0CDFBCDE904019DED040B53EC8C
+:107A9000102B51EC100B04F0C3FB41EC190B9A486E
+:107AA0000621B0EE490AF0EE690A7844FFF714FFA8
+:107AB0009648B0EE40DAF0EE60DAB0EE490AF0EE49
+:107AC000690A06217844FFF707FF9DED041B51EC7E
+:107AD000100B53EC112B04F0A3FB9DED040B41ECB8
+:107AE0001A0B53EC102B9DED160B51EC100B04F000
+:107AF00097FB41EC190B53EC1A2B51EC1D0B04F0C6
+:107B0000E5F853EC192B04F08BFB53EC182B04F025
+:107B1000DDF89DED041B53EC112B04F081FB53ECBD
+:107B2000182B04F0D3F841EC180B9FED790B51ECB6
+:107B3000190B53EC102B04F073FB53EC182B04F0CF
+:107B4000C5F841EC190B9DED160B53EC192B51ECBC
+:107B5000100B04F0BBF841EC180BA74269DC30466F
+:107B600004F0F7FA41EC1A0B51EC180B53EC1A2BFA
+:107B700004F0ACF841EC1B0B53EC182B51EC180B38
+:107B800004F04EFB53EC1B2B04F05CF953EC192B67
+:107B900004F052FD9DED161B53EC112B04F074FC08
+:107BA0009FED5D1B53EC112B04F03AFB53EC1A2BA9
+:107BB00004F06AFC41EC180B022000EAA570C0F149
+:107BC000010004F0C6FA53EC182B04F029FB00BFA7
+:107BD00041EC100B0AB0BDEC0C8B05B0F0BD711C74
+:107BE0001698214308430CD09DED160B012E1CBFA7
+:107BF00053EC102B51EC1C0B10D000BF04F022F9F9
+:107C0000E6E79DED160B51EC100B00F071FC41EC1A
+:107C1000100B51EC1B0B53EC102BEFE751EC100B3E
+:107C2000FEF712FC042808BF00F0C6F89DED160B05
+:107C3000D0E7012E04BFB0EE480AF0EE680AC9D0C2
+:107C40008DED048B002404949DED040B53EC102B5C
+:107C50009DED160B51EC100B04F016FC53EC192B98
+:107C600004F012FC41EC190B53EC182B51EC1C0BDB
+:107C700004F0E8F841EC180B8DED008B00949DEDBD
+:107C8000040B53EC102B9DED000B51EC100B04F08A
+:107C9000C7FA53EC1B2B04F019F89DED000B41ECD7
+:107CA0001A0B53EC192B51EC100B04F0B9FA53ECEE
+:107CB0001A2B04F00BF853EC182B04F0B1FA9DEDDD
+:107CC000001B53EC112B04F001F881E700000000C9
+:107CD0000000303E00000000000000000000F03F07
+:107CE000000000000000F0BF2894E53F0000000005
+:107CF000182D4454FB21E93F075C143326A6813C30
+:107D00000000000000000000DA650000F0650000DF
+:107D1000635555555555D53F000000000000004003
+:107D20009FED070B10B553EC102B9FED070B51EC9B
+:107D3000100B04F087F841EC100B10BD00000000A0
+:107D40000000000000000000000000000000F03F04
+:107D500010B553EC102B51EC100B03F0B7FF41ECB6
+:107D6000100B10BD10B553EC112B51EC100B03F0A0
+:107D7000ADFF41EC100B10BD9FED050B10B553ECA2
+:107D8000102B51EC100B04F05DF841EC100B10BD02
+:107D900000000000000000009FED050B10B553EC43
+:107DA000102B51EC100B04F03BFA41EC100B10BD02
+:107DB00000000000000000709FED050B10B553ECB3
+:107DC000102B51EC100B04F02BFA41EC100B10BDF2
+:107DD000000000000000001000BF704701462D4861
+:107DE000006828B92C480088401C2B4A108002E00B
+:107DF0000020294A10802748006828B927480078C1
+:107E000010B90120254A107025480078B0B92348E0
+:107E10000078012807D123480078401C214A1070BF
+:107E200001201F4A10701F480078022806D1002048
+:107E30001C4A10701C4A10800220704715480068C8
+:107E4000012804D10020154A1070154A10701548F9
+:107E5000007801281CD114480088401C124A108068
+:107E60001046008888420ADD0B480088884206DAFE
+:107E700000200C4A10700C4A10800120DDE70648F3
+:107E80000088884204DD0020064A1070064A1080EF
+:107E90000020D2E700024242320000202C000020E5
+:107EA0002D0000202E0000203000002008B500F03A
+:107EB00047FB00900DE03221684602F077FD00F0AC
+:107EC00009F8FDF707FFFEF72DF9FEF73BF9F9F783
+:107ED0001DFBF0E710B52DED0A8B7B20FE490876DF
+:107EE0007D21FD4880F82E10FC480078062873D2CA
+:107EF000DFE800F00373EFEDECEBF94890ED000ADA
+:107F0000F848D0ED000A30EE200AF748D0ED000A1C
+:107F100030EE200AF548D0ED000A30EE200AF1EEEE
+:107F2000000A80EE201A9FEDF20A21EE000ABDEE53
+:107F3000C00A10EE100A01B2E7484183E84890ED0C
+:107F4000000AE848D0ED000A30EE600AE648D0EDBD
+:107F5000000A30EE200AE548D0ED000A30EE600A53
+:107F6000F1EE000A80EE201A9FEDE10A21EE000AF0
+:107F7000BDEEC00A10EE100A01B2D7488183D8487E
+:107F800090ED000AB1EE400AD648D0ED000A30EE7E
+:107F9000600AD548D0ED000A30EE200AD348D0ED73
+:107FA000000A70EE200AB1EE001A80EE810AD14874
+:107FB000D0ED000AD04890ED001A30EE811AC0EEE4
+:107FC000010A9FEDCB0A20EE800ABDEEC00A10EE3A
+:107FD000100A01B2C048C18362E19FEDC80BFFF7F0
+:107FE000DFF9B0EE40CAF0EE60CA9FEDC60B53EC6D
+:107FF000102B51EC1C0B03F025FF41EC1A0BBA4877
+:1080000090ED000AB748D0ED000A30EE600AF0EEBD
+:10801000000A80EE201A11EE104A204604F0F6FB0A
+:1080200041EC1B0B53EC1A2B03F00CFF41EC190B2A
+:108030009FEDB60B53EC102B04F0F2F841EC180B4B
+:1080400004F058F801B2A4484183A64890ED000A14
+:10805000A348D0ED000AB0EE001A10EE810AA24843
+:10806000D0ED000A30EE600AB0EE081AC0EE010A48
+:108070009FED9F0A20EE800ABDEEC00A10EE100AA6
+:1080800001B295488183964890ED000A9548D0ED5D
+:10809000000A30EE200A9448D0ED000A70EE200A63
+:1080A000B0EE081A80EE810A9A48D0ED000A80EE00
+:1080B000201A9FED8F0A21EE000ABDEEC00A10EED5
+:1080C000100A01B28448C183EAE0B7E065E032E01B
+:1080D000FFE7834890ED000A8248D0ED000A30EEB9
+:1080E000200AF0EE000A80EE201A9FED810A21EEB0
+:1080F000000ABDEEC00A10EE100A01B276484183B4
+:1081000000218183774890ED000A7548D0ED000A80
+:1081100030EE600A7848D0ED000A80EE201A9FED1C
+:10812000740A21EE000ABDEEC00A10EE100A01B278
+:108130006948C183B4E06A4890ED000A6948D0ED0F
+:10814000000A30EE200AB0EE001AC0EE010A9FEDE0
+:10815000680A20EE800ABDEEC00A10EE100A01B2D5
+:108160005D484183002181835E4890ED000A5C48B0
+:10817000D0ED000A70EE600A5F4890ED001A80EEC4
+:10818000810ADFED5B0A20EE200ABDEEC00A10EE88
+:10819000100A01B25048C18382E0514890ED000AB4
+:1081A0005048D0ED000A30EE200A4F48D0ED000ACA
+:1081B00030EE200A4D48D0ED000A70EE200AB1EEF4
+:1081C000001A80EE810ADFED4A0A20EE200ABDEE99
+:1081D000C00A10EE100A01B23F484183002181839A
+:1081E000404890ED000AB1EE400A3D48D0ED000A4B
+:1081F00030EE600A3C48D0ED000A30EE200A3B48E1
+:10820000D0ED000A70EE200AB0EE001A80EE810A6E
+:108210003848D0ED000A384890ED001A30EE811A47
+:10822000C0EE010A9FED320A20EE800ABDEEC00AC0
+:1082300010EE100A01B22848C18331E0284890EDC1
+:10824000000A2848D0ED000A30EE200AF0EE000ABD
+:1082500080EE201A9FED260A21EE000ABDEEC00A2C
+:1082600010EE100A01B21C484183002181831D4891
+:1082700090ED000A1A48D0ED000A30EE600A1E4860
+:10828000D0ED000A80EE201A9FED190A21EE000AB7
+:10829000BDEEC00A10EE100A01B20F48C18300BF44
+:1082A00000BF1D4841880C4841841B48008840425B
+:1082B00001B209488184184881880748C184174859
+:1082C00041880548018515480088404201B20248AE
+:1082D00041851348007825E08C06002064010020C9
+:1082E000745A0020885A00209C5A0020B05A00205E
+:1082F00000007A44900100208C0100200000000062
+:1083000000000840000000000000004000000000E5
+:1083100000408F40940100203602002030020020EF
+:108320005C01002020B93B4881883B48818502E000
+:10833000002139488185394890ED000A5FED140A23
+:1083400020EE200ABDEEC00A10EE100A01B232483B
+:108350000184007E30490870314800784870084632
+:10836000408B000A88700846807EC8700846808B63
+:10837000000A08710846007F48710846C08B000A51
+:1083800088710846807FC8710846408C000A0872D0
+:10839000084690F8220048720846808C000A8872CD
+:1083A000084690F82400C8720846C08C000A08737A
+:1083B000084690F8260048730846008D000A887326
+:1083C000084690F82800C8730846408D000A0874D3
+:1083D000084690F82A0048740846808D000A887480
+:1083E000084690F82C00C8740846008C000A0875EE
+:1083F000084690F82000487501211620F9F7BCF8CE
+:1084000005498875084690F82E00C875BDEC0A8BA2
+:1084100010BD0000300200208C0600201800002053
+:108420005C01002070B504460420FCF7BBFA0C4840
+:10843000047025464FF47A704543012009490880AD
+:108440004FF0E020006940F002004FF0E0210861A9
+:1084500008464561006940F00100086170BD0000F8
+:10846000C8000020CA00002070B5044603F048F997
+:10847000012810D00B480088844206D309480088A0
+:10848000B4FBF0F5284602F057FA06480088B4FB22
+:10849000F0F100FB11444FF47A7104FB01F000F09D
+:1084A00003F870BDCA00002070B5034600224FF0EB
+:1084B000E02675690D4E367803FB06F44FF0E02692
+:1084C000B16910E04FF0E026B06988420BD08842D5
+:1084D00002D20E1A324402E02E1A0E4432440146F1
+:1084E000A24200D300E0EDE700BF70BDC80000204D
+:1084F00082B0CDE9000121F0004001909DED000B1C
+:1085000002B051EC100B7047F0EE400AF5EEC00AD5
+:10851000F1EE10FA02DBB0EE600A7047B1EE600ACD
+:10852000FBE7000000BF054A128802F04002002A63
+:10853000F9D0C2B2014B1B1D1A80704700440040A5
+:1085400010B503F0DDF8012802D003F0E9F810BD02
+:1085500001480068FBE70000CC00002009E0054866
+:108560000068C0430449C1F8B0020448006802F042
+:10857000E3F9F4E7B0024042000040423800002036
+:108580001CB501F0FDFD0748012100230A02CDE9D9
+:10859000001005A1074803F083F802F0D7FB002084
+:1085A0001CBD00000000002073746172745F746170
+:1085B000736B000081A0000810B50246012000E0A6
+:1085C00050430B1EA1F10104E1B2F9D110BD00002E
+:1085D00038B54FF4AD70FE4908600A210920FAF75A
+:1085E00007F9FB49096890FBF1F4052C00DD05242F
+:1085F000F84890ED000ADFEDF80A20EE200ABDEE03
+:10860000C00AF64880ED000AF5480068401CF449AD
+:108610000860F448006800287ED1062C28D2DFE8E4
+:1086200004F003090F151B21EFA200210846FBF7F8
+:10863000E3F81DE0EEA200210846FBF7DDF817E0A5
+:10864000EDA200210846FBF7D7F811E0ECA20021CB
+:108650000846FBF7D1F80BE0EBA200210846FBF738
+:10866000CBF805E0EAA200210846FBF7C5F800BFF9
+:1086700000BFE948007818B1E748007801282AD1FE
+:10868000E6A200213720FBF7B7F8E548B0F904006F
+:10869000002810DAE3A200215020FBF7ADF80C20EF
+:1086A0000090DF48B0F904004242052300215A201F
+:1086B000FBF758F84BE0DCA200215020FBF79CF8B8
+:1086C0000C200090D648B0F90420052300215A2040
+:1086D000FBF748F83BE0D048007802280BD0CE48A2
+:1086E0000078032807D0CC480078042803D0CA4873
+:1086F000007805282BD1CDA200213720FBF77CF88C
+:10870000CC48B0F90400002812DAC6A200215A2091
+:10871000FBF772F80C2000E0FEE30090C548B0F9CA
+:1087200004004242032300216420FBF71BF80EE003
+:10873000BDA200215A20FBF75FF80C200090BD4835
+:10874000B0F90420032300216420FBF70BF8B248A2
+:10875000007838B1B0480078012803D0AE480078DE
+:10876000042878D1B4A20A210020FBF745F8B348C9
+:1087700090ED020AB5EEC00AF1EE10FA19D2A9A2E4
+:108780000A210F20FBF738F80C200090AB4890ED41
+:10879000020AB1EE400ADFEDAA0A20EE200ABCEE82
+:1087A000C00A10EE102A05230A211420FAF7DAFF76
+:1087B00016E09DA20A210F20FBF71EF80C20009066
+:1087C0009E4890ED020ADFED9E0A20EE200ABCEEE4
+:1087D000C00A10EE102A05230A211420FAF7C2FF5E
+:1087E000964890ED000AB5EEC00AF1EE10FA19D2E3
+:1087F0008CA20A213C20FAF7FFFF0C2000908F4842
+:1088000090ED000AB1EE400ADFED8D0A20EE200A5D
+:10881000BCEEC00A10EE102A05230A214B20FAF7FD
+:10882000A1FF4EE080A20A213C20FAF7E5FF0C20D0
+:108830000090824890ED000ADFED810A20EE200AC8
+:10884000BCEEC00A10EE102A05230A214B20FAF7CD
+:1088500089FF36E0FFE770480078022807D06E48AD
+:108860000078032803D06C480078052829D175A228
+:108870000A210020FAF7C0FF6948B0F90400002877
+:1088800010DA68A20A213C20FAF7B6FF0C2000900B
+:108890006348B0F90400424205230A214B20FAF74D
+:1088A00061FF0EE060A20A213C20FAF7A5FF0C2030
+:1088B00000905B48B0F9042005230A214B20FAF709
+:1088C00051FF5548007838B153480078012803D04B
+:1088D00051480078042879D15CA214210020FAF7CD
+:1088E0008BFF5B4890ED020AB5EEC00AF1EE10FA7C
+:1088F00019D24CA214210F20FAF77EFF0C20009011
+:10890000534890ED020AB1EE400ADFED4D0A20EE29
+:10891000200ABCEEC00A10EE102A052314210846D6
+:10892000FAF720FF16E040A214210F20FAF764FFA7
+:108930000C200090464890ED020ADFED410A20EE3F
+:10894000200ABCEEC00A10EE102A052314210846A6
+:10895000FAF708FF3E4890ED000AB5EEC00AF1EEC6
+:1089600010FA19D22FA214213C20FAF745FF0C204F
+:108970000090374890ED000AB1EE400ADFED300A72
+:1089800020EE200ABCEEC00A10EE102A05231421A6
+:108990004B20FAF7E7FE16E023A214213C20FAF759
+:1089A0002BFF0C2000902A4890ED000ADFED240AEE
+:1089B00020EE200ABCEEC00A10EE102A0523142176
+:1089C0004B20FAF7CFFE23A21E2145E0BEE00000B7
+:1089D00060010020180000200000C842140200209E
+:1089E00028020020B80100204D656320000000002F
+:1089F0004F6D6E6900000000416B6D2000000000AB
+:108A000044696666000000003457442000000000FE
+:108A100054616E6B0000000064010020475A0000A2
+:108A2000300200202D0000002B000000424941537D
+:108A3000000000005002002041000000745A002095
+:108A400000007A444759524F5F5A3A0042000000F2
+:108A5000885A0020430000000020FAF7CDFEFD48B0
+:108A600090ED020AB5EEC00AF1EE10FA1AD2AFF29A
+:108A70004C021E210F20FAF7BFFE0C200090F54893
+:108A800090ED020AB1EE400A5FED130A20EE200AD3
+:108A9000BCEEC00A10EE102A05231E211420FAF79E
+:108AA00061FE17E0AFF280021E210F20FAF7A4FE4C
+:108AB0000C200090E74890ED020A5FED1F0A20EEBF
+:108AC000200ABCEEC00A10EE102A05231E21142035
+:108AD000FAF748FEDF4890ED000AB5EEC00AF1EE65
+:108AE00010FA1AD2AFF2C4021E213C20FAF784FE1B
+:108AF0000C200090D74890ED000AB1EE400A5FEDDF
+:108B0000300A20EE200ABCEEC00A10EE102A05231F
+:108B10001E214B20FAF726FE1AE1AFF2F4021E21C5
+:108B20003C20FAF769FE0C200090CA4890ED000A3C
+:108B30005FED3D0A20EE200ABCEEC00A10EE102ABE
+:108B400005231E214B20FAF70DFE01E1C2480078F3
+:108B5000022807D0C0480078032803D0BE48007818
+:108B60000528D9D1BDA214210020FAF745FEBC4842
+:108B700090ED020AB5EEC00AF1EE10FA1AD2AFF289
+:108B80005C1214210F20FAF737FE0C200090B44835
+:108B900090ED020AB1EE400A5FED570A20EE200A7E
+:108BA000BCEEC00A10EE102A052314210846FAF77D
+:108BB000D9FD17E0AFF2901214210F20FAF71CFE36
+:108BC0000C200090A64890ED020A5FED630A20EEAB
+:108BD000200ABCEEC00A10EE102A05231421084614
+:108BE000FAF7C0FD9E4890ED000AB5EEC00AF1EE1E
+:108BF00010FA1AD2AFF2D41214213C20FAF7FCFD7D
+:108C00000C200090964890ED000AB1EE400A5FED0E
+:108C1000740A20EE200ABCEEC00A10EE102A0523CA
+:108C200014214B20FAF79EFD17E0AFF20422142125
+:108C30003C20FAF7E1FD0C200090894890ED000AF5
+:108C40005FED810A20EE200ABCEEC00A10EE102A69
+:108C5000052314214B20FAF785FD82A21E21002056
+:108C6000FAF7CAFD804890ED020AB5EEC00AF1EEAF
+:108C700010FA1AD2AFF254221E210F20FAF7BCFDCF
+:108C80000C200090784890ED020AB1EE400A5FEDAA
+:108C9000940A20EE200ABCEEC00A10EE102A05232A
+:108CA0001E211420FAF75EFD17E0AFF284221E2188
+:108CB0000F20FAF7A1FD0C2000906B4890ED020AFE
+:108CC0005FEDA10A20EE200ABCEEC00A10EE102AC9
+:108CD00005231E211420FAF745FD634890ED000A94
+:108CE000B5EEC00AF1EE10FA1AD2AFF2C8221E2178
+:108CF0003C20FAF781FD0C2000905B4890ED000AC3
+:108D0000B1EE400A5FEDB20A20EE200ABCEEC00AC6
+:108D100010EE102A05231E214B20FAF723FD17E041
+:108D2000AFF2FC221E213C20FAF766FD0C200090D9
+:108D30004D4890ED000A5FEDBE0A20EE200ABCEE21
+:108D4000C00A10EE102A05231E214B20FAF70AFD57
+:108D50004148007818B140480078042879D143A2EE
+:108D600028210020FAF748FD414890ED020AB5EEAF
+:108D7000C00AF1EE10FA1AD2AFF2583228210F20B1
+:108D8000FAF73AFD0C200090394890ED020AB1EE56
+:108D9000400A5FEDD50A20EE200ABCEEC00A10EEB4
+:108DA000102A052328211420FAF7DCFC17E0AFF283
+:108DB000883228210F20FAF71FFD0C2000902C4844
+:108DC00090ED020A5FEDE20A20EE200ABCEEC00A36
+:108DD00010EE102A052328211420FAF7C3FC24489A
+:108DE00090ED000AB5EEC00AF1EE10FA1AD2AFF219
+:108DF000CC3228213C20FAF7FFFC0C2000901C48C4
+:108E000090ED000AB1EE400A5FEDF30A20EE200A71
+:108E1000BCEEC00A10EE102A052328214B20FAF7D9
+:108E2000A1FC05E1AFF2004228213C20FAF7E4FC66
+:108E30000C2000900E4890ED000ADFED0E0A20EEA7
+:108E4000200ABCEEC00A10EE102A052328214B2070
+:108E500012E014E09C5A0020640100204C3A00000B
+:108E6000745A0020523A0000885A00204400000042
+:108E7000B05A002000007A44FAF774FCD8E0B148F8
+:108E8000007801282CD1B0A228210020FAF7B4FCE8
+:108E9000AF48B0F91A00002811DAAFF27842282161
+:108EA0003C20FAF7A9FC0C200090A948B0F91A0060
+:108EB0004242052328214B20FAF754FCB8E0AFF2D8
+:108EC000984228213C20FAF797FC0C200090A048FB
+:108ED000B0F91A20052328214B20FAF743FCA7E01C
+:108EE0009848007802282BD19AA228210020FAF76E
+:108EF00083FC9A480068002812DAAFF2D842282191
+:108F00003C20FAF779FC0C20042300909348006879
+:108F100042422821502000E011E1FAF723FC87E0CB
+:108F2000AFF2FC4228213C20FAF766FC0C20042317
+:108F300000908A48282102685020FAF713FC77E055
+:108F400080480078032803D07E48007805286FD138
+:108F500083A228210020FAF74FFC824890ED010AF5
+:108F6000B5EEC00AF1EE10FA16D2AFF2485228213F
+:108F70001420FAF741FC0C2000907A4890ED010A89
+:108F8000B1EE400ABCEEC00A10EE102A04232821DC
+:108F90001E20FAF7E7FB13E0AFF2745228211420E9
+:108FA000FAF72AFC0C2000906E4890ED010ABCEE06
+:108FB000C00A10EE102A042328211E20FAF7D2FB43
+:108FC00069A228213C20FAF717FC684890ED010AB5
+:108FD000B5EEC00AF1EE10FA16D2AFF2B85228215F
+:108FE0005020FAF709FC0C200090604890ED010A2F
+:108FF000B1EE400ABCEEC00A10EE102A042328216C
+:109000005A20FAF7AFFB13E0AFF2E45228215020C8
+:10901000FAF7F2FB0C200090544890ED010ABCEEE8
+:10902000C00A10EE102A042328215A20FAF79AFBCE
+:109030004F480078012805D14EA232210020FAF7CE
+:10904000DBFB33E04D480078012805D14CA23221EA
+:109050000020FAF7D1FB29E04B480078012805D120
+:109060004AA232210020FAF7C7FB1FE049480078E6
+:10907000012805D148A232210020FAF7BDFB15E0F6
+:109080004748007810B94748007808B1012000E04F
+:109090000020012805D144A232210020FAF7ACFBC0
+:1090A00004E043A232210020FAF7A6FB4248006800
+:1090B000012808D14148007828B941A232212D2049
+:1090C000FAF79AFB04E03FA232212D20FAF794FB35
+:1090D0003D480068642190FBF1F50C2002232A46EC
+:1090E000322100904B20FAF73DFB38A23221582064
+:1090F000FAF782FB34480068642190FBF1F201FB2F
+:1091000012050C2002232A46322100906220FAF731
+:1091100029FB2FA232216E20FAF76EFB2A48006845
+:10912000642190FBF1F201FB12000A2807DA0C20FF
+:1091300002230022322100905C20FAF713FBFAF799
+:1091400097FA38BD640100204D4F56455F5A000024
+:109150008C060020534552564F3A0000680100200B
+:109160004D410000745A00204D420000885A0020F2
+:109170009801002050533220200000009901002067
+:1091800041505020200000009A010020522D432021
+:10919000200000009B01002043414E2020000000E1
+:1091A0009C0100209D0100205553415254000000B5
+:1091B000524F5320200000000C8241425C010020ED
+:1091C0004F204E004F464600140200202E000000A3
+:1091D000560000002DE9F04105460E461C48076880
+:1091E0001C480068001D01F0E9F950B919480068F1
+:1091F00090F82C10012088401749096881431648CF
+:109200000160681C38B936B112480168091D13485D
+:1092100001F012FA1AE07C190E4800684460BC4262
+:1092200007D20C480168091D0D48006801F0EAF9F1
+:109230000CE008480168091D0A48006801F0E2F9DD
+:1092400009480068844201D207480460BDE8F08103
+:10925000FC000020E8000020000100202C0A002073
+:10926000F0000020EC0000201801002010B504469A
+:1092700001F0EEF924480068401C234908602348A7
+:10928000006840B9214804600846006801280DD1F3
+:1092900000F0EEF90AE01E48006838B91B48006883
+:1092A000C06AE16A884201D8184804601948006819
+:1092B000401C1849086008460068606494F82C1047
+:1092C0000120884014490968084313490860E16A8D
+:1092D00001EB8101114A02EB8100211D01F0ACF983
+:1092E00001F0FAF90A48006868B108480068C06AE5
+:1092F000E16A884207D24FF0805009490860BFF305
+:109300004F8FBFF36F8F10BDF8000020E8000020E2
+:109310000401002014010020000100205C0700204F
+:1093200004ED00E010B501F093F910480068D0B9E1
+:109330000F4801F057F90F4801F054F90C480E4955
+:1093400008600C480D49086000221021052001F03A
+:1093500077FE064908600846006820B108A1034866
+:10936000006801F0ADFA01F0B7F910BD2C01002042
+:10937000400A0020540A0020240100202801002077
+:10938000546D72510000000070B523E001F034FD0F
+:109390001348006808B9012000E00020054602F0EB
+:1093A0003BFBBDB901F054F90D48C068C468201DED
+:1093B00001F004F90B480068401E0A4908600A4899
+:1093C0000068401E0849086001F086F9204600F058
+:1093D00060F800BF044800680028D7D170BD0000C5
+:1093E000180A0020F8000020F400002070B50446A0
+:1093F0000D46206C70B1216CE0680844E060616843
+:10940000E068884201D32068E0602846226CE16869
+:10941000F7F756F870BD2DE9F04104460F461546A2
+:109420004FF00008A66B206C40B9206860BB6068F4
+:1094300002F02CFA80460020606025E07DB93946B4
+:10944000226CA068F7F73CF8216CA0680844A06083
+:10945000D4E90110884217D32068A06014E039468F
+:10946000226CE068F7F72CF8216CE068401AE060A5
+:109470002168E068884203D2216C6068401AE0608D
+:10948000022D01D106B1761E701CA0634046BDE8D6
+:10949000F08110B50446206B01F056F9204601F02A
+:1094A00053F910BD0146084A126812680AB9012230
+:1094B00000E000220A600A6822B9034A1268D268F2
+:1094C000106800E0002070472401002030B54FF400
+:1094D000A043174800F007042CB1C01D20F007007E
+:1094E000134C041B1B1B0246124C22600024114D1E
+:1094F0006C60D018083820F007000F4C2060002462
+:109500000D4D2D686C600C4D2D682C601146441A71
+:109510004C60094C24680C60084D4C682C60084D68
+:109520004C682C604FF00044064D2C6030BD0000AC
+:10953000680A0020440100204C0100205401002052
+:10954000500100205801002000BFFFF71DFF064812
+:1095500000680128F9D94FF0805004490860BFF332
+:109560004F8FBFF36F8FF0E75C07002004ED00E042
+:109570002DE9F04106460D4617469846069C0DB962
+:10958000246000E02760E66325640121204601F0A5
+:1095900075FE84F850800020A064BDE8F0810000D2
+:1095A0002DE9F05F82460F4690469B460A9E0C9C32
+:1095B0004FEA8801A522206BF6F7C7FFA8F101004A
+:1095C000216B01EB800929F0070909F0070008B9B0
+:1095D000012000E0002028B940F22B321BA120A07E
+:1095E000F6F7C8FE002507E0795D04F13400415527
+:1095F000785D00B902E06D1C102DF5D300BF00218D
+:1096000043200155202E00D31F26E662E664002089
+:109610002065201D00F0F3FF04F1180000F0EFFFBB
+:109620002461C6F12000A06164620020606584F8B6
+:1096300058005A465146484600F00EFC20600B98F0
+:1096400008B10B980460BDE8F09F00002E2E5C4628
+:1096500072656552544F535C7461736B732E630073
+:109660004572726F723A25732C25640D0A00000052
+:1096700010B5002407E004EB84010F4A02EB8100DF
+:1096800000F0B0FF641C202CF5D30C4800F0AAFFBA
+:109690000B4800F0A7FF0B4800F0A4FF0A4800F0B9
+:1096A000A1FF0A4800F09EFF0448094908600448E9
+:1096B0000849086010BD00005C070020DC0900209C
+:1096C000F0090020040A0020180A00202C0A0020BB
+:1096D000EC000020F000002010B50146164800E024
+:1096E000006803688B42FBD30246436813448B42F5
+:1096F00004D143684C682344436001460A464B68E2
+:1097000013440468A34211D10C4C03682468A3429B
+:1097100008D04B680468646823444B6003681B6886
+:109720000B6005E0054B1B680B6001E003680B60F4
+:10973000884200D0016010BD440100204C0100208F
+:109740002DE9F04104460D4616461F464FF000082D
+:1097500065602461B5420CD8F01BA169884202D330
+:109760004FF0010811E0211D0948006800F04AFF90
+:109770000BE0BE4204D2BD4202D34FF0010804E028
+:10978000211D0448006800F03DFF4046BDE8F0811F
+:10979000280100202401002070B5054600F058FF84
+:1097A000A86B08B9012400E0002400F095FF2046D2
+:1097B00070BD70B5054600F04BFFA86BE96B8842A1
+:1097C00001D1012400E0002400F086FF204670BD96
+:1097D0002DE9F3410D460098846C00272CB940F622
+:1097E000CE121AA11EA0F6F7C5FDA06BE16B884250
+:1097F00001D2012000E0002028B940F6CF1213A1C9
+:1098000017A0F6F7B7FDA06BE16B88421BD294F965
+:1098100045602A4669462046FFF7FDFD0746701C55
+:1098200060B9606A08B9012000E0002050B904F175
+:10983000240002F097F828B1012703E0701C40B221
+:1098400084F8450000BF3846BDE8FC812E2E5C46FA
+:1098500072656552544F535C71756575652E630072
+:109860004572726F723A25732C25640D0A00000050
+:10987000F8B505460F4613480068C068C468201D47
+:1098800000F09CFEE069012818D1A06941192B461F
+:109890003A462046FFF754FF80B1002003462A468F
+:1098A00001460090204602F081F906462EB94FF499
+:1098B000027205A10AA0F6F75DFD00BF2046616AAD
+:1098C0008847F8BD240100202E2E5C467265655243
+:1098D000544F535C74696D6572732E630000000011
+:1098E0004572726F723A25732C25640D0A000000D0
+:1098F000F0B587B070E0039800280CDA04AE2EB9FA
+:1099000040F2E7223AA140A0F6F734FDD6E9002064
+:10991000B168904700BF039800285DDB059C606933
+:1099200008B9012000E0002010B9201D00F046FE1B
+:1099300002A800F0C7F8054603980A284AD2DFE8D3
+:1099400000F00905072C2E4506082D2F00BF00BF8B
+:1099500000BF00BF0498A269811803462A4620462A
+:10996000FFF7EEFEC0B12046616A8847E069012832
+:1099700012D1002000900498A169421800231946D2
+:10998000204602F013F907462FB940F2213218A100
+:109990001DA0F6F7EFFC00BF1DE000BF1BE000BFFD
+:1099A0000498A061A06908B1012000E0002028B956
+:1099B0004FF44E720EA114A0F6F7DCFCA069411919
+:1099C0002B462A462046FFF7BBFE04E0204600F067
+:1099D000BBFE00E000BF00BF00231A4603A90E48EB
+:1099E000006801F067FB002885D107B0F0BD0000DA
+:1099F0002E2E5C4672656552544F535C74696D65DA
+:109A000072732E63000000004572726F723A257304
+:109A10002C25640D0A0000002C010020F8B5054635
+:109A20000C4601F0E9F9684600F04CF8064600984B
+:109A300020BB44B9B54206D801F0EEFF31462846B6
+:109A4000FFF716FF1CE03CB10E480068006808B93B
+:109A5000012000E000200446A91B22460A480068B5
+:109A600000F044FF01F0D8FF50B94FF08050074993
+:109A70000860BFF34F8FBFF36F8F01E001F0CCFFA1
+:109A8000F8BD0000280100202C01002004ED00E0BA
+:109A90000A490968096809B9012100E0002121B1DA
+:109AA0004FF0FF31064A116006E004490968C968B1
+:109AB000C868034A4168116070470000EC0000204C
+:109AC0001801002070B5044601F02AFE054607483B
+:109AD0000068854204D200F00BF80120206001E00C
+:109AE0000020206001480560284670BD3401002038
+:109AF0002DE9F8432DE021480068C06805681F483B
+:109B00000068C068C468201D00F058FD2046616AE6
+:109B10008847E06901281CD1A0694619AE4207D9DF
+:109B200066602461211D1548006800F06BFD10E09F
+:109B3000002003462A4601460090204602F036F8EF
+:109B400007462FB940F292320DA113A0F6F712FC8E
+:109B500000BF0A480068006808B9012000E0002042
+:109B60000028C8D00548D0F800800F480068034995
+:109B700008600D48C0F80080BDE8F883240100208B
+:109B80002E2E5C4672656552544F535C74696D6548
+:109B900072732E63000000004572726F723A257373
+:109BA0002C25640D0A000000280100200C480068E4
+:109BB000401C08B9012000E0002028B940F20F1233
+:109BC00008A113A0F6F7D6FB00BF502080F3118840
+:109BD000BFF34F8FBFF36F8F00BF00BFFEE70000E2
+:109BE000380100202E2E5C4672656552544F535C3E
+:109BF000706F727461626C655C525644535C415282
+:109C00004D5F434D34465C706F72742E63000000EC
+:109C10004572726F723A25732C25640D0A0000009C
+:109C200008B500BF6846FFF73DFC04462046009992
+:109C3000FFF7F4FEFFF75CFEF4E770B5044600F0B2
+:109C400007FD94F945501AE0A06C38B10021204678
+:109C5000FFF7BEFD88B100F09DFF0EE0606A08B915
+:109C6000012000E0002038B904F1240001F07AFE60
+:109C700018B100F08FFF00E003E0681E45B2002D30
+:109C8000E2DC00BFFF2084F8450000F025FD00F075
+:109C9000DFFC94F9445010E0206908B9012000E08D
+:109CA000002048B904F1100001F05CFE08B100F09A
+:109CB00071FF681E45B200E001E0002DECDC00BF42
+:109CC000FF2084F8440000F007FD70BD08B5FEF7E2
+:109CD00037FC009005E00A21684600F067FEF9F7BE
+:109CE000E5FEF8E72DE9F04104464FF0000801F0E9
+:109CF00083F83E48006808B9FFF7E8FB3C48006875
+:109D0000204000285FD1A4B1083404F0070080B1DE
+:109D100004F00700C0F10800044404F0070008B98B
+:109D2000012000E0002020B9BF2232A13BA0F6F7BD
+:109D300021FB002C47D03D480068844243D83C4E6C
+:109D40003046056801E02E462D686868A04202D2C0
+:109D500028680028F7D125480068854233D030684C
+:109D600000F10808286830606868001B102813D9C3
+:109D70002F1907F0070008B9012000E0002020B9E2
+:109D8000EC221CA125A0F6F7F5FA6868001B7860A4
+:109D90006C603846FFF7A0FC244968680968081A17
+:109DA000224908600846006822490968884203D2AF
+:109DB0001E4800681F4908600D4968680968084323
+:109DC00068600020286001F027FE08F0070008B94D
+:109DD000012000E0002028B94FF4967205A10FA0E1
+:109DE000F6F7C8FA4046BDE8F08100004C010020BB
+:109DF000580100202E2E5C4672656552544F535C0C
+:109E0000706F727461626C655C4D656D4D616E67FB
+:109E10005C686561705F342E630000004572726F8C
+:109E2000723A25732C25640D0A00000050010020B1
+:109E300044010020540100200648006830B1054963
+:109E4000096801F15000096D491C01600148006872
+:109E500070470000E8000020001F4FF0807303608F
+:109E6000001F21F001030360001F054B036014383D
+:109E70000260001F6FF0020303602038704700008B
+:109E8000AD9B000808B5FEF75BFB0090ADE0002439
+:109E90006421684600F08AFD54480068322803DADD
+:109EA0000120534908600AE050480068332806DB67
+:109EB0004E480068642802DA00204D4908604D4889
+:109EC0000068012803D04C480068012802D1002016
+:109ED0004A49086049480068052804DA474800688C
+:109EE000401C4649086045480068052803DA0120FF
+:109EF0003F49086006E041480068052802D100207B
+:109F00003B490860002409E0F8F78AFC3C48D0EDA2
+:109F1000000A30EE200A80ED000A641C0A2CF3DBF4
+:109F2000374890ED000AF2EE040A80EE201A354818
+:109F300080ED001A9FED340A314880ED000A2D486B
+:109F40000068012804D12B480068401C294908609A
+:109F500029480068012804D127480068401C264988
+:109F60000860284890ED000ADFED280AB4EEE00A08
+:109F7000F1EE10FA04DB9FED250A80ED000A2FE0D8
+:109F8000204890ED000AF2EE040AB4EEE00AF1EE89
+:109F900010FA12DB90ED000AF2EE050AB4EEE00AC8
+:109FA000F1EE10FA09D213480068022805DA1148C8
+:109FB0000068401C0F49086012E0124890ED000A4A
+:109FC000F2EE040AB4EEE00AF1EE10FA08D2094803
+:109FD0000068022804DA08480068401C0649086046
+:109FE000F6F7D8FCFEF7F4FA00BF50E7D4010020E2
+:109FF000A002404220020020240200201C02002077
+:10A000002000002018000020000000009A9949411B
+:10A0100000B52DED048B83B041EC190B02F040FA32
+:10A0200041EC180B18EE100A18EE901A8DED008B0B
+:10A03000002818BF0120084320F00040C0F17F60D5
+:10A0400000F1E040C00F14D019EE101A19EE900A7A
+:10A050008DED009B002918BF0121084320F000402E
+:10A06000C0F17F6000F1E040C00F04BF0120F6F7AF
+:10A070009FFA51EC180B03B0BDEC048B00BD00003F
+:10A080001CB5044600F0E4FA002004210346CA018E
+:10A09000CDE900101FA1234801F002FB002003219D
+:10A0A00003464FF48072CDE900101FA1224801F051
+:10A0B000F7FA0020032103464FF40072CDE90010A7
+:10A0C0001EA1214801F0ECFA002003210346802262
+:10A0D000CDE900101DA1204801F0E2FA0020042182
+:10A0E00003468A01CDE900101CA11F4801F0D8FAEF
+:10A0F000002004210346CA01CDE900101BA11E481F
+:10A1000001F0CEFA1D48006800F0BEFC00F0E4FA51
+:10A110001CBD000042616C616E63655F7461736BAE
+:10A1200000000000E10B00084D5055363035305F1F
+:10A130007461736B000000009531000873686F77DD
+:10A140005F7461736B000000859E00086C65645F3E
+:10A150007461736B000000005D8500085053545714
+:10A160004F5F7461736B0000CD9C00084441544103
+:10A170005F7461736B000000AD7E0008000000207A
+:10A1800008B54FF44070F9F783F9A820FEF74AF9B3
+:10A19000F8F7F6FEF6F7B0FEF7F712FEF9F7CEF98C
+:10A1A000F8F7BAFE4FF4E13000F06AF84FF41650B9
+:10A1B00000F0BEF84FF4E13000F012F94FF4E13056
+:10A1C00000F066F9F6F788FCF6F7C8FC00200323D8
+:10A1D0000622072100900120F6F7AAFEFAF760F99F
+:10A1E000F7F706FEF7F778FEF7F7D4FEF7F730FF3C
+:10A1F000532142F20F70FAF75BFDA72142F20F7074
+:10A20000FBF74AF8002144F29F10FAF7B7FD00214E
+:10A2100044F29F10FBF7F2F8002144F29F10FAF786
+:10A22000A3FC002144F29F10FAF7EEFCF8F770FB54
+:10A23000F8F758FFF9F70EFCF9F714FD08BDF0EE3A
+:10A24000401AF4EEE01AF1EE10FA02D2B0EE600A13
+:10A250007047F4EEC11AF1EE10FA02DDB0EE410AD9
+:10A26000F6E7B0EE610AF3E703468B4201DA0846EF
+:10A270007047934201DD1046FAE71846F8E7000000
+:10A2800010B588B0044601210846F9F77DFE01218A
+:10A290001020F9F799FE072209212348F7F77EFFDE
+:10A2A00007220A212048F7F779FF4FF4C060069093
+:10A2B00002208DF81C0000208DF81E0002208DF871
+:10A2C0001D0001208DF81F0006A91748F7F71EFF93
+:10A2D00025208DF8040001208DF8050000208DF860
+:10A2E000060001208DF8070001A8F9F795F80294FF
+:10A2F0000020ADF80C00ADF80E00ADF81000ADF880
+:10A3000014000C20ADF8120002A90848FBF786FFE4
+:10A31000012240F225510548FBF75AFF012103486D
+:10A32000FBF720FF08B010BD000002400010014004
+:10A3300010B588B0044601210820F9F725FE012157
+:10A340004804F9F731FE072205212348F7F726FFD5
+:10A35000072206212048F7F721FF602006900220FF
+:10A360008DF81C0000208DF81E0002208DF81D00C5
+:10A3700001208DF81F0006A91748F7F7C7FE262011
+:10A380008DF8040001208DF8050000208DF80600EE
+:10A3900001208DF8070001A8F9F73EF8029400208B
+:10A3A000ADF80C00ADF80E00ADF81000ADF81400DB
+:10A3B0000C20ADF8120002A90848FBF72FFF01227C
+:10A3C00040F225510548FBF703FF01210348FBF745
+:10A3D000C9FE08B010BD0000000C0240004400405F
+:10A3E00010B588B0044601210820F9F7CDFD012100
+:10A3F0008804F9F7D9FD072208212348F7F7CEFE94
+:10A40000072209212048F7F7C9FE4FF44070069053
+:10A4100002208DF81C0000208DF81E0002208DF80F
+:10A420001D0001208DF81F0006A91748F7F76EFEE2
+:10A4300027208DF8040002208DF8050000208DF8FB
+:10A44000060001208DF8070001A8F8F7E5FF029447
+:10A450000020ADF80C00ADF80E00ADF81000ADF81E
+:10A4600014000C20ADF8120002A90848FBF7D6FE34
+:10A47000012240F225510548FBF7AAFE01210348BD
+:10A48000FBF770FE08B010BD000C02400048004011
+:10A4900010B588B0044601210420F9F775FD0121AB
+:10A4A0000820F9F771FD01210805F9F77DFD082263
+:10A4B0000C212C48F7F772FE082202212A48F7F7F0
+:10A4C0006DFE4FF48050069002208DF81C00002095
+:10A4D0008DF81E0002208DF81D0001208DF81F0050
+:10A4E00006A92048F7F712FE0420069002208DF8F6
+:10A4F0001C0000208DF81E0002208DF81D00012098
+:10A500008DF81F0006A91848F7F700FE35208DF8D2
+:10A51000040002208DF8050000208DF806000120BF
+:10A520008DF8070001A8F8F777FF02940020ADF836
+:10A530000C00ADF80E00ADF81000ADF814000C20C2
+:10A54000ADF8120002A90948FBF768FE012240F2AB
+:10A5500025510648FBF73CFE01210448FBF702FEAB
+:10A5600008B010BD00080240000C0240005000403E
+:10A570000449888000BF0349098801F0400100298F
+:10A58000F9D07047001001400549088000BF044918
+:10A59000091F098801F040010029F8D07047000028
+:10A5A000044800400449888000BF0349098801F03D
+:10A5B00040010029F9D070470050004001460A6967
+:10A5C000D1E901309860D1E90103586050688842B0
+:10A5D00001D188685060002008611068401E10603A
+:10A5E0001068704700F1080141604FF0FF31816051
+:10A5F00000F10801C1600161002101607047002184
+:10A600000161704710B502460B685C1C0CB91069FB
+:10A6100007E002F1080000E04068446824689C42BA
+:10A62000FAD944684C604C68A160886041600A6156
+:10A630001468641C146010BD42684A6093688B60A3
+:10A64000936859609160086103685B1C0360704700
+:10A6500010B500BF502080F31188BFF34F8FBFF3B8
+:10A660006F8F00BF0B480068401C0A49086008460D
+:10A67000006801280DD108480068C0B208B901205F
+:10A6800000E0002028B940F2B91204A10EA0F5F7AD
+:10A6900071FE10BD3801002004ED00E02E2E5C4656
+:10A6A00072656552544F535C706F727461626C6571
+:10A6B0005C525644535C41524D5F434D34465C708E
+:10A6C0006F72742E630000004572726F723A2573C8
+:10A6D0002C25640D0A00000010B50B48006828B94D
+:10A6E0004FF4E07209A114A0F5F744FE0648006893
+:10A6F000401E054908600846006820B9002080F324
+:10A70000118800BF00BF10BD380100202E2E5C460E
+:10A7100072656552544F535C706F727461626C6500
+:10A720005C525644535C41524D5F434D34465C701D
+:10A730006F72742E630000004572726F723A257357
+:10A740002C25640D0A00000070B506463546002E23
+:10A7500035D0083D2C461A4960680968084008B1A0
+:10A76000012000E0002028B94FF4A07215A11FA01D
+:10A77000F5F700FE206808B9012000E0002028B9A4
+:10A7800040F241120FA119A0F5F7F4FD0C496068E1
+:10A790000968084098B1206888B909496068096863
+:10A7A0008843606000F028FB144960680968084429
+:10A7B000124908602046FEF78FFF01F02DF970BDA9
+:10A7C000580100202E2E5C4672656552544F535C32
+:10A7D000706F727461626C655C4D656D4D616E6722
+:10A7E0005C686561705F342E630000004572726FB3
+:10A7F000723A25732C25640D0A00000050010020D8
+:10A80000064800684FF47A71B0FBF1F0401E4FF03B
+:10A81000E021486107200861704700000400002023
+:10A8200070B5F5F781FD0546102D11D305F1E02037
+:10A8300090F8F04310480078844201DB012000E0EA
+:10A84000002028B94FF440720CA117A0F5F792FD33
+:10A850001948006800F4E06018490968884201D886
+:10A86000012000E0002028B94FF4447203A10EA09B
+:10A87000F5F780FD70BD00003C0100202E2E5C46E7
+:10A8800072656552544F535C706F727461626C658F
+:10A890005C525644535C41524D5F434D34465C70AC
+:10A8A0006F72742E630000004572726F723A2573E6
+:10A8B0002C25640D0A0000000CED00E04001002092
+:10A8C000024600200BE0084B53F8303033B9064BFA
+:10A8D00043F8301003EBC0035A6002E0401C082824
+:10A8E000F1D300BF704700001C0700202DE9F041A4
+:10A8F00005460E4617462C46FFF7AAFE94F944007B
+:10A90000401C10B9002084F8440094F94500401C14
+:10A9100010B9002084F84500FFF7DEFEA06B28B9CF
+:10A920003A46314604F1240000F064F92046FFF76E
+:10A9300084F9BDE8F081000070B504460025ACB193
+:10A940000F48006808B9012000E0002028B940F253
+:10A95000CF420CA110A0F5F70DFD00F04DFA00213B
+:10A960002046FEF737FC01F057F805463DB94FF099
+:10A9700080500D490860BFF34F8FBFF36F8F70BDDC
+:10A98000200100202E2E5C4672656552544F535CA8
+:10A990007461736B732E63004572726F723A257324
+:10A9A0002C25640D0A00000004ED00E02DE9F047BD
+:10A9B00004460F464FF000092CB940F2794226A117
+:10A9C0002AA0F5F7D7FC0FB1012000E0002028B93C
+:10A9D00040F27A4220A125A0F5F7CCFC2748006878
+:10A9E00008B9012000E0002028B940F27B421AA1FA
+:10A9F0001EA0F5F7BFFC00F0FFF9214806682068AB
+:10AA0000C5192068B04207D92068A8420BD9B542C1
+:10AA100009D94FF0010906E02068A84201D8B542E3
+:10AA200001D94FF001092560B9F1000F03D0A81B2F
+:10AA30000021FEF7CFFB00F0EFFF8046B8F1000FDA
+:10AA400007D14FF080500F490860BFF34F8FBFF31D
+:10AA50006F8FBDE8F08700002E2E5C467265655250
+:10AA6000544F535C7461736B732E63004572726F45
+:10AA7000723A25732C25640D0A0000002001002085
+:10AA8000FC00002004ED00E070B50546FFF7E0FD96
+:10AA900015B92D48006800E028460446201DFFF740
+:10AAA0008DFD78B9E06A00EB8000284951F820005C
+:10AAB00040B994F82C100120884025490968814349
+:10AAC00023480160A06A18B104F11800FFF776FD71
+:10AAD00020480068401C1F4908601B4800688442E9
+:10AAE00009D1211D1C48FFF7A7FD1C480068401C28
+:10AAF0001A49086009E01A480068401E18490860B1
+:10AB00002046FEF7C6FCFEF7C3FFFFF7E5FD15483C
+:10AB10000068C0B10C480068844214D11248006833
+:10AB200008B9012000E0002028B940F265420FA1D9
+:10AB300013A0F5F71FFC4FF0805015490860BFF3D4
+:10AB40004F8FBFF36F8F70BDE80000205C070020BF
+:10AB50000001002014010020180A0020F400002049
+:10AB6000F800002004010020200100202E2E5C4669
+:10AB700072656552544F535C7461736B732E63003E
+:10AB80004572726F723A25732C25640D0A0000001D
+:10AB900004ED00E001200149086070470C0100202D
+:10ABA00070B504460D462CB940F6063207A10CA03C
+:10ABB000F5F7E0FB0E48016818312046FFF722FD4B
+:10ABC00001212846FEF706FB70BD00002E2E5C46D4
+:10ABD00072656552544F535C7461736B732E6300DE
+:10ABE0004572726F723A25732C25640D0A000000BD
+:10ABF000E800002070B505460E4614462DB940F613
+:10AC0000313209A10DA0F5F7B5FB104801681831E4
+:10AC10002846FFF711FD0CB14FF0FF3621463046B4
+:10AC2000FEF7D8FA70BD00002E2E5C4672656552A4
+:10AC3000544F535C7461736B732E63004572726F73
+:10AC4000723A25732C25640D0A000000E8000020EC
+:10AC500070B505462C46002D4BD02649E06A0968A0
+:10AC6000C96A884245D2A06900F0004028B921484D
+:10AC70000068C06AC0F12000A061E16A01EB8101B7
+:10AC80001D4A02EB81016069884201D1012000E088
+:10AC9000002050B3201DFFF791FC78B9E06A00EB6B
+:10ACA0008000154951F8200040B994F82C1001207B
+:10ACB0008840124909688143104801600D480068C6
+:10ACC000C06AE06294F82C10012088400B490968A2
+:10ACD00008430A490860E16A01EB8101064A02EB78
+:10ACE0008100211DFFF7A8FC03E002480068C06A4C
+:10ACF000E06270BDE80000205C0700200001002039
+:10AD000010B504462CB940F6C13205A109A0F5F7EB
+:10AD100031FB0C48006820600B480068606010BD83
+:10AD20002E2E5C4672656552544F535C7461736B92
+:10AD3000732E63004572726F723A25732C25640D71
+:10AD40000A00000010010020FC0000201CB51A4879
+:10AD500000210B468222CDE9001018A1194800F00D
+:10AD60009FFC0446012C02D100F0E6FE0446012CB3
+:10AD700015D100BF502080F31188BFF34F8FBFF370
+:10AD80006F8F00BF4FF0FF300F49086001200F495F
+:10AD9000086000200E49086000F08AF80BE0601C93
+:10ADA00008B1012000E0002028B940F2847209A116
+:10ADB0000DA0F5F7DFFA1CBD1C01002049444C45ED
+:10ADC000000000004995000818010020040100203F
+:10ADD000FC0000202E2E5C4672656552544F535C79
+:10ADE0007461736B732E63004572726F723A2573D0
+:10ADF0002C25640D0A00000002480068401C01492F
+:10AE0000086070472001002010B51B48006818B189
+:10AE100001201A4908602DE00020184908601848F0
+:10AE20000068B0FA80F0C0F11F0404EB84001549FB
+:10AE300051F8200008B1012000E0002028B940F6B8
+:10AE4000F62211A115A0F5F795FA04EB84010D4A3D
+:10AE500002EB810041684968416000F108014268E5
+:10AE60008A4202D14168496841604168C9680F4A15
+:10AE7000116000BF10BD0000200100200C01002067
+:10AE8000000100205C0700202E2E5C467265655292
+:10AE9000544F535C7461736B732E63004572726F11
+:10AEA000723A25732C25640D0A000000E80000208A
+:10AEB0001CB5404800684049884201D0012000E0AC
+:10AEC000002028B940F259123CA147A0F5F752FAE8
+:10AED000384800683849491E884201D0012000E006
+:10AEE000002028B94FF4AD7234A13FA0F5F742FA23
+:10AEF000414C204600780190FF202146087008460A
+:10AF0000007800909DF8000000F0F0009DF800101F
+:10AF1000884201D1012000E0002028B940F27312DC
+:10AF200026A131A0F5F726FA9DF8000000F05000A8
+:10AF30003249087007203249086009E0304800684B
+:10AF4000401E2F4908609DF800004006000E00904A
+:10AF50009DF8000000F080008028EFD028480068AD
+:10AF60000002274908600846008800F4E060086095
+:10AF70002149019808700F482030006840F47000A3
+:10AF80000C49203108600846006840F070400860B5
+:10AF9000FFF736FC00201B490860F5F78DF91A48C9
+:10AFA000006840F0404018490860F5F775F9002046
+:10AFB0001CBD000000ED00E071C20F412E2E5C466A
+:10AFC00072656552544F535C706F727461626C6548
+:10AFD0005C525644535C41524D5F434D34465C7065
+:10AFE0006F72742E630000004572726F723A25739F
+:10AFF0002C25640D0A00000000E400E03C01002064
+:10B00000400100203801002034EF00E010B500BFFF
+:10B01000502080F31188BFF34F8FBFF36F8F00BFB5
+:10B0200000F084FB18B14FF080500449086000BF65
+:10B03000002080F3118800BF10BD000004ED00E087
+:10B040002DE9F84305460E4690460DB1012000E07B
+:10B05000002028B94FF4C4720DA112A0F5F78AF9A7
+:10B060000EB9002701E005FB06F707F15400FEF7D3
+:10B0700039FE044644B104F1540943464A46314678
+:10B0800028460094FEF774FA2046BDE8F8830000D5
+:10B090002E2E5C4672656552544F535C7175657512
+:10B0A000652E63004572726F723A25732C25640D0C
+:10B0B0000A0000002DE9FF4782B005460E461F46F4
+:10B0C0004FF0000A2C462CB940F2DC4261A166A088
+:10B0D000F5F750F90EB9206C08B9012000E0002006
+:10B0E00028B940F2DD425BA15FA0F5F743F900F01B
+:10B0F00007FB08B9049808B9012000E0002028B92E
+:10B100004FF49C6253A158A0F5F734F900BFFFF744
+:10B110009FFAD4F83890B9F1000F3DD0D4F80C80E4
+:10B1200031462046FEF762F9DFB9A9F10100A063BC
+:10B13000206810B9FEF780FE6060206908B9012020
+:10B1400000E0002010BB04F1100000F00BFCE8B19F
+:10B150004FF0805048490860BFF34F8FBFF36F8FA7
+:10B1600014E0C4F80C80606A08B9012000E00020F7
+:10B1700060B904F1240000F0F5FB38B14FF08050C5
+:10B180003D490860BFF34F8FBFF36F8FFFF7A4FAFD
+:10B19000012006B0BDE8F087049818B9FFF79CFAC3
+:10B1A0000020F6E7BAF1000F04D16846FFF7A8FDCA
+:10B1B0004FF0010AFFF790FAFFF71EFEFFF748FA7B
+:10B1C00094F94400401C10B9002084F8440094F91C
+:10B1D0004500401C10B9002084F84500FFF77CFAB8
+:10B1E00004A9684600F00CFA40BB2046FEF7D4FAEA
+:10B1F000F0B1206830B9FFF72BFA6068FFF728FD3F
+:10B20000FFF76AFA04F124000499FFF7C9FC20460D
+:10B21000FEF713FD00F000FC00287FF478AF4FF03C
+:10B22000805015490860BFF34F8FBFF36F8F6EE7F3
+:10B230002046FEF702FD00F0EFFB68E72046FEF730
+:10B24000FCFC00F0E9FB2046FEF7A6FA0028EED051
+:10B2500000209EE72E2E5C4672656552544F535C6B
+:10B2600071756575652E63004572726F723A25734C
+:10B270002C25640D0A00000004ED00E070B50546C1
+:10B280000E462C462CB940F21B121EA122A0F5F747
+:10B2900071F8FFF7DDF9D4E90F12206801FB020015
+:10B2A00060600020A0632068A060E06B401E226CFC
+:10B2B000216800FB0210E060FF2084F8440084F85D
+:10B2C00045009EB9206908B9012000E00020A8B916
+:10B2D00004F1100000F046FB80B14FF0805012499D
+:10B2E0000860BFF34F8FBFF36F8F07E004F11000CA
+:10B2F000FFF778F904F12400FFF774F9FFF7ECF990
+:10B30000012070BD2E2E5C4672656552544F535C11
+:10B3100071756575652E63004572726F723A25739B
+:10B320002C25640D0A00000004ED00E02DE9FF4328
+:10B3300083B0064688461D464FF0000934462CB9B6
+:10B3400040F2D92260A165A0F5F714F8B8F1000F1A
+:10B3500001D1206C08B9012000E0002028B940F29A
+:10B36000DA2259A15DA0F5F705F8022D02D1E06BB4
+:10B37000012801D1012000E0002028B940F2DB22A1
+:10B3800051A156A0F4F7F6FF00F0BAF908B90598F4
+:10B3900008B9012000E0002028B940F2DE224AA1CD
+:10B3A0004EA0F4F7E7FF00BFFFF752F9A06BE16B87
+:10B3B000884201D3022D38D12A4641462046FEF765
+:10B3C0002AF80746A06C68B129462046FEF700FA25
+:10B3D00028B34FF0805045490860BFF34F8FBFF34B
+:10B3E0006F8F1CE0606A08B9012000E0002068B996
+:10B3F00004F1240000F0B6FA88B14FF080503B49C8
+:10B400000860BFF34F8FBFF36F8F08E03FB14FF07D
+:10B41000805036490860BFF34F8FBFF36F8FFFF73F
+:10B420005BF9012007B0BDE8F083059818B9FFF774
+:10B4300053F90020F6E7B9F1000F04D101A8FFF796
+:10B440005FFC4FF00109FFF747F9FFF7D5FCFFF765
+:10B45000FFF894F94400401C10B9002084F844001F
+:10B4600094F94500401C10B9002084F84500FFF70E
+:10B4700033F905A901A800F0C3F8F0B92046FEF79A
+:10B4800098F9A0B104F110000599FFF789FB204657
+:10B49000FEF7D3FB00F0C0FA002885D14FF08050B2
+:10B4A00012490860BFF34F8FBFF36F8F7CE72046D0
+:10B4B000FEF7C3FB00F0B0FA76E72046FEF7BDFBCF
+:10B4C00000F0AAFA0020ADE72E2E5C4672656552A8
+:10B4D000544F535C71756575652E63004572726FCC
+:10B4E000723A25732C25640D0A00000004ED00E07B
+:10B4F0002DE9F05F80468A4615461E4644462CB923
+:10B5000040F29F3235A13AA0F4F734FFBAF1000FB0
+:10B5100001D1206C08B9012000E0002028B94FF4C7
+:10B5200068722EA132A0F4F725FF022E02D1E06B43
+:10B53000012801D1012000E0002028B940F2A13209
+:10B5400026A12BA0F4F716FFFFF76AF900BF5021E0
+:10B55000EFF3118081F31188BFF34F8FBFF36F8F2B
+:10B5600000BF0746A06BE16B884201D3022E2BD1AE
+:10B5700094F945B0324651462046FDF74CFF0BF199
+:10B580000100C8B9A06C40B131462046FEF720F951
+:10B59000B8B1B5B10120286013E0606A08B9012094
+:10B5A00000E0002068B904F1240000F0DBF940B1AC
+:10B5B0003DB10120286004E00BF1010040B284F8A5
+:10B5C00045004FF0010901E04FF0000900BF87F38B
+:10B5D000118800BF4846BDE8F09F00002E2E5C4653
+:10B5E00072656552544F535C71756575652E6300C5
+:10B5F0004572726F723A25732C25640D0A000000A3
+:10B600002DE9F04104460D462CB940F6CB3219A184
+:10B610001DA0F4F7AFFE2DB940F6CC3215A11AA04B
+:10B62000F4F7A8FEFFF714F81B4807682868401CC9
+:10B6300008B9002619E0194920680968884204D031
+:10B640006068B84201D801260FE06068381A29689E
+:10B65000884209D228686168791A401A2860204611
+:10B66000FFF74EFB002600E00126FFF735F83046D5
+:10B67000BDE8F0812E2E5C4672656552544F535CD6
+:10B680007461736B732E63004572726F723A257327
+:10B690002C25640D0A000000FC0000201001002091
+:10B6A0002DE9FF4F85B0804689461746DDE912AB8C
+:10B6B000B800FEF717FB064656B15C20FEF712FBFA
+:10B6C00004460CB1266304E03046FFF73DF800E085
+:10B6D00000247CB10020CDE900ABCDE902403A4620
+:10B6E00049464046089BFDF75BFF2046FDF7BEFD3F
+:10B6F000012501E04FF0FF35284609B0BDE8F08F85
+:10B700000549096809B9012005E00449096809B932
+:10B71000022000E0002070470401002020010020EA
+:10B720000149086870470000FC0000202DE9F04145
+:10B730004FF0000841480068002872D14048006876
+:10B74000451C3F480560EDB93E480068006808B9EF
+:10B75000012000E0002028B940F6D9123AA13FA00C
+:10B76000F4F708FE37480768404800683549086024
+:10B770003E4807603E480068401C3D490860FEF7AF
+:10B7800087F900BF3B48006885423CD300BF2D4885
+:10B790000068006808B9012000E0002020B14FF0E7
+:10B7A000FF30344908602DE026480068C068C4684E
+:10B7B0006668B54202D22F48066023E0201DFEF7DE
+:10B7C000FDFEA06A18B104F11800FEF7F7FE94F828
+:10B7D0002C10012088402849096808432649086040
+:10B7E000E16A01EB8101254A02EB8100211DFEF790
+:10B7F00023FF2349E06A0968C96A8842C7D34FF02A
+:10B800000108C4E700BF1E480068C06A00EB800062
+:10B810001A4951F82000012801D94FF0010805E02C
+:10B82000FFE718480068401C164908601648006881
+:10B8300008B14FF001084046BDE8F081200100202A
+:10B84000FC000020EC0000202E2E5C467265655244
+:10B85000544F535C7461736B732E63004572726F47
+:10B86000723A25732C25640D0A000000F0000020B8
+:10B870001001002018010020000100205C070020BA
+:10B88000E8000020080100200C01002070B50546EA
+:10B890002C460026002D4BD026480068844201D15A
+:10B8A000012000E0002028B940F6C76222A127A0AD
+:10B8B000F4F760FD206D28B940F6C9621EA123A0EF
+:10B8C000F4F758FD206D401E2065E16CE06A884267
+:10B8D0002ED0206D60BB201DFEF770FE78B9E06AA7
+:10B8E00000EB80001D4951F8200040B994F82C105D
+:10B8F000012088401A490968814319480160E06CB9
+:10B90000E062E06AC0F12000A06194F82C100120F0
+:10B91000884013490968084311490860E16A01EB4E
+:10B9200081010E4A02EB8100211DFEF785FE0126F2
+:10B93000304670BDE80000202E2E5C4672656552D0
+:10B94000544F535C7461736B732E63004572726F56
+:10B95000723A25732C25640D0A0000005C07002054
+:10B960000001002070B50646F068C4682CB940F6A6
+:10B9700061321AA11EA0F4F7FDFC04F11800FEF7D5
+:10B980001DFE1F480068A8B9201DFEF717FE94F899
+:10B990002C10012088401B49096808431949086098
+:10B9A000E16A01EB8101184A02EB8100211DFEF7DB
+:10B9B00043FE04E004F118011448FEF73DFE14496B
+:10B9C000E06A0968C96A884204D901250120114941
+:10B9D000086000E00025284670BD00002E2E5C4661
+:10B9E00072656552544F535C7461736B732E6300C0
+:10B9F0004572726F723A25732C25640D0A0000009F
+:10BA000020010020000100205C070020040A002023
+:10BA1000E80000200C01002070B500240026344806
+:10BA2000006828B94FF4FD6232A137A0F4F7A2FCF8
+:10BA3000FEF70EFE2E480068401E2D49086008469D
+:10BA4000006800284FD13448006800284BD024E01B
+:10BA50003248C068C46804F11800FEF7AFFD201D2D
+:10BA6000FEF7ACFD94F82C10012088402C490968A1
+:10BA700008432B490860E16A01EB8101294A02EB86
+:10BA80008100211DFEF7D8FD2749E06A0968C96ACF
+:10BA9000884202D30120254908602048006808B97F
+:10BAA000012000E000200028D2D00CB1FDF7F0FF0B
+:10BAB0001F48056865B100BFFFF738FE10B10120CF
+:10BAC0001A4908606D1E002DF6D100201849086043
+:10BAD0001648006838B10126300716490860BFF3E0
+:10BAE0004F8FBFF36F8FFEF7F7FD304670BD00003C
+:10BAF000200100202E2E5C4672656552544F535C27
+:10BB00007461736B732E63004572726F723A2573A2
+:10BB10002C25640D0A000000F8000020040A002013
+:10BB2000000100205C070020E80000200C0100203C
+:10BB30000801002004ED00E01CB50024FDF7F2FB35
+:10BB40000B48006858B10B481F2100234FF4827244
+:10BB5000CDE9001008A10A48FFF7A2FD04462CB960
+:10BB600040F2331207A10DA0F4F704FC20461CBDDF
+:10BB70002C01002030010020546D722053766300A8
+:10BB8000219C00082E2E5C4672656552544F535C12
+:10BB900074696D6572732E63000000004572726FE8
+:10BBA000723A25732C25640D0A0000002DE9FF4729
+:10BBB00004460D4616461F46DDF830804FF000095A
+:10BBC0002CB94FF4D37217A11CA0F4F7D3FB1F4874
+:10BBD000006810B3009501960294062D15DAFFF760
+:10BBE0008FFD022808D100234246694617480068A5
+:10BBF000FFF79CFB814610E000231A466946134874
+:10BC00000068FFF793FB814607E000233A46694648
+:10BC10000E480068FFF76CFC8146484604B0BDE85A
+:10BC2000F08700002E2E5C4672656552544F535CBF
+:10BC300074696D6572732E63000000004572726F47
+:10BC4000723A25732C25640D0A0000002C01002097
+:10BC500081F00041704780F00040704721F00041C2
+:10BC6000704720F00040704721F00042A2F160527E
+:10BC7000B2F5801F01F0004328BFD2F17F6C0BD9D1
+:10BC80005FEA001C43EAC20242EB507018BF7047E3
+:10BC900028BF20F001007047B2F5801FBCBF1846D6
+:10BCA00070474FEA410C1CF5001F02D2084600F015
+:10BCB00023BE70B500F05EFB00000089FFF7F6BF01
+:10BCC0004FF00040A0F580007047000010B591EAE9
+:10BCD000030F48BF83F0004300F1B684841A71EB70
+:10BCE000030C05D2121943EB0C03001B61EB0C0192
+:10BCF000DFF824E14FEA1154A4EB135C1EEA430F72
+:10BD000018BF9EEA445F73D023EA0E03DCF1200ED5
+:10BD100021EA045143F4801332D322FA0CFE10EBD3
+:10BD20000E0023FA0CFE41EB0E01CCF1200E03FABB
+:10BD30000EFE10EB0E0051F10001B1F5801FCCF1A9
+:10BD4000200E32D201EB045112FA0EF2BDE810407F
+:10BD500058BF7047401C38BF5FEA420218BF7047A7
+:10BD6000002814BF20F0010041F100014FEA410317
+:10BD700013F5001F38BF7047A1F1C04100F048BB68
+:10BD8000012A43EB0302ACF1200CDCF11F0E32BFA1
+:10BD90004FF0000E23FA0CF310EB030041EB0451BB
+:10BDA000B4EB115FD0D0A1EB045101F5801149082B
+:10BDB0005FEA300001EB04510ED350F1000038BFB0
+:10BDC00012FA0EFE08D1BDE81040C9E7401C38BF8A
+:10BDD0005FEA4202CAD1C3E7BDE810404FEA41031F
+:10BDE00013F5001F38BF7047A1F1C04100F010BB30
+:10BDF0009EEA445F08D011EA5E0FBDE8104004BF20
+:10BE000001F0004100207047BDE8104070B500F01F
+:10BE1000B1FA00BF64FBBE3E0000E0FF02494FF0F4
+:10BE2000000000F06EBD00BF0000F87F491058BF51
+:10BE3000C1F140415B1058BFC3F140438B42EFF367
+:10BE4000008070472DE9C04130B4DFF8A0C23CEA61
+:10BE5000111418BF3CEA131400F0EC8081EA0305CA
+:10BE60001CEA111444EAD57418BF1CEA131500F03B
+:10BE7000C780A4EB05044FF0004545EAC12145EA1F
+:10BE8000C32341EA505143EA525304F17F7499426B
+:10BE900004F500344FEAC0204FEAC22208BF9042A6
+:10BEA00000F09C804FEA13650FF24016765D4FEA72
+:10BEB000134506FB05F7C7F1807706FB07F74FEA46
+:10BEC000D737A7FB03687642C8F58038A7FB06CEB4
+:10BED00038BFA8F1010807FB08E64FF0000EA6FBEB
+:10BEE000028CE6FB03CEDCF1000CCEF1004E38BF35
+:10BEF000AEF1010EA6FB0C584FF000074FF0000505
+:10BF0000E6FB0E87A1FB08C6A0FB07CE16EB0E06CC
+:10BF100045F10005E1FB076515F1E04E7EBFA4F594
+:10BF200080345FEA46066D4116F1800745F1000551
+:10BF30004FEA17274FEA066647EA0567A6F1DE468D
+:10BF4000B6F1805F4FEA15251FD9384624F0010C61
+:10BF500005EBC471BCF1FE6F01EB0C1102D8F0BC13
+:10BF6000BDE8008124425CBF01F5801E9EEAC47FCB
+:10BF700002D4F0BCBDE80081244238D4F0BCA1F169
+:10BF8000C041BDE8004100F043BA4FEAD22242EA84
+:10BF900043524FEAD323A7FB02864FEAD02040EA60
+:10BFA000415007FB03661EEA0E0F4FEAD12105FB45
+:10BFB000026658BFA6EB0056B6EB00564FEA520E8B
+:10BFC0004EEAC37E18EB0E0E56EB530EBDD518EBA2
+:10BFD00002085E417F1C55F10005B6E74FF480155D
+:10BFE0004FF000074FF000064FF00008ADE7F0BC3F
+:10BFF0004FF0000001F1C04101F00041BDE80081B7
+:10C0000011EA0C1F0CEA131500D00CE013EA0C1F08
+:10C0100000F025804FF00000F0BC81EA030101F040
+:10C020000041BDE80081F0BCBDE8004181EA0301A8
+:10C0300000F0EEB9F0BCBDE8004170B500F09AF92F
+:10C04000097EFC3E00F007B881EA03014FF00000D2
+:10C0500001F00041704781EA030100F0D9B9F0BC5A
+:10C06000BDE800414FF0000021497047FFFDFBF99A
+:10C07000F7F5F4F2F0EEEDEBE9E8E6E4E3E1E0DE1B
+:10C08000DDDBDAD8D7D5D4D3D1D0CFCDCCCBCAC88D
+:10C09000C7C6C5C4C2C1C0BFBEBDBCBBBAB9B8B7B4
+:10C0A000B6B5B4B3B2B1B0AFAEADACABAAA9A8A8A7
+:10C0B000A7A6A5A4A3A3A2A1A09F9F9E9D9C9C9B75
+:10C0C0009A99999897979695959493939291919020
+:10C0D0008F8F8E8E8D8C8C8B8B8A898988888787B1
+:10C0E0008685858484838382828181800000FF0726
+:10C0F0000000F87F4FEA41034FEA5353A3F58063F2
+:10C10000D3F11E03C8BFD3F1210C0CDD4FF0004268
+:10C1100042EAC12242EA505232FA03FC8CEAE17C44
+:10C12000ACEBE1707047102BC4BF0020704703F5E3
+:10C13000787CBCF1FF3F04D06FF0004282EA21001E
+:10C14000704770B500F016F94992248000207047BE
+:10C15000F2E710F0004248BF4042B0FA80F310FA14
+:10C1600003F10AD0C3F11D0303F580634FEA415088
+:10C1700002EB035202EBD12170474FF000007047F1
+:10C18000B0FA80F310FA03F10AD0C3F11D0303F5EE
+:10C1900080634FEA41504FEA035202EBD1217047CE
+:10C1A0004FF000007047000051EA030C17D41CF553
+:10C1B000801F58BFBCF5801F00F10680994218BF50
+:10C1C000704708BF9042704707D711F5801F58BFCE
+:10C1D00013F5801F19D499427047894270471CF5A6
+:10C1E000801F08D5BCF5801FF7D58B4218BF70475C
+:10C1F00008BF824270474FF4001C1CEB410F38BF50
+:10C200001CEB430F01D28B42704770B500F0B2F8BF
+:10C21000922449004FF000514FF08053FFF706BEC3
+:10C22000DFF848C170B51CEA111E1EBF1CEA1315C9
+:10C230009EEA0C0F95EA0C0F00F06F8081EA030470
+:10C2400023EA4C134EEAD47E21EA4C1141F48011CA
+:10C2500043F48013AE44A1FB024CA0FB0365AEF196
+:10C260007F7E361955EB0C05A1FB034C4CF1000306
+:10C27000A0FB021C16EB0C06654153F100030942BA
+:10C2800018BF46F0010613F4007F0BD14FEA0331CB
+:10C290004FEA0530340341EA155140EA16506FF079
+:10C2A00003020AE04FEAC3214FEAC520F40241EA43
+:10C2B000555140EA56506FF0020202EB2E4201EB5C
+:10C2C000025585EACE710AD05FEA440C18BF24F00B
+:10C2D000004450F1000041F1000120EAD47040F226
+:10C2E000FE7C624500D270BDA84214BF4FF080446E
+:10C2F0004FF04044002E08BF0024BEF1806FA8BF5D
+:10C30000A1F1C041BDE8704080F282804FF0000092
+:10C3100001F1C04101F0004170479EEA0C0F0CEAA8
+:10C32000131518BF95EA0C0F06D04FF0000081EAF4
+:10C33000030E0EF0004170BD00F01CF88900013EB4
+:10C3400000F007B800F009B84FEA430C5FEA5C5C04
+:10C3500008D081EA030100F05BB84FEA410C5FEAC4
+:10C360005C5CF6D14FF00000014970470000FF0708
+:10C370000000F87F0EF1020E2EF0030E5EF8046B43
+:10C38000364205D4012A43EB030515F5001F12D8E8
+:10C39000012841EB010C1CF5001F0CD80ED14FEA0F
+:10C3A000D17C15F5001F0CEB4C0C0CF1020C08BFF6
+:10C3B0004CEBD37C04E04FF0080C01E04FEAD37C57
+:10C3C0000CEB4C0526FA05F606F00706B6F1040C50
+:10C3D00006D20EEB860CBDE870404CF0010C6047B5
+:10C3E000DFE80CF0090B02024FF000414FF00000B3
+:10C3F000A1F5002170BD19461046012851EB01043A
+:10C4000018BFD4F5001484BF002001F0004170BDB6
+:10C410000808A0F500114FEA3101704753EA010CFA
+:10C4200017D41CF5801F58BFBCF5801F00F1068093
+:10C430008B4218BF704708BF8242704707D713F579
+:10C44000801F58BF11F5801F19D48B4270479B4243
+:10C4500070471CF5801F08D5BCF5801FF7D59942A1
+:10C4600018BF704708BF904270474FF4001C1CEB88
+:10C47000430F38BF1CEB410F01D2994270470FB4F4
+:10C480000CBC03BCFFF7C1BE91EA030F10B581F0ED
+:10C4900000413FF523AC83F0004300F0D5B8000025
+:10C4A0002DE9F04101F5801CBCF5001FC0F2A98008
+:10C4B0004FEA115C21EA0C510CF1FD0C41F48011A2
+:10C4C0005FEA5C0C0CF5C07C01D34000494130A40C
+:10C4D000890241EA905187028E0E0A0CA45D04FB8A
+:10C4E00004F602FB06F6C6F14046A4FB0662F60D12
+:10C4F00046EA422606FB06F4A4FB01235242C3F19E
+:10C50000404338BF5B1EA6FB02420024E6FB032427
+:10C51000D20B42EA4446A6FB0623A1FB02E2A3FBA0
+:10C5200007E4E3FB61426442C2F1404E38BFAEF122
+:10C53000010EA6FB04234FF00002E6FB0E32A2FB25
+:10C5400003463400E2FB6264A1FB06E6A4FB07E8B5
+:10C55000E4FB61687642C8F1405838BFA8F1010891
+:10C56000A2FB06E4A3FB08E5E2FB6854A1FB05E699
+:10C57000A7FB04E8E1FB648618F1200556F10006EC
+:10C58000A809A8F11B08B10908F03F08B8F10A0F83
+:10C5900040EA86601CD901EB0C51BDE8F08100BF78
+:10C5A000FCF5EEE8E2DDD8D3CFCBC7C3C0BDB9B64A
+:10C5B000B4B1AEACA9A7A5A3A19F9D9B9A9896954F
+:10C5C0009392908F8D8C8B898887868584838281D6
+:10C5D000A0FB006800FB01F208EB4208B8EB8728DB
+:10C5E00007D5341858EB0104D5D5401C51F1000192
+:10C5F000D1E7341A78EB0104CDD4401E71F100016B
+:10C60000C9E75FEA4C0C5FEA9C5C0DD105D34FF0A3
+:10C61000000001F00041BDE8F081BDE8F04170B5D7
+:10C62000FFF7A8FE6DDBFFBEBDE8F0414FF0000054
+:10C63000004970470000F87F10B591EA030F48BF2A
+:10C6400083F000433FF54AAB841A71EB030C07D229
+:10C6500012198CF0004C43EB0C03001B61EB0C0136
+:10C66000DFF8A4E14FEA1154A4EB135C1EEA430F78
+:10C6700018BF9EEA445F00F0B08023EA6E03524286
+:10C6800021EA0451C3EB6E0338BF5B1EDCF1200EC0
+:10C6900025D322FA0CFE10EB0E0043FA0CFE41EB00
+:10C6A0000E01CCF1200E03FA0EFE10EB0E0051F13C
+:10C6B0000001CCF1200E29D412FA0EF201EB045144
+:10C6C000BDE8104058BF7047401C1CBFB2F1004F7E
+:10C6D000704700280CBF491C20F00100704712EB86
+:10C6E000020E43EB030218BF4FF0010E4EEA420266
+:10C6F000ACF1200CDCF11E0E54D943FA0CFE10EB09
+:10C700000E0051F1FF31CCF11E0ED5D50EF1010E08
+:10C7100012FA0EFE404141EB010101EB445C5FEA7D
+:10C720005C5C10D910EBDE7001EB045138BFBEF138
+:10C73000004FBDE8104018BF704700280CBF491CCF
+:10C7400020F00100704730D24FEAD42C11F50011CF
+:10C7500024F400641BD0B1FA81F20B3AA41AA41E8F
+:10C76000D2F12003914030FA03F31943904001EBDA
+:10C77000CC71002C01EB0451BDE81040A8BF7047FC
+:10C7800001F1C0414FF0000001F000417047B0FAE4
+:10C7900080F310FA03F100D110BDE41A173C4805EC
+:10C7A000C90AE4E701EB045110BD491001EB045143
+:10C7B000BDE810404FEA300002E04FF00001704742
+:10C7C0004A0008BF0042F8D0B2F5001F28BF7047EA
+:10C7D00001F000414FF0000070479EEA445F07D02F
+:10C7E00011EA5E0FBDE8104004BF00210020704731
+:10C7F000BDE8104070B5FFF7BDFD00BF40DFF63E5D
+:10C8000083F00041104670470000E0FF43004FEA0C
+:10C81000D30C4FEA3C0C43401FBF40070CF1605162
+:10C8200013F0FE4F70471CF0006F03D100200CF096
+:10C83000004170470CF0004343EA507010B540EAE5
+:10C84000CC0000F00EF800BF000000924FEA00019B
+:10C85000FFF7DEBD4FF000414FF00000A1F50021D1
+:10C8600070470EF1020E2EF0030E5EF8044B2442C8
+:10C8700004D44FEA4102B2F17F4F11D84FEA40038E
+:10C88000B3F17F4F0CD80ED14FEAD07CB2F17F4F7D
+:10C890000CEB4C0C0CF1020C08BF4CEBD17C04E00F
+:10C8A0004FF0080C01E04FEAD17C0CEB4C0324FA6A
+:10C8B00003F404F00704B4F1040C06D20EEB840C6C
+:10C8C000BDE810404CF0010C6047DFE80CF00708B1
+:10C8D00002024FF00040A0F5800010BD0846420063
+:10C8E00018BFD2F1807288BF00F0004010BD4FF039
+:10C8F0004070E1EE100A7047FF2141EAD050C005B8
+:10C9000070470CF00F03092B08BF082000F0598076
+:10C910000A2B0BD0082B18BF704708BF1CF0400F24
+:10C920000AD04FF000004FF0000170471CF0400F9C
+:10C9300018BF4FF0004070471CF0100F08D020F0D7
+:10C94000704300F07F4242EAD3014FEA43707047E0
+:10C9500000F0604021F07F4242EA000201F07F4097
+:10C9600040EA727070474FF0FF0C4CF4E06C1CEA28
+:10C9700011531CBF9CEA030C9445C2BFDA4201EB81
+:10C9800002517047002B0DD0BCF1000F0FD0002AD0
+:10C9900001F00041A4BF41F0E04141F07F614FF060
+:10C9A0000000704701F000414FF00000704750EA6E
+:10C9B00001334FF09B0C18BF4CF0806C7FF42EAA13
+:10C9C00070471CF4801F11D01CF4E02F03D06FEAD5
+:10C9D000CC31490070474FF04050EFF3008222F015
+:10C9E000704242EA000282F3008870474FF0000074
+:10C9F0007047000000000000000000000000000080
+:10CA000000003F4000000000000000003000400037
+:10CA100030004000000009000BC03D000BC03D008D
+:10CA2000090018C024407FE0224031800000180037
+:10CA300024C01B000D803240018003801C40274031
+:10CA40001C80074000401000600000000000000053
+:10CA500000000000000000001F8020404020000077
+:10CA6000402020401F8000000000090006001F80B9
+:10CA7000060009000000040004003F8004000400D8
+:10CA80000000001000600000000000000000040032
+:10CA90000400040004000400000000000040000046
+:10CAA000000000000000002001C006003800400027
+:10CAB00000001F802040204020401F800000000018
+:10CAC00010403FC000400000000018C0214022403C
+:10CAD00024401840000010802040244024401B8047
+:10CAE000000002000D0011003FC0014000003C802A
+:10CAF000244024402440238000001F802440244000
+:10CB00003440038000003000200027C0380020009F
+:10CB100000001B802440244024401B8000001C0097
+:10CB200022C0224022401F80000000000000084078
+:10CB30000000000000000000000004600000000091
+:10CB40000000000004000A0011002080404009009D
+:10CB50000900090009000900000000004040208091
+:10CB600011000A00040018002000234024001800CF
+:10CB700000001F802040274029401F400000004047
+:10CB800007C039000F0001C0004020403FC02440D2
+:10CB900024401B8000001F80204020402040308027
+:10CBA000000020403FC0204020401F800000204067
+:10CBB0003FC024402E4030C0000020403FC02440F1
+:10CBC0002E00300000000F001080204022403380F3
+:10CBD000020020403FC0040004003FC0204020402D
+:10CBE00020403FC020402040000000602020202046
+:10CBF0003FC02000200020403FC024400B0030C038
+:10CC0000204020403FC020400040004000C03FC0C6
+:10CC10003C0003C03C003FC0000020403FC00C402F
+:10CC200023003FC020001F802040204020401F8064
+:10CC3000000020403FC024402400180000001F8056
+:10CC40002140214020E01FA0000020403FC02440A0
+:10CC5000260019C0004018C02440244022403180E2
+:10CC60000000300020403FC0204030000000200085
+:10CC70003F80004000403F80200020003E0001C077
+:10CC8000070038002000380007C03C0007C038000B
+:10CC90000000204039C0060039C0204000002000BC
+:10CCA000384007C0384020000000304021C02640F6
+:10CCB000384020C00000000000007FE040204020FD
+:10CCC0000000000070000C00038000400000000025
+:10CCD000402040207FE000000000000020004000D5
+:10CCE00020000000000000100010001000100010D4
+:10CCF00000100000000040000000000000000000E4
+:10CD000002800540054003C0004020003FC00440B1
+:10CD100004400380000000000380044004400640FB
+:10CD2000000000000380044024403FC00040000099
+:10CD300003800540054003400000000004401FC080
+:10CD4000244024402000000002E005500550065019
+:10CD5000042020403FC00440040003C00040000005
+:10CD6000044027C000400000000000100010041024
+:10CD700027E00000000020403FC00140070004C041
+:10CD80000440204020403FC000400040000007C059
+:10CD9000040007C0040003C00000044007C00440B2
+:10CDA000040003C0004000000380044004400380EE
+:10CDB0000000041007F0045004400380000000004D
+:10CDC00003800440045007F00010044007C00240F4
+:10CDD000040004000000000006400540054004C0B7
+:10CDE0000000000004001F80044000400000040018
+:10CDF00007800040044007C000400400070004C052
+:10CE0000018006000400060001C0070001C0060002
+:10CE10000000044006C0010006C0044000000410E9
+:10CE2000071004E00180060004000000044005C073
+:10CE30000640044000000000000004007BE04020A9
+:10CE40000000000000000000FFF0000000000000F3
+:10CE500040207BE004000000000040008000400013
+:10CE60002000200040000000000000000000000042
+:10CE70000000000000000000000000001FCC000CBB
+:10CE80000000000000000000080030006000080002
+:10CE9000300060000000022003FC1E20022003FC82
+:10CEA0001E200220000000000E1811043FFF108415
+:10CEB0000C78000000000F0010840F3800C00778C5
+:10CEC00018840078000000780F8410C411240E9894
+:10CED00000E4008400080800680070000000000002
+:10CEE00000000000000000000000000007E018182B
+:10CEF000200440020000000040022004181807E04F
+:10CF00000000000000000240024001800FF001809C
+:10CF10000240024000000080008000800FF8008086
+:10CF20000080008000000001000D000E00000000E5
+:10CF300000000000000000000080008000800080F1
+:10CF40000080008000800000000C000C0000000049
+:10CF500000000000000000000006001800600180D2
+:10CF6000060018002000000007F008081004100454
+:10CF7000080807F000000000080408041FFC000473
+:10CF800000040000000000000E0C101410241044D7
+:10CF900011840E0C000000000C1810041104110480
+:10CFA00012880C700000000000E003200424082414
+:10CFB0001FFC0024000000001F98108411041104BD
+:10CFC000108810700000000007F008881104110498
+:10CFD00018880070000000001C00100010FC1300F6
+:10CFE0001C001000000000000E3811441084108452
+:10CFF00011440E38000000000700088C1044104453
+:10D00000088807F00000000000000000030C030C7B
+:10D010000000000000000000000000010106000008
+:10D020000000000000000000008001400220041009
+:10D030000808100400000220022002200220022022
+:10D040000220022000000000100408080410022042
+:10D0500001400080000000000E001200100C106C57
+:10D0600010800F00000003E00C1813E4142417C410
+:10D07000082807D000000004003C03C41C400740FF
+:10D0800000E4001C000410041FFC1104110411042E
+:10D090000E880070000003E00C1810041004100447
+:10D0A00010081C10000010041FFC100410041004D1
+:10D0B000080807F0000010041FFC1104110417C435
+:10D0C00010040818000010041FFC1104110017C000
+:10D0D00010000800000003E00C18100410041044B5
+:10D0E0001C780040000010041FFC108400800080A9
+:10D0F00010841FFC10040000100410041FFC100416
+:10D1000010040000000000030001100110011FFEC8
+:10D1100010001000000010041FFC110403801464B0
+:10D12000181C1004000010041FFC1004000400046C
+:10D130000004000C000010041FFC1F0000FC1F0076
+:10D140001FFC1004000010041FFC0C04030000E08E
+:10D1500010181FFC100007F0080810041004100439
+:10D16000080807F0000010041FFC108410801080D5
+:10D1700010800F00000007F0081810241024101C65
+:10D18000080A07F2000010041FFC1104110011C06E
+:10D1900011300E0C000400000E1C110410841084C9
+:10D1A00010441C3800001800100010041FFC10046C
+:10D1B00010001800000010001FF810040004000404
+:10D1C00010041FF8100010001E0011E0001C007079
+:10D1D00013801C0010001FC0103C00E01F0000E086
+:10D1E000103C1FC000001004180C163401C001C010
+:10D1F0001634180C100410001C00130400FC130457
+:10D200001C00100000000804101C1064108413049B
+:10D210001C04101800000000000000007FFE400207
+:10D22000400240020000000030000C00038000605B
+:10D23000001C0003000000004002400240027FFE8C
+:10D24000000000000000000000002000400040003E
+:10D250004000200000000001000100010001000169
+:10D26000000100010001000040004000200000001B
+:10D270000000000000000000009801240144014467
+:10D28000014400FC000410001FFC0088010401049C
+:10D290000088007000000000007000880104010494
+:10D2A00001040088000000000070008801040104EF
+:10D2B00011081FFC0004000000F80144014401446F
+:10D2C000014400C800000000010401040FFC110427
+:10D2D000110411001800000000D6012901290129BC
+:10D2E00001C90106000010041FFC008401000100B8
+:10D2F000010400FC000400000104190419FC0004EE
+:10D3000000040000000000000003000101011901F9
+:10D3100019FE0000000010041FFC0024004001B4AE
+:10D32000010C010400000000100410041FFC0004A4
+:10D33000000400000000010401FC0104010001FCE4
+:10D340000104010000FC010401FC00840100010053
+:10D35000010400FC0004000000F8010401040104C1
+:10D36000010400F80000010101FF0085010401042F
+:10D3700000880070000000000070008801040104B3
+:10D38000010501FF00010104010401FC0084010406
+:10D39000010001800000000000CC012401240124D0
+:10D3A00001240198000000000100010007F80104B9
+:10D3B000010400000000010001F800040004000462
+:10D3C000010801FC0004010001800170000C001044
+:10D3D00001600180010001F0010C003001C000304B
+:10D3E000010C01F0010000000104018C00740170C7
+:10D3F000018C01040000010101810171000E00187F
+:10D4000001600180010000000184010C013401442D
+:10D410000184010C00000000000000000000010079
+:10D420003EFC400240020000000000000000FFFF40
+:10D430000000000000000000400240023EFC01002D
+:10D44000000000000000000060008000800040003C
+:10D45000400020002000404281FE00000121D21443
+:10D460000814E2010000080808FF090419111197C7
+:10D47000711111151900000000000000FF000000EC
+:10D480000080600000004040404040407F404042FB
+:10D490004140404040000106F840404040FE4040CE
+:10D4A0004241FE00000000007F444444447F444465
+:10D4B00044447F000000000106F880808080808066
+:10D4C0008080C00000000000001F1010907010103D
+:10D4D00010101F000000404281FE00000121D21404
+:10D4E0000814E2010000080808FF09041911119747
+:10D4F0007111111519008080FE848A6418E422A23B
+:10D50000A2FAA2A22200020CF72424012739082A39
+:10D510002AFF2A3E08004080FE0808FC0106F89019
+:10D5200090FC9291FE002021273A2223040817E460
+:10D5300024272C340700000000FC09120418E00026
+:10D54000E01804020100020242330000000000FF64
+:10D550000000000000000001020CF00000000000CC
+:10D56000FF0000000000014141417F414141414134
+:10D570007F41414101000244A810688400007F42BD
+:10D580004242427F000008080FF8080F0002071A05
+:10D59000E2020A060300000000FF222222222222C9
+:10D5A00022FF000000000000001F113151911111F5
+:10D5B000111F0000000020C000FF0082221A8272AA
+:10D5C000061AE202020008080BFF090A040A32C226
+:10D5D000320A040202000102040830C00000FC020A
+:10D5E0000202020E00000002424242437E424342D7
+:10D5F0004242020200004241FE8222A4A8B0A07F63
+:10D60000B0A8A4A222000808FF080907F494979084
+:10D610009794F4070000800000FF00000000FF1056
+:10D620001010101000000001061FE0020CF01F1186
+:10D63000111111101000106080FF80608101020242
+:10D64000E40830C000002424257FC44400031C00EB
+:10D65000FF0010080600020418E0007F4242424228
+:10D6600042427F0000000000003F24242424444460
+:10D6700044C444040400000204F80402FA12220222
+:10D680008242A21A0200020242330000FF929293E9
+:10D690009292FE010000003E0202020202FE02021D
+:10D6A0000202023F000000003E02020202FF0202EC
+:10D6B00002023F000000020202FE020202FE02021B
+:10D6C000020202020200004040434040407F4141CC
+:10D6D000414141400000408000FF0282828282FE80
+:10D6E000828282820200101011131C30D010101799
+:10D6F000101010101000000000FF2222222222220F
+:10D7000022FF000000000000001F11315191111193
+:10D71000111F0000000020C000FF0082221A827248
+:10D72000061AE202020008080BFF090A040A32C2C4
+:10D73000320A0402020000001A1C0000000000006F
+:10D7400000000000000000000000000000000000D9
+:10D75000000000000000106080FF80608101020274
+:10D76000E40830C000002424257FC44400031C00CA
+:10D77000FF0010080600020418E0007F4242424207
+:10D7800042427F0000000000003F2424242444443F
+:10D7900044C444040400008181828CF0808080FEB7
+:10D7A0008181818F0000083020242424A464242453
+:10D7B0002424202830000106F8000804F80102841F
+:10D7C000681864821F0000001F111111111010FF52
+:10D7D000109050131000101810FF202000FF42423C
+:10D7E000FE4242FF0000131DF1171111000F08083F
+:10D7F000FF08080F00000106F890909090FE9090AE
+:10D800009291FE00000004081724E4242427242C0D
+:10D81000340407000000000204F80412224282FAD5
+:10D820008242221202000202423300202F2929FFE5
+:10D8300029292F200000020CF1012132AAA4A4A45E
+:10D84000AA320101010000003F2424243FA46424E3
+:10D850003F2424242000000000FF22222222222232
+:10D8600022FF000000000000001F11315191111132
+:10D87000111F0000000020C000FF0082221A8272E7
+:10D88000061AE202020008080BFF090A040A32C263
+:10D89000320A04020200008181828CF0808080FEC6
+:10D8A0008181818F0000083020242424A464242452
+:10D8B0002424202830000106F8000804F80102841E
+:10D8C000681864821F0000001F111111111010FF51
+:10D8D0001090501310008080FE848800FF92929276
+:10D8E0009292FF000000020CF724261212FE121280
+:10D8F00012FE121202000000FE042921222428F048
+:10D90000282422212100024233000001794949499B
+:10D91000494979010000800000FF0000000000C0BC
+:10D92000300804021F000001061FE0040404FE0585
+:10D930000888680808004080FE0808FC00101010E5
+:10D9400010121102FC002021273A222300404F41EF
+:10D9500041417F0101000000F810101010FE11116C
+:10D960001111F9010F0000001F11111111FF111108
+:10D9700011111F0000000106F80202020202FE025D
+:10D9800002221A02020000007F40414141415F41F2
+:10D99000414141414000000204F8040202820212A7
+:10D9A0000AF20202020002024233001012111010A9
+:10D9B00010FF10101000800000FF0000FF020400A4
+:10D9C00082710C021F000001061FE0003F2121218F
+:10D9D0007F41C14101000000FF000181A29488F451
+:10D9E00082828181010001061FE02027242424FF78
+:10D9F00024242427200000FF48484A49FE00007ED6
+:10DA0000111121410700103352921252331800FEB7
+:10DA10001111214107000001020CF000000000007C
+:10DA2000FF0000000000014141417F41414141416F
+:10DA30007F4141410100818182828488B0C0B088E9
+:10DA4000848282818100000008886808080F080825
+:10DA500028C808000000818182828488B0C0B08814
+:10DA6000848282818100000008886808080F080805
+:10DA700028C80800000000FF001020408804F800BB
+:10DA8000000201FE0000001F8044044444455F443E
+:10DA90004444407F00001018122122FC00FE0A12AC
+:10DAA0006282621A0200405F41417F01007F40486C
+:10DAB000464146584000083CC808281D020C7080AA
+:10DAC000020102FC0000022223222222020808FF97
+:10DAD0000808080F000044E644484848020204C809
+:10DAE000302844821F00040C35C60418010909FFC0
+:10DAF000099252120200020CF1010202C4281028FD
+:10DB000044820201010000003F24242724244444CD
+:10DB100044C546000000202241FE804141526AC4B3
+:10DB2000444A72414000080808FF080A222AA663F6
+:10DB300022262A2202001018122122FC00FE0A12BC
+:10DB40006282621A0200405F41417F01007F4048CB
+:10DB5000464146584000083CC808281D020C708009
+:10DB6000020102FC0000022223222222020808FFF6
+:10DB70000808080F0000202241FE800001F1020C7D
+:10DB8000F00804F30000080808FF080900037A4AB7
+:10DB90004A4A7A030000101810E020281020408024
+:10DBA000FF0000C03000040404FF040420202021F2
+:10DBB00027382120200044E644484A1CE0FF90FE1C
+:10DBC00090FC91FF0000040C35C60C003F24A464B7
+:10DBD0002424243C00004080FE0808FC00101010A3
+:10DBE00010121102FC002021273A222300404F414D
+:10DBF00041417F01010010102F2949498F00804FBA
+:10DC00004929291F100001017949494979070179FA
+:10DC10004D4B49790100202241FE800001F1020CA8
+:10DC2000F00804F30000080808FF080900037A4A16
+:10DC30004A4A7A030000101810E020281020408083
+:10DC4000FF0000C03000040404FF04042020202151
+:10DC50002738212020000000F810101010FE1111AC
+:10DC60001111F9010F0000001F11111111FF111105
+:10DC700011111F00000020207E820CF004C8928148
+:10DC8000FE8090C8040008064031007F404F4A5A89
+:10DC90006A4A4A4F400008102040800000FF000000
+:10DCA000008040300000004040404041424F704200
+:10DCB000414040400000106080FF00C10620263136
+:10DCC0002D2123E806002424257FC544102949C9B5
+:10DCD0004959690F000001020478040202FE222261
+:10DCE000222222020200083022222222A2632222C1
+:10DCF00022222228300020207E80027E42427E4264
+:10DD00007E42427E02000806403100007F494949B8
+:10DD100049497F000000020CF1012132AAA4A4A409
+:10DD2000AA320101010000003F2424243FA46424FE
+:10DD30003F2424242000000204F80402028202127C
+:10DD40000AF2020202000202423300101211101005
+:10DD500010FF10101000007F40405E52525252528D
+:10DD60005E40417F0000202020202F29A969292919
+:10DD70002F20202020000000F810101010FE11119C
+:10DD80001111F9010F0000001F11111111FF1111E4
+:10DD900011111F00000020C000FF00C106F80000A4
+:10DDA00000FC02021E0008080BFF0908007F40402B
+:10DDB000407F0000000044E644484848020204C88E
+:10DDC000302844821F00040C35C60418010909FFDD
+:10DDD000099252120200202241FE804141526AC43F
+:10DDE000444A72414000080808FF080A222AA66334
+:10DDF00022262A2202008080FE848800FF929292CE
+:10DE00009292FF000000020CF724261212FE12125A
+:10DE100012FE121202001020C000000201FE0000DB
+:10DE200000000080700000000007000000FF0000FC
+:10DE300000040201000010109090909090FF9090CC
+:10DE4000909090101000001011121418F01710107C
+:10DE5000101010100000020202FE020202FE020276
+:10DE6000020202020200004040434040407F414124
+:10DE700041414140000000007C40404040FF4040A4
+:10DE800048447800000004181057351515F515158D
+:10DE900035571014180000004FBB610567ACDD3F1B
+:10DEA000182D4454FB21E93F9BF681D20B73EF3FC1
+:10DEB000182D4454FB21F93FE2652F227F2B7A3C39
+:10DEC000075C143326A6813CBDCBF07A8807703CF2
+:10DED000075C143326A6913CC4EB98999999C9BF65
+:10DEE000711623FEC671BCBF6D9A74AFF2B0B3BF9A
+:10DEF0009AFDDE522DDEADBF2F6C6A2C44B4A2BF5A
+:10DF00000D5555555555D53FFF8300922449C23FC5
+:10DF10006E204CC5CD45B73F513DD0A0660DB13FF9
+:10DF2000EB0D76244B7BA93F11DA22E33AAD903F0B
+:10DF3000000000000000F03F000000000000F83F7B
+:10DF400000000000000000000000004003B8E23FB5
+:10DF5000000000000000000006D0CF43EBFD4C3E67
+:10DF6000033333333333E33FFFAB6FDBB66DDB3F5C
+:10DF70004D268F515555D53F01411DA96074D13FA4
+:10DF800065DBC9934A86CD3FEF4E454A287ECA3F9E
+:10DF90003E5555555555C53F93BDBE166CC166BF20
+:10DFA0002CDE25AF6A56113FF16BD2C541BDBBBE19
+:10DFB000D0A4BE726937663E000000000000000079
+:10DFC00000004054FB21F93F3163621A61B4D03D37
+:10DFD0000000601A61B4D03D7370032E8A19A33B10
+:10DFE0000000002E8A19A33BC14920259A837B3962
+:10DFF00000000000000000006E83F9A22915444EC5
+:10E00000D15727FCC0DD34F5999562DB4190433C44
+:10E01000AB6351FE61C5BBDE3A6E24B7E0D24D4220
+:10E02000EA2E49061C92D1091CEB1DFE3EA729B120
+:10E03000F53582E88444BB2E26709CE9417E5FB4AE
+:10E0400039D69139F43953838B5F849C3B28F9BDD1
+:10E05000FF97F81F0F9805DE8B112FEF1F6D0A5ADF
+:10E06000CF7E366DB709CB27663F464F2DEA5F9EC0
+:10E07000C7BA27757BF1E5EBF739073DEA92528A7B
+:10E08000B15FFB6B085D8D1F7AFE10111111C13F4E
+:10E0900037D60684F464963F280356C9226D6D3F37
+:10E0A0000165F2F2D844433FA69237A0887E143F20
+:10E0B000735360DBCB75F3BEFE41B31BBAA1AB3F1C
+:10E0C00093846EE9E326823F1583E0FEC8DB573F69
+:10E0D00068108D1AF726303FE9A7F0320FB8123FCB
+:10E0E000D47ABF74702AFB3E08E1000800000020CB
+:10E0F00080020000C40100086CE1000880020020DA
+:10E10000D05E00002002000851847A030AC0090191
+:10E11000020304060708090213017AF415140142E8
+:10E12000011202120312041205120612071208123B
+:10E1300009120A120B120C120D120E120F022D10E0
+:10E140000B1CDC0504012A29CA0912CE01461AAAB1
+:10E1500001091F82719204E3FA431A9610038C4856
+:0CE1600044B264024D190314803F00001B
+:040000050800018965
+:00000001FF
diff --git a/OBJ/OriginCar.htm b/OBJ/OriginCar.htm
new file mode 100644
index 0000000..dc4caf1
--- /dev/null
+++ b/OBJ/OriginCar.htm
@@ -0,0 +1,3829 @@
+
+
+Static Call Graph - [..\OBJ\OriginCar.axf]
+

+
Static Call Graph for image ..\OBJ\OriginCar.axf

+
#<CALLGRAPH># ARM Linker, 5060750: Last Updated: Mon Dec 22 18:06:35 2025
+

+
Maximum Stack Usage =        424 bytes + Unknown(Functions without stacksize, Cycles, Untraceable Function Pointers)

+Call chain for Maximum Stack Depth:

+prvTimerTask ⇒ prvProcessReceivedCommands ⇒ prvSampleTimeNow ⇒ prvSwitchTimerLists ⇒ xTimerGenericCommand ⇒ xQueueGenericSend ⇒ prvUnlockQueue ⇒ prvNotifyQueueSetContainer ⇒ prvCopyDataToQueue ⇒ xTaskPriorityDisinherit ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+

+

+Functions with no stack information
+

+
+

+

+Mutually Recursive functions
+
 
  • ADC_IRQHandler   ⇒   ADC_IRQHandler
    
+
+
    
+
    
+Function Pointers
+
      
+ 
    • ADC_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • Balance_task from balance.o(i.Balance_task) referenced from main.o(i.start_task)
+ 
    • BusFault_Handler from stm32f4xx_it.o(i.BusFault_Handler) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • CAN1_RX0_IRQHandler from can.o(i.CAN1_RX0_IRQHandler) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • CAN1_RX1_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • CAN1_SCE_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • CAN1_TX_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • CAN2_RX0_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • CAN2_RX1_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • CAN2_SCE_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • CAN2_TX_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • CRYP_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • DCMI_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • DMA1_Stream0_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • DMA1_Stream1_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • DMA1_Stream2_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • DMA1_Stream3_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • DMA1_Stream4_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • DMA1_Stream5_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • DMA1_Stream6_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • DMA1_Stream7_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • DMA2_Stream0_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • DMA2_Stream1_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • DMA2_Stream2_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • DMA2_Stream3_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • DMA2_Stream4_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • DMA2_Stream5_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • DMA2_Stream6_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • DMA2_Stream7_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • DebugMon_Handler from stm32f4xx_it.o(i.DebugMon_Handler) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • ETH_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • ETH_WKUP_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • EXTI0_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • EXTI15_10_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • EXTI1_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • EXTI2_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • EXTI3_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • EXTI4_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • EXTI9_5_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • FLASH_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • FPU_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • FSMC_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • HASH_RNG_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • HardFault_Handler from stm32f4xx_it.o(i.HardFault_Handler) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • I2C1_ER_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • I2C1_EV_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • I2C2_ER_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • I2C2_EV_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • I2C3_ER_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • I2C3_EV_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • MPU6050_task from mpu6050.o(i.MPU6050_task) referenced from main.o(i.start_task)
+ 
    • MemManage_Handler from stm32f4xx_it.o(i.MemManage_Handler) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • NMI_Handler from stm32f4xx_it.o(i.NMI_Handler) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • OTG_FS_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • OTG_FS_WKUP_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • OTG_HS_EP1_IN_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • OTG_HS_EP1_OUT_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • OTG_HS_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • OTG_HS_WKUP_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • PVD_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • PendSV_Handler from port.o(.emb_text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • RCC_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • RTC_Alarm_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • RTC_WKUP_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • Reset_Handler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • SDIO_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • SPI1_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • SPI2_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • SPI3_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • SVC_Handler from port.o(.emb_text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • SysTick_Handler from delay.o(i.SysTick_Handler) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • SystemInit from system_stm32f4xx.o(i.SystemInit) referenced from startup_stm32f40_41xxx.o(.text)
+ 
    • TAMP_STAMP_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • TIM1_BRK_TIM9_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • TIM1_CC_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • TIM1_TRG_COM_TIM11_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • TIM1_UP_TIM10_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • TIM2_IRQHandler from encoder.o(i.TIM2_IRQHandler) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • TIM3_IRQHandler from encoder.o(i.TIM3_IRQHandler) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • TIM4_IRQHandler from encoder.o(i.TIM4_IRQHandler) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • TIM5_IRQHandler from encoder.o(i.TIM5_IRQHandler) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • TIM6_DAC_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • TIM7_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • TIM8_BRK_TIM12_IRQHandler from encoder.o(i.TIM8_BRK_TIM12_IRQHandler) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • TIM8_CC_IRQHandler from timer.o(i.TIM8_CC_IRQHandler) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • TIM8_TRG_COM_TIM14_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • TIM8_UP_TIM13_IRQHandler from timer.o(i.TIM8_UP_TIM13_IRQHandler) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • UART4_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • UART5_IRQHandler from usartx.o(i.UART5_IRQHandler) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • USART1_IRQHandler from usartx.o(i.USART1_IRQHandler) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • USART2_IRQHandler from usartx.o(i.USART2_IRQHandler) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • USART3_IRQHandler from usartx.o(i.USART3_IRQHandler) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • USART6_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • UsageFault_Handler from stm32f4xx_it.o(i.UsageFault_Handler) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • WWDG_IRQHandler from startup_stm32f40_41xxx.o(.text) referenced from startup_stm32f40_41xxx.o(RESET)
+ 
    • __main from __main.o(!!!main) referenced from startup_stm32f40_41xxx.o(.text)
+ 
    • _printf_input_char from _printf_char_common.o(.text) referenced from _printf_char_common.o(.text)
+ 
    • data_task from usartx.o(i.data_task) referenced from main.o(i.start_task)
+ 
    • fputc from usart.o(i.fputc) referenced from _printf_char_file.o(.text)
+ 
    • led_task from led.o(i.led_task) referenced from main.o(i.start_task)
+ 
    • prvIdleTask from tasks.o(i.prvIdleTask) referenced from tasks.o(i.vTaskStartScheduler)
+ 
    • prvTaskExitError from port.o(i.prvTaskExitError) referenced from port.o(i.pxPortInitialiseStack)
+ 
    • prvTimerTask from timers.o(i.prvTimerTask) referenced from timers.o(i.xTimerCreateTimerTask)
+ 
    • pstwo_task from pstwo.o(i.pstwo_task) referenced from main.o(i.start_task)
+ 
    • show_task from show.o(i.show_task) referenced from main.o(i.start_task)
+ 
    • start_task from main.o(i.start_task) referenced from main.o(i.main)
+
    
+
    
+
    
+Global Symbols
+
    
+
    __main (Thumb, 8 bytes, Stack size 0 bytes, __main.o(!!!main))
+

    [Calls]
    • >>   __scatterload
+
    • >>   __rt_entry
+
    
+
+
    __scatterload (Thumb, 0 bytes, Stack size unknown bytes, __scatter.o(!!!scatter))
+

    [Called By]
    • >>   __main
+
    
+
+
    __scatterload_rt2 (Thumb, 44 bytes, Stack size unknown bytes, __scatter.o(!!!scatter), UNUSED)
+

    [Calls]
    • >>   __rt_entry
+
    
+
+
    __scatterload_rt2_thumb_only (Thumb, 0 bytes, Stack size unknown bytes, __scatter.o(!!!scatter), UNUSED)
+
+
    __scatterload_null (Thumb, 0 bytes, Stack size unknown bytes, __scatter.o(!!!scatter), UNUSED)
+
+
    __decompress (Thumb, 90 bytes, Stack size unknown bytes, __dczerorl2.o(!!dczerorl2), UNUSED)
+
+
    __decompress1 (Thumb, 0 bytes, Stack size unknown bytes, __dczerorl2.o(!!dczerorl2), UNUSED)
+
+
    __scatterload_zeroinit (Thumb, 28 bytes, Stack size unknown bytes, __scatter_zi.o(!!handler_zi), UNUSED)
+
+
    _printf_d (Thumb, 0 bytes, Stack size unknown bytes, _printf_d.o(.ARM.Collect$$_printf_percent$$00000009))
+

    [Stack]
    • Max Depth = 56 + Unknown Stack Size
+
    • Call Chain = _printf_d ⇒ _printf_int_dec ⇒ _printf_int_common
+
    
+
    [Calls]
    • >>   _printf_int_dec
+
    
+
+
    _printf_percent (Thumb, 0 bytes, Stack size unknown bytes, _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000))
+

    [Called By]
    • >>   __printf
+
    
+
+
    _printf_s (Thumb, 0 bytes, Stack size unknown bytes, _printf_s.o(.ARM.Collect$$_printf_percent$$00000014))
+

    [Stack]
    • Max Depth = 24 + Unknown Stack Size
+
    • Call Chain = _printf_s ⇒ _printf_string ⇒ _printf_cs_common ⇒ _printf_str
+
    
+
    [Calls]
    • >>   _printf_string
+
    
+
+
    _printf_percent_end (Thumb, 0 bytes, Stack size unknown bytes, _printf_percent_end.o(.ARM.Collect$$_printf_percent$$00000017))
+
+
    __rt_lib_init (Thumb, 0 bytes, Stack size unknown bytes, libinit.o(.ARM.Collect$$libinit$$00000000))
+

    [Called By]
    • >>   __rt_entry_li
+
    
+
+
    __rt_lib_init_fp_1 (Thumb, 0 bytes, Stack size unknown bytes, libinit2.o(.ARM.Collect$$libinit$$00000001))
+

    [Calls]
    • >>   _fp_init
+
    
+
+
    __rt_lib_init_alloca_1 (Thumb, 0 bytes, Stack size unknown bytes, libinit2.o(.ARM.Collect$$libinit$$0000002E))
+
+
    __rt_lib_init_argv_1 (Thumb, 0 bytes, Stack size unknown bytes, libinit2.o(.ARM.Collect$$libinit$$0000002C))
+
+
    __rt_lib_init_atexit_1 (Thumb, 0 bytes, Stack size unknown bytes, libinit2.o(.ARM.Collect$$libinit$$0000001B))
+
+
    __rt_lib_init_clock_1 (Thumb, 0 bytes, Stack size unknown bytes, libinit2.o(.ARM.Collect$$libinit$$00000021))
+
+
    __rt_lib_init_cpp_1 (Thumb, 0 bytes, Stack size unknown bytes, libinit2.o(.ARM.Collect$$libinit$$00000032))
+
+
    __rt_lib_init_exceptions_1 (Thumb, 0 bytes, Stack size unknown bytes, libinit2.o(.ARM.Collect$$libinit$$00000030))
+
+
    __rt_lib_init_fp_trap_1 (Thumb, 0 bytes, Stack size unknown bytes, libinit2.o(.ARM.Collect$$libinit$$0000001F))
+
+
    __rt_lib_init_getenv_1 (Thumb, 0 bytes, Stack size unknown bytes, libinit2.o(.ARM.Collect$$libinit$$00000023))
+
+
    __rt_lib_init_heap_1 (Thumb, 0 bytes, Stack size unknown bytes, libinit2.o(.ARM.Collect$$libinit$$0000000A))
+
+
    __rt_lib_init_lc_collate_1 (Thumb, 0 bytes, Stack size unknown bytes, libinit2.o(.ARM.Collect$$libinit$$00000011))
+
+
    __rt_lib_init_lc_ctype_1 (Thumb, 0 bytes, Stack size unknown bytes, libinit2.o(.ARM.Collect$$libinit$$00000013))
+
+
    __rt_lib_init_lc_monetary_1 (Thumb, 0 bytes, Stack size unknown bytes, libinit2.o(.ARM.Collect$$libinit$$00000015))
+
+
    __rt_lib_init_lc_numeric_1 (Thumb, 0 bytes, Stack size unknown bytes, libinit2.o(.ARM.Collect$$libinit$$00000017))
+
+
    __rt_lib_init_lc_time_1 (Thumb, 0 bytes, Stack size unknown bytes, libinit2.o(.ARM.Collect$$libinit$$00000019))
+
+
    __rt_lib_init_preinit_1 (Thumb, 0 bytes, Stack size unknown bytes, libinit2.o(.ARM.Collect$$libinit$$00000004))
+
+
    __rt_lib_init_rand_1 (Thumb, 0 bytes, Stack size unknown bytes, libinit2.o(.ARM.Collect$$libinit$$0000000E))
+
+
    __rt_lib_init_return (Thumb, 0 bytes, Stack size unknown bytes, libinit2.o(.ARM.Collect$$libinit$$00000033))
+
+
    __rt_lib_init_signal_1 (Thumb, 0 bytes, Stack size unknown bytes, libinit2.o(.ARM.Collect$$libinit$$0000001D))
+
+
    __rt_lib_init_stdio_1 (Thumb, 0 bytes, Stack size unknown bytes, libinit2.o(.ARM.Collect$$libinit$$00000025))
+
+
    __rt_lib_init_user_alloc_1 (Thumb, 0 bytes, Stack size unknown bytes, libinit2.o(.ARM.Collect$$libinit$$0000000C))
+
+
    __rt_lib_shutdown (Thumb, 0 bytes, Stack size unknown bytes, libshutdown.o(.ARM.Collect$$libshutdown$$00000000))
+

    [Called By]
    • >>   __rt_exit_ls
+
    
+
+
    __rt_lib_shutdown_cpp_1 (Thumb, 0 bytes, Stack size unknown bytes, libshutdown2.o(.ARM.Collect$$libshutdown$$00000002))
+
+
    __rt_lib_shutdown_fp_trap_1 (Thumb, 0 bytes, Stack size unknown bytes, libshutdown2.o(.ARM.Collect$$libshutdown$$00000007))
+
+
    __rt_lib_shutdown_heap_1 (Thumb, 0 bytes, Stack size unknown bytes, libshutdown2.o(.ARM.Collect$$libshutdown$$0000000F))
+
+
    __rt_lib_shutdown_return (Thumb, 0 bytes, Stack size unknown bytes, libshutdown2.o(.ARM.Collect$$libshutdown$$00000010))
+
+
    __rt_lib_shutdown_signal_1 (Thumb, 0 bytes, Stack size unknown bytes, libshutdown2.o(.ARM.Collect$$libshutdown$$0000000A))
+
+
    __rt_lib_shutdown_stdio_1 (Thumb, 0 bytes, Stack size unknown bytes, libshutdown2.o(.ARM.Collect$$libshutdown$$00000004))
+
+
    __rt_lib_shutdown_user_alloc_1 (Thumb, 0 bytes, Stack size unknown bytes, libshutdown2.o(.ARM.Collect$$libshutdown$$0000000C))
+
+
    __rt_entry (Thumb, 0 bytes, Stack size unknown bytes, __rtentry.o(.ARM.Collect$$rtentry$$00000000))
+

    [Called By]
    • >>   __scatterload_rt2
+
    • >>   __main
+
    
+
+
    __rt_entry_presh_1 (Thumb, 0 bytes, Stack size unknown bytes, __rtentry2.o(.ARM.Collect$$rtentry$$00000002))
+
+
    __rt_entry_sh (Thumb, 0 bytes, Stack size unknown bytes, __rtentry4.o(.ARM.Collect$$rtentry$$00000004))
+

    [Stack]
    • Max Depth = 8 + Unknown Stack Size
+
    • Call Chain = __rt_entry_sh ⇒ __user_setup_stackheap
+
    
+
    [Calls]
    • >>   __user_setup_stackheap
+
    
+
+
    __rt_entry_li (Thumb, 0 bytes, Stack size unknown bytes, __rtentry2.o(.ARM.Collect$$rtentry$$0000000A))
+

    [Calls]
    • >>   __rt_lib_init
+
    
+
+
    __rt_entry_postsh_1 (Thumb, 0 bytes, Stack size unknown bytes, __rtentry2.o(.ARM.Collect$$rtentry$$00000009))
+
+
    __rt_entry_main (Thumb, 0 bytes, Stack size unknown bytes, __rtentry2.o(.ARM.Collect$$rtentry$$0000000D))
+

    [Stack]
    • Max Depth = 312 + Unknown Stack Size
+
    • Call Chain = __rt_entry_main ⇒ main ⇒ vTaskStartScheduler ⇒ xTimerCreateTimerTask ⇒ xTaskCreate ⇒ pvPortMalloc ⇒ xTaskResumeAll ⇒ xTaskIncrementTick ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   main
+
    • >>   exit
+
    
+
+
    __rt_entry_postli_1 (Thumb, 0 bytes, Stack size unknown bytes, __rtentry2.o(.ARM.Collect$$rtentry$$0000000C))
+
+
    __rt_exit (Thumb, 0 bytes, Stack size unknown bytes, rtexit.o(.ARM.Collect$$rtexit$$00000000))
+

    [Called By]
    • >>   exit
+
    
+
+
    __rt_exit_ls (Thumb, 0 bytes, Stack size unknown bytes, rtexit2.o(.ARM.Collect$$rtexit$$00000003))
+

    [Calls]
    • >>   __rt_lib_shutdown
+
    
+
+
    __rt_exit_prels_1 (Thumb, 0 bytes, Stack size unknown bytes, rtexit2.o(.ARM.Collect$$rtexit$$00000002))
+
+
    __rt_exit_exit (Thumb, 0 bytes, Stack size unknown bytes, rtexit2.o(.ARM.Collect$$rtexit$$00000004))
+

    [Calls]
    • >>   _sys_exit
+
    
+
+
    SVC_Handler (Thumb, 28 bytes, Stack size 0 bytes, port.o(.emb_text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    __asm___6_port_c_39a90d8d__prvStartFirstTask (Thumb, 28 bytes, Stack size 0 bytes, port.o(.emb_text))
+

    [Called By]
    • >>   xPortStartScheduler
+
    
+
+
    __asm___6_port_c_39a90d8d__prvEnableVFP (Thumb, 16 bytes, Stack size 0 bytes, port.o(.emb_text))
+

    [Called By]
    • >>   xPortStartScheduler
+
    
+
+
    PendSV_Handler (Thumb, 88 bytes, Stack size 0 bytes, port.o(.emb_text))
+

    [Stack]
    • Max Depth = 136 + Unknown Stack Size
+
    • Call Chain = PendSV_Handler ⇒ vTaskSwitchContext ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   vTaskSwitchContext
+
    
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    vPortGetIPSR (Thumb, 6 bytes, Stack size 0 bytes, port.o(.emb_text))
+

    [Called By]
    • >>   vPortValidateInterruptPriority
+
    
+
+
    Reset_Handler (Thumb, 8 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    ADC_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+

    [Calls]
    • >>   ADC_IRQHandler
+
    
+
    [Called By]
    • >>   ADC_IRQHandler
+
    
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    CAN1_RX1_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    CAN1_SCE_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    CAN1_TX_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    CAN2_RX0_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    CAN2_RX1_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    CAN2_SCE_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    CAN2_TX_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    CRYP_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    DCMI_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    DMA1_Stream0_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    DMA1_Stream1_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    DMA1_Stream2_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    DMA1_Stream3_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    DMA1_Stream4_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    DMA1_Stream5_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    DMA1_Stream6_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    DMA1_Stream7_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    DMA2_Stream0_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    DMA2_Stream1_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    DMA2_Stream2_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    DMA2_Stream3_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    DMA2_Stream4_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    DMA2_Stream5_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    DMA2_Stream6_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    DMA2_Stream7_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    ETH_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    ETH_WKUP_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    EXTI0_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    EXTI15_10_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    EXTI1_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    EXTI2_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    EXTI3_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    EXTI4_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    EXTI9_5_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    FLASH_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    FPU_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    FSMC_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    HASH_RNG_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    I2C1_ER_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    I2C1_EV_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    I2C2_ER_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    I2C2_EV_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    I2C3_ER_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    I2C3_EV_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    OTG_FS_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    OTG_FS_WKUP_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    OTG_HS_EP1_IN_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    OTG_HS_EP1_OUT_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    OTG_HS_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    OTG_HS_WKUP_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    PVD_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    RCC_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    RTC_Alarm_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    RTC_WKUP_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    SDIO_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    SPI1_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    SPI2_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    SPI3_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    TAMP_STAMP_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    TIM1_BRK_TIM9_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    TIM1_CC_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    TIM1_TRG_COM_TIM11_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    TIM1_UP_TIM10_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    TIM6_DAC_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    TIM7_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    TIM8_TRG_COM_TIM14_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    UART4_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    USART6_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    WWDG_IRQHandler (Thumb, 0 bytes, Stack size 0 bytes, startup_stm32f40_41xxx.o(.text))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    __user_initial_stackheap (Thumb, 0 bytes, Stack size unknown bytes, startup_stm32f40_41xxx.o(.text))
+

    [Called By]
    • >>   __user_setup_stackheap
+
    
+
+
    __use_no_semihosting (Thumb, 2 bytes, Stack size 0 bytes, use_no_semi_2.o(.text), UNUSED)
+
+
    __2printf (Thumb, 20 bytes, Stack size 24 bytes, noretval__2printf.o(.text))
+

    [Stack]
    • Max Depth = 128 + Unknown Stack Size
+
    • Call Chain = __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   _printf_char_file
+
    
+
    [Called By]
    • >>   vTaskDelay
+
    • >>   vTaskStartScheduler
+
    • >>   vTaskDelete
+
    • >>   vPortExitCritical
+
    • >>   vPortEnterCritical
+
    • >>   vTaskDelayUntil
+
    • >>   vTaskSwitchContext
+
    • >>   prvInitialiseNewTask
+
    • >>   xTaskRemoveFromEventList
+
    • >>   xTaskPriorityDisinherit
+
    • >>   xTaskCheckForTimeOut
+
    • >>   vTaskSetTimeOutState
+
    • >>   vTaskPlaceOnEventListRestricted
+
    • >>   vTaskPlaceOnEventList
+
    • >>   vPortValidateInterruptPriority
+
    • >>   xQueueGenericSendFromISR
+
    • >>   xQueueGenericSend
+
    • >>   xQueueGenericReset
+
    • >>   xQueueGenericReceive
+
    • >>   xQueueGenericCreate
+
    • >>   prvNotifyQueueSetContainer
+
    • >>   xTaskResumeAll
+
    • >>   vPortFree
+
    • >>   pvPortMalloc
+
    • >>   APP_Show
+
    • >>   prvTaskExitError
+
    • >>   xTimerGenericCommand
+
    • >>   prvSwitchTimerLists
+
    • >>   prvProcessReceivedCommands
+
    • >>   prvProcessExpiredTimer
+
    • >>   xTimerCreateTimerTask
+
    • >>   xPortStartScheduler
+
    • >>   xTaskIncrementTick
+
    
+
+
    __printf (Thumb, 104 bytes, Stack size 24 bytes, __printf.o(.text))
+

    [Stack]
    • Max Depth = 24 + Unknown Stack Size
+
    • Call Chain = __printf
+
    
+
    [Calls]
    • >>   _printf_percent
+
    
+
    [Called By]
    • >>   _printf_char_common
+
    
+
+
    _printf_str (Thumb, 82 bytes, Stack size 16 bytes, _printf_str.o(.text))
+

    [Stack]
    • Max Depth = 16
    • Call Chain = _printf_str
+
    
+
    [Called By]
    • >>   _printf_cs_common
+
    
+
+
    _printf_int_dec (Thumb, 104 bytes, Stack size 24 bytes, _printf_dec.o(.text))
+

    [Stack]
    • Max Depth = 56
    • Call Chain = _printf_int_dec ⇒ _printf_int_common
+
    
+
    [Calls]
    • >>   _printf_int_common
+
    
+
    [Called By]
    • >>   _printf_d
+
    
+
+
    __aeabi_memcpy (Thumb, 0 bytes, Stack size 0 bytes, rt_memcpy_v6.o(.text))
+

    [Called By]
    • >>   prvCopyDataToQueue
+
    • >>   prvCopyDataFromQueue
+
    
+
+
    __rt_memcpy (Thumb, 138 bytes, Stack size 0 bytes, rt_memcpy_v6.o(.text), UNUSED)
+

    [Calls]
    • >>   __aeabi_memcpy4
+
    
+
+
    _memcpy_lastbytes (Thumb, 0 bytes, Stack size unknown bytes, rt_memcpy_v6.o(.text), UNUSED)
+
+
    __aeabi_memset (Thumb, 16 bytes, Stack size 0 bytes, aeabi_memset.o(.text))
+

    [Calls]
    • >>   _memset
+
    
+
    [Called By]
    • >>   prvInitialiseNewTask
+
    
+
+
    __aeabi_memclr (Thumb, 0 bytes, Stack size 0 bytes, rt_memclr.o(.text))
+

    [Called By]
    • >>   USART2_IRQHandler
+
    
+
+
    __rt_memclr (Thumb, 68 bytes, Stack size 0 bytes, rt_memclr.o(.text), UNUSED)
+

    [Calls]
    • >>   _memset_w
+
    
+
+
    _memset (Thumb, 0 bytes, Stack size unknown bytes, rt_memclr.o(.text))
+

    [Called By]
    • >>   __aeabi_memset
+
    
+
+
    __use_two_region_memory (Thumb, 2 bytes, Stack size 0 bytes, heapauxi.o(.text), UNUSED)
+
+
    __rt_heap_escrow$2region (Thumb, 2 bytes, Stack size 0 bytes, heapauxi.o(.text), UNUSED)
+
+
    __rt_heap_expand$2region (Thumb, 2 bytes, Stack size 0 bytes, heapauxi.o(.text), UNUSED)
+
+
    __I$use$semihosting (Thumb, 0 bytes, Stack size 0 bytes, use_no_semi.o(.text), UNUSED)
+
+
    __use_no_semihosting_swi (Thumb, 2 bytes, Stack size 0 bytes, use_no_semi.o(.text), UNUSED)
+
+
    __read_errno (Thumb, 10 bytes, Stack size 8 bytes, _rserrno.o(.text), UNUSED)
+

    [Calls]
    • >>   __aeabi_errno_addr
+
    
+
+
    __set_errno (Thumb, 12 bytes, Stack size 8 bytes, _rserrno.o(.text))
+

    [Stack]
    • Max Depth = 8
    • Call Chain = __set_errno
+
    
+
    [Calls]
    • >>   __aeabi_errno_addr
+
    
+
    [Called By]
    • >>   __hardfp_tan
+
    • >>   sqrt
+
    • >>   __hardfp_sqrt
+
    • >>   __hardfp_pow
+
    
+
+
    _printf_int_common (Thumb, 178 bytes, Stack size 32 bytes, _printf_intcommon.o(.text))
+

    [Stack]
    • Max Depth = 32
    • Call Chain = _printf_int_common
+
    
+
    [Called By]
    • >>   _printf_int_dec
+
    
+
+
    _printf_char_common (Thumb, 32 bytes, Stack size 64 bytes, _printf_char_common.o(.text))
+

    [Stack]
    • Max Depth = 88 + Unknown Stack Size
+
    • Call Chain = _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   __printf
+
    
+
    [Called By]
    • >>   _printf_char_file
+
    
+
+
    _printf_cs_common (Thumb, 20 bytes, Stack size 8 bytes, _printf_char.o(.text))
+

    [Stack]
    • Max Depth = 24
    • Call Chain = _printf_cs_common ⇒ _printf_str
+
    
+
    [Calls]
    • >>   _printf_str
+
    
+
    [Called By]
    • >>   _printf_string
+
    • >>   _printf_char
+
    
+
+
    _printf_char (Thumb, 16 bytes, Stack size 0 bytes, _printf_char.o(.text), UNUSED)
+

    [Calls]
    • >>   _printf_cs_common
+
    
+
+
    _printf_string (Thumb, 8 bytes, Stack size 0 bytes, _printf_char.o(.text))
+

    [Stack]
    • Max Depth = 24
    • Call Chain = _printf_string ⇒ _printf_cs_common ⇒ _printf_str
+
    
+
    [Calls]
    • >>   _printf_cs_common
+
    
+
    [Called By]
    • >>   _printf_s
+
    
+
+
    _printf_char_file (Thumb, 32 bytes, Stack size 16 bytes, _printf_char_file.o(.text))
+

    [Stack]
    • Max Depth = 104 + Unknown Stack Size
+
    • Call Chain = _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   ferror
+
    • >>   _printf_char_common
+
    
+
    [Called By]
    • >>   __2printf
+
    
+
+
    __aeabi_memcpy4 (Thumb, 0 bytes, Stack size 8 bytes, rt_memcpy_w.o(.text), UNUSED)
+

    [Called By]
    • >>   __rt_memcpy
+
    
+
+
    __aeabi_memcpy8 (Thumb, 0 bytes, Stack size 8 bytes, rt_memcpy_w.o(.text), UNUSED)
+
+
    __rt_memcpy_w (Thumb, 100 bytes, Stack size 8 bytes, rt_memcpy_w.o(.text), UNUSED)
+
+
    _memcpy_lastbytes_aligned (Thumb, 0 bytes, Stack size unknown bytes, rt_memcpy_w.o(.text), UNUSED)
+
+
    __aeabi_memclr4 (Thumb, 0 bytes, Stack size 4 bytes, rt_memclr_w.o(.text), UNUSED)
+
+
    __aeabi_memclr8 (Thumb, 0 bytes, Stack size 4 bytes, rt_memclr_w.o(.text), UNUSED)
+
+
    __rt_memclr_w (Thumb, 78 bytes, Stack size 4 bytes, rt_memclr_w.o(.text), UNUSED)
+
+
    _memset_w (Thumb, 0 bytes, Stack size unknown bytes, rt_memclr_w.o(.text), UNUSED)
+

    [Called By]
    • >>   __rt_memclr
+
    
+
+
    __aeabi_errno_addr (Thumb, 8 bytes, Stack size 0 bytes, rt_errno_addr_intlibspace.o(.text))
+

    [Called By]
    • >>   __set_errno
+
    • >>   __read_errno
+
    
+
+
    __errno$intlibspace (Thumb, 0 bytes, Stack size 0 bytes, rt_errno_addr_intlibspace.o(.text), UNUSED)
+
+
    __rt_errno_addr$intlibspace (Thumb, 0 bytes, Stack size 0 bytes, rt_errno_addr_intlibspace.o(.text), UNUSED)
+
+
    ferror (Thumb, 8 bytes, Stack size 0 bytes, ferror.o(.text))
+

    [Called By]
    • >>   _printf_char_file
+
    
+
+
    __user_libspace (Thumb, 8 bytes, Stack size 0 bytes, libspace.o(.text), UNUSED)
+
+
    __user_perproc_libspace (Thumb, 0 bytes, Stack size 0 bytes, libspace.o(.text))
+

    [Called By]
    • >>   __user_setup_stackheap
+
    
+
+
    __user_perthread_libspace (Thumb, 0 bytes, Stack size 0 bytes, libspace.o(.text), UNUSED)
+
+
    __user_setup_stackheap (Thumb, 74 bytes, Stack size 8 bytes, sys_stackheap_outer.o(.text))
+

    [Stack]
    • Max Depth = 8 + Unknown Stack Size
+
    • Call Chain = __user_setup_stackheap
+
    
+
    [Calls]
    • >>   __user_initial_stackheap
+
    • >>   __user_perproc_libspace
+
    
+
    [Called By]
    • >>   __rt_entry_sh
+
    
+
+
    exit (Thumb, 18 bytes, Stack size 8 bytes, exit.o(.text))
+

    [Stack]
    • Max Depth = 8 + Unknown Stack Size
+
    • Call Chain = exit
+
    
+
    [Calls]
    • >>   __rt_exit
+
    
+
    [Called By]
    • >>   __rt_entry_main
+
    
+
+
    ADC_Cmd (Thumb, 22 bytes, Stack size 0 bytes, stm32f4xx_adc.o(i.ADC_Cmd))
+

    [Called By]
    • >>   Adc_POWER_Init
+
    • >>   Adc_Init
+
    
+
+
    ADC_CommonInit (Thumb, 34 bytes, Stack size 0 bytes, stm32f4xx_adc.o(i.ADC_CommonInit))
+

    [Called By]
    • >>   Adc_POWER_Init
+
    • >>   Adc_Init
+
    
+
+
    ADC_GetConversionValue (Thumb, 8 bytes, Stack size 0 bytes, stm32f4xx_adc.o(i.ADC_GetConversionValue))
+

    [Called By]
    • >>   Get_Adc2
+
    • >>   Get_Adc
+
    
+
+
    ADC_GetFlagStatus (Thumb, 18 bytes, Stack size 0 bytes, stm32f4xx_adc.o(i.ADC_GetFlagStatus))
+

    [Called By]
    • >>   Get_Adc2
+
    • >>   Get_Adc
+
    
+
+
    ADC_Init (Thumb, 74 bytes, Stack size 12 bytes, stm32f4xx_adc.o(i.ADC_Init))
+

    [Stack]
    • Max Depth = 12
    • Call Chain = ADC_Init
+
    
+
    [Called By]
    • >>   Adc_POWER_Init
+
    • >>   Adc_Init
+
    
+
+
    ADC_RegularChannelConfig (Thumb, 184 bytes, Stack size 20 bytes, stm32f4xx_adc.o(i.ADC_RegularChannelConfig))
+

    [Stack]
    • Max Depth = 20
    • Call Chain = ADC_RegularChannelConfig
+
    
+
    [Called By]
    • >>   Get_Adc2
+
    • >>   Get_Adc
+
    
+
+
    ADC_SoftwareStartConv (Thumb, 10 bytes, Stack size 0 bytes, stm32f4xx_adc.o(i.ADC_SoftwareStartConv))
+

    [Called By]
    • >>   Get_Adc2
+
    • >>   Get_Adc
+
    
+
+
    APP_Show (Thumb, 228 bytes, Stack size 24 bytes, show.o(i.APP_Show))
+

    [Stack]
    • Max Depth = 152 + Unknown Stack Size
+
    • Call Chain = APP_Show ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   __2printf
+
    
+
    [Called By]
    • >>   show_task
+
    
+
+
    Adc_Init (Thumb, 124 bytes, Stack size 56 bytes, adc.o(i.Adc_Init))
+

    [Stack]
    • Max Depth = 76
    • Call Chain = Adc_Init ⇒ GPIO_Init
+
    
+
    [Calls]
    • >>   RCC_APB2PeriphResetCmd
+
    • >>   RCC_APB2PeriphClockCmd
+
    • >>   RCC_AHB1PeriphClockCmd
+
    • >>   GPIO_Init
+
    • >>   ADC_Init
+
    • >>   ADC_CommonInit
+
    • >>   ADC_Cmd
+
    
+
    [Called By]
    • >>   systemInit
+
    
+
+
    Adc_POWER_Init (Thumb, 124 bytes, Stack size 56 bytes, adc.o(i.Adc_POWER_Init))
+

    [Stack]
    • Max Depth = 76
    • Call Chain = Adc_POWER_Init ⇒ GPIO_Init
+
    
+
    [Calls]
    • >>   RCC_APB2PeriphResetCmd
+
    • >>   RCC_APB2PeriphClockCmd
+
    • >>   RCC_AHB1PeriphClockCmd
+
    • >>   GPIO_Init
+
    • >>   ADC_Init
+
    • >>   ADC_CommonInit
+
    • >>   ADC_Cmd
+
    
+
    [Called By]
    • >>   systemInit
+
    
+
+
    Balance_task (Thumb, 724 bytes, Stack size 16 bytes, balance.o(i.Balance_task))
+

    [Stack]
    • Max Depth = 416 + Unknown Stack Size
+
    • Call Chain = Balance_task ⇒ Remote_Control ⇒ Drive_Motor ⇒ __hardfp_pow ⇒ sqrt ⇒ _dsqrt ⇒ __fpl_dnaninf
+
    
+
    [Calls]
    • >>   vTaskDelayUntil
+
    • >>   getSysTickCnt
+
    • >>   Turn_Off
+
    • >>   Set_Pwm
+
    • >>   Remote_Control
+
    • >>   PS2_control
+
    • >>   Limit_Pwm
+
    • >>   Key
+
    • >>   Incremental_PI_D
+
    • >>   Incremental_PI_C
+
    • >>   Incremental_PI_B
+
    • >>   Incremental_PI_A
+
    • >>   Get_Velocity_Form_Encoder
+
    • >>   Get_RC
+
    • >>   Drive_Motor
+
    
+
    [Address Reference Count : 1]
    •  main.o(i.start_task)
+
    
+
    BusFault_Handler (Thumb, 4 bytes, Stack size 0 bytes, stm32f4xx_it.o(i.BusFault_Handler))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    Buzzer_Init (Thumb, 50 bytes, Stack size 16 bytes, led.o(i.Buzzer_Init))
+

    [Stack]
    • Max Depth = 36
    • Call Chain = Buzzer_Init ⇒ GPIO_Init
+
    
+
    [Calls]
    • >>   RCC_AHB1PeriphClockCmd
+
    • >>   GPIO_Init
+
    
+
    [Called By]
    • >>   systemInit
+
    
+
+
    CAN1_Mode_Init (Thumb, 488 bytes, Stack size 40 bytes, can.o(i.CAN1_Mode_Init))
+

    [Stack]
    • Max Depth = 60
    • Call Chain = CAN1_Mode_Init ⇒ GPIO_PinAFConfig
+
    
+
    [Calls]
    • >>   RCC_APB1PeriphClockCmd
+
    • >>   NVIC_Init
+
    • >>   GPIO_PinAFConfig
+
    • >>   CAN_ITConfig
+
    • >>   RCC_AHB1PeriphClockCmd
+
    • >>   GPIO_Init
+
    
+
    [Called By]
    • >>   systemInit
+
    
+
+
    CAN1_RX0_IRQHandler (Thumb, 252 bytes, Stack size 48 bytes, can.o(i.CAN1_RX0_IRQHandler))
+

    [Stack]
    • Max Depth = 232
    • Call Chain = CAN1_RX0_IRQHandler ⇒ Vz_to_Akm_Angle ⇒ __hardfp_atan ⇒ __kernel_poly ⇒ __aeabi_dmul
+
    
+
    [Calls]
    • >>   Vz_to_Akm_Angle
+
    • >>   CAN1_Rx_Msg
+
    
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    CAN1_Rx_Msg (Thumb, 208 bytes, Stack size 20 bytes, can.o(i.CAN1_Rx_Msg))
+

    [Stack]
    • Max Depth = 20
    • Call Chain = CAN1_Rx_Msg
+
    
+
    [Called By]
    • >>   CAN1_RX0_IRQHandler
+
    
+
+
    CAN1_Send_Num (Thumb, 64 bytes, Stack size 24 bytes, can.o(i.CAN1_Send_Num))
+

    [Stack]
    • Max Depth = 44
    • Call Chain = CAN1_Send_Num ⇒ CAN1_Tx_Msg
+
    
+
    [Calls]
    • >>   CAN1_Tx_Staus
+
    • >>   CAN1_Tx_Msg
+
    
+
    [Called By]
    • >>   CAN_SEND
+
    
+
+
    CAN1_Tx_Msg (Thumb, 260 bytes, Stack size 20 bytes, can.o(i.CAN1_Tx_Msg))
+

    [Stack]
    • Max Depth = 20
    • Call Chain = CAN1_Tx_Msg
+
    
+
    [Called By]
    • >>   CAN1_Send_Num
+
    
+
+
    CAN1_Tx_Staus (Thumb, 126 bytes, Stack size 0 bytes, can.o(i.CAN1_Tx_Staus))
+

    [Called By]
    • >>   CAN1_Send_Num
+
    
+
+
    CAN_ITConfig (Thumb, 18 bytes, Stack size 0 bytes, stm32f4xx_can.o(i.CAN_ITConfig))
+

    [Called By]
    • >>   CAN1_Mode_Init
+
    
+
+
    CAN_SEND (Thumb, 102 bytes, Stack size 16 bytes, usartx.o(i.CAN_SEND))
+

    [Stack]
    • Max Depth = 60
    • Call Chain = CAN_SEND ⇒ CAN1_Send_Num ⇒ CAN1_Tx_Msg
+
    
+
    [Calls]
    • >>   CAN1_Send_Num
+
    
+
    [Called By]
    • >>   data_task
+
    
+
+
    Check_Sum (Thumb, 52 bytes, Stack size 8 bytes, usartx.o(i.Check_Sum))
+

    [Stack]
    • Max Depth = 8
    • Call Chain = Check_Sum
+
    
+
    [Called By]
    • >>   data_transition
+
    • >>   USART3_IRQHandler
+
    • >>   UART5_IRQHandler
+
    
+
+
    DebugMon_Handler (Thumb, 2 bytes, Stack size 0 bytes, stm32f4xx_it.o(i.DebugMon_Handler))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    Drive_Motor (Thumb, 1992 bytes, Stack size 104 bytes, balance.o(i.Drive_Motor))
+

    [Stack]
    • Max Depth = 368
    • Call Chain = Drive_Motor ⇒ __hardfp_pow ⇒ sqrt ⇒ _dsqrt ⇒ __fpl_dnaninf
+
    
+
    [Calls]
    • >>   target_limit_int
+
    • >>   target_limit_float
+
    • >>   Smooth_control
+
    • >>   __hardfp_tan
+
    • >>   __hardfp_sqrt
+
    • >>   __hardfp_pow
+
    • >>   __aeabi_f2d
+
    • >>   __aeabi_dmul
+
    • >>   __aeabi_ddiv
+
    • >>   __aeabi_dsub
+
    • >>   __aeabi_dadd
+
    • >>   __aeabi_d2f
+
    • >>   __aeabi_dneg
+
    
+
    [Called By]
    • >>   Balance_task
+
    • >>   Remote_Control
+
    • >>   PS2_control
+
    • >>   Get_RC
+
    
+
+
    Enable_Pin (Thumb, 42 bytes, Stack size 16 bytes, motor.o(i.Enable_Pin))
+

    [Stack]
    • Max Depth = 36
    • Call Chain = Enable_Pin ⇒ GPIO_Init
+
    
+
    [Calls]
    • >>   RCC_AHB1PeriphClockCmd
+
    • >>   GPIO_Init
+
    
+
    [Called By]
    • >>   systemInit
+
    
+
+
    Encoder_Init_TIM2 (Thumb, 224 bytes, Stack size 40 bytes, encoder.o(i.Encoder_Init_TIM2))
+

    [Stack]
    • Max Depth = 76
    • Call Chain = Encoder_Init_TIM2 ⇒ TIM_ICInit ⇒ TI4_Config
+
    
+
    [Calls]
    • >>   TIM_TimeBaseStructInit
+
    • >>   TIM_TimeBaseInit
+
    • >>   TIM_SetCounter
+
    • >>   TIM_ITConfig
+
    • >>   TIM_ICStructInit
+
    • >>   TIM_ICInit
+
    • >>   TIM_EncoderInterfaceConfig
+
    • >>   TIM_Cmd
+
    • >>   TIM_ClearFlag
+
    • >>   RCC_APB1PeriphClockCmd
+
    • >>   GPIO_PinAFConfig
+
    • >>   RCC_AHB1PeriphClockCmd
+
    • >>   GPIO_Init
+
    
+
    [Called By]
    • >>   systemInit
+
    
+
+
    Encoder_Init_TIM3 (Thumb, 180 bytes, Stack size 40 bytes, encoder.o(i.Encoder_Init_TIM3))
+

    [Stack]
    • Max Depth = 76
    • Call Chain = Encoder_Init_TIM3 ⇒ TIM_ICInit ⇒ TI4_Config
+
    
+
    [Calls]
    • >>   TIM_TimeBaseStructInit
+
    • >>   TIM_TimeBaseInit
+
    • >>   TIM_SetCounter
+
    • >>   TIM_ITConfig
+
    • >>   TIM_ICStructInit
+
    • >>   TIM_ICInit
+
    • >>   TIM_EncoderInterfaceConfig
+
    • >>   TIM_Cmd
+
    • >>   TIM_ClearFlag
+
    • >>   RCC_APB1PeriphClockCmd
+
    • >>   GPIO_PinAFConfig
+
    • >>   RCC_AHB1PeriphClockCmd
+
    • >>   GPIO_Init
+
    
+
    [Called By]
    • >>   systemInit
+
    
+
+
    Encoder_Init_TIM4 (Thumb, 180 bytes, Stack size 40 bytes, encoder.o(i.Encoder_Init_TIM4))
+

    [Stack]
    • Max Depth = 76
    • Call Chain = Encoder_Init_TIM4 ⇒ TIM_ICInit ⇒ TI4_Config
+
    
+
    [Calls]
    • >>   TIM_TimeBaseStructInit
+
    • >>   TIM_TimeBaseInit
+
    • >>   TIM_SetCounter
+
    • >>   TIM_ITConfig
+
    • >>   TIM_ICStructInit
+
    • >>   TIM_ICInit
+
    • >>   TIM_EncoderInterfaceConfig
+
    • >>   TIM_Cmd
+
    • >>   TIM_ClearFlag
+
    • >>   RCC_APB1PeriphClockCmd
+
    • >>   GPIO_PinAFConfig
+
    • >>   RCC_AHB1PeriphClockCmd
+
    • >>   GPIO_Init
+
    
+
    [Called By]
    • >>   systemInit
+
    
+
+
    Encoder_Init_TIM5 (Thumb, 178 bytes, Stack size 40 bytes, encoder.o(i.Encoder_Init_TIM5))
+

    [Stack]
    • Max Depth = 76
    • Call Chain = Encoder_Init_TIM5 ⇒ TIM_ICInit ⇒ TI4_Config
+
    
+
    [Calls]
    • >>   TIM_TimeBaseStructInit
+
    • >>   TIM_TimeBaseInit
+
    • >>   TIM_SetCounter
+
    • >>   TIM_ITConfig
+
    • >>   TIM_ICStructInit
+
    • >>   TIM_ICInit
+
    • >>   TIM_EncoderInterfaceConfig
+
    • >>   TIM_Cmd
+
    • >>   TIM_ClearFlag
+
    • >>   RCC_APB1PeriphClockCmd
+
    • >>   GPIO_PinAFConfig
+
    • >>   RCC_AHB1PeriphClockCmd
+
    • >>   GPIO_Init
+
    
+
    [Called By]
    • >>   systemInit
+
    
+
+
    GPIO_Init (Thumb, 144 bytes, Stack size 20 bytes, stm32f4xx_gpio.o(i.GPIO_Init))
+

    [Stack]
    • Max Depth = 20
    • Call Chain = GPIO_Init
+
    
+
    [Called By]
    • >>   TIM9_PWM_Init
+
    • >>   TIM1_PWM_Init
+
    • >>   TIM11_PWM_Init
+
    • >>   TIM10_PWM_Init
+
    • >>   Enable_Pin
+
    • >>   LED_Init
+
    • >>   Buzzer_Init
+
    • >>   KEY_Init
+
    • >>   Encoder_Init_TIM5
+
    • >>   Encoder_Init_TIM4
+
    • >>   Encoder_Init_TIM3
+
    • >>   Encoder_Init_TIM2
+
    • >>   CAN1_Mode_Init
+
    • >>   Adc_POWER_Init
+
    • >>   Adc_Init
+
    • >>   uart5_init
+
    • >>   uart3_init
+
    • >>   uart2_init
+
    • >>   uart1_init
+
    • >>   TIM8_Cap_Init
+
    • >>   TIM12_SERVO_Init
+
    • >>   PS2_Init
+
    • >>   OLED_Init
+
    • >>   I2C_GPIOInit
+
    
+
+
    GPIO_PinAFConfig (Thumb, 70 bytes, Stack size 20 bytes, stm32f4xx_gpio.o(i.GPIO_PinAFConfig))
+

    [Stack]
    • Max Depth = 20
    • Call Chain = GPIO_PinAFConfig
+
    
+
    [Called By]
    • >>   TIM9_PWM_Init
+
    • >>   TIM1_PWM_Init
+
    • >>   TIM11_PWM_Init
+
    • >>   TIM10_PWM_Init
+
    • >>   Encoder_Init_TIM5
+
    • >>   Encoder_Init_TIM4
+
    • >>   Encoder_Init_TIM3
+
    • >>   Encoder_Init_TIM2
+
    • >>   CAN1_Mode_Init
+
    • >>   uart5_init
+
    • >>   uart3_init
+
    • >>   uart2_init
+
    • >>   uart1_init
+
    • >>   TIM8_Cap_Init
+
    • >>   TIM12_SERVO_Init
+
    
+
+
    GPIO_SetBits (Thumb, 4 bytes, Stack size 0 bytes, stm32f4xx_gpio.o(i.GPIO_SetBits))
+

    [Called By]
    • >>   LED_Init
+
    
+
+
    Get_Adc (Thumb, 44 bytes, Stack size 8 bytes, adc.o(i.Get_Adc))
+

    [Stack]
    • Max Depth = 28
    • Call Chain = Get_Adc ⇒ ADC_RegularChannelConfig
+
    
+
    [Calls]
    • >>   ADC_SoftwareStartConv
+
    • >>   ADC_RegularChannelConfig
+
    • >>   ADC_GetFlagStatus
+
    • >>   ADC_GetConversionValue
+
    
+
    [Called By]
    • >>   Get_adc_Average
+
    
+
+
    Get_Adc2 (Thumb, 44 bytes, Stack size 8 bytes, adc.o(i.Get_Adc2))
+

    [Stack]
    • Max Depth = 28
    • Call Chain = Get_Adc2 ⇒ ADC_RegularChannelConfig
+
    
+
    [Calls]
    • >>   ADC_SoftwareStartConv
+
    • >>   ADC_RegularChannelConfig
+
    • >>   ADC_GetFlagStatus
+
    • >>   ADC_GetConversionValue
+
    
+
    [Called By]
    • >>   Get_battery_volt
+
    
+
+
    Get_RC (Thumb, 874 bytes, Stack size 8 bytes, balance.o(i.Get_RC))
+

    [Stack]
    • Max Depth = 376
    • Call Chain = Get_RC ⇒ Drive_Motor ⇒ __hardfp_pow ⇒ sqrt ⇒ _dsqrt ⇒ __fpl_dnaninf
+
    
+
    [Calls]
    • >>   Drive_Motor
+
    
+
    [Called By]
    • >>   Balance_task
+
    
+
+
    Get_Velocity_Form_Encoder (Thumb, 484 bytes, Stack size 24 bytes, balance.o(i.Get_Velocity_Form_Encoder))
+

    [Stack]
    • Max Depth = 24
    • Call Chain = Get_Velocity_Form_Encoder
+
    
+
    [Calls]
    • >>   Read_Encoder
+
    
+
    [Called By]
    • >>   Balance_task
+
    
+
+
    Get_adc_Average (Thumb, 46 bytes, Stack size 24 bytes, adc.o(i.Get_adc_Average))
+

    [Stack]
    • Max Depth = 224 + Unknown Stack Size
+
    • Call Chain = Get_adc_Average ⇒ delay_ms ⇒ vTaskDelay ⇒ xTaskResumeAll ⇒ xTaskIncrementTick ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   delay_ms
+
    • >>   Get_Adc
+
    
+
    [Called By]
    • >>   oled_show
+
    • >>   Robot_Select
+
    
+
+
    Get_battery_volt (Thumb, 120 bytes, Stack size 64 bytes, adc.o(i.Get_battery_volt))
+

    [Stack]
    • Max Depth = 96
    • Call Chain = Get_battery_volt ⇒ __aeabi_dmul
+
    
+
    [Calls]
    • >>   Get_Adc2
+
    • >>   __aeabi_dmul
+
    • >>   __aeabi_ui2d
+
    • >>   __aeabi_ddiv
+
    • >>   __aeabi_d2f
+
    
+
    [Called By]
    • >>   show_task
+
    
+
+
    HardFault_Handler (Thumb, 4 bytes, Stack size 0 bytes, stm32f4xx_it.o(i.HardFault_Handler))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    I2C_Ack (Thumb, 64 bytes, Stack size 8 bytes, i2c.o(i.I2C_Ack))
+

    [Stack]
    • Max Depth = 24
    • Call Chain = I2C_Ack ⇒ delay_us
+
    
+
    [Calls]
    • >>   delay_us
+
    
+
    [Called By]
    • >>   I2C_ReadByte
+
    
+
+
    I2C_GPIOInit (Thumb, 62 bytes, Stack size 16 bytes, i2c.o(i.I2C_GPIOInit))
+

    [Stack]
    • Max Depth = 36
    • Call Chain = I2C_GPIOInit ⇒ GPIO_Init
+
    
+
    [Calls]
    • >>   RCC_AHB1PeriphClockCmd
+
    • >>   GPIO_Init
+
    
+
    [Called By]
    • >>   systemInit
+
    
+
+
    I2C_NAck (Thumb, 62 bytes, Stack size 8 bytes, i2c.o(i.I2C_NAck))
+

    [Stack]
    • Max Depth = 24
    • Call Chain = I2C_NAck ⇒ delay_us
+
    
+
    [Calls]
    • >>   delay_us
+
    
+
    [Called By]
    • >>   I2C_ReadByte
+
    
+
+
    I2C_ReadByte (Thumb, 100 bytes, Stack size 16 bytes, i2c.o(i.I2C_ReadByte))
+

    [Stack]
    • Max Depth = 40
    • Call Chain = I2C_ReadByte ⇒ I2C_NAck ⇒ delay_us
+
    
+
    [Calls]
    • >>   delay_us
+
    • >>   I2C_NAck
+
    • >>   I2C_Ack
+
    
+
    [Called By]
    • >>   I2C_ReadOneByte
+
    
+
+
    I2C_ReadOneByte (Thumb, 64 bytes, Stack size 16 bytes, i2c.o(i.I2C_ReadOneByte))
+

    [Stack]
    • Max Depth = 56
    • Call Chain = I2C_ReadOneByte ⇒ I2C_ReadByte ⇒ I2C_NAck ⇒ delay_us
+
    
+
    [Calls]
    • >>   I2C_WriteByte
+
    • >>   I2C_WaiteForAck
+
    • >>   I2C_Stop
+
    • >>   I2C_Start
+
    • >>   I2C_ReadByte
+
    
+
    [Called By]
    • >>   I2C_WriteBits
+
    • >>   MPU_Get_Gyroscope
+
    • >>   MPU_Get_Accelscope
+
    • >>   MPU6050_initialize
+
    
+
+
    I2C_Start (Thumb, 88 bytes, Stack size 8 bytes, i2c.o(i.I2C_Start))
+

    [Stack]
    • Max Depth = 24
    • Call Chain = I2C_Start ⇒ delay_us
+
    
+
    [Calls]
    • >>   delay_us
+
    
+
    [Called By]
    • >>   I2C_WriteOneByte
+
    • >>   I2C_ReadOneByte
+
    
+
+
    I2C_Stop (Thumb, 60 bytes, Stack size 8 bytes, i2c.o(i.I2C_Stop))
+

    [Stack]
    • Max Depth = 24
    • Call Chain = I2C_Stop ⇒ delay_us
+
    
+
    [Calls]
    • >>   delay_us
+
    
+
    [Called By]
    • >>   I2C_WaiteForAck
+
    • >>   I2C_WriteOneByte
+
    • >>   I2C_ReadOneByte
+
    
+
+
    I2C_WaiteForAck (Thumb, 88 bytes, Stack size 8 bytes, i2c.o(i.I2C_WaiteForAck))
+

    [Stack]
    • Max Depth = 32
    • Call Chain = I2C_WaiteForAck ⇒ I2C_Stop ⇒ delay_us
+
    
+
    [Calls]
    • >>   delay_us
+
    • >>   I2C_Stop
+
    
+
    [Called By]
    • >>   I2C_WriteOneByte
+
    • >>   I2C_ReadOneByte
+
    
+
+
    I2C_WriteBits (Thumb, 88 bytes, Stack size 32 bytes, i2c.o(i.I2C_WriteBits))
+

    [Stack]
    • Max Depth = 88
    • Call Chain = I2C_WriteBits ⇒ I2C_ReadOneByte ⇒ I2C_ReadByte ⇒ I2C_NAck ⇒ delay_us
+
    
+
    [Calls]
    • >>   I2C_WriteOneByte
+
    • >>   I2C_ReadOneByte
+
    
+
    [Called By]
    • >>   MPU6050_setFullScaleGyroRange
+
    • >>   MPU6050_setFullScaleAccelRange
+
    
+
+
    I2C_WriteByte (Thumb, 88 bytes, Stack size 16 bytes, i2c.o(i.I2C_WriteByte))
+

    [Stack]
    • Max Depth = 32
    • Call Chain = I2C_WriteByte ⇒ delay_us
+
    
+
    [Calls]
    • >>   delay_us
+
    
+
    [Called By]
    • >>   I2C_WriteOneByte
+
    • >>   I2C_ReadOneByte
+
    
+
+
    I2C_WriteOneByte (Thumb, 50 bytes, Stack size 16 bytes, i2c.o(i.I2C_WriteOneByte))
+

    [Stack]
    • Max Depth = 48
    • Call Chain = I2C_WriteOneByte ⇒ I2C_WriteByte ⇒ delay_us
+
    
+
    [Calls]
    • >>   I2C_WriteByte
+
    • >>   I2C_WaiteForAck
+
    • >>   I2C_Stop
+
    • >>   I2C_Start
+
    
+
    [Called By]
    • >>   I2C_WriteBits
+
    • >>   MPU6050_Set_Rate
+
    • >>   MPU6050_Set_LPF
+
    • >>   MPU6050_initialize
+
    
+
+
    Incremental_PI_A (Thumb, 146 bytes, Stack size 0 bytes, balance.o(i.Incremental_PI_A))
+

    [Called By]
    • >>   Balance_task
+
    
+
+
    Incremental_PI_B (Thumb, 146 bytes, Stack size 0 bytes, balance.o(i.Incremental_PI_B))
+

    [Called By]
    • >>   Balance_task
+
    
+
+
    Incremental_PI_C (Thumb, 146 bytes, Stack size 0 bytes, balance.o(i.Incremental_PI_C))
+

    [Called By]
    • >>   Balance_task
+
    
+
+
    Incremental_PI_D (Thumb, 146 bytes, Stack size 0 bytes, balance.o(i.Incremental_PI_D))
+

    [Called By]
    • >>   Balance_task
+
    
+
+
    KEY_Init (Thumb, 42 bytes, Stack size 16 bytes, key.o(i.KEY_Init))
+

    [Stack]
    • Max Depth = 36
    • Call Chain = KEY_Init ⇒ GPIO_Init
+
    
+
    [Calls]
    • >>   RCC_AHB1PeriphClockCmd
+
    • >>   GPIO_Init
+
    
+
    [Called By]
    • >>   systemInit
+
    
+
+
    Key (Thumb, 40 bytes, Stack size 8 bytes, balance.o(i.Key))
+

    [Stack]
    • Max Depth = 8
    • Call Chain = Key
+
    
+
    [Calls]
    • >>   click_N_Double_MPU6050
+
    
+
    [Called By]
    • >>   Balance_task
+
    
+
+
    LED_Init (Thumb, 60 bytes, Stack size 16 bytes, led.o(i.LED_Init))
+

    [Stack]
    • Max Depth = 36
    • Call Chain = LED_Init ⇒ GPIO_Init
+
    
+
    [Calls]
    • >>   GPIO_SetBits
+
    • >>   RCC_AHB1PeriphClockCmd
+
    • >>   GPIO_Init
+
    
+
    [Called By]
    • >>   systemInit
+
    
+
+
    Limit_Pwm (Thumb, 156 bytes, Stack size 4 bytes, balance.o(i.Limit_Pwm))
+

    [Stack]
    • Max Depth = 4
    • Call Chain = Limit_Pwm
+
    
+
    [Calls]
    • >>   target_limit_float
+
    
+
    [Called By]
    • >>   Balance_task
+
    
+
+
    MPU6050_Set_LPF (Thumb, 60 bytes, Stack size 16 bytes, mpu6050.o(i.MPU6050_Set_LPF))
+

    [Stack]
    • Max Depth = 64
    • Call Chain = MPU6050_Set_LPF ⇒ I2C_WriteOneByte ⇒ I2C_WriteByte ⇒ delay_us
+
    
+
    [Calls]
    • >>   I2C_WriteOneByte
+
    
+
    [Called By]
    • >>   MPU6050_Set_Rate
+
    
+
+
    MPU6050_Set_Rate (Thumb, 60 bytes, Stack size 16 bytes, mpu6050.o(i.MPU6050_Set_Rate))
+

    [Stack]
    • Max Depth = 80
    • Call Chain = MPU6050_Set_Rate ⇒ MPU6050_Set_LPF ⇒ I2C_WriteOneByte ⇒ I2C_WriteByte ⇒ delay_us
+
    
+
    [Calls]
    • >>   I2C_WriteOneByte
+
    • >>   MPU6050_Set_LPF
+
    
+
    [Called By]
    • >>   MPU6050_initialize
+
    
+
+
    MPU6050_initialize (Thumb, 136 bytes, Stack size 8 bytes, mpu6050.o(i.MPU6050_initialize))
+

    [Stack]
    • Max Depth = 208 + Unknown Stack Size
+
    • Call Chain = MPU6050_initialize ⇒ delay_ms ⇒ vTaskDelay ⇒ xTaskResumeAll ⇒ xTaskIncrementTick ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   delay_ms
+
    • >>   I2C_WriteOneByte
+
    • >>   I2C_ReadOneByte
+
    • >>   MPU6050_setFullScaleGyroRange
+
    • >>   MPU6050_setFullScaleAccelRange
+
    • >>   MPU6050_Set_Rate
+
    
+
    [Called By]
    • >>   systemInit
+
    
+
+
    MPU6050_setFullScaleAccelRange (Thumb, 20 bytes, Stack size 16 bytes, mpu6050.o(i.MPU6050_setFullScaleAccelRange))
+

    [Stack]
    • Max Depth = 104
    • Call Chain = MPU6050_setFullScaleAccelRange ⇒ I2C_WriteBits ⇒ I2C_ReadOneByte ⇒ I2C_ReadByte ⇒ I2C_NAck ⇒ delay_us
+
    
+
    [Calls]
    • >>   I2C_WriteBits
+
    
+
    [Called By]
    • >>   MPU6050_initialize
+
    
+
+
    MPU6050_setFullScaleGyroRange (Thumb, 20 bytes, Stack size 16 bytes, mpu6050.o(i.MPU6050_setFullScaleGyroRange))
+

    [Stack]
    • Max Depth = 104
    • Call Chain = MPU6050_setFullScaleGyroRange ⇒ I2C_WriteBits ⇒ I2C_ReadOneByte ⇒ I2C_ReadByte ⇒ I2C_NAck ⇒ delay_us
+
    
+
    [Calls]
    • >>   I2C_WriteBits
+
    
+
    [Called By]
    • >>   MPU6050_initialize
+
    
+
+
    MPU6050_task (Thumb, 190 bytes, Stack size 8 bytes, mpu6050.o(i.MPU6050_task))
+

    [Stack]
    • Max Depth = 208 + Unknown Stack Size
+
    • Call Chain = MPU6050_task ⇒ vTaskDelayUntil ⇒ xTaskResumeAll ⇒ xTaskIncrementTick ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   vTaskDelayUntil
+
    • >>   getSysTickCnt
+
    • >>   MPU_Get_Gyroscope
+
    • >>   MPU_Get_Accelscope
+
    
+
    [Address Reference Count : 1]
    •  main.o(i.start_task)
+
    
+
    MPU_Get_Accelscope (Thumb, 170 bytes, Stack size 8 bytes, mpu6050.o(i.MPU_Get_Accelscope))
+

    [Stack]
    • Max Depth = 64
    • Call Chain = MPU_Get_Accelscope ⇒ I2C_ReadOneByte ⇒ I2C_ReadByte ⇒ I2C_NAck ⇒ delay_us
+
    
+
    [Calls]
    • >>   I2C_ReadOneByte
+
    
+
    [Called By]
    • >>   MPU6050_task
+
    
+
+
    MPU_Get_Gyroscope (Thumb, 202 bytes, Stack size 8 bytes, mpu6050.o(i.MPU_Get_Gyroscope))
+

    [Stack]
    • Max Depth = 64
    • Call Chain = MPU_Get_Gyroscope ⇒ I2C_ReadOneByte ⇒ I2C_ReadByte ⇒ I2C_NAck ⇒ delay_us
+
    
+
    [Calls]
    • >>   I2C_ReadOneByte
+
    
+
    [Called By]
    • >>   MPU6050_task
+
    
+
+
    MemManage_Handler (Thumb, 4 bytes, Stack size 0 bytes, stm32f4xx_it.o(i.MemManage_Handler))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    NMI_Handler (Thumb, 2 bytes, Stack size 0 bytes, stm32f4xx_it.o(i.NMI_Handler))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    NVIC_Init (Thumb, 106 bytes, Stack size 16 bytes, misc.o(i.NVIC_Init))
+

    [Stack]
    • Max Depth = 16
    • Call Chain = NVIC_Init
+
    
+
    [Called By]
    • >>   CAN1_Mode_Init
+
    • >>   uart5_init
+
    • >>   uart3_init
+
    • >>   uart2_init
+
    • >>   uart1_init
+
    • >>   TIM8_Cap_Init
+
    
+
+
    NVIC_PriorityGroupConfig (Thumb, 10 bytes, Stack size 0 bytes, misc.o(i.NVIC_PriorityGroupConfig))
+

    [Called By]
    • >>   systemInit
+
    
+
+
    OLED_Clear (Thumb, 42 bytes, Stack size 12 bytes, oled.o(i.OLED_Clear))
+

    [Stack]
    • Max Depth = 32
    • Call Chain = OLED_Clear ⇒ OLED_Refresh_Gram ⇒ OLED_WR_Byte
+
    
+
    [Calls]
    • >>   OLED_Refresh_Gram
+
    
+
    [Called By]
    • >>   OLED_ShowString
+
    • >>   OLED_Init
+
    
+
+
    OLED_DrawPoint (Thumb, 100 bytes, Stack size 20 bytes, oled.o(i.OLED_DrawPoint))
+

    [Stack]
    • Max Depth = 20
    • Call Chain = OLED_DrawPoint
+
    
+
    [Called By]
    • >>   OLED_ShowChar
+
    
+
+
    OLED_Init (Thumb, 296 bytes, Stack size 16 bytes, oled.o(i.OLED_Init))
+

    [Stack]
    • Max Depth = 216 + Unknown Stack Size
+
    • Call Chain = OLED_Init ⇒ delay_ms ⇒ vTaskDelay ⇒ xTaskResumeAll ⇒ xTaskIncrementTick ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   RCC_APB1PeriphClockCmd
+
    • >>   delay_ms
+
    • >>   RCC_AHB1PeriphClockCmd
+
    • >>   GPIO_Init
+
    • >>   RCC_LSEConfig
+
    • >>   PWR_BackupAccessCmd
+
    • >>   OLED_WR_Byte
+
    • >>   OLED_Clear
+
    
+
    [Called By]
    • >>   systemInit
+
    
+
+
    OLED_Refresh_Gram (Thumb, 70 bytes, Stack size 12 bytes, oled.o(i.OLED_Refresh_Gram))
+

    [Stack]
    • Max Depth = 20
    • Call Chain = OLED_Refresh_Gram ⇒ OLED_WR_Byte
+
    
+
    [Calls]
    • >>   OLED_WR_Byte
+
    
+
    [Called By]
    • >>   OLED_Clear
+
    • >>   oled_show
+
    
+
+
    OLED_ShowChar (Thumb, 158 bytes, Stack size 36 bytes, oled.o(i.OLED_ShowChar))
+

    [Stack]
    • Max Depth = 56
    • Call Chain = OLED_ShowChar ⇒ OLED_DrawPoint
+
    
+
    [Calls]
    • >>   OLED_DrawPoint
+
    
+
    [Called By]
    • >>   OLED_ShowString
+
    • >>   OLED_ShowNumber
+
    
+
+
    OLED_ShowNumber (Thumb, 148 bytes, Stack size 56 bytes, oled.o(i.OLED_ShowNumber))
+

    [Stack]
    • Max Depth = 112
    • Call Chain = OLED_ShowNumber ⇒ OLED_ShowChar ⇒ OLED_DrawPoint
+
    
+
    [Calls]
    • >>   oled_pow
+
    • >>   OLED_ShowChar
+
    
+
    [Called By]
    • >>   oled_show
+
    
+
+
    OLED_ShowString (Thumb, 68 bytes, Stack size 20 bytes, oled.o(i.OLED_ShowString))
+

    [Stack]
    • Max Depth = 76
    • Call Chain = OLED_ShowString ⇒ OLED_ShowChar ⇒ OLED_DrawPoint
+
    
+
    [Calls]
    • >>   OLED_ShowChar
+
    • >>   OLED_Clear
+
    
+
    [Called By]
    • >>   oled_show
+
    
+
+
    OLED_WR_Byte (Thumb, 82 bytes, Stack size 8 bytes, oled.o(i.OLED_WR_Byte))
+

    [Stack]
    • Max Depth = 8
    • Call Chain = OLED_WR_Byte
+
    
+
    [Called By]
    • >>   OLED_Refresh_Gram
+
    • >>   OLED_Init
+
    
+
+
    PS2_AnologData (Thumb, 8 bytes, Stack size 0 bytes, pstwo.o(i.PS2_AnologData))
+

    [Called By]
    • >>   PS2_Read
+
    
+
+
    PS2_ClearData (Thumb, 20 bytes, Stack size 0 bytes, pstwo.o(i.PS2_ClearData))
+

    [Called By]
    • >>   PS2_DataKey
+
    
+
+
    PS2_Cmd (Thumb, 130 bytes, Stack size 16 bytes, pstwo.o(i.PS2_Cmd))
+

    [Stack]
    • Max Depth = 32
    • Call Chain = PS2_Cmd ⇒ delay_us
+
    
+
    [Calls]
    • >>   delay_us
+
    
+
    [Called By]
    • >>   PS2_TurnOnAnalogMode
+
    • >>   PS2_ShortPoll
+
    • >>   PS2_ReadData
+
    • >>   PS2_ExitConfing
+
    • >>   PS2_EnterConfing
+
    
+
+
    PS2_DataKey (Thumb, 70 bytes, Stack size 8 bytes, pstwo.o(i.PS2_DataKey))
+

    [Stack]
    • Max Depth = 56
    • Call Chain = PS2_DataKey ⇒ PS2_ReadData ⇒ PS2_Cmd ⇒ delay_us
+
    
+
    [Calls]
    • >>   PS2_ReadData
+
    • >>   PS2_ClearData
+
    
+
    [Called By]
    • >>   PS2_Read
+
    
+
+
    PS2_EnterConfing (Thumb, 84 bytes, Stack size 8 bytes, pstwo.o(i.PS2_EnterConfing))
+

    [Stack]
    • Max Depth = 40
    • Call Chain = PS2_EnterConfing ⇒ PS2_Cmd ⇒ delay_us
+
    
+
    [Calls]
    • >>   delay_us
+
    • >>   PS2_Cmd
+
    
+
    [Called By]
    • >>   PS2_SetInit
+
    
+
+
    PS2_ExitConfing (Thumb, 84 bytes, Stack size 8 bytes, pstwo.o(i.PS2_ExitConfing))
+

    [Stack]
    • Max Depth = 40
    • Call Chain = PS2_ExitConfing ⇒ PS2_Cmd ⇒ delay_us
+
    
+
    [Calls]
    • >>   delay_us
+
    • >>   PS2_Cmd
+
    
+
    [Called By]
    • >>   PS2_SetInit
+
    
+
+
    PS2_Init (Thumb, 82 bytes, Stack size 16 bytes, pstwo.o(i.PS2_Init))
+

    [Stack]
    • Max Depth = 36
    • Call Chain = PS2_Init ⇒ GPIO_Init
+
    
+
    [Calls]
    • >>   RCC_AHB1PeriphClockCmd
+
    • >>   GPIO_Init
+
    
+
    [Called By]
    • >>   systemInit
+
    
+
+
    PS2_Read (Thumb, 204 bytes, Stack size 8 bytes, pstwo.o(i.PS2_Read))
+

    [Stack]
    • Max Depth = 64
    • Call Chain = PS2_Read ⇒ PS2_DataKey ⇒ PS2_ReadData ⇒ PS2_Cmd ⇒ delay_us
+
    
+
    [Calls]
    • >>   PS2_DataKey
+
    • >>   PS2_AnologData
+
    
+
    [Called By]
    • >>   pstwo_task
+
    
+
+
    PS2_ReadData (Thumb, 164 bytes, Stack size 16 bytes, pstwo.o(i.PS2_ReadData))
+

    [Stack]
    • Max Depth = 48
    • Call Chain = PS2_ReadData ⇒ PS2_Cmd ⇒ delay_us
+
    
+
    [Calls]
    • >>   delay_us
+
    • >>   PS2_Cmd
+
    
+
    [Called By]
    • >>   PS2_DataKey
+
    
+
+
    PS2_SetInit (Thumb, 28 bytes, Stack size 8 bytes, pstwo.o(i.PS2_SetInit))
+

    [Stack]
    • Max Depth = 48
    • Call Chain = PS2_SetInit ⇒ PS2_TurnOnAnalogMode ⇒ PS2_Cmd ⇒ delay_us
+
    
+
    [Calls]
    • >>   PS2_TurnOnAnalogMode
+
    • >>   PS2_ShortPoll
+
    • >>   PS2_ExitConfing
+
    • >>   PS2_EnterConfing
+
    
+
    [Called By]
    • >>   systemInit
+
    
+
+
    PS2_ShortPoll (Thumb, 60 bytes, Stack size 8 bytes, pstwo.o(i.PS2_ShortPoll))
+

    [Stack]
    • Max Depth = 40
    • Call Chain = PS2_ShortPoll ⇒ PS2_Cmd ⇒ delay_us
+
    
+
    [Calls]
    • >>   delay_us
+
    • >>   PS2_Cmd
+
    
+
    [Called By]
    • >>   PS2_SetInit
+
    
+
+
    PS2_TurnOnAnalogMode (Thumb, 78 bytes, Stack size 8 bytes, pstwo.o(i.PS2_TurnOnAnalogMode))
+

    [Stack]
    • Max Depth = 40
    • Call Chain = PS2_TurnOnAnalogMode ⇒ PS2_Cmd ⇒ delay_us
+
    
+
    [Calls]
    • >>   delay_us
+
    • >>   PS2_Cmd
+
    
+
    [Called By]
    • >>   PS2_SetInit
+
    
+
+
    PS2_control (Thumb, 552 bytes, Stack size 24 bytes, balance.o(i.PS2_control))
+

    [Stack]
    • Max Depth = 392
    • Call Chain = PS2_control ⇒ Drive_Motor ⇒ __hardfp_pow ⇒ sqrt ⇒ _dsqrt ⇒ __fpl_dnaninf
+
    
+
    [Calls]
    • >>   Drive_Motor
+
    
+
    [Called By]
    • >>   Balance_task
+
    
+
+
    PWR_BackupAccessCmd (Thumb, 6 bytes, Stack size 0 bytes, stm32f4xx_pwr.o(i.PWR_BackupAccessCmd))
+

    [Called By]
    • >>   OLED_Init
+
    
+
+
    RCC_AHB1PeriphClockCmd (Thumb, 26 bytes, Stack size 0 bytes, stm32f4xx_rcc.o(i.RCC_AHB1PeriphClockCmd))
+

    [Called By]
    • >>   TIM9_PWM_Init
+
    • >>   TIM1_PWM_Init
+
    • >>   TIM11_PWM_Init
+
    • >>   TIM10_PWM_Init
+
    • >>   Enable_Pin
+
    • >>   LED_Init
+
    • >>   Buzzer_Init
+
    • >>   KEY_Init
+
    • >>   Encoder_Init_TIM5
+
    • >>   Encoder_Init_TIM4
+
    • >>   Encoder_Init_TIM3
+
    • >>   Encoder_Init_TIM2
+
    • >>   CAN1_Mode_Init
+
    • >>   Adc_POWER_Init
+
    • >>   Adc_Init
+
    • >>   uart5_init
+
    • >>   uart3_init
+
    • >>   uart2_init
+
    • >>   uart1_init
+
    • >>   TIM8_Cap_Init
+
    • >>   TIM12_SERVO_Init
+
    • >>   PS2_Init
+
    • >>   OLED_Init
+
    • >>   I2C_GPIOInit
+
    
+
+
    RCC_APB1PeriphClockCmd (Thumb, 26 bytes, Stack size 0 bytes, stm32f4xx_rcc.o(i.RCC_APB1PeriphClockCmd))
+

    [Called By]
    • >>   Encoder_Init_TIM5
+
    • >>   Encoder_Init_TIM4
+
    • >>   Encoder_Init_TIM3
+
    • >>   Encoder_Init_TIM2
+
    • >>   CAN1_Mode_Init
+
    • >>   uart5_init
+
    • >>   uart3_init
+
    • >>   uart2_init
+
    • >>   TIM12_SERVO_Init
+
    • >>   OLED_Init
+
    
+
+
    RCC_APB2PeriphClockCmd (Thumb, 26 bytes, Stack size 0 bytes, stm32f4xx_rcc.o(i.RCC_APB2PeriphClockCmd))
+

    [Called By]
    • >>   TIM9_PWM_Init
+
    • >>   TIM1_PWM_Init
+
    • >>   TIM11_PWM_Init
+
    • >>   TIM10_PWM_Init
+
    • >>   Adc_POWER_Init
+
    • >>   Adc_Init
+
    • >>   uart1_init
+
    • >>   TIM8_Cap_Init
+
    
+
+
    RCC_APB2PeriphResetCmd (Thumb, 26 bytes, Stack size 0 bytes, stm32f4xx_rcc.o(i.RCC_APB2PeriphResetCmd))
+

    [Called By]
    • >>   Adc_POWER_Init
+
    • >>   Adc_Init
+
    
+
+
    RCC_GetClocksFreq (Thumb, 214 bytes, Stack size 20 bytes, stm32f4xx_rcc.o(i.RCC_GetClocksFreq))
+

    [Stack]
    • Max Depth = 20
    • Call Chain = RCC_GetClocksFreq
+
    
+
    [Called By]
    • >>   USART_Init
+
    
+
+
    RCC_LSEConfig (Thumb, 40 bytes, Stack size 0 bytes, stm32f4xx_rcc.o(i.RCC_LSEConfig))
+

    [Called By]
    • >>   OLED_Init
+
    
+
+
    Read_Encoder (Thumb, 88 bytes, Stack size 0 bytes, encoder.o(i.Read_Encoder))
+

    [Called By]
    • >>   Get_Velocity_Form_Encoder
+
    
+
+
    Remote_Control (Thumb, 554 bytes, Stack size 32 bytes, balance.o(i.Remote_Control))
+

    [Stack]
    • Max Depth = 400
    • Call Chain = Remote_Control ⇒ Drive_Motor ⇒ __hardfp_pow ⇒ sqrt ⇒ _dsqrt ⇒ __fpl_dnaninf
+
    
+
    [Calls]
    • >>   target_limit_int
+
    • >>   Drive_Motor
+
    
+
    [Called By]
    • >>   Balance_task
+
    
+
+
    Robot_Init (Thumb, 160 bytes, Stack size 40 bytes, robot_select_init.o(i.Robot_Init))
+

    [Stack]
    • Max Depth = 72
    • Call Chain = Robot_Init ⇒ __aeabi_d2f
+
    
+
    [Calls]
    • >>   __aeabi_d2f
+
    
+
    [Called By]
    • >>   Robot_Select
+
    
+
+
    Robot_Select (Thumb, 348 bytes, Stack size 8 bytes, robot_select_init.o(i.Robot_Select))
+

    [Stack]
    • Max Depth = 232 + Unknown Stack Size
+
    • Call Chain = Robot_Select ⇒ Get_adc_Average ⇒ delay_ms ⇒ vTaskDelay ⇒ xTaskResumeAll ⇒ xTaskIncrementTick ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   Get_adc_Average
+
    • >>   Robot_Init
+
    
+
    [Called By]
    • >>   systemInit
+
    
+
+
    Set_Pwm (Thumb, 134 bytes, Stack size 16 bytes, balance.o(i.Set_Pwm))
+

    [Stack]
    • Max Depth = 16
    • Call Chain = Set_Pwm
+
    
+
    [Called By]
    • >>   Balance_task
+
    
+
+
    Smooth_control (Thumb, 432 bytes, Stack size 4 bytes, balance.o(i.Smooth_control))
+

    [Stack]
    • Max Depth = 4
    • Call Chain = Smooth_control
+
    
+
    [Calls]
    • >>   target_limit_float
+
    • >>   float_abs
+
    
+
    [Called By]
    • >>   Drive_Motor
+
    
+
+
    SysTick_CLKSourceConfig (Thumb, 40 bytes, Stack size 0 bytes, misc.o(i.SysTick_CLKSourceConfig))
+

    [Called By]
    • >>   delay_init
+
    
+
+
    SysTick_Handler (Thumb, 16 bytes, Stack size 8 bytes, delay.o(i.SysTick_Handler))
+

    [Stack]
    • Max Depth = 168 + Unknown Stack Size
+
    • Call Chain = SysTick_Handler ⇒ xPortSysTickHandler ⇒ xTaskIncrementTick ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   xTaskGetSchedulerState
+
    • >>   xPortSysTickHandler
+
    
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    SystemInit (Thumb, 88 bytes, Stack size 8 bytes, system_stm32f4xx.o(i.SystemInit))
+

    [Stack]
    • Max Depth = 20
    • Call Chain = SystemInit ⇒ SetSysClock
+
    
+
    [Calls]
    • >>   SetSysClock
+
    
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(.text)
+
    
+
    TIM10_PWM_Init (Thumb, 150 bytes, Stack size 56 bytes, motor.o(i.TIM10_PWM_Init))
+

    [Stack]
    • Max Depth = 76
    • Call Chain = TIM10_PWM_Init ⇒ GPIO_PinAFConfig
+
    
+
    [Calls]
    • >>   TIM_TimeBaseInit
+
    • >>   TIM_Cmd
+
    • >>   GPIO_PinAFConfig
+
    • >>   RCC_APB2PeriphClockCmd
+
    • >>   RCC_AHB1PeriphClockCmd
+
    • >>   GPIO_Init
+
    • >>   TIM_OC1PreloadConfig
+
    • >>   TIM_OC1Init
+
    • >>   TIM_ARRPreloadConfig
+
    
+
    [Called By]
    • >>   systemInit
+
    
+
+
    TIM11_PWM_Init (Thumb, 158 bytes, Stack size 56 bytes, motor.o(i.TIM11_PWM_Init))
+

    [Stack]
    • Max Depth = 76
    • Call Chain = TIM11_PWM_Init ⇒ GPIO_PinAFConfig
+
    
+
    [Calls]
    • >>   TIM_TimeBaseInit
+
    • >>   TIM_Cmd
+
    • >>   GPIO_PinAFConfig
+
    • >>   RCC_APB2PeriphClockCmd
+
    • >>   RCC_AHB1PeriphClockCmd
+
    • >>   GPIO_Init
+
    • >>   TIM_OC1PreloadConfig
+
    • >>   TIM_OC1Init
+
    • >>   TIM_CtrlPWMOutputs
+
    • >>   TIM_ARRPreloadConfig
+
    
+
    [Called By]
    • >>   systemInit
+
    
+
+
    TIM12_SERVO_Init (Thumb, 196 bytes, Stack size 56 bytes, timer.o(i.TIM12_SERVO_Init))
+

    [Stack]
    • Max Depth = 76
    • Call Chain = TIM12_SERVO_Init ⇒ GPIO_PinAFConfig
+
    
+
    [Calls]
    • >>   TIM_TimeBaseInit
+
    • >>   TIM_Cmd
+
    • >>   RCC_APB1PeriphClockCmd
+
    • >>   GPIO_PinAFConfig
+
    • >>   RCC_AHB1PeriphClockCmd
+
    • >>   GPIO_Init
+
    • >>   TIM_OC2PreloadConfig
+
    • >>   TIM_OC2Init
+
    • >>   TIM_OC1PreloadConfig
+
    • >>   TIM_OC1Init
+
    • >>   TIM_CtrlPWMOutputs
+
    
+
    [Called By]
    • >>   systemInit
+
    
+
+
    TIM1_PWM_Init (Thumb, 238 bytes, Stack size 56 bytes, motor.o(i.TIM1_PWM_Init))
+

    [Stack]
    • Max Depth = 76
    • Call Chain = TIM1_PWM_Init ⇒ GPIO_PinAFConfig
+
    
+
    [Calls]
    • >>   TIM_TimeBaseInit
+
    • >>   TIM_Cmd
+
    • >>   GPIO_PinAFConfig
+
    • >>   RCC_APB2PeriphClockCmd
+
    • >>   RCC_AHB1PeriphClockCmd
+
    • >>   GPIO_Init
+
    • >>   TIM_OC4PreloadConfig
+
    • >>   TIM_OC4Init
+
    • >>   TIM_OC3PreloadConfig
+
    • >>   TIM_OC3Init
+
    • >>   TIM_OC2PreloadConfig
+
    • >>   TIM_OC2Init
+
    • >>   TIM_OC1PreloadConfig
+
    • >>   TIM_OC1Init
+
    • >>   TIM_CtrlPWMOutputs
+
    • >>   TIM_ARRPreloadConfig
+
    
+
    [Called By]
    • >>   systemInit
+
    
+
+
    TIM2_IRQHandler (Thumb, 24 bytes, Stack size 0 bytes, encoder.o(i.TIM2_IRQHandler))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    TIM3_IRQHandler (Thumb, 18 bytes, Stack size 0 bytes, encoder.o(i.TIM3_IRQHandler))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    TIM4_IRQHandler (Thumb, 18 bytes, Stack size 0 bytes, encoder.o(i.TIM4_IRQHandler))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    TIM5_IRQHandler (Thumb, 18 bytes, Stack size 0 bytes, encoder.o(i.TIM5_IRQHandler))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    TIM8_BRK_TIM12_IRQHandler (Thumb, 18 bytes, Stack size 0 bytes, encoder.o(i.TIM8_BRK_TIM12_IRQHandler))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    TIM8_CC_IRQHandler (Thumb, 810 bytes, Stack size 8 bytes, timer.o(i.TIM8_CC_IRQHandler))
+

    [Stack]
    • Max Depth = 20
    • Call Chain = TIM8_CC_IRQHandler ⇒ TIM_GetITStatus
+
    
+
    [Calls]
    • >>   TIM_OC4PolarityConfig
+
    • >>   TIM_OC3PolarityConfig
+
    • >>   TIM_OC2PolarityConfig
+
    • >>   TIM_OC1PolarityConfig
+
    • >>   TIM_GetITStatus
+
    • >>   TIM_GetCapture4
+
    • >>   TIM_GetCapture3
+
    • >>   TIM_GetCapture2
+
    • >>   TIM_GetCapture1
+
    • >>   TIM_ClearITPendingBit
+
    
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    TIM8_Cap_Init (Thumb, 328 bytes, Stack size 48 bytes, timer.o(i.TIM8_Cap_Init))
+

    [Stack]
    • Max Depth = 84
    • Call Chain = TIM8_Cap_Init ⇒ TIM_ICInit ⇒ TI4_Config
+
    
+
    [Calls]
    • >>   TIM_TimeBaseInit
+
    • >>   TIM_ITConfig
+
    • >>   TIM_ICInit
+
    • >>   TIM_Cmd
+
    • >>   NVIC_Init
+
    • >>   GPIO_PinAFConfig
+
    • >>   RCC_APB2PeriphClockCmd
+
    • >>   RCC_AHB1PeriphClockCmd
+
    • >>   GPIO_Init
+
    • >>   TIM_CtrlPWMOutputs
+
    
+
    [Called By]
    • >>   systemInit
+
    
+
+
    TIM8_UP_TIM13_IRQHandler (Thumb, 14 bytes, Stack size 0 bytes, timer.o(i.TIM8_UP_TIM13_IRQHandler))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    TIM9_PWM_Init (Thumb, 174 bytes, Stack size 56 bytes, motor.o(i.TIM9_PWM_Init))
+

    [Stack]
    • Max Depth = 76
    • Call Chain = TIM9_PWM_Init ⇒ GPIO_PinAFConfig
+
    
+
    [Calls]
    • >>   TIM_TimeBaseInit
+
    • >>   TIM_Cmd
+
    • >>   GPIO_PinAFConfig
+
    • >>   RCC_APB2PeriphClockCmd
+
    • >>   RCC_AHB1PeriphClockCmd
+
    • >>   GPIO_Init
+
    • >>   TIM_OC2PreloadConfig
+
    • >>   TIM_OC2Init
+
    • >>   TIM_OC1PreloadConfig
+
    • >>   TIM_OC1Init
+
    • >>   TIM_ARRPreloadConfig
+
    
+
    [Called By]
    • >>   systemInit
+
    
+
+
    TIM_ARRPreloadConfig (Thumb, 24 bytes, Stack size 0 bytes, stm32f4xx_tim.o(i.TIM_ARRPreloadConfig))
+

    [Called By]
    • >>   TIM9_PWM_Init
+
    • >>   TIM1_PWM_Init
+
    • >>   TIM11_PWM_Init
+
    • >>   TIM10_PWM_Init
+
    
+
+
    TIM_ClearFlag (Thumb, 6 bytes, Stack size 0 bytes, stm32f4xx_tim.o(i.TIM_ClearFlag))
+

    [Called By]
    • >>   Encoder_Init_TIM5
+
    • >>   Encoder_Init_TIM4
+
    • >>   Encoder_Init_TIM3
+
    • >>   Encoder_Init_TIM2
+
    
+
+
    TIM_ClearITPendingBit (Thumb, 6 bytes, Stack size 0 bytes, stm32f4xx_tim.o(i.TIM_ClearITPendingBit))
+

    [Called By]
    • >>   TIM8_CC_IRQHandler
+
    
+
+
    TIM_Cmd (Thumb, 24 bytes, Stack size 0 bytes, stm32f4xx_tim.o(i.TIM_Cmd))
+

    [Called By]
    • >>   TIM9_PWM_Init
+
    • >>   TIM1_PWM_Init
+
    • >>   TIM11_PWM_Init
+
    • >>   TIM10_PWM_Init
+
    • >>   Encoder_Init_TIM5
+
    • >>   Encoder_Init_TIM4
+
    • >>   Encoder_Init_TIM3
+
    • >>   Encoder_Init_TIM2
+
    • >>   TIM8_Cap_Init
+
    • >>   TIM12_SERVO_Init
+
    
+
+
    TIM_CtrlPWMOutputs (Thumb, 30 bytes, Stack size 0 bytes, stm32f4xx_tim.o(i.TIM_CtrlPWMOutputs))
+

    [Called By]
    • >>   TIM1_PWM_Init
+
    • >>   TIM11_PWM_Init
+
    • >>   TIM8_Cap_Init
+
    • >>   TIM12_SERVO_Init
+
    
+
+
    TIM_EncoderInterfaceConfig (Thumb, 66 bytes, Stack size 20 bytes, stm32f4xx_tim.o(i.TIM_EncoderInterfaceConfig))
+

    [Stack]
    • Max Depth = 20
    • Call Chain = TIM_EncoderInterfaceConfig
+
    
+
    [Called By]
    • >>   Encoder_Init_TIM5
+
    • >>   Encoder_Init_TIM4
+
    • >>   Encoder_Init_TIM3
+
    • >>   Encoder_Init_TIM2
+
    
+
+
    TIM_GetCapture1 (Thumb, 6 bytes, Stack size 0 bytes, stm32f4xx_tim.o(i.TIM_GetCapture1))
+

    [Called By]
    • >>   TIM8_CC_IRQHandler
+
    
+
+
    TIM_GetCapture2 (Thumb, 6 bytes, Stack size 0 bytes, stm32f4xx_tim.o(i.TIM_GetCapture2))
+

    [Called By]
    • >>   TIM8_CC_IRQHandler
+
    
+
+
    TIM_GetCapture3 (Thumb, 6 bytes, Stack size 0 bytes, stm32f4xx_tim.o(i.TIM_GetCapture3))
+

    [Called By]
    • >>   TIM8_CC_IRQHandler
+
    
+
+
    TIM_GetCapture4 (Thumb, 6 bytes, Stack size 0 bytes, stm32f4xx_tim.o(i.TIM_GetCapture4))
+

    [Called By]
    • >>   TIM8_CC_IRQHandler
+
    
+
+
    TIM_GetITStatus (Thumb, 34 bytes, Stack size 12 bytes, stm32f4xx_tim.o(i.TIM_GetITStatus))
+

    [Stack]
    • Max Depth = 12
    • Call Chain = TIM_GetITStatus
+
    
+
    [Called By]
    • >>   TIM8_CC_IRQHandler
+
    
+
+
    TIM_ICInit (Thumb, 110 bytes, Stack size 16 bytes, stm32f4xx_tim.o(i.TIM_ICInit))
+

    [Stack]
    • Max Depth = 36
    • Call Chain = TIM_ICInit ⇒ TI4_Config
+
    
+
    [Calls]
    • >>   TIM_SetIC4Prescaler
+
    • >>   TIM_SetIC3Prescaler
+
    • >>   TIM_SetIC2Prescaler
+
    • >>   TIM_SetIC1Prescaler
+
    • >>   TI4_Config
+
    • >>   TI3_Config
+
    • >>   TI2_Config
+
    • >>   TI1_Config
+
    
+
    [Called By]
    • >>   Encoder_Init_TIM5
+
    • >>   Encoder_Init_TIM4
+
    • >>   Encoder_Init_TIM3
+
    • >>   Encoder_Init_TIM2
+
    • >>   TIM8_Cap_Init
+
    
+
+
    TIM_ICStructInit (Thumb, 18 bytes, Stack size 0 bytes, stm32f4xx_tim.o(i.TIM_ICStructInit))
+

    [Called By]
    • >>   Encoder_Init_TIM5
+
    • >>   Encoder_Init_TIM4
+
    • >>   Encoder_Init_TIM3
+
    • >>   Encoder_Init_TIM2
+
    
+
+
    TIM_ITConfig (Thumb, 18 bytes, Stack size 0 bytes, stm32f4xx_tim.o(i.TIM_ITConfig))
+

    [Called By]
    • >>   Encoder_Init_TIM5
+
    • >>   Encoder_Init_TIM4
+
    • >>   Encoder_Init_TIM3
+
    • >>   Encoder_Init_TIM2
+
    • >>   TIM8_Cap_Init
+
    
+
+
    TIM_OC1Init (Thumb, 114 bytes, Stack size 16 bytes, stm32f4xx_tim.o(i.TIM_OC1Init))
+

    [Stack]
    • Max Depth = 16
    • Call Chain = TIM_OC1Init
+
    
+
    [Called By]
    • >>   TIM9_PWM_Init
+
    • >>   TIM1_PWM_Init
+
    • >>   TIM11_PWM_Init
+
    • >>   TIM10_PWM_Init
+
    • >>   TIM12_SERVO_Init
+
    
+
+
    TIM_OC1PolarityConfig (Thumb, 18 bytes, Stack size 0 bytes, stm32f4xx_tim.o(i.TIM_OC1PolarityConfig))
+

    [Called By]
    • >>   TIM8_CC_IRQHandler
+
    
+
+
    TIM_OC1PreloadConfig (Thumb, 18 bytes, Stack size 0 bytes, stm32f4xx_tim.o(i.TIM_OC1PreloadConfig))
+

    [Called By]
    • >>   TIM9_PWM_Init
+
    • >>   TIM1_PWM_Init
+
    • >>   TIM11_PWM_Init
+
    • >>   TIM10_PWM_Init
+
    • >>   TIM12_SERVO_Init
+
    
+
+
    TIM_OC2Init (Thumb, 154 bytes, Stack size 16 bytes, stm32f4xx_tim.o(i.TIM_OC2Init))
+

    [Stack]
    • Max Depth = 16
    • Call Chain = TIM_OC2Init
+
    
+
    [Called By]
    • >>   TIM9_PWM_Init
+
    • >>   TIM1_PWM_Init
+
    • >>   TIM12_SERVO_Init
+
    
+
+
    TIM_OC2PolarityConfig (Thumb, 26 bytes, Stack size 0 bytes, stm32f4xx_tim.o(i.TIM_OC2PolarityConfig))
+

    [Called By]
    • >>   TIM8_CC_IRQHandler
+
    
+
+
    TIM_OC2PreloadConfig (Thumb, 26 bytes, Stack size 0 bytes, stm32f4xx_tim.o(i.TIM_OC2PreloadConfig))
+

    [Called By]
    • >>   TIM9_PWM_Init
+
    • >>   TIM1_PWM_Init
+
    • >>   TIM12_SERVO_Init
+
    
+
+
    TIM_OC3Init (Thumb, 150 bytes, Stack size 16 bytes, stm32f4xx_tim.o(i.TIM_OC3Init))
+

    [Stack]
    • Max Depth = 16
    • Call Chain = TIM_OC3Init
+
    
+
    [Called By]
    • >>   TIM1_PWM_Init
+
    
+
+
    TIM_OC3PolarityConfig (Thumb, 26 bytes, Stack size 0 bytes, stm32f4xx_tim.o(i.TIM_OC3PolarityConfig))
+

    [Called By]
    • >>   TIM8_CC_IRQHandler
+
    
+
+
    TIM_OC3PreloadConfig (Thumb, 18 bytes, Stack size 0 bytes, stm32f4xx_tim.o(i.TIM_OC3PreloadConfig))
+

    [Called By]
    • >>   TIM1_PWM_Init
+
    
+
+
    TIM_OC4Init (Thumb, 112 bytes, Stack size 16 bytes, stm32f4xx_tim.o(i.TIM_OC4Init))
+

    [Stack]
    • Max Depth = 16
    • Call Chain = TIM_OC4Init
+
    
+
    [Called By]
    • >>   TIM1_PWM_Init
+
    
+
+
    TIM_OC4PolarityConfig (Thumb, 26 bytes, Stack size 0 bytes, stm32f4xx_tim.o(i.TIM_OC4PolarityConfig))
+

    [Called By]
    • >>   TIM8_CC_IRQHandler
+
    
+
+
    TIM_OC4PreloadConfig (Thumb, 26 bytes, Stack size 0 bytes, stm32f4xx_tim.o(i.TIM_OC4PreloadConfig))
+

    [Called By]
    • >>   TIM1_PWM_Init
+
    
+
+
    TIM_SetCounter (Thumb, 4 bytes, Stack size 0 bytes, stm32f4xx_tim.o(i.TIM_SetCounter))
+

    [Called By]
    • >>   Encoder_Init_TIM5
+
    • >>   Encoder_Init_TIM4
+
    • >>   Encoder_Init_TIM3
+
    • >>   Encoder_Init_TIM2
+
    
+
+
    TIM_SetIC1Prescaler (Thumb, 18 bytes, Stack size 0 bytes, stm32f4xx_tim.o(i.TIM_SetIC1Prescaler))
+

    [Called By]
    • >>   TIM_ICInit
+
    
+
+
    TIM_SetIC2Prescaler (Thumb, 26 bytes, Stack size 0 bytes, stm32f4xx_tim.o(i.TIM_SetIC2Prescaler))
+

    [Called By]
    • >>   TIM_ICInit
+
    
+
+
    TIM_SetIC3Prescaler (Thumb, 18 bytes, Stack size 0 bytes, stm32f4xx_tim.o(i.TIM_SetIC3Prescaler))
+

    [Called By]
    • >>   TIM_ICInit
+
    
+
+
    TIM_SetIC4Prescaler (Thumb, 26 bytes, Stack size 0 bytes, stm32f4xx_tim.o(i.TIM_SetIC4Prescaler))
+

    [Called By]
    • >>   TIM_ICInit
+
    
+
+
    TIM_TimeBaseInit (Thumb, 104 bytes, Stack size 0 bytes, stm32f4xx_tim.o(i.TIM_TimeBaseInit))
+

    [Called By]
    • >>   TIM9_PWM_Init
+
    • >>   TIM1_PWM_Init
+
    • >>   TIM11_PWM_Init
+
    • >>   TIM10_PWM_Init
+
    • >>   Encoder_Init_TIM5
+
    • >>   Encoder_Init_TIM4
+
    • >>   Encoder_Init_TIM3
+
    • >>   Encoder_Init_TIM2
+
    • >>   TIM8_Cap_Init
+
    • >>   TIM12_SERVO_Init
+
    
+
+
    TIM_TimeBaseStructInit (Thumb, 18 bytes, Stack size 0 bytes, stm32f4xx_tim.o(i.TIM_TimeBaseStructInit))
+

    [Called By]
    • >>   Encoder_Init_TIM5
+
    • >>   Encoder_Init_TIM4
+
    • >>   Encoder_Init_TIM3
+
    • >>   Encoder_Init_TIM2
+
    
+
+
    Turn_Off (Thumb, 54 bytes, Stack size 0 bytes, balance.o(i.Turn_Off))
+

    [Called By]
    • >>   Balance_task
+
    
+
+
    UART5_IRQHandler (Thumb, 246 bytes, Stack size 16 bytes, usartx.o(i.UART5_IRQHandler))
+

    [Stack]
    • Max Depth = 200
    • Call Chain = UART5_IRQHandler ⇒ Vz_to_Akm_Angle ⇒ __hardfp_atan ⇒ __kernel_poly ⇒ __aeabi_dmul
+
    
+
    [Calls]
    • >>   Vz_to_Akm_Angle
+
    • >>   USART_ReceiveData
+
    • >>   USART_GetITStatus
+
    • >>   XYZ_Target_Speed_transition
+
    • >>   Check_Sum
+
    
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    USART1_IRQHandler (Thumb, 282 bytes, Stack size 32 bytes, usartx.o(i.USART1_IRQHandler))
+

    [Stack]
    • Max Depth = 216
    • Call Chain = USART1_IRQHandler ⇒ Vz_to_Akm_Angle ⇒ __hardfp_atan ⇒ __kernel_poly ⇒ __aeabi_dmul
+
    
+
    [Calls]
    • >>   Vz_to_Akm_Angle
+
    • >>   USART_ReceiveData
+
    • >>   USART_GetITStatus
+
    • >>   XYZ_Target_Speed_transition
+
    
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    USART1_SEND (Thumb, 26 bytes, Stack size 4 bytes, usartx.o(i.USART1_SEND))
+

    [Stack]
    • Max Depth = 4
    • Call Chain = USART1_SEND
+
    
+
    [Calls]
    • >>   usart1_send
+
    
+
    [Called By]
    • >>   data_task
+
    
+
+
    USART2_IRQHandler (Thumb, 646 bytes, Stack size 56 bytes, usartx.o(i.USART2_IRQHandler))
+

    [Stack]
    • Max Depth = 320
    • Call Chain = USART2_IRQHandler ⇒ __hardfp_pow ⇒ sqrt ⇒ _dsqrt ⇒ __fpl_dnaninf
+
    
+
    [Calls]
    • >>   USART_GetITStatus
+
    • >>   __hardfp_pow
+
    • >>   __aeabi_f2d
+
    • >>   __aeabi_dmul
+
    • >>   __aeabi_i2d
+
    • >>   __aeabi_dadd
+
    • >>   __aeabi_d2f
+
    • >>   __aeabi_memclr
+
    
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    USART3_IRQHandler (Thumb, 256 bytes, Stack size 16 bytes, usartx.o(i.USART3_IRQHandler))
+

    [Stack]
    • Max Depth = 200
    • Call Chain = USART3_IRQHandler ⇒ Vz_to_Akm_Angle ⇒ __hardfp_atan ⇒ __kernel_poly ⇒ __aeabi_dmul
+
    
+
    [Calls]
    • >>   Vz_to_Akm_Angle
+
    • >>   USART_ReceiveData
+
    • >>   USART_GetITStatus
+
    • >>   XYZ_Target_Speed_transition
+
    • >>   Check_Sum
+
    
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    USART3_SEND (Thumb, 26 bytes, Stack size 4 bytes, usartx.o(i.USART3_SEND))
+

    [Stack]
    • Max Depth = 4
    • Call Chain = USART3_SEND
+
    
+
    [Calls]
    • >>   usart3_send
+
    
+
    [Called By]
    • >>   data_task
+
    
+
+
    USART5_SEND (Thumb, 26 bytes, Stack size 4 bytes, usartx.o(i.USART5_SEND))
+

    [Stack]
    • Max Depth = 4
    • Call Chain = USART5_SEND
+
    
+
    [Calls]
    • >>   usart5_send
+
    
+
    [Called By]
    • >>   data_task
+
    
+
+
    USART_Cmd (Thumb, 24 bytes, Stack size 0 bytes, stm32f4xx_usart.o(i.USART_Cmd))
+

    [Called By]
    • >>   uart5_init
+
    • >>   uart3_init
+
    • >>   uart2_init
+
    • >>   uart1_init
+
    
+
+
    USART_GetITStatus (Thumb, 84 bytes, Stack size 16 bytes, stm32f4xx_usart.o(i.USART_GetITStatus))
+

    [Stack]
    • Max Depth = 16
    • Call Chain = USART_GetITStatus
+
    
+
    [Called By]
    • >>   USART3_IRQHandler
+
    • >>   USART2_IRQHandler
+
    • >>   USART1_IRQHandler
+
    • >>   UART5_IRQHandler
+
    
+
+
    USART_ITConfig (Thumb, 74 bytes, Stack size 20 bytes, stm32f4xx_usart.o(i.USART_ITConfig))
+

    [Stack]
    • Max Depth = 20
    • Call Chain = USART_ITConfig
+
    
+
    [Called By]
    • >>   uart5_init
+
    • >>   uart3_init
+
    • >>   uart2_init
+
    • >>   uart1_init
+
    
+
+
    USART_Init (Thumb, 204 bytes, Stack size 48 bytes, stm32f4xx_usart.o(i.USART_Init))
+

    [Stack]
    • Max Depth = 68
    • Call Chain = USART_Init ⇒ RCC_GetClocksFreq
+
    
+
    [Calls]
    • >>   RCC_GetClocksFreq
+
    
+
    [Called By]
    • >>   uart5_init
+
    • >>   uart3_init
+
    • >>   uart2_init
+
    • >>   uart1_init
+
    
+
+
    USART_ReceiveData (Thumb, 10 bytes, Stack size 0 bytes, stm32f4xx_usart.o(i.USART_ReceiveData))
+

    [Called By]
    • >>   USART3_IRQHandler
+
    • >>   USART1_IRQHandler
+
    • >>   UART5_IRQHandler
+
    
+
+
    UsageFault_Handler (Thumb, 4 bytes, Stack size 0 bytes, stm32f4xx_it.o(i.UsageFault_Handler))
+
    [Address Reference Count : 1]
    •  startup_stm32f40_41xxx.o(RESET)
+
    
+
    Vz_to_Akm_Angle (Thumb, 188 bytes, Stack size 80 bytes, usartx.o(i.Vz_to_Akm_Angle))
+

    [Stack]
    • Max Depth = 184
    • Call Chain = Vz_to_Akm_Angle ⇒ __hardfp_atan ⇒ __kernel_poly ⇒ __aeabi_dmul
+
    
+
    [Calls]
    • >>   __hardfp_atan
+
    • >>   __aeabi_f2d
+
    • >>   __aeabi_dmul
+
    • >>   __aeabi_ddiv
+
    • >>   __aeabi_dadd
+
    • >>   __aeabi_d2f
+
    
+
    [Called By]
    • >>   CAN1_RX0_IRQHandler
+
    • >>   USART3_IRQHandler
+
    • >>   USART1_IRQHandler
+
    • >>   UART5_IRQHandler
+
    
+
+
    XYZ_Target_Speed_transition (Thumb, 102 bytes, Stack size 56 bytes, usartx.o(i.XYZ_Target_Speed_transition))
+

    [Stack]
    • Max Depth = 88
    • Call Chain = XYZ_Target_Speed_transition ⇒ __aeabi_dmul
+
    
+
    [Calls]
    • >>   __aeabi_dmul
+
    • >>   __aeabi_i2d
+
    • >>   __aeabi_dadd
+
    • >>   __aeabi_d2f
+
    
+
    [Called By]
    • >>   USART3_IRQHandler
+
    • >>   USART1_IRQHandler
+
    • >>   UART5_IRQHandler
+
    
+
+
    __ARM_fpclassify (Thumb, 48 bytes, Stack size 8 bytes, fpclassify.o(i.__ARM_fpclassify))
+

    [Stack]
    • Max Depth = 8
    • Call Chain = __ARM_fpclassify
+
    
+
    [Called By]
    • >>   __kernel_tan
+
    • >>   __hardfp_pow
+
    • >>   __hardfp_atan
+
    
+
+
    __hardfp_atan (Thumb, 622 bytes, Stack size 48 bytes, atan.o(i.__hardfp_atan))
+

    [Stack]
    • Max Depth = 104
    • Call Chain = __hardfp_atan ⇒ __kernel_poly ⇒ __aeabi_dmul
+
    
+
    [Calls]
    • >>   __kernel_poly
+
    • >>   __ARM_fpclassify
+
    • >>   fabs
+
    • >>   __mathlib_dbl_underflow
+
    • >>   __mathlib_dbl_infnan
+
    • >>   __aeabi_dmul
+
    • >>   __aeabi_ddiv
+
    • >>   __aeabi_dsub
+
    • >>   __aeabi_drsub
+
    • >>   __aeabi_dadd
+
    • >>   __aeabi_dneg
+
    
+
    [Called By]
    • >>   Vz_to_Akm_Angle
+
    
+
+
    __hardfp_pow (Thumb, 3072 bytes, Stack size 192 bytes, pow.o(i.__hardfp_pow))
+

    [Stack]
    • Max Depth = 264
    • Call Chain = __hardfp_pow ⇒ sqrt ⇒ _dsqrt ⇒ __fpl_dnaninf
+
    
+
    [Calls]
    • >>   __kernel_poly
+
    • >>   __ARM_fpclassify
+
    • >>   fabs
+
    • >>   __mathlib_dbl_underflow
+
    • >>   __mathlib_dbl_overflow
+
    • >>   __mathlib_dbl_invalid
+
    • >>   __mathlib_dbl_infnan2
+
    • >>   __mathlib_dbl_divzero
+
    • >>   __ARM_scalbn
+
    • >>   __aeabi_cdrcmple
+
    • >>   __set_errno
+
    • >>   sqrt
+
    • >>   __aeabi_dmul
+
    • >>   __aeabi_i2d
+
    • >>   __aeabi_ddiv
+
    • >>   __aeabi_dsub
+
    • >>   __aeabi_drsub
+
    • >>   __aeabi_dadd
+
    • >>   __aeabi_dneg
+
    
+
    [Called By]
    • >>   USART2_IRQHandler
+
    • >>   Drive_Motor
+
    
+
+
    __hardfp_sqrt (Thumb, 122 bytes, Stack size 32 bytes, sqrt.o(i.__hardfp_sqrt))
+

    [Stack]
    • Max Depth = 72
    • Call Chain = __hardfp_sqrt ⇒ _dsqrt ⇒ __fpl_dnaninf
+
    
+
    [Calls]
    • >>   _dsqrt
+
    • >>   __set_errno
+
    
+
    [Called By]
    • >>   data_transition
+
    • >>   Drive_Motor
+
    
+
+
    __hardfp_tan (Thumb, 108 bytes, Stack size 32 bytes, tan.o(i.__hardfp_tan))
+

    [Stack]
    • Max Depth = 216
    • Call Chain = __hardfp_tan ⇒ __kernel_tan ⇒ __kernel_poly ⇒ __aeabi_dmul
+
    
+
    [Calls]
    • >>   __kernel_tan
+
    • >>   __ieee754_rem_pio2
+
    • >>   __mathlib_dbl_invalid
+
    • >>   __mathlib_dbl_infnan
+
    • >>   __set_errno
+
    
+
    [Called By]
    • >>   Drive_Motor
+
    
+
+
    __ieee754_rem_pio2 (Thumb, 938 bytes, Stack size 120 bytes, rred.o(i.__ieee754_rem_pio2))
+

    [Stack]
    • Max Depth = 152
    • Call Chain = __ieee754_rem_pio2 ⇒ __aeabi_dmul
+
    
+
    [Calls]
    • >>   fabs
+
    • >>   __aeabi_dmul
+
    • >>   __aeabi_ui2d
+
    • >>   __aeabi_i2d
+
    • >>   __aeabi_d2iz
+
    • >>   __aeabi_dsub
+
    • >>   __aeabi_drsub
+
    • >>   __aeabi_dadd
+
    • >>   __aeabi_dneg
+
    
+
    [Called By]
    • >>   __hardfp_tan
+
    
+
+
    __kernel_poly (Thumb, 248 bytes, Stack size 24 bytes, poly.o(i.__kernel_poly))
+

    [Stack]
    • Max Depth = 56
    • Call Chain = __kernel_poly ⇒ __aeabi_dmul
+
    
+
    [Calls]
    • >>   __aeabi_dmul
+
    • >>   __aeabi_dadd
+
    
+
    [Called By]
    • >>   __kernel_tan
+
    • >>   __hardfp_pow
+
    • >>   __hardfp_atan
+
    
+
+
    __kernel_tan (Thumb, 764 bytes, Stack size 128 bytes, tan_i.o(i.__kernel_tan))
+

    [Stack]
    • Max Depth = 184
    • Call Chain = __kernel_tan ⇒ __kernel_poly ⇒ __aeabi_dmul
+
    
+
    [Calls]
    • >>   __kernel_poly
+
    • >>   __ARM_fpclassify
+
    • >>   fabs
+
    • >>   __mathlib_dbl_underflow
+
    • >>   __aeabi_dmul
+
    • >>   __aeabi_i2d
+
    • >>   __aeabi_d2iz
+
    • >>   __aeabi_ddiv
+
    • >>   __aeabi_dsub
+
    • >>   __aeabi_drsub
+
    • >>   __aeabi_dadd
+
    • >>   __aeabi_dneg
+
    
+
    [Called By]
    • >>   __hardfp_tan
+
    
+
+
    __mathlib_dbl_divzero (Thumb, 28 bytes, Stack size 8 bytes, dunder.o(i.__mathlib_dbl_divzero))
+

    [Stack]
    • Max Depth = 40
    • Call Chain = __mathlib_dbl_divzero ⇒ __aeabi_ddiv
+
    
+
    [Calls]
    • >>   __aeabi_ddiv
+
    
+
    [Called By]
    • >>   __hardfp_pow
+
    
+
+
    __mathlib_dbl_infnan (Thumb, 20 bytes, Stack size 8 bytes, dunder.o(i.__mathlib_dbl_infnan))
+

    [Stack]
    • Max Depth = 24
    • Call Chain = __mathlib_dbl_infnan ⇒ __aeabi_dadd
+
    
+
    [Calls]
    • >>   __aeabi_dadd
+
    
+
    [Called By]
    • >>   __hardfp_tan
+
    • >>   __hardfp_atan
+
    
+
+
    __mathlib_dbl_infnan2 (Thumb, 20 bytes, Stack size 8 bytes, dunder.o(i.__mathlib_dbl_infnan2))
+

    [Stack]
    • Max Depth = 24
    • Call Chain = __mathlib_dbl_infnan2 ⇒ __aeabi_dadd
+
    
+
    [Calls]
    • >>   __aeabi_dadd
+
    
+
    [Called By]
    • >>   __hardfp_pow
+
    
+
+
    __mathlib_dbl_invalid (Thumb, 24 bytes, Stack size 8 bytes, dunder.o(i.__mathlib_dbl_invalid))
+

    [Stack]
    • Max Depth = 40
    • Call Chain = __mathlib_dbl_invalid ⇒ __aeabi_ddiv
+
    
+
    [Calls]
    • >>   __aeabi_ddiv
+
    
+
    [Called By]
    • >>   __hardfp_tan
+
    • >>   __hardfp_pow
+
    
+
+
    __mathlib_dbl_overflow (Thumb, 24 bytes, Stack size 8 bytes, dunder.o(i.__mathlib_dbl_overflow))
+

    [Stack]
    • Max Depth = 40
    • Call Chain = __mathlib_dbl_overflow ⇒ __aeabi_dmul
+
    
+
    [Calls]
    • >>   __aeabi_dmul
+
    
+
    [Called By]
    • >>   __hardfp_pow
+
    
+
+
    __mathlib_dbl_underflow (Thumb, 24 bytes, Stack size 8 bytes, dunder.o(i.__mathlib_dbl_underflow))
+

    [Stack]
    • Max Depth = 40
    • Call Chain = __mathlib_dbl_underflow ⇒ __aeabi_dmul
+
    
+
    [Calls]
    • >>   __aeabi_dmul
+
    
+
    [Called By]
    • >>   __kernel_tan
+
    • >>   __hardfp_pow
+
    • >>   __hardfp_atan
+
    
+
+
    _sys_exit (Thumb, 4 bytes, Stack size 0 bytes, usart.o(i._sys_exit))
+

    [Called By]
    • >>   __rt_exit_exit
+
    
+
+
    click_N_Double_MPU6050 (Thumb, 184 bytes, Stack size 0 bytes, key.o(i.click_N_Double_MPU6050))
+

    [Called By]
    • >>   Key
+
    
+
+
    data_task (Thumb, 40 bytes, Stack size 8 bytes, usartx.o(i.data_task))
+

    [Stack]
    • Max Depth = 208 + Unknown Stack Size
+
    • Call Chain = data_task ⇒ vTaskDelayUntil ⇒ xTaskResumeAll ⇒ xTaskIncrementTick ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   data_transition
+
    • >>   USART5_SEND
+
    • >>   USART3_SEND
+
    • >>   USART1_SEND
+
    • >>   CAN_SEND
+
    • >>   vTaskDelayUntil
+
    • >>   getSysTickCnt
+
    
+
    [Address Reference Count : 1]
    •  main.o(i.start_task)
+
    
+
    data_transition (Thumb, 1342 bytes, Stack size 48 bytes, usartx.o(i.data_transition))
+

    [Stack]
    • Max Depth = 120
    • Call Chain = data_transition ⇒ __hardfp_sqrt ⇒ _dsqrt ⇒ __fpl_dnaninf
+
    
+
    [Calls]
    • >>   Check_Sum
+
    • >>   __hardfp_sqrt
+
    • >>   __aeabi_f2d
+
    • >>   __aeabi_dmul
+
    • >>   __aeabi_d2iz
+
    • >>   __aeabi_ddiv
+
    
+
    [Called By]
    • >>   data_task
+
    
+
+
    delay_init (Thumb, 58 bytes, Stack size 16 bytes, delay.o(i.delay_init))
+

    [Stack]
    • Max Depth = 16
    • Call Chain = delay_init
+
    
+
    [Calls]
    • >>   SysTick_CLKSourceConfig
+
    
+
    [Called By]
    • >>   systemInit
+
    
+
+
    delay_ms (Thumb, 60 bytes, Stack size 16 bytes, delay.o(i.delay_ms))
+

    [Stack]
    • Max Depth = 200 + Unknown Stack Size
+
    • Call Chain = delay_ms ⇒ vTaskDelay ⇒ xTaskResumeAll ⇒ xTaskIncrementTick ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   vTaskDelay
+
    • >>   xTaskGetSchedulerState
+
    • >>   delay_us
+
    
+
    [Called By]
    • >>   Get_adc_Average
+
    • >>   OLED_Init
+
    • >>   MPU6050_initialize
+
    
+
+
    delay_us (Thumb, 68 bytes, Stack size 16 bytes, delay.o(i.delay_us))
+

    [Stack]
    • Max Depth = 16
    • Call Chain = delay_us
+
    
+
    [Called By]
    • >>   delay_ms
+
    • >>   PS2_TurnOnAnalogMode
+
    • >>   PS2_ShortPoll
+
    • >>   PS2_ReadData
+
    • >>   PS2_ExitConfing
+
    • >>   PS2_EnterConfing
+
    • >>   PS2_Cmd
+
    • >>   I2C_WriteByte
+
    • >>   I2C_WaiteForAck
+
    • >>   I2C_Stop
+
    • >>   I2C_Start
+
    • >>   I2C_ReadByte
+
    • >>   I2C_NAck
+
    • >>   I2C_Ack
+
    
+
+
    fabs (Thumb, 24 bytes, Stack size 8 bytes, fabs.o(i.fabs))
+

    [Stack]
    • Max Depth = 8
    • Call Chain = fabs
+
    
+
    [Called By]
    • >>   __kernel_tan
+
    • >>   __ieee754_rem_pio2
+
    • >>   __hardfp_pow
+
    • >>   __hardfp_atan
+
    
+
+
    float_abs (Thumb, 26 bytes, Stack size 0 bytes, balance.o(i.float_abs))
+

    [Called By]
    • >>   Smooth_control
+
    
+
+
    fputc (Thumb, 24 bytes, Stack size 0 bytes, usart.o(i.fputc))
+
    [Address Reference Count : 1]
    •  _printf_char_file.o(.text)
+
    
+
    getSysTickCnt (Thumb, 22 bytes, Stack size 8 bytes, delay.o(i.getSysTickCnt))
+

    [Stack]
    • Max Depth = 8
    • Call Chain = getSysTickCnt
+
    
+
    [Calls]
    • >>   xTaskGetTickCount
+
    • >>   xTaskGetSchedulerState
+
    
+
    [Called By]
    • >>   show_task
+
    • >>   pstwo_task
+
    • >>   data_task
+
    • >>   MPU6050_task
+
    • >>   Balance_task
+
    
+
+
    led_task (Thumb, 24 bytes, Stack size 0 bytes, led.o(i.led_task))
+

    [Stack]
    • Max Depth = 184 + Unknown Stack Size
+
    • Call Chain = led_task ⇒ vTaskDelay ⇒ xTaskResumeAll ⇒ xTaskIncrementTick ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   vTaskDelay
+
    
+
    [Address Reference Count : 1]
    •  main.o(i.start_task)
+
    
+
    main (Thumb, 34 bytes, Stack size 16 bytes, main.o(i.main))
+

    [Stack]
    • Max Depth = 312 + Unknown Stack Size
+
    • Call Chain = main ⇒ vTaskStartScheduler ⇒ xTimerCreateTimerTask ⇒ xTaskCreate ⇒ pvPortMalloc ⇒ xTaskResumeAll ⇒ xTaskIncrementTick ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   xTaskCreate
+
    • >>   vTaskStartScheduler
+
    • >>   systemInit
+
    
+
    [Called By]
    • >>   __rt_entry_main
+
    
+
+
    oled_pow (Thumb, 22 bytes, Stack size 8 bytes, oled.o(i.oled_pow))
+

    [Stack]
    • Max Depth = 8
    • Call Chain = oled_pow
+
    
+
    [Called By]
    • >>   OLED_ShowNumber
+
    
+
+
    oled_show (Thumb, 2932 bytes, Stack size 16 bytes, show.o(i.oled_show))
+

    [Stack]
    • Max Depth = 240 + Unknown Stack Size
+
    • Call Chain = oled_show ⇒ Get_adc_Average ⇒ delay_ms ⇒ vTaskDelay ⇒ xTaskResumeAll ⇒ xTaskIncrementTick ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   Get_adc_Average
+
    • >>   OLED_ShowString
+
    • >>   OLED_ShowNumber
+
    • >>   OLED_Refresh_Gram
+
    
+
    [Called By]
    • >>   show_task
+
    
+
+
    pstwo_task (Thumb, 24 bytes, Stack size 8 bytes, pstwo.o(i.pstwo_task))
+

    [Stack]
    • Max Depth = 208 + Unknown Stack Size
+
    • Call Chain = pstwo_task ⇒ vTaskDelayUntil ⇒ xTaskResumeAll ⇒ xTaskIncrementTick ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   vTaskDelayUntil
+
    • >>   getSysTickCnt
+
    • >>   PS2_Read
+
    
+
    [Address Reference Count : 1]
    •  main.o(i.start_task)
+
    
+
    pvPortMalloc (Thumb, 262 bytes, Stack size 24 bytes, heap_4.o(i.pvPortMalloc))
+

    [Stack]
    • Max Depth = 192 + Unknown Stack Size
+
    • Call Chain = pvPortMalloc ⇒ xTaskResumeAll ⇒ xTaskIncrementTick ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   xTaskResumeAll
+
    • >>   vTaskSuspendAll
+
    • >>   prvInsertBlockIntoFreeList
+
    • >>   prvHeapInit
+
    • >>   __2printf
+
    
+
    [Called By]
    • >>   xTaskCreate
+
    • >>   xQueueGenericCreate
+
    
+
+
    pvTaskIncrementMutexHeldCount (Thumb, 26 bytes, Stack size 0 bytes, tasks.o(i.pvTaskIncrementMutexHeldCount))
+

    [Called By]
    • >>   xQueueGenericReceive
+
    
+
+
    pxPortInitialiseStack (Thumb, 38 bytes, Stack size 0 bytes, port.o(i.pxPortInitialiseStack))
+

    [Called By]
    • >>   prvInitialiseNewTask
+
    
+
+
    show_task (Thumb, 360 bytes, Stack size 8 bytes, show.o(i.show_task))
+

    [Stack]
    • Max Depth = 248 + Unknown Stack Size
+
    • Call Chain = show_task ⇒ oled_show ⇒ Get_adc_Average ⇒ delay_ms ⇒ vTaskDelay ⇒ xTaskResumeAll ⇒ xTaskIncrementTick ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   Get_battery_volt
+
    • >>   vTaskDelayUntil
+
    • >>   getSysTickCnt
+
    • >>   oled_show
+
    • >>   APP_Show
+
    
+
    [Address Reference Count : 1]
    •  main.o(i.start_task)
+
    
+
    sqrt (Thumb, 110 bytes, Stack size 32 bytes, sqrt.o(i.sqrt))
+

    [Stack]
    • Max Depth = 72
    • Call Chain = sqrt ⇒ _dsqrt ⇒ __fpl_dnaninf
+
    
+
    [Calls]
    • >>   _dsqrt
+
    • >>   __set_errno
+
    
+
    [Called By]
    • >>   __hardfp_pow
+
    
+
+
    start_task (Thumb, 146 bytes, Stack size 16 bytes, main.o(i.start_task))
+

    [Stack]
    • Max Depth = 280 + Unknown Stack Size
+
    • Call Chain = start_task ⇒ xTaskCreate ⇒ pvPortMalloc ⇒ xTaskResumeAll ⇒ xTaskIncrementTick ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   xTaskCreate
+
    • >>   vTaskDelete
+
    • >>   vPortExitCritical
+
    • >>   vPortEnterCritical
+
    
+
    [Address Reference Count : 1]
    •  main.o(i.main)
+
    
+
    systemInit (Thumb, 190 bytes, Stack size 8 bytes, system.o(i.systemInit))
+

    [Stack]
    • Max Depth = 240 + Unknown Stack Size
+
    • Call Chain = systemInit ⇒ Robot_Select ⇒ Get_adc_Average ⇒ delay_ms ⇒ vTaskDelay ⇒ xTaskResumeAll ⇒ xTaskIncrementTick ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   TIM9_PWM_Init
+
    • >>   TIM1_PWM_Init
+
    • >>   TIM11_PWM_Init
+
    • >>   TIM10_PWM_Init
+
    • >>   Enable_Pin
+
    • >>   LED_Init
+
    • >>   Buzzer_Init
+
    • >>   KEY_Init
+
    • >>   Encoder_Init_TIM5
+
    • >>   Encoder_Init_TIM4
+
    • >>   Encoder_Init_TIM3
+
    • >>   Encoder_Init_TIM2
+
    • >>   CAN1_Mode_Init
+
    • >>   Adc_POWER_Init
+
    • >>   Adc_Init
+
    • >>   NVIC_PriorityGroupConfig
+
    • >>   delay_init
+
    • >>   uart5_init
+
    • >>   uart3_init
+
    • >>   uart2_init
+
    • >>   uart1_init
+
    • >>   TIM8_Cap_Init
+
    • >>   TIM12_SERVO_Init
+
    • >>   PS2_SetInit
+
    • >>   PS2_Init
+
    • >>   OLED_Init
+
    • >>   Robot_Select
+
    • >>   MPU6050_initialize
+
    • >>   I2C_GPIOInit
+
    
+
    [Called By]
    • >>   main
+
    
+
+
    target_limit_float (Thumb, 42 bytes, Stack size 0 bytes, balance.o(i.target_limit_float))
+

    [Called By]
    • >>   Smooth_control
+
    • >>   Limit_Pwm
+
    • >>   Drive_Motor
+
    
+
+
    target_limit_int (Thumb, 22 bytes, Stack size 0 bytes, balance.o(i.target_limit_int))
+

    [Called By]
    • >>   Remote_Control
+
    • >>   Drive_Motor
+
    
+
+
    uart1_init (Thumb, 168 bytes, Stack size 40 bytes, usartx.o(i.uart1_init))
+

    [Stack]
    • Max Depth = 108
    • Call Chain = uart1_init ⇒ USART_Init ⇒ RCC_GetClocksFreq
+
    
+
    [Calls]
    • >>   NVIC_Init
+
    • >>   GPIO_PinAFConfig
+
    • >>   RCC_APB2PeriphClockCmd
+
    • >>   RCC_AHB1PeriphClockCmd
+
    • >>   GPIO_Init
+
    • >>   USART_Init
+
    • >>   USART_ITConfig
+
    • >>   USART_Cmd
+
    
+
    [Called By]
    • >>   systemInit
+
    
+
+
    uart2_init (Thumb, 166 bytes, Stack size 40 bytes, usartx.o(i.uart2_init))
+

    [Stack]
    • Max Depth = 108
    • Call Chain = uart2_init ⇒ USART_Init ⇒ RCC_GetClocksFreq
+
    
+
    [Calls]
    • >>   RCC_APB1PeriphClockCmd
+
    • >>   NVIC_Init
+
    • >>   GPIO_PinAFConfig
+
    • >>   RCC_AHB1PeriphClockCmd
+
    • >>   GPIO_Init
+
    • >>   USART_Init
+
    • >>   USART_ITConfig
+
    • >>   USART_Cmd
+
    
+
    [Called By]
    • >>   systemInit
+
    
+
+
    uart3_init (Thumb, 168 bytes, Stack size 40 bytes, usartx.o(i.uart3_init))
+

    [Stack]
    • Max Depth = 108
    • Call Chain = uart3_init ⇒ USART_Init ⇒ RCC_GetClocksFreq
+
    
+
    [Calls]
    • >>   RCC_APB1PeriphClockCmd
+
    • >>   NVIC_Init
+
    • >>   GPIO_PinAFConfig
+
    • >>   RCC_AHB1PeriphClockCmd
+
    • >>   GPIO_Init
+
    • >>   USART_Init
+
    • >>   USART_ITConfig
+
    • >>   USART_Cmd
+
    
+
    [Called By]
    • >>   systemInit
+
    
+
+
    uart5_init (Thumb, 212 bytes, Stack size 40 bytes, usartx.o(i.uart5_init))
+

    [Stack]
    • Max Depth = 108
    • Call Chain = uart5_init ⇒ USART_Init ⇒ RCC_GetClocksFreq
+
    
+
    [Calls]
    • >>   RCC_APB1PeriphClockCmd
+
    • >>   NVIC_Init
+
    • >>   GPIO_PinAFConfig
+
    • >>   RCC_AHB1PeriphClockCmd
+
    • >>   GPIO_Init
+
    • >>   USART_Init
+
    • >>   USART_ITConfig
+
    • >>   USART_Cmd
+
    
+
    [Called By]
    • >>   systemInit
+
    
+
+
    usart1_send (Thumb, 20 bytes, Stack size 0 bytes, usartx.o(i.usart1_send))
+

    [Called By]
    • >>   USART1_SEND
+
    
+
+
    usart3_send (Thumb, 22 bytes, Stack size 0 bytes, usartx.o(i.usart3_send))
+

    [Called By]
    • >>   USART3_SEND
+
    
+
+
    usart5_send (Thumb, 20 bytes, Stack size 0 bytes, usartx.o(i.usart5_send))
+

    [Called By]
    • >>   USART5_SEND
+
    
+
+
    uxListRemove (Thumb, 40 bytes, Stack size 0 bytes, list.o(i.uxListRemove))
+

    [Called By]
    • >>   vTaskDelete
+
    • >>   prvCheckTasksWaitingTermination
+
    • >>   prvAddCurrentTaskToDelayedList
+
    • >>   xTaskRemoveFromEventList
+
    • >>   xTaskPriorityDisinherit
+
    • >>   vTaskPriorityInherit
+
    • >>   xTaskResumeAll
+
    • >>   prvSwitchTimerLists
+
    • >>   prvProcessReceivedCommands
+
    • >>   prvProcessExpiredTimer
+
    • >>   xTaskIncrementTick
+
    
+
+
    vListInitialise (Thumb, 26 bytes, Stack size 0 bytes, list.o(i.vListInitialise))
+

    [Called By]
    • >>   prvInitialiseTaskLists
+
    • >>   xQueueGenericReset
+
    • >>   prvCheckForValidListAndQueue
+
    
+
+
    vListInitialiseItem (Thumb, 6 bytes, Stack size 0 bytes, list.o(i.vListInitialiseItem))
+

    [Called By]
    • >>   prvInitialiseNewTask
+
    
+
+
    vListInsert (Thumb, 52 bytes, Stack size 8 bytes, list.o(i.vListInsert))
+

    [Stack]
    • Max Depth = 8
    • Call Chain = vListInsert
+
    
+
    [Called By]
    • >>   prvAddCurrentTaskToDelayedList
+
    • >>   vTaskPlaceOnEventList
+
    • >>   prvSwitchTimerLists
+
    • >>   prvInsertTimerInActiveList
+
    
+
+
    vListInsertEnd (Thumb, 24 bytes, Stack size 0 bytes, list.o(i.vListInsertEnd))
+

    [Called By]
    • >>   vTaskDelete
+
    • >>   prvAddNewTaskToReadyList
+
    • >>   prvAddCurrentTaskToDelayedList
+
    • >>   xTaskRemoveFromEventList
+
    • >>   xTaskPriorityDisinherit
+
    • >>   vTaskPriorityInherit
+
    • >>   vTaskPlaceOnEventListRestricted
+
    • >>   xTaskResumeAll
+
    • >>   xTaskIncrementTick
+
    
+
+
    vPortEnterCritical (Thumb, 68 bytes, Stack size 8 bytes, port.o(i.vPortEnterCritical))
+

    [Stack]
    • Max Depth = 136 + Unknown Stack Size
+
    • Call Chain = vPortEnterCritical ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   __2printf
+
    
+
    [Called By]
    • >>   vTaskDelete
+
    • >>   start_task
+
    • >>   prvCheckTasksWaitingTermination
+
    • >>   prvAddNewTaskToReadyList
+
    • >>   xTaskCheckForTimeOut
+
    • >>   xQueueGenericSend
+
    • >>   xQueueGenericReset
+
    • >>   xQueueGenericReceive
+
    • >>   vQueueWaitForMessageRestricted
+
    • >>   prvUnlockQueue
+
    • >>   prvIsQueueFull
+
    • >>   prvIsQueueEmpty
+
    • >>   xTaskResumeAll
+
    • >>   prvCheckForValidListAndQueue
+
    
+
+
    vPortExitCritical (Thumb, 48 bytes, Stack size 8 bytes, port.o(i.vPortExitCritical))
+

    [Stack]
    • Max Depth = 136 + Unknown Stack Size
+
    • Call Chain = vPortExitCritical ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   __2printf
+
    
+
    [Called By]
    • >>   vTaskDelete
+
    • >>   start_task
+
    • >>   prvCheckTasksWaitingTermination
+
    • >>   prvAddNewTaskToReadyList
+
    • >>   xTaskCheckForTimeOut
+
    • >>   xQueueGenericSend
+
    • >>   xQueueGenericReset
+
    • >>   xQueueGenericReceive
+
    • >>   vQueueWaitForMessageRestricted
+
    • >>   prvUnlockQueue
+
    • >>   prvIsQueueFull
+
    • >>   prvIsQueueEmpty
+
    • >>   xTaskResumeAll
+
    • >>   prvCheckForValidListAndQueue
+
    
+
+
    vPortFree (Thumb, 120 bytes, Stack size 16 bytes, heap_4.o(i.vPortFree))
+

    [Stack]
    • Max Depth = 184 + Unknown Stack Size
+
    • Call Chain = vPortFree ⇒ xTaskResumeAll ⇒ xTaskIncrementTick ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   xTaskResumeAll
+
    • >>   vTaskSuspendAll
+
    • >>   prvInsertBlockIntoFreeList
+
    • >>   __2printf
+
    
+
    [Called By]
    • >>   xTaskCreate
+
    • >>   prvDeleteTCB
+
    • >>   prvProcessReceivedCommands
+
    
+
+
    vPortSetupTimerInterrupt (Thumb, 26 bytes, Stack size 0 bytes, port.o(i.vPortSetupTimerInterrupt))
+

    [Called By]
    • >>   xPortStartScheduler
+
    
+
+
    vPortValidateInterruptPriority (Thumb, 86 bytes, Stack size 16 bytes, port.o(i.vPortValidateInterruptPriority))
+

    [Stack]
    • Max Depth = 144 + Unknown Stack Size
+
    • Call Chain = vPortValidateInterruptPriority ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   vPortGetIPSR
+
    • >>   __2printf
+
    
+
    [Called By]
    • >>   xQueueGenericSendFromISR
+
    
+
+
    vQueueAddToRegistry (Thumb, 38 bytes, Stack size 0 bytes, queue.o(i.vQueueAddToRegistry))
+

    [Called By]
    • >>   prvCheckForValidListAndQueue
+
    
+
+
    vQueueWaitForMessageRestricted (Thumb, 74 bytes, Stack size 24 bytes, queue.o(i.vQueueWaitForMessageRestricted))
+

    [Stack]
    • Max Depth = 240 + Unknown Stack Size
+
    • Call Chain = vQueueWaitForMessageRestricted ⇒ prvUnlockQueue ⇒ prvNotifyQueueSetContainer ⇒ prvCopyDataToQueue ⇒ xTaskPriorityDisinherit ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   vPortExitCritical
+
    • >>   vPortEnterCritical
+
    • >>   vTaskPlaceOnEventListRestricted
+
    • >>   prvUnlockQueue
+
    
+
    [Called By]
    • >>   prvProcessTimerOrBlockTask
+
    
+
+
    vTaskDelay (Thumb, 72 bytes, Stack size 16 bytes, tasks.o(i.vTaskDelay))
+

    [Stack]
    • Max Depth = 184 + Unknown Stack Size
+
    • Call Chain = vTaskDelay ⇒ xTaskResumeAll ⇒ xTaskIncrementTick ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   prvAddCurrentTaskToDelayedList
+
    • >>   xTaskResumeAll
+
    • >>   vTaskSuspendAll
+
    • >>   __2printf
+
    
+
    [Called By]
    • >>   delay_ms
+
    • >>   led_task
+
    
+
+
    vTaskDelayUntil (Thumb, 170 bytes, Stack size 32 bytes, tasks.o(i.vTaskDelayUntil))
+

    [Stack]
    • Max Depth = 200 + Unknown Stack Size
+
    • Call Chain = vTaskDelayUntil ⇒ xTaskResumeAll ⇒ xTaskIncrementTick ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   prvAddCurrentTaskToDelayedList
+
    • >>   xTaskResumeAll
+
    • >>   vTaskSuspendAll
+
    • >>   __2printf
+
    
+
    [Called By]
    • >>   show_task
+
    • >>   pstwo_task
+
    • >>   data_task
+
    • >>   MPU6050_task
+
    • >>   Balance_task
+
    
+
+
    vTaskDelete (Thumb, 192 bytes, Stack size 16 bytes, tasks.o(i.vTaskDelete))
+

    [Stack]
    • Max Depth = 208 + Unknown Stack Size
+
    • Call Chain = vTaskDelete ⇒ prvDeleteTCB ⇒ vPortFree ⇒ xTaskResumeAll ⇒ xTaskIncrementTick ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   vPortExitCritical
+
    • >>   vPortEnterCritical
+
    • >>   prvResetNextTaskUnblockTime
+
    • >>   prvDeleteTCB
+
    • >>   vListInsertEnd
+
    • >>   uxListRemove
+
    • >>   __2printf
+
    
+
    [Called By]
    • >>   start_task
+
    
+
+
    vTaskMissedYield (Thumb, 8 bytes, Stack size 0 bytes, tasks.o(i.vTaskMissedYield))
+

    [Called By]
    • >>   prvUnlockQueue
+
    
+
+
    vTaskPlaceOnEventList (Thumb, 42 bytes, Stack size 16 bytes, tasks.o(i.vTaskPlaceOnEventList))
+

    [Stack]
    • Max Depth = 144 + Unknown Stack Size
+
    • Call Chain = vTaskPlaceOnEventList ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   prvAddCurrentTaskToDelayedList
+
    • >>   vListInsert
+
    • >>   __2printf
+
    
+
    [Called By]
    • >>   xQueueGenericSend
+
    • >>   xQueueGenericReceive
+
    
+
+
    vTaskPlaceOnEventListRestricted (Thumb, 50 bytes, Stack size 16 bytes, tasks.o(i.vTaskPlaceOnEventListRestricted))
+

    [Stack]
    • Max Depth = 144 + Unknown Stack Size
+
    • Call Chain = vTaskPlaceOnEventListRestricted ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   prvAddCurrentTaskToDelayedList
+
    • >>   vListInsertEnd
+
    • >>   __2printf
+
    
+
    [Called By]
    • >>   vQueueWaitForMessageRestricted
+
    
+
+
    vTaskPriorityInherit (Thumb, 164 bytes, Stack size 16 bytes, tasks.o(i.vTaskPriorityInherit))
+

    [Stack]
    • Max Depth = 16
    • Call Chain = vTaskPriorityInherit
+
    
+
    [Calls]
    • >>   vListInsertEnd
+
    • >>   uxListRemove
+
    
+
    [Called By]
    • >>   xQueueGenericReceive
+
    
+
+
    vTaskSetTimeOutState (Thumb, 32 bytes, Stack size 8 bytes, tasks.o(i.vTaskSetTimeOutState))
+

    [Stack]
    • Max Depth = 136 + Unknown Stack Size
+
    • Call Chain = vTaskSetTimeOutState ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   __2printf
+
    
+
    [Called By]
    • >>   xTaskCheckForTimeOut
+
    • >>   xQueueGenericSend
+
    • >>   xQueueGenericReceive
+
    
+
+
    vTaskStartScheduler (Thumb, 108 bytes, Stack size 16 bytes, tasks.o(i.vTaskStartScheduler))
+

    [Stack]
    • Max Depth = 296 + Unknown Stack Size
+
    • Call Chain = vTaskStartScheduler ⇒ xTimerCreateTimerTask ⇒ xTaskCreate ⇒ pvPortMalloc ⇒ xTaskResumeAll ⇒ xTaskIncrementTick ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   xTaskCreate
+
    • >>   xTimerCreateTimerTask
+
    • >>   xPortStartScheduler
+
    • >>   __2printf
+
    
+
    [Called By]
    • >>   main
+
    
+
+
    vTaskSuspendAll (Thumb, 12 bytes, Stack size 0 bytes, tasks.o(i.vTaskSuspendAll))
+

    [Called By]
    • >>   vTaskDelay
+
    • >>   vTaskDelayUntil
+
    • >>   prvCheckTasksWaitingTermination
+
    • >>   xQueueGenericSend
+
    • >>   xQueueGenericReceive
+
    • >>   vPortFree
+
    • >>   pvPortMalloc
+
    • >>   prvProcessTimerOrBlockTask
+
    
+
+
    vTaskSwitchContext (Thumb, 110 bytes, Stack size 8 bytes, tasks.o(i.vTaskSwitchContext))
+

    [Stack]
    • Max Depth = 136 + Unknown Stack Size
+
    • Call Chain = vTaskSwitchContext ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   __2printf
+
    
+
    [Called By]
    • >>   PendSV_Handler
+
    
+
+
    xPortStartScheduler (Thumb, 258 bytes, Stack size 16 bytes, port.o(i.xPortStartScheduler))
+

    [Stack]
    • Max Depth = 144 + Unknown Stack Size
+
    • Call Chain = xPortStartScheduler ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   vPortSetupTimerInterrupt
+
    • >>   __asm___6_port_c_39a90d8d__prvEnableVFP
+
    • >>   __asm___6_port_c_39a90d8d__prvStartFirstTask
+
    • >>   __2printf
+
    
+
    [Called By]
    • >>   vTaskStartScheduler
+
    
+
+
    xPortSysTickHandler (Thumb, 46 bytes, Stack size 8 bytes, port.o(i.xPortSysTickHandler))
+

    [Stack]
    • Max Depth = 160 + Unknown Stack Size
+
    • Call Chain = xPortSysTickHandler ⇒ xTaskIncrementTick ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   xTaskIncrementTick
+
    
+
    [Called By]
    • >>   SysTick_Handler
+
    
+
+
    xQueueGenericCreate (Thumb, 78 bytes, Stack size 32 bytes, queue.o(i.xQueueGenericCreate))
+

    [Stack]
    • Max Depth = 224 + Unknown Stack Size
+
    • Call Chain = xQueueGenericCreate ⇒ pvPortMalloc ⇒ xTaskResumeAll ⇒ xTaskIncrementTick ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   prvInitialiseNewQueue
+
    • >>   pvPortMalloc
+
    • >>   __2printf
+
    
+
    [Called By]
    • >>   prvCheckForValidListAndQueue
+
    
+
+
    xQueueGenericReceive (Thumb, 416 bytes, Stack size 56 bytes, queue.o(i.xQueueGenericReceive))
+

    [Stack]
    • Max Depth = 272 + Unknown Stack Size
+
    • Call Chain = xQueueGenericReceive ⇒ prvUnlockQueue ⇒ prvNotifyQueueSetContainer ⇒ prvCopyDataToQueue ⇒ xTaskPriorityDisinherit ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   vPortExitCritical
+
    • >>   vPortEnterCritical
+
    • >>   xTaskGetSchedulerState
+
    • >>   xTaskRemoveFromEventList
+
    • >>   xTaskCheckForTimeOut
+
    • >>   vTaskSetTimeOutState
+
    • >>   vTaskPriorityInherit
+
    • >>   vTaskPlaceOnEventList
+
    • >>   pvTaskIncrementMutexHeldCount
+
    • >>   prvUnlockQueue
+
    • >>   prvIsQueueEmpty
+
    • >>   prvCopyDataFromQueue
+
    • >>   xTaskResumeAll
+
    • >>   vTaskSuspendAll
+
    • >>   __2printf
+
    
+
    [Called By]
    • >>   prvProcessReceivedCommands
+
    
+
+
    xQueueGenericReset (Thumb, 136 bytes, Stack size 16 bytes, queue.o(i.xQueueGenericReset))
+

    [Stack]
    • Max Depth = 160 + Unknown Stack Size
+
    • Call Chain = xQueueGenericReset ⇒ xTaskRemoveFromEventList ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   vPortExitCritical
+
    • >>   vPortEnterCritical
+
    • >>   xTaskRemoveFromEventList
+
    • >>   vListInitialise
+
    • >>   __2printf
+
    
+
    [Called By]
    • >>   prvInitialiseNewQueue
+
    
+
+
    xQueueGenericSend (Thumb, 412 bytes, Stack size 56 bytes, queue.o(i.xQueueGenericSend))
+

    [Stack]
    • Max Depth = 272 + Unknown Stack Size
+
    • Call Chain = xQueueGenericSend ⇒ prvUnlockQueue ⇒ prvNotifyQueueSetContainer ⇒ prvCopyDataToQueue ⇒ xTaskPriorityDisinherit ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   vPortExitCritical
+
    • >>   vPortEnterCritical
+
    • >>   xTaskGetSchedulerState
+
    • >>   xTaskRemoveFromEventList
+
    • >>   xTaskCheckForTimeOut
+
    • >>   vTaskSetTimeOutState
+
    • >>   vTaskPlaceOnEventList
+
    • >>   prvUnlockQueue
+
    • >>   prvNotifyQueueSetContainer
+
    • >>   prvIsQueueFull
+
    • >>   prvCopyDataToQueue
+
    • >>   xTaskResumeAll
+
    • >>   vTaskSuspendAll
+
    • >>   __2printf
+
    
+
    [Called By]
    • >>   xTimerGenericCommand
+
    
+
+
    xQueueGenericSendFromISR (Thumb, 234 bytes, Stack size 40 bytes, queue.o(i.xQueueGenericSendFromISR))
+

    [Stack]
    • Max Depth = 240 + Unknown Stack Size
+
    • Call Chain = xQueueGenericSendFromISR ⇒ prvNotifyQueueSetContainer ⇒ prvCopyDataToQueue ⇒ xTaskPriorityDisinherit ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   xTaskRemoveFromEventList
+
    • >>   vPortValidateInterruptPriority
+
    • >>   prvNotifyQueueSetContainer
+
    • >>   prvCopyDataToQueue
+
    • >>   __2printf
+
    
+
    [Called By]
    • >>   xTimerGenericCommand
+
    
+
+
    xTaskCheckForTimeOut (Thumb, 116 bytes, Stack size 24 bytes, tasks.o(i.xTaskCheckForTimeOut))
+

    [Stack]
    • Max Depth = 160 + Unknown Stack Size
+
    • Call Chain = xTaskCheckForTimeOut ⇒ vPortExitCritical ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   vPortExitCritical
+
    • >>   vPortEnterCritical
+
    • >>   vTaskSetTimeOutState
+
    • >>   __2printf
+
    
+
    [Called By]
    • >>   xQueueGenericSend
+
    • >>   xQueueGenericReceive
+
    
+
+
    xTaskCreate (Thumb, 96 bytes, Stack size 72 bytes, tasks.o(i.xTaskCreate))
+

    [Stack]
    • Max Depth = 264 + Unknown Stack Size
+
    • Call Chain = xTaskCreate ⇒ pvPortMalloc ⇒ xTaskResumeAll ⇒ xTaskIncrementTick ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   prvInitialiseNewTask
+
    • >>   prvAddNewTaskToReadyList
+
    • >>   vPortFree
+
    • >>   pvPortMalloc
+
    
+
    [Called By]
    • >>   vTaskStartScheduler
+
    • >>   start_task
+
    • >>   main
+
    • >>   xTimerCreateTimerTask
+
    
+
+
    xTaskGetSchedulerState (Thumb, 24 bytes, Stack size 0 bytes, tasks.o(i.xTaskGetSchedulerState))
+

    [Called By]
    • >>   delay_ms
+
    • >>   SysTick_Handler
+
    • >>   getSysTickCnt
+
    • >>   xQueueGenericSend
+
    • >>   xQueueGenericReceive
+
    • >>   xTimerGenericCommand
+
    
+
+
    xTaskGetTickCount (Thumb, 6 bytes, Stack size 0 bytes, tasks.o(i.xTaskGetTickCount))
+

    [Called By]
    • >>   getSysTickCnt
+
    • >>   prvSampleTimeNow
+
    
+
+
    xTaskIncrementTick (Thumb, 272 bytes, Stack size 24 bytes, tasks.o(i.xTaskIncrementTick))
+

    [Stack]
    • Max Depth = 152 + Unknown Stack Size
+
    • Call Chain = xTaskIncrementTick ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   prvResetNextTaskUnblockTime
+
    • >>   vListInsertEnd
+
    • >>   uxListRemove
+
    • >>   __2printf
+
    
+
    [Called By]
    • >>   xPortSysTickHandler
+
    • >>   xTaskResumeAll
+
    
+
+
    xTaskPriorityDisinherit (Thumb, 168 bytes, Stack size 16 bytes, tasks.o(i.xTaskPriorityDisinherit))
+

    [Stack]
    • Max Depth = 144 + Unknown Stack Size
+
    • Call Chain = xTaskPriorityDisinherit ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   vListInsertEnd
+
    • >>   uxListRemove
+
    • >>   __2printf
+
    
+
    [Called By]
    • >>   prvCopyDataToQueue
+
    
+
+
    xTaskRemoveFromEventList (Thumb, 118 bytes, Stack size 16 bytes, tasks.o(i.xTaskRemoveFromEventList))
+

    [Stack]
    • Max Depth = 144 + Unknown Stack Size
+
    • Call Chain = xTaskRemoveFromEventList ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   vListInsertEnd
+
    • >>   uxListRemove
+
    • >>   __2printf
+
    
+
    [Called By]
    • >>   xQueueGenericSendFromISR
+
    • >>   xQueueGenericSend
+
    • >>   xQueueGenericReset
+
    • >>   xQueueGenericReceive
+
    • >>   prvUnlockQueue
+
    • >>   prvNotifyQueueSetContainer
+
    
+
+
    xTaskResumeAll (Thumb, 214 bytes, Stack size 16 bytes, tasks.o(i.xTaskResumeAll))
+

    [Stack]
    • Max Depth = 168 + Unknown Stack Size
+
    • Call Chain = xTaskResumeAll ⇒ xTaskIncrementTick ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   vPortExitCritical
+
    • >>   vPortEnterCritical
+
    • >>   prvResetNextTaskUnblockTime
+
    • >>   vListInsertEnd
+
    • >>   uxListRemove
+
    • >>   xTaskIncrementTick
+
    • >>   __2printf
+
    
+
    [Called By]
    • >>   vTaskDelay
+
    • >>   vTaskDelayUntil
+
    • >>   prvCheckTasksWaitingTermination
+
    • >>   xQueueGenericSend
+
    • >>   xQueueGenericReceive
+
    • >>   vPortFree
+
    • >>   pvPortMalloc
+
    • >>   prvProcessTimerOrBlockTask
+
    
+
+
    xTimerCreateTimerTask (Thumb, 56 bytes, Stack size 16 bytes, timers.o(i.xTimerCreateTimerTask))
+

    [Stack]
    • Max Depth = 280 + Unknown Stack Size
+
    • Call Chain = xTimerCreateTimerTask ⇒ xTaskCreate ⇒ pvPortMalloc ⇒ xTaskResumeAll ⇒ xTaskIncrementTick ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   xTaskCreate
+
    • >>   prvCheckForValidListAndQueue
+
    • >>   __2printf
+
    
+
    [Called By]
    • >>   vTaskStartScheduler
+
    
+
+
    xTimerGenericCommand (Thumb, 118 bytes, Stack size 48 bytes, timers.o(i.xTimerGenericCommand))
+

    [Stack]
    • Max Depth = 320 + Unknown Stack Size
+
    • Call Chain = xTimerGenericCommand ⇒ xQueueGenericSend ⇒ prvUnlockQueue ⇒ prvNotifyQueueSetContainer ⇒ prvCopyDataToQueue ⇒ xTaskPriorityDisinherit ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   xTaskGetSchedulerState
+
    • >>   xQueueGenericSendFromISR
+
    • >>   xQueueGenericSend
+
    • >>   __2printf
+
    
+
    [Called By]
    • >>   prvSwitchTimerLists
+
    • >>   prvProcessReceivedCommands
+
    • >>   prvProcessExpiredTimer
+
    
+
+
    __aeabi_dneg (Thumb, 0 bytes, Stack size 0 bytes, basic.o(x$fpl$basic))
+

    [Called By]
    • >>   Drive_Motor
+
    • >>   __kernel_tan
+
    • >>   __ieee754_rem_pio2
+
    • >>   __hardfp_pow
+
    • >>   __hardfp_atan
+
    
+
+
    _dneg (Thumb, 6 bytes, Stack size 0 bytes, basic.o(x$fpl$basic), UNUSED)
+
+
    __aeabi_fneg (Thumb, 0 bytes, Stack size 0 bytes, basic.o(x$fpl$basic), UNUSED)
+
+
    _fneg (Thumb, 6 bytes, Stack size 0 bytes, basic.o(x$fpl$basic), UNUSED)
+
+
    _dabs (Thumb, 6 bytes, Stack size 0 bytes, basic.o(x$fpl$basic), UNUSED)
+
+
    _fabs (Thumb, 6 bytes, Stack size 0 bytes, basic.o(x$fpl$basic), UNUSED)
+
+
    __aeabi_d2f (Thumb, 0 bytes, Stack size 32 bytes, d2f.o(x$fpl$d2f))
+

    [Stack]
    • Max Depth = 32
    • Call Chain = __aeabi_d2f
+
    
+
    [Called By]
    • >>   Vz_to_Akm_Angle
+
    • >>   Get_battery_volt
+
    • >>   XYZ_Target_Speed_transition
+
    • >>   USART2_IRQHandler
+
    • >>   Robot_Init
+
    • >>   Drive_Motor
+
    
+
+
    _d2f (Thumb, 98 bytes, Stack size 32 bytes, d2f.o(x$fpl$d2f), UNUSED)
+

    [Calls]
    • >>   __fpl_fretinf
+
    • >>   __fpl_dnaninf
+
    
+
+
    __aeabi_dadd (Thumb, 0 bytes, Stack size 16 bytes, daddsub_clz.o(x$fpl$dadd))
+

    [Stack]
    • Max Depth = 16
    • Call Chain = __aeabi_dadd
+
    
+
    [Called By]
    • >>   Vz_to_Akm_Angle
+
    • >>   XYZ_Target_Speed_transition
+
    • >>   USART2_IRQHandler
+
    • >>   Drive_Motor
+
    • >>   __kernel_tan
+
    • >>   __ieee754_rem_pio2
+
    • >>   __kernel_poly
+
    • >>   __mathlib_dbl_infnan2
+
    • >>   __mathlib_dbl_infnan
+
    • >>   __hardfp_pow
+
    • >>   __hardfp_atan
+
    
+
+
    _dadd (Thumb, 332 bytes, Stack size 16 bytes, daddsub_clz.o(x$fpl$dadd), UNUSED)
+

    [Calls]
    • >>   __fpl_dretinf
+
    • >>   __fpl_dnaninf
+
    • >>   _dsub1
+
    
+
+
    __fpl_dcheck_NaN1 (Thumb, 10 bytes, Stack size 0 bytes, dcheck1.o(x$fpl$dcheck1))
+

    [Calls]
    • >>   __fpl_return_NaN
+
    
+
    [Called By]
    • >>   __ARM_scalbn
+
    
+
+
    __fpl_dcmp_Inf (Thumb, 24 bytes, Stack size 0 bytes, dcmpi.o(x$fpl$dcmpinf), UNUSED)
+

    [Called By]
    • >>   _dcmple
+
    
+
+
    __aeabi_ddiv (Thumb, 0 bytes, Stack size 32 bytes, ddiv.o(x$fpl$ddiv))
+

    [Stack]
    • Max Depth = 32
    • Call Chain = __aeabi_ddiv
+
    
+
    [Called By]
    • >>   Vz_to_Akm_Angle
+
    • >>   Get_battery_volt
+
    • >>   data_transition
+
    • >>   Drive_Motor
+
    • >>   __kernel_tan
+
    • >>   __mathlib_dbl_invalid
+
    • >>   __mathlib_dbl_divzero
+
    • >>   __hardfp_pow
+
    • >>   __hardfp_atan
+
    
+
+
    _ddiv (Thumb, 552 bytes, Stack size 32 bytes, ddiv.o(x$fpl$ddiv), UNUSED)
+

    [Calls]
    • >>   __fpl_dretinf
+
    • >>   __fpl_dnaninf
+
    
+
+
    __aeabi_d2iz (Thumb, 0 bytes, Stack size 32 bytes, dfix.o(x$fpl$dfix))
+

    [Stack]
    • Max Depth = 32
    • Call Chain = __aeabi_d2iz
+
    
+
    [Called By]
    • >>   data_transition
+
    • >>   __kernel_tan
+
    • >>   __ieee754_rem_pio2
+
    
+
+
    _dfix (Thumb, 94 bytes, Stack size 32 bytes, dfix.o(x$fpl$dfix), UNUSED)
+

    [Calls]
    • >>   __fpl_dnaninf
+
    
+
+
    __aeabi_i2d (Thumb, 0 bytes, Stack size 0 bytes, dflt_clz.o(x$fpl$dflt))
+

    [Called By]
    • >>   XYZ_Target_Speed_transition
+
    • >>   USART2_IRQHandler
+
    • >>   __kernel_tan
+
    • >>   __ieee754_rem_pio2
+
    • >>   __hardfp_pow
+
    
+
+
    _dflt (Thumb, 46 bytes, Stack size 0 bytes, dflt_clz.o(x$fpl$dflt), UNUSED)
+
+
    __aeabi_ui2d (Thumb, 0 bytes, Stack size 0 bytes, dflt_clz.o(x$fpl$dfltu))
+

    [Called By]
    • >>   Get_battery_volt
+
    • >>   __ieee754_rem_pio2
+
    
+
+
    _dfltu (Thumb, 38 bytes, Stack size 0 bytes, dflt_clz.o(x$fpl$dfltu), UNUSED)
+
+
    __aeabi_cdcmple (Thumb, 0 bytes, Stack size 32 bytes, dleqf.o(x$fpl$dleqf), UNUSED)
+
+
    _dcmple (Thumb, 120 bytes, Stack size 32 bytes, dleqf.o(x$fpl$dleqf), UNUSED)
+

    [Calls]
    • >>   __fpl_dcmp_Inf
+
    • >>   __fpl_dnaninf
+
    
+
+
    __fpl_dcmple_InfNaN (Thumb, 0 bytes, Stack size unknown bytes, dleqf.o(x$fpl$dleqf), UNUSED)
+

    [Called By]
    • >>   _drcmple
+
    
+
+
    __aeabi_dmul (Thumb, 0 bytes, Stack size 32 bytes, dmul.o(x$fpl$dmul))
+

    [Stack]
    • Max Depth = 32
    • Call Chain = __aeabi_dmul
+
    
+
    [Called By]
    • >>   Vz_to_Akm_Angle
+
    • >>   Get_battery_volt
+
    • >>   data_transition
+
    • >>   XYZ_Target_Speed_transition
+
    • >>   USART2_IRQHandler
+
    • >>   Drive_Motor
+
    • >>   __kernel_tan
+
    • >>   __ieee754_rem_pio2
+
    • >>   __kernel_poly
+
    • >>   __mathlib_dbl_underflow
+
    • >>   __mathlib_dbl_overflow
+
    • >>   __hardfp_pow
+
    • >>   __hardfp_atan
+
    
+
+
    _dmul (Thumb, 332 bytes, Stack size 32 bytes, dmul.o(x$fpl$dmul), UNUSED)
+

    [Calls]
    • >>   __fpl_dretinf
+
    • >>   __fpl_dnaninf
+
    
+
+
    __fpl_dnaninf (Thumb, 156 bytes, Stack size 16 bytes, dnaninf.o(x$fpl$dnaninf))
+

    [Stack]
    • Max Depth = 16
    • Call Chain = __fpl_dnaninf
+
    
+
    [Called By]
    • >>   _dsqrt
+
    • >>   _dcmple
+
    • >>   _dmul
+
    • >>   _dfix
+
    • >>   _ddiv
+
    • >>   _dsub
+
    • >>   _dadd
+
    • >>   _d2f
+
    
+
+
    __fpl_dretinf (Thumb, 12 bytes, Stack size 0 bytes, dretinf.o(x$fpl$dretinf), UNUSED)
+

    [Called By]
    • >>   _f2d
+
    • >>   _dmul
+
    • >>   _ddiv
+
    • >>   _dadd
+
    
+
+
    __aeabi_cdrcmple (Thumb, 0 bytes, Stack size 16 bytes, drleqf.o(x$fpl$drleqf))
+

    [Stack]
    • Max Depth = 16
    • Call Chain = __aeabi_cdrcmple
+
    
+
    [Called By]
    • >>   __hardfp_pow
+
    
+
+
    _drcmple (Thumb, 108 bytes, Stack size 16 bytes, drleqf.o(x$fpl$drleqf), UNUSED)
+

    [Calls]
    • >>   __fpl_dcmple_InfNaN
+
    
+
+
    __aeabi_drsub (Thumb, 0 bytes, Stack size 8 bytes, daddsub_clz.o(x$fpl$drsb))
+

    [Stack]
    • Max Depth = 8
    • Call Chain = __aeabi_drsub
+
    
+
    [Called By]
    • >>   __kernel_tan
+
    • >>   __ieee754_rem_pio2
+
    • >>   __hardfp_pow
+
    • >>   __hardfp_atan
+
    
+
+
    _drsb (Thumb, 22 bytes, Stack size 8 bytes, daddsub_clz.o(x$fpl$drsb), UNUSED)
+

    [Calls]
    • >>   _dsub1
+
    • >>   _dadd1
+
    
+
+
    _dsqrt (Thumb, 404 bytes, Stack size 24 bytes, dsqrt_umaal.o(x$fpl$dsqrt))
+

    [Stack]
    • Max Depth = 40
    • Call Chain = _dsqrt ⇒ __fpl_dnaninf
+
    
+
    [Calls]
    • >>   __fpl_dnaninf
+
    
+
    [Called By]
    • >>   sqrt
+
    • >>   __hardfp_sqrt
+
    
+
+
    __aeabi_dsub (Thumb, 0 bytes, Stack size 32 bytes, daddsub_clz.o(x$fpl$dsub))
+

    [Stack]
    • Max Depth = 32
    • Call Chain = __aeabi_dsub
+
    
+
    [Called By]
    • >>   Drive_Motor
+
    • >>   __kernel_tan
+
    • >>   __ieee754_rem_pio2
+
    • >>   __hardfp_pow
+
    • >>   __hardfp_atan
+
    
+
+
    _dsub (Thumb, 464 bytes, Stack size 32 bytes, daddsub_clz.o(x$fpl$dsub), UNUSED)
+

    [Calls]
    • >>   __fpl_dnaninf
+
    • >>   _dadd1
+
    
+
+
    __aeabi_f2d (Thumb, 0 bytes, Stack size 16 bytes, f2d.o(x$fpl$f2d))
+

    [Stack]
    • Max Depth = 16
    • Call Chain = __aeabi_f2d
+
    
+
    [Called By]
    • >>   Vz_to_Akm_Angle
+
    • >>   data_transition
+
    • >>   USART2_IRQHandler
+
    • >>   Drive_Motor
+
    
+
+
    _f2d (Thumb, 86 bytes, Stack size 16 bytes, f2d.o(x$fpl$f2d), UNUSED)
+

    [Calls]
    • >>   __fpl_fnaninf
+
    • >>   __fpl_dretinf
+
    
+
+
    __fpl_fnaninf (Thumb, 140 bytes, Stack size 8 bytes, fnaninf.o(x$fpl$fnaninf), UNUSED)
+

    [Called By]
    • >>   _f2d
+
    
+
+
    _fp_init (Thumb, 10 bytes, Stack size 0 bytes, fpinit.o(x$fpl$fpinit))
+

    [Called By]
    • >>   __rt_lib_init_fp_1
+
    
+
+
    __fplib_config_fpu_vfp (Thumb, 0 bytes, Stack size unknown bytes, fpinit.o(x$fpl$fpinit), UNUSED)
+
+
    __fplib_config_pureend_doubles (Thumb, 0 bytes, Stack size unknown bytes, fpinit.o(x$fpl$fpinit), UNUSED)
+
+
    __fpl_fretinf (Thumb, 10 bytes, Stack size 0 bytes, fretinf.o(x$fpl$fretinf), UNUSED)
+

    [Called By]
    • >>   _d2f
+
    
+
+
    __fpl_return_NaN (Thumb, 100 bytes, Stack size 0 bytes, retnan.o(x$fpl$retnan))
+

    [Calls]
    • >>   __fpl_cmpreturn
+
    
+
    [Called By]
    • >>   __fpl_dcheck_NaN1
+
    
+
+
    __ARM_scalbn (Thumb, 92 bytes, Stack size 0 bytes, scalbn.o(x$fpl$scalbn))
+

    [Calls]
    • >>   __fpl_dcheck_NaN1
+
    
+
    [Called By]
    • >>   __hardfp_pow
+
    
+
+
    __fpl_cmpreturn (Thumb, 48 bytes, Stack size 0 bytes, trapv.o(x$fpl$trapveneer))
+

    [Called By]
    • >>   __fpl_return_NaN
+
    
+
    
+
    
+Local Symbols
+
    
+
    SetSysClock (Thumb, 220 bytes, Stack size 12 bytes, system_stm32f4xx.o(i.SetSysClock))
+

    [Stack]
    • Max Depth = 12
    • Call Chain = SetSysClock
+
    
+
    [Called By]
    • >>   SystemInit
+
    
+
+
    TI1_Config (Thumb, 58 bytes, Stack size 20 bytes, stm32f4xx_tim.o(i.TI1_Config))
+

    [Stack]
    • Max Depth = 20
    • Call Chain = TI1_Config
+
    
+
    [Called By]
    • >>   TIM_ICInit
+
    
+
+
    TI2_Config (Thumb, 80 bytes, Stack size 20 bytes, stm32f4xx_tim.o(i.TI2_Config))
+

    [Stack]
    • Max Depth = 20
    • Call Chain = TI2_Config
+
    
+
    [Called By]
    • >>   TIM_ICInit
+
    
+
+
    TI3_Config (Thumb, 72 bytes, Stack size 20 bytes, stm32f4xx_tim.o(i.TI3_Config))
+

    [Stack]
    • Max Depth = 20
    • Call Chain = TI3_Config
+
    
+
    [Called By]
    • >>   TIM_ICInit
+
    
+
+
    TI4_Config (Thumb, 80 bytes, Stack size 20 bytes, stm32f4xx_tim.o(i.TI4_Config))
+

    [Stack]
    • Max Depth = 20
    • Call Chain = TI4_Config
+
    
+
    [Called By]
    • >>   TIM_ICInit
+
    
+
+
    prvCopyDataFromQueue (Thumb, 42 bytes, Stack size 16 bytes, queue.o(i.prvCopyDataFromQueue))
+

    [Stack]
    • Max Depth = 16
    • Call Chain = prvCopyDataFromQueue
+
    
+
    [Calls]
    • >>   __aeabi_memcpy
+
    
+
    [Called By]
    • >>   xQueueGenericReceive
+
    
+
+
    prvCopyDataToQueue (Thumb, 124 bytes, Stack size 24 bytes, queue.o(i.prvCopyDataToQueue))
+

    [Stack]
    • Max Depth = 168 + Unknown Stack Size
+
    • Call Chain = prvCopyDataToQueue ⇒ xTaskPriorityDisinherit ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   xTaskPriorityDisinherit
+
    • >>   __aeabi_memcpy
+
    
+
    [Called By]
    • >>   xQueueGenericSendFromISR
+
    • >>   xQueueGenericSend
+
    • >>   prvNotifyQueueSetContainer
+
    
+
+
    prvInitialiseNewQueue (Thumb, 46 bytes, Stack size 24 bytes, queue.o(i.prvInitialiseNewQueue))
+

    [Stack]
    • Max Depth = 184 + Unknown Stack Size
+
    • Call Chain = prvInitialiseNewQueue ⇒ xQueueGenericReset ⇒ xTaskRemoveFromEventList ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   xQueueGenericReset
+
    
+
    [Called By]
    • >>   xQueueGenericCreate
+
    
+
+
    prvIsQueueEmpty (Thumb, 26 bytes, Stack size 16 bytes, queue.o(i.prvIsQueueEmpty))
+

    [Stack]
    • Max Depth = 152 + Unknown Stack Size
+
    • Call Chain = prvIsQueueEmpty ⇒ vPortExitCritical ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   vPortExitCritical
+
    • >>   vPortEnterCritical
+
    
+
    [Called By]
    • >>   xQueueGenericReceive
+
    
+
+
    prvIsQueueFull (Thumb, 30 bytes, Stack size 16 bytes, queue.o(i.prvIsQueueFull))
+

    [Stack]
    • Max Depth = 152 + Unknown Stack Size
+
    • Call Chain = prvIsQueueFull ⇒ vPortExitCritical ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   vPortExitCritical
+
    • >>   vPortEnterCritical
+
    
+
    [Called By]
    • >>   xQueueGenericSend
+
    
+
+
    prvNotifyQueueSetContainer (Thumb, 124 bytes, Stack size 32 bytes, queue.o(i.prvNotifyQueueSetContainer))
+

    [Stack]
    • Max Depth = 200 + Unknown Stack Size
+
    • Call Chain = prvNotifyQueueSetContainer ⇒ prvCopyDataToQueue ⇒ xTaskPriorityDisinherit ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   xTaskRemoveFromEventList
+
    • >>   prvCopyDataToQueue
+
    • >>   __2printf
+
    
+
    [Called By]
    • >>   xQueueGenericSendFromISR
+
    • >>   xQueueGenericSend
+
    • >>   prvUnlockQueue
+
    
+
+
    prvUnlockQueue (Thumb, 146 bytes, Stack size 16 bytes, queue.o(i.prvUnlockQueue))
+

    [Stack]
    • Max Depth = 216 + Unknown Stack Size
+
    • Call Chain = prvUnlockQueue ⇒ prvNotifyQueueSetContainer ⇒ prvCopyDataToQueue ⇒ xTaskPriorityDisinherit ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   vPortExitCritical
+
    • >>   vPortEnterCritical
+
    • >>   xTaskRemoveFromEventList
+
    • >>   vTaskMissedYield
+
    • >>   prvNotifyQueueSetContainer
+
    
+
    [Called By]
    • >>   xQueueGenericSend
+
    • >>   xQueueGenericReceive
+
    • >>   vQueueWaitForMessageRestricted
+
    
+
+
    prvAddCurrentTaskToDelayedList (Thumb, 124 bytes, Stack size 24 bytes, tasks.o(i.prvAddCurrentTaskToDelayedList))
+

    [Stack]
    • Max Depth = 32
    • Call Chain = prvAddCurrentTaskToDelayedList ⇒ vListInsert
+
    
+
    [Calls]
    • >>   vListInsertEnd
+
    • >>   vListInsert
+
    • >>   uxListRemove
+
    
+
    [Called By]
    • >>   vTaskDelay
+
    • >>   vTaskDelayUntil
+
    • >>   vTaskPlaceOnEventListRestricted
+
    • >>   vTaskPlaceOnEventList
+
    
+
+
    prvAddNewTaskToReadyList (Thumb, 156 bytes, Stack size 8 bytes, tasks.o(i.prvAddNewTaskToReadyList))
+

    [Stack]
    • Max Depth = 144 + Unknown Stack Size
+
    • Call Chain = prvAddNewTaskToReadyList ⇒ vPortExitCritical ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   vPortExitCritical
+
    • >>   vPortEnterCritical
+
    • >>   prvInitialiseTaskLists
+
    • >>   vListInsertEnd
+
    
+
    [Called By]
    • >>   xTaskCreate
+
    
+
+
    prvCheckTasksWaitingTermination (Thumb, 86 bytes, Stack size 16 bytes, tasks.o(i.prvCheckTasksWaitingTermination))
+

    [Stack]
    • Max Depth = 208 + Unknown Stack Size
+
    • Call Chain = prvCheckTasksWaitingTermination ⇒ prvDeleteTCB ⇒ vPortFree ⇒ xTaskResumeAll ⇒ xTaskIncrementTick ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   vPortExitCritical
+
    • >>   vPortEnterCritical
+
    • >>   prvDeleteTCB
+
    • >>   uxListRemove
+
    • >>   xTaskResumeAll
+
    • >>   vTaskSuspendAll
+
    
+
    [Called By]
    • >>   prvIdleTask
+
    
+
+
    prvDeleteTCB (Thumb, 18 bytes, Stack size 8 bytes, tasks.o(i.prvDeleteTCB))
+

    [Stack]
    • Max Depth = 192 + Unknown Stack Size
+
    • Call Chain = prvDeleteTCB ⇒ vPortFree ⇒ xTaskResumeAll ⇒ xTaskIncrementTick ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   vPortFree
+
    
+
    [Called By]
    • >>   vTaskDelete
+
    • >>   prvCheckTasksWaitingTermination
+
    
+
+
    prvIdleTask (Thumb, 32 bytes, Stack size 0 bytes, tasks.o(i.prvIdleTask))
+

    [Stack]
    • Max Depth = 208 + Unknown Stack Size
+
    • Call Chain = prvIdleTask ⇒ prvCheckTasksWaitingTermination ⇒ prvDeleteTCB ⇒ vPortFree ⇒ xTaskResumeAll ⇒ xTaskIncrementTick ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   prvCheckTasksWaitingTermination
+
    
+
    [Address Reference Count : 1]
    •  tasks.o(i.vTaskStartScheduler)
+
    
+
    prvInitialiseNewTask (Thumb, 170 bytes, Stack size 40 bytes, tasks.o(i.prvInitialiseNewTask))
+

    [Stack]
    • Max Depth = 168 + Unknown Stack Size
+
    • Call Chain = prvInitialiseNewTask ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   vListInitialiseItem
+
    • >>   pxPortInitialiseStack
+
    • >>   __aeabi_memset
+
    • >>   __2printf
+
    
+
    [Called By]
    • >>   xTaskCreate
+
    
+
+
    prvInitialiseTaskLists (Thumb, 70 bytes, Stack size 8 bytes, tasks.o(i.prvInitialiseTaskLists))
+

    [Stack]
    • Max Depth = 8
    • Call Chain = prvInitialiseTaskLists
+
    
+
    [Calls]
    • >>   vListInitialise
+
    
+
    [Called By]
    • >>   prvAddNewTaskToReadyList
+
    
+
+
    prvResetNextTaskUnblockTime (Thumb, 42 bytes, Stack size 0 bytes, tasks.o(i.prvResetNextTaskUnblockTime))
+

    [Called By]
    • >>   vTaskDelete
+
    • >>   xTaskResumeAll
+
    • >>   xTaskIncrementTick
+
    
+
+
    prvCheckForValidListAndQueue (Thumb, 72 bytes, Stack size 8 bytes, timers.o(i.prvCheckForValidListAndQueue))
+

    [Stack]
    • Max Depth = 232 + Unknown Stack Size
+
    • Call Chain = prvCheckForValidListAndQueue ⇒ xQueueGenericCreate ⇒ pvPortMalloc ⇒ xTaskResumeAll ⇒ xTaskIncrementTick ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   vPortExitCritical
+
    • >>   vPortEnterCritical
+
    • >>   xQueueGenericCreate
+
    • >>   vQueueAddToRegistry
+
    • >>   vListInitialise
+
    
+
    [Called By]
    • >>   xTimerCreateTimerTask
+
    
+
+
    prvGetNextExpireTime (Thumb, 36 bytes, Stack size 0 bytes, timers.o(i.prvGetNextExpireTime))
+

    [Called By]
    • >>   prvTimerTask
+
    
+
+
    prvInsertTimerInActiveList (Thumb, 80 bytes, Stack size 24 bytes, timers.o(i.prvInsertTimerInActiveList))
+

    [Stack]
    • Max Depth = 32
    • Call Chain = prvInsertTimerInActiveList ⇒ vListInsert
+
    
+
    [Calls]
    • >>   vListInsert
+
    
+
    [Called By]
    • >>   prvProcessReceivedCommands
+
    • >>   prvProcessExpiredTimer
+
    
+
+
    prvProcessExpiredTimer (Thumb, 84 bytes, Stack size 24 bytes, timers.o(i.prvProcessExpiredTimer))
+

    [Stack]
    • Max Depth = 344 + Unknown Stack Size
+
    • Call Chain = prvProcessExpiredTimer ⇒ xTimerGenericCommand ⇒ xQueueGenericSend ⇒ prvUnlockQueue ⇒ prvNotifyQueueSetContainer ⇒ prvCopyDataToQueue ⇒ xTaskPriorityDisinherit ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   uxListRemove
+
    • >>   xTimerGenericCommand
+
    • >>   prvInsertTimerInActiveList
+
    • >>   __2printf
+
    
+
    [Called By]
    • >>   prvProcessTimerOrBlockTask
+
    
+
+
    prvProcessReceivedCommands (Thumb, 254 bytes, Stack size 48 bytes, timers.o(i.prvProcessReceivedCommands))
+

    [Stack]
    • Max Depth = 416 + Unknown Stack Size
+
    • Call Chain = prvProcessReceivedCommands ⇒ prvSampleTimeNow ⇒ prvSwitchTimerLists ⇒ xTimerGenericCommand ⇒ xQueueGenericSend ⇒ prvUnlockQueue ⇒ prvNotifyQueueSetContainer ⇒ prvCopyDataToQueue ⇒ xTaskPriorityDisinherit ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   xQueueGenericReceive
+
    • >>   uxListRemove
+
    • >>   vPortFree
+
    • >>   xTimerGenericCommand
+
    • >>   prvSampleTimeNow
+
    • >>   prvInsertTimerInActiveList
+
    • >>   __2printf
+
    
+
    [Called By]
    • >>   prvTimerTask
+
    
+
+
    prvProcessTimerOrBlockTask (Thumb, 102 bytes, Stack size 24 bytes, timers.o(i.prvProcessTimerOrBlockTask))
+

    [Stack]
    • Max Depth = 392 + Unknown Stack Size
+
    • Call Chain = prvProcessTimerOrBlockTask ⇒ prvSampleTimeNow ⇒ prvSwitchTimerLists ⇒ xTimerGenericCommand ⇒ xQueueGenericSend ⇒ prvUnlockQueue ⇒ prvNotifyQueueSetContainer ⇒ prvCopyDataToQueue ⇒ xTaskPriorityDisinherit ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   vQueueWaitForMessageRestricted
+
    • >>   xTaskResumeAll
+
    • >>   vTaskSuspendAll
+
    • >>   prvSampleTimeNow
+
    • >>   prvProcessExpiredTimer
+
    
+
    [Called By]
    • >>   prvTimerTask
+
    
+
+
    prvSampleTimeNow (Thumb, 40 bytes, Stack size 16 bytes, timers.o(i.prvSampleTimeNow))
+

    [Stack]
    • Max Depth = 368 + Unknown Stack Size
+
    • Call Chain = prvSampleTimeNow ⇒ prvSwitchTimerLists ⇒ xTimerGenericCommand ⇒ xQueueGenericSend ⇒ prvUnlockQueue ⇒ prvNotifyQueueSetContainer ⇒ prvCopyDataToQueue ⇒ xTaskPriorityDisinherit ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   xTaskGetTickCount
+
    • >>   prvSwitchTimerLists
+
    
+
    [Called By]
    • >>   prvProcessTimerOrBlockTask
+
    • >>   prvProcessReceivedCommands
+
    
+
+
    prvSwitchTimerLists (Thumb, 140 bytes, Stack size 32 bytes, timers.o(i.prvSwitchTimerLists))
+

    [Stack]
    • Max Depth = 352 + Unknown Stack Size
+
    • Call Chain = prvSwitchTimerLists ⇒ xTimerGenericCommand ⇒ xQueueGenericSend ⇒ prvUnlockQueue ⇒ prvNotifyQueueSetContainer ⇒ prvCopyDataToQueue ⇒ xTaskPriorityDisinherit ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   vListInsert
+
    • >>   uxListRemove
+
    • >>   xTimerGenericCommand
+
    • >>   __2printf
+
    
+
    [Called By]
    • >>   prvSampleTimeNow
+
    
+
+
    prvTimerTask (Thumb, 26 bytes, Stack size 8 bytes, timers.o(i.prvTimerTask))
+

    [Stack]
    • Max Depth = 424 + Unknown Stack Size
+
    • Call Chain = prvTimerTask ⇒ prvProcessReceivedCommands ⇒ prvSampleTimeNow ⇒ prvSwitchTimerLists ⇒ xTimerGenericCommand ⇒ xQueueGenericSend ⇒ prvUnlockQueue ⇒ prvNotifyQueueSetContainer ⇒ prvCopyDataToQueue ⇒ xTaskPriorityDisinherit ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   prvProcessTimerOrBlockTask
+
    • >>   prvProcessReceivedCommands
+
    • >>   prvGetNextExpireTime
+
    
+
    [Address Reference Count : 1]
    •  timers.o(i.xTimerCreateTimerTask)
+
    
+
    prvTaskExitError (Thumb, 50 bytes, Stack size 0 bytes, port.o(i.prvTaskExitError))
+

    [Stack]
    • Max Depth = 128 + Unknown Stack Size
+
    • Call Chain = prvTaskExitError ⇒ __2printf ⇒ _printf_char_file ⇒ _printf_char_common ⇒ __printf
+
    
+
    [Calls]
    • >>   __2printf
+
    
+
    [Address Reference Count : 1]
    •  port.o(i.pxPortInitialiseStack)
+
    
+
    prvHeapInit (Thumb, 98 bytes, Stack size 12 bytes, heap_4.o(i.prvHeapInit))
+

    [Stack]
    • Max Depth = 12
    • Call Chain = prvHeapInit
+
    
+
    [Called By]
    • >>   pvPortMalloc
+
    
+
+
    prvInsertBlockIntoFreeList (Thumb, 96 bytes, Stack size 8 bytes, heap_4.o(i.prvInsertBlockIntoFreeList))
+

    [Stack]
    • Max Depth = 8
    • Call Chain = prvInsertBlockIntoFreeList
+
    
+
    [Called By]
    • >>   vPortFree
+
    • >>   pvPortMalloc
+
    
+
+
    _dadd1 (Thumb, 0 bytes, Stack size unknown bytes, daddsub_clz.o(x$fpl$dadd), UNUSED)
+

    [Called By]
    • >>   _dsub
+
    • >>   _drsb
+
    
+
+
    _dsub1 (Thumb, 0 bytes, Stack size unknown bytes, daddsub_clz.o(x$fpl$dsub), UNUSED)
+

    [Called By]
    • >>   _drsb
+
    • >>   _dadd
+
    
+
+
    _printf_input_char (Thumb, 10 bytes, Stack size 0 bytes, _printf_char_common.o(.text))
+
    [Address Reference Count : 1]
    •  _printf_char_common.o(.text)
+
    
+
    
+Undefined Global Symbols
+
    
diff --git a/OBJ/OriginCar.lnp b/OBJ/OriginCar.lnp
new file mode 100644
index 0000000..9acde31
--- /dev/null
+++ b/OBJ/OriginCar.lnp
@@ -0,0 +1,45 @@
+--cpu=Cortex-M4.fp.sp
+"..\obj\main.o"
+"..\obj\stm32f4xx_it.o"
+"..\obj\system_stm32f4xx.o"
+"..\obj\adc.o"
+"..\obj\can.o"
+"..\obj\encoder.o"
+"..\obj\key.o"
+"..\obj\led.o"
+"..\obj\motor.o"
+"..\obj\oled.o"
+"..\obj\pstwo.o"
+"..\obj\timer.o"
+"..\obj\usartx.o"
+"..\obj\delay.o"
+"..\obj\sys.o"
+"..\obj\usart.o"
+"..\obj\startup_stm32f40_41xxx.o"
+"..\obj\misc.o"
+"..\obj\stm32f4xx_gpio.o"
+"..\obj\stm32f4xx_rcc.o"
+"..\obj\stm32f4xx_syscfg.o"
+"..\obj\stm32f4xx_usart.o"
+"..\obj\stm32f4xx_adc.o"
+"..\obj\stm32f4xx_can.o"
+"..\obj\stm32f4xx_tim.o"
+"..\obj\stm32f4xx_pwr.o"
+"..\obj\croutine.o"
+"..\obj\event_groups.o"
+"..\obj\list.o"
+"..\obj\queue.o"
+"..\obj\tasks.o"
+"..\obj\timers.o"
+"..\obj\port.o"
+"..\obj\heap_4.o"
+"..\obj\system.o"
+"..\obj\balance.o"
+"..\obj\robot_select_init.o"
+"..\obj\show.o"
+"..\obj\mpu6050.o"
+"..\obj\i2c.o"
+--strict --scatter "..\OBJ\OriginCar.sct"
+--summary_stderr --info summarysizes --map --load_addr_map_info --xref --callgraph --symbols
+--info sizes --info totals --info unused --info veneers
+--list "..\OBJ\OriginCar.map" -o ..\OBJ\OriginCar.axf
\ No newline at end of file
diff --git a/OBJ/OriginCar.map b/OBJ/OriginCar.map
new file mode 100644
index 0000000..8a89e18
--- /dev/null
+++ b/OBJ/OriginCar.map
@@ -0,0 +1,4422 @@
+Component: ARM Compiler 5.06 update 6 (build 750) Tool: armlink [4d35ed]
+
+==============================================================================
+
+Section Cross References
+
+    main.o(i.main) refers to system.o(i.systemInit) for systemInit
+    main.o(i.main) refers to tasks.o(i.xTaskCreate) for xTaskCreate
+    main.o(i.main) refers to tasks.o(i.vTaskStartScheduler) for vTaskStartScheduler
+    main.o(i.main) refers to main.o(.data) for StartTask_Handler
+    main.o(i.main) refers to main.o(i.start_task) for start_task
+    main.o(i.start_task) refers to port.o(i.vPortEnterCritical) for vPortEnterCritical
+    main.o(i.start_task) refers to tasks.o(i.xTaskCreate) for xTaskCreate
+    main.o(i.start_task) refers to tasks.o(i.vTaskDelete) for vTaskDelete
+    main.o(i.start_task) refers to port.o(i.vPortExitCritical) for vPortExitCritical
+    main.o(i.start_task) refers to balance.o(i.Balance_task) for Balance_task
+    main.o(i.start_task) refers to mpu6050.o(i.MPU6050_task) for MPU6050_task
+    main.o(i.start_task) refers to show.o(i.show_task) for show_task
+    main.o(i.start_task) refers to led.o(i.led_task) for led_task
+    main.o(i.start_task) refers to pstwo.o(i.pstwo_task) for pstwo_task
+    main.o(i.start_task) refers to usartx.o(i.data_task) for data_task
+    main.o(i.start_task) refers to main.o(.data) for StartTask_Handler
+    system_stm32f4xx.o(i.SystemCoreClockUpdate) refers to system_stm32f4xx.o(.data) for SystemCoreClock
+    system_stm32f4xx.o(i.SystemInit) refers to system_stm32f4xx.o(i.SetSysClock) for SetSysClock
+    adc.o(i.Adc_Init) refers to stm32f4xx_rcc.o(i.RCC_AHB1PeriphClockCmd) for RCC_AHB1PeriphClockCmd
+    adc.o(i.Adc_Init) refers to stm32f4xx_rcc.o(i.RCC_APB2PeriphClockCmd) for RCC_APB2PeriphClockCmd
+    adc.o(i.Adc_Init) refers to stm32f4xx_gpio.o(i.GPIO_Init) for GPIO_Init
+    adc.o(i.Adc_Init) refers to stm32f4xx_rcc.o(i.RCC_APB2PeriphResetCmd) for RCC_APB2PeriphResetCmd
+    adc.o(i.Adc_Init) refers to stm32f4xx_adc.o(i.ADC_CommonInit) for ADC_CommonInit
+    adc.o(i.Adc_Init) refers to stm32f4xx_adc.o(i.ADC_Init) for ADC_Init
+    adc.o(i.Adc_Init) refers to stm32f4xx_adc.o(i.ADC_Cmd) for ADC_Cmd
+    adc.o(i.Adc_POWER_Init) refers to stm32f4xx_rcc.o(i.RCC_AHB1PeriphClockCmd) for RCC_AHB1PeriphClockCmd
+    adc.o(i.Adc_POWER_Init) refers to stm32f4xx_rcc.o(i.RCC_APB2PeriphClockCmd) for RCC_APB2PeriphClockCmd
+    adc.o(i.Adc_POWER_Init) refers to stm32f4xx_gpio.o(i.GPIO_Init) for GPIO_Init
+    adc.o(i.Adc_POWER_Init) refers to stm32f4xx_rcc.o(i.RCC_APB2PeriphResetCmd) for RCC_APB2PeriphResetCmd
+    adc.o(i.Adc_POWER_Init) refers to stm32f4xx_adc.o(i.ADC_CommonInit) for ADC_CommonInit
+    adc.o(i.Adc_POWER_Init) refers to stm32f4xx_adc.o(i.ADC_Init) for ADC_Init
+    adc.o(i.Adc_POWER_Init) refers to stm32f4xx_adc.o(i.ADC_Cmd) for ADC_Cmd
+    adc.o(i.Get_Adc) refers to stm32f4xx_adc.o(i.ADC_RegularChannelConfig) for ADC_RegularChannelConfig
+    adc.o(i.Get_Adc) refers to stm32f4xx_adc.o(i.ADC_SoftwareStartConv) for ADC_SoftwareStartConv
+    adc.o(i.Get_Adc) refers to stm32f4xx_adc.o(i.ADC_GetFlagStatus) for ADC_GetFlagStatus
+    adc.o(i.Get_Adc) refers to stm32f4xx_adc.o(i.ADC_GetConversionValue) for ADC_GetConversionValue
+    adc.o(i.Get_Adc2) refers to stm32f4xx_adc.o(i.ADC_RegularChannelConfig) for ADC_RegularChannelConfig
+    adc.o(i.Get_Adc2) refers to stm32f4xx_adc.o(i.ADC_SoftwareStartConv) for ADC_SoftwareStartConv
+    adc.o(i.Get_Adc2) refers to stm32f4xx_adc.o(i.ADC_GetFlagStatus) for ADC_GetFlagStatus
+    adc.o(i.Get_Adc2) refers to stm32f4xx_adc.o(i.ADC_GetConversionValue) for ADC_GetConversionValue
+    adc.o(i.Get_adc_Average) refers to adc.o(i.Get_Adc) for Get_Adc
+    adc.o(i.Get_adc_Average) refers to delay.o(i.delay_ms) for delay_ms
+    adc.o(i.Get_battery_volt) refers to adc.o(i.Get_Adc2) for Get_Adc2
+    adc.o(i.Get_battery_volt) refers to dflt_clz.o(x$fpl$dfltu) for __aeabi_ui2d
+    adc.o(i.Get_battery_volt) refers to dmul.o(x$fpl$dmul) for __aeabi_dmul
+    adc.o(i.Get_battery_volt) refers to ddiv.o(x$fpl$ddiv) for __aeabi_ddiv
+    adc.o(i.Get_battery_volt) refers to d2f.o(x$fpl$d2f) for __aeabi_d2f
+    can.o(i.CAN1_Mode_Init) refers to stm32f4xx_rcc.o(i.RCC_AHB1PeriphClockCmd) for RCC_AHB1PeriphClockCmd
+    can.o(i.CAN1_Mode_Init) refers to stm32f4xx_rcc.o(i.RCC_APB1PeriphClockCmd) for RCC_APB1PeriphClockCmd
+    can.o(i.CAN1_Mode_Init) refers to stm32f4xx_gpio.o(i.GPIO_Init) for GPIO_Init
+    can.o(i.CAN1_Mode_Init) refers to stm32f4xx_gpio.o(i.GPIO_PinAFConfig) for GPIO_PinAFConfig
+    can.o(i.CAN1_Mode_Init) refers to misc.o(i.NVIC_Init) for NVIC_Init
+    can.o(i.CAN1_Mode_Init) refers to stm32f4xx_can.o(i.CAN_ITConfig) for CAN_ITConfig
+    can.o(i.CAN1_RX0_IRQHandler) refers to can.o(i.CAN1_Rx_Msg) for CAN1_Rx_Msg
+    can.o(i.CAN1_RX0_IRQHandler) refers to usartx.o(i.Vz_to_Akm_Angle) for Vz_to_Akm_Angle
+    can.o(i.CAN1_RX0_IRQHandler) refers to system.o(.data) for CAN_ON_Flag
+    can.o(i.CAN1_RX0_IRQHandler) refers to balance.o(.data) for command_lost_count
+    can.o(i.CAN1_Receive_Msg) refers to can.o(i.CAN1_Msg_Pend) for CAN1_Msg_Pend
+    can.o(i.CAN1_Receive_Msg) refers to can.o(i.CAN1_Rx_Msg) for CAN1_Rx_Msg
+    can.o(i.CAN1_Send_Msg) refers to can.o(i.CAN1_Tx_Msg) for CAN1_Tx_Msg
+    can.o(i.CAN1_Send_Msg) refers to can.o(i.CAN1_Tx_Staus) for CAN1_Tx_Staus
+    can.o(i.CAN1_Send_MsgTEST) refers to can.o(i.CAN1_Tx_Msg) for CAN1_Tx_Msg
+    can.o(i.CAN1_Send_MsgTEST) refers to can.o(i.CAN1_Tx_Staus) for CAN1_Tx_Staus
+    can.o(i.CAN1_Send_Num) refers to can.o(i.CAN1_Tx_Msg) for CAN1_Tx_Msg
+    can.o(i.CAN1_Send_Num) refers to can.o(i.CAN1_Tx_Staus) for CAN1_Tx_Staus
+    encoder.o(i.Encoder_Init_TIM2) refers to stm32f4xx_rcc.o(i.RCC_APB1PeriphClockCmd) for RCC_APB1PeriphClockCmd
+    encoder.o(i.Encoder_Init_TIM2) refers to stm32f4xx_rcc.o(i.RCC_AHB1PeriphClockCmd) for RCC_AHB1PeriphClockCmd
+    encoder.o(i.Encoder_Init_TIM2) refers to stm32f4xx_gpio.o(i.GPIO_Init) for GPIO_Init
+    encoder.o(i.Encoder_Init_TIM2) refers to stm32f4xx_gpio.o(i.GPIO_PinAFConfig) for GPIO_PinAFConfig
+    encoder.o(i.Encoder_Init_TIM2) refers to stm32f4xx_tim.o(i.TIM_TimeBaseStructInit) for TIM_TimeBaseStructInit
+    encoder.o(i.Encoder_Init_TIM2) refers to stm32f4xx_tim.o(i.TIM_TimeBaseInit) for TIM_TimeBaseInit
+    encoder.o(i.Encoder_Init_TIM2) refers to stm32f4xx_tim.o(i.TIM_EncoderInterfaceConfig) for TIM_EncoderInterfaceConfig
+    encoder.o(i.Encoder_Init_TIM2) refers to stm32f4xx_tim.o(i.TIM_ICStructInit) for TIM_ICStructInit
+    encoder.o(i.Encoder_Init_TIM2) refers to stm32f4xx_tim.o(i.TIM_ICInit) for TIM_ICInit
+    encoder.o(i.Encoder_Init_TIM2) refers to stm32f4xx_tim.o(i.TIM_ClearFlag) for TIM_ClearFlag
+    encoder.o(i.Encoder_Init_TIM2) refers to stm32f4xx_tim.o(i.TIM_ITConfig) for TIM_ITConfig
+    encoder.o(i.Encoder_Init_TIM2) refers to stm32f4xx_tim.o(i.TIM_SetCounter) for TIM_SetCounter
+    encoder.o(i.Encoder_Init_TIM2) refers to stm32f4xx_tim.o(i.TIM_Cmd) for TIM_Cmd
+    encoder.o(i.Encoder_Init_TIM3) refers to stm32f4xx_rcc.o(i.RCC_APB1PeriphClockCmd) for RCC_APB1PeriphClockCmd
+    encoder.o(i.Encoder_Init_TIM3) refers to stm32f4xx_rcc.o(i.RCC_AHB1PeriphClockCmd) for RCC_AHB1PeriphClockCmd
+    encoder.o(i.Encoder_Init_TIM3) refers to stm32f4xx_gpio.o(i.GPIO_Init) for GPIO_Init
+    encoder.o(i.Encoder_Init_TIM3) refers to stm32f4xx_gpio.o(i.GPIO_PinAFConfig) for GPIO_PinAFConfig
+    encoder.o(i.Encoder_Init_TIM3) refers to stm32f4xx_tim.o(i.TIM_TimeBaseStructInit) for TIM_TimeBaseStructInit
+    encoder.o(i.Encoder_Init_TIM3) refers to stm32f4xx_tim.o(i.TIM_TimeBaseInit) for TIM_TimeBaseInit
+    encoder.o(i.Encoder_Init_TIM3) refers to stm32f4xx_tim.o(i.TIM_EncoderInterfaceConfig) for TIM_EncoderInterfaceConfig
+    encoder.o(i.Encoder_Init_TIM3) refers to stm32f4xx_tim.o(i.TIM_ICStructInit) for TIM_ICStructInit
+    encoder.o(i.Encoder_Init_TIM3) refers to stm32f4xx_tim.o(i.TIM_ICInit) for TIM_ICInit
+    encoder.o(i.Encoder_Init_TIM3) refers to stm32f4xx_tim.o(i.TIM_ClearFlag) for TIM_ClearFlag
+    encoder.o(i.Encoder_Init_TIM3) refers to stm32f4xx_tim.o(i.TIM_ITConfig) for TIM_ITConfig
+    encoder.o(i.Encoder_Init_TIM3) refers to stm32f4xx_tim.o(i.TIM_SetCounter) for TIM_SetCounter
+    encoder.o(i.Encoder_Init_TIM3) refers to stm32f4xx_tim.o(i.TIM_Cmd) for TIM_Cmd
+    encoder.o(i.Encoder_Init_TIM4) refers to stm32f4xx_rcc.o(i.RCC_APB1PeriphClockCmd) for RCC_APB1PeriphClockCmd
+    encoder.o(i.Encoder_Init_TIM4) refers to stm32f4xx_rcc.o(i.RCC_AHB1PeriphClockCmd) for RCC_AHB1PeriphClockCmd
+    encoder.o(i.Encoder_Init_TIM4) refers to stm32f4xx_gpio.o(i.GPIO_Init) for GPIO_Init
+    encoder.o(i.Encoder_Init_TIM4) refers to stm32f4xx_gpio.o(i.GPIO_PinAFConfig) for GPIO_PinAFConfig
+    encoder.o(i.Encoder_Init_TIM4) refers to stm32f4xx_tim.o(i.TIM_TimeBaseStructInit) for TIM_TimeBaseStructInit
+    encoder.o(i.Encoder_Init_TIM4) refers to stm32f4xx_tim.o(i.TIM_TimeBaseInit) for TIM_TimeBaseInit
+    encoder.o(i.Encoder_Init_TIM4) refers to stm32f4xx_tim.o(i.TIM_EncoderInterfaceConfig) for TIM_EncoderInterfaceConfig
+    encoder.o(i.Encoder_Init_TIM4) refers to stm32f4xx_tim.o(i.TIM_ICStructInit) for TIM_ICStructInit
+    encoder.o(i.Encoder_Init_TIM4) refers to stm32f4xx_tim.o(i.TIM_ICInit) for TIM_ICInit
+    encoder.o(i.Encoder_Init_TIM4) refers to stm32f4xx_tim.o(i.TIM_ClearFlag) for TIM_ClearFlag
+    encoder.o(i.Encoder_Init_TIM4) refers to stm32f4xx_tim.o(i.TIM_ITConfig) for TIM_ITConfig
+    encoder.o(i.Encoder_Init_TIM4) refers to stm32f4xx_tim.o(i.TIM_SetCounter) for TIM_SetCounter
+    encoder.o(i.Encoder_Init_TIM4) refers to stm32f4xx_tim.o(i.TIM_Cmd) for TIM_Cmd
+    encoder.o(i.Encoder_Init_TIM5) refers to stm32f4xx_rcc.o(i.RCC_APB1PeriphClockCmd) for RCC_APB1PeriphClockCmd
+    encoder.o(i.Encoder_Init_TIM5) refers to stm32f4xx_rcc.o(i.RCC_AHB1PeriphClockCmd) for RCC_AHB1PeriphClockCmd
+    encoder.o(i.Encoder_Init_TIM5) refers to stm32f4xx_gpio.o(i.GPIO_PinAFConfig) for GPIO_PinAFConfig
+    encoder.o(i.Encoder_Init_TIM5) refers to stm32f4xx_gpio.o(i.GPIO_Init) for GPIO_Init
+    encoder.o(i.Encoder_Init_TIM5) refers to stm32f4xx_tim.o(i.TIM_TimeBaseStructInit) for TIM_TimeBaseStructInit
+    encoder.o(i.Encoder_Init_TIM5) refers to stm32f4xx_tim.o(i.TIM_TimeBaseInit) for TIM_TimeBaseInit
+    encoder.o(i.Encoder_Init_TIM5) refers to stm32f4xx_tim.o(i.TIM_EncoderInterfaceConfig) for TIM_EncoderInterfaceConfig
+    encoder.o(i.Encoder_Init_TIM5) refers to stm32f4xx_tim.o(i.TIM_ICStructInit) for TIM_ICStructInit
+    encoder.o(i.Encoder_Init_TIM5) refers to stm32f4xx_tim.o(i.TIM_ICInit) for TIM_ICInit
+    encoder.o(i.Encoder_Init_TIM5) refers to stm32f4xx_tim.o(i.TIM_ClearFlag) for TIM_ClearFlag
+    encoder.o(i.Encoder_Init_TIM5) refers to stm32f4xx_tim.o(i.TIM_ITConfig) for TIM_ITConfig
+    encoder.o(i.Encoder_Init_TIM5) refers to stm32f4xx_tim.o(i.TIM_SetCounter) for TIM_SetCounter
+    encoder.o(i.Encoder_Init_TIM5) refers to stm32f4xx_tim.o(i.TIM_Cmd) for TIM_Cmd
+    key.o(i.KEY_Init) refers to stm32f4xx_rcc.o(i.RCC_AHB1PeriphClockCmd) for RCC_AHB1PeriphClockCmd
+    key.o(i.KEY_Init) refers to stm32f4xx_gpio.o(i.GPIO_Init) for GPIO_Init
+    key.o(i.Long_Press) refers to key.o(.data) for Long_Press
+    key.o(i.click) refers to key.o(.data) for flag_key
+    key.o(i.click_N_Double) refers to key.o(.data) for Forever_count
+    key.o(i.click_N_Double_MPU6050) refers to key.o(.data) for Forever_count
+    led.o(i.Buzzer_Init) refers to stm32f4xx_rcc.o(i.RCC_AHB1PeriphClockCmd) for RCC_AHB1PeriphClockCmd
+    led.o(i.Buzzer_Init) refers to stm32f4xx_gpio.o(i.GPIO_Init) for GPIO_Init
+    led.o(i.LED_Init) refers to stm32f4xx_rcc.o(i.RCC_AHB1PeriphClockCmd) for RCC_AHB1PeriphClockCmd
+    led.o(i.LED_Init) refers to stm32f4xx_gpio.o(i.GPIO_Init) for GPIO_Init
+    led.o(i.LED_Init) refers to stm32f4xx_gpio.o(i.GPIO_SetBits) for GPIO_SetBits
+    led.o(i.Led_Flash) refers to led.o(.data) for temp
+    led.o(i.led_task) refers to tasks.o(i.vTaskDelay) for vTaskDelay
+    led.o(i.led_task) refers to led.o(.data) for Led_Count
+    motor.o(i.Enable_Pin) refers to stm32f4xx_rcc.o(i.RCC_AHB1PeriphClockCmd) for RCC_AHB1PeriphClockCmd
+    motor.o(i.Enable_Pin) refers to stm32f4xx_gpio.o(i.GPIO_Init) for GPIO_Init
+    motor.o(i.TIM10_PWM_Init) refers to stm32f4xx_rcc.o(i.RCC_AHB1PeriphClockCmd) for RCC_AHB1PeriphClockCmd
+    motor.o(i.TIM10_PWM_Init) refers to stm32f4xx_rcc.o(i.RCC_APB2PeriphClockCmd) for RCC_APB2PeriphClockCmd
+    motor.o(i.TIM10_PWM_Init) refers to stm32f4xx_gpio.o(i.GPIO_PinAFConfig) for GPIO_PinAFConfig
+    motor.o(i.TIM10_PWM_Init) refers to stm32f4xx_gpio.o(i.GPIO_Init) for GPIO_Init
+    motor.o(i.TIM10_PWM_Init) refers to stm32f4xx_tim.o(i.TIM_TimeBaseInit) for TIM_TimeBaseInit
+    motor.o(i.TIM10_PWM_Init) refers to stm32f4xx_tim.o(i.TIM_OC1Init) for TIM_OC1Init
+    motor.o(i.TIM10_PWM_Init) refers to stm32f4xx_tim.o(i.TIM_OC1PreloadConfig) for TIM_OC1PreloadConfig
+    motor.o(i.TIM10_PWM_Init) refers to stm32f4xx_tim.o(i.TIM_ARRPreloadConfig) for TIM_ARRPreloadConfig
+    motor.o(i.TIM10_PWM_Init) refers to stm32f4xx_tim.o(i.TIM_Cmd) for TIM_Cmd
+    motor.o(i.TIM11_PWM_Init) refers to stm32f4xx_rcc.o(i.RCC_AHB1PeriphClockCmd) for RCC_AHB1PeriphClockCmd
+    motor.o(i.TIM11_PWM_Init) refers to stm32f4xx_rcc.o(i.RCC_APB2PeriphClockCmd) for RCC_APB2PeriphClockCmd
+    motor.o(i.TIM11_PWM_Init) refers to stm32f4xx_gpio.o(i.GPIO_PinAFConfig) for GPIO_PinAFConfig
+    motor.o(i.TIM11_PWM_Init) refers to stm32f4xx_gpio.o(i.GPIO_Init) for GPIO_Init
+    motor.o(i.TIM11_PWM_Init) refers to stm32f4xx_tim.o(i.TIM_TimeBaseInit) for TIM_TimeBaseInit
+    motor.o(i.TIM11_PWM_Init) refers to stm32f4xx_tim.o(i.TIM_OC1Init) for TIM_OC1Init
+    motor.o(i.TIM11_PWM_Init) refers to stm32f4xx_tim.o(i.TIM_OC1PreloadConfig) for TIM_OC1PreloadConfig
+    motor.o(i.TIM11_PWM_Init) refers to stm32f4xx_tim.o(i.TIM_CtrlPWMOutputs) for TIM_CtrlPWMOutputs
+    motor.o(i.TIM11_PWM_Init) refers to stm32f4xx_tim.o(i.TIM_ARRPreloadConfig) for TIM_ARRPreloadConfig
+    motor.o(i.TIM11_PWM_Init) refers to stm32f4xx_tim.o(i.TIM_Cmd) for TIM_Cmd
+    motor.o(i.TIM1_PWM_Init) refers to stm32f4xx_rcc.o(i.RCC_APB2PeriphClockCmd) for RCC_APB2PeriphClockCmd
+    motor.o(i.TIM1_PWM_Init) refers to stm32f4xx_rcc.o(i.RCC_AHB1PeriphClockCmd) for RCC_AHB1PeriphClockCmd
+    motor.o(i.TIM1_PWM_Init) refers to stm32f4xx_gpio.o(i.GPIO_PinAFConfig) for GPIO_PinAFConfig
+    motor.o(i.TIM1_PWM_Init) refers to stm32f4xx_gpio.o(i.GPIO_Init) for GPIO_Init
+    motor.o(i.TIM1_PWM_Init) refers to stm32f4xx_tim.o(i.TIM_TimeBaseInit) for TIM_TimeBaseInit
+    motor.o(i.TIM1_PWM_Init) refers to stm32f4xx_tim.o(i.TIM_OC1Init) for TIM_OC1Init
+    motor.o(i.TIM1_PWM_Init) refers to stm32f4xx_tim.o(i.TIM_OC2Init) for TIM_OC2Init
+    motor.o(i.TIM1_PWM_Init) refers to stm32f4xx_tim.o(i.TIM_OC3Init) for TIM_OC3Init
+    motor.o(i.TIM1_PWM_Init) refers to stm32f4xx_tim.o(i.TIM_OC4Init) for TIM_OC4Init
+    motor.o(i.TIM1_PWM_Init) refers to stm32f4xx_tim.o(i.TIM_CtrlPWMOutputs) for TIM_CtrlPWMOutputs
+    motor.o(i.TIM1_PWM_Init) refers to stm32f4xx_tim.o(i.TIM_OC1PreloadConfig) for TIM_OC1PreloadConfig
+    motor.o(i.TIM1_PWM_Init) refers to stm32f4xx_tim.o(i.TIM_OC2PreloadConfig) for TIM_OC2PreloadConfig
+    motor.o(i.TIM1_PWM_Init) refers to stm32f4xx_tim.o(i.TIM_OC3PreloadConfig) for TIM_OC3PreloadConfig
+    motor.o(i.TIM1_PWM_Init) refers to stm32f4xx_tim.o(i.TIM_OC4PreloadConfig) for TIM_OC4PreloadConfig
+    motor.o(i.TIM1_PWM_Init) refers to stm32f4xx_tim.o(i.TIM_ARRPreloadConfig) for TIM_ARRPreloadConfig
+    motor.o(i.TIM1_PWM_Init) refers to stm32f4xx_tim.o(i.TIM_Cmd) for TIM_Cmd
+    motor.o(i.TIM9_PWM_Init) refers to stm32f4xx_rcc.o(i.RCC_APB2PeriphClockCmd) for RCC_APB2PeriphClockCmd
+    motor.o(i.TIM9_PWM_Init) refers to stm32f4xx_rcc.o(i.RCC_AHB1PeriphClockCmd) for RCC_AHB1PeriphClockCmd
+    motor.o(i.TIM9_PWM_Init) refers to stm32f4xx_gpio.o(i.GPIO_PinAFConfig) for GPIO_PinAFConfig
+    motor.o(i.TIM9_PWM_Init) refers to stm32f4xx_gpio.o(i.GPIO_Init) for GPIO_Init
+    motor.o(i.TIM9_PWM_Init) refers to stm32f4xx_tim.o(i.TIM_TimeBaseInit) for TIM_TimeBaseInit
+    motor.o(i.TIM9_PWM_Init) refers to stm32f4xx_tim.o(i.TIM_OC1Init) for TIM_OC1Init
+    motor.o(i.TIM9_PWM_Init) refers to stm32f4xx_tim.o(i.TIM_OC2Init) for TIM_OC2Init
+    motor.o(i.TIM9_PWM_Init) refers to stm32f4xx_tim.o(i.TIM_OC1PreloadConfig) for TIM_OC1PreloadConfig
+    motor.o(i.TIM9_PWM_Init) refers to stm32f4xx_tim.o(i.TIM_OC2PreloadConfig) for TIM_OC2PreloadConfig
+    motor.o(i.TIM9_PWM_Init) refers to stm32f4xx_tim.o(i.TIM_ARRPreloadConfig) for TIM_ARRPreloadConfig
+    motor.o(i.TIM9_PWM_Init) refers to stm32f4xx_tim.o(i.TIM_Cmd) for TIM_Cmd
+    oled.o(i.OLED_Clear) refers to oled.o(i.OLED_Refresh_Gram) for OLED_Refresh_Gram
+    oled.o(i.OLED_Clear) refers to oled.o(.bss) for OLED_GRAM
+    oled.o(i.OLED_Display_Off) refers to oled.o(i.OLED_WR_Byte) for OLED_WR_Byte
+    oled.o(i.OLED_Display_On) refers to oled.o(i.OLED_WR_Byte) for OLED_WR_Byte
+    oled.o(i.OLED_DrawPoint) refers to oled.o(.bss) for OLED_GRAM
+    oled.o(i.OLED_Init) refers to stm32f4xx_rcc.o(i.RCC_AHB1PeriphClockCmd) for RCC_AHB1PeriphClockCmd
+    oled.o(i.OLED_Init) refers to stm32f4xx_gpio.o(i.GPIO_Init) for GPIO_Init
+    oled.o(i.OLED_Init) refers to stm32f4xx_rcc.o(i.RCC_APB1PeriphClockCmd) for RCC_APB1PeriphClockCmd
+    oled.o(i.OLED_Init) refers to stm32f4xx_pwr.o(i.PWR_BackupAccessCmd) for PWR_BackupAccessCmd
+    oled.o(i.OLED_Init) refers to stm32f4xx_rcc.o(i.RCC_LSEConfig) for RCC_LSEConfig
+    oled.o(i.OLED_Init) refers to delay.o(i.delay_ms) for delay_ms
+    oled.o(i.OLED_Init) refers to oled.o(i.OLED_WR_Byte) for OLED_WR_Byte
+    oled.o(i.OLED_Init) refers to oled.o(i.OLED_Clear) for OLED_Clear
+    oled.o(i.OLED_Refresh_Gram) refers to oled.o(i.OLED_WR_Byte) for OLED_WR_Byte
+    oled.o(i.OLED_Refresh_Gram) refers to oled.o(.bss) for OLED_GRAM
+    oled.o(i.OLED_Set_Pos) refers to oled.o(i.OLED_WR_Byte) for OLED_WR_Byte
+    oled.o(i.OLED_ShowCHinese) refers to oled.o(i.OLED_Set_Pos) for OLED_Set_Pos
+    oled.o(i.OLED_ShowCHinese) refers to oled.o(i.OLED_WR_Byte) for OLED_WR_Byte
+    oled.o(i.OLED_ShowCHinese) refers to oled.o(.constdata) for Hzk16
+    oled.o(i.OLED_ShowChar) refers to oled.o(i.OLED_DrawPoint) for OLED_DrawPoint
+    oled.o(i.OLED_ShowChar) refers to oled.o(.constdata) for oled_asc2_1206
+    oled.o(i.OLED_ShowNumber) refers to oled.o(i.oled_pow) for oled_pow
+    oled.o(i.OLED_ShowNumber) refers to oled.o(i.OLED_ShowChar) for OLED_ShowChar
+    oled.o(i.OLED_ShowString) refers to oled.o(i.OLED_Clear) for OLED_Clear
+    oled.o(i.OLED_ShowString) refers to oled.o(i.OLED_ShowChar) for OLED_ShowChar
+    pstwo.o(i.PS2_AnologData) refers to pstwo.o(.bss) for Data
+    pstwo.o(i.PS2_ClearData) refers to pstwo.o(.bss) for Data
+    pstwo.o(i.PS2_Cmd) refers to delay.o(i.delay_us) for delay_us
+    pstwo.o(i.PS2_Cmd) refers to pstwo.o(.bss) for Data
+    pstwo.o(i.PS2_DataKey) refers to pstwo.o(i.PS2_ClearData) for PS2_ClearData
+    pstwo.o(i.PS2_DataKey) refers to pstwo.o(i.PS2_ReadData) for PS2_ReadData
+    pstwo.o(i.PS2_DataKey) refers to pstwo.o(.bss) for Data
+    pstwo.o(i.PS2_DataKey) refers to pstwo.o(.data) for Handkey
+    pstwo.o(i.PS2_EnterConfing) refers to delay.o(i.delay_us) for delay_us
+    pstwo.o(i.PS2_EnterConfing) refers to pstwo.o(i.PS2_Cmd) for PS2_Cmd
+    pstwo.o(i.PS2_ExitConfing) refers to delay.o(i.delay_us) for delay_us
+    pstwo.o(i.PS2_ExitConfing) refers to pstwo.o(i.PS2_Cmd) for PS2_Cmd
+    pstwo.o(i.PS2_Init) refers to stm32f4xx_rcc.o(i.RCC_AHB1PeriphClockCmd) for RCC_AHB1PeriphClockCmd
+    pstwo.o(i.PS2_Init) refers to stm32f4xx_gpio.o(i.GPIO_Init) for GPIO_Init
+    pstwo.o(i.PS2_Read) refers to pstwo.o(i.PS2_DataKey) for PS2_DataKey
+    pstwo.o(i.PS2_Read) refers to pstwo.o(i.PS2_AnologData) for PS2_AnologData
+    pstwo.o(i.PS2_Read) refers to system.o(.data) for PS2_KEY
+    pstwo.o(i.PS2_Read) refers to pstwo.o(.data) for Strat
+    pstwo.o(i.PS2_Read) refers to mpu6050.o(.data) for Deviation_Count
+    pstwo.o(i.PS2_ReadData) refers to pstwo.o(i.PS2_Cmd) for PS2_Cmd
+    pstwo.o(i.PS2_ReadData) refers to delay.o(i.delay_us) for delay_us
+    pstwo.o(i.PS2_ReadData) refers to pstwo.o(.data) for Comd
+    pstwo.o(i.PS2_ReadData) refers to pstwo.o(.bss) for Data
+    pstwo.o(i.PS2_Receive) refers to pstwo.o(i.PS2_AnologData) for PS2_AnologData
+    pstwo.o(i.PS2_Receive) refers to pstwo.o(i.PS2_DataKey) for PS2_DataKey
+    pstwo.o(i.PS2_Receive) refers to system.o(.data) for PS2_ON_Flag
+    pstwo.o(i.PS2_RedLight) refers to pstwo.o(i.PS2_Cmd) for PS2_Cmd
+    pstwo.o(i.PS2_RedLight) refers to pstwo.o(.data) for Comd
+    pstwo.o(i.PS2_RedLight) refers to pstwo.o(.bss) for Data
+    pstwo.o(i.PS2_SetInit) refers to pstwo.o(i.PS2_ShortPoll) for PS2_ShortPoll
+    pstwo.o(i.PS2_SetInit) refers to pstwo.o(i.PS2_EnterConfing) for PS2_EnterConfing
+    pstwo.o(i.PS2_SetInit) refers to pstwo.o(i.PS2_TurnOnAnalogMode) for PS2_TurnOnAnalogMode
+    pstwo.o(i.PS2_SetInit) refers to pstwo.o(i.PS2_ExitConfing) for PS2_ExitConfing
+    pstwo.o(i.PS2_ShortPoll) refers to delay.o(i.delay_us) for delay_us
+    pstwo.o(i.PS2_ShortPoll) refers to pstwo.o(i.PS2_Cmd) for PS2_Cmd
+    pstwo.o(i.PS2_TurnOnAnalogMode) refers to pstwo.o(i.PS2_Cmd) for PS2_Cmd
+    pstwo.o(i.PS2_TurnOnAnalogMode) refers to delay.o(i.delay_us) for delay_us
+    pstwo.o(i.PS2_Vibration) refers to delay.o(i.delay_us) for delay_us
+    pstwo.o(i.PS2_Vibration) refers to pstwo.o(i.PS2_Cmd) for PS2_Cmd
+    pstwo.o(i.PS2_VibrationMode) refers to delay.o(i.delay_us) for delay_us
+    pstwo.o(i.PS2_VibrationMode) refers to pstwo.o(i.PS2_Cmd) for PS2_Cmd
+    pstwo.o(i.pstwo_task) refers to delay.o(i.getSysTickCnt) for getSysTickCnt
+    pstwo.o(i.pstwo_task) refers to tasks.o(i.vTaskDelayUntil) for vTaskDelayUntil
+    pstwo.o(i.pstwo_task) refers to pstwo.o(i.PS2_Read) for PS2_Read
+    timer.o(i.TIM12_SERVO_Init) refers to stm32f4xx_rcc.o(i.RCC_APB1PeriphClockCmd) for RCC_APB1PeriphClockCmd
+    timer.o(i.TIM12_SERVO_Init) refers to stm32f4xx_rcc.o(i.RCC_AHB1PeriphClockCmd) for RCC_AHB1PeriphClockCmd
+    timer.o(i.TIM12_SERVO_Init) refers to stm32f4xx_gpio.o(i.GPIO_Init) for GPIO_Init
+    timer.o(i.TIM12_SERVO_Init) refers to stm32f4xx_gpio.o(i.GPIO_PinAFConfig) for GPIO_PinAFConfig
+    timer.o(i.TIM12_SERVO_Init) refers to stm32f4xx_tim.o(i.TIM_TimeBaseInit) for TIM_TimeBaseInit
+    timer.o(i.TIM12_SERVO_Init) refers to stm32f4xx_tim.o(i.TIM_OC1Init) for TIM_OC1Init
+    timer.o(i.TIM12_SERVO_Init) refers to stm32f4xx_tim.o(i.TIM_OC2Init) for TIM_OC2Init
+    timer.o(i.TIM12_SERVO_Init) refers to stm32f4xx_tim.o(i.TIM_OC1PreloadConfig) for TIM_OC1PreloadConfig
+    timer.o(i.TIM12_SERVO_Init) refers to stm32f4xx_tim.o(i.TIM_OC2PreloadConfig) for TIM_OC2PreloadConfig
+    timer.o(i.TIM12_SERVO_Init) refers to stm32f4xx_tim.o(i.TIM_CtrlPWMOutputs) for TIM_CtrlPWMOutputs
+    timer.o(i.TIM12_SERVO_Init) refers to stm32f4xx_tim.o(i.TIM_Cmd) for TIM_Cmd
+    timer.o(i.TIM8_CC_IRQHandler) refers to stm32f4xx_tim.o(i.TIM_GetITStatus) for TIM_GetITStatus
+    timer.o(i.TIM8_CC_IRQHandler) refers to stm32f4xx_tim.o(i.TIM_ClearITPendingBit) for TIM_ClearITPendingBit
+    timer.o(i.TIM8_CC_IRQHandler) refers to stm32f4xx_tim.o(i.TIM_GetCapture1) for TIM_GetCapture1
+    timer.o(i.TIM8_CC_IRQHandler) refers to stm32f4xx_tim.o(i.TIM_OC1PolarityConfig) for TIM_OC1PolarityConfig
+    timer.o(i.TIM8_CC_IRQHandler) refers to stm32f4xx_tim.o(i.TIM_GetCapture2) for TIM_GetCapture2
+    timer.o(i.TIM8_CC_IRQHandler) refers to stm32f4xx_tim.o(i.TIM_OC2PolarityConfig) for TIM_OC2PolarityConfig
+    timer.o(i.TIM8_CC_IRQHandler) refers to stm32f4xx_tim.o(i.TIM_GetCapture3) for TIM_GetCapture3
+    timer.o(i.TIM8_CC_IRQHandler) refers to stm32f4xx_tim.o(i.TIM_OC3PolarityConfig) for TIM_OC3PolarityConfig
+    timer.o(i.TIM8_CC_IRQHandler) refers to stm32f4xx_tim.o(i.TIM_GetCapture4) for TIM_GetCapture4
+    timer.o(i.TIM8_CC_IRQHandler) refers to stm32f4xx_tim.o(i.TIM_OC4PolarityConfig) for TIM_OC4PolarityConfig
+    timer.o(i.TIM8_CC_IRQHandler) refers to timer.o(.data) for Remoter_Ch2
+    timer.o(i.TIM8_CC_IRQHandler) refers to system.o(.data) for Remote_ON_Flag
+    timer.o(i.TIM8_CC_IRQHandler) refers to mpu6050.o(.data) for Deviation_Count
+    timer.o(i.TIM8_Cap_Init) refers to stm32f4xx_rcc.o(i.RCC_APB2PeriphClockCmd) for RCC_APB2PeriphClockCmd
+    timer.o(i.TIM8_Cap_Init) refers to stm32f4xx_rcc.o(i.RCC_AHB1PeriphClockCmd) for RCC_AHB1PeriphClockCmd
+    timer.o(i.TIM8_Cap_Init) refers to stm32f4xx_gpio.o(i.GPIO_Init) for GPIO_Init
+    timer.o(i.TIM8_Cap_Init) refers to stm32f4xx_gpio.o(i.GPIO_PinAFConfig) for GPIO_PinAFConfig
+    timer.o(i.TIM8_Cap_Init) refers to stm32f4xx_tim.o(i.TIM_TimeBaseInit) for TIM_TimeBaseInit
+    timer.o(i.TIM8_Cap_Init) refers to stm32f4xx_tim.o(i.TIM_ICInit) for TIM_ICInit
+    timer.o(i.TIM8_Cap_Init) refers to misc.o(i.NVIC_Init) for NVIC_Init
+    timer.o(i.TIM8_Cap_Init) refers to stm32f4xx_tim.o(i.TIM_ITConfig) for TIM_ITConfig
+    timer.o(i.TIM8_Cap_Init) refers to stm32f4xx_tim.o(i.TIM_CtrlPWMOutputs) for TIM_CtrlPWMOutputs
+    timer.o(i.TIM8_Cap_Init) refers to stm32f4xx_tim.o(i.TIM_Cmd) for TIM_Cmd
+    timer.o(i.TIM8_SERVO_Init) refers to stm32f4xx_rcc.o(i.RCC_APB2PeriphClockCmd) for RCC_APB2PeriphClockCmd
+    timer.o(i.TIM8_SERVO_Init) refers to stm32f4xx_rcc.o(i.RCC_AHB1PeriphClockCmd) for RCC_AHB1PeriphClockCmd
+    timer.o(i.TIM8_SERVO_Init) refers to stm32f4xx_gpio.o(i.GPIO_Init) for GPIO_Init
+    timer.o(i.TIM8_SERVO_Init) refers to stm32f4xx_gpio.o(i.GPIO_PinAFConfig) for GPIO_PinAFConfig
+    timer.o(i.TIM8_SERVO_Init) refers to stm32f4xx_tim.o(i.TIM_TimeBaseInit) for TIM_TimeBaseInit
+    timer.o(i.TIM8_SERVO_Init) refers to stm32f4xx_tim.o(i.TIM_OC1Init) for TIM_OC1Init
+    timer.o(i.TIM8_SERVO_Init) refers to stm32f4xx_tim.o(i.TIM_OC2Init) for TIM_OC2Init
+    timer.o(i.TIM8_SERVO_Init) refers to stm32f4xx_tim.o(i.TIM_OC3Init) for TIM_OC3Init
+    timer.o(i.TIM8_SERVO_Init) refers to stm32f4xx_tim.o(i.TIM_OC4Init) for TIM_OC4Init
+    timer.o(i.TIM8_SERVO_Init) refers to stm32f4xx_tim.o(i.TIM_OC1PreloadConfig) for TIM_OC1PreloadConfig
+    timer.o(i.TIM8_SERVO_Init) refers to stm32f4xx_tim.o(i.TIM_OC2PreloadConfig) for TIM_OC2PreloadConfig
+    timer.o(i.TIM8_SERVO_Init) refers to stm32f4xx_tim.o(i.TIM_OC3PreloadConfig) for TIM_OC3PreloadConfig
+    timer.o(i.TIM8_SERVO_Init) refers to stm32f4xx_tim.o(i.TIM_OC4PreloadConfig) for TIM_OC4PreloadConfig
+    timer.o(i.TIM8_SERVO_Init) refers to stm32f4xx_tim.o(i.TIM_CtrlPWMOutputs) for TIM_CtrlPWMOutputs
+    timer.o(i.TIM8_SERVO_Init) refers to stm32f4xx_tim.o(i.TIM_Cmd) for TIM_Cmd
+    usartx.o(i.CAN_SEND) refers to can.o(i.CAN1_Send_Num) for CAN1_Send_Num
+    usartx.o(i.CAN_SEND) refers to usartx.o(.bss) for Send_Data
+    usartx.o(i.Check_Sum) refers to usartx.o(.bss) for Send_Data
+    usartx.o(i.UART5_IRQHandler) refers to stm32f4xx_usart.o(i.USART_GetITStatus) for USART_GetITStatus
+    usartx.o(i.UART5_IRQHandler) refers to stm32f4xx_usart.o(i.USART_ReceiveData) for USART_ReceiveData
+    usartx.o(i.UART5_IRQHandler) refers to usartx.o(i.Check_Sum) for Check_Sum
+    usartx.o(i.UART5_IRQHandler) refers to usartx.o(i.XYZ_Target_Speed_transition) for XYZ_Target_Speed_transition
+    usartx.o(i.UART5_IRQHandler) refers to usartx.o(i.Vz_to_Akm_Angle) for Vz_to_Akm_Angle
+    usartx.o(i.UART5_IRQHandler) refers to balance.o(.data) for Time_count
+    usartx.o(i.UART5_IRQHandler) refers to usartx.o(.bss) for Receive_Data
+    usartx.o(i.UART5_IRQHandler) refers to usartx.o(.data) for Count
+    usartx.o(i.UART5_IRQHandler) refers to system.o(.data) for PS2_ON_Flag
+    usartx.o(i.USART1_IRQHandler) refers to stm32f4xx_usart.o(i.USART_GetITStatus) for USART_GetITStatus
+    usartx.o(i.USART1_IRQHandler) refers to stm32f4xx_usart.o(i.USART_ReceiveData) for USART_ReceiveData
+    usartx.o(i.USART1_IRQHandler) refers to usartx.o(i.XYZ_Target_Speed_transition) for XYZ_Target_Speed_transition
+    usartx.o(i.USART1_IRQHandler) refers to usartx.o(i.Vz_to_Akm_Angle) for Vz_to_Akm_Angle
+    usartx.o(i.USART1_IRQHandler) refers to balance.o(.data) for Time_count
+    usartx.o(i.USART1_IRQHandler) refers to usartx.o(.bss) for rxbuf
+    usartx.o(i.USART1_IRQHandler) refers to usartx.o(.data) for Count
+    usartx.o(i.USART1_IRQHandler) refers to system.o(.data) for Usart1_ON_Flag
+    usartx.o(i.USART1_SEND) refers to usartx.o(i.usart1_send) for usart1_send
+    usartx.o(i.USART1_SEND) refers to usartx.o(.bss) for Send_Data
+    usartx.o(i.USART2_IRQHandler) refers to stm32f4xx_usart.o(i.USART_GetITStatus) for USART_GetITStatus
+    usartx.o(i.USART2_IRQHandler) refers to dflt_clz.o(x$fpl$dflt) for __aeabi_i2d
+    usartx.o(i.USART2_IRQHandler) refers to pow.o(i.__hardfp_pow) for __hardfp_pow
+    usartx.o(i.USART2_IRQHandler) refers to dmul.o(x$fpl$dmul) for __aeabi_dmul
+    usartx.o(i.USART2_IRQHandler) refers to f2d.o(x$fpl$f2d) for __aeabi_f2d
+    usartx.o(i.USART2_IRQHandler) refers to daddsub_clz.o(x$fpl$dadd) for __aeabi_dadd
+    usartx.o(i.USART2_IRQHandler) refers to d2f.o(x$fpl$d2f) for __aeabi_d2f
+    usartx.o(i.USART2_IRQHandler) refers to rt_memclr.o(.text) for __aeabi_memclr
+    usartx.o(i.USART2_IRQHandler) refers to mpu6050.o(.data) for Deviation_Count
+    usartx.o(i.USART2_IRQHandler) refers to usartx.o(.data) for Last_Usart_Receive
+    usartx.o(i.USART2_IRQHandler) refers to system.o(.data) for APP_ON_Flag
+    usartx.o(i.USART2_IRQHandler) refers to usartx.o(.bss) for Receive
+    usartx.o(i.USART3_IRQHandler) refers to stm32f4xx_usart.o(i.USART_GetITStatus) for USART_GetITStatus
+    usartx.o(i.USART3_IRQHandler) refers to stm32f4xx_usart.o(i.USART_ReceiveData) for USART_ReceiveData
+    usartx.o(i.USART3_IRQHandler) refers to usartx.o(i.Check_Sum) for Check_Sum
+    usartx.o(i.USART3_IRQHandler) refers to usartx.o(i.XYZ_Target_Speed_transition) for XYZ_Target_Speed_transition
+    usartx.o(i.USART3_IRQHandler) refers to usartx.o(i.Vz_to_Akm_Angle) for Vz_to_Akm_Angle
+    usartx.o(i.USART3_IRQHandler) refers to balance.o(.data) for Time_count
+    usartx.o(i.USART3_IRQHandler) refers to usartx.o(.bss) for Receive_Data
+    usartx.o(i.USART3_IRQHandler) refers to usartx.o(.data) for Count
+    usartx.o(i.USART3_IRQHandler) refers to system.o(.data) for PS2_ON_Flag
+    usartx.o(i.USART3_SEND) refers to usartx.o(i.usart3_send) for usart3_send
+    usartx.o(i.USART3_SEND) refers to usartx.o(.bss) for Send_Data
+    usartx.o(i.USART5_SEND) refers to usartx.o(i.usart5_send) for usart5_send
+    usartx.o(i.USART5_SEND) refers to usartx.o(.bss) for Send_Data
+    usartx.o(i.Vz_to_Akm_Angle) refers to f2d.o(x$fpl$f2d) for __aeabi_f2d
+    usartx.o(i.Vz_to_Akm_Angle) refers to dmul.o(x$fpl$dmul) for __aeabi_dmul
+    usartx.o(i.Vz_to_Akm_Angle) refers to daddsub_clz.o(x$fpl$dadd) for __aeabi_dadd
+    usartx.o(i.Vz_to_Akm_Angle) refers to ddiv.o(x$fpl$ddiv) for __aeabi_ddiv
+    usartx.o(i.Vz_to_Akm_Angle) refers to atan.o(i.__hardfp_atan) for __hardfp_atan
+    usartx.o(i.Vz_to_Akm_Angle) refers to d2f.o(x$fpl$d2f) for __aeabi_d2f
+    usartx.o(i.Vz_to_Akm_Angle) refers to system.o(.data) for Wheel_spacing
+    usartx.o(i.Vz_to_Akm_Angle) refers to usartx.o(.data) for test_z
+    usartx.o(i.XYZ_Target_Speed_transition) refers to dflt_clz.o(x$fpl$dflt) for __aeabi_i2d
+    usartx.o(i.XYZ_Target_Speed_transition) refers to dmul.o(x$fpl$dmul) for __aeabi_dmul
+    usartx.o(i.XYZ_Target_Speed_transition) refers to daddsub_clz.o(x$fpl$dadd) for __aeabi_dadd
+    usartx.o(i.XYZ_Target_Speed_transition) refers to d2f.o(x$fpl$d2f) for __aeabi_d2f
+    usartx.o(i.data_task) refers to delay.o(i.getSysTickCnt) for getSysTickCnt
+    usartx.o(i.data_task) refers to tasks.o(i.vTaskDelayUntil) for vTaskDelayUntil
+    usartx.o(i.data_task) refers to usartx.o(i.data_transition) for data_transition
+    usartx.o(i.data_task) refers to usartx.o(i.USART1_SEND) for USART1_SEND
+    usartx.o(i.data_task) refers to usartx.o(i.USART3_SEND) for USART3_SEND
+    usartx.o(i.data_task) refers to usartx.o(i.USART5_SEND) for USART5_SEND
+    usartx.o(i.data_task) refers to usartx.o(i.CAN_SEND) for CAN_SEND
+    usartx.o(i.data_transition) refers to sqrt.o(i.__hardfp_sqrt) for __hardfp_sqrt
+    usartx.o(i.data_transition) refers to ddiv.o(x$fpl$ddiv) for __aeabi_ddiv
+    usartx.o(i.data_transition) refers to f2d.o(x$fpl$f2d) for __aeabi_f2d
+    usartx.o(i.data_transition) refers to dmul.o(x$fpl$dmul) for __aeabi_dmul
+    usartx.o(i.data_transition) refers to dfix.o(x$fpl$dfix) for __aeabi_d2iz
+    usartx.o(i.data_transition) refers to usartx.o(.bss) for Send_Data
+    usartx.o(i.data_transition) refers to system.o(.data) for Car_Mode
+    usartx.o(i.data_transition) refers to system.o(.bss) for MOTOR_A
+    usartx.o(i.data_transition) refers to mpu6050.o(.data) for accel
+    usartx.o(i.data_transition) refers to usartx.o(i.Check_Sum) for Check_Sum
+    usartx.o(i.data_transition) refers to adc.o(.data) for Voltage
+    usartx.o(i.uart1_init) refers to stm32f4xx_rcc.o(i.RCC_AHB1PeriphClockCmd) for RCC_AHB1PeriphClockCmd
+    usartx.o(i.uart1_init) refers to stm32f4xx_rcc.o(i.RCC_APB2PeriphClockCmd) for RCC_APB2PeriphClockCmd
+    usartx.o(i.uart1_init) refers to stm32f4xx_gpio.o(i.GPIO_PinAFConfig) for GPIO_PinAFConfig
+    usartx.o(i.uart1_init) refers to stm32f4xx_gpio.o(i.GPIO_Init) for GPIO_Init
+    usartx.o(i.uart1_init) refers to misc.o(i.NVIC_Init) for NVIC_Init
+    usartx.o(i.uart1_init) refers to stm32f4xx_usart.o(i.USART_Init) for USART_Init
+    usartx.o(i.uart1_init) refers to stm32f4xx_usart.o(i.USART_ITConfig) for USART_ITConfig
+    usartx.o(i.uart1_init) refers to stm32f4xx_usart.o(i.USART_Cmd) for USART_Cmd
+    usartx.o(i.uart2_init) refers to stm32f4xx_rcc.o(i.RCC_AHB1PeriphClockCmd) for RCC_AHB1PeriphClockCmd
+    usartx.o(i.uart2_init) refers to stm32f4xx_rcc.o(i.RCC_APB1PeriphClockCmd) for RCC_APB1PeriphClockCmd
+    usartx.o(i.uart2_init) refers to stm32f4xx_gpio.o(i.GPIO_PinAFConfig) for GPIO_PinAFConfig
+    usartx.o(i.uart2_init) refers to stm32f4xx_gpio.o(i.GPIO_Init) for GPIO_Init
+    usartx.o(i.uart2_init) refers to misc.o(i.NVIC_Init) for NVIC_Init
+    usartx.o(i.uart2_init) refers to stm32f4xx_usart.o(i.USART_Init) for USART_Init
+    usartx.o(i.uart2_init) refers to stm32f4xx_usart.o(i.USART_ITConfig) for USART_ITConfig
+    usartx.o(i.uart2_init) refers to stm32f4xx_usart.o(i.USART_Cmd) for USART_Cmd
+    usartx.o(i.uart3_init) refers to stm32f4xx_rcc.o(i.RCC_AHB1PeriphClockCmd) for RCC_AHB1PeriphClockCmd
+    usartx.o(i.uart3_init) refers to stm32f4xx_rcc.o(i.RCC_APB1PeriphClockCmd) for RCC_APB1PeriphClockCmd
+    usartx.o(i.uart3_init) refers to stm32f4xx_gpio.o(i.GPIO_PinAFConfig) for GPIO_PinAFConfig
+    usartx.o(i.uart3_init) refers to stm32f4xx_gpio.o(i.GPIO_Init) for GPIO_Init
+    usartx.o(i.uart3_init) refers to misc.o(i.NVIC_Init) for NVIC_Init
+    usartx.o(i.uart3_init) refers to stm32f4xx_usart.o(i.USART_Init) for USART_Init
+    usartx.o(i.uart3_init) refers to stm32f4xx_usart.o(i.USART_ITConfig) for USART_ITConfig
+    usartx.o(i.uart3_init) refers to stm32f4xx_usart.o(i.USART_Cmd) for USART_Cmd
+    usartx.o(i.uart5_init) refers to stm32f4xx_rcc.o(i.RCC_AHB1PeriphClockCmd) for RCC_AHB1PeriphClockCmd
+    usartx.o(i.uart5_init) refers to stm32f4xx_rcc.o(i.RCC_APB1PeriphClockCmd) for RCC_APB1PeriphClockCmd
+    usartx.o(i.uart5_init) refers to stm32f4xx_gpio.o(i.GPIO_PinAFConfig) for GPIO_PinAFConfig
+    usartx.o(i.uart5_init) refers to stm32f4xx_gpio.o(i.GPIO_Init) for GPIO_Init
+    usartx.o(i.uart5_init) refers to misc.o(i.NVIC_Init) for NVIC_Init
+    usartx.o(i.uart5_init) refers to stm32f4xx_usart.o(i.USART_Init) for USART_Init
+    usartx.o(i.uart5_init) refers to stm32f4xx_usart.o(i.USART_ITConfig) for USART_ITConfig
+    usartx.o(i.uart5_init) refers to stm32f4xx_usart.o(i.USART_Cmd) for USART_Cmd
+    delay.o(i.SysTick_Handler) refers to tasks.o(i.xTaskGetSchedulerState) for xTaskGetSchedulerState
+    delay.o(i.SysTick_Handler) refers to port.o(i.xPortSysTickHandler) for xPortSysTickHandler
+    delay.o(i.delay_init) refers to misc.o(i.SysTick_CLKSourceConfig) for SysTick_CLKSourceConfig
+    delay.o(i.delay_init) refers to delay.o(.data) for fac_us
+    delay.o(i.delay_ms) refers to tasks.o(i.xTaskGetSchedulerState) for xTaskGetSchedulerState
+    delay.o(i.delay_ms) refers to tasks.o(i.vTaskDelay) for vTaskDelay
+    delay.o(i.delay_ms) refers to delay.o(i.delay_us) for delay_us
+    delay.o(i.delay_ms) refers to delay.o(.data) for fac_ms
+    delay.o(i.delay_us) refers to delay.o(.data) for fac_us
+    delay.o(i.delay_xms) refers to delay.o(i.delay_us) for delay_us
+    delay.o(i.getSysTickCnt) refers to tasks.o(i.xTaskGetSchedulerState) for xTaskGetSchedulerState
+    delay.o(i.getSysTickCnt) refers to tasks.o(i.xTaskGetTickCount) for xTaskGetTickCount
+    delay.o(i.getSysTickCnt) refers to delay.o(.data) for sysTickCnt
+    usart.o(.rev16_text) refers (Special) to use_no_semi_2.o(.text) for __use_no_semihosting
+    usart.o(.revsh_text) refers (Special) to use_no_semi_2.o(.text) for __use_no_semihosting
+    usart.o(i._sys_exit) refers (Special) to use_no_semi_2.o(.text) for __use_no_semihosting
+    usart.o(i.fputc) refers (Special) to use_no_semi_2.o(.text) for __use_no_semihosting
+    usart.o(i.uart_init) refers (Special) to use_no_semi_2.o(.text) for __use_no_semihosting
+    usart.o(i.uart_init) refers to stm32f4xx_rcc.o(i.RCC_AHB1PeriphClockCmd) for RCC_AHB1PeriphClockCmd
+    usart.o(i.uart_init) refers to stm32f4xx_rcc.o(i.RCC_APB2PeriphClockCmd) for RCC_APB2PeriphClockCmd
+    usart.o(i.uart_init) refers to stm32f4xx_gpio.o(i.GPIO_PinAFConfig) for GPIO_PinAFConfig
+    usart.o(i.uart_init) refers to stm32f4xx_gpio.o(i.GPIO_Init) for GPIO_Init
+    usart.o(i.uart_init) refers to stm32f4xx_usart.o(i.USART_Init) for USART_Init
+    usart.o(i.uart_init) refers to stm32f4xx_usart.o(i.USART_Cmd) for USART_Cmd
+    usart.o(i.uart_init) refers to stm32f4xx_usart.o(i.USART_ITConfig) for USART_ITConfig
+    usart.o(i.uart_init) refers to misc.o(i.NVIC_Init) for NVIC_Init
+    usart.o(.bss) refers (Special) to use_no_semi_2.o(.text) for __use_no_semihosting
+    usart.o(.data) refers (Special) to use_no_semi_2.o(.text) for __use_no_semihosting
+    startup_stm32f40_41xxx.o(STACK) refers (Special) to heapauxi.o(.text) for __use_two_region_memory
+    startup_stm32f40_41xxx.o(HEAP) refers (Special) to heapauxi.o(.text) for __use_two_region_memory
+    startup_stm32f40_41xxx.o(RESET) refers (Special) to heapauxi.o(.text) for __use_two_region_memory
+    startup_stm32f40_41xxx.o(RESET) refers to startup_stm32f40_41xxx.o(STACK) for __initial_sp
+    startup_stm32f40_41xxx.o(RESET) refers to startup_stm32f40_41xxx.o(.text) for Reset_Handler
+    startup_stm32f40_41xxx.o(RESET) refers to stm32f4xx_it.o(i.NMI_Handler) for NMI_Handler
+    startup_stm32f40_41xxx.o(RESET) refers to stm32f4xx_it.o(i.HardFault_Handler) for HardFault_Handler
+    startup_stm32f40_41xxx.o(RESET) refers to stm32f4xx_it.o(i.MemManage_Handler) for MemManage_Handler
+    startup_stm32f40_41xxx.o(RESET) refers to stm32f4xx_it.o(i.BusFault_Handler) for BusFault_Handler
+    startup_stm32f40_41xxx.o(RESET) refers to stm32f4xx_it.o(i.UsageFault_Handler) for UsageFault_Handler
+    startup_stm32f40_41xxx.o(RESET) refers to port.o(.emb_text) for SVC_Handler
+    startup_stm32f40_41xxx.o(RESET) refers to stm32f4xx_it.o(i.DebugMon_Handler) for DebugMon_Handler
+    startup_stm32f40_41xxx.o(RESET) refers to delay.o(i.SysTick_Handler) for SysTick_Handler
+    startup_stm32f40_41xxx.o(RESET) refers to can.o(i.CAN1_RX0_IRQHandler) for CAN1_RX0_IRQHandler
+    startup_stm32f40_41xxx.o(RESET) refers to encoder.o(i.TIM2_IRQHandler) for TIM2_IRQHandler
+    startup_stm32f40_41xxx.o(RESET) refers to encoder.o(i.TIM3_IRQHandler) for TIM3_IRQHandler
+    startup_stm32f40_41xxx.o(RESET) refers to encoder.o(i.TIM4_IRQHandler) for TIM4_IRQHandler
+    startup_stm32f40_41xxx.o(RESET) refers to usartx.o(i.USART1_IRQHandler) for USART1_IRQHandler
+    startup_stm32f40_41xxx.o(RESET) refers to usartx.o(i.USART2_IRQHandler) for USART2_IRQHandler
+    startup_stm32f40_41xxx.o(RESET) refers to usartx.o(i.USART3_IRQHandler) for USART3_IRQHandler
+    startup_stm32f40_41xxx.o(RESET) refers to encoder.o(i.TIM8_BRK_TIM12_IRQHandler) for TIM8_BRK_TIM12_IRQHandler
+    startup_stm32f40_41xxx.o(RESET) refers to timer.o(i.TIM8_UP_TIM13_IRQHandler) for TIM8_UP_TIM13_IRQHandler
+    startup_stm32f40_41xxx.o(RESET) refers to timer.o(i.TIM8_CC_IRQHandler) for TIM8_CC_IRQHandler
+    startup_stm32f40_41xxx.o(RESET) refers to encoder.o(i.TIM5_IRQHandler) for TIM5_IRQHandler
+    startup_stm32f40_41xxx.o(RESET) refers to usartx.o(i.UART5_IRQHandler) for UART5_IRQHandler
+    startup_stm32f40_41xxx.o(.text) refers (Special) to heapauxi.o(.text) for __use_two_region_memory
+    startup_stm32f40_41xxx.o(.text) refers to system_stm32f4xx.o(i.SystemInit) for SystemInit
+    startup_stm32f40_41xxx.o(.text) refers to __main.o(!!!main) for __main
+    startup_stm32f40_41xxx.o(.text) refers to startup_stm32f40_41xxx.o(HEAP) for Heap_Mem
+    startup_stm32f40_41xxx.o(.text) refers to startup_stm32f40_41xxx.o(STACK) for Stack_Mem
+    stm32f4xx_gpio.o(i.GPIO_DeInit) refers to stm32f4xx_rcc.o(i.RCC_AHB1PeriphResetCmd) for RCC_AHB1PeriphResetCmd
+    stm32f4xx_rcc.o(i.RCC_GetClocksFreq) refers to stm32f4xx_rcc.o(.data) for APBAHBPrescTable
+    stm32f4xx_rcc.o(i.RCC_WaitForHSEStartUp) refers to stm32f4xx_rcc.o(i.RCC_GetFlagStatus) for RCC_GetFlagStatus
+    stm32f4xx_syscfg.o(i.SYSCFG_DeInit) refers to stm32f4xx_rcc.o(i.RCC_APB2PeriphResetCmd) for RCC_APB2PeriphResetCmd
+    stm32f4xx_usart.o(i.USART_DeInit) refers to stm32f4xx_rcc.o(i.RCC_APB2PeriphResetCmd) for RCC_APB2PeriphResetCmd
+    stm32f4xx_usart.o(i.USART_DeInit) refers to stm32f4xx_rcc.o(i.RCC_APB1PeriphResetCmd) for RCC_APB1PeriphResetCmd
+    stm32f4xx_usart.o(i.USART_Init) refers to stm32f4xx_rcc.o(i.RCC_GetClocksFreq) for RCC_GetClocksFreq
+    stm32f4xx_adc.o(i.ADC_DeInit) refers to stm32f4xx_rcc.o(i.RCC_APB2PeriphResetCmd) for RCC_APB2PeriphResetCmd
+    stm32f4xx_can.o(i.CAN_DeInit) refers to stm32f4xx_rcc.o(i.RCC_APB1PeriphResetCmd) for RCC_APB1PeriphResetCmd
+    stm32f4xx_can.o(i.CAN_GetITStatus) refers to stm32f4xx_can.o(i.CheckITStatus) for CheckITStatus
+    stm32f4xx_tim.o(i.TIM_DeInit) refers to stm32f4xx_rcc.o(i.RCC_APB2PeriphResetCmd) for RCC_APB2PeriphResetCmd
+    stm32f4xx_tim.o(i.TIM_DeInit) refers to stm32f4xx_rcc.o(i.RCC_APB1PeriphResetCmd) for RCC_APB1PeriphResetCmd
+    stm32f4xx_tim.o(i.TIM_ETRClockMode1Config) refers to stm32f4xx_tim.o(i.TIM_ETRConfig) for TIM_ETRConfig
+    stm32f4xx_tim.o(i.TIM_ETRClockMode2Config) refers to stm32f4xx_tim.o(i.TIM_ETRConfig) for TIM_ETRConfig
+    stm32f4xx_tim.o(i.TIM_ICInit) refers to stm32f4xx_tim.o(i.TI1_Config) for TI1_Config
+    stm32f4xx_tim.o(i.TIM_ICInit) refers to stm32f4xx_tim.o(i.TIM_SetIC1Prescaler) for TIM_SetIC1Prescaler
+    stm32f4xx_tim.o(i.TIM_ICInit) refers to stm32f4xx_tim.o(i.TI2_Config) for TI2_Config
+    stm32f4xx_tim.o(i.TIM_ICInit) refers to stm32f4xx_tim.o(i.TIM_SetIC2Prescaler) for TIM_SetIC2Prescaler
+    stm32f4xx_tim.o(i.TIM_ICInit) refers to stm32f4xx_tim.o(i.TI3_Config) for TI3_Config
+    stm32f4xx_tim.o(i.TIM_ICInit) refers to stm32f4xx_tim.o(i.TIM_SetIC3Prescaler) for TIM_SetIC3Prescaler
+    stm32f4xx_tim.o(i.TIM_ICInit) refers to stm32f4xx_tim.o(i.TI4_Config) for TI4_Config
+    stm32f4xx_tim.o(i.TIM_ICInit) refers to stm32f4xx_tim.o(i.TIM_SetIC4Prescaler) for TIM_SetIC4Prescaler
+    stm32f4xx_tim.o(i.TIM_ITRxExternalClockConfig) refers to stm32f4xx_tim.o(i.TIM_SelectInputTrigger) for TIM_SelectInputTrigger
+    stm32f4xx_tim.o(i.TIM_PWMIConfig) refers to stm32f4xx_tim.o(i.TI1_Config) for TI1_Config
+    stm32f4xx_tim.o(i.TIM_PWMIConfig) refers to stm32f4xx_tim.o(i.TIM_SetIC1Prescaler) for TIM_SetIC1Prescaler
+    stm32f4xx_tim.o(i.TIM_PWMIConfig) refers to stm32f4xx_tim.o(i.TI2_Config) for TI2_Config
+    stm32f4xx_tim.o(i.TIM_PWMIConfig) refers to stm32f4xx_tim.o(i.TIM_SetIC2Prescaler) for TIM_SetIC2Prescaler
+    stm32f4xx_tim.o(i.TIM_TIxExternalClockConfig) refers to stm32f4xx_tim.o(i.TI2_Config) for TI2_Config
+    stm32f4xx_tim.o(i.TIM_TIxExternalClockConfig) refers to stm32f4xx_tim.o(i.TI1_Config) for TI1_Config
+    stm32f4xx_tim.o(i.TIM_TIxExternalClockConfig) refers to stm32f4xx_tim.o(i.TIM_SelectInputTrigger) for TIM_SelectInputTrigger
+    stm32f4xx_pwr.o(i.PWR_DeInit) refers to stm32f4xx_rcc.o(i.RCC_APB1PeriphResetCmd) for RCC_APB1PeriphResetCmd
+    event_groups.o(i.vEventGroupClearBitsCallback) refers to event_groups.o(i.xEventGroupClearBits) for xEventGroupClearBits
+    event_groups.o(i.vEventGroupDelete) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    event_groups.o(i.vEventGroupDelete) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    event_groups.o(i.vEventGroupDelete) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    event_groups.o(i.vEventGroupDelete) refers to _printf_dec.o(.text) for _printf_int_dec
+    event_groups.o(i.vEventGroupDelete) refers to _printf_str.o(.text) for _printf_str
+    event_groups.o(i.vEventGroupDelete) refers to tasks.o(i.vTaskSuspendAll) for vTaskSuspendAll
+    event_groups.o(i.vEventGroupDelete) refers to noretval__2printf.o(.text) for __2printf
+    event_groups.o(i.vEventGroupDelete) refers to tasks.o(i.xTaskRemoveFromUnorderedEventList) for xTaskRemoveFromUnorderedEventList
+    event_groups.o(i.vEventGroupDelete) refers to heap_4.o(i.vPortFree) for vPortFree
+    event_groups.o(i.vEventGroupDelete) refers to tasks.o(i.xTaskResumeAll) for xTaskResumeAll
+    event_groups.o(i.vEventGroupSetBitsCallback) refers to event_groups.o(i.xEventGroupSetBits) for xEventGroupSetBits
+    event_groups.o(i.xEventGroupClearBits) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    event_groups.o(i.xEventGroupClearBits) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    event_groups.o(i.xEventGroupClearBits) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    event_groups.o(i.xEventGroupClearBits) refers to _printf_dec.o(.text) for _printf_int_dec
+    event_groups.o(i.xEventGroupClearBits) refers to _printf_str.o(.text) for _printf_str
+    event_groups.o(i.xEventGroupClearBits) refers to noretval__2printf.o(.text) for __2printf
+    event_groups.o(i.xEventGroupClearBits) refers to port.o(i.vPortEnterCritical) for vPortEnterCritical
+    event_groups.o(i.xEventGroupClearBits) refers to port.o(i.vPortExitCritical) for vPortExitCritical
+    event_groups.o(i.xEventGroupClearBitsFromISR) refers to timers.o(i.xTimerPendFunctionCallFromISR) for xTimerPendFunctionCallFromISR
+    event_groups.o(i.xEventGroupClearBitsFromISR) refers to event_groups.o(i.vEventGroupClearBitsCallback) for vEventGroupClearBitsCallback
+    event_groups.o(i.xEventGroupCreate) refers to heap_4.o(i.pvPortMalloc) for pvPortMalloc
+    event_groups.o(i.xEventGroupCreate) refers to list.o(i.vListInitialise) for vListInitialise
+    event_groups.o(i.xEventGroupSetBits) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    event_groups.o(i.xEventGroupSetBits) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    event_groups.o(i.xEventGroupSetBits) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    event_groups.o(i.xEventGroupSetBits) refers to _printf_dec.o(.text) for _printf_int_dec
+    event_groups.o(i.xEventGroupSetBits) refers to _printf_str.o(.text) for _printf_str
+    event_groups.o(i.xEventGroupSetBits) refers to noretval__2printf.o(.text) for __2printf
+    event_groups.o(i.xEventGroupSetBits) refers to tasks.o(i.vTaskSuspendAll) for vTaskSuspendAll
+    event_groups.o(i.xEventGroupSetBits) refers to tasks.o(i.xTaskRemoveFromUnorderedEventList) for xTaskRemoveFromUnorderedEventList
+    event_groups.o(i.xEventGroupSetBits) refers to tasks.o(i.xTaskResumeAll) for xTaskResumeAll
+    event_groups.o(i.xEventGroupSetBitsFromISR) refers to timers.o(i.xTimerPendFunctionCallFromISR) for xTimerPendFunctionCallFromISR
+    event_groups.o(i.xEventGroupSetBitsFromISR) refers to event_groups.o(i.vEventGroupSetBitsCallback) for vEventGroupSetBitsCallback
+    event_groups.o(i.xEventGroupSync) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    event_groups.o(i.xEventGroupSync) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    event_groups.o(i.xEventGroupSync) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    event_groups.o(i.xEventGroupSync) refers to _printf_dec.o(.text) for _printf_int_dec
+    event_groups.o(i.xEventGroupSync) refers to _printf_str.o(.text) for _printf_str
+    event_groups.o(i.xEventGroupSync) refers to noretval__2printf.o(.text) for __2printf
+    event_groups.o(i.xEventGroupSync) refers to tasks.o(i.xTaskGetSchedulerState) for xTaskGetSchedulerState
+    event_groups.o(i.xEventGroupSync) refers to tasks.o(i.vTaskSuspendAll) for vTaskSuspendAll
+    event_groups.o(i.xEventGroupSync) refers to event_groups.o(i.xEventGroupSetBits) for xEventGroupSetBits
+    event_groups.o(i.xEventGroupSync) refers to tasks.o(i.vTaskPlaceOnUnorderedEventList) for vTaskPlaceOnUnorderedEventList
+    event_groups.o(i.xEventGroupSync) refers to tasks.o(i.xTaskResumeAll) for xTaskResumeAll
+    event_groups.o(i.xEventGroupSync) refers to tasks.o(i.uxTaskResetEventItemValue) for uxTaskResetEventItemValue
+    event_groups.o(i.xEventGroupSync) refers to port.o(i.vPortEnterCritical) for vPortEnterCritical
+    event_groups.o(i.xEventGroupSync) refers to port.o(i.vPortExitCritical) for vPortExitCritical
+    event_groups.o(i.xEventGroupWaitBits) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    event_groups.o(i.xEventGroupWaitBits) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    event_groups.o(i.xEventGroupWaitBits) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    event_groups.o(i.xEventGroupWaitBits) refers to _printf_dec.o(.text) for _printf_int_dec
+    event_groups.o(i.xEventGroupWaitBits) refers to _printf_str.o(.text) for _printf_str
+    event_groups.o(i.xEventGroupWaitBits) refers to noretval__2printf.o(.text) for __2printf
+    event_groups.o(i.xEventGroupWaitBits) refers to tasks.o(i.xTaskGetSchedulerState) for xTaskGetSchedulerState
+    event_groups.o(i.xEventGroupWaitBits) refers to tasks.o(i.vTaskSuspendAll) for vTaskSuspendAll
+    event_groups.o(i.xEventGroupWaitBits) refers to event_groups.o(i.prvTestWaitCondition) for prvTestWaitCondition
+    event_groups.o(i.xEventGroupWaitBits) refers to tasks.o(i.vTaskPlaceOnUnorderedEventList) for vTaskPlaceOnUnorderedEventList
+    event_groups.o(i.xEventGroupWaitBits) refers to tasks.o(i.xTaskResumeAll) for xTaskResumeAll
+    event_groups.o(i.xEventGroupWaitBits) refers to tasks.o(i.uxTaskResetEventItemValue) for uxTaskResetEventItemValue
+    event_groups.o(i.xEventGroupWaitBits) refers to port.o(i.vPortEnterCritical) for vPortEnterCritical
+    event_groups.o(i.xEventGroupWaitBits) refers to port.o(i.vPortExitCritical) for vPortExitCritical
+    queue.o(i.pcQueueGetName) refers to queue.o(.bss) for xQueueRegistry
+    queue.o(i.prvCopyDataFromQueue) refers to rt_memcpy_v6.o(.text) for __aeabi_memcpy
+    queue.o(i.prvCopyDataToQueue) refers to tasks.o(i.xTaskPriorityDisinherit) for xTaskPriorityDisinherit
+    queue.o(i.prvCopyDataToQueue) refers to rt_memcpy_v6.o(.text) for __aeabi_memcpy
+    queue.o(i.prvInitialiseMutex) refers to queue.o(i.xQueueGenericSend) for xQueueGenericSend
+    queue.o(i.prvInitialiseNewQueue) refers to queue.o(i.xQueueGenericReset) for xQueueGenericReset
+    queue.o(i.prvIsQueueEmpty) refers to port.o(i.vPortEnterCritical) for vPortEnterCritical
+    queue.o(i.prvIsQueueEmpty) refers to port.o(i.vPortExitCritical) for vPortExitCritical
+    queue.o(i.prvIsQueueFull) refers to port.o(i.vPortEnterCritical) for vPortEnterCritical
+    queue.o(i.prvIsQueueFull) refers to port.o(i.vPortExitCritical) for vPortExitCritical
+    queue.o(i.prvNotifyQueueSetContainer) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    queue.o(i.prvNotifyQueueSetContainer) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    queue.o(i.prvNotifyQueueSetContainer) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    queue.o(i.prvNotifyQueueSetContainer) refers to _printf_dec.o(.text) for _printf_int_dec
+    queue.o(i.prvNotifyQueueSetContainer) refers to _printf_str.o(.text) for _printf_str
+    queue.o(i.prvNotifyQueueSetContainer) refers to noretval__2printf.o(.text) for __2printf
+    queue.o(i.prvNotifyQueueSetContainer) refers to queue.o(i.prvCopyDataToQueue) for prvCopyDataToQueue
+    queue.o(i.prvNotifyQueueSetContainer) refers to tasks.o(i.xTaskRemoveFromEventList) for xTaskRemoveFromEventList
+    queue.o(i.prvUnlockQueue) refers to port.o(i.vPortEnterCritical) for vPortEnterCritical
+    queue.o(i.prvUnlockQueue) refers to queue.o(i.prvNotifyQueueSetContainer) for prvNotifyQueueSetContainer
+    queue.o(i.prvUnlockQueue) refers to tasks.o(i.vTaskMissedYield) for vTaskMissedYield
+    queue.o(i.prvUnlockQueue) refers to tasks.o(i.xTaskRemoveFromEventList) for xTaskRemoveFromEventList
+    queue.o(i.prvUnlockQueue) refers to port.o(i.vPortExitCritical) for vPortExitCritical
+    queue.o(i.uxQueueMessagesWaiting) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    queue.o(i.uxQueueMessagesWaiting) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    queue.o(i.uxQueueMessagesWaiting) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    queue.o(i.uxQueueMessagesWaiting) refers to _printf_dec.o(.text) for _printf_int_dec
+    queue.o(i.uxQueueMessagesWaiting) refers to _printf_str.o(.text) for _printf_str
+    queue.o(i.uxQueueMessagesWaiting) refers to noretval__2printf.o(.text) for __2printf
+    queue.o(i.uxQueueMessagesWaiting) refers to port.o(i.vPortEnterCritical) for vPortEnterCritical
+    queue.o(i.uxQueueMessagesWaiting) refers to port.o(i.vPortExitCritical) for vPortExitCritical
+    queue.o(i.uxQueueMessagesWaitingFromISR) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    queue.o(i.uxQueueMessagesWaitingFromISR) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    queue.o(i.uxQueueMessagesWaitingFromISR) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    queue.o(i.uxQueueMessagesWaitingFromISR) refers to _printf_dec.o(.text) for _printf_int_dec
+    queue.o(i.uxQueueMessagesWaitingFromISR) refers to _printf_str.o(.text) for _printf_str
+    queue.o(i.uxQueueMessagesWaitingFromISR) refers to noretval__2printf.o(.text) for __2printf
+    queue.o(i.uxQueueSpacesAvailable) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    queue.o(i.uxQueueSpacesAvailable) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    queue.o(i.uxQueueSpacesAvailable) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    queue.o(i.uxQueueSpacesAvailable) refers to _printf_dec.o(.text) for _printf_int_dec
+    queue.o(i.uxQueueSpacesAvailable) refers to _printf_str.o(.text) for _printf_str
+    queue.o(i.uxQueueSpacesAvailable) refers to noretval__2printf.o(.text) for __2printf
+    queue.o(i.uxQueueSpacesAvailable) refers to port.o(i.vPortEnterCritical) for vPortEnterCritical
+    queue.o(i.uxQueueSpacesAvailable) refers to port.o(i.vPortExitCritical) for vPortExitCritical
+    queue.o(i.vQueueAddToRegistry) refers to queue.o(.bss) for xQueueRegistry
+    queue.o(i.vQueueDelete) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    queue.o(i.vQueueDelete) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    queue.o(i.vQueueDelete) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    queue.o(i.vQueueDelete) refers to _printf_dec.o(.text) for _printf_int_dec
+    queue.o(i.vQueueDelete) refers to _printf_str.o(.text) for _printf_str
+    queue.o(i.vQueueDelete) refers to noretval__2printf.o(.text) for __2printf
+    queue.o(i.vQueueDelete) refers to queue.o(i.vQueueUnregisterQueue) for vQueueUnregisterQueue
+    queue.o(i.vQueueDelete) refers to heap_4.o(i.vPortFree) for vPortFree
+    queue.o(i.vQueueUnregisterQueue) refers to queue.o(.bss) for xQueueRegistry
+    queue.o(i.vQueueWaitForMessageRestricted) refers to port.o(i.vPortEnterCritical) for vPortEnterCritical
+    queue.o(i.vQueueWaitForMessageRestricted) refers to port.o(i.vPortExitCritical) for vPortExitCritical
+    queue.o(i.vQueueWaitForMessageRestricted) refers to tasks.o(i.vTaskPlaceOnEventListRestricted) for vTaskPlaceOnEventListRestricted
+    queue.o(i.vQueueWaitForMessageRestricted) refers to queue.o(i.prvUnlockQueue) for prvUnlockQueue
+    queue.o(i.xQueueAddToSet) refers to port.o(i.vPortEnterCritical) for vPortEnterCritical
+    queue.o(i.xQueueAddToSet) refers to port.o(i.vPortExitCritical) for vPortExitCritical
+    queue.o(i.xQueueCreateCountingSemaphore) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    queue.o(i.xQueueCreateCountingSemaphore) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    queue.o(i.xQueueCreateCountingSemaphore) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    queue.o(i.xQueueCreateCountingSemaphore) refers to _printf_dec.o(.text) for _printf_int_dec
+    queue.o(i.xQueueCreateCountingSemaphore) refers to _printf_str.o(.text) for _printf_str
+    queue.o(i.xQueueCreateCountingSemaphore) refers to noretval__2printf.o(.text) for __2printf
+    queue.o(i.xQueueCreateCountingSemaphore) refers to queue.o(i.xQueueGenericCreate) for xQueueGenericCreate
+    queue.o(i.xQueueCreateMutex) refers to queue.o(i.xQueueGenericCreate) for xQueueGenericCreate
+    queue.o(i.xQueueCreateMutex) refers to queue.o(i.prvInitialiseMutex) for prvInitialiseMutex
+    queue.o(i.xQueueCreateSet) refers to queue.o(i.xQueueGenericCreate) for xQueueGenericCreate
+    queue.o(i.xQueueGenericCreate) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    queue.o(i.xQueueGenericCreate) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    queue.o(i.xQueueGenericCreate) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    queue.o(i.xQueueGenericCreate) refers to _printf_dec.o(.text) for _printf_int_dec
+    queue.o(i.xQueueGenericCreate) refers to _printf_str.o(.text) for _printf_str
+    queue.o(i.xQueueGenericCreate) refers to noretval__2printf.o(.text) for __2printf
+    queue.o(i.xQueueGenericCreate) refers to heap_4.o(i.pvPortMalloc) for pvPortMalloc
+    queue.o(i.xQueueGenericCreate) refers to queue.o(i.prvInitialiseNewQueue) for prvInitialiseNewQueue
+    queue.o(i.xQueueGenericReceive) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    queue.o(i.xQueueGenericReceive) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    queue.o(i.xQueueGenericReceive) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    queue.o(i.xQueueGenericReceive) refers to _printf_dec.o(.text) for _printf_int_dec
+    queue.o(i.xQueueGenericReceive) refers to _printf_str.o(.text) for _printf_str
+    queue.o(i.xQueueGenericReceive) refers to noretval__2printf.o(.text) for __2printf
+    queue.o(i.xQueueGenericReceive) refers to tasks.o(i.xTaskGetSchedulerState) for xTaskGetSchedulerState
+    queue.o(i.xQueueGenericReceive) refers to port.o(i.vPortEnterCritical) for vPortEnterCritical
+    queue.o(i.xQueueGenericReceive) refers to queue.o(i.prvCopyDataFromQueue) for prvCopyDataFromQueue
+    queue.o(i.xQueueGenericReceive) refers to tasks.o(i.pvTaskIncrementMutexHeldCount) for pvTaskIncrementMutexHeldCount
+    queue.o(i.xQueueGenericReceive) refers to tasks.o(i.xTaskRemoveFromEventList) for xTaskRemoveFromEventList
+    queue.o(i.xQueueGenericReceive) refers to port.o(i.vPortExitCritical) for vPortExitCritical
+    queue.o(i.xQueueGenericReceive) refers to tasks.o(i.vTaskSetTimeOutState) for vTaskSetTimeOutState
+    queue.o(i.xQueueGenericReceive) refers to tasks.o(i.vTaskSuspendAll) for vTaskSuspendAll
+    queue.o(i.xQueueGenericReceive) refers to tasks.o(i.xTaskCheckForTimeOut) for xTaskCheckForTimeOut
+    queue.o(i.xQueueGenericReceive) refers to queue.o(i.prvIsQueueEmpty) for prvIsQueueEmpty
+    queue.o(i.xQueueGenericReceive) refers to tasks.o(i.vTaskPriorityInherit) for vTaskPriorityInherit
+    queue.o(i.xQueueGenericReceive) refers to tasks.o(i.vTaskPlaceOnEventList) for vTaskPlaceOnEventList
+    queue.o(i.xQueueGenericReceive) refers to queue.o(i.prvUnlockQueue) for prvUnlockQueue
+    queue.o(i.xQueueGenericReceive) refers to tasks.o(i.xTaskResumeAll) for xTaskResumeAll
+    queue.o(i.xQueueGenericReset) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    queue.o(i.xQueueGenericReset) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    queue.o(i.xQueueGenericReset) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    queue.o(i.xQueueGenericReset) refers to _printf_dec.o(.text) for _printf_int_dec
+    queue.o(i.xQueueGenericReset) refers to _printf_str.o(.text) for _printf_str
+    queue.o(i.xQueueGenericReset) refers to noretval__2printf.o(.text) for __2printf
+    queue.o(i.xQueueGenericReset) refers to port.o(i.vPortEnterCritical) for vPortEnterCritical
+    queue.o(i.xQueueGenericReset) refers to tasks.o(i.xTaskRemoveFromEventList) for xTaskRemoveFromEventList
+    queue.o(i.xQueueGenericReset) refers to list.o(i.vListInitialise) for vListInitialise
+    queue.o(i.xQueueGenericReset) refers to port.o(i.vPortExitCritical) for vPortExitCritical
+    queue.o(i.xQueueGenericSend) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    queue.o(i.xQueueGenericSend) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    queue.o(i.xQueueGenericSend) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    queue.o(i.xQueueGenericSend) refers to _printf_dec.o(.text) for _printf_int_dec
+    queue.o(i.xQueueGenericSend) refers to _printf_str.o(.text) for _printf_str
+    queue.o(i.xQueueGenericSend) refers to noretval__2printf.o(.text) for __2printf
+    queue.o(i.xQueueGenericSend) refers to tasks.o(i.xTaskGetSchedulerState) for xTaskGetSchedulerState
+    queue.o(i.xQueueGenericSend) refers to port.o(i.vPortEnterCritical) for vPortEnterCritical
+    queue.o(i.xQueueGenericSend) refers to queue.o(i.prvCopyDataToQueue) for prvCopyDataToQueue
+    queue.o(i.xQueueGenericSend) refers to queue.o(i.prvNotifyQueueSetContainer) for prvNotifyQueueSetContainer
+    queue.o(i.xQueueGenericSend) refers to tasks.o(i.xTaskRemoveFromEventList) for xTaskRemoveFromEventList
+    queue.o(i.xQueueGenericSend) refers to port.o(i.vPortExitCritical) for vPortExitCritical
+    queue.o(i.xQueueGenericSend) refers to tasks.o(i.vTaskSetTimeOutState) for vTaskSetTimeOutState
+    queue.o(i.xQueueGenericSend) refers to tasks.o(i.vTaskSuspendAll) for vTaskSuspendAll
+    queue.o(i.xQueueGenericSend) refers to tasks.o(i.xTaskCheckForTimeOut) for xTaskCheckForTimeOut
+    queue.o(i.xQueueGenericSend) refers to queue.o(i.prvIsQueueFull) for prvIsQueueFull
+    queue.o(i.xQueueGenericSend) refers to tasks.o(i.vTaskPlaceOnEventList) for vTaskPlaceOnEventList
+    queue.o(i.xQueueGenericSend) refers to queue.o(i.prvUnlockQueue) for prvUnlockQueue
+    queue.o(i.xQueueGenericSend) refers to tasks.o(i.xTaskResumeAll) for xTaskResumeAll
+    queue.o(i.xQueueGenericSendFromISR) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    queue.o(i.xQueueGenericSendFromISR) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    queue.o(i.xQueueGenericSendFromISR) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    queue.o(i.xQueueGenericSendFromISR) refers to _printf_dec.o(.text) for _printf_int_dec
+    queue.o(i.xQueueGenericSendFromISR) refers to _printf_str.o(.text) for _printf_str
+    queue.o(i.xQueueGenericSendFromISR) refers to noretval__2printf.o(.text) for __2printf
+    queue.o(i.xQueueGenericSendFromISR) refers to port.o(i.vPortValidateInterruptPriority) for vPortValidateInterruptPriority
+    queue.o(i.xQueueGenericSendFromISR) refers to queue.o(i.prvCopyDataToQueue) for prvCopyDataToQueue
+    queue.o(i.xQueueGenericSendFromISR) refers to queue.o(i.prvNotifyQueueSetContainer) for prvNotifyQueueSetContainer
+    queue.o(i.xQueueGenericSendFromISR) refers to tasks.o(i.xTaskRemoveFromEventList) for xTaskRemoveFromEventList
+    queue.o(i.xQueueGiveFromISR) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    queue.o(i.xQueueGiveFromISR) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    queue.o(i.xQueueGiveFromISR) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    queue.o(i.xQueueGiveFromISR) refers to _printf_dec.o(.text) for _printf_int_dec
+    queue.o(i.xQueueGiveFromISR) refers to _printf_str.o(.text) for _printf_str
+    queue.o(i.xQueueGiveFromISR) refers to noretval__2printf.o(.text) for __2printf
+    queue.o(i.xQueueGiveFromISR) refers to port.o(i.vPortValidateInterruptPriority) for vPortValidateInterruptPriority
+    queue.o(i.xQueueGiveFromISR) refers to queue.o(i.prvNotifyQueueSetContainer) for prvNotifyQueueSetContainer
+    queue.o(i.xQueueGiveFromISR) refers to tasks.o(i.xTaskRemoveFromEventList) for xTaskRemoveFromEventList
+    queue.o(i.xQueueGiveMutexRecursive) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    queue.o(i.xQueueGiveMutexRecursive) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    queue.o(i.xQueueGiveMutexRecursive) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    queue.o(i.xQueueGiveMutexRecursive) refers to _printf_dec.o(.text) for _printf_int_dec
+    queue.o(i.xQueueGiveMutexRecursive) refers to _printf_str.o(.text) for _printf_str
+    queue.o(i.xQueueGiveMutexRecursive) refers to noretval__2printf.o(.text) for __2printf
+    queue.o(i.xQueueGiveMutexRecursive) refers to tasks.o(i.xTaskGetCurrentTaskHandle) for xTaskGetCurrentTaskHandle
+    queue.o(i.xQueueGiveMutexRecursive) refers to queue.o(i.xQueueGenericSend) for xQueueGenericSend
+    queue.o(i.xQueueIsQueueEmptyFromISR) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    queue.o(i.xQueueIsQueueEmptyFromISR) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    queue.o(i.xQueueIsQueueEmptyFromISR) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    queue.o(i.xQueueIsQueueEmptyFromISR) refers to _printf_dec.o(.text) for _printf_int_dec
+    queue.o(i.xQueueIsQueueEmptyFromISR) refers to _printf_str.o(.text) for _printf_str
+    queue.o(i.xQueueIsQueueEmptyFromISR) refers to noretval__2printf.o(.text) for __2printf
+    queue.o(i.xQueueIsQueueFullFromISR) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    queue.o(i.xQueueIsQueueFullFromISR) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    queue.o(i.xQueueIsQueueFullFromISR) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    queue.o(i.xQueueIsQueueFullFromISR) refers to _printf_dec.o(.text) for _printf_int_dec
+    queue.o(i.xQueueIsQueueFullFromISR) refers to _printf_str.o(.text) for _printf_str
+    queue.o(i.xQueueIsQueueFullFromISR) refers to noretval__2printf.o(.text) for __2printf
+    queue.o(i.xQueuePeekFromISR) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    queue.o(i.xQueuePeekFromISR) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    queue.o(i.xQueuePeekFromISR) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    queue.o(i.xQueuePeekFromISR) refers to _printf_dec.o(.text) for _printf_int_dec
+    queue.o(i.xQueuePeekFromISR) refers to _printf_str.o(.text) for _printf_str
+    queue.o(i.xQueuePeekFromISR) refers to noretval__2printf.o(.text) for __2printf
+    queue.o(i.xQueuePeekFromISR) refers to port.o(i.vPortValidateInterruptPriority) for vPortValidateInterruptPriority
+    queue.o(i.xQueuePeekFromISR) refers to queue.o(i.prvCopyDataFromQueue) for prvCopyDataFromQueue
+    queue.o(i.xQueueReceiveFromISR) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    queue.o(i.xQueueReceiveFromISR) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    queue.o(i.xQueueReceiveFromISR) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    queue.o(i.xQueueReceiveFromISR) refers to _printf_dec.o(.text) for _printf_int_dec
+    queue.o(i.xQueueReceiveFromISR) refers to _printf_str.o(.text) for _printf_str
+    queue.o(i.xQueueReceiveFromISR) refers to noretval__2printf.o(.text) for __2printf
+    queue.o(i.xQueueReceiveFromISR) refers to port.o(i.vPortValidateInterruptPriority) for vPortValidateInterruptPriority
+    queue.o(i.xQueueReceiveFromISR) refers to queue.o(i.prvCopyDataFromQueue) for prvCopyDataFromQueue
+    queue.o(i.xQueueReceiveFromISR) refers to tasks.o(i.xTaskRemoveFromEventList) for xTaskRemoveFromEventList
+    queue.o(i.xQueueRemoveFromSet) refers to port.o(i.vPortEnterCritical) for vPortEnterCritical
+    queue.o(i.xQueueRemoveFromSet) refers to port.o(i.vPortExitCritical) for vPortExitCritical
+    queue.o(i.xQueueSelectFromSet) refers to queue.o(i.xQueueGenericReceive) for xQueueGenericReceive
+    queue.o(i.xQueueSelectFromSetFromISR) refers to queue.o(i.xQueueReceiveFromISR) for xQueueReceiveFromISR
+    queue.o(i.xQueueTakeMutexRecursive) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    queue.o(i.xQueueTakeMutexRecursive) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    queue.o(i.xQueueTakeMutexRecursive) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    queue.o(i.xQueueTakeMutexRecursive) refers to _printf_dec.o(.text) for _printf_int_dec
+    queue.o(i.xQueueTakeMutexRecursive) refers to _printf_str.o(.text) for _printf_str
+    queue.o(i.xQueueTakeMutexRecursive) refers to noretval__2printf.o(.text) for __2printf
+    queue.o(i.xQueueTakeMutexRecursive) refers to tasks.o(i.xTaskGetCurrentTaskHandle) for xTaskGetCurrentTaskHandle
+    queue.o(i.xQueueTakeMutexRecursive) refers to queue.o(i.xQueueGenericReceive) for xQueueGenericReceive
+    tasks.o(i.eTaskGetState) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    tasks.o(i.eTaskGetState) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    tasks.o(i.eTaskGetState) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    tasks.o(i.eTaskGetState) refers to _printf_dec.o(.text) for _printf_int_dec
+    tasks.o(i.eTaskGetState) refers to _printf_str.o(.text) for _printf_str
+    tasks.o(i.eTaskGetState) refers to noretval__2printf.o(.text) for __2printf
+    tasks.o(i.eTaskGetState) refers to port.o(i.vPortEnterCritical) for vPortEnterCritical
+    tasks.o(i.eTaskGetState) refers to port.o(i.vPortExitCritical) for vPortExitCritical
+    tasks.o(i.eTaskGetState) refers to tasks.o(.data) for pxCurrentTCB
+    tasks.o(i.eTaskGetState) refers to tasks.o(.bss) for xSuspendedTaskList
+    tasks.o(i.pcTaskGetName) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    tasks.o(i.pcTaskGetName) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    tasks.o(i.pcTaskGetName) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    tasks.o(i.pcTaskGetName) refers to _printf_dec.o(.text) for _printf_int_dec
+    tasks.o(i.pcTaskGetName) refers to _printf_str.o(.text) for _printf_str
+    tasks.o(i.pcTaskGetName) refers to noretval__2printf.o(.text) for __2printf
+    tasks.o(i.pcTaskGetName) refers to tasks.o(.data) for pxCurrentTCB
+    tasks.o(i.prvAddCurrentTaskToDelayedList) refers to list.o(i.uxListRemove) for uxListRemove
+    tasks.o(i.prvAddCurrentTaskToDelayedList) refers to list.o(i.vListInsertEnd) for vListInsertEnd
+    tasks.o(i.prvAddCurrentTaskToDelayedList) refers to list.o(i.vListInsert) for vListInsert
+    tasks.o(i.prvAddCurrentTaskToDelayedList) refers to tasks.o(.data) for xTickCount
+    tasks.o(i.prvAddCurrentTaskToDelayedList) refers to tasks.o(.bss) for xSuspendedTaskList
+    tasks.o(i.prvAddNewTaskToReadyList) refers to port.o(i.vPortEnterCritical) for vPortEnterCritical
+    tasks.o(i.prvAddNewTaskToReadyList) refers to tasks.o(i.prvInitialiseTaskLists) for prvInitialiseTaskLists
+    tasks.o(i.prvAddNewTaskToReadyList) refers to list.o(i.vListInsertEnd) for vListInsertEnd
+    tasks.o(i.prvAddNewTaskToReadyList) refers to port.o(i.vPortExitCritical) for vPortExitCritical
+    tasks.o(i.prvAddNewTaskToReadyList) refers to tasks.o(.data) for uxCurrentNumberOfTasks
+    tasks.o(i.prvAddNewTaskToReadyList) refers to tasks.o(.bss) for pxReadyTasksLists
+    tasks.o(i.prvCheckTasksWaitingTermination) refers to tasks.o(i.vTaskSuspendAll) for vTaskSuspendAll
+    tasks.o(i.prvCheckTasksWaitingTermination) refers to tasks.o(i.xTaskResumeAll) for xTaskResumeAll
+    tasks.o(i.prvCheckTasksWaitingTermination) refers to port.o(i.vPortEnterCritical) for vPortEnterCritical
+    tasks.o(i.prvCheckTasksWaitingTermination) refers to list.o(i.uxListRemove) for uxListRemove
+    tasks.o(i.prvCheckTasksWaitingTermination) refers to port.o(i.vPortExitCritical) for vPortExitCritical
+    tasks.o(i.prvCheckTasksWaitingTermination) refers to tasks.o(i.prvDeleteTCB) for prvDeleteTCB
+    tasks.o(i.prvCheckTasksWaitingTermination) refers to tasks.o(.bss) for xTasksWaitingTermination
+    tasks.o(i.prvCheckTasksWaitingTermination) refers to tasks.o(.data) for uxCurrentNumberOfTasks
+    tasks.o(i.prvDeleteTCB) refers to heap_4.o(i.vPortFree) for vPortFree
+    tasks.o(i.prvIdleTask) refers to tasks.o(i.prvCheckTasksWaitingTermination) for prvCheckTasksWaitingTermination
+    tasks.o(i.prvIdleTask) refers to tasks.o(.bss) for pxReadyTasksLists
+    tasks.o(i.prvInitialiseNewTask) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    tasks.o(i.prvInitialiseNewTask) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    tasks.o(i.prvInitialiseNewTask) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    tasks.o(i.prvInitialiseNewTask) refers to _printf_dec.o(.text) for _printf_int_dec
+    tasks.o(i.prvInitialiseNewTask) refers to _printf_str.o(.text) for _printf_str
+    tasks.o(i.prvInitialiseNewTask) refers to aeabi_memset.o(.text) for __aeabi_memset
+    tasks.o(i.prvInitialiseNewTask) refers to noretval__2printf.o(.text) for __2printf
+    tasks.o(i.prvInitialiseNewTask) refers to list.o(i.vListInitialiseItem) for vListInitialiseItem
+    tasks.o(i.prvInitialiseNewTask) refers to port.o(i.pxPortInitialiseStack) for pxPortInitialiseStack
+    tasks.o(i.prvInitialiseTaskLists) refers to list.o(i.vListInitialise) for vListInitialise
+    tasks.o(i.prvInitialiseTaskLists) refers to tasks.o(.bss) for pxReadyTasksLists
+    tasks.o(i.prvInitialiseTaskLists) refers to tasks.o(.data) for pxDelayedTaskList
+    tasks.o(i.prvListTasksWithinSingleList) refers to tasks.o(i.vTaskGetInfo) for vTaskGetInfo
+    tasks.o(i.prvResetNextTaskUnblockTime) refers to tasks.o(.data) for pxDelayedTaskList
+    tasks.o(i.prvTaskIsTaskSuspended) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    tasks.o(i.prvTaskIsTaskSuspended) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    tasks.o(i.prvTaskIsTaskSuspended) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    tasks.o(i.prvTaskIsTaskSuspended) refers to _printf_dec.o(.text) for _printf_int_dec
+    tasks.o(i.prvTaskIsTaskSuspended) refers to _printf_str.o(.text) for _printf_str
+    tasks.o(i.prvTaskIsTaskSuspended) refers to noretval__2printf.o(.text) for __2printf
+    tasks.o(i.prvTaskIsTaskSuspended) refers to tasks.o(.bss) for xSuspendedTaskList
+    tasks.o(i.prvWriteNameToBuffer) refers to strcpy.o(.text) for strcpy
+    tasks.o(i.prvWriteNameToBuffer) refers to strlen.o(.text) for strlen
+    tasks.o(i.pvTaskIncrementMutexHeldCount) refers to tasks.o(.data) for pxCurrentTCB
+    tasks.o(i.ulTaskNotifyTake) refers to port.o(i.vPortEnterCritical) for vPortEnterCritical
+    tasks.o(i.ulTaskNotifyTake) refers to tasks.o(i.prvAddCurrentTaskToDelayedList) for prvAddCurrentTaskToDelayedList
+    tasks.o(i.ulTaskNotifyTake) refers to port.o(i.vPortExitCritical) for vPortExitCritical
+    tasks.o(i.ulTaskNotifyTake) refers to tasks.o(.data) for pxCurrentTCB
+    tasks.o(i.uxTaskGetNumberOfTasks) refers to tasks.o(.data) for uxCurrentNumberOfTasks
+    tasks.o(i.uxTaskGetSystemState) refers to tasks.o(i.vTaskSuspendAll) for vTaskSuspendAll
+    tasks.o(i.uxTaskGetSystemState) refers to tasks.o(i.prvListTasksWithinSingleList) for prvListTasksWithinSingleList
+    tasks.o(i.uxTaskGetSystemState) refers to tasks.o(i.xTaskResumeAll) for xTaskResumeAll
+    tasks.o(i.uxTaskGetSystemState) refers to tasks.o(.data) for uxCurrentNumberOfTasks
+    tasks.o(i.uxTaskGetSystemState) refers to tasks.o(.bss) for pxReadyTasksLists
+    tasks.o(i.uxTaskPriorityGet) refers to port.o(i.vPortEnterCritical) for vPortEnterCritical
+    tasks.o(i.uxTaskPriorityGet) refers to port.o(i.vPortExitCritical) for vPortExitCritical
+    tasks.o(i.uxTaskPriorityGet) refers to tasks.o(.data) for pxCurrentTCB
+    tasks.o(i.uxTaskPriorityGetFromISR) refers to port.o(i.vPortValidateInterruptPriority) for vPortValidateInterruptPriority
+    tasks.o(i.uxTaskPriorityGetFromISR) refers to tasks.o(.data) for pxCurrentTCB
+    tasks.o(i.uxTaskResetEventItemValue) refers to tasks.o(.data) for pxCurrentTCB
+    tasks.o(i.vTaskDelay) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    tasks.o(i.vTaskDelay) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    tasks.o(i.vTaskDelay) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    tasks.o(i.vTaskDelay) refers to _printf_dec.o(.text) for _printf_int_dec
+    tasks.o(i.vTaskDelay) refers to _printf_str.o(.text) for _printf_str
+    tasks.o(i.vTaskDelay) refers to noretval__2printf.o(.text) for __2printf
+    tasks.o(i.vTaskDelay) refers to tasks.o(i.vTaskSuspendAll) for vTaskSuspendAll
+    tasks.o(i.vTaskDelay) refers to tasks.o(i.prvAddCurrentTaskToDelayedList) for prvAddCurrentTaskToDelayedList
+    tasks.o(i.vTaskDelay) refers to tasks.o(i.xTaskResumeAll) for xTaskResumeAll
+    tasks.o(i.vTaskDelay) refers to tasks.o(.data) for uxSchedulerSuspended
+    tasks.o(i.vTaskDelayUntil) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    tasks.o(i.vTaskDelayUntil) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    tasks.o(i.vTaskDelayUntil) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    tasks.o(i.vTaskDelayUntil) refers to _printf_dec.o(.text) for _printf_int_dec
+    tasks.o(i.vTaskDelayUntil) refers to _printf_str.o(.text) for _printf_str
+    tasks.o(i.vTaskDelayUntil) refers to noretval__2printf.o(.text) for __2printf
+    tasks.o(i.vTaskDelayUntil) refers to tasks.o(i.vTaskSuspendAll) for vTaskSuspendAll
+    tasks.o(i.vTaskDelayUntil) refers to tasks.o(i.prvAddCurrentTaskToDelayedList) for prvAddCurrentTaskToDelayedList
+    tasks.o(i.vTaskDelayUntil) refers to tasks.o(i.xTaskResumeAll) for xTaskResumeAll
+    tasks.o(i.vTaskDelayUntil) refers to tasks.o(.data) for uxSchedulerSuspended
+    tasks.o(i.vTaskDelete) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    tasks.o(i.vTaskDelete) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    tasks.o(i.vTaskDelete) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    tasks.o(i.vTaskDelete) refers to _printf_dec.o(.text) for _printf_int_dec
+    tasks.o(i.vTaskDelete) refers to _printf_str.o(.text) for _printf_str
+    tasks.o(i.vTaskDelete) refers to port.o(i.vPortEnterCritical) for vPortEnterCritical
+    tasks.o(i.vTaskDelete) refers to list.o(i.uxListRemove) for uxListRemove
+    tasks.o(i.vTaskDelete) refers to list.o(i.vListInsertEnd) for vListInsertEnd
+    tasks.o(i.vTaskDelete) refers to tasks.o(i.prvDeleteTCB) for prvDeleteTCB
+    tasks.o(i.vTaskDelete) refers to tasks.o(i.prvResetNextTaskUnblockTime) for prvResetNextTaskUnblockTime
+    tasks.o(i.vTaskDelete) refers to port.o(i.vPortExitCritical) for vPortExitCritical
+    tasks.o(i.vTaskDelete) refers to noretval__2printf.o(.text) for __2printf
+    tasks.o(i.vTaskDelete) refers to tasks.o(.data) for pxCurrentTCB
+    tasks.o(i.vTaskDelete) refers to tasks.o(.bss) for pxReadyTasksLists
+    tasks.o(i.vTaskEndScheduler) refers to port.o(i.vPortEndScheduler) for vPortEndScheduler
+    tasks.o(i.vTaskEndScheduler) refers to tasks.o(.data) for xSchedulerRunning
+    tasks.o(i.vTaskGetInfo) refers to tasks.o(i.vTaskSuspendAll) for vTaskSuspendAll
+    tasks.o(i.vTaskGetInfo) refers to tasks.o(i.xTaskResumeAll) for xTaskResumeAll
+    tasks.o(i.vTaskGetInfo) refers to tasks.o(i.eTaskGetState) for eTaskGetState
+    tasks.o(i.vTaskGetInfo) refers to tasks.o(i.prvTaskCheckFreeStackSpace) for prvTaskCheckFreeStackSpace
+    tasks.o(i.vTaskGetInfo) refers to tasks.o(.data) for pxCurrentTCB
+    tasks.o(i.vTaskList) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    tasks.o(i.vTaskList) refers to _printf_u.o(.ARM.Collect$$_printf_percent$$0000000A) for _printf_u
+    tasks.o(i.vTaskList) refers to _printf_c.o(.ARM.Collect$$_printf_percent$$00000013) for _printf_c
+    tasks.o(i.vTaskList) refers to _printf_dec.o(.text) for _printf_int_dec
+    tasks.o(i.vTaskList) refers to _printf_str.o(.text) for _printf_str
+    tasks.o(i.vTaskList) refers to heap_4.o(i.pvPortMalloc) for pvPortMalloc
+    tasks.o(i.vTaskList) refers to tasks.o(i.uxTaskGetSystemState) for uxTaskGetSystemState
+    tasks.o(i.vTaskList) refers to tasks.o(i.prvWriteNameToBuffer) for prvWriteNameToBuffer
+    tasks.o(i.vTaskList) refers to noretval__2sprintf.o(.text) for __2sprintf
+    tasks.o(i.vTaskList) refers to strlen.o(.text) for strlen
+    tasks.o(i.vTaskList) refers to heap_4.o(i.vPortFree) for vPortFree
+    tasks.o(i.vTaskList) refers to tasks.o(.data) for uxCurrentNumberOfTasks
+    tasks.o(i.vTaskMissedYield) refers to tasks.o(.data) for xYieldPending
+    tasks.o(i.vTaskNotifyGiveFromISR) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    tasks.o(i.vTaskNotifyGiveFromISR) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    tasks.o(i.vTaskNotifyGiveFromISR) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    tasks.o(i.vTaskNotifyGiveFromISR) refers to _printf_dec.o(.text) for _printf_int_dec
+    tasks.o(i.vTaskNotifyGiveFromISR) refers to _printf_str.o(.text) for _printf_str
+    tasks.o(i.vTaskNotifyGiveFromISR) refers to noretval__2printf.o(.text) for __2printf
+    tasks.o(i.vTaskNotifyGiveFromISR) refers to port.o(i.vPortValidateInterruptPriority) for vPortValidateInterruptPriority
+    tasks.o(i.vTaskNotifyGiveFromISR) refers to list.o(i.uxListRemove) for uxListRemove
+    tasks.o(i.vTaskNotifyGiveFromISR) refers to list.o(i.vListInsertEnd) for vListInsertEnd
+    tasks.o(i.vTaskNotifyGiveFromISR) refers to tasks.o(.data) for uxSchedulerSuspended
+    tasks.o(i.vTaskNotifyGiveFromISR) refers to tasks.o(.bss) for pxReadyTasksLists
+    tasks.o(i.vTaskPlaceOnEventList) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    tasks.o(i.vTaskPlaceOnEventList) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    tasks.o(i.vTaskPlaceOnEventList) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    tasks.o(i.vTaskPlaceOnEventList) refers to _printf_dec.o(.text) for _printf_int_dec
+    tasks.o(i.vTaskPlaceOnEventList) refers to _printf_str.o(.text) for _printf_str
+    tasks.o(i.vTaskPlaceOnEventList) refers to noretval__2printf.o(.text) for __2printf
+    tasks.o(i.vTaskPlaceOnEventList) refers to list.o(i.vListInsert) for vListInsert
+    tasks.o(i.vTaskPlaceOnEventList) refers to tasks.o(i.prvAddCurrentTaskToDelayedList) for prvAddCurrentTaskToDelayedList
+    tasks.o(i.vTaskPlaceOnEventList) refers to tasks.o(.data) for pxCurrentTCB
+    tasks.o(i.vTaskPlaceOnEventListRestricted) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    tasks.o(i.vTaskPlaceOnEventListRestricted) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    tasks.o(i.vTaskPlaceOnEventListRestricted) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    tasks.o(i.vTaskPlaceOnEventListRestricted) refers to _printf_dec.o(.text) for _printf_int_dec
+    tasks.o(i.vTaskPlaceOnEventListRestricted) refers to _printf_str.o(.text) for _printf_str
+    tasks.o(i.vTaskPlaceOnEventListRestricted) refers to noretval__2printf.o(.text) for __2printf
+    tasks.o(i.vTaskPlaceOnEventListRestricted) refers to list.o(i.vListInsertEnd) for vListInsertEnd
+    tasks.o(i.vTaskPlaceOnEventListRestricted) refers to tasks.o(i.prvAddCurrentTaskToDelayedList) for prvAddCurrentTaskToDelayedList
+    tasks.o(i.vTaskPlaceOnEventListRestricted) refers to tasks.o(.data) for pxCurrentTCB
+    tasks.o(i.vTaskPlaceOnUnorderedEventList) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    tasks.o(i.vTaskPlaceOnUnorderedEventList) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    tasks.o(i.vTaskPlaceOnUnorderedEventList) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    tasks.o(i.vTaskPlaceOnUnorderedEventList) refers to _printf_dec.o(.text) for _printf_int_dec
+    tasks.o(i.vTaskPlaceOnUnorderedEventList) refers to _printf_str.o(.text) for _printf_str
+    tasks.o(i.vTaskPlaceOnUnorderedEventList) refers to noretval__2printf.o(.text) for __2printf
+    tasks.o(i.vTaskPlaceOnUnorderedEventList) refers to list.o(i.vListInsertEnd) for vListInsertEnd
+    tasks.o(i.vTaskPlaceOnUnorderedEventList) refers to tasks.o(i.prvAddCurrentTaskToDelayedList) for prvAddCurrentTaskToDelayedList
+    tasks.o(i.vTaskPlaceOnUnorderedEventList) refers to tasks.o(.data) for uxSchedulerSuspended
+    tasks.o(i.vTaskPriorityInherit) refers to list.o(i.uxListRemove) for uxListRemove
+    tasks.o(i.vTaskPriorityInherit) refers to list.o(i.vListInsertEnd) for vListInsertEnd
+    tasks.o(i.vTaskPriorityInherit) refers to tasks.o(.data) for pxCurrentTCB
+    tasks.o(i.vTaskPriorityInherit) refers to tasks.o(.bss) for pxReadyTasksLists
+    tasks.o(i.vTaskPrioritySet) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    tasks.o(i.vTaskPrioritySet) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    tasks.o(i.vTaskPrioritySet) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    tasks.o(i.vTaskPrioritySet) refers to _printf_dec.o(.text) for _printf_int_dec
+    tasks.o(i.vTaskPrioritySet) refers to _printf_str.o(.text) for _printf_str
+    tasks.o(i.vTaskPrioritySet) refers to noretval__2printf.o(.text) for __2printf
+    tasks.o(i.vTaskPrioritySet) refers to port.o(i.vPortEnterCritical) for vPortEnterCritical
+    tasks.o(i.vTaskPrioritySet) refers to list.o(i.uxListRemove) for uxListRemove
+    tasks.o(i.vTaskPrioritySet) refers to list.o(i.vListInsertEnd) for vListInsertEnd
+    tasks.o(i.vTaskPrioritySet) refers to port.o(i.vPortExitCritical) for vPortExitCritical
+    tasks.o(i.vTaskPrioritySet) refers to tasks.o(.data) for pxCurrentTCB
+    tasks.o(i.vTaskPrioritySet) refers to tasks.o(.bss) for pxReadyTasksLists
+    tasks.o(i.vTaskResume) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    tasks.o(i.vTaskResume) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    tasks.o(i.vTaskResume) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    tasks.o(i.vTaskResume) refers to _printf_dec.o(.text) for _printf_int_dec
+    tasks.o(i.vTaskResume) refers to _printf_str.o(.text) for _printf_str
+    tasks.o(i.vTaskResume) refers to noretval__2printf.o(.text) for __2printf
+    tasks.o(i.vTaskResume) refers to port.o(i.vPortEnterCritical) for vPortEnterCritical
+    tasks.o(i.vTaskResume) refers to tasks.o(i.prvTaskIsTaskSuspended) for prvTaskIsTaskSuspended
+    tasks.o(i.vTaskResume) refers to list.o(i.uxListRemove) for uxListRemove
+    tasks.o(i.vTaskResume) refers to list.o(i.vListInsertEnd) for vListInsertEnd
+    tasks.o(i.vTaskResume) refers to port.o(i.vPortExitCritical) for vPortExitCritical
+    tasks.o(i.vTaskResume) refers to tasks.o(.data) for pxCurrentTCB
+    tasks.o(i.vTaskResume) refers to tasks.o(.bss) for pxReadyTasksLists
+    tasks.o(i.vTaskSetTimeOutState) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    tasks.o(i.vTaskSetTimeOutState) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    tasks.o(i.vTaskSetTimeOutState) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    tasks.o(i.vTaskSetTimeOutState) refers to _printf_dec.o(.text) for _printf_int_dec
+    tasks.o(i.vTaskSetTimeOutState) refers to _printf_str.o(.text) for _printf_str
+    tasks.o(i.vTaskSetTimeOutState) refers to noretval__2printf.o(.text) for __2printf
+    tasks.o(i.vTaskSetTimeOutState) refers to tasks.o(.data) for xNumOfOverflows
+    tasks.o(i.vTaskStartScheduler) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    tasks.o(i.vTaskStartScheduler) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    tasks.o(i.vTaskStartScheduler) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    tasks.o(i.vTaskStartScheduler) refers to _printf_dec.o(.text) for _printf_int_dec
+    tasks.o(i.vTaskStartScheduler) refers to _printf_str.o(.text) for _printf_str
+    tasks.o(i.vTaskStartScheduler) refers to tasks.o(i.xTaskCreate) for xTaskCreate
+    tasks.o(i.vTaskStartScheduler) refers to timers.o(i.xTimerCreateTimerTask) for xTimerCreateTimerTask
+    tasks.o(i.vTaskStartScheduler) refers to port.o(i.xPortStartScheduler) for xPortStartScheduler
+    tasks.o(i.vTaskStartScheduler) refers to noretval__2printf.o(.text) for __2printf
+    tasks.o(i.vTaskStartScheduler) refers to tasks.o(.data) for xIdleTaskHandle
+    tasks.o(i.vTaskStartScheduler) refers to tasks.o(i.prvIdleTask) for prvIdleTask
+    tasks.o(i.vTaskSuspend) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    tasks.o(i.vTaskSuspend) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    tasks.o(i.vTaskSuspend) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    tasks.o(i.vTaskSuspend) refers to _printf_dec.o(.text) for _printf_int_dec
+    tasks.o(i.vTaskSuspend) refers to _printf_str.o(.text) for _printf_str
+    tasks.o(i.vTaskSuspend) refers to port.o(i.vPortEnterCritical) for vPortEnterCritical
+    tasks.o(i.vTaskSuspend) refers to list.o(i.uxListRemove) for uxListRemove
+    tasks.o(i.vTaskSuspend) refers to list.o(i.vListInsertEnd) for vListInsertEnd
+    tasks.o(i.vTaskSuspend) refers to port.o(i.vPortExitCritical) for vPortExitCritical
+    tasks.o(i.vTaskSuspend) refers to tasks.o(i.prvResetNextTaskUnblockTime) for prvResetNextTaskUnblockTime
+    tasks.o(i.vTaskSuspend) refers to noretval__2printf.o(.text) for __2printf
+    tasks.o(i.vTaskSuspend) refers to tasks.o(i.vTaskSwitchContext) for vTaskSwitchContext
+    tasks.o(i.vTaskSuspend) refers to tasks.o(.data) for pxCurrentTCB
+    tasks.o(i.vTaskSuspend) refers to tasks.o(.bss) for pxReadyTasksLists
+    tasks.o(i.vTaskSuspendAll) refers to tasks.o(.data) for uxSchedulerSuspended
+    tasks.o(i.vTaskSwitchContext) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    tasks.o(i.vTaskSwitchContext) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    tasks.o(i.vTaskSwitchContext) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    tasks.o(i.vTaskSwitchContext) refers to _printf_dec.o(.text) for _printf_int_dec
+    tasks.o(i.vTaskSwitchContext) refers to _printf_str.o(.text) for _printf_str
+    tasks.o(i.vTaskSwitchContext) refers to noretval__2printf.o(.text) for __2printf
+    tasks.o(i.vTaskSwitchContext) refers to tasks.o(.data) for uxSchedulerSuspended
+    tasks.o(i.vTaskSwitchContext) refers to tasks.o(.bss) for pxReadyTasksLists
+    tasks.o(i.xTaskCheckForTimeOut) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    tasks.o(i.xTaskCheckForTimeOut) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    tasks.o(i.xTaskCheckForTimeOut) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    tasks.o(i.xTaskCheckForTimeOut) refers to _printf_dec.o(.text) for _printf_int_dec
+    tasks.o(i.xTaskCheckForTimeOut) refers to _printf_str.o(.text) for _printf_str
+    tasks.o(i.xTaskCheckForTimeOut) refers to noretval__2printf.o(.text) for __2printf
+    tasks.o(i.xTaskCheckForTimeOut) refers to port.o(i.vPortEnterCritical) for vPortEnterCritical
+    tasks.o(i.xTaskCheckForTimeOut) refers to tasks.o(i.vTaskSetTimeOutState) for vTaskSetTimeOutState
+    tasks.o(i.xTaskCheckForTimeOut) refers to port.o(i.vPortExitCritical) for vPortExitCritical
+    tasks.o(i.xTaskCheckForTimeOut) refers to tasks.o(.data) for xTickCount
+    tasks.o(i.xTaskCreate) refers to heap_4.o(i.pvPortMalloc) for pvPortMalloc
+    tasks.o(i.xTaskCreate) refers to heap_4.o(i.vPortFree) for vPortFree
+    tasks.o(i.xTaskCreate) refers to tasks.o(i.prvInitialiseNewTask) for prvInitialiseNewTask
+    tasks.o(i.xTaskCreate) refers to tasks.o(i.prvAddNewTaskToReadyList) for prvAddNewTaskToReadyList
+    tasks.o(i.xTaskGenericNotify) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    tasks.o(i.xTaskGenericNotify) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    tasks.o(i.xTaskGenericNotify) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    tasks.o(i.xTaskGenericNotify) refers to _printf_dec.o(.text) for _printf_int_dec
+    tasks.o(i.xTaskGenericNotify) refers to _printf_str.o(.text) for _printf_str
+    tasks.o(i.xTaskGenericNotify) refers to noretval__2printf.o(.text) for __2printf
+    tasks.o(i.xTaskGenericNotify) refers to port.o(i.vPortEnterCritical) for vPortEnterCritical
+    tasks.o(i.xTaskGenericNotify) refers to list.o(i.uxListRemove) for uxListRemove
+    tasks.o(i.xTaskGenericNotify) refers to list.o(i.vListInsertEnd) for vListInsertEnd
+    tasks.o(i.xTaskGenericNotify) refers to port.o(i.vPortExitCritical) for vPortExitCritical
+    tasks.o(i.xTaskGenericNotify) refers to tasks.o(.data) for uxTopReadyPriority
+    tasks.o(i.xTaskGenericNotify) refers to tasks.o(.bss) for pxReadyTasksLists
+    tasks.o(i.xTaskGenericNotifyFromISR) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    tasks.o(i.xTaskGenericNotifyFromISR) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    tasks.o(i.xTaskGenericNotifyFromISR) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    tasks.o(i.xTaskGenericNotifyFromISR) refers to _printf_dec.o(.text) for _printf_int_dec
+    tasks.o(i.xTaskGenericNotifyFromISR) refers to _printf_str.o(.text) for _printf_str
+    tasks.o(i.xTaskGenericNotifyFromISR) refers to noretval__2printf.o(.text) for __2printf
+    tasks.o(i.xTaskGenericNotifyFromISR) refers to port.o(i.vPortValidateInterruptPriority) for vPortValidateInterruptPriority
+    tasks.o(i.xTaskGenericNotifyFromISR) refers to list.o(i.uxListRemove) for uxListRemove
+    tasks.o(i.xTaskGenericNotifyFromISR) refers to list.o(i.vListInsertEnd) for vListInsertEnd
+    tasks.o(i.xTaskGenericNotifyFromISR) refers to tasks.o(.data) for uxSchedulerSuspended
+    tasks.o(i.xTaskGenericNotifyFromISR) refers to tasks.o(.bss) for pxReadyTasksLists
+    tasks.o(i.xTaskGetCurrentTaskHandle) refers to tasks.o(.data) for pxCurrentTCB
+    tasks.o(i.xTaskGetSchedulerState) refers to tasks.o(.data) for xSchedulerRunning
+    tasks.o(i.xTaskGetTickCount) refers to tasks.o(.data) for xTickCount
+    tasks.o(i.xTaskGetTickCountFromISR) refers to port.o(i.vPortValidateInterruptPriority) for vPortValidateInterruptPriority
+    tasks.o(i.xTaskGetTickCountFromISR) refers to tasks.o(.data) for xTickCount
+    tasks.o(i.xTaskIncrementTick) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    tasks.o(i.xTaskIncrementTick) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    tasks.o(i.xTaskIncrementTick) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    tasks.o(i.xTaskIncrementTick) refers to _printf_dec.o(.text) for _printf_int_dec
+    tasks.o(i.xTaskIncrementTick) refers to _printf_str.o(.text) for _printf_str
+    tasks.o(i.xTaskIncrementTick) refers to noretval__2printf.o(.text) for __2printf
+    tasks.o(i.xTaskIncrementTick) refers to tasks.o(i.prvResetNextTaskUnblockTime) for prvResetNextTaskUnblockTime
+    tasks.o(i.xTaskIncrementTick) refers to list.o(i.uxListRemove) for uxListRemove
+    tasks.o(i.xTaskIncrementTick) refers to list.o(i.vListInsertEnd) for vListInsertEnd
+    tasks.o(i.xTaskIncrementTick) refers to tasks.o(.data) for uxSchedulerSuspended
+    tasks.o(i.xTaskIncrementTick) refers to tasks.o(.bss) for pxReadyTasksLists
+    tasks.o(i.xTaskNotifyStateClear) refers to port.o(i.vPortEnterCritical) for vPortEnterCritical
+    tasks.o(i.xTaskNotifyStateClear) refers to port.o(i.vPortExitCritical) for vPortExitCritical
+    tasks.o(i.xTaskNotifyStateClear) refers to tasks.o(.data) for pxCurrentTCB
+    tasks.o(i.xTaskNotifyWait) refers to port.o(i.vPortEnterCritical) for vPortEnterCritical
+    tasks.o(i.xTaskNotifyWait) refers to tasks.o(i.prvAddCurrentTaskToDelayedList) for prvAddCurrentTaskToDelayedList
+    tasks.o(i.xTaskNotifyWait) refers to port.o(i.vPortExitCritical) for vPortExitCritical
+    tasks.o(i.xTaskNotifyWait) refers to tasks.o(.data) for pxCurrentTCB
+    tasks.o(i.xTaskPriorityDisinherit) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    tasks.o(i.xTaskPriorityDisinherit) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    tasks.o(i.xTaskPriorityDisinherit) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    tasks.o(i.xTaskPriorityDisinherit) refers to _printf_dec.o(.text) for _printf_int_dec
+    tasks.o(i.xTaskPriorityDisinherit) refers to _printf_str.o(.text) for _printf_str
+    tasks.o(i.xTaskPriorityDisinherit) refers to noretval__2printf.o(.text) for __2printf
+    tasks.o(i.xTaskPriorityDisinherit) refers to list.o(i.uxListRemove) for uxListRemove
+    tasks.o(i.xTaskPriorityDisinherit) refers to list.o(i.vListInsertEnd) for vListInsertEnd
+    tasks.o(i.xTaskPriorityDisinherit) refers to tasks.o(.data) for pxCurrentTCB
+    tasks.o(i.xTaskPriorityDisinherit) refers to tasks.o(.bss) for pxReadyTasksLists
+    tasks.o(i.xTaskRemoveFromEventList) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    tasks.o(i.xTaskRemoveFromEventList) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    tasks.o(i.xTaskRemoveFromEventList) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    tasks.o(i.xTaskRemoveFromEventList) refers to _printf_dec.o(.text) for _printf_int_dec
+    tasks.o(i.xTaskRemoveFromEventList) refers to _printf_str.o(.text) for _printf_str
+    tasks.o(i.xTaskRemoveFromEventList) refers to noretval__2printf.o(.text) for __2printf
+    tasks.o(i.xTaskRemoveFromEventList) refers to list.o(i.uxListRemove) for uxListRemove
+    tasks.o(i.xTaskRemoveFromEventList) refers to list.o(i.vListInsertEnd) for vListInsertEnd
+    tasks.o(i.xTaskRemoveFromEventList) refers to tasks.o(.data) for uxSchedulerSuspended
+    tasks.o(i.xTaskRemoveFromEventList) refers to tasks.o(.bss) for pxReadyTasksLists
+    tasks.o(i.xTaskRemoveFromUnorderedEventList) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    tasks.o(i.xTaskRemoveFromUnorderedEventList) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    tasks.o(i.xTaskRemoveFromUnorderedEventList) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    tasks.o(i.xTaskRemoveFromUnorderedEventList) refers to _printf_dec.o(.text) for _printf_int_dec
+    tasks.o(i.xTaskRemoveFromUnorderedEventList) refers to _printf_str.o(.text) for _printf_str
+    tasks.o(i.xTaskRemoveFromUnorderedEventList) refers to noretval__2printf.o(.text) for __2printf
+    tasks.o(i.xTaskRemoveFromUnorderedEventList) refers to list.o(i.uxListRemove) for uxListRemove
+    tasks.o(i.xTaskRemoveFromUnorderedEventList) refers to list.o(i.vListInsertEnd) for vListInsertEnd
+    tasks.o(i.xTaskRemoveFromUnorderedEventList) refers to tasks.o(.data) for uxSchedulerSuspended
+    tasks.o(i.xTaskRemoveFromUnorderedEventList) refers to tasks.o(.bss) for pxReadyTasksLists
+    tasks.o(i.xTaskResumeAll) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    tasks.o(i.xTaskResumeAll) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    tasks.o(i.xTaskResumeAll) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    tasks.o(i.xTaskResumeAll) refers to _printf_dec.o(.text) for _printf_int_dec
+    tasks.o(i.xTaskResumeAll) refers to _printf_str.o(.text) for _printf_str
+    tasks.o(i.xTaskResumeAll) refers to noretval__2printf.o(.text) for __2printf
+    tasks.o(i.xTaskResumeAll) refers to port.o(i.vPortEnterCritical) for vPortEnterCritical
+    tasks.o(i.xTaskResumeAll) refers to list.o(i.uxListRemove) for uxListRemove
+    tasks.o(i.xTaskResumeAll) refers to list.o(i.vListInsertEnd) for vListInsertEnd
+    tasks.o(i.xTaskResumeAll) refers to tasks.o(i.prvResetNextTaskUnblockTime) for prvResetNextTaskUnblockTime
+    tasks.o(i.xTaskResumeAll) refers to tasks.o(i.xTaskIncrementTick) for xTaskIncrementTick
+    tasks.o(i.xTaskResumeAll) refers to port.o(i.vPortExitCritical) for vPortExitCritical
+    tasks.o(i.xTaskResumeAll) refers to tasks.o(.data) for uxSchedulerSuspended
+    tasks.o(i.xTaskResumeAll) refers to tasks.o(.bss) for xPendingReadyList
+    tasks.o(i.xTaskResumeFromISR) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    tasks.o(i.xTaskResumeFromISR) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    tasks.o(i.xTaskResumeFromISR) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    tasks.o(i.xTaskResumeFromISR) refers to _printf_dec.o(.text) for _printf_int_dec
+    tasks.o(i.xTaskResumeFromISR) refers to _printf_str.o(.text) for _printf_str
+    tasks.o(i.xTaskResumeFromISR) refers to noretval__2printf.o(.text) for __2printf
+    tasks.o(i.xTaskResumeFromISR) refers to port.o(i.vPortValidateInterruptPriority) for vPortValidateInterruptPriority
+    tasks.o(i.xTaskResumeFromISR) refers to tasks.o(i.prvTaskIsTaskSuspended) for prvTaskIsTaskSuspended
+    tasks.o(i.xTaskResumeFromISR) refers to list.o(i.uxListRemove) for uxListRemove
+    tasks.o(i.xTaskResumeFromISR) refers to list.o(i.vListInsertEnd) for vListInsertEnd
+    tasks.o(i.xTaskResumeFromISR) refers to tasks.o(.data) for uxSchedulerSuspended
+    tasks.o(i.xTaskResumeFromISR) refers to tasks.o(.bss) for pxReadyTasksLists
+    timers.o(i.pcTimerGetName) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    timers.o(i.pcTimerGetName) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    timers.o(i.pcTimerGetName) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    timers.o(i.pcTimerGetName) refers to _printf_dec.o(.text) for _printf_int_dec
+    timers.o(i.pcTimerGetName) refers to _printf_str.o(.text) for _printf_str
+    timers.o(i.pcTimerGetName) refers to noretval__2printf.o(.text) for __2printf
+    timers.o(i.prvCheckForValidListAndQueue) refers to port.o(i.vPortEnterCritical) for vPortEnterCritical
+    timers.o(i.prvCheckForValidListAndQueue) refers to list.o(i.vListInitialise) for vListInitialise
+    timers.o(i.prvCheckForValidListAndQueue) refers to queue.o(i.xQueueGenericCreate) for xQueueGenericCreate
+    timers.o(i.prvCheckForValidListAndQueue) refers to queue.o(i.vQueueAddToRegistry) for vQueueAddToRegistry
+    timers.o(i.prvCheckForValidListAndQueue) refers to port.o(i.vPortExitCritical) for vPortExitCritical
+    timers.o(i.prvCheckForValidListAndQueue) refers to timers.o(.data) for xTimerQueue
+    timers.o(i.prvCheckForValidListAndQueue) refers to timers.o(.bss) for xActiveTimerList1
+    timers.o(i.prvGetNextExpireTime) refers to timers.o(.data) for pxCurrentTimerList
+    timers.o(i.prvInitialiseNewTimer) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    timers.o(i.prvInitialiseNewTimer) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    timers.o(i.prvInitialiseNewTimer) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    timers.o(i.prvInitialiseNewTimer) refers to _printf_dec.o(.text) for _printf_int_dec
+    timers.o(i.prvInitialiseNewTimer) refers to _printf_str.o(.text) for _printf_str
+    timers.o(i.prvInitialiseNewTimer) refers to noretval__2printf.o(.text) for __2printf
+    timers.o(i.prvInitialiseNewTimer) refers to timers.o(i.prvCheckForValidListAndQueue) for prvCheckForValidListAndQueue
+    timers.o(i.prvInitialiseNewTimer) refers to list.o(i.vListInitialiseItem) for vListInitialiseItem
+    timers.o(i.prvInsertTimerInActiveList) refers to list.o(i.vListInsert) for vListInsert
+    timers.o(i.prvInsertTimerInActiveList) refers to timers.o(.data) for pxOverflowTimerList
+    timers.o(i.prvProcessExpiredTimer) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    timers.o(i.prvProcessExpiredTimer) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    timers.o(i.prvProcessExpiredTimer) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    timers.o(i.prvProcessExpiredTimer) refers to _printf_dec.o(.text) for _printf_int_dec
+    timers.o(i.prvProcessExpiredTimer) refers to _printf_str.o(.text) for _printf_str
+    timers.o(i.prvProcessExpiredTimer) refers to list.o(i.uxListRemove) for uxListRemove
+    timers.o(i.prvProcessExpiredTimer) refers to timers.o(i.prvInsertTimerInActiveList) for prvInsertTimerInActiveList
+    timers.o(i.prvProcessExpiredTimer) refers to timers.o(i.xTimerGenericCommand) for xTimerGenericCommand
+    timers.o(i.prvProcessExpiredTimer) refers to noretval__2printf.o(.text) for __2printf
+    timers.o(i.prvProcessExpiredTimer) refers to timers.o(.data) for pxCurrentTimerList
+    timers.o(i.prvProcessReceivedCommands) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    timers.o(i.prvProcessReceivedCommands) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    timers.o(i.prvProcessReceivedCommands) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    timers.o(i.prvProcessReceivedCommands) refers to _printf_dec.o(.text) for _printf_int_dec
+    timers.o(i.prvProcessReceivedCommands) refers to _printf_str.o(.text) for _printf_str
+    timers.o(i.prvProcessReceivedCommands) refers to noretval__2printf.o(.text) for __2printf
+    timers.o(i.prvProcessReceivedCommands) refers to list.o(i.uxListRemove) for uxListRemove
+    timers.o(i.prvProcessReceivedCommands) refers to timers.o(i.prvSampleTimeNow) for prvSampleTimeNow
+    timers.o(i.prvProcessReceivedCommands) refers to timers.o(i.prvInsertTimerInActiveList) for prvInsertTimerInActiveList
+    timers.o(i.prvProcessReceivedCommands) refers to timers.o(i.xTimerGenericCommand) for xTimerGenericCommand
+    timers.o(i.prvProcessReceivedCommands) refers to heap_4.o(i.vPortFree) for vPortFree
+    timers.o(i.prvProcessReceivedCommands) refers to queue.o(i.xQueueGenericReceive) for xQueueGenericReceive
+    timers.o(i.prvProcessReceivedCommands) refers to timers.o(.data) for xTimerQueue
+    timers.o(i.prvProcessTimerOrBlockTask) refers to tasks.o(i.vTaskSuspendAll) for vTaskSuspendAll
+    timers.o(i.prvProcessTimerOrBlockTask) refers to timers.o(i.prvSampleTimeNow) for prvSampleTimeNow
+    timers.o(i.prvProcessTimerOrBlockTask) refers to tasks.o(i.xTaskResumeAll) for xTaskResumeAll
+    timers.o(i.prvProcessTimerOrBlockTask) refers to timers.o(i.prvProcessExpiredTimer) for prvProcessExpiredTimer
+    timers.o(i.prvProcessTimerOrBlockTask) refers to queue.o(i.vQueueWaitForMessageRestricted) for vQueueWaitForMessageRestricted
+    timers.o(i.prvProcessTimerOrBlockTask) refers to timers.o(.data) for pxOverflowTimerList
+    timers.o(i.prvSampleTimeNow) refers to tasks.o(i.xTaskGetTickCount) for xTaskGetTickCount
+    timers.o(i.prvSampleTimeNow) refers to timers.o(i.prvSwitchTimerLists) for prvSwitchTimerLists
+    timers.o(i.prvSampleTimeNow) refers to timers.o(.data) for xLastTime
+    timers.o(i.prvSwitchTimerLists) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    timers.o(i.prvSwitchTimerLists) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    timers.o(i.prvSwitchTimerLists) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    timers.o(i.prvSwitchTimerLists) refers to _printf_dec.o(.text) for _printf_int_dec
+    timers.o(i.prvSwitchTimerLists) refers to _printf_str.o(.text) for _printf_str
+    timers.o(i.prvSwitchTimerLists) refers to list.o(i.uxListRemove) for uxListRemove
+    timers.o(i.prvSwitchTimerLists) refers to list.o(i.vListInsert) for vListInsert
+    timers.o(i.prvSwitchTimerLists) refers to timers.o(i.xTimerGenericCommand) for xTimerGenericCommand
+    timers.o(i.prvSwitchTimerLists) refers to noretval__2printf.o(.text) for __2printf
+    timers.o(i.prvSwitchTimerLists) refers to timers.o(.data) for pxCurrentTimerList
+    timers.o(i.prvTimerTask) refers to timers.o(i.prvGetNextExpireTime) for prvGetNextExpireTime
+    timers.o(i.prvTimerTask) refers to timers.o(i.prvProcessTimerOrBlockTask) for prvProcessTimerOrBlockTask
+    timers.o(i.prvTimerTask) refers to timers.o(i.prvProcessReceivedCommands) for prvProcessReceivedCommands
+    timers.o(i.pvTimerGetTimerID) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    timers.o(i.pvTimerGetTimerID) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    timers.o(i.pvTimerGetTimerID) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    timers.o(i.pvTimerGetTimerID) refers to _printf_dec.o(.text) for _printf_int_dec
+    timers.o(i.pvTimerGetTimerID) refers to _printf_str.o(.text) for _printf_str
+    timers.o(i.pvTimerGetTimerID) refers to noretval__2printf.o(.text) for __2printf
+    timers.o(i.pvTimerGetTimerID) refers to port.o(i.vPortEnterCritical) for vPortEnterCritical
+    timers.o(i.pvTimerGetTimerID) refers to port.o(i.vPortExitCritical) for vPortExitCritical
+    timers.o(i.vTimerSetTimerID) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    timers.o(i.vTimerSetTimerID) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    timers.o(i.vTimerSetTimerID) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    timers.o(i.vTimerSetTimerID) refers to _printf_dec.o(.text) for _printf_int_dec
+    timers.o(i.vTimerSetTimerID) refers to _printf_str.o(.text) for _printf_str
+    timers.o(i.vTimerSetTimerID) refers to noretval__2printf.o(.text) for __2printf
+    timers.o(i.vTimerSetTimerID) refers to port.o(i.vPortEnterCritical) for vPortEnterCritical
+    timers.o(i.vTimerSetTimerID) refers to port.o(i.vPortExitCritical) for vPortExitCritical
+    timers.o(i.xTimerCreate) refers to heap_4.o(i.pvPortMalloc) for pvPortMalloc
+    timers.o(i.xTimerCreate) refers to timers.o(i.prvInitialiseNewTimer) for prvInitialiseNewTimer
+    timers.o(i.xTimerCreateTimerTask) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    timers.o(i.xTimerCreateTimerTask) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    timers.o(i.xTimerCreateTimerTask) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    timers.o(i.xTimerCreateTimerTask) refers to _printf_dec.o(.text) for _printf_int_dec
+    timers.o(i.xTimerCreateTimerTask) refers to _printf_str.o(.text) for _printf_str
+    timers.o(i.xTimerCreateTimerTask) refers to timers.o(i.prvCheckForValidListAndQueue) for prvCheckForValidListAndQueue
+    timers.o(i.xTimerCreateTimerTask) refers to tasks.o(i.xTaskCreate) for xTaskCreate
+    timers.o(i.xTimerCreateTimerTask) refers to noretval__2printf.o(.text) for __2printf
+    timers.o(i.xTimerCreateTimerTask) refers to timers.o(.data) for xTimerQueue
+    timers.o(i.xTimerCreateTimerTask) refers to timers.o(i.prvTimerTask) for prvTimerTask
+    timers.o(i.xTimerGenericCommand) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    timers.o(i.xTimerGenericCommand) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    timers.o(i.xTimerGenericCommand) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    timers.o(i.xTimerGenericCommand) refers to _printf_dec.o(.text) for _printf_int_dec
+    timers.o(i.xTimerGenericCommand) refers to _printf_str.o(.text) for _printf_str
+    timers.o(i.xTimerGenericCommand) refers to noretval__2printf.o(.text) for __2printf
+    timers.o(i.xTimerGenericCommand) refers to tasks.o(i.xTaskGetSchedulerState) for xTaskGetSchedulerState
+    timers.o(i.xTimerGenericCommand) refers to queue.o(i.xQueueGenericSend) for xQueueGenericSend
+    timers.o(i.xTimerGenericCommand) refers to queue.o(i.xQueueGenericSendFromISR) for xQueueGenericSendFromISR
+    timers.o(i.xTimerGenericCommand) refers to timers.o(.data) for xTimerQueue
+    timers.o(i.xTimerGetExpiryTime) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    timers.o(i.xTimerGetExpiryTime) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    timers.o(i.xTimerGetExpiryTime) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    timers.o(i.xTimerGetExpiryTime) refers to _printf_dec.o(.text) for _printf_int_dec
+    timers.o(i.xTimerGetExpiryTime) refers to _printf_str.o(.text) for _printf_str
+    timers.o(i.xTimerGetExpiryTime) refers to noretval__2printf.o(.text) for __2printf
+    timers.o(i.xTimerGetPeriod) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    timers.o(i.xTimerGetPeriod) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    timers.o(i.xTimerGetPeriod) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    timers.o(i.xTimerGetPeriod) refers to _printf_dec.o(.text) for _printf_int_dec
+    timers.o(i.xTimerGetPeriod) refers to _printf_str.o(.text) for _printf_str
+    timers.o(i.xTimerGetPeriod) refers to noretval__2printf.o(.text) for __2printf
+    timers.o(i.xTimerGetTimerDaemonTaskHandle) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    timers.o(i.xTimerGetTimerDaemonTaskHandle) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    timers.o(i.xTimerGetTimerDaemonTaskHandle) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    timers.o(i.xTimerGetTimerDaemonTaskHandle) refers to _printf_dec.o(.text) for _printf_int_dec
+    timers.o(i.xTimerGetTimerDaemonTaskHandle) refers to _printf_str.o(.text) for _printf_str
+    timers.o(i.xTimerGetTimerDaemonTaskHandle) refers to noretval__2printf.o(.text) for __2printf
+    timers.o(i.xTimerGetTimerDaemonTaskHandle) refers to timers.o(.data) for xTimerTaskHandle
+    timers.o(i.xTimerIsTimerActive) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    timers.o(i.xTimerIsTimerActive) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    timers.o(i.xTimerIsTimerActive) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    timers.o(i.xTimerIsTimerActive) refers to _printf_dec.o(.text) for _printf_int_dec
+    timers.o(i.xTimerIsTimerActive) refers to _printf_str.o(.text) for _printf_str
+    timers.o(i.xTimerIsTimerActive) refers to noretval__2printf.o(.text) for __2printf
+    timers.o(i.xTimerIsTimerActive) refers to port.o(i.vPortEnterCritical) for vPortEnterCritical
+    timers.o(i.xTimerIsTimerActive) refers to port.o(i.vPortExitCritical) for vPortExitCritical
+    timers.o(i.xTimerPendFunctionCall) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    timers.o(i.xTimerPendFunctionCall) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    timers.o(i.xTimerPendFunctionCall) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    timers.o(i.xTimerPendFunctionCall) refers to _printf_dec.o(.text) for _printf_int_dec
+    timers.o(i.xTimerPendFunctionCall) refers to _printf_str.o(.text) for _printf_str
+    timers.o(i.xTimerPendFunctionCall) refers to noretval__2printf.o(.text) for __2printf
+    timers.o(i.xTimerPendFunctionCall) refers to queue.o(i.xQueueGenericSend) for xQueueGenericSend
+    timers.o(i.xTimerPendFunctionCall) refers to timers.o(.data) for xTimerQueue
+    timers.o(i.xTimerPendFunctionCallFromISR) refers to queue.o(i.xQueueGenericSendFromISR) for xQueueGenericSendFromISR
+    timers.o(i.xTimerPendFunctionCallFromISR) refers to timers.o(.data) for xTimerQueue
+    port.o(.emb_text) refers to tasks.o(i.vTaskSwitchContext) for vTaskSwitchContext
+    port.o(.emb_text) refers to tasks.o(.data) for pxCurrentTCB
+    port.o(i.prvTaskExitError) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    port.o(i.prvTaskExitError) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    port.o(i.prvTaskExitError) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    port.o(i.prvTaskExitError) refers to _printf_dec.o(.text) for _printf_int_dec
+    port.o(i.prvTaskExitError) refers to _printf_str.o(.text) for _printf_str
+    port.o(i.prvTaskExitError) refers to noretval__2printf.o(.text) for __2printf
+    port.o(i.prvTaskExitError) refers to port.o(.data) for uxCriticalNesting
+    port.o(i.pxPortInitialiseStack) refers to port.o(i.prvTaskExitError) for prvTaskExitError
+    port.o(i.vPortEndScheduler) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    port.o(i.vPortEndScheduler) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    port.o(i.vPortEndScheduler) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    port.o(i.vPortEndScheduler) refers to _printf_dec.o(.text) for _printf_int_dec
+    port.o(i.vPortEndScheduler) refers to _printf_str.o(.text) for _printf_str
+    port.o(i.vPortEndScheduler) refers to noretval__2printf.o(.text) for __2printf
+    port.o(i.vPortEndScheduler) refers to port.o(.data) for uxCriticalNesting
+    port.o(i.vPortEnterCritical) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    port.o(i.vPortEnterCritical) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    port.o(i.vPortEnterCritical) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    port.o(i.vPortEnterCritical) refers to _printf_dec.o(.text) for _printf_int_dec
+    port.o(i.vPortEnterCritical) refers to _printf_str.o(.text) for _printf_str
+    port.o(i.vPortEnterCritical) refers to noretval__2printf.o(.text) for __2printf
+    port.o(i.vPortEnterCritical) refers to port.o(.data) for uxCriticalNesting
+    port.o(i.vPortExitCritical) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    port.o(i.vPortExitCritical) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    port.o(i.vPortExitCritical) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    port.o(i.vPortExitCritical) refers to _printf_dec.o(.text) for _printf_int_dec
+    port.o(i.vPortExitCritical) refers to _printf_str.o(.text) for _printf_str
+    port.o(i.vPortExitCritical) refers to noretval__2printf.o(.text) for __2printf
+    port.o(i.vPortExitCritical) refers to port.o(.data) for uxCriticalNesting
+    port.o(i.vPortSetupTimerInterrupt) refers to system_stm32f4xx.o(.data) for SystemCoreClock
+    port.o(i.vPortValidateInterruptPriority) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    port.o(i.vPortValidateInterruptPriority) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    port.o(i.vPortValidateInterruptPriority) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    port.o(i.vPortValidateInterruptPriority) refers to _printf_dec.o(.text) for _printf_int_dec
+    port.o(i.vPortValidateInterruptPriority) refers to _printf_str.o(.text) for _printf_str
+    port.o(i.vPortValidateInterruptPriority) refers to port.o(.emb_text) for vPortGetIPSR
+    port.o(i.vPortValidateInterruptPriority) refers to noretval__2printf.o(.text) for __2printf
+    port.o(i.vPortValidateInterruptPriority) refers to port.o(.data) for ucMaxSysCallPriority
+    port.o(i.xPortStartScheduler) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    port.o(i.xPortStartScheduler) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    port.o(i.xPortStartScheduler) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    port.o(i.xPortStartScheduler) refers to _printf_dec.o(.text) for _printf_int_dec
+    port.o(i.xPortStartScheduler) refers to _printf_str.o(.text) for _printf_str
+    port.o(i.xPortStartScheduler) refers to noretval__2printf.o(.text) for __2printf
+    port.o(i.xPortStartScheduler) refers to port.o(i.vPortSetupTimerInterrupt) for vPortSetupTimerInterrupt
+    port.o(i.xPortStartScheduler) refers to port.o(.emb_text) for __asm___6_port_c_39a90d8d__prvEnableVFP
+    port.o(i.xPortStartScheduler) refers to port.o(.data) for ucMaxSysCallPriority
+    port.o(i.xPortSysTickHandler) refers to tasks.o(i.xTaskIncrementTick) for xTaskIncrementTick
+    heap_4.o(i.prvHeapInit) refers to heap_4.o(.bss) for ucHeap
+    heap_4.o(i.prvHeapInit) refers to heap_4.o(.data) for xStart
+    heap_4.o(i.prvInsertBlockIntoFreeList) refers to heap_4.o(.data) for xStart
+    heap_4.o(i.pvPortMalloc) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    heap_4.o(i.pvPortMalloc) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    heap_4.o(i.pvPortMalloc) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    heap_4.o(i.pvPortMalloc) refers to _printf_dec.o(.text) for _printf_int_dec
+    heap_4.o(i.pvPortMalloc) refers to _printf_str.o(.text) for _printf_str
+    heap_4.o(i.pvPortMalloc) refers to tasks.o(i.vTaskSuspendAll) for vTaskSuspendAll
+    heap_4.o(i.pvPortMalloc) refers to heap_4.o(i.prvHeapInit) for prvHeapInit
+    heap_4.o(i.pvPortMalloc) refers to noretval__2printf.o(.text) for __2printf
+    heap_4.o(i.pvPortMalloc) refers to heap_4.o(i.prvInsertBlockIntoFreeList) for prvInsertBlockIntoFreeList
+    heap_4.o(i.pvPortMalloc) refers to tasks.o(i.xTaskResumeAll) for xTaskResumeAll
+    heap_4.o(i.pvPortMalloc) refers to heap_4.o(.data) for pxEnd
+    heap_4.o(i.vPortFree) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    heap_4.o(i.vPortFree) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    heap_4.o(i.vPortFree) refers to _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) for _printf_s
+    heap_4.o(i.vPortFree) refers to _printf_dec.o(.text) for _printf_int_dec
+    heap_4.o(i.vPortFree) refers to _printf_str.o(.text) for _printf_str
+    heap_4.o(i.vPortFree) refers to noretval__2printf.o(.text) for __2printf
+    heap_4.o(i.vPortFree) refers to tasks.o(i.vTaskSuspendAll) for vTaskSuspendAll
+    heap_4.o(i.vPortFree) refers to heap_4.o(i.prvInsertBlockIntoFreeList) for prvInsertBlockIntoFreeList
+    heap_4.o(i.vPortFree) refers to tasks.o(i.xTaskResumeAll) for xTaskResumeAll
+    heap_4.o(i.vPortFree) refers to heap_4.o(.data) for xBlockAllocatedBit
+    heap_4.o(i.xPortGetFreeHeapSize) refers to heap_4.o(.data) for xFreeBytesRemaining
+    heap_4.o(i.xPortGetMinimumEverFreeHeapSize) refers to heap_4.o(.data) for xMinimumEverFreeBytesRemaining
+    system.o(i.systemInit) refers to misc.o(i.NVIC_PriorityGroupConfig) for NVIC_PriorityGroupConfig
+    system.o(i.systemInit) refers to delay.o(i.delay_init) for delay_init
+    system.o(i.systemInit) refers to led.o(i.LED_Init) for LED_Init
+    system.o(i.systemInit) refers to led.o(i.Buzzer_Init) for Buzzer_Init
+    system.o(i.systemInit) refers to motor.o(i.Enable_Pin) for Enable_Pin
+    system.o(i.systemInit) refers to oled.o(i.OLED_Init) for OLED_Init
+    system.o(i.systemInit) refers to key.o(i.KEY_Init) for KEY_Init
+    system.o(i.systemInit) refers to usartx.o(i.uart1_init) for uart1_init
+    system.o(i.systemInit) refers to usartx.o(i.uart2_init) for uart2_init
+    system.o(i.systemInit) refers to usartx.o(i.uart3_init) for uart3_init
+    system.o(i.systemInit) refers to usartx.o(i.uart5_init) for uart5_init
+    system.o(i.systemInit) refers to adc.o(i.Adc_Init) for Adc_Init
+    system.o(i.systemInit) refers to adc.o(i.Adc_POWER_Init) for Adc_POWER_Init
+    system.o(i.systemInit) refers to can.o(i.CAN1_Mode_Init) for CAN1_Mode_Init
+    system.o(i.systemInit) refers to robot_select_init.o(i.Robot_Select) for Robot_Select
+    system.o(i.systemInit) refers to encoder.o(i.Encoder_Init_TIM2) for Encoder_Init_TIM2
+    system.o(i.systemInit) refers to encoder.o(i.Encoder_Init_TIM3) for Encoder_Init_TIM3
+    system.o(i.systemInit) refers to encoder.o(i.Encoder_Init_TIM4) for Encoder_Init_TIM4
+    system.o(i.systemInit) refers to encoder.o(i.Encoder_Init_TIM5) for Encoder_Init_TIM5
+    system.o(i.systemInit) refers to timer.o(i.TIM12_SERVO_Init) for TIM12_SERVO_Init
+    system.o(i.systemInit) refers to timer.o(i.TIM8_Cap_Init) for TIM8_Cap_Init
+    system.o(i.systemInit) refers to motor.o(i.TIM1_PWM_Init) for TIM1_PWM_Init
+    system.o(i.systemInit) refers to motor.o(i.TIM9_PWM_Init) for TIM9_PWM_Init
+    system.o(i.systemInit) refers to motor.o(i.TIM10_PWM_Init) for TIM10_PWM_Init
+    system.o(i.systemInit) refers to motor.o(i.TIM11_PWM_Init) for TIM11_PWM_Init
+    system.o(i.systemInit) refers to i2c.o(i.I2C_GPIOInit) for I2C_GPIOInit
+    system.o(i.systemInit) refers to mpu6050.o(i.MPU6050_initialize) for MPU6050_initialize
+    system.o(i.systemInit) refers to pstwo.o(i.PS2_Init) for PS2_Init
+    system.o(i.systemInit) refers to pstwo.o(i.PS2_SetInit) for PS2_SetInit
+    balance.o(i.Balance_task) refers to delay.o(i.getSysTickCnt) for getSysTickCnt
+    balance.o(i.Balance_task) refers to tasks.o(i.vTaskDelayUntil) for vTaskDelayUntil
+    balance.o(i.Balance_task) refers to balance.o(i.Get_Velocity_Form_Encoder) for Get_Velocity_Form_Encoder
+    balance.o(i.Balance_task) refers to balance.o(i.Get_RC) for Get_RC
+    balance.o(i.Balance_task) refers to balance.o(i.Remote_Control) for Remote_Control
+    balance.o(i.Balance_task) refers to balance.o(i.PS2_control) for PS2_control
+    balance.o(i.Balance_task) refers to balance.o(i.Drive_Motor) for Drive_Motor
+    balance.o(i.Balance_task) refers to balance.o(i.Key) for Key
+    balance.o(i.Balance_task) refers to balance.o(i.Turn_Off) for Turn_Off
+    balance.o(i.Balance_task) refers to balance.o(i.Incremental_PI_A) for Incremental_PI_A
+    balance.o(i.Balance_task) refers to balance.o(i.Incremental_PI_B) for Incremental_PI_B
+    balance.o(i.Balance_task) refers to balance.o(i.Incremental_PI_C) for Incremental_PI_C
+    balance.o(i.Balance_task) refers to balance.o(i.Incremental_PI_D) for Incremental_PI_D
+    balance.o(i.Balance_task) refers to balance.o(i.Limit_Pwm) for Limit_Pwm
+    balance.o(i.Balance_task) refers to balance.o(i.Set_Pwm) for Set_Pwm
+    balance.o(i.Balance_task) refers to balance.o(.data) for Time_count
+    balance.o(i.Balance_task) refers to system.o(.data) for Check
+    balance.o(i.Balance_task) refers to adc.o(.data) for Voltage
+    balance.o(i.Balance_task) refers to system.o(.bss) for MOTOR_A
+    balance.o(i.Drive_Motor) refers to balance.o(i.Smooth_control) for Smooth_control
+    balance.o(i.Drive_Motor) refers to balance.o(i.target_limit_float) for target_limit_float
+    balance.o(i.Drive_Motor) refers to f2d.o(x$fpl$f2d) for __aeabi_f2d
+    balance.o(i.Drive_Motor) refers to sqrt.o(i.__hardfp_sqrt) for __hardfp_sqrt
+    balance.o(i.Drive_Motor) refers to ddiv.o(x$fpl$ddiv) for __aeabi_ddiv
+    balance.o(i.Drive_Motor) refers to basic.o(x$fpl$basic) for __aeabi_dneg
+    balance.o(i.Drive_Motor) refers to dmul.o(x$fpl$dmul) for __aeabi_dmul
+    balance.o(i.Drive_Motor) refers to daddsub_clz.o(x$fpl$dsub) for __aeabi_dsub
+    balance.o(i.Drive_Motor) refers to daddsub_clz.o(x$fpl$dadd) for __aeabi_dadd
+    balance.o(i.Drive_Motor) refers to d2f.o(x$fpl$d2f) for __aeabi_d2f
+    balance.o(i.Drive_Motor) refers to tan.o(i.__hardfp_tan) for __hardfp_tan
+    balance.o(i.Drive_Motor) refers to system.o(.data) for Car_Mode
+    balance.o(i.Drive_Motor) refers to system.o(.bss) for smooth_control
+    balance.o(i.Drive_Motor) refers to pow.o(i.__hardfp_pow) for __hardfp_pow
+    balance.o(i.Drive_Motor) refers to balance.o(i.target_limit_int) for target_limit_int
+    balance.o(i.Get_RC) refers to balance.o(i.Drive_Motor) for Drive_Motor
+    balance.o(i.Get_RC) refers to system.o(.data) for Car_Mode
+    balance.o(i.Get_Velocity_Form_Encoder) refers to encoder.o(i.Read_Encoder) for Read_Encoder
+    balance.o(i.Get_Velocity_Form_Encoder) refers to balance.o(.bss) for OriginalEncoder
+    balance.o(i.Get_Velocity_Form_Encoder) refers to system.o(.data) for Car_Mode
+    balance.o(i.Get_Velocity_Form_Encoder) refers to system.o(.bss) for MOTOR_A
+    balance.o(i.Incremental_PI_A) refers to balance.o(.data) for Bias
+    balance.o(i.Incremental_PI_A) refers to system.o(.data) for Velocity_KP
+    balance.o(i.Incremental_PI_B) refers to balance.o(.data) for Bias
+    balance.o(i.Incremental_PI_B) refers to system.o(.data) for Velocity_KP
+    balance.o(i.Incremental_PI_C) refers to balance.o(.data) for Bias
+    balance.o(i.Incremental_PI_C) refers to system.o(.data) for Velocity_KP
+    balance.o(i.Incremental_PI_D) refers to balance.o(.data) for Bias
+    balance.o(i.Incremental_PI_D) refers to system.o(.data) for Velocity_KP
+    balance.o(i.Key) refers to key.o(i.click_N_Double_MPU6050) for click_N_Double_MPU6050
+    balance.o(i.Key) refers to mpu6050.o(.data) for Deviation_gyro
+    balance.o(i.Limit_Pwm) refers to balance.o(i.target_limit_float) for target_limit_float
+    balance.o(i.Limit_Pwm) refers to system.o(.bss) for MOTOR_A
+    balance.o(i.PS2_control) refers to balance.o(i.Drive_Motor) for Drive_Motor
+    balance.o(i.PS2_control) refers to system.o(.data) for PS2_LX
+    balance.o(i.Remote_Control) refers to balance.o(i.target_limit_int) for target_limit_int
+    balance.o(i.Remote_Control) refers to balance.o(i.Drive_Motor) for Drive_Motor
+    balance.o(i.Remote_Control) refers to timer.o(.data) for Remoter_Ch1
+    balance.o(i.Remote_Control) refers to system.o(.data) for RC_Velocity
+    balance.o(i.Remote_Control) refers to balance.o(.data) for thrice
+    balance.o(i.Smooth_control) refers to balance.o(i.float_abs) for float_abs
+    balance.o(i.Smooth_control) refers to balance.o(i.target_limit_float) for target_limit_float
+    balance.o(i.Smooth_control) refers to system.o(.bss) for smooth_control
+    balance.o(i.Turn_Off) refers to system.o(.data) for Flag_Stop
+    balance.o(i.robot_mode_check) refers to system.o(.bss) for MOTOR_A
+    balance.o(i.robot_mode_check) refers to balance.o(.data) for error
+    balance.o(i.robot_mode_check) refers to system.o(.data) for Flag_Stop
+    robot_select_init.o(i.Robot_Init) refers to d2f.o(x$fpl$d2f) for __aeabi_d2f
+    robot_select_init.o(i.Robot_Init) refers to robot_select_init.o(.bss) for Robot_Parament
+    robot_select_init.o(i.Robot_Init) refers to system.o(.data) for Encoder_precision
+    robot_select_init.o(i.Robot_Select) refers to adc.o(i.Get_adc_Average) for Get_adc_Average
+    robot_select_init.o(i.Robot_Select) refers to robot_select_init.o(i.Robot_Init) for Robot_Init
+    robot_select_init.o(i.Robot_Select) refers to system.o(.data) for Divisor_Mode
+    show.o(i.APP_Show) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    show.o(i.APP_Show) refers to _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) for _printf_d
+    show.o(i.APP_Show) refers to _printf_dec.o(.text) for _printf_int_dec
+    show.o(i.APP_Show) refers to noretval__2printf.o(.text) for __2printf
+    show.o(i.APP_Show) refers to adc.o(.data) for Voltage
+    show.o(i.APP_Show) refers to system.o(.bss) for MOTOR_A
+    show.o(i.APP_Show) refers to show.o(.data) for flag_show
+    show.o(i.APP_Show) refers to system.o(.data) for PID_Send
+    show.o(i.APP_Show) refers to mpu6050.o(.data) for gyro
+    show.o(i.oled_show) refers to adc.o(i.Get_adc_Average) for Get_adc_Average
+    show.o(i.oled_show) refers to oled.o(i.OLED_ShowString) for OLED_ShowString
+    show.o(i.oled_show) refers to oled.o(i.OLED_ShowNumber) for OLED_ShowNumber
+    show.o(i.oled_show) refers to system.o(.data) for Divisor_Mode
+    show.o(i.oled_show) refers to adc.o(.data) for Voltage
+    show.o(i.oled_show) refers to show.o(.data) for Voltage_Show
+    show.o(i.oled_show) refers to mpu6050.o(.data) for gyro
+    show.o(i.oled_show) refers to system.o(.bss) for MOTOR_A
+    show.o(i.oled_show) refers to oled.o(i.OLED_Refresh_Gram) for OLED_Refresh_Gram
+    show.o(i.oled_show) refers to usartx.o(.bss) for Send_Data
+    show.o(i.show_task) refers to delay.o(i.getSysTickCnt) for getSysTickCnt
+    show.o(i.show_task) refers to tasks.o(i.vTaskDelayUntil) for vTaskDelayUntil
+    show.o(i.show_task) refers to adc.o(i.Get_battery_volt) for Get_battery_volt
+    show.o(i.show_task) refers to show.o(i.APP_Show) for APP_Show
+    show.o(i.show_task) refers to show.o(i.oled_show) for oled_show
+    show.o(i.show_task) refers to balance.o(.data) for Time_count
+    show.o(i.show_task) refers to show.o(.data) for LowVoltage_1
+    show.o(i.show_task) refers to adc.o(.data) for Voltage_All
+    mpu6050.o(i.MPU6050_Set_LPF) refers to i2c.o(i.I2C_WriteOneByte) for I2C_WriteOneByte
+    mpu6050.o(i.MPU6050_Set_Rate) refers to i2c.o(i.I2C_WriteOneByte) for I2C_WriteOneByte
+    mpu6050.o(i.MPU6050_Set_Rate) refers to mpu6050.o(i.MPU6050_Set_LPF) for MPU6050_Set_LPF
+    mpu6050.o(i.MPU6050_getDeviceID) refers to i2c.o(i.I2C_ReadOneByte) for I2C_ReadOneByte
+    mpu6050.o(i.MPU6050_initialize) refers to i2c.o(i.I2C_WriteOneByte) for I2C_WriteOneByte
+    mpu6050.o(i.MPU6050_initialize) refers to delay.o(i.delay_ms) for delay_ms
+    mpu6050.o(i.MPU6050_initialize) refers to mpu6050.o(i.MPU6050_setFullScaleGyroRange) for MPU6050_setFullScaleGyroRange
+    mpu6050.o(i.MPU6050_initialize) refers to mpu6050.o(i.MPU6050_setFullScaleAccelRange) for MPU6050_setFullScaleAccelRange
+    mpu6050.o(i.MPU6050_initialize) refers to mpu6050.o(i.MPU6050_Set_Rate) for MPU6050_Set_Rate
+    mpu6050.o(i.MPU6050_initialize) refers to i2c.o(i.I2C_ReadOneByte) for I2C_ReadOneByte
+    mpu6050.o(i.MPU6050_newValues) refers to mpu6050.o(.bss) for MPU6050_FIFO
+    mpu6050.o(i.MPU6050_setClockSource) refers to i2c.o(i.I2C_WriteBits) for I2C_WriteBits
+    mpu6050.o(i.MPU6050_setFullScaleAccelRange) refers to i2c.o(i.I2C_WriteBits) for I2C_WriteBits
+    mpu6050.o(i.MPU6050_setFullScaleGyroRange) refers to i2c.o(i.I2C_WriteBits) for I2C_WriteBits
+    mpu6050.o(i.MPU6050_setI2CBypassEnabled) refers to i2c.o(i.I2C_WriteOneBit) for I2C_WriteOneBit
+    mpu6050.o(i.MPU6050_setI2CMasterModeEnabled) refers to i2c.o(i.I2C_WriteOneBit) for I2C_WriteOneBit
+    mpu6050.o(i.MPU6050_setSleepEnabled) refers to i2c.o(i.I2C_WriteOneBit) for I2C_WriteOneBit
+    mpu6050.o(i.MPU6050_task) refers to delay.o(i.getSysTickCnt) for getSysTickCnt
+    mpu6050.o(i.MPU6050_task) refers to tasks.o(i.vTaskDelayUntil) for vTaskDelayUntil
+    mpu6050.o(i.MPU6050_task) refers to mpu6050.o(i.MPU_Get_Gyroscope) for MPU_Get_Gyroscope
+    mpu6050.o(i.MPU6050_task) refers to mpu6050.o(i.MPU_Get_Accelscope) for MPU_Get_Accelscope
+    mpu6050.o(i.MPU6050_task) refers to mpu6050.o(.data) for Deviation_Count
+    mpu6050.o(i.MPU6050_testConnection) refers to mpu6050.o(i.MPU6050_getDeviceID) for MPU6050_getDeviceID
+    mpu6050.o(i.MPU_Get_Accelscope) refers to i2c.o(i.I2C_ReadOneByte) for I2C_ReadOneByte
+    mpu6050.o(i.MPU_Get_Accelscope) refers to mpu6050.o(.data) for accel
+    mpu6050.o(i.MPU_Get_Gyroscope) refers to i2c.o(i.I2C_ReadOneByte) for I2C_ReadOneByte
+    mpu6050.o(i.MPU_Get_Gyroscope) refers to mpu6050.o(.data) for gyro
+    mpu6050.o(i.MPU_Get_Gyroscope) refers to led.o(.data) for Led_Count
+    mpu6050.o(i.MPU_Get_Gyroscope) refers to system.o(.data) for Flag_Stop
+    mpu6050.o(i.Read_Temperature) refers to i2c.o(i.I2C_ReadOneByte) for I2C_ReadOneByte
+    i2c.o(i.I2C_Ack) refers to delay.o(i.delay_us) for delay_us
+    i2c.o(i.I2C_GPIOInit) refers to stm32f4xx_rcc.o(i.RCC_AHB1PeriphClockCmd) for RCC_AHB1PeriphClockCmd
+    i2c.o(i.I2C_GPIOInit) refers to stm32f4xx_gpio.o(i.GPIO_Init) for GPIO_Init
+    i2c.o(i.I2C_NAck) refers to delay.o(i.delay_us) for delay_us
+    i2c.o(i.I2C_ReadBuff) refers to i2c.o(i.I2C_Start) for I2C_Start
+    i2c.o(i.I2C_ReadBuff) refers to i2c.o(i.I2C_WriteByte) for I2C_WriteByte
+    i2c.o(i.I2C_ReadBuff) refers to i2c.o(i.I2C_WaiteForAck) for I2C_WaiteForAck
+    i2c.o(i.I2C_ReadBuff) refers to i2c.o(i.I2C_ReadByte) for I2C_ReadByte
+    i2c.o(i.I2C_ReadBuff) refers to i2c.o(i.I2C_Stop) for I2C_Stop
+    i2c.o(i.I2C_ReadByte) refers to delay.o(i.delay_us) for delay_us
+    i2c.o(i.I2C_ReadByte) refers to i2c.o(i.I2C_Ack) for I2C_Ack
+    i2c.o(i.I2C_ReadByte) refers to i2c.o(i.I2C_NAck) for I2C_NAck
+    i2c.o(i.I2C_ReadOneByte) refers to i2c.o(i.I2C_Start) for I2C_Start
+    i2c.o(i.I2C_ReadOneByte) refers to i2c.o(i.I2C_WriteByte) for I2C_WriteByte
+    i2c.o(i.I2C_ReadOneByte) refers to i2c.o(i.I2C_WaiteForAck) for I2C_WaiteForAck
+    i2c.o(i.I2C_ReadOneByte) refers to i2c.o(i.I2C_ReadByte) for I2C_ReadByte
+    i2c.o(i.I2C_ReadOneByte) refers to i2c.o(i.I2C_Stop) for I2C_Stop
+    i2c.o(i.I2C_Start) refers to delay.o(i.delay_us) for delay_us
+    i2c.o(i.I2C_Stop) refers to delay.o(i.delay_us) for delay_us
+    i2c.o(i.I2C_WaiteForAck) refers to delay.o(i.delay_us) for delay_us
+    i2c.o(i.I2C_WaiteForAck) refers to i2c.o(i.I2C_Stop) for I2C_Stop
+    i2c.o(i.I2C_WriteBits) refers to i2c.o(i.I2C_ReadOneByte) for I2C_ReadOneByte
+    i2c.o(i.I2C_WriteBits) refers to i2c.o(i.I2C_WriteOneByte) for I2C_WriteOneByte
+    i2c.o(i.I2C_WriteBuff) refers to i2c.o(i.I2C_Start) for I2C_Start
+    i2c.o(i.I2C_WriteBuff) refers to i2c.o(i.I2C_WriteByte) for I2C_WriteByte
+    i2c.o(i.I2C_WriteBuff) refers to i2c.o(i.I2C_WaiteForAck) for I2C_WaiteForAck
+    i2c.o(i.I2C_WriteBuff) refers to i2c.o(i.I2C_Stop) for I2C_Stop
+    i2c.o(i.I2C_WriteByte) refers to delay.o(i.delay_us) for delay_us
+    i2c.o(i.I2C_WriteOneBit) refers to i2c.o(i.I2C_ReadOneByte) for I2C_ReadOneByte
+    i2c.o(i.I2C_WriteOneBit) refers to i2c.o(i.I2C_WriteOneByte) for I2C_WriteOneByte
+    i2c.o(i.I2C_WriteOneByte) refers to i2c.o(i.I2C_Start) for I2C_Start
+    i2c.o(i.I2C_WriteOneByte) refers to i2c.o(i.I2C_WriteByte) for I2C_WriteByte
+    i2c.o(i.I2C_WriteOneByte) refers to i2c.o(i.I2C_WaiteForAck) for I2C_WaiteForAck
+    i2c.o(i.I2C_WriteOneByte) refers to i2c.o(i.I2C_Stop) for I2C_Stop
+    use_no_semi_2.o(.text) refers (Special) to use_no_semi.o(.text) for __use_no_semihosting_swi
+    __2printf.o(.text) refers to _printf_char_file.o(.text) for _printf_char_file
+    __2printf.o(.text) refers to usart.o(.data) for __stdout
+    __2sprintf.o(.text) refers to _printf_char_common.o(.text) for _printf_char_common
+    __2sprintf.o(.text) refers to _sputc.o(.text) for _sputc
+    noretval__2printf.o(.text) refers to _printf_char_file.o(.text) for _printf_char_file
+    noretval__2printf.o(.text) refers to usart.o(.data) for __stdout
+    noretval__2sprintf.o(.text) refers to _printf_char_common.o(.text) for _printf_char_common
+    noretval__2sprintf.o(.text) refers to _sputc.o(.text) for _sputc
+    __printf.o(.text) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    _printf_str.o(.text) refers (Special) to _printf_char.o(.text) for _printf_cs_common
+    _printf_dec.o(.text) refers to _printf_intcommon.o(.text) for _printf_int_common
+    __printf_flags.o(.text) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    __printf_flags.o(.text) refers to __printf_flags.o(.constdata) for .constdata
+    __printf_ss.o(.text) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    __printf_flags_ss.o(.text) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    __printf_flags_ss.o(.text) refers to __printf_flags_ss.o(.constdata) for .constdata
+    __printf_wp.o(.text) refers to __printf_wp.o(i._is_digit) for _is_digit
+    __printf_wp.o(.text) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    __printf_flags_wp.o(.text) refers to __printf_wp.o(i._is_digit) for _is_digit
+    __printf_flags_wp.o(.text) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    __printf_flags_wp.o(.text) refers to __printf_flags_wp.o(.constdata) for .constdata
+    __printf_ss_wp.o(.text) refers to __printf_wp.o(i._is_digit) for _is_digit
+    __printf_ss_wp.o(.text) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    __printf_flags_ss_wp.o(.text) refers to __printf_wp.o(i._is_digit) for _is_digit
+    __printf_flags_ss_wp.o(.text) refers to _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) for _printf_percent
+    __printf_flags_ss_wp.o(.text) refers to __printf_flags_ss_wp.o(.constdata) for .constdata
+    _printf_c.o(.ARM.Collect$$_printf_percent$$00000013) refers (Weak) to _printf_char.o(.text) for _printf_char
+    _printf_s.o(.ARM.Collect$$_printf_percent$$00000014) refers (Weak) to _printf_char.o(.text) for _printf_string
+    _printf_d.o(.ARM.Collect$$_printf_percent$$00000009) refers (Weak) to _printf_dec.o(.text) for _printf_int_dec
+    _printf_u.o(.ARM.Collect$$_printf_percent$$0000000A) refers (Weak) to _printf_dec.o(.text) for _printf_int_dec
+    _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000) refers (Special) to _printf_percent_end.o(.ARM.Collect$$_printf_percent$$00000017) for _printf_percent_end
+    rt_memcpy_v6.o(.text) refers to rt_memcpy_w.o(.text) for __aeabi_memcpy4
+    aeabi_memset.o(.text) refers to rt_memclr.o(.text) for _memset
+    rt_memclr.o(.text) refers to rt_memclr_w.o(.text) for _memset_w
+    __main.o(!!!main) refers to __rtentry.o(.ARM.Collect$$rtentry$$00000000) for __rt_entry
+    basic.o(x$fpl$basic) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    d2f.o(x$fpl$d2f) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    d2f.o(x$fpl$d2f) refers to fretinf.o(x$fpl$fretinf) for __fpl_fretinf
+    d2f.o(x$fpl$d2f) refers to dnaninf.o(x$fpl$dnaninf) for __fpl_dnaninf
+    daddsub_clz.o(x$fpl$dadd) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    daddsub_clz.o(x$fpl$dadd) refers to daddsub_clz.o(x$fpl$dsub) for _dsub1
+    daddsub_clz.o(x$fpl$dadd) refers to dretinf.o(x$fpl$dretinf) for __fpl_dretinf
+    daddsub_clz.o(x$fpl$dadd) refers to dnaninf.o(x$fpl$dnaninf) for __fpl_dnaninf
+    daddsub_clz.o(x$fpl$drsb) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    daddsub_clz.o(x$fpl$drsb) refers to daddsub_clz.o(x$fpl$dadd) for _dadd1
+    daddsub_clz.o(x$fpl$drsb) refers to daddsub_clz.o(x$fpl$dsub) for _dsub1
+    daddsub_clz.o(x$fpl$dsub) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    daddsub_clz.o(x$fpl$dsub) refers to daddsub_clz.o(x$fpl$dadd) for _dadd1
+    daddsub_clz.o(x$fpl$dsub) refers to dnaninf.o(x$fpl$dnaninf) for __fpl_dnaninf
+    ddiv.o(x$fpl$drdiv) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    ddiv.o(x$fpl$drdiv) refers to ddiv.o(x$fpl$ddiv) for ddiv_entry
+    ddiv.o(x$fpl$ddiv) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    ddiv.o(x$fpl$ddiv) refers to dretinf.o(x$fpl$dretinf) for __fpl_dretinf
+    ddiv.o(x$fpl$ddiv) refers to dnaninf.o(x$fpl$dnaninf) for __fpl_dnaninf
+    dfix.o(x$fpl$dfix) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    dfix.o(x$fpl$dfix) refers to dnaninf.o(x$fpl$dnaninf) for __fpl_dnaninf
+    dfix.o(x$fpl$dfixr) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    dfix.o(x$fpl$dfixr) refers to dnaninf.o(x$fpl$dnaninf) for __fpl_dnaninf
+    dflt_clz.o(x$fpl$dfltu) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    dflt_clz.o(x$fpl$dflt) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    dflt_clz.o(x$fpl$dfltn) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    dmul.o(x$fpl$dmul) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    dmul.o(x$fpl$dmul) refers to dretinf.o(x$fpl$dretinf) for __fpl_dretinf
+    dmul.o(x$fpl$dmul) refers to dnaninf.o(x$fpl$dnaninf) for __fpl_dnaninf
+    f2d.o(x$fpl$f2d) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    f2d.o(x$fpl$f2d) refers to fnaninf.o(x$fpl$fnaninf) for __fpl_fnaninf
+    f2d.o(x$fpl$f2d) refers to dretinf.o(x$fpl$dretinf) for __fpl_dretinf
+    atan.o(i.__hardfp_atan) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    atan.o(i.__hardfp_atan) refers to dunder.o(i.__mathlib_dbl_infnan) for __mathlib_dbl_infnan
+    atan.o(i.__hardfp_atan) refers to fpclassify.o(i.__ARM_fpclassify) for __ARM_fpclassify
+    atan.o(i.__hardfp_atan) refers to dunder.o(i.__mathlib_dbl_underflow) for __mathlib_dbl_underflow
+    atan.o(i.__hardfp_atan) refers to fabs.o(i.fabs) for fabs
+    atan.o(i.__hardfp_atan) refers to daddsub_clz.o(x$fpl$dadd) for __aeabi_dadd
+    atan.o(i.__hardfp_atan) refers to dmul.o(x$fpl$dmul) for __aeabi_dmul
+    atan.o(i.__hardfp_atan) refers to daddsub_clz.o(x$fpl$dsub) for __aeabi_dsub
+    atan.o(i.__hardfp_atan) refers to ddiv.o(x$fpl$ddiv) for __aeabi_ddiv
+    atan.o(i.__hardfp_atan) refers to poly.o(i.__kernel_poly) for __kernel_poly
+    atan.o(i.__hardfp_atan) refers to daddsub_clz.o(x$fpl$drsb) for __aeabi_drsub
+    atan.o(i.__hardfp_atan) refers to basic.o(x$fpl$basic) for __aeabi_dneg
+    atan.o(i.__hardfp_atan) refers to atan.o(.constdata) for .constdata
+    atan.o(i.__softfp_atan) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    atan.o(i.__softfp_atan) refers to atan.o(i.__hardfp_atan) for __hardfp_atan
+    atan.o(i.atan) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    atan.o(i.atan) refers to atan.o(i.__hardfp_atan) for __hardfp_atan
+    atan.o(.constdata) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    atan_x.o(i.____hardfp_atan$lsc) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    atan_x.o(i.____hardfp_atan$lsc) refers to dunder.o(i.__mathlib_dbl_infnan) for __mathlib_dbl_infnan
+    atan_x.o(i.____hardfp_atan$lsc) refers to fabs.o(i.fabs) for fabs
+    atan_x.o(i.____hardfp_atan$lsc) refers to daddsub_clz.o(x$fpl$dadd) for __aeabi_dadd
+    atan_x.o(i.____hardfp_atan$lsc) refers to dmul.o(x$fpl$dmul) for __aeabi_dmul
+    atan_x.o(i.____hardfp_atan$lsc) refers to daddsub_clz.o(x$fpl$dsub) for __aeabi_dsub
+    atan_x.o(i.____hardfp_atan$lsc) refers to ddiv.o(x$fpl$ddiv) for __aeabi_ddiv
+    atan_x.o(i.____hardfp_atan$lsc) refers to poly.o(i.__kernel_poly) for __kernel_poly
+    atan_x.o(i.____hardfp_atan$lsc) refers to daddsub_clz.o(x$fpl$drsb) for __aeabi_drsub
+    atan_x.o(i.____hardfp_atan$lsc) refers to basic.o(x$fpl$basic) for __aeabi_dneg
+    atan_x.o(i.____hardfp_atan$lsc) refers to atan_x.o(.constdata) for .constdata
+    atan_x.o(i.____softfp_atan$lsc) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    atan_x.o(i.____softfp_atan$lsc) refers to atan_x.o(i.____hardfp_atan$lsc) for ____hardfp_atan$lsc
+    atan_x.o(i.__atan$lsc) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    atan_x.o(i.__atan$lsc) refers to atan_x.o(i.____hardfp_atan$lsc) for ____hardfp_atan$lsc
+    atan_x.o(.constdata) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    pow.o(i.__hardfp_pow) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    pow.o(i.__hardfp_pow) refers to dunder.o(i.__mathlib_dbl_infnan2) for __mathlib_dbl_infnan2
+    pow.o(i.__hardfp_pow) refers to _rserrno.o(.text) for __set_errno
+    pow.o(i.__hardfp_pow) refers to dunder.o(i.__mathlib_dbl_divzero) for __mathlib_dbl_divzero
+    pow.o(i.__hardfp_pow) refers to basic.o(x$fpl$basic) for __aeabi_dneg
+    pow.o(i.__hardfp_pow) refers to dunder.o(i.__mathlib_dbl_overflow) for __mathlib_dbl_overflow
+    pow.o(i.__hardfp_pow) refers to ddiv.o(x$fpl$ddiv) for __aeabi_ddiv
+    pow.o(i.__hardfp_pow) refers to sqrt.o(i.sqrt) for sqrt
+    pow.o(i.__hardfp_pow) refers to fabs.o(i.fabs) for fabs
+    pow.o(i.__hardfp_pow) refers to dflt_clz.o(x$fpl$dflt) for __aeabi_i2d
+    pow.o(i.__hardfp_pow) refers to dunder.o(i.__mathlib_dbl_invalid) for __mathlib_dbl_invalid
+    pow.o(i.__hardfp_pow) refers to dmul.o(x$fpl$dmul) for __aeabi_dmul
+    pow.o(i.__hardfp_pow) refers to dunder.o(i.__mathlib_dbl_underflow) for __mathlib_dbl_underflow
+    pow.o(i.__hardfp_pow) refers to daddsub_clz.o(x$fpl$dsub) for __aeabi_dsub
+    pow.o(i.__hardfp_pow) refers to daddsub_clz.o(x$fpl$drsb) for __aeabi_drsub
+    pow.o(i.__hardfp_pow) refers to qnan.o(.constdata) for __mathlib_zero
+    pow.o(i.__hardfp_pow) refers to daddsub_clz.o(x$fpl$dadd) for __aeabi_dadd
+    pow.o(i.__hardfp_pow) refers to poly.o(i.__kernel_poly) for __kernel_poly
+    pow.o(i.__hardfp_pow) refers to pow.o(.constdata) for .constdata
+    pow.o(i.__hardfp_pow) refers to drleqf.o(x$fpl$drleqf) for __aeabi_cdrcmple
+    pow.o(i.__hardfp_pow) refers to scalbn.o(x$fpl$scalbn) for __ARM_scalbn
+    pow.o(i.__hardfp_pow) refers to fpclassify.o(i.__ARM_fpclassify) for __ARM_fpclassify
+    pow.o(i.__softfp_pow) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    pow.o(i.__softfp_pow) refers to pow.o(i.__hardfp_pow) for __hardfp_pow
+    pow.o(i.pow) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    pow.o(i.pow) refers to pow.o(i.__hardfp_pow) for __hardfp_pow
+    pow.o(.constdata) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    pow_x.o(i.____hardfp_pow$lsc) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    pow_x.o(i.____hardfp_pow$lsc) refers to dunder.o(i.__mathlib_dbl_infnan2) for __mathlib_dbl_infnan2
+    pow_x.o(i.____hardfp_pow$lsc) refers to _rserrno.o(.text) for __set_errno
+    pow_x.o(i.____hardfp_pow$lsc) refers to basic.o(x$fpl$basic) for __aeabi_dneg
+    pow_x.o(i.____hardfp_pow$lsc) refers to ddiv.o(x$fpl$ddiv) for __aeabi_ddiv
+    pow_x.o(i.____hardfp_pow$lsc) refers to sqrt.o(i.sqrt) for sqrt
+    pow_x.o(i.____hardfp_pow$lsc) refers to fabs.o(i.fabs) for fabs
+    pow_x.o(i.____hardfp_pow$lsc) refers to dflt_clz.o(x$fpl$dflt) for __aeabi_i2d
+    pow_x.o(i.____hardfp_pow$lsc) refers to dmul.o(x$fpl$dmul) for __aeabi_dmul
+    pow_x.o(i.____hardfp_pow$lsc) refers to daddsub_clz.o(x$fpl$dsub) for __aeabi_dsub
+    pow_x.o(i.____hardfp_pow$lsc) refers to daddsub_clz.o(x$fpl$drsb) for __aeabi_drsub
+    pow_x.o(i.____hardfp_pow$lsc) refers to qnan.o(.constdata) for __mathlib_zero
+    pow_x.o(i.____hardfp_pow$lsc) refers to daddsub_clz.o(x$fpl$dadd) for __aeabi_dadd
+    pow_x.o(i.____hardfp_pow$lsc) refers to poly.o(i.__kernel_poly) for __kernel_poly
+    pow_x.o(i.____hardfp_pow$lsc) refers to pow_x.o(.constdata) for .constdata
+    pow_x.o(i.____hardfp_pow$lsc) refers to drleqf.o(x$fpl$drleqf) for __aeabi_cdrcmple
+    pow_x.o(i.____hardfp_pow$lsc) refers to scalbn.o(x$fpl$scalbn) for __ARM_scalbn
+    pow_x.o(i.____softfp_pow$lsc) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    pow_x.o(i.____softfp_pow$lsc) refers to pow_x.o(i.____hardfp_pow$lsc) for ____hardfp_pow$lsc
+    pow_x.o(i.__pow$lsc) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    pow_x.o(i.__pow$lsc) refers to pow_x.o(i.____hardfp_pow$lsc) for ____hardfp_pow$lsc
+    pow_x.o(.constdata) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    sqrt.o(i.__hardfp_sqrt) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    sqrt.o(i.__hardfp_sqrt) refers to dsqrt_umaal.o(x$fpl$dsqrt) for _dsqrt
+    sqrt.o(i.__hardfp_sqrt) refers to _rserrno.o(.text) for __set_errno
+    sqrt.o(i.__softfp_sqrt) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    sqrt.o(i.__softfp_sqrt) refers to dsqrt_umaal.o(x$fpl$dsqrt) for _dsqrt
+    sqrt.o(i.__softfp_sqrt) refers to _rserrno.o(.text) for __set_errno
+    sqrt.o(i.sqrt) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    sqrt.o(i.sqrt) refers to dsqrt_umaal.o(x$fpl$dsqrt) for _dsqrt
+    sqrt.o(i.sqrt) refers to _rserrno.o(.text) for __set_errno
+    sqrt_x.o(i.____hardfp_sqrt$lsc) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    sqrt_x.o(i.____hardfp_sqrt$lsc) refers to dleqf.o(x$fpl$dleqf) for __aeabi_cdcmple
+    sqrt_x.o(i.____hardfp_sqrt$lsc) refers to _rserrno.o(.text) for __set_errno
+    sqrt_x.o(i.____hardfp_sqrt$lsc) refers to dsqrt_umaal.o(x$fpl$dsqrt) for _dsqrt
+    sqrt_x.o(i.____softfp_sqrt$lsc) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    sqrt_x.o(i.____softfp_sqrt$lsc) refers to dleqf.o(x$fpl$dleqf) for __aeabi_cdcmple
+    sqrt_x.o(i.____softfp_sqrt$lsc) refers to _rserrno.o(.text) for __set_errno
+    sqrt_x.o(i.____softfp_sqrt$lsc) refers to dsqrt_umaal.o(x$fpl$dsqrt) for _dsqrt
+    sqrt_x.o(i.__sqrt$lsc) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    sqrt_x.o(i.__sqrt$lsc) refers to dleqf.o(x$fpl$dleqf) for __aeabi_cdcmple
+    sqrt_x.o(i.__sqrt$lsc) refers to _rserrno.o(.text) for __set_errno
+    sqrt_x.o(i.__sqrt$lsc) refers to dsqrt_umaal.o(x$fpl$dsqrt) for _dsqrt
+    tan.o(i.__hardfp_tan) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    tan.o(i.__hardfp_tan) refers to _rserrno.o(.text) for __set_errno
+    tan.o(i.__hardfp_tan) refers to dunder.o(i.__mathlib_dbl_invalid) for __mathlib_dbl_invalid
+    tan.o(i.__hardfp_tan) refers to dunder.o(i.__mathlib_dbl_infnan) for __mathlib_dbl_infnan
+    tan.o(i.__hardfp_tan) refers to rred.o(i.__ieee754_rem_pio2) for __ieee754_rem_pio2
+    tan.o(i.__hardfp_tan) refers to tan_i.o(i.__kernel_tan) for __kernel_tan
+    tan.o(i.__softfp_tan) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    tan.o(i.__softfp_tan) refers to _rserrno.o(.text) for __set_errno
+    tan.o(i.__softfp_tan) refers to dunder.o(i.__mathlib_dbl_invalid) for __mathlib_dbl_invalid
+    tan.o(i.__softfp_tan) refers to dunder.o(i.__mathlib_dbl_infnan) for __mathlib_dbl_infnan
+    tan.o(i.__softfp_tan) refers to rred.o(i.__ieee754_rem_pio2) for __ieee754_rem_pio2
+    tan.o(i.__softfp_tan) refers to tan_i.o(i.__kernel_tan) for __kernel_tan
+    tan.o(i.tan) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    tan.o(i.tan) refers to _rserrno.o(.text) for __set_errno
+    tan.o(i.tan) refers to dunder.o(i.__mathlib_dbl_invalid) for __mathlib_dbl_invalid
+    tan.o(i.tan) refers to dunder.o(i.__mathlib_dbl_infnan) for __mathlib_dbl_infnan
+    tan.o(i.tan) refers to rred.o(i.__ieee754_rem_pio2) for __ieee754_rem_pio2
+    tan.o(i.tan) refers to tan_i.o(i.__kernel_tan) for __kernel_tan
+    tan_x.o(i.____hardfp_tan$lsc) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    tan_x.o(i.____hardfp_tan$lsc) refers to _rserrno.o(.text) for __set_errno
+    tan_x.o(i.____hardfp_tan$lsc) refers to dunder.o(i.__mathlib_dbl_infnan) for __mathlib_dbl_infnan
+    tan_x.o(i.____hardfp_tan$lsc) refers to rred.o(i.__ieee754_rem_pio2) for __ieee754_rem_pio2
+    tan_x.o(i.____hardfp_tan$lsc) refers to tan_i.o(i.__kernel_tan) for __kernel_tan
+    tan_x.o(i.____softfp_tan$lsc) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    tan_x.o(i.____softfp_tan$lsc) refers to _rserrno.o(.text) for __set_errno
+    tan_x.o(i.____softfp_tan$lsc) refers to dunder.o(i.__mathlib_dbl_infnan) for __mathlib_dbl_infnan
+    tan_x.o(i.____softfp_tan$lsc) refers to rred.o(i.__ieee754_rem_pio2) for __ieee754_rem_pio2
+    tan_x.o(i.____softfp_tan$lsc) refers to tan_i.o(i.__kernel_tan) for __kernel_tan
+    tan_x.o(i.__tan$lsc) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    tan_x.o(i.__tan$lsc) refers to _rserrno.o(.text) for __set_errno
+    tan_x.o(i.__tan$lsc) refers to dunder.o(i.__mathlib_dbl_infnan) for __mathlib_dbl_infnan
+    tan_x.o(i.__tan$lsc) refers to rred.o(i.__ieee754_rem_pio2) for __ieee754_rem_pio2
+    tan_x.o(i.__tan$lsc) refers to tan_i.o(i.__kernel_tan) for __kernel_tan
+    __rtentry.o(.ARM.Collect$$rtentry$$00000000) refers (Special) to __rtentry2.o(.ARM.Collect$$rtentry$$0000000A) for __rt_entry_li
+    __rtentry.o(.ARM.Collect$$rtentry$$00000000) refers (Special) to __rtentry2.o(.ARM.Collect$$rtentry$$0000000D) for __rt_entry_main
+    __rtentry.o(.ARM.Collect$$rtentry$$00000000) refers (Special) to __rtentry2.o(.ARM.Collect$$rtentry$$0000000C) for __rt_entry_postli_1
+    __rtentry.o(.ARM.Collect$$rtentry$$00000000) refers (Special) to __rtentry2.o(.ARM.Collect$$rtentry$$00000009) for __rt_entry_postsh_1
+    __rtentry.o(.ARM.Collect$$rtentry$$00000000) refers (Special) to __rtentry2.o(.ARM.Collect$$rtentry$$00000002) for __rt_entry_presh_1
+    __rtentry.o(.ARM.Collect$$rtentry$$00000000) refers (Special) to __rtentry4.o(.ARM.Collect$$rtentry$$00000004) for __rt_entry_sh
+    _rserrno.o(.text) refers to rt_errno_addr_intlibspace.o(.text) for __aeabi_errno_addr
+    _printf_char_common.o(.text) refers to __printf.o(.text) for __printf
+    _printf_char.o(.text) refers (Weak) to _printf_str.o(.text) for _printf_str
+    _printf_char_file.o(.text) refers to _printf_char_common.o(.text) for _printf_char_common
+    _printf_char_file.o(.text) refers to ferror.o(.text) for ferror
+    _printf_char_file.o(.text) refers to usart.o(i.fputc) for fputc
+    dleqf.o(x$fpl$dleqf) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    dleqf.o(x$fpl$dleqf) refers to dnaninf.o(x$fpl$dnaninf) for __fpl_dnaninf
+    dleqf.o(x$fpl$dleqf) refers to dcmpi.o(x$fpl$dcmpinf) for __fpl_dcmp_Inf
+    dnaninf.o(x$fpl$dnaninf) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    dretinf.o(x$fpl$dretinf) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    drleqf.o(x$fpl$drleqf) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    drleqf.o(x$fpl$drleqf) refers to dleqf.o(x$fpl$dleqf) for __fpl_dcmple_InfNaN
+    dsqrt_umaal.o(x$fpl$dsqrt) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    dsqrt_umaal.o(x$fpl$dsqrt) refers to dnaninf.o(x$fpl$dnaninf) for __fpl_dnaninf
+    fnaninf.o(x$fpl$fnaninf) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    fretinf.o(x$fpl$fretinf) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    scalbn.o(x$fpl$scalbn) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    scalbn.o(x$fpl$scalbn) refers to dcheck1.o(x$fpl$dcheck1) for __fpl_dcheck_NaN1
+    dunder.o(i.__mathlib_dbl_divzero) refers to ddiv.o(x$fpl$ddiv) for __aeabi_ddiv
+    dunder.o(i.__mathlib_dbl_infnan) refers to daddsub_clz.o(x$fpl$dadd) for __aeabi_dadd
+    dunder.o(i.__mathlib_dbl_infnan2) refers to daddsub_clz.o(x$fpl$dadd) for __aeabi_dadd
+    dunder.o(i.__mathlib_dbl_invalid) refers to ddiv.o(x$fpl$ddiv) for __aeabi_ddiv
+    dunder.o(i.__mathlib_dbl_overflow) refers to dmul.o(x$fpl$dmul) for __aeabi_dmul
+    dunder.o(i.__mathlib_dbl_posinfnan) refers to dmul.o(x$fpl$dmul) for __aeabi_dmul
+    dunder.o(i.__mathlib_dbl_underflow) refers to dmul.o(x$fpl$dmul) for __aeabi_dmul
+    fabs.o(i.__hardfp_fabs) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    fabs.o(i.__softfp_fabs) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    fabs.o(i.fabs) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    fpclassify.o(i.__ARM_fpclassify) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    poly.o(i.__kernel_poly) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    poly.o(i.__kernel_poly) refers to dmul.o(x$fpl$dmul) for __aeabi_dmul
+    poly.o(i.__kernel_poly) refers to daddsub_clz.o(x$fpl$dadd) for __aeabi_dadd
+    qnan.o(.constdata) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    rred.o(i.__ieee754_rem_pio2) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    rred.o(i.__ieee754_rem_pio2) refers to daddsub_clz.o(x$fpl$dsub) for __aeabi_dsub
+    rred.o(i.__ieee754_rem_pio2) refers to daddsub_clz.o(x$fpl$dadd) for __aeabi_dadd
+    rred.o(i.__ieee754_rem_pio2) refers to fabs.o(i.fabs) for fabs
+    rred.o(i.__ieee754_rem_pio2) refers to dmul.o(x$fpl$dmul) for __aeabi_dmul
+    rred.o(i.__ieee754_rem_pio2) refers to dfix.o(x$fpl$dfix) for __aeabi_d2iz
+    rred.o(i.__ieee754_rem_pio2) refers to dflt_clz.o(x$fpl$dflt) for __aeabi_i2d
+    rred.o(i.__ieee754_rem_pio2) refers to daddsub_clz.o(x$fpl$drsb) for __aeabi_drsub
+    rred.o(i.__ieee754_rem_pio2) refers to basic.o(x$fpl$basic) for __aeabi_dneg
+    rred.o(i.__ieee754_rem_pio2) refers to dflt_clz.o(x$fpl$dfltu) for __aeabi_ui2d
+    rred.o(i.__ieee754_rem_pio2) refers to rred.o(.constdata) for .constdata
+    rred.o(i.__use_accurate_range_reduction) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    rred.o(.constdata) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    tan_i.o(i.__kernel_tan) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    tan_i.o(i.__kernel_tan) refers to dfix.o(x$fpl$dfix) for __aeabi_d2iz
+    tan_i.o(i.__kernel_tan) refers to basic.o(x$fpl$basic) for __aeabi_dneg
+    tan_i.o(i.__kernel_tan) refers to daddsub_clz.o(x$fpl$drsb) for __aeabi_drsub
+    tan_i.o(i.__kernel_tan) refers to daddsub_clz.o(x$fpl$dsub) for __aeabi_dsub
+    tan_i.o(i.__kernel_tan) refers to daddsub_clz.o(x$fpl$dadd) for __aeabi_dadd
+    tan_i.o(i.__kernel_tan) refers to dmul.o(x$fpl$dmul) for __aeabi_dmul
+    tan_i.o(i.__kernel_tan) refers to poly.o(i.__kernel_poly) for __kernel_poly
+    tan_i.o(i.__kernel_tan) refers to dflt_clz.o(x$fpl$dflt) for __aeabi_i2d
+    tan_i.o(i.__kernel_tan) refers to ddiv.o(x$fpl$ddiv) for __aeabi_ddiv
+    tan_i.o(i.__kernel_tan) refers to fabs.o(i.fabs) for fabs
+    tan_i.o(i.__kernel_tan) refers to fpclassify.o(i.__ARM_fpclassify) for __ARM_fpclassify
+    tan_i.o(i.__kernel_tan) refers to dunder.o(i.__mathlib_dbl_underflow) for __mathlib_dbl_underflow
+    tan_i.o(i.__kernel_tan) refers to tan_i.o(.constdata) for .constdata
+    tan_i.o(.constdata) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    tan_i_x.o(i.____kernel_tan$lsc) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    tan_i_x.o(i.____kernel_tan$lsc) refers to dfix.o(x$fpl$dfix) for __aeabi_d2iz
+    tan_i_x.o(i.____kernel_tan$lsc) refers to basic.o(x$fpl$basic) for __aeabi_dneg
+    tan_i_x.o(i.____kernel_tan$lsc) refers to daddsub_clz.o(x$fpl$drsb) for __aeabi_drsub
+    tan_i_x.o(i.____kernel_tan$lsc) refers to daddsub_clz.o(x$fpl$dsub) for __aeabi_dsub
+    tan_i_x.o(i.____kernel_tan$lsc) refers to daddsub_clz.o(x$fpl$dadd) for __aeabi_dadd
+    tan_i_x.o(i.____kernel_tan$lsc) refers to dmul.o(x$fpl$dmul) for __aeabi_dmul
+    tan_i_x.o(i.____kernel_tan$lsc) refers to poly.o(i.__kernel_poly) for __kernel_poly
+    tan_i_x.o(i.____kernel_tan$lsc) refers to dflt_clz.o(x$fpl$dflt) for __aeabi_i2d
+    tan_i_x.o(i.____kernel_tan$lsc) refers to ddiv.o(x$fpl$ddiv) for __aeabi_ddiv
+    tan_i_x.o(i.____kernel_tan$lsc) refers to fabs.o(i.fabs) for fabs
+    tan_i_x.o(i.____kernel_tan$lsc) refers to tan_i_x.o(.constdata) for .constdata
+    tan_i_x.o(.constdata) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    __rtentry2.o(.ARM.Collect$$rtentry$$00000008) refers to boardinit2.o(.text) for _platform_post_stackheap_init
+    __rtentry2.o(.ARM.Collect$$rtentry$$0000000A) refers to libinit.o(.ARM.Collect$$libinit$$00000000) for __rt_lib_init
+    __rtentry2.o(.ARM.Collect$$rtentry$$0000000B) refers to boardinit3.o(.text) for _platform_post_lib_init
+    __rtentry2.o(.ARM.Collect$$rtentry$$0000000D) refers to main.o(i.main) for main
+    __rtentry2.o(.ARM.Collect$$rtentry$$0000000D) refers to exit.o(.text) for exit
+    __rtentry2.o(.ARM.exidx) refers to __rtentry2.o(.ARM.Collect$$rtentry$$00000001) for .ARM.Collect$$rtentry$$00000001
+    __rtentry2.o(.ARM.exidx) refers to __rtentry2.o(.ARM.Collect$$rtentry$$00000008) for .ARM.Collect$$rtentry$$00000008
+    __rtentry2.o(.ARM.exidx) refers to __rtentry2.o(.ARM.Collect$$rtentry$$0000000A) for .ARM.Collect$$rtentry$$0000000A
+    __rtentry2.o(.ARM.exidx) refers to __rtentry2.o(.ARM.Collect$$rtentry$$0000000B) for .ARM.Collect$$rtentry$$0000000B
+    __rtentry2.o(.ARM.exidx) refers to __rtentry2.o(.ARM.Collect$$rtentry$$0000000D) for .ARM.Collect$$rtentry$$0000000D
+    __rtentry4.o(.ARM.Collect$$rtentry$$00000004) refers to sys_stackheap_outer.o(.text) for __user_setup_stackheap
+    __rtentry4.o(.ARM.exidx) refers to __rtentry4.o(.ARM.Collect$$rtentry$$00000004) for .ARM.Collect$$rtentry$$00000004
+    rt_errno_addr.o(.text) refers to rt_errno_addr.o(.bss) for __aeabi_errno_addr_data
+    rt_errno_addr_intlibspace.o(.text) refers to libspace.o(.bss) for __libspace_start
+    dcheck1.o(x$fpl$dcheck1) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    dcheck1.o(x$fpl$dcheck1) refers to retnan.o(x$fpl$retnan) for __fpl_return_NaN
+    dcmpi.o(x$fpl$dcmpinf) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    libspace.o(.text) refers to libspace.o(.bss) for __libspace_start
+    sys_stackheap_outer.o(.text) refers to libspace.o(.text) for __user_perproc_libspace
+    sys_stackheap_outer.o(.text) refers to startup_stm32f40_41xxx.o(.text) for __user_initial_stackheap
+    exit.o(.text) refers to rtexit.o(.ARM.Collect$$rtexit$$00000000) for __rt_exit
+    libinit.o(.ARM.Collect$$libinit$$00000000) refers (Special) to libinit2.o(.ARM.Collect$$libinit$$0000002E) for __rt_lib_init_alloca_1
+    libinit.o(.ARM.Collect$$libinit$$00000000) refers (Special) to libinit2.o(.ARM.Collect$$libinit$$0000002C) for __rt_lib_init_argv_1
+    libinit.o(.ARM.Collect$$libinit$$00000000) refers (Special) to libinit2.o(.ARM.Collect$$libinit$$0000001B) for __rt_lib_init_atexit_1
+    libinit.o(.ARM.Collect$$libinit$$00000000) refers (Special) to libinit2.o(.ARM.Collect$$libinit$$00000021) for __rt_lib_init_clock_1
+    libinit.o(.ARM.Collect$$libinit$$00000000) refers (Special) to libinit2.o(.ARM.Collect$$libinit$$00000032) for __rt_lib_init_cpp_1
+    libinit.o(.ARM.Collect$$libinit$$00000000) refers (Special) to libinit2.o(.ARM.Collect$$libinit$$00000030) for __rt_lib_init_exceptions_1
+    libinit.o(.ARM.Collect$$libinit$$00000000) refers (Special) to libinit2.o(.ARM.Collect$$libinit$$00000001) for __rt_lib_init_fp_1
+    libinit.o(.ARM.Collect$$libinit$$00000000) refers (Special) to libinit2.o(.ARM.Collect$$libinit$$0000001F) for __rt_lib_init_fp_trap_1
+    libinit.o(.ARM.Collect$$libinit$$00000000) refers (Special) to libinit2.o(.ARM.Collect$$libinit$$00000023) for __rt_lib_init_getenv_1
+    libinit.o(.ARM.Collect$$libinit$$00000000) refers (Special) to libinit2.o(.ARM.Collect$$libinit$$0000000A) for __rt_lib_init_heap_1
+    libinit.o(.ARM.Collect$$libinit$$00000000) refers (Special) to libinit2.o(.ARM.Collect$$libinit$$00000011) for __rt_lib_init_lc_collate_1
+    libinit.o(.ARM.Collect$$libinit$$00000000) refers (Special) to libinit2.o(.ARM.Collect$$libinit$$00000013) for __rt_lib_init_lc_ctype_1
+    libinit.o(.ARM.Collect$$libinit$$00000000) refers (Special) to libinit2.o(.ARM.Collect$$libinit$$00000015) for __rt_lib_init_lc_monetary_1
+    libinit.o(.ARM.Collect$$libinit$$00000000) refers (Special) to libinit2.o(.ARM.Collect$$libinit$$00000017) for __rt_lib_init_lc_numeric_1
+    libinit.o(.ARM.Collect$$libinit$$00000000) refers (Special) to libinit2.o(.ARM.Collect$$libinit$$00000019) for __rt_lib_init_lc_time_1
+    libinit.o(.ARM.Collect$$libinit$$00000000) refers (Special) to libinit2.o(.ARM.Collect$$libinit$$00000004) for __rt_lib_init_preinit_1
+    libinit.o(.ARM.Collect$$libinit$$00000000) refers (Special) to libinit2.o(.ARM.Collect$$libinit$$0000000E) for __rt_lib_init_rand_1
+    libinit.o(.ARM.Collect$$libinit$$00000000) refers (Special) to libinit2.o(.ARM.Collect$$libinit$$00000033) for __rt_lib_init_return
+    libinit.o(.ARM.Collect$$libinit$$00000000) refers (Special) to libinit2.o(.ARM.Collect$$libinit$$0000001D) for __rt_lib_init_signal_1
+    libinit.o(.ARM.Collect$$libinit$$00000000) refers (Special) to libinit2.o(.ARM.Collect$$libinit$$00000025) for __rt_lib_init_stdio_1
+    libinit.o(.ARM.Collect$$libinit$$00000000) refers (Special) to libinit2.o(.ARM.Collect$$libinit$$0000000C) for __rt_lib_init_user_alloc_1
+    retnan.o(x$fpl$retnan) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    retnan.o(x$fpl$retnan) refers to trapv.o(x$fpl$trapveneer) for __fpl_cmpreturn
+    rtexit.o(.ARM.Collect$$rtexit$$00000000) refers (Special) to rtexit2.o(.ARM.Collect$$rtexit$$00000004) for __rt_exit_exit
+    rtexit.o(.ARM.Collect$$rtexit$$00000000) refers (Special) to rtexit2.o(.ARM.Collect$$rtexit$$00000003) for __rt_exit_ls
+    rtexit.o(.ARM.Collect$$rtexit$$00000000) refers (Special) to rtexit2.o(.ARM.Collect$$rtexit$$00000002) for __rt_exit_prels_1
+    rtexit.o(.ARM.exidx) refers (Special) to rtexit2.o(.ARM.Collect$$rtexit$$00000004) for __rt_exit_exit
+    rtexit.o(.ARM.exidx) refers (Special) to rtexit2.o(.ARM.Collect$$rtexit$$00000003) for __rt_exit_ls
+    rtexit.o(.ARM.exidx) refers (Special) to rtexit2.o(.ARM.Collect$$rtexit$$00000002) for __rt_exit_prels_1
+    rtexit.o(.ARM.exidx) refers to rtexit.o(.ARM.Collect$$rtexit$$00000000) for .ARM.Collect$$rtexit$$00000000
+    libinit2.o(.ARM.Collect$$libinit$$00000001) refers to fpinit.o(x$fpl$fpinit) for _fp_init
+    libinit2.o(.ARM.Collect$$libinit$$00000010) refers to libinit2.o(.ARM.Collect$$libinit$$0000000F) for .ARM.Collect$$libinit$$0000000F
+    libinit2.o(.ARM.Collect$$libinit$$00000012) refers to libinit2.o(.ARM.Collect$$libinit$$0000000F) for .ARM.Collect$$libinit$$0000000F
+    libinit2.o(.ARM.Collect$$libinit$$00000014) refers to libinit2.o(.ARM.Collect$$libinit$$0000000F) for .ARM.Collect$$libinit$$0000000F
+    libinit2.o(.ARM.Collect$$libinit$$00000016) refers to libinit2.o(.ARM.Collect$$libinit$$0000000F) for .ARM.Collect$$libinit$$0000000F
+    libinit2.o(.ARM.Collect$$libinit$$00000018) refers to libinit2.o(.ARM.Collect$$libinit$$0000000F) for .ARM.Collect$$libinit$$0000000F
+    libinit2.o(.ARM.Collect$$libinit$$00000026) refers to argv_veneer.o(.emb_text) for __ARM_argv_veneer
+    libinit2.o(.ARM.Collect$$libinit$$00000027) refers to argv_veneer.o(.emb_text) for __ARM_argv_veneer
+    trapv.o(x$fpl$trapveneer) refers (Special) to usenofp.o(x$fpl$usenofp) for __I$use$fp
+    rtexit2.o(.ARM.Collect$$rtexit$$00000003) refers to libshutdown.o(.ARM.Collect$$libshutdown$$00000000) for __rt_lib_shutdown
+    rtexit2.o(.ARM.Collect$$rtexit$$00000004) refers to usart.o(i._sys_exit) for _sys_exit
+    rtexit2.o(.ARM.exidx) refers to rtexit2.o(.ARM.Collect$$rtexit$$00000001) for .ARM.Collect$$rtexit$$00000001
+    rtexit2.o(.ARM.exidx) refers to rtexit2.o(.ARM.Collect$$rtexit$$00000003) for .ARM.Collect$$rtexit$$00000003
+    rtexit2.o(.ARM.exidx) refers to rtexit2.o(.ARM.Collect$$rtexit$$00000004) for .ARM.Collect$$rtexit$$00000004
+    argv_veneer.o(.emb_text) refers to no_argv.o(.text) for __ARM_get_argv
+    _get_argv_nomalloc.o(.text) refers (Special) to hrguard.o(.text) for __heap_region$guard
+    _get_argv_nomalloc.o(.text) refers to defsig_rtmem_outer.o(.text) for __rt_SIGRTMEM
+    _get_argv_nomalloc.o(.text) refers to sys_command.o(.text) for _sys_command_string
+    libshutdown.o(.ARM.Collect$$libshutdown$$00000000) refers (Special) to libshutdown2.o(.ARM.Collect$$libshutdown$$00000002) for __rt_lib_shutdown_cpp_1
+    libshutdown.o(.ARM.Collect$$libshutdown$$00000000) refers (Special) to libshutdown2.o(.ARM.Collect$$libshutdown$$00000007) for __rt_lib_shutdown_fp_trap_1
+    libshutdown.o(.ARM.Collect$$libshutdown$$00000000) refers (Special) to libshutdown2.o(.ARM.Collect$$libshutdown$$0000000F) for __rt_lib_shutdown_heap_1
+    libshutdown.o(.ARM.Collect$$libshutdown$$00000000) refers (Special) to libshutdown2.o(.ARM.Collect$$libshutdown$$00000010) for __rt_lib_shutdown_return
+    libshutdown.o(.ARM.Collect$$libshutdown$$00000000) refers (Special) to libshutdown2.o(.ARM.Collect$$libshutdown$$0000000A) for __rt_lib_shutdown_signal_1
+    libshutdown.o(.ARM.Collect$$libshutdown$$00000000) refers (Special) to libshutdown2.o(.ARM.Collect$$libshutdown$$00000004) for __rt_lib_shutdown_stdio_1
+    libshutdown.o(.ARM.Collect$$libshutdown$$00000000) refers (Special) to libshutdown2.o(.ARM.Collect$$libshutdown$$0000000C) for __rt_lib_shutdown_user_alloc_1
+    sys_command.o(.text) refers (Special) to use_no_semi.o(.text) for __I$use$semihosting
+    sys_command.o(.text) refers (Special) to indicate_semi.o(.text) for __semihosting_library_function
+    defsig_rtmem_outer.o(.text) refers to defsig_rtmem_inner.o(.text) for __rt_SIGRTMEM_inner
+    defsig_rtmem_outer.o(.text) refers to defsig_exit.o(.text) for __sig_exit
+    defsig_rtmem_formal.o(.text) refers to rt_raise.o(.text) for __rt_raise
+    rt_raise.o(.text) refers to __raise.o(.text) for __raise
+    rt_raise.o(.text) refers to usart.o(i._sys_exit) for _sys_exit
+    defsig_exit.o(.text) refers to usart.o(i._sys_exit) for _sys_exit
+    defsig_rtmem_inner.o(.text) refers to defsig_general.o(.text) for __default_signal_display
+    __raise.o(.text) refers to defsig.o(CL$$defsig) for __default_signal_handler
+    defsig_general.o(.text) refers to sys_wrch.o(.text) for _ttywrch
+    sys_wrch.o(.text) refers (Special) to use_no_semi.o(.text) for __I$use$semihosting
+    sys_wrch.o(.text) refers (Special) to indicate_semi.o(.text) for __semihosting_library_function
+    defsig.o(CL$$defsig) refers to defsig_rtmem_inner.o(.text) for __rt_SIGRTMEM_inner
+    defsig_abrt_inner.o(.text) refers to defsig_general.o(.text) for __default_signal_display
+    defsig_fpe_inner.o(.text) refers to defsig_general.o(.text) for __default_signal_display
+    defsig_rtred_inner.o(.text) refers to defsig_general.o(.text) for __default_signal_display
+    defsig_stak_inner.o(.text) refers to defsig_general.o(.text) for __default_signal_display
+    defsig_pvfn_inner.o(.text) refers to defsig_general.o(.text) for __default_signal_display
+    defsig_cppl_inner.o(.text) refers to defsig_general.o(.text) for __default_signal_display
+    defsig_segv_inner.o(.text) refers to defsig_general.o(.text) for __default_signal_display
+    defsig_other.o(.text) refers to defsig_general.o(.text) for __default_signal_display
+
+
+==============================================================================
+
+Removing Unused input sections from the image.
+
+    Removing main.o(.rev16_text), (4 bytes).
+    Removing main.o(.revsh_text), (4 bytes).
+    Removing stm32f4xx_it.o(.rev16_text), (4 bytes).
+    Removing stm32f4xx_it.o(.revsh_text), (4 bytes).
+    Removing system_stm32f4xx.o(.rev16_text), (4 bytes).
+    Removing system_stm32f4xx.o(.revsh_text), (4 bytes).
+    Removing system_stm32f4xx.o(i.SystemCoreClockUpdate), (192 bytes).
+    Removing adc.o(.rev16_text), (4 bytes).
+    Removing adc.o(.revsh_text), (4 bytes).
+    Removing adc.o(.constdata), (4 bytes).
+    Removing can.o(.rev16_text), (4 bytes).
+    Removing can.o(.revsh_text), (4 bytes).
+    Removing can.o(i.CAN1_Msg_Pend), (40 bytes).
+    Removing can.o(i.CAN1_Receive_Msg), (66 bytes).
+    Removing can.o(i.CAN1_Send_Msg), (66 bytes).
+    Removing can.o(i.CAN1_Send_MsgTEST), (66 bytes).
+    Removing encoder.o(.rev16_text), (4 bytes).
+    Removing encoder.o(.revsh_text), (4 bytes).
+    Removing key.o(.rev16_text), (4 bytes).
+    Removing key.o(.revsh_text), (4 bytes).
+    Removing key.o(i.Delay_ms), (22 bytes).
+    Removing key.o(i.Long_Press), (84 bytes).
+    Removing key.o(i.click), (48 bytes).
+    Removing key.o(i.click_N_Double), (208 bytes).
+    Removing led.o(.rev16_text), (4 bytes).
+    Removing led.o(.revsh_text), (4 bytes).
+    Removing led.o(i.Led_Flash), (56 bytes).
+    Removing motor.o(.rev16_text), (4 bytes).
+    Removing motor.o(.revsh_text), (4 bytes).
+    Removing oled.o(.rev16_text), (4 bytes).
+    Removing oled.o(.revsh_text), (4 bytes).
+    Removing oled.o(i.OLED_Display_Off), (28 bytes).
+    Removing oled.o(i.OLED_Display_On), (28 bytes).
+    Removing oled.o(i.OLED_Set_Pos), (42 bytes).
+    Removing oled.o(i.OLED_ShowCHinese), (92 bytes).
+    Removing pstwo.o(.rev16_text), (4 bytes).
+    Removing pstwo.o(.revsh_text), (4 bytes).
+    Removing pstwo.o(i.PS2_Receive), (132 bytes).
+    Removing pstwo.o(i.PS2_RedLight), (64 bytes).
+    Removing pstwo.o(i.PS2_Vibration), (96 bytes).
+    Removing pstwo.o(i.PS2_VibrationMode), (68 bytes).
+    Removing timer.o(.rev16_text), (4 bytes).
+    Removing timer.o(.revsh_text), (4 bytes).
+    Removing timer.o(i.TIM8_SERVO_Init), (244 bytes).
+    Removing usartx.o(.rev16_text), (4 bytes).
+    Removing usartx.o(.revsh_text), (4 bytes).
+    Removing usartx.o(i.usart2_send), (28 bytes).
+    Removing delay.o(.rev16_text), (4 bytes).
+    Removing delay.o(.revsh_text), (4 bytes).
+    Removing delay.o(i.delay_xms), (24 bytes).
+    Removing sys.o(.rev16_text), (4 bytes).
+    Removing sys.o(.revsh_text), (4 bytes).
+    Removing sys.o(.emb_text), (16 bytes).
+    Removing usart.o(.rev16_text), (4 bytes).
+    Removing usart.o(.revsh_text), (4 bytes).
+    Removing usart.o(i.uart_init), (172 bytes).
+    Removing usart.o(.bss), (200 bytes).
+    Removing misc.o(.rev16_text), (4 bytes).
+    Removing misc.o(.revsh_text), (4 bytes).
+    Removing misc.o(i.NVIC_SetVectorTable), (20 bytes).
+    Removing misc.o(i.NVIC_SystemLPConfig), (32 bytes).
+    Removing stm32f4xx_gpio.o(.rev16_text), (4 bytes).
+    Removing stm32f4xx_gpio.o(.revsh_text), (4 bytes).
+    Removing stm32f4xx_gpio.o(i.GPIO_DeInit), (312 bytes).
+    Removing stm32f4xx_gpio.o(i.GPIO_PinLockConfig), (34 bytes).
+    Removing stm32f4xx_gpio.o(i.GPIO_ReadInputData), (8 bytes).
+    Removing stm32f4xx_gpio.o(i.GPIO_ReadInputDataBit), (18 bytes).
+    Removing stm32f4xx_gpio.o(i.GPIO_ReadOutputData), (8 bytes).
+    Removing stm32f4xx_gpio.o(i.GPIO_ReadOutputDataBit), (18 bytes).
+    Removing stm32f4xx_gpio.o(i.GPIO_ResetBits), (4 bytes).
+    Removing stm32f4xx_gpio.o(i.GPIO_StructInit), (18 bytes).
+    Removing stm32f4xx_gpio.o(i.GPIO_ToggleBits), (8 bytes).
+    Removing stm32f4xx_gpio.o(i.GPIO_Write), (4 bytes).
+    Removing stm32f4xx_gpio.o(i.GPIO_WriteBit), (10 bytes).
+    Removing stm32f4xx_rcc.o(.rev16_text), (4 bytes).
+    Removing stm32f4xx_rcc.o(.revsh_text), (4 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_AHB1PeriphClockLPModeCmd), (32 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_AHB1PeriphResetCmd), (32 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_AHB2PeriphClockCmd), (32 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_AHB2PeriphClockLPModeCmd), (32 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_AHB2PeriphResetCmd), (32 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_AHB3PeriphClockCmd), (32 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_AHB3PeriphClockLPModeCmd), (32 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_AHB3PeriphResetCmd), (32 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_APB1PeriphClockLPModeCmd), (32 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_APB1PeriphResetCmd), (32 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_APB2PeriphClockLPModeCmd), (32 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_AdjustHSICalibrationValue), (24 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_BackupResetCmd), (12 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_ClearFlag), (20 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_ClearITPendingBit), (12 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_ClockSecuritySystemCmd), (12 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_DeInit), (100 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_GetFlagStatus), (64 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_GetITStatus), (24 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_GetSYSCLKSource), (16 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_HCLKConfig), (24 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_HSEConfig), (16 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_HSICmd), (12 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_I2SCLKConfig), (12 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_ITConfig), (32 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_LSEModeConfig), (36 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_LSICmd), (12 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_LTDCCLKDivConfig), (24 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_MCO1Config), (28 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_MCO2Config), (28 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_PCLK1Config), (24 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_PCLK2Config), (24 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_PLLCmd), (12 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_PLLConfig), (36 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_PLLI2SCmd), (12 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_PLLI2SConfig), (16 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_PLLSAICmd), (12 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_PLLSAIConfig), (24 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_RTCCLKCmd), (12 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_RTCCLKConfig), (60 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_SAIBlockACLKConfig), (24 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_SAIBlockBCLKConfig), (24 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_SAIPLLI2SClkDivConfig), (28 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_SAIPLLSAIClkDivConfig), (28 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_SYSCLKConfig), (24 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_TIMCLKPresConfig), (12 bytes).
+    Removing stm32f4xx_rcc.o(i.RCC_WaitForHSEStartUp), (56 bytes).
+    Removing stm32f4xx_syscfg.o(.rev16_text), (4 bytes).
+    Removing stm32f4xx_syscfg.o(.revsh_text), (4 bytes).
+    Removing stm32f4xx_syscfg.o(i.SYSCFG_CompensationCellCmd), (12 bytes).
+    Removing stm32f4xx_syscfg.o(i.SYSCFG_DeInit), (22 bytes).
+    Removing stm32f4xx_syscfg.o(i.SYSCFG_ETH_MediaInterfaceConfig), (12 bytes).
+    Removing stm32f4xx_syscfg.o(i.SYSCFG_EXTILineConfig), (64 bytes).
+    Removing stm32f4xx_syscfg.o(i.SYSCFG_GetCompensationCellStatus), (24 bytes).
+    Removing stm32f4xx_syscfg.o(i.SYSCFG_MemoryRemapConfig), (12 bytes).
+    Removing stm32f4xx_syscfg.o(i.SYSCFG_MemorySwappingBank), (12 bytes).
+    Removing stm32f4xx_usart.o(.rev16_text), (4 bytes).
+    Removing stm32f4xx_usart.o(.revsh_text), (4 bytes).
+    Removing stm32f4xx_usart.o(i.USART_ClearFlag), (18 bytes).
+    Removing stm32f4xx_usart.o(i.USART_ClearITPendingBit), (30 bytes).
+    Removing stm32f4xx_usart.o(i.USART_ClockInit), (32 bytes).
+    Removing stm32f4xx_usart.o(i.USART_ClockStructInit), (12 bytes).
+    Removing stm32f4xx_usart.o(i.USART_DMACmd), (18 bytes).
+    Removing stm32f4xx_usart.o(i.USART_DeInit), (240 bytes).
+    Removing stm32f4xx_usart.o(i.USART_GetFlagStatus), (26 bytes).
+    Removing stm32f4xx_usart.o(i.USART_HalfDuplexCmd), (24 bytes).
+    Removing stm32f4xx_usart.o(i.USART_IrDACmd), (24 bytes).
+    Removing stm32f4xx_usart.o(i.USART_IrDAConfig), (18 bytes).
+    Removing stm32f4xx_usart.o(i.USART_LINBreakDetectLengthConfig), (18 bytes).
+    Removing stm32f4xx_usart.o(i.USART_LINCmd), (24 bytes).
+    Removing stm32f4xx_usart.o(i.USART_OneBitMethodCmd), (24 bytes).
+    Removing stm32f4xx_usart.o(i.USART_OverSampling8Cmd), (22 bytes).
+    Removing stm32f4xx_usart.o(i.USART_ReceiverWakeUpCmd), (24 bytes).
+    Removing stm32f4xx_usart.o(i.USART_SendBreak), (10 bytes).
+    Removing stm32f4xx_usart.o(i.USART_SendData), (8 bytes).
+    Removing stm32f4xx_usart.o(i.USART_SetAddress), (18 bytes).
+    Removing stm32f4xx_usart.o(i.USART_SetGuardTime), (16 bytes).
+    Removing stm32f4xx_usart.o(i.USART_SetPrescaler), (16 bytes).
+    Removing stm32f4xx_usart.o(i.USART_SmartCardCmd), (24 bytes).
+    Removing stm32f4xx_usart.o(i.USART_SmartCardNACKCmd), (24 bytes).
+    Removing stm32f4xx_usart.o(i.USART_StructInit), (24 bytes).
+    Removing stm32f4xx_usart.o(i.USART_WakeUpConfig), (18 bytes).
+    Removing stm32f4xx_adc.o(.rev16_text), (4 bytes).
+    Removing stm32f4xx_adc.o(.revsh_text), (4 bytes).
+    Removing stm32f4xx_adc.o(i.ADC_AnalogWatchdogCmd), (20 bytes).
+    Removing stm32f4xx_adc.o(i.ADC_AnalogWatchdogSingleChannelConfig), (16 bytes).
+    Removing stm32f4xx_adc.o(i.ADC_AnalogWatchdogThresholdsConfig), (6 bytes).
+    Removing stm32f4xx_adc.o(i.ADC_AutoInjectedConvCmd), (22 bytes).
+    Removing stm32f4xx_adc.o(i.ADC_ClearFlag), (6 bytes).
+    Removing stm32f4xx_adc.o(i.ADC_ClearITPendingBit), (10 bytes).
+    Removing stm32f4xx_adc.o(i.ADC_CommonStructInit), (12 bytes).
+    Removing stm32f4xx_adc.o(i.ADC_ContinuousModeCmd), (22 bytes).
+    Removing stm32f4xx_adc.o(i.ADC_DMACmd), (22 bytes).
+    Removing stm32f4xx_adc.o(i.ADC_DMARequestAfterLastTransferCmd), (22 bytes).
+    Removing stm32f4xx_adc.o(i.ADC_DeInit), (22 bytes).
+    Removing stm32f4xx_adc.o(i.ADC_DiscModeChannelCountConfig), (24 bytes).
+    Removing stm32f4xx_adc.o(i.ADC_DiscModeCmd), (22 bytes).
+    Removing stm32f4xx_adc.o(i.ADC_EOCOnEachRegularChannelCmd), (22 bytes).
+    Removing stm32f4xx_adc.o(i.ADC_ExternalTrigInjectedConvConfig), (16 bytes).
+    Removing stm32f4xx_adc.o(i.ADC_ExternalTrigInjectedConvEdgeConfig), (16 bytes).
+    Removing stm32f4xx_adc.o(i.ADC_GetITStatus), (38 bytes).
+    Removing stm32f4xx_adc.o(i.ADC_GetInjectedConversionValue), (28 bytes).
+    Removing stm32f4xx_adc.o(i.ADC_GetMultiModeConversionValue), (12 bytes).
+    Removing stm32f4xx_adc.o(i.ADC_GetSoftwareStartConvStatus), (20 bytes).
+    Removing stm32f4xx_adc.o(i.ADC_GetSoftwareStartInjectedConvCmdStatus), (20 bytes).
+    Removing stm32f4xx_adc.o(i.ADC_ITConfig), (32 bytes).
+    Removing stm32f4xx_adc.o(i.ADC_InjectedChannelConfig), (130 bytes).
+    Removing stm32f4xx_adc.o(i.ADC_InjectedDiscModeCmd), (22 bytes).
+    Removing stm32f4xx_adc.o(i.ADC_InjectedSequencerLengthConfig), (24 bytes).
+    Removing stm32f4xx_adc.o(i.ADC_MultiModeDMARequestAfterLastTransferCmd), (44 bytes).
+    Removing stm32f4xx_adc.o(i.ADC_SetInjectedOffset), (20 bytes).
+    Removing stm32f4xx_adc.o(i.ADC_SoftwareStartInjectedConv), (10 bytes).
+    Removing stm32f4xx_adc.o(i.ADC_StructInit), (20 bytes).
+    Removing stm32f4xx_adc.o(i.ADC_TempSensorVrefintCmd), (44 bytes).
+    Removing stm32f4xx_adc.o(i.ADC_VBATCmd), (44 bytes).
+    Removing stm32f4xx_can.o(.rev16_text), (4 bytes).
+    Removing stm32f4xx_can.o(.revsh_text), (4 bytes).
+    Removing stm32f4xx_can.o(i.CAN_CancelTransmit), (48 bytes).
+    Removing stm32f4xx_can.o(i.CAN_ClearFlag), (56 bytes).
+    Removing stm32f4xx_can.o(i.CAN_ClearITPendingBit), (168 bytes).
+    Removing stm32f4xx_can.o(i.CAN_DBGFreeze), (22 bytes).
+    Removing stm32f4xx_can.o(i.CAN_DeInit), (56 bytes).
+    Removing stm32f4xx_can.o(i.CAN_FIFORelease), (22 bytes).
+    Removing stm32f4xx_can.o(i.CAN_FilterInit), (264 bytes).
+    Removing stm32f4xx_can.o(i.CAN_GetFlagStatus), (120 bytes).
+    Removing stm32f4xx_can.o(i.CAN_GetITStatus), (288 bytes).
+    Removing stm32f4xx_can.o(i.CAN_GetLSBTransmitErrorCounter), (12 bytes).
+    Removing stm32f4xx_can.o(i.CAN_GetLastErrorCode), (12 bytes).
+    Removing stm32f4xx_can.o(i.CAN_GetReceiveErrorCounter), (10 bytes).
+    Removing stm32f4xx_can.o(i.CAN_Init), (276 bytes).
+    Removing stm32f4xx_can.o(i.CAN_MessagePending), (30 bytes).
+    Removing stm32f4xx_can.o(i.CAN_OperatingModeRequest), (162 bytes).
+    Removing stm32f4xx_can.o(i.CAN_Receive), (240 bytes).
+    Removing stm32f4xx_can.o(i.CAN_SlaveStartBank), (52 bytes).
+    Removing stm32f4xx_can.o(i.CAN_Sleep), (30 bytes).
+    Removing stm32f4xx_can.o(i.CAN_StructInit), (32 bytes).
+    Removing stm32f4xx_can.o(i.CAN_TTComModeCmd), (118 bytes).
+    Removing stm32f4xx_can.o(i.CAN_Transmit), (294 bytes).
+    Removing stm32f4xx_can.o(i.CAN_TransmitStatus), (160 bytes).
+    Removing stm32f4xx_can.o(i.CAN_WakeUp), (48 bytes).
+    Removing stm32f4xx_can.o(i.CheckITStatus), (18 bytes).
+    Removing stm32f4xx_tim.o(.rev16_text), (4 bytes).
+    Removing stm32f4xx_tim.o(.revsh_text), (4 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_BDTRConfig), (32 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_BDTRStructInit), (18 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_CCPreloadControl), (24 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_CCxCmd), (30 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_CCxNCmd), (30 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_ClearOC1Ref), (18 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_ClearOC2Ref), (24 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_ClearOC3Ref), (18 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_ClearOC4Ref), (24 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_CounterModeConfig), (18 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_DMACmd), (18 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_DMAConfig), (10 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_DeInit), (400 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_ETRClockMode1Config), (54 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_ETRClockMode2Config), (32 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_ETRConfig), (28 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_ForcedOC1Config), (18 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_ForcedOC2Config), (26 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_ForcedOC3Config), (18 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_ForcedOC4Config), (26 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_GenerateEvent), (4 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_GetCounter), (6 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_GetFlagStatus), (18 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_GetPrescaler), (6 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_ITRxExternalClockConfig), (24 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_InternalClockConfig), (12 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_OC1FastConfig), (18 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_OC1NPolarityConfig), (18 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_OC2FastConfig), (26 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_OC2NPolarityConfig), (26 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_OC3FastConfig), (18 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_OC3NPolarityConfig), (26 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_OC4FastConfig), (26 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_OCStructInit), (20 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_PWMIConfig), (124 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_PrescalerConfig), (6 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_RemapConfig), (6 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_SelectCCDMA), (24 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_SelectCOM), (24 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_SelectHallSensor), (24 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_SelectInputTrigger), (18 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_SelectMasterSlaveMode), (18 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_SelectOCxM), (86 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_SelectOnePulseMode), (18 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_SelectOutputTrigger), (18 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_SelectSlaveMode), (18 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_SetAutoreload), (4 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_SetClockDivision), (18 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_SetCompare1), (4 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_SetCompare2), (4 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_SetCompare3), (4 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_SetCompare4), (4 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_TIxExternalClockConfig), (62 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_UpdateDisableConfig), (24 bytes).
+    Removing stm32f4xx_tim.o(i.TIM_UpdateRequestConfig), (24 bytes).
+    Removing stm32f4xx_pwr.o(.rev16_text), (4 bytes).
+    Removing stm32f4xx_pwr.o(.revsh_text), (4 bytes).
+    Removing stm32f4xx_pwr.o(i.PWR_BackupRegulatorCmd), (12 bytes).
+    Removing stm32f4xx_pwr.o(i.PWR_ClearFlag), (20 bytes).
+    Removing stm32f4xx_pwr.o(i.PWR_DeInit), (22 bytes).
+    Removing stm32f4xx_pwr.o(i.PWR_EnterSTANDBYMode), (40 bytes).
+    Removing stm32f4xx_pwr.o(i.PWR_EnterSTOPMode), (68 bytes).
+    Removing stm32f4xx_pwr.o(i.PWR_EnterUnderDriveSTOPMode), (68 bytes).
+    Removing stm32f4xx_pwr.o(i.PWR_FlashPowerDownCmd), (12 bytes).
+    Removing stm32f4xx_pwr.o(i.PWR_GetFlagStatus), (24 bytes).
+    Removing stm32f4xx_pwr.o(i.PWR_LowRegulatorLowVoltageCmd), (24 bytes).
+    Removing stm32f4xx_pwr.o(i.PWR_MainRegulatorLowVoltageCmd), (24 bytes).
+    Removing stm32f4xx_pwr.o(i.PWR_MainRegulatorModeConfig), (24 bytes).
+    Removing stm32f4xx_pwr.o(i.PWR_OverDriveCmd), (12 bytes).
+    Removing stm32f4xx_pwr.o(i.PWR_OverDriveSWCmd), (12 bytes).
+    Removing stm32f4xx_pwr.o(i.PWR_PVDCmd), (12 bytes).
+    Removing stm32f4xx_pwr.o(i.PWR_PVDLevelConfig), (24 bytes).
+    Removing stm32f4xx_pwr.o(i.PWR_UnderDriveCmd), (36 bytes).
+    Removing stm32f4xx_pwr.o(i.PWR_WakeUpPinCmd), (12 bytes).
+    Removing croutine.o(.rev16_text), (4 bytes).
+    Removing croutine.o(.revsh_text), (4 bytes).
+    Removing event_groups.o(.rev16_text), (4 bytes).
+    Removing event_groups.o(.revsh_text), (4 bytes).
+    Removing event_groups.o(i.prvTestWaitCondition), (30 bytes).
+    Removing event_groups.o(i.uxEventGroupGetNumber), (14 bytes).
+    Removing event_groups.o(i.vEventGroupClearBitsCallback), (16 bytes).
+    Removing event_groups.o(i.vEventGroupDelete), (116 bytes).
+    Removing event_groups.o(i.vEventGroupSetBitsCallback), (16 bytes).
+    Removing event_groups.o(i.xEventGroupClearBits), (116 bytes).
+    Removing event_groups.o(i.xEventGroupClearBitsFromISR), (28 bytes).
+    Removing event_groups.o(i.xEventGroupCreate), (26 bytes).
+    Removing event_groups.o(i.xEventGroupGetBitsFromISR), (44 bytes).
+    Removing event_groups.o(i.xEventGroupSetBits), (232 bytes).
+    Removing event_groups.o(i.xEventGroupSetBitsFromISR), (36 bytes).
+    Removing event_groups.o(i.xEventGroupSync), (276 bytes).
+    Removing event_groups.o(i.xEventGroupWaitBits), (344 bytes).
+    Removing list.o(.rev16_text), (4 bytes).
+    Removing list.o(.revsh_text), (4 bytes).
+    Removing queue.o(.rev16_text), (4 bytes).
+    Removing queue.o(.revsh_text), (4 bytes).
+    Removing queue.o(i.pcQueueGetName), (44 bytes).
+    Removing queue.o(i.prvInitialiseMutex), (28 bytes).
+    Removing queue.o(i.ucQueueGetQueueType), (8 bytes).
+    Removing queue.o(i.uxQueueGetQueueNumber), (6 bytes).
+    Removing queue.o(i.uxQueueMessagesWaiting), (68 bytes).
+    Removing queue.o(i.uxQueueMessagesWaitingFromISR), (60 bytes).
+    Removing queue.o(i.uxQueueSpacesAvailable), (76 bytes).
+    Removing queue.o(i.vQueueDelete), (72 bytes).
+    Removing queue.o(i.vQueueSetQueueNumber), (4 bytes).
+    Removing queue.o(i.vQueueUnregisterQueue), (48 bytes).
+    Removing queue.o(i.xQueueAddToSet), (38 bytes).
+    Removing queue.o(i.xQueueCreateCountingSemaphore), (108 bytes).
+    Removing queue.o(i.xQueueCreateMutex), (34 bytes).
+    Removing queue.o(i.xQueueCreateSet), (20 bytes).
+    Removing queue.o(i.xQueueGiveFromISR), (252 bytes).
+    Removing queue.o(i.xQueueGiveMutexRecursive), (100 bytes).
+    Removing queue.o(i.xQueueIsQueueEmptyFromISR), (68 bytes).
+    Removing queue.o(i.xQueueIsQueueFullFromISR), (72 bytes).
+    Removing queue.o(i.xQueuePeekFromISR), (184 bytes).
+    Removing queue.o(i.xQueueReceiveFromISR), (220 bytes).
+    Removing queue.o(i.xQueueRemoveFromSet), (48 bytes).
+    Removing queue.o(i.xQueueSelectFromSet), (26 bytes).
+    Removing queue.o(i.xQueueSelectFromSetFromISR), (22 bytes).
+    Removing queue.o(i.xQueueTakeMutexRecursive), (108 bytes).
+    Removing tasks.o(.rev16_text), (4 bytes).
+    Removing tasks.o(.revsh_text), (4 bytes).
+    Removing tasks.o(i.eTaskGetState), (160 bytes).
+    Removing tasks.o(i.pcTaskGetName), (76 bytes).
+    Removing tasks.o(i.prvListTasksWithinSingleList), (106 bytes).
+    Removing tasks.o(i.prvTaskCheckFreeStackSpace), (22 bytes).
+    Removing tasks.o(i.prvTaskIsTaskSuspended), (116 bytes).
+    Removing tasks.o(i.prvWriteNameToBuffer), (42 bytes).
+    Removing tasks.o(i.ulTaskNotifyTake), (116 bytes).
+    Removing tasks.o(i.uxTaskGetNumberOfTasks), (12 bytes).
+    Removing tasks.o(i.uxTaskGetSystemState), (176 bytes).
+    Removing tasks.o(i.uxTaskGetTaskNumber), (14 bytes).
+    Removing tasks.o(i.uxTaskPriorityGet), (36 bytes).
+    Removing tasks.o(i.uxTaskPriorityGetFromISR), (68 bytes).
+    Removing tasks.o(i.uxTaskResetEventItemValue), (28 bytes).
+    Removing tasks.o(i.vTaskEndScheduler), (36 bytes).
+    Removing tasks.o(i.vTaskGetInfo), (120 bytes).
+    Removing tasks.o(i.vTaskList), (224 bytes).
+    Removing tasks.o(i.vTaskNotifyGiveFromISR), (256 bytes).
+    Removing tasks.o(i.vTaskPlaceOnUnorderedEventList), (124 bytes).
+    Removing tasks.o(i.vTaskPrioritySet), (304 bytes).
+    Removing tasks.o(i.vTaskResume), (172 bytes).
+    Removing tasks.o(i.vTaskSetTaskNumber), (8 bytes).
+    Removing tasks.o(i.vTaskSuspend), (256 bytes).
+    Removing tasks.o(i.xTaskGenericNotify), (276 bytes).
+    Removing tasks.o(i.xTaskGenericNotifyFromISR), (340 bytes).
+    Removing tasks.o(i.xTaskGetCurrentTaskHandle), (12 bytes).
+    Removing tasks.o(i.xTaskGetTickCountFromISR), (20 bytes).
+    Removing tasks.o(i.xTaskNotifyStateClear), (52 bytes).
+    Removing tasks.o(i.xTaskNotifyWait), (160 bytes).
+    Removing tasks.o(i.xTaskRemoveFromUnorderedEventList), (192 bytes).
+    Removing tasks.o(i.xTaskResumeFromISR), (204 bytes).
+    Removing timers.o(.rev16_text), (4 bytes).
+    Removing timers.o(.revsh_text), (4 bytes).
+    Removing timers.o(i.pcTimerGetName), (64 bytes).
+    Removing timers.o(i.prvInitialiseNewTimer), (108 bytes).
+    Removing timers.o(i.pvTimerGetTimerID), (76 bytes).
+    Removing timers.o(i.vTimerSetTimerID), (76 bytes).
+    Removing timers.o(i.xTimerCreate), (48 bytes).
+    Removing timers.o(i.xTimerGetExpiryTime), (68 bytes).
+    Removing timers.o(i.xTimerGetPeriod), (64 bytes).
+    Removing timers.o(i.xTimerGetTimerDaemonTaskHandle), (80 bytes).
+    Removing timers.o(i.xTimerIsTimerActive), (88 bytes).
+    Removing timers.o(i.xTimerPendFunctionCall), (112 bytes).
+    Removing timers.o(i.xTimerPendFunctionCallFromISR), (52 bytes).
+    Removing port.o(.rev16_text), (4 bytes).
+    Removing port.o(.revsh_text), (4 bytes).
+    Removing port.o(i.vPortEndScheduler), (100 bytes).
+    Removing heap_4.o(.rev16_text), (4 bytes).
+    Removing heap_4.o(.revsh_text), (4 bytes).
+    Removing heap_4.o(i.vPortInitialiseBlocks), (2 bytes).
+    Removing heap_4.o(i.xPortGetFreeHeapSize), (12 bytes).
+    Removing heap_4.o(i.xPortGetMinimumEverFreeHeapSize), (12 bytes).
+    Removing system.o(.rev16_text), (4 bytes).
+    Removing system.o(.revsh_text), (4 bytes).
+    Removing balance.o(.rev16_text), (4 bytes).
+    Removing balance.o(.revsh_text), (4 bytes).
+    Removing balance.o(i.myabs), (14 bytes).
+    Removing balance.o(i.robot_mode_check), (200 bytes).
+    Removing robot_select_init.o(.rev16_text), (4 bytes).
+    Removing robot_select_init.o(.revsh_text), (4 bytes).
+    Removing show.o(.rev16_text), (4 bytes).
+    Removing show.o(.revsh_text), (4 bytes).
+    Removing mpu6050.o(.rev16_text), (4 bytes).
+    Removing mpu6050.o(.revsh_text), (4 bytes).
+    Removing mpu6050.o(i.MPU6050_getDeviceID), (12 bytes).
+    Removing mpu6050.o(i.MPU6050_newValues), (500 bytes).
+    Removing mpu6050.o(i.MPU6050_setClockSource), (20 bytes).
+    Removing mpu6050.o(i.MPU6050_setI2CBypassEnabled), (18 bytes).
+    Removing mpu6050.o(i.MPU6050_setI2CMasterModeEnabled), (18 bytes).
+    Removing mpu6050.o(i.MPU6050_setSleepEnabled), (18 bytes).
+    Removing mpu6050.o(i.MPU6050_testConnection), (18 bytes).
+    Removing mpu6050.o(i.Read_Temperature), (124 bytes).
+    Removing mpu6050.o(.bss), (146 bytes).
+    Removing i2c.o(.rev16_text), (4 bytes).
+    Removing i2c.o(.revsh_text), (4 bytes).
+    Removing i2c.o(i.I2C_ReadBuff), (106 bytes).
+    Removing i2c.o(i.I2C_WriteBuff), (76 bytes).
+    Removing i2c.o(i.I2C_WriteOneBit), (58 bytes).
+
+417 unused section(s) (total 19494 bytes) removed from the image.
+
+==============================================================================
+
+Image Symbol Table
+
+    Local Symbols
+
+    Symbol Name                              Value     Ov Type        Size  Object(Section)
+
+    ../clib/angel/boardlib.s                 0x00000000   Number         0  boardinit2.o ABSOLUTE
+    ../clib/angel/boardlib.s                 0x00000000   Number         0  boardinit3.o ABSOLUTE
+    ../clib/angel/boardlib.s                 0x00000000   Number         0  boardshut.o ABSOLUTE
+    ../clib/angel/boardlib.s                 0x00000000   Number         0  boardinit1.o ABSOLUTE
+    ../clib/angel/dczerorl2.s                0x00000000   Number         0  __dczerorl2.o ABSOLUTE
+    ../clib/angel/handlers.s                 0x00000000   Number         0  __scatter_zi.o ABSOLUTE
+    ../clib/angel/kernel.s                   0x00000000   Number         0  rtexit.o ABSOLUTE
+    ../clib/angel/kernel.s                   0x00000000   Number         0  rtexit2.o ABSOLUTE
+    ../clib/angel/kernel.s                   0x00000000   Number         0  __rtentry4.o ABSOLUTE
+    ../clib/angel/kernel.s                   0x00000000   Number         0  __rtentry.o ABSOLUTE
+    ../clib/angel/kernel.s                   0x00000000   Number         0  __rtentry2.o ABSOLUTE
+    ../clib/angel/rt.s                       0x00000000   Number         0  rt_raise.o ABSOLUTE
+    ../clib/angel/rt.s                       0x00000000   Number         0  rt_errno_addr_intlibspace.o ABSOLUTE
+    ../clib/angel/rt.s                       0x00000000   Number         0  rt_errno_addr.o ABSOLUTE
+    ../clib/angel/scatter.s                  0x00000000   Number         0  __scatter.o ABSOLUTE
+    ../clib/angel/startup.s                  0x00000000   Number         0  __main.o ABSOLUTE
+    ../clib/angel/sys.s                      0x00000000   Number         0  indicate_semi.o ABSOLUTE
+    ../clib/angel/sys.s                      0x00000000   Number         0  use_no_semi_2.o ABSOLUTE
+    ../clib/angel/sys.s                      0x00000000   Number         0  use_no_semi.o ABSOLUTE
+    ../clib/angel/sys.s                      0x00000000   Number         0  sys_stackheap_outer.o ABSOLUTE
+    ../clib/angel/sys.s                      0x00000000   Number         0  libspace.o ABSOLUTE
+    ../clib/angel/sysapp.c                   0x00000000   Number         0  sys_command.o ABSOLUTE
+    ../clib/angel/sysapp.c                   0x00000000   Number         0  sys_wrch.o ABSOLUTE
+    ../clib/armsys.c                         0x00000000   Number         0  no_argv.o ABSOLUTE
+    ../clib/armsys.c                         0x00000000   Number         0  argv_veneer.o ABSOLUTE
+    ../clib/armsys.c                         0x00000000   Number         0  argv_veneer.o ABSOLUTE
+    ../clib/armsys.c                         0x00000000   Number         0  _get_argv_nomalloc.o ABSOLUTE
+    ../clib/fenv.c                           0x00000000   Number         0  _rserrno.o ABSOLUTE
+    ../clib/heapalloc.c                      0x00000000   Number         0  hrguard.o ABSOLUTE
+    ../clib/heapaux.c                        0x00000000   Number         0  heapauxi.o ABSOLUTE
+    ../clib/libinit.s                        0x00000000   Number         0  libshutdown.o ABSOLUTE
+    ../clib/libinit.s                        0x00000000   Number         0  libinit.o ABSOLUTE
+    ../clib/libinit.s                        0x00000000   Number         0  libinit2.o ABSOLUTE
+    ../clib/libinit.s                        0x00000000   Number         0  libshutdown2.o ABSOLUTE
+    ../clib/memcpset.s                       0x00000000   Number         0  rt_memclr.o ABSOLUTE
+    ../clib/memcpset.s                       0x00000000   Number         0  rt_memcpy_w.o ABSOLUTE
+    ../clib/memcpset.s                       0x00000000   Number         0  rt_memcpy_v6.o ABSOLUTE
+    ../clib/memcpset.s                       0x00000000   Number         0  aeabi_memset.o ABSOLUTE
+    ../clib/memcpset.s                       0x00000000   Number         0  rt_memclr_w.o ABSOLUTE
+    ../clib/printf.c                         0x00000000   Number         0  noretval__2printf.o ABSOLUTE
+    ../clib/printf.c                         0x00000000   Number         0  __2printf.o ABSOLUTE
+    ../clib/printf.c                         0x00000000   Number         0  __2sprintf.o ABSOLUTE
+    ../clib/printf.c                         0x00000000   Number         0  noretval__2sprintf.o ABSOLUTE
+    ../clib/printf.c                         0x00000000   Number         0  __printf.o ABSOLUTE
+    ../clib/printf.c                         0x00000000   Number         0  _printf_str.o ABSOLUTE
+    ../clib/printf.c                         0x00000000   Number         0  _printf_dec.o ABSOLUTE
+    ../clib/printf.c                         0x00000000   Number         0  _printf_char_file.o ABSOLUTE
+    ../clib/printf.c                         0x00000000   Number         0  _printf_char.o ABSOLUTE
+    ../clib/printf.c                         0x00000000   Number         0  _sputc.o ABSOLUTE
+    ../clib/printf.c                         0x00000000   Number         0  _printf_char_common.o ABSOLUTE
+    ../clib/printf.c                         0x00000000   Number         0  _printf_intcommon.o ABSOLUTE
+    ../clib/printf.c                         0x00000000   Number         0  __printf_flags.o ABSOLUTE
+    ../clib/printf.c                         0x00000000   Number         0  __printf_ss.o ABSOLUTE
+    ../clib/printf.c                         0x00000000   Number         0  __printf_flags_ss.o ABSOLUTE
+    ../clib/printf.c                         0x00000000   Number         0  __printf_wp.o ABSOLUTE
+    ../clib/printf.c                         0x00000000   Number         0  __printf_flags_wp.o ABSOLUTE
+    ../clib/printf.c                         0x00000000   Number         0  __printf_ss_wp.o ABSOLUTE
+    ../clib/printf.c                         0x00000000   Number         0  __printf_nopercent.o ABSOLUTE
+    ../clib/printf.c                         0x00000000   Number         0  __printf_flags_ss_wp.o ABSOLUTE
+    ../clib/printf_percent.s                 0x00000000   Number         0  _printf_s.o ABSOLUTE
+    ../clib/printf_percent.s                 0x00000000   Number         0  _printf_c.o ABSOLUTE
+    ../clib/printf_percent.s                 0x00000000   Number         0  _printf_u.o ABSOLUTE
+    ../clib/printf_percent.s                 0x00000000   Number         0  _printf_d.o ABSOLUTE
+    ../clib/printf_percent.s                 0x00000000   Number         0  _printf_percent_end.o ABSOLUTE
+    ../clib/printf_percent.s                 0x00000000   Number         0  _printf_percent.o ABSOLUTE
+    ../clib/signal.c                         0x00000000   Number         0  defsig_stak_inner.o ABSOLUTE
+    ../clib/signal.c                         0x00000000   Number         0  defsig_fpe_inner.o ABSOLUTE
+    ../clib/signal.c                         0x00000000   Number         0  defsig_abrt_inner.o ABSOLUTE
+    ../clib/signal.c                         0x00000000   Number         0  defsig_other.o ABSOLUTE
+    ../clib/signal.c                         0x00000000   Number         0  defsig_segv_inner.o ABSOLUTE
+    ../clib/signal.c                         0x00000000   Number         0  defsig_rtmem_outer.o ABSOLUTE
+    ../clib/signal.c                         0x00000000   Number         0  defsig_rtmem_formal.o ABSOLUTE
+    ../clib/signal.c                         0x00000000   Number         0  defsig_cppl_inner.o ABSOLUTE
+    ../clib/signal.c                         0x00000000   Number         0  defsig_exit.o ABSOLUTE
+    ../clib/signal.c                         0x00000000   Number         0  defsig_rtred_inner.o ABSOLUTE
+    ../clib/signal.c                         0x00000000   Number         0  defsig_rtmem_inner.o ABSOLUTE
+    ../clib/signal.c                         0x00000000   Number         0  __raise.o ABSOLUTE
+    ../clib/signal.c                         0x00000000   Number         0  defsig_general.o ABSOLUTE
+    ../clib/signal.c                         0x00000000   Number         0  defsig_pvfn_inner.o ABSOLUTE
+    ../clib/signal.s                         0x00000000   Number         0  defsig.o ABSOLUTE
+    ../clib/stdio.c                          0x00000000   Number         0  ferror_locked.o ABSOLUTE
+    ../clib/stdio.c                          0x00000000   Number         0  ferror.o ABSOLUTE
+    ../clib/stdlib.c                         0x00000000   Number         0  exit.o ABSOLUTE
+    ../clib/string.c                         0x00000000   Number         0  strlen.o ABSOLUTE
+    ../clib/string.c                         0x00000000   Number         0  strcpy.o ABSOLUTE
+    ../fplib/basic.s                         0x00000000   Number         0  basic.o ABSOLUTE
+    ../fplib/d2f.s                           0x00000000   Number         0  d2f.o ABSOLUTE
+    ../fplib/daddsub.s                       0x00000000   Number         0  daddsub_clz.o ABSOLUTE
+    ../fplib/dcheck1.s                       0x00000000   Number         0  dcheck1.o ABSOLUTE
+    ../fplib/dcmpi.s                         0x00000000   Number         0  dcmpi.o ABSOLUTE
+    ../fplib/ddiv.s                          0x00000000   Number         0  ddiv.o ABSOLUTE
+    ../fplib/dfix.s                          0x00000000   Number         0  dfix.o ABSOLUTE
+    ../fplib/dflt.s                          0x00000000   Number         0  dflt_clz.o ABSOLUTE
+    ../fplib/dleqf.s                         0x00000000   Number         0  dleqf.o ABSOLUTE
+    ../fplib/dmul.s                          0x00000000   Number         0  dmul.o ABSOLUTE
+    ../fplib/dnaninf.s                       0x00000000   Number         0  dnaninf.o ABSOLUTE
+    ../fplib/dretinf.s                       0x00000000   Number         0  dretinf.o ABSOLUTE
+    ../fplib/drleqf.s                        0x00000000   Number         0  drleqf.o ABSOLUTE
+    ../fplib/dsqrt.s                         0x00000000   Number         0  dsqrt_umaal.o ABSOLUTE
+    ../fplib/f2d.s                           0x00000000   Number         0  f2d.o ABSOLUTE
+    ../fplib/fnaninf.s                       0x00000000   Number         0  fnaninf.o ABSOLUTE
+    ../fplib/fpinit.s                        0x00000000   Number         0  fpinit.o ABSOLUTE
+    ../fplib/fretinf.s                       0x00000000   Number         0  fretinf.o ABSOLUTE
+    ../fplib/retnan.s                        0x00000000   Number         0  retnan.o ABSOLUTE
+    ../fplib/scalbn.s                        0x00000000   Number         0  scalbn.o ABSOLUTE
+    ../fplib/trapv.s                         0x00000000   Number         0  trapv.o ABSOLUTE
+    ../fplib/usenofp.s                       0x00000000   Number         0  usenofp.o ABSOLUTE
+    ../mathlib/atan.c                        0x00000000   Number         0  atan.o ABSOLUTE
+    ../mathlib/atan.c                        0x00000000   Number         0  atan_x.o ABSOLUTE
+    ../mathlib/dunder.c                      0x00000000   Number         0  dunder.o ABSOLUTE
+    ../mathlib/fabs.c                        0x00000000   Number         0  fabs.o ABSOLUTE
+    ../mathlib/fpclassify.c                  0x00000000   Number         0  fpclassify.o ABSOLUTE
+    ../mathlib/poly.c                        0x00000000   Number         0  poly.o ABSOLUTE
+    ../mathlib/pow.c                         0x00000000   Number         0  pow.o ABSOLUTE
+    ../mathlib/pow.c                         0x00000000   Number         0  pow_x.o ABSOLUTE
+    ../mathlib/qnan.c                        0x00000000   Number         0  qnan.o ABSOLUTE
+    ../mathlib/rred.c                        0x00000000   Number         0  rred.o ABSOLUTE
+    ../mathlib/sqrt.c                        0x00000000   Number         0  sqrt_x.o ABSOLUTE
+    ../mathlib/sqrt.c                        0x00000000   Number         0  sqrt.o ABSOLUTE
+    ../mathlib/tan.c                         0x00000000   Number         0  tan.o ABSOLUTE
+    ../mathlib/tan.c                         0x00000000   Number         0  tan_x.o ABSOLUTE
+    ../mathlib/tan_i.c                       0x00000000   Number         0  tan_i.o ABSOLUTE
+    ../mathlib/tan_i.c                       0x00000000   Number         0  tan_i_x.o ABSOLUTE
+    ..\BALANCE\balance.c                     0x00000000   Number         0  balance.o ABSOLUTE
+    ..\BALANCE\robot_select_init.c           0x00000000   Number         0  robot_select_init.o ABSOLUTE
+    ..\BALANCE\show.c                        0x00000000   Number         0  show.o ABSOLUTE
+    ..\BALANCE\system.c                      0x00000000   Number         0  system.o ABSOLUTE
+    ..\CORE\startup_stm32f40_41xxx.s         0x00000000   Number         0  startup_stm32f40_41xxx.o ABSOLUTE
+    ..\FWLIB\src\misc.c                      0x00000000   Number         0  misc.o ABSOLUTE
+    ..\FWLIB\src\stm32f4xx_adc.c             0x00000000   Number         0  stm32f4xx_adc.o ABSOLUTE
+    ..\FWLIB\src\stm32f4xx_can.c             0x00000000   Number         0  stm32f4xx_can.o ABSOLUTE
+    ..\FWLIB\src\stm32f4xx_gpio.c            0x00000000   Number         0  stm32f4xx_gpio.o ABSOLUTE
+    ..\FWLIB\src\stm32f4xx_pwr.c             0x00000000   Number         0  stm32f4xx_pwr.o ABSOLUTE
+    ..\FWLIB\src\stm32f4xx_rcc.c             0x00000000   Number         0  stm32f4xx_rcc.o ABSOLUTE
+    ..\FWLIB\src\stm32f4xx_syscfg.c          0x00000000   Number         0  stm32f4xx_syscfg.o ABSOLUTE
+    ..\FWLIB\src\stm32f4xx_tim.c             0x00000000   Number         0  stm32f4xx_tim.o ABSOLUTE
+    ..\FWLIB\src\stm32f4xx_usart.c           0x00000000   Number         0  stm32f4xx_usart.o ABSOLUTE
+    ..\FreeRTOS\croutine.c                   0x00000000   Number         0  croutine.o ABSOLUTE
+    ..\FreeRTOS\event_groups.c               0x00000000   Number         0  event_groups.o ABSOLUTE
+    ..\FreeRTOS\list.c                       0x00000000   Number         0  list.o ABSOLUTE
+    ..\FreeRTOS\portable\MemMang\heap_4.c    0x00000000   Number         0  heap_4.o ABSOLUTE
+    ..\FreeRTOS\portable\RVDS\ARM_CM4F\port.c 0x00000000   Number         0  port.o ABSOLUTE
+    ..\FreeRTOS\queue.c                      0x00000000   Number         0  queue.o ABSOLUTE
+    ..\FreeRTOS\tasks.c                      0x00000000   Number         0  tasks.o ABSOLUTE
+    ..\FreeRTOS\timers.c                     0x00000000   Number         0  timers.o ABSOLUTE
+    ..\HARDWARE\LED.C                        0x00000000   Number         0  led.o ABSOLUTE
+    ..\HARDWARE\MPU6050\I2C.c                0x00000000   Number         0  i2c.o ABSOLUTE
+    ..\HARDWARE\MPU6050\MPU6050.c            0x00000000   Number         0  mpu6050.o ABSOLUTE
+    ..\HARDWARE\adc.c                        0x00000000   Number         0  adc.o ABSOLUTE
+    ..\HARDWARE\can.c                        0x00000000   Number         0  can.o ABSOLUTE
+    ..\HARDWARE\encoder.c                    0x00000000   Number         0  encoder.o ABSOLUTE
+    ..\HARDWARE\key.c                        0x00000000   Number         0  key.o ABSOLUTE
+    ..\HARDWARE\motor.c                      0x00000000   Number         0  motor.o ABSOLUTE
+    ..\HARDWARE\oled.c                       0x00000000   Number         0  oled.o ABSOLUTE
+    ..\HARDWARE\pstwo.c                      0x00000000   Number         0  pstwo.o ABSOLUTE
+    ..\HARDWARE\timer.c                      0x00000000   Number         0  timer.o ABSOLUTE
+    ..\HARDWARE\usartx.c                     0x00000000   Number         0  usartx.o ABSOLUTE
+    ..\SYSTEM\delay\delay.c                  0x00000000   Number         0  delay.o ABSOLUTE
+    ..\SYSTEM\sys\sys.c                      0x00000000   Number         0  sys.o ABSOLUTE
+    ..\SYSTEM\usart\usart.c                  0x00000000   Number         0  usart.o ABSOLUTE
+    ..\\BALANCE\\balance.c                   0x00000000   Number         0  balance.o ABSOLUTE
+    ..\\BALANCE\\robot_select_init.c         0x00000000   Number         0  robot_select_init.o ABSOLUTE
+    ..\\BALANCE\\show.c                      0x00000000   Number         0  show.o ABSOLUTE
+    ..\\BALANCE\\system.c                    0x00000000   Number         0  system.o ABSOLUTE
+    ..\\FWLIB\\src\\misc.c                   0x00000000   Number         0  misc.o ABSOLUTE
+    ..\\FWLIB\\src\\stm32f4xx_adc.c          0x00000000   Number         0  stm32f4xx_adc.o ABSOLUTE
+    ..\\FWLIB\\src\\stm32f4xx_can.c          0x00000000   Number         0  stm32f4xx_can.o ABSOLUTE
+    ..\\FWLIB\\src\\stm32f4xx_gpio.c         0x00000000   Number         0  stm32f4xx_gpio.o ABSOLUTE
+    ..\\FWLIB\\src\\stm32f4xx_pwr.c          0x00000000   Number         0  stm32f4xx_pwr.o ABSOLUTE
+    ..\\FWLIB\\src\\stm32f4xx_rcc.c          0x00000000   Number         0  stm32f4xx_rcc.o ABSOLUTE
+    ..\\FWLIB\\src\\stm32f4xx_syscfg.c       0x00000000   Number         0  stm32f4xx_syscfg.o ABSOLUTE
+    ..\\FWLIB\\src\\stm32f4xx_tim.c          0x00000000   Number         0  stm32f4xx_tim.o ABSOLUTE
+    ..\\FWLIB\\src\\stm32f4xx_usart.c        0x00000000   Number         0  stm32f4xx_usart.o ABSOLUTE
+    ..\\FreeRTOS\\croutine.c                 0x00000000   Number         0  croutine.o ABSOLUTE
+    ..\\FreeRTOS\\event_groups.c             0x00000000   Number         0  event_groups.o ABSOLUTE
+    ..\\FreeRTOS\\list.c                     0x00000000   Number         0  list.o ABSOLUTE
+    ..\\FreeRTOS\\portable\\MemMang\\heap_4.c 0x00000000   Number         0  heap_4.o ABSOLUTE
+    ..\\FreeRTOS\\portable\\RVDS\\ARM_CM4F\\port.c 0x00000000   Number         0  port.o ABSOLUTE
+    ..\\FreeRTOS\\queue.c                    0x00000000   Number         0  queue.o ABSOLUTE
+    ..\\FreeRTOS\\tasks.c                    0x00000000   Number         0  tasks.o ABSOLUTE
+    ..\\FreeRTOS\\timers.c                   0x00000000   Number         0  timers.o ABSOLUTE
+    ..\\HARDWARE\\LED.C                      0x00000000   Number         0  led.o ABSOLUTE
+    ..\\HARDWARE\\MPU6050\\I2C.c             0x00000000   Number         0  i2c.o ABSOLUTE
+    ..\\HARDWARE\\MPU6050\\MPU6050.c         0x00000000   Number         0  mpu6050.o ABSOLUTE
+    ..\\HARDWARE\\adc.c                      0x00000000   Number         0  adc.o ABSOLUTE
+    ..\\HARDWARE\\can.c                      0x00000000   Number         0  can.o ABSOLUTE
+    ..\\HARDWARE\\encoder.c                  0x00000000   Number         0  encoder.o ABSOLUTE
+    ..\\HARDWARE\\key.c                      0x00000000   Number         0  key.o ABSOLUTE
+    ..\\HARDWARE\\motor.c                    0x00000000   Number         0  motor.o ABSOLUTE
+    ..\\HARDWARE\\oled.c                     0x00000000   Number         0  oled.o ABSOLUTE
+    ..\\HARDWARE\\pstwo.c                    0x00000000   Number         0  pstwo.o ABSOLUTE
+    ..\\HARDWARE\\timer.c                    0x00000000   Number         0  timer.o ABSOLUTE
+    ..\\HARDWARE\\usartx.c                   0x00000000   Number         0  usartx.o ABSOLUTE
+    ..\\SYSTEM\\delay\\delay.c               0x00000000   Number         0  delay.o ABSOLUTE
+    ..\\SYSTEM\\sys\\sys.c                   0x00000000   Number         0  sys.o ABSOLUTE
+    ..\\SYSTEM\\usart\\usart.c               0x00000000   Number         0  usart.o ABSOLUTE
+    dc.s                                     0x00000000   Number         0  dc.o ABSOLUTE
+    main.c                                   0x00000000   Number         0  main.o ABSOLUTE
+    main.c                                   0x00000000   Number         0  main.o ABSOLUTE
+    stm32f4xx_it.c                           0x00000000   Number         0  stm32f4xx_it.o ABSOLUTE
+    stm32f4xx_it.c                           0x00000000   Number         0  stm32f4xx_it.o ABSOLUTE
+    system_stm32f4xx.c                       0x00000000   Number         0  system_stm32f4xx.o ABSOLUTE
+    system_stm32f4xx.c                       0x00000000   Number         0  system_stm32f4xx.o ABSOLUTE
+    RESET                                    0x08000000   Section      392  startup_stm32f40_41xxx.o(RESET)
+    !!!main                                  0x08000188   Section        8  __main.o(!!!main)
+    !!!scatter                               0x08000190   Section       52  __scatter.o(!!!scatter)
+    !!dczerorl2                              0x080001c4   Section       90  __dczerorl2.o(!!dczerorl2)
+    !!handler_zi                             0x08000220   Section       28  __scatter_zi.o(!!handler_zi)
+    .ARM.Collect$$_printf_percent$$00000000  0x0800023c   Section        0  _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000)
+    .ARM.Collect$$_printf_percent$$00000009  0x0800023c   Section        6  _printf_d.o(.ARM.Collect$$_printf_percent$$00000009)
+    .ARM.Collect$$_printf_percent$$00000014  0x08000242   Section        6  _printf_s.o(.ARM.Collect$$_printf_percent$$00000014)
+    .ARM.Collect$$_printf_percent$$00000017  0x08000248   Section        4  _printf_percent_end.o(.ARM.Collect$$_printf_percent$$00000017)
+    .ARM.Collect$$libinit$$00000000          0x0800024c   Section        2  libinit.o(.ARM.Collect$$libinit$$00000000)
+    .ARM.Collect$$libinit$$00000001          0x0800024e   Section        4  libinit2.o(.ARM.Collect$$libinit$$00000001)
+    .ARM.Collect$$libinit$$00000004          0x08000252   Section        0  libinit2.o(.ARM.Collect$$libinit$$00000004)
+    .ARM.Collect$$libinit$$0000000A          0x08000252   Section        0  libinit2.o(.ARM.Collect$$libinit$$0000000A)
+    .ARM.Collect$$libinit$$0000000C          0x08000252   Section        0  libinit2.o(.ARM.Collect$$libinit$$0000000C)
+    .ARM.Collect$$libinit$$0000000E          0x08000252   Section        0  libinit2.o(.ARM.Collect$$libinit$$0000000E)
+    .ARM.Collect$$libinit$$00000011          0x08000252   Section        0  libinit2.o(.ARM.Collect$$libinit$$00000011)
+    .ARM.Collect$$libinit$$00000013          0x08000252   Section        0  libinit2.o(.ARM.Collect$$libinit$$00000013)
+    .ARM.Collect$$libinit$$00000015          0x08000252   Section        0  libinit2.o(.ARM.Collect$$libinit$$00000015)
+    .ARM.Collect$$libinit$$00000017          0x08000252   Section        0  libinit2.o(.ARM.Collect$$libinit$$00000017)
+    .ARM.Collect$$libinit$$00000019          0x08000252   Section        0  libinit2.o(.ARM.Collect$$libinit$$00000019)
+    .ARM.Collect$$libinit$$0000001B          0x08000252   Section        0  libinit2.o(.ARM.Collect$$libinit$$0000001B)
+    .ARM.Collect$$libinit$$0000001D          0x08000252   Section        0  libinit2.o(.ARM.Collect$$libinit$$0000001D)
+    .ARM.Collect$$libinit$$0000001F          0x08000252   Section        0  libinit2.o(.ARM.Collect$$libinit$$0000001F)
+    .ARM.Collect$$libinit$$00000021          0x08000252   Section        0  libinit2.o(.ARM.Collect$$libinit$$00000021)
+    .ARM.Collect$$libinit$$00000023          0x08000252   Section        0  libinit2.o(.ARM.Collect$$libinit$$00000023)
+    .ARM.Collect$$libinit$$00000025          0x08000252   Section        0  libinit2.o(.ARM.Collect$$libinit$$00000025)
+    .ARM.Collect$$libinit$$0000002C          0x08000252   Section        0  libinit2.o(.ARM.Collect$$libinit$$0000002C)
+    .ARM.Collect$$libinit$$0000002E          0x08000252   Section        0  libinit2.o(.ARM.Collect$$libinit$$0000002E)
+    .ARM.Collect$$libinit$$00000030          0x08000252   Section        0  libinit2.o(.ARM.Collect$$libinit$$00000030)
+    .ARM.Collect$$libinit$$00000032          0x08000252   Section        0  libinit2.o(.ARM.Collect$$libinit$$00000032)
+    .ARM.Collect$$libinit$$00000033          0x08000252   Section        2  libinit2.o(.ARM.Collect$$libinit$$00000033)
+    .ARM.Collect$$libshutdown$$00000000      0x08000254   Section        2  libshutdown.o(.ARM.Collect$$libshutdown$$00000000)
+    .ARM.Collect$$libshutdown$$00000002      0x08000256   Section        0  libshutdown2.o(.ARM.Collect$$libshutdown$$00000002)
+    .ARM.Collect$$libshutdown$$00000004      0x08000256   Section        0  libshutdown2.o(.ARM.Collect$$libshutdown$$00000004)
+    .ARM.Collect$$libshutdown$$00000007      0x08000256   Section        0  libshutdown2.o(.ARM.Collect$$libshutdown$$00000007)
+    .ARM.Collect$$libshutdown$$0000000A      0x08000256   Section        0  libshutdown2.o(.ARM.Collect$$libshutdown$$0000000A)
+    .ARM.Collect$$libshutdown$$0000000C      0x08000256   Section        0  libshutdown2.o(.ARM.Collect$$libshutdown$$0000000C)
+    .ARM.Collect$$libshutdown$$0000000F      0x08000256   Section        0  libshutdown2.o(.ARM.Collect$$libshutdown$$0000000F)
+    .ARM.Collect$$libshutdown$$00000010      0x08000256   Section        2  libshutdown2.o(.ARM.Collect$$libshutdown$$00000010)
+    .ARM.Collect$$rtentry$$00000000          0x08000258   Section        0  __rtentry.o(.ARM.Collect$$rtentry$$00000000)
+    .ARM.Collect$$rtentry$$00000002          0x08000258   Section        0  __rtentry2.o(.ARM.Collect$$rtentry$$00000002)
+    .ARM.Collect$$rtentry$$00000004          0x08000258   Section        6  __rtentry4.o(.ARM.Collect$$rtentry$$00000004)
+    .ARM.Collect$$rtentry$$00000009          0x0800025e   Section        0  __rtentry2.o(.ARM.Collect$$rtentry$$00000009)
+    .ARM.Collect$$rtentry$$0000000A          0x0800025e   Section        4  __rtentry2.o(.ARM.Collect$$rtentry$$0000000A)
+    .ARM.Collect$$rtentry$$0000000C          0x08000262   Section        0  __rtentry2.o(.ARM.Collect$$rtentry$$0000000C)
+    .ARM.Collect$$rtentry$$0000000D          0x08000262   Section        8  __rtentry2.o(.ARM.Collect$$rtentry$$0000000D)
+    .ARM.Collect$$rtexit$$00000000           0x0800026a   Section        2  rtexit.o(.ARM.Collect$$rtexit$$00000000)
+    .ARM.Collect$$rtexit$$00000002           0x0800026c   Section        0  rtexit2.o(.ARM.Collect$$rtexit$$00000002)
+    .ARM.Collect$$rtexit$$00000003           0x0800026c   Section        4  rtexit2.o(.ARM.Collect$$rtexit$$00000003)
+    .ARM.Collect$$rtexit$$00000004           0x08000270   Section        6  rtexit2.o(.ARM.Collect$$rtexit$$00000004)
+    .emb_text                                0x08000278   Section      182  port.o(.emb_text)
+    $v0                                      0x08000278   Number         0  port.o(.emb_text)
+    .text                                    0x08000330   Section       64  startup_stm32f40_41xxx.o(.text)
+    $v0                                      0x08000330   Number         0  startup_stm32f40_41xxx.o(.text)
+    .text                                    0x08000370   Section        2  use_no_semi_2.o(.text)
+    .text                                    0x08000374   Section        0  noretval__2printf.o(.text)
+    .text                                    0x0800038c   Section        0  __printf.o(.text)
+    .text                                    0x080003f4   Section        0  _printf_str.o(.text)
+    .text                                    0x08000448   Section        0  _printf_dec.o(.text)
+    .text                                    0x080004c0   Section      138  rt_memcpy_v6.o(.text)
+    .text                                    0x0800054a   Section       16  aeabi_memset.o(.text)
+    .text                                    0x0800055a   Section       68  rt_memclr.o(.text)
+    .text                                    0x0800059e   Section        0  heapauxi.o(.text)
+    .text                                    0x080005a4   Section        2  use_no_semi.o(.text)
+    .text                                    0x080005a6   Section        0  _rserrno.o(.text)
+    .text                                    0x080005bc   Section        0  _printf_intcommon.o(.text)
+    .text                                    0x08000670   Section        0  _printf_char_common.o(.text)
+    _printf_input_char                       0x08000671   Thumb Code    10  _printf_char_common.o(.text)
+    .text                                    0x080006a0   Section        0  _printf_char.o(.text)
+    .text                                    0x080006cc   Section        0  _printf_char_file.o(.text)
+    .text                                    0x080006f0   Section      100  rt_memcpy_w.o(.text)
+    .text                                    0x08000754   Section       78  rt_memclr_w.o(.text)
+    .text                                    0x080007a4   Section        8  rt_errno_addr_intlibspace.o(.text)
+    .text                                    0x080007ac   Section        0  ferror.o(.text)
+    .text                                    0x080007b4   Section        8  libspace.o(.text)
+    .text                                    0x080007bc   Section       74  sys_stackheap_outer.o(.text)
+    .text                                    0x08000806   Section        0  exit.o(.text)
+    i.ADC_Cmd                                0x08000818   Section        0  stm32f4xx_adc.o(i.ADC_Cmd)
+    i.ADC_CommonInit                         0x08000830   Section        0  stm32f4xx_adc.o(i.ADC_CommonInit)
+    i.ADC_GetConversionValue                 0x08000860   Section        0  stm32f4xx_adc.o(i.ADC_GetConversionValue)
+    i.ADC_GetFlagStatus                      0x08000868   Section        0  stm32f4xx_adc.o(i.ADC_GetFlagStatus)
+    i.ADC_Init                               0x0800087c   Section        0  stm32f4xx_adc.o(i.ADC_Init)
+    i.ADC_RegularChannelConfig               0x080008d0   Section        0  stm32f4xx_adc.o(i.ADC_RegularChannelConfig)
+    i.ADC_SoftwareStartConv                  0x08000988   Section        0  stm32f4xx_adc.o(i.ADC_SoftwareStartConv)
+    i.APP_Show                               0x08000994   Section        0  show.o(i.APP_Show)
+    i.Adc_Init                               0x08000ad8   Section        0  adc.o(i.Adc_Init)
+    i.Adc_POWER_Init                         0x08000b5c   Section        0  adc.o(i.Adc_POWER_Init)
+    i.Balance_task                           0x08000be0   Section        0  balance.o(i.Balance_task)
+    i.BusFault_Handler                       0x08000ef4   Section        0  stm32f4xx_it.o(i.BusFault_Handler)
+    i.Buzzer_Init                            0x08000ef8   Section        0  led.o(i.Buzzer_Init)
+    i.CAN1_Mode_Init                         0x08000f30   Section        0  can.o(i.CAN1_Mode_Init)
+    i.CAN1_RX0_IRQHandler                    0x08001124   Section        0  can.o(i.CAN1_RX0_IRQHandler)
+    i.CAN1_Rx_Msg                            0x08001250   Section        0  can.o(i.CAN1_Rx_Msg)
+    i.CAN1_Send_Num                          0x08001328   Section        0  can.o(i.CAN1_Send_Num)
+    i.CAN1_Tx_Msg                            0x08001368   Section        0  can.o(i.CAN1_Tx_Msg)
+    i.CAN1_Tx_Staus                          0x08001474   Section        0  can.o(i.CAN1_Tx_Staus)
+    i.CAN_ITConfig                           0x080014f8   Section        0  stm32f4xx_can.o(i.CAN_ITConfig)
+    i.CAN_SEND                               0x0800150c   Section        0  usartx.o(i.CAN_SEND)
+    i.Check_Sum                              0x08001578   Section        0  usartx.o(i.Check_Sum)
+    i.DebugMon_Handler                       0x080015b4   Section        0  stm32f4xx_it.o(i.DebugMon_Handler)
+    i.Drive_Motor                            0x080015b8   Section        0  balance.o(i.Drive_Motor)
+    i.Enable_Pin                             0x08001dc0   Section        0  motor.o(i.Enable_Pin)
+    i.Encoder_Init_TIM2                      0x08001df0   Section        0  encoder.o(i.Encoder_Init_TIM2)
+    i.Encoder_Init_TIM3                      0x08001ed8   Section        0  encoder.o(i.Encoder_Init_TIM3)
+    i.Encoder_Init_TIM4                      0x08001f94   Section        0  encoder.o(i.Encoder_Init_TIM4)
+    i.Encoder_Init_TIM5                      0x08002050   Section        0  encoder.o(i.Encoder_Init_TIM5)
+    i.GPIO_Init                              0x0800210c   Section        0  stm32f4xx_gpio.o(i.GPIO_Init)
+    i.GPIO_PinAFConfig                       0x0800219c   Section        0  stm32f4xx_gpio.o(i.GPIO_PinAFConfig)
+    i.GPIO_SetBits                           0x080021e2   Section        0  stm32f4xx_gpio.o(i.GPIO_SetBits)
+    i.Get_Adc                                0x080021e8   Section        0  adc.o(i.Get_Adc)
+    i.Get_Adc2                               0x08002218   Section        0  adc.o(i.Get_Adc2)
+    i.Get_RC                                 0x08002248   Section        0  balance.o(i.Get_RC)
+    i.Get_Velocity_Form_Encoder              0x080025e8   Section        0  balance.o(i.Get_Velocity_Form_Encoder)
+    i.Get_adc_Average                        0x080027f0   Section        0  adc.o(i.Get_adc_Average)
+    i.Get_battery_volt                       0x08002820   Section        0  adc.o(i.Get_battery_volt)
+    i.HardFault_Handler                      0x080028c0   Section        0  stm32f4xx_it.o(i.HardFault_Handler)
+    i.I2C_Ack                                0x080028c4   Section        0  i2c.o(i.I2C_Ack)
+    i.I2C_GPIOInit                           0x08002910   Section        0  i2c.o(i.I2C_GPIOInit)
+    i.I2C_NAck                               0x0800295c   Section        0  i2c.o(i.I2C_NAck)
+    i.I2C_ReadByte                           0x080029a8   Section        0  i2c.o(i.I2C_ReadByte)
+    i.I2C_ReadOneByte                        0x08002a18   Section        0  i2c.o(i.I2C_ReadOneByte)
+    i.I2C_Start                              0x08002a58   Section        0  i2c.o(i.I2C_Start)
+    i.I2C_Stop                               0x08002abc   Section        0  i2c.o(i.I2C_Stop)
+    i.I2C_WaiteForAck                        0x08002b04   Section        0  i2c.o(i.I2C_WaiteForAck)
+    i.I2C_WriteBits                          0x08002b68   Section        0  i2c.o(i.I2C_WriteBits)
+    i.I2C_WriteByte                          0x08002bc0   Section        0  i2c.o(i.I2C_WriteByte)
+    i.I2C_WriteOneByte                       0x08002c24   Section        0  i2c.o(i.I2C_WriteOneByte)
+    i.Incremental_PI_A                       0x08002c58   Section        0  balance.o(i.Incremental_PI_A)
+    i.Incremental_PI_B                       0x08002d08   Section        0  balance.o(i.Incremental_PI_B)
+    i.Incremental_PI_C                       0x08002db8   Section        0  balance.o(i.Incremental_PI_C)
+    i.Incremental_PI_D                       0x08002e68   Section        0  balance.o(i.Incremental_PI_D)
+    i.KEY_Init                               0x08002f18   Section        0  key.o(i.KEY_Init)
+    i.Key                                    0x08002f48   Section        0  balance.o(i.Key)
+    i.LED_Init                               0x08002f80   Section        0  led.o(i.LED_Init)
+    i.Limit_Pwm                              0x08002fc0   Section        0  balance.o(i.Limit_Pwm)
+    i.MPU6050_Set_LPF                        0x0800306c   Section        0  mpu6050.o(i.MPU6050_Set_LPF)
+    i.MPU6050_Set_Rate                       0x080030a8   Section        0  mpu6050.o(i.MPU6050_Set_Rate)
+    i.MPU6050_initialize                     0x080030e4   Section        0  mpu6050.o(i.MPU6050_initialize)
+    i.MPU6050_setFullScaleAccelRange         0x0800316c   Section        0  mpu6050.o(i.MPU6050_setFullScaleAccelRange)
+    i.MPU6050_setFullScaleGyroRange          0x08003180   Section        0  mpu6050.o(i.MPU6050_setFullScaleGyroRange)
+    i.MPU6050_task                           0x08003194   Section        0  mpu6050.o(i.MPU6050_task)
+    i.MPU_Get_Accelscope                     0x08003270   Section        0  mpu6050.o(i.MPU_Get_Accelscope)
+    i.MPU_Get_Gyroscope                      0x0800332c   Section        0  mpu6050.o(i.MPU_Get_Gyroscope)
+    i.MemManage_Handler                      0x08003410   Section        0  stm32f4xx_it.o(i.MemManage_Handler)
+    i.NMI_Handler                            0x08003414   Section        0  stm32f4xx_it.o(i.NMI_Handler)
+    i.NVIC_Init                              0x08003418   Section        0  misc.o(i.NVIC_Init)
+    i.NVIC_PriorityGroupConfig               0x08003490   Section        0  misc.o(i.NVIC_PriorityGroupConfig)
+    i.OLED_Clear                             0x080034a4   Section        0  oled.o(i.OLED_Clear)
+    i.OLED_DrawPoint                         0x080034d4   Section        0  oled.o(i.OLED_DrawPoint)
+    i.OLED_Init                              0x0800353c   Section        0  oled.o(i.OLED_Init)
+    i.OLED_Refresh_Gram                      0x08003670   Section        0  oled.o(i.OLED_Refresh_Gram)
+    i.OLED_ShowChar                          0x080036bc   Section        0  oled.o(i.OLED_ShowChar)
+    i.OLED_ShowNumber                        0x08003764   Section        0  oled.o(i.OLED_ShowNumber)
+    i.OLED_ShowString                        0x080037f8   Section        0  oled.o(i.OLED_ShowString)
+    i.OLED_WR_Byte                           0x0800383c   Section        0  oled.o(i.OLED_WR_Byte)
+    i.PS2_AnologData                         0x08003894   Section        0  pstwo.o(i.PS2_AnologData)
+    i.PS2_ClearData                          0x080038a0   Section        0  pstwo.o(i.PS2_ClearData)
+    i.PS2_Cmd                                0x080038b8   Section        0  pstwo.o(i.PS2_Cmd)
+    i.PS2_DataKey                            0x08003948   Section        0  pstwo.o(i.PS2_DataKey)
+    i.PS2_EnterConfing                       0x0800399c   Section        0  pstwo.o(i.PS2_EnterConfing)
+    i.PS2_ExitConfing                        0x080039f8   Section        0  pstwo.o(i.PS2_ExitConfing)
+    i.PS2_Init                               0x08003a54   Section        0  pstwo.o(i.PS2_Init)
+    i.PS2_Read                               0x08003aac   Section        0  pstwo.o(i.PS2_Read)
+    i.PS2_ReadData                           0x08003bb0   Section        0  pstwo.o(i.PS2_ReadData)
+    i.PS2_SetInit                            0x08003c64   Section        0  pstwo.o(i.PS2_SetInit)
+    i.PS2_ShortPoll                          0x08003c80   Section        0  pstwo.o(i.PS2_ShortPoll)
+    i.PS2_TurnOnAnalogMode                   0x08003cc4   Section        0  pstwo.o(i.PS2_TurnOnAnalogMode)
+    i.PS2_control                            0x08003d1c   Section        0  balance.o(i.PS2_control)
+    i.PWR_BackupAccessCmd                    0x08003f7c   Section        0  stm32f4xx_pwr.o(i.PWR_BackupAccessCmd)
+    i.RCC_AHB1PeriphClockCmd                 0x08003f88   Section        0  stm32f4xx_rcc.o(i.RCC_AHB1PeriphClockCmd)
+    i.RCC_APB1PeriphClockCmd                 0x08003fa8   Section        0  stm32f4xx_rcc.o(i.RCC_APB1PeriphClockCmd)
+    i.RCC_APB2PeriphClockCmd                 0x08003fc8   Section        0  stm32f4xx_rcc.o(i.RCC_APB2PeriphClockCmd)
+    i.RCC_APB2PeriphResetCmd                 0x08003fe8   Section        0  stm32f4xx_rcc.o(i.RCC_APB2PeriphResetCmd)
+    i.RCC_GetClocksFreq                      0x08004008   Section        0  stm32f4xx_rcc.o(i.RCC_GetClocksFreq)
+    i.RCC_LSEConfig                          0x080040f0   Section        0  stm32f4xx_rcc.o(i.RCC_LSEConfig)
+    i.Read_Encoder                           0x0800411c   Section        0  encoder.o(i.Read_Encoder)
+    i.Remote_Control                         0x08004180   Section        0  balance.o(i.Remote_Control)
+    i.Robot_Init                             0x080043e4   Section        0  robot_select_init.o(i.Robot_Init)
+    i.Robot_Select                           0x080044a0   Section        0  robot_select_init.o(i.Robot_Select)
+    i.SetSysClock                            0x08004660   Section        0  system_stm32f4xx.o(i.SetSysClock)
+    SetSysClock                              0x08004661   Thumb Code   220  system_stm32f4xx.o(i.SetSysClock)
+    i.Set_Pwm                                0x0800474c   Section        0  balance.o(i.Set_Pwm)
+    i.Smooth_control                         0x080047e8   Section        0  balance.o(i.Smooth_control)
+    i.SysTick_CLKSourceConfig                0x080049a4   Section        0  misc.o(i.SysTick_CLKSourceConfig)
+    i.SysTick_Handler                        0x080049cc   Section        0  delay.o(i.SysTick_Handler)
+    i.SystemInit                             0x080049dc   Section        0  system_stm32f4xx.o(i.SystemInit)
+    i.TI1_Config                             0x08004a44   Section        0  stm32f4xx_tim.o(i.TI1_Config)
+    TI1_Config                               0x08004a45   Thumb Code    58  stm32f4xx_tim.o(i.TI1_Config)
+    i.TI2_Config                             0x08004a7e   Section        0  stm32f4xx_tim.o(i.TI2_Config)
+    TI2_Config                               0x08004a7f   Thumb Code    80  stm32f4xx_tim.o(i.TI2_Config)
+    i.TI3_Config                             0x08004ace   Section        0  stm32f4xx_tim.o(i.TI3_Config)
+    TI3_Config                               0x08004acf   Thumb Code    72  stm32f4xx_tim.o(i.TI3_Config)
+    i.TI4_Config                             0x08004b16   Section        0  stm32f4xx_tim.o(i.TI4_Config)
+    TI4_Config                               0x08004b17   Thumb Code    80  stm32f4xx_tim.o(i.TI4_Config)
+    i.TIM10_PWM_Init                         0x08004b68   Section        0  motor.o(i.TIM10_PWM_Init)
+    i.TIM11_PWM_Init                         0x08004c08   Section        0  motor.o(i.TIM11_PWM_Init)
+    i.TIM12_SERVO_Init                       0x08004cb0   Section        0  timer.o(i.TIM12_SERVO_Init)
+    i.TIM1_PWM_Init                          0x08004d7c   Section        0  motor.o(i.TIM1_PWM_Init)
+    i.TIM2_IRQHandler                        0x08004e74   Section        0  encoder.o(i.TIM2_IRQHandler)
+    i.TIM3_IRQHandler                        0x08004e8c   Section        0  encoder.o(i.TIM3_IRQHandler)
+    i.TIM4_IRQHandler                        0x08004ea4   Section        0  encoder.o(i.TIM4_IRQHandler)
+    i.TIM5_IRQHandler                        0x08004ebc   Section        0  encoder.o(i.TIM5_IRQHandler)
+    i.TIM8_BRK_TIM12_IRQHandler              0x08004ed4   Section        0  encoder.o(i.TIM8_BRK_TIM12_IRQHandler)
+    i.TIM8_CC_IRQHandler                     0x08004eec   Section        0  timer.o(i.TIM8_CC_IRQHandler)
+    i.TIM8_Cap_Init                          0x08005298   Section        0  timer.o(i.TIM8_Cap_Init)
+    i.TIM8_UP_TIM13_IRQHandler               0x080053e8   Section        0  timer.o(i.TIM8_UP_TIM13_IRQHandler)
+    i.TIM9_PWM_Init                          0x080053fc   Section        0  motor.o(i.TIM9_PWM_Init)
+    i.TIM_ARRPreloadConfig                   0x080054b4   Section        0  stm32f4xx_tim.o(i.TIM_ARRPreloadConfig)
+    i.TIM_ClearFlag                          0x080054cc   Section        0  stm32f4xx_tim.o(i.TIM_ClearFlag)
+    i.TIM_ClearITPendingBit                  0x080054d2   Section        0  stm32f4xx_tim.o(i.TIM_ClearITPendingBit)
+    i.TIM_Cmd                                0x080054d8   Section        0  stm32f4xx_tim.o(i.TIM_Cmd)
+    i.TIM_CtrlPWMOutputs                     0x080054f0   Section        0  stm32f4xx_tim.o(i.TIM_CtrlPWMOutputs)
+    i.TIM_EncoderInterfaceConfig             0x0800550e   Section        0  stm32f4xx_tim.o(i.TIM_EncoderInterfaceConfig)
+    i.TIM_GetCapture1                        0x08005550   Section        0  stm32f4xx_tim.o(i.TIM_GetCapture1)
+    i.TIM_GetCapture2                        0x08005556   Section        0  stm32f4xx_tim.o(i.TIM_GetCapture2)
+    i.TIM_GetCapture3                        0x0800555c   Section        0  stm32f4xx_tim.o(i.TIM_GetCapture3)
+    i.TIM_GetCapture4                        0x08005562   Section        0  stm32f4xx_tim.o(i.TIM_GetCapture4)
+    i.TIM_GetITStatus                        0x08005568   Section        0  stm32f4xx_tim.o(i.TIM_GetITStatus)
+    i.TIM_ICInit                             0x0800558a   Section        0  stm32f4xx_tim.o(i.TIM_ICInit)
+    i.TIM_ICStructInit                       0x080055f8   Section        0  stm32f4xx_tim.o(i.TIM_ICStructInit)
+    i.TIM_ITConfig                           0x0800560a   Section        0  stm32f4xx_tim.o(i.TIM_ITConfig)
+    i.TIM_OC1Init                            0x0800561c   Section        0  stm32f4xx_tim.o(i.TIM_OC1Init)
+    i.TIM_OC1PolarityConfig                  0x08005698   Section        0  stm32f4xx_tim.o(i.TIM_OC1PolarityConfig)
+    i.TIM_OC1PreloadConfig                   0x080056aa   Section        0  stm32f4xx_tim.o(i.TIM_OC1PreloadConfig)
+    i.TIM_OC2Init                            0x080056bc   Section        0  stm32f4xx_tim.o(i.TIM_OC2Init)
+    i.TIM_OC2PolarityConfig                  0x08005760   Section        0  stm32f4xx_tim.o(i.TIM_OC2PolarityConfig)
+    i.TIM_OC2PreloadConfig                   0x0800577a   Section        0  stm32f4xx_tim.o(i.TIM_OC2PreloadConfig)
+    i.TIM_OC3Init                            0x08005794   Section        0  stm32f4xx_tim.o(i.TIM_OC3Init)
+    i.TIM_OC3PolarityConfig                  0x08005834   Section        0  stm32f4xx_tim.o(i.TIM_OC3PolarityConfig)
+    i.TIM_OC3PreloadConfig                   0x0800584e   Section        0  stm32f4xx_tim.o(i.TIM_OC3PreloadConfig)
+    i.TIM_OC4Init                            0x08005860   Section        0  stm32f4xx_tim.o(i.TIM_OC4Init)
+    i.TIM_OC4PolarityConfig                  0x080058d8   Section        0  stm32f4xx_tim.o(i.TIM_OC4PolarityConfig)
+    i.TIM_OC4PreloadConfig                   0x080058f2   Section        0  stm32f4xx_tim.o(i.TIM_OC4PreloadConfig)
+    i.TIM_SetCounter                         0x0800590c   Section        0  stm32f4xx_tim.o(i.TIM_SetCounter)
+    i.TIM_SetIC1Prescaler                    0x08005910   Section        0  stm32f4xx_tim.o(i.TIM_SetIC1Prescaler)
+    i.TIM_SetIC2Prescaler                    0x08005922   Section        0  stm32f4xx_tim.o(i.TIM_SetIC2Prescaler)
+    i.TIM_SetIC3Prescaler                    0x0800593c   Section        0  stm32f4xx_tim.o(i.TIM_SetIC3Prescaler)
+    i.TIM_SetIC4Prescaler                    0x0800594e   Section        0  stm32f4xx_tim.o(i.TIM_SetIC4Prescaler)
+    i.TIM_TimeBaseInit                       0x08005968   Section        0  stm32f4xx_tim.o(i.TIM_TimeBaseInit)
+    i.TIM_TimeBaseStructInit                 0x080059ec   Section        0  stm32f4xx_tim.o(i.TIM_TimeBaseStructInit)
+    i.Turn_Off                               0x08005a00   Section        0  balance.o(i.Turn_Off)
+    i.UART5_IRQHandler                       0x08005a50   Section        0  usartx.o(i.UART5_IRQHandler)
+    i.USART1_IRQHandler                      0x08005b80   Section        0  usartx.o(i.USART1_IRQHandler)
+    i.USART1_SEND                            0x08005cd4   Section        0  usartx.o(i.USART1_SEND)
+    i.USART2_IRQHandler                      0x08005cf4   Section        0  usartx.o(i.USART2_IRQHandler)
+    i.USART3_IRQHandler                      0x08005fe4   Section        0  usartx.o(i.USART3_IRQHandler)
+    i.USART3_SEND                            0x08006124   Section        0  usartx.o(i.USART3_SEND)
+    i.USART5_SEND                            0x08006144   Section        0  usartx.o(i.USART5_SEND)
+    i.USART_Cmd                              0x08006164   Section        0  stm32f4xx_usart.o(i.USART_Cmd)
+    i.USART_GetITStatus                      0x0800617c   Section        0  stm32f4xx_usart.o(i.USART_GetITStatus)
+    i.USART_ITConfig                         0x080061d0   Section        0  stm32f4xx_usart.o(i.USART_ITConfig)
+    i.USART_Init                             0x0800621c   Section        0  stm32f4xx_usart.o(i.USART_Init)
+    i.USART_ReceiveData                      0x080062f0   Section        0  stm32f4xx_usart.o(i.USART_ReceiveData)
+    i.UsageFault_Handler                     0x080062fa   Section        0  stm32f4xx_it.o(i.UsageFault_Handler)
+    i.Vz_to_Akm_Angle                        0x08006300   Section        0  usartx.o(i.Vz_to_Akm_Angle)
+    i.XYZ_Target_Speed_transition            0x080063d8   Section        0  usartx.o(i.XYZ_Target_Speed_transition)
+    i.__ARM_fpclassify                       0x08006448   Section        0  fpclassify.o(i.__ARM_fpclassify)
+    i.__hardfp_atan                          0x08006478   Section        0  atan.o(i.__hardfp_atan)
+    i.__hardfp_pow                           0x08006750   Section        0  pow.o(i.__hardfp_pow)
+    i.__hardfp_sqrt                          0x080073a0   Section        0  sqrt.o(i.__hardfp_sqrt)
+    i.__hardfp_tan                           0x08007420   Section        0  tan.o(i.__hardfp_tan)
+    i.__ieee754_rem_pio2                     0x080074a0   Section        0  rred.o(i.__ieee754_rem_pio2)
+    i.__kernel_poly                          0x080078d8   Section        0  poly.o(i.__kernel_poly)
+    i.__kernel_tan                           0x080079d0   Section        0  tan_i.o(i.__kernel_tan)
+    i.__mathlib_dbl_divzero                  0x08007d20   Section        0  dunder.o(i.__mathlib_dbl_divzero)
+    i.__mathlib_dbl_infnan                   0x08007d50   Section        0  dunder.o(i.__mathlib_dbl_infnan)
+    i.__mathlib_dbl_infnan2                  0x08007d64   Section        0  dunder.o(i.__mathlib_dbl_infnan2)
+    i.__mathlib_dbl_invalid                  0x08007d78   Section        0  dunder.o(i.__mathlib_dbl_invalid)
+    i.__mathlib_dbl_overflow                 0x08007d98   Section        0  dunder.o(i.__mathlib_dbl_overflow)
+    i.__mathlib_dbl_underflow                0x08007db8   Section        0  dunder.o(i.__mathlib_dbl_underflow)
+    i._sys_exit                              0x08007dd8   Section        0  usart.o(i._sys_exit)
+    i.click_N_Double_MPU6050                 0x08007ddc   Section        0  key.o(i.click_N_Double_MPU6050)
+    i.data_task                              0x08007eac   Section        0  usartx.o(i.data_task)
+    i.data_transition                        0x08007ed4   Section        0  usartx.o(i.data_transition)
+    i.delay_init                             0x08008424   Section        0  delay.o(i.delay_init)
+    i.delay_ms                               0x08008468   Section        0  delay.o(i.delay_ms)
+    i.delay_us                               0x080084a8   Section        0  delay.o(i.delay_us)
+    i.fabs                                   0x080084f0   Section        0  fabs.o(i.fabs)
+    i.float_abs                              0x08008508   Section        0  balance.o(i.float_abs)
+    i.fputc                                  0x08008524   Section        0  usart.o(i.fputc)
+    i.getSysTickCnt                          0x08008540   Section        0  delay.o(i.getSysTickCnt)
+    i.led_task                               0x0800855c   Section        0  led.o(i.led_task)
+    i.main                                   0x08008580   Section        0  main.o(i.main)
+    i.oled_pow                               0x080085b8   Section        0  oled.o(i.oled_pow)
+    i.oled_show                              0x080085d0   Section        0  show.o(i.oled_show)
+    i.prvAddCurrentTaskToDelayedList         0x080091d4   Section        0  tasks.o(i.prvAddCurrentTaskToDelayedList)
+    prvAddCurrentTaskToDelayedList           0x080091d5   Thumb Code   124  tasks.o(i.prvAddCurrentTaskToDelayedList)
+    i.prvAddNewTaskToReadyList               0x0800926c   Section        0  tasks.o(i.prvAddNewTaskToReadyList)
+    prvAddNewTaskToReadyList                 0x0800926d   Thumb Code   156  tasks.o(i.prvAddNewTaskToReadyList)
+    i.prvCheckForValidListAndQueue           0x08009324   Section        0  timers.o(i.prvCheckForValidListAndQueue)
+    prvCheckForValidListAndQueue             0x08009325   Thumb Code    72  timers.o(i.prvCheckForValidListAndQueue)
+    i.prvCheckTasksWaitingTermination        0x08009388   Section        0  tasks.o(i.prvCheckTasksWaitingTermination)
+    prvCheckTasksWaitingTermination          0x08009389   Thumb Code    86  tasks.o(i.prvCheckTasksWaitingTermination)
+    i.prvCopyDataFromQueue                   0x080093ec   Section        0  queue.o(i.prvCopyDataFromQueue)
+    prvCopyDataFromQueue                     0x080093ed   Thumb Code    42  queue.o(i.prvCopyDataFromQueue)
+    i.prvCopyDataToQueue                     0x08009416   Section        0  queue.o(i.prvCopyDataToQueue)
+    prvCopyDataToQueue                       0x08009417   Thumb Code   124  queue.o(i.prvCopyDataToQueue)
+    i.prvDeleteTCB                           0x08009492   Section        0  tasks.o(i.prvDeleteTCB)
+    prvDeleteTCB                             0x08009493   Thumb Code    18  tasks.o(i.prvDeleteTCB)
+    i.prvGetNextExpireTime                   0x080094a4   Section        0  timers.o(i.prvGetNextExpireTime)
+    prvGetNextExpireTime                     0x080094a5   Thumb Code    36  timers.o(i.prvGetNextExpireTime)
+    i.prvHeapInit                            0x080094cc   Section        0  heap_4.o(i.prvHeapInit)
+    prvHeapInit                              0x080094cd   Thumb Code    98  heap_4.o(i.prvHeapInit)
+    i.prvIdleTask                            0x08009548   Section        0  tasks.o(i.prvIdleTask)
+    prvIdleTask                              0x08009549   Thumb Code    32  tasks.o(i.prvIdleTask)
+    i.prvInitialiseNewQueue                  0x08009570   Section        0  queue.o(i.prvInitialiseNewQueue)
+    prvInitialiseNewQueue                    0x08009571   Thumb Code    46  queue.o(i.prvInitialiseNewQueue)
+    i.prvInitialiseNewTask                   0x080095a0   Section        0  tasks.o(i.prvInitialiseNewTask)
+    prvInitialiseNewTask                     0x080095a1   Thumb Code   170  tasks.o(i.prvInitialiseNewTask)
+    i.prvInitialiseTaskLists                 0x08009670   Section        0  tasks.o(i.prvInitialiseTaskLists)
+    prvInitialiseTaskLists                   0x08009671   Thumb Code    70  tasks.o(i.prvInitialiseTaskLists)
+    i.prvInsertBlockIntoFreeList             0x080096d8   Section        0  heap_4.o(i.prvInsertBlockIntoFreeList)
+    prvInsertBlockIntoFreeList               0x080096d9   Thumb Code    96  heap_4.o(i.prvInsertBlockIntoFreeList)
+    i.prvInsertTimerInActiveList             0x08009740   Section        0  timers.o(i.prvInsertTimerInActiveList)
+    prvInsertTimerInActiveList               0x08009741   Thumb Code    80  timers.o(i.prvInsertTimerInActiveList)
+    i.prvIsQueueEmpty                        0x08009798   Section        0  queue.o(i.prvIsQueueEmpty)
+    prvIsQueueEmpty                          0x08009799   Thumb Code    26  queue.o(i.prvIsQueueEmpty)
+    i.prvIsQueueFull                         0x080097b2   Section        0  queue.o(i.prvIsQueueFull)
+    prvIsQueueFull                           0x080097b3   Thumb Code    30  queue.o(i.prvIsQueueFull)
+    i.prvNotifyQueueSetContainer             0x080097d0   Section        0  queue.o(i.prvNotifyQueueSetContainer)
+    prvNotifyQueueSetContainer               0x080097d1   Thumb Code   124  queue.o(i.prvNotifyQueueSetContainer)
+    i.prvProcessExpiredTimer                 0x08009870   Section        0  timers.o(i.prvProcessExpiredTimer)
+    prvProcessExpiredTimer                   0x08009871   Thumb Code    84  timers.o(i.prvProcessExpiredTimer)
+    i.prvProcessReceivedCommands             0x080098f0   Section        0  timers.o(i.prvProcessReceivedCommands)
+    prvProcessReceivedCommands               0x080098f1   Thumb Code   254  timers.o(i.prvProcessReceivedCommands)
+    i.prvProcessTimerOrBlockTask             0x08009a1c   Section        0  timers.o(i.prvProcessTimerOrBlockTask)
+    prvProcessTimerOrBlockTask               0x08009a1d   Thumb Code   102  timers.o(i.prvProcessTimerOrBlockTask)
+    i.prvResetNextTaskUnblockTime            0x08009a90   Section        0  tasks.o(i.prvResetNextTaskUnblockTime)
+    prvResetNextTaskUnblockTime              0x08009a91   Thumb Code    42  tasks.o(i.prvResetNextTaskUnblockTime)
+    i.prvSampleTimeNow                       0x08009ac4   Section        0  timers.o(i.prvSampleTimeNow)
+    prvSampleTimeNow                         0x08009ac5   Thumb Code    40  timers.o(i.prvSampleTimeNow)
+    i.prvSwitchTimerLists                    0x08009af0   Section        0  timers.o(i.prvSwitchTimerLists)
+    prvSwitchTimerLists                      0x08009af1   Thumb Code   140  timers.o(i.prvSwitchTimerLists)
+    i.prvTaskExitError                       0x08009bac   Section        0  port.o(i.prvTaskExitError)
+    prvTaskExitError                         0x08009bad   Thumb Code    50  port.o(i.prvTaskExitError)
+    i.prvTimerTask                           0x08009c20   Section        0  timers.o(i.prvTimerTask)
+    prvTimerTask                             0x08009c21   Thumb Code    26  timers.o(i.prvTimerTask)
+    i.prvUnlockQueue                         0x08009c3a   Section        0  queue.o(i.prvUnlockQueue)
+    prvUnlockQueue                           0x08009c3b   Thumb Code   146  queue.o(i.prvUnlockQueue)
+    i.pstwo_task                             0x08009ccc   Section        0  pstwo.o(i.pstwo_task)
+    i.pvPortMalloc                           0x08009ce4   Section        0  heap_4.o(i.pvPortMalloc)
+    i.pvTaskIncrementMutexHeldCount          0x08009e38   Section        0  tasks.o(i.pvTaskIncrementMutexHeldCount)
+    i.pxPortInitialiseStack                  0x08009e58   Section        0  port.o(i.pxPortInitialiseStack)
+    i.show_task                              0x08009e84   Section        0  show.o(i.show_task)
+    i.sqrt                                   0x0800a010   Section        0  sqrt.o(i.sqrt)
+    i.start_task                             0x0800a080   Section        0  main.o(i.start_task)
+    i.systemInit                             0x0800a180   Section        0  system.o(i.systemInit)
+    i.target_limit_float                     0x0800a23e   Section        0  balance.o(i.target_limit_float)
+    i.target_limit_int                       0x0800a268   Section        0  balance.o(i.target_limit_int)
+    i.uart1_init                             0x0800a280   Section        0  usartx.o(i.uart1_init)
+    i.uart2_init                             0x0800a330   Section        0  usartx.o(i.uart2_init)
+    i.uart3_init                             0x0800a3e0   Section        0  usartx.o(i.uart3_init)
+    i.uart5_init                             0x0800a490   Section        0  usartx.o(i.uart5_init)
+    i.usart1_send                            0x0800a570   Section        0  usartx.o(i.usart1_send)
+    i.usart3_send                            0x0800a588   Section        0  usartx.o(i.usart3_send)
+    i.usart5_send                            0x0800a5a4   Section        0  usartx.o(i.usart5_send)
+    i.uxListRemove                           0x0800a5bc   Section        0  list.o(i.uxListRemove)
+    i.vListInitialise                        0x0800a5e4   Section        0  list.o(i.vListInitialise)
+    i.vListInitialiseItem                    0x0800a5fe   Section        0  list.o(i.vListInitialiseItem)
+    i.vListInsert                            0x0800a604   Section        0  list.o(i.vListInsert)
+    i.vListInsertEnd                         0x0800a638   Section        0  list.o(i.vListInsertEnd)
+    i.vPortEnterCritical                     0x0800a650   Section        0  port.o(i.vPortEnterCritical)
+    i.vPortExitCritical                      0x0800a6d8   Section        0  port.o(i.vPortExitCritical)
+    i.vPortFree                              0x0800a748   Section        0  heap_4.o(i.vPortFree)
+    i.vPortSetupTimerInterrupt               0x0800a800   Section        0  port.o(i.vPortSetupTimerInterrupt)
+    i.vPortValidateInterruptPriority         0x0800a820   Section        0  port.o(i.vPortValidateInterruptPriority)
+    i.vQueueAddToRegistry                    0x0800a8c0   Section        0  queue.o(i.vQueueAddToRegistry)
+    i.vQueueWaitForMessageRestricted         0x0800a8ec   Section        0  queue.o(i.vQueueWaitForMessageRestricted)
+    i.vTaskDelay                             0x0800a938   Section        0  tasks.o(i.vTaskDelay)
+    i.vTaskDelayUntil                        0x0800a9ac   Section        0  tasks.o(i.vTaskDelayUntil)
+    i.vTaskDelete                            0x0800aa88   Section        0  tasks.o(i.vTaskDelete)
+    i.vTaskMissedYield                       0x0800ab94   Section        0  tasks.o(i.vTaskMissedYield)
+    i.vTaskPlaceOnEventList                  0x0800aba0   Section        0  tasks.o(i.vTaskPlaceOnEventList)
+    i.vTaskPlaceOnEventListRestricted        0x0800abf4   Section        0  tasks.o(i.vTaskPlaceOnEventListRestricted)
+    i.vTaskPriorityInherit                   0x0800ac50   Section        0  tasks.o(i.vTaskPriorityInherit)
+    i.vTaskSetTimeOutState                   0x0800ad00   Section        0  tasks.o(i.vTaskSetTimeOutState)
+    i.vTaskStartScheduler                    0x0800ad4c   Section        0  tasks.o(i.vTaskStartScheduler)
+    i.vTaskSuspendAll                        0x0800adf8   Section        0  tasks.o(i.vTaskSuspendAll)
+    i.vTaskSwitchContext                     0x0800ae08   Section        0  tasks.o(i.vTaskSwitchContext)
+    i.xPortStartScheduler                    0x0800aeb0   Section        0  port.o(i.xPortStartScheduler)
+    i.xPortSysTickHandler                    0x0800b00c   Section        0  port.o(i.xPortSysTickHandler)
+    i.xQueueGenericCreate                    0x0800b040   Section        0  queue.o(i.xQueueGenericCreate)
+    i.xQueueGenericReceive                   0x0800b0b4   Section        0  queue.o(i.xQueueGenericReceive)
+    i.xQueueGenericReset                     0x0800b27c   Section        0  queue.o(i.xQueueGenericReset)
+    i.xQueueGenericSend                      0x0800b32c   Section        0  queue.o(i.xQueueGenericSend)
+    i.xQueueGenericSendFromISR               0x0800b4f0   Section        0  queue.o(i.xQueueGenericSendFromISR)
+    i.xTaskCheckForTimeOut                   0x0800b600   Section        0  tasks.o(i.xTaskCheckForTimeOut)
+    i.xTaskCreate                            0x0800b6a0   Section        0  tasks.o(i.xTaskCreate)
+    i.xTaskGetSchedulerState                 0x0800b700   Section        0  tasks.o(i.xTaskGetSchedulerState)
+    i.xTaskGetTickCount                      0x0800b720   Section        0  tasks.o(i.xTaskGetTickCount)
+    i.xTaskIncrementTick                     0x0800b72c   Section        0  tasks.o(i.xTaskIncrementTick)
+    i.xTaskPriorityDisinherit                0x0800b88c   Section        0  tasks.o(i.xTaskPriorityDisinherit)
+    i.xTaskRemoveFromEventList               0x0800b964   Section        0  tasks.o(i.xTaskRemoveFromEventList)
+    i.xTaskResumeAll                         0x0800ba18   Section        0  tasks.o(i.xTaskResumeAll)
+    i.xTimerCreateTimerTask                  0x0800bb38   Section        0  timers.o(i.xTimerCreateTimerTask)
+    i.xTimerGenericCommand                   0x0800bbac   Section        0  timers.o(i.xTimerGenericCommand)
+    x$fpl$basic                              0x0800bc50   Section       24  basic.o(x$fpl$basic)
+    $v0                                      0x0800bc50   Number         0  basic.o(x$fpl$basic)
+    x$fpl$d2f                                0x0800bc68   Section       98  d2f.o(x$fpl$d2f)
+    $v0                                      0x0800bc68   Number         0  d2f.o(x$fpl$d2f)
+    x$fpl$dadd                               0x0800bccc   Section      336  daddsub_clz.o(x$fpl$dadd)
+    $v0                                      0x0800bccc   Number         0  daddsub_clz.o(x$fpl$dadd)
+    _dadd1                                   0x0800bcdd   Thumb Code     0  daddsub_clz.o(x$fpl$dadd)
+    x$fpl$dcheck1                            0x0800be1c   Section       16  dcheck1.o(x$fpl$dcheck1)
+    $v0                                      0x0800be1c   Number         0  dcheck1.o(x$fpl$dcheck1)
+    x$fpl$dcmpinf                            0x0800be2c   Section       24  dcmpi.o(x$fpl$dcmpinf)
+    $v0                                      0x0800be2c   Number         0  dcmpi.o(x$fpl$dcmpinf)
+    x$fpl$ddiv                               0x0800be44   Section      688  ddiv.o(x$fpl$ddiv)
+    $v0                                      0x0800be44   Number         0  ddiv.o(x$fpl$ddiv)
+    ddiv_entry                               0x0800be4b   Thumb Code     0  ddiv.o(x$fpl$ddiv)
+    x$fpl$dfix                               0x0800c0f4   Section       94  dfix.o(x$fpl$dfix)
+    $v0                                      0x0800c0f4   Number         0  dfix.o(x$fpl$dfix)
+    x$fpl$dflt                               0x0800c152   Section       46  dflt_clz.o(x$fpl$dflt)
+    $v0                                      0x0800c152   Number         0  dflt_clz.o(x$fpl$dflt)
+    x$fpl$dfltu                              0x0800c180   Section       38  dflt_clz.o(x$fpl$dfltu)
+    $v0                                      0x0800c180   Number         0  dflt_clz.o(x$fpl$dfltu)
+    x$fpl$dleqf                              0x0800c1a8   Section      120  dleqf.o(x$fpl$dleqf)
+    $v0                                      0x0800c1a8   Number         0  dleqf.o(x$fpl$dleqf)
+    x$fpl$dmul                               0x0800c220   Section      340  dmul.o(x$fpl$dmul)
+    $v0                                      0x0800c220   Number         0  dmul.o(x$fpl$dmul)
+    x$fpl$dnaninf                            0x0800c374   Section      156  dnaninf.o(x$fpl$dnaninf)
+    $v0                                      0x0800c374   Number         0  dnaninf.o(x$fpl$dnaninf)
+    x$fpl$dretinf                            0x0800c410   Section       12  dretinf.o(x$fpl$dretinf)
+    $v0                                      0x0800c410   Number         0  dretinf.o(x$fpl$dretinf)
+    x$fpl$drleqf                             0x0800c41c   Section      108  drleqf.o(x$fpl$drleqf)
+    $v0                                      0x0800c41c   Number         0  drleqf.o(x$fpl$drleqf)
+    x$fpl$drsb                               0x0800c488   Section       22  daddsub_clz.o(x$fpl$drsb)
+    $v0                                      0x0800c488   Number         0  daddsub_clz.o(x$fpl$drsb)
+    x$fpl$dsqrt                              0x0800c4a0   Section      408  dsqrt_umaal.o(x$fpl$dsqrt)
+    $v0                                      0x0800c4a0   Number         0  dsqrt_umaal.o(x$fpl$dsqrt)
+    x$fpl$dsub                               0x0800c638   Section      468  daddsub_clz.o(x$fpl$dsub)
+    $v0                                      0x0800c638   Number         0  daddsub_clz.o(x$fpl$dsub)
+    _dsub1                                   0x0800c649   Thumb Code     0  daddsub_clz.o(x$fpl$dsub)
+    x$fpl$f2d                                0x0800c80c   Section       86  f2d.o(x$fpl$f2d)
+    $v0                                      0x0800c80c   Number         0  f2d.o(x$fpl$f2d)
+    x$fpl$fnaninf                            0x0800c862   Section      140  fnaninf.o(x$fpl$fnaninf)
+    $v0                                      0x0800c862   Number         0  fnaninf.o(x$fpl$fnaninf)
+    x$fpl$fpinit                             0x0800c8ee   Section       10  fpinit.o(x$fpl$fpinit)
+    $v0                                      0x0800c8ee   Number         0  fpinit.o(x$fpl$fpinit)
+    x$fpl$fretinf                            0x0800c8f8   Section       10  fretinf.o(x$fpl$fretinf)
+    $v0                                      0x0800c8f8   Number         0  fretinf.o(x$fpl$fretinf)
+    x$fpl$retnan                             0x0800c902   Section      100  retnan.o(x$fpl$retnan)
+    $v0                                      0x0800c902   Number         0  retnan.o(x$fpl$retnan)
+    x$fpl$scalbn                             0x0800c966   Section       92  scalbn.o(x$fpl$scalbn)
+    $v0                                      0x0800c966   Number         0  scalbn.o(x$fpl$scalbn)
+    x$fpl$trapveneer                         0x0800c9c2   Section       48  trapv.o(x$fpl$trapveneer)
+    $v0                                      0x0800c9c2   Number         0  trapv.o(x$fpl$trapveneer)
+    .constdata                               0x0800c9f2   Section     5284  oled.o(.constdata)
+    x$fpl$usenofp                            0x0800c9f2   Section        0  usenofp.o(x$fpl$usenofp)
+    .constdata                               0x0800de98   Section      152  atan.o(.constdata)
+    atanhi                                   0x0800de98   Data          32  atan.o(.constdata)
+    atanlo                                   0x0800deb8   Data          32  atan.o(.constdata)
+    aTodd                                    0x0800ded8   Data          40  atan.o(.constdata)
+    aTeven                                   0x0800df00   Data          48  atan.o(.constdata)
+    .constdata                               0x0800df30   Section      136  pow.o(.constdata)
+    bp                                       0x0800df30   Data          16  pow.o(.constdata)
+    dp_h                                     0x0800df40   Data          16  pow.o(.constdata)
+    dp_l                                     0x0800df50   Data          16  pow.o(.constdata)
+    L                                        0x0800df60   Data          48  pow.o(.constdata)
+    P                                        0x0800df90   Data          40  pow.o(.constdata)
+    .constdata                               0x0800dfb8   Section        8  qnan.o(.constdata)
+    .constdata                               0x0800dfc0   Section      200  rred.o(.constdata)
+    pio2s                                    0x0800dfc0   Data          48  rred.o(.constdata)
+    twooverpi                                0x0800dff0   Data         152  rred.o(.constdata)
+    .constdata                               0x0800e088   Section       96  tan_i.o(.constdata)
+    Todd                                     0x0800e088   Data          48  tan_i.o(.constdata)
+    Teven                                    0x0800e0b8   Data          48  tan_i.o(.constdata)
+    .data                                    0x20000000   Section        4  main.o(.data)
+    .data                                    0x20000004   Section       20  system_stm32f4xx.o(.data)
+    .data                                    0x20000018   Section       12  adc.o(.data)
+    .data                                    0x20000024   Section       20  key.o(.data)
+    flag_key                                 0x20000024   Data           1  key.o(.data)
+    flag_key                                 0x20000025   Data           1  key.o(.data)
+    count_key                                0x20000026   Data           1  key.o(.data)
+    double_key                               0x20000027   Data           1  key.o(.data)
+    count_single                             0x20000028   Data           2  key.o(.data)
+    Forever_count                            0x2000002a   Data           2  key.o(.data)
+    flag_key                                 0x2000002c   Data           1  key.o(.data)
+    count_key                                0x2000002d   Data           1  key.o(.data)
+    double_key                               0x2000002e   Data           1  key.o(.data)
+    count_single                             0x20000030   Data           2  key.o(.data)
+    Forever_count                            0x20000032   Data           2  key.o(.data)
+    Long_Press_count                         0x20000034   Data           2  key.o(.data)
+    Long_Press                               0x20000036   Data           2  key.o(.data)
+    .data                                    0x20000038   Section        8  led.o(.data)
+    temp                                     0x2000003c   Data           4  led.o(.data)
+    .data                                    0x20000040   Section       40  pstwo.o(.data)
+    Strat                                    0x20000064   Data           4  pstwo.o(.data)
+    .data                                    0x20000068   Section       72  timer.o(.data)
+    .data                                    0x200000b0   Section       22  usartx.o(.data)
+    Count                                    0x200000b8   Data           1  usartx.o(.data)
+    Flag_PID                                 0x200000b9   Data           1  usartx.o(.data)
+    i                                        0x200000ba   Data           1  usartx.o(.data)
+    j                                        0x200000bb   Data           1  usartx.o(.data)
+    Last_Usart_Receive                       0x200000bc   Data           1  usartx.o(.data)
+    Data                                     0x200000c0   Data           4  usartx.o(.data)
+    Count                                    0x200000c4   Data           1  usartx.o(.data)
+    Count                                    0x200000c5   Data           1  usartx.o(.data)
+    .data                                    0x200000c8   Section        8  delay.o(.data)
+    fac_us                                   0x200000c8   Data           1  delay.o(.data)
+    fac_ms                                   0x200000ca   Data           2  delay.o(.data)
+    sysTickCnt                               0x200000cc   Data           4  delay.o(.data)
+    .data                                    0x200000d0   Section        6  usart.o(.data)
+    .data                                    0x200000d6   Section       16  stm32f4xx_rcc.o(.data)
+    APBAHBPrescTable                         0x200000d6   Data          16  stm32f4xx_rcc.o(.data)
+    .data                                    0x200000e8   Section       60  tasks.o(.data)
+    pxDelayedTaskList                        0x200000ec   Data           4  tasks.o(.data)
+    pxOverflowDelayedTaskList                0x200000f0   Data           4  tasks.o(.data)
+    uxDeletedTasksWaitingCleanUp             0x200000f4   Data           4  tasks.o(.data)
+    uxCurrentNumberOfTasks                   0x200000f8   Data           4  tasks.o(.data)
+    xTickCount                               0x200000fc   Data           4  tasks.o(.data)
+    uxTopReadyPriority                       0x20000100   Data           4  tasks.o(.data)
+    xSchedulerRunning                        0x20000104   Data           4  tasks.o(.data)
+    uxPendedTicks                            0x20000108   Data           4  tasks.o(.data)
+    xYieldPending                            0x2000010c   Data           4  tasks.o(.data)
+    xNumOfOverflows                          0x20000110   Data           4  tasks.o(.data)
+    uxTaskNumber                             0x20000114   Data           4  tasks.o(.data)
+    xNextTaskUnblockTime                     0x20000118   Data           4  tasks.o(.data)
+    xIdleTaskHandle                          0x2000011c   Data           4  tasks.o(.data)
+    uxSchedulerSuspended                     0x20000120   Data           4  tasks.o(.data)
+    .data                                    0x20000124   Section       20  timers.o(.data)
+    pxCurrentTimerList                       0x20000124   Data           4  timers.o(.data)
+    pxOverflowTimerList                      0x20000128   Data           4  timers.o(.data)
+    xTimerQueue                              0x2000012c   Data           4  timers.o(.data)
+    xTimerTaskHandle                         0x20000130   Data           4  timers.o(.data)
+    xLastTime                                0x20000134   Data           4  timers.o(.data)
+    .data                                    0x20000138   Section       12  port.o(.data)
+    uxCriticalNesting                        0x20000138   Data           4  port.o(.data)
+    ucMaxSysCallPriority                     0x2000013c   Data           1  port.o(.data)
+    ulMaxPRIGROUPValue                       0x20000140   Data           4  port.o(.data)
+    .data                                    0x20000144   Section       24  heap_4.o(.data)
+    xStart                                   0x20000144   Data           8  heap_4.o(.data)
+    pxEnd                                    0x2000014c   Data           4  heap_4.o(.data)
+    xFreeBytesRemaining                      0x20000150   Data           4  heap_4.o(.data)
+    xMinimumEverFreeBytesRemaining           0x20000154   Data           4  heap_4.o(.data)
+    xBlockAllocatedBit                       0x20000158   Data           4  heap_4.o(.data)
+    .data                                    0x2000015c   Section      120  system.o(.data)
+    .data                                    0x200001d4   Section       62  balance.o(.data)
+    Bias                                     0x200001e0   Data           4  balance.o(.data)
+    Pwm                                      0x200001e4   Data           4  balance.o(.data)
+    Last_bias                                0x200001e8   Data           4  balance.o(.data)
+    Bias                                     0x200001ec   Data           4  balance.o(.data)
+    Pwm                                      0x200001f0   Data           4  balance.o(.data)
+    Last_bias                                0x200001f4   Data           4  balance.o(.data)
+    Bias                                     0x200001f8   Data           4  balance.o(.data)
+    Pwm                                      0x200001fc   Data           4  balance.o(.data)
+    Last_bias                                0x20000200   Data           4  balance.o(.data)
+    Bias                                     0x20000204   Data           4  balance.o(.data)
+    Pwm                                      0x20000208   Data           4  balance.o(.data)
+    Last_bias                                0x2000020c   Data           4  balance.o(.data)
+    thrice                                   0x20000210   Data           1  balance.o(.data)
+    error                                    0x20000211   Data           1  balance.o(.data)
+    .data                                    0x20000214   Section       25  show.o(.data)
+    LowVoltage_1                             0x20000220   Data           4  show.o(.data)
+    LowVoltage_2                             0x20000224   Data           4  show.o(.data)
+    count                                    0x20000228   Data           4  show.o(.data)
+    flag_show                                0x2000022c   Data           1  show.o(.data)
+    .data                                    0x20000230   Section       78  mpu6050.o(.data)
+    .bss                                     0x20000280   Section     1024  oled.o(.bss)
+    .bss                                     0x20000680   Section        9  pstwo.o(.bss)
+    .bss                                     0x2000068c   Section      141  usartx.o(.bss)
+    rxbuf                                    0x200006dc   Data          11  usartx.o(.bss)
+    Receive                                  0x200006e7   Data          50  usartx.o(.bss)
+    .bss                                     0x2000071c   Section       64  queue.o(.bss)
+    .bss                                     0x2000075c   Section      740  tasks.o(.bss)
+    pxReadyTasksLists                        0x2000075c   Data         640  tasks.o(.bss)
+    xDelayedTaskList1                        0x200009dc   Data          20  tasks.o(.bss)
+    xDelayedTaskList2                        0x200009f0   Data          20  tasks.o(.bss)
+    xPendingReadyList                        0x20000a04   Data          20  tasks.o(.bss)
+    xTasksWaitingTermination                 0x20000a18   Data          20  tasks.o(.bss)
+    xSuspendedTaskList                       0x20000a2c   Data          20  tasks.o(.bss)
+    .bss                                     0x20000a40   Section       40  timers.o(.bss)
+    xActiveTimerList1                        0x20000a40   Data          20  timers.o(.bss)
+    xActiveTimerList2                        0x20000a54   Data          20  timers.o(.bss)
+    .bss                                     0x20000a68   Section    20480  heap_4.o(.bss)
+    ucHeap                                   0x20000a68   Data       20480  heap_4.o(.bss)
+    .bss                                     0x20005a68   Section       92  system.o(.bss)
+    .bss                                     0x20005ac4   Section       16  balance.o(.bss)
+    .bss                                     0x20005ad4   Section       24  robot_select_init.o(.bss)
+    .bss                                     0x20005aec   Section       96  libspace.o(.bss)
+    HEAP                                     0x20005b50   Section      512  startup_stm32f40_41xxx.o(HEAP)
+    Heap_Mem                                 0x20005b50   Data         512  startup_stm32f40_41xxx.o(HEAP)
+    STACK                                    0x20005d50   Section     1024  startup_stm32f40_41xxx.o(STACK)
+    Stack_Mem                                0x20005d50   Data        1024  startup_stm32f40_41xxx.o(STACK)
+    __initial_sp                             0x20006150   Data           0  startup_stm32f40_41xxx.o(STACK)
+
+    Global Symbols
+
+    Symbol Name                              Value     Ov Type        Size  Object(Section)
+
+    BuildAttributes$$THM_ISAv4$E$P$D$K$B$S$7EM$VFPi3$EXTD16$VFPS$VFMA$PE$A:L22UL41UL21$X:L11$S22US41US21$IEEE1$IW$USESV6$~STKCKD$USESV7$~SHL$OTIME$ROPI$IEEEX$EBA8$UX$STANDARDLIB$REQ8$PRES8$EABIv2 0x00000000   Number         0  anon$$obj.o ABSOLUTE
+    __ARM_use_no_argv                        0x00000000   Number         0  main.o ABSOLUTE
+    __ARM_exceptions_init                     - Undefined Weak Reference
+    __alloca_initialize                       - Undefined Weak Reference
+    __arm_preinit_                            - Undefined Weak Reference
+    __cpp_initialize__aeabi_                  - Undefined Weak Reference
+    __cxa_finalize                            - Undefined Weak Reference
+    __rt_locale                               - Undefined Weak Reference
+    __sigvec_lookup                           - Undefined Weak Reference
+    _atexit_init                              - Undefined Weak Reference
+    _call_atexit_fns                          - Undefined Weak Reference
+    _clock_init                               - Undefined Weak Reference
+    _fp_trap_init                             - Undefined Weak Reference
+    _fp_trap_shutdown                         - Undefined Weak Reference
+    _get_lc_collate                           - Undefined Weak Reference
+    _get_lc_ctype                             - Undefined Weak Reference
+    _get_lc_monetary                          - Undefined Weak Reference
+    _get_lc_numeric                           - Undefined Weak Reference
+    _get_lc_time                              - Undefined Weak Reference
+    _getenv_init                              - Undefined Weak Reference
+    _handle_redirection                       - Undefined Weak Reference
+    _init_alloc                               - Undefined Weak Reference
+    _init_user_alloc                          - Undefined Weak Reference
+    _initio                                   - Undefined Weak Reference
+    _mutex_acquire                            - Undefined Weak Reference
+    _mutex_release                            - Undefined Weak Reference
+    _printf_mbtowc                            - Undefined Weak Reference
+    _printf_post_padding                      - Undefined Weak Reference
+    _printf_pre_padding                       - Undefined Weak Reference
+    _printf_truncate_signed                   - Undefined Weak Reference
+    _printf_truncate_unsigned                 - Undefined Weak Reference
+    _rand_init                                - Undefined Weak Reference
+    _signal_finish                            - Undefined Weak Reference
+    _signal_init                              - Undefined Weak Reference
+    _terminate_alloc                          - Undefined Weak Reference
+    _terminate_user_alloc                     - Undefined Weak Reference
+    _terminateio                              - Undefined Weak Reference
+    __Vectors_Size                           0x00000188   Number         0  startup_stm32f40_41xxx.o ABSOLUTE
+    __Vectors                                0x08000000   Data           4  startup_stm32f40_41xxx.o(RESET)
+    __Vectors_End                            0x08000188   Data           0  startup_stm32f40_41xxx.o(RESET)
+    __main                                   0x08000189   Thumb Code     8  __main.o(!!!main)
+    __scatterload                            0x08000191   Thumb Code     0  __scatter.o(!!!scatter)
+    __scatterload_rt2                        0x08000191   Thumb Code    44  __scatter.o(!!!scatter)
+    __scatterload_rt2_thumb_only             0x08000191   Thumb Code     0  __scatter.o(!!!scatter)
+    __scatterload_null                       0x0800019f   Thumb Code     0  __scatter.o(!!!scatter)
+    __decompress                             0x080001c5   Thumb Code    90  __dczerorl2.o(!!dczerorl2)
+    __decompress1                            0x080001c5   Thumb Code     0  __dczerorl2.o(!!dczerorl2)
+    __scatterload_zeroinit                   0x08000221   Thumb Code    28  __scatter_zi.o(!!handler_zi)
+    _printf_d                                0x0800023d   Thumb Code     0  _printf_d.o(.ARM.Collect$$_printf_percent$$00000009)
+    _printf_percent                          0x0800023d   Thumb Code     0  _printf_percent.o(.ARM.Collect$$_printf_percent$$00000000)
+    _printf_s                                0x08000243   Thumb Code     0  _printf_s.o(.ARM.Collect$$_printf_percent$$00000014)
+    _printf_percent_end                      0x08000249   Thumb Code     0  _printf_percent_end.o(.ARM.Collect$$_printf_percent$$00000017)
+    __rt_lib_init                            0x0800024d   Thumb Code     0  libinit.o(.ARM.Collect$$libinit$$00000000)
+    __rt_lib_init_fp_1                       0x0800024f   Thumb Code     0  libinit2.o(.ARM.Collect$$libinit$$00000001)
+    __rt_lib_init_alloca_1                   0x08000253   Thumb Code     0  libinit2.o(.ARM.Collect$$libinit$$0000002E)
+    __rt_lib_init_argv_1                     0x08000253   Thumb Code     0  libinit2.o(.ARM.Collect$$libinit$$0000002C)
+    __rt_lib_init_atexit_1                   0x08000253   Thumb Code     0  libinit2.o(.ARM.Collect$$libinit$$0000001B)
+    __rt_lib_init_clock_1                    0x08000253   Thumb Code     0  libinit2.o(.ARM.Collect$$libinit$$00000021)
+    __rt_lib_init_cpp_1                      0x08000253   Thumb Code     0  libinit2.o(.ARM.Collect$$libinit$$00000032)
+    __rt_lib_init_exceptions_1               0x08000253   Thumb Code     0  libinit2.o(.ARM.Collect$$libinit$$00000030)
+    __rt_lib_init_fp_trap_1                  0x08000253   Thumb Code     0  libinit2.o(.ARM.Collect$$libinit$$0000001F)
+    __rt_lib_init_getenv_1                   0x08000253   Thumb Code     0  libinit2.o(.ARM.Collect$$libinit$$00000023)
+    __rt_lib_init_heap_1                     0x08000253   Thumb Code     0  libinit2.o(.ARM.Collect$$libinit$$0000000A)
+    __rt_lib_init_lc_collate_1               0x08000253   Thumb Code     0  libinit2.o(.ARM.Collect$$libinit$$00000011)
+    __rt_lib_init_lc_ctype_1                 0x08000253   Thumb Code     0  libinit2.o(.ARM.Collect$$libinit$$00000013)
+    __rt_lib_init_lc_monetary_1              0x08000253   Thumb Code     0  libinit2.o(.ARM.Collect$$libinit$$00000015)
+    __rt_lib_init_lc_numeric_1               0x08000253   Thumb Code     0  libinit2.o(.ARM.Collect$$libinit$$00000017)
+    __rt_lib_init_lc_time_1                  0x08000253   Thumb Code     0  libinit2.o(.ARM.Collect$$libinit$$00000019)
+    __rt_lib_init_preinit_1                  0x08000253   Thumb Code     0  libinit2.o(.ARM.Collect$$libinit$$00000004)
+    __rt_lib_init_rand_1                     0x08000253   Thumb Code     0  libinit2.o(.ARM.Collect$$libinit$$0000000E)
+    __rt_lib_init_return                     0x08000253   Thumb Code     0  libinit2.o(.ARM.Collect$$libinit$$00000033)
+    __rt_lib_init_signal_1                   0x08000253   Thumb Code     0  libinit2.o(.ARM.Collect$$libinit$$0000001D)
+    __rt_lib_init_stdio_1                    0x08000253   Thumb Code     0  libinit2.o(.ARM.Collect$$libinit$$00000025)
+    __rt_lib_init_user_alloc_1               0x08000253   Thumb Code     0  libinit2.o(.ARM.Collect$$libinit$$0000000C)
+    __rt_lib_shutdown                        0x08000255   Thumb Code     0  libshutdown.o(.ARM.Collect$$libshutdown$$00000000)
+    __rt_lib_shutdown_cpp_1                  0x08000257   Thumb Code     0  libshutdown2.o(.ARM.Collect$$libshutdown$$00000002)
+    __rt_lib_shutdown_fp_trap_1              0x08000257   Thumb Code     0  libshutdown2.o(.ARM.Collect$$libshutdown$$00000007)
+    __rt_lib_shutdown_heap_1                 0x08000257   Thumb Code     0  libshutdown2.o(.ARM.Collect$$libshutdown$$0000000F)
+    __rt_lib_shutdown_return                 0x08000257   Thumb Code     0  libshutdown2.o(.ARM.Collect$$libshutdown$$00000010)
+    __rt_lib_shutdown_signal_1               0x08000257   Thumb Code     0  libshutdown2.o(.ARM.Collect$$libshutdown$$0000000A)
+    __rt_lib_shutdown_stdio_1                0x08000257   Thumb Code     0  libshutdown2.o(.ARM.Collect$$libshutdown$$00000004)
+    __rt_lib_shutdown_user_alloc_1           0x08000257   Thumb Code     0  libshutdown2.o(.ARM.Collect$$libshutdown$$0000000C)
+    __rt_entry                               0x08000259   Thumb Code     0  __rtentry.o(.ARM.Collect$$rtentry$$00000000)
+    __rt_entry_presh_1                       0x08000259   Thumb Code     0  __rtentry2.o(.ARM.Collect$$rtentry$$00000002)
+    __rt_entry_sh                            0x08000259   Thumb Code     0  __rtentry4.o(.ARM.Collect$$rtentry$$00000004)
+    __rt_entry_li                            0x0800025f   Thumb Code     0  __rtentry2.o(.ARM.Collect$$rtentry$$0000000A)
+    __rt_entry_postsh_1                      0x0800025f   Thumb Code     0  __rtentry2.o(.ARM.Collect$$rtentry$$00000009)
+    __rt_entry_main                          0x08000263   Thumb Code     0  __rtentry2.o(.ARM.Collect$$rtentry$$0000000D)
+    __rt_entry_postli_1                      0x08000263   Thumb Code     0  __rtentry2.o(.ARM.Collect$$rtentry$$0000000C)
+    __rt_exit                                0x0800026b   Thumb Code     0  rtexit.o(.ARM.Collect$$rtexit$$00000000)
+    __rt_exit_ls                             0x0800026d   Thumb Code     0  rtexit2.o(.ARM.Collect$$rtexit$$00000003)
+    __rt_exit_prels_1                        0x0800026d   Thumb Code     0  rtexit2.o(.ARM.Collect$$rtexit$$00000002)
+    __rt_exit_exit                           0x08000271   Thumb Code     0  rtexit2.o(.ARM.Collect$$rtexit$$00000004)
+    SVC_Handler                              0x08000279   Thumb Code    28  port.o(.emb_text)
+    __asm___6_port_c_39a90d8d__prvStartFirstTask 0x08000299   Thumb Code    28  port.o(.emb_text)
+    __asm___6_port_c_39a90d8d__prvEnableVFP  0x080002b9   Thumb Code    16  port.o(.emb_text)
+    PendSV_Handler                           0x080002cd   Thumb Code    88  port.o(.emb_text)
+    vPortGetIPSR                             0x08000329   Thumb Code     6  port.o(.emb_text)
+    Reset_Handler                            0x08000331   Thumb Code     8  startup_stm32f40_41xxx.o(.text)
+    ADC_IRQHandler                           0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    CAN1_RX1_IRQHandler                      0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    CAN1_SCE_IRQHandler                      0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    CAN1_TX_IRQHandler                       0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    CAN2_RX0_IRQHandler                      0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    CAN2_RX1_IRQHandler                      0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    CAN2_SCE_IRQHandler                      0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    CAN2_TX_IRQHandler                       0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    CRYP_IRQHandler                          0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    DCMI_IRQHandler                          0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    DMA1_Stream0_IRQHandler                  0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    DMA1_Stream1_IRQHandler                  0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    DMA1_Stream2_IRQHandler                  0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    DMA1_Stream3_IRQHandler                  0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    DMA1_Stream4_IRQHandler                  0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    DMA1_Stream5_IRQHandler                  0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    DMA1_Stream6_IRQHandler                  0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    DMA1_Stream7_IRQHandler                  0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    DMA2_Stream0_IRQHandler                  0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    DMA2_Stream1_IRQHandler                  0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    DMA2_Stream2_IRQHandler                  0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    DMA2_Stream3_IRQHandler                  0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    DMA2_Stream4_IRQHandler                  0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    DMA2_Stream5_IRQHandler                  0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    DMA2_Stream6_IRQHandler                  0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    DMA2_Stream7_IRQHandler                  0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    ETH_IRQHandler                           0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    ETH_WKUP_IRQHandler                      0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    EXTI0_IRQHandler                         0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    EXTI15_10_IRQHandler                     0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    EXTI1_IRQHandler                         0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    EXTI2_IRQHandler                         0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    EXTI3_IRQHandler                         0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    EXTI4_IRQHandler                         0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    EXTI9_5_IRQHandler                       0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    FLASH_IRQHandler                         0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    FPU_IRQHandler                           0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    FSMC_IRQHandler                          0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    HASH_RNG_IRQHandler                      0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    I2C1_ER_IRQHandler                       0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    I2C1_EV_IRQHandler                       0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    I2C2_ER_IRQHandler                       0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    I2C2_EV_IRQHandler                       0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    I2C3_ER_IRQHandler                       0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    I2C3_EV_IRQHandler                       0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    OTG_FS_IRQHandler                        0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    OTG_FS_WKUP_IRQHandler                   0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    OTG_HS_EP1_IN_IRQHandler                 0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    OTG_HS_EP1_OUT_IRQHandler                0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    OTG_HS_IRQHandler                        0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    OTG_HS_WKUP_IRQHandler                   0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    PVD_IRQHandler                           0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    RCC_IRQHandler                           0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    RTC_Alarm_IRQHandler                     0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    RTC_WKUP_IRQHandler                      0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    SDIO_IRQHandler                          0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    SPI1_IRQHandler                          0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    SPI2_IRQHandler                          0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    SPI3_IRQHandler                          0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    TAMP_STAMP_IRQHandler                    0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    TIM1_BRK_TIM9_IRQHandler                 0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    TIM1_CC_IRQHandler                       0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    TIM1_TRG_COM_TIM11_IRQHandler            0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    TIM1_UP_TIM10_IRQHandler                 0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    TIM6_DAC_IRQHandler                      0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    TIM7_IRQHandler                          0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    TIM8_TRG_COM_TIM14_IRQHandler            0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    UART4_IRQHandler                         0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    USART6_IRQHandler                        0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    WWDG_IRQHandler                          0x0800034b   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    __user_initial_stackheap                 0x0800034d   Thumb Code     0  startup_stm32f40_41xxx.o(.text)
+    __use_no_semihosting                     0x08000371   Thumb Code     2  use_no_semi_2.o(.text)
+    __2printf                                0x08000375   Thumb Code    20  noretval__2printf.o(.text)
+    __printf                                 0x0800038d   Thumb Code   104  __printf.o(.text)
+    _printf_str                              0x080003f5   Thumb Code    82  _printf_str.o(.text)
+    _printf_int_dec                          0x08000449   Thumb Code   104  _printf_dec.o(.text)
+    __aeabi_memcpy                           0x080004c1   Thumb Code     0  rt_memcpy_v6.o(.text)
+    __rt_memcpy                              0x080004c1   Thumb Code   138  rt_memcpy_v6.o(.text)
+    _memcpy_lastbytes                        0x08000527   Thumb Code     0  rt_memcpy_v6.o(.text)
+    __aeabi_memset                           0x0800054b   Thumb Code    16  aeabi_memset.o(.text)
+    __aeabi_memclr                           0x0800055b   Thumb Code     0  rt_memclr.o(.text)
+    __rt_memclr                              0x0800055b   Thumb Code    68  rt_memclr.o(.text)
+    _memset                                  0x0800055f   Thumb Code     0  rt_memclr.o(.text)
+    __use_two_region_memory                  0x0800059f   Thumb Code     2  heapauxi.o(.text)
+    __rt_heap_escrow$2region                 0x080005a1   Thumb Code     2  heapauxi.o(.text)
+    __rt_heap_expand$2region                 0x080005a3   Thumb Code     2  heapauxi.o(.text)
+    __I$use$semihosting                      0x080005a5   Thumb Code     0  use_no_semi.o(.text)
+    __use_no_semihosting_swi                 0x080005a5   Thumb Code     2  use_no_semi.o(.text)
+    __read_errno                             0x080005a7   Thumb Code    10  _rserrno.o(.text)
+    __set_errno                              0x080005b1   Thumb Code    12  _rserrno.o(.text)
+    _printf_int_common                       0x080005bd   Thumb Code   178  _printf_intcommon.o(.text)
+    _printf_char_common                      0x0800067b   Thumb Code    32  _printf_char_common.o(.text)
+    _printf_cs_common                        0x080006a1   Thumb Code    20  _printf_char.o(.text)
+    _printf_char                             0x080006b5   Thumb Code    16  _printf_char.o(.text)
+    _printf_string                           0x080006c5   Thumb Code     8  _printf_char.o(.text)
+    _printf_char_file                        0x080006cd   Thumb Code    32  _printf_char_file.o(.text)
+    __aeabi_memcpy4                          0x080006f1   Thumb Code     0  rt_memcpy_w.o(.text)
+    __aeabi_memcpy8                          0x080006f1   Thumb Code     0  rt_memcpy_w.o(.text)
+    __rt_memcpy_w                            0x080006f1   Thumb Code   100  rt_memcpy_w.o(.text)
+    _memcpy_lastbytes_aligned                0x08000739   Thumb Code     0  rt_memcpy_w.o(.text)
+    __aeabi_memclr4                          0x08000755   Thumb Code     0  rt_memclr_w.o(.text)
+    __aeabi_memclr8                          0x08000755   Thumb Code     0  rt_memclr_w.o(.text)
+    __rt_memclr_w                            0x08000755   Thumb Code    78  rt_memclr_w.o(.text)
+    _memset_w                                0x08000759   Thumb Code     0  rt_memclr_w.o(.text)
+    __aeabi_errno_addr                       0x080007a5   Thumb Code     8  rt_errno_addr_intlibspace.o(.text)
+    __errno$intlibspace                      0x080007a5   Thumb Code     0  rt_errno_addr_intlibspace.o(.text)
+    __rt_errno_addr$intlibspace              0x080007a5   Thumb Code     0  rt_errno_addr_intlibspace.o(.text)
+    ferror                                   0x080007ad   Thumb Code     8  ferror.o(.text)
+    __user_libspace                          0x080007b5   Thumb Code     8  libspace.o(.text)
+    __user_perproc_libspace                  0x080007b5   Thumb Code     0  libspace.o(.text)
+    __user_perthread_libspace                0x080007b5   Thumb Code     0  libspace.o(.text)
+    __user_setup_stackheap                   0x080007bd   Thumb Code    74  sys_stackheap_outer.o(.text)
+    exit                                     0x08000807   Thumb Code    18  exit.o(.text)
+    ADC_Cmd                                  0x08000819   Thumb Code    22  stm32f4xx_adc.o(i.ADC_Cmd)
+    ADC_CommonInit                           0x08000831   Thumb Code    34  stm32f4xx_adc.o(i.ADC_CommonInit)
+    ADC_GetConversionValue                   0x08000861   Thumb Code     8  stm32f4xx_adc.o(i.ADC_GetConversionValue)
+    ADC_GetFlagStatus                        0x08000869   Thumb Code    18  stm32f4xx_adc.o(i.ADC_GetFlagStatus)
+    ADC_Init                                 0x0800087d   Thumb Code    74  stm32f4xx_adc.o(i.ADC_Init)
+    ADC_RegularChannelConfig                 0x080008d1   Thumb Code   184  stm32f4xx_adc.o(i.ADC_RegularChannelConfig)
+    ADC_SoftwareStartConv                    0x08000989   Thumb Code    10  stm32f4xx_adc.o(i.ADC_SoftwareStartConv)
+    APP_Show                                 0x08000995   Thumb Code   228  show.o(i.APP_Show)
+    Adc_Init                                 0x08000ad9   Thumb Code   124  adc.o(i.Adc_Init)
+    Adc_POWER_Init                           0x08000b5d   Thumb Code   124  adc.o(i.Adc_POWER_Init)
+    Balance_task                             0x08000be1   Thumb Code   724  balance.o(i.Balance_task)
+    BusFault_Handler                         0x08000ef5   Thumb Code     4  stm32f4xx_it.o(i.BusFault_Handler)
+    Buzzer_Init                              0x08000ef9   Thumb Code    50  led.o(i.Buzzer_Init)
+    CAN1_Mode_Init                           0x08000f31   Thumb Code   488  can.o(i.CAN1_Mode_Init)
+    CAN1_RX0_IRQHandler                      0x08001125   Thumb Code   252  can.o(i.CAN1_RX0_IRQHandler)
+    CAN1_Rx_Msg                              0x08001251   Thumb Code   208  can.o(i.CAN1_Rx_Msg)
+    CAN1_Send_Num                            0x08001329   Thumb Code    64  can.o(i.CAN1_Send_Num)
+    CAN1_Tx_Msg                              0x08001369   Thumb Code   260  can.o(i.CAN1_Tx_Msg)
+    CAN1_Tx_Staus                            0x08001475   Thumb Code   126  can.o(i.CAN1_Tx_Staus)
+    CAN_ITConfig                             0x080014f9   Thumb Code    18  stm32f4xx_can.o(i.CAN_ITConfig)
+    CAN_SEND                                 0x0800150d   Thumb Code   102  usartx.o(i.CAN_SEND)
+    Check_Sum                                0x08001579   Thumb Code    52  usartx.o(i.Check_Sum)
+    DebugMon_Handler                         0x080015b5   Thumb Code     2  stm32f4xx_it.o(i.DebugMon_Handler)
+    Drive_Motor                              0x080015b9   Thumb Code  1992  balance.o(i.Drive_Motor)
+    Enable_Pin                               0x08001dc1   Thumb Code    42  motor.o(i.Enable_Pin)
+    Encoder_Init_TIM2                        0x08001df1   Thumb Code   224  encoder.o(i.Encoder_Init_TIM2)
+    Encoder_Init_TIM3                        0x08001ed9   Thumb Code   180  encoder.o(i.Encoder_Init_TIM3)
+    Encoder_Init_TIM4                        0x08001f95   Thumb Code   180  encoder.o(i.Encoder_Init_TIM4)
+    Encoder_Init_TIM5                        0x08002051   Thumb Code   178  encoder.o(i.Encoder_Init_TIM5)
+    GPIO_Init                                0x0800210d   Thumb Code   144  stm32f4xx_gpio.o(i.GPIO_Init)
+    GPIO_PinAFConfig                         0x0800219d   Thumb Code    70  stm32f4xx_gpio.o(i.GPIO_PinAFConfig)
+    GPIO_SetBits                             0x080021e3   Thumb Code     4  stm32f4xx_gpio.o(i.GPIO_SetBits)
+    Get_Adc                                  0x080021e9   Thumb Code    44  adc.o(i.Get_Adc)
+    Get_Adc2                                 0x08002219   Thumb Code    44  adc.o(i.Get_Adc2)
+    Get_RC                                   0x08002249   Thumb Code   874  balance.o(i.Get_RC)
+    Get_Velocity_Form_Encoder                0x080025e9   Thumb Code   484  balance.o(i.Get_Velocity_Form_Encoder)
+    Get_adc_Average                          0x080027f1   Thumb Code    46  adc.o(i.Get_adc_Average)
+    Get_battery_volt                         0x08002821   Thumb Code   120  adc.o(i.Get_battery_volt)
+    HardFault_Handler                        0x080028c1   Thumb Code     4  stm32f4xx_it.o(i.HardFault_Handler)
+    I2C_Ack                                  0x080028c5   Thumb Code    64  i2c.o(i.I2C_Ack)
+    I2C_GPIOInit                             0x08002911   Thumb Code    62  i2c.o(i.I2C_GPIOInit)
+    I2C_NAck                                 0x0800295d   Thumb Code    62  i2c.o(i.I2C_NAck)
+    I2C_ReadByte                             0x080029a9   Thumb Code   100  i2c.o(i.I2C_ReadByte)
+    I2C_ReadOneByte                          0x08002a19   Thumb Code    64  i2c.o(i.I2C_ReadOneByte)
+    I2C_Start                                0x08002a59   Thumb Code    88  i2c.o(i.I2C_Start)
+    I2C_Stop                                 0x08002abd   Thumb Code    60  i2c.o(i.I2C_Stop)
+    I2C_WaiteForAck                          0x08002b05   Thumb Code    88  i2c.o(i.I2C_WaiteForAck)
+    I2C_WriteBits                            0x08002b69   Thumb Code    88  i2c.o(i.I2C_WriteBits)
+    I2C_WriteByte                            0x08002bc1   Thumb Code    88  i2c.o(i.I2C_WriteByte)
+    I2C_WriteOneByte                         0x08002c25   Thumb Code    50  i2c.o(i.I2C_WriteOneByte)
+    Incremental_PI_A                         0x08002c59   Thumb Code   146  balance.o(i.Incremental_PI_A)
+    Incremental_PI_B                         0x08002d09   Thumb Code   146  balance.o(i.Incremental_PI_B)
+    Incremental_PI_C                         0x08002db9   Thumb Code   146  balance.o(i.Incremental_PI_C)
+    Incremental_PI_D                         0x08002e69   Thumb Code   146  balance.o(i.Incremental_PI_D)
+    KEY_Init                                 0x08002f19   Thumb Code    42  key.o(i.KEY_Init)
+    Key                                      0x08002f49   Thumb Code    40  balance.o(i.Key)
+    LED_Init                                 0x08002f81   Thumb Code    60  led.o(i.LED_Init)
+    Limit_Pwm                                0x08002fc1   Thumb Code   156  balance.o(i.Limit_Pwm)
+    MPU6050_Set_LPF                          0x0800306d   Thumb Code    60  mpu6050.o(i.MPU6050_Set_LPF)
+    MPU6050_Set_Rate                         0x080030a9   Thumb Code    60  mpu6050.o(i.MPU6050_Set_Rate)
+    MPU6050_initialize                       0x080030e5   Thumb Code   136  mpu6050.o(i.MPU6050_initialize)
+    MPU6050_setFullScaleAccelRange           0x0800316d   Thumb Code    20  mpu6050.o(i.MPU6050_setFullScaleAccelRange)
+    MPU6050_setFullScaleGyroRange            0x08003181   Thumb Code    20  mpu6050.o(i.MPU6050_setFullScaleGyroRange)
+    MPU6050_task                             0x08003195   Thumb Code   190  mpu6050.o(i.MPU6050_task)
+    MPU_Get_Accelscope                       0x08003271   Thumb Code   170  mpu6050.o(i.MPU_Get_Accelscope)
+    MPU_Get_Gyroscope                        0x0800332d   Thumb Code   202  mpu6050.o(i.MPU_Get_Gyroscope)
+    MemManage_Handler                        0x08003411   Thumb Code     4  stm32f4xx_it.o(i.MemManage_Handler)
+    NMI_Handler                              0x08003415   Thumb Code     2  stm32f4xx_it.o(i.NMI_Handler)
+    NVIC_Init                                0x08003419   Thumb Code   106  misc.o(i.NVIC_Init)
+    NVIC_PriorityGroupConfig                 0x08003491   Thumb Code    10  misc.o(i.NVIC_PriorityGroupConfig)
+    OLED_Clear                               0x080034a5   Thumb Code    42  oled.o(i.OLED_Clear)
+    OLED_DrawPoint                           0x080034d5   Thumb Code   100  oled.o(i.OLED_DrawPoint)
+    OLED_Init                                0x0800353d   Thumb Code   296  oled.o(i.OLED_Init)
+    OLED_Refresh_Gram                        0x08003671   Thumb Code    70  oled.o(i.OLED_Refresh_Gram)
+    OLED_ShowChar                            0x080036bd   Thumb Code   158  oled.o(i.OLED_ShowChar)
+    OLED_ShowNumber                          0x08003765   Thumb Code   148  oled.o(i.OLED_ShowNumber)
+    OLED_ShowString                          0x080037f9   Thumb Code    68  oled.o(i.OLED_ShowString)
+    OLED_WR_Byte                             0x0800383d   Thumb Code    82  oled.o(i.OLED_WR_Byte)
+    PS2_AnologData                           0x08003895   Thumb Code     8  pstwo.o(i.PS2_AnologData)
+    PS2_ClearData                            0x080038a1   Thumb Code    20  pstwo.o(i.PS2_ClearData)
+    PS2_Cmd                                  0x080038b9   Thumb Code   130  pstwo.o(i.PS2_Cmd)
+    PS2_DataKey                              0x08003949   Thumb Code    70  pstwo.o(i.PS2_DataKey)
+    PS2_EnterConfing                         0x0800399d   Thumb Code    84  pstwo.o(i.PS2_EnterConfing)
+    PS2_ExitConfing                          0x080039f9   Thumb Code    84  pstwo.o(i.PS2_ExitConfing)
+    PS2_Init                                 0x08003a55   Thumb Code    82  pstwo.o(i.PS2_Init)
+    PS2_Read                                 0x08003aad   Thumb Code   204  pstwo.o(i.PS2_Read)
+    PS2_ReadData                             0x08003bb1   Thumb Code   164  pstwo.o(i.PS2_ReadData)
+    PS2_SetInit                              0x08003c65   Thumb Code    28  pstwo.o(i.PS2_SetInit)
+    PS2_ShortPoll                            0x08003c81   Thumb Code    60  pstwo.o(i.PS2_ShortPoll)
+    PS2_TurnOnAnalogMode                     0x08003cc5   Thumb Code    78  pstwo.o(i.PS2_TurnOnAnalogMode)
+    PS2_control                              0x08003d1d   Thumb Code   552  balance.o(i.PS2_control)
+    PWR_BackupAccessCmd                      0x08003f7d   Thumb Code     6  stm32f4xx_pwr.o(i.PWR_BackupAccessCmd)
+    RCC_AHB1PeriphClockCmd                   0x08003f89   Thumb Code    26  stm32f4xx_rcc.o(i.RCC_AHB1PeriphClockCmd)
+    RCC_APB1PeriphClockCmd                   0x08003fa9   Thumb Code    26  stm32f4xx_rcc.o(i.RCC_APB1PeriphClockCmd)
+    RCC_APB2PeriphClockCmd                   0x08003fc9   Thumb Code    26  stm32f4xx_rcc.o(i.RCC_APB2PeriphClockCmd)
+    RCC_APB2PeriphResetCmd                   0x08003fe9   Thumb Code    26  stm32f4xx_rcc.o(i.RCC_APB2PeriphResetCmd)
+    RCC_GetClocksFreq                        0x08004009   Thumb Code   214  stm32f4xx_rcc.o(i.RCC_GetClocksFreq)
+    RCC_LSEConfig                            0x080040f1   Thumb Code    40  stm32f4xx_rcc.o(i.RCC_LSEConfig)
+    Read_Encoder                             0x0800411d   Thumb Code    88  encoder.o(i.Read_Encoder)
+    Remote_Control                           0x08004181   Thumb Code   554  balance.o(i.Remote_Control)
+    Robot_Init                               0x080043e5   Thumb Code   160  robot_select_init.o(i.Robot_Init)
+    Robot_Select                             0x080044a1   Thumb Code   348  robot_select_init.o(i.Robot_Select)
+    Set_Pwm                                  0x0800474d   Thumb Code   134  balance.o(i.Set_Pwm)
+    Smooth_control                           0x080047e9   Thumb Code   432  balance.o(i.Smooth_control)
+    SysTick_CLKSourceConfig                  0x080049a5   Thumb Code    40  misc.o(i.SysTick_CLKSourceConfig)
+    SysTick_Handler                          0x080049cd   Thumb Code    16  delay.o(i.SysTick_Handler)
+    SystemInit                               0x080049dd   Thumb Code    88  system_stm32f4xx.o(i.SystemInit)
+    TIM10_PWM_Init                           0x08004b69   Thumb Code   150  motor.o(i.TIM10_PWM_Init)
+    TIM11_PWM_Init                           0x08004c09   Thumb Code   158  motor.o(i.TIM11_PWM_Init)
+    TIM12_SERVO_Init                         0x08004cb1   Thumb Code   196  timer.o(i.TIM12_SERVO_Init)
+    TIM1_PWM_Init                            0x08004d7d   Thumb Code   238  motor.o(i.TIM1_PWM_Init)
+    TIM2_IRQHandler                          0x08004e75   Thumb Code    24  encoder.o(i.TIM2_IRQHandler)
+    TIM3_IRQHandler                          0x08004e8d   Thumb Code    18  encoder.o(i.TIM3_IRQHandler)
+    TIM4_IRQHandler                          0x08004ea5   Thumb Code    18  encoder.o(i.TIM4_IRQHandler)
+    TIM5_IRQHandler                          0x08004ebd   Thumb Code    18  encoder.o(i.TIM5_IRQHandler)
+    TIM8_BRK_TIM12_IRQHandler                0x08004ed5   Thumb Code    18  encoder.o(i.TIM8_BRK_TIM12_IRQHandler)
+    TIM8_CC_IRQHandler                       0x08004eed   Thumb Code   810  timer.o(i.TIM8_CC_IRQHandler)
+    TIM8_Cap_Init                            0x08005299   Thumb Code   328  timer.o(i.TIM8_Cap_Init)
+    TIM8_UP_TIM13_IRQHandler                 0x080053e9   Thumb Code    14  timer.o(i.TIM8_UP_TIM13_IRQHandler)
+    TIM9_PWM_Init                            0x080053fd   Thumb Code   174  motor.o(i.TIM9_PWM_Init)
+    TIM_ARRPreloadConfig                     0x080054b5   Thumb Code    24  stm32f4xx_tim.o(i.TIM_ARRPreloadConfig)
+    TIM_ClearFlag                            0x080054cd   Thumb Code     6  stm32f4xx_tim.o(i.TIM_ClearFlag)
+    TIM_ClearITPendingBit                    0x080054d3   Thumb Code     6  stm32f4xx_tim.o(i.TIM_ClearITPendingBit)
+    TIM_Cmd                                  0x080054d9   Thumb Code    24  stm32f4xx_tim.o(i.TIM_Cmd)
+    TIM_CtrlPWMOutputs                       0x080054f1   Thumb Code    30  stm32f4xx_tim.o(i.TIM_CtrlPWMOutputs)
+    TIM_EncoderInterfaceConfig               0x0800550f   Thumb Code    66  stm32f4xx_tim.o(i.TIM_EncoderInterfaceConfig)
+    TIM_GetCapture1                          0x08005551   Thumb Code     6  stm32f4xx_tim.o(i.TIM_GetCapture1)
+    TIM_GetCapture2                          0x08005557   Thumb Code     6  stm32f4xx_tim.o(i.TIM_GetCapture2)
+    TIM_GetCapture3                          0x0800555d   Thumb Code     6  stm32f4xx_tim.o(i.TIM_GetCapture3)
+    TIM_GetCapture4                          0x08005563   Thumb Code     6  stm32f4xx_tim.o(i.TIM_GetCapture4)
+    TIM_GetITStatus                          0x08005569   Thumb Code    34  stm32f4xx_tim.o(i.TIM_GetITStatus)
+    TIM_ICInit                               0x0800558b   Thumb Code   110  stm32f4xx_tim.o(i.TIM_ICInit)
+    TIM_ICStructInit                         0x080055f9   Thumb Code    18  stm32f4xx_tim.o(i.TIM_ICStructInit)
+    TIM_ITConfig                             0x0800560b   Thumb Code    18  stm32f4xx_tim.o(i.TIM_ITConfig)
+    TIM_OC1Init                              0x0800561d   Thumb Code   114  stm32f4xx_tim.o(i.TIM_OC1Init)
+    TIM_OC1PolarityConfig                    0x08005699   Thumb Code    18  stm32f4xx_tim.o(i.TIM_OC1PolarityConfig)
+    TIM_OC1PreloadConfig                     0x080056ab   Thumb Code    18  stm32f4xx_tim.o(i.TIM_OC1PreloadConfig)
+    TIM_OC2Init                              0x080056bd   Thumb Code   154  stm32f4xx_tim.o(i.TIM_OC2Init)
+    TIM_OC2PolarityConfig                    0x08005761   Thumb Code    26  stm32f4xx_tim.o(i.TIM_OC2PolarityConfig)
+    TIM_OC2PreloadConfig                     0x0800577b   Thumb Code    26  stm32f4xx_tim.o(i.TIM_OC2PreloadConfig)
+    TIM_OC3Init                              0x08005795   Thumb Code   150  stm32f4xx_tim.o(i.TIM_OC3Init)
+    TIM_OC3PolarityConfig                    0x08005835   Thumb Code    26  stm32f4xx_tim.o(i.TIM_OC3PolarityConfig)
+    TIM_OC3PreloadConfig                     0x0800584f   Thumb Code    18  stm32f4xx_tim.o(i.TIM_OC3PreloadConfig)
+    TIM_OC4Init                              0x08005861   Thumb Code   112  stm32f4xx_tim.o(i.TIM_OC4Init)
+    TIM_OC4PolarityConfig                    0x080058d9   Thumb Code    26  stm32f4xx_tim.o(i.TIM_OC4PolarityConfig)
+    TIM_OC4PreloadConfig                     0x080058f3   Thumb Code    26  stm32f4xx_tim.o(i.TIM_OC4PreloadConfig)
+    TIM_SetCounter                           0x0800590d   Thumb Code     4  stm32f4xx_tim.o(i.TIM_SetCounter)
+    TIM_SetIC1Prescaler                      0x08005911   Thumb Code    18  stm32f4xx_tim.o(i.TIM_SetIC1Prescaler)
+    TIM_SetIC2Prescaler                      0x08005923   Thumb Code    26  stm32f4xx_tim.o(i.TIM_SetIC2Prescaler)
+    TIM_SetIC3Prescaler                      0x0800593d   Thumb Code    18  stm32f4xx_tim.o(i.TIM_SetIC3Prescaler)
+    TIM_SetIC4Prescaler                      0x0800594f   Thumb Code    26  stm32f4xx_tim.o(i.TIM_SetIC4Prescaler)
+    TIM_TimeBaseInit                         0x08005969   Thumb Code   104  stm32f4xx_tim.o(i.TIM_TimeBaseInit)
+    TIM_TimeBaseStructInit                   0x080059ed   Thumb Code    18  stm32f4xx_tim.o(i.TIM_TimeBaseStructInit)
+    Turn_Off                                 0x08005a01   Thumb Code    54  balance.o(i.Turn_Off)
+    UART5_IRQHandler                         0x08005a51   Thumb Code   246  usartx.o(i.UART5_IRQHandler)
+    USART1_IRQHandler                        0x08005b81   Thumb Code   282  usartx.o(i.USART1_IRQHandler)
+    USART1_SEND                              0x08005cd5   Thumb Code    26  usartx.o(i.USART1_SEND)
+    USART2_IRQHandler                        0x08005cf5   Thumb Code   646  usartx.o(i.USART2_IRQHandler)
+    USART3_IRQHandler                        0x08005fe5   Thumb Code   256  usartx.o(i.USART3_IRQHandler)
+    USART3_SEND                              0x08006125   Thumb Code    26  usartx.o(i.USART3_SEND)
+    USART5_SEND                              0x08006145   Thumb Code    26  usartx.o(i.USART5_SEND)
+    USART_Cmd                                0x08006165   Thumb Code    24  stm32f4xx_usart.o(i.USART_Cmd)
+    USART_GetITStatus                        0x0800617d   Thumb Code    84  stm32f4xx_usart.o(i.USART_GetITStatus)
+    USART_ITConfig                           0x080061d1   Thumb Code    74  stm32f4xx_usart.o(i.USART_ITConfig)
+    USART_Init                               0x0800621d   Thumb Code   204  stm32f4xx_usart.o(i.USART_Init)
+    USART_ReceiveData                        0x080062f1   Thumb Code    10  stm32f4xx_usart.o(i.USART_ReceiveData)
+    UsageFault_Handler                       0x080062fb   Thumb Code     4  stm32f4xx_it.o(i.UsageFault_Handler)
+    Vz_to_Akm_Angle                          0x08006301   Thumb Code   188  usartx.o(i.Vz_to_Akm_Angle)
+    XYZ_Target_Speed_transition              0x080063d9   Thumb Code   102  usartx.o(i.XYZ_Target_Speed_transition)
+    __ARM_fpclassify                         0x08006449   Thumb Code    48  fpclassify.o(i.__ARM_fpclassify)
+    __hardfp_atan                            0x08006479   Thumb Code   622  atan.o(i.__hardfp_atan)
+    __hardfp_pow                             0x08006751   Thumb Code  3072  pow.o(i.__hardfp_pow)
+    __hardfp_sqrt                            0x080073a1   Thumb Code   122  sqrt.o(i.__hardfp_sqrt)
+    __hardfp_tan                             0x08007421   Thumb Code   108  tan.o(i.__hardfp_tan)
+    __ieee754_rem_pio2                       0x080074a1   Thumb Code   938  rred.o(i.__ieee754_rem_pio2)
+    __kernel_poly                            0x080078d9   Thumb Code   248  poly.o(i.__kernel_poly)
+    __kernel_tan                             0x080079d1   Thumb Code   764  tan_i.o(i.__kernel_tan)
+    __mathlib_dbl_divzero                    0x08007d21   Thumb Code    28  dunder.o(i.__mathlib_dbl_divzero)
+    __mathlib_dbl_infnan                     0x08007d51   Thumb Code    20  dunder.o(i.__mathlib_dbl_infnan)
+    __mathlib_dbl_infnan2                    0x08007d65   Thumb Code    20  dunder.o(i.__mathlib_dbl_infnan2)
+    __mathlib_dbl_invalid                    0x08007d79   Thumb Code    24  dunder.o(i.__mathlib_dbl_invalid)
+    __mathlib_dbl_overflow                   0x08007d99   Thumb Code    24  dunder.o(i.__mathlib_dbl_overflow)
+    __mathlib_dbl_underflow                  0x08007db9   Thumb Code    24  dunder.o(i.__mathlib_dbl_underflow)
+    _sys_exit                                0x08007dd9   Thumb Code     4  usart.o(i._sys_exit)
+    click_N_Double_MPU6050                   0x08007ddd   Thumb Code   184  key.o(i.click_N_Double_MPU6050)
+    data_task                                0x08007ead   Thumb Code    40  usartx.o(i.data_task)
+    data_transition                          0x08007ed5   Thumb Code  1342  usartx.o(i.data_transition)
+    delay_init                               0x08008425   Thumb Code    58  delay.o(i.delay_init)
+    delay_ms                                 0x08008469   Thumb Code    60  delay.o(i.delay_ms)
+    delay_us                                 0x080084a9   Thumb Code    68  delay.o(i.delay_us)
+    fabs                                     0x080084f1   Thumb Code    24  fabs.o(i.fabs)
+    float_abs                                0x08008509   Thumb Code    26  balance.o(i.float_abs)
+    fputc                                    0x08008525   Thumb Code    24  usart.o(i.fputc)
+    getSysTickCnt                            0x08008541   Thumb Code    22  delay.o(i.getSysTickCnt)
+    led_task                                 0x0800855d   Thumb Code    24  led.o(i.led_task)
+    main                                     0x08008581   Thumb Code    34  main.o(i.main)
+    oled_pow                                 0x080085b9   Thumb Code    22  oled.o(i.oled_pow)
+    oled_show                                0x080085d1   Thumb Code  2932  show.o(i.oled_show)
+    pstwo_task                               0x08009ccd   Thumb Code    24  pstwo.o(i.pstwo_task)
+    pvPortMalloc                             0x08009ce5   Thumb Code   262  heap_4.o(i.pvPortMalloc)
+    pvTaskIncrementMutexHeldCount            0x08009e39   Thumb Code    26  tasks.o(i.pvTaskIncrementMutexHeldCount)
+    pxPortInitialiseStack                    0x08009e59   Thumb Code    38  port.o(i.pxPortInitialiseStack)
+    show_task                                0x08009e85   Thumb Code   360  show.o(i.show_task)
+    sqrt                                     0x0800a011   Thumb Code   110  sqrt.o(i.sqrt)
+    start_task                               0x0800a081   Thumb Code   146  main.o(i.start_task)
+    systemInit                               0x0800a181   Thumb Code   190  system.o(i.systemInit)
+    target_limit_float                       0x0800a23f   Thumb Code    42  balance.o(i.target_limit_float)
+    target_limit_int                         0x0800a269   Thumb Code    22  balance.o(i.target_limit_int)
+    uart1_init                               0x0800a281   Thumb Code   168  usartx.o(i.uart1_init)
+    uart2_init                               0x0800a331   Thumb Code   166  usartx.o(i.uart2_init)
+    uart3_init                               0x0800a3e1   Thumb Code   168  usartx.o(i.uart3_init)
+    uart5_init                               0x0800a491   Thumb Code   212  usartx.o(i.uart5_init)
+    usart1_send                              0x0800a571   Thumb Code    20  usartx.o(i.usart1_send)
+    usart3_send                              0x0800a589   Thumb Code    22  usartx.o(i.usart3_send)
+    usart5_send                              0x0800a5a5   Thumb Code    20  usartx.o(i.usart5_send)
+    uxListRemove                             0x0800a5bd   Thumb Code    40  list.o(i.uxListRemove)
+    vListInitialise                          0x0800a5e5   Thumb Code    26  list.o(i.vListInitialise)
+    vListInitialiseItem                      0x0800a5ff   Thumb Code     6  list.o(i.vListInitialiseItem)
+    vListInsert                              0x0800a605   Thumb Code    52  list.o(i.vListInsert)
+    vListInsertEnd                           0x0800a639   Thumb Code    24  list.o(i.vListInsertEnd)
+    vPortEnterCritical                       0x0800a651   Thumb Code    68  port.o(i.vPortEnterCritical)
+    vPortExitCritical                        0x0800a6d9   Thumb Code    48  port.o(i.vPortExitCritical)
+    vPortFree                                0x0800a749   Thumb Code   120  heap_4.o(i.vPortFree)
+    vPortSetupTimerInterrupt                 0x0800a801   Thumb Code    26  port.o(i.vPortSetupTimerInterrupt)
+    vPortValidateInterruptPriority           0x0800a821   Thumb Code    86  port.o(i.vPortValidateInterruptPriority)
+    vQueueAddToRegistry                      0x0800a8c1   Thumb Code    38  queue.o(i.vQueueAddToRegistry)
+    vQueueWaitForMessageRestricted           0x0800a8ed   Thumb Code    74  queue.o(i.vQueueWaitForMessageRestricted)
+    vTaskDelay                               0x0800a939   Thumb Code    72  tasks.o(i.vTaskDelay)
+    vTaskDelayUntil                          0x0800a9ad   Thumb Code   170  tasks.o(i.vTaskDelayUntil)
+    vTaskDelete                              0x0800aa89   Thumb Code   192  tasks.o(i.vTaskDelete)
+    vTaskMissedYield                         0x0800ab95   Thumb Code     8  tasks.o(i.vTaskMissedYield)
+    vTaskPlaceOnEventList                    0x0800aba1   Thumb Code    42  tasks.o(i.vTaskPlaceOnEventList)
+    vTaskPlaceOnEventListRestricted          0x0800abf5   Thumb Code    50  tasks.o(i.vTaskPlaceOnEventListRestricted)
+    vTaskPriorityInherit                     0x0800ac51   Thumb Code   164  tasks.o(i.vTaskPriorityInherit)
+    vTaskSetTimeOutState                     0x0800ad01   Thumb Code    32  tasks.o(i.vTaskSetTimeOutState)
+    vTaskStartScheduler                      0x0800ad4d   Thumb Code   108  tasks.o(i.vTaskStartScheduler)
+    vTaskSuspendAll                          0x0800adf9   Thumb Code    12  tasks.o(i.vTaskSuspendAll)
+    vTaskSwitchContext                       0x0800ae09   Thumb Code   110  tasks.o(i.vTaskSwitchContext)
+    xPortStartScheduler                      0x0800aeb1   Thumb Code   258  port.o(i.xPortStartScheduler)
+    xPortSysTickHandler                      0x0800b00d   Thumb Code    46  port.o(i.xPortSysTickHandler)
+    xQueueGenericCreate                      0x0800b041   Thumb Code    78  queue.o(i.xQueueGenericCreate)
+    xQueueGenericReceive                     0x0800b0b5   Thumb Code   416  queue.o(i.xQueueGenericReceive)
+    xQueueGenericReset                       0x0800b27d   Thumb Code   136  queue.o(i.xQueueGenericReset)
+    xQueueGenericSend                        0x0800b32d   Thumb Code   412  queue.o(i.xQueueGenericSend)
+    xQueueGenericSendFromISR                 0x0800b4f1   Thumb Code   234  queue.o(i.xQueueGenericSendFromISR)
+    xTaskCheckForTimeOut                     0x0800b601   Thumb Code   116  tasks.o(i.xTaskCheckForTimeOut)
+    xTaskCreate                              0x0800b6a1   Thumb Code    96  tasks.o(i.xTaskCreate)
+    xTaskGetSchedulerState                   0x0800b701   Thumb Code    24  tasks.o(i.xTaskGetSchedulerState)
+    xTaskGetTickCount                        0x0800b721   Thumb Code     6  tasks.o(i.xTaskGetTickCount)
+    xTaskIncrementTick                       0x0800b72d   Thumb Code   272  tasks.o(i.xTaskIncrementTick)
+    xTaskPriorityDisinherit                  0x0800b88d   Thumb Code   168  tasks.o(i.xTaskPriorityDisinherit)
+    xTaskRemoveFromEventList                 0x0800b965   Thumb Code   118  tasks.o(i.xTaskRemoveFromEventList)
+    xTaskResumeAll                           0x0800ba19   Thumb Code   214  tasks.o(i.xTaskResumeAll)
+    xTimerCreateTimerTask                    0x0800bb39   Thumb Code    56  timers.o(i.xTimerCreateTimerTask)
+    xTimerGenericCommand                     0x0800bbad   Thumb Code   118  timers.o(i.xTimerGenericCommand)
+    __aeabi_dneg                             0x0800bc51   Thumb Code     0  basic.o(x$fpl$basic)
+    _dneg                                    0x0800bc51   Thumb Code     6  basic.o(x$fpl$basic)
+    __aeabi_fneg                             0x0800bc57   Thumb Code     0  basic.o(x$fpl$basic)
+    _fneg                                    0x0800bc57   Thumb Code     6  basic.o(x$fpl$basic)
+    _dabs                                    0x0800bc5d   Thumb Code     6  basic.o(x$fpl$basic)
+    _fabs                                    0x0800bc63   Thumb Code     6  basic.o(x$fpl$basic)
+    __aeabi_d2f                              0x0800bc69   Thumb Code     0  d2f.o(x$fpl$d2f)
+    _d2f                                     0x0800bc69   Thumb Code    98  d2f.o(x$fpl$d2f)
+    __aeabi_dadd                             0x0800bccd   Thumb Code     0  daddsub_clz.o(x$fpl$dadd)
+    _dadd                                    0x0800bccd   Thumb Code   332  daddsub_clz.o(x$fpl$dadd)
+    __fpl_dcheck_NaN1                        0x0800be1d   Thumb Code    10  dcheck1.o(x$fpl$dcheck1)
+    __fpl_dcmp_Inf                           0x0800be2d   Thumb Code    24  dcmpi.o(x$fpl$dcmpinf)
+    __aeabi_ddiv                             0x0800be45   Thumb Code     0  ddiv.o(x$fpl$ddiv)
+    _ddiv                                    0x0800be45   Thumb Code   552  ddiv.o(x$fpl$ddiv)
+    __aeabi_d2iz                             0x0800c0f5   Thumb Code     0  dfix.o(x$fpl$dfix)
+    _dfix                                    0x0800c0f5   Thumb Code    94  dfix.o(x$fpl$dfix)
+    __aeabi_i2d                              0x0800c153   Thumb Code     0  dflt_clz.o(x$fpl$dflt)
+    _dflt                                    0x0800c153   Thumb Code    46  dflt_clz.o(x$fpl$dflt)
+    __aeabi_ui2d                             0x0800c181   Thumb Code     0  dflt_clz.o(x$fpl$dfltu)
+    _dfltu                                   0x0800c181   Thumb Code    38  dflt_clz.o(x$fpl$dfltu)
+    __aeabi_cdcmple                          0x0800c1a9   Thumb Code     0  dleqf.o(x$fpl$dleqf)
+    _dcmple                                  0x0800c1a9   Thumb Code   120  dleqf.o(x$fpl$dleqf)
+    __fpl_dcmple_InfNaN                      0x0800c20b   Thumb Code     0  dleqf.o(x$fpl$dleqf)
+    __aeabi_dmul                             0x0800c221   Thumb Code     0  dmul.o(x$fpl$dmul)
+    _dmul                                    0x0800c221   Thumb Code   332  dmul.o(x$fpl$dmul)
+    __fpl_dnaninf                            0x0800c375   Thumb Code   156  dnaninf.o(x$fpl$dnaninf)
+    __fpl_dretinf                            0x0800c411   Thumb Code    12  dretinf.o(x$fpl$dretinf)
+    __aeabi_cdrcmple                         0x0800c41d   Thumb Code     0  drleqf.o(x$fpl$drleqf)
+    _drcmple                                 0x0800c41d   Thumb Code   108  drleqf.o(x$fpl$drleqf)
+    __aeabi_drsub                            0x0800c489   Thumb Code     0  daddsub_clz.o(x$fpl$drsb)
+    _drsb                                    0x0800c489   Thumb Code    22  daddsub_clz.o(x$fpl$drsb)
+    _dsqrt                                   0x0800c4a1   Thumb Code   404  dsqrt_umaal.o(x$fpl$dsqrt)
+    __aeabi_dsub                             0x0800c639   Thumb Code     0  daddsub_clz.o(x$fpl$dsub)
+    _dsub                                    0x0800c639   Thumb Code   464  daddsub_clz.o(x$fpl$dsub)
+    __aeabi_f2d                              0x0800c80d   Thumb Code     0  f2d.o(x$fpl$f2d)
+    _f2d                                     0x0800c80d   Thumb Code    86  f2d.o(x$fpl$f2d)
+    __fpl_fnaninf                            0x0800c863   Thumb Code   140  fnaninf.o(x$fpl$fnaninf)
+    _fp_init                                 0x0800c8ef   Thumb Code    10  fpinit.o(x$fpl$fpinit)
+    __fplib_config_fpu_vfp                   0x0800c8f7   Thumb Code     0  fpinit.o(x$fpl$fpinit)
+    __fplib_config_pureend_doubles           0x0800c8f7   Thumb Code     0  fpinit.o(x$fpl$fpinit)
+    __fpl_fretinf                            0x0800c8f9   Thumb Code    10  fretinf.o(x$fpl$fretinf)
+    __fpl_return_NaN                         0x0800c903   Thumb Code   100  retnan.o(x$fpl$retnan)
+    __ARM_scalbn                             0x0800c967   Thumb Code    92  scalbn.o(x$fpl$scalbn)
+    __fpl_cmpreturn                          0x0800c9c3   Thumb Code    48  trapv.o(x$fpl$trapveneer)
+    __I$use$fp                               0x0800c9f2   Number         0  usenofp.o(x$fpl$usenofp)
+    oled_asc2_1206                           0x0800c9f2   Data        1140  oled.o(.constdata)
+    oled_asc2_1608                           0x0800ce66   Data        1520  oled.o(.constdata)
+    Hzk16                                    0x0800d456   Data        2624  oled.o(.constdata)
+    __mathlib_zero                           0x0800dfb8   Data           8  qnan.o(.constdata)
+    Region$$Table$$Base                      0x0800e0e8   Number         0  anon$$obj.o(Region$$Table)
+    Region$$Table$$Limit                     0x0800e108   Number         0  anon$$obj.o(Region$$Table)
+    StartTask_Handler                        0x20000000   Data           4  main.o(.data)
+    SystemCoreClock                          0x20000004   Data           4  system_stm32f4xx.o(.data)
+    AHBPrescTable                            0x20000008   Data          16  system_stm32f4xx.o(.data)
+    Voltage                                  0x20000018   Data           4  adc.o(.data)
+    Voltage_Count                            0x2000001c   Data           4  adc.o(.data)
+    Voltage_All                              0x20000020   Data           4  adc.o(.data)
+    Led_Count                                0x20000038   Data           4  led.o(.data)
+    Handkey                                  0x20000040   Data           2  pstwo.o(.data)
+    Comd                                     0x20000042   Data           2  pstwo.o(.data)
+    MASK                                     0x20000044   Data          32  pstwo.o(.data)
+    TIM8CH1_CAPTURE_STA                      0x20000068   Data           1  timer.o(.data)
+    TIM8CH1_CAPTURE_UPVAL                    0x2000006a   Data           2  timer.o(.data)
+    TIM8CH1_CAPTURE_DOWNVAL                  0x2000006c   Data           2  timer.o(.data)
+    TIM8CH2_CAPTURE_STA                      0x2000006e   Data           1  timer.o(.data)
+    TIM8CH2_CAPTURE_UPVAL                    0x20000070   Data           2  timer.o(.data)
+    TIM8CH2_CAPTURE_DOWNVAL                  0x20000072   Data           2  timer.o(.data)
+    TIM8CH3_CAPTURE_STA                      0x20000074   Data           1  timer.o(.data)
+    TIM8CH3_CAPTURE_UPVAL                    0x20000076   Data           2  timer.o(.data)
+    TIM8CH3_CAPTURE_DOWNVAL                  0x20000078   Data           2  timer.o(.data)
+    TIM8CH4_CAPTURE_STA                      0x2000007a   Data           1  timer.o(.data)
+    TIM8CH4_CAPTURE_UPVAL                    0x2000007c   Data           2  timer.o(.data)
+    TIM8CH4_CAPTURE_DOWNVAL                  0x2000007e   Data           2  timer.o(.data)
+    TIM8_T1                                  0x20000080   Data           4  timer.o(.data)
+    TIM8_T2                                  0x20000084   Data           4  timer.o(.data)
+    TIM8_T3                                  0x20000088   Data           4  timer.o(.data)
+    TIM8_T4                                  0x2000008c   Data           4  timer.o(.data)
+    Remoter_Ch1                              0x20000090   Data           4  timer.o(.data)
+    Remoter_Ch2                              0x20000094   Data           4  timer.o(.data)
+    Remoter_Ch3                              0x20000098   Data           4  timer.o(.data)
+    Remoter_Ch4                              0x2000009c   Data           4  timer.o(.data)
+    L_Remoter_Ch1                            0x200000a0   Data           4  timer.o(.data)
+    L_Remoter_Ch2                            0x200000a4   Data           4  timer.o(.data)
+    L_Remoter_Ch3                            0x200000a8   Data           4  timer.o(.data)
+    L_Remoter_Ch4                            0x200000ac   Data           4  timer.o(.data)
+    test_movz                                0x200000b0   Data           4  usartx.o(.data)
+    test_z                                   0x200000b4   Data           4  usartx.o(.data)
+    __stdout                                 0x200000d0   Data           4  usart.o(.data)
+    USART_RX_STA                             0x200000d4   Data           2  usart.o(.data)
+    pxCurrentTCB                             0x200000e8   Data           4  tasks.o(.data)
+    Flag_Stop                                0x2000015c   Data           1  system.o(.data)
+    Divisor_Mode                             0x20000160   Data           4  system.o(.data)
+    Car_Mode                                 0x20000164   Data           1  system.o(.data)
+    Servo                                    0x20000168   Data           4  system.o(.data)
+    RC_Velocity                              0x2000016c   Data           4  system.o(.data)
+    Move_X                                   0x20000170   Data           4  system.o(.data)
+    Move_Y                                   0x20000174   Data           4  system.o(.data)
+    Move_Z                                   0x20000178   Data           4  system.o(.data)
+    Velocity_KP                              0x2000017c   Data           4  system.o(.data)
+    Velocity_KI                              0x20000180   Data           4  system.o(.data)
+    Encoder_precision                        0x20000184   Data           4  system.o(.data)
+    Wheel_perimeter                          0x20000188   Data           4  system.o(.data)
+    Wheel_spacing                            0x2000018c   Data           4  system.o(.data)
+    Axle_spacing                             0x20000190   Data           4  system.o(.data)
+    Omni_turn_radiaus                        0x20000194   Data           4  system.o(.data)
+    PS2_ON_Flag                              0x20000198   Data           1  system.o(.data)
+    APP_ON_Flag                              0x20000199   Data           1  system.o(.data)
+    Remote_ON_Flag                           0x2000019a   Data           1  system.o(.data)
+    CAN_ON_Flag                              0x2000019b   Data           1  system.o(.data)
+    Usart1_ON_Flag                           0x2000019c   Data           1  system.o(.data)
+    Usart5_ON_Flag                           0x2000019d   Data           1  system.o(.data)
+    Flag_Left                                0x2000019e   Data           1  system.o(.data)
+    Flag_Right                               0x2000019f   Data           1  system.o(.data)
+    Flag_Direction                           0x200001a0   Data           1  system.o(.data)
+    Turn_Flag                                0x200001a1   Data           1  system.o(.data)
+    PID_Send                                 0x200001a2   Data           1  system.o(.data)
+    PS2_LX                                   0x200001a4   Data           4  system.o(.data)
+    PS2_LY                                   0x200001a8   Data           4  system.o(.data)
+    PS2_RX                                   0x200001ac   Data           4  system.o(.data)
+    PS2_RY                                   0x200001b0   Data           4  system.o(.data)
+    PS2_KEY                                  0x200001b4   Data           4  system.o(.data)
+    Check                                    0x200001b8   Data           4  system.o(.data)
+    Checking                                 0x200001bc   Data           4  system.o(.data)
+    Checked                                  0x200001c0   Data           4  system.o(.data)
+    CheckCount                               0x200001c4   Data           4  system.o(.data)
+    CheckPhrase1                             0x200001c8   Data           4  system.o(.data)
+    CheckPhrase2                             0x200001cc   Data           4  system.o(.data)
+    ErrorCode                                0x200001d0   Data           4  system.o(.data)
+    Time_count                               0x200001d4   Data           4  balance.o(.data)
+    robot_mode_check_flag                    0x200001d8   Data           4  balance.o(.data)
+    test_num                                 0x200001dc   Data           2  balance.o(.data)
+    command_lost_count                       0x200001de   Data           1  balance.o(.data)
+    Voltage_Show                             0x20000214   Data           4  show.o(.data)
+    i                                        0x20000218   Data           1  show.o(.data)
+    Send_Count                               0x20000219   Data           1  show.o(.data)
+    Buzzer_count                             0x2000021c   Data           4  show.o(.data)
+    gyro                                     0x20000230   Data           6  mpu6050.o(.data)
+    accel                                    0x20000236   Data           6  mpu6050.o(.data)
+    sensors                                  0x2000023c   Data           2  mpu6050.o(.data)
+    Deviation_Count                          0x20000240   Data           4  mpu6050.o(.data)
+    sum_gyro                                 0x20000244   Data           6  mpu6050.o(.data)
+    sum_accel                                0x2000024a   Data           6  mpu6050.o(.data)
+    Deviation_gyro                           0x20000250   Data           6  mpu6050.o(.data)
+    Original_gyro                            0x20000256   Data           6  mpu6050.o(.data)
+    Deviation_accel                          0x2000025c   Data           6  mpu6050.o(.data)
+    Original_accel                           0x20000262   Data           6  mpu6050.o(.data)
+    q0                                       0x20000268   Data           4  mpu6050.o(.data)
+    q1                                       0x2000026c   Data           4  mpu6050.o(.data)
+    q2                                       0x20000270   Data           4  mpu6050.o(.data)
+    q3                                       0x20000274   Data           4  mpu6050.o(.data)
+    Gx_offset                                0x20000278   Data           2  mpu6050.o(.data)
+    Gy_offset                                0x2000027a   Data           2  mpu6050.o(.data)
+    Gz_offset                                0x2000027c   Data           2  mpu6050.o(.data)
+    OLED_GRAM                                0x20000280   Data        1024  oled.o(.bss)
+    Data                                     0x20000680   Data           9  pstwo.o(.bss)
+    Send_Data                                0x2000068c   Data          48  usartx.o(.bss)
+    Receive_Data                             0x200006bc   Data          32  usartx.o(.bss)
+    xQueueRegistry                           0x2000071c   Data          64  queue.o(.bss)
+    smooth_control                           0x20005a68   Data          12  system.o(.bss)
+    MOTOR_A                                  0x20005a74   Data          20  system.o(.bss)
+    MOTOR_B                                  0x20005a88   Data          20  system.o(.bss)
+    MOTOR_C                                  0x20005a9c   Data          20  system.o(.bss)
+    MOTOR_D                                  0x20005ab0   Data          20  system.o(.bss)
+    OriginalEncoder                          0x20005ac4   Data          16  balance.o(.bss)
+    Robot_Parament                           0x20005ad4   Data          24  robot_select_init.o(.bss)
+    __libspace_start                         0x20005aec   Data          96  libspace.o(.bss)
+    __temporary_stack_top$libspace           0x20005b4c   Data           0  libspace.o(.bss)
+
+
+
+==============================================================================
+
+Memory Map of the image
+
+  Image Entry point : 0x08000189
+
+  Load Region LR_IROM1 (Base: 0x08000000, Size: 0x0000e388, Max: 0x00100000, ABSOLUTE, COMPRESSED[0x0000e16c])
+
+    Execution Region ER_IROM1 (Exec base: 0x08000000, Load base: 0x08000000, Size: 0x0000e108, Max: 0x00100000, ABSOLUTE)
+
+    Exec Addr    Load Addr    Size         Type   Attr      Idx    E Section Name        Object
+
+    0x08000000   0x08000000   0x00000188   Data   RO         1279    RESET               startup_stm32f40_41xxx.o
+    0x08000188   0x08000188   0x00000008   Code   RO         4684  * !!!main             c_w.l(__main.o)
+    0x08000190   0x08000190   0x00000034   Code   RO         5010    !!!scatter          c_w.l(__scatter.o)
+    0x080001c4   0x080001c4   0x0000005a   Code   RO         5008    !!dczerorl2         c_w.l(__dczerorl2.o)
+    0x0800021e   0x0800021e   0x00000002   PAD
+    0x08000220   0x08000220   0x0000001c   Code   RO         5012    !!handler_zi        c_w.l(__scatter_zi.o)
+    0x0800023c   0x0800023c   0x00000000   Code   RO         4671    .ARM.Collect$$_printf_percent$$00000000  c_w.l(_printf_percent.o)
+    0x0800023c   0x0800023c   0x00000006   Code   RO         4669    .ARM.Collect$$_printf_percent$$00000009  c_w.l(_printf_d.o)
+    0x08000242   0x08000242   0x00000006   Code   RO         4668    .ARM.Collect$$_printf_percent$$00000014  c_w.l(_printf_s.o)
+    0x08000248   0x08000248   0x00000004   Code   RO         4781    .ARM.Collect$$_printf_percent$$00000017  c_w.l(_printf_percent_end.o)
+    0x0800024c   0x0800024c   0x00000002   Code   RO         4881    .ARM.Collect$$libinit$$00000000  c_w.l(libinit.o)
+    0x0800024e   0x0800024e   0x00000004   Code   RO         4886    .ARM.Collect$$libinit$$00000001  c_w.l(libinit2.o)
+    0x08000252   0x08000252   0x00000000   Code   RO         4889    .ARM.Collect$$libinit$$00000004  c_w.l(libinit2.o)
+    0x08000252   0x08000252   0x00000000   Code   RO         4892    .ARM.Collect$$libinit$$0000000A  c_w.l(libinit2.o)
+    0x08000252   0x08000252   0x00000000   Code   RO         4894    .ARM.Collect$$libinit$$0000000C  c_w.l(libinit2.o)
+    0x08000252   0x08000252   0x00000000   Code   RO         4896    .ARM.Collect$$libinit$$0000000E  c_w.l(libinit2.o)
+    0x08000252   0x08000252   0x00000000   Code   RO         4899    .ARM.Collect$$libinit$$00000011  c_w.l(libinit2.o)
+    0x08000252   0x08000252   0x00000000   Code   RO         4901    .ARM.Collect$$libinit$$00000013  c_w.l(libinit2.o)
+    0x08000252   0x08000252   0x00000000   Code   RO         4903    .ARM.Collect$$libinit$$00000015  c_w.l(libinit2.o)
+    0x08000252   0x08000252   0x00000000   Code   RO         4905    .ARM.Collect$$libinit$$00000017  c_w.l(libinit2.o)
+    0x08000252   0x08000252   0x00000000   Code   RO         4907    .ARM.Collect$$libinit$$00000019  c_w.l(libinit2.o)
+    0x08000252   0x08000252   0x00000000   Code   RO         4909    .ARM.Collect$$libinit$$0000001B  c_w.l(libinit2.o)
+    0x08000252   0x08000252   0x00000000   Code   RO         4911    .ARM.Collect$$libinit$$0000001D  c_w.l(libinit2.o)
+    0x08000252   0x08000252   0x00000000   Code   RO         4913    .ARM.Collect$$libinit$$0000001F  c_w.l(libinit2.o)
+    0x08000252   0x08000252   0x00000000   Code   RO         4915    .ARM.Collect$$libinit$$00000021  c_w.l(libinit2.o)
+    0x08000252   0x08000252   0x00000000   Code   RO         4917    .ARM.Collect$$libinit$$00000023  c_w.l(libinit2.o)
+    0x08000252   0x08000252   0x00000000   Code   RO         4919    .ARM.Collect$$libinit$$00000025  c_w.l(libinit2.o)
+    0x08000252   0x08000252   0x00000000   Code   RO         4923    .ARM.Collect$$libinit$$0000002C  c_w.l(libinit2.o)
+    0x08000252   0x08000252   0x00000000   Code   RO         4925    .ARM.Collect$$libinit$$0000002E  c_w.l(libinit2.o)
+    0x08000252   0x08000252   0x00000000   Code   RO         4927    .ARM.Collect$$libinit$$00000030  c_w.l(libinit2.o)
+    0x08000252   0x08000252   0x00000000   Code   RO         4929    .ARM.Collect$$libinit$$00000032  c_w.l(libinit2.o)
+    0x08000252   0x08000252   0x00000002   Code   RO         4930    .ARM.Collect$$libinit$$00000033  c_w.l(libinit2.o)
+    0x08000254   0x08000254   0x00000002   Code   RO         4950    .ARM.Collect$$libshutdown$$00000000  c_w.l(libshutdown.o)
+    0x08000256   0x08000256   0x00000000   Code   RO         4960    .ARM.Collect$$libshutdown$$00000002  c_w.l(libshutdown2.o)
+    0x08000256   0x08000256   0x00000000   Code   RO         4962    .ARM.Collect$$libshutdown$$00000004  c_w.l(libshutdown2.o)
+    0x08000256   0x08000256   0x00000000   Code   RO         4965    .ARM.Collect$$libshutdown$$00000007  c_w.l(libshutdown2.o)
+    0x08000256   0x08000256   0x00000000   Code   RO         4968    .ARM.Collect$$libshutdown$$0000000A  c_w.l(libshutdown2.o)
+    0x08000256   0x08000256   0x00000000   Code   RO         4970    .ARM.Collect$$libshutdown$$0000000C  c_w.l(libshutdown2.o)
+    0x08000256   0x08000256   0x00000000   Code   RO         4973    .ARM.Collect$$libshutdown$$0000000F  c_w.l(libshutdown2.o)
+    0x08000256   0x08000256   0x00000002   Code   RO         4974    .ARM.Collect$$libshutdown$$00000010  c_w.l(libshutdown2.o)
+    0x08000258   0x08000258   0x00000000   Code   RO         4768    .ARM.Collect$$rtentry$$00000000  c_w.l(__rtentry.o)
+    0x08000258   0x08000258   0x00000000   Code   RO         4840    .ARM.Collect$$rtentry$$00000002  c_w.l(__rtentry2.o)
+    0x08000258   0x08000258   0x00000006   Code   RO         4852    .ARM.Collect$$rtentry$$00000004  c_w.l(__rtentry4.o)
+    0x0800025e   0x0800025e   0x00000000   Code   RO         4842    .ARM.Collect$$rtentry$$00000009  c_w.l(__rtentry2.o)
+    0x0800025e   0x0800025e   0x00000004   Code   RO         4843    .ARM.Collect$$rtentry$$0000000A  c_w.l(__rtentry2.o)
+    0x08000262   0x08000262   0x00000000   Code   RO         4845    .ARM.Collect$$rtentry$$0000000C  c_w.l(__rtentry2.o)
+    0x08000262   0x08000262   0x00000008   Code   RO         4846    .ARM.Collect$$rtentry$$0000000D  c_w.l(__rtentry2.o)
+    0x0800026a   0x0800026a   0x00000002   Code   RO         4884    .ARM.Collect$$rtexit$$00000000  c_w.l(rtexit.o)
+    0x0800026c   0x0800026c   0x00000000   Code   RO         4934    .ARM.Collect$$rtexit$$00000002  c_w.l(rtexit2.o)
+    0x0800026c   0x0800026c   0x00000004   Code   RO         4935    .ARM.Collect$$rtexit$$00000003  c_w.l(rtexit2.o)
+    0x08000270   0x08000270   0x00000006   Code   RO         4936    .ARM.Collect$$rtexit$$00000004  c_w.l(rtexit2.o)
+    0x08000276   0x08000276   0x00000002   PAD
+    0x08000278   0x08000278   0x000000b6   Code   RO         4036    .emb_text           port.o
+    0x0800032e   0x0800032e   0x00000002   PAD
+    0x08000330   0x08000330   0x00000040   Code   RO         1280    .text               startup_stm32f40_41xxx.o
+    0x08000370   0x08000370   0x00000002   Code   RO         4631    .text               c_w.l(use_no_semi_2.o)
+    0x08000372   0x08000372   0x00000002   PAD
+    0x08000374   0x08000374   0x00000018   Code   RO         4637    .text               c_w.l(noretval__2printf.o)
+    0x0800038c   0x0800038c   0x00000068   Code   RO         4641    .text               c_w.l(__printf.o)
+    0x080003f4   0x080003f4   0x00000052   Code   RO         4643    .text               c_w.l(_printf_str.o)
+    0x08000446   0x08000446   0x00000002   PAD
+    0x08000448   0x08000448   0x00000078   Code   RO         4645    .text               c_w.l(_printf_dec.o)
+    0x080004c0   0x080004c0   0x0000008a   Code   RO         4676    .text               c_w.l(rt_memcpy_v6.o)
+    0x0800054a   0x0800054a   0x00000010   Code   RO         4678    .text               c_w.l(aeabi_memset.o)
+    0x0800055a   0x0800055a   0x00000044   Code   RO         4680    .text               c_w.l(rt_memclr.o)
+    0x0800059e   0x0800059e   0x00000006   Code   RO         4682    .text               c_w.l(heapauxi.o)
+    0x080005a4   0x080005a4   0x00000002   Code   RO         4766    .text               c_w.l(use_no_semi.o)
+    0x080005a6   0x080005a6   0x00000016   Code   RO         4769    .text               c_w.l(_rserrno.o)
+    0x080005bc   0x080005bc   0x000000b2   Code   RO         4771    .text               c_w.l(_printf_intcommon.o)
+    0x0800066e   0x0800066e   0x00000002   PAD
+    0x08000670   0x08000670   0x00000030   Code   RO         4773    .text               c_w.l(_printf_char_common.o)
+    0x080006a0   0x080006a0   0x0000002c   Code   RO         4777    .text               c_w.l(_printf_char.o)
+    0x080006cc   0x080006cc   0x00000024   Code   RO         4779    .text               c_w.l(_printf_char_file.o)
+    0x080006f0   0x080006f0   0x00000064   Code   RO         4782    .text               c_w.l(rt_memcpy_w.o)
+    0x08000754   0x08000754   0x0000004e   Code   RO         4784    .text               c_w.l(rt_memclr_w.o)
+    0x080007a2   0x080007a2   0x00000002   PAD
+    0x080007a4   0x080007a4   0x00000008   Code   RO         4857    .text               c_w.l(rt_errno_addr_intlibspace.o)
+    0x080007ac   0x080007ac   0x00000008   Code   RO         4861    .text               c_w.l(ferror.o)
+    0x080007b4   0x080007b4   0x00000008   Code   RO         4869    .text               c_w.l(libspace.o)
+    0x080007bc   0x080007bc   0x0000004a   Code   RO         4872    .text               c_w.l(sys_stackheap_outer.o)
+    0x08000806   0x08000806   0x00000012   Code   RO         4874    .text               c_w.l(exit.o)
+    0x08000818   0x08000818   0x00000016   Code   RO         2012    i.ADC_Cmd           stm32f4xx_adc.o
+    0x0800082e   0x0800082e   0x00000002   PAD
+    0x08000830   0x08000830   0x00000030   Code   RO         2013    i.ADC_CommonInit    stm32f4xx_adc.o
+    0x08000860   0x08000860   0x00000008   Code   RO         2024    i.ADC_GetConversionValue  stm32f4xx_adc.o
+    0x08000868   0x08000868   0x00000012   Code   RO         2025    i.ADC_GetFlagStatus  stm32f4xx_adc.o
+    0x0800087a   0x0800087a   0x00000002   PAD
+    0x0800087c   0x0800087c   0x00000054   Code   RO         2032    i.ADC_Init          stm32f4xx_adc.o
+    0x080008d0   0x080008d0   0x000000b8   Code   RO         2037    i.ADC_RegularChannelConfig  stm32f4xx_adc.o
+    0x08000988   0x08000988   0x0000000a   Code   RO         2039    i.ADC_SoftwareStartConv  stm32f4xx_adc.o
+    0x08000992   0x08000992   0x00000002   PAD
+    0x08000994   0x08000994   0x00000144   Code   RO         4375    i.APP_Show          show.o
+    0x08000ad8   0x08000ad8   0x00000084   Code   RO          382    i.Adc_Init          adc.o
+    0x08000b5c   0x08000b5c   0x00000084   Code   RO          383    i.Adc_POWER_Init    adc.o
+    0x08000be0   0x08000be0   0x00000314   Code   RO         4205    i.Balance_task      balance.o
+    0x08000ef4   0x08000ef4   0x00000004   Code   RO          266    i.BusFault_Handler  stm32f4xx_it.o
+    0x08000ef8   0x08000ef8   0x00000038   Code   RO          638    i.Buzzer_Init       led.o
+    0x08000f30   0x08000f30   0x000001f4   Code   RO          439    i.CAN1_Mode_Init    can.o
+    0x08001124   0x08001124   0x0000012c   Code   RO          441    i.CAN1_RX0_IRQHandler  can.o
+    0x08001250   0x08001250   0x000000d8   Code   RO          443    i.CAN1_Rx_Msg       can.o
+    0x08001328   0x08001328   0x00000040   Code   RO          446    i.CAN1_Send_Num     can.o
+    0x08001368   0x08001368   0x0000010c   Code   RO          447    i.CAN1_Tx_Msg       can.o
+    0x08001474   0x08001474   0x00000084   Code   RO          448    i.CAN1_Tx_Staus     can.o
+    0x080014f8   0x080014f8   0x00000012   Code   RO         2260    i.CAN_ITConfig      stm32f4xx_can.o
+    0x0800150a   0x0800150a   0x00000002   PAD
+    0x0800150c   0x0800150c   0x0000006c   Code   RO          998    i.CAN_SEND          usartx.o
+    0x08001578   0x08001578   0x0000003c   Code   RO          999    i.Check_Sum         usartx.o
+    0x080015b4   0x080015b4   0x00000002   Code   RO          267    i.DebugMon_Handler  stm32f4xx_it.o
+    0x080015b6   0x080015b6   0x00000002   PAD
+    0x080015b8   0x080015b8   0x00000808   Code   RO         4206    i.Drive_Motor       balance.o
+    0x08001dc0   0x08001dc0   0x00000030   Code   RO          682    i.Enable_Pin        motor.o
+    0x08001df0   0x08001df0   0x000000e8   Code   RO          513    i.Encoder_Init_TIM2  encoder.o
+    0x08001ed8   0x08001ed8   0x000000bc   Code   RO          514    i.Encoder_Init_TIM3  encoder.o
+    0x08001f94   0x08001f94   0x000000bc   Code   RO          515    i.Encoder_Init_TIM4  encoder.o
+    0x08002050   0x08002050   0x000000bc   Code   RO          516    i.Encoder_Init_TIM5  encoder.o
+    0x0800210c   0x0800210c   0x00000090   Code   RO         1331    i.GPIO_Init         stm32f4xx_gpio.o
+    0x0800219c   0x0800219c   0x00000046   Code   RO         1332    i.GPIO_PinAFConfig  stm32f4xx_gpio.o
+    0x080021e2   0x080021e2   0x00000004   Code   RO         1339    i.GPIO_SetBits      stm32f4xx_gpio.o
+    0x080021e6   0x080021e6   0x00000002   PAD
+    0x080021e8   0x080021e8   0x00000030   Code   RO          384    i.Get_Adc           adc.o
+    0x08002218   0x08002218   0x00000030   Code   RO          385    i.Get_Adc2          adc.o
+    0x08002248   0x08002248   0x000003a0   Code   RO         4207    i.Get_RC            balance.o
+    0x080025e8   0x080025e8   0x00000208   Code   RO         4208    i.Get_Velocity_Form_Encoder  balance.o
+    0x080027f0   0x080027f0   0x0000002e   Code   RO          386    i.Get_adc_Average   adc.o
+    0x0800281e   0x0800281e   0x00000002   PAD
+    0x08002820   0x08002820   0x000000a0   Code   RO          387    i.Get_battery_volt  adc.o
+    0x080028c0   0x080028c0   0x00000004   Code   RO          268    i.HardFault_Handler  stm32f4xx_it.o
+    0x080028c4   0x080028c4   0x0000004c   Code   RO         4529    i.I2C_Ack           i2c.o
+    0x08002910   0x08002910   0x0000004c   Code   RO         4530    i.I2C_GPIOInit      i2c.o
+    0x0800295c   0x0800295c   0x0000004c   Code   RO         4531    i.I2C_NAck          i2c.o
+    0x080029a8   0x080029a8   0x00000070   Code   RO         4533    i.I2C_ReadByte      i2c.o
+    0x08002a18   0x08002a18   0x00000040   Code   RO         4534    i.I2C_ReadOneByte   i2c.o
+    0x08002a58   0x08002a58   0x00000064   Code   RO         4535    i.I2C_Start         i2c.o
+    0x08002abc   0x08002abc   0x00000048   Code   RO         4536    i.I2C_Stop          i2c.o
+    0x08002b04   0x08002b04   0x00000064   Code   RO         4537    i.I2C_WaiteForAck   i2c.o
+    0x08002b68   0x08002b68   0x00000058   Code   RO         4538    i.I2C_WriteBits     i2c.o
+    0x08002bc0   0x08002bc0   0x00000064   Code   RO         4540    i.I2C_WriteByte     i2c.o
+    0x08002c24   0x08002c24   0x00000032   Code   RO         4542    i.I2C_WriteOneByte  i2c.o
+    0x08002c56   0x08002c56   0x00000002   PAD
+    0x08002c58   0x08002c58   0x000000b0   Code   RO         4209    i.Incremental_PI_A  balance.o
+    0x08002d08   0x08002d08   0x000000b0   Code   RO         4210    i.Incremental_PI_B  balance.o
+    0x08002db8   0x08002db8   0x000000b0   Code   RO         4211    i.Incremental_PI_C  balance.o
+    0x08002e68   0x08002e68   0x000000b0   Code   RO         4212    i.Incremental_PI_D  balance.o
+    0x08002f18   0x08002f18   0x00000030   Code   RO          588    i.KEY_Init          key.o
+    0x08002f48   0x08002f48   0x00000038   Code   RO         4213    i.Key               balance.o
+    0x08002f80   0x08002f80   0x00000040   Code   RO          639    i.LED_Init          led.o
+    0x08002fc0   0x08002fc0   0x000000ac   Code   RO         4214    i.Limit_Pwm         balance.o
+    0x0800306c   0x0800306c   0x0000003c   Code   RO         4411    i.MPU6050_Set_LPF   mpu6050.o
+    0x080030a8   0x080030a8   0x0000003c   Code   RO         4412    i.MPU6050_Set_Rate  mpu6050.o
+    0x080030e4   0x080030e4   0x00000088   Code   RO         4414    i.MPU6050_initialize  mpu6050.o
+    0x0800316c   0x0800316c   0x00000014   Code   RO         4417    i.MPU6050_setFullScaleAccelRange  mpu6050.o
+    0x08003180   0x08003180   0x00000014   Code   RO         4418    i.MPU6050_setFullScaleGyroRange  mpu6050.o
+    0x08003194   0x08003194   0x000000dc   Code   RO         4422    i.MPU6050_task      mpu6050.o
+    0x08003270   0x08003270   0x000000bc   Code   RO         4424    i.MPU_Get_Accelscope  mpu6050.o
+    0x0800332c   0x0800332c   0x000000e4   Code   RO         4425    i.MPU_Get_Gyroscope  mpu6050.o
+    0x08003410   0x08003410   0x00000004   Code   RO          269    i.MemManage_Handler  stm32f4xx_it.o
+    0x08003414   0x08003414   0x00000002   Code   RO          270    i.NMI_Handler       stm32f4xx_it.o
+    0x08003416   0x08003416   0x00000002   PAD
+    0x08003418   0x08003418   0x00000078   Code   RO         1286    i.NVIC_Init         misc.o
+    0x08003490   0x08003490   0x00000014   Code   RO         1287    i.NVIC_PriorityGroupConfig  misc.o
+    0x080034a4   0x080034a4   0x00000030   Code   RO          726    i.OLED_Clear        oled.o
+    0x080034d4   0x080034d4   0x00000068   Code   RO          729    i.OLED_DrawPoint    oled.o
+    0x0800353c   0x0800353c   0x00000134   Code   RO          730    i.OLED_Init         oled.o
+    0x08003670   0x08003670   0x0000004c   Code   RO          731    i.OLED_Refresh_Gram  oled.o
+    0x080036bc   0x080036bc   0x000000a8   Code   RO          734    i.OLED_ShowChar     oled.o
+    0x08003764   0x08003764   0x00000094   Code   RO          735    i.OLED_ShowNumber   oled.o
+    0x080037f8   0x080037f8   0x00000044   Code   RO          736    i.OLED_ShowString   oled.o
+    0x0800383c   0x0800383c   0x00000058   Code   RO          737    i.OLED_WR_Byte      oled.o
+    0x08003894   0x08003894   0x0000000c   Code   RO          825    i.PS2_AnologData    pstwo.o
+    0x080038a0   0x080038a0   0x00000018   Code   RO          826    i.PS2_ClearData     pstwo.o
+    0x080038b8   0x080038b8   0x00000090   Code   RO          827    i.PS2_Cmd           pstwo.o
+    0x08003948   0x08003948   0x00000054   Code   RO          828    i.PS2_DataKey       pstwo.o
+    0x0800399c   0x0800399c   0x0000005c   Code   RO          829    i.PS2_EnterConfing  pstwo.o
+    0x080039f8   0x080039f8   0x0000005c   Code   RO          830    i.PS2_ExitConfing   pstwo.o
+    0x08003a54   0x08003a54   0x00000058   Code   RO          831    i.PS2_Init          pstwo.o
+    0x08003aac   0x08003aac   0x00000104   Code   RO          832    i.PS2_Read          pstwo.o
+    0x08003bb0   0x08003bb0   0x000000b4   Code   RO          833    i.PS2_ReadData      pstwo.o
+    0x08003c64   0x08003c64   0x0000001c   Code   RO          836    i.PS2_SetInit       pstwo.o
+    0x08003c80   0x08003c80   0x00000044   Code   RO          837    i.PS2_ShortPoll     pstwo.o
+    0x08003cc4   0x08003cc4   0x00000058   Code   RO          838    i.PS2_TurnOnAnalogMode  pstwo.o
+    0x08003d1c   0x08003d1c   0x00000260   Code   RO         4215    i.PS2_control       balance.o
+    0x08003f7c   0x08003f7c   0x0000000c   Code   RO         2973    i.PWR_BackupAccessCmd  stm32f4xx_pwr.o
+    0x08003f88   0x08003f88   0x00000020   Code   RO         1428    i.RCC_AHB1PeriphClockCmd  stm32f4xx_rcc.o
+    0x08003fa8   0x08003fa8   0x00000020   Code   RO         1437    i.RCC_APB1PeriphClockCmd  stm32f4xx_rcc.o
+    0x08003fc8   0x08003fc8   0x00000020   Code   RO         1440    i.RCC_APB2PeriphClockCmd  stm32f4xx_rcc.o
+    0x08003fe8   0x08003fe8   0x00000020   Code   RO         1442    i.RCC_APB2PeriphResetCmd  stm32f4xx_rcc.o
+    0x08004008   0x08004008   0x000000e8   Code   RO         1449    i.RCC_GetClocksFreq  stm32f4xx_rcc.o
+    0x080040f0   0x080040f0   0x0000002c   Code   RO         1458    i.RCC_LSEConfig     stm32f4xx_rcc.o
+    0x0800411c   0x0800411c   0x00000064   Code   RO          517    i.Read_Encoder      encoder.o
+    0x08004180   0x08004180   0x00000264   Code   RO         4216    i.Remote_Control    balance.o
+    0x080043e4   0x080043e4   0x000000bc   Code   RO         4346    i.Robot_Init        robot_select_init.o
+    0x080044a0   0x080044a0   0x000001c0   Code   RO         4347    i.Robot_Select      robot_select_init.o
+    0x08004660   0x08004660   0x000000ec   Code   RO          345    i.SetSysClock       system_stm32f4xx.o
+    0x0800474c   0x0800474c   0x0000009c   Code   RO         4217    i.Set_Pwm           balance.o
+    0x080047e8   0x080047e8   0x000001bc   Code   RO         4218    i.Smooth_control    balance.o
+    0x080049a4   0x080049a4   0x00000028   Code   RO         1290    i.SysTick_CLKSourceConfig  misc.o
+    0x080049cc   0x080049cc   0x00000010   Code   RO         1159    i.SysTick_Handler   delay.o
+    0x080049dc   0x080049dc   0x00000068   Code   RO          347    i.SystemInit        system_stm32f4xx.o
+    0x08004a44   0x08004a44   0x0000003a   Code   RO         2411    i.TI1_Config        stm32f4xx_tim.o
+    0x08004a7e   0x08004a7e   0x00000050   Code   RO         2412    i.TI2_Config        stm32f4xx_tim.o
+    0x08004ace   0x08004ace   0x00000048   Code   RO         2413    i.TI3_Config        stm32f4xx_tim.o
+    0x08004b16   0x08004b16   0x00000050   Code   RO         2414    i.TI4_Config        stm32f4xx_tim.o
+    0x08004b66   0x08004b66   0x00000002   PAD
+    0x08004b68   0x08004b68   0x000000a0   Code   RO          683    i.TIM10_PWM_Init    motor.o
+    0x08004c08   0x08004c08   0x000000a8   Code   RO          684    i.TIM11_PWM_Init    motor.o
+    0x08004cb0   0x08004cb0   0x000000cc   Code   RO          948    i.TIM12_SERVO_Init  timer.o
+    0x08004d7c   0x08004d7c   0x000000f8   Code   RO          685    i.TIM1_PWM_Init     motor.o
+    0x08004e74   0x08004e74   0x00000018   Code   RO          518    i.TIM2_IRQHandler   encoder.o
+    0x08004e8c   0x08004e8c   0x00000018   Code   RO          519    i.TIM3_IRQHandler   encoder.o
+    0x08004ea4   0x08004ea4   0x00000018   Code   RO          520    i.TIM4_IRQHandler   encoder.o
+    0x08004ebc   0x08004ebc   0x00000018   Code   RO          521    i.TIM5_IRQHandler   encoder.o
+    0x08004ed4   0x08004ed4   0x00000018   Code   RO          522    i.TIM8_BRK_TIM12_IRQHandler  encoder.o
+    0x08004eec   0x08004eec   0x000003ac   Code   RO          949    i.TIM8_CC_IRQHandler  timer.o
+    0x08005298   0x08005298   0x00000150   Code   RO          950    i.TIM8_Cap_Init     timer.o
+    0x080053e8   0x080053e8   0x00000014   Code   RO          952    i.TIM8_UP_TIM13_IRQHandler  timer.o
+    0x080053fc   0x080053fc   0x000000b8   Code   RO          686    i.TIM9_PWM_Init     motor.o
+    0x080054b4   0x080054b4   0x00000018   Code   RO         2415    i.TIM_ARRPreloadConfig  stm32f4xx_tim.o
+    0x080054cc   0x080054cc   0x00000006   Code   RO         2421    i.TIM_ClearFlag     stm32f4xx_tim.o
+    0x080054d2   0x080054d2   0x00000006   Code   RO         2422    i.TIM_ClearITPendingBit  stm32f4xx_tim.o
+    0x080054d8   0x080054d8   0x00000018   Code   RO         2427    i.TIM_Cmd           stm32f4xx_tim.o
+    0x080054f0   0x080054f0   0x0000001e   Code   RO         2429    i.TIM_CtrlPWMOutputs  stm32f4xx_tim.o
+    0x0800550e   0x0800550e   0x00000042   Code   RO         2436    i.TIM_EncoderInterfaceConfig  stm32f4xx_tim.o
+    0x08005550   0x08005550   0x00000006   Code   RO         2442    i.TIM_GetCapture1   stm32f4xx_tim.o
+    0x08005556   0x08005556   0x00000006   Code   RO         2443    i.TIM_GetCapture2   stm32f4xx_tim.o
+    0x0800555c   0x0800555c   0x00000006   Code   RO         2444    i.TIM_GetCapture3   stm32f4xx_tim.o
+    0x08005562   0x08005562   0x00000006   Code   RO         2445    i.TIM_GetCapture4   stm32f4xx_tim.o
+    0x08005568   0x08005568   0x00000022   Code   RO         2448    i.TIM_GetITStatus   stm32f4xx_tim.o
+    0x0800558a   0x0800558a   0x0000006e   Code   RO         2450    i.TIM_ICInit        stm32f4xx_tim.o
+    0x080055f8   0x080055f8   0x00000012   Code   RO         2451    i.TIM_ICStructInit  stm32f4xx_tim.o
+    0x0800560a   0x0800560a   0x00000012   Code   RO         2452    i.TIM_ITConfig      stm32f4xx_tim.o
+    0x0800561c   0x0800561c   0x0000007c   Code   RO         2456    i.TIM_OC1Init       stm32f4xx_tim.o
+    0x08005698   0x08005698   0x00000012   Code   RO         2458    i.TIM_OC1PolarityConfig  stm32f4xx_tim.o
+    0x080056aa   0x080056aa   0x00000012   Code   RO         2459    i.TIM_OC1PreloadConfig  stm32f4xx_tim.o
+    0x080056bc   0x080056bc   0x000000a4   Code   RO         2461    i.TIM_OC2Init       stm32f4xx_tim.o
+    0x08005760   0x08005760   0x0000001a   Code   RO         2463    i.TIM_OC2PolarityConfig  stm32f4xx_tim.o
+    0x0800577a   0x0800577a   0x0000001a   Code   RO         2464    i.TIM_OC2PreloadConfig  stm32f4xx_tim.o
+    0x08005794   0x08005794   0x000000a0   Code   RO         2466    i.TIM_OC3Init       stm32f4xx_tim.o
+    0x08005834   0x08005834   0x0000001a   Code   RO         2468    i.TIM_OC3PolarityConfig  stm32f4xx_tim.o
+    0x0800584e   0x0800584e   0x00000012   Code   RO         2469    i.TIM_OC3PreloadConfig  stm32f4xx_tim.o
+    0x08005860   0x08005860   0x00000078   Code   RO         2471    i.TIM_OC4Init       stm32f4xx_tim.o
+    0x080058d8   0x080058d8   0x0000001a   Code   RO         2472    i.TIM_OC4PolarityConfig  stm32f4xx_tim.o
+    0x080058f2   0x080058f2   0x0000001a   Code   RO         2473    i.TIM_OC4PreloadConfig  stm32f4xx_tim.o
+    0x0800590c   0x0800590c   0x00000004   Code   RO         2493    i.TIM_SetCounter    stm32f4xx_tim.o
+    0x08005910   0x08005910   0x00000012   Code   RO         2494    i.TIM_SetIC1Prescaler  stm32f4xx_tim.o
+    0x08005922   0x08005922   0x0000001a   Code   RO         2495    i.TIM_SetIC2Prescaler  stm32f4xx_tim.o
+    0x0800593c   0x0800593c   0x00000012   Code   RO         2496    i.TIM_SetIC3Prescaler  stm32f4xx_tim.o
+    0x0800594e   0x0800594e   0x0000001a   Code   RO         2497    i.TIM_SetIC4Prescaler  stm32f4xx_tim.o
+    0x08005968   0x08005968   0x00000084   Code   RO         2499    i.TIM_TimeBaseInit  stm32f4xx_tim.o
+    0x080059ec   0x080059ec   0x00000012   Code   RO         2500    i.TIM_TimeBaseStructInit  stm32f4xx_tim.o
+    0x080059fe   0x080059fe   0x00000002   PAD
+    0x08005a00   0x08005a00   0x00000050   Code   RO         4219    i.Turn_Off          balance.o
+    0x08005a50   0x08005a50   0x00000130   Code   RO         1000    i.UART5_IRQHandler  usartx.o
+    0x08005b80   0x08005b80   0x00000154   Code   RO         1001    i.USART1_IRQHandler  usartx.o
+    0x08005cd4   0x08005cd4   0x00000020   Code   RO         1002    i.USART1_SEND       usartx.o
+    0x08005cf4   0x08005cf4   0x000002f0   Code   RO         1003    i.USART2_IRQHandler  usartx.o
+    0x08005fe4   0x08005fe4   0x00000140   Code   RO         1004    i.USART3_IRQHandler  usartx.o
+    0x08006124   0x08006124   0x00000020   Code   RO         1005    i.USART3_SEND       usartx.o
+    0x08006144   0x08006144   0x00000020   Code   RO         1006    i.USART5_SEND       usartx.o
+    0x08006164   0x08006164   0x00000018   Code   RO         1822    i.USART_Cmd         stm32f4xx_usart.o
+    0x0800617c   0x0800617c   0x00000054   Code   RO         1826    i.USART_GetITStatus  stm32f4xx_usart.o
+    0x080061d0   0x080061d0   0x0000004a   Code   RO         1828    i.USART_ITConfig    stm32f4xx_usart.o
+    0x0800621a   0x0800621a   0x00000002   PAD
+    0x0800621c   0x0800621c   0x000000d4   Code   RO         1829    i.USART_Init        stm32f4xx_usart.o
+    0x080062f0   0x080062f0   0x0000000a   Code   RO         1836    i.USART_ReceiveData  stm32f4xx_usart.o
+    0x080062fa   0x080062fa   0x00000004   Code   RO          271    i.UsageFault_Handler  stm32f4xx_it.o
+    0x080062fe   0x080062fe   0x00000002   PAD
+    0x08006300   0x08006300   0x000000d8   Code   RO         1007    i.Vz_to_Akm_Angle   usartx.o
+    0x080063d8   0x080063d8   0x00000070   Code   RO         1008    i.XYZ_Target_Speed_transition  usartx.o
+    0x08006448   0x08006448   0x00000030   Code   RO         4823    i.__ARM_fpclassify  m_wm.l(fpclassify.o)
+    0x08006478   0x08006478   0x000002d8   Code   RO         4714    i.__hardfp_atan     m_wm.l(atan.o)
+    0x08006750   0x08006750   0x00000c50   Code   RO         4728    i.__hardfp_pow      m_wm.l(pow.o)
+    0x080073a0   0x080073a0   0x0000007a   Code   RO         4742    i.__hardfp_sqrt     m_wm.l(sqrt.o)
+    0x0800741a   0x0800741a   0x00000006   PAD
+    0x08007420   0x08007420   0x00000080   Code   RO         4754    i.__hardfp_tan      m_wm.l(tan.o)
+    0x080074a0   0x080074a0   0x00000438   Code   RO         4828    i.__ieee754_rem_pio2  m_wm.l(rred.o)
+    0x080078d8   0x080078d8   0x000000f8   Code   RO         4825    i.__kernel_poly     m_wm.l(poly.o)
+    0x080079d0   0x080079d0   0x00000350   Code   RO         4833    i.__kernel_tan      m_wm.l(tan_i.o)
+    0x08007d20   0x08007d20   0x00000030   Code   RO         4803    i.__mathlib_dbl_divzero  m_wm.l(dunder.o)
+    0x08007d50   0x08007d50   0x00000014   Code   RO         4804    i.__mathlib_dbl_infnan  m_wm.l(dunder.o)
+    0x08007d64   0x08007d64   0x00000014   Code   RO         4805    i.__mathlib_dbl_infnan2  m_wm.l(dunder.o)
+    0x08007d78   0x08007d78   0x00000020   Code   RO         4806    i.__mathlib_dbl_invalid  m_wm.l(dunder.o)
+    0x08007d98   0x08007d98   0x00000020   Code   RO         4807    i.__mathlib_dbl_overflow  m_wm.l(dunder.o)
+    0x08007db8   0x08007db8   0x00000020   Code   RO         4809    i.__mathlib_dbl_underflow  m_wm.l(dunder.o)
+    0x08007dd8   0x08007dd8   0x00000004   Code   RO         1233    i._sys_exit         usart.o
+    0x08007ddc   0x08007ddc   0x000000d0   Code   RO          592    i.click_N_Double_MPU6050  key.o
+    0x08007eac   0x08007eac   0x00000028   Code   RO         1009    i.data_task         usartx.o
+    0x08007ed4   0x08007ed4   0x00000550   Code   RO         1010    i.data_transition   usartx.o
+    0x08008424   0x08008424   0x00000044   Code   RO         1160    i.delay_init        delay.o
+    0x08008468   0x08008468   0x00000040   Code   RO         1161    i.delay_ms          delay.o
+    0x080084a8   0x080084a8   0x00000048   Code   RO         1162    i.delay_us          delay.o
+    0x080084f0   0x080084f0   0x00000018   Code   RO         4819    i.fabs              m_wm.l(fabs.o)
+    0x08008508   0x08008508   0x0000001a   Code   RO         4220    i.float_abs         balance.o
+    0x08008522   0x08008522   0x00000002   PAD
+    0x08008524   0x08008524   0x0000001c   Code   RO         1234    i.fputc             usart.o
+    0x08008540   0x08008540   0x0000001c   Code   RO         1164    i.getSysTickCnt     delay.o
+    0x0800855c   0x0800855c   0x00000024   Code   RO          641    i.led_task          led.o
+    0x08008580   0x08008580   0x00000038   Code   RO            3    i.main              main.o
+    0x080085b8   0x080085b8   0x00000016   Code   RO          738    i.oled_pow          oled.o
+    0x080085ce   0x080085ce   0x00000002   PAD
+    0x080085d0   0x080085d0   0x00000c04   Code   RO         4376    i.oled_show         show.o
+    0x080091d4   0x080091d4   0x00000098   Code   RO         3530    i.prvAddCurrentTaskToDelayedList  tasks.o
+    0x0800926c   0x0800926c   0x000000b8   Code   RO         3531    i.prvAddNewTaskToReadyList  tasks.o
+    0x08009324   0x08009324   0x00000064   Code   RO         3898    i.prvCheckForValidListAndQueue  timers.o
+    0x08009388   0x08009388   0x00000064   Code   RO         3532    i.prvCheckTasksWaitingTermination  tasks.o
+    0x080093ec   0x080093ec   0x0000002a   Code   RO         3292    i.prvCopyDataFromQueue  queue.o
+    0x08009416   0x08009416   0x0000007c   Code   RO         3293    i.prvCopyDataToQueue  queue.o
+    0x08009492   0x08009492   0x00000012   Code   RO         3533    i.prvDeleteTCB      tasks.o
+    0x080094a4   0x080094a4   0x00000028   Code   RO         3899    i.prvGetNextExpireTime  timers.o
+    0x080094cc   0x080094cc   0x0000007c   Code   RO         4121    i.prvHeapInit       heap_4.o
+    0x08009548   0x08009548   0x00000028   Code   RO         3534    i.prvIdleTask       tasks.o
+    0x08009570   0x08009570   0x0000002e   Code   RO         3295    i.prvInitialiseNewQueue  queue.o
+    0x0800959e   0x0800959e   0x00000002   PAD
+    0x080095a0   0x080095a0   0x000000d0   Code   RO         3535    i.prvInitialiseNewTask  tasks.o
+    0x08009670   0x08009670   0x00000068   Code   RO         3536    i.prvInitialiseTaskLists  tasks.o
+    0x080096d8   0x080096d8   0x00000068   Code   RO         4122    i.prvInsertBlockIntoFreeList  heap_4.o
+    0x08009740   0x08009740   0x00000058   Code   RO         3901    i.prvInsertTimerInActiveList  timers.o
+    0x08009798   0x08009798   0x0000001a   Code   RO         3296    i.prvIsQueueEmpty   queue.o
+    0x080097b2   0x080097b2   0x0000001e   Code   RO         3297    i.prvIsQueueFull    queue.o
+    0x080097d0   0x080097d0   0x000000a0   Code   RO         3298    i.prvNotifyQueueSetContainer  queue.o
+    0x08009870   0x08009870   0x00000080   Code   RO         3902    i.prvProcessExpiredTimer  timers.o
+    0x080098f0   0x080098f0   0x0000012c   Code   RO         3903    i.prvProcessReceivedCommands  timers.o
+    0x08009a1c   0x08009a1c   0x00000074   Code   RO         3904    i.prvProcessTimerOrBlockTask  timers.o
+    0x08009a90   0x08009a90   0x00000034   Code   RO         3538    i.prvResetNextTaskUnblockTime  tasks.o
+    0x08009ac4   0x08009ac4   0x0000002c   Code   RO         3905    i.prvSampleTimeNow  timers.o
+    0x08009af0   0x08009af0   0x000000bc   Code   RO         3906    i.prvSwitchTimerLists  timers.o
+    0x08009bac   0x08009bac   0x00000074   Code   RO         4037    i.prvTaskExitError  port.o
+    0x08009c20   0x08009c20   0x0000001a   Code   RO         3907    i.prvTimerTask      timers.o
+    0x08009c3a   0x08009c3a   0x00000092   Code   RO         3299    i.prvUnlockQueue    queue.o
+    0x08009ccc   0x08009ccc   0x00000018   Code   RO          841    i.pstwo_task        pstwo.o
+    0x08009ce4   0x08009ce4   0x00000154   Code   RO         4123    i.pvPortMalloc      heap_4.o
+    0x08009e38   0x08009e38   0x00000020   Code   RO         3542    i.pvTaskIncrementMutexHeldCount  tasks.o
+    0x08009e58   0x08009e58   0x0000002c   Code   RO         4038    i.pxPortInitialiseStack  port.o
+    0x08009e84   0x08009e84   0x0000018c   Code   RO         4377    i.show_task         show.o
+    0x0800a010   0x0800a010   0x0000006e   Code   RO         4744    i.sqrt              m_wm.l(sqrt.o)
+    0x0800a07e   0x0800a07e   0x00000002   PAD
+    0x0800a080   0x0800a080   0x00000100   Code   RO            4    i.start_task        main.o
+    0x0800a180   0x0800a180   0x000000be   Code   RO         4178    i.systemInit        system.o
+    0x0800a23e   0x0800a23e   0x0000002a   Code   RO         4223    i.target_limit_float  balance.o
+    0x0800a268   0x0800a268   0x00000016   Code   RO         4224    i.target_limit_int  balance.o
+    0x0800a27e   0x0800a27e   0x00000002   PAD
+    0x0800a280   0x0800a280   0x000000b0   Code   RO         1011    i.uart1_init        usartx.o
+    0x0800a330   0x0800a330   0x000000b0   Code   RO         1012    i.uart2_init        usartx.o
+    0x0800a3e0   0x0800a3e0   0x000000b0   Code   RO         1013    i.uart3_init        usartx.o
+    0x0800a490   0x0800a490   0x000000e0   Code   RO         1014    i.uart5_init        usartx.o
+    0x0800a570   0x0800a570   0x00000018   Code   RO         1015    i.usart1_send       usartx.o
+    0x0800a588   0x0800a588   0x0000001c   Code   RO         1017    i.usart3_send       usartx.o
+    0x0800a5a4   0x0800a5a4   0x00000018   Code   RO         1018    i.usart5_send       usartx.o
+    0x0800a5bc   0x0800a5bc   0x00000028   Code   RO         3247    i.uxListRemove      list.o
+    0x0800a5e4   0x0800a5e4   0x0000001a   Code   RO         3248    i.vListInitialise   list.o
+    0x0800a5fe   0x0800a5fe   0x00000006   Code   RO         3249    i.vListInitialiseItem  list.o
+    0x0800a604   0x0800a604   0x00000034   Code   RO         3250    i.vListInsert       list.o
+    0x0800a638   0x0800a638   0x00000018   Code   RO         3251    i.vListInsertEnd    list.o
+    0x0800a650   0x0800a650   0x00000088   Code   RO         4040    i.vPortEnterCritical  port.o
+    0x0800a6d8   0x0800a6d8   0x00000070   Code   RO         4041    i.vPortExitCritical  port.o
+    0x0800a748   0x0800a748   0x000000b8   Code   RO         4124    i.vPortFree         heap_4.o
+    0x0800a800   0x0800a800   0x00000020   Code   RO         4042    i.vPortSetupTimerInterrupt  port.o
+    0x0800a820   0x0800a820   0x000000a0   Code   RO         4043    i.vPortValidateInterruptPriority  port.o
+    0x0800a8c0   0x0800a8c0   0x0000002c   Code   RO         3305    i.vQueueAddToRegistry  queue.o
+    0x0800a8ec   0x0800a8ec   0x0000004a   Code   RO         3309    i.vQueueWaitForMessageRestricted  queue.o
+    0x0800a936   0x0800a936   0x00000002   PAD
+    0x0800a938   0x0800a938   0x00000074   Code   RO         3550    i.vTaskDelay        tasks.o
+    0x0800a9ac   0x0800a9ac   0x000000dc   Code   RO         3551    i.vTaskDelayUntil   tasks.o
+    0x0800aa88   0x0800aa88   0x0000010c   Code   RO         3552    i.vTaskDelete       tasks.o
+    0x0800ab94   0x0800ab94   0x0000000c   Code   RO         3556    i.vTaskMissedYield  tasks.o
+    0x0800aba0   0x0800aba0   0x00000054   Code   RO         3558    i.vTaskPlaceOnEventList  tasks.o
+    0x0800abf4   0x0800abf4   0x0000005c   Code   RO         3559    i.vTaskPlaceOnEventListRestricted  tasks.o
+    0x0800ac50   0x0800ac50   0x000000b0   Code   RO         3561    i.vTaskPriorityInherit  tasks.o
+    0x0800ad00   0x0800ad00   0x0000004c   Code   RO         3565    i.vTaskSetTimeOutState  tasks.o
+    0x0800ad4c   0x0800ad4c   0x000000ac   Code   RO         3566    i.vTaskStartScheduler  tasks.o
+    0x0800adf8   0x0800adf8   0x00000010   Code   RO         3568    i.vTaskSuspendAll   tasks.o
+    0x0800ae08   0x0800ae08   0x000000a8   Code   RO         3569    i.vTaskSwitchContext  tasks.o
+    0x0800aeb0   0x0800aeb0   0x0000015c   Code   RO         4044    i.xPortStartScheduler  port.o
+    0x0800b00c   0x0800b00c   0x00000034   Code   RO         4045    i.xPortSysTickHandler  port.o
+    0x0800b040   0x0800b040   0x00000074   Code   RO         3314    i.xQueueGenericCreate  queue.o
+    0x0800b0b4   0x0800b0b4   0x000001c8   Code   RO         3315    i.xQueueGenericReceive  queue.o
+    0x0800b27c   0x0800b27c   0x000000b0   Code   RO         3316    i.xQueueGenericReset  queue.o
+    0x0800b32c   0x0800b32c   0x000001c4   Code   RO         3317    i.xQueueGenericSend  queue.o
+    0x0800b4f0   0x0800b4f0   0x00000110   Code   RO         3318    i.xQueueGenericSendFromISR  queue.o
+    0x0800b600   0x0800b600   0x000000a0   Code   RO         3570    i.xTaskCheckForTimeOut  tasks.o
+    0x0800b6a0   0x0800b6a0   0x00000060   Code   RO         3571    i.xTaskCreate       tasks.o
+    0x0800b700   0x0800b700   0x00000020   Code   RO         3575    i.xTaskGetSchedulerState  tasks.o
+    0x0800b720   0x0800b720   0x0000000c   Code   RO         3576    i.xTaskGetTickCount  tasks.o
+    0x0800b72c   0x0800b72c   0x00000160   Code   RO         3578    i.xTaskIncrementTick  tasks.o
+    0x0800b88c   0x0800b88c   0x000000d8   Code   RO         3581    i.xTaskPriorityDisinherit  tasks.o
+    0x0800b964   0x0800b964   0x000000b4   Code   RO         3582    i.xTaskRemoveFromEventList  tasks.o
+    0x0800ba18   0x0800ba18   0x00000120   Code   RO         3584    i.xTaskResumeAll    tasks.o
+    0x0800bb38   0x0800bb38   0x00000074   Code   RO         3911    i.xTimerCreateTimerTask  timers.o
+    0x0800bbac   0x0800bbac   0x000000a4   Code   RO         3912    i.xTimerGenericCommand  timers.o
+    0x0800bc50   0x0800bc50   0x00000018   Code   RO         4686    x$fpl$basic         fz_wm.l(basic.o)
+    0x0800bc68   0x0800bc68   0x00000062   Code   RO         4688    x$fpl$d2f           fz_wm.l(d2f.o)
+    0x0800bcca   0x0800bcca   0x00000002   PAD
+    0x0800bccc   0x0800bccc   0x00000150   Code   RO         4690    x$fpl$dadd          fz_wm.l(daddsub_clz.o)
+    0x0800be1c   0x0800be1c   0x00000010   Code   RO         4865    x$fpl$dcheck1       fz_wm.l(dcheck1.o)
+    0x0800be2c   0x0800be2c   0x00000018   Code   RO         4867    x$fpl$dcmpinf       fz_wm.l(dcmpi.o)
+    0x0800be44   0x0800be44   0x000002b0   Code   RO         4697    x$fpl$ddiv          fz_wm.l(ddiv.o)
+    0x0800c0f4   0x0800c0f4   0x0000005e   Code   RO         4700    x$fpl$dfix          fz_wm.l(dfix.o)
+    0x0800c152   0x0800c152   0x0000002e   Code   RO         4705    x$fpl$dflt          fz_wm.l(dflt_clz.o)
+    0x0800c180   0x0800c180   0x00000026   Code   RO         4704    x$fpl$dfltu         fz_wm.l(dflt_clz.o)
+    0x0800c1a6   0x0800c1a6   0x00000002   PAD
+    0x0800c1a8   0x0800c1a8   0x00000078   Code   RO         4786    x$fpl$dleqf         fz_wm.l(dleqf.o)
+    0x0800c220   0x0800c220   0x00000154   Code   RO         4710    x$fpl$dmul          fz_wm.l(dmul.o)
+    0x0800c374   0x0800c374   0x0000009c   Code   RO         4788    x$fpl$dnaninf       fz_wm.l(dnaninf.o)
+    0x0800c410   0x0800c410   0x0000000c   Code   RO         4790    x$fpl$dretinf       fz_wm.l(dretinf.o)
+    0x0800c41c   0x0800c41c   0x0000006c   Code   RO         4792    x$fpl$drleqf        fz_wm.l(drleqf.o)
+    0x0800c488   0x0800c488   0x00000016   Code   RO         4691    x$fpl$drsb          fz_wm.l(daddsub_clz.o)
+    0x0800c49e   0x0800c49e   0x00000002   PAD
+    0x0800c4a0   0x0800c4a0   0x00000198   Code   RO         4794    x$fpl$dsqrt         fz_wm.l(dsqrt_umaal.o)
+    0x0800c638   0x0800c638   0x000001d4   Code   RO         4692    x$fpl$dsub          fz_wm.l(daddsub_clz.o)
+    0x0800c80c   0x0800c80c   0x00000056   Code   RO         4712    x$fpl$f2d           fz_wm.l(f2d.o)
+    0x0800c862   0x0800c862   0x0000008c   Code   RO         4796    x$fpl$fnaninf       fz_wm.l(fnaninf.o)
+    0x0800c8ee   0x0800c8ee   0x0000000a   Code   RO         4942    x$fpl$fpinit        fz_wm.l(fpinit.o)
+    0x0800c8f8   0x0800c8f8   0x0000000a   Code   RO         4798    x$fpl$fretinf       fz_wm.l(fretinf.o)
+    0x0800c902   0x0800c902   0x00000064   Code   RO         4882    x$fpl$retnan        fz_wm.l(retnan.o)
+    0x0800c966   0x0800c966   0x0000005c   Code   RO         4800    x$fpl$scalbn        fz_wm.l(scalbn.o)
+    0x0800c9c2   0x0800c9c2   0x00000030   Code   RO         4931    x$fpl$trapveneer    fz_wm.l(trapv.o)
+    0x0800c9f2   0x0800c9f2   0x00000000   Code   RO         4802    x$fpl$usenofp       fz_wm.l(usenofp.o)
+    0x0800c9f2   0x0800c9f2   0x000014a4   Data   RO          740    .constdata          oled.o
+    0x0800de96   0x0800de96   0x00000002   PAD
+    0x0800de98   0x0800de98   0x00000098   Data   RO         4717    .constdata          m_wm.l(atan.o)
+    0x0800df30   0x0800df30   0x00000088   Data   RO         4731    .constdata          m_wm.l(pow.o)
+    0x0800dfb8   0x0800dfb8   0x00000008   Data   RO         4827    .constdata          m_wm.l(qnan.o)
+    0x0800dfc0   0x0800dfc0   0x000000c8   Data   RO         4830    .constdata          m_wm.l(rred.o)
+    0x0800e088   0x0800e088   0x00000060   Data   RO         4834    .constdata          m_wm.l(tan_i.o)
+    0x0800e0e8   0x0800e0e8   0x00000020   Data   RO         5006    Region$$Table       anon$$obj.o
+
+
+    Execution Region RW_IRAM1 (Exec base: 0x20000000, Load base: 0x0800e108, Size: 0x00006150, Max: 0x00020000, ABSOLUTE, COMPRESSED[0x00000064])
+
+    Exec Addr    Load Addr    Size         Type   Attr      Idx    E Section Name        Object
+
+    0x20000000   COMPRESSED   0x00000004   Data   RW            5    .data               main.o
+    0x20000004   COMPRESSED   0x00000014   Data   RW          348    .data               system_stm32f4xx.o
+    0x20000018   COMPRESSED   0x0000000c   Data   RW          389    .data               adc.o
+    0x20000024   COMPRESSED   0x00000014   Data   RW          593    .data               key.o
+    0x20000038   COMPRESSED   0x00000008   Data   RW          642    .data               led.o
+    0x20000040   COMPRESSED   0x00000028   Data   RW          843    .data               pstwo.o
+    0x20000068   COMPRESSED   0x00000048   Data   RW          953    .data               timer.o
+    0x200000b0   COMPRESSED   0x00000016   Data   RW         1020    .data               usartx.o
+    0x200000c6   COMPRESSED   0x00000002   PAD
+    0x200000c8   COMPRESSED   0x00000008   Data   RW         1165    .data               delay.o
+    0x200000d0   COMPRESSED   0x00000006   Data   RW         1237    .data               usart.o
+    0x200000d6   COMPRESSED   0x00000010   Data   RW         1481    .data               stm32f4xx_rcc.o
+    0x200000e6   COMPRESSED   0x00000002   PAD
+    0x200000e8   COMPRESSED   0x0000003c   Data   RW         3587    .data               tasks.o
+    0x20000124   COMPRESSED   0x00000014   Data   RW         3920    .data               timers.o
+    0x20000138   COMPRESSED   0x0000000c   Data   RW         4046    .data               port.o
+    0x20000144   COMPRESSED   0x00000018   Data   RW         4129    .data               heap_4.o
+    0x2000015c   COMPRESSED   0x00000078   Data   RW         4180    .data               system.o
+    0x200001d4   COMPRESSED   0x0000003e   Data   RW         4226    .data               balance.o
+    0x20000212   COMPRESSED   0x00000002   PAD
+    0x20000214   COMPRESSED   0x00000019   Data   RW         4378    .data               show.o
+    0x2000022d   COMPRESSED   0x00000003   PAD
+    0x20000230   COMPRESSED   0x0000004e   Data   RW         4428    .data               mpu6050.o
+    0x2000027e   COMPRESSED   0x00000002   PAD
+    0x20000280        -       0x00000400   Zero   RW          739    .bss                oled.o
+    0x20000680        -       0x00000009   Zero   RW          842    .bss                pstwo.o
+    0x20000689   COMPRESSED   0x00000003   PAD
+    0x2000068c        -       0x0000008d   Zero   RW         1019    .bss                usartx.o
+    0x20000719   COMPRESSED   0x00000003   PAD
+    0x2000071c        -       0x00000040   Zero   RW         3329    .bss                queue.o
+    0x2000075c        -       0x000002e4   Zero   RW         3586    .bss                tasks.o
+    0x20000a40        -       0x00000028   Zero   RW         3919    .bss                timers.o
+    0x20000a68        -       0x00005000   Zero   RW         4128    .bss                heap_4.o
+    0x20005a68        -       0x0000005c   Zero   RW         4179    .bss                system.o
+    0x20005ac4        -       0x00000010   Zero   RW         4225    .bss                balance.o
+    0x20005ad4        -       0x00000018   Zero   RW         4348    .bss                robot_select_init.o
+    0x20005aec        -       0x00000060   Zero   RW         4870    .bss                c_w.l(libspace.o)
+    0x20005b4c   COMPRESSED   0x00000004   PAD
+    0x20005b50        -       0x00000200   Zero   RW         1278    HEAP                startup_stm32f40_41xxx.o
+    0x20005d50        -       0x00000400   Zero   RW         1277    STACK               startup_stm32f40_41xxx.o
+
+
+==============================================================================
+
+Image component sizes
+
+
+      Code (inc. data)   RO Data    RW Data    ZI Data      Debug   Object Name
+
+       566         64          0         12          0       4545   adc.o
+      7214        650          0         62         16      15523   balance.o
+      1480         82          0          0          0       5627   can.o
+       248         24          0          8          0       3497   delay.o
+      1016         70          0          0          0       6607   encoder.o
+         0          0          0          0          0       9568   event_groups.o
+       752        176          0         24      20480       4371   heap_4.o
+       914        100          0          0          0       7557   i2c.o
+       256         30          0         20          0       3286   key.o
+       156         22          0          8          0       2528   led.o
+       148          0          0          0          0       3622   list.o
+       312        132          0          4          0     323584   main.o
+       180         24          0          0          0       2337   misc.o
+       808         46          0          0          0       4015   motor.o
+       932         74          0         78          0       7289   mpu6050.o
+      1030         44       5284          0       1024       8072   oled.o
+      1182        396          0         12          0      11665   port.o
+      1184        148          0         40          9       8890   pstwo.o
+      2164        238          0          0         64      14445   queue.o
+       636        140          0          0         24       2117   robot_select_init.o
+      3796        456          0         25          0       3736   show.o
+        64         26        392          0       1536        900   startup_stm32f40_41xxx.o
+       374         24          0          0          0       6078   stm32f4xx_adc.o
+        18          0          0          0          0       1591   stm32f4xx_can.o
+       218          0          0          0          0       2582   stm32f4xx_gpio.o
+        20          0          0          0          0       3121   stm32f4xx_it.o
+        12          6          0          0          0        598   stm32f4xx_pwr.o
+       404         46          0         16          0       6280   stm32f4xx_rcc.o
+      1644         66          0          0          0      26325   stm32f4xx_tim.o
+       404          8          0          0          0       4646   stm32f4xx_usart.o
+       190          0          0        120         92       4006   system.o
+       340         32          0         20          0       2009   system_stm32f4xx.o
+      3626        928          0         60        740      32665   tasks.o
+      1500        152          0         72          0       4825   timer.o
+      1310        312          0         20         40       9707   timers.o
+        32          4          0          6          0       3176   usart.o
+      4536        518          0         22        141      16142   usartx.o
+
+    ----------------------------------------------------------------------
+     39704       5038       5710        640      24172     577532   Object Totals
+         0          0         32          0          0          0   (incl. Generated)
+        38          0          2         11          6          0   (incl. Padding)
+
+    ----------------------------------------------------------------------
+
+      Code (inc. data)   RO Data    RW Data    ZI Data      Debug   Library Member Name
+
+        90          0          0          0          0          0   __dczerorl2.o
+         8          0          0          0          0         68   __main.o
+       104          0          0          0          0         84   __printf.o
+         0          0          0          0          0          0   __rtentry.o
+        12          0          0          0          0          0   __rtentry2.o
+         6          0          0          0          0          0   __rtentry4.o
+        52          8          0          0          0          0   __scatter.o
+        28          0          0          0          0          0   __scatter_zi.o
+        44          0          0          0          0        108   _printf_char.o
+        48          6          0          0          0         96   _printf_char_common.o
+        36          4          0          0          0         80   _printf_char_file.o
+         6          0          0          0          0          0   _printf_d.o
+       120         16          0          0          0         92   _printf_dec.o
+       178          0          0          0          0         88   _printf_intcommon.o
+         0          0          0          0          0          0   _printf_percent.o
+         4          0          0          0          0          0   _printf_percent_end.o
+         6          0          0          0          0          0   _printf_s.o
+        82          0          0          0          0         80   _printf_str.o
+        22          0          0          0          0        100   _rserrno.o
+        16          0          0          0          0         68   aeabi_memset.o
+        18          0          0          0          0         80   exit.o
+         8          0          0          0          0         68   ferror.o
+         6          0          0          0          0        152   heapauxi.o
+         2          0          0          0          0          0   libinit.o
+         6          0          0          0          0          0   libinit2.o
+         2          0          0          0          0          0   libshutdown.o
+         2          0          0          0          0          0   libshutdown2.o
+         8          4          0          0         96         68   libspace.o
+        24          4          0          0          0         84   noretval__2printf.o
+         8          4          0          0          0         68   rt_errno_addr_intlibspace.o
+        68          0          0          0          0         68   rt_memclr.o
+        78          0          0          0          0         80   rt_memclr_w.o
+       138          0          0          0          0         68   rt_memcpy_v6.o
+       100          0          0          0          0         80   rt_memcpy_w.o
+         2          0          0          0          0          0   rtexit.o
+        10          0          0          0          0          0   rtexit2.o
+        74          0          0          0          0         80   sys_stackheap_outer.o
+         2          0          0          0          0         68   use_no_semi.o
+         2          0          0          0          0         68   use_no_semi_2.o
+        24          0          0          0          0        164   basic.o
+        98          4          0          0          0        140   d2f.o
+       826         16          0          0          0        492   daddsub_clz.o
+        16          4          0          0          0        116   dcheck1.o
+        24          0          0          0          0        116   dcmpi.o
+       688        140          0          0          0        256   ddiv.o
+        94          4          0          0          0        140   dfix.o
+        84          0          0          0          0        232   dflt_clz.o
+       120          4          0          0          0        140   dleqf.o
+       340         12          0          0          0        152   dmul.o
+       156          4          0          0          0        140   dnaninf.o
+        12          0          0          0          0        116   dretinf.o
+       108          0          0          0          0        128   drleqf.o
+       408         56          0          0          0        168   dsqrt_umaal.o
+        86          4          0          0          0        132   f2d.o
+       140          4          0          0          0        132   fnaninf.o
+        10          0          0          0          0        116   fpinit.o
+        10          0          0          0          0        116   fretinf.o
+       100          0          0          0          0        116   retnan.o
+        92          0          0          0          0        116   scalbn.o
+        48          0          0          0          0        116   trapv.o
+         0          0          0          0          0          0   usenofp.o
+       728        106        152          0          0        228   atan.o
+       184         44          0          0          0        744   dunder.o
+        24          0          0          0          0        124   fabs.o
+        48          0          0          0          0        124   fpclassify.o
+       248          0          0          0          0        152   poly.o
+      3152        296        136          0          0        352   pow.o
+         0          0          8          0          0          0   qnan.o
+      1080        142        200          0          0        188   rred.o
+       232          0          0          0          0        296   sqrt.o
+       128         20          0          0          0        144   tan.o
+       848         84         96          0          0        196   tan_i.o
+
+    ----------------------------------------------------------------------
+     11602        990        592          0        100       7788   Library Totals
+        26          0          0          0          4          0   (incl. Padding)
+
+    ----------------------------------------------------------------------
+
+      Code (inc. data)   RO Data    RW Data    ZI Data      Debug   Library Name
+
+      1420         46          0          0         96       1896   c_w.l
+      3484        252          0          0          0       3344   fz_wm.l
+      6672        692        592          0          0       2548   m_wm.l
+
+    ----------------------------------------------------------------------
+     11602        990        592          0        100       7788   Library Totals
+
+    ----------------------------------------------------------------------
+
+==============================================================================
+
+
+      Code (inc. data)   RO Data    RW Data    ZI Data      Debug   
+
+     51306       6028       6302        640      24272     554332   Grand Totals
+     51306       6028       6302        100      24272     554332   ELF Image Totals (compressed)
+     51306       6028       6302        100          0          0   ROM Totals
+
+==============================================================================
+
+    Total RO  Size (Code + RO Data)                57608 (  56.26kB)
+    Total RW  Size (RW Data + ZI Data)             24912 (  24.33kB)
+    Total ROM Size (Code + RO Data + RW Data)      57708 (  56.36kB)
+
+==============================================================================
+
diff --git a/OBJ/OriginCar.sct b/OBJ/OriginCar.sct
new file mode 100644
index 0000000..3bb4046
--- /dev/null
+++ b/OBJ/OriginCar.sct
@@ -0,0 +1,16 @@
+; *************************************************************
+; *** Scatter-Loading Description File generated by uVision ***
+; *************************************************************
+
+LR_IROM1 0x08000000 0x00100000  {    ; load region size_region
+  ER_IROM1 0x08000000 0x00100000  {  ; load address = execution address
+   *.o (RESET, +First)
+   *(InRoot$$Sections)
+   .ANY (+RO)
+   .ANY (+XO)
+  }
+  RW_IRAM1 0x20000000 0x00020000  {  ; RW data
+   .ANY (+RW +ZI)
+  }
+}
+
diff --git a/OBJ/OriginCar_FreeRTOS.dep b/OBJ/OriginCar_FreeRTOS.dep
new file mode 100644
index 0000000..c783137
--- /dev/null
+++ b/OBJ/OriginCar_FreeRTOS.dep
@@ -0,0 +1,2244 @@
+Dependencies for Project 'OriginCar', Target 'FreeRTOS': (DO NOT MODIFY !)
+CompilerVersion: 5060750::V5.06 update 6 (build 750)::.\ARMCC
+F (.\main.c)(0x67C8460C)(-c --cpu Cortex-M4.fp.sp -g -O0 --apcs=interwork --split_sections -I ..\CORE -I ..\SYSTEM\delay -I ..\SYSTEM\sys -I ..\SYSTEM\usart -I ..\USER -I ..\HARDWARE\LED -I ..\FWLIB\inc -I ..\FreeRTOS\include -I ..\FreeRTOS\portable\RVDS\ARM_CM4F -I ..\BALANCE -I ..\HARDWARE -I ..\HARDWARE\MPU6050

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Drivers\CMSIS\Device\ST\STM32F4xx\Include

-ID:\Keil_v5\ARM\CMSIS\Include

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Device\Include

-D__UVISION_VERSION="531" -DSTM32F407xx -DSTM32F40_41xxx -DUSE_STDPERIPH_DRIVER -D__FPU_PRESENT="1" -D__TARGET_FPU_VFP -DARM_MATH_CM4 -D__CC_ARM --C99

-o ..\obj\main.o --omf_browse ..\obj\main.crf --depend ..\obj\main.d)
+I (..\BALANCE\system.h)(0x67C844F4)
+I (..\FreeRTOS\include\FreeRTOSConfig.h)(0x67C84613)
+I (..\SYSTEM\sys\sys.h)(0x67C8463C)
+I (..\USER\stm32f4xx.h)(0x67C84611)
+I (..\CORE\core_cm4.h)(0x67C84524)
+I (D:\Keil_v5\ARM\ARMCC\include\stdint.h)(0x5EC775FC)
+I (..\CORE\core_cmInstr.h)(0x67C84526)
+I (..\CORE\core_cmFunc.h)(0x67C84526)
+I (..\CORE\core_cm4_simd.h)(0x67C84526)
+I (..\USER\system_stm32f4xx.h)(0x67C84610)
+I (..\CORE\arm_math.h)(0x67C84525)
+I (D:\Keil_v5\ARM\ARMCC\include\string.h)(0x5EC77604)
+I (D:\Keil_v5\ARM\ARMCC\include\math.h)(0x5EC77604)
+I (..\USER\stm32f4xx_conf.h)(0x67C8460F)
+I (..\FWLIB\inc\stm32f4xx_adc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_crc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dbgmcu.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dma.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_exti.h)(0x67C8461C)
+I (..\FWLIB\inc\stm32f4xx_flash.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_gpio.h)(0x67C8461E)
+I (..\FWLIB\inc\stm32f4xx_i2c.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_iwdg.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_pwr.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_rcc.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_rtc.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_sdio.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_spi.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_syscfg.h)(0x67C84625)
+I (..\FWLIB\inc\stm32f4xx_tim.h)(0x67C84627)
+I (..\FWLIB\inc\stm32f4xx_usart.h)(0x67C84626)
+I (..\FWLIB\inc\stm32f4xx_wwdg.h)(0x67C84626)
+I (..\FWLIB\inc\misc.h)(0x67C84618)
+I (..\FWLIB\inc\stm32f4xx_cryp.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_hash.h)(0x67C8461F)
+I (..\FWLIB\inc\stm32f4xx_rng.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_can.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dac.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dcmi.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_fsmc.h)(0x67C8461F)
+I (..\SYSTEM\usart\usart.h)(0x67C8463C)
+I (D:\Keil_v5\ARM\ARMCC\include\stdio.h)(0x5EC775FC)
+I (..\FreeRTOS\include\FreeRTOS.h)(0x67C84614)
+I (D:\Keil_v5\ARM\ARMCC\include\stddef.h)(0x5EC775FC)
+I (..\FreeRTOS\include\projdefs.h)(0x67C84615)
+I (..\FreeRTOS\include\portable.h)(0x67C84615)
+I (..\FreeRTOS\include\deprecated_definitions.h)(0x67C84612)
+I (..\FreeRTOS\portable\RVDS\ARM_CM4F\portmacro.h)(0x67C84645)
+I (..\FreeRTOS\include\mpu_wrappers.h)(0x67C84614)
+I (..\FreeRTOS\include\task.h)(0x67C84619)
+I (..\FreeRTOS\include\list.h)(0x67C84613)
+I (..\FreeRTOS\include\queue.h)(0x67C84617)
+I (..\FreeRTOS\include\timers.h)(0x67C84618)
+I (..\FreeRTOS\include\semphr.h)(0x67C84617)
+I (..\SYSTEM\delay\delay.h)(0x67C8463B)
+I (..\BALANCE\balance.h)(0x67C844E9)
+I (..\HARDWARE\led.h)(0x67C8454B)
+I (..\HARDWARE\oled.h)(0x67C8454E)
+I (..\HARDWARE\usartx.h)(0x67C84556)
+I (..\HARDWARE\adc.h)(0x67C8453E)
+I (..\HARDWARE\can.h)(0x67C84540)
+I (..\HARDWARE\motor.h)(0x69491826)
+I (..\HARDWARE\timer.h)(0x67C84554)
+I (..\HARDWARE\encoder.h)(0x67C84544)
+I (..\BALANCE\show.h)(0x67C844F2)
+I (..\HARDWARE\pstwo.h)(0x67C84551)
+I (..\HARDWARE\key.h)(0x67C84549)
+I (..\BALANCE\robot_select_init.h)(0x6842B20E)
+I (..\HARDWARE\MPU6050\I2C.h)(0x67C84639)
+I (D:\Keil_v5\ARM\ARMCC\include\stdbool.h)(0x5EC775F6)
+I (..\HARDWARE\MPU6050\MPU6050.h)(0x67C8463A)
+I (D:\Keil_v5\ARM\ARMCC\include\stdlib.h)(0x5EC775FC)
+I (D:\Keil_v5\ARM\ARMCC\include\stdarg.h)(0x5EC775FC)
+F (.\stm32f4xx_it.c)(0x67C8460F)(-c --cpu Cortex-M4.fp.sp -g -O0 --apcs=interwork --split_sections -I ..\CORE -I ..\SYSTEM\delay -I ..\SYSTEM\sys -I ..\SYSTEM\usart -I ..\USER -I ..\HARDWARE\LED -I ..\FWLIB\inc -I ..\FreeRTOS\include -I ..\FreeRTOS\portable\RVDS\ARM_CM4F -I ..\BALANCE -I ..\HARDWARE -I ..\HARDWARE\MPU6050

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Drivers\CMSIS\Device\ST\STM32F4xx\Include

-ID:\Keil_v5\ARM\CMSIS\Include

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Device\Include

-D__UVISION_VERSION="531" -DSTM32F407xx -DSTM32F40_41xxx -DUSE_STDPERIPH_DRIVER -D__FPU_PRESENT="1" -D__TARGET_FPU_VFP -DARM_MATH_CM4 -D__CC_ARM --C99

-o ..\obj\stm32f4xx_it.o --omf_browse ..\obj\stm32f4xx_it.crf --depend ..\obj\stm32f4xx_it.d)
+I (stm32f4xx_it.h)(0x67C8460F)
+I (stm32f4xx.h)(0x67C84611)
+I (..\CORE\core_cm4.h)(0x67C84524)
+I (D:\Keil_v5\ARM\ARMCC\include\stdint.h)(0x5EC775FC)
+I (..\CORE\core_cmInstr.h)(0x67C84526)
+I (..\CORE\core_cmFunc.h)(0x67C84526)
+I (..\CORE\core_cm4_simd.h)(0x67C84526)
+I (system_stm32f4xx.h)(0x67C84610)
+I (..\CORE\arm_math.h)(0x67C84525)
+I (D:\Keil_v5\ARM\ARMCC\include\string.h)(0x5EC77604)
+I (D:\Keil_v5\ARM\ARMCC\include\math.h)(0x5EC77604)
+I (stm32f4xx_conf.h)(0x67C8460F)
+I (..\FWLIB\inc\stm32f4xx_adc.h)(0x67C8461A)
+I (..\USER\stm32f4xx.h)(0x67C84611)
+I (..\FWLIB\inc\stm32f4xx_crc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dbgmcu.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dma.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_exti.h)(0x67C8461C)
+I (..\FWLIB\inc\stm32f4xx_flash.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_gpio.h)(0x67C8461E)
+I (..\FWLIB\inc\stm32f4xx_i2c.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_iwdg.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_pwr.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_rcc.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_rtc.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_sdio.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_spi.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_syscfg.h)(0x67C84625)
+I (..\FWLIB\inc\stm32f4xx_tim.h)(0x67C84627)
+I (..\FWLIB\inc\stm32f4xx_usart.h)(0x67C84626)
+I (..\FWLIB\inc\stm32f4xx_wwdg.h)(0x67C84626)
+I (..\FWLIB\inc\misc.h)(0x67C84618)
+I (..\FWLIB\inc\stm32f4xx_cryp.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_hash.h)(0x67C8461F)
+I (..\FWLIB\inc\stm32f4xx_rng.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_can.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dac.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dcmi.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_fsmc.h)(0x67C8461F)
+F (.\system_stm32f4xx.c)(0x67C84611)(-c --cpu Cortex-M4.fp.sp -g -O0 --apcs=interwork --split_sections -I ..\CORE -I ..\SYSTEM\delay -I ..\SYSTEM\sys -I ..\SYSTEM\usart -I ..\USER -I ..\HARDWARE\LED -I ..\FWLIB\inc -I ..\FreeRTOS\include -I ..\FreeRTOS\portable\RVDS\ARM_CM4F -I ..\BALANCE -I ..\HARDWARE -I ..\HARDWARE\MPU6050

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Drivers\CMSIS\Device\ST\STM32F4xx\Include

-ID:\Keil_v5\ARM\CMSIS\Include

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Device\Include

-D__UVISION_VERSION="531" -DSTM32F407xx -DSTM32F40_41xxx -DUSE_STDPERIPH_DRIVER -D__FPU_PRESENT="1" -D__TARGET_FPU_VFP -DARM_MATH_CM4 -D__CC_ARM --C99

-o ..\obj\system_stm32f4xx.o --omf_browse ..\obj\system_stm32f4xx.crf --depend ..\obj\system_stm32f4xx.d)
+I (stm32f4xx.h)(0x67C84611)
+I (..\CORE\core_cm4.h)(0x67C84524)
+I (D:\Keil_v5\ARM\ARMCC\include\stdint.h)(0x5EC775FC)
+I (..\CORE\core_cmInstr.h)(0x67C84526)
+I (..\CORE\core_cmFunc.h)(0x67C84526)
+I (..\CORE\core_cm4_simd.h)(0x67C84526)
+I (system_stm32f4xx.h)(0x67C84610)
+I (..\CORE\arm_math.h)(0x67C84525)
+I (D:\Keil_v5\ARM\ARMCC\include\string.h)(0x5EC77604)
+I (D:\Keil_v5\ARM\ARMCC\include\math.h)(0x5EC77604)
+I (stm32f4xx_conf.h)(0x67C8460F)
+I (..\FWLIB\inc\stm32f4xx_adc.h)(0x67C8461A)
+I (..\USER\stm32f4xx.h)(0x67C84611)
+I (..\FWLIB\inc\stm32f4xx_crc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dbgmcu.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dma.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_exti.h)(0x67C8461C)
+I (..\FWLIB\inc\stm32f4xx_flash.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_gpio.h)(0x67C8461E)
+I (..\FWLIB\inc\stm32f4xx_i2c.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_iwdg.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_pwr.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_rcc.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_rtc.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_sdio.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_spi.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_syscfg.h)(0x67C84625)
+I (..\FWLIB\inc\stm32f4xx_tim.h)(0x67C84627)
+I (..\FWLIB\inc\stm32f4xx_usart.h)(0x67C84626)
+I (..\FWLIB\inc\stm32f4xx_wwdg.h)(0x67C84626)
+I (..\FWLIB\inc\misc.h)(0x67C84618)
+I (..\FWLIB\inc\stm32f4xx_cryp.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_hash.h)(0x67C8461F)
+I (..\FWLIB\inc\stm32f4xx_rng.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_can.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dac.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dcmi.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_fsmc.h)(0x67C8461F)
+F (..\HARDWARE\adc.c)(0x67C8453B)(-c --cpu Cortex-M4.fp.sp -g -O0 --apcs=interwork --split_sections -I ..\CORE -I ..\SYSTEM\delay -I ..\SYSTEM\sys -I ..\SYSTEM\usart -I ..\USER -I ..\HARDWARE\LED -I ..\FWLIB\inc -I ..\FreeRTOS\include -I ..\FreeRTOS\portable\RVDS\ARM_CM4F -I ..\BALANCE -I ..\HARDWARE -I ..\HARDWARE\MPU6050

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Drivers\CMSIS\Device\ST\STM32F4xx\Include

-ID:\Keil_v5\ARM\CMSIS\Include

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Device\Include

-D__UVISION_VERSION="531" -DSTM32F407xx -DSTM32F40_41xxx -DUSE_STDPERIPH_DRIVER -D__FPU_PRESENT="1" -D__TARGET_FPU_VFP -DARM_MATH_CM4 -D__CC_ARM --C99

-o ..\obj\adc.o --omf_browse ..\obj\adc.crf --depend ..\obj\adc.d)
+I (..\HARDWARE\adc.h)(0x67C8453E)
+I (..\SYSTEM\sys\sys.h)(0x67C8463C)
+I (..\USER\stm32f4xx.h)(0x67C84611)
+I (..\CORE\core_cm4.h)(0x67C84524)
+I (D:\Keil_v5\ARM\ARMCC\include\stdint.h)(0x5EC775FC)
+I (..\CORE\core_cmInstr.h)(0x67C84526)
+I (..\CORE\core_cmFunc.h)(0x67C84526)
+I (..\CORE\core_cm4_simd.h)(0x67C84526)
+I (..\USER\system_stm32f4xx.h)(0x67C84610)
+I (..\CORE\arm_math.h)(0x67C84525)
+I (D:\Keil_v5\ARM\ARMCC\include\string.h)(0x5EC77604)
+I (D:\Keil_v5\ARM\ARMCC\include\math.h)(0x5EC77604)
+I (..\USER\stm32f4xx_conf.h)(0x67C8460F)
+I (..\FWLIB\inc\stm32f4xx_adc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_crc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dbgmcu.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dma.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_exti.h)(0x67C8461C)
+I (..\FWLIB\inc\stm32f4xx_flash.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_gpio.h)(0x67C8461E)
+I (..\FWLIB\inc\stm32f4xx_i2c.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_iwdg.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_pwr.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_rcc.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_rtc.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_sdio.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_spi.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_syscfg.h)(0x67C84625)
+I (..\FWLIB\inc\stm32f4xx_tim.h)(0x67C84627)
+I (..\FWLIB\inc\stm32f4xx_usart.h)(0x67C84626)
+I (..\FWLIB\inc\stm32f4xx_wwdg.h)(0x67C84626)
+I (..\FWLIB\inc\misc.h)(0x67C84618)
+I (..\FWLIB\inc\stm32f4xx_cryp.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_hash.h)(0x67C8461F)
+I (..\FWLIB\inc\stm32f4xx_rng.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_can.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dac.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dcmi.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_fsmc.h)(0x67C8461F)
+I (..\BALANCE\system.h)(0x67C844F4)
+I (..\FreeRTOS\include\FreeRTOSConfig.h)(0x67C84613)
+I (..\SYSTEM\usart\usart.h)(0x67C8463C)
+I (D:\Keil_v5\ARM\ARMCC\include\stdio.h)(0x5EC775FC)
+I (..\FreeRTOS\include\FreeRTOS.h)(0x67C84614)
+I (D:\Keil_v5\ARM\ARMCC\include\stddef.h)(0x5EC775FC)
+I (..\FreeRTOS\include\projdefs.h)(0x67C84615)
+I (..\FreeRTOS\include\portable.h)(0x67C84615)
+I (..\FreeRTOS\include\deprecated_definitions.h)(0x67C84612)
+I (..\FreeRTOS\portable\RVDS\ARM_CM4F\portmacro.h)(0x67C84645)
+I (..\FreeRTOS\include\mpu_wrappers.h)(0x67C84614)
+I (..\FreeRTOS\include\task.h)(0x67C84619)
+I (..\FreeRTOS\include\list.h)(0x67C84613)
+I (..\FreeRTOS\include\queue.h)(0x67C84617)
+I (..\FreeRTOS\include\timers.h)(0x67C84618)
+I (..\FreeRTOS\include\semphr.h)(0x67C84617)
+I (..\SYSTEM\delay\delay.h)(0x67C8463B)
+I (..\BALANCE\balance.h)(0x67C844E9)
+I (..\HARDWARE\led.h)(0x67C8454B)
+I (..\HARDWARE\oled.h)(0x67C8454E)
+I (..\HARDWARE\usartx.h)(0x67C84556)
+I (..\HARDWARE\can.h)(0x67C84540)
+I (..\HARDWARE\motor.h)(0x69491826)
+I (..\HARDWARE\timer.h)(0x67C84554)
+I (..\HARDWARE\encoder.h)(0x67C84544)
+I (..\BALANCE\show.h)(0x67C844F2)
+I (..\HARDWARE\pstwo.h)(0x67C84551)
+I (..\HARDWARE\key.h)(0x67C84549)
+I (..\BALANCE\robot_select_init.h)(0x6842B20E)
+I (..\HARDWARE\MPU6050\I2C.h)(0x67C84639)
+I (D:\Keil_v5\ARM\ARMCC\include\stdbool.h)(0x5EC775F6)
+I (..\HARDWARE\MPU6050\MPU6050.h)(0x67C8463A)
+I (D:\Keil_v5\ARM\ARMCC\include\stdlib.h)(0x5EC775FC)
+I (D:\Keil_v5\ARM\ARMCC\include\stdarg.h)(0x5EC775FC)
+F (..\HARDWARE\can.c)(0x67C8453F)(-c --cpu Cortex-M4.fp.sp -g -O0 --apcs=interwork --split_sections -I ..\CORE -I ..\SYSTEM\delay -I ..\SYSTEM\sys -I ..\SYSTEM\usart -I ..\USER -I ..\HARDWARE\LED -I ..\FWLIB\inc -I ..\FreeRTOS\include -I ..\FreeRTOS\portable\RVDS\ARM_CM4F -I ..\BALANCE -I ..\HARDWARE -I ..\HARDWARE\MPU6050

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Drivers\CMSIS\Device\ST\STM32F4xx\Include

-ID:\Keil_v5\ARM\CMSIS\Include

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Device\Include

-D__UVISION_VERSION="531" -DSTM32F407xx -DSTM32F40_41xxx -DUSE_STDPERIPH_DRIVER -D__FPU_PRESENT="1" -D__TARGET_FPU_VFP -DARM_MATH_CM4 -D__CC_ARM --C99

-o ..\obj\can.o --omf_browse ..\obj\can.crf --depend ..\obj\can.d)
+I (..\HARDWARE\can.h)(0x67C84540)
+I (..\SYSTEM\sys\sys.h)(0x67C8463C)
+I (..\USER\stm32f4xx.h)(0x67C84611)
+I (..\CORE\core_cm4.h)(0x67C84524)
+I (D:\Keil_v5\ARM\ARMCC\include\stdint.h)(0x5EC775FC)
+I (..\CORE\core_cmInstr.h)(0x67C84526)
+I (..\CORE\core_cmFunc.h)(0x67C84526)
+I (..\CORE\core_cm4_simd.h)(0x67C84526)
+I (..\USER\system_stm32f4xx.h)(0x67C84610)
+I (..\CORE\arm_math.h)(0x67C84525)
+I (D:\Keil_v5\ARM\ARMCC\include\string.h)(0x5EC77604)
+I (D:\Keil_v5\ARM\ARMCC\include\math.h)(0x5EC77604)
+I (..\USER\stm32f4xx_conf.h)(0x67C8460F)
+I (..\FWLIB\inc\stm32f4xx_adc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_crc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dbgmcu.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dma.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_exti.h)(0x67C8461C)
+I (..\FWLIB\inc\stm32f4xx_flash.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_gpio.h)(0x67C8461E)
+I (..\FWLIB\inc\stm32f4xx_i2c.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_iwdg.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_pwr.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_rcc.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_rtc.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_sdio.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_spi.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_syscfg.h)(0x67C84625)
+I (..\FWLIB\inc\stm32f4xx_tim.h)(0x67C84627)
+I (..\FWLIB\inc\stm32f4xx_usart.h)(0x67C84626)
+I (..\FWLIB\inc\stm32f4xx_wwdg.h)(0x67C84626)
+I (..\FWLIB\inc\misc.h)(0x67C84618)
+I (..\FWLIB\inc\stm32f4xx_cryp.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_hash.h)(0x67C8461F)
+I (..\FWLIB\inc\stm32f4xx_rng.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_can.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dac.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dcmi.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_fsmc.h)(0x67C8461F)
+I (..\BALANCE\system.h)(0x67C844F4)
+I (..\FreeRTOS\include\FreeRTOSConfig.h)(0x67C84613)
+I (..\SYSTEM\usart\usart.h)(0x67C8463C)
+I (D:\Keil_v5\ARM\ARMCC\include\stdio.h)(0x5EC775FC)
+I (..\FreeRTOS\include\FreeRTOS.h)(0x67C84614)
+I (D:\Keil_v5\ARM\ARMCC\include\stddef.h)(0x5EC775FC)
+I (..\FreeRTOS\include\projdefs.h)(0x67C84615)
+I (..\FreeRTOS\include\portable.h)(0x67C84615)
+I (..\FreeRTOS\include\deprecated_definitions.h)(0x67C84612)
+I (..\FreeRTOS\portable\RVDS\ARM_CM4F\portmacro.h)(0x67C84645)
+I (..\FreeRTOS\include\mpu_wrappers.h)(0x67C84614)
+I (..\FreeRTOS\include\task.h)(0x67C84619)
+I (..\FreeRTOS\include\list.h)(0x67C84613)
+I (..\FreeRTOS\include\queue.h)(0x67C84617)
+I (..\FreeRTOS\include\timers.h)(0x67C84618)
+I (..\FreeRTOS\include\semphr.h)(0x67C84617)
+I (..\SYSTEM\delay\delay.h)(0x67C8463B)
+I (..\BALANCE\balance.h)(0x67C844E9)
+I (..\HARDWARE\led.h)(0x67C8454B)
+I (..\HARDWARE\oled.h)(0x67C8454E)
+I (..\HARDWARE\usartx.h)(0x67C84556)
+I (..\HARDWARE\adc.h)(0x67C8453E)
+I (..\HARDWARE\motor.h)(0x69491826)
+I (..\HARDWARE\timer.h)(0x67C84554)
+I (..\HARDWARE\encoder.h)(0x67C84544)
+I (..\BALANCE\show.h)(0x67C844F2)
+I (..\HARDWARE\pstwo.h)(0x67C84551)
+I (..\HARDWARE\key.h)(0x67C84549)
+I (..\BALANCE\robot_select_init.h)(0x6842B20E)
+I (..\HARDWARE\MPU6050\I2C.h)(0x67C84639)
+I (D:\Keil_v5\ARM\ARMCC\include\stdbool.h)(0x5EC775F6)
+I (..\HARDWARE\MPU6050\MPU6050.h)(0x67C8463A)
+I (D:\Keil_v5\ARM\ARMCC\include\stdlib.h)(0x5EC775FC)
+I (D:\Keil_v5\ARM\ARMCC\include\stdarg.h)(0x5EC775FC)
+F (..\HARDWARE\encoder.c)(0x67C84543)(-c --cpu Cortex-M4.fp.sp -g -O0 --apcs=interwork --split_sections -I ..\CORE -I ..\SYSTEM\delay -I ..\SYSTEM\sys -I ..\SYSTEM\usart -I ..\USER -I ..\HARDWARE\LED -I ..\FWLIB\inc -I ..\FreeRTOS\include -I ..\FreeRTOS\portable\RVDS\ARM_CM4F -I ..\BALANCE -I ..\HARDWARE -I ..\HARDWARE\MPU6050

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Drivers\CMSIS\Device\ST\STM32F4xx\Include

-ID:\Keil_v5\ARM\CMSIS\Include

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Device\Include

-D__UVISION_VERSION="531" -DSTM32F407xx -DSTM32F40_41xxx -DUSE_STDPERIPH_DRIVER -D__FPU_PRESENT="1" -D__TARGET_FPU_VFP -DARM_MATH_CM4 -D__CC_ARM --C99

-o ..\obj\encoder.o --omf_browse ..\obj\encoder.crf --depend ..\obj\encoder.d)
+I (..\HARDWARE\encoder.h)(0x67C84544)
+I (..\SYSTEM\sys\sys.h)(0x67C8463C)
+I (..\USER\stm32f4xx.h)(0x67C84611)
+I (..\CORE\core_cm4.h)(0x67C84524)
+I (D:\Keil_v5\ARM\ARMCC\include\stdint.h)(0x5EC775FC)
+I (..\CORE\core_cmInstr.h)(0x67C84526)
+I (..\CORE\core_cmFunc.h)(0x67C84526)
+I (..\CORE\core_cm4_simd.h)(0x67C84526)
+I (..\USER\system_stm32f4xx.h)(0x67C84610)
+I (..\CORE\arm_math.h)(0x67C84525)
+I (D:\Keil_v5\ARM\ARMCC\include\string.h)(0x5EC77604)
+I (D:\Keil_v5\ARM\ARMCC\include\math.h)(0x5EC77604)
+I (..\USER\stm32f4xx_conf.h)(0x67C8460F)
+I (..\FWLIB\inc\stm32f4xx_adc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_crc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dbgmcu.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dma.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_exti.h)(0x67C8461C)
+I (..\FWLIB\inc\stm32f4xx_flash.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_gpio.h)(0x67C8461E)
+I (..\FWLIB\inc\stm32f4xx_i2c.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_iwdg.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_pwr.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_rcc.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_rtc.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_sdio.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_spi.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_syscfg.h)(0x67C84625)
+I (..\FWLIB\inc\stm32f4xx_tim.h)(0x67C84627)
+I (..\FWLIB\inc\stm32f4xx_usart.h)(0x67C84626)
+I (..\FWLIB\inc\stm32f4xx_wwdg.h)(0x67C84626)
+I (..\FWLIB\inc\misc.h)(0x67C84618)
+I (..\FWLIB\inc\stm32f4xx_cryp.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_hash.h)(0x67C8461F)
+I (..\FWLIB\inc\stm32f4xx_rng.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_can.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dac.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dcmi.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_fsmc.h)(0x67C8461F)
+I (..\BALANCE\system.h)(0x67C844F4)
+I (..\FreeRTOS\include\FreeRTOSConfig.h)(0x67C84613)
+I (..\SYSTEM\usart\usart.h)(0x67C8463C)
+I (D:\Keil_v5\ARM\ARMCC\include\stdio.h)(0x5EC775FC)
+I (..\FreeRTOS\include\FreeRTOS.h)(0x67C84614)
+I (D:\Keil_v5\ARM\ARMCC\include\stddef.h)(0x5EC775FC)
+I (..\FreeRTOS\include\projdefs.h)(0x67C84615)
+I (..\FreeRTOS\include\portable.h)(0x67C84615)
+I (..\FreeRTOS\include\deprecated_definitions.h)(0x67C84612)
+I (..\FreeRTOS\portable\RVDS\ARM_CM4F\portmacro.h)(0x67C84645)
+I (..\FreeRTOS\include\mpu_wrappers.h)(0x67C84614)
+I (..\FreeRTOS\include\task.h)(0x67C84619)
+I (..\FreeRTOS\include\list.h)(0x67C84613)
+I (..\FreeRTOS\include\queue.h)(0x67C84617)
+I (..\FreeRTOS\include\timers.h)(0x67C84618)
+I (..\FreeRTOS\include\semphr.h)(0x67C84617)
+I (..\SYSTEM\delay\delay.h)(0x67C8463B)
+I (..\BALANCE\balance.h)(0x67C844E9)
+I (..\HARDWARE\led.h)(0x67C8454B)
+I (..\HARDWARE\oled.h)(0x67C8454E)
+I (..\HARDWARE\usartx.h)(0x67C84556)
+I (..\HARDWARE\adc.h)(0x67C8453E)
+I (..\HARDWARE\can.h)(0x67C84540)
+I (..\HARDWARE\motor.h)(0x69491826)
+I (..\HARDWARE\timer.h)(0x67C84554)
+I (..\BALANCE\show.h)(0x67C844F2)
+I (..\HARDWARE\pstwo.h)(0x67C84551)
+I (..\HARDWARE\key.h)(0x67C84549)
+I (..\BALANCE\robot_select_init.h)(0x6842B20E)
+I (..\HARDWARE\MPU6050\I2C.h)(0x67C84639)
+I (D:\Keil_v5\ARM\ARMCC\include\stdbool.h)(0x5EC775F6)
+I (..\HARDWARE\MPU6050\MPU6050.h)(0x67C8463A)
+I (D:\Keil_v5\ARM\ARMCC\include\stdlib.h)(0x5EC775FC)
+I (D:\Keil_v5\ARM\ARMCC\include\stdarg.h)(0x5EC775FC)
+F (..\HARDWARE\key.c)(0x67C84548)(-c --cpu Cortex-M4.fp.sp -g -O0 --apcs=interwork --split_sections -I ..\CORE -I ..\SYSTEM\delay -I ..\SYSTEM\sys -I ..\SYSTEM\usart -I ..\USER -I ..\HARDWARE\LED -I ..\FWLIB\inc -I ..\FreeRTOS\include -I ..\FreeRTOS\portable\RVDS\ARM_CM4F -I ..\BALANCE -I ..\HARDWARE -I ..\HARDWARE\MPU6050

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Drivers\CMSIS\Device\ST\STM32F4xx\Include

-ID:\Keil_v5\ARM\CMSIS\Include

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Device\Include

-D__UVISION_VERSION="531" -DSTM32F407xx -DSTM32F40_41xxx -DUSE_STDPERIPH_DRIVER -D__FPU_PRESENT="1" -D__TARGET_FPU_VFP -DARM_MATH_CM4 -D__CC_ARM --C99

-o ..\obj\key.o --omf_browse ..\obj\key.crf --depend ..\obj\key.d)
+I (..\HARDWARE\key.h)(0x67C84549)
+I (..\SYSTEM\sys\sys.h)(0x67C8463C)
+I (..\USER\stm32f4xx.h)(0x67C84611)
+I (..\CORE\core_cm4.h)(0x67C84524)
+I (D:\Keil_v5\ARM\ARMCC\include\stdint.h)(0x5EC775FC)
+I (..\CORE\core_cmInstr.h)(0x67C84526)
+I (..\CORE\core_cmFunc.h)(0x67C84526)
+I (..\CORE\core_cm4_simd.h)(0x67C84526)
+I (..\USER\system_stm32f4xx.h)(0x67C84610)
+I (..\CORE\arm_math.h)(0x67C84525)
+I (D:\Keil_v5\ARM\ARMCC\include\string.h)(0x5EC77604)
+I (D:\Keil_v5\ARM\ARMCC\include\math.h)(0x5EC77604)
+I (..\USER\stm32f4xx_conf.h)(0x67C8460F)
+I (..\FWLIB\inc\stm32f4xx_adc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_crc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dbgmcu.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dma.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_exti.h)(0x67C8461C)
+I (..\FWLIB\inc\stm32f4xx_flash.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_gpio.h)(0x67C8461E)
+I (..\FWLIB\inc\stm32f4xx_i2c.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_iwdg.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_pwr.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_rcc.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_rtc.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_sdio.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_spi.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_syscfg.h)(0x67C84625)
+I (..\FWLIB\inc\stm32f4xx_tim.h)(0x67C84627)
+I (..\FWLIB\inc\stm32f4xx_usart.h)(0x67C84626)
+I (..\FWLIB\inc\stm32f4xx_wwdg.h)(0x67C84626)
+I (..\FWLIB\inc\misc.h)(0x67C84618)
+I (..\FWLIB\inc\stm32f4xx_cryp.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_hash.h)(0x67C8461F)
+I (..\FWLIB\inc\stm32f4xx_rng.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_can.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dac.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dcmi.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_fsmc.h)(0x67C8461F)
+I (..\BALANCE\system.h)(0x67C844F4)
+I (..\FreeRTOS\include\FreeRTOSConfig.h)(0x67C84613)
+I (..\SYSTEM\usart\usart.h)(0x67C8463C)
+I (D:\Keil_v5\ARM\ARMCC\include\stdio.h)(0x5EC775FC)
+I (..\FreeRTOS\include\FreeRTOS.h)(0x67C84614)
+I (D:\Keil_v5\ARM\ARMCC\include\stddef.h)(0x5EC775FC)
+I (..\FreeRTOS\include\projdefs.h)(0x67C84615)
+I (..\FreeRTOS\include\portable.h)(0x67C84615)
+I (..\FreeRTOS\include\deprecated_definitions.h)(0x67C84612)
+I (..\FreeRTOS\portable\RVDS\ARM_CM4F\portmacro.h)(0x67C84645)
+I (..\FreeRTOS\include\mpu_wrappers.h)(0x67C84614)
+I (..\FreeRTOS\include\task.h)(0x67C84619)
+I (..\FreeRTOS\include\list.h)(0x67C84613)
+I (..\FreeRTOS\include\queue.h)(0x67C84617)
+I (..\FreeRTOS\include\timers.h)(0x67C84618)
+I (..\FreeRTOS\include\semphr.h)(0x67C84617)
+I (..\SYSTEM\delay\delay.h)(0x67C8463B)
+I (..\BALANCE\balance.h)(0x67C844E9)
+I (..\HARDWARE\led.h)(0x67C8454B)
+I (..\HARDWARE\oled.h)(0x67C8454E)
+I (..\HARDWARE\usartx.h)(0x67C84556)
+I (..\HARDWARE\adc.h)(0x67C8453E)
+I (..\HARDWARE\can.h)(0x67C84540)
+I (..\HARDWARE\motor.h)(0x69491826)
+I (..\HARDWARE\timer.h)(0x67C84554)
+I (..\HARDWARE\encoder.h)(0x67C84544)
+I (..\BALANCE\show.h)(0x67C844F2)
+I (..\HARDWARE\pstwo.h)(0x67C84551)
+I (..\BALANCE\robot_select_init.h)(0x6842B20E)
+I (..\HARDWARE\MPU6050\I2C.h)(0x67C84639)
+I (D:\Keil_v5\ARM\ARMCC\include\stdbool.h)(0x5EC775F6)
+I (..\HARDWARE\MPU6050\MPU6050.h)(0x67C8463A)
+I (D:\Keil_v5\ARM\ARMCC\include\stdlib.h)(0x5EC775FC)
+I (D:\Keil_v5\ARM\ARMCC\include\stdarg.h)(0x5EC775FC)
+F (..\HARDWARE\LED.C)(0x67C8454A)(-c --cpu Cortex-M4.fp.sp -g -O0 --apcs=interwork --split_sections -I ..\CORE -I ..\SYSTEM\delay -I ..\SYSTEM\sys -I ..\SYSTEM\usart -I ..\USER -I ..\HARDWARE\LED -I ..\FWLIB\inc -I ..\FreeRTOS\include -I ..\FreeRTOS\portable\RVDS\ARM_CM4F -I ..\BALANCE -I ..\HARDWARE -I ..\HARDWARE\MPU6050

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Drivers\CMSIS\Device\ST\STM32F4xx\Include

-ID:\Keil_v5\ARM\CMSIS\Include

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Device\Include

-D__UVISION_VERSION="531" -DSTM32F407xx -DSTM32F40_41xxx -DUSE_STDPERIPH_DRIVER -D__FPU_PRESENT="1" -D__TARGET_FPU_VFP -DARM_MATH_CM4 -D__CC_ARM --C99

-o ..\obj\led.o --omf_browse ..\obj\led.crf --depend ..\obj\led.d)
+I (..\HARDWARE\led.h)(0x67C8454B)
+I (..\SYSTEM\sys\sys.h)(0x67C8463C)
+I (..\USER\stm32f4xx.h)(0x67C84611)
+I (..\CORE\core_cm4.h)(0x67C84524)
+I (D:\Keil_v5\ARM\ARMCC\include\stdint.h)(0x5EC775FC)
+I (..\CORE\core_cmInstr.h)(0x67C84526)
+I (..\CORE\core_cmFunc.h)(0x67C84526)
+I (..\CORE\core_cm4_simd.h)(0x67C84526)
+I (..\USER\system_stm32f4xx.h)(0x67C84610)
+I (..\CORE\arm_math.h)(0x67C84525)
+I (D:\Keil_v5\ARM\ARMCC\include\string.h)(0x5EC77604)
+I (D:\Keil_v5\ARM\ARMCC\include\math.h)(0x5EC77604)
+I (..\USER\stm32f4xx_conf.h)(0x67C8460F)
+I (..\FWLIB\inc\stm32f4xx_adc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_crc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dbgmcu.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dma.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_exti.h)(0x67C8461C)
+I (..\FWLIB\inc\stm32f4xx_flash.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_gpio.h)(0x67C8461E)
+I (..\FWLIB\inc\stm32f4xx_i2c.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_iwdg.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_pwr.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_rcc.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_rtc.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_sdio.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_spi.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_syscfg.h)(0x67C84625)
+I (..\FWLIB\inc\stm32f4xx_tim.h)(0x67C84627)
+I (..\FWLIB\inc\stm32f4xx_usart.h)(0x67C84626)
+I (..\FWLIB\inc\stm32f4xx_wwdg.h)(0x67C84626)
+I (..\FWLIB\inc\misc.h)(0x67C84618)
+I (..\FWLIB\inc\stm32f4xx_cryp.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_hash.h)(0x67C8461F)
+I (..\FWLIB\inc\stm32f4xx_rng.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_can.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dac.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dcmi.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_fsmc.h)(0x67C8461F)
+I (..\BALANCE\system.h)(0x67C844F4)
+I (..\FreeRTOS\include\FreeRTOSConfig.h)(0x67C84613)
+I (..\SYSTEM\usart\usart.h)(0x67C8463C)
+I (D:\Keil_v5\ARM\ARMCC\include\stdio.h)(0x5EC775FC)
+I (..\FreeRTOS\include\FreeRTOS.h)(0x67C84614)
+I (D:\Keil_v5\ARM\ARMCC\include\stddef.h)(0x5EC775FC)
+I (..\FreeRTOS\include\projdefs.h)(0x67C84615)
+I (..\FreeRTOS\include\portable.h)(0x67C84615)
+I (..\FreeRTOS\include\deprecated_definitions.h)(0x67C84612)
+I (..\FreeRTOS\portable\RVDS\ARM_CM4F\portmacro.h)(0x67C84645)
+I (..\FreeRTOS\include\mpu_wrappers.h)(0x67C84614)
+I (..\FreeRTOS\include\task.h)(0x67C84619)
+I (..\FreeRTOS\include\list.h)(0x67C84613)
+I (..\FreeRTOS\include\queue.h)(0x67C84617)
+I (..\FreeRTOS\include\timers.h)(0x67C84618)
+I (..\FreeRTOS\include\semphr.h)(0x67C84617)
+I (..\SYSTEM\delay\delay.h)(0x67C8463B)
+I (..\BALANCE\balance.h)(0x67C844E9)
+I (..\HARDWARE\oled.h)(0x67C8454E)
+I (..\HARDWARE\usartx.h)(0x67C84556)
+I (..\HARDWARE\adc.h)(0x67C8453E)
+I (..\HARDWARE\can.h)(0x67C84540)
+I (..\HARDWARE\motor.h)(0x69491826)
+I (..\HARDWARE\timer.h)(0x67C84554)
+I (..\HARDWARE\encoder.h)(0x67C84544)
+I (..\BALANCE\show.h)(0x67C844F2)
+I (..\HARDWARE\pstwo.h)(0x67C84551)
+I (..\HARDWARE\key.h)(0x67C84549)
+I (..\BALANCE\robot_select_init.h)(0x6842B20E)
+I (..\HARDWARE\MPU6050\I2C.h)(0x67C84639)
+I (D:\Keil_v5\ARM\ARMCC\include\stdbool.h)(0x5EC775F6)
+I (..\HARDWARE\MPU6050\MPU6050.h)(0x67C8463A)
+I (D:\Keil_v5\ARM\ARMCC\include\stdlib.h)(0x5EC775FC)
+I (D:\Keil_v5\ARM\ARMCC\include\stdarg.h)(0x5EC775FC)
+F (..\HARDWARE\motor.c)(0x67C8454D)(-c --cpu Cortex-M4.fp.sp -g -O0 --apcs=interwork --split_sections -I ..\CORE -I ..\SYSTEM\delay -I ..\SYSTEM\sys -I ..\SYSTEM\usart -I ..\USER -I ..\HARDWARE\LED -I ..\FWLIB\inc -I ..\FreeRTOS\include -I ..\FreeRTOS\portable\RVDS\ARM_CM4F -I ..\BALANCE -I ..\HARDWARE -I ..\HARDWARE\MPU6050

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Drivers\CMSIS\Device\ST\STM32F4xx\Include

-ID:\Keil_v5\ARM\CMSIS\Include

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Device\Include

-D__UVISION_VERSION="531" -DSTM32F407xx -DSTM32F40_41xxx -DUSE_STDPERIPH_DRIVER -D__FPU_PRESENT="1" -D__TARGET_FPU_VFP -DARM_MATH_CM4 -D__CC_ARM --C99

-o ..\obj\motor.o --omf_browse ..\obj\motor.crf --depend ..\obj\motor.d)
+I (..\HARDWARE\motor.h)(0x69491826)
+I (..\BALANCE\system.h)(0x67C844F4)
+I (..\FreeRTOS\include\FreeRTOSConfig.h)(0x67C84613)
+I (..\SYSTEM\sys\sys.h)(0x67C8463C)
+I (..\USER\stm32f4xx.h)(0x67C84611)
+I (..\CORE\core_cm4.h)(0x67C84524)
+I (D:\Keil_v5\ARM\ARMCC\include\stdint.h)(0x5EC775FC)
+I (..\CORE\core_cmInstr.h)(0x67C84526)
+I (..\CORE\core_cmFunc.h)(0x67C84526)
+I (..\CORE\core_cm4_simd.h)(0x67C84526)
+I (..\USER\system_stm32f4xx.h)(0x67C84610)
+I (..\CORE\arm_math.h)(0x67C84525)
+I (D:\Keil_v5\ARM\ARMCC\include\string.h)(0x5EC77604)
+I (D:\Keil_v5\ARM\ARMCC\include\math.h)(0x5EC77604)
+I (..\USER\stm32f4xx_conf.h)(0x67C8460F)
+I (..\FWLIB\inc\stm32f4xx_adc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_crc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dbgmcu.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dma.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_exti.h)(0x67C8461C)
+I (..\FWLIB\inc\stm32f4xx_flash.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_gpio.h)(0x67C8461E)
+I (..\FWLIB\inc\stm32f4xx_i2c.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_iwdg.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_pwr.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_rcc.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_rtc.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_sdio.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_spi.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_syscfg.h)(0x67C84625)
+I (..\FWLIB\inc\stm32f4xx_tim.h)(0x67C84627)
+I (..\FWLIB\inc\stm32f4xx_usart.h)(0x67C84626)
+I (..\FWLIB\inc\stm32f4xx_wwdg.h)(0x67C84626)
+I (..\FWLIB\inc\misc.h)(0x67C84618)
+I (..\FWLIB\inc\stm32f4xx_cryp.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_hash.h)(0x67C8461F)
+I (..\FWLIB\inc\stm32f4xx_rng.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_can.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dac.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dcmi.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_fsmc.h)(0x67C8461F)
+I (..\SYSTEM\usart\usart.h)(0x67C8463C)
+I (D:\Keil_v5\ARM\ARMCC\include\stdio.h)(0x5EC775FC)
+I (..\FreeRTOS\include\FreeRTOS.h)(0x67C84614)
+I (D:\Keil_v5\ARM\ARMCC\include\stddef.h)(0x5EC775FC)
+I (..\FreeRTOS\include\projdefs.h)(0x67C84615)
+I (..\FreeRTOS\include\portable.h)(0x67C84615)
+I (..\FreeRTOS\include\deprecated_definitions.h)(0x67C84612)
+I (..\FreeRTOS\portable\RVDS\ARM_CM4F\portmacro.h)(0x67C84645)
+I (..\FreeRTOS\include\mpu_wrappers.h)(0x67C84614)
+I (..\FreeRTOS\include\task.h)(0x67C84619)
+I (..\FreeRTOS\include\list.h)(0x67C84613)
+I (..\FreeRTOS\include\queue.h)(0x67C84617)
+I (..\FreeRTOS\include\timers.h)(0x67C84618)
+I (..\FreeRTOS\include\semphr.h)(0x67C84617)
+I (..\SYSTEM\delay\delay.h)(0x67C8463B)
+I (..\BALANCE\balance.h)(0x67C844E9)
+I (..\HARDWARE\led.h)(0x67C8454B)
+I (..\HARDWARE\oled.h)(0x67C8454E)
+I (..\HARDWARE\usartx.h)(0x67C84556)
+I (..\HARDWARE\adc.h)(0x67C8453E)
+I (..\HARDWARE\can.h)(0x67C84540)
+I (..\HARDWARE\timer.h)(0x67C84554)
+I (..\HARDWARE\encoder.h)(0x67C84544)
+I (..\BALANCE\show.h)(0x67C844F2)
+I (..\HARDWARE\pstwo.h)(0x67C84551)
+I (..\HARDWARE\key.h)(0x67C84549)
+I (..\BALANCE\robot_select_init.h)(0x6842B20E)
+I (..\HARDWARE\MPU6050\I2C.h)(0x67C84639)
+I (D:\Keil_v5\ARM\ARMCC\include\stdbool.h)(0x5EC775F6)
+I (..\HARDWARE\MPU6050\MPU6050.h)(0x67C8463A)
+I (D:\Keil_v5\ARM\ARMCC\include\stdlib.h)(0x5EC775FC)
+I (D:\Keil_v5\ARM\ARMCC\include\stdarg.h)(0x5EC775FC)
+F (..\HARDWARE\oled.c)(0x67C84556)(-c --cpu Cortex-M4.fp.sp -g -O0 --apcs=interwork --split_sections -I ..\CORE -I ..\SYSTEM\delay -I ..\SYSTEM\sys -I ..\SYSTEM\usart -I ..\USER -I ..\HARDWARE\LED -I ..\FWLIB\inc -I ..\FreeRTOS\include -I ..\FreeRTOS\portable\RVDS\ARM_CM4F -I ..\BALANCE -I ..\HARDWARE -I ..\HARDWARE\MPU6050

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Drivers\CMSIS\Device\ST\STM32F4xx\Include

-ID:\Keil_v5\ARM\CMSIS\Include

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Device\Include

-D__UVISION_VERSION="531" -DSTM32F407xx -DSTM32F40_41xxx -DUSE_STDPERIPH_DRIVER -D__FPU_PRESENT="1" -D__TARGET_FPU_VFP -DARM_MATH_CM4 -D__CC_ARM --C99

-o ..\obj\oled.o --omf_browse ..\obj\oled.crf --depend ..\obj\oled.d)
+I (..\HARDWARE\oled.h)(0x67C8454E)
+I (..\SYSTEM\sys\sys.h)(0x67C8463C)
+I (..\USER\stm32f4xx.h)(0x67C84611)
+I (..\CORE\core_cm4.h)(0x67C84524)
+I (D:\Keil_v5\ARM\ARMCC\include\stdint.h)(0x5EC775FC)
+I (..\CORE\core_cmInstr.h)(0x67C84526)
+I (..\CORE\core_cmFunc.h)(0x67C84526)
+I (..\CORE\core_cm4_simd.h)(0x67C84526)
+I (..\USER\system_stm32f4xx.h)(0x67C84610)
+I (..\CORE\arm_math.h)(0x67C84525)
+I (D:\Keil_v5\ARM\ARMCC\include\string.h)(0x5EC77604)
+I (D:\Keil_v5\ARM\ARMCC\include\math.h)(0x5EC77604)
+I (..\USER\stm32f4xx_conf.h)(0x67C8460F)
+I (..\FWLIB\inc\stm32f4xx_adc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_crc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dbgmcu.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dma.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_exti.h)(0x67C8461C)
+I (..\FWLIB\inc\stm32f4xx_flash.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_gpio.h)(0x67C8461E)
+I (..\FWLIB\inc\stm32f4xx_i2c.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_iwdg.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_pwr.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_rcc.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_rtc.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_sdio.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_spi.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_syscfg.h)(0x67C84625)
+I (..\FWLIB\inc\stm32f4xx_tim.h)(0x67C84627)
+I (..\FWLIB\inc\stm32f4xx_usart.h)(0x67C84626)
+I (..\FWLIB\inc\stm32f4xx_wwdg.h)(0x67C84626)
+I (..\FWLIB\inc\misc.h)(0x67C84618)
+I (..\FWLIB\inc\stm32f4xx_cryp.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_hash.h)(0x67C8461F)
+I (..\FWLIB\inc\stm32f4xx_rng.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_can.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dac.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dcmi.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_fsmc.h)(0x67C8461F)
+I (..\BALANCE\system.h)(0x67C844F4)
+I (..\FreeRTOS\include\FreeRTOSConfig.h)(0x67C84613)
+I (..\SYSTEM\usart\usart.h)(0x67C8463C)
+I (D:\Keil_v5\ARM\ARMCC\include\stdio.h)(0x5EC775FC)
+I (..\FreeRTOS\include\FreeRTOS.h)(0x67C84614)
+I (D:\Keil_v5\ARM\ARMCC\include\stddef.h)(0x5EC775FC)
+I (..\FreeRTOS\include\projdefs.h)(0x67C84615)
+I (..\FreeRTOS\include\portable.h)(0x67C84615)
+I (..\FreeRTOS\include\deprecated_definitions.h)(0x67C84612)
+I (..\FreeRTOS\portable\RVDS\ARM_CM4F\portmacro.h)(0x67C84645)
+I (..\FreeRTOS\include\mpu_wrappers.h)(0x67C84614)
+I (..\FreeRTOS\include\task.h)(0x67C84619)
+I (..\FreeRTOS\include\list.h)(0x67C84613)
+I (..\FreeRTOS\include\queue.h)(0x67C84617)
+I (..\FreeRTOS\include\timers.h)(0x67C84618)
+I (..\FreeRTOS\include\semphr.h)(0x67C84617)
+I (..\SYSTEM\delay\delay.h)(0x67C8463B)
+I (..\BALANCE\balance.h)(0x67C844E9)
+I (..\HARDWARE\led.h)(0x67C8454B)
+I (..\HARDWARE\usartx.h)(0x67C84556)
+I (..\HARDWARE\adc.h)(0x67C8453E)
+I (..\HARDWARE\can.h)(0x67C84540)
+I (..\HARDWARE\motor.h)(0x69491826)
+I (..\HARDWARE\timer.h)(0x67C84554)
+I (..\HARDWARE\encoder.h)(0x67C84544)
+I (..\BALANCE\show.h)(0x67C844F2)
+I (..\HARDWARE\pstwo.h)(0x67C84551)
+I (..\HARDWARE\key.h)(0x67C84549)
+I (..\BALANCE\robot_select_init.h)(0x6842B20E)
+I (..\HARDWARE\MPU6050\I2C.h)(0x67C84639)
+I (D:\Keil_v5\ARM\ARMCC\include\stdbool.h)(0x5EC775F6)
+I (..\HARDWARE\MPU6050\MPU6050.h)(0x67C8463A)
+I (D:\Keil_v5\ARM\ARMCC\include\stdlib.h)(0x5EC775FC)
+I (D:\Keil_v5\ARM\ARMCC\include\stdarg.h)(0x5EC775FC)
+I (..\HARDWARE\oledfont.h)(0x67C84550)
+F (..\HARDWARE\pstwo.c)(0x67C84550)(-c --cpu Cortex-M4.fp.sp -g -O0 --apcs=interwork --split_sections -I ..\CORE -I ..\SYSTEM\delay -I ..\SYSTEM\sys -I ..\SYSTEM\usart -I ..\USER -I ..\HARDWARE\LED -I ..\FWLIB\inc -I ..\FreeRTOS\include -I ..\FreeRTOS\portable\RVDS\ARM_CM4F -I ..\BALANCE -I ..\HARDWARE -I ..\HARDWARE\MPU6050

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Drivers\CMSIS\Device\ST\STM32F4xx\Include

-ID:\Keil_v5\ARM\CMSIS\Include

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Device\Include

-D__UVISION_VERSION="531" -DSTM32F407xx -DSTM32F40_41xxx -DUSE_STDPERIPH_DRIVER -D__FPU_PRESENT="1" -D__TARGET_FPU_VFP -DARM_MATH_CM4 -D__CC_ARM --C99

-o ..\obj\pstwo.o --omf_browse ..\obj\pstwo.crf --depend ..\obj\pstwo.d)
+I (..\HARDWARE\pstwo.h)(0x67C84551)
+I (..\SYSTEM\delay\delay.h)(0x67C8463B)
+I (..\SYSTEM\sys\sys.h)(0x67C8463C)
+I (..\USER\stm32f4xx.h)(0x67C84611)
+I (..\CORE\core_cm4.h)(0x67C84524)
+I (D:\Keil_v5\ARM\ARMCC\include\stdint.h)(0x5EC775FC)
+I (..\CORE\core_cmInstr.h)(0x67C84526)
+I (..\CORE\core_cmFunc.h)(0x67C84526)
+I (..\CORE\core_cm4_simd.h)(0x67C84526)
+I (..\USER\system_stm32f4xx.h)(0x67C84610)
+I (..\CORE\arm_math.h)(0x67C84525)
+I (D:\Keil_v5\ARM\ARMCC\include\string.h)(0x5EC77604)
+I (D:\Keil_v5\ARM\ARMCC\include\math.h)(0x5EC77604)
+I (..\USER\stm32f4xx_conf.h)(0x67C8460F)
+I (..\FWLIB\inc\stm32f4xx_adc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_crc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dbgmcu.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dma.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_exti.h)(0x67C8461C)
+I (..\FWLIB\inc\stm32f4xx_flash.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_gpio.h)(0x67C8461E)
+I (..\FWLIB\inc\stm32f4xx_i2c.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_iwdg.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_pwr.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_rcc.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_rtc.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_sdio.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_spi.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_syscfg.h)(0x67C84625)
+I (..\FWLIB\inc\stm32f4xx_tim.h)(0x67C84627)
+I (..\FWLIB\inc\stm32f4xx_usart.h)(0x67C84626)
+I (..\FWLIB\inc\stm32f4xx_wwdg.h)(0x67C84626)
+I (..\FWLIB\inc\misc.h)(0x67C84618)
+I (..\FWLIB\inc\stm32f4xx_cryp.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_hash.h)(0x67C8461F)
+I (..\FWLIB\inc\stm32f4xx_rng.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_can.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dac.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dcmi.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_fsmc.h)(0x67C8461F)
+I (..\BALANCE\system.h)(0x67C844F4)
+I (..\FreeRTOS\include\FreeRTOSConfig.h)(0x67C84613)
+I (..\SYSTEM\usart\usart.h)(0x67C8463C)
+I (D:\Keil_v5\ARM\ARMCC\include\stdio.h)(0x5EC775FC)
+I (..\FreeRTOS\include\FreeRTOS.h)(0x67C84614)
+I (D:\Keil_v5\ARM\ARMCC\include\stddef.h)(0x5EC775FC)
+I (..\FreeRTOS\include\projdefs.h)(0x67C84615)
+I (..\FreeRTOS\include\portable.h)(0x67C84615)
+I (..\FreeRTOS\include\deprecated_definitions.h)(0x67C84612)
+I (..\FreeRTOS\portable\RVDS\ARM_CM4F\portmacro.h)(0x67C84645)
+I (..\FreeRTOS\include\mpu_wrappers.h)(0x67C84614)
+I (..\FreeRTOS\include\task.h)(0x67C84619)
+I (..\FreeRTOS\include\list.h)(0x67C84613)
+I (..\FreeRTOS\include\queue.h)(0x67C84617)
+I (..\FreeRTOS\include\timers.h)(0x67C84618)
+I (..\FreeRTOS\include\semphr.h)(0x67C84617)
+I (..\BALANCE\balance.h)(0x67C844E9)
+I (..\HARDWARE\led.h)(0x67C8454B)
+I (..\HARDWARE\oled.h)(0x67C8454E)
+I (..\HARDWARE\usartx.h)(0x67C84556)
+I (..\HARDWARE\adc.h)(0x67C8453E)
+I (..\HARDWARE\can.h)(0x67C84540)
+I (..\HARDWARE\motor.h)(0x69491826)
+I (..\HARDWARE\timer.h)(0x67C84554)
+I (..\HARDWARE\encoder.h)(0x67C84544)
+I (..\BALANCE\show.h)(0x67C844F2)
+I (..\HARDWARE\key.h)(0x67C84549)
+I (..\BALANCE\robot_select_init.h)(0x6842B20E)
+I (..\HARDWARE\MPU6050\I2C.h)(0x67C84639)
+I (D:\Keil_v5\ARM\ARMCC\include\stdbool.h)(0x5EC775F6)
+I (..\HARDWARE\MPU6050\MPU6050.h)(0x67C8463A)
+I (D:\Keil_v5\ARM\ARMCC\include\stdlib.h)(0x5EC775FC)
+I (D:\Keil_v5\ARM\ARMCC\include\stdarg.h)(0x5EC775FC)
+F (..\HARDWARE\timer.c)(0x67C84553)(-c --cpu Cortex-M4.fp.sp -g -O0 --apcs=interwork --split_sections -I ..\CORE -I ..\SYSTEM\delay -I ..\SYSTEM\sys -I ..\SYSTEM\usart -I ..\USER -I ..\HARDWARE\LED -I ..\FWLIB\inc -I ..\FreeRTOS\include -I ..\FreeRTOS\portable\RVDS\ARM_CM4F -I ..\BALANCE -I ..\HARDWARE -I ..\HARDWARE\MPU6050

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Drivers\CMSIS\Device\ST\STM32F4xx\Include

-ID:\Keil_v5\ARM\CMSIS\Include

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Device\Include

-D__UVISION_VERSION="531" -DSTM32F407xx -DSTM32F40_41xxx -DUSE_STDPERIPH_DRIVER -D__FPU_PRESENT="1" -D__TARGET_FPU_VFP -DARM_MATH_CM4 -D__CC_ARM --C99

-o ..\obj\timer.o --omf_browse ..\obj\timer.crf --depend ..\obj\timer.d)
+I (..\HARDWARE\timer.h)(0x67C84554)
+I (..\BALANCE\system.h)(0x67C844F4)
+I (..\FreeRTOS\include\FreeRTOSConfig.h)(0x67C84613)
+I (..\SYSTEM\sys\sys.h)(0x67C8463C)
+I (..\USER\stm32f4xx.h)(0x67C84611)
+I (..\CORE\core_cm4.h)(0x67C84524)
+I (D:\Keil_v5\ARM\ARMCC\include\stdint.h)(0x5EC775FC)
+I (..\CORE\core_cmInstr.h)(0x67C84526)
+I (..\CORE\core_cmFunc.h)(0x67C84526)
+I (..\CORE\core_cm4_simd.h)(0x67C84526)
+I (..\USER\system_stm32f4xx.h)(0x67C84610)
+I (..\CORE\arm_math.h)(0x67C84525)
+I (D:\Keil_v5\ARM\ARMCC\include\string.h)(0x5EC77604)
+I (D:\Keil_v5\ARM\ARMCC\include\math.h)(0x5EC77604)
+I (..\USER\stm32f4xx_conf.h)(0x67C8460F)
+I (..\FWLIB\inc\stm32f4xx_adc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_crc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dbgmcu.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dma.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_exti.h)(0x67C8461C)
+I (..\FWLIB\inc\stm32f4xx_flash.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_gpio.h)(0x67C8461E)
+I (..\FWLIB\inc\stm32f4xx_i2c.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_iwdg.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_pwr.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_rcc.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_rtc.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_sdio.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_spi.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_syscfg.h)(0x67C84625)
+I (..\FWLIB\inc\stm32f4xx_tim.h)(0x67C84627)
+I (..\FWLIB\inc\stm32f4xx_usart.h)(0x67C84626)
+I (..\FWLIB\inc\stm32f4xx_wwdg.h)(0x67C84626)
+I (..\FWLIB\inc\misc.h)(0x67C84618)
+I (..\FWLIB\inc\stm32f4xx_cryp.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_hash.h)(0x67C8461F)
+I (..\FWLIB\inc\stm32f4xx_rng.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_can.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dac.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dcmi.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_fsmc.h)(0x67C8461F)
+I (..\SYSTEM\usart\usart.h)(0x67C8463C)
+I (D:\Keil_v5\ARM\ARMCC\include\stdio.h)(0x5EC775FC)
+I (..\FreeRTOS\include\FreeRTOS.h)(0x67C84614)
+I (D:\Keil_v5\ARM\ARMCC\include\stddef.h)(0x5EC775FC)
+I (..\FreeRTOS\include\projdefs.h)(0x67C84615)
+I (..\FreeRTOS\include\portable.h)(0x67C84615)
+I (..\FreeRTOS\include\deprecated_definitions.h)(0x67C84612)
+I (..\FreeRTOS\portable\RVDS\ARM_CM4F\portmacro.h)(0x67C84645)
+I (..\FreeRTOS\include\mpu_wrappers.h)(0x67C84614)
+I (..\FreeRTOS\include\task.h)(0x67C84619)
+I (..\FreeRTOS\include\list.h)(0x67C84613)
+I (..\FreeRTOS\include\queue.h)(0x67C84617)
+I (..\FreeRTOS\include\timers.h)(0x67C84618)
+I (..\FreeRTOS\include\semphr.h)(0x67C84617)
+I (..\SYSTEM\delay\delay.h)(0x67C8463B)
+I (..\BALANCE\balance.h)(0x67C844E9)
+I (..\HARDWARE\led.h)(0x67C8454B)
+I (..\HARDWARE\oled.h)(0x67C8454E)
+I (..\HARDWARE\usartx.h)(0x67C84556)
+I (..\HARDWARE\adc.h)(0x67C8453E)
+I (..\HARDWARE\can.h)(0x67C84540)
+I (..\HARDWARE\motor.h)(0x69491826)
+I (..\HARDWARE\encoder.h)(0x67C84544)
+I (..\BALANCE\show.h)(0x67C844F2)
+I (..\HARDWARE\pstwo.h)(0x67C84551)
+I (..\HARDWARE\key.h)(0x67C84549)
+I (..\BALANCE\robot_select_init.h)(0x6842B20E)
+I (..\HARDWARE\MPU6050\I2C.h)(0x67C84639)
+I (D:\Keil_v5\ARM\ARMCC\include\stdbool.h)(0x5EC775F6)
+I (..\HARDWARE\MPU6050\MPU6050.h)(0x67C8463A)
+I (D:\Keil_v5\ARM\ARMCC\include\stdlib.h)(0x5EC775FC)
+I (D:\Keil_v5\ARM\ARMCC\include\stdarg.h)(0x5EC775FC)
+F (..\HARDWARE\usartx.c)(0x688742F1)(-c --cpu Cortex-M4.fp.sp -g -O0 --apcs=interwork --split_sections -I ..\CORE -I ..\SYSTEM\delay -I ..\SYSTEM\sys -I ..\SYSTEM\usart -I ..\USER -I ..\HARDWARE\LED -I ..\FWLIB\inc -I ..\FreeRTOS\include -I ..\FreeRTOS\portable\RVDS\ARM_CM4F -I ..\BALANCE -I ..\HARDWARE -I ..\HARDWARE\MPU6050

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Drivers\CMSIS\Device\ST\STM32F4xx\Include

-ID:\Keil_v5\ARM\CMSIS\Include

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Device\Include

-D__UVISION_VERSION="531" -DSTM32F407xx -DSTM32F40_41xxx -DUSE_STDPERIPH_DRIVER -D__FPU_PRESENT="1" -D__TARGET_FPU_VFP -DARM_MATH_CM4 -D__CC_ARM --C99

-o ..\obj\usartx.o --omf_browse ..\obj\usartx.crf --depend ..\obj\usartx.d)
+I (..\HARDWARE\usartx.h)(0x67C84556)
+I (D:\Keil_v5\ARM\ARMCC\include\stdio.h)(0x5EC775FC)
+I (..\SYSTEM\sys\sys.h)(0x67C8463C)
+I (..\USER\stm32f4xx.h)(0x67C84611)
+I (..\CORE\core_cm4.h)(0x67C84524)
+I (D:\Keil_v5\ARM\ARMCC\include\stdint.h)(0x5EC775FC)
+I (..\CORE\core_cmInstr.h)(0x67C84526)
+I (..\CORE\core_cmFunc.h)(0x67C84526)
+I (..\CORE\core_cm4_simd.h)(0x67C84526)
+I (..\USER\system_stm32f4xx.h)(0x67C84610)
+I (..\CORE\arm_math.h)(0x67C84525)
+I (D:\Keil_v5\ARM\ARMCC\include\string.h)(0x5EC77604)
+I (D:\Keil_v5\ARM\ARMCC\include\math.h)(0x5EC77604)
+I (..\USER\stm32f4xx_conf.h)(0x67C8460F)
+I (..\FWLIB\inc\stm32f4xx_adc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_crc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dbgmcu.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dma.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_exti.h)(0x67C8461C)
+I (..\FWLIB\inc\stm32f4xx_flash.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_gpio.h)(0x67C8461E)
+I (..\FWLIB\inc\stm32f4xx_i2c.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_iwdg.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_pwr.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_rcc.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_rtc.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_sdio.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_spi.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_syscfg.h)(0x67C84625)
+I (..\FWLIB\inc\stm32f4xx_tim.h)(0x67C84627)
+I (..\FWLIB\inc\stm32f4xx_usart.h)(0x67C84626)
+I (..\FWLIB\inc\stm32f4xx_wwdg.h)(0x67C84626)
+I (..\FWLIB\inc\misc.h)(0x67C84618)
+I (..\FWLIB\inc\stm32f4xx_cryp.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_hash.h)(0x67C8461F)
+I (..\FWLIB\inc\stm32f4xx_rng.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_can.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dac.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dcmi.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_fsmc.h)(0x67C8461F)
+I (..\BALANCE\system.h)(0x67C844F4)
+I (..\FreeRTOS\include\FreeRTOSConfig.h)(0x67C84613)
+I (..\SYSTEM\usart\usart.h)(0x67C8463C)
+I (..\FreeRTOS\include\FreeRTOS.h)(0x67C84614)
+I (D:\Keil_v5\ARM\ARMCC\include\stddef.h)(0x5EC775FC)
+I (..\FreeRTOS\include\projdefs.h)(0x67C84615)
+I (..\FreeRTOS\include\portable.h)(0x67C84615)
+I (..\FreeRTOS\include\deprecated_definitions.h)(0x67C84612)
+I (..\FreeRTOS\portable\RVDS\ARM_CM4F\portmacro.h)(0x67C84645)
+I (..\FreeRTOS\include\mpu_wrappers.h)(0x67C84614)
+I (..\FreeRTOS\include\task.h)(0x67C84619)
+I (..\FreeRTOS\include\list.h)(0x67C84613)
+I (..\FreeRTOS\include\queue.h)(0x67C84617)
+I (..\FreeRTOS\include\timers.h)(0x67C84618)
+I (..\FreeRTOS\include\semphr.h)(0x67C84617)
+I (..\SYSTEM\delay\delay.h)(0x67C8463B)
+I (..\BALANCE\balance.h)(0x67C844E9)
+I (..\HARDWARE\led.h)(0x67C8454B)
+I (..\HARDWARE\oled.h)(0x67C8454E)
+I (..\HARDWARE\adc.h)(0x67C8453E)
+I (..\HARDWARE\can.h)(0x67C84540)
+I (..\HARDWARE\motor.h)(0x69491826)
+I (..\HARDWARE\timer.h)(0x67C84554)
+I (..\HARDWARE\encoder.h)(0x67C84544)
+I (..\BALANCE\show.h)(0x67C844F2)
+I (..\HARDWARE\pstwo.h)(0x67C84551)
+I (..\HARDWARE\key.h)(0x67C84549)
+I (..\BALANCE\robot_select_init.h)(0x6842B20E)
+I (..\HARDWARE\MPU6050\I2C.h)(0x67C84639)
+I (D:\Keil_v5\ARM\ARMCC\include\stdbool.h)(0x5EC775F6)
+I (..\HARDWARE\MPU6050\MPU6050.h)(0x67C8463A)
+I (D:\Keil_v5\ARM\ARMCC\include\stdlib.h)(0x5EC775FC)
+I (D:\Keil_v5\ARM\ARMCC\include\stdarg.h)(0x5EC775FC)
+F (..\SYSTEM\delay\delay.c)(0x67C8463B)(-c --cpu Cortex-M4.fp.sp -g -O0 --apcs=interwork --split_sections -I ..\CORE -I ..\SYSTEM\delay -I ..\SYSTEM\sys -I ..\SYSTEM\usart -I ..\USER -I ..\HARDWARE\LED -I ..\FWLIB\inc -I ..\FreeRTOS\include -I ..\FreeRTOS\portable\RVDS\ARM_CM4F -I ..\BALANCE -I ..\HARDWARE -I ..\HARDWARE\MPU6050

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Drivers\CMSIS\Device\ST\STM32F4xx\Include

-ID:\Keil_v5\ARM\CMSIS\Include

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Device\Include

-D__UVISION_VERSION="531" -DSTM32F407xx -DSTM32F40_41xxx -DUSE_STDPERIPH_DRIVER -D__FPU_PRESENT="1" -D__TARGET_FPU_VFP -DARM_MATH_CM4 -D__CC_ARM --C99

-o ..\obj\delay.o --omf_browse ..\obj\delay.crf --depend ..\obj\delay.d)
+I (..\SYSTEM\delay\delay.h)(0x67C8463B)
+I (..\SYSTEM\sys\sys.h)(0x67C8463C)
+I (..\USER\stm32f4xx.h)(0x67C84611)
+I (..\CORE\core_cm4.h)(0x67C84524)
+I (D:\Keil_v5\ARM\ARMCC\include\stdint.h)(0x5EC775FC)
+I (..\CORE\core_cmInstr.h)(0x67C84526)
+I (..\CORE\core_cmFunc.h)(0x67C84526)
+I (..\CORE\core_cm4_simd.h)(0x67C84526)
+I (..\USER\system_stm32f4xx.h)(0x67C84610)
+I (..\CORE\arm_math.h)(0x67C84525)
+I (D:\Keil_v5\ARM\ARMCC\include\string.h)(0x5EC77604)
+I (D:\Keil_v5\ARM\ARMCC\include\math.h)(0x5EC77604)
+I (..\USER\stm32f4xx_conf.h)(0x67C8460F)
+I (..\FWLIB\inc\stm32f4xx_adc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_crc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dbgmcu.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dma.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_exti.h)(0x67C8461C)
+I (..\FWLIB\inc\stm32f4xx_flash.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_gpio.h)(0x67C8461E)
+I (..\FWLIB\inc\stm32f4xx_i2c.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_iwdg.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_pwr.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_rcc.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_rtc.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_sdio.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_spi.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_syscfg.h)(0x67C84625)
+I (..\FWLIB\inc\stm32f4xx_tim.h)(0x67C84627)
+I (..\FWLIB\inc\stm32f4xx_usart.h)(0x67C84626)
+I (..\FWLIB\inc\stm32f4xx_wwdg.h)(0x67C84626)
+I (..\FWLIB\inc\misc.h)(0x67C84618)
+I (..\FWLIB\inc\stm32f4xx_cryp.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_hash.h)(0x67C8461F)
+I (..\FWLIB\inc\stm32f4xx_rng.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_can.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dac.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dcmi.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_fsmc.h)(0x67C8461F)
+I (..\FreeRTOS\include\FreeRTOS.h)(0x67C84614)
+I (D:\Keil_v5\ARM\ARMCC\include\stddef.h)(0x5EC775FC)
+I (..\FreeRTOS\include\FreeRTOSConfig.h)(0x67C84613)
+I (..\SYSTEM\usart\usart.h)(0x67C8463C)
+I (D:\Keil_v5\ARM\ARMCC\include\stdio.h)(0x5EC775FC)
+I (..\FreeRTOS\include\projdefs.h)(0x67C84615)
+I (..\FreeRTOS\include\portable.h)(0x67C84615)
+I (..\FreeRTOS\include\deprecated_definitions.h)(0x67C84612)
+I (..\FreeRTOS\portable\RVDS\ARM_CM4F\portmacro.h)(0x67C84645)
+I (..\FreeRTOS\include\mpu_wrappers.h)(0x67C84614)
+I (..\FreeRTOS\include\task.h)(0x67C84619)
+I (..\FreeRTOS\include\list.h)(0x67C84613)
+F (..\SYSTEM\sys\sys.c)(0x67C8463B)(-c --cpu Cortex-M4.fp.sp -g -O0 --apcs=interwork --split_sections -I ..\CORE -I ..\SYSTEM\delay -I ..\SYSTEM\sys -I ..\SYSTEM\usart -I ..\USER -I ..\HARDWARE\LED -I ..\FWLIB\inc -I ..\FreeRTOS\include -I ..\FreeRTOS\portable\RVDS\ARM_CM4F -I ..\BALANCE -I ..\HARDWARE -I ..\HARDWARE\MPU6050

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Drivers\CMSIS\Device\ST\STM32F4xx\Include

-ID:\Keil_v5\ARM\CMSIS\Include

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Device\Include

-D__UVISION_VERSION="531" -DSTM32F407xx -DSTM32F40_41xxx -DUSE_STDPERIPH_DRIVER -D__FPU_PRESENT="1" -D__TARGET_FPU_VFP -DARM_MATH_CM4 -D__CC_ARM --C99

-o ..\obj\sys.o --omf_browse ..\obj\sys.crf --depend ..\obj\sys.d)
+I (..\SYSTEM\sys\sys.h)(0x67C8463C)
+I (..\USER\stm32f4xx.h)(0x67C84611)
+I (..\CORE\core_cm4.h)(0x67C84524)
+I (D:\Keil_v5\ARM\ARMCC\include\stdint.h)(0x5EC775FC)
+I (..\CORE\core_cmInstr.h)(0x67C84526)
+I (..\CORE\core_cmFunc.h)(0x67C84526)
+I (..\CORE\core_cm4_simd.h)(0x67C84526)
+I (..\USER\system_stm32f4xx.h)(0x67C84610)
+I (..\CORE\arm_math.h)(0x67C84525)
+I (D:\Keil_v5\ARM\ARMCC\include\string.h)(0x5EC77604)
+I (D:\Keil_v5\ARM\ARMCC\include\math.h)(0x5EC77604)
+I (..\USER\stm32f4xx_conf.h)(0x67C8460F)
+I (..\FWLIB\inc\stm32f4xx_adc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_crc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dbgmcu.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dma.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_exti.h)(0x67C8461C)
+I (..\FWLIB\inc\stm32f4xx_flash.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_gpio.h)(0x67C8461E)
+I (..\FWLIB\inc\stm32f4xx_i2c.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_iwdg.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_pwr.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_rcc.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_rtc.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_sdio.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_spi.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_syscfg.h)(0x67C84625)
+I (..\FWLIB\inc\stm32f4xx_tim.h)(0x67C84627)
+I (..\FWLIB\inc\stm32f4xx_usart.h)(0x67C84626)
+I (..\FWLIB\inc\stm32f4xx_wwdg.h)(0x67C84626)
+I (..\FWLIB\inc\misc.h)(0x67C84618)
+I (..\FWLIB\inc\stm32f4xx_cryp.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_hash.h)(0x67C8461F)
+I (..\FWLIB\inc\stm32f4xx_rng.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_can.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dac.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dcmi.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_fsmc.h)(0x67C8461F)
+F (..\SYSTEM\usart\usart.c)(0x687CED0F)(-c --cpu Cortex-M4.fp.sp -g -O0 --apcs=interwork --split_sections -I ..\CORE -I ..\SYSTEM\delay -I ..\SYSTEM\sys -I ..\SYSTEM\usart -I ..\USER -I ..\HARDWARE\LED -I ..\FWLIB\inc -I ..\FreeRTOS\include -I ..\FreeRTOS\portable\RVDS\ARM_CM4F -I ..\BALANCE -I ..\HARDWARE -I ..\HARDWARE\MPU6050

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Drivers\CMSIS\Device\ST\STM32F4xx\Include

-ID:\Keil_v5\ARM\CMSIS\Include

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Device\Include

-D__UVISION_VERSION="531" -DSTM32F407xx -DSTM32F40_41xxx -DUSE_STDPERIPH_DRIVER -D__FPU_PRESENT="1" -D__TARGET_FPU_VFP -DARM_MATH_CM4 -D__CC_ARM --C99

-o ..\obj\usart.o --omf_browse ..\obj\usart.crf --depend ..\obj\usart.d)
+I (..\SYSTEM\usart\usart.h)(0x67C8463C)
+I (D:\Keil_v5\ARM\ARMCC\include\stdio.h)(0x5EC775FC)
+I (..\USER\stm32f4xx_conf.h)(0x67C8460F)
+I (..\FWLIB\inc\stm32f4xx_adc.h)(0x67C8461A)
+I (..\USER\stm32f4xx.h)(0x67C84611)
+I (..\CORE\core_cm4.h)(0x67C84524)
+I (D:\Keil_v5\ARM\ARMCC\include\stdint.h)(0x5EC775FC)
+I (..\CORE\core_cmInstr.h)(0x67C84526)
+I (..\CORE\core_cmFunc.h)(0x67C84526)
+I (..\CORE\core_cm4_simd.h)(0x67C84526)
+I (..\USER\system_stm32f4xx.h)(0x67C84610)
+I (..\CORE\arm_math.h)(0x67C84525)
+I (D:\Keil_v5\ARM\ARMCC\include\string.h)(0x5EC77604)
+I (D:\Keil_v5\ARM\ARMCC\include\math.h)(0x5EC77604)
+I (..\FWLIB\inc\stm32f4xx_crc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dbgmcu.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dma.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_exti.h)(0x67C8461C)
+I (..\FWLIB\inc\stm32f4xx_flash.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_gpio.h)(0x67C8461E)
+I (..\FWLIB\inc\stm32f4xx_i2c.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_iwdg.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_pwr.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_rcc.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_rtc.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_sdio.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_spi.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_syscfg.h)(0x67C84625)
+I (..\FWLIB\inc\stm32f4xx_tim.h)(0x67C84627)
+I (..\FWLIB\inc\stm32f4xx_usart.h)(0x67C84626)
+I (..\FWLIB\inc\stm32f4xx_wwdg.h)(0x67C84626)
+I (..\FWLIB\inc\misc.h)(0x67C84618)
+I (..\FWLIB\inc\stm32f4xx_cryp.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_hash.h)(0x67C8461F)
+I (..\FWLIB\inc\stm32f4xx_rng.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_can.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dac.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dcmi.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_fsmc.h)(0x67C8461F)
+I (..\SYSTEM\sys\sys.h)(0x67C8463C)
+I (..\FreeRTOS\include\FreeRTOS.h)(0x67C84614)
+I (D:\Keil_v5\ARM\ARMCC\include\stddef.h)(0x5EC775FC)
+I (..\FreeRTOS\include\FreeRTOSConfig.h)(0x67C84613)
+I (..\FreeRTOS\include\projdefs.h)(0x67C84615)
+I (..\FreeRTOS\include\portable.h)(0x67C84615)
+I (..\FreeRTOS\include\deprecated_definitions.h)(0x67C84612)
+I (..\FreeRTOS\portable\RVDS\ARM_CM4F\portmacro.h)(0x67C84645)
+I (..\FreeRTOS\include\mpu_wrappers.h)(0x67C84614)
+F (..\CORE\startup_stm32f40_41xxx.s)(0x67C84534)(--cpu Cortex-M4.fp.sp -g --apcs=interwork 

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Drivers\CMSIS\Device\ST\STM32F4xx\Include

-ID:\Keil_v5\ARM\CMSIS\Include

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Device\Include

--pd "__UVISION_VERSION SETA 531" --pd "STM32F407xx SETA 1"

--list ..\obj\startup_stm32f40_41xxx.lst --xref -o ..\obj\startup_stm32f40_41xxx.o --depend ..\obj\startup_stm32f40_41xxx.d)
+F (..\FWLIB\src\misc.c)(0x67C84627)(-c --cpu Cortex-M4.fp.sp -g -O0 --apcs=interwork --split_sections -I ..\CORE -I ..\SYSTEM\delay -I ..\SYSTEM\sys -I ..\SYSTEM\usart -I ..\USER -I ..\HARDWARE\LED -I ..\FWLIB\inc -I ..\FreeRTOS\include -I ..\FreeRTOS\portable\RVDS\ARM_CM4F -I ..\BALANCE -I ..\HARDWARE -I ..\HARDWARE\MPU6050

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Drivers\CMSIS\Device\ST\STM32F4xx\Include

-ID:\Keil_v5\ARM\CMSIS\Include

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Device\Include

-D__UVISION_VERSION="531" -DSTM32F407xx -DSTM32F40_41xxx -DUSE_STDPERIPH_DRIVER -D__FPU_PRESENT="1" -D__TARGET_FPU_VFP -DARM_MATH_CM4 -D__CC_ARM --C99

-o ..\obj\misc.o --omf_browse ..\obj\misc.crf --depend ..\obj\misc.d)
+I (..\FWLIB\inc\misc.h)(0x67C84618)
+I (..\USER\stm32f4xx.h)(0x67C84611)
+I (..\CORE\core_cm4.h)(0x67C84524)
+I (D:\Keil_v5\ARM\ARMCC\include\stdint.h)(0x5EC775FC)
+I (..\CORE\core_cmInstr.h)(0x67C84526)
+I (..\CORE\core_cmFunc.h)(0x67C84526)
+I (..\CORE\core_cm4_simd.h)(0x67C84526)
+I (..\USER\system_stm32f4xx.h)(0x67C84610)
+I (..\CORE\arm_math.h)(0x67C84525)
+I (D:\Keil_v5\ARM\ARMCC\include\string.h)(0x5EC77604)
+I (D:\Keil_v5\ARM\ARMCC\include\math.h)(0x5EC77604)
+I (..\USER\stm32f4xx_conf.h)(0x67C8460F)
+I (..\FWLIB\inc\stm32f4xx_adc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_crc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dbgmcu.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dma.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_exti.h)(0x67C8461C)
+I (..\FWLIB\inc\stm32f4xx_flash.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_gpio.h)(0x67C8461E)
+I (..\FWLIB\inc\stm32f4xx_i2c.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_iwdg.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_pwr.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_rcc.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_rtc.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_sdio.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_spi.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_syscfg.h)(0x67C84625)
+I (..\FWLIB\inc\stm32f4xx_tim.h)(0x67C84627)
+I (..\FWLIB\inc\stm32f4xx_usart.h)(0x67C84626)
+I (..\FWLIB\inc\stm32f4xx_wwdg.h)(0x67C84626)
+I (..\FWLIB\inc\stm32f4xx_cryp.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_hash.h)(0x67C8461F)
+I (..\FWLIB\inc\stm32f4xx_rng.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_can.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dac.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dcmi.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_fsmc.h)(0x67C8461F)
+F (..\FWLIB\src\stm32f4xx_gpio.c)(0x67C84630)(-c --cpu Cortex-M4.fp.sp -g -O0 --apcs=interwork --split_sections -I ..\CORE -I ..\SYSTEM\delay -I ..\SYSTEM\sys -I ..\SYSTEM\usart -I ..\USER -I ..\HARDWARE\LED -I ..\FWLIB\inc -I ..\FreeRTOS\include -I ..\FreeRTOS\portable\RVDS\ARM_CM4F -I ..\BALANCE -I ..\HARDWARE -I ..\HARDWARE\MPU6050

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Drivers\CMSIS\Device\ST\STM32F4xx\Include

-ID:\Keil_v5\ARM\CMSIS\Include

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Device\Include

-D__UVISION_VERSION="531" -DSTM32F407xx -DSTM32F40_41xxx -DUSE_STDPERIPH_DRIVER -D__FPU_PRESENT="1" -D__TARGET_FPU_VFP -DARM_MATH_CM4 -D__CC_ARM --C99

-o ..\obj\stm32f4xx_gpio.o --omf_browse ..\obj\stm32f4xx_gpio.crf --depend ..\obj\stm32f4xx_gpio.d)
+I (..\FWLIB\inc\stm32f4xx_gpio.h)(0x67C8461E)
+I (..\USER\stm32f4xx.h)(0x67C84611)
+I (..\CORE\core_cm4.h)(0x67C84524)
+I (D:\Keil_v5\ARM\ARMCC\include\stdint.h)(0x5EC775FC)
+I (..\CORE\core_cmInstr.h)(0x67C84526)
+I (..\CORE\core_cmFunc.h)(0x67C84526)
+I (..\CORE\core_cm4_simd.h)(0x67C84526)
+I (..\USER\system_stm32f4xx.h)(0x67C84610)
+I (..\CORE\arm_math.h)(0x67C84525)
+I (D:\Keil_v5\ARM\ARMCC\include\string.h)(0x5EC77604)
+I (D:\Keil_v5\ARM\ARMCC\include\math.h)(0x5EC77604)
+I (..\USER\stm32f4xx_conf.h)(0x67C8460F)
+I (..\FWLIB\inc\stm32f4xx_adc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_crc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dbgmcu.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dma.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_exti.h)(0x67C8461C)
+I (..\FWLIB\inc\stm32f4xx_flash.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_i2c.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_iwdg.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_pwr.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_rcc.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_rtc.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_sdio.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_spi.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_syscfg.h)(0x67C84625)
+I (..\FWLIB\inc\stm32f4xx_tim.h)(0x67C84627)
+I (..\FWLIB\inc\stm32f4xx_usart.h)(0x67C84626)
+I (..\FWLIB\inc\stm32f4xx_wwdg.h)(0x67C84626)
+I (..\FWLIB\inc\misc.h)(0x67C84618)
+I (..\FWLIB\inc\stm32f4xx_cryp.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_hash.h)(0x67C8461F)
+I (..\FWLIB\inc\stm32f4xx_rng.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_can.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dac.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dcmi.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_fsmc.h)(0x67C8461F)
+F (..\FWLIB\src\stm32f4xx_rcc.c)(0x67C84635)(-c --cpu Cortex-M4.fp.sp -g -O0 --apcs=interwork --split_sections -I ..\CORE -I ..\SYSTEM\delay -I ..\SYSTEM\sys -I ..\SYSTEM\usart -I ..\USER -I ..\HARDWARE\LED -I ..\FWLIB\inc -I ..\FreeRTOS\include -I ..\FreeRTOS\portable\RVDS\ARM_CM4F -I ..\BALANCE -I ..\HARDWARE -I ..\HARDWARE\MPU6050

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Drivers\CMSIS\Device\ST\STM32F4xx\Include

-ID:\Keil_v5\ARM\CMSIS\Include

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Device\Include

-D__UVISION_VERSION="531" -DSTM32F407xx -DSTM32F40_41xxx -DUSE_STDPERIPH_DRIVER -D__FPU_PRESENT="1" -D__TARGET_FPU_VFP -DARM_MATH_CM4 -D__CC_ARM --C99

-o ..\obj\stm32f4xx_rcc.o --omf_browse ..\obj\stm32f4xx_rcc.crf --depend ..\obj\stm32f4xx_rcc.d)
+I (..\FWLIB\inc\stm32f4xx_rcc.h)(0x67C84624)
+I (..\USER\stm32f4xx.h)(0x67C84611)
+I (..\CORE\core_cm4.h)(0x67C84524)
+I (D:\Keil_v5\ARM\ARMCC\include\stdint.h)(0x5EC775FC)
+I (..\CORE\core_cmInstr.h)(0x67C84526)
+I (..\CORE\core_cmFunc.h)(0x67C84526)
+I (..\CORE\core_cm4_simd.h)(0x67C84526)
+I (..\USER\system_stm32f4xx.h)(0x67C84610)
+I (..\CORE\arm_math.h)(0x67C84525)
+I (D:\Keil_v5\ARM\ARMCC\include\string.h)(0x5EC77604)
+I (D:\Keil_v5\ARM\ARMCC\include\math.h)(0x5EC77604)
+I (..\USER\stm32f4xx_conf.h)(0x67C8460F)
+I (..\FWLIB\inc\stm32f4xx_adc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_crc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dbgmcu.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dma.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_exti.h)(0x67C8461C)
+I (..\FWLIB\inc\stm32f4xx_flash.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_gpio.h)(0x67C8461E)
+I (..\FWLIB\inc\stm32f4xx_i2c.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_iwdg.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_pwr.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_rtc.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_sdio.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_spi.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_syscfg.h)(0x67C84625)
+I (..\FWLIB\inc\stm32f4xx_tim.h)(0x67C84627)
+I (..\FWLIB\inc\stm32f4xx_usart.h)(0x67C84626)
+I (..\FWLIB\inc\stm32f4xx_wwdg.h)(0x67C84626)
+I (..\FWLIB\inc\misc.h)(0x67C84618)
+I (..\FWLIB\inc\stm32f4xx_cryp.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_hash.h)(0x67C8461F)
+I (..\FWLIB\inc\stm32f4xx_rng.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_can.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dac.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dcmi.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_fsmc.h)(0x67C8461F)
+F (..\FWLIB\src\stm32f4xx_syscfg.c)(0x67C84636)(-c --cpu Cortex-M4.fp.sp -g -O0 --apcs=interwork --split_sections -I ..\CORE -I ..\SYSTEM\delay -I ..\SYSTEM\sys -I ..\SYSTEM\usart -I ..\USER -I ..\HARDWARE\LED -I ..\FWLIB\inc -I ..\FreeRTOS\include -I ..\FreeRTOS\portable\RVDS\ARM_CM4F -I ..\BALANCE -I ..\HARDWARE -I ..\HARDWARE\MPU6050

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Drivers\CMSIS\Device\ST\STM32F4xx\Include

-ID:\Keil_v5\ARM\CMSIS\Include

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Device\Include

-D__UVISION_VERSION="531" -DSTM32F407xx -DSTM32F40_41xxx -DUSE_STDPERIPH_DRIVER -D__FPU_PRESENT="1" -D__TARGET_FPU_VFP -DARM_MATH_CM4 -D__CC_ARM --C99

-o ..\obj\stm32f4xx_syscfg.o --omf_browse ..\obj\stm32f4xx_syscfg.crf --depend ..\obj\stm32f4xx_syscfg.d)
+I (..\FWLIB\inc\stm32f4xx_syscfg.h)(0x67C84625)
+I (..\USER\stm32f4xx.h)(0x67C84611)
+I (..\CORE\core_cm4.h)(0x67C84524)
+I (D:\Keil_v5\ARM\ARMCC\include\stdint.h)(0x5EC775FC)
+I (..\CORE\core_cmInstr.h)(0x67C84526)
+I (..\CORE\core_cmFunc.h)(0x67C84526)
+I (..\CORE\core_cm4_simd.h)(0x67C84526)
+I (..\USER\system_stm32f4xx.h)(0x67C84610)
+I (..\CORE\arm_math.h)(0x67C84525)
+I (D:\Keil_v5\ARM\ARMCC\include\string.h)(0x5EC77604)
+I (D:\Keil_v5\ARM\ARMCC\include\math.h)(0x5EC77604)
+I (..\USER\stm32f4xx_conf.h)(0x67C8460F)
+I (..\FWLIB\inc\stm32f4xx_adc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_crc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dbgmcu.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dma.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_exti.h)(0x67C8461C)
+I (..\FWLIB\inc\stm32f4xx_flash.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_gpio.h)(0x67C8461E)
+I (..\FWLIB\inc\stm32f4xx_i2c.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_iwdg.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_pwr.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_rcc.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_rtc.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_sdio.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_spi.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_tim.h)(0x67C84627)
+I (..\FWLIB\inc\stm32f4xx_usart.h)(0x67C84626)
+I (..\FWLIB\inc\stm32f4xx_wwdg.h)(0x67C84626)
+I (..\FWLIB\inc\misc.h)(0x67C84618)
+I (..\FWLIB\inc\stm32f4xx_cryp.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_hash.h)(0x67C8461F)
+I (..\FWLIB\inc\stm32f4xx_rng.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_can.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dac.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dcmi.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_fsmc.h)(0x67C8461F)
+F (..\FWLIB\src\stm32f4xx_usart.c)(0x67C84639)(-c --cpu Cortex-M4.fp.sp -g -O0 --apcs=interwork --split_sections -I ..\CORE -I ..\SYSTEM\delay -I ..\SYSTEM\sys -I ..\SYSTEM\usart -I ..\USER -I ..\HARDWARE\LED -I ..\FWLIB\inc -I ..\FreeRTOS\include -I ..\FreeRTOS\portable\RVDS\ARM_CM4F -I ..\BALANCE -I ..\HARDWARE -I ..\HARDWARE\MPU6050

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Drivers\CMSIS\Device\ST\STM32F4xx\Include

-ID:\Keil_v5\ARM\CMSIS\Include

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Device\Include

-D__UVISION_VERSION="531" -DSTM32F407xx -DSTM32F40_41xxx -DUSE_STDPERIPH_DRIVER -D__FPU_PRESENT="1" -D__TARGET_FPU_VFP -DARM_MATH_CM4 -D__CC_ARM --C99

-o ..\obj\stm32f4xx_usart.o --omf_browse ..\obj\stm32f4xx_usart.crf --depend ..\obj\stm32f4xx_usart.d)
+I (..\FWLIB\inc\stm32f4xx_usart.h)(0x67C84626)
+I (..\USER\stm32f4xx.h)(0x67C84611)
+I (..\CORE\core_cm4.h)(0x67C84524)
+I (D:\Keil_v5\ARM\ARMCC\include\stdint.h)(0x5EC775FC)
+I (..\CORE\core_cmInstr.h)(0x67C84526)
+I (..\CORE\core_cmFunc.h)(0x67C84526)
+I (..\CORE\core_cm4_simd.h)(0x67C84526)
+I (..\USER\system_stm32f4xx.h)(0x67C84610)
+I (..\CORE\arm_math.h)(0x67C84525)
+I (D:\Keil_v5\ARM\ARMCC\include\string.h)(0x5EC77604)
+I (D:\Keil_v5\ARM\ARMCC\include\math.h)(0x5EC77604)
+I (..\USER\stm32f4xx_conf.h)(0x67C8460F)
+I (..\FWLIB\inc\stm32f4xx_adc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_crc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dbgmcu.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dma.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_exti.h)(0x67C8461C)
+I (..\FWLIB\inc\stm32f4xx_flash.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_gpio.h)(0x67C8461E)
+I (..\FWLIB\inc\stm32f4xx_i2c.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_iwdg.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_pwr.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_rcc.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_rtc.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_sdio.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_spi.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_syscfg.h)(0x67C84625)
+I (..\FWLIB\inc\stm32f4xx_tim.h)(0x67C84627)
+I (..\FWLIB\inc\stm32f4xx_wwdg.h)(0x67C84626)
+I (..\FWLIB\inc\misc.h)(0x67C84618)
+I (..\FWLIB\inc\stm32f4xx_cryp.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_hash.h)(0x67C8461F)
+I (..\FWLIB\inc\stm32f4xx_rng.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_can.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dac.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dcmi.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_fsmc.h)(0x67C8461F)
+F (..\FWLIB\src\stm32f4xx_adc.c)(0x67C84628)(-c --cpu Cortex-M4.fp.sp -g -O0 --apcs=interwork --split_sections -I ..\CORE -I ..\SYSTEM\delay -I ..\SYSTEM\sys -I ..\SYSTEM\usart -I ..\USER -I ..\HARDWARE\LED -I ..\FWLIB\inc -I ..\FreeRTOS\include -I ..\FreeRTOS\portable\RVDS\ARM_CM4F -I ..\BALANCE -I ..\HARDWARE -I ..\HARDWARE\MPU6050

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Drivers\CMSIS\Device\ST\STM32F4xx\Include

-ID:\Keil_v5\ARM\CMSIS\Include

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Device\Include

-D__UVISION_VERSION="531" -DSTM32F407xx -DSTM32F40_41xxx -DUSE_STDPERIPH_DRIVER -D__FPU_PRESENT="1" -D__TARGET_FPU_VFP -DARM_MATH_CM4 -D__CC_ARM --C99

-o ..\obj\stm32f4xx_adc.o --omf_browse ..\obj\stm32f4xx_adc.crf --depend ..\obj\stm32f4xx_adc.d)
+I (..\FWLIB\inc\stm32f4xx_adc.h)(0x67C8461A)
+I (..\USER\stm32f4xx.h)(0x67C84611)
+I (..\CORE\core_cm4.h)(0x67C84524)
+I (D:\Keil_v5\ARM\ARMCC\include\stdint.h)(0x5EC775FC)
+I (..\CORE\core_cmInstr.h)(0x67C84526)
+I (..\CORE\core_cmFunc.h)(0x67C84526)
+I (..\CORE\core_cm4_simd.h)(0x67C84526)
+I (..\USER\system_stm32f4xx.h)(0x67C84610)
+I (..\CORE\arm_math.h)(0x67C84525)
+I (D:\Keil_v5\ARM\ARMCC\include\string.h)(0x5EC77604)
+I (D:\Keil_v5\ARM\ARMCC\include\math.h)(0x5EC77604)
+I (..\USER\stm32f4xx_conf.h)(0x67C8460F)
+I (..\FWLIB\inc\stm32f4xx_crc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dbgmcu.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dma.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_exti.h)(0x67C8461C)
+I (..\FWLIB\inc\stm32f4xx_flash.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_gpio.h)(0x67C8461E)
+I (..\FWLIB\inc\stm32f4xx_i2c.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_iwdg.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_pwr.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_rcc.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_rtc.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_sdio.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_spi.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_syscfg.h)(0x67C84625)
+I (..\FWLIB\inc\stm32f4xx_tim.h)(0x67C84627)
+I (..\FWLIB\inc\stm32f4xx_usart.h)(0x67C84626)
+I (..\FWLIB\inc\stm32f4xx_wwdg.h)(0x67C84626)
+I (..\FWLIB\inc\misc.h)(0x67C84618)
+I (..\FWLIB\inc\stm32f4xx_cryp.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_hash.h)(0x67C8461F)
+I (..\FWLIB\inc\stm32f4xx_rng.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_can.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dac.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dcmi.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_fsmc.h)(0x67C8461F)
+F (..\FWLIB\src\stm32f4xx_can.c)(0x67C84628)(-c --cpu Cortex-M4.fp.sp -g -O0 --apcs=interwork --split_sections -I ..\CORE -I ..\SYSTEM\delay -I ..\SYSTEM\sys -I ..\SYSTEM\usart -I ..\USER -I ..\HARDWARE\LED -I ..\FWLIB\inc -I ..\FreeRTOS\include -I ..\FreeRTOS\portable\RVDS\ARM_CM4F -I ..\BALANCE -I ..\HARDWARE -I ..\HARDWARE\MPU6050

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Drivers\CMSIS\Device\ST\STM32F4xx\Include

-ID:\Keil_v5\ARM\CMSIS\Include

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Device\Include

-D__UVISION_VERSION="531" -DSTM32F407xx -DSTM32F40_41xxx -DUSE_STDPERIPH_DRIVER -D__FPU_PRESENT="1" -D__TARGET_FPU_VFP -DARM_MATH_CM4 -D__CC_ARM --C99

-o ..\obj\stm32f4xx_can.o --omf_browse ..\obj\stm32f4xx_can.crf --depend ..\obj\stm32f4xx_can.d)
+I (..\FWLIB\inc\stm32f4xx_can.h)(0x67C8461A)
+I (..\USER\stm32f4xx.h)(0x67C84611)
+I (..\CORE\core_cm4.h)(0x67C84524)
+I (D:\Keil_v5\ARM\ARMCC\include\stdint.h)(0x5EC775FC)
+I (..\CORE\core_cmInstr.h)(0x67C84526)
+I (..\CORE\core_cmFunc.h)(0x67C84526)
+I (..\CORE\core_cm4_simd.h)(0x67C84526)
+I (..\USER\system_stm32f4xx.h)(0x67C84610)
+I (..\CORE\arm_math.h)(0x67C84525)
+I (D:\Keil_v5\ARM\ARMCC\include\string.h)(0x5EC77604)
+I (D:\Keil_v5\ARM\ARMCC\include\math.h)(0x5EC77604)
+I (..\USER\stm32f4xx_conf.h)(0x67C8460F)
+I (..\FWLIB\inc\stm32f4xx_adc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_crc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dbgmcu.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dma.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_exti.h)(0x67C8461C)
+I (..\FWLIB\inc\stm32f4xx_flash.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_gpio.h)(0x67C8461E)
+I (..\FWLIB\inc\stm32f4xx_i2c.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_iwdg.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_pwr.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_rcc.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_rtc.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_sdio.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_spi.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_syscfg.h)(0x67C84625)
+I (..\FWLIB\inc\stm32f4xx_tim.h)(0x67C84627)
+I (..\FWLIB\inc\stm32f4xx_usart.h)(0x67C84626)
+I (..\FWLIB\inc\stm32f4xx_wwdg.h)(0x67C84626)
+I (..\FWLIB\inc\misc.h)(0x67C84618)
+I (..\FWLIB\inc\stm32f4xx_cryp.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_hash.h)(0x67C8461F)
+I (..\FWLIB\inc\stm32f4xx_rng.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_dac.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dcmi.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_fsmc.h)(0x67C8461F)
+F (..\FWLIB\src\stm32f4xx_tim.c)(0x67C84639)(-c --cpu Cortex-M4.fp.sp -g -O0 --apcs=interwork --split_sections -I ..\CORE -I ..\SYSTEM\delay -I ..\SYSTEM\sys -I ..\SYSTEM\usart -I ..\USER -I ..\HARDWARE\LED -I ..\FWLIB\inc -I ..\FreeRTOS\include -I ..\FreeRTOS\portable\RVDS\ARM_CM4F -I ..\BALANCE -I ..\HARDWARE -I ..\HARDWARE\MPU6050

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Drivers\CMSIS\Device\ST\STM32F4xx\Include

-ID:\Keil_v5\ARM\CMSIS\Include

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Device\Include

-D__UVISION_VERSION="531" -DSTM32F407xx -DSTM32F40_41xxx -DUSE_STDPERIPH_DRIVER -D__FPU_PRESENT="1" -D__TARGET_FPU_VFP -DARM_MATH_CM4 -D__CC_ARM --C99

-o ..\obj\stm32f4xx_tim.o --omf_browse ..\obj\stm32f4xx_tim.crf --depend ..\obj\stm32f4xx_tim.d)
+I (..\FWLIB\inc\stm32f4xx_tim.h)(0x67C84627)
+I (..\USER\stm32f4xx.h)(0x67C84611)
+I (..\CORE\core_cm4.h)(0x67C84524)
+I (D:\Keil_v5\ARM\ARMCC\include\stdint.h)(0x5EC775FC)
+I (..\CORE\core_cmInstr.h)(0x67C84526)
+I (..\CORE\core_cmFunc.h)(0x67C84526)
+I (..\CORE\core_cm4_simd.h)(0x67C84526)
+I (..\USER\system_stm32f4xx.h)(0x67C84610)
+I (..\CORE\arm_math.h)(0x67C84525)
+I (D:\Keil_v5\ARM\ARMCC\include\string.h)(0x5EC77604)
+I (D:\Keil_v5\ARM\ARMCC\include\math.h)(0x5EC77604)
+I (..\USER\stm32f4xx_conf.h)(0x67C8460F)
+I (..\FWLIB\inc\stm32f4xx_adc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_crc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dbgmcu.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dma.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_exti.h)(0x67C8461C)
+I (..\FWLIB\inc\stm32f4xx_flash.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_gpio.h)(0x67C8461E)
+I (..\FWLIB\inc\stm32f4xx_i2c.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_iwdg.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_pwr.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_rcc.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_rtc.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_sdio.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_spi.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_syscfg.h)(0x67C84625)
+I (..\FWLIB\inc\stm32f4xx_usart.h)(0x67C84626)
+I (..\FWLIB\inc\stm32f4xx_wwdg.h)(0x67C84626)
+I (..\FWLIB\inc\misc.h)(0x67C84618)
+I (..\FWLIB\inc\stm32f4xx_cryp.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_hash.h)(0x67C8461F)
+I (..\FWLIB\inc\stm32f4xx_rng.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_can.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dac.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dcmi.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_fsmc.h)(0x67C8461F)
+F (..\FWLIB\src\stm32f4xx_pwr.c)(0x67C84633)(-c --cpu Cortex-M4.fp.sp -g -O0 --apcs=interwork --split_sections -I ..\CORE -I ..\SYSTEM\delay -I ..\SYSTEM\sys -I ..\SYSTEM\usart -I ..\USER -I ..\HARDWARE\LED -I ..\FWLIB\inc -I ..\FreeRTOS\include -I ..\FreeRTOS\portable\RVDS\ARM_CM4F -I ..\BALANCE -I ..\HARDWARE -I ..\HARDWARE\MPU6050

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Drivers\CMSIS\Device\ST\STM32F4xx\Include

-ID:\Keil_v5\ARM\CMSIS\Include

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Device\Include

-D__UVISION_VERSION="531" -DSTM32F407xx -DSTM32F40_41xxx -DUSE_STDPERIPH_DRIVER -D__FPU_PRESENT="1" -D__TARGET_FPU_VFP -DARM_MATH_CM4 -D__CC_ARM --C99

-o ..\obj\stm32f4xx_pwr.o --omf_browse ..\obj\stm32f4xx_pwr.crf --depend ..\obj\stm32f4xx_pwr.d)
+I (..\FWLIB\inc\stm32f4xx_pwr.h)(0x67C84621)
+I (..\USER\stm32f4xx.h)(0x67C84611)
+I (..\CORE\core_cm4.h)(0x67C84524)
+I (D:\Keil_v5\ARM\ARMCC\include\stdint.h)(0x5EC775FC)
+I (..\CORE\core_cmInstr.h)(0x67C84526)
+I (..\CORE\core_cmFunc.h)(0x67C84526)
+I (..\CORE\core_cm4_simd.h)(0x67C84526)
+I (..\USER\system_stm32f4xx.h)(0x67C84610)
+I (..\CORE\arm_math.h)(0x67C84525)
+I (D:\Keil_v5\ARM\ARMCC\include\string.h)(0x5EC77604)
+I (D:\Keil_v5\ARM\ARMCC\include\math.h)(0x5EC77604)
+I (..\USER\stm32f4xx_conf.h)(0x67C8460F)
+I (..\FWLIB\inc\stm32f4xx_adc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_crc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dbgmcu.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dma.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_exti.h)(0x67C8461C)
+I (..\FWLIB\inc\stm32f4xx_flash.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_gpio.h)(0x67C8461E)
+I (..\FWLIB\inc\stm32f4xx_i2c.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_iwdg.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_rcc.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_rtc.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_sdio.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_spi.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_syscfg.h)(0x67C84625)
+I (..\FWLIB\inc\stm32f4xx_tim.h)(0x67C84627)
+I (..\FWLIB\inc\stm32f4xx_usart.h)(0x67C84626)
+I (..\FWLIB\inc\stm32f4xx_wwdg.h)(0x67C84626)
+I (..\FWLIB\inc\misc.h)(0x67C84618)
+I (..\FWLIB\inc\stm32f4xx_cryp.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_hash.h)(0x67C8461F)
+I (..\FWLIB\inc\stm32f4xx_rng.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_can.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dac.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dcmi.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_fsmc.h)(0x67C8461F)
+F (..\FreeRTOS\croutine.c)(0x67C84536)(-c --cpu Cortex-M4.fp.sp -g -O0 --apcs=interwork --split_sections -I ..\CORE -I ..\SYSTEM\delay -I ..\SYSTEM\sys -I ..\SYSTEM\usart -I ..\USER -I ..\HARDWARE\LED -I ..\FWLIB\inc -I ..\FreeRTOS\include -I ..\FreeRTOS\portable\RVDS\ARM_CM4F -I ..\BALANCE -I ..\HARDWARE -I ..\HARDWARE\MPU6050

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Drivers\CMSIS\Device\ST\STM32F4xx\Include

-ID:\Keil_v5\ARM\CMSIS\Include

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Device\Include

-D__UVISION_VERSION="531" -DSTM32F407xx -DSTM32F40_41xxx -DUSE_STDPERIPH_DRIVER -D__FPU_PRESENT="1" -D__TARGET_FPU_VFP -DARM_MATH_CM4 -D__CC_ARM --C99

-o ..\obj\croutine.o --omf_browse ..\obj\croutine.crf --depend ..\obj\croutine.d)
+I (..\FreeRTOS\include\FreeRTOS.h)(0x67C84614)
+I (D:\Keil_v5\ARM\ARMCC\include\stddef.h)(0x5EC775FC)
+I (D:\Keil_v5\ARM\ARMCC\include\stdint.h)(0x5EC775FC)
+I (..\FreeRTOS\include\FreeRTOSConfig.h)(0x67C84613)
+I (..\SYSTEM\sys\sys.h)(0x67C8463C)
+I (..\USER\stm32f4xx.h)(0x67C84611)
+I (..\CORE\core_cm4.h)(0x67C84524)
+I (..\CORE\core_cmInstr.h)(0x67C84526)
+I (..\CORE\core_cmFunc.h)(0x67C84526)
+I (..\CORE\core_cm4_simd.h)(0x67C84526)
+I (..\USER\system_stm32f4xx.h)(0x67C84610)
+I (..\CORE\arm_math.h)(0x67C84525)
+I (D:\Keil_v5\ARM\ARMCC\include\string.h)(0x5EC77604)
+I (D:\Keil_v5\ARM\ARMCC\include\math.h)(0x5EC77604)
+I (..\USER\stm32f4xx_conf.h)(0x67C8460F)
+I (..\FWLIB\inc\stm32f4xx_adc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_crc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dbgmcu.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dma.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_exti.h)(0x67C8461C)
+I (..\FWLIB\inc\stm32f4xx_flash.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_gpio.h)(0x67C8461E)
+I (..\FWLIB\inc\stm32f4xx_i2c.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_iwdg.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_pwr.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_rcc.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_rtc.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_sdio.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_spi.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_syscfg.h)(0x67C84625)
+I (..\FWLIB\inc\stm32f4xx_tim.h)(0x67C84627)
+I (..\FWLIB\inc\stm32f4xx_usart.h)(0x67C84626)
+I (..\FWLIB\inc\stm32f4xx_wwdg.h)(0x67C84626)
+I (..\FWLIB\inc\misc.h)(0x67C84618)
+I (..\FWLIB\inc\stm32f4xx_cryp.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_hash.h)(0x67C8461F)
+I (..\FWLIB\inc\stm32f4xx_rng.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_can.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dac.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dcmi.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_fsmc.h)(0x67C8461F)
+I (..\SYSTEM\usart\usart.h)(0x67C8463C)
+I (D:\Keil_v5\ARM\ARMCC\include\stdio.h)(0x5EC775FC)
+I (..\FreeRTOS\include\projdefs.h)(0x67C84615)
+I (..\FreeRTOS\include\portable.h)(0x67C84615)
+I (..\FreeRTOS\include\deprecated_definitions.h)(0x67C84612)
+I (..\FreeRTOS\portable\RVDS\ARM_CM4F\portmacro.h)(0x67C84645)
+I (..\FreeRTOS\include\mpu_wrappers.h)(0x67C84614)
+I (..\FreeRTOS\include\task.h)(0x67C84619)
+I (..\FreeRTOS\include\list.h)(0x67C84613)
+I (..\FreeRTOS\include\croutine.h)(0x67C84611)
+F (..\FreeRTOS\event_groups.c)(0x67C84530)(-c --cpu Cortex-M4.fp.sp -g -O0 --apcs=interwork --split_sections -I ..\CORE -I ..\SYSTEM\delay -I ..\SYSTEM\sys -I ..\SYSTEM\usart -I ..\USER -I ..\HARDWARE\LED -I ..\FWLIB\inc -I ..\FreeRTOS\include -I ..\FreeRTOS\portable\RVDS\ARM_CM4F -I ..\BALANCE -I ..\HARDWARE -I ..\HARDWARE\MPU6050

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Drivers\CMSIS\Device\ST\STM32F4xx\Include

-ID:\Keil_v5\ARM\CMSIS\Include

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Device\Include

-D__UVISION_VERSION="531" -DSTM32F407xx -DSTM32F40_41xxx -DUSE_STDPERIPH_DRIVER -D__FPU_PRESENT="1" -D__TARGET_FPU_VFP -DARM_MATH_CM4 -D__CC_ARM --C99

-o ..\obj\event_groups.o --omf_browse ..\obj\event_groups.crf --depend ..\obj\event_groups.d)
+I (D:\Keil_v5\ARM\ARMCC\include\stdlib.h)(0x5EC775FC)
+I (..\FreeRTOS\include\FreeRTOS.h)(0x67C84614)
+I (D:\Keil_v5\ARM\ARMCC\include\stddef.h)(0x5EC775FC)
+I (D:\Keil_v5\ARM\ARMCC\include\stdint.h)(0x5EC775FC)
+I (..\FreeRTOS\include\FreeRTOSConfig.h)(0x67C84613)
+I (..\SYSTEM\sys\sys.h)(0x67C8463C)
+I (..\USER\stm32f4xx.h)(0x67C84611)
+I (..\CORE\core_cm4.h)(0x67C84524)
+I (..\CORE\core_cmInstr.h)(0x67C84526)
+I (..\CORE\core_cmFunc.h)(0x67C84526)
+I (..\CORE\core_cm4_simd.h)(0x67C84526)
+I (..\USER\system_stm32f4xx.h)(0x67C84610)
+I (..\CORE\arm_math.h)(0x67C84525)
+I (D:\Keil_v5\ARM\ARMCC\include\string.h)(0x5EC77604)
+I (D:\Keil_v5\ARM\ARMCC\include\math.h)(0x5EC77604)
+I (..\USER\stm32f4xx_conf.h)(0x67C8460F)
+I (..\FWLIB\inc\stm32f4xx_adc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_crc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dbgmcu.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dma.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_exti.h)(0x67C8461C)
+I (..\FWLIB\inc\stm32f4xx_flash.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_gpio.h)(0x67C8461E)
+I (..\FWLIB\inc\stm32f4xx_i2c.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_iwdg.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_pwr.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_rcc.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_rtc.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_sdio.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_spi.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_syscfg.h)(0x67C84625)
+I (..\FWLIB\inc\stm32f4xx_tim.h)(0x67C84627)
+I (..\FWLIB\inc\stm32f4xx_usart.h)(0x67C84626)
+I (..\FWLIB\inc\stm32f4xx_wwdg.h)(0x67C84626)
+I (..\FWLIB\inc\misc.h)(0x67C84618)
+I (..\FWLIB\inc\stm32f4xx_cryp.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_hash.h)(0x67C8461F)
+I (..\FWLIB\inc\stm32f4xx_rng.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_can.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dac.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dcmi.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_fsmc.h)(0x67C8461F)
+I (..\SYSTEM\usart\usart.h)(0x67C8463C)
+I (D:\Keil_v5\ARM\ARMCC\include\stdio.h)(0x5EC775FC)
+I (..\FreeRTOS\include\projdefs.h)(0x67C84615)
+I (..\FreeRTOS\include\portable.h)(0x67C84615)
+I (..\FreeRTOS\include\deprecated_definitions.h)(0x67C84612)
+I (..\FreeRTOS\portable\RVDS\ARM_CM4F\portmacro.h)(0x67C84645)
+I (..\FreeRTOS\include\mpu_wrappers.h)(0x67C84614)
+I (..\FreeRTOS\include\task.h)(0x67C84619)
+I (..\FreeRTOS\include\list.h)(0x67C84613)
+I (..\FreeRTOS\include\timers.h)(0x67C84618)
+I (..\FreeRTOS\include\event_groups.h)(0x67C84612)
+F (..\FreeRTOS\list.c)(0x67C84533)(-c --cpu Cortex-M4.fp.sp -g -O0 --apcs=interwork --split_sections -I ..\CORE -I ..\SYSTEM\delay -I ..\SYSTEM\sys -I ..\SYSTEM\usart -I ..\USER -I ..\HARDWARE\LED -I ..\FWLIB\inc -I ..\FreeRTOS\include -I ..\FreeRTOS\portable\RVDS\ARM_CM4F -I ..\BALANCE -I ..\HARDWARE -I ..\HARDWARE\MPU6050

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Drivers\CMSIS\Device\ST\STM32F4xx\Include

-ID:\Keil_v5\ARM\CMSIS\Include

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Device\Include

-D__UVISION_VERSION="531" -DSTM32F407xx -DSTM32F40_41xxx -DUSE_STDPERIPH_DRIVER -D__FPU_PRESENT="1" -D__TARGET_FPU_VFP -DARM_MATH_CM4 -D__CC_ARM --C99

-o ..\obj\list.o --omf_browse ..\obj\list.crf --depend ..\obj\list.d)
+I (D:\Keil_v5\ARM\ARMCC\include\stdlib.h)(0x5EC775FC)
+I (..\FreeRTOS\include\FreeRTOS.h)(0x67C84614)
+I (D:\Keil_v5\ARM\ARMCC\include\stddef.h)(0x5EC775FC)
+I (D:\Keil_v5\ARM\ARMCC\include\stdint.h)(0x5EC775FC)
+I (..\FreeRTOS\include\FreeRTOSConfig.h)(0x67C84613)
+I (..\SYSTEM\sys\sys.h)(0x67C8463C)
+I (..\USER\stm32f4xx.h)(0x67C84611)
+I (..\CORE\core_cm4.h)(0x67C84524)
+I (..\CORE\core_cmInstr.h)(0x67C84526)
+I (..\CORE\core_cmFunc.h)(0x67C84526)
+I (..\CORE\core_cm4_simd.h)(0x67C84526)
+I (..\USER\system_stm32f4xx.h)(0x67C84610)
+I (..\CORE\arm_math.h)(0x67C84525)
+I (D:\Keil_v5\ARM\ARMCC\include\string.h)(0x5EC77604)
+I (D:\Keil_v5\ARM\ARMCC\include\math.h)(0x5EC77604)
+I (..\USER\stm32f4xx_conf.h)(0x67C8460F)
+I (..\FWLIB\inc\stm32f4xx_adc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_crc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dbgmcu.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dma.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_exti.h)(0x67C8461C)
+I (..\FWLIB\inc\stm32f4xx_flash.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_gpio.h)(0x67C8461E)
+I (..\FWLIB\inc\stm32f4xx_i2c.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_iwdg.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_pwr.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_rcc.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_rtc.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_sdio.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_spi.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_syscfg.h)(0x67C84625)
+I (..\FWLIB\inc\stm32f4xx_tim.h)(0x67C84627)
+I (..\FWLIB\inc\stm32f4xx_usart.h)(0x67C84626)
+I (..\FWLIB\inc\stm32f4xx_wwdg.h)(0x67C84626)
+I (..\FWLIB\inc\misc.h)(0x67C84618)
+I (..\FWLIB\inc\stm32f4xx_cryp.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_hash.h)(0x67C8461F)
+I (..\FWLIB\inc\stm32f4xx_rng.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_can.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dac.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dcmi.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_fsmc.h)(0x67C8461F)
+I (..\SYSTEM\usart\usart.h)(0x67C8463C)
+I (D:\Keil_v5\ARM\ARMCC\include\stdio.h)(0x5EC775FC)
+I (..\FreeRTOS\include\projdefs.h)(0x67C84615)
+I (..\FreeRTOS\include\portable.h)(0x67C84615)
+I (..\FreeRTOS\include\deprecated_definitions.h)(0x67C84612)
+I (..\FreeRTOS\portable\RVDS\ARM_CM4F\portmacro.h)(0x67C84645)
+I (..\FreeRTOS\include\mpu_wrappers.h)(0x67C84614)
+I (..\FreeRTOS\include\list.h)(0x67C84613)
+F (..\FreeRTOS\queue.c)(0x67C84538)(-c --cpu Cortex-M4.fp.sp -g -O0 --apcs=interwork --split_sections -I ..\CORE -I ..\SYSTEM\delay -I ..\SYSTEM\sys -I ..\SYSTEM\usart -I ..\USER -I ..\HARDWARE\LED -I ..\FWLIB\inc -I ..\FreeRTOS\include -I ..\FreeRTOS\portable\RVDS\ARM_CM4F -I ..\BALANCE -I ..\HARDWARE -I ..\HARDWARE\MPU6050

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Drivers\CMSIS\Device\ST\STM32F4xx\Include

-ID:\Keil_v5\ARM\CMSIS\Include

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Device\Include

-D__UVISION_VERSION="531" -DSTM32F407xx -DSTM32F40_41xxx -DUSE_STDPERIPH_DRIVER -D__FPU_PRESENT="1" -D__TARGET_FPU_VFP -DARM_MATH_CM4 -D__CC_ARM --C99

-o ..\obj\queue.o --omf_browse ..\obj\queue.crf --depend ..\obj\queue.d)
+I (D:\Keil_v5\ARM\ARMCC\include\stdlib.h)(0x5EC775FC)
+I (D:\Keil_v5\ARM\ARMCC\include\string.h)(0x5EC77604)
+I (..\FreeRTOS\include\FreeRTOS.h)(0x67C84614)
+I (D:\Keil_v5\ARM\ARMCC\include\stddef.h)(0x5EC775FC)
+I (D:\Keil_v5\ARM\ARMCC\include\stdint.h)(0x5EC775FC)
+I (..\FreeRTOS\include\FreeRTOSConfig.h)(0x67C84613)
+I (..\SYSTEM\sys\sys.h)(0x67C8463C)
+I (..\USER\stm32f4xx.h)(0x67C84611)
+I (..\CORE\core_cm4.h)(0x67C84524)
+I (..\CORE\core_cmInstr.h)(0x67C84526)
+I (..\CORE\core_cmFunc.h)(0x67C84526)
+I (..\CORE\core_cm4_simd.h)(0x67C84526)
+I (..\USER\system_stm32f4xx.h)(0x67C84610)
+I (..\CORE\arm_math.h)(0x67C84525)
+I (D:\Keil_v5\ARM\ARMCC\include\math.h)(0x5EC77604)
+I (..\USER\stm32f4xx_conf.h)(0x67C8460F)
+I (..\FWLIB\inc\stm32f4xx_adc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_crc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dbgmcu.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dma.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_exti.h)(0x67C8461C)
+I (..\FWLIB\inc\stm32f4xx_flash.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_gpio.h)(0x67C8461E)
+I (..\FWLIB\inc\stm32f4xx_i2c.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_iwdg.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_pwr.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_rcc.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_rtc.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_sdio.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_spi.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_syscfg.h)(0x67C84625)
+I (..\FWLIB\inc\stm32f4xx_tim.h)(0x67C84627)
+I (..\FWLIB\inc\stm32f4xx_usart.h)(0x67C84626)
+I (..\FWLIB\inc\stm32f4xx_wwdg.h)(0x67C84626)
+I (..\FWLIB\inc\misc.h)(0x67C84618)
+I (..\FWLIB\inc\stm32f4xx_cryp.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_hash.h)(0x67C8461F)
+I (..\FWLIB\inc\stm32f4xx_rng.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_can.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dac.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dcmi.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_fsmc.h)(0x67C8461F)
+I (..\SYSTEM\usart\usart.h)(0x67C8463C)
+I (D:\Keil_v5\ARM\ARMCC\include\stdio.h)(0x5EC775FC)
+I (..\FreeRTOS\include\projdefs.h)(0x67C84615)
+I (..\FreeRTOS\include\portable.h)(0x67C84615)
+I (..\FreeRTOS\include\deprecated_definitions.h)(0x67C84612)
+I (..\FreeRTOS\portable\RVDS\ARM_CM4F\portmacro.h)(0x67C84645)
+I (..\FreeRTOS\include\mpu_wrappers.h)(0x67C84614)
+I (..\FreeRTOS\include\task.h)(0x67C84619)
+I (..\FreeRTOS\include\list.h)(0x67C84613)
+I (..\FreeRTOS\include\queue.h)(0x67C84617)
+F (..\FreeRTOS\tasks.c)(0x67C8453B)(-c --cpu Cortex-M4.fp.sp -g -O0 --apcs=interwork --split_sections -I ..\CORE -I ..\SYSTEM\delay -I ..\SYSTEM\sys -I ..\SYSTEM\usart -I ..\USER -I ..\HARDWARE\LED -I ..\FWLIB\inc -I ..\FreeRTOS\include -I ..\FreeRTOS\portable\RVDS\ARM_CM4F -I ..\BALANCE -I ..\HARDWARE -I ..\HARDWARE\MPU6050

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Drivers\CMSIS\Device\ST\STM32F4xx\Include

-ID:\Keil_v5\ARM\CMSIS\Include

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Device\Include

-D__UVISION_VERSION="531" -DSTM32F407xx -DSTM32F40_41xxx -DUSE_STDPERIPH_DRIVER -D__FPU_PRESENT="1" -D__TARGET_FPU_VFP -DARM_MATH_CM4 -D__CC_ARM --C99

-o ..\obj\tasks.o --omf_browse ..\obj\tasks.crf --depend ..\obj\tasks.d)
+I (D:\Keil_v5\ARM\ARMCC\include\stdlib.h)(0x5EC775FC)
+I (D:\Keil_v5\ARM\ARMCC\include\string.h)(0x5EC77604)
+I (..\FreeRTOS\include\FreeRTOS.h)(0x67C84614)
+I (D:\Keil_v5\ARM\ARMCC\include\stddef.h)(0x5EC775FC)
+I (D:\Keil_v5\ARM\ARMCC\include\stdint.h)(0x5EC775FC)
+I (..\FreeRTOS\include\FreeRTOSConfig.h)(0x67C84613)
+I (..\SYSTEM\sys\sys.h)(0x67C8463C)
+I (..\USER\stm32f4xx.h)(0x67C84611)
+I (..\CORE\core_cm4.h)(0x67C84524)
+I (..\CORE\core_cmInstr.h)(0x67C84526)
+I (..\CORE\core_cmFunc.h)(0x67C84526)
+I (..\CORE\core_cm4_simd.h)(0x67C84526)
+I (..\USER\system_stm32f4xx.h)(0x67C84610)
+I (..\CORE\arm_math.h)(0x67C84525)
+I (D:\Keil_v5\ARM\ARMCC\include\math.h)(0x5EC77604)
+I (..\USER\stm32f4xx_conf.h)(0x67C8460F)
+I (..\FWLIB\inc\stm32f4xx_adc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_crc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dbgmcu.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dma.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_exti.h)(0x67C8461C)
+I (..\FWLIB\inc\stm32f4xx_flash.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_gpio.h)(0x67C8461E)
+I (..\FWLIB\inc\stm32f4xx_i2c.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_iwdg.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_pwr.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_rcc.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_rtc.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_sdio.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_spi.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_syscfg.h)(0x67C84625)
+I (..\FWLIB\inc\stm32f4xx_tim.h)(0x67C84627)
+I (..\FWLIB\inc\stm32f4xx_usart.h)(0x67C84626)
+I (..\FWLIB\inc\stm32f4xx_wwdg.h)(0x67C84626)
+I (..\FWLIB\inc\misc.h)(0x67C84618)
+I (..\FWLIB\inc\stm32f4xx_cryp.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_hash.h)(0x67C8461F)
+I (..\FWLIB\inc\stm32f4xx_rng.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_can.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dac.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dcmi.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_fsmc.h)(0x67C8461F)
+I (..\SYSTEM\usart\usart.h)(0x67C8463C)
+I (D:\Keil_v5\ARM\ARMCC\include\stdio.h)(0x5EC775FC)
+I (..\FreeRTOS\include\projdefs.h)(0x67C84615)
+I (..\FreeRTOS\include\portable.h)(0x67C84615)
+I (..\FreeRTOS\include\deprecated_definitions.h)(0x67C84612)
+I (..\FreeRTOS\portable\RVDS\ARM_CM4F\portmacro.h)(0x67C84645)
+I (..\FreeRTOS\include\mpu_wrappers.h)(0x67C84614)
+I (..\FreeRTOS\include\task.h)(0x67C84619)
+I (..\FreeRTOS\include\list.h)(0x67C84613)
+I (..\FreeRTOS\include\timers.h)(0x67C84618)
+I (..\FreeRTOS\include\StackMacros.h)(0x67C84616)
+F (..\FreeRTOS\timers.c)(0x67C8453D)(-c --cpu Cortex-M4.fp.sp -g -O0 --apcs=interwork --split_sections -I ..\CORE -I ..\SYSTEM\delay -I ..\SYSTEM\sys -I ..\SYSTEM\usart -I ..\USER -I ..\HARDWARE\LED -I ..\FWLIB\inc -I ..\FreeRTOS\include -I ..\FreeRTOS\portable\RVDS\ARM_CM4F -I ..\BALANCE -I ..\HARDWARE -I ..\HARDWARE\MPU6050

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Drivers\CMSIS\Device\ST\STM32F4xx\Include

-ID:\Keil_v5\ARM\CMSIS\Include

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Device\Include

-D__UVISION_VERSION="531" -DSTM32F407xx -DSTM32F40_41xxx -DUSE_STDPERIPH_DRIVER -D__FPU_PRESENT="1" -D__TARGET_FPU_VFP -DARM_MATH_CM4 -D__CC_ARM --C99

-o ..\obj\timers.o --omf_browse ..\obj\timers.crf --depend ..\obj\timers.d)
+I (D:\Keil_v5\ARM\ARMCC\include\stdlib.h)(0x5EC775FC)
+I (..\FreeRTOS\include\FreeRTOS.h)(0x67C84614)
+I (D:\Keil_v5\ARM\ARMCC\include\stddef.h)(0x5EC775FC)
+I (D:\Keil_v5\ARM\ARMCC\include\stdint.h)(0x5EC775FC)
+I (..\FreeRTOS\include\FreeRTOSConfig.h)(0x67C84613)
+I (..\SYSTEM\sys\sys.h)(0x67C8463C)
+I (..\USER\stm32f4xx.h)(0x67C84611)
+I (..\CORE\core_cm4.h)(0x67C84524)
+I (..\CORE\core_cmInstr.h)(0x67C84526)
+I (..\CORE\core_cmFunc.h)(0x67C84526)
+I (..\CORE\core_cm4_simd.h)(0x67C84526)
+I (..\USER\system_stm32f4xx.h)(0x67C84610)
+I (..\CORE\arm_math.h)(0x67C84525)
+I (D:\Keil_v5\ARM\ARMCC\include\string.h)(0x5EC77604)
+I (D:\Keil_v5\ARM\ARMCC\include\math.h)(0x5EC77604)
+I (..\USER\stm32f4xx_conf.h)(0x67C8460F)
+I (..\FWLIB\inc\stm32f4xx_adc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_crc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dbgmcu.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dma.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_exti.h)(0x67C8461C)
+I (..\FWLIB\inc\stm32f4xx_flash.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_gpio.h)(0x67C8461E)
+I (..\FWLIB\inc\stm32f4xx_i2c.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_iwdg.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_pwr.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_rcc.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_rtc.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_sdio.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_spi.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_syscfg.h)(0x67C84625)
+I (..\FWLIB\inc\stm32f4xx_tim.h)(0x67C84627)
+I (..\FWLIB\inc\stm32f4xx_usart.h)(0x67C84626)
+I (..\FWLIB\inc\stm32f4xx_wwdg.h)(0x67C84626)
+I (..\FWLIB\inc\misc.h)(0x67C84618)
+I (..\FWLIB\inc\stm32f4xx_cryp.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_hash.h)(0x67C8461F)
+I (..\FWLIB\inc\stm32f4xx_rng.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_can.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dac.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dcmi.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_fsmc.h)(0x67C8461F)
+I (..\SYSTEM\usart\usart.h)(0x67C8463C)
+I (D:\Keil_v5\ARM\ARMCC\include\stdio.h)(0x5EC775FC)
+I (..\FreeRTOS\include\projdefs.h)(0x67C84615)
+I (..\FreeRTOS\include\portable.h)(0x67C84615)
+I (..\FreeRTOS\include\deprecated_definitions.h)(0x67C84612)
+I (..\FreeRTOS\portable\RVDS\ARM_CM4F\portmacro.h)(0x67C84645)
+I (..\FreeRTOS\include\mpu_wrappers.h)(0x67C84614)
+I (..\FreeRTOS\include\task.h)(0x67C84619)
+I (..\FreeRTOS\include\list.h)(0x67C84613)
+I (..\FreeRTOS\include\queue.h)(0x67C84617)
+I (..\FreeRTOS\include\timers.h)(0x67C84618)
+F (..\FreeRTOS\portable\RVDS\ARM_CM4F\port.c)(0x67C84646)(-c --cpu Cortex-M4.fp.sp -g -O0 --apcs=interwork --split_sections -I ..\CORE -I ..\SYSTEM\delay -I ..\SYSTEM\sys -I ..\SYSTEM\usart -I ..\USER -I ..\HARDWARE\LED -I ..\FWLIB\inc -I ..\FreeRTOS\include -I ..\FreeRTOS\portable\RVDS\ARM_CM4F -I ..\BALANCE -I ..\HARDWARE -I ..\HARDWARE\MPU6050

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Drivers\CMSIS\Device\ST\STM32F4xx\Include

-ID:\Keil_v5\ARM\CMSIS\Include

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Device\Include

-D__UVISION_VERSION="531" -DSTM32F407xx -DSTM32F40_41xxx -DUSE_STDPERIPH_DRIVER -D__FPU_PRESENT="1" -D__TARGET_FPU_VFP -DARM_MATH_CM4 -D__CC_ARM --C99

-o ..\obj\port.o --omf_browse ..\obj\port.crf --depend ..\obj\port.d)
+I (..\FreeRTOS\include\FreeRTOS.h)(0x67C84614)
+I (D:\Keil_v5\ARM\ARMCC\include\stddef.h)(0x5EC775FC)
+I (D:\Keil_v5\ARM\ARMCC\include\stdint.h)(0x5EC775FC)
+I (..\FreeRTOS\include\FreeRTOSConfig.h)(0x67C84613)
+I (..\SYSTEM\sys\sys.h)(0x67C8463C)
+I (..\USER\stm32f4xx.h)(0x67C84611)
+I (..\CORE\core_cm4.h)(0x67C84524)
+I (..\CORE\core_cmInstr.h)(0x67C84526)
+I (..\CORE\core_cmFunc.h)(0x67C84526)
+I (..\CORE\core_cm4_simd.h)(0x67C84526)
+I (..\USER\system_stm32f4xx.h)(0x67C84610)
+I (..\CORE\arm_math.h)(0x67C84525)
+I (D:\Keil_v5\ARM\ARMCC\include\string.h)(0x5EC77604)
+I (D:\Keil_v5\ARM\ARMCC\include\math.h)(0x5EC77604)
+I (..\USER\stm32f4xx_conf.h)(0x67C8460F)
+I (..\FWLIB\inc\stm32f4xx_adc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_crc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dbgmcu.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dma.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_exti.h)(0x67C8461C)
+I (..\FWLIB\inc\stm32f4xx_flash.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_gpio.h)(0x67C8461E)
+I (..\FWLIB\inc\stm32f4xx_i2c.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_iwdg.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_pwr.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_rcc.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_rtc.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_sdio.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_spi.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_syscfg.h)(0x67C84625)
+I (..\FWLIB\inc\stm32f4xx_tim.h)(0x67C84627)
+I (..\FWLIB\inc\stm32f4xx_usart.h)(0x67C84626)
+I (..\FWLIB\inc\stm32f4xx_wwdg.h)(0x67C84626)
+I (..\FWLIB\inc\misc.h)(0x67C84618)
+I (..\FWLIB\inc\stm32f4xx_cryp.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_hash.h)(0x67C8461F)
+I (..\FWLIB\inc\stm32f4xx_rng.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_can.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dac.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dcmi.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_fsmc.h)(0x67C8461F)
+I (..\SYSTEM\usart\usart.h)(0x67C8463C)
+I (D:\Keil_v5\ARM\ARMCC\include\stdio.h)(0x5EC775FC)
+I (..\FreeRTOS\include\projdefs.h)(0x67C84615)
+I (..\FreeRTOS\include\portable.h)(0x67C84615)
+I (..\FreeRTOS\include\deprecated_definitions.h)(0x67C84612)
+I (..\FreeRTOS\portable\RVDS\ARM_CM4F\portmacro.h)(0x67C84645)
+I (..\FreeRTOS\include\mpu_wrappers.h)(0x67C84614)
+I (..\FreeRTOS\include\task.h)(0x67C84619)
+I (..\FreeRTOS\include\list.h)(0x67C84613)
+F (..\FreeRTOS\portable\MemMang\heap_4.c)(0x67C8463F)(-c --cpu Cortex-M4.fp.sp -g -O0 --apcs=interwork --split_sections -I ..\CORE -I ..\SYSTEM\delay -I ..\SYSTEM\sys -I ..\SYSTEM\usart -I ..\USER -I ..\HARDWARE\LED -I ..\FWLIB\inc -I ..\FreeRTOS\include -I ..\FreeRTOS\portable\RVDS\ARM_CM4F -I ..\BALANCE -I ..\HARDWARE -I ..\HARDWARE\MPU6050

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Drivers\CMSIS\Device\ST\STM32F4xx\Include

-ID:\Keil_v5\ARM\CMSIS\Include

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Device\Include

-D__UVISION_VERSION="531" -DSTM32F407xx -DSTM32F40_41xxx -DUSE_STDPERIPH_DRIVER -D__FPU_PRESENT="1" -D__TARGET_FPU_VFP -DARM_MATH_CM4 -D__CC_ARM --C99

-o ..\obj\heap_4.o --omf_browse ..\obj\heap_4.crf --depend ..\obj\heap_4.d)
+I (D:\Keil_v5\ARM\ARMCC\include\stdlib.h)(0x5EC775FC)
+I (..\FreeRTOS\include\FreeRTOS.h)(0x67C84614)
+I (D:\Keil_v5\ARM\ARMCC\include\stddef.h)(0x5EC775FC)
+I (D:\Keil_v5\ARM\ARMCC\include\stdint.h)(0x5EC775FC)
+I (..\FreeRTOS\include\FreeRTOSConfig.h)(0x67C84613)
+I (..\SYSTEM\sys\sys.h)(0x67C8463C)
+I (..\USER\stm32f4xx.h)(0x67C84611)
+I (..\CORE\core_cm4.h)(0x67C84524)
+I (..\CORE\core_cmInstr.h)(0x67C84526)
+I (..\CORE\core_cmFunc.h)(0x67C84526)
+I (..\CORE\core_cm4_simd.h)(0x67C84526)
+I (..\USER\system_stm32f4xx.h)(0x67C84610)
+I (..\CORE\arm_math.h)(0x67C84525)
+I (D:\Keil_v5\ARM\ARMCC\include\string.h)(0x5EC77604)
+I (D:\Keil_v5\ARM\ARMCC\include\math.h)(0x5EC77604)
+I (..\USER\stm32f4xx_conf.h)(0x67C8460F)
+I (..\FWLIB\inc\stm32f4xx_adc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_crc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dbgmcu.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dma.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_exti.h)(0x67C8461C)
+I (..\FWLIB\inc\stm32f4xx_flash.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_gpio.h)(0x67C8461E)
+I (..\FWLIB\inc\stm32f4xx_i2c.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_iwdg.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_pwr.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_rcc.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_rtc.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_sdio.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_spi.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_syscfg.h)(0x67C84625)
+I (..\FWLIB\inc\stm32f4xx_tim.h)(0x67C84627)
+I (..\FWLIB\inc\stm32f4xx_usart.h)(0x67C84626)
+I (..\FWLIB\inc\stm32f4xx_wwdg.h)(0x67C84626)
+I (..\FWLIB\inc\misc.h)(0x67C84618)
+I (..\FWLIB\inc\stm32f4xx_cryp.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_hash.h)(0x67C8461F)
+I (..\FWLIB\inc\stm32f4xx_rng.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_can.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dac.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dcmi.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_fsmc.h)(0x67C8461F)
+I (..\SYSTEM\usart\usart.h)(0x67C8463C)
+I (D:\Keil_v5\ARM\ARMCC\include\stdio.h)(0x5EC775FC)
+I (..\FreeRTOS\include\projdefs.h)(0x67C84615)
+I (..\FreeRTOS\include\portable.h)(0x67C84615)
+I (..\FreeRTOS\include\deprecated_definitions.h)(0x67C84612)
+I (..\FreeRTOS\portable\RVDS\ARM_CM4F\portmacro.h)(0x67C84645)
+I (..\FreeRTOS\include\mpu_wrappers.h)(0x67C84614)
+I (..\FreeRTOS\include\task.h)(0x67C84619)
+I (..\FreeRTOS\include\list.h)(0x67C84613)
+F (..\BALANCE\system.c)(0x6842D731)(-c --cpu Cortex-M4.fp.sp -g -O0 --apcs=interwork --split_sections -I ..\CORE -I ..\SYSTEM\delay -I ..\SYSTEM\sys -I ..\SYSTEM\usart -I ..\USER -I ..\HARDWARE\LED -I ..\FWLIB\inc -I ..\FreeRTOS\include -I ..\FreeRTOS\portable\RVDS\ARM_CM4F -I ..\BALANCE -I ..\HARDWARE -I ..\HARDWARE\MPU6050

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Drivers\CMSIS\Device\ST\STM32F4xx\Include

-ID:\Keil_v5\ARM\CMSIS\Include

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Device\Include

-D__UVISION_VERSION="531" -DSTM32F407xx -DSTM32F40_41xxx -DUSE_STDPERIPH_DRIVER -D__FPU_PRESENT="1" -D__TARGET_FPU_VFP -DARM_MATH_CM4 -D__CC_ARM --C99

-o ..\obj\system.o --omf_browse ..\obj\system.crf --depend ..\obj\system.d)
+I (..\BALANCE\system.h)(0x67C844F4)
+I (..\FreeRTOS\include\FreeRTOSConfig.h)(0x67C84613)
+I (..\SYSTEM\sys\sys.h)(0x67C8463C)
+I (..\USER\stm32f4xx.h)(0x67C84611)
+I (..\CORE\core_cm4.h)(0x67C84524)
+I (D:\Keil_v5\ARM\ARMCC\include\stdint.h)(0x5EC775FC)
+I (..\CORE\core_cmInstr.h)(0x67C84526)
+I (..\CORE\core_cmFunc.h)(0x67C84526)
+I (..\CORE\core_cm4_simd.h)(0x67C84526)
+I (..\USER\system_stm32f4xx.h)(0x67C84610)
+I (..\CORE\arm_math.h)(0x67C84525)
+I (D:\Keil_v5\ARM\ARMCC\include\string.h)(0x5EC77604)
+I (D:\Keil_v5\ARM\ARMCC\include\math.h)(0x5EC77604)
+I (..\USER\stm32f4xx_conf.h)(0x67C8460F)
+I (..\FWLIB\inc\stm32f4xx_adc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_crc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dbgmcu.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dma.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_exti.h)(0x67C8461C)
+I (..\FWLIB\inc\stm32f4xx_flash.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_gpio.h)(0x67C8461E)
+I (..\FWLIB\inc\stm32f4xx_i2c.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_iwdg.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_pwr.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_rcc.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_rtc.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_sdio.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_spi.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_syscfg.h)(0x67C84625)
+I (..\FWLIB\inc\stm32f4xx_tim.h)(0x67C84627)
+I (..\FWLIB\inc\stm32f4xx_usart.h)(0x67C84626)
+I (..\FWLIB\inc\stm32f4xx_wwdg.h)(0x67C84626)
+I (..\FWLIB\inc\misc.h)(0x67C84618)
+I (..\FWLIB\inc\stm32f4xx_cryp.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_hash.h)(0x67C8461F)
+I (..\FWLIB\inc\stm32f4xx_rng.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_can.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dac.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dcmi.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_fsmc.h)(0x67C8461F)
+I (..\SYSTEM\usart\usart.h)(0x67C8463C)
+I (D:\Keil_v5\ARM\ARMCC\include\stdio.h)(0x5EC775FC)
+I (..\FreeRTOS\include\FreeRTOS.h)(0x67C84614)
+I (D:\Keil_v5\ARM\ARMCC\include\stddef.h)(0x5EC775FC)
+I (..\FreeRTOS\include\projdefs.h)(0x67C84615)
+I (..\FreeRTOS\include\portable.h)(0x67C84615)
+I (..\FreeRTOS\include\deprecated_definitions.h)(0x67C84612)
+I (..\FreeRTOS\portable\RVDS\ARM_CM4F\portmacro.h)(0x67C84645)
+I (..\FreeRTOS\include\mpu_wrappers.h)(0x67C84614)
+I (..\FreeRTOS\include\task.h)(0x67C84619)
+I (..\FreeRTOS\include\list.h)(0x67C84613)
+I (..\FreeRTOS\include\queue.h)(0x67C84617)
+I (..\FreeRTOS\include\timers.h)(0x67C84618)
+I (..\FreeRTOS\include\semphr.h)(0x67C84617)
+I (..\SYSTEM\delay\delay.h)(0x67C8463B)
+I (..\BALANCE\balance.h)(0x67C844E9)
+I (..\HARDWARE\led.h)(0x67C8454B)
+I (..\HARDWARE\oled.h)(0x67C8454E)
+I (..\HARDWARE\usartx.h)(0x67C84556)
+I (..\HARDWARE\adc.h)(0x67C8453E)
+I (..\HARDWARE\can.h)(0x67C84540)
+I (..\HARDWARE\motor.h)(0x69491826)
+I (..\HARDWARE\timer.h)(0x67C84554)
+I (..\HARDWARE\encoder.h)(0x67C84544)
+I (..\BALANCE\show.h)(0x67C844F2)
+I (..\HARDWARE\pstwo.h)(0x67C84551)
+I (..\HARDWARE\key.h)(0x67C84549)
+I (..\BALANCE\robot_select_init.h)(0x6842B20E)
+I (..\HARDWARE\MPU6050\I2C.h)(0x67C84639)
+I (D:\Keil_v5\ARM\ARMCC\include\stdbool.h)(0x5EC775F6)
+I (..\HARDWARE\MPU6050\MPU6050.h)(0x67C8463A)
+I (D:\Keil_v5\ARM\ARMCC\include\stdlib.h)(0x5EC775FC)
+I (D:\Keil_v5\ARM\ARMCC\include\stdarg.h)(0x5EC775FC)
+F (..\BALANCE\balance.c)(0x687D901F)(-c --cpu Cortex-M4.fp.sp -g -O0 --apcs=interwork --split_sections -I ..\CORE -I ..\SYSTEM\delay -I ..\SYSTEM\sys -I ..\SYSTEM\usart -I ..\USER -I ..\HARDWARE\LED -I ..\FWLIB\inc -I ..\FreeRTOS\include -I ..\FreeRTOS\portable\RVDS\ARM_CM4F -I ..\BALANCE -I ..\HARDWARE -I ..\HARDWARE\MPU6050

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Drivers\CMSIS\Device\ST\STM32F4xx\Include

-ID:\Keil_v5\ARM\CMSIS\Include

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Device\Include

-D__UVISION_VERSION="531" -DSTM32F407xx -DSTM32F40_41xxx -DUSE_STDPERIPH_DRIVER -D__FPU_PRESENT="1" -D__TARGET_FPU_VFP -DARM_MATH_CM4 -D__CC_ARM --C99

-o ..\obj\balance.o --omf_browse ..\obj\balance.crf --depend ..\obj\balance.d)
+I (..\BALANCE\balance.h)(0x67C844E9)
+I (..\SYSTEM\sys\sys.h)(0x67C8463C)
+I (..\USER\stm32f4xx.h)(0x67C84611)
+I (..\CORE\core_cm4.h)(0x67C84524)
+I (D:\Keil_v5\ARM\ARMCC\include\stdint.h)(0x5EC775FC)
+I (..\CORE\core_cmInstr.h)(0x67C84526)
+I (..\CORE\core_cmFunc.h)(0x67C84526)
+I (..\CORE\core_cm4_simd.h)(0x67C84526)
+I (..\USER\system_stm32f4xx.h)(0x67C84610)
+I (..\CORE\arm_math.h)(0x67C84525)
+I (D:\Keil_v5\ARM\ARMCC\include\string.h)(0x5EC77604)
+I (D:\Keil_v5\ARM\ARMCC\include\math.h)(0x5EC77604)
+I (..\USER\stm32f4xx_conf.h)(0x67C8460F)
+I (..\FWLIB\inc\stm32f4xx_adc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_crc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dbgmcu.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dma.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_exti.h)(0x67C8461C)
+I (..\FWLIB\inc\stm32f4xx_flash.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_gpio.h)(0x67C8461E)
+I (..\FWLIB\inc\stm32f4xx_i2c.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_iwdg.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_pwr.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_rcc.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_rtc.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_sdio.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_spi.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_syscfg.h)(0x67C84625)
+I (..\FWLIB\inc\stm32f4xx_tim.h)(0x67C84627)
+I (..\FWLIB\inc\stm32f4xx_usart.h)(0x67C84626)
+I (..\FWLIB\inc\stm32f4xx_wwdg.h)(0x67C84626)
+I (..\FWLIB\inc\misc.h)(0x67C84618)
+I (..\FWLIB\inc\stm32f4xx_cryp.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_hash.h)(0x67C8461F)
+I (..\FWLIB\inc\stm32f4xx_rng.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_can.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dac.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dcmi.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_fsmc.h)(0x67C8461F)
+I (..\BALANCE\system.h)(0x67C844F4)
+I (..\FreeRTOS\include\FreeRTOSConfig.h)(0x67C84613)
+I (..\SYSTEM\usart\usart.h)(0x67C8463C)
+I (D:\Keil_v5\ARM\ARMCC\include\stdio.h)(0x5EC775FC)
+I (..\FreeRTOS\include\FreeRTOS.h)(0x67C84614)
+I (D:\Keil_v5\ARM\ARMCC\include\stddef.h)(0x5EC775FC)
+I (..\FreeRTOS\include\projdefs.h)(0x67C84615)
+I (..\FreeRTOS\include\portable.h)(0x67C84615)
+I (..\FreeRTOS\include\deprecated_definitions.h)(0x67C84612)
+I (..\FreeRTOS\portable\RVDS\ARM_CM4F\portmacro.h)(0x67C84645)
+I (..\FreeRTOS\include\mpu_wrappers.h)(0x67C84614)
+I (..\FreeRTOS\include\task.h)(0x67C84619)
+I (..\FreeRTOS\include\list.h)(0x67C84613)
+I (..\FreeRTOS\include\queue.h)(0x67C84617)
+I (..\FreeRTOS\include\timers.h)(0x67C84618)
+I (..\FreeRTOS\include\semphr.h)(0x67C84617)
+I (..\SYSTEM\delay\delay.h)(0x67C8463B)
+I (..\HARDWARE\led.h)(0x67C8454B)
+I (..\HARDWARE\oled.h)(0x67C8454E)
+I (..\HARDWARE\usartx.h)(0x67C84556)
+I (..\HARDWARE\adc.h)(0x67C8453E)
+I (..\HARDWARE\can.h)(0x67C84540)
+I (..\HARDWARE\motor.h)(0x69491826)
+I (..\HARDWARE\timer.h)(0x67C84554)
+I (..\HARDWARE\encoder.h)(0x67C84544)
+I (..\BALANCE\show.h)(0x67C844F2)
+I (..\HARDWARE\pstwo.h)(0x67C84551)
+I (..\HARDWARE\key.h)(0x67C84549)
+I (..\BALANCE\robot_select_init.h)(0x6842B20E)
+I (..\HARDWARE\MPU6050\I2C.h)(0x67C84639)
+I (D:\Keil_v5\ARM\ARMCC\include\stdbool.h)(0x5EC775F6)
+I (..\HARDWARE\MPU6050\MPU6050.h)(0x67C8463A)
+I (D:\Keil_v5\ARM\ARMCC\include\stdlib.h)(0x5EC775FC)
+I (D:\Keil_v5\ARM\ARMCC\include\stdarg.h)(0x5EC775FC)
+F (..\BALANCE\robot_select_init.c)(0x6842B21A)(-c --cpu Cortex-M4.fp.sp -g -O0 --apcs=interwork --split_sections -I ..\CORE -I ..\SYSTEM\delay -I ..\SYSTEM\sys -I ..\SYSTEM\usart -I ..\USER -I ..\HARDWARE\LED -I ..\FWLIB\inc -I ..\FreeRTOS\include -I ..\FreeRTOS\portable\RVDS\ARM_CM4F -I ..\BALANCE -I ..\HARDWARE -I ..\HARDWARE\MPU6050

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Drivers\CMSIS\Device\ST\STM32F4xx\Include

-ID:\Keil_v5\ARM\CMSIS\Include

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Device\Include

-D__UVISION_VERSION="531" -DSTM32F407xx -DSTM32F40_41xxx -DUSE_STDPERIPH_DRIVER -D__FPU_PRESENT="1" -D__TARGET_FPU_VFP -DARM_MATH_CM4 -D__CC_ARM --C99

-o ..\obj\robot_select_init.o --omf_browse ..\obj\robot_select_init.crf --depend ..\obj\robot_select_init.d)
+I (..\BALANCE\robot_select_init.h)(0x6842B20E)
+I (..\SYSTEM\sys\sys.h)(0x67C8463C)
+I (..\USER\stm32f4xx.h)(0x67C84611)
+I (..\CORE\core_cm4.h)(0x67C84524)
+I (D:\Keil_v5\ARM\ARMCC\include\stdint.h)(0x5EC775FC)
+I (..\CORE\core_cmInstr.h)(0x67C84526)
+I (..\CORE\core_cmFunc.h)(0x67C84526)
+I (..\CORE\core_cm4_simd.h)(0x67C84526)
+I (..\USER\system_stm32f4xx.h)(0x67C84610)
+I (..\CORE\arm_math.h)(0x67C84525)
+I (D:\Keil_v5\ARM\ARMCC\include\string.h)(0x5EC77604)
+I (D:\Keil_v5\ARM\ARMCC\include\math.h)(0x5EC77604)
+I (..\USER\stm32f4xx_conf.h)(0x67C8460F)
+I (..\FWLIB\inc\stm32f4xx_adc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_crc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dbgmcu.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dma.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_exti.h)(0x67C8461C)
+I (..\FWLIB\inc\stm32f4xx_flash.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_gpio.h)(0x67C8461E)
+I (..\FWLIB\inc\stm32f4xx_i2c.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_iwdg.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_pwr.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_rcc.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_rtc.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_sdio.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_spi.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_syscfg.h)(0x67C84625)
+I (..\FWLIB\inc\stm32f4xx_tim.h)(0x67C84627)
+I (..\FWLIB\inc\stm32f4xx_usart.h)(0x67C84626)
+I (..\FWLIB\inc\stm32f4xx_wwdg.h)(0x67C84626)
+I (..\FWLIB\inc\misc.h)(0x67C84618)
+I (..\FWLIB\inc\stm32f4xx_cryp.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_hash.h)(0x67C8461F)
+I (..\FWLIB\inc\stm32f4xx_rng.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_can.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dac.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dcmi.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_fsmc.h)(0x67C8461F)
+I (..\BALANCE\system.h)(0x67C844F4)
+I (..\FreeRTOS\include\FreeRTOSConfig.h)(0x67C84613)
+I (..\SYSTEM\usart\usart.h)(0x67C8463C)
+I (D:\Keil_v5\ARM\ARMCC\include\stdio.h)(0x5EC775FC)
+I (..\FreeRTOS\include\FreeRTOS.h)(0x67C84614)
+I (D:\Keil_v5\ARM\ARMCC\include\stddef.h)(0x5EC775FC)
+I (..\FreeRTOS\include\projdefs.h)(0x67C84615)
+I (..\FreeRTOS\include\portable.h)(0x67C84615)
+I (..\FreeRTOS\include\deprecated_definitions.h)(0x67C84612)
+I (..\FreeRTOS\portable\RVDS\ARM_CM4F\portmacro.h)(0x67C84645)
+I (..\FreeRTOS\include\mpu_wrappers.h)(0x67C84614)
+I (..\FreeRTOS\include\task.h)(0x67C84619)
+I (..\FreeRTOS\include\list.h)(0x67C84613)
+I (..\FreeRTOS\include\queue.h)(0x67C84617)
+I (..\FreeRTOS\include\timers.h)(0x67C84618)
+I (..\FreeRTOS\include\semphr.h)(0x67C84617)
+I (..\SYSTEM\delay\delay.h)(0x67C8463B)
+I (..\BALANCE\balance.h)(0x67C844E9)
+I (..\HARDWARE\led.h)(0x67C8454B)
+I (..\HARDWARE\oled.h)(0x67C8454E)
+I (..\HARDWARE\usartx.h)(0x67C84556)
+I (..\HARDWARE\adc.h)(0x67C8453E)
+I (..\HARDWARE\can.h)(0x67C84540)
+I (..\HARDWARE\motor.h)(0x69491826)
+I (..\HARDWARE\timer.h)(0x67C84554)
+I (..\HARDWARE\encoder.h)(0x67C84544)
+I (..\BALANCE\show.h)(0x67C844F2)
+I (..\HARDWARE\pstwo.h)(0x67C84551)
+I (..\HARDWARE\key.h)(0x67C84549)
+I (..\HARDWARE\MPU6050\I2C.h)(0x67C84639)
+I (D:\Keil_v5\ARM\ARMCC\include\stdbool.h)(0x5EC775F6)
+I (..\HARDWARE\MPU6050\MPU6050.h)(0x67C8463A)
+I (D:\Keil_v5\ARM\ARMCC\include\stdlib.h)(0x5EC775FC)
+I (D:\Keil_v5\ARM\ARMCC\include\stdarg.h)(0x5EC775FC)
+F (..\BALANCE\show.c)(0x67C844F1)(-c --cpu Cortex-M4.fp.sp -g -O0 --apcs=interwork --split_sections -I ..\CORE -I ..\SYSTEM\delay -I ..\SYSTEM\sys -I ..\SYSTEM\usart -I ..\USER -I ..\HARDWARE\LED -I ..\FWLIB\inc -I ..\FreeRTOS\include -I ..\FreeRTOS\portable\RVDS\ARM_CM4F -I ..\BALANCE -I ..\HARDWARE -I ..\HARDWARE\MPU6050

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Drivers\CMSIS\Device\ST\STM32F4xx\Include

-ID:\Keil_v5\ARM\CMSIS\Include

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Device\Include

-D__UVISION_VERSION="531" -DSTM32F407xx -DSTM32F40_41xxx -DUSE_STDPERIPH_DRIVER -D__FPU_PRESENT="1" -D__TARGET_FPU_VFP -DARM_MATH_CM4 -D__CC_ARM --C99

-o ..\obj\show.o --omf_browse ..\obj\show.crf --depend ..\obj\show.d)
+I (..\BALANCE\show.h)(0x67C844F2)
+I (..\SYSTEM\sys\sys.h)(0x67C8463C)
+I (..\USER\stm32f4xx.h)(0x67C84611)
+I (..\CORE\core_cm4.h)(0x67C84524)
+I (D:\Keil_v5\ARM\ARMCC\include\stdint.h)(0x5EC775FC)
+I (..\CORE\core_cmInstr.h)(0x67C84526)
+I (..\CORE\core_cmFunc.h)(0x67C84526)
+I (..\CORE\core_cm4_simd.h)(0x67C84526)
+I (..\USER\system_stm32f4xx.h)(0x67C84610)
+I (..\CORE\arm_math.h)(0x67C84525)
+I (D:\Keil_v5\ARM\ARMCC\include\string.h)(0x5EC77604)
+I (D:\Keil_v5\ARM\ARMCC\include\math.h)(0x5EC77604)
+I (..\USER\stm32f4xx_conf.h)(0x67C8460F)
+I (..\FWLIB\inc\stm32f4xx_adc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_crc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dbgmcu.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dma.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_exti.h)(0x67C8461C)
+I (..\FWLIB\inc\stm32f4xx_flash.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_gpio.h)(0x67C8461E)
+I (..\FWLIB\inc\stm32f4xx_i2c.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_iwdg.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_pwr.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_rcc.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_rtc.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_sdio.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_spi.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_syscfg.h)(0x67C84625)
+I (..\FWLIB\inc\stm32f4xx_tim.h)(0x67C84627)
+I (..\FWLIB\inc\stm32f4xx_usart.h)(0x67C84626)
+I (..\FWLIB\inc\stm32f4xx_wwdg.h)(0x67C84626)
+I (..\FWLIB\inc\misc.h)(0x67C84618)
+I (..\FWLIB\inc\stm32f4xx_cryp.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_hash.h)(0x67C8461F)
+I (..\FWLIB\inc\stm32f4xx_rng.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_can.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dac.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dcmi.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_fsmc.h)(0x67C8461F)
+I (..\HARDWARE\oled.h)(0x67C8454E)
+I (..\BALANCE\system.h)(0x67C844F4)
+I (..\FreeRTOS\include\FreeRTOSConfig.h)(0x67C84613)
+I (..\SYSTEM\usart\usart.h)(0x67C8463C)
+I (D:\Keil_v5\ARM\ARMCC\include\stdio.h)(0x5EC775FC)
+I (..\FreeRTOS\include\FreeRTOS.h)(0x67C84614)
+I (D:\Keil_v5\ARM\ARMCC\include\stddef.h)(0x5EC775FC)
+I (..\FreeRTOS\include\projdefs.h)(0x67C84615)
+I (..\FreeRTOS\include\portable.h)(0x67C84615)
+I (..\FreeRTOS\include\deprecated_definitions.h)(0x67C84612)
+I (..\FreeRTOS\portable\RVDS\ARM_CM4F\portmacro.h)(0x67C84645)
+I (..\FreeRTOS\include\mpu_wrappers.h)(0x67C84614)
+I (..\FreeRTOS\include\task.h)(0x67C84619)
+I (..\FreeRTOS\include\list.h)(0x67C84613)
+I (..\FreeRTOS\include\queue.h)(0x67C84617)
+I (..\FreeRTOS\include\timers.h)(0x67C84618)
+I (..\FreeRTOS\include\semphr.h)(0x67C84617)
+I (..\SYSTEM\delay\delay.h)(0x67C8463B)
+I (..\BALANCE\balance.h)(0x67C844E9)
+I (..\HARDWARE\led.h)(0x67C8454B)
+I (..\HARDWARE\usartx.h)(0x67C84556)
+I (..\HARDWARE\adc.h)(0x67C8453E)
+I (..\HARDWARE\can.h)(0x67C84540)
+I (..\HARDWARE\motor.h)(0x69491826)
+I (..\HARDWARE\timer.h)(0x67C84554)
+I (..\HARDWARE\encoder.h)(0x67C84544)
+I (..\HARDWARE\pstwo.h)(0x67C84551)
+I (..\HARDWARE\key.h)(0x67C84549)
+I (..\BALANCE\robot_select_init.h)(0x6842B20E)
+I (..\HARDWARE\MPU6050\I2C.h)(0x67C84639)
+I (D:\Keil_v5\ARM\ARMCC\include\stdbool.h)(0x5EC775F6)
+I (..\HARDWARE\MPU6050\MPU6050.h)(0x67C8463A)
+I (D:\Keil_v5\ARM\ARMCC\include\stdlib.h)(0x5EC775FC)
+I (D:\Keil_v5\ARM\ARMCC\include\stdarg.h)(0x5EC775FC)
+F (..\HARDWARE\MPU6050\MPU6050.c)(0x6884D1D3)(-c --cpu Cortex-M4.fp.sp -g -O0 --apcs=interwork --split_sections -I ..\CORE -I ..\SYSTEM\delay -I ..\SYSTEM\sys -I ..\SYSTEM\usart -I ..\USER -I ..\HARDWARE\LED -I ..\FWLIB\inc -I ..\FreeRTOS\include -I ..\FreeRTOS\portable\RVDS\ARM_CM4F -I ..\BALANCE -I ..\HARDWARE -I ..\HARDWARE\MPU6050

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Drivers\CMSIS\Device\ST\STM32F4xx\Include

-ID:\Keil_v5\ARM\CMSIS\Include

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Device\Include

-D__UVISION_VERSION="531" -DSTM32F407xx -DSTM32F40_41xxx -DUSE_STDPERIPH_DRIVER -D__FPU_PRESENT="1" -D__TARGET_FPU_VFP -DARM_MATH_CM4 -D__CC_ARM --C99

-o ..\obj\mpu6050.o --omf_browse ..\obj\mpu6050.crf --depend ..\obj\mpu6050.d)
+I (..\HARDWARE\MPU6050\MPU6050.h)(0x67C8463A)
+I (..\SYSTEM\sys\sys.h)(0x67C8463C)
+I (..\USER\stm32f4xx.h)(0x67C84611)
+I (..\CORE\core_cm4.h)(0x67C84524)
+I (D:\Keil_v5\ARM\ARMCC\include\stdint.h)(0x5EC775FC)
+I (..\CORE\core_cmInstr.h)(0x67C84526)
+I (..\CORE\core_cmFunc.h)(0x67C84526)
+I (..\CORE\core_cm4_simd.h)(0x67C84526)
+I (..\USER\system_stm32f4xx.h)(0x67C84610)
+I (..\CORE\arm_math.h)(0x67C84525)
+I (D:\Keil_v5\ARM\ARMCC\include\string.h)(0x5EC77604)
+I (D:\Keil_v5\ARM\ARMCC\include\math.h)(0x5EC77604)
+I (..\USER\stm32f4xx_conf.h)(0x67C8460F)
+I (..\FWLIB\inc\stm32f4xx_adc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_crc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dbgmcu.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dma.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_exti.h)(0x67C8461C)
+I (..\FWLIB\inc\stm32f4xx_flash.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_gpio.h)(0x67C8461E)
+I (..\FWLIB\inc\stm32f4xx_i2c.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_iwdg.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_pwr.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_rcc.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_rtc.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_sdio.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_spi.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_syscfg.h)(0x67C84625)
+I (..\FWLIB\inc\stm32f4xx_tim.h)(0x67C84627)
+I (..\FWLIB\inc\stm32f4xx_usart.h)(0x67C84626)
+I (..\FWLIB\inc\stm32f4xx_wwdg.h)(0x67C84626)
+I (..\FWLIB\inc\misc.h)(0x67C84618)
+I (..\FWLIB\inc\stm32f4xx_cryp.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_hash.h)(0x67C8461F)
+I (..\FWLIB\inc\stm32f4xx_rng.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_can.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dac.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dcmi.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_fsmc.h)(0x67C8461F)
+I (..\HARDWARE\MPU6050\I2C.h)(0x67C84639)
+I (..\BALANCE\system.h)(0x67C844F4)
+I (..\FreeRTOS\include\FreeRTOSConfig.h)(0x67C84613)
+I (..\SYSTEM\usart\usart.h)(0x67C8463C)
+I (D:\Keil_v5\ARM\ARMCC\include\stdio.h)(0x5EC775FC)
+I (..\FreeRTOS\include\FreeRTOS.h)(0x67C84614)
+I (D:\Keil_v5\ARM\ARMCC\include\stddef.h)(0x5EC775FC)
+I (..\FreeRTOS\include\projdefs.h)(0x67C84615)
+I (..\FreeRTOS\include\portable.h)(0x67C84615)
+I (..\FreeRTOS\include\deprecated_definitions.h)(0x67C84612)
+I (..\FreeRTOS\portable\RVDS\ARM_CM4F\portmacro.h)(0x67C84645)
+I (..\FreeRTOS\include\mpu_wrappers.h)(0x67C84614)
+I (..\FreeRTOS\include\task.h)(0x67C84619)
+I (..\FreeRTOS\include\list.h)(0x67C84613)
+I (..\FreeRTOS\include\queue.h)(0x67C84617)
+I (..\FreeRTOS\include\timers.h)(0x67C84618)
+I (..\FreeRTOS\include\semphr.h)(0x67C84617)
+I (..\SYSTEM\delay\delay.h)(0x67C8463B)
+I (..\BALANCE\balance.h)(0x67C844E9)
+I (..\HARDWARE\led.h)(0x67C8454B)
+I (..\HARDWARE\oled.h)(0x67C8454E)
+I (..\HARDWARE\usartx.h)(0x67C84556)
+I (..\HARDWARE\adc.h)(0x67C8453E)
+I (..\HARDWARE\can.h)(0x67C84540)
+I (..\HARDWARE\motor.h)(0x69491826)
+I (..\HARDWARE\timer.h)(0x67C84554)
+I (..\HARDWARE\encoder.h)(0x67C84544)
+I (..\BALANCE\show.h)(0x67C844F2)
+I (..\HARDWARE\pstwo.h)(0x67C84551)
+I (..\HARDWARE\key.h)(0x67C84549)
+I (..\BALANCE\robot_select_init.h)(0x6842B20E)
+I (D:\Keil_v5\ARM\ARMCC\include\stdlib.h)(0x5EC775FC)
+I (D:\Keil_v5\ARM\ARMCC\include\stdarg.h)(0x5EC775FC)
+I (D:\Keil_v5\ARM\ARMCC\include\stdbool.h)(0x5EC775F6)
+F (..\HARDWARE\MPU6050\I2C.c)(0x67C84638)(-c --cpu Cortex-M4.fp.sp -g -O0 --apcs=interwork --split_sections -I ..\CORE -I ..\SYSTEM\delay -I ..\SYSTEM\sys -I ..\SYSTEM\usart -I ..\USER -I ..\HARDWARE\LED -I ..\FWLIB\inc -I ..\FreeRTOS\include -I ..\FreeRTOS\portable\RVDS\ARM_CM4F -I ..\BALANCE -I ..\HARDWARE -I ..\HARDWARE\MPU6050

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Drivers\CMSIS\Device\ST\STM32F4xx\Include

-ID:\Keil_v5\ARM\CMSIS\Include

-ID:\Users\32892\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.13.0\Device\Include

-D__UVISION_VERSION="531" -DSTM32F407xx -DSTM32F40_41xxx -DUSE_STDPERIPH_DRIVER -D__FPU_PRESENT="1" -D__TARGET_FPU_VFP -DARM_MATH_CM4 -D__CC_ARM --C99

-o ..\obj\i2c.o --omf_browse ..\obj\i2c.crf --depend ..\obj\i2c.d)
+I (..\HARDWARE\MPU6050\I2C.h)(0x67C84639)
+I (..\BALANCE\system.h)(0x67C844F4)
+I (..\FreeRTOS\include\FreeRTOSConfig.h)(0x67C84613)
+I (..\SYSTEM\sys\sys.h)(0x67C8463C)
+I (..\USER\stm32f4xx.h)(0x67C84611)
+I (..\CORE\core_cm4.h)(0x67C84524)
+I (D:\Keil_v5\ARM\ARMCC\include\stdint.h)(0x5EC775FC)
+I (..\CORE\core_cmInstr.h)(0x67C84526)
+I (..\CORE\core_cmFunc.h)(0x67C84526)
+I (..\CORE\core_cm4_simd.h)(0x67C84526)
+I (..\USER\system_stm32f4xx.h)(0x67C84610)
+I (..\CORE\arm_math.h)(0x67C84525)
+I (D:\Keil_v5\ARM\ARMCC\include\string.h)(0x5EC77604)
+I (D:\Keil_v5\ARM\ARMCC\include\math.h)(0x5EC77604)
+I (..\USER\stm32f4xx_conf.h)(0x67C8460F)
+I (..\FWLIB\inc\stm32f4xx_adc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_crc.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dbgmcu.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dma.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_exti.h)(0x67C8461C)
+I (..\FWLIB\inc\stm32f4xx_flash.h)(0x67C8461D)
+I (..\FWLIB\inc\stm32f4xx_gpio.h)(0x67C8461E)
+I (..\FWLIB\inc\stm32f4xx_i2c.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_iwdg.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_pwr.h)(0x67C84621)
+I (..\FWLIB\inc\stm32f4xx_rcc.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_rtc.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_sdio.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_spi.h)(0x67C84624)
+I (..\FWLIB\inc\stm32f4xx_syscfg.h)(0x67C84625)
+I (..\FWLIB\inc\stm32f4xx_tim.h)(0x67C84627)
+I (..\FWLIB\inc\stm32f4xx_usart.h)(0x67C84626)
+I (..\FWLIB\inc\stm32f4xx_wwdg.h)(0x67C84626)
+I (..\FWLIB\inc\misc.h)(0x67C84618)
+I (..\FWLIB\inc\stm32f4xx_cryp.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_hash.h)(0x67C8461F)
+I (..\FWLIB\inc\stm32f4xx_rng.h)(0x67C84623)
+I (..\FWLIB\inc\stm32f4xx_can.h)(0x67C8461A)
+I (..\FWLIB\inc\stm32f4xx_dac.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_dcmi.h)(0x67C8461B)
+I (..\FWLIB\inc\stm32f4xx_fsmc.h)(0x67C8461F)
+I (..\SYSTEM\usart\usart.h)(0x67C8463C)
+I (D:\Keil_v5\ARM\ARMCC\include\stdio.h)(0x5EC775FC)
+I (..\FreeRTOS\include\FreeRTOS.h)(0x67C84614)
+I (D:\Keil_v5\ARM\ARMCC\include\stddef.h)(0x5EC775FC)
+I (..\FreeRTOS\include\projdefs.h)(0x67C84615)
+I (..\FreeRTOS\include\portable.h)(0x67C84615)
+I (..\FreeRTOS\include\deprecated_definitions.h)(0x67C84612)
+I (..\FreeRTOS\portable\RVDS\ARM_CM4F\portmacro.h)(0x67C84645)
+I (..\FreeRTOS\include\mpu_wrappers.h)(0x67C84614)
+I (..\FreeRTOS\include\task.h)(0x67C84619)
+I (..\FreeRTOS\include\list.h)(0x67C84613)
+I (..\FreeRTOS\include\queue.h)(0x67C84617)
+I (..\FreeRTOS\include\timers.h)(0x67C84618)
+I (..\FreeRTOS\include\semphr.h)(0x67C84617)
+I (..\SYSTEM\delay\delay.h)(0x67C8463B)
+I (..\BALANCE\balance.h)(0x67C844E9)
+I (..\HARDWARE\led.h)(0x67C8454B)
+I (..\HARDWARE\oled.h)(0x67C8454E)
+I (..\HARDWARE\usartx.h)(0x67C84556)
+I (..\HARDWARE\adc.h)(0x67C8453E)
+I (..\HARDWARE\can.h)(0x67C84540)
+I (..\HARDWARE\motor.h)(0x69491826)
+I (..\HARDWARE\timer.h)(0x67C84554)
+I (..\HARDWARE\encoder.h)(0x67C84544)
+I (..\BALANCE\show.h)(0x67C844F2)
+I (..\HARDWARE\pstwo.h)(0x67C84551)
+I (..\HARDWARE\key.h)(0x67C84549)
+I (..\BALANCE\robot_select_init.h)(0x6842B20E)
+I (..\HARDWARE\MPU6050\MPU6050.h)(0x67C8463A)
+I (D:\Keil_v5\ARM\ARMCC\include\stdlib.h)(0x5EC775FC)
+I (D:\Keil_v5\ARM\ARMCC\include\stdarg.h)(0x5EC775FC)
+I (D:\Keil_v5\ARM\ARMCC\include\stdbool.h)(0x5EC775F6)
diff --git a/OBJ/adc.crf b/OBJ/adc.crf
new file mode 100644
index 0000000000000000000000000000000000000000..182a2c400944fe70cbe5ec1e76ceb73f75d04a29
GIT binary patch
literal 613175
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	i|pRAhh>y=0QFukgJg
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
z
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�-T%FhQ=X
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
Q4(!OZ?vx!Mou}=80Kyh!pa1{>

literal 0
HcmV?d00001

diff --git a/OBJ/balance.crf b/OBJ/balance.crf
new file mode 100644
index 0000000000000000000000000000000000000000..da5ff847938edb4af87e969c90dd69cefe5e2333
GIT binary patch
literal 619194
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%0ARjB}@1XN}X0`XKcfjt*
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%0Dth#+kRf<0CE-@i7f?TVk!|h9|
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�
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

literal 0
HcmV?d00001

diff --git a/OBJ/balance.d b/OBJ/balance.d
new file mode 100644
index 0000000..01d661b
--- /dev/null
+++ b/OBJ/balance.d
@@ -0,0 +1,78 @@
+..\obj\balance.o: ..\BALANCE\balance.c
+..\obj\balance.o: ..\BALANCE\balance.h
+..\obj\balance.o: ..\SYSTEM\sys\sys.h
+..\obj\balance.o: ..\USER\stm32f4xx.h
+..\obj\balance.o: ..\CORE\core_cm4.h
+..\obj\balance.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\stdint.h
+..\obj\balance.o: ..\CORE\core_cmInstr.h
+..\obj\balance.o: ..\CORE\core_cmFunc.h
+..\obj\balance.o: ..\CORE\core_cm4_simd.h
+..\obj\balance.o: ..\USER\system_stm32f4xx.h
+..\obj\balance.o: ..\CORE\arm_math.h
+..\obj\balance.o: ..\CORE\core_cm4.h
+..\obj\balance.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\string.h
+..\obj\balance.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\math.h
+..\obj\balance.o: ..\USER\stm32f4xx_conf.h
+..\obj\balance.o: ..\FWLIB\inc\stm32f4xx_adc.h
+..\obj\balance.o: ..\USER\stm32f4xx.h
+..\obj\balance.o: ..\FWLIB\inc\stm32f4xx_crc.h
+..\obj\balance.o: ..\FWLIB\inc\stm32f4xx_dbgmcu.h
+..\obj\balance.o: ..\FWLIB\inc\stm32f4xx_dma.h
+..\obj\balance.o: ..\FWLIB\inc\stm32f4xx_exti.h
+..\obj\balance.o: ..\FWLIB\inc\stm32f4xx_flash.h
+..\obj\balance.o: ..\FWLIB\inc\stm32f4xx_gpio.h
+..\obj\balance.o: ..\FWLIB\inc\stm32f4xx_i2c.h
+..\obj\balance.o: ..\FWLIB\inc\stm32f4xx_iwdg.h
+..\obj\balance.o: ..\FWLIB\inc\stm32f4xx_pwr.h
+..\obj\balance.o: ..\FWLIB\inc\stm32f4xx_rcc.h
+..\obj\balance.o: ..\FWLIB\inc\stm32f4xx_rtc.h
+..\obj\balance.o: ..\FWLIB\inc\stm32f4xx_sdio.h
+..\obj\balance.o: ..\FWLIB\inc\stm32f4xx_spi.h
+..\obj\balance.o: ..\FWLIB\inc\stm32f4xx_syscfg.h
+..\obj\balance.o: ..\FWLIB\inc\stm32f4xx_tim.h
+..\obj\balance.o: ..\FWLIB\inc\stm32f4xx_usart.h
+..\obj\balance.o: ..\FWLIB\inc\stm32f4xx_wwdg.h
+..\obj\balance.o: ..\FWLIB\inc\misc.h
+..\obj\balance.o: ..\FWLIB\inc\stm32f4xx_cryp.h
+..\obj\balance.o: ..\FWLIB\inc\stm32f4xx_hash.h
+..\obj\balance.o: ..\FWLIB\inc\stm32f4xx_rng.h
+..\obj\balance.o: ..\FWLIB\inc\stm32f4xx_can.h
+..\obj\balance.o: ..\FWLIB\inc\stm32f4xx_dac.h
+..\obj\balance.o: ..\FWLIB\inc\stm32f4xx_dcmi.h
+..\obj\balance.o: ..\FWLIB\inc\stm32f4xx_fsmc.h
+..\obj\balance.o: ..\BALANCE\system.h
+..\obj\balance.o: ..\FreeRTOS\include\FreeRTOSConfig.h
+..\obj\balance.o: ..\SYSTEM\usart\usart.h
+..\obj\balance.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\stdio.h
+..\obj\balance.o: ..\FreeRTOS\include\FreeRTOS.h
+..\obj\balance.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\stddef.h
+..\obj\balance.o: ..\FreeRTOS\include\projdefs.h
+..\obj\balance.o: ..\FreeRTOS\include\portable.h
+..\obj\balance.o: ..\FreeRTOS\include\deprecated_definitions.h
+..\obj\balance.o: ..\FreeRTOS\portable\RVDS\ARM_CM4F\portmacro.h
+..\obj\balance.o: ..\FreeRTOS\include\mpu_wrappers.h
+..\obj\balance.o: ..\FreeRTOS\include\task.h
+..\obj\balance.o: ..\FreeRTOS\include\list.h
+..\obj\balance.o: ..\FreeRTOS\include\queue.h
+..\obj\balance.o: ..\FreeRTOS\include\timers.h
+..\obj\balance.o: ..\FreeRTOS\include\semphr.h
+..\obj\balance.o: ..\SYSTEM\delay\delay.h
+..\obj\balance.o: ..\BALANCE\balance.h
+..\obj\balance.o: ..\HARDWARE\led.h
+..\obj\balance.o: ..\BALANCE\system.h
+..\obj\balance.o: ..\HARDWARE\oled.h
+..\obj\balance.o: ..\HARDWARE\usartx.h
+..\obj\balance.o: ..\HARDWARE\adc.h
+..\obj\balance.o: ..\HARDWARE\can.h
+..\obj\balance.o: ..\HARDWARE\motor.h
+..\obj\balance.o: ..\HARDWARE\timer.h
+..\obj\balance.o: ..\HARDWARE\encoder.h
+..\obj\balance.o: ..\BALANCE\show.h
+..\obj\balance.o: ..\HARDWARE\pstwo.h
+..\obj\balance.o: ..\HARDWARE\key.h
+..\obj\balance.o: ..\BALANCE\robot_select_init.h
+..\obj\balance.o: ..\HARDWARE\MPU6050\I2C.h
+..\obj\balance.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\stdbool.h
+..\obj\balance.o: ..\HARDWARE\MPU6050\MPU6050.h
+..\obj\balance.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\stdlib.h
+..\obj\balance.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\stdarg.h
diff --git a/OBJ/balance.o b/OBJ/balance.o
new file mode 100644
index 0000000000000000000000000000000000000000..e82c5c69944b7ea20d233842b9584e93b5f1f5ca
GIT binary patch
literal 616852
zcmeEv34B!5_5XXbWf(w1K*a!IShOKxO~Nizm`oBfl4YD3)}|eXWCByOkp+XbEh;MR
zsIAtmxco|8+KN{CbE#{syT6K6TTx3~ic3v?)P1S-|2^m4x6Qm6K>hXi``1oBlX>@^
zbH3-?bI)DgefPchgR0tURaF)3qbkLUky4aO_Yfkvr!zyba*E>zjsq1zKe45oWne4=j7SQJg4U5If;2H-=3FG7OY2^JjKON?Rs6=
zfc@>TCM1=~w(K)3CmoE?Kg~
zELnJ5I-UJ=QhykAv*=i5^M!_8h1JKJQohil6%|yX7HAEoX+6fQqhyXbRXD?(Vr^AG
zC{IH;GTp9{;`E%ti5W3(P4IA@_KI;jDI4tJTV8D&J+hwRZ4%
zeiL_p_L;K%$btN`&)l|caKTx723KB&s61=i;4mN3m;D{_F#6_C@Lw$+wPV}h8pLc0
zlp40?eMFW*d}nP&J?sHLqMCls8iWMJ`JBN`z5#9(1H@a{Ie4tlkZGrdHmy8k
zpRFXz3@gVCRrk-t
zvqD)rR8!<-Svzl{cHS&S|0L>`%2g!GGFC5Fy7zs9n|)gbN(*-llp->`k~
z-W&clnE$c=$#EP_h!cz!-|?x4Xg^xcy@MsbLu&3tj31On_v`e0rn~!xQ#sEP|F;Yr
z;wwR^%u!f0^sxSW`}e08@h*_u{QJjA<0~(_^w9bE-t(6yU!Je|hhk*>z|b+<25aHh
zR;_Gzz)yE<8F&glp(q~1{-cOB0F;kFFijMn=L9_em^{}kU%w$XGw$I$h*
zv}>6*ejtRI0rh(02Wov+@zH|!f9z;@w`T37GFmRd%;S)kE<+qTiz{|q%CWZwy}~xs
z`UdozvtiNsEO}uDjr!3unRdFZ6(=)ogDvg5OdCJYpd&0*Rc3r*?I>(@q(a)H}l2Cuk_13OCD#`HQmoVliC(5P&FrcrCow0bnt4zZ;b
zFm3$6^S*p}^rG)TJ{q#^uD9~fR_>y<_=mc8=i_I?MWbK6htiHCKAK-U>k;HVTuJF%
zpZx9W2{km9vG8~lO0U}9M?vTCjJ6qoBM=vL4^cKCMikvh4r
z|8b_!=&JZ0;bWR5J|gLBFfu&odw^5->D2orb$S19^t?Mc?>0S6W2@p*Cok;(m7aGC
z=TZB-SyE^B|6Hfuz&~8&J%6#a!DTw
z$xD1c;?$ObAIT$SvT_gprjFQgA^Yoq9p^B@u7UG?8wUM_TL#YaO+X)eF3WB0KSy$%
zBDqeNT$`AS=IV;?B53-akJ>8axa|!o{to*;L)H~Exsl``bPf>oklH@(3bfc`RJ(rs7^ah
z(iZy`^U(xos`t^jN)in|YM+Yl;QnfssFwL5Ux<%<;I8m3khu$dm3%}VJ%;_{#yEV8
z?-ca*DP`f
zYcuFW7|Fw2G$+XCmYS<2ejI%MKx(t%gJZPi6D#vEPj{W|@DoNaMhYh%b%$zJy7;IQ
zb0jw(wTB*F*^aV$iVMY=T;Z(RMBf^=0Oyxy(QN%g{BBsYphBK=UY4l2SEfL@tgHW9
z7?X7BS<7n{7}T?t)R-kB7Rkl^^|~IjObEFSI=jU=f|ImgwxGY#mh+el&LjHg=$v-8
zms>0t)&F&!+iXE`1};V0mVv{3#fYBCdVNpiBWl4DxW=~(j0MLA-x!^vQ0F*Qa*V?4
zUGa_7IY#Il)Nd>33x@Li-lubjs30vq=D6!E*V*RCc(_8V|McI|!FvlQu?$5QTU%H*
zm?-oUcHxA<35DbNsF1u+q7I%?IF{38ppY#jwQFE>;jM!&;fyH%W9N%o1`c9M0ZD*X
zV9=i0GH@W%@|fmfy;4#9RmMg=;u-4ciNsi@C(y%iIc%d}B{w)Z|UnPJFut&cKX$rFq5d
zJG3T8l#|mbE50u&C#F+QTv>5ih2zDaRwz4_!&X+Dj^nL#eE7;O{YlB^(D}SO#Ed}jt@IJ!x0p*CC!OdER&YMXj1}m~
zG44MJE;=*bg^{27vIzGNpnr$xbtZZ>(-&#<6N$bH=R`t!K2v#)P*{bLYxK>P_^%cp
zxFf(e9Bo1pymJ|8ZvWBXqj|tA=Chv%&}^ON0W@czdBBnQrFp>DEame&bvUPKPDG`j
z$SLkSrImiRax7~e&D32O8>rmWuWB=c(RvQ|r;LT#E*!>X@Ua|4>s_z!Ia$U`&>TDI
z$L6_!qI?YA6Dtv43!4vXc=zK~$K{_P&mK?1oIvDklsTv9IU8io_w}6b$(-*Zrw_+h
zz5T*cZ#Dle>lNuGYsK&KH5_3#afGd@*ihws@wzH?XTu)FyN2WNmmG&{DozIFdO;b|
z!ll(Bp%mk%Tn#=}nTklAocD=q53F6g`IEoxk#i8=3i7P);lC-$%Ah%4%r757zQ(x=
z>oy{C!t8CHYZf-3UPs?thyN5g$7&WFOR?sM1-k~S^tzeb9|Rvo&H}Cx`^cf_qR5$z
zUy7WW_@&4>ie@x%Pf|Vg?==k+&S-YmOtJS_Kp67=hTd=0^=Ap+H^r`?v6#373cSBme7rpua!EV>N;3!8T~
zDY)W6bIf62?R#OP<=ZAq_E9nQmFv^VY
zQ;OB+U7%M=y6eT^)LzF9MSJz($Wxs6qT(Nd{#W&Tk%#Zf(k$nOTG^@mC~x7rnEOy<
zI-U~ceHU|aPQOUk65oGq+hD@?&TG!2I_-Vjg6}kt%>%g&U`JbLM|-lp=V*T*Qs<{+sx{f=pYiq5
znf~6+=0s1@Khs~lsyEfz?4LEGbc#RL(b0OeKhf2e=x+0Wb9(c%8Of$^DOE=|b|spU
z@$SUBWMg+*qN^v~l;|oiEuYcY(3M)9Y7Zv5o_*+n7w-J{!4DpO?2nJ$_j^yNix;k26SL5PnRYa6Xy2TNX!;pA9J|`|q6>o~qZfTjBmMHw7Ca@R6c4b#x`;O>Lp}?w+o%uTkJkT&Z@@
zf9ENxTIg_iAo*_}3m-?xsfyy_|M>UCeSCrLTkyptVyr#SLXb>wYyxGaSEEh?V&MZ|ih$IlYQk^*X#c%IQ7D;XT#i-RSV1
z=J1~G@a}6lOKi$1bmsD{cZ0)wvg7mWJUFY)y_E9{=q${tGjFfH)njNMd^-wyw9htl
z7lDyKIFEXbmH3)tY41MX|M*>|DaP-^c~W=9$c_=493w`Y={Ru2S&rc&&UOqPagJli
zh;tozBhGWUN1X3)21d3xUv!S_s2KSJ&nAcGOo!(zhv#gE=NyOUT!-g8hX;*g|Lx!Z
z7#VG{|8yJ&MxM0Mb(-^Z2RxWv|CiS;%yoAK>(5K}8#~8BpY|!nSXwdi#EqWQ
z+^4(FaBli%+2GdtX-%v)
zGxQ|8d*bcAZA!skb)lw?wzfojbG)?!Gy$1^E9P|?s5q-mv{tn@0k})aKMoF;M5=>E
z!~gDoRsT~t=^TbWE|;sNwIk7^9P?*~dZQz+C(*S!*%NO~wWWICaH6OMdze)dNu}Dm
zlc+Xi<7{6^wRW69$F!)LT9aD6h7wbezzJ?wvb(pHIjK*h_Pp#X;$J#nqmPXBV|F^!
zTODqTcc~3%zSY=GzO9F}=G(b+tofFPD~oRrLI(ME-dDu8bY4myBX)n|P@i+>ak$14
ztGac!YMdswW{pfm34cZWN9WiU|IPosL%qxGiMDlg^sLdA4aLHp#+zE#NA0>3a;bIe
z>5x{cQtM8nLq86eb@wDYDdE|CisMSZA|v{TUlE_u+5vs^n4Eu+Q$5&I*_B$CjMsJa
zbaV-SYJ90B?9Z`qPihJK^Ib@%masn`$Ki@ZTW4#kr?)vtPQ4X52VdyS$Iy5$G_8nG
zW-GBp5dAOC*|m;YV#t%9m0yv1p*0cu$bNYK%MSHJ)f2@K
z7e1j)REfrtYNKk3C&-y?5RvIslwM(^n<%}|NHt1q=%e}g
zI){3N!&A#s2;IvXQ_2$8(o>3Z&R4`&v`$4IZ4RtYzs`25KX$r9?M+?DHe6Rqw8q1s
zc%?p)X>uuT;#%+lPqI=mp0FuMjsonr&2ug_yjfM3SELf%L>80WYfKz*E-Q6Is7*9Tvc{GU4y*5cf*eQeCAkBWcS$Nyq|eC$Z?uLA#T^-=p389!)U
zoIbLB9P^k%{hh-V>+NcfH?*`UDlc{rgT|Oz*U{ROSk1FYnv)wN1hcB)>FTncWLu{q
zlX5X`^jE~6+S>2@OC0JZw`Wmuy_ghg`73%f*XUCfrRJ;R8>~IkN1N9@nS2#x}eXp+GR8qRu><=tadpcE%7glh@+*kWwA9_4O-LD%JXG4<`F_0z9PP)Yb*58
ze0j1{{gulTN#dL%84rq$IwJBk&gDI8x>8L^(Jsa0EzO6EJ(|mxF40`R?Aw~lm$xsA
zhzeQKvP>$91lJ{7JDO5Ge8#E9egp3-ivKH82XtMDKJ&LY)Ek_hg*XX}U`9t-8fjTI
z)|hd=zE1jGjme!kUzPI{y8cBUV;$ohr+TrQowY>9PQ1FKt1Ygbh_HYrwoK;61M$u-
z>H|ERH_>X4M<-NR2!4YQ)Cp%=B`Pfhzvwu=Dt$0r|D#Xux{g${G7%n~k8b#S)l(t%
zBF1|X-N%a<)>u=W>%xhyL|d{a*@ZK|_mv5dU*3u{y`_oclXR^`$^S7HksKHFFtk#M
zDwNlp{-v*Z(Dh9Epbu{CXkV=y^IM1dg2Uamo|lZ-Cq&lRQoItBHfJKoso`PToJl50
z?5nfhvsDyVnU95@-EL3%bvhA^8q@M*R~HsPO&8%J|3f^7a_2dJfHGmb
zE$N^oWhbu~eLlb8@&Ng5n5P{79i9pJFEr(OX5)ASYc(G`Jo9byGkNv_$FmI%!xwe6
z4NgOO#C3(w9|s3>aSA+@0CjmL;eVm$P(DV{Jah3yXn6eiPR4g4zN_$Um%p9(Z8W~v
zN88G>#0Nx2#B+dWq}TI;!9wg{E5-i;f)h%q#=M@DV5>%!+w(OXt-*IKzJ<(G1hnB)
zU~Hjo#9YMfa_&}CM$TJ@QM^RsyEN+P
zoK$j-71=CHRMj(znkKpZi?&THgsa@ykbhAd^xwn(RnLjC{nJIY&)+tk&dZ$SGY;4r
z0H5#q2L3zQUn4w0?btIFN2;e>w4X1kbMya#&eQ)FbpD;ki~aNMrY}^Vs`GagGcJq|
zZiGMni=N5tnLtCyaPFqW_%$499$&h^SX7`kpYJ)y?L_nQERkPyZ|;M*xYUz5sq|Ts?5=}3+J|tbK3YaT
zjY5ZbW)T2&^VGemu*FF#~dgmolj`!c4%R_r?7MW2p#E{_pmX*9zFbV|WHJ
zng2UEU-cX-?iKQ5%JTX9N7adQebs%yD7S-(JerH_l(o4CImH~#$9N8N*JC0>JX+2y
zcb&}n8r$^^&n$PX%$dTGFdsP$X*q{wr6f@2-o+F?Oibn7#KZOmLk4yuKCUNs&
z5_0ODeQ=o5CmJ`^%2@W;5So(6<3c`m^88|ihe{}#V;cQG
ziI2@RAxGWjNsIy7cuj8aG@Acp>a&w`epd?>o~zP)6<>5r?GBWLrjcLJPgr?S-3L*D
z-JUUS7ow3T&xf!#T%Ho7Y2bn**-L(IZ9We3%;WK%A_l616wTT4JoPy0F@1Y+O#Sg#
z_WyT1yZD&Y1K7PI*}dcWznrvE9pgir
zH66m%1V7`@u}R*-M@uJ8*l;m^`QycZ
zAHJ#*78&9{*`+Fx%&g@w!3>4~oPCd_a59%w-wvR+P>7Lif35+t0zGpv*tZY{OVzs5tq>2+(uGqYKJ
zcsfXM2;uUFYMJs>B_=Y&f01PgJCS7xU6Ex8U6Eypc}pGA-Y9d0kUGjsYbO^9Hlpeu
z%G3O!XX3z=Z_eg?sLIIu{}E#*O5vjZMeks!Sf+l07*xel6&Al!#|39lv*8al&cpFd
zt9L>qpV2Q}?8GsJs{S$4>FOQmew~N|(n<34OBb4Otg9qGGuh{Q
zdcj0s#N)A09TUoCA6+{0=xNhMZZuXI1bZ2?aAHYSBpPa{r_4EX=9HGz8l;+rXsoKz
z${va~#LG%&PM?YF^3u|orL&m7s&b*uN5=;0bQ4E3w4y2=TOKCEdfU5GtJ{;!e%^`?
zgGnqLi&TcHt2G{t)SWsp+0hb5(m$Qm$qc%ZV9n|5>5>_EG(<3{+2Nl-md+?;;aDKD
zuqqZ0h8M^2*o0WsvUuI}cy%})4NJdBhH5Y@sSYoh4obYTY^J0xUJ_!5$s+n^Oe1eb
zV|CNYt5Mj#KIYTX@#$rKG7Havh{NUKsz@kY6R(VffFLnRRX9==t*VdN+Q6A8QM@h?
ztBD8erb{lAkRE{{suNEdFpl)vkcA0Ef;I73RdJ2koJ|lG*D!OeW^rAGbf$%S=5!nG
z0Le@%mj+1waHOF+RGXo+x+)M`9I1-e1Zu07Hbg3|LK;=*7e$kJ8mVq^Z7dY7U2ZQ}
z84ZIW3$0;sMQv4frIn#2p~@KE2#
zv7u^Ntg4>FFH*HIgytDR3@@grnaQyo2nVC_P(AWd#zhhzv0WXA#^Tj=fohr6v!=Ig
zmHAkYm!4_m`f)=Ty-0|{HXI0Q7U`L_RZFUB5eiO4btxU_k*F_Klnv-D-^H)##xftW
z(yvsBJIam#rAND!Y(5e;_mIVroqp>WDLM>ap>icSK0?ZJi;uX0iWn#9jE!LYAf1tV
z8T!yvN#HGzc*adFM4zD3W0IbB(*`jW=}bSCOy=7Vh(pYl>8KeTWR12Xp7IPMrb?=@
zmz(HDSvG@?I#)8bE$K_Z6-vVsuRg^6fH!w-&R5V<8^+r>0_iU
zSN(~FCL+QpT5dRl(Y*UvV53kCSWaql!9JJA~7^!81Ev7pnIkSynzb2_q5k}8mGsF+h;K5g2p^3rKDXU~{EYu1d}rL&;o2jobUg%D=UP}B`7
zWl&*|Gjqm_X~;X7^Qbh)n_fO=`ka}w%ID1JRn$|MLZx9l?!mi3WFzfz~$*UC?H`aV|5)w+NTMN=?eqtm2g%oT90PPD0=|ImrLV{%u{&x9|f
zU($p9I)f@Lv9yKj4YFN5-C&S)YxY)6w@?9ae#4yw4u!WB^>#fUHp=|KGDW?Yb+7;k
zgf1*m)CWldjZ}6!dRJ@enzVkWwG|QYh|UinQ`c-0)Xe`lYi0#j0lS`{mqngYwKF&B
zBu%Az)*x7mw^NOV7RCdyhPqJDu4jGTLWit5QeFZPXOh%WnH=MIO(kM{##1|K=zC8s7qnCoh9!|N}3IykXL8NgEVO2tEhjc3S$Vj+9k<{KhFlQE@hco^<1a7L@ba>gpGbh2jdhn;<Tbx)n91Ox>1{DO0!TSfRp%3A^gdnYwlL=3L#z26L`%X;|oL(F}zv
z78_Xt5_wCEJl)KtMxJivGO0wzgLA%V$`gRdY&2!+CVtD5sayDMR)h5^SyM^DBr^cj
z!VGPRK3R9)nZR`?Gf*4HPv9V=^M&*A-Hh)A_|kd6*D#^Q6F{*t6snJ6jH$uIc3wPQ
z-w;NJ-`>%ws945ZS{*{_gqD<|)>5j9Q%OaQVy;}Z1gY-iIur?QJ6cgpv-ni^s^ZeV
z>M4rajFm>2*{o-_BC}3#Hn(Y<>-h1d5bh$dt5hT#B9x@N@NY!2Vo^9&ye`q&n%`iOxTye3%`;DZ245SgHFCkx5)BSo}vzDtTlUO{YYb7x>wed
z(ai>HVE_u;)C#4FdJeLp(Ez!ryPF;ra|tpQi;P~*xSEAlu*iwrInU;J`8xh*^v&pk
z`605l&yc07t8cL^{)wkSF>~7EX1}!F_W#23ps1Z)gzpdW{Sm&_c2>Q(KFH1NNmOF8
zJ+Z1a8E;A8fjjY3*IIa7%Sx?P)IWixIn|xPqvwIirHHyY5}Nj2H`TrEP5J>Kf-EI{mJ4X^TWi$}dqGlx-3=IBz=96g<0sJZWW
z)a{xr;Yg@15M8tv52fnpb|2j(r5Sf(_|xr2G?OX?UAz!iaL
z6{K^ju1Itz0b;1W&Wke|Ss^-rP`yg>3f1Y7a|gWYCt9hi1GtQ`*K$`=rFJ)W8(4SWX@WVGao!P8q*q)
zw*W)0%<2_60pw_cy;8CQd75Oel*HxOXmoJ}YwYe_1&x@h9Vc_viX1GYMr$;tH6pK?
z274jbD{^oJcCjYdD^$b
z6_xVpNVA@)$>W+bmsYT9@(rTA0u+Xmd{~s2^T=?@J5H8aFp}w%8v!PYBOqlSrmtLX
zk*UeYNW0Fe$uFj|M`;$-o#@6SY6+E_(`z}sl*=p_)^HA%#TN^XUQQ#xP*&zZwGze(
z(j;?)%r~iwSTBHTsFb5hI8;_08HIT0#i3g;2Co$lgJPL|F;sHL)#Nm=MdV+{>N+W73mt1+F!z$RH`FTSThlh
zLP4jMlVhM72UASvH%IN$9C~`ZJJr@KXVI8L(>1y*b7-CQUuYJM(u#5Ma{OL_@0Ixe
z1YbJOIm$FP*2EW9)nm^}(66W%VzBuH-)JbRU1P*DEL|8wbWTH6W5CJeKsQVb<)vW2
z=##;K+O^3Qz^Lc4nH27J90UwZj7d1<;hj8e$aLgkObJBmAca@0@MsdMuMO4Hnn$X=
zHPwz~4~!+zSRjV=XG!YrN%W+eOdRN6XlD*K?$DkO=XI*X<-A^Xx|}ztE|>F0+$f~p
zg07lQx42N))l(I&s;>-SLx!S04^qgFN5BBJHR;E>MK{jUUqo($o~x*TCN6Wv%Z~ab
zuqhe~MQD*VR2dI}hQ+BC_SZY_f1KkSIvVKrI6ZcUfet;L1&pV<*}z#7(G
zZ%Brs5p46Tste2JF-^h4P$>MlR!me|U=tm64ugMgl|?*Y>zMFwxuX8UmYNmWkOuNi
zhU^kFI;vLW}o2rC~t9Ee1lQDi&*?(^$5=43YdRJEE=O7FobKu$RHS?G*bH$1->%K#YmvODjF3k
z&}JU6rLqE3k0gw@NCWvnlPnfU7DgHthZz_h(nEGMhMi@&TELn`f%=F^GP*oUTW+ze
ze;flNt{=@pwl_Hq0Pv5SxT!wyG*ziLd7CKiZINAZo0Ka5I
zvO}~80`e7I4jYx@rSVuqxDz$>stw5w(jo}R-MXCI->idTaC*&_Xa}1n4B$5mS-b!d
z?W|4@C^UpO?WwlVY2v_sOP8*1sHdSLRuieLst>S#(Fz8#(e3avA)sLoBSdRxuC+M2
zke4|%1!btgzh$APE3icX{yQf5ip5bYK8BQcv(WAF(-46FzDd5Ws?Lg!q2+@tbbI_X
z1mJ&Ul8-J425M`mc5$}|4T)vw`#;XcV6Pz^11kP*LeL6mR)V1aG&_sEnoJxh`pkr)
zmDH>V4Pk?e<}#u((^%{kr7?;5+9@U!EvU?jFan*LoyA^JCJst;nh6D?6wYxMVH^^5
zgT{BdJ=tD?RUY7*Owwe1bcv3Qrgx?-)gIa+4dk;;vULshAR1Y
zFEPn$F{{C&Hh-LjY!9CX0Qk#UK3Hw)MRCY|1UjKBY^jVbmM)FioDBrve_{Y=MU(J|
zmo2tL9X$=(Di7?d4RNhp5*vQG#+H~3+bR$2pR#xjxuvqIV)4SNC8BZCY5Z0jTDrS4
zB!PLIAy?fH3CgZ`8jQU@gJO$kNCE9eLx$#{INuSqhLg@riY=T;40t!OR3(*|?qQ1H
zUMdDeC%(;wl#ZAo2*_IuISfEC+}}oVg(ml_41z73Aq24PhD_zsSS%9I=c&KWq}all
z#DI63Aw?UWH0Rx(mTilq2>|9!gCBRx(cPF-M%3wVG6=R%h7iDZK&D-slVgt<))r|&
zG+Mv7P6K@^D+7b0O=^uMD-6^;qoJT5!E#R}ZW(RBEofvo=F-pFQ?1rBe1LMYd}dG0if$4I_Q`IG
zgK*M-J5IG4IK`Hj71lv#wkT<8vMi*5rWy5Lo
zyTFc^9aobD>_uskxb?P9EN%hzhqlE1a>#@3P^>N<3u8iro55)(j^^!$GASCe=z;A7
zVez9v4oeuA&WLryatw%%S+mWBXCM4ROtEsEwWJ`F2Q#2#{XTC8EpggBlci!WT0L
zc337MfbG&{aOp!XnV|jkr)Ap#=>mXxS?5P}YdEOMSJLzCfD92J?PiJ4(gnf0f<4OYGDM|jPbw>+426j
zJv9T@MjY60vve(H#TDy&l7XfshDFW3lR-#FOcMgwd%6sOu$z;yP_^%;=i5OUB0&03
zm!O7)S7K?U{V0QAhh-81*fkymvzRSlt{H5olT&Ln(`z$HjHk~u?IZ#DQW(9P4C1
zx1nW)HDrPMOS5D+Qmvz+x4OxOmKD{I1?tU)B(&kgRBPMih{{{+h*@wg(g42IkgdkV
z*o=%A-EK?G0&SHC_J11Ewb8|9X!J<8*%7lKTciPehanrK>kuaBGMvoZX;01qo`wMU
zyA1iNWoBp767$`5#4OMjX#n4A$Ogk9v(;!J_t_D%09&L1{98j7I??pB@Sw@T19rqL
zz!qr$KWNC}872YRr=kr`2)u`Esac?{^1yz?kfyOPCQt5Z;_+xENutWRhu&G3Bmw!j
zA%{TM5D^kjWDv4gX@~*t_l8s$PhARO?UQ>RbP!M4kR+s>Z|NqQMFIMhRgxbtBw*3t
z{$NYY0c?l^`WZtShf3X2C=oKI!U=QD$8*%GhJRBsj;Sot?$2yV0D
z*%lsr6|9lVU$klMZF{l?EY2IKVbG0Q=?H*-*D8<4s0Ef_2YaMUOq$S{y_c0k^M;KQ
zD-QI0kOiew=t0-^VOEZP(Ze{<^RW#I-y~1yO&-V{|YK|%~0RVkNo~6E6IafQo3IpQFSs8NZu);visa6zpUxpG4jvKR(bEq&w
zK*8x&gsQp_mXqrjiZvi~=x1c3=TKn*fsQk+7{L
zHxT5-33^UIt=ut+P}*)s(~Q@*JK4*__S;xI8U}Q1SzSY=zBqP!20?<#*d)X>F~I$X
zrK;)5LUm7l2W}ec=;VmOsrFrVG|f`cd{3%gEpjWs3uW>J|ZP??i=e$tq!$o
zZSm0zf*qhm3~-MdQdRBMbYrGg@+UGWSpZFfKzx$r=uB-P0#y5z&0vQuF%wr4(|$!0
zcv_egs%|Ka(~_24onVX0(ce9jg)Z?;L0fHy0ptIehOi2208Jge(kpZ_`=_iNxwKet
zpl7EE1^aNUCBabld=`2(9cdWQ@M0Q*#RA@C{^zV5xwKetpr_x8QZB*=MR+NlAW^kt
zZ*JyX4KSX?fcA=2NR0g$XkJav&jrR(0NZU95(7LM-)rglxxlpH{7n`LVZUYtPO{3i
zl`JkUF#no`ETQE(2bI|t0@e=dR+ZTX_kU-hOATqkoq+)je@jEKRHdJS`|Ye8xwKet
zpyyo^N?Kt0%V{2$g`Q1E8U{3ckcMEffP?$PtQ@(tSa6`{V-pHG93!|tNhe6u^x)=d
z(1QC@tB@Yt|47fz1*Qe}2CvqDSce|mC#UD<0@H$fBMWJfS(+Z)r)42aXq(`+K){ik
zBm!Tdtm|kNmj%#n&dea#fm*}>cMeNo#R}I!>LV+7jaqa(IFCNpj+lv>DGlKBO|o@?
z`k)CJ#%{KyW`nlK1N%agG#=wxZ(w8Sy2zH84ca0O=pUJ+>r(9%y)Drb*&k?a7u(S!
zu-u$YktEz<76$H*O|pUR_3gpdhEqJ+1ir;7vn8jEyY;yWE(IylaTugyZv
z4sU^gg8RI6xYLa_hv?D5@&X5~>fN77(r~5ScA~(1z!1dKdvr_;u)oWsWP>zG0`eh4
z5YJ5r;8Ki!_VBO`i9uzDp&Mxy1mt5Z$8DZ2!(vN?c20|l{^Pd9bXXf<0RNXE%iF&-
zSace{w;|brngs#5!;k}-X@)Jnl`)&w?W)fOEf@Kcb%p(S`iq
zW|A09p4SU!aq)CH06xf4bxW!vrS!s-E-Y2y;q$BGZ8*geyG>~DdMGCstI_v&kfI!T
z(D{f7ExM+ot0%rL+0@g~CH28Ak7nh_rYi#ndLB2UtnE#7B~iW(ae`2ej_rvo^sG9p
z7|`&06GCNbT}qyo(iHp2Oj0&nLlTfrndDF*$-bs!XS}B?(b-AW!b1-#`wuy}vMI8~
zgU)A6Xq6qk^x(tJu4GfHJJq4D4nLcVC!0b$FzEY}2`h?XW#~f)JeP|nn?5@*=zHFT
z6%bDb!$Sm9-FPIPh&cqq3%Pi*>9YfazFj(288xbw-fmnEs0)Z05VfcNYz+2_GEt!9
zWh+Ka7@8n8c?o)rc*D&P$}
zS~g^}FmN~cf*oDS%H*ov)$vNc!Lzbrq4~D^ld~~s3iK&`b|C0EH3KG!a|wD>1>VKO
z&d1oWF&7i-lc%rgs;pR0ce*VSo+3kUozg4&jGSD1Q)ohi#xrfOY8!%!wvST-b)dl%jbKQ-e7BRF40uqo7d$nI@XW5$~4F`&Dvqh214AigPo{eE|
zN(2T}+?j!}1drej;K2{rv(Ix~#My6hG38Qa#e%xK?U3jO0I3b3a8C}Fz34K4pz1z5
z9NfX9sX{p1pMzyDsth2gdcY2c9_XX#!Z`Q4Ts(VGW`csYhwPAoHH$Q5h>M4FuATs(VGW`csYC+v{w>NH*GivBA*$6hq)Fwpa)9SS{fP=9U@
zEeP(&&9xVO7C7j9(HF%_B9^+}0@;+(0#O5!V;@A1%g4YO#St{ZNT_S`2x@Iu($a^hyKAC1a!TScA
z4Mw(J<1&f@mN&`c;2^(i40;`a{#SB4=;VBju2%%;Z;|gory9`cdToF{U{nCOjL}!)
zHFC&k2<-9ETD6_0E9VGL|BW~RMtmBKE(3)3e6;FghfqCDAiPf;Kp;L1L6-r-b;HR8
zk!84lx*F@0^gO-g2!|Pgzzq8GqhR@&rcQoCO7{0D?901^^cP}G7te~--z|h!KQ`e+
zGTzh{!jnC_1Xbo3FKCb%`XgjvjN+m9X*@h4`}1aj^)K|O*^;*%t_gS(LwB-kU9!1U
zJjdQKNpa=pPgq!GBwfP{t}-J#&pqKdBc-|~EHR~=6N09cW5NnkN}W(|O5r`Lr#W5Y
zS1AQ=D&tQO1SL!_Ti_T|3c6JFT!*vdw@%jtJZaI89CCAepU
z@VBaZ833e$dancQl(%qXnyC%x=AX8+T
zQt%duIGq=IH7$V(hzxN-1kV`u3cF?*C7G@ij0f>5m-9hy!Kp61#}0)LD+TjN!sC2V
zN}TF8L}n-j$AP*huZSKftUwW1$0|LH-IISbx}&f@`X~i+o$4-!t7ON}bJQY!Vz5&1
zM>qUhL=Pw>X~!g25k16G9D9rSDT^X8tcYIaz&!ayxXvgJM>+pCglrwE6h&)b>+66R
zjYA!8auGe-M=%!`(UWb&@zf%E=!-ZmEvmyK%w%GEQH6dyyC|SD&2v8QgS9H060Qbs
z1comF2o9+XHAR6+d06W_Z76X%6~aa4NuY>OK(;BMwu06J
z4+TUqos%}H$_U}pf*o$WmO@Mpl!D7$Dq^W*>#$+YPb3oFcWgr110-^9Oxoru;^&@-
za(nS2Wbw!r8U_(CZuP%h&XWHg1_$Hm8-htGqGvgXV^mH+W_yeHF$<#b!vJKOj3@<1
zd(`(_&gfOcUE_OaE2yCHy*NuNxXLrWcUn1NAw)t5j*@}=4SwgX!wcHH>UcP|Areyx
zZuC%7dwjU?%r1|mK=*nOVQLXhCJiuT?8+#Ls8^;#m`3HjW-m%V~93UV~
zj4)fu@0LQ=2KFlm-8Q}`9I6BY>3WhAXnK@*
zniKFXCH};TSt9WQC(u0+rJoaU3ngCVM7c=3&IuHcC~u7~3Wlglqr@IgNSSvzA!R<~
zgp~RFc%`RcqbID*A(euy9`(0wXUY2`8!d4pZsj8vQ8O2}--(pBNZbJ@QfTRPGc0Z&
z6X|?7iSAJosZmApo-mOdU4;8F*@cctV~gnaZ&*(n{6(~?Cliy4v>Q-lMzQn80#QTO
z_TnGnm^77PP;P=j-vAhyn6AUfjM>h&Ghskm4VZZh1CJ5R0)~-^N*zXK)HrV+nPClR
zzXVJz!@$=B6J{8hi0LpgW0?}xChAJTDPDDp$62!D5QIwxa=s+74mbROhPVV+XxG8oK&TE^
zV1zTSLL;FJJf&A;{Kt6bRfh;uFs;zsjn?`jh+j9ph9X_7+93%S;>(D~ez@kvPuh{CGeH@+cW&2vnPKn2CTJwYS@QO$t`$?S;29`RdwD&W7Nxs
z9?a96XtD>d((33+^{iir{R?!RTv5aeq%8SLBQE;J`OS`E=Gtf>$J#nYwleo0W7M05
z7BcukJ8<@CBJIs|%Dk(`s&`78s`&MRp~!J$$!#7*!C||i%=_I~^&B_Cn%rWNHHj(nc8pW^NVXte1=|(Q!Z`QLBK0%FmOxWa
zYF$#k*vtf&X~$hf>UqO5s>k9CQA3@w<`iY_2Sw^N!!o?S58CGb+^^myC9B$-uyaML
zSY4Rjd#7b`kmv!DOty9E@gsAw&s$^8cmZLSph30;sUp?WEu+kYX5=dKo|~XPEnQTJ
zTg1#pTZ30O)fD5(W9}^z
z)pLgzYV%Rt1=x~8Bb4z<&c|C=j_=NJrZRW;M0NY{LTcbq#9)wKz-$(4T4N(~>Kl5*ZWRg@tD9C{J$>0SdKH}uWMv-nl;c07
zt?$ytYd+}$0lhDqy^D9zwoNNR{H`zKz3Nl~EjoA&@;WXb{$VX{
zU)Dl}6TZyVNzzT9^cSIryHh77=}p*p<@wY?;-GrD9^V`Ay%FD^<4bh|kG3Ux)^N>?
z%~3O`5$#3we&f~Z>Qs7X9$w!xXAU-9#cJr?a5|bTR9wAup4jps|iVJ8NKc;odrC28&_>ZRs_7gkLpiv
zR`i}NtzEsUAEWiYfdpRD7+=+!YVAq26Cf_3y|32bG0b%5NHs1zw6u04dZysTT=muT
zC?34?5&A#SS!%(;A=J$KAJZ8>R5iJ5P#>xF0lYIU9;YWOgzzrN;HB*ebjTeJd^D7`RGe5Ux1*2S9lLkxa7)1?<6i5Cayt^ONYtc+ZZS0{t=Fl1%Zgj3=(8NtsO)d?PnzU!H4oJEuFxk;lHuZ(
zsj+<)p6ZVgz>@|*`F^OLDkhy`oF<%~crX-J2e3E0x-L+S8UI@zqfClpz?2FrjzJ??
zt~j>(jL9sWDc15_xB~w%OSYaT?#r}ZQD_FOof%+G{iItzZ``Nz0xABbokyY|{BgNl
zJULNZUYGD3P88gD6L7})0vJqnPh6CQ9RITK6_@I5qBVmsW75gRCOim59T67LlyL!W
zVpR)96kM*X<&%nJSJ#?Edox}byILvu44#?$xI;Z({hHSKh$%;lf(w0EP}!u!<9()8
z1!Stq+)o|qMd=b!-~wBLpF7pd3;_&Vx$$>8)t^|{bAn&(Qh#c2(=e!Yo|Zz0!mLj#
z3|?g3q7-2DV(x1$^#)rQi}J~EXgr=Bb)j0?p<>!B2ipyrDERiQGb^%x)-HV@*R)*geIwVXE_UZZJxR#O(2IRW$t5n
z>f4Sn@$R)XE4)nvv6@qds5iSOwIo(`oB3PJk;Z&?48fzEC%0fgg(RY(6
zh~M=xeWF?H7AnOnL+~u&ajjVD=pn)TbU{;i+((S(`tbPPNv%5PBX*pR5a)mT@W@<1
z((R79F<U4b5pu*lXj(OP_Bybma@yC+rkBl_Q$BOX
zv>CJK%$kE(e#XJ0IU5(_hjY-){QepA!rW&~G^oX!#uQQB{Ni4Ijx+Z8skTM!(opfi$95`Z37D
z3@6rRi%O>G68AVY3f|g_>%W>rNrs4_uGs;;JY+*{bon0>Yldv!I<&(qk;nZ0ag
z20wAz@WVb>Q$9V7UvLvYJblWnw%*nryc!@rt-KG_dweq4iJwSuVk)nOB>dm-7q3M;
z_wdR{aq-%j)95(C*wbJVmh!aBK7WZHiz2jfTRWe{()JYpF~|79i5nPM8LmiuZe>UA
zyRx%b*}iF#g<|`&n}43IuMAHeVR4li({RCswk|L*j@$=~i!)1R0A!Un)x(vuY8#fu
z8}QVxy3h*ot_!>fs4C)*hr1H1+YF?@wm{9{~6~!xIRWVHZ&^xb^?^>YU9fY;v`7h
zv@KHlRSyiG@=S*ZQdQk>q<)^{(-fMJzO?h9s-qj}RXp+T#JXf-cUuBaL1;>Jm6w*!
zXl%e^SyS!7MAz<1?|A*xyLMl3$6qeJ?$tZ)czyfE-4|bKkYBy+&fQnulb+sv$L80r
zI=K=1Apio%IIauybak}0CcF6ZB0MWTHfLgCDk)tO=l_v{DM^?|
z*kG-XpEM1wczc@^6i@`p-0^6g3e1q3ZK8tjmU3kMChp|qgk7k{8G?sPJk>5@ymF`xz`YLpOCUrJ|
zSLmc8?Dd9DI`TUIFboGKoyTI2wa`g)p_7h;PCByF$q`lTQQwBnox{RfKbEB4q?d&aUC_ItsLxct>=I8!tQkNWEa+$Gx&*pE;!
zHHB5FT;OV+dN05)Ja9k2O>veL9OI8t@a;VHQGoyV{(zerMs{%O=9hlEO3IFYb-4Npl}@MNouy#1&Q>ajA)Lz#MczL!tsnON}HFq^V)6#d~q^#+vX
zPZMyfC8lqOBFGmav$69Rk9wArSnMQA_(20OatG=g=az!46#mJv1uJvpB(YHsRD@0UKw
zSN{lO-oXrcUyM15r@n?U6ed<k1vsG=)L{1BF+DxZgl)_!86c4m|g1x9IoNXr4+Wid$>SKpu)_eFq>L4eh)KUjm
zLQWmjJP#PDJ_{Y&zP67#S~Fet>_~O6&|Pxsl>JbZ({1*u$a8^F>PJvDxIe0Lde2rBJMibD)Qw}@CA&&2
zi%Pm9Wo5(<;_BBTj_coUodsqaJSeMeZd}fN;hwI_aIj?FXxy$GJ-${<_8X
zbYvOB8gg3O&qSsG9(jm*8IZ3zDkpOG3Z|Yb1DPwf?GW`pfP8MLC0^5QmfkpCGn(B|
z)Va=_mP;lnJ5_xC`_Lik#v*sghq+Zr_vor*+t5`}I;Se~SNUl5e5iV*EN7{tzjRgH
zB21;CbS_owz$-_qmqFF<%2}2DqP$(j6t(q=se!iC)YhHW=Ddfhr;m4++%j!c`e0=&
z_uGXjBh#>oLDN{L78752#@1?9#+9?`Q1w5dY|Hc<%4F4Ol`d+Aib0c#eN{%)^ZP^9
zH=*o;8Kbk8EVs{!lI_W^)$4@^^NaehZc2-Ia^gnCqX}4=L+2H$Kk;L7KGUCF?Y@^$
zbg%hE^yueKxq3v>qjcNIEu+~sIvOhm_)Ocl3;$K2`V?$?WL6HB?0aPk+YYeUM$-AZ
zZ4@7)*fu&kIIC?mfod3|ZkpgOd1kgvY;@BsDb(Ja?9*n#m>HO+9HwhgqItC?`YMyH
ziS-&g;s%XIWECtP3mdVTMmHnsQ?BmL1Qzkq>hiB+)MqEUOWv5XpElXo@7`_7Y7N)k
z55}smz?u(^-cM`nYxIj)L-jQr_bbDi)8_4`HFnnyi}svzLCL?t0UN=_6_wz=V*aX
z+cAJY3+(w|KgtT9PwcOKLp{YM&5`Und>TK)Uvi9kuIo_R3&K+`AkUYE5WZ!9=X}Dy
ze7^cC*H}J@r0zi!R@~qV{!}}*+SNIlyL;T
zEQBTZh-R6=RPcwxgws<7cBb?-Ke|2#JAT%g{0
z*f{b7U5%mvlRE0j1uOhf6up70FiMQHEN_E~v$`L6=3X68Up(wkO`MvVh?uKcoE>Qr
zN8mIjnwqF?G`9g}sAujw0ri~24H&(q-(eW`g$V`~ZiPX~*Kt3G=V*-u;wA2Rw^pd1
z96p*1!`)?F$0tS6s6?Rz7c8_2KUX_CLy1FaDZYmNGz2Cxlr&E>4R-ykQvDzU
zz+{^QAp58w(nR^YO3}=*v+cu5_0eK3GCK3)&EB%Ls##jK7QYQD?tG%ir^BX>ZaP%v
zeOjfyVFKKnl>|smB*3E#z@s$4?6zwZJUYbiI8GyuQk8j6RjYSS;Zl*u(@I7v;cL=p
z8wc4+_WVM1XBwzcIs%3N3Dh<|zQoeaeXd5my@cDY^-87DikD9ot=Q6iQzPbyS)-Vh
zHHs^)jq7=i*0>(w(V#Y(FTPR_Mk9WsaRnBwY^P`Lvmy2E5^lFv3)mm<13N)nwWWgh
zDdJHO+BIKOo2IS-Mxh4D4EhmK+Jaq0qJNb=D%qjT{r$1(&yTQEtalygG51L^btX`Z
z9*GpACn3f7$)fn7Me1LU;D|~qu{M}(-ABC`dPT$GWu~_%NApUd7?S1VT;F#;gWyjtFS00tweUbRb1N<
zW+Nk~*_k^@6Y4c$H4n;GU0ETif^M)!^{Y>(zNz9jD%9HHdwg
z+n&An(wKTs>Ho)kxh_XpVyTmFe9B|CmST-o04upU%TV`d$rVV7R|T3=GTQ;|6uPx!*9&@fvY&Fb@VT
zrD9NMDU<0kk=8emHTKCf`EbhQPwii=%UTjc>;<7rqAeU*Bgg4
z77~%CY}z1%>qeB>6_UeXlXjquhjos|cCodNd+Uh>7v{~qZkhU47L)Zss(5NvlQSl{
zWEG6V&_u==0~Hzf{}_9(AU)13O|M%$3Mm4hw9;y2W~ANL%0$nNgaYU~bX6!rRI>_I
zT~#2v=cZyWMiC0d&PHs^MvSy83555KAORAFFodNA2oMBFf`qq(_nz=19N|5nW4_Eh
zF7sc+kUc~_dGeg^J?H&0vwnkrS=1oPDNp&~uT9D~{-gix*q?vB=4I-6x60Y}cC0*O
z+|kU{eMweW2W)j%N3ro?9q?b}885UMxBkcf`1#-b`k&xO70_E+;1eDj;EVTu^{e8q
z>N{T>)CR8&?}5*$fRBXz|B9cqHVu3YK8%C^{{Johp1$6)t)&YhHVpXH|5N+`KGFd`
z7UEa`uK1fSc+1Kl{233$aF0Rop%cIRH}Lxle39{Ar?(-%3(|-E8Ugt7g3fOE
z_9A%YdsF)${8)8F>s|&F-ly>rzKa50#|&tTk5vaB0EB;lnDFcT^zd0uUEPiF9Rw{M
z1F{bbg5_+1PrHDKbpTJS0mCP1(7TlS;OA*fstxz0$e70D8gOSrj!vmYVIlrKDoXDr
z`FAx~DhOD7r^>$v+ZW%Z0&jw;g?2XJdx_>jAq{OW!WXu@!SC6EH!aPFzr)Wv?7$Cn
z9N3K?r}82E6@6kKe0X(xPyd$guHV8}HY|X@eFH8;{?)(kfscmjh7Td*&nCmqhgk?e
z!w)bNK^CRIqIWmd{pvS|e)Avv#cvM(2Hs_M_sloKhYrIB070SnzMkUm`CDA6wqDJx^<4wfC+8Pk42@JY^88*6
z4Q-9}(8%@K7d1#Se_uYVL9Z@g>Vk0j$Bw{~5Y#t@>hSYwV9^&6)Gvl87(k19r77SK
z{+CJdJJKlB;$Hn%?4LzN~DeG|v;SW&D)mmg<{vgj>mr4cr
zi)=X}u5ZDu$X29;%NAv2wkR>jHN$zo%-1CXUo1|%s#uy5GFzQBbZTCkLSy&>o%HwV
z@bn}8FZeQ>UiBUQ>!e8H|A#Lh#UJ+-fA!nn$^YQ5E1y!xK3Ey%r?S}EjUynx$^+)Gs)%mZ-SkbAj;!&-pb
zj@&C%9Ot(Kxw@)?>o~!k1Xfjy%?W4zfxxPgQ5gVt_3G?ysK~G{pLln#H{Wc0t%~FG
z?&;N1&EZD?!D;vQYU$h6_iz8YHj*)iu;kPTAF^G;sHE$zv@%t
z>_V0YdkuomiSMpD`HP(7AttL%|01V(xYr;ES*6U2oaYe&tGY2=t{jDe8ZwuUy89*0
z@fdPdwYMf
z-eaO_U*WT!q2;R@zE}9PKN9$ARYb1$Jk38vCD+6PkDqP7M?AGjgIAJO=@RyMkQB()5M72kdIEu135Zqi>!9
z@q9R5>T5X5RST1B%OqR4*Q=|(a;=js+)o@nqU@
    +#0N^dm0|{mqG6sY=h9F-8!W&q@$6naxN7|4@-5Ue|(xqX>Mx
z3gmSh-MgW)YPpj=jOpFkP>FH0vAy}WE8l#AQqtIu>)qH^pY>q0Hu#JHDjCmQ*WbhA
z_J5g8e{m?a1br&V1PNw=4cPZph&WM#S$iAsMLhK+31-%9z?U%MWC>;_YQR@8;uHyH
z&SSt=G2+`2%&fN
zmO+sWMWpq9Pl95-Wkg!<_a!LSTY|LSGbAY1TY|LSGbJe2TY|LSvm_|iTY|LSvwJte
zL%p;=2V(#OgZh0y7=DF4quD|5qdEK|xOdk-qL0JnJGbmOp1{LBBbWo&f^5xc7kKNlgrLXD(r|vE?;<
zvYD@J5cm}`gr&VZ;e&jtI5w?Md(#7w{{Q0d{?EGnF^PO;LLJKGe0N1D>eugkH}-$6tzl52@&`J
z4HseXIP`b$KlJr+jeq;U}KNtY$KySSL2Z){m2q=Fl0MNnS>E0hWxI~rblMe-eJk%S0
zj>}*${M$_5!^q$wcqU(iBX~x<<@cC;764~F+MDnA0i^#&CMTW+0C|i_JabIuXFuMX
z?)XD6e-r=_PY{PK<^uwkciBm(rU8Cq@H_Y)nIHabwkoHP!Ikq&zH+CL!Tddw=YFO)
z-s1xU|0BR4!LZ3w;_PMXcnKK{<(WLrW$pxAC7&2RKgy&1#3VXI
zOy(}}b8onx1`O}2;WLK*<-htnnPGOX4Mki*5KoPNC)N%BHY?&PGANK|a)GWPgU#TX
zycw?d#=Cc5=q6sAEWfFTgl^zGVnTi%^Mrmu1}(`mxg*`|&A04G@x8k|VR1JPr@Yl0
z@7V#QTX%uwxAFkpMkRj_kXMp#}$*?
z`93n(4W7w6;X!Y_bw;LMS!I4h4H-Qorl&vOnkSb3t5^*_K-|5Y^qtpml8OWQ
zUKkF1+#Bz#;Y@UcU7RGp-v;IhF+F_So}u(#qEYDpac2+5Jr&1c*A_^4T;9UZ=|S>-tUv-p=jMT
z56zu?vOE-xxaOg`FHez&qQBKVG`G9A<)LVMH4n{QaH>2MF9B*EnqLmQgNJ4-tF_OU
z@?B#7eYEeJL0Q{OlZRGnpBA=GxDY
zhgNEz9hz%DQyyBWeRgQB{VaKCrS{pOx%RVPfF~2sE%
zT=fD!dw_$|LkN+gcq{?v?icWCxvR6M{!Q#4d@0$h{7N!>-PfM%r%mm+kBOh+XW{P6
ze)ChD7~6iHmWRidZ}PmIjzvCoP!mLIePeeI_FTv7^J6PXL1m}4-8%#=toVV*W{2DS_
z2>-(MY!3dReo!~wlv$1+Kc34uc==gFQ*>s2o_Ib7|4>Gzr>+-r62XCk+Wg7k86Ec7
zMN38q@uc5PVPbdKiKuh(O0bQoWKn$^{&9s<_p%%64
zUyQ{ti`wPq@x}=nE>XMsX~2;ip*dSpstC!EhBOtWf{+}Qli|{*dXOATWLH}UY~t|m
zx_E2G?^_&aNt-FQKK#K;mhp}?xiZ=ZyTlqx8hEezvuk)K}$tYW#GRR<-V}opQ&VZfm*dSY+G+;k4
zEZ+0#>nwcnDUx$68D*Q;xsLVOl6^qjd5-njl7Rp_->`U_t+J(8u4A?zS~AF%%m&y6
zj`i7+djh-Au`XNoMPL^h7Vqp;ws;XqYrEKzK3n!sh`PkFE?ag{V3#`9WlM$OihX2Q
z{GE`@7Mqr{{n(N&+q5-6)K461v*p4tgHIi6v*p5&U6!-(NTjW!d~;ZCK$k0*g?qyn
z7PYA|id(}9i`q;X#hqcLM#Gr2F??yjl1y=5SY^>LDs2m2Sv1U)c7@d%jX>TM))+9(
zl=g(LEgEJ@Tf#RM4HKYw`BtOl8^T%xhM7VK!kT_((I``BKtR8@Xp|`o7NF}iTD}>q
zH(-=$+6y*VG{_XE3QoV#qCuuORDf>MX!%C4*?>`|X&=~PQJ-nH4Q#cj&y<`3GTo-p
z@=aj70fS7*Q6T0Hi~3BnEnufbU8eaC@PkInH-KFR^qI0vLZ-Vd>M~`Q1ayx@U8cGF
z@6~9z`R_BJ%e3(R{T8*Ea!uHL2P|qc<(d#Zs8Rfdx7eoWYK0s6kO5t$Ts+1+Y*CYG
zstM5}7B!isnh-rs=pWjf;SL7=jbGZ9#m(N2+YH~C_AB^C1iZ^cux|!tQ8oBu4))8y
z%=pwtC-?QRUFzkmmzKMioJO1Nl&qeyiy73ctwzk>j381_b1DMY^r0PcxbdaD)F-`o&3_ikG9x
z6Zw`QedXjn5OatjedT06Kn^veubli8$YF-`m6J;XIlLg`v1(7}d
zX|@D|N2Qr9eW1Ch>SRlE4C%|xY-z3`echQY%`>DgJhP?whV+$Zw)CMQZI*SpGcC}Z
zuRJ%Wg@&{-@wYwj2LxYaNLP7oQHu@fD$iYNi6L#}oF<-qsUpp}VXm_*Khm75oXf$8
z9~;tE&gCHai6PC|#fN!(YDiOgDhFeJW=KjgF($WTmWvApvN*J-=wgp=H%m>HRx-m34{}G(V(xH1`xol8uT@jO#rw}
zgT9!|!?#P&-c1x1zC&TYX7&;|@lFl8n%PPK{6T}RW;Q$kcWKbooZI(q4ceMHMbvqZ
z1kHVfFz>wzb2W1%7;m2jZOvQ>g8MaSYvxK2JfJ~SbE*WvgBmn7rxX!9Lf{|ZSwRo{
z%ce+XN5*|rbFOM4=^Ff)A;Xwt-Ny}S>*ko~-6srb3TKea`=lXFj4p!UK6;kwL^{;uka*Rt`-J5ic4t
zsvNo)$V-L{D#tbk^0Fa=Jh6{~{K=3(Rfpo|D(D;l3;SZ>6z!AvMPEF%KhUnb^Y
z376buQqEzyLA>NGlXDKr^@ErV_mmuiGCY<|_S-pz<$5lg>!}5YWq2?f>vwW6!_n2$w>}ea+N^frzzsR9p<|lIRYtCCm-uE*M8Fm(34$L%UAPPjq=AUIq
zR}Y;XyMMMJy+Hy>{r^EuHa4}^|2epWg@K2Nb2JxL&Lc3_kWuA41@jCURnBuT-;hz|
zJP02aWc2#j)ZPmUDtfIg{K^1pUMQ)kV(eSs7AY>M7uy!N#W@G=3Lkyy7MnIC0GAjr
zICnOIOD*b8pH1OMIr>I__}o-`b{axV^W&WB?s}uMso9Y2IlLW>Hbr*M{tzB
z$&t?H*6c;~MHHN&Z*yc|@w(g`q2XDZBlU0QFU`*p+Bd!{kpAuNM08dBeU5Z@H#meI
zXspW-{M6lUU3KcNjm*G?+%m8p-xI1A1{ZHrj&!vK2(I1c9Dz@p#y4T!^xj*OX`*;2^
zL-9*U>7+kO%Ju*|H=gsX#OxAtW{91Wn5lr4mn*%HW3BCPrrAli4C$FZ2D>OJlNxEj
z!7fS6q?QW6XqP2sQcDFOc7?Fc=02T0&Bbdj(;EW&0dQ3SgIZg&yb^(Pbxja(ai|G$
zsOtsM+1%cy33B(FiKwGAvZ_QHw*&xb7y{F{EeLT3!Z9d~I|YGh=opm7eIi<#;PYPE
zn%o7K&EeLaKjDaVb=pUH0N;F^;~9)!*Z^x_4RRktM%{f2rBJI&w$>^sqQYHfA*;5T|v3*`Ni;%
z{j{9w`h#)nKE-x3J*Qgxzn)!or7;vX{9cZAwdB{w2@^Ivi?HsNKHxlm%CFefR8tqt
zF1XI_&R{v%c0MSu7Pn<4p`g+^1=jSZmh9c&`C04mjsi_*ZozeRTduh|f6v2*%r$mH
z8I7%BU-rQ#b_)d8{aSVvo}ZW668mVOwsY
z)Oa5m(lt!p$R8Wh+*FHZ{w$FLQl8=C1j_SsL)u@V!5XDJml@Lh;)yw`Xt^QH3#LS#
zE17J8?YOcXzbv?_c3f3pRqgmyfmOES>Vm6m$8VTx?1nO`+VNY#Rkh<<$yK%Ex&*f3
zi7VT2y&=onaf2bt+i{~I%iD2FA_t^A%iD3QAgsh)s6=RSJjS(Bv;jrM-$kJC$4PAV}>km$K!@9
zZ^sjcEN{oti5!sfEN{m%hAeN#9}QXFj%N*7-i{ZD?8MEws?9DISXG-{DzM5nyIgRU
zZFYsZnw#)d!8Oyz1epuhw7*;v9DH_Q`6m2J0&8!=Hw{_dX15Gk-e$KAS>9&%5?Ol_
zzHi9#HhW;m@-};D$nrLO!X$3ORc-dPz^dBpS%Foy+4F*{Y_lQ%Io`f?*4$i&3a+Zn
zh6%2+%|<4$_U1aukmYSQ+K}aKHpY_z(-!_Q6TDkgi8d&clHlX;5CUlg7}{J>Y|?yN`;lTy&X5hZ$H$5>DFcJ;@rh#M_V`pWaeI8G
zn7BPYS4`X<%M=s0$8yEQ?eT?TO4?(EhU`jnd#u!uS?bgtUuwv#b!v~*3^mtde>9s{
z@TC4&qnWrtzSfY*wi4Vk=Ci+rmglXvQowHk_>oRL`85elOVksl?N^@PIcTI8(6vaV1VU5=cSSk@O30~Mfz^AgKC
zLt-EUU>78o_lD&7y5yqbA|1FxE-5Y$BK62+#RW>FF8N7uffV?-9_sj6ae)?)9&%R{
z=f%MEkh`iluLh=v+%?5{Iq0_uz+G3I*8|hTcsC^1*Np|GhuklUb9zvE$lX+&(}U7O
z?v~=59+Vz(w-smg;PjBYqd2Pvr-$5K#aTT#J>>2w&g#MGA$MPKMvs&pat{<|^hoI;
z_fT^Ej2^$JcE6$5Sg8|$G#d$So
zFo2t=I4=hc25^%U=k=h$0B*A6DqL@h;+!5lw-E1b#W_8AZh@PsIHw2CEpYEB&gxOP
z-n)vkdL&zcc+(VT^+>h?+;qiRJvcqo_dUfKJ%sDMuQ;PeN)O}BkX(i9%~YJxBc+G&
zK47kI4cD6^F%u0M8ULW`&6SuFmoRj_c@lHl5{9lfUt(5TqR90=l$cePFmk;G60^c`
zYPcW^C1!Qy)DT-FF(YeA4Y9=%GpeT45L+U#3fEhzxJU<(7UF%RxIl>HdLJt;Py#y-
z;(emHK#JsgpDHfU0y_`leWo}sM&^2-E6%Gyg8}iDDbCB0x!!Wcc|B+_Al?^}t8l#)
zigSAK+(NvSigSA8uJ@(loE|*45O0;@tR98yeWf_7N3s=&w_0&lkHYoVD9-A^>7l+~
zE6(U4T<;sj89h>Z81GxjRk+?-#Th+PdKhmVbNy<#-g=3dXf(a-dK)C>#3c}2Z==MV
zwuGVUZIYOkmMC()%@VW95=O4KMPgQ1P7N1itHi9XoEl==BxYnysUfyqVn)@J8e%&n
zR^fU(6&L9M(n7o+6c-4QTyK}+0wu8XAl`1p1yUr}+oQNZ3+z0Iw^wmqjLh}+DbA}w
zg8}jOE6&T2x!wWAc|B+_Al^aARk+?E#W_8AZXw=b#W_84*E^y(rw7k1#5<}ut4HB_
z#}sGvNVWp;jw{aUQMld-#aTT#J=FK4;*1``^-d|y=#kRHc&8;-;d*BjXY@$vVZ3w9
zy;#Hb&P&Whqv>VWyC5+qE`jKJ7bWJjB@A8flEkdEM3L)VmY7wRFmk=0BxZ%>)Nnz5
zmYCI*Q$y^E#Eh&dHN>t;%&3}DL+qNwDqQcn;vyYDT8MW;ae)xY^?p%Ypagav#Jj1u
zK#Jsgw-gs>ft?5OZY$114s+;CMzxwBDvla#RW=W=Rv%;6&Fa6TyLu40xhufAl^HQ^I~MK_pai+
z8Z;OXZ<^w~9GUA)SDe>_1_R=~C%FpOdtY%*51w0yH$!nwkKFZUD$eP_a|`iiDbDIq
zxZZ5VSv``iK)eqWXZ0vtZ;s-u9-JQPJ6CZ=58-0!M2lB;mN4;5$hNaf=CmaYUGF1_S!szP*ZWvvR$0Qx^*)i96_!)O
z1^HBBR##39vCkxCWKF3d_PNB2swp+ZmPxF_^_D9x(gCD}cwZwTj*
zrw7k1#QRopPLJI6)+)~F!E+1ozEhmlqj0_N6=(HGwgU0iDbDIqxZZljSv@#C)OUm8
zj2^=EHY(2Okn1Eg3Au%T|f#`ZWCFZmx
z3|;RBiCJlhBG=m`F{>A`ag@lGqw>5;qM8O1q0cy1xykBYN;6s~tx
zaaNCHD-iFT;;bHp>z!Ae)q~SReJ?1^=pkJ1qT-AmDLssLNpcmgcUf^pkCYz9yTaV7
zHC*qi#7s1rUUt1}5_94bh^}{CVoqDa(DiOe%t}iXx!x}lv&s@iu6I*nR#;9A7vz@2
ztgf6IVz(t`WKF3dc1L1H)sz}ycO_QgdiN9;=>XC~y!(m^gh;OUKyiT**m)4|q2dB5
zlIuNET%ZMZ9>jaBI4?%#dQTMR)u6$Ecuy7Q<;Yy`nc}=2G#C)?x#TKbZ}2~%=Tba9
zeVraWw-E0w#W_84*BhcZrw7k1#2czOt4HB_!xU%rNVWp;hAYnMQMld+#aTT#J=Axk
z;*1``^+qYq=#kRHc%vm(;d)~fXY@$vVZ8Co{l13lO^}$0M$^l#H&J3vTmsScCP~a`
zOBlM|WQkd6i6YmVA~CBhVdQ#mOUw$(so{c5m6+9)Q$y?>i5Xc_YKXlnF{5fq4Y6qw
zt8l&Pii>mrX(8TwiVK8DuJ^v;0wu8XAl?kc1yUr}o2j@!3+z0IH%oC|jLh|BE6%Gy
zg8}hAP@I<|bG)8O
zxw=|!&iGt$CLYZ%``$9eIem#l<6Evcr!R5nd|xQe>Pr||-wMT9eTgIQTd6p!FQ~O0Ftuo1QAmTO+T4f4D+^#{Z45x@%@6e!8
zMp)ub4H{)qiWu<+1y-2iE)5!GQi>RHZvtz*d1IgAOgx%ucE$aQb3zk|u6RIkPG{oK
z6%Q)T%1ju!;vvOZm5C!)Jghh?GN*^@azt@fV@?mbqlz;Ur}U6JrZ}T;N)Nf?imPzN
z6B>*Z0huA)Bv(A8!9Wx2M2L7=gMlc?70+lePz5^?BL1jBFH7c%XEo?`p<#iD
z=QQYr$z1Wg2E8&gED-U60xMkcq6VEZJkJpEk_MeJxhr1Qpi_qD86y6qL90yRia%@6
zDw8Y+B3{v;Ri<#os~WV*aEhq)H4PeNgezXxpiw5Jh!Jlnu)-C8(V$T#rHB!4C$QF=
zJMJjX#G|QZSG=n@Cp3}hiuV-fbS4g6@xJ1$%!H9EK2V%hnK*LAhl;Zzb9%Tgj}&J$
z=Jb$ztT-caN)NdwiZcqQ^pJb1xC&Q%rol)NkQpLA*I*z?a>c>_CBM&*TOs=HY3xLZ
z_?89(QIabT(O{qob|OR^szEPH=8D5K=yjoCfr!I3=!MB#afAlFGBhj@aijt(Tyc~J
zoiaSn5OK5yoie#Aj?ti-7M^E_I97vJnZgyvY0xT@EC(Wv*PvCVaK#B4w90UbsP#k*
z8fAnlPST)JCZ&iGCo8bR6{l#>D3emei0>q@)|)@xRh)@OQ_Ze8O>s_WBGDD6E6(Xm
z9J=CrinB5kMy~k2;;hQVkt@znoE4eV!*!XdIIA(Ihukd18HrPR$jw%qQ8=ZC+y{!Q
zaK$+qj1&QxA>v#O29hLKoTtG+6YNBYIA4Q-D9IH+)L@_rb|OSvpg}K7=86k7=yjoC
zfryJV=!MB#aj^!yGBhj@aft#eTyd!eoiaSn5b+}oI%RTK{8)od8J=f|_=yIsGKDLC
zszIwvvK)x`nFg&gg)4rpL8}a>h*~expixG+;&KfdWm1Y5@e2i3xZ(;88f8+77;zPY
zeLDMAe&)+p5;M_grr8r$OU$WEAX?%Yi8+l4Lr45tVpd_I$PmAgnAMjs^22W>X4U1?
za6#5e%xcT2A@-fbjIt>;#J-o9(KV%p*gA<-SmAobMLK}A5O0Ix0wIzSZd6>L1oj@p
z+oZTaie!VE6&GlMod@x@D9($Knc!B%c{OM>Al^2`c{wr*+^#sU2Mq?q+ab9M1Kg=N
zrw30i#QQ;UPLJIFb}7#3!E+1ob}P>6QJCKz#aTU)u|T}NinDqY*0)b_Ru4`O_1&*H
zqlYlQ1Bx?xr1UV}LCICv-XX;qJyLoY?S!D?$*E=mSD=epm3vxzcR##39u^%O7WKF3dc2;6W)sz}y=Ok9)
zdgm1v=>XC~ybFp8gh;M;QE`D1*m)4|lHvj>lIvYoT%ZMZ9>n`eabAqf^?p{ISAzxv
z;$2akmm_n%tBUh_&|pBkYm%#Qz3Yl|dhpyryc>#hdgQM6i{hLfJhu?;*C^XAVhM#QHl$cz|Mns
zqZJoOkz8+#;sPzO^B~?>#d$F@*BhreuLcbU#2c?TFGuEj6BOt5puvE66D3#SdXp6A
z^x(OLc#{?9^vGRrisGCeJhu?%FTus|Tlt`c6}v
z(L=c2bj2AxQhFHgJ;_zL-usF(dZhF)-Yn+&)o{Jp5;M_gdfD|pkeCyfKy;w@2JAVhM#rHTubz|MnsA1N-7BDvnjiVL*B&VzWLD9($Kx!$LW^J>sw
zK)lZs=jF&;?{md@J!mi>-ZIHmxZZNbIX!r8A>J2?b9&^iw?c7F51w0yw^DIdkHYo7
zRGif#*$Tv4r8uic;d);w&g#MGp}wmXXY>%Rw?=VBkCYz9`&x1puJ?`Nj2qGS}OqIIji`2E^N|I4?)$dixaT^`OCkc>5(+;d%!Y=k(yY
zg?I-Q=k&;3?~vl09z3@Y@37*m9);^2QJmEy*$TuvsyM4h;d;juXZ7IpP~YQzz`Z(IcgY@qT3Pr5dhxR$?X^O)tCNIf*%O2}IXBFEOVrVd#1n
zBxa>0id^ra#H_M}k?UQOm=%^&!v(o4F{>-5hS*OMGqR@C5c^qTM%9!WVpk+q;d)mU
z7wG`fLcD8=3xr6ncU^IT64-eV?}p+6DU$2`qPRc{>^z8fQ*mC5%=K<5&Z|L#0r74t
z&dZUx-W|nxJ!mi>-d)L6xZXX*IX!r8A>Mt(IX!aMd!RU{2hT0Ud#E_8N8x&p6le8F
zwgT}UE6(asxZV@RSv@#C)c2|4j2^=Eo+-}gk&m~vkdV~LKdf3Ho*3amX(!+Q|
znR~g0>kX5biAK}Qt~Xp_PFw=f^+rg{X-gQo-bjgAX^A4&8znKTEMeq&qa|jA<h?@n$K`>QT7fY{gkUI6c(&1H~CV
zgzL>woY5nthwn)U+iAK}QuD3{HPFw=f^%hIaX-gQo
z-V%vfX^A4&TPiWDEMeq&A4$v#%cU=1_R=)mRyDFtx=rQgXb3FeXTgBNA7yxD9-7@a|`jlRh-qMaJ{vP
zvw9?3fq363&gxOP-uH^LdT@HE?>fa9J%sD6SDeu!rHAo0NUp;5HY(2OkTbO&b
zhU;yWn2AQy%dWRgVoqEF(e<`V%xOy)y50_nS!szP*V`#Et1MyUdOt|a3d^bCg6xu*
z)s<62Y`4UWtSL3b_DIaAno>h-uf!@`Z=d2K9Y9)$w_kCA5XtopC@xR}I}hR=R9qlM
za=k-}3$(z_gLsD(=f%ie?}*~O8Z;OX@2KLu9GUAKQ=Hd>1_R<9mt2MGolu<9gXb3F
zom8CDBX_-1igSAK+(Nw5inDqYu6IUpR*z&W5bsCDSv?BZJF7UW2d9Vno>QFBL%7~~
z#Th+PdKmA5;d(zy%tWKs^dL7hc2izkxFt1ofneUlYu_2u+%
zU8X3`>dWaN_qO7Uz9~KArYg?po69mQ1`;JX@(6akqb;xr8gk|Yb9uE9VP>_dq7
zo(2O^k_o=A!9W%4M2I*;gI<=*24`x}>q4Uf5oc-83zHe)Yz=y4XjmZP2MVmP!Z{jr
z%J4Kp#JL)D%H(D^PlHYwo@aqQzg
z$_PtbtU;qpN)aP2QDB8BF4dq>CZ&iGKS^M%H*b8ZI1`VinqBcT#W|sgL|6P=aZYFA
z&=r>{&dN*}x#DugS(S++SNuY8R%A{O*JXv`tj3%kaw`>QBu?oe_od>D!YMuERw=H+
z6~EG8qzK3i5m#$4kR-X{8Vv@TU?)PvuQeEml3ei{4F;-UCql$;HRxr@Tyd=iy)HB?
z5b-+=dSNnG{9c1z85$OdxK4o;uDD)lH)_x+!}AOgH)+r+Q@G-0
z4O(TAA2t>vBkO
zR%1>Nxx_muoQiFjg
z$rVp&Fi-_M5h9+}pqC|c#WNc8y3nvd#2+>2g~?p;tOmU@G%OJDoB}Ic@w^6|GCa=^
z@qz}OGPx^W)Sy#_=NTei(x6qQaK+0Sw8|vQfrvk8&?-~7;?Eki%5aLP^%V^oWrQnU
z)u2%(rHB!)DX_v7uWQgKlTyTpHxpRv%^$ZEXX4RRvn$?KoD-Tzbj3T0b2<};u6S2*
zR%XJ;74Ip|s!SZY;(f(gkvTnFmj{Zo8gqKcJye{LIHiZ&BgGkoQ+mifR$PTEKG9&L
z2*?Z(pK36WB)Q@<4F;NECql&M8Vp29t~mHF`LngSx#|K{uoEHTTN?DTWUe?wgI*UJ
z7Kk`hgI<`-6^CiiD?`Hq5r-?V!WBno&?&?73=v0a&?%F<;wTL|Wq6(;;%E(8WeQgu
zqd}`ovK)vwR)bcV!WGA9&?>_zqSoUzXp|AII6;F(nUo?%oT$JGSDd6lqfAN>BToOz
zhR%kb#!mRZ-~R4*|K|VryT9+(x99Kwy3ao}r$4~VB&G!*_$N`XCJ25!hko49+0)t7
z)zqzi-lqRVrHZ*0jzq!W=P^y!0Exm1yD?Tt-3CqNBV!8=Ja%ni~3t+2E3YR&q>3|Az1wtl)EhOvP!a
zj%D#7C1Ce%MQG=|?4{5CL
zuJ8VHhwmj2u>qrh<m@Go3qW$t%JG-`1MLV*xDS#X>A(lL39m>_w=gq16#^h
zW{)J>2X&XA7<3<_oh`81K*IlqrQ>?<7ii1CG7^IxWU>u|whV;-DUEqZkZ}4k6oa1n
z%f|W!+?bjM`aZ+X!5mL#Q2+Mk<`~0RXELn2EEw)^XLG8nsWl8n=5PX}CuWzt
zrokv8TjX^OMoR-835$J0gWhfE@&v$}83@A~b^|&daJMq9X`nxA=8Cs72>Z`tnH}EA
zFz7!|(bX%Q@m@|r|2eE*W|#LB7A$fGKG2|BWGVtneW*cqYAOT4#~FzI=dcEBe8iq8
z%xB1#>i|C0pv#ad!HCZ@5c|)b7fMr1wh7LH6u*LzMb@&O>
zuu2Ve@E^&i>t3cChCXmt0qDd6Z7oBA#2lw&D1JGc2`X+v-pMdHd0*oCmYsZhfwq>R
z>Etsq6klVDCl^7*$!BL6oV?K{DQ|PQ`VSl~!e%&T0DoWw<`sBrRrHkee24q!DL6)7
znBlMb)HBgQH6RyRQp8Op<_zRgCfjqx+T%9(B;&HhE#W>V4t9R%=Ru8~S&L>%1p{)hC{)YOF?m?aLMI3Jb-xp+jb%d?Iu7En*JHks7-2K<*
z*dIEYUJEhY)Hmce#BmKsMA3z->9$)YujV#;&NW2Jq5}f8GpCvc*7t7>
zS^%vVz}*Z&{|)H+^T7Bf9b08j&b?8}VYlqfxvIN|15D9nbaQ8YTT@Tj^)a6NprG5|
zXf9>({D%bF)CtdRO0K4{We*FMsw$LoeI}gb_;@qof9-xR>op!=LL(k
zm9bdd1;KK4Wi*y|QP5Oh2}}k4#Bd9kXVR^!d?tP_U=pqb#qzEcC@EKhVs%#wG)Y$i
zV{z9Cn6-;ps_pJy!4}ig^$)l)41h~yW2#Nij_?P9-ZP+ct>XIbzD2EZ6<2r*gmqP%Qc0CvK~9uCR<$KJ}KCaD1$yPXN&dJl0E}o
zF38}SV{Ha~c)fsqUa<8IuN$rUaHfC_{%;FW?K06V8!hNt1=ZN!Z}oIi2sWg^I&6Eu
zv+2|xLnY;_<=i0JFvYn_>AD8nZMfiC1~#+@mj$RdkRuAREq>yNvH&>JfI*hoWz{H)
z`b0?-h&sAJJL1!0V*)tFfYIr(F998E(ctuHPajvHZLm(ZC7^Q95kihHxQ>|PE0YNY
z*U-`##e)+=yom)@@(T`nYBEV-Vabpn#G9cyZp!4`m;BPjdpN{U5t&J~pX
zT_sV}NAm<_e^E&kHPL)Qncq?p#6A9@pvo;Z
zIQbRP+5*IC9LVQ}YQ8H#tj2+SnFrwa1xVF+GP~MYSCCkZ2kGPxa(w|}HIaxs(Hja7
ztBF9~qBj;GRuh4|M{g=XswN^KO-OQcL1Hx#$lLFh0>o;fM;yGVZY@BpCIrdUw-q2(
z6N0p@ZZANpCMI#u*-?;KO$_3M?ILhMHaB)3DCTB&0b(^4EaqlU0b(^4Eaql!0a7)V
zEaqlkL1Hx)Eaql^0irf;@5|@rKmlSk4$SA~U;$z^4$SA~Pytdkp3LUva6w`<9?a(E
zNC9Fs!ETc-f{zv;Ruh3dH^&MPtBF9Ko8tvY)kGxE&544{b90`+))w608?c`89p{2Xu_B8WvvX0R
zSd&GI>A56Ps>-s({9KkS)@9LRf_{=H*5zzHpP`>6igh_OpQ0-g#kw4t&(T$hQeB?S
zCh3}Fu`Z8hvvggeSXX55ybIlsDApCBJWsz!6zhsmo~WA=rMe=PXX=(@v91W^sk$vu
ztShv7x+}ONQLHOO`B9fdv91uM*}5lDsw-x3y6#IB>xxmFuSbLqDCWzWez7w>mMGR`
z(PF-yNEGX`Xfa<;B}#Q!wwSMHlEu0#TFlpTiK1T4{`2`7{NLfDsk8)GmqYXUdP|~M
zmqYXU8X{4u%d^>h4V5g`<5Vif0V8lrt0
z@wc2^-SwT_(Gv%H5;9$YgSt9G4xfd*S8(mu3}QLw$T=?$6l*1jU04vFV|b4+Izn#8C!rPQit*Th1N~f0#JB7zg#jwMOw4
zNDz851W}ZQ5`41+L{SzA5LYJ-i4PbSOA-enIyp7@5=oYXq`~u0
zsYXjqPfr9s(`Z%opDVPw{$-l2T!H19Eh&uF;LC(Izt&a{zrCy1D}c`~@ei#3njCEJ
z>}hS+96o30$K2Y)^{*9heGXO!+?<~n9wy^eum3#=o*r}DV$qnTF4=0>Qa7Sy+Ggm6
zF24Zjg(lk#TJQ7C25*N&TRR3g1+X|8=iNEo(B9hF)4z34U=gqoxDtCb`&wsH^!Peu
zyjR1WO^vp={B=JE6Waf^nqnNXXoVPu4O=b75kpsqanzs{VjQz*r5LAjy0#dnHCrvl
z84Xv7aXz8V@S^wX;k{f0twCN*WP7E)uRx34%E){HdcxZU>c`s(rWJ_j)R1=+4NKtJ
zyd&=_wjM>ZG_y2A4-}0f)Z_2nVBG3(h#o4KlaA{-=B~)=m=g+66S;@&G+l(Uf$2orh~TOu?LV
zNYe`{hbtPBj#z#n-w4HW(gBUHRD?XnWOR+bpOA6Yo6(en4Fm%o82nx{ZI*8f%>G6m
z_es$8~(jDHzPC;sT4HvOr)rKhD0
zw*1cWo8gZo77jOE@q8k&py?qyyw>|vVnLe$h8KFDNh}Z+O2xJNTw>vU6m8tgB<61;
zF*S^~Tw?An8YsAr1?&rnmH$?9g~ZB#ExA%+6~CAKQgM+E>?*4i7YLE=AHGstphUWV
zSgp7~3cO#3Rav9BK#OD`Un|awf$3qqZxrX%!1R#&R&idA>~X?c#d$q2J&d=GxuzOZ
zv0h@48t^DlxAE
zriR!yiFp|?HN>_{%&UN@A+|$e6;rWOagh!@6+b905F$;*F2w~(q^a1gxIl_D6?+sH
zXpyF3uj0HI*;MRPoL3{8iv5c7a%59+KyhA=Y$^^j*V&D~;;z^%jwmkDgXiL?;sQO=
zU>s9iphudFyZt|DaCm`vgtUjIIl-G9%mHi^~mPqN5xeP
z$XN|WitvP-(_kP;8jSt
z--HZvY@`oQ%y7pB5~Zmb;n+Z>G&v(38wi!AXOv?Dtv&>wtf`gnt?MZvy_65*~lY@NK}qTEgQ~
zlC=T<`x5^5z<(F;b!7tA!vWt%2b3w?9}ZX-9Z)85101kEI-pGBMmS(YbU>NNO>n@*
z=zubnaSAqz13EgJVPt{21q&PF!kU-yl{F{=U=7_$PN8sq~PDj8~lctil-=hQU
zDX^{*3>qq?
zRA&4~5(XCB5r5_YuFcVcf|EuS(}UJy1=d!Ap|>4ZSlw@V7k~`lAb2x(@zbt>;pgNv
zqrse1Sjjs`5Im*9Xd7p}PHQmO$kSEL84U(od3tL5qXvV`Jb`Bmu;hJ__})<{=9~e;
zy4e8ETQsViE#N|df&@X~>0;ty!F6>9FYwBm>QceM#JSf`5k}=)F2L4y`yO4oOaM=T
zvackry#s&m2LJXnx)1!pZoO*hFj=H=psy(!UbxoN+Vn=auKa6)>meU4F8{vZM#P6B
zgqzMUnr`kNsF5zgZz=T6#@FEfJ&H>fb6dfG2ks58`ipIjjOI?nH}(%N(8zD@sslP3
zgVzbB*A(2dWVqPe#P=N=Ei`xW1II>d$9vgB$3|1kyV)bh27`<}4e~v9Y;b9gSJS{g
zajd^Sr!7
z%fnuc?0#X0hrJwR2M~Fvhn*hmFaQtpuoHw*#+-+H*eOCOBRs;xP7-!7fJb`R-aT>3
z7Pe_*kNEwwQ@xjy?hT69dMlr&sHIYSHlY
zbj|R&K%3#??c#-^%Y|hErB8baS@1YmfaQXHv%aM}{?swBIAFh!Y-fFkvlUtdFd|@A
zNEYHYG)Ffy&@jNRlx$~|Ec!8kUrG>yMku;5psNH5zkLZ)Mau;AD}mPIr-9)*_~ydq
z270xi8)$Vq{e>P40>IzoaNinZ@U0{($KX3jR*k{;28{cV#$cUA!#<=}+-#6&)fj9v
zV0?NSgH09lDjlnj-)*6HDlC3cYJ0x3U40cMkY7BmmVD%X65@?Mv
z*e%f7W3WfiHOF9o4)?1u1_vZrIR=L$Sv3ZS4H)+!jlmI%hJ8q5a7?0AV{qJn@#$#{
zPFOTNJ&nOBfz}v<(*mtE24@6YYYcvrY>hEEE7=-ja89ySV{l%A)njl$pf$$eqCjhp
z!6iZ09D|>8_{ADya7B`pV{lE9Rbz17fN>wv7~HUE*oQO*Hzis%2Dc0tpPt6xwnf9!
z(-_X~V$vzJeF0|ke{)%OYL*u@oCyhfr9Ci*pXdLEYf47Ng;9bIS
z5Br-(Zf-Bd?zx=!%=yBD>B)`QF(kX^0t8CJ3ip^ru}dAviGS>^=wce
zJxhYVcqgEJh4e59=ywC!mq-tNfSwl6zQ*jX75T55@
zTOL=3@O%&3^0+#L7YG=h1Gqa|dKWEt5ughlYRgO2A-u@Lro2=g!b@|Qe&t)`;U78F
zCV|cgfAF_OAA8s&!7O?BCmyzI%rtuVryjOz%rJWR=Nhi^@MR8-%Oek8?%}XJ^6)P_
z9F|8OzQV&{dF0_=3b=-cuX1Qu9`q3`+gBcr%7Z=vc(sS4^4P=IcsMGLJ^UL1*Yfah
zJsT8AV*)v^4QO8>%?Z%o1+*_Q^YHHj+SizQ_JnRZ&9{~8ehh2TShu`q9D=+u(n*y%k;kO*>%1bT>8Q=D>Eibtoz;`@s
z%PTzmu7_=Tg@@l4a19TC;80s$st#xBp@&U*sXBz83(;DT
zhmR6)4G$mf(6Bt{BUrXE9*)X`J_2~Ghokb?!^e3zDvv#Uf`Dsz_(abJ1=5&6&XWS#
zS4eXL^yGl{C1xHzC7^wcnTJmmbPW%G$DzJL_5sNGT@Skg*#`ig=3!S~?%~rt?8?hM
z{Cxq}@bDQ9b>$_OgN$c-*p`=E4&YfHw&fKbKHI~#yu!oh2)Kra&vmFRFI9&#HP6GQ
zyi^^+3la?9?O5}H_(IRxG?FpnmH487HhCnPUSAW?cAXi==P649+AcKHXyhLmy2{Bv
z_H0}uS@|ac9o9%*{%JsmHIkWs7SLgh
zdfx@Kt+BAZ?*rP_Soq$$fVMRj#wGoMM>B2zDu69
zH45*$9MGml;eA&My5V$C4PE7Zw>%ry
zNZxllpu-x;`|bpESR;Ag-GB~jB=5T~=^Ebmz_VeE?0pXdI;xSq?@>TUHL~|T4(O;x
z_P(c*uHk*pJnL)Bz3+KIyBc%v8~i`;(<8W7>es`0_|KEgz3;7nb~WbSH&oI!ylbF#s;*hQFz~kg3cZTnipxX
zhv19ACVJN9k=zXLc_#(5$s^Ht&pSDw?OHRA_q*~-z|Ey=3U+bhAU(c5RhV5wkHY4rA6)UOnvGqx-Wfv%1*OsZ
z(U88LZ1m0vvU>E+TQaCA8@&sT^;Kn~chRxFu59#v%Gnodj^59btsK28lB^oNYZ9y)
zz3T=HmMR;)8y58|m5ts_fmV;+Z9!I!-W>ymiSp>(wP=(mkKR3tdPTF*yKhn7s@dp0
zlxW51J%tgkB@z2VGu!S!ZKXII*wU+ww(zwYx7^rHI_;^(dA=Xeo1QvAHx{2VVm
zM~R;o?^H`Cz)Q~20%*;zb{U{eY>WV!4M1Dh*aB#7YU{|}(ZM0;zI8%I^oxs}D1IIl
zIZ6CHDsr;;d06BW0fa@qEr77dsRd9{lJAZzJhsn_U
z1V4;$?;;o-$6`T*yU(RTnucUygu4%>L7YZrQG~lsra_$MXK{qPkETJK9{emdINrww
z3zOan_)$cMGJ(Uw%6uI1kxsn9eG>9PKKKz{5dYJVkCXxr1^%;;52V5k0{G8EKF})d
zX3Ii85G(Cz%R@d;EA4D63_qZ~wb89k{{34kBRWtk+YP@Ad9PNs&#el1mk)j18m{J7
zA@9}7_Pf;~@6@97G5(s6cWP1k$bTL3PA%H1k^d&-om!MW@@p;M@;7F2SSo6@?*iCq
z#ie5G?<3qw#g!tyF2YSRtP>@(KEka~Tqj1~5aC9rlse)YBizW8Qb&AKgd3GuBg%bq
zgd34k>KJ`nfy0NI&@N>QMYH5xYI^`XkqD<BaYG;I7kr>CzwI3op%$;_r
zT@h|XN~zOe$?GC@;9G6zFG
z(h0f}_(LHd3B|kA;gApVPmdvwgnS?s&J^TxG~@%VaHxPk7V?2uX_q=4@_|}7RuKQB
z;c=I8)#kg@sfZ5LA_IZwr$gSWMGgY|nUMEtk%a*NW5~Pw>4QPB+Or|=)MEbw{#?jA
zwb%fGKOgc=Ep|ZQFNC~PE8nFqS-$0OOtE5@x*WhxD=rn+=BEg^QgNk-{~X~~DJ~T8
zD-mvTXPKxiuSU4hDW#6luSK|#DW#71^$0gArPL9>5#dH8u}j@5aQMt2+NDh9?3Vm(
z!~yI?Vjh3feka1MNQ~nybvMGTNQ~nybuYrLNQ~pX)cpt#OQn0M2N7;WN~zS;uWGC@;9^k*R-=>%N~{PU2Hgo3sNe(?XqPq?7F
zsKqGz@I777m%zUj@|H174XACK2R&|QX>qHyOhg5-=#)I
zbf6X)2xK!V_z2=HS=-qp+g2mH8@cWSW#0zW?Fom%XG
zz)uKyrxsfv@RKax@;4@Vu}e)3V5b$Aik&kh!mU(XDdKNOxK)Y^MSN<6TcNm4#NUZ<
zQ))^b@pmKK$dpn?d|HGXl~U@6PmgdTQc4~1840iN?uK^(baz)i@tYaIP9%0$+@)qk
zxD|WI&aa3fMm9r5`QZbV9{
zBfh}k)ld8uMsz3>G$lk|6!MWy(3QY14*5tZXiMOignXnF^d<01Lq3oSXA1a_LO#$6
zhYI+QLp~4-rwaH_LOxIn#|rq*3}5}k@AHTb)FK0c=*vRht3?h1{PK|ZYLSHi|3%1q
zwa7z&UlH<7E%ra)SBAV(iwzL?FGJp`#SRGks*rbTu>}IZ+VWLT{MH1p(~3*QPWU>)
ztyEko;@?ELRf-Em{M!h(LUEmluZ?h{Q%W82?;_mDlu}3h`v^BGrPL8$7vV;vlse)Y
z3mo3BLA#VK6lO0y@!J%@P9(zViQnc3w<0l)yVRBlw<0l)yVTYQ4|As{e%m74h?G*t
zb=e-_Mx>NF;yWVTh?G)Cd}o9kkr<~Ze!C1_{lsr~M29j#Q$jL(LO#+7x)S)kAs-0^
zZ3+CokdKstz65@M$Ols4OaXr&qPuggd3ew>WE*C
za3fPn9r2$c+^CdNNBrjqHzK9f5x-X8@Xi|ArA+29dhmyy_+1ZRCld2`FLfirtw@aH
zF7-=`9Lb1Dd3-me4rH$74XkO
zJ`fA13i#(CAEf}jrxsfv@MA4s^~7&n06VR?RP2QD
z5pJd8N)ewB;Z`Xw6!D1>ZiV7H5uX&{MyHfI;*%rX$dpn?d`g5Hl~U@6za8O5q?9`1
z?7$EY;0qwORUjX`(fcDyuEdc##KznV-6@dOMpq)1CXFz`*&`uk+GoY6Rw9|&&
z4Cv(n?X+Pt1A2v~t9F}}4t2_KfvEYH9=5`8eF(4eu+@djL-;EXTUod|gjajmsFG4f
zc#VgRC@E!xzxJ@vB&Ce-Hy$>Uq?8fLDgpMiXQMpOXn;Nw&_N#PG(ewqwDAqV`oMA^d(N{_9%xHIpAYCD
z5A-FVFFM+OlP@m^vX?v?;XI8{|PQ4fNH3_IZ#^
z1AX1m?%Ri{J!tW61hCJ9HzJ7rON6^rcq;<@md7289YU$x4q%@O?_3c3PK3MYymtY9
z&*Ros)A#!Td_RC)D!eGD=7R{gsqms8{>bCjS$Rvo~(xPDO!T+n>*Xv&FF{z|QL41hEjlZTvL3n5Y+f>q`AU-U@O)6zi|x&hcJj*aw!
zRsi;G#|DC7zXLnfv4LXP?7+U`*g!IDUSQvKY@iu-F0k(Hn#?n0~+H
zfQojXQFchQjQmc|S@9w90eEdayX1h9v~XTNC_5xR3(n2l_>e$iyn28G=9L@}r$qxd
zzwD4OEgHN9@gYGs;l%``wXo!XI4!#TUQ~8Sm=;}wFNqHc8W%4uAg!e(2ZU+y$bVFJ
zNR$?j{wMJv!HnRAD5Uji$pK+nY#E=G9TKI*&ao^$B=FF5nZCT_fGDlxIA4?<5~P)k
zXJvdy;Mcg*!fJh4azK<;GOSf)hXiRQ-&!3X;`au+6oItXlpGMGg^Puid|h^kPYV|d
z5BWAe#P36NSpo;FEjb`a3l|H|@m<*=J}q1@W9DPxpE9&s=OV*HkGs}7<+1jn^e-GApWk$jlYU(lW75LQ%Q@0v8PA4
zNhK``;xia;f$I_cC%zoP3yhf>G!bDY@ee-5oTWkAc?{yE!fXxNzF-iq55tj|J2
zM%sYnKrS+5AP#mlkc$l&sDlj+KG>N+e#~TgzRrzF`$FEQ@PZh}
z)csa5b?`LDF?}`D7he40n0}h+2QPVX%!`_N5nkxxn3pv361=>{F)wT8Wq1RgV_wnB
zEAYY>$GobUSK*Czj`_W2eh<%Y90P5p7qJh#!o^c|sbQ_Z@|0QZI#})1o-)f_2kX7Y
zQ)a>IV8y@olv(mRSo5`s0(Wb#bhz&{7)=p7-1iy`h6uVC9d4ZlgBb!49d5k_gAqde
z0C0l_g9$?W0C1xQ%N=f$2Fo38vj)o@Zi@!X9d4@zD;#c{AtP~QBa7z|NzxbqqeW+*w_1q}uxlpOA&27?Jo4tGg|~_JKPlwRyf>MLq^)L!(B6EAWm|)>xK-}Ne*|zkbykO;eIh>pigqRo05#~Ea?6T
zwyIki^p(?{6M(lh=nKajar3*QL0>nfh~Qlfy0R%n1n+6kRZS@(cwd9AD=9?;A862Z
zC8dbqLk-%lCOvpHKI|RBB}7S&_fXIZN>Ss;-VloRdJ>rY4IRG;NDT3
zX-49pdw_d4=NelE4h)tVTO7D)IoAfQ6Lc6hIB?T*uJ!e%Kf7h2fdOm=V_n^yJ@M-G
zslzYoo2jsH`S|xlvosj3A728@)?l=Ne3SEm2BQ_^o18fsG}BB=%{Mu73$U@FzSXTw
z{wRgHmbT6w(4?g;0J-P|0&FPZ@X^)cbYhOzRT^(e!8NqR7=~L~U~Tm=hFdTyJ8d%@i
zVIz@6trAQ}Q-fvbCiE-8yyg&crPVnyupOGbsk>o-4MlFVCg-}k>pQct%FRX#^vT6Rm&zY__JG)FlxM6_~
z8xqsEr@6D~k0#wd{c!L%DkLBLY+<-FHfbmu`U1k%*sP&!;0p+Qb&H1j*_^0Tw`wRG
z^gI&v&o&KZJ9Z9H1MSEm_^Q6n;%hN7ign*9sW*!6^vfug{s%$zA5?rnMnag@f
z9O<9whh5M*UHwh}vDjB~0HS9BvU+*o=R#@yt~3f{_*`p(wu@->UX0^TkVn=23Z
zog8R?!=8ml`)*Fap5{_X!+kG@x?9?s+6Ni)hI8TA-p?u6j)Q$5wbP@7!T0TSWtTcx
zSuFSCoDkOs1%lrFBuBbC>&^1`2V?k?=ZP;Bhhz;LrYv+>!oSYmTm2rUTSSh
ztMyLL43k&(s;9$Dixb-2Jsinb@9U){TIO4d^hZ*<^1b`^D(9RjiOM2|9BtSP
z%2>$s#-0vwKfYuD(+~R)(5O}Fr6&DrYT|)ObM5|wlm{UfFAm$*m|>4<9FU#Q508{X
zg6w-lcV(>D-<(rxW;wr61D|(=GLB}V3b%*ZwwfAd!rA5CSvS|4^LUZ=82`MT1t1YBCftC?$Hd5w`qelT6+H4;six{A?$C=?Cq@)W<}96WBw$fCOX?wW~)ywSt@
zWxZ(ZnVgV%SWUrz!qRT`uq++Rl*2fR+$|YbEmTLW#~F|)25-&4VkrVKqsBi_;$Jdw
zZao4q7T_NMZ_B`e7{r)>e*nCT!FmmB4J%FK@>yFDL(jk4r5o
z9JMoIP$Z3l2LiOeR?_;}1jz>jwpJ=iMctTrgvkm#05n)pE2s86nqlS91c&W;EaNam
zPmq{#Jf4wB4zrG@4F@r1uwsK~U>#EMnG6F3bq*DLHseS^okRtn%ScdA=TO0y3K9oOzg-{J#-+AVqbpA=-^Ih
zC2f3};r*4z6-Hpo&MpnZ7NMeF`{>}P767qO3@*F&(0n+!)7SuZ)7U`05g8Q?3a?{A
z^Y0en)d=_cU@wQyrPAlNE`9F^Z&~{O7B9@ffiS0KC_6yFt%KQtf^HSg4z+Bx3~IPV
zO4u!!I~{4kLLT)U8HSA{86?@%03T!FBF5=r>o|R^fLk~2I6=2++zP?w2de`@X&!Mj
zRh?w%J~TyN*(P|gElw7sO%;8TXZ+JGSt$4A!EEqvQOqsqarg(!cD6@D4hghdXm~~E
z7(OS0MgE2y_6QVwfzJ+e$;0X_%OUL&$HM>|17ozBXD=0S>;Ah;(5?FKa={ir8^wOu
zNNVPFJylQ^I&ZLA)WaL58rNH@T1-$FhE`dsFgB{sWf&@Na8$idr!Y$1XsIg1a&6F1
zG`rbR?gwzaUhnEEVNc%TL2d~XV6^jhtB+~!3HLriX@BuC)!%7<;SL`gEX}ps9YMX+
z19u8it(r8vOOR^qq~zU#wA*Sy?K7}B_XyH%t_38u=w3nEEw+HnW105}(r&Z`Bt6-3
zzaVF7Jx!hXpe2jZQVKm8GIyx>Aq$mtXXZ_tzglXrI;wgzB<)bx!xkH==@{?dJYuoI
z>fqcK#XV}dp<06D@*cNbzE~(06lcJ-2dMX?<>qR67T(Pb&{H0yxxU$|c-qI5DsgcF
zr9Epgxab=vBX)`PTt?N$6pq$TP}=jB8`Vmq+tGn~!Kaia&;kp%7XvPC12zHM@UrE~
zL-l&JX5s}PV6Ql=qF}uI1MGE+RcZ6qgi`1c*zM#~kc_5+AqLjB9hC}(7+BwN6huS2
z6B&#q+Dm!YVSR2(Go&!GzUQdY*r=HQ&`4%1z3;HTnihb;22j`sj)F$ligqW=tJS#J
zhYp0h;1te!&qp2ym#Gxe`p?IXgyE@@)`vcGWUbVXMN&WEGJ$l4cmDR)3V5NjIZ&^R
z#GXw?fyVCYVVY*hVR!BBaj>zcUL`JLSL`7`#lNvkME8_v?BYPuq_~$v)p>$ul)WXY
zP82ky>?6_iOtGJbs#nu7$$~cRA98Bz!7qS3K#*GF*&z=Uq}FzDNhtFmL26CskbJNp
zm6oIXLYapMQkf&seSthwkjflsM$Tb^ROUz%pO47MlH$g8h#l!+nj6~zc9h5UZ52lf
z)DN3-wB-u*x>Bu;yvr?C9UP1>(v3o)W{_xZs#{Y7A>b
zgD>5j7Q@=;;K+1(3@Zb~#HKT1SQ#UrG8*nI2`iy_W|6I
zux2=L4bb?!7}g92&H?cGF{~Mmqtyj5tQn32)`c;w#255tP~)N)RzeK=Gr$+eu)X{p
z&-s^1IF2Fo03?)qS%fP6N5c=`%VRk1KN^4lUnybOSC^{{juil3rNEFBMEQ>sSg8wC
zWDOW9$$-~Lf!_+0_8$nnHbNttn1BSDUl+sDCMF~Se0>Z{pU%SPsu-3&odwXF38p|7
zT|{FW;45=)@u{d$%wdGPHQ;1>n8SqYwt#~qPS})5^xxYB8TBloSoa+P2~k@u6KlWQ
zC+jMPZ?(85z!I&-4U&69P;WNog!hMFt9CyiQN7_<{evNzYB?(KaE1<4)l~xAY75*W
zA*Z*Ua@R)%sWzS_hsOjd9hf?j!u{idl-^4u#rh`&S**-e6`S@E2mdd%CI%ZRxxi
zX=q-g#
zm;JUvD;=2Q_PwLfO8@1!iSH`3=1a!TAB4D~a|wnPnC?RXY8_(oi;pC#bO=sOQ0m7L
zRTRL93D8d^+Ok7FQ|NTrpDVP|A$iv13x!rX1a~e#?=KZv>kwn-Z!)~rC@29rN67^g
zyz_M0@WAy5lS-G^Y-^W@jr+tVTf0VVY&gm+K!@ETHV({`SOB|w#6~9OR0!C;GIppi
z66rbvOiRYyJLF;uaJ~d3?jy*kOllH#*nSxaYf>fCqy`~*Kt`gLacAL;Ev)E)5gO^5
z<$(vquv9n80}qa2*;kF@qScFCzXYk=MEHpN)!;+7PVWF{U9l}S2
zaG06V<{%sR=#Z1T8WUiN%LOSEHH|{@I3_D_VXa<)-2wed7bco3JhGG|G0{BUk&x;o
zNzCC+@W^zTn8KatNJ#WjWm0N(l23wnr(nv?PWEBgNlC$!pq=7i*g;YaMLE=|4r7z5
zH~xUHK&wvkP;9@7f~Np_x)2qyYou1&(BM
zMP+gb0P;egWNSq*hX8;t@?kbs1oP+y_+kfx7e*KlZNM%gEI-hfgJ)=JO?(P8pFK_E
zZGwPZad=-I^L;5E2l*8-Ur6yd)US;BVv5HBe^tzv5)>+6a}u0`HIeSD7Y@>x6pZx2iM2^9G&N&uqxyWaMz~0H{J6FGuUqkX?WrX-6))y
zaQD-U${QoRTfvERI^^
zO-)0IuHvC`dx#fmTUBFa$TZ}ccZ4`TWu3suG4B$1Jx@3$!Z4ayLsJIq>4b1?xTO!@
z6VhOoay_96`S1gl?;*S34~`~q3L%d%UNs>H9s$w3fDHqk^mv40HPXij$AI%hg!iU!
zj5kk4`1BNx;pV9bpOL_+PoIwPnF*Zw^qC0HrA$M?=GmA}*@immxtLEFhl9=YAwLF>
zUg+v`mheJ|*Q*s>dmP|k%NHYDS02YV;4g*vXdRwnRm-RG4FWGK0%{Eua6sS{ApjMq
z=AnQC{HrmqIS)q=;9m=Qc(kWww0u3nwdT5L`9_3mjdj8D%@8l-hZSYAQ2ADbE6T7g
z*jaCfINYHSIgS@t-wElW619ycSoXUiJqq0vk1C@I^6$m`tVkQS3pv_{md6&tLnoCX
z#WECcD4cy1;c@9q)7=ywhd8-$s(gwepC|&UphHpQ(@+3zyoy>&`tTV4ETrqj%7~7G
zg}|7f3%pv>zaa2cC;)vmTf@oM0RK9|b6py5
zL&!HVuQr#w4a(nn2F<@!Gyg&aY#9)CiEyoB+4Z6HT?L+3ZO@($_--MNH_FFtHRA;E
zJwqIH&rOl7!N$V|5|glID8Ze?v}90jj6)y86~n#}-It(o`ra?1Qx9k1?7e?PYd7Da
zCOCN?5Yg%bLFU^2ff1cO^6q8A=HmWA5e<)tYDo%B+y_VWfKJo2eMm%CRGJ6$p%J}>
zN`qU0O%97_{mBgQ6QBEm
zs6Yf)A949^^c*eW?ihAsXL$rGj^*akV*;Aj9Z}(|2&#Rog2RK|(p|Eld7L6piv`Ra
z1~sfu1gedytbz?mJ$rm0fh(c9q)h{`1t-Mx=wLPSO49e@2F~XDs*iC<7!8PaSVX%|^uMc2e=_qB>fCPM1
zjBBOSXaxL*5XV)HQaA+@pl^(5#YtR5zA2z_g%cO;BJ#}=Rt(4?1oXH?!b%f400Mk#
z0OQ&wQX>n;f01ykh6!X)@@)YO>l#_G7gKK!SXk9a){Cfj1T3v-ByE&H2e~t%XGxlE
zLGE;qrJ-TGo{=yHUigEt_g)D{B{NIW=Dq;twTxaiMTPrgJP|}FE<6z6u#Sm)k+h~p
zJ}BY17ZC=NLn9xOu;NSrgT(>pT7?NlWMkfLI5eaJp(XNdi4Pjau
zX=S6EK-rH4I4+D7n4A^h$0eNWQfP8lpr43nt&!xeKtCDKxFm{;cJbpW2`m1=qXtTT
zI)q_46qn3{2H<5ssv3#(2@^?1TNMz0XMimj0MzoxB>o=BA|{Ao*6->
zkA(y;+!U=?DeRC>RFTG(icl6!K2?Qknh@)THGQTE!6GiMilZkv%;!Ri7ILwKX%N=)
zg(iWExme1y2&KNZQq(8Bpo;~-iSZA{$8UrHF6vSO6o_`7X)k3V2G6p=!Y(C1acCDI
z0E@d6Pf=)B!P5dSB|%YWPb)#L&WpU105$qR7Jy|QV!Y66DR59MpbslFD^4N@#{#{{
z8gLFdBo>&S6u>Fu&{$wbN`N}EB^0bcVud21Iu!>hkT_mQ;6hQW!p#OJ!~&{uIYdDXC&mJ5vpL{`z)3;?7mbQa
z*;H_HETE}mf+o~(iV%RsV_bn3%TEU2e7RxH6bA{RW%
zN>EdIF&PWsK!raT_s@<6lp2_)h<1(;;6-Js4vIMEY9h%XMKR|*A%cs`L>(Ls&W{DU
z_4NSs2(DG<0g7SPAFU2$F_1!&Ew
z*MVLIbzCY$aNVg2ke`FVWwAi6OO+r`2Z_rS3BBRu=^$~1kia#lRt1ke5V$fHP~C|K
z9|&9}1z;_z)xcv91Xc!vYL7$X5W)d>T>!$ZkI_;ANz5It
z4@m8iXe2RdSQU`)ZV0tZ%oc9UNVpTfUeX>jL~Uox;yyRFRKOL_-^1$e;%+;ti~>P=OX
zhxLu%?Gut@??dt)M^^LL6iH@obZ3E*LPZA1u2E+Zn_8EHkn0}1@sf2(!VmJysof6Ro4u^wh
zQX=As1a^3e3(uxR;zwUl3IoJ*DUs+27?hyt{rQxL_QW{MT~NzQx`?uUXCAnJSr_=N
z@TBZ%=2vt9;dA2e@r0560`$z%=K
z5&R=5?@9q^i!OkVWSoEG~tnergQnV-a0Xy2qV)bn%zud=S{c#C`l^&B}v03f!Odab%
znr5gPly#hsDVm{bfUWQ`MKiNHI^M@()50*L(oV3LcFQ2z7HT{(V^sA)f1pnCC{25w
zXHNDgO?lp~I>k|%Rl%-M->Dg+YegyMX&$9&MT!0C9;IqUf$I#9(k#lM>ujRnhc>o~
ze3d6d(EXf@iFJ1a`&^HTbaw;$JdcWWcj4xIkBW5XR15UFz)`W??W4mNW=yQR3lbN3
zRHVBL5*K?^q&tl<^sGxfD$*VOm^}GXON|v{<>5u31YPDqiuQK&U+!bE`gZhR;bXD>
zq#EddrNxFKkD&D$w(%;*D9W4Pt6P~dn(iiyTL!X@<57y{CWu_?QL*K147tuy
zMWub1sX+U#&lpvAjv=c&O4FTV$PJFtY{k*x#*ESHqv&vxN2&Eubhz20G+XhK{}zwZ
zY{k*xHliR$DvU&LU~$9nb_E!L=Oi6t5r
zs0S=HHrmiIGp|2rvHW1IPvcNIDDEMT%WE8J2i#vR*NERG1q3Ju(8Cr2-6H1z3UmYN
z5lf+J8V0HX_Na%cKPSpb$72?QpY(|GLedP%dfY-~ErOw906k$L*cYo0kaV&*e3az3>gkrG6rpu1UTbU|MnPif=itroT>r{P1l@
zVWoA=y~qvUaa?^s=`rjJT(Z9FFfiSisvKpJ?>P=_mjKbP-uJ|V<;0@O4`RiX9AN>tGlRR#1oi7J|!^lXJh
z2vXIOcX0%%^$*YJXFC!mwwCkIIX>BX9y-@YTg*e}g`6~!HxHdJNMR&z9=aePWd~*R
z(1jr<>*hE|1LGn=in>jZMTfgskg|iadFT>B$_~orp-X+T^UxI`
z7g@-d2-=D7W2>@A*VJTS`RI{Q;=HQq47Z8
zB}lF5JP+L+kXj${JakXU=~~h}bgv*)EomOQPmrpXG!NY`NUeW(9(st#v8w+QzS(XX
zI3_K_9wDj@dkgh?xL^VTf6WhjC;?g)P`_`dq3c`c5r2{=_difW$*oMvN=XSKB+&J>#A*j6;+>DJQ0y4TK3Az_He4)ihhFl9bf)xA1
zgAf>eGh2PYCJ^LRljeQC!1NklgC_#?Xc!F+9K
zWVF$Mceq6A+PvXpPXMlW4r^DvC>H{(7{PNb34T?TjfmKbQaKO*ga77g}O`Nac+6V*_Lg^O>T)!qpu6?0EwM*YH4l#~iB+y)=
z*00zD#v#BLOE?|^IK1(y*JXs#RU!<%L;3ogXyKD>X%6kS(rId1-1IV#Hsm
z^3v8ce2KqGvnQ3ijYwJSqDYAH}=-FB@b`_{lN*J*SMyIimGX}hda`LtbbQ2Df7
zZVdSrcDaQ}cviow7P=oUjqwjy`8Lbs(#)Nf=}t5ESf(e<+;5rQH1m*Url*-lEHfj`
zJZ_npY33=*%t|xQT4r{ddBHO9qR6D7Uv^LnOTXrz7N&mFK`m_kj)Phl`+Wzsu=Ym|
zYGLkA9n`|!UpT0R!M}D;3ybghuW;LcvmbJY`c}h*it>O2LxwjdKh(99{R8
zs2t*qV$9w*Kp}Gpd!0dAK;t{+&^Mf4Jdg#h}fM9wH!Xqq)!>x{)0nKubn2B
zLj-ToHUP!SX~3W@#LtCReydQ?tKO7XrIz+CR;8K
zIJH(vgO3TgZmrKLQ#dZ;2H_{J6YqcL^kzlI!i`)F5kAO~V8(^UoRER&^77F!BKfz#
zPL!nDbk2WHide1roD-gsu|p%n%1?5eZ1B{KgOO3JRp!Q)GWqUl84BZBX%l59(E8Ie
z5MBzSfRvU1ct!>ekHCFFQPq@R0C-jg4i)AogQ@-3j!(SCHvlpZf%v-t~FFC+m6bcVqEx
zOsM@qNvgKzLGn<<|vaiOhZVk#T
zUsGt+95mIu;nTx?sEMKn54bmDR@H-t+*=B*>A{2UZH3nQg@@fc3axbv54`t$8e1rH
zKHR=AKKdcEm7!X5WNvK~GERLxL^qCSEM^qNlKMyt6pS(b;|w072jCM0^yjOAij%)pYA20lb>7J)B{GKSBW
zjMWMamrTxTF59?kCt5(QP$=gHhQp9^yvA8CFdUAclb9pw~HU!>MqI*E{(a!KD<=DOd*AR%w^Xr
zLbBo(wYF+@i7P`4UQK5oS+pFx#8nwrsMfRJW3d!F#LA4q;Zh&1D+O{-U!9?)VX$HW
zR)#jRnnE#Jf)%gH$l+{5$S|gpug#c33C1xL81{(i<5kRIPXGeXAJYE@<$*^%cT>i7
z!JP`VV!e@XjMlphY3>vBT;kSDAm<6#zKI2H&jh+X0TJQ78t%#jdOQJWaEzSIVwSvF58~|N
zv5+cOYGFT`H0<#Z^Y**5;xMy#BH+Aj!VJUA;;8`Z8yta+*UIl~(;ZtzcYIoB;{i*#
z$TJDrI)*Eo5|U>VwDk%{Q&#d^g0?Q5S
zz246j$1&k$AH%31!>_r&;5EyQj1D)*p$hmZbU(aD$N1Bm%tJex1$cvcIbX5i!@G+Y
z+y&>`w=x#qgqUV=&V4&$3+VreOF48^|DBAbQIlfP$KK7@#+IWnXVk1~2l|rNyqB@H
zEl1`iP;!~~GZZ2k{H%x#d_k$?FCPSGy%ZT2tYv184>J_wfL-arUYcJlwdIO0!>`
z=+Qjcs4(~o82ls;rujx=F*pKyvd7Ytqp=tsfjz}z?X08W=;DB%>fv_c(QtHfz)$mV
zGxsPo#dM%g_h>WyC^W@&pwIAVGXp6!4NaiW^k_2)DKw2upwIGXo`+(Xw8loB?ZG@1
z#V{$2@HrmL(IkdlI62pYZ9Iu_7f>!>98(9ln%t!Sm1LHlN2A5j#hC!nI3U8zm-AkN
zSN&;8q~xN
z{wUy}S@nipcsr2p_WW1@V>QVqKGD!fO&T7b1t{!g;thb(p5zT*1SH#EfN%{7TJ)s?
zMv8KX{7OTmq8ux~k*FPO)=C^Lcm54dY1TX7|9CfvgXV4)1m^`TyGhTM#}`C)_pp(o
z>=|yw9v%bt`?)Y>OX3C`@S8gQd`WYtG*la^;(zJeYw`7Z2POoZExkPiJ9x6o2eW`}9eGV6VeXQCn4_Pns%jcU+kI;Fw-Q4R(CM2|GbN3%(
zC8|U4ZnR=yr(z*)u)Q36tblVGjMFT-|8WBD)?l1(5ndtS9u3BM7vU3pc&Jio*6<(Y
zSv8!2N#Z0;Vv6xYY`I?wECnnMIRxy2eVl=?t|
zmOVe4%6>3G%bw2@{isIwqKtGwFMbG05
z5A;(BTJ$`0Jkn1mXwmcdf^(psNzkI_G35dJ*#s?m9up0qpG(l9=b__~em+5qo`;S{
z`lXQWrktcVni%lLfR{DY-Y4y5Gs;O`(NKGvv_&~5c~wL0{ptoaImw$E+MDvyw-U7Q
zQZNH9XWvfH!b^e1tp1$@ExZ(Hd|c<<1TDN2XiWd#OVGkgfySKV{RAz%6llyzK1k5Q
zOM%9mDJR(@K}S7LImx~nJtNig`z2`E^PH3HpP*&Wn+=8pEqk7Gk^>X8?0L>f4oc9n
z=Q$@iI6=#v=bYq_1TA}>bCN?7wCs7#Ne)ZUvgbJ`IXpqjp68roxkk@S_53jjTJ*fh
zNsdj>qUTLca$JHIJ#TW76$x7Oyva$9Ptc<0O-^z`f)+h*a*`7hwCH)0lbn>GMbDd@
zfvoRplUvSRV7TKFl@n3Y_VpoO0TjakXX30n9m(3q86lAwj30*zV8
zr3qU2DbSdeT$Z4Pp8}0p$>j-J_$knsm0Xdag`WbAS;;jTJv-Hx*CyzwFDcKsEPyNqZc5NmUs9fNbApcglJbmO5_Hs;
zlxN(b(YfRn=A9{A_9o{JccpOIot!+}ox){*a`tdf3YQ(q>BGG#T=ppE5BH^T*`=I7
z+@Hc_pK=EAKnjxR$RpZ
z6n8gXR#~~d!E^pADl7Ik%$)y*$|ko;-%R1c3t<+*S^upRF1!$Moc7;N;lc|6$9eyq
z6fV3FaGdzxP2s`|0mqsDy%a9I5OAFO-%sJf3jxQu|AQ1Ryby4l{69?L!V3Y%+5a;Y
zPi}*Lp2DMErTPDh6dv^|B>-Qh@TgZQ1NbV1N4-iZz}G1}>Q%}CzDeOxuTm1Q^X9=u
zh8fOa$f#E-3)m%v>%F>b3fFseFBMO28}6OLWv_A`uulq?y~=sOzA0SxD(3Y?tDFZMoWf+Rkx=
z_Y&c3y8)-#b2Fq?m%9u!U7qKN5%=Q~Ss6Gfo$mjOW8>9^fyZnM
zRWZj8IgCJ
z_<2Wwh+<68ywhhyN^TAfy_h3&-zeR1VJ;6J{K}lapQ{53rc8iobg4Eaz8C?
z%w(MLB@bzcC#}tF_bMU93OtoR>h5&6#^wn2T80z~IR(OL=5-(HRv-*?Z}?D;0^wxy
zrVsVT5V_-99yBr(L*$QdXHfREm}?uk<2xCW{R+85D3ZOKA*1eYeT%TCy_X?ip$KA6
zd*6q;BZxii10U*%AdY4q`cSWgj1zt2K_f#FGCuTi1~nvNeCRVm;8BOsib&qf1oycG
z&^clRo#TrP=~fVQjW08#M?ugrzRHl^7$LX#+9BW+kuKyE-&mv(1LP7r7luWk^qia6j*!A-xhYy}TD8rGDrhn=6|KNig@=+nohf
z#d++PeZ2GC;yiZBzTWvBaUOeQKks~Rc%Hgr|Lpw8Ps#_=cts>9UW59
zOh^;+askEalbMf^SfoB#`&fy|$&M536(J_47TBi3H2egQDipfKbO%3YgwTlsiuC93
zd6LAW{yeBo@vxCXcVvDZSEq(lWPTo6r-zgS?O75N<~Q;7
zoDh@dH`De79#tvis`YsBfp0{=Fv4UTjMH8egQ67x;*h^21ZDW+J?u*b6jw@qdzr+d
zD#>pzmzXe|Sr}d+F`1^Z<6aeD-Ld8PiIbHP7BzzX?dlkm&0v?iHUx#`%r5KpfeQewjV#{HiTF=>9|{m*+;rO*?{jjk??xGzMQY=eooFUFu~g^9Q?hoFcX
z=BnW<0*WgozkO9=QI+JkuSrZ8&iL)?5)*O5IPRMP)*D-nBko%f7BzzX?d=$p&0v>%
zHw1;{OvHUpK(bQfa_>t_RB2r91BnUC8JGJ|V#0F9=RPqQEY2atjnhqxq@M>W3h+S{j5RxUa+wJB(0E-FUXJ-(;x-#rqv&=guWFlkoAUs!4(waOB&(Elldh{9<9)%YK
zOik#-gYd$P>6@dE!HayvdbRNqGXyWrki2||--Pl@GGs_1W{h4=2)xd#S?r4*My4M#
zxWXqQ`>``#88Fg%oG)J$FuE(Q3>e)LuMQa95wG5QpIH
z0*cztgYXWCNfYp@^-hbytDbX8ot#45C8?-VHrCw{Cu?PcJq&N%hF7`bW@wbvvr|5j
z5z*>^UGmY4h$dBzjgMu-NKFh?6B!@RkV95ane$=GUTMGDIIt%>UGI}YoqP6mkExA~hUJ*4?+u@cdW9yw
zH$9{gBRK87*N41UJh`H%qu=wWYOEG_
z_4__l7iQwF{=i4%@)E)TcFBhxGnSV#mbt|Ekq3zdvgvLD7gCJN-h`s8t5Q=QhZgsdv
zjSQFIjnzUe_N$`|*59bY#2Rni(*osa0ZG3CPrxP0a)}AQGLiZiiODRAr{ZHJCKD-M
zs2nFTkxPMUXxSAK(-$kpOH5y`oFFlM!E%z1^@|R`A8`W3&MJ(J72&5iAcHd<#EaRP
z_|AZ{vy)xHS+e&z*;#98bHNq&tIy5OS_7N2xClHiJ8SJ~&f+w9es1^r@
zVRVa!A~-)>?9=Xvg`7&+ffglVm)awwC>XhvEH;8j>KmYV$;)N
zI6R+Ch|Nff(U^TMAvQB9MqT@SLM)dyC3V>gDY>*Qspnoy$t8`+qx&UI4t~fy)jCck
zUe=^&)=KyZrxvehVilb1bTN~izN(6K7hrif1o<>NsPwVXZN)y_pbGJ&2V>v9~obFmlOQ*@R+$gu5<)$IUcp
zFtDmCHIO2}`w6jGS`%3eBftjESgDchUJvZz`z+U^X$acOG>t~q-~--2bzq{(gD
zMbNWmX|%P(u9EK3XxskX1U<7`qw)C{?48{OJ)>8n$!b9FA?WF9EAd4ZSoWTR?p0d}
z`;A2JC26&l*4}%2bfF&gA1=tK)O|dzT(X-gS^wdl3F^A9$JIvS^2jZL+t1?$?Z$~$
zoQZ<_dstDy%r49U9#*Lq;@>@nOoh}t&;x6Vb|$ww$iwp0g3?@bE#_bk?6X@WUNhkN
zRJ6*W0oHWy3kgV4@UW1yJ3#?RbM4_FXmjrXq{;P&5LELZQu0U-EZUpbg7PRgILgD^
z_F;hW-IN~Ywva;%^O|EVR)(cc&8~zD$3ceda-7c%xR+V^1#%Cs@WFcCCgwf}@c?Q*
zJ_KC~?~~w#K%U@})q++eUtl;sCz`}vQOyg(hJdVuEH9lw8=VAG{)VM<9yLBG*zf$9KU8+J9c&-WshU~^js0wCS
zD+Ouy3qlgz;#!Y{%RcURL_N~D#VSjdAs?zX!VW~nnE3{u``vH#2Ty4n-{_OoK~W?Y
z2lsDc&)p=z=FoygJ1kWrKK1m?D&MWnC1lxKRDoQtS_MUhTUCkf>1uaVBmUw`j8^ri
zLo>&1K3OZft217ofMw7{Z}-VYibRjN!zasyzCLZRLaFEzcUyMuV15|xSE2vn`Os!Y
z_h`7?GV*jbessUZ;R+tkc_R8Eg?~VgXDnGAY7}6bX$$^)O`uEuI(bkW_(L@`@J(JLWDxdv?Hrq1+b*JLE2Bhb;EqOM=x06?NXL76pSf
z>h40XUnbk&H4hvb$}S1}BwOJ1fP}|L)pU>y@J4{@c_WRuH$4!#S1pkS!#ftN3{itB
z+LXyHde=vxP!;7__yddPyI?kiH6HvQMl|eIv8v~;
zp9f%FWPY>=0~Mh2zX-sgJ~0w|DDV>br6ijJun1e4o8Aol9mhoJV6q)0K4Mo5ka%peaBZG}Mq4(@5~4MzuH3vXB+
zfUUgY7)h>yHyo?WM8@;H;kZa-4ZLB6F4Wo^j@N}+dcz62Ow=IH8%_*Gz#Dqf-f&6=
z8*k`Id&Aib58?jeP@z0v?{o+zV479W2}qTrN%h=-Q@}9HVLpRKi1Qh1glj_E97a|(B0;zE~Nm_-CC2n;vbOeq8?2v*;ZfGgMtAX1+9=d}C
z@I&a9p2S_A1mkJ;Ud!To3t;*$S@HuJoo5>UOVWRJG;}wXjsGR-CyA~$s*O4-UC*AO
z$N~f2=Y`(%RK`-eUx(jp6B#FxrhA^2bV-9v_dFxvN_B4bv|Xl(-Oqkj;b&;eADk>e
z_2(oHEgmUp0%nW*c_9FNwLaH9@8fA?wz^*s0(CWlfvbZyFG@CFQ&j=wfqprosf+S8
zZK=syh_48?qHh^f{C-ui^@dt5#qif6R#|d`sd1_Kx?sx%y5QIFiQ&ThmQnX7wAk=E})-g
z=)forEBD?jqpYXG7a2RqY%3+cjOZ3>e3QYjVcL+Hou|aEWnB7T7{LA72G}hbG4{w%
zFd3lfoMUf?!f3$#frdI=(=@Sq=!d|cC;3(*(puOD?Ko?TmgHqr@px=eMl-eqkVyj)GOX(xh
z+3sRpDlsCR2`}-*O72x+c2WYRP%UW7r9N1cvnO$IaT37G0#NMOGDqv-%Y9DGI-zY)
z-c^=sRN>ki{1XlpFB`bVk~JjZpCoy`Ba4HOV$^G5{CS1mXwe3vEw1$5Vo~*~0>@7B
zi(5S~-q%M@z(3ITzjz>Aeh`@(M}7it^T1M{Hl~6+)jj8fRk=)~
zVFg14n)194!p+8VKp{#~#|u8FVzfK=qK7r~;%LeBlE>9X)bePf;AM|%Y@xOo6oiJn
z;)98X&=$d~KB$`pCRQl%H6K(pq^a#qi;cjFu-GV+qWc}t8{iKV`IgVt>T=)O%q{@F
z?SsW~O_Eude#a*pQITd2fFj@Z!Loa`uZzttbiU_<4fmwB1L2+|Zq54wY(jSP=VkMk
zYCc5G|3C_0Vxvo#5%ggsF}ph!{@$0y%G0-2{d2$T)8CO3f+{4`AVAS&7b%c-NYjX2
zeTk8HxS=W(W_I(zL}rXpW>3rEOQ2zLigzKc+wJ9(Fg?YjouBsh$x_WdFPjZv+NFTn
z_wh-XqBPXF&b~fc%3kU06>3&Y`}rhHQ(B>BNw$B0R_iJX1^`tL2++Rlec8SO?7RmC
zs9Gkd3S}PTgN;OyG+!O;leH1OO!BEid=jQC9i=(z&;U&}iQMV108JQ*=dHs7G*LY+
z%8s(&P`Pgew)aQMBVzROoIvJ3TEIhPxhgD|ZA!Xaup>kADi94o_y@E&M!*_t?@wA`
z*}^~rR)_FUUTlMUi@p;xxQ1}86?{qtH~L^TIRO8ri#|Q0Yed7pNxI{r{&mK;U)f(T
zHQ=q*jcK(~|EBQ&#to1gOh(=x@`XT
zO~EW(28+UFKyt*%9oa(`QplzuU@wM%SSHHPQQ5N)i1BOULL=^^59oa+-2*<
zR0tG_4P3Tl@j}p&>`slte+|D-`(SwTG5<;4i_#c+wR7BmS~cgLguV4AB`=#gF-nHT+NT(AZ%^{A}9)_xRbgyK`~{
zADqP}>d_Z|Y7T3BI0X;8-Pxa+Lv!{YCfBPKQ}tB*Z0g!*GQF?HocTvSGUtBIM@Exh
zkPYC*EZeqeD7%WJkjVF&Z`kUpt=VzOs`m>tGQt$vZf&awc8dI6_H{~yVQ<--E
zGoP`h`la91Gr7cnnOufn#^KLhlk3IG2!GC@sOhzCY__SaXYwe#e$15LO9zIUjuJDP
z#k?tP1|FMQW@63Vp>xmjzcXf>?SE(5{44)Eqs71a-x*~#n~Zrrnd#T`F&nhML9gs?
zS||QDK6FmJs?C03)VRTX;oSJfHrqo~{!MLu{igjl2Va_zbW8B1vBs@!>>q~tOB;F|
zyf(Abl+ypzsr3`+TRU26^1Iz-vdpp
zZB^xid)p=tU~sDq_wyI`wM{NpNBQ&pZEaPQZ#Mq?r}=G@-hl1Yj*jZmp6<4Z8^TQ4
z{!GWD>eAedwuyg>N6&VAuex+r+r)2R4rqU_<9pvDsJe6;;3s{sPWuZTKl~n%@D&J6
zT4&w%7x63P;j39~lYX>r`%4`^SjKWYVm*`oY2Ef$I)1o}<#xo%CjDmJ_E+&MlG_n#
zob=mu+h2okppxp2T-`S7w!hIac^TA!-=NeE>$bm%-~5Qa0inItZGWp{{pt?bnypa(
zcRIdb-2q!u!J~JfZ970~euW3`bxismLDe0oH8-r={z1nE-y;&f!tx(lxBWx>3VHYn
zDtKkx_K#3cEWElS)-&m|b=yDb*kBpU?TD34T5m%8r$~|9j!@&IpH6813|n&pXv)>)
zCbWM6c7ZzZ8_S1vKF0y8L;3CtT7ppC`cQ0rPpiwkia|W@D$Jc?%ZyE#4_psr>Es
zYoWxuCQs~yyHjn6HLt{)S7J?;Sgw>uqB4*EcKhv6=3YOT(CK=t4L)`oC0QAMR<$;N
zy9JP2FUd4|^V{tYg7lR?I&qy&c;?2cG-M41ZL}XJbk@pUwu$gLXFgBtgzXa+T)(qq
z=?yyjterOOIQ)k^+{fBFairAdmWo|%llJ+}xT#Y*&i~=0|MBhiac!MTox$2Bo%WrM
zsXKRc-0{OncYPZc8=XtNrngPH0nT37(eb(|^*dRq;LFdz$@@Aw%R{6S6f+(^v#uRe
zcOUN*Fd?X8>fQjh&xl@291Vm6jvL>x`;WN2>t>owZ=3Yz
z^*W}WIKJbAA5B{KJMBNgM$rSrwo}?B9SOjy@y2_s8*lQR_V=KNj{Na@&ePjEE9kmE
zoiJ`{rc4*d&2dw|<(in|xH@j?IxyzBhrrbfHE)pIwO;$zQ2N_HndOkS&iYuRR_Qkq
z<2%6(bKQ1KPT<2q7d7DQEPHaIVY{t6km#T}+yKwcs+pq=4O?V(iYeC|Zp5rPn$}qy
zv2|>UpG_GML~1PF+g8Pt$PNBY{P^@iY`^kOK+Fb?vk@tydVlJf8PXaXK}
z+anmj=1nH9ym8-cKk-}RHhJvtH+3a|om^S9iv2tx8x8Aq4!N&E4O=q~68m`r_&jP#
z*|4)PR&UhosF{L?mEYN+1qLzPG|&zc3#VJ{yX}`iTd(Ncz|(Em3o6yT5uMOE)MY<|
zb~*cbVkg`&%$8UmN*~Ib95Sop?eDhV0Cnv1(}|sfu2F5B1Mc&9_}&#V0ZzCBv?i38
zsrz^Bw?k3y{A_1mU$3A{6hc}*ya$mrTMrIk=A-#+Vkf-x%br*t4(y2y0IHTtbUfou
zfQEG9uXti2S-HEI*?Gm^wZ95>KL4K{ozh9~mtoVj;Q>73%17hz2p`txLvRp0w5o%T
ziQ#4+1~J{BSPA)9?#^2A99s
zwBycL8p6&hknTd*4!K!)01p|k*k*Wy4_xx$=6q;dRHQ?A&X3Oy@S#0BNQdwc9iOf8
zp*`E6LwKl)&u+1L
z4%#vG%I7etDyKVHr=ojq7Z6@Yos})
zt<2}~5bzt>AuN>430O;*PZJTb2kY~JNs2ar6&!6}y5{`s2krMledql1l#b*783Q|5
zvX7*X_yN=mJZ=y5&0F*zxlGAJe$f6H2tE7H8+JTMLhFDKb;})6sFX?F`h)i8LF$2D
zZqNy-Ubk&q-F_V3Ssf}3neQibR`ZR9Iats6G31iCf*v<@VrL2BmN^erbZWvjk4;d&
z{6YJ>P~lDgLKT`N8YV~PBUfk+xI%M~tk9hIE9}WC-2R8{Uqgi_cCC*sH0waD(0t?y
z%>h?v4%X|eRz}Qcm@r*ydb7fx{$cxm>vnANmmJJT@IKL+wcki%tExQ$@2FQxB|8g3
z6{BW&j+?q3=jP~8;2{=)6s2CP4dT|rxT&x-f`b7*_;Kf8VUDR~!;Y(S=o~Ox=5d0)
zcmtRx+p7Jbbf)0HZqWWJD0o%(MxD@)@FNUX!|G6hKaTI%wHu4+fB^$uPd*AIP3Snb
zn}@MC8@ElG_#@P)Fa)M#aj3DrRlNXjg>zl}Uqul4czU%PVT+3EJ|58$jRcmsFV>^Y5_`eWV_z>+s~XJ=a3&Q4eg)k|FS6n7prskr8U=q%G#
z2a0dxPS3Wde-4{@-QKdK`lI$kCV+QMpV(viVGY(K-UhWosJXTSY=gN_?#M8$$}XZ{2Y
zREM8JVmH~S<8{NeWv&2bZUQ&0v(KgAn|2&Jlgsls7~p#W*Oe`ndOO_;U{23$eoJICg_g9)95IhKO>
z;Fc{DI}2`VSiiIA+5@B4F&lQgJu9*mbipx1uH|-pp_h)|#=bN9j-wmzZ>sQbc*IJhx!*)V-3~u|j(fX|o
z+aCe?mfsxQ?%~zJK^X8x8g|CqXDHKdRDtgd^yO->L}dqBhKD#lXUY
zzN+Ud*;jkFgQL&Mj`xSHWxV$4yyqu>-@fzTbZqib--+!I7+IY*w=)5bW4?o35IZ_y
zOx5hfIk9tW)QYVS<7=?eX9PCr%n#PwLK^%8j_kQ9ontnU+X&iZBw%A1HW_Sbo5DV&
z{oDng?Zn#)pPdNoaY4DP^=6%oyc@^h3|PAZi(J1u9&p_W69Z>PgPnbIs&+fHiU&DU
zasv;#&B2y<&|?m^#)DpS@b7pq-5hL-2Q$n8^!1$TOmnah4`!KzKjFb_bFd5#a#n?%
z=*a5upLE1ZQ0F7cYEZ}HAu9qa&US)X6<8qgAu9vRBR*txV1>zttPre?_>fhC)dczr
zT*!C+vei%9F9d&CUKpQEFp%wn(`C#)KWkqJ%mGD+n0Aw|4L){rN5R&rn{!}V92~LT
z44IZ)4orl3iD~ev!J6INfDK3U^@dz0y(luP`MjUC-wHL~S;nC-GG@ILDj#%H0_+pk
z`nha~g+pdTk`k0E9p-FGQiVW;2b6(SL3=!)AXtS!f(MjeR3ZPw16TvWm0MdUZ0`-0
zhPfWt?JP7fS;Qm~wmS*D6i%
znz1^`Dbe3I>V)5g;c}+AsO$3SO<*)aF+4C_4|h2bb|p+=-i>KJI5VPQVz-EX7L
zIXV0NH27@4-?Vd1xBb2gKHKkmJLmM+?`Oeh`~7B}mAS5h&GEpVDZ+uPVgL{9nL$VZ
z;pzkoIXnAT-8VJ^fG}g2Zqvdo-8Vhvo2}h9SyE!9vdqMOlcgv2n=D76Z>%zypMrW;
zlVyBp)!2y-tq%Xmhc+33Je7oPHUcv<9ouvSk`+3(`3PpHbZ3ooivv=MA_B
zY&#cH)QXv0!J%vdF`?t^2KY)lY{}wo@y|A)-5Z-zOmUvKQO83Ko>F_VQ3$)Az)$OV
zi;9>IE{mSG?Is;lKLwTO{vM~&mm9b5@tuxM&KRB2aoi}@2)ln+<6%$&WJ3fOEB&Q<
zBMSisZPI=q$ho4Ch+I`SZPLE{J8;u0?8mfS4u7wJzgNQF4!9ror%kx!
za;T@f4ENo_Pumrm15?^Mem-t|`@%|{j`M?q@N<{7N_Aiw|A%)ZyN|#A^%M}w!7ajY
zkFfZ*Tm7~NZ(&}FH4QD^c7C%0&uG$vnv3EWV!-|AbVvF!q>DSuTSyXcX}rE*d%8b$
z(f>Pt8~zNH!xM+gf=3VNX|NpcLVOBRVDF3kR1cb%4+JG4if)8kZ^jcHOv5h
zr+|k$bLTHvsKPS={&N7gR)03|{{wkw;GY)GUpuqq@KJ>SnUro>a}EvnpF(yurpuw}
z{y!np(s(&E-hT;+wE1#qzW*ig*3Ccz?%Zxh0B-qC!+*&0`2+iX*jow3gL0Un_exI;2hD6_%+7UUNh{I$CuJyaHez
z+>wtjhVNF#G(Ku`WDLvK*k%ty9~Hy#E5GT9RVexB7#1($h0to><+j{|4kR`d*oR(jMtD0-$s_r(2go)SIF8Xj8EgkSrCJ2#sxqK)28&4okKPS0Uj3XEpw
z>J|u1+?P}P8vlK9ectweS_seh7w0dW_vhyH!k@QUI6wWM@fEt*jHDPpVtA!4HZv&(
z?hjsZl`b|bDFy=p#8&EJvy)=rAs}|OE|%*`%1tM^YZ7v~q}&XWyEY-$os@%DSb(0_
zCFFXNa^TY-cYQ*xHz_xpqM7UdeLSa{#p1IO+$CZ26g8CmoP=jdmJ%u&
zx6eyK~dB8@AB&?`pWN->(rjYt673zejt&
zOD!$!1nW_F+5|G)?Fx$*?O57&yZKFcl5~F3^zWtRY763bD|rvIzn_*Y!;_}byM#=y
zU^x9CEy|Uu1(>eF0zR~T1^2}?@gDbPsn}ndhW}7U@dwjINu!uvSUt>2tub!2Ut>OK
zGj`_A<8VPD^=>wD%|b!Rdd(=>rG=EtezW1UYYQov1!n_mw}ezTXejH-hS=^cq-0%~
z%EKS9#vU!C5zqj*C4NN!*kEUX9ssTk02{9jfG^U&DgdUN9LxZ?gT68V?9QM8aKrrS0GJt;
zfLr9(1c2QxG$r5*!>$d0*d8?6!^V+_k2WSFF$ApTwx$TJX{)_X8xz~
z=02MdXBC6@;LsJo)OouFnL2L+VCuXLd8zYuT1lOsz8d}PrgKVu=4#|;t>*mf)tm>1
zT8#l$XF+hM)s(P08|GGLM7UD7nkrUjMz|EWni6PR|7~(u+G3vHSg`&4X1GUb;t7W4
zcO;n$w-*hHLHb>Zc85EB2E}mwoWbRcCV#XEV1%J-W51vQEve1ut(Ui%U40SY_4HehX-POlwiKTIy$zJ+_rB
zF2HQImQ_nzFCco{>O^Bh(f$jFu4pBSE3>$MO72imJGmqH$yGD@{*tA!=5pHmT1#h&F7X-ZS)YH4P${+q7|?m5mh_6wDYm(Q1uFuq)P1
zhQ{>TimZJ#G=|r%8WgdK;~E-(#_ZbFf+9A-U5i?5%DcuQYi}|dlWW(Q>Ha>;8mdNP
zaP6u=k+n1cimY8{+OdX{;q^2oX>cr?zpY&w+UU$#C@eByjjw_>#266QqBp3Z4JZc0
zJ%Jll(1s5N>Alf6*`W`1FBKZ4V$&@7S}t>=HkqD~%SFjqmt7rayJ>Y?FPiyYYHJ=Y
z%`M(;Y##jX%C?KQYu4c!*~0m7V_#_z-u)yqHJF+p0RZ9q(!!*?E)KIei{GCXhq_0W
zv?v4S3ohdUt&IG_g{_o_tO=BVFd^BZR=)HDvJWL>p;oB7MG1T<0!sL+Rzk}Qq7PeV
z%Ma%VNBWy%`9@)&IMP4OexOxXc3`HO)?I5{Z_T81;kx@33v3Y=(c6Wq?N==^
zGPh<%q$#4iD~H>muUQ9y*O2oY$mu`h2dtcF7oN_(2c6XKQI(BpCobec0c`XKq!7G^
zq`#T9ilZalE&pM5K5LUXj~gQ&W#_#{8vrBw#~uLBR5ZMOOxR4vkp4+VL;!88ewqQ9
z*}Mq;xwRR;njIT64gaCBWIn+w%<*vmmMXyB8d#1t^QZhAP8sND<~va83tJ|^5A1F?50k5I<>zsFpd8s``eGd!8%~elFV(t
zq_SuVJ2fh*mLHxo4gaBH_(M<#f0Y$+o-G2dB#z?m&He8v0}cmPxLg*sHp*}j*UKV`
zm3pB$JUY||H&gR})G+%oXqx?!8iyO8@P_>@>G_;N_!pkqiQcbY9)qXk@zweCl6`*L
ze)j(S=DcmU;Wys@*x^0oZ4=e+Ua3%p-{!J-`&@32&!{}!Ex6gaw3
z%9ai9kW}uzv1j4!8F1EJwX|QuOElo?;omPA`2*HCf5}p~>CL{$6W)J>XDjf!efNOZ
zhi&a6<2Jc=JPUFQ_>BbIHg~tat$`aB+$C;LvBvV|QF|8N+laOETX6#&9&T^n7W@jI
zFl|kc&3*B>sKj(=Ge?tZ?u!VEDeHhW3#eZc=gbNh#!uyn(crEB(GqNX5
zVuLoz$lf%GP5O04PEV7V0{tcfwT>dBK?^N*sGO@TS5+GB4D>xBD52XwN#7<{gQ{$1Xc&hEizK=Kh^@tIoa63
zHz%!b{LKFU*?aRKNsA*-w5qzr@Wi||49y?!k7q1q^Pa2*vmL9WFJ_pT&C1N`PEl2v
z%FODfXEd8zbSF&>-BmqxK(}^Q0s#^dr-Z~MBymX^om@iqEd)s1H%RCN3D7NZ>E`|1
zBRuZ-GMgRSoyA_aRpytU|2)FOBf{hIh!~x$(!jfS{h8Jxp#DIMMfC@Dd-HU8mXy3H
zkEHrjx5%T?NOm6u(j2eMH<2WxXKexcY8&WiMp9N6pxD4KhK5da?xidk8Wby
z+jiAqVP8ZaZRc^j_Uu?qchg|6f6aCqANjV+gzyq;zPSDRGE)8({N04Vs1JdTi}WD|
zPofN_?Q^~MsRLy0_|YRRX+x0N4plrY(o~t!OH*YcFHM!H)ihPSE7DYPtw>YFufnIo
zkf=M2lIay{I=w_p))d#kCV_B
zT(ME*yiw$wn8gK`%?@3MFiamTq4B>O0Xc
zSSoBji{5FT$^+*4l8CCTaeObadt7QmX8Ke@t0%2hKMp09){$mO0<|!dyxUk-
zrLw}L!Sn!rdjRj1tUD!HIBK}w+}=l$LQ#^*u^=ZY4+mwnaM{-y(d?Ux1=F-EDM@1t}Mzgzms&GcR=cP$h!v#7Im4x&OC+VqVJmF-u
z7j0IRPo_8|_Lz$rJ;d`=iYu)`YW~3SV^N_lRK3)vN{g3p
zTz0WYzn^Uc!*5K%N5k>NsF@u5gyfO7`4h7^^?R5FCvU{U2
zB<#I`%D=*Cw0*R`)P7TvDW!TfXhb|;&9Q{)A5r5+u-u$uiLzisjU~Zzt7L)Gb73uH
zvmu@Iq?SWyHail)be1H5DqHU7v{U6(7hZOzy35PG4cQS#AAJN_iw8pXo~)z7`e4W^
z^*>n&$As;nkj=9LN#1eceK_Q;?%BJtKgqLBcpeFPvet9GuzXX>2C0=BpxG9WT4q~j
z*g}uGeikWT7Y}NV(j20+oNT~_tvXqJE
zd4-=@Ag3mUR6X3ETO_3>1yn=pUsxceCIwUj)n8g5r6vVbqqtvLAf+alaf5iAASm)_
z3*^+qNVcv(K4X!Tni$Bf8i3DQAf+Y(DqRBjoCQ*9BA{ssp0_|sO)xJwY8!xGTOg+<
zM5?HH^kI>dnh>a>Cg5)^kWv!@Rog?r-&r7~CIqTBpMbx&KuS%}`Oq;_z4?O$a%$2@
zsyBbMNJ>o_NcH9g3#8N}fn0A+SwjO7_V%LGB!OISPPITvO)$r*Qp5G;4Hn3$Ng)$pSewF;eQynHEW@
ziGfmY-fV%Cnh0p>&08#xQWF7{(xIQTERa$Y%vX=udULh~a%w`PtvBabB&8+obIvV&Q=gGH=WChNXUUiba&c;R3P)S#LDyckA<*dt-sR-n$qWeQ+3c&%P)y
zR%VMe%L3yjz*hyezw6Y1<|_iDVv-1L6PD``+D!tZObx~f
zDh=Ez`>Mb=4FQf~9mNNNyIF9Qh6HR3i2&>tfl(R~uyv|CcB{ZB4GGvL)fxMmz$gvD
z=m2TpP6;CYy1+OM0S=&b1O)Cj!BHAw*e2?`0Cu~;C=C%z4K@I~LtvDK2sXx}U%>7Z
z7^NW?6C7nbV0Q_O(-7b&4|E#t796D^gdqVs4fhC)(h$Os2h{t5aQ6y~(h$Os2h{fh
z>^^}}8iJ94_MxEqaKFGf4FQe>qr3p_0l`rk5->oiK0GKeN<#vs>%&6=qckL7x;{KC
zFiJzv|5s_?`tXRrI1K@g(||-kxNiuK(vX1Z`tVJGQ5q63T^}A57^NWr)Aiw70;4np
zy?&&DiU`T}ZGmwb0vysH_2D~$qcp@YsSn>37^NYCnfmZOfl(SFn5hrn7Z{}>=~(G=+33{d_+n5+O|?5z-VEVbt5`r;|z&qC(p%q$wmp
zn!*yKNhCs=LLx}_Jr*HNAraCP7GXT6gftIHAU*Y1f;5FBNK;sXG>MdurjQ8IE00A;
zQ%Hm~g+*AOQ$m`DB#;hxEJ2z=5~L|CL7GHLNK;4z>59i9q$wmqn!+M%%qf98^=Gc7
z3evz5RK3+{EW?G!?_*NyLH}S<-t0oj4TR6MOkF6VdkAOI=07L+BCj7u09lamTzwSX
ziIvtG-oX-0?p{2(yt1^rqgFz*@?Yqq?V4GNgS*QYO9CdR>f1VW&*(6H@G6gbkTo7(
z1f7C3#KucWxRQlZlAAL&WeHiSo^*ee3k&+jK#{@;_FfUVJlkwmXWAXCAP?h@CFXA}
zutcaOO^`+*-T&x*%bk1X(vJLUzvY>|_gktEUP6xiNB(l{(R8n(xKYanLfpDX_0V{~
zPRuQLOFMTi2_087g08Y{BqZY2MiAjxDrmmCu`{uH{PEo-atoCAhX%303sOk9w%tVF
zyvDV_o?PNtCT#z=!xqwTYcB=K8%Nc)OWfQ`p=nPg2?KZd;w`O{x>#K1tKS;G6JZ!p
z0eAN-F72Nn{|+InQ{h`Jy2MQb4GPiQorxWy3n+zZZ{W@Nz6F1`;xF1;ffKB2W^={S
zFl_uHb1RXekpmRpl(n?FcSUL%-;;rUL5-8YX3)1)Z8-=mygYWO8VL_fG~8+ochjra937f&npwKtsRX
z1`v!k2|$CsJq8dA7A&o78@;klLoi6dCEn6d8cT6d4%A6zQ+W6zNCD6zSf^6zQtQ6!C3}
zDRNA3OhNTmt|-~?A*59T1?1Xo@YaKy?=nAgQn=|mHAv}5BoO%tao2ehwu{W?7iaZp}{}ns?09yrY|sX$bj>j+y8+>
z)($iX%1Cp9#j^v0e>L=q^VaBK{5F5!kb_k)@>)0B1Bd*n|K4xa2M#$@MI~$|wxb6J
zHxC{8hcyQuuIvvQed$>Zs8`%UJM8}%q%%Mmqr(_D>^!`CndK|**(s-m9He6NJ6<0g
z9Q;S>c+r^*U&r5V_`4l{QNIgoU9Byq?mT2q4|2gw;9BkifdQ1_(xF+T2+Ig
zleL;YM%q<_q25%>$4JX+Fmz)<+sBv=iviIoU9$lw(lp&$ur&Zhs-|NKw*{a`*K~Wq
zu>mMjHeFz_Jpe`8rsJJngH~4Ku-9y+ynT2|eREISJfp4kLo?P@&=JBI*(|~|z*&T8
zfU*eFAZHP#Im#kTtCU5U#wm+1ZB!OvnyM_qHsE`z}Js(PMz1jvoAIf@~wOQV}
zxO-)8SGPI0fXm;)au2|Y2MEeM8K6}U5R`YaJ|}sApsbVW*@r^BwLaA@VWe1^!Od*^
z$t74np>%qIh#E6wDVZ6vs4qk2^UF>fR28Px-LbN`WX!Ya<8rV5bRQ(zvmi23XZRq|
zpaJo)?~Oi4v}i#T(wlscXwraqe0Zi0602cB6w;f0kQiwL8mDo@TYQjMX$zu|&hkNG
zrVWUPq-XmevC|erA)VucjG;ED^(54}0V>k@dJ5~j02L{n2g2tEs7ULZD6F>zs7UQc
zkz8*JP?6q`qOdLqP?6$G6xQ1VRHXS5h4qdA6{&uL!n!a(MY^A$urBgZW&~<U}NF6D*tk;{vE&gKLAdjZ$lDeu#4mr9Q
zj~rdBM~*J$BS)7uEk~CYEk~F3EJv5tEJv5NEJv4?EJru(SQgMrgQgA3hR{ogrv1u>
z&`XPEu$m2_mmbZ)H5)=NO`1V$E(9}_%>sHA#xcIM{Tf?ON|g$Z2W<`OZ>}l!2cMgu
z7FlRIhdqW3l24}ukxpZq{0m)+0^U)OHqs1UikFF{5%8k!-ZWUB=xl2?I#MlDi&H%B
z`qcm_cE!vo^5heBC2kIoVq1J94OMOlkYZnaB-xl-1Ekn@56O-6*8-&2cn`^q@Ye&R
z*m)1hP2+6=Qf$445%Ea_gwS+8QQqGhLX#QA)A09&&}2^Wg#7&>G?`VL{SSoDWL|OpKNvz&nWd)d
z9}1zV+)@+w4+l`wOuMeW!Ks{6)#&#zIGuH5O#cvr(|Jc_;*T*nnR#qbUx>lU++&k^
z$`F-(w-m?Q)2Uu^u{bpbC-aZX#T#O9Dg%{aJuL>Oa!{Gp(<5+!aXljjr*cr0jW@>N
zR1PWw`=%J2%0X2&&WylCM)obV*IP2im{y#SVV?g@%s?fEA~ckPyFuJr;R
zA(~S*c0ElYU#LYzFgSUBYgM@^=_h4cofwo;ScXczKZBQ3jOvKlZMqRsv2mfg!ce#P
zRPM`Msbx{@_1R__=X&v%8iVRbC6$gt#-A~5%QlkdgA^kje~ROVa2|#y65F&789+#8
znLey#;vkeTd6{fHNwJuWSV*oLRkS$OIUyJu(2rY0QZhd8gA+%A^cKxTm646;TDUJz
z)Dv~O1pp;NYK7Byf6)U-9n%0B5`4)6_~nib*Ovu=s}a0R8KIf|uV}49hFqyM;>iHn
zE0u;SW4bg|hQ<*UQc*75PEuA@=XQ4{78h4k=RuA;Q>kUcdWQ$orx*D+E=+ftWYuvp
zOTFIaa;+XzsSe}Pd6k4nJS6CYLu%%RFF9!hy+7sBK%<3+99Xj%z+gk^A7BrYoD!g1
zrJ_B@+5JFwktWON9^#+zRnQ@*@hW+uMqR`2Y6%efW?U8%imC#j2KIX{u#N*&LU9$8
zn%D2UP>g~zSk9`)Tx?@=DT8He^|+7Ch0A8-2R^oy372d34_$1tl7_0D(GxCoqP0E9
zGHTfI4?1|#W?A8uW-t3F@2aS9;%cH)s;3($hY}h1l#Qrhhq5X>lF7Ohs}NDp9V+K+
z0bONh0YK$pA%HTj5J0(A0D#^LsGNaR2cOY-)gX`M&cyc2Mn%f4XFcea($r*UTfHe4
zBe??*RScf<@ENG;13m9SEA`olscJ58>=}VDzaA>%1XUJ#y3{(xFJe?gsG0+J${Okk
z98;A-XeO*n)R8!KjmlNf#oX(3tXscf`pSmtMw0yOH6DV7f$^k`Aoxa}L0`VM-m5KSxhmpSP1LNu-6U!l;WoXq0D(K9rDJ2UW}coFBV
zAHREU`Gkz)4*YgLiy(X4i6bGrlpJ?H0FN703vg$`_JKp>7t9MfQ_af2Aw!z3-ZVD1
z1`b&hylTLyCwNsFIOJvCD_F&WLk{v@HJbI!&C>M1A%Eh%Ci_~V^M}dpN6A*MPdBEj
z?drfG|Hpv#AW_GB4IK8|z~JABf6bjJ8F%6D?v#Jc=0>e<+-t_rTi_QxPmL#3N!wBg
zR%>kGwufF%q+iPgU;$e03=3Yvuad883tppxl6sBiE%h2QrC!(4uV0mZeGIh-TSPG#
zhi_Jza`Kwd!I&dSEe-c>Sk-==iY>8*-Ir%wYV^{#AbgcVFFJP5$bL@HVq
zsT#A5$}oMfOzJ`6Y^*kRc4q30*(nUVRf%JuN1v4pN$^(c+c=9~C$UYS`(IM0jjJz?
zRUQ%U#QaJJD^^u0PyvYukp4Y`toX+KLc$k=`sSBgfV9r0Gr*IeS6G0w$`(NF=9Ly8
z!%GXGm7=RGK&HwJfIIS6TYyZD836a*-)jLfqiF!#Wq+Rq$TXM%a6kS179dk!0#Mzu
zf3*Oa?h=6NjD5fY%q*oK)GX8o9Ym;0HTCo%2N5WfI{(nshaE(qO&Zey@ev0Rs1srk
z;-d~C&?m$o#5ERS=e~4esFMiDbsAEe>BK!rgu<(xz+F!h`>Kr9W`?niP}L6lexD0G(~^9CHfOOPpph#<2C5n){}4p}&lIK=ND
zBFI8{L=aDdh#(8&5dqaio0TZ(*|ZyPf;hBn>W%+E%)@SPx0!;|T3lV)VRi&L^GUY{
z5UB|oLN@1)03uaELuel0&Hy5HK|^Q&a#sM6%Ag@+n(huDQX4dc`tkP!5V0>BLY?<}
z1Bh4{4WSh10d6Q$`IERB!cd0jOk~%^q|U;-F%}<52`EC-{jJRs!H^;U3y@}$mpKq
z(gPDl^mAQ$Xuk+>o(BjtK!CR!Kn-^m`Whgc{tlNOXo%<+y7WLpM1QBDw;Ht|d})bjbnG2>X4Qu6~n;bXAEE#Vg{O^M*FiKAkYK>K4$@x(jdDC@p+2?
zAm}>~;0qogsB;9k$pGlGOut4@x8bWUJebOfKI)QgTq^1GO6Qpj|bQi10FPhYI}>vK0=+MM-6$hH7(~CD$7j$
zp~noF;@^TbGd~8xJZ>4(KU(rXGR)aayTqk^5KWMqR~%7jLyIUO41P(HW}r660C
z2~Nkww2T}~%S6ZKG7}`MTt@30qV#$Ly_0E62M9_=LS-q^T&fnQX|NAzf~opxGS&Jt
zg(`fSB2_s}B~wJxbYEJ-b(-goOSKu*PN`oraG_9C)NKejN|s4FiAn=>tf%v44Cc#2
zY-yp9@DV{6Z0~3#N$#D0k$b>*?VVrDEF~R;wWMcy?*Z2#yp)!bK7&2rHhXJWz8P?S
z!_3p_k_D6|X>G~*4Td!X4SK;P!fe*Y*6__kulTKmF0=k7c=e)=rK&;2u3i}a*5F`s
z=oLR$qa!!d>LvhpCf&$rC(n(TcEa39s+JT?R2K{mc7|T@skJ&PXS&=(#_wja7Up7T
zS{%_R@fl%){Nv!@($Fh@h9J#MIE6(&F!#-A#&c=M%KYNOz+tZ*8vO4=M?U(pgAZrL
zVm{pNYd5MMIP9-^Upv203m1p|fOoa?8&==IVXwuTgLE*M_8&OxsG*@h{}Uymzs3Fa
zL)eohYjF3XZrz8!`|%g;aYx%?mf+}OZu;GG1?RL^i6;!6g+72YL?Cn&5@-TLsF0_ULw}Y>dOA|{vErq
zwRb~DhPhfeJph2=f-E4V|??;ew=X9eJ9cSm>rq!3AyBxj4f<|f_38+o%bXeFCa
zxTEZ&MF>g_Zf{l!UsybOcX#Km?oK+N4cBRPHXb)0lwe&*F3Pfujzm0kpERPmSW;Ii
zA2U@zX}yvKZ+3UhFC()$gHODEUi4S1+YJ~5isFF;X2!jFw!s1
zV@TmW0|KabNR?*KaG>x$FukLK!h43p3a66#SQ9RQTG!1oQn
z_&Q5TRPF|kNvd+UQt--!=9%2&_+@LCUdJPw)c+HS5V^;BrNt8eQ^cy*{(mY+Oc_+|
z9FqgoZP(8P2ra?KEe=q-Ec{$>^{ojIMGN_UA)u0I)QM1Q^_K?IoRZl!7o}ADD?v>p
zg(5F%#P_tI+Q*7nmZ12GPj(7_G7>(lP4|2Z8
zA|s1P5N#1Jx3JJAG79k`uqzx?WEB|)^#F(ccA}ivE;0@uz+Gi=k!55Uqyy|~3yW=|
z!m(|9uf-*-qXKf*9Jh{(dQZ)3V(v8|+PX?@(Jy=QCr5s9E+pN&xv*KBPBRG7MF#`RuT=OVhU!&!)~xLG=C
zYnDb;G)qLi%+jPXW&wVC5GUMg6JoM$7h;-e8xkbjKEy<)jfjc1orq~pTM-l8_9CXb
zZAMJB?M6&<+K!m0+K;=qI`EnV`D9{1+My{keIP?*dg&q>svkd&*-%DiTGO?55JWZJ
z__PrgkE-HN;y{|{S=P4tLL@>UF(`ze#UZftlyIEg6ZN`AMu?L}^yjUi+U2F2wh+OA
zngxi31|u7|3o?u*`L&tNk=iK5WJTZ6i#d^2;w1z3X@|EpRoZG~ZOU8_GO%6Vk_dtt
zOj6fpq9BaaP`OrGHWYM|Iom!Tg<^6IhlbQ=Dm?&3_+Au9ahU)gmx;$BKC0233ijcY+ll<3N<>0G5%F<+Rts@4r1Vm0
zz|~Tw{HoI6v!+U+=;}uiFU@95mTFV8&2ZEMQK`d&7=K0AN0~^6x$5v_fqv3WlB!Zl
zB%6?^bZMiX=QU+2$h@A6ZluXF)H4JV^^0TA7rdS^d&Mn64;$@woGdpM>tA@)fDFAF
z3dq4@R>%DZARU58hNK8q<+63FSDX&V5ieHmOc;HO?$yzPgvQNcZ?KikYfov@5)VnO
zeyl=uJf`$H?QlPQ#bqao#y1yzM_>{L1JgS#eq&sKSLN9;Lo~KMm#!`%!LjBmt<$J1
za$sWFEO_9VS0~4LlJ+8DD^JyF`6|74j1TYwBcI%-_j@4_JqV^vw8!$g>=Zs<#2(uD
zu^l1De#DaHLo06JNQ?8Ud^_p`IT;I#|~Qm^G-d}1Hbk7hf@955x8h2
zmaY|249yz4r=@b4&!prpHC3-4sreZAp9nXID`a6<(3#r#
zT8M(u$S(gq>ykSfjjgjf)6DD!j}QOBLYfH(Wj~#`Z&1T(e2O(}J5Z%UDv{`vCWr{0
zWco)5ty!I_mnv9Qr7y}fdEyp=SHH~p2rts7ZT{q)yK=^zeA?Jv;A3Fz%m4B(Uo*LF
zsy6YO`Gp;?Szg&QK6d=Nefv5(gqM(UM`~fW2fl&7Z{qJ!{6#jiv8`!MCjDq^t;p$S
z^pj31nQGCwR3k8x9$@qcA22#Fc(ex?3jkvSgMZ@z#sk3kz~J9{fOP?29ga)z0P6$5
z`hmg!>;X0efDHqKB@eJM0Bjr>ETi0Nj5?4jc_fw>itPNf=URDWeb;SY1v3PQK
z$>SgbO4C%M0!P;t{ffw8EV$sr$4S7PXY#`h1{ay=%!9YZEUpN_d1mH`n+xX`nhOd(
zj8)sU7?_HX?A(8iLz!LJ*gbD7<&ftivN)vN-2bgwGgac56&j*?IkdQQ%t1hf8?eA=xtohvt>W(ag7@6j9
zx+9A^Z9FW*Zj0vjVgBTt)K5AWz1Xzuc|?^ocQQ#}OOL*Uqtl{JmUvP*C0u)c?JMAt
z-jc(m7qRviaLGm+hfA+#y*A2QeU-?t{$@p(XRV4{lC)O(go{<`6V8sSrw>vxxr4B6
zR+ZFNv$Jh>l5PqyB&_k!a~Y)81W0eRB(y$tL!=*cF^FNDfP;f@;(1{3OiSBZZ#661
z4O#u9%Rmfwz2XA+7dbyV^wu^X!N1Ap(O_o1Fi-=DgD&nc2$&5Cg!LeToKH*fgeq8E
zGJ$NH)p=z)SB8Wo0ySL`lSp4#BJ`D|DH*e5R#gF&m5`;g%BZ@*GgE0GwSE_;=Edni
zVl(~87dcn3_vEEqcarx=a9;`^`TnE|;ic7`wF+3sjelaFli2Mm_Ar;^`HfhqSTT`AU{45`B)OAF*T(QWWfHSnwG+8SadgSdkB@r
z*Fg288;vZLrV+553L$&^p>uiE(tELM$qOLd4AY=fi!*~mVX_F<_O`x*bo|F2of98Vj4dZhv#RcpRGd#Mmo>-%_fSW
zV`F%A7{j_E32|Z}*yk)e_CvqOR37IA(hS8YR1|mmsZ*&H4JmqMOV>k3sVmgU|6)VgV|7uP
zKdFfw9w#OGr`jMa#9*1$GbX`!Z!N}PnclNtS-{;JgU!sNMUxKznbUu^Nk>7Tq(`~n
zRMR-{?JH}v25EB1)BDA)*%2UVmVR&DcKu5Nhbiq@0uaD3$u!tyW
z*J%QeHwjs$-Ud4qJZ-ZB6f7dQo`GfeP)blz&|3x_flvq&Ln}%zkY@$RWN~HJg0ll;
zTvibx-(7c3fQ$<&kbE=UxdAd!N&)4I=gteDW(wREXh8X1x$^_4oeB4_d~e)a1FW48
z_pnvc)!PE>dUIxkhn*zs1=RDVOxS|5GfW?|zU0w))9;wj2ht*55uu75@j#PWOhf5S#a$p4R3J;ek
zuA|DM<4O;gD6FH(RsSjvmny2G>Ud@B?b59x(t^u;bl$56ow+8NS~W?c71_yw4ImGZ@vX40!G+-fyU6XDUOu6MBU&5yC6Ov)IcIqYoHAn(d&X7-UHTk53
zlJxv1TVRx}GhKV+8xkogNm2^Vkg{A#sYx!VA^9FGN`*P9$^@#e*k7hfxtd!rs?$3o
zc&`MGS761{2rD@vz1flzL(*FeH8m!s5{5ltN(jU-j6XKA{H^Pmj#(!sqR5~$B-lae
zJuCxGPD3@;oeh8!#tBvj0^OT}rv`=Ss{wvr49EC5-ESNtuTAjWpXG^XHODp216iKf
zF0Ru&4`zAfyeHf2t=BvcWqD+s+45}AJP&7iPOi_6l9o0;a<(Z-a0Y6t2)8l!js6>oPP5MEWDZb$g9SjxI5A#e>
zi5Qi-^hBO1DiNbnnV!ruMI~ZXYSUABrl>@qGo;e=qdZeoB1WY?{W#AQmk6m(Kgl!2
zB|_@cPxDN1iIDpAvpiE=BBVb3Jj*mb61EegQlEa2XNpUN)TducYp0r{-b2l>+0xBm
zFo+CLa$r*tN*bv?0@P4BFsqMHrDxj*R1VbY11f`%KA>{AY#&hRX!ik?vrGDbqVJm=
z?t3|<6+0?}$9}?<5k)`P1IRIRa$Y~-9zdR%v1vcy9zd?ytGMl*dejR~>h}Qh4dao%
z^UdDX-CKsS1IRaALe#$u2T;|<4j|vg4xqA)9YDUBsfIqv!`K1j+xP+G+c@6=dGQdB
z+QwRAc3gnL6NX3rK$<%2mn5)Na}tNM1ouwb4XMLLu)Xa&qKo2B=f00b>@UGb(CQWAO0IF%m1PPnlKP7XDFJl0
zr-3GRswQ7&!Ae^uMjPFw`MoFbIkWM;eaa0I@3s^?Jc)w9YB%ETDY%>@XKDw-X~yG@
z6g=J_M|hfHyE6q(O<$<3cz31X(P;`4I8VLZor1^vJ^|-hxO-A?Ig;2*Do@MZn}VlI
zlbU+DF9nyg=-trO)XV)TcxstP%@RKl!r?CwTS+o{(E5WRcyg*19cu!p_EdW)gtu_Z
zSu_kVYk?1^;L(r}Ii!SnB!o{K)1U|<>Dd55`fr2`gpNj!EIcLln<2bhp01SIB`{TG
zQqQR0v*7%4P4dkVzfh>kFpSLXkY4#&>3?8bMvti6N#R
ziU}sGh|?ixhnYH6b65`7gb_B+uRLO8-=@)#i7L_-&Y}xmU!zL~_X#g_zRasv=r~(w
zvd_@@8d>UPvFuX~a`WjG{3gsaZRk(^H$b9OfRZpd|AC
z1(9Q1tIs)=K33lwX*agc%kloCnCwT2bJuX74b$YK2NBsD)&{ls=Oxgwy(Bm-o1LFP
zN7HN^HnsO}O`xOsHAYi&|F#4=nph(=udZE?Ku0rbgy!P(_5?b;0?q~M9VvKHD_ou~
zOu$
zMTmAT^^j!RCiuz(I+R4WR|xy65DnjMKZBeG^y&~?3A+ML>-pXgOg8`obx6xWiF{uQ
z9?VB8jc{hZ-Gs6C2gtm7$8J(-T4D^>m
zv~zcjpcR;O_!Xxj_wFrCY}&MGq>QuM;l$vaIhp7!-Q_nD+_sFntPtkHN#Wt`ip~!QJcO!isJ)
z?>-L~R`K;59A)zT9xkkaN<6|n;NimJi-WG{A8-#!=5h}3DuHqSkM{xi*_58tbTI7k
zl5#0^Fvygi;i$ZzQQIS~xbPyz+4Ecf0-2<~wLcDp&bgukW=uen#f}tB7B^BfS#
z*iU-6pkS*y$l*QZ;evuarUga3Kk{%v!G<>g{{!yF9xf=@<2JmXI3;CFE#(v!Y(KxU
zWl~@!oAfp2{sJ3{pa6>sxL|An|G6tR3R$jzj};Vfrez8^(=r8|X_*4fG%n!3;SAtS
zkO`kmtT+w~{?>&=UYS_j!r90cg2adZl;d=--S0gJRu3W+T`l(q4~3P32u0Vw{n4Ue
zltRcllIR5&5{0sXAg8RQAs#1vqTXzpbA8qF+C~!kR13kix)FqKR(XR1NrXa)I?X~_
zlkF%Jx&z^K3!$SuA`GSa42z+mYlNYT@7`!JQy8&C7`lJvOgiRClAbs}L`bwZ4Z78J
z$L#%d$c`UrOjZRU%dIl5fLs{2%CIcA%B(z@Gb&3~nUp2#3{sXNPPfjREW6H^9J{ha
zq<3y=br_SbcHVP9CWT=L=x2y3Rw!)^VYiC`zsEGvzI`
znoDh~`l3kWiHrP3vU!&ZOMe`E93C#^ft}PT866v@1aT77!`~i(c@sVaPyI$@YFCQd
z%%Sm)T2V5uFcH0tF2-EO);29gt?yDA>7!b!0KSl*0BC2uz3_Pc41KD
zqhlSjVy8VuC@--ELsJ{Fo~Nih1$&)D1oq*^G$)t7B)2$FZQ6qO_=(^@Edgw=mYT!#
zL1CzG2zV5w1|I$pVR~_4<%G_w<`!1xmi7a)I=`^uc(%aL-+(5&$1TMuni+?`zd=pU
zE$xs?TXaCA=vy5~Y46hfZa*%XG5?wanVt)Tp^fZccL1+iUFiBj&@Ej1vv^V*6x;v@
z2Jd!I6peiIDn@sSWoED;9XG!}P(7>cQbt
zFTkd}rQi{djNR7lp15;vKa~}H`HCRv;R5fV+N<5=2u9+=>D_^C>+W1g0I96N(cJ;I
zPgq@w1Ec~2-*yK#xilX|OQi<+3mx3anv;i&Auf8E8c#%ZPU!}r`Uuv$H)QrbSe
zO?|UE&9knkzT$L+&4IMudZ3Kjdf-HBJzz>{JwT$fUNBY}nIBwfqYPzfs??nBP@(GR
zWb==x02(76lt0{hlMP4*`2S~ssh=&A0jCX75iRYWTiR2B(-xJ(%G~}|cXx+=>KZJw
zopv7J^emeW!RK_QPu|F@$`ogueOxmj{XCC5oL_Z6dcfe%rJeZHiI9?!DAzChok?TG28**V0cm*
zAzW@_>!h6L)Dp}U4l3m{huJHHg;Z+{p6O6j@;RiqVeTHxcfzg2EQeh
z#yG@R9x-gH0>u9p?(TBQ>mZCH;Jgy2_`^0Wt<~dHZg9DZ6z%lRugNjt9*1?&WVT+m
zgi7F=Dpl2wjQN5&K;;|8s)Vy?0bejDNLzpCAL6^QkS`p4*va%y6!Hagh9h=z{ZoZ}
z;i`_EZ2wFlU$9a;Vkh4}SI8GGf7-cCc)S+q^QfS*A7%9Ur9!@F1+8Qlzf#N?E`LlI
z#;+DLhDAotLnG^NDP|1IOvS|bwIaqqGgZR{f7-N06Xto+aNQx5S{bd@>;x`zp=&wl
zewWC8xdy|pKB%j@AyFnTk5m=(K)^B&+*imlG29neW{Ud)%f^nrz_PQWFR*Ow=nE`c
zsrmxT=8nF=W;<1XXxUKJANqhYar8iPvCpDJ)qr|0KggDNo--7ec;g$7(HSi+kBs0_
zSDID%8P~IIb0>CZ_wtmK-VVj5afAj|)iY`ceqO*9nn}e)W4&J#aD|PB;-aA+d@ErJ
z(jtcTN^#LR5I&Xx7vG1_tl|=LTsEETAn|pRaJS4c(#_UsMj8V?BU!PnbWC-&p&Vp~
z*-e(aDf&sW%W(^
zGLKwj$(0m*Z&*W_)1KecZLQ4h*;~cEoX&xZU}27Q9p;
zm3tvYEC0v@Ust4e36Q{!y$Hqj5R%x%oJht(HrMjo|p{6uN3
zq%kTjy&-ZiYdRDqIcXJMjwV5kMGR->SN3OpnD5yj=c9&jV`
z)G+>75&Z3G!4pEKvjByNDH$JRp~`c+=Z|a6?^@`nE2U4$7myDH3^UzbbJ$juWZ+@m
zhb0xf0@Z2NHqQ*x2PZ>4=yb$V=wxJ25;djcqkb%z<_WD6JN&_O4q3tR=^}&!qqe*@
z%n4P^5juS50{mzK%{_LYKjq7!N>V{7j^s#}QWu8kDb-(QxmtS`7gtVTGC8;}?(B?@
zEq8ZhQ*%>>Yji`Bi|RY#x;ewODak|?A56E3Dq7R^I<~;5GC*Eu^$Kt0sPjz{=24e~
zOp2sbGrO6riNTzZe!(O^=@Kqk$YVFK-K)!u)!ob8Om_f
zC63lh5sqabh5SP0BW_0M*7tUoVAK{DaISn&2L3X|k}50Q3?dG`>5q#Ut~9{;Rj3HO
zB0p@NR4XU%Z5dC9r4#3{N-^=l5Qx$T7aU|-8~vK@QhRBB*DhQ^q&hd$&xwn-E~IeF
ziP&`KBFjg;aX9Kkd}wp{R+4OF@Y{))s7=jtQB*HTL7}b`j(Bc2YnwNtyQjZdrRG`d
zD5nRl)MB`k{=V>%?!Le#y_9KZt+fi7oZr2IJnPkiJ11rtYa!Q@oj%ww#ByHDvM$F$
zwG%9FjafEjSyU_+uqz7Xuga#$+7xxl)fZ=yJbHQLCtItq2&q%s2T~`p52Q{TWy!mp
zlyiz<{K!AU8QPAIZQPI^r;_R}?;XJChVf0wAuF_x5U%VU!X`Rw*|~m14a@a5gR6V<
zuNyfkH9lA8G`+7k|Jca7lm=i3A^*Sj<{uqNx|?9~7W^OV&7VF<6+;ZLf4Db$`pi~L
z<%0dAK{;-rI8UKn>P$APuO6lkRhaqVZ~n$s;G)tZWw2i+E+GfXM1|r&d8i;9C=X@+
zf$~s>A1Du<@~RG|QCjaq+4`cj&pSl`=Sb{0VQy(xx3a2R{ZZsuOV*A6h$yt@@
z?C6_K>*_$+w2}^#O>2j&_`QxAu>=OSp;?;5^-k0{jaD%n@HI888ZFhA;P%V(%~V&S
z!)N$B>IB=E$8fql8m?V%A>z#VRtT=eCQ~}Y-}c4nz=3rbe=HAw`}w1z)(Xl1YJAhd
z6G{r1^y(?~lL>r6aOwCzWdt{qU0K;f8B*eV7?pxwu|#ShPcDxg^xqdMOStST(E_S^
z@N~%1SY18=gS}w28er+VKO^Z-!}(5od!sr`AF4?3gU*ALBswXIA;wAcR5bs{vb9c_
zKYj&wv5sOLxo{BjLI{rrAUrRj(tXOy^tyCwOKq}ESO1QZuVCx}5k{}&cRe2*h#q3R
z*$*8f!pYX~BoAciGh7|G;AK?paCAtg(u|HZRMiCPc)NoNR~{9J#sKedP^pfO+DLk#
zgG$#+n%uw0K_z=(Jd=O1g9_J}m0aZFb%}#Yb*M&0XmbBj2NkX#tFXwy>zxiNwiJY;
z+2zX|RJb;*!XgjBcR8qNC0M~|^TNAbSX%qEf#E$aEUkXp#BjL_OY5KZFA;Fa_HI@Q)FE+rby2yrpS6>Opy*)Op*26m?E9Sm?A5+F-1CuF-6v3V~SaDO_1_h
zFdf7MS6&b1?8yXIUK3_@Ey0!7g*i7e!F3ch2Vdr*q2-7YWzgWDOY=^hK)Hk&#^OK-2g*WyZ3&52Zi=;R>4`#fMN1ytkq`z^3G
zlRUjkpPci61vXo$@Sqz+{Gf$Vc&$`-hmG4q7TDU7$P_9W)OI{yF>FPW3S_A%kGsJ6f8ErjIINek^GBNd2?
z1}=1OL^MC*(t=AZQiYlNvB3OTFi=}u;`K23Cjuhv#V9=#|EYtD*173KBaZNAf+AhU
zVF5%g|37z8aaT#kL%%eNtj|o=Hsb;hxgSK|auI4p>yW5MgOih3rcP_{R}y~u$`I5a
z)~?QQxh_P#hC-9?NryRtxWf7&ajBzn^Q?#yTxjl4Ibo
zj}A(j_$7IP`zqtt&K3gfu@Jz)HZTVuV$dE^$_(10VdVHvLxcNKWO)zi5App3{+`4i
z-5u-gA*Dlz%qG&;@h^7$>&Khw^#MHVNu}*KUzDeK_`JxB8&wdhTJ_Wh&G=9SAjg5~
zErXV(Zt>~42zOS@QeDV6Ua2*avuQt(laz_=jZ&*MtiIH^kl(N+%*mtEBur=_BBT<7
zO!I|~jE%*UyGvNe@AgdDMMPtFx_!yMpP1vr;`s_E-UR
z`qJce#}$${9Y>jZt&(rc+|tgI=a#yYyBAMJi@371i2YSPT>q}iv*xl_cebuKNyS=1
zWm^fZ4U@QVxdY$$b`wr(`kRw(o+b4KqU!Ya#bUGlvnm~`@T|a=I`@RdUU{F3(di*J
z&DVV1BvhB+Htku33#Z<+s-Gljz6ery6*`5Pp&Yzb34~r+x!f#ImTFVUVoM{YuNi2i
z2uj1SuN!EYyiPHRoeY&avbPy%r3gyn#oGmvrK0*#R*C?UULkSferP?D37-!w=SW{e~;3Hhi&wvVlp
zwni0+r6l0D46vC5vXBJ)wgFPpQ;RZ^WhCHt46s~HmpB%Zpx-q{#f}Aec=SqVgiJ$c
zN)^&YLm}q~KN>1|11Y8<+^0;qv>Ur!if07;64@V;;u1ddB@?xoJ@8ZI87yDG>
zg2J&63_cw|TPG|ot)$Q#@G}8=YBB9i&)4ieYedEt&qjR)H!#WrHy-wfm`_JwZC?v8
zENO2TiAa|Clp*e4Y@3^3DbmNO4lFJaP?|CZ9Yu7l0>2lUM8c_sxE@-Tg{F|0?CVqbRL`33b42(z
zr102xmC7ZyK_5#ojHgquo?^H$#jqirgbl>-@e~8Du};dgkvKk);(&Kjl7ss&pGO^w#mgbyPiwwFzs3uC7I(F&U5*fy}6_2!yelzF>`o%gD5$
z9~6ppA7P;^_kp4U+y{(GZ67cys(rw?eD;CkLfHq7OJW~5E`ELBRGFg&=>b(F+e>o`
z%g1+@D)UR7_F@?$@020p*6G0%2Q~Fc4jQ*TWQuURS(<50!o9sxYvP#DCYNFUmf{i%
zqLWjAqR1&N-}5D#Uc`h6Hx5b3$bfx6!O>b->dx&+vQWGGSezKTDFw$x>3I?L5T=KP
zQ9^bcJjRWpE@c*p??m6`TodfPU`2W2F?m7Jbg9Gk00q{o$+iMEo1s_{D32@39
z?p3prdrbqJ>R@|L1iZlk_nHbg&B6AV3^?6^7EcG9;UJ4A1m5T%drk?w$pQDA6gblX
z_nH=XvxDt5G4K`#+iPmzEC<_ba^P$S+hcm*90%HCg5X>SN~J9x5Sl51^Bic;NrLlf
zkCQ3Bi9>k}%}g6=TS>*;4l7jQ*RzFrgjk9^Ld-)RAvPh8(1sun(6zr1Kvg~u(DghI
zkjkA$=o*~|sA`<2bKT98xx(hjQcLp)shW9&u8(_;Av`54?|u(KcD6e>R-U?*S&z~*SnbL)VYA@*SCNe)U|->*Rz1=)vw*P(#u)t`Xo)t!Lm)ti9k))~I{h0AQ{s*{|I
zPS+L+KUr7qRE=G;JGYZ&F1brjWhFgHN8^jT5*)crS=2GV+tkKpwS+}T)UBeyg(nHZ
z)pf`pS$H587uIF%z_IN2FpW=mmK^kd!UJNEj@G8%fBBcMncRkx)?YKfu;VoY_%)0B
z2VOHUu)MNoeC+sj`}TE~cg`>Vqb
zLXuoX#8qX$d9R!=gtFG57*7Eq9;}FZXrEjLxcaUyx^z;{Rn?Q#@|oy7yA`8YR0YTWaM`q2nnp^y$t`*m@#JPr#Po0`YD;hjlrBdo0AyoG&wB5ZU+XXP){
z27D;s;xt!tUwy%x3NIWOD}v*afMb;6>6lBNHCV6BUz!A)TckCZPToYw@085I3}F?0
zP23HVYcq>e8nvD&xJqI%RMOTDs=bfO<@-6o+@XLEBu>Z(v_8t-+5c)$t=;f*3qVR8
z9}smED8Y#+B_oqL29oUtl^L*lYK_e-iAV<1fMa0rV?NBRwFpW{ccVy09T8ehptH*P
zK}|rKAIhlEdD5Hrn97YUrOv2x;*5=vGzdo|0gWX=)I+?(inXN#v9`c>9ky6K
z7_lTCBN)M4Dn~$)!D9xI&a}`LEgml(5F(da%ZI0ohESg)snAD6Dg-o)KbDEVb)*u3
z7APc9z$DFM9M#0!>dq#7-rz&Mykl-R&Wn*Awg{#Q)8iSmEOlEnt%d&}gO&}D2F>fg
zKg^&>l=H2EHK@eT+hXDg(#bR+t^Uxcs9G-ku0zq#vj7e=ONI
zQJSsb2nF2xj^%pneZ$c<=85yv`K5Ck#w7fC_ubt`EM3~8JaDVT^reYYcxc@=&cCvAW(!lzUlg3OL~jXk
zQF!WXpR;Iviv>)t%!RV+1eX&gI8BoiF+XtWvOiG7{6KZmwOaE)q`N1E3Z(WsFtJAw>J;|_6vw#_vLdMep|=NH
z=NzL3F5@3c05RNvcUm`YEU5|qaL8bNS!~GUsr``VJZgi7J4&BzbZY=x
zx5LlQX0ch1x
z$*3pWD12k6%-$Km{DkUs-W7l<-Q(w0cS|>wHB5c=dnCuveZj<+e}WO_@QbHjmMja%g
zM51LgqYgupQOA=*)N!ZRmFZFwr~5_Csyb2TsSp=6tIBQUMskqa&FIQ@;leb#czQq0LSSG}Tfq2tVQx2#N1Q`zrH-qT{Y(;#`ABnAt;AkschP4>
zbQ*}%=pgl((i9xX)dROz_J{5gC1lYm?+Il=s9344(_0XqT+fQDD%cYpkYH>wBro->ywIC;dp)Q+>TmG{TiHwHsdR!6rt^5c=Rg
zjgpZiA^}vME_a2hZweUSnqS0(hJEbUs?y8PByEul4ohi?1TzTRLUB=Y$}}z9#wdtBA;e++<#ByU-F3a
znv!+B(KfrBIOR;Nkur=o_&8f)EsUC}k8ye9pvt&*x+3Mtq9_Ayv?yCHErd$l$2mR~
zkeiJL#iN5ySQJJkQWgw`hX$YYCATHYz}WfxQ$B2>wLNU%c&zzpALdmW2~gSZ&$!O7Iay2QcBtKIhVQMpcTneW{1o=$GxB_&zWvZibrP}sV~LML|qGXM?oBwOt{Fy
zkk!ysDG14)*tSA=VwoUpWlGak9+1|)E?T2z1HFswGxg~j8bSL=CfxmnF4M?9vbOhe
zzS>TNNNC;+4BqcT(8>gm=03O@tJ0w?y3mz@rxWP;O}oRD%%Re6Oj8P(Y?edCPdbBM
z^HTA3i1>-!drah<@`5&Rux-ymsOm}xjKB-**0TUN3I=c_k6HlL4KD<|z~(##RJycq
zXvpd(I(aq#Udy8pWhL(5Z*ard|n0YfW__&0IBb}nK|gB<2B9m$(tbs)ax?x77Ose(NIL*9HifDDajiw!~=s~wY+#azlbJ!g^cBS;ALV`
z-u?#_ZnKQLV)idA?wOy%i6BZ?ax4Icw>baIz~JoAk>6N*=;35C-GmJA8=2{nFoyW8
zogtC;YZbqlt&sNz@q07c6=#8i`L(ML97sYEc*5O3IJhY1k^Bt)0zb#!FOq%(+gs(y
z&Bk@$udwu6!!_v`p;TRuA$B#~8(5#U4Ca(Xe&!WeMX10mb-{_IYP3}+hc@hE35mmjB
zG9B6*i2);b!+Rrf!A+k?>Av?4Q+iark#PO)Gj=%4^ogwXjeJ$#$YZFR_4g|C<`-1e
zlrw>KDWp;KKlljQ2doiPBVXeqWDQXxs51VekB}X}8bS5&zxW7QSkwrrg1S_Sq;mSK
zMo{hhuYMS^^r;b4@#cJloH?rzROgQK5wc*Z5meoF_y{>^RwJmU?er1mtX~bGTGkC9
zfmZ2&-{S*FpjO%ny(@qOdZmMXPY57^V(C!d`2Z4VmbNedlQ9al8DkS_GpfH6y=1sLOMR)CRncyYM8Xd+6xoI+cKF^jGR;m9ey
zMd4r=-G`$4(X=_kw=lYXbZyS{EevTrnW8rgwp71iy1Qp_X@9f3XKrr?9rooD{8oyL
z(rGDdYd?IE_9QsSNS&VKXqKk^z{wV!k%Yq2Ai$DUIx~fxY)vP6Bw-z&Wq7j$SYZAP4N1zJGbg@w?K)JB;mq&3$Wp46J>*=j3j@*gMM-!b@m)M+xRL
z4}XR4r}6g;{vzLG?87kw3@#Y-qNj5*K*s)Amu0*)ZHxETSUB&kX+ONTrp55ynl{3F
zYgz^Gt!W3mx5n~&Z>_EOU#C-N?74A>MwK94q!S3EO%5BcI
zpe)D1x>#4_42d3+sA}wgXH|_+&OhKLr-$$P|AL%{gpaxsu6vOR=gWA$K6PnCF{-#nL`I&`pwh02XJseT2p(NX=pm?bHnFt@PK-Hq$j)J2r0RI>z^c$lc<
z^RA6cJ&epK*l=hHzCKawGJG2wKK&((Y1e_x!Gf?#@VS+#Y?gm?_jF4roMf
ze5sfzs%P9*ec5QXK1;q|MOLHiDJEq$Tm)&P7sgk`0ih)?J)7*t?}g39^)6OWoz}_b
zmgZOXcalzrq{_QPWNP1(@v~G78hH?unzihK~o7JI|~;~-C~qy`cHu`LOux=r_=C+5^Qy4@9GMzf`=#5o4Uh|$&(Q}=@G45
zj-E0pnQb>_v96Ro#hddh7C|S2`PdUJ#Oag2ptYwR!Df1=>2HLc|z`~Ww`#Kq!XkP4;H6##$iu}ykKT`pZ9WIxTRShwHi-|U|XbBnQ
z5FJPIvn0xyoM5D^vn{GfvUAAQM@u$CqNzJp)q{;+qO#Hf=aL=yF5;Lca5UbDNdeKg
zktw;@ffY#z*Gnbg1P;15rbnK;u_p6c0UT+svSJwXk+KOS^3@4!Y$~;@{Cj=5#g6qb
zf-Ijah)#vD8?F05@#DURB`mG3Ebf_Gncq>cT|)cmUYlen%8%Tu)K7<=~VY5bhhi0;tJqf$j=72usfl8Sf2|}VgEsOvOXW6!VZJl
zN%jTN3!l9@Ro#kyH-BXRMVv_=FCt0E&7}?9U%2c(N^nUDV;T??Glkjsb(oB)`s*?O7
zhUUfpr4@gsFZq1|G6`@%CI!D^v1+z!t8PO|4qkpAV*UG=B)8N~m_LNziN%!@l6&#V
z=irZ$U|35r
zyB2AQdOT-EaGdwUhk_&+Xee+_#L#Za60OxKE&iTMmyRo8I=FgU?G~Z?x}AL^&M%X!
zSaK;LmNfyka`y#?)TFLUbaEQ4a(;AwsSgU<6?KK;JAF_%!q@j(`yg?Ov5MmfA4hR!
z8++k?e5GYcgA^@qQ@aO|R>p+x7C)s4vox0vg(v+#pih~cFNGtcl77(`AO0gfYfJpN^LGe)osEhM~(K=5?TqA(?()_Mn(Mc?7^5I$mafdBT
zEboQ5&g7oC9Me66PDe@?qOj8S(K_m)Onm~Keuv_Dg9Mh`Tf=!On%B9m_sD1x6rOo6
zMIgk>#9#Pc%0uwJE{+cVd#%G{+^jmPdtYH?VlTnO94>7sH{-HFjpI!LDlQ;o$G+;J
z;8)QMGlzXyZ}wo7S~Z4|>AJ;(wPFyB$!_&P)y*-ATt?&}e5EJ^{n
z)!i205-FewkK28ixn0VX`4RH3yTe1lene4Hb9bkQDw#{AY*^%FcbA81CNh9*+ua@t
zr-jFvPR@4sgs@l{(;>Li(JMG-qyha!5bkctXW#LOkX
z7htRyP%K{A9HpF0JxX^`=qT1jWR&M3G8N<=^d4zzis4NPkMP9+C+SpJi{eKqEh5)>
zkLlB<$gbiD8gj0wwfz@tV+&!%|Bb3AH1@?45%U5-Z$;h#_O
ztk3bN;qtFjJR5R6>sbfCN%3sV@!+roRQ%tjcsAvDHZsreQanfHc+?2`_bHyyksQ-e
z9MK<=Or{`&xmseTKPH*7MPY)OUPv-!%R-r%PI(!1Zpb9M#WY(OD$I0hk||pns?79;
zBvZCHP?ru4wMnL2dC=3Rrze?m1p-HDP)ujg_2gO?@daAu1}&!zaTO+IK-&emZ!3+q
z`PdiS=3rlNn|FP|ZLakNxB1l<+~!nYaGOVc!EJr*3+`0a{_wVz_J=>fj2%6|oE<&D
ztQ|eTyd6Ej%pE5#f**VvqrOuR$coyn0dLeXg0&+t_561{~pr<@uHB#!o#e*ffIkS7=em
z8{i67pZ@|WAjY*UMs?pxySbU>FmkH^*9AEEHw4<#DZf4j1}f4DxFH4xQ!?mEkfuH+
zI=~K}KF>%b!|bI=SIBtI#iA%h{lTO+*dsKaqWL1HvQ3AoG-X?w9lKHTzT_aH0U1x9
zeAz(+O2-rqh4B>!5f)i>_2Er|XxBz3J5||3YD8i8j<32Pb62Lp@cAt_Tg=#GBNB%_
zK5h|AwcU&smDn@!R>{+Lv$lCNd_v4*WY0-TtxKI%hR@8RDY}dZa&*b+99>2PNxIfy
zkq8876bjL
zRv}NilzqF9XEamBpI|Os?Zr!{ws2B+X(c>5P@jkPWQt>EaUsp5mzAE9JY%EPpW9AG
zC^1ULJHY6RXHw)*i<}ZiC$A7`B%zeOz@mCiugc{$81bqD^iDa58Uqh4F0vt>ZQ!W~
z>5e_lW-M1L9bBf4)6Iv~7pF-cb(*}OJty5FpvXW8I*UcDF6_XG56UMnQBC*`!Lt*{
zsB-XR>p2PJXbk1GB1v&|ri`Oo3;pu~A$8t)4st$33|s*OQ+80orApwF;JK)6MZu!R
zJ0o!1-BYU@mnD#~8fZ%ST?u5=ma@C_yA#Nuj{|=(s#WiakzsdGx8RpY$Yi$=%Uu-i
z6%jhWCUT|8-mP%rm3`0B8O(Pg)2k%H=XD}K%;Kp0(wVn;_u_GLyTcmB{kdymbhEo_
z6%LaToThxQ75QfyIB69N^y)AN5ya^P>k65WLt0sV_(KY)MWCYiX%-MpluK+nlde}V
z^EB1}nE+bkCGlBF2troYuBWqsFM*_jeDzFs$BOB=O5Ci)n#8>ZIq|8?-{RtmWWUwQ
zK3T$v);;_M%TB}@sTtvje4iGDk2A{1%xir2d%z;0AFx8J)6RNH?Z%xETR|MTzr*5S
z^iU)L;t@ndL
zV*7xRuKR$In)`r}hRL!$&&uapMz}+mE~{i2ejOk;qZ=5XtWArozX_0;c58$dT7Mg0
zWrPq73PxzT^>>o}t*O%1YSFfVAVpduUZ2B4I4Q*torYqN5uP;rraz%>raF4wMwPDM
zY{t$^G8CD!H~)$5nNGK+dl=xf98yrc_9KKkrtNJc;uy_xZ^DRkv)naq<^#Ajzd(WL
zNP;wa;KI3u9u)ZSr0TT&pk{BRM0)_3UWtso{fRdlhUPqiY4
zE4FEu2wBd?GD+bqxm1yx?Pw{!Or5UFh&(!)kNsU5u%#7+&wcXuNCxtG7qp929i73W
z3g?%yK#tH@cAYVBq5pBr^*5goR|xD3{|;T3Ei{|0xSX(xY0Z
zX2U=2g2p0{s=uFcLE{lf)!)y$pmiZgPY!=hYCypOvO%_LqeaJlnm#X|0g6Nw&}7`1
z;*+_(6iw!K6Ex#)71R9oBBm?1E7i}4shmAUX{lp2pB+(CyvUFODsqBq%e|s_c+F1M
zrmzcdxK>sVWPR*2PUOdx#^Cs-aL@#nX2GN7aef%4$GH%M%fl1Iqt84><
zKT5G~%(B`AH(WQBV%?NwwQFw!gFi{J9+hRa%d7)~KTWZYj%0bAHP?Z`pCy?`^UQVu
zc3|-5N#=Z!8g$(%1%&N}VD;IER*`GVyv+G5T($(%1*&I&GO
zfRoJm!sRUIVnbn)IbXb-wOu-a>VN2L;g$J4>BFZE;(L*A$2GC)rr7NHQ!0d)(BV@@
zK0oxQhm*xMxB1D@xdZ&#*~Bb_A%*WQ%`fhh19jIbFx{+-D~;!uaSVmP4`z}a-mti!
zLzHWeUp~;F=yCW)mmG|}19)*d@XVScAHnU%1W{+PNU%ygwb_pM_y|FXrwD3)sZf-V
zjn&=D<|1JwoZSU2P^FW4+3Xn>!hg`Bn9VstI8+nth8Uq7rczihduh9H5Z4kP`IDEu
zocZ*D5W=DoXZMcCdzCh4+lUZU(!j8!?_?ChK^#0I}H#qnoI~Wj8kB?2#J?XQp63+bHa>T%z
zR}QTmT)?1Nz3F+Z8pEVh=^UHI@1;W-zL(CV`yTO2KQeeNClk4^N!-K%YqNNrIAM)m
zvu6QaWvvo6IyP?3NRogtEiR83PX3#vOv#Gw;VFYE?rn=pJGHlJ=JwfBW8_iC`J;C|
zIyj9E_0hrBo0Vd>xNo%N6FJ>0~4AzU{@AgquEcOLBHQ;=YkE`ztXC9R!@8woa4Sg(zb0~&>
zGzv1J>69xL9#g7fq5&jT4+sRJM1M$&sisopswp$4#0L?5*u{i5Jn2QGkJxn3l%+k-
zNU5
z^=)(rZM#XAxT$ZhEaur1g`6&Qw)e*X`3?w=v>Xs#r=Rlht6EKE>WLK|k8!hyOin+m
z>6%-t2FujQ5A&ze7yWkXg%_(NA&JrJDUkRckpp{dJGnz3?sY-&=?_@yrgC+kBPl{l
z+|Q?~Z|;UZhbm_~e9J^EcXkIQTFoYZ+l8fW2Umrdk6x5mlJ|pKqPmG(l*ku}n^MU)
zm76=lpVE;}VF{ORBraMR_)&mO=DVt;eCxE5X9^3sXj+E#H|M>1Hc|!gYti#KTLzxh
zQsK6tMl>PLS8P9L5%Kk18^>r3=y?YcPRnl?qcx>pTLj-V5qeQ>T1Nu?-a=ygb<_sh)%OPrvG>6lv%P_e{U0ra
zM2@x^jx*{7i!#^oNjPJSIAuuXHgdt-r6&m79*UUGun5GY`igW1po(^25Enp8w+xnX
zvbH(Co6bbhkgF*4mQ+KqS87ER*%}rSC^vO+3rUnc84_|OL$L-p3=VlfW|ogOR1zn*
z{F=o4@0m*EXGSxW(@h+q#BRzssxEC{9JFDM4Zd5s)>
zw=UY4curr%%Ikjb@loM*o!aN>a+?+kuFq>&$1yqY_tg~hUmTI_t$k37vTg3f?(E(U
z%|}elXF6#g^0B3zJ26eLJUzE0SN}>iS1mqnz?N#ft#nLvwlS=}*zU`tG5di4I&X3?
zCvK`pAJ>vi)n<4CpweBzc^I;(aU>Z1>A}G#3YkVDCU$-Kq)ike>!^dRD%CcQx#(y3
zm=jPZHyTN%@uNJb{EC*pwp1zchydN5#^TBGVFo-dxG6->EH3TIILv+3CbHJ7lyZ&`
zx+;ay>$DhWhybSIrChs9i$se|iJrIW?A+~w;ucVKGVXCfamzl!weDUI6t?Zk&+$GN
zlW5)5?uYwbRHEfp9#s#xC>XV%c~|~?54xbJMOBB5Jmg}cHdVQuKI~%R-Vd)$KVq|$
zR6eX0_b_o|R{2y`aekO4Cq=Z4YmzFKHAQr+Yl`eNv?;PRz$vP2a8p#<9HpqHVM!5H
zT8+WrxqMV)kW~yxbNoFU#RRT7Z^H2srv#`6www0H-yVT8MP7;69Kg{>
zY{WKYIy(~8>-#pWQl)~EU0TEXn?f>=W-awGi-+H9X_!6;slFLDO4n@D1s-bsWCl+!
z;{J}+<+-Jm%nAzb?>M6O-HZ~#OKAn=ZEFraT-86hD^XTO2K0M7^(k}LYc)mY;^h57
z`n{TAlD7xzx71k3yO-;Ci5UukV1itma9nHJ-oLk7=^j6D*mDDeuU>QH>1!oW9<&RK
zNbFvXIHY5uQK#TUem&-s*9S?A9H=)d|DnOb<1r~ubMn8%-|z7Ed;CTBoNU`xu{SCH
zHUBb;8fNx2zGUa<04ejT9+F#=zX_1yg5x4pZ8Oh&B{3Y2lzB6+B^d7xp=sp)i?Bf_pS&}3gAlLbs=IR#bp8$@9l}e<
z1Sw4p{1M+TP|~4RU9YBV*r_WETw7)x90r{;QR(4i;HT0L2?x1Jz>3N&*;|Lvbt7$REv1Y5!dwL5aMGfrsCZeX_0h3I~ys|I2IkXWbFXmCcb8%tc+WK_s;E^
zU*3`KtfH@aHrq%tmVvL2=6VUW4o5ySwDxc=f3@bTjibq5K>tULzE}@TT9=_BhOc(
z+}z$UE!pe&S84aIMI4)oEnqvA_U~QMC06FLP-0P9PZ{)}m2MhJ1)D3mLQie3S8C1S
zlKN)DWu9TWydZV#x=3eXI%YEY=UAC|`lnr~;tuMv-2LrWIZDL2DTeZd%!K$1wAt{j
z0YgCqY@*(lz-PiArSRVo;7j=gj8OtEOyD!&^K#EcDZDx8&r2_FSGzcYKc>4sWy8iv
z{!0@0&1E@p)P~Q!9N;fa;Bi!56h7f8{L9FAo1(-^^;9s_%o^rx><_mzd4<6#Pi8{S
zlsk)r7S#rbf*^J7_YRSO6rh@3F9=cRcYnaXLoA!q@p?p!tnDvqw1Uh5*az{w4>x12rYW(Tq2c8cl7|Hs|Cz(-b8`Q!JddosgA7{dsN
z7+YQ@cI-MclTR=onk(VO)#0S0=@v*2N
zpsuT|_*&Noy8aYd-F1Dk=%Ty7|M#4F+`6wM2*3aCX9jNP-a4nMPMtbcb?Vfqsu8CL
zyH8BSa{WR&Vj%=GY1y}!m_yTZu<-^`#2GhQv@jjVQI!14J(PS?66F>`vLF;LNM8v<
z(!3H16HEO2f+#|^-l~(m!Rbu}jPcwn-|53k4g~Oc`^sHDyrAP4PrvW>p#_%!cw5#N
zHS5SSRvRzp*hEGz%s>^&%09E+EQn;l3P>o0Xp1Z0Y+D^gEE3!+$^=obPG8h;lBr0-=
zeS%oBw>pDk)p6MjjrrbB42=9xPIbj{wnwJ{{2vcSQSBv^7&O!SsfkgnIiS;S(h-9HM3z;Pg7%zODoy!ev_BS9aW>f}E)
zuL4d6<`Leaj)pLrK~@b9I9j!qXHpO`59`!ISMr%}f>K#jPNG--|{pdIPNp==4@zfR5smvHHy1
zGuIFPO4}Xj-r+Mcw%whK1qz-F_~&Hq{ogW$!)bQ*owkjgTvc*9<1QZPP+|8U$F!*J
z)VM%aBa_13AcAFgtU|E@z=?P)@&94j>9)-ujwf`KoT0gT6_l_nPP@y1^dwlV!n>j;Cxhwq0)9{JwQEoBYnOq9N3i
zm@FA?jWn~C1w*I@S+jJfC*zSedr#Zu%Qmz?u#;J8HgP%;oM)$|_xt!tBvn+H&bg8p$ap8mTD;Cf&qNmOM4mQlgM@u}+g%DL2P18Pw}yZBaokR!{6(
z>o=0D+Uun#WvbAK>11)Mb2GKx!sTYlAG#moSQPTmc?3a1bpwtJjAY(7Ly=a)w_|Yu;m87`{
zyw#^O-t;gp3z?~Sal&UaUL4G3gsngo(dDCNn3&GIPLyZ_Ohuo~lf&wP`DP0rkuvc5
zV4TAI++o&2jNE@GaiT1^-wvM@Sc7_Ov%B;$IWEtX63
zS=xM492*_Pj(Pn}c^ey|L{(A1
zswiKT%qJW}AYd)ph2w*aCI)ykZGiDXmJ%1t(?kA5>hyu@cnmOd$E=Ov)Dr27cDg8e
zSz)&2X2B(p<<;{V0}PT^fP&&^XxN0xNSVkbN&BoOILv=3j3#1wbhcR{nH75B5A;{+
z^DvVgSV5oPxVk@(OyO|S=YI@+o~zKKdMJ(0a$#Pro};KvQ(JD_ZSRCUkPdewevZO(beIlTDZ1`I&!i90
zM^v(2BM|y5npK~zF*3P~*RBE#nhKwzF{&XLWWjkBIs-z|eSwO>9jp6+(LjATS`4K?kw%-v|%Dv=fPUvu)$p~NuCWO8{q&PwYRX}vonu<8S{?G>&g
z%$D#mMx+vSku-)CDjj+u&08cS^3&y#gNI9^!7(ok6q@}Ntp-DQ*0v7pS`V6Yk*-7S
zSZ`c|?~q90FzT+rNN$tIfSt$U*%;O)GwGt9R;5s*^u6jHc_68Yh_SyMp?rw%S8Pgz
zdM`S>VQJABs!z}8a|4BR@yzV+{fO12i3#jp@JKWF1^+;p824&J>3jiadWU9!d(sqI
zX@?(0CXE}vI8&abc)aZmy1wV46y~v^x;~*cQ%EH0p1$uQRZ+Y-wVotVsDJu_9|fBr
z!;+)(m+vDrfQrS_9Wif#>Zd0#41$j+w(HUs0oj^@V3mWI0|eoM*2w4rtm&k7{!1=J
zX`#`?71(q8nR8UR)AgC@ix4!gwr?98{MV2;VcaH0{#yucb*9l+@QML3^w)|>C5Roa
z%0~Z3C3N>nd&;{K$zcre;!8gBZm1QKWlD)n59`WaMe6_TM+{2+Q&nwyl0qgIw-KcJ
zoLx?`bhv$s;FKRsoW4|pd;MVI?yEGo&krUEeKi}NMfP1FfxCMCi_y~{OS0Av
z0YyS4{Q%Gs5d~xrXWz(l4OWxkg}zFILkoSi28R~<8VwFD^tBq?@8=2W7uRX3cP`5B(Vs8G>cLWA|jv9DopKT9__^rPj4`rcd=+}PBPg8Ya$Z6TO}sW0d%Bg
zMEoHd)Emg){o7yTVu*8!#P~6Z6K8#cDs^D@1Q83g?-25>^-n0@;T3{T?LB
zlFIo{1~t`*`V5xp2li>l5o5UfUH}nRI6oqh{R1D_)l9mO>*8P0ozgeYHb}w+QAWD)r85H5*#-Wn(J2t4k-;bm0=Mskq{<)7}N~()~m|XE9yMI9~=OyWk0P{wu
zUmBTn9B$Jh4M8vtI`rWr{WvhE{$3F{m@e*+g6O_7mFA}*+h(v3RFwB&m0YcoE>=hL
zwNWUXgQeYFzHdr65QJ1bj_Iro|5>G2t!49BoZy3BiY;Gs9BJ9x3V&bF@fQ^f2W%o1
z|57aZ;*W(rVEm7w{+EiHEo8dzP&EFdBgy*Z%_5h^NYe6?I6A04H;Ln6WDyJtIN1=9
z?yD3g9eF)BsTF!JCiQuj#iTBq&$6*r{2@BJ)T@*kBVQ>qK?Ic@mF=~HhAa;Hl9K?J
zaLc|zLBS;!6(p}>TlO^!t<+#DgxMsrnAd8wN@I3jUwh*%C5;Q$sZt`zE<9X5{woWo
zvXUk9gGBOFs_S)@WNT;2Ra^}78i)g&$eW|g(
z+lx|0Ekoh=CPgKGj~A~vKZ*(7;JiBfNM=fsa5G`nb{n%cADx!{et{xqY#LlTAH%u;
z(XJ4v`dn}gm&D=xB_^g=az+Qe7@90tjTuLDGoBVoa($}?hV*}*Qk6`RqdGq7UPHS)
z0JyWeowMMnLgZxl4g)8wa_%B{mG++)+%%KKxU5kmHwBnj`87^m?&pu1kKbb=h0$;?
zA&Bk&1`(cAaZ#CzB*~BnM923zi(Iog-^_^FEZ)5mMs@N7A6m7wG&SYNWcTJD`Y>@3
z)2ttn{gm(XA!4!0kH`MTKl0(>*qus)tP<0Q8vY1uO#5*#LUw)@KAv+eKR(}+@y|Z|
z3~re6@qkZc`H2s&IzQE-v%9K|K)QTS#;+NlO{&-nP*wxJ?6`Wxt}bfkzwsg}sW%aY
zU*T`Ph`x0E7HSM}$~J1BX_CK|CWPQfpP4+JamqXwvU^so2U5Ju+byJ5n&-psLYW
ziTEokaxKJ0RoKeZ;;OO8lB`ml(Y!^(Xy8f$M7$%`-N+3Et1Puqby$dOP1G>)k9yR%
zE2LoWCy;o#>Kz)(-}gx*YMAfTNP(VDVo_K1E{zrF_XHMqR5xiXf3GKycwBt9Mhf(K
z0*eQ^_bIGEj|U_*4BV`css&$n2PE#^LHY+3QlPWr?2s0aKBSTST^%C{clHk}q(Dc<
zNMe8MM-)<^n`0!5ipcJx3duc(&8TD=Ie~PGLSivyT~mk!^h*;YW~mBvs|iYZVtrb*
zN_QDfu8dI^ClZh?!W&Lf77ox&$QQxw4SfK&U-AKTXXXoc+mjc7+6*Ph?cBZi?ttJ8
zcLxz~IGxTW`W0`u+lIa25J76bcPJi
zZWRFEV#I-^R|Tx&fLbjxsUs1n$U4riin|Rjea8q%u^{I7e~_
zrtoEja}>OI5zXVBg46t;7u)>Zb;mHau;S$>>7-R}F%<--qA7qVtpJcw*c(lh)Px#Q
zMHvN<=I3cl()Q2IVl7rBE=njcic7Qm=$L%LWKk}eFrU36!jCdaz?N4PK~$fJz!&`T
z(x+m|;{;O#*u$Fd**GO2w)r31H+5E9lX-oug4GGrl=~U)%)|3l61Slf_8;|eL?^6w
z>f^}RSK1kgJg|lP&$;ldraGz5)t2G@V|6^(X1@(NerNq-l;dsdeK~%Va_k%$%`2*o
zB}yIekWd2Ye2W!?P*O_aF<0PIZ9EdGt|hPVe8}Xqrb-8{;qy*yz%$CT0y6
zq`8;Ud64;})|v;oFB+Lvw8lKh{gKE?Lf+{?9*9KdgZ_4Tkhex6CrJg|?Lqe3y5}ii
z50SCQM218`Z`kgg9I~F%(@QBo*F;wKgivfs`gxf9afC{Kco?3q^1gYtbLw|Y0L?_{
zFmX9fN1@aNuU5kns9M&g!B2(ai+RY)?T`q)p%KJUIj5No1b!d$6svhJRmvamyS?Sq@
znd#ONoUDAtKSP*a6A_~~q}d5^dTm6EtsyalKwS|LBdIPPF^2&mQm>1M(i>J1AyluA
zh%yjX6d_h`h=`I*g%w6f)|C-)QvG425yJJxh&cVpu;K{$x+)?LoEE|gBxLOBh)AiP
zzOWJrF}o%rQeV&Zup$XbyN+DfR6pU26|r?-2h@Okx;R|OIqA`IAzvGVE1Nu>4_&K#
zlYOhNvy=VhN;uTVtpyET+gi}jp{)fC-Pl^t(0Q!|4PDk+(9lt>1r6QPTF}rbtp$y`
zqBY?~)k8?P6PjKSuXl}j>gFh~m;}>Hs*8YDL+n+?)YT9N)=DC}jx`nr9mX0l(M_xo
zlRAerqEeTzMpWtuNK5$?cNF5fxpVrJvHl*8=CF~lIor-L!PSAKY-(1OorRL6qT
z0?K1G?2{TA%2igl8k{G
zW+aV$QMlhl{AC?ezss&rXDdmLg0uV0*O`L!3=9J}Xaz@OhK#y`_xJiR3!#`ajrxXx
zxh*P5GSh!k6$^U^hl|+6ieE00e3Jz-sFOvCf)`eR6D1^d_c3*(i(>+@(tO}YE~4rZ
z!ivn(fFG-ptfKylEG3lzt)C|NJl!BVf1#2jrMu`ZQ{2~Cd}bDwE~B32T7!r
z1>pTor57;rk|gW+l=YuENm>D0Ez!TILAKg8sll6#$4aGgCm#`g$
zc6RvAHgtEwh!hSd+v%^d?T#1?=^^uwyNitiy^~G_i*p1+X;PA>b$o@nficYvQ9-cJ
zjU~rC)DVWw9GzHzYOs#S&k1-=
zdTwccNo{uV9&OkPM5xZy7qF{Zxx%{WGzJ_Z-I6lQq|3E2+~X4A4jV|-B||n@z0)Cp
zstBO=gBdU7R=sd;;y`nr3#85}m(A0qkD4atuYUX-jIooh6QRcE;ouT(bsS~9m>H>*
zLUworQdAU#mc%4gWlbf)B#5#pXLhLjN#US1Gvm6wX~MXV!34;UUcrsH+DT4h^U^Bs
zUDpvx1$jN8eBprrcbU0Y6l&D@8F7Q6Bt@2JWn4iAmFX>l$emSPq^P^sZU|t8T)-wS
z>fmD!nLwnw#-eyBh%AMHrtW5YuOMt>^&-44fEiW)v
zMHTc51Is=3P_hX)R7JlsaYz^{`9L*Mj{k1pq2M7{l;f`rEN~$Ni}L)9fyLB^;L)TC
z^8pf5<^}O5h{odapn=BnJnAa~`cNvue;9ZuLI@TW;UNPHMF_#7BK*<7;v$6Lv8Snl
zM@0ytaS`}5L@w+K?w2kzSTLj<5qI1c&%83lECd{KbflX!Gq946PMj-08qBpG4VKj%
zjUehd8ZIk18i8vz8q8H14VHBojUXzKTIyxA`-T}8=4%;#9aU)8B&x{loZLH}{>n35
zCMRa6qa1VKm-Cm^&vcO~98QzVPsEPt6!qm!&y@QJTr8-oF(wZR(k39ryg@-Q^Q1Vg
zQmX*%0^q8O3V<0X#W1uj1vyec{HlTi(*%`bdi+grP)t6y`Ci-sCFp20ThrLPh}}WW
z7TqGLBFnOk;BJzOFd41Sl%}Q@8#vf-$#tKRrQ9jgpy(dBEUTp41HyGtqEwYq*+bvg
zYkJ3r|ZOO+~y$*|QaVVwF?2zIDBl!xg5
z48aat#1ez`!y(vxa=7-|i)qvOE88^PDfoWr3wJ!2Jp5ejV)jO1$|X)0vk!CW3~pl&
z<_}b|1zbrTB$FVS=Fmn=+?Q9xb>mp}5-(8HG?^}YWe2e
zPdr5P56V15o@D-$0rWC;7oqs1M}8`RkG2wuP1@wA-6CU$Xl1->l>dl=%U4x)AH}NB
z(O68VJWM7U3*?b_-DT2EY~D3J**f6p34E}Q?+%YaM{J6Xnw}`!Eq&2fTxS>d43Bj2
zFPB-qd5dgPBTKys9vza2GJRc8IJneYY^C{lA~s5_v@Azees6fRNa+;lTgLkZtyHcmRs!oYA*NA}q;a$Td1NfZ#%M+pMz#lZ38{3>
z8cdB`o#DjEqN+rAP8Wr)Opm{jbT{h@Ym(L9`tYM_5Z5u2X#dVFUnO0RT5AwQ`bdza
z(W?wzB)7gE_H&*+t{cu^V`{$HU{2v^F=acN*
z<`l3tRLqQb$-jiJUv-?Hi7GYpqjZ@5#=N<_0FCeT#rFPaIgrwrxNOnu>CLe}gaV!c|s-7q%M8bt9;L
zTosJdpG<|vVF^ZUTpf%<=dFcDqOP7~{+eJU_$h7+j|6{gj&yA>5w=NC
zCAUYE34YR?)0@nCDW`{NjK!^E^uyvMUX*Ns?*SI88sZpXh>EYPB5G!?im5rcDyC-J
zs+gKr)VklT*;30CD$(NvjV&K?anq}y-l|bU#uM-GVcDP4$lUk|96G!a4PVr_E01f0
zdyk8o-?MVjz9U2m`nB*~$xZGL*XYT}@sAq0&^XkX@s1cIZgdO*@V=|@r1MNvs_dcj
zPnufSX)yA-g$(?EA%bE7nKBGpMCNeN@jab#=t44gR-Tee5t6IP3eJTM2N~rfq57#P
zI2#mK;U_J7{>(s+YsWt~@##YCFih^YAMo&qC=cB^g4Y
z?u3|eOn!xc4f>G<~bD<;g)np2N2-Tv7x@dQDHt%A;P_n_8TWbQ;CF
zUb%hM{q{12!)aabi?NeCS$3qw8OLTVE!3uGvBo5BTeCdik@=ZP6B-v#G8+bBZV<4+
zrN!D(b1vP)lG!9?>~cf6Nd0Jm15F!Ow8KSkeop1P(M`Dk8^+wkg$lAsKwM=|0Zz2a
zTok!t0y<&E@T_8C)o;9Q^VRFmk)&Z&N=26C^jf_YP!`iQ3oC#uqX1~*se;PV`HZ3p
zDog0M$0@KZrfVxv#yEv=qA0{JX*^QFvOe8-!p5S&2^Gt&je`(uS+qmj(
zgJfht0A-ajC;Vb9Yn0?U5KmU>$n>572y4kg#AvNcEa8QS*{5T;pr>u~y+=xZ((0$;
zib0f|vnYs1$O5t?iGud0@TGJa`k;bHhLGA6D1j8KS~>`l0)_5vc7Cq9P@nKsS!rF{
zsj9bVwVKoWmRgMnv;^wzX>pfVo{Bp!4(GPE%^yEnNw7OxQYDaF3N3-;Q&6>);ti?(gjX-ibBxr{GD*wQ`UDJNe|X|NALz@z|-c
zcIvzXoaq-w$$HZgLI5r;Z
z*%*%{A0LmUI^wb3UX2d;Ap1}PJ
z)AN4B=~N)&=?f<5P83hng$tVgpyos%X0sItTAU2#xwsIZck#l-iK#%Yt?5~Ru1kyX
zNAU+WMH
zjZVr#YeEu>cpby#d@1devbZLc=(MjLe4-qfe?m#2tx+KiG(ohL%;>>I*TU~!iW!H#6UQS5b{2R
zyn%2sA*7wWhsd-*NRsE#lL=wahaefn2%Ut0t$LmmB%>JNDTI*qAxK6sLV^%-J_N}q
zMtCYA4EYcwqZr{7Lcq0J9vUR07~xbx81W%UMlr%^gaD^JPYRMzjL=n1&o8yQ=DHJF
zBq@q3V_W9Ht?qJqdM*S>rOQZ9FAs(#2f|KDOX+zDQ?j%Y%wb%djEi~BzpV380=YN5~`DhPYmc7AoPGJ#&?V$_OCcS{D^(4
zMgk(%VK!v)n0W?R@iaVLc)Ib>oz}-W&SDFylye|q*_#|ET^Y?l-E?;5D%E_cnCS0;
zmA-eYWuHQz^k6>WIFpTunZ{t&9|`O@&a@Zr_*NBY`)}VbD2UlVYNNYaVVuC
z?od5by(0LW;#i?z+2_)q1THDw&*L^$;){vo0NpoBC
z#Q%gnL}WUn>D>uUv}OOTjaz4OMeIpo2-adO`*yqFv}PCP>az(G2+Ory8-<4oQeeD$
z>>QnmeI^+|zhzf*xgE5+OKkbJ_{xk`NOAd&_`>3OB1PA@fzZKxku1M`w7*`k9tSW=
zdI!j7??)mSr!aWKe=NeW!$61gC~(KR{f*YdfqJv6J3((sktHo7rdX-O-qyaSrwGh4|2u$?QevzZdfw%xGqCwh_;2gfb7AT*Pcw
z-JD46^fN4{+)g*HB{3qJ<|2<-`=zYuUp&5Et8&xuNRMxDzge}TAFKPP;O^AI{G!uB
zyJGvxModEyV0Bz?;aXID%dp+V_^~!#gN*E<&az0s>iDQ-
z*JEfsBt)16({D%2wr5T_C>w>`jrfYi6dagHwVk~%rC?5SosP%OGY{7FTp0n^!ABVZYST&7VfSes*
z@*j__i^uKtBDj*n*=^{5xEI)f7S6#*r?MMu4@G$g(v4YMHzD(MIdt&+aj&%&8Kp_R
zp4}TGk7cPzCb&dx-=nd(XP?=9g-gz33Vz4^fPxBcSc&p&YEZ9l*M=KF8E?H8ZCii$^q)V;I@v0%(2JsTT4Xy2u8g=ei&bg^R7m
zYz8irnVI>C^Fe!Epi#OGZRut-=?1t@z%Y8ET=^1QukyKSqN|q%=Lrd;EA8PKiK;^a
zw46_ieQFB6cwoNS>Q3^tDwA$vTtXhesTb(t(QrzDsT|meO7kKjsY*pWAV5@Nr#ey^
zgJ;!vK3B*R8>ii9BGpnYKa|hlYS2=V+3-RaVRWpP+l>Ms+W8_>aIBIW&f_NRaY6nz
z%bpd`%t#Jp8Y=NwN_ZFm*b3-a3>BD
zXu1gLGR}SzB#X+grH2V+(M8F?w~KE(t>#A4<&jcF6k}OnD5Fbu98Aq;==$E0NRP^T
zp+KsYYN)4?92|CKHHkr{yDQbRnS3K?!SkhVmdtKN?aSP7mJ}6!i7f#7aL~$Fk=OkB
z_$jWvOC<``Y^{>cfUE3v24<$@z}pQt
zU;`NSdI=&ybwM7PO{5Yi-ql7L)F3OI@-;G)LqrWoamTgfqI}*a!0O|*o>)SXAkM?J
zkwic42J=8gljbIp&6RY+2>#>GNd6vX(rjIkqE!O3M|NL>jbMypeB&N+#$ZHY4_zAi*J
zN$)K(pH(RGXSNFZN;!VoUM`~tC&pKIj^KJgNMJ&IIr5XvpF2cI)twoIfmav&S$i~9
z>*8HldR(A!xeH;NWjioOpJ&kEa~95GK#4zR4@JZk{Pe^_dK3vN+J~S&#H@D;O(I~s
z7-}{eq)52)A*hF@R_J~Tb#84srlr!&@PI50A#4$W{-abv(j;lVO)DQlnS^fh7p50K
zLYGttX#!P%PWdoWEUDB`@pw|wkCy?d?>&L1E|ZNZHk2H{f}!MzJR8sEhO{N*BxTC5
zY;*_0C<04JRaio5$`bP2dEW3mKh@RRGTWHNSt(txut;<{I6BmvX{Et&y3W83tQJ-j
zdb-bi7UK(Pvn3=t`TRRAbBgk);YOI?lF@S%A5Yh
zoWisrPhvFtOBFJC~~H+{a*vY*{q
zo~3U3G&k}6n$%FV|k@pw6mxy8666z;+Cno#S`UznsZ+Jy0`
zvoOQ;*TsKhuxu`X8ES5b0UZ~C7E3rW2zuec03=r|<%%`3={18eWL8PQzPA_xDv?sx
z3Id9|^Q8m~kV`?(U^+XL*p9RLf}r$p8rH-l^p^{Qz+F@W%u&Wz4q_BbsEI@prMNH%
z!in
z5LPTP5PW!97!Vfh3hY31qF@l5uQC*DdPNwt2x&;9z=c&=
zgJWVFz?X-CarZB`@a;(bHDL%aiPuV{LJ1az?O@t#LvTuEG;NwMCbmPMuL!{?mdL7|
zNcI5!x==WJTx0{c-eeC*eSHWH4Vd{NnmHsGe0oC&3Qe}Mn8N`B5_e??M!txQhB4Cx
zF-c_f#t@uzp^{5yA+;nzSA`*f5|lW-llskM3T3)F1S?;KQ3(w)1^K=v1dbFW0_5r1
zPz01FKZZuxi!81S!N_AEI1gYX@TL$jE>z0EVA4+nAiGitd4VDkAMc}M>>eg;F
zp@T4mNf6skpN%mxW)0vM1Eg0MfnKXLNv&F1)Y8dNe0SshJhDkZ7{s8pDy;;isWf^<((r|=DfUb>c;
znwhV+pi5B*dZj^h!%~yA_fi=5sl4E1Kaaj)hOE>QLiM$u&mnBx;r@LIDl+W`fEG)T
zLAcmB3=j#tkOFB^p3N1~q_26@(w^lh`Hys)Il|>xE+yb#lUur0f{BkzAB%3b!aX23QWkyMl^ku|)>NBLF!JJ4Zpr|cT3Z#fZ3&hs`noD8i7z$m8D&ds$N%?wPC(>QC462~A&$h%?558y6O
zw@g$Fh(IMVAbnrhD)Bw)`b{Gsl!ydq%{?YK|~axy4xqeQy_;LKPwv
zLrfSQ@_nxsa=CKXa&8$O7wCEOFnW>sQKho9fIfL~ks9q{8g{XnMq{BX5kRN<_!wt_
z5usGca&sBirpB(NWo47yvb0Pa2`-f1(+!@j1_B|MFFw~5zpjLvf)Lq{%iM^MtQ9@F
z%+5GB@lq}9!Q4K{xzX0Pk^Jxo*;ADj6-BGfFRWBL4+8pwu0$_2sx$GT`c4$daVBOi
zqHZgU72HTa&or=cT`d)W3Mi*tht$ZuW#Len{J~-0Zi25g#3wY6Is<%fHgOWDx7&m1
zKFSpD<`l*9qLYU+nU+<>H3VTglh3O5v=i2lNsRn?YFEvrg_dF{wXMJ7=Vs`XKl>gI#&QalTr?1;r%W^?hM|)Tt)`Pu1Fgfdv$wJ{TP3#=Co|eN
z1j82rX6qA8@&TbSm~@gWVemA3q_xr+k%*bZVWgG7R>lLq>BzzXWh~+-LzLJRV%JYB
zyEYrEqusXm9aA1NgO0K7i4)4MsvsjyA9v1mF&xU=>FeU)sLi|FmS$uZZdvDiF$UKq
zfoS%luwO3C6dM;PM2=^j^FYl0H;GNlKurlAYR=DMctcH}{kL(PcY8{(W3~isb;m(R
zxikYe8`=?PBbN&HDmCRkxUfvme#1KZ^0w1>(IJmh8W*Q0-3DM;9euW&C_X63%u=(7
z`(AZ35t;2pm&#cI3#8&7{mJ4dhi3>6+YU#uIKB%<7(q=E_QN}Ew8x#8g%3l8SA7ba
z*j;8gor-}l(Wb|$G~k;FVTy*9MOuE$dZx&EExP{f!jf|VHoPsMqcYmkpEw=-M9jr}
z(GH{bBkF7fb(P2S99d^ONT+9og`A6a!2#s?vAE4TwO3z-(_a;r&_lC>Vz-sL^_Nmd
zQyfFr#U3PM6;6g$|AntW>{2@(r%v%5cw*L@@QX~>POpEXLn
zise$m`IHwYy$^!Q%jX2V%>|yf)L6p(u&q&SPh6%Ao>-0r#_cXfwJ}>?fY*&5OF0WH
zha^GWn}*9pc$c;>YnX5)Aa4X3zv!&FT~JV(qxI(bM8(%NBD);GX<%u#A%_c^ul~Rb
zM>?|arYzn3?w70Fv`COmc16-TOv?4-R}zmJbZvwuqvZ8Mu1KW{oitJ|
zv6jUiA}?=qD=A&T90NvN^4NhdJdu7$8#Na-O>y8>!u}_DWSto#gg43fQiEgT4jJn#
z`&JRPki(7WbV^iauxnu%zqG)_+9jrJ^o@0L#>8wxln1l_9JyP;AE;}A-7sqN!VzQ3
z!t(fZV`h>T+Toi^D&FTfE;Rd#5
zMhi*w%K}>#HRyuJlKItDkW{)0tj`K*40(PgQ@KU?Gkl2W?GOewd!Oui6QH1bI#_@_*G
zM&=|1SR?8@{Mk_ow}}*lr!ceusm^X$nkGe-Fm4wZq>P5b?-KCbPGTpP1E42JrY+|V
zVSYS}Ginwnp)W@vn!NjJ5Q**_a(KLhX;h~O(Hfj?EkbG_#C7Xy1
z`QdGD7h1HZ!`fX73ZQ2Dkj
z2!*K#qcaubVS&#h2K)%}L*vl@p{9toL>T`aj=^2~E7!RLii|DfnLMtGg*Jx}3C>^+G|*NXtm2TP
z*Hk#u&Y*L_AV^aKilF3E9Po|<~(&nxX
zIbWnD62Ebgr>DPKH`~h4_7a-6!ut(ceYyg7a!&ZS0U+8-dYoYoGF|4n0wu{a{0(k}{-U<4-_GN9Skr=*j!uq^S
z1O29%jQ%8?+g%(S)V8nD^kJHTgntKUhT2kEYSDZS#o>2?e4!os5M5>>Y-AZy>;v_yTZe}+Ta19Wmr2!U?Hu2VS=Kg=IIah*$Ev&U+6yw
zg;YJlp}z`Ah6${{2bMCe@n4Ch!UWb=+u6_~bIZ?7%_mdKfKTqiwAt
z`#t>&w~ebb4=>xe>%T?|jPS!SYQ5vmxc!^PT08MVbnUhb2+;-
zJ9}YLte?S%9{YM5Jl(*|&V@q^!dCMftm|=0CO-;)G&74Q+V&sYpVoaxOl3hX-qxnh
zC7m*@yODX`P4F*dn3q}iS{;tqpzo3o0quCPZU5i)Soh8ARJvqM-P^gKk_DAS?tjI|
zMGxePaHRGiQLD1=w>FCGx2Tu{7RT&~{cW5V2JB<4&ZP-1>Q<}ctTr6t82e6~V^OlI
z7(G@;9TbnI>UpT3-@)k%>tj{ijQ13i
zLr;-8r$h;??rYa8POuVc)nfm-j;g9na~7ur{1$Y8XshG%csV+DLwm;^UhZ_@l*)~<
zPqvE!BCgD)&+6C=(6-n&+67yv?1C-*kN|+Pssh0#;{AwsULMGVeP6$0hXHz}7d
z#q3vXh;@JP2$c(WyB5Slh&y=5g5@R;4jaNM50O1l6~0g9cXI62M^JUREeCviS-kDk
zghCxqs9lOQ9$1K~r^oGgfT~v>si@+865K>L1xgp>RWVFQDz@)Nr!i-AOiJ{
zl-CU_M@R)C+{h7lA`rq>gOs=W5fv>)?mzP7PRI0>cH!D&i9;O0l2hq|IWlL_tV~eO
zngh1FEgWJH`)LV(DNNM}Nd&Ve)&raed4sw1`tw*RZA|)p6GEoRNG5ZcjdNisam6x}
z2^EOKG44M@i1VksN|K=Om2D*K;w*P?kP~olk{ou_XW@a5^8+-`iHC}d32=}FA%{)U
z-DlBK$#M%pR2)Gr(teFj`>#nYffTONDHL((k5RK>1rtP2w72MJWMz?)P9?Zh2ohl;
z6PAp)$
z0*(-rMNZ{(HV8Ih)P%4cIoVj2Xl^tYL^vcFXVb|eNWjz3!XgO9Xf#srJ)VZ$N>d-$Vdh!
zxzIKdxPId7mk7yK6?vA?YoJ}w#K+x7AdUvJ&cV1Jvr<9>Si@Y+qFzl*!Ps}RC&G7A
z9Udmp4CRWF8d~d*R
zrN0QuNq?NTadsWF+Bm1`D8=!S6AU$&$9JpaPf+oX#;0y1B4{Hr{t{`K7VDZdypG}7
zDRoU4Z8O52Kz>t291*;`wRpZfB10Z_=)iYpFjq;OvUB@cIP&2XY|#ngjHaK1t8cOY
zZ%+s;PuJqYR`}c?Y;Y`(BZ2_C(*}_3!)k35{a0X28B3sHe$8%SE~YlHQ2WyRF}}~B
zfaQ~L{DI`^MCo|LO%prCTG9RqXBv@&&y331dBZIGmqAoFGkE4uq?L`QV*AMNIi1k$
zBa}oK0A^-c)ZiWxrd60vGYOi#!dNY)c6(Y*yhGN$;D(dmOvp8yv=Zsv-OB$yaCSIK?L0v5PrzasKx
z;vNH{Fwli2Erz|<9%C>_di1T#Ck(;lABZ!1q|+2Jb=Um)jZhA%Bp*2=iP4c+3F5CX
ziC279IeO~NU)ce6V`~!$fslyEY{RNU<@d-+7_1eO0wGzEWQfvVdaO}(!_$Wv-g*n8
zl{!ZcUqnV&ncI?pQ|&~vF$;$REyyr7j9?6ivF3r!e=Rx(wSS>=nA!*LXMGUqtz^5E
zQ4c%)14roduGCXHpodUv(F-GF*4)3b_@1_nw3p#@d}8E1QEX5i@h*FGoNn8*#~*iP
z%-+++tiSrKJ*pa)DXU>c#m&FEg!05`;m3j
zI;-q1kMSv{%dz7wjU%Dryyy`*eXL258wls1B}C-WXmNAdHQhQ;I@D-hKt7qAAL3{T
zd3U%#SeTJKb;dG_j(6EO<001l!}u~U@xm($2-{u&8n(WzSejqwHqeU@VJuzheC|FR_%<6*{W{yH2drkRerfW_}VEQ_*g2
z%5PzU7mPYChq)D*EW&^}aelV3&^lmkq}>qE`w-7veWUH^q@}rg0+sr>5kB(E9DQ(U
zYO2w+I$nn~H^qM2-tnb2q|^yVCvv8TqPib|6RpQX;X9?{6|u*6TpBxNBVF&p;^^i@
z<+-m72e-w#FFQh%ht?Fvs4UAuYORhqvrR0eiK1M}MG?Ib&+rw68#)`(5uD7lIHvbX
zSri$nh7g6n5v8Om@`q!kVFp4^mCO=>vT7Ucf@A@r2?m_3nCfw3SIkX_G7~*ZI9b^0
z_z+!t6g%#|BOv+gozL4oh3vO*E?T`QHiB{sD9%%bE|O0Wsh85>CN`v@S^fv`6(}--#D`5aF?b
zT?he8R+7$VO!7KVo49@Hv2rxWSb`8<{HJ|joFX}uZ{wqsdRTd$_hUlC4Mkk=Bl5YK
zKGY&6n_ezLd<*zWqXHj!!-u28jkXc==Y
z?S^!SvaZcDIpmmz{mQj@5=spE94JYlxIE@_pvZB-j4Xo86exs=QUWRD3|j3cVcBCLr3-td=sy&V3o04Se@cvg)t9nz#
z}um$%D?P4wSGVar*F_`oZ)!=+s8yAXsVb#n1EbJfHar{<6z~xJ0cC
z3+W5s{H68};H2^l&MRl9XOahP(PJgVqxYT3idubz$RTl91>9%EVT+oRg}x|`=?=zW
z{c^$|C5XpKPa1gGJ0ev<58X_5!@$GN&2lig-UJ4;DFY2hI2CDsC!cK;#OD(z_Z#@a
zy*!B6PYF*0QTPrh?`HB5rOhJ22m=)1g+|JPXDVVug!7FE%!w7MlJ}|47!imiE8uS<
zie?Rb4{uh8xSb-t6Z2{EV#H*miT;J({n`NsDy0?Ir(&|h+5v~tsAgo&>>!gI&+^z`
zQts%1v$8aO3b3n;3NzK$G$r#3j|m~A@|Hx;m@ra>XL-XqQQ*vh`rQ6T8TQ=yNu4$A
zm*S8|!wyefFcCW0mAP@JBu$uPG*Mm^{*hFSXaTEn1P;fXs2pzi{n3=4h5fG*hpS;H
z(SoUmYC+ISiW_4*5@FRXB$P~*GYjvEhGt?dwWx1t!si!MY}u|JJGzY?0r?W;k!h2h
z3CeER5EOSGg}h5pNPT32P(L0ClRZtq%WO|uSW^*xCyT)H>7)IzBG}tOKQ>Z9?s(Eh
z{w$#htVI`VQ3H@C!APSw=@4|j(gD^VDAjQPW*zk~RLmX}W?Z?4fNXOQ%y*m%qRmKr!__EMxAPVovwj*%;SW
zuEl_a`^=4Mf_!`2EhQ1)Qmzh?5EE#EMHh{V@)qnaQ2ZinJ-q196_>QRTxL9QYqhej
zIOY*epEGEp%K2+(k}{>Du7NCSdaLLZMBGCLaiTFXgQ4gPmYZS1R%~xV^5@;B_K6f|BJz0#>aLV)ez?qM*uxNfk3j9R6fv_-o1ZrR7jd(60x^Phl1cETfoDqUB)D^vw*{*^H>o1%Mw*y4EMf%e
zL0)+@N!N7oEzag0NEQc+Y7kdn!Y>p#+rQ;B>78{?Pa-PLVN?}VQ06!3+|zho=<<6o
zU7%C@702n8Q@dRSigkXRzD+lZtXHAcn!F?tHym5`QMgx8c>*N577xM*)7$-w)LBz#
z^he{YU>DYNRzC$ku3!cx&+0)SDjLVIqMoU?L0q7oW!}Lm-dCTg&rQg-rYjjQST~dn
zP~1P{ySrN@=*B96QsU>P89dP4y22gu^6fE>rx
zA2{H3pr^lQjrR@HZNa(`Df-|)jf+~*uuvuyCcYM1v%RUQzU5_n!WTr&_JO9xLcHoZ
zJ>K=0NAG;Y92llLU+jHWm(8_f%4)W8+>47Ga5wL~eq&V17oqjZ3Gp&fpA#>$^R0Or
zmI37a#cN}30v;?f9CsjGfM8V8!eZ+JIt3cY=Ql1CFU|RV^SGEB_e)N+a4_|>+-Z4WL#RqNsrUZ^asni{L;(ca%p9+_^l_Pw%-a4Q{;ebP&MJSC?J|9BWU+GFY
zjJhivSS#+XP&c#5L#NA`dXxN&td7yR-4iR1QcXGw>U12dn~KbGOy;
zZx(r-?Hm_x@y?xl#2Z}MsJ{3;2(L6MdjoAdOWSpH1cq8J{QpyV%`PB;iBF
za(0wuL^mWaLlyQXPC=fQbh~=GRcyNCpm}|Dsn8LB$eBrk(>be4VZeLIq_gb)5
zyvD3ic|4?-^SDp})-{bnPRus&i_1qIH%pm=yu>&Kml&
z2F#EI-q7jFH%mM@db&X@^4Q9cp6_yu2lyZV{)7R6td(vvZQ;w)L@z@C$P*3p&G-UG@uhI-v&{RpovHD&8Jp6@*TQqi4zo8$2aQjPI6{XS@=^n1p7
zwtmlAMZ5t6Xv&FDvX7metb>W!MvpVS8$P&?#@QAG1OL4B&mv)LPvvd%?-+i+M0#k}bt#G#32
z5f90r)T43LnRnhq0q&d$w->Ib5ItW?(oKFx4K7`DQKN}Nw{ZE=a5-N}W1ghKaG@dv
zIpyg&2e^+D;fZn@&bM9LFnM}BC1^(N-~cloP0Ef#sEn1wW!xy2HHjx?jpG*u2Nz)s2Z$4D%At?3D&)c5$Z}{t&V{27Vmwa
zS4$;784ns3{*f;{SsPp=3MHgN__+YjG9D>UC92DjgcXZnRz?%?4IDz}SY&3Juu7J*
zBnPO`b1@Y;LIdH-;{js!bd&^oBPKcG(F*2?2N>cV!?0?mfMco5Ec-a-u`bjT7f{4~
zyntqL(w!%6FURe0p`N&aBJObv&5ZJ9$4&gfH&g(0YNklO$GfH{TL<`N&(lP}NP|Xm
z3L){9^1VlJ_pg+1Ii*02L;WT{#`AVivrcB{dF7
zT?bihk3(9i#@ybHtwTp}nA<1zK{SVG-v}Q$fo-!rySL(4`J+V`Ho_MuB#W+({Rl;h
z`8~Mi6fuuc2P(V4xPBJ3|7Na}D^{)hHJ$0@&ZmPNpq^=xh{%~98oH1cNQLeWNhIaH
z*9Z=i7oF5$Br)-}b>ccf2*VOCzS%$5m=yOE>M34%bYY2%5Kgw%Kci
z`ZZ0ws;#DDo!B`Q(8BRhvLY|bxE%r5|o0yfILYxQZ&6DjB8t?vH<
zeRQ@6%bnE|yDtWaeS+1wPi{y0Ht!U2%V2e!iV!-qNky|d?zZjjw(bYxY8EQWx@qOI
zwj-IiTUPqq;Fgs>j}8#L(dxcs9i1IdC#y@E6R|7T5zR-sG+)MtYso1w5o2{6L&t1c
zIAqj~YIU^Q?18rKOWPgCtUAYP@7(R+axYXORfq*5-LE##=zekkj22_P6hAM+^Kv||
zz$3@KbT;D|_SOy7TbPSp=wuGig^lfHOcLj?X_e~@yXcMn{?X|(!dL`CBD#C>Q#p<4
z1o2|6K{9J%h>0K&zR%hO=V#^?rITWYO03b|fj-V|%y3YJe9o@)0
ziCOGf6y3-jLCIVZvytgJto2!TFI!z4U~v{HRlq*1U+gUL*+5X!vEoA=cY)h!Mo8Dn
zdb&IDR5pCkG{vd}cQ&@|Ti4V5vx;(fwMfxVz7~AA0?+I4ydID2D^b5ViA466e>Jbw
zA_>yf>a657^#ftLtcr3N@melL9K?0cY@}{N8G*f(&D&-e46cDN9NQWQ>yu%@)Z7r2
zmK&l{azkV~mUSIkkQi@C5@@_N$x2%72sJ}e)=9pQUh6DhNFU!i?q-&>YQS*6Q|zhX
ze)qEV!u{?874#30tSj;JMm$&Hk@A@<(jm`ULWPM#1wwfBZkVOyKzG+be}8Ykuw5NM
zdNJ#HBIT9)47n5v$@ST;+yy@nw8Hov)t|WW4eUV0n1OxS@yY=8qTle0mBE2T7D@&SK&;#j?3F*su
zwoflpnaE@gzdEDUj_dKf1NG+ewT>2WOE_(v#?`jI&F}%H$<-vihvx
zI`3KnWqPs-$>MO##8%7hQ~`zDP>p7nPoaQ9iVkN>&}$`?NP?KBa&R(1y4xunj(3o9
zD!mWW<(LUljZR|_jO|HKb2@zt7RE3k0WoLLS22lb)B-~3Z0RxlpZwnqVo^L_GL-^uk
zj>ZSaJOM8%9^q50x8mn*c;1djwtuXRnXTVGh64105#~3?a)7yDM9mn1qV4z4h)X^9
zqn%3&_ZbkTyKmiTlSuGdk+09zLMh@NM$#ec>z!c7yYSrP)>ox8SgMImkIqo_)ZJ6~
z(9ZOZQ3o$hZLCssD(P%~4AsY#)pv_074f#0r(-k{QzwtQtI##F(}!F&gx7e
z#2cRM>qCUIm<}JLpOSipNro?OY8w!Gm<(^!REi4MH-Z~SoZg35Rb68&c-(f4l^A*rp26gtpt5}r)-qto9mzP2V4Tk-YG(dZ>isIo?MV1J4N`>Fhep{1D_UU-L#kIu`oM?K*xKg%w9
z!jZ5@9$wmBfXc$M%N{_grx!8sYuV>{0ZB?Kl>~pr24`>}h_j2tG&>E$K5V;y^$b8d
zc5zJxKz&H>x$NM;ZUYtJUF0NtwiA6l7_0Y&KnMB=I)IV*c_Gkk%+GD8nCAzfsqF;C
zuVwF(UK*oIGp*?b$TKM#4duUz%L}mwq?j3pmcRxL(N{*TJL;j+9cIxD!q+*%sW8}C
zqO0Kjl0V@-10TW;tr8AP=P>Fx^}3OqkC!X#j42Lsn`=3=^@TPJW*bvh#|vzGW83C$
zwr%W$f877&MG3gZ(M!A&UUBrYp%V^q^nzs$S|fsGMb@F+vSqXl;mf|LyLHuHrr!*+W<2fCiD-1o2JnmywPUP;@6W6p{O6#DM2|QOpu^88{;56}L
z#W$`c5jTm)Omr!8{f`KHKYl)d=Yx2Jt^@~OXT(WZF=G)swjNIK8{hR5hE1
z^%A}nFCwp;!84yVO7@F0&V6ZD?>XmmC6k*|-Q8!KpckLpbIv&we)daHFBDx|{=N42
zNjLtnd0b)#SByk?kSAeK&FqaFmQAa$B*Gp~*K0e-41qLzLm2Ay3n+8Ux)r}Du(w{(
z7im>X`-Gc%zOS=dOBGs{@P|fbTF*152GY?Pgt?V1KGPhwQ75ArS>dgnPzwH+nfBu0RZ~OW6H{XBT
zZNK>BB@bM8y$inoGoO9nt#|mpAGqzxe|g6%_Rcq__u~k9_$x}EUMxnllRpY9{vG$a
zHhUAvB@W9WKTUcq@;f*o`iBqW?IUmfO|YZOuvsYfV**DPBG^Uw(wVculpiJl*zpttFg#u<(ajkW3T|jgguJCQnOwmD
zXDs`vM&zL(r#1r5qva(0j85?avSSRuJo!`ufCWz#Wr!wSV#5a}W3&|Nh&Z$h>2w3K
zr{cy+L9EXRz+^l~_0tU4P=2U{b#0KBLM?U~5b6v@$rrFzAx@Ga-^eE|W){
zCd0rgc~osG2=CR&qlSCK;4*nsb6*%(CeM@0AiPf{--`+#2!o5{dr{|G!@$`RYNi+U
zzAX%@GDpR44}-&gi`c04XZoNdHR5<^;n8dvoHJ%QD$8~H}_+U7g
zW23$^0q`Cj8}*IC@b)-r)`Bz!Q|vypZCn7Q!8qLnn^`2?eW>f9Fd)Z7O%EGD?znW3
zX_`9{3gx({=e!@P3*3i#eoiQq`CF
z?)F1K_C%u)cWKqSxTN$U0|$c8l!T)Cr-RU52}RAn&N4#Hj>1>c0k1!3PZxE=Qn22wEo1QV0Rn+w>t+9G(lIRu>Hj4R9D2nVhYt
z&Q=JFs38;ak^y5Sj*odKb$lzD{Gm`Nk-HU@e1RV-$k~b-UN%6xMoLb4)S+R1E2{S*
z1*&D>dAy{>Z2Ps=9
z4{;4q;lSog!=Y~U%QS+fK;8+3ttZPU!>fY`dbp?RLP;(UqPXKa;ee3WMBwoFO*kmZ
zYa?)6y~DDv2;vxe6D0)3y)Ft#=Z30%eH4<;4q|hqMqJ`hFeQOt!aFoD
zEs2Kt0bQ|d$nOk*VPcSA6!~2NFw6)N3|`$70H?hyd3Pj&%aiv6ad?J3g0?5y-FsI+
zaU0*w1{O`xiMx`w?+=1V{UF);KoF#4>w`g1lEoE#{ji2*iBL6QQAK{l3u5s>Mj!PC
zr^*aK{e8>}NS0F!K_(yfLVC&rH1d-G-{OUgl;|SAr
z_m3JVwQHxcOUdAO12EDNl@R_@I8=%XSopmFf-BzN55NY;aTb16z{PAxN8O
z0}%2b1`viTP{|<0kkb1CK#-+G{70ccSH%C>5AQR0@{=IYWXk`E0J~iIX%NF@%g=&9
zv6DwJ{r(_=k1szDV({FhFs_*MKs1IV6YTwkMxxl|G*(4m7cPwrk8m=m-d}n!r1bRB
z{Q^SIMkW4h0HshuYUv6*0Z~!N=HCJs=+XLkSx1rkt1y&a7X=-}zlWiuToiOLzYar5
zx+v(NeiMe$uH^%Vi-@vJy}gLs(uN0^XzGkdwM&sLW87S5rU>{-GqWNzb*`g_Pq8OBC9R>o
zB@AI)rGP@-5Q?Buzz}w07{VTv0;=n+p$IAkl>BX>2)yzp>);(4gH2mxlafX*=$h4$
zH2lIh}2GOGAJkY`Veb?vLCS=Ek@AFq
zd}tLkIaGtX5Bo9Ey|8(W>keH0NF;)r$VdG+)XTW3pmZOL#&DCl#gCNDWh%K*T$Jw4
zF)jNO(O9IjBC}hgF=$eZQhzcUgH&4-`_meOtg1q|VX~BhidOuYAc8shL;w4?K@8P#
z%4ASew}m6+hqStiM)BDo5_OucWPsq$1#y@j7YXJ5d=N>IPez+|E3Xymiw8qwe&gR13MBP_@CLyS%W>I0i}OjA#S}7rqk$g=L1I;Nd@pKw+C9
zC~DxlAy8On2nwnEo`!Ov$+Or|rX|b%eh5@pq>%6rLV#qF0!2Rz0kP>6W%-eY(Q*k%
zV!1Lzs<~|Gko6x2P-qUoYc{;ZLbRi1|2crht1Pam^(T=CveJ;qPc@EO*kIOxik}4`
zG8%wC*Fbki8w&S;4)$zoBX7dpc>cfk-UU93;%pnAeG*6n6o{Nu)Tj|bA?BQbpoE+V
zBoIh|fYFB>NgyY3A|NUvDk@qJsHoJcr5X%+Ad2&d%<}iE?`dU9h!~?&nAapK04m
zTq8@g?X|9HSmo%qM$t+8f6zKb=S4s9@+D}IW!iBMgy=OhA+dH9-m8N*%HVOQxMx*Z
zExmw8B%M#sKovIjwa^mkcJ*SBkLh`-pDL*nZ5t{lL&sIDy&SW)HEc(&p~$=COL>s9
zla%w@O3`~%bR;duK1tq`^oKi|n!542%2B6cQ6+_}9}u#^48eNu^pddr0z6)QI)n@@
z?x0tq$e$H0J@w7}dwK0T`xn}v5I@78{j66OfS&A<<+ubtY^QSZ%PEHacDbcmm`u=v
zph$6K2t9G_B(#muD$$6_4*Cv)oFe~>Sfse`5sMV{pI}-sPlLy@kZ0hBUBnCViwY<=
z=*9E+?@RdGi@!Kj=BRKOtA6nUo+g)!GrI%h#8mYS)b$s$xj-!8$jAo=wm93|R{s%df@Z$_h{VeIda0hLQ|
z3kHvhLUDt&7+-n}m*-dG2$0)kZ}LVao-bX3+ro&LOvP`kt!oLFM*^{~9qvDc7rNjR
z03}QE@j1#eJg!P;fAXv{T)bofrZ#ZiPG3z&K|VJm9B%6D?h2Py(haKy4hpH`uz3nPYc9T5qwrlrI5T<&faw4|7VFjM_`
z6|zu<;DG)G6;il@G&m?er$R~>N<$*_FTBr6wKQ5TFYI>=&{qi1X!T=6u=VeD3+H1*
zPXiv%P``OyJM8kh_WkHEe9Q>?e1!e>@c*$x2wahy@y6}=#34?v>!q(&;SH9F_04!|
zaD041u3q@bU8kGE1Jjj^oSj48hl;l3!bFF3zMF-E=+pPT8huA
zJt0OX?FK$;ouBl8RS^z1H`aD`cA+$1vaCOaMo#$?dQUgXnVC_y9&e&lWxdVuoPMIL
znk?y6%laffZOWebaJYA1>b*{C`YBVpWJw7jYtxYFQ$9p$$~z~kZar3%CY~ef*3R0l
zaxHI`B^8CN%|p^E*3n+2-E}~OW}j2hjaO_E+biOxo;l^^A^N@>P#)P!#8*&(U&Y@G
z_@i+iPa>fg;I+?koIllPoW~IXV`Tnf-0!f*$WW3R1F<$;{lth<&{s>l7he^r?VO5N
zzqc)zf}zYEm~4k)oghMyHwk<2NEqulBv}SwL6%I6_x-J(+|bzFGqt;`9$zM#Oig{t
zWEn&skDE-vbZ}S$n}Nl>5aTuBaDek>BF7i|IjchSI#gDS;|t0XdCY1k>U$5Y4RRc@
zP5h6KBlcKvKDy78=PX&ptu5UcB+wCSJ4Mo6)S~STr57*azpvwOAO6s8;;ayTEd!?$
z_=^*sb>x0LiQZAHo_|!|hN!3Xil|4?sE#JcJSbLv>t|rP|FOFG|NikIHJV3W!>L~B
z$3r=PSK)k|pHhWTOBCP0f7W^8(vdhNJr6t%XR%{T$Dz7X#PH#l506U}V#sJKF7d*|
z(}$duIND0GM&X+rL-imb5}W{vhfpOE;uMDzAfatxm^+Y?3|9e4F~S`n#Hoss_%ua?
z7^!|bwnsTZBpy9UP>GV_QM9@4
z6DUlGGmt=>sp8W|32~OKpq~>doPL}=To9adDlC_d%R5DgbM2o(B&)Ej5kj1&$nfE(
z4j%#2=Z}pczh3$v6tQ%n7g)3Ncd;5@MDUP=dO;
z+@X%Evr%PN=n>>B1q42saWN+tMFMlGV
z2KqtSG|~@zTyBVjRRq-0n}@Kk_!b)fM5@*HPki=AMU(wjMeLm0l%C?+$sqN|4*3H%
zI#mg%ve(+=iV-tGx@2jZv*`}^bcB2HJz@JH
za~Zj+vAwYi=h@*loC4!p3*qkdZFL>3-AIaWzkv4Q%($_;d)D;nndwvIe>pi=>N#y%
zeP{2i0=!hDv42{5R%%mcYIi3>n-IFRxS}sBTv-t=#In6<)9{#cXK&9e9Ns(XR@bPb
zc?V+pn(!9BhQ?V<9bNT}!$fI2bjhfWHoO?Pdj_gLH?tvYS|&PSM_Xq{J3?n9W6FRe
zoh^9G7BBor%SrC-#7l`AlXH?M*Y&ovHYDd}r%g$&!o%w`l2IeI-ECY$^|FSDqil_J
zy{ibLlo2ns%$S;3OS=Je_tp>)JGrS0{ty=W;iGcpwJ%O;;Wi5C4I`eNrEu~>-t
ztfi%uG%>_)oS2oJnVvkYkV}%5+u!eE;jHw289fv&c>uFRNQzf@c;e0)qsCXlInulPB0CQc-}Xo5=4-DtMX
z`mUzrXx9pAOjX!KuW*TMme6^~;BlfJdU{iry~WA+3>T;PLzw4r$18@DYnlEudDTOq
z@iKk2i&Oen@aiyov*Q)R8M#bWYQT#oTfCQO7Lh;!=JwDNhKgEbY#fTqf#1Av#hs$`U
zK873dBV_!}h(jZc_*3olk^Oh75r3MDzc>g^kaQ*n5;_lwt6lMNDB)M>rlQ(HapGwgk3)af#Ba3t(MJ4e@!wi}k`bRIexSvlZp5E1Uew~p81ZAo
z=d}2-M*LWDj}|}9h#x2J;CNghp#0;F`0?Tvj=x;SPcY&qh|P${m57{+w8R9Fiuxv7
z)L)7BBc9$ur8wy)xH##lm#KKtC%ZW5Q(T<%H2%8vQ(c_&X)aFsEEgyHc`m*dd?q*z
zndI*p@L4Xt2wZKJI9KFqJXxHr@$*ES#?Ke;Emf(>{srQP8cz{l*7$|uVU14`H)#AK
zu}b5UMY+bOh)j)NEGB6D67jDkZhxkVw>3UZd{5)4Vz<0ax!jn5V1HC`${UhMX7
zp7^cC=Zk|HFB4zVc)55;;|s(M8eb@yHC`bWYJ8E%(fDFuIjW>!yjW>y@8eb*GXuMgRT$}CTHQpm$)_AY@oW}daR*kO{Yc$?37HE9E
zNZ0rVF-GIph`-TtE#54#QM{?~YsE_%zfL@=@$1EAjc*bS8oxmlYkaeqtnnMgFpX~!
z$LK^e;?GUuHI3ga_GtVT@qmku7PpGE;B@Sw<6#ocFXwAKBraq9D8!ErjTdRmNk2L?
zL7WLrzZD-1j=6ccj)>wvo-YI@gJmAX4}hy}bm$w_%^F`|&Cz&G
zta~-S$y%cEJz|2!_gTLvb*Eo#J+ASatOkvLTAZix2gTvJ?)3MGM>Kx7sMmOtHD2SF
zTW^-Q)8At~rt!~M%^L5vQZ>HVI$rEf|EzdX<9HQ<#&5M|X}s8q(|Eu29eTwkZ=*x=
zteZ7H$C|708P=&9f5`fAp-N5rV}*6Q#y@K<)OejWR^#_uKQC~nf5F4vnl(Pcx=`as#BblcGZ7Pm1vx
zPqBV6!=1j}x=-Veiz_w0)JoR)9oCWQ?(|n%PiuUd)u!={)=Z5ru!d+n!}>X04DdEO
z^sM!?#-FpU)%Yf>OyhgRM2+vWj^!$AR6nb&{Tjc?`jo~$EtYHiL2;qR?-L*8xb597
zUeb5bF2!D&#=zd_(Rt5Ot-xi){7edtaZD_>#VCae!q38#$T{L$#C0y
z(t2IvIo4wuze99ue6m%j@x4}(&c$2lZu>8YCp13F>d<(yHC^NTL`dWD*1rzaqY>@q=QM#wS{(8h>3RX*|(-E7fi9kocU&-w+)de+zfw
z-TK2KPU9o2A53${9})L!{HR!|@nhm5jejKmIMtp0xcHjJPl(MLKPf6T{-n4_<0;mO
zOWgL_t#4}ladD5vms$-Pzr)Jb_|;Z|#-~|tTu$?o(m)>kyX#p>7iPLZwg9pd;!?)2Nm^BTWPtkZa-b&1Aj
zSszYvr@!0!vc?~=Hfp@fnxpYWR-(qA5wBh7w)cs+SL0i)MH(-%#%p|?_45>W`cms5
zjpti68lP^Rr|}1^cQ0_KUv7Oy`p(@dO_poTD=1#1xJHSsXdjo&Im)QH}poG-&(@af!w+u>Np{
zJAIq=w8kG39U5O^Wodkybz*`${Z-aW8lP(2pz&+0*%~ji{yyHFKFxYb<4;@HYW(w7
zzQ(V!gvP%h_K$Phd(qmY@n)+~<2PDy8h=>4G}fK|0kK}=_lhiye@gsyj9cGeJ*n}T
z)+&wPWnH52Pg{RD-JO1|^}NO_tX_>jE%G$}vG_-lJN+%zmo;8!^=rJ(%GLN>>o23-
z>1SJeHJ)enX?%y3r}1j*!%^<^k6F)Ye5KW;@$FWo#=m0yd89l2=d8UN&$497dJ`S4KdE{*?KlxqB^B2MFPikD7t
zr~j2$r}1G{y2jrY?jRaTU6B^bcG2YJ7@Ssqqf$6pepYd_Uw)eKph=CmduDRi3nWSQ;n%~C&7e8`;E93+KCiFcUi$oSFXXUyp^mJ~`7
zKV(kbIw^Fz*vI?{$;XH%nO`jVSh1Zs4f{!18vG1{(_^-3
zBfVwtzpF?f#lL6pUl{y{E>8ZxZ167|{3(M!Z16h`zS-ct247|H6$URbc(%bOxj2>A
zb^3(3)
zoe+b@CPF;S{t)4$koX4SMIrGv;pC9~p7gLOAu$pAY1kzp(MOmX5-&4;$Vkt_Q}_nP
zeT=U$(s&wrUx+sdr-#H_ggGH`m~e4O93fl~5=RM3LgE-s6@)}QAqI;?!n}|eLAWd=Xq+2%X-IrXm=zMk$Y0`gjA~122z3qgsheMf6
zKMF|oHHHv_^8~_N>~F%FkVqy(eWwu4LHi;^eNQDsq0$KFhC~gJ{OKfY2#KwPDA#rl
ze~QERbNCyCDCZGE_;-@|2%ImFpR)NA?iie>jl_LeTj`XgS&yVRcCCBJ32lu8Va&QFPs`
z!{8_Ft&5`TV_iS%Hbl{_7xI4QuvPYW6}k-ViTs&|_Cz=%B-aFmN<)IC6KMYxGRpA_
z{4VCQT&Raf!Kof(xlj)@&Qm=kqdsW7!%!wdWw1|J4*P@)?fw~>kA6fP`wvOv{zH?N
z`wu~Kzf}=pKhWhCwZronvl!(#OX1K_ep5-0lNp&G63hISaDGdj{AQC5?M3E`_G0FT
zrYAzzz$W(du=J1^$CyP3qjLO0_yP`Z>gO}5evrAWC)D3=;;6qp
zgs8v0gmCHw!i_@gCxre0;Rm!*82B#6b3z={-eNpVh=b2?$_L>i8E0|4mM)jm0cAQk
zCDVb+bU>L7*i7j`TG@`|mor!K*D_zl`s4ejxqjdbH<0kF@8HC61co^YWOROOLJ)VCe
z#0UK7ypzT+xxbZN>=$Vlh@>L)l>HWz5cpZ72h#atXdfP0WR&@UmoTqp)a+vaO1nU5
z_h~%oNjmWHjMDx~cvO-&Fo%)OZ;8ut05!X{Y!@i)K7;EC(u31;eT38>LpW)=kWtzN
z*X&%yc7W2(vsi;kdhjufw7xm?O(8B|l;sDX&RnyH_9@E?l=gOGjVI~ArCp%3yPxY5
zD9a7ZCLK`LCy>SsO1GG?hT~T=u4lZ1QS$@+Liz!eetaI!1CtJ1_G6&z$KPT5!j<2cquh~pKFqahs6H2di1(mqhy$KWaLgG>8BX&-~8v=5Z_fzp02+sAQJ
z+Fxhb$G9Qw1Eu{hvVCxAA1LjAhwTHUeW0|D2sP}+Z}&0?PVApv(`b
z`Hk^W+679xI9Qz&NDnT^4lthZ74EM{FZ(OFW(VV{v;&lOzRc|wT((=F97kR?(qa6S
z>3}lbS2!PVnGaBo3*YBk%mJzJ{md$sgcULg+4I)b>jw+XYIyU*~oMF53-IwwoWaJ=l@u+=%g#>TeZe
z3u7%K##Rs${50bujGtkAl<_gf#~DA%xQp>~
zj88D)_>EH`5yC~t&4f=l{qbGmKeq%<4MgZuPWW$$zhTMwo6wz>-Ja1oWdFc_lW4yK
z3mLA2Ghe
zD2CYf#xu(Hg#Gk8s`sB+;se4voc-}O@t;~k?yqf@_$P7rPuCTM=P_Q&IE!&U<8sDT
zjGGuAV|;<}M~r`BJca9X0wbnkWPZ40mWWF-iJ01v*v#0+xP|c^#%CF6UWxoZ%=kw}
zIsZfD;d)=rsP@xK%s*npYnG&)C5+cI-o*F}*Y8glk25}w3a9)JFn-85KEV#3&A6HI
ztBfh9*zs!^pJ%*ym>s^D@fybcjHeB^<5w^~$avofJG}B#8}DFzmholA_ZUwwjz0~0
z8h;sU2~nO^%&%eo2=nhTzQ^HzU>-NpPM1Omd-8=cutV>*AbVGF_*&-M86RT&0^~4UG3PKFjzX<0p)#aDTdj
zaS>w+;Z3_c6wCzfk?{F6NIgo|k0T)1{2hGk%+K-061wMT{F5Z)f}!tyv=ES47H1&G0vG_^UpJmJHzIkjL$Isl5zZ*cKkfX
zZ!!Lp@v5`z_y-vO&UorXJA5YNGR8X?A7gx-@vO6L{iTdoGd|7u65}z()N^fp4P!Us
z^^CVL-p}|v<6*|XF~%j^c7`*a$yl0Vhu_WkBgSDD+TrsUH#5G>IBk+0U&MG7<7!4)
zZ%F&&HpaUdzsLA1#<+`Y-5AF67&96385c6%$oMehml*dm{+RJFjK605J!9v^w%uzPZ)L2w
z#13E1*vS|-)eaxQcmd;=8Nb2!-;6`)c=VwV?-2gkvd=r8wglaeq5btM#t#_(!btaL
zDE=(QX^iT8sgn64jJp}X#`tZ%s7U}i)_YajO!S`z<7}H14cEzT*Tu^5o06cO^mx3
zf57-R#*#_4pG}N6Gwx!1lksniV=uDxYFt^wyo2#h#&Yg&L%E+EBRp=2j|iW!?0HP=
z7ddZ%^X39NPXjjc`Pz+)4>5j~@wbfXdUrgZ$KlqK+|OEmf8+c<@0>^ef%5-{CH_pf
z#|fAI!Kn1_d4zL5>N;Ke2Y;(Lyp{15M!H{4?d%(jZ!#WZ46%ReIxv&Dy8gp0Db4@i
zlYjrR#2*Q9@&6**`3oWHNtF{rkO+Nji9ZqUb;4zO5wg>N#S(WK_GNkDlq@eUUgf+p
z{Fn1*zzoh$UH{fFzm`$uFY}4xe7@%7FYU*(eK@c5GJFV!f1T&ake_S^z?p1+iII;?
zm%!;>a{M*Zt>JX)`uslTn6i=e`!mM(8C5&NC5enz^Cat--)GdDEN>#07duv|ARP`#yv9V4%Y3~G&J6~}2i=0nKx*Yba
zj8XNo9n7C&{2t@482`$s<|i-Ydd89tSr&wNEzBQc{5<1+#{XhG#;Db=#r6AD%f9~!dul(b@oFiT?>a^`ANYOds=vR>T-lf7
z+EDHX`<(qC!~ep^qi3D{p!)G8Y)9o^&RotTV}GtC4!n`^K1SJp5RRc*#{Yp3<-w39
zaS|hzKuF%mcs=6-jC&YmzkxlqUq*8MO=O(Hn8TRQ*u{7Qga$OSAp^HmC
zm9d2JCPp=0f1UYH88v@CVSm1C+4pr|_fpPhK4S;tt&E>#M3a&Et8sZ8+gJ0ON%Q1~A$aT6gLy&R86a{TFz?spVF
zHe}x~_%A*$M0-A)>J=#S&vo?2N&lK9F!d=yI9MwGHWU8?-yiy%6E5@p9iN|l+6g~N
zdKwfcpSzv#k0~631g1VkXs0En5u$!nJHCZE4(&2romZ;k@p-)eG)L(dVX=_<;O=&l2+d=`&7wWcwe(#|s=>O2~htSLtN@2Rtr5#>b7}
zPP}aIIBAmh?{dPAP=1Fj`@T3%LX^FCD0~$6ukTu-o$^D!xQFpoDnIxy8ILn2Qn?X+
zE~6a(!RIo+l2IN95H8n=0`KE+nSX}k$8X3FoJ{7Xe=uH9m?lzKCeQf*TPTddU}<^vz>V9_gj2F
z7?r2e$$XA+K94)$GM}TI&m-IpP(MQ~WRk2>Ku
zQh7ea_)ECU34f3H4=o{&mp3`#lE2Q!tD7x>DwORHLyE+|FiO8Ln5c4YCVPM4@$o6g
zo(#vy`^^-OgPPLI{q_@Xk95#W#anMvBcHPB7OCAm^wMHrv-*X1c&EzuR);%#>)LDE
z8liH+nz|6;4#2y?HQv(R)FIg{lSb7TD)4z9wdufhwPnwVC$b>LH6
z_)toFPgh4P2QJ1NyYaU00xhtjGQ*ISwY1?i)D`R6INAKh_52I38^#xH@G5V7=dGeN
zT<9HK;2k{2J2;<%OB#E^OX*GLEj{bQ#T{L3;iC3>l(NeezgU@;uVN0Dcl30q=sC5m
zwe9uzU`}l}sst}Wmph=|ejm9=#mmIQcw;$zEr?9Y@8E=2b#uT&vUDegm
z+nJgX&TpfSV1--jI-BR0_N-}4$p}+GTAC}RdKr2>^l7~m8E!0GvS!|fIW0@^S+PtC
zaqI2x@T4}Ad=ABhSJ%~r%hMLF>53wkUzmb?)iNocSJv5@nccT6cR}Mo>yeKdLSJ1y
zoy=Eth36F4t*PxqQ&~+G+}_~xtgC}D`0iP_X-&$4>8&k&wX4&^J+k^;dkY`LS|`P6
z>!j(7%I5s=y1C({-E{*^H`*;v>Pu}`3hS3_=xfRBX~^=Z{GOJ!#xAK|m_}b<3oq+v
zSe;$6XkJr8eK?o$b5}h&VTY|=KA)n(wZ$!^?aev!vRgcwO?_>(a@+fBbGy?!)-KB$Xu6}d
zu|bN93Z;12+`6*W>*lV{%gq@mR@$sgSsP1J@~c;6u1V|d&mQOp-Xh=A*d|RctyoC=
zadBSj-1>P7OIN2igcq3mQT00NMvMBTD_Q9stvU0$%I4*Jw5W#0)>^wwmG?+>T4hmj
z6C<#@WrS=HH+(G#BA7~Vid
zaknY@wv!Z>FOhx}SN7Dcs%Tl8yCN&xYKn{bmHRS5Q8|4EFub5+dSU${WIUW)5wgz2S9T_$me7mv6gex89~zee35|HMcZW
zc?=trOIvMym))t0>SaN)*Yz~4D(mcMU637aGPA)K5V{)c@d1eje1sAo#%Q6hm)aS2
z+v8M6!J_)gl*|o%bJGXz?ar=_)ktS2SkfwsHNSpNbzo)c8!5henb#$uU_tg
z@RH)%+P?6jj<(*+f%a8Bepc4+-u&cJUblcTXzji4VsJNs9o22NR`HT|?}!t=7HFIiC7T-jMT
zJuC+b?^I~K^-Z>$s}{@lTU1=pzP>)CynBtuk<+R8?oPWwEmH-t9#mW
z{2CO#bSt(zWR
z#JQz{nZdvcrmfY67`Zd0zKud=0V)t@ci}TiW&0AOASWur{7p{+9FdVb&TC8uA$rhGp
z_m$UIR+i+}4m?6SyR4~Ib(X9WnQn3Cyw<9^lFr;Vk0H}Z*Vx}<@9RbLWc%OHomo^i
zFKuDp^z5)4AHA!jp{-Un$f6uNT?=RSwr^-zlv_|zkmuJz8tPWH)%VJTd3kaVWUnil
zpS!3wuX&NjX`hS!OfYv&CQ^hmTKeXfRIJTv&ZrF+
z=1^00T^OhY;qI0;`wTbDJ~pmxD4A23nbNzg%VVc-s^Z>u)otbOFYIgU>0H;pd|qc>
zcp+uvky9zYa&7n8{CT7ZugFPnoi~5O(vCLIv9j&m$~KEa-lz$G_g@F^sbTG!nzT2k?C*HyR}Z*Vd6<^05885(#E^h3&MpMQd=9teBp~y#lEYrWl~yrZu%yuya%HdNz1=T!?AV{*vG0>(Lv`GQ;xSN3#t+P@aJ
ztZMGDf0i{i@vp)boY>RZyx`)5=}f<+n?mTzTeTDymQFgfw!XfxRTRisu>yQbxg66+
zBEKJvMD3OQii${OIp=lUFVxIj3ZK=a;Dk5G8Mv98X9FmCkm&$3xqU(G9{R{qkg?C(
zQff1$4{~iiAiaHQLCJ$$TbRjtf`*a@nV~V0+lLoQ9pw08rj}C>lsL#7gqc_!6YQ!B
zauhKw$V0WvKEPCrnK&|+M+SmS=CJ`D*zNX7ii{mzx#P8;MR-7Ev2W>FR71vt+dkX&86+ZTjn
zCdd_GR5PxjG{_ZVR6Fv5k-Q0V#TeBJc8t7$Btt>2Afp?i3reyQ)hyO
z=(3lr1i9{wYQ>)WAu~ZHf1;YPucpaNkjv?)X6%_cG81HKF1i`}BAx66xk`^}$G&JM
zGeNG}qneQy@nj{)ReW?Sa{7_X&L@*IK_--=o1t4{vStEI-bS?&IaLcXtrE?O?MIMlmH`$Tx&*=S7`e7;vE!IZ@%;A(TAG{g8pV+qab|eUSUg1Jh%s
z!uCGM9d$Fgydz9`2e~C|CgvN3lsw3tLL<4y9dc>OzF6?RMQ&K)dy14g$W28fb!?Yt
zYX3X;&t&!iZlIajJ9qqK@dMoQ^RPgl2e(^6kXw_60sFqT%ss%3Z6mRMo0E)`%i9-W
z-}{`V5qmiRr4F(lz)UUg_fX;>H+;;*a=Moi58@JA?S1=}vn+Igd(KAAv0R?3jO8K`
z$~VX=5hLHo$_`2&WNC+yKH42;G8g2Q^8j;lb%LzK9yuB8yF9^2&C?V-p-e`C%qV*s
zv1hW$#v*%dg6~wew~Z{GLnkXiCefoNEG7#kUi)nz?{!rQ=i+_x?|LKI2TudhO4zQZc$lF{b
zL1u!il89o)u7eo!JBaBrnKZ_^GAFH_?I32E?WD2HlF5|+@f4ZM
zitYO#=A~6yJK-QE$Lxf$&5Uu{|7cpwuo2swm|-NA2{FS&jI&{;l^CYNOcSxpgBdnr
znFKRU#4rP9nuuZg%PmVkwIC)I7SSoD{Q&^FtG0b17v~n#koo^0e@=B$RY352Lj%C`)P8-Xdm7OxS2`icQ
zKcB6VW@4MFl1XEmr?Qhq7J1X24zkMIePQ5QlTOKlEJ`<%$22`9U5{yQN~ZjeCZ=o)
zG0jTZNn@FkvQx$~A0<=9G#O>5q~}^_-wtA-h)fvEG?Yvj>l~C!{691S#kOLZeUeH4
zqp2sig_!1@+y-Ktbka=N4PX#6PIhW_yiN-~-6RvnI@hEn9_&PuOdRtplbt$-DJGdP
z*7+rwIF`vJneacHS<-CSEhNaalDxVP{#+eT24MUNGI^vXj35uPwo1z7+TkEmM1y+Z
zY~V}~dEMcq<_B6!y5aM8-@N>FoY)=uz_%NruxrQ-*a1ToU
zKl{iMo_!t6I}!%@s4P~$|Jx^ToV787d^Q;JLA_G}dO2%ANB$shj~LAB4hH$uyT^0@
zybAJqhrvAn&lml$9pv!=XE6#A1i8$2UD}iT0oI-j`Z4%Hy);3;W`|2b){+eFT@r(O
zICxNx_YLa(1A}=z#9-bC61lKOw@
zoPw;y;G72W+~gqMOA@)@g)>23+M)D8U#;U@)*^!-YbVrUDacxh$i*vc2YDE0FmKi|
zFHw<2khKpgnY=Oza#6~2lJwYTtZN;dwDz@dkjqtfw(8QArrLsByADWeXB*@~R!bVo
zS_fIyfmgWXdXP(8cmC>fm(m8g-Zj$Ng${D@t0jzWt%F@`Wt#vSL#I)AIv=P%<2g68AYaI+5v8;74O~kU+!L$+ES_jig3~L<>6EUrI
z7+_=YYaL7zv8;74ZK!)EL8cS*Lz`NP7t2})-3$BRI*7FnoIIwr4k~R7YaJp7<
z?9?$ojT1>8(^?0aI;OP_GNnFmLOUzS#EE-n@g#~o(+%)OPAzFHYaML2V_EAUQ^vH`
z!A=>&S_hdhmbDHtVPr~%DmTcSjJtB9&CignAQLpYtytDN$TH|NH+-oSa_#{C+FE
z$g8_891c$pb2ACohx3}6a%yw%8gOijicD`c+h}
zUp?jcRa3TKEoJ*vQkGvGW%^Z7re6(Z_|;IlUk#;u)R20p(ZeX-*q4&-RYDozRXQ2r
zRWdumqf|1&t3)!wt2B0mM@eKvn#X>oi0K}?n8Ncs_O1-~*s&Cz>#|{kLaAuV9W<)7(x>tGW(ZuvDuM*fXUS*ImnO>!kF&SRvuw%SRB4g6M
z$|7UZyh=kc)1wt>akjL7q7UNRy#S_R}rD}PS3;%7%IeRj0MXGJS}X0)PbMk{$nw30{8Nn9rgc3llT
z(8_R+a?7vE;6UM#2S;Uj)GtS6depFrik?@7M=f)zbdP#gQ64qTQE47^ZAVS_sBDh$
zsBJqYFKSifMy-jQs1=bDwH~sgR)g1IZu^!MwGzArb32XKV9qgVqOq$BU&rZb?rN!T
z6lJwI&8};y?G|(BznI?lYo4J;c?EFfOGGWH##e|Cz^?~xNj1Jj)ROA{4pB?0^9`bw
z)cN@SP)q87Zx0O!Dj2AmGcYJ0LD9c8WXItkMozj=4y+0ZWA}L%+QX24*>DpHL7VDG-kLG$HYn
zVZ%q9dfLcQqmxb_Gj`ng38Ek)HEp^`3Y}@4Gc+^;I(&+Cf;cB0Ux636niN(7ek56;
zVRqDM_)u7|Eg9djCoz3*jJ7QN;ZuB(P5mBY=<=fI@F_&i-c0D|8?|av_SPD@3TP4&
zmCEskT;I?-Hy4^|yRJwhJZr2zgR(jOSlZGySybui@
zx?x5;XhsX%>5=a}roA(Tpl`IQP5DRP-E)^?|5-v*C=pQUJ|3m(Mokm~CL^12^{
    tJt!D?t4$Gj#W#BLs!1P3cT~Z$lTv-apRuwnxLEvQ2pv
zCkxR-KX_AdrtZb$V7k=vg6SR)s2g{FFnhN_w^0=W7_A&bFA!pX0Nr)VVch00>_U;L&8+uW&@@|H1OMvuE$ZvxyscNUD?jO)?Qjrj=pQdiZG#o!vq>t{+R3T~t
z=yKA8m>odZmo7wA0NwX9g!~5czbkKD7LIQL?0q*|h^YZ|f675S2%y`HgLx2L(u`ob
z$1!jQv6nFm$JHSI;UF_HfbNkiFy05yy+0fMGJvjqju0sUboUelEARP5!Tf747GiFI
ze7{oS-44v->f3Ym^EGAK)SX!>M5}6~u6|_dZicQofbK)+8UpAR&lBSH0J`(%d-o&L
zzZVe@#NKV?!TkFWIgFvBX73x&Z3|F;^D2Us_Y2UCQH=z4)laj$
zFE8?L&!+CQO7tUjQtD$bV~G%xRc1cA6-#lh89;aSGK}{D>g7e~ypGc^jB?6OW-hM|
zrh6H>R*!s5d#THD{0N}i4Bd_Zx-(Y@QRq=GX1-Tn>3y6wb-#iRhos1+Oq;qSRB~ZN
z<LggP$gCk=I#pcut(e210ai;ER=x~Y}*`nF|F?5txZP9dp
zhb~!(fYEek;Gl&|i^vvDcR6&pA0Nu}^OADY&XcFRr0J@8z
zn;1Y>44v2hy$k&fQ(cj*6S_pOZ=vGe1;+E=X4NnGnA;CsGUC*x>bcUew*xu^Nqcmi
zr0hldIoo>*x*e1;Z^~ZexX-%T9p1+`4BK|!W8HS>M#L#=&VD<`@bA$s$G;*U|MoyP
zm2H#NX#Ty0le(Eswh^7_--KT8>(%#1>iZ+H&+(6r!_n$*0(2`q@-^$PAG#p^?S(FR
zh+|Ndcdy~!p=%uf3Vi%K0^J)P_Duiw-4M*b6VM%Z+>6xnjfQ{6Hsib#I%>~zeEbtP
zVqUb$F$k&LO#fc_8Rq3VjzHfyOX(uVBW_Ds?|b+2c}6*^p;P6!)~6h;
z&?S5LXO?3dbhABlW;qT*H$piNz4~dE^N5bXz^_ndR64
zooly6{4>jO47%MO_CCaKIi1ndR6$#1fkvStMVx98-r{
zV#_o~sO;Tt__rt1iuf1y@oztLt>w-@uI!oqO}!yryx?RT)xRUqoxIo)Dtk)|{|@ht
zkNCIJ$G?xD+nG7gp6TDV!||Tijb{BFC7s7{=3K+S!gn11>V5pHf-c!{FH$e2e?8EV
zFKScuV*2+wbZF9%P3hh}Rqscy9C7?>^6~Et=&C*1z3E@t`@#I%2HnYscg}dV$MA3K
z2abQuKK|{1t|8SisLE^lck+xOf$FdN%pqc%$NpV!_;+ODkVyM$@$v6CbjJhq-=h}<
z^RF;vh?wBvU%ugA%_PUa)js~ULYH;kzpuYXOM>}#61x3rC%~-wIn3~HU#a6?tB-#N
zp-Z0d@BKSg8_d7Cbwk7nkNP__Lhm258y)}Jef+C{ZoBKkLY3ESe@8Y4^KbTzL&T%X
zh^ziSZTNS1i{oF1kAELQ_qsDYNA`#5-~O$^{F`_y>d)C75qql)|HjJf$n(n
zzxQv~CBgg?Q-^x?-#ZQePNX{i_4@dicTikRU)n;)zdj%T
zWt&c^AEZoO~&mf7Ra@>Um#dkKy0O{f>X@ef--7-EmcE
za8vy>>u=M`!Tfs*IQK-7
z#ASwm+rRJl*WlydF6efk?W#@XYu4Y)p9ZVH9nd9vly|J*-wSU#{1{3Cg?Z
z`*+0K!Tf86Zj8tH^6OLd{;~0h<6oDLf7_r-^RQ>u-@bQ)`8VNr-tF&c!@p5S9sg>5
z{7Z&z^2C2%e{=;MZeRSO*duJQ4&0lFgruFvOIB?KCucR=@%M|pb;|F$kkh|G6h<>TK@=;nIV
zi&=k1mId3tv#S%d^}EPgZst7P$>j;6)1w^4MmbtnIOVv(ryQH0EA+5umg4|)UhTzf
z2hCR|c&>Xe%W+ptg6IACkw!TVK&R#tXZV!k5Oirst2R}CW;x;;6SVc{N@td1FLaSk
z0i#NH7{TuTwztXg?@Ay44nVg@Ip?xx`q#56L9F!9nf@JuE>St(@b5&IzE+D|B-`
zbmsnj9lDbqx;Jo)a`%se*E#+z^6~F2=$bw3nftf!`e5VGQRuwZV?Js4mv@8X-*g}U
z=0Z0j!1Y$u{oeiDtiSjN5=6Ym@oj_QU*b;3zxh7?O@Qubfc7VLC5YJ`^=$e#8@eoy
z_E&EB*Ykwq-*rCzZGrA1kMf%Pw`X^P|8o=U(|+hq#5)B+)^a=7@b85$I{q#3@$VJr
z3IiNJM!XoT{>q^9TE9zm;O-wgzV7(9$;ZE^p!+Dm{@wBIVD)zdI+~wWoBH`J!@r8}
zIQ}j3@oyz`DFOW3axj>GuS4gxZWGg>TKygQf#YAXkAKIZbDfSyj^}3k8}VAO@p&b5
z$5rJ4RsGc){#E_Z@o%<|e+|&xKZTJ#=ROt$N-2d^gMRukc6CdE!PN|Ei&*
z`EIqTpQeAW{5V0(^cXix|Kk7KyZ>H<45V$gaq{O0;tmgciAFiLz2%f+o=-U*g>J7Z
zgvtwOmZR#I-p3=e9Q&Y)SC!$iXO?6CuM$Ku;?<^-`~qW`dptM{ojTv8;};Ea^k=SH
z`Utv0Wd!l+r&*3HoUnQwSIu(lgzlJf&Sej`nKl2m{>JfdvyXo}pxfbL&-5?t?F8-l
zMpX{ezk|>vdR(7xGW*l;_jlgMk1C@a
z$Dvd0Am67P@i^$G1t>=rbb;CdbYAUXlHuRh_Z
zwG(I??tV1!_f9*w-p9W*=z<&<=0aEDQO{;O-2vUU0PP^<4+-KS4|}f|<=79MY6o+D
z%JDjMvpwvY^*jnE5v?9Nvm6_t`^ZE0u;E|pA07Xyef--9U7?3P)4%=D^?2w^|FZt%
z-A>yK|C0agw1X-i|FWPP<#C)b{VV)Sg6H!Urhl(MH#I;zIR01f{+n-irwcedf*u1v?j_pG=;@=|=cRzXyI@M0E@bT{$
zbR#_K#q{q4bV2%2Sx%zobF*JE{Aw8bWQVDnE-K>NmxW
znUyGQC>`0O?IA-q0lG2|d-p)++U=rYPNH~yk`S8^_%7^_J*rPSN5QS8$d=V&?_XL!
zPQxYXXnKO~$+~q_s}n^9Y>`ftm2@i&-LBR|Ij=`La#PuxZRn0cw-WKB!&FK{H^tDE
zwIzzltV?j|k_=ssOGkdGeE*5x?sDvO=_p+3ju^TFE*)-NM|5u*x??UK-9}gTzHjKp
zv?q$$2&3{+dsVs@3|$p;6|BROzliR$hHe*h{j9^%*@*5=LpQO*u}Aw~<$JxMYlV*L
zjr^m2sC3PSt_Qk2){SxLstw(4=+an+SIb1~%{6pyx$>pwnpD1~y(2DrXSsByy)m6m
zIVQSvw8YEZ4kkiJ^+DyO1Mig^c+_-U71Ul?4zr3>CW@fwYqfY
z`{*{hbQk#Owz+gEKDwPQ-Gx57-7X!5qp0<=&!wYdZnXM4=+aI0(Y@u;P4UqkbLlSj
z(VcYZF7eTgSnIT_sXn@iF5NUA-Bg#3mT5<;mzgfzr9QecmyY^pGXAx}7e21wOhX(9LFhg+98J
zbxyuTKDrv{RJ$tn(d~jx)k}$w?xf2e*;Va@e!Guvh5gQPaGsB@%%z*}qpNc1=-fJ5
zzBMjgxsR>^I(7VA;G^qt*<0wN+vw6!|BU9}7ME_3k8Ybwx7bIw-KE1TJEG>h)1{;9
zkZAtxa_N@%=ytnwOMP^EUAkpHx_vGkwZmxs9dPOJijAncgD%|)AKf9B?n)osTP_`4
z^G5UUh)Z{sOGoEC?*4JirK9&MD0`;vxJ%dLqdV!+_4?@I*E{_Zk03|QcZ5r~&PO-K
zrR(?6O?2tj`{+_!x(zlF&Mju^|OSi>Gx6!4$$w#-vrMuZjx6P%y#igUM!QGFxLpK3o
zbo{-;N4MLhyW2;106Kaef$ZJqqnmk+lkbB*x+>_Z<7|7McInK1zWX|-Uq0f}ndRLJ
zT{7ayzsFrV)7~MMz0bOIroFeIQ}y?xkM6ij_pD22<~!ngryRRoIy2uf(Cxs)3zcJ!
zk8bx(n16}0b$fkuhqfll^`d0&1s`4EtxkFO`RHm~y8S-79_a2uJmq`9M;CvaGmrF&
zk8Ub-YJVK`(G^0MjCjiTbst>=bn5)?kdJP+E8jPKbO&6zw|sPOL6?Vk^6#*ZZp`h@
zb;=PR-A?EpMLgL%>Z6;v&DkHvd~^q)Q}z6jkM0O`hY?Tt9{155xFb>CXCmDRAKlbD
zoqSLF=nA1z^+yx6>iAKOH16?lBXo3MgYu>I8PRmxKIL3TCHm-&L8t0vgpV%%E@$4B
z@{g8p%H2*mXq{6uT@7@qA5HMl9fNK%;;Fn7eRN~)b;^HQ@)hH
zDu+4#H9(ihI+{yXI&;6ZLN}Rp(_A{!-gcM0RF}@Qw-Y+G-!go3dtJI5AKgKhPOV3$
za+&!aap}~1FuZgppi(~nF8+R}9O^!-mu@0-$!t&Er}NUybm`RdE?&ACSH9}K5MH_-
zmrlK3z)QCcx=rk#dXAoSW;-46fYa{P^Xy*s#z3dqsd_Hj%idI%y&j)-n&q;mo+I_j
zx6Gwe>;JrT4KCd#SH5O>H@f`0!KE|%#}=2pn|yRTUAkL+bbDR8J6t-`zk@FS?sVx)
z{|>qA(LKCqj?tUL#{0^rd(Y-@u&-5<~I;wvfPak&aO#fy=r`pSBd~{VV9o^eh
z`I`1xUAiZIbX#1yXMJ=#p-ba(Jm=Dx+*?!
zin1!8?28pq`+;>~Q4s-A>H-LEG%8ef1yNK4+5G5QddXc(VLvxKXuJ*)eiov+kKEz
zF%Jmo4e3lYanj(nLHYxfThEp#mnoF?bToC+;81U4Lw@qV?>4qf@aMXhP*}gG0IAtf~3=O7jLw^NwO~wzp$w6KGwl^{t?I6&*D+?ws`@5_V3c}l}$cE8D~SOUD*x|Vno
zxyfw<*^X{9@1+X&S7T`^0pz-h7P%kpKFX;$s0{1w&W*iY!{C0I;{LH9NxOSHfP00)
z{n73>I~7aIkj`x#>H+fQ3i(~Tk8~;yEQ6dcbPSTiHR(SDk={7a(+}h;73p}8%smZc
zj%yU|KZ6MOZ0V+kp^=XdB0R8#x{k)ZG6=WWMM8W*32|#6?hxT_SGfNdB=BH2TS5~K
z2N50|Actt&F9kIWgs-kV+2UFy$9scF5B2l{_d11pU68Mb2Rn)sn!c#8zZaz87U2?&
zyi)ZJw6H745ehf^fwEqJ{Wr
z5N>w|X{S5rFM|Z`?&>8UYvlI^A?F8siL%zNRhhOa)Dmh9M`;X0%m&KeKPiW?k=^x9
z#bMNmi@97X)0WmFjsk=c`Fg0~T%e4$MGY5nbY%aZq*{R75WU9|8qNnQq;&nIzkq}i!gPCP<2Xnmxn<$2By7N3u
zwL4en*me^C4Ycnl_RDu4>{RRzNmWPb>?m~fb&-gFP(9_&v2-SHURlUd2K5t_^~_Xx
zkxo4O1;)J!<5DGw#^8QMdF8JZ&RHett4KI*QwT?tAe75*HJ9H0p?*#rcYfi=oC3e5
z)YT~L3CQsa#b$q%TWXYCUsr#3j_BN_kUEtt%Cv)<`nLe#ugb1>l`t9@9NI$7`F=&?
z6-7fcIytuu2tRTWWGbSV6#F~-hq8mYLau8lOZ^Mj=RWqSJ6W~<-G@6Bi{NcdE|F|M
zX4#5mC&e4WK>U_!7KPn!cPfq^V+8B$?=PV8KU9AH2^FbJxJYh5{sIG~N9M|s
zX{u!XdZ(fU+OTrHbMVL#iMv0(NWeFejHcqr=4>PtUmHz1TSoRnImte?8Rct3E$va~
z)sZ?0oJYWPCX~vwC$pJ&BHGrTajrM(#ATg-jvOiL9IDk@zusU7Zs~YiYc>&zw>n3T
z6+7MDRPU_V3+x7G`N*53BnJmek_tQD8#!F!E)B$WzUAr+A19V)Q_;1~)22(&VzbFq
zG#zctI3FE3K$4x4&9<(Mhfxx5%QnR`Y3G8G17+EQY<6v~ue-mPO>Y~_^mLsp(g^48
zCfS%l_Dps$Icr)rO9gOg1kGWFv+59PKUMM634P9c;PN`>5d2;+ueHA~fw753-FV+n
zmdghqfGnS%$o2LYwv}u~91tYoyl-_zz(O$!Uf(k0^LEj35i9
zu3HybEueS6KN316xi%tz`x(+^LWv}`Wcof6X0(`CqTra@qc)$$;e6|PND8OfVz{>^rQ>Hl+q55oksF>^M
zm7JgPFO>p3?O!V8_@jTR6z32ArBbS={7Y8|nV!Xs{s%zAY<7{u5%LYz1=>`0BGwsWlV<-zMtK
z@D_{sST996aO7ZBdm-1(q*iCcZ3&`KFNHeSV9hwHQT^R$;V6*adB}!Jul&x2N^ktu
zAdT_5J{y(2YFbG_O6W7oE@;p-rj``Q8Z!;f>113gWy%Anl>N6xCvQ(WhT|TlY_fK;i}$`gQ8sZ{PsBg8~AGNLawR3o4}1e|Pm43VTk2cO4{DqNt0
zk0-=5WK-*HC&LNCM3IHkI+7fS#I`2TB
z6y#=8${WfcJC#LKIBg}GNL!Kgua0Io&0HHxI_H^Eh?SNsCc5E9L2N&8#G(u)`j!3;
zrIA9!S;Rea%<^nzLo%ApI>(xyM_l531?^T)nyZk**>rm>7GIAFj;Tm8gaxMtr`06F
zFy}OQQ4pD`i8z&}!{W%`(G=n`p11pI2=NJcxCMmh1U%SFGPK@F
zTZlvwz(Xt`kp$4@LnHw_(8Z*V3NZnE#qGZYltd}x5eiKssHA$24V7efxm_2i*_J2*
zh%musHyG*?X^40E6iIV5`4mZ`{Et5?sL}6JN$O&RWG#hM$WIEX)v+!?vVc|#ycW9i
z4{niU_M~5#N*PEqGpOi8SD+eAz%J8qfv*
zS&F~Z=&aHbsgI8UQkyf~I&2}S4*29eW>xy2h(14r2(xu1$>|uMBFU=WZIci@nMrZ)
zxu6sZ4xdIy6C9=!2Sx_??G`dR1(Vob3I*;pHVH-s_;?o#s*!js#x!WMLo(E0V0XCY
zNyk@bLz%V&(gf=Dz5XSrbFv!`((x0c+;@+4JM_9RCV82}q!J)%|I4ktj{Hl!j`6~P
zw;Thj5V!_ttFmF|C5(>(QVR&$MA-R}1%ivh&QB~5ToZPF=z_@DL~Fatkw8qWXv3J=
zkPTyU{Vohu$?jpN*;SS33E*>XFXM!c(#m*i8V#e_xzbGGTHBJ&d=s!P7I&7|fGFay
zk@cl9ExEr5h^L#J!%RQ~fHzx!M3b}31klvxd`|2rJwjsF+Lnzbnxc_NG{R}+=`dX7
z(kc{U!W-E2$2h+L=%}fOOmZrpom72FM`1YUT<5_`H#=7oRxM%u#l*W?Leu==vt-xDr^i*?=V8I_Hfh9*jecNLX<<5)L9;R-_{hpQcbV1=x18uKa-)TA0kQVhFd9H5;-9cBmI*fI
zhLG{MW>Re}&PnKa)7iqORv=p_<~Cxwc&ON4aPnrAL8D3%txq`Rw2E5n&SC5~YdWWS
z=yW5V2-f(}AlC6@I^{$WAq3x#RUoSdUj|S0B8Lb$p^-l!kr_POi@cSP=WFCoO62tf
zegRSoF~E+*NT!p{XGRW{Qk+$Rk1a@%EcSQh1_#qa9bG3U`;iglib$x9s$>bO`f+qO
zVTE%lW)1ZZwB@NP*KrbT(Tj6;FiHYtRZ*`?yH@HCgPT$$#gAW)-%Ita2jc6PEd0
zMeTsZey67MIS-v}<|kUNj}{e>bko{EPjNHar|}ir-81MZ{*x&L$=wu6N3kk`6(}Y5
z<&s}h$6yY!J0CNvkld=u$y)9!D{4C>c3jiB(nIHT^fu9;@To_vW1;pI#9|ojemFxo
z@tO*J)}dMPf(D!IQnMPdcdPvXEms(Bd&N{X0oQo1rnbF=+Qq0Mgup5v3z1BRQ_f_3
z0SE!USb<�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
    uz;r-lID5=6B#z&8wEViaE=-(;6;XW
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
Pv%q_5bCq1q&pq(pXgT3T

literal 0
HcmV?d00001

diff --git a/OBJ/can.d b/OBJ/can.d
new file mode 100644
index 0000000..49a77de
--- /dev/null
+++ b/OBJ/can.d
@@ -0,0 +1,78 @@
+..\obj\can.o: ..\HARDWARE\can.c
+..\obj\can.o: ..\HARDWARE\can.h
+..\obj\can.o: ..\SYSTEM\sys\sys.h
+..\obj\can.o: ..\USER\stm32f4xx.h
+..\obj\can.o: ..\CORE\core_cm4.h
+..\obj\can.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\stdint.h
+..\obj\can.o: ..\CORE\core_cmInstr.h
+..\obj\can.o: ..\CORE\core_cmFunc.h
+..\obj\can.o: ..\CORE\core_cm4_simd.h
+..\obj\can.o: ..\USER\system_stm32f4xx.h
+..\obj\can.o: ..\CORE\arm_math.h
+..\obj\can.o: ..\CORE\core_cm4.h
+..\obj\can.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\string.h
+..\obj\can.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\math.h
+..\obj\can.o: ..\USER\stm32f4xx_conf.h
+..\obj\can.o: ..\FWLIB\inc\stm32f4xx_adc.h
+..\obj\can.o: ..\USER\stm32f4xx.h
+..\obj\can.o: ..\FWLIB\inc\stm32f4xx_crc.h
+..\obj\can.o: ..\FWLIB\inc\stm32f4xx_dbgmcu.h
+..\obj\can.o: ..\FWLIB\inc\stm32f4xx_dma.h
+..\obj\can.o: ..\FWLIB\inc\stm32f4xx_exti.h
+..\obj\can.o: ..\FWLIB\inc\stm32f4xx_flash.h
+..\obj\can.o: ..\FWLIB\inc\stm32f4xx_gpio.h
+..\obj\can.o: ..\FWLIB\inc\stm32f4xx_i2c.h
+..\obj\can.o: ..\FWLIB\inc\stm32f4xx_iwdg.h
+..\obj\can.o: ..\FWLIB\inc\stm32f4xx_pwr.h
+..\obj\can.o: ..\FWLIB\inc\stm32f4xx_rcc.h
+..\obj\can.o: ..\FWLIB\inc\stm32f4xx_rtc.h
+..\obj\can.o: ..\FWLIB\inc\stm32f4xx_sdio.h
+..\obj\can.o: ..\FWLIB\inc\stm32f4xx_spi.h
+..\obj\can.o: ..\FWLIB\inc\stm32f4xx_syscfg.h
+..\obj\can.o: ..\FWLIB\inc\stm32f4xx_tim.h
+..\obj\can.o: ..\FWLIB\inc\stm32f4xx_usart.h
+..\obj\can.o: ..\FWLIB\inc\stm32f4xx_wwdg.h
+..\obj\can.o: ..\FWLIB\inc\misc.h
+..\obj\can.o: ..\FWLIB\inc\stm32f4xx_cryp.h
+..\obj\can.o: ..\FWLIB\inc\stm32f4xx_hash.h
+..\obj\can.o: ..\FWLIB\inc\stm32f4xx_rng.h
+..\obj\can.o: ..\FWLIB\inc\stm32f4xx_can.h
+..\obj\can.o: ..\FWLIB\inc\stm32f4xx_dac.h
+..\obj\can.o: ..\FWLIB\inc\stm32f4xx_dcmi.h
+..\obj\can.o: ..\FWLIB\inc\stm32f4xx_fsmc.h
+..\obj\can.o: ..\BALANCE\system.h
+..\obj\can.o: ..\FreeRTOS\include\FreeRTOSConfig.h
+..\obj\can.o: ..\SYSTEM\usart\usart.h
+..\obj\can.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\stdio.h
+..\obj\can.o: ..\FreeRTOS\include\FreeRTOS.h
+..\obj\can.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\stddef.h
+..\obj\can.o: ..\FreeRTOS\include\projdefs.h
+..\obj\can.o: ..\FreeRTOS\include\portable.h
+..\obj\can.o: ..\FreeRTOS\include\deprecated_definitions.h
+..\obj\can.o: ..\FreeRTOS\portable\RVDS\ARM_CM4F\portmacro.h
+..\obj\can.o: ..\FreeRTOS\include\mpu_wrappers.h
+..\obj\can.o: ..\FreeRTOS\include\task.h
+..\obj\can.o: ..\FreeRTOS\include\list.h
+..\obj\can.o: ..\FreeRTOS\include\queue.h
+..\obj\can.o: ..\FreeRTOS\include\timers.h
+..\obj\can.o: ..\FreeRTOS\include\semphr.h
+..\obj\can.o: ..\SYSTEM\delay\delay.h
+..\obj\can.o: ..\BALANCE\balance.h
+..\obj\can.o: ..\BALANCE\system.h
+..\obj\can.o: ..\HARDWARE\led.h
+..\obj\can.o: ..\HARDWARE\oled.h
+..\obj\can.o: ..\HARDWARE\usartx.h
+..\obj\can.o: ..\HARDWARE\adc.h
+..\obj\can.o: ..\HARDWARE\can.h
+..\obj\can.o: ..\HARDWARE\motor.h
+..\obj\can.o: ..\HARDWARE\timer.h
+..\obj\can.o: ..\HARDWARE\encoder.h
+..\obj\can.o: ..\BALANCE\show.h
+..\obj\can.o: ..\HARDWARE\pstwo.h
+..\obj\can.o: ..\HARDWARE\key.h
+..\obj\can.o: ..\BALANCE\robot_select_init.h
+..\obj\can.o: ..\HARDWARE\MPU6050\I2C.h
+..\obj\can.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\stdbool.h
+..\obj\can.o: ..\HARDWARE\MPU6050\MPU6050.h
+..\obj\can.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\stdlib.h
+..\obj\can.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\stdarg.h
diff --git a/OBJ/can.o b/OBJ/can.o
new file mode 100644
index 0000000000000000000000000000000000000000..c0635c6776b6ce461e85132bc3eec1538d686684
GIT binary patch
literal 591724
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
    =A`ik#rA}c0Ku(!lMpd7~;h!dA*P;QYJ??
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⪥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%0DvnURjlv5@&9o
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%0AA8u&wgwQp1>$2^3qUsR{We2tI(QJos|
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%0DvjkgD_
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
MyM52A@&5e(0Z#G3&j0`b

literal 0
HcmV?d00001

diff --git a/OBJ/croutine.d b/OBJ/croutine.d
new file mode 100644
index 0000000..b10bf84
--- /dev/null
+++ b/OBJ/croutine.d
@@ -0,0 +1,55 @@
+..\obj\croutine.o: ..\FreeRTOS\croutine.c
+..\obj\croutine.o: ..\FreeRTOS\include\FreeRTOS.h
+..\obj\croutine.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\stddef.h
+..\obj\croutine.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\stdint.h
+..\obj\croutine.o: ..\FreeRTOS\include\FreeRTOSConfig.h
+..\obj\croutine.o: ..\SYSTEM\sys\sys.h
+..\obj\croutine.o: ..\USER\stm32f4xx.h
+..\obj\croutine.o: ..\CORE\core_cm4.h
+..\obj\croutine.o: ..\CORE\core_cmInstr.h
+..\obj\croutine.o: ..\CORE\core_cmFunc.h
+..\obj\croutine.o: ..\CORE\core_cm4_simd.h
+..\obj\croutine.o: ..\USER\system_stm32f4xx.h
+..\obj\croutine.o: ..\CORE\arm_math.h
+..\obj\croutine.o: ..\CORE\core_cm4.h
+..\obj\croutine.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\string.h
+..\obj\croutine.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\math.h
+..\obj\croutine.o: ..\USER\stm32f4xx_conf.h
+..\obj\croutine.o: ..\FWLIB\inc\stm32f4xx_adc.h
+..\obj\croutine.o: ..\USER\stm32f4xx.h
+..\obj\croutine.o: ..\FWLIB\inc\stm32f4xx_crc.h
+..\obj\croutine.o: ..\FWLIB\inc\stm32f4xx_dbgmcu.h
+..\obj\croutine.o: ..\FWLIB\inc\stm32f4xx_dma.h
+..\obj\croutine.o: ..\FWLIB\inc\stm32f4xx_exti.h
+..\obj\croutine.o: ..\FWLIB\inc\stm32f4xx_flash.h
+..\obj\croutine.o: ..\FWLIB\inc\stm32f4xx_gpio.h
+..\obj\croutine.o: ..\FWLIB\inc\stm32f4xx_i2c.h
+..\obj\croutine.o: ..\FWLIB\inc\stm32f4xx_iwdg.h
+..\obj\croutine.o: ..\FWLIB\inc\stm32f4xx_pwr.h
+..\obj\croutine.o: ..\FWLIB\inc\stm32f4xx_rcc.h
+..\obj\croutine.o: ..\FWLIB\inc\stm32f4xx_rtc.h
+..\obj\croutine.o: ..\FWLIB\inc\stm32f4xx_sdio.h
+..\obj\croutine.o: ..\FWLIB\inc\stm32f4xx_spi.h
+..\obj\croutine.o: ..\FWLIB\inc\stm32f4xx_syscfg.h
+..\obj\croutine.o: ..\FWLIB\inc\stm32f4xx_tim.h
+..\obj\croutine.o: ..\FWLIB\inc\stm32f4xx_usart.h
+..\obj\croutine.o: ..\FWLIB\inc\stm32f4xx_wwdg.h
+..\obj\croutine.o: ..\FWLIB\inc\misc.h
+..\obj\croutine.o: ..\FWLIB\inc\stm32f4xx_cryp.h
+..\obj\croutine.o: ..\FWLIB\inc\stm32f4xx_hash.h
+..\obj\croutine.o: ..\FWLIB\inc\stm32f4xx_rng.h
+..\obj\croutine.o: ..\FWLIB\inc\stm32f4xx_can.h
+..\obj\croutine.o: ..\FWLIB\inc\stm32f4xx_dac.h
+..\obj\croutine.o: ..\FWLIB\inc\stm32f4xx_dcmi.h
+..\obj\croutine.o: ..\FWLIB\inc\stm32f4xx_fsmc.h
+..\obj\croutine.o: ..\SYSTEM\usart\usart.h
+..\obj\croutine.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\stdio.h
+..\obj\croutine.o: ..\FreeRTOS\include\projdefs.h
+..\obj\croutine.o: ..\FreeRTOS\include\portable.h
+..\obj\croutine.o: ..\FreeRTOS\include\deprecated_definitions.h
+..\obj\croutine.o: ..\FreeRTOS\portable\RVDS\ARM_CM4F\portmacro.h
+..\obj\croutine.o: ..\FreeRTOS\include\mpu_wrappers.h
+..\obj\croutine.o: ..\FreeRTOS\include\task.h
+..\obj\croutine.o: ..\FreeRTOS\include\list.h
+..\obj\croutine.o: ..\FreeRTOS\include\croutine.h
+..\obj\croutine.o: ..\FreeRTOS\include\list.h
diff --git a/OBJ/croutine.o b/OBJ/croutine.o
new file mode 100644
index 0000000000000000000000000000000000000000..6f355afd2ba1f9350a4035da5e66fdb7c3488157
GIT binary patch
literal 526088
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ƍPE|Dn$uBI7JCPMnwrd
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
      R()Fg13gjbSmmaCiv(unD&TXY=XCi
z!L;l35)*t(7)*``mzvR
zUSY!{-O<&NSK9DMdF1nUmDn3{eh?qBH~zv%o6L<30+fKhQAahLwvacO;7Cv^7H>Ae
zk(^X4-eQ6yF{xO*)dWXUl7(Drf+HcxLasBxNej8&1Sc)zMysM>=mwsVq#}G76%DsQ
zh;-g9NaJIk_hN^qHYO6g
zek|a`*`QIS3hdJ{aAI*SXj&=HJ{z!5&FibFAsgAM~sDa2qp
z^=HE1XnE>bZHV@fxpaRzw(Y)Fh6;HflIWWC@>FB8)|^C#b9DN+!QeMV9KAv;o?|-q
zh98y~8_jC1iW7YBm#FoFq0uvYN5kJ2d^{plIA9Z0{FkWoLr8@^VEm6reU&P0tJZhV9($zK-10*?;?IntbDo(!Eg8<8TPwz`56k1|aLG(i1)BAD`tv4}M
zh-s6on6EIfdVAlBx%S4FlG=p}MM^|Dh!4xh-�HN=p_7spv_nOH7h9*Up>^Et+`~
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
BQknn&

literal 0
HcmV?d00001

diff --git a/OBJ/delay.crf b/OBJ/delay.crf
new file mode 100644
index 0000000000000000000000000000000000000000..63dc9c1dc0ceebad071f6ef7149e51c968ba2cfc
GIT binary patch
literal 562538
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
      )
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
      +BXClYTpoK
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
V{z-5RWd5mUkG@yyI5p0H`+rvPU(Wyl

literal 0
HcmV?d00001

diff --git a/OBJ/delay.d b/OBJ/delay.d
new file mode 100644
index 0000000..5094ac5
--- /dev/null
+++ b/OBJ/delay.d
@@ -0,0 +1,54 @@
+..\obj\delay.o: ..\SYSTEM\delay\delay.c
+..\obj\delay.o: ..\SYSTEM\delay\delay.h
+..\obj\delay.o: ..\SYSTEM\sys\sys.h
+..\obj\delay.o: ..\USER\stm32f4xx.h
+..\obj\delay.o: ..\CORE\core_cm4.h
+..\obj\delay.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\stdint.h
+..\obj\delay.o: ..\CORE\core_cmInstr.h
+..\obj\delay.o: ..\CORE\core_cmFunc.h
+..\obj\delay.o: ..\CORE\core_cm4_simd.h
+..\obj\delay.o: ..\USER\system_stm32f4xx.h
+..\obj\delay.o: ..\CORE\arm_math.h
+..\obj\delay.o: ..\CORE\core_cm4.h
+..\obj\delay.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\string.h
+..\obj\delay.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\math.h
+..\obj\delay.o: ..\USER\stm32f4xx_conf.h
+..\obj\delay.o: ..\FWLIB\inc\stm32f4xx_adc.h
+..\obj\delay.o: ..\USER\stm32f4xx.h
+..\obj\delay.o: ..\FWLIB\inc\stm32f4xx_crc.h
+..\obj\delay.o: ..\FWLIB\inc\stm32f4xx_dbgmcu.h
+..\obj\delay.o: ..\FWLIB\inc\stm32f4xx_dma.h
+..\obj\delay.o: ..\FWLIB\inc\stm32f4xx_exti.h
+..\obj\delay.o: ..\FWLIB\inc\stm32f4xx_flash.h
+..\obj\delay.o: ..\FWLIB\inc\stm32f4xx_gpio.h
+..\obj\delay.o: ..\FWLIB\inc\stm32f4xx_i2c.h
+..\obj\delay.o: ..\FWLIB\inc\stm32f4xx_iwdg.h
+..\obj\delay.o: ..\FWLIB\inc\stm32f4xx_pwr.h
+..\obj\delay.o: ..\FWLIB\inc\stm32f4xx_rcc.h
+..\obj\delay.o: ..\FWLIB\inc\stm32f4xx_rtc.h
+..\obj\delay.o: ..\FWLIB\inc\stm32f4xx_sdio.h
+..\obj\delay.o: ..\FWLIB\inc\stm32f4xx_spi.h
+..\obj\delay.o: ..\FWLIB\inc\stm32f4xx_syscfg.h
+..\obj\delay.o: ..\FWLIB\inc\stm32f4xx_tim.h
+..\obj\delay.o: ..\FWLIB\inc\stm32f4xx_usart.h
+..\obj\delay.o: ..\FWLIB\inc\stm32f4xx_wwdg.h
+..\obj\delay.o: ..\FWLIB\inc\misc.h
+..\obj\delay.o: ..\FWLIB\inc\stm32f4xx_cryp.h
+..\obj\delay.o: ..\FWLIB\inc\stm32f4xx_hash.h
+..\obj\delay.o: ..\FWLIB\inc\stm32f4xx_rng.h
+..\obj\delay.o: ..\FWLIB\inc\stm32f4xx_can.h
+..\obj\delay.o: ..\FWLIB\inc\stm32f4xx_dac.h
+..\obj\delay.o: ..\FWLIB\inc\stm32f4xx_dcmi.h
+..\obj\delay.o: ..\FWLIB\inc\stm32f4xx_fsmc.h
+..\obj\delay.o: ..\FreeRTOS\include\FreeRTOS.h
+..\obj\delay.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\stddef.h
+..\obj\delay.o: ..\FreeRTOS\include\FreeRTOSConfig.h
+..\obj\delay.o: ..\SYSTEM\usart\usart.h
+..\obj\delay.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\stdio.h
+..\obj\delay.o: ..\FreeRTOS\include\projdefs.h
+..\obj\delay.o: ..\FreeRTOS\include\portable.h
+..\obj\delay.o: ..\FreeRTOS\include\deprecated_definitions.h
+..\obj\delay.o: ..\FreeRTOS\portable\RVDS\ARM_CM4F\portmacro.h
+..\obj\delay.o: ..\FreeRTOS\include\mpu_wrappers.h
+..\obj\delay.o: ..\FreeRTOS\include\task.h
+..\obj\delay.o: ..\FreeRTOS\include\list.h
diff --git a/OBJ/delay.o b/OBJ/delay.o
new file mode 100644
index 0000000000000000000000000000000000000000..313aa7188e24038c2302ee72f4e2353c762e26e1
GIT binary patch
literal 534796
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
z
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
      Z0Pcq(oig$e?UfNdRI0?w_hD5xyvGh{B8x!%;
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
      E<2!n&cwd}AM|Cghf~V|W
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	!MCy
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	H&H=W~x8WDbZz_
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

literal 0
HcmV?d00001

diff --git a/OBJ/encoder.d b/OBJ/encoder.d
new file mode 100644
index 0000000..8ad3c3b
--- /dev/null
+++ b/OBJ/encoder.d
@@ -0,0 +1,78 @@
+..\obj\encoder.o: ..\HARDWARE\encoder.c
+..\obj\encoder.o: ..\HARDWARE\encoder.h
+..\obj\encoder.o: ..\SYSTEM\sys\sys.h
+..\obj\encoder.o: ..\USER\stm32f4xx.h
+..\obj\encoder.o: ..\CORE\core_cm4.h
+..\obj\encoder.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\stdint.h
+..\obj\encoder.o: ..\CORE\core_cmInstr.h
+..\obj\encoder.o: ..\CORE\core_cmFunc.h
+..\obj\encoder.o: ..\CORE\core_cm4_simd.h
+..\obj\encoder.o: ..\USER\system_stm32f4xx.h
+..\obj\encoder.o: ..\CORE\arm_math.h
+..\obj\encoder.o: ..\CORE\core_cm4.h
+..\obj\encoder.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\string.h
+..\obj\encoder.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\math.h
+..\obj\encoder.o: ..\USER\stm32f4xx_conf.h
+..\obj\encoder.o: ..\FWLIB\inc\stm32f4xx_adc.h
+..\obj\encoder.o: ..\USER\stm32f4xx.h
+..\obj\encoder.o: ..\FWLIB\inc\stm32f4xx_crc.h
+..\obj\encoder.o: ..\FWLIB\inc\stm32f4xx_dbgmcu.h
+..\obj\encoder.o: ..\FWLIB\inc\stm32f4xx_dma.h
+..\obj\encoder.o: ..\FWLIB\inc\stm32f4xx_exti.h
+..\obj\encoder.o: ..\FWLIB\inc\stm32f4xx_flash.h
+..\obj\encoder.o: ..\FWLIB\inc\stm32f4xx_gpio.h
+..\obj\encoder.o: ..\FWLIB\inc\stm32f4xx_i2c.h
+..\obj\encoder.o: ..\FWLIB\inc\stm32f4xx_iwdg.h
+..\obj\encoder.o: ..\FWLIB\inc\stm32f4xx_pwr.h
+..\obj\encoder.o: ..\FWLIB\inc\stm32f4xx_rcc.h
+..\obj\encoder.o: ..\FWLIB\inc\stm32f4xx_rtc.h
+..\obj\encoder.o: ..\FWLIB\inc\stm32f4xx_sdio.h
+..\obj\encoder.o: ..\FWLIB\inc\stm32f4xx_spi.h
+..\obj\encoder.o: ..\FWLIB\inc\stm32f4xx_syscfg.h
+..\obj\encoder.o: ..\FWLIB\inc\stm32f4xx_tim.h
+..\obj\encoder.o: ..\FWLIB\inc\stm32f4xx_usart.h
+..\obj\encoder.o: ..\FWLIB\inc\stm32f4xx_wwdg.h
+..\obj\encoder.o: ..\FWLIB\inc\misc.h
+..\obj\encoder.o: ..\FWLIB\inc\stm32f4xx_cryp.h
+..\obj\encoder.o: ..\FWLIB\inc\stm32f4xx_hash.h
+..\obj\encoder.o: ..\FWLIB\inc\stm32f4xx_rng.h
+..\obj\encoder.o: ..\FWLIB\inc\stm32f4xx_can.h
+..\obj\encoder.o: ..\FWLIB\inc\stm32f4xx_dac.h
+..\obj\encoder.o: ..\FWLIB\inc\stm32f4xx_dcmi.h
+..\obj\encoder.o: ..\FWLIB\inc\stm32f4xx_fsmc.h
+..\obj\encoder.o: ..\BALANCE\system.h
+..\obj\encoder.o: ..\FreeRTOS\include\FreeRTOSConfig.h
+..\obj\encoder.o: ..\SYSTEM\usart\usart.h
+..\obj\encoder.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\stdio.h
+..\obj\encoder.o: ..\FreeRTOS\include\FreeRTOS.h
+..\obj\encoder.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\stddef.h
+..\obj\encoder.o: ..\FreeRTOS\include\projdefs.h
+..\obj\encoder.o: ..\FreeRTOS\include\portable.h
+..\obj\encoder.o: ..\FreeRTOS\include\deprecated_definitions.h
+..\obj\encoder.o: ..\FreeRTOS\portable\RVDS\ARM_CM4F\portmacro.h
+..\obj\encoder.o: ..\FreeRTOS\include\mpu_wrappers.h
+..\obj\encoder.o: ..\FreeRTOS\include\task.h
+..\obj\encoder.o: ..\FreeRTOS\include\list.h
+..\obj\encoder.o: ..\FreeRTOS\include\queue.h
+..\obj\encoder.o: ..\FreeRTOS\include\timers.h
+..\obj\encoder.o: ..\FreeRTOS\include\semphr.h
+..\obj\encoder.o: ..\SYSTEM\delay\delay.h
+..\obj\encoder.o: ..\BALANCE\balance.h
+..\obj\encoder.o: ..\BALANCE\system.h
+..\obj\encoder.o: ..\HARDWARE\led.h
+..\obj\encoder.o: ..\HARDWARE\oled.h
+..\obj\encoder.o: ..\HARDWARE\usartx.h
+..\obj\encoder.o: ..\HARDWARE\adc.h
+..\obj\encoder.o: ..\HARDWARE\can.h
+..\obj\encoder.o: ..\HARDWARE\motor.h
+..\obj\encoder.o: ..\HARDWARE\timer.h
+..\obj\encoder.o: ..\HARDWARE\encoder.h
+..\obj\encoder.o: ..\BALANCE\show.h
+..\obj\encoder.o: ..\HARDWARE\pstwo.h
+..\obj\encoder.o: ..\HARDWARE\key.h
+..\obj\encoder.o: ..\BALANCE\robot_select_init.h
+..\obj\encoder.o: ..\HARDWARE\MPU6050\I2C.h
+..\obj\encoder.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\stdbool.h
+..\obj\encoder.o: ..\HARDWARE\MPU6050\MPU6050.h
+..\obj\encoder.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\stdlib.h
+..\obj\encoder.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\stdarg.h
diff --git a/OBJ/encoder.o b/OBJ/encoder.o
new file mode 100644
index 0000000000000000000000000000000000000000..617d212c7061869cda8955229606d7fa40e0530b
GIT binary patch
literal 588788
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%0AHl=pjOER_%ekD
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�xlabqM*v_oAwtL?l)iY~N=By-|&TZptcHV>yzsOB$e8ks5k!@aMWc!i~l3%A!3CUw#hj~eq`M!I~>pwrUtGScH~2K|-+myyv_
zGq^!=&}C#i)eO2f6_=3_RWo>~R@G%>Ow|mYtMyBlkx^AMc(PW_Wn^5{40=;_mywZG
zGx)`VhRbM&MMHQ>*N_JVn#S)IZ013Ms_~e@VGjy)jbAU=+=BvT;|C13@Ss53c)Zh=
zFv=7_X60tfmy9mhdZe~s8GQWBw|f9a
z9l*1B?0{A|fM@U6`)um~o~>iovmF@mW|jU%9%hR9LHIHo{Yw_Cet~s5iHI5#!D5+-
zU{PNpn9eWTIm->EKC*Ch`3l`VYaf@q`dwT|v}Yjfq;_>7(V&KC+P9kvi53lnDedk;
zqDc+W{BRE!l3v3=n9`muB%QQ|x^Nz`mkUWRZ6Hi(Zx@noT0=A?-N%KbpEeMtw66>4
zj#^VQQK(E1!q>p+hR)IJyGI>@5}z0bw84)&-(@p(+^
z5RVEppU1Qg^{7DgJ($*E9u?@m2h%#-rSuF`>mE*6#7~YpZK5;KeF4)t(xU?17cs4)
zJSxzA5z{&bXOSvXcxAm(n^C9#sBe&;dgzk2s%8$UaOpf!;nI7g!lnC2h0B~sc;#|QsH_WO9EqQP>*5B6von_9>0<)jHN|ASxu%emLB!QHJQR#
zn$(lnR0?`3n*_!(#!mWZ`+26F4WwbR}-}
zNa^*dCwWKOKlU@Qp$mI2?kw!_UH|qMqal{P7)`x{
zbV$;Xs_m{S3^I8U1*$HrRjS^r{IU=L%u9xG-rr}0TH(t|)@lJ$s+an~ADKZH)YGb8
z;F9>csqQoan0NKxru;c&civ&wFh8t%Ctzb$3=fTKtd98+)_VaPt7Lwf^?txc
z+a$G~4+1vYD5?2;7_iY+Nge1%0UK?WRCyl`0JrE|cMaiK4YF9)v>GidA?$f7{?&yLnt|J=i5gbKJ+y#3kgzl&FvloIJl-iMJ`K
zU);4?Iq;^iL@4h4$)12Y@)5JcY7pYw$f!=#p}lS>`7$RdSvY!Ss8)b;z34xlgQ}k_
zmC8frpJ7<409b^y3TyDb-T|bIDFCMg
zH#mT6chqs+C;)sK!KsvXT-m=#X&q!pS)~?FCdiIe>QI@}#Y1Ik9E5^YSW9=Il*LsG
zmNa{oFCS&+L5@4)(o)BIw}YwEi(HP3=^kCI3Y^SRsWiy0`3GCIpO>nuC?ffwppQ)8
zl^goVN!9cIcuND$79O>*TFt|t55+%#J%(~hg7PU9wR4=dA1D{8TmbhF{^-35Dg~ae
z;!f1SHGEo00IAP|kHz?+asoKOK4XIwI8enGmr)#EpS4k#1t(als^@IBIxnAKskeIG
zWmD-=H}ZnZ))VPc%YM;jYsEOqp3zG-+Ed@ct1=we;ScEGWm9D>Uukx#59_W34NkV2
zuu9c(1J+Qa0$(v1wRl6BjYle3Suv*whHiyY&9(^V>TCgU9kv9p;#vY&TP*<4dy7!2
zKx~8WtGcS;N(B6E1xj9^^$%m2b2?(3PhYp`W*$4W_L5r24p8irQ
zad>A0g!yVcX2^4#qPq);;hna
zlzg9D9*T%H(%w`naBeBVBkb&gSM-5BAP4!5hlXWSczj^d9j(%auYJR!zD0Mor18o9
zF&5p`lE!EFCos_mnXpA>ExCg31)Ql`F|*bL70!36^Xi$ka^9^fZ0hlDx&N0OQ_`0hqJFkj|5
zStMS55M`)~43)+f)zS?5m)uVE3x;FLs)GBun$@bxDjHfTVv4^ezP`=K$f9QFK=1E3
zJ{*tQq5tEn
z;;W07MfPH#Z+?OSWOUZf04;)^XaE_N4S?h3Nd}PVr2+6s(a8por7{hWBY%nkWO+;j
z@ERev4*dVe+?&8XPJ(72_N0Ymxrh>g9q;i(bPGZYmbQhd
z+X1p}K-t>?vSbhh$ZA0l(4ERd9-Id;WZyv$AP>re0NH5}1jvK&AOM<)>Q;iHC(EvP
z6NITHORx72gmGxw+nw5Q>dRNHSg79!veuLC@(^hW3c)_-ZV!>Bpb%UKxW_}JEhq#h
zAoqHRGzNuW*L0tUNNZ3C`tkRBi1aTCLFfGe50M^5A?UF`=poX_C_n6Ok8pi#$kNb?LV%%=~gwJ?7#=eBU0wB#>
zmN&t|tOa4~%4)yL$c*hvjDWFPL6WgLgCt|Mj3i@q5lP1CEs~7YaU>b54@ojscamhR
zo+ZiHolF`UkEZReC!NxGbZvJ?>6EB%`j9O#UvA=;_GY$&H#>ty8`XMn;QL531BFT$
z{IL#hE|)jqET2%PQ!o`eXT;Q*e92%ITEv!3^L
zh~ekz@S%FX*6_591Lk=y;Yo?a`7YrV6p0IjfG>asHG#mT0yO(N>s|1689Su;GDpZ{
zuhPH}i0Nqp2komJz|#Z**BAgx>QxsK*BSx<&v!uJItTFD90E6M06&)Lwg_|^Zn48X
zO=9@1Ivl@W83F#}0G_5Xh1(p!(-Q)B2rw5^U5I3HrvpT?xKDs)r2z+r*PUXb<8!|Q
z^oGDA8Yne-o#^f86g{bf%k=>{zmR)o^oO3)!I*z9JTr51K<0VP)Qf%Y@PWav=-^^u
zpwE>6-Kn>9cz>hlO3;q3)cZOd9@P#u%r{!q_<^p}NBGD_4G}Y7!3c7p|HL7(MnB~>
zA!LRAf9$<^l%!RaFPf26BG=p9i$(Vz_m5s&-s*QrM=igxIZjEJlXD<>l&
zD=C}4ag(a3A}?8)We!mIZYv6?tuhG8tRUcs%BZL~0?rD^q$rNyfCEn801ofB_c{B_
z=Zh%1SKq#@TeTwNi|_pQIeYK3&%Dn$WCGHG34+ihW@xxEOoyQvOb2iSmNC%jrpAM!{pAMk{
zpAM0toDQX`h^Fa2xsJ;;&mUJBld7Fkzb4^Ap+Zr%!C;wcCg~(94bZWk&YNLWUmjw6
z3yp-22;$)Sj#iT7yq~AI2Ylaw`K8QK(qULjdaU;za2>;bpg+raY8fb$#G
zJgqKSKxK^9mYm-pST`_DFW4f?W^HT@-!}M{Pe|-C>u;i0FQ%|mRZ`^Yg`sbiO3lH)
z{N6g9xS3Wr5x6tyhDSSjZrHRF=7v+Xq+pUdzf|fB{^f_(>!h6Na+4Upo55O`i=k<8
zB%|18go*NxrPA`?Up|T`%}hAOML#h2%`)S;vU_!YX>s7l7Y&yFX>h}X&p7-jRxIYj
z?Y?%S>VYGl%lq2-g<7~c@_W3io!_wf29A6w-W;Z*!L?KLi~bh(mk(l3
znykT{hq84(K5xV)+T)J4#VoeVcrnJ|Z!VhnLXRq-;B*49=}t)9Aj0b6^w
zbYz&TnbWiED?U#8yc#sBX3R(pI^ltdVcqqSbbdpZgzKf=T8oiG)eM$;n&=xTX-XHmItk56AO2g
zeY7w^(%|-HrSQe2Qx>{=_I3Br`E0mOt8>f=^MM6xBe^h3Qr;NR(0$TK<|2`<7+Vk*rrTAx6r8
z9*8uj1t^`bcP`J*vB8>El^B7Wi
z&xio(9aF8@Gae|s4@~c*pzxmYu)@hwKf)O?iNZ3yv@*}t%p^_qsJUOM=+ye_M`LVt
zZFw1|@A>etV|WepW0HFmduMv8)!^H|<$<%%{?J(%aiT>j25L4)pwBXs+-_ACy34E1
zZM9k&y%PMn5J>$nUyzz=hCVNXAl8`{dKUF&dx-zC4Ejk6;HRv)&q63o;`&}@X1ZSO
zoeTFx(4tJZUwB8{{pLZ)MlK6noRb6JW(MJaft%EQed<>AI|8WhYzF}4Ebv_eFuu-W
ziOSvJA(1L~D+RAyXqvIDj$gKR>2*A^N&P>O1d)53SDG#HKSio~?f<8O#FRnZ&M`Sa
z-F7`HKxhd*ZgGU#W#MOno7$NGQL^Cg=K`vTMx6w;R)1kI&2gDsb5TmQzZBGHk}2|{
zMtZ*zRQouomL)2_;**_19urXWxXC1neM=q}6z%y4xu>G2c4YlpU}$H}!iS{EFy1Wj
z8-b0slX3CBvEK@a+U!8_Dk|zm(pl8Y98b}mvOfLH&`HQgzZyi
zyOdZYl{x%FoacE^_-Xk~RkpKsCIaBvm|sUZ(kEpWtdv`|b2hcLweVtkW@
zk*jTl%vnldXwHJBXql
zZ+toiH69hkpTvo)QdPFE74K~_hE;&HD1|icx}pD5Hhe`-JXbo
z8cb5xEm0JPYp7f+EgK8E$((H;i()akhC@T9CTl$+;`^dV8y}A%a@pxGE@Fz}x;2Um
zbsBcZj8liC2Sa7)P<$tfq}V1v$2Rd$L`NmMQ^P)-YCDl1REUV_A4GJVp4CEZh9oap
z1Fn`b_N%PHCrw$Q=;}uiEzM?(RT|?n&2ZEMR;j~-6n{zAN0~&2xaja?fqv3Wk}6V)
zB`Zi|UAofG(;Ax!GOs70n`qL8dd6Uqern`-!|R!{XKoRC$Y{UgWVxxa{wJ>*P(`nX
z0&?(})p7q3NQWTeA<2SOxoq9)m8L^+^i$Y&%ghes$4z0!A=YFui5*8{-1JvS+6nqOtASbafFijx}FtoyxMv
zfr(|a;DKjeogCpw+6#rOIzC0qSLwZDe1IPa`Q$#m-wToGK`?Ei{TJPHG(WsM=k`E;
z50~}cL#twV8o51eICI?*M^ScG7nXLPq*l|9P?rD=@OxTJ9yp=_)zDe;gfy$J^7=4-
zJ$1^WUT7;zz~LN#1uuE=EO`;GfC=Ew2H=db58w`QY3T>TZnZ_#S?l~+rbT;YEtmCpi7C-_I
zRT>{`3n1p;Djf~=Mz;r;kzqe6^8IcEm@NT2)D?PRfGH0L43XA%1fb!~foCpxDUXY?
zr!jg!#}TV@=82W<{1SaTn$n6c1c{SjA;=uLT8J7M?kB-5;tE+97j&j}z80dOG^&?h
z%(~=`#`Mk^ooQxvgU5&eU?I%}gtDJb+&8EpH9o}}wjHRFkxC+3(nKJlC!YRMVr$mN
zrz$n9s?rx_nmlm}!K+{9e1xay(>8y~o_)E>oqXE3zQCV>_0M|FbB-UI9dC>tKfk#9
z_?6ZDBg1<)9X#04F+7bbcSwtRd*Bj$F2(0Ee4;vYdbVk+O!_gsvnHpT(N8+5WV}V^
zQf)*v=>f_|`+)L5>3JStH~dBeA?#WappNmIp;DD(g7w|1
znNV@_%>?t+qf;cw#N7NM+#c2z=IFwJsYzYIn3V?_lJbajn$U1koL)MmyX;X=0IX?z
zx&}wr7X6BX!&Gp=iI0<&?OkA*`}gHH#Z_7jsdma8wWE}z<&9c%dA2G?J~jYCtU_&
zsHbW!fPazmqZ8hm^%4A=d>##E#)|_bkSOTl4ue3oA(5~igpqS;DV|UTi%TYw*%_Tz
zrgLS2utcDyE8-y1S2hs(%7!T(v%##Yf>2gMHk?&P#SNaBN&~6&yI7j1rUOaM^e4yB
z>p?H*Q18h*aLRJ7JIQ+_xG#l2`TnGe;px?#qxccLRlY3_Q|gi3EhSNzmCR3&iq)B|%XD}L)iW5*h7Nn?h#x8U-D
zVG4hv4is8CQ&g3eCwF-IG^IJFIB5=Ui2g9&>OnIeC8;@$Kz@3}@^Qq<^!T_skOBLP8k!5IVbR^RT_IE&
zUjx;XZZxt~nnuKODunFuhtB0ubMK|DIWK^4Gfaa{&CWz;XJve*KE!`XH~InN#4R-S
zKqE>GoeZHkrI2PEHHn@?wDg-WG)D~o&Bibt#vrLd7Ss3CNnMznl6tR=
zp@pq=A;bOUE$u`RyRI~z3L7VSF+2sm{SPk!-1WXQVxwGS1IkEGvavw>Pc@ePRu{GT
zlbhJ#adM)6sw;%W7%bCzrb;m0TT3xmruQsZ7H|*5U^DY*(c}X_)#*#D=r9BlJ<0{A
zn8s1Z1vkdTMLEXEoS-e-F$PnD;P{^?ptY-29pBMM#rv`ZI;wj~7d&P6@(7Iz76~Qm
zb(+BAO+uEacZD4?p02Y46lz3nJ%gIvLn%f{L9Z=248aH!Lo1RO$kzqPq`9(d!RrHL
zY^#Wo@2)#5K*oj&B;QPTc7RM+DWH7u+&KZ%Oo3a229)oWJ2!yZnQ#xw_r|>;z}g9M
z4_hZ)oflv?n=>Ok>=~
zt}?-9mOT@0X3jI=G-s}Rc4^^gy1WnoJ(AI0&g!L9SS85Vc9Vla0~TV~HR=6=skZ#%OSo#gSu(8APTd5c21!858S?3^CLfeo
zlAixm7Z_#hOxGUyCWw@j3{nct1ZAm|Qj=6rL-IXHlnQg9Dif%%%WMSA7rkFqqL-=qd%ip@3>6EoNQHTsm!vH%d
z{W9}_lhaU)b!P+MMCF892Mpbvf~N+B=&J#KPYlQSINfg?Ca+D<+?%C|XEjGO&3###
zxL(|(Y3|R`$azn;+1spXzLKSpb!JPmMbmsWOCyIuS(;-s%>!AQxc=U%X}*@Fk&Wy&
zontl4*RwPUr`n1pdN5BEcf>|D(Kqr$aT8b7MBmI4#kNq>MBmC2#l}$AMBmO6#nv#U
ziN2F3ip&AUN169`^F)z7l*^jvp*&G!5b$$VDLtGgiY%fmCFy%vqWFd{bTCv(-_H|8
z7EzY6^n*N6WD#X4Oh3#MMHW$(()384D6$B2hLlV{$`eHvQI_)b<2+Gp5mKIhk|&BS
zLdw%m^F*;lNO^iRPZV2(l&7C%iAFYt?L=A1)6ernu|-IE`h~Q1syXUC)C`*~-3$hU
z$N(h=HWi_yk?JEt4V444`iNC}wtYb5K&?KYG6?AdDu>JV0hNw+A5b~Fqz@?izRBUf
zms47?Wf?s76R(UY`oSJTj+vA5`ib`t^304)`-%4ua?M`FZST~hUU*W!hmda=kMx~y
z_O9;UJPaQ~zTpz0{&_frqBeX8`8IqAg>Co{^36;&^kEOfhmdb0hmdb0d*
zZVlUU0R~SP9{B@l>abs&z}C%49L^HlrL-GT$BSrt*Y8L!NH(z10v&0Cv)9h>&>E
z4^k`adJ$!`Z-w2ECP^sFEdSk@AW0~U++27-_``#6h&
z9jxphTQqcV&x}>JkCvyq%ku|L`IF
zQNL*w9t^2!6O~A0(*Zc@M7o7yn4lsvxUa`
zjGeEMrCt{EK0ZxuKE0yfikYS@{W1Rw(dV#kEu2HoO);RN$&JM?Lv*#dE67{Ms_OYy
zA$ohIm8?Ixc77~GHxqmE5j)q-kB4A>BioiWRP$f9>Saa4+>?zX|@~F!x{uC6V`k
z5`kYhgWA(j?c4O_&CX4r
zqiHsdo7(#~B+$|P8l$PXKQDofCe{eet83>c(9w(JVHDy8=$@`L+;DHvj}>Nb^BLzC8sG
z=A)HHI5Xd2syEa`y{b1j-;_sixJ4h8?6ty%v{9(uqFg6~;x_8K1UlfEv8sBzK16eQ
zNXE{U&<#m^veM#e=*AFVF?WWDnK0w5z?%}_6f3Gyd4B>O8WqKj{6}7XAc2m|8)#%d
z&^L!@=c*K!Z{$AEAB@oUP9_IURtxlp66i$LNoEW5ha)sR>BbV3C)q9Vw}f~YOSBqd
z1}7g$pc8AQT!aw$M^o@Phqwp<{;?2_iacMreLR7V3`-Se#Qli~ZSQb0I#*>G=ud`d
z=k6LoD=_KsHm4x>?k$aO-MV#S6=%1@iNQH@GSOSQ-HW%cp7I#QzNN3&zr-@)`kQhe
zZkBh1;Dnom(e<4n7>gNxh0Ntf8Q@(Z7!$3S_X+W+`V{`l1`pS|PHaqqyW7Ks1>I)e
zJsvJB;+r`-%H(@JTvz}VdxX2s!-eLHgRbZwaQ92*at`n+fpPwi_W}6Xl%CXdFzoS?
zaw&B%$dsP(sJx(2+XF7U@FK?9^E>}5GD&@Fe;kUPb45qYm>^6RJ5ph?xRDBz#f(%K
zJNiE)iXYbYtUNG7LoylgaEMnk{E_WxQ=vTjUPuxdw$r?SKLn=?oAyA`KScfmgD*Dh
zA9}dJuvHo4_#W|afng78Mv?B1JX~Pd@CM+2!2Q_61%^Fhjng9t^}zx~moP$`9w
zO~lckTu2nl7J{6%o`!fV`sh@%Y0mXk%WKCF)32})T&o*F=w_8yI*>#xB-H5^(i&?=
zvCtg|XIKaw?Ga%}>N72dhOQBYF1~w}#f)Rb5@G26nb*)UPa=Ba{16GEy=l;`E<0xL
zrxWb>k;cKw5VF)N;|hWc(^eUlrB<1h59W-@2CGcU2I~w`HAO79&YLW`&X*jys)xpUgFT5#%Qxbw0@3nuYi%^qhIHQLb5*i;i|s}89z?%K&C_27I4%vINU$nYjMdP$kD)s65+Ui2f{(+)r97x7wIt=?Argp1P!BIS8uKQ62%h?l#MG`7wV6ZH
z4R11Z1_pl{zNtsWKGB$*Y1dmr`kPWPkBDqSoehG7)3MV@b@>UiMi$7
za%qc>h!p)<2U0n(Jip+lMKk7~b08CQ0W-9b{qqjsg=>plKMFbl?F$}aA&7&nQ2wHW
zsI2WLe$@X?^ipO8J4gG{OA>~9!{l=7ryM+`By!9da!-VR=p;IqF
zro5%#5s!?W?RHPvGj}T43ch?r5chC_cTnxM?n(qB_TlvIz-GI9785|S6*#&(!1jr2
z%W;HcFz{`6aAV8!QL(w8nDW^&8F2a_nP_EUZh3zVPFrM$wYgJU-GvVQ)FoJEJMBEc
z8CfzNgHP#9pS+4!l_||Q$6NJrG>^DQf#$yGTbGU;d)mx;K{ZQcZ*Q=CPt2{H)R|l|
zjYBNtc>&l_kT0Gy;d6dKLmjpiAFZ5%czWiI0eWJ7ac#95;f)*7n*w~RyBjra0#6hW
z_ksXlS&-ILOS=^~`VZ`dlrbt(a6t2pA^M}*41OR7k7IB<9R25v;SK;t!;{j8;R>5t
zC*?e+mSEoMpi(|_n7u+=xYfle&$zJ-)dO>*pIpo6$ekUjFuptpcfY9E;J2h?jAMNE
z(L<&vfc^i;-Cef44&pc(&MUFR@3FG9)=p5l!FClX+UcENnYd4;9jdt2%bF
z{gy(yV5N4WoqYdjAzirqY3DZK@miqIV}rtetkLHu3+bX2w2C3Tt(Y)e{unicpDHE{
zO-9c{BkMm?Oc>fs&7}CbBEmp3bwdSz+O$R!)$^F4`jQlCRcWc(<
zrKo5e2p`LUitj^c)^UkBE}KqvkodYuxLf83>1OLRA&mhaldPDn?5NL7D+k#jc9Z39
zihj~{Nm?GW_pKkWl%0OCQaAL2730oheN}3c?E}sVB(r@Y)Ya6?BwYwyRo|p9^T;Mk
zuB4!QZzf#i_N`18b`&cq?-!Eab;o@KOb18qA&1
zsAFwBF5sgYV59D}>ZE}Qc&J*evd&Pa#@XUL(GRZ7ot|kAsV~-yJZjzeLTRm}F-n%+
z5ILAN9gE_ev2{
z(`sy+9HKughI-I)#9U}GGAK!!2>%pL7YAEab5p*}~e&^xDEoccs(nuEyG=>;~Qa1$52sN{W)~3Y1?>D`$MB
zH8hPss+{vfLMssEVc68x{YOSC*hO>Rbkq095>Rhw&qSoYuCYW
zs2pz`;l={V{Uk+#3+NIgT>pXOr@|rTvd3{OFD~D%?8N0*L-ErL!qt|j(Bc28{4*_yQjZdrRG`dD5nRl)MB_J
ze_wc!yDzYjmon{j>#ah@<`-6xXT5rGXT>DLE#!K#(}y|?shks&Y|4>P=>*9eVv?;{
z5|zsN?21D9tFmdVF;1Ow^~ISak6s@6Vrvx^A+@x9AhnQvAhm3iC2w&gXNghyk$;9W
zv>h2fW=ndUN~*h}cLe1vBU_V0R%jnFT-iH@t#sJ3bNz@Kmg{W>SNEphwDH)~_*|XS
z^!DEL!y7lHG=Pc_{J*m|eR*Tj-2{`jpnrF7`t(7n7-E3@J-x}(XSQN07v%2??6?JU
z9!I;>8Ee*GG(>-tG4sRopKl9rk+p~o_DjSTa;QXP6o*PfhH$7fl=+8BLm7UkG<3?V
zI+#Xjy$@yUi`G8om;la^*nQ&M^1g0uO}F}Grtvk}U7E*7@
zQR^P{?S<4^bJR4r2Irp%Y!{AD)$Nt$Hk=PRqq`#Vz(#C;cy)4CWjZ_hCeyk)R5Gok
zLnYJNp<4WIM~zqlgWAw6jp2GHYMjb-3hF8Q%!OjkwB`&hR&Vb~a{a>u
zKEb$j{2wulo5`*$?;#H<_C1V};Frvi8pxB&V+Z~B#o971J4>{HsvP_(B$-}YIT3@s
zV6_@x>AF8Aa;V{ar@d>sK16?%N$`WtgA^xP6h#o@BzZE;KQeEv6X*A?;x5)Q){zSb
zA%6C~Fhv4*OcKpk&%P~pm>0?`=YO%5v6@lhK|FK|%la!Hf>7doh9
zFN|mMFLF@f8nfbyT)ZxJP^k{p#*H+&e~E(%*N;_Pbz$iYpsfs7y0CN((4_uV
zE-aY^>43!{vYs1j%8(hIzH!1Iy84!D0jJHBzqJg(mNewYief#sOKc^
za)AjL+|Ec%U$(H>nbZ+ldVBrd7FQW>j;10+CkGMU;{huvpc=Q|Yk`f)XK9ue`Irr3U1vj;
zf{TKo)oidTT-jhyC=E18qO_A%kGsJ6f8ErjIINek^8H`c%|8o1EC5y||B
ztp%4_q>P#RvB3OTFi=};@p_p269JL-Vw4_=|I|T6>)dpr5hwVlph%Z-TmX^F|Ib`h
z+*OkC&@YT4rzXc5+i-!0+z+B}xd^qQbx5H`gJWY@rcP_{mlA*a$`F(v)~?QQxh_P#
zhC-9?Nr$-rafS6`Vyh#&d0f~DuJmA`^A_VsTiZy^85wE+$V#ux@0(wpTi_MY>eAxg
z`F%W~uP)6kuXLTaSSpC|`}aiP{d)%f74|@`7Vd$(3H$NZVGmxx-J{DK!_#RGc)v9p2?-Nky)_+U4b-;;}p|FV?A)$P>q;^be&{YjDE_>s3nH<6j7L
zTC{;pUa6GGqhH>rWOjAumgS93hd?HsPnAmD!3}SI#u3aEd$AB714q8EBr@?!@&fl&
z#;=_%1lVICfWvKM4nWwTJ*1Qwv`546@&68%PKC+x9@4kt`yKea6Cb)e*4sl$hY*=f
zq%Y%N?E2S_H`U7nc-E6j*WY|mo}%INA~SAOL9A-kQ&(ulhbjO$4pgr#*)VmBPtQfT
z*Tp3D#f;;XS`&Fa?I&_X8QnEqX|;ybml_xH8?Fg+{Aihk2rWc}RBTYye1XH`^wKHa
zWh~@(drEd;k}4~l>LFhg2&b;%rDgfVV!mZL;!4YB*7H+PE8vxi)zP(;+4())PWgmn
z+f7}Ht9<096jBWyuJ(~z6G+`_c$<-Vbf(prZQ!n8`omeN9wd7#gId0H@TLS(QyJHJWr=Ue#U0%ZesvfR?*XK!d*{eHSHyBZ|mQb6mz_nov7cO_;
z8{cliX-$8#=;m3ZFJM*6+ZTz=_Kzqzl<};hE_Ln+i@owb8l%%gY?`n6m=RQ4aGUn5
z!i7_BTGdY?n$Ln5uR^CVlazy>RScn*R;@OxW0l5u(rjtO^f?2q6+vkj_IU%XlGiCF
zv6HbmEbOU+6!L^SYYm7~8ug4jr3-MPBw5gzp(Z3#nebqo!
ztTB?A+cgH(~mNMe+bUo%J*XUr(^Nyx7oq>3{}5}Sm4&>-8#)hauqg2Y@B@EZo$
zOahrn0)Eo~sp)A%8Ob~n@LL90t*0%HnI!19O{HSTf;>EWwlhMep)*MZxo9Zl9N|Yp
zC2t_bVTkt;6EAH-Y@m1^H^hIb9@Y=fLrh$heyRAyQqzH@#g#7hsm6xFsSlKX6+l}j
zE-kO7&>Zn&0eXBX?M=_u>^^Q-#um@%sY%?xC=c9t*dJ1TIt=UjwE)AM_J$FQR1=>z
z$o-4ix%t&1eZ0bf#TEgjsfy*54s5!+xF?}8Rjr&(yBAc-6K>f!U~~NeJ#%`Fk$_?zqCcwb=Lg}EQ`OD3;#2{>
zaLpAldy!&*@;9DdA={+Fbg>1c*P*C|yTpRht5DRoU1~v_5_yG-p#i$gNJ?z6u^L0Q
zJ#}W;u{%FRR%!_4hsX*=9Ky%kyxk;Djap~CKDiBNZ>TTgLY~yRD_nQ!ADF&YNrsW%
z+~~s6?vq;cFD>jHUzfrUCwjhQ>WKgP6h7IfR@2xwr0}VpHQnck_-{<%vF|FCOI!!t
zlp+{OOR$+zcz=puOIn02MDT$W0j{x5@^lPQ+?=9-cT$pq`!F9&QNRT%Nx`?Ke<(#k
zj#fz$zCQiKDH8JMN|Nw3>bImw$Zaf1!u9+|QY7S^mL%a@)jygdVK2BO4d1T*F;hTB
zd3vDLcrkkG_`_vXJxFa6mIhs1i$KFNAS(iyQCkrRV>f-l8Z(#SX-hvSm~|gajP0`z92;dHIJU$-aBO~k;FQf#gLI!V$@cQx;>zCca&3OO(_X4#
z_P)fmb=mo>Ky^cECL+1zzKTdrb@cvxDt5G4NUk
z+iPmzbq==I(-Ivm9uT34*g7C|O%PAT(11=Qz-wlLY6|9w%eIi9>l!n3*=z
zbtRd*9abpg*RzFrgwzyygj5fCgwzRngsuqk0A2bE0aWDk0A0@W04dyggf7u}fGWoM
za4x&~U@oxvU@4_}gcQv@LYK!pKo`P1K$pBcKo_?>K$Wq4xGGrra8;V};ZlUC?SGdk
zEh%>uiPLJZBYIKTEFZCfquD*1D!G#1p4JI2n@cbDG2n-QV{5uqae^PLqVWdeu6Ns>;z$6xe3DDGQ;=2u+4_9I?2iCbZMdZlV#-&
z)z~$=b9-p!lDqU|E9pr(8eiO*pvY~?qK^4prZhI|6)ZxcY!wYIJWdd=E<^sv!UHk8
zs9n|%9LIhS6Zi|ylEeNS9uOruTAO}9=Q+oZ&Ell>#zx13FiPF5oPjam|>@dXiSZ}`|9mCVfG3cUo|LG`Ydo&?Qt|H>9GT^*d
z&KDB0-U%_D0up$*3e-#M^7hZv+r*NyAaF)IdTr|bblkZiE-`;KFwO5hXQRglO54|M
zxMKZZDVoaizP0_`#Z`$)IN!ggvACyuP+n`cW#K|zYlf+C$Sch)&5FybBQzgXiq!FY
zx~^0@e%*$zJVR@dCbP&(2s@F4QgcHg{Wb!}whpA5UCihcf^g
z(>Q*bT3Ot2rc1W}Rwmv3w=&`GzulCKK{f*T*e%rkcv-|=r+!@9TwUwjV*9^_MK#yx
zFpk?+hPww>V>uBpLIDtp&+R9r52tQLbs_^Mr(HzzT3+IFqbb%+E~=*_!#R{VWTGUC
z4W}QCz!eH|VA`*Xi{)`x$nf|)&JFL3VH;s>4d*Q!)DvOlEuGc>sy5(50T-pIng^#A
z&8hH0fw3YeE)FQllupN7@~pvnZT^xZ*xVwm!F2K_V!l)|12cqm^fhreNUqH+mNaTT
zQ*b3>F;ryh2h~1EcKHq#m^&2kfy4jy-TQ?*>WI*40-aUP4{8F^{7{t&ou_S*
z)vQ{A5Tm@uKF*9(aco!zXO<*&^a%@bPCK)l(xmk#g;RHli`~3{MEW0l)oFe~0
z20jvT&hBA9%)qxqtPfM{k7VFj+X}OT7ngsO!P^r-4EG}x|Bog6Mk_Nl9HD@F-?3be
zy>B?$#yoMJI=^(zCNfKBaz9wpEs^w$na1(Tj>~@HHTxL*0gssWxeqS3916?GphHlG
zKG)+(&b_hu<(1V@co
zUYQGd*8-byvmf3(m<<d|1K+xVE{}hfP-}Tz5BH6;O`B83-9`xvWk&&Tal>MJ20t732KS^0gB_?yIB#`|Ipimt#gi11KapD2_S|W
z@J{Q-jU_eV?+FR4FN=+tJhk5&039-JTpMX`R^AXVo#oZ}9xs)W0IM4zpLT--&
zn6u{nX=bdlhWRi)KMn3bC+QN+Zu>UBj
z7gWo6X8@{o_s*>?NH>)=Onvn)OOB)af{8Ex3^RS28E)b7`PzDtzS&Nly9EbBKb*1>
zSD2^^D)o_O0YtMy*8CuIDg%OKrTz^INscvw&*{jp>>=nM-C;^i6nFqTtM-Lyg9r%K=}(ivbESgeaIx
z{?-htXvGW&-~^~n2OJL&ft}tl>1g$gDsNi&9C$FptcKBgKlpvUaAc-h$cal$x-fUn
zFU^XZwC1!3q^3hIV0OrGu>jIOPBup<-5f)0=!Gt#dEBHAVRzPxT!`HQqaxu7?c#Mh
z2@HC4iPfRh`d;GFw;N;4F+Y*bR9-I=jd0;h?S|KSu)>H9p%3ndkr>%P2tf99h0D~`
z&VX$?hUu*e!3#&SQ$&viy^sw1
z(mG%{xmuN#JR640PN={nrD|iBOv#y`QN{xm`C&H4{r6=5l1H4^B-RZ^+w5}U*qPKu
zs$#s+$61TDFlwf5VteDLs2Q??q_xkB)~MM)?_$^F)IWn+Jr3lY
z@}f3xux-ymsOU-zjKB-**0TUN2?lT?4_W|~4KD_~z~(##)Vj2AXoA&Gbow~3(bmU)
z2(`SxMm$A5QNfa_rRJa5ddGn+j5ldqXM*Jg+@cxK#J#t;;=;o?@8~dnN_bm$b!=g7
zA0_}+*H%nq-djx5GPJsYV;=}?VCKz0>0yZtM><7u$vaHS+L#(`+R=rBs4?l~$LNOe
zp(e_A;VIthzH(qb=ej_?3kUk}UEmm=POb|dU3cVBl>4T)HgH6P7uK=jj@LBLCvOH7
zP_N6#TP(l>M?(>LbC`a!y&`Y05DyG`)$-z5{34p@m0&E-11}Sk^7b!Oyv-`^iaB+0
zY5)8jP6ScRl4AiVyv6y)21+x78@{&wh@+^=bOjmUH!{;DaSZZXJ3}Jx*DHE6TOscc
z7}f62OTemLe|RJHUY?(T)qEIrn_rNCNk>N~
zO1+%FOTeUyqG8ls{rd!Lo1Z9kdMgQ-+~c8Rqr*o>6R?IK8+EU$3D^sL7#%-~y~t56
z?C@c9{OA}4%?dfy#PuIjGw89QnQh|qH+tl8llv2WodAyI1HAIb|!uXFqLUsUa1eL@8<|AZbQ6s1bYO54Z<@8yNpwjo>{WxUlQzNM0
z&G`s9b5xH<0H&jzZycNtQ$ZAt3?PAG=}_PK01{}HwlDt=Qz6YGIz5GLoeE#1{Rs-H
zq|QiEG%FK+#8h(^PVAki;9gOhh{GjY
z{EHh{{Y3K#8I|aqE(ALI=nD=3`@xZPlwa==(d)QnZUW~A!p{_Q;d|$HcRLde>8QlV
zKfSkru9+jGEWFlHAg5WcH7aU)e5`_A3eR)X6YJ3VW%Zb5RZHD31u+Q)IOkPPp%;t+
z$RYcspSrSp@4oc#4r9CDa^D(%2G&2zb8f;b}CyBZ2wM!yE8@BR)6b6Zs}%
zAC4Jduwl@Pp3cbtnflMVEaR4X(PP1rd9CXns&f@YifS)
zt*z_**JH~WDp)1W6kp_7L
zuP`{?ss~m0g=hDjRATNsT*85fe_q17&Qz71=&;en-nK1EC2G<27cQ;>Fa6l@o0ofj
z>EarTb4esG`uxg8wwLzpGuJAbl-Z5+F&8&IJ0W8#gW`48#{-lMs|<>d3i`FEajKeg
z&yUohdlAO1&H*Sr6aYj41rQ~9;JW9eK@t~`BbbZ!@2zALiBmwF2vsH*MEUPUDmCcw
z^bRMu-Q7LJAU28Q`Sf6oMGb_tzkZMvF|AxiVe7HY@$C&~xwvNcKzDUMW$`?}c{Vw9
z=x7U#%1t$?eg&|}QTe=xIjNpFx476{!1ZeCB1&V`%)!MTCbE3qwQ-4ukr@RW4^4qw
z>S1I`!D47`g551iT3mKFIa!Bykox9o$ULi>sAJgH;^xAo%F2aHcP1CkXSiJ{`G6vU
zMSy=*_8|Dx5`A?FmsHj#a8^PEL%o09bd<^G#2g`mxK?G-jv7uc+L^Y8>s&}^4r=B5
zdKVJrwDNYm!3eC)}2UloUhmb~=pWH)^;ZZ_9DSwT~@PBynZzj|sX>2ye{yemYe
z_DvZ-OVyx}2SKITXzwDA0e)Z$wLi3(2I*^|i(p8cO54{pQCF_O%*r)RLPls(0p
z^DAaSi@|j4i5BAY$zRaguN=lEd&}`y49^Hc^L^}@$!W77m<{hk5}%6#Q8duX@+W4l
zT0Pjw@I>=sr>!G~2vp=}&i07F3lZxh$K~A9KNd7uWax%vlDeLtX
zRm9m@~y-lE_Rk_sIV+
z@np_hkdxCUk#u|%s=2T-|Wr2mw1kO4RV-&NO4qc>{;k4_U(nmVzSB@
zAC8cTO$w+xsV4fK;l0|Zjn{i|@28$--ocnX2|v>;O%`#l3dzr7XrBFFSoSCT;@@W=
zBY*=k5b-G-DLy!<}I`u8zOZmFFxe+a>&ORFa)_u`Y!!5>9n)Rt0}_h<srSF3bWLG{^#}7{x_<)FiW58p?v$=jYvz><9S^K$9X?|
zC`f{Uh5~0r1ns6Q(OR9-;_umX>9}I1gR8gIZV|e#+u1kb{4!$2oQs86(gfJ@-4`5O
zle#X};!L-y`O*C)J}7Kg)D?=C`k-)xukW|^LE;o+6~_}kj^fNV_QL)6O3NaHn3lJx
z-GfLgV`6vBPiev|&E;d^N&j~#iQ1i+1A8#gNgCO^1yiktEw?Iu*H}PWx$m)nu)S7_
zeXj*Xn&%0M_Zh&HI3F0T^JK)e0%$MK@7ouh#G)o2t`iV<*g|1>FU0jG_sr#(?iqAC
zQMwR?m9CH0Q5R+E6X^6inCFcWS#oa;=c#C3=eph_ql2LE%zH6`5HAyd;d`-%;Qf?1
zI{5Fk4wGrK>Zt79#>&KAg3&o#+EQ)Cwn2^K?Exw_5UR&M<)PqL(F`+(eOW*4!D@|q
z45O;+GajrJgJ?|lSr1g-7Nf|O?sFchTAfIUNe*?Nk8s101msrtg#ee3fF?Y?=)=tI
zQpV;tl7HQoJQV7WC`oGW?(k3*bE%Y#i@faa^ia)222kC0mxsb>;c=#uv)z|NSgZ_k
zxVt-q#gzj&-Q5$y(pAL09&EJMj&c+Wcv#Z)U^oIbR2qB)u&>2KO~oLxv#&_;Mj_~o
zR&Zkw{ox^odeH5hQ$}==$^=WPP6kt{C?cogP!!%O3`GGbB4*3)1sE;{6th<~M=2+z
zhjkal4zn%_hCLSrlOgvA?;%@LD&8dXh+it;WH=dXQTnjbqTngsWBMy&vTHbkMjf=+
zDa$E|p_TK<<*^jWu#l_-G-_n@c#38uN2A6gzfRF?%F(DH{BKe;n{za3xcu7`&6XU^
zX4b*)QZ&cpXmD5p3jPx*nyopSW0>a26wR?Y8a0CceTt^MF-LSPC-jFTkuiiYS1U~P
z$0SkK6h@ioPf4PzEmWE4v}aJ~hN?u@OtZ#NW1?3iiL%yEXQEdoiL&NET{<|_CW&(P
zpr=pIND}1?0!L|3N@vpbjk-QD~-1K*caU9U|(>XcYVQa
zuJr}C`PCQP=2TyBn@4@YZF%hr?iAJj@V1ophd;!OEgxdemJcy&%ZHe^cqbygWVGmECeWkiq*m#of(%ZMNuu60<%0zsw=nP@jie?@VS
z_Na{BCCZW`kUIZ^oZmcS6cnK?PQpeO3AqV=x$;FcQ_)W
z`4w}GD!tiVSeo0TUColy#8iVkmVh_*@2CAxnTh4cMM6^zVk6l2RHcR;VD!Z^De|aU
zPO+oKD?}PjNU}dMtDe)Va(N9#yy^hG(+;D?z(b3RY>4MN@D+#Yjy=w1tk!ECT&9lG
z&4<(%%OsClCNFBwNw)|nJdi-IV;1X+yK&-!@(D~76TU<6^$BEDIC!%4tOT+gLwT)8
zB(6_Zadc~;e_p_(&O6UR&WA_^R{+739h7j1V)$fuF6z3XU{T}J2po6!)au4%31qAW
zno@pq0vWZX>@NM51TyI3z+a3?)#WiV><;P{{E7&f>=t6Vi{gE2gwC&tTxqg*C!Ba?
z-?MZE^PR}_Dv8i}oyhkvJ1W0)=51S8I$>@hEMeTAyEaBQyZhGQFd4yV%J(|qe`Xpd
ztzv;*9p)g6IGtc!AQOB@E2|HGNC7nqWQreV2H`}x%vER7^$OKIP4(XrK#RO2J|co3
zW>wqubT;rg5Glx4&vbVzn~tl*r!`w+xYr=ZKH2M>
zMmQ|rqgmnOj50j)8sEJhu!!mVEYs?=vtC@gX=m705Qpz?F*_JNO=-)|`)YhUgeHB5
zRL$|75Sy+Ix%dCw5IYqw_43}LhZ4YMcW+qixQcl=#ttX2+9Bm+sky$gPr36h0=sdrG?Lse}E^A(7WB$#eb2UUrhP>I3u9u)ZS!3+fyL5{BR+GHh1Xgtso^eRdkUGA8$ntS6ruEEWvU%mJx-s
z?S^kCov4kR-QxYB-@bN(m@9KsLx$U1`y=pQg{tXMjSef-o6(rs!mDFBK+pyNNL4
zZWV|5?L{1}+^$qVBM#;4DUxLhv-#|ZnxaL96oeutsI=TIiig+iSYsT!@P-;y^+2_c
zea4CWxY8IDUl$6Rz|tgmv^35SL-a5kLAX3TdMc)nC|kn-Sq6m{c8YMA2v<^+cI9lK
z^!*g+NS4$tqTvFm6zQfcsa;RQ2?Z(A%~?{rw1$hNQlwk5q;{2Up!A~@=`mSSyWocF
zrc$I^v!r(IZJ_j%6zQ>9QoGDLQ2J?#w7fA(>#VsBlpakIm-EDS0d}DDvm|leq{^;M
z{X9vWH!5docA)f&ByrxXoORlP(l3+5dBbuRZ87JYB+i?bvx18m;3RS0xSZu&Y$!|;
z=grGm+ocnz{zYdCug>pJA3k*$-;4Z3TobEqip`!srDAv*9X_?;H-mq66xF!qHa|H!
zcYt3zo0uhFP~p4F^Gkc=K;88UOgAgzO5^zz977@S!#PL}Z&+H?G0L^a&l;GfrvPOvpm0&!$BnFTpjdYV0K
z9WHF8a!mI_
z4Bty<(tVHgr5_o*mXnFx*Tin(fVCOCPMoktui3MJuCi8wm4`>n8A%c`rp4tE!^wX&
z$rP{X9-dZGY0oY#@6q0>ncHVy5hIU1!5_Wr(ZT6-sE>|zs#z;`t4k!WyTOh(T?9Io
zZ$Udtv(#E$I)H=kS2739oE^e8cH~r9J#nBJKPLnR!$|G%a&8DKhw*8Tmp52NwAxeC
zxD&F4YyQ*&PZro8lDW7&P-M|+D8fLHK2T!vMKM7H8ehCwi#DxJy_j6`GgvQ*zr{z@
zvDg>j)PVDHA2+opoOx7^yjNH?P3vPZoI^46qfwAyO-rswcuc9xL<5Mc9uP1@LSLiV
zR8y&P)s&f2;)96Z<6^=ap7bKpd#xNaWogf|(oeo~7cP%NoddD>5-+uPNzHU(O>Ssy
zesR@sKuo@0GeEcfo-()G9a~sB1$SPoE-x)~;4%PzpeEa{)~?
zqEXWiA1t6jI-QtKxtD*)YHU01z?{W(XqXC`nx#W%+fBN}O?`7=G0(;na=Osj-X8(@
zJ0v`0IV8N6pYrfiT1{2zi4`7?@o5j4oPJi*HJ`B>tWqOC#DA5(=(kfYyi`SmBu1~N
zfa5OLzkgB3~qKtdegkH+O_Tq7xs-5-#0HT(mOqqX3)CcU4OH
z)@jAhI2Llzv<&HQ&U^E0xC+wOtmkpo1|HX3;kKdaXhNK?*#5Oe#MgHnGfZnhzi}Yp
zwEUJ~T2uP1Metoi{*iH;`QFRlS-W
zO~laeEhMhLj@?4L`u<=c_C7dMZEqp7|D%Nv%h6WD5k~#VqRe%C63;LrP8(FYja)Ey
z=?Mb2ha#mjEdnX2z9QWLsFEEh;R0ysmZ4@GYix_}rZY)Q%T*M5OR5R5S87EevNbFW
zpxo5v76wuFWP*?@nGjn6htVMqsG8-Y4Hd`9Ex$&X|2?Hder7a7Io-q&N<7CLDo2??
zCNP^rW4uW7M#ps0w;CFqVnHaKet{Vj=QVQlE!wm(@tnSjmDl|)_fg?>o!aN>3M&gm
z*XK2?Bbc1``)Z2#zaE|Jt-V{bGCOxtcjiEc<|D@EGo7?+d~9XU9!wLgOw29I)xT2A
zRf~@su%#H!R(8~9riauQ*ZcBls{Mcgoi{m{lQtEk4`|ND8A}Ixg+%3uh+SVkXoW&z9d)o(t=`5l7yS$$a|~*6qmg79U*!i58g>J#W?7
zxyuE`EuiXTeAxxXE&E0;b$5H9ux(d3
zYbwyGT~onMLz@b=6>uulHn^!!+Z?4rO~aB3RE^8Gto~A$nQAo#gXik8QH88hNLI(+
zu}O^Ln)4OBI8)@=NX-E}@91N&O_|P)MDhBrjjK|t;bfQAkp8Ba
z%%fRLeaPbB_gWdEKZI1@3@g($+jN14T0fb@(^I&=V{K(_c{Q_wg8Ms;?tM3-#PD=l
zK{;>T5l5-=CwC>vs>pzTZ>K(G?s~lrk-0c|f0%x+W|-vd;rcB#7V_>{`dwm%LLitR
z*Ht*KHEo}Ipj+$i9XRsW1Em+O+i=EuiIfNJLLwZyS0fJUlxWl`IN@K9`Q-Isk|Iay
z&B|X>D(%IjJk7~}7@u44`3OGIoc!!;&EBN=T>fPiHO%a5e96x90;J5VdPr_fo*y8^
z1;<6I#_0tCQZ^lWNRIRG&|y+wIftq6AgCZ-vydRf+z|{wGR124(4;_SEuknTUK6Ma
z$Fq&e8m7Z`R>o)QL;RPj4*kG&$1&vOQ4@Ss9nFk+Gd`l3>o)VuR}#bVNL6pdvcR=-
zawnX6cA|sbo;#squlLgSOluGH54k<-A<^u$+Ru;m^QhRs;Q;tt#>*vm?$?5u}%%-Rd26_L?Zi5-G*Qaavz=~;#TVFy*
zGctQT%+zH4xJKJY(UCx1k!O5*XndNbpf3@?WkWjuL9lR85Udg>;SMlU(^yQWQ^2<^
zFRdNu$o5~YY;~~6asnvc&>E-~J603GpgL4XqMV!niqE2sQBABKOaOywQ_Z&jf13nuJQlxRrI!ej<0lH0m-9Qz8`))J#&#&xGcUI9?eLbQ{`ub?9r%~&$;jzK>
zN3s1inlCbrCVvYB4F1hP7=XT3cmDypMn;OJIO>!_Xlw0+5HlEJs{7$0^r6EksdWR>
ziV3$f`s0Dp3ppFW&A_er+=kEX_(c7}YIE1LX~|yBzbXs+mT+t;wt($kKJ~z=wpf|V
zg2lpGPb+!QS~m?P!{$P+(Bs>tYK`VlMSXL{Wu8%Wc~R=rwMl1TI%TTz&$2x6^iR81
z#~svFx%=BMawNprDT3;#%!K#^wAt_t0YO0mTt%Iiz-QtwQ~YlV@Rhs(!z92334A7g
zUhcUtg*ONNdGhjhwTlw?9o}QyitreG^
z0^n^~w;R>b%vgKZbe*Tj=z$d|Z@IJ2s&@s^3Mc?U3RM;hFk5>=)FQ#1N+y_kYyPF(
zPI)+%omF{PfIBu)xt?kFal@M*D}?a^rf-|-NWvX@XJXr%XD7ctpvh_{l0
z3=`xb2QoEgrulUw)NA;jhZvjjSmnmx`z~Sz&ZjnFr*d$peB(b(f`fUwX
zhfYQteJm}Bk*CGjVkRF-d65sDV&PO4r`RGDQ||soDFluKjmd_uFVe+tO)w%1!YNOF
zXLJ=g8MsGyt2`P*YX)0&Jm6^6TAxWl%sgRYORnUz-V~==aJ}j+0mLK4bNV1P(;b|Q
zf{to1tw2(pp~7qRL^ySk&Kl$x_4+eaJdMd%H)lsEr0>H>Md#3pfQheo0XnBAXZ4x2
z=dK?-#ko7`d#6WaJa_lkSfEIb$?W~#I)o`F*9jwqvJ1Bf
zmp%BOnP`SxxRw>M414guGVl=>{-5k?5B}F$FvR1@woocf4{mtJGjuYIohi}q){9I_
zhFc@uq_tpp>w%3*cX|nLA1u9iaKoz)Uj@UR>e})$PA7u%?B4l(fnJHFro1yLZ)}=(
zHeHL;$|PP4PBiI6CrWf;69txSWPh!7>cl0cFlSy5sUhN`R!ze)iR`a^`ab%LEEUjQ+5&vk8
z;M4eg2A|L36U`BzL%iM05zO%~DpdBWlGgT0Fl9>pc~qDuq`||(n~vrXWGanGI_ReF
z&OkSB@t~M)P5>urn>`eb5cZ<3R#2p1P7&lWqWQ(0FXF&?gJvy}0*RbWRf@8OIeAI4>gk&2H=k7j%fMl))zKt!~9GzwG0nX{Bc+o4p{**rLGow&5TiXT}U
zI6I~pUs~KpB+Ld>JC4x?&0&isDE%fLmA^Q6?IIMKowx)fG(K$dZ_Nfyhc
zjT&vfnVgvz#g2LNo6>fEXkQG_Ua4e5&$33HV3wyb0b9YZiGk8pHn{4BRw?jpCSCYs
zQ+E{R?)H4OVd_bK+X3dXC5y98H(0+1S8q2lCp*K6OU1I*mF^9jkSceEuT|{xXoMtc
zDFItbz7|cNFognOE!u|T2Thtd!4nlH7(ZyH#0K;5kbfd}`hn|soM5DmQ5%O-Nu*!2
z(?#s1V6G2KNFuzyNBvNS#`f!DI>M99AHE3UN4~U##U4#Fv9hl=zpuN3&eh4K(vEc-{sTv=RuK!Fd5H0|J@4Kq$CkwLj1r
z$d679{OIB(@3`rcA01++5J22e(XQy!oq{cq6r|sG^e?2y(8^Tn4c*S_*)8hz?$Cj)
zAdu%?;X1-s=es&hP9Q>*xdYrIX6&Q
z7mv(77Xn*ryLV&vf@jTK7kr73X!qJ#G(rzJv|cbGv0Tg$7ae^neAmAl{;^Cus=PPhSfm*aVr1j?Q0xkh%dR77usSxCLE5
zGl1bB_=sY=E^QIer6~@U6x0|X4p+Qp$yKo7lgjxcEXCA;?lP{xUfjo;qs*P3TbO?-
zUMdxD(en
z<71xpVuzV6MINs^pjaky#io?F0D{gxAq)RS2hCrhk9!)02VlbWhOJQ)d
zGPy$=qJ3m8-JgzayRVg@Lf$7Nx^}ZN*_vpyC(z*>ojPtP_)QT6Gj>Aq~E#*?+`
zi})ClM{P4sy4q%9fFwtr8jbDvyG`jOq*oI
ze3OASyZe{SwKu+$)Gk~gQX$FBGD=f>k-bU`T|?j(TP{_im1#fpo{EJ(AV0mR1xoJ4(jd1<+-
zMzeVKEsXNyYXPjay0&+3h-CNXuLnq6#I!#IvY+yU0T7E-A&&ixzY*YY>`t>wvl8QUu{@e!!8;uYnVB9qP$^yqG!j#Ku^BMJ(A9HYH
zA%hA=Bb&z^*woG>j`RN44sOESRH)@BV}BF=QL?{raATpk3P#EP)`3m!OyW4%CoOJv
zhd2d__E;tC8~A$*!_^f#{03))aePnxE7nsB%=uQI-R8r}8*!zvnht-Z1DoENgi+mm
zx`mCJ^VdZsDmJQ^&#E{bH}
zB^y?s-kA@Zg$Ja6>bcPtl%EY7gWco<#|pw=zj;EKMLuw>APnZ2C8W|So7!TnQfN7J
zycD%^LC;3aW=9>2b0iy`m58U9k^L~6%dlc@an)E>k{;Qa*DVP1fkg&Hx+B$H#svkd
zEbR$7EJT+kDwz03HR|O8ifcaw;^nF<3@WVqG>8i3TMa0x`80~Esw)jDs`nI%E2^su
zDy;Psh}*@h4JfMf6p9l;sWSB1{79x
z3{vjw?-fu~(J@HvZ+)MDqH2yoXcdv%wF0u|usNAbEhj)X2#C#?`(4mx2IOnFa4{dGZ60n@N^z
zmoGTS@HASB-SEkEaP&p7HV2-_xhim^#cSm-qBiah@*6CZ
z$oAZI`~vgc@&dlaputS9ym$t`Xt%2qvL*L0ep4BpGH;%#-ptOJH*iNrG?O?>T&Vs7
zziEz*8_cu#4TkX3g87f|;su%Kor2T+|8d=h`=9X_j8?OFjXiYIsxPL5;8ZjTP|~UZ
zniTfQl%#H`L#kv{fiym^V34+NaX;2#C2}R9LQJmhKY@4^F49rgY{Iuh{A
zs}QK{Qv`g$FE4$HQvO^iMFo4R`DzKL1gzU|-(i1sRBLrl!(6K{a1^Gd?9cT_HQ@QG
znLGR_%>T%b|8Nv$@8rj`)_wLc29XE0a{qZgJgX^B<`&xr;r=sl%(?rVZ
zxx#o^3|=XR2k|go4L)9;zz-+!Y8-M}DM2ujBv41`ydp)gDM_FPF|SM!Y)%rW<9|+1
z5o}2ksDp*hND&;9Bv3~dotYxonj}zTtXHK7j!hCA%h~qo6hV1olA^*CuSrs*vwD;%
z{+TJnvMT!zEX=R2!O1F^{Bw-ywHb<$M6pxm^tueiF$oG~P_NHWl;z?Pw;50-bykLC
zBqfP5s85N+CcY)T|$X%~>|n$#1WnMrIN*nw_9qcXW|yxyryOpiC(GjL_o
zr}Lp|)la%^4JtcbUlw7gj_U`8s;wUwDztuJsK)w%q4MenhAOKc7%HlMV5pw@fuU0B
z2S!yIEE;$<$uJE&Z~Hs-sU~P+|0mL^aVT
zk}8Kjp;RUG38jjFdMO{^ib7piH;M&JjBLD1IoxU-O$;b*jw$>rKYS8e@cE!rEI2J-
zdZvwiQe$KFX2I3qR0$<`(z3P8z2FhfxfJ|X=2IUyR?u4B=HY?`MAfSDO!e&|M0I-w
z`=W5ai~8n1rg_#?p-EP=oC|07n>(0;$^s?^aL@{l#!R%jO80jL$nhkShEaDp$gR03
zX`24aA{O=#Zkxm=R{Uj=^ph6I;ZBQ`3m-2CCr-%f9%SyQFOC63(Rkn+7ARFhN@N}e
zd{ZRp(fwCRYA&N*KMnACxIujWP@*KKm(;=5@Mxkk@pEPq)8RO^0*7wLEYivXaKDiF
zqDfw|WJ6C$Kgm(j3Rtg5e=m^|IB_^TMeW3c$k+eN?lIjnmpRx_-D7$NcEt3UJ5@0}
zo#sv-#kM>lexXz<(|oWZ4zNp?+Ew>PH}
zJ3OKog@dFdE~}C>NrFKTB{N;!A@`HQL2F^by1g03xQ@X9D1Pf>ghvQjuOxts0nim~mzMR-SqOo_nrU+*+lg?RfE!RH_=f&&u~ZcvQrLf@QQ
z?RF{)3!Sm$x&1QRW~_y6>&BR%ytH>XNug#IZc0*YN>Zqq1>POcxhORS-)2F7*c{aZ
zbxX+1le}vkMJJ4q(p`z%~D-0?v
zHKBmMYZ|{P#8)~0R3DZ}j%&kZwO-@XK}^p^KZtT8KD+}rcn?4({f+L)97RB!1Y(cy
zC<1QclljoCCGOEv8p9Fp;_YIMlssL&Y%o(h<=8!optk64gRssN7D3(TdkkV{3)Op|
ze09p|y#|BZmLgWTk+{zk=fbn%blMmcVYCkA^SRo1}l%YNQ4;1BJgR5ENp@MrBwzS
zhPETpjxF)5E7!~t!HJ_IZPcv5W+NXtXMR4Ib3GrdvpWw^`J4~e8Jq`j&gO$TOY^}x
zFY^GEiBwWwO}lScaVcNR^mSCps!3&$TRGV~o}S{FE_-(GpU*kwVEpp?-eBsW2}WV{#XT;SW|yN3f^b8DVh4$=c>J6+SlXv%RA@~9HGIB~&x3kQ|DWA4
z{a9~bpGcrL>E_y>
zFQ!fBuN*Xd55xD%T)5*Qx%oNWB1dvay~Jsen=qEH;x_g;eL!h0;9RO8nFX!14sFE5
zeR-3(ZXC;A>H!@!!=_cQu7C?5;zwTqkqQ3-2=8)!lVucI>dB>2W|l*xL24l`GV!8S
z=a!i`DN;axQLCF0yJX*~?1M&ha!KqOrpV@3=1xevp0K67D@j$b
zf3C@esv7wt1L5+5Gz>_%u})
zNj&u(jR+4DyP2Oxp#tzZuuAvG3QiAJ8kv-s8gwCUwQGJ+99tHNuyl!>*CNs1x$T}HOinI2MppB8RHcuFa{sG0l>et_RrK
z@&k&~%8HuJUBsO9?A-in&*J&D3|&q{y^Z4QM#KsRva=Pe)?_8j@st)ZLR%RhR=kp2
zEvy92EhMH!JxgQb{9cyInPYUx)Fj*Yjf5m!r;n*d&dxM*T2zUI$8_5
zx>PYJqq)9{=4A<*oLDHGB-UGuSU3hl%|mCF16lSIJIP||0j*T;)M}@U=SH$;M!hSd
z$Vfyj21)d8Bhf6|Be#u1{Fk#yKbc&LSkdz2aaNogO*`a>zI
zZ=9#H@gSX4bxTCEeQLZ`NOGGYA@7Go5;_fgp}3nS9})8f69txhv55zl_7meONeN@+`>
zrT4Kd+iSaRw_Dn7p($){mSuZw_y7It{EoS2e)F5(%*ZPB
z=tuD&{f%q$F&}N0NlT*;{h?%k;-l5u1!~Nvu1tTRJ?5jWScJk;mj6KeQzwt{L;{bn
zFF1*La~0S#JOo|GBhW|W%_-0$AxVS%?`2+SIvFeC4$X4$xV`ERewHfTiVA_2N`G_;
zf%TN`RGfSV8r3)VEa$h=xBMwmIbM*|?O!j8$WbSeIBt$!?vhr|3GeK_f=+ola#@|M
zu2iPns8!M{RAnM?6Z~2y71`naMSidgPg!*xoh@qD4Zr&FIzLZmYg;f6w_w!9>-{`*
z-&!ye4fWLKZ}Bt1PjPE76a2B6=?#7+cq~@Qk{*L^^)qd4-Bu+}@RR14-sr8DY`ll&
zSiCw$|8Vn?KXltdx%-M(*AR0A5$bY1E}>JH$E9>i@VJytu^pGvDJ$yT?{tc#km$=*
zpC@Q;d7n!gKMv`A4r#!AVoo2z`nW^PouANw(;KDXa}Mpo^BU1U?9!(9ES$A($tDH;
zTKcY}M)wD6^kn4tXNS12c(^!W&KT6(=o$jhecPc^&NJ1dvWL!hoYcBbgH@kfNWlLW
zO;BziQ-ndA$Q+JzeAkg2xRK0*m63DRgw$@b#&c$aQJ(x!qx!MTI2#m?Q=YW#`KX7y
zYKihR@tB9w6K7Bj@ZRxHy!7;-b`T{G+sBMDqLc@CSaL~JN4;EU$#I+`ZFhe$KT6SlYqL1Z)jG+y@)R)W}hdSuHWHGN=)2MV7Ooc1(~?STT%U
zEbRIXh1S1*(RP(I>`G~7l~2>^t&u95u31NYF!?EP-9eqklN(SfofKTxF4k&6o$9S>8X5ac%-7rGBu&|^k^|VTOQvx
zH(RVi7DL@#6miSSsJN>maBd5&|KKv+g5A}U&VeeWz#OP@3d(^hqy=-JiY3Va4zKkAVwBTPQz
zVg$(>iHsn5OvVh7{!vDl(u@!$=S!eJb6sRK|*_1pQuY&MfC*qM9`cXKbtvw3hbNHz|Sj+UEoA^OzZ
zBy~yxV;7R~lr&)cHC@~?uPk{NYc#O**R*|mXVb-vl6m`fKGU}X8{9UTXIWBHY(4e!
z38-IiCYYO|JAiOG^#q<1jID2yBv9t-krhDbJ9g3W^CDv+?P<*~Y1+nA0SQ#cgBFQz)&bY!KHW?twtz9PS
z$fklsxqX4DImu7ncM7eE?
ziFRargG9MKk*O}r_6CS@TOku&kxd7Qa{DY(#k1)EQEq!BqKKeZ*uo-#e}i--Ioj{V
zWN$pic60_4I_RAVQO@s>Vf~!t;U76~dIUfS$WF2;ljqE1$n8(@c^sc7@S%Bgm2J<=
zLY1-)#Dullw&S_}1m3l?ccyarbY>vd*#awl`xarXBUHRA9kcDx;>g5IsW{ST+f&oC
zIB|`p@mye0iMYc_n2JnXJ2K^Jk+Xn{w`h>NEzG8T!ct6kE*ohyA
zwQi>OW+^#%!RtbYN2ZX5pmz}xP0EKw7|`z~bdjzuuV6+P(C@Qs47FX|nCG#hhj(-c
z?qe8pJs!>>cz|JSXVAm2xViv40WX=BK
z?8t%Pa${4Bel>DMK+unBN^=r1(iEegjU&x5SrKv_Bj0t+phfxmX7ZA~R~5%6?8BXV
z(R}EWNbJSnzZbeHo=%*=-A4RsqEzO&tCB;E?6%ZT??;$AUtWJA!YI+S7J0_{FLK3y
zk;o!Pl^cggdZf;US+%2oMAMH^x?`p38G9D}itR7;IEIY?5xq^|SyTX%`)0^j2!17qW%^{Wpy`Xr34ZEfUt(c=snbkunMMsqhZUMIPH+?6e7CRvMdRq
z6L>*1dI_!r4Jd|-!~4d$vrma=LUK7_%v%}A5-2b`Gyd$N4e75Gq2@Ez-yg0+HaHWl
z9LCvVxJ|;ex)ovqA6lmf@p07RY53?=U!Z?eyd4^#_<9&{(ltIMt}#Q1qhtmVAN?Uz
z{0tu&+kb)2FY!@pgTZ_ps{pk+z~Vm=u8BmfMKU;-!rg5ce|QwALl5WRRy(&FeGgf=
zljU&T1gz85)WPe=z2ZdLsQX?hdVy!=5kfCQkrUmJjm4i@^rJ(_S&GV8-otP{SX4iu
zb)bQk+4404H_Q2yW{=~62
zKk$>=?tbin2Oj_MOOD-on~Q$z{s)h}<&%~0u?KGc>76g!iz6Tq0+BW{JX@Zgm?)O{
zg;iu%{)PWw)!(-WRsKaw98$Hoo5nK{{S`(HHwatlqW&(Tq}Cxs3qG<C
z2y_C7m;Q*8*4e+o=Sh61P4#x?QmI@agEul^SW3%xgs+5Y=_<6X0kp0BVch--`%eO=
z_lu*AG_W>f+`tHm0d97zab1eu9J%CzndS>d_m=lgt!s8jgjJx59^W6&<5k&0<9t(W
ze5?^)J9c1;&y*|22HS47Z94O1+ZeEiBsUC5Hr`94%_Ex0F^%kT5wyQ*=ljwLddLQ-
zYh09EFoOxN^5V=eyn$#|!adkp%(X6UA)UCYkNj2A$-WfLTU296ImLbTU}_L?qzb(D
zzD^<%*+HlUnZ#9gFDBOf(V5xeWCAXfiHYfvgGl?ZBqO;t9qDE=GD+RmrVKD`8=IWS$GZEEFbRYqN5oI{?#X%uMW*>Fsv
zDIYkAO6wv@Ql7GSK%ywecD^?=2+yjabgC~&#W?P=NvWAax;ve~)1a9FE{5w}g8som
zYBw?fwu3TMmRK&;lg3NfLo)eWg*7R$iQW|Q)ScnGl<+G99j&`Bvy0MHa>ZgagR3_D
zLTyh3hg>|02jy?e_j2ss4Bo_nfU-*v&*JVknPge{g?JB<%(x^8_;&GYr}r4xv!f33|RaBjr(Ek4mCKrht0tO~GMTRg;`#ni|_$){}1pZFoMB@hrK_pVl46N+Z+(nY9EGV>CU+-B@ed`V@J&@?b
zWq|g40hgQh6le1z2a2O}7?p7t4qneFI9$h}XbuxiwmgnOeD)|dMF{&A2Rp|iG#a7^
z{ZbeHxiX$WBHlYqlKdQ2CR3w?d7FuW)ZwFpxaDSo
zkZ%t_QusTZ@S@JE&f+^A)I4^gie-B7t9x#0gkBt`QJ&b}qso~oj7E(-mP-RW(FdFW
zJno=qusF)a(aq6?Q~83O9wpe$wU*i-g{L%$4OCTWXB<2D8`Rk^I44GRPgzoy?7oF
zEifh_TY+@{++iZh?@VY4{B+R|TK#Q>Mm~k*%nLLxHzI7k>IdH0XA@068*vu{a{O_t
zy9%!?PlFHghzTm%`&egq8~%kR;oIlwE*FcWNVw}ESAWw64MUwfF&$HAxe1<-<%&vb
zjnIFzN=TX{t+#3CLn@QdZT`sV#Xr(Eq6Ik#)B%pDURncl?9@(vi_h=y
z`8__=PI|Jr%$2Bo-iosFrP2PpUC2n~v61JE^i=;0suuqh#zzhoj+U^pj>!ODki!6i
z^_3j{F$YweDyeArLO4dRou$$4cwZhGG5+fso+&zUgFsljN~49`U;wt2utTNMES4kS
zRAdO-Lju#dmJ(r7G6Ju`YFug`wD5q&g8%%H?RBWS$qpDyWP=ErCiLrp47SRo7MZeh
zsjCOmIjl_Nu~IN^;3Qt>$n2s8Mhf2cu?-zDq-of}NJSmtofKY_MM$b(A5?C>9*O76
z9;_{fY^iW}4HcwXcd#@{bF>%7x6Z;0*EuZz8-!)Egu>8kLrmy+2y`HW8-t)19`a#Q
z1DVu7foytZKMs-QVzBSc1fVjc)Xn-41H03i7z~heepFXH*&W-4yZQX6cuySG#8&7p
zNBqcLR0CY1Ofm1L7|5U|Vy(!&cO~uHwyaE={#dmOfL+=
z4xlx}+E5BF3cwCz^4UbJ4T*Yj05+dZXH&5@r0OLB*j%PNA8SXVUK)TL9EcYZy|E6&
z`?3HuYCQ!bKJI}DKz7q>$gwSm_7wrxfqpVL#ltVN^ngY(x9LB>)cziU95D4S@v6O?nWWvK>*}8bFc8L~u3G5b(wT
zG#*q+z~lp)Mh9|ohnE6N
z*Js`yx*$sGI_s?T1JjAIYN|2G&(o5hqd2QQ4AiNdJ)8IfM_@M=x1c`{RjR
zhN=K66_%;ED?Aq?-ILTQz%b~=3$d|@>ET)EQWSzwsSCrf(qyf@6vksJZ#Y@cA{b`K
zTp=b^U+Y>9Ve1Z$?{iR*=`;YeSi*F{#l~iY6mUHS(xN<>>Wh=UW~ikt^JD6dbek!n
z%Fy6lNXMY4
z&5;CB#GnP@=zBjYO&Gc6Im#iMbV#U$@ubb?aUmKnlYs5HglClxdz#OQ5yZwAXjXQj
zkRzU+*bX~gvFXnHS2mIWm;V&`|Ip&7uwk9x{A&gYMe
zV;479JTy06E{^h+LaZW?uAYS2!;1uLR6vd@Jf500h}$?b{ZghR@<$e%r=(zN15YxY
zkD~#*cBnimgH1HKVcZ5!%@KB`M$lubVP$9TnpnUCpVH?tG88vvu2mYtfK
zEtV57L5}0DF%phRkcfA~lJBFPAD{J-VnPHdH3QQ3rA>~XM{zRV6r0119p%}|9K4A+
z)zh9;c(I!!4ODJ+=8?X?m61XfA{9d}7;W->&-bNL*~a>ra!KwkLyoDjac*AQWSi&a=^(*T1&&XPYk
z?Av9OD^2k+2T6kg;Pqab80zgIzudo4;%8Z+++MWPa3*uwsxCDIVL6jd>i)D7){s%m
z{Aub}<+;+VE>P-QUu1CunJlP<^$!fC2WUT%hRCT2y5-M$n1ivMf-M&ZiQ7{~ii*Oc
zlXT0;v%0O6Iw;-MwKumjnJ2drJJH|K4Z{~9CWlAL
zP9m)YwlbdZy|yq8$YK*m8=~Z?5NmjC*0tG)Xsu=KTb>>C1}(R&k<+rSs-PIhS8cyF
zj7ymtDuy^A&gWBZa}#O^7h?P8!f;)Zgx+x!_RG16f#MNO$b4e^v9R?sMNQj4Wrgl8
zPfuccLrq`$u?X(FUFRQ|g-qM9ZDXLEn}C}Qortp#OAcq1%IX|kP^6dsO^x-+(D}US
zke*3n8+p|20767NELSK15}BAQm+{`K(@kV#doiSPRG>mq@kd{zE7#ytix2DT{n#Ae
zg)5ApCQ19@r!DlyomhqUK!w+13cA>5yy0{!2Et^Y9?a8(?-hh48hRFK`C)O1jJbNh
za(%KUOLO)S9C#~Xpz`!3vUdjcCCymDb`td;S!Z>qtHt;%QFV3|>GZ6ykaN*4IDlLm
zj##WyoBAr8{_=Q)9-18#yDc=VKaU2Qfk6yi>_IY^V==V*FMS2VFSQ~O8Wiv3GJhlf
zMWiQCciuH}l`&2Zlr)0Mx~;k_LyX?>5F=?t4TAvbvii6@=r^B3amHBPE_6B&-AU9Y
znm!cjEe>NtdOw|~t!pUFjbJb>&#EK7BH9iYKhZExw{)bZ_!bONe>(~(bY4WP<5!Hc
zt^iurKaKl1>9Jxe)@AtT6nw}jiN^0oMkKGEZc$Fh&ACF
zwFgqW$d?x!FeS&aW`ecmUe7MJ+{|Z<51lCL*?yrLO$RkubwN;;eFWI
zejHDnrvskYjs?X-E=9gLIb4F*O(m6f7MKqZLBpGaSDWx|+P>i6q$>e=BhdUscg^jB
zf>Q1uE+3>+eAOXjmjgHr%uN>6bV2LY@0obWQDZkn>Bje%+U2HAf@B;wPQsytJ)&?b
zlI~&Bt|vcNbkv~>y}TGDuNQJf%H-&#k!*&wEcOt2LCCG7cpugnFyfNO4t(J$=`RUU
zchSof8*U}+f09Pji7p~|qvBT@92^mQl!z
zvzw1JJZP;N&o_i-$&(PSHt=&J$={IySW+_hhy-Pc^LiE&VS0dZk4hYx3QC)78ssy^
zo=M~}hj#@e9_|$=`(0QgvI|ic##hPzi$J`N`9FeUhJl!){-X!!(U^N--YCfO&Ww3F
z1(sClsRKninmwxZW=i2p!kl}~og)V8<@CS;lB9dI`r>uJj-zo|F;b*420I`uNS90VUMMAk@!I?%c
zDvxDB<>SGC()b=fg>qPHoEu>(+Pfsm_e)ACMS8p;U0zxD`YE(567Ug;?r|LEki~>_
zpo1W;L?U~jI+>Q{p?*kG7vfhbFT7x(pQ%n3AoL58T4mMmg2yfM%f}(oaw$(=m9(-R
zDr^6nl}OF$X(8YC(xBKXo7(rh_$*F0c$?P`Dv_>T$rHtoy;LfSfRr5bl2KLyh5dU~
zssNF{^b$KUYtxq}iBB#>7$Ep*FFlotlhy#@-+PJW80{^@KS?x?Al{y&I_8Ta?f|3O
zjr9BEw(>F$))7s!pC0+Ck=$q!#fR`#a3S3%huGItB3bV1JfY68hRFg6C+Qds(LcSz
z*R39g{9v9eoQk$EtsMF&DYtvbU?dyF4N+2JVOq}aMD$i4kyE?@)Nl7t^F%_XWu8gM
zS!3iNKOsP3?^1;1r3nL~J7%#fAW^)>Poe9R(C;_Unf`vZ?NLspH(~R9Kg@Wz(Jh^H
ze!}Q7SLA=1)dG?v-RqT<+MOj|2+A7yBoh83UVK8uq#Ce8=)_SO9Z7gVN|2ty&<2z`
z+dMZ;iY!q)Bq>N44a9#&;!``RII$f7JwX-PeCjaP$33{CrbL3iP>s-Ac3<`r(VIgy
z&v!75Iug;ey2fW`&}xda&TqPvqLE!mXVz*1&I4AtTf7Gib#UrSNW}7LHi)|GS@GjfI}nQbfO$gfuv@DF$y__F)**mfgZM>BnCCZfi4a
zQQFws)?Ak9eKJUlC#8R`yr-o+t?sF#1Mqlglqz3yNh(YOFgjBCzW6d#@*<{aqw$=!ESj_f?nsxv%2QljuF<~
zHN0k0rW9HY&`3?ECCoDb9OFGq?AX?*k)ani#yloYSp3OU6N91VKBnfaFx>55z?K>>
z)F?g<#CoVkuIDfs=q==CKuDGn*nt}!Y8yvXD%eqTw^D{1ek4z*sSEs{#(A}>#WUNbqHpyMU9
zZiV+7wEB1s?&K`^*FGfrOMHlNPjR}u`wF~INR{|Ul^$<8v`b%-&w-7S}J;8?(sG><`{Da5NCZWNhDi(53#<#g5kKkeD1V>
zCZzI(bHcP2+J)0eyYMItmaF|)=}!rP9EetO#L
ztz&(`Z9IIc4IU6q8+M!`u#r|<8Xwp>YNI`6U%RyRFcQBizN7ll&_
zUhLOv=lgKRIgRsvG5v$Mz9GXojNnI9Pa%677i>2+MbvNr0~guD<#~#C;1>*|Ctwdh
zF{gKJvX%yM#|0i1Z|8&reru|P=TwEq{|pJDdUXx!NTVfc7Tz<_GEXksxa+@08;tP7
z@YH(r(-G@ewdRT|{kp
zK;KP18ff$e%le<%aMRs2S}s{r_coNYSfrAY``=-5(L-`&IHWyAsnyYUih3D+v*z3^
zn6oAPu?TMrSSv)s+z4lNi->Lv;S$I2w<63%Vs$oJL^KUtGW=^l4n+!F9>qyvc-(NEyVvhW?X(NCJC6U8l+_2CcK$_#>6Mbjao>w(%D{(7w}7RtLU
zmQJ()ppv=*QA||!y_yxdm1T?qkQ`2CvpTapAX09B5V9U!6jp7?nf?g#hOqV6qSKmg
zuG87{tZKzszJ{s-Q1+knR(QKk4DL>q4a!|_QY@bjTQ95&H@$bUj)jL^f#xBbJIat7
zmMb15>}jm(64|vn^Bp?Av%;@fOx5A`9F*JhBcbzRnsl=!ZPZEQiG@;iam2b4sd~{8
zohm*j!CiE{hkp~6Xih?_lHckR4m~nR?i>Abt5Cj4QR2nw
z6G=0yHZ&iSdVHJ1d1C4Ju-@*l$~;%3t<~mJDqx_|k>a{zVTLvz!<(6b7Xksr>PgC5
zDhYL3Jh4Ag5j$Pem)V79lNAk>2)3LuN2bV}MXNHIa@HJh)U9-wQS7HB{iU!}BO)2h
zo><2?4)O+b(_0zGLb9>w`&B?Py#>k1oM+=)kR+~H#&SX>p>&MQaoM1i2xka7emoBW;z;&mxGjBa;i+H#)Na
z5@|6=c%36*0FVB7YBnfiG7-dfyTe9S7PaWq4VN-OO_-93BXd|N&fxeXSN?_7GAK*@
z9V}Khg}lwDR*b@N9h+F1x2#~Ro}-0KW{jepq5JlIW&#<>-5d$Fj&fx41jt%=J=b{IVhq1JxNa^VY)d8ZJE(<9u_*-E4;UR4>jAKCh=G&drk
zhEY0?ANL%Ayc$ew$GjgFZ6~}|6Ev#HB^di|wp8)m)P6;Z{3P-z((9%tMV9)q
z9POYVTGl76Gn>8}n)ff2h=vDmt=>Ze&^VFVron(xBT1O<&JbH*IZeAw^lv0V=L_~K3uES}iKgyJo{y1&n?mB3-5teFe
z#qrNiFw|h4-$nGdQ1O=mbUKL)sz=11CoNO3uDKdNPsL}A(lueUO-OqJ`ArSris0R|
zGY8cb8S1h_8@@YTsa$N`&TSiU<-bZ|CjghGXK`UGyvC2~8cgGg
zAmBc20m=4Zy*G;S%QvSC#?UdpV$EVLrVp@C|8mY_{0pOemQSLo3?x@4l4FK@P3*+A
zp#2lhG*U!`8I_|m!-VyOpVW;Eo;k#{u<=wLA9<4H1RftD5kUx;nN?Q(XGl1$(){Y!
zd2tj4hj~L(I(eM-P7e0LkgRr~`TTg$+4UDy&|@Ejt{2L|?$0%84DWn0{lyg=*pV23
zwcbz7w*uXB3LA0}7OM5p%`(h~j`)gDKY3
zj3C7+0mV)L-#&p-_@Fmd93;WQxO|-0n@iZ>Qsat@n-lj8BnlH!RqX1xWal?F$nTx3MpnQM;0sdl7X
zoPYj4-ez`kyu(IvhMa6-(or+UiH!l1Px5f
z5s~F%Pm0_?I0mPM$T*6#++B8!&mPDeE|!mwPbS9)9tT6-9WD|UW{9W3SVa+iyM;R*
z!cG4gnddEDc!k3Ed!ATuaQ6uN3<)kBvU$oKt|>l{NClt_b&yI{Hf(*7o^)mi2RFk_
zpRbvhmzuy|kd6Vs4qiG;^NHh7PDVc%KqvZ&Q~PHRI6md_jVD-_U5|qq9TO>go~<;B
zZZZU8S-9zii{^QYB^%GtT@5&OBF;yIRNaZ`Q9MjVCsZiD(g<%DMPCVXDHkPFk9KCQz%7_3)9OXZEhSv9V%VL|+Y=tHZypjeefaNjJdJ
ziJa-7sO|@1tyl?#Z(a0-;g!*shS$}f0}^hI#!g@K`ypK17H)d^VwoS>Qy8SY%*$3Q
zq7g1Oxs@if@>0%<9F2H|uTxmpP*jfKWTwS6y*I0@s8BtHX!?5OlB%dO96JpYX!KOc
z+#--y$3|OHMF2Kg0B7k!HQd;B;l^a1DLr$zSy)8hN6#LGSABmmT0VQ{^RZ9a_GfV~
z+HhGO1mzwuFijOYLq0)hf0Q1yZ}bKg};KS$F
zrIQI6Y{w6g>pweM!YR0m_62F2HdG(>ow(j0gvSO>A^0d+Njk`sLV`|oMLpn@R7p6HmDP!&}u&%_9mzcqt^dQdbooiIj@Yk$@yPR$oEx3
zoM|pFHGfIXw5Y0ZJ2LWpi}DM}7K@$=kTbwSZ6R00>0l^{XqU3!baRlb!7ahPpzL*v
zB$pN=A^7P1e~a0<2JMMDx29E3&`P(H3U7y~sy7GJffnQ|6^}qwP}P<_)qBi6i@gb_
z9;2iCKbdabvtGVLCeLZm|0h#zbc%1NB-4QRe=@atG}UE%_cB?=aJDb%alN8>N|frX
z&F*C)?6)Ir!R=DJIFWT3kLk)7j8#W3>mgvTa>i7XpLC0{bxedX-*
zOzpw3=&=%F=zSYlQ5#->Ie>>%zY>Bg5v2+m
z>E>h?J#;v^ne~fnk6}U^^N`^RrvWG=lA{T_PhUhXICB*Eh#l)eMnyP14M
z>9B~OVKXsY?~yFaOfyztIOt*El31WB`JDQMhk=S@0s5_!qDc?EQ8o)OZX?FGVLeS=
zj9846F~0EcO6`CHwbF{`Q?b}#?SR8+R`W#8#X%-HUgfdBq&m?9XJuvjlxSBOm1e51
zI4PMfJtGOpWSe6xgVIP99OWG~GQ)`j!&Cc?s%&a!GG%wv`I~!13i*_v
zZ1q(ILjCx23fbraW?>tB;e@jA8`ztRELA4qEO-5(C?NvN1TCC#|%3<25Zevd1b>oa%YVouz{xh}d2mT@Y&
z0FU|TnU?jO`pm;1{k^z=je}sg%*xV9vZC|01PSf4aOW^7ZdB$m{Btfo>$u!;=eT1=
z;uo&^p}Ji?Q=F`{F{vv7)T1CYYq};gY2M0#%atXKY_w%huVc|eA|{XQ$a(PaX)HcK
z#%G?Gj%Ek&x_s?5V$t$34e!PG0e
zgx7RfX@tX-j?&%9NB}NHl$)gNw4^T4a4C2f3t4tUNQZ#O5&0ZFY`MWkmMhjx|6g+j
zM*{fS>zh~#!w0eJ=77!fyaz*Vv?5K~YJ$8OYY$}4%&kYQab(d*?_4E`ry1de?@a(?
z&y{C*|BtU&2uKB`lW{IB#mhk?9lt%X#W34F;fX}lWKG)`Pb^)a@X)E>&1k&ISDgWg;2`4$6D*Q9V
zRhsD`m<|u<`jmosPYC-lu+aAp!*z2Gd)RbM3^r+oCm1x7uIU{yJQzE?vPYN#AE!2Nm^;aYRAq1&b;!7(4phq5O
z)R3gMB-H%~dLxVSzi^vIVm-Rf<#P5s5nX4dI9WPSmWHQ8w0+{*py&+4LjC{_>q(^R
zWS#19%un@n&$yL24gX4=m=l%DD0
zSDaM|>wxrnWfMN@@wwP7bD4iG^jh2v
zw-|TBEy3MzOK~^cvf4=altq#7^14WP<>E*&GJb2G{9?D
zM8c=nN5W^UjD*jOM#5*UiiFQz9SJv_8VR4XCK8UF773rbHWFTUdL(?_84+uQypD63
zK6QUM-Qx}WSR$U&?v!{>VLu;wZKcN?aYxw!hB^tt>jdKx*TP7!Ue9nF!}N^8K?yTC
zJ(w^dxfxFnTTCi`B>*8)N`exBkZC1Dh7eatNl{`Da!AY3f?7oQ@R^bDk+UM<`LiS8
zqYaVpv(JfypA(}?8Mm@u@+SO?!uPf1u6Q3kpuo*opYC+uIKcgkINh4_HFAU-?U&w(
zRRR277c=0#_#}>wOW6*93qLovbhez}`?K_VEH-0hchc#DKP?{aM40E4tAxDIr(^6>
zt3QzGu@OI=H6DIDV<7$J*VIv9x-;S|tbTl~R)~GW6T?#@YJ9~zsfZA7wN5*~m~>u-
z4v&t=A0xw4^2g-#>@*G2VBz@X&*IbwJQ`Fu?!-TWU{q3RX7&i(3Jl_d#iQ~^d3xV8
z9%{yWgCn!JsCZm?o~PRqz}E?(id6!1444EgMy~XmY4Z2P_&y!39?L@bDJRi*g$qpOTL${2E_DfU7B2*o--(F!N351`wx4R!F6rA+MD#5Y
z>(bErheOL6cJ3C@p9%6p+BqbDMH+VQk-y;Dl%Jf&8}v4LgX5uK5pA-pWav=$#4sL~
zpPeoV`Ao2NC^>$3dpFUi)
zIWZdG^k{&S1VD4yS7jBW8?>4>7
zF+M{Vk;?S$I#4W5*towJOFP_)X@t&{hDXR5O;X0^C-9iF5tNyn8n@}nV!J#%IzCJX
z2e=Tj`8K*;kjmF7T3qSj3(LXdY_{kN#=A1Uu)!Ia`&)y9JAJ`ivwg)eT;t3SKwGk|
zb8zpi2uk9e1NM@3C<~MyBk9>RF4%{)#UY{m_327xKvyyWIWH#X#axxrP~t#wyyd9s7P34rXJ@5C=}*Zc@z)iFP-e-4SS>z{kXBlzj2CM$krz-jm?VmLRu;~E6%
z&Un7_yGyh=zZ2pL=XX*J;J3dMjv=(N3*O*_>E1?n(;MCI9SHDuz6TNN?RsA$Hcz*E
z6mUhC`#plZ-EBFh?uxE(iEU2H%@vU?3{(Cu3D2y(mCjewjkbq4{mJKe2+
z4v7z|pXf@T(Laa8*VIqyMvvgP>_kuKU(|(us{wSNTC^V~k=^Gs4eHLb-VA6HI}qS@
z9BzYBkKTahuo0h4__W|devVkXs5x1$UZ6%ttXdr?eP;2J4ZY5{NQdSN>cR0&dSh%U
z-YC~zwXw#TL)g%4Z`#zhaSRLSWq5bP#kFkgq`*`9yn(G7TM&pu<4FUgiB?WX+=6#HS&ohrHmY!EzZo^Q*#*B
zeohm-)CMP^me?aSQrlxR%SHc_a3gZB*`AmN%LrL(gqnYZ=tJqDbn%x&Y5o!4j^L#T
z2o`%0FabhI3NWG#|Fq*nKK7mXsCJ1b*~~Uc0d9N5D~pRL#A%DI^y1*suDNGFyI98M
zV0a{|C!5a1(FS!G9)6@CJ3BsQgZ2~|9?QnzB;2?a4Ra+4^s+`dz{^JseicF$S1TS3
zN7EIf_=Lrf%#p9{I%^ltGKU*4Rz12I3L#elC;)#W#(026jLM+`BS5ubN3i5QnHsQs
z?)Fe09$-_7!xNN${GEl5Y=h*pPgW6^i10+T1^;ZtXB$4MJ!Pmadt)LThP8kOxjGJ^
z`!*62Wmr$MNoohE(H&SKFLsb{IWmw~)h|^@ld+W9c
zvLhA05ob=f>gMo3&;F_6sC-Y+F+F7aOLJr#vy;QK!y@{H
zkab$9>9b*4_mM#$KU=oN+J|yhJEVT)IafwCN~cvdLBaPaw*LwqMx;_rcl#U5p5lj
zd0oA5UTYyH;^vjWIybKbF7qY0UNqfXLwDTM4e%<>vGC0`l;$OFnqSVBfGJZAB}PP-
z({*41m!Z0>B03wgHiw#CT5H?hsUT$V`Wpx!NW*xNMwDGs{~Vs>2ev7Ff3n7viAM>Ttwj4B0PQnRZdX2)LDYJ?*Q
zv2WAdYaDJF6Sz-vxIK|$*K93ubL5g6tE{s%cfyIgL367hjvGpfbq){+qpWk}U_aMk
zcOqZsuzMm$&d(!mnRA`=M$MgcB5%^%Do92S#c4ed2y-GwP_x7CM83gc_e9=`RqRG$
z_r#8%*3Iy1|Kz6qJD8>iW)8d;+LxuUJxglDX
z8=@t-Axe%Ax1t*4e0vjWh2~ptvRe5aOK(UUpB(pww6m?%8`8mAnHyQFC_uIgw}~+W
zZWr?g+(AtPe+U#;69%6=KB|4D2Iw+sr-e!rhYm#Jbx!TfwQg=|+}zpO-YIQY2Ouvj
zo+TwOJZ5+euZHc)-H1kl7MS0wjVCVuNz}?!T@9j0cH*$E39c_O;V99jDXJTzd@d?F=TO3%+Q-=S+gKxMOuNOWsRoX)uRp#|ts!
z>1-X6#3i1wEy8Nh0ez|N0@K>^$lV{g2Y@%P&Peq6&o!Z2`c2$IGsof7O*x^NFtrX?Q6`v
zp5a_3pJ(=q3Cv$T2=5{mupx_w=ySU%n;ZG(5an+Z{p{OKIcwpcL&y_N{o)1qgvAm3
zi^k#WgKkH2J7KW1pD~DPw;hPoE<~7vWC!(jOHP4h(Mm9A?X1O|M7=Wnv?aHo>ck;w
z+9DMod{e0YF8Da%`uIciiV1GpCU+9@+=SbckT?_){+jWT^LaA@o(9BX=-FB3JPkiI
zAJG%nwfM)z=Q?~;|Hq!KxA$AiDZtqN2tK23edRJ;nSvbj=&o0z?#|)MMdMfX+xTG@
z26F>;E}l#e;#r`L?VT-S7=HRw3Hu1S7AY47U|P1dqed?vcasWC>*hA_T*%%hjLJ(d
zBQUjY*#gu>Ld@{ijt($v
z&44!dC)+m<*qwIk
z)>!ApR*d~yWJueVSQ`e=tqR{7>%^eHO+s5*V_N`S(x2SiGC-Wfcd3Lrw!}KXcX{>z
z9Ol?<5%)gYop`4TA7Ne5i+5S<)^;B4lkf@}#_qPgxrORzGu2*7hi&Pkuq~ALZXE{K
zU8QDyZyft_s>*h%^C>zuHfeb{z^YuSv}v5RZchw6a5
zYuNFI-C1(d>&@vpGI
z0ATut1Ub!~L<6U@Z=}}a*&I6w%M0hGW^Fp6LkAm^#W4}R&a&!5>%S4IZ-C$C|L~>+
zTsG-PqygTV^rNl;j+*oX+Z?K%MYPef&IqmlQFv_wH$*im((~`MuMx+XW&}kVdWys4
z99{RRg(^|lV4A}V+DBCsQk-t`QeJ%nH9l(9s!_|})l{)Or_&01KRySzzAbC1ZSR|&
zp0H=jb47b>cw(k#50{JfXmJd8l8=(2yv(-ax&8z_F0bxR#`ptsTRZyR3gV5~UHBKX
zJjo!Al`IGMA45+gZ>F$F$=FRj@r1TZX&;m#!3HQ&Ea&x`SSJ1vk@^!6;);02nl44|
z{87TL$3F-0nZQTtN^mT-qFN#=8^T{}@m+-B44teEtZMdwT
z>=zgAcwS@s_U(8Fp#96iswG*AxsNSIsM5@0ue{;Ayc@msCwN%;+0Kj=iuD4(%5le%OtdM})>
zhYuI`&P>7)+8!A$x3#o&?v?MnCx*+%ZhPSI7k}c|n;-beZFfKRzypte_$9|~z0E~G
zcK?IN-tx&x_}BwC|Mbom?wu}=@5fd7@S|0}=Gctp!zakF{9EHVrmSbs!&wrWO;{8BL9%}ioaTcq)Lixk%wN%;EJO>>d*fO=P79yBqzM
z5=_}|!74i%fa_D)!63WJgC6p-qGVSG;4~`=_EZmgkCzo*folSAniZRDr+Lu2gyES(
zX(sc++F&&NYv##Tak>Yst3Y$3G|mV{GdBw4Ob=Suk>*B$oE3~_Zj{N{9(2Ax+m|cY
z$@ET27)qqUgM`x6o$et7isKv)qGu?Vp%*?B7Ny~|M6|bfB9ZFzpcBG6*TdZ1Z5Mjs
zc{JY&KcjUfB00zitdr04Ah6-7S-NS_CC_(ZF-BXVw&bDHaTjvC>rQuPu&<5ewV@UpJs27c`pFltkfV|$kEo^!biQwA3-?XJqZ-!-;c=TWp;3(&
z2cfli)MK+B-|C1*MQ#YfEAgnxjX`KF9yPkjk8g9tqfT3b@Jc-Dv^5B=#iMH5{P=c9
zJZiW-2(QGWnmdBfN<1$v{rC;(@juHGV}fnwon%YCP^k4>{bZ@UCDqbECc!KJ*@k8}*IM
z@Uczm)-q{~ChiXOZ9G)vpm7Te4q2&mcc8AjgOJRLn(px+dEj!gOv~KfKrHj3p3{|B
zC&L}6=PLuT%!^9CsuJsDm#h|jfmr56E%$q{^yn4**z(eqjLZ`A9jNDl>Ljg1g4)J=
z%1)V8NP)>>z5_L$txf{V!h8p6{p#u@Sn$txpyqScNnl!;??CNiqN$da%|wD0P^eA<
zW5zt4R35BOvXw~C7Is!Af%Rg(6D?v_RgzXJ-A*)%-PK8`bUV>DhN_cL>2{)l?5R#d
zrAxa$*HkB=((Oc3*;}22O1Bg3qF51g*
zRgyL?U9^{d)k(N?(OyQXlW^&xy^K~Tq0%LrW6?vxx&kitPk6?}&1f)V9vYhCc@pQD
zU^5!Rem}MqH*u1Dw1ESDY@5QO`p5m)c7;XFUtfWxS%P1W*BZuV)crvZQ9j)>5T}z-
zgSG0bZ^ia@gdnX1|`jiKk-IcTZd-@AD)xu^}_jC}F%6~H|
zy5vE2#RqWWD@EhiW>oMY4+@Vs&?E#clU6B2fa)z*5aeuL3!zqLJQ$kbFfVd)wxBv^
z18|fYG7-;taID1fb@Zf;Z$Xzo9EhdlZb2m|UY(Wjrdr-T2Gj_b+rfGf)s`uF%
zRY<`33MB{Ygx!@c&~D&!JUCj*;Pp+ypxSTnW7LgeKt9)tEM)C2l`_2Kc|KHxJwX)Nu8^#UsppTzbk-pF*2RH8f`4B;6toigO-#nmZP3Q<%qF^H0V
z*>0{O${dRMrNLO2{pAjUlLGa26^@?FBM-0e6FAd7RTpydN8R8<0{cGKVT?U9rok-W1ifmUVc7K;m}3yFFC2M5oeKW&3VFiqsEkTkr9sblZBbAJxju73KQ(4lYRv)e{y~CN`jCU%701qZH}2a=7`gqFgVt7&
ztUZv=F*h>&X&;*0ji{|6yPpX}s#Xf-&pG%+Uj~<}!!~8NcW{#v*5`we?NsR~j4uQs
zc}PP!elZByLSm7oF9jgmw(-J5SpN`&+{${ju)Z9G+(Jl{;#Y!@n@Qb9JA60@*+~h4
zLjR8eNIBX;o%?D4vI9HiE%VUlz7~Y+pw0|^?(0FwHsXXn_l+PV52DcMz8QdQ-%6a&
z=Kd)NN!!8mQ0V^IK`QOq&h64|@Y_Bd>4>@!ekT~KnhJ{WyFLQ9dH;(K*ENJY`|~nx
zRL=K&1h5XFwaGq!M*gopf}R{yGPGi}((n6_NS1Emj|3v!CjP@pe21q@e&k1b3+3Oc
zpxsjWv7f>%mPh?ad6GvL`eS~AigNjhpMuveeM7o%j#Z~n$wcu!?hp}oHjZ5p*o8BL
zJ-sXj)%%1&p;}J|y@Me2Y*gaE`$+mSkQUFu6A%@JXny9Sz=+nt+d4YAKMx{lcS$fn
z{33{?%_YGA^UENTR+j_=)USd_T3iwg*}ri}P%WgXQ|(AapE86}c`}G1lT}rWGWm~6
zg1&em(aVAq5sKxhN+OCUm$c<$w5pN+XC+a0p4JRzl2AHNSEo}kqI~|Vl87p_Yltge
zQK5)_TSV6>u`A_PQY81tGoGLTShX?ra&%Lj;~+lQLfDC!v{^OPEL?<;7kSS@hCg
zOMA*n%uD<<@qr;t03k2)5~Omu!7OHTsT!iWygUF)RsyPGG?rHcp!aAz+Q};e@T|XN
zx>1_C2i+Jzr8NU;Efg8r$*Tg$vTzv7C5O0C5gA&_O#x)u)=ebH^Q(hM==?j0A{x};
zYaJReQz|+cgG{}y64RkG^7=|lyH5Kpm6$fhAh~a-#I!O7sl2rk)4~{}?M)5_WsS!z
zc_(Z4045+xJgV)sK!R+>(a>%WA{f#VkjXm&3A6-EVQ&s1*rO$&y515$GQ|7t05V?1
zxKxPpy$)4U+B>Brv@&U5q&U$)-gg`_HB}>Ze_u(7;f2j>Tz4qt_g5uwg?ylrhDI4z
z3UYT(bqZI^y_H1CR3ew^$Aj+f8dF#ws!l~ZD9OqI+5~_prAf&lH~hRDXD6sh(2TD
z5<{3Mx#6K?K5OE*FK87W`Td-UhAyGaQOM`#1Cgqwf%%ILUM@s2g`{$@z^i%rOBHCE
z$aYiDCOnGg9|G`08jt9|9Dv`W@reE_0eBcq+uN?92vFe<2NSez>n8#f&OcTVTt$V-
zRY(LV^{+Vus2JS!n6-Dsufn@#G)k*^=<5rRxSjGFCRM)BHDtq#rUsgC24G=DBP_D<
zPXSmM(FluD_*MWGmKnmL4F5R*3)>7~Q3Kx&z`{C1ShULTI#|v$c^2E+v?Q#53BXE=
z6a;@S07)h(r08D*P;5FyULJ99v|U0iF`Mfq)m-&-wDlkONN5efdp5kqLTN|M{?JFp
zyDYA$^+#0+RHZ@4j~yDlvB5=yR6Od(C^jH};vn4}p`Owgi~NbsOMP3Dx@ak=p9DRnvC
zFlL~8TAl20$ZHKEDeN9El??hkg4`^Bhae}rPY~o}^$&oIY%WKNIg_X3hs@#y_(d7y
zKhTRA{6lG*!zYZwtha4={o-P7`#=nymJ9f+pK8M^6-OlTiA_vT?dN~sZ%7{Q@vd~t
zhU5DP4m%Y`8f|+DcTJb4kH7``EQQA^8pkCAi4clgh05dm=5Q0T-Pi~h+?m-X@Sd%C
z2Qs-79kQy*Z$w=#&ccZw{0*9)j7PhWzjJMDz$D2XADUrb9wALOji7d7+ct&4~W`HeY@{cz%alUjA+rmIJQud3(`^N2lClG$^NdDcp&;|G7_YB7IY-S&htJ1f8
znk{d44-UYz0ll4GcSlD4uEw^pN_8AmYI5l-lCavi2~x$o0KgWVJaOZDIDkPL@lLVv#wN$w#UOo|`S
zA?XYY5~2UbeO9`qk-NN*cMRaRR=>aei5y{Izjk@`JQ_V(I}T{5`2vk@iY}Z-xbkcN
z6grHWGfwn;gcSXZO(94M|5e-sAE~Qxd)*wpt|f56&&UDXW*vzva;|h6$AznrkPFL;
zT(hI&hv|8=J44pqrlyyLCL~a
zio>N+8M*n8Wjz^M(exyG&kXX}-nQ>3ZlctAz0plM{X||3vgkip*8fCWn(m3%_MD&l
zK9`$*GPj2;x+rA5pk`asFTqW5Z|>N46dt8@4P3S|YFXq)+=?uk3Ry3zX~`a;TBYjx
zoCsafke$I5n*`k_!p&zieWu2&J70ddmxv=MK)M0sC_XgK<0KMVKCUC@asHGA#(B&L
z7$f63?03j9G8ENgAbivHPmDN;!^2d)xUqS-)Ql$yCI^}@lz9VVG8BG-2u0jPIEy1;
zicW>ZI0z0|%#8c~jy8_s!r|tb@(5l~Yow;$)W|{f$Xz1^)8udvGEbOz4#c>=9tlu!
zD}curdCn?{UWdXmb*Viig?Dy5jj?@L-%R=fW<{TF+PJq0^Mu4
zB%(J{i2uaX@
z8g0=gk9VKThpi
z;^i6;Vuk+c%C2{VhP8W+I}6BD`Nt_jtXT>aB>~#@
zQXzk=r7$5*2ZK06<6G;6I8##4&$B3;ew@8j&{xALkept#b+HiV$e%*QbXdnSABq$~
z3|B?0LOwRELQ>EZRw4PD2-C4l(zi%}I9hc$t}tI^QTp0f38KSQ=JW%%nQsK=B`Ypn
zv28`T?(${nHL`3ro53=0iyPRZ=(f5+l0Al4x0!(ybcq|(vxWjLbps?LE*Un1gxKK*
z^q{ORb3r$$SD?r)HxZOr3ckV(mdT~SxEtsZvIN(Wng|wx;Dj5jgdi|^HVUm3?UCA3
zN&>jF(hc3cVra!KcW7A^@=Rp(A)Nz^X#^pk!RWEkF}IE`D=&b4SwyVi1B-`&BI
zLW`S0IHUnwI;4Ig(bveIM6g%>6yjN$lH$Bp1I;T4v=vxOz;zOkm|+P}_`VKAFJm3y
zpNMFbeo!<;`XR(v4S(&YFY4$AYE)W<7*{{Rb-nzFbH5r*@+UMPW1iIXgqtFP)E}q$
z2V|6V4ydpXN#OEj+X0j%aMl`1*Ng_R@a^OtJa;LV=;0k=EfRcWrA1>c)TQm}2MU`1
z{?ge8s?fyv)WO&_9i#1?#nER89k5{o6e4=JGPYsE)U-W3I%=2c?W7rdcG{l9TgLL>
zI3xELr;26h&h{kKTC7s+nWK~YrYB~=ig$(p&OzHP&dluCwynLjng7|m8Sa}KHjI?!
zb|i37NO68cf5*nL(#Dw*LdOugvpajZ!_H^zBwX<}Y{1dw(%kG0%-GZWuHUQY=V@RL
zkKty$(c+G=>GDW%iAYa@E{5Wm#AUxTm!Rm|#yVOyw4)PFPnM>q5PC@rW&k27jpOJn
zF7asD9GffQqTym}bF6XS-1x+3Y)fZLQ>=gk>6gS%BEvJ2s)RmF(|46T
z;v*oJA*xu??9P&RbK*Mq^I
z=+CF~d&!tLQUs+-yf-~HGBJmi!jX|6`*0_vS+N-CzcMW{c1L0oHmaTJJQ;h`EfPCA
z+goEBk}4-HTju9IkloQb&jDoE!cs1q%B8ctb}|P?7*rgjb!P{$y?|pP1BD$V$HoP8
zxgMNDAOr>p1W{%5(`gda2va0*@*O=KqsHWzy$`m%nPO$@94U{*s;d8bP*vZb&UphY
zVZxybI4m9l{f``$a0NcXc)C$R{zWSAH5K@p3Vbc&@73(0wgSJ1@w8VV{}xr?>nh;I
zOdr+cc+k+y-;xUak_!CN3jERv{IUxCGI6g_o-eR&_rMYHoBw%@f@v{_b)C4;gQqp!
z^9+2b0uQ5@`dbUVDlDM4tG_;chsAOY3W>+GtNtV&)2#ZN#dlb&)S!@X)PZA+Pm2Sd
z^ilf1aJ55%m6Ih*I3(`%;KPVvsRtIJu=ua6%OA$7-^546qXxdF0$(G(X5ecp@U`Mo
z27XZmevx>;fv>B;*NHb9_{A0Y#o|T-zoY`cM9drbr4{(4Vy}T;R)Jq8x;%JGtP+g|
zyjmg%Y$44rImjAHzHrvZn=^3ZnhN9N(27FLlXTYBl7Z~uB)}v(Zb@*$ocN_3F>!1NIv6>AyWc@Os
zxnb`L{a$>?fUmJ|Xu|nh89KviHQ-U}Kf4?>_}5tv8t^Xb`38K{>N4O1cx2Jb|FrmW
z+za=MzcJv)Mc#nt@aCzPepY|C1TouUm?~T@J-^_4ln=r#oG<|W^t_ne@UEaz_*C+(4#2oZ)NCB
z;uZsbv$)!T?-a`o_+jytOEovu|2xIY4ft-6G~oA%KVj9Z|5k?X5f2*hed4eI-!Iw>
z_~YW~ZJL|n+b=$0z>kR+8t{7SQUl(HYe~HPYpgG9^}++zjRxFcWeoTiVwC~!uztM7
z%fH-uuK_pu!7Obw$-^x(jdUCS^B7Y_E83W#A-D<$yR?&c;B{muGkoZHV
zSKgrbf&pJG-ekZRT0;i>C(&fU&$WKn;gy%S{?UN1v)*RF9oDP?N39+MJ}AyG;7^I4
z!yFuJ-z@HOk1OArSX235HAp`!dczB~%-b=(A4EPn|Sq6NQxX^&VFMhSb
z%YU=D-+;d)USze7C4I;P;7tyx1%6
z9`Qy4zE9W&e7|Tk;E#*nt@rZp7yoF$kBPS$@OrCg!285j172e-G2j8~Uz@!08?3)K
z;9rR68SoD43IjgH`eUP)|2N{Z27J(ZnE_8*{RVu6wZed>#WyeV%G+q&X22=y8Ux-d
z)*A3`@tq63`~~p_1I~&)27H0F+<^aEeB%Ny{|(kH2As35F<{$TXTa^&j2E5q1!hrF1v;qH4d~uyu-X7~F13ukK8Ssd;
z*nrQqzILvcf2Z|&1D>~b8t{JW3Hk%H#DM=slnwZcVv_;CUi|D#FaI0G-3EMzC>rqJiggD374gF}y!`JFcNp-y#BKwA
zuZSA(2gKJ-_ws*8+-Sfb72O8>pjcwSW8xcYz5I`gHyCh}l`-I9ajF5IYJKlCFMq%F
zRs%lU8ZqFXi;E0+yLD`hmw%b{w+8%cF=D{iTX^fz`CA#9vVMB117iNY+`7wvr^J{6
zZ?M)IaMF5WwU_@I@eTvtC2RxEi!%&3Bfh`N%YVN0Y6JeG=r`c!Sf?29)z&wnUjA#X
zHyCi6wcCK}tuqaHT>N0Am;WJgrvdj`*BEfbYB1m})+6;^{yOUp1IG1S2K-xbmH`i0
zKUm@AUu)fB!27I01CCj14S3M{m*rmmBi3yOJZ9}N;HSiy27HxxMS>)w^
zySUka?-ExU@OyBLub2M);=x)ke6N@>;E#xA1AajKqQ*;K6dyF;AB(a9H(E^we4Y4t
z#LK_hdcOhpS4E<8vceS*){RnUr_W$2yC43*l
z5%CiPt`Xl*@V$($6`xV?ZiW|$dlXF5Kr~b*-l||4mZES=xXFN*h-Vw{QgN*TFB8YW
zr~jfTi+|Ptz6pM)0)AHod|L(l+6wq^1$?jq-ctehSHPE5z#A%H&veA;^;Cyghx8l!
zE7-rG?zQATOVrc%hb+-S-ygKZPW62qecx+|>(zIOzCU4!o9X-GmUt_De-w68`u>>3
zx2G>bBl$SNAI5$VeLrA{uhaK~miR7xf5Z}%@wQPo;@wW)h_73H_t7`v4xn8~Hmx-^kxAeItL*
zrf=l$74(h#ad{(uw-b!~y`8?1zxU8L@<+o~Xj+JWp>K4CN7VPf(KmEVx)+|p>(%!T
zg*W(+Nan*g^FbG8KETX}Z|1`{r8g9VYmkz|@VN@s_)8Rgp`yQ3!Ho(=Wi$VJ1w%N)
z%?d_iXLzH6FIRAjg0E088V|=GS1=ke!(9sAtl)%#x59Cg(p?tfC-glk#1r(LsR&29
zIUL`=Abb{OP2~r8x%!UM_Z~PE()S19g{HpgJ&Mp>74nd8mWOYahp~|50cLslW_j0~
zpgfct%fmOz%PD#Puf1;pucA8Fo*R)>himmbTi17A-x+Q%;LVPD?Fqu|`FuN?TfK%klj0
zx8_@WCMz@J+T;KHx96Wnd^0oe_pNtbXVy1sW@BIY0}6jDHT|L7g+HM1*MRYY@`3$x
z8EGBmq?@sRk`Vc=VWi*Qn2=x8oA3t|{u;R*VLyZT!0Cjy7{(QZ7(8e5zVM6VQ|2^a>i``Gg_G4(&tO0fij~H(`f;VFwg;s}wu5BVh*=cFk;uePIU_
zc45U1?M>JLgQ%at<<|0el*1_2Ncp|%J1j69Rp|aeirv5K*Uv4`;<#xF7M
zV|;<}HO8r_roWkt#f)`~?TmLbeu?o}#^)JdW;AerO67DBqb&E=s2*0N7;h3{u$RYw
zNBhfD%=*G0@ORpWy%@KEGr9c4c!2#IcwdZz*oUd$i}4Wq8+rc`MqJv&`R5t`$an^q
z=XA!8Fy6pe!?=R6lacOcN#7{rrx_n-{3+v6M!G*Hema-;OvdGmvYwve{S%CM#YosS
zG2YJj3C6E-`M$t-lJTEVu$10D#c!7Od15U?p=HqL5pXTv&{2|7#Gwx&jE#o_k=bvZtXERna
zE@#}q_%!1o#$Pd>f4*sd5#wCOO2);Es~B%*ypM4k<8Hp3P>$j{3oPXH
zDi}Y`c!+Th_m2&X|G|i+pxKg0Mq
zj3LHB#&0k_!}v=^yi+66y_T_qaUJ6Wj6Y+1g)xWwZ5iWA#)lYpG5!~0A@|!V#tn?$
zW&8ua;{&WT7jf{I3Cv(4${cQ{Hf01$K
z2h4K%2;;XHf5>GuWtjY17yqocJjNf8B%J>fB
z3=5Uy*%E&%s6wJdA@`(%6J>&9~e`4JeBtsckwv3k8yy<
ztzR)-#^Vw_m!bUM$M_WE{X8z!^7wNDk1tik0+UoH!|MB
zcpKvwTX3?BMa_amLL&UVM)+{ljK{vKcoqeuwcGV>6Eff4kh|UwMUzw=zD+
z_+7>q82`kW!Q(|fV>9D0BRxN-ay`KKCZil*X7hLwWNc&n1mh0Ie`kD$v0|3#x1I4W
z#vP0=GQPuj!EBQ+$CY~C?_<1=v6lPWRPHCo2}e?l6NCsdiMR#wBjY8dbf5Mh-ty!7
zwL2LfV*DQCD~xi!dlBEqX8a=K(~K`N9%r1y`s6$?m-prTuS?PYd(wxS*gp{B=JxyS=g)*FCz;Q;
z==>ci#vcibto#W3QMSJ>#kf!LFYR&QWGR*s*Rmx4|cQfa=Bqb3)2(Uj$6MmW*WjtpK@9$&$6{Cz3
zOyP87`&i2R-HdlLKEk+%@n?+V%Kct0Cp6l0PUjNFEJjEdI%Rv7{SHk=9Dj)MJB%+g
z{+023PWLLtg^W_S)Fb-aeca#5ly-1G>kL{tXR`l%#yZA6#xFDOWqgrQ#=&Gcewg*p
zb3m%sdPW&f+0OglVU+QdG2XvqvT2viSjl(`<66eej9+1t`4;^Wl`i^axz*0EWW6%J
z)WG{4jGtnBic!Xs)NxOyBiiEw+#V~e@_m`c161m3gy_^M>~AikELSm(*~Sy$Zv*?o
zARyb%Wo(C`QIuy5qwHtfc>f!WKW6+5<6jtMeDX>z=Z`Y>Gj3v(@yWxyf1FXqB{R6Z
z=P+K+xR^1_NY9n2{_kddi1BNTdl`Sic${%u`F?`Sl1^_G(JCz5mg}SaXDi@<7URk
z8ILhe<8qkGSi$%SMmb*p3-AA&ahx7hlDK}(PcfgTpnajrg^opxeT=wtisO$m?qU2Z
zI7jCW7rd@(-FD9h;>jbrOm4AC!e5tGMXrsJRCajwcb{&6}!m|}c_5S>Mg$DiT*
zrq5gVPhxz0ke?SU;p-II^M|NBfg+uMvG^y+-_jK06d^jL)Nu#x4{%)bD(kpNx0|m6
zxVTCFY2x34L@1pM>-f8Le02)Ff@)04OffK}6!k6J@!h=t14emYDX+&fx&G+uk~Hpp
zj8Ud5u16gy#$PBMWKtd%I=fgW2745lF=;ox62s|?P=Q#+Mk!@ju6W3?ei5{B^9ef$__%|0zb%Z|=oMe^_rd>%X5-
zTvwoL2J6gYTug|1lFwbFjyFknZ;B!ApRTa#={OxnVT*BZaf(qv`d}~Z#CZ%B;yf-=
z;<|CabzZdho4LJz(DM5-`Q6I>s5-@1Lw?czKh5|Y@cDBryO${)bWTyOXe`p7IR1G)j*GK6
z{-ova6|!5!&xbFx>_j>-P6rpIasGPPA1-pDU7$Rtq`(hQ+&2RS|2``n;V;boF0%ZI
z{*Fo(;{hfwGMzg~7cP2t6V9=YzfSuNDdzM1Gpys{dWuPexPG0PV#xc|mq{1e<)0aa
z{~=4)9prC_$IH2vKXDv4FL%-T+17DUUbwjtIxc|IdH7nyyu@c+2aI_Gar)Q?uv7kp
zZ{N%l-+Kwg23yyJd)vUWjQm-XxMV#FrF99sRL+oR@HGYk%9&ypI09
z!Pq?fXnHSwMm5ya8tYtC74L2f!zR+i0DetIVYes`QshDtk2`f?*{8w-Q2pjs2mL^49KfEZP=YO&;uO@B;usN?wpogd(~9HMx=6Wg|V&iN2w{6(0Z+{Nh2u
zU*5WUO;dAadvRILM1Fr?Yae|zrw8B733Z`%g=H`xEY}U@b+xaLjx4XtpJ>_LwoY)H
zh6Fdfq9PiuX)mu^9hu0D4aA501bcaCF}|D|YVQs#p5N0o6keSjii`5J)fPUfIxNUp
z!@_k=LuYYlxH7bCz@e&S)lywmnNrFkP3woca^ulFhr*9{^|tj3?@O}i8@{3DzUb=w
ziu&sIXe3lf>Di0Ew=dpjvX?KSQ=xEqSJj%%g6jM(hjtJNuQ7F-I`I9ds;Zjeip6C`
z6N@AqjRd#)(7UUIjKVb|;lhFJzO~JH6J7W9v_%Cu
zSSHBLm8~_ahbz|=6&6e+OKx7SD2-)-;+Brw?ySL){E0eR!#&|Okv8FbxJp#y(2~K5
zV06V`HGZcsHlZTd4aD1e1$|lF5~}y5MLm^~>LpdHv!kKKDqVaeNw90pKAP1KEN|-=
zsP1nHPZU1T)*I_I>n6BDXpdzz$4VP3R+JVLPSh^yeL#56YNIbNV_X?&87VCrSsaK?
zq^})p8#FW8G$fqowdD77Hx=Y(1swW9JUq}XT=(@-rb3<3Ku4@ACmyP73$3R*u(v7t
zI;fe;CZVIeA>P_i*R{5AMP8^!C71IDo`gZLmOdmMTHH6kY@~8^>qu2WNQ_Q)@A8vR
z!XUC%XdfO37RMVKs~T&gp;k48-q>JhxF6p@!`GQiS!U~P?-*KF+1S|?ZFCqmD3#uD
zq~Gk+!HCF6{%}0nQ4{OyS)3ngSChf_w))#5_*_{OpE1X0*t+QZ_hy0v<~Y??S|4c$
zU+420q{)EE{bq6$Jy<>By9sJ^dv
zFn6MVSYudZ;rCFF2i*I~~nhL|^>zDUcwG=vZHPJH#yS_s7htAp+#Z~2j=8BSV
zs9$a1(9~s?SXH&i!SeV>IMh{M6GhceC^7M43(&E=RdAQ&<}Gh7?aT`2IE*F(@!ni~
zG7g{I!nfV=@oks|7gH648d~~0oAQ>0!b6T%3u)Fq&})uIS*4NN<-}SY}&Z+ZF5|iVl`6$_r0y%QmyHnOK$CT|z60RutFv^eyRX3x(B&
zV_C`JwQ6uVeju2Wz|m~AV+!Bn*(^o`lX%CHPyYHF^7I^
zS#^d7I)zznt7zLxgS{gi**Q5aec28*WtD#ax|mrW4Z>`sD^gonTiehw*gmnV_I3@J
z#SmG$j51W-7+%`2xGJl=zCBb!b?#i|!^2TCN6YzIP|;o9A6?zIKF70$t)`mQEC#7?
ze$MjVvZl)1NLHwWQgcoY1E2R%%m&r8LbSuuqOv79LnW)@YYMy?6ut#+cC7k=d{UX$+}yCZ
zzc8z9ZEI)^WzAV-f1E2IO5g1dHD*<>t7r`L4Ytk?b$eJvOso1KVbxkQG!(86mNs;^
zdbQrzuz9hnDi+1Dx+WCNkK|UaM#jWA;jFMrR(5?02?`a~3@+;`>?w+LdyWEKIi|#c
z<)Rd;yZft$YuidA*{z|7d&Y3hGD|ViE6kSE<`30I8X77J!xOKNR+Y8)$j*{iA?%jM
zs(Tt+D`JJc4nwA8*ESM2>$<*LwEy)3xxt$1tR+M9^Fv~MbS{!;Z&)nbi
ztnaEXEUhRl@@gT`){frDpfD^d5;c%N99&dbA1>;wceqWoR7U#EqU<)WQgxkc%i=xt
zf&6lZ`&`RP-rf~;)BRnjx_5Q`l4Z-Ai&^V3_INWVEQP2
zwE=@>k$DFmT-_b(2&`FAUg=b!;w}$gs^@Eo$VKm3G5$4n_hqkXSX@+5=5R|8>FaL`
zp{WUj%931IgmSuu7FE=(&Fjnwhsp}5soEw6(jYX@)ob42W|`NK);yO#;Yi+uBe@ffD1Me=@*Uz?Kh52T20BCd;B8#|on2u5
zZPawN1_DdlaI-uR4+PLEF%34LD%6NsR!MlEts&k&7>QHVVBF!vfrhrY_=O*6Co}v&
ztGNF%cS;rOs?vlVE32X}&bEgmZ8o#g-l#Ay?P&}5m-mD_jHUEx&AO88y0-qVSZ65;
zv71QZaOH%<6?IihLUmnhip$xlI3QBCZZEicWLPD@7uNvYXK36As^&Z?C3BrwscMdk
zE#_JF9!Q>ax}dYCd7WghGi94#Z{FdOxy~)FYR+*2GS>+dsOIJLP!0A+Rngeb^dCr069
zZdxbNe`MlvZcmBpOzxG${q?>?;$rSkN$X7hm89Qy&y^}nM@e^Fo4IMLGuc%0z_$xj
z1UmN%6U^lt)STFm8=aYrs~g)`tTWSb^@C=??O9{ypUD&to_aLWc^#ufkg5e
z4}#R>ttVF^`x=j~96ZpEs+et9=MkIYzvR?wj|>u=IFBa%}1vq(;ClCm6ZL=?`6Vbu>+;6v)VyPH?cy2
z>~)qXxY$R?UT5`+V(<3kmE7q(dY#~|CybRJWUcd9onW$y7qdK)2>Zx}C7x-D#LZspxn@L3+;7B4rfoe%AOSj$5flN5
z+ZdfiEQ;;>4LFHKQKVaERg{vp`mmqe=sfLrabs4#&f*MqKnv~sM$9Z*Gub4eJ
zT=cU6(OL5^R_NBP+75Gwp_=tKbE_{W&6d%6g
zU5XE1!7kN@uSl2T#8;S0@!==NrMmDF;8K0~i*Bi2e1x_X7rx?J6MQ5e)KXpeiD;=l
ze1x+U7m1s|Bw|_PU6>cwBm!A%?kkEVZGD8W5~e=lSJGCjNu~SEB!XAc)>q_88v6-b
znYMmnR;H!DfR(U)|IsSp#$TvPnEH!TnWl-w%2d-jtCj5&1KZkaGS^vLt(yA^PYLP1
zVpGEMeFdgW55A&Orm3HhlxgWF9wjV&1*1$$dOw5eHi?xc!q86`N*MZ$L5(v`HUK4z
z|0hMC*q5KslQ4Z>aVNV6UqL6k1D_G6aW2f(lSH`5w3Zk9Ed5xMF!UQ}62`uxOr|xx
zCMCLx{-P#f=r_J3jQs?cgyH*)ERFMF=36JMBxd*e?}u?P0OOBN@JI%XK-XDYCFo)e
ztWJn1sTZdvMuMP8XO*LAC`9SRen1yoop4XGYo+BP>Cpdwiv#a3i`RM+3&%tMYv1DV
z^X
z?u9=Qkbsp=JR*@XG2rWjAn*=nGVl5)`N}7j&%fszB-YxPB;RobJ*jU4fG?s3bmiCi
z3PLik?I-#6wnI1os&qb6klc&hJn4sTo%au{#V9b)ndaN3_9S0p?Mc$Fb0_uk|M)pO
zB|C6Y{d8vsNN8d4+GC
zmvNH$LX0{^MG`t|AEcSMQ0h!dIVMT3FZx~UVA+~;VV&u!Jy|(*rTBr)+;xJjnXJx4
zcATl7wGJY$6KA+2U1y4GPhU=V$yR5+tJs>E)|vc{GxWFC!OXTYD<|!AU=UWxk=*9AJvPGwGOHaKWiNnAAZ(4s4jf0bx>XSSnHs;@UzxIap7yN
zgX+V_S_j32ueA<}4_|8?6d%6UI;cK;t#weG_*(0r`0%sVL3QD0t%K^r-&zONi;uMq
ziVI(B9VYlleyxM*!p~X<)rWlip%YFRe`%9T@%*fH7_Y*-xatHN#w+l()`62w4F5^I
zlAkd3vDQJ_`dRBBZGEkEkj8%2I+(V8);gG${?mUqeh($a$)``j33s)K^yVgOZ>=vw{TGoly*oAQ9MzpQC`1X+J
z*D&p-9-RO9dMnsF}7D`paF9ZYL^u}@;HgD_0QfvDVc0zvk2
zvw}iotrHa*XYFIHgV3A^7g4G@@gjSwe%3mORAofS{7jNrO*)Yzd*afEX`Mt^DT$9j
z9UT-H#D?{K{*E4#q`Yh8&)G9k`f;=@pdxz_i~
zCY&sgF7b8i2`BUCdsyb@c%013_c)nbcs8xj5law5F$tJxP43KTzmU
zOXisZ2VZ=~p%l$C`3}Wsp2>44M?T|Fkmi|OhmthUa{^qB3*05WAH%fh7%f#ihYOu%x&suryd-6sTJoY$yr@i%Y78
zavY@R{GTa(oa%Y=R#p}-Eo&}b8eEyUK_B;3%D_<8xGz(}!ZNYh1fuwsWw<9Aj)#pv
z)Ck0l;$HmFMz}59+GV6%k3UmOF(qvqxwbZMUVCibK+KquIABaYJFWJNNoP(yKP6+*
zMJdx$E>5{LWk$;7DS?zp`1Mp{a_W?+Y3XO2dDb+eG-qDceB%T7A@>hYoiq*SQYIPG
zjSr_@j6bpN%}7bZA0J4Wbf$R8*#n>ZBK*<|bct>4$JqnM0kI>2A%}PF6@VhxthjbSy
zyglIIC%Y3H+>33#!aJn!WIkpqJo^12yFbahK;hBvfjRO1dhYo0qu)Vt;;n>ADrdRT
z?peG;4evj#`x-*mDDzZXWwB-G#x!}+Gc^5yr<0EsbZs5p0ZraQ{C>5LzulU=In$i|sqJMucqbg{
zL*;Eg8~$t!L;k7q4DE+E4mWc+)j`b2WJjU3kA$>Z1|7&A0~3ErtJ>4U~V=
zp`%wC#vDFJAkV41^jUhmEKOdECT}BnS7_*a6g>Qw*xd5*oF?yWP2L44D4le#2QMq3
z&MN1BMZMutkl1>_!=>N20~zQ8QWes_CuIHd4PhL-OdOY+%{}p7n@;eINVF!O|`8`phr|%?qC#5)`)c2&K?^vlhPEvdRk%zw1;O)0H
zEa^|xw{M$aJnWFJT7FUdrse@#$CCcg%uTJ_ma-mq9$z*p`Dg@>t_zfp6#R25=T7i4
z9rUUB*aY4}2cDXb{oqZL;=z}Hs`)sy(|H`KSMqThJlS68H;di!G3{%HvB^Q7nvbpE
z*{Us}PtC_M@Q`$3llcfJ`nG=ED(8b>yXkujy!5jY?h@&$`gT2O7gzTx2SPnbv8nwv4Y*DB{{!FS8YR`4>WS`KBosQGvdoqMB2bIr#b3{s=l
zT14sZ8AabtbY9sGUIyJw-yZOKY9}WgN`I=pIVGu%_t|PW9|iC9)d_creB7hxJJOq)
z&^P9x?>KmL4UwChzD8uHSq^1>Reh&k)YI4at5jpNL;Ze3(RcLMmcHM6=sN-4NsazHHm0X<;VY@e
zbO(LIioTZDEPZcz=<5V8Z{~ZK-}dw=TJ?JhyuGp#;8y;*P|^3qnNt$|_k@SO{orLz
ze{X%qF4xmncEuFqltcNQspwlU%hE@`rR~-~YQWoyxxCzDers?*{LN_{E!ESvplpiq
zuyi7Q0AIkh%zphi614RF3FqDP9S85AH9RNkL)EvZN>AVPYLp++lbe+K4~o9?7Fqgm
ziE!1I3EpvydBwCwJ$;?vIqBL^!?dGUktpA>tt@N_N2;7j)FHL3k`1N
zpV^AOmIo|-?|A6z1TPbF0l7(ks=iJ8_4JK__k=_L_#5K6_V%~^Czd`cZ@2ch6TFj|
zQk|7wRo}zM_4J(v&#C|JQ}msD+tT+}4}Ga8rWh?6{deWrQ?3iNo-%;=mQsMIErf=6Lr|Qk4J~h?YBAvje
z{PPY)-J@jn@?-)&#d2?%j8(-AZcLcmm
z(g}RZKl>GZ(Ib|=H^Fo3A93(Hr%82|Kec|39MjWR^g1Rp4&`^fqOa(O(ER>C@7TGKYS&61Jia
z`P|BL(j4QWhcQOj`$yfmmcIY?(6B`dx5wnz2WULb~$L+465r>(nJ_MoeZxo&#=B^3i#zm5(WK
z=9Z5Q;FUS}Q}eMGJg4@ewu9)5G-HkwZ_}sdWAlg7#9Ansv@{7S`Pd5{4MP-vej4bO
zkAvW4p)bfy`cv~^%t|wMNfJ=<)O_p$FLBbwL$!}<&%0(@`hE+Zo4&o^Ii;)Wi_J+h
zR>6fu|FfKMtN#`Nb7|Cvz=*Kljj=num6;QGRo;*VDHV
zysZx7%T0>Dj2kU|FL>w+fVT?g<>pp?qu^Ca5>WEg`aJ;NX$RgpioX3fS^EAHe7E*@
z7`#pge`@<%xKM8#8UwFRinrzC*SMzG`$t}hrSB;ZeP!TH)0l77H9Plnwfu~hG$YmF
z`nF5amwL0M?`IzRGQc~g(f&?H(~O1iBR5$@s=ftn7@r;5-<^uSScj!=5}di!??&(t
zl1OYaUA2B=y=ji?7*&0Hz&k~W@h1HttTnEFclTTRehIFdzJ1`8XO1s6nz6v4U#k7%ysggtW483oKGGjdGwyZpw_3@^wl7%u
z_#u3_w}TKV`X{JG_$
z47}YqFE=Sc&BrP5oUU7HK34rB#(U`mPUW9!KB5n&8JRLs8}EE2AEV&OapMqpZu!^>
zo>Td$`8fQDUOpE7Q<`zyLErB%cealkb04+zO+{wi^eq5yn}a`9-y!g}JMh$Uj_tsG
z9kj?zmh*QNeIsAC+QBm*yXo5u-U8_iDE+DW_JgO>4zeE8n;*4&#rZn(DJ37ABVxy$;U!WoSoXiN=4t?$1Q#T;h}EsC9M?9omSfv0o*I1XN&L%OQI1>ZrK^n?7L~ks3ZX;Pu17+y)1bQHXO4*nVxeU*Q<^!?gHUkiAdQWSXdPgUQ@U-a7P0q~sei?2}hZG6Yl
z_Y)6&Tfmzp3(rH}cJLY=g1%R`(5~l
zN1}=C$Ytrq2=*u+G+Yvo@@VP?_3*C^*8Nu%O91S%m*zgvX@H+cyyl9
zrS{>*3)pxc@ZjaycpvoOmDzY19=t{ykHU{``l2=-USV|Q#cjNcJb0rv-gFP%RvYhP
z58e(N?-CE*ZW|A;Cc5ThpN)rZlHjTBTYmT1cpvfL
z9kB6eTy^tz$i~a|;2p8?a%?i^6?^bfXIbr~
z#Dh1@#w+#UW!QLS9=sVgUeJRVu<^=0cyn#M3L8%yukyf?<65l;ug1o!_uxgrqxHKq
zZZvuDj?A{wUGBj<2_Aj>gZ$lWc-wHpMEQt$@M?0>jX9G|9>qCiKUe+5^R4@^
z5f9!Ncrw2mJb0&Vyp0~bjDmDAU!{DEdhm9DHwWj5x53Te+NBy`);uEama&r8a!EVhdp?kZ$v-h
zbdPxOcHd;>ii!5afF6Xz+v$80=x{7YSEjpMJ|crEzbejhOnygBUe_cosD
zFVE&rzUP$=zUprQc(UI9X!ED?8f`qeZrI6RkBukaUvT1$+Ia7Jq`MuwRX9)OHwphz
z@wbz|(>8zdd6^S0qu46HGd=t*0FU}NrAwbHb4&L)cv;N*fCq0zi8Wqb=)v0oo~(~c
zJa~J+%j9%F?7=%?<6Z8-J8esMmIp7RG~L+9>0WK)sqJqocvSvWe%IJ|YP;GFUMBNC
zV&kd)_SpPo*?6kIec;LR%d_!Re@ATo@@+iT-`bKU3C
zQ5#RyH)hkf(#BKu9k->s%7d30wCXMD!JA>@b$amfY&=>=<;K}^b`WDGk^Sc2&
z*pXb7ZM@rTJc?ya#y`0o0B`g>xo5?6DQ0Nr)h$am_AQ;r
VgKOf&)J)=B#?9;Cy7~(N4v?BFCJ#CX>s%TaP?3luXc{aQMWQ+`x%P9C2c9
zpf^9#mpQRG+?UVw9I@GX?deNiu6FR>D?8ujOxqtQu|g)3On0PC%xujJ47-~OgCj%5
zBYK@1KYRJDHH3N7&UZQ$2bh?Ws;mmSU;eznet1u0>dRzJnVdbTn;RH5>;7S9gHv%x
zkd)!UfoyIQ>U>Gcx^3ryPQ?P$No`1_qlpuXV@3J{lpPY~B8k$KiY8&k{-(xk^XMp0
zz93P;I}dOw=7UPOBN;uhcd(Fgd;6P#aiz52CwCs~RP5)$hz}Hp3&6TsVqLWJAg5xX
z2P-x*&}$;SW#?O+ibWozX1AE@?=#VI@NNZpmy11C9M1H+ru64X=^HKSy9@npfA{ca
z(7H;>H4*(L-VO`70rJ78o)PVEJ+XG;x_
z+WB^;Vj1va>)PTi)FreZ-R?dz?^h)5uO{N|0CK$ri`?Bi4|ggKEW^65XH$Rg2)JJ)
zxqmuH(!Ty~;9eqe@7ehdr($^-(wWiW9FQ-T$nR5K*vACfe0Px?u1G%>M0(RuZV{$Pt3iZw+xnss@9}FTroa+bfH4^ulAYYFZy9*RHua?+9
z4AO8LcZot?DSL6hGhGbgl*zf9of~&85zu{Hmy$jV
zZtmJ>G8OM=ck;Uyp%7`JGnW^JRZ)dWt*xVdHT`ie+%;EFt0iKgmbmlnUHb~qECF&m
zyOL37)~>|@K2O5ik@=*%lI_l2yB3PF*|IF%n(SETd}r5wqF|2erqU4-HWCfDrJRgG
z&PBT7hL1j4U^w@(GE!q6tEIGXUFRda<_U^*u1m_dr<|5u3jibhde`k8%8wN3k28a5
zLf~02VD2NC!K^zpTySpKHOE=R(5DmB9dNuj
z`gq!nh2m}G=XULX3%-vBp6UvRqp6fLZP$Uq_={ZT$WVJK4w9inXIs=whT0>}HtjR|
z?IuF&ofCHL@626Z4FTr6Zg-};C+8+w+;CTtm0qA*s{#EA^x}1@yN3s}&QaFyoYQ3e
z&O0k$7>-{9{CwWI1Lov_>Bz!|2m733J&>$(42;EbY8g(x&$-`&ly{mvNF#aYe>@!P$cD&Ee?Y1ee5L
z(}wBo&gTbvodK<07D3TDPGj_Qj6N-QA;UqhpfPg#bA|?sxly-21LWMM0q410`-na?
z!*w@j5Y`LB&U;}Yj*jk5K(bKLS?vXH1&ux@s}0=UgRul&QH=nG9nB3p35dkwM=d%-
zWHrLf;I0M{5#H{)ZK3wnU7^)cw=LejhW-t=0uoKRv99)T8iChMZ|ICV-CB1>_E62)
zjS`*sDBmAhiHlUN&|MgFw;~B7@`(Oe|A2u4u?9x^dol%Q
zpIwKG(DT+rXP3J!8S3mre&@#9!);xWXvB>rI}&cFGw#OXZBYzPD#Zc@3Zqe4*K=Eu
zVi_Jq0*Oo<3FIvrpCwn3XiTJJ{W{npP3p^Kvq*E^1t5=&h`_!1?tx8+jz_^kJThZq*>lF)B>ECjf)
z&#o)I-1&qV*deF*oi7>?be2RoQT6~IxQQqs%3Th1cR1&%z=TjsU@{>Yn
z^&VY|ETGf^uSI%ltcwJ*C;iF#aFwbbVni{W)=GVOHk(|9S>6RjZxNj-=jP9I!t-E>eEVqsQreny^h)!*~mx|
zI1G5r7(ls&rUPx28+QJVagal50YRGxJNH;1xG0PjArlL(31b?kKxAy9b%mCKK#W+y
zhB0cxHjI%Q)G$;fyN5Bwrrd|+3`CCupVtd;D%T2kw8voRR_9bL6q2hAl!a~3U4rth
zL{no7JBcVbgZY9j!3gjQx4B_-bkzAT)-%UL^A-v~lHn#PMa2k)Zq1DjL?<
zkSxYKTir-9j%7ity(k@8QNA|R))jSLM>5S7TR^~6I+RRzb-L+zBHGcFcD`ZOiHka~
z?s})FbFk85{d$9;ScF8&f%D%vQS4M#OM`Rd9$+`35xreV@|Ivpl40kEyABn&%L8$p
z?`fTp!6%yCWOS|bwCOua#ygYIRJ1+qd{T#6*KJ>m-qo3mcepL_bPBQI0KsxU*Ik<#
z=o>7!sj*@@*LxD*i*{Z#$;J$_r|X#Dx>Nv{M$jB)IjasL7gxuVCk!|r*tOhQ>KugM
zyQeK^9~?+v0h^ZQ<4Bhn!daNgsu_ipPs+mj)Y>o>a5%wd(WGR-K9Nk%$fm>~mi?hS<9D=KuMp!O
zKrfK>W(hO#l2!yaSu$hYIxNdDN{_)t5?t50Ho~DROrg_Qd!$BG%o`zupUP;P9_|;f)-AofqE3;n#ZM
z%^dzU%eaY9gPR)0{I_4QpHZe*NKsd&SO`;FrdY@{y-cwXt)@)zkzDfXGQ~&nVw!+S
z^VfwU!puptO@u@34Q_h9#5bBPD@m>wMtIP4vM3S;_(e%kDjekme_^sBj~?v`$!8+4
zO3~&cGB&s^$u$%rkLESsSyIj;XoHaFy}J%l^%t@F>EvoRjHx^Q5RzSQvS&!LsqJI7
zev}Ajz2*T6C;h_%7S8#*Nj}~fZg8Wb+r7QCB+2!9m#3sr)j6!RMASLlWS{Dc3+*ha
z02Vs@-HZiYDU3Y=KV4EFYNSdEgx*QSVd)VcmWwmK0>Y
zc^&E1ZY*U4g;UG`3)`=fu5S?XyyEfwDp&Ykh}Gor{VLb=y>QM~O>;6X()TmVbeff1
z_)62-u~b6znrBULDuUsNsrr-&1{=}5Up2w-jgb6RGXizNHA2{{y>LP1Dzj^W`cZBq
zB;>ira1}j-Cnus@8$ztIcZ?KZZLOXA;lEp$vT3VH@qAr>iL&4Fe
ziUif82c>Yb!Yss`MirbF;Yzbx83^%q
zUOwI1Ye7Ie<787-QJYz4h1n1z;Y6HMv!YWtxuKJTcbPtDrGy~aE>e%H&Gtd*86*F0
zWR86KYX<#x(_=#!=gUxqXV_RUrW1lJr)+gsN86E}hn@3wy+xES=ILfQk&36}ZavST
z8`;h(O+T=vO)063gUlJr5-O4RL2+(_z+4I(A%GO=DCVBdD4Xg~K1o~Xh>OVtCTp_=
zW(`gbq!L*6QAR3WdG_hrm>BQb_Kr?xp$S+Qi#y9~Kom0`L(~+q^nFc0Jk{bHVge!nyu$({
zTG-Ao*97WProWKQ>PUVZt7z|VqluPigcjS$7Bs7?VtdtClLj`n!X5miHQ89HR_8LpVrK-N(pZM{$&REmS5Jvuw`EOdnr)kK;iiKf<`jS!&S;Ayqw8C+
zbM1w-np1A#HOEFvX+vGieAEmcZ6Fm&v;9;h
zE@DI)$3YAo!)+U#C1%4By@B>l(EzH@Yq@P_yDoM`(LmbM$&NPXM8uJLX5m*Wu$zdD
z8qA)C3xj#*FJ={NKBy|4=!x7Z|EQ?Nc~FM^Ek)-a9y(8>cW~C|9mG1`nMyiQL<`RM
zpB30D0AB|Ff)_bN$O(mfawSJ*;Duh~Q9@p*kWUfF>k0fiq~>CP0*TR?>cm#-!9t2p
zRU$$_iq67dZ>CsG4R`mR)H#SXWNZ};n^nmYRP{6HZrlo=shl%BIMk7)s;nN$B-zgd
zkS&;GNumVEo{MP2?Q%xtLMBn7J2zm7^HZ}Pi9_|yP~v<}h@a!f!@X&6!x--bu84?hSe(=?dNa?uk@8l9Q;AEVsm?Dw#&?FWHw#x
zM`*d+a2Hq3U?yNS`V_T`OQ>CnDqIL0(qKY#rou_55_u#SV0$Hc9R$F(bZ-Ht%M5hJ
zoT2YlVfOOM8jktAqHwuIVWwV}V`Cj3aZ~X`1W_h$2C`Hr5?SSZ-2|P$K;N)JU@L=l
zn`m7ObghZj#jCEhV7#hpR!w2JUgdn&1f9S@pEql!S{dwpCR!H*oo=Fa@v28!FkbaI
z6Gob1u(Hm~k-UI?3~h=>ZA6_E2@K#0voa|Q*rl3u25^pvNGb!i&O~H716XANNofFQS))=YwVoaIQlrud1i8yJDl`UY)U4J;klRco
zXbVuk1!DEKn)NUUdf5@g!;U~UJA!!F5y-=iKwB*d;M7&lS8Q{IBB505N#5edH}60;=IrFI#q20;va2#U8#suwCe)2-dSv;wE^v8HX1;*(P^_y
zf$b3YQ@@6zVZ0aMfM49X)%@9kqaf09CKQs=jxs;pccMSkRm*Wm1g
zAhLeN2?&eE&$Uq5_!)LCFn?~u@NSg0W5XOjmmY*OWPhrx=)rjtS&Ej&z6qHPIDQ=vE6t8nBeyOB*
z-IC&NW&YQh`H%L+YjA#~#CyH6B8^TXPu-y!rW=Qu#U~*ANRtA4Elz_PKf}(a%%2<4
zhK$m7XN-O_@4QBKNvl%)+=fHI$~%-HbGv+U59~5mw4yVsY6g&8t#v+uKE)drK&ejZ
zo!6i*N>FvIGaN!9E?ec9Rc7lwQVIL{DhPY05*9zVAy%uyjbe_%<^3_q%T9({9Ry72
zxbA`HR#nIG5h27_z#$(xw`vA$BPG{HBP(!x$wUkT@n%dOSXCg_B{^P$6SMGAok^Ub
z@*&uWvw0RlAYSi>*o1k9i5O~0Vv`BM{G7U?3jp
z{5O$gb2ez5O2?B3(aOVYn~W`v+^SP&1|&>6lNFD+or6UrYbvw$7AKJ27ya!m{eE>-
zO}Miw9>L^W3Uf7F5Ju3r2hY9R<6x|Z@(hp5`q
zQlMH0)EP_Sgr^~L1c3LNfKVifPbP%(=fXJPMD0^R7Ld8HD(_q^+YKN_i=`8Kl0Qrx
zf<>;!(8-s;>Qdnr-Yphk4V(`>O9;k%;>PKtfCP3>qehKooXk+RG{IuPKC*;nsLM8panaQATETTr8sX3B9tXX?0?y9IHmudYb~u
zss1r~(AM>_s1&C!co>B*2VxM7i}cDM(V)idwkP5=>Zh>qMq;!FqY#xYn-8PHNUW7a
zJ{O2VG`?6C1ItBBkn;jDh{h%5Fw#%+>!YtdH8Kax!SI5>W1Sr?2#R6eMqI%!1V*G;#yb>Juy*<@?^VygXdyNk0>jn(pS
zdQEf#tN+&^1fuYg9cnBJw3f}NTsIyPQTmpxET=?%3AN*cC`RX`U=*TKuxM?3WaM&q|Z2t?sYAB47Ov@?P~jKV*H5QsvBEhdwJ
zD0H;5kK@Qq#|5Jhm8fS-AWhP1LT&NYJmRkoD5v`EwwOpl+?H5t3?W|-m>+~d6qb}C
zMB;1R71)^OmUtuxfhhdWR+D7tYUe6Q8t(~4Au26)%wklK;-a}Glv`gP2Z!j;rxfOh
z4r$su+9{~v!_!E#J;dDm`Ejv`)|c!K!V)-~yjsoHKP9Of$3r4YH~S&AbfqjxH;sox
zly>+bC89_Pv6L%ix@|lpqV!|i23$Lw+zPd|k;SpaMUB{#`}klHtxxPaL|A5`eiNY$lH6|WjgQ&_@u2R
zo$JR#B1+%!Lz1mZQu@|-NJQxtKP1_nB&EQvMMy;HPTK%9gHs^^|4UtFRWJ%s`F}nr
zQZYg0y}>9%CE|l3l@e51gHeb|haKQ)28yqmTDn$8*Ybw^d=LUrc*Rc97=>6zGAu&K
z1?7vW_I7)WW3?$IKn}>vd1OF2)j!r2kLJtx${Z6(3_^^+pMnsG0v%E1W5xoCUW@|b
zU^?8&>YrD>m}*~Q%g1U*)}_<TR=J0KSJ+MDeko0&nh2Ou8?ZJ-AAz25QYIB
zx-ThTOtr7{UoH`AM^)dfHm3F=wY2cfYAl(glg=Y*vj5HM8g!1fBsPN8hkmK>0O`UO
zb!MBXAp;WuTGpYnBdPYT1k?0)+dmG73Kz*}_b
zMiNVMOqTx&MjW9*OVA3>Ka7NVD?`59CPa0T1LToMy3Wtz<{%_}Vm?
zJC6O8hdek9&aXU>Mx^;RohEGY8jvv2(Tnw<3`m3Xdk;<{rpR`!Cg*XzFdk3id`sC=~H5RwUDn)&{LaI5x
zR4P!ARexNzl!p|B*!oi3@9ZLiHB}2_CdAteK9qEsTR38!cF8
zoM0a?VbS#rZv$->v*>+cOQXML(WRTeN@DPFrBn<`Dc~7
zU073tua!DiIJcW13R5d^xCvvEU^_$Jg0upcY{+TFg*9qeSmCTS2@uT&cJN6Os3DpS
zm~#8jY`}33ADRu=ypk!Vkh2lp+W-;GMrDS{
z!ly^kIGq-&G_wQBss6q?qANMk&Sdq0^2Jnp#HSf|c3`;}YqYGLe>Vt$DEz=rMNnWL
zo^u-Wf>DUdB0rz9fkpbm&ttqt69&<^$RjEngK&(4h9aiR<3R{S!B~(ZTk;W0{zJp(
zPMd;_Koowf*K>)29N+Z+5S8uYArYmkZB~3t#CT3aBh%(vK?p?Q7TfG%1a;-VB#E(x
zPvXiV`7cpP>RgXdXhh+EQT_Sl3aRE2J08eE7qzi~DV74Kje|pUYV~3e6H;Db7zw3A
zYjJip*}&{^{jn`ktnB?RZE;>Bcfvh$iA#lg9OwOssX|ViBzmmSL#G
zBeS199uiSH&p+jrNz{uqH7T6ROyY|?0~BVUV`NfR`=XgV?p7)4i#64uFcv)M4o9}A
z^5`@Jv%xvg#7uPp^Aw5s`6>gm5hn~~4i1_zIzo4z4Z#}6)fR*f0$wPoJ-VMktqDC!
zX4Ws()KXrx8ml+-H6TxLp>r%A>sWzIJ4%1y#k+T
zc<46Zb~!nJc(G=BJWW}qLtn`-8(nPL=tz9EBqJL{xA;`~VyeB-rccgyW5c*bC52DrSeG%@Ac(#PgJ|5~Ln9qFCx+h-
z#2^~C`(VU|Nr)j_noj-g!axk7ahV>ow50j?0KWIz#7Hy+ArOUQY-7b@n4zZ&xlQo_
zR{tO6i>Y>nPNq12)Q%3s=sQhT{d)oBRR1A1wC
zpuXnPY+bB%Fj0(yrv6Ao=?)$0ZKNKoHuMgT2(=y?AC0K}(N8X%bFt+5;dn?y>25!U
zM9G%x_v51xwLj|>53MDrH8MlJQMQ!o)|4sbIfGNSlekw3
zQo&QMM={aw8V`vm-D@LJWX9zS9kdF+gffN4~Z!K
z$d6%ZYcV!rr8{svjMb=!+Eb-|VOsLm^7pc(RM*F+tS)aY|0q+pflWUu%9Qff@>
zHlgC!KsbMr7Fo#0Q2(`1rG8Tr8rsvV9}kHrea%0GmKo~<)2mr}rSnrjSkCtywfpwK^r~cg68ob@
zrDO~C<8HSgAtb)^6&lY|ADCWCIBuu`Lxc$g8Uc4&K!(|f@KA!;hz!vLGR!8d2ADub
zvkAL%YSEOg*JC;2KXul?VC0N=GP+vs7|ahSC;Kh&DaTb9s{W#Ya;krTPMQ>de7YaP
zrUlP1?+HR63P01$g(#47*cKm7c*vP&I2eVf9B;E>RM?qcN#lti1fuYa4o^xBRF>xs
zPA^|fwa?ZumTIFx;kbda;*DiXsqW2sC4<#vZ2)TvtT!E6u8?ZJ%R`rH>LB&gvZYk_
zSGGc|H5($2l`p2+CwpkKCW>`(evsg@vZYk_8vT(j)0gV5=V!am@-L!V=lT?hb;>LJ
zi>TIhdXHD}qKkbfT@IBgqk65lFoNe_b5uR9+wXl#sLr2#N^sXDIKALoLUriUIWM0U
zR_8_E5~}kLAGuRWeyl29ri|)!dYTg1U9A(nRIZR}zUFBRRMY4ipDtfawLgzw=5tg^
zPUKIkHFm$UYQB70Z4C~cVI|=X4+xR@E;Wfit#*2>GeQdvbZZ5V&8V4J8%wT0a_0dx
zu$toIJGya+#ZbC-k^5i)!5CLuWrQQg%n_d{UrgGa=~vvQYJaqRG1Wdr$5+i8$CQ&1
zen#P-fO4vD9Cy_9TVk@huk5_Itn7(|tUc@}J1?f%zN)n<-Y5Ij=EYR|G(XMoJpy*j
znc2eufSxB`}k&D+YBQr#c>(T30HKr{8%=74gl{~kS<2;P(mAY{u=nqCS*
zAPPoK&M8nEc0;Y5jQ;~(=~XG!-Ko2(Q8&U{>;B~msitvq)~FfV$e7OZt%*Xaxxi}?
zCQ(u)_dg3Lr}_`=I!yGj1Bo;1pXg~WUeX=t!*d^QKc)%%kio)zaDdh?GB`q4HPH)%?By3mv~NO~MDrv+
z%oKzxq4|LcVG>PW?ja0SxSa@hAmLp>ycEOa{G%Vu5=^4`7d^X?x;Ie!%Z?PWf|$TH
zoMgFC9JM7L)-et5}JH=V+hl3D^!ee?XMN1QL+q>IYKVY()Fb)pUS+8f1noewZ
zqo(qBAO_K(sfN$!EJw~eYilCxBmI-rU`n8H64N2NYKITG9E4BhKW%}cbpDa<{p3UL
zoG>1KX4hTwfp=J&TbD3yZlqPLKweYsfs~@d@A&y+4)r2i`bp$DK84e5l6+teF@pQJq!3
z<=`C%>^b8U9#8!{Cxl5fjh#fVPatVpd{9dl4D!Tt|1wxa>&zf5*Rt1K;sMYJx{
zH~g1!FC9`9LgOPs3b$!MIpNYr8KN1te^l
zsFOCvzOZ2r6N_lw?Avu17E*QS$q)1%Gd>zo3;DKoMNPGiKTH6R=sg{bM_*1dyS+LA
zJfi26w;X9JW<_5Z7mH|J;M-%Eu4{3jX$W5*;~XqSyUc_ziDurnX-b-OWLA*8Xd;M2
z@vDJ|I4>?KUOW**qIgB1Hgto6B-uJ4OrqHl$UNM-Mv}a7B8Wus=0M)<9bvqV!o8E8
z5GK)lfB9Ahk0%n6;$J6#NAzCO@0WOcDCp5WZu**p|Ct~z(WNB>9xrhVPl{bQigZfB
zXp@URkT>rMq*FEwmehE(pw3`vypD4J=wwFgGjtMd3x_
z3(1r&ILfJvLn~rTvJPDjFnorhP$(T`C~GweVEBmrE#jur#r(Re%rI_q9W3OA$5vx5
zNYfe|yI3SHQ2kQfY^xOUWPwx5j#7WAZU*K8F27BB4D)3Po@doa_YWZ_wRx`g;kg;^
z<2SI*VRA*;4Ys(V9QU8iaSlI-zGJ$ejz1|w*Z7MoV;OFQ-)Bq6bT1S~{)#}p0-|x`
z`3#wu<3$(fN%%tw|6+lExd%UG;nNe>oc^T(pS~34^!H`-!+6cGU~srf)woR5xWuC>
zBntHo=eB0BfhVbdRp4HP9-~gu2zMcRNbD;G_JueZ!*9O5vaW7O;{BJ0hGBjj
zW0y3p5j5z-V$N{^;}{+2#mazUdbVmC*LvH=DOkVY+^?;hi}NL!{vj>w4Y)2?7S?08
zN)gPdrgLpwY15(8+`M63TerYNvn7XjlvjbNM3`&PWrZ(zbcx_xgrSQz*Nt^`N}w+)
z4R7>n_)*Au_#!mLsvGO(4SB@D-R1kK(pf`>Ecnz)b`R8(j97Q0?y*_vc%#3L4NAuw
z>q>Nd#^YTCAiT_+#AhGFc;#C?Dek&`#U4ymR4EJ$FS^2_fBna>QRfgA66@cz81!#^tdm2
zmSAveT_xU$ew*&Zj7p|AgD${O+kjfjE~3AUp{~(aO%rN(a|Vx75l!POd|dB}n=YaW
zB=_vmGCcOxircI4PVx-WU@kWcMbj`|{yqs2e7<-CcP1~2!WG|yxE-e99P2rK4t}>)zn31if5-xjW()nu29&rY
z$>xIdAq^oWfW)k7y~Uvc1WZ$>p`OA?XtgGYRitk*wJoS#qYW7@;E1P*GdxJwLhU1J
z&7dcd0m1|IZ=gl-2kdZLIk^rC*6fja7q>I2cc2xzp#;>TE_s55l_?Yk3-~(7rktgZH4#`@lEn;ZHw!k3aow
zc{s}le_Ic};9DrFa_h&b4&3r*NoQeJ4wSg~-M_
zc{zrU5|-j2lh5c-ENk%+#FH4JiAqbQjGxDdz(Wt75{b2?v4XGiR0ti%BMrvywhnwG
zt&(S#M>`&=rs>{}Cs+^(`w#<~*=O4#2yk$gf&T&1a4;S$A?)lBUgs_rbJ?-1^KPil
z3-KC@UFe*zM+sh*D`sQ&+}F;<~9u=CT21Jken~)mG48W;9kWuF632#iiw+_@4!^Py#pt(RCJI~5jTdZ
zW3dEo9*cVzZ8mog^yO)e7t`#d42T!AL`SUd?!}VOF~)B+dyI&>d>HNFSXhg9+?sCu
zZiHg>0#HTuFVR1#I;}-<^aETM+dgi0Z|_I}{lhJE4{XBUnZ6Osg9Znj9$k_6Y}b52
zb~7%mRdRstW_**Negl0oM84*^KYzRIbq}fh%yH(V`%q&LewMqGh{#ibyP!XlS;`J$4uf&<(071Zo4D
zaXd@|n6>XU0LWa8B0)A3%5%
z0T;$3a9hw!-J<~)K)U^e_vm^6MgNUr@Kg&&go`dr0Y-G0&0|A@!#E$M068?a9(GL#
z$C%ClS%;RNOi148wPc95b*ye#feDo*0|ANSR^8F%*on5KqEb$dQRW#b1`taU>niLTQ4$V4C{lIwy4kbh((~k$MpfK_PrAq-1X*mb$
zUQbt%^yCMiuIh0Dl*NLh7na9PmTE~1Zvbse&nk!*vVmz{P#*MEA}L2oTB;I_63Q!i;pZ6fZ|yevq~iwf<_jnJk@VBmMqqs6chYz
zSdqmHN?~9?$U1M;BxwN1;v+0wg@&9gzCu$FHY#N?+ABFIc4y7$ISbZVmh_2cn`I-B
zVG;UGCQ|W@G8;?-+Hm{NpL9>s&`x|uSc=?;JX*;?X3t}0s{ycK9*YYa0FzPgQOYp0
z=W*GHLLp`HxVA`{h!K6afdDt;aad3xz(9G#Gev>gQ=VOgBz()vk;hHL8U^Z;q)HBE
z)I3%_6oifSc{~xL_`rL4b1i^*GY|hOvSd^utE#}gd1tx)&Fn!hHVU^;8_VNcF%5wK
z^9XN>0y7vr(;#Y4nCc$s;Y&5Z;!1J&?S)fJ2@@Yo*v3#42#`nPRHCraIEz(58qiB}B5FwOgkUWx871{VGkwrN7fbv++QBhk(+$>hsOQCt(q^{JV
zK%B*Dp#{j}42-tO=ujgj2?_!FHc|w%0C~1e#O1Ee_T~D`e1(2nHY5PqkY*&5I$}nG
ztRfb|37A+SBvuuv0IP~dK@2Tk&EYNher)DYTB8lArb=+L7+-JDdf{gllLw_Ie&?Cg
zJipyVk$w~zu}t?EU<`h?03X34N+yX>mJo;z0g{+W8bOBudBkm_2Bs57XHTgxEn%9E;br7$l2hN*+)in|zYc^PJF#fs^NycIo^e&p}z-
z@~?6R0i(4$N$Vv}i(XXXMysO4&B(afVuBGB@S8^kzGw0()gNXr;_&)22C!AuGe$|x
z4Bg`tFpF~msvjz79#09W2!TGkWn|D?qvjAAJC#*9h(;i($;tJsl|Equ#;~#u47R_+
zFt#{<1wb?qZZ&!{hy$hz^S65-dH6`-4DoX=H}s0xaA9Pi*ZH@M_UzoUD2q=?DsECH?FvJzeQztBSY
z3Rle*cy*X9Nk{-%!7$FqXpEzp05~2^kz>qY>ts!h0Mb=+Ch(|c058_w!qy7T8UvMm
zJ4jENaYxMJFA8?GW63^(iHce=lNE3rS}lf27(KY0O5;*PT_ULCH5a;1;sP%ntnz1B
zOD0z@P}Xe09b`Dmg@;qvgo}%WN6FEs)@)gc@klLw_U3a#?iSL2(A|Po`U!;0!w)?O
z>(Ae+uNVb!e@rylk1NdY5N02Q<_nc`I88D#Xs*OH^dQOhNN*yZ|&S!T84gR7uxVs)2T&Xm;yIyOs1H^m|
zh2x`Cc7yLv>uU!_`qSM*MZDI4`&5{Te_B6%2rpb?mzvgxB&>EQJebL5i`bZ7DmvW)
z@?thuaB~Cb=mWhOYEblMX#mFuHOJ=_#|IV14=Rp8lpN`9Sl-R|E#(N~&k1I^Q?q5`AKEYV`;1+)B(X8ELI`5VPDt+WK9Wchjk%PekH-hbB&^Z|sD
zs)`iu(nEV=KdOgPgTiaz!1Z#Q
z>(m&F`rrTBgx>^pi0jw=0}Z~pt-@$C?ZR0z5Wo?wH)V
zv|Y*cMJ3aAEz^5QCU(s{>T8+WCn6KvUSaNl<9XSE!
zh+vOa~MXKX$QxitvY(~KstY{J31iq+JH-UlDr@L+vl
z83|N8`l&6(q|_acnF_hToC0R!+7=DyuT#KhVoHJ8LpHO2iz6Y%&uuX#<;d}DOa0>&
zo6qFc9nZk5i4w<0{6mz?dmo%d=}mHQTM>uTY+!gWU&QPHA4Ia8@WEL%LlLZZ<6^S|
zMQ~h1{R0Of3b|38`4ZFHgPHEsOxayA{0$8TWK932nC_HJA0LM)rd;D>_`lIif1xzx
zK*sbhis^48(?^4uQXsl1SkvEYrnDc*=NcTyn6ek2nR$ONnLacQQ?%Bb*_;YttEz@_
z-Vj?=<7p@Z(DxI%3G*!2Nz
zJ&jF*Ng0u0;4e;sT9AMsNk?_5J4vd4_u;8gYng5+*QYZw
zYB%%Cip}JBfQh|T$wj{#a57)YNxvI$lwHVK|A3V9Qzi=JJly)7<8n(DYx;1~CqPa#
zj(y9@$quGJ!sP5GChB(sPT!fo8y#24`G}PBqb3UE+|T-*V+T+aNyvF{fSl9}4zODp
zzEfk}Z4SK-glnAP!dSk06BZh+u+80qg+C(kO`C+(=?RgMVwlI-n0v~MHWobVb!C_l
zX7j(u42|syn?yNgz-;t)H!@|mSn=2Vx-;%9XKmnx*>$6-
zq3&KfguO*AXuL3c`p^azi|9fhzJh%K#UdQm#wIy>2hJl7=}tl(d9z=u5=r|-{!pELcDu&0o=m!mEVN!Ivq?%vM~a#Y68P
z)nHR=)EG){%k}jkp}Q6PzY;oY2z#5T!Z%Pm@a31}I&T>0w9A(m?8{|yI5YeuswZTc
z#W}^0&EdR%v%NIh3)%4bMPF{TQ3n@t)Qfgd#GHg>RZ>AZDa02swR+zHQx5YgcO)(V
z;1kfr)EaE2w6O$+pRyV1M3(1`O9cV8cWDx!x@DfOlYaTO^24=KN(p5>Qm<@{py7nsQt$0ledG+)&9Y)S4VpUS=l
zhMx-d%M;2ko0VUlF#K|@^2-w?etD36Ec9D!)A8U<;EVY`*X)+&eX
zHXL@oa@g(?hb>kPLk;CHx+aGw1iL*BdsR7Xw~xc#s~m=UmcxFd9Jbqb*xSlE%;;fc
zzkk~H+e;1;y@VK^Wiy|ffl;E#4mDtXV$aenE9qug5~WA$gInpBmD0B;
zrN3+_{eMd7FME`Jzfu|{meTJHR2re~8+%o0FxVKZ^me86HG5Q
z5=-gEAf>70-n=)JCI<9nkI%r4*VWhp#dULM@@SmQ;B@68b#mjnxijP>C5e|5mWWx(
zb#v!({p2hqiFJ&niq<}I+CjHa^LfWg97E;d>AJbIWzY&SZcq3XwXmW;sQK`9b8Cje
z5D_2#TAc=;8x7le@Wr+%>E0_^2sibki*?1>Hm%)yc#i|Unf?*bn@>{qp?)e@iY)kW
zo1Hi2=-+%v-0Fvn67|D)uy=M?-llF=>K(8<;$QX-h^z_r&i$5mUL^0Z3HJSSXYfANGS-Oi
zBjjNyfOVrgNjdHQQm6ezIqiNwr_EQMx!>!w+x?2T({58vyI(r(w?R&$;PExviWtcG
zQPGqej^X2u=MX3NUMC{~R@nmRPUXLST-wQqNSD7G@wU)XY+20x-Q4OFeQ-1%9~E#1
z{!TfTv|OR${_ha?#X3xqN?LH?Dqo^wN4;3DW~ZIhU{376VCztt4O!dfCJ{s$BJdWQ
zfI1aBgna^Skq#W0e~WK&P#VOTkVN`8f78?pLp(dTq8*pJ!BVVYKRdU&y$5YNLv5NZ
zT|YZ_2LCdj4kiCu4V%vz!{#8Fl`UgEJ9j2dNEgMj(|1*Sd=~97Ng@753&f)S5A7z}
z*E{UVHJ`SPV>D6bqQ@b;x6#6YY~>2Nok<2{Ke%Qefj#*CsiD{3>|sF2Ae{5jGW^B4
z`!xGlfX1QOL-7Gx!WCEModvV-v1JyGEsQ96gid+-jMvg5r_O`azgHePbsm@dXXFvK
zOLgizL-Mrp$f@&m%DPK=|HdE^~I9-%q%<7F&@JKw3(OvWQ@
zYs%2;pXEG4{I`_hKN*h@y|aQnaz1&4u07&?iv{&Nn=AxAMsO
zmPckP^Pew0GTj0(k1P!I2(paF%2?!I@CZ8k|#4j?I+nsUlt?I;E2j?mg=02*27Z)a4`%gw=k$U^mCh0E#NaHYmnni;f{lh%IXl1|3RZk@bpoXI>+;VO#M$D
zO%YQ#?}ZYk+L-}nv)VAOI-xfF%H&AdfdZr`%b?q7>^7x;2Z&Wdi|k65fJ_N3nCqSi
z^d#TLt+G5EI>FAeb12qPd3rUErB`?=YN#;C4-8*9bxf=ygME?-oVC{#A#%zJO0-~cWxhQAO*A^I~vg8L2B5ghZrZ%!S4H<11$B3As-JoQ_BK&
z`gI8lv`KapbNV1Yw#7xiEe1w_k@gb}cMdgNUX}IP(ho(!fH^`k=$aS<%SM6$+;F*3
zo7)KVSx}br+YF37RDhc6kWpPRU;$V%Xg4tSlmT2&FsgF~Ixa%iBYqR#;Cz)?0Q?)b!#}W
zTP8-VR5Y?0yH}X?Q$g+flcolcMII=Hnh
z>3atUwlc%g9eUg=D)pZtei%a7By@)StcH{;0n+-THM%m%28S^8!M5xcEPEf#
z;(o9)X5AH5;_Jt~)laPu$yg#pZry9_^qxqrP#li4J8I~V0gqqwg?Hy5_8W>g*Ro8c
zdh9Y3CfQJTVK~>#hlH2@6GWW2XYB)>6n>>LvXjvTpL-`1Pl?SbK0fuIAmTxySuCL$
zfZZ%)NTpj||Lvxnc-uHsXtdm4BiTUM0}gv7Do#xUK@5HRKf&D%UWszdghW9*EOY({`PL^OeniK5c^dV&?r?uoCqYqP-_}-b_c?u4AG<4#UB*kv9sB&~XxmJa>T_00
z_vJ>rexCcpkc3SBemY)LYdm+?J4A0gh^B+SGN_N*z8ma{znQL}>z}#V|E65AO1a{1
z+7*xQdY4F~53wZ>cl0%;bv{k)q09&++rw^Ch}V=5yOj`4N{HQBh(~ud3n32o5du&4
z7BYiq172BP3O2}VrYyUaEUzh9=ssC)q}Q}85ABITa8=o}Q_v9KDjLC3AMKgiWO>gA
zcav)I?-Yy<_F-h2nfQJ6O;HRM^n9%_`40AWp`Ey&L0V=tK4wAWfqwhb*l!13JjG^x;FE$EnBDEZvfiF`H{65vdKcLQF-?wkw&`IJl{0lAURslWB
zZuhxzJ)Z8<36SXlQ>OitOb;lT)+z1}7&3jyf=ZcApNLHG`S*fldf1d{o|5TdCDRFt
z`@@DzXIfAx(iF|kGR5uROBgA0HX5ib<@dYhgN!HFk2kJ|hREeG)<1jfUl(`z;
z3RR{&YWz#tLjCJq!sJ5fde&y}@7J1yirYd>vDOICeKv#t0Iea^YX4p**Zogfs8)lI
zR(wCD$?~?fA-di8g2lQ46-dQB(Gn>$R`uC|_N#eDyKZ=6wZ-(pQI&
zuh^Gx*E3%otbBF7>8pkyUmqrfGXt5zrZGH$D`OvUM(N@8gT$%{I~_son7%-@
z1EA-l(7n>2OCk^xgQDOCQ|7|)qM&uC%`k=fHZ`z&J*-`(w|E~`F6&e-1EO>pJ=n~<
z*Tc+ZyVauR!)EuYS06M!yl^Ia9gN>mcPljw);qyRczCr*5*}_C&%=~kcs??H6Fp4a
zJ@?J*-A-D%d>Y_(l5R_IPkmmy{r^-?eO|eJrE)tErQ3f?K4M?9KF{3#sB-)BrrTdo
zZhzi#`&Gn8RF`gN7wt-taQnh>-Hrjn^Cjz>>2`4c{FHU<2@K$S=5|OoxYtf5d5)A8
z3K_O#O0n+Py~b2e$n>KHR>SWdl!D0PV|(vRXBi7n4zu?T)mryLXl>QOh{bQJ?XA~g
zJkm%9xO+{aat=Va^SS*N0eLDuCu;vX{s@exfI1dIQu7XLR&{6{VEuTkPZs>G*@oOp`>
z0V)2AO8iF+@y}M`KWd8KXkYc?*LcwMqjrK&K0V*X`$2So7!JXx{3ww&WWHx_QzCH9qS>B}aKw-x8CN8*M4y1lv$|
z@T@og2ik_Dym~5Zvp}?_dfA$2HIG`pkGIM-CrW5;w}tsnG#RA4(w1^^&1p|eW@R8o
z4@9^3oC^K-Sj3+SgK7AN;KOW9`u-`VNpjvb)ilwd@0cV_>jbrUEUtT#Tf{+-LWW;>
z@%Y{$O_q3QFOh~peuO}NrK0;|PWL7Puw@Vc=-K-#G3M4X{eHY?`d0p!(h2BTyoJ}g
zZm}P4`9jZm0#rw!e0RRjxdc0w9Bn#a#qMFeBTUAkdylH{Z8gqvs-Jy$TKr_(Gs*GU
z8w&JHU2cFqK*211qQ>6C$~b?s4!0(9@3DIuz4~>zJs%M
zfy9=T?(iTx{5cO{j;qVU96aS3R;BNSxD}sVG+h{N1I1(37oJ>H!)^8>G&ipKlZ&cg
zT=85W8I}QhaO*`mHe}hyhz;uo&nPw@A~pgh*xaYsJj2=W@7#$E1N1obz5}=HGlpd^
z@qsqttek0C+>3>F4F^w+WzlEnU@E~a%kE;tr0^ux0W!*_uP9|(l}%rfHvO(r_7zgL
z&-s`Q*n*`w=^PNk5K05BA3S&J*-mG@h}w>a%82%NQ8#Tho^VUgji#WK#&j8YPk-usdX6GpqB
zj4$V4@M@s62#IGXX>U=|o~@+4g`^!;(%zz_
zbx2y4HvwmiJ;2Dbn_Cu>v=q1X?*^wwiFV6kA?+(Bh)eq%HtTs4VHYLXO$75V_M#{2
zC$}qMKcj@borFC}346O1cDFJuaK^B!2jQwPMoqh23#)#c!rm^0eU^k}9s`IA`vgr)
z**ptu-;X4bXILzUMSo=j%MS^M&76R)Zj7ovBfi~
zSlq|_HPv1oTa0h%#@M~hq{U;4>$g$u4t|N-9C(6v*~b>o=o!goGllp-FK*tJdDUZ!
zS*o2=G5ImX=|V3dZJ@fWwNTysVDCvOx;J|kHA4YLbonndRo=rNTU@(Muzkbs0#YwL
zmcVC4jY_SjEVV9GYCT12(Pi9Rd!Q9iS&%+gu+u^S$)4Xh&hCky>4di9+@T5}q
zW##Y|r7YD|%D$|W1?wCFfOPoF+Tni+a5$-Ts8Z|XC1yLWQEHvM1Zq8Gq8SeVr_$==
zB}Oy;gmU=FOPIs&QVu_PiFWvH%Hd#cIQ$7^gOis?hksYufH)}|oTO|3IdkmgQtt4R
zmnetRH3kYO9lp`uFv8(0@dbix;%8chc~u$aOft;>DSw~2#OmN5QkFT>v`j%+=FBCm
zgR?=0HTpA`$PRv;(v|8eT|cOF1?wCx3zur0xkPpFPRzym7{}i;6oHF%a13$llvd|k
zT0N_@I-j&+j$tDq&U{2QdijR;@AD0JU#r{=s)oDoSMEMvx%(1j
z0^+1hkX9yuoH^%5$^_?Ychg!mcQ=62-C-l}^W%uVb7sA6ndBG1J_!Hv5py6N|XM33dzA4rMHw$w0Bs_7Q}(@o2N!P
zB1g)8V+zSZ*{@Fxx#BR-!ET*8a-{4Oxq_slgyGvI(&?xWL27pdg?^vC6>Hy1?=MhO
zj!rE}Qkst1%h>@Bruz3Jq$I^B^1!se>NFNsAj6}PG%v=Ludor4L2>cYCIP){m$m)I
z&7|)GhZJ>esHJ-98dB>9H@f3=FG~UQ&iuDaLG5N=4D{TxINwz04PzT`)H#@v31;p(
z0wVFrJ69Qq42zn;fo1Guoj?!`l^z)<=dm7ei9zknVhfwolgDqewq)dMOL~%TBv;?K
zsf+Vfv*ha;--Nk&A~ll|seUYBAPM;M#HjnEWr`u*L+ZK|Mf6zF6OQ
z8o`DCFImgyFsSND6woNZPYEv=ZrPip7uoP_hSX34D{NjZeB+9>;Lle2(r5lPA&sq@`q8|Zz7X%XlM~OHzDjZ{aX*|EW)GCLtcT{R
z_g^MyJzHB&koxqLXe-FA#Ln!2VpW7)4BC^k*Z!$}-c2hYY{}!9{joiiqMvL72S3+4
zN%Q9hd`%`#hdi@CJ8ePBI()wefb5DDSZKBY4Guf8AqZAw8&-G$4LFK{O#mT5%}}Hp
zM-v`KGQ*cLp4or;C?DuPWWvTc%vGBm&+ISu557+z!LMc%ujppkNi78$V<4IwNKj=@
z1Cm_xcOxFoG=DcaE3Mzn&QZaJB~R{9hJAw!`#$=~*1Pa?Jq{KcKQ}nXli5TmGweww
zfDX`Htki!4CgD3%N1CuP4r?Y!1*OW-24|`Do9@^&%E#yszWKWm*RUGD3vp+L`MWpn
zEGC}JTaZI+-hEhYuDSn3ayAeC;MmZF>e>Y-pUADQimr4V(!$d-e
z>B7KQD1(3x3^Zo`hJj931_B*npqWfLa!qr*RZ8*e+a<0;nfM(2~}
zZ`jfP-N=rDNj_wsoU#w-!9JtPK9ED$=N@IB?b1HWV4qIMndUhA^g{!LnOjq%
zdr~GdgnyD~xfVtWPt|!aUcsU;r?G%&c#99iQaCT(*N=tsGrQc&0Lv*$ME!kA$m2aD
zC0$#`I=7=U9Z$qJhSKqlb~oCdjwa!d<)Zq+QjGQSG&cSY69@;!LrJ%zy={YAipgj_
zy6bHM^?(3WB6<+o4Zj4rs)+D^u<^6uDD1<{6s48LRfztx#INdNFOX@4hS$Y!U{i>b
zw0c*u1WgogCEBz;q<#baT8+LH)OVqU^5UAUjC{-jphCnX00twPzzFES#rO&A1GMZT
ztDH_}TjKoKkHh
zo(i?JMe&LH908ghZD)|
zXJ)J4RpDd4?(
z(}Y!O8`8{PwUqKyMv_QSlt)65u$vwm%0zHG$$Wp0Nag;vv?>gj{6uL>fUv1P0YLsy
zoNDCFX+Dt;5BB#D4k#|~4d$|YX;nI&#D@`5iQP-9(-9bT$cD5f`D5A4^$e#qi33W@
z1?Pp~P`jHRO?2n-ErX+q`SM`quP?1ig8Ba_RtF
z9_#S3zayCasmrRUWo}d!W`IVVWl(RQGs?LMWx&0!NgBnR+WIa-m8cc
z0RDWJ2}lEQsM74TW!1^piX^gd=?n&GNV1dPyhVXZ9OKjfGpR&D8p5u8l@k;2}8yUvb*9nMLI?=YQ!bc)~yMv}Lo3hBe`3d~--8sG$fo
zIBzvM#u7>A7*p(60%A|6nykebH7QFm^oyl{IL!~S3F(TA2B$5niN!*|yw?wtu0%9R
z65@O*HS|$Z(RUQUAuzxaPUd<4L|
zNdk7w_jWA-IRIdOQKJSo;P|RR4h?765GARDMrE)lS1+qX-F_f(yI;MmHnlFDjIT~&
zGHC!Kt;vQ)wEgB1U|Rzmi7O45+pb0PQK*2qA5UrU_-i+NUEeab}Xw6
zuS=zq2qIo!d?RAd4@?=+&etNMaFu68!il(2xXfjpvYFq*6h2-Fa?i5rc8dL1DCzH6
zR@E6w;y!=rexM{)0CKMdX#nK^%t|pRSfK~SNFwB>hOt%BuSBDZzkGZl`TTrYbsHJ-
zLd6G=R)SojBGS*7)wIQlQ@06fWgt4zC>tM`%K?9!F!B&H2;Dlt8{R|kFIYaVgm`FK
zH6wqm;`k84;_3wS|DcH!TaChnS#4}}XN(ez`&6@jXxa4G
z>Tm~!-+B|VMIipnL~P-Rb4?g36JJ`EkSa|F9>Lha&do0gQ|xn(tp5LvlR8RfZU(*cUbXc&}z@VRBR
zfVHNP=Uh_)gpOBWM#4?{+_E}gCgPY{Vm43$MgPotIe~i>>Cepn+_D*{zqT#Zj=onR
z%~A`nw8{!RF>hlh*L9J&uY16qFfAIa<42?cZn13u%ws*0#gRqq_NW_L0UJC}0)!3d
zb8@KzSu4~4%%7J4fyti!5!y1$MqvKTi`fXw`@Fy=VA7#Bi%}CW@0EGfWz!5>H9GVW
zjYO_VB*@k5CSt*UIzW{3{?SrBfoWb6W;Xc{9_(?x2Z*JLBo2Ox=DW(^-Gn>mklP7H
zGr=gmI+h{77Nhsf$Kimg@B$hXWec&@}kiD9YEbZ45zG&)=?wX6j&m4Z##izU+a
z3=b;|0%rsb0ZYQg&ZnnzV$BUan
z9~qD)cyOL!f}_#-WKc!?KnQ9AgoDO6AWCwCw{_gTB
z>VtIZg|h-63cxHiR(*GQb&{rbSDKI*L2gvh;k(OgQtQY@^xcT0Q`wos$fDAz==!uy
zr|7IjfK)q{SA}5O`HJO^<<)DV8#r)Co>K3Az(OFt7l?b~n-2*2zC_m73
z96lNgB1``lM5x^)v1Z1-xIhz$Dk>+GrNY|Oz00dRX<_Sj<<5JTSET@`R3^B0c}-^`
znrK9bkg=UWp>(n3T=f
zE|O9{LQ*#4dpjx8BV5X6W2KKkkg^#Aj7cco(TuiRDowMJ=3IZ9NmjpGUX#F7E{P#o
zMyubU<)$}u0=5fvd9V8&dPS-;8b$Qbi8bnWc2S^gR;v6C-5!8Hn1BudenYyk`8+DM
zq>{-tL^2Pk6{(KY?RU$o+rn#T42O}ZH`Ic12mX7~KZB77;p0N+9t?_8)?t@2<#lc_#ueu|IU~{1#Vk359Y(%=G
z)Q4gdHrx?t1w~r0VX25$z-DK*DPRhGANC`6B*ML+2nCFX{P2##)XBi3Y>XD@r5wsI
zE3wHS8_i40Yp`UKiedxE2Xhs+eGQFcv;xi&3a=_hV~A4YTf9*(f-Lj*pB#ohcR(eY
z=YOdY0lzUUjgcBG7Jcr3sw9$_x0?tULbmGW8($aEt>p%PZqSUi!Y>@4Y_I~if6HF-
zg#)Tnl+^vogtSn*{IdxOtpnr_CL~RepDSU%a6r{+0B8xmgkJ+PbCX{Zh|Gy3Sd}4I
zqZ2j}TgZ#MCB^?w*qaB)mQ;1Z$ocVdLA_D5^iz5Og4I1CO`FgA=u#C?R
zvzx5I)$VbiW+qcm{<5v__zk(+hY^|wI=JWA_Z^M%)6dv?e?A0Lq}k@T&N
z8ZShq7eRSXNWrXq-TR}EGT{*9FGI?db@joJvQMrL)U|ir3&Zw*XsE+v&N15a6A~=kiCo~S7+;{r~F{Iuva@_SCGgT=hfF=w^}aI)$;pPTjr}#^`yM1$@A676H}YJ
zG^6NOUw`}Y;eN5kq8%c}>baYzmX6BM?m7>qtsK?$sLrQf9k#+MN{qEmm)JenA&GB~
z6;LnunRUHi7l+YD{Qwd-1m>p(0?ymdmXNNo250;#3D)}R#t#h8{?fQLjU
z^;4Ew74Bn!mDB~MTFVthJSriVp4^U_pam<5Ovmfgkdd8e#X~0
zrX15Ze&5Vu@^8`$EPG@l6k#us-O{zlnGP1$Zi
zXNj`Cw<-QD*I%<*qx<~nkaBhkp^s}^`j+c&HyJM%`)jmo?dG73muoH*UX#+0juCLa
zMv&ndzH04<0t8OC|1jj*U^y2#emvA+ODFrmn1Z7HL{t5@Tz~C$Ls1V36G726Zu6?!
zh>6DR2ro6hb_<-Cnv<1x^VE7e>OQH?W}Nlj(z@#i`22_>>E7c*3ujI2oL=`F#9aH}lgjxPkVi#;6^k?434-_p}Sw%sHz0+os;1cH!F1
z@&qRQl#q+-84OPJ74ozTToU;HkY}=7V}`;TNSY)t`X57(l~?=jRC}LCVjJaOVk=)8
zz|9w~U7ei4!=KdT1JY#4QN{}z-EO{c+wuAU6RNtxK$sj&F*&I_{hKdbhdy{k;%7oh
zBosgLN8+B|N)aJwlMU7=~a8F%xAYo^QDaZs<&eLC4DDK`
zpOtioiy>fvBK5lZ%j)(|QVn>*Jm~!?Fjf%kll;8%wFT$r!CZL
zS~J*j@ylLQm#)O}YhCyt9pALV*hA!9gVne-)^Uu4+~NolPC3c>pH{*O4pX=IYh0J&
z2I-PRV?cc@KGp^V1!ov@a5PHE1vUB-RxvGc+kog;794pigl^Uh{M
z9&-#$fWs|b&!9zC7?%b%fbH4?GhN@s>&Pb%y>0Uq`Iv3_wagDVyZXYW$vzMo{sWt=
zkqkY_L#$*4R$1yof8fGx_t8MNSm{b^1qJEY8g7!|>NUu=a`)xWLu%Vp;$gNDon3zH0+$4?r#kZc
zwiA5q-^uE$6QIB5Rf4{S?tB(5@cid)>7Q`Yd33=G!*2-V(S_zW+U8!3Wq$(S))VZo
ze>;8HW&a6$Te0o4h7Sg$1-39b?5aHid@exdF(Jjp!?dA{NON%q1Mz2uX)f-d&3`hY
z6i9P(OhKBTh$!4Henw0|njeoS+$e5mFwDI|n*SIT;}RA6>V$+;?czMjzqmw|9u}u6
zkZM48l3KdsWP{)ebc`56|EWdCF#5d~z2w40-$^oR1lsff`0zbPWrew89Z=T|Bs6y~y6oDsDBbwz}#zov-L^A*rvjDNDe
zvT9uGIY?}LnQP;I?)~XnE;P_J(sS>B+v(yMR$KcT2%J#fneM<5+~mdP|8^ap*NHkg?*iGaOx>eZ{4m_1V|Ch!Q|g5mJ2mdnZml`y
z>Ed9vY5SEQ%gS(t{S{Yu-ZA1e$8TtUDf|u34}zuE$L+E)pD^$TKs;6n-yA_@2z^rkVTmn-zCD5>
zuE(~D;rlP`#F$CZ7DQ<#27k1~zOPpXleWZxCtiq%Lr=UuB91)qeyu?uqe8O(hnOn)
z|9wmq1^y0G2d}{G*O>o1ljIyhlyYB8N969A5ZykBBYs}n0+=6^kAD33cnN>iCf=+T
zqE=8=5JjsCk%X#|!0k1k-JRT^KxF(tLKZ3C-TOUI$ENU|J+2jj!x)lw9ucKfvxq2_GHr{+vm8>arlQ=W-4Q>h
z<%SJNK7nU|D2>P2p6D<8xK6;gwE|`gGjYUgS|Vy?&lB(4Rv@ct$5VN+t`~bpQbhv}
z*FE(P&_E1@(NZl@DvFzsHE~=QplDC+VL=Hp-HOuK=QuJ!>8ggUIJc?eit`1ywbPrxqA|=c`_04hGxu?DS0Q*ZDRcg%eoNcS_^-0K
z##l^OYtj4)jnH6j%5P6BH|bhzW|dKG+1M
zhxziT@S^3zB92lb(53Kk`D#!KAD6ENMQmKY8kEAv<*Pv{d|bX7l)}g5t3fIJmzzbA
z!gGgJtb{Ri&Pu+awGz@Wck}cwP3VmH;$Y&wF&)8|o_n7Jl3@Ms>8C+FEJixr%e~hebOGY{6NL
z-r8WrscA3w&;Y9%JTSn14bI!1Ue2C4MS0lXm-ZU;)TO(xz5QKbS1QE&xS1;a&F6^1
z-$SgahrdTyP```Fzm{Ku6459Tp>p#dpQB6B#~G+Q3CnFUSi+>Vk;ripCeh7r4v`Sh
z^Er~7E3F(IA;_&sf)7m@DvjS2lnz-q973qxT}8_6{74AlsWGKO1Z|_b8~?alHAHn1
z2JY;#)E;7L3dBk`ir{yNc!=2#H-|ayjzr_
zM+)xZbV4JawU6^b;qP5{@YUz%OI={OF)sBG3t3I37{0W}Kv5sABbUn+%z5qCd?{6?Ynup85qnuXlKCU8V3+->Z_
z!GQ;iGSp#+YG{9BWP#O$cFGfsG;p}dqVMBKdc)751g`vOMpePk!tKO(HSW}sODqjH
z>be0%XjX140keuyOnN6Vfv4c26f?AZM3^H2AtD^$B9n-4=(Ym9de<`B1=jqd6gOaP
zKO$VjdTnDH7#U#4tNDpR0e&{g-FN^ezngmEXWcCe`yB5aeCBt;`VZ*58M3MWfL>xv
z$D&tQ*0Jb)cN9YBJHXks8lqIXT_oA*}wGSRzE?~ib_
zderoOqIXRnBzo8MA@sKL9pP+X(|-6gyJ%LQ9hX?kDRzC^^5P>J`Yykpy&r9HekHM0
z+xS87)r>m$;{(LVHiORgbJ%-w%iB_CSmo4-d1zQuc|urI{b^uds@wSwA=cNLbevah
z*5~81DJnIk&Q2yU&8A3__6CxJp>Ivb%H0;R&1rH+ez=l-a*2U`&GHY0U>AXkOb+oW
zY8JL4;Cu()tqfEkKraK8P&WfrIBJ}M`dHRc`l0NL8G0}UKyd({Zdajd#aUfI0#~k)
z4L*5T#c$TFYC1%14wmSoRVFu#Pq!xsAXF^4USonC_?PLj+#t{+HALk2^ay=vb306}
zfpP0icgfFZ1afO4q
zsP=IH^f<~v1%@7qt1k1G#*n)+<{W=9ihEStG696#-kt{w>;pt?8giC67#bnKJCdWR)`Z788kz-b9A36Shp0mWfBa`C*QG=Nr2goribbuV+lIP^iCX?e3(My>e
zhsZH2bch_^oaZbtcgo~ALLgKo#}RVO3LPQGH|04?#J6N}+(k@PCdXamm=(H<9N(Dd
zT(*8H#<6O(mtw?+HhKs(R^ymSmdh`G*F`2e=
zD{)G}E*t$m`9?Gn>Gq$^@|74R+PPJTXs~mm&*vo4<^L_qS7IH&&aIEw2s=0Wdrl(V
z{a>?uC89U&+y;oUuydoY=OohAKa=Gv(_w4V0z<@W*tyZqa}w$1pU(1?_=4MI8{uI#
zJ2(1xP9j}A851=6kIoryWaqYv(VCqb{W~X-?wyP>n%s7g+y9@*Z4WUuc5ZvfEhljg
zxh3P4CbvE0_Q`f(m7^eq+CnLPCBj1qL}FcctAqL0?fDA7N!phPCGJ`N$6`VC;BCJ+08
zj1ueyGD-}fUq*=m^!vtKUOc*N>NkW@oBFZm$SA>%BcsF+`el?DLcd4l^5Tt&kySdY
zSmKI}XujvE(Con`ooD;4^d*keS@a5bN2YXquw``e2Fd1c2N?GgMFc$KYKzufA)iR{<~J@B@0z8q!y}LNG(*gkXoo}A+=CdLmXnH
zKIru07%y2ZYj{w3y89Kb(&+gFs*FxYpg#QFtUnHOO#L`2%qYP@q3(WNP9<7b_k03b
z-vEL54M;7oV*BD)RBCyS4(*wRy_kFJzDkhxu)uJ~sO-%}N~3vN%|8cK)n3
zJAc-ioqq|R`1wpeee_qBW)+TzS(70xKjK41_o_oZzx4DPjkpC6@odMLw-Xcn4dZ1*WH6G}pBNVrWOPBLgPssO|HN+y(pRGHigave6u8DYDm&@iupHwU!
zc)bRu*s3Yq8Hu2;6s72;mQtnKV-clFgj3i`mAK@?RI2R#o(8B?i31ucbL?EPe^7K(
zNQK>7l>=+4!gcw!QWfUbiiI^*;f*T=P^qf-CkZfFpC6qr5jc`8r{d6@2VkX%o3s#b
zL5}*m7UEgf3{=5QGEg6f&|}4+#&otEU%`I6;&A}j+rW;vU!
z(7!dNUIW|9^A*-r6@5Kl9^pnRML*{5UvSK#mNP!XZuISR`tknB5e^(GIos{z2-i9_
zC9CCNa~SVb{C2{C4q1+TzpU4;Thvn4mvQPY$`rRKp0975VDsR$8rWVwxwwPa
z8pSbQZnisNC&vsZ3Xi?4x#h1p_SZM=AbL*$%)G#LfeK*e1p<#0z|4!VGYd0kNP*@+
z<^?V%Q2;aNJIe}S<|P7J6u`_&v#wBbhAe0fWL{$XHL?xXmAe@Iu5p{XIy{=;47W?YnJ((z$XoslS@RB{2O5fZbMi3Q&`daL`E3b&lJn-
z>;Nji-2hg|AD?u^v44VG5KN(f<&1$x@6!OgwHe0$ii7>y3>~KeHp`0u-W=NzUfMW^
zy7RP)cl6bzd1{ZOL)keZ+#|Cl9lB!eCdyaH_)7k<4HO73HaSZ4R4RupayZxIHOP;Q
z$#^j2e1E-iS3JwufTl+BcEc6wNVX?)by|@(H=H4+H1a*BUhZE!!kqz%zFFXNnfT;(
z0iWDn#s@iwouoDn;Hw15chu1rc(b95>&DS%mlsnUN{%Yc0h=v=|CIpKE%Kf&Cy0WH
zIUKM(*y0lsxhbB?p|-dl2GNYoNX%(FT~Zb%J3F{-F9Q{bW6wamS~de!;Yy~@>rnFQ
z>%3}cp!2Gsq0Xy@M#w9!iUqnX*E~V!t#2LxY@R#D?Yt!enS+03>8wgbBdRYoo>NcpMDqP5w<`J&G(FOty
zbY6!74Ru~MG(uiU^OVv&ybL}V+-(;C*gSVI=xm-~Anlt6>0R@@!^puk&s!5UZ3SP^OM#+og&2yq6{LBDt8cV{Km(%<1R5Ic
zEzk%H_fadX*}1V5k|DXHvlW81E9&Oxt`%;H>(l|R6_O7p-p^uRfL8cm!r_29V!GcQ
zw}R(zt?-n%6>uwj(}x8|x1C}QRN#vGsH1AR%Ct9XAzo9RaMfK-A6I{5pn=Y-<{Ij}
zYG{PKl2(9cu@!i|P2eNzx~mFS=zJ?6y=#ScCv{2&*9vb-fTpYZfCaD>-lbXrvRo_t
zNLu{5XW7xkuc1O0zlKU()iqS52EU%xJxgEbRYL=vR}BqyUNtmAUQt(tH^cC1+cDm~
zd~Mted^_xXzJG+(xP-yechVt4&A|5xO^y;bKbk;=+n7wCkN7ha7$8*41csQun!pJ2
zX%pDRW~vGBb%$t}(G+k813()oFaorZ5)(-qsnS^)a8-
zW!1Rmr5+Ir6s&DJ9=>jOjyLXLsWD3pa52J0xKdyvoW|Qog=l9R>0?xEBZG8a>7L}H
z(nD-b**qgeI4T5hod_LdZ$8b3%%%lr=SR+>^9yIu`FXSGyBIiH^u2WCUYBbJ*M-Iw=_>*T{_kv{47aD8aS2Bi
zZV`n*KisAXfdN+9%*=<_VK#x0`btaYyV$ofIrgx3WC10gO)-IJ|1D6rjP}4nAliot
zfqtfdy`rBsDB~AksEl8L
zkurV(c9ro9u$NAH#m3I_jE4b#8&I+
zT)VO8T)465T(z<2yXkVl+{@of7m9@ruSjjfGvHg1R-FLaHU!YNA%M0G0kmxhplw3{
zZ5sk;+Ymt8h6mskb^%M;M(h>BQ7YpXpi;&!KwlZZ00U+G0t}V$3ouf~FTk!cegXEv
zFd^r}9)MTa1%y{5yJYi9ydoX>csdtuVk`7?uG(01F4A0j9-9VW&8r{rJForBk&5lfbfdF#CrPT
z6{+=mIv3JnYx8ujqFHnY8wL3HmthB2r6BA6pl(6
zzW{w@`~nP=@e43i#xKA~8NUF#%J>D?OZV319)MTa1%y`wk&dqK9Eew>*6-=usEn=6
z)45A&(YZxw(fi8!y_|uveor4N>-Y4LvVKqB4G%U1<=P7ml?8NoMQR&f5JpgG)d`?&
zLjY|X0%+S1K--1@+BO8xwjqGF4FR-mcmQ5u7Z4+;)cA#ik*Kk|2*7Ai6NqBPgKEcY
zJK5-(i>RS8egQ_x_yyQi#xKBLx}_<3z$@$m!YhJMTc_?&ydt%JPv`z{Y~`NL&0&kq
zonedKSJv<443zbI`cPTFr;n8Nd-^V{-^zC{Jjxi97haLth8F~{NUKf&Z5sk;+Ymt8
zh5*_&1kko2fVK?*v~38WZNmfb3cG;tiq!apgQpZ?;}?Ku6igsGp%7F%ydv3noQtTT
zGJXL@%J>D?RmLyC9*%ffTEQ#q0>UeTSZ}B9NW3DoeoyDNd~9u=&OLdH&JB5s&O?3{
zeW0x0%O5K1_wV{%02VgfURS0sU5a}hOE#xKA~8NUF#
z%J>D?!|_5(D|m%nKzIe8-U#<4cEu}F>-Th?F}2e3fT>02=~9c%qoo#opse5LJ5<*1
z=_6(Rp1up~x8(03W-zWHDVMel0kmxhplw3{Z5sk;+Ymt8h5*_&1kko2fVK?*v~73*
zUXj{{0JIIOuHY4^@e2pfW0@R0jb#D@W&9#)sEl8LkurV(c9ro9u!p0qR_5>uyMXYD
zequd);uWd&dpb`x$JXZQJl1T{d8XN-M+cf+=i%iHl=XZ1P+7mHkCgR$`Yx>B%6AX9
zZN)X@)8ku_+J*qyHU!YNA%M0G0kmxhplw3{Z5sk;+Ymt8h5*_&JOHmqZ9@RshE-Sa
ziq!apgJ-Nvj_8C{(A@Y|Bw>tm5j9lCFTh9{zW}?+_yyR*v1&^zc!ga+ctu)3ymIO{
zEYiJR0rXz40D7-i0KL~MfZppBK=1Vmp!a$O(0jcC=)GP6xYrxU76RY^0Bvd>a|yl!%QC5nyH`BSe_l$gT?9sY|+t7&DUxu97J!W*eE3!dWsU
zEvsBf%YLq;@Rv+UvF)8HDfYe75G5%oHokKu-9tE?SqE^MOiAH2$w9X{-U0SrqxOP5
zVC)6U9;4bV5>dupu;(!Lf<0jD1$)5Q3-*Aq7wiFJFW3Xz3r=dw1MnJUF@hKtBZy%!
zf*2Mfh+#2;7#1UlVKIUj79)sZF@hKt;}Lj`vKT>VF=oBNYg8{FJeBqhLHgP^1Q}@G
z5M-!*Ly(d74MBFbZwRu7SW~k+@S03X;WgJKU#G%v9O}Jd0rXz60D7-j0KHc%fZi(>
zK<^a`p!bRe(0j!K=)GbAxL2IimM=NHMp=v?hQ$bCSd1Ws#Ry_pj39=^2x3@_Acn;V
zVpxnIhQ)XUUZX5V5L%2`Z}1xRg%qAj`-UKW?Hhs&v~LJ9)V?9eNc)B$yV^Gd*$b}#
zb%R4O5O__dr0|;HxVY!>JC1rUx$uDAOBO)yB@3YUk_FIv$pYxTWC8SEvH*H7SpdD4
zECBbClh&648WtmnVKIUj79)sZF@hKtBZy%!f*2Mfh+#2;7#1UlVKE+o*C>k-gcf7g
z8@xu1sf4G}z9C3o`-UI`?Hhs&wQmSA(!L?cuJ#Q<_HatUEDyXUQ&M=%waKh_XI;8D
ztTZ~&({*&Br|alMPuJ0jp01-4JzYm9db*BI^mHAa=;=B-(bIKwqNn2nla5FQ&?8a-
zbabKsdPFLK9+3*5N2CJi5vc%rL@IzDkqV%r6FmS2Nh8n%(4z_g^r%7rJ*p5uk17Pv
zqY44^s6qfest`brDg@9GXdZxDq!DNW=;*{kydsTG^mHAa=;=B-(bIKwqNnTVL{Hbz
ziJq>b6Fpr=CwjV$PV{sgo#^TCiqtj)(6%9fwhaNaZ3v)kLjY|X0%+S1K--1@+BO8x
zw&4MIMQR%Y7^4Pf8~A9XaR|a;j2b+LF>3IDF>3IDF>3IDF>3IDF>3IDjzIJ3!Yk4!
zBLQ@DV(CQf7_qthhUn--pI%2Ndb*BI^mHAa=;=B-(bIKwqNnTVL{HbziJq>b6FnVX
zk=lj;+BO8xwjqGF4FR-m2%v340BsurXxk7#+lBzzHaq~YNNqy^9f2l*jzAMYN1zFy
zBhUoU5oiMF2s8n71eyRk0!;uNf#v~tMe5xG=;*{sydsTG^mHAa=;=B-(bIKwqNnTV
zL{HbziJq>b6Fpr=CwjV$PV{sgo#^TCiqtj)(6%9fwhaNaZ3v)kLjY|X0%+S1K--1@
z+BO8xw&4MIMQR%Y=m<0cbOf3JIs#1q9f2l*jzAMYN1zFyBhUoU5oiMF2s97CE7B+<
z0d#a?U%VoXPV{sgo#^R0I?>a0bfTy0=tNJ~(TSd}qZ2({M<;r^j!yJ+9i8au@QTzn
z1kko2fVK?*v~38WZ9@QU8vDKu4enpd-)(&=F_?=m<0qz$?-yBLQ@D;y}D2jZXA*9i8auIy%wQb#$Vq>*z#J
z*U^cduA>t@T}LN+x{gltbRC`O>F|owHU!YNA%M0G0kmxhplw3{Z5sk;+Ymt8h5*_&
z1kkqO0eD4f8v^JEGy!x3ngBWiO#mH%CV-AW6F^6x37{j;1ke#^0_X@d55OzZ2s8n7
zbmCCFB8^V;bRC`O={h>m({*&Br|alMPuJ0jp01-4JzYm9db*BI^mHAa=;`o^)HVdr
zwjqGF4FR-m2%v340BsurXxk7#+lBzzHU!YN;Q@F>Y8wLR2s8n71eyRk0!;uNfhK^C
zKodYmpb4NO&;-yCXaeX6G!MWl(kLSVbadiKydsTG^mHAa=;=B-(bIKwqNnTVL{Hbz
ziJq>b6Fpr=CwjV$PV{sgo#^TCiqtj)(6%9fwhaNaZ3v)kLjY|X0%+S1K--1@+BO8x
zw&4MIMQR%Y=m<0cbOf3JIs#1q9f2l*jzAMYN1zFyBhUoU5oiMF2s97CE7Axw0d#cY
zu6RWno#^R0I?>a0bfTy0=tNJ~(TSd}qZ2({M<;r^j!yJ+9i8auIy%wQ;T5TE2%v34
z0BsurXxk7#+lBzzHU!YNA%M0G0kmxhpl!ng@QTzn1kllm0_f;O0d#bt06IER03Dqu
zfR0WSKu0GEpraE7(9ww=fLEl^i2^V>F^z5YyLdV_*RRa#*j&>2+?yqbZ@pP`KJ;eM
z2S#izwvxyn(Kgp5t{3O
zp%I$vfRPcJ>wsM&G}i%p>P9=S6}-YOAojM?*keRFQkLH96+rLx3ZVCT1<-rF0_eS7
z0rXz40D7-i0KL~MfZppBz=%HdC5MBk=tDt_=tDt_=tDt_=tDt_=tDt_=tDt_=tDt_
z=tDt_=tDt_=tGadRa7jQAVw^iAVw^iAVw^iAVw^iAVw^iAVw^iAVw^iAVw^iAVw^i
zN8mInmP`;M`q1zH8GFGVF!q8yVC)6UR-#%IEj(cC1$)5Q3-*Aq7wiFJFW3XdUa$v@
z=tB>{Ym~(ZVpxnIhQ$bCSd1Ws#Ry_pj39=^2x3@_Acn;VVpxnv;5Eu(1TkXC1TkXC
z1TkXC1TkXC1TkXC1TkXC1TkXC1TkXC1TkXCJOZy#v1Ec6(T9G2Q12BZl#w4Hy;m%N
z-YXVB?-dK6_lgD3d&L6iyqbx=cBl=JfBl=JfBl=JfBl=JfBl=JfBl=JfBl=JfBl=Jf
zBl^%I@ER3;CBz111mDuAww%N*C8V-GS?xyR%EV2_Hco?X$SC{
zOi3}Xx#pI;%enPCOxBZgKA5(~E#2)~E+8&I#edPv8e}|`=3g4SCb-6TePu;pygWFW
zF4nz!w-3Bc0_f-juN(Z~E%%YEKR3nj=*=TKP#%cP^YT>W14Qz@mE`SowmF|o_R*VO
zCDCMmg2CGTMbf>Lq*~C|UnLFYd_zZ?u_*M&tE8cvM_nxq-Z9v}N}7waD@fBk%2$_*
z?`v$YtY*08S=DWgpNq0uc-2QwJHq=W&WZIE_#2iYk=lXo5oYB
z;d^#e7LPkE=CdQ*G2bpfHT2^-UcyxLllk$i_fd;JKgB~HD*gWH<_d0bk86Hq_y}Ao>j)1ca*Euz
zgK#)HWc^A8DS9u-AZ72DGf35YaXX-rd|)`N%HU~60cOW#_+YJ2*&Zcc0Bb%bLPvX)
zc!DV{9or*%*}YCqI!YJ3>>eS}%kB}vm)+A`Snph^P3zFnkxTIOp2+eDAJ|J}vEI2d
zk;-y($g*pl&s^KJ&R4EqoRL=bUSzjNi4j55ol)h@8T{}7Ptmyl7kC=411@{-x#bI`
zGyHsVPY>6ajum)rX)-DB10Q0I!#^5)7K;Z9FAQnmZ!_32FehG8{KE|#&E4P=Lwo>#
ztHHjWw%I=O!AwHocnyU4^`wTwI+jdyflDT9CsHf!Ao@k^^3*Wz9Ko-N9oL
zts9CghZJ~AqL~@i<(^HC!17)jDBu%qpCz&;sHMl~EM~{!{pGCp^NA$X`r+ov@uc@(
zHE_uR&rh-d2S5A&S70#A*?m3d>+#Wy|HPQNwTT8kxioj+B@4u3mkzva33jSD_@(Wj
z#?_I_ceyzB+1@je?4JE}O5s_|pH0k)AXNf%Zv&!2fbMIE^y&b7Y&#lo+EAoZ2H1O&
zg1C`_uOSW=-kZqv0|}@@@Ea_U3K9IjEx}$T!mmnd$O(2z5xswcF5p~VsRdq8nx*9d
z>Z%CXn+?p>5wPDkq)H_L{lcU)%+uErz#k866)$ve9#3yS#HSPwh&Mwm^cevHkNBM|
zR^VOK9A624ZM&9Q=F$G?db7prnXSpj5b_I#>5VR)4t7#9z!}9Hi<3A3=SLgf+l&^?uF(
zCX4kX8t>M{0Y7)pZ<#cs?X1#H}?)%j$*UWTuLH3qQdOTo`I6g%7kur%KCW#wP6
z@^^18f30C2m~NHrYKzbNc)G>FIk7wtQMjo^E_xG-Tw+3R2&sBwi`?&hjYS?{sAmWn
zVzI>_k1%pG$h(-H800;SlG`zZYh9KS+hKPz=|%Xca#L03MH!7fS~*qthGvkyAHM1s
z&_CC-A!aj)
zRXb_hL#S|V4&oADq{EVvZW#Q$>iwjFz~X^C%|KxCKz=;V$Vr>R<^f$am{6lYe%?T+
zLfLz|fl!6A_hSY^70TXED#M4xmZqpDuy`MICsKQSA8TUMpwu73>sIb#JHpEedcn%E}4r^N&rMBP@sxV4z
z!Sg`cD76KLI9nK{w%{PDFiLH~i$g;UQ(JHdRT!qW;CUcznA(CvoC?F#792zshN&%h
zaZq89+JZxh(Dm*1=F;bbTcOMh;
zeZ=RO7?mjzgJj9{{ls1J%9L0ywHT>PiMfe|`QGAgCPrlnd{az5$Sm;P%GOMQhdC`q
zDpO#TZ(&qsr+0S~qcS^a3X=~qckpq|Dzk(4LoG%sv(vj@j2*T%GeQX?KEbHWD7BfI
z4>Cuo%?RdfW|Z2DfK+Cb+Dt9f^(BeT2u5Xwsm;`UkU7LKBB~j|oHE1IW(1@%!_;PK
zp{`d+Y(_9D!*PgJYc$|NYBQlSgVbgMWd^Cu1j_VNn+cTRU@50eKed@qnSN?BfiivA
zO!z@8r(Ad1Y{%#xC7f>vz+wHzEZ_{l
zpBj2i#+3Ct76Ol(Mawz0ViU3i&pkI9yIszB5(mB9Cl}3&ZH=T}>W?wzgcfoJo+m{g
zeUV0`=h&SM#{)IQej*u#))1NE$s&tud#G{(ZsxcBn3f#(M&SO_`6R#{Sw`!&mNq%8Zw@}X3N`N3*F
z;dk)}i&o}2y|GQ`*15R_|d!YxU^kX>a@e+c<1rekt9ZQH`oYI$P=*`Z0pP%+-AStpnDo8gr`yH}%f&HmGdc(Xj=W8P^8*v$EXD--y+5#lLGP_LFvKv&6gBF-
z#Rhh#B*)a3n-ZN~D
zy>MkDkjXLZJ>LdKz317$ZaBdU
z^Vkc+e?kDQ|D8!~iCTzq{*Da7J7(insd;$Itc~!VSsUR^vo^xJW^IJG&Dsd>o3#<%
zINOZHTpesMk7b|_{_a4%EXX^tvLG+U%7VNdD+}_9tSrcTva%pA%gTbhF)Iu5+N>qvE06M`tvt%xwwj$f
zS63^HKVe5fz+Ou(dWTl(vUgyStKQrq_YnwTWH|`;I@>IV;a+D;9))|IEqOQG>ukw;
z*z1f(5U!N4g?pIv0^@8eeTiwhMX!3FYtp&SW~Cp58=kG2#W39P4Cq`|wdCxE8=gV>
zy>K~oz8r53&lv~293$v*as@+y`$@3hJrsDpbGAW5bw`2%2~N8blt{4cN>CxerYk`o
z3D#W+21syYSAroDthy46kl>^%!7dUUcO}?Ef}>lmmzun%uE~N``9+;6SeFmzOu@>$
ze`gBT=7r7_tj_B@Q?NdRRsFUstMwc<)4Qep7`5190wmZsZILOFpJ~@XS_IKahz9x+
z3z|CU!M9wH8vTNnYyZl2wsSt7PI1(P;cuBFWs~IXt-E+B7#+_LvlvV<8~O(He@GQV
z`m^;45m>!X8PMurOz1u)0d#~D{7?oddOw&!%H9uTkgE6n8KmEPyn*mS9CV(`qnOLJ31|#;6Uj*22o*-E4jqMtdXE|AM
zEe3xb94rPWu*>k*)4s)XV}Ij(IlF|~A9N?+ae`)jE6hM7U@@TC#))8F%kt@VNDyLY
z(*uknVOmM|?^Sy&To-#baF-9Hok^5nx_m*m`%<{bb-oJF9103DT^A2%ZFprLKuqTi1_Wrp8-9x`bYDGPQ
zX8K?jEAZiK$4a6l_}K72Wpeq3HyYP-VOQ=`7N0cyeRK4gYN2eARi~
z@IP;Y((unWL239`S|xN1|71&3Y50G%FlqRY=!UO?hQF0=_^NIAuhI?Qmxez!A=mH^
z)r9~T8$O71sH@Z?X!!T*LI_s$-e*c=!~dkov2o`u@2z{JnGw^&5|W
zmIc-gZ+r*(n8Nz5{&_i0cJ;qumC!Z(lPpc8;Xh_!((r$!8@?Yjd`~xgzis%vRPYwx
zcuf5_vu!ktblq=@p&1{Q$_>y0`#H%6CO}K<>EzK0`#MRJ3Gd-@il9cD6Bu;*z7Dj&
z_#@9-;vT*=({`MN_#jfYqGpJU0mw@omC`{L9MUtKnomdHL62+%ifg^
zwCY{9j0zQvRa%5A8ge}boxZ*UEwEse=Pj{ym`5v=)-rV5mw^G?Z7oiWP=P_G@9aRi
z1*hb?#X355IQtX3s4>Vj+_pgr%WWI9gxjjJHfV({Sz9MM_3bm9-l+|@b#jRomfJRH
z3AeR%B5$R?Qd@UQ-Z}M0EY8NM4Y%b%adJW@!)+V1gxeZA32%j!dgas{g?gv{UhQ`c
zh}JW_wuL#IR$kk}CA_u+uJCC#8c>}2Z>=IVPHng?#+5MU$rX0jlv7uYQ-6>4y9Pw-8D87MoGK}=
zZQ&AL+W}X-KeH-JoceF9A~jBJxGm-rwNo2z+n}X2Bx=wKLn6bdyyN1;fnCjX+a1eo
zT@!hyHpUhWT3Ta^2CdLZ89Iqmt10z%4P&jp)ZcDt+&Fb`>4KjpZPysPd#4W9OXW*l
zV<@ZfwQbPCa@z(itr1OwR_Gd4SshBJzMU>jjX@{FZ5y<(+_pi>-gk9Kt}xy)bP}ij
zu*KOpwc)n?)~OA*ZO{^KtE{a-E3APkr{?U@f2qG)`&|Q~rVOubVNQdU*S2s8ukC;<
z9I`PgOPu46kKP_tST%1AqRf`#G%zo;?%?LF
z)*Udfw$^2K!s%DPmgDt)WjRjG3%{})r-4g2PDU{bufpSVL5+Fi$F8`=>p|3*W5EXE!)*W$`wCWqomKUO2qvI1OBypWz0s@EOk37$#3R
zQf4XE_?7j=X{JZ^0JVYb0cr!=15_A-pIyDgRIKr<&+mc@oC=7`yqaJYbtOBcVH`A9
zO+4s=mL8F8y?Th-)xmA&u6acwww<4l%v&1-KKjutR`foS?3z2inF}xqZqREp+fJ5i
zghs}bWXD7VnSCUS6s|J#62Q>zV5mlzH0ASm+kJXrKzmIq5*D5Atxjr}}Rs{_#4&%e|51Bmt$oNKI`
zloDY-Mw5EPZc@S6q^edbJfXkS4YPPS1U6v&sd4anQi*H{f*+mB%)u7+0|sA8Ik
z=PY}_s>Svj`?*=G1JK#e!?pbYqWuJ?U+X5NMA(nfq#i+48ciw~n^e_GU+m|^Qp4HL
z59qe;*Y;!dBZ3u{jR;o4MwI;sR^fKX_IQBwKfqu=Z?UxZ_G1`{<3XbtM&cp9C~Z`S
zx1YWRdHZ>U)zG#57$)Ls*x8S1BDMXzG&mZx@MJkHaj{K?-@&M+XLcvxMgE-U4D@)^@ytbMaH}P7Ej4d7lMJ2tx6X*H2F8(s_
zi%x!(_eF>I^S1*Rf)Pflx+ij3u&b$XGCRZXU{sUUkF@+4-dX)fkf1dC
zksv{3_9H=pzS)li2?pp#I!iIceZidxM!3^B<7@E63ZYsVTO^7~vcBqGLE=T;7af0@
z_eF|KJItO@H-gQWQ|8!et4NR9tjeZW{y
zzUc6N-WMG{$orzhhk0Lg_z1q3)XsRj#m4&MKx!90!oy67i`Dx1+1YJU+lye-&v$euV6<~$y|IK6
zSB7;asBkq`XM#Si=ju!_z!hDc35K|)t24nUyyn$U;_Fhdt0}R}kl}YQs!4UX5kI_4
zb+>VXQg^p;f=YL{ae}_?ZsP<4bhn+Q7~;Z_&IBWMY-`nI!P(hK&KBXRoSpr4Ctl=z
z(eamgUvzkt_eF>I^SV2Eq~Iune-+nJl5$Vp&VQ{h&k48Ma>O={Q%`)m2p
z6RBZaoPbvqb!NdEi#ikV;-bz31N0-E35GZn*_mLZPLr`G^2Oxr>?mi8@Knyutgm{*
zjXKKuqT}by-WgwTIPd4~!g-B$7e2`QqLV+&`=Y}~@I~DdVNc)nM14E~sB>>n)Q+Wn
zix;N$Enb@1w|Hf0-{O6eD2@(`$
zKN2J;&3+_EP?`Nmkf3k&BSC@z`Vs9xL4qN!5$#Mc!d0TW!*&wb)$lo#48Ma>O;$hB
z^25ulek4dxn*B(SpfdZBAVJ^kM}hi9zI}DfHRK(rW3C}OROjVFbcBO9NjQto*Y`RvO1&)r
zQ5$#ff(uMg5?>9uOI)AY0dr8%0rzorVh21xN6-NevCrHAkFc|AR*LUqUTO2zJUKyaU1X8t3QzoKHD)kn<^r4s$-`&=GtpjtD_;24WuYmm^gTxzL~rpN__?
z4p5GB+{S>*z}?>+T)f`2odV%&ckF@-oczj)E^u{wR&)W;!Ktw{=K^2E+vi1>;lY`d
zm$U2O;EaZOa3-sD6`mbPc{yAT&JJjpX9u#P`(gNW%FFLx5I(J8hEHcj5AafDwyp;d
z9fV$|q6et!Yx1IpcrGF3lk>
z8G$M3bjf#i;zjQr9n$$eR9-s0@*SOcffrfwy7P^wymUI|pLF7U)+H~U4?*Rn(>MRP
z6EE;KOkVl`^NYN6y5}Et;svg=ZoYx8-A)jHi7xzP3*KMJVny#IS*+~+au%z4FV159
z-ixx>Abce-(Q}B~lXGPl;f0YLwi`YwpUB(`@25;KxYFa2?xC$TJoxdwd9cJhC+=7R
zPTs$h1^c)VAPWv~A3$>xyw`TKn$7qrK5_rRiwgI;<^FQB`MvBEXz!<9HBHg`(W~TC
z;Lu8UPV5bS^r~qJM67j}i9v7OIk9JW%2m@a^sPIm3P%FFb7C*?BUepRAois@r#`}G
zx^rTW@#L$fVGvDsP6Hep>CTD0$CIv_rob+GcTPiW#CPY!Z~YHnH4V4pyK@?0{??t-
z2su6Rs%Z*rGY9DP8)&HsKDMq
z{5e~luBLc#f`9pajYrrahz$O`3+82wS<(DDXGPQAKG+5G%DAj(e%rI6XGU|ye-)tcjqtY}(JaP>~AHN#r|EH9d)lB{Uj$)9z>1+MMM
zYCS~2L{>DvCV$!m7rpo9MUN0_krmC)$9ubAzH^e*dKa6kS<(Dnyr&B;@OnsA^d7cl
zv!eNdxTOm&@Mv;8#|Uf_pM^;>hlo%J|FurMz|{nK=>?wBif1sPbh_j#I`IMrAM?^n
zoSDo^r&qqb6X(gvyz~kWd*!9mF<;h+^ITnCdcXIG4sQD9f9=Ez9L&p0AK>BcyzX?*
zU+u(;-b>q)Jg#S0p#SE7JLqGZ>&hdfKo@Bvyu{E(Ds)gb(ntSdBZKhK#Ylr;_~>GU
zjKW73BV-r8W#_YpJ<4WjG~$8N?B}2YHksinVNe;Uf;D8IKAJKE4SEkxIt`g{`i2S~
zU3BUPAXjwa?j``aAd>~To{|N*9FhgOnvn&E;iHSGwj&%_&vNeKKuZ?f3-9<%#iAK^
z6CVm{0dxIP2g*~rvHyj><-W&Fc=6%Cz75yi|Q!%~Pp9tw#E)PpgrE>eFgu
z2p^1lyBZn60c~U#-e)6wa6PMfoNJ{WTAdO6%5Fe#m6-+vRAm|vP(RavfCgy5<~02w
z--*QohKpmo#}qs-S<|OS;~CEHHmms!9kuV(;uW5T7A}m7I^$u>A_8GtS~G3
zczJMw)%2#$>%2%uK2OacTsd#v9j3nc&
z?X|QqUM+p0Ca+F5*k@>bqfSj#pQCdfFK5X0lN#8Z@onF?rt09{j`i$D%*Glc@ELeI
z?DG{FgbNEcPl?*FkqT3C8|h;@Z6gCrq?6Xg^(R}r)r;FQf_DXLwENrz7TH7%?exCP28!O7
z+CbTRkPTFLtJ%z>k1v4<40;c=fgw&@n;auNfo%f2I2maIdwB4=`3!~iLWI2lg&QvUWojSRK83dK6XzLr0;L%
zIMf&wL6T!^JTtD<2jas
zBmbxHlS^wXuS7mWGP(tde{O7+PMgKi?BsNdXvN76=0VORudvIrhWf4ehKk^bw0oeEtd;!X~9vf(i@!RKH^n){OJ~#E=rpJ@0*CaYKizz=#uTRQPU^U@$
zu-{=I(;1Pp&d76VL*yod=g=YlPoltP4JHiW@HLHV(*c+E*I~qxE6P5dV1Kf|Je`Ht
z$A{R#dWIssDydFkT+gQ1>Wr&rfsmUeUTy!pLF{6gl?1MHJO6z(sZ^7zaK6yha3_KuJ&t@
zOMDh~gX)W2%X4`wm|}VDA5Z0BB+p8imINjzm^2-Sr!!in$?}x`@=NV5i(qGmtdO(A
z4IWY6gu65;z9Js%p4Ipz$A8K5KS0Z`amW89?FXyY?IJb5==|b~+ik-b^_~&zNX9UI
zBiQQ^a5aZy3^9Vac+EC;wRMa+1^l4-gbF%!pE2*LmC{I1uhCz%tBo-;HF|Q6cf4F3
zj`1LS+-)u&zfXnt=OxzsGEjjfjArAtF3fx%H*rqzcN#s=*~0ip0mg8lRO*uM&{cTG
zG+;gUyvOL#4pmLjsLr4=`?P=7ih0!6)Jt{N9%fBV+v8Yu)*fUAEY>~RFX;*yqMDYg
z=?0^|=DRE86&`O2KgU9zoSn`wQcF`$Hv4nTY*O+H-i#4aGlZ#SS~#FDXP5YLdIsX{^cjdZ(`O*wN}qxHxL7*_4KOsyKtqgIqRlH*aFf<=G(eq@wIRl{U;gsnguF{i?e1pM-2y#Gy
zQ0dgH=0}^&8a1To3(|D~R&MqfjP_jy_>$36g2`7+rl&kCk&e`Gl@kP##MJ=$J|;~&
zI{EDEbcHFOk$i?)Xoj+Nrl|e(^h!9vuMuq70C+}Xh{%{VP3VIff(be3y*i`y?0`&@
zR^#=A>tyGLo5jg7mLZ!4ZRunP-VtvB%xjJ?Gi$!;F@k3O-&w4{_$S9#;-bSGR^e*0
z9M;FRWQO`&tNg>Zl3FDJK*wPFKZc5M`#*+Cv|-aT#84G3`ovHlc9r28pcl?S!|*Ef
zSl|e|=#3jR&T!MZZB?xrp@CsEB0E?2c
zzEU-vhsgFGi)}NeQ3k6*Qb@1?BHLSIkpS@cIlOhbJPMD#kT1m0?vwT-uTTb0HG?IE
zGWaQvGI%MEGWaNuGI%Jm?m*|`@UTsy6T8s7#>dzb$ZLFzZMeL~$GG`CukrCYV`OsW
zIX-8YOdcJ=Rr2Tv-jYXm;V`+HV#k}~T%o4&rCp(>@}so~<{xgW1e$H|o=Ni+4e8MBF&TuRSCP#~DL4H1;R~0;X6Q9-
zjQYL8sENbXdKNAMHVP7ehQa0XF%(@cA4AdQ@-b9}QB5&4U0h;Jc+~W+*iI9mC2n@g
zqr7b;kM3d-vYDjme1};5%EQAxPL(u~lA62R#i%onmxCdqk@NTf+v*=Q3}J;9;2p2J
zK^=m|`Ain$yd=jLJ(<;%#>;e#5L|(vVcyZEtE%Ddhj$!k?p=KEbxkzf#Smf2+F6M6
zGF!VujN#3dwnR7isVrag$Wf#$mfmTOxuQBay6r)8N7p%Mco#?1?V9j;4-t{Adz$rj
zLWlk0cIMtl_7LjgnR$?xmp8FkDJL&3&w{+PJPY!|@_0DQ4)bVo621D<>Y`&{#?RU#jMgLsCgM5scjEv$y`5ea}qt?k&VD$wA{P()zd?QV8&5CLXUyup*>J;S5
zk%3r@33l=nmoEkL$~V#k>vIx8Sr1TH)KJj19
z^ACu>IFApBzbKE7h`%tYfFS?E6(G1-GA&@?N)X%#rxLg#d{0J&GlUCJg`dpeo7KW;
zkgEdVPJtK4^WUb5Pd5l_a}s)8DV&Vp4#TJrrx4)^k@|97PfXw%Vx1`k!ZDmL1{a$|
zIRJM$23M1$xYIDWTqMFL<6|fPwVC{ZJNdtxbR~5GufOAnew-bxGIqrJ
z*<}X7WyhjF)xvi6;>hW*9i_n?|1YUF^tfwfCqcJzkit1b@RDkz19mQ`;=idX^a3{1
z#R>6e=kV3SDWDBi_*V;OLodt}VRL1}88UMCSSANl(jM_&RJH7LU?uJ_L2yxQR6-_j
zIzBFw1Dwg3@qfwVt_pR3CuJP_ItXrRjTGSKBNcpJJpF*PHg!~>GfO+`VuoE(H?Y8F
z&V%#tKHx9U!wi`DvOLV4qA$(E3>|q;9%i8Cm*imtlwqQmE!ZL82j<}g;4jL
z9%jtK{gWEUaE+CUAq2oTCI%(o{zb%VjE|7uY3+R!u03n+$r0Zt_Gx}E9!7E)!W=jX
zfrMYkq9xGaPO?zG8-W1cB<3ih{rCg;hZC2Ia6~m8r|YM+ax#KpioN!>gir;aVzpf%
z$=}*l%t6iu@I7n^4nAG3*oMK)Qj!Tu?}tG^pQ!4{p&SGO4elrmc{v0E8r<9$q8Q)+
z{4J%p6YPdJfbXgDt*8|TH$cBDLGj5TioS#`_x)KEGN4s7wctltc>6%VFN+RxDMTK?~4l
zW>HE`*0}1n!hi+f^OIgpN`&DGz>eCWjRe=AMwQ8-3gBeU%ukeIA9jsXhueohueD%H_S-r!|R{3n~2V;i84&Y&3C0M)kZw1Vx@
zEA;r@qi$3K{C92H9Mb>|t`?ETaNKT01NcB0b^}whxhcdGIvQn
z)RpAGCHc#)B!@1^Uvwo|xFmnxmE;DOvAQRjT=un
zA;A@HvATY|@nbEQ;t{zN9B;W4_sgZ=n9HTuRrV*jVBF;re4i?iByeLdm*kx)
z7iS56{N+-VNeX=BNcUqfmtwCYg}1BSjud?-BMC9!hqlRO;8F}bWDH%3K}U*_OVLj%
zB+RAo=6h{d5?`8Yx{~DNqfvTD=t2{Bp=L`h+{aH;+r~B_%c7bBZb%X8*?c*o^!dZJ5u;uZcH4f
zDGbJSPQ=&e5@2lS5_Hy>x3%|oRqC#j@;;@h)6XwRxfI&9+7wYkO@+dA!?H9VvX%=pMK(F@}jw
zk$FxAhl(ymaL)+KyN{JH?AS7D@(J5XwW?F~T!77a|Ha
zvn667qm6$j&_md6er_HtFztw9IciQ=-IEPu-|ZYdG1>D*{4n-EQRLt(HkF@vfF-^u
z*%St{KDsmy&}P1MT({AX-=*Mzt9Wl3
zdC3mO9IwVGZ0Q%)=i%MkR3AI245~Pp;&N^TlSXagu?3DUZD%VSPK_1~J-9(Q!g$K|
z{Aiq~z>to1d3$V=eqY{2VflX^;jl|{7cI5YDPR=OxoVmMlg_KjDKYiDTAB(E2wW{q
zA1?u1EzJN|`lrE=h)4)ZehlyFPH`g^lDku^;hbp-Y??>8BqK=FZ=B*r7-+YQH6A^Q
zQcNcogDeo(bR$;8b19IUOOXt90vSHV8hS)KlywTg#h8&gAI#&pYi5FbBcheQnjbwi
zqiU9cQy(8N?%yv=ezrX*4+7~3n)p}{6AB_c%$-HpRpiMGr~8f+c|-EU6?rnl#U2NW
zydilM=&|L&>GRbQ){mM~{OBP`Jlw*k+JM!X2qy`%YsdwHCzOa&$WtF)2S-GPi9L9-vIkFA_Tb612bJL|c6lS^n3g3>EX|XP)Y3e;
zgk(cVg`r1eB1nBUJq@o1prLsxvJ9>V2|R~DIfi5sc;bhkm~
z+n!Oopr@Uj%);w?SkIv1jkzVNqYYJT$x!8$Hc;R}yHq@n`#&T0XqPGF-%6$4$6Z3d
zs#0%G_lrXuzK{9^NWqC!&Z~_j;#_tm=;%+qv(EKnSO)l5vA(p5S8(_Is+8pY>rLg
zsJWN{%K#*}Rjtkg$QVd)M<)@Cz%Zb}Iq=1$^Kp3fX9{vO6{!amTvg(Fl1K|Q;9{R^
zsl4hds>%jIG;Y-LQ0)lE=#MrR`-rlL3`U?cH=#+qQ809{uQcVkPBx5cMtK_^^z7Hi
z>ebLGdMr!5DLdRSG&c~(55@g*TqW)~$Ox>Wfb3Qvs-g;y-m*1BKa4(KZYquuXn4@E
z1wGUYj;p90G$9lMTj;qAgL>Yk=ZG_mT4Xxvp$0RdtxqB$m_FwB}SAvnN@g!
zOek}6vB0#>YBG#{UuagN8~@%d2Nj5_w<_O_gYRnRbc&a_OdeK7MjVaft~ss}%O@Fu
zRkVsD)`l*|^%oD)6$r@p7q8d4vuD~`4(}WSv^!)jt9u~7r~W#wY>mBe-Yg17y#%m3n{uk_YfW2st5EJFEi`G^%q8`
zKyfq)qf_uuX>|%7st}lD)w%00zD)NQ;9`Gac(6xo4;IYyV8Q6Ys&{hODUKj0-}VS{
zGx`L<3ad{LtVExXlUZRLmZ_2=y!I@x0Q47z7b7p%Ul?BOA=8UJL@&0CV{?kpkfq&*
z{e{sfP#lfJ=oCCuW;z9MRXDpFjl9lq5gqTRdq_Nj#xXN2wj#)VT~mJwGA#1i4d-HMgCFC!k0F<(j?&F
zBACU&BHFT8#)oBixcXsB;{u3oK)6KGy*Y)QLj)IWHu?f65DBE~(S1CFd!Sp6Q}lR7
zdX~==#Nz#^%~9gbLsL|RCkms{`gSABE$>UKqgilSW{?7>z>+Eyo)Sl~lPUy)Nol(B
z#mtXRvGSED>&Phgb8UbdOD0E&T?G@Uu$7=S!WVzfNblwcFSdaKVT*>KQ!HZXjNQ!O
zMK(}iNM>@B=zC3|LRXozo%B?1j2SSW!cq<9%e^-=FQa52K8uop_$EpQ8irTe)8$$XN8y$BF|-SV
zZMR9-X^(ju+;}-&AK{u=clq`Qf{nN)1s0W#xjGU&QRe*Iv2U?p;o;ypxERKbTi9WE
zXRtrgiU#*;jqA9JV0T5KXp-l5;(R~7-9e1_ai1&J=i42`6ol*#cfnk(Z#Q;gZr;Pa
zlT(bhbVK;_I`IOXLc8sxq~r7PocO!#+l-ZtrIgp?Ff84Lf%cKyV!J-TO)Sx9pp{z8
za7#*5TW%ss*TnVj7cr0sk4ivr0;9zJAaKPJU{tKtZq+*xCxG+HVLvEXIe
zDY0B*N}3X@HO8GOvA@QMGbIkz7;C1);TogNlsH=B+KZI9yT%O=DRFO&8``7wTq=(u
zy-!n7ra#kE6zWek6{UKwrlMHy(NvV{7EMLL-mR%9*}F6qMSG{FqHOPIKS2bs2nv2@9xU)B)k+?n9G~DC
z?xtUE^g!cJ*NaOSsx{-&2E#v~NbmqqgCNowNbsOwgB+h=89cnMq(P1*7YW_NP~Af)
z*N@~uz6P%ASU5|plV`ySuVpubK~bkXpKlMbKbjWW(V@sUW{?6e7^O`Hp84_=_n!yX
z^EKJ*@bcLh8esc9E^wpau=nvCGz#xw4g_xa
zyuzmwr|<#^q0qszlL;S+{mpq!UbPeZS|GNg_HaXn|2q>;oZhiQ!Hjt_uY!=>{=qiLDd(Y{N!3x(JtYMUz8c=O9QUR@5=&vByU3xR=aZ1sSA32l*qWHnY^y7bQ(8%&w+ho;0OkzP4_%#Y&Cc-$td@?vd0Q7Vmh%AGeFP
z<-|dO^VP{2V+zjJlP$hnpKWLHJVp?ssM&Ap#0wa7>qX?BEZv(0OE(^SMo!hxHzQ?lz
z7k(3*4-c3R&*l?6D-}-d9XehkDi)V4V9{bXE$h*g(BgPHyNq5esX>5e;{{%O+pOR|
ztr@!F1R#p@p)Qy=xwnJzkb8k)-di%+;w;J(H~O?+#F`N=fbc$vFG&mnVrN
zdb6PtUSv9&a(K1G<4i>F1t}^F5Os=vkRrOk)M+|Jm^Ivyp2~lP
z*GYLCFPbdq4M0TDyj(i#6g#V&qvXh&?~42AAd0bj?oT
z-8QzFp^$GfFjfKi{?gENv)y+OD`H3=*So6#gp`u;uM=ArWyX^&wu;-&dRssumkeZm
znaE{BkL~68Vt#Ts!wm_#mDV1d<1Q4fr01L?N>XE
zUY?FI2D-+mleLF#XFz1fBffVsO6NLPR`UxIuW=7Vi49ILIf{LXXlAyx+#t+XtaK7h=h*yCWpAdF@MaNLdjirgv0|tbyeXnJ
zsx5VbAdUY++ndKpdR2Afl}Pr?mQ40NAqx;->Z$5w0GC?3Yo@kTRZpjhp{VJunQ5k{
zds5w<%n(3!!lo|>yzqMw1Ox>6y?}}!i0F%K5kyfIM`2(b#$~#20M=@M#HPY7Kz@Ed-YB
z0r0kvY^p^7e`%0hvz6?a@>L;4?x%o<{(DW=JeGl>q+w5M0eB
zfd6JlY&oF-{Iw8R&M5%@a|kS_6@b4U0?U~N;P@6-)|w_4Kp!2_n3!JxjgM!h6}=qL
ze5lr{p9B7}*yf04UKkwv{L4$F6*rnkEP%_i`4-
zPsBAq#WXAEV(UH$V#opTr><&Xw%|;o8T1ZcDS2QqhVLMq(%+h9yDgtby-AF@&th
zram=>(w`<2y`LT;y~>)AEaniQ+bd%ZH;bnSMbUpc7M{iK&77|-dK@n4J}mRi#KP&)
za4nHJpeX$B$HKF?^L3g-X%)W|o!smhEWrSy6G`8rL=OOrF2StS^-|k_wU8*#de373
zxa7i6d$=_%~TvpETW%)C-9;4BH9nZ#i4$L3J#)JGyf*ypC9WN~9?+CXq=H{kV9E}cNk4m&@Rlu|;o1ideb
zHX`T?lAt+)KHn3KI5%oFgj2vD@@RU7)o+bx3I%b&&9D$)%=XxlX8ZKJC-aW6@GK^Z
zar6;3%H!ZUgiMI*-zgt49$?Z*K`G*?R|-lA31U-F%2?P_P-tFHL8;_uGjRLDuvwDmzl)I(VPtnqB@|=rl<}m
zwRF|(!{~_HYMjo!ht&J5RGcENOVaq1;J1^8Q-;wa4W|NQY#L5A^R!f)88{iG@tK8j
zHVvl+2c9&XeYjp8i-RL)Ax($CDW>TVIHfcl0;im&L*P`>bO@Yknht?8lcq!9%%^IovOdMabi^`dEYsnEAtPtz@9KPU`0drT?T$OYZQo$+Po_{~4E;@G8=m(uxT_
z=MWKUMyed$@{xTZHFJONe1$;RS$Rf^gtN?h|meAd-`+rd|eTOTz
z<0akQJ6r@c};Woj($$pqN3Pq`ewK%G}_8Z`Hb41jUQ#
zBI?ukCf?+Fi~xvGg%Cm1#B<#cLC$v6P;~&K964%)2=a($<9w%NxBV`(^pNqLAV%st
z)YMLZP`Fa%Im?%(Hv@knM_*KGk&KqkKrfXV3bEYz?W#o$4BUVm
ztx`k^NvJenSyVcSF2XC>u#8a1Vu-9(%C@^D%m~_1$OtK55XMTr=t0Rq9O!wVrTgB1
zpacQWD-vN8|1pVL^t&|Wjwg~8OL5)eqTD-q^IW>q!E-mjEHr+$*(ml%Xj-3!S9
zs)qgk#^Fbu`n-@FL4ysP$795+QjW&JS^gM^@bZLU
z5N2ZxG>fBWpyz>>?vw+95(GR0eVI$7F>pyD9X(V`;+cb2d=QqW8lD-h1HmATm5kLi
zZLP%6EDp}W8s_QJHe4drFrgNCs$oJc0E-f9QAKpj-R{=B1Yc}g%IUF*vu9U;HeRU3
zWET`oZ+ECjnr%DoiqHnrM3v09f~7=lq?rhn5}}mWCqUXr9}p5bSAl185YUbv@T9~!
zloC4uXh<7A{UK)giXGbCs${;6Lw=|(dFbWkvC}yocu-WClKYu@6!o}*`?=6TSU-5q
z$FSLh9SOC5F)k->(mGk3`eGI6(CpoztRry%9_*GnIYc&z1Mp6_)X5`-k+YjDmJzz6
zjD2Iqt+D!!K71?zlEveBM@yO}!n64>B!_pMVMrdH{b9(2ol1h5NtZK;SSw+gDFj+^
z6u>m}s26UD&g`fGsOfb{pe&9#KD$;IuUK9m26V6y_Z3~-Pj9|L-`jXO?td@9cm3SJ
z_XfWI)a_c7v#(q%*fGUOSMoC|cghu10kU}a>QqeuB0EQg%_;{gPLLuGYmI)PV<_q{
zGX(G{uEnRrfGpl~2PvYA6^O$s0kh&K!xVXh6Lncpss}vGDZ*0d^qm%E*382Ny^T~n
z&Wvs#5c&5LVOcm_I$aBN2y>8SmOn6WKuB&21fGk@z$}!fb;?;g=~)i86psmf#wNr{
zMW(SaH|{Z=NPli2``O>FVa-9qcT5B4>Pl}!$C>QTetwXBDr?*Cy)m4A57t2^h
zbZ^(+OE9f{KF(e|33`Hgz#-6!m`N#VNOd$=+*n>)MU*EUn!v?q3|2Rm*VhMlR~V}j
zy%*>f_v8J30MMDA!x1bdBvC+Xmeop>Mc)yU>@3qa%y&{J>_Gn#g2`uHpE5ns(Dh27
zy2tb=3&KyntQ<84)TW|NhQx;H?mt5HY-3mW(NOvG1x!{O@#dhKHt-@UpqM#|4WtKv
zk%?a3Pumt=1&SzJ65^riVQ2v8B6ZwfdfcKuAgJQrFj0wKjs)28J4!2EjVXv8m0`{d
z6ol9)xZAKE;v1rF4-pltlteBB1KLVS6ob)gus~t;S`&rc;5QK5cu-yIMWEuB>(>yq
zz+QrF2!b+O!S)PfmJ`|B;_E2aZx*mPK0O5K(u+weV4-1$d9-7n@Eu4Gy~k^dT)#t^
zs;mS-h6dx`i6G@bpoMGwA(ZR4niYgv$b2?l)JzZ0!e|Tji*YIiK|8%85k_x>^dcYx
z(RB1aC<#VygOXr*nBkIO6Sg5PR^Fs-lZwHn;4T%Ly;#nf9)jHHsIQa<7T0zCo*i3N
zf82wzwb4+2&7xHQYlQOruQ?bP{I7YOvi+|UFk|~)C$Zw_IYr3;sS7aq$FLE_Y91*9
z^r|SZ>FXZ!tH9^1eYa?^BjoQ1VCQht7WkaU`|QBy379kkpDDb#?)#?5@=ULYkRW;j
za3K`qH~~b_jbrLTg)8&5%uiz9u{*%$D%KnA8d@&SG)i;*8bTD6EB$ii0RD;Bk_qsR
zfd8(!D3#2dId+7ADg3e3`}$59^)nyhZdUU;sP2ZUOM&8PN7ukbJQ8@@q=L?
z;QSK%cg$)Zf@5e~;f{hBWMQ~bM)tW%Vib_;yBr8Y)yEuFy6&u@oF^LG2X*ZJw_ILQ=r&dRKotRfv9TK*c^1|xoHH@kVEjCGy-VK
zA$ay!(MyFUM50btPs5XKwSR0AKou3Ki+>o)5DJh5=hN_}g@BJv!`mzHZXGKimAgkE
zo}P**B|Oc{c$MBP;VGVx^LoRMO=1Yj4czkTRndH}wM#8H_Xb+8Q^q_VpeVGF-qA`i
zV|W$oXm7oU+TZ(l&hW$#vtqqJjSM$|VgSi!UYG#MVuKYBxm>aXwip3$JhTF~nD01F
zUgD{}ip9NCz~MPA6agqF=W~LPF4BZr8CPT>M1!EERXcr=1!|Y7c+Ich8Mu&sab<1s
zXkldqqw9J(mtG!2sjiLg8H|<)>Bdu!l}I;-k=ldx_2E)sX=zklUfCFqY;&$fQLL6>
zfDTo@U1*^4@dl((fuLk2*Ul&OsH)B02+8B$7|cF)c-X91pg
z8=Mz!@Ouo=AkU2D_-+va(r+xUZm#F;*i9jXXd21Nydff(3l`aY9yg+6QKE@SOhEA(
zQ?=&W=V+l@{`^zI?Tg-p2jDdv
zvf|RhD#l|C6M3Ap-RPBY_?QR0-N6{uCtb-}!e?m6=}e)E?ekU1fe4yQ>^
z(UDN}JHiks`gOjdiG~#YB)?7)WGQ;LUnd8N>eTR6sBkPre>nw9DEdpuLK#KxOcqKj
zy5_5rg@U4^S*XS9(UDYiMA5W7MdyT~e*oHX3yHtLKG4xs!4FEt-r5McaZS@FQoBvI23-02;i
zwR_0YM+JAuccbajGLUxwUBrkZUvNh+7PtcFzq@*|ptbe^atphB9Ks|JEK4P6#o~Z}
zwkp8*J$L_YFz~N-_W+!7-V>;wr~(GdqY~>^=zzPGu|b#5x+!$#aG*+19Ku^8HhKcE
z+nd7by=WF<~tr8d@yjl?U5_SF9zr^k<&)*0gtZN#bnm)
zwVPdBCOTU$E{}mo#_;?A;p`ms9K7Jk1{7NtK;rx2K*y0_aQ;F-S{xL6Sdo6{3q(iH
zUJr?~toWp=wdm{#SRDoWTIF8QLs-~H_)IDNA~e^En-j=A0uw_4P7<$imrV(&;(Ywn
zAOu+waKYg$!jh&_ZsR)JIW-taKU*9QHZX@I!6Sx0DG{D$_%A2Irx|{`I~MKoCmG@9
zM1-7>;1TW;ZE?t-Xp_B&*&I&664ERht2i~K$15vjic-*|Wcd^{7#2yz)@?z!&`1dP
z6L;yA!c~j#&~Qelk{Z{oumU)fum$R8;qds4WN-wq75CYejP7x6hZ5mJqgH@(OEBUuH2LIUpW^aG13xwqK{jnR*qw-j-Rag+
zu!J;6gWbgNlAZ2xDQHr%C#0asPB&#P3t}n~70Aj?XFcz-@Q`>4=9kc%QpTkB)L=&~
z7i@<&iy79#_j^6K*M`*zf3R4`J9mdb_=AT_&MJY<-6x+fO#o_w8{earV
z=?n);z0qKG{Se&EoKv+fpkE$r3h=nCAI#6wl!ND{(ro5M}2q4l8H
z)Ub(^n^vY)11JDsIm#J81qQEohx%)^h{My#V1LDq?42Q!&O9KsAf$~g(``WrrNz3_
zJr9Z&hhRSp6_12Tw%e|$N~cBd;o=hwb>MxF%X-yfNP1NI9YGqBxD}EMyexN6$*YA8
zSGiZJz!Gdd*|dP2Zq;@ju^{DYr)oQ@S)d+>tmnTLq>9JH$33}8iXPlKhh86+kUnPg
zlN-ZzT$nk>J!o8E&}7aion(}~kwCGsD_OEZf>d{gQHly#}J^3?3%ygttJeao2kMbGDHMV2)MMzCrBb99|@)U
z7bIe+`o1I)16SKzn`Z~xhDy=R=l6FKq=g=JB&-Uu*Tk1kdbo`_g)(o1K$ul3@ryBZ
zC8DZOD#|HuVI>e|7Qp^9$dOY>!G
z-53OQS^zydSQcg)z)po>EXRXk7|U;YLCWDoG7`t9xo1)6xPgSNI90chqy&qyb8s}!
zMwKGWIra|&Y&Bq6v9eCdA|+!2zRe>o%_3(uZc59AHX<^_8JA`|1nm&C=baWnTf~No
z{vb2IFrV_8`r>k3rhVMb-R?6G(sAtoCP-v{={Ih9dMmfKPDYfD3Tre3F^mk<;XY-2XpHrF-ICD?Q+?w1ix+@2)*l2)Ua;&4Z)XA>ut8t&;;iUG`m?p=$3WaBX#Y
zqj&Q7usl43V|!2|7fNZ~S38F&xVH4Hy^-NE81@;?VHPZs|
z)}51lDI$y!J!yE*JPc^b&`G#CBtxgM4(J1-6sL{co~1&)(t+hdpSY-0%w%R%K(6({
z!4(`>+GaZRv9g)UIBNw^!nAGhT*4`LcT?;zMbOS&8`NG{i_EKA47>
zlZanRL(EIW2htE#t9&sHQ8mjyq#>$y`TI0P)i8gThNxQRR0?9GTIS1UevqBDTR`gF
zT5|@z?e)R}b~DaUG%Gdswg(Z+DiONppq&Jf`iDh3eGnHDdfN~KP9DTN01cF4VT8Bp
zbG=%tiMQq2_nIg}%X`1MwmQuG&r`R^N&4DE#LhBXDBkNXK|!9?!3wRP2zR0#^HSI<
z3hVuVtPX3cH+O_p~&2^q@PBQ&38&6I|+PTS1HP
z3VaLPa_NOmbD=*?tLn6<>OJE}2Mrgzq(!vxZRR)?>y+qd?h2LYQJA^YdZAB%CUPWlUur9|lb0{2ip&YrnFzrGg{%4s#fGAX&IXXv2mBiO_gq
zNDd*3!jL>{!C}Y*p2deDlX#sQhD;$aN*FSYm%DlcWJ}!}9y{J0uCA|*;`=Yv3l5Bi
zhn8`AxX*0xYz7Ao;>zs-Q>^T@rP)HWi8N=gaEs;R&ak(9Y}i+OftMRQ4e_-wvTAX^
zGZ7_Hi||4s%7j|^Z%;&-R@;qvci(Nxl2x0WMjJ%>v#fDfFk>m+4x(t
zS*^LRf(^D_Xn!wxnb&m{t8E^`@{v-I>k|bbTwbqUyd}o824=CX-wI>75WZ+jjA=ED
zAhC0f4(ht!BiuYDkged-vPf~7wu&2J%GxS!4l-;-5qY8E`?kcG7HFF3w!(NqFn+<7
z7}FvgVWQkh?FcuAsdKBic}%8`y(HXn_)07H1cDvuLw&HXV+qy>)OERQZw!~zJe#$z
z1w#l_(Xkw;c4HB!O8QPi3dw`9S1BVyu9&g^!L4-xHoCRL^8;L6F0CEzcd^%A8Ny~$
zS*25Z=DqIB6U644O8l>#isblxB-Js95ALmzP4u7cks(HeXE{cmGu=++quP9@P9bP+
zCIf@uEdgN!U;MR6zGoB|AmIbf!_1N=bzEo`>aCgne4$sGEw^UyghoI3=7#R|D=<-i
z(ED1zo4@y&$JY{fA0b=GhUI5ULHrx$LA+|-9!$ad5f`CW>xG#n?)?%iDB;y2%%qB#F
z;5Jt2&bI1hcz0?cB&=1fb}PNi$Gry8ogT@LXYkzVVq-Z~dZRUphDE2)+>b10dR$3(
zr!q4~z7di^-R#X{2u%MKZyi+hHRl>dn92SS9bo6xXP`TtN6IP>$?}UU%x#%l
zFNM|mVQ1j$34X07{?Ar=!s%{|HWxP#rg4{~XKOW6({scm>`Npz^AS9l<|WXEpkXVu
zu|msoD3F$rlPL`x(I3(%uacA&XRG8(yt?kn+@ps^i!--w2fNd^&*G@nI|76Mk+qd2
z4uB;9+v;ognD1Y~6e<+NhIY3EjYgLvhhRK^u2y#r9?CXn6Ec#JtZF7~>LOpNj@d{P%QmHJyG}GK5$_qU5Ya}Y)0z$8(
zesTGBV6d_|M8n@AG1&G8j0UcqmRYeH>5!gg(#g7io1Z$@UG3_`bOap
zE@0||^$p<&HXIShhk_#_FRQ{QB3+LZRs~OI34?v>Bj$Q3$K}+Sd9Px2m9n9q=#{EF
zO?|j}c;g6G@JC8Ee6CV#x}=rWMW}?)B)cDY?5>o3kndd;u^hJWMnq{mf1cGkbZC9J
zfqBE}<=x?iqLBz+^h&s1&gfjr;8q;Za-2r>kVq})WwH`4_lmel7I8Hx(xWC)zNCIP
zEX`tezd48~iy>TD)J1`!1P3n4nSGQZs5sn+#^;|%7R|fo_{?R~qTk9%?2R6i(0I63
zGQO1RRM^~Di!sB!L0pzpHj0HkY240n_CRQ{fU-m<`>dN4-)cUiw#NcAdfE@`+E5pHvSY)am
zv0oQwS|+{pWXT7&KvQG%5CC{oRcVAwkT*9
z6+|33SOc-S!|as_hWgXjHxqMirL${gvE(#OBM~A^HDxT#%j=luGcR+2q(uY#4Ra{4
zl_2Bn%wiJL=PLP41de)yIkBnl6z}Fq=JcdLi%?N7bPhEVD1ACCe=P~Xi?#^tU@}%wkf#jE^tlk748!!<5KM+%`Ww?@j4UeL(p!Q+De0SoKq=~PnWLa&
zt3xSSDH9~fgirb-Pf`;y>3;LLRMG{)Bt0^O1hqSnjvf(0LaiL6TRc%r2&C_XV6t()
zZF(P0lu}X(-z7W7pL?|E7&3m4-46zj}0@K2e=bQyF^yIA^}{doWRg5?5CsiKgO%c7eMnJhG7rbzOX2J$oW}6j+UVpSjqp+wsSwU41WHmiM7L2NchE;M
zQ+Jo2I>cq5a(nyn{tMhvYpaW}S}KRRAMf983M9~*ljWr~gt?!AuBA%8(2#5RZ(=1-
z@N*bWK8YX1Y^%O*W0^+FYoq0jlX#UFgH&tP7M(z_8pP^B5Pe+7)4j_z%biA$;^t_5
z11_X7ty-FAgq_fWbUq|nGPEe?!(*lc&`<}|a_W0J7z-Qa#TF1=p1n@1PR><(joFJx
zWmmxE?Q|HBwIk2i6cHlvXbYMR$l*3B2*_vhVZa1py#y&HVZjRmreGe|SC_J)$|C(D
zV?86W&>gLQ-CGm=H}fSQOF(*SrY(S_uR#?rg(dmiYbHo32MUBOkepn;=-k;6gCe5E
zzyY~idtwC+a@q@$K&Di5^}e)!zs_1SJRIo?hwYd4QIH~tX|&QQ)cdt2#S$#wakBL+
zkIEDBTV?GvUB`v1a_%?AY*|jD(r9%StTKMZh~m~sjlVv5+hdy2PCW@|vxAjG^J}9e
zywTT{OF(6`S%c>5fPEKO=T9+JFm-fg`-b5ZK+$qNc`PTE=^=yS>dVOUJPdO&T*VYY
z{fT
zW3aX8J-h=Z6DFnrJ*zmt1H;itMtGsAhf;s1*6P%H3vi9muT6Q`EO3sAAKA5s!e**?Ap~Gub0eTkhXK&ktU2iz5ZXz1n^W8D;%-4NtS;o4>?VK)F
zPV!r4)E!1Rzi7swiQb)$S$uO1QE^#_QOS#hygb7S>?qL2z~Ii~CBr!QG;B3m1QIev
zkBC4srUg`I663l!*THk1ce`3M^OPgy3zKFufyI(On2IxvAd@;~5=k2`4SXQ+JG_x)
z&3HoUSNW|d4!m%1T3>g%#l`N3rv{R!4%&N6p{lVZn(jLD#=k3u;`WxyE?KUeT6VnA=wNk6@LBJPhw&8oXa)Uvu0iqs5tjJfI
z-7HcL?m^IRy##9rg7gDoy=Bx85+Q3pHP#RoA#0~q(I65bi{|zVA`!B9Pvb*Kge-!1
z_z)5y!o69779u-%ydy$nziHDD5+SlP32F$55ZN)qG=xOR;g&W*gq)oyMiY@1azS;I
z2s!(SrlEldxuE7qggkEI6GX_{G1&||CJL#WM9AZ{g|BYXLO!TD5@7-}e}V`TcIq2P
zgo&WKNrVZU4#FZ#1T{w@Od?E7f(Vm#jvYsY$)LJPgh@R14vR1u?5HHdl%0M@m%}4s
z%1-8^LDUzfg6bv_rtD;?h6W8W1CR^jt!oB^^s&
zew^*$&N2QG+s^MAKLv@2+M(8QR0Q5R&1_$kgm|6?2W#Xr_>^Tn6H<`+_So(RhCKnS
zgeppGCa|)NYRL)T%1W*9p|(ACrWpC13eMWzqw>3)$G+)FDrPY&ovBrD7M5~j7*zVD
z0<3hYR>6_&ooW{x**StGfC`T6R5Vt>5#H~F3Xbf2tX9Ff_|Xv^foq&YXnl_n3eE*o
zN_{kk7Y80b&sM&MNY(lH(NqafJ&+03A}Fh@KNwYKtojH$@tM)6+CID!M56XGN4i_coOfdLIqC-Ivo`}6+gPG
zf~W8(%VWd@zDlX!DePK3eAIXf8qzba8sqHBgCTykIqO?<5CB#N5vp_>o4{7L-(Dwc
zQrX=Y)YwkZ^|IP*dmVNI!dT8WSmHQb-4Iw<^KOu`UO`nauWiD4QKj1^waS2+z3q(c|l3N)V-8#54-5
z-c;0K+z{|99k?LxE3|c#A|&HFDK1L54?3&1V1x%5GnEe7Ie6u?TV8&AvvDq?*O&2_
z^A4CTMPLZ^nQu}kz>)gA&6W~L4C4^uLyN?%82gqgog0#$Ge-_x_8tVV(r(oHYZfC`%iJ
z&1XuI75E(C@+9y%hiO0XIgf)#;PV6)-oWQc+`(gF@p;A%DvQ2(Er6GEXK68X*v!4Ur>mS
z&by|!jlAY%6WR2@Cqr|g_6)-4Yq|z
z^p=iE%)I}ZFuGprR0(=E{$`j!?_>;r$Cc;<#`0;;yjb13vzU6{g)t#!v-89!L>pUx
zXUiq>>kjd?(m}B7K9c3U(#*v+q&?H+;J9*{c0p}UFA)S45cWn-?l#qYhjP5>Wx)ou
zJFS@xlC;oc8^QEq8{C5By1=)EEAd*CT6o1@feGaUSQ^A!w@r{r*R5AW7%>;@6yNLU
z7psdWalm+15-6K_W)di}<8!$Tb9PK87nHZtlDeP?+)X4%IEk2q37{#QjuJrAI3Oi}
z_TrvH4{KKpJkM<=!m^0@pF|hIb0i6tL$t~ySRPJqNw5io^V2X)KT=d&&^Aj8nZHIK
z5G}gnz}m{j;P4P0@P~&8=lbLXNQBiROp~*H$Q*8YtRh;Ckl{e9-YZ}&FEnQ=SV=TH
zAzOF2xUn`upRxjeIgqTK9o~UNaAFU0%i(H049VNigB@-YxKIz%Oyb%o44J|^pD<(^
zxt_z2y$Cm^)#FHjp7gFHP!_iy2~-hIBMG3K9U{&xD-Y{^0@Vbp>ItApSi2KIQ!u0?
zfTm#`P5|w-A6PjOVnI%-G8W~eDq~@`qT;y>>B2&bp$A77?i9#X88rtGzcl0dZgOQ50+U;>DCfe9em3MPPPKbQcbO<@9vc7_Qc+8!o=Xpg98
z7*`wUzqv#h?G}^hXv>%cqkUr%j5d!+Fxo*T!Dt(q1f#uV5{x#KNif<~Cct=WnFOQ#
zWfF`wnMtsm?ZV-<173+@CDS(`=;;EE*myR#_F|{i){YVna~fR0q?5$DV>Se@c8Msv
zl{$t_<}!2fV?b(nd_EbNMM6k@WfZ53AZsEp2cu{rFppI(5jcUIi;2KVq$NoNP9d;#
zB5)c}E)#)!k?=~JUE}q{kom1K&@3+8l4&D5-;~EWhZN7rw0S#)l1Dp%SB%NDlXg}h
zk9Go?Or?kM;wY_G)5a(6Rhl89&I#E8&MA0(EdwtS{hFOY)*_~IPnm`
z(+IuBg9<4Z;Qnzp2dnvR0wjxPe6f*9nHs)kPUB!C{KMywd_tem)z{g1C|~zAA&Wq7
z&2^BVZqeLwfP_5r;qgU&Hit|N6o5Y89B0NPUBPVDsYJJjRML{0b^pTL2tw@s$uzx?
zO%O?bXF9?aafqr{4pizip0yt)*l7UG0zm-H9kyzS0`IG_If>~O06Px?n3oY~vR_rF|bO2t;IhZJMlo+dUKxXY^G8N`{P@0|`VpS8&WToegh
z6?F#^-|!a^zrg5uX0Em%be`*AKcahp1;f6CfX@m7+cO0MzA*vFl)s(;>=Nbw2+Gqb
z6YML&S`=}1zSj&ZU2V%R;6F@>8mv77tQbF{mWa9g#7e)ofHUi#7_T!MHe0Ay`|~Xv
z>__1u?_kXKvkW;&N-QSg#23|6%$ag7ykpWD?kq-Re$xggTps`~J!To+#_CDA?g+
z7R!bIHNrX(YwuROM@+JryAvQ0UefELWNq0I09;oo*nb8M`}%rEHW0=2j{BFG3RP>sCQmr?1Zdw$P#)Wr5$a1Vm#~Nz_E|;U{I5_)in>A1>G%%lYBp0TCUIIPe
z#tQm7FgFP)q$y6)Yv=CM6L@el3LZ=G=94_wzn!jtL;=z;hjmMKo;P5~36LCe0CE4h
zkDfh?8#H_(gW^ALrQ-`+d5`wKE%LZhim+QWg5Z&rOrA%@inpr(@Hqn(QGLm-NqB?R
z9j>68({L3r0`4MWuEjY-Ove!1`rw-vmLoRy6t?8^h%NJpHKpRCYV!k93D@Qh_M8*VPA`tBXevC?htXqi(nzCh<6@Z@jYtMm_L*VKRWS
zoV!qvU7*znGSTG2K-CnG>XJ9
zi*Db6%(QDQT!DPsK(Qm^kJkIIt1*L%TZU~65_i*0j&>xzZ#Umtb3K?L0tAIB`}BE?
z3QcHB-@6hc=L-8O@G@7}q8z%yJ_B=}U3iPGmHTZ;?kD{NO4=k6t8@8cYCpGFcU^Awlag
z5IuI0Alk)SB62x>Bce9WF-rlB8naJDS^;h1u|X3An-9V!_7H3V<%wF0DhQU@Jq&!5
zuaa)NQYpjD`!ZR#U0hmwv%S=Bw%T*`I;;S0(=%+Y4ePh7M*d!I%{LJi-D!LVs483D
zq^ecgb4U~RZJhXocF#qufIiH%l^&M1o$}+^^pQS24|qbKgje821^qx9DiqTq&T$3t
zzV3RE1QJuI2cBgaa9{8F?b@h=%<3@JyHvKh+Kwmy?9{!5{*NMz(;OitFT==+C
z*cJOH+%_HlYDP2^dsgtI8O@Ur(oeopqfUut_09t`$p9j
z9_|0|*fgdKL&WME5@8VxIquYG=yI9s5@GqwwTZ9^#0&6d5VUh&+Plt*Q5LG4SZZPq
zCftvk9>O&QtWj#=jz=2^)aM?;?ZXplI|$ppzJVN45>Ol9s51Ew>d@byBW
zQLrF*`oj0fexIZ2P9aYsyi)RtCO{4z+Ce}*^Gy%17fL}W;oV_C4tb}%CTaEX46}=E
zTo5wb#UkRaY|uOsh~Zf2)vwxZln{i}-46ntikOA%no9AAy5(9cv(x`xE;VYQ0afpn
zOGw4;&d4Ow0X#>blY63RRHSh_{Yua~@TU`3?o#o?cXFkTWocYejj#3%s2wS1dw)9f0PSO^^^jPu87$ncDd$z_xTR@lv<$SHJ9^c#`lPE>!I?w0g
z7V1#oLfcboNN(-OrweUuZdj$>=d;n~kpKyNLbg<_w#YIMSfx?Jb;Ly760x=mNCDO*
z`P;Te4nq=KvCcx7h!zItHf_pdhVuv*GbD{)?DNylLE390CO!)rYSHrI+`+_{w6;_c
zx6}334kO4mD`M8C$Kwg^bmB;?w^X>t)mAN*9%J{z80|tPd01RtEmUP+oHWyoZIr+?
z2%E%G_#mcY0KNaV9fXHOyo*Q0dHlCg`)jvfj~Kb{zwI1?@o9`h|H!Y~>1%m&<0Pkc
z!rY8#Iuf*#K&^XLrIDHT*a$%+foBu20DJti5lBFNyi|T%UAqUV!wwIZlzsXk3~h1f
zWTrIS)p^#srNi{b3{394mzmow2`txUYCXhTsn+T}>;>uZl{}9SDbIrV2P|s(E>nL;
z1hCEZ^6>8E#UavWnC+^fWBBYE!UkDKC0Q&daXaA>X|46Mll{F2JFKTrD$+nBJaN)%
zh^oe1Z=qjWzzra}w_d4;4mwp)X)JFm1yM0#R?UK;v{u?L19kkP3GKjwERTfg7@7Bw
zY5Umn2F2KWz`W;kkvhZ0;W9!v+WwkKXdQ9qJ0<{wlq}xl{i%Z(p%+n|&CfqAVEg=#BnuSgQa+%fH4U1TeyVywj+f
zYq^8bpx11Nt_z;K6JZf_5~eGaI++XH9;S;!Ru1H=wY=1%k`S-F)}?W<#~LW8VY5)$
z-$p)hvUB#Ew5i-}VuFyg4uX7?hCQJfG-4IMa>iq;&!FvihqZ>sV3$&TuHynDqj=;EF=7b#-M6Ql`p8uJ8ZjF{c}QIA_Ew(=B2P
zWk#FSuzIv?1t^n!pNvMhnxK$!LMy!Z(N#mgJO}p&RLdD?3_+{Rw&0#)xdV`_3RbRE
z3v=}z-^&Z8yEJ$Pp5wRyu+Op@*6S4Px8(XeKb!c1t1m9A(XHd8>C8$>2GMK&Fd)3@
zH{Z0>q=c6}=Rlw=>N_{Nt-xiW_q^Kef#NgupMMPixCi}PpaAMaw+0Bf7g@gKS}md<
zy)@8rq9<7~B{WSDeaXsiroVG<$^@#1{`4YC!*+k7dcrap?`+!P<_Yfd#z!$SXJV$6
z5wV2F=S`<_vhO{L7MhgPPP{O$>SQ2
zM@SHDBqBk`DOc8mnrY@|=OCJC1!37&h{M8`IA|v!l0hXtVDCKQVP(evJgKeSHbKY~
zxFxbFf>?aq69a9_Lm*~=*lBzUNfz=EphLYrO-t4KBM~7gm>+N0?Bfm27TSnLENz(N
z_IXb_ZOvhYkl}z2I(UKSs!Bs7rx$yiLQSqsQpCN`X_JQj#G}LjV+Sea2&ZjwEE76C
zSsrm#i4R0=wIV!uoM%)kXB9w6?dXszlL5Aundbyb5;|w24p7vY4W7Er(6B&KPgi@q
zLV9wh4@xwEpsX81lBMF&J31vFC}4fa!wQw+P$EzTwZ>mlb@;fS{{?4#V%&mvr$fG!D6y-shb^`zeYUZ$VI6F0GTKL$&q
z5J%V(j|>-&iohD5_JnZ+huTR60{8nKE|f1^7O5!SgTERZbWswogsw+ea4dNYv~8G}
z8t<^SSGsollxn*S`+re3cVCpPAJwmHf!OKberS`uW`pC{apC9)L+kvu6Hk^eQ2e8=m^Ely|)3FPi
z#%-!OnYu6pg?(QlFc%^2XcFaQ9tIS%>5H+ArXg$+G@6*iYkI?2R<(_D05;jMem%!J
zd=g_m$F>j5AugD{YGmy&paa0W-EFHPvV*$Pww1njD)m;O3{N7n!q8`{$?yipEPgQ<
zO(q|sttL<9JD8(x20Sh^{htVN(PDsWVdS|$@Hdx|&W;HM+x`ccP$`giIeK11bmMhdAR3OJWP^N_qb#>pL%R)$EsTes&s=+%!f2YUL@K2TPVz^r#M
z4kU|rQrdjuKq7cRh9NoofxJVLw;#wmkO}*NyaSoEAILk9DcH!(5J4O~Q6=$G3qFwA
zU`c?+V0jf&Hmy&1!;hHs7n$KpaJWde*X|jP9GtGiH+ox`or{IT&1$EKCVjT-(rS|8Vcm!4Mz#ag
zmCmdc#B@8^pRd*slr#}oai$kh03Ud98Qxid?d?V>>{YH-MZeLqb34y1Y`8fpD^gqKi)iN`a#>RkY!OE)-)EZEP
z>6Sv{i00m@zaMCIJLLteCeBFVl3Qhh{Ic7_B&0h}Fe`GiW;n-GmM@)#pl=b;4kLwB
zgf^O;W?EH(toLnq!=f!_p!0~OJi-5BaOa}uQo<|_7LRTo7fU0}rT-i15xaAA!-n4eYwQ*L1Mj8BVs%_SUJEKy~_%-I_snHOLzKI9N
zT<~8~<;Cup;JlXKX|@;i&0WgdK?1#GOPY`#$~r*!C~4qN0F-Y9NHVrQ
ztSd)@SDT5L#qL)4rL+}-PJeFN5ysWm;>qI!Jhl6nbvM`TOCW-x>*NpgsSf4{PTOwH
zOH)3sr*(!Kg)m#2ndQ}z?-ck+j-22ze<~z)Jh;$kpT4*2b>UPD&#jsrJR%OP;EjP^
zY9&(;E3aHiog_-UzyKTl1BLor1)dcFU{eBzAz)hq7em0?B=DfwH<>cw`KUNskI)@B
z)>#(or3v&(?3X9NRr$Xff_LFKC;2}+0j}tOB>}GFdxo=9Pz_S3AwSXq#bY9b10C2n
zWn(`#Ov=l5W9?kNJHl~Do7a7C9;?_G@HEa5dh_a2}ZA2FK|!-Djah1EpwmRu0I3MYWbSvUbS
z4RQ5Zz-0(^(W^hX6L(=a^S;vz1{apak@smyKsxb0H3>M8r3i9*S1DCPlPIDe>GLj?
z#uF>+gO(*B;&vMlVWJBH@(7R+1WY69hTd)3te}Tuo=`M~H^Uq?K(UT@&79x|0Nm9WiJwHL4=^v|doy4l8b{{@g@J7DwZREEl5>8!2T8
z0OFaHGrW>)k55O+;g%_@uq$wOtQ<0_-pFb68FG6eFAP3bINqWMC{JC4e$|7uKIm*h!@G$|FEa
zI@ScfTHyUH7>?ThVGR3$5z8O3q+nx>0*nYd=L}3^R9R
zCNnXWLr>1;+r>e~cm$@27XloxQH8w5?02XTECB_l5PX17o;CpmaljF8iX1^)J|xIp
z20_+V;wVXGyi$suB%e#cAxZwp6eOj!_>d&W4T6z`aFirfw-orEv1PhETp!@g@ZGqF
zTS62`r@jh@9u*6OZ<ECo1Jh_T&UIf_Zr!Ypzrb8ZQK5n90NpxZ70FJfUB2QOhw
z7zZz7IT#18U?ms_uVN7x2cJP8$Z_yl1Zfxtufa=j9DE-A0G)V|hM`i4*ozuI;9Z$#L!B&FznzLc>G5Wm|h)I`*)H#7*
z4bI9I;MDH5F)W;+XJLugX?SFk#6~_}o2$2Lc*~_{H90_uQ@>OvXDmFnt+i+I?lFkN
z5e5{_lBt=^r`~4oM9JvkUL!JGcYRpuzhZ<$&K*x)$SL^Bjj+4lq9}*j~kzwtrFlOH-V`+Nq)E>WN{5P1{~q;dJH%R
zqeBvypX*v-JY&6zU+r2^O=Do#eX*{)W64ykjHzzCTBhu`95LRcwrPYM*4))lLjh{E
z?DOiSMk+>2HZWQ&@HFgV?zGr0Dlj*C7NO0@B22sQdSc(g8|&Qsa$c
z5mOG+F<{Csngr%Y#gscn*l>2oBtw7C24(_PHo$p|<)n&}QLQ?Ih>S_>q4>S9IK>Bp
zVo&X|2T?Z0!LyhvlGsDM3A_gx119&6L@+(te?=mgpI6^&+SK$oJ-PeV&H}oPh@hi-
z{3##TvY7<9$v&N6-jjo3odG{_Y|^H3PGId
za7M5b3dV3qZ|_VjLh9{fUY#PLH(xyrhyvCkLv!baHsIc>qpdsqg+Nx~4!B
z)_6QI5n&w%=+pvmG2zOvbs#}tyV1tnaoCNol&)mE(J$Z%Pg49l)48IT5Z5<=g}ikqLD40}{D9*&
z++Fz^`wV<+;2OgIe-niE|J(4Ov;Th^ZYLbof`^oCAzd~?X4&BC&mx?SFR-RG5qTx{
zsl$CpG}SIy1F|WJX5`SGUL?-AV1$q2T;3Ra&CDM=#o^O!$W3HRKqC~smfF!n>9A0f
z65JiEZCnDdAqoCCh^zzI5_1t#V7R!6*b67SC)YQI$B2?{CWNYX5SCfI@RW16gq*J+
zm>D^Vj?kJWkP<)EVtK84=taP!WG90C!|6;CA6?>4
zg2>v%h@=ueUHW+mg%z{JqG6$~tMEkH5lg_NSikP}7%^7SGj4+ql8$#x<)NDkU}@zj
z;F6po1c_p~D*^*}Ox_KV(^#>|_rWA2$S;v)6e;e8F&yI&v33KCV@MI|VIIa*i}noi
zAPmW4e?m1nSl#to6)K;0!XPsW*gftv$qiT*{8_hPV}U}&(eb_M
z#P=Ke`@$#ot-dBA`Yw!%+hYkt>y{G`nWo1(4olh~TyH8FnrPz)nlIzNrA`CaDm
zQ}w-OOZ?*Xy)?#88`6Ka_Rz!fT#uiU?`LWc&F>tK-+!q+G{3WB{IrIDw)W8cPWSk!
z`u!hW^ao0WJ%LoJ~mWN
zrgwy;QQW_NfVs~PheykUlQ`}xF~2UvY#{Od5nTBpY8My!^#kWnp?JMH#0enwbzwLd
zaXvvy7Q$4rtb}E`G;{5h(9FZWbznR3F02ej$EXT0q5*Vn9Ml-BAB9~LLB1sDQcXpL
z$*Lef0qzp7kz#-Az(pY>j1nEcS;LjIKQ?`hV5Z;n;V<#ZL?D{u)y9fJM{^>EeX3t=
zbr4zt;e@qaQbG&eg=T4%uAs@}a+fh3O1J~IEMpdPlxhXzv;dIxe#}q8Qm{h;8nxzJ
zuhPY9?l?rmmgu7M>wrHje-^o88g>{U^|jr=Q)-Q?3WhkJaLpD_!a}9c!P9MRhawi-
zzxw+ItDA$-NxWDwrfvAyDD?Xn6%*AI6fXc{b43
zt<0g8B%8=qe%z?VhOC^#5zjd9X=a7Z!!T+%=57t^4v*txdJth0ZVOesgcd`zg~
z&9%D)=^urlWrRgz#t)hIIjVVEO~em%6QfZ@a5-JU%;M;nhRf36BsBzn5SrMSwLzhv
zz0Kh|f#)n6rv;uLF0BfLmzd5?C2IO3n(K50Be3-gB*w`Eq+{$5QbMJ1l
z?El9!n^eSnrLwL
zU#Hm$gCg}vmEYlS~u=E
zjuifSONe=dMBEbM1aiG>32_q1t+#|Yg-q95LY#*0{+1B;W@gPO9j6{#?OnY^%q-0K
zdgPDg8Q~Gt)-ZFKD=Y_~aQC5(f#<@;PbiGWL$z-v5xWETyK_hq$zh^I-h%HLH74PS
z2Ptnb45`ZEaUdUAq~kO{NSK79qa$A!ZyN4wTR@}q3|l~>oDYtc?Ls-&Qm2C0r3js~
zj)>Lim=t7Z9Zx{@JSH_WU)W!nYYV3#Y=89CUku!uYf`An3(QRlDU7zBxZOB*yn=wS
z{m%0G^6Ft+HXBDN52uRIHiUGmR}ySg6}*XSwEGk`6s~>Fq%8s`qdC?G2Ulo6?QD%C
zl;_<7?!FR%MP%s;0fln$&`WQCWc?B9v5jbtPdC1hRBusUdkx!fnAH0mBlBh0L5nTd
zB>@yXcEmGwU9`g;aW3n~$?TBx?NE35@M>SgWx0EZGg|^ib9fj@k$_>PzmWy-Jy*Y5
zn`y!mOe@p@ijnYW(;g%}7caGnCo9PGkT*Rij*tcT^#<&4m->6J+vU5*kdf;M7ed}t
zYfJrHv_4$K;mjEsK3aB?&|cv#N8?q?9&de25FPqoO
z=6ZW`Wqr6#p&c+c-y+-h+GIpFAR&OKbKgj8os#QwU06)@C<#eN$BwS!w+t@j!O1$3
zD{XWKcVi6Ew3nSlNLpPO$rZyv5If-HP1liyVXIfi6GnsuEgYbTaSym$x`>1@)Y-Q1
zuohv!;SK9_z!(ncXuH8smBK4~Jdc603mk^_L+*^*!`v|(^+wBw4jc?7IQPHy
z)T3n`ZcMEMJ>mP*&wx+w0Y7f~pW9AdEO>Pcz<#w;xebexj^|;-fQ@bO$Y69Banyvn
zKtBs0u6vLudQ0e$M1R}X(DM@gty@E%mgsM?f?0~=pd34})s$un9fSfe&&gTfesdB5
zwH&lK9*n&8SMY!%gI>H00irnI5*A5GPMU=^2CYrQ=^(!9D!Fi3KkqJkdOxFC&zb?o
ztks5x5y1Vpfvbkq`xwfVb;upWVo4>lSs%0OYI%gvGqCfR*R;@vh11?dz=KUr(WUDz
zixCTJpL6&Dn4iJRA?lp_)HP@1K7FDkYF*gudsoY=^#2U?C2DpTu*N(Dy0W
zq(k4Q;o}_oz8B9<;#NvD6=#l=wo%f8xESac(aAq*tVuScR7QM*_=Z|qcHeAl4opIk
zzcEh~>WESPudaoXJ;P|sW~vdZPs)&~3)I|_=tDIL;NX-^={ysm4*D-Go
zuqxC$#VXvC{Xzgi$nETv
zXWZZ`i3Mv<;Bx`hh<~QmMe0MR1*tr0^vwCDt4R4x=zhx`)T$fq^j_{&T0h@D%WP7q
z3S|+&mk%TIlJAH)%y<~M#(fubAg&kBWAKn;61UK7GA1!=25C}6^kJBhbp&Gt$^2vt
zw(&`Vcvb}CqrrPh-#s!|TDymC%YPMW
z7Wdk$W_b~LxvMy_VvjZ#H*osZf$~URENy%<_USPMP6Z7sZqL8@?-h^RTQ2_ZTn*#1
zHjF}tTc{zKp=C#+RHC9qkKMYIT1RZo)sp^d$;rJCmrjZIQ=gyX&MXFEd(J7;=iEd?W$!jZXoZ
zN7YpefIuo}KW+6zc3iLkaw5x8K_Htud>?7Hx4TsS0i
z;g1T=M#jt06bQ}Vh>1-|!V{ZoF+qS02kKfm@XWx`txGFwN|!yND_=}Cg|IOuuXcN;
z*zhA$s8g``s%(s$5?e6knOZ<)fv>?yD7)N>f|UYy*?;Em9=zb)rBR64rgx`-1)E
zk&^s+E=8FlTC0Lnd1&qWz8z%Xte3KUm>1@blQ#dC+aTg}j$q6BjRyME0NyT6%kqX(
z`Gm`e=$}krKR6INq#6LnC9%)tmjQN9P`ZJ3Gk@gvaoxcIGYq!T
zE|F(S_Iwl55!q?tOOt`f#{ZT}X^bnFWgMOi!Ki}SX!TxJ=D1XmlDxfG_79fN22nG!NtUZew#Dv8zG^&ag9{i#G;jb2k3q
ztvweD0c2-+^gS21V<8j=&kJqOMS4dI*TrvR=MwN4RIZC3SlGdceDdHMg13X6@PGTj
z!Y%`oQMlfQ`CUPG8z_ev#XZXq#>GoC!Zt=gLW%k1r6EiXH)zOZ44EB_mhKshhSe1u
zVc-rpT3g}N@xmeS0}IziM6<}z_`>^ESY=VL|j?V-!+$#sz_XH
zl;;b$;;bTMY#)ZHUI&-?Z!!iX<|!15sTO8`L<;=0=>Z`;G|F8>iMO3o6^OzF5mn^N(d`wHFaw4Cu3uQWSlUly)0n=6
zy2QFb>O$zDQV$cmHo&T~dbbncO+KK*0Ly4?D5|w;Yqo+IG@j}^w==8?PXtd*J%&{?
z+kB89tJ>k(-O?(!XZIKistSC8y!!TTFBcBf@ubXybOfa5L#RY-Iu`s|l`679$nGOF
zd!8B%pm-T(bn%tq60_jsO;|&Ef!mQ<$W@YBhv126$3$T&4eK63I&es$Hw7-Zz6N(9
zva-oRp-M%Fqjsx_7tg^94|R-_)5o
z(PF9Rm(Lo}3{XxeWuGB0wEu2Y%QRG%ES~ymh3l^o9(4O(bJ+CyU-NLA(k6CQ0b-4v
zs_hoW%xTymT}E>T?$Hm%7Cl;{^)gH|_;q6uqJwzVgLyisy5iEKf4tY-;#6&j^hg>oaV#lZ5kpi`1M~{OD2&c!O>OMu@xpZq!
ztRQQoTWhu5!e*@BTPtB}j45p#3Kg7rqQ7zB)Rt8QV=v?3{5=UQXj9kcPKnUdZhe&?
zi~@7>aBvLu)g4k*MHjy?#%GX!Q#I@K`ljDz%0`B?MHf_?r`eypF#j1XL^eyF(J`wcN_A
zY}H1t=JAb+P@-7Re;8X7875Zr>q8*1rawF+j98tqs+U4gy{?x-wNxwnOF}@kw*P7f
zC@3pPhoYBIqXD(P|5~i;$y)LX|5qWHT;r{H*@h|o3+vYxLbcTE{87I{Q=!;tc(Z|Z
zd;AM#6;%UFM%LbEq*M@nH~XR3=q4)>t-m~UssBW{fz~6JE8?J#S5(;`DE^&F0lRc;
z{dj1X%rzQwkg;CQLMIVcR&f%gW1qa7Iv*!nVN4WYG;XvWc&
z7Dm^%roTi*upLK;WX=(Mi6KN1M`K)fTF{@MZEPqkG8Xh~Kt)XjEn5n7Wxs>=5wyZu
zLMd8HYsZcaumk#b3Z+{r_*ykT2W>0(UdpwEOp>kI>fybgzLjDW-kgw?#Fhtin&8ik
z>6-~?8MWH&MbMuhHO2*LV55kX(xx7!)V5L$w(9Z*Pz%Pw5(1g1XqB_={Ww7gu(0@0
zA0;?U^>J&ezU=2>*qq9ke~3vyun@)zlt8BmE&&^vkd<5;NtqQ#9io4!0fKwt5S2E@
zNvgHu4$(fyA-bTDLvdpx3dLR)LJDIAI-yO>ID5BJs-V*j$8f|CiR$(r>X%encXJ)C
zbW3EyetM8hUvY2^WuL~ej
z^v0;R0RJe2?)FvR2K-U820Aw2b`2)rNyr;80mA^g9WS6yf94(A5ta~}H8{>v17lZ@
z*Vhts4uQC1o{tqueci?c7@=%fB+mf_Vf+%k&{*`p&K7W_#Updc`)uOUgmvxpnCjHW
zi|J!=u({NM`3E;WB8exKu~_NV<>k-F^vj347~{??7H?yi?pNyBYR`ZqH`>hcvGD@4y(Es*H7HFS!WJ0wochiWt;o;Im5jSn!L3TEJzMB!`2xst
z8Wkk~5;3G0V1+T=bw$F6=Dg}SNNe*6F{1BeS;n&^ZETUXqe;MeGe+3n6wr?l5zw56
zgDCmT#c3$h_M^OTK}hfOpmin=mW2Gj52fKCCDIoyJ3){SrAGRlG$eWwL18IGGhQy0
zRxBWeB~08_f&ptNQ`OWQ*>7}A?!fAR{m8&1^J)zNBH^vv!{ltH2aInX4&3K4
zmaJ0}jeP^dNc^ldH7J-EMj(80A`p}Zoo>dATezh-VohXVsAk}P`^YjLNgiL1OR5p5
z_O@57O-!{XFB+lRi>WY8*Df`LG4*@aEEq#zb1F^Eg27Ixk9knGLfm!0C*7R-Kx!5T
zo&wg)eGyT)(BX*XS;i_LUO
zMOz5!Y3WNoeLmqStF&A6B%ZFdgfYy9?brc@#nY6M*^Yqi~^50_Kn6
zS#AO_hcZ8v1dIUuizHwc0+HvEs0$LfJ9Wt(&HSZ1N=!u|>`z=R8(4XGXt24m0b;{h
zG!lk3ZtwY#)3ePiO2z64--`LGzw?BDk2idH!nZOY()cGDY@s`N(}wYQzL6jX#CY6p
zfO2+F#CU`CGcgsR(y{OSM
z>Sm#iYdpPX5D)C}NbF_*E95B>r+rDOnec44#cUU00m+M%9qj^Ap86Nj*x_4Oky;`+XtzbXx
zTwF^bjK}{of)ch4bYS<<`vPXm)}AW-cbt6$WPtKWI4j<})eE#K>eEI_3oLC|Pc%SP
z1vbQWZihbZH41isq{dGeHBz5rq7tI@VmX+1#|48(UAFNO>JTKN3b(j*V-U7!RU|sq
zYn&qj>FL7>uwr)s{(!pEI&`vezGn@5u`lP5T1T`ZmJ881G<{5IBpc%Mn}tcxQ@_WK
zZ=u<0)G#Wpbt`1Xb0G*oPcNA+#uAI(YNc3|U%6!{IG5#EK2w>2SZr61!0l(y`*_`>$a2bM1pYQFq^D6sV=|{n^N6u*)SAi_*F9QetA@l>o;@FI^Uy;&Gv+<8fXDvg
z<_gSNv<>mctfODPd_A_jL8x!=CFDS-LOrOzPq#cEn8+}Ox3bSn3?`xJtpBgdY#H%6VBNp6JwgU<*4<@-3AdV
z$Q=4PvmtaW!JPO8#^8p5!&Fy8yqwX7$VV{KuC)rtqNO*K0eBJi)N$~VokuG`Uq+EgN93$LkOM(syuf237`o??o0qpW~xb`DI`Zs
zpqj=(BLTD*yHUOGc7;c@fXfnLSr`J7=ps8&N{nX?*1;sYJbWpWU=x|$mKlRh+!!~t
zrfSolScX6`%o@XEYon8$;jzK-J}!>dkHB3|#~h<%3e}mujU%#52+ZrO19bqC@<^_Y
zEwBr#U?cO0v1~Y%-$^4Aojzn?l}4+xfZzg+0>YfNnpFySbijD>N;J*|iD1UKKE`SP
z&|q=cZ`5jV5{y?ffY>3-YYj_NI3pueZ9yFTtA$bp-WFyDAw-m0|3x&4SWPZevKzI-
zYu4PgdTNv_$wz}LkC|j`y6!!L@ItrK?Sm&^
z=P;|1;7=IVW{+IU#0~Q0iMocNO23UtM3R-<3|3NSJdxydzdKxAM_@GE@D5j2Xn%J)
z+``2IdY#0gokI)})>3*AbI2T%>}3c0J*+v?;fpqP0r}!Pw-cVZ?E5<~lXq%&?j(?O
z6rjB$0(f1dF3#>ekLkoq#_KTgDxwRRh;mfm-3Y?$;Zn1N@gUxny!g(G3EUYT$9*=}
zSH7wp0Y%)fT}lY_=%P4S=cAUoGJJfvCXk5lG+!*WVOuQn4?rlJD7;BIytHyyFn=!E3H*(YT(a%qLgY&
zD-?_nqCD9XrPMUgogfujVXd}G_RZsm!umiAaMs6b?>wKREFBrFt|DqS`Nk^%i(fP1
zzfeo~TA{33$viik@PVecJPyYO#dRAMS1ZX!jrY2u*BsG55*A%`$~TEl+3I#XLQ7X-
zOp9U+s3t%+#zExeDMF;tWtyU5;mYuBp`OKId=!M6xHuXPj&jmR^_dmUpLIjtfaybl
zcT;5xn;UD0IKR9o@0G8`Fc8hf;9?oE*sMG6>!1>4#O~5@%)TlfI(rua)@$9KPFMM<
zAXw)Xw2Wbx(G|76N+#bUW8hWbyt*vDKM0;s;7lM4KCQ!U~w1|W@K%-GnH>N;CM
z&fGo3LvbyZ1+1-d=I^1M6wm_q)(#&=Si1Yn&c*_^=aIY9GF-Z#2*J&?(OBxKg=pn;
z!!>7&RvOZ#D1$F0XFhr
zFKE0=j7g70+Fyp>^MNcJ{`BSZ|Hs^W2S{2}d&AwhvpLM{E;$Vu5!{`y$$<3q^vpCn
zGd*_qY(TV~-Ra#OndF3J)^P8Fq97(rD2Skf2>~NPROG54SFh+*47(zV0gRXQ(k;COr?_ITcI|N6;w$<(QMDKgp%$Sa@L7g
z>bzIQqtN!T3rC^mv>Z_sp2bDP>O^K3ZcD3!O)z>oILu}|0Df?oEpSI>N4IT7aZRfu
z;4==)!WHattUg+=4AUe0i(?7J-tsn~~D)jArfNBz~m>TjIS`
zeJk~w9d|3#r>DlJVSS3-3v^Y#{ZbQwi4rsv1S^APv76}>t3M#p740=hrjOe#s`
zFgPZcuR4J-sEOnP@j))Ao#O@`v&m*>g2PwdQ8iOHfCQB*#a4=Jb_@JCMicY~v?iQ%
zV`%l-N<77#1O@OGa-bNnI2mJxF
zJKQLi36M*S-iZK7IA9a@m{7MlP_utiFPy3cCR27-GmXH6xP!C_i)+;lI;H~`qpV6$
z^=a3FVR%sKxiRXbVY;w0MqPQNfckKZx`7AO|B*z!XsDmXP@6H+WUyl^t<8_7pczF1Mi?+P5@elb{N5N*$>*a7!xP*?$4K6+36wbm!
z2rfOJ7hYF9j5c_J7GtaxvE>)z(awN5;l;~irp?KBIS(GiK32en_Hl3%Ud%y(^=sFh
zQLHj_%?~@UX$%wt&q$aP@~?$gH&mnqA9CEFFPa6?3>Bc=iZw@*rWMM)WXSr6+D(&r
zhEWfM`4gV3j}KDzS>P5@NyOX1P4fPbuDl{)@(?`R3^x?^IMm{{r0z(FZN(!RG2B8=
ziqAMIT@`FUu)>(uQ|Y*#7wG%*y0dBRTHt*A>L6Fag9T~y(Z#Xhj?2}#B~nw
z)|!ax9pWczB5rVqp9pjE>?FUvS3Att)W)=3Gl?Z5BppO)dYyA=ZA`CsUR@j0>z-HD
z#`OBPF2fea3rq@HSsEz4$k*5^!CV{!ZJrSEb!G7`Ij#oAVUp9nu*}+6
zIqViFBod-qvDU_;v1y#|rfWbX*fl(xKCcqysA+q6G0n|Pm5ZI+O6gO>dk>979T0nS
zGj4!{MBWgT&(F*bU5{&1_JGWk2?}m+D;^EkvdlAJ_`vQ=if+P@Q>aZ8yBV@cLUap`
znnG(Hu*>83m>~>vc3iaF9F`$b{5dw(bo)f&uA98ar|oTNQ$6$8fyeZm
z9eV1EWCJ_K;AI34c|5#Ul=CxaZZV*Q9c_~y4ze0(q0mw~8)7rs%s#y#Rho?=n&ner
z5y*6O@K8&Bba!=P3Kq!E2v4gB8Xg<6mkHIKb_6t(J#3+f)^UBmW4!equX&%F(Gwg$Njt(xEYQZ?1V{3-3+a{
zr5;SE-YnFGMb+Uv7#1dSyP;JwqsH*KJQ-20Q&hq}2ASP&)B-nyNve^$1>8^#a4Srk
zX9r_#yD{8De$j$8?&h#G<)bKz%*&;wdO`baf|4*eoxLTTg|>-lpw8j3ZMY-$weYA6
zp%kk-VY@To+fA5U`uku?52;cQ_J_m02wmBPjO;)reqOj54j#zFzjXa*G60SaWFxsg
z9A3~1*$&)F3g}-IUX%?mApW#i8v!AM8y>2Ix;vU!>{|lT&vA)4Knq!g2DHECYHkaz
zX2DAQRSwSN*n|qE`Bh%u7;YI4ZZv3hvm%%Q{Eev98fsjhSyPRW*aGB
zA=^xZ3u+*=5aC5N5L$`g`KvH(#6kvR=g;8=mfJP5dT0ZACM7JN19xH_9E6wXQ1Kl&
zm_av$XMjTpHku|F*IKE}l&{ncH)OiP>D#CZ`^F
z3ek~rRcQNe=4r)x882{S;)}=46&eckmHY6ZhQHxASNcnMW&_RIfi8(bx)id@iPXqo
zO@($(xB$^$7Lf%K*Niz@-{QZ%;n8XJU*B-?Selo+jQ;87H7{wo7buLbnRu;2n;Osx+mmT%W$
z%X_2AzsTeJoU5i(l`GLcd-(p=-8luOAACCZX
zVJxwIvx28k$`i_aoSI&$iu4{Z6C)AIOl+|98Gu*BFhku4OxsTIhG%b;pxPWdNtWE!
zWeA%_Hz2cdo5q{rUy6t
zqJsiGs;#8f&kDofG;`FuHDlW036p9zq!vH1=+n)>tQHUoB5u+38_{ec0
zOsMQNU5*PaSrqAn+BE;S22*Ik;b79a+8)b2yeT*<5iDsT5Sf=i?5RdUR=j{sQ)osR
zvlDwE+Z5vqv0@}GQlZ^aTeE9mco<$%CdVdliz_-}Ld=g`bjJnM&`KwfrVMM*_r^rS
zza89P%D^*17f$FC9TW#|)ZIO>OfdtWpt$IAw7CU&_dtWfHjhmVnupNn=}qrQ+LU-v
zb{yU@CZXgF?ql9PutZb#>HXPLac&xAV+;}hP;f~QY=O;(Y}uLswL
zKb%~_;F|1x1B*3{EJH9N4oY(0fGLT1@Eb{rhyT@oN5g9g?;BXEgu0jyfr{ag+3hHa_45~y!36x)NB
zbUc%9r5^MnE-CWiVI5N|BCyq!HLxVNhrkhNvpj^CoU#cipO21IC|_hUiOYpP_(CoD
zelrxJgNN@U@%YN53xUYl!IU6U9FwjvIEcIazB#r@tJmCq;j9)lUadlAU|?^}89e~J
z6|QgqTY9-$`d(+krzsK!F{&|Ig+FL(XE-}%5sh*E!60UV_;F_sS(9Rg$R$@$TZ80h
z<1*2~CDX@VYr8!F2OwG@Cx!Rg{!xoIres6I`ubLJY
zQTlT5Aa89-Y&3oNeJ24O1~IL!>=s>o0eaUJETDkb0E=624iOpA$eDMl;CC{fcXwNR
z>dy)B96t{w#M5md9jK&@cA-fhOvqQUEfK7P#j3
zKr&rUPt1tpb6a9Y80WVo0x;6=N(5j%_@o2a{t)HF&2CAy03FH#{$9dJ58RmJjWN4N
z+O(N=ynzYl@Sje|kdCZVH}kz@IVztgEinT_2dksewlVI4Zb-niYFou5Ut|<#A98A2
z2ZMv&S}CmBR#SKiv%3@WKF*Z;FvXV5$twW;HmHnhmMe<@o$LYAT1|^b+$+zQ6Uvh$
z71(E-3>oM=zL}5|!izdPQZ%Qm+<#zMLhryflpV|^iNuDW*Po?xUSG~S43EeUjzI>IUgLN%H&w9pf4
z69}DTn($~%l(ZXQr?sA@X2&vx{b52LNrjE90?3zRZA%3CKxVS;dAH
z9)j}@ebybKX>!61$cR2TZQgAy?0_lFf0kBE?i{vhn6Bh_c|QxaI{&27Q3_%b+P?FPPAZZP0l+Fn+asGwmw
zC&s47E34sQwHCYyimO`iW_Vhy1#f|Vs}{T!w^r<{)5~`00_4WrNkEG*<#d8Bl;o66Ad_Nq75mjC5^07oH24t1Bz|6D$Bs$7=fVd=HTg=x
z#0o~_u?dWL_^tae3CW_fBoNC*+rBVyPmPe;gU8rLy8BEWK8-=Hc`uJOBzz#-Ehq*w
z>3@^F1!ap{`>^snoV@bj6k#D&fjKvBUm}Q^;hke}-Y+jn1dyc`B2{}FZ5;;DH$9IC
zz{p4GZLIE*w-wvmdLq<()%`z{ix%Ya(d}9QkXqec-7$rwA~;d`==NnojiBPt&RtVD
z%1%huB+2NASCK}r6>glJ%YJ04Bq-%E%F_P65E&A{HD5Dn}H;?XU@-j@&!Y(6L7_$K$Z~rQUc|F)kRWPdWZSa->)c@)0SWK+
zZybRXu5!Cb7$IW{adj;OQn;oj0=y8ttQG>+7`V2yJ6XI8=sI{|t$~1!g|8{gwfoI1
zM_XTZT_Du^cG2mT>{n+x2FL?-!3Qs1^PF@GzX$9a*u%?3so%I9J!r=eUN-X&D}vJC
z{Y>2N{XitYV1=*nEx!Mp4anC(zZA*Nro<`gUuT0sHJ);?peR&~mbXGpds`$!v#C_@
z=;XH4FJ}X8Kv91&3lJ|+Zo?he*pT0t+bXY<@?xCM2HjvN(N@~}@qE*!BuKs^*8{z8
zLYjO>ZwHj-HY4c*p_cD0=1cxdtPWJ@fHwQZN#wwq_2Ux09YbE4e)w-G;o!@{f@ZWA
zia&*ANGqi)3Qwkb^BC0jU`og#8tx$Tc(u!NYt#qG{@yyc-gc~&CZLoMP7jLi(fO1mD~+MFSi#ba<}$rE=fQs@-)a^%F^n-FDn{4
z&8pD^Q(_IT@MCnSwvCy1`Hn)z@HAeYkhf)oHCH8etb;jVM&U^z+_)S^u+|j^fZ9M{
zP{0wJeY3?t22>|tTONHr1atH`s%WuW5j6h=qLjW-AsSQ)00@R
zU`!>VkTPMS1w0l_t0{CQgq0`Kr;?;jM2oHa7MtdrgW(NzfxQ}mpObi)3=8^FgE3cZ
z0kJm#M~21x{BU)2=hUv$T&L7C&g5GogCbxV>We{_iGrx$a+s-QQS%KSep78#Wm
znyLN&tXN==mj6E~mN9-i)pep_b6)0py2~J)=8$YpV>n0;&c{{sU1j*u=uhZ;@@irx
z9%^Mfv|vB9y$bFK16qdGLWvMT_Bl^(EIhH=*}8PKP4CzNR_}y^tFWCCsK1o@yo5F&
zJ1S3yh1wu80d12!q1hH*ZLFB^o!9`1*1jKtKoC1$aN(M^6Z^La>EB5QxY<$>
za)lMq71N057deX_i4V1DrPP&aN?ihTaP6z3l2MwQTcQ6t5Yn2pP*7WuJb_YA`x@A5
zT3Hn=ydpv3cRsJra|6ec5V@bf;HuaTs|XaG3Y$t_4za{V&Lyv^m0T`>V1S5l`QzDu
z6fV89vT#bsfh$~&VHku%=VlQ^xAHZ?omT#v)Zf}228w~h9fsv!-Tq4;(6l!VtQv}S=y%OcmswQDK<-01G@X{i7qUJTEu$w!(fOvPTPfu+
z=>jpT;>0KcN5rVzi8ZwHk|Z$(5knpi$^8%V(nk|hTMkB2TX|^9iB?E
zTXjTvVS9Ln^^kNfcybwW^^}aB`>)Wk>Ims6?s#wbzfxY856jDZu5x>r&v6xdX$$g9
zX9CIyU4x75TYW243&`fOC0|Qx0VM*y;FejemxNhe-wIa*1M*f<`WMjcWDyf#m&xYx
z*s`OsCB(i3!&h+^8bX*e`&}Kpi~)FyTP8`_EYWTu{^KV1S<#qaa~DVVe%I+UZyFZwb5z1+>rOok+vl!
zu&V$QxH&3fr%<1#xx!f7?i_};ouOIIr3kXM;Iwo@#zcIoP}_XDKYp^AUW}hU2SnR5
z&b#LHa`e{vW6;v6h0mHE9UXv^>9bSMMd9>b)z7L+nZTLgybk@P<|03xT!yImt7vSd4R_$@#$q@3_dv@Nq0oy9
zb~wq1#1=ccdvFUX5?kKV(T7V6M;K9{o)z$giIL5Vicd)w$z(ZY9T;jaIB>w|A?EqtC6oVw%aRV|yIMN}IMaWD};$5{7oTlP6
zR+LffghFLB(}P#D0_ZYFLpoHR%`_>!@|U&`z=T1{FWvR0s#kvT87}Xr!oub_)0l@j
z!hVzfJ-JEijmUJ-j=80&!TcZ&dAulGTSe60u(WHjFWNCDkH-TW{D>k%FRJ`3MtgS_
z+^`Y+=3lf!1-~;edsXmTkR2E;&p`0QxlrO%2nujnP^Q1wG9gOK^gEm5Wm={Megw<(
zBR_&=ns3W=nJLqWK1xSVKK0K~A&XMTUppC$Ez365jlI$_FfC)GJthxgs7x!wN5D>T(D{b;4cp`EZx8tOgcY2(?l
zhb7>%qK78Lv!*K(;#pO`$*e7~#L{P7mnX!tvJJ7$;HLP+Xr-E^Gh(gYES(W+_2vqT
z7;E+B3QHJk_2vo-7;E+B3dhyIKY6BG~yI
zJ39g_8Gvv+cuwu{mEju53mn))Y~@|~;Agv|uo~vev%#9=DQYFVB21P^Q_bPURBNq7
zy|*%5h6FXG?sn_5q1l${-Dq0+?QT&rz;ZFuTk6S|d$1d{6}I4>xgFaEqf~Csx2KlH
z;^9gh@!pGa2A})f?ct*52P;_nMh9`%BK4dY2)ilnpkNn!PDoy0#q#Z<6T8(7IgNz}
z{dO2J*fq|?qDcM)TE=1a@?@aUJ#HDFpE43z{AJz(Rlpf$!rEnK3JwyDltuBT8OfuKhJ?M6HcY3}bD&gj){
zOnE@$a#W~0^fs@_X2{hAX%vKfUgj17lFCg?j7?;*t;3H1zG1&?Rq0`HX$q%u#Ml~M
zW*hXdtO(CXOf%jzLk8hkp2%;x@T9GQ(h5|3t6PbJXcLu9cG+04T+WH$1fW3i>~
zjj+cFum9x=+xPwPShVi7u~@e4$78W<+30Qqx-i3iceo$WLOQ@36XW@+e5gMSJ|C60
zORDJ{D8zmf>rCx2fR5wgftV`Pp=V~`{>C0Lu&0dfY)1?WcdaCq2>B{8(yu0ztyU8$
zJq__m_8-OeBzrH-UolmUDxYbLT7xP1%*kx|gwlA2Bo{M{sJf(VZ3Ckh80Ew#oQj(OCx1V4UGH{2Z{2P{RcbaxSpZl;z-F9;8vm&@uDN>O(=7Z1!n-?4#s1L|$jhWL
zFuHTNni&}%9-5lQYaeH0RS2jx5L*xIjJ;S1+m9+n>j~q^AK27f=ool{OzG5h7VmBw
zfyalH@st^!d&4c(WN@p3PoD+6M!~1e0$!`&Q)dCMQ}8LXfXxGICntj;iDJBO!0j2U
zu<$DuFujn+EbEFrTu_Sn&Q6$S>~X3^Mu+=MTkTP&p-e;>!kReaE>$Mr1l!)s(r)X1r$yt}fIA-Uxxfuo@j?B^Krq22VEOe(MP}F`9wVSQDcK7{}MdXaxoh
zA9NfYo=}c8z&N%h##&$;QxjtyFpjQ?u^t#l)x_8Uj3dL{8*Q=GKzXb-3S0HpVU(ad
z?QF$$|3wEvX@TaY(X`qTY_&L*by&EqZ>waKrZqS=J^)Tj6Rx)%0B0>^Xkeb)5fo0MGkk&Lcf$==a)c)vMvRmEUf^GZ&Sk0?j*Wsqj0kB$EZ&-u7u1_~P
zo@yo=yT8)k3nQnESatH5-p=k^CDYT_oiF#}h>Cu9by!OW`73Vl*62^d4I4rUo{-$_
zN@w!Lm6pE#GAFlt~6O!?9a*5zBUEdV6!-IG(qnC23`b
zakPkARJgjIx@R^}H{K4i^jxa-OymjMrUo!*>+FRn97@5(5=$i4zqh-6l(YmA3~=nD
zR&+GvWU+f;EL!w+d&2dH90ntw{`MjUtS^W$8?ZXw%an`}4THh&i_sTmW{;D{n8L_o
z<3LunM>h4qO~cPnV!{&gD7LStbv4H&XZIpz|n
z8P}si5lt}14>vsw>(Gv-bVB$evo&BSA(&rc>#Cz(Rj9*B9JfiWY!wk~A7eUq?`#At
zBTi(@v}K7MXN3yIGD5|zvk|qT0nueTzTU|ej6)SY+2W!nLdS|2q~k;kp138pP`rXx
z(l8~l#y;B)ol^}5(ZLCPXx~oAD&GRQzbzt+2
zLQ8u_x9^%56DS?4sRc@qwlBNUI`95G+CG5R3*}8E3;bIQ*yVupV{}cKiZlXyD>l-A
z?qNbVI5Oh!m4e*~F~wX95CmU@X-sZ~6AaC7?>bz|TAi30f~kuroWwO~J-y_Jwa>SA
z9W6LraG&!M*y#@ptKScC69nOEHd-X3IER824`?kHTBe2yUII>D%YUc>i-kVF4qUMk
zdJ+ahVz2Yyu9cFkV*<8ZQUM-Jh!3X#VTB;DKn}i-&29+jP#`=vink__`T-W%K()w1
zJ^+v7G((H5eZn-8ewk1Agcy!TZ8g=z27Hq(YS6yrN*q)-YX%18V4Pru`z*S0&~5vlBI6>4(**auUp^ob90}ZaK%~}fse9cq
zU{GWnT;muv*A86*yu7~9V_7)@cp3w*SvmjUMVbzP!ln+mG_wqG5X}>da-7U24rScS
zvPTmEKKw=Ia13A#N`r#AtNeQ%vmOA=eG$(SoRAZyxl3|tag)h`v=FC6N++r4(cnj}
z6fTX_znF&uTql~aX(Sce03gp?!lgqy0Mwd9Qi=iKt2_;tCCT;x?Dt6tr7W=2^E?*2
z3{e(<)+H4aWdUeI5=kiwfS1o!7Qp`EV15S(*Rwx9FTEo_N-jooF9kI+%8@9f3M0B%
zbL}?L2oI?=#X?CzkjQ?s;yYf4ZRiOkYp~*ID&3;8W@j@wJ&ZzVPFe_p4cGUD18|7U
zNYKI2FUB&UxtRSk*o;gzr@AXLQX!sOn-$+|6|#L{GfHA~9aqXc&+W@~Qi?b#5!ars
zNj}8uO2ms)TVJ3f`VLGCZIPuyq6qgb!qlG+V-6Jz=4+>vaa5U9+;Dn(E2V-?)%4n_
zGIG{n13qm>63#quBS+~aEoKi0R7i`7RTHFTZ>x8X4rE%J$yac`!#9gKH2
zQ*4iq?B~}W+4uV+`=xfK-9M!BkmcS{g_9DvWZ7lM<^8ja++RcQr+s?=&;sq#Y!(&(
z!R!vG=I|IJE=7ueg}JsZ?l)~!&UP1FW%;mYKvUbIobkXf#0wJI#rF>#D_O!oVPtHy
zG(NCB+|d`I)dI{$!OToeO$=?Do~p)?SEE$g#5zaW#Qu=@MRKbK72TK6e9yNP-IrL=
zI$P0wrqe?e?Y9-(cYuoSwiVqsbij(90{KK+W#7<|(kl5vyg3T!dTkD!MmpI12BGU=
z6|r@vAsrp3~Qn4lH~
z{Ru0Kf^=9B)M};?>>;c~3C2>Wnz~eII-GiiOKjnsg#vs{JTb%qVao;1W!DrcNDQe(
zK+BzkCz*zK7W=@@UME#1p&9qfk2x7A$fu`&3ta8nx=CWUIaRnh;_9@uERVwb1mT!S
zcX$NQNHAWpM;JC+SOXWg;$f#oQ*m8uBRe1EPVY*Lm$}^>X`BwO-&P=;L1iH+E#3cGTt^2LV>T75yg1AuNI^Cm?!Z>+5!Vx8
z1XGz!@uu5c%=D>#YL`1a)WnuSQ3j*ZR^0(tU{ZRy_`2;t3BXW-uX72y-82bRu!NJg
zOm`)dE$3ko;JJe~mGHS3Ti3H4u_QE8u!WU@WEenJb%37x*L1Mwk8&lBv*bZVUt&SyTS*#Y?fw|nFgnt_B1*Gn|FcW>b%_Fhu3ML3VNff
za}=wq(A};`kGrx2NK`O+WPao-6ktH9ihHzh~
z-HQ8Wb~TZXacq4h153wQfo-_OF)J|ZyB&>^ZN~_YwQeSx#j8p>5q}vO1{{!v>9bv!
zG-v}H(}%x~*Ibs9j$DRHX^2Jk){hR!EKbOVCdCn)egD?{G&PIf2r&8
zAYH&&R^X|$ZO>G7GWE0?NNbv!6=}5_VlhfhtD9RD>z_5SU^lT|vHns63w9HxSii4<
zwZ3VCDcA4ftxEPe)5)oRUJm9Xc2oq-Lk3z0`*zpl7ML-xkAp4ONy&>=QfF@x)Wyk4
zXUas|9tXM!_TqS+UHS90JbbL#9+~CeCF4x(60|B(Vy1P1zlMXw61AsYO
zkaUkZll7n`*etJ%vmr(~+vl28$O&iWmE-QnU=+BPcPj3%Xpk6XBLT^(;2
zdp+TP*Dyg9JY{7&qz!YfF1eCbg@6GOTi
zU!}}PA`;4xKqEY*SuF}!p4JNu&%E80P-`)Ayz~m&%1}ftNIC#eu
zQ+wMIyGw;H%)S}r(M@2Xu5pZ9i5}9(1;tzjf;8d=qKL&@CybkHYUL0a`P)cp#%*)E
z0{GN?$JPpCKjyYBKBtny!}0xneFZ#1UMRt;$QBm)Lm+R*Dr?Kt17vcYV#H<23bY{3
z3ca0u`9h{rXfIZ%6NbHT2-4;tjbR83(1SF`hav3_a$Fb!xgtnI%Q!97GM1pjL5>MS
zIvwQbFr>>tycbSME$<*lhSOwlA=%W_dr+Ba+8o5QY9s{4PC=Se!qnOwZ80%5C%&`yL0JcM>2Z1E6sMEItMkORVI521qy-|!IdRsrtL
zxI%Uk;lDkEP9XGq2wg<@x`)sOgtCW_C&Je}ggg*Rm^Zp3%-`IBlTJK=#5bEYYDpfK
ztl^BYlxf3T&d+e?t`eW?mFUYrQP-%t0Zy7{If^|nDDEls!E2_S_!aXgdlwu=c#)G+
zgF|DLUGOczY0PD6ex))rI<>YH=Z%)N(QD80gY4>;Vg2*ts&bPWJEz<%TUx0MR0p;V83OOY
z^i#kx4?r?p(Bcphd%7E3T8e8?be&}L5W&QJv(m*d(bHT^1xsC92aJ?04r00y^M_DO
zFJgY@Vqhl@=}9~tDdmM7Y`02JW(zKWTT>9WR4=SdB>pV76?9joM#kYI3=D|fG0HvA
zYa#io;VMsQ&dK3E?Jr!aQZ9#wyD&L;`mHDnBre-uOr0Bvokc!4kxR^?KY%;@6zqobkFmUOuC=C+Ejvs^q66qsA5w7%||myFLBb9HqmYac+jQa
zZ5r+CetHu})?c$(usi6&AulfI3ffjF9u{JD#ctc~WS14R&_&XnnTZ6d$&7y2Y-Etz
ze5}M8xyU1Wxhum!ken|z1R2>#?@G89%tCg>iflo@aUH&6XLV{jH~=?G5HX28&P9w*
z1LM=-h)IYyOH66%gv7Ja;JUud=kHwu6L|B~_F)k9cqr8*T;Wc;1c+sVPov
zbcJUdaesZ-BRW~FUI3oNR*Y1Y!lTB@o*{@7dz&*(`1L6%cZVH
zJE~(la4E>9!b1YMk_?X+HU@sz7{iBvwag1DJD}5?!h@pIP^)U(k(J6c-lG~Ft4vl$
zhIWlj(ok)E7^EjSy)-ux`^
zK3_^NF)6liu@?tm^>T&6#p9Y3p0dGB3c2?&cN>jza29KaHXeeW0s{qw&^%X;-SDdj
z`7R6NUYG{I(v@SoI1n}R-~~>{rtuUQ;r`0JvWYA5_DI0Nsa&j-y7O5&-|5)5+6>~;
z9fnG3c&HPv!ooBZdVB7u@KC|0JHgr7qX?ITPiA&g*PU+%8{~O+aVXF2&-EkYT)BjU
zYOA4Cc($(}4{jFl>}J<_;OZh!d5=>rmje2dXq~|h1kZ)$b0yT-9=9m%9{3#W!9f)I
z0rW+kdrPzmq#@N5K7?KW+oYyzT1$}`TGs5w66BIdJFx2T2VCgKDah7*uDcyZM)r)<
zwS(qUDCax!S@`uU^p^UucyD9+ky&x+9}o*s0|4@I}gwQTeU`K!f-(sqvI7R
z+m%CY;q1WFyRaz-ccg{Q@PA^hpj}=V@HlM6Ib9{l^@^mTqZ!dj74=qB=_bp7$_8bGG%e{*wNoB^Q@HmT(oYa
znJrXsL?SYH^o0%U>)(*<(*J6(;f8arPbFRnZD6l8!}8
zm`<1kTpJxT9wD85?YTbS4Y)Cr@6C4O%4%h%4EF(@)v40LM}i8Sr}s5!;Jt*2(`l(2=e)<>*o-d+PTsGaX54zo1TE1
ztJHtE)hC2lnw|u&JqR)1E(#$y@)_9EKRSh-m(J^Ts;-EmVAr#DApx`+w2d^$DM^ht
zG*X?QOOlT1(d{($3?6Z_wkc5K{B5{^(o)gj?6CI=*b4A?sO+w8_C&&Rv^IbI4k~4jH34<+A
z+SCPqe;7cxP-d&Yo6ypxYyf)HNsm3vWr(a+nC!sMzdD^}U$Jm*d#(e|kHF~OKHkFq
z2wJ)_1;cvFK8z3clq%(d*&!$~7!GlKup`rrhb#XLOpQj(8y_qe`*YwiyqG?0>@e-|
zVz}1AJ)6}!f)mm?$31>4?g`kuErc3lIMue7#sR=Gi%qGw06i*KaQbN|=APT1FJgO#
z#+7D654aV=QflLt3|GCcNyuM!xJCP#O?}RA>q<8^Cb>`|o!lvpg6n?NwzZ6P%e$XG
zKFA^Cqu|XEw91R!G(gjVqbZgPc+0g|gnPhVyqxZPJBT6VdJDPUGH$0>?kA3dY>WPt
zrUZ-v+?Lj$(7PpHfGhnP7;TyM4qV@{D?&VvOlJoAhTU%6jH7I3*GWf!)viIRw}6g>
zlB@=bm?NYvtcB8%>F+LsO08P)nNi-1)Ny=7yvTUhzEsA2wi-mXwC6Tq<*q@b7mssp
zLP_kt8qWvgneYG3sYNDVB8tbW#mVG*G3HX|*P_x}DD`E1%epv~QePfV!S>gxbg|G;
zf+<0b8uj;P%GoaHR%uH$Q`-4lYqeIU`Ceq&2?mv%nPoZR)H2;XTiXg**|OvbNGKVaBeRLid!bf)
zoLE*}{Vmv(d-Iu`u4)L3wkPruAzTwM9g2qAux#
z0aQ<}GgHZIDyB|y@p%~c*!Y#QZ4$o${#P<>mA-to85YjWRxi$Zuy!mGrbzdS$Vb?6
zo33enhbFv97#jjtSYS(Y59C~u?SmRbPhJ*OI&$qGnFT|~o0v?oxYUkvXSdS$5?-M!
zDr*Bh-a70yv=Eb01#x&Jy*uBBX>y2c^n@)d7B+Y1z!3Ijn_FgPV9!jSmxL^m`j`4z
zTULYpu(8rw8heN^CB$87sNiUc=xU-!z~L;45O129!4qWp?n-e}dkN=iw!ozfFhCVz
zPB;$vo2SL3IKbPm1qYXi{k&@hmV5Q;)e`+}S4s?wbxm6&_U>@(8jbx-ES5$1N+@=N
zp>UV*cPzww*1l^!g>^EWjH+i;ro5r4qu7dqtj943MG%5kva0NiY)?z2yQifD(>E||
zWM&CoAt}SqFS-IaD8v@q>+BS&X+aV_Os0^emYQhI2v26)Ji4-_re+9>ki9l%a8(s1
z_^
zP+CH}k@|(Rre*=_XMuLj5W3tgPfB~;`i-lLm5q{dC7RR%nQenWQz+Joafn^u#NjI{
z3n2g+q3+bDWQY*Dn2Q;nq$(D$mT#8kV)OzgfL;i#J0@?
z?{(qi!i?M#P7cK!*3LmE$uPNUC4^o2hLfZSX@jwHMF6W&Vm;Gc45h^O3+SK_Qr}(_
zM57nA!JDXw{f9&D_oCnDkjq1s#IM3xQrd0Lb!WC>v31-X$|CwGmZbu-#Z0+?*$H>~
z*3Q>eq!Y_6^edi*fiOu9!}xpw!d?ky-d1Xsib5oVR0w1J9tuq#@mNnb&{j1-5_2Ij
z1wvbgx<%!{mwVehlJ#!FJ_ix2k}Vgpvcn|kiZES4pa=NUrodw9xnUB3RZ5$2hq#OC
z!F;I*Yll$5C1dy};Fb^Q<$&rzzzPxfbE8x628ELix>k|fq6%HE(3znr3;b!gY{rU0
zgjZ35lu|pRWfL~VYCB5M?O6>j8x;}|>K=^wlv9C7U%^DnCdFwswClDOIb17Kx#~os
z8fVN_8xuyp$75I7SKzJ5o~rht!kbd!sUD_Oa7rtu56fqAGvn3mQ&qfnG|ZcORXoFE
z9b>7QWO{sj0-kp{PA4-^sK~Q4p05;^3k+GI*p7|`qw7>eFLX?sBC%^DIKKD;LbT28
z%6E2A>10(+ABqfrX(6K)1r|7eJj@YlZ_%j-np5nw)&;FpN#3G_Ix){7F)=+p6=()A
z(V9$iKb0lcW0guC#!j}$gHj<%oO2EeM{!n6!~MixvD7jeOMViYHk
zL5`0_ay%ciNvRz!TDd%Y^Gps6y4J@5=dp(3??#Ygc6wq04>j4|!4bvs)ckt3!0$%p
z&zKB%hX(~UNp9JaSp-L$PG)4!^n)EL^mgPs`-?JPd1S)lmbbf2pa%y}yex&~ks?Jl
zyb|=6xc2xsurIfYWc11=n67j}FtJ1Lk51|6fyKE>9-M-j{4N=vDUXd8cF1-D9vTk3
z#L#En_>A~J+U8;I?xTe#bkq}*xP@=+ddIbCacamXs3z%J39n$SMpvml)FM1e54H79
zUhTghBS&wa{&S>$e0n=@G1OrIhFK2f|KaB5?>|SD%f~dj-7%lb-Jy2YaZO8OpWb$~*_-=>|
z_OMit=vf_FSKAm8NppB@i#AZWU{ZY4>XLt`G!~8ln2_a>JJF9~RaSUo0Pn#u?8x*;
zZg+JeggS^$SJah)DlKS_Dj?@sOK&L(9922sADt-eG^D+`%}}3XZN!#~cW}xOysWYy
zQ2Pf*BC=9LD>Sl(;HRlqhU|-yKrddl*4lwi_hQ~S_p1cmZ8O!iQ&%ne5VC1Zd
zAwZWJog8B0vNtcX$=TlX
zqh}yoFUnoQ=}}R19@2J(H(KoaT0d})IV_7(y*tCq
zCAMOd_@po|V=5=7rONP{$P^9In(Kk#x9Upn$A7oNJ*SFvM_B}6rtI^
z#T8T#(1&PWa@IIP$Ku?Nq5n14sDgtdD75%y2n}*f+lEEE7e-um)F&aaF#m8PG@&q5
z?|C;>9R`-^f}Bv~d%M6Rb1I%{DtcT37MQ~T@fbH}1yPjr+%PcQf-`zNT#L)Ee{@4)
z7R(ZB@XZLp9vs>m^9!6QDIfOE0WxVa_-`wHNnW=CJ@xFtc?(y=Q*>yStv`9O2j
zk7q(GyCnoPsTvEw2GptnW59sG!;wzzw6+GQm$5y75w$(|7eYx$0m1eN!E$D!F<$Tp
zo*yBYgcJ}wH`4f~ig5!47%tnRHNU=b%z*T79aA6)w1uV1-xwLR4iqH*Hz)OYiP2~>
zvObzfx(_z6IHC!6i;^bDi5u^Yw4&k|;z0?nO(ewPJ3{YrB92$e5KchuwUNmX$up4W
z?sAK{N6{9|pan#4O3Xi0*#Py5$XM3=b?HRkTCrMkl@-lQlueN}$b$v6+mn(T(wmbO
zOOf~C%DaqXfcHiEQs@f;9;UJfLatbL<-*#YYKqiKm*V~sWo+mP6KVxfu^;!jH$;Yj
zBvhE|UT?#3`O9KXrGc#GIOq(o5o-Kl+HP)S4EeyI@%|8PUz(?2lj!LYQI-`sH8L5L
zOm0gbPqKX<16s-u0W);kaet0lN>M=xnp!o%Ilk3vNHkBKamEndcXFFpU+7t|nVPCC
zi7Xs(l%RrtkBodDlU@redd&N=NRPzO*b?VPmNp+r?hw~iwX%LOl3uZ;N}&KU6`f@S#xMdlC=<#-=X_8jfl|4Lc`Jhaq%YtYe-
zqCp0Be`_NY%Z_Nc{FgA_H6tt(mWPccwypb|$cXVPB)hW3ym8+uGnq~kZr8}$!$@&R54bA&=
zOrxw*a)IpP8%7#NpK7nD8ljYWk6Z9Zrm{5Nq#y$08L)YoB21`o$I=dhD2DDC^TJK(
z>$XH;y5FrJT1dZeftgUdm{Q_`QpD0QFv%o48n(zBjkFONebHTG;q(szUh0}$+S1{L
zbfh)eZD2cNT
z;C&KDBp5Tc6=s-Cko~W{YGucYxO+w|kr?g462dNAFps0iPFWW14wILwJQyb*2aFhn
z<4nWje#W;OwFLk5@@f^GAnJa<5_s*
zC-&^Xq3uDzpzfpMM|Fya2YJw<9%d6*izK7#ZAMqRj8Z{H^RM(W+KM$vb&7{-M%1`@
znf(-FMl*vhQkNFygQ1CHFQ-QM>ahjWL1kXfSn*JaSX-HwvpBrdx%ld!I4#h&SY@WG
zA!@fAounBq4l<;IWu2vb9ViF+T}aAoywk69l=;A?77eJTXlvx{Q7xJyuojj#LF*HD
zyR`l~oc!YwD#^~jZfs#txz#v9PKa*CPzn5{5_?$tb-lRaR-gHdR?4Ln8tKGImok4|;Mk?%M%e{;OkWX-|Z
zXV4m-wLQ@UqsJiM&jy8Q#zAFJLL1qF8}&iEA-!$+&5V_C>8P%OC0!hMEmn|7Ys&hH
zGT#Vvqf7)7q-x48D6y@Hv#cXsa$U_V(z^Fb{3dw#hiII`p@X$E#&O3KOh~Z$*d<69
zfw&QI|GpNJ_tTiDghNY600&BSyc2GsS%HIz=khDZlE!jLOmN%2wWe54*97pge^B)~
zWZycIa8;1-AnWv%aGl6IX){C$*i=#T>%Sf(ezU>|oPO;shwD>O*7m$7k}RgH?ScRyW3n#uf;hfrBcjRIIN9))RGnRk)MfV4)+I!e+cr
z0E@0rKk^jc_LV{L-Wp_AhpFf&`%Nt>it@MpSOZ~2E8_|QY~WX^@5y(#QKAcuR3ua-5D!$lt_*
zs91}t=DHhVzw2S@Wx7GQwsEQRqq||CFbLV#E~idd#?jGoLvvxZcZ?osVXwf4;)5bW
zti_A5lW?`-GS820hZ_y>MYwN&yum!Y3QXA&HV;khD&PQLFSY*w+AgJaR0so7r$f5f
zF)t{^)X2
zW6Eapw(XKW65H9NST;UABgD+R(T`v_2y43d>hT4z5Tc#S
zB%ax_Vk}3#%L6ssiCnaXOSFa*FZ)ZdsR?$<>&NHM7&XKLw#wI|%A!z^>V25Zf)w@o
z@x`JFG4Ix&#J)Na;!XPc@ugK`nLrM{in|AJt#8sSpPn%=Tg$Dir2#LSo?$Or*u9v^
zI-0H@Z-C|1^eD%Tj5IJP^_Fu%Va84K@Ll`$m=)Ry*N-1+Iw5R(aV_fSEgdZAG(0WA
zH_=KnTNYQvoD|QMw95aWFE)Qd1w6mm`WMG(VpHzh!
zAD++*vAA1p50*+%;09+}xcKExV?b7|OyA)4>M2ATtwdu<%*^!fWRd6W@YE@&Zj
z<8r5Wi2)r6@9k+~B^ZqEaY{HXOVnW0;~j`l!u`nh{%$BpOL}I9O*rFe>O&~dIN(+7zC1T;Yo!BYt
zhPodgA?pv`bQ{|a(y+`6=Kkkh#zLq(X0CSA#aF;Vup}m$cO=v%b}80r*o#Smfju~C
zweD$x8{&xl9!8!PYlUOiHxFE(Hnh*h1W{tkWYKp!)Zrf6WO5Jgf!`Cax@EDX3Z6yR
zcjCC#m((H9avhm#uHiBo#7kkpNwO=AtEI=^ZQe5w0aJa6*Ewq(xeWM
z?H9aqG;oU4g1q)T~FxGeqaf*joz8r+T4XF?s&3o!uZ50s#F4
zG_jLpWTBHV5Xxi0rTw}{zCrv?Vq;2;(^4~$F=e8+%#Lqu(Qr
zV%b-m!>x&5Ab_$4lQ4<2Lqe#O$Dm%D*aM3(JE*LpUbfbIUE3)y5v1VVbInV;4TUwk
zG+io2){c`6>M^!hGT_3y-_m$GSX|47q11*h^FfFV}=V2AmLa#8*3-!#<
zc9YjD(0aO?8-`5ycT9GB<|By=TR%Fe!;lV~G;gf_vKIVbD*A~go1J1SnkV8;F4aXwys0_eLP*Wy8Oc|&R&VC}-N(Ov3LTq}T7RUVVu
z03xDbZhjeUrtpyFAd4&Y8Bysc?V3&^ux^UB>h
z1P_Vtn!Se(s!iEEVvRc@fKXy;G(d47kS-;Mmobx+!LjP
z9npmLD7ns-I+QLPg10}ao2jxMbZdaF=%^CB$g}fU09^=ga7dCLcEY#~{Cz(EY}5=8
z6~ikz*dYVb4de64iR>DQP0O3mdmJ?>M|M|r`vo0i6G3i2i!fn5L-1ucxOJ#HJctu>
zJ28VgSWZXF@>@6Y$7lT83NLWk>L@TPX?_&TDkd$pIA%?cCbZInIqOOId@Z%UeJBB7kqC)l0VZN?t$EmW$E-TuY=mll;{tW$%?wkwc6p{Cz
z&T;2HFlY!&FX4tR3ukmJ2CkU53k$ZN0Y#r9T$|EZxY^A+G15$cQgEr9V0~|F$
zgM))480=JG`+6Z}uGXYJL>@QuZuK;_jwG%Z_wrtc+=<0C7^e_$IL3%D=Lz8>6M9Y;
z7{3L!skmM0Z0Z~ZtzUo)ZATK4)W9|9C5h$5MU*~=^96S&#;b0qP7ZlBhLfs#mU4a?
zBOK^@?uAUPfFlGz?sgl5GtaTrhtcMW(m>Z*RqI|1$teN_+ld<02phk{@em>j!z&r4
z>0ln3E8fXEor7Mc2^8y@=_x4OhsWTo^kHuS+AYP&w?oPA$=uQ6!Ir`bi<*;a8(_h0
zH5(d_YadpC!i-=eh`@vY$fPL&9jvNslsF`Wa0#SS{S}P_%mPXRS0)g!YloH~kIS@3
zqz|s)lAhf|6&#eNeE>>X6)V&l>LIkTz5dA;%oZ4V
zivG!P%iadbK980~oUm&l=4oj$z^#bv4BTWoZcZ4S9yd<<7=31pd^G_%GLnIe3*P*Z}Mtt~Cvqvh+Yis)!EhQMRp>Ul;y+y^@`K6T|=AxxN9;OMrFweJ>88ig(v
zC}k-`ztXKU%0Egfvn>6>t(P7UItGj=sX5N@RVL#w05=6^HmH>})e@CZjBv7uNhH30
z#^6G!Bd28FbF&~as9Zm~`Y^F1TRB_Vz)(rqpk>ptso?TX$BB7$5tz{X+-&r)We7be
zI+Pyua?f*oO%ke2ra92sIl;za?T-F*qAp$>2JbS`L9V~$M&Z!{w_sWeCn02(nXErW>((N=^
z-FnDR$`Twdh;l20mn>j)tgc<7dFsk0w}EH^QY-*Zym0;rtGAwr9_AHZF74wcJaW2Kj5u+TlB7!s|#W#Ui~se)5KtXqOn#tNaQnzu}>@Y}{T%;D%MT|t)!
z*}%e)x;|YZkjenTq51k00_2n*0DmbvgGwa>h^^;ul1+{#u-8n4XYH5JTIylr8n#wpVrb_O
zc0jbG3jX6@_yRb@OXCoOCYM@nl)^7}GfJWEGp?DapUDhkQy$zS;x`l|pFj%-K%Dhs
z8>cD6_U-h+F$m*g&%+fxM8cobv3?vKn;`B`$iF%t@ervP};DU
zPhgLuHfCZ>x6&6ukkNL!d}6umvv$PvU_pA=wlS&|ZR2}v8(%&VZ{yQ#Z(q*dj*as3
zZBxEJ+?2~@_;Ucgo~7kPGa6j6V$`vKG=9A^w%)Jz>OE+)xFVdzGMmK}(JW~Et_^a<
zgmucoDbR3i)h$Okx
zj-?NvnL_*SFs6V~yDf1F@W?ZO#}AkVb3S@0BDTzq4>|1HfUW%lY`^19*}ou_PA}V=
zPS-bX-M!$;3o`z&*0*xAh?df
z*BN}D!PRvLKEvQE2)6Ct2%-=1=N}oo8s$%4#o%fN?__WdgLg5wj={ST)F07U{|x+V
z!(R{n%J_T!-gMXgLaMHQ5I?5z_j3Hb5;dxS9fP+rco%~YGPs+;*BR_%@F;^nGq?x^
zuYWxQcFfCI>H2r@=hY1EW^gZq`x$(T!Ot1I5_PM;gu$yAyqdwK3@&5v8U~j$crAj9
z**W#EjzR2Jn2H#=uT?YFY>}T*j
z1`jg$J_C-!h95BaA%a#R`Y?a~h{2B;{Di?z89c(^Q3gL_@N)*gVDL)@zhdwQ1{~K7
ze`4@w1UC!OzwqZ@8T^gG-x)m4;2#YBhrvG??8R7bxQM~U3|_(Dl?*On@G1tJF)t9J
zm-6Rj3|_JdW$-ozS2B1zgLg1^FN5nDypO>L8GH!A148sh{`@e5n;6{8
z;1&iSVenA~A7k)w2A^cW1hs~%wRLk5pBc#Oec82pvN;|%`6fRk#~n;CHKTq#6v
z9Hpy%!+;}W71!5Q?BZ3oGGM=~`fmmgG58gN1KHDLCwnEbPQQl18xb_D
zYixKU8o%LA2LEKhjiP}I=i~cVrRFx=!k@P>_z3Yo%HZ=1zQEu=QKE(~Gx#qAzr!v(
zFMVud`mMlE-^$<~1ZVDFmYSbFt}*=!#=IWo*@&%sLAnvYPH0@U|CrRm^lA8hYGe9^
z`1fIqm-KxMxXAVHKPR;)eL8;OZ_W$!ui&_w~Bdba0Ak;lHi;CVla3A>8Zu(
zv(8DkHqJTfoH>n+b*G$DcV=V#vFFsE+}QA7`kaOzryEzDcFwA^8t>SDZfXg}R62bw
z{yvYyX%2<-!wmkwfKxQh`8Vfi{9)spvkiYkUa{k`*GW=i0i2CF4cPGI0pwCdfI>yN?5G1$hB#s6dPN$*8p
z;*T@qc*N`@t>d{qG~!nyr{W3tIN?fsoQRJTzmVRWJ_#Qu{RRa*86PKeZl8jWQwH{?
zPsRUJuTSqypN5a6tmJ9GLmf`XuhY4HJQW{LebL_Z8Tfw&H@2tY<7w{!%9$v|nIFQ(
zS%^97Z7Asc|LjDcW1y_!p7d-MY!$bZRqw?FX*m~v`e$EF(6
zeT~BNdhD(=={aOG>r%_p=Qmz~|10qSjrhM3|KG5GVd_x)m!-9c$ivbvXuKT%56A!4
z;QtZ$e;JUD#D7_J*CO($^g!b)@&9Q2e+B*@gZ~!;=~(<1(V~9;+|+UDDyAHu$EQac
zC-J{AJ=Qo5zzOM>?MgRiHi*$|(>*BK&gydPgr6N%#ne4Qy`$F=x6OJt9K$Jf(E0C^B!
zt3)*V2EJCOIfd@SSChyipWR=dYEFOhkVX+qL?(F~O4q`umB4D1_>bUgjR0>3{@V2I
zz_*giWx!v@s3pK!FYzD5*9H-5SjuO}{J9Qa&lCaY9r${dNI7rB*Rw^`xeQ-ti@b9o
z$UP_hyF(hkjHq)&`q_!EjEF$r!dIK@Pyd0htVl$+;;TJPZv5u`ho*Ar4?G2%D1N0M
zXYfu;$+LjbAsgB?`0A8h?X~#o5@BjDzVaebP2lTX+2#iEwNYmBUHIyjP5C|e>XG4d
z6~209dww0h3Nl(Q##f(g)Wi6Ct_+R=RHc~y=bXk5;-kcm58$KBkN59ilC-GI0#5d#Xg#u--42b-AHIi>j-%!{1JA70(_0iq&*j3W3o23;A>pgMvmSWi^zI8z9vL&<+zv>;q}${ni2{25`0aI
z82bu*?G{;Qetc
zr_y*FfY>Xr!_+Nm+=qt0C|$P{s8CZpWB-Y%i_>*08tbsG*JbdB4C}BD)osBa7@)e3
z9db?ujr59i-O9#o_;_Wy?yyG2T#~Lkyz%+?cvZUYh{osP^7`y>ZwDdg;9zbQT*0=BYXK?LF
z2tLo?XAItOGJ?09ir}3L?mh#-7a9DG!A01}mwtl59SrV7@GGTy^I74;cKA!NUxG%HS6Wu2iaj;qNzN-(LDw23In;n!#NRKF8p0
z247(CMF#gVxSzqF8T^&O-x>T9!9Jz>Uhu0+uV-)rgAXwHAcLD2e4N3ftq6X};8zU(
z4{PTcH_1`m>*?v~?y8yDkp>wFNwC{u1-q=Y1Pc*tz#@amV2q8y1``b!+Zf|(@U=JR
zoO8}O=bUrS@8+Cyj`#nZmRBGn|7@;5)bpO|nW=ZCtLjwMsdK8wYFw@?2P?pOumM~X
z9?^tc_jT!eRCfnd3+@Ow0hqwQORcqC5dC3VVXfv>vF(HCL#f}JSMDYlE`{Xh)>3iX
zXj8YrG#b`sFz^v!5Eu)_fjM9Snvz%6hO+}5z=FabUG8KvD4eq>ek*g>wnf@5Sa{wA;?J$4ze+;uPzr&*kz
zwV!X|(=5@So(txIC1ADi#vf}fvOvn@O$&wEgLJ9(5HJkzf!dhIY99vJ$VO>3&_1Zm
z@2$;BxQ^6%9o?HcpI7>l($|%=YOC`trSB;HT#K2HE1~9|u~iKQhG)77Kd$+#%6g`|
z#5XhZe>2~~P*j#x|C*L|)AF4M+@110K
zvEFov^)T<&n+4{Ad0;+R09ZoQW8z+K30Ml20ZfqfFoxD!1+cG-%t~EDe%(W?M`96D
z536atO%JgJ3HxO|EXVb>1C|3Bb|UQ(I%cKTkf+Pn!^T+;D^5Ko`t=Th!vMQyy`$g+
zI0;SxmKOESf^*=!@K;(WwGZlDAb(M)zg739J~pHbr;tvAGvNF~U?#7B5wK8x+xL{d
zuk?dPL2E6P+6Qm@p;nE$;SF9=Qf)T)w9>yQ{YvTIlo*d1bOXIWKfvOm0qcqeQvnOS
z?)I}A%qEXbp#fId2AEYE?0bm)NLY;;(CQk{>N3#Y8W=FtHelu4;EeG1HSf`PY=Ggm
z!8zf1wY%rPtEAuYyne^Kdg%X!JriLH*ai*?KT}`s5JZ2J`Vo<|KuaxSE1f}KFdQre
zmq33M@LW)X0^SRbgA?E)xFmGdPwXIdP5urTh6*1Jrhutn5m*f7SA+#%C0GSEgDs#2
z>=kZhr4B$-4*^5LFfazp2J^uJun;T
z9EOz(mH5{oo9^4jMCJ3>DU8r7kCb0<>pz=m`dcNnjl~
z2^!TF+JYWn2G{|vgC;UORYnNk%u1a?eg!xN+A`eq0t>(za0N7aMi>n?y;;}{wt;=maJ;6t)QO%S!F`cI9V)o1o7-
zH14ru;;sTr#Ex~GyQ}`?j;imtW8faR4<3L<>L{+U@SK(Envib_nt|q^1)!_BR-iR#
z1KNUipgrgSI)YB%w0ho$vr^AUbZ5aia2{L$7r`ZP8C(HZ!8LFl+yFPhEx@emPFCt2
z^3Bv^U31U^v;?g{YtRO?1?@n4&;fJ=oj_;MMYx)k+Le4a&>i#yy+9w(7YqV}!4NPM
z3%66$58P9{GEOa)8}-E=Smu>5edz-%xF%mwqneBrTOs>Tec(l=YFzcyE)
zmLGcn8c8uefm#2Fg~F3_)drqi2iQM&as${XJhcnhBxElVGm%frl-?nDiapY&m;pb<
zismU6K2IG6Oo+4D${%Vr@*$-UD}7AqlS1bOBw3y6;!|0EUfEtGv1&RZg>%x__?p4W;iW
zY51wDZ&>%IO21V4zeT{=x&`b%B9
zN?p22-ChsTA87y>D10d^brAW%0F!Oqp?YYFab;yN?ECs
z$WI1Sz*I2pA*Lf479wF@ue%s50qekeumNlore>vXBEK1Id5En@yTER+=OJp4411CG
zf&CA0NYZVq^SXz*cmx~;#~$K1(kXEIAuPc^aEqSc)>RTO+hn&vx094
zD8aV|6yVzd?rIY&)%PS%fqp39PI>N>9}RFX@#BE~lL<(8I`~OoGMEZjj(C+HB=u~PdUk+4eiR-*3XdO!$B)9}N8$0K@a(O5
z{3twr6rMdRj~~VDtW>-yJdPBejbx7_g3_Q
z{!dnFSMsoPIn`Kc3BI&t|jl3;GEYvQqn#
z9{>h|L0~W#0@!}@!@zJb0*nNsz-TZAj0NL_(^;wG$xi?i!6bl^_9$tOYW6e0OfU<~
z26Mn%Fb~WJois_hl9k$7qVEE_f^MKYU}EK&Sb3&Y{x0ZS68eJy4>1&JBEWn(Gb{BK
zbEZjac-gQEY0q!sI9bDGB*O!w#^sm62&I-~`3_v{47!3LV8la=LNd%kdKKnyZ7!H6
zd`p%UmAZ}mtFVJ>JHal{zSe(WIufWQWn7u6K2ezs<^T*W|7Ksc!ZfSGmU)HQO@&o*
zg*9)5YonU>jhp>yedum3$M`M1>lx3<49t0~$SwE@Y+H16*V|cLm%5cfmc-n)O>d&<%74J-`q!
z0!##xgqp0>$>a~RoI4Nhf;O1Ydw~&P8dw50frH>8X!LtRJJ1UZ6EdY;nM8g*SPOQ8
z6W}^%_IjZU7z8GOd0-9L0S<%n;I@zrTa^}%E8hhS0As)mumo%Xd%y{B3fuyBK-(vT
z_Mk85FMK__1LMh01Pj4pun}wqhrkhV1zZCy-XOFBZ9rSl9}E<}nw2`3{17k=%mA~%
zY_J-v1?#~Ea1a~@N5L_01KbjdS*dr(-v#YhZFc~jKxZ%%3tom-vgbW6{dql
zU>(>6j)IGz_gnu1{gDi_>T#{U(EV+=r#f|+0`*bEMVOQ7-Z3mrj!FdB>nGr?@(vstOj$*%-k!FF&6903==C2$Ws0Bv6o
z+JnAeG?)pN3NP!djpS><32+5G0Bzqb^aSHy6mEcy@A(gOLNfG3GW3!(C;P65mE~aH
zL+nQ~978f3M*{9bC|m(I0PAGetsr2!KWL@89^`RWa=k!r&t^n4=e{O0N#3T71#{6fEt0_tB!%&
zOCE!>!`AE$fP(<5v%~7_usS=&U5A0hVQY4$z-fTh*)bqH2IK}=sSL{wM;vzxFf6+k
z8kQYnvug!#bac24y0)Mlz?s-}038ATgbv?gpOxB$Jid{xALtJT0KDMbD8RJZF|Bq?
zs~yv7$F$lpp>|BD9TRHDggVpOj%l@Hy6l)PJEqHyiLzs&?3gIKa
z6>I}IWyaZe-9dgQz%|+7n(S~*cDN?Hy#PNlw;vn;2LT?P?l8c!$l;ajjtOnDQt?f8
zC%{E;30wwO03OK>k7S2)m%}63;f(BXMs_$OJDic-U2so$Dl7Fq`3C@(WY-wrlI)rS
zT#_9w$qtufhfA_!z2I0cIMxe}^@3x);8-u*%}Qm};8-;{Rt=6-gJad;ST8u%3y$@I
zW4+*5FF4i68?7MCt
zkN>kf1Wto9;4C-?&Vvi!Cb$J|gFE0ZxCdHjp|U3{wWUPY3bY1ozLTL7?xIV@ogOPIqF=GbX+%fNELG~TTgUcRrZ
z$gc)#z*?{!>;MPAL4d8xG4pp=xg1t5hn34=;BqIxNg-QpI1FA6gO@u4&Vq9Q)0evd
zE&_JI++}bDu$*w$z;$o~+!PvQciB0#+)H
zRpyGURMwh~wWedO=~!#J9-t@a1$u)%pfBhL*tc^7z(By##|;+RWTg%vKNJiD!@&qJ
z5{v?)!5A;FjZ9VC7FVfwI~#`WpP
zzpnHbN-E`XnU0@$pVA*HeNaj7dE(=Zf*;6i+c9|J)5?8T=?h9dE9tS_}+0UJ!U4eT=2HgH>OGpnpUAFu;fn;XoAamS!Gceplp
zxHk8;HdD>oY)RF|Xj7Y8U7NdHo4Z__yIh;QT$|Zw?X3X2PHloBYVQy}sI4-UN}H;^
z8|(qhSZgy^t<7Auj#^}$KTuLzsq<5%e^6r1P>1P49i|I)m?+d?j_?=uHR~`x$iV!d
zj)6%+9VQ9C2Br&j49pbjFjJ_*OrZ{wf(*n&eIYBApr|^ASx5%v40V_@)M3t0hdD!?
z#b60o239@<^N2dkBkC}ZIBxB!4zr0mn;v2_l3_d24zLsKd5C>T`vGA-bq)e19jO|`
z<24`C9Zhx5QuVJ?{W1NBl6qA7C8e(@sYj>klc{=hsveboSLp{zKUUKHP1&FPjyyzE
z3~rd|>4#uFl(IXX;xm?B2CR%ywhYtepap0NS_#jnr@ncS+H75Yk=EKd>KN43zpdL+
z<6+%apfzABQkSVnU8W*+nTpiK09zLWY+Venb(uaqtM2m_>4UejGxJuQ)tlCQTt%Ar
zR`v_)>37$AztRVkKBV+1C25p;f2{NwCEbU5pHuq0k~B;`-HUo(YZUY~4OZ{Zl+&H5
zr@K<`yGq|v`o5CxPQAZT(yytfyHxKdN`I@QyH)S+l>S~xt@2N-LhJoZIkuAOu`N=M
zZI{diYbnxd@QMQ!8y&yqEXDRl<`Q)T>6GwQ#k6$He4Fa)*VWgrtFM}^uU}XHlS)!x
z^;N6&|3pdmrv4V)hWcz2)jtf_EvkPM91~*uhOc&tVl%1!LszJ`eOvRHHoDY+Xxj#;
z#0G3jHMpn>ZEy)-gKdENZ-Dy$m8r1jR5{P-i#?~Be(s}6?e*oK>j*l5E)UTasT;7p
zJ2se}V^`@pwy6v)YCfyq{9J$Xh5<;1fk=iyNZ|RwLPOn~hN|_3A6EK=l4`r5YPg|l
z_oUszhH7{XzoVquY^YjnsM>3&x@!0frC%!jn-be|4N=t%xdRQk0}cBCT3bU#hQ_7~
z8jdHAKUc$f01v)~Y}7Se4pxD6pau}s(~#l+POF=t>o
z+|a<9xS^p7l7V$`Lqj(t5bMXj@NFeE)E5XP>TF;11^)L7#6!Pu3$Q5|PENF)*;UyW
zab0^6U$qx+m5^%v2ijC58FnH)#Fm;rQq{cJ_))pCH`eFgyUq*eh4-=idmqccJhh%@
zk2i~(VF8~X2DS-36~fU;uIZ^6)}CZ!{Y6cj>l{R%RJ1{y>k>qtO6y4I8bqJAK!a{_
zVpn`Yoa-J$pG%*R&?AUGpT1r~&mj6j`j~`Xa&k|r5_$*GSJRS&K0)-Ssh7|drsAo|yIvxM&nHof`gLJN>X+hK`PzYj@n;t~%gOtFF89~$`NT*7g8AQ_OlO@dxqE10N
zQPS)n>KdeDCCv$K-UOB+1PSq8>p?aL@c8>KmklM=S`UenCnU%fcY)
zAEbRHEefImK}t}~;vgCvq}?Sg38EoE+EvohAQ~Dd8Y;;x3!-6x;-He;@*o-+DEKMK
ztq7t~fx@1W+{z#tt${<*svsJp!9>z(1uFzPg(1nU38L9S`g2KZgJ@BZ663Nih*kvY
z_av43DRdJ?GB>5
zfkI}I+@2u17o@4AnjpF#C{QEG?Ny!TQ(|`ZsZR50FG>4Vr}?ypqys_JG@o{pbTEio
zG=3l>0M=x1c^FalGnYd@l=yO$|i<(lrNvYG;v`s!Ad%&rg=9v
z(+$n?ZeFGvn&;j8OgFU1y9JqUXqk5lgLJ$;(JJrMla`~w&B;4yIU3yDyt|e)xOsVZod&1zAn$HyX(4Gr-rWq+4@z2?cek|U
zkhCc8ZU^c6B`wZ7X~_3VT9S9tkS|JFns?HWFGyOJchZpWlC(VU9t7z-B(2Ch>B@1E
zR_2{_sp|N1nA<;_+nx7ceA)lZyvIJG
zPw3O;b0!UJzGlp0Gv6|ED>IKWb0#xCG8P5qJ+`do2^E*QkD1Syd5Yn`^}L3ZJ$e77
zw89#&a^AiPXrck3(jH6&$HCmU2>U?0w+eSak9xvha09HVFAosSNcZF`rzBS9zD?Kz
zW;YNngK^IZ$G|12%F6hL!XD6B_qZ}2TmysOAsl2EaEQjTAvLuq^{m9o91Ux=bc<^8
z{>#69i(b<2)!j4KydUWA&y|?HnkQc7erKL{=5)t2K6ABWVT2*RCZD<4;UAZI)Um3|
zoO{fX=fBx-GVdBZXO<~SPG9o4#LQR5++-|>k@!V)$=Nq$jh(MCS@m0YNczZ@`}2&VfwU5D8)1R
z;-Db?zNEAH;@B*}{9L{`GgC0<^F<97AJMB9^2N288n~D*N*ObGx|A()^Z!%iy}e
zyy<4Xq)(LU+4A95zVwntL7%&wFMT8}eN;XHaqdpO^f{>)pSz1t`l4>M&)v(Hz92dO
z3BBQdzVvm?+I;RozVwZ>^i8?;$GJvf=?7_17aNDAze!6!(m#uHO~TU8wPf(QreWz9
zY3ZM3wN7%)LNzcg5=yz|p`1R`QnMiVvaYuX)#kJ?DCJt3RO%ck6rq%B6{@?Y%H`j!
zceM`HC>4QT%C!mQ7@C#_1lq?>a&1F-h^F&&y`4#=u|e=ax%Q!)MpNbTcl53fp}a?>
zMN7Gkp|-b=a8CY6@!gcaqwgmN!UmCG;DySj!Yjj`<{bqh-x
z9T_{jhw2a-6HB=sp&U@t($PQ*VU5C}JW3T1dN|yrJaZ9=0q0~#NT%M7wPpIyr
zh~`qRZzx@pmhK1gpwNgM%4aoQqwD=mlE9dPmM|tPe?&_Gt=GcxN7KB7abfvmDd#DS56d4<
z?@O2vmOr7nd7PUVmOq)^mM|$Se=5BxVRBghbb4LFl(78A=~W3+!}4b=&V5=~{;b8h
zPY=tVvpDw|Vfpj6w4521zhFztSz-B$=}CQRc3A#WdR)Ssu>9rpsD!y;`77yR3G>48
zpQHyR%n!?7P4`P!5SITm-78^XSpHhNN5Z18{AcMd35&z>pQk${ED6hBPq#@}8kYYe
z-6COGSpJ4-lI3Cfo9PB!SrL~1GF>NOWmx_z)li&U6_&r1u9C1iEPp#)Az@8e{_Av^
zgtcM$JLwV$>%#JP(?t^2hvo03ECM!!5!Gz;SL@
zSpIuE*kE^9{s+wt;@qCF{4-4s;#^Hw{zuIX;@sY_{BunW;@rNl{7;%0ygs)-EdL^{
zjACeN!YFiI_@u5M2+RMRR$4PeHRt*jfiHM4EdPrps8X_F`CqlNm68q1|E}fi>vKm!
zj|HVNHlIFX!uvnaruy{Apk1N;@jitD^yKvKO;bUvZXw=-_Jc+ZK;+
zVf&do3}GW#$nb0J;n{ZGSdBBs!fexyUAix8(sexa`*cJ0Gn5YHt6StZ+asCRG`<^|
z_cKnlZ0Vc`y{6omi}*G^W{%ZPpI5&V~tU>q0^CV<&s4wwt(f#qNYSP52v&0q_t
z5k8WYx|jSuupb-%2f-n57@Pnn!D(<7oCmkSZEz1@(7l$G`n$P6IgGr&)%hta^>=fD
zdTr;YtkmDl1Fz`ac68v(z3COtCUa_fEq|s{S*dhm^J;QzQ@+}t>3{6XG$Si@0%c7ElK>l*|36+#
zcrTm?-3E%;1zyvO=>o6b1g~;ndg#04T1pF<*V3P7rM4#D2K?8)OGkN&#n-;37Za{a
zFJ`4$46cRWHkS6v!fl%)vAdYX*S1A!4>|(&8DH)4^w8VsL{=(x#b5JzGIuBQbo$-g
zo4RGCzRJmICI4gtF}(?;gjH1u1v3ZF}=!x=@s84+?L!ea0lS4wB+Uc
zO8$5ASaQF`SE-Pd`kEd~|E05%do4F5!s2xYem7?&_gZdBt+P`9YiFfbc_Y2zgJe!e
z#A|0k+H8thXf{FN`mUGBUj-JCZNb>gY_j0%7FvX7A=egdZGqMnV{PHpL{?|v)aKMg
zIQ5RKRP%4Lpz7ara&qS0WHHu5_^?G*k3b@xIt!wnhGe1B7Bx-4^vAPOEn@nA&o`=f
zR_gzHrdt%|$CH{U26oEasnE-Gi9zCYsAx(Z(I;z2
zsE|q>&L?X~sJP0M6T!}f3a&Ks^7&8^mS$eQ5Gu^l%*z);#afzq`BJEWOEWKD*0eEi
z=H)A);xEm-d^Pm#^JZSY7W%IF^oJ_>dg#07ZS(6!s1QvvAm0oXp=sM-w?f}5ZwBPs
zp#nB-L+noI`{d1ld^hxi^68(blzX8ck~b6a{ZKKTW+HwNDzMYG#u^nA-Dz8pjSC9#
zv@OUc1;u%4v8RoMf`UD@+LNiHpomW`_mW)mf}fDrdQWDKf?_|l;7f8X3km?$iccE}
z1x0~sAusbr!B5F+xtHYH6ciMy^`1-{1wSpX1z(bDSMYQ4wi(&J;OAuq-wp-Ejhex?
zV?n{AX7KG)@C!48Z|8ynNX_8erQjE52H&m)#gp2$TepH=ni+h%7yRbDEL$>T6ts#+
z6@ZtYsQ=irpomj#tI3Q}P}pgz$h-VNUGH5`{HeAK9?A77XswYd4lhvLT^{2|--04i
zRkx*Fzkv!aa7W@Id>y>CgivfHk=+8p?ETE5VE==LW3jT23HX4Q({E@tE
zG>j}Rtrk|HIuAnGdZJ|Dr8(+|IU2M7K6-=m;1+-aF(CRA1ursls2;1}%k|q@t
zW}ALY(&U1cS!NHMQc%Ec`jW0qEhy?X{g9+-1%=+GACNS?pw+Q$TFodZ2-h~PW)>8Q
zYa80L3JS-y4ei+lt(a{?drmDq!H6q?O#UBM3yZNF-L!4D17f7AOm6#THzcEmRp{D{!h$fklH8JZf|tZo|GF8P*%
z9~0WX=~i{q(3HnEb<@!HrnakdhO*jeUt66sG=;KLT{1L_H-`&;S*YgobnZyOulSGhtlkXN)_MK6qXob6H(uq1_v*hLEBMuV
z;jFT=l|5eYYhKRI)IUE_@asa`pgLLb>qFb1I#uu+!}L9R^>o2+3R6t4XQT_l^qrE<
zN*9E->3>eWKTMy~we#xrVfr>n7u3(g^sSOEs-K7E2yjXLIJE8m%j(CWZU0{>_=BOm
zS7g;L_(Nfe8TXp{XP7=N>3YE*4eg}U8wGznlm|c-<B|4DcDS5Qlx_jtOh4XG9X%KpAzXv0_*HkBfp_w8`0Auzqw#FI6d-P
z3f9?YM1Fh0<_t3~Z#6sey9?IY=S04yU|Y>|Bfqy`Tg~$#zrUc-
zLkcwV2MXyIB`t{jp@Mbng^@p8Fpq{sk-u1wZZG8)M>3|RzFVz)8|9WnvZ`qWsg-Z5
z+|o$qHI0h3@-0=)GPT))`s3rd<&nQ;?~-!qs;x17x=}DfZ&?xfn+5BhE7gPx+Eyy(
zRz?1f{R7S^Dd$$J9lxBtq3oK--&eM~3b>-|TD9nxvzL@z7x~6f>U-$bpD4RtZTscy
zkCfe@X02>Tz52JxZdBWTIm;gZCN=BGyj?a&zD;CaJX<2)KC&v^s%9POkmn?~E%Kcr
ztJ3Xi){%KR?TCEW$f|UwnssCo$6acMkyYvL$PbIspXvtfQG?XKoLej3T_x41QAW1&
zvNw{sH1%_8=?Jz*a{JUovmEba0=8dGHA=s$5)MQMyA~lso_SZ
z-491PmqJxv${mSxEJf;P)(RM(j;cXNHjOx@1|8Wn;&>z*wM`>VsA)&m5KgLTN7fKd
zMKayml;N}*d1PK!XVl0e)AeT~S+#Ada8AuVvZ=y(HTTG-3Kt?BYhhD`i)#3hO%*Pw
z;YT)AxE#saZBvCSkxbs&6qRa?WcN~}`y57#{QyR(+kBKCW-
zmeMlzd$X3(D)#%bmeM-*2eOvZCiVwuDdk+-*dKoR7d23}UF?s%oUO0#(mwXbBbys^
zi2aGkmKYsle>!Vhonn6`GIh~8_U9v05?x|{A+kwi*Vtc|4g>$Ji&9aoiRWePbOuVvC4=u}&T__1!;~mE6?#
zfLNw-^KBd$%U*82je}wt&CR!QaI7OqY*IKRmJQt|g+pT*(rr>WEY=AnrqYMUzH4kM
zeMBtdx=jj4#yYCRJefwtIoH<6|9U
zVrqUutkX=)lWAfso4m~eC&fC~#Abn$V?QvqI-e5zA+h;DPL2K0*cAS>*bk3QCrpq1
zh}abVjM$HgZ5B8)_M>A{__Ja^Hnv&d?AVWsP2tap{e;+NfpcR&F*dKId9j}y+bnQ?
z?5D)$N4FsM(_*XXg|VL=TTL&D{mj^Afs125E7qCt^2CY#oY)42rLmtITb(b9{ruQw
zfy-mRAhs?26|r9wTb-|r{o>e$h*hy)8k?S29s6am4H0W%zaq9eUmN?Cu?-RHV!t{z
z&9FZ9Yhu$38)CmMwz=QN*sqUmh}abSjj`#2&9UDUn?BeQ`z^6~9&J_ciOtn*TkN;T
zrUkaE_r#_JcBs$9*7tX+&&1aEcd4hu*5h}_et)bUubFG?55+c0)TpP#*1Pw{{#cyS
zKlZ7A#MZm_$Np4oKAZ>CKVqB29gO|C*!uJ#^^aJ)cuDSX>@USObvvT|5!=-5XzZ`X
zHg!9u{t?^M?Re~O#5Q$1q5cuu)a_*KZ^t%uI~Dsou}$4h$NpZd-DOQYV}C!^_Od3P
zv2T=E{ho_`5Ey%_rziPi5V^|!?8_p*9fV)c7Py)3c%y{a~z
zSZ!TX8&7ONzpgf(m`1;$HlCP9zo|B!SiRj+8&9m>ZmW$arqS=HjVGqj@5b6pG>v{Q
z)-gR+gZI_$6RW`oYWIn0^hSwJ?XiB|IMLBP*3X+HI={#IdDBFP_*g%0mgpoO>*viA
zZA4l>Z;@z2%ldiCLqMJe*3a7{I^oCqdD}$$m)6hQB|7WJ`g!}r
zPfo0#cS!uS#Cmtf#7|GGcXvwsti<|s=fuxWtWS4I{Jg|^a@WMqPs}H=TjCccroFo-
zeoI0Nlbh9O#ITsR(8D-zdW&VzIWnRB(}2allaw%_2j;ZUz6B4-!Jj&66?wR
z6Tdz&1JQuQZ%S-EH!$&=vzi{1_-%=zIWrI~Onh^ft=tpe%GuO>apGG$o0>04d^=}T^QDPz?`(8l
zmiUg&H1+btcXBp5uSk3sXPSCt;=4MV$E`|ycW0Ve$Co5!t5d@pD9yEgH?oz?HU
z#P@Ypzv~m<&sqI$Nc=!&^}8|ggPir`O^F}kY`wlY@k5>U&XWazt~y-J*YPBtS%2Fewj1h&%zPGpKaVO{dcr(&=cD|oCZQI59{@%20SLX+M
zGtG8$evmiQYX25OTG2RvCgmXrftVL
zztWqw9q;^VZ`yW(^J~1-;6&%wdDFI&oL}#)1}8he(VMoN;`}CW{dcPKTfAx8Y0hu;
zrfsJ?zujA}o#FfrZ@qS=^Siuh+gZ-<_NHxTJ743iug-CPueZKB*ZBk9dgwgo4|*GG
z=R1Gc+iYop^GCeRmKHjH%-d{fk@LsB&6XBBf6|-rYl-uxycxfis!e(`Wi3;i^l3e{
zm*q|e*rjigv_h@Zr*$Q*RO|G%+F9lNJ#VX>)y_96nsI%N^Now9PuDu%v}iNmbB9(fQUzoB3{XzD?2e>1OBK6|DxhIN!c#`gE(>ebH)go7#QR
z^yzlB_M+9`4z>28&5U-cjTfy3cd3mRZDzFF`CdiSr+d`ei#9W=alUWSW=4C}+KV7yv
zsbv>U+a7m*e9>y~gj#md#>NUpC*+PVu!Y&iDwisMj^
ze#?;Lu-h?6zp|ul(MNKFP14q$8~{stwvr-&
zyn;cbT_4E}HHqy#OESI;^S(nl3&d(v^H^?pmhGfBbXMwG4#w(ZBeJV6Utt$^q}Q38
z8u}i~jWWp(*Soc+#_r%(_4;V9xB>mdQf`b%eok3Wpf2UcX1OKhV6bxIvfR>gFi=4q
zuSV?=ju`9V&Z|K1-^}Qd5;W!|S+EUddDP
z5A;1|s*-f2CcBdTFNLeB!<4m*cp^7jeL#CV7Rm5Ri1F+6UFUcOQD_i)BsbS2nQ3*;
zYXu*!c|&fV_ajjdYjtUz()wEZhqd%G9?#A9epIbguju9VV4pxh(gLp&OEuU(l3Qq!
zEQIootQE}HYm3y(YRSy;NN%y$1E*3In)jP(1x@tY60fIE>AMzlOMR_+3Pq`}vAL96
z<~jS60PP8S({f)+rw;r?(h6To(dk&1SNh5zd8bws((p-XyH&n2k!(Lj{ZxhvFRIAZ
z{?XslDKoEEqb=sv_(z{o=4l&i)_NYH{qHJqoqzNrgi|X9%0K!!%GREt=h2R=|2BFa
zt<7feCjaPniP}tZn>`PFWD9nS=Q-OiD)4cuw+BEzCvls%XKp_ual5xCZ@)p}4sXxj
zu1MVJ?dgztiMzZ#i~E$s-QJ$ay-VUAZ_nl4AhE{V)43N)-0STb-4iA5^Y)}}onoHb
z@9lZrua|hh+f%!X5)XQNY`2qm$UoXgHzt;N*xPfw3lfj$AM5HqiATLX(|d=+W8R)j
zxnAONZ_oE$F7br7r+iP6cv3%8-pjuy@szhGe!ouQX`em!TjCjSPygm;p7r(&@Up~n
z-kt=`H#_g`dEk7r3*Mdz&NsX0?b+abvrD>t`WM`t%ld5+a}uw3d%Wd+)#FuPRXtXp
z*1D%&?wYSQQ0Dox`mg$PR=(ra{`yGuf}9y(nB(i@NTsI;OGu*+#)H743Ax
zSKpmhIk2GG7IXxJ_g6W(pgI6>j6;<$u=W1zz2&Pq_u>aFdpDjm^~T#5Yl0A0-O|n
zS@V(H9bf%;TD`1#tX=~X`QcBCQAefeN|ntDi{!e}4aG
z6f||uSHF-}2@k6_5x!sZ_S}76{b5?|%%y&SXZlo^fQ^7NfPM}7zyn|X+qBx97dbhi
zItQ!-TfsCw@DLUK(?-SWPt#Z4`xCW|#>J`*6{-GA@gTKwO^Vq!8mEuHU-_m*`*PKh
z%6~v@s#(z*z|SN$FIqGBdsR=1qHcyZR26Mxl72#geT!B_wGUb4OS#r2>6;eVp>I=E
zlhGz>Dc9B{{n`Rs&FzY6McPPxB-h>~ebEBxqk64FQH@I$I7J(oq_3p$yOitnFn2+p
z>s-|Jv^pvXNYCqYU5aXtS}m4xT}`Tv(}R+g>-I2rNT2Io)b+GFUY}E9hSH;`CM;!N
z%Jno!l~Gu!>%EF<)mklTmSB?Zd4Y6F@9a~Qlvd{k3L}u~PEk!?)*HF*n53F4jM3-%
z7bT_DrTSk=8}-fsMfDFGdIy@MDlGKZI|mgdrPWn>rxL@$;G#N_Y&nWXGD!`i&_>sX
z7S*q8|8AH`s{cYGjXlGQ)swUY1@%@hA~aH?CoFbEv8s@&&r2FvtSW5xvyw&?s|vmS
zn55CgszPr+B56#qs?b}!XvP++ikm})k1JN?p~f_2e6e~jkWtO$CKRjpRsJ?zoLH>N
zMGc)hsaS2H|MzK$lhtq}eoW$&qCL&~gA%6}tKD>!0;Z`YNPL&X>BXuYy&`djYFAgE
zl{m9l9WAkr#975E0~ce&Y*mg#RO+0fJs=#7Ik#9{sH>60dBy4qiT5PVFIG7c=c>d7
z#VTjwoR_$;Sluo0gv3R~>OP5wB`z*jk4UUhA6QbXo|b4z<5T*5ON$a^RnmxSl5znf
z*YaZZs@{j^z>1=@iHo9Zd8Mp$k?!{Smh)!g4QvC7F%WA%TI>VAg`rb}|ibX!BStsPgx4O4Ex3EkSz
ztY;^SRXKzFRM$>P3l(h5eY#kc%f{Dr?TlJj!7R>abyEt~{LdAua*24qUOiu|E-si|
z_(HL|x*+R?244LZ#b3;oc&S+3DUt7ZxmYF4gYS5ySS7Awti-EoMiNIzyjH9d*)dq+
zb^RWReI?!~Rtfy+F7c+ipTv$5ZxyR|B(|1#yI5_ck%_VWPO-{KK6fSF)o+q`L*l(+
zl{0QHOT1sKa)Qq}i4Tg^?h>h`Mx|CX?
zM%z-A6X*UwV!Kk6bLZ&p?MqdjF7Y0T9ZJ>N65lPcW2wrMCg=p6N>vWfeW%3Er7F>9
zZ;wD30dNo;0>=Qc
zCDl{lG&lp!3U8Dvu?js$p0JWC=jm37D5(-mQYDV0+K5?36VME_0_{K#Km$sj
z3*Xk%UZtKQe>Q%J=R@}|RpmQS<-p%62mV&i#VpO!ej
zWH+3)KA}`4r02NAi6#4SMnf^kZOK}|
zTO_V4Rom(+>!tN2Yk!P!8%ot~y2{AAu~h9Y@o|ZpO4c@6;%qKed+O@zByK5Hi8Opv
z;#R33i4}?4O4U9R%M!Os8%aci?B)unKuD17KuBUSQ9_D)JtQFG{S=5IX3klTwZn
zu^^q2M#QI}lsj#b-V^*-A2}mM$VWKb@!#~3v(knV@m)M86^NrjDRygqWXR9!0(C)ZojE_f%Da<@&=d#q92k&4h;M(W*n
zr6ME_mv~PqLgG-Bd0#3*VwD3WX=D$iCnOG3nT^U?UYVnNW0Ulrpt1f#lZUxR$~AqM
z`*(f3S-HwGk9OC*Y>PeGU5m1*M%rD=a`mX*K)Y*It{#&}yK7xGwaG-WP1%-*PGZ}#
zEfQmi?aHQ1*`jM-uB^%1HbRGTWi4L))m+DNWt|R%;26@%eW8Q&Z>Mr)Ju|xvdE3M2
zT&~Ea|6f%=mvTie{lApdwOo-a|NoKHtz3~SKlYRE<%-<+e=eyR-
zbycr&MXvVrir(eQ2^EjqMxS!!WL|T-a;|T=A}{$$vxYi@f+3(>k*j>AwX%Hk{^g4N
zQ(y;-S8$#;33un07JgU}aD0V~0Na1FG1QWy+ofqP)QOd^%NV9?WO
zthe%Amq@G}1xwy4YyfslOn2SZ%3vYXof=x!gXz->A;}d&(=)W<#R5eR)JgKwn=r7z#Y*3S)l`%AtNRSUh2E{tgn36w+Y9d6OMy3p#Ag0^|uSR!H{nOIqkf;$TwbKqF%l~W!C|oH1>rL2@os_Rd@4)8GH^@ir%E1HuC!7m
zpQnB=KZG4j)Pk;WU`k&hSi5oxoB=$6qSA#r?+Uhnt-=rW6IJLz@|+`I;l%d}C%#u!
zDnPHY3Y-BveYJ82+yy)xwL-jJg>$$o%jk36=taW>jsZ}qE$BDqTnU&gKVr3mz4{n0n
z;4Zia?t?b8>vo_6=mYwJ0bm@MAneXcokV^zm;#Q0mG*
zSSS2pR_X!rhrkhV9Gn27=}=?9YOn@$L`QW3{lNe*8B76Z1s;{8HgJx7CzMxbFboU_
z9o{5#1e3uOumCIsjcW@{KvQrWoDddgrQRTa6Wjt*>j=}pbg&Yv0;|Dpum{wDy`b?k
zLKDzbKq=|FHYeW#v;;jsPtXhW24lcjFb=E*>%m5_3G4$0gb!t<9wL7pTm+ZF1JD=+
z)D$!WGr=ry7MufHQA*puc5p&?XIAP-@@t+I)`Iik0%*tZ&;fJ?V?nR_f}Jro9=$aM
zYy;!aVB>|C+rUcltH6+k!cfrV?LrT*04xDZ!Cr9f9YXJS3Vp$LuoK)8cm$R1>mBm_
z-z5wLi@_4G5o`kY!2{6f_k|f?7B~+sf?h8Oy@i!hpenTw`3>MWxCdIlTj&n#P_!#A
zO1cgvzNb+zO$u~)xzb(=)J}Fg5$Xj4MxBa*)4eMOj`gVAd5ES3Wt%@lN2F;2k8xC?
z)5*^Ovp`GKt?67&^se*=jZmA7K?lGCFDg8wqB0P0hD?R$Kvaluo}QK33)RXqp(}(h
zS9soYg`nliUC;vs%IT(+O@J-D%6@PF90Z5JVQ@samzBD@qI`3-Y75X3>;T8XMQ{sj
zd{o#0+E;}RpbzK^8of?vEPNm;{T0SPU0e*@eEQ_yl#!3wYvTm_BaC^P|`Kri%NZ?GP0
z0DFX1S*bPT+o9#!gAQN?SP6E5U0^pjj&3^vPJ)}@7Pt-W2v26Ew$pjImG+xCT-7hac@dW!rxa1k_bAlSK)SCFoP8{j6m1s;HIsQ8{>0+TfqTv5VZS!p*`pT
zmVp)EF1QayyugzMtYwXqSQ!PDfMehiX!CA?!!Rquz;G}Ui~^&<7%&b@0W$?AQfgTo
z2wm9%wu2pDH`oLAf&JhRI1es>%it=w3mU&i7$AJN<_{=!2>B6!v!*NazECy@9
zMz9AQ7Mf^u8d0uv(dcw6)U^wseL?5|I)g4?8`uT*pchYqE9jNZXp=*<|6|~!@K^es
zD)bEbPV|TV;FVVYO1u7TEtM8nc~#q^O}#lQ)mqkM+Rp~C862Rk+yIBE}oP0Z&k>@C2pG(xR{oYyn#Vr*>3sl!YZ4K6xOK3OysSau%Ee=fMSV5nKXO8DXb^
z>0lw~%8=R(bO&u76*>sDvr_w#9}Y%?8Q>r|0Y+AZQD8cl0TzN)53vPlE7&G{Fe~*m
z`D@@h*!MbNKR5uoKPL15J;8dg0c-?4XjnbLTrf{qo|U?QeE-)A1HeGA4QvO^9v7N}
zX<#}y4o-s8pgF^AOVC=_l$CmbA@(3R2hM}W45UpAwD6{28`us`f>WR`O}`%)4n_zZ
zYNXnlPksSd3)X>?;1swHZh#>SvqQlta2i|(H$YDY*IvT6vr>DL9|1;!nP3)}4Vp68
zHUrH;H_#pQ06oD-Fba$ozWH*g45xiSU(gTq2jjqaFab;i3&A3=7|dZsF%K*NTQtnp
z%SzqKh}(uSwJm4|`hx+W@3TTb&>u_%)4&d}6WAHY^HCuSg|}p--bInz1NXrL(43*t
zun%cJH~h?C}=YjcP0ayqYfyJOj1Hn#Co{KaeEC36^
zBCrJX(IAFdNTv2=Jev+?fXmm
zTm+ZF70`#Vt1svWwt#J*%?m<1FbzxxGr(fu1q~i5bv^mr;6AXko)5oU(h+bB90w=B
zDR5dS%d2)&xzbPij>oB0CeoxQf!$yaXhuVBF6@!Lc(jHoy}29J)=wa4V@$a+G_>%8
zvFbORn^4Y;D_0iieY^$lnepYy!qEK8CzLCTLd6VdQ%mD$*hq)*%5$<@(MI}T>T{FJ
zT4SX)Ozo8e@A-dpy?1;Z%XXkQBrt;lh&eq8lS7j?^Inn)_wwrPD%xHJ
z{}i8AYpuMyvf|p_wPjh>@9iow=K$uMbIzF{36cPF&I!ypCoq%#&KbOSrPb;W6uv%P
z-P7H5>Qr@gom1;-iOBTEFMpNH-S+|;YiU(|8dYsm
z+x-%fO|>%oJBh}B-&{+aZ+sy>3N+O6s^?1sxwrDSgTGz&*Pa#IDceduWOoQ`(YHWf
z&Q~(2t3zOGEw6*V9IRx{Z7#5_miI#4YOlF@Ec(}8^EPqCjkPQc@3W`9oM6uh{*z-R
zd$!lITD;G%v}b6aD#U-zc$#SuJIZ^GB00*Qqm>nN$iK6eh2=FibbGF{ybDr);fnAK~bMzz5_k_Pz{$AT(dsdvM0tDOr9Cx;x
z!G3ZL4>A{^LtsxWql~`v3^HFJ7uZYlXj|2ycU<#(e(62`IpeQ$p9ji&`jWRV$Mg+W{3`hmqBZ1yLcUi1^eRUNc?)5t
zC&P|q|Fpxk(%)H}fg_BXI`fS=TFYR#-;)Y(tX2l$8MVssB({?r<=ErA!8rRGa-vp7
zIQtrMk}g@mJ^&|RKnTB@v~T+vWwF>s%6>5
z>3l5%0ZjEEY)q|8u4pYAD3^SlAwNEzF8|P!OP$+J}`j#
z8TodtXtchA;GJ6gOrW2U@7CJK0{x79uU4ALpr4WN*GeO(86IE&K>Zy0u-1l_H-L|@
z1xR%s(c@Y<4%(EIS~(1^NBXqZ9^QQLS$PC{F8I9G#-V3}t$b=C?@aJTt+asp>F#B%
zJ?@d%rHxHgY`-d{b-V*F(U!wepM%gTQxK7f>_2ueB%tx8R3b8{A3{4v-sEV_W{AA?^nO9j}2QNSU-A>
z3(FQV=$G~JVbP^c)hB8~SenXSV-v%IhnRjboD}B6fYp)7VZIJn9hnjqe8v7h6nkn|
z@D&q{1SlFmR|e1;b>pyUVZk}_uzlCiI(c+udj#SsoURT&Q(qMcBTF
zXcbr)wyz>uM^=U99T~KatPYEYI@Ann!uBY1#?jiaeLT?_N9)4&2}Nfdtq;p!F7j(|
zLsG!Zv`Y
zAE6t=HjEenw})jOc?H}NmRVpF+!?lq8~~fbq9GFBgUw+Zc+`nAyTUg7sMTe6Sk{q2
zC(i5%%Suo)>%hg$a@_;7?wux7I+Bl08fL5Q4jDW
zcm(|bkAp{15b!8?EG&mWos4iiEN5#hIMoSsqQ*S>PNEYv=FxWwolx(t?*~q!6E%E=
z?!X-n(qynEt29}y$r?>AXwsrduUeAcn)K0Rza|GXIjBi1$^SzW#7ST3_Evr2+oAoa
zoh152`%GA_m)*tAh6R@=ow|E2EVw-BMC0>ex@fH677biL!MLnLdhB5m{gU1imWMSK
zJmF$ka5$<#b}1}49O;yl%VEB@F{$wTfh%Eo%CWk5t?1&lGC`9@O}1;YLzCN@+|fi`
zvSg$t>c1s3G?}T%EKSam{0_@p9r
zlWm%)-%B0W#z}AMw))1&7`?3Vn#>|mi+qbp#mR!;Z7LO50p6iff$hM%RKParJ!%rD
zlWy))lR%wx^MINJ>ZF^8)Ven5BdQOmM&L2k2fPSAq56Oqz^7ETHt92}4|oXabE*$`
z0BoiDfcwA~RFpR9OOzjMK>CV018Vd6nmPk&^ZAB418Vd6Hf+-zHiGY{C`cE8@2M!D
zPHg!=MFHo4J;Y{1dI_a4)3MLNNn&$CR61Eq>9XJyG1W_hQ^gceAJjClsUs?#E@lt(navQh3i`}u
zirI!raF*EI5|z#tt68n!9I=}944g{=pu
ze+pbpxgpga#Tv0XrX7a0Vjr5c30fyIjttratrx3*+5~N&+>m|>ZlqX1eP){|7Eqg@
z%_4Ka7}y~8!AhH;EtDqGIJlJ(0=33&ql7@Mv5g|Dzz^Vdv1tVFz#SAUQf;GlQdr<4
zu!+I~AArpwjo>|Sm)N-79dI{gjPyQ+YLCcXbye#S*h^W3btMj_tc3&nC|a_}C`|Ei
z_U;$HtLgF^^vp|v1H$|TeG#tY!vf2n34MhQffix-
z)3!V==%O$VYFoPB{+hXvW_TC>cYo4e8^KG$Kq<`^4Vf@n>g$xSE5eYe-<}J)D)NML
zywx)3s~5DH3))55T@w?I0ye)QfZ;;**8IDv9
z*7~~O
zUW%+`Yh&lK~a5bkRR{5u5RQZJC+{JPy;
zPW6te!PaF)iPYcVy-2fI>3$H|#g0wiFjLP9^zdXiTT8xSyzd+0>2(P7^kff`#ozE|
zUmNJ<$zHZ*eWM@Hn4j;-VZpJyL!gf*N7&J~JAMXUpsy!K*?Pfgko+0@`+0HlRW7IYWp_Xvu^;u08a7jOMt%7P4(=1fVNrFJQ+(~wZGFn840Rq(+p3hcs43G
z)03&51qGSq$u!S`OU(9Ux@W;9=6Fn;vhW~tJ(=lQFs6B)%Mfq^
z0`=`=t7r2&weD~8>|FXB8a1^Se<3`%rrBqJ`7Tb&`+yx&0_K*bE-<
zy1M?IUru^v3;$u%-;;8%~M_@1pXcfynV
z9u=R7?Vdc~_n}jsJoM~s+!a!^^Ff1aCT=7m$
zAgv^S&k2V|Y+FrFeMEGcr<$G-5ore1^o)$iE>K@%Mnz-?nCA4OBXS^Ov8KjEDJdd&!2I#zo|C#D-+YN90I^;ihO{LPU=8<0m+Q4Cm2kotYT1?GNCjh|PM^-sa?p
zoFdm7a7si@gRj7;5jhU(i0`zBv_vd$(e#L1jM$0-Ga`JsHTS)l5xE?(064QEawS3l
zoM>QnM6UAVH}uCF`0;443_
zh|GwZX*v{)rY|c^V!7Jc-
z>O80~nHM7F(x4eysNG1W#1)C|@&s(;ip
z?K;&zil#*aH>mzx^9~M^T_nH5X>L-HL2b-#QU5_zu-g%HtI&q;4wWA1X7Fyr<~wL>
zcdv{a!21!|Lxy$W18fDT4c|j7K-40WKEeV-Ei&n2EI`x`v-b%WAZpR@o<^87VbSoO
zQLCeV6?>m!3!)aIv=vhj^((mc7gz$W{W_6B?
z3=RU{QiH((;Jb+Eyo`R}`-rH|$YAgTRTKOxut(J9Y`g$_Ms4QCbFf!bo|54O7uY*0
z@1o`@-zO^Xqvlc5H!2^Z=26ox%H&Lc7y0@}nW5=7K?9=FE9UQj21cm`zIs^=iqd)$
zkTeWS8lnIvlTheU1rSHYoCt26&II4o+7{V#*VqcWDfzX;YxWgPfFfg_?e
z3G{yeM@G#T=9j=xQ9EyUaCForh<*)@iP|*Lp8&^3Wd>)^x94$DSrjuPFg_}aV`c;<
zL}f|LjKIVw^Zd;SOo}qu-;BWIC^P=e2uz7$v&;xgjnX;92t)(ZqOyvcYvlBDm_+Nx
z^r&rX9i9<23#WB>X4LwUT8C#vWhZ$n!P!x10^5UgqUKeggAa3~=Hn9t=SA(jHjEQB
zkAo*j7evkPKu0GQM&%G^Q0bzmO~O%2zc^}Ban#Z;iQ0r5we(A)a*4cZ>6b<2Jg60O
zc~tI#hrtz5^UgU4u8f*@&VF!JR34CFFSt4?cR(F`ToX072Q$u5bAB-695ojRtvlcQ!=jC8(8aW7KBu>gdm=sLkKi(Vxvxo5lMH*btRL@$v_VEm7$Qeu{J}x&i9w
z&o*=e)X|?tbOTh&xgFgABj65H3RHu;6NLaPz$O#|YzH<+&DBWT<6Tjii}W418$ANG
z0QOMSpg!Ndlr^ZG`F#{NsG~poqp}*j10Fy@K<&{TjM_A0eZGe%LZoWq4xcQ7(YnXh~a!I}|rkH9~iz=IHel
zycd-rNFRguQ4LU~4=8z1-=-c?@}TPaBT61rU4M+0v`L>(n&1hfPf-H!82Ah&0FQvr
zu?lU{R_Z<2g!Ba!AJit}B?Sv=lko}@(I$NzwJB@*sNY0w;+j6{w^3;zgFfna6fCHZ
z`h8S3f-AreQS)D$0rrTQ7h4hR8Iyfv$b-FNHZ?s9_KwMJqy?}~%-n;*VBeTI33UMb
z#pDbbs=@v-o2gj^4v5J~q&48cnCRs8*WjR-O>x&DiNP_siL@0Q60^CTYF38EZ7iYnXjEb>Jc$%MXHZ_WK5ob*T7LR^IZCEaCA(1F;DNez%em%
zW%>Cb`_V>S_ATZu_A8Hw~?fRke~4Ez~z
zO3bDQb^)ixY?9!Y;Ix=c6;!h_Jtou1t7c_JOeTY!!I?307S!iED`qZ(X>fMT90%2`
z%!$cT@~T;x8H72jgpjy2xCNDshHd3(6x$FpTkJ-G;61XEK{gA5u?nDVdl{Qhv
zU=(boj6v=D?xKuARq);DLz{FDgk-o69*)U8P^Cv=Hg8n*_h`&!k6r|i#bhlRE`Y~lvI*I16sWyNk;^w)m
zx;`>4SCOh#kBXZsv+DZjxOr^e1;@nAZ}T=dHZB+2@{Ws}$FufJ#>eF;Qtg*ah?@)a
zDR5$3o+H(Eb5h)VqP5+e9GAyPHN%v+O|kw3aB5uoF~|Dnz-e)tbNw^m^tcQ_`Y*v5
zahrtwJ#c1R1|ikwJ1Z`O!EeCXadTwXymR8_V%iCu8<#0$@WFX;^EoYo^W!oNsWz4i
z;^u^^#(ZI1W*}8#z9=p;K{e)!tV~{=C|4oTppLz9QFZR
z5jRKHci_sntVQ|;TopIZ)>q)_xU5I|0$dZ94WO3LTGXg5@4C1-z^bmVkINpUYRosp
z%_COL_QtsEL#oDnQ`}r+&x4yOd8B8-26P8J4Q`2x`t@txtrQ{H1a3n$z#U*CssT2F
z+ffa0E4TyI02{!as0O$RY(h1_4PY~>0j>jg#mx_Q4Y)gQ0R;50J(N5dW`ld<@&cR*
z?u(lv+jMY$TwWoa3Lc1?XWL}(U|ilHod_O^%Uf_fco>ap%X@^9XXCw0h0kyF_
z7B`Q$_Tcfj3_}_KPsC+7_#QkNmwNCmcq%R&^Dp!UqK
z#bqP76TBW54H2*%yb+hp;5P6kMgiOc-omVao59uYX2aU44gyxD%bHeu$eZ
z#$SRx67rC|Pr#lDxeIE|>XooFXu0)H$Ooia0DThDgRA>@VBduKar_?GFJayszYF$H
zNN+Oy8*o6vqF(1Z*He-Rv(uxHyH
z9G)ul5W$
zE@8gyDR6v3R*|6&oRF}X9a(T??gGB+U?L9HV5
z66Tw#Rb+lb)HhYD$by7i0Z)Jn6BcRYEPAmhA-A)BS7>oU?qvP1pe2-WmasjnZkoWM
z-~Sw1mcXB%7=qEj@`OCdG6`IrZ)T8;W$%iFJj>dAgOv$+p0)V~s}jS2(IUD}jg#P60
zTf*jq^vUt*SkH2uU8ZT=h4IWPilPuSh472A=J
znMl=&?M%ol@Fm!kun-1XTFnUyWT2(BDHQ=d)IZ&+vPbcIghiO;$OhS%=tHHAgdy?9WoJ+_J
zq}q&}PsmMhGI$|j-d7XB7L*66HX|3&9&jvpDPbXNCQ+i76Y@A`Ht9-2p5)9XT}|M#
zXg28@T9d;j@s$s)$@w?Yt{Z3#CE7#XR)&%MfD_(C8$f-qw@?RAjn8fL0n{3C2ZaE&
z<8>Du;yV5kyhq_8y$0S#CqRA156}tl68I3E09(LE=me;C=rOj%GGLt(G9hoD=$&z1_5B8~(tsJ0st8blb0@d>MtFuecO3}a09Okr7
zJfP0p=CsQ@uucw;SNp_+>SPb7Lm7kX?ANub45>4ZBdsb!>&)*+tIDuCIY(ZtD#PpK
z6sW~mUuVxrdjuouu~tD6&dE$;q}jo4AH>+I+@6^`}Ei|BpQWlL7hx5n5WgkI+;Bi+Rt+VU+04}SOuKTP~R8Vpedlf4z8_}ZQu=X9SR2Oo6CAM1=NOS1DXP!
z0ym;5pf)s{>MW>%>g8q>4CzU*0ZjqbbZtRXKs8-k(G*a7Xxr-KJh%;PM8Uuv;C3_x
zRMWKsO##((?L<>ReM@huGw01EU^5DabUC;SO#!EayU`R-4cZqfja3?vVjl!)R2IwT+^IBPdjn??mbc`kX`?
z(4%!SsA#LH9IKPTMZ(xKF$29S+PW$y(5s@Yt8x;(Dzc(rG;j*N;w(*imJ=lZmLpEr
z$(W+8t8xatD%$6tv*=aPKL4CUuZs5h=RA5*N~vx8NJ}2-GgdTl5J0KfrhB5%?d$_vjJ$C*X%Vi%#@MV2`A{
zMtTYCnUrVXbxO2XQhJvB^-%Am^eWjR&3%%%5BvHtyl)a8Vq1l(UlK=RR-uXp`X{Ad
zi4S$^I6Q|$`z!;JwyoA|VA7n8)tU`Tn#-|Tv%yJoJpL(gNYdPoyMsfMGM+Ph4Gv4n
zNbq~$@T8sh6RdvU)TjNysLvM-!98ZL)eaDJg49R*xnpWgU0g#Hr*oi9XON
zN!!-8V`@^Gkv<2fB}D^1Jq4#HE$owa0cIpE_|rphW>WT&;XXJkDf>Vjdzqb-ouKBO
zleC{W56(?mxTv$>yrcz<(wZ_qX`!RErYuNW04c303zKqzGiXg&l$2ATP6S$$76)hzS(mgJFZ00lNqLKO4!9vHt)SMijY&Ii
z0^F38!TdxF+?*7R2cyc=kQ9pw18zx*#)hc{wd-z?nDq)hP5!ZjuFYBvkloW!-=)=b@%#J}CvOx>Nt$(>N&(ZHUhO!e_<)RQ)l
z^yWwQCT;sFxG!mr@YZuqnmfGpoRj7he}N1Klja()Z$F2UvYaz$qjVVE1Y5u(NjvXe
z@Mu!DAl(ffOPVviwnWF1=2EXM(TSuv)@w_2GAY~1t1Z!~q-+NDllo~i%(qvYGbosE
zJ+-swmv23_b4lXqSWoSIlAt;^P;enB2YnkTXh{-d#|8>6CgreiGZ8K&<%rKrglOP$
zQjYQ*F7iY2ghYEXSCY1^#_wvKFEMf*ZI2J=bk`QbO1IB*yE783_Hf$va7a0mDv
zT?DnI`hYTm+EVpM$wW|%WY3h027dwUm9q1G1@=zK0;HY6J}Ha%_Bq%$WpUp=1^cBe
z`rF4~|CB5tZzpg-N|u5?I4~viK+QWSWuY0gnhj3LCZt-;hNQ}|8o;3`X+WygY*@;I
zH)u5*o{|kn1*}h5n7KFLh?ML{`U)JGvbb|<3rD5oAX2r3qf-`$PHo|sl!c>H`!+Tu
zd&$rWj!Rj5I(-KkpOO}&+9pj%S-?82A`??`38~t`Nh#6Tb!rPIr{p}S8K$HxnB6{b
zYDyj=-2+ZbS#&!si|HwOj8w~FM#{q7X<5un$$g}nVOGlG->n8`r=$nrDSjNBld^z#
z-N3mi>4mflI4@-p^1cM;rz}q17vO@Fyys+U6Bni|>Xf!Ti&8Rz!!qFFl!c*6flE>{
z3TYjs0!>vA3E7vXA|ns
z$=*7fQ*xveZ=I}fm?BPyUxaq2S#)?bh24h$5L{Y
zGcVCIZza(t@_0&acVfJ=DsUntcRKkmp_3`O+sSW*PNfKs=s$x_qfwoF4P0>smF(m{
zg3h9mo%{z}^EnifGauD6Unkkc-t#GG?c{6E>q1Iibn>r4Eh%}~$-fL;Oc58>zX)AQ
z5ggXP09{VWn@+xZ_gqQI+fM!&&U`f`?>O^IJ@ep?%P+0hQucJTfUl=4*oqeLjg*C4
z(E`4ivcM}^z_(H|lw-B+x}A~%pk}y}l1ZSJ>fMw~2DMc0r7Tp7mg@bK1#HpE_5jr*
zgVv>oC@-j$?Gefg?f@TS;y}&&1Oo-G0iR-^z*XS0l!aeg0X|Pz5H_t#t*9OumVhrX
zaiC^+nX;mp0=`PgHl&ll*C`9zHUWH-vfypwz_+L#8ODI`P+o8p_#Wj2M}QwNaiHey
zk+#y&3e+=gkuJ4{^-5d3ORZtO(-!qo4PT$Mg@#kZ*EcPvIKvCDUs{fUZ^8a)D`hQ!
z0cp8`R108W+CpaP^Bt5H4VkG0FgPu@K`nqGX}JSl0EedKE_eR6d55R1p!XxK
zPs=N$+Ibj}wwS@%c^H|t$idoq7?rlrb=r9totAgx)y~71w7dYdu*RlMVSXGOmzE*u
zPB(CT+QJTZ0Vkv__^?{LiD?;52DNsR(ozq822M`P2=EhdN?Hbins;j2!uY7+o0hg<
zK5Eydr!Az98on86nMhuh&P-cqy=rh)+CuA9fwR*VU@r*HNy}XFs&sDJ;sNPXpO?0%
zK>F0@r)3Qpo`Vb0vJzD3!n8%_y8|vtTa3P2;NrAwBf|}FNm?2}l`c(Na?5&^{KBxOWLGs(-s$SBhqzgiw?LR
zTu*6|VJ)~JEtf%+ZcJOu)P>-tv_(#x4{lD&BQned8`5$goKM}~k|qWciwkuNY)#{p
zW*%`r@^ky4znlJ7f48#F8#GVIuNfYDB_Nxcp*)+kfY@arg=h8CvGr|{nf%9pCP5Ls8v&{U=LgQRW6M2&1m(Q5v
zkHaLlRNnswY+a;AvNiuRK7e_FOVnDnW`4%Q`i$W}FL1dmnNybhzvp6sE7VpEqt)vR
zl2#J!7FjokPObUbgO_Pv!ml*t(l0ewXdjWu)$5&OY-Ga+dp;M&vy{XIlN|xR2CBEYDfC-l8aMk^2O>-=R$3!FLeE1v-#}X15;)kMBU+|L45)v5#iK0_qFbL%Z`ecYGTF%Y!$B^{R
z$U`K0Mvgy%q+f<8qbg~y=lB&Q{mYV_G&p17*R&lPl94eyaBW+LW@IF&o=3wnvgr$=w0MEx8G^Loz4Hb0_`fhiP@f@U
z+m9swfqNQ}A$*%j)F*XhhB$7%=Kej7AC)1X+mCYpE|Sq1qPzV_@^ARHF&R1g1#gC4
zU~Gn%sVE@7cK-`LvU!1V83L&Kgr?MhsEkr~2#n7VP1Q$D7^LVBn2;f?Dn6%Q@P*Y2
zOw15pwVa#dZz7qLA=qm9j2wR*$>a=?S5?wp&!J^Dr7XE!mYhX0HA7%ld{>chW-Wzj
zWyzzmL_2KLGZvloQ*cJcV%6ze;>?Wn$CX##5@%(k52zo4W@m_F$AIoffjJpmea#hE
z9e_n0h1=YRf9Nor=GW%({K=(z&v)jXDHWKc}AX+r}vkH8RM^>zY$+rS*^$r
z;Feff96j_)Ubno!%8Wcm(vv*o@5j}x$`JpSXm($=C){m?O#G6$a$aC{hJd&}=W5R$
z)6z9%$q38Gx;62@+6?h>ea>uoI2vD!Twq;BUL*a${p+vv{qBmUbJgoJ#8PK~oppIL
zvgAtw!?C}SzrFnJ`;u8z1enVZbJv#*NOpbM?w65l%E&S#n~;!SLz`{R$OwO%~(04y^;3+iinP0U{_hv$MUuNzc_L?
zc8@$g%6T}Nam!R-5B3jfD_5?+(so55s>|MtMQ^+Y?#ozAN5%aai&lIFJdm;I#fk?h
zjjzh1WrrxDHawiMsE^uW9LZP|NX4UQI2p7jc#KNXhQ~7&{9a#xPGm%b;ag7u%legn
zjr%!;zJ7((<%zxe%G&AE=q(bqWIz{dq0VG1bh2L1*^C8HJ_Vk`qIN0wXwPRXxW4vi
zFL3clwMW~Mv6Wo*P*NAUk1o8HcL-cUi@M-2)rIn**K&(xUZ*ZzHPOaM;za;YsEtD
z>lw8G=^gHi>*We6+OD)huTA@f&&xUPl7lPJ*k!F58PSzN6v8#oEOzx}URPEQ^a3ww
zMcG=)oi6LjTuU$TipCVlG$d=gw$r7sU!ws?mUM0R75m?yCFSE~Vb=-`aPSsoL9(zb
z&2ERlyNrxyYi3vMd_3?T)wiwoGMh85>{{{L+`$Lx2GVI=+v|03=8Co}sL|oC!lQ6-G1$VQuvn=^FwgzOSiLJAG9>P3i
zrJ1dxU75BO4-Cr6ZrdU(Cdc3DS`pyB24`gt(gWNV*UJ@Dv|TALFAZ`tbC4F`#MU`$rt+ZG`$
zIpf%F74x}+v03?mw0F1mdL5j(qU{Q3o4Q%sKQ1dXy72*@o=cX6gQ#EKh$_YczFC>Y
z)^3j4+YJXvdM{a-jbsIqqungf=%lR7LDJlfI+Y4c&a&o^9WPt>oo(dX-mSgXwkcT_
zA|k}4NmvlQLttuF=9eY^nXPGAS-{p7Jx_+t7$ibETK89^})&j`usK}hGv~(+vipL$ibQ5Qpy{g
z4lc{evo`7StS!V8N4g>_y?(4b8*F9PqS|{%S7oI~n{;*7)@!Ojx+W{bkm?B4+N>?$
zq$5=8vNEJix;|@5pFBmnAuAJ+J_a{tZ7r0C;HIpMZy)*=)i0(WF(d7E@6bsW@2t%*tw>KjorH5}A8qFq_p
z+$P;ky#ZGt-IJBQ;0kbW)*|^Y1NTuO+ob!mwwTK-qzAHc66p-^VAfW5nFb!p%JDYo
z;j9Hq9)ltSzANk@4-`9xz{E=
zP0a-V0_hp5CHUvyS?VMBXW%(1bDQ*h*1|OFmyHWq>G$L1_r;d1#ckFP7ZxtUdh_J1^Tt^YF6soq}Q^xbd3(>UC+u?q^h(xvbL7Z7Vu_PCbvm%
zQKLXr+S^noP?h#hRu+Le6mgdd*e1P~wFMGXY42xknFLkZ2U%H1hNWe20q1nw@II6ZCRZjNS|kIah<;dTeEV641WW@$l7`ge+9nG+Nuoy
z1$>p2gKZgJQ#Zl?6X_eu4gBB1x0EsXr{Fuv82n@KJ!K63A^3sX-Ik$8&H`hr{`SmS
zcx=_*UO9P82G!r*Ig6LAZ%lo17ByRkxclbhL0g7?Ia?A)pKt%1EexcCIs>aL(41=nM|Y+3FIXgF|z+#)Q6<4a>=J4*M7!o|D0#4y)GZ
zENHimkB-P$=x!Y~9htKL-f?hLPNtAI3Xaan1W-SrkIC7BZk6EJoGd`v9vqjmwcP^X
z_?#?4`W~E+lX+k}aAMBZH+l?C%E>yU55dVfTkz;UI3*_=klqES=41`{0GyT+T_mFg
zoSu^=@H{vpC%S5ej-}4b$u96TI4dVRKpo7UowEq!`h4f)+{`BX(Cly
zy$2-#8^OIO0jRcmUrttm+rj-g3k$yrJdm?hPgZ~jDOfTr0}th78>rI5Ig1;wkNQZ?
z*2L0BeKaSB$e@qxlfe{Ip!R?wq)fXcJ?9(#sYMg5_8Z=%a)HM@E+lWh=3SUrXao2g$lsuEco&EVo|N~#Wv}i*
zdKKx@va~m6Y0LX>Irp=&v=379eNK<>InUqD&G;hM(3>;#`G)uCQlK>_x7c%!^Zqw?
zqSxL`ju+(|_y0RNxR*w9ye#KYCI>k}|iP?koKye&%xlqEXi@vbZxSeEE}>-(}~P+8J}()y5Nkstp9ci$sV
z5IPG>_rqXy8nA9CNA=9J29VDpKlFgVvA6SHc@_lnS@DP7^fye;`z+8q&+0&gZs*KL
zk)GiHN&cVV|5^TD;D5_EOm@iy`s7(ch&L6>QNi8{_EfMG5G9@q^v$!j5FdirdxYc4
z=g{LZCAmPq^4`7dE&mEJcFDz=b!4%Bo+XJG$15MJiw_JaOPZ0K_=f2yjMSDT2aufk
zh7Ux9#4AerMG5R(*FN-+ON+di1`)lHVGk*v8JNOL)jvobvlyj~7=X2$GszdVx
z`qOLrN5}i@8J6cc|C2pBX<&GsRrZ)%kP6i2iRfoB{(czwPow`;bJZjAteeCbH0K@C
zosWvVU*%auiP1Yk`;G3-tf5?BRGvkDc#rMgUS@T#ka_$q;%`}ZdKjMtM(0^?$!A5N
z_T=E(isjPPfOzX=dm;Z9bw~TXz?i%|CFgJ?Q@h*S-`KLG9?8t^_U1dTEE$JnZg=XU
z7Z_ibj7PGtJMZqfz=S-DJNaC%ori1EU(;X0MK>3iSl&CDz2)m6zA<~bhQHxyPs+=4
zj(yA1<_Xx}aQ@fxH;%vY-SI8^C@{I4t0(99XL5bRQ=O70YNFoHKRSLQd#2`j&i`c3
zc*jXh&p@kaLj$nh2`Y`6Skl8zqLCf
zfVse&JPTg&_K)N?dmixjm_PRZ1bgR}_g-Od`8>>bv*Y>h?FHuLSpnCV3*}?aBbi^8
zv>>_Poz|BT?Xu)L63)99$-=Va29oF9nN$8zU{PLnaGt$Lcmno!f&VT1UFYvccfuEZ
z6j)r&b?BeZr3;WO$@4_@n*P!8z1g!g&vX7Kdo(iDvb^;A)~2^E&r82=E#m!(ybSu*
zqSvj=%dl^4n&hgyjQrMuK&{Tp*l#VW*qXdd`Ifk0Re`m6nftBHnOjGV{FYg9j6~;U
z`M2hpvLWv-R@gkcjd^#e!sgL!%Dc-IHji#|-d(Nme~Kd-@{V;`xx&b+%{!Dx#YXv#YlZK?XD
z9__jkjJ2L|gyy_^RN;3e9`zrwwJYx)vqix6Kjd7y^X_Ryd74q)J*y~BGs?T?6-+a#
z3hc|f7Zo;na(~{j;EQ@$9>_Zue2GE_^X?5xzd(ob?rnv6h#k(mcNIh}tPLE=yAKsU
zf8~jYM{P57?zaNRjN(@+nfIkDp2Xjgr1q1fXSZXr*kO*yoFK`q4C1)_7dXP~Kwi8`
zj#5jA`Fy(QXGdLmtA4(`Tg%?!bv8?v^vC)`9Y>RVq|0P{Je6PgY^|RC
znx6eXa`va}{Bjzicf>3{p8sl|{>CWIGK9x)BJX-u`uz1^w4HCVj
zz|ZifYskgVYjQyoz1jFRO>StSD@MofX>wna7n;1(i8iwAUDZ?>q#Sv;)C5lxP1qK~+ELX(r4
zoYLfsCTBG{r->FoQ464`>iK;;YiT5EP#UYrI8EkivQ(1|nrzghQIp-8?APRgCKpKj
zD?CmAxhAce=vwf)5ZtM}udCVmZ#8+R$$L#yOZ+}09d&QV*P7^#j#`U44yYv2r3X8X
zAnCM)=hLZ?NVM=$!<;dXtG}uUH;`GUHIjryCfgKL{UF}t;rir
z`tTzk571vemKCgU}kMDi&H=F=Jc`e$0DK3l2D8co)be14K0pSNgo
zndA#<-+ru4u8MPAIjOeCs{k|GK!tGR60K*`EodC`?6k>
z5t@wDWP&D>Nxqs$^3Ay)EPUE`6zpUHWMH=)uz
z0IufU#7gr3xR!U5D$N7ndfrX0!~=juB=T-br8Rsv^KNRTh10y1chf2@oaXJkn_lVv
z8u{+z-Hb|W7VqZW%u4@Pklo9>S(P^B{C?ieuCyuV5AtqKrA;}1n0Iq4t@(VEck?P~
zD!(6ioOkmp{kT@#vPINN8dsf&t4_o(X>wT;Yd*fSl4`HZrt+rJkL=}L)a`LTuDTT0
zRv@kmZN=4M$De8PToY@BzO$*XRHla2TBi7WB~_((4>X~L`+Aahiz=_|u#CM;9yHsfrriT^W1*WxTc`JZX7GP
z=AgZ99LGQe&0?LvKm^TVoy0%{&0?LxHU#a};xx7)Xs&W+unj?Tl{<@V2%7CWS8&IJ
zX1mT8+=-yst_uZsGHAA|rQl8lv0b!01$R2=7obZ8cP40ICoW@Bg65lb1(U)vVeeH;
zO3;kjHB3s-jM{ZfO3;kj4NOYV{26XyQi6V%BW__*g67X~8I2mPzi
zYwCE=zYM*hjt9-3;VpGMX#NcEsN+HNXLwH?58}^&VW*A<{ZmknqWcguL)WwDdW3v!
z^?Mav&yarz>RoibLjD1$Pto-b`TL;0Mb{_f>!g)_Mb|gv?}GXlUB8gu1Pv&<{vm${
zG_dFfg#1QmP|*zx`CFmEMK>tqH$X#*Zg9xo1Pv{^At8SQG_2@`hWvHV@S+FS>Cdvsx31ZhXkB*2JQl5HhPZspuw#%xX<8x=A6kT2qQ{a>%UK)S{abGOIPM
z=%$9uYE3V?X(6*(Gm36{$gI}PqMH#it2L|WW`@ja%`UoGA+uU@if(quAIO!?ExI`&
zzdtmu=;ns}zR>)ln-?;hwxHreEV>0DvuTTpZehr5+Tx;H6f&E(r05oh%%&|Z
zx+Nk12b^VD(Jc*GB!T5cw=86l1XdK?@{n1)l|{EAWEO8#(X9-b#amr;8$xE&))d{w
zklD1gMYkzrHf>$eZ4Q}DTVHeyA+u>4if&8DY}&@6+Zr;PwyEg0g{*(Kx#)I<%%(LI
z-R_Xtv@J!qCuBBlYtiiunN8bPbo)YP(;ACzf5>`p+l%f%$a-))itb>@dT=|7?oi0A
zPgBvI3R#=gTy&>H)@JQ0x-%hbvvwEVrH~C>>?yj-Asf2bTXa`K7Lj9L(cKQ2_tXBO
zyA!fui33GWYZtW~;9jjFN|yi#-*
zs_aUy7F|n~UFo%=yI5sIDc5;IRW_7zgC|tQPzv+Jc|uioAGeC`YL(r`?V`I@W%qHX
z=&o1UecUa&8&!56_loXj75DMWf%`>wtIE$Fk`0Ei|$#K
ze+PP2bkD2&ThMbJag~1wYUL4E`P!j=!6UBn&qFUUcvb#c=oJRfnXGogXgSyeuu$xrpoUr9%rijf#Pwd$~{VsC1-bYzMdt=lCwHtzE{by~^S6$qjbCeue5=azmWI1?pFFL!G}F>R)ohoWBtoP;$ea1qc{eax6`|mPUS1$&GM+
zZZ<7(Zk{GOdXihH$$v9=vQ%X@g0fs`g(liJ_y@x%+DkacyZoS1ZmsUok(~0_igp-s
zn>DdfmTgLnnrPSIAB?x`(M|0-*qdu^F)uAPlJ=)`9XRV6-PSR#+&Yp!;hqMU+<50N
zhK7{f1m`b=hL#-b=BlgBu##il+_}*3l4IT6*-(ASv2N~6Xhg}eJnlqjWXZ8Su8w$*
zDmj+N9Se;vIhMyA4UH)|md70ljV-wa&et_W#+BScXKyXzOKy>~m2xJO++t@dymZgt76a=hHrtuDFM
z&X!4?S#oR2O9{^^xwYk`glCsrgR?i8IVHEn*_+JVlH2O+O=e!nZFBY}Gr!~-oxRB{
zD7o#<-eeY*+zw}NGK)%Xr?WSi#U`i7#$u&EBlUZ7FyUGg)FDtp-UdwZm%vNOt-q^_Bnf#Sygfe${M}8QtziUeFgfsKIw&YGaGr#Lf?vyk0yT0UF
zoOSOul-xyU-Mft?cgb1zZd1u!cJ@NLx#X@m8&_^9xvS2`mA91KHD{f_ttEHeS?6zC
z$=z_)`D-k>o6b6a+e_}2v(Dd+lDqA!^S86)?l|lGHI>|5XPv+1lDp@u^S7(y?o%(g
zx7{W8z**;SPsu%W*7@68a*v#K{`QsJV`rVe{U!IrS?BLS$vt(}`8!y0&zyDs4wc+<
zXPv*pCD-b#^LM1=UN~Pne@9F1rL)f8v66e`tn+ugd=<-4ZB6qvEJw99&DTqAWVKnl8zncY+N|Bp
zk{exZ*6voxjj1+kce~`qR-3iEQ*z^~&D!0i{#Ki{yGQ-4wubvY^|#tI=K=M%+BD}O
z^|#tI=MnX{+BD~J$xW@chWkm$O{=!ohNmSrz1m(Io|W8;YSXLdB{#F$^s2SwW>uSB
zy`b(_n_j)7?pK>$y`t_{n_j)9?pK>$y`k<`n_j)8?pK>$y`%0|n_j)A?pK>$eW31F
zn_l(s-I8j5I#05v@0M2kQ=wkITUPB)hI;#Md9~S`KE7LDZJoNlzS~f3ow|O$+gNR#
zy8gavsJ5=$0N-t?wyxYj-)*h7uG}EsZL7Af++g1|R$EtYi0`&nTUTzV?{-vMS8kZ^
zc2-+gZn*DQd|6*l>wU-K%i1Q6@ZEuG>j;eW-NCZHjPl)~vc8P=-QlvnjPc!(vc8P<
z-O;kXjPo69EUUhZ_Z@32{{b|?cdW7e`_M$+oh<9iB;TDX>&s-{oi6Lk6yKdG>&sN%
zoh|FjG`a|7eVOjN^JRUR;kyfEeVOUIma@Lg^4-OS?9Y~)n;kd
z`|fqMS(**LdsB_2`F>!d@7{966FM&)bpXDj4#59|arHO4`Bsy6n!MM&f*T2RZxNW{0P-6{TqwfaRSOd4+cY|uIf!pD`!8O*v?eyJ{8f)O1
zd^fbl8n|ZP4Xd$rz<2p>c#W+CzT0>8H8zm9$9E%YY#?v1??%?xK;AyzjjFNcZ@=$G
z*I4s+z;|P6tob|WyRkLa{2lV$xEgEz4*PC=jWvHqd^e%Sn!lsIn^ZPh42Xge6ayfLieMH|f&KK=2VYIq
zoUHQQ->$dz{?>i}?(2TmT5XwMSyg<*QC+;ODPC%dm)hc`u6U_0Ue*>b#Rn(K`r?Jp
zO&W@S+E~2s3CdRSr$G_L#{9~*;{R}a@v@_M*;TykE?)K&FO9`ZQ}MF5c-dFH>@Qvp
z6fXyhmqW$N;o{|pxcr~ezx8PGpPP%9mg1$gcsW+Qv=uMMi;UA+8%
z9vT@-|JM7(|G4;!RT(T^iqArohsDdI;^jXNmWGS}I8wYkFJ4BAmsiEhc=0k(yu1~c
zR`C}|i~n9Hi~l@TynHBLich7KIdLgIp&1w8m+@?LLV#b!v(dMHoGs(o=%gR*W!y8T
z{OBm-p83v?&NA+q(|(*QT%bAEJ}iH}RfiIEs3W#Sh){_lVLB1Vb$Prr)CGU|`w
zYNLb?Wz1EZBz!DmuG%bNri{62i-b>Q%vD<@%$6}%ZIdup#$2^s!sjyPsvQ!(lrdNB
zlpy{#`2Q*XKi?(cTN!iJZVBJZn5*_k_)*4O)hOX-8FN*WgnwmBPJ1ORmN7Z)ldx3A
zZp+RKgk^lT)*V^*Zij
zEfO~9xR13;XwY#VJ0@YfjsvMp!VVn=(s2npbsR`1B<#|0Af1%3TgQQPO2Q!>2hC{-
zhjkn@XCxfaanPKVa8$=Z(=MS|$3fE}p+(0*(Nr3yNjRtD0J$vTyp98;OTq;m2S~Ss%Q}vYD-ybN92-|9T+{KsU6atG<9+Lq
za9zjyc3r{^9q-!>3Ac5n<0}bwbfx1f33qj+<0}chI^L~268dz!TX!Y&>zIOjCEU|7
z1@}o9&@lz~OSrG&y}T#kfsXfbK*FGo_wv4kAsz4K0|^gxOu>T^9_g5Zha^1KF$F)A
z@I=QH{7Ax69aHdQ3D0!QJWnJH>zH|-N*K{G^E{LAT*u5aEV@j`?P^4HnU34lbJ1lw
zZdWfvm+81&jfyVQal3jcx=hFI>Xqm+9k;93qRVvLuHJ}_(s8F66CI`FPBkt%O2?gQ
zLUfdlJJnm!Q9ABalcJ+^+^MESN9njzy%Qa!<4!d#I!foC7ya>Gbd-+A?H@!(>3H1!
zQFN4!$L%wsqjWrO|0Fs}$K&={(NQ`cx6g@=(($&68`9T-2O|#UmcIz=SAn~#Cyl$^htD{&i`2aX+dHOZ;htj9NVp*;mS_
z)ANvhm5h2l5810_tkv_7eYK2rdLFW`k+ELSL-raO8}vM6ua(iD=OKHYjE#C8ve(Pl
zq~{^~S{a-5JY-)dV~d`L?CWK0)$@>jgN$u@9bZ|K$~dIwA$yaI!+LIJdu251xsUCW(W2)*wqHi8p8MDV8OQY8#}3M9
z({mp?B;%Bx`W%*VT2FnB$T*{?K1XGo)l;8l8SQ%N(;}ls&#BQWqfgIia7;$Op3|UB
z#yvf!!EqS_dQO8AGVbd+4Nl55%b6PhUD^Jk`^eb26Uk>C1T;!+QF1LB@!lzFd^?Tu)yv$#|isFPCME>gh|DjF)=)
z(k@mfz`uF80$r!UuJjOpo1kBo6WeYq}ULQh|A$at%#FE?dO>gmfZ8B==t
za$CkbJ$<<&V_HvN?#g(tr!T!SKIrL7pNx-s`qD3BMo(Yv$@rwFF9R}W_4MVwj5$4h
zc_8Dnp1usq_@d|O&5(?*dP?(9#y35sc_ibzp3*#)@k38(p2+yAr!-Gx{L)jJXENsX
zlxA4QZ#|_Mk+GnsG|y%H(NmfiGXCl*&8UojdP?(B#-g6myppk`r!=o+EbA%F8yPDM
zTztl4tTb@(8JDrjz{O`mMzw)+>#dB{2F|TX8EXujTT?P>44hlQS`on6KqEGzJca^61{JrIkTeo4K!y?^uB@Sd=|ZLpgCVe?;B{&
zSJC?hn)6NczQO-Lgg)Oz?;FG~;fT|B(fbCzaPU*~zJa0om*{;1L-oAqeFH=FZ_)b(
zhUx{;`v!*UKce>y4Ap-{?;9AZ|B2o=FjOy!-ZwB*FNxkaFjOy#-ZwB*uTXH%Kyy|q
zIAowXs}vkI(41-oM+`J)wSpD{rCFn()j(-#6dW^9npy>I21-+>;JAU()GN4PU_x1|
zV9>xkxlX~5fq8Phf`@(7cCkpl(X~a_n2aGi0ndmJejTjcaWuy@!qPL7R
z;<@N8BaL{W;HZ&Cj4Eh0(ukL$-;6ZkmFPDkjd(5k%}68Oh<-EDh%wP`MjA1$;DnJz
zOei>Mq!DiwoHEjgNd;$(lwnFiyOA=yQ_x|g4ATlajg;ZNf^$a7@Ik?OBiHSZqLYnW
zw`UYwG;-bkq~MZ~KZrT2;IfgAgy$4=8Tm-~vx06T9|?a^aK*?+!e13!HJ0{Y1=ozF
z{Z~Pcv9$jxxNa=%zY1;`OZ%^an?^opomX(n$Oo;z72G!RLF7g
zWaM_dTE#;nx8pS`9vP`wjf%%cYF4Y_iIJMssd#FnX7wtb8L8P?6~jhqwob)}kvV6*
zicupq+o0mLk%l#>7&n&oUlo%^dbLT#w2?|}R`JnDo3^N!HBzLlD&~w7X`71AMvAmu
z#TO$*+M(jBks|F>@y$q)cB%Moq)59}{4i3aJt}@0DN>_~Uq*`5q+;Gkk@l+iZDf+!
zr((fKoA#^tW28+7RQxs4rh_W}8EMlY6^lmNbXdibkv1Jsv23JGM^&sa@p(bBij^il
zFKAJ*%EaddttzTb+=-8=SZ(4?+@@lUi97Le6*VS4qdcLa*2HI&Csov$XwxYb^(NYM
zTE%)3MLMHmgNY)YRncIgNbM>%nkZ6-icKbp)Tv^#i6Wg-vBkuL+w&^6nrPDn728a-
z>7t75CfamK#SRl~x~yWSi8ghq*kz(k-70pQXwwxHdrY+Hs)|MvZMvqS$wZraRO~g;
zrt2#9nP}4u75h!J>86SUCfamM#X%Eox~<}ni8kF)ao9wg?y5LqqD{Rjj+$swpNeJ^
zZR%IiVxmp=RJ59C(}0R&CfamgMVpB>Jy3DnM4JXxoG{U*Ar&W0wCSOWQzqKEg+BB`=j)^wCS8>-wn?9)MHPNPzD*8;cX+}lAi8g&wanD4XW>pNB
zXw#gq#6+7u3rkG2>5H($M4P?}OH8!so3O-0o4yN6Otk5Tu*5{0ehN!WwCR_y#Ke=k
zdEthM=XJkTJU8*Zjs+DjOnk57kFdnV_d5QncxmE$9sg9kGV#5RMd6Ey?{zGxcw_Rv
zEAGE4#!TYZnZ*99VcbNKR%)0qF=?&R@YY0|sx?fSn6y@Fm@-kRH5%TTn6zp%Oq=Lc
zt%mm|CapRRA54_1Uc*Ndlh#@dGbS3gPQxb?lh%3-vnFb`LBpJhNvlD_XA@o9sNsu=
zu5Hrr)kN1eYxriOYg;t@G*Ppy8h)E-*ftG+O_Xc9h9wid+M!{knP+o5HLNo8Y;Ko^
zHD;d3?bc9Z=84=M4Yg*T$Te!HGt;If4fST)v{%DgGi}Xfo5LQyTV~Y13&9`^>cIjE4PY+H_XK0W)oC*Kp8G
zn>sWcGSj9`4TsIN>70fmX4-UK!%;JBx}c%iOq(uhXfe~KOB!0uwCS>jV`kdarJ>DC
zo4Pd|H`Aso8cvvL(^UaM?_0ZfNK-Q<|F^y3Lg4mWC^4
zrl8vzu9|7i9SzsaH0Q2{9y879)o|TRbNV#gGEF0QywUK|
zOkc({yfV|5aSgA{^kqWBn3=oyThZNS?&6c8yUpCir$l#~xr@IOJ#FUmfN9awX8Q78
z^t742d=NctrY|2w|C*`FjObr8Rrw_P*GyGrMgN+q%ADv`vwuRU@>%q%nQxGN(eT~O
zH^{zf_+jQ7WZyK*oBbo=fA72KU$g(2_|p#!3ugZl@u!~}{+Rub#GihNo;Lf3#GmFh
z{4XyqW+S
z%6Xbs8^ES=`cfCb=5n6>*9WkzoW86LV0$@zSr@>La{979fSu*^WkUeF%IQl(0K3cS
z%f$U`Npq%G*TLU;)&hxr$0URmk`xDy(I9ks0x*Y*D
zm-D=CX8^~_c}lk{fVOg;((Ml5csbvi*b~5sa=tau7{KXrX5gj(&Xh9)?+xH=IWzFS
z0NTr$f%gY+uAIsDKmg~
znQ|e3=jEI!7Xx@v&J27hfYEYh;L8ELEN2Gp3gAsSlW%tbW93Y~R{|I>XY#!oz(hH>
z@@oN1m2(&G3E*8hck$~1OqX*PzY)Oua_-_c1DGl227W7mPvtzXyB)x6InV3v1n{Mt
zr*wA%_*%|Wy50c3mGhLYFM#jmJf-Uo;8!_4xEH{DIXxH%;CDGaxF5hmIX!p~z`t^y
z$PEUtSk4oRm4&n7aRAj8&Wa}ithR7gJQW>f;e>c5I?BQc
zF)TXD!U-`Fz*-9@#B6IJPiKCJ&a<#0eu~bsup)km&a<#0=0)dOSP{Pi=&_Z$gg%EB~qG>CT=rjh0#rY%e(EkV4uFpabZ@xj70ax93C7N(K5AZ9E~BgcdI
zWMLXP5yY&8Y2;)Oa~AGBr-JxwVJ5c3x1k_$onwlJ4m3}V5;TyiOhKNjYa%Rww!m`1vSSh6sU
zbO*6)VH&v-#0o2C&($DSS~+{J1+mJ?+0zq5wUx8ydJwCvJc+px#2PE7(9Ixfteir(
zf~d7}3f&H(&dMotCy070Ph#!{vDV6Y)EmS)E9X&P5bLd+NBu!;uyP*V3!=fwc{C8j
zMl1K8`$257axy&#VzZT#X)uT_R!*j&Ahue$_dE<@o0T)_Q4rg$oKcU1*kR?2dJ@D=
zD`(WxAa+@~_dE+?x0P}Y2eHS>X*Ci=qm_m|52DFR!(Ifj-%7bggE(NNTrYz-Xr)}Q
zf;eQQT(5&TY^7Xpf;eKOTw_5TwNkF}Aeya|Ya)miE9H6{M5~o@O$KqyO1Y+jXtPqT
zcR?Jta)M0^HCqr~S*h6{VUv|lq5cY+tekZJgiTgXx)4}cL-xv
zy0#~Tw^nM_7{a8Lnl*(mWu<0&LwIMUX8S^zwoyj2y<3y)*QlTD>Z8g;fs};wTAH3O3jXi@Xboi+CunlrDn%N
z_+h1HCqnpXrDi8X_+_PLr$U&wQnS+`{I*iFGa)QksoB{O{#dD5dkBB6)T|?fe^zSN
z8N#BKnw<+_$;vJ3dcYD
z*M>tlWTR^%Asn{RwdWxmvC*{`A+*@2*=Pu@Hfr`Vgkv^p_9}!n8#Q|!!f_ildlSM5
z8#NmX;iQe4jfZf`M$INdIBlb5Z$mg^qh^yKoV8K2sSw(2)a+dd9X4t<9YUv#n!OL<
zoQ;}&2;sbqntcr6f{mKZgmBSD%|3;2$wtj)L%3|CW^*BQ*{Ip)5V~#D>`Mq&Y}D*)
z2v=>?>{|%eY}D*~2t77x_9KMrHfr`Wgc~+yvtJ?Hw9&Qs5N_G%+V2o<+vwUt2zP9B
z?T_%vM$P^TuWU^4|AbdICiq3+m5m90NqA*rf?pP1+4xL-MHquNYPK?rAsaPY6~;pw
zHLDKek&T+I4&$+nnym@riH(}ogz?ly&1%DVW}{|xVGP@-S$!BIHfpvujOR9Lwl0hp
zHfpv$j8Pjk+YrV}8#QYPa$~Tf>;JQL}Af
zytPrY?O{yXn9_EHF=eA`JHvQqqiegun6}Zi-C?}9(X~Bc%-E<|V;G-o)T}9tSsOLm
z8^)ZCn(YhYvyGbV595oCnjHw^tBsl+4C9-PnjH$`yN#M14&#T7njHz_r;VB&4da)M
znl*L8#Ox_#*&SioeE>w
zM$Jx#vBJ)`cg}>d(#~^%vtg{V^IV`kjA}bI>j-1DotkxqvBpl#&V^B9XG%LCMy;K$
zT?nJjPS-AmQE#Vfm%>S{PgG
z)T}3rt#)d5J&bL3YIY-x?RIK*GmIT}YIZA(opx$=JB(d+YIY}#-F9krH;g@YYStS@
zqn(=dh0$cEX8mF8wNtZuVeGS0vw<-7+o{?8Fb>$M*@G|++Ns%K7>DfCY$%Mwc53!8
zj3ahx_9%>_c53!GjAlDEdlE*Aotixjqt(uo_AHEJcDgnkMw^|kjf8RBPS>7?al%g5
zUW9SlPR&NcIAf<~FT*%%r)IChXtz_d*I{(nso9$_I_=bKER1t@YBnCmc{??m2;+jC
zn!OF_Zq=?bPgJ7}xC7Y$l8z
zJ2m?h#&tV2n+@ZJotn*sannxCK8JD3PR+iAaobMKzJ_tfPR+iBao0}GzK79kr)EFG
z=(AI^pJDXdnbLlRanDZI=EE4U)3x7W+_%%Ug)ko2>DnLRm7SXX6<*o-hR{FZm7VV*
zE()*gd>3&^cxC6ih|9t&JKsfI5y7yXnyrjr#7@mtMey8C&8j1KVW(!RBN(+)vo#UC
zv{SR12wvH#S#1Qb?bNI;f;V<*Rv*EbotmwUVBAj4)FI&Q`(LQX6EPMsu?SWm1aqBZBn~YStOS1_w1e7eRxADeZg&8y$4*LIj%}bnRjUn;mrRQUqHZ
zbnS8k+a1)bD}o&kYStaWP6su+62UG9HM<(YZU;5H7Qr3|HS39>(Lv3wN6_S;W;Y_(
z>!4;gBiQGlX15~P@1SP4BRJroW_Kbu=%8kIBRJ%sX1x&{c2Kjv2#z?YS$_ma9n|bz
z1kDa=HV{FJgPPrspw&Um9z<}=LCppuXme1rp$LvUsM*5^PB^I9qXn~va?gPOgM;I@OBeTd+WgPMJe;I4z3%|y`apk|*U=yOoB*$Da_)NC$-
zdk$*$If4NPHTx35eFruB8o>hxHTxF9po5xyk6_3_&3;7i&_T_9M)1hNl=drv#}2wS
zAHfp`UHcuuQwLpJh~SxnuKf{SIjGrR;gy4LR{s-TIrwJvqVUSWH>;O~R}Q{ey)3+P
z@XhKKQM_?bvz1YdIjGsHD8?PstU8Jb2Q^zA#ajn8TNA~kgPPSuG3B6UwNbotP_w!y
zrXAF*K8p7aYPL3t4-RU!E{cy1YPLR#83#4n5XC14HEW1s)Y!#@qxj~aX4|6p?x1Gdqxj)qO4|{|PX}Gw8O1LLUE3AKyo0Xoj^ek2
zuI-89uY;O3M)A)<&6=WEbWpRsQ7k#A*}f>29n@@p6f2yipD&4GrL*+&B~h$$mVUk@
zifSh{I~>JoCp9|~#Tq9yI~qlelbSV0QR}2;Em71tsab0j^-gMbEQ+;GYStFTIwv(d
z9>sbmH9HZ-1}8N;8AXGWnw^Sbqm!DQj$)IOnw^Pavy+;gjbe+Fnzcu<)k)1dqS)r7
zW}Q)NcT%%+QS5LsrJavrr<1N-h+>zMu3d~`x09}2ieitGu3e5|ualZ}MX}FG&AOx5
z@1$l|qB!8BW>=#)=%i-XqB!KFW<60Hc2cwJQ5y6^LlbZEKal%Q>`lC4Mq-OV`IOU{f15uoIQnUL}oN-dK
z2T`1LQnSG*+MU#FD2fgzHG3FEr<0mJisGD;nmvxaZZE30
zqj=_|X5XS1c2cwNQH(gL*^elmJE_^vC|)?3(tbrT>ZEJ)QM`20wck;^a?-VhC|*11
z+8^PSlbZb%UOD-*O#g&ePJS`6D7sX4Nr#bW*d`G0Zrr*_s$WIjLDq46{yZRvW{dlbY4V@YzYt>SOrgq-JYl`0Au)
z>tgukq-N`5`0k`;8)Eq3q-G5<{B%;YjWPUkQnO7l%sZ*s<`{lEso9no7M#>DsOsmYsBMcML0Be2;ri4Am}b))>QT7d2~&
zVU3HL?Tw+vMa}lbQ0t;*`(vncQL_Uv)VrwJ!5G%MsM(4qGs1)IN_pZH)1&HqGmT^IOU>dw_-T$qGq>aIOC#bcVal}qGoqvXm?Sw
z-WWPu)T}RtP8T)nkKvq)n%#@xyo;I*#Bjky&F;r=(M8Q3#Bj+)%?4w*?4o8vF?6}8
z*~1vRUDWJR3|Cy#>~RcNUDWJJ4A)%L>}d==E~d0+Fm7d3ksL!XP9y^5jVMa^EvaL+}}-o!BAqGn?;+;>s4@faSssM$me
zgDz_JHijV=HJgm#p^KVL#qh{Q&ECcE*hS5zV|e1CX76Ko>Y`>JVtD4FW*=i1c2TpL
z7)D&w>{ATSUDRwgh8HesHW$OFtMvU_3@=@!@84p0HD`B-ndHNzr`@-
zDt-SJ!?>&T{aXwZuG05!F}!t^zJH5h(nZ&P$1vrhYYQ>FbJ4Xw!Ydaw`zyS1@#p6L
z39nrIxw%E*m5V<&wpvxYbpUDRx297`^0wkeKf7d6`)#|n4p`?ok&x=Y``#j(m=`u;7BYIo`Tw>Vb2
zOW(i6vBq8c{wcnH#KXDV}qNT?Tw?sP0jYj
zvC&P<_Q$cwP0bF(vDr<{4#u&?P0bF)vDHn@4#%<0P0fzPvE5D0j>fUWP0gC)*y*Nb
zEphB}Q?u4McDt$Bu{id)saabbjc#goJdP$eH9HZK{qu!8^<9xHEWOKu$!87#Bsz;%{t>a>ZWGr;%Ig=rJawX#ZA{P#L?=eYZv1<
z=B8_x;%IZzwaamwbW^jgI8M2#S$7<#-PG(#9B16r>}nim-PG(_9PMsu))PmEo0?sZ
zqti{zZp3lUP0en`ao$bMZpCrIP0en{anVi9?!Q
zKaMMIYIZM4ejbu*+c-wt)NC@2
z=Wc2?6~_xVHG3DwsGFKi$MMol&ECiH%1zBa#PQlq%|6EQ#!by;;uv#Nvrlo1yQ$f1
z920J8HW$ZRH#Pel$E2H@eTierP0hZ>@y<=nzQr-^re@#cc<-iWKjQe{re;6m_~>Rz
z`xVEGo372r@ySise#bHErfUmv%(>~>AK{gon*9}Cx%uOn|Abd=e%HGwymIrq-X-Cc
zo8R>=3$NV#u6IQO^KNRkGJ)T2YPKqY1vfRTPT-H5nypUYubY~!N#LKGn$;w*=%!}1
z2`ss(SzQ9lZfaJazzPq)tXrGFN)NxRTbIBp55KHipFp*Tnr%p6wTGHDB(TOq%{C@b
zCOYdaHY@X)ng
z32gMxwcQD9^3b(C3GDLleV@hznmkmhDS-nXJ`LZSK&yx5>`S1{!{x5b#Oj`J09Ns3klry@a|tspx48@
ze<^`J5AXiv1o}O^`&|hPc<4)a0{1=if!0ajRc-~cvgBdf!7{taVvp09%^wrfiVwL(47P(JbXTVH-WbvzIW4`z@&%o-Sj0e
z<>6Nb{RvEasKvbm-g~IUKms2;)Z%^uGakML{2+l(9=-)Un82)uZvhV_Fz4Z0zz-An
z?BQ1ij}rLmp%IT0_~xMzPZIdH&j4`p~Mddou@UWtzK@O|LdqN6G}d)|nSs$fNoiH@pZMU0D%s$fM-
zh(4;|*7jEPOa;@;r0AInrkg3z9~Hd&??f+D@Saa6u%&_>|2~236};0QL|0Vs{(elL
zv4TB4lfb?T=8{hd?62TmolW3S1$V2t1P)hlxB8qwa|Q3^mjqfWcrU+-?y2Bu_czfg
z6?|g%U35hS-#Yjqx}t(_9sEq-S_SXSFHxrzbbMaaX$2ksE$Xy_jxUHht)Sz761Y`C
z$Nwg9yMm7Y6SZ5xd$cHOw}SU*Nz`ry@6ocT-3s2L6-o40uzy!3aj$~?yDEu+3ifYx
z5`z_`=O0N7Rg|88B=NAK^!y`NxUuHtu0ARR&m1Ch@O=GyYH#ixuqJ!$~YvuxpPb
zv0TBfJ(|P{FTeF@PGY5(-+HtpvC7MDJzA5f_VRtqV@a&`@_o#3?Su8@+t`e=dnlUMhb+iOpUre<6u2URKG)B({24C6|)e=4F*!PGY;4%6BEP!^?W<
zPGYB*^>QVNJzm;=HHk(q>*ZP!O7@+Mk~rt3_rpnC^iqbABrbV*n*2P8%U&AsB8e_9jTlX$+skKTFO#_9r53M}xa#GT
z{?|!d^U{qsN%VO6q<<`l>s|^np2Q6=1(`_Vrk8W!Z4$SL4c4RS$F)zOzSxREu
z%Wp@Pg&G0zIwT*Y)IjomwQS>3g5ll
zQ#PjX!^<48DTSY2=7`NH{PJ>7*^MJSN;S|kKzRI*CCQaD@5D(Oz4y^>XOC57{ql;&y*mn&HZ*HXAzNmY7M
zxKYVFeLaOcm2~4q3U@2%#?2IZE14~BrO;PNL2jqeUr9mkq;Rj2g4|7Eu#$JRH-(`}
z&ZE8*9#(Q5^{4Q(l1AK1;aMe(7)W8bl1AK5VWg5qJV@brC5;$N;YB5l7)s%FB@^Sr
z6y8)ampn>gtdhCpaSD@_^x%o;lu9O#r=k}s+40XrWmj@D92S*b$<1&?RCXmd!{?&1
zE4dlINa1%SQ{QL`3zbZLFGXcnavyvps<@I{;A>IEmD~c~h$^n+7C0uVxQY{ETvTio
z=fZ@j*ecG2x1wUJI2R^G#a3}HOo^JTV%NS)p`nWMPp7b@ihcP$g{@WW%MYR^tEl`(
zQFT@9yctn-RqVV^DIBljf6ucioT%b|&vT+msyO#Qiz=z&-2Wn~q>6L@tEiGHZu#Ft
zl~i%d|1PSeid+7V6gsN7<^N2fvx-~(uN2NzF}Kf)8mi)5_?^OqD&B>K6fRcrF8oR1
zQWewTUr}LIOo#tc=&E8mTuh<6is^7Eg)3FON6VuAs+bN}q;b89(|%x=8SEX^Y
ziqpP2jayZm_N&vlUBzj?CXG8)oc1+o+^yoYuT7)3iqpO>jlL?T!}>J(tJrUA)3{f~
zep{EuKo$FKeH!WDYe-|Tiv6}RjiJ(A-IT_|D$f1QX*??3-z{l8F5Ta)
zX*?<2-)(6OS8>{JPh+Ht(|$)9&#O4?cc$^8iaoe1jnUFQ-<`(GDkjD~X}qf9+;2?d
zbrt7+QyOoo*r9vV7^~vk-<)0nN|+&`AaTovbjTNg)A&}!o<5bv_bT@E=`?;+v8T_Z@w19OeKw6>RqW~ZH0G-~_dC+~UB$WI
znZ`mD=l;1g{#0@9pHJg&73cniH2zg_GrX9_Vii07QW{HDOaPbDSgv9M=t^USkB)bz
zQSGDNSJGJRquy83SmUGK*V3r*QSY8KYJJrEdKz^;>U|@PdLQ+^nZ{Zl^}dzHIv>v`
zZ>O=|$MeZMX>9QEeDZD@4L+Vv_NKAX#~raRjZHr8i2Z47_HjqNm&O(!cf^4-w)%K#
za6gT0KHB~ujqN_#KA6T1A8j8>W4Di@KTKnfkD@IGqdsraX!Y@Yax9HwJ|=+iG}?Sj0265(_b~yyP2+@*31BjfP9JM%DvfhK*3i2&
z&ihzH(`j7rv4-BKanZ*b`jEyYA8Y7i8kc>np_w$ge5|2QX>|KoL$hgI@v(;H(zxnl
z4Si1InvXT~C5;{*Yv`+x#>X1^CZzGPhQ14Fe5|1#LK+`y=%?_-N1J{LUwqtL=Y=mm
zZmz$DFFtOr3&Iy4PayvYUwoW1e}ykT&Y6G05+A3_qOior(}g8riH~z;SyN9xl4%^%;0;eUYaua;bUUlo54>Xv&Fs)e)%}__Gd8f*ua}CWAUZcipoY)cd*Xwr8-`&t118
zgY|ye)S1BsKW#df!6tv{`ELfB{iWx>8Eo;Fp8saB)n9u4o541J>G^L4+x--&D}x<=
ziqxIKPCrGulEE%NMY@{7Za+o3mcbrBMe50*(NB@CXVB!QNH;P#>Zdt3GidhHoLd>R
z`dKfxGdSjFz1+#5&Chzdo52Y`rRmM!q@U9CWpK(*Y5Frb<7buJ%iye^nPwn^c0cRo
zeg++W*2{woI{mDd!3@s%SuaBwocFU{9%gXC&w6>3!9_nO*y9W?`8mO!WYF#B=K3^)
zD}GL}XBk}cvr2|D=<%~kMl!hWXO%q9;HIDEyvX2|pXQ8aaNAFFUS@FD&)RsEL9d^+
z@j8P(Kl9L=4Ep`dLt`1-^D_^PXE5Mr9-7GDzMpyMZ3Ykg%tMnI4EmXerZO1vGY`EJ
zz3-ZLA=#ZtZ0XR%bOm$g}}l=uu|T^6e(KEqg_MYY6d7#p%!E%6yfLl$c!
zKEv3UMXkg=bW;{}68F%}S=3A1L$_qHR^lGIHH&o;_t0%wY>@awc6$~L5}(NK$YP_!
zC$c-U*d+0Z?5->}OMD``JBzInE!mUBHi?!rX0ctOB~4lEkZ8%?EOtt?WM3A$C8nGG
zS?rOxr5?zlQDV+Hm_?IBOAckRSE40{v)C^&KOf2BfW-WKG>d~0^K)|+ha~3bmMjiS
z%+IY^9F=Ivu`HS;TGEz9i$qI~XVE56kP}%Pmng`|EKW!iN$sX|86`BT<@bS=^AAWO}l=DKW`h&*GNE
zBy%H++Y*z^%`EOnOft8!=#`j|Z)edbQJOnh^h=cHZWi|>X64>21|;U3zAPR{l%_w6
zL5cI|UKT?V=g~kGk0nl_`&m4ZD9wW`o=TKvFpFmrr5Va%SSszmSv;4RX&z
z_@_`nW(NM1MUBi1JTDZGIhlS71!PX91)+e<$@E7kAagSP&0@XG$@EVsAT#+c3I${)
znI)ls%p|ic6p)!@R^+fn=GoWE9Ja}PTDmHS?J}R1R_Cxo=F`&EIqa1Av~*1lyJWrv
zQj^0TnI~SgIW)>V@v6(ANoIbj&tb33{IWKOeKPaQx*QJ3eD`C04hLnv`>`R1Lo(m}
zXvpEH%r`zZ=FlutnoT*h$dqPt4y`h!*^oCbnQ3n2FfB9F+|J>>%uI79hZ&hk=57w3WJ=SU!>mkc`f`|)DNTP4
zpJhsOFNd!(GtEE_-(*U2KZox!rFoFU51G;o=I~RdG($Pe%iNwG=I~plG>>vvkSWdM
z9RA3Z=1C5JWlHljhees0=2;F)GNl>LVOgd$BRQ;4IHR8Duu|cSdXYo5!WlK1!)k>y
z>SYdV6watuIn*eeQLl5TRXC&G}nIHMMY0t#o;lIVSflWAG>
zzQS#LMIIdrrCFKBIi>XdZyx6ro(WdxaX~44|C`4pg(o&^^5|0NOHCf#3Vo@~hid%Fv-;CaZTY#;MzQ{EA(Yu9yb*FvObTS3Vqp-$1R1KrXi2p3Ny{dJnky=Wm6u#
zO6mMBk3NOIY{{d)R4-fexL>N0ZFxK>Rmt`|21`}4BaerrD%qLGqf(XZ%HwgVN_OY*
zRN*|@lgDtWN*ePRDOE{R9?wfvvNw+xr7GE%$Ed=2v_Fqmr7Ag)$Lms+9L(cQsY(vz
zF;=RQ!+DG=oJU9Ucw4HHqj^l0s-!uOsZy1+eZjd9!%HxE}DfBvzlPags
zn>YoqR&;T@=o-*N>!#spQ}{m
zeI6H8s`5c}yh>F*=5bl&jy)rKU*$adBzj-vJen09uQK`0iH=w4%jZ0LRQmEo^uEex
z!e2%2t9&N>P4vFXCq&;x@2jk#AENhFPNtuE+)+81eu<7(IgjQ=$E%!2zw@}Kmj3qH
zJO)&5+kb=tD!1*wLIIWA_CKM3%58fwk0F)Y_LA^GdzXVmrrW>n6o9R+++sn5;=W=nOotAM#uUF|O5bE&TO6!5K7O^pS7FI7`h
z0Y6IBw6}ntrE1z&z^_s@?Jrw|U+`!uksMffFA1`3F#?!nL1=MKF#U~4>
z)tHM<6;P)!7oRSmUZY573RtUAq_YLA(va^cL8DEb1vF^1>0AMuG|sK_
z1#H&%1nWWpTQr^$Uo2p&##7=;1#HuJN_@G1?HUtuR{=XTCgkn{c51AvD+TP*SXWmI
zXw+Cu*9vITSWP_z?A2IJ*9+LEv6^lauwP>}-7MgM##6sr1sv3vkZ%`oNMl02Q@~-3
z3HfdTM>X2iTR^kMYU(SXMWa&v1+;2Z>RtiIG%7VvK$}LT?iX-eqf!qFIH6Ig!2(Wd
zRBEVz(;BPkVF70}R@0*b&T3TZaRKcbm3mS@hgLfOE1**=o&ObZPNP!81)SHY)JOpr
zG%EGHfJ+*u+KU1%Ys|`{1$1dt>SY1l8kKrgz!i;3y)NLYMy1{qa8099V+HhRRBF6{
z>l&4sDBzY>I{z!+wpKd-E8vb+I{z!+u2wq#E1*~7e48$yPvd-hUqHXc`SziJdm2;o
z#{vd4?&mWFJkV&&N=6t
z=H#4n&N=5iCnxV&-=B+(zIE?CxAsbVf7R7}s8Vl4Y5Gv5-ip%np-R0IrRhVJ>K1+J
z!}n>{6&#yUn!qosB
zPZX{O>UgSfHAu$`g{HweUMe&V(eX;5X{e6Z3QfawyisTxuH$VVdfo^f@A}a5M(XJ9
z!z4XQ$NN4^(xY{JRA?Hb2|B*@q32E1@x2c{Z<3B5
zeW+5Cb^Po@m71cXZzE^+sXF>Ka%P{Vqkki3_USqXG;(I2p<`epXZD#o1~qa|I7`Ri
zMyk|o9YY$aQgd_+ZKO)g)iJ!0)B8LfBN~~h=j#~RNR?WkV^kwmYN3wNjZ~>cI>t0o
zr55WL+enpKqGMbmRcfh@@r_ieWjZD`Qk$0RnB2(Rv_i*}M&_oKI;J)v#;bS!D4N^RG%tdVHip<{U?(X>;?ibkr`E*&cy
zsZzUjtZJl6?a{Hikt(%U$C^f})IJ?+8>v$Jb*yWoN*&O#p^=_dRRjhntv!&gnSXr1pP0jy0+MpN`{AYX7I>WRu$e={VJ-_J2A~H>v%f
zj|Yhw1frsI5*+W+ae*u;~D8#*pE@ucCVj>}CvX}G21Y7J<@T%iCe$Nq5@6Sk|&}9
zP1KU7q5@6Sl4rvGCThuZ9nYGmB`JnE~PZjza
z7?S3xLO%mT(>zt^Z(vxOPqz&)Fg#7&7-(Qbnz}K_z{oUpW3YiyY3jxh1EbT_jiCm{
zq^TRj42(@vH-;M+m!@uvFfcw%-56VgsAf)QBYpwxqf1TWVlyn!CPb2DYWS
z>sxMMN1Dp8!obcnm0_iUU1=)ADg%4cREE_C_NJ)}YYgm5QyJD8IFP2#tTS*hO`lnB
z;82GH@czS$wmBlWC@wEe1}dnOe3QIFqKkY%_2+
z%?!NVz_~Ot@D2kP(#$G54O~o9OLiH!l%|&KHgGk~tg^?zwKTKJUIW+D%qsf~+)Q(h
z+Hc@insd|v1Gm$hqYfIln`S~eWZ+(!3FWYX`)NKEam2vGG!x2E1CP>7D8~#uPBWn#
zH}Evgz1|4}&(hrMoiy+~&Ar|!125CeC8rI%N^^QTW8ig~)6-c4Z_~^r=M20{Gnbq<
z(4A&3xnST!n&$==4SY=Vtn!k9PidZ2UN-P0&2xh*2EL|wR(aLHw=_=>t{M1|=2_)+
z13%L|tGr>LGed0LG|(?YY}_)?KSONXHZUMVY}_$0C_`-A6;5Y}jeElB46$)vn4BRt
z9te{&#KuEma)#J=B>c?~8;^y*8Dis!@HazjJQdbvh>d5$+6=MrTv(eSHeLu^os?hS=y9)@F!}_Xg%Z`z-wb``
zqwqIFlzbBYW{8r{1{P$9k}tyK3={2FVRD9!^G%qXq2qivup~pr`5~On5HCN4(;4EW
z)5MAllSf|@D>KxRekN9Bs3rYPtj6RT*ZYD??QoZeml08DxZs%^7BpktViexWyS|Vrzz5oY5w>WvDM>Ozg~1
zRmPgwmEj4(I1{@w+~SNku_wbV&IA*CGu+}#G_fy3eVJrpe}?)p*~9^bp(!Q~W|%>y
znmCkU2AO8!aE2LVx``thW{?>sjw&?GG;vI!X_krO3Qe<3oXBuenq%UWLepFmrxlv!
znK+YS2AOZ-Y=#+Rfr)b&W{`y@&S&UMi%eWlxLR!DqQcb@6PFaOmYTSnVH#Ox;!1|u
zcDaeG8Rn7|Caz_eZC9GOo}v1zGI1kA^;vD=W`^ps#>AZrH-T$S+|6(kxX#4A47bGV
zP2A6LOT59vgA9|*MiUP+Ofp?29%YzhHko*wp$=^}@gzeX+G65qhB~y>#Ip?dIonJ;
z&oI+$H}N9FOtZtp%M3HkP7|*(RHR)dUT3ICyG^{wP?7eSc$?wOwAaMD4Aad%6Wtl6
zoBbxf;%kOE=a`9a8Rneh
zCcbB=QYTFO$WWzDn)sQaN}V#%*-WgRHZi1`)Akt?Lz_8mpEWV8nVaKtCWbdtkGf$>2n;6r~EzT7aW1G3fxoTouGqvfOiSfyn3&j1G~F~YshMcHWnywO(RACylxCvoj*02b)TX;8W;9cq?wOd`Obp#OF{_yv
zdSGI9Gcokg#GGbg=#h!J&BV}S6APM&oF^t0HuGfasfi`cM9wo4OPh(D=O&gl6FDzT
zEN>=qUWy7dQ*&O43N%x5UW*DeQ*+*k3N%x5-iit|)1%&r3N-V{y>3x~X6D`Zq5{p#
zyB|aanwfV$n%LeE~(vnWF|-Rg@dLo-jIzKSw5Gx>fK6=-JO{VpodOt<qLNvv8!Db5DN@#}p0*SUBEH%^7InL^CyKkcE@Y
z)SSTMTvXT?Vd0X(#z+g76*fj$xT3Hz+QLaEOa;1t>#;J-%Ph!VBteE-D;tQkIi(eMHap&yezixRpDicg>MQkOD%j?
zcv)uQhr-Kp3qKWJR#@n4;VINg3w>L73bo3@fEMQ6)fNV}Fz>FhFsOxjcddn?E!^C#
zvoNBC`?~cOMz%2JZm=-1g*kSkg()rMewT%*E$sOw3)5QI^UW5fx3K41EX-=5yKJ>E
zw}qYFW?^0nJ!QLv6)j}<4ht(=$nKpM*0ylxvCG1`7UqrJ7P?x<-#r#KwJ>GuwXm&)
z-P&hidkeG0eha%>$khWD_Oy_z2QBPvq23>|u&;%zJ#1lr3t4-_!hsel|4|DETgcyI
zg7y~j_qd?Fh5S7s$Zlb0P71PH*qKun&a_b5PYa$~sO@J2&n?vUvx40gvi6){w}q@d
zFW7A%YcB|PTgcjrg3cDI_azIrTBzQa1*a`k?<*GWv{1dTT6oYxhF-Jqu!Ri0E{JU*
zLvL7k+`>KAO~Gjk_4$?{v4z?3wji;E+3}8Gt%Zs4u3)W&Pq*C@thM}ljm(_)EqrR>
z^!Y##*1})jekcfQ;mr9+5Z1z(^Rb0~t=xP*vCzMjyQ-%a2DegopII2vO5J@f7-}WA
zUI>O-)%QOvjA~`yURfB|N{xMOVN$Ege}bV_cIK^MsFj_0XJJMwJJW4pW-B}MUeMG^
z&U_FwwX!oGEi7uK>wdDZtd)BD*~0Qx>gg8?t6S--UoEU}<-PxAVM8kw^SgzOtyIh(
zg0)sE=1&VdTj`RWHg>f#hxN6wyOlYtpN&1O%whd)>}_QZ8(?F9t2+O%aiCS5f7m$K
zs?I-b9BNhPA2yD*asxEf#<5m9=P(<`Tj`v`ZJcPObB?favX#y`(#EM)I_D@Gr(5Zq
zqivjNrE`w4ajunFeyol2t<3V{Y+Pt%`WkQJqUzQJ8<$kKCfc~%N|sHsaaHwgvW@Gl
z%<@xg+-RjbPPK7Ub#R)E+pYA=={D}P(l2M&xZ6sg6mO_gl%q*)|@kuFkRX
zsFgZ7*T&OUs^dHxFIuUI^KHCrr6w-0@v4=YxX{LH)!#)n-l+aAw(+)=%v)mPT`Lp(
zQXAc^bkk)v-nY_Cm)rQDy1&B4=T>^?N*jH%Oy;X>^vg1tueLEDOVwLrV_=pi7i(<{
z$}0V{F*wVUi}f~!WT}K3Yz)m(2{+mpo+S>tY>dbf2b*k+%n}EiZH&rNC%4!bon
        W@MSA4%(QRWtKW*V^)@Gd)UU@EECib8}qVEP)BXd&oV(B
zv#}scCLg!4FiR$%u(2ph1wLtGah3{v%ErVn2wfL-!6_
zSt|NR;cAwO{>jFzEEWB;ur^CY|01l-a-aBBSexZO@td$V%U@*sF09S+7ukLYSF`*@
zwx2d0XSq-8bnqlgmGA4|X_mUt&%twrlKu`}D3lCv@KT{fn8r9x%+ohb(ntxPwm$8zUTiR@fNn;ETe>C5?Il9YI
z2Xk_Cmt_v-=IAcV9n8ydi@3tU{2YB|rGo`Is>&({3v*PJ)eaWrs48n5EY49?);d^{
zqpGZPurx9jwk#U$!_{lcT0eL3#nK#o(}2?vLBobpdPIFjR(f6Bqp9QEb2gX1}R&lv|Na!ej)9h}TDd7N`_
zHpk>~-ocd|736}0t2rvjMF-b%RFF#!uIHHgE<3o9qn2E8a5G0Ox$59nj#_ff!R;Jp
z_UjJrwIqJ(p2hVcUmq)_*9QEa~Fg{0pc_NI@QD2@4<8#!PXTta#_2s#P
zH#zFd3t@bYzbN}s7@woQyb{Les4uS_e9ZB@;*D@W$McG}!u=e7@$sE-KgVBu>=y3l
z_=~ddh5I@FqU;9;-*fy$*^dr>)^dL_^`XYLeryqS4J;>9KzKI^>
z=||rk49e4mehByT^q!v%hUKX*oi2vwd0x@i#fUu5EBd(@nWxh9cQGnYr5WI2be>8x
z(8ZWMm1dBOv3V-ZU>D=^Jg*qyVtk&OGt|X|JT+&Si-~z^&Tto#@;td1;bL;0&nu5~
zF(ps+8RcSXp6WB&#k4%tXN-&Kd8*G?7c=sl>BhO3nP<8g?_yS->1Kk9*?Fd$i7w{l
zsXmij%+FJOCc9XWr}|8Bu`tgwjHxab<*7r{TrAI1bEdmkpXVGu!^MU?r@NUhHs(3e
z&vMa~=bSg&#il&xyg4p5=eawa>taiuyTf@dw&uBsp6_B?p6PXgi|u))*M%;24l9(bb#X+YWSxtn3MK1Z98)OS;Nql0$wn8a^2{n-E>0`FY;ti%
z;bpUnvw3FQEiTUG=}cQ)oX<1cZgX)V&(yNr#l<{R%MKTp@=Pr|U0lvH+wO94CC_ZT
z+r`y9^<|HXYkBI+UKiK%)R%oOZseJA_q({6=gfJ)#jQM(%t04-^UN=YT-?iZ+Bxjv
zexB3L5f=~goOX`7c$nvY=$MN~dG3dfyLg=E$><3ePx9OpopkXu&pGszi)VRen$s?x
z=b35FxOkCgra9~4Wu9lG=UlwXGu@nb@jB0RbHT-%Jk!lZ7jN@SHZ
zcOG6eGwf{_
zKk}Sh@3{Dx=V|F(7o9rY>Yj_fI^F8Ni+(!Y>VbS{3v~;-b#9&C3%hmt(Fb9-PCxo6?AF!%>tc@1y!+Y3T%CFMi!fei-u)_!
z*O_;}3FCEcoxcm?b$ZkfVZ6?*^G_E`b?%xwJuK5XGxhbbTxYuJ=V67;bkpC%N}cIu
zfQMB&)6GB+t971c4Dzr>=V``Z4{LQ!(L+3}(>Xm2^{`&&^fb)F2A$K>a1R@GPER8|
zbm^R)Mtaz!b9x%(VYANZX|#teI;W>G9=7V7p2m9Ep;M8@dDy8_k;Z%2rBjh6c-XB|
zktTZBt25n9@~}^5x|!@@zs__s#lu0JIyBY8A)Puj&BIZh>NDNLF`eo&!^3f%>NC^B
z35Azg9!~01pV=Nx=~SON9!~32pSd2+=v1G19?t4ipZOln>GY@t9xm#1riC6Z>2#(=
z9xm&gloorqqSK?6c(|_9qn3KOq0^(5dAO-lbC!F!rBicOc(|=ob5?q|qf>KMdAO@n
zb5?tJpi^nqczCE&Y1Vppq*H0ud3dT*U)Fngrc+-wczCW;Up9JprE@;&^6*-xzHIXF
zMyI}P_V8AxzHIUEPN%+X_0X+TU$%Mpu2VO*d-$PKH+FdFYcS>R^w7^>%H8Fmzd^^@
z?O}kyl)J~nK!YiFuZNKa`@7G>D1-go?_spT{vPl!#-QUI^f1<-;~erZ&YJpYt%wV9(Ecm~F7<7d*@{*z=1X<{Hc;mpsff*!{~M<{Rw(6%PvxcK@n}
zg$BES&BG#t-gDiT!cc>bb59s*
z5C`{#p$2jAKp1Ke2M>jz1|8>-Fw`I-9t%SaBI1cK)F2|B3PTM#&NE@CL2Nu1h8o1i
z3t^~1Y`pZa%^)^jdDw0c8?S}62C?x*SZmOG-U@3Cde1vytwHbU_OQpG_q-SW8pO~C
z;jcjqeH8v0^qx;14jA;F&mImNbeu09ju>>Dufk-5j`K~JY|wGO3zH2x&JSU-LC5(i
zOg88^ojy((oRs?dIBjrJ>gVH(!AYsVkFy4~WPp!z2DN0MkMjn#WRQ;w1}CM#J}w%Z
zl!o}YWYBwt`nYV+dxrVAV$ger`?zXwQX1jon!!nFq>t+cH!-7p+%PyZjrMWV;LJ3}
z$1Q_1(^wz34Z77hA9oD8)p#HG4SLiB9}f(A)I=W-4SLihACC-r)MOuz4SLiRA5RQ=
z)Kni&4SLixAI}VW)N~)u4SLiJA1@4g)Jz{Q4SLipAFm90)NCKG4SLiZA8!nL)Lb8L
z4SLi(AMXu1(|jKv3_8;SAD<2S(Lx{J47$)FAKwk0eJ=LVY0`z3_~>iWg_ip0XVQh1
z`RH%bg_ipmVA6$F_!wx?g;x3)WYUFJ`50`{g;x6*V$y}y_!w%^h1U8QX3~Y$`511}
zh1UBRVbX;*_!w!@g*N&aWzvPZe2g~fLYsVyG3i2^eT+4kkhl04XR7lLALC8x)ixg!
zOzPEk9}`XL)eaw%OzPE6ACpb$)h-`XOzPEcA5%^0)gB+yOzPEMAJa|h)jl6HOzPEs
zA2Utr)d3%~OzPD^AG1yB)gd2qOzPEPA9GFW)e#@_OzPE9AM;J>)iECnOzPEf9}7+D
z)d?SqOzPE1AB#=u)hQp#OsdprAInXu)EOTuOsdpbA1h6&)HxrkOsdp*AFEBe)de4G
zOzPD|A8SqO)g>S6OzPETAL~u()fFEbOzPED9~({T)ioboCiUvNk4+}^>V}WaCiUv3
zk1Zzk>XwhKCiUvJk8LLP>W+`?CiUvBj~yoU>Yk6CCiUvRk6kA9>Vc2lCiUu}k3A;!
z>XDDVCiUvEk9{Wf>WPp2CiUv6j{_$4>Y0y&CiUvMk3%N)>V=QPrrQ7cIAW^(pO2%a
z+W+}DW>T--_&9DdE5G$|!lZJ&^KsIoa&?OinN+U#qC+N?>x1Z!N#*(|nqyM0K8e1V
z%*CHYOH8KWFQO$T)9_c(4U=j3o9KqgH2ht3!{j@ce~50FeCP5{A9qc@bGb9XJ(G&m
zH^6<9iqtQ_1Cxr>KfptiiZmd=Ba@0WFu-GziZm#|6O)QGIKWd=?f(KiGu8etz;jdW
z{{p-))&4KQOOx6(BETz?+B7o2Ym?eED!?0)+B7=ATa(%}CcrzB+B7ymw@Gap7vQ}~
zZ5kiogGp_g5a6RpZJHS1lSyrw6yU2#MVcJoo5|EXCBS!++B7x550lz7Ex=Ecsd;*U
zPK!Ii83FoQd>UwGfPNOA2AUP1zs0A4W(OEx@yuaPfPog3Yi@u+7L{vWfWa1(Ykq(s
z7L{v3fT0$ZYhi$47L{vJfZ-OEYjJ=P7L{vBfYBE9YH5IR7FB9lfbkYpYI%SO7FB9R
zfQc4WYGr^)7FB9hfXNnBYIT4q7FB9ZfTQI1n7FFtSfQ=Tl=}3Ssi`sNFz$S~@bS%JTi`sNNz!rh)pz$Hta{|2~fQ9-T;xM5K@ZUne(Q7vu?S1oG9E#aj_WwMq42}v`_>-`7c4$E{8&(I^WHxZ
z6x+P_PX)y`@BK5uu1zLC7wp<(@(aPPO(wq-?AmJn4KT)5^KXE$wwiwh#WwHwTS2kS
zJN`~kY|{<81-mv``(ChXGf{jH?Aqk-N5QU5{(cg~+PveR1+g|g;7fqnHnYXo0CQ~4
zy59u5HdDrTL9ER#{1C+2RQ{iWSeyOm46(@OF0F5f#Wr_o{X#6Y$<_WLmf7U$fDp@V
za&=&c6*jp#D8x#eDPwSmH8!)wkPvHavUX^Qbv9W$EW`$zGtTf38*R=wBSLi9+~ki8
zvB~Bpe^iJqHn}=F#8#VJ9TQ@kO|Fg&vE3$D$A#EoldI!H?6k?%2_bgbOcWDC?6H|j
zCxzH&ldF?M?6=9)DIpHn(k+z_V~O6G+)t57mO#5skM1tHEWlq?K!!KU6X3UN{4WpRj03NK4S
zTvm8l8sdsgy`h<`6GzCWS2_UfN{x))233
zCWUPw-q_sfZx7LJbCbU##Cw~Y{GA~_*xcmr3h~kACVzK`Pc}FCdqRA+xyj!f;)~5q
z{=N|3ZSL>)hxlQ0e}5pvPn-MugCRN{;^k0?z7FwnI7B~(csUZHzeBtn4KdK+6mu-Z
zAcs@T@eqR@PBAA!3~`8;lOcvXoLx?Z7~ybsIUQo8!`bCbh*1uc!r2g`9VUfyA;vgN
z3g<(Nb(j<`gqYwkA6yJE!=X}N3Nh26QeO@+%b`+V2{G59QeO=*&!JLZ3o+lJQeO|T
zz@bv#5QaK*`#1e;Ye_I&pP^s?-LmlGaZirP5yMIsE=uji>hgk1WBOVAF
z9csiwVWUHhcqANjs1c7tY<8#-PlSyQHR7qT(P7V@2^$^u{JF5vVb5O(8y)KS%MiOA
z>i8>Ro5Mmf~+cfuZrI^Hduaj4_(g&z)e{DW}8p^kqPE;vkh
zpF&)9sOX=C6%MoB7vX}#bC<6nZaO@7`4-}q!*iGK!Vib%EsP=-)xrJ+JaL%o1{CnzVVWCQzzc^SFsOi+4n1IS0k0f-z>or7J7o9J
z0^T@ugJA`{b?64e3wYkJF0*Ws=uQP_^A3jrhrclePL_?pB?(b
zxB|X7^o8*Se0Asx6AJj|FxO2i;Jd?IH>rRh4s+e)0)DFQPbr|&Wv-iAKwp=+Zdw8T
zT;{sz1@w2B>t+-%$Yq+FS-@bIX>L{lLtLi0*#!)B=@4@Y80OL;<`yvAr9;dsV1!GD
zm|wt1mkzO@fKe`U-NFJ!yYz}h1&nd&6^jcP>(VQh6fn+Z!dqIvM3=d4Spkz==DOtt
zOm>;;RunMBCHGerFx4gZR~0bLCHGesFx@5h*Ay_rrB|#iV5Up2SXaO-mtL{HfY~k+
z-i89^xJ-B(3z+NDHM$Cz=h8Jc6)@kWYiurHfy;!qrGSMl{bOqZi(LB0wgMKr^pEWY
zEOF@{I|^9p(m!??&Zn%apOZfE6xN#-0LJyHtz41*~(a5&H_*>Jl&e3)too
zF9!N0dN@?TE|+d_xPaX*_25VWdtBp^*vv}DVJxx7YaD-
z@~rn_0cTvE^_GT);V(XT4VnIPcOSt`=~~r7v77;Id0!xL&{&m%ebLfU7Qj
z;bsBXT>8ST0iNF{9=SZjeNeztmnXLm
zg~={YZXXGMUCxM)g}*M-;S=Gn%Ng;hu-2t+JQJ?E)Q#uDRhMtFdm&tP`6j!U!cdo|
zw6BDhE`NjPweZsATczFzFI~P>>aDQRqH=
zJo2dbpM*yq_29Gc$fF*75gvKegRjCKkIMh8fC(P^`(1eCvA;irM;`n8Q<&m$FVGob
zy2q2&z7b}4JZbG0VW!8E*8UM@d*uFr2y;E2uMUi`z~lMqpa=^+p05s$u*l>2>W~PF
zJ)W-)jj-G!yN5+s;gQ|LBdqku?hz4Id7R%yMp*5U=c6L5@yPSh5!QO-`IrdnJo0>O
zg!LYIJ}$xrk31hAVWUT$Pl&M9Q~58#HjkX16k)qZPEU@o!y~7sMA+$((^Dht^2q6F
z5q5jz^z;aOJaT$QguNa)Ju|{SkDQ(rVZTRC&yH}!BY)>aIO>tVb0Zw{I3>)BaNHx4
z=SMi<(f1cbIH@|lFv2O1d!$7XPOF|Tj&Mfxd`X0}s^?21ob#9fmPNSik>|@JT=B^B
z6%np_u
zjS(Jr%mQ5z9(v3In<6~&m<2XRcKqd@Y+-P
zFTxv7<-Z7TJ(d3=yz^B4i_q<<{1@T9r}AHf4<32GKf+g!sqa99ZywowFv53_Pi-8E
z@WUg|4@dav@u`g?5juS;|IrA2eJcO42>pDbM~Pn4XBFw7?+
zPDdE-6A@=3jPQwwvk^x6M8vrWqkJObe1y?HRsKSRF+NrPVuZ0iQF1B5IG-rF9AUgq
zlw650!6!JugRBFyuNlKTwfgrPpu;cH>2&vf`ELYL3o;oAtCeCEV=!cd=k
z!fs)x&z$&P80vFR_(2%zGckS?hWgwSeiDZI%#NRhp+5J7UxcAPQ{-1+sLvCQZxIgo
z%#+`Rp+3*ge+WZ;=E3>L!D?U@?&=^;J&H=+>T=Tgn93JDk&pbII#tol)!jUm<
z`b?IiV%+kXEJw$?5esAdRESsjHNFP>c-$_26)fu7ES*krpq~GWaX3)V|HU{GsOSG;91Ya-e=&{)>iIumUO=z7Cd>=y71xD%
z0lngeFfX82+!VeAREAqI&IeS6+c7Q#RE9e-E(TPFyTZnRN${R_!13=Q}@kDWz)S9s}L#1Dm+entFLcx2LPAy_)NZpuL#O#o{b9xbTLgvmHMa&JEJ7*R#KcrgBDq=y%6Y|+b
zEDD(|<`l6wWVV=F#FCKNVqOtTLuQNlMJx}g8w-k99Wre$EMiT_Y_X__wIQ>`;v&|E
z+#@Y1Vnax^SX#u!kZQ54h^~-Mvb=~*A)RDJ5nDngij_rd4XGuoir5xXOI8=LBcy+<
zDPm_x|5#hZu8^CFbw%tBsU_=+*b`DqHWaZxqX;rTC%-}lOgAi9YvfDsUUuzlf_L734q>*Fq}D!6L4QRFFeO+zgp04i|AZq;4E3
z;$BGII9kO0kQwt>5f4M^#_=K^h187`MLZ6v8z+l+5;9SoD&lF#L~*)^=ONSPnIc|<
zOq*wmco{Nno-5*YNZmMJ#G8=W;zAK`LuQMMMZ62StGZM~cgS7Uf
zUM=EtNCml8#Fvl?a=nPJAr<6C5#K^8$W7sDNCmkiTn(upw}q=A737X^wLom#6|NST
zGVTdi3rrdJg{uXoj0eKi0#nArA_f+Sl1IYT0Xt?
zo#c5DlMC$r3*lCQJ%1^TDsa+#B|Ivy)31d`1$O#P5%UV{^jl$6fv)jR7*(KabQiI(
zK-YLL+$yl=AB0;4_WYx8tH7RrDq>lIDe|*$tH7RrDPl!|C(vJuSXE&6zX{(8?EZJ*
zTY=sGA$%)v!uVOlx&kMR&IIcVoJ0F2=qgYJ`X$&@pbGR)u(?1L7?5B~fz#)}1X~N7
zJ_jY(R^aqGIKhqrbHtDYI}6MaLlf*OFh>kau)Dw-~n6qp`H
zB{*DQW*D8|NP&7VCc)7H^0w%e>#Eb!6Wl0}`!f>UR6U=W;8uY-Vpf8?1#TQ>CwNdG
zVJ$!ApgM#R*<194txjTH#=6
zf;S2W%M!d*I9Q(Gox;J21lOxUoe>eSDM7!8DROgy{t;8;mIMPL`oh)(gCgQ!
zTY{kx-C%oyVG-S6M}pxI-C$>e5fLZNT?s};oHTbQ7!`3Ju_wXkhz_wg!I+2+u`j{c
zhz_wo!MKRi=Ya&{BTk6QzJUW(FD^XI>fOA(<3^>
z@dPs>rp*%xW=2e#Clkzym^M!(m>qErJ)K}~L_Ii@U}?np@@#@-5#8Wig5?q2;CzA=
z5$DSb306j&D=sEj6>-wMlwftlN%L}oH4!uBl?3Y|qU36VjS)5Cns6|pMqC#TM%0KK
z!oi3daZ@-LQ6p{%2P104ZQ)=u_5QPPFk)i-A{>mE7{4ZX6frS=OYk^iV*D<=jF=dI2rnZh#-GB=h>5YYgy#{J
zzi$aIBW@h}mGCCwo}qsUZzIkX14?)oanCTYgl>g{K_$FbI2c^Q_lO=aq=X+4eSc^P
zKO?%quo60BX2Rhm^o^MbN0iVnW+oh2LjRbVa8wBcVrIh8B@B$23CEN$C}t)cTf*R&
znQ&YQLt>soj4xqm%yc-Rgkdq$;lvV#$4rNlN*EFI9Aa__BV(RJOetYh%yWpTC5(=l
z6Q`9hCT32YUc$JT^W}^Z#>bp5XO=J_W=@<{!o-;Kr$8?CrCCrKG5KBs!8`B|{mM|}-Lo6#{
ze#}X8c?k<*dc}$o7RH=3SC+6SrfaM!VR1~?SY5)Bn69y=gyk{4Vr>blVy1$1C9I8^
z1=g3aE@l?kP{R6{Szu!c8)EuLR|y+qVq;SYT`~P*a|xSb>cN&0HpldjttD)UnH08_
zur;QCY%gI)OxM^^!tR)^v9p9dF*C!i686UQkKHBgi;0{)CG3xhoV_I+h>4tiB^->Y
z5&KIx6f;pADB*BSwK!P9k(g?6sDz_2)#7joCt_;EkrGbE)QF=coQbIn$4a;rbAmix
z!tIzz@I(oBVkW_pCESgf1W%Q4FJ=-vUBdmCN$^Yw4`R-eXG?e-bAmiq!jqU2grC{k<=IE3&^2gj+>+^`Y>n
z$X-4Y9u?Wk$HJo`d-+6oRAeuo3Xh5^{|S$Z?CNvjQISdTh484z{=O6*71`fcC5$by
zzpsToMRxU#Fr~;|z7?hv*~@n&Of9mP-6c#bvX}3LJw^8NgRrMa<^L$`DYC1dggr%e
z^|P?2Nag<`>?yLpUxg_}W`S=dEGw$~Ck!a6{8z$?qRM|ItSqYhSH`NM%7107F7h0r
zUm5F)D*u(SzNqqF85@c!|CO<+NVgwU#^xfYz`?zXYN0hO*NRJ;`#=aswepDF;i*)wUWgIDTn>?nB<3;-U*fLHP>Eh$cI9sH5
zk1yjwk&Zo~jO#^e_QW!76sg&h%D7piW=}5TR*~L4rHtD}diT^a?iA_W)5^G8q<2p*
z<6e>8J)?~KMSAzlG9Ic9&MMr|R4CGWsR#)`~I)Cd_6l
z%NUZdN2|&hny^Q!%NUceA8X1On=ps1En{55&a5kAe8SGGFJnT&&TJ@SV!|A@v5ZLx
zd(>6NfZDq_z*thLv%uJZbc9bzIVF!1X
zF*{)*+f~M#MD72|n475mUm5cfwf`$)exmk&Wh_Y4{;!OM2@~0YG8QHD>4Rk~PIxkK
zsEj2EyMMThr3t%#q>N<=yMMHd2yMMfll?l6lLKu*+`zM6~3A=x)j5P_n
zf4Ypd36t9yVMW5^c2-!CaH2matVp;WJYUAfgxkRjWppJxH@GOQNI2175>_NUBe-0~
zu7oE8SA+oxQ`*%s4kXNG*MtFydj7ABLkUj?Zj^C2;mN?wGL9zX@2xV9CFJjI;YY&U
zey5BR33L11GEOFH|0kSDnC9-6aXR4~|DcRB33J^;;Zed|_o$3>33J`!GR`N=bx(v_
z2{(aH%ea_u6Zou*O9?lD&&#-+@a*_S8CMcMee$x5s|lYzc~!=>gioKm7G5TN`s9u9
zGT|xmTj6EGZ~eX#UMBq3Z@2I=;kSO@3ojFX>-U53GU0jhN8x3{Z~cA}UMBoyw9jQc
zNchWWUxc9v-(mVy7@F{8`I|5_;X6#f3qupW!}LcP&lA46^k*3_627^#vx1ijIeja5
zrI6FFg4YT;{VRB*kTalyw+cA}D|n}nGpK@Yg`B|^yjRE>Qo#p>oS_wbRLB`t!6${B
z;T3#V$Qe<=7loXW6?|358CAhIg`Ck9d{21dG^TUc#+NuF
zE~sEaiJ5R=1(Qomf{QAcQeqNZT*1^5li-pHrj?ikmsT*dr1D<{b4pBo%PW{)V%A$x
z!J?8Ryx*x=S@}o*V`uF@`aO}h->F$u(SEP9R{MSV=Nf8OSG2s4q@iX_Mbm{N4K-^k
zTF;~P4K?d3TF(;_4K?d4S|Ai?sM%1_dQwY6&BlsW7Kk_0bXBx=!S(OfY^rE~@N4b#
zFY+%wBY)W|e{XX|`y;_^L(P_o_J0U$8)~*zv_BTCHq>mZXn!UEZK&B^(f(ZKj^C}>
zQPKYIUu$Q3{`qtAm-+Jdc2=~1Bb(@knq3v`ujR+D8ftb|w7>cFUrDj2qW!I`oEvKP
zRz}?j#sqKS`HN_D%!+aE{0E5v`MvG
z44VxQ?dEJnTUg8XovUbzYT3T?6>V`X+jpU&EvaSuE>^Uq
zwG8r?Dq2@9!}#TjwyBmYoGTS=b1h@})rz*ImTS9f6>V!R1N!xfwylAclRsWzFNk+2Ni99
zE#uw8iguuu@$OMYJ6Owj_qd|ns%7+gQqgYLGI~9&Xm@HEy`ELHyS0p7&nw!!T1KxI
z743B`W7f-x_NJCG>s3X2TT7XKUD4jvQl{TjwC-BU^jo?2btJ;Oiq^M|!%=rd>sQBn
z`o5y|uj4)aP|*g|@t%IHXannbPd`<(L3O;RpDWtnI+Ei{MH^Db;pl5c8(K%2e5+`~
z>Np&IuV};TNSGfLZA2Z1qn{ORWF7m_*`|%EW1#Narj4#+pzhbEjj3ax?%$>@spD%9
z2DE8Q>-ZXkfol;YXXcwN4#=v}xPw)Zs^)w!Kareza*j>eS&!o3^u#gYMWiZC4!!-EnQ&?m7;-
z+BX;MsX>aO?-MMYr+d5)*
zUYqu=j@X^wrghg5y9?U1_jSbX!Zz(g9kIKpO&e6td%Czy8(hzOx};4TQqNaQEN#<<
z*7Ma8%i6SI^?bF&@-}U9Jzo#8qD`Ap&xe*)wrNxA`Owm;Hf>rxA6i=7rcJL`FTZNj
zX4I>fU$tp7>($Gz+O%2q>g88$+U$BBKW}K$=G4uD5SZQ8tg8pWnIZGJtC
zVso3epq@strA=E{Povn{rY)+cQEY3|7T41#woA9_88CN9x9S-%cS^VF88CNAx9S-%
zcT2bG88G*>X{YLWC-+J}>Uk&kNk8g&C-=8$XX|+<4@hU~c_$CHY3J*CCl9r07wV}3
zhugG^^;Cf)ZQ6r+j%P>Pw1@Q^&yKZekLo#|9dFYf*K<5O(WX7A=lFe6`c}`_c1rqI
zPxC!3eXD1HJ0pFor}>_3(>~TS%AIS|KGpMakMnKXmwFCh7uvM1^^EivrGvllzFcb4
z#{EKLyeyshg*?9^ck&nV_iCHA@)z>*ny}{=rGIk&ev$tp)ZA#(PKafUmGY+C7%4|e
zc}tZeq`a-l;Zoj_`z03)mGZ7Che&x(?wx!(NXq-F94O@jxsUQ`e<>fTvY(WX
zol-tl<$sm(i7Nk#luz5VOLD<~l=7J>|3S*
ztMad4;v%DdR3r2NpP-H=cJA1Obo@?T2%
zsZF~rpZ;?xKdbVeN%=*U|Cf|sRr%*qepBWDDdqPz?T-9ozm@WbD*sH%pKaP*`Seeu
z>}+RwS<1fc+CBO7qLlqqc|pqlsyr{{fOhS^TyR#(fvP+sXyyY^Z>T_@#K
zRj!qCnkv^wIbD^jrJSM4RZ`Au*WSoKwnEBTs$4GRY*j9ka!$MURxVf~1(ol1|y;md;k2KWWY3~&?vEOa)Rg_0Z8fxyf_e$iqY#VCsxA!W^PuVuqJZSG#
zW|)82-mAhe|ERrJ8^iqL_FnA_^H17)b;$dn8fu=l_xg>z9;%_{S$nTPkheoM)I4wR
z^}ox@p&DvlwDtI@@AW60wQr?*)86Y(J8NG{
z^_JBusot@ADOGoSuRrUoeJ<5|R?npR!0M?~AKQEVwzKxJRG(NqlIk<7hjQD$w5O!c
zso$54R71_z_LR;)`M36z!7=1}d&=hY@uNNE@(=v8J=ODoOG8a(HB}UwY^dp5O;scz
zH`Mg2rmA9y4K@9%sXySqa6mQnhqB>ns2NyI{gEW*hMGau)SqxZ8(dBORu&fxHAAYY
zeg&k{B>%hAUV|~f9XNSh-&KZxLFukO%1N)
z{6DIi8d=LrN$d;V0asnwK>J%23Kv}$TuEo0d9
zYHDLGL)DCGN(Pod{_f0bN(L5Bs#(>Pj48HMv#Y6NwG5kcs;T3(91Z4HQzvV=S)Er+
zU9M$Nm|sm@sb$b#P)%K}Wzb((OVq1EmRD0B)hM*0n)+PJP1(w7O2&_WC4Z__)s&1M|5B>e)s&1M|3a!Y)s&1M
z|6HoI)sze!e=gNJxkDLtKDy;9Xrq0)Kt9YQAx=_ch;=yX_VjZ`N
zhpMSdb=)c*mU~~vt>O{6_jTMV9<8RX)p1xnCil6HoBiW*pX<06K2c3Qt>cdWq}=g3
z?)XntQ_t(T<3C+Zy{O}k|4cO{W5reZQ=P4*WURO>)wya)#)^wlov)^3tT->#g=$L1
zinCH(tfpkFI4#wsYO1@A5%Y32C1b^L`Rs~xwT}DatJ2jvp8Q{{raskilYCwJTgM^w
zMm6=Njzj9rYU*p9+9g&~-|EyZv6}i`r*?_e)Q>u~ORT1T)~Q`$HPuY58W&y*r`5RdMmSwh+`ko0*R%WYgvs?BYr6%L^&HUN
zS5s^1x%vH2O|7lx=J%r@te%_SPlB*|Zhk)t!s@yC{ZdVJse$0DaJ8O&`&LcK5OZDr
zRNsZQ_3Yb^YD$Kfp1%DQ{MEB>ogJzD^&DLLcBBr}b8zj~kvdqQFrg*8v@=
z!}T0o2X>^6)N^nh)R8(`uf9v%kvdk-!F5PS>Ucc|*P$J$6ZPu5Bps=f_3FDM9Vr=^
zT=^4>=t#-P)T1RMJ5n+-nNp4FNXf|5_}ZveVf#gx~lp%xg&K=^=(Q=>bmON)Q;2*)wgLKshg^A
z(>qePRNrQFq;9Le&Fo0sQGJ`$k-Dq;HoGHrub!-((~-JgPu9-uNXhut!`gWrDH-4X
zd#UDkq-1FO@1$DLk$PUwGlPX4sUg2muNHNrWZde}tHm9u;lJ>0i%U9E6Mvy9FYQQ8
z`h{zTWgV$0zi>ES-jSO33-A4kj@0~Lc<)zsq!#`nqpqaCj?_AFm!4R^T9xOdT+>10
zIVI&hos!3%APF0xg)hzF4!yO
z7FF(%a;qwLOS!EhwM{PQ$@1G(*^}jWsB*iMJ3CT4<$}#p?owq>fZwgko&dk6BehE|
z*dXOzRj!wEUq@=MeA<)R_p7oewIAq6?UPS?Qu{&mX-|1b;4PmnmGZDEds6!mRraLz
zqk?+5peL#yQ{@6Fj|&6j)1Ih)LVem(o)k97r#(^qlq!3o`e|W-eA*Mr&!}>$lxKwz
z@@Y>fKc~t`Ql1xf$frG_{DLZbLit5ij+63|kVY=(3FVhn*%QjIsB)B)SA|P*K~E^Z
zrplgBeqEKrq`aZZo{9RVuuZP*iR!mh*%Q@otFkAm-w_hZ1w9k>T~+o(^?R!9E1~Ls
zM{fyLy?rVMlLMBFXR6JnHCe{kr!b_53FqY94p=cH~v04K+_XddJL<
zPdj=SnZllR^iBlvzf<$PqqnTW|7mCKznAM?bo8z;L%!_j{ZF{;ebv$X4+Z-THLp8*
z|B>v~8fxBj^!}%!Newk`J9_`A2+{A>yzA)w+h6ydT`PaAIr5hi^7pzsdjBgCm4=%4
z9lifTG^L^DLr3p_Et1ku^Rc7%zY#@gsQJ{<`~MX|X{h0e101_5|)BA7b2uZ@?
zZ+icoY}zF({-*bTkOL$Mi@)jp_i}#JP&42+z5n6=XX(Ae+q$lFZ-51y`#E<$&v$QT
zd;syB10GnQacAa!lgv%C{=xHmHWoqh?6%&u*4{w+2+pGWjX%T3gR|&<<1a`aSxf`nZ~T?@
zz##Vf`)d#F%AFiSAZkj{NMir
zaHL=naFm-LMNqT>TDL-130X`t-O6`R#bGhkxs|t3#9=YjyOno1+0o!uzKaqLi)ofyc^4HN-!;v4
zD>&5El#k!Al3tqWWfi@wrk6GJ(n2q5>17wabkWOUy!65c&2cL~L7|t$G}o`xStKG`)c)qN0EC0o+rNyoMo|7kQ-O3+%e^}>MFeF0QGuFG6erDbkHn^4k
zW)7LQx|IQD4w-IrD^L|~*lltvgUlQ<-RxEdi+8`ptqd`9$aJe)8EWQ`={C1A%*-Lv
z?QR7+#K!>~o+U-`LL%svr<5r+Uz6EM?E6^d|0PS@v
z&>^I&+uh1|Gw0U!xfLi9Qq%k0%0$r(2i(deGp7_f+{$E0(;RdwQzT8(=~kwh+2cCo
zR+gA~f9-NBNQgYeryO=GNQgWJ9dRq$%`9$;E6_04@w2Dg3N#Ff&C_nB&CEIUGj0WHh9u@$x6*Fr9Qrx8vd_#p^lrDZ-^@Am
z^KRvUnRDnD+)9U;gRvLg%0V*+V=uXtPBRB%FT0gPW)8+)aVuSB4#r+}E6_*0ozxDx;Z}~BIoE#Etw1sDM%yj7a?;G6@@=7xbH4nMTe)ZEeEDOya^KAP@+WQuYHKz=
z<*8eN+G+qjb1RR`oG*XwR-n6T(e}cvJTY^={H0rYYUX@-FOTv}v|VqH^4!cmZXb{G
z!py!>Uyt(A%)U}TkAj5KD11tPkAj5K2+#nJf`rmA&_Is@MK=UA$fH2f4FV1JC{T0*
zKtntV6kR{iP>+IyQXkMTj{g_UU1^PFipJWsIH=iR9E78CC9C>I)|K_ug
zy9)iA&pz&Ij{?O+>(v^MGD`GCi${SbqG!6+qabGaqbx=%xvJX)$yMF%QI?>U!p=K9
z%2FW3ns<7X<-jK3E|0PTNKWZ)j0qqGnD+=$fVoYOT-Ci8Dlk|CY!@W|bRUKdS}Cf$
zUyxkY10LSk$Up56oDDqa;hm2B(@sH(DjyOg|Fp})yI?KwupqgrM+C`LJ?h~davJcM
zAVrmr3z7qS!o#~KMU_tqk^_56kQ~_47~J@K$yGgr(G4V5^(=-rko?ngf)qdQ79>~o
zJVreX$UnUxNdDTH(7{HH7jIoAg@0#u3rsUh5Coi5uaye!x!LNU!xncH%~Ptv|&6
z^O|Y2*ZPre9SnDnT%a*t>yOxz8|$@tIT||7YxQ9Rdd)Q6Yc12QBVqU@3@3Q4e(XUO
z(?qW|#$MPYuQkqI*krFY!Cu%DuQdrT>^0L=ueCzA4#SUrj-Qz3wN|kQHr;DYvj;ZA
zYt66+R^zp1*#oQfTC1_Gz{m7jf5mQAo!9znj-1zftzRH={+g-5YyFLG9fME(1ctM`
z*59(cneDay1tkRV7`@iNBHR6%X|C7$H{E&$&+;0Y=XtGP@*XnZYlYvH!CJJyYlYuc
z1zPCEqu}uOA}{`6PIxc&;=ktIWQiBQ4tvNynU;F3@Q$q1KUQ*6a{Kw4{W2?
z3J;88UYoquWfI}t?6o#Zgm;VAx?Cc>TfJ6zR{5~o=C#7JGK02zt?;a9U)kZc!n2}%
zWvAB)&x-uGU0y3ZEAr!Zd#&)S9)k9Gt?;bwgW9}Scvg2od%ae8Ry1Z8S
zI$J@9y;k@-n?XmsR`@y_K}Wq-_&OUv$GlefFsnhwy;k@zUk&c=t5MffU7@@mf*D;y~M3uN6fsC7^Q{8&VY0jS(Tc`+2W*yzK55yjJ)t{|vi}
zUh7mT;JDIDCRWik=Kf%n3JH#UMq@XC&ztv){MZt=GI`mFo%SeNwkSy2i@x}?9)3Xh3;
zW`NInJda2FK%W(!kP~f#d{%fuZ-NHcqdz7HDVvm$Ove#l6l6>-z=f=2nQh?~BR<#e>q+JUJ|(X%mvJAq^I*PwMPaGW5y
zB;y6iC7Iyk6@XlliGt*kO!8StxsppVS&&?kDS{L|o9eS3g8@a)rU^C!rwgtG&cHtp
z1B#y22$G{x>$9FfD>*7N1<6sV6C_8a-e)}t19DUv1j$jE<+GkbD>*8&1<6sFBSwsyU@UN@Ao(oKf|UMVB{&Lu-)f%?d!J3iqJ)}ApY59*
z*J<(DzQu8!wLaV19L`ziv%Skvob^82dmOyk;In)JR>le1%|2U{BV=2AwhRmXtv*|ph5k05EyqHCyU$k5dCDC=+iy4)w$o?(
zEnH;OMEY#M38+I6qc^~uHu*3X!&~cv)JIrgK6FwVunEwVk>9ehs_5GC3hT=$C
z-%tB&$TiaXe#U3pVdm1NvpyRXJFP6|d^RZdZcw++hSmQF=)BK{)xQgL!Dqwj-wC?t
zv!VQP7wD4Dc1Be4WuNV=ne$0ke718^^mx^0yJqG*(KVm#x|#Dt*L}7dX0AEE;j`T|
zbItippY4@~zU8yM($KekwpSYZj?eZ=L*Mn;UTNriKHDn|ecxxpzCs%MfzS3zLqGJ{
zUTNq@KHDn|{n%%Na-I&mCq5hW@)XchpKX-rvu8frXwhfSeKu%W+DBjbY|yf_kG}NT
zuwT$V+N;cl{o>D{-eorI7k>oxDYIdh_yW|o%!Xa!SD=1nHtZ6gf%=!(uuJ>`G@#6e
zU4pWw1IujC!PTHaWj5$w%AO7`v(<}A9#Up&5S2W%%!b{h0`Cqhvtc($fQFaZu$#m{
zBg$;pO(LL?Wj5?4VbG{D+baz{y3Dpn@~vaaZ0)jBjxDnx>quj0T$v47M;b%p%WTLs
zQr=`jnGLxz`uir9*~aFxw>1g>Z$2yb$z`@Rl0}+QW^0iw($q5BddVG4E3+XRMhbg+
znGKn*{|%Z^WN{|%vYIG3{XuDb?NZVD5AZ=G`%WR8bK-<+iLE5g?3vK{z5Tu=}wam5zwzOSs
z6l?)*5?lk^TxMGe1KPy42+}6DRggBZZDqD)FrZCryC7|1I|LhnJIid1FrZCrmmqCo
zy9FsRw5QCr90s(BwFxc&?iHl{ti8;(0tU2+?Gq&7y_vjb(eCK%8r)*)CAJSa%}
zS!bDTB@Ad2J0wV(SeM`o;Ndb`GYn`GJ0eJ%*ipeLz++{$RWP7U?6@FpVkZPA08e6k
z!+tJBFAgS&1f&+mU%51GL=nuRo*bjI~
zurKg(nQbEsdIPTr_5xlNB;kDxa|;Hfwyz8R6?mh}wiT^^1l|<<1MrsM?}4|=Y};V)
zJK!C`-vaLn{swrj%(fE-p9Aj;lCFLr_)Fl!GTSZ~dM_jrdT`Y3;o4_SGS_V@T9=TOG@dwj$>l(GIEKSB=0VjAb~@nc-5
zWHF8R_xK4;!$OApdwh(;u#n;Y9-rVWti?3R-y_OttjYc!G4^|=_fMu&tLowBG*XX_=~@b
zz%`OL{^EDB=OTIIFa93q=oa~lzt6thVt?^_?8`0j7t<+zByar19`@Xp`HQ_AC}{K-
z`w?_T^2T2rK+GA*8-H<#LkCU%;!5nVI9}r~PGNhsn40~?X|AJNpV36{KbJn7?=>T4}93E=a!r34d`jT4}93DM)MODSz=Qw2lLw790ya<1cPO>qy{P
zL0T)%`HR=1bqKIqkk*Lvg0x0l@E31@0YxS+3esA6Ns!jc%l_h47*J&LiobX>@JrxT
zL0T2B`HQ!p^)JBdf`7*FzTsCpZUR_|^a9
zadp?P($@jMX1eEBzoDzNtdm~3?^oZ$VG88D{p$M&G9l;fSAU=f0FV6Y2M9JH=j~U2
zilK#^w_kN*WLZp4{i+9%b>zJLYB|E`$a(wK2r_ucdHdBU#4~c9VMH=w3)S{^y?fLg`b)&2oB&Dqrf0X55$Z(u;p@#Gs6P^)=m85~f5
z#w*K^fchyXRfh)DUvNloSU~+ur?Y9p1M26T7atK&f5kI(WI+8j&(u)?^$UnCi)nN~
z{TnN*F#+{Uj@^w7sDI~b$#DTJ9$X_iKA>Wn{1TI6LO{hd`4luUph6M-3^XaA4ma~R
zo=y&^m^u{An-Wk*N;Ge3K*c1gMBB80I$Gj-(*x=lGaqT05m3iUgs&!`)|k0Ysy3k3
znz>GDW0^aa$fxp}$^--HL#^U#c&g0_p)dy0$W)cF57S=70(%W`fjNq>oKzOPA)p>N
zbCjtypq?;ulxbr?MXvK2-rW>XPnr4X%jST3TJ+(TfC`OA`fzJNg~lU&xGkVU<5661
zdqC|rb2Ms4Ks|5fXw=Stdcn-ms9gc|q8ypq9Z)aHk-0qq^|Bn9YYV7XA?X(^?~%@z@Yk4l>4BdiYijl=7WPO>OV=54+*N!w4}&~236!bNs$i=s;C4dMLs;J
zjuFK>BB(;~k|G}&RFMfKMLsI1Li?scql4-MQNd$^Dh}C^A|D%6ktZcZJ}#)@kR2)V
z@j(@b>`0MM2&y<_M~Zx6P(>Cs2$~dBamdaOnjBPd$j%3v5>#uX{&Q+jt(E%EX+ag)
z){pV-^q^WN`PmskwO;B!Yl3Qn)PL3n)mc*iIWwrvmio`SpgKpQru9K}Nj^tr8-gmT
zT&X%_R!~Ki>(@ZDgDR?AsXAm%P(_vNzk}umRaCkDD`;L&ZOZ3^X!CRrkETo6>7
z^ZCH(!l1e;pJVHbg6isgj;${as)!EIs<$MlB08XgmIl?e`J7E(7F5^eb2hy(s3KxO
zvvGM)MZ|#O?JI(6t5oJT1yw|UDI&Zws3Q7Hv4iHIis&!JxK;&KRJl^FV|7qPl`F+)
z)&x~lxl)X#C8(mxm0~n&gDR?ApMur}RaCh?2CWaOsB(P>+7MJx<$52~8dOo`dKa`Y
zsG`dCHfU2&MMdj%(B`0um<6qHTY_qLKCf_FgDUDyDc-&<9zxr$po-WA)oSk!s#o(l2EQk$qCS;YxVE5rGoRPBy+QSHKF`qhp!y`A
zXXw75`ZS+s=>DMkET3oSfuQ<4pJ!-CP<@flGxQ*4Kt9jV&Y;?>fcy7QQ0-m7{o55(
z`xJ2h9uBH~3%Gxe1l4|W(C}zb?O(wCdknLufcy7&P({_Ofxqtr=1c+l4K5$XF1#Re
zJ5OPt0?F+>El6(X84OyqlG}L}qZUXZ=W~MOc6MU~qm?B3c|meJFJLsIl_dH_L2^4U
zVPvC~B>H7RayzeJl%sV#@TwrWo!11(?Yu5X!u^II3HO_VB;0RdcHk4p8NDq?!u?KA
zosU*>M(+xeGkQ;u1nYfF78sDP`9P3-&4-vcXeD3sk>HNMigYrW{&-4eS+SyaDVjNaD6nNTmn|DcZh*SAhKlN!<1iscT?x
z9yma-8#pkeQdr|Ga8O940LE$HV8K(sAt7}gT2BCn3LXaz3#seTdK5TZkP_k}LhKcH
z0Y?fR0*(r)6rVT%94$!UvoRrcGg{k$V+HpD$A#1_Xr-9hc){Jk2_bbWT6Y2`3hn?-
z3aQ)Bx(zs4a4T?1NZpRs&A_RGn}E|o>JGHF0;daZ0L}=h6yaD0tPvz-RvS`xp>+*#
zrr>H|T}a)HRuXCTf-8XyA+-&yq}OH%l3trFxC}Tar0#_Q>9x6ni-Ge57Xjyo)OHw<
zid!H^(`ljLJm8{`x(^0(fQtobk}VOWNwzek?uP+QvSos#?HUDXzAX=_9WbCtwnC65
zS(6}XyOkmJAPi`dH4BoqTO~;IZFNZPgaK*0HG(wXS_EmntqrM%U_g^>oghuJ^@23X
zHiXnJ7|?2kA>6=
zXiWo;3syn5o(O4BR+@$#0%s3H+BZ0(btU7V(;@9UxEBCt4@25_p}Jl-oegQ<
z)3s3+{LpB;+`)V2LfVIX2CqA${g4k0o)2jsqgKLVx)9RbtYR;QG#|vPYPuBC{JMrP
zk~W1tV=BE&qnAy1G2urphqMT*+bbb0%IfxNNJ}7Ji_?iAtrE#$)S8F1G-R&TbR(o?
zb!`Uyd=0(S(#vMNT!q!mkoF7gPmtju?U!5$b33Gc&XwSILfRKx0Dd>5{SN!kS55aq
z+Mjf-o_@Z8US{Eie3$znt-o9j@*t!Qkjp_HhO~ilImn}s21QBA>2XM#BKfZ;A+28O
z7M_N*2B}+k7Sd)(-NN&bHe2czUW7F0L-N^QhBW9y^4WWZHR!_-sCQUfBXz!g!rE2|
z5%mpg+ayHPFRX2s5K;fI295U}{KSB;wo{bnz_7MUl;@zZwp*0v;IOtwl;@DJ)+Wkx
zXjt1T%5zv)YZv7?Jgn^#24$y!#)LH}yMFZ|YfyIo12jIYLD`XKJt3??*^$3BF|3`FoZ_Ugc1Nm5CWp1VQav&yto4-~
z*3_`pPjXn(!rFj5R`b)t8nS5R_>>u84OujLRyAP_S+oGCHmo6wRtB0G){sT>g6hH=
zvS?I`SRd9V=5g(GLs&zejA{U8g*D{Kz7Lum){rNA7c?iVLB&x3Zf;mxn8)7Eys(DK
z3G!j*qmSfN;DWFQ#YRtPVOWD=qiE@(u+}WKAdAD=YNn(F5-;4Qr^Opr^Jh
ztU=k4Z`v5vHi`;a9@aKXRmckTxoD3j^t9B1tVI7x&1W-uRj%+@g}#(b;_9$=K96&)
zYr-0`ZRA0=gf-MbkO#Rotlg4|jdfuSI_NOk*5ldBX}=A4_Hx>m540IQBcA^j^o-O?Yz=ET5%+bxyDh9i5&Z{fdsu@a`rn`(VGWAt-#|Oj
zTjKBU3Tsd%#c10d)}TyiH0?ou$f>Nhur^<=;n*A27Dz^~9lapeaO?|fizT-Bi|L|B7oy%uybtX^jheum&Hy7IZPJ;rtkBluLNJ
z1w3aiK>kR0V|XHVQqZ@#|a*UwblZTl|01LE#R^7
z2v4_wpU`8B(*i!>`2?#)0q5bL;^`Lfb9sh!qkwDFpJUx9;2QN8ST_pzxx5T(7Yh(d
z#QImRT`J%a(Ysu`T);D>Pq}tSopj>-dz_F`=
zNCDv
zt10BwXF|DFTga==#ByzBA)m{hRIb$(a++XrxmI6@?GAdqTx%%gI_at9+N?rerKXi@
zvkT??cDXjEkXNZ0<=Un~R>n2u+U7!5#Gt0HMLj8Z@^XkgAy@foQ>dUqE
zLXHPElxzD6xf*I#xwgNM^X9Y5wF8BG+0C4Ct)r0RRCCL3;EeED%Xw_a@=rnxpuUW$K;Z7?N}jKqAe}g&K7cHa9O!_
zrI0K68q2k-g*@t(muuGw`9#Kwa_xGdeg?mzsa(5J$R{#ZmTNZ)Ioj1+uH7!=S-T2j
zqmWm#)#cj#LRP_RFd_;$e%FE#QHaqAkFs1Fjt!jz#JY0!UPwT!7bF3(p`6_r5)iF|
zBp^1HYh&;!DNUCAKAgP7}7>h8VEKdgp
zBao!RK|zuVoq`L2hcHHAKvJPgkfg$4j90XhR5&6?QsJl|Nrht=vM?Y~a9pq!ctWrS
zcv6t0!YK@D*pfatEl7I&3c6;xGXplctwz;!c{?%3fIcDxv(7yye>Edc%xiffYt%Pn}VbdZk1~b(MqD=wqPIN
zopNmvT1gb#E!P$UNxR<@BvEj`Tw8`#a{nI)lKcNqklg=AQNTok6*P4J|0G|kw
zG=C~cO5jAaICa2XLq$&8%S&_UHEj
zhYQlo8WCaNybU-~S_wx*v@Q6sUBJ;1Z98xqaEu^Lr?G-tfa4&2r>G7EnZ68``I@Jl%bgCCz0Bne8`(Z%SX_nwz;OvOjiPn1H9Kkx^+=zAvtu%+`
z3DO*zAJMwdIvuz`kmk_Bh;|gMG+P!4(rj5QNV8>0L^}Zknioq2NkT6Zq$$!E(N4mE
z=EZVBnine~+9|Zsyl4`nd9gC0oklB3=w?BZ(5oWa8MM+ASuNNPf^tnnr&OJW1dqkk
z64Aeo3IpWKBl>^xLD_W?UGB?SAJO0Dqm&yW`u8|L-x|^1$3ZY$KN-1nRiRe|FdTop78LrIS8_}!zxN>_${{?n#i)mj(
z{~X)(>!$q?{R>^cPM>%KFaLt~4n*`XIn&w^(f`h|@PiQ@?~{t`jOasNoqLSv$XZh5
zvn!$_Ye~6@!x0@RebNF)BKkzh;vJ3XlO&6GETY$$xt{HKM2E60gx!gV4rNJk>XQ*2
z%97&Lry@F3Bt@N1M|7yjyPz`>y-_Oc&qnmMuPQJj`np#Ym=S%wWZ2F}bg0NK{KSQb
z4i(u6x){-+B0E5rB05y$e$eHJ4i(uBx)RZ$BHKV$BRW(hDTQkh9V&7s=z2tlirfym
z5z(O{w}Ng)bg0P9pj#0gna7Qw+Yud^#|@x65gnPwb)dTu9ht`#(7lL`%;Rd%{fLgt
zV>9SML`UYa3G^_cA2oBX=ut#R=5ZO?9!GTO(i0$c_l@ek^7vk#eo?)*
zoKEZ?)%)bJ$2lOXL%se9KRYn0<9xv9pg~c6L>}j?2S@dhd7QHz64jAMti-!RqdM}4
zNzkyUJ|&Mm&f!rV8O12tMnrW~ev;lD8P!pr`BTuSs17aq1JLNGzEtkC857l^O23D;
zu~EHI?z9;f)uB({M%(zPzCz9}PKfGIs^3K0#HhYf&Mr=h>d>sD;U-7*Re7x8rbKn9
zSJH4(qxu@T4`*6bhmQSUXq%49lH`ozjHnJp>qJ{kRL7|R(!jM*y;Icd%&3k`;cIBC
zi|WV}{x?v4R7XDV1*jpaBcJySG%Ko~lT!<`qxy9@lQ<`;L&sjnyK|#DbnI2oyr}*t
zkNv{=QT=fq`-KalI+W@Oyt^=}Kh5Ka%A%mr|lHUtLOxzI=5lWmNC?>Qc(6-v8C5lu>=at4k@P`oLG0QbzSb`Ru2!
ziR!pf=3V@bmZ(1D)uohCeW;vvTo=`cvIGpf@efj5{R%J%JS><19>H)xYXo>yupD>{Lj$cL;Bmnq
z@C1elTK&M2QT-Os2Rs$kZv#ER(}Hf`nW%mTt)BqTVrBz>1Ux7B5wJU|KS1k;!1ID1
z053%KhiH8tcv0{@;3bSow0;kGS@2!p6^u}{z5~1}_%`qwMkZRn3A`@&4d4xoQndaj
z@TTC`fwwSX(fS|2+k*c;@D4^Q0=eW~+!dS;yoV8rR&vqr3(f*Q5NrTG#K46Cc^Z!d
z$#H*-L5x=NG@b~~06xWlMk{$5&jiU^e~!V8R`S+g2u{L=|1xUFhHuxnIH*_5{!I=g
z_m0`W1r3J#G-CF*`KqFCgPMvJ0-m}v~{h#>Qu`&A}_?o?OG5ePs
zI~X6cBi@_EoSG1`V;@g}CdTX|&76^+6tiQ`rkLa8m>qjI#T=)^?33lbhN&?-;=-Sx
zZCcDeRf+?r$Lw?D?B9%-eXf~T=$e>)o}BckjoFt=RCZ>}zCxn1buoLBL}lw^_6=~a
z@Ocd}d#jn_XtQGWjS`ie9kXMnrk!g}%#NM7UzGZtWik6Dso!ag*|CdK
zP0I3^{fc-OD`NJm;$1Yw>`%piSQ)cF6aS$(W`8dJ!zw&o*~3=H?1N+vTNASnmOZQm
zPh9q}wK4lp*~8Z1ImvJbW5Imm`fozW1aTmb<
zK--p>eSy?`Y>n9w<^6xrwk>8~BsMATsvZR?0>Xh?Tp#6|IvQ6D`v<3_XM;%
zX5S|J)t;Cgky_fX+G2K`aijfeZ_JLE?PXAV%#K=}i=chzqdbmx>_;EvalGRI`bhS*
zj+lL~>}v;O_IBCVI%D?z61_bXvmciebzL$02{}=BIA%xn4AmbIJRP%RPoxocCT7Q;SPVLgUXVTK
z9C|_S#p;gPv4_!9J0G)8kc*HnU@pixi;L)^e2xuWLLcSx^Sg{b%ID{I1wA7>*VUN4
zHlL%E*JAdW`8@uv$Lw`-b@Gjvy+LXvZpQ4h<-+7!F?*w2lYAR9C7<{EJD4eQP4ZpL
z6uBn(Ud+Byu1UThvm;ha`~8EM9kF8aWFN-th!wYk9-)8p*^_;YUd`tx`6OmvCz0Q$
z=r@V-K8x8AD_)A9cpkH(zGE@yMaj%)Uc+q>kRvfgn!BFW?t^@-b$
z$US9!5}X1Y9p@#L6yq4d
z@xZZy6lxh4=M|E4i*Bpo?5Zl@iQbmTNa
z(vi~zDe5vKZhry;O2yU)Qq-kZun%x%-2M~>y?}Lse+SkJehF-d+i83KD{z+JUx2d(
z$pM-Zx6@8bv6#7n6pNWBNN&;mxSclL-vJj0l3TP;kldn0ar;XckXy7^kldmrf}aDI
z#(6Ix&uf|BWniP=CE)V7o%ZT(;0i&C&@>621+I+SX|FyFY!*BPTot#|{(B6#TJR`v
zjUYv6TH^M>Fz5oV6+8r77q<^V>p|dp!4BXC!2`h7xP2%L_5n8vQm|%I+&%)WyMdbp
zcLBEu?gVZX+yUGcw~vPH7T|Wl&A=Ukn}9n7DOj^BZXW~N4Zz)k>w$X&DOl4Mw~vKE
z3vjRC8eqHNYT&-OeH;v$f%^ql0uKmM+@>RL9}k1&z=MK~z)rzs@L3MUOW?DVXnf?N
zD_$Zw?!)ntx4CTlNWA17$TeKp8!!1Tmu(-5m%Phm+sET2-$NDw7xu_tcu55pb6<{^RB|!*m3T>tLkw5rB~=J9ASE6zNh3drlz6-(
z!^!R&@scbjyKlxzawx?@`a51yjY>OIp~p*phIA#aUyGOgoDZPfjhB4NWp?-CC4J;b
z=lys|UkNunh?n$}aKpoRNq-49Jc^eL635|jykwM=06&SBER^*1(|E}u2_rmkSP~5!8&6yF78F-=JrpQFrO
zGfhnxU+BhI`W@rwWjwu1pqGhw`6^7OC5%7vspIJh
zfzG5j!pwv*fGP|A*;JP>(1pe-`mojXvW7nq!aQN1M}Gq2hJ-OjO5A59jPX*~K09H+
zxupQZoP+^Kmcj~i6Gn{`8q7-=2vU6wZSxbxEOKA}$+RG0z|A$b((l-Y7ZSq@69&db
z320HmK=6r@oQo3%TvZBYElC)ia&g4cgn>ZLZL}>*7zo;sTh*8_;BKA+El(J?q~v==
z!niFZ-%SYv;TuZeu1pvR-%vqhbHYIQ<^X6_!niLb->VbG11b4llQ7_nQjn@8VGNT{
z$l8Q~pbdpW)+G!CZTYgn^(9CDnE$39{sd{4q?l?xo&5(df!ZlG;%!q_AiIJ74WxQr*!wl86zyqi-0`xC}1=kY+oI3|VO
z9eBD@=zTC@z>VAuyUv7hQLf`Xgy$^R@pdH)xRI3XK8$B7&f^h0Q*j=T;+cx`cr0PO
zavqOk=!sKvB4P9vr{-kBfXhfdeG1Q6uEjl#=PYUdGYJDOBlZ4SJm-9tC+F~-rR26d
zVbqIzcpgtu+`|hPVd5TM#52ujSNam3X+DpQ%Xp^w93r}sFj^#~e>Gviv7-@j4Nq4}
zWUu4tN{Q?ZJYD(5jGGB#x0J}cJr|^AVi6=n~$?F2vH`Cr}D6tGO~pEU5z9}&DeAZbjKt7r!%jp+qkI6f$8%q!qT^x&j{asWz1
z4@nve=qg%-D3b;X1KtM>OB(pD5Gt1$o-|M*Ky!LT(pXZ!65mAsL@EwiR&ddP34bDM1gsJ27eOpyFT@
zwkM691zglUIce;YZ!4LSG
zfK%MHNn?Kjr?_V(4U{X;Y^+NfC|97_Sf4Zw(zl;rB}^Kf1uSD`C5=N;UNAdpbQQ3S
znUge7kZ=libCU)N5-12cFKOH_U{NwZX*?+4vaSV5<6!}Z*B2&@M+F>SUz9W+7qBQ<
zoHU+DiN%tn@w9+N$WSYR`HUy22`B#lNX
z7TAh$P{>bmThdq|#RA)tMr$Fj@;j2o#zHRG*_kvp74mw&3*)7bW%O>0mqM1&doW(4
zY@iL}Mal;DV!TM%Ks&~Zlnv}dPfKCI{-kldkXN_^N#jHzKfjKoak7w~-@&ADv5?aa
zok`K8*e?WTAHi{aeUF?~Zvhg-7fO
z%uox<C|^LoS$Gw=h<>whImIRPn}v6S%jh=?2Y|0&)>?QayowoW;n8^wePrR$c|B>Y
zvG5Ur8%d+Z!i7CIlg3&L9~QWUr)!ZE4W6z=QZ#tF7D>@yrdT+Xa1S%Z!l8uwm?;)c
zxI9Q2rz{*wc$hR!TXZUEdXzNISh&RJand+zLD&xKU(z^dkxMd?Mz;n26V|_^aoz$4
z3hQ6exM1NG^9B0I!Yk%W%p(i0iM=X}M-~n$^sX=-%k%3~VLXxN*SErWD$lQ9g)y**
z6E6KLj6p?wNN_-fF}R3Jfd*C>V~RN8GN{5BTf~mi;0j}05hq-RR2bunxWs2@g)y;+
zkJSvTFeVl8v6|r(#^fTtR((W;F{OwTGb1aEX+`WojjAxF7x8*Jy27X_;zNRCDvV`C
z>?4h>FdB8SYE_sh2txX6-9h>VnT({RK!PPCRP|Li@3mWQiai6#3h)MD~we|
zyoye#Fjg1wDmt~oSX0CWK+`IWmLgt7r&kzji+D`Vs4&(Q@tCZsFb)*)3RhcU94q3n
zHnYO$F5)p%S7Dql;xSZTVO%KUG1O3DTrA?ldb28wOGR8JHoL;OT*Se?ITgm0B0j7)
zx5Btu#06vXDvWDIe3WH=g>k)zy^#eK#*HHOMiy2WH;cG*XHkW5tB6Z?7FQUzi`a8p
zQeoUF;(dB)g>kotJ-1~Q#=RmQr;QcH{UVH02;$f2KH|*amDB+ymT*
z@dg8u%9{j9DsL7fsk{Zl5C&A@uvKs?aGM|tXpBx6kZRr`NUC{fg)s!Jq?&gLl4{;v
zVGKplY*3)
zI3-Bs5T`LEVK4)DMsPattRN*R&S9p)U<$BXa5C_`;3VLM3KmZjfENWR&UHy}9Plz`
zI6h$v@QNVCxvpZiqje2@igVo+
z><_#r*bjKW!k7w!KEMZpy@3w}DdhDC%L@#?1U?r08}NxBg}k0()q%mEfzJg01bi+?
zA+Hw|#tazz9{5u5zkt0ex%DovccoDSgWJG9g13Nu1#bfTRT{N0xDM5q=>=TN@ErbX!?&6r0G9ikRk>XDvjANpy@wRkRk??1ZgFhTxraK0ZsoY
zf;9c73Q~A%TBR`;1~mPr3)1wTAxJ^9no46H3~2h-3exnSDYzY2S82?L0ZspUL7M&z
zf)qcSRcS1M!A9V0!B*fLL0SpsRvHUounss+kXC~Eg0vDWs5BPAU^Q@|Agu(81ZgE$
zTxl$ZK@)I^Agu&T1!*N%R%tAO!7^Z@Agu(;1!*N%QE4oN!6IOjAgu%|1!*N{t~8dx
zU>2}NumQMMupYRs(pV0InZWgev?y#4tO2%G8Y^Hxi^4`h
zS`;=3P6cijr1fD-rO^aiS`@YlP6Tcfr1fFDAgvEODmh9*E5S~|QNUe-v?%PZ=Qg8hQD5*(;B)}pm9utShmf`gUDI<)oz
zb_)I-c&O4?k5-!gU4k_I4_6u+&`Q()h#*b>qk=U3k5wA2FrevwT#%;!3Blh1PgWWm
zVelK^DZwv*rv-lvJX2|Gg2Cs&vx1)i&k6n#*j>p1pPvEG3swU!2)dH0bUYJ
z120z^+wr+6;1$72;8np2;I&F)2MiLx>w7hhXotZM
zfzJg$1ildb0Qj=f*aw66fxS|Ut-#)bG`stxjQud6+1*!=W_Le9n%(_V#sL`6>>eOU
zvwNT*&F(>hD}jSkMh9$Zb`KGx**#Q{_W5CgG|`8rjDxVH**!v#_W6;5G|@+;j4l|^
zlpZZeQ+iCwIE>cWz_EffrN;@K}29S5ux91EP8GESnErgWVkP3d|uAZ$n(
zXJ9ZCI7^V`@oYhw$8%D~Sr`li&K0D2JWr73@%)r=4hA%j7YNckUMScbxF}_G!+_@T
zVnN!`mk837UYat_!{9H#Wr8%N8wF`fFHad4VDJav3TY*5N*R~YN|Se`AWh!plyL>E
zzXGljq{+Kl3<%exjH@vC1+Yc%Q{Y;`p99yWj2ke>0@n-Di`p}})U
z^=8WPO}!6bQ_ArzlyRbFGv#=f3o5px9PjZpOIuTp4^UZwFAq;SKIT%*?J0+wOEq_-
z96sG~FAtx0A1^wLcBUNVoITl4sKnt4i>WQ;NJDtNZrYo2
zObOIhrKCeJ15tiJDimolQBKqEP|!g!%$q3(3OXo;c`M~WLC18^?UV!2bc$i#
zNjVTrrx@nll;fcpi4Md>Q;tVw+~|XtXv*=}j9a)66HPgu(0AV;CYo}f7-RtGQObe%
zdq2?Qlmo>eeLzoAju&Q(8pK3Xj+bWrOVBg)mRynYJmu)0$0e>WQVx`b+{C*t(MNf#
zPVGGdq-6{4oEIwbd{q+t|cB*D~0P&E0Eup3w9K+z->
z?2NB+plI^{0ZpiK9G2|C#45)T$sSCqa-5ROLnl``P*V8}c2lYxD5<2vl&Mt?lvF;#
zOr2KcxQ(emE7o*DTCrwS@hqdYsYa02rdmOAH)dAx45YQGPLS57`YN7Wv^F&e(%Ljj
zkk+QzRXp)%L7F2-?#A3I$0Pg=ktVL+Zoqab-6%LQ}56;+NGFsK4H36i_9Qjpw@<|@Za7$kwK
z1j*f4UFGP5eE(tK8o@4Li{K&P+A2q17#swy6YK!47d!ymQ03?cgMGkO!FJ$A!M(su
zRgQr$*ah4yxD&WVa0hT}m17VLwgI;ZZUt@^+ydNDm18sv$XPfjxERw(9s9Ft%`9>NJhatlrhP6wV6
zoCZ8y<(LZFNx(CL6M<(1Cjie0l6&7><(LLratqE2jsac}BoE
z-YlcTYFJOJ-o)3q?EpPtqD;Zlsy9QVHnE;EZ2>*6dNWLe205mxH}O4gt)Q1ov}^QA
zzlm@6{SK%%6RnAT(r+evnQ0~Ln|`yRm-*}XANr+x;(zEVS3CAk_xz?5b*6iM3#UL)
z)S2%2UCyKrO80ypn+v{CH{J6i6m`C48j|k$6TN2*QuDN{4^8(BarNe~bk8sf@o{Th
zx@S3;agIp$tiqmwY<#+Bnh%MLO83mLn=v}wGs|wqm~_uy^Q8r2(>;H~-o?0d&);!D
z$M|&5-*c{fLb~T4IafY0-SaP;E1#6^2?rpCe`s>LCmaB(w4ajh+271*v8m~v*!C$U
zJ}uo7+dgd?)6+e%?f(${I3wM22L5(h18M|2fwgJ=k7x~;DM)KTUAkv2Y-tUs7o;_y
zL6FvfS?QiLVXy}{TW~jUjv%cJbJIQRU_i^kJi+aF`18|FJbb67pT*Nzkao(~QZGz9
z<(SQ)wDa3KeRbL5wDTSQ#_u!cK!sF2^LdR+W9d%aVyi#Pxw2ho72vp^7CGmcDngHr&p()9vsE_
zs%cHy>D8Sx>37u8%VNBIh7V~;JA-ida4;zC4B`GOT&9_JhEZ5+F|AKK%W?aa#k3*q
zj39^kx~VnojOxyM`uPUDP@(X~w6hXNZsBC6omG59XLH(_VNY;N+L`4^v^DL_@g&-o
zc2@Hw+Mag)9Fcg7X-C@mDb7#8wM;vIp}z;%m3ID;XVdPq^D}l9_oSVlqsRfSW!m{G
z_yZQx-n8@Aa0lQ}rk!8F8^Cd(wDUJ`C~+Jp?fk9oTtt8361>oJI*@k$ox}7UX(yab
z9V6#p+KI8If;!VqxR~Tb9!fjmVp0`lSK5hj^&04K+KKWDIxBG`?Hn&9I7idY2~s3+
zEbTwcN>9i9?7u{$(lXfnZn%uK#
z=Q1;g>CdH|jdG`6ciM@1V|Fal&em6sW!ky%m1CK9ZhGZdrk$H#-N>GHZh3Vhd)nD<
z#>B^YptN(J88aV_W!eb`bS3C|+6f1A1?WcFiNcO~pqpvuY56{~TWRMR`98ASY3Erp
zCyef-o#)J)FuI#|o;T}L@e}vb&I@J~dc(0yJK>&=2R%qT;dYWc`7rH-+ez-^qqGxl
zC%Kc4(@waZhtf=7X)GR`?@C6{G%#yJm23)2`u@>9lU
zob%C23)8p^k6T)T#%Fkf(h@X5S_vm+cubQ=GD(n@pvf6$BR+wAk12wifl~#^4Vjj4
zHo;&$aJnG5Au|NY4XMdESHfTouvU;F88b7^X0(z=QkQYA0yY8b1y=wYGR_vXE(OlY
zIM)Kn;g~H*4#%8~a~)b20OtzM2hPhl*Q1qukNNTm)Vd(!Y(*8Rr(XP60N`hmpbZjB^`W$>CU$ac&2W12$!xJAmY6
ztP~_KqdDW;iB|G5Rtb`qu{z`2h1OxfHS%F((2{ZPLF*vkT0wFx)@7V+XzdSNFW3*b
zA>-VO);_>iL2~dnW}NM4rQpLR!7qWEGtPZz{VQ;bAUXJ3}Je6^FqxBQuY54>)IFoT+MC(Vu
zvl-_l;D^9-8Ruo-4}jf*?*q?goLA8Lec%Q8F>1Y-ab82~JHSgB=XKzBfR{7Q8^CV?
zuVkDzf!_dL75qQIYZ>P)w0<3UT|VI(a1U-|O5q-qYFIyUAyTIF8@xx}%9MVS_sH9s
z(r@EZTU3N*O5bMx@@}T|T~zwKZn~E#{k~q>29Kk3FJ9R9%#{9+>rfwLNT9Nl
znbME-(k{He03Y%wQ|jYF)5n?8GA=ZIk}36bq3P31X#l$+ZYa)_1`%a>-Sj+D8q!OT
z(&rz;%YVmvFEXVm)brr3;!J533dSs^UfI$#yDz=7r5QfQ(rHm(%-SKG9X*}H}*pYW=p^1Bf*2RrGMudslnM&Y{u2t5Qbz+`VjmehImg|?s
zW=pZ%{yTnRT(%V3?Z1M?XG^i&xgz0;7q}(z`AT{
z2U;fs>$9Z?fuxWc1ZlyVl`ZW=D=k>Fv!#cCv|!BxC(v$dHTAG#!($cgvTY3hqe*-QP{420gkk+H++0wHxpeVx%
z!9N0UG2TY4LM&%T8P
z;4KY@r{S+=-}(*)zs0ma`_|j+e;>%c^$z>r9oe_u+~TR-6->!Ivh
zALCS;#nhF3>!+x5v6v2L-*W38W4Ip4z6FU$9^=vMTS=|P
zTNx^wfPc!=20E2}D@*4K5cp);1v-;`D<{JBEE5UWbJ@45MYwh|k#Ieqed}i;TrV(f
z#D97*>%xEP(h#9U?R?htH4YVD&bq$MYu=Tt>pQ&WUCp{gQ(w!vzRyznde-$Jm)_sV
zx_->A{>`lG6ZY_LWnCT=0YjT-U1j`j;&-yHAb*MY-K?t|Q9o$&tSg3d{I8qtXI%;1
zb+7<`#UZ?W1@Aq`y3#0}gG$f3GN_!xBAIpljEm17XI;O9yN_$!v#u|2s^4OInsxmi
z?mQOBtm{wk;c<<7*7X;}@US#yU0-tX*UPL68sf&Wub6t}T+pkoPW&c{6!*@#2Ak29
z(C9hW5ILmSH|N62mOxv-oD1t2Re$!+xyG6Kx}pI&7vzHnZ3A;INQIx^LkHzth+n&o
z<3pSA#^9W*!OW$ELvk)GbX4v+H0PQtOWv@Y3*qcM5#x-c2ITzyB
z=Rq@at{W0xugSR}5U4V^Hs?ZIng;7kJXnbj*X3N03KSo%&$$qJ{s7dFbKxqw_d&CA
zu2;tuXXjj_B|bbS=NcpR<8yPau~I)i4^Lc<($CMi#>-Lq1v%FQIl{Ow=b9)HlR$$kZ
zb0OmWFQAnefkauFttpw@z|%1G-z{&8;~X4oBWb+s2#=G4e~GO*t2iI-UY;&be^Z@dRiK
zdQ}cHZbh%k7X@xZugbB;?dVIXN8gciA%49PKe03C>Xu`TyK=7ca;$MT`Zte7<{tEK
z9*fMjoa>I%qwhtp$_3!<=v6t^xG(2=mdDa^f6nzhkEP`S^r~D7-GN?}8uf!Y7Y_5k
zj^EpvbD?gXp4Fk83w7%x$h**&`8*O2qc7!H;}P_w9BVv^e#^&v#UhA)%jdey<9POR
zgz-eqgsA{Lh@^a3#DPO19-WBwWTw`|?JtG%7UqjF2
z^EDdRb1qyRumpBDaxPpQun2S$vrMYmZ=q+Ts{MA(g@cPVc=rzGTRvxm?&e%LxX2W64$wF@=$lo9G(?LrMbofzp;
z?dn~i=Rkd{U407J+v`{D>RZ5BqW;yceg)X`ko~E44Ul^Ifz_^&1?=|?s&=7D{zJSw
zxY|`yfG81s#%fn>0iS^xTJ4%yz){y>)vme%J`FRx+Erh`nWGWau7(269F44Y%_-oV
zgwMDjjMK{uHFe6U+r2_z^lN7YFA?c
z&;5zjE>zQNcz05@YefOqY)`IsHOp0bQ>tAXsQMi)W3_8P7FlxmrU{ZlonFnm6M1*oN9KM-?=
zR_6+m8#u4pbp!_ef%64PtS%7j3tU*u+Yc$!MS>(i7YmYexTM;30-r!0;Zngr1D6Ss
zbJ$qzItc?3tIGw+Ib0z~&S6tEZ$YF`R|=9x*epmM;VMBAtE;PBXYpYqR@VrUpV%Tu
ze&YWv?L5OAIgYzOnAru+yrquEvw}(6f)yUi2MmD&h~1TCNtP`0C{wmXQ4&o>QWOOY
zFoOXgiKZlz+RHiToO8}O=bYnS&N*jZ@UOb>y`}W{!|O*MQ22LG&rDB;>guZM?uF^b
z$4MZ<;UW#wz{MJhoVX<2_!J35B3!DWh=I#A6yb1ry76fe$h>uhhCczWOgBD5tjLM0
zG!!{;b-M9+VnrfcqoGKIYtxM{5GxYlIt@i4T%T@ykyw!kH)!~6;Kp?0E5yD6+@#^Z
z0XJ*-P2d&{Uj}YXH@-^Rmw?+el-cZd4Zi{0k#2mA1YZa4)bMM-T^h>7c6Yk*brO69
zxJSb;1NUkubKHID#y3dtkHGyJei2x!VKs8yfpi49F7oN{NaUb{=}49G1vr$BREJ+D
z=5RXlB|2=-IFgQhRY`hB(~*B+!p2_3>Bzr^Bb}HPM><1Rk?43j@~V>XPNXBRsil-B
z(~<9~rIe@Ak?*Uel&8~?AE>32XVQ_^)l$l{>BxT~(*%uk>BtY2@OM5P`H|W{_(D4J
z6E(5Dn2z{pbc4pFbfkbnm+5voQpD|_1(@kbNlAKF(~wt;>a~K+G7*HuA9J;NCc-rMhoBaj
zNEbadZkdT7K+4p(RVLEyu>hHgbPq5^K!D6ddgz@m+GZk%m;XUryG#U)^(&zEnFx}g
zOny6LB6GA%*fA5Ct0%vmGLhwa_lnM$$O^ruaF}vX_hrv3xMn8Oo;Gt7IEaD)9s~~7@Bna#hPA+;3$fe1lxh5HQWXqqv2NISW21%n}Opr+yop?sS~>aI6=epz=;~J
z15VO#EpRgRLfX~9DH^THr8
z91Rx$=ThUOod=w!;auSSOr#&NGl2^>@;dJ1lOhgpzlYxsh6gBP=4JQJZYB&M7
zEE5?-+Ht_;8jc07&~OZJWhOG11fzhfG#m+Bt)b{j)?^}L^BM+RtKm@KIt@k7yFL>U
zd)Of01`P)SH)=QlhO{XY<*cvh-zuZ#=1lZO<-xQi6HTeP_0~+ZT1~09WujkFmaOfW
z=vOc?28|t==+_j}+L?)dLouygnP^j{V9yx4GtqB`qkVXBv@b-C_uG?+ep{KV_GY5r
zQRb?BndocEO0_=|{ed!0)n=mXsD~!*KqmU*a8wHV6t^DCM1QUr)}c)FZKaYsoQeKI
zspO7iqVFh`+|f)FPbqFamWigr(E;4LgIkYhq9xo_g2stV^w)Si1&x!L=(|cFK9z~W
zqhwNWIunI68K5(nDEvsK0%tQ(xW+Zmxl9zUaRqcf6NPJB0$s>Nu}cZ>xtNI#(7fkT
zCOS|%H(ky|QJ%>(>`Ep&Mo+`8W};*DlHF^WC@Qm6T)m!&GP_&>x{-;_45;bB%}f;K
z*%IPzWui+1N|e2wi7pGM1xj}^QMii;wRba7xQht2_cBqq%LLGenJAoOFz9|J3MY|e
zNe?p7?fUHAhneV(fLfOHC==ZoP|K2Poain+Wo_m}ck3x@b0>OAmqrUGdRk9UTRKrV
zj=1Esa-tVBXK(F9FKW)-#))3ioV~3Ry{tKVJ0}Wf5&^co6TJ~oE=?Vr=uN%DPDdwt
zE1(wLbaJ9tyiSm=vlG3ed07`HdROzZu1=KQbY#fy=0v4y9|3lERLc^!)k8yJTRk1s
z)P!yI(oon|Z%4HvVOxDP6t>mZiS}0w1j~ss2ZA3ZKv0qWUM$B^TZ!0a^Y{!0`k@Xp4
zj$^+Ow!5OHv%5pKaNAtR{+Uv<&2#KGm6~n7W52C5RSO(D%|UZm$sId~$^k36W9OBo
zYO!ONlpM3fvENnV%TmYw9sBiR8+Ysv)L^^Zu@M?RLql2N*a!$>cwXt)hybD;SmoFZ
z_a6tXcF2)3Mz3+m7CvYVjkS)=fNnoPGP55-Mv!iuWB1d>==F|GXBI}V!Lf(xX1>v}
z>B1tmY;x>LBAA4Y&5ljSwYSRmiYnSZEkyLEwkSq}B;MlK$N@({TOE6zwnJ}o?1g%H
z|8~b-q8Ih=aBTXqOm=rV_9|_g-sRY9wMBZjV{gNvbu+BR+3L@d57aSWE&>_%8#~!QCal7Q$&I57v7!cFEePVq}8eHEW}akqLUYtc@y0Cg|O>HVPP-g7?VU3-q3hJ+n57m8Xg8
zm9vWln#WZup-ln0*z}vHSdtyb}-H}xsX*h7Fh9d3m$|@EmBJOSt2LtzH?M~b#
zBJN%d2LSicdx#aw;C>Bz18X(x1w5c(PvAjX8ELx%4{6v9cv!=(z#}w15{S;|sD_<@
z$29B+JWiV=L3`i{4ch@vYSn(4p7}?cqy_HSz
zYR4{~4b=#1~YYf516p9_7XCh+f6<$zr1Uqw5GBwO(vf=Di?cQO%6xrV*jZohhuWFpDHu!*j(&qYLl>W0)9f`@wwQW
z%o3k5Cgfsog=4dWJZL*aCXN$xv9waOOv=SLJL?=DF&Pw&wWkbX9fVvL(hfN`CNut+
z%#vf`R}|YIMEq@H;`%nqh%
zD6@lU8jAX2dQN?&%noK~xB@s+LlJOh)8y=2j47lDmveHlaavBDn~P1Lb~C_6-^fifl?&c(U`WpFu?i%CXmfJbQp
zz;}Via;lTd+m6#5h%Et6=$7sSPtr7q^?;{n8^9d!G>rr30MFzUBlsooEcqq&C%|*G
z3g8cb=X0^Oz*m45XbnJ-8ZPn`K&i1yxtN%|W5CPQF7WSxS8}n-z)u6O@|nPo1Fz*2
z4`~Fvo{Nb*(*SrQr
za=h+YrJ9Q^<+|wX@6%F%)xZa27bvpsLmFc_@;N@RWSq#q0oJ&&Ge8;fo4KmzcK|kb
zW9{k8mw_$ZSbyLlU`sbP9w;5Vm8&?yQebO0CVXKgu#Ky@gGeZCUBw;bx$RuVBV=rE
z?zG7XEWOg;V=2
zqputMUO2go{$vSz{&OC;8I@f>H~2=_YR2Qb66)^;e;Bs*P&+T;b3ech{wSOr$+hHI
zdEaf~zss;P&<*}HY^@+SpIqkT^$1M!7*JY(0{UOy$<;JaV)f%!Vx))vSSJ*BVCr
zNRp0mgSoJ^MBXCqxW{?cSU2c}tv+y%?~`Dh8!Ut^ahp;%ZY9BZH&_f?(kZ^kp^+2Z
zU@2^gD#9AcLsLg+2C1Wv8j?W<8^;SiB5Kdzr_Y!-%?vk){>M5@@FZG`nQpL?yo`5S2O%qI@3Y)sXIbC!d1JO4?7`LBa&-Wo
zW$pu+;vQW0gHu0xRs7Y~xIqMmMqFL%22pj@-MgBr>)asLuKJ+$Zg8#^PByr~
z1zL%=(G4yn8+4^jZu})q8*PeL*2j&_Zv5ZFO+-bQ8YtupB`AruxN%l@#b0CVwpWd<
zZu|$~q!?RFRit8{GDX@m#p~HTDMVIFnzAs_ltpajEFp7*tQFFaCS!_xYi@)DYoF$s
z=0s^UlOd(r&l%g?`0L@MXnoD;LKaBkRYGP;vSpAKH1F+h{0-$4yu*$EP+3%Wy73<=
zmEjsHqH2p@LizgFIKN8I>t&|I?Vt{Zu$WQR_Whx-a0H{M;VO&_{(y0yrukK8yNSLDqzfN3BFHR@@XIfz^ugSmF1e&~pmhUN}wU?mXCiLvN
zjhA?hMfap`>m^uADB9+BUIKRiDNuVa@s?JPcJLDK)C4|8Tt_eA)CB$l)X7VDHGwiv
zXD?B#2|NOI@e;qO35Y?rtCwJy5zTTpFToIWh0(pcmypr#EU<@{5T1Gh*waf0Lp==a
z-b0tOAO_
zGtx^4Q|ba7b=Tcq3ZUg9XQ2%O+0
zP6A!vL@#j`mV;)qQtz+5+)L{HwO4pay}$NKFDd(LKV_`)l0OY6->M0Gmd?G}OUfSG
z&lzjHyNZOhvYUU@^
zeoj4Aj{vgJ$y8*mAT{17qUMDEza!60vT#5@RZeozBT?OOR5#4Xz+{e>u|^R!I6WDm
z>INZG<~G7z7$nzuNhH+!REH&M25X3r;X<|u*&*bxkb6R8b8Sm@aH|w^
zRpnx`mKq95iR7D-K7XY4yF4>BS;7}6fYf}c>E%LZ^MurB3O%(~$X%&!MJ7p&&5#-s
zxwyI~iA|qhOZm3DkeQ6U>pb(2e8UmQUy||lUeXCCWofZ>L2`dX$SujF>~dE*mkX6E
zB^RRoNzLJ|)U_w1tz@9D5Y@D#RlQGXulG`Gq#dn&LR14&ZL3BysT$ZK$!TYDS|u&2
zswI!9>LKJwgQ^x@tJ+eoHo{Y@_e;*D$joa(M55PiL{?9kmxK(UEX5CMgO|)Q=s#m@
z^pg3o)j~dNDC7j<@Fp*b+})RtyiLl@Uh>!YHvX-##Y_Gs+~h5WoOk#+{OD{=iu@QH
zzE8j1>LuR`n^L%%$Z~sANH^ZI%}c)j_@YE@Mo!!AB^he#(k>xxhnHl~t&3a4P_xrZ
zGW(-hw%1EC?27GYpO<9V
zy@CL`-%B#s{z>BVWTe(hGWJ>%JTrv
zoM(Rzx%rfr#ACub&Kv%P`%ZhwHQJTpjF(&|`^0?SIO`=hNKQ5)`^un|JRsz}5Sc(I
zo|)lM=R7Wl)d#evV$Q2zQZ!AFfWgx*c-)JR@H56m4>3BNJRuiP1k{?6OCHZewO(Od
z_IPkumCoC>pE9m^Nb2F_BT4%xVDbwjTbV2_c*eM@FV#?R$r_Vg6Op~Bd^u+4Q^s|w
z7e9S*uY#ET0?D3cz^-j%+@QX>)SKA;{05n5wVpC=dQGz7CdeT>5L$0}O^`#Hd=O3z
z=fywf@@?@D+DOJCY`w6M235-o3MznRN!l{k-OfD_@}6mrpYKt
zB21=CbbT~acDW-K+vL*Xc>d{Je@Je;1@26Hkp3_fNLs%VOQG9NOaF`WB6vtBo
zT<<4rZ)^n@4heZO=+%vMwfd=Qyi-G69b@{FLGPY0E5)5!35#m~girMrq(;Nxf@DZ6
z*H3-Ia8ts|Qk#VAfK*9USBVO;N~X+u0F_Q!H-J{jcYcKD$w=zfev@)l?5|pCL64%c
z)k?J*N;^~FdOQ_ASp86ls0*sQ2YYojA%X!Om!-Z-g!$zWed&w
zJc51l)^Q1*klhA8Vf4*g!k?@Qu(mPM`fpLs!fE^EE#V_p4GUkSm$W9Xf8J_A!?9Wt
zH-N-1Qt|`x7Atn%;K>8?)(p9dkA-L<2IVbTyKc=DM}`VxaNb%V!G&@bScNepZ;7yE
zt(TQ96~@rKB}#Q`n=EpvFoxwVSwC&DB4#GR;dyJn1UZ~x48ak3>xcwd5!0XG$h>t*
zf*jM(ncyhCNP-u|y`sVxowu$?@Vd!{9Tmoyymd>0xJ{%9j^!&Q*isgeR2bv(mTWy_
zb(8}vD~$1ZOEv_udRi=1s4ynvEm0m=I7Wz$XJXzGeZIwlmIeeT<*iW?9BnbHt}rI&
zt#J~>PeMv#O5U0z!O3!dLxnMw+Lz#TSprjGOr!QCINM^jTVYJ6_9Zx9PVquvMeR#)
zv7FFQVa%lVCCDgA*!@Re7tG1ab9<5?r0P+DWjz_-9lYYw}hn33ir~
z5-NQ{n`%WySnXzZkZCAgeJ7go>(-ym)ml`L_qiCaV5w}{(KO-tN*
z;%*T43F7up-4eH%xWzQ=uM@YII+wWZ#Pz0J-z07y6)$o4o|xN-d!D%c)V{>+C+-As
z2644C0f{?AoK(><;ttRbB<>h-BLOyX2WbovcZ#?ju*)079il}@+&SWI1J?4XhiMiP
zcS#P=s4$MuEF^eMTy!doqcjT%-YR3oL4|RQW+B0Q;*L{c9H&`G@Sz-xQDK~*S@0%{
z(;XTSJV~>VVC!lF^HKYmLOMEyuy3!nl;T
zHb`(|IlBZQujMT%9cyQ~>J?Y=R;>g%lHs-5myN4%E(u=XManKRi5fJ8nVB_|y(t5&
zIYNlA19Q0$F~yrwmF8S-HCI8t!Hcftt;_PLE9H1;RT$Uv)^!PTYD1XdjlA`t1n-x_
zxtba`;d*d*t6h*ehk*Z0v0uyEsyaieuh7<%VqYdd=6oSi5x-+FxRtji1eIsn?YzZt
z3nz%XL(d2*CEneu9l1eHQ|uuno1vJH(PzV(RP
zw#(aYLqz#F)VDf^lt)}@liLZLs!Q7)--*%!#LlXt`Bz@?^|<2%EN8~U?WcNZAf1
zQ_dl^_;d>8970&aua0sKsfD`Jd~%Ko8^1aqm4@=kpW$0OLu&3i)5k|ot$>;3qw7$m
zG26F}gcK8)<6Fl=Ve14REoC~_2P)^pd6cd`n_<3>;z2EqSwQKA)Oj@vDcF!YrDljtg>ZwyMmQrB#)F~IsD6o1M0PvBZ!0IuI;UhtT)l64Xe
znk0&mN)Zk#R|`?f9GRKQ__5BfM2@bUBNt?x3DL0D`<1c?5F+qxA>L)wcq|$zY>MHxQuM`D^ZxA2W|H&2g!=8
zu(89hoW-N+vb%(b*5&l)C_#4md{Wq)QichwzOlY^eVdDzlxZkf_#=UE~x0=V-`Y4wW
zoEsSje6kldN0&+3fcdaYDd7+Ll&q4p4*A>^uH4RzpXJ8Ge&r_73e-1__>?=tXBie-
zG!H)c!t>yH>%O_li
zwB{8j{K|s?wbb~eUwJBk-5URDzw&ZG3B;%U%DcRF3W>kWg)@F7j@KgKob@Z)bL!e?
zE=(tQ&aY(gJ_RoGfePb16-!XcY81C!@GD1{Q~)EMUy0APQs2q*F8P&QAPHw=|S#
z;cc?Q4Q~VQXebK(yBfX)yyq*0z$?HHH54z{`x<@|_<&6Egf9XgYFLe)?UA4QPh|+J
zDWu-O;{#8_Lh6SIyLcKFQa@rZz*mhHg;YA668lF=Gz}loG5nu23r`dVKgHFEXa0%W
zpiWPql;KJbt|t9YCitl*Q~N5Bvt^6GmW7n3{Oej3QYE$Ks&ygtE47Van?mZ>YVlRu
zLh3ilzph;&^{!fl)xMDWFQ#uFH#!tj?}byMbxA$ZiiqW~VJN(HcPXT>0g9chYa!K4>|_m%ZiN&!z&cIG@44E&kiyFMRZx!twgEK=^emvT#n{l$
z=v7FeT&&Y)NE7Z|NMXH8fcg|t*z97UzJ(OZLmSkukb-kXxVL{H1;0{?Csh@4$ACf#
z79@ReU;(Q!5)VF;g%pfOtZ;)1DU9fU4H{BNp)!09G_-(nn>ii3T@+Ho0&0Ka;RT+G
zd6nHR3MmZc&w@r4Qey(jv3*p5HlUVYjxMAylh@!@D&Oa-lELQ{4
z_yW3eH6TqWq%fk3GIe4Bql#JLR{FM-=Nd|!jOoSk3U66L=pI2?Oz+G3rY=Y9)?AjyQwR4
zIF(@DglyvSnS!$JneF6CKX{UPPA>PRY=xDdEu=(g`rp8F1!a=S0nZndp-8fQp^y@;
zDE8Ki8cGYf#7l|&C*WlbzXZIZIp*hqS2g?`@LEBc7Cqo~4aNL>LqmDn%|c4FvNA;6
zBDcT?z}p($2j0=}L*QKv?*Z=>Qli3@miM8CQj_-!N~hZp_&~#FfDh^1ST^O0A89CA
zuPLh7`M_ox%0h|e8qTH5v?!*gKCL)V%VKKU({Lb^ltpC}-3M%~p{z)3qoMfswbgJp
zu$_it)o-t%EFbMqOm+Ae&L?;m6jL2P20ukHSyZ~`mcY&$wg7g~usN`+hT`zpO+y*D
zyBAZf8mI^KC@KqWU#|DmPxCz*=s4Tk+f&DcUjp=}*
zGWCuE4lF7`M=~}@L&?}+4JBhkipq2+=AEG$egGV%;rlqC57*GVD{WPDct^NCqNwc1
zdEiJ5rKyb4P@2kU4W+4!DJpaGcYtFx6xKDasO-$8g~5f?fE=V&PWWo}U!2wDN>X(&x$eo+Y&Qi=;Sd>^>5
zsI0Z`0vBoc8{lFMg_A5PD#L;UT&iIPxU8rKqt}7Ui^|^c9p)`7id9Tvs$NE32pTJk
zRc|tv4jQY9Rd^ZzRu`*&&M+S|))cGWW|U`N;$qb=806WPxLEa$+Gk>YvFevl3
zclj17Q3lF;8vX?MVNp4S`~Y~rs7zT>st+`jQhli5cY%*Id=*$zQfY;$HPdi2ZMu1>
z`X!o4Q&v7PH7Hg8KKy^OiW5~Qr|OZ$@6@f>a~6HDeV!nzr%Cii5Zjd0VXlKIZ#n_5ZRlg2fw
z_61{d$^2zlFD+Og4-@;Mxm8je5i(d>-V7l#A+q!2l#=Pd+`ev1Et$EnIVWJ6M*{)#
zLclU{qA-W?8)sUy{D66y|7jL&*s{zs{GaE)JxZZ*Wftw4{jVFzLzWYBklz_%FO)Gy
zf6kazGTkuhjWWKn48f$#9E$qqdRdvcO-wJDe%L%)&Ti7L8Z%1fZm`s`GEXrsOzq$O@2Li9-5i(Es2!)12I;t)eUnn+DgzeE_WCa_Gp+0M@)-juj*}|`u-)VkbXw9=!%f?RF$XKIOo#e_rese75>Wz%G
zI#%v!q0?`qe%9&O?Zh6VG%oQkPa9xiM0nmV#Ze(oKsqa&Bt%&6mG?&zSN+$a@
za?LdFTWt7L-`FdoeV8uH3Un3&lyHm`=PnaZG2U3;*k9sWSU630uGf~#)+%J0oy!8Z
zh&do5ZJ3TPD-oHLH!u$Bn8AuSu~7fh#-S3LZ_)Bny2PSS7Y)1OQ^(89x47r9PBEDj
z$IHE+mE%UMF#
z$hiDRF%sLCyRPWi$>o72q`6vRsYw_YUXx`crn#;>(2_LQN;32_xGIOx>rXOl

literal 0
HcmV?d00001

diff --git a/OBJ/event_groups.d b/OBJ/event_groups.d
new file mode 100644
index 0000000..bf45428
--- /dev/null
+++ b/OBJ/event_groups.d
@@ -0,0 +1,56 @@
+..\obj\event_groups.o: ..\FreeRTOS\event_groups.c
+..\obj\event_groups.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\stdlib.h
+..\obj\event_groups.o: ..\FreeRTOS\include\FreeRTOS.h
+..\obj\event_groups.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\stddef.h
+..\obj\event_groups.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\stdint.h
+..\obj\event_groups.o: ..\FreeRTOS\include\FreeRTOSConfig.h
+..\obj\event_groups.o: ..\SYSTEM\sys\sys.h
+..\obj\event_groups.o: ..\USER\stm32f4xx.h
+..\obj\event_groups.o: ..\CORE\core_cm4.h
+..\obj\event_groups.o: ..\CORE\core_cmInstr.h
+..\obj\event_groups.o: ..\CORE\core_cmFunc.h
+..\obj\event_groups.o: ..\CORE\core_cm4_simd.h
+..\obj\event_groups.o: ..\USER\system_stm32f4xx.h
+..\obj\event_groups.o: ..\CORE\arm_math.h
+..\obj\event_groups.o: ..\CORE\core_cm4.h
+..\obj\event_groups.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\string.h
+..\obj\event_groups.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\math.h
+..\obj\event_groups.o: ..\USER\stm32f4xx_conf.h
+..\obj\event_groups.o: ..\FWLIB\inc\stm32f4xx_adc.h
+..\obj\event_groups.o: ..\USER\stm32f4xx.h
+..\obj\event_groups.o: ..\FWLIB\inc\stm32f4xx_crc.h
+..\obj\event_groups.o: ..\FWLIB\inc\stm32f4xx_dbgmcu.h
+..\obj\event_groups.o: ..\FWLIB\inc\stm32f4xx_dma.h
+..\obj\event_groups.o: ..\FWLIB\inc\stm32f4xx_exti.h
+..\obj\event_groups.o: ..\FWLIB\inc\stm32f4xx_flash.h
+..\obj\event_groups.o: ..\FWLIB\inc\stm32f4xx_gpio.h
+..\obj\event_groups.o: ..\FWLIB\inc\stm32f4xx_i2c.h
+..\obj\event_groups.o: ..\FWLIB\inc\stm32f4xx_iwdg.h
+..\obj\event_groups.o: ..\FWLIB\inc\stm32f4xx_pwr.h
+..\obj\event_groups.o: ..\FWLIB\inc\stm32f4xx_rcc.h
+..\obj\event_groups.o: ..\FWLIB\inc\stm32f4xx_rtc.h
+..\obj\event_groups.o: ..\FWLIB\inc\stm32f4xx_sdio.h
+..\obj\event_groups.o: ..\FWLIB\inc\stm32f4xx_spi.h
+..\obj\event_groups.o: ..\FWLIB\inc\stm32f4xx_syscfg.h
+..\obj\event_groups.o: ..\FWLIB\inc\stm32f4xx_tim.h
+..\obj\event_groups.o: ..\FWLIB\inc\stm32f4xx_usart.h
+..\obj\event_groups.o: ..\FWLIB\inc\stm32f4xx_wwdg.h
+..\obj\event_groups.o: ..\FWLIB\inc\misc.h
+..\obj\event_groups.o: ..\FWLIB\inc\stm32f4xx_cryp.h
+..\obj\event_groups.o: ..\FWLIB\inc\stm32f4xx_hash.h
+..\obj\event_groups.o: ..\FWLIB\inc\stm32f4xx_rng.h
+..\obj\event_groups.o: ..\FWLIB\inc\stm32f4xx_can.h
+..\obj\event_groups.o: ..\FWLIB\inc\stm32f4xx_dac.h
+..\obj\event_groups.o: ..\FWLIB\inc\stm32f4xx_dcmi.h
+..\obj\event_groups.o: ..\FWLIB\inc\stm32f4xx_fsmc.h
+..\obj\event_groups.o: ..\SYSTEM\usart\usart.h
+..\obj\event_groups.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\stdio.h
+..\obj\event_groups.o: ..\FreeRTOS\include\projdefs.h
+..\obj\event_groups.o: ..\FreeRTOS\include\portable.h
+..\obj\event_groups.o: ..\FreeRTOS\include\deprecated_definitions.h
+..\obj\event_groups.o: ..\FreeRTOS\portable\RVDS\ARM_CM4F\portmacro.h
+..\obj\event_groups.o: ..\FreeRTOS\include\mpu_wrappers.h
+..\obj\event_groups.o: ..\FreeRTOS\include\task.h
+..\obj\event_groups.o: ..\FreeRTOS\include\list.h
+..\obj\event_groups.o: ..\FreeRTOS\include\timers.h
+..\obj\event_groups.o: ..\FreeRTOS\include\event_groups.h
diff --git a/OBJ/event_groups.o b/OBJ/event_groups.o
new file mode 100644
index 0000000000000000000000000000000000000000..b6296f2b8fab29f4022ae35f1e639f2ae1a276bc
GIT binary patch
literal 556184
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ξEGHZ!pwpnRGE?@ePLhEmJN=T2q4|2gzv{Bkifd
zQ1_0+c!H5fWq>oqP$T2+IgleJndM%q<_q25&6#YoF)Fmz)<$HkZq
ziviIoT{9jikTl&}u+;+vqNZaCw|SsI)^vNpQ64A|HeFz_-2(;ErsJKCMk}jv*lRXj
z**-j}zPYDup3&C2u^HH^RZ1dET_CblaHYPh|j158Bu3hR#%LVzb{8a8Is;Km?{Gn4rVWUPq^G$cvC|odVmjRg8AEMQYl*2d
zJX9d_wG`Kx9x4zz4}{<8p#rIIpt#=Up#rgQB)-n_P=VYxQe0C#0@;sKT<5wdGXgcT#|evc<+xKPMg!SbD6aE8R3Q5*#dU#)3S?iU
zxGtnoq)rrD)*G$iHh-~gkVn&WNnO<=hZJ3mM~W`iBSjbUk)lhRmZD3GmZD30mZD2*
zmZD2rmZD2bmZF<>ED7i*LDPmMW9TPC(|#pm=qE)pSWU*zPmX5bnv9{JB+Vc;6@wYd
zCIS7Fag;A@zbdOIaL^=lqd?24IF-|&!P;~gY7!r%0eV&@$sH;uP=NU`+}l3S}=J*3!s8>!}R
zZ}X61^KGP>$i3Y|nnu@#su|rod}yqcNHK5%xetvO6LlW%@}co^qO!l+heivEr{VAM
zq0y4!3Hf_{Xtb!f`0w+f(X!(5zu$+(3QJAbKj1@SrKKkBAM~K6nYK$yslY=%G*((l
z2fpP)W2L2Z;M+blR$5929`>L($vaa2$#M27Iyn?p8d&agt8~2**b_p5<{xp
zT{R7f{D>H8?r1fd-d28@2mt2s4CCzIR}ij+PiS776^f}{n?!$Pn18UP)lcY>_^D}g
z8UbW`^?%9ftC-z!hh4&IvFcX=Hde$~G(x_99bjW+td_8z3b3(4R;yW02iRzx%%3lmMJ#Tu%+bu@Y3e@#YX5D?w#o-x7jjC8%`ctpPaC$iAKSdP~6=
z(~1)^%=2Hx%$`L|wW>{Q&p#o!Yqv~ut!KLkk({!zYiSDk9L*}C!O8PmYsyVYKPl5{
zrJ$U`5>)d2DPBw|sv~B%=|)JU#!B@8L*49Bxi52x=0yc>%(N;v*NeZ@7*szhu5=nQ
z{tRiGw-G-dr4;G-Qye#h^DrEi*rr`!06v*{x>EDRQ7C58JZ0%b*H;O0H6_4E3C%*OAbKlm_OsFB9yCCwC6axALuU9L4^ItDdfB~R3#
zYxsT50b<{T%VK<1RRq+){=fz{aG;9Mu7XnY`a>IvQE&pwMfHe{ZEh+juxza!b+M^<
z*^E5qV%v#$xn}>!#F^4Kvf^;w+^)0m>Hj}r6R|k
z5is++p$bk=Wu~Xf?Jcf~k%~|?2kxX*)DzfJ6D2eg)@ABQym6H(RnW!U>wK(PyKenR
z36p1q;+ry%G#VOIsn#YoY%J5-@5vg}Xm%(yFSd~lrH!NIF#?|A0=*d5RMuA4)z%Z|
zr>!a@i&P>bT|EQm<`O-^(J^e%2lkz-knSL8Oq*i)z(SYu;>K;?nAEq>qq%5Wxxdgt
zkL99i4gUiQUE*x!M~+f|64(Okf>w63WxosQ2a;nulW!(@z-(zn1_}-!@SqsQBLZ=n`pvj`^P@XbO~PF~YG8gnFRM#H@uX<~UojmaY6%G1O{
zTX<-6wl{0T{Fl3(`U%Z3C)FT-u5PoblZsLsRf_Q##<%zOdON$LQ=4C>!sB?{$@Bg9by#iwb6!WUt+<)vCk%SB)0wx6v*-
zy;TL#`O`qjz0F%3kujzO?nRLCL?T)eu9`E=>M;Fbp45Y+*<5Mv>`phDGm{u}D~)5I
zL!XfXiG-~-ws8@^UQ!!J_rI)88&_YPsyrgz@ww$LR;+5GP#%d0;Qpc_3%)rwAMwSY
zzWK!&Kw4+h8Q@9K4`cvol`{afo0nt&8D3@pS}D3T1ISdF0dPnDvJ4>8V+O#z_scVY
z%xD?_ciBIf0c0A?0Jxw2p$s5XUjk6wvJYnfneGyR>WqCP1DIJ#L8w`%k6H*{mTKzh
z3Jc*0lRE#9)s+^)lO~PnfcTh&@Wcr=2=Q?X;mH$h5aOx~k9FK|qj&@_-Vk&Q0OSr2
zB9%cy$TZ#QL8LZl2=(Ld@*rYgG=w_ucY6@AFd9NV_Io^t*cc5VD|oL55i6r1mj+W0_!v*XG%fd_kMSf-{1CkZJVBSOoPbUHc081*f#w}X<~VzOE>MU9YJq)m|GiNd#K_2t-(xH8X@_2
zhTJJnVc-!Wes2)%ZLbc=&l+;4Rj$aPR2Bn&$pE;`&5eLe<4HqYPml?^t1+aXYSXAw9Uz?lxflK=tUZ2)!LS?EfD
zZ2Eg_x+fu`pJUTK2@(ChhTd-0z4)m?xX`A1@e}=hLdRW}&AOKW0p2eFqI*R^^owk|
zR|G`A*rt2U5z#NV>0bKOTzydJxI(j8_i{jh4>v
zfK5*l)M#Jt06a+$;D!u9IrWN*5MRg;0C;@|0({W{cy*2dHyQw4mg&|A>Nb4MrhAek
z`qvGe?yrmhZgK#gq$!4*9e^h%0(?^d8zJgSB#B!bKqQGf1<-ADaBz6r$tHDt?s5Q|
zL%{t8Q0r`Vf{#$A=wU;iXiv%cg~~Ehf9MfIrt~*s&CE@KFpnBcyIOaf4A-j-G>M5Y+!)4bXa?g1ZU7S`@Q|cPFU?~Pd`o{Jq$DzgFwzeT!$_~mqfnz0
z=ZzFQNlEYqyOfBHOmjRoDxq|A2}(|}Dia(}i)jfyn3hP6&1E7=ShQV+MPte+u^&0_J6`J&dHNtGx#@6sn
zLoaz&VwYKe6TN!Tz*1FF1y?Uj_;#__8hXiNt90UKTHQoo&!ih3v&nPAW;S7NI8{pu
zCaJTF#qQ8cKDSyYWlfix#Q5C|*1~KIO^YKL#XciUlz%Q37l&T*b3|!o!YMBLfw^za
zGoH&kmgg4c3x~aCsQ7O~M?U<5gAZrHVm>_E*KR~zIP4X?ubp40g^R-;<6Z6ihQ(Jn
z>~(l^kd6k^{)NLf4h{X?3l)p*7WX#{VNaT@!Cis6btOI@!zb9|j<&@t!O_Ls^tVV9o)J(QJ?JKoFVl^y$N|zn_6h17gN2kP&ZZb$|BnU(INh6u_BzNV?mg&Z}$y#+&Om|&1tG8=z35C_Iw7hXAF?y+wkvgEqD>U13nTu(Z{fKCQdwBrzVxrO22VGFL
zgBOsio)^?}+c;WI2Da%%E
zQ@u@=Rvy>_WIwbKF!4d)y4dnC(l1V9NZ@@V0;qpX)mGnlAn*Y&{gZ;g`^LipCr!Pc
z3t}3TrMa*)$7W`lrh3%euNXSD{(3`*t*k6A;`BWiKCzzHK))cRN3nOCjdq=H|CR?X
z!t94G!hjQdzqPLtb*{j<^Rc1D}ml5!g7Z1isG<
z!T|#}sk`#jt?Ca1P}|z^0Loe5hX!DLokbIsyTK!ptJJL&ymFz#Ol+|Hvb9UE<&jO|
z|EVO1(&MtyY>EFVQq^n!KNBRT3~JdNlLgdm*UtqADZ$4rj8MBQ{6cVztq~9<3;up7
zpt4BRN>EGnR|eCXl-V^Kr9}H{L5)Y5A}?yB_mrSIM~PXMsQ8Lcb_#h~K&_*uqbT+*
zc}7sQ=fmfos-oJF^&5eqoiz&|k|x7=v&3%&Hr|QG#rwv7Cm?FGJ;AG}s2h!&ve5)V
zP21y940VGP~LQR`on
zrc^FUf|f$vb2v5yMK_VGg*FtCss
z#@+Y~7TQRSBOCdV4Ch-(jUp>~1+A(OgZ=m0m@ZgoE2&y$K5o+9v$gz~B#^Vu#t4XO
zwl)GPPTe!(datW<9$nYrBt%!-BptOiNuw&7B%)p>X;K-J0Jl8|Gw!qrAvtRoLYiqC
zBBZQ+2#Ho35fZa@BBWVuMM$*Ui;!x!86h=mH$s}#c7#OLe%!&;f!8F+CldqGE=`%~
z0~rF-OBc~l{rE{33_3F1o~n1eC~D!xr}eOSR26?3M$$shvcA=2A`%0!K{5P1jDfkQ
zjN|N{pw~4rLLq5Hf95KxT~5Af3lSWsnSqdL1Y`qub|Rq3etmjVAU4V|S<(0O3mnNS
zg(U;`c`Iytvb@#s+LE~-6kw;aIT8gmm?W<2f+!5v5V;mwG8S}`x!ArC#9~SfhlVt!
zt9>Hk`=Ur1UkoC$*%>S@Vv6GWN)Q)p8g|D_Qir4uLnY}@{2+)VUndZbb>fjA9M$M<
z75i{1ok)35B_gID55jSJnG`}br2LXL;A$zOze*e2pfN2JS^YQ&OS2gh<@)4I%OCZC
zRqF5{#b49)Q6|x0t~xwfpr3S;q^gu+Da%NpUE1iU!y29P3a@WKJJF~P^^L(K{oI15
z6|Zl~j=BZtVI%#nRpiEE{dZn9AVaT)0&?(JCgZ^)kPbn>LzIO~3*~5&Dx=E4m
zciqFR^Vp%T(5pR6Y1Ctgq`t)ijjr`PbID72QiR>a=m8x^tj?Jy7Pj?EGS`i2p
zKb^R5P{V3`iZ$$Pph`+AiRhe0h=`te`WK0%2$B&+y-*NQP@}9BLW7q84*VQpRkBmEV3%gyo
z7N1Yz^C^4+o7vpf%1kExXl|{_>1OnkPAZvf)45b5Fq00Tbc72i6^gHP0HYpYv{3v9
z2QcOV#tOw(Ie;}DU=5B-Z~$vPz}iCbpB%tC53sIKEIWYp9$Hy73~G#3=TpQ^TNAuyI8*}4B3#xgU%v$t4Xgl7~9i|EMuRBMLv
zK1)BtxZEJhF@ohgtb>!}FfcQ}5E-Su!_RPcW*SFaRa=;|JHWg3t&
zx!U~l;{NWoiMrd3pzg@LkCAB(t2?rw^TxwM?6zoaALhSYlKM%PqLZ5DJ&mZ5NL2m}f1D
zRF#h9S}q
zx){U+9EXF0gv4{9_|}ZJwb5=>w;QthNtc0`(2c4M;9unYXwlo-Tm=6npGSk4apFJ?
zq!4s*he5z>NF*!=VdR~(6i=v}#U&HTwi#VkrgLRTSRzo<6(Nb_l_Wx5Nt)s@NoG;y
zP+15`I*W{|8$2_W1Y+xVVQ!wA3?wzvpL~vU1$$3iOm!!Dj|BIn@F(4$R53iix|7_W
z{0wsaS$sZ+5A`Px@50nijg3xFFS=DxKJx!3hTvuX(XMraBS&fOdfZT@H=zwbH4YUa
zj_=<)yR_uC9yE5WLYFjVcyk*r9~h?aH*BDUr87lUT?r^SnuO>4e1b}jv~`MNnFRB=
zQ@q*OrkB55MkpK8g4PvZY1@6MG`VZa-8anMmaY`Z0IO-sJ5-|(E219ei@L#eRntlwD
z8uDTqKVpaHXQZF4V+2Mz&)J&|ltMR4;Wd5=Yw|e6iG>J0n+3;y=;xTrW1L7@J{!4$
z;!ZzxDz%`&MZaR{Ip`qQxyh+qADhL{#@0HY;law5cA|)0m+Q}kjpLjco`c-}n-c-<
zdfytbQOeT+rKHDau|WFIHI_Y@EUI%Sw6MeDgh>BX8-)1~EYo_%BpC0lg%B*$dl^_3
zaQB8_GxM0C$p?VU>Az-KhayncgHo`nX&7}_aYIa4l|zio31*c$#9&Gg9RC{;+S}We
z$t?pI-q%Oaf$b$(@RZ#f0yGRP5{lY&n!w{tLRp~x2HR&mZnHfUEF!m_o@IAXicu2K
z+lv-MP{PR2it-EOJ3M4mUD>tZG!Gf-Dq`fj>rVHOp`rrGH`ATrAtPD}C|^8xrUx}s
z;F&@L%J<5>(}QL+;SQGXjeD1e%_hVhY>i}fmWN$y&Wv!d6NEjRdfrqBo1r_y^hfoV
z_(8Yas_@82$o3G03&>K#5@e}d39{6y1li28C+KG8JVB>9bKSFxXO5=Ja{-VeDeXlp
zUP^^U60L9~+KU}rL}AH+5x5UHxQM!zlt;%U4lbgsCFQDrse_BDYDpchjJ;jDRYYEJ
znU5}e^`HyaWK)YKN|bVs5~b9mL@AOeQ5n&Xb9Ue*KiRI+@Yy*Nih9piWdO`=c>uC}
zR|^2$-T**LQrBdFFa~lz`-A{sy8IZ}HRxIkfOgr(@LsY{S{O87K89VBJ|&n++daO7
zP1|Rr!0MgYO#o_;1f-lHAKz;7S&1d;`A@dM2wNAr_Q*FR5>k|;1e_oxLn)y~LqQDD
z_Xwgyn4+pepz4bKWlGD{+=3CE-WkDrC2+g~3!X+;(Gls_Gje1|dXu5X#-yZS*b}Ch
zKnlb7u#x3&UC(sNIy(VH2BkhB88-7;P-@Z
zjF02}#!>RxM3{S%VZvF>F&*ZE|
zt4it7bf7>ZN>Y;^O9l#W_(BImrSzk8pgZN>ZDiOa}@y
z0-Yh1ryr*S1sYM3`t*}@pim>EKK(QuDAWk4Pd`fs3N=FN)6dg^LXD96^owMmu@S$W
zC`o<#Wjau(5mKLiC9R!mj`|NZ{boxygWe$0L&Yjl@v5%{lyUE0PMuY5Fqhl5Tq8^HIkL_fd%%7c#w#|%<|v0ksuL)
zk(&z-2tQ>Bj2Ih8U~Ufb1m+_11ZE+%z`n>?!46jT53cr>W^v%v3A4++onbZkl7poK
z>LNgznEHz37x7YdjkB&SQ(%$QT||g6po={YG^tZH`6e?~-aKAv_7>;%9>?d*hWqxZ
zG>E-hVsQT?3IeO$h_}Yza*~{>9So-#kK1DKaDyD-X@>3g7(6z8p|;}P5rYS(DNy7*
z^>$|r9`5@DoM++gioxYbVkfISEq8Ye9y3j9>gApoT+X7mV^>oz_r~C{Wgaz4e4h`8
zzeH#y$>>4q_xs?9$$D_C3830j?ExR&#w};TFu<$@J{W@sLqe30V&)+qKE9<%2?X4;
z0Rs2m@&gb$7(Fucl-Y0l@JeN>TJDq)s3wzoM*OB#c-RkBohk=eHf_RpBIqE;#(;h|
zh7Rh8v7g`b;W!5u+kgGyRm@P1zn=)u?d)s=NAa!`J%b3m!CGuz--<_FkdUZ`_h64RaOfXqRoDM-d%+#rx!*aMLjIeor=@BFQ
zHk3xjYsi~Fi!OM5jV>A7$DP>uGOvEI<7}ac0b}QDWT}_MyiYdC&8J`V8!*$fZZPJ5
zCGs5At%Y^yxv2(JHMz0)wU4f}wtHpESY@7{^3j{i?Wp}^>-@BjZbkOwBX+jU&-h?<
zgtDtPiWN4_zp=__w4eB}-vs|~n7g-v5-Iz?2p?lweAcP-q4?fRyRmgyjt$1e#2{Rp
zv5F&YnkFATh``>kG^oWtGlCB7CBbRg?41#GFwMqsQ+xle2s)TwV>C7QXGPG##2TS_
zb?xj3I+#%-G^^9QBk1@FI4jh9V(_R`Sf9>`!DC`kjs3Ykd>i&jMU<85EL}?L6(^lC
zAEL>?0eyZ19bug8G|(6LXmxgc5W6(T?~UTa_}SVb{tE-VbtOkuBZwPf=Y27FpfIKx
ze!maLX3%sqd{G1)$Wb*DVCCWnI>;yUO^koQM_ZSANH()3_>u_P=R~(xi2G6>4c~6J
zfUE}eG9O&^y8>40dASd!8vwjIr1_vselQ02=A)HFxG+Ct%o{9GKl29Xo6;B#w-~_4
zUL|Zu8wK+glsYLCw^3I|&>qi>Rp#v)AINk+o8;LWul^7(6T?u0nu+!H2_;
zr;XbeBj`Y}RAoloUkcFK9Zp8(sxAZlWgl(bT_b1(CK-O!s>uC&OXC|hY#6EF>~=UY
zSZ7W~dP_Gt@eb5eo}k#*4HWxroJU-LQyRd{@^&8_ag#8zzQYG&F~c>;TyK;D-syue
z(TaH=9}m-~@OK$JT`-
zMgM@iUkaB?fL95O^MAMxz%8cuq^5;okC&KBsf9tI^o>WA1&!Jsve|_fG0vXf`u8X#
z^{xGJD0VIt9Wi4(nk;t2XtKBwqsd}MjK+@skBHz$wLU8kOka^q0X*vC)eL{2ds4Zwp(6FofMcUCVh>$yTAq&6kwi$3no+WU)XFz$x;eF
znxo)MODH(g5(>_=gn~1T75w*H0K5q@;**IL$3pR08xnYBVsQ&+BWDm~-uI^*qkHZC
z=s>V~5TNL4xj#85tQ-U=y8i9Y845yh(AghYGOAX{B`%-&CnZ26IfWTgnn(5m2a$hm2&0!xNgg_S0A
zK_$tmkdkCwK*~~t`POBV46e&16&k~=rGVf+B7dO|!i-
z-VffdKAgPmaSfdx;9w?+rcApBwbP-~Zj&_lw({
z<>;+bi*Q}(ZpPj76AO!bW|zC8UMsB|Y3fD1*~jKg;=P4E&M0cMq1}l_3umhit1s@_
z$s_gPTn5Zl*J;S;8diEqqTJp-UD-^lxzx6*FG@t7SmoD~&AUK?3>Jcq!^5RKu#-9`
zrO{!^5NAO>yy^(doA4oc>NgToyHeC<4jpcEjR|L9@VDWcdQ|LF_34>Ttv#&2DFyS0
zIM-4;gd2MlSRJg{9@gIkHje_vE(}V%G}<*QcG_cv$`V^JG_@(~d5X$Yu-8aJ2tM4L
z;_T9wlom&-O`G=~KN0=sC4%j>a%-6WP#o$T3~r>{z{4LbOfAeWAJ={L?EK2?;(lOO
z=H{0z&ldRk8_-1Wn8gr9Gvo00H>j!E#T{~Ki;jo{eX|8A?_HeR?WRRD=HIX&Q?nj3
zw2}Rr7U0z@^F22TIsxq#2eI3WgRW4%)k2h4cCDD3+BB~;8GoCFY4`Rn_x2pqTXYj6
z0p4!G8atL3d=Sr)-C=>I7fuMHf*W9=c&CM`;+n7^LFhDY43<)zYD{-FV^ci-vTo=n
zoCzr>Lh3iBHry>ivA|m!rav4|Jy_w?3j|Z%Qt*gJ!EWpIj^8=EpL7LZt{{kexWHSe
z&Ps17fD!v}dbeQPdOPPMK++XBx?8}`aVv{qgrqR=ZMSd}i*rG;q&0A6w@~fb<(0(%
zN4f+5bsM)5=9Tn^@3~=Mt+u6F-afodeX}^tv#zMF;B@Y
z+!uZ8+L2;Ut64v&W{LFeT^Zj~vrET!rx#4)5N7f$4{Qm@&7L*kbG8?TI&4cWS~&&r
z^vt_G^wiw^%5pEj8#ki&c=&d22P|y_Pa%-qb3A-`x3s1@w;OSdZJ`=sy<>cK|pVo|Hxm7iXz;W6pDG3FZS9D&{kX*(=0_TV1UBj2qiv
z9+(^bWNSuO?(B%s`0^m!{i0%n-;&B>7~@Ni7&cV_?EiP}?y}}}5yug5UI}x2WtNxr
z$}y@mSg!&>TfOtEQh{)f!fl{>9&{AzwcfB9qF1pHclKwo9_JT!{_ru=}u&Qwi`-^dH-Nv38(
z!JjrR(TI7TFrjXfO0A4mduAM$xzM#7biYerziflyRv*+=-H<4gmqw}zdLUq#2OcP9
znHU}jEHlLefn{UIKw#O~F%Vd`b_@iTtyBYnWpl?sV6&ZSFtlu_8Vr3vg;+X}QXEi~
zs2Wi3<*}s3^PHi$#2epujLv9rd1M5ay3(x5&$*s$n?1favzMo&^mZsdjl(yvs-96p
z@Qa*azL`{^Xsq|koKSw_p+eEn55AQ!1#uRAd!<6rI1oOTUMRi~p;f~r=D2J++Ck#$
zCgE#5si*{U{||3yVwLrC9qdWqI$)GAiEE>@mC3<1Bcof-w!|&S=oFHXax7QT4Dv_gZz*zyv&0Gpy21
zU#7;{;w+I5uFP%DbcWRzOGX~GY}`y~sl+iVFa05MFl#&(#W_h8UXCV1%>@i+=a%<(
zty`hP(H%S;!w@(@+LwdsfFp^ET{+-J=E-4vSP=Z}NWo!3=Q9U|gee;zWu_{#yXTH+
z&+VG;sw<^WNGr${UV!P|u32oWiU#0e-j$LIUV-Yi>zk&B=?`Z^J?MOdT1h?hfl-@Z=a+=4=7=4>a~{4FL358C=+C*lC{4=I;((91
zmfA2RPr3dI^VQz7u&{g_lgYt-VP|)2bg8!^nVTCEp-Stbp{Twit*<9SZHNY7i
zb7l8ZZ>ihvEr-&i;zqdpbHcTHORX
z52K0G!csfkts5zEI|-*8hziqolem$7xjlOVTDvZWL#1%z2sai;?x(RJxPUGagzX=K
z{7g8+T=pc6<;CUO<*m3JYZzauom3B6I5Bp#T=H^+o%L#(%&P6gD^~T|-6NE#X!?%(o6NBGQ5Qy5;
zbSO&dFQO>amBJCvomPF*CUp1oH;dFfYZ;~FpoN+bxAH#_Uh+K<*yNWA?H#K#flSQp
zUPhVq>%pBK1{rOm)T5m~*f6AWW*B5mDhSn11bJ5&WJ5BDO66>JMWOOl#WYc$q)xf|
z;zE)~r;OZeYZ2xlb#4bh>P!xR)On*KdB2r&&M}N1`Da)|+p*F0>*C{765Yl9BPgvK
z+YlYHLi&i|lKwGlpu?7}>qpeETyHbDtbh15BO7Dmb9GMB2m6N~9a$5T01P4c|8W2C
zrIDz+2_|n5{-gcF#}87)5Cg%l>>oUSW-F$05&Ywx9=D;+lW3Q^6Rp~7hUt$|W`6jG
zf5<9up0|WK(-c|DXY1$_+i53avZRU&#%-y&)Bv2G`*H
zCQoAiCq<@-iaEgQVqiaS5m{O(NcX0Zof?5Om!u?e1^}%R>Rj%SR`z1(X2P`KE)%6&Et;)tBohBKQd7((!-NFm5KhlDzvo
z#MpN*DhI!2j?_S&TpqjVzt2|}aoJg<1yuFmDL+VaW$8E!_Po_iQ7XX?x(s5R=&Yy!Ax@Gf)%-K_);@0T*k#(cGb^@$E${aYem!O#Q3PhRtHdp=kYJ;ZpM8#_jX6Yb#%9>~&Pe|6yO7f`js(IMSx
zD>&9rRTGHg-4@DUc~l@81H8vV#X3G}Bk4I7Dqb&Xa{pWl743!bO#XQm%3otve36US
z`4%eHp&A*X$^8o~l)rwg;vxsH_gbjXQV@=2moKzX{@SpLi#!D1XQ6_XUP|&;bI#Wmp|=e_<#+I7XWQ#xWtCVOMoWzFSTLOB4BUG%WPP*4A>p=
zavK&c1onsgpbd+b0+#J?E}2vqRDxlA*p~3OHW9jV=-L-jWL+_&NY5yw$a-N&kq%f$
zk@eh=BAvsKA}h5aMLLHeMb=eRYlaWwqNto5ONT{?d%(;<~
zP#dW^_zJ6%_Q4;o2ge_&%1WKPuR6#|a5|AflC`{1^scY_eU`4)LC^PI=#?t*dYj^4
zvb?E_j%9hW8J_bc9h%!SD0jI+BzqJg(mO0Md+Q0}5Zf7K>yE53enb;9p
zdVBrd8Lm9p8jnSYP7Wfx#{rgOKs9c^Hv`tEqo;T2lXLFNfUR~cKF9_M-=D!KzILp;
z!^Z7_4A|ZrDHPHSYC9gxa1hP5Xv*C9J(K}SHVGuHuYb!ymJ>))%5RHO=G?7F9R}L*
z)a{Tah)Uvx>5Xe@nnq=w49EqYM=htra*-y(q8yVnmUWV<1e`~PRFh;?xsqgEO_Ov|
z7pmDml)_10`xtRpRNG(l7D969q=oj8kt*0l1LwOpBAFkvw%}5Wm@-p87MPz124V{}
zUJsLhDjbL}dE%C>%3_<;2>FNTP>q69P2sHYhWSAm|E36w6YaQv$
zGs2E{r3Ys^tua<^t0Ux`k;v_zS?JZdU31H`yLkn)vM_(_+%6u_R~BX$mwMJ)EERdE?NF4<{3z?JCT6K+^m2(*F4!
z$6m+bbtJu=pIf#!I{xF(ksn{B0FfCyyZ#O0P4xy3p7f;B
z_M0!tQ(^eL$b=h}7pq$J)CSG?PAMK`jxb1VKH+$!)LJJWf6&qxl&#`!HE}Ym~#6o_rZ_dt*hDv5m^^ni=
zGN-QMrDgfZVt&SQz?IIQSP0nEr54ss|~aj6t2hIC;%6x#SJUP@!I}_}e_Yxbwu>#oom3
zg%i;tE-x-%e^npXziZM#Q^l)0Tc0pl#acpjTN$nm6S#1>3*Y!o3r=hLo3n17CHFb3
z>iiBABrEpoRX&vREW?&s_k@LBc{haU_z;`sYrbGIsx`PndsgAXsW+|aC&`-2f+(*-
z$1u}Wf;TIM&`YaST9t`%eKM-HG-CROfmZXNGz|NufmX=t6qDG|Sg9j>i-A`2pfp~*
z)j&H(%}iHotyU~n9)jLxpsk}CTN6kg)!uH9*gVy$O-JW3cr*GPHnLrtj^>G-5brcd
zY~w7)<5Xkxy9~138Lz`ZA(ka&)$TUX>Ud>KJW^%c?=eU^$GQ^ZQ<;~04X|@m6sL{L
zeFoQx<8%Xgzrl5mny61SHrK)e(v|oD18pg2Wc05`U=JFoiZw(Mn`BrYGDsC^h$Kb{
z`7MJ~afXZ%pM?CjL8>@IB(X`zhYhlGRJFV{s7TBu0l#B_ttgP0B;a=qkeZ%)P>{?c
z0l#N}m0Dcmm`Q?u-x!r_EXc#7ms%ra8ah+1kS`hvSx5NMP{|ocF%9uPY2u|#h;>xY
zqlWn}*DP*1EH&+2m|yB)pK7QmoO+@7lm~4ex3IVzLvzGWd+5o9xHmmt
zv-^x;8CyJ?jcMG#C=c9tWIx1wS`2IZnuB3Z`@@JuvcxA1asOi5?A&smJl<%*LXCjX
zlwo<31#9-^cSarm9fU66s|t5DRoy*C4`iIf#Ch6dCJeExmIovQk4Rmm(_^
zA%%~*`JhRh8ny0ZZF&>V-cVn}g*>TsSGexdKQMij${9v}v*WuLb{yZHdtGkt`05yb
zG}7}WRY&~S#PHERwVKBML<}G6S<`)vi2vFc9{a9hrNlPqld%9}@f@tB6h0LTur8j3
zbrj&!u>iQnI?B^}3h|j(2zVz&LvSDFv#}6xfr^IUThl)m3qg)n(I9+%`sZUo$e$}3
zgs)M*E*6B`#-c&k&R-u3Lf&c7AbhL(4Y45X1s4s&x2u1_RFH9=9%$EJi{3i^a2-_-
zVr~4|psQ;hXjBGdc_1@t%L8HTrY~4y<`O)u8w3Tl9w090@&G7O-~nKywFAINRR@5v
zehz?Rr5pgqnm7QC)o%ct(m867?o%q+S)83;I<~i1om=d77AhEd#|#m-PWQ(`P*Wcb
zLF2Xuj0$&J<>~eW+}o@57LEyRu@3XMs7uI*&Q1=B5~sZUz~yXe0TU+NI7B%k1NOs6
zi1zYgZ+1^K2(`P9gqfk6QgB?9o)=LMetwu46}8S#4vv|o9Q{o3R~@8p^K%QE?AxGq
zL$tpzd7zkw>5nQ2r*FflI(-`jl&mq`>f8KIF~EzLeTV(Ox4?Y|{?A(AzC-^%Sm3^c
z|36ybzQg}NS>S#X0Drcy{iXo^;$m|r0Zv-Qy=oS6ziEIsTG+l50dKOv{iXs=wy=FB
z15UA^`O^WXTFCqffj3*ozEc8kvA}&N1>S0b`%MeH&BFGZ74h!3Fa^N%z
z+h=;`|XbnVXtP?b*ubUjZ4q;jVbx<;n~sv4*1TzAuCuCQsc)Y3FU
zs%9FY>thR6htDps1VYEzmnRfyXDkC@sLb5}9`D4DATO|Okj
zOwc5(H@&8+PjrIq3X@9I*Me)LHI1)Xr+FFa27oFJc%16hLqDvZpO1(2>Yo?Zt$QBP
zt#={Os&gLEt#2ODt7{(Bt!Ez5sbe0^u3sL>u3H|-t5+V?t5Y7;txq1&txF!!tw$cw
ztwSEssXrdgsXHFcsW%?Yt}}e^3+t@!suP`zj@K57KU!CASB+h(H@lN&F1brjx)PtH
zqw&QZkr1g(S=2GV)6~XRt&BxT)UCY1g~JKr)pf`nSvVkO7uIEU;VAZdn8IIpmK^jS
z-~myjqqXVx%U*W$#5SC?e)Qb@j-w0sHG}&HjxH3ImiLT}9=m4WzV6b_xrLV1e
zdHZ7ZHnQX_2%OQ5UYj~U9d~YsOU&OCn*82zHhQK|+`Q_@i&y`R3R7O(wX&x-zbsJ+
z=X-Y6=Xdt@$!pEFEL_NI%`jCCd8N6fS#f!FsOF@n67f+Y4&SdB
zD*mhTf};xbReWy5=WFY!~o}7$aVTUsS>P;L!O|2~MIMX%TeJhjh
z?pv8~ci*mw#vmI3T3;2E2F)A%V9o27$X8Q
z#pm{u&_`ppqFRvwlael?c{?xh+0o?7CKc6l%EOtIIPyeE<}1!15`ile@_}i;9xj&0
zVIiZFb2vA=JArM4)fJq#uuo5fmDY8a|6XmthXBrthidI>%$rl;B?QKb2ywm_qD1L*
z%_Ywotk>o*h=R>6(i%)BZzAURN?~Azu!g=S?gmMsGP>Q=x33t>Hq16OBtDGOy1f=<)j0&BnZIacjW&wPR@*evlGg85^
zVO^YA5|z=HGKh8BS;i?%T7OwMrI@h%tIsS`4?1N@L~|C>D0Y$|+>xM6mFDJhw`83-
zlch)!gd>uGMx!9=A>Nj;wYdzoHp6!vwpcwFwj>?H7{P2RCqSIRV+M&%x6u|Y94j6W
z!k1dhho_8&P@f|z(1(O8L^O;K^TgjeQAt2EVRK&s1@Q0`7gsay|CG;bZgxL9`}ETe!9Kp6U5k3VqfP0TGWEsw)%
zXR1B!7cv{%Kf18V5XLL+f0DADsN8R8OcyZeajH_K(dCy
zZ<|p;$)vs2gZb^fb}M>Y22;&n5S_9_Z})LQeClkUchLG4GZ
z3%BYTvoO4(BLc|cJZ2t;vf}2G#hu;eadS9fb?;KNY|nSG5fxw~b%6_ur~q4=_qwoV
zWy*GU%S-{47@UDnuo;(?Da+Z-K-p*FeIjLe3{O|#G)+##{J`3k{eX(Ok?O2#v8I8@
zcV7%Cr1m>7sRs$_91j8%$GMNPAgKSLw+Cm=IYtbu<5xt07;eBjtrs?y)P!H@2grO`
zvY5$J`(r*ZbN9)BbU?$$r6j0tlz$x=6@;59Efi}{bcm7s^u;18eKF+S0j59CxtqeY
zl|H`IS+tf6s)~P|k98gW1gwnC^&$<5yPJD*DdjZaKxaS&>3XU57am=ELg
z)8PJdyspvgrjOr>shd3D#&r&Eqdwc{W)HSzg9BTm2T0%WVQXC28s)C}O%FEaGB>7q
zyTyZzy0Fnv+&6&&yVZl0+$@xI7I4D=q-u$zTv)K|YtN*vu6OnkX#nCa8Za0{2q*M{Tu&35YCEjSpubSg?*VWKXm)JK|m5X}y0
z^TW)k3<#n|{W}>XI_jXF*mor-6jNl>K`crlnm04*FfS%mGIXLu56c3m}VDG@28jv3=Hb?82`@C
z?xyjGb!e^Bai!T$N70y%G)L7+>NR#3eMVTPfk>SWQlBnQ!hu{paC?>g&|RVkFIwb%
zq09)W1zbC5OxME6Tr!iQZ^EM*1!oRTH4?Wj2Ye$h1}MNVqF^rhTQjJl6*VA$MNpj%
zI36H^YylLTc;J^&C8b<5=;P*7)$V|166PKEFVeYJ7niV@~&1oJ;O^2Mr
z?2zJO0i<)3Y>rT}Sx;@~xi+G8)U*p>ch>W4NVWw=MZyN{{8c&$40?2p)l_PIFR;UR
z>JzOAH<7heUoRAiaOI2bhSze)G9x;KKDbMxY$S=u0O`}kHdBqQ9@}&b(+3oS7mj47
zip~|8-AjZFr@5G8zgy
zA_9|?vc`5WmCr~Rr92RkOUp{!eNXx?WyEDo+4_W$HoKfydM4IL8OCc}T&A%ZjGC!W
zvc7Rt6@W~F_S%q-eGEroeDNa{qKvMgr
zNR65e^e(nfH>T=n1hYpn;r1_dnMU@JwY`VSHS0tOhvrS8c&`mXE8{_0``~J+Ma>J#(`-5kxUdjs*ze
zEY3e&D9#KW`K{H59!@6H&PajZ$V`{SF~o1P84`KFT7@^W74rTdes4y*;w*45zqaLp
z14)Pjhq-%;#RWN!FmRqJ9J0+m(q;#&zK3So*Ewnw!PtHf~DY(c9FlH{|Fi
z)z{9%vhJ^pz$#9Ec!YW{{}6#yT^MznUloB#M@J`0y_|oHz@&?!Vbopy
zrwDA5n<#a9%MqB|u(}%?b+0NB*sEO_9Y2b_$U!M=aba})=mZAM3fXAk
z`j5s8dTeNBTR8oV9(mkk|3sfB60san)gLL-q5Y8x{9l#nv_3*#A2w7Ov2&#fwD}_@zeO4o=_Wf5k4q5ut2&#CqE<(fzXZH32XCe3IT+(ImV+_to;eufPL_i)OQJa#
z<7$?Jk#l%)xVlIp$h(|En};!rt~v3@DZP2|U>H4spa+q(Im0(Mxj|%Y&h^cWX)T$e
zHx=8e-!RqNv#_|o)!Q?>w~G$@(s6DpMMml57`DA1zDRo_A;?Ib5)IKRPq~qkEjl#{
zg{OgsC9Cw-7B-U!!2`DI6n}6rkD#qc6LXvJ5`sCN_hO!$8y58QUR$5ud)Ql
zY1XRsvYH;BD5ICc^W5~rGPHhWa*VU8b3JGXViE$d&Z}&o7mNYO0sE!zU)pi(uK4f{
zW4qsR-x_}kt6$_exf?I`?vljtJR06nhWX6HTkw4=KDXf$_$Ff?ju~LEV$h4e&dC57
z`4ax{!VQ{=v532GD&-Obp
zV)i>+!hwi?S;V_;qry&f*yxhowk=B~YSHyqHm(dW{m}87mwSF~_+;ujcab3k};J*@jB}>9!iE)2E|7O{YJ#tsHEKU199kHgmJ6007?!y
z01-eAMCIIb-Lul59OncFnXC36vz$#uP64qZRE3-q<-eC)sX>n;cR0cA=_HmQ@M;n*F&A-+Z#@|ajo9o-tt^b<9UAb407tw(dH_ZooZD43Xmm7
z_47RDq;lNs{CsaWu2)kRQ5vmg4$gNlf#&nBjSC!%%qV2>&=kmf9gIvVWEh&8V0TN(
zEiSv8p02?=NPV*zGSA8qbq(7(yD7SutQ1|kGbuWs;dY6X1F8fT0sgA&A>)@x^pyrK
zsjN-mtb{U#dVk$?l**^FIYtU`l`5nyRh(Y5HLed=+YnzJ)XMiYHpDM!
zoNTsoDf73Ku;xP-aD*gf8zFJA-Jm#GSfN2C*UOo`Q7!*M0IV*YDEHDCCFMrwivhHP
z-K4$6^6t4^^Szyc)VMwRQhp#`jyRwZrSawbKtVm@w(2WJvW*$?{mQc%6-O{Jvtc7h
zBKIDp17Kz0@`n7YNNOb?y|mxXi|GMvuC
z6Is0cS;8DYs%2BEzrf)IPCKb&ggDj%uNd686Nu%@BG}MWYFGKoUB1PR^)Z6XpUsHQg#3Gx0-U;YzHzvdt
zz_pOqdpN&4p?X+1cqqUBpgLJ!@KAn-LG2{_qR55MUY)FMMZcT>a%I;~y2?2GYZ0Un
zGO$e1rM*wlxrM)lv(RX_>&hrcEt=YXf2#-0(}mk4&lGc?^7j*umV5@X%KQQ0sFlOK
z+FJgg2hC&tA&dD|f99RUQ_O3S#rz|Rqe^|}?w(>lyRcYPRw?770Wz{l0k)GY(PM`9
zO1(N+>&LyDdYpL+WA-HcLbEiT$Gxf~zYL*i_J5VJKRpotE(3`SSRj*wKQLSMtZS=o
zLy8Vw{^(=f`R7z@yX}l&yrzSOEKkrT7rOQoofkhS^^6ww>W9f
z7U^wkt78F$S?WH&Z8f$3^$IS`(kFW;-@Z;gkP`KH-VwlY-VYxN5(z*rjes-02ZDoZ64&`UJI!__J-WZZ
z1^MlYx-();kT}I;g5wDvOK@fzd+vUGC1uHjsFt&--GN9eV`8_}Pf5Zo
z&81`EN&k6IHU03Z_!=TW(eTuE+p!;a-^m{PtQ2_G1|!kUURNeB1yU
z;(TDF&XW;W381q$w`*5$5{sIAxLQEmVe>P~dm*kdrDrb3w9lZ^iPD8AEOdRej=CsQ
zpFpSIK|QaP$fA2|xJ*Uzy43X^8BKz~6YoU@e7sEj`R_#^y!Q=pba3Bm8Aj7)(NW#|
zDhm^P3C3q}X-lOQ>IOBAH+ra0LCB7M%|XGhqU9G3`?7xBfmQ3Z5Jsl!CI{9IK{O`2
z*#Xryg(z~R`-X$6RHh=?B!{|h2Ds562jo_Fi-(KkfF?X{bz$aqDWmfva4yqL?0J3d&Iw+hL9u_(|+uh~ELSc}@-Q7McG!Eo+caIN?
zn}~ZI*m$)QlqeSPu%zq2a0IF^H24T$UyFlkgdozh2c&wV5_HGQxG{+S@DM{i=yuMk
zBf3f@$Wp7LWU3W;!Kpgr(c8IHRDis|toi)_qxpb*_A2HmT68EQ8<2!mLk)!C?ug
z_|L||Y)FM!&td)$3$rm5Mvb8V7zP=$S8tes$~xJ=V+j$DvWcWzeEEi
zb)mw6PI>`#Zpb9sYMNArDhGOFG*D6-Y8>cI(LhOcpe`L8YNLTt`k<#zPl*OfDFlwv
zpp;If>&dk&!V9#_4O&(kVhc=kK-&emZ!3<@%5flgR)Pb;v$7iqo|W1_@T|NBf@dW)
z5IifRf#6wv9SCk!)xq#tEgcMhfCXDRz>+N;V9}Niuxv{QSh%GFEZve-yr^*(Ni~g+
zc2%{!*nq;}u4>IbU?KdDt!jrZu@HWrR$2B-Eri#d)i&j_4B-!X!3G(S%MBtr=GBV|
zAGFPk-o_@oG~fs~EYB}hH-73-!G;l>ze0;j&Hz`i`urDg0XD8?HfsBpJFQJLhml$Z
zxW>c5zrmB9&iN-opeG_NfNMjbHzk9v1WD?XA_MI38SsomGR#h%bcGD(Trw2pXfT-c
z2K&UuQ#4=VTz2SCm6mKv%f@b$y)RpcU_i#xCttA;p3pIcLvei7Lij4Hu0Fg`5S@By
zqFa+aq=prC@A#SxGIwPf44>cf^$asQ(G1vOkB^%KQ|q*XMJ4u3yjjY$)2eUU1fLKy
z8QFJ|Qp-{ol?i8N(G*=q1Sz@{b&4({f+$_fFpmX-G;^8g)JcAMagg+=j@~K4k|U71
z|9+(gb{|%yU*Cti#fM5^|8_}j%tVhVP;u6(@8pJwYuR^m!;}&_{y2xy)n2@G>hmY`
z7MJ~_1NC`mPsBn@FU-dS>1CxSrOeo94d%9!U`mXVarx2RL=SFpL`w4%a}AT;>g`^b
z-Kky8qSM4=L7tAl>wEUleyGI6@-vb{V+OGiY_d_VVh0#~@l1+5YL;W{=WlLvk2+6I
z)Q*#G9#D9o484O{tj+Jhi4V#rFj7tU4#CqR$e?oYWb5e>WGRI5T9M?qHeJEdt-1br
z9+SH490xfUA_gu8f+;%);R40*3GiIhwjyUyXiM2$
z`u!24*T;ds7}ctaLZsgv)GheM0W#Vx#BvwK`+)$RUK6>*6z^6z@yfnu=?tbjk?~a$
z3FmYouVi*qdFjI2w0q&0+1-8(
z$XCyFcQQ6DSBbA{wkB||L5h9S`I~H99`842yib&IqIDmC!HSh|f@?-tEZ?J9;p2=F
zJo6ggy$&#s>H9LK)oEw_xVFK=2$shNKMJvHB3K?JJT3)D;_YAY
z{X&o;bZfnZ(jKa68-f@VZ5%9^5`Ev;AoW2o$m{?xlJx*E67v8sk}z4e-?H%emJ#j{
z#&wk}!|y!gCUgVCleKA)_4gh!(Qb{tYS@N%Rj
z;`BK(2xlc9qVtdsGR%`?-||B0W~!s-v!vn`oXyx
zu#-ecI)_$E(jemmO$#_pg>fFr-;UzMjkMIB15G{2-n(>_|V{!HY7eK_>>Ka
z4+cJMK@y{Y&t#B<8D%~GYz9mB`#+a~koBO}soC()+n~_^r0VZ=HfSsWsrq}p4O-)a
z^yKgjQUh`hkoAgH8!bBa)AV`y3{Ye$hbH6BSU8#6i_v6mH$pS+Rw2!8FG9L-SuAL2BpKFPb1f8q9t~Vd2hJ8?3&meV1E*E0Wb4!~qk+>(Wi8DX
zioc2mPOFu*PFpDcIvO~wSk|H~=6s`p)2d~y;9>?i8aS<7)^aX36h;H5)yrDjr4y+B
zKbLpCRW`Pn>>F?#qc~jeCo*G4!!trvbg3pKRG(Lz^|=M%t9Da
z_}=2&!cI9*ceMi3&C0macy0;DPzd~BCduIq3-dZgx%T))g(fAB!#8^5VC)>gi_?Lp
zR~`8fZa*f7I*Uc3RqUzFcD%<&2#P&LQ2R@TqL^&1>|Qb#2`lEZUC;tmGHF!Io?#*U
zN6m`aoFjxoH6hy&Bb38b4jUCGZ|4+oE%A{*eZh-3oIVgjf~d@8dq?EG%A2)qL$ma4dooyu0;Dt@?^Bd=5$@GIGbDI_HvZ)>6uabz>81vynZl09e@E^MWGO!qzC
zfzO@z+=WkYrrJ!qj5B{XA5mEK(xKJGc?_D>o4&`YF-$s@*0EXqUOJTid+AKt?~%Ur
zBfZyhGLik7*o_>pHiOrZ6V~W8dlt}D)+%GA(J^yIl0=MYae2gW@~@UN#VfjpClyuN
z+ZGmgYH!uV?XzzTksFV3NAG%ca55e0qoZxKs`+kpk>qtZ*z%?eKpXiMw9_?9?d65N
zIQV`kanQ^eK5V2br^@Py1I_rEKF}LRYLAz9`mmB8pZ0ipS0;#dr_scnkZoM^ryh8+
zAp0SOi`xSwFIo(F7-VDsl&E}OOvnO_FW#rK)>NlnOfR?vtQW=K@1km0?DKGHzPz?QO1Y}s#Iafh=OsUjF1Bk0W5HLiUzCyF9rc&jqDKn?U
z2N7LqWBePQ^di#7vV72#WpFZg^UH<H$E>6}0~L)|Mh)B=S0Oiq|e5JpWud^RTx
z(&>iblzaK-GKp=*9hlp29U7*B8r$d)+D?luaZ}%1Sl{GCKXNrfY7>Bv_$FewhC%dC_mHUO1^r7NQuvo&t{V5PsT^km=9b73f
zAH684MDGXBi0USC5h7nCZnTnbDmQn8KdBR+#1byuNSwDa@M8}fEq7H*`POO0&m;nGQUoxx#Hj&0s>Duh{-gh6u0kT0cr_K)UU`o(>e&oMTj@Q_no(L8`$LAA9QVB_H>@Fs{+K~R
z`?YZ$?dtne2FdP&GiG}osr{cb2(cV&H5_BqUow=rj!)tlWyDECs{X-z%Ke|m86ncP67
zAP~F0d^XDz66>mit*W&Sj=30Q_?Ti)XEzv0#_=T{RDMg?QUgTfY2
zbu#XsWYtCD6
zyu>L1>VfTM_TyDY;7pO1A~g%}$|Kfen=+jpiR$&kEUt33ij!U1!}^|@?*`^CT)cVOZo}R<~9V<(-i_3`>6x`o&ME|=PC5GqI3d&il4n17e
zKe;PWRz(W>eKz$ebJwdiMdsq<{XzP@nqiW+2kW=gSjf8<>35MC3V~pPT$^xQYueer
zw^!{QTR7}Dh2m>g9eK)XiIfNJ5=1z*uSOiwDbc7?aKgVH^U3RjBt?$YnU%kySUeV!
z@-!!Z4?g$eb00pzocy+J)$At4SMV>hs9|Pb!%KEv=^
zA!XB{gXB2>5gjH4mUEbL4}$XIH46z6m^*?VNTyiL9-0`)tR>{d#A^Z-;donpx{B$r
zt>wv?+A#km)1e>OcC05SkE-A+>S$)noAD9NY}?E;Ur7wdBW2#qYl+6WLud-6{~T=4
zi6`z%+#tkjxKFcA;ZOPwAsxf>$OI`#79PO&gZMmzkFHl!b?nrY1+J~rTjA8R6&>u(
z>@nT!dM~ZdwDv&%P}YFvgJY%@v#F^c_
zm4tAz)E*wgAt#&I`nk0+-KK*IkoV8*Fqp|&ty#qfT1->i`VvB#k=f~B8q>9-
z>KzwFM*{UEKaR^$@2vEGCHBc>fEJuKzIaEiYoDczu&!Ub|O|0&V06nv*X50TCkzKP@Z_x4M-A%0q
z#*h4$MX8@enqI!O#BxDmEptI)EptJ#Ae#%~v-sagGs{W{ty*mg>&^`vP_FX`Q?D{h
z8O)wvNw>38W#Yw34&0s@A2`&hCP{3xZ`V4*>Wk8lCrSa85X(H&yDOeq#07YrIn4WG
z8?D}AvKfz<5I(_cx;V(h1RV(W&O|6(F{Hk$>Q1$YmmG0T9}XejLMi3%wurN&%h}pU
z5yvs>s3oflbes69LIr;ZZZr1GE$xVRR?$~I4ben>eRQbjQR{Hz(?hEdXZ@?UUSk|h
zUJd~a{awK)ps&^2vzM-sk*X<eRJLCt*5eGWn-xJn{5Tr&_}u)D^k=+pThx
zi8EpWD&sN};s&72hVSwMZ}Mp5r2u|e~*VRr!z2088|0`PsGp5J?F;o=Ab_(
zzr0=Tya;|vZ-2~&jS>InNAQ~}a^h$fKlgHgzaWCgQF%f9gs1o~B;##ViI?h0G1SZ&
z=54Ycwl+D+VCj>YkTZIhAt6Pz0U{?#UHbiFBp^korq^>~)a5-GaNrm#=5)M1Nuy{7
zOB!W57!ZX?HS;P}&duZKs8brg1|`hxAdpwv$jxwa!|W{=Po>pGs<@qEs=2v4g54)J
zusOS*j#!8wONHVmY~;k;Jmz?V7;(mpQ7sI|aTF#0WecUBM5D4yXc0u|iuF8%<~a|-
z%#!@Rq_R+*U7n@+hVIyCFd5HQ`O6-zv@XE$_LZ-AxX^Kohu>fIVBrz~Z_B#Th>m8)
zI@_Byo+6_M7NET4&OVFY&WIL34hXqWbukCCp+7_|65OHk1XXX(y{^|SjfQz=QQqm{
zHU=WsGwm*JbZsDVHEn;l5z?00_ICZXwPF3uA~MgSWj22*^JxfJ>jNRKNRJ*?%+h>o
zcYLP3T~|YEy!U+zQJ<)ZDb}MsIt}0l4q{sN5^4mE^nPd~rdxIKR#K2rf;?hD8WU!k
zUq?c{hQ}Pl#Eio#HwHhl5i@XB_0l0`pEOd>+3&sCv^1l&ez|
zy;_UVsf%>_5XY$3pULplr$gDC5ulL13nLMoNh<;-zWfE~l$@;9XO^D5e()UU?x^n_
zACd9g-QQw?B046^?*G;?JfB8q_YNI;I2V;3&SZ-R=B=9d-_9ep)e0;vlb{b)ueCXr
zw^#w-NSvAYX9~sg(2*ZoeS`@zGTA$JS;7>u*R8o-$C>v!VWd#9;aS2Z2mWFc&8Q96
zc||Ov4*YKne9VUbr|h)@|683g#N*^`cd^(UI`Ts=(8<)d#1nm%(tiva+~{(~00bd+gjUPp-sLOWv83M_T4xmTrdA!X#b{
zP9$kXCqlGh69Ja8$o^K#)QU?~VKhViXN?-oQXJN=#xm6ZC9g8n$f~16T3VK=QB`nxr&o{9lLeFD^uE?M$C?(JJH9QNg*;u01X@sH*RzK75E@%aHh
z!5jfP#GB0=!7TrxN|jwz(%xM5rc9|n4}*D396UO@<_M;sP-#rkMK^s%0=jmc1I2W6
z1UOY)>!4_aa4c-Kf+7WTiXe{>%`fhJ5eL>AG;5I*D2uwK8WfLQ9%zWQvJGXRG>~g*
zBLCH}%i~x2rJJs7#4Y2iMGrewt{A~lLt7{=+hU_v)~MPaVtbJxVJpKFmOBX^3P}>z
z|HiMy-daN%i)p}K@4{$A!*8HDG8~}7euE1`r#?VI$4)A`FbrsXSfThP>bWRf|KW@q
zAI4>ok&26nk7is9Ml))zK(d(0(FjZpXHHi++6X7k{%ecZz0GJYg=;EXWLXf%g5vMu9S`pGw+vj=I8SO#j1!$16E23;9FS(5Z<57wX}wCDZ>DFa
z#<64G{HC<6AKDiKVJ}g6L(j5GonX#SeG0mQUsHwRr5U+mQ!7Ng+@uSiZ0e3e-R+*Q
zR!lv~pLKw_Zpq@T)eY9~!PN&%%+b!U;!?4!Wu<$=hEn0q@KuU^9*t0r+A4!>mA^Jk
zpKu5Tz*=-h#}Aq`vB*|QJQf+LW7NiUs)_WAcDjhZ5f6&$Cju>qA8GqFpWcAa53=D!rhhF&uJ;(k$rpb=W
z>CYe9-ycZF@OwReSRbx6ow@(KoPH=9
z(W<(WK(JXfs(yt*RB9D>UIhpm3cu1I+7SfJ;JgaPfI!9;NC-Bp*$=b^@}pY?Ke~F!
zJ8t^qN0->i1rRq>waYqnt71zeIq44^{i`W5v@(@iUAMD(c8hwwTQsrl5qa(vt|Kg#
zcpIZ)30)+uW`%MGD`aGgh*WweU%K(gShOVO(!il@uV^(Gnsm^Az)EhBREmDT>}5w!
zY@4i)A3Zm}_F!>7={j@}Vj94ANX76xGFL1){COOoC-8X^pI}^7
zDNmbW)hJ4oe)ruY50DH*to`M9%ZK>hT%<_IdePwxD@)yp*}2{3+(4yWJTm)+4{WdO
z*n!;(jyAI`xQ&o#_c{~h`XtWujwXP6(gfDn;zM-Qxbce<&obm_rq4Fy
zXr|w7$k9x{$B@_hGNJy(IflH>C)25@=Nj^QpGmWMyeOjwvZJdbFV5(J@W|)w
z645u5{4hSGZ~TRkHmMsc1VRG(Q61H2Ttluf4HmO>C+>nD@
zl7?Jm$U!DaL#{UDsD@l)$WaZsHWSe(WCPDg5)rqMnC*8!lqBWz0gIdVj@jKXsLl0B(F_=#MwJ&4KS|K)WMvp13dUb1kS<@|EOP29(zN;53Jbc;75YI`Vpcr|HnUNV0ivS*823^(s%+sxRVWSRS>`Sm|n=
z2?3HE>`tpkvl4SB^!xxknfBc#LM?&{G9PTrHZ`(O=4FU&1ckCe%iuK_zWr-jclH=V2!O&
z9GCrXEZmg2sZi&mg#AtUN6G%y!cF+uRWM5ScNVPi|FZWc@Nrhv|L}b>X_cq&P)m3=XSTBcP;Ui0K3ninr`IR17
zgM0tFNfIrM8s;lKvetOuut6=8ahZBmsr2OT0=nLiLQk$g%-D~tIU&fjg0A7Bi5Yas
z>laUM%kS3<3rPFcb2qh+_<8-BP;T;jHqGLP@|&L##Uj6F(=2`{o_QImwwgn2xv5IN
z)j`8cldN3P^9tr-M+1!4n{4#$L=>5kg(#aZ!)DhOPmSe`$sF04KW)L7-*dJCL}^D!
zcRN=U?6P#Xnae_?Hc`dIk6P5X8lv3RPZRNW)!SUEVB04|R59P~66LgfLPbs0J6x)q
zc284rL-kIVD%k32BJLO8wN$;_o}hDK4xmAw+$ydW7NcH0a7DucPeG!9&Qy1FnFzDz{6{o
z0v>K-7I63KlkI`r3{}Z%+--WVL$KYwPQ-Sn+u3xxV!L~F*mg$|r0V;yNn_pe9dJs|
zmZ1KN(j>>4W=pmZ`u}&P+6%plf1qzHpXmtg#Xbf@@VRWkS;C8GFLvc45g7WSTDupX
zn0r-VNDF6eFrp9cmaq%9NzC!w2s>cC+c?0s7(7_%H4gLGp}RZQW{%{Ru}ghJhwCz5
zyY%+BE-*)in0DMHZnzF&m(HeEmu4ZmU<#i!G>c%x3pUF-1-JR17g_ned51E!Ud2lc
z(oL&&G>s2#MKc~cw%UUhg>5z+Q@^i|RmV|#()_$0leAr9qu7fz!gUNaMf=ofKV6fr
z6IsVg1oPcH+I^8P2E6iW7lYVi`aT~&x&9bsd0{<7$pkhhK=^*kjFVywIummKe1U)
z2&E>`=V9*044sMQW>~(;d-J@`>3(AZ=odrOVJ9RFV;MP?;Q{fyy|gVsGDcx;Z_@mKNhDx0A_5Jk^U=IB{v{Hf&R26+nMTAqY`lQebv6C|v-ZQI%5bQi@7z
zQ&(rt*eLpp6c*_M%S5`=bAxeNF7ZTl@FE_j*OQNzhtSuA((8H1E1VF9+E504mCog1
z40WLldJ=O*7{l6727Ud{E5jJpg)-=ig{}-^SRcxuuPnMMjA274gPvo(DvV)cD8ok1
zwyVP!s;fdd>Y3x!p&a2^-M}2zFo!8w^`n`Q;mIi&Sp^pVe1+*Xc{plAs+}%Qug$};
zK7>OTsMqD;s5TFe_`3mJq^`}wQX3W%U8t_h!?G?cD!N#`J`YQEO;}`f$+|udPtDq}
z*yzG_Lmr;B)nU=mq`jPthT6D7$k4PELWTyd
z5Hd7lg^;1~DufJ8Rv~0)s0txN^Hc~K8l^(Ws3|IlE?+)`G&`a4a_MRdq%$u^*~KJR
zUbT4$XfDE9vzR&;;krUqMAK1VWYAy~NQq{mKuT&H3M8c_p+Hh<2xye@QEn*ob9D{a
zz{JePdX&T8jH8PI$H#Ix>?c2L7TWOnxM^5$TR^g>8|S2&n&O?aJPl5bP>4|l&S$fOQT6BR8MBS_MO7){A60w$goQuNyE*kO})BTpF&<$2p&gakO
zH(z57>PN6JfQwdeHD*Y!tJD7L0m{};N}5J}!$-LxpGaD!|E7r+&JZ@Y;}9$Un#4H36;8^uy!;S#{^=w`M^&-LenIKMVY4oKQl3zWB9Lw6fJW`{WQVn
z=?3Zfgb_(bFJTv3!=j1m#GhDAEQjOP3S7FKt0L_zfbMA{FK3aLO0vsOK|jYLX$NdB
zq0bwkL>zKCJBjwmf$-87_KxXbU!IE%^*g3l;zZ0GYo}Vmi)rojk2rQm360W2%R}BN
zHgdEloyM<}8GM5#Q}Wy~zM)*el>P?M_~4uymmL44hFIu~(~SjmFzG4${Rw|hp9l8%q)7ZgPmiP7w|S`UiTo3)bLy4)z`dwcD+9LkUf*z`jkeC;7C2)PAD#nvEi
zEPQ0AxRNJU#Jx1ZM0F&4YDyTMIMp4;&r$wOY9^R$p&@4%RqB9$W^qryO=r56-1
zb`7Vm3)06p|MVD^S+;k>WHsK%w}ZGN8~HGao1=$y;Rc@p$P<2*|7MQa2yqjLcZJ7n
zgmru~ABMH0Jw{4RxWe67yLg3^EM30o(sXPy*Y0@~)E9lrrSOa?JPH~sIGk?~0SKF)6}q9f{BPYU7j7w~)<%To{Kugl^w+g@)de
zVI`0xuGk$IFQiMjM~(%9;owvV=b^}xT951G;E`raZla-bQ|A1}M-`H^prQ61&w#pAC&GA_?;fheF2r6~N(M~5hcP*D{A?xR8!LZ~PT&-kb~3L$iCY3ie+DCClH
z6!I6BmcPVRG`GC)T$GMgXGhY~?<k;g2QdaEq8tU769)?qFk!)xrh
z;e(Xc04z<)T;To|!b6EddG>t%v%#u`)SAVc+hCjZyypyJ&6QZ3vD%u$6h|8ym
zdq86o>HJizs9YwKp9<DR%;IwK1GBpAF}rD>n5(O^bz_rAGtN
zP4(i;a7zXM%W;-3JIa1-B-V4#(IuIP)7P|y4O7{P$$Gw?h!-X1D!gA0XUki9bwm0M
zH*O6*omfn!%WY&w4o#!CH>caiaFrx>a}axF`G;E5`U$<7JBBss-oD|>;(3Wge;9(C5;Q`uk&*G))@V4
zdXepMH-;3uQ~^tkoSosyNmPvxp3~(cH%pICiQd`1OhIM!PXYRTIf&<&d85sXUuS(X
z-(G`OGN6LQ#@%JGiM;&!XE5d2;yRsbNDqx?)0|ScTFk7Y`m;bcxX(F_&13B(t>V#HPi_nYJU6SmS@!UzynNjb};m8vs>M##tQzIvq`?(T*^^J;*+1wi_U#+Sn?P*UMB7CNv66JZSe~FheFg4_o-CP&`njJ
z%;9P2XlT&dtYiXd7%=YK7>Bl>K!M
zt=TS+HlM08{XqM84sBo(3QJl3f%Z3U9P48-Jiy|xpie?0
zHTM71aiQ*HD2+Qbv*|f&)pNNld8!p90!@{kcN2lfDNXTuvK^=p$TiFTcI#HIMiS#$
zNxk~@s#4wR#A0*C=xUENe@u91_tkXD)0NA^$^3)LxEHjj9vCVUfv4~dt`^C@U1@%>
z3r|@!?4L{<(~aEW$Bnr>YpZL*dAI~4H*U)1q5IatnW(9!GJkU}6YLZ>gfqb&o0)FO
zWrD?Go+z0%_zk&C8>%4{
zy3R@HCgz-!ZVJvx=_cEplx|v4?S7Y=EZwoz&iwrZ^)2uBXzS-7{fJ8%(x2GfhjKpU
z5_9Dz@6hgzba>RIoxNWp+OK-FiF0O;+IMu3!uVR-uEYm-g^%cIk>k5Aacg=yJ!1D5
zRNUwq0?>WWr4!?sd{Ws$=liaKPpte)DhA!ZtXdWCrV^v^E?5AY?sDM^3t>NodZo^%3o58sCH
zlA<+o_w=N!yx@Jkp^4GFMx)r*OP0-PGb$2ZO#6C|Mvhy?Wk*(=ac$OArh9l4drbPZ
zHD!6XjE@ZZeM_}3EgR-=F3^4rQxn}&*|GX8w#)`GW0wQrTKd771|w}e(GC;A@i7zb
z5>Ij~)-c8f_8XtWwU0L#G#*E*Bu7PdOrR%LF|1uI?E38}S$Wg^vqUxQN*QK}r@iWJ
zJSCdmvas=xIBE}f@znTA>;j9T##dq(T#qx}5>0Qd#4N@cf}?dLdS&s*I7@zde0q(=
zct;JFe+9yLt`JXm0&hGjw1pJS=KSH+aOU{iv<*^-HYq*7=MB%Q)yAc-_<3?$j==ZJx%VWJ~X3=fx*pbLQ&zsx*XhLQO@
z+rK{p_z(O&i@zNEce2T2`}gG~rIC{&rI8h-rIC~8l}1h}D~+5wzcf;@pfpl>P-$f4
z!qUiTi%KJ_4la$XKBP3V=Frl}>5EGvRZB`E)k{kwHRYv|+QUjCb%&Qml1G$AwjNm;
z={%}5(sgucr28eMk)C5pBioKGb!Pe|CSa$K%Jjj)wjw=~$KdVF}W65~SZW6x&$
zmUZ|SJN-HDi|7|c?1x5t?~4rJ!N-8@Osa2?x?RZgo*@~?<~R-Z?;0JL3K9;E_642N
zGm~VVW62vD(eE%>j=M6$<3YmVnw)@#_YKmUC>CpGUpDBJ9mwI#PUbjG4CaP8k;&0_
zV*kXzP)?|m!=u4arzT*J5_H_>YCJkTk)wh<5NpLp9+|S-^g}L|lfIG2a?;0SY$t6W
zWx2`72yTk*E~4`uzVkO+XneV^3(1RU7=`F^U4IVndHnqge^l2?U>CCkPZUN~B!UAj
z3xIUT+frRU$z(@ocdDZ+io3ZF#j|-ZGH9&m8yw88!iDH#Q=?QV35}jYi>EXK#;@|U
zsu@|yJI#2*mwuIJowc^|v(X}Z!tEwQ?xwGk}9Jssh*Eu_yuEvsWG|(2$xfj
z;5otQ%1TXw!Tb^^<1x9~xS}jwqoOSM%A1pkj`~zbBc2H*y(=`{fJNKWcn*0OIWzRn`!JS-xR2l{B4`Q_H2DaQCW7Vw0Uls?
zgLnxMv;+uRd<4f3K_Wnq@DUtG1of$erDVM(s3yy!ey6cel<0vP34
z5+tFRpdwj6J~de}RvC4RB(Zp9Y}FW2t1?+XJQhM^;VPpKJ;f<<%Od+K_At5#^N_CORY8945-EUrcpovN=SQSGJgFQ?eyYlvfj(>ZQq+
z5K&$!WTLZ^i7-)Kon@-}WFkbAS6+#zRM9JJ5f#I~VPhrT+V4bXZ#~Age*zsk=-m!c
z_wSJ5&>djDe$yuaLO}K+>oU2|{14(xAM}b{3I3?xJS>%(n8Z*jwL7Yu!&9mH&bAod
zwM%V_cXlN@+M{c$uu5OMUOCIjtG*!-O{E6Y10xfe^gu-_H8wtp1DE^IJe*91sf~$_
zRAW5W+7(qLr>0UQsU2^qt~Q@=KC8W_wN*Kr2t@Hn@h@&Gg3;Qf9lg{HQl3H>~F^ze=j;jN6LugAkVgts$}
z?F@Pt7FQQwM<7~(HGS~k=QNR;skZvni=aG
zjru*Ya_w}t!9oQRnC`1iobJS4O$(ska=PO2EwsB!$?|QD#dp%L(jND
z(S}4jt^C%}`Ffr7xPVdgT}L*1Kh@5-g~4|JnRdqs1J|82{#?#otGM(L}9
zGXjEsJ})z+Jq9YH^jR^mDylO=&tvqvt{q`@v+<0bThhZLsp+*lQGDnx7Tbx&e<$WO
zcsg+ecN_7miFz>4RdsM=xL;RWDyg65a!LiabV(t?NNJjj{MYI)1x>%w()sRCZWtEn
zr3*Zqhj#Rjs{AEVcPKMHk(xxk;`Ns$IED=eRer0&v#3Bu`zOd&NR{7?w@VkOWGXe?
zmm0wnKdSr&$7x!Y)cmUaL(1ukpzcr+!W@|XEq5Ge8(Ajjmy@I~nqq+f&Ddkpk3>f#R31&9yFrkcGuevH>>
zoTj;I1b;MNQR-3T<`MWa`k!RJNrM`LP{?scTn&fE6fI-=;z1l^wiEHu53Z^d|IEW*
z8UE(uPv!_cUGLdE`!2NLlsX4MlD6^*~CQ$tV;z1=^Yf%H$s%nC`78ne}}PD>$w|Rp~-c
zs#eNK{jb%H_!&F1Si4G1;BJqd6Qh_wrw016HB~ihcXr@vgyFGRU-t1^A9&)G4?ceT
z1HZoYuE!pD;EDUMeEbc!dftzH{F9Hr<>4Uy_ygDf=53en#8D6kfyfjhJeeII8A)gP
zrB#X_|02&hOFl9mS^fn_?Uh{IPVJg1e+sRK=Y%bFwd78sL;~Sgg+E;;E8sx0NsIeX
zIJyqROF!Z~2>&d^-y-}`nQCe3jK@2>JMdN}7MK$HJ>kt*V%mbT)sC{&HH}+fu?`f&
zDgN|e1vRj%(0-sLh2`JmP{r~%y*+Zq$rGzi9^9GTIktS2OQM`^%IM);^<8*fw!31c
zGCDj|0kCNkw)$+jx|K+!R;5yO_A8Y_!@WauV@)81chhJSiF$N&C+Bz`w9lIAYE8uG
zK^u6T>v`#kGnnu?FU}6bDu{X~+=p$%obS
z-pzCH3$#Zp*@NLhM{G-~1s!bH{)x%-Xbh&5v61nCJRlabsM9qnc^F$e6|e&|IJ
zuS5q-uoCgEXhkh`(gWg0Pus&n5?KcUw5?B@er75@v3oo_Sy|1`s|cCj7skNh*bjo;Q
z(VD?z8}^|oUjTbOe6w0*hf&LzdTU+HKM_ma@go_5~*=WD1q_pTBW%GvJD`dAz(5li6GyB(z5
zt9-s>jRR|*4h(<0IkHVX?OX>q%dYiN#yV24dIJrT0SR@Tcu_(1ysR=Ct%)LfH~C~x
zh3sU>H;XH~=p2yZj_1jB{Ol^g!^m4KE?tsPoSVB_qHFO+nB}XhG*^+vcoGywY)trc
zTU_5M7Gb<0ioEY|y_vZ&J(AW^-)eirM$&y_J(DHzVZvju20Bf2Zr7HgPpke3$DrgB_`KmR|m9ni?CRmxrm9C-(PAI#Y&G
ztI>sNQ~Ng50oMVKJO~XYNuBkm=BUE)uI^N#y&Gfmo+J$Qb>oHtiJZG9KuuYXF#}#+
zYz<=p$A^VuOS}^|n1vBlM0GKmTZ6OCidJlht`>SX5|vbX@0D=o&?p$#9OScw_%UZD
zi58p^zH3_xo(V(=jA|?;DBVLhO+;PWVuk{rp7$r6wwmq=K8@w}3)C-Hz-^_}1Ap&x
zI(0s4a3=#|{3)j?53f#7ix2XM2}88^WBd?NZ`UJP@El+&9T?C$Id@vSD`9ht!-
zhMC|LGPs>X0u#7)5N=vB9M8opOZO@?phQoE|8fJ{=~6Y(I!`!J3Pcz|VBFN+fvpfd
zI*6w_<6C=m8kq*OGf$Cn0t5tr$x2
z^*7uOHe<}VBc%sY4LiDZcfBVwNNum*k8c&lGRxXN{a+7Ot};jrGv-G_jfWoFJ8&Zm
z`un{(KJoUBczZXk*<^G55Ljmv>o*f2ULDj~Pv&~GZ%=eYvA{Hy>(x--*c9D}yVr8P
z>YMAaT2zgGXNMG1L}PpnXOVt!9I
z#^rh^y4V-Vba|L>J4!>e2B~mGh;MsGS27l@fl{vw@$E_`lJRH_w7N3Hx3i?yEw)k?V0R(&C+B;~~GFn{)|7%12(c&T)
zm~B>9LDlO*XlUy-(T-}45{z_ueFzB+q8l+b2L(#p^&u3Ab_CRn84Q%6@^eE7O?_);
zyuJ~omWt4gVFb_wF|OZ6?Phfi;&f98RiX=v1*niUDBm}S_(Osapgi3YN`TlTdQd5A
z5yTrpC=%!hw!#|%-WcMI2XkVW%44othnU>vr@$1b8#7w0HRCRDYSwP|`!-;SL%euR
z>}(z*tkb<^0b?4K$&Oz*m>!ay8Ma}Fa^DIOdd9-
zNt$JtSp+S%V*J&%q~jeWCzsPOjK?BNkxu3KJIstlFloaqAFCs{*)86LNgFRO(DEjY
z;ZzcT5!I-<3(1?obS9e~z)WrsdptwKxMvho8aJoP$liq3Rc9L$<`wZG$~j6~Bm=Kx
zABm5nBtKec#jLG9*4aT>fFTv8AGiy;GfFFZG@JsCg_`>A=+MY`-z3IT
zwQ%=@a(0p%x2e3L;G9P|mX|uaqr7aTob%a*XYJg+Phr?j*4|ijBcBGCP^8#H3%HOR
zX|mNAZ>^{Cnl&t~ni-NGjcvw=mS-;{AcaFr_1zs1t7Fyk
zkYkO=5J!2&f}W4*u^y6&(JC(%JB;l3*kn2z!_pGnB}Kx~2@>&ktkCAr&J0ibNzoyK
zl!}43*22$UxDl_6PT@v|>|`(oZ(>e)y3t*yv3apduNNM?=*&RBx9UJK6rv%9o-n4!
zwwa$$ub7F?U`HJ-Zvu-Mw5(*LOl8m}PfSpyov6op$4EMzsfgx~Q-0jTL7+$I=xpTb
zvcp|Ms+gKFYi+BhX2?){zu?1Zo~`CMqFi3G$t!*pQBQ&{vLBYvC>?oJ^uhu=WmEJr
zx3K4ic0Y$kN0(X>%`LP}W>&`#weIoEY_YQl&>mDoYpGJL#)oM;5v5dWVB{idw!)Hv
zE9rx*123AIC17ZQ!D+>`>A6>Brjumvi*?H^(v`aSsOw3M0q~W6nke$^pm%%n+Bs#{-RaqS&RP%Gz4j3wG>
zpNX2tu@Sn(&G{-jW0@RF>8>Yk#~4Tpg>OvKG}oAfDk$B>w6k+tV;7kXq+)G#O)wQ8
zkI}w?EbZ}AA53GC>#>j(HYUj<#4qASG%6`AoyQ%%-%x=al31KK3sKtY-|0I#>8;tQ
z@-oNiKQ!6ncRJK@298R4Lj_?RKJ2X9BCt4Fmeas1wR38uJ-ttwa80kydNAVrUZ`o+
zJ}cf$+3`{ITFAgNZz^@JDOte_x(VEbH!(cu6+(=6>zuw+3N7H&2nNMsRh+}n|E4<
z5dG~TTGBucg8+Itt(+e8&2}Yj_@-PKJrLZBs7zGeSJIO1!$#vSIxo3kS!QYgjcImL
zj&Q2-T9|ODWixaOLt>0?IZ#W!heRqlsZ=fJS89`<0GihS9rrELW3-g4C*q&w_#-PQ
zvL$K8)+q+xVoyTltrg|%To{t{m5kbwH>o1$Do^GFa{qz&xyTExzUw@>Vi7gQrH*
z(y!2b^+&cp)|0_zoOsa3i`~{1+WQhS=XHxyj5~?m{nv#OK0NWKL5Ol182;M0C
zGJ@m99a^kY&POzBYaB0L(=9-;hKkG#{-q5j9$jL}MmY9AnG&-N9Usj8<77qyJCBMC
zZ?AWc>kal*nVB8K>5)O&K*cd$8sdG5c`>q|J%}&sAaumpd_ylhm{B#Z=P#Kg3o)2b
zz@K4q5dC*)Yu5c;&cUEMprbVy*VFk7e(Di
zc!wrzgZ+?LcVQz_&*aGDg@kg!f{}!#Om<+}RRH;&np|s0na8p)Hsr>DbbMbfg%~1L
zObsv#A^}pUF=aBJ}f`TB4e3TE!*v%X1JJxfG|bX}GO33&8G)T5!
zQTvhKKMCt~fARWR(9>I2@&)lrKa~U#qRHcaGKxy5u;1mS3K987Kd~FKS^Dy+_~+RO
zLj?cbPfw}h>Ka1)Pd~A4qy35aZ|%)3h`%OD#k``_Yha|@XnQ^`E3fkTx}vG~Gc7+A
zlGoTo^*ituYpLtU
zdTkb)coD_>aw$xHlJ^HK?~b-MUfZLXYAdl-Gi_ML!;M{uM)wnoE>mg#XO&D|Nz%Q3
zN%8GTvW1|ik*yi|f7I_ElaQnUyM%5S!Qe>316qQ%0L5rPhO?`thG`&66c1?%8jObe
ze@6Sqw^4FpI{@PZNwk^xH0I{bxPv4^fH4GGkn~D6DI1!~ykbMS__Ntqz4{lHQ?86(=E|U@G^Rvw!
zu<-vbmtWdKpSBdxA2lI0PP`O@w+ma*44ReQ?r|C)``34?S7Fh}EcVu{%4&W8945x6
z>4D1oyOw8$dtwp}i-!t5lf{+pRKh9P?=?Ao?0j90vzH#E(2cqNJY4f_$0+Bnc|2#5r4*VCP)ki#
z@V0F?hjGQ#6K29J
z_)j^Ws4w+9*zd2bmw#V@_X#NzpBH`ndKi#^^7utYR
zC%t%d1k=^FBx2a$9xV8H8QYVyy*ydHTh`?`OsbU-!%^Q>Jv!|&9$m@Gg|~=78~>jy
z(~W_6@(fCUlkca>X54iep$Ona^`OW=yXhC>qD1qMM}v#F`qS9}rQeb0ABN5twscHQ
z(tHll;cxQ!bQ#7&^jL*nTZ{S;@_$6f)@@%Wq7-8fC7RD@8cIvte8vHQMx*5aSsl7j
zk_S*;sytdY6C3YDM~~eriADe?8J{bIJuIyU(ZUI`6V`T|^yA}xYaQqFUg6=>O0a-%
z%dl${fsM4X%mA??=Lt}o9d%s@L;FD_G}I#+f`&-kG}V_tWtP?$3YBrwR9`ORg&qkl
zF*Y$QjIg_$&skT(lmp?d0EyFD#4}upVB}SxeUrUN4Bl+8riN
z_{NI2Yx$0Ev#=fWSn7x_*pbCFmRjVe{1fL~+ePq}_bqBQ(kmraf6)ZAc_v)hP<
zB`b$ka?*B_kks-}M8D%WAD%
z@b{mf2b5Oj58~tC$Zcii58J6zj#~(qMD8!s5d^OUQ>V&T!fQk18)Z6KDDFC0)}jQ!
ztI=d2l8Ms3#jql_I*pM4n!}B3(nOXUM2hXtN}ONKk4RZ^yFc=|CE`3b|ES9A7no@J
zX0__LoPsJ2Nc)HV8D49Y!QGg;KzZ{`3gvSV=kf)S%DWFTp>VUSP&{;TM;da$^28&B
zeT7vn2|e0GzRrYqT;$aUQFeGW2kG|m(vp*+hIE}FtuU%_$3j}2R_eSBT3xZwXvOCw
zxQZU06Z6Q^98ko~ccj4+2#DHjR5f)n{y7DIr{a(Hvv#pCGKDn9DcNBgp1Q^gQylI$
zJ0s{bni6queUHakO24#Vxtz!QOxWc8`?mLQ?g
z#TWWd1EJG3Y#qIL7FTE}MX=@6v2To)vuIYPHRq8-P8B(fD~>D!%68zSm5JaxSQsbh9(uGNI@N(2QZJ$dO#HANO%O@#^TH<
zEU|x*o4Vn}J8x;?^wAZ@v_i_WR!lU2mu7}Yh%+Pt2NHSisjLMHL{dtNT5m3R%
zOe5JQ`!May22#~4n7YV4#UXo5oKe8vl!jI~UkHf6-+f|mLkArbf$1mi^vF|kO-8Qq
zwHl}wH1YAy5$LO*)LH2FBdVt0xtgL@O;5qtcC#vv?WVCS67m<3O_7;5{aGccF6-6~
z<3q=J*g3ZH2PHGPQzfF|#@h_G2DrKZfl
z@xT?vFqr#yRsIhQ@ec;-Rub*B1Ob1JMwyDonw9umiNDiitcgY2m|jmHyQy|u0lR&2
zVvk&XAeY&tV7t>0?~E?rws8%P@-N2`om`r>`ptOS6zBiW3GqwNv!_@qJU7>`p(lZ>
zU*PwM15aKbHhZIJzjFGNo+v8jSDZ=A#moT~s$cGTj32UB&dMjz1RcrLiR9Ss{v~$e
znsxmX#xz<)U>TKzv)z>Q+gwsFFj(dg)9j0<`uND7Sx)Hj5fTyRfn{ciYVH{l)>SXR
zy6e0+ih{$uC6qc{IPKlo(~5;;*@5Qs<6&pluL#g%AB3)r>BPD}=cLuV^U3sA1~{-I
z(T>&nTx!1U<(@-$A-8>ea(HMzc88%{_qfKeqr~-mRhpg>7{`sQ?A@G3Uoku&91v?U
zMJrdqNjNnk?1b<=i%5kJ`$NS+5=@MD{s=-glOekFtc-#8%LX{
z5a<$-H`uW3FyS3o40ChEuYoREdDYOdziP2B>zaqB({{dv=}L{Gl`c9U?98o-!l-s2
zn;wNhfm@KV*wBJLAi^ULH2wvw4=bwwdd%S;eeikKze3(@_U^*^q8oqUigZ4ey1X3Y
z5UMTi#t1EI?po6R?vf=qN1;vzik|mqeL%Uz-u5Uz*>OgXJnZ_2b9lOQYHSSFqiT`D
zH=Qq2i{RQo*SVz!)uNKa(_-mESmf}uwmrpn>EX!b={_7kQj6xPq_;h$%43c*6FKav
zQV41v*DWH;$DS0Kfp7?J3DIGsC%L-x4o~jxm`-Q+kxeFt2OigltUEkUtT017HO3M|
z`8yok@erx}ap??i@xm$;w%;?vf`hyJ*k(v^>d=~}-r*YK1BsLXvQP)9w91C9FB&Hu
zTY`g|k;>1_o6(n=z+RA!0bm_GGfn-8Yfw&$epmn+!fdtbaSZ)CvSh*&Q1n#KS{$nw!GQ4Dg0g`88N>
zMIaMcz#Q1qn9fY@R!b601KW4s$u>HkPNOvMOrRM)E`g2w46`>(4GpEUs{C5WJUsHJ
zvhvT-ox{su=tRc!7^v=o$I)sj27JrQFOMuOzbdkP2_3uO;%M#kmH(s!7ji`^uRch}
zhxQbDC@wR))T;7QPBy)jrlWEdM@6?rJi|8{E?AZpLvUKA#Wk$gOH{@qx_LRDBq|JDAvqI@A_)dxN^1>_Wjh}A)VD~
z{Idpsr{jTsjs#=%a&eAud_Y(VNvy`{-cVpUfqzjbb!4
zFD2S3ULJwoU;%YLU`L8I_
zkz5t6>d}Lk@E~uSr{fme-8Z%?oy2&5e9#S=>}lDBEdE?w4=_2bykI3nVLgvCd
z>qLZ-mTJ_uT*b#ThWo#+x35J&xTN_klLVvLZ40y>{^B0ckgdpdsn09$g;W7Mv8}pL
zP!yh)C~)}<=>FeQ*lwWzJEelQYh@1gQautVXbweXSxySeq=?24bpC!fj~_^C_}S1&
z!}_9|MJ+G?s~+ZyjTw#I{)sF2mUP^Pi<|zfFtR-iGbf6Fh(%TTv5s@`l8&!}^q=Zv
z9z25KrB0G8jnnR(vLv+C!JTwVbZ)6?q&HobU(4x^bE7_k1wDGB_0K2g`3#)V`O%EY
zZ{>}u<5?)^v-w2fcSU7IE5hYP-z7EYy$xpBUa2%0?WcCpIRH~?Ofi7kTyAK7IosSj
zAmT+>dj6@BULII8@QasdAIdcp04^N3AMkLhWt4tv@y|N^t>-j!BF)J0R{ymC*yrK9
zn&qSvPM-2R5>XZDz=7f<4is<2f#S}x(vs~3u;F5L&JDe;%jK<$P9gGrJ7irATWY%D
z2|v0=YLJP0+S%wF`(=%|03L@6L8#w1nW>W3)rdIF#B63x=G?GDH|8p?Dnl7b3y+Zd#_OYU0EMfzy}Zz*%7*L
zm-uY{u)`${CViPofNx6zTO#5S2eha6aGsJxyFIn&2VP9)?7cm)rCidN^Xf|FpG$mA
zRHJ(%9gMQ3vj^oT}@mzUp(Z(S!h;>$TvoxT|AoCvoFEZ~kv9EogP
zp%yKA>7vL2yh*aui7YsI!C~``U9i+Ccb4EO>@wR4@0EBC8
zgXaJ+cV>JbR9!KucgN4mQ4uS@R6QF>_A=XplqKi0J!h>hIo5lQJ|PR0YOp<62%KY{
zvj~A>
ztb^;2IWI$wwRsMNwjTk1DoP#nfi=q`xrFL0Rcfn7DXTk=Vo6jky6BTWy0sggm^q3|
z)3&2gntG4svcA2JC6yes3WPfhqSQI^38l}~pG2@ze=2pJp`7Bjf^&
zXrDffkb8d}g4dxA@FxNqqz?)vO&>}P&10~O09Ewe^F&vrhUF7n7wS)?_84!HKVlFa
z@~ELFzcCU>^>Lg(AR}X9K#9FqBQHDnEFf8p9Csw?HDM5RtZTUjPo2prI=x994TbkD
zb*QaXYUV8YKtl7c*ui99b`;m0?TMaSH(0wiJ$Rln4y#vZuxd5jHxgaFdTbm|F%RO_
zD(rq>^fsQF!gwC{sp1t__S{ALxmbHn;qsIW)@)M~`$zl7M<(DqINS$RF8$lIabs=u
zD*k8Py1E*84`ik`;h7v<$FjPuZp~0;%|r&SLvY>Jl$@?hbtO}c)$8DdC15<&wh054
z@%{^US|f*Xcux;u$6zqMiSK7ys1jo!j?#J>2JI8LMJiL%zrJpDEo$QUXl8s2u4hDX
z3mcJS@TzS#x^_*~x+rcTM=YZ2q80s9!y|*y^=t7iQTO=x$Qe;2OW(w(B+~#V6XA$p
zx_@dH!8{SIURPDKs=8`@EocgkZC_?!V$(a62kPZKrNx6+-|8ZiOc*iKAT)>W-VOcNNx_uy5niJi4I
z8#dPLtj}Z``zHH#wvOXA(4EMVok?t9P4L@;JG;8uYHOP6W@b{2P05`#YpQG4RPAic
zVsje&v9_*6*Um;5PYt9&=@IY5#v(mWr~~sqVyIax?-!_x4&9a5m`e3*!!0qGUy0??
zrnR-z(bbI-ldAPIGd?U;S3ScHbfl`QyOA~`k}WA*i4Jbi;b|}&v7&27VIj1M#^*#jw1^I5hoZAji%gU2!cW(`
zpZIW;jh6)QNB}Pl;PV1_nR*cNTihVZ0{-&@_<{iaf`I=)>`y(k{v8zXUl_m_1@MEJ
z{{h3U4i5Mq!v4!#|3d=)hqC`;uK%F{|HbT2=PvYbvHGx;zGpZ$`|wir^nYG0I4$g8
z-%nlX^QZinvHVK{{+PJRPro&YZdQJ+fDyISpi29fySVnJk+c3y0z?!qX|RLFF`ANJ
z6fmOBQRn&eBmF;lwh$1&rm~HfsCW7NBarZ~m-*=<>Q4AOaH2FXf&Z_4{t+y9+4QCA
z^Opa-fd4#oujOAB@Gn!hSpM?^{`1vkmj8l){{nS^<$qAX{~*PYoY3qML-W8p`u
zaSMNm>ap-+)R`83tUA%ck5lt4{CM@`CKEd<7t7SQE&K%a2@8*^w_5m#>M9Fgu0}2V
zB-LZ#E7VyQezH2r!cS2PE&NpVG#OdT&rucX2Nqtb9=7n6>P`zkOI
z_(oN2;b*9$E&NRNAG#J*eh%!$9=GsK>VGW!rRshQf0=rVg`cgivhaE}YT*s4$HHT3
zlZ7{`lPx^14zchi^|y^iTT0Jn^-~LPQJ=H$g!+JmZ&tTh_!f1Mg}18nEWAyfZQ##Mg?FkCS$LPa(Zajcl!f=G?H0aGooV5{YMF&^SMz-MQuGf$
zT(8@6>d(s2AAG>VOVk8#^IKZ7(OGNZCpk~AGrm~gDp};*XW`eVDGQ%gH5Q&#Pp|d!
zkEst?_=Re~!Vhy!wD9%L|JM2WYn^vn_^Hkw3%^p~Jtg%yCzS#K(9p8}O(vp7lDGMJ`ms_~w#4Y@MRc7JWs?Sy%X_THfs8?9{Z`D~A
z{;Ybo%1?iby5GWosShan
zuS#0@FVrCx{sHx+)qegDt5;e0{VHbRpTHubpZ?eC!Bu|zLABq)A5rTp{B!D0r}^o>
zq&{Hb|D$$W_&3!G3;(WqVx^z|73xD4{x3Cb;TNmZE&Md+FO`1&)18l7c$ssxg`eak
zEqsx4f`wnB{#fCcH?2Ny;aPR1g^#HY3%^h;vGBv3AD`-%x8Awa!fT!V7JjPJYT;L^
z6D<6P>UXF3SH(ZWa7GspS)ht=H{UhWKA_&VoQ
z3$JmWJl4;DigTZZzf$eD@E@r47JiKL>@j}+WzGW@ex!4Wg&*piZQ*^Y)WXy1OE2-u
z!!vUhex7Q#@YktD7Jj|@;?aKoC)AY|{ts1e;Ww*)9p$J0iF&}o|DYx<{7tIL!vCb6
zJkrm9yLzvMzfBEV_`6ip!vCs%a)h7%F7+l0|GDb1@b{~w7JiTV+TniwkEqvL_{UX?
zg+Hd|S@@^aBZv9Wvouebs5uy5BBpP;aq3ohd3P;
zet}wI;e+a1i~RimQ8!umPPNs-UyHqPKmF^~=N9_$->Azh{28^u!f#SfALOV1vAWyB
zf3Ny2{Eg~Z3x7&|cY&Y(Hg%nazg0C^_&e2q=KJaYqCRfn?@@a#{D0MH7Jj#Stjy2<
zA$5m^->0@)_{UVah5t%@b)KL9ljsgDTW!g!f_qvbzey~6Tep!x-;X1yHSlI?<1w^ClR
zP}K;&it$D2c)=fF{9xq>PTg{O$sy{gmumeUWBgF{L&0gyw!CDq+Uko>IntszfRl}v
z`H?@}uVa3M)0-vcM>xF`X?}#42Jqh*PeAhjQ2_r!0KY$g-yOhT7r-wG;OPJ!3*dDD
z+}EA4em?cpa_DQV&tg58numoK3e}Xr34zlBCk5_v6jkqqFQ=6>z$~p;0bcGXWQ$sO
zsiPVQUg0Q~J0^Su$ORj=oE=`#Cb?@!j*)+{$iKu;s1{)pf0gd<+}5JY@fKEjOxFBv}YaKOg#I|YEkIYS_)+bbN^E%h1ou1YA%aMkZxKYg@b3W9ndy<<2Acfj_(MO|18^q@7DB%n
zg21VKl76gLrBaU)4*kAN5c>UrAoTkOLFh;IXCdgy2|`b5o=dJ$>SqKoR{W*F#|bXe
z?}3v0v7jfoN&GE7jCq+4kols*2b}o;nGbL`@t+723X#M3a>0#1BF+BmgdUZQabyzH
zHwuo-VmvPRse(5NezxGvg4YP%BKRu76N01AvAoTKZxDQo;HU)b-zs>O;BA7RC3w5w
zE6Fw(@qM*YzaxlD`y;{g0`7<>y9552{Lk0zUdfI6UDgt~zl72sklM$RJuu)R2>%9x
zHw5G%omd_q%S-9}Ci)|Z9`5v(7eTf+MB-M7JhEdh0p3IqayJXUL;S}H-lP_n*ACSZE*Y7D)yg0q!
z&glhs0`ZSadcmJ;t_j~l5c+fo-Y@u&;MA0nKkEVdn+QjGyixq`BnWvA3f#5=3}bd}}1WfPYr-ACUA$_?+Hw=kx~T^v>wB1*G3P
z(gQe`XUK0CoXZLPCkTi8RidvIF4_ssXTU#GxabT{COY7BcMCx}e_FCv>LcJb!XfV*
zaku25ond)^EDwVU&L^ZR=M&sdB0j)V31+3-Ku<0=z-gRC@_WR8kRbSJh(OQ^Z-ayf
z$l(o1djfgK6FuBd6v*+K(6;!LZfBA^a85Vidqh5$2ZYb{AMU1nzD?x3OW+5D{$7C}
zB?x(3&!FeSf`38$zd{iDa5)0}fw=!f=&X3Hk$3_Anet^9-Z>;X;9L&@xm--@`*kQj
zm?5hY;Aazr{waZ$T(s+dBzb@=7mYsW2XM|0z|)9tO5^}`iX6^&;Fdh}3oH+iv
zBmSKJaOd;~E=LH@@?I_$&6}V2|Hi3HuzE$8S1b$KAuLZ)igyozjFd=Ze
zz!8D36-e`J3inZg-xl~Afn}xIpXTdCS1&Lra7f_Q0`C;~8G+vv_$z^QZ#Bs|N+6dT
z7y-#=4?+HHZ<;O1xM`OVG^$(?P<2YXW~R@M(byB)v}*xI>`H
zrw0Z9lR&xvm(rm};L8PGCGdTczTX!3SAp+9f)n4P0{La-nwb6nL?~PYXPBk@i1F;H?60Ias@Q9irj20`C_18G*kQ_z!_c9SZt8(BBE{
zBS`rx_{D$mSO(V?-KZs!0!nBvB0HEHUCipR|#wp*e>t_fiD+$oxnE<{D{EM3Pg6R
zlGl0l>vx2o=jeV1olB{df2RASM|TC$oh$7qIzRSDy?q6_uY)}wK_%`tdwjnncMQ57
zC-{tvcagr_j{&Zi@R|i)E|BLX@UM{iaf!fh2`rI%@G^np0^cu?9=WA_JVM}hfx`l6
zeUkhi5m+kq;|PK8Lj=ixv6TO)z!8C$3jC759|=5Vf#zE;@N$7S3A|h2Zw3BG;6YNK
zUM6s>z+r*!5%{3MX9ON3_3T7}DS=Z0KP2!Gfj<<8vr!zs)dF`3+%ND3fnOK+Yk@UV
zZyN>f6!>O=_Xzx#!1YpZ69O+0_)&pR3p`Eg=Y;|<75D~$9~Maa7?dw(2<#F#Ch#$V
zrXDVo`gD@OmkRupz=+ffQ{S!^{0@O9mh13N7kID0&k8*9FztV;z>5UFR^ZPB{zYKo
za7}-{z>f(0lE71s(EhywZx{G)fxC{>{$CP!(oq_}RN(goHXN`{Re(r*1&;0e+$wF$gV;DZ8R
zFYQvBv_G4qefglk!=?S$Bk&r5cM1H0z{doZNP7|$_)>xA3%pd|V*<}SR>yll;A;i$
zlJ}3{;4=c7Ptke~34E2ncM1HFz-I&=
zajK>_?aEfc#|2&|uubY)8PyBalRprwchsK=P3=;oBaH;3c`Xz+^Ft|%NW}Y4syj$Riz^et`
zA@CuAKN9!{fxI4y@@3|MwW6a<6F-iS1
z!6Ur*Fh3TNm>-M7*9GKrd^;q*FY)q&*Ci27jp%LWzdHrLRGT(pZTzfVU-^r-yY#J^YdE-zf<7%1^!N;
zDMyD&`j~Z+eS+T-NH>lzl;d*NeX!JJvaD78!aD6*5P!6_>p36NwLBjg26^Nq6__)CL2>i6b9|<(;U?v@x
zi9YKEZWU%8AG@QHvireaKA3uZn#eKXqp9ccc^w(~
zxtDOjR|@2I5IEN#z)y(#Q^L1E()SdByibR6k{0~s0^ca`9)VnMAkXB>VoAT_1Xc=M
zC$L^%R^a6VuM>Eiz`F$AC-AERt#oUW^jU&*lX##hvC8L=;D(R$vqkc=+)+qcrawjC
z*#c2@**z=pbpr1e_=LcNB^_1?&TxG{1*cME$}Ew?;3$y0{QTS;AVa7gi@Ve
zeF85Qc&os>1%6K8F9bd>@alP*|D6IK5@^!t32M(`+PrGG*>MiunNR}Xpgewv==E=MKf|G;zY5o$>3w9B7gJ8(K<>cJcyW#7#}0vJoVZ``*9kQ8xxd-q
zD5wY-o<6MSM$t3k=zYJph+P1}GyF`4#)akl4f}GW&zqFu_8pMN+kiC^E|)LhtQX+5
z;{G;)KO_kEHB?>z%|6n_f?q4;i1&%$zktdEAnykO&ItZafn09jZuI>f#S?=C*84wV
z*8>07ir&8vXwjc9^c9Y_9{~LsqGy-D_lW)v3gmimD=udeeK(8#uNTPu2IL$kde#YS
zCy4Yl`zl5cZr{;ZbNgP2lai9}#-G!_PVy0j21Sq4#rSi)Yb754Qi{tJ!aE%9s
zxx+NCf38O?o2Dz&bAoZNlgum9r4Z(6?*=x}#$1@0OQ7!|&UJTXdaSruhZB52Uu~n-
z;9i;(F270b#uEkUtV+=(7r4YPvqo~EufHEJo~+?}E7#Pd>PP8P!PH29X7`rFbh74H`7ekr7j8*
z>z6S=+}6XA*NqL$#5dGkSlhfVH4-HDZZ`x&yp67DO!e;W*tM>CV*7eRJxR1=+BlKUq%j@EbgrTT*mqnWAHzAUas;!9^qt!W}j4egrV-_pH%c(A)BMUkqi
z@+B&TGTJwg9p_-;100dg`jN?j9T#<`y9QGFibx*^?%v6!@ytqkFvT}C4fDM{%sw$i
z(o^HHtpi;vYA>2@sSXJ+JANVfaKR}w>>1%`Z5e1tZ>ehBzM*MdE`v!pJZ?2Kyo=fD
zXPB*LeP7c>JH`{+*VpB;@ohXzy|uX=fR`fPE^rf<#4!%gyd)7J$5)&-D
zc4Wnt`aL`Fc;G;8DZ$M@EO|#i({|L>?dXl|uIj7VkgLbUH1I$(x<3h6{Io2_;FICsFeJ~X#LH_LYLK_?y9cH$AT{!m+
z$FtLeQw>|{`f>}WkF8G!meA!tbf1)fJBHJ#zWjj=^o?;?iK!hRO6?mwXJE8{
z+faXfRfAQ`gLKAkIw9>uBq8R
zUY%Q5y@(BD_h)o^bTQk^@Ic%8wzjVAQ$x9RZ*+Je%%
zT-{Zh_cwR17@z9jnA$T7*MR2QI?Y`Dt<%$eTjQ~=J^izl-pszNF1_`f92d5x;%f(L
zTP{Sza@tETV#6l0w{9neQtMl%whgZz*)XtY)>dG+MyoingHv(yp6up*ZRyxRb$@Cg
zf5diWqdYbsExO7uIiZHxHh#pfB7FA?c;=uucMANRXa6y(eT#wvF6x@S(}{xU84h2
z%(!6#=fK*1@h$7O_HEd`H9cDn3}kgu?$O;&a`)cG$&sxq);0~y#??2dxi;)sK}v2O
zy>M&CwjI42c2uRh@-XIm$)&;b${FRNbO*zY5(?pA;S|4fpPbtR%RcCoZ7Xww!0^>
zy|=nMtg!B%z%!UBH(!}?bT7Am-FwEX$GX}#G&iozZ8itSv*{Fy8Z)#s)Pf^bGd#Ve
zIk~rPcTHcaaa|zVh9NaEJUYl+Rl0B7JJ{UNSi54XHye^E!qqf2W~wb`f8+G%WM<#Y
zj?I}3sSXOrpI*X~z`MS>*4A$(iqtvlsz)|&xoF$?XlPqIh>QPNuMN!{MnimG_r%87
zaP7L#&Snrp6eb_wQD17;j>Ls+n|t@~PxObCEq#eK1~mJqx}cHUy1!*6QM0eE)|GAz
zmZiYpdPmE7O|=pnLoz*2(Gwk9im9yWid;@_<_g1W{8u%@Q*LV>UX#gAcc&*NX?lYJ
z)F2PmXc{m*u{(t;F(>)EdY%4Ot;78*R&=KKPJv~`3Y2AB&aL#T6Li5oWfYC}XtH2}
z=7(bNp2O5=x_)E?#27($;-<{$G*R@7jb|}wNDuN{g`P##6i~5iV0U_O3KwJQH>LQA
zEqU*Z1Tmf*=^IFQjD<*SSaGPl&1zyNJF%Y=Ete%()nKuTQUvLhZNbt0Tlqh6g5>!HZ7GmF5K-ZGP
zZe}@p49r>-FbK{o##bu}85HN0!((L9rjS8$UMXhGOo9p-H0KvYV`!36$RIku6dqHP
zm_i2CdByM;o1_dBFv!j?g$5+7O99ik{8DJ-&Qb~(y62U`BYBdNC}1d`SBf6lvoZw?
z?emMFkv>T&WT>B4ik|M0m_p{edBx}n1c@nR29Z~cUW_0yg{(&87o+DTB&U#xNnSa6
zo@nW*Fy!}AuBQpm(5zZ70^Au)w4x#Slk(;*U6$b2ZjAX>^HDTS=%>&k&*W}~
zMN*6pU{1-LFL**}r0DcIfZ3#GEN&_(yf0`T8IV!jBr+hRm>Fb1M3K|Spp+u!jzJN{
zOdJC;ikUSAMHDe*42mdXz8DZu%w#bjqNtf-P(~5c#DIvR=7<3qMNJR`GK!iV24xgA
zH4F$TYF-$SQOu+;D597dVNgbK)4`yWBIbet5k*Y|b7UO&EHEgdm?>aTMiKMBfQVuy
zf3^tSxgNmGPuPo^_8DHBJ?1TXs;9Y&p69vjMNRUU`vuML
zw1i@&cbc=9xgB#BHL+vP7c{HOm2jX_I+pNXn$NMU7c`mkODJk4=NC}qG|m#CtNj7Y
z;h4MV2^@33z}cH6L+fA2)XlS|Dr7s=%+P3t{NJ_@&7FrKltOl9!N|r3h0MGT)Fi~U
z4f_9$)r=jpYaf&PziX^kl=)-!#cJYKq+MsRmT|>d)&76Opsq;M-(v0X28**9J`jUk
zuZk9D^jDj|B3B;kt
z>(+>LI%IGZ$Y-BMebWL
zs~Hv3Qb8fZVt=qj*}`$Cx#MLDzmNg5KYSiM6JsHxXN$48eG9F6U|7xJ7jFL+kWt*e
zML5`La{jjv$vp>BK9qUB8u6!2*@aA-y$fYh<%Hoh$8ka0wRjpw+M(R
zYTqI#qlkTrfQX{@Ednx%+P4VEC~Ds#D5I!-i-3@#_ALT3irKdaiYR8^A}FJ{eT$%!
zBK9o;B8u9#$dPg2`xZeF#q3)IWfZY*5fD+#zJ)E~fcGtgy{LT)!&}6@h09vRzJ=i}
zX5WH&y_pX6orO$w{38+Hw1?Oaz&=d}?#_XTyO2qcKX7|OL=p;_5m^$7*|%WLi#kKX
zoJH+hFsC&iI#6r0TnPudZ^07sO|K~R3z=W}Q{SFzk%U4fTOksP+PC27nE6z3=4Y0O
z1Kzh_Zf|}@@h@b8=8wObb(tFnI1LM!t%b=beBVO258yTp93T9DnmhmCxT-3Szm#n@
zg#ZQDA(dDcctWJH!PahVXhMk^O$uo(&Wag`wKE1LI?<^ZXW|$&I8o~m
zor+PbMy)eZ0u4~KLeYXLrkX;)phbf&T4&K&f2r4-m+&+l_fJ#W67*eS~9C_L8!C^p;8kB
zdeBy56hBP#>owks?MaQ}x$PRC#r8UlyJCB-#?##P%CjRNw$~VRCNzEvKA~}0Y_HZ-
zx!7K1@VC<7Z>7#(@i1q-DI=+igxI4_7m8elE*2uARu>GBQKO4SE<+a%k&)2FLu6Fz
z0wOZ1bP>sAm^`mEd2VuC<9BYLVUnBB
zR8ww`YE3oeGc?td%cwGW9*(EVD3#m8BO!y+%}!qfwR5Nor)}bLuoTlFzBt
zC<}6o+G;eFlHVtxsg)o{Q!V+NYE8Z5bE=Fns4~W&vU>S1=fjDvdmzTuVvdpJK+Rhrnv$(eDuyt
zcT+g?n(w!5+|s$JwP{bnZ}waKl)u^E;J5m9&0GBKH@Dnb?Kii#r7CO1hgSUC(&V=^
z`%TxUtEz5ICn|4ES5^A$*QYBh{Z?#g#gIvKW-0X7Ud<_1cie+;$U^lrR-_h^JR1P~b-8*`Bcz(C%_j*k|n3-_L&KmmYU}Ag^4^nsqQLJ2A
zfOkFTvc!b7j_K|TbJJDk=2jHDB=Cpn3&TX~yBL==a9bJI0B&t)4f72K>*C!mLZz77
zP^91C#GI)rw--#W!jT`C_H!90=48~_yO?oeZcm-PSFv3!
zw+A0eHRV3bI58(9UQ-Yz^7nEUmv4b94=EYHNo-TgJ&q4zzEn!&?lVn%>Cf@hQJLHgr%w6Qgm$>?f|$x2YWu=4Kn1w
zO@JG4;F87p_jwU&^5c*rmqb74Cu3L|?KyHu3@%Rgz`6L_fOkcy;{oa8?erkHti}({
ziFdA~$%x`F=N2#Vyf_UO7H)OS^Ta&Wl*lxIEnd)DbXtD
z#;?_nSDY(b=Xs(HQ8L*ZaOCE|9VcU0n(R%K>&IQLukr0}`bHhOGvK;3`c`ASBdsF4
zeZA+!9k{*Vbn)Z%j)OboU~lj`^j`;V5!@LEZlS_WU#ilL+waINffMJ7lqj}5F1=Oy
ze#yBBa4vCPU9E5T+}TfB0=KN{lk4kZaRtgVoEH`<6JK|bm1_W
z?0pp+hN3W;xWnMk)x%`sUImA)8731~Qtx?iIZP&QGdNU9m`vQg;LrraWa7RH&Lw`&
zf!eS%|n23#E5
zDUrSJFnfdGaB7mX_ggH+1uDS4@P7R<|&H0~@5iXF!|u4TBpI6&ED3
z$MuzOc8gy>xMEzJQ6hUKOyA(UrM|}ioAix>6Yo2rME1D8BQ0nv1Yt=Wk6+{#FZUh<
zLW!HdV0nAaf}{2~4cMeFvQ1xaTwgah7k&G|#c|C_iS&Js>6^Mu>N{-FcMRN&#va#q
z;Qem;=D}r29G0Z-UZ!v61GtVyz8DW4wdgwy?ugPc$sX4?@gtn?!VV?kc>T6bc-~QE
zU?MI&&ID~K{y5$PN5-%uF2(#vfg?X&17~Un?cm}Xd)$w`;2Jd?_u~+_ViEZ)AR)21o7rZ?I?bV+q_ojXv(jz!81B=YGtC8`s!d!2JTHn!KSWWt@L$(KiOJ
z2)r$MN1Vg0Lix>stbMT+=^zoR2;4dEeLA`ziCI|MxP^kAOGDc?evrP#PqC
z+>fzSp4TriqaXeYxPO3icS>aMQ%v6h++d`30N0KB4uQ*Tkpnr|1%jc>YK6X
zOM{CGLqQ^YJboE)LJKA0xV|Ic&JctpadWGd_oJyPsSi!e7{6oS+BNN->nnTQP2T{x
zC5^s^n7;leq`s3DeM8{7aZN~x{N?(xue<4M`Derv@2{dn_U>W&X3t1{e*kQ1f2YA^
z9s2Lwf8F#ocq?=7YvuZGVEWottPK0dA1(U2!6mLBYqGuY_>Ek((y9Gr!A()nV3t-R
zOy9&?rM^=ZebeCLCFj;Rf1{he#&@jr&S>iQDV*D?$C+f4)c2xA-$ro5Z$7ua*$=qs
zOLnf*-mm*I(>K#4_03!KEr2^Fhv%?9c>NygcGDNziTFu(Lwh@zzT#a{-%A#KrQl9u
zUrN+oxW1x~xasQ#r_;BN>Fel``d+r^%YcjF+L4k;U;jgH`ewoHB_l9OtFK3wx4*V=
zsc!+CX?*Dh7q26A(jJfBz>9AB=D;1&^p9UKeIqYReXm&b9RQb&pIhH(w9sjMIRj4D
zfA=wci{}@H^HG+g|3TZvtGeCVpF)zOr>v-(M{HlHitbZb6CK3$Ncq
zt((3faJu8~8m4csPU<^t(KiaNWD}_~x4(&gH+`!=QK%iSPT?4;j?Z%gQs1i;rE4TE0@~`I`EDi0SJcmHPf_(Ki4tOO*id&L-vGD@jXmD}CLVRu
zxB9TY{XNL^6-`Th&sp@9fGaDd=$ZRRzKFstD%u9W^q&K#|VQ>rL
zLODoekH@d?bvJ!8;P#Ob*re53rmyQ?Qr|2%Q~&4zx4W3sNqb!1%z06#<8LB@#;l1S
zE?<_lzeF?|9)IU7`cmLB4(Im=-{PjPI3D%d&{ru@{EjevT~|wezq9D;0XIg*uq1mt
zez9w!UP{xCI%uCDul;RN?S0WvrZ0W1)VFBS*8y%GZG)0YUt>koX?z|6C(5Hl_U>Z(
z`YWU1{m$P2Mt1IxfA2C3ZlfkHJbts)ZuOf?M7?Peg)(XN8d?v^TB?b9J=jKxxJKqj
zrdIlq1#I%8A6$xzVM+G5AJgE*G#qaSyX&G}85vRRaX*HVQSJAutC%0t;KVQ_?xRm(
zY4YPZxC)2stw>W;`+XGmV**?l48@Nbj1lVbXkvrZ_q0XdG`JW{Qlb#?IL~a-*9X^E
z`mU(qo+xFro&!1Rr^OMSlvZ|WZt
z;C5^5aebxlaqH((;997Wz%H#GLrm5FvHE>d-@_Jtad5>B*E8ikZvA%_TtsvHc#!Fv
z`>53Sq($E%xCMvyH*;^)YlIz26c=8iav4n(DU$+@i)`Ucc#2
zN43x8a(yG`PHENkK!ow0aUNYX3-oS?YVjqOSv-`dm2KPQSU%-B3TWA{GkA5juf<){0Gj0f6
zMq}@j;FNCTEqxQ?F3z)mj_sdgA#4-&E>gJNjPs|W-hqI-SmA^g)!(DwDgsW_7x}S~aZBJt
z+(fyeT@uIbMIMp%E>$>gF9DA1y+Pr`t!7nU12~~elpC{fX@wJqFVe^DbtoJj{WfwL
zg}cnc^(kD5g&S13H5P7E;ofB7#uW~ak{kV)RJc+LcU0lT?P^o}W)*I&g*&Zq;`dx8
zdrJxzw{XRe%64#tg)3FKD;18n({ga4zC^pa%EG0hwQz~Y^Vh$^-Z~3625tuV
zf-ARheNV`7QanCF?SRnH*Pw8Cl;+KTP)nL
z!fmr~qYBq*;l>nBoR^#QjVs)(7H&e}wp+MKg}cqdO)H!jQ%D~lUygz+LB1Fd@JOhU
zn^(BoE!>jA?XqyOU&?YnWZ}xeiSPG?zPl{k*sr9$yDi)#xc2k%_Vy?oZ&$IW<@on8
zh2!xn1s6xY(D!kLugg&PA$_3@a6OPrMcK5607;O3Ao;`eI{SN@0meHFnyW8sFuQT;w^;l{yH
z{7zW7d2p*yrYQHMh0Fd?o`;>XaBXu^-%A!Q11=tv`-+7dJSF{j)xu4Kqk4PI!nM7S
z|K3IT`?`hedr|uFZwoi9aR0Gz;|f=Rvg!E7$G>TCV!RXjRw!IMwynY+rK8|zJSbE+
zZZE6Yiz*zqx1{J3_hv{R=VJ3RE@BP}6IZTqZ?JGFa9wap_hkGTZ3&l?1d={
p?!F7dkKw(>OR!1h?#@QN!%b&%FfF(q%BiU>^6sY(Sc-g+{s))$01p5F

literal 0
HcmV?d00001

diff --git a/OBJ/heap_4.crf b/OBJ/heap_4.crf
new file mode 100644
index 0000000000000000000000000000000000000000..126eecfe908d2e383e942884fe8135ff0b654829
GIT binary patch
literal 568129
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	pve32WK^mTU
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
        %5YTBSXn6`uf}TuSD|7<%RLTR{#z9Y~>^XE8
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%0Avh~|6`~KkN;z+
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

literal 0
HcmV?d00001

diff --git a/OBJ/key.d b/OBJ/key.d
new file mode 100644
index 0000000..a0605e1
--- /dev/null
+++ b/OBJ/key.d
@@ -0,0 +1,78 @@
+..\obj\key.o: ..\HARDWARE\key.c
+..\obj\key.o: ..\HARDWARE\key.h
+..\obj\key.o: ..\SYSTEM\sys\sys.h
+..\obj\key.o: ..\USER\stm32f4xx.h
+..\obj\key.o: ..\CORE\core_cm4.h
+..\obj\key.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\stdint.h
+..\obj\key.o: ..\CORE\core_cmInstr.h
+..\obj\key.o: ..\CORE\core_cmFunc.h
+..\obj\key.o: ..\CORE\core_cm4_simd.h
+..\obj\key.o: ..\USER\system_stm32f4xx.h
+..\obj\key.o: ..\CORE\arm_math.h
+..\obj\key.o: ..\CORE\core_cm4.h
+..\obj\key.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\string.h
+..\obj\key.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\math.h
+..\obj\key.o: ..\USER\stm32f4xx_conf.h
+..\obj\key.o: ..\FWLIB\inc\stm32f4xx_adc.h
+..\obj\key.o: ..\USER\stm32f4xx.h
+..\obj\key.o: ..\FWLIB\inc\stm32f4xx_crc.h
+..\obj\key.o: ..\FWLIB\inc\stm32f4xx_dbgmcu.h
+..\obj\key.o: ..\FWLIB\inc\stm32f4xx_dma.h
+..\obj\key.o: ..\FWLIB\inc\stm32f4xx_exti.h
+..\obj\key.o: ..\FWLIB\inc\stm32f4xx_flash.h
+..\obj\key.o: ..\FWLIB\inc\stm32f4xx_gpio.h
+..\obj\key.o: ..\FWLIB\inc\stm32f4xx_i2c.h
+..\obj\key.o: ..\FWLIB\inc\stm32f4xx_iwdg.h
+..\obj\key.o: ..\FWLIB\inc\stm32f4xx_pwr.h
+..\obj\key.o: ..\FWLIB\inc\stm32f4xx_rcc.h
+..\obj\key.o: ..\FWLIB\inc\stm32f4xx_rtc.h
+..\obj\key.o: ..\FWLIB\inc\stm32f4xx_sdio.h
+..\obj\key.o: ..\FWLIB\inc\stm32f4xx_spi.h
+..\obj\key.o: ..\FWLIB\inc\stm32f4xx_syscfg.h
+..\obj\key.o: ..\FWLIB\inc\stm32f4xx_tim.h
+..\obj\key.o: ..\FWLIB\inc\stm32f4xx_usart.h
+..\obj\key.o: ..\FWLIB\inc\stm32f4xx_wwdg.h
+..\obj\key.o: ..\FWLIB\inc\misc.h
+..\obj\key.o: ..\FWLIB\inc\stm32f4xx_cryp.h
+..\obj\key.o: ..\FWLIB\inc\stm32f4xx_hash.h
+..\obj\key.o: ..\FWLIB\inc\stm32f4xx_rng.h
+..\obj\key.o: ..\FWLIB\inc\stm32f4xx_can.h
+..\obj\key.o: ..\FWLIB\inc\stm32f4xx_dac.h
+..\obj\key.o: ..\FWLIB\inc\stm32f4xx_dcmi.h
+..\obj\key.o: ..\FWLIB\inc\stm32f4xx_fsmc.h
+..\obj\key.o: ..\BALANCE\system.h
+..\obj\key.o: ..\FreeRTOS\include\FreeRTOSConfig.h
+..\obj\key.o: ..\SYSTEM\usart\usart.h
+..\obj\key.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\stdio.h
+..\obj\key.o: ..\FreeRTOS\include\FreeRTOS.h
+..\obj\key.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\stddef.h
+..\obj\key.o: ..\FreeRTOS\include\projdefs.h
+..\obj\key.o: ..\FreeRTOS\include\portable.h
+..\obj\key.o: ..\FreeRTOS\include\deprecated_definitions.h
+..\obj\key.o: ..\FreeRTOS\portable\RVDS\ARM_CM4F\portmacro.h
+..\obj\key.o: ..\FreeRTOS\include\mpu_wrappers.h
+..\obj\key.o: ..\FreeRTOS\include\task.h
+..\obj\key.o: ..\FreeRTOS\include\list.h
+..\obj\key.o: ..\FreeRTOS\include\queue.h
+..\obj\key.o: ..\FreeRTOS\include\timers.h
+..\obj\key.o: ..\FreeRTOS\include\semphr.h
+..\obj\key.o: ..\SYSTEM\delay\delay.h
+..\obj\key.o: ..\BALANCE\balance.h
+..\obj\key.o: ..\BALANCE\system.h
+..\obj\key.o: ..\HARDWARE\led.h
+..\obj\key.o: ..\HARDWARE\oled.h
+..\obj\key.o: ..\HARDWARE\usartx.h
+..\obj\key.o: ..\HARDWARE\adc.h
+..\obj\key.o: ..\HARDWARE\can.h
+..\obj\key.o: ..\HARDWARE\motor.h
+..\obj\key.o: ..\HARDWARE\timer.h
+..\obj\key.o: ..\HARDWARE\encoder.h
+..\obj\key.o: ..\BALANCE\show.h
+..\obj\key.o: ..\HARDWARE\pstwo.h
+..\obj\key.o: ..\HARDWARE\key.h
+..\obj\key.o: ..\BALANCE\robot_select_init.h
+..\obj\key.o: ..\HARDWARE\MPU6050\I2C.h
+..\obj\key.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\stdbool.h
+..\obj\key.o: ..\HARDWARE\MPU6050\MPU6050.h
+..\obj\key.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\stdlib.h
+..\obj\key.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\stdarg.h
diff --git a/OBJ/key.o b/OBJ/key.o
new file mode 100644
index 0000000000000000000000000000000000000000..148fe3b0e10a38b036274640a1e2d5d47d494b85
GIT binary patch
literal 582536
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
z
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
        6I0xL1rhsbD4xlOE4DevJyad&t
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%0DNw*^eEiJk8tU$Ieoo=56((
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%0A591}J-X<43JcRl6%^nWMIS
zk|X_<-I6NXT(wce>?vH+mfZW59HXDu%aLEVRK*ve&zQkkv$)G#{u}g95#7h!@~5Bl
z6nW3n{G7NY=QzCU
zFCYFkzP;U5@xa*AC~v0CM=Kt-8mmw#T36ZgZMI7LytSuFhe|=&x<+NBNY|CovWlN{
z-;HwZr>wnII$X-`MGN<)RplowOox`Pe4Mx2SGCci>{gu7mfTMKdMV;J^49*UeT^fx
zxXT?%yvP0P=<3Zmqm@3>rnf1al8PRr%f7(V9;g!1m*OlXWp%>Od9X@<#~#QzX6VH1
z8QiS_+6*5vdg*bD+L*nK-wvf)_E42UB3IrY`GTi##{H5^DIeqmA1LKj-tchM#x=oJ
Tw!W%?f9`u_XN_gq)~Ej;g!kV#

literal 0
HcmV?d00001

diff --git a/OBJ/heap_4.d b/OBJ/heap_4.d
new file mode 100644
index 0000000..58fd512
--- /dev/null
+++ b/OBJ/heap_4.d
@@ -0,0 +1,54 @@
+..\obj\heap_4.o: ..\FreeRTOS\portable\MemMang\heap_4.c
+..\obj\heap_4.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\stdlib.h
+..\obj\heap_4.o: ..\FreeRTOS\include\FreeRTOS.h
+..\obj\heap_4.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\stddef.h
+..\obj\heap_4.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\stdint.h
+..\obj\heap_4.o: ..\FreeRTOS\include\FreeRTOSConfig.h
+..\obj\heap_4.o: ..\SYSTEM\sys\sys.h
+..\obj\heap_4.o: ..\USER\stm32f4xx.h
+..\obj\heap_4.o: ..\CORE\core_cm4.h
+..\obj\heap_4.o: ..\CORE\core_cmInstr.h
+..\obj\heap_4.o: ..\CORE\core_cmFunc.h
+..\obj\heap_4.o: ..\CORE\core_cm4_simd.h
+..\obj\heap_4.o: ..\USER\system_stm32f4xx.h
+..\obj\heap_4.o: ..\CORE\arm_math.h
+..\obj\heap_4.o: ..\CORE\core_cm4.h
+..\obj\heap_4.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\string.h
+..\obj\heap_4.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\math.h
+..\obj\heap_4.o: ..\USER\stm32f4xx_conf.h
+..\obj\heap_4.o: ..\FWLIB\inc\stm32f4xx_adc.h
+..\obj\heap_4.o: ..\USER\stm32f4xx.h
+..\obj\heap_4.o: ..\FWLIB\inc\stm32f4xx_crc.h
+..\obj\heap_4.o: ..\FWLIB\inc\stm32f4xx_dbgmcu.h
+..\obj\heap_4.o: ..\FWLIB\inc\stm32f4xx_dma.h
+..\obj\heap_4.o: ..\FWLIB\inc\stm32f4xx_exti.h
+..\obj\heap_4.o: ..\FWLIB\inc\stm32f4xx_flash.h
+..\obj\heap_4.o: ..\FWLIB\inc\stm32f4xx_gpio.h
+..\obj\heap_4.o: ..\FWLIB\inc\stm32f4xx_i2c.h
+..\obj\heap_4.o: ..\FWLIB\inc\stm32f4xx_iwdg.h
+..\obj\heap_4.o: ..\FWLIB\inc\stm32f4xx_pwr.h
+..\obj\heap_4.o: ..\FWLIB\inc\stm32f4xx_rcc.h
+..\obj\heap_4.o: ..\FWLIB\inc\stm32f4xx_rtc.h
+..\obj\heap_4.o: ..\FWLIB\inc\stm32f4xx_sdio.h
+..\obj\heap_4.o: ..\FWLIB\inc\stm32f4xx_spi.h
+..\obj\heap_4.o: ..\FWLIB\inc\stm32f4xx_syscfg.h
+..\obj\heap_4.o: ..\FWLIB\inc\stm32f4xx_tim.h
+..\obj\heap_4.o: ..\FWLIB\inc\stm32f4xx_usart.h
+..\obj\heap_4.o: ..\FWLIB\inc\stm32f4xx_wwdg.h
+..\obj\heap_4.o: ..\FWLIB\inc\misc.h
+..\obj\heap_4.o: ..\FWLIB\inc\stm32f4xx_cryp.h
+..\obj\heap_4.o: ..\FWLIB\inc\stm32f4xx_hash.h
+..\obj\heap_4.o: ..\FWLIB\inc\stm32f4xx_rng.h
+..\obj\heap_4.o: ..\FWLIB\inc\stm32f4xx_can.h
+..\obj\heap_4.o: ..\FWLIB\inc\stm32f4xx_dac.h
+..\obj\heap_4.o: ..\FWLIB\inc\stm32f4xx_dcmi.h
+..\obj\heap_4.o: ..\FWLIB\inc\stm32f4xx_fsmc.h
+..\obj\heap_4.o: ..\SYSTEM\usart\usart.h
+..\obj\heap_4.o: D:\Keil_v5\ARM\ARMCC\Bin\..\include\stdio.h
+..\obj\heap_4.o: ..\FreeRTOS\include\projdefs.h
+..\obj\heap_4.o: ..\FreeRTOS\include\portable.h
+..\obj\heap_4.o: ..\FreeRTOS\include\deprecated_definitions.h
+..\obj\heap_4.o: ..\FreeRTOS\portable\RVDS\ARM_CM4F\portmacro.h
+..\obj\heap_4.o: ..\FreeRTOS\include\mpu_wrappers.h
+..\obj\heap_4.o: ..\FreeRTOS\include\task.h
+..\obj\heap_4.o: ..\FreeRTOS\include\list.h
diff --git a/OBJ/heap_4.o b/OBJ/heap_4.o
new file mode 100644
index 0000000000000000000000000000000000000000..f6ac3f174e6b3b57b3b37dca9e8d5c6d940429d0
GIT binary patch
literal 539484
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≠7|oRS;pI{VH&lG
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