background image

Software architecture

26/70

FDL Content: Basic Device Data

The following table shows the section of the FDL that holds the 

Basic

Device Data

; i.e. the identification data of the device.

Important:

Hilscher tools like the 

Communication Studio

 (though not the

Flasher tool) check some of these IDs for conformity against the IDs
contained in the File header (a.k.a. “device header”) of the *

.nxi

communication firmware before downloading the firmware to the
device. If these IDs do not match, the Hilscher tool will refuse to
download the COM firmware. 
The same applies to the *

.mxf

 maintenance firmware, which

manages firmware updates on the netX: It also checks these IDs
and refuses to update the COM firmware if these IDs do not match.
We therefore strongly advise you not to change the preset default
values of the basic device data in the FDL. Change or customize
only the serial number and the production date.

Offset

Size 
(bytes)

Data type

Name

Description/comments/values

16

2

UINT16

Manufacturer ID

Manufacturer ID managed and assigned by Hilscher. By
default, this field is filled with the code for Hilscher.

0

Undefined

1

Default code for Hilscher

... 

255

Hilscher

256 

... 

65535

OEM ID 
(managed and assigned to OEM by Hilscher)

18

2

UINT16

Device classification
number (device class)

0x003C

netX 90 (COM CPU)

0x0045

netX 90 (COM CPU) with SDRAM

20

4

UINT32

Device number

The numbers for Manufacturer 

1

 ... 

255

 (Hilscher) are

managed by Hilscher.

Note

: Hilscher tools use Manufacturer ID, device class and

device number for identifying a device type. The tools display
the device type and add a serial number, thus making
devices individually identifiable (in case multiple devices are
connected to the tool at once).

24

4

UINT32

Serial number

Serial number of the device. To be defined and incremented
for each device during production by OEM.

28

1

UINT8

Hardware
compatibility number

Index indicating whether a hardware version is compatible
with a firmware version. The index starts with zero and is
incremented each time if changes made to the hardware
require the firmware to be changed (adapted) as well.

29

1

UINT8

Hardware revision
number

Index starts with 

1

 and is incremented each time if hardware

is changed.

30

2

UINT16

Production date

Format is 

0xYYWW

:

Year

((usProductionDate >> 8) &

0x00ff) + 2000

Week

((usProductionDate >> 0) &

0x00ff)

Example

0C2Bh

 

(where 

0Ch

 is year 2012 and 

2Bh

 is week 43)

Note

: In the binary, the data is stored in 

Little endian format

,

thus offset 

30

 contains the week and offset 

31

 the year.

32

16

UINT8[16]

Reserved fields

Currently not used, set to 

0

Table 11: FDL Content: Basic Device Data

netX 90 | Production guide
DOC190101PG03EN | Revision 3 | English | 2019-07 | Released | Public

© Hilscher 2019

Summary of Contents for netX 90

Page 1: ...Production guide netX 90 Hilscher Gesellschaft f r Systemautomation mbH www hilscher com DOC190101PG03EN Revision 3 English 2019 07 Released Public...

Page 2: ...firmware mxf 36 2 3 7 Hardware configuration file for maintenance firmware mwc 39 2 4 Boot process 42 2 4 1 Overview 42 2 4 2 Console mode 45 2 4 3 Alternative boot mode 46 3 End of line programming...

Page 3: ...d 3 2019 07 12 MKE Document revised and released Table 1 List of revisions 1 2 Further relevant documentation Besides this production guide the following documents are also relevant to the OEM manufac...

Page 4: ...ot be ruled out Therefore we cannot assume any guarantee or legal responsibility for erroneous information or liability of any kind You are hereby made aware that descriptions found in the user s manu...

Page 5: ...zation of the hardware and or software in connection with Flight control systems in aviation and aerospace Nuclear fusion processes in nuclear power plants Medical devices used for life support and Ve...

Page 6: ...ing conditions or is due to violations against our operating regulations or against rules of good electrical engineering practice or if our request to return the defective object is not promptly compl...

Page 7: ...fidential information to his own advantage or for his own purposes or rather to the advantage or for the purpose of a third party nor must it be used for commercial purposes and this confidential info...

Page 8: ...sks of the SoC DPM Parallel Dual Port Memory of the netX 90 host interface FDL Flash Device Label HW config Hardware configuration file ROM code Hard coded software residing in the Read only memory of...

Page 9: ...dustrial communication tasks as pre built and ready to use firmware Note that there are three different firmware use cases A Small footprint slave device B Small footprint slave device with firmware u...

Page 10: ...cess and use the flasher utility either via the netX Studio GUI recommended for software development or flashing of single prototypes or via command line interface recommended for end of line mass pro...

Page 11: ...sses this information during booting The user can define up to ten flash areas containing either a certain binary file like e g the firmware or dedicated space for storing non file based data see sub...

Page 12: ...ge of firmware update data Offsets and sizes of these areas are described in the Flash area definition values tables in the following sections Important If you are not programming a blank netX 90 devi...

Page 13: ...ernet protocol firmware including a basic web server protocol stack running in channel 0 and network services running in channel 1 of DPM Communication firmware size is 500 KByte and located only in I...

Page 14: ...RODUCT_DATA_FL ASH_LAYOUT_CONTENT_ TYPE_FWUPDATE Relative 0x0 0x5F000 0x1 FWUpdate O_RDWR Absolute 0x00180000 4 Maintenance hardware configuration mwc HIL_PRODUCT_DATA_FL ASH_LAYOUT_CONTENT_ TYPE_MFW_...

Page 15: ...e B applies to traditional Fieldbus protocol firmware protocol stack running in channel 0 of DPM and standard Real Time Ethernet protocol firmware including a basic web server protocol stack running i...

Page 16: ...the storage and management of remanent data Therefore the firmware file nxi must be configured accordingly by using the Tag List Editor software i e in the Remanent Data Responsibility tag the Remane...

Page 17: ...hardware configuration mwc HIL_PRODUCT_DATA_ FLASH_LAYOUT_CONT ENT_TYPE_MFW_HWCO NFIG Relative 0x5F000 0x2000 0x1 MFW_HWConfig O_RDONLY Absolute 0x001DF000 4 Maintenance Firmware mxf HIL_PRODUCT_DATA...

Page 18: ...ion firmware file size is limited to 880 KByte and located in INTFLASH01 Firmware update area is located in the HCC Flash File System of the external SQI Flash and does therefore not need to be define...

Page 19: ...mwc HIL_PRODUCT_DATA_F LASH_LAYOUT_CONTEN T_TYPE_MFW_HWCONFI G Relative 0x5F000 0x2000 0x1 MFW_HWConfig O_RDONLY Absolute 0x001DF000 4 Maintenance Firmware mxf HIL_PRODUCT_DATA_F LASH_LAYOUT_CONTEN T...

Page 20: ...e Label fdl page 23 Communication firmware nxi Pre built binary firmware file for the COM CPU containing protocol stack operating system web server and tag list Create Provided as ready to use binary...

Page 21: ...DT The GUI integrated Flasher tool of netX Studio CDT will automatically write the file to the right location within the flash memory of the device For more information about the Flasher tool please r...

Page 22: ...X Studio CDT but create your own FDL with your own tool instead you must define the flash area for this file by entering the following values in the Flash Layout Table of the FDL Content type in FDL H...

Page 23: ...ddresses serial number and production date in the Flash Device Label Editor of netX Studio CDT For more information on this please refer to the How to Use the Flash Device Label Editor section in the...

Page 24: ...lash area definition in the FDL yourself However if you are not using a pre configured FDL template or the New Flash Device Label wizard of netX Studio CDT but create your own FDL with your own tool i...

Page 25: ...NT8 12 Start label Fixed string to mark the beginning of the FDL a k a device production data ProductData 12 2 UINT16 Size of label Size of the complete Label including this Header and the Footer 14 2...

Page 26: ...ssification number device class 0x003C netX 90 COM CPU 0x0045 netX 90 COM CPU with SDRAM 20 4 UINT32 Device number The numbers for Manufacturer 1 255 Hilscher are managed by Hilscher Note Hilscher too...

Page 27: ...h fields of the FDL they should be positioned Offset Size bytes Data type Name Description comments values 48 6 UINT8 6 MAC address 1 1st MAC Address 54 2 UINT8 2 Reserved fields 1 2 bytes reserved fo...

Page 28: ...to 0 128 6 UINT8 6 MAC address 3 3rd MAC Address 134 2 UINT8 2 Reserved fields 3 2 bytes reserved for alignment set to 0 136 6 UINT8 6 MAC address 4 4th MAC Address 142 2 UINT8 2 Reserved fields 4 2 b...

Page 29: ...e parameters anyway but we still advise you to set this field to 0 in order to avoid conflicts with upcoming firmware versions that might be able to evaluate this section 260 4 28 CHAR 28 OEM serial n...

Page 30: ...HWCONFIG is always stored at the beginning of the flash device it shall be defined as Area 0 the FDL being always stored at second position shall be defined as Area 1 and so on Offset Size bytes Data...

Page 31: ...cont Application firmware extension nae Maintenance Maintenance firmware mfw Filesystem File system in external SQI flash FWUpdate Firmware update area MFW_HWConfig Hardware configuration of maintenan...

Page 32: ...TFLASH0 COM CPU 4096 INTFLASH1 COM CPU 4096 External SQI flash W25Q32V from Winbond Electronics 876 4 UINT32 Flash size Size of the flash chip device in bytes 0x80000 INTFLASH0 COM CPU 0x80000 INTFLAS...

Page 33: ...rate tool from Hilscher Flashing downloading The COM firmware can be flashed to the netX 90 by the Flasher tool of netX Studio CDT The GUI integrated Flasher tool of netX Studio CDT will automatically...

Page 34: ...ur own tool instead you must define the flash area for this file by entering the following values in the Flash Layout Table of the FDL Content type in FDL HIL_PRODUCT_DATA_FLASH_LAYOUT_CONTENT_TYPE_FW...

Page 35: ...to Use the Flasher tool section in the above mentioned Getting started document Important The netX Studio s GUI integrated Flasher tool checks the file name extension in order to decide where to flas...

Page 36: ...the Flash Layout Table of the FDL see section Firmware use cases page 13 to support additional downloads of configuration files use case C requires file system The maintenance firmware is started by...

Page 37: ...rage location and size of the maintenance firmware in the internal flash memory must be defined as an area in the Flash Layout Table of the Flash Device Label In use case A we recommend you to define...

Page 38: ...nt type HIL_PRODUCT_DATA_FLASH_LAYOUT_ CONTENT_TYPE_MFW 676 0x02A4 Area 5 start address 0x61000 680 0x02A8 Area 5 size Use cases A B 0x15000 Use case C 0x1F000 684 0x02AC Area 5 chip number 0x1 688 0x...

Page 39: ...shing downloading The HW config binary for maintenance firmware can be flashed to the netX 90 by the Flasher tool of netX Studio CDT The GUI integrated Flasher tool of netX Studio CDT will automatical...

Page 40: ...CT_DATA_FLASH_LAYOUT_CONTENT_TYPE_MFW_HWCONFIG Start address in flash device 0x5F000 relative address Size in flash 0x2000 Chip number flash device number 0x1 Name in FDL MFW_HWConfig Access type in f...

Page 41: ...tware architecture 41 70 See also FDL Content Flash Layout Table page 30 and section Flash layout page 11 netX 90 Production guide DOC190101PG03EN Revision 3 English 2019 07 Released Public Hilscher 2...

Page 42: ...hat enable the handling of firmware programming The ROM code enters console mode or alternative boot mode on the following conditions After a software reset cycle if the application has initiated the...

Page 43: ...ftware architecture 43 70 The following flow chart shows the boot sequence Figure 7 Boot mode flow chart netX 90 Production guide DOC190101PG03EN Revision 3 English 2019 07 Released Public Hilscher 20...

Page 44: ...he ROM code If an image for whatever reason is incomplete or defect the ROM code follows the sequence depicted in the Boot mode flow chart above If the device is blank MAC addresses derive from unique...

Page 45: ...rnal pull down Reserved 5 Reserved High by internal pull up Low by external pull down High by internal pull up 4 UART and 8 bit DPM High by internal pull up Low by external pull down Low by external p...

Page 46: ...enance firmware installs the firmware selected by the system integrator e g via a rotary DIP switch or by a parameter in the software reset command The alternative boot mode is entered on the followin...

Page 47: ...sher on PC laptop Note Not yet supported by the Flasher Using console mode and standard Ethernet page 49 ROM code in console mode via built in web server RJ45 port 0 or port 1 connected to PC laptop v...

Page 48: ...laptop netX Studio CDT integrated Flasher tool or Command line flasher Entering console mode In its initial blank state the netX 90 automatically supports firmware programming in console mode via UAR...

Page 49: ...sole mode via Standard Ethernet i e you do not need make any special configuration settings in order to enable this option This is because the netX automatically enters console mode if the ROM code ca...

Page 50: ...ndividual files to certain offsets in the flash Requirements Your netX 90 device is equipped with an Ethernet interface RJ45 jack The Ethernet interface is connected to your programming PC laptop via...

Page 51: ...ork in which a DHCP server is available Connect the netX device to the voltage supply If the flash is blank the ROM code automatically enters the default console mode thus enabling access via UART or...

Page 52: ...netX 90 device connected to your local network at the same time you can identify your currently connected device by clicking the Identify button The SYS LED if implemented on your device check this w...

Page 53: ...he flash Click Send the file button to start flashing the image After successful flashing the Upload finished page is displayed You have flashed a communication firmware image to the netX The firmware...

Page 54: ...o CDT integrated Flasher tool or Command line flasher Enabling disabling the debug interface Note Flashing files to the netX via JTAG does not require putting the ROM code into console mode The user c...

Page 55: ...terface you must first set the console mode interface according to your host interface type This interface type is determined by the configuration settings of the SQI_SIO0 SQI_SIO1 and SQI_SIO2 pins a...

Page 56: ...flash you can force the ROM code into console mode by pulling the RDY pin of the netX 90 to GND i e if the pin is accessible Consult the hardware documentation of your netX 90 device for information o...

Page 57: ...ript allows you to conveniently automate the end of line software flashing process The Command line flasher and the GUI integrated flasher both use the same drivers which are included in the netX Stud...

Page 58: ...a flash device flash Writes a specified file to the specified flash destination Must be followed by the following parameters optional parameters are indicated in curly brackets interface bus unit chi...

Page 59: ...in order to automate your production process Use the info command to display a list of interfaces values that the flasher can use see sub section Select and open interface below p romloader _uart_com...

Page 60: ...the specified flash destination Note The file must be available in the directory of the flasher tool otherwise you have to specify the path to the location of the file Example firmware nxi If used in...

Page 61: ...he available interface options are listed for selection The list should include the interface that you are currently connected with Figure 14 Interface options detected by the command line flasher Ent...

Page 62: ...s number from the list use the string between colon and brackets i e in this example use p romloader_jtag_netX90_COM NXHX_90 JTAG 7 1 Press Enter on your keyboard The flasher sets up the interface and...

Page 63: ...16 Example of entering flash parameters Note The file that you want to write to the flash must be stored in the directory of the flasher script otherwise you have to specify the path to the location...

Page 64: ...le you want to use the romloader_jtag_netX90_COM NXHX_90 JTAG 7 1 interface To start flashing enter the following command lua5 1 exe cli_flash lua flash p romloader_jtag_netX90_COM NXHX_90 JTAG 7 1 b...

Page 65: ...he interface you want to use then press Enter on your keyboard The flasher reads the indicated flash area and writes the contents to the specified output file on your PC laptop The end of the action i...

Page 66: ...nterface Enter the number of the interface you want to use then press Enter on your keyboard The flasher erases the indicated flash area The end of the action is indicated by the Area erased message n...

Page 67: ...ting For information about end of line production tests for netX 90 based devices please go to our netX 90 FAQ page https kb hilscher com x 5oCDB netX 90 Production guide DOC190101PG03EN Revision 3 En...

Page 68: ...igure 8 Pin configuration for operating modes 44 Figure 9 netX 90 ROM code in Windows Explorer 51 Figure 10 Start page of ROM code web server 52 Figure 11 Write page 53 Figure 12 Prompt in flasher scr...

Page 69: ...uct identification 28 Table 15 FDL Content OEM identification 29 Table 16 FDL Content Flash Layout Table 30 Table 17 FDL Content Flash Chip Table 32 Table 18 FDL Footer 32 Table 19 Flash area definiti...

Page 70: ...Phone 91 8888 750 777 E mail info hilscher in Italy Hilscher Italia S r l 20090 Vimodrone MI Phone 39 02 25007068 E mail info hilscher it Support Phone 39 02 25007068 E mail it support hilscher com Ja...

Reviews: