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
22 Commits
1 Branch
2 Tags
148 KiB
Shell 100%
 
Go to file
server 4c733fbece pysalx-date-set 2022-01-20 21:50:12 -07:00
doc doc/ 2022-01-20 20:11:17 -07:00
scripts Set time on analyzer based on workstation's time 2022-01-20 21:48:00 -07:00
.gitignore ignore tmp files 2022-01-20 17:43:42 -07:00
LICENSE pysalx - scripts for SciAps analyzers 2022-01-20 17:33:04 -07:00
README.md pysalx-date-set 2022-01-20 21:50:12 -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-export --- Backup the export directory, with spectra from templates.
  • pysalx-backup-extsd --- Backup the ext SD card.
  • pysalx-backup-fs --- Backup whole file system. Not yet.
  • pysalx-backup-sd --- Backup the SD card.
  • pysalx-date-set --- Set time/date on analyzer using workstation's time.
  • 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.

Usage

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

Notes

See more notes in the doc/ directory.

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