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:
Wed Feb 05 13:34:37 2014 +0000
Revision:
10:40c7f6788902
Parent:
9:7f9f64cf5ded
fix endpoint callback.

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 10:40c7f6788902 20 #include "myvector.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 10:40c7f6788902 26 INTERFACE(uint8_t _class, uint8_t _subclass, uint8_t _protocol) {
va009039 10:40c7f6788902 27 intf_class = _class;
va009039 10:40c7f6788902 28 intf_subclass = _subclass;
va009039 10:40c7f6788902 29 intf_protocol = _protocol;
va009039 9:7f9f64cf5ded 30 }
va009039 8:6463cd1964c0 31 uint8_t intf_class;
va009039 8:6463cd1964c0 32 uint8_t intf_subclass;
va009039 8:6463cd1964c0 33 uint8_t intf_protocol;
va009039 10:40c7f6788902 34 myvector<USBEndpoint*>ep;
va009039 9:7f9f64cf5ded 35 };
va009039 8:6463cd1964c0 36
va009039 6:03ef38d6e1ba 37 /**
va009039 6:03ef38d6e1ba 38 * USBDeviceConnected class
va009039 6:03ef38d6e1ba 39 */
va009039 8:6463cd1964c0 40 class USBDeviceConnected {
va009039 6:03ef38d6e1ba 41 public:
va009039 8:6463cd1964c0 42
va009039 8:6463cd1964c0 43 /**
va009039 8:6463cd1964c0 44 * Constructor
va009039 8:6463cd1964c0 45 */
va009039 8:6463cd1964c0 46 USBDeviceConnected();
va009039 8:6463cd1964c0 47
va009039 8:6463cd1964c0 48 /**
va009039 8:6463cd1964c0 49 * Attach an USBEndpoint to this device
va009039 8:6463cd1964c0 50 *
va009039 8:6463cd1964c0 51 * @param intf_nb interface number
va009039 8:6463cd1964c0 52 * @param ep pointeur on the USBEndpoint which will be attached
va009039 8:6463cd1964c0 53 * @returns true if successful, false otherwise
va009039 8:6463cd1964c0 54 */
va009039 8:6463cd1964c0 55 bool addEndpoint(uint8_t intf_nb, USBEndpoint * ep);
va009039 8:6463cd1964c0 56
va009039 8:6463cd1964c0 57 /**
va009039 8:6463cd1964c0 58 * Retrieve an USBEndpoint by its TYPE and DIRECTION
va009039 8:6463cd1964c0 59 *
va009039 8:6463cd1964c0 60 * @param intf_nb the interface on which to lookup the USBEndpoint
va009039 8:6463cd1964c0 61 * @param type type of the USBEndpoint looked for
va009039 8:6463cd1964c0 62 * @param dir direction of the USBEndpoint looked for
va009039 8:6463cd1964c0 63 * @param index the index of the USBEndpoint whitin the interface
va009039 8:6463cd1964c0 64 * @returns pointer on the USBEndpoint if found, NULL otherwise
va009039 8:6463cd1964c0 65 */
va009039 8:6463cd1964c0 66 USBEndpoint * getEndpoint(uint8_t intf_nb, ENDPOINT_TYPE type, ENDPOINT_DIRECTION dir, uint8_t index = 0);
va009039 8:6463cd1964c0 67
va009039 8:6463cd1964c0 68 /**
va009039 8:6463cd1964c0 69 * Retrieve an USBEndpoint by its index
va009039 8:6463cd1964c0 70 *
va009039 8:6463cd1964c0 71 * @param intf_nb interface number
va009039 8:6463cd1964c0 72 * @param index index of the USBEndpoint
va009039 8:6463cd1964c0 73 * @returns pointer on the USBEndpoint if found, NULL otherwise
va009039 8:6463cd1964c0 74 */
va009039 8:6463cd1964c0 75 USBEndpoint * getEndpoint(uint8_t intf_nb, uint8_t index);
va009039 8:6463cd1964c0 76
va009039 8:6463cd1964c0 77 /**
va009039 8:6463cd1964c0 78 * Add a new interface to this device
va009039 8:6463cd1964c0 79 *
va009039 8:6463cd1964c0 80 * @param intf_nb interface number
va009039 8:6463cd1964c0 81 * @param intf_class interface class
va009039 8:6463cd1964c0 82 * @param intf_subclass interface subclass
va009039 8:6463cd1964c0 83 * @param intf_protocol interface protocol
va009039 8:6463cd1964c0 84 * @returns true if successful, false otherwise
va009039 8:6463cd1964c0 85 */
va009039 8:6463cd1964c0 86 bool addInterface(uint8_t intf_nb, uint8_t intf_class, uint8_t intf_subclass, uint8_t intf_protocol);
va009039 8:6463cd1964c0 87
va009039 8:6463cd1964c0 88 /**
va009039 8:6463cd1964c0 89 * Disconnect the device by calling a callback function registered by a driver
va009039 8:6463cd1964c0 90 */
va009039 8:6463cd1964c0 91 void disconnect();
va009039 8:6463cd1964c0 92
va009039 10:40c7f6788902 93 void init(USBDeviceConnected* parent, uint8_t _port, bool _lowSpeed);
va009039 8:6463cd1964c0 94 void setAddress(uint8_t addr_) { addr = addr_; };
va009039 8:6463cd1964c0 95 void setVid(uint16_t vid_) { vid = vid_; };
va009039 8:6463cd1964c0 96 void setPid(uint16_t pid_) { pid = pid_; };
va009039 8:6463cd1964c0 97 void setClass(uint8_t device_class_) { device_class = device_class_; }
va009039 8:6463cd1964c0 98 void setSubClass(uint8_t device_subclass_) { device_subclass = device_subclass_; };
va009039 8:6463cd1964c0 99 void setProtocol(uint8_t pr) { proto = pr; };
va009039 8:6463cd1964c0 100 void setEnumerated() { enumerated = true; };
va009039 8:6463cd1964c0 101 void setNbIntf(uint8_t nb_intf) {nb_interf = nb_intf; };
va009039 8:6463cd1964c0 102 void setSpeed(bool _lowSpeed) { lowSpeed = _lowSpeed; }
va009039 8:6463cd1964c0 103 void setName(const char * name_, uint8_t intf_nb) { return; };
va009039 8:6463cd1964c0 104 void setEpCtl(USBEndpoint* ep) { ep_ctl = ep; }
va009039 8:6463cd1964c0 105
va009039 8:6463cd1964c0 106 static int getNewAddress() {
va009039 8:6463cd1964c0 107 static int addr = 1;
va009039 8:6463cd1964c0 108 return addr++;
va009039 8:6463cd1964c0 109 }
va009039 8:6463cd1964c0 110 uint8_t getAddress() { return addr; };
va009039 8:6463cd1964c0 111 uint16_t getVid() { return vid; };
va009039 8:6463cd1964c0 112 uint16_t getPid() { return pid; };
va009039 8:6463cd1964c0 113 uint8_t getClass() { return device_class; };
va009039 8:6463cd1964c0 114 bool getSpeed() { return lowSpeed; }
va009039 8:6463cd1964c0 115 bool isEnumerated() { return enumerated; };
va009039 8:6463cd1964c0 116 USBEndpoint* getEpCtl() { return ep_ctl; }
va009039 8:6463cd1964c0 117
va009039 8:6463cd1964c0 118 private:
va009039 10:40c7f6788902 119 USBDeviceConnected* hub_parent;
va009039 9:7f9f64cf5ded 120 mymap<int,INTERFACE*>intf;
va009039 8:6463cd1964c0 121 uint8_t port;
va009039 6:03ef38d6e1ba 122 uint16_t vid;
va009039 6:03ef38d6e1ba 123 uint16_t pid;
va009039 6:03ef38d6e1ba 124 uint8_t addr;
va009039 8:6463cd1964c0 125 uint8_t device_class;
va009039 8:6463cd1964c0 126 uint8_t device_subclass;
va009039 8:6463cd1964c0 127 uint8_t proto;
va009039 8:6463cd1964c0 128 bool lowSpeed;
va009039 8:6463cd1964c0 129 bool enumerated;
va009039 8:6463cd1964c0 130 uint8_t nb_interf;
va009039 8:6463cd1964c0 131 USBEndpoint* ep_ctl;
va009039 8:6463cd1964c0 132 void init();
va009039 6:03ef38d6e1ba 133 };