Remove excessive initializations from the main template file

Port ADC block to the HDK kit, implement demo for ADC

Fixes: #998

Port CAN demo to the HDK kit

Refs: #999

Remove unnecessary blocks

Only those blocks and demos which are usefull for RM48 project were kept.

Set rpp/lib submodule to rm48/master branch

doc: Fix \bf generated by pandoc to \bfseries

The reason is that Koma-script complains about \bf.

Update block masks by running rpp_update_doc.m

Changelog:
Processing rpp_lib/Analog Input
Processing rpp_lib/Analog Output
Processing rpp_lib/CAN Receive
Processing rpp_lib/CAN Setup
Processing rpp_lib/CAN Transmit
Processing rpp_lib/Configure FlexRay node
--- sfunction_frayconfig.MaskType.old 2014-12-03 16:22:55.500671474 +0100
+++ sfunction_frayconfig.MaskType.new 2014-12-03 16:22:55.500671474 +0100
@@ -1 +1 @@
-RPP Configure FlexRay node
+RPP Configure FlexRay node
\ No newline at end of file

Processing rpp_lib/Configure RX buffer
Processing rpp_lib/Configure TX buffer
Processing rpp_lib/Digital Input
Processing rpp_lib/Digital Input Configure
--- sfunction_dinc.MaskType.old 2014-12-03 16:22:56.932643620 +0100
+++ sfunction_dinc.MaskType.new 2014-12-03 16:22:56.932643620 +0100
@@ -1 +1 @@
-RPP Digital Input Configure
+RPP Digital Input Configure
\ No newline at end of file

Processing rpp_lib/Digital Output
Processing rpp_lib/H-Bridge Control
Processing rpp_lib/IRC Input
Processing rpp_lib/Overrun Detection
Processing rpp_lib/Power Output
Processing rpp_lib/SD-RAM Log Data
--- sfunction_sdrw.MaskType.old 2014-12-03 16:22:59.016603086 +0100
+++ sfunction_sdrw.MaskType.new 2014-12-03 16:22:59.016603086 +0100
@@ -1 +1 @@
-RPP SD-RAM Log Data
+RPP SD-RAM Log Data
\ No newline at end of file

Processing rpp_lib/Serial Configure
--- sfunction_scic.MaskType.old 2014-12-03 16:22:59.348596628 +0100
+++ sfunction_scic.MaskType.new 2014-12-03 16:22:59.348596628 +0100
@@ -1 +1 @@
-RPP Serial Configure
+RPP Serial Configure
\ No newline at end of file

Processing rpp_lib/Serial Printf
--- sfunction_scip.MaskType.old 2014-12-03 16:22:59.664590482 +0100
+++ sfunction_scip.MaskType.new 2014-12-03 16:22:59.664590482 +0100
@@ -1 +1 @@
-RPP Serial Printf
+RPP Serial Printf
\ No newline at end of file

Processing rpp_lib/Serial Receive
--- sfunction_scir.MaskType.old 2014-12-03 16:23:00.072582546 +0100
+++ sfunction_scir.MaskType.new 2014-12-03 16:23:00.072582546 +0100
@@ -1 +1 @@
-RPP Serial Receive
+RPP Serial Receive
\ No newline at end of file

Processing rpp_lib/Serial Send
--- sfunction_scis.MaskType.old 2014-12-03 16:23:00.436575466 +0100
+++ sfunction_scis.MaskType.new 2014-12-03 16:23:00.436575466 +0100
@@ -1 +1 @@
-RPP Serial Send
+RPP Serial Send
\ No newline at end of file

[\bWarning: an error occurred while parsing class fxptui.explorer:
Invalid data type.
]\b

Revert "doc: Make `make diff-doc` more readable"

This reverts commit 1c1cf9786538011fdb3d7b6ac18e3757d32ba314.

doc: Clean bib

doc: Fix block help generator

Update block masks by running rpp_update_doc.m

Changelog:
Processing rpp_lib/Analog Input
Processing rpp_lib/Analog Output
Processing rpp_lib/CAN Receive
Processing rpp_lib/CAN Setup
Processing rpp_lib/CAN Transmit
Processing rpp_lib/Configure FlexRay node
--- sfunction_frayconfig.MaskType.old 2014-12-03 15:22:52.202587608 +0100
+++ sfunction_frayconfig.MaskType.new 2014-12-03 15:22:52.202587608 +0100
@@ -1 +1 @@
-RPP Configure FlexRay Node
+RPP Configure FlexRay node

Processing rpp_lib/Configure RX buffer
Processing rpp_lib/Configure TX buffer
Processing rpp_lib/Digital Input
Processing rpp_lib/Digital Input Configure
--- sfunction_dinc.MaskType.old 2014-12-03 15:22:53.582564992 +0100
+++ sfunction_dinc.MaskType.new 2014-12-03 15:22:53.582564992 +0100
@@ -1 +1 @@
-RPP Digital Input Reference Voltage Configuration
+RPP Digital Input Configure

Processing rpp_lib/Digital Output
Processing rpp_lib/H-Bridge Control
Processing rpp_lib/IRC Input
Processing rpp_lib/Overrun Detection
Processing rpp_lib/Power Output
Processing rpp_lib/SD-RAM Log Data
--- sfunction_sdrw.MaskType.old 2014-12-03 15:22:55.766529184 +0100
+++ sfunction_sdrw.MaskType.new 2014-12-03 15:22:55.766529184 +0100
@@ -1 +1 @@
-RPP SD-RAM Write
+RPP SD-RAM Log Data

Processing rpp_lib/Serial Configure
--- sfunction_scic.MaskType.old 2014-12-03 15:22:56.102523674 +0100
+++ sfunction_scic.MaskType.new 2014-12-03 15:22:56.102523674 +0100
@@ -1 +1 @@
-RPP Serial Communication Interface Configuration
+RPP Serial Configure

Processing rpp_lib/Serial Printf
--- sfunction_scip.MaskType.old 2014-12-03 15:22:56.418518490 +0100
+++ sfunction_scip.MaskType.new 2014-12-03 15:22:56.418518490 +0100
@@ -1 +1 @@
-RPP Serial Communication Interface Printf
+RPP Serial Printf

Processing rpp_lib/Serial Receive
--- sfunction_scir.MaskType.old 2014-12-03 15:22:56.754512978 +0100
+++ sfunction_scir.MaskType.new 2014-12-03 15:22:56.758512913 +0100
@@ -1 +1 @@
-RPP Serial Communication Interface Receive
+RPP Serial Receive

Processing rpp_lib/Serial Send
--- sfunction_scis.MaskType.old 2014-12-03 15:22:57.118507007 +0100
+++ sfunction_scis.MaskType.new 2014-12-03 15:22:57.118507007 +0100
@@ -1 +1 @@
-RPP Serial Communication Interface Send
+RPP Serial Send

[\bWarning: an error occurred while parsing class fxptui.explorer:
Invalid data type.
]\b

doc: Extend make commit-doc to commit include diff in commit message

doc: Make `make diff-doc` more readable

Get rid of "\ No newline at end of file" in diff output by always
terminating one-line fields with '\n'.

doc: Update block names to match reality

Extend rpp_update_doc to update block names

doc: Allow having a note in block parameter description

This note will be included in PDF documentation but will not be present
in block masks. This will be needed in rm48 branch.

Add Makefile target for updating and committing block masks

Fix syntax error, caused by the licence header inserted before the interpreter selector

Add licence to the header of scripts and source files, library update

Add release target

doc: remove references to documents in ref directory

Those documents should not be redistributed, so the link has been
changed to the link to a bibliography.

doc: lines reformated for the length of 80 characters

doc: add me to tha author list

doc: add references in a bibtex style, include citation on used pictures

doc: fix typos, add missing links and labels

doc: add commands description

doc: tune OS interchangable layer description, add description of the
distributed OS versions.

doc: labels added to the chapters, sections, subsections and figures

doc add sections in Getting Started chapter

Run rpp_update_doc

doc: Clarify documentation of SCI blocks

doc: Clarify description of the tror block

doc: Change YAML field Status to simple string

doc: Put back block overview table

doc: Fix compilation errors and some typos

Several underscores were not preceded by '\'.
Typos discovered by my spellchecker were corrected.

doc: Fix doc build

Update block Mask by running rpp_update_doc

In case the previous content contained some valuable information, which
I forgot to move into YAML blocks, I append the output of

  make diff-doc

which prints the diff of the old and new content:

Processing rpp_lib/Analog Input
rpp_lib/Analog Input: MaskDescription not up-to-date
--- sfunction_ain.MaskDescription.old 2014-12-01 23:16:51.938656419 +0100
+++ sfunction_ain.MaskDescription.new 2014-12-01 23:16:51.942656359 +0100
@@ -1,5 +1,3 @@
-Gets the analog value of the specified analog input pin on the RPP board.
-
-The value is an unsigned 16 bit integer between 0-4095 (12 bit ADC).
-
-If an error is detected while getting the value, the ErrFlag is set high.
\ No newline at end of file
+<p>Gets the analog value of the specified analog input pin on the RPP board.</p>
+<p>The value is an unsigned 16 bit integer between 0–4095 (12 bit ADC).</p>
+<p>If an error is detected while reading the value, the ErrFlag is set high.</p>

rpp_lib/Analog Input: MaskPromptString not up-to-date
--- sfunction_ain.MaskPromptString.old 2014-12-01 23:16:52.014655279 +0100
+++ sfunction_ain.MaskPromptString.new 2014-12-01 23:16:52.014655279 +0100
@@ -1 +1 @@
-Pin number [1-12]:
\ No newline at end of file
+Pin number [1–12]:
\ No newline at end of file

Processing rpp_lib/Analog Output
rpp_lib/Analog Output: MaskDescription not up-to-date
--- sfunction_aout.MaskDescription.old 2014-12-01 23:16:52.246651798 +0100
+++ sfunction_aout.MaskDescription.new 2014-12-01 23:16:52.246651798 +0100
@@ -1,6 +1,3 @@
-Sets the analog value of the specified analog output pin on the RPP board.
-
-If 'input is voltage' is set the value must be an unsigned 16 bit integer between 0-12000 (millivolts to set the analog output).
-If 'input is voltage' is NOT set the value must be and unsigned 16 bit integer between 0-4095 (DAC is 12 bit).
-
-If an error is detected while setting the value, the ErrFlag is set high.
\ No newline at end of file
+<p>Sets the analog value of the specified analog output pin on the RPP board.</p>
+<p>If 'input is voltage' is set the value must be an unsigned 16 bit integer between 0-12000 (millivolts to set the analog output). If 'input is voltage' is NOT set the value must be and unsigned 16 bit integer between 0-4095 (DAC is 12 bit).</p>
+<p>If an error is detected while setting the value, the ErrFlag is set high.</p>

rpp_lib/Analog Output: MaskPromptString not up-to-date
--- sfunction_aout.MaskPromptString.old 2014-12-01 23:16:52.318650717 +0100
+++ sfunction_aout.MaskPromptString.new 2014-12-01 23:16:52.318650717 +0100
@@ -1 +1 @@
-Pin number [1-4]:|Input is millivolts.
\ No newline at end of file
+Pin number [1-4]:|Input in millivolts
\ No newline at end of file

Processing rpp_lib/CAN Receive
rpp_lib/CAN Receive: MaskType not up-to-date
--- sfunction_canreceive.MaskType.old 2014-12-01 23:16:52.478648317 +0100
+++ sfunction_canreceive.MaskType.new 2014-12-01 23:16:52.478648317 +0100
@@ -1 +1 @@
-RPP CAN bus receive message
\ No newline at end of file
+RPP CAN Receive
\ No newline at end of file

rpp_lib/CAN Receive: MaskDescription not up-to-date
--- sfunction_canreceive.MaskDescription.old 2014-12-01 23:16:52.566646997 +0100
+++ sfunction_canreceive.MaskDescription.new 2014-12-01 23:16:52.566646997 +0100
@@ -1,7 +1,6 @@
 <p>Receive a messages from the CAN bus.</p>
 <p>The output can be a uint8, uint16, uint32 number or CAN_MESSAGE object. CAN Unpack block can be used to unpack the data from CAN_MESSAGE object.</p>
 <p>A Function-call subsystem is triggered every time when a new message has been received.</p>
-<p>When Mixed is selected in the <i>Message type</i>, the block is able to receive both, the mesages with Standard and Extended identifier.<br>
-<b>NOTE:</b> When Mixed is selected, the <i>Message ID</i> and eventualy the <i>Message ID mask</i> have to be shifted by 18 bits to the left.</p>
-<p>If the <i>Message filter</i> is set to Single ID, only the messages with the one identifier specified in <i>Message ID</i> will be accepted by the block. But when ID & mask is selected, all messages with identifier compliant to logical AND of the <i>Message ID</i> and <i>Message ID mask</i> will be accepted.</p>
-<p>Uncheck <i>Automatic mailbox number</i>, if user defined mailbox number is needed.<br>
\ No newline at end of file
+<p>When Mixed is selected in the <em>Message type</em>, the block is able to receive both, the mesages with Standard and Extended identifier.<br /><strong>NOTE:</strong> When Mixed is selected, the <em>Message ID</em> and eventualy the <em>Message ID mask</em> have to be shifted by 18 bits to the left.</p>
+<p>If the <em>Message filter</em> is set to Single ID, only the messages with the one identifier specified in <em>Message ID</em> will be accepted by the block. But when ID &amp; mask is selected, all messages with identifier compliant to logical AND of the <em>Message ID</em> and <em>Message ID mask</em> will be accepted.</p>
+<p>Uncheck <em>Automatic mailbox number</em>, if user defined mailbox number is needed.</p>

rpp_lib/CAN Receive: MaskPromptString not up-to-date
--- sfunction_canreceive.MaskPromptString.old 2014-12-01 23:16:52.642645856 +0100
+++ sfunction_canreceive.MaskPromptString.new 2014-12-01 23:16:52.642645856 +0100
@@ -1 +1 @@
-Module|Frame type|Message ID filter|Message ID|Message ID mask|Data type|Automatic mailbox number|Mailbox number (1-64)
\ No newline at end of file
+Module:|Frame type:|Message ID filter:|Message ID:|Message ID mask:|Data type:|Automatic mailbox number|Mailbox number [1-64]:
\ No newline at end of file

Processing rpp_lib/CAN Setup
rpp_lib/CAN Setup: MaskType not up-to-date
--- sfunction_cansetup.MaskType.old 2014-12-01 23:16:52.798643516 +0100
+++ sfunction_cansetup.MaskType.new 2014-12-01 23:16:52.798643516 +0100
@@ -1 +1 @@
-RPP CAN setup
\ No newline at end of file
+RPP CAN Setup
\ No newline at end of file

rpp_lib/CAN Setup: MaskDescription not up-to-date
--- sfunction_cansetup.MaskDescription.old 2014-12-01 23:16:52.878642315 +0100
+++ sfunction_cansetup.MaskDescription.new 2014-12-01 23:16:52.878642315 +0100
@@ -1 +1 @@
-Configure CAN bus communication baud rates for every CAN modul. Default value is 500kb/sec.
\ No newline at end of file
+<p>This block configures the CAN bus controllers. Exactly one CAN bus configuration block must be in the model if any of the CAN Receive or CAN Transmit block is used.</p>

rpp_lib/CAN Setup: MaskPromptString not up-to-date
--- sfunction_cansetup.MaskPromptString.old 2014-12-01 23:16:52.946641295 +0100
+++ sfunction_cansetup.MaskPromptString.new 2014-12-01 23:16:52.946641295 +0100
@@ -1 +1 @@
-CAN1 Baudrate (1-1000000 bits/sec)|CAN2 Baudrate (1-1000000 bits/sec)|CAN3 Baudrate (1-1000000 bits/sec)
\ No newline at end of file
+CAN1 baud rate in bps 1 – 10000000:|CAN2 baud rate in bps 1 – 10000000:|CAN3 baud rate in bps 1 – 10000000:
\ No newline at end of file

Processing rpp_lib/CAN Transmit
rpp_lib/CAN Transmit: MaskType not up-to-date
--- sfunction_cantransmit.MaskType.old 2014-12-01 23:16:53.102638954 +0100
+++ sfunction_cantransmit.MaskType.new 2014-12-01 23:16:53.102638954 +0100
@@ -1 +1 @@
-RPP CAN bus transmit a message
\ No newline at end of file
+RPP CAN Transmit
\ No newline at end of file

rpp_lib/CAN Transmit: MaskDescription not up-to-date
--- sfunction_cantransmit.MaskDescription.old 2014-12-01 23:16:53.186637693 +0100
+++ sfunction_cantransmit.MaskDescription.new 2014-12-01 23:16:53.186637693 +0100
@@ -1,4 +1,4 @@
 <p>Transmit a CAN message.</p>
 <p>Expects a uint8, uint16, uint32 or CAN_MESSAGE object as an input. Use CAN Pack to create the CAN_MESSAGE object.</p>
 <p>Matlab expression can be used as Message ID and Mailbox number.</p>
-<p>Uncheck <i>Automatic mailbox number</i>, if user defined mailbox number is needed.<br>
\ No newline at end of file
+<p>Uncheck <em>Automatic mailbox number</em>, if user defined mailbox number is needed.</p>

rpp_lib/CAN Transmit: MaskPromptString not up-to-date
--- sfunction_cantransmit.MaskPromptString.old 2014-12-01 23:16:53.258636612 +0100
+++ sfunction_cantransmit.MaskPromptString.new 2014-12-01 23:16:53.258636612 +0100
@@ -1 +1 @@
-Module|Frame type|Message ID|Automatic mailbox number|Mailbox number (1-64)
\ No newline at end of file
+Module:|Frame type:|Message ID:|Automatic mailbox number|Mailbox number [1–64]:
\ No newline at end of file

Processing rpp_lib/Configure FlexRay node
rpp_lib/Configure FlexRay node: MaskType not up-to-date
--- sfunction_frayconfig.MaskType.old 2014-12-01 23:16:53.434633972 +0100
+++ sfunction_frayconfig.MaskType.new 2014-12-01 23:16:53.434633972 +0100
@@ -0,0 +1 @@
+RPP Configure FlexRay Node
\ No newline at end of file

rpp_lib/Configure FlexRay node: MaskDescription not up-to-date
--- sfunction_frayconfig.MaskDescription.old 2014-12-01 23:16:53.526632591 +0100
+++ sfunction_frayconfig.MaskDescription.new 2014-12-01 23:16:53.526632591 +0100
@@ -0,0 +1 @@
+<p>This block ...</p>

rpp_lib/Configure FlexRay node: MaskPromptString not up-to-date
--- sfunction_frayconfig.MaskPromptString.old 2014-12-01 23:16:53.614631270 +0100
+++ sfunction_frayconfig.MaskPromptString.new 2014-12-01 23:16:53.614631270 +0100
@@ -1 +1 @@
-gColdStartAttempts|gListenNoise|gMacroPerCycle|gMaxWithoutClockCorrectionFatal|gMaxWithoutClockCorrectionPassive|gNetworkManagementVectorLength|gNumberOfMinislots|gNumberOfStaticSlots|gOffsetCorrectionStart|gPayloadLengthStatic|gSyncNodeMax|gdActionPointOffset|gdCASRxLowMax|gdDynamicSlotIdlePhase|gdMinislot|gdMinislotActionPointOffset|gdNIT|gdSampleClockPeriod|gdStaticSlot|gdTSSTransmitter|gdWakeupSymbolRxIdle|gdWakeupSymbolRxLow|gdWakeupSymbolRxWindow|gdWakeupSymbolTxIdle|gdWakeupSymbolTxLow|pAllowHaltDueToClock|pAllowPassiveToActive|pChannels|pClusterDriftDamping|pDelayCompensationA|pDelayCompensationB|pExternOffsetCorrection|pExternRateCorrection|pKeySlotUsedForStartup|pKeySlotUsedForSync|pLatestTx|pMacroInitialOffsetA|pMacroInitialOffsetB|pMicroInitialOffsetA|pMicroInitialOffsetB|pMicroPerCycle|pRateCorrectionOut|pOffsetCorrectionOut|pSamplesPerMicrotick|pSingleSlotEnabled|pWakeupChannel|pWakeupPattern|pdAcceptedStartupRange|pdListenTimeout|pdMaxDrift|pDecodingCorrection|syncFramePayloadMultiplexEnabled|secureBuffers
\ No newline at end of file
+gColdStartAttempts:|gListenNoise:|gMacroPerCycle:|gMaxWithoutClockCorrectionFatal:|gMaxWithoutClockCorrectionPassive:|gNetworkManagementVectorLength:|gNumberOfMinislots:|gNumberOfStaticSlots:|gOffsetCorrectionStart:|gPayloadLengthStatic:|gSyncNodeMax:|gdActionPointOffset:|gdCASRxLowMax:|gdDynamicSlotIdlePhase:|gdMinislot:|gdMinislotActionPointOffset:|gdNIT:|gdSampleClockPeriod:|gdStaticSlot:|gdTSSTransmitter:|gdWakeupSymbolRxIdle:|gdWakeupSymbolRxLow:|gdWakeupSymbolRxWindow:|gdWakeupSymbolTxIdle:|gdWakeupSymbolTxLow:|pAllowHaltDueToClock|pAllowPassiveToActive:|pChannels:|pClusterDriftDamping:|pDelayCompensationA:|pDelayCompensationB:|pExternOffsetCorrection:|pExternRateCorrection:|pKeySlotUsedForStartup|pKeySlotUsedForSync|pLatestTx:|pMacroInitialOffsetA:|pMacroInitialOffsetB:|pMicroInitialOffsetA:|pMicroInitialOffsetB:|pMicroPerCycle:|pRateCorrectionOut:|pOffsetCorrectionOut:|pSamplesPerMicrotick:|pSingleSlotEnabled:|pWakeupChannel:|pWakeupPattern:|pdAcceptedStartupRange:|pdListenTimeout:|pdMaxDrift:|pDecodingCorrection:|syncFramePayloadMultiplexEnabled|secureBuffers:
\ No newline at end of file

Processing rpp_lib/Configure RX buffer
rpp_lib/Configure RX buffer: MaskType not up-to-date
--- sfunction_frayreceive.MaskType.old 2014-12-01 23:16:53.778628809 +0100
+++ sfunction_frayreceive.MaskType.new 2014-12-01 23:16:53.778628809 +0100
@@ -0,0 +1 @@
+RPP Configure RX buffer
\ No newline at end of file

rpp_lib/Configure RX buffer: MaskDescription not up-to-date
--- sfunction_frayreceive.MaskDescription.old 2014-12-01 23:16:53.854627669 +0100
+++ sfunction_frayreceive.MaskDescription.new 2014-12-01 23:16:53.854627669 +0100
@@ -0,0 +1 @@
+<p>This block ...</p>

rpp_lib/Configure RX buffer: MaskPromptString not up-to-date
--- sfunction_frayreceive.MaskPromptString.old 2014-12-01 23:16:53.930626527 +0100
+++ sfunction_frayreceive.MaskPromptString.new 2014-12-01 23:16:53.930626527 +0100
@@ -1 +1 @@
-channel|cycleCounterFiltering|maxPayload (in half-words)|msgBufferInterrupt|payloadPreambleIndicatorTr|singleTransmit|slotId
\ No newline at end of file
+channel:|cycleCounterFiltering:|maxPayload (in half-words):|msgBufferInterrupt|payloadPreambleIndicatorTr|singleTransmit|slotId:
\ No newline at end of file

Processing rpp_lib/Configure TX buffer
rpp_lib/Configure TX buffer: MaskType not up-to-date
--- sfunction_fraytransmit.MaskType.old 2014-12-01 23:16:54.094624066 +0100
+++ sfunction_fraytransmit.MaskType.new 2014-12-01 23:16:54.094624066 +0100
@@ -0,0 +1 @@
+RPP Configure TX buffer
\ No newline at end of file

rpp_lib/Configure TX buffer: MaskDescription not up-to-date
--- sfunction_fraytransmit.MaskDescription.old 2014-12-01 23:16:54.174622865 +0100
+++ sfunction_fraytransmit.MaskDescription.new 2014-12-01 23:16:54.174622865 +0100
@@ -0,0 +1 @@
+<p>This block ...</p>

rpp_lib/Configure TX buffer: MaskPromptString not up-to-date
--- sfunction_fraytransmit.MaskPromptString.old 2014-12-01 23:16:54.246621785 +0100
+++ sfunction_fraytransmit.MaskPromptString.new 2014-12-01 23:16:54.246621785 +0100
@@ -1 +1 @@
-channel|cycleCounterFiltering|maxPayload (in half-words)|msgBufferInterrupt|payloadPreambleIndicatorTr|singleTransmit|slotId
\ No newline at end of file
+channel:|cycleCounterFiltering:|maxPayload (in half-words):|msgBufferInterrupt|payloadPreambleIndicatorTr|singleTransmit|slotId:
\ No newline at end of file

Processing rpp_lib/Digital Input
rpp_lib/Digital Input: MaskDescription not up-to-date
--- sfunction_din.MaskDescription.old 2014-12-01 23:16:54.474618363 +0100
+++ sfunction_din.MaskDescription.new 2014-12-01 23:16:54.474618363 +0100
@@ -1,5 +1,3 @@
-Gets the digital value of the specified digital input pin on the RPP board.
-
-If pin is high the output is 1, 0 if the pin is low.
-
-If an error is detected while getting the pin, the ErrFlag is set high.
\ No newline at end of file
+<p>Gets the digital value of the specified digital input pin on the RPP board.</p>
+<p>If pin is high the output is 1, 0 if the pin is low.</p>
+<p>If an error is detected while getting the pin, the ErrFlag is set high.</p>

rpp_lib/Digital Input: MaskPromptString not up-to-date
--- sfunction_din.MaskPromptString.old 2014-12-01 23:16:54.550617222 +0100
+++ sfunction_din.MaskPromptString.new 2014-12-01 23:16:54.550617222 +0100
@@ -1 +1 @@
-Pin number [0-15]:|User variable threshold|Pull:|Active:
\ No newline at end of file
+Pin number [0-15]:|Use variable threshold|Pull:|Active:
\ No newline at end of file

rpp_lib/Digital Input: MaskHelp not up-to-date
--- sfunction_din.MaskHelp.old 2014-12-01 23:16:54.634615961 +0100
+++ sfunction_din.MaskHelp.new 2014-12-01 23:16:54.634615961 +0100
@@ -1 +1,2 @@
-<p>This block allows to read the digital inputs on the RPP board. For pins number 0-7 is not relevant and not visible parameter 'Use variable threshold' and only one block for each pin can be in model. And oppositely for other pins (8-15) are not relevant and visible parameters of names 'Pull' and 'Active'. The variable threshold check change the read mode of the pin. For setting it see Digital Input Configure block.<br />The ErrFlag should raise if <code>rpp_din_update()</code> or <code>rpp_din_get()</code> returns error. <code>rpp_din_update()</code> is called just by the first DIN block in the model and thus only the first block could raise the flag because of this. In case an errors occurs the return value will always be LOW (0). Because the ErrFlag should never set, once set the following steps will never clear it back.</p>
+<p>This block allows to read the digital inputs on the RPP board. For pins number 0-7 is not relevant and not visible parameter 'Use variable threshold' and only one block for each pin can be in model. And oppositely for other pins (8-15) are not relevant and visible parameters of names 'Pull' and 'Active'. The variable threshold check change the read mode of the pin. For setting it see Digital Input Configure block.</p>
+<p>The ErrFlag should raise if <code>rpp_din_update()</code> or <code>rpp_din_get()</code> returns error. <code>rpp_din_update()</code> is called just by the first DIN block in the model and thus only the first block could raise the flag because of this. In case an errors occurs the return value will always be LOW (0). Because the ErrFlag should never set, once set the following steps will never clear it back.</p>

Processing rpp_lib/Digital Input Configure
rpp_lib/Digital Input Configure: MaskDescription not up-to-date
--- sfunction_dinc.MaskDescription.old 2014-12-01 23:16:54.778613800 +0100
+++ sfunction_dinc.MaskDescription.new 2014-12-01 23:16:54.778613800 +0100
@@ -1 +1 @@
-Configure Digital Input Reference Voltage.
\ No newline at end of file
+<p>This block allows one to set reference voltage (threshold) for DIN pins. The block have two parameters, one for pins 8 - 11 and the other for pins 12 - 15.</p>

rpp_lib/Digital Input Configure: MaskPromptString not up-to-date
--- sfunction_dinc.MaskPromptString.old 2014-12-01 23:16:54.850612718 +0100
+++ sfunction_dinc.MaskPromptString.new 2014-12-01 23:16:54.850612718 +0100
@@ -1 +1 @@
-Reference voltage for pins 8-11 [0-4095]|Reference voltage for pins 12-15 [0-4095]
\ No newline at end of file
+Reference voltage for pins 8-11 [0-4095]:|Reference voltage for pins 12-15 [0-4095]:
\ No newline at end of file

Processing rpp_lib/Digital Output
rpp_lib/Digital Output: MaskDescription not up-to-date
--- sfunction_lout.MaskDescription.old 2014-12-01 23:16:55.074609356 +0100
+++ sfunction_lout.MaskDescription.new 2014-12-01 23:16:55.074609356 +0100
@@ -1,5 +1,3 @@
-Sends the digital value to the specified logic output pin on the RPP board.
-
-An input of 1 sets the pin high and 0 sets the pin low.
-
-If an error is detected while setting the pin, the ErrFlag is set high.
\ No newline at end of file
+<p>Sends the digital value to the specified logic output pin on the RPP board.</p>
+<p>An input of 1 sets the pin high and 0 sets the pin low.</p>
+<p>If an error is detected while setting the pin, the ErrFlag is set high.</p>

Processing rpp_lib/H-Bridge Control
rpp_lib/H-Bridge Control: MaskDescription not up-to-date
--- sfunction_hbr.MaskDescription.old 2014-12-01 23:16:55.366604973 +0100
+++ sfunction_hbr.MaskDescription.new 2014-12-01 23:16:55.366604973 +0100
@@ -1,3 +1,2 @@
-Control H-Bridge (10A, PWM) at default frequency.
-
-This block expects input in range [-1.0, 1.0].
\ No newline at end of file
+<p>Control H-Bridge (10A, PWM) at default frequency.</p>
+<p>This block expects input in range [-1.0, 1.0].</p>

Processing rpp_lib/IRC Input
rpp_lib/IRC Input: MaskDescription not up-to-date
--- sfunction_irc.MaskDescription.old 2014-12-01 23:16:55.670600408 +0100
+++ sfunction_irc.MaskDescription.new 2014-12-01 23:16:55.670600408 +0100
@@ -1,7 +1 @@
-Gets value of specified IRC.
-
-The value is an 32 bit integer.
-
-Posible IRC numbers explanation
-    1: IRC connected to DIN10 and DIN11.
-    2: IRC connected to DIN14 and DIN15.
\ No newline at end of file
+<p>This block allows to read a value of an IRC sensors. Two configurations are supported: IRC is connected to pins DIN10 and DIN11 and/or pins DIN14 and DIN15. The ErrFlag output raises if an error is detected, which should normally not happen.</p>

Processing rpp_lib/Overrun Detection
rpp_lib/Overrun Detection: MaskType not up-to-date
--- sfunction_tror.MaskType.old 2014-12-01 23:16:55.886597166 +0100
+++ sfunction_tror.MaskType.new 2014-12-01 23:16:55.886597166 +0100
@@ -1 +1 @@
-Overrun detection
\ No newline at end of file
+RPP Overrun Detection
\ No newline at end of file

rpp_lib/Overrun Detection: MaskDescription not up-to-date
--- sfunction_tror.MaskDescription.old 2014-12-01 23:16:55.966595965 +0100
+++ sfunction_tror.MaskDescription.new 2014-12-01 23:16:55.966595965 +0100
@@ -1 +1 @@
-Connected function subsystem is executed when overrun is detected.
\ No newline at end of file
+<p>This block triggers connected simulink function subsystems in case that previous loop took more time than simulation time is set.</p>

Processing rpp_lib/Power Output
rpp_lib/Power Output: MaskDescription not up-to-date
--- sfunction_mout.MaskDescription.old 2014-12-01 23:16:56.254591640 +0100
+++ sfunction_mout.MaskDescription.new 2014-12-01 23:16:56.254591640 +0100
@@ -1 +1 @@
-Toggle RPP Power Outputs (2A, push/pull).
\ No newline at end of file
+<p>This block allows to write the power outputs (2A) on the RPP board. The ErrFlag should raise only if <code>rpp_mout_set()</code> returns error. Note that <code>rpp_mout_set()</code> returns error only if some bad parameter or in case it could detect a faulty condition on the pin in a very very short period of time after setting the value, see the function API for details. If the faulty condition persist on the next step the call will successfully detect the faulty condition and ErrFlag should set. Because the ErrFlag should never set, once set the following steps will never clear it back.</p>

Processing rpp_lib/SD-RAM Log Data
rpp_lib/SD-RAM Log Data: MaskType not up-to-date
--- sfunction_sdrw.MaskType.old 2014-12-01 23:16:56.474588337 +0100
+++ sfunction_sdrw.MaskType.new 2014-12-01 23:16:56.474588337 +0100
@@ -1 +1 @@
-RPP SD-RAM Write (Logging)
\ No newline at end of file
+RPP SD-RAM Write
\ No newline at end of file

rpp_lib/SD-RAM Log Data: MaskDescription not up-to-date
--- sfunction_sdrw.MaskDescription.old 2014-12-01 23:16:56.554587135 +0100
+++ sfunction_sdrw.MaskDescription.new 2014-12-01 23:16:56.554587135 +0100
@@ -1 +1,2 @@
-Log data on SD-RAM.
\ No newline at end of file
+<p>This block allows to log a double value to the SD-RAM. User needs to provide a valid PrintFormat string to format and register the double value on the log. The PrintFormat string should include two specifiers:<br /> 1. For the block ID. Any valid integer specifier.<br /> 2. For the value to log. Any valid double specifier.</p>
+<p>Note that the value of PrintFormat is inserted raw between quotes on code generation and thus there is no validation on it. Error to provide a valid PrintFormat could generate compilation errors or even run-time errors (normally this generates a warning on compile time). Note that the function for logging used is <code>rpp_sdr_printf()</code>, which is a blocking call, and can potentially overrun the step. The ErrFlag will set if <code>rpp_sdr_printf()</code> returns an error (for example out of memory), but will clear back if the next step the call to this function is successful.</p>

rpp_lib/SD-RAM Log Data: MaskPromptString not up-to-date
--- sfunction_sdrw.MaskPromptString.old 2014-12-01 23:16:56.626586054 +0100
+++ sfunction_sdrw.MaskPromptString.new 2014-12-01 23:16:56.626586054 +0100
@@ -1 +1 @@
-Block ID [0-255]:|Printf format for logging (include specifiers):
\ No newline at end of file
+Block ID [0-255]:|Printf format for logging:
\ No newline at end of file

Processing rpp_lib/Serial Configure
rpp_lib/Serial Configure: MaskDescription not up-to-date
--- sfunction_scic.MaskDescription.old 2014-12-01 23:16:56.854582631 +0100
+++ sfunction_scic.MaskDescription.new 2014-12-01 23:16:56.854582631 +0100
@@ -1 +1 @@
-Configure Serial Communication Interface baud rate. Default is 9600.
\ No newline at end of file
+<p>This block allows to configure the baud rate of the SCI. There should be only one block of this type per model, and this requirement is validated.</p>

Processing rpp_lib/Serial Printf
rpp_lib/Serial Printf: MaskDescription not up-to-date
--- sfunction_scip.MaskDescription.old 2014-12-01 23:16:57.158578065 +0100
+++ sfunction_scip.MaskDescription.new 2014-12-01 23:16:57.158578065 +0100
@@ -1 +1,2 @@
-Printf through the Serial Communication Interface.
\ No newline at end of file
+<p>This block allows to print a formatted string to the SCI. The <em>Print format</em> parameter is used as the format specifier for C <code>printf()</code> function. Note that this value is inserted raw between quotes during code generation and thus there is no validation on it. User should always put a valid specifier for the input type of the block.</p>
+<p>Due to Simulink limitations, it is not posible join diferent types into one vector. So one block can be used only for one type of inputs.</p>

rpp_lib/Serial Printf: MaskPromptString not up-to-date
--- sfunction_scip.MaskPromptString.old 2014-12-01 23:16:57.234576924 +0100
+++ sfunction_scip.MaskPromptString.new 2014-12-01 23:16:57.234576924 +0100
@@ -1 +1 @@
-Printf format (must include specifier for arguments):
\ No newline at end of file
+Print format:
\ No newline at end of file

rpp_lib/Serial Printf: MaskHelp not up-to-date
--- sfunction_scip.MaskHelp.old 2014-12-01 23:16:57.314575723 +0100
+++ sfunction_scip.MaskHelp.new 2014-12-01 23:16:57.314575723 +0100
@@ -1,2 +1,2 @@
-<p>This block allows to print a formatted string to the SCI. The PrintFormat string parameters SETTING is used as the format specifier. Note that this value is inserted raw between quotes on code generation and thus there is no validation on it. User should always put any valid specifier for the values on the input of the block.</p>
-<p>Because of Simulink limitations, it is not posible join diferent types in to one vector. So one block can be used only for one type of inputs.</p>
+<p>This block allows to print a formatted string to the SCI. The <em>Print format</em> parameter is used as the format specifier for C <code>printf()</code> function. Note that this value is inserted raw between quotes during code generation and thus there is no validation on it. User should always put a valid specifier for the input type of the block.</p>
+<p>Due to Simulink limitations, it is not posible join diferent types into one vector. So one block can be used only for one type of inputs.</p>

Processing rpp_lib/Serial Receive
rpp_lib/Serial Receive: MaskDescription not up-to-date
--- sfunction_scir.MaskDescription.old 2014-12-01 23:16:57.458573560 +0100
+++ sfunction_scir.MaskDescription.new 2014-12-01 23:16:57.458573560 +0100
@@ -1 +1 @@
-Reads one byte from the Serial Communication Interface.
\ No newline at end of file
+<p>This block allows to receive a byte from the SCI. The ErrFlag should raise if <code>rpp_sci_read_nb()</code> doesn't succeed. The behavior of the ErrFlag is different from others blocks in that this block will set or clear the flag if the call fails of success at each step. Note that this block uses the non-blocking call to read the SCI and thus will never cause an overrun.</p>

Processing rpp_lib/Serial Send
rpp_lib/Serial Send: MaskDescription not up-to-date
--- sfunction_scis.MaskDescription.old 2014-12-01 23:16:57.754569115 +0100
+++ sfunction_scis.MaskDescription.new 2014-12-01 23:16:57.754569115 +0100
@@ -1 +1,2 @@
-Sends one byte through the Serial Communication Interface.
\ No newline at end of file
+<p>This block allows to send a byte to the SCI.</p>
+<p>The ErrFlag will be set only if <code>rpp_sci_write_nb()</code> returns an error.</p>

doc: Update S-function YAML block to match the current state of the blocks

Mainly description and parameter names were updated. In most cases
descriptions were not checked for correctness (plain copy & paste). In
same cases I updated the text a bit.

doc: Do not append ':' to checkbox labels

doc: Implement updating of block description from YAML data

Merge branch 'master' of rtime.felk.cvut.cz:jenkicar/rpp-simulink

Large changes in documentation, still some parts and correcture missing

Whitespace fixes

doc: Introduce Help field in YAML doc

The reason is that I want to automatically generate both MaskDescription
and MaskHelp. Currently, these two things are often not consistent. For
now Help is set to be equal to Description, but in a future, Description
is supposed to be shorter (and displayed just in Simulink block),
whereas Help will be longer and will be used also in printed
documentation.

doc: Unify block names

- No "block" at the end of the name
- Don't use acronyms in block names

Merge branch 'master' of rtime.felk.cvut.cz:jenkicar/rpp-simulink

Fix download script ampersand typo

doc: Update mode parameters of block Mask automatically

This is an attempt to make the blocks more consistent with documentation.
Now the rpp_update_doc script also updates parameter prompt and block
title (tj. MaskType)

In a future, it would also be useful to have MaskDescription updated from
YAML, but we currently have no such a field in the YAML data.

Update built-in help in rpp_lib.slx

This was done by rpp_update_doc.m.

rpp_update_doc: Implement printing of diffs

For buildbot users to see the reason of failure.

Large changes in documentation

Make rpp_update_doc to return the number of updated blocks

This will be used by the buildbot to check that the help is up-to-date.

Add function that updates documentation of RPP blocks

The documentation is extracted from YAML comments in .c files.

Use a C macro as a function

Without this, uncrustify complains about the syntax.

Update rpp/lib submodule

doc: Restructure documentation

Another fix for Windows download script

Resolves invalid path to debug server error.

Fix the loadti download script, used in Windows

Fix calling of the loadti download script on Windows

Fix path to CCS root generation

Expand download function for Windows downloading

Some aditional changes in loadti.bat are necessary.

Fix retreiving of the CCS root path

The path contained only ordinar slashes (/), which was wrong for Windows.

Fix path generation to the Matlab root

On Windows the default installation path for Matlab is in "Program Files"
folder, which name contains spaces. This caused the compilation to fail.
Double quotes added to the begining and to the end of the path to avoid
wrong interpretation of the spaces in the directories names.

Extend rpp_download documentation

#Fixes: #1034

Add parameters names to error messages

Fixes: #1035

Remove unnecessary CAN_Common_MdlInitSizes call

This call is not needed any more as it is only a relict from
some previous code.

Fixes: #1032

Remove the SDRAM download code fragment

This fragment was not finished and has to be rewritten

Make error messages more clear

#fixes #1035

Do not fail in rpp_build_demos on Windows

Fix compile errors on Windows

This fixes all errors that appeared when compile_blocks.m was run under
Windows.

Make rpp_setup Windows compatible

Auto loading to Flash disabled, library and documentation updated

Some models had loading to Flash enabled, which caused the
rpp_compile_blocks to fail, when rpp board is disconnected.

The library and documentation was updated according to refs #916
The commit fixes #917.

Signed-off-by: Michal Horn <hornmich@fel.cvut.cz>

Simulink blocks tlc files tuned to reflect changes in rpp library

Until now, the model called convenience function rpp_init(), which
initialized all peripherals, even those, which vere not used. Also all
headers were included as well.

Now only those peripherals are initialized and only necessary header files
are included.

External mode seems to not work anymore and will be fixed in near future
commits.

This commit refs #916 and #917.

Excessive record removed from rpp_can_ctrl_config removed

It is better to not have it here until it is used by the timing
computation algorithm.

Tunable parameter checked and fixed for all blocks

Some FlexRay and CAN blocks had set tunable parameters in mask.
Setting a tunable parameter is nonsence since all the code is
generated and all the peripherals are configured only once, when
the program starts.

Fixes #1017

CAN Setup block tlc file modified to reflect changes in rpp-lib

The CAN Setup block have to initialize the new rpp_can_ctrl_config
structure records for right CAN bus initialisation.

Two others warnings fixed

Fixed warning "ert_main.c", line 46: warning #238-D: controlling expression is constant
Fixed warning Source 'can_ext_mode_demo/CAN Receive' specifies that its sample time

Signed-off-by: Michal Horn <hornmich@fel.cvut.cz>

Fixed warnings in flexray demos

Configure FlexRay node and Configure RX Buffer inherits sample
time from the model configuration. They have no input signals to
inherit the sample time from. So the warning has been disabled in
Model Configuration parameters
(Diagnostis->Sample Time->Source block specifies -1 sample time)

The second warning was caused by precission loss during a calculation.
The resulting value was set as the parameter instead of the whole equation
and the equation itself moved to the comment.

Fixes #982

Merge branch 'master' of rtime.felk.cvut.cz:jenkicar/rpp-simulink

Fixed syntax error when extenal mode enabled for model with CAN blocks

Compiler returned with undefined data types CAN_MESSAGE_EXTENDED and
CAN_MESSAGE_STANDARD errors when the external mode was enabled for
a model witch used RPP CAN blocks.
When CAN Pack or CAN Unpack block has been added to the model, the error disappeared.

Also a can_ext_mode_demo has been created for detection of similar error in the future.

Fixes #1015

Remove (or reduce) README files

The information in those files is already in .tex documentation. It makes
no sense to have it at two places.

doc: Simplify CCS link and add TODO comment

Documentation updated, references updated

Related to Feature #992

Texas Instruments loading script fixed

Javascripts vere simplified by removing all features, which are not used inour use case.
More catch/try blocks added to solve exceptions when quitting the script.
AutoRun after program loaded fixed.

Solved some bug in JVM, which caused the VM to fall with error message:

#
# An unexpected error has been detected by Java Runtime Environment:
#
#  SIGSEGV (0xb) at pc=0x2acafeca, pid=29608, tid=3333421888
#
# Java VM: Java HotSpot(TM) Client VM (11.3-b02 mixed mode linux-x86)
# Problematic frame:
# C  0x2acafeca
#
# If you would like to submit a bug report, please visit:
#   http://java.sun.com/webapps/bugreport/crash.jsp
#

Fixes #1014

Signed-off-by: Michal Horn <hornmich@fel.cvut.cz>

Update lib to the version with the new arm compiler

Update default compiler path in rpp_setup

do_download function improved to be compatible with future releases of MATLAB

The internal functions definitions of the coder.internal.ModelCodegenMgr
class are still chaging, so it should be really better to use rtwprivate
for data access.

CAN blocks icons tuned again

Name of the target MCU removed,
Checkbox for showing the configuration information removed,
When the block is too small, only message ID is printed, when it is large enough, all of the fialds are printed.

To invoke the refresh of the icon, parameters dialog has to be opened and closed. I have found no way how to redraw the icon in MoveFcn Callback, which is the only one, which is invoked after resizing of the block.

compilation errors fixed

CAN blocks masks icons changed

Icons follows the same template as others.
The details of the block configuration can be shown or hidden by checking the 'Show details in icon' checkbox.

doc: Don't use & in YAML doc

It is not properly escaped in LaTeX.

Ignore generated images

doc: Do not build documentation in subdirectory - it's buggy

doc: demo board image font changed

doc: Update makefile and latexmk to better handle dependencies

... and automatic generation of figures from sources.

Correct documentation formating of demo_boad

Use the svg version of demo_board scheme

todo: add conversion from svg to pdf to makefile properly

Added irc_input demo documentation

Updated some model images in documentation to fit with changes

Small change in DAC documentation to make it fit on one page