{"type":"doc","content":[{"type":"layoutSection","content":[{"type":"layoutColumn","attrs":{"width":66.66},"content":[{"type":"paragraph","content":[{"text":"Different kinds of GOAL extension modules can be divided:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"libraries for communication profiles provided by port GmbH","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"more complex function blocks","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Device Detection (DD)","type":"text"}]},{"type":"paragraph","content":[{"text":"The Device Detection represents a public interface to read and write CM-variables by other external components or remote devices. It is projected only for development and initial configuration purposes. During normal operation the Device Detection shall be disabled. The source code is located in the directory ","type":"text"},{"text":"…\\goal\\protos\\dd","type":"text","marks":[{"type":"em"}]},{"text":". ","type":"text"},{"type":"hardBreak"},{"text":"The Device Manager tool provides a graphical user interface to read and write CM-variables by a host computer using the Device Detection. This chapter describes a GOAL device used as counterpart to the Device Manager tool. ","type":"text"},{"type":"hardBreak"},{"text":"The Device Detection works according to the producer/consumer model, i.e. a DD-request of the DD-producer is received by one or more DD-consumers and each DD-consumer transmits a DD-response. Each DD-request must be answered by one or more DD-responses. ","type":"text"}]},{"type":"paragraph","content":[{"text":"The data transfer between the DD-producer and DD-consumers is realized via a TCP/IP connection using the UDP protocol. All UDP datagrams are transmitted as broadcast packets to be independent on the IP configuration.","type":"text"}]},{"type":"paragraph","content":[{"text":"The data in the UDP datagram contains a DD-packet, which is coded according to the Device Detection protocol. The Device Detection protocol allows:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"to build groups of devices via a DD-customer-ID,","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"to assign DD-requests and DD-responses to unique devices via the MAC address and","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"to assign DD-requests to DD-responses.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Each DD-consumer can be assigned to a group by a DD-customer-ID. The DD-packet involves the DD-customer-ID of the group, which shall receive the DD-packet. The DD-customer-ID allows a filtering of the received DD-packets. The DD-customer-ID can be configured about the CM-variable DD_CM_VAR_CUSTOMERID. On the local device the CM-variable DD_CM_VAR_CUSTOMERID can be set by function goal_ddCfgCustomerID().","type":"text"}]},{"type":"paragraph","content":[{"text":"The DD-customer-ID 0 disables the filtering of the received DD-packets. A DD-consumer with the DD-customer-ID 0 accepts all DD-packets. A DD-packet with the DD-customer-ID 0 is received from all DD-consumers.","type":"text"}]},{"type":"paragraph","content":[{"text":"A symbolic name can be assigned to each device usable for graphical user interfaces. The remote device can set the symbolic name by the CM-Variable DD_CM_VAR_MODULENAME. On the local device the CM-variable DD_CM_VAR_MODULENAME can be set by function goal_ddCfgModuleName().","type":"text"}]},{"type":"paragraph","content":[{"text":"GOAL initializes the Device Detection automatically in the state GOAL_FSA_INIT if the Device Detection is enabled by the compiler-define GOAL_DD.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Configuration","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Compiler-defines","type":"text"}]},{"type":"paragraph","content":[{"text":"The following compiler-defines are available to configure the Device Detection:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"GOAL_DD:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"0: Device Detection is disabled (default)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"1: Device Detection is enabled","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"CM-variables","type":"text"}]},{"type":"paragraph","content":[{"text":"The following CM-variables are available to configure the Device Detection:","type":"text"}]},{"type":"paragraph","content":[{"text":"Table: ","type":"text","marks":[{"type":"strong"}]},{"text":"DD_CM_VAR_MODULENAME","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"5a3bbe0d-1c7c-4e43-8521-7c9049e3ec37"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[125.0]},"content":[{"type":"paragraph","content":[{"text":"CM-Module-ID","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"#ffffff","rowspan":1,"colwidth":[553.0]},"content":[{"type":"paragraph","content":[{"text":"DD_CM_MOD_ID","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[125.0]},"content":[{"type":"paragraph","content":[{"text":"CM-variable-ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[553.0]},"content":[{"type":"paragraph","content":[{"text":"0","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[125.0]},"content":[{"type":"paragraph","content":[{"text":"CM-variable name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[553.0]},"content":[{"type":"paragraph","content":[{"text":"DD_CM_VAR_MODULENAME","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[125.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[553.0]},"content":[{"type":"paragraph","content":[{"text":"name of the local device, usable by tools for symbolic names This CM-variable can be set by function goal_ddCfgModuleName().","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[125.0]},"content":[{"type":"paragraph","content":[{"text":"CM data type","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[553.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL_CM_STRING","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[125.0]},"content":[{"type":"paragraph","content":[{"text":"Size","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[553.0]},"content":[{"type":"paragraph","content":[{"text":"20 bytes","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[125.0]},"content":[{"type":"paragraph","content":[{"text":"Default value","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[553.0]},"content":[{"type":"paragraph","content":[{"text":"from NVS or 0","type":"text"}]}]}]}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Table: ","type":"text","marks":[{"type":"strong"}]},{"text":"DD_CM_VAR_CUSTOMERID","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"48383fd8-01f2-46f2-8898-64ae7c00a28e"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[120.0]},"content":[{"type":"paragraph","content":[{"text":"CM-Module-ID","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"#ffffff","rowspan":1,"colwidth":[558.0]},"content":[{"type":"paragraph","content":[{"text":"DD_CM_MOD_ID","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[120.0]},"content":[{"type":"paragraph","content":[{"text":"CM-variable-ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[558.0]},"content":[{"type":"paragraph","content":[{"text":"1","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[120.0]},"content":[{"type":"paragraph","content":[{"text":"CM-variable name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[558.0]},"content":[{"type":"paragraph","content":[{"text":"DD_CM_VAR_CUSTOMERID","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[120.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[558.0]},"content":[{"type":"paragraph","content":[{"text":"DD-customer-ID of the local device This CM-variable can be set by function goal_ddCfgCustomerID().","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[120.0]},"content":[{"type":"paragraph","content":[{"text":"CM data type","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[558.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL_CM_UINT32","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[120.0]},"content":[{"type":"paragraph","content":[{"text":"Size","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[558.0]},"content":[{"type":"paragraph","content":[{"text":"4 bytes","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[120.0]},"content":[{"type":"paragraph","content":[{"text":"Default value","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[558.0]},"content":[{"type":"paragraph","content":[{"text":"from NVS or 0","type":"text"}]}]}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Implementation guide","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Initial disabling of features by the application","type":"text"}]},{"type":"paragraph","content":[{"text":"With the call of ","type":"text"},{"text":"goal_ddNew()","type":"text","marks":[{"type":"code"}]},{"text":" from ","type":"text"},{"text":"appl_setup()","type":"text","marks":[{"type":"code"}]},{"text":" a bitmask can be passed with bits representing single functions of DD. Please refer to the ","type":"text"},{"text":"API documentation of DD","type":"text","marks":[{"type":"link","attrs":{"href":"https://portgmbh.atlassian.net/wiki/spaces/GOALR/pages/191562330/GOAL+extension+modules+protos#Device-Detection-(DD)"}}]},{"text":" for possible values. If all bits are set, all features (hello, get, set, get_list, wink) are enabled.","type":"text"}]},{"type":"paragraph","content":[{"text":"The described mechanism can also be set before application start by setting the corrensponding CM variable ","type":"text"},{"text":"FEATURE_DISABLE","type":"text","marks":[{"type":"code"}]},{"text":". Each request processed by the device detection module will utilize the value of this variable to determine, if the request is allowed to be processed. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Please note, that any call of ","type":"text"},{"text":"goal_ddNew","type":"text","marks":[{"type":"code"}]},{"text":" will overwrite the value of this variable, if a different initialization value is passed. ","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Temporary enable features of the device detection","type":"text"}]},{"type":"paragraph","content":[{"text":"This property is applied at an arbitraty time, for example when configured using a web site provided by the AC application. ","type":"text"}]},{"type":"codeBlock","attrs":{"language":"c"},"content":[{"text":"GOAL_STATUS_T goal_ddSessionFeatureActivate(\n GOAL_DD_T *pHdlDd, /*< dd handle */\n uint32_t bitmaskFeatures /*< bitmask with feature enable bits set */ \n); ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The parameter bitmask contains bits representing features being enabled","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Those bits overwrite the disable bits from CM for the current session","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Filtering and access rights","type":"text"}]},{"type":"paragraph","content":[{"text":"This property is applied at starup of the AC application.","type":"text"}]},{"type":"paragraph","content":[{"text":"Using filters it is possible to limit access to CM variables by groups (module ids) and variables (variable ids). Currently some filters are predefined for usage. These can be enabled using following function: ","type":"text"}]},{"type":"codeBlock","attrs":{"language":"c"},"content":[{"text":"GOAL_STATUS_T goal_ddFilterAdd(\n GOAL_DD_T *pHdlDd, /*< dd handle */\n GOAL_DD_ACCESS_FILTER_SET_T setId /*< set id */\n);","type":"text"}]},{"type":"paragraph","content":[{"text":"This function works on a created instance of DD, thus requires passing of a valid DD handle. The setId can be used with following values: ","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"106597ea-578b-47a3-9d09-10d2eca7894a"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[303.0]},"content":[{"type":"paragraph","content":[{"text":"Set Id","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[375.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[303.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL_DD_ACCESS_FILTER_SET_ALL","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[375.0]},"content":[{"type":"paragraph","content":[{"text":"Complete access to all variables","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[303.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL_DD_ACCESS_FILTER_SET_BASIC","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[375.0]},"content":[{"type":"paragraph","content":[{"text":"Filter for minimal ","type":"text"},{"type":"hardBreak"},{"text":"function of the management tool","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[303.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL_DD_ACCESS_FILTER_SET_HIDDEN","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[375.0]},"content":[{"type":"paragraph","content":[{"text":"Filter for hiding critial information","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Configure the local device","type":"text"}]},{"type":"paragraph","content":[{"text":"The local device shall support the Device Detection, therewith the Device Manager tool can set and get CM-variables.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"GOAL initializes the Device Detection automatically in the state GOAL_FSA_INIT if the Device Detection is enabled by the compiler-define GOAL_DD.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set the DD-customer-ID to 1:","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"c"},"content":[{"text":"goal_ddCfgCustomerID(1);","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set the device name:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"c"},"content":[{"text":"uint8_t str[] = “myDev”;\ngoal_ddCfgModuleName(str);","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Now the Device Manager tool can read and write CM-variables on the device “myDev”.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Command line interface (CLI)","type":"text"}]},{"type":"paragraph","content":[{"text":"GOAL provides a command line interface, which is used by GOAL core modules and other GOAL extension modules. The available commands for the command line interface are described in the appropriate chapters. But it is also possible to integrate a command line interface for the own application, see ","type":"text"},{"text":"Chapter: Command structure","type":"text","marks":[{"type":"link","attrs":{"href":"https://portgmbh.atlassian.net/wiki/spaces/GOALR/pages/191562330/GOAL+extension+modules+protos#Command-structure"}}]},{"text":". The source code of the GOAL command line interface is located in the directory …\\goal\\protos\\cli. ","type":"text"},{"type":"hardBreak"},{"text":"The command line interface supports the auto-completion of commands and provides a command history. The size of the command history is configurable during compilation. ","type":"text"},{"type":"hardBreak"},{"text":"The data exchange about the command line interface is realized","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"via a UART connection","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"For further medias please contact ","type":"text"},{"text":"port","type":"text","marks":[{"type":"em"}]},{"text":". ","type":"text"},{"type":"hardBreak"},{"text":"The command line interface provides an interface for debugging, see ","type":"text"},{"text":"Chapter: Command line interface for debugging","type":"text","marks":[{"type":"link","attrs":{"href":"https://portgmbh.atlassian.net/wiki/spaces/GOALR/pages/191562330/GOAL+extension+modules+protos#Command-line-interface-for-debugging"}}]},{"text":". ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"example:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"…\\goal\\appl\\00410_goal\\cli*","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Configuration","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"The following compiler-defines are available to configure the command line interface: ","type":"text"},{"type":"hardBreak"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"GOAL_CONFIG_CLI:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"0: command line interface is disabled (default)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"1: command line interface is enabled ","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"GOAL_CONFIG_CLI_HISTORY:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"0: history of the command line interface is disabled (default)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"1: history of the command line interface is enabled ","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"GOAL_CONFIG_CLI_HISTORY_SIZE:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"number of history entries ","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"GOAL_CONFIG_CLI_UART:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"0: command line interface is not connected via UART (default)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"1: command line interface is connected via UART ","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"GOAL_CONFIG_CLI_DBG:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"0: debug interface of the command line interface is disabled (default)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"1: debug interface of the command line interface is enabled","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Platform API","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"UART connection","type":"text"}]},{"type":"paragraph","content":[{"text":"Table:","type":"text","marks":[{"type":"strong"}]},{"text":" goal_tgtCharGet()","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"3c3abf67-bd3b-4d56-a08f-32bc093c31e1"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[100.0]},"content":[{"type":"paragraph","content":[{"text":"Prototype","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[74.0,504.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL_STATUS_T goal_tgtCharGet(char *pBuf)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[100.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[74.0,504.0]},"content":[{"type":"paragraph","content":[{"text":"This indication function receives a single char from the UART connection.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[100.0]},"content":[{"type":"paragraph","content":[{"text":"Parameters","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[74.0]},"content":[{"type":"paragraph","content":[{"text":"pBuf","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[504.0]},"content":[{"type":"paragraph","content":[{"text":"buffer for a single received char from UART","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[100.0]},"content":[{"type":"paragraph","content":[{"text":"Return values","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[74.0,504.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL return status, see ","type":"text"},{"text":"Chapter: GOAL status","type":"text","marks":[{"type":"link","attrs":{"href":"https://portgmbh.atlassian.net/wiki/spaces/GOALR/pages/191562344/Implementation+specifics#GOAL-status"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[100.0]},"content":[{"type":"paragraph","content":[{"text":"Category","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[74.0,504.0]},"content":[{"type":"paragraph","content":[{"text":"mandatory for GOAL command line interface via UART","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[100.0]},"content":[{"type":"paragraph","content":[{"text":"Condition","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[74.0,504.0]},"content":[{"type":"paragraph","content":[{"text":"none","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Table:","type":"text","marks":[{"type":"strong"}]},{"text":" goal_tgtCharPut()","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"ceec8252-f4a3-4dc3-944f-9500228d5646"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[102.0]},"content":[{"type":"paragraph","content":[{"text":"Prototype","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[74.0,502.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL_STATUS_T goal_tgtCharPut(char c)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[102.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[74.0,502.0]},"content":[{"type":"paragraph","content":[{"text":"This indication function transmits a single char via the UART connection.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[102.0]},"content":[{"type":"paragraph","content":[{"text":"Parameters","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[74.0]},"content":[{"type":"paragraph","content":[{"text":"c","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[502.0]},"content":[{"type":"paragraph","content":[{"text":"single char to send via UART","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[102.0]},"content":[{"type":"paragraph","content":[{"text":"Return values","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[74.0,502.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL return status, see ","type":"text"},{"text":"Chapter: GOAL status","type":"text","marks":[{"type":"link","attrs":{"href":"https://portgmbh.atlassian.net/wiki/spaces/GOALR/pages/191562344/Implementation+specifics#GOAL-status"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[102.0]},"content":[{"type":"paragraph","content":[{"text":"Category","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[74.0,502.0]},"content":[{"type":"paragraph","content":[{"text":"mandatory for GOAL command line interface via UART","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[102.0]},"content":[{"type":"paragraph","content":[{"text":"Condition","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[74.0,502.0]},"content":[{"type":"paragraph","content":[{"text":"none","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Command structure","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Each CLI command is composed of:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"a main-command,","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"one or more sub-commands,","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"an action and","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"one or more optional parameters.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Main-command","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"port","type":"text","marks":[{"type":"em"}]},{"text":" recommends to use \"appl\" as main-command for application-specific commands to separate these commands from the existing commands in the GOAL system.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Sub-command","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"The sub-command is any specific name.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Action","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Table 12 provides an overview about binding action names for standard actions. Not all actions must be implemented by a specific command.","type":"text"}]},{"type":"paragraph","content":[{"text":"Table:","type":"text","marks":[{"type":"strong"}]},{"text":" command line standard action","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"590a1c3f-04c5-483a-b4fd-614403f7a684"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[75.0]},"content":[{"type":"paragraph","content":[{"text":"Action","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[603.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[75.0]},"content":[{"type":"paragraph","content":[{"text":"add","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[603.0]},"content":[{"type":"paragraph","content":[{"text":"adding a value to a set of values, e.g. an entry to a table","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[75.0]},"content":[{"type":"paragraph","content":[{"text":"help","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[603.0]},"content":[{"type":"paragraph","content":[{"text":"put out a help string for the main-/sub-command","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[75.0]},"content":[{"type":"paragraph","content":[{"text":"set","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[603.0]},"content":[{"type":"paragraph","content":[{"text":"set the value of a specified parameter","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[75.0]},"content":[{"type":"paragraph","content":[{"text":"show","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[603.0]},"content":[{"type":"paragraph","content":[{"text":"put out the value of a specified parameter","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[75.0]},"content":[{"type":"paragraph","content":[{"text":"rem","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[603.0]},"content":[{"type":"paragraph","content":[{"text":"removing a value from a set of values, e.g. remove an entry from a table","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Parameters","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Integer values","type":"text"}]},{"type":"paragraph","content":[{"text":"Integer values are currently only accepted with a base of 10 and may optionally contain a sign.","type":"text"},{"type":"hardBreak"},{"text":"Example: The following command sets the port membership of port 1 to VLAN 1024: ","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","content":[{"text":"$ eth vlan port add 1 1024","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Strings","type":"text"}]},{"type":"paragraph","content":[{"text":"Strings are started and ended with a \"-character.","type":"text"},{"type":"hardBreak"},{"text":"Example:","type":"text","marks":[{"type":"underline"}]},{"text":" The following command sets the value of config variable 0-1 to value \"example\" ","type":"text"}]},{"type":"codeBlock","content":[{"text":"$ cm set 0 1 \"example\"","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Port numbers","type":"text"}]},{"type":"paragraph","content":[{"text":"Ports are entered as integer values starting with 0 up to max. port number + 1. Max. port number +1 represents the management port. A 5 port switch provides ports 0 – 3 (external ports) and port 4 as management port.","type":"text"},{"type":"hardBreak"},{"text":"Example: The following commands set the default VLAN tag for port 1 to 1024 with prio 7: ","type":"text"}]},{"type":"codeBlock","attrs":{"language":"c"},"content":[{"text":"$ eth vlan default set 1 1024 7","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":4},"content":[{"text":"MAC addresses","type":"text"}]},{"type":"paragraph","content":[{"text":"MAC addresses are given in the format xx:xx:xx:xx:xx:xx where xx stands for a two char hex number.","type":"text"},{"type":"hardBreak"},{"text":"Example: The following command adds port 3 to MAC address 00:11:22:33:44:55 ","type":"text"}]},{"type":"codeBlock","content":[{"text":"$ eth mactab mac add 00:11:22:33:44:55 3","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":4},"content":[{"text":"IP addresses","type":"text"}]},{"type":"paragraph","content":[{"text":"IP addresses are given in the format xxx.xxx.xxx.xxx where xxx stands for a one- to three-digit decimal number.","type":"text"},{"type":"hardBreak"},{"text":"Example: The following command sets the IP address, netmask and gateway for the TCP/IP stack: ","type":"text"}]},{"type":"codeBlock","attrs":{"language":"c"},"content":[{"text":"$ net ip set 192.168.1.133 255.255.255.0 0.0.0.0","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Creating application-specific commands","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"The following steps are necessary to implement application-specific commands for the command line interface:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create commands, see ","type":"text"},{"text":"Chapter: Command structure","type":"text","marks":[{"type":"link","attrs":{"href":"https://portgmbh.atlassian.net/wiki/spaces/GOALR/pages/191562330/GOAL+extension+modules+protos#Command-structure"}}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Implement the initialization of the application-specific command line interface.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Implement command handlers for main- and sub-commands.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Register commands to the command line interface by function ","type":"text"},{"text":"goal_cliCmdReg()","type":"text","marks":[{"type":"code"}]},{"text":" and make the command handlers of the own commands known.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The commands are processed loop-controlled in the state ","type":"text"},{"text":"GOAL_FSA_OPERATION","type":"text","marks":[{"type":"code"}]},{"text":". It is possible to return a response by function ","type":"text"},{"text":"goal_cliPrintf()","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Chapter 7.2.6.1 shows an example.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Command line interface for debugging","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"The following commands are available for the debug interface:","type":"text"}]},{"type":"paragraph","content":[{"text":"Table: ","type":"text","marks":[{"type":"strong"}]},{"text":"dbg memb show","type":"text"}]},{"type":"table","attrs":{"layout":"full-width","localId":"0181ca80-04e4-431e-b89d-249f264554ee"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[100.0]},"content":[{"type":"paragraph","content":[{"text":"Command","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[91.0,487.0]},"content":[{"type":"paragraph","content":[{"text":"dbg memb show

[count]","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[100.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[91.0,487.0]},"content":[{"type":"paragraph","content":[{"text":"Shows the byte memory value (8 bit) at the given address. If count is given, up to count values will be shown starting at the given address.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":2,"colwidth":[100.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[91.0]},"content":[{"type":"paragraph","content":[{"text":"

","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[487.0]},"content":[{"type":"paragraph","content":[{"text":"The memory address where the reading begins in hex format (0xXXXXXXXX).","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[91.0]},"content":[{"type":"paragraph","content":[{"text":"[count]","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[487.0]},"content":[{"type":"paragraph","content":[{"text":"Specifies the number of values to be read starting at the given memory address.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Table: ","type":"text","marks":[{"type":"strong"}]},{"text":"dbg memw show","type":"text"}]},{"type":"table","attrs":{"layout":"full-width","localId":"ca89fc72-948c-4374-aa45-d2235aebf55b"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","content":[{"text":"Command","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[94.0,487.0]},"content":[{"type":"paragraph","content":[{"text":"dbg memw show

[count]","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[94.0,487.0]},"content":[{"type":"paragraph","content":[{"text":"Shows the word memory value (16 bit) at the given address. If count is given, up to count values will be shown starting at the given address.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":2,"colwidth":[97.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[94.0]},"content":[{"type":"paragraph","content":[{"text":"

","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[487.0]},"content":[{"type":"paragraph","content":[{"text":"The memory address where the reading begins in hex format (0xXXXXXXXX).","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[94.0]},"content":[{"type":"paragraph","content":[{"text":"[count]","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[487.0]},"content":[{"type":"paragraph","content":[{"text":"Specifies the number of values to be read starting at the given memory address.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Table: ","type":"text","marks":[{"type":"strong"}]},{"text":"dbg memd show","type":"text"}]},{"type":"table","attrs":{"layout":"full-width","localId":"4ad70ae0-f3b4-4cd2-90e5-36800fde16f7"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[96.0]},"content":[{"type":"paragraph","content":[{"text":"Command","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[100.0,482.0]},"content":[{"type":"paragraph","content":[{"text":"dbg memd show

[count]","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[96.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[100.0,482.0]},"content":[{"type":"paragraph","content":[{"text":"Shows the double word memory value (32 bit) at the given address. If count is given, up to count values will be shown starting at the given address.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":2,"colwidth":[96.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[100.0]},"content":[{"type":"paragraph","content":[{"text":"

","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[482.0]},"content":[{"type":"paragraph","content":[{"text":"The memory address where the reading begins in hex format (0xXXXXXXXX).","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[100.0]},"content":[{"type":"paragraph","content":[{"text":"[count]","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[482.0]},"content":[{"type":"paragraph","content":[{"text":"Specifies the number of values to be read starting at the given memory address.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Implementation guidelines","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"type":"hardBreak"},{"text":"Create application-specific commands","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"This example assumes that the command line interface is implemented in an own C module, e.g. appl_cli.c.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Digital outputs shall be set via the command line interface. The given value is bit-coded. Each bit relates to a specific DOUT channel. The relevance of the bits in the value can be managed by a bit mask. According to chapter 7.2.3 the command name is:","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"c"},"content":[{"text":"appl dout set ","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Define the string variable in the source code:","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"c"},"content":[{"text":"const char strAppl[] = “appl”; /* main-command */\nconst char strApplDout[] = “dout”; /* sub-command */\nconst char strApplSet[] = “set”; /* action */","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Implement the initialization function to register the commands and to make the handler applCmdHandler() for all commands known:","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"c"},"content":[{"text":"GOAL_STATUS_T applInitCli(void) {\n GOAL_STATUS_T res; /* GOAL return value */\n GOAL_CLI_CMD_T *pApplCliHdl; /* handle to main-command */\n GOAL_CLI_CMD_T *pApplCliSubHdl; /* handle to sub-commands */\n\n /* register main-command */\n res = goal_cliCmdReg(strAppl, NULL, applCmdHandler, NULL,\n pApplCliHdl);\n \n /* register sub-command */\n if (GOAL_RES_OK(res)) {\n res = goal_cliCmdReg(strApplDout, NULL, NULL, pApplCliHdl,\n &pApplCliSubHdl);\n }\n\n /* register action */\n if (GOAL_RES_OK(res)) {\n res = goal_cliCmdReg(strApplSet, NULL, NULL, pApplCliSubHdl, \n NULL);\n }\n \n return res;\n}","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Implement the command handler applCmdHandler():","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"c"},"content":[{"text":" void applCmdHandler(\n GOAL_CLI_DATA_T *pData /* [in] complete received command */\n)\n{\n GOAL_STATUS_T res; /* GOAL return value */\n const char *pStr = NULL; /* string argument from the received command */\n unsigned int len = 0; /* length of the argument in byte(s) */\n uint8_t cmdFound = 0; /* flag to check the existence of the command */\n\n /* The main-command is already analyzed by the GOAL command line\n interface and this command handler was called. */\n\n /* eliminate sub-command from the received command */\n res = goal_cliParamGet(pData, 1, &pStr, &len);\n if (GOAL_RES_OK(res)) {\n /* check sub-command */\n if (strApplDout == pStr) {\n /* eliminate action */\n res = goal_cliParamGet(pData, 2, &pStr, &len);\n if (GOAL_RES_OK(res)) {\n /* check support of action */\n if (strApplSet == pStr) {\n /* execute application-specific action */\n applDoutSet();\n cmdFound = 1;\n }\n }\n }\n }\n /* print a response */\n if ((GOAL_RES_OK(res)) && (1 == cmdFound)) {\n goal_cliPrintf(“command executed\\n”);\n }\n else {\n goal_cliPrintf(“unknown command\\n”);\n }\n return res;\n}","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Implement the application-specific function applDoutSet() to handle the DOUTs.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Register the initialization of the application-specific command line interface. The initialization shall be executed in stage GOAL_STAGE_CLI in state GOAL_FSA_INIT_GOAL.","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"c"},"content":[{"text":"GOAL_STAGE_HANDLER_T stageApplCli;\n\ngoal_mainStageReg(GOAL_STAGE_CLI, &stageApplCli, GOAL_STAGE_INIT, applInitCli);","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Web-server","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"GOAL provides a smart web-server for embedded systems. The web-server was designed:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"for file downloads and","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"to get information about the current device state and properties.","type":"text"}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"The web-server supports the following properties:","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"47c7e8bc-517d-4db1-a3c5-c36dc2a634ff"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[129.0]},"content":[{"type":"paragraph","content":[{"text":"transfer protocols:","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[549.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"HTTP","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"HTTPS","type":"text"}]}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[129.0]},"content":[{"type":"paragraph","content":[{"text":"request methods:","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[549.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"One or more web-pages can be assigned to one instance of the web-server. The web-pages are part of the application and must be made available by the application. The web-server provides a callback function for this purpose, see ","type":"text"},{"text":"cbHttpReqFunc()","type":"text","marks":[{"type":"code"}]},{"text":" in ","type":"text"},{"text":"Chapter: Callback functions","type":"text","marks":[{"type":"link","attrs":{"href":"https://portgmbh.atlassian.net/wiki/spaces/GOALR/pages/191562330/GOAL+extension+modules+protos#Callback-functions"}}]},{"text":". ","type":"text"},{"type":"hardBreak"},{"text":"The current device state and properties can be read from CM-variables and application-specific variables. The application-specific variables can be organized as simple variables or as a one-dimensional list.","type":"text"},{"type":"hardBreak"},{"text":"It is possible to store templates for web-pages with placeholders for current values of application-specific variables. The text substitutions are described in ","type":"text"},{"text":"Chapter: Web-templates","type":"text","marks":[{"type":"link","attrs":{"href":"https://portgmbh.atlassian.net/wiki/spaces/GOALR/pages/191562330/GOAL+extension+modules+protos#Web-templates"}}]},{"text":". Web-templates make the dynamic management of web-pages possible. ","type":"text"},{"type":"hardBreak"},{"text":"The access to the web-server can be limited by user levels. The application can specify, which user levels shall be supported by the device and which rights the user levels shall have. The authentication data consisting of user name and the password for each user level are configurable by CM-variables. The GOAL web-server provides up to 4 user levels.","type":"text"},{"type":"hardBreak"},{"text":"The user levels can be applied by all instances of the web-server. For each instance of the web-server the valid user level can be specified during registration. Web-requests are only transferred to the application after a successful authentication, i.e. the callback function ","type":"text"},{"text":"cbHttpReqFunc()","type":"text","marks":[{"type":"code"}]},{"text":" in ","type":"text"},{"text":"Chapter: Callback functions","type":"text","marks":[{"type":"link","attrs":{"href":"https://portgmbh.atlassian.net/wiki/spaces/GOALR/pages/191562330/GOAL+extension+modules+protos#Callback-functions"}}]},{"text":". is only called after a successful login. The transfer of the user name and the password via a web-server instance using the HTTP transfer protocol is unsafe. ","type":"text"},{"text":"port","type":"text","marks":[{"type":"em"}]},{"text":" recommends using the HTTPS transfer protocol. ","type":"text"},{"type":"hardBreak"},{"text":"HTTPS is activated by the compiler-define GOAL_CONFIG_HTTPS. HTTPS uses the TLS media interface for encoding and authentication. This allows to use different TLS software, like Mbed TLS and WolfSSL, see ","type":"text"},{"text":"Chapter: TLS","type":"text","marks":[{"type":"link","attrs":{"href":"https://portgmbh.atlassian.net/wiki/spaces/GOALR/pages/191562304/GOAL+media+goal+media#TLS"}}]},{"text":". TLS for HTTPS is initialized and opened by function ","type":"text"},{"text":"goal_httpsNew()","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"},{"type":"hardBreak"},{"text":"About the CM-variables for HTTPS it is possible to install a private key and an own X509-certificate for. If no own certificate is stored, the web-server takes a default certificate provided by ","type":"text"},{"text":"port","type":"text","marks":[{"type":"em"}]},{"text":". ","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"example:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"…\\goal\\appl\\goal_http\\01_get*:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"for upload of a web-page","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"…\\goal\\appl\\goal_http\\05_template_cm*:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"for upload of a web-template with CM-variables and application-specific variables","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"…\\goal\\appl\\goal_http\\06_template_list*:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"for upload of a web-template with lists","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"…\\goal\\appl\\goal_http\\04_auth*:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"for authentication about user levels","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"…\\goal\\appl\\goal_http\\02_post*:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"for file download","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Configuration","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Compiler-defines","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"The following compiler-defines are available to configure the webserver: ","type":"text"},{"type":"hardBreak"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"GOAL_CONFIG_HTTP:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"0: transfer protocol HTTP is not used (default)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"1: transfer protocol HTTP is used ","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"GOAL_CONFIG_HTTPS:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"0: transfer protocol HTTPS is not used (default)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"1: transfer protocol HTTPS is used","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"CM-variables","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"The following CM-variables are available to configure the web-server:","type":"text"}]},{"type":"paragraph","content":[{"text":"Table:","type":"text","marks":[{"type":"strong"}]},{"text":" HTTPD_CM_VAR_HTTPD_CHANNELS_MAX","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"0cea5c2b-dfa3-4b7d-9ef7-acf85e5d629c"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[129.0]},"content":[{"type":"paragraph","content":[{"text":"CM-Module-ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[549.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL_ID_HTTPD","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[129.0]},"content":[{"type":"paragraph","content":[{"text":"CM-variable-ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[549.0]},"content":[{"type":"paragraph","content":[{"text":"0","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[129.0]},"content":[{"type":"paragraph","content":[{"text":"CM-variable name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[549.0]},"content":[{"type":"paragraph","content":[{"text":"HTTPD_CM_VAR_HTTPD_CHANNELS_MAX","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[129.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[549.0]},"content":[{"type":"paragraph","content":[{"text":"maximal number of connections available for the HTTP transfer protocol","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[129.0]},"content":[{"type":"paragraph","content":[{"text":"CM data type","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[549.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL_CM_UINT16","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[129.0]},"content":[{"type":"paragraph","content":[{"text":"Size","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[549.0]},"content":[{"type":"paragraph","content":[{"text":"2 bytes","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[129.0]},"content":[{"type":"paragraph","content":[{"text":"Default value","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[549.0]},"content":[{"type":"paragraph","content":[{"text":"from NVS or 0","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Table:","type":"text","marks":[{"type":"strong"}]},{"text":" HTTPD_CM_VAR_HTTPS_CHANNELS_MAX","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"3a9b4040-8e9b-4e8f-a1c6-cef4e82f37df"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[131.0]},"content":[{"type":"paragraph","content":[{"text":"CM-Module-ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[547.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL_ID_HTTPD","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[131.0]},"content":[{"type":"paragraph","content":[{"text":"CM-variable-ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[547.0]},"content":[{"type":"paragraph","content":[{"text":"1","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[131.0]},"content":[{"type":"paragraph","content":[{"text":"CM-variable name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[547.0]},"content":[{"type":"paragraph","content":[{"text":"HTTPD_CM_VAR_HTTPS_CHANNELS_MAX","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[131.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[547.0]},"content":[{"type":"paragraph","content":[{"text":"maximal number of connections available for the HTTPS transfer protocol","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[131.0]},"content":[{"type":"paragraph","content":[{"text":"CM data type","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[547.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL_CM_UINT16","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[131.0]},"content":[{"type":"paragraph","content":[{"text":"Size","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[547.0]},"content":[{"type":"paragraph","content":[{"text":"2 bytes","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[131.0]},"content":[{"type":"paragraph","content":[{"text":"Default value","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[547.0]},"content":[{"type":"paragraph","content":[{"text":"from NVS or 0","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Table:","type":"text","marks":[{"type":"strong"}]},{"text":" HTTPD_CM_VAR_USERLEVEL0","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"1efc2ba7-c7ae-4c53-8bb2-559469f0d509"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[129.0]},"content":[{"type":"paragraph","content":[{"text":"CM-Module-ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[549.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL_ID_HTTPD","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[129.0]},"content":[{"type":"paragraph","content":[{"text":"CM-variable-ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[549.0]},"content":[{"type":"paragraph","content":[{"text":"2","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[129.0]},"content":[{"type":"paragraph","content":[{"text":"CM-variable name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[549.0]},"content":[{"type":"paragraph","content":[{"text":"HTTPD_CM_VAR_USERLEVEL0","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[129.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[549.0]},"content":[{"type":"paragraph","content":[{"text":"authentication data for level 0","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[129.0]},"content":[{"type":"paragraph","content":[{"text":"CM data type","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[549.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL_CM_STRING","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[129.0]},"content":[{"type":"paragraph","content":[{"text":"Size","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[549.0]},"content":[{"type":"paragraph","content":[{"text":"32 bytes","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[129.0]},"content":[{"type":"paragraph","content":[{"text":"Default value","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[549.0]},"content":[{"type":"paragraph","content":[{"text":"from NVS or an empty string","type":"text"}]}]}]}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Table:","type":"text","marks":[{"type":"strong"}]},{"text":" HTTPD_CM_VAR_USERLEVEL1","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"68f73b22-3bf0-4c77-8394-def97b36875a"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[131.0]},"content":[{"type":"paragraph","content":[{"text":"CM-Module-ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[547.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL_ID_HTTPD","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[131.0]},"content":[{"type":"paragraph","content":[{"text":"CM-variable-ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[547.0]},"content":[{"type":"paragraph","content":[{"text":"3","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[131.0]},"content":[{"type":"paragraph","content":[{"text":"CM-variable name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[547.0]},"content":[{"type":"paragraph","content":[{"text":"HTTPD_CM_VAR_USERLEVEL1","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[131.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[547.0]},"content":[{"type":"paragraph","content":[{"text":"authentication data for level 1","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[131.0]},"content":[{"type":"paragraph","content":[{"text":"CM data type","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[547.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL_CM_STRING","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[131.0]},"content":[{"type":"paragraph","content":[{"text":"Size","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[547.0]},"content":[{"type":"paragraph","content":[{"text":"32 bytes","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[131.0]},"content":[{"type":"paragraph","content":[{"text":"Default value","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[547.0]},"content":[{"type":"paragraph","content":[{"text":"from NVS or an empty string","type":"text"}]}]}]}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Table:","type":"text","marks":[{"type":"strong"}]},{"text":" HTTPD_CM_VAR_USERLEVEL2","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"4d281b54-307f-4880-8267-944452d2288f"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"CM-Module-ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL_ID_HTTPD","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"CM-variable-ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"4","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"CM-variable name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"HTTPD_CM_VAR_USERLEVEL2","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"authentication data for level 2","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"CM data type","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL_CM_STRING","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"Size","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"32 bytes","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"Default value","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"from NVS or an empty string","type":"text"}]}]}]}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Table:","type":"text","marks":[{"type":"strong"}]},{"text":" HTTPD_CM_VAR_USERLEVEL3","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"f214275a-1759-421b-8a16-7cb1c940d469"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"CM-Module-ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL_ID_HTTPD","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"CM-variable-ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"5","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"CM-variable name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"HTTPD_CM_VAR_USERLEVEL3","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"authentication data for level 3","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"CM data type","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL_CM_STRING","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"Size","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"32 bytes","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"Default value","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"from NVS or an empty string","type":"text"}]}]}]}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"The following CM-variables allow to configure the TLS layer used by HTTPS:","type":"text"}]},{"type":"paragraph","content":[{"text":"Table:","type":"text","marks":[{"type":"strong"}]},{"text":" HTTPS_CM_VAR_TLS_SERVER_CERTIFICATE","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"0d89adde-7cec-4f0f-8422-a750270f53b5"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"CM-Module-ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL_ID_HTTPS","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"CM-variable-ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"0","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"CM-variable name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"HTTPS_CM_VAR_TLS_SERVER_CERTIFICATE","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"certificate of the web-server","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"CM data type","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL_CM_GENERIC","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"Size","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"1024 bytes","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"Default value","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"from NVS or certificate from ","type":"text"},{"text":"port","type":"text","marks":[{"type":"em"}]}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Table:","type":"text","marks":[{"type":"strong"}]},{"text":" HTTPS_CM_VAR_TLS_PRIVATE_KEY","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"6fb8d486-362f-49d4-bec0-5c0b60c498ae"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"CM-Module-ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL_ID_HTTPS","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"CM-variable-ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"1","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"CM-variable name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"HTTPS_CM_VAR_TLS_PRIVATE_KEY","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"private key of the web-server","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"CM data type","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL_CM_GENERIC","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"Size","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"1024 bytes","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"Default value","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"from NVS or an empty entry","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Table:","type":"text","marks":[{"type":"strong"}]},{"text":" HTTPS_CM_VAR_TLS_SRV_CERT_CA_CN","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"8a674c77-d101-4a37-b24e-2713ac559acf"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"CM-Module-ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL_ID_HTTPS","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"CM-variable-ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"2","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"CM-variable name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"HTTPS_CM_VAR_TLS_SRV_CERT_CA_CN","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"common name of the server of the certification authority","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"CM data type","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL_CM_STRING","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"Size","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"128 bytes","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"Default value","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"from NVS or an empty string","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Table:","type":"text","marks":[{"type":"strong"}]},{"text":" HTTPS_CM_VAR_TLS_SRV_CERT_CA_O","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"0c68c5ca-6b19-4af1-8c7b-7ead9e4b6f83"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"CM-Module-ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL_ID_HTTPS","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"CM-variable-ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"3","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"CM-variable name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"HTTPS_CM_VAR_TLS_SRV_CERT_CA_O","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"name of the certification authority organization, e.g. the company name","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"CM data type","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL_CM_STRING","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"Size","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"128 bytes","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"Default value","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"from NVS or an empty string","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Table:","type":"text","marks":[{"type":"strong"}]},{"text":" HTTPS_CM_VAR_TLS_SRV_CERT_CA_C","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"a9b9f88e-1c0e-43d2-bcf6-43ee625df6cc"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"CM-Module-ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL_ID_HTTPS","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"CM-variable-ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"4","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"CM-variable name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"HTTPS_CM_VAR_TLS_SRV_CERT_CA_C","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"country, in which the certification authority organization is located","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"CM data type","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL_CM_STRING","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"Size","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"8 bytes","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"Default value","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[546.0]},"content":[{"type":"paragraph","content":[{"text":"from NVS or an empty string","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Table:","type":"text","marks":[{"type":"strong"}]},{"text":" HTTPS_CM_VAR_TLS_SRV_CERT_CN","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"1cba0505-3376-4ff4-8d6e-b1951f24710a"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[135.0]},"content":[{"type":"paragraph","content":[{"text":"CM-Module-ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[543.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL_ID_HTTPS","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[135.0]},"content":[{"type":"paragraph","content":[{"text":"CM-variable-ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[543.0]},"content":[{"type":"paragraph","content":[{"text":"5","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[135.0]},"content":[{"type":"paragraph","content":[{"text":"CM-variable name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[543.0]},"content":[{"type":"paragraph","content":[{"text":"HTTPS_CM_VAR_TLS_SRV_CERT_CN","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[135.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[543.0]},"content":[{"type":"paragraph","content":[{"text":"common name of the web-server","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[135.0]},"content":[{"type":"paragraph","content":[{"text":"CM data type","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[543.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL_CM_STRING","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[135.0]},"content":[{"type":"paragraph","content":[{"text":"Size","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[543.0]},"content":[{"type":"paragraph","content":[{"text":"128 bytes","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[135.0]},"content":[{"type":"paragraph","content":[{"text":"Default value","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[543.0]},"content":[{"type":"paragraph","content":[{"text":"from NVS or an empty string","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Table:","type":"text","marks":[{"type":"strong"}]},{"text":" HTTPS_CM_VAR_TLS_SRV_CERT_O","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"9c78d419-4dda-4345-97ef-ead1f3b755c7"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[135.0]},"content":[{"type":"paragraph","content":[{"text":"CM-Module-ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[543.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL_ID_HTTPS","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[135.0]},"content":[{"type":"paragraph","content":[{"text":"CM-variable-ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[543.0]},"content":[{"type":"paragraph","content":[{"text":"6","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[135.0]},"content":[{"type":"paragraph","content":[{"text":"CM-variable name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[543.0]},"content":[{"type":"paragraph","content":[{"text":"HTTPS_CM_VAR_TLS_SRV_CERT_O","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[135.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[543.0]},"content":[{"type":"paragraph","content":[{"text":"name of the organization provided the web-server","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[135.0]},"content":[{"type":"paragraph","content":[{"text":"CM data type","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[543.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL_CM_STRING","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[135.0]},"content":[{"type":"paragraph","content":[{"text":"Size","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[543.0]},"content":[{"type":"paragraph","content":[{"text":"128 bytes","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[135.0]},"content":[{"type":"paragraph","content":[{"text":"Default value","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[543.0]},"content":[{"type":"paragraph","content":[{"text":"from NVS or an empty string","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Table:","type":"text","marks":[{"type":"strong"}]},{"text":" HTTPS_CM_VAR_TLS_SRV_CERT_C","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"0c9b2bc9-1054-49ec-8bd8-d8b081224247"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[135.0]},"content":[{"type":"paragraph","content":[{"text":"CM-Module-ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[543.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL_ID_HTTPS","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[135.0]},"content":[{"type":"paragraph","content":[{"text":"CM-variable-ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[543.0]},"content":[{"type":"paragraph","content":[{"text":"7","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[135.0]},"content":[{"type":"paragraph","content":[{"text":"CM-variable name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[543.0]},"content":[{"type":"paragraph","content":[{"text":"HTTPS_CM_VAR_TLS_SRV_CERT_C","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[135.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[543.0]},"content":[{"type":"paragraph","content":[{"text":"country, in which the organization provided the web-server is located","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[135.0]},"content":[{"type":"paragraph","content":[{"text":"CM data type","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[543.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL_CM_STRING","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[135.0]},"content":[{"type":"paragraph","content":[{"text":"Size","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[543.0]},"content":[{"type":"paragraph","content":[{"text":"8 bytes","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[135.0]},"content":[{"type":"paragraph","content":[{"text":"Default value","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[543.0]},"content":[{"type":"paragraph","content":[{"text":"from NVS or an empty string","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Table:","type":"text","marks":[{"type":"strong"}]},{"text":" HTTPS_CM_VAR_TLS_SRV_CERT_NOT_BEFORE","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"3a16fcd1-42f0-4358-8c1c-210ebd5baf97"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[139.0]},"content":[{"type":"paragraph","content":[{"text":"CM-Module-ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[539.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL_ID_HTTPS","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[139.0]},"content":[{"type":"paragraph","content":[{"text":"CM-variable-ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[539.0]},"content":[{"type":"paragraph","content":[{"text":"8","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[139.0]},"content":[{"type":"paragraph","content":[{"text":"CM-variable name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[539.0]},"content":[{"type":"paragraph","content":[{"text":"HTTPS_CM_VAR_TLS_SRV_CERT_NOT_BEFORE","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[139.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[539.0]},"content":[{"type":"paragraph","content":[{"text":"from what date and time the certificate is valid","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[139.0]},"content":[{"type":"paragraph","content":[{"text":"CM data type","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[539.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL_CM_STRING","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[139.0]},"content":[{"type":"paragraph","content":[{"text":"Size","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[539.0]},"content":[{"type":"paragraph","content":[{"text":"20 bytes","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[139.0]},"content":[{"type":"paragraph","content":[{"text":"Default value","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[539.0]},"content":[{"type":"paragraph","content":[{"text":"from NVS or an empty string","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Table:","type":"text","marks":[{"type":"strong"}]},{"text":" HTTPS_CM_VAR_TLS_SRV_CERT_NOT_AFTER","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"4d7ec2aa-4cb2-4954-90d8-2e2815e4e805"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[139.0]},"content":[{"type":"paragraph","content":[{"text":"CM-Module-ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[539.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL_ID_HTTPS","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[139.0]},"content":[{"type":"paragraph","content":[{"text":"CM-variable-ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[539.0]},"content":[{"type":"paragraph","content":[{"text":"9","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[139.0]},"content":[{"type":"paragraph","content":[{"text":"CM-variable name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[539.0]},"content":[{"type":"paragraph","content":[{"text":"HTTPS_CM_VAR_TLS_SRV_CERT_NOT_AFTER","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[139.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[539.0]},"content":[{"type":"paragraph","content":[{"text":"from what date and time the certificate is invalid","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[139.0]},"content":[{"type":"paragraph","content":[{"text":"CM data type","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[539.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL_CM_STRING","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[139.0]},"content":[{"type":"paragraph","content":[{"text":"Size","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[539.0]},"content":[{"type":"paragraph","content":[{"text":"20 bytes","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[139.0]},"content":[{"type":"paragraph","content":[{"text":"Default value","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[539.0]},"content":[{"type":"paragraph","content":[{"text":"from NVS or an empty string","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Web-templates","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"The GOAL web-server allows to implement templates for web-pages with placeholders for current information. The placeholders are substituted by the current values by the web-server during the upload process. The web-server provides placeholders for","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CM-variables,","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"application-specific variables and","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"lists.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"CM-variables","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"The placeholder for CM-variables contains the CM-module-ID and the CM-variable-ID. The web-server executes the substitution of the placeholder by the CM-variable automatically.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"syntax:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[CM:, ] ","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"example:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[CM:0, 2]","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Application-specific variables","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"The placeholder for application-specific variables contains the name of the variable in the application. The web-server requires the current value of the variable from the application by calling a callback function, see ","type":"text"},{"text":"Chapter: Callback functions","type":"text","marks":[{"type":"link","attrs":{"href":"https://portgmbh.atlassian.net/wiki/spaces/GOALR/pages/191562330/GOAL+extension+modules+protos#Callback-functions"}}]},{"text":" ","type":"text"},{"text":"cbHttpTemplateFunc()","type":"text","marks":[{"type":"code"}]},{"text":", and substitutes the placeholder in the web-page. ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"syntax:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[VAR:] ","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"example:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[VAR:applVar]","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Lists","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"The web-server provides an effective method to generate lists in HTML text. The HTML text for a single list entry can be enclosed in the placeholders ","type":"text"},{"text":"FOREACH","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"/FOREACH","type":"text","marks":[{"type":"code"}]},{"text":" in the web-template. FOREACH marks a one-dimensional list and the HTML text between the placeholders ","type":"text"},{"text":"FOREACH","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"/FOREACH","type":"text","marks":[{"type":"code"}]},{"text":" is execute for each list element. The place for the list entry is marked in the HTML text by the placeholder VAR with the desired variable name. After the substitution of the placeholder VAR the web-server changes to the next list entry automatically, i.e. it is not possible to substitute the same list entry twice. Therewith it is only necessary to describe the first list entry in the web-template. ","type":"text"},{"type":"hardBreak"},{"text":"The web-server only gets the ID and the name of the list and the number of list elements during the registration. The content of the list elements is managed by the application. The web-server calls a callback function to get the content of the next list element, see ","type":"text"},{"text":"Chapter: Callback functions","type":"text","marks":[{"type":"link","attrs":{"href":"https://portgmbh.atlassian.net/wiki/spaces/GOALR/pages/191562330/GOAL+extension+modules+protos#Callback-functions"}}]},{"text":" ","type":"text"},{"text":"cpHttpTemplateFunc()","type":"text","marks":[{"type":"code"}]},{"text":". ","type":"text"},{"type":"hardBreak"},{"text":"Nested lists are allowed. The maximal supported nesting depth is 4. ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"syntax:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[FOREACH:] … [/FOREACH] ","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"example for HTML listing:","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"html"},"content":[{"text":"

main: [VAR:mainName]
sub-lists:\n
- sub: [VAR:subName]
\n

","type":"text"}]}]}]},{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"type":"hardBreak"},{"text":"Example ","type":"text"},{"text":"…\\goal\\appl\\goal_http\\06_template_list*","type":"text","marks":[{"type":"em"}]},{"text":" generates a HTML listing. The indication in the web-browser is shown:","type":"text"},{"type":"hardBreak"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"395","id":"4404a30e-f610-4e2a-b97f-883b82adb790","collection":"contentId-191562330","height":"277"}}},{"text":" ","type":"text"},{"type":"hardBreak"},{"text":"Figure: web-page of example 06_template_list ","type":"text"},{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"The placeholder [FOREACH] … [\\FOREACH] can also be integrated in other HTML formatting like tables. ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Characters","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"square brackets","type":"text","marks":[{"type":"strong"}]},{"text":": If the HTML text shall show square brackets, the square brackets must be written double, because placeholders in web-templates are bordered by square brackets.","type":"text"},{"type":"hardBreak"},{"text":"example:","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"An array instruction shall be shown on a web-page.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"HTML text: applArray[[5]]","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Web-browser view: applArray[5] ","type":"text"},{"type":"hardBreak"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"double quotes","type":"text","marks":[{"type":"strong"}]},{"text":": Double quotes in the HTML-text must be protected by a backslash, because strings in the C code are enclosed by double quotes.","type":"text"},{"type":"hardBreak"},{"text":"example","type":"text","marks":[{"type":"em"}]},{"text":": ","type":"text"}]},{"type":"paragraph"},{"type":"codeBlock","attrs":{"language":"html"},"content":[{"text":"uint8_t webPage[] = \" … \"; ","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"The rules for HTML text are valid for ","type":"text"},{"text":"all other characters","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Callback functions","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Table: ","type":"text","marks":[{"type":"strong"}]},{"text":"cbHttpReqFunc()","type":"text"}]},{"type":"table","attrs":{"layout":"full-width","localId":"0cf47a74-4c8f-4792-9c58-de730f5c9aef"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[121.0]},"content":[{"type":"paragraph","content":[{"text":"Prototype","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[77.0,480.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL_STATUS_T cbHttpReqFunc(GOAL_HTTP_APPLCB_DATA_T *applData)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[121.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[77.0,480.0]},"content":[{"type":"paragraph","content":[{"text":"The received and valid web-request is passed to the application. The application has to process the web-request and to produce a web-response.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[121.0]},"content":[{"type":"paragraph","content":[{"text":"Parameters","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[77.0]},"content":[{"type":"paragraph","content":[{"text":"applData","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[480.0]},"content":[{"type":"paragraph","content":[{"text":"contains data for the application and data returned by the application","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[121.0]},"content":[{"type":"paragraph","content":[{"text":"Return values","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[77.0,480.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL return status, see ","type":"text"},{"text":"Chapter: GOAL status","type":"text","marks":[{"type":"link","attrs":{"href":"https://portgmbh.atlassian.net/wiki/spaces/GOALR/pages/191562344/Implementation+specifics#GOAL-status"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[121.0]},"content":[{"type":"paragraph","content":[{"text":"Category","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[77.0,480.0]},"content":[{"type":"paragraph","content":[{"text":"optional","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[121.0]},"content":[{"type":"paragraph","content":[{"text":"Registration","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[77.0,480.0]},"content":[{"type":"paragraph","content":[{"text":"during runtime about function goal_httpdResReg()","type":"text"}]}]}]}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Table: ","type":"text","marks":[{"type":"strong"}]},{"text":"cbHttpReqFunc()","type":"text"}]},{"type":"table","attrs":{"layout":"full-width","localId":"dd7c38e0-b378-47f7-adee-3d98ffdff126"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[80.0]},"content":[{"type":"paragraph","content":[{"text":"Prototype","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[124.0,474.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL_STATUS_T cbHttpTemplateFunc(GOAL_HTTP_APPLCB_TEMPL_T *pWebTemplate)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[80.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[124.0,474.0]},"content":[{"type":"paragraph","content":[{"text":"About this callback function the application provides the current information for the specified placeholder. This callback function is called for each placeholder in the web-template. There are multiple placeholders for the same information, this callback function is called for each placeholder.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[80.0]},"content":[{"type":"paragraph","content":[{"text":"Parameters","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[124.0]},"content":[{"type":"paragraph","content":[{"text":"pWebTemplate","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[474.0]},"content":[{"type":"paragraph","content":[{"text":"Contains the information to specify a variable or list and the current return value of the specified variable.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[80.0]},"content":[{"type":"paragraph","content":[{"text":"Return values","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[124.0,474.0]},"content":[{"type":"paragraph","content":[{"text":"GOAL return status, see ","type":"text"},{"text":"Chapter: GOAL status","type":"text","marks":[{"type":"link","attrs":{"href":"https://portgmbh.atlassian.net/wiki/spaces/GOALR/pages/191562344/Implementation+specifics#GOAL-status"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[80.0]},"content":[{"type":"paragraph","content":[{"text":"Category","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[124.0,474.0]},"content":[{"type":"paragraph","content":[{"text":"optional","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[80.0]},"content":[{"type":"paragraph","content":[{"text":"Registration","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[124.0,474.0]},"content":[{"type":"paragraph","content":[{"text":"during runtime about function","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Implementation guideline","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Upload a web-page","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"The web-page \"device.html\" shall be uploaded from the device to the web-browser. The content of the web-page is stored in variable webPage[] as string. No text substitutions on the web-page are necessary.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Initialize the web-server in state GOAL_FSA_INIT_APPL or GOAL_FSA_INIT_GOAL:","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"c"},"content":[{"text":"goal_httpInit();","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open 1 instance of the web-server using the TCP port 8080 in state GOAL_FSA_INIT_SETUP:","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"c"},"content":[{"text":"GOAL_HTTP_T *pWebInstanceHdl; /* handle for the web-server instance */\ngoal_httpNew(&pWebInstanceHdl, 8080, 1);","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Register the callback-functions and allowed methods for the opened web-server in state GOAL_FSA_INIT_SETUP: No callback function for text substitution is registered.","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"c"},"content":[{"text":"GOAL_HTTP_HDL_T webResourceHdl;\ngoal_httpResReg(pWebInstanceHdl, (uint8_t *) „/device.html\", \nGOAL_HTTP_METHOD_ALLW_GET, applWebReqCb, NULL, &webResourceHdl);","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Provide the web-page as string variable:","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"c"},"content":[{"text":"const uint8_t webPage[] = \"\\\n Device \\r\\n{color}

Device

\\r\\n\\\n

The device implementation bases on the GOAL middleware of port.\n

\\r\\n\\\n\"","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Implement a callback function to process web-requests:","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"c"},"content":[{"text":"GOAL_STATUS_T applWebReqCb (GOAL_HTTP_APPLCB_DATA_T *pWebData) {\n GOAL_STATUS_T res; /* GOAL return value */\n res = GOAL_ERROR; /* no valid web-handle or\n * request method not supported */\n \n if (webResourceHdl == pWebData->hdlRes) {\n if (GOAL_HTTP_FW_GET == pWebData->reqType) {\n GOAL_HTTP_GET_RETURN_HTML(pWebData, webPage,\n GOAL_STRLEN((const char*) webPage));\n res = GOAL_OK;\n }\n }\n return res;\n} ","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The callback function applWebReqCb() is called by the web-server after the receipt of the web-request.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Read a CM-variable","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"The web-page \"device.html\" shall be uploaded from the device to the web-browser. The web-page bases on the template webPage[]. The template includes a placeholder for the CM-Variable DD_CM_VAR_MODULENAME with the CM-module-ID 34 and the CM-variable-ID 0. The web-server substitutes the placeholder by the current value of the CM-variable automatically. No text substitutions on the web-page are necessary.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Initialize the web-server in state GOAL_FSA_INIT_APPL or GOAL_FSA_INIT_GOAL:","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"c"},"content":[{"text":"goal_httpInit();","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open 1 instance of the web-server using the TCP port 8080 in state GOAL_FSA_INIT_SETUP:","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"c"},"content":[{"text":"GOAL_HTTP_T *pWebInstanceHdl; /* handle for the web-server instance */\ngoal_httpNew(&pWebInstanceHdl, 8080, 1);","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Register the callback-functions and allowed methods for the opened web-server in state GOAL_FSA_INIT_SETUP: No callback function for text substitution is registered.","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"c"},"content":[{"text":"GOAL_HTTP_HDL_T webResourceHdl;\n\ngoal_httpResReg(pWebInstanceHdl, (uint8_t *) „/device.html“, \nGOAL_HTTP_METHOD_ALLW_GET, applWebReqCb, NULL, &webResourceHdl);","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Provide a template for the web-page as string variable with placeholder for the CM-variable:","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"c"},"content":[{"text":"const uint8_t webPage[] = “\\\n Device \\r\\n\\\n

Device

\\r\\n\\\n

The device with the name [CM:34, 0] bases on the GOAL middleware of port.

Device

\\r\\n\\\n

The device with the name [VAR:applVar] bases on the GOAL middleware of port.

\\r\\n\\\n” ","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Implement a callback function to process web-requests:","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"c"},"content":[{"text":"GOAL_STATUS_T applWebReqCb (GOAL_HTTP_APPLCB_DATA_T *pWebData) {\n GOAL_STATUS_T res; /* GOAL return value */\n res = GOAL_ERROR; /* no valid web-handle or\n * request method not supported */\n \n if (webResourceHdl == pWebData->hdlRes) {\n if (GOAL_HTTP_FW_GET == pWebData->reqType) {\n GOAL_HTTP_GET_RETURN_HTML(pWebData, webPage,\n GOAL_STRLEN((const char*) webPage));\n res = GOAL_OK;\n }\n }\n return res;\n}","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Implement a callback function to get the current value of the application-specific variable from the application:","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"c"},"content":[{"text":"uint8_t deviceName[] = “Sample Gadget”;\nGOAL_STATUS_T applWebGetValCb (GOAL_HTTP_APPLCB_TEMPL_T *pWebData) {\n if (0 == GOAL_MEMCMP(pWebData->in.name, “applVar”,\n GOAL_STRLEN(“applVar”))) {\n \n /* provide the complete device name */\n if (GOAL_STRLEN(deviceName) <= pWebData->in.retLenMax) {\n GOAL_MEMCPY(pWebData->out.strReturn, deviceName,\n GOAL_STRLEN(deviceName));\n }\n /* the device name is too long, cut the device name down\n * to the maximal allowed length */\n else {\n GOAL_MEMCPY(pWebData->out.strReturn, deviceName,\n pWebData->in.retLenMax);\n }\n }\n return GOAL_OK;\n}","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The callback function applWebReqCb() is called by the web-server after the receipt of the web-request. The desired template for the web-page is made available for the web-server.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The callback function applWebGetValCb() is called for substitution.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Read a list","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"The web-page \"device.html\" shall be uploaded from the device to the web-browser. The web-page bases on the template webPage[]. The template includes a placeholder for the list of device components. The web-server calls the callback function applWebGetValCb() to provide the current value of the list entries. The web-server substitutes the placeholder by the current value of the application-specific variable.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Initialize the web-server in state GOAL_FSA_INIT_APPL or GOAL_FSA_INIT_GOAL:","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"c"},"content":[{"text":"goal_httpInit();","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open 1 instance of the web-server using the TCP port 8080 in state GOAL_FSA_INIT_SETUP:","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"c"},"content":[{"text":"GOAL_HTTP_T *pWebInstanceHdl; /* handle for the web-server instance */\ngoal_httpNew(&pWebInstanceHdl, 8080, 1);","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Register the callback-functions and allowed methods for the opened web-server in state GOAL_FSA_INIT_SETUP:","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"c"},"content":[{"text":"GOAL_HTTP_HDL_T webResourceHdl;\ngoal_httpResReg(pWebInstanceHdl, (uint8_t *) „/device.html“, \nGOAL_HTTP_METHOD_ALLW_GET, applWebReqCb, applWebGetValCb, &webResourceHdl);","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create the list information and register the list information for the web-server. The list information contains a list-ID, a list name and the number of list entries.","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"c"},"content":[{"text":"GOAL_HTTP_TEMPLATE_LIST_INIT_T webList;\nGOAL_MEMSET(&webList, 0, sizeof(webList));\nwebList.listId = 1;\nwebList.cntMemb = 4;\nGOAL_MEMCPY(webList.listName, “deviceComponents”,\n sizeof(“devcieComponents”));\ngoal_httpTmpMgrNewList(pWebInstanceHdl, &webList);","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Provide a template for the web-page as string variable with placeholders for the list and list entries:","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"c"},"content":[{"text":"const uint8_t webPage[] = “\\\n Device \\r\\n\\ \n

Device

\\r\\n\\\n

The device contains the following components: \\r\\n\\\n

[VAR:devComponent]

\\r\\n\\\n

\\r\\n\\\n” ","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Implement a callback function to process web-requests:","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"c"},"content":[{"text":"GOAL_STATUS_T applWebReqCb (GOAL_HTTP_APPLCB_DATA_T *pWebData) {\n GOAL_STATUS_T res; /* GOAL return value */\n res = GOAL_ERROR; /* no valid web-handle or\n * request method not supported */\n\n if (webResourceHdl == pWebData->hdlRes) {\n if (GOAL_HTTP_FW_GET == pWebData->reqType) {\n GOAL_HTTP_GET_RETURN_HTML(pWebData, webPage,\n GOAL_STRLEN((const char*) webPage));\n res = GOAL_OK;\n }\n }\n return res;\n} ","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Implement a callback function to get the current value of the list entries from the application:","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"c"},"content":[{"text":"GOAL_STATUS_T applWebGetValCb (GOAL_HTTP_APPLCB_TEMPL_T *pWebData) {\n GOAL_STATUS_T res; /* GOAL return value */\n res = GOAL_ERR_NOT_FOUND;\n\n if (NULL != pWebData->in.pPath) {\n if (0 == GOAL_MEMCMP(pWebData->in.name, “devComponent”,\n GOAL_STRLEN(“devComponent”))) {\n \n switch ((pWebData->inPath)->path[0].index) {\n case 0:\n GOAL_MEMCPY(pWebData->out.strReturn, “I/O module”,\n GOAL_STRLEN(“I/O module”));\n res = GOAL_OK;\n break;\n case 1:\n GOAL_MEMCPY(pWebData->out.strReturn, “drive”,\n GOAL_STRLEN(“drive”));\n res = GOAL_OK;\n break;\n case 2:\n GOAL_MEMCPY(pWebData->out.strReturn, “encoder”,\n GOAL_STRLEN(“encoder”));\n res = GOAL_OK;\n break;\n case 3:\n GOAL_MEMCPY(pWebData->out.strReturn, “power supply”,\n GOAL_STRLEN(“power supply”));\n res = GOAL_OK;\n break;\n default:\n break;\n }\n }\n }\n return res;\n}","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The callback function applWebReqCb() is called by the web-server after the receipt of the web-request. The desired template for the web-page is made available for the web-server.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The callback function applWebGetValCb() is called for each substitution.","type":"text"}]}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":3},"content":[{"text":"Set a user level","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"The upload of the web-page \"admin.html\" shall only allowed for users with the USERLEVEL0. The login data for the USERLEVEL0 are:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"user name: admin","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"password: a1b2c3:UL","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The HTTPS transfer protocol is used.","type":"text"},{"type":"hardBreak"},{"text":"The web-page \"admin.html\" does not contain any placeholder. No text substitutions on the web-page are necessary.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Initialize the web-server in state GOAL_FSA_INIT_APPL or GOAL_FSA_INIT_GOAL:","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"c"},"content":[{"text":"goal_httpInit(); ","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open 1 instance of the web-server using the TCP port 443 in state GOAL_FSA_INIT_SETUP:","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"c"},"content":[{"text":"GOAL_HTTP_T *pWebInstanceHdl; /* handle for the web-server instance */\ngoal_httpsNew(&pWebInstanceHdl, 443, 1); ","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Register the callback-functions and allowed methods for the opened web-server in state GOAL_FSA_INIT_SETUP:","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"c"},"content":[{"text":"GOAL_HTTP_HDL_T webResourceHdl;\ngoal_httpResReg(pWebInstanceHdl, (uint8_t *) „/admin.html“, \nGOAL_HTTP_METHOD_ALLW_GET | GOAL_HTTP_AUTH_USERLEVEL0, applWebReqCb, NULL, &webResourceHdl);","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Install the authentication for USERLEVEL0 in state GOAL_FSA_INIT_SETUP: The authentication data are written to the CM-variable USERLEVEL0.","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"c"},"content":[{"text":"goal_httpAuthBasSetUserInfo(pWebInstanceHdl, GOAL_HTTP_AUTH_USERLEVEL0,\n “admin”, “a1b2c3:UL”); ","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Provide a template for the web-page as string variable:","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"c"},"content":[{"text":"const uint8_t webPage[] = “\\\n Administration \\r\\n\\\n

Administration

\\r\\n\\\n

Internal information: …

Download dialog

\\r\\n\\\n \\r\\n\\\n”","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Implement an application-specific function applDownload() to receive and install the new firmware.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Implement an application-specific function applDownloadFinished() to report the result of the web-request to the application.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Implement a callback function to process web-requests:","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"c"},"content":[{"text":"GOAL_STATUS_T applWebReqCb (GOAL_HTTP_APPLCB_DATA_T *pWebData) {\n GOAL_STATUS_T res; /* GOAL return value */\n res = GOAL_ERROR; /* no valid web-handle or\n * request method not supported */\n\n if (webResourceHdl == pWebData->hdlRes) {\n switch (pWebData->reqType) {\n case GOAL_HTTP_FW_GET:\n GOAL_HTTP_GET_RETURN_HTML(pWebData, webPage,\n GOAL_STRLEN((const char*) webpage));\n break;\n case GOAL_HTTP_FW_POST_START:\n res = applDownload(pWebData);\n GOAL_HTTP_RETURN_OK_204(pWebData);\n break;\n case GOAL_HTTP_FW_POST_DATA:\n res = applDownload(pWebData);\n GOAL_HTTP_RETURN_OK_204(pWebData);\n break;\n case GOAL_HTTP_FW_POST_END:\n res = applDownload(pWebData);\n GOAL_HTTP_RETURN_OK_204(pWebData);\n break;\n case GOAL_HTTP_FW_REQ_DONE_OK:\n case GOAL_HTTP_FW_REQ_DONE_ERR:\n res = applDownloadFinished(pWebData);\n break;\n default:\n break;\n }\n }\n return res;\n} ","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Application Programming Interface","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Initialization","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"goal_httpNewImpl()","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"c"},"content":[{"text":"GOAL_STATUS_T goal_httpNewImpl ( GOAL_HTTP_T ∗∗ ppInst, uint16_t port, uint16_t cntChn )","type":"text"}]},{"type":"paragraph","content":[{"text":"Registers the http module for GOAL.","type":"text"}]},{"type":"paragraph","content":[{"text":"Return values:","type":"text"}]},{"type":"paragraph","content":[{"text":"GOAL_STATUS_T","type":"text","marks":[{"type":"code"}]},{"text":" result","type":"text"}]},{"type":"paragraph","content":[{"text":"Parameters:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ppInst","type":"text","marks":[{"type":"code"}]},{"text":" pointer to instance pointer","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"port","type":"text","marks":[{"type":"code"}]},{"text":" port to link instance to","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"cntChn","type":"text","marks":[{"type":"code"}]},{"text":" channel count","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"goal_httpResReg()","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"GOAL_STATUS_T goal_httpResReg ( GOAL_HTTP_T ∗ pInst, \n uint8_t ∗ strUrl, \n uint32_t allowMeth, \n GOAL_HTTP_REQCB_T pfnCbData, \n GOAL_HTTP_TMPCB_T pfnCbTemplate, \n GOAL_HTTP_HDL_T ∗ pHdl )","type":"text"}]},{"type":"paragraph","content":[{"text":"Parameters:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"pInst","type":"text","marks":[{"type":"code"}]},{"text":" instance pointer","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"strUrl","type":"text","marks":[{"type":"code"}]},{"text":" URL string","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"allowMeth","type":"text","marks":[{"type":"code"}]},{"text":" allowed methods for resource","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"pfnCbData","type":"text","marks":[{"type":"code"}]},{"text":" application callback","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"pfnCbTemplate","type":"text","marks":[{"type":"code"}]},{"text":" template handler callback","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"pHdl","type":"text","marks":[{"type":"code"}]},{"text":" resource handle return","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Firewall","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"GOAL provides a basic firewall for ARP, TCP and UDP. After calling ","type":"text"},{"text":"goal_fwInit()","type":"text","marks":[{"type":"code"}]},{"text":" the firewall is active and working. All frames received in ","type":"text"},{"text":"goal_miEthRecv()","type":"text","marks":[{"type":"code"}]},{"text":" matching ether type ARP and IPv4 will be passed to and processed by the firewall.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"ARP-Firewall","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"All received Ethernet frames of ether type ARP will be filtered by ","type":"text"},{"text":"goal_fwArp()","type":"text","marks":[{"type":"code"}]},{"text":". The firewall will process frames that match the following conditions:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"EtherType = 0x0806 (Address Resolution Protocol)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Data length must be equal or higher than 96 bytes","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ARP hardware type is Ethernet - 0x0001","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Opcode is request – 0x01","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Protocol type is IPv4 – 0x0800","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Frames that doesn't match these conditions will be passed to the queue. The ARP-firewall drops all frames that are not addressed to the device or have MAC-Address NULL. The firewall reads the IP, Gateway and Netmask settings at initialization and gets updated automatically at any change of these values.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"IPv4-Firewall","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"All received Ethernet frames of ether type IPv4 will be filtered by goal_fwIpv4(). All frames of type ICMP will be passed directly to the queue. For TCP and UDP the firewall:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Checks frame length and drops malformed frames","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Iterates through all channels to check for matching port number on used channels","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Drops frames with no matching port number","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The firewall reads the maximum number of net-channels and the location of the cannel list at initialization.","type":"text"}]}]},{"type":"layoutColumn","attrs":{"width":33.33},"content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"_parentId":{"value":"191562330"}},"macroMetadata":{"macroId":{"value":"67b3c981-594d-4533-a31d-3bcab9db2fb6"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"d8200b87-7b3f-4c96-8e93-dabfd5bfd66f"}}]}]}],"version":1}

Browser not supported