#include "Arduino.h" #include // std::swap #include // Servo drive support for ESP32 #include "esp32-hal-ledc.h" // Part of ESP32 board files - Analog output #include "BluetoothSerial.h" // Bluetooth enablement - part of ESP or standart Arduino lib #include // support for vectors #include #if !defined(CONFIG_BT_ENABLED) || !defined(CONFIG_BLUEDROID_ENABLED) #error Bluetooth is not enabled! Please run `make menuconfig` to and enable it #endif #ifndef __CodeRacer_H__ #define __CodeRacer_H__ //----- Fun stuff --------- #define FUN_MIN_PAUSE_MS 120000 // minimum and maximum pause between to rounds fun #define FUN_MAX_PAUSE_MS 300000 #define LED_SWITCH_MS 50 // speed of knight rider lights //----- Button ------------ #define H_BUTTON_PIN 17 #define BUTTON_BOUNCING_TIME_MS 200 // bouncing delay //----- Servo ----- #define H_SERVO_PIN 16 #define H_SERVO_LEFT_POS 145 // left position of the servo #define H_SERVO_CENTER_LEFT 100 // left-center position of the servo #define H_SERVO_RIGHT_POS 35 // right position of the servo #define H_SERVO_CENTER_RIGHT 80 // right-center position of the servo #define H_SERVO_CENTER_POS 90 // center position of the servo #define H_SERVO_SWEEP_LEFT_POS 140 // most left sweep position of the servo #define H_SERVO_SWEEP_RIGHT_POS 40 // most right sweep position of the servo #define SERVO_SWEEP_TO_LEFT_STEP 5 // sweep step to the left #define SERVO_SWEEP_TO_RIGHT_STEP -5 // sweep step to the right #define SERVO_SWEEP_MS 10 // duration of time betwee to sweep steps #define SERVO_MAX_POSITION 170 // maximum servo position #define SERVO_MIN_POSITION 10 // minimum servo position #define SERVO_SET_1TICK_POSITION_DELAY_MS 3 // minimum duration of time between two servo steps //----- Ultrasonic sensor ----- #define H_US_TRIG_PIN 12 #define H_US_ECHO_PIN 14 #define H_US_STOP_DISTANCE_CM 25 // if the measured distance is smaller the racer maybe stopped #define US_MAX_ECHO_TIME_US 6000 // timeout for ultrasonic sensor measurements - this is about 100cm //----- Drives ----- #define H_DRIVE_RIGHT_SPEED 255 // default speed of right side drive. 0 ...255 #define H_DRIVE_LEFT_SPEED 255 // default speed of left side drive. 0 ...255 #define H_DRIVE_RIGHT_ENABLE_PIN 2 #define H_DRIVE_RIGHT_FWRD_PIN 4 #define H_DRIVE_RIGHT_BACK_PIN 15 #define H_DRIVE_LEFT_ENABLE_PIN 21 #define H_DRIVE_LEFT_FWRD_PIN 22 #define H_DRIVE_LEFT_BACK_PIN 23 #define H_RACER_TURN_LEFT_FOR_MS 400 // duration of time the racer will turn to left #define H_RACER_TURN_RIGHT_FOR_MS 400 // duration of time the racer will turn to right #define DRIVE_PWM_LEFT_CHANNEL 5 // PWM-channel for left side drive #define DRIVE_PWM_RIGHT_CHANNEL 6 // PWM-channel for right side drive //----- LEDs ----- #define H_LED_FRWD_PIN 26 #define H_LED_STOP_PIN 25 #define H_LED_LEFT_PIN 33 #define H_LED_RIGHT_PIN 27 using namespace std; static volatile bool coderracer_activ = false;; static volatile unsigned long button_last_pressed_at_ms = millis(); enum ledstate { LEDOFF, LEDON }; enum drivestate { DRIVESTOP, DRIVEFRWD, DRIVEBACK }; //--- this is as preparation of the class creation class CodeRacer { private: //bluetooth std::vector _bt_ignoremsgs; std::vector _bt_onlymsgs; bool _bluetoothcreated; unsigned long _bt_stopOnLostConnection_timeout_ms; unsigned long _bt_lastmessagereceived; BluetoothSerial* _BTSerial; //pins uint8_t _button_pin; uint8_t _servo_pin; uint8_t _us_trigger_pin; uint8_t _us_echo_pin; uint8_t _drive_left_frwd_pin; uint8_t _drive_left_back_pin; uint8_t _drive_left_enable_pin; uint8_t _drive_right_frwd_pin; uint8_t _drive_right_back_pin; uint8_t _drive_right_enable_pin; uint8_t _led_frwd_pin; uint8_t _led_stop_pin; uint8_t _led_left_pin; uint8_t _led_right_pin; //servo variables int8_t _servo_sweep_step; uint8_t _servo_position; unsigned long _servo_position_set_at_ms; unsigned long _servo_position_eta_in_ms; //drives variables uint8_t _drive_left_speed; uint8_t _drive_right_speed; unsigned long _turn_left_for_ms; unsigned long _turn_right_for_ms; // ultrasonic variables bool _coderacer_stopped_at_min_distance; bool _coderacer_stop_at_distance_enabled; unsigned long _usonic_stop_distance_cm; unsigned long _usonic_stop_distance_us; unsigned long _usonic_distance_us; unsigned long _usonic_distance_cm; //fun stuff variables unsigned long _last_led_switched_at_ms; uint8_t _led_count; uint8_t _last_led_on; unsigned long _servo_look_around_at_ms; unsigned long _min_distance_cm; bool _drive; unsigned long _drive_set_at_ms; bool _servo_sweep; bool _coderracer_activ; //objects Servo* _servo; Servo* _servo_dummy; static void _set_button_state(); void _analog_write(uint8_t pin, uint8_t speed); unsigned long _servo_set_position(uint8_t position); public: //properties bool coderacer_fun_enabled; uint8_t servo_center_pos; /**< The position the servo is looking straight forward. Default is 90 . Allowed are values 10<=pos<=170 */ uint8_t servo_left_pos; /**< The position the servo is looking to the left. Default is 170 . Allowed are values 10<=pos<=170 */ uint8_t servo_right_pos; /**< The position the servo is looking to the right. Default is 0 . Allowed are values 10<=pos<=170 */ uint8_t servo_sweep_left_pos; /**< When the servo is sweeping this is the left most position */ uint8_t servo_sweep_right_pos; /**< When the servo is sweeping this is the right most position */ //methods CodeRacer(); CodeRacer(uint8_t button_pin, uint8_t servo_pin, uint8_t us_trigger_pin, uint8_t us_echo_pin, uint8_t drive_left_frwd_pin, uint8_t drive_left_back_pin, uint8_t drive_left_enable_pin, uint8_t drive_right_frwd_pin, uint8_t drive_right_back_pin, uint8_t drive_right_enable_pin, uint8_t led_frwd_pin, uint8_t led_stop_pin, uint8_t led_left_pin, uint8_t led_right_pin); void set_inactive(); void set_active(); void begin(); // getters bool is_active(); bool is_driving(); bool stopped_at_min_distance(); unsigned long usonic_distance_cm(); unsigned long usonic_distance_us(); uint8_t servo_position(); unsigned long servo_position_set_at_ms(); unsigned long servo_position_eta_in_ms(); uint8_t drive_left_speed(); uint8_t drive_right_speed(); unsigned long turn_left_for_ms(); unsigned long turn_right_for_ms(); // higher level {code}racer services void stop_driving(); void drive_forward(); void drive_forward(uint8_t left_speed, uint8_t right_speed); void drive_backward(); void drive_backward(uint8_t left_speed, uint8_t right_speed); void turn_left(); void turn_left(unsigned long turn_for_ms); void turn_left(unsigned long turn_for_ms, uint8_t left_speed, uint8_t right_speed); void turn_right(); void turn_right(unsigned long turn_for_ms); void turn_right(unsigned long turn_for_ms, uint8_t left_speed, uint8_t right_speed); void start_stop_at_min_distance(); void start_stop_at_min_distance(unsigned long min_distance_cm); void stop_stop_at_min_distance(); // Bluetooth void bt_enable_stopOnLostConnection(); void bt_enable_stopOnLostConnection(unsigned long timeout); void bt_disable_stopOnLostConnection(); void bt_start(String name); String bt_getString(); String bt_getString(uint8_t delimiterbyte); bool bt_msgavailable(); void bt_addStringToIgnoreList(String stringtoignore); void bt_clearIgnoreList(); void bt_removeStringFromIgnoreList(String stringtoignore); // LEDs void set_leds_left_stop_frwd_right(ledstate leftled, ledstate stopled, ledstate frwdled, ledstate rightled); void set_leds_all(ledstate alleds); void set_leds_all_off(); void set_leds_all_on(); // Drives void drives_settings(uint8_t drive_left_speed, uint8_t drive_right_speed, unsigned long turn_left_ms, unsigned long turn_right_ms); void set_drives_states_left_right(drivestate stateleft, drivestate stateright); void set_drive_left_state(drivestate state); void set_drive_right_state(drivestate state); void set_drive_state(drivestate state, uint8_t frwdpin, uint8_t backpin); void set_drives_speed_left_right(uint8_t speedleft, uint8_t speedright); void set_drive_left_speed(uint8_t speed); void set_drive_right_speed(uint8_t speed); void set_drive_speed(uint8_t speed, uint8_t enablepin); void set_drives_stop_left_right(); // Ultrasonic sensor unsigned long usonic_measure_cm(); unsigned long usonic_measure_us(); unsigned long usonic_measure_cm(unsigned long max_echo_run_time_us); unsigned long usonic_measure_us(unsigned long max_echo_run_time_us); unsigned long usonic_measure_single_shot_cm(); unsigned long usonic_measure_single_shot_us(); unsigned long usonic_measure_single_shot_cm(unsigned long max_echo_run_time_us); unsigned long usonic_measure_single_shot_us(unsigned long max_echo_run_time_us); void usonic_set_stop_distance_cm(unsigned long stop_distance_cm); void usonic_set_stop_distance_us(unsigned long stop_distance_us); // Servo drive void servo_settings(uint8_t pos_center, uint8_t pos_left, uint8_t pos_right, uint8_t sweep_left_pos, uint8_t sweep_right_pos); uint8_t servo_set_position_wait(uint8_t position); unsigned long servo_set_position(uint8_t position); void servo_set_to_right(); void servo_set_to_left(); void servo_set_to_center(); void servo_sweep(); // just for fun void kitt(); void look_around(); // previous OBSOLETE german language definitions of the methods - still needed to support MakerLab Murnau {code}racer project // - but use the english ones for new implementations void servo_einstellungen(uint8_t winkel_mitte, uint8_t winkel_links, uint8_t winkel_rechts, uint8_t schwenk_links, uint8_t schwenk_rechts); void motor_einstellungen(uint8_t motor_links_tempo, uint8_t motor_rechts_tempo, unsigned long drehung_links_ms, unsigned long drehung_rechts_ms); void anhalten(); void vorwaerts(); void rueckwaerts(); void links(); void rechts(); void servo_rechts(); void servo_links(); void servo_mitte(); unsigned long abstand_messen(); void servo_schwenk(); bool start_stop(); }; #endif