pslab androidダウンロード - pslab androidソースコードダウンロード

pslab android

JAVAソースコード

PSLab Version 3.1.36

ダウンロード

PSLab Android アプリ

Pocket Science Lab オープンハードウェアプラットフォームで実験を実行するための PSLab Android アプリのリポジトリ。

このリポジトリには、PSLab で実験を実行するための Android アプリが保持されます。 PSLab は、科学や工学の実験を行うためのさまざまな機器を提供する小さなポケットサイエンスラボです。オシロスコープ、波形発生器、周波数カウンタ、プログラム可能な電圧および電流源のように機能し、またデータロガーとしても機能します。私たちのウェブサイトは https://pslab.io です。

ここからベータプログラムに参加して、最新のアップデートにサインアップし、新機能を早期にテストしてください。

Google Play で入手 F-Droid で入手

買う

Pocket Science Lab デバイスは FOSSASIA ショップから入手できます。
PSLab Web サイトにはさらに多くの再販業者がリストされています。

コミュニケーション

PSLab チャットチャネルは Gitter にあります。
PSLab メーリングリストにもぜひご参加ください。

ロードマップ

まず、Android アプリと PSLab 間の通信を機能させる必要があります。
アプリケーションを実装し、PSLab ハードウェア機能をユーザーに公開します。
ワイヤレス接続を実装する

スクリーンショット

ビデオデモ

PSLab Android アプリの概要。
PSLab デバイスを使用した音響波形の観察。
Pocket Science Lab を使用したリアルタイムのセンサーデータロギング
Pocket Science Lab を使用した波形の生成と観察

特徴

特徴	説明	状態
ホーム画面	PSLab デバイスのステータスとバージョンを表示する	✔️
楽器	オシロスコープなどの PSLab 機器を公開します	✔️
オシロスコープ	アナログ信号の変化を表示します	✔️
マルチメーター	電圧、電流、抵抗、静電容量を測定	✔️
ロジカルアナライザー	デジタルシステムからの信号をキャプチャして表示します	✔️
ウェーブジェネレーター	任意のアナログおよびデジタル波形を生成	✔️
電源	プログラム可能な電圧と電流を生成	✔️
照度計	周囲の光の強さを測定します	✔️
バロメーター	圧力を測定する	✔️
加速度計	デバイスの加速度を測定します	✔️
ジャイロメーター	回転速度を測定します	✔️
コンパス	地球の磁極に対する絶対回転を測定します。	✔️
温度計	周囲温度を測定します	✔️
ガスセンサー	NH3、NOx、アルコール、ベンゼン、煙、CO2 などのガスを検出	✔️
ロボットアームコントローラー	ロボットアームの4つのサーボモーターを独立して制御可能	✔️

開発環境で Android アプリをセットアップする方法

アプリケーションフレーバー

PSLab Android アプリケーションには 2 つのフレーバー (ビルドバリアント) があります。

Play ストアのフレーバー

Play ストアフレーバーは、Google マップを使用して、データロガーのログに保存された位置を表示します。

Fdroid フレーバー

Fdroid フレーバーは、Open Street Maps を使用して、データロガーのログに保存された位置を表示します。

開発セットアップ

始める前に、Android Studio SDK をダウンロードし、正しく設定しておく必要があります。これを行う方法についてのガイドは、ここで見つけることができます: Android Studio のセットアップ

Android プロジェクトのセットアップ

PSLab Android プロジェクトをセットアップするには、以下にリストされている 2 つの方法のいずれかを実行できます。つまり、リポジトリ zip ファイルをダウンロードするか、リポジトリを Android Studio に直接クローンすることができます。

zipファイルをダウンロードすることで

pslab-androidプロジェクトのソースをダウンロードします。これを行うには、リポジトリをフォークしてクローンを作成するか (変更をプッシュする予定がある場合に推奨)、ZIP ファイルとしてダウンロードして解凍します。
Android Studio を開くと、 「Android へようこそ」ウィンドウが表示されます。 [クイックスタート] で、[プロジェクトのインポート (Eclipse ADT、Gradle など)] を選択します。Wi-Fi 経由でデバッグするには、このブログに記載されている手順に従います。

注:独自のハードウェアを構築した場合は、CommunicationHandler.java の VendorID および/または ProductID を変更します。

直接クローン作成による

Android Studio を開くと、 「Android へようこそ」ウィンドウが表示されます。 [クイックスタート] で、[バージョン管理からプロジェクトをチェックアウト] を選択します。
表示されたドロップダウンメニューから git を選択します。
リポジトリに移動し、クローンまたはダウンロードボタンをクリックします。
表示されたドロップダウンからリンクをコピーします。
コピーしたURLを貼り付けて「クローン」を押します。
Android Studio は、gradle を使用してプロジェクトのビルドを開始するはずです。
このプロセスが完了して Android Studio が開いたら、コンソールでビルドエラーがないか確認してください。

注: 「... が見つかりませんでした」というタイトルの Gradle 同期エラーが表示された場合は、エラーメッセージの下にあるリンク (存在する場合) をクリックして、「不足しているプラットフォームをインストールしてプロジェクトを同期し、Android Studio を許可します」というメッセージを表示する必要があります。足りないものを持ってきてください。

すべてのビルドエラーが解決されたら、アプリをビルドしてテストする準備が整います。
アプリをビルドするには、 [ビルド] > [プロジェクトの作成]に移動します (または、ツールバーの [プロジェクトの作成] アイコンを押します)。
アプリが正常に構築された場合は、 [実行] > [アプリの実行] に移動するか、ツールバーの [実行] アイコンを押して、実際のデバイスまたはエミュレートされたデバイスで実行してテストできます。

apk のビルドのみが必要な場合は、[Build] > [apk のビルド] に移動すると、apk がビルドされ、apk が生成されるディレクトリが Android Studio によって要求されます。

PSLab デバイスは OTG ケーブルを介してマイクロ USB ポートに接続されているため、通常の方法ではデバッグできません。そのため、Android デバイスは USB ケーブルを介して PC に接続されていません。

Wi-Fi 経由でデバッグするには、このブログに記載されている手順に従います。

注:独自のハードウェアを構築した場合は、CommunicationHandler.java の VendorID および/または ProductID を変更します。

必要な権限

Record_Audio : オシロスコープが電話機の内蔵マイクからの入力を受け入れるために必要です。その実装は AudioJack.java にあります。
Access_Fine_Location と Internet : 地図上のデータにタグを付けるための座標を取得するためにルクスメーターとコンパスで使用するために必要です。その実装は GPSLogger.java にあります。
Write_External_Storage : 将来の分析のために転送できる機器からのログファイルを保存するために必要です。
Read_External_Storage : ストレージにログを書き込む際、CSVLogger.java はまず、この読み取り権限を必要とする CSVLogger ディレクトリが存在するかどうかを確認します。

Android アプリで PSLab を使用するためのセットアップ

Android で PSLab デバイスを使用するには、OTG ケーブル、USB ホスト機能が有効になっている Android デバイス (ほとんどの最新の携帯電話は OTG サポートを備えています)、および PSLab Android アプリが必要です。 OTG ケーブルを介して PSLab デバイスを Android Phone に接続します。残りはアプリ自体によって処理されます。

貢献のベストプラクティス

コードの実践

寄稿者だけでなくレビュー担当者にとっても容易になるように、ベストプラクティスに従うようご協力ください。私たちは、プルリクエストの倫理管理よりもコードの品質に重点を置きたいと考えています。

プルリクエストごとに 1 つのコミット。
コミットメッセージ内の課題番号を参照してください。パターンに従ってくださいFixes #<issue number> <commit message>
統一された設計慣行に従ってください。デザイン言語はアプリ全体で一貫している必要があります。
コミットが潰されるまで、プルリクエストはマージされません。 PR に複数のコミットがある場合、メンテナがスカッシュを選択してマージするのではなく、コミット作成者がそれらをスカッシュする必要があります。
PR がフロントエンドの変更に関連している場合は、プルリクエストの説明に関連するスクリーンショットを添付してください。

`git squash`はどうすればよいですか？

コミットを 1 つにまとめるのに苦労している新しい開発者向けのヒントとして、主に次の理由により、プルリクエストに複数のコミットが表示されることがあります。

git addだけを行わずに、変更のたびに複数のコミットメッセージを意図的に追加します。
マージコミットが行われるようにリモートで現在のブランチを更新します。

理由を問わず、以下の手順に従って、ベストプラクティスに準拠したすべてのコミットを 1 つにまとめてください。

前に設定されていない場合は、リモートを上流ブランチにセットアップします

$ git remote add upstream https://github.com/fossasia/pslab-android.git

プルリクエストに関連するブランチにチェックインする

$ git checkout <branch-name>

ソフトリセットを実行して変更を保持し、コミットの詳細をすべて削除します。

$ git reset --soft upstream/development

ステージング領域にファイルを追加する

$ git add <file paths or "." to add everything>

コミットメッセージのガイドラインに従って、適切なメッセージを含む新しいコミットを作成します。

$ git commit -m "tag: commit message"

すでにプルリクエストを行っている場合

$ git push -f origin <branch-name>

ブランチポリシー

弊社では以下の支店を設けております

開発すべての開発はこのブランチで行われます。貢献する場合は、開発にプルリクエストを行う必要があります。 Travis のビルドチェックに合格することを確認してください。
masterこれには安定したコードが含まれます。重要な機能/バグ修正が開発に蓄積された後、マスターに移行します。
apkこのブランチには、テスト用に自動生成された apk ファイルが含まれています。

コードスタイル

コードを作成して送信するときは、レビュー担当者や他の開発者が理解しやすくなるように、前述のガイドラインに従うようにしてください。

レイアウトファイルに名前を付けるときは、 activity_oscilloscope.xml 、 fragment_control_main.xmlのように、 (activity/fragment) _ (name).xml という規則に従っていることを確認してください。
レイアウトファイルで定義されているビューとウィジェットに、 (ビュータイプ/ウィジェット) _ (フラグメント/アクティビティ名) _ (ファイル内の番号) という名前を付けます ( spinner_channel_select_la1 、 button_activity_oscilloscope1など)。
レイアウトファイルに対応するアクティビティ/フラグメントファイル名は、レイアウトファイルfragment_channels_parameter.xmlに対応するChannelsParameterFragment.javaと同様に、 (アクティビティ/フラグメント名)(アクティビティ/フラグメント).java という名前にする必要があります。
アクティビティファイル内のボタン、テキストボックス、チェックボックスなどに対応するウィジェットは、 spinner_channel_select1に対応するspinnerChannelSelect1のように、(ビュータイプ/ウィジェット)(フラグメント/アクティビティ名)(ファイル内の番号) という名前にする必要があります。