{"type":"doc","content":[{"type":"paragraph","content":[{"text":"FreeRTOS, short for Free Real-Time Operating System, is an open-source, real-time operating system kernel designed for embedded systems. Developed by Real Time Engineers Ltd., FreeRTOS is known for its simplicity and flexibility, making it a popular choice for a wide range of microcontroller-based applications.","type":"text"}]},{"type":"paragraph","content":[{"text":"For further information, refer to official web site: ","type":"text"},{"text":"FreeRTOS - Real-time operating system for microcontrollers","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.freertos.org/"}}]}]},{"type":"paragraph","content":[{"text":"CM4 startup is controlled by the kernel through the use of ","type":"text"},{"text":"remoteproc","type":"text","marks":[{"type":"em"}]},{"text":" driver. CM4 software implements control of each power domain when the system is suspended or resume. It also includes polling wake-up key to enter or exit deep-sleep mode, power down or up main-domain, CA55, NPU, video codec powers, and data communication between CA55 and CM4 via virtIO as well.","type":"text"}]},{"type":"paragraph","content":[{"text":"Table of Contents","type":"text","marks":[{"type":"strong"}]}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"style":{"value":"none"}},"macroMetadata":{"macroId":{"value":"9d50ec82-8295-459c-bae2-504d0cf45ddb"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"db553ea2-fe01-483e-8572-731632a08aa5"}},{"type":"heading","attrs":{"level":3},"content":[{"text":"Features","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Output log at UART6 (set at 115,200 bps by x-boot).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Support SP7350 power manager","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Detect wake-up key","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Power down and up control for main-domain, CA55, NPU, video codec","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Support DDR retention","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Support PMIC control","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Support communication with CA55 via virtual l/O serial port","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Support CmBacktrace to tracks and debug ARM Cortex-M4","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Support Arduino hardware interface, such as SPI, I2C, UART, timer, GPIO.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Support CUnit test of SPI, I2C, UART, timer, GPIO driver","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Default Tasks","type":"text"}]},{"type":"paragraph","content":[{"text":"By default, FreeRTOS of SP7350 platform is configured to run 6 tasks. In table below, we outline each task along with its location of source files and functionality.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"b0a033cf-b5ca-4c68-801c-f8ab34cd352f"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#deebff","rowspan":1,"colwidth":[125.0]},"content":[{"type":"paragraph","content":[{"text":"Tasks","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#deebff","rowspan":1,"colwidth":[338.0]},"content":[{"type":"paragraph","content":[{"text":"Files (under FreeRTOS project directory)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#deebff","rowspan":1,"colwidth":[296.0]},"content":[{"type":"paragraph","content":[{"text":"Descriptions","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[125.0]},"content":[{"type":"paragraph","content":[{"text":"powerdown","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[338.0]},"content":[{"type":"paragraph","content":[{"text":"application/power_manager/power_down.c","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[296.0]},"content":[{"type":"paragraph","content":[{"text":"power-down control","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[125.0]},"content":[{"type":"paragraph","content":[{"text":"powerup","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[338.0]},"content":[{"type":"paragraph","content":[{"text":"application/power_manager/power_up.c","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[296.0]},"content":[{"type":"paragraph","content":[{"text":"power-up control","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[125.0]},"content":[{"type":"paragraph","content":[{"text":"wakeupkey","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[338.0]},"content":[{"type":"paragraph","content":[{"text":"application/power_manager/wakeup_key.c","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[296.0]},"content":[{"type":"paragraph","content":[{"text":"Detect wake-up key","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[125.0]},"content":[{"type":"paragraph","content":[{"text":"virtIOrw","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[338.0]},"content":[{"type":"paragraph","content":[{"text":"application/VirtIOSerial/vios_rw.cpp","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[296.0]},"content":[{"type":"paragraph","content":[{"text":"virtual IO read/write","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[125.0]},"content":[{"type":"paragraph","content":[{"text":"tmr Svc","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[338.0]},"content":[{"type":"paragraph","content":[{"text":"system/freertos/timers.c","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[296.0]},"content":[{"type":"paragraph","content":[{"text":"FreeRTOS system Timer task","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[125.0]},"content":[{"type":"paragraph","content":[{"text":"Idle","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[338.0]},"content":[{"type":"paragraph","content":[{"text":"system/freertos/tasks.c","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[296.0]},"content":[{"type":"paragraph","content":[{"text":"FreeRTOS system Idle task","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The source files of FreeRTOS are located within the \"firmware/arduino_core_sunplus/\" directory under the project's top directory.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Linux Remote Processor Framework","type":"text"}]},{"type":"paragraph","content":[{"text":"The Linux Remote Processor Framework is a framework that allows for managing (power on, load firmware, power off) and communicating with remote processors on Linux systems. This framework is typically used in embedded or multiprocessor systems where one processor (usually the main processor) is responsible for managing and controlling the other remote processors. In addition, this framework also adds ","type":"text"},{"text":"rpmsg","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"virtio","type":"text","marks":[{"type":"em"}]},{"text":" devices for remote processors that supports this kind of communication. This way, platform-specific ","type":"text"},{"text":"remoteproc","type":"text","marks":[{"type":"em"}]},{"text":" driver only needs to provide a few low-level handlers, and then all ","type":"text"},{"text":"rpmsg","type":"text","marks":[{"type":"em"}]},{"text":" drivers will then just work. For example:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Load firmware of CM4 via Linux shell command:","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":"echo firmware > /sys/class/remoteproc/remoteproc/firmware","type":"text"}]},{"type":"paragraph","content":[{"text":"where ‘firmware’ is the firmware file (elf format) of CM4 stored at “/lib/firmware/\".","type":"text"}]},{"type":"orderedList","attrs":{"order":2},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Start CM4 via Linux shell command:","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":" echo start > /sys/class/remoteproc/remoteproc0/state","type":"text"}]},{"type":"orderedList","attrs":{"order":3},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Stop CM4 via Linux shell command:","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":"echo stop > /sys/class/remoteproc/remoteproc0/state","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Linux Remoteproc Driver","type":"text"}]},{"type":"paragraph","content":[{"text":"The remoteproc driver bases on Remote Processor Framework to implement firmware loading and booting, resource allocation and management, communication support, and other functions.","type":"text"}]},{"type":"paragraph","content":[{"text":"Enabling remoteproc driver in Linux kernel needs to enable the kernel feature: ","type":"text"}]},{"type":"paragraph","content":[{"text":"CONFIG_REMOTEPROC=y and","type":"text"}]},{"type":"paragraph","content":[{"text":"CONFIG_SUNPLUS_REMOTEPROC=y","type":"text"}]},{"type":"paragraph","content":[{"text":"in default configuration file.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Device-tree Nodes for Remoteproc Driver","type":"text"}]},{"type":"codeBlock","content":[{"text":"\tremoteproc0: remoteproc@f800817c {\n\t\tcompatible = \"sunplus,sp-rproc\";\n\t\tfirmware = \"firmware\";\n\t\treg = <0 0xf800817c 0 4>, /* mbox G258.31, cpu0 to cpu2 direct reg07 */\n\t\t <0 0xf8800250 0 4>,\n\t\t <0 0xf80081fc 0 4>; /* mbox G259.31, cpu2 to cpu0 direct reg07 */\n\t\tinterrupt-parent = <&gic>;\n\t\tinterrupts = ; /* CPU2_TO_0_DIRECT_INT7 */\n\t\tresets = <&rstc RST_CM4>;\n\t\tmemory-region = <&rproc_0_reserved>, <&rproc0runaddr>,<&vdev0buffer>, <&vdev0vring0>, <&vdev0vring1>;\n\t};","type":"text"}]},{"type":"paragraph","content":[{"text":"In the RemoteProc framework, vdev0vring0, vdev0vring1, and vdev0buffer are typically used in conjunction with Virtio devices for efficient data transfers between the host processor and the remote processor.","type":"text"}]},{"type":"paragraph","content":[{"text":"vring0 and vring1 represent the two virtual rings of a Virtio device, typically one for sending data and the other for receiving data. These two rings pass data and control information through a set of descriptors. vbuffer represents the Virtio device's buffer, which is used to store data.","type":"text"}]},{"type":"paragraph","content":[{"text":"The remoteproc-related dts notes are as follows: ","type":"text"}]},{"type":"codeBlock","content":[{"text":"\tvdev0buffer: vdev0buffer@5be00000 {\n\t\tcompatible = \"shared-dma-pool\";\n\t\treg = <0x0 0x5be00000 0x0 0x100000>;\n\t\tno-map;\n\t};\n\tvdev0vring0: vdev0vring0@5bf00000 {\n\t\tcompatible = \"shared-dma-pool\";\n\t\treg = <0x0 0x5bf00000 0x0 0x10000>;\n\t\tno-map;\n\t};\n\tvdev0vring1: vdev0vring1@5bf10000 {\n\t\tcompatible = \"shared-dma-pool\";\n\t\treg = <0x0 0x5bf10000 0x0 0x10000>;\n\t\tno-map;\n\t};","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"RPMSG and Virtual IO","type":"text"}]},{"type":"paragraph","content":[{"text":"The RPMsg framework (Remote Processor Messaging Framework) is an implementation of remote processor messaging. It allows communication between different processors, including communication between the main processor and remote processors, and it is a VirtIO-based message bus that allows Linux kernel drivers to communicate with remote processors in the system.","type":"text"}]},{"type":"paragraph","content":[{"text":"Enabling RPMSG and VirtIO in kernel needs to enable the kernel feature:","type":"text"}]},{"type":"paragraph","content":[{"text":"CONFIG_RPMSG=y and","type":"text"}]},{"type":"paragraph","content":[{"text":"CONFIG_RPMSG_VIRTIO=y","type":"text"}]},{"type":"paragraph","content":[{"text":"in default configuration file.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"RPMSG: After CM4 is running, a device node /dev/ttyRPMSGx is generated on the kernel side, and the kernel side communicates with CM4 via /dev/ttyRPMSGx. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"VirtIO: Virtio is a standard for high-performance virtual appliances in virtualized environments, CM4 write/read VirtioSerial to transfer data to /dev/ttyRPMSGX","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Build Image","type":"text"}]},{"type":"paragraph","content":[{"text":"Use “","type":"text"},{"text":"make firmware","type":"text","marks":[{"type":"code"}]},{"text":"\" in the root directory to compile the FreeRTOS code, The output file after compilation is put in bin/firmware. You need to copy it to linux/rootfs/initramfs/disk/lib/firmware in project directory.","type":"text"}]},{"type":"paragraph","content":[{"text":"This project includes several code environments, including FreeRTOS+Arduino (default), Arduino, and CUnit, and the different code environments are determined by the configuration of the ","type":"text"},{"text":"Makefile","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FreeRTOS+Arduino: The default compiled image is based on the FreeRTOS environment, It implements power management function for suspend and resume processes.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Arduino: Set ","type":"text"},{"text":"FREERTOS ?=0","type":"text","marks":[{"type":"code"}]},{"text":" in ","type":"text"},{"text":"Makefile","type":"text","marks":[{"type":"em"}]},{"text":" will compile the code environment with only Arduino, not FreeRTOS. The entry function of the program is in ‘application/arduino_main.cpp’.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CUnit: Set ","type":"text"},{"text":"CUNIT ?=1","type":"text","marks":[{"type":"code"}]},{"text":" in ","type":"text"},{"text":"Makefile","type":"text","marks":[{"type":"em"}]},{"text":". Compiled code contains only CUnit test code, including SPI, I2C, UART, timer, and GPIO test units.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Supported Drivers for SP7350 Platform","type":"text"}]},{"type":"paragraph","content":[{"text":"The source files of FreeRTOS are located within the \"firmware/arduino_core_sunplus/\" directory under the project's top directory. For the SP7350 platform, a wide array of device drivers is supported. These drivers are within the \"system/drivers/sp7350_hal_driver/\" directory. Below is a reference table detailing the drivers along with their corresponding feature descriptions:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"3bc8f79b-045d-4982-a3cb-35585080a6a8"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#deebff","rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"Drivers","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#deebff","rowspan":1,"colwidth":[197.0]},"content":[{"type":"paragraph","content":[{"text":"Files","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#deebff","rowspan":1,"colwidth":[426.0]},"content":[{"type":"paragraph","content":[{"text":"Features","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"ADC (SAR12B)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[197.0]},"content":[{"type":"paragraph","content":[{"text":"sp7350_hal_adc.c","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[426.0]},"content":[{"type":"paragraph","content":[{"text":"read analog voltage","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"Audio (I2S)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[197.0]},"content":[{"type":"paragraph","content":[{"text":"sp7350_hal_i2s.c","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[426.0]},"content":[{"type":"paragraph","content":[{"text":"I2S read/write interface","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"GPIO driver","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[197.0]},"content":[{"type":"paragraph","content":[{"text":"sp7350_hal_gpio.c","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[426.0]},"content":[{"type":"paragraph","content":[{"text":"write/read gpio level","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"AHB DMA","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[197.0]},"content":[{"type":"paragraph","content":[{"text":"sp7350_hal_dma.c","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[426.0]},"content":[{"type":"paragraph","content":[{"text":"AHB DMA driver ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"I2C driver","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[197.0]},"content":[{"type":"paragraph","content":[{"text":"sp7350_hal_i2c.c","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[426.0]},"content":[{"type":"paragraph","content":[{"text":"I2C read/write interface","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"Mailbox","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[197.0]},"content":[{"type":"paragraph","content":[{"text":"sp7350_hal_ipcc.c","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[426.0]},"content":[{"type":"paragraph","content":[{"text":"trigger between CM4 and CA55","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"PWM","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[197.0]},"content":[{"type":"paragraph","content":[{"text":"/sp7350_hal_pwm.c","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[426.0]},"content":[{"type":"paragraph","content":[{"text":"output pwm","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"RTC","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[197.0]},"content":[{"type":"paragraph","content":[{"text":"sp7350_hal_rtc.c","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[426.0]},"content":[{"type":"paragraph","content":[{"text":"get rtc time and generate rtc irq","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"SPI","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[197.0]},"content":[{"type":"paragraph","content":[{"text":"sp7350_hal_spi.c","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[426.0]},"content":[{"type":"paragraph","content":[{"text":"SPI read/write interface","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"Timer","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[197.0]},"content":[{"type":"paragraph","content":[{"text":"sp7350_hal_tim.c","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[426.0]},"content":[{"type":"paragraph","content":[{"text":"get/set timer. generate timer irq","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"UART","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[197.0]},"content":[{"type":"paragraph","content":[{"text":"sp7350_hal_uart.c","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[426.0]},"content":[{"type":"paragraph","content":[{"text":"UART read/write interface","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"Watchdog","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[197.0]},"content":[{"type":"paragraph","content":[{"text":"sp7350_hal_wdg.c","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[426.0]},"content":[{"type":"paragraph","content":[{"text":"watchdog interface","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Source Files","type":"text"}]},{"type":"paragraph","content":[{"text":"The source files of FreeRTOS are organized within the \"firmware/arduino_core_sunplus/\" directory at the project's top directory. Below is a breakdown of the main subdirectories:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"57df07ef-0d1f-4cdf-b3f5-5dd723eb11f7"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#deebff","rowspan":1,"colwidth":[254.0]},"content":[{"type":"paragraph","content":[{"text":"Folders","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#deebff","rowspan":1,"colwidth":[506.0]},"content":[{"type":"paragraph","content":[{"text":"Descriptions","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[254.0]},"content":[{"type":"paragraph","content":[{"text":"cores/arduino","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[506.0]},"content":[{"type":"paragraph","content":[{"text":"Contains the code for Arduino only","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[254.0]},"content":[{"type":"paragraph","content":[{"text":"libraries/","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[506.0]},"content":[{"type":"paragraph","content":[{"text":"Contains the third party source code and ‘syscall.c’","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[254.0]},"content":[{"type":"paragraph","content":[{"text":"application/power_manager/","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[506.0]},"content":[{"type":"paragraph","content":[{"text":"Contains power manager codes ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[254.0]},"content":[{"type":"paragraph","content":[{"text":"application/VirtIOSerial/","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[506.0]},"content":[{"type":"paragraph","content":[{"text":"Contains VirtIO Serial read/write codes ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[254.0]},"content":[{"type":"paragraph","content":[{"text":"bin/","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[506.0]},"content":[{"type":"paragraph","content":[{"text":"Output folder","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[254.0]},"content":[{"type":"paragraph","content":[{"text":"system/drivers","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[506.0]},"content":[{"type":"paragraph","content":[{"text":"Contains CMIS files for CM4 and SP7350 drivers","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[254.0]},"content":[{"type":"paragraph","content":[{"text":"system/freertos","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[506.0]},"content":[{"type":"paragraph","content":[{"text":"Contains FreeRTOS kernel files","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[254.0]},"content":[{"type":"paragraph","content":[{"text":"system/Middlewares","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[506.0]},"content":[{"type":"paragraph","content":[{"text":"Contains Open-amp driver (VirtIO/Remoteproc)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[254.0]},"content":[{"type":"paragraph","content":[{"text":"system/sp7350","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[506.0]},"content":[{"type":"paragraph","content":[{"text":"Contains many constant definitions","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[254.0]},"content":[{"type":"paragraph","content":[{"text":"variants/sp7350_evb/","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[506.0]},"content":[{"type":"paragraph","content":[{"text":"Contains ldscript and config file","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Example Files","type":"text"}]},{"type":"paragraph","content":[{"text":"CUnit is a C unit testing framework for unit testing C programs. It provides a set of libraries and macros for writing and executing test cases and reporting test results. CUnit tests include examples using the SP7350 peripheral interface driver. Includes examples for other drivers such as SPI, I2C, UART, GPIO and PWM. The path is:","type":"text"}]},{"type":"paragraph","content":[{"text":"/application/Cunit_test","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Set ","type":"text"},{"text":"CUNIT ?=1","type":"text","marks":[{"type":"code"}]},{"text":" in ","type":"text"},{"text":"Makefile","type":"text","marks":[{"type":"em"}]},{"text":" to build image. The code will run from Cuint_main.cpp","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"FreeRTOS Log and Explanation","type":"text"}]},{"type":"paragraph","content":[{"text":"The following explains the key lines in the FreeRTOS log:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Line 1: The banner of CM4 firmware.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Line 2-4: Initialize ","type":"text"},{"text":"remoteproc","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Line 5-6: Initialize ","type":"text"},{"text":"rpmsg","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Line 7-12: Create FreeRTOS tasks.","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":"CM4 build @ Mar 7 2024 02:01:06\nSuccessfully intialize remoteproc.\nInitialize remoteproc successfully.\ncreating remoteproc virtio: 0x5be00000\ninitializing rpmsg vdev in mode 1\ninitializing rpmsg vdev done\nCreateTask-viorw-result:1\nCreateTask-wakeupkey-result:1\nCreateTask-powerdown-result:1\nCreateTask-powerup-result:1\nCreateTask-IDLE-result:1\nCreateTask-Tmr Svc-result:1\npower down wait Semaphore !","type":"text"}]}],"version":1}

Browser not supported