background image

PCAN-MiniDisplay – User Manual 
 

61 

D.1.6

 

[variableX] Section 

Each variable is indicated with a [variableX] section. X is a 
consecutive number, starting with 1. The number of variables is 
defined with the “variables” keyword in the [global] section. 

[variable1] 

 

name 

Name of the variable as a reference to be used with an instrument 
or a label (max. 23 characters). 

name="Speed" 
 

There are 3 special variable names for addressing device functions 
or parameters: 

name="dev_keys" 

 

Name your variable 

dev_keys

 to address the key functions of the 

PCAN-MiniDisplay. The variable can have the values: 0 for no key 
pressed, 1 for Enter, 2 for Key up, and 3 for Key down. 

name="dev_brightness" 

 

Name your variable 

dev_brightness

 to set the display brightness 

of the PCAN-MiniDisplay. Integer values from 0 to 100 are valid. 

name=" dev_buzzer" 

 

Name your variable 

dev_buzzer

 to address the buzzer of the 

PCAN-MiniDisplay. Integer values from 0 to 14 are valid. The buzzer 
sound is only played once on change of the variable value. 
 

messagename 

The name refers to the respective [messageX] (max. 23 characters). 

messagename=”testmessage1” 

Содержание PCAN-MiniDisplay

Страница 1: ...Visualization Recording and Playback of CAN Data User Manual PCAN MiniDisplay Document version 2 4 0 2019 11 19...

Страница 2: ...uct names in this document may be the trademarks or registered trademarks of their respective companies They are not explicitly marked by or Copyright 2019 PEAK System Technik GmbH Duplication copying...

Страница 3: ...inition 14 3 1 General Description of an ins File 14 3 2 Example of an ins File 16 3 3 Using Several Scenes 18 4 Steps to Operation 19 4 1 Prerequisites 19 4 2 Preparing the Memory Card 19 4 3 Powerin...

Страница 4: ...cations 40 Appendix A CE Certificate 42 Appendix B Dimension Drawing 43 Appendix C Structure on the Memory Card 45 Appendix D Definition Files Reference 47 D 1 Scene Definition ins 47 D 2 Scenes Proje...

Страница 5: ...analyzed on a PC later on In addition to the built in PCAN MiniDisplay there is a version in plastic casing with push buttons available This can be used to create and evaluate application specific con...

Страница 6: ...of texts CAN data as well as the values of the analog and digital inputs via text labels Formattable output of CAN data as numbers float numbers or strings with consideration of enums and multiplexers...

Страница 7: ...g Windows software Playback of a recording with optional loop function Use of optionally equipped push buttons for menu navigation and to switch between multiple display configurations Dimensions 80 x...

Страница 8: ...ystem 2 2 on page 9 J3 and J7 USB 2 3 on page 10 J4 JTAG 2 4 on page 12 J5 microSD 2 5 on page 12 J6 Serial 2 6 on page 13 For basic use at least the power supply J2 a CAN connection J2 and a microSD...

Страница 9: ...led to do communication configuration changes or CAN tracing Figure 2 Pin assignment J1 external Buttons Pin Function 1 Din1 Down 2 Din2 Up 3 Din3 Enter 4 GND The 3 push buttons connect each function...

Страница 10: ...3 and J7 USB The connections J3 and J7 Mini USB port can be used for access to the memory card in the PCAN MiniDisplay from a PC via a USB connection The memory card can also be accessed with the PCAN...

Страница 11: ...memory card of the PCAN MiniDisplay Figure 6 Safely remove hardware windows icon in the taskbar notification area 2 3 2 Restriction for PCAN MiniDisplay Functions During a USB connection to a PC some...

Страница 12: ...ng purposes Figure 7 Pin assignment J4 JTAG Pin Function 1 GND 2 GND 3 Reset 4 3 3 V 5 TCK 6 TMS 7 TDO 8 TDI 9 RTCK 10 TRST 2 5 J5 microSD Slot for a microSD memory card max 32 GByte Figure 8 Location...

Страница 13: ...Serial Provides serial signals for customer specific extensions Figure 9 Pin assignment J6 Serial Pin Function 1 GND 2 5 V 3 TxD RS 232 4 RxD RS 232 5 DBG 6 Buzzer Note The serial pins RxD and TxD are...

Страница 14: ...ore include bitmap graphic files bmp and font files fon The content of a scene definition file is divided in different sections each containing definition entries global general specifications for the...

Страница 15: ...s interpreted by the PCAN MiniDisplay During load time the PCAN MiniDisplay generates a binary version of a definition inb That one is loaded much faster on future use because all conversions for pane...

Страница 16: ...Number of CAN messages defined in this scene variables 1 Number of variables defined in this scene labels 2 Number of labels defined in this scene message1 enable 1 1 Enables message processing of th...

Страница 17: ...label2 name label2 Name of the label for reference position 140 20 X position Y position in pixel 0 0 is the top left corner font_idx 0 Sets the font to be used fmt_string 3d km h Format definition va...

Страница 18: ...f scene definition files must be created in a scenes project file inp This list also defines which scene is used on startup A reference to the keywords to be used in those sections is located in appen...

Страница 19: ...ibes the steps to put the PCAN MiniDisplay to operation Please go through each of the following sections 4 1 Prerequisites microSD memory card max 32 GByte 512 MByte card is enclosed PC with SD card r...

Страница 20: ...Display Scenes Each scene must have its own subdirectory 3 End the USB connection in the PC s operating system and disconnect the USB cable If prepared in a PC remove the microSD memory card from it a...

Страница 21: ...MiniDisplay and insert it into a card reader attached to your PC The memory card appears as a mass storage device 4 3 Powering On the Device The PCAN MiniDisplay is powered on by applying a supply vol...

Страница 22: ...ipped with push buttons for example See section 2 1 on page 9 for details about the connection The PCAN MiniDisplay Case is equipped with the appropriate push buttons In that case browsing through the...

Страница 23: ...f the bus off state was reached due to too many send errors no more CAN messages are received or transmitted The PCAN MiniDisplay automatically resets the CAN controller after a certain time 4 5 Setti...

Страница 24: ...g to start tracing at startup 1 To the right of Start tracer select the checkbox and set the marker 2 At Tracer timeout enter the time span for stopping the tracer if no CAN messages are received The...

Страница 25: ...ic including RTR frames and error frames is recorded on the memory card of the PCAN MiniDisplay The timing is regarded too Trace CAN 1 Trace CAN 2 With these settings the information to be recorded ca...

Страница 26: ...eached the recording is continued in a new file The given File name is supplemented by a consecutive number If the option is inactive the recording is stopped when reaching the maximum file size Trace...

Страница 27: ...g the file sequence with the name trace_xx btr is overwritten Data A new sequence of files is created with each recording Later a trace file can be used for playback of the recorded CAN messages on th...

Страница 28: ...t and maximum fill level of the receive queue latter in parentheses If the queue has reached a fill level of 100 percent most likely some incoming CAN messages were not recorded CAN messages total Num...

Страница 29: ...and select the trace file btr for playback from the list 4 If you don t want the trace to be played back repeatedly change the Loop mode from Infinite to the desired number of cycles 1 to 9 5 If you u...

Страница 30: ...from the memory card of the PCAN MiniDisplay It is stored in binary coded trace files btr in the following directory MiniDisplay Traces For further use you must convert the data in an appropriate form...

Страница 31: ...ues CSV csv Common text based format for import into a spreadsheet semicolon as separator For further use of the trace data proceed as follows 1 Connect the PCAN MiniDisplay to the PC with the provide...

Страница 32: ...following to apply a CAN ID filter 1 Create a filter file with the extension flt with a text editor The format of the file is described in the appendix section D 3 on page 79 2 List the CAN IDs that c...

Страница 33: ...he connected CAN bus is unknown the PCAN MiniDisplay can automatically detect it This requires data traffic on the CAN bus Bitrates from the following series are recognized kbit s 1000 800 500 250 200...

Страница 34: ...controller The register settings are analog to those of a SJA1000 CAN controller operating at 16 MHz clock frequency Eight user defined entries can be edited Each entry contains a 2 byte value 4 hexad...

Страница 35: ...span of non use The power consumption is therefore reduced 6 1 9 Show startscreen After power on the PCAN MiniDisplay shows a bitmap file for a few seconds as start screen This behavior can be switch...

Страница 36: ...e Firmware updates files bin can be placed in the directory MiniDisplay Firmware on the memory card The update process is started by selecting a firmware file Important note Older PCAN MiniDisplays wi...

Страница 37: ...s long as a USB connection to a PC is established Show Directory Shows the directories on the memory card in order to see which files exist View Bitmap Only bitmap files bmp are shown in the directori...

Страница 38: ...Properties of the pictures File name bmp Format Windows bitmap Resolution max 320 x 240 pixels Color depth 24 bits Transparency Without alpha channel transparency by black and white mask no gradation...

Страница 39: ...PCAN MiniDisplay A bitmap file must be located on the internal memory card By default the manufacturer start screen PEAK logo is displayed The following table shows the file name and storage path to b...

Страница 40: ...voltage range from 0 to 16 5 V 10 bit A D converter 10 bit Range of values 0 0 V 1023 16 5 V Display Type a Si TFT active matrix Resolution 320 x 240 pixels Active area 57 6 x 43 2 mm W x L Memory car...

Страница 41: ...emperature 20 70 C 4 158 F Temperature for storage and transport 30 80 C 22 176 F Relative humidity 15 90 not condensing Measures Size With frame 82 x 62 x 18 3 mm W x L x D Without frame 80 x 55 x 18...

Страница 42: ...PCAN MiniDisplay User Manual 42 Appendix A CE Certificate...

Страница 43: ...isplay User Manual 43 Appendix B Dimension Drawing Figure 13 View onto the PCAN MiniDisplay with mounting frame IPEH 002262 The installation depth is 18 3 mm The figure does not correspond to the orig...

Страница 44: ...PCAN MiniDisplay User Manual 44 Figure 14 View onto the PCAN MiniDisplay without mounting frame IPEH 002262 The installation depth is 18 3 mm The figure does not correspond to the original size...

Страница 45: ...e lower than 1 2 x you must upgrade to version 1 1 7 before installing a firmware 1 2 x Help dhp Files of the PCAN MiniDisplay device help dhp It is recommended to update these files in connection wit...

Страница 46: ...PCAN MiniDisplay PEAK Converter exe Windows program PEAK Converter for converting a recorded binary trace file btr to another format Traces Fixed subdirectory for traces that are recorded by the PCAN...

Страница 47: ...ns The following describes all available keywords for a scene definition They are written into a ins text file and structured in sections Section names are indicated by square brackets e g global Entr...

Страница 48: ...PCAN MiniDisplay Otherwise no new binary file will be created and changes in the text file will be ignored protect The protect function is related to the creation of the binary version of a scene usin...

Страница 49: ...defined bitrate is closed that bitrate stays active Note During the device s startup the bitrate defined in the Device Settings menu is active for a short time before the bitrate of the scene is enabl...

Страница 50: ...cified for this project range 1 27 There are 3 internal fonts available To use the internal fonts use font_idx instead of a font name For more information see D 1 3 fontX Section on page 55 fonts 2 fl...

Страница 51: ...nt1 pictures Count of pictures per instrument range 1 99 pictures 4 name Name of the instrument max 23 characters Only for documen tation The string must be written with quotation marks name turn_left...

Страница 52: ...s have different sizes 1 The picture sequence will be drawn without saving the background makes only sense if all pictures of the instrument have the same size and are drawn at the same position Used...

Страница 53: ...el is defined by a separate grayscale bitmap The grayscale values define the transparency of the foreground picture RGB value 255 255 255 foreground picture is available to 100 no part of the backgrou...

Страница 54: ...ces the global background picture from instrument0 Typically an individual background pictures has the same size as the single pictures of the instrument background 1 update_rate Update rate of this i...

Страница 55: ...ke pic name xpos x position 0 319 Will be added to the parameter x Offset ypos y position 0 239 Will be added to the parameter y Offset low val The lowest variable value for displaying the picture hig...

Страница 56: ...8_numbers fon only digits from 0 to 9 Palatino_Linotype_12_14 fon Palatino_Linotype_16_20 fon Palatino_Linotype_24_28 fon Palatino_Linotype_24_32_numbers fon only numbers from 0 to 9 Palatino_Linotype...

Страница 57: ...ive number starting with 1 The number of messages is defined with the messages keyword in the global section Variables can refer to the CAN messages defined in this way message1 enable Value Descripti...

Страница 58: ...s the CAN channel receiving this message Value Description 0 CAN channel 1 1 CAN channel 2 channel 0 Use first CAN channel timeout If a messageX was not received in the specified time span up to 2 32...

Страница 59: ...meoutval 133 D 1 5 enumX Section Each enum is indicated with an enumX section X is a consecutive number starting with 1 The number of enums is defined with the enums keyword in the global section enum...

Страница 60: ...sists of the number of entries as specified in the keyword count The value of the variable which uses the enum determines which string from the list is used An entry consists of an integer value and t...

Страница 61: ...name dev_keys Name your variable dev_keys to address the key functions of the PCAN MiniDisplay The variable can have the values 0 for no key pressed 1 for Enter 2 for Key up and 3 for Key down name de...

Страница 62: ...to be used count starts at 0 The number of supported channels depends on source type Source type Value Description 0 CAN channel 1 CAN 1 CAN channel 2 0 Internal NTC 1 External input AIN 2 External i...

Страница 63: ...xtype specifies whether the variable to be configured is the multiplexer or is contained in the data of the message depending on a multiplexer Value Description 0 The multiplexer function is not used...

Страница 64: ...tion with internal data type float 32 bit Any larger value than this is limited to this value Use either maxraw OR maxval maxval Maximum physical value value from CAN message after scale offset calcul...

Страница 65: ...2 floating point number 32 bits 4 string vartype 1 A signed integer variable with an assumed bit length of 8 has a value range from 128 to 127 datatype Data type of the variable after reading from th...

Страница 66: ...enumX max 23 characters enum enum_test Example of a Variable variable1 name odometer messagename testmessage1 Name of the message position 8 16 Start bit and bit length byteorder 1 0 Intel 1 Motorola...

Страница 67: ...type 0 variable2 name multiplexed1 messagename testmessage1 position 8 16 byteorder 1 muxtype 2 2 multiplexed muxval 103 This variable is updated if the scale 1 multiplexer variable 1 has this value o...

Страница 68: ...haracters for documentation name odometer position X and Y position of label 1st parameter X position horizontal range 0 31 2nd parameter Y position vertical range 0 239 position 10 30 font_name Name...

Страница 69: ...ing Format specification according to the printf function known from various programming languages for output of the variable value If no formatting is specified a standard formatting corresponding to...

Страница 70: ...redrawn with this rate independent of the reception of a relevant variable update_rate 100 Redraw label not faster than every 100 ms update_rate 0 Updates label as fast as possible each time the varia...

Страница 71: ...alue is equal 0 to 10 the displayed value is shown in red and flashing In the range of 11 to 244 is displayed in green In the range of 245 to 255 it is displayed in red and flashing range A sector is...

Страница 72: ...27 0 0 RGB value mid red sector 1 New sector 1 enabled range 0 10 Applicable for values within 0 to 10 fontcolor 0 255 0 Font color if value in this range bgcolor 0 0 0 Background color for this range...

Страница 73: ...ot line color as an 8 bit RGB value The color components red green and blue have a value range from 0 to 255 plotcolor 255 0 0 Color is 100 red plotcolor 127 127 127 Color is mid gray bgcolor Defines...

Страница 74: ...raw the complete diagram var_nameX Name of the data source max 23 characters X can be 1 2 3 or 4 for up to 4 variables in a plotter diagram See channels keyword var_name1 speed var_name2 acceleration...

Страница 75: ...a scene txlist_init txlist_cyclic The transmit list is executed cyclically during the scene txlist_cyclic txlist_exit The transmission list is executed once when ending a scene txlist_exit After the i...

Страница 76: ...N channel 1 1 CAN channel 2 delay 1 message ID frameformat messagetype length data 0 message ID Specifies the ID of the CAN message as a 11 bit or 29 bit integer value decimal or hex delay bus 0x180 f...

Страница 77: ...smit Lists txlist_init Send once by starting a scene count 6 100 0 0x80 s d 4 0x11 0x22 0x33 0x44 200 0 0x81 s d 5 0x11 0x22 0x33 0x44 0x55 250 0 0x82 s d 8 0x11 0x22 0x33 0x44 0x55 0x66 0x77 0x88 100...

Страница 78: ...4 200 1 0x48 s d 5 0x21 0x22 0x23 0x24 0x258 D 2 Scenes Project File inp Note The text file inp must have an empty line at its end D 2 1 global Section version Version format Currently only 1 version...

Страница 79: ...f a CAN ID filter flt file is determined in the Device Settings menu of the PCAN MiniDisplay While a recording CAN IDs and ID ranges that are listed in a filter file can pass the filter All the others...

Страница 80: ...0 1023 range_11bit Defines 11 bit CAN ID ranges that can pass the filter 4 13 0x200 0x340 Full 11 bit range 0x000 0x7ff single_29bit Defines 29 bit CAN IDs that can pass the filter 0x123 0x11111 12500...

Страница 81: ...isplay User Manual 81 125000 0x1E848 range_29bit 500 550 0x9000 0x10000 0x1F80000 0x1FA0000 Tip On the memory card of the PCAN MiniDisplay the example Example flt is located in the directory MiniDispl...

Страница 82: ...te the development of configurations for the PCAN MiniDisplay Figure 15 Model with casing and push buttons E 1 Scope of Supply PCAN MiniDisplay in plastic casing including mating connectors Phoenix Co...

Страница 83: ...scene display and show the main menu Menus Skip to previous or next entry of a menu or of a list Activate the selected entry Off supply voltage applied No function Start device No function Note The d...

Страница 84: ...accessible by opening the casing Do the following to access the microSD card slot 1 From the bottom of the casing cautiously remove the four plastic caps 2 Remove the four screws from the wholes that...

Страница 85: ...card with a suitable tool e g tweezer until the spring mechanism is released click sound 5 Carefully remove the microSD card with a tool 6 When inserting a microSD card push it in until the spring mec...

Страница 86: ...s are given in the following table Refer to Technical Specifications on page 40 for further details Technical specifications only IPEH 002262 KSM01 Size 116 5 x 24 5 x 72 5 mm W x H x D Weight 138 g I...

Отзывы: