PSLab iOS https://pslab.io
Repository for the PSLab iOS App for performing experiments with the Pocket Science Lab open-hardware platform.
This repository holds the iOS 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 https://pslab.io
| Feature | Description | Status | |------------------|-----------------------------------------------------------|------------------------------------------| | Home Screen | Show status and version of PSLab device | :negativesquaredcrossmark: | | Instruments | Exposes PSLab instruments like Oscilloscope, etc | :negativesquaredcrossmark: | | Oscilloscope | Shows variation of analog signals | :negativesquaredcrossmark: | | Multimeter | Measures voltage, current, resistance and capacitance | :negativesquaredcrossmark: | | Logical Analyzer | Captures and displays signals from digital system | :negativesquaredcrossmark: | | Wave Generator | Generates arbitrary analog and digital waveforms | :negativesquaredcrossmark: | | Power Source | Generates programmable voltage and currents | :negativesquaredcrossmark: | | Lux Meter | Measures the ambient light intensity | :negativesquaredcrossmark: |
Before you begin, you should already have the Xcode downloaded and set up correctly. You can find a guide on how to do this here: Setting up Xcode
Run
sudo gem install cocoapodsto install the latest version of cocoapods. To install cocoapods from HomeBrew,
brew install cocoapods.
Next, run
pod setupfor setting up cocoapods master repo. You may include
--verbosefor more descriptive logs. NOTE: This might take a while to setup depending on your network speed.
Download the pslab-iOS 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. OR
$ git clone https://github.com/fossasia/pslab-iOS.git
Navigate to the unzipped folder and run
pod install.
Open
Pslab.xcworkspacefrom the folder.
Build the project (⌘+B) and check for any errors.
Run the app (⌘+R).and test it.
To use PSLab device with iOS, you need to have the Apple Lightning connector. Connect PSLab device to iOS Phone via Lightning connector. Rest is handled by App itself.
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.
Fixes #
git squash?
As a tip for new developers those who struggle with squashing commits into one, multiple commits may appear in your pull request mostly due to following reasons.
git adding.
Despite any reason, follow the steps given below to squash all commits into one adhering to our best practices.
$ git remote add upstream https://github.com/fossasia/pslab-iOS.git
$ git checkout
$ git reset --soft upstream/development
$ git add
$ git commit -m "tag: commit message"
$ git push -f origin
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.
This project is currently licensed under the Apache License 2.0. A copy of LICENSE is to be present along with the source code. To obtain the software under a different license, please contact FOSSASIA.