monarco-hat - Node.js driver library for Monarco HAT
Compatible Monarco HAT firmware version: 2.006 and newer
Install required build-dependencies on your Raspbian running on Raspberry Pi:
sudo apt update sudo apt install build-essential
Install Node.js on your Raspbian running on Raspberry Pi:
curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash - sudo apt install -y nodejs
If you are interested in details, see Installing Node.js via package manager.
Acquiring the package
Install the package using npm registry:
npm install monarco-hat
If installed correctly the package is located in
The most comprehensive way how to get into using the Node.js library for Monarco HAT is to examine the application example, which is located in ~/node_modules/monarco-hat/index.js.
Running the demo example
To run the demo first change the current working directory to the location where the package is installed and then execute the example application:
cd ~/node_modules/monarco-hat npm start
### Monarco HAT Node.js library demo example v1.0 Cycle interval: 50 [ms] MONARCO SDC INIT DONE, FW=00002005, HW=00000104, CPUID=0367011264953669 DI1..4: 1111 | CNT1: 00000 | CNT2: 00000 | AIN1: 1.937 | AIN2: 5.150 DI1..4: 1110 | CNT1: 00000 | CNT2: 00001 | AIN1: 1.937 | AIN2: 5.521 DI1..4: 1100 | CNT1: 00000 | CNT2: 00002 | AIN1: 1.941 | AIN2: 5.885 DI1..4: 1101 | CNT1: 00000 | CNT2: 00003 | AIN1: 1.937 | AIN2: 6.237 DI1..4: 1111 | CNT1: 00000 | CNT2: 00004 | AIN1: 1.937 | AIN2: 6.581 DI1..4: 1110 | CNT1: 00000 | CNT2: 00005 | AIN1: 1.934 | AIN2: 6.911 DI1..4: 1100 | CNT1: 00000 | CNT2: 00002 | AIN1: 1.937 | AIN2: 7.221 DI1..4: 1101 | CNT1: 00000 | CNT2: 00003 | AIN1: 1.939 | AIN2: 7.512 DI1..4: 1111 | CNT1: 00000 | CNT2: 00004 | AIN1: 1.937 | AIN2: 7.766 DI1..4: 1110 | CNT1: 00000 | CNT2: 00005 | AIN1: 1.937 | AIN2: 7.993 DI1..4: 1100 | CNT1: 00000 | CNT2: 00006 | AIN1: 1.937 | AIN2: 8.183 DI1..4: 1101 | CNT1: 00000 | CNT2: 00007 | AIN1: 1.934 | AIN2: 8.344 DI1..4: 1111 | CNT1: 00000 | CNT2: 00008 | AIN1: 1.934 | AIN2: 8.484
This example code runs in 50 ms cyclic loop. Initial values of important service registers (SDC) are defined to be written, and identification registers like hardware and firmware version and CPU ID are read out during startup phase. You can use service registers handling approach provided by this example as a basis for your projects. Completion of SDC startup phase is signalised by message starting with
MONARCO SDC INIT DONE.
AOUT1 is driven by constant 2.0 Volts,
AOUT2 is driven by sinusoidal signal between 1.0 Volts and 9.0 Volts. Digital outputs
DOUT4 simulate quadrature encoder signal.
For the test, it is expected you connected together AIN1<->AOUT1, AIN2<->AOUT2, DIN3<->DOUT3, DIN4<->DOUT4. COUNTER2 module is switched to quadrature decoder mode.
Alternative method of acquiring the package via Git
Cloning the repository should be only used if the npm registry is not available or it is not desirable to use the Node.js package ecosystem.
sudo apt install git
Clone the repository:
git clone https://github.com/monarco/monarco-hat-driver-nodejs.git
Change working directory:
Install dependencies in the cloned repository:
monarco-hat package and examples provided in this repository are covered by the BSD 3-Clause License. See LICENSE.txt or https://opensource.org/licenses/BSD-3-Clause