SIM001

SIM001

Test report

Test vocabulary

The terms the tests are written in: the states the system can be in, the things that can happen, and the shorthand for a few of them together. The docs word each one with its Say:, Set: and Shows:.

The simulator

States

StateCan beTo change it
the opponentsin hand · on the ground · launching · flying · down
the lap counta number from 0 to 5
the cut counta number from 0 to 2
the chaseryou · an opponent
the throttlea number from 0 to 100 %Set the throttle to … with Shift, or with the number keys.
the pitch stickforward · centred · backHold the pitch stick ….
the roll stickleft · centred · right
the wingslevel · banked
the flight controllerfitted · missing
the flight modeMANUAL · ANGLE · ACROPress M on the keyboard until the flight mode is ….
the rateslow · highPress L for … rates.
differential thruston · offPress X to turn differential thrust ….
the viewline of sight · chase · FPVPress C until the view is ….
auto-zoomon · offPress Z to turn auto-zoom ….
the help screenshown · hidden
the simrunning · paused
the batterya number from 0 to 100 %
the gamefree flight · a race · tag
the game clockoff · waiting for takeoff · counting down · running · stopped

Actions

ActionWhat to do
the pilot starts a racePress G.
the pilot starts a game of tagPress T.
the pilot ends the gamePress G again to stop a race, or T again to stop a game of tag.
the countdown endsNothing: it happens by itself.
the pilot flies a lapFly round the outside of pylon 1, pylon 2 and pylon 3. Then fly across the start line.
the pilot cuts a pylonTurn inside the next pylon.
the pilot tags an opponentFly at an opponent until your plane touches it.
the chaser tags the planeNothing: it happens by itself.
the pilot leaves the arenaFly out past the edge of the arena.
the clock runs outNothing: it happens by itself.
the pilot throws the planePress Space to throw the plane.
the pilot resets the planePress R.
the pilot changes flight modePress M on the keyboard.
the pilot changes ratesPress L.
the pilot toggles differential thrustPress X.
the pilot changes the viewPress C.
the pilot toggles auto-zoomPress Z.
the pilot toggles the helpPress H.
the pilot closes the helpPress Esc.
the pilot toggles pausePress P.
the pilot fits a fresh batteryPress V.

Shorthand

PhraseMeans
the pilot flies the raceFly five laps of the course. Keep outside the pylons. (the pilot flies a lap, then the pilot flies a lap, then the pilot flies a lap, then the pilot flies a lap, then the pilot flies a lap)
the sim has just startedStart the sim with the T1-S Ranger. It opens at the pilot box with the plain T1-S, which has no flight controller. The plane is in your hand, the throttle is closed and the flight mode is MANUAL. (the flight controller is missing, the plane is in hand, the throttle is 0 %, the pitch stick is centred, the roll stick is centred, the wings are level, the flight mode is MANUAL, the rates are high, differential thrust is on, the view is line of sight, auto-zoom is on, the help screen is hidden, the sim is running, the battery is at least 99 %, the game is free flight and the game clock is off)
the pilot throws the plane with the throttlePress 4 to set the throttle to 80 %. (the throttle is 80 %)
the pilot closes the throttlePress 0 to close the throttle. (the throttle is 0 %)
the pilot throws the plane nose-downHold W to push the nose down, and at the same time press 5 for full throttle. (the throttle is 100 % and the pitch stick is forward)
the pilot lets go and closes the throttleRelease W. Then press 0 to close the throttle. (the throttle is 0 % and the pitch stick is centred)
the pilot rolls the plane to the leftHold A to roll the plane to the left. (the roll stick is left)
the pilot releases the roll stickRelease A. (the roll stick is centred)

Ground control station

States

StateCan beTo change it
the linkconnected · lost
the vehicledisarmed · armed
the autopilot modeMANUAL · FBWA · FBWB · CRUISE · AUTO · RTL · LOITER · CIRCLE · GUIDED · TAKEOFF · QSTABILIZE · QHOVER · QLOITER · QLAND · QRTLPress … on the vehicle command screen.
the map toolpan · PLAN · GOTO
the plana number from 0 to 650 items
the plan altitudea number from 10 to 300 mSet the plan altitude to … with ALT- and ALT+.
the last plan itemnone · TAKEOFF · WAYPOINT · LOITER_UNLIM · LOITER_TURNS · LAND · RTLChange the last item's command to ….
the takeoffplanned · not planned
the newest waypointat the plan altitude · at another altitude
the vehicle missionempty · up to date · out of date
the home positionset · not set
the waypointsunchecked · clear of the terrain · too low somewhere
the mission filemissing · up to date · out of date
the measured distancehidden · shown
the vehicle's current itema number from 0 to 650
the radiocalibrated · not calibrated
the throttle sticklow · middle · highMove the throttle stick to the … position: all the way down is low, the middle is middle, and three quarters up is high.
the arm switchoff · onPut the arm switch …: SE pressed in is on, and SE out is off (with a toggle fitted in place of the button, up is on and down is off).
the mode switchQHOVER · QLOITER · FBWA · CRUISE · AUTO · QRTLPress the button for … on the front of the radio: button 1 is QHOVER, 2 is QLOITER, 3 is FBWA, 4 is CRUISE, 5 is AUTO and 6 is QRTL.
the aileron stickleft · centred · rightMove the aileron stick …: all the way left, in the middle, or all the way right.
the VTOL's wingslevel · banked
the last landingsoft · hard
the radio lineUSB · serial
the airframeconventional · VTOL
the flightgrounded · hovering · in transition · cruising
the height above homea number from 0 to 300 m
the battery currenta number from 0 to 100 A
the battery voltagea number from 0 to 30 V

Actions

ActionWhat to do
the operator toggles the planning toolPress PLAN.
the operator toggles the fly-to toolPress GOTO.
the operator clicks the mapClick the map.
the operator right-clicks the mapRight-click the map.
the operator raises the plan altitudePress ALT+.
the operator lowers the plan altitudePress ALT-.
the operator adds a takeoffPress +TKOF.
the operator adds a return homePress +RTL.
the operator clears the planPress CLEAR.
the operator uploads the planPress UPLOAD.
the operator downloads the vehicle's missionPress DOWNLOAD.
the operator edits the vehicle's missionPress EDIT.
the operator restarts the missionPress WP1.
the operator arms the vehiclePress ARM. Then press CONFIRM ARM in three seconds or less.
the operator disarms the vehiclePress DISARM.
the operator switches to AUTOPress AUTO.
the operator switches to AUTO anywayPress AUTO. The button shows AUTO: NO MISSION? for four seconds. In that time, press it again.
the operator saves the plan to a fileSave the plan to a file.
the operator loads the plan from the fileLoad the plan from the file.
the operator checks the heights against the terrainCheck the heights against the terrain.
the operator draws a survey gridDraw a survey grid.
the operator measures between two pointsMeasure between two points.
the pilot throws the plane in the simClick the sim window. Then press Space to throw the plane.
the plane reaches a waypointNothing: it happens by itself.
the plane reaches the last itemNothing: it happens by itself.
the pilot calibrates the radioPress F2 in the sim window, and follow the prompts on the screen. Do each step in order: put the sticks in the middle with the throttle all the way down, and press Enter. Push the aileron stick right, the elevator stick up and the rudder stick right, one at a time, and hold each one until the prompt changes. Push the throttle stick all the way up. Then the sim asks for buttons for its other functions, one at a time: press Enter to skip all of them, because the arm switch, the mode buttons and the camera knobs are channels, and [[Setting up the TX15]] shows how the sim reads them.
the pilot switches to forward flightPush the throttle stick all the way up, pull the elevator stick back a little, and press button 3 on the front of the radio. The wing motors tilt forward and the plane speeds up.
the pilot switches back to a hoverCentre the elevator stick, put the throttle stick in the middle, and press button 2 on the front of the radio. The plane slows down and the wing motors tilt up.
the pilot switches to QHOVERPress button 1 on the front of the radio. The plane stays in the air, and the wind can move it.
the pilot switches to cruisePress button 4 on the front of the radio, with the throttle stick up. The wing motors tilt forward and the plane flies on its wing.
the pilot sends the plane homePress button 6 on the front of the radio. The plane flies to home, and lands there.
the operator takes off verticallyPress VTOL TKOF. The plane climbs straight up to the plan altitude.
the operator switches to forward flightPress CRUISE. The wing motors tilt forward and the plane speeds up.
the operator switches to hoverPress QLOITER. The plane slows down and the wing motors tilt up.
the operator lands verticallyPress QLAND. The plane comes down straight and stops its motors.

Shorthand

PhraseMeans
the plane is flying a three-waypoint missionDo the steps of [[From plan to flight]], but plan only three waypoints, with no takeoff and no return. (the plan has 3 items, the last plan item is WAYPOINT, the vehicle mission is up to date, the vehicle is armed, the autopilot mode is AUTO, the plane is flying the mission and the vehicle's current item is 1)
the VTOL is hovering over the fieldPut the arm switch on, press button 2 and push the throttle stick up. Wait until the plane is 15 m above the field. Keep the throttle stick up. (the vehicle is armed, the autopilot mode is QLOITER, the flight is hovering, the height above home is at least 15 m and the throttle stick is high)
the VTOL is cruising in FBWALift off as above. Push the throttle stick all the way up, pull the elevator stick back a little, and press button 3. The wing motors tilt forward. Wait until the plane flies on its wing. (the vehicle is armed, the autopilot mode is FBWA, the flight is cruising, the height above home is at least 15 m and the throttle stick is high)
the TX15 is on the serial lineStart the station with `--flight-computer`. The simulated TX15 is on the serial line. Put the throttle stick all the way down, SE out and press button 1. (the radio line is serial, the throttle stick is low, the arm switch is off, the mode switch is QHOVER and the TX15 screen arming is disarmed)
the console is connected to a plane on the groundInstall Rust and Docker Desktop. Then run `cd domains/teleoperation/console && cargo run --release -- --station`. The first time, it builds ArduPlane [[SITL]], which takes approximately 15 minutes. After that, it starts in a few seconds. Three windows open: the console, the [[sensor feed]] and the sim. The console connects to the plane. The plane is on the ground and disarmed, in MANUAL, with home set and no plan. Wait until the ARM button shows ARM, not ARM: NOT READY. (the link is connected, the game clock is off, the vehicle is disarmed, the autopilot mode is MANUAL, the map tool is pan, the plan has 0 items, the plan altitude is 40 m, the last plan item is none, the takeoff is not planned, the vehicle mission is empty, the home position is set, the waypoints are unchecked, the mission file is missing, the measured distance is hidden, the plane is on the ground and the vehicle's current item is 0)
the operator plans two waypointsClick the map at two points over the valley floor near home. (the operator clicks the map, then the operator clicks the map)
the operator plans three waypointsClick the map at three points over the valley floor near home. (the operator clicks the map, then the operator clicks the map, then the operator clicks the map)
the TX15 is readyPlug the TX15 in over USB, and choose USB Joystick (HID) when EdgeTX asks. Set the radio up once, as [[Setting up the TX15]] shows: load the model with the six buttons on channel 8, calibrate the sticks in the sim with F2, and copy the channels of the switches from controls.cfg.example. Then put the throttle stick all the way down, SE out and press button 1. (the radio line is USB, the throttle stick is low, the arm switch is off and the mode switch is QHOVER)
the console is connected to a VTOL on the groundThe station flies the T1-S VTOL, the default plane, with its two tilt-rotors and its rear rotor. The console shows the Q modes (QHOVER, QLOITER, QLAND and QRTL) with the other modes. Wait until the ARM button shows ARM, not ARM: NOT READY. (the link is connected, the game clock is off, the vehicle is disarmed, the autopilot mode is MANUAL, the map tool is pan, the plan has 0 items, the plan altitude is 40 m, the last plan item is none, the takeoff is not planned, the vehicle mission is empty, the home position is set, the waypoints are unchecked, the mission file is missing, the measured distance is hidden, the plane is on the ground, the vehicle's current item is 0 and the airframe is VTOL)
the VTOL is hoveringArm the plane, and press VTOL TKOF. Wait until the plane has climbed to the plan altitude and stopped. (the vehicle is armed, the flight is hovering and the height above home is at least 15 m)

Flying with a flight controller

States

StateCan beTo change it
the autopilotarmed · disarmed

Actions

ActionWhat to do
the pilot arms the planePress B, the arm switch of ArduPilot.
the pilot opens the throttle to climbPress 4. In the hover modes the middle of the throttle holds the height, and the throttle that you set above it is the climb.

Shorthand

PhraseMeans
the sim has just started with a flight controllerStart the sim with the T1-S VTOL. It opens at the pilot box with the T1-S VTOL, which has a flight controller. The plane is on the ground, the throttle is closed and the flight mode is MANUAL. (the flight controller is fitted, the throttle is 0 %, the pitch stick is centred, the roll stick is centred, the flight mode is MANUAL and the sim is running)

Other aircraft

States

StateCan beTo change it
the other planesilent · sending Remote ID · sending MAVLink · sending bothAsk the other pilot to be ….
the distance to the other planea number from 0 to 8000 mAsk the other pilot to fly … from your plane.
the mapa number from 0 to 40 other planes
the marker of the other planemissing · live · stale
the source of the markernone · Remote ID · MAVLink · Remote ID and MAVLink
the TX15 linkup · lost
your Remote IDon · off
the crowda number from 0 to 40 planesAsk … more pilots to share their positions on the MAVLink network.
the telemetry of your planea number from 0 to 20 position updates per second

Actions

ActionWhat to do
5 seconds passWait 5 seconds.
10 seconds passWait 10 seconds.
70 seconds passWait one minute and 10 seconds.

Shorthand

PhraseMeans
the station is connected to the TX15Switch on the TX15 and the plane. Start the station. The map shows your plane, and no other planes. (the TX15 link is up, your Remote ID is on, the other plane is silent, the distance to the other plane is 200 m, the crowd has 0 planes and the map has 0 other planes)

Watching a real plane

States

StateCan beTo change it
the telemetryflowing · silentLet the telemetry of the plane be ….
the reported distance north of homea number from 0 to 2000 mFly the plane … north of home.
the reported heighta number from 0 to 500 mFly the plane at … above home.
the reported banka number from 0 to 90 degreesBank the plane … to the right.
the reported headingnorth · east · south · westTurn the plane to fly ….
the plane in the viewmissing · shown
the distance north of the pilot box in the viewa number from 0 to 2000 m
the height above the pilot box in the viewa number from 0 to 500 m
the right wing in the viewlow · level · high
the heading in the viewnorth · east · south · west

Actions

ActionWhat to do
1 second passesWait 1 second.

Shorthand

PhraseMeans
the view is listeningStart `sim001_view`. It listens for MAVLink on UDP port 14550. (the plane in the view is missing, the telemetry is silent, the reported distance north of home is 0 m, the reported height is 0 m, the reported bank is 0 degrees and the reported heading is north)

The flight computer

States

StateCan beTo change it
the TX15connected · not connectedConnect the TX15 to the flight computer, or unplug it.
the TX15 roll sticka number from -100 to 100 %Move the roll stick of the TX15 to ….
the TX15 pitch sticka number from -100 to 100 %Move the pitch stick of the TX15 to ….
the TX15 throttle sticka number from 0 to 100 %Move the throttle stick of the TX15 to ….
the TX15 arm switchoff · onPut the arm switch of the TX15 ….
the roll channela number from 800 to 2200 us
the pitch channela number from 800 to 2200 us
the throttle channela number from 800 to 2200 us
the arm channela number from 800 to 2200 us
the corrupted framesa number from 0 to 100 %Let this share of the frames on the serial line have a wrong checksum.
the TX15 screen batterya number from 0 to 30 VLet the battery of the plane be at ….
the TX15 screen banka number from -90 to 90 degreesBank the plane to ….
the TX15 screen airspeeda number from 0 to 60 m/sLet the plane fly at ….
the TX15 screen climba number from -10 to 10 m/sLet the plane climb at ….
the TX15 screen satellitesa number from 0 to 30Let the GPS of the plane have … satellites.
the TX15 screen messagenone · PreArm: Throttle (RC3) is not neutral · Mode QHOVER · Failsafe: radio lostLet ArduPilot say ….
the TX15 uplink qualitya number from 0 to 100 %
the ground station telemetrysilent · flowingLet ArduPilot send, or not send, its MAVLink telemetry.
the ground station map distancea number from 0 to 2000 mFly the plane this far north of home.
the ground station commandnot sent · sentSend a command to the plane from the ground station.
the autopilot commandnot received · received
the ground station telemetry ratea number from 0 to 10000 bytes per second

Shorthand

PhraseMeans
the TX15 is connected and the plane is at restConnect the TX15 to the flight computer with the sticks centred, the throttle stick all the way down and the arm switch off. Start the simulator with --flight-computer PORT. Wait until the screen of the TX15 shows MANUAL and DISARMED. (the TX15 is connected, the TX15 roll stick is 0 %, the TX15 pitch stick is 0 %, the TX15 throttle stick is 0 %, the TX15 arm switch is off, the corrupted frames are 0 %, the TX15 screen mode is MANUAL, the TX15 screen arming is disarmed, the TX15 screen battery is 12 V, the TX15 screen bank is 0 degrees, the TX15 screen airspeed is 0 m/s, the TX15 screen climb is 0 m/s, the TX15 screen satellites is 12, the TX15 screen message is none, the ground station telemetry is silent and the ground station map distance is 0 m)

Flying by plan

States

StateCan beTo change it
the chaser Kestrelfar from the others · behind Merlin and ahead of Swift · near Merlin
the plane that Kestrel pursuesnone · Merlin · Swift
the plan of Merlinnone · pursue · evade · go to · orbit · band · loiter
the plan of Swiftnone · pursue · evade · go to · orbit · band · loiter
the band of Merlinnone · 20 to 30 m · 35 to 45 m · 50 to 58 m
the band of Swiftnone · 20 to 30 m · 35 to 45 m · 50 to 58 m
the pursue plans for the planes not ita number from 0 to 100000
the planes in AGENT modea number from 0 to 3
the refused commandsa number from 0 to 100000
the reports of the hand-overscomplete · incomplete
the flight mode of the planeAGENT · FBWASwitch the plane to …: type `mode …` in the console.
the reply to the plannone · accepted · refused for the mode · refused as malformed
the time to live of the plana number from 0 to 1000 s
the starta level pass over the arena centre · a level pass over home · a dive at the ground · a steep climb · a slow climb · a run at the fence
the other aircraftfar away · round the arena · after your plane · across your path
the track of the other aircraftheard · not heardStop the ADSB_VEHICLE messages of the other aircraft: type `silent` in the console.
the separation limita number from 0 to 50 mSet AGENT_SEP to ….
the fence radiusa number from 0 to 2000 mSet AGENT_FENCE_R to ….
the reported plana number from 0 to 65535
the reported primitivenone · pursue · evade · go to · orbit · band · loiter
the reported fallbacknone · plan expired · bad input · recovery
the reported interventionsa number from 0 to 1000000
the messages about a recoverya number from 0 to 1000
the status reports in 10 secondsa number from 0 to 100
the throttle of the planethe executor's · the pilot's
the closest approach to the pointa number from 0 to 5000 m
the least distance from the point in the last minutea number from 0 to 5000 m
the greatest distance from the point in the last minutea number from 0 to 5000 m
the lowest height in the last minutea number from 0 to 500 m
the highest height in the last minutea number from 0 to 500 m
the interventions in the last minutea number from 0 to 100000
the lowest height of the flighta number from 0 to 500 m
the highest height of the flighta number from 0 to 500 m
the farthest distance from the arena centrea number from 0 to 5000 m
the closest distance to the other aircrafta number from 0 to 5000 m
the distance to the other aircrafta number from 0 to 5000 m
the greatest distance from the other aircraft in the last minutea number from 0 to 5000 m
the airspeed of the planea number from 0 to 60 m/s
the closest distance between two planesa number from 0 to 5000 m

Actions

ActionWhat to do
the ground control agent decidesWait for the next decision of the ground control agent.
the planes play a game of tagScroll up to the report just above `console ready`.
the ground sends a go-to planType `plan goto 80 10 40 0 600` in the console. This plan tells the plane to fly to the point 80 m north and 10 m east of home, at 40 m.
the ground sends a short go-to planType `plan goto 80 10 40 0 5` in the console. This go-to plan is good for only 5 s.
the ground sends an orbit planType `plan orbit 70 0 45 45 600` in the console. This plan tells the plane to circle the arena centre at 45 m from it, at 45 m.
the ground sends a band planType `plan band 70 0 35 10 600` in the console. This plan tells the plane to stay between 35 m and 45 m over the arena.
the ground sends a loiter planType `plan loiter 0 0 0 0 600` in the console. This plan tells the plane to circle where it is.
the ground sends a pursue planType `plan pursue 0 0 0 0 600 2` in the console. The plane chases Merlin, the aircraft with the id 2.
the ground sends an evade planType `plan evade 0 0 0 0 600 2` in the console. The plane breaks away from Merlin, id 2.
the ground sends a malformed planType `plan 9 80 10 40 0 600` in the console. There is no primitive 9.
the ground sends the plan id again with an orbitType `again orbit 70 0 45 45 600` in the console. This sends an orbit plan with the id of the last plan.
the operator watches the status for 10 secondsType `watch 10` in the console. The console counts the AG_PLAN messages in the next 10 s of simulated time.
the plane loses its position estimateNothing: it happens by itself.
the plane gets its position estimate backNothing: it happens by itself.
the plane flies on for 1 secondType `wait 1` in the console.
the plane flies on for 5 secondsType `wait 5` in the console.
the plane flies on for 10 secondsType `wait 10` in the console.
the plane flies on for 30 secondsType `wait 30` in the console.
the plane flies on for 2 minutesType `wait 120` in the console.
the plane flies on for 10 minutesType `wait 600` in the console.
three planes fly random plans for 20 minutesSimulate three planes on random plans for 20 minutes.

Shorthand

PhraseMeans
the agent plane flies in AGENT with no planFrom the top folder of the repository, build the AGENT fork with `AP_DIR=.ardupilot-agent AGENT_EXEC=1 ardupilot/build_native.sh`. Start the runner with `SIM001_BIN=.ardupilot-agent/build/sitl/bin cargo run --release -p cognition_runner -- --agent --console --speedup 10`. Three planes take off and play a game of tag. After about 25 s, the console says `console ready`. Type `reset`. The first plane, Kestrel, flies in AGENT mode with no plan. After each command, the console shows a `status` line. After a plan, it shows an `ack` line first. (the flight mode of the plane is AGENT, the time to live of the plan is 0 s, the reply to the plan is none, the reported plan is 0 and the reported primitive is none)

States

StateCan beTo change it
the TX15 screen modeMANUAL · FBWA · AUTO · RTL · QHOVER · QLOITER · CRUISE · QRTLLet ArduPilot fly this mode.
the TX15 screen armingarmed · disarmedArm or disarm the plane.
the planein hand · being carried back · launching · flying · on the ground · crashed · flying the mission · flying home · loitering