BA / Mbed OS BaBoRo1

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Embed: (wiki syntax)

« Back to documentation index

USBSerial Class Reference
Public Member Functions

USBSerial Class Reference

USBSerial example. More...

#include <USBSerial.h>

Inherits USBCDC.

Public Member Functions

 USBSerial (uint16_t vendor_id=0x1f00, uint16_t product_id=0x2012, uint16_t product_release=0x0001, bool connect_blocking=true)
 Constructor.
virtual int _putc (int c)
 Send a character.
virtual int _getc ()
 Read a character: blocking.
uint8_t available ()
 Check the number of bytes available.
bool connected ()
 Check if the terminal is connected.
int readable ()
 Determine if there is a character available to read.
int writeable ()
 Determine if there is space available to write a character.
bool writeBlock (uint8_t *buf, uint16_t size)
 Write a block of data.
template<typename T >
void attach (T *tptr, void(T::*mptr)(void))
 Attach a member function to call when a packet is received.
void attach (void(*fptr)(void))
 Attach a callback called when a packet is received.
void attach (Callback< void()> &cb)
 Attach a Callback called when a packet is received.
void attach (void(*fptr)(int baud, int bits, int parity, int stop))
 Attach a callback to call when serial's settings are changed.

Detailed Description

USBSerial example. 

 #include "mbed.h"
 #include "USBSerial.h"

 //Virtual serial port over USB
 USBSerial serial;

 int main(void) {

    while(1)
    {
        serial.printf("I am a virtual serial port\n");
        wait(1);
    }
 }

Definition at line 47 of file USBSerial.h.

Constructor & Destructor Documentation

USBSerial ( uint16_t  vendor_id = 0x1f00,
uint16_t  product_id = 0x2012,
uint16_t  product_release = 0x0001,
bool  connect_blocking = true 
)

Constructor.

Parameters:
vendor_idYour vendor_id (default: 0x1f00)
product_idYour product_id (default: 0x2012)
product_releaseYour preoduct_release (default: 0x0001)
connect_blockingdefine if the connection must be blocked if USB not plugged in

Definition at line 59 of file USBSerial.h.

Member Function Documentation

int _getc ( void   ) [virtual]

Read a character: blocking.

Returns:
character read

Definition at line 29 of file USBSerial.cpp.

int _putc ( int  c ) [virtual]

Send a character.

You can use puts, printf.

Parameters:
ccharacter to be sent
Returns:
true if there is no error, false otherwise

Definition at line 22 of file USBSerial.cpp.

void attach ( T *  tptr,
void(T::*)(void)  mptr 
)

Attach a member function to call when a packet is received.

Parameters:
tptrpointer to the object to call the member function on
mptrpointer to the member function to be called

Definition at line 128 of file USBSerial.h.

void attach ( void(*)(void)  fptr )

Attach a callback called when a packet is received.

Parameters:
fptrfunction pointer

Definition at line 139 of file USBSerial.h.

void attach ( Callback< void()> &  cb )

Attach a Callback called when a packet is received.

Parameters:
cbCallback to attach

Definition at line 150 of file USBSerial.h.

void attach ( void(*)(int baud, int bits, int parity, int stop)  fptr )

Attach a callback to call when serial's settings are changed.

Parameters:
fptrfunction pointer

Definition at line 159 of file USBSerial.h.

uint8_t available (  )

Check the number of bytes available.

Returns:
the number of bytes available

Definition at line 66 of file USBSerial.cpp.

bool connected (  )

Check if the terminal is connected.

Returns:
connection status

Definition at line 70 of file USBSerial.cpp.

int readable ( void   )

Determine if there is a character available to read.

Returns:
1 if there is a character available to read, 0 otherwise

Definition at line 99 of file USBSerial.h.

int writeable ( void   )

Determine if there is space available to write a character.

Returns:
1 if there is space to write a character, 0 otherwise

Definition at line 107 of file USBSerial.h.

bool writeBlock ( uint8_t *  buf,
uint16_t  size 
)

Write a block of data.

For more efficiency, a block of size 64 (maximum size of a bulk endpoint) has to be written.

Parameters:
bufpointer on data which will be written
sizesize of the buffer. The maximum size of a block is limited by the size of the endpoint (64 bytes)
Returns:
true if successfull

Definition at line 37 of file USBSerial.cpp.

Generated on Tue Jul 12 2022 12:22:51 by  doxygen 1.7.2