Wi-Fi and RTSP Camera Stream¶

Fit the FIN card and the camera. Unplug USB-C first. Set JP3 to GPIO (the slot supply then follows GPIO14, which fin cycle needs to power-cycle the card), insert the FIN card into the microSD slot and the camera cable into FPC1, check that SW7 is on CAM and SW8 on PWR, connect U6, and plug in USB-C last.

(Optional) Build the FIN card firmware. You need it only to update the card (step 10). From the SDK root:

make -C apps/platform/ipro6_if_wifi DEFCONFIG=defconfig_ipro6_sdio

Output: apps/platform/ipro6_if_wifi/build_ipro6_sdio/build_out/ipro6_if_wifi_IPRO6.bin. This configuration starts Wi-Fi and the SDIO bridge on its own about 600 ms after reset; nothing is typed on the FIN card, and the Reef drives association and DHCP.

Build the Reef's Wi-Fi version.

make -C apps/platform/ipro7ai_reef_demo DEFCONFIG=defconfig_wifi_ipro6s

Output: apps/platform/ipro7ai_reef_demo/build_wifi_ipro6s/build_out/ipro7ai_reef_demo_IPRO7.bin. This configuration adds components/network/ipronet_host (the SDIO host side), lwIP and the RTSP server (port 8554) to the out-of-box firmware, and drops the USB microphone (mic usb) to make room.

Flash. Hold SW1 (BOOT), tap SW2 (RESET) and release SW1 to enter download mode (if the out-of-box firmware is running, reboot_dl does the same), then from the IntelProCube directory:

./ipro_iot_tool_macos --chipname ipro7 --chip-variant IPRO7AI \
    --port /dev/cu.usbserial-XXXX --baudrate 921600 \
    --pt chips/ipro7/partition/partition_cfg_2M.toml \
    --firmware <SDK>/apps/platform/ipro7ai_reef_demo/build_wifi_ipro6s/build_out/ipro7ai_reef_demo_IPRO7.bin

./ipro_iot_tool_linux --chipname ipro7 --chip-variant IPRO7AI \
    --port /dev/ttyUSB0 --baudrate 921600 \
    --pt chips/ipro7/partition/partition_cfg_2M.toml \
    --firmware <SDK>/apps/platform/ipro7ai_reef_demo/build_wifi_ipro6s/build_out/ipro7ai_reef_demo_IPRO7.bin

.\ipro_iot_tool.exe --chipname ipro7 --chip-variant IPRO7AI `
    --port COM5 --baudrate 921600 `
    --pt chips/ipro7/partition/partition_cfg_2M.toml `
    --firmware <SDK>\apps\platform\ipro7ai_reef_demo\build_wifi_ipro6s\build_out\ipro7ai_reef_demo_IPRO7.bin

Check the output for [All Success] (the tool exits with 0 even on failure).

Open the console and check the FIN card. Open the console at 115200 baud and tap SW2. The boot log ends with the available commands (level and time fields left out):

REEF: shell ready - `reef`, `led`, `btn`, `spk`, `mic`, `sd`, `fin`, `cam`, `hp`
REEF: IPRO-WiFi - `ipronet_up <ssid> <psk>`
REEF: RTSP - `rtsp_cam on [fps]`

Type fin to check that the card is seated and powered:

IPRO6S_FIN: SDIO slave in the SD slot, SD_VDD = its 3V3.
  seated : yes (DET GPIO15)
  supply : on (GPIO14, JP3 2-3 required for control)
  host   : SDH_0 on GPIO28-33, see apps/platform/ipro7_sdio_wifi
fin cycle | fin power on|off

("JP3 2-3" in the message is the jumper name of an earlier board revision; on the V4.0 board it is JP3 = GPIO.)

Start Wi-Fi and scan for access points.

ipronet_up
ipro6s_scan
ipro6s_scan_last

Without arguments, ipronet_up only starts Wi-Fi on the FIN card and prints ipronet_start -> 0. ipro6s_scan starts a scan whose results arrive asynchronously; after a second or two, ipro6s_scan_last lists the latest result:

[ctrl] scan_last: <count> APs (on_scan_result fired <n> times)
   0 ssid=<SSID>                           rssi=<signal> ch=<channel> auth=<security>

Join the access point.

ipro6s_connect <SSID> <passphrase>

[ctrl] connect '<SSID>' -> 0 (CONNECTED_IND + IP_UPDATE_IND arrive async)
[ctrl] STA CONNECTED
[ctrl] IP <IP address> / <netmask> gw <gateway>

To start and connect in one go, type ipronet_up <SSID> <passphrase> right after a reset instead. If no [ctrl] IP … line appears, type ipro6s_link_status: host connected=1 ip=1 means the link is up with an address.

Start the RTSP stream.

rtsp_cam on

It starts the camera if it is not running yet, then prints the format and the URL:

rtsp_cam: on, <sensor> <width>x<height> JPEG q<quality>, 15 fps
rtsp_cam: rtsp://<IP address>:8554/av0_0

The default is 15 fps; rtsp_cam on <fps> takes 1 to 30.

Watch it on the computer. With the computer on the same network, open a network stream in VLC (Media > Open Network Stream) with the URL from the previous step, or use ffplay:

ffplay rtsp://<IP address>:8554/av0_0

rtsp_cam stats shows the frames sent, the average JPEG size and encoder errors; rtsp_cam off stops sending (the camera keeps running until cam stop); ipronet_down shuts Wi-Fi down.

Update the FIN card firmware. ipro6s_ota downloads an IPRO6S OTA package from an HTTP server and writes it to the FIN card, whose boot2 installs it after a restart. The package is an IPRO6S package generated by IntelProCube (FW_OTA.bin.xz.ota, a 512-byte header plus XZ-compressed content); for the steps that turn the build from step 2 into a package, contact INTELPRO. Put the package in a folder on your computer and serve that folder over HTTP:

python3 -m http.server 8000

At the Reef's console (with Wi-Fi connected), type:

ipro6s_ota http://<computer IP>:8000/FW_OTA.bin.xz.ota

The whole update takes about 30 to 60 seconds: the Reef stops Wi-Fi traffic and downloads the package, the FIN card writes and checks it and restarts to install it, and the Reef enumerates the card again and reconnects. On success it prints:

[ota] fetch <bytes> B in <ms> ms
[ota] RESULT OK total=<ms> …

On failure it prints [ota] RESULT ERR rc=<code> … phase=<phase>.