Developers

onHand Manual: wbios (C bindings)

Button input (key input)

• int bi_getbtn(void)
  Reads a button from the button data buffer encoded in a word (b7...Down/Right/Up/Left/Enter/El/Menu/Filer...b0; b15: Event)
• int bi_sensbtn(int *code)
  If true, returns into code the next word waiting in the button data buffer
• int bi_scanbtn(void)
  Read the button I/O ports and return actual status of the buttons encoded as in bi_getbtn() but b15:Event always 0
• void bi_clrbtn()
  Clears the button data buffer, discarding any ramaining keys
• void bi_chatpsbtn(int clk)
  Sets the clock to (clk*16)Hz (default: clk=1) to prevent misunderstanding of Filer/Menu/EL/Enter buttons because of chattering
• void bi_chatjkbtn(int clk)
  Sets the clock to (clk*16)Hz (default: clk=1) to prevent misunderstanding of cursor buttons because of chattering

Disk control

• int bi_secread(int drive,int head,int cyl,int secno,int snum,void *rbuf)
  Reads snum sectors into rbuf, returning the number of sectors actually read
• int bi_secwrite(int drive,int head,int cyl,int secno,int snum,void *wbuf)
  Writes snum sectors from wbuf, returning the number of sectors actually written
• int bi_format(int drive,int level)
  Formats drive (1=Flash) using the specified level (1=deletion only;2=write check and deletion;3=write check,deletion and read check)
• int bi_getdrform(int drive,int *inf)
  Returns drive information into inf (8bytes: maxCyl/maxHead/maxSect/SectorSize, being sector size 0=128/1=256/2=512bytes)
• int bi_setdrform(int drive,int cyl,int hed,int secnt,int secsize)
  Sets format information of the specified drive, useful only as preamble of formatting a drive
• int bi_wrflush(int drive)
  Flush the write buffer of the specified drive (1=Flash). Must be called after using dos_write()/dos_fwrite()

RS-232c (full duplex) and IR (half duplex) using XMODEM protocol

• int bi_cominit(int comdev,int baud,int pulse,int timeout)
  Init the comm port (comdev: 0=none,1=SIR,2=RS-232,3=ASK,4=RC,5=SIRad,7=RC2)
• int bi_comopen(void)
  Opens the communication device (powers it up)
• int bi_comclose(void)
  Closes the communication device (powers it down)
• int bi_comwrite(char cdat)
  Transmits the character in cdat
• int bi_complwrite(char *cdat,int clen,int *num)
  Transmits clen characters from cdat; on failure puts into num the number of characters not transmitted
• int bi_comread(char *cdat)
  Receives a character and saves it into cdat. Drawing in the LCD during reception is discouraged as its stops the receive interrupt
• int bi_complread(char *cdat,int clen)
  Receives clen characters from cdat returning the number of characters received
• int bi_complreadn(char *cdat,int clen,int *num)
  Receives clen characters from cdat; on failure puts into num the number of characters received
• int bi_comclr(void)
  Clears the communication receive buffer of 150bytes
• int bi_comrnum(void)
  Returns the number of characters waiting in the receive buffer

RTC

• int bi_tmread(char *hour,char *minute,char *second)
  Reads the time from the RTC circuit
• int bi_tmwrite(char hour,char minute,char second)
  Writes the time into the RTC circuit
• int bi_dtread(char *year,char *month,char *day)
  Reads the date from the RTC circuit
• int bi_dtwrite(char year,char month,char day)
  Writes the date into the RTC circuit

Timer

• int *bi_tmset(int kind,int prio,int cnt,void (*func)())
  Grab a timer (kind:0=1Hz,1=4Hz,2=64Hz) of the specified prio (0-255; 0=greatest) to be called every cnt times and return a timer_id pointer (-1=error)
• int bi_tmdel(int *timerid)
  Release the specified timer (NOTE: a timer int *timerid can be temporarily stopped by *timerid=0, and restarted by *timerid=cnt).

Sound

• void bi_buzzinit(int volume,int tempo)
  Inits buzzer with the specified volume (2=low,9=high) and the specified tempo (NOTE: note_length=tempo*length/64 secs)
• int bi_buzzer(unsigned char tone,unsigned char length)
  Plays a note with the specified tone (0=A1#,89=C9) and length (b3..b0: length w/ 0=16; b7..b4 envelope)
• void bi_melody(unsigned int *melody)
  Plays a melody in background, being each word a note (b0-b7:tone,b8-b15:length) and 0xffff the terminating word (progress info at *(0xf27c))
• void bi_canmelody(void)
  Stops the current playing melody (if any)

System control

• void bi_reboot(void)
  Reboots the system
• void bi_cpususp(void)
  Stops the CPU
• int bi_powerread(void)
  Returns the supply voltage (0-255) as read from the A/D converter
• int bi_powerread2(void)
  Returns the supply voltage (0-255) calculated under heavy load
• int bi_current(void)
  Returns the charging/discharging current (0-255). (NOTE: in the manuals its use is discouraged)
• unsigned long bi_getpower(void)
  Returns the charge count value (160000000d=100%, 32000000d=0%)
• void bi_setpower(unsigned long count)
  Sets the charge count value to the specified one
• void bi_el(int sec)
  Lights the EL for the specified amount of seconds (sec=0 turns it off)
• int bi_27Verror(void)
  Returns true if low voltage is detected
• void bi_setvect(int ino,void (*func)())
  Sets the specified interrupt vector (ino: 0-16=hardware ints, 20-31=software ints)
• void (*bi_getvect(int ino))()
  Returns the currect handler for the specified interrupt vector
• int bi_sysread(void *rbuf)
  Copies the contents of the Flash's system area (512bytes) into rbuf
• int bi_syswrite(void *wbuf)
  Writes the contents of the system area (copies 512bytes from wbuf into the Flash's system area) and does some fixups

Synopsis

#include <wbios.h>

int bi_getbtn(void);

• b0: K0 Filer/time button
• b1: K1 Menu button
• b2: K2 EL button
• b3: K3 ENTER button
• b4: K4 Cursor left
• b5: K5 Cursor up
• b6: K6 Cursor right
• b7: K7 Cursor down
• b8: TEST (not used)
• b9: Cell dismounted
• b10: RS-232 connected but idle
• b11: RS-232 connected
• b12: CPU multiplier (1=3.6Mhz, 0=1.8Mhz)
• b13: Reserved (always 0)
• b14: Reserved (always 0)
• b15: Event number at address 0xf080

Return values
Returns a word indicating the button status (see description).

Examples
(none)