## Support » Qik 2s12v10 User's Guide » 5. Serial Parameters and Commands »## 5.a. Configuration ParametersThe qik 2s12v10 has twelve configuration parameters that are saved in non-volatile memory, which means that once set, these parameters will retain their values even if the unit is powered off. Commands 0x83 and 0x84 are used to read and write these parameter values, respectively (see Section 5.d). Please note that the memory used to store these parameters is only rated for approximately 100,000 erase/write cycles, so you should avoid putting ## 0: Device ID
## 1: PWM Parameter
The least-significant bit (bit 0) selects for 7-bit resolution when cleared (i.e. a speed of 127 results in full voltage to the motors) and 8-bit resolution when set (i.e. a speed of 255 results in full voltage to the motors). A PWM with 7-bit resolution has twice the frequency of one with 8-bit resolution. Bits 1 and 2 give you additional control over the PWM frequency. When combined with the resolution bit, PWM parameter can be set to the following six values: - 0 = 7-bit resolution, high-frequency (PWM frequency of
**19.7 kHz**, which is ultrasonic) - 1 = 8-bit resolution, high-frequency (PWM frequency of
**9.8 kHz**) - 2 = 7-bit resolution, medium-frequency (PWM frequency of
**2.5 kHz**) - 3 = 8-bit resolution, medium-frequency (PWM frequency of
**1.2 kHz**) - 4 = 7-bit resolution, low-frequency (PWM frequency of
**310 Hz**) - 5 = 8-bit resolution, low-frequency (PWM frequency of
**150 Hz**)
Using a PWM parameter of zero produces the highest PWM frequency of approximately 20 kHz, which is outside the range of human hearing and can help make your motors quieter. Using lower frequencies has the benefit of decreasing power losses due to switching. ## 2: Shut Down Motors on Error
- bit 0: if this bit is set, stop motors M0 and M1 when any serial error occurs.
- bit 1: if this bit is set, stop motors M0 and M1 when any motor-over-current error occurs.
- bit 2: if this bit is set, stop motors M0 and M1 when any motor-fault error occurs.
When this parameter has a value of 7, both motors M0 and M1 are stopped as a safety precaution whenever ## 3: Serial Timeout
The timeout duration is specified in increments of 250 ms (a quarter of a second) and is calculated as the four least-significant bits (which are interpreted as a number from 0 – 15) times the quantity 2 to the three most-significant bits (which are interpreted as a number from 0 – 7) power. If the four least-significant bits are called **timeout = 0.25 seconds * L * 2**^{M}= L * 2^{M-2}seconds
For example, if the timeout parameter is set as 0x5E (01011110 in binary), we have that - 0.25s * 14 * 2
^{5}=**112 seconds**.
The maximum timeout duration (arising from a parameter value of 127) is 8 minutes and the minimum timeout duration (arising from a parameter value of 1) is 250 ms. ## 4: Motor M0 Acceleration## 5: Motor M1 Acceleration
When one of these parameters has a value of zero, acceleration control of the associated motor is inactive. Otherwise, the M0 and M1 acceleration parameters control the rate at which the the M0 and M1 speeds are allowed to increase over time, respectively. These parameters provide a great way to smooth out your motor control and reduce current spikes caused by sharp increases in motor speed or changes in motor direction. When acceleration control is active, a - If the target speed is lower than the motor speed and the target direction matches the current direction, the motor speed is immediately set to the target speed.
- If the target speed is higher than the motor speed and the target direction matches the current direction, the qik linearly ramps the motor speed up to the target speed by adding the value of the associated acceleration parameter to the speed every 40 ms.
- If the target direction does not match the current direction, the motor speed is immediately set to zero, and the qik then proceeds to ramp the motor speed linearly from zero to the target speed by adding the value of the associated acceleration parameter to the speed every 40 ms.
For example, if the M0 acceleration parameter is 1, it takes a stationary motor M0 5.08 s (127 * 40 ms) to reach a speed of 127. If the M0 acceleration parameter is 127, it takes a stationary motor M0 40 ms to reach a speed of 127. The qik actually updates the motor speed 100 times per second, so the speed is really being incremented by a quarter of the acceleration parameter every 10 ms, which results in even smoother acceleration. The following oscilloscope captures show qik acceleration in action. When the yellow line is low, the motor driver is in coast mode, and when the yellow line is high, the motor driver is driving with one output at VIN and the other at ground. The left capture shows the effect of using an acceleration of 127, and the right capture shows a more gradual acceleration using a parameter value of 28. The captures were taken with a low PWM frequency (310 Hz) to make it easier to see the effect of the acceleration on the motor driver output.
Please note that acceleration does not apply to braking or to a speed decrease that does not also result in a change of direction. Motor speed can also be influenced by current-limit settings, which impose additional constraints on the logic detailed above. Please see the current-limit parameters, which are documented later in this section, for more information. ## 6: Motor M0 Brake Duration## 7: Motor M1 Brake Duration
When one of these parameters has a value of zero, requested changes of direction for the associated motor occur immediately. Otherwise, the M0 and M1 brake duration parameters control the amount of time motors M0 and M1 spend braking before the motor direction is changed from forward to reverse or vice versa. Along with the acceleration parameters, these parameters provide a great way to smooth out your motor control and reduce current spikes caused by changes in motor direction. These parameters represent a time duration in units of 10 ms, so a value of 127 results in a brake duration of 1.27 s. For example, if the M0 brake duration has a value of 50 and M0 is moving forward, issuing an M0-reverse ## 8: Motor M0 Current Limit / 2## 9: Motor M1 Current Limit / 2
When one of these parameters has a value of zero, current limiting is inactive for the associated motor. Otherwise, the current-limiting behavior is determined by the current-limit response parameters (see their parameter description below for more details). Please note that these parameters specify ## 10: Motor M0 Current-Limit Response## 11: Motor M1 Current-Limit Response
The qik lets you limit the current motors M0 and M1 are allowed to draw. It does this by decreasing power to the motors if their currents exceed the current limits that have been set (see the description of the current-limit parameters above for more information). Specifically, every time the motor speed is updated, which happens 100 times per second, the current being drawn by the motors is compared to the current-limit parameters. The following current-limiting logic is then performed every 10 ms: - If current limit = 0, there is no current limit; take no actions based on motor current, and use acceleration logic only, if applicable.
- Else if current-limit response = 0, generate a motor-over-current error if the motor current exceeds the current limit.
- Else add the following signed change to the motor speed, making sure the result does not exceed the target speed or go negative:
**min( acceleration, response * ( current limit – current ) ) / 4**
If the current-limiting feature for a motor is enabled (i.e. the current limit parameter is not zero), current limiting can affect that motor’s acceleration. The current-limit response parameters determine how the motors react when their currents are in the vicinity of their limits. If a motor’s current is just under the limit and its response parameter is small, the motor speed may not be allowed to increase as much as would be dictated by the acceleration parameter alone. If the current is over the current limit, the quantity: - response * ( current limit – current )
becomes negative, and the effect is a reduction in motor speed. The motor speed continues to drop at a rate proportional to the difference between the current and the limit until the current equals the limit. You will most likely need to empirically determine the best response parameter for your particular application. |

Log In | Wish Lists | BIG Order Form | Shopping Cart
US toll free: 1-877-7-POLOLU ~
(702) 262-6648 |
||||||||||||||||

Catalog | Forum | Blog | Support | Ordering | Distributors | About | Contact |
---|