PHung Tung / DISCO-F746_WAV_PLAYER

SPKT

Dependencies:   F746_GUI SD_PlayerSkeleton F746_SAI_IO

SRC_STM32F7/common/semihost_api.c@0:8ede47d38d10, 2019-06-04 (annotated)

Committer:
phungductung
Date:
Tue Jun 04 21:37:21 2019 +0000
Revision:
0:8ede47d38d10
SPKT

Who changed what in which revision?

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