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/ek-lm4f232/usb_dev_bulk/usb_dev_bulk.c | |
| parent | 990090a4cc9070837d31e66b58d40f0c3d038741 (diff) | |
Add more board models
Diffstat (limited to 'boards/ek-lm4f232/usb_dev_bulk/usb_dev_bulk.c')
| -rw-r--r-- | boards/ek-lm4f232/usb_dev_bulk/usb_dev_bulk.c | 709 |
1 files changed, 709 insertions, 0 deletions
diff --git a/boards/ek-lm4f232/usb_dev_bulk/usb_dev_bulk.c b/boards/ek-lm4f232/usb_dev_bulk/usb_dev_bulk.c new file mode 100644 index 0000000..93f32f3 --- /dev/null +++ b/boards/ek-lm4f232/usb_dev_bulk/usb_dev_bulk.c @@ -0,0 +1,709 @@ +//*****************************************************************************
+//
+// usb_dev_bulk.c - Main routines for the generic bulk device example.
+//
+// Copyright (c) 2011-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 EK-LM4F232 Firmware Package.
+//
+//*****************************************************************************
+
+#include <stdbool.h>
+#include <stdint.h>
+#include "inc/hw_gpio.h"
+#include "inc/hw_ints.h"
+#include "inc/hw_memmap.h"
+#include "inc/hw_types.h"
+#include "inc/hw_sysctl.h"
+#include "driverlib/debug.h"
+#include "driverlib/fpu.h"
+#include "driverlib/gpio.h"
+#include "driverlib/interrupt.h"
+#include "driverlib/pin_map.h"
+#include "driverlib/sysctl.h"
+#include "driverlib/systick.h"
+#include "driverlib/timer.h"
+#include "driverlib/uart.h"
+#include "driverlib/rom.h"
+#include "grlib/grlib.h"
+#include "usblib/usblib.h"
+#include "usblib/usb-ids.h"
+#include "usblib/device/usbdevice.h"
+#include "usblib/device/usbdbulk.h"
+#include "utils/uartstdio.h"
+#include "utils/ustdlib.h"
+#include "drivers/cfal96x64x16.h"
+#include "usb_bulk_structs.h"
+
+//*****************************************************************************
+//
+//! \addtogroup example_list
+//! <h1>USB Generic Bulk Device (usb_dev_bulk)</h1>
+//!
+//! This example provides a generic USB device offering simple bulk data
+//! transfer to and from the host. The device uses a vendor-specific class ID
+//! and supports a single bulk IN endpoint and a single bulk OUT endpoint.
+//! Data received from the host is assumed to be ASCII text and it is
+//! echoed back with the case of all alphabetic characters swapped.
+//!
+//! A Windows INF file for the device is provided on the installation CD and
+//! in the C:/ti/TivaWare_C_Series-x.x/windows_drivers directory of TivaWare
+//! releases. This INF contains information required to install the WinUSB
+//! subsystem on WindowsXP and Vista PCs. WinUSB is a Windows subsystem
+//! allowing user mode applications to access the USB device without the need
+//! for a vendor-specific kernel mode driver.
+//!
+//! A sample Windows command-line application, usb_bulk_example, illustrating
+//! how to connect to and communicate with the bulk device is also provided.
+//! The application binary is installed as part of the ``TivaWare for C Series
+//! PC Companion Utilities'' package (SW-TM4C-USB-WIN) on the installation CD
+//! or via download from http://www.ti.com/tivaware . Project files are
+//! included to allow the examples to be built using
+//! Microsoft Visual Studio 2008. Source code for this application can be
+//! found in directory ti/TivaWare_C_Series-x.x/tools/usb_bulk_example.
+//
+//*****************************************************************************
+
+//*****************************************************************************
+//
+// The system tick rate expressed both as ticks per second and a millisecond
+// period.
+//
+//*****************************************************************************
+#define SYSTICKS_PER_SECOND 100
+#define SYSTICK_PERIOD_MS (1000 / SYSTICKS_PER_SECOND)
+
+//*****************************************************************************
+//
+// The global system tick counter.
+//
+//*****************************************************************************
+volatile uint32_t g_ui32SysTickCount = 0;
+
+//*****************************************************************************
+//
+// Variables tracking transmit and receive counts.
+//
+//*****************************************************************************
+volatile uint32_t g_ui32TxCount = 0;
+volatile uint32_t g_ui32RxCount = 0;
+#ifdef DEBUG
+uint32_t g_ui32UARTRxErrors = 0;
+#endif
+
+//*****************************************************************************
+//
+// Debug-related definitions and declarations.
+//
+// Debug output is available via UART0 if DEBUG is defined during build.
+//
+//*****************************************************************************
+#ifdef DEBUG
+//*****************************************************************************
+//
+// Map all debug print calls to UARTprintf in debug builds.
+//
+//*****************************************************************************
+#define DEBUG_PRINT UARTprintf
+
+#else
+
+//*****************************************************************************
+//
+// Compile out all debug print calls in release builds.
+//
+//*****************************************************************************
+#define DEBUG_PRINT while(0) ((int32_t (*)(char *, ...))0)
+#endif
+
+//*****************************************************************************
+//
+// Graphics context used to show text on the color LCD display.
+//
+//*****************************************************************************
+tContext g_sContext;
+
+//*****************************************************************************
+//
+// Flags used to pass commands from interrupt context to the main loop.
+//
+//*****************************************************************************
+#define COMMAND_PACKET_RECEIVED 0x00000001
+#define COMMAND_STATUS_UPDATE 0x00000002
+
+volatile uint32_t g_ui32Flags = 0;
+char *g_pcStatus;
+
+//*****************************************************************************
+//
+// Global flag indicating that a USB configuration has been set.
+//
+//*****************************************************************************
+static volatile bool g_bUSBConfigured = false;
+
+//*****************************************************************************
+//
+// The error routine that is called if the driver library encounters an error.
+//
+//*****************************************************************************
+#ifdef DEBUG
+void
+__error__(char *pcFilename, uint32_t ui32Line)
+{
+ UARTprintf("Error at line %d of %s\n", ui32Line, pcFilename);
+ while(1)
+ {
+ }
+}
+#endif
+
+//*****************************************************************************
+//
+// Interrupt handler for the system tick counter.
+//
+//*****************************************************************************
+void
+SysTickIntHandler(void)
+{
+ //
+ // Update our system tick counter.
+ //
+ g_ui32SysTickCount++;
+}
+
+//*****************************************************************************
+//
+// Receive new data and echo it back to the host.
+//
+// \param psDevice points to the instance data for the device whose data is to
+// be processed.
+// \param pi8Data points to the newly received data in the USB receive buffer.
+// \param ui32NumBytes is the number of bytes of data available to be processed.
+//
+// This function is called whenever we receive a notification that data is
+// available from the host. We read the data, byte-by-byte and swap the case
+// of any alphabetical characters found then write it back out to be
+// transmitted back to the host.
+//
+// \return Returns the number of bytes of data processed.
+//
+//*****************************************************************************
+static uint32_t
+EchoNewDataToHost(tUSBDBulkDevice *psDevice, uint8_t *pi8Data,
+ uint_fast32_t ui32NumBytes)
+{
+ uint_fast32_t ui32Loop, ui32Space, ui32Count;
+ uint_fast32_t ui32ReadIndex;
+ uint_fast32_t ui32WriteIndex;
+ tUSBRingBufObject sTxRing;
+
+ //
+ // Get the current buffer information to allow us to write directly to
+ // the transmit buffer (we already have enough information from the
+ // parameters to access the receive buffer directly).
+ //
+ USBBufferInfoGet(&g_sTxBuffer, &sTxRing);
+
+ //
+ // How much space is there in the transmit buffer?
+ //
+ ui32Space = USBBufferSpaceAvailable(&g_sTxBuffer);
+
+ //
+ // How many characters can we process this time round?
+ //
+ ui32Loop = (ui32Space < ui32NumBytes) ? ui32Space : ui32NumBytes;
+ ui32Count = ui32Loop;
+
+ //
+ // Update our receive counter.
+ //
+ g_ui32RxCount += ui32NumBytes;
+
+ //
+ // Dump a debug message.
+ //
+ DEBUG_PRINT("Received %d bytes\n", ui32NumBytes);
+
+ //
+ // Set up to process the characters by directly accessing the USB buffers.
+ //
+ ui32ReadIndex = (uint32_t)(pi8Data - g_pui8USBRxBuffer);
+ ui32WriteIndex = sTxRing.ui32WriteIndex;
+
+ while(ui32Loop)
+ {
+ //
+ // Copy from the receive buffer to the transmit buffer converting
+ // character case on the way.
+ //
+
+ //
+ // Is this a lower case character?
+ //
+ if((g_pui8USBRxBuffer[ui32ReadIndex] >= 'a') &&
+ (g_pui8USBRxBuffer[ui32ReadIndex] <= 'z'))
+ {
+ //
+ // Convert to upper case and write to the transmit buffer.
+ //
+ g_pui8USBTxBuffer[ui32WriteIndex] =
+ (g_pui8USBRxBuffer[ui32ReadIndex] - 'a') + 'A';
+ }
+ else
+ {
+ //
+ // Is this an upper case character?
+ //
+ if((g_pui8USBRxBuffer[ui32ReadIndex] >= 'A') &&
+ (g_pui8USBRxBuffer[ui32ReadIndex] <= 'Z'))
+ {
+ //
+ // Convert to lower case and write to the transmit buffer.
+ //
+ g_pui8USBTxBuffer[ui32WriteIndex] =
+ (g_pui8USBRxBuffer[ui32ReadIndex] - 'Z') + 'z';
+ }
+ else
+ {
+ //
+ // Copy the received character to the transmit buffer.
+ //
+ g_pui8USBTxBuffer[ui32WriteIndex] =
+ g_pui8USBRxBuffer[ui32ReadIndex];
+ }
+ }
+
+ //
+ // Move to the next character taking care to adjust the pointer for
+ // the buffer wrap if necessary.
+ //
+ ui32WriteIndex++;
+ ui32WriteIndex =
+ (ui32WriteIndex == BULK_BUFFER_SIZE) ? 0 : ui32WriteIndex;
+
+ ui32ReadIndex++;
+ ui32ReadIndex = (ui32ReadIndex == BULK_BUFFER_SIZE) ? 0 : ui32ReadIndex;
+
+ ui32Loop--;
+ }
+
+ //
+ // We've processed the data in place so now send the processed data
+ // back to the host.
+ //
+ USBBufferDataWritten(&g_sTxBuffer, ui32Count);
+
+ DEBUG_PRINT("Wrote %d bytes\n", ui32Count);
+
+ //
+ // We processed as much data as we can directly from the receive buffer so
+ // we need to return the number of bytes to allow the lower layer to
+ // update its read pointer appropriately.
+ //
+ return(ui32Count);
+}
+
+//*****************************************************************************
+//
+// Shows the status string on the display.
+//
+// \param psContext is a pointer to the graphics context representing the
+// display.
+// \param pi8Status is a pointer to the string to be shown.
+//
+//*****************************************************************************
+void
+DisplayStatus(tContext *psContext, char *pcStatus)
+{
+ //
+ // Clear the line with black.
+ //
+ GrContextForegroundSet(&g_sContext, ClrBlack);
+ GrStringDrawCentered(psContext, " ", -1,
+ GrContextDpyWidthGet(psContext) / 2, 16, true);
+
+ //
+ // Draw the new status string
+ //
+ DEBUG_PRINT("%s\n", pcStatus);
+ GrContextForegroundSet(&g_sContext, ClrWhite);
+ GrStringDrawCentered(psContext, pcStatus, -1,
+ GrContextDpyWidthGet(psContext) / 2, 16, true);
+}
+
+//*****************************************************************************
+//
+// 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, uint32_t ui32Event, uint32_t ui32MsgValue,
+ void *pvMsgData)
+{
+ //
+ // We are not required to do anything in response to any transmit event
+ // in this example. All we do is update our transmit counter.
+ //
+ if(ui32Event == USB_EVENT_TX_COMPLETE)
+ {
+ g_ui32TxCount += ui32MsgValue;
+ }
+
+ //
+ // Dump a debug message.
+ //
+ DEBUG_PRINT("TX complete %d\n", ui32MsgValue);
+
+ return(0);
+}
+
+//*****************************************************************************
+//
+// 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, uint32_t ui32Event, uint32_t ui32MsgValue,
+ void *pvMsgData)
+{
+ //
+ // Which event are we being sent?
+ //
+ switch(ui32Event)
+ {
+ //
+ // We are connected to a host and communication is now possible.
+ //
+ case USB_EVENT_CONNECTED:
+ {
+ g_bUSBConfigured = true;
+ g_pcStatus = "Host connected.";
+ g_ui32Flags |= COMMAND_STATUS_UPDATE;
+
+ //
+ // Flush our buffers.
+ //
+ USBBufferFlush(&g_sTxBuffer);
+ USBBufferFlush(&g_sRxBuffer);
+
+ break;
+ }
+
+ //
+ // The host has disconnected.
+ //
+ case USB_EVENT_DISCONNECTED:
+ {
+ g_bUSBConfigured = false;
+ g_pcStatus = "Host disconn.";
+ g_ui32Flags |= COMMAND_STATUS_UPDATE;
+ break;
+ }
+
+ //
+ // A new packet has been received.
+ //
+ case USB_EVENT_RX_AVAILABLE:
+ {
+ tUSBDBulkDevice *psDevice;
+
+ //
+ // Get a pointer to our instance data from the callback data
+ // parameter.
+ //
+ psDevice = (tUSBDBulkDevice *)pvCBData;
+
+ //
+ // Read the new packet and echo it back to the host.
+ //
+ return(EchoNewDataToHost(psDevice, pvMsgData, ui32MsgValue));
+ }
+
+ //
+ // Ignore SUSPEND and RESUME for now.
+ //
+ case USB_EVENT_SUSPEND:
+ case USB_EVENT_RESUME:
+ break;
+
+ //
+ // Ignore all other events and return 0.
+ //
+ default:
+ break;
+ }
+
+ return(0);
+}
+
+#ifdef DEBUG
+//*****************************************************************************
+//
+// Configure the UART and its pins. This must be called before UARTprintf().
+//
+//*****************************************************************************
+void
+ConfigureUART(void)
+{
+ //
+ // Enable the GPIO Peripheral used by the UART.
+ //
+ ROM_SysCtlPeripheralEnable(SYSCTL_PERIPH_GPIOA);
+
+ //
+ // Enable UART0
+ //
+ ROM_SysCtlPeripheralEnable(SYSCTL_PERIPH_UART0);
+
+ //
+ // Configure GPIO Pins for UART mode.
+ //
+ ROM_GPIOPinConfigure(GPIO_PA0_U0RX);
+ ROM_GPIOPinConfigure(GPIO_PA1_U0TX);
+ ROM_GPIOPinTypeUART(GPIO_PORTA_BASE, GPIO_PIN_0 | GPIO_PIN_1);
+
+ //
+ // Use the internal 16MHz oscillator as the UART clock source.
+ //
+ UARTClockSourceSet(UART0_BASE, UART_CLOCK_PIOSC);
+
+ //
+ // Initialize the UART for console I/O.
+ //
+ UARTStdioConfig(0, 115200, 16000000);
+ //
+ UARTStdioConfig(0, 115200, 16000000);
+}
+#endif
+
+//*****************************************************************************
+//
+// This is the main application entry function.
+//
+//*****************************************************************************
+int
+main(void)
+{
+ uint_fast32_t ui32TxCount;
+ uint_fast32_t ui32RxCount;
+ tRectangle sRect;
+ char pcBuffer[16];
+
+ //
+ // Enable lazy stacking for interrupt handlers. This allows floating-point
+ // instructions to be used within interrupt handlers, but at the expense of
+ // extra stack usage.
+ //
+ ROM_FPULazyStackingEnable();
+
+ //
+ // Set the clocking to run from the PLL at 50MHz
+ //
+ ROM_SysCtlClockSet(SYSCTL_SYSDIV_4 | SYSCTL_USE_PLL | SYSCTL_OSC_MAIN |
+ SYSCTL_XTAL_16MHZ);
+
+#ifdef DEBUG
+ //
+ // Configure the UART for debug output.
+ //
+ ConfigureUART();
+#endif
+
+ //
+ // Not configured initially.
+ //
+ g_bUSBConfigured = false;
+
+ //
+ // Initialize the display driver.
+ //
+ CFAL96x64x16Init();
+
+ //
+ // Initialize the graphics context.
+ //
+ GrContextInit(&g_sContext, &g_sCFAL96x64x16);
+
+ //
+ // Fill the top part of the screen with blue to create the banner.
+ //
+ sRect.i16XMin = 0;
+ sRect.i16YMin = 0;
+ sRect.i16XMax = GrContextDpyWidthGet(&g_sContext) - 1;
+ sRect.i16YMax = 9;
+ GrContextForegroundSet(&g_sContext, ClrDarkBlue);
+ GrRectFill(&g_sContext, &sRect);
+
+ //
+ // Change foreground for white text.
+ //
+ GrContextForegroundSet(&g_sContext, ClrWhite);
+
+ //
+ // Put the application name in the middle of the banner.
+ //
+ GrContextFontSet(&g_sContext, g_psFontFixed6x8);
+ GrStringDrawCentered(&g_sContext, "usb-dev-bulk", -1,
+ GrContextDpyWidthGet(&g_sContext) / 2, 4, 0);
+
+ //
+ // Show the various static text elements on the color STN display.
+ //
+ GrStringDraw(&g_sContext, "Tx bytes:", -1, 0, 32, false);
+ GrStringDraw(&g_sContext, "Rx bytes:", -1, 0, 42, false);
+
+ //
+ // Enable the GPIO peripheral used for USB, and configure the USB
+ // pins.
+ //
+ ROM_SysCtlPeripheralEnable(SYSCTL_PERIPH_GPIOB);
+ ROM_SysCtlPeripheralEnable(SYSCTL_PERIPH_GPIOL);
+ ROM_GPIOPinTypeUSBAnalog(GPIO_PORTB_BASE, GPIO_PIN_0 | GPIO_PIN_1);
+ ROM_GPIOPinTypeUSBAnalog(GPIO_PORTL_BASE, GPIO_PIN_6 | GPIO_PIN_7);
+
+ //
+ // Erratum workaround for silicon revision A1. VBUS must have pull-down.
+ //
+ if(CLASS_IS_TM4C123 && REVISION_IS_A1)
+ {
+ HWREG(GPIO_PORTB_BASE + GPIO_O_PDR) |= GPIO_PIN_1;
+ }
+
+ //
+ // Enable the system tick.
+ //
+ ROM_SysTickPeriodSet(ROM_SysCtlClockGet() / SYSTICKS_PER_SECOND);
+ ROM_SysTickIntEnable();
+ ROM_SysTickEnable();
+
+ //
+ // Show the application name on the display and UART output.
+ //
+ DEBUG_PRINT("\nTiva C Series USB bulk device example\n");
+ DEBUG_PRINT("---------------------------------\n\n");
+
+ //
+ // Tell the user what we are up to.
+ //
+ DisplayStatus(&g_sContext, "Configuring USB");
+
+ //
+ // Initialize the transmit and receive buffers.
+ //
+ USBBufferInit(&g_sTxBuffer);
+ USBBufferInit(&g_sRxBuffer);
+
+ //
+ // Initialize the USB stack for device mode.
+ //
+ USBStackModeSet(0, eUSBModeDevice, 0);
+
+ //
+ // Pass our device information to the USB library and place the device
+ // on the bus.
+ //
+ USBDBulkInit(0, &g_sBulkDevice);
+
+ //
+ // Wait for initial configuration to complete.
+ //
+ DisplayStatus(&g_sContext, "Waiting for host");
+
+ //
+ // Clear our local byte counters.
+ //
+ ui32RxCount = 0;
+ ui32TxCount = 0;
+
+ //
+ // Main application loop.
+ //
+ while(1)
+ {
+
+ //
+ // Have we been asked to update the status display?
+ //
+ if(g_ui32Flags & COMMAND_STATUS_UPDATE)
+ {
+ //
+ // Clear the command flag
+ //
+ g_ui32Flags &= ~COMMAND_STATUS_UPDATE;
+ DisplayStatus(&g_sContext, g_pcStatus);
+ }
+
+ //
+ // Has there been any transmit traffic since we last checked?
+ //
+ if(ui32TxCount != g_ui32TxCount)
+ {
+ //
+ // Take a snapshot of the latest transmit count.
+ //
+ ui32TxCount = g_ui32TxCount;
+
+ //
+ // Update the display of bytes transmitted by the UART.
+ //
+ usnprintf(pcBuffer, 16, " %d ", ui32TxCount);
+ GrStringDraw(&g_sContext, pcBuffer, -1, 48, 32, true);
+ }
+
+ //
+ // Has there been any receive traffic since we last checked?
+ //
+ if(ui32RxCount != g_ui32RxCount)
+ {
+ //
+ // Take a snapshot of the latest receive count.
+ //
+ ui32RxCount = g_ui32RxCount;
+
+ //
+ // Update the display of bytes received by the UART.
+ //
+ usnprintf(pcBuffer, 16, " %d ", ui32RxCount);
+ GrStringDraw(&g_sContext, pcBuffer, -1, 48, 42, true);
+ }
+ }
+}
|
