# daqhats

**Repository Path**: zfz2/daqhats

## Basic Information

- **Project Name**: daqhats
- **Description**: MCC DAQ HAT Library for Raspberry Pi
- **Primary Language**: C
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2022-09-14
- **Last Updated**: 2022-09-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MCC DAQ HAT Library for Raspberry Pi
<table>
    <tr><td>Info</td><td>Contains C and Python Libraries for interacting with 
    Measurement Computing DAQ HAT boards.</td></tr>
    <tr><td>Author</td><td>Measurement Computing</td></tr>   
    <tr><td>Library Version<td>1.2.0.1</td></tr>
</table>

## About
This is the development repository for Measurement Computing DAQ HAT boards. The
**daqhats** library was created and is supported by Measurement Computing Corporation (MCC).

#### Supported MCC DAQ HAT hardware
Hardware supported by this version of the MCC DAQ HAT Library:
- [MCC 118](https://mccdaq.github.io/daqhats/overview.html#mcc-118)
- [MCC 134](https://mccdaq.github.io/daqhats/overview.html#mcc-134)
- [MCC 152](https://mccdaq.github.io/daqhats/overview.html#mcc-152)

## Prerequisites
- Raspbian or Raspbian Lite image (may work with other Raspberry Pi operating systems)
- Raspberry Pi A+, B+, 2, or 3 (A+, B, B+)
- C, C++, Python 2.7 or Python 3.4

## Raspberry Pi Configuration
Follow the instructions at https://www.raspberrypi.org/help/ for setting up a Raspberry Pi.

## Install Instructions
1. Power off the Raspberry Pi and attach one or more DAQ HAT boards, using unique 
   address settings for each. Refer to 
   [Installing the HAT board](https://mccdaq.github.io/daqhats/hardware.html) 
   for detailed information.
   When using a single board, leave it at address 0 (all address jumpers removed.) 
   One board must always be at address 0 to ensure that the OS reads a HAT EEPROM
   and initializes the hardware correctly.
2. Power on the Pi, log in, and open a terminal window (if using the graphical interface.)
3. Update your package list:

   ```sh
   sudo apt update
   ```
4. **Optional:** Update your installation packages and reboot:

   ```sh
   sudo apt full-upgrade
   sudo reboot
   ```
5. Install git (if not installed):

   ```sh
   sudo apt install git
   ```
6. Download the daqhats library to the root of your home folder:

   ```sh
   cd ~
   git clone https://github.com/mccdaq/daqhats.git
   ```
7. Build and install the shared library, tools, and optional Python support. The 
   installer will install Python 3 support by default and ask if you want to install
   Python 2 support. It will also detect the HAT board EEPROMs and save the contents,
   if needed.

   ```sh
   cd ~/daqhats
   sudo ./install.sh
   ```   
**Note:** If you encounter any errors during steps 5 - 7 then uininstall the daqhats
library (if installed), go back to step 4, update your installed packages and reboot, 
then repeat steps 5 - 7.
   
You can now run the example programs under ~/daqhats/examples and create your own 
programs. Refer to the [Examples](#examples) section below for more information.

If you are using the Raspbian desktop interface, the DAQ HAT Manager utility will be
available under the Accessories start menu. This utility will allow you to list the
detected DAQ HATs, update the EEPROM files if you change your board stack, and launch
control applications for each DAQ HAT to perform simple operations. The code for these
programs is in the daqhats/tools/applications directory.

#### List the installed boards
You can use the DAQ HAT Manager or the **daqhats_list_boards** command to display a
list of the detected MCC DAQ HATs.  This list is generated from the EEPROM images, so
it will not be correct if you change the board stack without updating the EEPROM
images (see below.)

#### Update the EEPROM images
If you change your board stack, you must update the saved EEPROM images so that 
the library has the correct board information. You can use the DAQ HAT Manager or the
command:

```sh
sudo daqhats_read_eeproms
```

#### Uninstall the daqhats library
If you want to uninstall the the daqhats library, use the following commands:

```sh
cd ~/daqhats
sudo ./uninstall.sh
```

## Firmware Updates
#### MCC 118
Use the firmware update tool to update the firmware on your MCC 118 board(s).
The "0" in the example below is the board address. Repeat the command for each
MCC 118 address in your board stack. This example demonstrates how to update the
firmware on the MCC 118 that is installed at address 0.

```sh
mcc118_firmware_update 0 ~/daqhats/tools/MCC_118.hex
```

## Examples
The daqhats library includes example programs developed with C/C++ and Python. 
The examples are available under ~/daqhats/examples, and are provided in the 
following formats:

- console-based (C/C++ and Python)
- User interface
  - Web server (Python)
  - IFTTT (If This Then That) trigger service (Python)
  - Data logger (C/C++)

Refer to the README.md file in each example folder for more information.

## Usage
The following is a basic Python example demonstrating how to read MCC 118 voltage 
inputs and display channel values.

```python
#!/usr/bin/env python
#
# MCC 118 example program
# Read and display analog input values
#
import sys
from daqhats import hat_list, HatIDs, mcc118

# get hat list of MCC daqhat boards
board_list = hat_list(filter_by_id = HatIDs.ANY)
if not board_list:
    print("No boards found")
    sys.exit()

# Read and display every channel
for entry in board_list: 
    if entry.id == HatIDs.MCC_118:
        print("Board {}: MCC 118".format(entry.address))
        board = mcc118(entry.address)
        for channel in range(board.info().NUM_AI_CHANNELS):
            value = board.a_in_read(channel)
            print("Ch {0}: {1:.3f}".format(channel, value))	
```
    
## Support/Feedback
The **daqhats** library is supported by MCC. Contact technical support through 
our [support page](https://www.mccdaq.com/support/support_form.aspx).

## Documentation 
Documentation for the daqhats library is available at 
https://mccdaq.github.io/daqhats/index.html.