You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Andrew Tridgell b577787f68 AP_Scripting: use AP_Filesystem API 6 years ago
..
generator AP_Scripting: Allow the bindings to descirbe any build dependencies needed 6 years ago
lua AP_Scripting: use AP_Filesystem API 6 years ago
scripts AP_Scripting: Support enum types, add millis() remove manual GCS wrapper 6 years ago
AP_Scripting.cpp AP_Scripting: Add support for enums to be passed through 6 years ago
AP_Scripting.h AP_Scripting: Add a debug level param 6 years ago
README.md AP_Scripting: Disable by default, fix a nullable type, update README 6 years ago
lua_bindings.cpp AP_Scripting: Fix up some warnings 6 years ago
lua_bindings.h AP_Scripting: Enforce a time limit for a script 6 years ago
lua_boxed_numerics.cpp AP_Scripting: Fix up some warnings 6 years ago
lua_boxed_numerics.h AP_Scripting: Support enum types, add millis() remove manual GCS wrapper 6 years ago
lua_generated_bindings.cpp AP_Scripting: Allow the bindings to descirbe any build dependencies needed 6 years ago
lua_generated_bindings.h AP_Scripting: Allow the bindings to descirbe any build dependencies needed 6 years ago
lua_scripts.cpp AP_Scripting: use AP_Filesystem API 6 years ago
lua_scripts.h AP_Scripting: use AP_Filesystem API 6 years ago

README.md

AP_Scripting

Enabling Scripting Support in Builds

Scripting is automatically enabled on all boards with at least 1MB of flash space. The following example enables scripting, builds the ArduPlane firmware for the Cube, and uploads it.

$ waf configure --board=CubeBlack

$ waf plane

$ waf plane --upload

To run SITL you can simply use the sim_vehicle.py script which will wrap the configuration, compilation, and launching of the simulation into one command for you.

$ Tools/autotest/sim_vehicle.py -v ArduPlane

Once you have a vehicle flashed with scripting you need to set the SCR_ENABLE parameter to 1 to enable scripting and reboot.

Adding Scripts

The vehicle will automatically look for and launch any scripts that are contained in the scripts folder when it starts. On real hardware this should be inside of the APM folder of the SD card. In SITL this should be in the working directory (typically the main ardupilot directory).

An example script is given below:

function update () -- periodic function that will be called
  current_pos = ahrs:get_position()
  home = ahrs:get_home()
  if current_pos and home then
    distance = current_pos:get_distance(ahrs:get_home()) -- calculate the distance from home
    if distance > 1000 then -- if more then 1000 meters away
      distance = 1000;      -- clamp the distance to 1000 meters
    end
    servo.set_output_pwm(96, 1000 + distance) -- set the servo assigned function 96 (scripting3) to a proportional value
  end

  return update, 1000 -- request to be rerun again 1000 milliseconds (1 second) from now
end

return update, 1000 -- request to be rerun again 1000 milliseconds (1 second) from now