Simple USBHost library for Nucleo F446RE/F411RE/F401RE FRDM-KL46Z/KL25Z/F64F LPC4088/LPC1768

Dependencies:   FATFileSystem

Dependents:   F401RE-BTstack_example F401RE-USBHostMSD_HelloWorld

Fork of KL46Z-USBHost by Norimasa Okamoto

簡易USBホストライブラリです。
official-USBHostの下位互換で対応プログラムを僅かな修正で動かすことが出来ます。

Platforms

  • Nucleo F446RE
  • Nucleo F411RE
  • Nucleo F401RE
  • FRDM-K64F
  • FRDM-KL46Z
  • FRDM-KL25Z
  • LPC4088
  • LPC1768

Nucleo F446RE/F411RE/F401REのUSB接続方法

ST morphoUSB
U5V (CN10-8)VBUS (1 RED)
PA11 (CN10-14)DM  (2 WHITE)
PA12 (CN10-12)DP  (3 GREEN)
GND (CN10-20)GND (4 BLACK)

Examples

Import programF446RE-USBHostMouse_HelloWorld

USBHostMouse Hello World for ST-Nucleo-F446RE

Import programF401RE-USBHostMSD_HelloWorld

Simple USBHost MSD(USB flash drive) for Nucleo F401RE/FRDM-KL46Z test program

Import programF401RE-USBHostC270_example

Simple USBHost WebCam test program

Import programK64F_USBHostC270_example

Simple USBHost C270 example

Import programF401RE-BTstack_example

BTstack for Nucleo F401RE/FRDM-KL46Z example program

Import programUSBHostRSSI_example

Bluetooth device discovery example program.

Import programKL46Z-USBHostGPS_HelloWorld

Simple USBHost GPS Dongle Receiver for FRDM-KL46Z test program

Committer:
va009039
Date:
Mon Feb 03 13:00:16 2014 +0000
Revision:
9:7f9f64cf5ded
Parent:
8:6463cd1964c0
Child:
10:40c7f6788902
add interrupt write transfer.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
va009039 6:03ef38d6e1ba 1 /* mbed USBHost Library
va009039 6:03ef38d6e1ba 2 * Copyright (c) 2006-2013 ARM Limited
va009039 6:03ef38d6e1ba 3 *
va009039 6:03ef38d6e1ba 4 * Licensed under the Apache License, Version 2.0 (the "License");
va009039 6:03ef38d6e1ba 5 * you may not use this file except in compliance with the License.
va009039 6:03ef38d6e1ba 6 * You may obtain a copy of the License at
va009039 6:03ef38d6e1ba 7 *
va009039 6:03ef38d6e1ba 8 * http://www.apache.org/licenses/LICENSE-2.0
va009039 6:03ef38d6e1ba 9 *
va009039 6:03ef38d6e1ba 10 * Unless required by applicable law or agreed to in writing, software
va009039 6:03ef38d6e1ba 11 * distributed under the License is distributed on an "AS IS" BASIS,
va009039 6:03ef38d6e1ba 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
va009039 6:03ef38d6e1ba 13 * See the License for the specific language governing permissions and
va009039 6:03ef38d6e1ba 14 * limitations under the License.
va009039 6:03ef38d6e1ba 15 */
va009039 6:03ef38d6e1ba 16 #pragma once
va009039 6:03ef38d6e1ba 17
va009039 6:03ef38d6e1ba 18 #include "USBEndpoint.h"
va009039 6:03ef38d6e1ba 19 #include "USBHostConf.h"
va009039 9:7f9f64cf5ded 20 #include "myqueue.h"
va009039 9:7f9f64cf5ded 21 #include "mymap.h"
va009039 6:03ef38d6e1ba 22
va009039 8:6463cd1964c0 23 class USBEndpoint;
va009039 8:6463cd1964c0 24
va009039 9:7f9f64cf5ded 25 struct INTERFACE {
va009039 9:7f9f64cf5ded 26 INTERFACE() {
va009039 9:7f9f64cf5ded 27 in_use = false;
va009039 9:7f9f64cf5ded 28 intf_class = 0;
va009039 9:7f9f64cf5ded 29 intf_subclass = 0;
va009039 9:7f9f64cf5ded 30 intf_protocol = 0;
va009039 9:7f9f64cf5ded 31 ep.clear();
va009039 9:7f9f64cf5ded 32 }
va009039 8:6463cd1964c0 33 bool in_use;
va009039 8:6463cd1964c0 34 uint8_t intf_class;
va009039 8:6463cd1964c0 35 uint8_t intf_subclass;
va009039 8:6463cd1964c0 36 uint8_t intf_protocol;
va009039 9:7f9f64cf5ded 37 myqueue<USBEndpoint*>ep;
va009039 9:7f9f64cf5ded 38 };
va009039 8:6463cd1964c0 39
va009039 6:03ef38d6e1ba 40 /**
va009039 6:03ef38d6e1ba 41 * USBDeviceConnected class
va009039 6:03ef38d6e1ba 42 */
va009039 8:6463cd1964c0 43 class USBDeviceConnected {
va009039 6:03ef38d6e1ba 44 public:
va009039 8:6463cd1964c0 45
va009039 8:6463cd1964c0 46 /**
va009039 8:6463cd1964c0 47 * Constructor
va009039 8:6463cd1964c0 48 */
va009039 8:6463cd1964c0 49 USBDeviceConnected();
va009039 8:6463cd1964c0 50
va009039 8:6463cd1964c0 51 /**
va009039 8:6463cd1964c0 52 * Attach an USBEndpoint to this device
va009039 8:6463cd1964c0 53 *
va009039 8:6463cd1964c0 54 * @param intf_nb interface number
va009039 8:6463cd1964c0 55 * @param ep pointeur on the USBEndpoint which will be attached
va009039 8:6463cd1964c0 56 * @returns true if successful, false otherwise
va009039 8:6463cd1964c0 57 */
va009039 8:6463cd1964c0 58 bool addEndpoint(uint8_t intf_nb, USBEndpoint * ep);
va009039 8:6463cd1964c0 59
va009039 8:6463cd1964c0 60 /**
va009039 8:6463cd1964c0 61 * Retrieve an USBEndpoint by its TYPE and DIRECTION
va009039 8:6463cd1964c0 62 *
va009039 8:6463cd1964c0 63 * @param intf_nb the interface on which to lookup the USBEndpoint
va009039 8:6463cd1964c0 64 * @param type type of the USBEndpoint looked for
va009039 8:6463cd1964c0 65 * @param dir direction of the USBEndpoint looked for
va009039 8:6463cd1964c0 66 * @param index the index of the USBEndpoint whitin the interface
va009039 8:6463cd1964c0 67 * @returns pointer on the USBEndpoint if found, NULL otherwise
va009039 8:6463cd1964c0 68 */
va009039 8:6463cd1964c0 69 USBEndpoint * getEndpoint(uint8_t intf_nb, ENDPOINT_TYPE type, ENDPOINT_DIRECTION dir, uint8_t index = 0);
va009039 8:6463cd1964c0 70
va009039 8:6463cd1964c0 71 /**
va009039 8:6463cd1964c0 72 * Retrieve an USBEndpoint by its index
va009039 8:6463cd1964c0 73 *
va009039 8:6463cd1964c0 74 * @param intf_nb interface number
va009039 8:6463cd1964c0 75 * @param index index of the USBEndpoint
va009039 8:6463cd1964c0 76 * @returns pointer on the USBEndpoint if found, NULL otherwise
va009039 8:6463cd1964c0 77 */
va009039 8:6463cd1964c0 78 USBEndpoint * getEndpoint(uint8_t intf_nb, uint8_t index);
va009039 8:6463cd1964c0 79
va009039 8:6463cd1964c0 80 /**
va009039 8:6463cd1964c0 81 * Add a new interface to this device
va009039 8:6463cd1964c0 82 *
va009039 8:6463cd1964c0 83 * @param intf_nb interface number
va009039 8:6463cd1964c0 84 * @param intf_class interface class
va009039 8:6463cd1964c0 85 * @param intf_subclass interface subclass
va009039 8:6463cd1964c0 86 * @param intf_protocol interface protocol
va009039 8:6463cd1964c0 87 * @returns true if successful, false otherwise
va009039 8:6463cd1964c0 88 */
va009039 8:6463cd1964c0 89 bool addInterface(uint8_t intf_nb, uint8_t intf_class, uint8_t intf_subclass, uint8_t intf_protocol);
va009039 8:6463cd1964c0 90
va009039 8:6463cd1964c0 91 /**
va009039 8:6463cd1964c0 92 * Disconnect the device by calling a callback function registered by a driver
va009039 8:6463cd1964c0 93 */
va009039 8:6463cd1964c0 94 void disconnect();
va009039 8:6463cd1964c0 95
va009039 8:6463cd1964c0 96 void init(uint8_t hub, uint8_t _port, bool _lowSpeed);
va009039 8:6463cd1964c0 97 void setAddress(uint8_t addr_) { addr = addr_; };
va009039 8:6463cd1964c0 98 void setVid(uint16_t vid_) { vid = vid_; };
va009039 8:6463cd1964c0 99 void setPid(uint16_t pid_) { pid = pid_; };
va009039 8:6463cd1964c0 100 void setClass(uint8_t device_class_) { device_class = device_class_; }
va009039 8:6463cd1964c0 101 void setSubClass(uint8_t device_subclass_) { device_subclass = device_subclass_; };
va009039 8:6463cd1964c0 102 void setProtocol(uint8_t pr) { proto = pr; };
va009039 8:6463cd1964c0 103 void setEnumerated() { enumerated = true; };
va009039 8:6463cd1964c0 104 void setNbIntf(uint8_t nb_intf) {nb_interf = nb_intf; };
va009039 8:6463cd1964c0 105 void setSpeed(bool _lowSpeed) { lowSpeed = _lowSpeed; }
va009039 8:6463cd1964c0 106 void setName(const char * name_, uint8_t intf_nb) { return; };
va009039 8:6463cd1964c0 107 void setEpCtl(USBEndpoint* ep) { ep_ctl = ep; }
va009039 8:6463cd1964c0 108
va009039 8:6463cd1964c0 109 static int getNewAddress() {
va009039 8:6463cd1964c0 110 static int addr = 1;
va009039 8:6463cd1964c0 111 return addr++;
va009039 8:6463cd1964c0 112 }
va009039 8:6463cd1964c0 113 uint8_t getHub() { return hub_nb; };
va009039 8:6463cd1964c0 114 uint8_t getAddress() { return addr; };
va009039 8:6463cd1964c0 115 uint16_t getVid() { return vid; };
va009039 8:6463cd1964c0 116 uint16_t getPid() { return pid; };
va009039 8:6463cd1964c0 117 uint8_t getClass() { return device_class; };
va009039 8:6463cd1964c0 118 bool getSpeed() { return lowSpeed; }
va009039 8:6463cd1964c0 119 bool isEnumerated() { return enumerated; };
va009039 8:6463cd1964c0 120 USBEndpoint* getEpCtl() { return ep_ctl; }
va009039 8:6463cd1964c0 121
va009039 8:6463cd1964c0 122 private:
va009039 9:7f9f64cf5ded 123 mymap<int,INTERFACE*>intf;
va009039 8:6463cd1964c0 124 uint8_t hub_nb;
va009039 8:6463cd1964c0 125 uint8_t port;
va009039 6:03ef38d6e1ba 126 uint16_t vid;
va009039 6:03ef38d6e1ba 127 uint16_t pid;
va009039 6:03ef38d6e1ba 128 uint8_t addr;
va009039 8:6463cd1964c0 129 uint8_t device_class;
va009039 8:6463cd1964c0 130 uint8_t device_subclass;
va009039 8:6463cd1964c0 131 uint8_t proto;
va009039 8:6463cd1964c0 132 bool lowSpeed;
va009039 8:6463cd1964c0 133 bool enumerated;
va009039 8:6463cd1964c0 134 uint8_t nb_interf;
va009039 8:6463cd1964c0 135 USBEndpoint* ep_ctl;
va009039 8:6463cd1964c0 136 void init();
va009039 6:03ef38d6e1ba 137 };