Install Poststation

Currently, the only way to obtain the Poststation executables is to Contact OneVariable for early access.

MacOS

You should have received a file named poststation-aarch64-apple-darwin-signed.zip.

You can unzip this file in the Finder, or run:

unzip poststation-aarch64-apple-darwin-signed.zip

This contains an application package called Poststation.app. This folder contains the following contents:

Poststation.app/
Poststation.app/Contents/
Poststation.app/Contents/_CodeSignature/
Poststation.app/Contents/MacOS/
Poststation.app/Contents/Info.plist
Poststation.app/Contents/_CodeSignature/CodeResources
Poststation.app/Contents/MacOS/poststation

This is a signed package, and is a command line executable. You can launch the application on the command line:

$ ./Poststation.app/Contents/MacOS/poststation

MacOS does not require any additional steps for permissions.

Linux

You should have received one of the following files:

  • poststation-aarch64-unknown-linux-musl.zip
    • This will work on 64-bit ARM linux targets, including the newer Raspberry Pi devices
    • You can extract the contents with unzip poststation-aarch64-unknown-linux-musl.zip
  • poststation-x86_64-unknown-linux-gnu.tar.xz
    • This will work on 64-bit AMD/Intel linux targets, including most desktop/laptop systems
    • You can extract the contents with tar xf poststation-x86_64-unknown-linux-gnu.tar.xz

These archives will contain a single binary called poststation. This can be executed on the command line:

./poststation

udev rules

Depending on the devices you are using, you may need to add udev rules for the VID and PID of connected devices, in order to allow access to connected USB devices. It is NOT recommended to run poststation as a root user or with sudo.

You may need to repeat this process for each new device!

The following udev rules file is usable for the examples provided in the poststation-util repository, which uses the USB VID 16c0, and the USB PID 27dd:

# These rules are based on the udev rules from the OpenOCD + probe.rs projects
#
# This file is available under the GNU General Public License v2.0
#
# SETUP INSTRUCTIONS:
#
# 1. Copy/write/update this file to `/etc/udev/rules.d/60-poststation.rules`
# 2. Run `sudo udevadm control --reload` to ensure the new rules are used
# 3. Run `sudo udevadm trigger` to ensure the new rules are applied to already added devices.

ACTION!="add|change", GOTO="poststation_rules_end"
SUBSYSTEM!="usb|tty|hidraw", GOTO="poststation_rules_end"

# Default demos from poststation - 16c0:27dd
ATTRS{idVendor}=="16c0", ATTRS{idProduct}=="27dd", MODE="660", GROUP="plugdev", TAG+="uaccess"

# You can add addtional rules here if your devices use different VID:PID pairs
# ATTRS{idVendor}=="xxxx", ATTRS{idProduct}=="xxxx", MODE="660", GROUP="plugdev", TAG+="uaccess"

LABEL="poststation_rules_end"

Windows

You should have received a file called poststation-x86_64-pc-windows-msvc.zip.

You can unzip this in the file explorer. This contains a single file, poststation.exe.

You can run this on the command line:

poststation.exe

Permissions

TODO: I don't think that windows needs any additional permissions for this? If you have issues then please open an issue!