@@ -952,9 +952,11 @@ G13.1
952952
953953'G12.1' selects one of the kinematics provided by a switchable kinematics
954954module; the 'P' word is the kinematics number. 'G13.1' cancels back to
955- identity kinematics, where joints and coordinates are the same thing.
956- Which number that is is declared by the module itself, so 'G13.1' means
957- the same kinematics whatever order a module lists its types in.
955+ the machine frame kinematics: the identity kinematics, where joints and
956+ coordinates are the same thing, on a machine whose slides line up with its
957+ frame, and the arm kinematics with no tool on a robot. Which number that is
958+ is declared by the module itself, so 'G13.1' means the same kinematics
959+ whatever order a module lists its types in.
958960
959961[WARNING]
960962Deprecation notice: selecting the kinematics by writing the
@@ -970,12 +972,12 @@ planned in one kinematics and executed in another. Because of that, both
970972codes stop any blending that was in progress, in the same way 'G4' does.
971973
972974The kinematics module decides what each number means, and declares
973- which one is identity . See the `switchkins` section of the kins(9) man
974- page for the modules that support switching and the order in which they
975+ which one is the machine frame . See the `switchkins` section of the kins(9)
976+ man page for the modules that support switching and the order in which they
975977list their kinematics. A machine whose kinematics module is not
976978switchable rejects the change, and 'G13.1' is an error on a switchable
977- module that declares no identity kinematics; such a module can still be
978- driven by number with 'G12.1'.
979+ module that declares no identity or machine frame kinematics; such a module
980+ can still be driven by number with 'G12.1'.
979981
980982Selecting a kinematics does not move the machine. It changes how joint
981983positions and coordinate positions map onto each other, so the position
@@ -996,14 +998,14 @@ G12.1 P#<saved> (put back whatever the caller was using)
996998Nothing cancels the selection on its own. It survives the end of the
997999program and an abort, so that the kinematics keeps matching what the
9981000position readout shows. End a program with 'G13.1' if it should leave the
999- machine in identity kinematics.
1001+ machine in the machine frame kinematics.
10001002
10011003.G12.1, G13.1 Example
10021004[source,ngc]
10031005----
10041006G12.1 P1 (switch to kinematics 1)
10051007G0 X0 Y0
1006- G13.1 (back to identity kinematics)
1008+ G13.1 (back to the machine frame kinematics)
10071009----
10081010
10091011It is an error if:
@@ -1012,7 +1014,7 @@ It is an error if:
10121014* The 'P' word is negative.
10131015* The 'P' word names a kinematics the module does not provide.
10141016* A 'P' word is used with 'G13.1'.
1015- * 'G13.1' is used and the module declares no identity kinematics.
1017+ * 'G13.1' is used and the module declares no identity or machine frame kinematics.
10161018
10171019[[gcode:g17-g19.1]]
10181020== G17 - G19.1 Plane Select(((G17 - G19.1 Plane Select)))
@@ -1076,7 +1078,7 @@ G28 Z2.5 (rapid to Z2.5 then to Z location specified in #5163)
10761078The 'absolute' position is the machine coordinate system of the kinematics in
10771079force, see <<gcode:g53,G53>>: on a kinematics that is not the identity it is
10781080that kinematics' world, not the slides, and the stored position is a world
1079- position too. <<gcode:g28.5,G28.5>> is the form that moves the slides , and with
1081+ position too. <<gcode:g28.5,G28.5>> is the machine frame form , and with
10801082`MACHINE_MOVES_IN_MACHINE_FRAME` set in the `[RS274NGC]` section of the INI
10811083file 'G28' and 'G28.1' are 'G28.5' and its store whenever the kinematics in
10821084force is not the machine frame kinematics.
@@ -1222,8 +1224,9 @@ with its frame, and the move is a <<gcode:g53.4,point-to-point move>> there,
12221224rapid, with no offset, tool length, rotation or work plane applied. The
12231225values are in the machine units of the INI file, as for 'G28'. The stored
12241226position has to be a machine frame position: store it with 'G28.1' or 'G30.1'
1225- while the identity kinematics is in force, where the world is that frame, or
1226- under any kinematics with `MACHINE_MOVES_IN_MACHINE_FRAME` set.
1227+ while the machine frame kinematics is in force, what 'G13.1' selects, where
1228+ the world is that frame, or under any kinematics with
1229+ `MACHINE_MOVES_IN_MACHINE_FRAME` set.
12271230
12281231* 'G28.5' - moves every letter the machine has to the stored position.
12291232* 'G28.5 axes' - moves the letters named by 'axes' to the given machine
@@ -1844,9 +1847,9 @@ declares its working transform, so the program runs with tool length
18441847compensation in the module's working kinematics. The switch happens
18451848first and the offset applies after it, as if the two had been written
18461849on consecutive lines. 'G49' is the matching cancel: it clears the
1847- offset and switches back to identity kinematics, as long as the offset
1848- in effect is still 'G43.4''s and no 'G12.1' or 'G13.1' has selected a
1849- kinematics since.
1850+ offset and switches back to the machine frame kinematics, what 'G13.1'
1851+ selects, as long as the offset in effect is still 'G43.4''s and no 'G12.1'
1852+ or 'G13.1' has selected a kinematics since.
18501853
18511854The H word, the offset itself and the parameters it lands in are
18521855'G43''s. Which kinematics is the working one is declared by the module
@@ -1949,11 +1952,13 @@ It is an error if:
19491952
19501953* 'G49' - cancels tool length compensation
19511954
1952- 'G49' also switches a switchable kinematics module back to its identity
1953- kinematics when it cancels a 'G43.4' or 'G43.5', undoing the switch that made. It
1954- leaves a kinematics selected by 'G12.1' or 'G13.1' alone, as it does
1955- after a plain 'G43', and a module that declares no identity kinematics
1956- gets the plain cancel.
1955+ 'G49' also switches a switchable kinematics module back to its machine
1956+ frame kinematics, what 'G13.1' selects, when it cancels a 'G43.4' or
1957+ 'G43.5', undoing the switch that code made. It leaves a kinematics selected
1958+ by 'G12.1' or 'G13.1' alone, as it does after a plain 'G43', and a module
1959+ that declares no identity or machine frame kinematics gets the plain
1960+ cancel. On a robot the arm kinematics is the machine frame, so there the
1961+ cancel switches nothing.
19571962
19581963It is OK to program using the same offset already in use. It is also
19591964OK to program using no tool length offset if none is currently being
@@ -2167,19 +2172,23 @@ one more layer of interpretation from the destination than the one before:
21672172 without leaving its coordinate system and without the trajectory planner
21682173 trying to hold the tool tip on a line the joints cannot follow at speed.
21692174* 'G53.5' takes the same axis letters as a position in the machine frame
2170- with the orientation left out: 'X', 'Y' and 'Z' are the carriage, the
2171- point the rotary joints do not move, in machine coordinates, and the
2172- rotary letters are the rotary joints themselves. On a machine whose slides
2173- line up with its frame, which every shipped module is, that is the slides:
2174- each letter names the joints the module's identity mapping gives it, which
2175- the `coordinates=` parameter and the `[TRAJ]COORDINATES` line describe,
2176- and the two joints of a gantry take one value together. A module whose
2175+ with the tool left out: 'X', 'Y' and 'Z' are the point the tool hangs
2176+ from, the pivot of a head or the flange of a robot, in machine
2177+ coordinates, and the rotary letters are the orientation as the machine
2178+ frame kinematics reports it, on a mill the rotary joints themselves. On a
2179+ machine whose slides line up with its frame that is the slides: each
2180+ letter names the joints the module's identity mapping gives it, which the
2181+ `coordinates=` parameter and the `[TRAJ]COORDINATES` line describe, and
2182+ the two joints of a gantry take one value together. A module whose
21772183 carriage does not line up, a slanted slide or a composite Y on a mill-turn,
21782184 declares a machine frame type of its own (see the
21792185 <<cha:switchable-kinematics,Switchable Kinematics>> chapter) and 'G53.5'
21802186 goes through it, so that 'Y10' is machine Y whichever slides make it, and
2181- a letter not given holds its machine coordinate rather than a joint.
2182- Values are in program units, so 'G20' scales them like any other axis
2187+ a letter not given holds its machine coordinate rather than a joint. On a
2188+ robot the machine frame is the arm kinematics with no tool, the flange in
2189+ the base frame, so 'Z10' puts the flange at base Z 10 with its orientation
2190+ held and 'A', 'B' and 'C' are the flange angles the module reports; the
2191+ move is still interpolated in joint space. Values are in program units, so 'G20' scales them like any other axis
21832192 word. No offset, tool length, rotation or work plane applies. On a mill
21842193 whose joint 2 carries the Z slide, 'G53.5 G0 Z0' puts that slide at zero
21852194 whatever the head and the tool are doing, where under a tool centre point
@@ -2192,19 +2201,20 @@ one more layer of interpretation from the destination than the one before:
21922201+
21932202An axis letter carries a unit class and a joint does not, so where the
21942203machine frame is the joints 'G53.5' is refused on a machine whose letters
2195- name joints of the other kind. A serial robot answers X with its first
2196- rotary joint, which turns in degrees, and there the whole code is refused
2197- rather than that one letter. Which joints turn is what `[JOINT_n] TYPE`
2198- declares.
2204+ name joints of the other kind: a module that declares no kinematics types
2205+ and answers X with a rotary joint, which turns in degrees, has the whole
2206+ code refused rather than that one letter. Which joints turn is what
2207+ `[JOINT_n] TYPE` declares.
21992208
22002209* 'G53.7' takes joint values, one word per joint, and works on every machine:
22012210 'J2=-5' sends joint 2 to -5. The number after 'J' is the joint number, the
22022211 `[JOINT_n]` section and the `joint.n` HAL pins, and the value after '=' is
22032212 the joint's own position, what `joint.n.pos-cmd` shows, in the joint's own
22042213 units. Nothing is converted, not even 'G20' and 'G21'. A joint left out
22052214 keeps its position, and the two joints of a gantry pair must both be given,
2206- with one value. This is the form for a robot, and for any machine where the
2207- letters do not name the joints they look like.
2215+ with one value. This is the form that names a joint outright, a robot's
2216+ joints by number, and the only form on a machine whose letters do not name
2217+ the joints they look like and whose module declares no machine frame.
22082218
22092219With 'G0' the speed comes from the joint limits in the INI file,
22102220`[JOINT_n] MAX_VELOCITY` and `MAX_ACCELERATION`, scaled so that no joint
0 commit comments