ObjectExchange

Brecham ObexServer r6 -- support 32feet.NET Widcomm

Andy Hume — Fri, 12 Mar 2010 11:23:17 GMT

Updated on Sunday 13th March.

Note, this is the server-side library, for the main client-side distribution see http://32feet.net/files/folders/objectexchange/entry6351.aspx

From the readme:

An implementation of an OBEX Server using the Brecham.OBEX library.

Andy Hume, March 2010

This is a sample implementation of an OBEX Server using the Brecham.OBEX library. It includes the source for both the concrete implementation of both a PUT / Inbox Server and a GET / Folder Browsing server, as well as the implementation of base OBEX Server infrastructure. A sample command-line program is also included which writes the files it receives to disk, and can handle GET of files and Folder Listings, and can listen on Bluetooth, IrDA, or TCP/IP. A similar NETCF WinForms program is also included.

Things may change later on, but for now at least the code isn't a simple ‘create a new instance of this class, and it will do the job just like that’. With server side code I feel that there will always be some different behaviour wanted, for instance to write the received files to a MemoryStream instead of to disk, or to also support GET and SETPATH, or to listen or more protocol at once, or to support multi connections simultaneously, etc. To provide only a closed binary implementation would likely not be the most useful delivery.

So I intend not to release an official complete version as such but instead let the community improve it as it sees fit. So the code here is provided to be added into your project, with some integration work likely needed. Of course I welcome any changes to the code, let me have you diffs and I’ll integrate them for later version. It could even become a CodePlex project if there was demand and support for that.

In brief the main changes in this version is support for running on 32feet.NET's new Widcomm support.

Brecham ObexServer r5 -- multi-connection, basic authentication

Andy Hume — Sun, 02 Nov 2008 22:00:54 GMT

Note, this is the server-side library, for the main client-side distribution see http://32feet.net/files/folders/objectexchange/entry6351.aspx

From the readme:

An implementation of an OBEX Server using the Brecham.OBEX library.

Andy Hume, November 2008

In brief the changes in this version were firstly handling of multiple connections, secondly basic authentication.

Brecham Obex 1.7 release

Andy Hume — Sun, 12 Oct 2008 16:33:21 GMT

From the readme:

OBEX library — Readme

12^th October 2008 — release 1.7 (1.7.1012).

What’s new

For the full list of changes in the current and previous versions see the Changes document. In brief the changes in the core library in this version include

The listings produced by some SonyEricsson and LG phones include a user-perm (permissions) attribute with an empty value. This is disallowed by the Folder-Listings DTD in the OBEX specification, and thus the .NET XmlReader fails on reading that attribute, with “The 'user-perm' attribute has an invalid value according to its data type.”. We have included a modified DTD in the library which permits the emtpy string, and the Folder-Listing parser class now uses it by default.
Previously when reading a Folder-Listing, the operation generally was completed by sending an ABORT pdu to the server. Now a normal GET close is carried out. The ABORT pdu causes no problems as far as I know but thought I’d fix it anyway in case the ABORT appears to server logs and might confuse someone. This occurred due to our workaround for the bug in listings produced by Broadcom/Widcomm.
Added an Authentication class which contains some method to create an parse the various OBEX Authentication headers, and also to do the secure hash of the password. These methods are currently marked as: “Prelimary code, may change or disappear in later versions.” Please give me your feedback!

Changes in the previous version (1.6) include:

Add option IgnoreBadDateFormats to ObexFolderListingParser, to allow it to continue even when the server provides invalid folder-listing content. For instance the LG K800 phone sometimes produces date values like modified="19800000T-90000" a negative time! See the Programmer’s Guide for more information.
Added ObexClientSession.PutFile which takes a pathname parameter of the file to send.
Add a Headers property to the ObexResponseException which lists the headers received along with the error response. (Note that the headers are currently discarded if the exception is runtime-serialized).

These were a few fixes and improvements to the sample programs in that release also.

Features

The library provides very broad client-side OBEX support, providing not just the ‘Put’ operation that most libraries and applications support, but also the complete set of operations: Connect, Put, Get, SetPath, Delete, and Abort. This is accessed through a session based interface. All errors communicating to the peer OBEX server are exposed to the calling application.

As well as the ‘on-the-wire’ protocol support there is also broad support for the objects defined in the OBEX specification, for instance the Folder Listing XML documents as used by the Folder-Browsing service. A full parser, returning an array of folder and file objects, is included

The library also provides access to its lower-level PDU (packet) creation and parsing facilities, enabling third-party implementation of any required features, for instance server-side operation, and perhaps even reliable-session support.

The library, its class documentation in both compiled HTML Help, and in raw XML for Intellisense, and a Programmer’s Guide are included.

Assemblies for both the FXv2 desktop and Compact Framework versions 1 and 2 are supplied.

Included sample code contains examples in both C# and VB.NET, showing how to use Put, Get, SetPath, and Folder Listings operations. They include examples of asynchronous usage, along with progress bar updating. Most use the TransportConnection library to form the connection to the OBEX server. Some however manually create the connection.
License

Copyright me, free for any use.
-->
Save

Brecham Obex 1.6 release

Andy Hume — Thu, 18 Sep 2008 19:42:00 GMT

From the readme:

OBEX library — Readme

18^th September 2008 — release 1.6 (1.6.0918).

What’s new

For the full list of changes in the current and previous versions see the Changes document. In brief the changes in the core library in this version include:

Add option IgnoreBadDateFormats to ObexFolderListingParser, to allow it to continue even when the server provides invalid folder-listing content. For instance the LG K800 phone sometimes produces date values like modified="19800000T-90000" a negative time! See the Programmer’s Guide for more information.
Added ObexClientSession.PutFile which takes a pathname parameter of the file to send.
Add a Headers property to the ObexResponseException which lists the headers received along with the error response. (Note that the headers are currently discarded if the exception is runtime-serialized).

These are a few fixes and improvements to the sample programs.

Features

The library provides very broad client-side OBEX support, providing not just the ‘Put’ operation that most libraries and applications support, but also the complete set of operations: Connect, Put, Get, SetPath, Delete, and Abort. This is accessed through a session based interface. All errors communicating to the peer OBEX server are exposed to the calling application.

As well as the ‘on-the-wire’ protocol support there is also broad support for the objects defined in the OBEX specification, for instance the Folder Listing XML documents as used by the Folder-Browsing service. A full parser, returning an array of folder and file objects, is included

The library also provides access to its lower-level PDU (packet) creation and parsing facilities, enabling third-party implementation of any required features, for instance server-side operation, and perhaps even reliable-session support.

The library, its class documentation in both compiled HTML Help, and in raw XML for Intellisense, and a Programmer’s Guide are included.

Assemblies for both the FXv2 desktop and Compact Framework versions 1 and 2 are supplied.

Included sample code contains examples in both C# and VB.NET, showing how to use Put, Get, SetPath, and Folder Listings operations. They include examples of asynchronous usage, along with progress bar updating. Most use the TransportConnection library to form the connection to the OBEX server. Some however manually create the connection.

Brecham ObexServer r4 with GET support

Andy Hume — Tue, 17 Jun 2008 11:02:33 GMT

Note, this is the server-side library, for the main client-side distribution see http://32feet.net/files/folders/objectexchange/entry4355.aspx

From the readme:

An implementation of an OBEX Server using the Brecham.OBEX library.

Andy Hume, June 2008

In brief the changes in this version were to add GET and Folder Listings support, giving full OBEX Folder Browser service, i.e Bluetooth’s FTP profile. Tidying was done to the NETCF Forms app, the socket creation there, and also to server stop and PUT file opening in general.

Brecham ObexServer r3

Andy Hume — Mon, 10 Dec 2007 17:12:58 GMT

Note, this is the server-side library, for the main client-side distribution see http://32feet.net/files/folders/objectexchange/entry2428.aspx

From the readme:

An implementation of an OBEX Server using the Brecham.OBEX library.

Andy Hume, December 2007

This is a sample implementation of an OBEX Server using the Brecham.OBEX library. It includes the source for both the concrete implementation of a PUT / Inbox Server, as well as the implementation of base OBEX Server infrastructure. A sample command-line program is also included which writes the files it receives to disk, and can listen on Bluetooth, IrDA, or TCP/IP. A similar NETCF WinForms program is also included.

In brief the changes in this version were to set the Bluetooth Class-of-device bits correctly, improve the performance, and have an event called to open the PUT content stream rather that needing the overriding of a virtual method.

Brecham Obex 1.5 release

Andy Hume — Mon, 03 Dec 2007 16:39:26 GMT

From the readme:

OBEX library — Readme

3^rd December 2007 — release 1.5 (1.5.1203).

What’s new

For the full list of changes in the current and previous versions see the Changes document. In brief the changes in the core library in this version include:

Support for NETCFv1.

Support for Mono (http://www.mono-project.com/Main_Page), Mono version 1.2.6 is required for the library and samples to work fully.

Added a HasSize property to ObexFileOrFolderItem class, and thus to ObexFolderItem, and ObexFileItem classes. This allows one to know whether a size value was included in the folder-listing.

The ProtocolViolationException message when parsing an incorrectly formatted received PDU now reports information about the location of the fault, for example “Overrun PDU in parsing at index: 3, location: 'pre-header-bytes', pduLength: 3.”

A fix to workaround the bug in various servers where a connect response packet signalling an error is in a bad format (it doesn't contain the necessary connect bytes). We detect the short response when it has an error code and suppress the ProtocolViolationException in that case so that the ‘bad response code error’ can occur.

A fix to workaround the bug in the Widcomm servers, where a connect response packet signalling an error has zero in the maximum-packet-size field.

A fix to workaround the Widcomm Abort fault where it returns an illegal Final PDU. We now ignore any such invalid responses in that case.

Adding null Byte-Array headers disallowed.

These are also many fixes and improvements to the sample programs. They have also been updated to use version 2.2 of the InTheHand 32feet.NET library. Note that the NullReferenceException that would occur when attempting a Bluetooth connection on a CE/PPC device without the Microsoft Bluetooth stack was an issue in that library and has been fixed (their workitem 11744).

Features

The library provides very broad client-side OBEX support, providing not just the ‘Put’ operation that most libraries and applications support, but also the complete set of operations: Connect, Put, Get, SetPath, Delete, and Abort. This is accessed through a session based interface. All errors communicating to the peer OBEX server are exposed to the calling application.

As well as the ‘on-the-wire’ protocol support there is also broad support for the objects defined in the OBEX specification, for instance the Folder Listing XML documents as used by the Folder-Browsing service. A full parser, returning an array of folder and file objects, is included

The library also provides access to its lower-level PDU (packet) creation and parsing facilities, enabling third-party implementation of any required features, for instance server-side operation, and perhaps even reliable-session support.

The library, its class documentation in both compiled HTML Help, and in raw XML for Intellisense, and a Programmer’s Guide are included.

Assemblies for both the FXv2 desktop and Compact Framework versions 1 and 2 are supplied.

Included sample code contains examples in both C# and VB.NET, showing how to use Put, Get, SetPath, and Folder Listings operations. They include examples of asynchronous usage, along with progress bar updating. Most use the TransportConnection library to form the connection to the OBEX server. Some however manually create the connection.

The class documentation is also available online, at http://www.alanjmcf.me.uk/ThirdParty/Brecham.Obex%20library/ Thanks to Alan for hosting it for me.

TraceStream.zip

Andy Hume — Fri, 27 Jul 2007 13:42:07 GMT

Chart showing Server performance versus maximum packet size

Andy Hume — Fri, 29 Dec 2006 02:13:22 GMT

See http://32feet.net/forums/2574/ShowThread.aspx#2574

Brecham.Obex Beta 3 release

Andy Hume — Thu, 30 Nov 2006 20:43:39 GMT

As described in http://32feet.net/forums/2429/ShowThread.aspx#2429