diff options
| author | Yuval Adam <yuv.adm@gmail.com> | 2014-06-29 12:34:32 +0300 |
|---|---|---|
| committer | Yuval Adam <yuv.adm@gmail.com> | 2014-06-29 12:34:32 +0300 |
| commit | c3e4c9a25c2910d2d66d52215b3406b13d5b23d5 (patch) | |
| tree | added370d1e356901f8579f076e3263fb0464db7 /boards/dk-tm4c123g/usb_dev_msc/usb_dev_msc.c | |
| parent | 990090a4cc9070837d31e66b58d40f0c3d038741 (diff) | |
Add more board models
Diffstat (limited to 'boards/dk-tm4c123g/usb_dev_msc/usb_dev_msc.c')
| -rw-r--r-- | boards/dk-tm4c123g/usb_dev_msc/usb_dev_msc.c | 617 |
1 files changed, 617 insertions, 0 deletions
diff --git a/boards/dk-tm4c123g/usb_dev_msc/usb_dev_msc.c b/boards/dk-tm4c123g/usb_dev_msc/usb_dev_msc.c new file mode 100644 index 0000000..e9e4f3f --- /dev/null +++ b/boards/dk-tm4c123g/usb_dev_msc/usb_dev_msc.c @@ -0,0 +1,617 @@ +//*****************************************************************************
+//
+// usb_dev_msc.c - Main routines for the device mass storage class example.
+//
+// Copyright (c) 2012-2014 Texas Instruments Incorporated. All rights reserved.
+// Software License Agreement
+//
+// Texas Instruments (TI) is supplying this software for use solely and
+// exclusively on TI's microcontroller products. The software is owned by
+// TI and/or its suppliers, and is protected under applicable copyright
+// laws. You may not combine this software with "viral" open-source
+// software in order to form a larger program.
+//
+// THIS SOFTWARE IS PROVIDED "AS IS" AND WITH ALL FAULTS.
+// NO WARRANTIES, WHETHER EXPRESS, IMPLIED OR STATUTORY, INCLUDING, BUT
+// NOT LIMITED TO, IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+// A PARTICULAR PURPOSE APPLY TO THIS SOFTWARE. TI SHALL NOT, UNDER ANY
+// CIRCUMSTANCES, BE LIABLE FOR SPECIAL, INCIDENTAL, OR CONSEQUENTIAL
+// DAMAGES, FOR ANY REASON WHATSOEVER.
+//
+// This is part of revision 2.1.0.12573 of the DK-TM4C123G Firmware Package.
+//
+//*****************************************************************************
+
+#include <stdbool.h>
+#include <stdint.h>
+#include "inc/hw_ints.h"
+#include "inc/hw_memmap.h"
+#include "inc/hw_types.h"
+#include "driverlib/debug.h"
+#include "driverlib/sysctl.h"
+#include "driverlib/rom.h"
+#include "driverlib/systick.h"
+#include "driverlib/usb.h"
+#include "driverlib/gpio.h"
+#include "driverlib/udma.h"
+#include "driverlib/pin_map.h"
+#include "grlib/grlib.h"
+#include "usblib/usblib.h"
+#include "usblib/usb-ids.h"
+#include "usblib/device/usbdevice.h"
+#include "usblib/device/usbdmsc.h"
+#include "drivers/cfal96x64x16.h"
+#include "usb_msc_structs.h"
+#include "third_party/fatfs/src/diskio.h"
+
+//*****************************************************************************
+//
+//! \addtogroup example_list
+//! <h1>USB MSC Device (usb_dev_msc)</h1>
+//!
+//! This example application turns the evaluation board into a USB mass storage
+//! class device. The application will use the microSD card for the storage
+//! media for the mass storage device. The screen will display the current
+//! action occurring on the device ranging from disconnected, no media, reading,
+//! writing and idle.
+//
+//*****************************************************************************
+
+//*****************************************************************************
+//
+// These defines are used to define the screen constraints to the application.
+//
+//*****************************************************************************
+#define DISPLAY_BANNER_HEIGHT 11
+#define DISPLAY_BANNER_BG ClrDarkBlue
+#define DISPLAY_BANNER_FG ClrWhite
+
+//*****************************************************************************
+//
+// The number of ticks to wait before falling back to the idle state. Since
+// the tick rate is 100Hz this is approximately 3 seconds.
+//
+//*****************************************************************************
+#define USBMSC_ACTIVITY_TIMEOUT 300
+
+//*****************************************************************************
+//
+// This enumeration holds the various states that the device can be in during
+// normal operation.
+//
+//*****************************************************************************
+volatile enum
+{
+ //
+ // Unconfigured.
+ //
+ MSC_DEV_DISCONNECTED,
+
+ //
+ // Connected but not yet fully enumerated.
+ //
+ MSC_DEV_CONNECTED,
+
+ //
+ // Connected and fully enumerated but not currently handling a command.
+ //
+ MSC_DEV_IDLE,
+
+ //
+ // Currently reading the SD card.
+ //
+ MSC_DEV_READ,
+
+ //
+ // Currently writing the SD card.
+ //
+ MSC_DEV_WRITE,
+}
+g_eMSCState;
+
+//*****************************************************************************
+//
+// The Flags that handle updates to the status area to avoid drawing when no
+// updates are required..
+//
+//*****************************************************************************
+#define FLAG_UPDATE_STATUS 1
+static uint32_t g_ui32Flags;
+static uint32_t g_ui32IdleTimeout;
+
+//*****************************************************************************
+//
+// Graphics context used to show text on the display.
+//
+//*****************************************************************************
+tContext g_sContext;
+
+//******************************************************************************
+//
+// The DMA control structure table.
+//
+//******************************************************************************
+#ifdef ewarm
+#pragma data_alignment=1024
+tDMAControlTable sDMAControlTable[64];
+#elif defined(ccs)
+#pragma DATA_ALIGN(sDMAControlTable, 1024)
+tDMAControlTable sDMAControlTable[64];
+#else
+tDMAControlTable sDMAControlTable[64] __attribute__ ((aligned(1024)));
+#endif
+
+//*****************************************************************************
+//
+// Handles bulk driver notifications related to the receive channel (data from
+// the USB host).
+//
+// \param pvCBData is the client-supplied callback pointer for this channel.
+// \param ui32Event identifies the event we are being notified about.
+// \param ui32MsgValue is an event-specific value.
+// \param pvMsgData is an event-specific pointer.
+//
+// This function is called by the bulk driver to notify us of any events
+// related to operation of the receive data channel (the OUT channel carrying
+// data from the USB host).
+//
+// \return The return value is event-specific.
+//
+//*****************************************************************************
+uint32_t
+RxHandler(void *pvCBData, uint_fast32_t ui32Event,
+ uint_fast32_t ui32MsgValue, void *pvMsgData)
+{
+ return(0);
+}
+
+//*****************************************************************************
+//
+// Handles bulk driver notifications related to the transmit channel (data to
+// the USB host).
+//
+// \param pvCBData is the client-supplied callback pointer for this channel.
+// \param ui32Event identifies the event we are being notified about.
+// \param ui32MsgValue is an event-specific value.
+// \param pvMsgData is an event-specific pointer.
+//
+// This function is called by the bulk driver to notify us of any events
+// related to operation of the transmit data channel (the IN channel carrying
+// data to the USB host).
+//
+// \return The return value is event-specific.
+//
+//*****************************************************************************
+uint32_t
+TxHandler(void *pvCBData, uint_fast32_t ui32Event, uint_fast32_t ui32MsgValue,
+ void *pvMsgData)
+{
+ return(0);
+}
+
+//*****************************************************************************
+//
+// This function updates the status area of the screen. It uses the current
+// state of the application to print the status bar.
+//
+//*****************************************************************************
+void
+UpdateStatus(char *pcString, bool bClrBackground)
+{
+ tRectangle sRect;
+
+ //
+ //
+ //
+ GrContextBackgroundSet(&g_sContext, DISPLAY_BANNER_BG);
+
+ if(bClrBackground)
+ {
+ //
+ // Fill the bottom rows of the screen with blue to create the status area.
+ //
+ sRect.i16XMin = 0;
+ sRect.i16YMin = GrContextDpyHeightGet(&g_sContext) -
+ DISPLAY_BANNER_HEIGHT;
+ sRect.i16XMax = GrContextDpyWidthGet(&g_sContext) - 1;
+ sRect.i16YMax = sRect.i16YMin + DISPLAY_BANNER_HEIGHT - 1;
+
+ //
+ // Draw the background of the banner.
+ //
+ GrContextForegroundSet(&g_sContext, DISPLAY_BANNER_BG);
+ GrRectFill(&g_sContext, &sRect);
+
+ //
+ // Put a white box around the banner.
+ //
+ GrContextForegroundSet(&g_sContext, DISPLAY_BANNER_FG);
+ GrRectDraw(&g_sContext, &sRect);
+ }
+ else
+ {
+ //
+ // Fill the bottom rows of the screen with blue to create the status area.
+ //
+ sRect.i16XMin = 1;
+ sRect.i16YMin = GrContextDpyHeightGet(&g_sContext) -
+ DISPLAY_BANNER_HEIGHT + 1;
+ sRect.i16XMax = GrContextDpyWidthGet(&g_sContext) - 2;
+ sRect.i16YMax = sRect.i16YMin + DISPLAY_BANNER_HEIGHT - 3;
+
+ //
+ // Draw the background of the banner.
+ //
+ GrContextForegroundSet(&g_sContext, DISPLAY_BANNER_BG);
+ GrRectFill(&g_sContext, &sRect);
+
+ //
+ // White text in the banner.
+ //
+ GrContextForegroundSet(&g_sContext, DISPLAY_BANNER_FG);
+ }
+
+ //
+ // Write the current state to the left of the status area.
+ //
+ GrContextFontSet(&g_sContext, g_psFontFixed6x8);
+
+ //
+ // Update the status on the screen.
+ //
+ if(pcString != 0)
+ {
+ GrStringDrawCentered(&g_sContext, pcString,
+ -1, GrContextDpyWidthGet(&g_sContext) / 2,
+ 58, 1);
+ }
+}
+
+//*****************************************************************************
+//
+// This function is the call back notification function provided to the USB
+// library's mass storage class.
+//
+//*****************************************************************************
+uint32_t
+USBDMSCEventCallback(void *pvCBData, uint32_t ui32Event, uint32_t ui32MsgParam,
+ void *pvMsgData)
+{
+ //
+ // Reset the time out every time an event occurs.
+ //
+ g_ui32IdleTimeout = USBMSC_ACTIVITY_TIMEOUT;
+
+ switch(ui32Event)
+ {
+ //
+ // Writing to the device.
+ //
+ case USBD_MSC_EVENT_WRITING:
+ {
+ //
+ // Only update if this is a change.
+ //
+ if(g_eMSCState != MSC_DEV_WRITE)
+ {
+ //
+ // Go to the write state.
+ //
+ g_eMSCState = MSC_DEV_WRITE;
+
+ //
+ // Cause the main loop to update the screen.
+ //
+ g_ui32Flags |= FLAG_UPDATE_STATUS;
+ }
+
+ break;
+ }
+
+ //
+ // Reading from the device.
+ //
+ case USBD_MSC_EVENT_READING:
+ {
+ //
+ // Only update if this is a change.
+ //
+ if(g_eMSCState != MSC_DEV_READ)
+ {
+ //
+ // Go to the read state.
+ //
+ g_eMSCState = MSC_DEV_READ;
+
+ //
+ // Cause the main loop to update the screen.
+ //
+ g_ui32Flags |= FLAG_UPDATE_STATUS;
+ }
+
+ break;
+ }
+ //
+ // The USB host has disconnected from the device.
+ //
+ case USB_EVENT_DISCONNECTED:
+ {
+ //
+ // Go to the disconnected state.
+ //
+ g_eMSCState = MSC_DEV_DISCONNECTED;
+
+ //
+ // Cause the main loop to update the screen.
+ //
+ g_ui32Flags |= FLAG_UPDATE_STATUS;
+
+ break;
+ }
+ //
+ // The USB host has connected to the device.
+ //
+ case USB_EVENT_CONNECTED:
+ {
+ //
+ // Go to the idle state to wait for read/writes.
+ //
+ g_eMSCState = MSC_DEV_IDLE;
+
+ break;
+ }
+ case USBD_MSC_EVENT_IDLE:
+ default:
+ {
+ break;
+ }
+ }
+
+ return(0);
+}
+
+//*****************************************************************************
+//
+// This is the handler for this SysTick interrupt. FatFs requires a timer tick
+// every 10 ms for internal timing purposes.
+//
+//*****************************************************************************
+void
+SysTickHandler(void)
+{
+ //
+ // Call the FatFs tick timer.
+ //
+ disk_timerproc();
+
+ if(g_ui32IdleTimeout != 0)
+ {
+ g_ui32IdleTimeout--;
+ }
+}
+
+//*****************************************************************************
+//
+// This is the main loop that runs the application.
+//
+//*****************************************************************************
+int
+main(void)
+{
+ tRectangle sRect;
+ uint_fast32_t ui32Retcode;
+
+ //
+ // Set the system clock to run at 50MHz from the PLL.
+ //
+ ROM_SysCtlClockSet(SYSCTL_SYSDIV_4 | SYSCTL_USE_PLL | SYSCTL_OSC_MAIN |
+ SYSCTL_XTAL_16MHZ);
+
+ //
+ // Configure SysTick for a 100Hz interrupt. The FatFs driver wants a 10 ms
+ // tick.
+ //
+ ROM_SysTickPeriodSet(ROM_SysCtlClockGet() / 100);
+ ROM_SysTickEnable();
+ ROM_SysTickIntEnable();
+
+ //
+ // Configure and enable uDMA
+ //
+ ROM_SysCtlPeripheralEnable(SYSCTL_PERIPH_UDMA);
+ SysCtlDelay(10);
+ ROM_uDMAControlBaseSet(&sDMAControlTable[0]);
+ ROM_uDMAEnable();
+
+ //
+ // Initialize the display driver.
+ //
+ CFAL96x64x16Init();
+
+ //
+ // Initialize the graphics context.
+ //
+ GrContextInit(&g_sContext, &g_sCFAL96x64x16);
+
+ //
+ // Fill the top 15 rows of the screen with blue to create the banner.
+ //
+ sRect.i16XMin = 0;
+ sRect.i16YMin = 0;
+ sRect.i16XMax = GrContextDpyWidthGet(&g_sContext) - 1;
+ sRect.i16YMax = DISPLAY_BANNER_HEIGHT - 1;
+ GrContextForegroundSet(&g_sContext, ClrDarkBlue);
+ GrRectFill(&g_sContext, &sRect);
+
+ //
+ // Put a white box around the banner.
+ //
+ GrContextForegroundSet(&g_sContext, ClrWhite);
+ GrRectDraw(&g_sContext, &sRect);
+
+ //
+ // Put the application name in the middle of the banner.
+ //
+ GrContextFontSet(&g_sContext, g_psFontFixed6x8);
+ GrStringDrawCentered(&g_sContext, "usb-dev-msc", -1,
+ GrContextDpyWidthGet(&g_sContext) / 2, 5, 0);
+
+ //
+ // Initialize the idle timeout and reset all flags.
+ //
+ g_ui32IdleTimeout = 0;
+ g_ui32Flags = 0;
+
+ //
+ // Initialize the state to idle.
+ //
+ g_eMSCState = MSC_DEV_DISCONNECTED;
+
+ //
+ // Draw the status bar and set it to idle.
+ //
+ UpdateStatus("Disconnected", 1);
+
+ //
+ // Enable the USB controller.
+ //
+ ROM_SysCtlPeripheralEnable(SYSCTL_PERIPH_USB0);
+
+ //
+ // Set the USB pins to be controlled by the USB controller.
+ //
+ ROM_SysCtlPeripheralEnable(SYSCTL_PERIPH_GPIOB);
+ ROM_SysCtlPeripheralEnable(SYSCTL_PERIPH_GPIOG);
+ ROM_GPIOPinConfigure(GPIO_PG4_USB0EPEN);
+ ROM_GPIOPinTypeUSBDigital(GPIO_PORTG_BASE, GPIO_PIN_4);
+ ROM_SysCtlPeripheralEnable(SYSCTL_PERIPH_GPIOL);
+ ROM_GPIOPinTypeUSBAnalog(GPIO_PORTL_BASE, GPIO_PIN_6 | GPIO_PIN_7);
+ ROM_GPIOPinTypeUSBAnalog(GPIO_PORTB_BASE, GPIO_PIN_0 | GPIO_PIN_1);
+
+ //
+ // Set the USB stack mode to Device mode with VBUS monitoring.
+ //
+ USBStackModeSet(0, eUSBModeDevice, 0);
+
+ //
+ // Pass our device information to the USB library and place the device
+ // on the bus.
+ //
+ USBDMSCInit(0, &g_sMSCDevice);
+
+ //
+ // Determine whether or not an SDCard is installed. If not, print a
+ // warning and have the user install one and restart.
+ //
+ ui32Retcode = disk_initialize(0);
+
+ GrContextFontSet(&g_sContext, g_psFontFixed6x8);
+ if(ui32Retcode != RES_OK)
+ {
+ GrStringDrawCentered(&g_sContext, "No SDCard Found", -1,
+ GrContextDpyWidthGet(&g_sContext) / 2, 16, 0);
+ GrStringDrawCentered(&g_sContext, "Please insert",
+ -1, GrContextDpyWidthGet(&g_sContext) / 2, 26, 0);
+ GrStringDrawCentered(&g_sContext, "a card and",
+ -1, GrContextDpyWidthGet(&g_sContext) / 2, 36, 0);
+ GrStringDrawCentered(&g_sContext, "reset the board.",
+ -1, GrContextDpyWidthGet(&g_sContext) / 2, 46, 0);
+ }
+ else
+ {
+ GrStringDrawCentered(&g_sContext, "SDCard Found", -1,
+ GrContextDpyWidthGet(&g_sContext) / 2, 30, 0);
+ }
+
+ //
+ // Drop into the main loop.
+ //
+ while(1)
+ {
+ switch(g_eMSCState)
+ {
+ case MSC_DEV_READ:
+ {
+ //
+ // Update the screen if necessary.
+ //
+ if(g_ui32Flags & FLAG_UPDATE_STATUS)
+ {
+ UpdateStatus("Reading", 0);
+ g_ui32Flags &= ~FLAG_UPDATE_STATUS;
+ }
+
+ //
+ // If there is no activity then return to the idle state.
+ //
+ if(g_ui32IdleTimeout == 0)
+ {
+ UpdateStatus("Idle", 0);
+ g_eMSCState = MSC_DEV_IDLE;
+ }
+
+ break;
+ }
+ case MSC_DEV_WRITE:
+ {
+ //
+ // Update the screen if necessary.
+ //
+ if(g_ui32Flags & FLAG_UPDATE_STATUS)
+ {
+ UpdateStatus("Writing", 0);
+ g_ui32Flags &= ~FLAG_UPDATE_STATUS;
+ }
+
+ //
+ // If there is no activity then return to the idle state.
+ //
+ if(g_ui32IdleTimeout == 0)
+ {
+ UpdateStatus("Idle", 0);
+ g_eMSCState = MSC_DEV_IDLE;
+ }
+ break;
+ }
+ case MSC_DEV_DISCONNECTED:
+ {
+ //
+ // Update the screen if necessary.
+ //
+ if(g_ui32Flags & FLAG_UPDATE_STATUS)
+ {
+ UpdateStatus("Disconnected", 0);
+ g_ui32Flags &= ~FLAG_UPDATE_STATUS;
+ }
+ break;
+ }
+ case MSC_DEV_IDLE:
+ {
+ break;
+ }
+ default:
+ {
+ break;
+ }
+ }
+ }
+}
+
+//*****************************************************************************
+//
+// The error routine that is called if the driver library encounters an error.
+//
+//*****************************************************************************
+#ifdef DEBUG
+void
+__error__(char *pcFilename, uint32_t ui32Line)
+{
+ while(1)
+ {
+ //
+ // Hang on runtime error.
+ //
+ }
+}
+#endif
+
|
