Robot Systems Learning Kit

This is a free Android app that can be used to control the ASEE version of Lab 19 running on the RSLK robot using Bluetooth Low Energy (BLE).

There are 4 services. The RSLK Service is the one that interacts with the robot. The RSLK service has 4 characteristics with which you can interact.

Jacki command (R/W, 0=halt, 1=go, 2=back, 3=left, 4=right)
Bump switches (Read only, 6 bits, 1=crash)
Jacki speed (R/W, sets duty cycle for each motor 0 to 14998)
Jacki sensors (Read only, switches, 3 IR sensors, and command)

The Robot Control mode provides an easy to use access to the characteristics.

This application collects no personal data, but does require Bluetooth 4.1, an RSLK advanced robot with CC2650, and the ASEE 2018 software project running on the MSP432. This app is provided for free. The application was derived from the BluetoothLeGatt example project on the Android Studio developer web site, so the chances of it being malicious are low. However, since this is my first Android app, the chances are quite high that there are bugs.

Download the application on an Android.

Download the rslk.apk file version 1.0.
Open your downloads folder and install rslk.apk.
Turn on an ASEE robot and start Lab 19.
Start the rslk app and see the ASEE robot. You will have to grant BLE permissions to the app,

Troubleshooting

You will have to change settings to allow download from unknown sources (set it back after installing)
Bluetooth needs to be on
Location services need to be on, and you may have to manually grant permissions for rslk to access location services
If the app stops, restart the app, or restart both the robot and the app

Configuring RSLK to run the ASEE project

You will need to complete Lab 1 on the RSLK curriculum. This will install CCS, TExaSdisplay, and the RSLK starter projects.
You will need to complete contruction of the advanced RSLK kit (you will not need the CC3120 wifi module)
Download and unzip this ASEE CCS project.
Place the folder with the other CCS projects unpacked in step 1 above. Make sure the 7 jumpers are in place when programming the RSLK. Import this new project, build, and debug. Make sure the 7 jumpers are removed when the USB cable is disconnected from the computer

Download the source code for the RSLK Android app.

Install the Android Studio programming environment
Download the android_BLE_RSLK_release_June21_2018.zip file version 1.0.
Unzip the android_BLE_RSLK_release_June21_2018.zip file
Open the project in Android Studio
This was my first app, so I am sure there are bugs. You are free to use my code however you wish; there is a license associated with the BluetoothLeGatt example from which this app was derived.

Volume 1, Introduction to the MSP432 Microcontroller (2nd edition, 1st printing- December 2017) and Volume 2, Real-Time Interfacing to the MSP432 Microcontroller (second edition, 1st printing- June 2018), 2015, ISBN: 978-1512185676, and 978-1514676585 Volume 1 from Amazon Volume 2 from Amazon, Volume 1 includes architecture, assembly language and C programming for the Texas Instruments MSP432. Volume2 includes interfacing, circuits, real-time systems and the internet of Things (IoT).

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Send comments to: Jonathan W. Valvano , Go to Home