WIO User Bitmaps

Content → Arduino

• WIO Overview | WIO Setup | WIO Control | User Bitmaps | WIO Firmware | LEDScript

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

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.

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.)

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

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.

Remove the listed file from the WIO.

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

Select the wanted file for uploading.

Transfer the selected file to the WIO.

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.