v2.8.0

• released: 2023-07-20

2.8.0 Changes

1. dsPIC low level hal support
2. GCC ARM support
3. New Features
4. Improvements
5. Fixes
6. NEW HARDWARE

dsPIC

dsPIC MCUs supported!

Supported modules:

• ADC (Full module support)
• SPI (Full module support)
• UART (Full module support)
• I2C (Full module support)
• PWM (Full module support)
• GPIO (Full module support)
• OW (Full module support)

Files added:

• assembly.h
• CMakeLists.txt
• ./common/CMakeLists.txt
• ./core/CMakeLists.txt
• ./dspic/CMakeLists.txt
• ./dspic/src/adc/CMakeLists.txt
• ./dspic/src/gpio/CMakeLists.txt
• ./dspic/src/hal_ll/CMakeLists.txt
• ./dspic/src/i2c/CMakeLists.txt
• ./dspic/src/one_wire/CMakeLists.txt
• ./dspic/src/pps/CMakeLists.txt
• ./dspic/src/spi_master/CMakeLists.txt
• ./dspic/src/tim/CMakeLists.txt
• ./dspic/src/uart/CMakeLists.txt
• common_macros.h
• hal_ll_adc.c
• hal_ll_adc.h
• hal_ll_analog_in_map.h
• hal_ll_bit_control.h
• hal_ll_core.c
• hal_ll_core.h
• hal_ll_core_defines.h
• hal_ll_core_port.h
• hal_ll_gpio.c
• hal_ll_gpio.h
• hal_ll_gpio_constants.h
• hal_ll_gpio_port.c
• hal_ll_gpio_port.h
• hal_ll_i2c_master.c
• hal_ll_i2c_master.h
• hal_ll_i2c_pin_map.h
• hal_ll_odcon_map.h
• hal_ll_one_wire.c
• hal_ll_one_wire.h
• hal_ll_pin_names.h
• hal_ll_pps.c
• hal_ll_pps.h
• ./HAL_LL_PPS_DEFAULT/hal_ll_pps_connection_defs.h
• ./mcu_name/hal_ll_pps_connection_defs.h - https://github.com/MikroElektronika/mikrosdk_v2/blob/master/targets/pic_16bit/mikroe/dspic/include/pps/hal_ll_pps_connection_defs/mcu_name/hal_ll_pps_connection_defs.h
  • Added for MCUs with PPS modules only where mcu_name is actual chip full name, i.e. dsPIC33EP512MU814 etc.
• hal_ll_pps_defines.h
• hal_ll_pps_port.c
• hal_ll_pps_port.h
• hal_ll_pps_struct_def.h
• hal_ll_slrcon_map.h
• hal_ll_spi_master.c
• hal_ll_spi_master.h
• hal_ll_spi_master_pin_map.h
• hal_ll_target.h
• hal_ll_target_names.h
• hal_ll_tim.c
• hal_ll_tim.h
• hal_ll_tim_pin_map.h
• hal_ll_uart.c
• hal_ll_uart.h
• hal_ll_uart_pin_map.h
• ./mcu_name/mcu_definitions.h - https://github.com/MikroElektronika/mikrosdk_v2/blob/master/targets/pic_16bit/mikroe/common/include/mcu_definitions/mcu_name/mcu_definitions.h
  • Added for all MCUs in mikroSDK where mcu_name is actual chip full name, i.e. dsPIC30F4013 etc.

GCC ARM

• As of mikroSDK version 2.8.0, GCC ARM v10.2 is officially supported.
• All 1394 ARM MCUs can now be used with the GCC toolchain along with full mikroSDK functionality.
• Linker scripts and startup files are included upon selecting adequate setup for your project so it can be easily edited on the fly.

2.8.0 New Features

• Plot logger added
  • User is now able to log data to NECTO chart GUI
• File System structure added to mikroSDK
  • Module imported from http:https://elm-chan.org/fsw/ff/doc/appnote.html
  • Files added:
    • 00history.txt
    • 00readme.txt
    • CMakeLists.txt
    • dir.c
    • dir.h
    • diskio.h
    • fatfs.c
    • fatfs.h
    • ff.c
    • ff.h
    • ff_types.h
    • ffconf.h
    • ffsystem.c
    • ffunicode.c
    • file.c
    • file.h
    • file_system.c
    • file_system.h
    • fs_common.h
  • Added physical drive with sd spi implementation:
    • CMakeLists.txt
    • pd_common.h
    • physical_drive.c
    • physical_drive.h
    • sd_common.h
    • sdspi_physical_drive.c
    • sdspi_physical_drive.h

2.8.0 Improvements

• Plot included implicitly with the LOG library
  • Can be included as a standalone library as well
• All DRIVER and HAL close APIs now return an error code
• Following APIs now return error code:
  • digital_out_high
  • digital_out_low
  • digital_out_toggle
  • digital_out_write
  • port_init
  • port_write
  • port_read
• Added port_read_input and port_read_output APIs
  • Previous port_read is defined as port_read_output for backwards compatibility
• SPI write APIs now have a generic pointer typecast for 8-bit archicecture compatibility
  • ROM and RAM pointers are not the same on 8-bit architectures
• All DRIVER and HAL APIs have added checks for passed data validity
• ./tests/pwm/main.c
  • PWM test improved with multiple new cases
• ./tests/CMakeLists.txt
  • gl tests are now included only if setup has a display

2.8.0 Fixes

• Fixed PIC32MZ adc low level implementation
  • Setting internal VREF after previously setting external didn't work as bits in appropriate register werent cleared properly
• Fixed all low level implementations for ARM MCUs to accommodate the relase of GCC ARM toolchain
• Fixed uart_configure_default API
  • stop_bits previosuly set incorrectly
• ring_buf8_init previously used sizeof( ring_buf8_t ) as last parameter which would delete all data starting from buf address all the way to the sizeof( ring_buf8_t ) which could produce problems if buf was shorter than sizeof( ring_buf8_t )
  • Fixed to clear data starting from buf all the way up to the capacity of buf
• ./targets/arm/mikroe/nxp/src/tim/implementation_1/hal_ll_tim.c
  • Fixed issue with double frequency setting
    • Frequency is now set adequately
  • Fixed issue with inability to start the signal again after stopping it
• ./targets/arm/mikroe/nxp/src/uart/implementation_2/hal_ll_uart.c
  • Fixed adequate error setting when calculated baud difference is 1% or higher
• ./targets/arm/mikroe/nxp/src/uart/CMakeLists.txt
  • Adequate UART subimplemntation for MK8x MCUs is now propagated
• ./targets/arm/mikroe/stm32/src/gpio/implementation_2/hal_ll_gpio_port.c
  • GPIO pins used for SWJTAG (debug mode) are now set in release build only, when debug is active these pins are not changed
    • This ensured uninterrupted debugging
• All modules
  • Clock is now being set everytime before disabling the module and then being disabled again
    • This ensures proper module function without exceptions
• ./targets/arm/mikroe/tiva/src/uart/implementation_1/hal_ll_uart.c
  • Data frame is now being checked for errors, i.e. parity errors, data bit error etc.
    • If error is present, read API shall return 0 as actual data
  • Uart module is now disabled completely before changing any register state
• ./targets/avr_8bit/mikroe/avr/src/tim/implementation_1/hal_ll_tim.c
  • Fixed issue with inability to start the signal again after stopping it
• ./targets/avr_8bit/mikroe/avr/src/tim/implementation_2/hal_ll_tim.c
  • Fixed issue with inability to start the signal again after stopping it
• ./targets/avr_8bit/mikroe/avr/src/tim/implementation_3/hal_ll_tim.c
  • Fixed issue with inability to start the signal again after stopping it
• ./targets/avr_8bit/mikroe/avr/src/uart/implementation_1/hal_ll_uart.c
  • Fixed adequate error setting when calculated baud difference is 1% or higher
• ./targets/avr_8bit/mikroe/avr/src/uart/implementation_2/hal_ll_uart.c
  • Fixed adequate error setting when calculated baud difference is 1% or higher
• ./targets/avr_8bit/mikroe/avr/src/i2c/implementation_1/hal_ll_i2c_master.c
  • Fixed function for calculating I2C baud rate
• ./targets/avr_8bit/mikroe/avr/src/adc/implementation_1/hal_ll_adc.c
  • Fixed ADC channel selection for channels 8 to 15
• ./targets/pic_8bit/mikroe/pic18/src/gpio/implementation_1/subimplementation_1/hal_ll_gpio_port.c
  • hal_ll_gpio_port_index API now returns adequate value
• ./targets/riscv/mikroe/gigadevice/src/tim/implementation_1/hal_ll_tim.c
  • Timer module can now be started again after stopping the signal

2.8.0 NEW HARDWARE

Support added for following hardware:

• Easy24-33 v6
• EasyPIC v8 for dsPIC30
• EasyPIC v8 for PIC24/dsPIC33
• EasyPIC v7 for dsPIC30
• Clicker 2 for PIC24
• Clicker 2 for dsPIC33
• mikromedia for PIC24
• mikromedia for PIC24EP
• mikromedia for dsPIC33
• mikromedia for dsPIC33EP
• Sibrain for dsPIC33EP512MU814
• Sibrain for dsPIC33FJ256GP710A
• Sibrain for PIC24EP512GU814
• Sibrain for PIC24HJ256GP610
• EasyPIC Fusion v7 MCUcard with dsPIC33EP512MU810
• EasyPIC Fusion v7 MCUcard with dsPIC33FJ256GP710A
• EasyPIC Fusion v7 MCUcard with PIC24EP512GU810
• EasyPIC Fusion v7 MCUcard with PIC24FJ128GA310
• PIC24FJ256GA7 Curiosity Development Board
• Curiosity PIC32MZ EF
• Explorer 16/32 Development board
  • PIC24FJ64GB004 PLUG-IN-MODULE
  • PIC24FJ128GA310 PLUG-IN MODULE
  • PIC24F32KA304 PLUG-IN-MODULE
  • PIC24F16KA102 PLUG-IN-MODULE
  • PIC24EP512GU810 PLUG-IN-MODULE
  • DSPIC33EP512MU810 PLUG-IN-MODULE
  • PIC24FJ256GB210 PLUG-IN-MODULE
  • PIC24FJ64GB004 PLUG-IN-MODULE
  • PIC24FJ64GA004 PLUG-IN-MODULE
  • PIC24FJ256GB110 PLUG-IN-MODULE
  • DSPIC33EP256GP506 PLUG-IN-MODULE
  • PIC32MX250F128D PLUG-IN-MODULE
  • PIC32MX270F256D PLUG-IN-MODULE
  • PIC32MX360F512L PLUG-IN-MODULE
  • PIC32MX460F512L PLUG-IN-MODULE
  • PIC32MX795F512L PLUG-IN-MODULE
  • PIC32MX450/470 PLUG-IN-MODULE
  • PIC32MZ EF PIM