User Tools

Site Tools


arduino:amp-en

French VersionDeutsche VersionEnglish Version

WIO User Bitmaps

File System

The SPIFFS, SPI Flash File System, is required to be able to Upload user defined images to the WIO sketch.
See: WIO Firmware


The AMP (ASCII-MAP) Format

To make it easy to define a small bitmap/icon, an ASCII-MAP text file format is used.
The file name format is defined as follows:

<number>.amp

The number is in range between 0 and 999.
The maximum size is 128x64 pixel.
Tip: It is recommended to use a simple text editor with a monospace font like Courier.

Example

Lines starting with a '#' are regarded as comment.
All other lines contains X'es and white space. Any character can be used as white space, excluding the 'x' and 'X'.
In the following example blanks are used as white space.
The bitmap/icon width and height are calculated automatically.
An 'X' represents a display pixel which should be turned on.

# DB, Deutsch Bahn, Logo
 XXXXXXXXXXX 
X           X
X XXX  XXX  X
X X  X X  X X
X X  X XXX  X
X X  X X  X X
X XXX  XXX  X
X           X
 XXXXXXXXXXX

The {b#} display command is used to make it visible.
See: Display commands
rocrail-logo-amp.jpg
The text content in Rocrail for this example:

{E}
{L0X0b55X18} Deutsche Bahn
{L2X0b56X18} Nederlandse Spoorwegen
{L4X0b999}
{P}

(55.amp is the DB, 56.amp the NS, and 999.amp the Rocrail logo.)


Upload by WEB Browser

This method is only available for four minutes after WIO boot.

Get the hostname or IP of the WIO

Check the router of the home LAN which IP or hostname the WIO has:

Open the WEB Browser

Click on the Tripple Dot button on the WIO Setup dialog, or type the IP or hostname of the WIO in the WEB Browser like this:

http://192.168.100.140

The following page will show up:

Click on the "List files…" button to change to the file listing page:

The directory structure is kept flat for best performance.

Actions

Remove

Remove the listed file from the WIO.

Download

Download the listed file from the WIO to the local file system.

Choose file

Select the wanted file for uploading.

Upload

Transfer the selected file to the WIO.


Create AMP (ASCII-MAP) with Rocview

2.1.350+

  1. Put Rocview in edit mode.
  2. Select a region with symbols.
  3. Choose the selection action AMP, and click on OK.
  4. A save as file dialog will popup.

The AMP data are also available on the clipboard, and can be pasted in an editor:

  1. Open an editor, and paste the AMP source into it.
  2. Save it, and use the Browser to upload it to a WIO.

Note: The prefix field is used as AMP comment.

arduino/amp-en.txt · Last modified: 2023/08/17 07:38 by rjversluis