View source for Template:GreenDrivingFeature

{{GreenDrivingFeature
|intro_paragraph=
The **Green/Eco Driving feature** is designed to monitor and improve driving behaviors by identifying harsh driving actions such as rapid acceleration, abrupt braking, and aggressive cornering. This functionality leverages the built-in accelerometer or GPS data and provides configurable thresholds for flexibility. It plays a key role in reducing vehicle wear, enhancing fuel efficiency, and promoting responsible driving practices across fleets.

|functional_purpose=
== Functional Purpose ==
The primary objective of Green/Eco Driving is to detect and discourage harsh driving patterns, which can lead to higher fuel consumption, increased maintenance costs, and compromised safety. By monitoring:
* Acceleration forces,
* Braking forces, and
* Cornering forces,
this feature ensures proactive feedback to drivers and generates actionable data for fleet managers. 

When configured, outputs such as buzzers or LEDs can be activated to immediately alert drivers about undesirable actions. This real-time feedback mechanism ensures safer and eco-friendly driving practices.

|parameters_table=
{| class="wikitable"
|+ Green/Eco Driving Parameters
|-
! Parameter ID !! Parameter Name !! Default Value !! Value Range !! Description
|-
| 11000 || Scenario Priority || 0 (Disabled) || 0-3 || Determines the importance level of the scenario. Options:
* 0: Disabled,
* 1: Low Priority,
* 2: High Priority,
* 3: Panic Priority.
|-
| 11004 || Max Acceleration || 2.31 m/s² || 0.5-10 m/s² || Configures the maximum acceleration threshold. Exceeding this triggers a harsh acceleration event.
|-
| 11005 || Max Braking || 2.52 m/s² || 0.5-10 m/s² || Configures the maximum braking threshold. Exceeding this triggers a harsh braking event.
|-
| 11006 || Max Cornering || 2.94 rad/s or m/s² || 0.5-10 rad/s (GPS), 0.5-10 m/s² (Accelerometer) || Configures the maximum cornering force. Exceeding this triggers a harsh cornering event.
|-
| 11007 || Data Source || 0 (GPS) || 0-1 || Configures the source of data:
* 0: GPS (Angular change-based detection),
* 1: Accelerometer (Force-based detection).
|-
| 11008 || Event Duration Recording || Disabled (0) || 0-1 || Configures if additional records are saved for event durations:
* 0: Disabled,
* 1: Enabled.
|}
== Additional Parameters ==
* **DOUT Activation Timing**:
  * ON Duration (ID: 11001): Configurable between 100–5000 ms (default: 200 ms).
  * OFF Duration (ID: 11002): Configurable between 0–5000 ms (default: 200 ms).
* **SMS Alerts**:
  * Phone Number (ID: 7034): GSM numbers to send alerts.
  * SMS Text (ID: 8034): Customizable event text message.

|detection_conditions=
== Conditions for Event Detection ==
Green/Eco Driving events are detected under specific operating conditions to ensure accuracy and reliability:
* **For Acceleration and Braking Events**:
  * Ignition must be ON.
  * Vehicle speed must be ≥ 10 km/h.
* **For Cornering Events**:
  * Ignition must be ON.
  * Vehicle speed must be ≥ 30 km/h.
These conditions prevent false-positive detections during low-speed maneuvers or stationary states.

|event_logic=
== Detailed Event Logic ==
=== When Accelerometer is the Data Source ===
1. Accelerometer data is sampled every 100–200 Hz depending on firmware version.
2. When a configured threshold is exceeded:
   * A 1-second window of data is collected.
   * If more than 50% of the samples in this window exceed the threshold, an event is registered.
3. Harsh driving conditions:
   * Acceleration and braking events require speed ≥ 10 km/h.
   * Cornering events require speed ≥ 30 km/h.

=== When GPS is the Data Source ===
1. The device calculates angular changes and vehicle speed.
2. Harsh cornering is detected if the calculated angle change (in rad/s) exceeds the threshold.
3. The calculation involves:
   * Difference in GPS heading over 1 second.
   * Conversion of angular change to rad/s using mathematical coefficients.
   * Comparison with configured threshold.

|use_cases=
== Use Cases ==
The Green/Eco Driving feature is particularly beneficial in:
1. **Fleet Management**:
   * Reduces wear and tear on vehicles by promoting safer driving habits.
   * Enhances fuel efficiency by minimizing aggressive driving.
2. **Driver Training**:
   * Provides real-time feedback for improving driving behavior.
   * Helps organizations identify and coach drivers exhibiting harsh driving tendencies.
3. **Safety and Risk Management**:
   * Alerts fleet managers to potential safety risks based on driving data.
   * Helps prevent accidents caused by harsh driving events.

|output_config=
== Output Configuration ==
* **Digital Outputs (DOUT)**:
  * Configurable outputs (e.g., DOUT1 or DOUT2) can trigger external devices such as buzzers or LEDs.
  * Allows real-time feedback to drivers on harsh events.
* **Event Activation Timing**:
  * Output ON duration: Default 200 ms, adjustable between 100–5000 ms.
  * Output OFF duration: Default 200 ms, adjustable between 0–5000 ms.

|sms_notifications=
== Notifications and Alerts ==
Green/Eco Driving supports notification mechanisms to inform fleet managers or relevant stakeholders about harsh driving events:
* **SMS Alerts**:
  * Configurable to send SMS notifications to up to 10 predefined phone numbers.
  * Customizable message text (default: "Green Driving").
* **Server Integration**:
  * Event records are saved and transmitted to servers only when thresholds are exceeded, optimizing data usage.

|best_practices=
== Best Practices for Configuration ==
1. **Set Realistic Thresholds**:
   * Adjust acceleration, braking, and cornering thresholds to suit specific vehicle types and usage scenarios.
2. **Enable Feedback Mechanisms**:
   * Configure digital outputs to provide immediate feedback to drivers during harsh driving events.
3. **Optimize Data Usage**:
   * Limit event recording to scenarios exceeding thresholds to minimize GPRS traffic.

|default_image=[[Image:{{{default_image|green_driving_default.png}}}|300px|right]]
|closing_paragraph=
The Green/Eco Driving feature not only enhances driving safety but also supports eco-friendly practices by reducing fuel consumption and vehicle wear. Its robust configurability and integration capabilities make it an indispensable tool for fleet managers and businesses aiming to optimize operations and promote responsible driving behaviors.
}}