Avimesa Gadget is a virtual device that can be run from the command line on a Linux-based device, like a Raspberry Pi for instance, or using Localhost. This allows developers to get started building Avimesa-based Industrial IoT projects without the need for an Avimesa 1000. You can also attach it to other Linux programs and processes using STDIN/STDOUT and named pipes. Primary uses include connecting to sensor processes and directly communicating with Avimesa Messages via a prompt.
Instructions to install and run Avimesa Gadget:
- Create Avimesa Account if you haven’t already.
- Download Avimesa Gadget and unzip the files.
man avmsagadgetto check if installed correctly and to view some instructions on how to use Gadget
avmsagadgetto begin using the Command Line Interface
- Use one of the
Authcodesfrom your Avimesa Account to send sample messages to our cloud
How to use Example:
- Open ExampleInput in a text editor and replace
<Enter Device ID Here>and
<Enter Authcode Here>with the
Authcodethat you want to use.
valin the JSON data above with values you’d want sensors to read between .004 and .02.
- On the command line run
avmsagadget < exampleInput
- This will run avmsagadget and pipe in, line by line, the inputs that you would normally type in. Using this format allows you to not have to manually type in a whole JSON.
You can run
man avmsagadgetto view the man page for Avimesa Gadget
To send a message you must have a valid DeviceID, Authentication Code, and our Valid JSON format (View the Example.json). You will want to change the “dev_id” key into your personal Dev_ID and change the channel data
valto 4-20mA ranges for whatever sensor data you would like to use. They should be within range
You can run Avimesa Gadget through CLI or through Pipe files
To view more information on how to run gadget, you can also run avmsagadget through CLI with
helpto see the commands available and how to use them.
When using the
stderrare redirected to the name you give with
-p. You must then open another terminal window and write to these named pipe files. To properly exit, you can write to the
namegiven.inpipe file the word
cat > namegiven.in exit
Avimesa Gadget is available as a free download.