fossasia/pslab-android

Name: pslab-android

Owner: FOSSASIA

Description: PSLab Android App https://github.com/fossasia/pslab-android/raw/apk/app-debug.apk

Created: 2017-03-28 16:03:15.0

Updated: 2018-05-23 18:06:31.0

Pushed: 2018-05-24 14:38:35.0

Homepage: http://pslab.fossasia.org

Size: 33476

Language: Java

GitHub Committers

Other Committers

README

pslab-android

PSLab Android App

<img alt="Get it on Google Play"
    height="80"
    src="https://play.google.com/intl/en_us/badges/images/generic/en_badge_web_generic.png" />

This repository holds the Android App for performing experiments with PSLab. PSLab is a tiny pocket science lab that provides an array of equipment for doing science and engineering experiments. It can function like an oscilloscope, waveform generator, frequency counter, programmable voltage and current source and also as a data logger. Our website is at http://pslab.fossasia.org

Communication

Please join us on the following channels:

• Pocket Science Channel
• Mailing List

Roadmap

• [x] First we need to get communication between Android App and PSLab working.
• [ ] Implement Applications and expose PSLab Hardware functionality to the user.
• [ ] Implement Functionality to Perform Experiment using PSLab Hardware Device.

Screenshots

Video Demo

• PSLab Android App Overview
• Observing Sound Waveforms Using PSLab Device
• Real-time Sensor Data Logging Using Pocket Science Lab
• Generating and Observing Waveforms Using Pocket Science Lab

Features

Feature|Description|Status —–|—–|—– Home Screen|Show status and version of PSLab device|Established Application|Exposes PSLab application like Oscilloscope, etc |Established |Oscilloscope |Shows variation of analog signals | Established |Control |Generate waveforms and PWM signals. Control voltage and current sources and read results from a variety of electric components | Established |Logical Analyzer |Captures and displays signals from digital system | Working |Data Sensor Logger |Scans sensors connected to PSLab Device and provides an interface to see and log real-time data | Working |Sensor Quick View |Scans all the sensors connected to PSLab Device and visualize real-time data | Established |Settings |Enable Auto-Start | |Saved Experiments |Access Pre-defined and Designed Experiments | Working |Design Experiments |To Design our own experiments |

How to set up the Android app in your development environment

Development Setup

Before you begin, you should already have the Android Studio SDK downloaded and set up correctly. You can find a guide on how to do this here: Setting up Android Studio

Setting up the Android Project

1. Download the pslab-android project source. You can do this either by forking and cloning the repository (recommended if you plan on pushing changes) or by downloading it as a ZIP file and extracting it.

2. Open Android Studio, you will see a Welcome to Android window. Under Quick Start, select Import Project (Eclipse ADT, Gradle, etc.)

3. Navigate to the directory where you saved the pslab-android project, select the “pslab-android” folder, and hit OK. Android Studio should now begin building the project with Gradle.

4. Once this process is complete and Android Studio opens, check the Console for any build errors.

5. Note: If you receive a Gradle sync error titled, “failed to find …“, you should click on the link below the error message (if available) that says Install missing platform(s) and sync project and allow Android studio to fetch you what is missing.

6. Once all build errors have been resolved, you should be all set to build the app and test it.

7. To Build the app, go to Build>Make Project (or alternatively press the Make Project icon in the toolbar).

8. If the app was built successfully, you can test it by running it on either a real device or an emulated one by going to Run>Run 'app' or pressing the Run icon in the toolbar.

If you want build apk only, go to Build>Build apk and apk would be build and directory where apk is generated would be prompted by Android Studio.

You can't debug the usual way as PSLab device is connected to micro-USB port through OTG cable. So Android Device is not connected to PC through USB cable.

To debug over Wi-Fi: http://blog.fossasia.org/android-app-debugging-over-wifi-for-pslab/

Note :

1. If you built your own hardware, change VendorID and/or ProductID in CommunicationHandler.java

Setup to use PSLab with Android App

To use PSLab device with Android, you simply need an OTG cable, an Android Device with USB Host feature enabled ( most modern phones have OTG support ) and PSLab Android App. Connect PSLab device to Android Phone via OTG cable. Rest is handled by App itself.

Contributions Best Practices

Code practices

Please help us follow the best practice to make it easy for the reviewer as well as the contributor. We want to focus on the code quality more than on managing pull request ethics.

• Single commit per pull request
• Reference the issue numbers in the commit message. Follow the pattern ` Fixes #<issue number> <commit message>`
• Follow uniform design practices. The design language must be consistent throughout the app.
• The pull request will not get merged until and unless the commits are squashed. In case there are multiple commits on the PR, the commit author needs to squash them and not the maintainers cherrypicking and merging squashes.
• If the PR is related to any front end change, please attach relevant screenshots in the pull request description.

Branch Policy

We have the following branches

• development All development goes on in this branch. If you're making a contribution, you are supposed to make a pull request to development. Make sure it passes a build check on Travis.

• master This contains the stable code. After significant features/bugfixes are accumulated on development, we move it to master.

• apk This branch contains automatically generated apk file for testing.

Code style

Please try to follow the mentioned guidelines while writing and submitting your code as it makes easier for the reviewer and other developers to understand.

• While naming the layout files, ensure that the convention followed is (activity/fragment) _ (name).xml like `activity_oscilloscope.xml, ``fragment_control_main.xml``` .
• Name the views and widgets defined in the layout files as (viewtype/widget) (fragment/activity name) (no. in the file) like `spinner_channel_select_la1, ``button_activity_oscilloscope1``` .
• The activity/fragment file name corresponding to the layout files should be named as (activity/fragment name)(activity/fragment).java like `ChannelsParameterFragment.javacorresponding to the layout file ``fragment_channels_parameter.xml``` .
• The corresponding widgets for buttons, textboxes, checkboxes etc. in activity files should be named as (viewtype/widget)(fragment/activity name)(no. in the file) like `spinnerChannelSelect1corresponding to ``spinner_channel_select1``` .

License

This project is currently licensed under the GNU General Public License v3. A copy of LICENSE is to be present along with the source code. To obtain the software under a different license, please contact FOSSASIA.

Maintainers

The project is maintained by

• Praveen Patil (@wavicles)
• Mario Behling (@mariobehling)
• Lorenz Gerber (@lorenzgerber)
• Jithin (@jithinbp)
• Akarshan Gandotra (@akarshan96), Asitava Sarkar (@asitava1998), Padmal (@CloudyPadmal), Vivek Singh Bhadauria (@viveksb007)