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