sdwifi

simple http server to upload files to FYSETC SD WiFi Pro card

description

The primary use case is my research project on Fujifilm camera custom boot code. For the project I was looking for a convenient way to wirelessly transfer experimental fimrware files to and from SD card that is inserted into the camera slot when the camera's native WiFi cannot be used for that purpose. Otherwise to update/collect the files I had to physically transfser the SD card itself.

While the use case is very specific to my needs the server may still prove to be useful in other similar simple scenarios when it could be reasonably guaranteed by some means that the SD card is not used actively by the host (camera, printer etc) at the time this server is accessing the card. Or if the host is capable to recover gracefully from sporadic SD card access errors.

The code is based on standard Arduino/ESP32 sketches and the orginal FYSETC firmware.

build instructions

clone the repository
compile and upload with arduino-cli (assuming the port is /dev/ttyUSB)
```
cd sdwifi/
./sketch build 
./sketch upload
```
run monitor
```
./sketch monitor
```

if successful you should see "HTTP server started" message:

[   118][I][sdwifi.ino:167] setupAP(): Soft AP created: sdwifi
[   131][I][sdwifi.ino:140] setup(): HTTP server started

usage

By default the server starts as unprotected Wifi Access Point with defaul name "sdwifi" and ip address 192.168.4.1. The AP name and AP password can be changed or the card can be configured to use Wifi STA mode.

The server accepts the following commands:

file operations

 upload   - upload a file to SD card
 download - download a file
 remove   - remove a file
 rename   - rename a file
 sha1     - get sha1 sum of a file
 list     - get file info

directory operations

 mkdir    - create a directory on the SD card
 rmdir    - remove a directory (has to be empty)
 list     - get all file info in a directory

config - change wifi settings

param=value

sysinfo - get general info about the server

ping - returns 0200 empty response

exp - experimental commands

power=off|reset
sleep=sense|ms (sense puts ESP32 to sleep until there is an activity on D3/CS SD finger, ms -- sleep for N ms)

examples

Change AP name and AP password

curl http://192.168.4.1/config?ap_ssid=sdwifi4&ap_password=012345678

Change wifi mode to STA

curl http://192.168.4.1/config?sta_ssid=mywifinetwork&sta_password=mywifinetworkpassword

Reset wifi settings to default (AP mode, no password)

curl http://sdwifi.local/config?reset=all

or reset a parameter selectively

curl http://sdwifi.local/config?reset=sta_ssid

Download a file uilog.bin

curl http://sdwifi.local/download?path=uilog.bin -O -J

Upload file xe2-ffboot.bin as ffboot.bin to the root of SD card

 curl -T xe2-ffboot.bin http://192.168.4.1/upload/ffboot.bin

or when in STA mode

curl -T xe2-ffboot.bin http://sdwifi.local/upload/ffboot.bin

or with POST (from a Form)

curl -F "data=@xe2-ffboot.bin" "http://sdwifi.local/upload?path=ffboot.bin

Remove a file

curl http://sdwifi.local/remove?path=ffboot.bin

Get sha1 sum of a file

curl http://sdwifi.local/sha1?path=ffboot.bin | jq

Rename a file

curl http://sdwifi.local/rename?from=ffboot_new.bin&to=ffboot.bin

Create a directory

curl http://sdwifi.local/mkdir?path=boot

Remove a directory

curl http://sdwifi.local/rmdir?path=boot

Give permanent control over SD to ESP32, blocks access to NAND SD card from the host side

curl http://sdwifi.local/exp?io26=esp32

Relinquish SD control

curl http://sdwifi.local/exp?io26=host

Reboot ESP32

curl http://sdwifi.local/exp?power=reset

Get some info

curl http://sdwifi.local/sysinfo | jq

Get a list of files in / directory

curl http://sdwifi.local/list?path=/ | jq

web application

The server can also be used in a browser with the original firmware web application.

To build the filesystem with the web app:

download the firmware source code
copy ./data from the firmware directory into sdinfo/data
build sdinfo as described above and then execute
```
./fs build upload
```

Levak/sdwifi