Online Development Notebook > Index > Programming Overview > DLL Commands > DeviceSer

DeviceSer - Return the serial number of the device

---

Description:

This is a USBm.dll function that returns the Serial number string from a USB device.

Command Syntax:

true⁄false USBm_DeviceSer( device, string )

The USBm_DeviceSer function syntax has these parts:

Remarks:

In VB the string passed as an argument must be large enough to hold all the characters that the function places in the string. The best way to acheive this is to set the string to a large size with the String function as in this code:

strStrng = String(250, " ")

Note: USBm_DeviceSer returns TRUE for a valid device.

VB Declaration (USBmAPI.bas)

Public Declare Function USBm_DeviceSer _     Lib "USBm.dll" _         (ByVal device As Byte, _         ByVal serial As String) _     As Integer

VB Example

Dim strng As String * 255     USBm_DeviceSer 3, strng     frmStatus.lstDevices.AddItem "Serial: " & strng

This code fragment shows that string is loaded with the "serial" text of device three. Assuming that the form called "Main" exists with a text box called "Info", the "serial" information will be made visible to the user.

C Prototype

int USBm_DeviceSer( unsigned char device, char *product );

C Example

RobotBASIC

DID, PID, VID, Mfr, Prod, Serial Number, and Firmware Version are all handled by the RobotBASIC function usbm_DeviceSpecs(ne_DeviceNumber).

usbm_DeviceSpecs(ne_DeviceNumber)

Returns a string that contains information about the device. There are 7 sections seperated by the | character. You can use the Extract() function to extract each section seperately if desired. The sections are:

DID

PID

VID

Mfr

Prod

Serial Number

Firmware Version

---

Hardware:  U401 USB Interface    U421 USB Interface   U451 USB Interface

Programming:  USBm DLL Programming    Download Files

Application Notes:  U4x1 Application Notes    Misc Applications and Information    FAQ

While every effort has been made to make sure that the information posted on this site is correct, the author can not be held liable for any damages whatsoever for losses as a result of the application of this information. Use this information at your own risk.

USBmicro can design your custom and semi-custom USB product. Email about USB design can be directed to " Robert " at usbmicro.com.

Copyright © USBmicro, L.L.C., 2002-2010