Hello Guest it is July 16, 2020, 10:38:14 AM

Author Topic: Mach3 Customization/Macro Programming Documentation  (Read 51452 times)

0 Members and 1 Guest are viewing this topic.

vmax549

*
Re: Mach3 Customization/Macro Programming Documentation
« Reply #10 on: August 17, 2009, 10:58:45 PM »
OH MY what a can of worms you are opening(;-)   REMEMBER there are huge volumes of VB that have been coded. Most of it runs things that the current users have no way of redoing.

IN realiality WHY even mess with them. THey are there and they work.  Needs better descriptors you say???

 NOPE I diasagree all they need is a good definition as to what they do and how to use them.

Take Gcode for example NOT ONE gcode has a descriptor built into the GCODE name.  YEt millions can read and write the code just fine. why because they are well documented and people LEARNED what they mean.


IF it is not broke please don't fix it. IT is way too late in the game to do that.

PLEASE be carefull in your endevors, (;-) TP
« Last Edit: August 18, 2009, 01:16:51 AM by vmax549 »

Offline poppabear

*
  • *
  •  2,233 2,233
  • Briceville, TN, USA
    • View Profile
    • S S Systems, LLC
Re: Mach3 Customization/Macro Programming Documentation
« Reply #11 on: August 18, 2009, 09:34:53 AM »
Ray,

   The docs I posted under Member docs for the VB stuff was ALSO from the Source Code that Art sent me, it was tested as to funciton, and for what had been depreciated, and added above and beyond the current Wiki........

it will save you some time, my friend,

scott
Commercial Mach3 & Mach 4, Design/Build/Retrofit CNC and Industrial machines.
http://www.ss-systems-llc.com/

Offline simpson36

*
  •  1,371 1,371
    • View Profile
Re: Mach3 Customization/Macro Programming Documentation
« Reply #12 on: August 18, 2009, 10:17:50 AM »
HimyKabibble,

I vote to go forward with aliases. If the original 'names' are retained to run legacy code, there is no logical objection.

Just having everything in one place and in some semblance of a similar format will be a huge step in the right direction. I hope you will release something like that as soon as it is assembled.

If you are accepting 'wish list' items, and if it is possible, can M codes be named or have aliases? If not, could a look-up table be created where descriptive names could be used that would then call the numbered macro?

And, although it does not seem like part of your responsibility, I'll just take advantage of the opportunity to throw out some more whining for serial or USB port bidirectional access.  :'(
Re: Mach3 Customization/Macro Programming Documentation
« Reply #13 on: August 18, 2009, 12:03:15 PM »
Ray,

   The docs I posted under Member docs for the VB stuff was ALSO from the Source Code that Art sent me, it was tested as to funciton, and for what had been depreciated, and added above and beyond the current Wiki........

it will save you some time, my friend,

scott

Scott,

Yup, I'm using that.

Regards,
Ray L.
Regards,
Ray L.
Re: Mach3 Customization/Macro Programming Documentation
« Reply #14 on: August 18, 2009, 12:41:10 PM »
Simpson,

I agree, no reason not to do the aliases - Old macros will still work for as long as the old calls are supported, and we can push people towards using the new ones.  Below is a sample of the format I'm using to document the function calls.

Don't think named macros will happen this time, though I'd sure like to see it myself.  In the meantime, you can get partway there:

MyBlivetMacro = "M978"
...
Code (MyBlivetMacro)

Not as good, but a small step in the right direction.

Regards,
Ray L.
Regards,
Ray L.

Offline ger21

*
  • *
  •  6,282 6,282
    • View Profile
    • The CNC Woodworker
Re: Mach3 Customization/Macro Programming Documentation
« Reply #15 on: August 18, 2009, 10:13:59 PM »
"Assert an output signal". Why not just say "activate an output signal, or send an output signal. Seems to me that "Assert" will confuse the hell out of people. I've been writing VB code for many years, and when I first saw "Assert", I had to read through the description to make sure I knew what you were saying. Very confusing imo.
Gerry

2010 Screenset
http://www.thecncwoodworker.com/2010.html

JointCAM Dovetail and Box Joint software
http://www.g-forcecnc.com/jointcam.html
Re: Mach3 Customization/Macro Programming Documentation
« Reply #16 on: August 18, 2009, 10:42:35 PM »
"Assert an output signal". Why not just say "activate an output signal, or send an output signal. Seems to me that "Assert" will confuse the hell out of people. I've been writing VB code for many years, and when I first saw "Assert", I had to read through the description to make sure I knew what you were saying. Very confusing imo.

Gerry,

When defining the behavior of a piece of hardware of software, "assert" has a very definite meaning: it makes it clear that the output will be driven to its active state.  With a Mach3 output, this might mean it's driven to a logic high, or driven to a logic low, depending on how that output is defined in Ports&Pins.  But, whatever its active state, it will be driven to that state.  Assert has a very definite and unambiguous meaning, and is a term commonly used in technical literature, such as chip data sheets, to define such things.  If I read something was "activated" or "sent", I would not know what that meant, as those terms are quite ambiguous.  There may be a few new terms you'll need to learn to read this document, but once you do, you'll never have any doubts as to what a function does, once you've read its description.

Regards,
Ray L.
Regards,
Ray L.

Offline RICH

*
  • *
  •  7,411 7,411
    • View Profile
Re: Mach3 Customization/Macro Programming Documentation
« Reply #17 on: August 18, 2009, 10:56:06 PM »
HMM......
Ray, here is the challenge, so what would a dummy like me do, i would't even know where start looking
 for the definition......but don't let me fog up your progress.......I am sure you'll clarify as necessary.

I quess, just write at whatever level you wish, you have enough of a challenge!
RICH

Offline simpson36

*
  •  1,371 1,371
    • View Profile
Re: Mach3 Customization/Macro Programming Documentation
« Reply #18 on: August 19, 2009, 07:14:49 AM »
Since I'm following this thread, I may as well make a nuisance of myself and chime in on this one also.

The difference between 'assert' and 'activate' is very clear in my mind thanks to the description provided and it should be obvious that a clearly defined distinction between the two will prevent many hours of trouble shooting and frustration in writing code for Mach.

I do not find the terms confusing, however, the different definitions do cause a conflict when the two terms are used for the same function. I have to agree that this inconsistency is confusing. When I read it, my first thought was 'typo'.

My vote would be to change the function name to 'AssertAnOutput()' in the interest of continuity and clarity, if the purpose of the function is an 'assertion' as described.

Assuming the big dogs are watching this thread, may I take advantage one again and ask if it is possible to change the Mach setting from 'step/dir' to 'PWM' for spindle control from within a macro. I have looked but not found such a function.

Thanks!
« Last Edit: August 19, 2009, 07:25:31 AM by simpson36 »

Offline ger21

*
  • *
  •  6,282 6,282
    • View Profile
    • The CNC Woodworker
Re: Mach3 Customization/Macro Programming Documentation
« Reply #19 on: August 19, 2009, 09:14:22 AM »
There may be a few new terms you'll need to learn to read this document, but once you do, you'll never have any doubts as to what a function does, once you've read its description.

Regards,
Ray L.

I don't really care how you word it, I can figure it out. But imo you're going to make it very confusing for beginners. just my 2 cents.
Gerry

2010 Screenset
http://www.thecncwoodworker.com/2010.html

JointCAM Dovetail and Box Joint software
http://www.g-forcecnc.com/jointcam.html