ScratchLink can utilise up to four SR04 Ultrasonic Range Finders. The default max distance is 200cm.
ultra config info
Command Syntax:
ultra[device] config info;
Purpose: Reports configuration information of ultrasonic devices. For example:
{Ultra:0,Enabled:1,Pin:16,Max:300}
{Ultra:1,Enabled:1,Pin:17,Max:200}
ultra config enable
Command Syntax:
ultra[Device] config enable [on|off];
Purpose: Enables/disables ultrasonic device.
Example 1: Enable ultrasonic device 0.
ultra0 config enable on;
Example 2: Enable all configured ultrasonic devices.
ultra config enable on;
Example 3: disable all configured ultrasonic devices.
ultra config enable off;
ultra config default
Command Syntax:
ultra config default;
Purpose: Set to ultrasonics to defaults.
ultra config pin
Command Syntax:
ultraDevice config set pinValue [maxValue];
Purpose: Sets specified ultrasonic device to specified esp32 GPIO pin and sets the maximum detection range.
Example 1: Set ultrasonic range finder 0 to GPIO pin 17 with a maximum range of 200cm.
ultra0 config set 17 200;
ultra config max
Command Syntax:
ultraDevice config max value;
Purpose: Sets specified ultrasonic device to maximum detection range in cm.
Example 1: Set ultrasonic range finder 1 to a maximum range of 200cm.
ultra1 config max 200;
ultra
Command Syntax:
ultraDevice;
Purpose: Returns the ultrasonic range finder reading in cm.
Example 1: Read Ultrasonic device 0 and return value.
ultra0;
Returned data example:
{Ultra:[227]}
Example 2: Return all values from all configured Ultrasonics.
ultrax;
Returned data example:
{Ultra:[227,200]}