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 illucat access point
open web browser and navigate to the gateway IP
change stationMode to 1 in the Settings section for connecting the cat to your own AP. leave it 0 to build a mesh.
change stationSSID and stationPassword to match your AP settings
change the NeoPixel settings according to your hardware. The pin needs to be specified as the pin id of your board, e.g. 4 = D2 on a Wemos D1 Mini.
submit all changes
hit restart under the System section
illucat connects to your network and can be reached with http://illucat (or any other configured hostname)

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 192.168.4.1

now you can enter the SSID and Password of your WLAN, press save (and may reset the esp)

the Cat should now joined your network

find the ip of your cat in your DHCP table

have fun

2.6 KiB Raw Blame History