Important changes to repositories hosted on mbed.com
Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.
To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.
It is also possible to export all your personal repositories from the account settings page.
mbed-os/platform/mbed_semihost_api.c@0:fb8047b156bb, 2020-01-15 (annotated)
- Committer:
- rahul_dahiya
- Date:
- Wed Jan 15 15:57:15 2020 +0530
- Revision:
- 0:fb8047b156bb
STM32F7 LWIP
Who changed what in which revision?
| User | Revision | Line number | New contents of line |
|---|---|---|---|
| rahul_dahiya |
0:fb8047b156bb | 1 | /* mbed Microcontroller Library |
| rahul_dahiya |
0:fb8047b156bb | 2 | * Copyright (c) 2006-2013 ARM Limited |
| rahul_dahiya |
0:fb8047b156bb | 3 | * |
| rahul_dahiya |
0:fb8047b156bb | 4 | * Licensed under the Apache License, Version 2.0 (the "License"); |
| rahul_dahiya |
0:fb8047b156bb | 5 | * you may not use this file except in compliance with the License. |
| rahul_dahiya |
0:fb8047b156bb | 6 | * You may obtain a copy of the License at |
| rahul_dahiya |
0:fb8047b156bb | 7 | * |
| rahul_dahiya |
0:fb8047b156bb | 8 | * http://www.apache.org/licenses/LICENSE-2.0 |
| rahul_dahiya |
0:fb8047b156bb | 9 | * |
| rahul_dahiya |
0:fb8047b156bb | 10 | * Unless required by applicable law or agreed to in writing, software |
| rahul_dahiya |
0:fb8047b156bb | 11 | * distributed under the License is distributed on an "AS IS" BASIS, |
| rahul_dahiya |
0:fb8047b156bb | 12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| rahul_dahiya |
0:fb8047b156bb | 13 | * See the License for the specific language governing permissions and |
| rahul_dahiya |
0:fb8047b156bb | 14 | * limitations under the License. |
| rahul_dahiya |
0:fb8047b156bb | 15 | */ |
| rahul_dahiya |
0:fb8047b156bb | 16 | #include "cmsis.h" |
| rahul_dahiya |
0:fb8047b156bb | 17 | #include "platform/mbed_semihost_api.h" |
| rahul_dahiya |
0:fb8047b156bb | 18 | |
| rahul_dahiya |
0:fb8047b156bb | 19 | #include <stdint.h> |
| rahul_dahiya |
0:fb8047b156bb | 20 | #include <string.h> |
| rahul_dahiya |
0:fb8047b156bb | 21 | |
| rahul_dahiya |
0:fb8047b156bb | 22 | #if DEVICE_SEMIHOST |
| rahul_dahiya |
0:fb8047b156bb | 23 | |
| rahul_dahiya |
0:fb8047b156bb | 24 | // ARM Semihosting Commands |
| rahul_dahiya |
0:fb8047b156bb | 25 | #define SYS_OPEN (0x1) |
| rahul_dahiya |
0:fb8047b156bb | 26 | #define SYS_CLOSE (0x2) |
| rahul_dahiya |
0:fb8047b156bb | 27 | #define SYS_WRITE (0x5) |
| rahul_dahiya |
0:fb8047b156bb | 28 | #define SYS_READ (0x6) |
| rahul_dahiya |
0:fb8047b156bb | 29 | #define SYS_ISTTY (0x9) |
| rahul_dahiya |
0:fb8047b156bb | 30 | #define SYS_SEEK (0xa) |
| rahul_dahiya |
0:fb8047b156bb | 31 | #define SYS_ENSURE (0xb) |
| rahul_dahiya |
0:fb8047b156bb | 32 | #define SYS_FLEN (0xc) |
| rahul_dahiya |
0:fb8047b156bb | 33 | #define SYS_REMOVE (0xe) |
| rahul_dahiya |
0:fb8047b156bb | 34 | #define SYS_RENAME (0xf) |
| rahul_dahiya |
0:fb8047b156bb | 35 | #define SYS_EXIT (0x18) |
| rahul_dahiya |
0:fb8047b156bb | 36 | |
| rahul_dahiya |
0:fb8047b156bb | 37 | // mbed Semihosting Commands |
| rahul_dahiya |
0:fb8047b156bb | 38 | #define RESERVED_FOR_USER_APPLICATIONS (0x100) // 0x100 - 0x1ff |
| rahul_dahiya |
0:fb8047b156bb | 39 | #define USR_XFFIND (RESERVED_FOR_USER_APPLICATIONS + 0) |
| rahul_dahiya |
0:fb8047b156bb | 40 | #define USR_UID (RESERVED_FOR_USER_APPLICATIONS + 1) |
| rahul_dahiya |
0:fb8047b156bb | 41 | #define USR_RESET (RESERVED_FOR_USER_APPLICATIONS + 2) |
| rahul_dahiya |
0:fb8047b156bb | 42 | #define USR_VBUS (RESERVED_FOR_USER_APPLICATIONS + 3) |
| rahul_dahiya |
0:fb8047b156bb | 43 | #define USR_POWERDOWN (RESERVED_FOR_USER_APPLICATIONS + 4) |
| rahul_dahiya |
0:fb8047b156bb | 44 | #define USR_DISABLEDEBUG (RESERVED_FOR_USER_APPLICATIONS + 5) |
| rahul_dahiya |
0:fb8047b156bb | 45 | |
| rahul_dahiya |
0:fb8047b156bb | 46 | #if DEVICE_LOCALFILESYSTEM |
| rahul_dahiya |
0:fb8047b156bb | 47 | FILEHANDLE semihost_open(const char* name, int openmode) { |
| rahul_dahiya |
0:fb8047b156bb | 48 | uint32_t args[3]; |
| rahul_dahiya |
0:fb8047b156bb | 49 | args[0] = (uint32_t)name; |
| rahul_dahiya |
0:fb8047b156bb | 50 | args[1] = (uint32_t)openmode; |
| rahul_dahiya |
0:fb8047b156bb | 51 | args[2] = (uint32_t)strlen(name); |
| rahul_dahiya |
0:fb8047b156bb | 52 | return __semihost(SYS_OPEN, args); |
| rahul_dahiya |
0:fb8047b156bb | 53 | } |
| rahul_dahiya |
0:fb8047b156bb | 54 | |
| rahul_dahiya |
0:fb8047b156bb | 55 | int semihost_close(FILEHANDLE fh) { |
| rahul_dahiya |
0:fb8047b156bb | 56 | return __semihost(SYS_CLOSE, &fh); |
| rahul_dahiya |
0:fb8047b156bb | 57 | } |
| rahul_dahiya |
0:fb8047b156bb | 58 | |
| rahul_dahiya |
0:fb8047b156bb | 59 | int semihost_write(FILEHANDLE fh, const unsigned char* buffer, unsigned int length, int mode) { |
| rahul_dahiya |
0:fb8047b156bb | 60 | if (length == 0) return 0; |
| rahul_dahiya |
0:fb8047b156bb | 61 | |
| rahul_dahiya |
0:fb8047b156bb | 62 | uint32_t args[3]; |
| rahul_dahiya |
0:fb8047b156bb | 63 | args[0] = (uint32_t)fh; |
| rahul_dahiya |
0:fb8047b156bb | 64 | args[1] = (uint32_t)buffer; |
| rahul_dahiya |
0:fb8047b156bb | 65 | args[2] = (uint32_t)length; |
| rahul_dahiya |
0:fb8047b156bb | 66 | return __semihost(SYS_WRITE, args); |
| rahul_dahiya |
0:fb8047b156bb | 67 | } |
| rahul_dahiya |
0:fb8047b156bb | 68 | |
| rahul_dahiya |
0:fb8047b156bb | 69 | int semihost_read(FILEHANDLE fh, unsigned char* buffer, unsigned int length, int mode) { |
| rahul_dahiya |
0:fb8047b156bb | 70 | uint32_t args[3]; |
| rahul_dahiya |
0:fb8047b156bb | 71 | args[0] = (uint32_t)fh; |
| rahul_dahiya |
0:fb8047b156bb | 72 | args[1] = (uint32_t)buffer; |
| rahul_dahiya |
0:fb8047b156bb | 73 | args[2] = (uint32_t)length; |
| rahul_dahiya |
0:fb8047b156bb | 74 | return __semihost(SYS_READ, args); |
| rahul_dahiya |
0:fb8047b156bb | 75 | } |
| rahul_dahiya |
0:fb8047b156bb | 76 | |
| rahul_dahiya |
0:fb8047b156bb | 77 | int semihost_istty(FILEHANDLE fh) { |
| rahul_dahiya |
0:fb8047b156bb | 78 | return __semihost(SYS_ISTTY, &fh); |
| rahul_dahiya |
0:fb8047b156bb | 79 | } |
| rahul_dahiya |
0:fb8047b156bb | 80 | |
| rahul_dahiya |
0:fb8047b156bb | 81 | int semihost_seek(FILEHANDLE fh, long position) { |
| rahul_dahiya |
0:fb8047b156bb | 82 | uint32_t args[2]; |
| rahul_dahiya |
0:fb8047b156bb | 83 | args[0] = (uint32_t)fh; |
| rahul_dahiya |
0:fb8047b156bb | 84 | args[1] = (uint32_t)position; |
| rahul_dahiya |
0:fb8047b156bb | 85 | return __semihost(SYS_SEEK, args); |
| rahul_dahiya |
0:fb8047b156bb | 86 | } |
| rahul_dahiya |
0:fb8047b156bb | 87 | |
| rahul_dahiya |
0:fb8047b156bb | 88 | int semihost_ensure(FILEHANDLE fh) { |
| rahul_dahiya |
0:fb8047b156bb | 89 | return __semihost(SYS_ENSURE, &fh); |
| rahul_dahiya |
0:fb8047b156bb | 90 | } |
| rahul_dahiya |
0:fb8047b156bb | 91 | |
| rahul_dahiya |
0:fb8047b156bb | 92 | long semihost_flen(FILEHANDLE fh) { |
| rahul_dahiya |
0:fb8047b156bb | 93 | return __semihost(SYS_FLEN, &fh); |
| rahul_dahiya |
0:fb8047b156bb | 94 | } |
| rahul_dahiya |
0:fb8047b156bb | 95 | |
| rahul_dahiya |
0:fb8047b156bb | 96 | int semihost_remove(const char *name) { |
| rahul_dahiya |
0:fb8047b156bb | 97 | uint32_t args[2]; |
| rahul_dahiya |
0:fb8047b156bb | 98 | args[0] = (uint32_t)name; |
| rahul_dahiya |
0:fb8047b156bb | 99 | args[1] = (uint32_t)strlen(name); |
| rahul_dahiya |
0:fb8047b156bb | 100 | return __semihost(SYS_REMOVE, args); |
| rahul_dahiya |
0:fb8047b156bb | 101 | } |
| rahul_dahiya |
0:fb8047b156bb | 102 | |
| rahul_dahiya |
0:fb8047b156bb | 103 | int semihost_rename(const char *old_name, const char *new_name) { |
| rahul_dahiya |
0:fb8047b156bb | 104 | uint32_t args[4]; |
| rahul_dahiya |
0:fb8047b156bb | 105 | args[0] = (uint32_t)old_name; |
| rahul_dahiya |
0:fb8047b156bb | 106 | args[1] = (uint32_t)strlen(old_name); |
| rahul_dahiya |
0:fb8047b156bb | 107 | args[0] = (uint32_t)new_name; |
| rahul_dahiya |
0:fb8047b156bb | 108 | args[1] = (uint32_t)strlen(new_name); |
| rahul_dahiya |
0:fb8047b156bb | 109 | return __semihost(SYS_RENAME, args); |
| rahul_dahiya |
0:fb8047b156bb | 110 | } |
| rahul_dahiya |
0:fb8047b156bb | 111 | #endif |
| rahul_dahiya |
0:fb8047b156bb | 112 | |
| rahul_dahiya |
0:fb8047b156bb | 113 | int semihost_exit(void) { |
| rahul_dahiya |
0:fb8047b156bb | 114 | uint32_t args[4]; |
| rahul_dahiya |
0:fb8047b156bb | 115 | return __semihost(SYS_EXIT, args); |
| rahul_dahiya |
0:fb8047b156bb | 116 | } |
| rahul_dahiya |
0:fb8047b156bb | 117 | |
| rahul_dahiya |
0:fb8047b156bb | 118 | int semihost_uid(char *uid) { |
| rahul_dahiya |
0:fb8047b156bb | 119 | uint32_t args[2]; |
| rahul_dahiya |
0:fb8047b156bb | 120 | args[0] = (uint32_t)uid; |
| rahul_dahiya |
0:fb8047b156bb | 121 | args[1] = DEVICE_ID_LENGTH + 1; |
| rahul_dahiya |
0:fb8047b156bb | 122 | return __semihost(USR_UID, &args); |
| rahul_dahiya |
0:fb8047b156bb | 123 | } |
| rahul_dahiya |
0:fb8047b156bb | 124 | |
| rahul_dahiya |
0:fb8047b156bb | 125 | int semihost_reset(void) { |
| rahul_dahiya |
0:fb8047b156bb | 126 | // Does not normally return, however if used with older firmware versions |
| rahul_dahiya |
0:fb8047b156bb | 127 | // that do not support this call it will return -1. |
| rahul_dahiya |
0:fb8047b156bb | 128 | return __semihost(USR_RESET, NULL); |
| rahul_dahiya |
0:fb8047b156bb | 129 | } |
| rahul_dahiya |
0:fb8047b156bb | 130 | |
| rahul_dahiya |
0:fb8047b156bb | 131 | int semihost_vbus(void) { |
| rahul_dahiya |
0:fb8047b156bb | 132 | return __semihost(USR_VBUS, NULL); |
| rahul_dahiya |
0:fb8047b156bb | 133 | } |
| rahul_dahiya |
0:fb8047b156bb | 134 | |
| rahul_dahiya |
0:fb8047b156bb | 135 | int semihost_powerdown(void) { |
| rahul_dahiya |
0:fb8047b156bb | 136 | return __semihost(USR_POWERDOWN, NULL); |
| rahul_dahiya |
0:fb8047b156bb | 137 | } |
| rahul_dahiya |
0:fb8047b156bb | 138 | |
| rahul_dahiya |
0:fb8047b156bb | 139 | #if DEVICE_DEBUG_AWARENESS |
| rahul_dahiya |
0:fb8047b156bb | 140 | |
| rahul_dahiya |
0:fb8047b156bb | 141 | int semihost_connected(void) { |
| rahul_dahiya |
0:fb8047b156bb | 142 | return (CoreDebug->DHCSR & CoreDebug_DHCSR_C_DEBUGEN_Msk) ? 1 : 0; |
| rahul_dahiya |
0:fb8047b156bb | 143 | } |
| rahul_dahiya |
0:fb8047b156bb | 144 | |
| rahul_dahiya |
0:fb8047b156bb | 145 | #else |
| rahul_dahiya |
0:fb8047b156bb | 146 | // These processors cannot know if the interface is connect, assume so: |
| rahul_dahiya |
0:fb8047b156bb | 147 | static int is_debugger_attached = 1; |
| rahul_dahiya |
0:fb8047b156bb | 148 | |
| rahul_dahiya |
0:fb8047b156bb | 149 | int semihost_connected(void) { |
| rahul_dahiya |
0:fb8047b156bb | 150 | return is_debugger_attached; |
| rahul_dahiya |
0:fb8047b156bb | 151 | } |
| rahul_dahiya |
0:fb8047b156bb | 152 | #endif |
| rahul_dahiya |
0:fb8047b156bb | 153 | |
| rahul_dahiya |
0:fb8047b156bb | 154 | int semihost_disabledebug(void) { |
| rahul_dahiya |
0:fb8047b156bb | 155 | uint32_t args[1]; |
| rahul_dahiya |
0:fb8047b156bb | 156 | #if !(DEVICE_DEBUG_AWARENESS) |
| rahul_dahiya |
0:fb8047b156bb | 157 | is_debugger_attached = 0; |
| rahul_dahiya |
0:fb8047b156bb | 158 | #endif |
| rahul_dahiya |
0:fb8047b156bb | 159 | return __semihost(USR_DISABLEDEBUG, &args); |
| rahul_dahiya |
0:fb8047b156bb | 160 | } |
| rahul_dahiya |
0:fb8047b156bb | 161 | |
| rahul_dahiya |
0:fb8047b156bb | 162 | #endif |
| rahul_dahiya |
0:fb8047b156bb | 163 |