Embedded GUI Design and Development Tool

    Embedded GUI Design and Development Tool
    Download Embedded GUI Development Demos
    Embedded GUI Design and Development Tool


    2 min read

    Storyboard Suite + JSON deliver rich data to embedded UIs

    Dec 15, 2014 11:27:24 AM

    Communicating between a Storyboard application and external sources is straightforward and flexible. Storyboard provides a number of connectivity options ranging from its native SBIO API for system engineers, to JSON (JavaScript Object Notation) for more web-centric programmers.

    JSON with Storyboard

    JSON is a great option to use with Storyboard because of how closely it resembles Lua. They are both lightweight for use in embedded applications, simple for humans to read and write, and easy for machines to parse and generate.

    Using the Lua JSON module makes it easy to encode/decode incoming/outgoing JSON strings to Lua tables, which can then be parsed and used within the Storyboard application.

    Example of JSON String Decoded

    The following Lua example demonstrates how an incoming JSON string is decoded, and how the “message” data is used as the alarm text and the “timeout” data is used to dismiss the alarm dialog box after a certain amount of time has passed.

    local json = require "dkjson"

    function cb_alarm_show(mapargs)
    local ev = mapargs.context_event_data
    local json_data = ev["json"]
    local data = {}

    local json_table = json.decode(json_data)
    if (json_table == nil) then
    return nil

    local alarm = json_table

    -- text message
    data["alarm_l.alarm_c.txt"] = alarm["message"]

    -- make sure the layer is visible
    data = {}
    data["hidden"] = 0
    gre.set_layer_attrs_global("alarm_l", data)

    -- if timout isn't 0 set up a timeout callback
    if alarm["timeout"] ~= 0 then
    gre.timer_set_timeout(cb_alarm_hide, alarm["timeout"])

    Not only can JSON be a solution for local system communication, but also for transmitting data remotely over the Internet. Simply adding the Lua Socket and Lua JSON modules enables Storyboard applications to communicate over the Internet, enabling engineers to easily create IoT (Internet of Things) applications.

    Below is a an example of a Storyboard application requesting weather data from the Internet.

    http = require("socket.http")

    function cb_get_weather(mapargs)
    local v, b, c, h
    local City = "Ottawa,CA"
    local url_current

    local data = {}

    b, c, h = http.request(url_current)
    v = json.decode(b)

    data["Layer.temp.text"] = math.floor(v.main.temp)

    These examples quickly highlight JSON communication. Another option is SBIO, which we will cover in another blog post. Stay tuned!

    Jamie Villeneuve
    Written by Jamie Villeneuve

    Application Engineer at Crank Software

    Post a Comment