Below is a short description of the configurations and calibrations you can perform using the Quarky settings/Quarky Debug Extension:
4.1 Firmware Version Check:
4.1.1 By clicking on the check button, the board will send its firmware version, which will be displayed in the empty field (In this example, the firmware version is 4.1).
4.1.2 Version check will be useful for debugging the problems faced by the user. You can determine if any feature that is not working on the board is supported by the firmware version present in the board or not. Example: Ultimate Robots’ extension is not supported on versions < 4.1
4.1.3 Versions 3 and 4 correspond to the previous C++ based firmware, whereas Quarky Python firmware begins from 4.1 onwards. The latest firmware version in PictoBlox v6.2.0 is 5.0.
4.2 Bluetooth Settings
4.2.1 On powering ON, Quarky shows its Bluetooth connectivity status through blue/green color on the bottom right LED of the display (BLUE: Bluetooth disconnected, GREEN: Bluetooth connected). Users can turn off this indicator using the toggle button to the right of the Bluetooth Indication LED option.
4.2.2 The default Bluetooth name of Quarky follows the format “Quarky wxyz” where the wxyz digits stand for the last four digits of the Bluetooth MAC address of the board. Users may change the Bluetooth name to any 12 digit string, including numbers and special characters.
4.3 Motor Calibration
4.3.1 Select the motor you want to test and the direction it should turn, and click on the Run button. Verify if you think it is running in the intended direction, if that is not the case then click on Stop.
4.3.2 Now, to change the direction of the incorrectly configured motor, select it in the dropdown of the Change Default Motor Direction option & click the swap button. Now you can again run the motor using the Test Motor option, and you will find the direction to be corrected.
4.3.3 Quarky will remember this configuration even after power is turned off and will be forgotten only on erasing the flash.
4.4 Servo Pulse Calibration
4.4.1 Servos are adjusted to the desired angle using PWM signals. The signals generally have 50Hz frequency and the angle of the servo is set by the width of the pulses, i.e.,0° corresponds to a 500 µs pulse width, whereas the maximum angle, 180°, corresponds to approximately 2500 µs.
4.4.2 These pulse width values are given just as an example, and it may vary according to the servo used. So to calibrate your servo’s minimum and maximum position, you can set their values in the Min. and Max. Field and click on Set button. You can check the calibration result by running the set servo to [x] angle from the robot palette.
4.5 RGB Test
4.5.1 In case you want to test the proper functioning of the RGB LEDs on your Quarky, press the run button and a LED test sequence will run on your board which you can observe to validate the RGB LEDs. The test sequence would be as follows:
4.5.2 Complete grid would follow the pattern of colors: Red, Green, Blue and then White.
4.5.3 The white color pattern will go from low brightness to high, and then from high to low.
4.5.4 Finally, the rainbow pattern will run on the board.
This above sequence will help you identify any faulty LED present on the board.
4.6 IR Sensors Test
4.6.1 If you want to get the continuous readings of the onboard IR sensors, then you can use this option as the continuous analog sensor data streamed from the board will be visible here and you could use the same to calculate your threshold values for the sensors.
4.7 Output and Input (GPIO) Pins Testing
4.7.1 If you feel like your digital pins output commands are not working properly, then you can test the hardware pins using the blink option. On clicking the ON button, the corresponding pin will go high and low periodically and you can test with an LED or multimeter if the hardware pin state is actually changing or not.
4.7.2 Similarly, to test some sensor’s input values to the hardware pins, you can stream the values read by the Quarky pins continuously by clicking the Get button. You can validate the proper functioning of your Quarky input pins this way, and also calculate the threshold for your analog sensors.
4.8 Touch Calibration
4.8.1 You can check if the touchpads on Quarky are working properly using the Get button beside Touch Sensor Values, this will start filling the T1, T2, etc. fields with the analog values of the touch pins that are being communicated to PictoBlox by Quarky.
4.8.2 Try touching the pads and notice the drop in the readings, and you can then set the touchpads threshold accordingly using the Calibrate Touch Sensor option.
4.9 Push Button Calibration
4.9.1 Pressing the Left and Right push buttons on Quarky sends analog values to PictoBlox which checks the range in which this value falls under and based on that it declares if the left or right push button is pressed.
4.9.2 If push buttons are not working on Quarky, users can check the same using the analog values fetching option and pressing the buttons and observing the values. If the value is shown as just “-”, it means the board is not responding (check if firmware is uploaded on Quarky properly), if the value is stuck at 0, it may suggest a problem with the hardware.
4.9.3 The analog values may differ between boards and the user may wish to change this range for L and R push buttons, and he can do the same using the other two options below the analog values.
4.10 Factory Reset
In case the user wishes to reset the configurations set through the Quarky settings, they can do so by clicking on the Factory Reset button which will delete all the saved Bluetooth name, pulse width, touch threshold, etc. from the board without having to erase the flash which achieves the same.
4.11 Enable auto firmware update
4.11.1 When this option is enabled, PictoBlox will automatically detect the Quarky firmware when connected via USB and update it if required. This ensures that Quarky always runs the latest firmware without manual intervention.
4.11.2 When disabled, PictoBlox will not automatically update the firmware. Users must manually upload the firmware using the “Upload Firmware” button.
4.12 Ultrasonic Sensor Test
4.12.1 You can validate the proper functioning of your Ultrasonic sensor by connecting the echo and trig pins of your ultrasonic sensor to D1 and D2 pins, respectively. On pressing the Get button, you will continuously get the distance measured by the ultrasonic sensor if the sensor is working correctly.
4.12.2 In case you don’t get the distance, please try checking if the sensor you are operating is a 3.3V compatible sensor or not, as Quarky does not support 5V logic level sensors.
4.12.3 Distinguishing 3.3V and 5V Ultrasonic sensors
4.12.4 Check for the part number on the sensor (depicted by the Green box in the image below). Search for the text HC-SR04+, which means it is 3.3V compliant. If the part number is HC-SR04, then it is a 5V version and won’t work with Quarky.
4.12.5 You can also distinguish the 3.3V and 5V sensors by looking at the backside of your sensor and differentiating the presence of C7 capacitor (depicted by the Red highlight box in the image below):
