Skip to content

Changes

Page history
Update Using the Peary software : pearycli and ATLASPixServer authored by Mathieu Benoit's avatar Mathieu Benoit
Show whitespace changes
Inline Side-by-side
Using-the-Peary-software-:-pearycli-and-ATLASPixServer.md
View page @ da3b2b54
......@@ -23,5 +23,88 @@ To connect to the FPGA, make sure you PC has an interface in the same local netw
``` ssh root@192.168.1.10 ```
# Getting started with the **Pearycli**
The **Pearycli** is a command line interface allowing to register and interact with multiple devices using test commands and arguments. To start the **Pearycli**, use the following command :
``` pearycli -v <VERBOSE LEVEL> -l <LOG FILE> -r <SCRIPT of COMMANDS> ```
* `<VERBOSE LEVEL>` represent the level of verbosity of the peary software, the available choices are : `INFO,WARNING,DEBUG`
* `<LOG FILE>` is a text file where all the input/output of the command line seesion with be reccorded
* `<SCRIPT of COMMANDS>` point to the path of a text file containing a list of commands to be executed at startup
`add_device <device>` is first command required to activate ATLASPix in the pearycli. `<device>` is the device to be instantiated. For ATLASPix, the device name is ATLASPix, therefore, the following commands tells the pearycli to activate one ATLASPix :
``` add_device ATLASPix```
Output :
```# add_device ATLASPix
|16:31:12.666| (INFO) Creating new instance of device "ATLASPix".
|16:31:12.666| (STATUS) New Caribou device instance, version peary v0.9+596~g062fe2c
|16:31:12.666| (STATUS) This device is managed through the device manager.
|16:31:12.667| (STATUS) Firmware version: 0x64a530a7 (12/9/2018 19:2:39)
|16:31:12.671| (INFO) Setting clock circuit on CaR board ATLASPixDevice
|16:31:13.803| (INFO) Appending instance to device list, device ID 0
|16:31:13.804| (INFO) Manager returned device ID 0.
```
A new ATLASPix device is instantiated and is attributed the ID 0. Multiple device can be instantiated, if the connection scheme allows for it.
As ATLASPix contains three type of matrices, the second command that is required is `SetMatrix <matrix type> <ID>` where :
* <matrix type> is the type of ATLASPix matrix, which can be M1,M1ISO or M2. In most case, M1 is the one that is wire-bonded to the PCB, unless otherwise noticed.
* <ID> is the device ID of the ATLASPix that was instanciated. In most case it is 0
The third required commands is `powerOn <ID>`, which powers the ATLASPix LV power supplies with the defaults values.
* <ID> is the device ID of the ATLASPix that was instanciated. In most case it is 0
* Defaults values can be found in ATLASPix code [here](https://gitlab.cern.ch/ATLASPix/peary/blob/master/devices/ATLASPix/ATLASPix_defaults.hpp).
To verify the LV voltage levels and currents measured by the CaR board, you can use the following command : `powerStatusLog <ID>`. The output should look like this :
```
# powerStatusLog 0
|16:40:22.887| (INFO) ATLASPixDevice power status:
|16:40:22.887| (INFO) VDDD:
|16:40:22.887| (INFO) Bus voltage: 1.8575V
|16:40:22.888| (INFO) Bus current: 0.0227678A
|16:40:22.889| (INFO) VDDA:
|16:40:22.889| (INFO) Bus voltage: 1.8375V
|16:40:22.890| (INFO) Bus current: 0.0667773A
|16:40:22.891| (INFO) VSSA:
|16:40:22.891| (INFO) Bus voltage: 1.19V
|16:40:22.892| (INFO) Bus current: 0.057011A
|16:40:22.893| (INFO) VDDRam:
|16:40:22.893| (INFO) Bus voltage: 1.88375V
|16:40:22.893| (INFO) Bus current: 0A
|16:40:22.894| (INFO) VCC25:
|16:40:22.895| (INFO) Bus voltage: 2.5075V
|16:40:22.895| (INFO) Bus current: 0.0299704A
|16:40:22.896| (INFO) VDDHigh:
|16:40:22.896| (INFO) Bus voltage: 1.85875V
|16:40:22.897| (INFO) Bus current: 0.0212418A
#
```
Finally, to configure the ATLASPix with its defaults values, use the `configure <ID>` command. Ex:
```
# configure 0
|16:42:10.686| (INFO) Configuring ATLASPixDevice with default configuration
sending default TDACs
|16:42:10.989| (INFO) Setting registers from configuration:
#
```