Skip to content

Commit

Permalink
Upload retarget-io 1.2.0.21473
Browse files Browse the repository at this point in the history
  • Loading branch information
gitlab-runner committed Apr 12, 2021
1 parent 903873f commit 135a764
Show file tree
Hide file tree
Showing 8 changed files with 449 additions and 236 deletions.
1 change: 1 addition & 0 deletions .cyignore
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
docs
5 changes: 4 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,9 @@ A utility library to retarget the standard input/output (STDIO) messages to a UA

**NOTE:** If the application is built using newlib-nano, by default, floating point format strings (%f) are not supported. To enable this support, you must add `-u _printf_float` to the linker command line.

# RTOS Integration
To avoid concurrent access to the UART peripheral in a RTOS environment, the ARM and IAR libraries use mutexes to control access to stdio streams. For Newlib (GCC_ARM), the mutex must be implemented in _write() and can be enabled by adding `DEFINES+=CY_RTOS_AWARE` to the Makefile. For all libraries, the program must start the RTOS kernel before calling any stdio functions.

### Quick Start
1. Add `#include "cy_retarget_io.h"`
2. Call `cy_retarget_io_init(CYBSP_DEBUG_UART_TX, CYBSP_DEBUG_UART_RX, CY_RETARGET_IO_BAUDRATE);`
Expand All @@ -32,4 +35,4 @@ If you want to use only '\\n' instead of "\r\n" for printing a new line using pr
* [PSoC 6 Resources - KBA223067](https://community.cypress.com/docs/DOC-14644)

---
© Cypress Semiconductor Corporation, 2019-2020.
© Cypress Semiconductor Corporation, 2019-2021.
14 changes: 10 additions & 4 deletions RELEASE.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,10 @@ A utility library to retarget the standard input/output (STDIO) messages to a UA
* Thread safe write for NewLib

### What Changed?
#### v1.2.0
* Improve error handling
* Add de-initialization of the mutex to `cy_retarget_io_deinit`
* Update documentation for integration of the library in a RTOS environment.
#### v1.1.1
* Minor update for documentation & branding
#### v1.1.0
Expand All @@ -21,11 +25,13 @@ This version of the Retarget IO was validated for compatibility with the followi

| Software and Tools | Version |
| :--- | :----: |
| ModusToolbox Software Environment | 2.0 |
| GCC Compiler | 7.4 |
| IAR Compiler | 8.32 |
| ModusToolbox Software Environment | 2.2.1 |
| GCC Compiler | 9.3.1 |
| IAR Compiler | 8.4 |
| ARM Compiler 6 | 6.11 |

Minimum required ModusToolbox Software Environment: v2.0

### More information

* [API Reference Guide](https://cypresssemiconductorco.github.io/retarget-io/html/index.html)
Expand All @@ -37,4 +43,4 @@ This version of the Retarget IO was validated for compatibility with the followi
* [PSoC 6 Resources - KBA223067](https://community.cypress.com/docs/DOC-14644)

---
© Cypress Semiconductor Corporation, 2019-2020.
© Cypress Semiconductor Corporation, 2019-2021.
Loading

0 comments on commit 135a764

Please sign in to comment.