Merge branch 'release/0.2.0'

Author: Daisuke Baba

.classpath

@@ -1,4 +1,6 @@
 target
 tmp
 .idea
-*.iml
+*.iml
+libs/com/hoho/usb-serial-for-android/ccc8e8d
+libs/com/hoho/usb-serial-for-android/b96f9ca

.gitignore

@@ -1,18 +1,24 @@
 # AndroidSerial for Processing
 
+[![GitHub release](https://img.shields.io/github/release/inventit/processing-android-serial.svg)](https://github.com/inventit/processing-android-serial/releases/latest)
+[![master Build Status](https://travis-ci.org/inventit/processing-android-serial.svg?branch=master)](https://travis-ci.org/inventit/processing-android-serial/)
+[![License MIT](https://img.shields.io/github/license/inventit/processing-android-serial.svg)](http://opensource.org/licenses/MIT)
+
 This is a Processing-for-Android library offering the serial communication.
 
-This library works on Android 3.1 or later since it uses Android USB Host API.
+This library works on Android 5.0 or later since it uses Android USB Host API.
 
-This library also includes [usb-serial-for-android](https://code.google.com/p/usb-serial-for-android/downloads/list) containing FTDI serial driver and USB CDC/ACM serial driver (for Arduino). The library still has some issues and also has bunch of improvements according to the google code site. I will update the library when the newer version is released.
+This library also includes [usb-serial-for-android](https://github.com/mik3y/usb-serial-for-android) containing FTDI serial driver and USB CDC/ACM serial driver working on Android. Since the project creates only AAR file by default, there is a shell script, `update_libs.sh`, to extract a jar file from the built AAR file. Use the script when you require the other revision of the project binary.
 
 Note that this version is alpha release.
 
 ## How to use
 
-Build the source code (see below) or download a binary from [our SourceForge project page](https://sourceforge.net/projects/procandser/).
+Build the source code (see below) or download a binary from [the release page](https://github.com/inventit/processing-android-serial/releases).
+
+Unzip `AndroidSerial-distribution.zip` and copy all files including `AndroidSerial` directory to your `libraries` folder (e.g. `~/Documents/Processing/libraries`).
 
-Unzip `AndroidSerial-distribution.zip` and copy all files including `AndroidSerial` directory to your `library` folder (e.g. `~/Documents/Processing/library`).
+If you already install the older version of `AndroidSerial` library, remove it prior to copying the new one.
 
 The usage of the library is almost same as [processing.serial.Serial](http://processing.org/reference/libraries/serial/Serial.html) library.
 
@@ -32,33 +38,40 @@ Other methods in processing.serial.Serial class should work without any changes.
 
 You can get a working example from the [sparkfun's pulse sensor SEN-11574](https://www.sparkfun.com/products/11574).
 
- 1. Install Android SDK Platform 10 as well as Android 3.1 or later (I tried Android SDK Platform 16 Rev. 4, SDK Platform Tools Rev. 16.0.2, SDK Tools Rev. 22, and Processing 2.0)
+ 1. Install Android SDK Platform 23 or higher as well as Android SDK Tools and Android SDK Platform-tools or later (I tried Android SDK Platform 23/24, SDK Platform Tools 24.0.3, SDK Tools 25.2.2, and Processing 3.2.1)
  1. Install Android mode on your Processing environment
+ 1. Install this library (Unzip `AndroidSerial-distribution.zip` and copy all files including `AndroidSerial` directory to your `libraries` folder (e.g. `~/Documents/Processing/libraries`))
  1. Go to the [page](https://www.sparkfun.com/products/11574)
  1. Download the Processing sketch from `Documents` section
- 1. Open the downloaded sketch
- 1. Modify the code as below
+ 1. Open the downloaded Processing sketch (not Arduino)
+ 1. On the Processing IDE, choose `Sketch` -> `Import Library` -> `Android Serial Library for Processing` (This will insert `import io.inventit.processing.android.serial.*;`)
+ 1. Modify the code as below (see [here](https://github.com/WorldFamousElectronics/PulseSensor_Amped_Processing_Visualizer/blob/pr/1/PulseSensorAmpd_Processing_1dot1/PulseSensorAmpd_Processing_1dot1.pde) for the source code available at the sparkfun site)
 
-        L60: println(Serial.list());    // print a list of available serial ports
+        L9: // import processing.serial.*; // comment out
+        L57: println(Serial.list());    // print a list of available serial ports
                      | (add `this`)
                      v
-        L60: println(Serial.list(this));    // print a list of available serial ports
+        L57: println(Serial.list(this));    // print a list of available serial ports
 
-        L62: port = new Serial(this, Serial.list()[0], 19200);  // make sure Arduino is talking serial at this baud rate
+        L61: port = new Serial(this, Serial.list()[0], 115200);  // make sure Arduino is talking serial at this baud rate
                      | (add `this`)
                      v
-	    L62: port = new Serial(this, Serial.list(this)[0], 19200);  // make sure Arduino is talking serial at this baud rate
+	    L61: port = new Serial(this, Serial.list(this)[0], 115200);  // make sure Arduino is talking serial at this baud rate
 
- 1. Please make sure that you need to check and modigy the index of `Serial.list(this)` at the line 62 in order to specify the valid port name
+ 1. Please make sure that you need to check and modify the index of `Serial.list(this)` at the line 62 in order to specify the valid port name
  1. Create `res/xml` directories under the opened sketch directory (e.g. `~/Documents/Processing/PulseSensorAmpd_Processing_1dot1`)
  1. Copy `examples/PulseSensor11574/res/xml/device_fileter.xml` to the created directory (e.g. `~/Documents/Processing/PulseSensorAmpd_Processing_1dot1/res/xml`)
  1. Copy `examples/PulseSensor11574/AndroidManifest.xml` to the opened sketch directory (e.g. `~/Documents/Processing/PulseSensorAmpd_Processing_1dot1`)
- 1. Connect your Android 3.1+ device to your computer and Run the code
+ 1. Connect your Android device to your computer and Run the code
  1. The application may report `Unexpected error` on your Android screen but you can ignore it (tap `OK`)
  1. Disconnect the Android device from the computer and connect your FTDI device or Arduino to the Android device with USB cable
  1. Android asks you to choose an application to launch, then choose your application (e.g. `PulseSensorAmpd_Processing_1dot1`)
  1. Finally, you will see the same screen as your computer!
 
+** Screenshot  on Galaxy J **
+
+![Galaxy J Screenshot](images/Galaxy_J_Screenshot.jpg)
+
 ## How to build
 
 You can build the project source code though you can download the built binary from [our SourceForge project page](https://sourceforge.net/projects/procandser/).
@@ -67,6 +80,7 @@ Prior to building the project, you need to install the following software:
 
  1. JDK 6+ (Any JDK will be available)
  1. [Apache Maven](http://maven.apache.org/) (Choose the latest one if possible)
+ 1. [Gradle](https://gradle.org) is required if you run `update_libs.sh`, which downloads and builds the other revision of `usb-serial-for-android` source code than `b96f9ca`
 
 Then run the following command under the root of the project:
 
@@ -77,15 +91,15 @@ And you can find the artifact file named `AndroidSerial-distribution.zip` at `ta
 ## Directory Structure
 The directory structure of this application is as follows:
 
-    |-- .settings (E)
+    |-- images
     |-- libs
     |   |-- processing
     |   |   `-- android-core
-    |   |       `-- 2.0
+    |   |       `-- android-mode-0252
     |   `-- com
     |       `-- hoho
     |           `-- usb-serial-for-android
-    |               `-- v010
+    |               `-- b96f9ca
     |-- src
     |   |-- main
     |   |   |-- assembly
@@ -99,14 +113,13 @@ The directory structure of this application is as follows:
     |       |-- java
     |       `-- resources
 
-(E) Eclipse specific setting files
 (X) is a working example for Sparkfun's Pulse Sensor SEN-11574
 
 ## Source Code License
 
 All program source codes are available under the MIT style License.
 
-Copyright (c) 2013 Inventit Inc.
+Copyright (c) 2016 Inventit Inc.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 
@@ -123,12 +136,14 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
  * [Robolectric](https://github.com/robolectric/robolectric/) ... Android testing library (TEST USE ONLY)
  * [Mockito](https://code.google.com/p/mockito/) ... Mock testing library (TEST USE ONLY)
 
-## Known Issues
+## Change History
 
- * Unexpected error occurs when the sketch is compiled and installed into a device
- * The current version of [usb-serial-for-android](https://code.google.com/p/usb-serial-for-android/) has several issues regarding data reading. If `java.io.IOException: Expected at least 2 bytes` is observed, please wait a moment or try to re-connect the cable though the trunk version of the driver is already fixed
+0.2.0 : September 23, 2016
 
-## Change History
+ * Rename package to `io.inventit.processing.android.serial`
+ * Processing 3.2 support
+ * Use the latest version of [usb-serial-for-android](https://github.com/mik3y/usb-serial-for-android)
+ * Android Mode 0252 support
 
 0.1.0-alpha : February 29, 2016
 

.project

@@ -10,13 +10,13 @@ authorList = [Daisuke Baba](https://github.com/dbaba)
 url = https://github.com/inventit/processing-android-serial
 
 # The category of your library, must be one (or many) of the following:
-#   "3D"            "Animation"     "Compilations"      "Data"          
-#   "Fabrication"   "Geometry"      "GUI"               "Hardware"      
-#   "I/O"           "Language"      "Math"              "Simulation"    
-#   "Sound"         "Utilities"     "Typography"        "Video & Vision"  
-# 
+#   "3D"            "Animation"     "Compilations"      "Data"
+#   "Fabrication"   "Geometry"      "GUI"               "Hardware"
+#   "I/O"           "Language"      "Math"              "Simulation"
+#   "Sound"         "Utilities"     "Typography"        "Video & Vision"
+#
 # If a value other than those listed is used, your library will listed as "Other."
-category = Hardware
+category = I/O
 
 # A short sentence (or fragment) to summarize the library's function. This will be
 # shown from inside the PDE when the library is being installed. Avoid repeating
@@ -29,7 +29,7 @@ sentence = Android Serial Library
 # 'sentence' always will be prepended, so you should start by writing the
 # second sentence here. If your library only works on certain operating systems,
 # mention it here.
-paragraph = This library works on Android 3.1 or later.
+paragraph = This library works on Android 5.0 or later.
 
 # Links in the 'sentence' and 'paragraph' attributes can be inserted using the
 # same syntax as for authors. That is, [here is a link to Processing](http://processing.org/)
@@ -42,4 +42,4 @@ paragraph = This library works on Android 3.1 or later.
 version = 3
 
 # The version as the user will see it. If blank, the version attribute will be used here
-prettyVersion = 0.1.0-alpha
+prettyVersion = 0.2.0

.settings/org.eclipse.jdt.core.prefs

@@ -2,8 +2,8 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>com.hoho</groupId>
   <artifactId>usb-serial-for-android</artifactId>
-  <version>v010</version>
+  <version>b96f9ca</version>
   <url>https://code.google.com/p/usb-serial-for-android/</url>
   <description>GNU Lesser GPL</description>
   <name>USB Serial Driver for Android</name>
-</project>
+</project>