Blueprint for Mobile Clients

We want clients on Mobile devices to be able to talk to Sahana Eden servers. They should have local storage for use completely offline & then be able to sync back to the server using whatever connectivity becomes available:

• SMS
  • compressed multi-part SMS to get maximal throughput
  • wiki:BluePrintMessagingModule#Micro-Syntax
  • forms should be updatable via SMS
• GPRS/3G
• WiFi
• BlueTooth
  • J2ME eedocs:
    • tbc
  • Python docs:
    • Intro: ​http://www.devshed.com/c/a/Python/Bluetooth-Programming-using-Python/
    • ​http://lightblue.sourceforge.net/
    • ​http://code.google.com/p/pybluez/

Using the open XForms standard means that we can support handsets using both Android & J2ME.

XForms editors(written in GWT, so includable in Eden as a simple HTML page):

• ​PurcForms - can import the output from our controller, powerful but not for non-techies!
  • ​Demo
• ​OX-Designer - more basic, but pretty. No import yet. Built for OpenMRS (which uses ODK)

XForms can be submitted using SMS by including the encoding format within the XForm so that client & server agree on the encoding:

• ​http://bitbucket.org/javarosa/javarosa/wiki/SMSSendingAPI

Android

​OpenDataKit have a suite of tools to use on Android.

• UserGuidelinesMobile - how to use ODK Collect with Sahana Eden
• Android Development Environment
• ​OpenRosa - joint project between ODK & JavaRosa

There are 2 APIs for sending SMS. 1 of which automatically splits up larger messages into multi-part SMS.

J2ME

Documentation on the current implementation is here: ​http://wiki.sahanafoundation.org/phase2/doku.php/dev:j2meclient

• This needs updating to the latest version of JavaRosa

JavaRosa is a fast-developing framework which uses XForms & ​J2MEPolish:

• ​http://code.javarosa.org

This supports using Mesh4j to do synchronisation via SMS:

• ​http://code.google.com/p/mesh4x/wiki/SMSAdapter

Alternatives

KUIX can be used to develop lightweight applications which work across may handhelds & forms can be customised easily via XML/CSS:

• ​http://www.kalmeo.org/projects/kuix

Old, un-maintained J2ME client for the PHP back-end, which just uses XML-RPC (=> requires Internet):

• ​http://wiki.sahanafoundation.org/doku.php?id=dev:sahana_mobile_intro

Other projects

• ​FrontlineSMS
  • FrontlineForms is a proprietary add-on for FrontlineSMS allowing a mobile Java client to connect to FrontlineSMS and share data with it.
• ​Global Relief Technologies

---

BluePrintMessagingModule

BluePrints