SchmalzHaus logoEBB Commands

Introduction

The EBB firmware is based on the UBW firmware. The same basic command processing framework is used, so the same type of commands are used, and the same type of errors are returned. See the UBW command documentation for an introduction to these topics.

This command reference applies to EiBotBoard Firmware v1.8.0 and above. (Any differences between firmware versions are noted below and in release notes.)

Other Resources

EBB Command Reference

The "QC" Command (Query Current) - Added in v2.0, bug fixed in 2.0.1

    This command only works properly on EBB hardware v1.3 and above. (The white boards from EMSL are v2.0, and all boards from SparkFun are v2.0 and above) The first value returned is the raw 10 bit analog level on the REF_RA0 input to the stepper driver chip. This voltage level sets the max current that the driver chips allow into the motor coils. The second value returned is the raw 10 bit analog level on the V+ input (i.e. the power coming into the board, but after the first diode), and is scaled so that the input voltage doesn't go above the 3.3V max analog input level for the MCU.

    For a v1.5 EBB, the following values were measured for the second returned parameter of the QC command:
Input (V+)    QC second parameter
0.0 449
5.0 513
9.0 574
12.0 604
24.0 775
    So one can use these two returned values to check for proper stepper motor driver current and proper power supply input voltage. You could also disable the motors, read the power input voltage, then enable the motors and check it again, giving an approxiate reading of the level of voltage droop on the power supply when the motors are loading it down. Note that V+ is not measured directly, but rather after a diode and through a resistor divider. The diode will drop some voltage (dependent upon current) and there will be some tolerance in the voltage divider. Thus you can't rely upon the raw ADC value alone to give a precise measurement.

    Version History: This command was introduced in v2.0.0, but it had a bug where the upper byte of the result was no being displayed. Version 2.0.2 fixed this bug and the command now works properly.

The "SE" Command (Set Engraver) - Added in v2.1.0

The "NI" Command (Node count Increment) - Added in v1.9.5

The "ND" Command (Node count Decrement) - Added in v1.9.5

The "BL" Command (BootLoad) - Added in v1.9.5

The "SN" Command (Set Node count) - Brought back in v1.9.5

The "CN" Command (Clear Node count) - Added in v1.9.3, removed in 1.9.5 and above

The "SL" Command (Set Layer) - Added in v1.9.2

The "QL" Command (Query Layer) - Added in v1.9.2

The "QN" Command (Query Node count) - Added in v1.9.2

The "QB" Command (Query Button) - Added in v1.9.2

The "QP" Command (Query Pen) - Added in v1.9

The "TP" Command (Toggle Pen) - Added in v1.9

The "SM" Command (stepper motor move)

The "SP" Command (set pen state)

The "EM" Command (enable motors) for EBB v1.1

The "EM" Command (enable motors) for EBB v1.2 and above

The "SC" Command (stepper mode configure)

The "S2" Command (general RC servo output) - for versions prior to 2.2.0


The "S2" Command (general RC servo output) - for versions 2.2.0 and above



Questions? E-mail me at my e-mail address

Creative Commons License
EggBotBoard by Brian Schmalz is licensed under a Creative Commons Attribution 3.0 United States License.
Based on a work at www.schmalzhaus.com/EBB.
Permissions beyond the scope of this license may be available at www.schmalzhaus.com/EBB.