Safari Jupyter Notebook Copy - ArrowElectronics/arrow-safari GitHub Wiki
Description: Using Jupyter Notebook you can pull up plots for the various sensors connected to the inputs of the Safari board.
Note: This requires a different image to be placed onto the SD card than is used to run the standalone GUI. Instructions for this are contained in the section Flashing the SD Card below.
- Prerequisites
- Software Installation
- Hardware Components
- Power Test
- Input Test
- Connect Sensors
- Running the Demo
- Theory of Operation
-
Appendix
- Windows 10 PC
- Meerkat 96Board
- Safari 96Board Mezzanine Card
- Git (optional)
- Note: These first 3 steps are for initial installation only. If Anaconda is already installed, step #2 may be skipped. If the Safari environment has already been imported into Anaconda, step #3 may be skipped also.
- Obtain this repository
- Install Anaconda 3
- Import Safari environment into Anaconda
- Start Jupyter notebook with the Safari environment
- Open the Notebook
Create the directory C:\Users\username\arrow_demos. Download and extract this repository to the newly created directory or if you have Git installed, you can clone it to your local machine. To clone it using Git, open Git, cd to this directory and enter the following command
git clone https://github.com/ArrowElectronics/arrow-safari.git
-
Download and install Anaconda
- Leave all settings as the default
-
Launch Anaconda Navigator
-
In Anaconda Navigator, select the Environments tab

-
Select Import

-
In the window that opens name your environment Safari as shown in the picture below.
-
Click on the folder icon and navigate to C:\Users\username\arrow_demos\arrow-safari-master\safari_env.yaml.


-
Select Import. Note: This takes a few minutes- be patient!
-
Once the import is complete, you will see a new environment named Safari in the list of available environments

-
After the Safari environment has been imported, Select the Home tab

-
Ensure the Applications on dropdown menu is set to Safari

-
Find the Jupyter Notebook application and select Launch

-
Select your preferred browser

-
Jupyter will launch a web browser and allow you to run the Notebook
This demo is designed to demonstrate the functionality of the AD7124 using Arrow's Safari 96Board mezzanine card.
- Novtech Meerkat 96Board
- Arrow Safari Multi-Sensor Input 96Boards Mezzanine Card - p/n 96B-05SENSORADC-V2.0-ARROW
- 12V/2A Power Supply (Not Pictured)
- 8GB or larger MicroSD Card (Not Pictured)
- USB-to-UART Cable (Not Pictured)
- Analog Devices ADXL203EB Accelerometer Eval Board
- 4-pin Connector Cable (not shown)
- Adafruit 3290 PT100 RTD Temperature Probe
- Sensirion SDP816-125PA Differential Pressure Sensor (not shown)
For the Safari kit the Meerkat board requires an 8GB microSD card with the necessary software downloaded (flashed) onto it. Here are the instructions for doing this.
- Obtain 8GB or larger microSD card
- Locate the image 'safari_jupyter.img.bz2'. It is in your arrow-safari-master folder.
- Extract image using winzip, 7zip, etc. File name will now be 'safari_jupyter.img'
- Format microSD card to 'FAT32' using SD Card Formatter or another program
- Using balenaEtcher, Win32DiskImager or similar software transfer image from your PC to the memory card
Insert microSD card containing Linux OS and Safari demo into Meerkat.
Turn the Meerkat board over and identify the small DPDT DIP switch on the bottom. Make sure both switches 1 and 2 are in the ON position as shown.
Before connecting the Safari and Meerkat boards together it is necessary to modify one of the connectors. This will provide clearance for the Safari board and allow access to pins which are needed for the UART connection. Very carefully bend the 3 pins on connector J3 located next to the power input jack on the Meerkat board taking special care not to rip it off the board while doing so.
Assemble Safari board on top of Meerkat board using the mating low-speed connectors on each board. It should like this:
Before connecting anything to the inputs it is a good idea to test the power to both the Meerkat and Safari boards first.
-
Plug AC-to-DC power supply into AC wall outlet and insert barrel jack into receptacle on the Meerkat board.
-
Check that all 4 LEDs on the Safari- red, blue, yellow, green- are on. These LEDs correspond to the following power supplies: Red: 5VDC output from Meerkat Blue: 1.8VDC output from Meerkat Yellow: 3.3VDC supply 'AVDD' on Safari board Green: 1.8VDC supply 'IOVDD' on Safari board
- Check LEDs (a) If these are all lit up, we are ready to go to the next step which is connecting the sensors. Remove power to the Meerkat board before proceeding to this step. (b) If the LEDs are not all lit up, there is a problem with a power supply. Using a multimeter and the schematics, troubleshoot and identify the problem and fix before proceeding.
The demo software allows you to connect the Analog Devices ADXL203EB accelerometer eval board, Adafruit 3290 RTD temperature probe and Sensirion SDP816-125PA differential pressure sensor and view the outputs.
Connect 4-pin connector cable to the ADXL203EB accelerometer board leaving pin ST unconnected. Identify the color of the wire connected to pin +V on the ADLX203EB; connect the other end to Safari board connector J1 pin 1 (AVdd) and tighten down using a small screwdriver. Similarly connect the wire on pin X to J1 pin 2 (IN0) on Safari, and the wire on pin G to J1 pin 4 (ground). See picture below.
This is a little tricky. Using 22-26 gauge insulated wire, cut small pieces and insert into terminal J2 on Safari as shown in these diagrams, tightening down on corresponding screws.
- Connect wire between pins IN2 and REF+
- Connect wire between pins IN3 and IN5
- Connect wire between pins REF- and IN4
- Connect precision resistor between REF+ and REF-
- Now take the RTD probe and determine which two wires are connected together at one end by using an ohmmeter. Resistance should be approximately zero ohms. Take the wire which is not connected directly to the others (resistance approx 100 ohms) and connect to J2 pin 6 (IN4) (will have to loosen screw first). Take one of the remaining wires and connect to J2 pin 5 (IN5) and the other wire to J2 pin 6 (HDRM).
- Connect wiring harness to the pressure sensor
- Connect wires for OCS and GND together (pins 3 and 1- see diagram) then connect to AGND on board
- Connect wire from VDD on sensor (pin 2) to AVDD on board
- Connect wire from AOUT on sensor (pin 4) to IN6 on board
Connect the USB-to-UART cable between connector J3 on the Meerkat board and any available port on your PC.
Set jumpers on top of Safari board as follows (see picture below):
| Jumper | Settings | Description |
|---|---|---|
| JP1 | off | enables 30.9k resistor R6A for resistive divider on input IN6 |
| JP2 | on | enables 100k resistor R6B for resistive divider on input IN6 |
| JP3 | off | enables 30.9k resistor R6A for resistive divider on input IN7 |
| JP4 | on | enables 100k resistor R6B for resistive divider on input IN7 |
| JP5 | across pins 1-2 | enables positive output (2.5V) from precision voltage reference U5 |
| JP6 | across pins 3-4 | enables negative output (GND) from precision voltage reference U5 |
Connect the 12V power supply to the Meerkat board. Wait approximately 15 seconds for the Meerkat to fully boot.
On your PC running Windows 10 open up Device Manager. Look under 'Ports' and make a note of which COM port the Meerkat is connected to. If there are multiple devices listed, you can unplug the USB cable and plug it back in to identify the right one.
-
With Jupyter Notebook running, click on 'arrow-safari' to navigate to the location of Safari_IPython.ipynb.
-
Click the filename Safari_IPython.ipynb to launch the notebook.
- The notebook should open in a new tab
Note: If you are unable to locate the files you downloaded/cloned earlier please follow the instructions here to change the starting directory of Jupyter.
- The notebook should open in a new tab
-
Follow the instructions inside the notebook.
-
With Jupyter Notebook running, click on 'arrow-safari' to navigate to the location of Safari_IPython_Modifying_Registers.ipynb.
-
Click the filename Safari_IPython_Modifying_Registers.ipynb to launch the notebook.
- The notebook should open in a new tab
Note: If you are unable to locate the files you downloaded/cloned earlier please follow the instructions here to change the starting directory of Jupyter.
- The notebook should open in a new tab
-
Follow the instructions inside the notebook.
-
With Jupyter Notebook running, click on 'arrow-safari' to navigate to the location of Safari_IPython_Test_Mode.ipynb.
-
Click the filename Safari_IPython_Test_Mode.ipynb to launch the notebook.
- The notebook should open in a new tab
Note: If you are unable to locate the files you downloaded/cloned earlier please follow the instructions here to change the starting directory of Jupyter.
- The notebook should open in a new tab
-
Follow the instructions inside the notebook.