{"id":87,"date":"2019-03-03T18:40:44","date_gmt":"2019-03-03T18:40:44","guid":{"rendered":"http:\/\/julien-nevo.com\/disark\/?page_id=87"},"modified":"2019-03-03T22:47:01","modified_gmt":"2019-03-03T22:47:01","slug":"usage","status":"publish","type":"page","link":"https:\/\/julien-nevo.com\/disark\/index.php\/usage\/","title":{"rendered":"Usage"},"content":{"rendered":"\n

Please check the example page<\/a> first, in order to grasp the concepts of Disark!<\/p>\n\n\n\n

Note: all the addresses can be decimal or hexadecimal (starting with “&”, “#”, “$”, “0x”).<\/em><\/p>\n\n\n\n

The command-line options are:<\/p>\n\n\n\n

<path to input binary file><\/strong> Mandatory. The path to the binary file to open. It must be a Z80 binary file.<\/p>\n\n\n\n

<path to output Z80 source file><\/strong> Mandatory. The path to the file to generate. It will be a Z80 source, to be opened by your favorite assembler. In order to be compliant with your assembler, check the “source profile” option.<\/p>\n\n\n\n

sourceProfile <profile><\/strong> If present, uses a “source profile”, to generate a Z80 generate compliant with your assembler. “profile” can be: winape, maxam, pasmo, sdcc, vasm, orgams. If no source profile is selected, a Rasm\/Sjasmplus source profile is generated. Even if selected, you can still override the source generation with the options below.<\/p>\n\n\n\n

symbolFile <path to symbol file><\/strong> If present, must point to a symbol file. Each line of the symbol file must contain a label, and an address. Labels will be removed their possible “.” and “:”. Addresses can be decimal or hexadecimal (detected by “&”, “#”, “$”, “0x”). By default, the first word is the label, the second the address. You can use the two options just below to change that.<\/p>\n\n\n\n

labelPositionInSymbolFile <position><\/strong> If present, indicates the position of the labels in the symbol files. 1 means “first word”, 2 “second word”, etc.<\/p>\n\n\n\n

addressPositionInSymbolFile <position><\/strong> If present, indicates the position of the addresses in the symbol files. 1 means “first word”, 2 “second word”, etc. <\/p>\n\n\n\n

loadAddress <address><\/strong> If present, indicates the address the original code was compiled. This greatly improve the disassembling accuracy.<\/p>\n\n\n\n

genOrg <\/strong>If present, an ORG mnemonic is generated (see the “loadAddress” option about how to set this address).<\/p>\n\n\n\n

genLabels <\/strong>If present, labels will be generated whenever needed, which is handy for relocation. However, this should not be needed if you are using a symbol table.<\/p>\n\n\n\n

genLabelPrefix <prefix> <\/strong>If present, all the generated labels will start with the given “prefix”. If not present, the labels start with “lab”.<\/p>\n\n\n\n

src8bitsValuesInHex<\/strong> If present, all the 8 bits values will be written in hexadecimal.<\/p>\n\n\n\n

src16bitsValuesInHex <\/strong>If present, all the 16 bits values will be written in hexadecimal. <\/p>\n\n\n\n

hexPrefix <prefix> <\/strong>Defines how the hexadecimal values will be presented (for example “0x” for 0x4000). Default is “#”. You may use quotes, useful for empty strings. <\/p>\n\n\n\n

hexPostfix <prefix> <\/strong>Defines how the hexadecimal values ends (for example “h” for 4000h). Default is empty. You may use quotes, useful for empty strings.<\/p>\n\n\n\n

adrInComments <\/strong>If present, the current address is generated in the comment of each line.<\/p>\n\n\n\n

undocumentedOpcodesToBytes <\/strong>If present, all the undocumented opcodes are encoded as bytes, to maximize compatibility (“out (c),0”, but also all instructions about IXL\/IXH\/IYL\/IYH).<\/p>\n","protected":false},"excerpt":{"rendered":"

Please check the example page first, in order to grasp the concepts of Disark! Note: all the addresses can be decimal or hexadecimal (starting with “&”, “#”, “$”, “0x”). The command-line options are: <path to input binary file> Mandatory. The path to the binary file to open. It must be a Z80 binary file. <path Read more<\/a><\/span><\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-87","page","type-page","status-publish","hentry"],"yoast_head":"\nUsage - Disark<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/julien-nevo.com\/disark\/index.php\/usage\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Usage - Disark\" \/>\n<meta property=\"og:description\" content=\"Please check the example page first, in order to grasp the concepts of Disark! Note: all the addresses can be decimal or hexadecimal (starting with “&”, “#”, “$”, “0x”). The command-line options are: <path to input binary file> Mandatory. The path to the binary file to open. It must be a Z80 binary file. <path Read more\" \/>\n<meta property=\"og:url\" content=\"https:\/\/julien-nevo.com\/disark\/index.php\/usage\/\" \/>\n<meta property=\"og:site_name\" content=\"Disark\" \/>\n<meta property=\"article:modified_time\" content=\"2019-03-03T22:47:01+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/julien-nevo.com\/disark\/index.php\/usage\/\",\"url\":\"https:\/\/julien-nevo.com\/disark\/index.php\/usage\/\",\"name\":\"Usage - Disark\",\"isPartOf\":{\"@id\":\"http:\/\/julien-nevo.com\/disark\/#website\"},\"datePublished\":\"2019-03-03T18:40:44+00:00\",\"dateModified\":\"2019-03-03T22:47:01+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/julien-nevo.com\/disark\/index.php\/usage\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/julien-nevo.com\/disark\/index.php\/usage\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/julien-nevo.com\/disark\/index.php\/usage\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"http:\/\/julien-nevo.com\/disark\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Usage\"}]},{\"@type\":\"WebSite\",\"@id\":\"http:\/\/julien-nevo.com\/disark\/#website\",\"url\":\"http:\/\/julien-nevo.com\/disark\/\",\"name\":\"Disark\",\"description\":\"A powerful cross-platform Z80 disassembler \/ source converter\",\"publisher\":{\"@id\":\"http:\/\/julien-nevo.com\/disark\/#\/schema\/person\/1c076d62ea698382f18b9a2a7bfddb15\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"http:\/\/julien-nevo.com\/disark\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":[\"Person\",\"Organization\"],\"@id\":\"http:\/\/julien-nevo.com\/disark\/#\/schema\/person\/1c076d62ea698382f18b9a2a7bfddb15\",\"name\":\"Targhan\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"http:\/\/julien-nevo.com\/disark\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/c4ecfa4cef2c920a1d2544b3025074e4ab0d1685c53b73ecdf3c803225808696?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/c4ecfa4cef2c920a1d2544b3025074e4ab0d1685c53b73ecdf3c803225808696?s=96&d=mm&r=g\",\"caption\":\"Targhan\"},\"logo\":{\"@id\":\"http:\/\/julien-nevo.com\/disark\/#\/schema\/person\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Usage - Disark","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/julien-nevo.com\/disark\/index.php\/usage\/","og_locale":"en_US","og_type":"article","og_title":"Usage - Disark","og_description":"Please check the example page first, in order to grasp the concepts of Disark! Note: all the addresses can be decimal or hexadecimal (starting with “&”, “#”, “$”, “0x”). The command-line options are: <path to input binary file> Mandatory. The path to the binary file to open. It must be a Z80 binary file. <path Read more","og_url":"https:\/\/julien-nevo.com\/disark\/index.php\/usage\/","og_site_name":"Disark","article_modified_time":"2019-03-03T22:47:01+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/julien-nevo.com\/disark\/index.php\/usage\/","url":"https:\/\/julien-nevo.com\/disark\/index.php\/usage\/","name":"Usage - Disark","isPartOf":{"@id":"http:\/\/julien-nevo.com\/disark\/#website"},"datePublished":"2019-03-03T18:40:44+00:00","dateModified":"2019-03-03T22:47:01+00:00","breadcrumb":{"@id":"https:\/\/julien-nevo.com\/disark\/index.php\/usage\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/julien-nevo.com\/disark\/index.php\/usage\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/julien-nevo.com\/disark\/index.php\/usage\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"http:\/\/julien-nevo.com\/disark\/"},{"@type":"ListItem","position":2,"name":"Usage"}]},{"@type":"WebSite","@id":"http:\/\/julien-nevo.com\/disark\/#website","url":"http:\/\/julien-nevo.com\/disark\/","name":"Disark","description":"A powerful cross-platform Z80 disassembler \/ source converter","publisher":{"@id":"http:\/\/julien-nevo.com\/disark\/#\/schema\/person\/1c076d62ea698382f18b9a2a7bfddb15"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"http:\/\/julien-nevo.com\/disark\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":["Person","Organization"],"@id":"http:\/\/julien-nevo.com\/disark\/#\/schema\/person\/1c076d62ea698382f18b9a2a7bfddb15","name":"Targhan","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"http:\/\/julien-nevo.com\/disark\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/c4ecfa4cef2c920a1d2544b3025074e4ab0d1685c53b73ecdf3c803225808696?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/c4ecfa4cef2c920a1d2544b3025074e4ab0d1685c53b73ecdf3c803225808696?s=96&d=mm&r=g","caption":"Targhan"},"logo":{"@id":"http:\/\/julien-nevo.com\/disark\/#\/schema\/person\/image\/"}}]}},"_links":{"self":[{"href":"https:\/\/julien-nevo.com\/disark\/index.php\/wp-json\/wp\/v2\/pages\/87","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/julien-nevo.com\/disark\/index.php\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/julien-nevo.com\/disark\/index.php\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/julien-nevo.com\/disark\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/julien-nevo.com\/disark\/index.php\/wp-json\/wp\/v2\/comments?post=87"}],"version-history":[{"count":6,"href":"https:\/\/julien-nevo.com\/disark\/index.php\/wp-json\/wp\/v2\/pages\/87\/revisions"}],"predecessor-version":[{"id":100,"href":"https:\/\/julien-nevo.com\/disark\/index.php\/wp-json\/wp\/v2\/pages\/87\/revisions\/100"}],"wp:attachment":[{"href":"https:\/\/julien-nevo.com\/disark\/index.php\/wp-json\/wp\/v2\/media?parent=87"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}