/K210_FreeRTOS_SDK

FreeRTOS SDK for Kendryte K210

Primary LanguageCApache License 2.0Apache-2.0

Kendryte K210 SDK with FreeRTOS

This SDK is for Kendryte K210 which contains FreeRTOS support.
Ported from Kendryte kendryte-freertos-sdk

Changes to make the SDK work better with MicroPython, but can be used as SDK for other applications to

You may want to edit lib/freertos/conf/FreeRTOSConfig.h to make some changes to better suit your needs.

Use the latest Kendryte GNU Toolchain v8.2.0-20190409.

To compile only the libraries, execute (no project given):

cd build
cmake ../ -DTOOLCHAIN=<path_to_kendryte-toolchain>/bin
make

The following libraries will be created in build directory:

third_party/fatfs/libfatfs.a
third_party/lwip/liblwipcore.a
SDK/bsp/libbsp.a
SDK/drivers/libdrivers.a
SDK/hal/libhal.a
SDK/posix/libposix.a
SDK/freertos/libfreertos.a

To build the project, place your project source files in the directory src/<project_name> and execute:

cd build
cmake ../ -DPROJ=<project_name> -DTOOLCHAIN=<path_to_kendryte-toolchain>/bin
make

Use -jN make option for faster build.

Example: Build 'uart_example' project

Change working directory to build directory.
Export your Kendryte toolchain directory path, for example
export CROSS_COMPILE=${PWD}/../../kendryte-toolchain/bin

Execute:

cmake ../ -DPROJ=uart_example -DTOOLCHAIN=${CROSS_COMPILE}
make -j8

Flash the created uart_example.bin to your board.

kflash.py is provided in the src directory.
Change working directory to src directory.
Execute:

./kflash.py -p /dev/ttyUSB0 -b 2000000 -t ../build/uart_example.bin

This version of kflash.py has terminal emulator included, with -t option it will be started after flashing.

Modifications

  • Drivers
    • uarths: added - uarths_baudrate global variable used by uarths_init function
    • uart: enable using external uart irq handler, added functions uart_get_driver(handle_t file), uart_get_handle(void *driver)
    • i2c: some changes and new functions
    • spi: many changes, some new functions, much improved slave support
    • gpiohs: some changes for better interrupt handling
    • gpio: added some missing functions
    • timer: added some functions
    • pwm: added some functions
    • dmac: dma_completion_isr, do not assert on wrong int status, but provide the interrupt status in global variable to be used by caller function
  • syslog: various changes
    • print log time in micro seconds
    • make syslog level configurable during run time
    • make syslog colors configurable during run time
    • add syslog mutex
    • enable filtering of non-printable characters
  • FreeRTOS tasks:
    • lot of changes for better multiprocessor support
    • some useful functions added or enabled
    • all notification functions uses 64-bit values
  • FreeRTOS heap_4: added functions pvPortRealloc & pvPortCalloc
  • filesystem: added setting file time from external function (get_fattime(void) function), enabled f_mkfs() function, default code page set to 850
  • lwip: added SHA256, enabled PPP support, enabled IGMP, thread priority set to 12
    • SNTP: added function set_rtc_time_from_seconds(time_t seconds) to set RTC, enabled support for DNS names
  • added reading 64-bit CSR, function: read_csr64(reg)
  • other small changes for better functionality and no compiler warnings

Full list of modified files:

  • lib/arch/include/
    • encoding.h
  • lib/bsp/
    • entry_user.c
    • dump.c
    • printf.c
    • device/
      • dmac.cpp
      • gpiohs.cpp
      • i2c.cpp
      • pwm.cpp
      • rtc.cpp
      • spi.cpp
      • timer.cpp
      • uart.cpp
  • lib/drivers/src/storage/
    • sdcard.cpp
  • lib/utils/include/
    • syslog.h
  • lib/freertos/
    • conf/
      • FreeRTOSConfig.h
    • include/
      • devices.h
      • filesystem.h
      • hal.h
      • FreeRTOS.h
      • osdefs.h
      • portabe.h
      • task.h
      • kernel/
        • driver.hpp
        • object.hpp
    • kernel/
      • devices.cpp
      • storage/
        • filesystem.cpp
    • portable/
      • heap_4.c
      • portmacro.h
  • lib/hal/
    • uarths.c
    • include/
      • spi.h
      • uarths.h
  • third_party/
    • fatfs/
      • source/
        • ffconf.h
    • lwip/
      • src/
        • Filelist.cmake
        • api/
          • sockets.c
        • include/
          • lwipopts.h
          • lwip/
            • opt.h
            • apps/
              • sntp_opts.h`
          • netif/
            • ppp/
              • ppp_opts.h