1 //===-- MSP430AsmBackend.cpp - MSP430 Assembler Backend -------------------===//
2 //
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4 // See https://llvm.org/LICENSE.txt for license information.
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6 //
7 //===----------------------------------------------------------------------===//
8 
9 #include "MCTargetDesc/MSP430FixupKinds.h"
10 #include "MCTargetDesc/MSP430MCTargetDesc.h"
11 #include "llvm/ADT/APInt.h"
12 #include "llvm/MC/MCAsmBackend.h"
13 #include "llvm/MC/MCAssembler.h"
14 #include "llvm/MC/MCContext.h"
15 #include "llvm/MC/MCDirectives.h"
16 #include "llvm/MC/MCELFObjectWriter.h"
17 #include "llvm/MC/MCExpr.h"
18 #include "llvm/MC/MCFixupKindInfo.h"
19 #include "llvm/MC/MCObjectWriter.h"
20 #include "llvm/MC/MCSubtargetInfo.h"
21 #include "llvm/MC/MCSymbol.h"
22 #include "llvm/MC/MCTargetOptions.h"
23 #include "llvm/Support/ErrorHandling.h"
24 #include "llvm/Support/raw_ostream.h"
25 
26 using namespace llvm;
27 
28 namespace {
29 class MSP430AsmBackend : public MCAsmBackend {
30   uint8_t OSABI;
31 
32   uint64_t adjustFixupValue(const MCFixup &Fixup, uint64_t Value,
33                             MCContext &Ctx) const;
34 
35 public:
36   MSP430AsmBackend(const MCSubtargetInfo &STI, uint8_t OSABI)
37       : MCAsmBackend(support::little), OSABI(OSABI) {}
38   ~MSP430AsmBackend() override = default;
39 
40   void applyFixup(const MCAssembler &Asm, const MCFixup &Fixup,
41                   const MCValue &Target, MutableArrayRef<char> Data,
42                   uint64_t Value, bool IsResolved,
43                   const MCSubtargetInfo *STI) const override;
44 
45   std::unique_ptr<MCObjectTargetWriter>
46   createObjectTargetWriter() const override {
47     return createMSP430ELFObjectWriter(OSABI);
48   }
49 
50   bool fixupNeedsRelaxation(const MCFixup &Fixup, uint64_t Value,
51                             const MCRelaxableFragment *DF,
52                             const MCAsmLayout &Layout) const override {
53     return false;
54   }
55 
56   bool fixupNeedsRelaxationAdvanced(const MCFixup &Fixup, bool Resolved,
57                                     uint64_t Value,
58                                     const MCRelaxableFragment *DF,
59                                     const MCAsmLayout &Layout,
60                                     const bool WasForced) const override {
61     return false;
62   }
63 
64   unsigned getNumFixupKinds() const override {
65     return MSP430::NumTargetFixupKinds;
66   }
67 
68   const MCFixupKindInfo &getFixupKindInfo(MCFixupKind Kind) const override {
69     const static MCFixupKindInfo Infos[MSP430::NumTargetFixupKinds] = {
70       // This table must be in the same order of enum in MSP430FixupKinds.h.
71       //
72       // name            offset bits flags
73       {"fixup_32",            0, 32, 0},
74       {"fixup_10_pcrel",      0, 10, MCFixupKindInfo::FKF_IsPCRel},
75       {"fixup_16",            0, 16, 0},
76       {"fixup_16_pcrel",      0, 16, MCFixupKindInfo::FKF_IsPCRel},
77       {"fixup_16_byte",       0, 16, 0},
78       {"fixup_16_pcrel_byte", 0, 16, MCFixupKindInfo::FKF_IsPCRel},
79       {"fixup_2x_pcrel",      0, 10, MCFixupKindInfo::FKF_IsPCRel},
80       {"fixup_rl_pcrel",      0, 16, MCFixupKindInfo::FKF_IsPCRel},
81       {"fixup_8",             0,  8, 0},
82       {"fixup_sym_diff",      0, 32, 0},
83     };
84     static_assert((std::size(Infos)) == MSP430::NumTargetFixupKinds,
85                   "Not all fixup kinds added to Infos array");
86 
87     if (Kind < FirstTargetFixupKind)
88       return MCAsmBackend::getFixupKindInfo(Kind);
89 
90     return Infos[Kind - FirstTargetFixupKind];
91   }
92 
93   bool writeNopData(raw_ostream &OS, uint64_t Count,
94                     const MCSubtargetInfo *STI) const override;
95 };
96 
97 uint64_t MSP430AsmBackend::adjustFixupValue(const MCFixup &Fixup,
98                                             uint64_t Value,
99                                             MCContext &Ctx) const {
100   unsigned Kind = Fixup.getKind();
101   switch (Kind) {
102   case MSP430::fixup_10_pcrel: {
103     if (Value & 0x1)
104       Ctx.reportError(Fixup.getLoc(), "fixup value must be 2-byte aligned");
105 
106     // Offset is signed
107     int16_t Offset = Value;
108     // Jumps are in words
109     Offset >>= 1;
110     // PC points to the next instruction so decrement by one
111     --Offset;
112 
113     if (Offset < -512 || Offset > 511)
114       Ctx.reportError(Fixup.getLoc(), "fixup value out of range");
115 
116     // Mask 10 bits
117     Offset &= 0x3ff;
118 
119     return Offset;
120   }
121   default:
122     return Value;
123   }
124 }
125 
126 void MSP430AsmBackend::applyFixup(const MCAssembler &Asm, const MCFixup &Fixup,
127                                   const MCValue &Target,
128                                   MutableArrayRef<char> Data,
129                                   uint64_t Value, bool IsResolved,
130                                   const MCSubtargetInfo *STI) const {
131   Value = adjustFixupValue(Fixup, Value, Asm.getContext());
132   MCFixupKindInfo Info = getFixupKindInfo(Fixup.getKind());
133   if (!Value)
134     return; // Doesn't change encoding.
135 
136   // Shift the value into position.
137   Value <<= Info.TargetOffset;
138 
139   unsigned Offset = Fixup.getOffset();
140   unsigned NumBytes = alignTo(Info.TargetSize + Info.TargetOffset, 8) / 8;
141 
142   assert(Offset + NumBytes <= Data.size() && "Invalid fixup offset!");
143 
144   // For each byte of the fragment that the fixup touches, mask in the
145   // bits from the fixup value.
146   for (unsigned i = 0; i != NumBytes; ++i) {
147     Data[Offset + i] |= uint8_t((Value >> (i * 8)) & 0xff);
148   }
149 }
150 
151 bool MSP430AsmBackend::writeNopData(raw_ostream &OS, uint64_t Count,
152                                     const MCSubtargetInfo *STI) const {
153   if ((Count % 2) != 0)
154     return false;
155 
156   // The canonical nop on MSP430 is mov #0, r3
157   uint64_t NopCount = Count / 2;
158   while (NopCount--)
159     OS.write("\x03\x43", 2);
160 
161   return true;
162 }
163 
164 } // end anonymous namespace
165 
166 MCAsmBackend *llvm::createMSP430MCAsmBackend(const Target &T,
167                                              const MCSubtargetInfo &STI,
168                                              const MCRegisterInfo &MRI,
169                                              const MCTargetOptions &Options) {
170   return new MSP430AsmBackend(STI, ELF::ELFOSABI_STANDALONE);
171 }
172