B4A Library PL2303 USB to RS232 adaptor driver

This is a driver for PL2303 based USB to RS232 adaptors. The PL2303 is a chip produced by Prolific Technology Inc. of Taiwan and is a very common chip to find in such adaptors. The driver requires version 0.92 or later of the USB Host library and needs a Honeycomb 3.1 or later device with USB host support .

This driver is not up to the standard that I would normally expect of myself. However it is unavoidably crippled by problems with the Android implementation of USB support and has been produced by reverse engineering a Linux driver as Prolific only provide chip operation details to their OEMs and do not publish an operation manual. Erel has suggested that I post it anyway as it is probably usable in at least some situations.

The specific problems that beset the Android USB support concern data transfer. There are two ways to transfer data in and out, asynchronously by queueing Requests and synchronously using the BulkTransfer method. Of the four possibilities two are broken in Android. Asynchronous reads will transfer fixed length arrays of data but there is no way of telling you how many bytes of the returned arrays contain valid data! I have also found a problem with synchronous writes. BlockTransfer is supposed to return a value of how many bytes it has written, or a -ve number if a fault occurred. However I was getting return values of -1 even though the data has been successfully sent! So we have a USB implementation that can't tell you how many bytes you have received nor how many bytes you have sent!

This driver implementation therefore has to use asynchronous writes and synchronous reads invoked by a Timer in order to provide some semblance of functionality. The use of synchronous reads limits the data rates that can be reliably supported without dropping data. If you have a PL2303 based adaptor then have a play yourself.

 

[agraham]

I would expect the HL340 to have a proprietary protocol like the FTDI and Prolific chips so I would not expect USBSerial and the PL2030 driver to work with them

 

[qsrtech]

Hmmm, my printer does seem to get some data but it seems to be garbage. I use getbytes("ascii") so i'm pretty sure that part is fine. Well I guess if I can't find a solution then I'll just have to spec a "pl2303" cable to be used with any "serial" printer. Unfortunately I don't have an actual USB based printer atm, one is on it's way. Hopefully the regular USB lib will work with these, w/o any additional headaches.

 

[microbox]

Connecting android(3.2) to PL2303 adapter

Hello everyone, forgive me if this may sound simple...but I'm really having a hard time making my phone to communicate with Pl2303 module. I appreciate anyone who can give help me on this. My hardware setup is I have a microcontroller attached to the USB adapter(e-Gizmo USB-UART Serial TTL converter) pl2303 then to android tab. The application in the mcu is simply sending "Hello World" and have it display to android.
I installed the example program made by agraham, when pressing the button 'Open' gives me 'No PL2303 device found' every time. I tried also Slick USB to see if there are any incoming data but there are none...can any one point what I'm missing and kindly check my hardware connection...thanks in advance.


regards,
microbox

 

[agraham]

Your tablet needs to support USB host mode and if it does you will need an On The Go (OTG) cable, sometimes called a Camera cable, to switch the tablet USB port into host mode. This cable will have a mini-USB to plug into the tablet and a female USB socket so you can connect the tablet to the USB adaptor with a standard USB A-B cable.

 

[microbox]

Thanks agraham for the response, I hope can get one today and try it again.

Regards,
microbox

 

[microbox]

Hi..I finally got the mcu and android talking..OTG cable was the key. But I have another question:sign0104:...I insert an EditText to show the data("Hello World") in the following code..

Sub RxDataEvent
   Dim rxdata As RxDataBlock
   For i = 0 To USBpl2303.rxdata.size - 1
      rxdata = USBpl2303.rxdata.Get(0)
      USBpl2303.rxdata.RemoveAt(0)
      totalrxbytes = totalrxbytes + rxdata.bytecount
   Next
       EditText1.Text = rxdata
   Log("RxDataEvent total bytes = " & totalrxbytes)
   If totalrxbytes = 4100 Then
      Msgbox(totalrxbytes, "Success")
   End If
End Sub

this is the output I have [data=[B@4109e10,bytecount=20,IsInitialized=false
I read it needs the ByteConverter library but to be honest I'm not really sure how to use it...

 

[agraham]

Look here http://www.b4x.com/forum/additional...03-usb-rs232-adaptor-driver-8.html#post138112

 

[microbox]

Thanks I got it...

 

[microbox]

Hi, I'm having difficulty filtering/capturing my data sent via my MCU to android using USBPL2303, hope anyone here have time to point me what I'm doing wrong.
Hardware setup:
Microcontroller (with 1 button) connected to USB Pl2303 to Android(version 4). When Button is pressed it send message to port ":Hello World message 1,:Hello World message 2,:" + CHR(13).
I'm able to display the characters to editText1..but I need it to display them like in the form..
editText2.text = "Hello World message 1"
editText3.text = "Hello World message 2"
I tried to play with the following code but not working as I needed.

Sub Button1_Click
Dim MyValue() As String
If EditText1.Text.Length > 20 Then 
  MyValue=Regex.Split(",",EditText1.Text)      
  MyValue(0)=MyValue(0).SubString(MyValue(0).IndexOf(":")+1)
  MyValue(1)=MyValue(1).SubString(MyValue(1).IndexOf(":")+1)
  editText1.text = MyValue(0) 
  editText2.text = MyValue(1)
End If 
End Sub

Thanks in advance and sorry if I'm not making clear :sign0104:

 

[microbox]

Okay I got it right this time..

 

[NewB4a]

Hello,

I've got the following Error:

Parsing code. Error
Error parsing program.
Error description: Unknown type: byteconverter
Are you missing a library reference?
Occurred on line: 132
Dim conv As ByteConverter

What to do?

 

[agraham]

You need the ByteConverter library Libraries - Basic4android Wiki

 

[NewB4a]

Problem with Byteconverter library

Sorry agraham,

first thanks for the hint to the library. As a beginner in b4a I have a very simple question:
I load byteconverter library and put the .Jar and.xml file in the libraries folder of b4a. But when compiling the example USBpl203 again I receive the error:

Error description: Unknown type: byteconverter
Are you missing a library reference?
Occurred on line: 132
Dim conv As ByteConverter

What changes are to do in the manifest?

 

[rboeck]

You have to make one click in the Libs tab at Byteconverter: you should see the version (1.10) behind the name. You dont need anything in the manifest.
Greetings
Reinhard

 

[NewB4a]

One Click ?

Sorry, but I don't understand this.

What do you mean by 'Libs Tab' and what by 'one click'?

Thanks
Tom

 

[agraham]

Right hand pane of the IDE. Tab row at bottom. Select Libs. Check ByteConverter. You should keep the B4A Libraries folder for the official libraries that come with each release. Tools -> Configure Paths -> Additional libraries lets you define a folder for extra libraries. You should not put it in Ptrogram Files as that is a protected folder on Vista and later.

 

[NewB4a]

Thanks,

indeed I've put it in the wrong path. My library has the Version 1.1.
Did i overwrite the original version? If so, how can i correct this?

And: What path is conveniant? Should I create a new folder parallel to the original libraries folder?

Besides: The Error now is:
Error description: Unknown type: reflector
Are you missing a library reference?
Occurred on line: 188
Dim Obj1 As Reflector

Thanks,Tom

 

[agraham]

Version 1.1 is correct. There was no original version as this is an additional library not part of the official release. You can put the additional libraries folder anywhere you want but, as I already said, I would suggest not in Program Files. For example mine is in C:\Android\Basic4android\Basic4androidLibraries as I have a whole structure of Android SDK, Eclipse and Basic4android projects and library source code under C:\Android

 

[NewB4a]

Sorry Agraham, when wasting your time.

I have extracted both files 'ByteConverter' to
C:\Android\Basic4Android\AdditionalLibraries

and I changed the correspondend path as neccessary.
But the error is still:
Error description: Unknown type: reflector
Are you missing a library reference?
Occurred on line: 188
Dim Obj1 As Reflector

Could you hel me again?

Thanks Tom

 

[agraham]

You also need the Reflection library.