From 951c6daa5b3256320649cf71ce1fe3f3cd1b12a9 Mon Sep 17 00:00:00 2001 From: Balamurugan R Date: Mon, 6 Oct 2025 13:32:37 +0530 Subject: [PATCH] feat(example): Add writeMicroseconds_Example sketch (issue #51) --- ...rcuit Connection for writeMicroseconds.png | Bin 0 -> 79169 bytes .../writeMicroseconds_Example.ino | 52 ++++++++++++++++++ 2 files changed, 52 insertions(+) create mode 100644 examples/writeMicroseconds_Example/Circuit Connection for writeMicroseconds.png create mode 100644 examples/writeMicroseconds_Example/writeMicroseconds_Example.ino diff --git a/examples/writeMicroseconds_Example/Circuit Connection for writeMicroseconds.png b/examples/writeMicroseconds_Example/Circuit Connection for writeMicroseconds.png new file mode 100644 index 0000000000000000000000000000000000000000..ac2e5ba16c48220d93fa5adefb3acd84d2165620 GIT binary patch literal 79169 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 literal 0 HcmV?d00001 diff --git a/examples/writeMicroseconds_Example/writeMicroseconds_Example.ino b/examples/writeMicroseconds_Example/writeMicroseconds_Example.ino new file mode 100644 index 0000000..e43999e --- /dev/null +++ b/examples/writeMicroseconds_Example/writeMicroseconds_Example.ino @@ -0,0 +1,52 @@ +#include // Corrected: Include the library first + +/* * -------------------------------------------------------------------------- + * writeMicroseconds_Example + * -------------------------------------------------------------------------- + * The writeMicroseconds() function is part of the Servo Library. + * It sets the servo's angle by accepting a pulse width duration measured in microseconds (µs). + * * CORE TIMING VALUES (Note: Values can vary slightly by servo model): + * * 1. Minimum Position (0 degrees): + * - Value: 544 microseconds (us) + * - Result: Servo moves to its extreme counter-clockwise limit (0°). + * * 2. Center Position (90 degrees): + * - Value: 1500 microseconds (us) + * - Result: Servo moves to its neutral, center position (90°). + * * 3. Maximum Position (180 degrees): + * - Value: 2400 microseconds (us) + * - Result: Servo moves to its extreme clockwise limit (180°). + * + * * BASIC WORKING PRINCIPLE: + * Servo motors use Pulse Width Modulation (PWM). The duration (width) that the + * control wave is held HIGH directly determines the commanded angle. This function + * allows for precise, non-standard movement by letting the user specify the exact time duration. + */ + +// Create a servo Object. We'll use myservo for standardization. +Servo myservo; // Correction: Added standard name and semicolon + +void setup() { + // 1. Attach the servo object to a PWM pin (e.g., Digital Pin 9). + myservo.attach(9); + + // 2. Initialize Serial Monitor to explain the timing values. + Serial.begin(9600); + Serial.println("--- Servo Microseconds Example Running ---"); +} + +void loop() { + // 1. Write CENTER position (Standard 90 degrees) + myservo.writeMicroseconds(1500); + Serial.println("Position: Center (1500 us)"); + delay(1500); // Wait 1.5 seconds + + // 2. Write MINIMUM position (Standard 0 degrees) + myservo.writeMicroseconds(544); + Serial.println("Position: Min (544 us)"); + delay(1500); + + // 3. Write MAXIMUM position (Standard 180 degrees) + myservo.writeMicroseconds(2400); + Serial.println("Position: Max (2400 us)"); + delay(1500); +} \ No newline at end of file