This package contains a simple test of tests for various elements of the SmartBoard hardware, which is a simple baseboard designed for easy embedding. It is able to run both a semi-automatic test suite as well as allow interactive testing.

Dependencies:   EthernetNetIf NTPClient_NetServices mbed

This program is most of what you need to test your SmartBoard baseboard hardware. It provides a means to test the following:

  • Two channels of CAN (with a loopback cable)
  • RS-232 Ports
  • Analog inputs
  • PWM outputs
  • Ethernet port
  • Real time clock
  • micro SD
  • USB Host port

Files at this revision

API Documentation at this revision

Comitter:
WiredHome
Date:
Sun Jan 16 18:30:14 2011 +0000
Child:
1:586392c0e935
Commit message:
First release

Changed in this revision

EthernetNetIf.lib Show annotated file Show diff for this revision Revisions of this file
FATFileSystem.lib Show annotated file Show diff for this revision Revisions of this file
MSCFileSystem_Lib.lib Show annotated file Show diff for this revision Revisions of this file
NTPClient.lib Show annotated file Show diff for this revision Revisions of this file
SDFileSystem.cpp Show annotated file Show diff for this revision Revisions of this file
SDFileSystem.h Show annotated file Show diff for this revision Revisions of this file
ShowTime.c Show annotated file Show diff for this revision Revisions of this file
ShowTime.h Show annotated file Show diff for this revision Revisions of this file
SmartBoard.h Show annotated file Show diff for this revision Revisions of this file
SmartBoard_Tester.cpp Show annotated file Show diff for this revision Revisions of this file
mbed.bld Show annotated file Show diff for this revision Revisions of this file
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/EthernetNetIf.lib	Sun Jan 16 18:30:14 2011 +0000
@@ -0,0 +1,1 @@
+http://mbed.org/users/mamezu/code/EthernetNetIf/#0f6c82fcde82
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/FATFileSystem.lib	Sun Jan 16 18:30:14 2011 +0000
@@ -0,0 +1,1 @@
+http://mbed.org/users/mbed_unsupported/code/fatfilesystem/
\ No newline at end of file
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/MSCFileSystem_Lib.lib	Sun Jan 16 18:30:14 2011 +0000
@@ -0,0 +1,1 @@
+http://mbed.org/users/chris/code/MSCFileSystem_Lib/#f4e330489777
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/NTPClient.lib	Sun Jan 16 18:30:14 2011 +0000
@@ -0,0 +1,1 @@
+http://mbed.org/users/donatien/code/NTPClient/#7c3f1199256a
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/SDFileSystem.cpp	Sun Jan 16 18:30:14 2011 +0000
@@ -0,0 +1,457 @@
+/* mbed SDFileSystem Library, for providing file access to SD cards
+ * Copyright (c) 2008-2010, sford
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+/* Introduction
+ * ------------
+ * SD and MMC cards support a number of interfaces, but common to them all
+ * is one based on SPI. This is the one I'm implmenting because it means
+ * it is much more portable even though not so performant, and we already 
+ * have the mbed SPI Interface!
+ *
+ * The main reference I'm using is Chapter 7, "SPI Mode" of: 
+ *  http://www.sdcard.org/developers/tech/sdcard/pls/Simplified_Physical_Layer_Spec.pdf
+ *
+ * SPI Startup
+ * -----------
+ * The SD card powers up in SD mode. The SPI interface mode is selected by
+ * asserting CS low and sending the reset command (CMD0). The card will 
+ * respond with a (R1) response.
+ *
+ * CMD8 is optionally sent to determine the voltage range supported, and 
+ * indirectly determine whether it is a version 1.x SD/non-SD card or 
+ * version 2.x. I'll just ignore this for now.
+ *
+ * ACMD41 is repeatedly issued to initialise the card, until "in idle"
+ * (bit 0) of the R1 response goes to '0', indicating it is initialised.
+ *
+ * You should also indicate whether the host supports High Capicity cards,
+ * and check whether the card is high capacity - i'll also ignore this
+ *
+ * SPI Protocol
+ * ------------
+ * The SD SPI protocol is based on transactions made up of 8-bit words, with
+ * the host starting every bus transaction by asserting the CS signal low. The
+ * card always responds to commands, data blocks and errors.
+ * 
+ * The protocol supports a CRC, but by default it is off (except for the 
+ * first reset CMD0, where the CRC can just be pre-calculated, and CMD8)
+ * I'll leave the CRC off I think! 
+ * 
+ * Standard capacity cards have variable data block sizes, whereas High 
+ * Capacity cards fix the size of data block to 512 bytes. I'll therefore
+ * just always use the Standard Capacity cards with a block size of 512 bytes.
+ * This is set with CMD16.
+ *
+ * You can read and write single blocks (CMD17, CMD25) or multiple blocks 
+ * (CMD18, CMD25). For simplicity, I'll just use single block accesses. When
+ * the card gets a read command, it responds with a response token, and then 
+ * a data token or an error.
+ * 
+ * SPI Command Format
+ * ------------------
+ * Commands are 6-bytes long, containing the command, 32-bit argument, and CRC.
+ *
+ * +---------------+------------+------------+-----------+----------+--------------+
+ * | 01 | cmd[5:0] | arg[31:24] | arg[23:16] | arg[15:8] | arg[7:0] | crc[6:0] | 1 |
+ * +---------------+------------+------------+-----------+----------+--------------+
+ *
+ * As I'm not using CRC, I can fix that byte to what is needed for CMD0 (0x95)
+ *
+ * All Application Specific commands shall be preceded with APP_CMD (CMD55).
+ *
+ * SPI Response Format
+ * -------------------
+ * The main response format (R1) is a status byte (normally zero). Key flags:
+ *  idle - 1 if the card is in an idle state/initialising 
+ *  cmd  - 1 if an illegal command code was detected
+ *
+ *    +-------------------------------------------------+
+ * R1 | 0 | arg | addr | seq | crc | cmd | erase | idle |
+ *    +-------------------------------------------------+
+ *
+ * R1b is the same, except it is followed by a busy signal (zeros) until
+ * the first non-zero byte when it is ready again.
+ *
+ * Data Response Token
+ * -------------------
+ * Every data block written to the card is acknowledged by a byte 
+ * response token
+ *
+ * +----------------------+
+ * | xxx | 0 | status | 1 |
+ * +----------------------+
+ *              010 - OK!
+ *              101 - CRC Error
+ *              110 - Write Error
+ *
+ * Single Block Read and Write
+ * ---------------------------
+ *
+ * Block transfers have a byte header, followed by the data, followed
+ * by a 16-bit CRC. In our case, the data will always be 512 bytes.
+ *  
+ * +------+---------+---------+- -  - -+---------+-----------+----------+
+ * | 0xFE | data[0] | data[1] |        | data[n] | crc[15:8] | crc[7:0] | 
+ * +------+---------+---------+- -  - -+---------+-----------+----------+
+ */
+ 
+#include "SDFileSystem.h"
+
+#define SD_COMMAND_TIMEOUT 5000
+
+SDFileSystem::SDFileSystem(PinName mosi, PinName miso, PinName sclk, PinName cs, const char* name) :
+  FATFileSystem(name), _spi(mosi, miso, sclk), _cs(cs) {
+      _cs = 1; 
+}
+
+#define R1_IDLE_STATE           (1 << 0)
+#define R1_ERASE_RESET          (1 << 1)
+#define R1_ILLEGAL_COMMAND      (1 << 2)
+#define R1_COM_CRC_ERROR        (1 << 3)
+#define R1_ERASE_SEQUENCE_ERROR (1 << 4)
+#define R1_ADDRESS_ERROR        (1 << 5)
+#define R1_PARAMETER_ERROR      (1 << 6)
+
+// Types
+//  - v1.x Standard Capacity
+//  - v2.x Standard Capacity
+//  - v2.x High Capacity
+//  - Not recognised as an SD Card
+
+#define SDCARD_FAIL 0
+#define SDCARD_V1   1
+#define SDCARD_V2   2
+#define SDCARD_V2HC 3
+
+int SDFileSystem::initialise_card() {
+    // Set to 100kHz for initialisation, and clock card with cs = 1
+    _spi.frequency(100000); 
+    _cs = 1;
+    for(int i=0; i<16; i++) {   
+        _spi.write(0xFF);
+    }
+
+    // send CMD0, should return with all zeros except IDLE STATE set (bit 0)
+    if(_cmd(0, 0) != R1_IDLE_STATE) { 
+        fprintf(stderr, "No disk, or could not put SD card in to SPI idle state\n");
+        return SDCARD_FAIL;
+    }
+
+    // send CMD8 to determine whther it is ver 2.x
+    int r = _cmd8();
+    if(r == R1_IDLE_STATE) {
+        return initialise_card_v2();
+    } else if(r == (R1_IDLE_STATE | R1_ILLEGAL_COMMAND)) {
+        return initialise_card_v1();
+    } else {
+        fprintf(stderr, "Not in idle state after sending CMD8 (not an SD card?)\n");
+        return SDCARD_FAIL;
+    }
+}
+
+int SDFileSystem::initialise_card_v1() {
+    for(int i=0; i<SD_COMMAND_TIMEOUT; i++) {
+        _cmd(55, 0); 
+        if(_cmd(41, 0) == 0) { 
+            return SDCARD_V1;
+        }
+    }
+
+    fprintf(stderr, "Timeout waiting for v1.x card\n");
+    return SDCARD_FAIL;
+}
+
+int SDFileSystem::initialise_card_v2() {
+    
+    for(int i=0; i<SD_COMMAND_TIMEOUT; i++) {
+        _cmd(55, 0); 
+        if(_cmd(41, 0) == 0) { 
+            _cmd58();
+            return SDCARD_V2;
+        }
+    }
+
+    fprintf(stderr, "Timeout waiting for v2.x card\n");
+    return SDCARD_FAIL;
+}
+
+int SDFileSystem::disk_initialize() {
+
+    int i = initialise_card();
+//    printf("init card = %d\n", i);
+//    printf("OK\n");
+
+    _sectors = _sd_sectors();
+
+    // Set block length to 512 (CMD16)
+    if(_cmd(16, 512) != 0) {
+        fprintf(stderr, "Set 512-byte block timed out\n");
+        return 1;
+    }
+        
+    _spi.frequency(1000000); // Set to 1MHz for data transfer
+    return 0;
+}
+
+int SDFileSystem::disk_write(const char *buffer, int block_number) {
+    // set write address for single block (CMD24)
+    if(_cmd(24, block_number * 512) != 0) {
+        return 1;
+    }
+
+    // send the data block
+    _write(buffer, 512);    
+    return 0;    
+}
+
+int SDFileSystem::disk_read(char *buffer, int block_number) {        
+    // set read address for single block (CMD17)
+    if(_cmd(17, block_number * 512) != 0) {
+        return 1;
+    }
+    
+    // receive the data
+    _read(buffer, 512);
+    return 0;
+}
+
+int SDFileSystem::disk_status() { return 0; }
+int SDFileSystem::disk_sync() { return 0; }
+int SDFileSystem::disk_sectors() { return _sectors; }
+
+// PRIVATE FUNCTIONS
+
+int SDFileSystem::_cmd(int cmd, int arg) {
+    _cs = 0; 
+
+    // send a command
+    _spi.write(0x40 | cmd);
+    _spi.write(arg >> 24);
+    _spi.write(arg >> 16);
+    _spi.write(arg >> 8);
+    _spi.write(arg >> 0);
+    _spi.write(0x95);
+
+    // wait for the repsonse (response[7] == 0)
+    for(int i=0; i<SD_COMMAND_TIMEOUT; i++) {
+        int response = _spi.write(0xFF);
+        if(!(response & 0x80)) {
+            _cs = 1;
+            _spi.write(0xFF);
+            return response;
+        }
+    }
+    _cs = 1;
+    _spi.write(0xFF);
+    return -1; // timeout
+}
+int SDFileSystem::_cmdx(int cmd, int arg) {
+    _cs = 0; 
+
+    // send a command
+    _spi.write(0x40 | cmd);
+    _spi.write(arg >> 24);
+    _spi.write(arg >> 16);
+    _spi.write(arg >> 8);
+    _spi.write(arg >> 0);
+    _spi.write(0x95);
+
+    // wait for the repsonse (response[7] == 0)
+    for(int i=0; i<SD_COMMAND_TIMEOUT; i++) {
+        int response = _spi.write(0xFF);
+        if(!(response & 0x80)) {
+            return response;
+        }
+    }
+    _cs = 1;
+    _spi.write(0xFF);
+    return -1; // timeout
+}
+
+
+int SDFileSystem::_cmd58() {
+    _cs = 0; 
+    int arg = 0;
+    
+    // send a command
+    _spi.write(0x40 | 58);
+    _spi.write(arg >> 24);
+    _spi.write(arg >> 16);
+    _spi.write(arg >> 8);
+    _spi.write(arg >> 0);
+    _spi.write(0x95);
+
+    // wait for the repsonse (response[7] == 0)
+    for(int i=0; i<SD_COMMAND_TIMEOUT; i++) {
+        int response = _spi.write(0xFF);
+        if(!(response & 0x80)) {
+            int ocr = _spi.write(0xFF) << 24;
+            ocr |= _spi.write(0xFF) << 16;
+            ocr |= _spi.write(0xFF) << 8;
+            ocr |= _spi.write(0xFF) << 0;
+//            printf("OCR = 0x%08X\n", ocr);
+            _cs = 1;
+            _spi.write(0xFF);
+            return response;
+        }
+    }
+    _cs = 1;
+    _spi.write(0xFF);
+    return -1; // timeout
+}
+
+int SDFileSystem::_cmd8() {
+    _cs = 0; 
+    
+    // send a command
+    _spi.write(0x40 | 8); // CMD8
+    _spi.write(0x00);     // reserved
+    _spi.write(0x00);     // reserved
+    _spi.write(0x01);     // 3.3v
+    _spi.write(0xAA);     // check pattern
+    _spi.write(0x87);     // crc
+
+    // wait for the repsonse (response[7] == 0)
+    for(int i=0; i<SD_COMMAND_TIMEOUT * 1000; i++) {
+        char response[5];
+        response[0] = _spi.write(0xFF);
+        if(!(response[0] & 0x80)) {
+                for(int j=1; j<5; j++) {
+                    response[i] = _spi.write(0xFF);
+                }
+                _cs = 1;
+                _spi.write(0xFF);
+                return response[0];
+        }
+    }
+    _cs = 1;
+    _spi.write(0xFF);
+    return -1; // timeout
+}
+
+int SDFileSystem::_read(char *buffer, int length) {
+    _cs = 0;
+
+    // read until start byte (0xFF)
+    while(_spi.write(0xFF) != 0xFE);
+
+    // read data
+    for(int i=0; i<length; i++) {
+        buffer[i] = _spi.write(0xFF);
+    }
+    _spi.write(0xFF); // checksum
+    _spi.write(0xFF);
+
+    _cs = 1;    
+    _spi.write(0xFF);
+    return 0;
+}
+
+int SDFileSystem::_write(const char *buffer, int length) {
+    _cs = 0;
+    
+    // indicate start of block
+    _spi.write(0xFE);
+    
+    // write the data
+    for(int i=0; i<length; i++) {
+        _spi.write(buffer[i]);
+    }
+    
+    // write the checksum
+    _spi.write(0xFF); 
+    _spi.write(0xFF);
+
+    // check the repsonse token
+    if((_spi.write(0xFF) & 0x1F) != 0x05) {
+        _cs = 1;
+        _spi.write(0xFF);        
+        return 1;
+    }
+
+    // wait for write to finish
+    while(_spi.write(0xFF) == 0);
+
+    _cs = 1; 
+    _spi.write(0xFF);
+    return 0;
+}
+
+static int ext_bits(char *data, int msb, int lsb) {
+    int bits = 0;
+    int size = 1 + msb - lsb; 
+    for(int i=0; i<size; i++) {
+        int position = lsb + i;
+        int byte = 15 - (position >> 3);
+        int bit = position & 0x7;
+        int value = (data[byte] >> bit) & 1;
+        bits |= value << i;
+    }
+    return bits;
+}
+
+int SDFileSystem::_sd_sectors() {
+
+    // CMD9, Response R2 (R1 byte + 16-byte block read)
+    if(_cmdx(9, 0) != 0) {
+        fprintf(stderr, "Didn't get a response from the disk\n");
+        return 0;
+    }
+    
+    char csd[16];    
+    if(_read(csd, 16) != 0) {
+        fprintf(stderr, "Couldn't read csd response from disk\n");
+        return 0;
+    }
+
+    // csd_structure : csd[127:126]
+    // c_size        : csd[73:62]
+    // c_size_mult   : csd[49:47]
+    // read_bl_len   : csd[83:80] - the *maximum* read block length
+
+    int csd_structure = ext_bits(csd, 127, 126);
+    int c_size = ext_bits(csd, 73, 62);
+    int c_size_mult = ext_bits(csd, 49, 47);
+    int read_bl_len = ext_bits(csd, 83, 80);
+
+//    printf("CSD_STRUCT = %d\n", csd_structure);
+    
+    if(csd_structure != 0) {
+        fprintf(stderr, "This disk tastes funny! I only know about type 0 CSD structures\n");
+        return 0;
+    }
+             
+    // memory capacity = BLOCKNR * BLOCK_LEN
+    // where
+    //  BLOCKNR = (C_SIZE+1) * MULT
+    //  MULT = 2^(C_SIZE_MULT+2) (C_SIZE_MULT < 8)
+    //  BLOCK_LEN = 2^READ_BL_LEN, (READ_BL_LEN < 12)         
+                            
+    int block_len = 1 << read_bl_len;
+    int mult = 1 << (c_size_mult + 2);
+    int blocknr = (c_size + 1) * mult;
+    int capacity = blocknr * block_len;
+        
+    int blocks = capacity / 512;
+        
+    return blocks;
+}
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/SDFileSystem.h	Sun Jan 16 18:30:14 2011 +0000
@@ -0,0 +1,81 @@
+/* mbed SDFileSystem Library, for providing file access to SD cards
+ * Copyright (c) 2008-2010, sford
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+#ifndef MBED_SDFILESYSTEM_H
+#define MBED_SDFILESYSTEM_H
+
+#include "mbed.h"
+#include "FATFileSystem.h"
+
+/** Access the filesystem on an SD Card using SPI
+ *
+ * @code
+ * #include "mbed.h"
+ * #include "SDFileSystem.h"
+ *
+ * SDFileSystem sd(p5, p6, p7, p12, "sd"); // mosi, miso, sclk, cs
+ *  
+ * int main() {
+ *     FILE *fp = fopen("/sd/myfile.txt", "w");
+ *     fprintf(fp, "Hello World!\n");
+ *     fclose(fp);
+ * }
+ */
+class SDFileSystem : public FATFileSystem {
+public:
+
+    /** Create the File System for accessing an SD Card using SPI
+     *
+     * @param mosi SPI mosi pin connected to SD Card
+     * @param miso SPI miso pin conencted to SD Card
+     * @param sclk SPI sclk pin connected to SD Card
+     * @param cs   DigitalOut pin used as SD Card chip select
+     * @param name The name used to access the virtual filesystem
+     */
+    SDFileSystem(PinName mosi, PinName miso, PinName sclk, PinName cs, const char* name);
+    virtual int disk_initialize();
+    virtual int disk_write(const char *buffer, int block_number);
+    virtual int disk_read(char *buffer, int block_number);    
+    virtual int disk_status();
+    virtual int disk_sync();
+    virtual int disk_sectors();
+
+protected:
+
+    int _cmd(int cmd, int arg);
+    int _cmdx(int cmd, int arg);
+    int _cmd8();
+    int _cmd58();
+    int initialise_card();
+    int initialise_card_v1();
+    int initialise_card_v2();
+    
+    int _read(char *buffer, int length);
+    int _write(const char *buffer, int length);
+    int _sd_sectors();
+    int _sectors;
+    
+    SPI _spi;
+    DigitalOut _cs;     
+};
+
+#endif
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/ShowTime.c	Sun Jan 16 18:30:14 2011 +0000
@@ -0,0 +1,20 @@
+
+#include "mbed.h"
+
+
+static int SignOf(const int i) {
+    return (i >= 0) ? 1 : -1;
+}
+
+
+void ShowTime(time_t tValue=0, int hOffset=0, int mOffset=0) {
+    time_t ctTime;
+    char timbuf[70];
+
+    if (tValue == 0)
+        tValue = time(NULL);
+    ctTime = tValue + hOffset * 3600 + SignOf(hOffset) * mOffset * 60;
+    strcpy(timbuf, ctime(&ctTime));
+    timbuf[strlen(timbuf)-1] = '\0';
+    printf("    %s (offset: %02i:%02i)\r\n", timbuf, hOffset, mOffset);
+}
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/ShowTime.h	Sun Jan 16 18:30:14 2011 +0000
@@ -0,0 +1,13 @@
+
+/// ShowTime prints out the time to the serial console in a usable format
+///
+/// This prints the passed in, or current time, to the console. It will
+/// indicate the time zone offset parameters as well.
+///
+/// @param tValue is the optional time value to convert to friendly time format. If
+///     this value is absent or zero, then it will get the system time to convert.
+/// @param hOffset is the optional hour offset to the local time zone
+/// @param mOffset is the optional minute offset to the local time zone
+/// @returns nothing
+///
+void ShowTime(time_t tValue=0, int hOffset=0, int mOffset=0);
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/SmartBoard.h	Sun Jan 16 18:30:14 2011 +0000
@@ -0,0 +1,12 @@
+/// @file SmartBoard.h defines IO special to the board
+///
+///  This is for version 0.05 of the SmartBoard mbed carrier
+///
+
+#ifndef SMARTBOARD_H
+#define SMARTBOARD_H
+
+#define ETHERGREEN p25
+#define ETHERYELLOW p26
+
+#endif
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/SmartBoard_Tester.cpp	Sun Jan 16 18:30:14 2011 +0000
@@ -0,0 +1,453 @@
+/// @file SmartBoard_Tester.cpp is the simple test framework
+///
+/// This file contains the startup, interactive, and test code
+/// to evaluate the SmartBoard baseboard.
+///
+/// @note Copyright &copy; 2011 by Smartware Computing, all rights reserved.
+/// @author David Smart
+///
+#include "mbed.h"
+#include "SmartBoard.h"
+#include "ShowTime.h"
+#include "EthernetNetIf.h"
+#include "NTPClient.h"
+#include "SDFileSystem.h"
+#include "MSCFileSystem.h"
+
+Serial pc(USBTX, USBRX);    ///< Used as the console for interactively reporting progress
+
+const char * TicTocServer = "ntp.okstate.edu";  ///< time server since it is closer than "0.uk.pool.ntp.org"
+const int tzOffsetHr = -6;      ///< time zone offset hours to print time in local time
+const int tzOffsetMin = 0;      ///< time zone offset minutes to print time in local time
+
+void LED_Tests(void);
+void PWM_Tests(void);
+void AnalogIn_Tests(void);
+void RTC_Tests(void);
+void MicroSD_Tests(void);
+void RS_232_Tests(void);
+void CAN_Tests(void);
+void Ethernet_Tests(void);
+void USBHost_Tests(void);
+
+/// TestVector will execute a given test, based on the parameter
+///
+/// It can show the list of available commands, as for an interactive
+/// test session, or it can simply execute the chosen test. This is
+/// used for both the automated testing and the interactive testing,
+/// so a couple of the commands for interactive would not be used
+/// for the automated testing.
+/// '?' causes it to display the available commands.
+///
+/// @param i contains the single character value indicating the operation
+///         to perform.
+/// @returns false if the input paramter was 'X'.
+/// @returns true if the input parameters was not 'X'.
+///
+bool TestVector(int i) {
+    bool r = true;  ///< expect to return true
+
+    switch (i) {
+        default:
+        case '?':
+            pc.printf("Commands:\r\nx"
+                      "  L   LED_Tests();\r\n"
+                      "  P   PWM_Tests(); // note interaction between LEDs and PWMs\r\n"
+                      "  A   AnalogIn_Tests();\r\n"
+                      "  R   RTC_Tests();\r\n"
+                      "  M   MicroSD_Tests();\r\n"
+                      "  S   RS_232_Tests();\r\n"
+                      "  C   CAN_Tests();\r\n"
+                      "  E   Ethernet_Tests();\r\n"
+                      "  U   USBHost_Tests();\r\n"
+                      "  X   eXit to automatic testing\r\n");
+            break;
+        case 'X':
+            r = false;
+            break;
+        case 'L':
+            LED_Tests();
+            break;
+        case 'P':
+            PWM_Tests();
+            break;
+        case 'A':
+            AnalogIn_Tests();
+            break;
+        case 'R':
+            RTC_Tests();
+            break;
+        case 'M':
+            MicroSD_Tests();
+            break;
+        case 'S':
+            RS_232_Tests();
+            break;
+        case 'C':
+            CAN_Tests();
+            break;
+        case 'E':
+            Ethernet_Tests();
+            break;
+        case 'U':
+            USBHost_Tests();
+            break;
+    }
+    return r;
+}
+
+/// main is the main startup code.
+///
+/// This initializes the test environment, shows a banner,
+/// and starts the automated testing.
+/// It also detects if the user is attempting to interact, and
+/// between each test category there is the possibility to transfer
+/// to the interactive test mode.
+/// When in interactive test mode, the user determines which test
+/// to run. The user can also exit interactive mode back to the
+/// automated test mode.
+///
+/// @returns never
+///
+int main() {
+    bool init = true;                   ///< init is slightly different
+    bool interactive = false;           ///< track when in interactive mode
+    int test = 0;                       ///< which test to run
+    char TestList[] = "XLPARMSCEU";     ///< list of valid test commands
+
+    while (1) {
+        if (pc.readable() || init) {
+            pc.printf("\r\n\r\n");
+            pc.printf("SmartBoard Hardware Tester\r\n");
+            pc.printf("  SmartBoard Hardware    v0.05\r\n");
+            pc.printf("  SmartBoard Software    v0.07\r\n");
+            pc.printf("\r\n");
+            pc.printf("                      [USB]       [Eth/USB]    \r\n");
+            pc.printf(" +---------------+------------+---+-------+---+\r\n");
+            pc.printf(" |O [RS232 1-2]  |  |       | |   |       |  O|\r\n");
+            pc.printf(" |               |  |microSD| |   |       |   |\r\n");
+            pc.printf(" |S              |  |       | |   |       |  C|\r\n");
+            pc.printf(" |P              |  +-------+ |   |       |  A|\r\n");
+            pc.printf(" |I              |            |   |Yl   Gr|  N|\r\n");
+            pc.printf(" |1              |            |   +-------+  1|\r\n");
+            pc.printf(" |-              |            |              -|\r\n");
+            pc.printf(" |2              |     RTC    |              2|\r\n");
+            pc.printf(" |               |  (Battery) |               |\r\n");
+            pc.printf(" |               |            |               |\r\n");
+            pc.printf(" |               | 1  2  3  4 |               |\r\n");
+            pc.printf(" |               +------------+               |\r\n");
+            pc.printf(" |O[Analog In ]        O        [PWM Out]    O|\r\n");
+            pc.printf(" +--------------------------------------------+\r\n");
+            pc.printf("\r\n");
+            init = false;
+        }
+        if (pc.readable()) {
+            interactive = true;
+            while (pc.readable())
+                (void)pc.getc();
+
+            while (interactive) {
+                pc.printf("> ");
+                int i = pc.getc();
+                pc.putc(i);
+                pc.putc('\r');
+                pc.putc('\n');
+                interactive = TestVector(i);
+            }
+        } else {
+            if (test == 0)
+                pc.printf("\x07"); // Bell character indicating start of tests
+            TestVector(TestList[test++]);
+            if (TestList[test] == '\0')
+                test = 0;
+            wait(5.0);  // Extra pause
+        }
+    }
+}
+
+/// LED_Tests performs some simple digital output to the
+/// LEDs.
+///
+/// It will attempt to exercise the LEDs on the Ethernet ports
+/// as well, but by jumper configuration these may not be available.
+///
+void LED_Tests(void) {
+    int l;
+    int i;
+    struct {
+        const char * name;
+        DigitalOut led;
+    } Leds[] = {
+        {"Ethernet Green", ETHERGREEN},
+        {"Ethernet Yellow", ETHERYELLOW},
+        {"Led 1", LED1},
+        {"Led 2", LED2},
+        {"Led 3", LED3},
+        {"Led 4", LED4}
+    };
+    const int numLeds = sizeof(Leds) / sizeof(Leds[0]);
+
+    printf("LED Test:\r\n");
+    for (l=0; l<numLeds; l++) {
+        printf("   Blink %s LED 3 times\r\n", Leds[l].name);
+        for (i=0; i<3; i++) {
+            Leds[l].led = true;
+            wait(0.4);
+            Leds[l].led = false;
+            wait(0.4);
+        }
+    }
+}
+
+/// PWM_Tests performs some simple pwm output to the
+/// PWM channels and the LEDs.
+///
+/// It will attempt to exercise the outputs with a simple ramping
+/// signal, but by jumper configuration these may not be available.
+///
+void PWM_Tests(void) {
+    int l;
+    int i;
+    float f;
+    struct {
+        const char * name;
+        PwmOut pwm;
+    } Pwms[] = {
+        {"PWM 1", p21},
+        {"PWM 2", p22},
+        {"PWM 3", p23},
+        {"PWM 4", p24},
+        {"PWM 5", p25},
+        {"PWM 6", p26},
+        {"Led 1", LED1},
+        {"Led 2", LED2},
+        {"Led 3", LED3},
+        {"Led 4", LED4}
+    };
+    const int numPwms = sizeof(Pwms) / sizeof(Pwms[0]);
+
+    printf("PWM Test:\r\n");
+    for (l=0; l<numPwms; l++) {
+        printf("   Ramp %s PWM 3 times\r\n", Pwms[l].name);
+        for (i=0; i<3; i++) {
+            for (f=0.0; f<=1.0; f+= 0.1) {
+                Pwms[l].pwm = f;
+                wait(0.1);
+            }
+        }
+        Pwms[l].pwm = 0;    // off when done
+    }
+}
+
+/// AnalogIn_Tests takes a few sample measurements on each channel
+///
+/// It samples each channel a number of times and presents the
+/// converted results on the console.
+///
+void AnalogIn_Tests(void) {
+    int l;
+    int i;
+    const int samples = 20;
+    struct {
+        const char * name;
+        AnalogIn in;
+    } Analogs[] = {
+        {"Ain 1", p15},
+        {"Ain 2", p16},
+        {"Ain 3", p17},
+        {"Ain 4", p18},
+        {"Ain 5", p19},
+        {"Ain 6", p20}
+    };
+    const int numAnalogs = sizeof(Analogs) / sizeof(Analogs[0]);
+
+    printf("Analog Test:\r\n");
+    for (l=0; l<numAnalogs; l++) {
+        for (i=0; i<samples; i++) {
+            uint16_t raw = Analogs[l].in.read_u16();
+            float flt = Analogs[l].in.read();
+            printf("    Analog %i is %04X, %3.2f, %3.2fv\r", l, raw, flt, flt*3.3);
+            wait(0.1);
+        }
+        printf("\n");
+    }
+}
+
+/// RTC_Tests will perform simple tests on the Real Time Clock
+///
+/// It will first sample the time from the RTC and later restore
+/// it as best it can.
+/// In the middle of that it will set the clock, then simply show
+/// the time once per second for 5 seconds. After this it
+/// will restore the clock at best it can.
+///
+void RTC_Tests(void) {
+    time_t x;
+    int i;
+    const int oldTime = 1256729737;
+
+    printf("RTC Test:\r\n");
+    ShowTime(0, -6, 0);
+    x = time(NULL);         // Save the time before the test
+    printf("    Saving current time(%d)\r\n", x);
+
+    set_time(oldTime);  // Set RTC time to Wed, 28 Oct 2009 11:35:37
+    printf("    Set time to Wed, 28 Oct 2009 11:35:37\r\n");
+
+    for (i=0; i<5; i++) {
+        ShowTime();
+        wait(1.0);
+    }
+    set_time(x + time(NULL) - 1256729737);          // Approximately restored
+    ShowTime(0, -6, 0);
+    wait(1.0);
+    ShowTime(0, -6, 0);
+}
+
+/// Ethernet_Tests will attempt to test the Ethernet interface
+///
+/// It will connect to the network - if possible, then it will
+/// try to connect to a network time server and set the clock,
+/// using hard coded time server and time zone offset values.
+///
+/// It appears that the Ethernet interface cannot be instantiated,
+/// destroyed, and later instantiated again (it would reliably "hang").
+/// So, this test is "runonce" protected.
+///
+void Ethernet_Tests(void) {
+    EthernetNetIf eth;
+    NTPClient ntp;
+    static bool runonce = true;
+
+    printf("Ethernet Test:\r\n");
+    if (runonce) {
+        EthernetErr ethErr = eth.setup();
+        if (ethErr) {
+            printf("Error %d in setup.\r\n", ethErr);
+            return;
+        }
+        printf("    Ethernet Setup OK\r\n");
+        ShowTime(0, tzOffsetHr, tzOffsetMin);
+        printf("    Setting clock to %s\r\n", TicTocServer);
+        Host server(IpAddr(), 123, TicTocServer);
+        ntp.setTime(server);
+        printf("    Clock was set.\r\n");
+        wait(1.0);
+        ShowTime(0, tzOffsetHr, tzOffsetMin);
+        runonce = false;
+    } else {
+        printf("   only runs once per cold-boot.\r\n");
+    }
+}
+
+/// MicroSD_Tests attempts to access and write a file on the micro SD card
+///
+/// It will mount the file system, then attempt to write a simple
+/// file on the micro SD card.
+///
+void MicroSD_Tests(void) {
+    SDFileSystem sd(p5, p6, p7, p8, "sd"); // the pinout on the mbed Cool Components workshop board
+    FILE *fp;
+    char buffer[50];
+
+    printf("SD File System Tests:\r\n");
+    mkdir("/sd/mydir", 0777);
+    fp = fopen("/sd/mydir/sdtest.txt", "w");
+    if (fp == NULL) {
+        printf("    Could not open file for write\r\n");
+    } else {
+        fprintf(fp, "Write a message to the micro SD card!");
+        fclose(fp);
+        printf("    Closed file.\r\n");
+        fp = fopen("/sd/mydir/sdtest.txt", "r");
+        if (fp) {
+            printf("    Reading file back.\r\n");
+            if (fgets(buffer, sizeof(buffer), fp)) {
+                if (strlen(buffer) > 2)
+                    buffer[strlen(buffer)-2] = '\0';    // chomp the <LF>
+                printf("    Read: {%s}\r\n", buffer);
+            }
+            fclose(fp);
+        }
+    }
+    printf("    test complete!\r\n");
+}
+
+
+/// USBHost_Tests attempts to access and write a file on USB stick
+///
+/// It will mount the file system, then attempt to write a simple
+/// file on the USB interface.
+///
+void USBHost_Tests(void) {
+    MSCFileSystem fs ("fs");
+    FILE *fp;
+    char buffer[50];
+
+    printf("USB Host Tests: [installed memory stick required]\r\n");
+    fp = fopen("/fs/hello.txt","w");
+    if (fp) {
+        printf("    Writing to hello.txt file\r\n");
+        fprintf(fp,"Hello world!\r\n");
+        fclose (fp);
+        printf("    Closed file.\r\n");
+        fp = fopen("/fs/hello.txt", "r");
+        if (fp) {
+            printf("    Reading file back.\r\n");
+            if (fgets(buffer, sizeof(buffer), fp)) {
+                if (strlen(buffer) > 2)
+                    buffer[strlen(buffer)-2] = '\0';    // chomp the <LF>
+                printf("    Read: {%s}\r\n", buffer);
+            }
+            fclose(fp);
+        }
+    }
+}
+
+/// CAN_Tests will send some packets on one CAN port and expect them on the other
+///
+/// It will attempt to send 10 messages on one port and expect that
+/// all 10 messages were received on the other port. The two ports should
+/// be wired from one to the other with a loop-back cable and a termination
+/// resistor.
+///
+void CAN_Tests(void) {
+    CAN can1(p9, p10);
+    CAN can2(p30, p29);
+    char Txcounter = 0;
+    char Rxcounter = 0;
+    CANMessage msg;
+    int i;
+
+    printf("CAN Tests:\r\n");
+    for (i=0; i<10; i++) {
+        if (can1.write(CANMessage(1337, &Txcounter, 1))) {
+            Txcounter++;
+            printf("    Message sent: %d\r\n", Txcounter);
+            wait(0.05);
+        }
+        if (can2.read(msg)) {
+            printf("    Message received: %d\r\n", msg.data[0]);
+            Rxcounter++;
+        }
+        wait(0.2);
+    }
+    if (Txcounter == Rxcounter)
+        printf("    passed.\r\n");
+    else
+        printf("    **** Txcounter (%d) != Rxcounter (%d) ****\r\n", Txcounter, Rxcounter);
+}
+
+/// RS_232_Tests will say hello on each of the RS-232 channels
+///
+/// It will print a hello text string out each of the ports.
+///
+void RS_232_Tests(void) {
+    Serial s1(p13, p14);
+    Serial s2(p28, p27);
+
+    pc.printf("RS-232 Tests:\r\n");
+    s1.printf("    Hello going out S1\r\n");
+    s2.printf("    Hello going out S2\r\n");
+    pc.printf("    end tests.\r\n");
+}
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mbed.bld	Sun Jan 16 18:30:14 2011 +0000
@@ -0,0 +1,1 @@
+http://mbed.org/users/mbed_official/code/mbed/builds/e2ac27c8e93e