search

s390guy / SATK

Toolkit for creating baremetal programs targeting mainframe compatible systems
GNU General Public License v3.0
41 stars 6 forks source link

Missing "Getting started" #7

Closed BertLindeman closed 4 years ago

BertLindeman commented 10 years ago

Hi Harold,

This is a fun area you opened here. I got this far:

So I am at a stage: now what. Would like to assemble a hello world program and run it. But I do not want to override anything in the distribution. Have seen many references in SATK to "only a hello world program"

So question like:

Suggestions (just typing out loud..)?:

Willing to help write a "Getting started"

s390guy commented 10 years ago

On Mon, 2014-09-15 at 01:30 -0700, Bert wrote:

Hi Harold,

This is a fun area you opened here. I got this far:

  * downloaded zip from github
  * unzipped (in my case today on a windows pc)
  * read the introduction, README, README.SAMPLES.txt
  * verified that my python is at least 3.3
  * have seen hercules conf and rc files (and have some hercules
    versions ;-) )

So I am at a stage: now what. Would like to assemble a hello world program and run it. But I do not want to override anything in the distribution. Have seen many references in SATK to "only a hello world program"

So question like:

  * Do I need to set any path or other environment?

Environment setup is discussed in the documentation for ASMA. The samples at present only have GNU as source. I have been working on the ASMA assembler and have not really yet had a chance to create samples for its use.

The simple answer is likely you will need to set ASMPATH environment variable to find your source program, although an absolute path may also be used. ASMPATH is used to find any source that is not an absolute path.

Suggestions (just typing out loud..)?:

  * first start hercules and load and run sample xx

These samples are GNU as based.

  * create a directory mysrc to keep your own creations ( or
    better advice? subdir of src?)

The src directory only contains GNU as source. I have not figured out yet whether to include ASMA source there or a different directory. GNU as is not the direction going forward. Let's say that is being "stabilized".

For now I would suggest a directory outside of the SATK for your own programs.

  * use a copy of ???? 
  * etc...

Willing to help write a "Getting started"

Glad you find the tool kit of interest, Bert.

Not sure with what you want to get started although I suspect it is with ASMA. I suspect you saw the announcement on one of the two Hercules related email lists. You can email me directly from the email address for me you find there or respond to the announcement on the list itself.

I am certainly open to more doc. But this is probably not the best forum for working out those details.

I expect communication on one of the Hercules email lists or privately. It has been pointed out my email address is not in the readme. That is intentional. Maybe I should revisit that. But, I have reasons for not including it. Github does want contact information in the readme.

Harold Grovesteen

BertLindeman commented 10 years ago

Hi Harold,

Thanks for the reply.

Yes, got the announcement at the hercules email lists. asma was indeed my first interest. Bare metal has a ring to it. Even literally. Will react there after I had a look as to what I want ;-) Your email address is yours, no problem with that.

So, maybe later... Bert Lindeman

s390guy commented 10 years ago

On Mon, 2014-09-15 at 09:40 -0700, Bert wrote:

Hi Harold,

Thanks for the reply.

Yes, got the announcement at the hercules email lists. asma was indeed my first interest. Bare metal has a ring to it. Even literally. Will react there after I had a look as to what I want ;-) Your email address is yours, no problem with that.

So, maybe later... Bert Lindeman

I am just not comfortable putting it here. For all of Yahoo's imperfections, the Hercules lists are controlled so I have had very little problem with my email address from that source. And no bigger risk, it is already there.

I am certainly interested in getting more than myself involved. Hopefully ASMA will encourage contributions to the project whereas GNU as might have been an impediment.

Thanks for understanding, Harold

Fish-Git commented 4 years ago

FWIW to anyone reading this, I have been using Harold's fantastic SATK/ASMA product for a couple of years now and it totally rocks!

I have used it to write many stand-alone test cases for the Hercules project and it has proven itself to be absolutely invaluable!

Well done and THANK YOU, Harold!   :)

s390guy commented 4 years ago

This was added to the ASMA.odt / ASMA.pdf document