SIO Command $FB Set SSID and Connect

This is a command for Device $70 - The FujiNet Device itself (see SIO-Commands-for-Device-ID-$70).

Set SSID and Connect ($FB)

Description

Given a network SSID string (32 characters + NULL), and a password (64 characters), connect to the requested network.

Both string values are NUL terminated.

Parameters

DCB	Value
DDEVIC	$70
DUNIT	$01
DCOMND	$FB
DSTATS	$80
DBUF	Pointer to a 97 byte buffer containing SSID and password, example struct below
DTIMLO	$0F
DBYT	ENCODED DATA LENGTH
DAUX1	1 = Ask FujiNet to store SSID and password in its configuration immediately; 0 = Information is used, but not saved until a save operation occurs
DAUX2	Encoding Indicator, 0 = NONE, 1 = URL ENCODED DATA

As of 2024/04/21, DAUX2 may contain the scheme used to encode any data on the wire. If there is no encoding, DBYT = 97, otherwise it must contain the length of the 2 encoded strings plus their NUL terminated bytes.

Examples

C

/**
   Network Configuration
*/
union
{
  struct
  {
    char ssid[33];
    char password[64];
  };
  unsigned char rawData[97];
} netConfig;

/**
 * Write desired SSID and password to SIO
 */
unsigned char config_set_ssid(void)
{
  OS.dcb.ddevic=0x70;
  OS.dcb.dunit=1;
  OS.dcb.dcomnd=0xFB; // Set SSID
  OS.dcb.dstats=0x80; // Computer->Peripheral
  OS.dcb.dbuf=&netConfig.rawData;
  OS.dcb.dtimlo=0x0f; // 15 second timeout
  OS.dcb.dbyt=sizeof(netConfig.rawData);
  OS.dcb.daux=0;
  siov();

  return OS.dcb.dstats;
}

See Also

• Get SSID
• Scan Networks
• Scan Result