Table of Contents
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
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
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+
- Put Rocview in edit mode.
- Select a region with symbols.
- Choose the selection action AMP, and click on OK.
- A save as file dialog will popup.
The AMP data are also available on the clipboard, and can be pasted in an editor:
- Open an editor, and paste the AMP source into it.
- Save it, and use the Browser to upload it to a WIO.