Setup
System Requirements
EHANDBOOK Container-Build Tools is a 64-bit application and works on Microsoft Windows 10 with 64-bit versions. It requires a minimum 8 GB available RAM. An SSD is highly recommended to speed up file I/O operations. 16 GB RAM or more may be required for processing complex models and huge amount of texts and graphics.
The amount of RAM EHANDBOOK Container-Build is allowed to use is specified in the eHandbookCB.ini file. Please refer to chapter RAM Usage for details.
Download
The EHANDBOOK Container-Build Tools can be downloaded from the ETAS download server.
Installation
The EHB-CB is delivered as a .zip archive and a tarball (extension '.tar.gz'). Any zip archive management tool (e.g. 7zip or WinZip) can be used to unzip the contents into a local drive. Likewise, the contents of .tar.gz can be extracted using the tar utility on Linux based systems. Further tool installation is required for EHB-CB versions with an electronic license, see License Management Installation.
|
The user must have full access rights to the installation directory. Typically, this is not the case for the directory “Program Files”, so use another directory, e.g. C:\ETAS... |
Please check, if any optional prerequisite software installation is required before you start the tool (see chapter Additional Third Party Tools).
Windows
The tool archive is broadly named as EHANDBOOK-Container-Build_x.y.z_[TAG].zip for Windows. Once unzipped, contains the below mentioned contents:
-
configuration
-
documentation
-
examples
-
features
-
icons
-
jre
-
p2
-
plugins
-
artifacts.xml
-
eHandbookCB.exe
-
eHandbookCB.ini
-
License_Management_setup.exe
eHandbookCB.exe is the application executable which is used to create the EHANDBOOK container.
Linux
The tool archive is broadly named as EHANDBOOK-Container-Build_x.y.z_[TAG].tar.gz for Linux based systems. Once extracted, contains the below mentioned contents:
-
artifacts.xml
-
configuration
-
documentation
-
eHandbookCB
-
eHandbookCB.ini
-
examples
-
features
-
icons
-
jre
-
license
-
p2
-
plugins
eHandbookCB is the application executable which is used to create the EHANDBOOK container.
Common for Windows and Linux
The documentation/oss_licenses folder contains the necessary open source license information of various components, which are part of the EHB-CB.
The examples folder contains sample files in corresponding sub folders for container configuration and text styling. Their usage is described in the following chapters.
Electronic Licenses
ETAS software products are protected by electronic license keys. To operate EHANDBOOk Container-Build tools, please ensure that your license keys are installed appropriately.
Evaluation Licenses
You can evaluate all EHANDBOOK tools to check the suitability for your needs. To start your free evaluation, go to http://license.etas.com and choose the product you want to evaluate.
|
License Management Installation
In order to use the protected product package, you must register your license.
Windows
In a windows based system, please run the following installer once for adding your license configuration to the Windows registry.
The following steps are required:
-
Run License_Management_setup.exe (located in the CB installation folder)
-
Start the ETAS License Manager
-
Go to Menu → Device → Online Activation
-
Place the provided Activation ID
-
Verify license installation in ETAS License Manager. Depending of your license, you will see only some elements of these:
Linux
In a Linux based system, please run the following shell script once to install ETAS License Manager:
-
Run License_Management_setup.sh with administrative permissions (Located in "license" subfolder in the CB installation folder)
-
Copy your license file to ‘/usr/share/ETAS/LiMa/CommonLicensePath‘ (for all users) or ‘$HOME/ETAS/LiMa/UserLicensePath‘ (current user)
-
You can also customize those locations by changing the configuration in ‘/etc/etas/lima/LiMa.ini‘ (CommonLicensePath and UserLicensePath)
Common for Windows and Linux
Feature-License Mapping:
| Feature | License Key |
|---|---|
ASAM CC, FSX and MDX file inputs |
EHB_CB_BASE_ASAM |
Directory based file inputs |
EHB_CB_BASE_DIR |
ASCET model converter |
EHB_CB_MDL_ASCET |
SIMULINK model converter |
EHB_CB_MDL_SIMULINK |
C-CODE converter |
EHB_CB_MDL_CCODE |
PDF generator |
EHB_CB_PDFGEN |
ASCET for Unified Graphics Generator |
EHB_CB_UGG_ASCET |
C-Code for Unified Graphics Generator |
EHB_CB_UGG_CCODE |
SL for Unified Graphics Generator |
EHB_CB_UGG_SIMULINK |
AUTOSAR Classic ARXML files processing |
EHB_CB_CON_AUTOSAR_CLASSIC |
Additional Third Party Tools
EHANDBOOK Container-Build uses few third party tools for model, image and TeX formula conversions which are not part of this software package.
PDF FLY
Tool vendor: Visual Integrity Technologies LLC
Minimum Tool Version: 9.0.5
As standard EHANDBOOK Container-Build expects all graphics in .svg or raster formats (i.e., .jpeg, .bmp or .png). However, if images referenced in the FSX file are provided in PostScript or Encapsulated PostScript (.ps or .eps) format, the tool PDF FLY is required to transform it into .svg.
MiKTeX
Tool Provider: MikTex
Link: http://miktex.org
Required Tool Version: 2.9
MiKTeX is required, if TeX formula expressions are present in FSX files. It dissolves the TeX expressions and transforms them into .eps format. These .eps are sent to PDF FLY tool to generate .svg images then.
|
As all formula elements will be transformed into polylines and clip-paths they will not have any textual information and hence are not selectable/searchable later on in EHB-NAV. |
MATLAB
Tool vendor: The Mathworks
Required Tool Version: MATLAB 2013a or above
For advanced styling of some Simulink blocks (e.g. masks) MATLAB connection during container build process is required. If multiple versions of MATLAB are installed and no command line parameter is given, the latest installed will be used.