ch592-projects/vendor/FreeRTOS

本工程为 FreeRTOS-KernelV10.5.1 在Qingke V4C RISC-V内核的CH592/1上的移植。

需要注意以下几点：

	1.配置文件路径为工程目录下FreeRTOS/FreeRTOSConfig.h
	
	2.本移植例程默认使用了硬件压栈（不可关闭），未使用中断嵌套，用户使用的外部中断函数最好使用__attribute__((section(".highcode")))修饰，保证运行速度。
	
	3.使能中断嵌套会导致每个中断执行会多约10个指令周期，中断嵌套使能通过工程右键 -> properties -> c/c++ Build -> settings -> tool settings -> GNU RISC-V Cross Assembler -> Preprocessor 右边输入框Defined symbols中的 ENABLE_INTERRUPT_NEST=0 修改为 ENABLE_INTERRUPT_NEST=1 即可。

	4.startup_ch592.S中_vector_base下面的中断向量表库中如果是unified_interrupt_entry中断函数，则是统一入口中断函数，不需要再使用__attribute__((interrupt("WCH-Interrupt-fast")))或者__attribute__((interrupt()))修饰。其他则非统一入口，需要使用__attribute__((interrupt("WCH-Interrupt-fast")))或者__attribute__((interrupt()))修饰。
	
	5.CH592系列上电运行默认的栈为编译后剩余的RAM空间。所有统一入口的中断会把栈修改为LD文件中提供的__freertos_irq_stack_top，所以中断中可以使用的最大栈空间为RAM剩余空间。所以请一定要预留RAM空间给栈使用。
		
	6.因为Systick中断经常处理，所以Systick中断不从统一中断入口处理，并使用了__attribute__((interrupt("WCH-Interrupt-fast")))修饰，Systick中调用的函数栈不大，所以未切换为中断栈，提升速度。
	
	7.中断中使用了CSR寄存器mscratch作为sp指针的临时寄存器，所以用户不可以再自行使用mscratch寄存器。
	
	8.不建议使用蓝牙，使用蓝牙的话可以创建一个优先级仅比IDLE TASK高一级的任务，循环运行TMOS_SystemProcess，不主动退出任务，由其他更高优先级任务抢断。由于蓝牙中断为库内中断函数，使用了免表中断方式，所以初始化蓝牙时需要关闭中断，等初始化完成后失能免表中断。在StartUP.S文件中，已经将LIB中真正的中断函数地址BB_IRQLibHandler和LLE_IRQLibHandler放入中断向量表中。
	
	9.本工程的Startup.S文件和Ld文件都是单独的，用户中断向量表可见Startup.S，用户中断总入口unified_interrupt_entry和中断向量表_real_user_vector_base就在该文件中。
	
	10.FreeRTOS任务中函数的打印最好使用main.c中提供的APP_Printf进行，不然可能会导致HardFault。
		
	11.CH592的蓝牙会采用类似于RTOS操作，在中断中切换到另一个运行环境等待蓝牙事件完成，所以如果使用蓝牙，则必须在ble_task_scheduler.S中，添加调用其他函数用来停止FreeRTOS操作系统，防止在蓝牙内部任务中被切换。

	12.CH592不可以使用原core_riscv.h中的 __enable_irq 和 __disable_irq 函数，使用freertos中提供的 portENTER_CRITICAL 和 portEXIT_CRITICAL。