[DSF Extension] Exec On MCode (was: Shutdown SBC)

wilriker

Release v2.1

This release provides parameter substitution. Please see the below for details on how to use it.

It can be found at the GitHub Releases page.

Parameters

execonmcode does provide a simple mechanism for parameter substitution. It is possible to pass string parameters to the
selected M-Code and have them inserted in the -command. In the command string they have to be single letters prefixed by
the percent-sign (%) and they must not be G, M or T.

All parameters that do not have a corresponding value in the M-Code will be forwarded as given.

Example

Run execonmcode as

$ ./execonmcode -command "mycommand %F %N %D"

Then you can use the following M-Code syntax to replace these parameters

M7722 F"my first parameter" N"my second parameter"

this will lead to an execution of

mycommand "my first parameter" "my second parameter" %D

Note that %D was passed as is since it was not given in the M-Code.

wilriker

Release v2.1.1

This is just a bug fix release to address a bug where too many (empty) parameters where introduced in between the command and it's actual parameters. This could lead to various problems.

As usual it can be found at GitHub Releases page.

Thanks to @too for reporting this.

wilriker

Just as a short teaser: the upcoming version will allow an arbitrary amount of M-code+command pairs.

tobias_munich

great Job !! many thanks.
exactly what I looked for

Tobias

wilriker

Release v3.0

This release adds the possibility to provide an arbitrary amount of -mCode + -command tuples. This way it is possible to have a single instance of execonmcode handle all the custom commands.

Note that as part of this change there is no longer a default value for -mCode.

Get it at GitHub Releases page.

EDIT: This version is built agains goduetapiclient 1.2.0 and as such will only work with DSF 1.2.2.1 and later. In case you need a version that is working with DSF <= 1.2.2.0 please tell me here. It's not a problem to provide that as well.

gtj0

@wilriker I can't believe I missed this whole thread! Gonna give it a try tomorrow.

I'm also working on something to allow the SBC to do a hardware reset and flash erase via GPIO pins for cases where the firmware is stuck and you can't get to the board. Could be a good companion to your utility.

wilriker

@gtj0 Glad to hear about any use-cases.

I myself use it to run poweroff as well as activating and deactivating my webcam (starting/stopping a systemd unit).

A Former User

Tempting to try with a small I2C OLED on the Pi, but not top of the list just yet

chas2706

@wilriker

This sounds really good. I would like to use it to activate a bash script on my system but I have attempted to install it and I cant get it to work.
I followed your instructions in your first post but using execonmode V3:

I downloaded execonmode and placed it into /usr/local/bin.
I tried to run it using sudo ./execonmode -help (just to see if it works) but I get the error message "cant open binary".

Could you instruct me where i'm going wrong.

BTW I am on the latest version of RRF3 and up to date with DSF etc.

Thanks in advance.

wilriker

@chas2706 If you run

sudo ./execonmcode -help

It will try to find the executable in the current directory you issue this command. To have your shell locate it in your $PATH remove the ./ in front of execonmcode. For -help you don't need sudo BTW.

To make sure that it can find it also check if

echo $PATH

actually does contain /use/local/bin.

Last thing: you spelled it execonmode instead of execonmcode (extra "c" after "m") above. Make sure that's only a typo here. I might rename the executable in the future to something less error-prone.

chas2706

@wilriker
Thanks for the info. I will give it another go.

execonmode was just a typo error in my post lol.

Thanks

chas2706

@wilriker said in [DSF Extension] Exec On MCode (was: Shutdown SBC):

./execonmcode -help

I have placed execonmcode in /usr/local/bin and typed the following in the terminal without success:

pi@Duet3:~ $ cd /usr/local/bin
pi@Duet3:/usr/local/bin $ ls
execonmcode listen-for-shutdown.py
pi@Duet3:/usr/local/bin $ ./execonmcode -help
bash: ./execonmcode: Permission denied
pi@Duet3:/usr/local/bin $ sudo ./execonmcode -help
sudo: ./execonmcode: command not found
pi@Duet3:/usr/local/bin $ execonmcode -help
bash: /usr/local/bin/execonmcode: Permission denied
pi@Duet3:/usr/local/bin $ sudo execonmcode -help
sudo: execonmcode: command not found
pi@Duet3:/usr/local/bin $

wilriker

@chas2706 Have you made execonmcode executable via sudo chmod +x /usr/local/bin/execonmcode? I think that's missing from the installation instructions.

chas2706

@wilriker

No I forgot!!

My silly mistake! It works a treat now.

Thank you for your help.

wilriker

@chas2706 Thank you for implicitly pointing out a hole in the installation instructions. I amended that to GitHub already and will fix it above in an instant.

chas2706

@wilriker

No problem, again thanks for your help and for producing a fantastic plugin.

wilriker

Important Note

The current version of Exec On MCode is NOT compatible with DSF 1.3.0+. It will connect but fail at a random point in time which might lead to breaking side-effects. I will release a new version tomorrow or Monday. Until then, don't use this tool with DSF 1.3.0+.

chas2706

@wilriker said in [DSF Extension] Exec On MCode (was: Shutdown SBC):

Important Note

I plan to temporarily remove this feature can you confirm that all I need to do this is to delete the extension?
I did not enable it to run at start up.
Many thanks for pointing this out.

wilriker

@chas2706 If you don't start it (automatically or manually) there is no need to do anything. It can sit in the filesystem that won't have any effect until you execute it.

wilriker

Release 4.0

This version works with DuetSoftwareFramework 1.3.0 and later.

Unfortunately due to breaking changes in the API of DSF this is NOT backwards-compatible with older versions of DuetSoftwareFramework.

This release also has a new parameter -trace that will enable output of the underlying requests/responses to/from DuetControlServer.

It can be downloaded as usual from GitHub Releases page.