ARMmbed
/
mbed-os
mirror of https://github.com/ARMmbed/mbed-os.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Merge pull request #10553 from korjaa/semihosting_docs 

Add semihosting and SWO examples to mbed_override_console().
pull/10654/head
Martin Kojtal 2019-05-23 21:40:37 +01:00 committed by GitHub
parent cfb107912b 9fb4437003
commit 541dee4531
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 27 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
platform/mbed_retarget.h
View File

@ -120,14 +120,38 @@ FileHandle *mbed_target_override_console(int fd);
* by mbed_target_override_console, else will default to serial - see * by mbed_target_override_console, else will default to serial - see
* mbed_target_override_console for more details. * mbed_target_override_console for more details.
* *
* Example: * Example using UARTSerial:
* @code * @code
* FileHandle *mbed::mbed_override_console(int) { * FileHandle *mbed::mbed_override_console(int) {
* static UARTSerial my_serial(D0, D1); * static UARTSerial my_serial(D0, D1);
* return &my_serial; * return &my_serial;
* } * }
* @endcode * @endcode
*
* Example using SingleWireOutput:
* @code
* FileHandle *mbed::mbed_override_console(int) {
* static SerialWireOutput swo;
* return &swo;
* }
* @endcode
*
* Example using arm semihosting:
* @code
* FileHandle *mbed::mbed_override_console(int fileno) {
* static LocalFileSystem fs("host");
* if (fileno == STDIN_FILENO) {
* static FileHandle *in_terminal;
* static int in_open_result = fs.open(&in_terminal, ":tt", O_RDONLY);
* return in_terminal;
* } else {
* static FileHandle *out_terminal;
* static int out_open_result = fs.open(&out_terminal, ":tt", O_WRONLY);
* return out_terminal;
* }
* }
* @endcode
*
* @param fd file descriptor - STDIN_FILENO, STDOUT_FILENO or STDERR_FILENO * @param fd file descriptor - STDIN_FILENO, STDOUT_FILENO or STDERR_FILENO
* @return pointer to FileHandle to override normal stream otherwise NULL * @return pointer to FileHandle to override normal stream otherwise NULL
*/ */