3.9 KiB
Servo library
Methods
attach()
Attach the Servo variable to a pin. Note that in Arduino IDE 0016 and earlier, the Servo library supports servos on only two pins: 9 and 10.
Syntax
servo.attach(pin)
servo.attach(pin, min, max)
Parameters
- servo: a variable of type
Servo - pin: the number of the pin that the servo is attached to
- min (optional): the pulse width, in microseconds, corresponding to the minimum (0 degree) angle on the servo (defaults to 544)
- max (optional): the pulse width, in microseconds, corresponding to the maximum (180 degree) angle on the servo (defaults to 2400)
Example
#include <Servo.h>
Servo myservo;
void setup()
{
myservo.attach(9);
}
void loop() {}
See also
write()
Writes a value to the servo, controlling the shaft accordingly. On a standard servo, this will set the angle of the shaft (in degrees), moving the shaft to that orientation. On a continuous rotation servo, this will set the speed of the servo (with 0 being full-speed in one direction, 180 being full speed in the other, and a value near 90 being no movement).
Syntax
servo.write(angle)
Parameters
- servo: a variable of type Servo
- angle: the value to write to the servo, from 0 to 180
Example
#include <Servo.h>
Servo myservo;
void setup()
{
myservo.attach(9);
myservo.write(90); // set servo to mid-point
}
void loop() {}
See also
writeMicroseconds()
Writes a value in microseconds (us) to the servo, controlling the shaft accordingly. On a standard servo, this will set the angle of the shaft. On standard servos a parameter value of 1000 is fully counter-clockwise, 2000 is fully clockwise, and 1500 is in the middle.
Note that some manufactures do not follow this standard very closely so that servos often respond to values between 700 and 2300. Feel free to increase these endpoints until the servo no longer continues to increase its range. Note however that attempting to drive a servo past its endpoints (often indicated by a growling sound) is a high-current state, and should be avoided.
Continuous-rotation servos will respond to the writeMicrosecond function in an manner analogous to the write function.
Syntax
servo.writeMicroseconds(us)
Parameters
- servo: a variable of type Servo
- us: the value of the parameter in microseconds (int)
Example
#include <Servo.h>
Servo myservo;
void setup()
{
myservo.attach(9);
myservo.writeMicroseconds(1500); // set servo to mid-point
}
void loop() {}
See also
read()
Read the current setpoint of the servo (the angle passed to the last call to write()).
Note that the servo has no way of reporting its current physical orientation. This method returns the angle to which the sketch program has requested the servo to move, regardless of whether the servo has already reached that angle.
Syntax
servo.read()
Parameters
- servo: a variable of type
Servo
Returns
The setpoint of the servo, as an angle from 0 to 180 degrees.
See also
attached()
Check whether the Servo variable is attached to a pin.
Syntax
servo.attached()
Parameters
- servo: a variable of type
Servo
Returns
true if the servo is attached to pin; false otherwise.
See also
detach()
Detach the Servo variable from its pin. If all Servo variables are detached, then pins 9 and 10 can be used for PWM output with analogWrite().
Syntax
servo.detach()
Parameters
- servo: a variable of type
Servo