v3.5

FtcRobotController/src/main/AndroidManifest.xml

@@ -2,8 +2,8 @@
 <manifest xmlns:android="http://schemas.android.com/apk/res/android"
           xmlns:tools="http://schemas.android.com/tools"
           package="com.qualcomm.ftcrobotcontroller"
-          android:versionCode="24"
-          android:versionName="3.4">
+          android:versionCode="25"
+          android:versionName="3.5">
 
   <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
 

FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/internal/FtcRobotControllerActivity.java

@@ -216,6 +216,7 @@ protected void passReceivedUsbAttachmentsToEventLoop() {
   @Override
   protected void onCreate(Bundle savedInstanceState) {
     super.onCreate(savedInstanceState);
+    RobotLog.onApplicationStart();  // robustify against onCreate() following onDestroy() but using the same app instance, which apparently does happen
     RobotLog.vv(TAG, "onCreate()");
     ThemedActivity.appAppThemeToActivity(getTag(), this); // do this way instead of inherit to help AppInventor
 

README.md

@@ -42,14 +42,31 @@ For technical questions regarding the SDK, please visit the FTC Technology forum
       http://ftcforum.usfirst.org/forumdisplay.php?156-FTC-Technology
 
 
+**************************************************************************************
+# Release Information
+**************************************************************************************
+
+Version 3.5 (built on 17.10.30)
+
+Changes with version 3.5 include:
+ * Introduced a fix to prevent random op mode stops, which can occur after the Robot Controller app has been paused and then resumed (for example, when a user temporarily turns off the display of the Robot Controller phone, and then turns the screen back on).
+ * Introduced a fix to prevent random op mode stops, which were previously caused by random peer disconnect events on the Driver Station.
+ * Fixes issue where log files would be closed on pause of the RC or DS, but not re-opened upon resume.
+ * Fixes issue with battery handler (voltage) start/stop race.
+ * Fixes issue where Android Studio generated op modes would disappear from available list in certain situations.
+ * Fixes problem where OnBot Java would not build on REV Robotics Control Hub.
+ * Fixes problem where OnBot Java would not build if the date and time on the Robot Controller device was "rewound" (set to an earlier date/time).
+ * Improved error message on OnBot Java that occurs when renaming a file fails.
+ * Removed unneeded resources from android.jar binaries used by OnBot Java to reduce final size of Robot Controller app.
+ * Added MR_ANALOG_TOUCH_SENSOR block to Blocks Programming Tool.
 
 **************************************************************************************
 # Release Information
 **************************************************************************************
 
 Version 3.4 (built on 17.09.06)
 
-Changes with verion 3.4 include:
+Changes with version 3.4 include:
  * Added telemetry.update() statement for BlankLinearOpMode template.
  * Renamed sample Block op modes to be more consistent with Java samples.
  * Added some additional sample Block op modes.
@@ -86,7 +103,6 @@ Changes with verion 3.3 include:
 Known issues:
  * Android Studio
     - After updating to the new v3.3 Android Studio project folder, if you get error messages indicating "InvalidVirtualFileAccessException" then you might need to do a File->Invalidate Caches / Restart to clear the error.
-
  * OnBot Java
     - Sometimes when you push the build button to build all op modes, the RC returns an error message that the build failed.  If you press the build button a second time, the build typically suceeds.
 
@@ -184,8 +200,7 @@ Changes include:
     - Fixes bug with projects page for Firefox browser.
     - Added IsSpeaking block to AndroidTextToSpeech.  
  * Implements support for the REV Robotics Expansion Hub
-    - Implements support for integral REV IMU (physically installed on I2C bus 0, uses same Bosch BNO055 9 axis absolute orientation sensor as Adafruit 9DOF abs orientation sensor).
-    - Implements support for REV color/range/light sensor.
+    - Implements support for integral REV IMU (physically installed on I2C bus 0, uses same Bosch BNO055 9 axis absolute orientation sensor as Adafruit 9DOF abs orientation sensor).    - Implements support for REV color/range/light sensor.
     - Provides support to update Expansion Hub firmware through FTC SDK.
     - Detects REV firmware version and records in log file.
     - Includes support for REV Control Hub (note that the REV Control Hub is not yet approved for FTC use).

doc/javadoc/com/qualcomm/ftccommon/FtcEventLoopHandler.html

@@ -17,7 +17,7 @@
     catch(err) {
     }
 //-->
-var methods = {"i0":10,"i1":10,"i2":10,"i3":10,"i4":10,"i5":10,"i6":10,"i7":10,"i8":10,"i9":10,"i10":10,"i11":10,"i12":10,"i13":10,"i14":10};
+var methods = {"i0":10,"i1":10,"i2":10,"i3":10,"i4":10,"i5":10,"i6":10,"i7":10,"i8":10,"i9":10,"i10":10,"i11":10,"i12":10,"i13":10,"i14":10,"i15":10,"i16":10};
 var tabs = {65535:["t0","All Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"]};
 var altColor = "altColor";
 var rowColor = "rowColor";
@@ -242,68 +242,76 @@ <h3>Method Summary</h3>
 </tr>
 <tr id="i0" class="altColor">
 <td class="colFirst"><code>void</code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../com/qualcomm/ftccommon/FtcEventLoopHandler.html#closeAutoCloseOnTeardown--">closeAutoCloseOnTeardown</a></span>()</code>&nbsp;</td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../com/qualcomm/ftccommon/FtcEventLoopHandler.html#close--">close</a></span>()</code>&nbsp;</td>
 </tr>
 <tr id="i1" class="rowColor">
-<td class="colFirst"><code>void</code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../com/qualcomm/ftccommon/FtcEventLoopHandler.html#closeMotorControllers--">closeMotorControllers</a></span>()</code>&nbsp;</td>
+<td class="colFirst"><code>protected void</code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../com/qualcomm/ftccommon/FtcEventLoopHandler.html#closeAutoCloseOnTeardown--">closeAutoCloseOnTeardown</a></span>()</code>&nbsp;</td>
 </tr>
 <tr id="i2" class="altColor">
-<td class="colFirst"><code>void</code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../com/qualcomm/ftccommon/FtcEventLoopHandler.html#closeServoControllers--">closeServoControllers</a></span>()</code>&nbsp;</td>
+<td class="colFirst"><code>protected void</code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../com/qualcomm/ftccommon/FtcEventLoopHandler.html#closeBatteryMonitoring--">closeBatteryMonitoring</a></span>()</code>&nbsp;</td>
 </tr>
 <tr id="i3" class="rowColor">
+<td class="colFirst"><code>protected void</code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../com/qualcomm/ftccommon/FtcEventLoopHandler.html#closeMotorControllers--">closeMotorControllers</a></span>()</code>&nbsp;</td>
+</tr>
+<tr id="i4" class="altColor">
+<td class="colFirst"><code>protected void</code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../com/qualcomm/ftccommon/FtcEventLoopHandler.html#closeServoControllers--">closeServoControllers</a></span>()</code>&nbsp;</td>
+</tr>
+<tr id="i5" class="rowColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../com/qualcomm/ftccommon/FtcEventLoopHandler.html#displayGamePadInfo-java.lang.String-">displayGamePadInfo</a></span>(java.lang.String&nbsp;activeOpModeName)</code>&nbsp;</td>
 </tr>
-<tr id="i4" class="altColor">
+<tr id="i6" class="altColor">
 <td class="colFirst"><code><a href="../../../com/qualcomm/robotcore/eventloop/EventLoopManager.html" title="class in com.qualcomm.robotcore.eventloop">EventLoopManager</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../com/qualcomm/ftccommon/FtcEventLoopHandler.html#getEventLoopManager--">getEventLoopManager</a></span>()</code>&nbsp;</td>
 </tr>
-<tr id="i5" class="rowColor">
+<tr id="i7" class="rowColor">
 <td class="colFirst"><code>java.util.List&lt;LynxUsbDeviceImpl&gt;</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../com/qualcomm/ftccommon/FtcEventLoopHandler.html#getExtantLynxDeviceImpls--">getExtantLynxDeviceImpls</a></span>()</code>&nbsp;</td>
 </tr>
-<tr id="i6" class="altColor">
+<tr id="i8" class="altColor">
 <td class="colFirst"><code><a href="../../../com/qualcomm/robotcore/hardware/Gamepad.html" title="class in com.qualcomm.robotcore.hardware">Gamepad</a>[]</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../com/qualcomm/ftccommon/FtcEventLoopHandler.html#getGamepads--">getGamepads</a></span>()</code>&nbsp;</td>
 </tr>
-<tr id="i7" class="rowColor">
+<tr id="i9" class="rowColor">
 <td class="colFirst"><code><a href="../../../com/qualcomm/robotcore/hardware/HardwareMap.html" title="class in com.qualcomm.robotcore.hardware">HardwareMap</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../com/qualcomm/ftccommon/FtcEventLoopHandler.html#getHardwareMap--">getHardwareMap</a></span>()</code>&nbsp;</td>
 </tr>
-<tr id="i8" class="altColor">
+<tr id="i10" class="altColor">
 <td class="colFirst"><code>java.lang.String</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../com/qualcomm/ftccommon/FtcEventLoopHandler.html#getOpMode-java.lang.String-">getOpMode</a></span>(java.lang.String&nbsp;extra)</code>&nbsp;</td>
 </tr>
-<tr id="i9" class="rowColor">
+<tr id="i11" class="rowColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../com/qualcomm/ftccommon/FtcEventLoopHandler.html#init-com.qualcomm.robotcore.eventloop.EventLoopManager-">init</a></span>(<a href="../../../com/qualcomm/robotcore/eventloop/EventLoopManager.html" title="class in com.qualcomm.robotcore.eventloop">EventLoopManager</a>&nbsp;eventLoopManager)</code>&nbsp;</td>
 </tr>
-<tr id="i10" class="altColor">
+<tr id="i12" class="altColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../com/qualcomm/ftccommon/FtcEventLoopHandler.html#refreshUserTelemetry-TelemetryMessage-double-">refreshUserTelemetry</a></span>(TelemetryMessage&nbsp;telemetry,
                     double&nbsp;requestedInterval)</code>
 <div class="block">Updates the (indicated) user's telemetry: the telemetry is transmitted if a sufficient
  interval has passed since the last transmission.</div>
 </td>
 </tr>
-<tr id="i11" class="rowColor">
+<tr id="i13" class="rowColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../com/qualcomm/ftccommon/FtcEventLoopHandler.html#restartRobot--">restartRobot</a></span>()</code>&nbsp;</td>
 </tr>
-<tr id="i12" class="altColor">
+<tr id="i14" class="altColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../com/qualcomm/ftccommon/FtcEventLoopHandler.html#sendBatteryInfo--">sendBatteryInfo</a></span>()</code>
 <div class="block">Send robot phone power % and robot battery voltage level to Driver station</div>
 </td>
 </tr>
-<tr id="i13" class="rowColor">
+<tr id="i15" class="rowColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../com/qualcomm/ftccommon/FtcEventLoopHandler.html#sendTelemetry-java.lang.String-java.lang.String-">sendTelemetry</a></span>(java.lang.String&nbsp;tag,
              java.lang.String&nbsp;msg)</code>&nbsp;</td>
 </tr>
-<tr id="i14" class="altColor">
+<tr id="i16" class="altColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../com/qualcomm/ftccommon/FtcEventLoopHandler.html#updateBatteryStatus-BatteryChecker.BatteryStatus-">updateBatteryStatus</a></span>(BatteryChecker.BatteryStatus&nbsp;status)</code>&nbsp;</td>
 </tr>
@@ -546,6 +554,15 @@ <h4>init</h4>
 <pre>public&nbsp;void&nbsp;init(<a href="../../../com/qualcomm/robotcore/eventloop/EventLoopManager.html" title="class in com.qualcomm.robotcore.eventloop">EventLoopManager</a>&nbsp;eventLoopManager)</pre>
 </li>
 </ul>
+<a name="close--">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>close</h4>
+<pre>public&nbsp;void&nbsp;close()</pre>
+</li>
+</ul>
 <a name="getEventLoopManager--">
 <!--   -->
 </a>
@@ -646,7 +663,7 @@ <h4>sendTelemetry</h4>
 <ul class="blockList">
 <li class="blockList">
 <h4>closeMotorControllers</h4>
-<pre>public&nbsp;void&nbsp;closeMotorControllers()</pre>
+<pre>protected&nbsp;void&nbsp;closeMotorControllers()</pre>
 </li>
 </ul>
 <a name="closeServoControllers--">
@@ -655,7 +672,7 @@ <h4>closeMotorControllers</h4>
 <ul class="blockList">
 <li class="blockList">
 <h4>closeServoControllers</h4>
-<pre>public&nbsp;void&nbsp;closeServoControllers()</pre>
+<pre>protected&nbsp;void&nbsp;closeServoControllers()</pre>
 </li>
 </ul>
 <a name="closeAutoCloseOnTeardown--">
@@ -664,7 +681,16 @@ <h4>closeServoControllers</h4>
 <ul class="blockList">
 <li class="blockList">
 <h4>closeAutoCloseOnTeardown</h4>
-<pre>public&nbsp;void&nbsp;closeAutoCloseOnTeardown()</pre>
+<pre>protected&nbsp;void&nbsp;closeAutoCloseOnTeardown()</pre>
+</li>
+</ul>
+<a name="closeBatteryMonitoring--">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>closeBatteryMonitoring</h4>
+<pre>protected&nbsp;void&nbsp;closeBatteryMonitoring()</pre>
 </li>
 </ul>
 <a name="restartRobot--">

doc/javadoc/com/qualcomm/ftccommon/package-tree.html

@@ -148,12 +148,12 @@ <h2 title="Class Hierarchy">Class Hierarchy</h2>
 <li type="circle">com.qualcomm.ftccommon.<a href="../../../com/qualcomm/ftccommon/LaunchActivityConstantsList.html" title="class in com.qualcomm.ftccommon"><span class="typeNameLink">LaunchActivityConstantsList</span></a></li>
 <li type="circle">PreferenceFragment
 <ul>
-<li type="circle">com.qualcomm.ftccommon.<a href="../../../com/qualcomm/ftccommon/FtcRobotControllerSettingsActivity.SettingsFragment.html" title="class in com.qualcomm.ftccommon"><span class="typeNameLink">FtcRobotControllerSettingsActivity.SettingsFragment</span></a></li>
+<li type="circle">com.qualcomm.ftccommon.<a href="../../../com/qualcomm/ftccommon/FtcAdvancedRCSettingsActivity.SettingsFragment.html" title="class in com.qualcomm.ftccommon"><span class="typeNameLink">FtcAdvancedRCSettingsActivity.SettingsFragment</span></a></li>
 </ul>
 </li>
 <li type="circle">PreferenceFragment
 <ul>
-<li type="circle">com.qualcomm.ftccommon.<a href="../../../com/qualcomm/ftccommon/FtcAdvancedRCSettingsActivity.SettingsFragment.html" title="class in com.qualcomm.ftccommon"><span class="typeNameLink">FtcAdvancedRCSettingsActivity.SettingsFragment</span></a></li>
+<li type="circle">com.qualcomm.ftccommon.<a href="../../../com/qualcomm/ftccommon/FtcRobotControllerSettingsActivity.SettingsFragment.html" title="class in com.qualcomm.ftccommon"><span class="typeNameLink">FtcRobotControllerSettingsActivity.SettingsFragment</span></a></li>
 </ul>
 </li>
 <li type="circle">RobotCoreCommandList
@@ -170,32 +170,32 @@ <h2 title="Class Hierarchy">Class Hierarchy</h2>
 <li type="circle">com.qualcomm.ftccommon.<a href="../../../com/qualcomm/ftccommon/SoundPlayer.SoundInfo.html" title="class in com.qualcomm.ftccommon"><span class="typeNameLink">SoundPlayer.SoundInfo</span></a></li>
 <li type="circle">ThemedActivity
 <ul>
-<li type="circle">com.qualcomm.ftccommon.<a href="../../../com/qualcomm/ftccommon/AboutActivity.html" title="class in com.qualcomm.ftccommon"><span class="typeNameLink">AboutActivity</span></a></li>
+<li type="circle">com.qualcomm.ftccommon.<a href="../../../com/qualcomm/ftccommon/ConfigWifiDirectActivity.html" title="class in com.qualcomm.ftccommon"><span class="typeNameLink">ConfigWifiDirectActivity</span></a></li>
 </ul>
 </li>
 <li type="circle">ThemedActivity
 <ul>
-<li type="circle">com.qualcomm.ftccommon.<a href="../../../com/qualcomm/ftccommon/FtcLynxFirmwareUpdateActivity.html" title="class in com.qualcomm.ftccommon"><span class="typeNameLink">FtcLynxFirmwareUpdateActivity</span></a></li>
+<li type="circle">com.qualcomm.ftccommon.<a href="../../../com/qualcomm/ftccommon/FtcAdvancedRCSettingsActivity.html" title="class in com.qualcomm.ftccommon"><span class="typeNameLink">FtcAdvancedRCSettingsActivity</span></a></li>
 </ul>
 </li>
 <li type="circle">ThemedActivity
 <ul>
-<li type="circle">com.qualcomm.ftccommon.<a href="../../../com/qualcomm/ftccommon/FtcAdvancedRCSettingsActivity.html" title="class in com.qualcomm.ftccommon"><span class="typeNameLink">FtcAdvancedRCSettingsActivity</span></a></li>
+<li type="circle">com.qualcomm.ftccommon.<a href="../../../com/qualcomm/ftccommon/AboutActivity.html" title="class in com.qualcomm.ftccommon"><span class="typeNameLink">AboutActivity</span></a></li>
 </ul>
 </li>
 <li type="circle">ThemedActivity
 <ul>
-<li type="circle">com.qualcomm.ftccommon.<a href="../../../com/qualcomm/ftccommon/ViewLogsActivity.html" title="class in com.qualcomm.ftccommon"><span class="typeNameLink">ViewLogsActivity</span></a></li>
+<li type="circle">com.qualcomm.ftccommon.<a href="../../../com/qualcomm/ftccommon/FtcWifiDirectChannelSelectorActivity.html" title="class in com.qualcomm.ftccommon"><span class="typeNameLink">FtcWifiDirectChannelSelectorActivity</span></a></li>
 </ul>
 </li>
 <li type="circle">ThemedActivity
 <ul>
-<li type="circle">com.qualcomm.ftccommon.<a href="../../../com/qualcomm/ftccommon/FtcWifiDirectChannelSelectorActivity.html" title="class in com.qualcomm.ftccommon"><span class="typeNameLink">FtcWifiDirectChannelSelectorActivity</span></a></li>
+<li type="circle">com.qualcomm.ftccommon.<a href="../../../com/qualcomm/ftccommon/FtcRobotControllerSettingsActivity.html" title="class in com.qualcomm.ftccommon"><span class="typeNameLink">FtcRobotControllerSettingsActivity</span></a></li>
 </ul>
 </li>
 <li type="circle">ThemedActivity
 <ul>
-<li type="circle">com.qualcomm.ftccommon.<a href="../../../com/qualcomm/ftccommon/FtcRobotControllerSettingsActivity.html" title="class in com.qualcomm.ftccommon"><span class="typeNameLink">FtcRobotControllerSettingsActivity</span></a></li>
+<li type="circle">com.qualcomm.ftccommon.<a href="../../../com/qualcomm/ftccommon/FtcLynxFirmwareUpdateActivity.html" title="class in com.qualcomm.ftccommon"><span class="typeNameLink">FtcLynxFirmwareUpdateActivity</span></a></li>
 </ul>
 </li>
 <li type="circle">ThemedActivity
@@ -205,7 +205,7 @@ <h2 title="Class Hierarchy">Class Hierarchy</h2>
 </li>
 <li type="circle">ThemedActivity
 <ul>
-<li type="circle">com.qualcomm.ftccommon.<a href="../../../com/qualcomm/ftccommon/ConfigWifiDirectActivity.html" title="class in com.qualcomm.ftccommon"><span class="typeNameLink">ConfigWifiDirectActivity</span></a></li>
+<li type="circle">com.qualcomm.ftccommon.<a href="../../../com/qualcomm/ftccommon/ViewLogsActivity.html" title="class in com.qualcomm.ftccommon"><span class="typeNameLink">ViewLogsActivity</span></a></li>
 </ul>
 </li>
 <li type="circle">com.qualcomm.ftccommon.<a href="../../../com/qualcomm/ftccommon/UpdateUI.html" title="class in com.qualcomm.ftccommon"><span class="typeNameLink">UpdateUI</span></a></li>
@@ -227,8 +227,8 @@ <h2 title="Enum Hierarchy">Enum Hierarchy</h2>
 <ul>
 <li type="circle">java.lang.Enum&lt;E&gt; (implements java.lang.Comparable&lt;T&gt;, java.io.Serializable)
 <ul>
-<li type="circle">com.qualcomm.ftccommon.<a href="../../../com/qualcomm/ftccommon/ConfigWifiDirectActivity.Flag.html" title="enum in com.qualcomm.ftccommon"><span class="typeNameLink">ConfigWifiDirectActivity.Flag</span></a></li>
 <li type="circle">com.qualcomm.ftccommon.<a href="../../../com/qualcomm/ftccommon/LaunchActivityConstantsList.RequestCode.html" title="enum in com.qualcomm.ftccommon"><span class="typeNameLink">LaunchActivityConstantsList.RequestCode</span></a></li>
+<li type="circle">com.qualcomm.ftccommon.<a href="../../../com/qualcomm/ftccommon/ConfigWifiDirectActivity.Flag.html" title="enum in com.qualcomm.ftccommon"><span class="typeNameLink">ConfigWifiDirectActivity.Flag</span></a></li>
 </ul>
 </li>
 </ul>