Peter Barker 7ceb7c31c7 global: fix whitespace issues in markdown files
global: fix MD007 unordered list indentation in markdown files

Normalize unordered list indentation to use 2-space multiples:
- Top-level list items start at column 0
- Nested list items use 2 additional spaces per level

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

global: fix MD009 trailing whitespace in markdown files

Remove trailing whitespace from all affected markdown files.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

global: fix MD010 hard tabs in markdown files

Replace hard tab characters with 4 spaces.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

global: fix MD012 multiple consecutive blank lines in markdown

Collapse multiple consecutive blank lines to single blank lines
across all markdown files (excluding vendored code).

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

global: fix MD007 list indentation base level in markdown

Shift list indentation left by 2 spaces so top-level list items
start at column 0 instead of column 2.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Tools/scripts: fix MD022 blank lines around headings in markdown

Ensure headings are surrounded by blank lines as required by
markdownlint MD022 rule.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Tools/scripts: fix MD032 blank lines around lists in markdown

Ensure lists are surrounded by blank lines as required by
markdownlint MD032 rule.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Tools/scripts: fix MD031 blank lines around code blocks in markdown

Ensure fenced code blocks are surrounded by blank lines as required
by markdownlint MD031 rule.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Tools/scripts: fix MD047 files should end with single newline

Ensure all markdown files end with exactly one newline character
as required by markdownlint MD047 rule.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Tools/scripts: fix MD023 headings must start at beginning of line

Remove leading whitespace from heading lines as required by
markdownlint MD023 rule.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Tools/scripts: fix MD007 remaining list indentation in markdown

Fix unordered list indentation to use correct spacing as required
by markdownlint MD007 rule.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Tools/scripts: fix MD030 spaces after list markers in markdown

Reduce multiple spaces after list markers to single space as
required by markdownlint MD030 rule.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Tools/scripts: fix MD022 blank lines around setext headings

Ensure setext-style headings (underlined with === or ---) are
surrounded by blank lines as required by markdownlint MD022 rule.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Tools/scripts: fix MD018 missing space after hash in headings

Add space after hash marks in atx-style headings as required by
markdownlint MD018 rule.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Tools/scripts: fix MD019 multiple spaces after hash in headings

Reduce multiple spaces after hash marks to single space in
atx-style headings as required by markdownlint MD019 rule.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Tools/scripts: fix MD012 multiple consecutive blank lines in markdown

Remove multiple consecutive blank lines and ensure files end with
exactly one newline as required by markdownlint MD012 rule.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Tools/scripts: fix MD023 headings with leading whitespace

Remove leading whitespace from setext-style heading text lines
as required by markdownlint MD023 rule.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Tools/scripts: fix MD022 blank line after heading in markdown

Add missing blank line after heading as required by markdownlint
MD022 rule.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Tools/scripts: fix MD009 trailing non-breaking space in markdown

Remove trailing non-breaking space (U+00A0) as required by
markdownlint MD009 rule.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Tools/scripts: fix MD012 remaining multiple blank lines in markdown

Remove leading blank lines and whitespace-only lines that create
multiple consecutive blank lines.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-04 11:37:38 +11:00

2.3 KiB

Web Server Application

This implements a web server for boards that have networking support.

Parameters

The web server has a small number of parameters

WEB_ENABLE

This must be set to 1 to enable the web server

WEB_BIND_PORT

This sets the network port to use for the server. It defaults to 8080

WEB_DEBUG

This enables verbose debugging

WEB_BLOCK_SIZE

This sets the block size for network and file read/write operations. Setting a larger value can increase performance at the cost of more memory

WEB_TIMEOUT

This sets the timeout in seconds for inactive client connections.

Operation

By default the web server serves the root of your microSD card. You can include html, javascript (*.js), image files etc on your microSD to create a full web server with any structure you want.

Server Side Scripting

The web server supports embedding lua script elements inside html files for files with a filename of *.shtml. Here is an example:

<html>
  <head>
       <meta http-equiv="refresh" content="1">
  </head>
  <body>
    <h1>Server Side Scripting Test</h1>
    <table>
      <tr><th>Roll</th><th>Pitch</th><th>Yaw</th></tr>
      <tr>
      <td><?lua return tostring(math.deg(ahrs:get_roll_rad()))?></td>
      <td><?lstr math.deg(ahrs:get_pitch_rad())?></td>
      <td><?lstr math.deg(ahrs:get_yaw_rad())?></td>
      </tr>
    </table>
  </body>
</html>

In this example we are using two forms of embedded lua scripts. The first form starts with "<?lua" and requires you to have a return statement at the end which returns a string. This form can use as many lines as you like.

The second form starts with "<?lstr" and will automatically cast the expression to a string. The second form is for short single value elements.

You can use any of the normal ArduPilot lua script bindings inside these lua embedded elements to access sensor data etc.

CGI Scripts

You can have CGI scripts written in lua by putting them in a directory called "cgi-bin" in the root of the microSD card. The files must have a file extension of ".lua".

Here is an example of a simple cgi script:

--[[
example lua cgi file for cgi-bin/ folder
--]]
return [[
test-from-cgi
2nd line
and a third line
]]

You can use any of the normal ArduPilot lua script bindings inside CGI scripts to access sensor data etc.