Printoid for OctoPrint

#⃣ Control Printoid through ADB (Premium version)

The Premium version of Printoid can be piloted by using the Android Debug Bridge (ADB). Following is a link to learn more about ADB: https://developer.android.com/studio/command-line/adb.html

Controlling Printoid through ADB is a bit more difficult than from a physical keyboard since it’s not plug-n-play. But this is also more powerful, since you are able to send extra values with some commands. Typically, this is the solution I use to control Printoid with physical keys & buttons: my actuators are connected to the GPIO ports of my Raspberry Pi, then I perform a simple conversion from “GPIO action” to “Printoid command”.

You have to ensure first that ADB is properly installed on your Raspberry Pi (The question has already been asked on internet). Then, you have to activate the developer options on your device and activate ADB.

The first time you’ll plug your device to the Raspberry, execute the adb devices command to check if your device is properly recognized. May you will have to accept the debug bridge from the device (don’t forget to check to “remember” box)

Once you’re able to communicate with the device, here’s how to communicate with Printoid. First start the application manually, or by sending the following command:

adb shell am start -n fr.yochi76.printoid.phones.pro/.MainActivity

Then, each control commands should be executed while the app is in the foreground, with the following schemes:

adb shell am broadcast -a PRINTOID_COMMAND --es PRINTOID_ACTION XXXX

or by passing a float value as argument (when the command requests a float value):

adb shell am broadcast -a PRINTOID_COMMAND --es PRINTOID_ACTION XXXX --ef PRINTOID_VALUE YY.YY

or by passing a string value as argument (when the command requests a string value):

adb shell am broadcast -a PRINTOID_COMMAND --es PRINTOID_ACTION XXXX --ez PRINTOID_VALUE YY.YY

Where you have to replace the XXXX by one of the following action, and when available you can complete the command with an optional value (so you have to replace YY.YY by your own float value, as for example 1.0, 5.2, 12.9…)

Here are the available actions (this list will be enhanced over the time and the versions of Printoid Premium).

Function	Action key	Value (unit) [type]
Connect/Disconnect printer	CONNECT	❌
Switch fullscreen	FULLSCREEN	❌
Show streaming	STREAMING	❌
Show commands	COMMANDS	❌
Show OctoPrint web-app	WEBAPP	❌
Show the files	FILES	❌
Show timelapses	TIMELAPSES	❌
Show Printoid web-site	WEBSITE	❌
Show printer profiles	PRINTER_PROFILES	❌
Show app settings	SETTINGS	❌
Show app infos	INFOS	❌
Move X axis to left	X_LEFT	✅ distance (mm) [float]
Move X axis to right	X_RIGHT	✅ distance (mm) [float]
Move Y axis to back	Y_TOP	✅ distance (mm) [float]
Move Y axis to front	Y_BOTTOM	✅ distance (mm) [float]
Move Z axis to top	Z_UP	✅ distance (mm) [float]
Move Z axis to bottom	Z_DOWN	✅ distance (mm) [float]
Set XY home	XY_HOME	❌
Set Z home	Z_HOME	❌
Extrusion	EXTRUSION	✅ length (mm) [float]
Retraction	RETRACTION	✅ length (mm) [float]
Increment fan speed	INC_FAN	✅ delta [float]
Decrement fan speed	DEC_FAN	✅ delta [float]
Increment extruder 1 temp.	INC_EXT1	✅ delta (°) [float]
Decrement extruder 1 temp.	DEC_EXT1	✅ delta (°) [float]
Increment extruder 2 temp.	INC_EXT2	✅ delta (°) [float]
Decrement extruder 2 temp.	DEC_EXT2	✅ delta (°) [float]
Increment extruder 3 temp.	INC_EXT3	✅ delta (°) [float]
Decrement extruder 3 temp.	DEC_EXT3	✅ delta (°) [float]
Increment extruder 4 temp.	INC_EXT4	✅ delta (°) [float]
Decrement extruder 4 temp.	DEC_EXT4	✅ delta (°) [float]
Increment extruder 5 temp.	INC_EXT5	✅ delta (°) [float]
Decrement extruder 5 temp.	DEC_EXT5	✅ delta (°) [float]
Increment extruder 6 temp.	INC_EXT6	✅ delta (°) [float]
Decrement extruder 6 temp.	DEC_EXT6	✅ delta (°) [float]
Increment extruder 7 temp.	INC_EXT7	✅ delta (°) [float]
Decrement extruder 7 temp.	DEC_EXT7	✅ delta (°) [float]
Increment extruder 8 temp.	INC_EXT8	✅ delta (°) [float]
Decrement extruder 8 temp.	DEC_EXT8	✅ delta (°) [float]
Increment extruder 9 temp.	INC_EXT9	✅ delta (°) [float]
Decrement extruder 9 temp.	DEC_EXT9	✅ delta (°) [float]
Increment extruder 10 temp.	INC_EXT10	✅ delta (°) [float]
Decrement extruder 10 temp.	DEC_EXT10	✅ delta (°) [float]
Increment bed temp.	INC_BED	✅ delta (°) [float]
Decrement bed temp.	DEC_BED	✅ delta (°) [float]
Select a tool (printer head)	SELECT_TOOL	✅ tool index (0->9) [float]
Print selected file	PRINT	❌
Pause print	PAUSE	❌
Stop print	STOP	❌
Send GCODE command	GCODE	✅ GCODE command(s) [string]

For the GCODE command, which let you sending your own GCODE command(s), please note that you can send multiple GCODE instructions at once, separating the commands by commas.