{"id":15489324,"url":"https://github.com/kevinpt/opbasm","last_synced_at":"2025-04-14T16:02:10.819Z","repository":{"id":33052771,"uuid":"36689044","full_name":"kevinpt/opbasm","owner":"kevinpt","description":"Open PicoBlaze Assembler","archived":false,"fork":false,"pushed_at":"2023-10-29T17:41:43.000Z","size":2408,"stargazers_count":62,"open_issues_count":15,"forks_count":13,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-03-28T04:41:58.488Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://kevinpt.github.io/opbasm/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kevinpt.png","metadata":{"files":{"readme":"README.rst","changelog":"ChangeLog.txt","contributing":"CONTRIBUTING","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-06-01T21:09:10.000Z","updated_at":"2025-01-12T21:48:20.000Z","dependencies_parsed_at":"2024-11-01T05:01:38.154Z","dependency_job_id":"4de9da69-6bdb-4aee-8324-268f65411d4a","html_url":"https://github.com/kevinpt/opbasm","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinpt%2Fopbasm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinpt%2Fopbasm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinpt%2Fopbasm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinpt%2Fopbasm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kevinpt","download_url":"https://codeload.github.com/kevinpt/opbasm/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246273533,"owners_count":20750904,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-02T07:05:00.751Z","updated_at":"2025-03-30T03:31:17.552Z","avatar_url":"https://github.com/kevinpt.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":".. image:: http://kevinpt.github.io/opbasm/_static/opbasm_logo.png\n\n========================\nOpen PicoBlaze Assembler\n========================\n\nOpbasm is a free cross-platform assembler for the PicoBlaze-3 (PB3) and\nPicoBlaze-6 (PB6) microcontrollers `provided by Xilinx\n\u003chttp://www.xilinx.com/products/intellectual-property/picoblaze.htm\u003e`_. It will\nrun readily on any platform with a Python interpreter. Opbasm\nprovides a better performing solution to assembling PicoBlaze code without\nresorting to DOS or Windows emulation to run the native KCPSM assemblers.\n\n\n**Special features of Opbasm:**\n\n * Optional `m4 preprocessor macros\n   \u003chttp://kevinpt.github.io/opbasm/rst/m4.html\u003e`_ are available when the m4\n   program is installed. An extensive set of built-in macros provide more\n   advanced features than the base language. For example, converting\n   temperature scales becomes as easy as this:\n\n  .. code-block::\n\n    reg16(rx, s4,s5)                ; Create a virtual 16-bit register pair named rx\n\n    c_to_f:\n      load reglower(rx), s0         ; Load 8-bit Celsius temperature into low byte\n      signex(rx)                    ; Sign extend to 16-bits\n      expr2s(rx := rx * 9 / 5 + 32) ; Perform 16x8-bit signed arithmetic to get Fahrenheit\n      return\n\n\n * Includes an optimizer that performs `static code analysis\n   \u003chttp://kevinpt.github.io/opbasm/#static-code-analysis\u003e`_ to identify dead\n   code and optionally remove it. This permits the development of code\n   libraries that can be included without wasting memory on unused functions.\n\n * Code block annotations with `user defined PRAGMA meta-comments \u003chttp://kevinpt.github.io/opbasm/#user-defined-pragma-meta-comments\u003e`_.\n \n * A basic `command line simulator Opbsim \u003chttp://kevinpt.github.io/opbasm/rst/opbsim.html\u003e`_ is included.\n\n\nSupport for the full PicoBlaze-6 syntax is provided as well as `enabling most\nof the new PB6 syntax enhancements in PicoBlaze-3 code\n\u003chttp://kevinpt.github.io/opbasm/#enabling-most-of-the-new-pb6-syntax-enhancements-in-picoblaze-3-code\u003e`_.\nThe original templating system for ROM components is supported as well as a\nmore flexible `generic ROM component\n\u003chttp://kevinpt.github.io/opbasm/#generic-rom-component\u003e`_ that can read *.mem*\nand *.hex* files directly during synthesis and simulation. A utility script is\nincluded that permits `updating the ROM contents of a bitstream file\n\u003chttp://kevinpt.github.io/opbasm/#updating-the-rom-contents-of-a-bitstream-file\u003e`_\nwithout requiring resynthesis as was formerly supplied by the DOS-based KCPSM3\ntools.\n\nFiles generated on non-Windows platforms will not have DOS line endings and\nPicoBlaze-3 files are not restricted to 8.3 file names. Opbasm also runs\nsignificantly faster than the native implementation:\n\n.. image:: http://kevinpt.github.io/opbasm/_images/opbasm_perf.png\n\nRequirements\n------------\n\nOpbasm requires Python 3.x and no additional libraries.\nThe installation script depends on setuptools which will be installed if it\nisn't currently present in your Python distribution. Optional macro support is\nprovided when m4 is installed. You can get optional colorized output from the\nscripts by installing the Python colorama package.\n\n\nDownload\n--------\n\nYou can access the Opbasm Git repository from `Github\n\u003chttps://github.com/kevinpt/opbasm\u003e`_. `Packaged source code\n\u003chttps://drive.google.com/folderview?id=0B5jin2146-EXd0hBTlAzem1ybmM\u0026usp=sharing\u003e`_\nis also available for download. You can install direct from PyPI with the \"pip\"\ncommand if you have it available.\n\n\nInstallation\n------------\n\nYou can use ``pip`` to get the latest development code from Github:\n\n.. code-block:: console\n\n  \u003e pip install --upgrade https://github.com/kevinpt/opbasm/tarball/master\n\nIf you manually downloaded a source package or created a clone with Git you can install Opbasm with the following command run from the base Opbasm directory:\n\n.. code-block:: console\n\n  \u003e python setup.py install\n\nOn Linux systems you may need to install with root privileges using the *sudo* command.\n\nAfter a successful install the Opbasm scripts will be available. On Linux they should be immediately accessible from your current search path. On Windows you will need to make sure that the ``\u003cPython root\u003e\\Scripts`` directory is in your %PATH% environment variable.\n\n\nDocumentation\n-------------\n\nThe full documentation is available online at the `main Opbasm site\n\u003chttp://kevinpt.github.io/opbasm/\u003e`_.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkevinpt%2Fopbasm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkevinpt%2Fopbasm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkevinpt%2Fopbasm/lists"}