This is an alphabetical reference listing all the functions provided in Bitlash.
Many Bitlash functions are straight pass-throughs from the Arduino functions of the same name. Therefore, the definitive reference for the behavior of the functions is the Arduino Extended Reference Page.
Functions may be used in expressions in the normal way: abs(ar(3)-256) and so forth.
Bear in mind that functions return 32-bit integer values (signed long or int32_t in C). Whether the value is interpreted as signed or unsigned depends on the function.
It is an error to call a function with the wrong number of arguments.
For functions of zero arguments you may omit the empty parens ():
> print free,free(),millis,millis() 335 335 24455 24456
Return x < 0 ? -x : x. See abs.
Return a 10-bit analog-to-digital conversion value from the specified analog input pin. See analogRead.
Write a PWM value to a digital pwm output pin. The pin must be prepared for output beforehand via pinmode(pin,1).
A simpler syntax if the pin is fixed is: a6=128
See analogWrite.
By default, Arduino prints at 57600 on pin 0 and 9600 on any other pin. If you wish to set a different rate use the baud function:
> baud(5, 4800); // prepare "print #5:" to produce serial output on pin 5 at 4800 baud (8,n,1) > baud(0, 9600); // set the default/hardware serial port to 9600 baud
See print.
Toggle the specified pin at the specified frequency for the specified duration. Automatically sets pinMode to OUTPUT.
Beep is blocking: background execution is paused. Use caution for long durations: there is no way to break out of a long beep (the longest value is several days).
> beep(11,440,200) // make the beeper on pin 11 beep at 440Hz for 200ms
Pause execution for the specified number of milliseconds.
Delay is blocking; nothing else happens while a delay() is being processed. For this reason is it better to use background macros to do things that span non-trivial time.
See delay.
The dr() function is shorthand for digitalRead(). It returns the current logic level on the specified pin.
If the pin is fixed and known beforehand you can use pin variable notation instead:
> z = 13 > x = dr(z) // return digitalRead(13) > x = d13 // same result using pin variable notation
See digitalRead.
Delay for the specified number of microseconds.
NOTE: This function is deprecated as of Bitlash v1.1 and therefore is no longer included in the build.
See delaymicroseconds.
Return the value stored in EEPROM at the specified address.
Returns the amount of memory between the top of the heap and the stack pointer; in other words, the amount of stack space Bitlash and all your other code, including interrupt handlers, have to work with.
Numbers less than 50 or so indicate ram starvation and mean that the odd behavior you are seeing (or will see soon) is attributable to the occasional excursion of the stack into the defined ram area, piddling on the interpreter state. Nothing good will come of this.
Note that malloc() and free() are not used by or included in Bitlash and the free memory calculation takes no heed of memory broken out of the heap if you should include them for your code.
The free() function will issue an exception if free memory appears to be less than zero.
Return the 8-bit value of the specified AVR processor register.
The processor registers and their functions are the function of the extensive ATmega328P Data Sheet. You will find a convenient cross reference chart of the registers starting on page 425.
You specify a register address (from the first column of the table on pp. 425 ff.) to tell the inb() and outb() which register to address. In the case where the table has two addresses, use the right-hand one.
For example, to read the Timer0 count register TCNT0, find its entry on page 470 and note its address is 0x46. Then, to read and print it in Bitlash:
print inb(0x46)
Constrains val to [fromlow..fromhigh] and then maps it linearly to [tolow..tohigh]. Got it?
NOTE: The map() function is deprecated as of Bitlash version 1.1 and is therefore not included in the build.
See map.
Set the specified AVR processor register to the given value.
The processor registers and their functions are the function of the extensive ATmega328P Data Sheet. You will find a convenient cross reference chart of the registers starting on page 425.
You specify a register address (from the first column of the table on pp. 425 ff.) to tell the inb() and outb() which register to address. In the case where the table has two addresses, use the right-hand one.
For example, to set the OCR0A register (0x47) to control timer 0 PWM, you could say:
outb(0x47, 128)
Times an input pulse. See pulseIn.
Suspend further invocations of this background macro for snoozemillis milliseconds. See the page on Background Macros for details on multitasking with snooze.
> blink13:="while 1:d13=!d13; snooze(100)" > run blink13 // only toggles every 100 ms