Lancaster University / mbed-src

Lancaster University's (short term!) clone of mbed-src for micro:bit. This is a copy of the github branch https://github.com/lancaster-university/mbed-classic

Fork of mbed-src by mbed official

capi/mbed_interface.c@0:fd0d7bdfcdc2, 2012-11-20 (annotated)

Committer:
mbed_official
Date:
Tue Nov 20 17:24:08 2012 +0000
Revision:
0:fd0d7bdfcdc2
Child:
2:143cac498751
mbed sources

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbed_official 0:fd0d7bdfcdc2 1 /* mbed Microcontroller Library
mbed_official 0:fd0d7bdfcdc2 2 * Copyright (c) 2006-2012 ARM Limited
mbed_official 0:fd0d7bdfcdc2 3 *
mbed_official 0:fd0d7bdfcdc2 4 * Permission is hereby granted, free of charge, to any person obtaining a copy
mbed_official 0:fd0d7bdfcdc2 5 * of this software and associated documentation files (the "Software"), to deal
mbed_official 0:fd0d7bdfcdc2 6 * in the Software without restriction, including without limitation the rights
mbed_official 0:fd0d7bdfcdc2 7 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
mbed_official 0:fd0d7bdfcdc2 8 * copies of the Software, and to permit persons to whom the Software is
mbed_official 0:fd0d7bdfcdc2 9 * furnished to do so, subject to the following conditions:
mbed_official 0:fd0d7bdfcdc2 10 *
mbed_official 0:fd0d7bdfcdc2 11 * The above copyright notice and this permission notice shall be included in
mbed_official 0:fd0d7bdfcdc2 12 * all copies or substantial portions of the Software.
mbed_official 0:fd0d7bdfcdc2 13 *
mbed_official 0:fd0d7bdfcdc2 14 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
mbed_official 0:fd0d7bdfcdc2 15 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
mbed_official 0:fd0d7bdfcdc2 16 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
mbed_official 0:fd0d7bdfcdc2 17 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
mbed_official 0:fd0d7bdfcdc2 18 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
mbed_official 0:fd0d7bdfcdc2 19 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
mbed_official 0:fd0d7bdfcdc2 20 * SOFTWARE.
mbed_official 0:fd0d7bdfcdc2 21 */
mbed_official 0:fd0d7bdfcdc2 22 #include <stdio.h>
mbed_official 0:fd0d7bdfcdc2 23 #include "mbed_interface.h"
mbed_official 0:fd0d7bdfcdc2 24
mbed_official 0:fd0d7bdfcdc2 25 #include "gpio_api.h"
mbed_official 0:fd0d7bdfcdc2 26 #include "wait_api.h"
mbed_official 0:fd0d7bdfcdc2 27 #include "semihost_api.h"
mbed_official 0:fd0d7bdfcdc2 28 #include "error.h"
mbed_official 0:fd0d7bdfcdc2 29
mbed_official 0:fd0d7bdfcdc2 30 // return true if a debugger is attached, indicating mbed interface is connected
mbed_official 0:fd0d7bdfcdc2 31 int mbed_interface_connected(void) {
mbed_official 0:fd0d7bdfcdc2 32 return semihost_connected();
mbed_official 0:fd0d7bdfcdc2 33 }
mbed_official 0:fd0d7bdfcdc2 34
mbed_official 0:fd0d7bdfcdc2 35 int mbed_interface_reset(void) {
mbed_official 0:fd0d7bdfcdc2 36 if (mbed_interface_connected()) {
mbed_official 0:fd0d7bdfcdc2 37 semihost_reset();
mbed_official 0:fd0d7bdfcdc2 38 return 0;
mbed_official 0:fd0d7bdfcdc2 39 } else {
mbed_official 0:fd0d7bdfcdc2 40 return -1;
mbed_official 0:fd0d7bdfcdc2 41 }
mbed_official 0:fd0d7bdfcdc2 42 }
mbed_official 0:fd0d7bdfcdc2 43
mbed_official 0:fd0d7bdfcdc2 44 int mbed_interface_uid(char *uid) __attribute__((weak));
mbed_official 0:fd0d7bdfcdc2 45 int mbed_interface_uid(char *uid) {
mbed_official 0:fd0d7bdfcdc2 46 if (mbed_interface_connected()) {
mbed_official 0:fd0d7bdfcdc2 47 return semihost_uid(uid); // Returns 0 if successful, -1 on failure
mbed_official 0:fd0d7bdfcdc2 48 } else {
mbed_official 0:fd0d7bdfcdc2 49 uid[0] = 0;
mbed_official 0:fd0d7bdfcdc2 50 return -1;
mbed_official 0:fd0d7bdfcdc2 51 }
mbed_official 0:fd0d7bdfcdc2 52 }
mbed_official 0:fd0d7bdfcdc2 53
mbed_official 0:fd0d7bdfcdc2 54 int mbed_interface_disconnect(void) {
mbed_official 0:fd0d7bdfcdc2 55 if (mbed_interface_connected()) {
mbed_official 0:fd0d7bdfcdc2 56 return semihost_disabledebug();
mbed_official 0:fd0d7bdfcdc2 57 } else {
mbed_official 0:fd0d7bdfcdc2 58 return -1;
mbed_official 0:fd0d7bdfcdc2 59 }
mbed_official 0:fd0d7bdfcdc2 60 }
mbed_official 0:fd0d7bdfcdc2 61
mbed_official 0:fd0d7bdfcdc2 62 int mbed_interface_powerdown(void) {
mbed_official 0:fd0d7bdfcdc2 63 mbed_interface_disconnect();
mbed_official 0:fd0d7bdfcdc2 64 if (mbed_interface_connected()) {
mbed_official 0:fd0d7bdfcdc2 65 return semihost_powerdown();
mbed_official 0:fd0d7bdfcdc2 66 } else {
mbed_official 0:fd0d7bdfcdc2 67 return -1;
mbed_official 0:fd0d7bdfcdc2 68 }
mbed_official 0:fd0d7bdfcdc2 69 }
mbed_official 0:fd0d7bdfcdc2 70
mbed_official 0:fd0d7bdfcdc2 71 void mbed_mac_address(char *mac) __attribute__((weak));
mbed_official 0:fd0d7bdfcdc2 72 void mbed_mac_address(char *mac) {
mbed_official 0:fd0d7bdfcdc2 73 char uid[33];
mbed_official 0:fd0d7bdfcdc2 74 int i;
mbed_official 0:fd0d7bdfcdc2 75
mbed_official 0:fd0d7bdfcdc2 76 // if we have a UID, extract the MAC
mbed_official 0:fd0d7bdfcdc2 77 if (mbed_interface_uid(uid) == 0) {
mbed_official 0:fd0d7bdfcdc2 78 char *p = uid + 20;
mbed_official 0:fd0d7bdfcdc2 79 for (i=0; i<6; i++) {
mbed_official 0:fd0d7bdfcdc2 80 int byte;
mbed_official 0:fd0d7bdfcdc2 81 sscanf(p, "%2x", &byte);
mbed_official 0:fd0d7bdfcdc2 82 mac[i] = byte;
mbed_official 0:fd0d7bdfcdc2 83 p += 2;
mbed_official 0:fd0d7bdfcdc2 84 }
mbed_official 0:fd0d7bdfcdc2 85 } else { // else return a default MAC
mbed_official 0:fd0d7bdfcdc2 86 mac[0] = 0x00;
mbed_official 0:fd0d7bdfcdc2 87 mac[1] = 0x02;
mbed_official 0:fd0d7bdfcdc2 88 mac[2] = 0xF7;
mbed_official 0:fd0d7bdfcdc2 89 mac[3] = 0xF0;
mbed_official 0:fd0d7bdfcdc2 90 mac[4] = 0x00;
mbed_official 0:fd0d7bdfcdc2 91 mac[5] = 0x00;
mbed_official 0:fd0d7bdfcdc2 92 }
mbed_official 0:fd0d7bdfcdc2 93 }
mbed_official 0:fd0d7bdfcdc2 94
mbed_official 0:fd0d7bdfcdc2 95 // for backward compatibility
mbed_official 0:fd0d7bdfcdc2 96 void mbed_reset(void) {
mbed_official 0:fd0d7bdfcdc2 97 mbed_interface_reset();
mbed_official 0:fd0d7bdfcdc2 98 }
mbed_official 0:fd0d7bdfcdc2 99
mbed_official 0:fd0d7bdfcdc2 100 int mbed_uid(char *uid) __attribute__((weak));
mbed_official 0:fd0d7bdfcdc2 101 int mbed_uid(char *uid) {
mbed_official 0:fd0d7bdfcdc2 102 return mbed_interface_uid(uid);
mbed_official 0:fd0d7bdfcdc2 103 }