feat: added SafeSetAngleToRight, SafeSetAngleToLeft, SafeSetDirectionToRight and SafeSetDirectionToLeft methods

Author: ralvarezdev

interfaces.go

@@ -13,9 +13,13 @@ type (
 		IsAngleCentered() bool
 		SetAngleToCenter() tinygoerrors.ErrorCode
 		SetAngleToRight(angle uint16) tinygoerrors.ErrorCode
+		SafeSetAngleToRight(angle uint16) tinygoerrors.ErrorCode
 		SetAngleToLeft(angle uint16) tinygoerrors.ErrorCode
+		SafeSetAngleToLeft(angle uint16) tinygoerrors.ErrorCode
 		SetDirectionToCenter() tinygoerrors.ErrorCode
 		SetDirectionToRight(angle uint16) tinygoerrors.ErrorCode
+		SafeSetDirectionToRight(angle uint16) tinygoerrors.ErrorCode
 		SetDirectionToLeft(angle uint16) tinygoerrors.ErrorCode
+		SafeSetDirectionToLeft(angle uint16) tinygoerrors.ErrorCode
 	}
 )

types.go

@@ -221,6 +221,22 @@ func (h *DefaultHandler) SetAngleToRight(angle uint16) tinygoerrors.ErrorCode {
 	return h.SetAngleRelativeToCenter(-int16(angle))
 }
 
+// SafeSetAngleToRight sets the servo motor to the right by a specified angle without exceeding limits
+//
+// Parameters:
+//
+// angle: The angle value to move the servo to the right, must be between 0 and the right limit
+//
+// Returns:
+//
+// An error if the angle is not within the right limit
+func (h *DefaultHandler) SafeSetAngleToRight(angle uint16) tinygoerrors.ErrorCode {
+	if angle > h.maxAngle {
+		angle = h.maxAngle
+	}
+	return h.SetAngleToRight(angle)
+}
+
 // SetAngleToLeft sets the servo motor to the left by a specified angle
 //
 // Parameters:
@@ -234,6 +250,22 @@ func (h *DefaultHandler) SetAngleToLeft(angle uint16) tinygoerrors.ErrorCode {
 	return h.SetAngleRelativeToCenter(int16(angle))
 }
 
+// SafeSetAngleToLeft sets the servo motor to the left by a specified angle without exceeding limits
+//
+// Parameters:
+//
+// angle: The angle value to move the servo to the left, must be between 0 and the left limit
+//
+// Returns:
+//
+// An error if the angle is not within the left limit
+func (h *DefaultHandler) SafeSetAngleToLeft(angle uint16) tinygoerrors.ErrorCode {
+	if angle > h.maxAngle {
+		angle = h.maxAngle
+	}
+	return h.SetAngleToLeft(angle)
+}
+
 // SetDirectionToCenter sets the direction to center
 func (h *DefaultHandler) SetDirectionToCenter() tinygoerrors.ErrorCode {
 	return h.SetAngleToCenter()
@@ -252,6 +284,22 @@ func (h *DefaultHandler) SetDirectionToRight(angle uint16) tinygoerrors.ErrorCod
 	return h.SetAngleToLeft(angle)
 }
 
+// SafeSetDirectionToRight sets the direction to right without exceeding limits
+//
+// Parameters:
+//
+// angle: The angle value to move the servo to the left, must be between 0 and the left limit
+//
+// Returns:
+//
+// An error if the angle is not within the left limit
+func (h *DefaultHandler) SafeSetDirectionToRight(angle uint16) tinygoerrors.ErrorCode {
+	if angle > h.maxAngle {
+		angle = h.maxAngle
+	}
+	return h.SetDirectionToRight(angle)
+}
+
 // SetDirectionToLeft sets the direction to left
 //
 // Parameters:
@@ -263,4 +311,20 @@ func (h *DefaultHandler) SetDirectionToRight(angle uint16) tinygoerrors.ErrorCod
 // An error if the angle is not within the right limit
 func (h *DefaultHandler) SetDirectionToLeft(angle uint16) tinygoerrors.ErrorCode {
 	return h.SetAngleToRight(angle)
+}
+
+// SafeSetDirectionToLeft sets the direction to left without exceeding limits
+//
+// Parameters:
+//
+// angle: The angle value to move the servo to the right, must be between 0 and the right limit
+//
+// Returns:
+//
+// An error if the angle is not within the right limit
+func (h *DefaultHandler) SafeSetDirectionToLeft(angle uint16) tinygoerrors.ErrorCode {
+	if angle > h.maxAngle {
+		angle = h.maxAngle
+	}
+	return h.SetDirectionToLeft(angle)
 }