summaryrefslogtreecommitdiff
path: root/ext/nomali/lib/jobcontrol.hh
blob: d76a26937f8843336b9b8d37fbff9a0fdcf76a7d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
/*
 * Copyright (c) 2014-2015 ARM Limited
 * All rights reserved
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 *
 * Authors: Andreas Sandberg
 */

#ifndef _LIBNOMALIMODEL_JOBCONTROL_HH
#define _LIBNOMALIMODEL_JOBCONTROL_HH

#include <vector>

#include "gpublock.hh"
#include "jobslot.hh"
#include "types.hh"

namespace NoMali {

class GPU;

/**
 * Minimal GPU job control implementation.
 *
 * This class implements the job control block of a Midgard style
 * GPU. The job control block mainly coordinates interrupt delivery
 * and register mappings for the different job slots within the
 * block. The actual job slots are implemented by the JobSlot class.
 *
 * @see JobSlot
 */
class JobControl
    : public GPUBlockInt
{
  public:
    JobControl(GPU &_gpu);
    virtual ~JobControl();

    void reset() override;

    uint32_t readReg(RegAddr idx)  override;
    void writeReg(RegAddr idx, uint32_t value) override;

    uint32_t readRegRaw(RegAddr idx)  override;
    void writeRegRaw(RegAddr idx, uint32_t value) override;

    /**
     * Signal job done.
     *
     * Calling this method raises the job done interrupt for a
     * specific job slot. This is typically called from the job slot
     * running the job chain.
     *
     * @param slot Job slot number.
     */
    void jobDone(uint8_t slot);
    /**
     * Signal job failed.
     *
     * Calling this method raises the job failed interrupt for a
     * specific job slot. This is typically called from the job slot
     * running the job chain.
     *
     * @param slot Job slot number.
     */
    void jobFailed(uint8_t slot);

  protected:
    /**
     * Update the state of the job slot state snapshot register.
     *
     * @param jobs Bit mask representing which job slots to update.
     */
    void updateJsState(uint16_t jobs);

    void onInterrupt(int set) override;

    /** Job slots belonging to this job control block */
    std::vector<JobSlot> slots;
};

}

#endif // _LIBNOMALIMODEL_JOBCONTROL_HH