Differences

This shows you the differences between two versions of the page.

--- en:iot-open:remotelab:sut:generalpurpose2:b7 [2020/04/28 19:57] – created pczekalski
+++ en:iot-open:remotelab:sut:generalpurpose2:b7 [Unknown date] (current) – external edit (Unknown date) 127.0.0.1
@@ Line 1: / Line 1: @@
+==== B7: Controlling servo ====
+In this scenario, you will control a servo to rotate it to the predefined positions.\\
+Servo is under the red arrow you can see in the video stream, to let you easily observe its position.\\
+Servo is connected to the GPIO D5.
+=== Target group ===
+Beginners
+=== Prerequisites ===
+You need to understand how a typical servomotor looks like and how it works.\\
+The servo is controlled using predefined, precise PWM timing. Most servos share exactly the same model (0-180 degree servos), regardless of their size and power voltage. Classical, analogue servo frequency is 50Hz = 20ms period and duty cycle of the high signal is 1ms for 0deg and 2ms for 180deg. So changing the PWM duty cycle from 1ms to 2ms (5% to 10%) rotates servo. There is no need, however, to implement manually (still you can do it) but you will use a predefined library instead of manually setting up PWM. This brings features like range mapping to control servo logical way (i.e. providing angle, not duty cycle).\\
+The library is ''Servo.h''.
+According to the algorithm of your choice to implement your code, you may hard code rotations one by one or i.e. declare a table with rotation targets and then iterate over it, so familiarity with array operations in C is essential in this case.
+=== Scenario ===
+In this scenario, you will rotate the servo to 0 degrees, then 45, 90, 135 and 180 degrees counter wise, then 180, 90, 0, clockwise. Note - Arrow pointing left means servo is set to 0, pointing right is 180 degrees, and when 90 degrees, arrow points down.
+We use LCD to get feedback about the requested servo angle and to compare it with the result, but please note, it is just for information only and is not necessary to implement servo rotation.
+<note warning>Please DO NOT use ''loop()'' to implement infinite servo rotation as it will wear out quickly and can even burn. Servo is NOT INTENDED to rotate as a motor. Instead, implement your code to run once or twice in the ''setup()'' function. You may reset the node to restart your code without the need to recompile.</note>
+=== Result ===
+You should see the red arrow rotating as predefined in the scenario.
+=== Start ===
+There are no special steps to be performed.
+=== Steps ===
+== Step 1 ==
+Include servo driver library:
+<code c>
+#include <Servo.h>
+</code>
+== Step 2 ==
+Define a servo management class:
+<code c>
+...
+Servo servo;
+...
+</code>
+If you intend to implement your solution with rotation targets array, here is a hint on array declaration:
+<code c>
+...
+byte angles[] = {0,45,90,135,180,90,0};
+...
+</code>
+== Step 3 ==
+Instantiate software controller component for the LCD display:
+<code c>
+...
+LiquidCrystal_I2C lcd(0x3F,20,4);   // set the LCD address to 0x3F for nodes 1 through 5,
+                                 //8 and 9 for a 20 chars and 4 line display
+//LiquidCrystal_I2C lcd(0x27,20,4); // for nodes 10 and 11 only!
+...
+</code>
+== Step 4 ==
+In the ''setup()'' function initialize LCD and attach servo, then implement your code:
+<code c>
+...
+  lcd.init(D2,D1);     // initialize the lcd
+  lcd.backlight();
+  lcd.home();
+  lcd.print("Starting");
+...
+  servo.attach(servoPin);
+  servo.write(0); // rotate to 0 degrees.
+...
+</code>
+Setting servo to the desired angle is as simple as calling ''servo.write(angle);''. The default mapping is 0...180 degrees for micro servos we use here.
+\\
+If you implement your solution using rotation targets array, here is a hint on how to implement the ''for'' loop to iterate over an array:
+<code c>
+...
+  for(int i=0; i<sizeof(angles); i++)
+  {
+...
+</code>
+The ''sizeof'' operator above brings you an automated evaluation of the array size during compilation, thus if you add or remove an item(s) from the array in the declaration section, the loop will automatically change iteration scope, according to the new array size.
+<note tip>Give it at least 2s gap between setting subsequent rotation target for the servo. Otherwise, you may be unable to reliably observe results via video stream.</note>
+== Step 5 ==
+Keep ''loop()'' dummy, empty method not to overheat the servo or to wear out its gears:
+<code c>
+...
+void loop()
+{
+}
+</code>
+=== Result validation ===
+Observe the arrow rotating to the desired angle.