TFT100 Manual CAN Commands - Revision history

Arijus.C at 10:33, 30 April 2026

2026-04-30T10:33:01Z

← Older revision		Revision as of 13:33, 30 April 2026
Line 16:		Line 16:
	*Transport's CAN communication protocol (with information about frames, parameters, ID's, baud rate '''<u>and commands</u>''').		*Transport's CAN communication protocol (with information about frames, parameters, ID's, baud rate '''<u>and commands</u>''').

	[[Image:Manual CAN Commands Settings.png\|~~750px\|left~~]]		<br />[[Image:Manual CAN Commands Settings.png\|center]]
	~~<div style="clear: both;"></div>~~

	==Manual CAN Commands Settings==		==Manual CAN Commands Settings==
Line 28:		Line 27:
	*<b>Data length</b> - Defines command data length in bytes.		*<b>Data length</b> - Defines command data length in bytes.
	*<b>Send Type</b> - Selects command send type:<br> - If ''Once'' is selected - command will be send one time after it is triggered.<br> - If ''Periodic'' is selected - command will be send periodically after it is triggered.<br> - If ''Response'' is selected - command will be send once as response to received manual can message.		*<b>Send Type</b> - Selects command send type:<br> - If ''Once'' is selected - command will be send one time after it is triggered.<br> - If ''Periodic'' is selected - command will be send periodically after it is triggered.<br> - If ''Response'' is selected - command will be send once as response to received manual can message.
	*<b>Run On Startup</b> - If enabled, the command will be triggered automatically on device startup.
	*<b>Send Period</b> - Defines command send period in ms <u>if Periodic send type is selected</u>.		*<b>Send Period</b> - Defines command send period in ms <u>if Periodic send type is selected</u>.
			*<b>Response</b> - Defines Manual CAN message which will trigger command.
	*<b>Send Count</b> - Defines command sending count <u>if Periodic send type is selected</u>:<br> - If set to 0 - command will be send infinitely until it is turned off by user.		*<b>Send Count</b> - Defines command sending count <u>if Periodic send type is selected</u>:<br> - If set to 0 - command will be send infinitely until it is turned off by user.
	*<b>Response</b> - Defines Manual CAN message which will trigger command.

	{\| class="wikitable"		{\| class="wikitable"
	! rowspan="2" \|Parameter Id		! rowspan="2" \|Parameter Id
			! rowspan="2" \|Parameter Type
	! rowspan="2" \|Name		! rowspan="2" \|Name
	! colspan="3" \|Value		! colspan="3" \|Value
Line 44:		Line 43:
	\|-		\|-
	\|16000 + 10 * Command number		\|16000 + 10 * Command number
			\|Uint8
	\|CAN Type		\|CAN Type
	\|0 - Disabled		\|0 - Disabled
Line 55:		Line 55:
	\|-		\|-
	\|16001 + 10 * Command number		\|16001 + 10 * Command number
			\|Char
	\|CAN ID		\|CAN ID
	\|00000000		\|00000000
Line 62:		Line 63:
	\|-		\|-
	\|16002 + 10 * Command number		\|16002 + 10 * Command number
			\|Char
	\|Data		\|Data
	\|0000000000000000		\|0000000000000000
Line 69:		Line 71:
	\|-		\|-
	\|16003 + 10 * Command number		\|16003 + 10 * Command number
			\|Uint8
	\|Data length		\|Data length
	\|0		\|0
Line 76:		Line 79:
	\|-		\|-
	\|16004 + 10 * Command number		\|16004 + 10 * Command number
			\|Uint8
	\|Send Type		\|Send Type
	\|0 - Once		\|0 - Once
Line 87:		Line 91:
	\|-		\|-
	\|16005 + 10 * Command number		\|16005 + 10 * Command number
			\|Uint32
	\|Send Period		\|Send Period
	\|0		\|0
Line 94:		Line 99:
	\|-		\|-
	\|16006 + 10 * Command number		\|16006 + 10 * Command number
			\|Uint8
	\|Response		\|Response
	\|0		\|0
Line 101:		Line 107:
	\|-		\|-
	\|16007 + 10 * Command number		\|16007 + 10 * Command number
			\|Uint16
	\|Send Count		\|Send Count
	\|0		\|0
Line 108:		Line 115:
	\|-		\|-
	\|16008 + 10 * Command number		\|16008 + 10 * Command number
			\|Uint8
	\|Run On Startup		\|Run On Startup
	\|0 - Disabled		\|0 - Disabled
Line 115:		Line 123:
	\|}		\|}

	==Important ~~note~~!==		==Important Note!==
	<b>Send Period details</b>		<b>Send Period details</b>
	#If only CAN commands are being used:		#If only CAN commands are being used:

Arijus.C at 07:17, 24 March 2026

2026-03-24T07:17:09Z

← Older revision		Revision as of 10:17, 24 March 2026
Line 16:		Line 16:
	*Transport's CAN communication protocol (with information about frames, parameters, ID's, baud rate '''<u>and commands</u>''').		*Transport's CAN communication protocol (with information about frames, parameters, ID's, baud rate '''<u>and commands</u>''').

	~~<br />~~[[Image:Manual CAN Commands Settings.png\|~~center~~]]		[[Image:Manual CAN Commands Settings.png\|750px\|left]]
			<div style="clear: both;"></div>

	==Manual CAN Commands Settings==		==Manual CAN Commands Settings==

Arijus.C at 13:37, 23 March 2026

2026-03-23T13:37:15Z

← Older revision		Revision as of 16:37, 23 March 2026
Line 27:		Line 27:
	*<b>Data length</b> - Defines command data length in bytes.		*<b>Data length</b> - Defines command data length in bytes.
	*<b>Send Type</b> - Selects command send type:<br> - If ''Once'' is selected - command will be send one time after it is triggered.<br> - If ''Periodic'' is selected - command will be send periodically after it is triggered.<br> - If ''Response'' is selected - command will be send once as response to received manual can message.		*<b>Send Type</b> - Selects command send type:<br> - If ''Once'' is selected - command will be send one time after it is triggered.<br> - If ''Periodic'' is selected - command will be send periodically after it is triggered.<br> - If ''Response'' is selected - command will be send once as response to received manual can message.
			*<b>Run On Startup</b> - If enabled, the command will be triggered automatically on device startup.
	*<b>Send Period</b> - Defines command send period in ms <u>if Periodic send type is selected</u>.		*<b>Send Period</b> - Defines command send period in ms <u>if Periodic send type is selected</u>.
			*<b>Send Count</b> - Defines command sending count <u>if Periodic send type is selected</u>:<br> - If set to 0 - command will be send infinitely until it is turned off by user.
	*<b>Response</b> - Defines Manual CAN message which will trigger command.		*<b>Response</b> - Defines Manual CAN message which will trigger command.
	*<b>Send Count</b> - Defines command sending count <u>if Periodic send type is selected</u>:<br> - If set to 0 - command will be send infinitely until it is turned off by user.

	{\| class="wikitable"		{\| class="wikitable"

Arijus.C: /* Manual CAN Commands Settings */

2026-03-23T08:50:33Z

Manual CAN Commands Settings

← Older revision		Revision as of 11:50, 23 March 2026
Line 104:		Line 104:
	\|0		\|0
	\|Send Count		\|Send Count
			\|-
			\|16008 + 10 * Command number
			\|Run On Startup
			\|0 - Disabled
			\|1 - Enabled
			\|0 - Disabled
			\|Run On Startup
	\|}		\|}

Martyna.D: Protected "TFT100 Manual CAN Commands" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

2023-03-27T07:38:17Z

Protected "TFT100 Manual CAN Commands" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

← Older revision		Revision as of 10:38, 27 March 2023
(No difference)

Martyna.D: Created page with "TOC ==Manual CAN Commands== right To use Manual CAN Commands functionality, the user can select any of listed available CAN protocols in..."

2023-03-27T07:38:11Z

Created page with "__TOC__ ==Manual CAN Commands== right To use Manual CAN Commands functionality, the user can select any of listed available CAN protocols in..."

New page

__TOC__
==Manual CAN Commands==
[[Image:Manual CAN Commands.png|right]]
To use Manual CAN Commands functionality, the user can select any of listed available CAN protocols in CAN I/O tab apart from "None". Afterwards, Manual CAN Commands functionality can be found at the bottom of Manual CAN Settings tab in configurator.
{| class="wikitable" style="border-style: solid; border-width: 0px;"
|+
| style="width: auto; text-align: left; background: #F6F6FB;" |'''NOTE!'''
| style="width: auto; text-align: left; background: #F6F6FB;" |Manual CAN Commands can be tested on FW 55.00.09.rev.08 or newer
|}
Manual CAN Commands functionality allows user to send configurable commands in CAN network. Up to 10 Manual CAN Commands could be configured by setting parameters using SMS/GPRS commands or in configurator at the bottom of Manual CAN Settings tab. 
The main benefit, of using Manual CAN Commands functionality is that the user is able to control the transport via CAN BUS without requiring additional specific commands implementation from the device's firmware side to perform certain action. To use this functionality, the user must have:

*TFT100 device with CAN interface;
*55.00.09.Rev.08 or newer firmware;
*Transport with CAN interface;
*Transport's CAN communication protocol (with information about frames, parameters, ID's, baud rate '''and commands''').

 [[Image:Manual CAN Commands Settings.png|center]]

==Manual CAN Commands Settings==
User can configure up to 10 Manual CAN Commands by setting CAN Type, CAN ID, Data, Data length, Send Type, Send Period, Send Count parameters.
[[Image:Manual CAN Send Type.gif]]

*CAN Type - Enables command and selects CAN ID Type which will be used in command.
*CAN ID - Defines command CAN ID.
*Data - Defines command data.
*Data length - Defines command data length in bytes.
*Send Type - Selects command send type: - If ''Once'' is selected - command will be send one time after it is triggered. - If ''Periodic'' is selected - command will be send periodically after it is triggered. - If ''Response'' is selected - command will be send once as response to received manual can message.
*Send Period - Defines command send period in ms if Periodic send type is selected.
*Response - Defines Manual CAN message which will trigger command.
*Send Count - Defines command sending count if Periodic send type is selected: - If set to 0 - command will be send infinitely until it is turned off by user.

{| class="wikitable"
! rowspan="2" |Parameter Id
! rowspan="2" |Name
! colspan="3" |Value
! rowspan="2" |Description
|-
!Min
!Max
!Default
|-
|16000 + 10 * Command number
|CAN Type
|0 - Disabled
|2 - Extended
|0 - Disabled
|0 - Disabled

1 - Standard

2 - Extended
|-
|16001 + 10 * Command number
|CAN ID
|00000000
|FFFFFFFF
|FFFFFFFF
|CAN ID Range
|-
|16002 + 10 * Command number
|Data
|0000000000000000
|FFFFFFFFFFFFFFFF
|FFFFFFFFFFFFFFFF
|CAN Data Range
|-
|16003 + 10 * Command number
|Data length
|0
|8
|0
|Length Bytes
|-
|16004 + 10 * Command number
|Send Type
|0 - Once
|2 - Response
|0 - Once
|0 - Once

1 - Periodic

2 - Response
|-
|16005 + 10 * Command number
|Send Period
|0
|2147483640
|0
|Period ms
|-
|16006 + 10 * Command number
|Response
|0
|29
|0
|Manual CAN No.
|-
|16007 + 10 * Command number
|Send Count
|0
|1000
|0
|Send Count
|}

==Important note!==
Send Period details
#If only CAN commands are being used:
#*Each command period increases approximately by 50 ms.
#*Enabling all messages with the same period adds delay of 500-550 ms <code>Example: 100 ms Period selected for all commands - each command sending could take up to 550 ms.</code>
#If CAN Commands will be used together with CAN data reading:
#*CAN DATA reading increase CAN commands period approximately by 50 ms. <code>Example: One command configured with 200 ms period - command sending could take up to 250 ms.</code>
#*Using all CAN commands period increase approximately by 150 ms.
#CAN Commands will be used together with frequent (less than 5 seconds) records saving/sending:
#*One command period increases approximately by 100 ms.
#*If all are commands used - period increases approximately by 200 ms.
#CAN Commands will be used together with CAN reading and frequent (less than 5 seconds) records saving/sending:
#*Using one command increases period by approximately 250 ms <code>Example: One command configured with 50 ms period could have delay up to 300 ms.</code>
#*Enabling all commands could drastically increase delay - sending could take up to 1.5 s (All commands configured with 100 ms period).

We strongly advise:

#If all commands are necessary with certain period - keep all commands with same sending period.
#If one particular command (ex. Heartbeat) is necessary to be sent with specific period - increase particular command period and increase other commands period as high as possible. <code>For example: Heartbeat 50 ms, all other commands 1000 ms.</code> That will give particular command priority, but other commands will be sent with a bigger delay than configured. 
#Do not leave any enabled CAN reading parameters if CAN reading is not used.
#Keep Data Acquisition settings with higher than 15 seconds.

{| class="wikitable" style="border-style: solid; border-width: 0px;"
|+
|-
| style="width: auto; text-align: left; background: #F6F6FB;" | '''NOTE!'''
| style="width: auto; text-align: left; background: #F6F6FB;" | Send Period details Records could drastically increase CAN command sending period as records could be generated every second by configured Features records, Data Acquisition settings or IO elements operands. Each particular case has different affect for CAN Command delay, that depends on configuration and in case of issue should be investigated individually.
|}

==SMS/GPRS Commands for Manual CAN Commands functionality==
*<code>'''mcan_cmd:<Command No.>'''</code> - Used to trigger Manual CAN Command.
*<code>'''mcan_stop:<Command No.>'''</code> - Used to turn off periodic Manual CAN Command.

==Examples==

*<code>Example on '''how to configure Manual CAN Commands''' functionality can be found in [[How to configure Manual CAN Commands?|here]].</code>

[[Category:TFT100 Configuration]]