Backup RAM Functions

bm_check

char bm_check(void); [ 1.5+ ]

Return whether the backup ram is available.

0 = false
1 = true

bm_free

int bm_free(void); [ 1.5+ ]

Return the number of free bytes available for user data. The amount
required for the data header and the necessary 2-byte termination are
alreadt deducted from this amount. The value returned is the number
of bytes free for user data.

bm_exist

Before 3.03, it would return the bm_error code ( 0 is OK, != 0 is bad ),
but this did not match the sense of the function name.

From 3.03 forward, it returns TRUE (!= 0) if good; FALSE (0) if bad.
The error type can be retrieved from bm_errno().

Note2: The name structure is not just an ASCII name; it begins with a
2-byte "uniqueness ID" which is almost always 00 00, followed by
10 bytes of ASCII name - which should be padded with trailing
spaces.