obniz/parts/MovementSensor/Button/README.md

obniz sdk for javascript

# Button
Button turn on/off electricity. Just monitor voltage to check button pressed or not.

## wired(obniz, {signal [,gnd]})

Connect two pins to obniz. Many buttons has no pin direction. you can connect each one to signal,gnd.

![photo of wired](./wired.png)

```Javascript
// Javascript Example
var button = obniz.wired("Button",  {signal:0, gnd:1});
```

gnd is optional. It can be shared other gnd.

```Javascript
// Javascript Example
var button = obniz.wired("Button",  {signal:0});
```



## onchange = function(pressed){}
called when button pressed/released.

```Javascript
// Javascript Example
var button = obniz.wired("Button",  {signal:0, gnd:1});
button.onchange = function(pressed){
  console.log("pressed:" + pressed)
};
```

## [await] isPressedWait()
Check current button with waiting result.
```Javascript
// Javascript Example
var button = obniz.wired("Button",  {signal:0, gnd:1});
var pressed = await button.isPressedWait();
console.log("Pressed = " + pressed);
```


## [await] stateWait()
Wait until push/release button.
```Javascript
// Javascript Example
var button = obniz.wired("Button",  {signal:0, gnd:1});
await button.stateWait(true); 
console.log("button pushed!");
await button.stateWait(false); 
console.log("button released");
```