USB Host Keyboard example from Arduino - HIDHost library not found

Official Hardware Mega GIGA R1 WiFi
1

Trying out some examples from the "Guide to Arduino GIGA USB Features" and have run into a problem with the "USB Host Keyboard" example.

When I try and compile it, I get messages about the "HIDHost.h" file not being found

The description says "This library is included in the core, so it does not require any additional installation". But that doesn't seem to be the case!

I have tried it on a couple of computers, both Linux and Windows, and the results are the same.

Would appreciate any suggestions, thanks!

1 Like
2

I have the same expreience. The USB flash drive examples do compile after installing the following. But there is no HIDHost.h.

I do not yet have a board :(. The USBHostMbed library is very sparse so I will be looking Teensy 4.1 with USBHost_t36.

Name: "Arduino_USBHostMbed5"
  Author: Arduino
  Maintainer: Arduino <info@arduino.cc>
  Sentence: ARM Mbed5 USBHOST library port for Arduino.
  Paragraph: This library contains an Arduino port for the ARM Mbed5 USBHost library for STM32H747 based boards.
  Website: https://github.com/arduino-libraries/Arduino_USBHostMbed5
  Category: Communication
  Architecture: mbed, mbed_portenta, mbed_giga
  Types: Contributed
  Versions: [0.0.3]
3

Unfortunately many of the giga examples are still broken, flash as a usb drive doesn't work either.

1 Like
4

I received my board on Monday and it’s been a frustrating experience. I’ve been spending most of my time reading the hardware core code, because of the broken examples. Lots of warnings during compilations too. I’d swear we’re still in Beta :-). But, the board is impressive and I’m having a lot of fun playing with coding dual-core stuff.

My only answer to the OP, hang in there and keep experimenting, it will get better.

1 Like
5

Yes, I've been having a similar experience, also got my board on Monday and was hoping to record a video and write an article about it by this weekend. But with so many non-functional examples, it's proving difficult.

Glad to see I'm not the only one who feels like we are in Beta mode!

1 Like
6

Hello @DroneBotWorkshop and everyone else in this thread!

In the particular case of the "Keyboard Example", we had missed to link the USBHostGiga library, which is currently in an Alpha stage. We are updating this documentation as we speak. This library can be downloaded from this GitHub repository.

Sorry about the inconvenience!

1 Like
7

I should also add (and I am updating the documentation to specify this more clearly), that the USB features on the GIGA board are currently split between three separate libraries and therefore I think there may have been some confusion and broken examples.

The libraries are:

I hope this provides some clarity! :slight_smile:

2 Likes
8

Hi, thanks for the response. Any idea why does the flash as usb example cause mbedOS to crash?

9

Hi @bexin , there could be several reasons for the mbed os to crash, but some of the more common are:

  • The USB drive may not be properly formatted. It should be formatted with the FAT32 file system and an MBR partition scheme. Try reformat the drive and see if it works.
  • The designation may be wrong. If your USB drive is named e.g. device_1, it needs to be reflected in the code.

First, when creating the object:

mbed::FATFileSystem usb("name_of_usb_stick")

Second, when you are reading/writing:

FILE *f = fopen("/name_of_usb_stick/file.txt", "r+");

The examples in the guide uses a the very generic "usb" designation.

1 Like
10

Was having more bizarre issues, such as code that compiles on one workstation but not on the other, until I realized that the USBHost library appears to have changed names!

The copy I installed from the Library Manager on Mar 16 was version 0.0.2. It was named "USBHostMbed5" and the file directory example works properly with it. The file write demo also works once you fix the errors in the sketch (should be "msd.connect" and not "msd.connected").

The latest installation of the library installed today (March 19) is 0.0.3. It installs under the name "Arduino_USBHostMbed5", and none of the examples using the USB file system work with it, as they expect to find "USBHostMbed5.h". Changing the reference in the examples to "Arduino_USBHostMbed5.h" compiles.

I've experienced this on both Linux and Windows. Very frustrating to say the least, it's bad enough that there are so many errors in the example code, but to change library names between versions is just silly.

11

Are you using the examples that come with the version 0.0.3 installation? I ask because all the #include directives were updated to the new header filename before the release:

So the problem should not occur with the library's example sketches, which are updated along with the library. It would occur with any standalone code that was saved separately from the library though.

Even though it would normally be best practices to rename primary header filenames in a backwards compatible manner, in this case where the library is still in the unstable development phase (as indicated by the use of the 0 major version series), I think it is reasonable for the developers to make such changes in a breaking manner rather than building up cruft in the repository. However, I do think it would be a good idea to communicate such breaking changes to the users in the release notes. I submitted a report about that:

@ksoderby I don't have write permissions in the repository so I can't update the release notes (and it can't be done via a pull request). If you have write permissions, please document the header filename change in the 0.0.3 release notes. You can do that by clicking the pencil icon near the top right corner of the release page:

12

Alexander Entinger has now taken care of it:

https://github.com/arduino-libraries/Arduino_USBHostMbed5/issues/17#issuecomment-1475604788

13

Thanks for addressing this @ptillisch , and for posting the issue in the repository.

@DroneBotWorkshop the documentation including the examples will be updated in short, with the new library name. The name update had an unfortunate timing, apologies for the inconvenience there. Hopefully this will resolve any of the issues you had, otherwise, please let us know if there are any other issues :slight_smile:

14

Through much trial and error, I found one cause for mbed to crash. The USB Host examples, for some reason, are using Serial, which isn't available when working as a Host.

So, I had to change from Serial to Serial1 for the USB Host Mass Storage Directory List example to work.

Obviously, this means you need an external USB-to-serial converter.

I don't understand why the USB Host examples use Serial. My understanding was that there is only 1 USB PHY, so the STM32 cannot be both a host and device. Which, these numerous issues would back up.

1 Like
15

I do believe that usb OTG configuration should support both device and host, while there are also device only and host only modes. Based on the stm33cube config options, I’ll recheck later today.

16

I noticed the 3 mass storage examples different in an OTG reference. The list directory example has none. The Read example has mbed::DigitalOut otg(PB_14, 0); and the write example has mbed::DigitalOut otg(PB_8, 1);.

Of course, I see no comment (or readily available documentation) on what either of those calls/pins do.

Of those three examples, none of them worked for me when using Serial. They all caused mbed to crash.

The Write example also has an issue with msd.connect() and msd.connected(). The single call to connect() and then waiting for connected() to become true never happens. I don't know why that example uses a different method than the other two.

17

Hi All,

I also was able to get the "Read" and the "List" Programs working.

From what I see the "PB_8" appears to be a mistake!

I noticed that the Pinout lists "PB14" as noted below.

I have even tried toggling both the "0" to a "1" and changed the "PB14" to "PB15".

Both do not work!

Does anyone know what the "HS_DP" and "HS_DM" stand for?

I was able to find out that "OTG" stands for "On The Go".

Thanks Paul

image
image775×344 32.1 KB

18

Hi All,

I just got the Code to work with a few changes:

Switched "PB_8" to "PB15"
mbed::DigitalOut otg(PB_15, 1);

Swiched " while (!msd.connected()) " to "while (!msd.connect()) "

I also added a " delay(2500);" but I'm not sure that makes a difference.

Let me know if you have any Questions.

Thanks Paul

image

#include <Arduino_USBHostMbed5.h>
#include <DigitalOut.h>
#include <FATFileSystem.h>

USBHostMSD msd;
mbed::FATFileSystem usb("usb");

// mbed::DigitalOut pin5(PC_6, 0);
//mbed::DigitalOut otg(PB_8, 1);
mbed::DigitalOut otg(PB_15, 1);

void setup() {
  Serial.begin(115200);
  
  pinMode(PA_15, OUTPUT); //enable the USB-A port
  digitalWrite(PA_15, HIGH);
  
  while (!Serial);

//I Added this line
  delay(2500);
  
  
  msd.connect();  

  while (!msd.connect()) {
    //while (!port.connect()) {
    delay(1000);
  }
  

  Serial.println("Mounting USB device...");
  int err =  usb.mount(&msd);
  if (err) {
    Serial.print("Error mounting USB device ");
    Serial.println(err);
    while (1);
  }
  Serial.print("read done ");
  mbed::fs_file_t file;
  struct dirent *ent;
  int dirIndex = 0;
  int res = 0;

  Serial.println("Open /usb/numbers.txt");

  //FILE *f = fopen("/usb/numbers.txt", "w+");

  FILE *f = fopen("/usb/numbers.txt", "w");

  /*

  for (int i = 0; i < 10; i++) {
    Serial.print("Writing numbers (");
    Serial.print(i);
    Serial.println("/10)");
    fflush(stdout);
    err = fprintf(f, "%d\n", i);
    if (err < 0) {
      Serial.println("Fail :(");
      error("error: %s (%d)\n", strerror(errno), -errno);
    }
  }
  */

  Serial.println("File closing");
  fflush(stdout);  
  err = fclose(f);

  /*
  if (err < 0) {
    Serial.print("fclose error:");
    Serial.print(strerror(errno));
    Serial.print(" (");
    Serial.print(-errno);
    Serial.print(")");
  } else {
    Serial.println("File closed");
  }
   */ 
}