Rabbit RabbitCore RCM4400W Product Manual - page 75
User’s Manual
67
•
Select encryption key—
_WIFI_USEKEY
indicates which
_WIFI_KEYn
key to use.
The default shown below indicates that key 0, defined by
_WIFI_KEY0
,
will be used.
#define _WIFI_USEKEY "0"
•
Use WPA encryption.
The following macro must also be used with WPA encryption.
#define WIFI_USE_WPA
When using WPA encryption,
_WIFI_WEP_FLAG
must be defined as
WIFICONF_WEP_
TKIP
, and you must define a WPA key using
_WIFI_PSK_PASSPHRASE
or
_WIFI_
PSK_HEX
:
•
Set WPA passphrase—
_WIFI_PSK_PASSPHRASE
is a string that matches the pass-
phrase on your access point. It may also point to a variable.
Define an ASCII passphrase here, from 1 to 63 characters long. This passphrase is only
used if you did not specify a hexadecimal key for the
_WIFI_PSK_HEX
macro. The
insecure default is shown below.
#define _WIFI_PSK_PASSPHRASE "now is the time"
•
Set WPA hexadecimal key—
_WIFI_PSK_HEX
is a string of hexadecimal digits that
matches the 256-bit (64-byte) hexadecimal key used by your access point.
Specify a 64 hexadecimal digit (32 bytes) key here. This key will be used and will over-
ride any passphrase set with the
_WIFI_PSK_PASSPHRASE
macro. The example hex
key shown below
#define _WIFI_PSK_HEX \
"57A12204B7B350C4A86A507A8AF23C0E81D0319F4C4C4AE83CE3299EFE1FCD27"
is valid for the SSID
"rabbitTest"
and the passphrase
"now is the time"
.
Using a passphrase is rather slow. It takes a Rabbit 4000 more than 20 seconds to gen-
erate the actual 256-bit key from the passphrase. If you use a passphrase and
#define
WIFI_VERBOSE_PASSPHRASE
, the Wi-Fi library will helpfully print out the hex key
corresponding to that passphrase and SSID.
If both
_WIFI_PSK_HEX
and
_WIFI_PSK_PASSPHRASE
are defined,
_WIFI_PSK_HEX
will be used, and
_WIFI_PSK_PASSPHRASE
will be ignored.
•
Authentication algorithm—
_WIFI_AUTH_MODE
can be used to limit the authentication
modes used.
The default shown below allows enables both open-system authentication and shared-
key authentication.
#define _WIFI_AUTH_MODE WIFICONF_AUTH_ALL
The following authentication options are available.
•
WIFICONF_AUTH_OPEN_SYS
—
only use open authentication
.
•
WIFICONF_AUTH_SHARED_KEY
—
only use shared-key authentication (useful for
WEP only)
.