srec_cat - En ligne dans le Cloud

PROGRAMME:

Nom

srec_cat - manipule les fichiers de chargement d'EPROM

SYNOPSIS

srec_cat [ option...] nom de fichier...
srec_cat -Aidez-moi
srec_cat -Version

DESCRIPTION

Le srec_cat programme est utilisé pour assembler les fichiers d'entrée donnés en un seul fichier de sortie.
L'utilisation de filtres (voir ci-dessous) permet d'effectuer des manipulations importantes par ce
commander.

Date Order
Les données des fichiers d'entrée ne sont pas immédiatement écrites dans la sortie, mais sont stockées dans
mémoire jusqu'à ce que l'image EPROM complète ait été assemblée. Les données sont ensuite écrites dans le
fichier de sortie dans l'ordre croissant des adresses. L'ordre d'origine des données (dans ces
formats capables d'ordonner les enregistrements aléatoires) est pas conservé.

Date Comparaison
Étant donné que l'ordre des enregistrements d'entrée n'est pas préservé, la comparaison textuelle des entrées et des sorties (comme
car diff(1) ou tkdiff(1) commandes) peuvent être trompeuses. Non seulement les lignes peuvent apparaître dans
des ordres d'adresses différents, mais les longueurs de ligne et la terminaison de ligne peuvent également différer. Utilisation
le srec_cmp(1) programme pour comparer deux fichiers de chargement EPROM. Si une comparaison de texte est
essentiel, exécutez les deux fichiers via le srec_cat(1) programme pour s'assurer que les deux fichiers soient
comparés ont un ordre d'enregistrement et des longueurs de ligne identiques.

Date Conflits
Le stockage des données en mémoire permet de détecter les conflits de données, généralement causés par
les sections de l'éditeur de liens se chevauchent involontairement.

· Un avertissement sera émis pour chaque adresse définie de manière redondante sur la même valeur.

· Une erreur fatale sera émise si une adresse est définie avec des valeurs contradictoires. Éviter
cette erreur utilise un -exclure -dans filtre (voir entrée_srec(1)) ou, pour en faire un avertissement,
utiliser le -plusieurs option (voir ci-dessous).

· Un avertissement sera émis pour les fichiers d'entrée où les enregistrements de données ne sont pas strictement
ordre croissant des adresses. Pour supprimer cet avertissement, utilisez le -désactiver l'avertissement de séquence
option (voir ci-dessous).

Ces fonctionnalités sont conçues pour détecter les problèmes difficiles à déboguer et détectent
le point de vue de avant les données sont écrites sur une EPROM et exécutées dans votre système embarqué.

CONTRIBUTION DOSSIER DONNÉES TECHNIQUES

L'entrée peut être qualifiée de deux manières : vous pouvez spécifier un fichier de données ou un générateur de données.
format et vous pouvez spécifier des filtres à leur appliquer. Une spécification de fichier d'entrée ressemble
comme ça:
fichier de données [ une fonction filtre ...]
générateur de données [ une fonction filtre ...]

Date Documents officiels
L'entrée des fichiers de données est spécifiée par le nom du fichier et le nom du format. Un fichier d'entrée
spécification ressemble à ceci:
nom de fichier [ le format ][ -ignore-checksums ]
Le format par défaut est le format Motorola S‐Record, mais de nombreuses d'autres sont également compris.

Date Générateurs
Il est également possible de générer des données, plutôt que de les lire à partir d'un fichier. Vous pouvez utiliser un
générateur partout où vous pourriez utiliser un fichier. Une spécification de générateur d'entrée ressemble à
ce:
-Produire plage d'adresses -la source de données
Les générateurs incluent des données aléatoires et diverses formes de données constantes.

Commun Manuel (Le français commence à la page neuf) Page
See entrée_srec(1) pour plus de détails sur les spécificateurs d'entrée. Cette description est dans un
page de manuel distincte car elle est commune à plusieurs commandes SRecord.

OPTIONS

Les options suivantes sont comprises :

@nom de fichier
Le fichier texte nommé est lu pour des arguments de ligne de commande supplémentaires. Les arguments sont
séparés par un espace blanc (espace, tabulation, saut de ligne, etc). Il n'y a pas de caractère générique
mécanisme. Il n'y a pas de mécanisme de cotation. Commentaires, qui commencent par '#' et
s'étendent jusqu'à la fin de la ligne, sont ignorés. Les lignes vides sont ignorées.

-Production nom de fichier [ le format ]
Cette option peut être utilisée pour spécifier le fichier de sortie à utiliser. Le dossier spécial
nom « -[rq] signifie la sortie standard. La sortie par défaut est la
sortie standard si cette option n'est pas utilisée.

Le le format peut être spécifié comme :

-Absolute_Object_Module_Format
Un fichier Intel Absolute Object Module Format sera écrit. (Voir
srec_aomf(5) pour une description de ce format de fichier.)

-Ascii_Hex
Un fichier Ascii-Hex sera écrit. (Voir srec_ascii_hex(5) pour un
description de ce format de fichier.)

-ASM [ préfixe ][-option...]
Une série d'instructions de base de données assembleur sera écrite.

Le facultatif préfixe peut être spécifié pour changer les noms des symboles
généré. Les valeurs par défaut sont "eprom" si elles ne sont pas définies.

Plusieurs options sont disponibles pour modifier le style de sortie :

-Point_STyle
Utilisez des pseudo-ops de style "point" au lieu de mots. Par exemple .byte
au lieu de la valeur par défaut de la base de données.

-HEXadécimal_STyle
Utilisez des nombres hexadécimaux dans la sortie, plutôt que la valeur par défaut
Nombres décimaux.

-Style_Section
Par défaut, l'assemblage généré est placé à la bonne adresse
en utilisant les pseudo-ops ORG. La sortie de style de section émet des tableaux de
les adresses et les longueurs des sections, de sorte que les données peuvent être liées à
Durée.

-A430 Générer une sortie conforme au compilateur a430.exe car il
est utilisé, par exemple dans IAR Embedded Workbench. C'est un raccourci pour
-style de section -style hexadécimal

-CL430 Générer une sortie conforme à Code Composer Essentials, à
le compilateur de celui-ci. C'est un raccourci pour -section-style -hex-
style -style point

-Output_Word
Générer une sortie en mots de deux octets plutôt qu'en octets.
Cela suppose des mots little-endian ; vous devrez utiliser le -Byte‐
Filtre d'échange si votre cible est big-endian. Aucune tentative n'est faite pour
aligner les mots sur des limites d'adresses égales ; filtre d'utilisation et d'entrée
tel que
fichier d'entrée -remplir 0xFF -à l'intérieur fichier d'entrée
-gamme‐pad 2
pour remplir d'abord les données avec des mots entiers.

-Atmel_Générique
Un fichier Atmel Generic sera écrit. (Voir srec_atmel_generic(5) pour un
description de ce format de fichier.)

-De base Une série d'instructions BASIC DATA sera écrite.

-B-Enregistrement
Un fichier au format Freescale MC68EZ328 Dragonball bootstrap b‐record sera
écrit. (Voir srec_brecord(5) pour une description de ce format de fichier.)

-Binaire Un fichier binaire brut sera écrit. Si vous obtenez des résultats inattendus veuillez cliquer
voir la srec_binaire(5) manuel pour plus d'informations.

-C-Array [ identifiant ][-option...]
La définition du réseau AC sera écrite.

Le facultatif identifiant est le nom de la variable à définir, ou
bugus si non spécifié.

-Comprendre
Cette option demande également qu'un fichier d'inclusion soit généré.

-Pas de CONST
Cette option demande aux variables de ne pas utiliser le mot-clé const
(elles sont déclarées constantes par défaut, de sorte qu'elles sont placées
dans le segment en lecture seule dans les systèmes embarqués).

-C_COMpressé
Ces options demandent un c‐array compressé dont les trous de mémoire
pas être rempli.

-Output_Word
Cette option demande une sortie en mots et non en octets.
Il s'agit d'un petit endian, vous devrez peut-être

-COsmac Un fichier au format RCA Cosmac Elf sera écrit. (Voir srec_cosmac(5) pour un
description de ce format de fichier.)

-Déc_Binaire
Un fichier au format DEC Binary (XXDP) sera écrit. (Voir srec_dec_binary(5)
pour une description de ce format de fichier.)

-Elektor_Monitor52
Cette option indique d'utiliser le fichier au format EMON52 lors de l'écriture du fichier.
(Voir srec_emon52(5) pour une description de ce format de fichier.)

-FAIrenfant
Cette option indique d'utiliser le fichier au format Fairchild Fairbug lors de l'écriture du
déposer. (Voir srec_fairchild(5) pour une description de ce format de fichier.)

-Charge_rapide
Cette option indique d'utiliser le fichier au format LSI Logic Fast Load lors de l'écriture
le fichier. (Voir srec_fastload(5) pour une description de ce format de fichier.)

-Formatted_Binary
Un fichier au format binaire formaté sera écrit. (Voir
srec_formatted_binary(5) pour une description de ce format de fichier.)

-FORT [ -option ]
Un fichier d'entrée FORTH sera écrit. Chaque ligne de sortie comprend un octet
valeur, une adresse et une commande.

-RAM La commande de magasin est C ! C'est la valeur par défaut.

-EEPROM La commande de magasin est CEE !

-Four_Packed_Code
Cette option indique d'utiliser le fichier au format PFC lors de l'écriture du fichier. (Voir
srec_fpd(5) pour une description de ce format de fichier.)

-HEX_Dump
Un dump hexadécimal lisible par l'homme (y compris ASCII) sera imprimé.

-IDT Un fichier binaire IDT System Integration Manager (IDT/sim) sera écrit.
(Voir srec_idt(5) pour une description de ce format de fichier.)

-Intel Un fichier au format hexadécimal Intel sera écrit. (Voir srec_intel(5) pour un
description de ce format de fichier.) La valeur par défaut est d'émettre « i32hex » 32 bits
adressage linéaire; si vous voulez un adressage de segment étendu 16 bits « i20hex »
utiliser le -adresse‐longueur=3 option, si vous voulez un adressage « i8hex » 16 bits
utiliser le -adresse‐longueur=2 option.

-Intel_HeX_16
Un fichier au format hexadécimal Intel‐16 (INHX16) sera écrit. (Voir
srec_intel16(5) pour une description de ce format de fichier.)

-Memory_Initialization_File [ largeur ]
(Altera) Le format de fichier d'initialisation de la mémoire (MIF) sera écrit. Les
largeur par défaut à 8 bits. (Voir srec_mif(5) pour une description de ce fichier
format.)

-Mips_Flash_BigEndian

-Mips_Flash_LittleEndian
Le format de fichier Flash MIPS sera écrit. (Voir srec_mips_flash(5) pour un
description de ce format de fichier.)

-MOS_Technologies
Un fichier au format Mos Technologies sera écrit. (Voir srec_mos_tech(5)
pour une description de ce format de fichier.)

-Motorola [ largeur ]
Un fichier Motorola S‐Record sera écrit. (Voir srec_motorola(5) pour un
description de ce format de fichier.) Il s'agit du format de sortie par défaut. Par
par défaut, la plus petite longueur d'adresse possible est émise, ce sera S19
pour les données dans les 64 premiers Ko ; si vous souhaitez forcer S28 utilisez le -adresse-
longueur=3 option; si vous souhaitez forcer S37 utilisez le -adresse‐longueur=4 option

Le facultatif largeur L'argument décrit le nombre d'octets qui forment chaque
adresse multiple. Pour les utilisations normales, la valeur par défaut d'un (1) octet est
approprié. Certains systèmes avec des cibles 16 bits ou 32 bits mutilent le
adresses dans le fichier ; cette option imitera ce comportement. contrairement à
la plupart des autres paramètres, celui-ci ne peut pas être deviné.

-MsBin Cette option indique d'utiliser le format de données d'image binaire Windows CE pour écrire
le fichier. Voir srec_msbin(5) pour une description de ce format de fichier.

-Needham_Hexadécimal
Cette option indique d'utiliser le format de fichier ASCII de Needham Electronics pour écrire
le fichier. Voir srec_needham(5) pour une description de ce format de fichier.

-Ohio_Scientifique
Cette option indique d'utiliser le format hexadécimal de l'Ohio Scientific. Voir
srec_os65v(5) pour une description de ce format.

-PPB Cette option indique d'utiliser le format binaire Stag Prom Programmer. Voir
srec_ppb(5) pour une description de ce format.

-PPX Cette option indique d'utiliser le format hexadécimal du programmeur Stag Prom. Voir
srec_ppx(5) pour une description de ce format.

-SIGNétique
Cette option indique d'utiliser le format hexadécimal Signetics. Voir srec_signétique(5)
pour une description de ce format.

-Spasme Cette option indique d'utiliser le format de sortie de l'assembleur SPASM (couramment utilisé
par les programmeurs PIC). Voir srec_spasme(5) pour une description de ce format.

-SPAsm_LittleEndian
Cette option indique d'utiliser le format de sortie de l'assembleur SPASM (couramment utilisé
par les programmeurs PIC). Mais avec les données dans l'autre sens.

-STwie Un fichier au format binaire Stewie sera écrit. (Voir srec_stewie(5) pour un
description de ce format de fichier.)

-Tektronix
Un fichier au format hexadécimal Tektronix sera écrit. (Voir srec_tektronix(5) pour un
description de ce format de fichier.)

-Tektronix_Extended
Un fichier au format hexadécimal étendu Tektronix sera écrit. (Voir
srec_tektronix_extended(5) pour une description de ce format de fichier.)

-Texas_Instruments_Tagged
Un fichier au format TI‐Tagged sera écrit. (Voir srec_ti_tagged(5) pour un
description de ce format de fichier.)

-Texas_Instruments_Tagged_16
Un fichier au format Texas Instruments SDSMAC 320 sera écrit. (Voir
srec_ti_tagged_16(5) pour une description de ce format de fichier.)

-Texas_Instruments_TeXT
Cette option indique d'utiliser le format Texas Instruments TXT (MSP430) pour écrire
le fichier. Voir srec_ti_txt(5) pour une description de ce format de fichier.

-VHdl [ octets par mot [ nom ]]
Un fichier au format VHDL sera écrit. Les octets par mot par défaut à un,
le nom par défaut à eprom. Les etc/x_defs_pack.vhd fichier dans la source
distribution contient un exemple de pack de définitions de ROM pour le type‐
sortie indépendante. Vous devrez peut-être utiliser le filtre -byte‐swap pour obtenir le
ordre d'octet que vous voulez.

-VMem [ largeur de mémoire ]
Un fichier au format Verilog VMEM sera écrit. Les largeur de mémoire peut être 8,
16, 32, 64 ou 128 bits ; par défaut à 32 si non spécifié. (Voir srec_vmem(5)
pour une description de ce format de fichier.) Vous devrez peut-être utiliser le -byte‐
swap filter pour obtenir l'ordre des octets souhaité.

-WILson Un fichier au format Wilson sera écrit. (Voir srec_wilson(5) pour un
description de ce format de fichier.)

-Adresse_Longueur nombre
Cette option peut être utilisée pour spécifier le nombre minimum d'octets à utiliser dans le
sortie pour représenter une adresse (remplissage avec des zéros non significatifs si nécessaire). Cette
aide lorsque vous parlez à des dispositifs de programmation EPROM imbéciles qui ne sont pas complètement
implémenter la spécification de format.

-Données_seulement
Cette option implique la -disable=en-tête, -disable=compte de données, -disable=exec-start-
propos et -disable=pied de page options.

-Permettre nom de la fonction
Cette option est utilisée pour activer la sortie d'une entité nommée.

En-tête Cette fonction contrôle la présence d'enregistrements d'en-tête, les enregistrements qui apparaissent
avant les données elles-mêmes. Les en-têtes incluent souvent, mais pas toujours,
texte descriptif.

Compte_données
Cette fonction contrôle la présence d'enregistrements de comptage d'enregistrements de données, qui
apparaissent après les données et indiquent combien d'enregistrements de données les ont précédés.
Généralement un mécanisme d'intégrité des données.

Adresse_début_exécution
Cette fonctionnalité contrôle la présence d'enregistrements d'adresse de début d'exécution,
c'est là que le moniteur sautera et commencera à exécuter le code une fois que le
le fichier hexadécimal a fini de se charger.

Pied de page Cette fonction contrôle la présence d'un enregistrement de fin de fichier, qui
ne pas double comme enregistrement d'adresse de début d'exécution.

Facultatif_Adresse
Dans des formats dont l'adresse et les données sont séparées ou partiellement
séparé (au lieu d'avoir une adresse complète dans chaque enregistrement), il est
possible de désactiver l'émission de la première adresse où cette adresse serait
zéro, car ces formats par défaut l'adresse à zéro si aucune adresse n'est
vu avant le premier enregistrement de données. Ceci est désactivé par défaut, le zéro
l'adresse est toujours émise.

Tous les formats n'ont pas toutes les caractéristiques ci-dessus. Tous les formats ne sont pas capables de
omettre éventuellement une ou toutes les fonctionnalités ci-dessus. Les noms de fonction peuvent être abrégés
comme les noms d'options de ligne de commande.

-Désactiver nom de la fonction
Cette option est utilisée pour désactiver la sortie d'une fonction nommée. Voir le -permettre
option pour une description des fonctionnalités disponibles.

-IGNore_Sommes de contrôle
Le - Ignorer les sommes de contrôle l'option peut être utilisée pour désactiver la validation de la somme de contrôle de l'entrée
fichiers, pour les formats qui ont des sommes de contrôle du tout. Notez que la somme de contrôle
les valeurs sont toujours lues et analysées (il s'agit donc toujours d'une erreur si elles sont manquantes)
mais leurs valeurs ne sont pas vérifiées. Utilisée après un nom de fichier d'entrée, l'option
affecte ce fichier uniquement ; utilisé n'importe où ailleurs sur la ligne de commande, il s'applique à tous
fichiers suivants.

-Enable_Sequence_Warnings
Cette option peut être utilisée pour activer les avertissements concernant les fichiers d'entrée où les données
les enregistrements ne sont pas dans l'ordre strictement croissant des adresses. Un seul avertissement est émis
par fichier d'entrée. C'est la valeur par défaut.

Remarque: la sortie de srec_cat(1) est toujours dans cet ordre.

Remarque: Cette option doit être utilisée avant le fichier d'entrée. C'est parce que s'il y a
sont plusieurs fichiers sur la ligne de commande, chacun peut nécessiter des paramètres différents. Les
le réglage reste en vigueur jusqu'au prochain -Disable_Sequence_Warnings option.

-Disable_Sequence_Warnings
Cette option peut être utilisée pour désactiver les avertissements concernant les fichiers d'entrée où les données
les enregistrements ne sont pas dans l'ordre strictement croissant des adresses.

Remarque: Cette option doit être utilisée avant le fichier d'entrée incriminé. Ceci est dû au fait
s'il y a plusieurs fichiers sur la ligne de commande, chacun peut nécessiter des paramètres différents.
Le réglage reste en vigueur jusqu'au prochain -Ensable_Sequence_Warnings option.

-CRLF Cette option est un raccourci pour le -line-termination=crlf option. A utiliser avec
dispositifs de programmation EPROM farfelus qui supposent que tout le monde utilise Evil Bill's
terminaison de ligne du système d'exploitation.

-Ligne_Terminaison nom du style
Cette option peut être utilisée pour spécifier le style de fin de ligne pour la sortie de texte. Les
par défaut est d'utiliser le style de terminaison de ligne par défaut du système d'exploitation hôte (mais
Cygwin se comporte comme s'il s'agissait d'Unix). Utilisez cette option avec prudence, car elle
introduire également des octets CR supplémentaires (c'est-à-dire erronés) dans des formats binaires.

Carriage_Return_Line_Feed
Utilisez le style de terminaison de ligne CRLF, typique de DOS et M$ Windows.

Nouvelle ligne
Utilisez le style de terminaison de ligne NL, typique d'Unix et de Linux.

Chariot_Retour
Utilisez le style de terminaison de ligne CR, typique d'Apple Macintosh.

Tous les autres noms de style de fin de ligne produiront une erreur fatale. Noms de styles
peuvent être abrégés comme les noms d'options de ligne de commande.

-Longueur de la ligne nombre
Cette option peut être utilisée pour limiter la longueur des lignes de sortie à au plus nombre
personnages. (Pas significatif pour le format de fichier binaire.) La valeur par défaut est inférieure
plus de 80 caractères, selon le format. Si vous avez besoin de contrôler au maximum
nombre d'octets dans chaque enregistrement de sortie, utilisez le --Output_Block_Size option.

-Entête string
Cette option peut être utilisée pour définir le commentaire d'en-tête, dans les formats qui prennent en charge
ce. Cette option implique la -enable=en-tête option.

-Execution_Start_Address nombre
Cette option peut être utilisée pour définir l'adresse de début d'exécution, dans les formats qui
soutiens le. L'adresse de début d'exécution est l'endroit où le moniteur sautera et
commencer à exécuter du code une fois que le fichier hexadécimal a fini de se charger, considérez-le comme un
adresse « aller à ». Généralement ignoré par les dispositifs de programmation EPROM. Cette option implique
le -enable=exec-start-addr option.

Veuillez noter : l'adresse de début d'exécution est un concept différent de la première
adresse en mémoire de vos données. Si vous souhaitez modifier l'emplacement de départ de vos données dans
mémoire, utilisez le -décalage filtre.

-Output_Block_Size nombre
Cette option peut être utilisée pour spécifier le nombre exact d'octets de données à afficher dans
chaque enregistrement de sortie. Il existe des limitations spécifiques au format sur cette valeur, vous
obtenir une erreur si la valeur n'est pas valide. Si vous devez contrôler le nombre maximum
de caractères sur une ligne de sortie de texte, utilisez le --Longueur de la ligne option.

-Output_Block_Packing
De temps en temps, avec des fichiers volumineux, vous pouvez remarquer que vos enregistrements de données sont
cracher de façon inattendue sur la sortie. Cela se produit généralement lorsque les longueurs d'enregistrement ne sont pas un
puissance de 2. Si cela vous dérange (ou vos outils de comparaison), cette option peut être
utilisé pour reconditionner la sortie afin que les limites de bloc internes de SRecord ne soient pas
visible dans la sortie.

-Output_Block_Alignment
Cette option est similaire à la -Output_Block_Packing option, sauf que court
les enregistrements sont utilisés après les trous pour que les enregistrements suivants soient placés sur un bloc
limite de taille.

-Plusieurs
Utilisez cette option pour permettre à un fichier de contenir plusieurs valeurs (contradictoires) pour
certains emplacements mémoire. Un avertissement sera imprimé. La dernière valeur du fichier
sera utilisé. Par défaut, cette condition est une erreur fatale.

Toutes les autres options produiront une erreur de diagnostic.

Toutes les options peuvent être abrégées ; l'abréviation est documentée en lettres majuscules,
toutes les lettres minuscules et les traits de soulignement (_) sont facultatifs. Vous devez utiliser consécutivement
séquences de lettres facultatives.

Toutes les options sont insensibles à la casse, vous pouvez les saisir en majuscules ou en minuscules ou un
combinaison des deux, la casse n'a pas d'importance.

Par exemple : les arguments "-help", "-HEL" et "-h" sont tous interprétés comme signifiant le -Aidez-moi
option. L'argument « -hlp » ne sera pas compris, car des facultatifs consécutifs
les caractères n'ont pas été fournis.

Les options et autres arguments de ligne de commande peuvent être mélangés arbitrairement sur la ligne de commande.

Les noms d'options longs GNU sont compris. Étant donné que tous les noms d'option pour srec_cat sont longues,
cela signifie ignorer le "-" de début supplémentaire. Les "--option=valeur” la convention est aussi
compris.

EXIT STATUT

Le srec_cat La commande se terminera avec un statut de 1 en cas d'erreur. Les srec_cat la commande sera
ne sortir avec un statut de 0 s'il n'y a pas d'erreurs.

DROIT D'AUTEUR

srec_cat Version 1.58
Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009,
2010, 2011 Peter Miller

Le srec_cat le programme est livré avec ABSOLUMENT AUCUNE GARANTIE ; pour plus de détails, utilisez le 'srec_cat
-Version Licence' commande. Ceci est un logiciel gratuit et vous pouvez le redistribuer
sous certaines conditions; pour plus de détails, utilisez le 'srec_cat -Version Licence' commande.

Utilisez srec_cat en ligne à l'aide des services onworks.net