pslab android

PSLab 안드로이드 앱

Pocket Science Lab 개방형 하드웨어 플랫폼으로 실험을 수행하기 위한 PSLab Android 앱용 저장소입니다.

이 저장소에는 PSLab으로 실험을 수행하기 위한 Android 앱이 보관되어 있습니다. PSLab은 과학 및 공학 실험을 수행하기 위한 다양한 장비를 제공하는 작은 휴대용 과학 실험실입니다. 오실로스코프, 파형 발생기, 주파수 카운터, 프로그래밍 가능한 전압 및 전류 소스와 같은 기능을 수행할 수 있으며 데이터 로거로도 사용할 수 있습니다. 저희 웹사이트는 https://pslab.io입니다.

여기에서 베타 프로그램에 참여하여 최신 업데이트에 등록하고 새로운 기능을 조기에 테스트해 보세요.

구입하다

• FOSSASIA Shop에서 Pocket Science Lab 장치를 구입할 수 있습니다.
• 더 많은 리셀러가 PSLab 웹사이트에 나열되어 있습니다.

의사소통

• 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가지 버전(빌드 변형)이 있습니다.

1. 플레이 스토어 맛

• Play 스토어 버전은 Google 지도를 사용하여 데이터 로거의 로그에 저장된 위치를 표시합니다.

2. Fdroid 맛

• Fdroid 플레이버는 Open Street Maps를 사용하여 데이터 로거의 로그에 저장된 위치를 표시합니다.

개발 설정

시작하기 전에 Android Studio SDK를 이미 다운로드하고 올바르게 설정해야 합니다. 이 작업을 수행하는 방법에 대한 가이드는 Android Studio 설정에서 찾을 수 있습니다.

안드로이드 프로젝트 설정

PSLab Android 프로젝트를 설정하려면 아래 나열된 두 가지 방법 중 하나를 따를 수 있습니다. 즉, 저장소 zip 파일을 다운로드하거나 저장소를 Android Studio에 직접 복제할 수 있습니다.

zip 파일을 다운로드하여

1. pslab-android 프로젝트 소스를 다운로드하세요. 저장소를 포크하고 복제하거나(변경 사항을 푸시하려는 경우 권장) ZIP 파일로 다운로드하고 추출하여 이 작업을 수행할 수 있습니다.

2. Android Studio를 열면 Welcome to Android 창이 표시됩니다. 빠른 시작에서 _Import Project(Eclipse ADT, Gradle 등)를 선택합니다. Wi-Fi를 통해 디버깅하려면 이 블로그에 제공된 단계를 따르세요.

• 참고: 자체 하드웨어를 구축한 경우 CommunicationHandler.java에서 VendorID 및/또는 ProductID를 변경하세요.

직접 복제를 통해

1. Android Studio를 열면 Welcome to Android 창이 표시됩니다. 빠른 시작에서 "버전 관리에서 프로젝트 체크아웃"을 선택합니다.
2. 나타나는 드롭다운 메뉴에서 git을 선택합니다.
3. 저장소로 이동하여 복제 또는 다운로드 버튼을 클릭하세요.
4. 표시된 드롭다운에서 링크를 복사하세요.
5. 복사한 URL을 붙여넣고 복제를 누르세요.
6. 이제 Android 스튜디오는 Gradle을 사용하여 프로젝트 빌드를 시작해야 합니다.
7. 이 프로세스가 완료되고 Android Studio가 열리면 콘솔에서 빌드 오류가 있는지 확인하세요.

• 참고: "...을 찾지 못했습니다"라는 제목의 Gradle 동기화 오류가 표시되면 누락된 플랫폼 및 프로젝트 동기화 설치 및 Android 스튜디오 허용이라는 오류 메시지(사용 가능한 경우) 아래의 링크를 클릭해야 합니다. 누락된 것을 가져오세요.

8. 모든 빌드 오류가 해결되면 앱을 빌드하고 테스트할 준비가 모두 완료되어야 합니다.
9. 앱을 빌드하려면 빌드>프로젝트 만들기 로 이동하세요(또는 도구 모음에서 프로젝트 만들기 아이콘을 누르세요).
10. 앱이 성공적으로 빌드된 경우 실행>'앱' 실행 으로 이동하거나 도구 모음에서 실행 아이콘을 눌러 실제 장치 또는 에뮬레이트된 장치에서 실행하여 테스트할 수 있습니다.

apk만 빌드하려면 Build>Build apk로 이동하면 apk가 빌드되고 apk가 생성되는 디렉터리가 Android Studio에서 프롬프트됩니다.

PSLab 장치는 OTG 케이블을 통해 마이크로 USB 포트에 연결되므로 일반적인 방법으로 디버깅할 수 없습니다. 따라서 Android 장치는 USB 케이블을 통해 PC에 연결되지 않습니다.

Wi-Fi를 통해 디버깅하려면 이 블로그에 제공된 단계를 따르세요.

• 참고: 자체 하드웨어를 구축한 경우 CommunicationHandler.java에서 VendorID 및/또는 ProductID를 변경하세요.

필요한 권한

1. Record_Audio : 오실로스코프가 휴대폰 내장 마이크의 입력을 받아들이는 데 필요합니다. AudioJack.java에서 해당 구현을 찾을 수 있습니다.
2. Access_Fine_Location 및 인터넷 : 지도에 데이터를 태그하기 위한 좌표를 얻기 위해 조도계 및 나침반에서 사용하는 데 필요합니다. GPSLogger.java에서 해당 구현을 찾을 수 있습니다.
3. Write_External_Storage : 향후 분석을 위해 전송할 수 있는 기기의 로그 파일을 저장하는 데 필요합니다.
4. Read_External_Storage : 저장소에 로그를 쓰는 동안 CSVLogger.java는 먼저 CSVLogger 디렉터리가 있는지 여부와 이 읽기 권한이 필요한지 확인합니다.

Android 앱에서 PSLab을 사용하도록 설정

Android에서 PSLab 장치를 사용하려면 OTG 케이블, USB 호스트 기능이 활성화된 Android 장치(대부분의 최신 휴대폰은 OTG 지원) 및 PSLab Android 앱이 필요합니다. OTG 케이블을 통해 PSLab 장치를 Android Phone에 연결합니다. 나머지는 앱 자체에서 처리됩니다.

기여 모범 사례

코드 관행

리뷰어와 기여자가 쉽게 사용할 수 있도록 모범 사례를 따를 수 있도록 도와주세요. 우리는 풀 리퀘스트 윤리 관리보다 코드 품질에 더 집중하고 싶습니다.

• 풀 요청당 단일 커밋.
• 커밋 메시지에서 문제 번호를 참조하세요. Fixes #<issue number> <commit message> 패턴을 따르세요.
• 통일된 디자인 관행을 따르십시오. 디자인 언어는 앱 전체에서 일관되어야 합니다.
• 풀 요청은 커밋이 압축되지 않는 한 병합되지 않습니다. PR에 여러 개의 커밋이 있는 경우 커밋 작성자는 이를 스쿼시해야 하며 관리자가 스쿼시를 선택하고 병합하는 것이 아닙니다.
• PR이 프런트 엔드 변경과 관련된 경우 풀 요청 설명에 관련 스크린샷을 첨부해 주세요.

git squash ?

커밋을 하나로 압축하는 데 어려움을 겪는 새로운 개발자를 위한 팁으로, 대부분 다음과 같은 이유로 풀 요청에 여러 커밋이 나타날 수 있습니다.

• git add ing 없이 각 변경 후에 의도적으로 여러 커밋 메시지를 추가합니다.
• 병합 커밋이 발생하도록 현재 분기를 원격으로 업데이트합니다.

어떤 이유에도 불구하고 아래 단계에 따라 모든 커밋을 모범 사례를 준수하는 하나로 압축하세요.

• 이전에 설정되지 않은 경우 업스트림 분기에 대한 원격 설정

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

• Pull Request와 관련된 Branch를 확인하세요.

$ git checkout <branch-name>

• 모든 커밋 세부 정보를 제거하면서 변경 사항을 유지하려면 소프트 재설정을 수행하세요.

$ git reset --soft upstream/development

• 준비 영역에 파일 추가

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

• 커밋 메시지 지침에 따라 적절한 메시지로 새 커밋을 만듭니다.

$ git commit -m "tag: commit message"

• 이미 pull 요청을 한 경우

$ 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 과 같이 (viewtype/widget) _ (fragment/activity name) _ (파일의 번호)로 지정합니다.
• 레이아웃 파일에 해당하는 액티비티/프래그먼트 파일 이름은 레이아웃 파일 fragment_channels_parameter.xml 에 해당하는 ChannelsParameterFragment.java 와 마찬가지로 (activity/fragment name)(activity/fragment).java 로 지정되어야 합니다.
• 활동 파일의 버튼, 텍스트 상자, 체크박스 등에 해당하는 위젯의 이름은 spinner_channel_select1 에 해당하는 spinnerChannelSelect1 과 같이 (viewtype/widget)(fragment/activity name)(파일의 번호)으로 지정되어야 합니다.

개발자

유지관리자

프로젝트는 다음에 의해 유지됩니다.

• 파드말(@CloudyPadmal)
• 마리오 벨링(@mariobehling)
• 로렌츠 거버(@lorenzgerber)
• 웨이 타트(@cweitat)
• 와이기에(@woshikie)

동문

• 닐 트리베디(@neel1998)
• 아카샨 간도트라(@akarshan96)
• 아시타바 사르카르(@asitava1998)
• 비벡 싱 바다우리아(@viveksb007)
• 아브지트(@Avjeet)
• 아비나브(@abhinavraj23)
• 가혹한 (@harsh-2711)
• 야트리(@yatri1609)

특허

이 프로젝트는 현재 Apache License 2.0에 따라 라이센스가 부여됩니다. 라이센스 사본은 소스 코드와 함께 제공됩니다. 다른 라이센스로 소프트웨어를 얻으려면 FOSSASIA에 문의하십시오.