Artesyn MOTLoad User Manual

MOTLoad Firmware Package

User’s Manual

P/N: 6806800C24D
February 2015

©

Copyright 2015 Artesyn Embedded Technologies, Inc.

All rights reserved.

Trademarks

Artesyn Embedded Technologies, Artesyn and the Artesyn Embedded Technologies logo are trademarks and service marks of
Artesyn Embedded Technologies, Inc.© 2015 Artesyn Embedded Technologies, Inc. All other product or service names are the
property of their respective owners.

Intel® is a trademark or registered trademark of Intel Corporation or its subsidiaries in the United States and other countries.

Java™ and all other Java-based marks are trademarks or registered trademarks of Oracle America, Inc. in the U.S. and other countries.

Microsoft®, Windows® and Windows Me® are registered trademarks of Microsoft Corporation; and Windows XP™ is a trademark of
Microsoft Corporation.

PICMG®, CompactPCI®, AdvancedTCA™ and the PICMG, CompactPCI and AdvancedTCA logos are registered trademarks of the PCI
Industrial Computer Manufacturers Group.

UNIX® is a registered trademark of The Open Group in the United States and other countries.

Notice

While reasonable efforts have been made to assure the accuracy of this document, Artesyn assumes no liability resulting from any
omissions in this document, or from the use of the information obtained therein. Artesyn reserves the right to revise this document
and to make changes from time to time in the content hereof without obligation of Artesyn to notify any person of such revision or
changes.

Electronic versions of this material may be read online, downloaded for personal use, or referenced in another document as a URL to
an Artesyn website. The text itself may not be published commercially in print or electronic form, edited, translated, or otherwise
altered without the permission of Artesyn.

It is possible that this publication may contain reference to or information about Artesyn products (machines and programs),
programming, or services that are not available in your country. Such references or information must not be construed to mean that
Artesyn intends to announce such Artesyn products, programming, or services in your country.

Limited and Restricted Rights Legend

If the documentation contained herein is supplied, directly or indirectly, to the U.S. Government, the following notice shall apply
unless otherwise agreed to in writing by Artesyn.

Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subparagraph (b)(3) of the Rights in
Technical Data clause at DFARS 252.227-7013 (Nov. 1995) and of the Rights in Noncommercial Computer Software and
Documentation clause at DFARS 252.227-7014 (Jun. 1995).

Contact Address

Artesyn Embedded Technologies Artesyn Embedded Technologies
Marketing Communications Lilienthalstr. 17-19
2900 S. Diablo Way, Suite 190 85579 Neubiberg/Munich
Tempe, Arizona 85282 Germany

Contents

Contents

About this Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

1.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

1.1.1 MOTLoad Implementation and Memory Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

1.1.2 MOTLoad Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

1.1.3 MOTLoad Utility Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

1.1.4 MOTLoad Tests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

2 Using MOTLoad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

2.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

2.1.1 Command Line Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

2.1.2 Command Line Help. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

2.1.3 Command Line Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

2.1.4 Command History Buffer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

2.1.5 pseudo-Vi Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

2.1.6 Command Line Execution Modes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

2.1.7 Copying/Transferring MOTLoad Images. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

2.2 MOTLoad Command Description Page Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

2.3 User Download Buffer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

2.4 Standard Error Codes and Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

2.4.1 Error Message Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

2.4.2 IOCTL Codes (Block) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

2.4.3 Standard Error Codes (errno) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

3 MOTLoad Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

3.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

3.1.1 MOTLoad Command List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

3.1.2 as . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

3.1.3 bcb bch bcw . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

3.1.4 bdTempShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

3.1.5 bfb bfh bfw. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

3.1.6 blkCp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

3.1.7 blkFmt. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

MOTLoad Firmware Package User’s Manual (6806800C24D)

3

Contents

Contents

Contents

3.1.8 blkRd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

3.1.9 blkShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

3.1.10 blkVe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

3.1.11 blkWr. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

3.1.12 bmb bmh bmw . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

3.1.13 br . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

3.1.14 bsb bsh bsw . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

3.1.15 bvb bvh bvw. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

3.1.16 cdDir . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

3.1.17 cdGet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

3.1.18 clear. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

3.1.19 cm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

3.1.20 csb csh csw. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

3.1.21 csUserAltBoot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

3.1.22 devShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

3.1.23 diskBoot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

3.1.24 docBoot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

3.1.25 docProgram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

3.1.26 docRead . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

3.1.27 downLoad. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

3.1.28 ds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

3.1.29 echo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

3.1.30 elfLoader. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

3.1.31 errorDisplay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

3.1.32 eval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

3.1.33 execProgram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90

3.1.34 fatDir . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91

3.1.35 fatGet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93

3.1.36 fdShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95

3.1.37 flashLock. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

3.1.38 flashProgram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100

3.1.39 flashShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .103

3.1.40 flashUnlock. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104

3.1.41 gd. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107

3.1.42 gevDelete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .108

3.1.43 gevDump . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109

4

MOTLoad Firmware Package User’s Manual (6806800C24D)

Contents

3.1.44 gevEdit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

3.1.45 gevInit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .112

3.1.46 gevList. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113

3.1.47 gevShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .114

3.1.48 gn. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115

3.1.49 go. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116

3.1.50 gt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117

3.1.51 hbd. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118

3.1.52 hbx. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119

3.1.53 help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120

3.1.54 l2CacheShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .122

3.1.55 l3CacheShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .123

3.1.56 mdb mdh mdw . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124

3.1.57 memShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125

3.1.58 mmb mmh mmw . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126

3.1.59 mpuFork - Fork Idle MPU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128

3.1.60 mpuShow - Display MPU Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130

3.1.61 mpuStart - Start the Other MPU. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131

3.1.62 netBoot. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132

3.1.63 netShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135

3.1.64 netShut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137

3.1.65 netStats. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138

3.1.66 noCm. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140

3.1.67 pciDataRd. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141

3.1.68 pciDataWr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142

3.1.69 pciDump. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143

3.1.70 pciShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144

3.1.71 pciSpace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146

3.1.72 ping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148

3.1.73 portSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .150

3.1.74 portShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .152

3.1.75 rd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153

3.1.76 reset. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154

3.1.77 rs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155

3.1.78 set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156

3.1.79 sromRead . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158

MOTLoad Firmware Package User’s Manual (6806800C24D)

5

Contents

Contents

Contents

3.1.80 sromWrite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160

3.1.81 sta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162

3.1.82 stl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164

3.1.83 stop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166

3.1.84 taskActive. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167

3.1.85 tc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169

3.1.86 td . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170

3.1.87 testDisk. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171

3.1.88 testDocHwInt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173

3.1.89 testEnetPtP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174

3.1.90 testNvramRd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175

3.1.91 testNvramRdWr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176

3.1.92 testRam . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177

3.1.93 testRamAddr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179

3.1.94 testRamAlt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181

3.1.95 testRamBitToggle. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182

3.1.96 testRamBounce. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184

3.1.97 testRamCodeCopy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185

3.1.98 testRamEccMonitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186

3.1.99 testRamMarch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .187

3.1.100testRamPatterns. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188

3.1.101testRamPerm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189

3.1.102testRamQuick . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190

3.1.103testRamRandom. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191

3.1.104testRtcAlarm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192

3.1.105testRtcReset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193

3.1.106testRtcRollOver. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194

3.1.107testRtcTick. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195

3.1.108testSerialExtLoop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196

3.1.109testSerialIntLoop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197

3.1.110testStatus. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198

3.1.111testSuite. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200

3.1.112testSuiteMake . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .203

3.1.113testThermoOp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205

3.1.114testThermoQ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206

3.1.115testThermoRange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207

6

MOTLoad Firmware Package User’s Manual (6806800C24D)

Contents

3.1.116testWatchdogTimer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208

3.1.117tftpGet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209

3.1.118tftpPut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212

3.1.119time. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215

3.1.120transparentMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217

3.1.121tsShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .219

3.1.122upLoad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220

3.1.123version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222

3.1.124vmeCfg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223

3.1.125vpdDisplay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225

3.1.126vpdEdit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227

3.1.127wait . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229

3.1.128waitProbe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230

A MOTLoad Non-Volatile Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231

A.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231

A.2 Vital Product Data (VPD) Use . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .231

A.2.1 Purpose. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231

A.2.2 How to Read VPD Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232

A.2.3 How to Archive VPD Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233

A.2.4 Restoring the Archive. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233

A.2.5 Editing VPD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234

A.3 Global Environment Variables (GEVs) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235

A.3.1 Initializing the GEV Storage Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235

A.3.2 Reserved GEVs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236

A.3.2.1 Startup GEVs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236

A.3.2.2 Network GEVs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238

A.3.2.3 Console Configuration GEV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239

A.3.2.4 Disk Boot Option GEV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239

A.3.2.5 Boot Results GEV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239

A.3.2.6 IDE GEV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240

A.3.2.7 SCSI GEV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .241

A.3.2.8 Test Suite GEVs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241

A.3.2.9 Creating a Configurable POST (Power On Self Test) . . . . . . . . . . . . . . . . . . . . 242

A.3.2.10 Other GEVs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242

MOTLoad Firmware Package User’s Manual (6806800C24D)

7

Contents

Contents

Contents

A.3.3 Viewing GEV Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243

A.3.4 Viewing GEV Labels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243

A.3.5 Creating GEVs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244

A.3.6 Editing GEVs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245

A.3.7 Deleting GEVs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245

B Remote Start. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247

B.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247

B.2 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247

B.2.1 Inter-Board Communication Address Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248

B.2.2 Opcode 0x01: Write/Read Virtual Register . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250

B.2.3 Opcode 0x02: Initialize Memory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251

B.2.4 Opcode 0x03: Write/Read Memory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251

B.2.5 Opcode 0x04: Checksum Memory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252

B.2.6 Opcode 0x05: Memory Size Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252

B.2.7 Opcode 0x06: Firmware/Payload Query. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253

B.2.8 Opcode 0x07: Execute Code. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255

B.2.9 Opcode 0x08: Allocate Memory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255

B.2.10 Remote Start Error Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256

B.2.11 VME Remote Start. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256

B.2.12 CompactPCI Remote Start . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257

B.2.13 Demonstration of the Host Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258

B.2.14 Reference C Function: rsCrc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .261

C VME Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263

C.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263

C.2 CR/CSR Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263

C.3 Displaying VME Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263

C.4 Editing VME Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264

C.5 Deleting VME Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .265

C.6 Restoring Default VME Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265

8

MOTLoad Firmware Package User’s Manual (6806800C24D)

Contents

D Auto Boot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267

D.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267

D.2 Auto Boot From a Disk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268

D.3 Auto Boot From the Network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269

E Safe Start and Alternate Boot Image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271

E.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271

E.2 Safe Start . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271

E.3 Alternate Boot Images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272

E.4 Firmware Startup Sequence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272

E.5 Firmware Scan for Boot Image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273

E.6 Valid Boot Images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274

E.6.1 Checksum Algorithm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275

E.6.2 Boot Image Flags. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275

E.6.3 Board State Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277

E.6.4 Alternate Boot Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278

F Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279

F.1 Artesyn Embedded Technologies - Embedded Computing Documentation . . . . . . . . . . . . . . .279

F.2 Related Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279

MOTLoad Firmware Package User’s Manual (6806800C24D)

9

Contents

Contents

Contents

10

MOTLoad Firmware Package User’s Manual (6806800C24D)

List of Tables

Table 3-1 MOTLoad Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Table B-1 Command/Response Error Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256

Table E-1 MOTLoad Image Flags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275

Table F-1 Related Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .279

MOTLoad Firmware Package User’s Manual (6806800C24D)

11

List of Tables

12

MOTLoad Firmware Package User’s Manual (6806800C24D)

About this Manual

Overview of Contents

The MOTLoad Firmware Package User’s Manual provides information on the MOTLoad
firmware. It is intended to be used in conjunction with a specific Artesyn board level product,
on which this firmware resides, such as the MVME5500, MVME3100, MVME6100, MVME7100,
ATCA-F102, and ATCA-C110. This manual provides general information on how to use the
firmware, as well as a detailed description of each command. It also provides information on
special features provided by MOTLoad (see Appendices).

This manual is divided into the following chapters and appendices.

 Chapter 1, Introduction, includes an overview of the MOTLoad firmware, a brief description

of the firmware’s implementation and memory requirements, command types, utility
applications and tests

 Chapter 2, Using MOTLoad, provides instructions on how to interact with the firmware

including a description of the command line interface, encompassing command line help
and command line rules; command history buffer, encompassing pseudo-VI Mode;
command line execution modes and MOTLoad manual page formats.

 Chapter 3, MOTLoad Commands, provides a list of all current MOTLoad commands followed

by a detailed description of each command.

 Appendix A, MOTLoad Non-Volatile Data, provides a description of the various types of non-

volatile data: VPD, GEV and SPD. Explanations and examples of existing VPD and GEV
commands are also provided. SPD is not covered at this time.

 Appendix B, Remote Start, describes the remote interface provided by MOTLoad to the host

CPU via the backplane bus, which allows the host to obtain information about the target
board, download code and/or data, modify memory, and execute a downloaded program.

 Appendix C, VME Configuration Parameters, describes how to manage VME configuration

parameters for VME-based products.

 Appendix D, Auto Boot, provides information on how to auto boot an operating system

where no console is required.

 Appendix E, Safe Start and Alternate Boot Image, describes MOTLoad’s Safe Start

mechanism and Alternate Boot Image support that enable customers to recover from
inadvertent board configurations.

 Appendix F, Related Documentation, lists various documents related to specific devices and

industry specifications that are used in conjunction with the MOTLoad product.

MOTLoad Firmware Package User’s Manual (6806800C24D)

13

About this Manual

Abbreviations

This document uses the following abbreviations:

Abbreviation Definition

BOOTP Bootstrap Protocol

DHCP Dynamic Host Configuration Protocol

GEV Global Environment Variable

IBCA Inter-Board Communication Address

NVRAM Non-Volatile Random Access Memory

PCI Peripheral Component Interconnect

POST Power -On Self Test

RTC Real-Time Clock

SBC Single Board Computer

About this Manual

SDRAM Synchronous Dynamic Random Access Memory

SPD Serial Presence Defect

VME VMEbus (Versa Module Euro Card)

VPD Vital Product Data

Conventions

The following table describes the conventions used throughout this manual.

Notation Description

0x00000000 Typical notation for hexadecimal numbers (digits are

0b0000 Same for binary numbers (digits are 0 and 1)

bold Used to emphasize a word
Screen Used for on-screen output and code related elements

14

0 through F), for example used for addresses and
offsets

or commands in body text

MOTLoad Firmware Package User’s Manual (6806800C24D)

About this Manual

Notation Description
Courier + Bold Used to characterize user input and to separate it

from system output

Reference Used for references and for table and figure

descriptions

File > Exit Notation for selecting a submenu

<text> Notation for variables and keys

[text] Notation for software buttons to click on the screen

and parameter description

... Repeated item for example node 1, node 2, ..., node

12

.

.

.

.. Ranges, for example: 0..4 means one of the integers

| Logical OR.

Omission of information from example/command
that is not necessary at the time being.

0,1,2,3, and 4 (used in registers).

Indicates a hazardous situation which, if not avoided,
could result in death or serious injury.

Indicates a hazardous situation which, if not avoided,
may result in minor or moderate injury

Indicates a property damage message.

No danger encountered. Pay attention to important
information.

MOTLoad Firmware Package User’s Manual (6806800C24D)

15

About this Manual

Summary of Changes

This manual has been revised and replaces all prior editions.

Date Change

February 2015 Re-branded to Artesyn template.

March 2009 The following command was added to Chapter 3: csUserAltBoot

April 2008 These commands were added to Chapter 3: wait and waitProbe.

March 2008 The following commands were added to Chapter 3: mpuFork, mpuShow,

mpuStart, wait. New GEV descriptions added to Appendix A, MOTLoad Non­Volatile Data.

Update to Emerson style.

June 2007 Added

-n

option to the netBoot command. Added Network I/O error codes to tftpGet,

tftpPut, netBoot, and ping commands.

About this Manual

16

June 2006 Added new commands in support of the ATCA-C110 blade: docBoot,

docProgram, docRead, and testDocHwInt,

April 2006  The

-r

option of the testSuite command was updated

 Two commands were added to Chapter 3: flashLock and flashUnlock.

 diskBoot command was updated.

 New appendices added: Appendix C, VME Configuration Parameters and

Appendix E, Safe Start and Alternate Boot Image.

MOTLoad Firmware Package User’s Manual (6806800C24D)

About this Manual

Date Change

June 2004  A Standard Error Codes and Devices section was added to Chapter 2.

 The following tests and commands were added to Chapter 3:

testThermoOp, testThermoQ, testThermoRange, csb csh csw and devShow.

 A note was added to all memory tests, for example, testRam, specifying

how the memory is tested.

 An error message field was added to applicable MOTLoad commands in

Chapter 3, MOTLoad Commands.

 A warning was added to testDisk about being destructive.

 The following commands were deleted from Chapter 3: mpuFork,

mpuShow, mpuSwitch, testFlash, testI2cRomRd, testI2cRomRdWr,
testUsbOscillator, and testUsbVok.

 A Reserved GEVs section was added to Appendix A.

 Auto boot instructions were added as an appendix, Appendix D, Auto Boot

July 2003 The MOTLoad prompt throughout this document was changed to a generic

MOTLoad> from a specific product prompt, which will vary depending upon
which product was purchased.

Some command descriptions were modified and added to Chapter 3, as well
as corrections to font and text throughout to reflect more accurately screen
displays.

MOTLoad Firmware Package User’s Manual (6806800C24D)

17

About this Manual

About this Manual

18

MOTLoad Firmware Package User’s Manual (6806800C24D)

Introduction

1.1 Overview

MOTLoad is a PowerPC firmware package developed for Artesyn’s Single Board Computers
(SBCs). The first boards using MOTLoad employ a Marvell GT64260A bridge. Subsequent
products will use MOTLoad in conjunction with the most recent industry designed bridge
devices. MOTLoad is continuously being developed and extended to support newly developed
Artesyn products. When new features are added and changes are made, this document will be
updated.

The main purpose of the MOTLoad firmware package is to serve as a board power-up and
initialization package, and to serve as a vehicle from which user applications can be booted.
Although MOTLoad was not specifically designed as a diagnostics application, the test suites
and the individual tests (with their various options) provide the user with a significant amount
of information that can be used for debug and diagnostic purposes. To use the MOTLoad
firmware package successfully, the reader should have some familiarity with the product and
firmware methodology.

Chapter 1

MOTLoad is controlled through an easy to use, UNIX-like, command line interface. Its format
was designed with the application-oriented needs of the end user in mind. Consequently, the
MOTLoad software package is similar to that of many end-user applications designed for the
embedded market, such as the currently available real-time operating systems. Functionally,
this design allows MOTLoad to detect typical system level product devices.

1.1.1 MOTLoad Implementation and Memory Requirements

The implementation of MOTLoad and its memory requirements are product specific. Each of
the Artesyn SBCs are offered with a wide range of memory (for example, DRAM, external
cache, and flash). Typically, the smallest amount of onboard DRAM that an SBC has is 32 MB.
Each supported Artesyn product line has its own unique MOTLoad binary image(s). Currently
the largest MOTLoad compressed image is less than 1 MB. During board initialization, the
MOTLoad image is decompressed into DRAM, where it executes. A MOTLoad decompressed
image can be as large as 2.5 MB.

1.1.2 MOTLoad Commands

MOTLoad supports two groups of commands (applications): utilities and tests. Both types of
commands are invoked from the MOTLoad command line in a similar fashion. Beyond that,
MOTLoad utilities and MOTLoad tests are distinctly different.

MOTLoad Firmware Package User’s Manual (6806800C24D)

19

Introduction

1.1.3 MOTLoad Utility Applications

The definition of a MOTLoad utility application is very broad. Simply stated, it is a MOTLoad
command that is not a MOTLoad test. Typically, MOTLoad utility applications are applications
that aid the user in some way. From the perspective of MOTLoad, examples of utility
applications are: configuration, data/status displays, data manipulation, help routines,
data/status monitors, and so on.

Operationally, MOTLoad utility applications differ from MOTLoad test applications in several
ways:

 Only one utility application may be operating at any given time (that is, multiple utility

applications can not be executing concurrently).

 Utility applications may interact with the user. Most test applications do not.

1.1.4 MOTLoad Tests

A MOTLoad test application determines whether or not the hardware meets a given standard.
Test applications are validation tests. Validation is conformance to a specification. Most
MOTLoad tests are designed to directly validate the functionality of a specific SBC subsystem
or component. It is possible for a board's component to fail in the user application but pass
specification conformance. These tests validate the operation of such SBC modules as:
dynamic memory, external cache, NVRAM, real time clock, and so on.

All MOTLoad tests are designed to validate functionality with minimum user interaction. Once
launched, most MOTLoad tests operate automatically without any user interaction. There are
a few tests where the functionality being validated requires user interaction (that is, switch
tests, interactive plug-in hardware modules, and so on). Most MOTLoad test results (error­data/status-data) are logged, not printed. Test results are not preserved and therefore not
available to user applications subsequent to their execution. All MOTLoad tests/commands are
described in detail in Chapter 3, MOTLoad Commands.

All devices that are available to MOTLoad for validation/verification testing are represented by
a unique device path string. Most MOTLoad tests require the operator to specify a test device
at the MOTLoad command line when invoking the test.

20

MOTLoad Firmware Package User’s Manual (6806800C24D)

Introduction

A listing of all device path strings can be displayed through the devShow command. If a SBC
device does not have a device path string it is not supported by MOTLoad and can not be
directly tested. There are a few exceptions to the device path string requirement, like testing
RAM, which is not considered a true device and can be directly tested without a device path
string. Refer to the devShow command page in this manual for more information.

Most MOTLoad tests can be organized to execute as a group of related tests (a test suite)
through the use of the testSuite command. The expert operator can customize their
testing by defining and creating a custom test suite(s). The list of built-in and user defined
MOTLoad test suites, and their test contents, can be obtained by entering: testSuite –d at
the MOTLoad prompt. All test suites that are included as part of a product specific MOTLoad
firmware package are product specific. For more information refer to the testSuite
command page in this manual.

Test results and test status are obtained through the testStatus, errorDisplay, and
taskActive commands. Refer to the appropriate command page(s) in this manual for more
information.

MOTLoad Firmware Package User’s Manual (6806800C24D)

21

Introduction

22

MOTLoad Firmware Package User’s Manual (6806800C24D)

Using MOTLoad

2.1 Overview

This chapter describes various command line characteristics, as well as the MOTLoad Manual
Page Format.

Interaction with MOTLoad is performed via a command line interface through a serial port on
the SBC, which is connected to a terminal or terminal emulator (for example, Window’s
Hypercomm). The default MOTLoad serial port settings are: 9600 baud, 8 bits, no parity.

2.1.1 Command Line Interface

The MOTLoad command line interface is similar to a UNIX command line shell interface.
Commands are initiated by entering a valid MOTLoad command (a text string) at the MOTLoad
command line prompt and pressing the carriage-return key to signify the end of input.
MOTLoad then performs the specified action. The MOTLoad command line prompt is shown
below.

Chapter 2

Note: The generic command prompt designation of MOTLoad is for documentation purposes
only. The exact command prompt designation is determined by the product being purchased,
for example, MVME6100, MVME5500, and so on.

If an invalid MOTLoad command is entered at the MOTLoad command line prompt, MOTLoad
displays a message that the command was not found.

Example:

MOTLoad>

mytest

"mytest" not found
MOTLoad>

If the user enters a partial MOTLoad command string that can be resolved to a unique valid
MOTLoad command and presses the carriage-return key, the command will be executed as if
the entire command string had been entered. This feature is a user input shortcut that
minimizes the required amount of command line input. MOTLoad is an ever changing firmware
package, so user input shortcuts may change as command additions are made.

MOTLoad>

MOTLoad Firmware Package User’s Manual (6806800C24D)

23

Using MOTLoad

Example:

MOTLoad>

version

Copyright: Motorola Inc. 1999-2003, All Rights Reserved
MOTLoad RTOS Version 2.0
PAL Version 1.1 RM01
Mon Mar 10 12:01:28 MST 2003

Example:

MOTLoad>

ver

Copyright: Motorola Inc. 1999-2003, All Rights Reserved
MOTLoad RTOS Version 2.0
PAL Version 1.1 RM01
Mon Mar 10 12:01:28 MST 2003

If the partial command string cannot be resolved to a single unique command, MOTLoad will
inform the user that the command was ambiguous.

Example:

MOTLoad>

te

"te" ambiguous
MOTLoad>

2.1.2 Command Line Help

Each MOTLoad firmware package has an extensive, product specific, help facility that can be
accessed through the help command. The user can enter help at the MOTLoad command line
to display a complete listing of all available tests and utilities.

Example:

MOTLoad>

24

MOTLoad Firmware Package User’s Manual (6806800C24D)

help

For help with a specific test or utility, the user can enter:

help

<command_name> at the MOTLoad prompt. The

help

command also supports a limited form of pattern matching. Refer to the

help

command page.

Example:

MOTLoad>

Using MOTLoad

help testRam

Usage: testRam [-aPh] [-bPh] [-iPd] [-nPh] [-tPd] [-v]
Description: RAM Test Directory
Argument/Option Description

-a Ph: Address to Start (Default = Dynamic Allocation)

-b Ph: Block Size (Default = 16 MB)

-i Pd: Iterations (Default = 1)

-n Ph: Number of Bytes (Default = 1 MB)

-t Ph: Time Delay Between Blocks in OS Ticks (Default = 1)

-v 0: Verbose Output
MOTLoad>

2.1.3 Command Line Rules

There are a few things to remember when entering a MOTLoad command:

 Multiple commands are permitted on a single command line, provided they are separated

by a single semicolon(";").

 Spaces separate the various fields on the command line (command/arguments/options).

 The argument/option identifier character is always preceded by a hyphen (“-”) character

MOTLoad Firmware Package User’s Manual (6806800C24D)

25

Using MOTLoad

 Options are identified by a single character

 Option arguments immediately follow (no spaces) the option

 All commands, command options, device tree strings, and so on are case sensitive

Example:

MOTLoad> flashProgram –d/dev/flash0 –n00100000

2.1.4 Command History Buffer

MOTLoad saves command line inputs into a command history buffer. Up to 128 previously
entered commands can be recalled, edited, and reentered at the command line. Once the
desired command appears on the command line it can be re-executed by pressing the
carriage-return key.

2.1.5 pseudo-Vi Mode

MOTLoad supports a pseudo-VI editor command recall through the ESC and the j and k keys.
Ty pi ng

ESC

and then

k

moves backwards through the history command buffer and displays the preceding
commands. Typing

ESC

and then

j

moves forward through the history command buffer and displays the more recent commands.
After the

ESC

26

MOTLoad Firmware Package User’s Manual (6806800C24D)

key is pressed, the

j

and/or

k

key may be pressed as often as needed to bring up the desired command from the command
history buffer.

2.1.6 Command Line Execution Modes

MOTLoad utilities such as help always execute in the foreground. MOTLoad tests can be
executed in the foreground (sequentially) or in the background (concurrently) as background
tasks.

Using MOTLoad

Note Not all tests can execute in background mode. As an example, cache tests must run in
the foreground.

When a sequential test starts executing in the foreground, no new MOTLoad tests can execute
until the current test running in the foreground is complete. This does not apply to background
tests.

Example:

MOTLoad>

testRam

In concurrent test mode, each test gets a time sliced share of the CPU execution time. The
amount of user control over the background task time slicing operations is determined by the
underlying OS. The operator specifies concurrent test execution by ending the test command
line with the ampersand (&) character (prior to the carriage-return). The MOTLoad command
prompt reappears after a concurrent test is started.

Example:

MOTLoad>

testRam &

MOTLoad Firmware Package User’s Manual (6806800C24D)

27

Using MOTLoad

After the MOTLoad prompt reappears, another test or utility may be started (in the foreground
or background execution mode) as long as it does not interfere (use the same computer
resources) with the operations of other test(s) running in background mode. The test
execution status of a test(s) running in background mode can be monitored through the use
of the taskActive and testStatus commands. Refer to the appropriate man pages for
more details.

2.1.7 Copying/Transferring MOTLoad Images

Flash images can be copied between memory and flash, or between flash banks, by the use of
the flashProgram utility. Extreme care should be taken in this process to ensure that
accidental overwriting of the bootloader code and/or MOTLoad does not occur. It is advised
that you never program the boot block of the active flash bank (the one from which the board
was booted). This ensures that the bootloader image is never overwritten by flashProgram.

The bootloader resides in the boot block of each flash bank. If both images have been
overwritten, the board may be unbootable. Further, since flashProgram is a component
within MOTLoad, the user is not able to reprogram (reflash) the boot block to effect recovery.

28

The utility flashShow indicates which flash bank is the active flash bank and provides its base
address and size. Also refer to the Programmer’s Reference Guide and/or Installation and Use
manual for your board.

The boot block is the last (highest address) 1 MB of a flash bank. flashProgram writes to an
offset from the base (lowest address) of a flash bank. The source for the image being
programmed can be any addressable memory; for example, SDRAM, NVRAM, or flash.

MOTLoad Firmware Package User’s Manual (6806800C24D)

Using MOTLoad

2.2 MOTLoad Command Description Page Format

All MOTLoad command pages follow the format described below.

Name

This field names the test or utility as it would appear on the MOTLoad command line. It also
provides a description of the command, for example:

errorDisplay - displays the Contents of the MOTLoad Test Error Status Table

Synopsis

This field shows command line usage or syntax of a command, test, or utility. This consists
of the name of the command, test or utility, and a list of all possible arguments/options, for
example:

errorDisplay [-eP*] [-nP*] [-sP*]

If an argument is optional, it is enclosed in a set of braces [ ], otherwise it is required.

If an asterisk (*) or other symbol follows an option, another argument is required with that
option.

The asterisk (*) symbol means that a number of valid numeric base conversion option
arguments are possible. Refer to the table titled Number Base Specifiers for more
information.

An attempt has been made to standardize the meaning of option arguments but the exact
meaning of an option and its arguments is test specific. Exact option information can be
displayed through the use of the help command or by referring the appropriate man page.

Parameter

This field describes each argument and option of the command, for example:

MOTLoad Firmware Package User’s Manual (6806800C24D)

29

Using MOTLoad

-a P*: Executive Process/Task Identifier of Entry to Display

-n P*: Number of Entries to Display

-s P*: Specific Entry Number (1 to n) to Display

Example

This field shows how the command, test, or utility is typically used. The command line
invocation of the command, test, or utility and the subsequent displayed results are
shown. In some cases extensive examples are provided, for example:

MOTLoad> errorDisplay

tName =testDisk -d/dev/ide0/hdisk2 -n5000
sPID=00000011 ePID=00000014 eS.eM = 2.1 entryNo = 00000001
sErrNo=00000000 eErrNo=0C0000002C errCnt=00000001 loopCnt-00000000
sTime=43:48:15 fTime=43:48:15 eTime=00:00:00 1Time=15:51:54
Error Messages:
Data Comparison Failure in Block Range 0-255
Write/Read Date: 05F0436F/00000000
Write/Read Address: 008E1000/00*C0000
Device-Name =/dev/ide0/hdisk2

30

Error Messages

This field shows the known error messages output by MOTLoad. This field is only
applicable to commands, not tests.

Assembler Error:error code = <value>
Error code not in table

See Also

This field lists tests/utilities that are functionally related to the described command, for
example: clear, testStatus

MOTLoad Firmware Package User’s Manual (6806800C24D)