Akifumi Takahashi / PMRC16ch

Library to use my Photo MOS Relays Circuit having 16 or less channels.

Fork of PMRC4ch by Akifumi Takahashi

PMRC16ch.h@35:2329524f385a, 2018-11-07 (annotated)

Committer:
aktk
Date:
Wed Nov 07 18:12:56 2018 +0000
Revision:
35:2329524f385a
Parent:
34:013746eddc4a
Child:
36:d365db06cf17
tenntekomai

Who changed what in which revision?

UserRevisionLine numberNew contents of line
aktk 34:013746eddc4a 1 /** PMRC16 class header file
aktk 24:4714402606f0 2 * @file PMRC16ch.h
aktk 29:9028bc6b5717 3 * @author Akifumi Takahashi
aktk 29:9028bc6b5717 4 * @date 2016/dec/11-
aktk 31:0f491590ada9 5 * - ver.1; 8 channel
aktk 29:9028bc6b5717 6 * @date 2018/jun/01-
aktk 31:0f491590ada9 7 * - ver.16.1; 16 channel
aktk 29:9028bc6b5717 8 * @date 2018/jun/28-
aktk 31:0f491590ada9 9 * - ver.16.2; major change
aktk 29:9028bc6b5717 10 */
aktk 34:013746eddc4a 11 #ifndef PMRC_16CHANNEL_H
aktk 34:013746eddc4a 12 #define PMRC_16CHANNEL_H
aktk 29:9028bc6b5717 13 #include "mbed.h"
aktk 35:2329524f385a 14 /** PMCR16 nyaan
aktk 24:4714402606f0 15 * @par About PMRC16 class
aktk 26:a47ab67a4d12 16 * - A Program with which to control Photo MOS Relay Circuit
aktk 15:56703876e914 17 * for 16 channels Electric Stimulation.
aktk 26:a47ab67a4d12 18 * - Photo Couplers are controlled by Shift Resisters. So this lib serves
aktk 22:4aad836d3333 19 * shift resister's utility.
aktk 23:cea3ec410735 20 *
aktk 24:4714402606f0 21 * @par Image of Photo MOS Relay Array
aktk 25:953a60ea0e64 22 * - 32 Photo MOS Relay IN
aktk 25:953a60ea0e64 23 * - 16 channel OUT
aktk 34:013746eddc4a 24 *
aktk 34:013746eddc4a 25 * @verbatim
aktk 31:0f491590ada9 26 * +--i o----+----i o--+
aktk 31:0f491590ada9 27 * | [PMR01-1] | [PMR01-2] |
aktk 31:0f491590ada9 28 * | (ch1(B)out) |
aktk 31:0f491590ada9 29 * | |
aktk 31:0f491590ada9 30 * +--i o----+----i o--+
aktk 31:0f491590ada9 31 * | [PMR02-1] | [PMR02-2] |
aktk 31:0f491590ada9 32 * | (ch2(R)out) |
aktk 31:0f491590ada9 33 * | |
aktk 31:0f491590ada9 34 * . . .
aktk 31:0f491590ada9 35 * . . .
aktk 31:0f491590ada9 36 * . . .
aktk 31:0f491590ada9 37 * Vpp GND
aktk 34:013746eddc4a 38 * @endverbatim
aktk 24:4714402606f0 39 *
aktk 24:4714402606f0 40 * @par Info. Shit-Resister circuit board
aktk 24:4714402606f0 41 * - nOE is connected to GND
aktk 34:013746eddc4a 42 *
aktk 30:6a9e4e451b42 43 * @verbatim
aktk 15:56703876e914 44 * in
aktk 15:56703876e914 45 * ->[PMR01-1]->[PMR01-2]->[PMR02-1]->[PMR02-2]
aktk 15:56703876e914 46 * ->[PMR03-1]->[PMR03-2]->[PMR04-1]->[PMR04-2]
aktk 15:56703876e914 47 * ->[PMR05-1]->[PMR05-2]->[PMR06-1]->[PMR06-2]
aktk 15:56703876e914 48 * ->[PMR07-1]->[PMR07-2]->[PMR08-1]->[PMR08-2]
aktk 15:56703876e914 49 * ->[PMR09-1]->[PMR09-2]->[PMR10-1]->[PMR10-2]
aktk 15:56703876e914 50 * ->[PMR11-1]->[PMR11-2]->[PMR12-1]->[PMR12-2]
aktk 15:56703876e914 51 * ->[PMR13-1]->[PMR13-2]->[PMR14-1]->[PMR14-2]
aktk 15:56703876e914 52 * ->[PMR15-1]->[PMR15-2]->[PMR16-1]->[PMR16-2]
aktk 15:56703876e914 53 * ->out
aktk 30:6a9e4e451b42 54 * @endverbatim
aktk 24:4714402606f0 55 *
aktk 27:a0a453783a4c 56 * @version 1
aktk 34:013746eddc4a 57 * - 2016/dec/11-
aktk 35:2329524f385a 58 * - program bersion for 8 channel circuit
aktk 27:a0a453783a4c 59 * @version 16.1
aktk 34:013746eddc4a 60 * - 2018/jun/01-
aktk 35:2329524f385a 61 * - 16 channel version
aktk 27:a0a453783a4c 62 * @version 16.2
aktk 34:013746eddc4a 63 * - 2018/jun/28-
aktk 34:013746eddc4a 64 * - major change
aktk 15:56703876e914 65 */
aktk 15:56703876e914 66 class PMRC16ch
aktk 15:56703876e914 67 {
aktk 15:56703876e914 68 public:
aktk 15:56703876e914 69 //
aktk 15:56703876e914 70 // Constructor
aktk 15:56703876e914 71 //
aktk 15:56703876e914 72 PMRC16ch();
aktk 15:56703876e914 73 PMRC16ch(
aktk 21:fa067e2a30f2 74 uint8_t arg_num_ch
aktk 21:fa067e2a30f2 75 );
aktk 21:fa067e2a30f2 76 PMRC16ch(
aktk 15:56703876e914 77 uint8_t arg_num_ch,
aktk 15:56703876e914 78 PinName arg_SCK,
aktk 15:56703876e914 79 PinName arg_CLR,
aktk 15:56703876e914 80 PinName arg_RCK,
aktk 15:56703876e914 81 PinName arg_SER,
aktk 15:56703876e914 82 PinName arg_OUT
aktk 19:1112aeb5cddd 83 );
aktk 15:56703876e914 84
aktk 15:56703876e914 85 // Const.
aktk 19:1112aeb5cddd 86 enum State {
aktk 21:fa067e2a30f2 87 ALLGROUND = 0x55555555,
aktk 21:fa067e2a30f2 88 CH1 = /*1V*/0b10000000000000000000000000000000/*16G*/,
aktk 21:fa067e2a30f2 89 CH2 = /*1V*/0b00100000000000000000000000000000/*16G*/,
aktk 21:fa067e2a30f2 90 CH3 = /*1V*/0b00001000000000000000000000000000/*16G*/,
aktk 21:fa067e2a30f2 91 CH4 = /*1V*/0b00000010000000000000000000000000/*16G*/,
aktk 21:fa067e2a30f2 92 CH5 = /*1V*/0b00000000100000000000000000000000/*16G*/,
aktk 21:fa067e2a30f2 93 CH6 = /*1V*/0b00000000001000000000000000000000/*16G*/,
aktk 21:fa067e2a30f2 94 CH7 = /*1V*/0b00000000000010000000000000000000/*16G*/,
aktk 21:fa067e2a30f2 95 CH8 = /*1V*/0b00000000000000100000000000000000/*16G*/,
aktk 21:fa067e2a30f2 96 CH9 = /*1V*/0b00000000000000001000000000000000/*16G*/,
aktk 21:fa067e2a30f2 97 CH10= /*1V*/0b00000000000000000010000000000000/*16G*/,
aktk 21:fa067e2a30f2 98 CH11= /*1V*/0b00000000000000000000100000000000/*16G*/,
aktk 21:fa067e2a30f2 99 CH12= /*1V*/0b00000000000000000000001000000000/*16G*/,
aktk 21:fa067e2a30f2 100 CH13= /*1V*/0b00000000000000000000000010000000/*16G*/,
aktk 21:fa067e2a30f2 101 CH14= /*1V*/0b00000000000000000000000000100000/*16G*/,
aktk 21:fa067e2a30f2 102 CH15= /*1V*/0b00000000000000000000000000001000/*16G*/,
aktk 21:fa067e2a30f2 103 CH16= /*1V*/0b00000000000000000000000000000010/*16G*/,
aktk 21:fa067e2a30f2 104 ALLHiZ = 0x00000000
aktk 19:1112aeb5cddd 105 };
aktk 15:56703876e914 106 enum Polarity {Anodic = 0, Cathodic = 1};
aktk 21:fa067e2a30f2 107 enum StimMode {ONE_VS_THEOTHERS, TWIN_ELECTRODES};
aktk 15:56703876e914 108 //
aktk 21:fa067e2a30f2 109 // Function to prepare channels
aktk 15:56703876e914 110 //
aktk 20:26972de3cf90 111 void allGround();
aktk 15:56703876e914 112 void allHiZ();
aktk 21:fa067e2a30f2 113 void setPol(Polarity pol); //inline definition
aktk 21:fa067e2a30f2 114 void setOvsO(char ch);
aktk 21:fa067e2a30f2 115 void setTwin(char stim_ch, char ref_ch);
aktk 15:56703876e914 116 //
aktk 15:56703876e914 117 // Function to get prameter
aktk 15:56703876e914 118 //
aktk 21:fa067e2a30f2 119 uint32_t getState(); //inline definition
aktk 21:fa067e2a30f2 120 bool getPol(); //inline definition
aktk 15:56703876e914 121
aktk 15:56703876e914 122 private:
aktk 21:fa067e2a30f2 123 // The number of channels to use
aktk 21:fa067e2a30f2 124 const uint8_t m_num_ch;
aktk 15:56703876e914 125 //
aktk 15:56703876e914 126 // Sig var to controll PRM circuit
aktk 15:56703876e914 127 //
aktk 15:56703876e914 128 DigitalOut m_SCK; // Shift-resister's clock
aktk 15:56703876e914 129 DigitalOut m_CLR; // To use when you want to clear shift-resister
aktk 15:56703876e914 130 DigitalOut m_RCK; // FF's clock
aktk 15:56703876e914 131 DigitalOut m_SER; // Serial input to shift data in a shift-resister
aktk 15:56703876e914 132 DigitalIn m_OUT; // Output data overflowed from shift-resister
aktk 21:fa067e2a30f2 133 //
aktk 21:fa067e2a30f2 134 // Var of state
aktk 21:fa067e2a30f2 135 //
aktk 21:fa067e2a30f2 136 // Position of stimulation bits
aktk 21:fa067e2a30f2 137 // 0: no stimbits, 1~m_num_ch: channel of stimulation
aktk 21:fa067e2a30f2 138 uint32_t m_pos_stim;
aktk 21:fa067e2a30f2 139 static const uint32_t m_statearray[];
aktk 21:fa067e2a30f2 140 uint32_t m_PMRC_state;
aktk 21:fa067e2a30f2 141 Polarity m_PMRC_POL;
aktk 21:fa067e2a30f2 142 StimMode m_PMRC_mode;
aktk 15:56703876e914 143 // Initialization
aktk 15:56703876e914 144 void init();
aktk 15:56703876e914 145 //
aktk 21:fa067e2a30f2 146 // Function to control buffer of shift-resister
aktk 15:56703876e914 147 //
aktk 15:56703876e914 148 // shift the bits arbitary times
aktk 15:56703876e914 149 void shiftby(int times);
aktk 21:fa067e2a30f2 150 // the function with which to rapidly set it all-ground
aktk 15:56703876e914 151 void sweep();
aktk 15:56703876e914 152 // set the simulation bits of 01
aktk 15:56703876e914 153 void setStimbits();
aktk 21:fa067e2a30f2 154 // set all bits arbitarily
aktk 21:fa067e2a30f2 155 void setBits(const uint32_t bits);
aktk 21:fa067e2a30f2 156 //
aktk 21:fa067e2a30f2 157 // Clock Function
aktk 21:fa067e2a30f2 158 //
aktk 15:56703876e914 159 //update the clock of shift-resister
aktk 15:56703876e914 160 void update();
aktk 15:56703876e914 161 // output the data by uploading them to FF Resitors
aktk 15:56703876e914 162 void upload();
aktk 15:56703876e914 163 };
aktk 21:fa067e2a30f2 164 inline void PMRC16ch::setPol(Polarity arg_pol)
aktk 21:fa067e2a30f2 165 {
aktk 21:fa067e2a30f2 166 m_PMRC_POL = arg_pol;
aktk 21:fa067e2a30f2 167 }
aktk 20:26972de3cf90 168 inline uint32_t PMRC16ch::getState()
aktk 15:56703876e914 169 {
aktk 21:fa067e2a30f2 170 return m_PMRC_state;
aktk 15:56703876e914 171 }
aktk 15:56703876e914 172 inline bool PMRC16ch::getPol()
aktk 15:56703876e914 173 {
aktk 15:56703876e914 174 //return false if cathodic
aktk 15:56703876e914 175 //return true if anodic
aktk 15:56703876e914 176 return static_cast<bool>(m_PMRC_POL);
aktk 15:56703876e914 177 }
aktk 15:56703876e914 178 #endif