Web Interface

From openinverter.org wiki
Jump to navigation Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

The web interface does all the tedious serial commands in the background and allows you to control, parametrize and monitor your inverter via Wifi!

Connecting to the Web Interface: Disconnect your device (phone, laptop, etc) from any other wifi networks. Connect the Wifi module to the inverter (if it is not already). On your device, connect to the "inverterX" wifi network with the supplied credentials (default PW is inverter123) and then use a browser to go to http://192.168.4.1.

Once in the web interface, there are options to have the inverter connect to another wifi network and to change the inverter's wifi network name and password. If you have multiple wifi equipped boards on your vehicle, it is highly recommended that you change their network names to make them easily identifiable (ex: inverter, charge control, VCU etc).

Top section: commands
Top section: commands

Commands

Save Parameters to Flash saves the current parameter values and the CAN message configuration onto the embedded flash. In other words, if you make changes to the latter and do not hit this button your changes will be lost at the next power cycle.

Likewise, Restore Parameters from Flash will do the opposite, it will load the last saved parameter values and CAN configuration from flash memory in case you messed up your configuration

Restore Defaults = factory reset. You can see the default values in the table below.

Start Inverter in manual Mode Just turns on the PWM. It takes parameters ampmin and flslipspnt and runs the motor closed loop. It does NOT close the DC switch, ignores throttle input and does not check for various start conditions. Careful!

Stop Inverter - just that

Display Error Memory - shows the latest 4 errors. Errors are only reset by power cycling. See: Errors for list of errors.

Reset CAN Mapping - Deletes all CAN configuration

Parameter section
Parameter section

Send Custom Command - since not all terminal commands are brought out to the web interface you can enter them here. Like adding the hidden flag to channels

Update

Allows you to upload a firmware update in form of a *.bin file that is then transferred to the STM32. Make sure you're not running a plot or a gauge or are continuously refreshing while doing this! If you upload any other, non-bin file it will be placed into the ESP8266 flash memory. You can make use of that to modify the web interface itself.

Parameters

The Download Parameter File link lets you save your currently displayed configuration as a human-readable JSON file. Likewise you can use the Upload field below it to upload an earlier saved file or one that you found on the internet. Before doing this, open the file in a text editor and make sure you remove any parameter that is custom to your application.

Messages displays the inverters response to the last command.

Toggle Category Visibility collapses or or expands the categories to un-clutter your display.

Numeric parameters have an up/down type numeric box. When you type a value and press enter or go to a different box the value will be sent to the inverter. Enum-parameters have a dropdown list. As soon as you select something new it will be sent to the inverter.

Parameters can not be set to values outside of the Min/Max range. The resolution of the parameters is roughly 0.05.

Spot values
Spot values

Spot values

This table lets you select values for plotting, gauging or mapping to CAN. You can also check the Auto box next to the refresh button to continuously refresh the values.

You can select values by clicking the "l" checkbox and then hit Show Gauges to open a new window where the specified values are constantly polled and displayed. Likewise you can hit the Show Data Logger button to generate a CSV logfile from selected values.

You can select "l" or "r" to plot values on the left or right axis of the plot discussed next.

Finally you can enter a CAN specification (see CAN communication) to map a value to or read it from the CAN bus. Pro tip: you can only map each value once. If you want to map it more than once use the Send Custom Command function with the "can" command!

Hitting Unmap will remove the given value from all CAN messages.

Signal Plotter
Signal Plotter

Plot

Finally maybe the best part, the plotting facility. It lets you plot as many signals as you want at the appropriate update rate. The fewer signals you select, the higher the update rate. The ESP8266 communicates with the STM32 via a 1 MBit/s serial link. So with the highest burst length you can plot one signal at roughly a 100µs time resolution. That is in real time. You can easily see the sine wave character of the current sensors that way.

High speed plot of resolver signals
High speed plot of resolver signals

The Limit Data points to field lets you specify how many data points per signal are displayed in the plot a once. It is limited to 10000 points. The Burst Length lets you specify how many data points are obtained from the inverter at each polling cycle. So for long term plotting you would limit the data points to 10000 and have a burst length of 1. This would fit roughly 40 minutes of data in one screen (one poll cycle takes roughly 250ms). For real time plots you would limit to 1000 points and poll 1000 points. It will look like a slowly updating scope and give you about 100ms of data.