Docs
Download Spikemark
  • Creative Conners Docs
  • Technical Support
    • Tech Tips
      • Revolver V1 Position Issues
      • Setting Up a New Comptuer for Spikemark
  • Spikemark 6
    • Navigating Spikemark
      • Show Modes
      • Workspaces
        • Jog Workspace
        • Cues Workspace
        • Preset Workspace
        • Customize Your Workspace
      • Selection and Input
      • Tags
      • Filters
      • Search
      • Keyboard Shortcuts
    • Cues
      • Cue Structure
      • Cue Creation
        • Add Movements
        • Add Triggers
        • Add Actions
      • Editing Cue Properties
      • Cue Deletion
    • Movements
      • Motor Movements
      • Locked Group Movements
      • Unlocked Group Movements
      • FX Movements
      • OSC Movements
        • Custom OSC Command Library
      • UDP Movements
      • Modbus Movements
    • Triggers
      • Playback Go Trigger
      • Delay Trigger
      • Completion Trigger
      • Position Trigger
      • FX Input Trigger
      • Stacking Triggers
    • Actions
      • Motor Property Action
      • Motor Method Action
      • Playback Property Action
    • Running Cues
      • Playbacks
        • Playback Editing
        • Playback Control Speed
        • Playback Stacking
      • Cue Controls
      • Consolette
      • Restore Cue
    • Spikes
      • Simple Spikes
      • Dynamic Spikes
        • Incremental Spikes
        • Nearest Forward Multiple Spikes
        • Nearest Reverse Multiple Spikes
        • Nearest Multiple Spikes
      • Locked Group Spikes
    • Presets
      • Presets Overview
      • Creating, Editing, and Deleting Presets
      • Running Presets
    • User Authentication and Authorization
      • Overview
      • Users
      • Roles
      • Permissions
    • Show Control
      • Open Sound Control (OSC)
        • Send OSC Messages
        • OSC Position Output
        • OSC Input Trigger
          • OSC Input Messages
          • Cue Messages
          • Playback Messages
          • Sequence Step Messages
          • Motor Movement Messages
          • Motor Messages
        • Troubleshooting OSC
          • OSC Response Window
          • Medialon Manager Configuration
      • UDP
        • Send UDP Messages
        • UDP Position Output
      • Watchout Position Output
      • PosiStageNet (PSN)
  • Spikemark 5
    • How to Open Spikemark
    • Spikemark Installation
      • User Authorization
      • Windows Settings
    • Quick Start Tutorial
      • Step 1: Adding Motors
        • 1.1 Simulator Mode
        • 1.2 Add Motors from the Machine Library
        • 1.3 Rename Motors
        • 1.4 Add A Group
      • Step 2: Saving
      • Step 3: Jogging
        • 3.1 Single Axis Jogging
        • 3.2 Jogging Multiple Machines (Multi-Jog)
        • 3.3 Move To Position
      • Step 4: Writing Your First Cues
        • 4.1 Cues Workspace
        • 4.2 Add A Movement
        • 4.3 Duplicate A Cue
        • 4.4 Delete A Movement From A Cue
        • 4.5 Edit Movement - Changing Position, Speed, and Time
        • 4.6 Copy to Group
        • 4.7 Cue Total Time
        • 4.8 Load and Run your Cue
        • 4.9 Spikes
        • 4.10 Cue Links
        • 4.11 Restore Cue
        • 4.12 Delete A Cue
      • Step 5: Going Live
        • 5.1 Set Your IP Address
        • 5.2 Test Manual Movement
        • 5.3 Resetting Position
        • 5.4 Program Your Show
      • Sharpen Your Programming Skills
    • Steps to a Successful Load-In
    • Show Modes
    • Locking Changes
    • Workspaces
      • Customize Your Workspace
    • Selection and Input
    • IP Address and Network Connection
      • Setting Computer IP Address
      • Setting Stagehand IP Address
      • Setting Showstopper Consolette IP Address
      • Setting Pendant IP Address
      • Setting Showstopper IP Address
      • Setting Showstopper Node ID
      • Connecting To A Stagehand
      • Connecting To A Showstopper Consolette
      • Connecting To A Pendant
    • Adding Motors or Machines
      • Adding Motors or Machines From The Machine Library
      • Adding Custom Motors or Machines To Spikemark
      • Importing Motors or Machines
      • Exporting Motors or Machines
    • Stage Model Viewer
      • Changing Your Viewer
      • Adjusting the Stage Size
      • Changing the Type of Scenery
      • Adjusting Model Dimensions
      • Adjusting Model Rotation
      • Adjusting Location On Stage
      • Making Models
        • Modeling A Winch
        • Modeling A Lift
        • Modeling A Hoist
        • Modeling A Vertical Curtain
        • Modeling A Split Curtain
        • Modeling A Turntable or Periaktos
    • Tags
    • Editing Direction Labels
    • Filters
    • Search
    • Position
      • Reset Position
      • Units
      • Position Scale
        • Position Scale Wizard
        • Manually Calculate Position Scale
      • Limits
        • Setting Hard Limits
        • Setting Soft Limits
      • Target Tolerance
      • Strict Timing Mode
      • Position Fault and Max Position Error
      • Motor Tuning Overview
        • Motor Tuning - The Practical Approach
    • Load Cell
      • Load Cell Readout
      • Load Cell Configuration
      • Load Cells and Groups
    • Speed
    • Spikes
      • Adding A Spike
      • Removing A Spike
      • Spike Input Fields
      • Simple Spike
      • Incremental Spike
      • Nearest Forward Multiple Spike
      • Nearest Reverse Multiple Spike
      • Nearest Multiple Spike
    • Editing Cues
      • Adding and Deleting Cues
      • Adding and Deleting Movements
      • Edit Movement
      • Edit Cue Options
    • Cue Controls
    • Cue Status
    • Cue Links
      • Completion Link
      • Time Link
      • Position Link
      • Input Link
      • Deleting A Cue Link
    • Presets
    • Motor Groups
    • Showstopper Node Editor
    • Show Control
      • Open Sound Control (OSC)
        • OSC Position Output
        • OSC Messenger
          • Expanding The Command Library
        • OSC Response Window
        • OSC Input Trigger
          • Input Messages
          • Cue Commands
          • Motor Commands
          • My OSC Input Trigger Isn't Working, Is there another way?
      • UDP
        • UDP Position Output
        • UDP Messenger
      • Watchout Position Output
      • Modbus Effect
      • PosiStageNet (PSN)
    • Drive Communication
      • Drive Information
      • Configuring The Drive
      • Analyzing Movements
      • Drive Communication: Compatibility
      • Drive Communication: Setting VFD Parameters
      • RS-485 Upgrade
        • Upgrading an A800
        • Upgrading an A700
        • Drive Communication Troubleshooting
      • VFD Fault Codes
    • Motor Status Icons
    • Keyboard Shortcuts
    • Advanced Cue Techniques
  • Showstopper
    • Showstopper 4 Base
      • Installation
      • Operation
      • Troubleshooting
      • Specifications
    • Spikemark Console
      • Making-The-Connections
      • Using-the-Console
      • Console-Firmware
      • Troubleshooting
      • Specifications
    • Spikemark Pendant V2
      • Getting Started
      • Setup
      • Operation
      • Troubleshooting
      • Specifications
      • Drawings
    • Showstopper 4 E-Stop Hub
      • Getting Started
      • Installation
      • Operation
      • Troubleshooting
      • Specifications
    • Showstopper 4 Accessory Hub
      • Getting Started
      • Installation
      • Operation
      • Troubleshooting
      • Specifications
    • Showstopper Remote E-Stop
      • Installation
      • Making The Connections
      • Operation
      • Troubleshooting
      • Specifications
    • Control Connection
      • Installation
      • Making The connections
      • Operation
      • Troubleshooting
      • Specifications
    • Drive Connection
      • Installation
      • Making The connections
      • Operation
      • Troubleshooting
      • Specifications
    • Showstopper E-Stop Patch Panel
    • Showstopper Accessory Patch Panel
    • 🦺Safety Interlock
      • Safety Interlock Classic
      • Safety Interlock Pro
      • Safety Interlock Pro 4
      • 4-Axis Safety Interlock
    • Legacy
      • Showstopper 3 Base
      • Showstopper 3 Remote
      • Showstopper 3 E-Stop Patch Panel
      • Stage Manager
        • Getting Started
        • Installation
        • Making the Connections
        • Operation
        • Troubleshooting
        • Specifications
      • Showstopper 4 Consolette
        • Features
        • Making the Connections
          • Accessory Cable Connection
          • Ethernet Connection
          • Multiple Consolettes
        • On-Board Settings
        • Operation & Spikemark Integration
        • Connecting the Consolette to Spikemark
        • Jogging Motors
        • Running Cues
        • Emergency Stop
        • Updating Consolette Firmware
        • Troubleshooting
        • Physical Specifications
        • Drawings
  • Stagehand
    • Stagehand Firmware
      • Manually Updating a Stagehand Unipolar V6 Card via SD Card
      • Manually Updating a Stagehand Unipolar V6 Card via USB
    • Stagehand Parameters
      • Stagehand Pro 2 Parameters
      • Stagehand Pro 3/Pro 4 Parameters
      • Stagehand Pro 3e Parameters
      • Stagehand Pro 5 Parameters
      • Stagehand Apprentice 2 Parameters
      • Stagehand Apprentice
      • Stagehand AC - AKA: The Classic
      • Classic+ Parameters
      • Pro+ Parameters
      • Setting the C3 Value
      • Setting the C4 Value
      • All Clear/Parameter Clear
      • How to Use the Mitsubishi VFD Keypad
      • USB Parameter Sets
      • Parameter Library in Spikemark
    • Stagehand Apprentice
      • Getting Started
      • Installing the Stagehand
      • Making the Connections
      • Hooking up a motorized effect
      • Using the Stagehand
      • Troubleshooting
      • Technical Support
      • Specifications
    • Stagehand Apprentice DC
    • Stagehand Apprentice 2
      • Stagehand Apprentice 2: Features
      • Stagehand Apprentice 2: Installation
      • Stagehand Apprentice 2: Making The Connections
        • Stagehand Apprentice 2: Power Input
        • Stagehand Apprentice 2: Motor and Brake Output
        • Stagehand Apprentice 2: Sensor Input
        • Stagehand Apprentice 2: Interlock Inputs
        • Stagehand Apprentice 2: Ethernet Input
        • Stagehand Apprentice 2: Showstopper Emergency Stop Input
      • Stagehand Apprentice 2: Operation
      • Stagehand Apprentice 2: Troubleshooting
      • Stagehand Apprentice 2 Specifications
      • Stagehand Apprentice 2: Drawings
    • Stagehand FX
      • Getting Started
      • Making the Connections
      • Connecting an Effect
      • Operation
      • Troubleshooting
      • Specifications
    • Stagehand Hydraulic
      • Getting Started
      • Features
      • Installation
      • Operation
      • Troubleshooting
      • Technical Support
      • Specifications
      • Drawings
    • Stagehand Pro 3
    • Stagehand Pro 3E
    • Stagehand Pro 4
      • Stagehand Pro 4: Unpacking
      • Stagehand Pro 4: Installation
      • Stagehand Pro 4: Making The Connections
        • Stagehand Pro 4: Power Input
        • Stagehand Pro 4: Motor and Brake Output
        • Stagehand Pro 4: Sensor Input
        • Stagehand Pro 4: Interlock Inputs
        • Stagehand Pro 4: Ethernet Input
        • Stagehand Pro 4: Showstopper Emergency Stop Input
      • Stagehand Pro 4: Operation
        • Stagehand Pro 4: Powering Up
        • Stagehand 4: Machine Configuration
        • Stagehand Pro 4: Manual Operation (Jogging)
        • Stagehand Pro 4: Brake Test
        • Stagehand Pro 4: Connecting to Spikemark
        • Stagehand Pro 4: Status Displays
      • Stagehand Pro 4: Troubleshooting
        • Stagehand Pro 4: Recovering From Faults
        • Stagehand Pro 4: Monitoring Behavior
      • Stagehand Pro 4: Specifications
      • Stagehand Pro 4: Drawings
    • Stagehand Pro 5
      • Stagehand Pro 5: Features
      • Stagehand Pro 5: Installation
      • Stagehand Pro 5: Making The Connections
        • Stagehand Pro 5: Power Input
        • Stagehand Pro 5: Motor and Brake Output
        • Stagehand Pro 5: Sensor Input
        • Stagehand Pro 5: Interlock Inputs
        • Stagehand Pro 5: Ethernet Input
        • Stagehand Pro 5: Showstopper Emergency Stop Input
      • Stagehand Pro 5: Operation
      • Stagehand Pro 5: Troubleshooting
      • Stagehand Pro 5 Specifications
      • Stagehand Pro 5: Drawings
      • Stagehand Pro 5: Replace Control Card
    • Deck Chief 2
      • Getting Started
      • Features
      • Making the Connections
      • Using the Deck Chief
      • Troubleshooting
      • Specifications
    • Stagehand Classic+
    • Stagehand Pro+
    • Legacy Manuals
      • Deck Chief
        • Getting Started
        • Installation
        • Making the Connections
        • Using the Deck Chief
        • Troubleshooting
        • Specifications
        • Deck Chief Legacy Connections
      • Stagehand Mini^2
      • Stagehand Pro AC (Pro 2)
      • Stagehand AC
      • Stagehand Mini
      • Stagehand DC & DC Max
    • X-Groove Override
  • Machinery
    • Smart Chain Hoist
      • Getting Started
      • Installation
      • Making the Connections
      • Under The Hood
      • Troubleshooting
      • Specifications
    • Floorpocket
      • GettingStarted
      • Installation
      • Making the Connections
      • Prepping the Machine for Operation
      • VFD Settings
      • Troubleshooting
      • Specifications
    • Floorpocket v2
      • Get Started
        • Unpack
        • Installation Tools
      • Assembly
        • Base
        • Column Extension
        • Limit Cables
        • Roller Chain
      • Get Moving
        • Power Up
        • Platform
        • Stay Safe
        • Write Cues
      • Maintain the Machine
      • Troubleshooting
      • Floorpocket v2: Specifications
    • Pivot
      • Getting Started
      • Installation
      • Troubleshooting
      • Specifications
    • Pushstick
      • Getting Started
      • Installation
      • Making the Connections
      • Rigging the Pushstick
        • Rigging a Pushstick v2
      • Setting the Limits
      • Troubleshooting
      • Specifications
    • Pushstick Mini
      • Getting Started
      • Installation
      • Making the Connections
      • Rigging the Pushstick Mini
      • Troubleshooting
      • Technical Support
      • Specifications
    • Revolver
      • Installation
      • Making the Connections
      • Making It Move
        • Friction Wheel Tension Guide
      • Position Scaling
        • Encoder Finessing
      • Troubleshooting
      • Specifications
        • Drawing
      • Multi-Motor Configuration
      • Revolver v1 Manual
    • Rotator
      • Getting Started
      • Installation
      • Making the Connections
      • Troubleshooting
      • Technical Support
      • Specifications
    • Spotline
      • Getting Started
      • Installation
      • Rigging the Spotline
      • Operation
      • Troubleshooting
      • Specifications
    • Spotline V2
      • Spotline V2: Setup Process
      • Spotline V2: Installation
      • Spotline V2: Rigging the Spotline
      • Spotline V2: Operation
      • Spotline V2: Troubleshooting
      • Spotline V2 Accessories
      • Spotline V2: Maintenance
      • Spotline V2: Specifications
    • Spotline Mini v2
    • Spotline Practical
      • Practical v2
        • Getting Started
        • Installation
        • Rigging the Machine
        • Setting the Limits
        • Troubleshooting
        • Specifications
      • Practical v1
        • Getting Started
        • Installation
        • Operation
        • Troubleshooting
        • Specifications
    • Turntable Template
      • Overview
      • Bill Of Materials
      • Fabrication
      • Turntable Assembly and Installation
      • Turntable Assembly Guide
      • Tech Support
      • 20' Turntable Specs
      • Turtable Research Notes for Nerds
    • Retired
      • Curtain Call
      • Trickline
        • TricklineProductManualv1.0
        • Getting Started
        • Installation
        • Making the Connections
        • Troubleshooting
        • Specifications
      • Spotline Mini
        • Getting Started
        • Installation
        • Making the Connections
        • Rigging the Spotline Mini
        • Troubleshooting
        • Specifications
      • Pushstick Manual
    • Stromag Limits
  • Broadweigh Load Cells
Powered by GitBook
On this page
  • Understanding the values:
  • Max Position Error
  • Maximum Max Position Error
  • Calculating The Maximum Max Position Error
  • Position Lag Time
  • Check Points to Solve Position Faults:
  • Encoder/Motor Phase Mismatched
  • Encoder Failure
  • Motor Tuning
  • Increase Max Position Error or Position Lag Time Values
  • Abort On Position Error

Was this helpful?

  1. Spikemark 5
  2. Position

Position Fault and Max Position Error

PreviousStrict Timing ModeNextMotor Tuning Overview

Last updated 1 year ago

Was this helpful?

We’ve all been there: Press GO, the cue begins but then stops well before its target and Spikemark is displaying yellow highlights and the cursed Position Fault icon.

Inevitably this happens under intense stares from the artistic team and lots of pressure to “just make it work”. Before you begin looking for a job raising Alpacas or turning off Abort on Position Error, which we do not recommend, what else can be done? Read on to learn what Abort on Position Error means and how Spikemark conjures up the mystical Max Position Error.

Spikemark keeps an eye on the actual position of the machine and compares that to where it should be at any given time through the cued movement. If the actual position error is greater than the Max Position Error value, the movement will be stopped and you will see the Position Fault icon in Spikemark.

Some common reasons you will see the Position Fault in Spikemark:

  • A slow speed move with a small Position Lag Time

  • Unattainable speed

    • If the machine can't go as fast as you are asking it to - it will always be behind.

  • Encoder loss

    • If the encoder signal is lost (or simply not connected) it will be behind

  • Motor/Encoder direction mismatch

    • If the FWD command is returning REV counts, Spikemark will see the position error grow and fault out

  • Poor motor tuning

    • This is a bit more challenging to quantify...

Understanding the values:

  • Position - This is the actual that the encoder is reading the machine to be at

  • Desired Position - when running in a Cue, this readout is where the position is expected to be based on the values in the Movement

  • Position Error = Desired Position - Actual Position. If the position error exceed what is set for the max position error, the cue will abort and you will see the position fault icon.

  • Peak Position Error - This is the largest position error value this axis has seen since this value was last reset.

Max Position Error

Throughout a cue, Spikemark is constantly calculating where a machine is supposed to be, and comparing that number to where the machine is in reality. If that discrepancy becomes larger than the Max Position Error, Spikemark will stop that motor and indicate a Position Error.

Maximum Max Position Error

Notice that if you try to enter in a value too high for the Max Position Error, Spikemark will autocorrect this to being a smaller number. This is because the motion controller inside the Stagehand has a maximum allowable Max Position Error (MPE) value is 32,767 raw encoder counts. Therefore, this Maximum Max Position Error is dependent on your position scale and therefore your encoder resolution. So with a higher encoder resolution, you get more precise position feedback, but you also reduce your Maximum Max Position Error.

Calculating The Maximum Max Position Error

The MPE is given in scaled position units such as inches or degrees. Therefore, if you have a position scale of 10,000 encoder counts per inch, the largest MPE you can input will equal 3.2767” [32,767 raw encoder counts ÷ 10,000 encoder counts/inch = 3.2767 inch]. Below is a table of stock CCI machines and their MPE values as a real world reference:

Machine

Counts/Unit

MPE

Units

Pushstick V2

3145.87

10.42

Inches

Revolver

5585.048

5.87

Degrees

CM Chain Hoist

29520.16239

1.11

Inches

You can set the MPE to be lower than this maximum, but Spikemark wont let you set a value higher. Try for yourself: Try setting the MPE for the Pushstick V2 to be 15", you will notice that it corrects itself to ~10.42".

Position Lag Time

Position Lag is another way to look at the MPE value. The idea behind Position Lag Time is to allow you a max time for how long a movement can be in a position error before faulting.

However, the motion controller cannot take a time input for Max Position Error. Therefore, Position Lag Time is calculated dynamically based on the speed of the current movement.

When the cue is loaded, Spikemark will calculate a Position Lag Value(Maximum Position Error based on the Position Lag Value) and compare it to the entered Max Position Error value, and then will use the smaller value as the Max Position Error for that move.

Let's look at a real world example:

Let's say we have a show with a Pushstick V2. From the table above we know the MPE is 10.42" and we have the Position Lag Time set to .5 seconds. If we run a cue with a speed of 30"/s.

Since Spikemark will use the smaller value of the Position Lag Value and the inputted MPE, from the MPE field, the loaded MPE will be 10.42"

However, if use the same Pushstick V2 with the same MPE Value and Position Lag time, but a cue with a speed of 12"/s:

Since Spikemark will use the smaller value of the Position Lag Value and the inputted MPE, from the MPE field, the loaded MPE will be 6" not 10.42"

Make sense? I hope so. The short answer is that both the inputted Max Position Error and Position Lag Time will effect the actual loaded Max Position Error and will stop a motor if exceeded.

Check Points to Solve Position Faults:

Encoder/Motor Phase Mismatched

If the encoder direction is moving opposite to the motor direction, this position error will increase fast and fault. If you turn off "Abort On Position Error" this machine will likley speed up and speed up to correct for the error until it is running at full speed in the opposite direction. Keep "Abort on Position Error" checked and turned on to prevent a machine from running away.

Make sure that when you are jogging from the face of the Stagehand that Forward has encoder count counting up and Reverse has encoder counts counting down.

Encoder Failure

If you encoder is not being powered, missing a phase, or is not physically connected to the moving machine, the position feedback to not be sent to the motion controller, and like a Mismatch, the machine will likely start to run away or position fault. Check that you encoder is getting power, is wired correctly, and is mechanically secured to track position accurately.

Motor Tuning

If you are position faulting due to tuning, increasing the Proportional Gain will likely prevent you from faulting, but may also create motion that isn't buttery smooth. Adding Derivative gain could help smooth it out.

You can also try Auto-tuning(drive level) to make sure the motor is being powered optimally.

Increase Max Position Error or Position Lag Time Values

We want all of our effects to have the least amount of error. So making sure the mechanics are tight, everything is wired correctly, and optimizing the tuning, should be the first steps to getting rid of position faults.

However, sometimes we have sloppy mechanics in our effect and have to work with what we have. This is where you increase you Max Position Error or Position Lag Time Values.

But what if you are already at the maximum values for Max Position Error and Position Lag Time, and are still getting position faults, what should you do?

  • Try Motor Tuning again

  • Swap in a new encoder with a lower resolution. If you use an encoder with half the resolution, you will double your Maximum Allowable Max Position Error.

Abort On Position Error

If this is selected, Spikemark will use the smaller of the numbers as discussed above to stop the motion of a motor when the Max Position Error has been exceeded.

Deselect this and the move will continue, regardless of how far off it may be, until Spikemark receives feedback that the motor is located within the Target Tolerance of the target destination.

If you are having an encoder issue, turning off Abort On Position Error could result in a motor that increases speed until you e-stop the machine. This could be very dangerous.

Turning off Abort On Position Error should only be used for troubleshooting and without scenery attached and with nothing near the machine.

PositionLagValue(units)=PositionLagTime(s)∗MovementSpeed(units/sec)Position Lag Value(units) = PositionLagTime(s) * MovementSpeed(units/sec)PositionLagValue(units)=PositionLagTime(s)∗MovementSpeed(units/sec)

The Position Lag Value will equal 15"=30"/s∗0.5s15" = 30"/s * 0.5s15"=30"/s∗0.5s

The Position Lag Value will equal 6"=12"/s∗0.5s6" = 12"/s * 0.5s6"=12"/s∗0.5s

The motion controller auto-magically is comparing the Actual Position vs. the Desired Position, and will speed up or slow down the motor to correct any Position Error even if it isn't a Position Error Fault. adjusts how this Position Error Correcting is achieved.

Motor Tuning