CONFIG

Last update: May 2018

The FlashAir can be controlled by changing
/SD_WLAN/CONFIG. To activate changed settings, you have to restart the FlashAir by removing and
re-inserting
it. There are hidden attributes attached to this directory, therefore you need tools to handle this hidden
folder.
Please note that any setting changes made by config.cgi may take some time to be reflected in the CONFIG file.
Restart
the FlashAir, then change the CONFIG file. Regarding how to write CONFIG, please see
CONFIG writing sample.

Subnet Mask

Example:

Default Gateway

When DHCP client is disabled, sets the Default Gateway. Default value is "0.0.0.0". When "DHCP_Enabled=YES",
values
are ignored.

Example:

Default_Gateway=192.168.0.1

Preferred DNS Server

(Preferred_DNS_Server)

When DHCP client is disabled, sets the Preferred DNS Server. Default value is "0.0.0.0". When
"DHCP_Enabled=YES",
values are ignored.

Example:

Preferred_DNS_Server=192.168.0.1

Alternate DNS Server

(Alternate_DNS_Server)

When DHCP client is disabled, sets the Alternate DNS Server. Default value is "0.0.0.0". When
"DHCP_Enabled=YES",
values are ignored.

Example:

Alternate_DNS_Server=192.168.0.1

Enable Proxy Server

(Proxy_Server_Enabled)

Sets whether to enable or disable Proxy Server as follows.

YES

Enable Proxy Server

NO (Default)

Disable Proxy Server

Example:

Proxy_Server_Enabled=YES

Proxy Server

(Proxy_Server_Name)

Sets the domain name or IP Address of Proxy Server. Default is empty. When "Proxy_Server_Enabled=NO", values
are ignored.

Example:

Proxy_Server_Name=yourproxy.comProxy_Server_Name=123.123.0.1

Proxy Server Port Number

(Port_Number)

Sets the Port Number of Proxy Server. Default value is "8080". When "Proxy_Server_Enabled=NO", values are
ignored.

Example:

Port_Number=8080

Set connection time-out period

(APPAUTOTIME)

Sets the automatic time-out period for Wireless LAN functionality.

When the Wireless LAN mode is
4, the Wireless LAN functionality will stop if other devices are not connecting to the FlashAir
for the time
specified by this parameter.
The available values are from
60000 to
4294967294, with a default value of
300000. Time is measured in milliseconds.

Specifies
0 to disable the automatic time-out.
Note:
The card would stop ex. if the power supply to the card stops.

APPAUTOTIME is valid only when APPMODE is AP. There will be no timeout due to the time set in APPAUTOTIME
when APMODE
is STA or BRG.

Example:

APPAUTOTIME=3000000

Application's unique information

(APPINFO)

Saves information uniquely used by the application using 1 - 16 characters.

This mode is used to switch the ON / OFF of the wireless LAN function of FlashAir manually.
You can activate the wireless LAN by turning off the image protection of the wireless LAN startup image
(/ DCIM
/ 100__TSB / FA000001.JPG) saved in FlashAir at the time of shipment, and deactivate the wireless LAN by
turning
on the image protection.
Protection ON / OFF is performed mainly on the digital camera side.

In AP mode (i.e. Access Point Mode), the FlashAir behaves like a normal wireless access point - although with
no direct internet
access
The config file parameters
APPSSID and
APPNETWORKKEY set the SSID and Network Security Key respectively.
The security mode is WPA2-AES.

STA mode

In STA mode (ie. Station Mode), the FlashAir becomes a Wireless LAN client. This requires another device to
act as the access
point.
The config file parameters
APPSSID and
APPNETWORKKEY set the SSID and Network Security Key respectively.
Please refer to
Advanced Tutorials - Using Station Mode for further
information.

Internet pass-thru mode

In Internet pass-thru mode, the FlashAir becomes both a Wireless Access Point, and a Wireless LAN client.
This allows you to connect to the internet while also connected to your FlashAir.
If the card fails to connect to the second access point, only AP mode functionality will be enabled.
The config file parameters
APPSSID and
APPNETWORKKEY set the SSID and Network Security Key respectively.
The security mode is WPA2-AES.
The config file parameters
BRGSSID and
BRGNETWORKKEY set the SSID and Network Security Key to use for the second access point.
Please refer to
Advanced Tutorials - Using Internet Pass-Thru Mode for more
information.

Example:

APPMODE=4

NETBIOS/Bonjour name

(APPNAME)

Sets the name returned from NETBIOS or Bonjour in 15 characters.

If there is no setting in the CONFIG file, or there is no CONFIG file, the name becomes
flashair.

Network security key for Internet pass-thru Mode

Example:

SSID for Internet pass-thru Mode

Sets the Service Set Identifier (SSID) for Internet pass-thru mode using 1 - 32 characters.

Example:

BRGSSID=myhomelan

Card ID

(CID)

CID is a Card Identifier specified by the SD standard. The identifier is a 32-digit hexadecimal number.

Example:

CID=02544d53573038470750002a0200c201

Wireless boot screen path

(CIPATH)

Sets the full-path of the image to use as the wireless boot screen. The wireless boot screen is an image file
that controls
whether the Wireless LAN is ON or OFF when the Wireless LAN mode (
APPMODE) is
0,
2, or
3.

Example:

CIPATH=/DCIM/100__TSB/FA000001.jpg

Sets the valid opcode of command.cgi

(COMMANDCGI)

Sets the valid opcode of command.cgi.

Example:

COMMANDCGI=100-103

Disable CGI

(DELCGI)

Disables specified CGIs.

Parameters:

Specifies one or multiple values in the following list connecting with comma:

/

Disable file downloading operation.

/command.cgi

Disable command.cgi

/config.cgi

Disable config.cgi

/thumbnail.cgi

Disable thumbnail.cgi

/upload.cgi

Disable upload.cgi

Example:

DELCGI=/,/thumbnail.cgi

DHCP client retransmission count

(DHCPC_RETRANS_MAX)

Sets the number of DHCP client retransmissions. If 0 is specified, retransmit infinitely. The setting value
is
0 to
255.

Example:

DHCPC_RETRANS_MAX=5

DNS operation mode

(DNSMODE)

Selects the DNS operation mode.

0

Returns the FlashAir's IP Address only if the DNS request is done with the APPNAME or
flashair .

1 (Default)

resolves and returns the FlashAir's IP Address to DNS requests. For example, even if APPNAME is set to
'myflashair'
and accessing with http://flashair resolves to the card's IP address

Example:

DNSMODE=1

File path of TLS certificate

(EAPCERT)

Sets the file path of the TLS certificate. Specifiable certificates are in .pfx or .p12 format.

Example:

EAPCERT=/cert.pfx

PEAP password or TLS secret key password

(EAPPASSWORD)

Set PEAP password or TLS secret key password.

Example:

EAPPASSWORD=12345678

Encryption standard

(EAPTYPE)

If EAPTYPE is set when setting STA mode, it operates in 8021X mode (WPA2 Enterprise). The set value is
PEAP ,
TLS . If
PEAP is set, Flashair tries connection using
EAPUSER and
EAPPASSWORD parameters. If
TLS is specified, it connects using client certificate. At this time, specify the SSID of the
access point to be connected with
APPSSID.

EAPTYPE=TLS
EAPCERT=/radius2.p12 # The certificate set in the RADIUS server also works.
EAPPASSWORD=******** # Password set at certification creation
EAPUSER=flashair

User ID to use when EAPTYPE is specified

(EAPUSER)

Sets the user ID to use when EAPTYPE is specified.

Example:

EAPUSER=SMITH

Memory size

(HTTPDBUFF)

By reducing the amount of memory used in the HTTP server, you can increase the amount of memory used in Lua
script
execution. Note that in the case of reducing the memory of the HTTP server, the download throughput will
decrease.
The range of value is from
2920 to
23360. Default value is
23360.

Example:

HTTPDBUFF=2920

Authentication method

(HTTPDMODE)

Specifies authentication method used by built-in HTTP server. Specify one of the following values.

SD Interface Enable Flag

Example:

IFMODE=1

Default configured flag

(LOCK)

This flag indicates whether the default configuration has been completed. If the default configuration is set,
the flag will
be set to
1. If the default configured flag does not exist, the SSID and network security setting screen
will be displayed
when the FlashAir is connected to a web browser. Please do not set this flag to any value other than
1.

Example:

LOCK=1

Path to a Lua script to execute on boot

(LUA_RUN_SCRIPT)

Sets the absolute path to a Lua script that will be executed on boot. The script will run 5 minutes after the
FlashAir boots.

Example:

LUA_RUN_SCRIPT=/bootscript.lua

Path to a Lua script to execute on a write event

(LUA_SD_EVENT)

Sets the absolute path to a Lua script that will be executed on a write event. The script will run every time a
file is written
to the FlashAir. It is executed 0.5 seconds after writing the last data.

Example:

LUA_SD_EVENT=/writescript.lua

Master code

(MASTERCODE)

The master code is a 12-digit hexadecimal number which is used as a password to set the SSID (APPSSID) and
network security
key (APPNETWORKKEY). If the master code is not yet set, please set it via config.cgi before changing any
settings.

Example:

MASTERCODE=0123456789AB

Noise Cancel

(NOISE_CANCEL)

Improves connection at the cost of decreased range of the signal, which can be beneficiary in a noisy
environment.

2

Enable Noise Cancelling

Other (Default)

Disable Noise Cancelling

Example:

NOISE_CANCEL=2

Product code

(PRODUCT)

The product name of the FlashAir.

Example:

PRODUCT=FlashAir

HTTP redirect mode

(REDIRECT)

Changes the HTTP redirect mode. The following modes are available:

1 (Default)

Enable redirecting

0

Disable redirecting

Example:

REDIRECT=1

Address filtering function in STA mode

(STAMAC)

Sets the address filtering function in STA mode. Up to seven can be registered when registering more than
one. In
that case, you need to list multiple lines of STAMAC.

Example:

STAMAC=40b395A0851a

Limited number of connections in STA mode

(STANUM)

Sets the connection limit in STA mode. Up to seven units can be connected if not described.

Example:

STANUM=2

Number of connection retried in STA mode

(STA_RETRY_CT)

Sets how many times to retry connecting to a wireless LAN in STA mode.
0will retry indefinitely.

Example:

STA_RETRY_CT=3

Timezone

(TIMEZONE)

Sets the timezone that will be used to convert from FAT file time to UTC time when FlashAir Drive is run. The
timezone is
stored in 15 minute increments, ranging from
-48 to
54. For example UTC standard time is
0, and Japan time (which is 9 hours ahead), is
36 (9(h)×4(15m)=36).

Example:

TIMEZONE=36

Upload destination directory

(UPDIR)

Specifies the directory to upload.

Example:

UPDIR=/DCIM

Upload operation enabled flag

(UPLOAD)

Sets whether the upload operation is enabled or not using one of following values:

1

Upload operation enabled

Other (Default)

Upload operation disabled

Example:

UPLOAD=1

Vendor code

(VENDOR)

The vendor name of the FlashAir.

Example:

VENDOR=TOSHIBA

Firmware version

(VERSION)

The firmware version for the FlashAir

Example:

VERSION=F24A6W3AW1.00.03

FlashAir Drive(WebDAV)

(WEBDAV)

Sets whether to enable or disable FlashAir Drive. The following modes are available:

0

Disable FlashAir Drive

1

Enable FlashAir Drive（read only）

2

Enable FlashAir Drive. Needs also
UPLOAD=1 to write files.

Example:

WEBDAV=0

Wireless LAN Standard

(WLANAPMODE)

Sets the Wireless LAN Standard as follows.

0x01

802.11b

0x02

802.11g

0x03 (Default)

802.11bg

0x82

802.11ng

Example:

FlashAir™ Developers

A technical information website for developers of Toshiba FlashAir apps or services. FlashAir Developers is operated by Fixstars in cooperation with Toshiba Memory Corporation. To learn more about Fixstars, visit
www.fixstars.com
. ?FlashAir is a trademark of Toshiba Memory Corporation.