Reporting Channel Status on Web
When a channel's Source is set to None (off) / Script, and the COM Port is being used for Modbus or SDI-12, it is helpful to be able to control the Source Status.
The script can control the colour of the status, the text, and variables that appear when the mouse hovers over the cell.
e.g.
i.chnl[3].src.web={}
i.chnl[3].src.web.label='ModBus'
i.chnl[3].src.web.level=2
i.chnl[3].src.web.data={}
i.chnl[3].src.web.data[1]={'Test','12345'}
i.chnl[3].src.web.data[2]={'---',''} -- horizontal line
i.chnl[3].src.web.data[3]={'Another','Blah blah'}
i.chnl[3].src.web.data[4]={'More','Yadayada'}
When updating the web.data table, it is best to build the table in a temporary table first, and then assign atomically to the web.data value, and/or use the atomic.lock & atomic.unlock methods.
Otherwise things could get out of sync in the display process.
e.g.
local td = {} -- temporary table
td[1] = {'Test', 'Value'}
td[2] = {'More', 'Values'}
table.insert(td, {'---', ''} ) -- alternative
table.insert(td, {'Yet', 'More'} )
atomic.lock()
i.chnl[3].src.web.data = td -- quick atomic assignment
atomic.unlock()
These variables are only used when the Source is set to "None".
Any other mode will ignore them.
The label string is shown on the web-page with a bullet • prefix.
An integer value indicating the colour level.
.level value |
Description |
|---|---|
| 0 | White |
| 1 | Green |
| 2 | Amber |
| 3 | Red |
The data table defines the values that appear in the right side of the web-page when the mouse hovers over the Source cell.
Each table entry should be an indexed table with two values, with [1] being the value name, and [2] being the string value.
If the value name is --- then a horizontal dividing line will be displayed.
There is a finite limit to the text that is injected into the HTML stream, so keep the number of data entries relatively small.