---
tag: g038
title: Probe target
brief: Probe towards (or away from) a workpiece
author: thinkyhead

since: 1.1.0
requires: G38_PROBE_TARGET
group: calibration

codes: [ G38.2, G38.3, G38.4, G38.5 ]

notes:
  - These commands require `G38_PROBE_TARGET` and a defined probe.
  - '`G38.4` and `G38.5` are only available with the `G38_PROBE_AWAY` option.'

parameters:
  -
    tag: X
    optional: true
    description: Target X
    values:
      -
        tag: pos
        type: float
  -
    tag: Y
    optional: true
    description: Target Y
    values:
      -
        tag: pos
        type: float
  -
    tag: Z
    optional: true
    description: Target Z
    values:
      -
        tag: pos
        type: float
  -
    tag: F
    optional: true
    description: Feedrate for the move
    values:
      -
        tag: rate
        type: float
---

The Probe Target commands are used to probe towards (or away from) a workpiece to determine its precise position. You might, for example, use a grounded metal workpiece, with a metal probe spliced into the bed probe circuit.

- `G38.2` probes towards a target and stops on contact, signaling an error if it reaches the target position without triggering the probe.
- `G38.3` probes towards a target and stops on contact. No error is given if it fails to trigger the probe.
- `G38.4` probes away from a target and stops on contact break. An error is signaled if the target position is reached without triggering the probe.
- `G38.5` probes away from a target and stops on contact break. No error is given if it fails to trigger the probe.

These commands use the current homing feedrate, by default.