PSOC6: add psoc6csp asset with Cypress HAL implementation

PSoC 6 Chip Support Package provides hardware abstraction layer
for Cypress PSoC 6 device peripherals.

Author: vmedcy

targets/TARGET_Cypress/TARGET_PSOC6/psoc6csp/abstraction/include/COMPONENT_RTX/cyabs_rtos_impl.h

@@ -0,0 +1,76 @@
+/***************************************************************************//**
+* \file cyabs_rtos_impl.h
+*
+* \brief
+* Internal definitions for RTOS abstraction layer
+*
+********************************************************************************
+* \copyright
+* Copyright 2019 Cypress Semiconductor Corporation
+* SPDX-License-Identifier: Apache-2.0
+* 
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+* 
+*     http://www.apache.org/licenses/LICENSE-2.0
+* 
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+
+#ifndef INCLUDED_CYABS_RTOS_IMPL_H_
+#define INCLUDED_CYABS_RTOS_IMPL_H_
+
+#include "cmsis_os2.h"
+#include "rtx_os.h"
+
+#ifdef __cplusplus
+extern "C"
+{
+#endif
+
+/******************************************************
+*                 Constants
+******************************************************/
+#define CY_RTOS_MIN_STACK_SIZE      300                     /** Minimum stack size */
+#define CY_RTOS_ALIGNMENT_MASK      0x00000007UL            /** Checks for 8-bit alignement */
+
+
+/******************************************************
+*                 Type Definitions
+******************************************************/
+
+/* RTOS thread priority */
+typedef enum
+{
+    CY_RTOS_PRIORITY_MIN = osPriorityNone,
+    CY_RTOS_PRIORITY_LOW = osPriorityLow,
+    CY_RTOS_PRIORITY_BELOWNORMAL = osPriorityBelowNormal,
+    CY_RTOS_PRIORITY_NORMAL = osPriorityNormal,
+    CY_RTOS_PRIORITY_ABOVENORMAL = osPriorityAboveNormal,
+    CY_RTOS_PRIORITY_HIGH = osPriorityHigh,
+    CY_RTOS_PRIORITY_REALTIME = osPriorityRealtime,
+    CY_RTOS_PRIORITY_MAX = osPriorityRealtime7
+} cy_thread_priority_t ;
+
+typedef osThreadId_t cy_thread_t;                      /** CMSIS definition of a thread handle */
+typedef uint32_t cy_thread_arg_t;                      /** Argument passed to the entry function of a thread */
+typedef osMutexId_t cy_mutex_t;                        /** CMSIS definition of a mutex */
+typedef osSemaphoreId_t cy_semaphore_t;                /** CMSIS definition of a semaphore */
+typedef osEventFlagsId_t cy_event_t;                   /** CMSIS definition of an event */
+typedef osMessageQueueId_t cy_queue_t;                 /** CMSIS definition of a message queue */
+typedef osTimerId_t cy_timer_t;                        /** CMSIS definition of a timer */
+typedef uint32_t cy_timer_callback_arg_t;              /** Argument passed to the timer callback function */
+typedef uint32_t cy_time_t;                            /** Time in milliseconds */
+typedef osStatus_t cy_rtos_error_t;                    /** CMSIS definition of a error status */
+
+#ifdef __cplusplus
+} /* extern "C" */
+#endif
+#endif /* ifndef INCLUDED_CYABS_RTOS_IMPL_H_ */
+

targets/TARGET_Cypress/TARGET_PSOC6/psoc6csp/abstraction/include/cyabs_chip.h

@@ -0,0 +1,30 @@
+/***************************************************************************//**
+* \file cyabs_chip.h
+*
+* \brief
+* Basic abstraction layer for dealing with chips containing a Cypress MCU. This
+* API provides convenience methods for initializing and manipulating different
+* hardware peripherals. Depending on the specific chip being used, not all
+* features may be supported.
+*
+********************************************************************************
+* \copyright
+* Copyright 2018-2019 Cypress Semiconductor Corporation
+* SPDX-License-Identifier: Apache-2.0
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*     http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*******************************************************************************/
+
+#pragma once
+
+#include "cyhal.h"

targets/TARGET_Cypress/TARGET_PSOC6/psoc6csp/abstraction/include/cyabs_fs.h

@@ -0,0 +1,116 @@
+/***************************************************************************//**
+* \file cyabs_fs.h
+*
+* \brief
+* Basic file system abstraction layer. This API provides convenience methods
+* for reading and writing values.
+*
+********************************************************************************
+* \copyright
+* Copyright 2018-2019 Cypress Semiconductor Corporation
+* SPDX-License-Identifier: Apache-2.0
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*     http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*******************************************************************************/
+
+/**
+* \addtogroup group_abstraction_fs File system abstraction
+* \ingroup group_abstraction
+* \{
+* Basic file system abstraction layer. This API provides convenience methods
+* for reading and writing values.
+*
+* \defgroup group_abstraction_fs_macros Macros
+* \defgroup group_abstraction_fs_data_structures Data Structures
+* \defgroup group_abstraction_fs_functions Functions
+*/
+
+#pragma once
+
+#include <stdint.h>
+#include <stdbool.h>
+#include "cy_result.h"
+
+#if defined(__cplusplus)
+extern "C" {
+#endif
+
+/**
+* \addtogroup group_abstraction_fs_macros
+* \{
+*/
+
+#define CY_O_RDONLY             (1 << 0) /**< TODO */
+#define CY_O_WRONLY             (1 << 1) /**< TODO */
+#define CY_O_RDWR               (1 << 2) /**< TODO */
+#define CY_O_APPEND             (1 << 3) /**< TODO */
+#define CY_O_CREAT              (1 << 4) /**< TODO */
+
+/** \} group_abstraction_fs_macros */
+
+/**
+* \addtogroup group_abstraction_fs_data_structures
+* \{
+*/
+
+typedef uint32_t cy_handle_t; /**< Resource handle */
+
+/** \} group_abstraction_fs_data_structures */
+
+
+/**
+* \addtogroup group_abstraction_fs_functions
+* \{
+*/
+
+/**
+  * \brief open or create a file and return a handle
+  * \param path the path name of the file to open
+  * \param oflag the mode to use when opening the file
+  * \param handle pointer to location re receive handle
+  * \returns CY_RSLT_SUCCESS if successful, otherwise error code
+  */
+cy_rslt_t cy_fs_open(const char *path, uint32_t oflag, cy_handle_t *handle) ;
+
+/**
+ * \brief close an open file
+ * \param handle a file handle to an open file
+ * \returns CY_RSLT_SUCCESS if successful, otherwise error code
+ */
+ cy_rslt_t cy_fs_close(cy_handle_t handle) ;
+
+/**
+ * \brief read data from a file
+ * \param handle a file handle open for reading or read/write
+ * \param buf the buffer for the read data
+ * \param nbyte the size of the buffer in bytes, the number of bytes read on return
+ * \returns CY_RSLT_SUCCESS if successful, otherwise error code
+ */
+cy_rslt_t cy_fs_read(cy_handle_t handle, void *buf, size_t *nbyte) ;
+
+/**
+ * \brief write data to a file
+ * \param handle a file handle open for writing or read/write
+ * \param buf the buffer for the data to write
+ * \param nbyte the size of the buffer in bytes, the number of bytes written on return
+ * \returns CY_RSLT_SUCCESS if successful, otherwise error code
+ */
+cy_rslt_t cy_fs_write(cy_handle_t handle, const void *buf, size_t *nbyte) ;
+
+/** \} group_abstraction_fs_functions */
+
+#if defined(__cplusplus)
+}
+#endif
+
+/** \} group_abstraction_fs */

targets/TARGET_Cypress/TARGET_PSOC6/psoc6csp/abstraction/include/cyabs_resource.h

@@ -0,0 +1,164 @@
+/***************************************************************************//**
+* \file cyabs_resource.h
+*
+* \brief
+* Basic abstraction layer for dealing with resources.
+*
+********************************************************************************
+* \copyright
+* Copyright 2018-2019 Cypress Semiconductor Corporation
+* SPDX-License-Identifier: Apache-2.0
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*     http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*******************************************************************************/
+
+/**
+* \addtogroup group_abstraction_resource Resource abstraction
+* \ingroup group_abstraction
+* \{
+* Basic abstraction layer for dealing with resources.
+*
+* \defgroup group_abstraction_resource_macros Macros
+* \defgroup group_abstraction_resource_enums Enums
+* \defgroup group_abstraction_resource_data_structures Data Structures
+* \defgroup group_abstraction_resource_functions Functions
+*/
+
+#pragma once
+
+#include <stdint.h>
+#include <stdbool.h>
+#include "cy_result.h"
+
+#if defined(__cplusplus)
+extern "C" {
+#endif
+
+/**
+* \addtogroup group_abstraction_resource_macros
+* \{
+*/
+
+/** Error code for when the specified resource operation is not valid. */
+#define CY_RSLT_RSC_ERROR_UNSUPPORTED (CY_RSLT_CREATE(CY_RSLT_TYPE_ERROR, CY_RSLT_MODULE_ABSTRACTION_RESOURCE, 0))
+/** Error indicating that memory for the specified resource could not be allocated. */
+#define CY_RSLT_RSC_ERROR_UNAVAILABLE (CY_RSLT_CREATE(CY_RSLT_TYPE_ERROR, CY_RSLT_MODULE_ABSTRACTION_RESOURCE, 1))
+/** Error code for when the specified resource offset is not valid for the specified resource. */
+#define CY_RSLT_RSC_ERROR_OFFSET (CY_RSLT_CREATE(CY_RSLT_TYPE_ERROR, CY_RSLT_MODULE_ABSTRACTION_RESOURCE, 2))
+/** Error code for when the specified resource can not be opened for reading. */
+#define CY_RSLT_RSC_ERROR_OPEN (CY_RSLT_CREATE(CY_RSLT_TYPE_ERROR, CY_RSLT_MODULE_ABSTRACTION_RESOURCE, 3))
+/** Error code for when the specified location can not be accessed in the specified resource. */
+#define CY_RSLT_RSC_ERROR_SEEK (CY_RSLT_CREATE(CY_RSLT_TYPE_ERROR, CY_RSLT_MODULE_ABSTRACTION_RESOURCE, 4))
+/** Error code for when the specified resource can not be read. */
+#define CY_RSLT_RSC_ERROR_READ (CY_RSLT_CREATE(CY_RSLT_TYPE_ERROR, CY_RSLT_MODULE_ABSTRACTION_RESOURCE, 5))
+
+/** \} group_abstraction_resource_macros */
+
+
+/**
+* \addtogroup group_abstraction_resource_enums
+* \{
+*/
+/** Different types of memory that the resources can be stored in. */
+typedef enum
+{
+    CY_RESOURCE_IN_MEMORY,           /**< resource location in memory           */
+    CY_RESOURCE_IN_FILESYSTEM,       /**< resource location in filesystem       */
+    CY_RESOURCE_IN_EXTERNAL_STORAGE  /**< resource location in external storage */
+} cy_resource_location_t;
+
+/** \} group_abstraction_resource_enums */
+
+
+/**
+* \addtogroup group_abstraction_resource_data_structures
+* \{
+*/
+
+/** Filesystem handle */
+typedef struct
+{
+    unsigned long offset;      /**< Offset to the start of the resource */
+    const char* filename;      /**< name of the resource                */
+} cy_filesystem_resource_handle_t;
+
+/** Resource handle structure */
+typedef struct
+{
+    cy_resource_location_t location;     /**< resource location */
+    unsigned long size;                  /**< resource size     */
+    union
+    {
+        cy_filesystem_resource_handle_t fs;                       /** < filesystem resource handle */
+        const uint8_t*                  mem_data;                 /** < memory resource handle     */
+        void*                           external_storage_context; /** < external storage context   */
+    } val;
+} cy_resource_handle_t;
+
+/** \} group_abstraction_resource_data_structures */
+
+/**
+* \addtogroup group_abstraction_resource_functions
+* \{
+*/
+
+/**
+ * \brief return the block size for the resource
+ * \param handle handle to a resource
+ * \param size pointer to a uint32_t to receive the size
+ * \returns CY_RSLT_SUCCESS if the size was found, otherwise an error
+ */
+cy_rslt_t cy_resource_get_block_size(const cy_resource_handle_t *handle, uint32_t *size);
+
+/**
+ * \brief return the total size for the resource
+ * \param handle handle to a resource
+ * \param size pointer to a uint32_t to receive the size
+ * \returns CY_RSLT_SUCCESS if the size was found, otherwise an error
+ */
+cy_rslt_t cy_resource_get_total_size(const cy_resource_handle_t *handle, uint32_t *size);
+
+/**
+ * \brief return the total number of blocks that exist for the resource
+ * \param handle handle to a resource
+ * \param blocks pointer to a uint32_t to receive the count
+ * \returns CY_RSLT_SUCCESS if the count was found, otherwise an error
+ */
+cy_rslt_t cy_resource_get_block_count(const cy_resource_handle_t *handle, uint32_t *blocks);
+
+/**
+ * \brief read data from a resource
+ * \param handle the handle to the resource
+ * \param blockno the block number of the data from the resource
+ * \param buffer pointer to receive buffer address from resource. The buffer must be freed when done. Eg: free(buffer)
+ * \param size location to receive the size of the block read
+ * \returns CY_RSLT_SUCCESS if data read, otherwise an error
+ */
+cy_rslt_t cy_resource_read(const cy_resource_handle_t *handle, uint32_t blockno, uint8_t **buffer, uint32_t *size);
+
+/**
+ * \brief optimized version of read for resources stored in memory (\see CY_RESOURCE_IN_MEMORY)
+ * \param handle the handle to the resource
+ * \param buffer pointer to receive buffer address from resource. This does NOT need to be freed.
+ * \param size location to receive the size of the block read
+ * \returns CY_RSLT_SUCCESS if data read, otherwise an error
+ */
+cy_rslt_t cy_resource_readonly_memory(const cy_resource_handle_t *handle, const uint8_t **buffer, uint32_t *size);
+
+/** \} group_abstraction_resource_functions */
+
+#if defined(__cplusplus)
+}
+#endif
+
+/** \} group_abstraction_resource */