spacecruft
/
pysalx
1
0
Fork 0
Code Issues 1 Pull Requests Projects Releases Wiki Activity
Unofficial scripts for interacting with the SciAps LIBS and XRF analyzers. https://spacecruft.org/spacecruft/pysalx
16 Commits
1 Branch
2 Tags
148 KiB
Shell 100%
 
Go to file
server ff7e9d2916 a scriptlet that doesn't backup 2022-01-20 19:10:02 -07:00
scripts a scriptlet that doesn't backup 2022-01-20 19:10:02 -07:00
.gitignore ignore tmp files 2022-01-20 17:43:42 -07:00
HARDWARE.md split out system notes 2022-01-20 18:26:04 -07:00
LICENSE pysalx - scripts for SciAps analyzers 2022-01-20 17:33:04 -07:00
NET.md backup extsd scriptlet, net notes 2022-01-20 19:04:24 -07:00
OS.md split out system notes 2022-01-20 18:26:04 -07:00
README.md list of scriptlets 2022-01-20 18:37:29 -07:00
SEC.md backup extsd scriptlet, net notes 2022-01-20 19:04:24 -07:00

README.md

pysalx

pysalx - scripts for interacting with the SciAps XRF and LIBS analyzers.

Installation

Tools to interact with the device are available in most free software oriented distributions, such as Debian.

Install on a Debian workstation (running as user debian, hostname workstation) example:

debian@workstation:~$ git clone https://spacecruft.org/spacecruft/pysalx
debian@workstation:~$ sudo apt update
debian@workstation:~$ sudo apt install adb
debian@workstation:~$ cd pysalx/

HOWTO

See ./scripts/ directory in this repo for current scripts. Current scripts:

  • pysalx-backup-sd --- Backup the SD card.
  • pysalx-install-deps --- Install script dependencies (initial setup).
  • pysalx-tail-log --- View the analyzer logfile in semi-real-time.

TODO HOWTOs

  • Connect to device.
  • Copy SD card data, such as samples and photos.
  • Mount device.
  • Initiate sampling remotely via USB and/or wifi.

Connect

You may need to set up permissions to access the device as non-root.

Run:

debian@workstation$ adb root
# If you don't have perms, something like:
debian@workstation:~$ sudo adb root

It should then say you are connected.

To see files, after connecting as show above. Examples (output not shown):

# See top level directory:
debian@workstation:~$ adb ls /

# See main sdcard where captured samples and photos are stored (main dir):
debian@workstation:~$ adb ls /storage/sdcard0/

To view debug logs in realtime:

debian@workstation:~$ adb shell tail -f /storage/sdcard0/ngl.log

SciAps Analyzers

In sum, they are Android-derived 64-bit ARM systems. So they interact with standard free software Android tools such as "Android Debug Bridge" (adb).

Equipment:

Z-903 LIBS Analyzer

X-555 XRF Analyzer

SciAps Resources

SciAps sites.

Unofficial

This repository, documentation and code is unofficial, unaffiliated with SciAps.

License

GPLv3+.

Copyright (C) 2022, Jeff Moe