LeafLabs Garden

A place to share, learn, and grow...

1. 

   Yogybear
   Member

   Hi folks,

   is there any way to change the device name of the Maple (Maple R3) which appears in the Device Manager of MS Windows before the drivers are installed.

   To be clear:
   I know that there is a way by editing the "DESCRIPTION = ..." in the maple_serial.inf and after installation of this driver the new device name appears in the device manager.

   But:
   I want to have a custom device name before any drivers are installed.

   I already searched in the Internet, this forum and in the boot loader files for any hint without success.

   I would appreciate any hints and help.

   Cheers

   Posted 2 years ago #
2. 

   bnewbold
   Ex-Leaflabs

   You are probably looking for u8_usbStringVendor and u8_usbStringProduct in maple-bootloader/usb_descriptor.c. This isn't user-friendly code, so i'd recommend reading the USB specification (if you can find a copy) and/or not changing the length of any of the arrays in usb_descriptor.c. You might be able to find a more user-friendly bootloader floating around the net.

   You could/should also change the Vendor string and USB vendor/product IDs if you're going to do something like this (the curious mind wonders why).

   Posted 2 years ago #
3. 

   Yogybear
   Member

   You understood me right! This is the answer I was looking for, thank you very much!

   In my opinion there is no really need for a user-friendly bootloader, the energy which this would cost should be saved in some places where it's really needed.

   Thank you for your help.

   [SOLVED]

   Posted 2 years ago #
4. 

   Yogybear
   Member

   Hi folks,

   I'd like to capture this topic again, because my initial problem is not completely solved yet.

   For fast readers: I'd like to change the device name which appears in the device manager while the board is connected to a Windows-PC via USB and a user programm is running. Usually the name "Maple" is visible, but I'd like to have my own device name.

   As bnewbold has already mentioned, in the "usb_descriptor.c" which can be found in the root directory of the bootloader ( https://github.com/leaflabs/maple-bootloader ) you can edit the values of usbStringVendor and usbStringProduct.

   BUT

   This only affects the device name while it is in the DFU-Mode (alias bootloader mode). The device is only about 5 sec in this mode and jumps subsequently in the user program, while it changes it's name to 'Maple'. Until now I couldn't find any record to change the device name 'Maple' while a user program is running.

   For the curious minds out there: Imagine you have a couple of boards on your desk but you forgot which is the board you are looking for. Sure you could mark it, but I would like also to see the right device name popping up in the corner "Device XYZ is ready for use"

   Thanks a lot.

   Cheers

   Posted 2 years ago #
5. 

   ventosus
   Member

   The strings you want to change seem to be located in the code for the USB serial driver of libmaple:

   ./libmaple/libmaple/usb/stm32f1/usb_cdacm.c

   search for usbVcomDescriptor_iManufacturer and usbVcomDescriptor_iProduct...

   Posted 2 years ago #
6. 

   Yogybear
   Member

   Thank you for your fast reply!

   I'll take a look and report if I could solve the problem.

   Cheers

   Posted 2 years ago #
7. 

   Yogybear
   Member

   [SOLVED][SOLUTION]

   Hi folks,

   I figured it out and I like to share my new knowledge to the world :)

   Introduction for Newbies (like me)
   ==================================
   First of all (as already known) there are two states in which the stm32/Maple Board could be - first the "bootloader mode" and second the "user program mode". If there is no user program on the uC, it stays in the "bootloader mode", because there is no program in which it could jump in. This happens with a factory new uC or after flashing the bootloader. While connected to a PC (or power source), the stm32/Maple Board goes first for about 3-5 sec in the "bootloader mode". After this time is elapsed, it changes into the "user program mode". For the device/hardware managers of all operating systems on PCs, every mode appears as a separate hardware device with a separate device name.

   Essence
   =======
   The device name for the "bootloader mode" differs from the device name of the "user program mode". In addition the places where the names are stored differs too. You can change the device name of each mode separately.

   The "bootloader mode device" name is stored in the "usb_descriptor.c" in the maple bootloader. To change this name you need to flash the bootloader according to this manual: http://leaflabs.com/docs/bootloader.html and change some values in the file "usb_descriptor.c". These values are u8_usbStringVendor and u8_usbStringProduct. You need to do this (of course) before compiling and flashing. You need to adapt the string length in hex - be patient, you need to add 3 to the string length (I don't know why). You also need to change the string length in the bottom of the file.

   The "user program mode" name is stored in the Maple IDE in the "descriptor.c" file. You can find this file in [MAPLE IDE PATH]/hardware/leaflabs/cores/maple. Here you can find the values "usbVcomDescriptor_iManufacturer" and "usbVcomDescriptor_iProduct". Again, you have to adapt the string length of these values. The "user program mode" name will change when you upload a new user program.

   That's it. Hope I could help some people out there with these informations.

   Cheers

   [SOLVED][SOLUTION]

   Posted 2 years ago #

RSS feed for this topic

Reply

You must log in to post.