Merge pull request 'F446' (#3) from F446 into main

Reviewed-on: https://git.intern.spaceteamaachen.de/ALPAKA/ioc-collection/pulls/3
Reviewed-by: carlwachter <carlwachter@noreply.git.intern.spaceteamaachen.de>

F4xx/F446/STM32F446RETX.ioc

@@ -0,0 +1,107 @@
+#MicroXplorer Configuration settings - do not modify
+CAD.formats=
+CAD.pinconfig=
+CAD.provider=
+FREERTOS.IPParameters=Tasks01,configMINIMAL_STACK_SIZE,configRECORD_STACK_HIGH_ADDRESS,configUSE_MALLOC_FAILED_HOOK,configCHECK_FOR_STACK_OVERFLOW,configTIMER_TASK_PRIORITY,configUSE_NEWLIB_REENTRANT
+FREERTOS.Tasks01=defaultTask,24,256,StartDefaultTask,Default,NULL,Dynamic,NULL,NULL
+FREERTOS.configCHECK_FOR_STACK_OVERFLOW=2
+FREERTOS.configMINIMAL_STACK_SIZE=256
+FREERTOS.configRECORD_STACK_HIGH_ADDRESS=1
+FREERTOS.configTIMER_TASK_PRIORITY=48
+FREERTOS.configUSE_MALLOC_FAILED_HOOK=1
+FREERTOS.configUSE_NEWLIB_REENTRANT=1
+File.Version=6
+KeepUserPlacement=false
+Mcu.CPN=STM32F446RET6
+Mcu.Family=STM32F4
+Mcu.IP0=FREERTOS
+Mcu.IP1=NVIC
+Mcu.IP2=RCC
+Mcu.IP3=SYS
+Mcu.IPNb=4
+Mcu.Name=STM32F446R(C-E)Tx
+Mcu.Package=LQFP64
+Mcu.Pin0=VP_FREERTOS_VS_CMSIS_V2
+Mcu.Pin1=VP_SYS_VS_Systick
+Mcu.PinsNb=2
+Mcu.ThirdPartyNb=0
+Mcu.UserConstants=
+Mcu.UserName=STM32F446RETx
+MxCube.Version=6.12.1
+MxDb.Version=DB.6.0.121
+NVIC.BusFault_IRQn=true\:0\:0\:false\:false\:true\:false\:false\:false\:false
+NVIC.DebugMonitor_IRQn=true\:0\:0\:false\:false\:true\:false\:false\:false\:false
+NVIC.ForceEnableDMAVector=true
+NVIC.HardFault_IRQn=true\:0\:0\:false\:false\:true\:false\:false\:false\:false
+NVIC.MemoryManagement_IRQn=true\:0\:0\:false\:false\:true\:false\:false\:false\:false
+NVIC.NonMaskableInt_IRQn=true\:0\:0\:false\:false\:true\:false\:false\:false\:false
+NVIC.PendSV_IRQn=true\:15\:0\:false\:false\:false\:true\:false\:false\:false
+NVIC.PriorityGroup=NVIC_PRIORITYGROUP_4
+NVIC.SVCall_IRQn=true\:0\:0\:false\:false\:false\:false\:false\:false\:false
+NVIC.SavedPendsvIrqHandlerGenerated=true
+NVIC.SavedSvcallIrqHandlerGenerated=true
+NVIC.SavedSystickIrqHandlerGenerated=true
+NVIC.SysTick_IRQn=true\:15\:0\:false\:false\:true\:true\:false\:true\:false
+NVIC.UsageFault_IRQn=true\:0\:0\:false\:false\:true\:false\:false\:false\:false
+PinOutPanel.RotationAngle=0
+ProjectManager.AskForMigrate=true
+ProjectManager.BackupPrevious=false
+ProjectManager.CompilerOptimize=6
+ProjectManager.ComputerToolchain=false
+ProjectManager.CoupleFile=true
+ProjectManager.CustomerFirmwarePackage=
+ProjectManager.DefaultFWLocation=true
+ProjectManager.DeletePrevious=true
+ProjectManager.DeviceId=STM32F446RETx
+ProjectManager.FirmwarePackage=STM32Cube FW_F4 V1.28.1
+ProjectManager.FreePins=false
+ProjectManager.HalAssertFull=false
+ProjectManager.HeapSize=0x200
+ProjectManager.KeepUserCode=true
+ProjectManager.LastFirmware=true
+ProjectManager.LibraryCopy=1
+ProjectManager.MainLocation=Core/Src
+ProjectManager.MultiThreaded=true
+ProjectManager.NoMain=false
+ProjectManager.PreviousToolchain=
+ProjectManager.ProjectBuild=false
+ProjectManager.ProjectFileName=F446RE.ioc
+ProjectManager.ProjectName=F446RE
+ProjectManager.ProjectStructure=
+ProjectManager.RegisterCallBack=
+ProjectManager.StackSize=0x400
+ProjectManager.TargetToolchain=STM32CubeIDE
+ProjectManager.ThreadSafeStrategy=Cortex-M4NS\:FreeRtosStrategy4,
+ProjectManager.ToolChainLocation=
+ProjectManager.UAScriptAfterPath=
+ProjectManager.UAScriptBeforePath=
+ProjectManager.UnderRoot=true
+ProjectManager.functionlistsort=1-SystemClock_Config-RCC-false-HAL-false
+RCC.CECFreq_Value=32786.88524590164
+RCC.CortexFreq_Value=16000000
+RCC.FamilyName=M
+RCC.IPParameters=CECFreq_Value,CortexFreq_Value,FamilyName,PLLCLKFreq_Value,PLLI2SPCLKFreq_Value,PLLI2SQCLKFreq_Value,PLLI2SRCLKFreq_Value,PLLQCLKFreq_Value,PLLRCLKFreq_Value,PLLSAIPCLKFreq_Value,PLLSAIQCLKFreq_Value,SAIAFreq_Value,SAIBFreq_Value,SDIOFreq_Value,USBFreq_Value,VCOI2SInputFreq_Value,VCOI2SOutputFreq_Value,VCOInputFreq_Value,VCOOutputFreq_Value,VCOSAIInputFreq_Value,VCOSAIOutputFreq_Value
+RCC.PLLCLKFreq_Value=96000000
+RCC.PLLI2SPCLKFreq_Value=96000000
+RCC.PLLI2SQCLKFreq_Value=96000000
+RCC.PLLI2SRCLKFreq_Value=96000000
+RCC.PLLQCLKFreq_Value=96000000
+RCC.PLLRCLKFreq_Value=96000000
+RCC.PLLSAIPCLKFreq_Value=96000000
+RCC.PLLSAIQCLKFreq_Value=96000000
+RCC.SAIAFreq_Value=96000000
+RCC.SAIBFreq_Value=96000000
+RCC.SDIOFreq_Value=96000000
+RCC.USBFreq_Value=96000000
+RCC.VCOI2SInputFreq_Value=1000000
+RCC.VCOI2SOutputFreq_Value=192000000
+RCC.VCOInputFreq_Value=1000000
+RCC.VCOOutputFreq_Value=192000000
+RCC.VCOSAIInputFreq_Value=1000000
+RCC.VCOSAIOutputFreq_Value=192000000
+VP_FREERTOS_VS_CMSIS_V2.Mode=CMSIS_V2
+VP_FREERTOS_VS_CMSIS_V2.Signal=FREERTOS_VS_CMSIS_V2
+VP_SYS_VS_Systick.Mode=SysTick
+VP_SYS_VS_Systick.Signal=SYS_VS_Systick
+board=custom
+isbadioc=false

README.md

@@ -1,3 +1,42 @@
 # ioc-collection
 
-A collection of .ioc files for working with different STM32 μCs and TACOS.
+A collection of .ioc-files for working with different STM32 μCs and TACOS. The .ioc-files are already correctly configured for TACOS-based projects. 
+
+## Using An .ioc
+
+You can create a project from an existing .ioc-file (e.g. one of the .ioc's provided in this repository) by pressing `file > new > STM32 Project from an Existing STM32CubeMX Configuration File` and choosing the desired file under `STM32CubeMX .ioc file > Browse`.
+
+## Creating An .ioc
+
+If your microcontroller is not supported yet, you can create a .ioc-file by creating a new project with the desired microcontroller and selecting the following settings in the project's .ioc: 
+
+`Project Manager > Project`
+
+![Step 1](media/6Cggrafik.png) 
+
+`Project Manager > Code Generator`
+
+![Step 2](media/StCgrafik.png) 
+
+`Pinout & Configuration > Middleware and Software Packs`
+
+![Step 3](media/bV1grafik.png) 
+
+`Pinout & Configuration > Middleware and Software Packs > FREERTOS > Config Parameters`
+
+![Step 4](media/vXUgrafik.png) 
+
+![Step 5](media/z9wgrafik.png)
+
+`Pinout & Configuration > Middleware and Software Packs > FREERTOS > Advanced Settings`
+
+![Step 5](media/RMqgrafik.png)
+
+Please note that 256 words (1 word = 4 bytes) of stack memory tend to be insufficient for many applications. You might want to increase that by adjusting the setting 
+* `Pinout & Configuration > Middleware and Software Packs > FREERTOS > Config parameters > Kernel Settings > MINIMAL_STACK_SIZE`. 
+
+Usually, you also have to increase the FreeRTOS heap size via
+* `Pinout & Configuration > Middleware and Software Packs > FREERTOS > Config parameters > Memory management settings > TOTAL_HEAP_SIZE` 
+since the stack of each task is allocated on the FreeRTOS heap. 
+
+###