Installation

Initial Setup (TODO)

download and flash firmware and filesystem
or: rename example.config.json to config.json, build and upload it yourself

Enduser Setup

Scan for access points
connect to access point "illucat"
open web browser and navigate to http://192.168.4.1
To connect the cat to your own WiFi, open the Settings section and change stationMode to 1 and set stationSSID and stationPassword
submit all changes
hit restart under the System section
illucat connects to your network and can be reached with http://illucat

Install and setup Python

Linux

Download udev rules and follow install instructions in rules file.

wget https://raw.githubusercontent.com/platformio/platformio-core/develop/scripts/99-platformio-udev.rules

MacOs

{TBD}

Windows

download and install python 2.7.x for Windows https://www.python.org/downloads/

now open your command shell (start->cmd.exe) type "python" and hit enter

python

if it starts up the python shell you can type "exit()" and hit enter {IMG} python.png

if you get the error message: "'python' is not recognized as an internal or external command, operable program or batch file" follow the instructions bellow, then resart your shell and retry the python command https://superuser.com/questions/143119/how-do-i-add-python-to-the-windows-path/143121#143121

Install Esptool

now open your command shell (start->cmd.exe) type "python -m pip install --upgrade esptool" and hit enter

python -m pip install --upgrade esptool

{IMG} esptool.png

Flash Firmware

Extract firmware.bin and spiffs.bin

in the command shell window change to the folder where you extracted the .bin files using cd

flash the firmware with the command "python -m esptool --port YOUR SERIAL PORT --baud 115200 write_flash 0x00000 firmware.bin 0x00300000 spiffs.bin" hint: you can crank the baudrate up to 921600 bps ;)

python -m esptool --port COM11 --baud 115200 write_flash 0x00000 firmware.bin 0x00300000 spiffs.bin

Configuration after first boot

the esp will build a AP with ssid name illu and password illumination

when connected browse to http://illucat

now you can enter the SSID and Password of your WLAN and set StationMode to 1
then press save and reset the esp)

the Cat should now joined your network

find the ip of your cat in your DHCP table

have fun

2.4 KiB Raw Blame History